Middleware
Kori uses the same middleware signature as Chi and the standard library:
type Middleware = func(http.Handler) http.HandlerThis is a type alias, not a new type. Any existing net/http or Chi middleware works with Kori without adaptation.
Standard Chi middleware
Section titled “Standard Chi middleware”Global middleware is registered on the Chi router with r.Use. It applies to all handlers — both Chi and Kori:
r := chi.NewRouter()
r.Use(middleware.RequestID)r.Use(middleware.Logger)r.Use(middleware.Recoverer)r.Use(middleware.Timeout(30 * time.Second))
kori.GET(r, "/users", listUsers)kori.POST(r, "/users", createUser)Middleware in Kori
Section titled “Middleware in Kori”Kori provides two ways to attach middleware below the global level: per-group and per-route.
Group-level middleware
Section titled “Group-level middleware”Middleware passed to kori.Group applies to every route registered under that group:
api := kori.Group(r, "/api", authMiddleware)
kori.GET(api, "/users", listUsers) // authMiddleware applieskori.POST(api, "/users", createUser) // authMiddleware appliesMultiple middleware functions are passed in order:
admin := kori.Group(r, "/admin", authMiddleware, auditMiddleware)
kori.GET(admin, "/stats", statsHandler)kori.DELETE(admin, "/users/{id}", deleteUser)Route-level middleware
Section titled “Route-level middleware”kori.Use attaches middleware to a single route. It returns an Option passed at registration time:
kori.DELETE(r, "/admin/users/{id}", deleteUser, kori.Use(authMiddleware, auditMiddleware),)Multiple kori.Use calls on the same route compose in order:
kori.POST(r, "/payments", createPayment, kori.Use(authMiddleware), kori.Use(idempotencyMiddleware),)Global middleware
Section titled “Global middleware”For middleware that must run on every request, use r.Use on the root Chi router:
r := chi.NewRouter()r.Use(middleware.Logger)r.Use(middleware.Recoverer)Middleware precedence
Section titled “Middleware precedence”Middleware executes from outermost to innermost. The order is:
- Global (
r.Use) - Group-level (passed to
kori.Group) - Route-level (
kori.Use)
r := chi.NewRouter()r.Use(logMiddleware) // 1. runs first
api := kori.Group(r, "/api", authMiddleware) // 2. runs second
kori.DELETE(api, "/users/{id}", deleteUser, kori.Use(auditMiddleware), // 3. runs third)