type BaseInputModel struct{}

type BinaryResult struct {

	// StatusCode, if provided, use this value, otherwise HTTP 200.
	StatusCode int

	// ContentType, if provided, use this value.
	ContentType string

	// ContentDisposition, if provided, use this value.
	ContentDisposition string

	// Headers, if provided, are added to the response
	Headers map[string][]string

	// Content, if provided, use this value, otherwise no content will be written to the response stream.
	Content []byte
}

type CSV interface {
	// Header returns all the column names for the CSV
	Header() []string
	// CSV returns an iterator that returns one row at a time to be rendered to the CSV
	CSV() iter.Seq[[]string]
}

type DeserializeBody interface {
	Body() any
}

type Deserializer interface {
	// Deserialize renders the decodes the source stream into the instance provided. If there are any problems, an error is returned.
	Deserialize(any, io.Reader) error
}

type InputError struct {

	// Fields indicates the exact location(s) of the errors including the part of the HTTP request itself this is
	// invalid. Valid field prefixes include "path", "query", "header", "form", and "body".
	Fields []string `json:"fields,omitempty"`

	// ID represents the unique, numeric contractual identifier that can be used to associate this error with a particular front-end error message, if any.
	ID int `json:"id,omitempty"`

	// Name represents the unique string-based, contractual value that can be used to associate this error with a particular front-end error message, if any.
	Name string `json:"name,omitempty"`

	// Message represents a friendly, user-facing message to indicate why there was a problem with the input.
	Message string `json:"message,omitempty"`

	// Context represents a error-specific value in the form a serializable instance that the client can use to get more understanding about the error itself.
	Context any `json:"context,omitempty"`
}

type InputErrors struct {
	Errors []error `json:"errors,omitempty"`
}

type InputModel interface {
	// Reset clears the contents of the instance and prepares it for the next use.
	Reset()
	// Bind maps the values on the HTTP request provided to fields on the instance. If there are any problems and error
	// is returned which can then be rendered on the response using the configured callback.
	Bind(*http.Request) error
	// Validate ensures that the instance has all the necessary fields appropriately populated. The slice of errors
	// provided is a pre-allocated buffer in which to place any errors encountered during validation. It returns the
	// number of errors placed into the buffer provided.
	Validate([]error) int
}

type Monitor interface {
	HandlerCreated()
	RequestReceived()
	NotAcceptable()
	UnsupportedMediaType()
	Deserialize()
	DeserializeFailed()
	ParseForm()
	ParseFormFailed(error)
	Bind()
	BindFailed(error)
	Validate()
	ValidateFailed([]error)
	TextResult()
	BinaryResult()
	StreamResult()
	SerializeResult()
	NativeResult()
	SerializeFailed()
	ResponseStatus(int)
	ResponseFailed(error)
}

type Processor interface {
	Process(context.Context, any) any
}

type Reader interface {
	Read(InputModel, *http.Request) any
}

type ResultContainer interface {
	SetContent(any)
	Result() any
}

type SerializeResult struct {

	// StatusCode, if provided, use this value, otherwise HTTP 200.
	StatusCode int

	// ContentType, if provided, use this value.
	ContentType string

	// Headers, if provided, are added to the response
	Headers map[string][]string

	// Content, if provided, use this value, otherwise no content will be written to the response stream.
	Content any
}

type Serializer interface {
	// Serialize renders the instance provided to the io.Writer. If there are any problems, an error is returned.
	Serialize(io.Writer, any) error
	// ContentType returns HTTP Content-Type header that will be used when writing to the HTTP response.
	ContentType() string
}

type StreamResult struct {

	// StatusCode, if provided, use this value, otherwise HTTP 200.
	StatusCode int

	// ContentType, if provided, use this value.
	ContentType string

	// ContentDisposition, if provided, use this value.
	ContentDisposition string

	// Headers, if provided, are added to the response
	Headers map[string][]string

	// Content, if provided, use this value, otherwise no content will be written to the response stream.
	Content io.Reader
}

type TextResult struct {

	// StatusCode, if provided, use this value, otherwise HTTP 200.
	StatusCode int

	// ContentType, if provided, use this value.
	ContentType string

	// Headers, if provided, are added to the response
	Headers map[string][]string

	// Content, if provided, use this value, otherwise no content will be written to the response stream.
	Content string
}

type Writer interface {
	Write(http.ResponseWriter, *http.Request, any)
}