httpclient

type BearerTransport struct {
	Token string
	Base  http.RoundTripper
}

type CertSource interface {
	// Certificate returns the current client cert+key for TLS handshake.
	Certificate() (tls.Certificate, error)
}

type ClientName string

type ClientSpec struct {
	Timeout             time.Duration
	CertSource          CertSource          // nil = no client certificate
	TransportMiddleware TransportMiddleware // nil = no wrapping
	RootCAPath          string              // PEM-encoded CA cert file to trust; empty = system roots
	BaseURL             string              // optional origin for relative Lua URLs; empty = none
	MaxIdleConnsPerHost int                 // 0 = DefaultMaxIdleConnsPerHost
}

type FileCertSource struct {
	CertPath string
	KeyPath  string
}

type HTTPClientObserver interface {
	// RequestStarted is called when an outbound HTTP request begins.
	// clientName is the [ClientName] from the registry (empty for inline clients).
	// Returns a potentially modified context and a probe to track the request.
	RequestStarted(ctx context.Context, clientName string, method string, host string) (context.Context, RequestProbe)
}

type HeadersTransport struct {
	Headers map[string]string
	Base    http.RoundTripper
}

type LuaClient struct {
	Client  *http.Client
	BaseURL string
}

type NoOpHTTPClientObserver struct{}

type NoOpRequestProbe struct{}

type Registry struct {
	// contains filtered or unexported fields
}

type RegistryOption func(*registryConfig)

type RequestProbe interface {
	// StatusCode records the HTTP response status code.
	StatusCode(code int)

	// Error records a transport-level error (timeout, connection refused, etc.).
	Error(err error)

	// ConnectionReused records whether the underlying TCP connection was
	// reused (true) or newly established (false). Called from an
	// httptrace.ClientTrace.GotConn callback during the round-trip.
	ConnectionReused(reused bool)

	// ProtocolVersion records the negotiated HTTP protocol version
	// (e.g. "HTTP/1.1", "HTTP/2.0") from the response. Only called on
	// successful round-trips; omitted on transport-level errors.
	ProtocolVersion(proto string)

	// End signals the request is complete (for timing). Called via defer.
	End()
}

type TransportMiddleware func(base http.RoundTripper) http.RoundTripper