belgie-proto 0.1.0a4__py3-none-any.whl

belgie_proto/__init__.py

@@ -0,0 +1,17 @@
+"""Shared protocol interfaces for Belgie packages."""
+
+from belgie_proto.account import AccountProtocol
+from belgie_proto.adapter import AdapterProtocol
+from belgie_proto.connection import DBConnection
+from belgie_proto.oauth_state import OAuthStateProtocol
+from belgie_proto.session import SessionProtocol
+from belgie_proto.user import UserProtocol
+
+__all__ = [
+    "AccountProtocol",
+    "AdapterProtocol",
+    "DBConnection",
+    "OAuthStateProtocol",
+    "SessionProtocol",
+    "UserProtocol",
+]

belgie_proto/account.py

@@ -0,0 +1,23 @@
+from __future__ import annotations
+
+from typing import TYPE_CHECKING, Protocol, runtime_checkable
+
+if TYPE_CHECKING:
+    from datetime import datetime
+    from uuid import UUID
+
+
+@runtime_checkable
+class AccountProtocol(Protocol):
+    id: UUID
+    user_id: UUID
+    provider: str
+    provider_account_id: str
+    access_token: str | None
+    refresh_token: str | None
+    expires_at: datetime | None
+    token_type: str | None
+    scope: str | None
+    id_token: str | None
+    created_at: datetime
+    updated_at: datetime

belgie_proto/adapter.py

@@ -0,0 +1,121 @@
+from __future__ import annotations
+
+from typing import TYPE_CHECKING, Any, Protocol, runtime_checkable
+
+from belgie_proto.account import AccountProtocol
+from belgie_proto.oauth_state import OAuthStateProtocol
+from belgie_proto.session import SessionProtocol
+from belgie_proto.user import UserProtocol
+
+if TYPE_CHECKING:
+    from datetime import datetime
+    from uuid import UUID
+
+    from belgie_proto.connection import DBConnection
+
+
+@runtime_checkable
+class AdapterProtocol[
+    UserT: UserProtocol,
+    AccountT: AccountProtocol,
+    SessionT: SessionProtocol,
+    OAuthStateT: OAuthStateProtocol,
+](Protocol):
+    """Protocol for database adapters."""
+
+    async def create_user(
+        self,
+        session: DBConnection,
+        email: str,
+        name: str | None = None,
+        image: str | None = None,
+        *,
+        email_verified: bool = False,
+    ) -> UserT: ...
+
+    async def get_user_by_id(self, session: DBConnection, user_id: UUID) -> UserT | None: ...
+
+    async def get_user_by_email(self, session: DBConnection, email: str) -> UserT | None: ...
+
+    async def update_user(
+        self,
+        session: DBConnection,
+        user_id: UUID,
+        **updates: Any,  # noqa: ANN401
+    ) -> UserT | None: ...
+
+    async def create_account(
+        self,
+        session: DBConnection,
+        user_id: UUID,
+        provider: str,
+        provider_account_id: str,
+        **tokens: Any,  # noqa: ANN401
+    ) -> AccountT: ...
+
+    async def get_account(
+        self,
+        session: DBConnection,
+        provider: str,
+        provider_account_id: str,
+    ) -> AccountT | None: ...
+
+    async def get_account_by_user_and_provider(
+        self,
+        session: DBConnection,
+        user_id: UUID,
+        provider: str,
+    ) -> AccountT | None: ...
+
+    async def update_account(
+        self,
+        session: DBConnection,
+        user_id: UUID,
+        provider: str,
+        **tokens: Any,  # noqa: ANN401
+    ) -> AccountT | None: ...
+
+    async def create_session(
+        self,
+        session: DBConnection,
+        user_id: UUID,
+        expires_at: datetime,
+        ip_address: str | None = None,
+        user_agent: str | None = None,
+    ) -> SessionT: ...
+
+    async def get_session(
+        self,
+        session: DBConnection,
+        session_id: UUID,
+    ) -> SessionT | None: ...
+
+    async def update_session(
+        self,
+        session: DBConnection,
+        session_id: UUID,
+        **updates: Any,  # noqa: ANN401
+    ) -> SessionT | None: ...
+
+    async def delete_session(self, session: DBConnection, session_id: UUID) -> bool: ...
+
+    async def delete_expired_sessions(self, session: DBConnection) -> int: ...
+
+    async def create_oauth_state(
+        self,
+        session: DBConnection,
+        state: str,
+        expires_at: datetime,
+        code_verifier: str | None = None,
+        redirect_url: str | None = None,
+    ) -> OAuthStateT: ...
+
+    async def get_oauth_state(
+        self,
+        session: DBConnection,
+        state: str,
+    ) -> OAuthStateT | None: ...
+
+    async def delete_oauth_state(self, session: DBConnection, state: str) -> bool: ...
+
+    async def delete_user(self, session: DBConnection, user_id: UUID) -> bool: ...

