httpclient

type BreakerOptions struct {
	// Failures is the number of consecutive failures (transport errors and
	// 5xx responses) that opens a host's circuit (default 5).
	Failures int
	// Cooldown is how long the circuit stays open before one trial
	// request may go through (default 30s).
	Cooldown time.Duration
}

type Limit struct {
	// PerSecond is the sustained request rate per host; 0 means no rate
	// limit.
	PerSecond float64
	// Burst is how many requests may go at once after an idle period
	// (default 1).
	Burst int
	// InFlight bounds the requests per host whose response body is still
	// open; 0 means no bound.
	InFlight int
}

type Options struct {
	// Timeout bounds the whole request (default 10s).
	Timeout time.Duration
	// MaxBody bounds response bodies; reads past it fail (default 10 MiB).
	MaxBody int64
	// MaxRedirects (default 5).
	MaxRedirects int
	// Allow lists extra prefixes that may be reached (e.g. an internal
	// service network). Use sparingly.
	Allow []netip.Prefix
	// WrapTransport, when set, wraps the client's transport (tracing,
	// metrics; drivers/otel's Transport fits). It must delegate every
	// request to the transport it is given: the address check runs in that
	// transport's dialer, so a delegating wrapper cannot reach blocked
	// addresses. A wrapper returning nil makes every request fail with
	// ErrNilTransport (http.Client would otherwise use
	// http.DefaultTransport, which has no address check).
	WrapTransport func(http.RoundTripper) http.RoundTripper
}

type RetryPolicy struct {
	// Attempts is the total number of tries, the first included
	// (default 3).
	Attempts int
	// Base is the first backoff delay, doubled on every retry with full
	// jitter (default 200ms).
	Base time.Duration
	// Max caps every delay (default 30s). A Retry-After longer than Max
	// is not waited for: the response is returned as is.
	Max time.Duration
}

type RoundTripperFunc func(*http.Request) (*http.Response, error)