http

type Blackbox interface {
	contract.HTTPRequester
	contract.HTTPWriter
	contract.HTTPDoer
}

type Client interface {
	Blackbox
	QueryString(pairs ...string) string
	RespondJSON(w http.ResponseWriter, v any, status int, escapeHTML bool) error
	RespondError(w http.ResponseWriter, status int, escapeHTML bool)
	RespondGzipJSON(w http.ResponseWriter, v any, status int, escapeHTML bool) error
	RespondGzipError(w http.ResponseWriter, status int, escapeHTML bool)
	ValidateQueryParams(q map[string][]string, rules ...*QueryParamRule) error
	ServeHTML(w http.ResponseWriter, body io.Reader, status int)
	CopyHeaders(dst, src *http.Request, headers ...string)
	GetHeaders(r *http.Request) http.Header
	DecodeBody(r *http.Request, v any) error
}

type QueryParamRule struct {
	Key                   string   // Name of the query parameter.
	DefaultValue          string   // Default value if not provided in the request.
	AcceptedValues        []string // Accepted values; nil allows any value.
	MultipleValuesAllowed bool     // Whether multiple values are permitted.
	Optional              bool     // Whether the parameter is optional.
}