middleware

type CORSConfig struct {
	// AllowOrigins 是允许的源列表，例如 ["https://example.com"]
	// 特殊的 "*" 表示允许所有源
	AllowOrigins []string

	// AllowMethods 是允许的HTTP方法列表
	// 默认是 ["GET", "POST", "PUT", "DELETE", "OPTIONS", "PATCH"]
	AllowMethods []string

	// AllowHeaders 是允许的HTTP头部列表
	// 默认是 ["Origin", "Content-Type", "Content-Length", "Accept", "Authorization"]
	AllowHeaders []string

	// ExposeHeaders 是客户端可以访问的自定义头部列表
	ExposeHeaders []string

	// AllowCredentials 表示请求中是否可以包含用户凭证
	AllowCredentials bool

	// MaxAge 表示预检请求的结果可以缓存多长时间（秒）
	MaxAge int

	// AllowPrivateNetwork 指示是否允许私有网络请求
	AllowPrivateNetwork bool
}

type CSRFConfig struct {
	// TokenLength 指定CSRF令牌的长度
	TokenLength int

	// TokenExpiry 指定CSRF令牌的过期时间
	TokenExpiry time.Duration

	// CookieName 指定存储CSRF令牌的Cookie名称
	CookieName string

	// CookiePath 指定Cookie的路径
	CookiePath string

	// CookieDomain 指定Cookie的域
	CookieDomain string

	// CookieSecure 指定Cookie是否只通过HTTPS发送
	CookieSecure bool

	// CookieHTTPOnly 指定Cookie是否只能通过HTTP访问
	CookieHTTPOnly bool

	// CookieSameSite 指定Cookie的SameSite策略
	CookieSameSite http.SameSite

	// HeaderName 指定CSRF头名称
	HeaderName string

	// ParameterName 指定CSRF表单参数名称
	ParameterName string

	// ContextKey 指定存储在上下文中的键名
	ContextKey string

	// Secret 用于签名CSRF令牌的密钥
	Secret string

	// ErrorFunc 自定义错误处理函数
	ErrorFunc func(*flow.Context, error)

	// TokenStore 令牌存储接口
	TokenStore TokenStore

	// ExcludeURLs 排除的URL列表
	ExcludeURLs []string

	// AllowedOrigins 允许的源列表
	AllowedOrigins []string

	// AllowedMethods 允许的HTTP方法列表，不检查CSRF
	AllowedMethods []string

	// SingleUseToken 是否为单次使用令牌
	SingleUseToken bool
}

type ConsoleLogWriter struct{}

type Counter struct {
	// 计数值
	Value int
	// 过期时间
	Expiry time.Time
}

type ErrorLogWriterFunc func(error)

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

type HTTPError struct {
	Code    int    `json:"code"`
	Message string `json:"message"`
}

type JWTConfig struct {
	// 从请求中提取token的函数
	TokenExtractor func(*flow.Context) (string, error)

	// 用于签名的密钥
	SigningKey interface{}

	// 用于验证的密钥
	ValidationKey interface{}

	// 签名方法
	SigningMethod jwt.SigningMethod

	// 令牌在上下文中的键
	ContextKey string

	// 处理令牌错误的回调函数
	ErrorHandler func(*flow.Context, error)

	// 路径白名单，这些路径不需要检查令牌
	Skipper func(*flow.Context) bool

	// 令牌查找顺序：1. 查询参数，2. Cookie，3. 请求头
	TokenLookup string

	// 请求头中包含令牌的头部名称
	AuthScheme string

	// 是否使用令牌黑名单
	UseBlacklist bool

	// 黑名单检查函数
	BlacklistCheck func(string) bool
}

type LocaleOptions struct {
	// 默认语言
	DefaultLocale string

	// 翻译器
	Translator i18n.Translator

	// 支持的语言列表
	SupportedLocales []string

	// 从查询参数获取语言的键名
	QueryParameterName string

	// 从Cookie获取语言的键名
	CookieName string

	// 从Header获取语言的键名
	HeaderName string

	// 是否自动保存语言到Cookie
	SaveToCookie bool

	// Cookie有效期（秒）
	CookieMaxAge int

	// Cookie路径
	CookiePath string

	// 是否创建子域名Cookie
	CookieSecure bool

	// 是否只允许HTTP访问Cookie
	CookieHTTPOnly bool

	// 是否使用会话Cookie（会话结束就过期）
	CookieSession bool

	// 是否自动检测浏览器语言
	DetectBrowserLocale bool
}

