from dataclasses import dataclass
from typing import Optional


@dataclass(frozen=True)
class MailIntakeConfig:
    """
    Global configuration for mail-intake.

    This configuration is intentionally explicit and immutable.
    No implicit environment reads or global state.
    """

    provider: str = "gmail"
    user_id: str = "me"
    readonly: bool = True

    # Provider-specific paths (optional at this layer)
    credentials_path: Optional[str] = None
    token_path: Optional[str] = None