lib init

mail_intake/config.py

@@ -0,0 +1,20 @@
+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