routerfx

type Context interface {
	// Context extend the [context.Context] interface by proxying to [http.Request.Context]
	context.Context

	// Inject inject underlying [context.Context]
	Inject(fn func(ctx context.Context) context.Context)

	// Req returns the underlying *http.Request
	Req() *http.Request

	// Header returns the headers of underlying [http.ResponseWriter]
	Header() http.Header

	// Bind unmarshal the request data into any struct with json tags
	//
	// HTTP header is prefixed with "header_"
	//
	// HTTP query is prefixed with "query_"
	//
	// both JSON and Form are supported
	Bind(data interface{})

	// Files returns the multipart file headers
	Files() map[string][]*multipart.FileHeader

	// Code set the response code, can be called multiple times
	Code(code int)

	// Body set the response body with content type, can be called multiple times
	Body(contentType string, buf []byte)

	// Text set the response body to plain text
	Text(s string)

	// JSON set the response body to json
	JSON(data interface{})

	// Perform actually perform the response
	// it is suggested to use in defer, recover() is included to recover from any panics
	Perform()
}

type HandlerFunc func(c Context)

type Options struct {
	fx.In

	*Params

	Routes []Route `group:"winterfx_core_routerfx_routes"`
}

type Params struct {
	LoggingResponse bool
	LoggingRequest  bool
	Concurrency     int
}

type Route struct {
	Pattern string
	HandlerFunc
}

type RouteOptions struct {
	LoggingRequest  bool
	LoggingResponse bool
}

type Router interface {
	http.Handler
}