contract

type ErrorHandler func(
	runtime runtimecontract.Runtime,
	writer nethttp.ResponseWriter,
	request Request,
	err error,
) Response

type ForwardedHeadersPolicy struct {
	TrustForwardedHeaders bool
	TrustedProxyList      []string
}

type Handler func(
	runtimeInstance runtimecontract.Runtime,
	writer nethttp.ResponseWriter,
	request Request,
) (Response, error)

type Kernel interface {
	Use(middlewares ...Middleware)

	SetNotFoundHandler(handler Handler)

	SetErrorHandler(handler ErrorHandler)

	SetForwardedHeadersPolicy(policy ForwardedHeadersPolicy)

	SetSessionCookiePolicy(policy SessionCookiePolicy)

	ServeHttp(serviceContainer containercontract.Container) nethttp.Handler
}

type MatchResult struct {
	Handler         Handler
	Params          map[string]string
	RouteAttributes map[string]any
}

type Middleware func(next Handler) Handler

type RateLimiter interface {
	Allow(key string) bool

	Reset(key string)
}

type Request interface {
	HttpRequest() *nethttp.Request

	Param(name string) (string, bool)

	Params() map[string]string

	Query() bagcontract.ParameterBag

	Post() bagcontract.ParameterBag

	Attributes() bagcontract.ParameterBag

	Header(name string) string

	RouteName() string

	RoutePattern() string

	RuntimeInstance() runtimecontract.Runtime

	RequestContext() RequestContext
}

type RequestContext interface {
	RequestId() string

	StartedAt() time.Time
}

type Response interface {
	StatusCode() int

	SetStatusCode(statusCode int)

	Headers() nethttp.Header

	SetHeaders(headers nethttp.Header)

	BodyReader() io.Reader

	SetBodyReader(reader io.Reader)
}

type RouteDefinition interface {
	Name() string

	Pattern() string

	Methods() []string

	Host() string

	Schemes() []string

	Requirements() map[string]string

	Defaults() map[string]string

	Locales() []string

	Priority() int

	Attributes() map[string]any
}

type RouteRegistry interface {
	RouteDefinitions() []RouteDefinition

	RouteDefinition(routeName string) (RouteDefinition, bool)

	RouteDefinitionForUrlGeneration(routeName string) (UrlGenerationRouteDefinition, bool)
}

type Router interface {
	RouteDefinitions() []RouteDefinition

	RouteDefinition(routeName string) (RouteDefinition, bool)

	Handle(method string, pattern string, handler Handler)

	HandleNamed(name string, method string, pattern string, handler Handler)

	Match(method string, path string, host string, scheme string) (*MatchResult, bool)
}

type SessionCookiePolicy struct {
	Path     string
	Domain   string
	SameSite nethttp.SameSite
}

type UrlGenerationRouteDefinition interface {
	Pattern() string

	Defaults() map[string]string

	Requirements() map[string]*regexp.Regexp
}

type UrlGenerator interface {
	GeneratePath(routeName string, params map[string]string) (string, error)

	GenerateUrl(routeName string, params map[string]string, queryParams map[string]string) (string, error)
}