courierhttp

type BasePathDescriber interface {
	BasePath() string
}

type ContentTypeDescriber interface {
	ContentType() string
}

type CookiesDescriber interface {
	Cookies() []*http.Cookie
}

type ErrResponseWriter interface {
	WriteErr(ctx context.Context, rw http.ResponseWriter, req Request, statusErr *statuserror.StatusErr)
}

type ErrorResponse interface {
	Error() string
	Unwrap() error

	StatusCodeDescriber
	ContentTypeDescriber
	CookiesDescriber
	courier.MetadataCarrier
}

type FileHeader interface {
	io.ReadCloser

	Filename() string
	Header() http.Header
}

type Method struct {
}

type MethodConnect struct{}

type MethodDelete struct{}

type MethodDescriber interface {
	Method() string
}

type MethodGet struct{}

type MethodHead struct{}

type MethodOptions struct{}

type MethodPatch struct{}

type MethodPost struct{}

type MethodPut struct{}

type MethodTrace struct{}

type OperationInfo struct {
	Server
	ID     string
	Method string
	Route  string
}

type PathDescriber interface {
	Path() string
}

type RedirectDescriber interface {
	StatusCodeDescriber
	Location() *url.URL
}

type Request interface {
	Context() context.Context

	ServiceName() string

	Method() string
	Path() string
	Header() http.Header
	Values(in string, name string) []string
	Body() io.ReadCloser

	Underlying() *http.Request
}

type Response[T any] interface {
	Underlying() T
	StatusCodeDescriber
	ContentTypeDescriber
	CookiesDescriber
	courier.MetadataCarrier
}

type ResponseSetting interface {
	SetStatusCode(statusCode int)
	SetLocation(location *url.URL)
	SetContentType(contentType string)
	SetMetadata(key string, values ...string)
	SetCookies(cookies []*http.Cookie)
}

type ResponseSettingFunc = func(s ResponseSetting)

type ResponseWriter interface {
	WriteResponse(ctx context.Context, rw http.ResponseWriter, req Request) error
}

type RouteDescriber interface {
	MethodDescriber
	PathDescriber
}

type Server struct {
	Name    string
	Version string
}

type StatusCodeDescriber interface {
	StatusCode() int
}

type Transformer interface {
	// Names name or alias of transformer
	// prefer using some keyword about content-type
	Names() []string

	// New transformer instance by type
	// in this step will to check transformer is valid for type
	New(context.Context, typesutil.Type) (Transformer, error)

	// EncodeTo writer
	EncodeTo(w io.Writer, v any) (mediaType string, err error)

	// DecodeFrom reader
	DecodeFrom(r io.Reader, v any, headers ...textproto.MIMEHeader) error
}

type WithHeader interface {
	Header() http.Header
}