web

Jun 4, 2026

Changes in this version

type App

+ func (a *App) Health()

+ func (a *App) Ready(checks ...HealthCheck)

+ func (a *App) Test(req *http.Request) *httptest.ResponseRecorder

type Context

+ func (c *Context) Attachment(path, filename string)

+ func (c *Context) File(path string)

+ func (c *Context) Redirect(code int, url string)

+ func (c *Context) SSE(event, data string) error

+ func (c *Context) Stream(code int, contentType string, r io.Reader) (int64, error)

+ type HealthCheck struct

+ Name string

+ Probe func(ctx context.Context) error

+ Timeout time.Duration

May 30, 2026

Changes in this version

+ const DefaultBodyLimit

+ func Validate(dst any) error

+ type CORSConfig struct

+ AllowCredentials bool

+ AllowedHeaders []string

+ AllowedMethods []string

+ AllowedOrigins []string

+ ExposedHeaders []string

+ MaxAgeSeconds int

+ type CSRFConfig struct

+ CookieName string

+ FormField string

+ HeaderName string

+ MaxAge int

+ SameSite http.SameSite

+ Secure bool

type Context

+ func (c *Context) BindAndValidate(dst any) error

+ func (c *Context) ClearCookie(name string, opts ...CookieOption)

+ func (c *Context) Cookie(name string) string

+ func (c *Context) SetCookie(name, value string, opts ...CookieOption)

+ func (c *Context) UnprocessableEntity(ve *ValidationError)

+ func (c *Context) WithStatus(code int) *Context

+ type CookieOption func(*http.Cookie)

+ func CookieDomain(d string) CookieOption

+ func CookieExpires(t time.Time) CookieOption

+ func CookieInsecure() CookieOption

+ func CookieMaxAge(seconds int) CookieOption

+ func CookiePath(p string) CookieOption

+ func CookieReadable() CookieOption

+ func CookieSameSite(s http.SameSite) CookieOption

type Middleware

+ func BodyLimit(n int64) Middleware

+ func CORSWithConfig(cfg CORSConfig) Middleware

+ func CSRF(cfg ...CSRFConfig) Middleware

+ func RateLimit(limit int, window time.Duration) Middleware

+ func RequestID() Middleware

+ func SecurityHeaders(cfg ...SecurityHeadersConfig) Middleware

+ func Throttle(limit int, window time.Duration) Middleware

+ type SecurityHeadersConfig struct

+ ContentSecurityPolicy string

+ FrameOptions string

+ HSTS string

+ NoSniff bool

+ PermissionsPolicy string

+ ReferrerPolicy string

+ type ValidationError struct

+ Fields map[string]string

+ Message string

+ func (e *ValidationError) Error() string

May 17, 2026

Changes in this version

type Middleware

+ func AuthJWT(m *auth.Manager) Middleware

May 15, 2026

Changes in this version

type Context

+ func (c *Context) Created(v any) any

May 15, 2026

Changes in this version

+ type App struct

+ func New(opts ...Option) *App

+ func (a *App) DB() *database.Connection

+ func (a *App) MustRun(addr ...string)

+ func (a *App) Run(addr ...string) error

+ type Context struct

+ DB *database.Connection

+ Request *http.Request

+ Writer http.ResponseWriter

+ func (c *Context) BadRequest(msg string)

+ func (c *Context) Bind(dst any) error

+ func (c *Context) Ctx() context.Context

+ func (c *Context) Error(err error) bool

+ func (c *Context) Forbidden(msg string)

+ func (c *Context) Get(key string) (any, bool)

+ func (c *Context) InternalError(err error)

+ func (c *Context) JSON(code int, v any)

+ func (c *Context) MustBind(dst any) bool

+ func (c *Context) NoContent()

+ func (c *Context) NotFound(msg string)

+ func (c *Context) Param(name string) string

+ func (c *Context) ParamInt(name string) int

+ func (c *Context) ParamUint(name string) uint64

+ func (c *Context) Query(name string) string

+ func (c *Context) QueryDefault(name, fallback string) string

+ func (c *Context) QueryInt(name string, fallback int) int

+ func (c *Context) Set(key string, value any)

+ func (c *Context) Status(code int)

+ func (c *Context) String(code int, body string)

+ func (c *Context) Unauthorized(msg string)

+ type Handler func(c *Context)

+ type Middleware func(next Handler) Handler

+ func Auth() Middleware

+ func CORS(allowedOrigins ...string) Middleware

+ func Logger(l *log.Logger) Middleware

+ func Recovery(l *log.Logger) Middleware

+ type Option func(*App)

+ func WithAddr(addr string) Option

+ func WithDatabase(conn *database.Connection) Option

+ func WithManager(mgr *database.Manager) Option

+ func WithMigrations(reg *migrations.Registry) Option

+ func WithShutdownTimeout(d time.Duration) Option

+ type ResourceController interface

+ Destroy func(c *Context)

+ Index func(c *Context)

+ Show func(c *Context)

+ Store func(c *Context)

+ Update func(c *Context)

+ type Route struct

+ Handler Handler

+ Method string

+ Path string

+ type Router struct

+ func (r *Router) APIResource(name string, ctrl ResourceController)

+ func (r *Router) Any(path string, h Handler)

+ func (r *Router) Delete(path string, h Handler)

+ func (r *Router) Get(path string, h Handler)

+ func (r *Router) Group(prefix string, fn func(g *Router))

+ func (r *Router) Head(path string, h Handler)

+ func (r *Router) Options(path string, h Handler)

+ func (r *Router) Patch(path string, h Handler)

+ func (r *Router) Post(path string, h Handler)

+ func (r *Router) Put(path string, h Handler)

+ func (r *Router) Resource(name string, ctrl ResourceController)

+ func (r *Router) Routes() []Route

+ func (r *Router) Use(mw ...Middleware)