Rene Nochebuena
c4ef1948f6
Introduces code.nochebuena.dev/einherjar/web — the HTTP transport layer of the
Einherjar framework. Absorbs httpserver, httpmw, and httputil from micro-lib,
replacing gorilla/mux with chi, adopting SecurityBag-native middleware, and
centralizing error handling through a single httputil.Error function.
server:
- Server interface — embeds lifecycle.Component and chi.Router
- Config struct (EINHERJAR_SERVER_* env vars); DefaultConfig
- New(logger, cfg, opts...) Server; WithMiddleware option
- Binds TCP synchronously in OnStart; logs "server: listening" on success
- Graceful shutdown within ShutdownTimeout on OnStop
mw:
- Recover — catches panics, returns 500, logs at Error
- RequestID — injects UUID v7 (UUID v4 fallback) into context and X-Request-ID header
- RequestLogger — structured access log per request
- CORS / CORSAllowAll — chi-based, applied only when origins non-empty
- IPRateLimit / UserRateLimit — pluggable RateLimiterStore interface
- InMemoryRateLimiterStore — token-bucket backed by golang.org/x/time/rate;
background goroutine evicts stale entries every 5 minutes
- StatusRecorder — wraps ResponseWriter to capture HTTP status code
httputil:
- Handle[Req, Res] / HandleNoBody[Res] / HandleEmpty[Req] — generic handler adapters
- Error(logger, w, r, err) — derives log level from status (≥500→Error, 4xx→Warn,
499→Info); writes standardized JSON body; logz enriches *xerrors.Err automatically
- JSON(w, status, v) / NoContent(w) — response helpers
- HandlerFunc adapter type
health:
- NewHandler / NewHandlerWithConfig — runs all Checkable checks concurrently;
returns JSON {status, components} with per-component latency and error
- Config struct (EINHERJAR_HEALTH_CHECK_TIMEOUT, default 5s)
Root factory:
- web.New(logger, cfg...) Server — composes Recover+RequestID+RequestLogger+CORS
in outermost-first order; CORS applied only when AllowedOrigins non-empty
- server.Server interface and web/server/identifiable.go: embeds observability.Identifiable;
ModulePath and ModuleVersion read via runtime/debug.ReadBuildInfo() — prints in launcher banner
38 lines
999 B
Go
38 lines
999 B
Go
// Package server provides a lifecycle-managed chi HTTP server.
|
|
//
|
|
// The server implements [lifecycle.Component] from contracts, making it
|
|
// directly compatible with [launcher.New] without any adapter layer.
|
|
//
|
|
// # Example
|
|
//
|
|
// srv := server.New(logger, server.Config{Port: 8080},
|
|
// server.WithMiddleware(
|
|
// mw.Recover(),
|
|
// mw.RequestID(uuid.NewString),
|
|
// mw.RequestLogger(logger),
|
|
// ),
|
|
// )
|
|
//
|
|
// lc := launcher.New(logger)
|
|
// lc.Append(srv)
|
|
// lc.BeforeStart(func() error {
|
|
// srv.Get("/health", healthHandler)
|
|
// return nil
|
|
// })
|
|
package server
|
|
|
|
import (
|
|
"github.com/go-chi/chi/v5"
|
|
|
|
"code.nochebuena.dev/einherjar/contracts/lifecycle"
|
|
"code.nochebuena.dev/einherjar/contracts/observability"
|
|
)
|
|
|
|
// Server is a lifecycle-managed HTTP server that exposes a chi router.
|
|
// Embed chi.Router gives callers the full routing API: Get, Post, Route, Mount, Use, etc.
|
|
type Server interface {
|
|
lifecycle.Component
|
|
observability.Identifiable
|
|
chi.Router
|
|
}
|