wazzapi 0.2.0__tar.gz → 0.4.0__tar.gz

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

@@ -1,9 +1,9 @@
 Metadata-Version: 2.4
 Name: wazzapi
-Version: 0.2.0
+Version: 0.4.0
 Summary: Typed Python SDK for WazzAPI
-Project-URL: Homepage, https://github.com/wazzapihq/wazzapi-py
 Project-URL: API, https://api.wazzapi.com
+Project-URL: Homepage, https://github.com/wazzapihq/wazzapi-py
 Keywords: api,sdk,wazzapi,webhook,whatsapp
 Classifier: Development Status :: 4 - Beta
 Classifier: Intended Audience :: Developers
@@ -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
@@ -26,11 +26,12 @@ Description-Content-Type: text/markdown
 
 Official Python SDK for WazzAPI.
 
-Use it to send messages, manage contacts and templates, and verify incoming webhooks with a simple typed client.
+Use it to send messages, inspect WhatsApp devices, manage contacts and templates, and verify incoming webhooks with a simple typed client.
 
 ## What you can do with this SDK
 
 - send direct WhatsApp messages
+- list and inspect WhatsApp devices
 - list, create, update, and delete contacts
 - manage message templates and preview rendered content
 - verify and parse incoming WazzAPI webhooks
@@ -118,6 +119,19 @@ with WazzapiClient(api_key="your-api-key") as client:
 
 for contact in response.contacts:
     print(contact.model_dump())
+
+### List devices
+
+```python
+from wazzapi import WazzapiClient
+
+with WazzapiClient(api_key="your-api-key") as client:
+    response = client.devices.list(limit=20, status="connected")
+
+for device in response.devices:
+    print(device.name, device.session_name, device.status)
+```
+
 ```
 
 ### Create a template
@@ -182,6 +196,7 @@ Supported webhook event families:
 
 Ready-to-run examples live in `examples/`:
 
+- `examples/list_devices.py`
 - `examples/list_contacts.py`
 - `examples/send_message.py`
 - `examples/create_template.py`
@@ -192,6 +207,7 @@ Run them with:
 
 ```bash
 uv run python examples/list_contacts.py
+uv run python examples/list_devices.py
 uv run python examples/send_message.py
 uv run python examples/create_template.py
 uv run python examples/preview_template.py

{wazzapi-0.2.0 → wazzapi-0.4.0}/README.md

@@ -2,11 +2,12 @@
 
 Official Python SDK for WazzAPI.
 
-Use it to send messages, manage contacts and templates, and verify incoming webhooks with a simple typed client.
+Use it to send messages, inspect WhatsApp devices, manage contacts and templates, and verify incoming webhooks with a simple typed client.
 
 ## What you can do with this SDK
 
 - send direct WhatsApp messages
+- list and inspect WhatsApp devices
 - list, create, update, and delete contacts
 - manage message templates and preview rendered content
 - verify and parse incoming WazzAPI webhooks
@@ -94,6 +95,19 @@ with WazzapiClient(api_key="your-api-key") as client:
 
 for contact in response.contacts:
     print(contact.model_dump())
+
+### List devices
+
+```python
+from wazzapi import WazzapiClient
+
+with WazzapiClient(api_key="your-api-key") as client:
+    response = client.devices.list(limit=20, status="connected")
+
+for device in response.devices:
+    print(device.name, device.session_name, device.status)
+```
+
 ```
 
 ### Create a template
@@ -158,6 +172,7 @@ Supported webhook event families:
 
 Ready-to-run examples live in `examples/`:
 
+- `examples/list_devices.py`
 - `examples/list_contacts.py`
 - `examples/send_message.py`
 - `examples/create_template.py`
@@ -168,6 +183,7 @@ Run them with:
 
 ```bash
 uv run python examples/list_contacts.py
+uv run python examples/list_devices.py
 uv run python examples/send_message.py
 uv run python examples/create_template.py
 uv run python examples/preview_template.py

wazzapi-0.4.0/examples/list_devices.py

@@ -0,0 +1,15 @@
+from __future__ import annotations
+
+import os
+
+from wazzapi import WazzapiClient
+
+api_key = os.environ["WAZZAPI_API_KEY"]
+
+with WazzapiClient(api_key=api_key) as client:
+    response = client.devices.list(limit=20, status="connected")
+
+for device in response.devices:
+    print(device.model_dump())
+
+print({"total": response.total, "limit": response.limit, "offset": response.offset})

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