belgie_proto/connection.py

@@ -0,0 +1,12 @@
+from __future__ import annotations
+
+from typing import Protocol, runtime_checkable
+
+
+@runtime_checkable
+class DBConnection(Protocol):
+    async def commit(self) -> None: ...
+
+    async def rollback(self) -> None: ...
+
+    async def close(self) -> None: ...

belgie_proto/oauth_state.py

@@ -0,0 +1,17 @@
+from __future__ import annotations
+
+from typing import TYPE_CHECKING, Protocol, runtime_checkable
+
+if TYPE_CHECKING:
+    from datetime import datetime
+    from uuid import UUID
+
+
+@runtime_checkable
+class OAuthStateProtocol(Protocol):
+    id: UUID
+    state: str
+    code_verifier: str | None
+    redirect_url: str | None
+    created_at: datetime
+    expires_at: datetime

belgie_proto/session.py

@@ -0,0 +1,18 @@
+from __future__ import annotations
+
+from typing import TYPE_CHECKING, Protocol, runtime_checkable
+
+if TYPE_CHECKING:
+    from datetime import datetime
+    from uuid import UUID
+
+
+@runtime_checkable
+class SessionProtocol(Protocol):
+    id: UUID
+    user_id: UUID
+    expires_at: datetime
+    ip_address: str | None
+    user_agent: str | None
+    created_at: datetime
+    updated_at: datetime

belgie_proto/user.py

@@ -0,0 +1,20 @@
+from __future__ import annotations
+
+from typing import TYPE_CHECKING, Protocol, runtime_checkable
+
+if TYPE_CHECKING:
+    from datetime import datetime
+    from uuid import UUID
+
+
+@runtime_checkable
+class UserProtocol[S: str](Protocol):
+    # Generic over scope type S (must be str or subclass like StrEnum)
+    id: UUID
+    email: str
+    email_verified: bool
+    name: str | None
+    image: str | None
+    created_at: datetime
+    updated_at: datetime
+    scopes: list[S] | None  # User's application-level scopes (None means no scopes)

belgie_proto-0.1.0a4.dist-info/METADATA

@@ -0,0 +1,12 @@
+Metadata-Version: 2.3
+Name: belgie-proto
+Version: 0.1.0a4
+Summary: Shared protocol interfaces for Belgie
+Author: Matt LeMay
+Author-email: Matt LeMay <mplemay@users.noreply.github.com>
+Requires-Python: >=3.12
+Description-Content-Type: text/markdown
+
+# belgie-proto
+
+Shared protocol interfaces for Belgie packages. Import from `belgie_proto`.

belgie_proto-0.1.0a4.dist-info/RECORD

@@ -0,0 +1,11 @@
+belgie_proto/__init__.py,sha256=ABjW1baApcplegVDWN4g44my3wpTGCwObOP9H6wlbXo,500
+belgie_proto/account.py,sha256=DImHp_ywOIQQtswxumZ35X9fmSf-XL_ihF9y_BR4Drs,524
+belgie_proto/adapter.py,sha256=RTIAGJlCQCFnsV_Dh3L-yYB_3d6evbfHoz0VluOtMIY,3220
+belgie_proto/connection.py,sha256=cHrErcD5vL5gfWOE4klzOeYvnsnLBJL7CSoSYKwtfi0,257
+belgie_proto/oauth_state.py,sha256=vznJ24sScY5kDEd2pEwNy4vkQX17gStdFyZKGb5l6oU,371
+belgie_proto/py.typed,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+belgie_proto/session.py,sha256=oQ7XfzWUDgny2WpRrC4DjbiessVt83fERjQiCPCoJls,391
+belgie_proto/user.py,sha256=8_mMbVKOJzwJotmgP1rosg3xBCuLa3IkScnkU2zZCIw,538
+belgie_proto-0.1.0a4.dist-info/WHEEL,sha256=fAguSjoiATBe7TNBkJwOjyL1Tt4wwiaQGtNtjRPNMQA,80
+belgie_proto-0.1.0a4.dist-info/METADATA,sha256=LpnmBZE_QUNDfQ3Y2tqqgZwGDhHmKPfzecMqquRO_Xc,341
+belgie_proto-0.1.0a4.dist-info/RECORD,,

belgie_proto-0.1.0a4.dist-info/WHEEL

@@ -0,0 +1,4 @@
+Wheel-Version: 1.0
+Generator: uv 0.9.28
+Root-Is-Purelib: true
+Tag: py3-none-any