httprequest

type HTTPDoer interface {
	Do(*http.Request) (*http.Response, error)
}

type Options struct {
	Prepare      Preparer
	TimeoutMs    int
	MaxChars     int
	MaxRedirects int
	UserAgent    string
	Now          func() time.Time
}

type PrepareInput struct {
	RawURL          string
	TimeoutMs       int
	FollowRedirects bool
	MaxRedirects    int
	// CredentialSensitive asks the Host to apply its credential-safe redirect
	// policy. It does not prescribe same-origin rules or header handling.
	CredentialSensitive bool
	// OnRedirect receives display-safe redirect observations from the Host.
	// The Host remains responsible for validating every redirect before it is
	// followed. Portable retrieval uses this hook only for diagnostics.
	OnRedirect func(context.Context, string, int)
}

type PreparedRequest struct {
	URL   *url.URL
	Doer  HTTPDoer
	Close func()
}

type Preparer func(context.Context, PrepareInput) (PreparedRequest, error)

type Request struct {
	Method          string            `json:"method,omitempty"`
	URL             string            `json:"url"`
	Headers         map[string]string `json:"headers,omitempty"`
	Query           map[string]string `json:"query,omitempty"`
	Body            string            `json:"body,omitempty"`
	TimeoutMs       int               `json:"timeout_ms,omitempty"`
	MaxChars        int               `json:"max_chars,omitempty"`
	FollowRedirects *bool             `json:"follow_redirects,omitempty"`
	MaxRedirects    int               `json:"max_redirects,omitempty"`
}