middleware

Oct 21, 2026

Changes in this version

type AccessLogOption

+ func WithAccessLogLogger(l logx.Logger) AccessLogOption

+ func WithAccessLogSilent() AccessLogOption

type AccessLogOptions

+ Logger logx.Logger

+ Silent bool

Oct 18, 2026

Changes in this version

type AccessRecord

+ Panic bool

Oct 18, 2026

Changes in this version

type AccessLogOption

+ func WithAccessLogSink(sink AccessSink) AccessLogOption

type AccessLogOptions

+ Sinks []AccessSink

+ type AccessRecord struct

+ ClientIP string

+ Latency time.Duration

+ Method string

+ Path string

+ Status int

+ TraceID string

+ UserAgent string

+ type AccessSink func(ctx context.Context, c *app.RequestContext, rec AccessRecord) error

type StackConfig

+ AccessLogOptions []AccessLogOption

+ DisableResponseWrap bool

Oct 18, 2026

Changes in this version

type StackConfig

+ Prometheus *PrometheusConfig

Oct 17, 2026

Changes in this version

type AccessLogOption

+ func WithAccessLogRedactPathPrefixes(prefixes ...string) AccessLogOption

type AccessLogOptions

+ RedactPathPrefixes []string

Oct 17, 2026

Changes in this version

+ func AccessLogMiddleware(opts ...AccessLogOption) app.HandlerFunc

+ func BearerTokenAuth(opts ...BearerTokenOption) app.HandlerFunc

+ func DefaultMiddleware(cfg StackConfig) []app.HandlerFunc

+ func ErrorResp(c *app.RequestContext, code int, message string)

+ func Fail(ctx context.Context, c *app.RequestContext, err error, opts ...FailOption)

+ func FailWithData(ctx context.Context, c *app.RequestContext, err error, data any, ...)

+ func I18n(opts ...I18nOption) app.HandlerFunc

+ func LangFromCtx(ctx context.Context) string

+ func MinimalMiddleware() []app.HandlerFunc

+ func RateLimitMiddleware(opts ...RateLimitOption) app.HandlerFunc

+ func RateLimitMiddlewareWithLimiter(keyed *ratelimit.KeyedLimiter, opts ...RateLimitOption) app.HandlerFunc

+ func RecoveryMiddleware(opts ...RecoveryOption) app.HandlerFunc

+ func ResponseMiddleware(opts ...ResponseOption) app.HandlerFunc

+ func SetStatusMapper(m StatusMapper)

+ func SheddingMiddleware(opts ...SheddingOption) app.HandlerFunc

+ func SkipResponseWrap(c *app.RequestContext)

+ func SuccessResp(c *app.RequestContext, data any)

+ func SuccessRespMsg(c *app.RequestContext, data any, message string)

+ func Translate(ctx context.Context, key string) string

+ type AccessLogOption func(*AccessLogOptions)

+ func WithAccessLogSkipPaths(paths ...string) AccessLogOption

+ type AccessLogOptions struct

+ SkipPaths []string

+ type Authorizer interface

+ Authorize func(ctx context.Context, c *app.RequestContext, sub Subject) (bool, error)

+ type BearerTokenOption func(*BearerTokenOptions)

+ func WithAuthAuthorizer(a Authorizer) BearerTokenOption

+ func WithAuthSkipFunc(fn func(path string) bool) BearerTokenOption

+ func WithAuthSkipPaths(paths ...string) BearerTokenOption

+ func WithAuthSubjectExtractor(fn SubjectExtractor) BearerTokenOption

+ func WithBearerToken(token string) BearerTokenOption

+ type BearerTokenOptions struct

+ Authorizer Authorizer

+ SkipFunc func(path string) bool

+ SkipPaths []string

+ SubjectExtractor SubjectExtractor

+ Token string

+ type BundleLoader func(ctx context.Context) (Catalog, error)

+ type Catalog map[string]map[string]string

+ type FailOption func(*failOptions)

+ func WithNotFoundChecker(checker func(error) bool) FailOption

+ type I18nOption func(*I18nOptions)

+ func WithI18nBundleLoader(fn BundleLoader) I18nOption

+ func WithI18nCatalog(c Catalog) I18nOption

+ func WithI18nDefaultLang(lang string) I18nOption

+ type I18nOptions struct

+ BundleLoader BundleLoader

+ Catalog Catalog

+ DefaultLang string

+ type NotFoundErrChecker func(err error) bool

+ type PrometheusConfig struct

+ Buckets []float64

+ EnableSizeMetrics bool

+ Namespace string

+ Registry prom.Registerer

+ ServiceName string

+ SkipPaths []string

+ type PrometheusMetrics struct

+ RequestDuration *prom.HistogramVec

+ RequestSize *prom.HistogramVec

+ RequestsInFlight *prom.GaugeVec

+ RequestsTotal *prom.CounterVec

+ ResponseSize *prom.HistogramVec

+ func NewPrometheusMetrics(cfg PrometheusConfig) *PrometheusMetrics

+ func (m *PrometheusMetrics) Middleware() app.HandlerFunc

+ type RateLimitOption func(*RateLimitOptions)

+ func WithLimiterTTL(ttl time.Duration) RateLimitOption

+ func WithRateLimit(r rate.Limit, burst int) RateLimitOption

+ func WithRateLimitKeyFunc(fn func(c *app.RequestContext) string) RateLimitOption

+ type RateLimitOptions struct

+ Burst int

+ KeyFunc func(c *app.RequestContext) string

+ LimiterTTL time.Duration

+ Rate rate.Limit

+ type RecoveryOption func(*RecoveryOptions)

+ func WithPanicReporter(r SentryReporter) RecoveryOption

+ func WithRecoveryErrorHandler(fn func(c *app.RequestContext, r any, stack string)) RecoveryOption

+ type RecoveryOptions struct

+ ErrorHandler func(c *app.RequestContext, r any, stack string)

+ PanicReporter SentryReporter

+ type Response struct

+ Code int

+ Data any

+ Message string

+ TraceID string

+ type ResponseOption func(*responseSkipConfig)

+ func WithSkipPaths(paths ...string) ResponseOption

+ func WithSkipPrefixes(prefixes ...string) ResponseOption

+ type SentryReporter interface

+ Report func(ctx context.Context, c *app.RequestContext, panicVal any, stack string)

+ type SheddingOption func(*SheddingOptions)

+ func WithShedder(s shedding.Shedder) SheddingOption

+ func WithShedderCPUThreshold(milli int64) SheddingOption

+ type SheddingOptions struct

+ Shedder shedding.Shedder

+ type StackConfig struct

+ SkipPaths []string

+ type StatusMapper func(bizCode int) int

+ type Subject struct

+ Claims map[string]any

+ Method string

+ Path string

+ Roles []string

+ UserID string

+ type SubjectExtractor func(c *app.RequestContext) Subject