wazzapi 0.3.0__tar.gz → 0.4.0__tar.gz

{wazzapi-0.3.0 → wazzapi-0.4.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: wazzapi
-Version: 0.3.0
+Version: 0.4.0
 Summary: Typed Python SDK for WazzAPI
 Project-URL: API, https://api.wazzapi.com
 Project-URL: Homepage, https://github.com/wazzapihq/wazzapi-py
@@ -17,7 +17,7 @@ Classifier: Programming Language :: Python :: 3.13
 Classifier: Topic :: Software Development :: Libraries :: Python Modules
 Classifier: Typing :: Typed
 Requires-Python: >=3.10
-Requires-Dist: cryptography<45.0,>=44.0
+Requires-Dist: cryptography<50.0,>=46.0
 Requires-Dist: httpx<1.0,>=0.28
 Requires-Dist: pydantic<3.0,>=2.11
 Description-Content-Type: text/markdown

{wazzapi-0.3.0 → wazzapi-0.4.0}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "wazzapi"
-version = "0.3.0"
+version = "0.4.0"
 description = "Typed Python SDK for WazzAPI"
 readme = { file = "README.md", content-type = "text/markdown" }
 requires-python = ">=3.10"
@@ -19,7 +19,7 @@ classifiers = [
   "Typing :: Typed",
 ]
 dependencies = [
-  "cryptography>=44.0,<45.0",
+  "cryptography>=46.0,<50.0",
   "httpx>=0.28,<1.0",
   "pydantic>=2.11,<3.0",
 ]
@@ -30,8 +30,8 @@ Homepage = "https://github.com/wazzapihq/wazzapi-py"
 
 [dependency-groups]
 dev = [
-  "pytest>=8.3,<9.0",
-  "pytest-asyncio>=0.25,<1.0",
+  "pytest>=9.0,<10.0",
+  "pytest-asyncio>=1.0,<2.0",
   "twine>=6.1,<7.0",
 ]
 

{wazzapi-0.3.0 → wazzapi-0.4.0}/tests/smoke_test.py

@@ -10,7 +10,7 @@ from wazzapi import (
 
 
 def main() -> None:
-    assert __version__ == "0.3.0"
+    assert __version__ == "0.4.0"
 
     client = WazzapiClient(api_key="smoke-test-token")
     try:

{wazzapi-0.3.0 → wazzapi-0.4.0}/tests/test_resources.py

@@ -213,3 +213,70 @@ def test_sync_status_returns_typed_list() -> None:
     assert len(result) == 1
     assert isinstance(result[0], models.ContactSyncStatusResponse)
     assert result[0].account_id == "wa_123"
+
+
+def test_get_profile_picture_returns_metadata() -> None:
+    seen: dict[str, object] = {}
+
+    def handler(request: httpx.Request) -> httpx.Response:
+        seen["method"] = request.method
+        seen["path"] = request.url.path
+        seen["query"] = dict(request.url.params)
+        return httpx.Response(
+            200,
+            json={
+                "contact_id": "contact_1",
+                "phone_number": "+6281234567890",
+                "url": "https://cdn.example.com/pic.jpg",
+                "picture_id": "pic_1",
+                "picture_type": "image",
+                "preview": True,
+                "whatsapp_account_id": "wa_1",
+                "cached": False,
+            },
+        )
+
+    transport = httpx.MockTransport(handler)
+    with WazzapiClient(base_url="https://api.example.com", transport=transport) as client:
+        result = client.contacts.get_profile_picture(
+            "contact_1",
+            whatsapp_account_id="wa_1",
+            preview=True,
+        )
+
+    assert seen["method"] == "GET"
+    assert seen["path"] == "/api/v1/contacts/contact_1/profile-picture"
+    assert seen["query"] == {"whatsapp_account_id": "wa_1", "preview": "true"}
+    assert isinstance(result, models.ContactProfilePictureResponse)
+    assert result.url == "https://cdn.example.com/pic.jpg"
+    assert result.preview is True
+
+
+def test_get_profile_picture_image_returns_bytes() -> None:
+    seen: dict[str, object] = {}
+    image_bytes = b"\xff\xd8\xff\xe0fake-jpeg"
+
+    def handler(request: httpx.Request) -> httpx.Response:
+        seen["method"] = request.method
+        seen["path"] = request.url.path
+        seen["query"] = dict(request.url.params)
+        return httpx.Response(
+            200,
+            content=image_bytes,
+            headers={"content-type": "image/jpeg"},
+        )
+
+    transport = httpx.MockTransport(handler)
+    with WazzapiClient(base_url="https://api.example.com", transport=transport) as client:
+        result = client.contacts.get_profile_picture_image(
+            "contact_1",
+            proxy=True,
+            preview=False,
+        )
+
+    assert seen["method"] == "GET"
+    assert seen["path"] == "/api/v1/contacts/contact_1/profile-picture/image"
+    assert seen["query"] == {"proxy": "true", "preview": "false"}
+    assert isinstance(result, models.ContactProfilePictureImageResult)
+    assert result.content == image_bytes
+    assert result.content_type == "image/jpeg"

{wazzapi-0.3.0 → wazzapi-0.4.0}/wazzapi/__init__.py

@@ -16,7 +16,7 @@ from .webhooks import (
     verify_webhook_signature,
 )
 
-__version__ = "0.3.0"
+__version__ = "0.4.0"
 
 __all__ = [
     "EVENT_HEADER",

{wazzapi-0.3.0 → wazzapi-0.4.0}/wazzapi/client.py

@@ -107,6 +107,37 @@ class WazzapiClient:
         payload = response.json()
         return TypeAdapter(response_model).validate_python(payload)
 
+    def _request_bytes(
+        self,
+        method: str,
+        path: str,
+        *,
+        params: Mapping[str, Any] | None = None,
+        response_model: Any | None = None,
+    ) -> Any:
+        """Issue a request and return binary content (follows redirects)."""
+
+        response = self._client.request(
+            method,
+            path,
+            params=self._filter_none(params),
+            follow_redirects=True,
+        )
+
+        if response.status_code >= 400:
+            raise WazzapiAPIError.from_response(response)
+
+        payload = {
+            "content": response.content,
+            "content_type": response.headers.get("content-type"),
+            "final_url": str(response.url) if response.url else None,
+        }
+
+        if response_model is None:
+            return payload
+
+        return TypeAdapter(response_model).validate_python(payload)
+
     @staticmethod
     def _filter_none(data: Mapping[str, Any] | None) -> dict[str, Any] | None:
         if data is None:

{wazzapi-0.3.0 → wazzapi-0.4.0}/wazzapi/models/contacts.py

@@ -173,6 +173,27 @@ class ContactUpdateRequest(WazzapiModel):
     is_opted_out: bool | None = None
 
 
+class ContactProfilePictureResponse(WazzapiModel):
+    """Ephemeral WhatsApp profile picture metadata for a contact."""
+
+    contact_id: str
+    phone_number: str
+    url: str
+    picture_id: str | None = None
+    picture_type: str | None = None
+    preview: bool
+    whatsapp_account_id: str
+    cached: bool = False
+
+
+class ContactProfilePictureImageResult(WazzapiModel):
+    """Raw image bytes returned by the profile-picture image endpoint."""
+
+    content: bytes
+    content_type: str | None = None
+    final_url: str | None = None
+
+
 class RemoveFromGroupRequest(WazzapiModel):
     contact_ids: list[str]
 
@@ -193,6 +214,8 @@ __all__ = [
     "ContactGroupUpdateRequest",
     "ContactItem",
     "ContactListResponse",
+    "ContactProfilePictureImageResult",
+    "ContactProfilePictureResponse",
     "ContactResponse",
     "ContactSyncHistoryItem",
     "ContactSyncHistoryResponse",

{wazzapi-0.3.0 → wazzapi-0.4.0}/wazzapi/models/messages.py

@@ -136,6 +136,9 @@ class SendMessageRequest(WazzapiModel):
     message_type: str = "text"
     media_type: str | None = None
     media_url: str | None = None
+    media_base64: str | None = None
+    filename: str | None = None
+    mimetype: str | None = None
     caption: str | None = None
     latitude: float | None = None
     longitude: float | None = None

{wazzapi-0.3.0 → wazzapi-0.4.0}/wazzapi/resources/contacts.py

@@ -218,5 +218,41 @@ class ContactsResource(BaseResource):
         self._client._request("DELETE", f"/api/v1/contacts/{contact_id}")
         return None
 
+    def get_profile_picture(
+        self,
+        contact_id: str,
+        *,
+        whatsapp_account_id: str | None = None,
+        preview: bool | None = None,
+    ) -> models.ContactProfilePictureResponse:
+        return self._client._request(
+            "GET",
+            f"/api/v1/contacts/{contact_id}/profile-picture",
+            params={
+                "whatsapp_account_id": whatsapp_account_id,
+                "preview": preview,
+            },
+            response_model=models.ContactProfilePictureResponse,
+        )
+
+    def get_profile_picture_image(
+        self,
+        contact_id: str,
+        *,
+        whatsapp_account_id: str | None = None,
+        preview: bool | None = None,
+        proxy: bool | None = None,
+    ) -> models.ContactProfilePictureImageResult:
+        return self._client._request_bytes(
+            "GET",
+            f"/api/v1/contacts/{contact_id}/profile-picture/image",
+            params={
+                "whatsapp_account_id": whatsapp_account_id,
+                "preview": preview,
+                "proxy": proxy,
+            },
+            response_model=models.ContactProfilePictureImageResult,
+        )
+
 
 __all__ = ["ContactsResource"]