timeout

type ClientConfig struct {
	// Total timeout for the entire request (including redirects).
	// Default: 30 seconds.
	Timeout time.Duration

	// DialTimeout is the maximum time to establish a connection.
	// Default: 10 seconds.
	DialTimeout time.Duration

	// TLSHandshakeTimeout is the maximum time for TLS handshake.
	// Default: 10 seconds.
	TLSHandshakeTimeout time.Duration

	// ResponseHeaderTimeout is the maximum time to wait for response headers.
	// Default: 10 seconds.
	ResponseHeaderTimeout time.Duration

	// IdleConnTimeout is the maximum time an idle connection will remain open.
	// Default: 90 seconds.
	IdleConnTimeout time.Duration

	// MaxIdleConns controls the maximum number of idle connections.
	// Default: 100.
	MaxIdleConns int

	// MaxIdleConnsPerHost controls idle connections per host.
	// Default: 10.
	MaxIdleConnsPerHost int

	// MaxConnsPerHost limits total connections per host.
	// Default: 0 (no limit).
	MaxConnsPerHost int

	// ExpectContinueTimeout is the time to wait for 100-continue response.
	// Default: 1 second.
	ExpectContinueTimeout time.Duration
}

type Config struct {
	// Timeout is the maximum duration for handling a request.
	// Default: 30 seconds.
	Timeout time.Duration

	// OnTimeout is called when a request times out.
	// If nil, a default 503 Service Unavailable response is sent.
	OnTimeout func(w http.ResponseWriter, r *http.Request)

	// Skipper determines whether to skip timeout for a request.
	// Useful for SSE, WebSocket upgrades, or long-polling endpoints.
	Skipper func(r *http.Request) bool

	// ErrorHandler handles panics that occur during request processing.
	// If nil, panics are re-raised after timeout cleanup.
	ErrorHandler func(w http.ResponseWriter, r *http.Request, err interface{})
}

type Transport struct {
	// Base is the underlying transport. If nil, http.DefaultTransport is used.
	Base http.RoundTripper

	// Timeout is the per-request timeout.
	Timeout time.Duration
}