api

type Authorizer func(huma.Context) error

type CRUD[
	CB interface {
		Decode(context.Context, *M) error
	},
	UB interface {
		Decode(context.Context, *M) error
	},
	M any,
	ID any,
] struct {
	Info CRUDInfo
	List[M]
	Read[M, ID]
	Create[CB, M, ID]
	Update[UB, M, ID]
	Delete[ID]
	DeleteMany[ID]
}

type CRUDInfo struct {
	Area    string
	Version string
}

type Create[B interface {
	Decode(context.Context, *M) error
}, M any, ID any] struct {
	Saver            func(context.Context, *M) error
	Location         func(string, M) *CreateResponse
	ErrorTransformer ErrorTransformerFunc
	Operation        huma.Operation
}

type CreateInput[B any] struct {
	Body B
}

type CreateResponse struct {
	Location string `header:"Content-Location"`
}

type Delete[ID any] struct {
	Deleter          func(context.Context, ...ID) error
	ErrorTransformer ErrorTransformerFunc
	Operation        huma.Operation
}

type DeleteMany[ID any] struct {
	Deleter          func(context.Context, ...ID) error
	ErrorTransformer ErrorTransformerFunc
	Operation        huma.Operation
}

type ErrorTransformerFunc func(context.Context, error) error

type Handler interface {
	Area() string
	Version() string
	Register(*echo.Echo, huma.API)
}

type IDInput[ID any] struct {
	ID ID `path:"id"`
}

type IDsInput[ID any] struct {
	IDs []ID `query:"ids" required:"true" minItems:"1" nullable:"false"`
}

type List[M any] struct {
	Finder           func(context.Context, *cr.Criteria) ([]M, int, error)
	ErrorTransformer ErrorTransformerFunc
	Operation        huma.Operation
}

type ListInput struct {
	Page   int    `query:"page" json:"page,omitempty" yaml:"page,omitempty" required:"false"`
	Limit  int    `query:"limit" json:"limit,omitempty" yaml:"limit,omitempty" required:"false"`
	Sort   string `query:"sort" json:"sort,omitempty" yaml:"sort,omitempty" required:"false"`
	Filter string `query:"filter" json:"filter,omitempty" yaml:"filter,omitempty" required:"false"`
}

type ListOutput[E any] struct {
	ListInput
	Items []E `json:"items,omitempty" yaml:"items,omitempty" required:"false"`
	Total int `json:"total,omitempty" yaml:"total,omitempty" required:"false"`
}

type Middleware struct {
	Name       string
	Middleware func(huma.API) func(huma.Context, func(huma.Context))
}

type Option func(*huma.Operation)

type Read[M any, ID any] struct {
	Finder           func(context.Context, ID) (M, error)
	ErrorTransformer ErrorTransformerFunc
	Operation        huma.Operation
}

type Response[B any] struct {
	Body B
}

type Update[B interface {
	Decode(context.Context, *M) error
}, M any, ID any] struct {
	Finder           func(context.Context, ID) (M, error)
	Saver            func(context.Context, *M) error
	ErrorTransformer ErrorTransformerFunc
	Operation        huma.Operation
}

type UpdateInput[B any, ID any] struct {
	ID   ID `path:"id"`
	Body B
}