bhttp

type InformationalResponse struct {
	StatusCode int
	// Header contains the headers as FieldLines for the BHTTP encoded message. This
	// usually differs from what a net/http response contains, as Go 	moves some headers
	// to/from fields. For example, the Host and Content-Length headers.
	Header http.Header
}

type InvalidMessageError struct {
	Err error
}

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

type Request struct {
	// KnownLength indicates whether the request should/is encoded as a known or indeterminate
	// length message.
	KnownLength bool
	// ContentLength is the Body length of a known length request. Ignored for indeterminate length messages.
	ContentLength int64
	// ControlData contains the RequestControlData. This data is passed as-is to the encoded/decoded messages,
	// mapping functions should take extra care to validate this data.
	ControlData RequestControlData
	// Header contains the headers that will be encoded to the BHTTP message.
	//
	// This might differ from what the original net/http request contains as net/http manages a few headers
	// behind the scenes.
	//
	// For example, while net/http takes the Content-Length header from the .ContentLength field on the original
	// request, the Content-Length header should be set in this map (if it's used).
	Header http.Header
	// Body usually reads the body of the original net/http request.
	Body io.Reader
	// Trailer works similar to the http.Request.Trailer field. It is up the MapFunc to:
	// - Initialize the keys of the Trailer map.
	// - Ensure that an appropriate Trailer header is added to the Header field.
	// - The values of the Trailer map are set when Body returns io.EOF.
	Trailer http.Header
}

type RequestControlData struct {
	// Method contains the :method pseudo-header according to RFC9113 Section 8.1.2.3.
	Method []byte
	// Scheme contains the :scheme pseudo-header according to RFC9113 Section 8.1.2.3.
	// Note: BHTTP RFC makes this required, so we can't omit it like in HTTP 2.
	Scheme []byte
	// Authority contains the :authority pseudo-header according to RFC9113 Section 8.1.2.3.
	// Note: BHTTP RFC requires us to provide an empty encoding when omitted.
	Authority []byte
	// Path contains the :scheme pseudo-header according to RFC9113 Section 8.1.2.3.
	// Note: BHTTP RFC makes this required, so we can't omit it like in HTTP 2.
	Path []byte
}

type RequestDecoder struct {
	// MaxHeaderBytes is the maximum number of header bytes that can be read. Will default to 16KB.
	MaxHeaderBytes int64

	// MapFunc determines how a BHTTP request is interpreted. If this field is nil, the decoder will default
	// to interpreting the BHTTP request as a an unproxied HTTP/1.1 server side request.
	MapFunc RequestToHTTP
}

type RequestEncoder struct {
	// MapFunc maps a net/http Request to a BHTTP response. If this field is nil, [DefaultRequestFromHTTP] will be used
	// which interprets net/http requests as unproxied HTTP/1.1 client side requests.
	MapFunc RequestFromHTTP

	// PadToMultipleOf pads the message with zeroes until it reaches a multiple of this number. 0 will add no padding.
	PadToMultipleOf uint64

	// MaxEncodedChunkLen is the maximum length of indeterminate length content chunks (including their length prefix). MaxEncodedChunkLen
	// should be at least 2 bytes so that it will always fit a quicencoded integer with some data. If this field is 0, it
	// will default to 4096.
	MaxEncodedChunkLen int
	// contains filtered or unexported fields
}

type RequestFromHTTP func(r *http.Request) (*Request, error)

type RequestToHTTP func(ctx context.Context, r *Request) (*http.Request, error)

type Response struct {
	// KnownLength indicates whether the response should/is encoded as a known or indeterminate
	// length message.
	KnownLength bool
	// ContentLength is the Body length of a known length request. Ignored for indeterminate length messages.
	ContentLength int64
	// Informational contains an array of InformationalResponses (1xx status codes and attendant headers)
	// They do not map to go Response objects, so would need to be manually encoded.
	Informational []InformationalResponse
	// FinalStatusCode contains the 2xx-5xx status code of the final response.
	FinalStatusCode int
	// FinalHeader contains the headers for the final response.
	//
	// This might differ from what the original net/http response contains as net/http manages a few headers
	// behind the scenes.
	//
	// For example, while net/http takes the Content-Length header from the .ContentLength field on the original response, the
	// Content-Length header should be set in this map (if it's used).
	FinalHeader http.Header
	// Body usually reads the body of the original net/http response.
	Body io.Reader
	// Trailer works similar to the http.Response.Trailer field. It is up the MapFunc to:
	// - Initialize the keys of the Trailer map.
	// - Ensure that an appropriate Trailer header is added to the Header field.
	// - The values of the Trailer map are set when Body returns io.EOF.
	Trailer http.Header
}

type ResponseDecoder struct {
	// MaxHeaderBytes is the maximum number of header bytes that can be read. Will default to 16KB.
	MaxHeaderBytes int64

	// MapFunc maps a [*Response] to a net/http Response. If this field is nil, [*Response] will be mapped to a
	// server-side, unproxied response.
	MapFunc ResponseToHTTP
}

type ResponseEncoder struct {
	// MapFunc maps a net/http response . If this field is nil, DefaultResponseMapFunc will be used.
	MapFunc ResponseFromHTTP

	// PadToMultipleOf pads the message with zeroes until it reaches a multiple of this number. 0 will add no padding.
	PadToMultipleOf uint64

	// MaxEncodedChunkLen is the maximum length of indeterminate length content chunks (including their length prefix). MaxEncodedChunkLen
	// should be at least 2 bytes so that it will always fit a quicencoded integer with some data. If this field is 0, it
	// will default to 4096.
	MaxEncodedChunkLen int
	// contains filtered or unexported fields
}

type ResponseFromHTTP func(r *http.Response) (*Response, error)

type ResponseToHTTP func(ctx context.Context, r *Response) (*http.Response, error)