interfaces.py

from abc import ABC, abstractmethod
from typing import Dict, List, Optional
from datetime import datetime

class DatabaseInterface(ABC):
    @abstractmethod
    def find_user_by_email(self, email: str) -> Optional[Dict]:
        pass

    @abstractmethod
    def find_user_by_id(self, user_id: str) -> Optional[Dict]:
        pass

    @abstractmethod
    def save_user(self, user, password_hash: str) -> None:
        pass

    @abstractmethod
    def update_user(self, user) -> None:
        pass

    @abstractmethod
    def get_password_hash(self, user_id: str) -> Optional[str]:
        pass

    @abstractmethod
    def update_password(self, user_id: str, password_hash: str) -> None:
        pass

    @abstractmethod
    def get_user_activity_logs(self, user_id: str) -> List[Dict]:
        pass

class CacheInterface(ABC):
    @abstractmethod
    def set_user_data(self, user_id: str, data: Dict) -> None:
        pass

    @abstractmethod
    def get_user_data(self, user_id: str) -> Dict:
        pass

    @abstractmethod
    def increment_login_attempts(self, user_id: str) -> None:
        pass

    @abstractmethod
    def clear_login_attempts(self, user_id: str) -> None:
        pass

class EmailServiceInterface(ABC):
    @abstractmethod
    def send_welcome_email(self, email: str) -> None:
        pass

    @abstractmethod
    def send_password_reset_email(self, email: str, temp_password: str) -> None:
        pass

    @abstractmethod
    def send_role_update_email(self, email: str, new_role: str) -> None:
        pass