client

type APIError struct {
	Method     string // HTTP method of the failed request
	URL        string // request URL (path + query)
	StatusCode int    // HTTP status code
	Message    string // human-readable message extracted from the body
	Body       string // raw response body (truncated)
}

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

type Authorizer interface {
	// Authorize mutates the request to carry authentication.
	Authorize(*http.Request)
}

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

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

type Option func(*Client)

type RawBody struct {
	Bytes       []byte
	ContentType string
}

type Request struct {
	// Method is the HTTP method (GET, POST, PATCH, PUT, DELETE).
	Method string
	// Path is appended to the client's base URL. A leading slash is optional.
	Path string
	// Query holds URL query parameters.
	Query url.Values
	// Body, when non-nil, is JSON-encoded and sent as the request body.
	// If Body already implements io.Reader it is sent verbatim.
	Body any
	// ContentType overrides the request Content-Type. Defaults to
	// "application/json" when a body is present.
	ContentType string
	// Header holds extra request headers (applied after defaults, so they win).
	Header http.Header
	// Out, when non-nil, receives the JSON-decoded response body.
	Out any
}

type Response struct {
	StatusCode int
	Header     http.Header
}