xiaoxia-saas/packages/domain/auth/jwt_service.py

"""JWT 服务端口（领域层接口）.

定义 JWT Token 生成、验证、解析的抽象接口，具体实现由应用层或基础设施层提供。
遵循 DDD 依赖倒置原则：领域层定义端口，外层实现端口。
"""

from __future__ import annotations

from abc import ABC, abstractmethod
from typing import Any, Dict


class JWTServicePort(ABC):
    """JWT 服务端口（抽象接口）"""

    @abstractmethod
    def create_access_token(
        self,
        user_id: str,
        role: str = "",
        additional_claims: Dict[str, Any] | None = None,
    ) -> str:
        """创建 access_token"""
        ...

    @abstractmethod
    def create_refresh_token(self, user_id: str, session_id: str) -> str:
        """创建 refresh_token"""
        ...

    @abstractmethod
    def verify_token(self, token: str) -> Dict[str, Any]:
        """验证任意 Token"""
        ...

    @abstractmethod
    def verify_access_token(self, token: str) -> Dict[str, Any]:
        """验证 access_token"""
        ...

    @abstractmethod
    def verify_refresh_token(self, token: str) -> Dict[str, Any]:
        """验证 refresh_token"""
        ...