Skip to content

domain.protocols.password_reset_token_service_protocol

src.domain.protocols.password_reset_token_service_protocol

PasswordResetTokenServiceProtocol - Domain protocol for password reset token operations.

This protocol defines the interface for password reset token generation. Infrastructure provides the concrete implementation (PasswordResetTokenService).

Following hexagonal architecture: - Domain defines what it needs (protocol/port) - Infrastructure provides implementation (adapter) - Application layer uses protocol, not concrete implementation

Classes

PasswordResetTokenServiceProtocol

Bases: Protocol

Protocol for password reset token generation.

Generates unguessable tokens for password reset links. Very short-lived (15 minutes) for security.

Implementations
  • PasswordResetTokenService: src/infrastructure/security/password_reset_token_service.py
Source code in src/domain/protocols/password_reset_token_service_protocol.py 
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
class PasswordResetTokenServiceProtocol(Protocol):
    """Protocol for password reset token generation.

    Generates unguessable tokens for password reset links.
    Very short-lived (15 minutes) for security.

    Implementations:
        - PasswordResetTokenService: src/infrastructure/security/password_reset_token_service.py
    """

    def generate_token(self) -> str:
        """Generate password reset token.

        Returns:
            64-character hex string (32 bytes of entropy).
        """
        ...

    def calculate_expiration(self) -> datetime:
        """Calculate expiration timestamp for new token.

        Returns:
            Expiration datetime (UTC) based on configured expiration_minutes.
        """
        ...
Functions
generate_token 
generate_token() -> str

Generate password reset token.

Returns:

Type Description
str

64-character hex string (32 bytes of entropy).
Source code in src/domain/protocols/password_reset_token_service_protocol.py 
26
27
28
29
30
31
32
def generate_token(self) -> str:
    """Generate password reset token.

    Returns:
        64-character hex string (32 bytes of entropy).
    """
    ...
calculate_expiration 
calculate_expiration() -> datetime

Calculate expiration timestamp for new token.

Returns:

Type Description
datetime

Expiration datetime (UTC) based on configured expiration_minutes.
Source code in src/domain/protocols/password_reset_token_service_protocol.py 
34
35
36
37
38
39
40
def calculate_expiration(self) -> datetime:
    """Calculate expiration timestamp for new token.

    Returns:
        Expiration datetime (UTC) based on configured expiration_minutes.
    """
    ...