middleware

middleware

import "github.com/agentstation/starmap/internal/server/middleware"

Package middleware provides HTTP middleware for the Starmap API server. It includes logging, recovery, CORS, authentication, and rate limiting.

Index

• func Auth(config AuthConfig, logger *zerolog.Logger) func(http.Handler) http.Handler
• func CORS(config CORSConfig) func(http.Handler) http.Handler
• func Chain(middlewares ...func(http.Handler) http.Handler) func(http.Handler) http.Handler
• func Logger(logger *zerolog.Logger) func(http.Handler) http.Handler
• func RateLimit(rl *RateLimiter) func(http.Handler) http.Handler
• func Recovery(logger *zerolog.Logger) func(http.Handler) http.Handler
• type AuthConfig
  • func DefaultAuthConfig() AuthConfig
• type CORSConfig
  • func DefaultCORSConfig() CORSConfig
• type RateLimiter
  • func NewRateLimiter(limit int, logger *zerolog.Logger) *RateLimiter

func Auth

func Auth(config AuthConfig, logger *zerolog.Logger) func(http.Handler) http.Handler

Auth middleware validates API keys for protected endpoints.

func CORS

func CORS(config CORSConfig) func(http.Handler) http.Handler

CORS middleware adds CORS headers to responses.

func Chain

func Chain(middlewares ...func(http.Handler) http.Handler) func(http.Handler) http.Handler

Chain combines multiple middleware functions into a single middleware.

func Logger

func Logger(logger *zerolog.Logger) func(http.Handler) http.Handler

Logger logs HTTP requests with structured logging.

func RateLimit

func RateLimit(rl *RateLimiter) func(http.Handler) http.Handler

RateLimit middleware limits requests per IP address.

func Recovery

func Recovery(logger *zerolog.Logger) func(http.Handler) http.Handler

Recovery recovers from panics and returns 500 error.

type AuthConfig

AuthConfig holds authentication configuration.

type AuthConfig struct {
    Enabled      bool
    APIKey       string
    HeaderName   string
    PublicPaths  []string
    BearerPrefix bool
}

func DefaultAuthConfig

func DefaultAuthConfig() AuthConfig

DefaultAuthConfig returns default authentication configuration.

type CORSConfig

CORSConfig holds CORS configuration.

type CORSConfig struct {
    AllowedOrigins []string
    AllowedMethods []string
    AllowedHeaders []string
    AllowAll       bool
}

func DefaultCORSConfig

func DefaultCORSConfig() CORSConfig

DefaultCORSConfig returns the default CORS configuration.

type RateLimiter

RateLimiter implements token bucket rate limiting per IP address.

type RateLimiter struct {
    // contains filtered or unexported fields
}

func NewRateLimiter

func NewRateLimiter(limit int, logger *zerolog.Logger) *RateLimiter

NewRateLimiter creates a new rate limiter. limit is requests per minute per IP.

Generated by gomarkdoc