wazzapi 0.2.0__tar.gz → 0.3.0__tar.gz

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

@@ -1,9 +1,9 @@
 Metadata-Version: 2.4
 Name: wazzapi
-Version: 0.2.0
+Version: 0.3.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
@@ -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.3.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.3.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.3.0}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "wazzapi"
-version = "0.2.0"
+version = "0.3.0"
 description = "Typed Python SDK for WazzAPI"
 readme = { file = "README.md", content-type = "text/markdown" }
 requires-python = ">=3.10"
@@ -25,8 +25,8 @@ dependencies = [
 ]
 
 [project.urls]
-Homepage = "https://github.com/wazzapihq/wazzapi-py"
 API = "https://api.wazzapi.com"
+Homepage = "https://github.com/wazzapihq/wazzapi-py"
 
 [dependency-groups]
 dev = [

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

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

{wazzapi-0.2.0 → wazzapi-0.3.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.3.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(

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

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

{wazzapi-0.2.0 → wazzapi-0.3.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)

{wazzapi-0.2.0 → wazzapi-0.3.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.3.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.3.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.3.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"]