lib init

mail_intake/exceptions.py

@@ -0,0 +1,19 @@
+class MailIntakeError(Exception):
+    """
+    Base exception for all mail-intake errors.
+
+    Users of the library should catch this type (or subclasses)
+    instead of provider-specific or third-party exceptions.
+    """
+
+
+class MailIntakeAuthError(MailIntakeError):
+    """Authentication and credential-related failures."""
+
+
+class MailIntakeAdapterError(MailIntakeError):
+    """Errors raised by mail provider adapters."""
+
+
+class MailIntakeParsingError(MailIntakeError):
+    """Errors encountered while parsing message content."""