token

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

type AuthenticatorFunc func(ctx context.Context, username, password string) (*auth.User, error)

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

type CustomTokenConfig struct {
	// 签名密钥
	SigningKey []byte
	// 默认有效期
	DefaultDuration time.Duration
	// 颁发者
	Issuer string
	// 加密器
	Encryptor Encryptor
	// 令牌存储
	TokenStore TokenStore
	// 令牌黑名单
	Blacklist TokenBlacklist
}

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

type Encryptor interface {
	// Encrypt 对数据进行加密/签名
	Encrypt(data []byte) ([]byte, error)
	// Verify 验证数据签名
	Verify(data []byte, signature []byte) error
}

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

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

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

type Middleware interface {
	// Authenticate 认证中间件
	Authenticate(next interface{}) interface{}
	// Authorize 授权中间件
	Authorize(resource, action string, next interface{}) interface{}
}

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

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

type RedisTokenStoreConfig struct {
	// Redis客户端
	Client redis.Client
	// 键前缀
	KeyPrefix string
	// 令牌过期时间
	Expiration time.Duration
	// 用户缓存
	UserCache UserCache
	// 是否启用缓存
	EnableCache bool
}

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

type TokenBlacklist interface {
	// AddToBlacklist 将令牌添加到黑名单
	AddToBlacklist(ctx context.Context, tokenID string, expiration time.Duration) error
	// IsBlacklisted 检查令牌是否在黑名单中
	IsBlacklisted(ctx context.Context, tokenID string) (bool, error)
	// RemoveFromBlacklist 从黑名单中移除令牌（主要用于测试）
	RemoveFromBlacklist(ctx context.Context, tokenID string) error
	// CleanupExpired 清理过期的黑名单条目
	CleanupExpired(ctx context.Context) error
	// Close 关闭黑名单
	Close() error
}

type TokenClaims struct {
	// 用户ID
	UserID string `json:"uid"`
	// 用户名
	Username string `json:"uname"`
	// 角色列表
	Roles []string `json:"roles,omitempty"`
	// 权限列表
	Permissions []string `json:"perms,omitempty"`
	// 元数据
	Metadata map[string]string `json:"meta,omitempty"`
	// 令牌ID
	TokenID string `json:"jti"`
	// 颁发时间
	IssuedAt int64 `json:"iat"`
	// 过期时间
	ExpiresAt int64 `json:"exp"`
	// 颁发者
	Issuer string `json:"iss,omitempty"`
}

type TokenData struct {
	// 访问令牌
	AccessToken string
	// 刷新令牌
	RefreshToken string
	// 用户ID
	UserID string
	// 过期时间
	ExpiresAt int64
	// 令牌ID
	TokenID string
	// 是否被撤销
	Revoked bool
	// 创建时间
	CreatedAt int64
}

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

type TokenServiceOptions struct {
	// 访问令牌有效期
	AccessTokenDuration time.Duration
	// 刷新令牌有效期
	RefreshTokenDuration time.Duration
	// 是否启用刷新令牌轮换
	EnableRefreshTokenRotation bool
	// 是否启用令牌撤销
	EnableTokenRevocation bool
	// 令牌类型
	TokenType string
}

type TokenStore interface {
	// StoreToken 存储令牌
	StoreToken(ctx context.Context, token *TokenData) error
	// GetToken 获取令牌
	GetToken(ctx context.Context, tokenID string) (*TokenData, error)
	// GetTokenByRefresh 通过刷新令牌获取令牌
	GetTokenByRefresh(ctx context.Context, refreshToken string) (*TokenData, error)
	// RevokeToken 撤销令牌
	RevokeToken(ctx context.Context, tokenID string) error
	// IsTokenValid 检查令牌是否有效
	IsTokenValid(ctx context.Context, tokenID string) (bool, error)
	// CleanupExpiredTokens 清理过期令牌
	CleanupExpiredTokens(ctx context.Context) error
	// GetUserByID 获取用户信息
	GetUserByID(ctx context.Context, userID string) (*auth.User, error)
	// Close 关闭存储
	Close() error
}

type UserCache interface {
	// GetUser 获取用户
	GetUser(userID string) (*auth.User, bool)
	// SetUser 设置用户
	SetUser(user *auth.User)
	// DelUser 删除用户
	DelUser(userID string)
}