codec

type Codec interface {
	// Name returns the Smithy protocol shape ID, e.g. NameAWSJSON10.
	// Used for diagnostics, logging, and the Smithy-Protocol response
	// header (rpcv2Cbor only).
	Name() string

	// Decode reads r.Body into into. into MUST be a non-nil pointer to a
	// typed input struct. Returns a *protocol.AWSError populated with a
	// 4xx code on malformed input, or nil on success.
	//
	// Decode is responsible for draining and closing r.Body so the
	// HTTP/1.1 connection can be reused. Callers MUST NOT touch r.Body
	// after calling Decode.
	Decode(r *http.Request, into any) *protocol.AWSError

	// WriteResponse serialises v as a successful response body using the
	// codec's native format and writes it to w with status. v may be nil
	// or a typed pointer; nil is rendered as the codec's empty-response
	// representation (e.g. "{}" for JSON).
	WriteResponse(w http.ResponseWriter, r *http.Request, status int, v any)

	// WriteError serialises aerr in the codec's native error envelope.
	// The HTTP status comes from aerr.HTTPStatus.
	WriteError(w http.ResponseWriter, r *http.Request, aerr *protocol.AWSError)
}

type Identifier interface {
	// Claim returns (codec, operationName, true) on a match, or
	// (nil, "", false) if the request does not match this protocol.
	Claim(r *http.Request) (Codec, string, bool)
}