docs-and-mcps (#1)

Reviewed-on: #1
Co-authored-by: Vishesh 'ironeagle' Bangotra <aetoskia@gmail.com>
Co-committed-by: Vishesh 'ironeagle' Bangotra <aetoskia@gmail.com>

mail_intake/auth/__init__.pyi

@@ -0,0 +1,4 @@
+from .base import MailIntakeAuthProvider
+from .google import MailIntakeGoogleAuth
+
+__all__ = ["MailIntakeAuthProvider", "MailIntakeGoogleAuth"]

mail_intake/auth/base.pyi

@@ -0,0 +1,8 @@
+from abc import ABC, abstractmethod
+from typing import Generic, TypeVar
+
+T = TypeVar("T")
+
+class MailIntakeAuthProvider(ABC, Generic[T]):
+    @abstractmethod
+    def get_credentials(self) -> T: ...

mail_intake/auth/google.pyi

@@ -0,0 +1,7 @@
+from typing import Sequence, Any
+from mail_intake.auth.base import MailIntakeAuthProvider
+from mail_intake.credentials.store import CredentialStore
+
+class MailIntakeGoogleAuth(MailIntakeAuthProvider[Any]):
+    def __init__(self, credentials_path: str, store: CredentialStore[Any], scopes: Sequence[str]) -> None: ...
+    def get_credentials(self) -> Any: ...