type LoggerConfig struct {
	// SkipPaths 是不需要记录日志的路径
	SkipPaths []string

	// LogLevel 是日志级别
	LogLevel logrus.Level

	// Formatter 是日志格式化器
	Formatter logrus.Formatter

	// Output 是日志输出目标
	Output logrus.FieldLogger
}

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

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

type RateLimiterConfig struct {
	// 存储器
	Store RateLimiterStore
	// 最大请求数
	Max int
	// 时间窗口
	Duration time.Duration
	// 键生成函数
	KeyGenerator func(*flow.Context) string
	// 忽略规则
	Skipper func(*flow.Context) bool
	// 错误处理函数
	ErrorHandler func(*flow.Context, error)
	// 头部名称
	HeaderEnabled bool
	// 头部名称前缀
	HeaderPrefix string
}

type RateLimiterStore interface {
	// Increment 增加计数器并返回当前计数
	Increment(ctx context.Context, key string, expiry time.Duration) (int, error)
	// Reset 重置计数器
	Reset(ctx context.Context, key string) error
	// Get 获取当前计数
	Get(ctx context.Context, key string) (int, error)
}

type RecordConfig struct {
	// 日志输出位置: LogToConsole, LogToFile, LogToDatabase
	LogDestination int
	// 日志文件路径，当LogDestination为LogToFile时使用
	LogFilePath string
	// 自定义日志写入器，如果提供则忽略LogDestination
	LogWriter RecordLogWriter
	// 日志详细级别: LogLevelBasic, LogLevelStandard, LogLevelDetailed, LogLevelFull
	LogLevel int
	// 是否屏蔽敏感信息
	MaskSensitiveData bool
	// 自定义敏感字段列表，补充默认的正则表达式
	SensitiveFields []string
	// 请求路径排除列表，这些路径不会被记录
	SkipPaths []string
	// 记录请求体的最大大小(字节)
	MaxBodySize int
	// 错误处理函数
	ErrorLogWriter ErrorLogWriterFunc
	// 是否记录健康检查请求
	SkipHealthChecks bool
	// 健康检查路径
	HealthCheckPath string
}

type RecordLogWriter interface {
	WriteLog(entry *RequestLogEntry) error
	Close() error
}

type RecoveryConfig struct {
	// DisableStackAll 禁用完整堆栈跟踪
	DisableStackAll bool

	// DisablePrintStack 禁用打印堆栈信息
	DisablePrintStack bool

	// MaxStackSize 最大堆栈大小
	MaxStackSize int
}

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

type RedisTokenStore struct {
}

type RequestLogEntry struct {
	Timestamp       time.Time     `json:"timestamp"`
	RequestID       string        `json:"request_id"`
	ClientIP        string        `json:"client_ip"`
	Method          string        `json:"method"`
	Path            string        `json:"path"`
	Query           string        `json:"query,omitempty"`
	UserAgent       string        `json:"user_agent,omitempty"`
	RequestHeaders  interface{}   `json:"request_headers,omitempty"`
	RequestBody     interface{}   `json:"request_body,omitempty"`
	ResponseStatus  int           `json:"response_status"`
	ResponseSize    int           `json:"response_size,omitempty"`
	ResponseHeaders interface{}   `json:"response_headers,omitempty"`
	ResponseBody    interface{}   `json:"response_body,omitempty"`
	Latency         time.Duration `json:"latency"`
	Error           string        `json:"error,omitempty"`
}

type ResponseBodyWriter struct {
	gin.ResponseWriter
	// contains filtered or unexported fields
}

type TokenExtractorFunc func(*flow.Context) (string, error)

type TokenStore interface {
	// GenerateToken 生成一个新的CSRF令牌
	GenerateToken(ctx *flow.Context) (string, error)

	// ValidateToken 验证CSRF令牌
	ValidateToken(ctx *flow.Context, token string) bool

	// DeleteToken 删除CSRF令牌
	DeleteToken(ctx *flow.Context, token string) error
}