session

type Provider interface {
	// NewSession 创建新会话
	// userId: 用户 ID（string 类型）
	// jwtData: 存储在 JWT 中的数据
	// sessData: 存储在 Session 中的数据
	NewSession(ctx *gctx.Context, userId string, jwtData map[string]string, sessData map[string]any) (Session, error)

	// Get 获取会话
	// 会自动验证会话的有效性
	Get(ctx *gctx.Context) (Session, error)

	// Destroy 销毁会话
	Destroy(ctx *gctx.Context) error

	// RenewToken 刷新 Token
	// 在 Token 即将过期时调用
	RenewToken(ctx *gctx.Context) error
}

type Session interface {
	// Set 设置会话数据
	Set(ctx context.Context, key string, val any) error

	// Get 获取会话数据
	Get(ctx context.Context, key string) (any, error)

	// Del 删除会话数据
	Del(ctx context.Context, key string) error

	// Destroy 销毁整个会话
	Destroy(ctx context.Context) error

	// Claims 获取 JWT 中的声明数据
	Claims() *jwt.Claims

	// Refresh 刷新会话过期时间
	Refresh(ctx context.Context) error
}

type TokenCarrier interface {
	// Inject 将 Token 注入到响应中
	Inject(ctx *gctx.Context, token string)

	// Extract 从请求中提取 Token
	Extract(ctx *gctx.Context) string

	// Clear 清除 Token
	Clear(ctx *gctx.Context)
}