from typing import Any, Optional


class AppException(Exception):
    """Base exception class for all domain and system exceptions."""
    def __init__(
        self,
        message: str,
        status_code: int = 400,
        error_code: str = "BAD_REQUEST",
        details: Optional[dict[str, Any]] = None,
    ):
        super().__init__(message)
        self.message = message
        self.status_code = status_code
        self.error_code = error_code
        self.details = details or {}


class NotFoundError(AppException):
    def __init__(self, message: str = "Resource not found", details: Optional[dict[str, Any]] = None):
        super().__init__(message, status_code=404, error_code="NOT_FOUND", details=details)


class UnauthorizedError(AppException):
    def __init__(self, message: str = "Authentication required", details: Optional[dict[str, Any]] = None):
        super().__init__(message, status_code=401, error_code="UNAUTHORIZED", details=details)


class ForbiddenError(AppException):
    def __init__(self, message: str = "Permission denied", details: Optional[dict[str, Any]] = None):
        super().__init__(message, status_code=403, error_code="FORBIDDEN", details=details)


class TenantAccessError(AppException):
    def __init__(self, message: str = "Cross-tenant access forbidden", details: Optional[dict[str, Any]] = None):
        super().__init__(message, status_code=403, error_code="TENANT_ACCESS_DENIED", details=details)


class ConflictError(AppException):
    def __init__(self, message: str = "Resource already exists", details: Optional[dict[str, Any]] = None):
        super().__init__(message, status_code=409, error_code="CONFLICT", details=details)


class ValidationError(AppException):
    def __init__(self, message: str = "Validation failed", details: Optional[dict[str, Any]] = None):
        super().__init__(message, status_code=422, error_code="VALIDATION_ERROR", details=details)


class CryptoError(AppException):
    def __init__(self, message: str = "Cryptographic operation failed", details: Optional[dict[str, Any]] = None):
        super().__init__(message, status_code=500, error_code="CRYPTO_ERROR", details=details)


class QuotaExceededError(AppException):
    def __init__(self, message: str = "Plan quota exceeded", details: Optional[dict[str, Any]] = None):
        super().__init__(message, status_code=429, error_code="QUOTA_EXCEEDED", details=details)


class PaymentError(AppException):
    def __init__(self, message: str = "Payment processing error", details: Optional[dict[str, Any]] = None):
        super().__init__(message, status_code=400, error_code="PAYMENT_ERROR", details=details)


class InsufficientFundsError(AppException):
    def __init__(self, message: str = "Insufficient wallet funds", details: Optional[dict[str, Any]] = None):
        super().__init__(message, status_code=400, error_code="INSUFFICIENT_FUNDS", details=details)


class ExternalServiceError(AppException):
    def __init__(self, message: str = "External service error", details: Optional[dict[str, Any]] = None):
        super().__init__(message, status_code=502, error_code="EXTERNAL_SERVICE_ERROR", details=details)