@@ -1,6 +1,6 @@
 [project]
 name = "wazzapi"
-version = "0.2.0"
+version = "0.4.0"
 description = "Typed Python SDK for WazzAPI"
 readme = { file = "README.md", content-type = "text/markdown" }
 requires-python = ">=3.10"
@@ -19,19 +19,19 @@ classifiers = [
   "Typing :: Typed",
 ]
 dependencies = [
-  "cryptography>=44.0,<45.0",
+  "cryptography>=46.0,<50.0",
   "httpx>=0.28,<1.0",
   "pydantic>=2.11,<3.0",
 ]
 
 [project.urls]
-Homepage = "https://github.com/wazzapihq/wazzapi-py"
 API = "https://api.wazzapi.com"
+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.2.0 → wazzapi-0.4.0}/tests/smoke_test.py

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

{wazzapi-0.2.0 → wazzapi-0.4.0}/tests/test_client.py

@@ -15,6 +15,7 @@ def test_client_formats_bearer_auth_header() -> None:
         assert client.http.headers["Authorization"] == "Bearer plain-token"
         assert client.http.headers["Accept"] == "application/json"
         assert client.http.headers["Content-Type"] == "application/json"
+        assert client.devices is not None
     finally:
         client.close()
 

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

@@ -12,6 +12,18 @@ from wazzapi import WazzapiClient, models
 @pytest.mark.parametrize(
     ("call_factory", "expected_method", "expected_path", "expected_response_type", "response_json"),
     [
+        (
+            lambda client: client.devices.list(limit=25, status="connected", search="main"),
+            "GET",
+            "/api/v1/devices",
+            models.DeviceListResponse,
+            {
+                "devices": [],
+                "total": 0,
+                "limit": 25,
+                "offset": 0,
+            },
+        ),
         (
             lambda client: client.contacts.list(limit=25, search="alice"),
             "GET",
@@ -134,6 +146,50 @@ def test_delete_endpoints_return_none() -> None:
     assert seen_paths == ["/api/v1/contacts/contact_1", "/api/v1/templates/template_1"]
 
 
+def test_get_device_returns_typed_response() -> None:
+    seen: dict[str, object] = {}
+
+    def handler(request: httpx.Request) -> httpx.Response:
+        seen["method"] = request.method
+        seen["path"] = request.url.path
+        return httpx.Response(
+            200,
+            json={
+                "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
+                "name": "Primary Device",
+                "session_name": "main",
+                "status": "connected",
+                "is_primary": True,
+                "auto_warmer_enabled": True,
+                "total_messages_sent": 123,
+                "total_messages_received": 45,
+                "contacts_synced_count": 900,
+                "created_at": "2026-05-01T00:00:00Z",
+                "updated_at": "2026-05-02T00:00:00Z",
+                "timezone": "Asia/Jakarta",
+                "connection_attempts": 2,
+                "daily_message_limit": 1000,
+                "message_delay_ms": 500,
+                "phone_number": "6281234567890",
+                "last_connected_at": "2026-05-02T00:00:00Z",
+                "last_health_check_at": "2026-05-02T01:00:00Z",
+                "last_contact_sync_at": "2026-05-02T02:00:00Z",
+                "last_contact_sync_status": "completed",
+                "backend_id": "7a5d6343-1dd1-429a-8d83-25c9bf06c878",
+            },
+        )
+
+    transport = httpx.MockTransport(handler)
+    with WazzapiClient(base_url="https://api.example.com", transport=transport) as client:
+        result = client.devices.get("3c90c3cc-0d44-4b50-8888-8dd25736052a")
+
+    assert seen["method"] == "GET"
+    assert seen["path"] == "/api/v1/devices/3c90c3cc-0d44-4b50-8888-8dd25736052a"
+    assert isinstance(result, models.DeviceResponse)
+    assert result.session_name == "main"
+    assert result.timezone == "Asia/Jakarta"
+
+
 def test_sync_status_returns_typed_list() -> None:
     def handler(_: httpx.Request) -> httpx.Response:
         return httpx.Response(
@@ -157,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.2.0 → wazzapi-0.4.0}/wazzapi/__init__.py

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

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

@@ -7,7 +7,7 @@ import httpx
 from pydantic import BaseModel, TypeAdapter
 
 from .errors import WazzapiAPIError
-from .resources import ContactsResource, GroupsResource, MessagesResource, TemplatesResource
+from .resources import ContactsResource, DevicesResource, GroupsResource, MessagesResource, TemplatesResource
 
 DEFAULT_BASE_URL = "https://api.wazzapi.com"
 
@@ -39,6 +39,7 @@ class WazzapiClient:
         )
 
         self.contacts = ContactsResource(self)
+        self.devices = DevicesResource(self)
         self.groups = GroupsResource(self)
         self.messages = MessagesResource(self)
         self.templates = TemplatesResource(self)
@@ -106,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.2.0 → wazzapi-0.4.0}/wazzapi/models/__init__.py

@@ -1,6 +1,8 @@
 from .base import WazzapiModel
 from .contacts import *
 from .contacts import __all__ as contacts_all
+from .devices import *
+from .devices import __all__ as devices_all
 from .groups import *
 from .groups import __all__ as groups_all
 from .media import *
@@ -12,4 +14,13 @@ from .templates import __all__ as templates_all
 from .webhooks import *
 from .webhooks import __all__ as webhooks_all
 
-__all__ = ["WazzapiModel", *contacts_all, *groups_all, *media_all, *messages_all, *templates_all, *webhooks_all]
+__all__ = [
+	"WazzapiModel",
+	*contacts_all,
+	*devices_all,
+	*groups_all,
+	*media_all,
+	*messages_all,
+	*templates_all,
+	*webhooks_all,
+]

{wazzapi-0.2.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.4.0/wazzapi/models/devices.py

@@ -0,0 +1,42 @@
+from __future__ import annotations
+
+from datetime import datetime
+
+from .base import WazzapiModel
+
+
+class DeviceItem(WazzapiModel):
+    id: str
+    name: str
+    session_name: str
+    status: str
+    is_primary: bool
+    auto_warmer_enabled: bool
+    total_messages_sent: int
+    total_messages_received: int
+    contacts_synced_count: int
+    created_at: datetime
+    updated_at: datetime
+    phone_number: str | None = None
+    last_connected_at: datetime | None = None
+    last_health_check_at: datetime | None = None
+    last_contact_sync_at: datetime | None = None
+    last_contact_sync_status: str | None = None
+
+
+class DeviceListResponse(WazzapiModel):
+    devices: list[DeviceItem]
+    total: int
+    limit: int
+    offset: int
+
+
+class DeviceResponse(DeviceItem):
+    timezone: str
+    connection_attempts: int
+    daily_message_limit: int
+    message_delay_ms: int
+    backend_id: str | None = None
+
+
+__all__ = ["DeviceItem", "DeviceListResponse", "DeviceResponse"]

{wazzapi-0.2.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.2.0 → wazzapi-0.4.0}/wazzapi/resources/__init__.py

@@ -1,6 +1,13 @@
 from .contacts import ContactsResource
+from .devices import DevicesResource
 from .groups import GroupsResource
 from .messages import MessagesResource
 from .templates import TemplatesResource
 
-__all__ = ["ContactsResource", "GroupsResource", "MessagesResource", "TemplatesResource"]
+__all__ = [
+	"ContactsResource",
+	"DevicesResource",
+	"GroupsResource",
+	"MessagesResource",
+	"TemplatesResource",
+]

{wazzapi-0.2.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"]

wazzapi-0.4.0/wazzapi/resources/devices.py

@@ -0,0 +1,40 @@
+from __future__ import annotations
+
+from .. import models
+from .base import BaseResource
+
+
+class DevicesResource(BaseResource):
+    def list(
+        self,
+        *,
+        limit: int | None = None,
+        offset: int | None = None,
+        status: str | None = None,
+        search: str | None = None,
+        sort_by: str | None = None,
+        sort_order: str | None = None,
+    ) -> models.DeviceListResponse:
+        return self._client._request(
+            "GET",
+            "/api/v1/devices",
+            params={
+                "limit": limit,
+                "offset": offset,
+                "status": status,
+                "search": search,
+                "sort_by": sort_by,
+                "sort_order": sort_order,
+            },
+            response_model=models.DeviceListResponse,
+        )
+
+    def get(self, device_id: str) -> models.DeviceResponse:
+        return self._client._request(
+            "GET",
+            f"/api/v1/devices/{device_id}",
+            response_model=models.DeviceResponse,
+        )
+
+
+__all__ = ["DevicesResource"]