feat: add typed Python SDK (#213)

packages/python-sdk/usesend/contacts.py

@@ -0,0 +1,69 @@
+"""Contact resource client using TypedDict shapes (no Pydantic)."""
+from __future__ import annotations
+
+from typing import Any, Dict, Optional, Tuple
+
+from .types import (
+    APIError,
+    ContactDeleteResponse,
+    Contact,
+    ContactUpdate,
+    ContactUpdateResponse,
+    ContactUpsert,
+    ContactUpsertResponse,
+    ContactCreate,
+    ContactCreateResponse,
+)
+
+
+class Contacts:
+    """Client for `/contactBooks` endpoints."""
+
+    def __init__(self, usesend: "UseSend") -> None:
+        self.usesend = usesend
+
+    def create(
+        self, book_id: str, payload: ContactCreate
+    ) -> Tuple[Optional[ContactCreateResponse], Optional[APIError]]:
+        data, err = self.usesend.post(
+            f"/contactBooks/{book_id}/contacts",
+            payload,
+        )
+        return (data, err)  # type: ignore[return-value]
+
+    def get(
+        self, book_id: str, contact_id: str
+    ) -> Tuple[Optional[Contact], Optional[APIError]]:
+        data, err = self.usesend.get(
+            f"/contactBooks/{book_id}/contacts/{contact_id}"
+        )
+        return (data, err)  # type: ignore[return-value]
+
+    def update(
+        self, book_id: str, contact_id: str, payload: ContactUpdate
+    ) -> Tuple[Optional[ContactUpdateResponse], Optional[APIError]]:
+        data, err = self.usesend.patch(
+            f"/contactBooks/{book_id}/contacts/{contact_id}",
+            payload,
+        )
+        return (data, err)  # type: ignore[return-value]
+
+    def upsert(
+        self, book_id: str, contact_id: str, payload: ContactUpsert
+    ) -> Tuple[Optional[ContactUpsertResponse], Optional[APIError]]:
+        data, err = self.usesend.put(
+            f"/contactBooks/{book_id}/contacts/{contact_id}",
+            payload,
+        )
+        return (data, err)  # type: ignore[return-value]
+
+    def delete(
+        self, *, book_id: str, contact_id: str
+    ) -> Tuple[Optional[ContactDeleteResponse], Optional[APIError]]:
+        data, err = self.usesend.delete(
+            f"/contactBooks/{book_id}/contacts/{contact_id}"
+        )
+        return (data, err)  # type: ignore[return-value]
+
+
+from .usesend import UseSend  # noqa: E402  pylint: disable=wrong-import-position