auth

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

type Authenticator interface {
	// Authenticate 认证令牌并返回用户信息
	Authenticate(ctx context.Context, token string) (User, error)
}

type Authorizer interface {
	// Authorize 检查用户是否有权限访问资源
	Authorize(ctx context.Context, user User, resource string, action string) error
}

type CallbackAuthenticator struct {
	AuthFunc func(ctx context.Context, token string) (User, error)
}

type CallbackAuthorizer struct {
	AuthorizeFunc func(ctx context.Context, user User, resource, action string) error
}

type ChainAuthenticator struct {
	Authenticators []Authenticator
}

type CompositeAuthorizer struct {
	Authorizers []Authorizer
}

type Config struct {
	// Name 认证器名称
	Name string
	// TokenExtractor 令牌提取器
	TokenExtractor TokenExtractor
	// Authenticator 认证器
	Authenticator Authenticator
	// Authorizer 授权器（可选）
	Authorizer Authorizer
	// SkipPaths 跳过认证的路径列表
	SkipPaths []string
	// EnableMetrics 是否启用指标统计
	EnableMetrics bool
	// OnAuthSuccess 认证成功回调（同步调用，须轻量，不得阻塞）
	OnAuthSuccess func(ctx context.Context, user User)
	// OnAuthFailure 认证失败回调（同步调用，须轻量，不得阻塞）
	OnAuthFailure func(ctx context.Context, err error)
}

type CookieTokenExtractor struct {
	CookieName string // Cookie 名称
}

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

type GRPCMetadataExtractor struct {
	MetadataKey string // gRPC metadata 键名
}

type HeaderTokenExtractor struct {
	HeaderName string // Header 名称，如 "Authorization"
	Prefix     string // 令牌前缀，如 "Bearer "
}

type JWTClaims struct {
	UserID    string    `json:"user_id"`
	Username  string    `json:"username"`
	Roles     []string  `json:"roles"`
	IssuedAt  time.Time `json:"iat"`
	ExpiresAt time.Time `json:"exp"`
}

type MultiTokenExtractor struct {
	Extractors []TokenExtractor
}

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

type PathRule struct {
	PathPattern string   // 路径模式，支持通配符
	Methods     []string // HTTP 方法列表，空表示所有方法
	Roles       []string // 允许的角色列表
	AllowAll    bool     // 是否允许所有用户
}

type PermissiveAuthorizer struct{}

type QueryTokenExtractor struct {
	ParamName string // 查询参数名称，如 "token"
}

type RestrictiveAuthorizer struct{}

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

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

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

type Stats struct {
	TotalRequests   uint64    `json:"total_requests"`    // 总请求数
	AuthRequests    uint64    `json:"auth_requests"`     // 需要认证的请求数
	SuccessRequests uint64    `json:"success_requests"`  // 认证成功请求数
	FailureRequests uint64    `json:"failure_requests"`  // 认证失败请求数
	SkippedRequests uint64    `json:"skipped_requests"`  // 跳过认证请求数
	LastAuthTime    time.Time `json:"last_auth_time"`    // 最后认证时间
	LastFailureTime time.Time `json:"last_failure_time"` // 最后失败时间
}

type TokenExtractor interface {
	// Extract 从请求中提取令牌
	Extract(ctx context.Context, metadata map[string]any) (string, error)
}

type TrustedHeaderAuthenticator struct{}

type User interface {
	// ID 返回用户ID
	ID() string
	// Name 返回用户名
	Name() string
	// Roles 返回用户角色列表
	Roles() []string
	// HasRole 检查用户是否拥有指定角色
	HasRole(role string) bool
	// Metadata 返回用户元数据
	Metadata() map[string]any
}