http

type HTTP struct{}

type HTTPConfig struct {
	// Target is the request-target: either an origin-form ("/path?query")
	// or an absolute URL ("https://example.com/path?query").
	// Defaults to "/" when empty.
	Target string

	// Method is the HTTP method. Case-insensitive; defaults to "GET".
	Method string

	// Headers are additional request headers to send.
	Headers []Header

	// MaxResponseBodyBytes caps how many bytes of the response body are
	// buffered. 0 uses DefaultMaxResponseBodyBytes.
	MaxResponseBodyBytes int64

	// BodyReader, if non-nil, is written as the request body.
	BodyReader io.Reader

	// MaxRedirectFollow is the maximum number of redirects to follow.
	// 0 (DefaultMaxRedirectFollow) means no redirects are followed;
	// the original 3xx response is returned as-is.
	MaxRedirectFollow int

	// RedirectValidator is called with each redirect Location URL before
	// following it. If nil, DefaultRedirectValidator is used. Return an
	// error to reject the redirect. This is only invoked on redirect
	// targets, never on the original user-specified target.
	RedirectValidator func(locationURL string) error
}

type HTTPResult struct {
	// ProtocolVersion is the HTTP version from the response status line, e.g. "HTTP/1.1".
	ProtocolVersion string

	// StatusCode is the numeric HTTP status code, e.g. 200.
	StatusCode int

	// Status is the full status text, e.g. "200 OK".
	Status string

	// ResponseHeaders are the response headers in the order received.
	ResponseHeaders []Header

	// Body is the buffered response body, limited to MaxResponseBodyBytes.
	// Only available in the Go API; the JSON API omits it.
	Body *bytes.Reader

	// Redirects holds the chain of redirects that were followed, in order.
	// Empty when no redirects occurred (either because the final status was
	// not 3xx, or MaxRedirectFollow was 0).
	Redirects []RedirectEntry
}

type Header struct {
	Name  string
	Value string
}

type RedirectEntry struct {
	// URL is the full absolute URL that was followed.
	URL string

	// StatusCode is the 3xx status code that triggered this redirect.
	StatusCode int

	// Method is the HTTP method used for the redirected request.
	Method string

	// ResponseHeaders are the response headers from the 3xx redirect
	// response, in the order received.
	ResponseHeaders []Header
}