wazzapi 0.1.2__tar.gz → 0.3.0__tar.gz

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

@@ -1,9 +1,9 @@
 Metadata-Version: 2.4
 Name: wazzapi
-Version: 0.1.2
+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.1.2 → 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.1.2 → wazzapi-0.3.0}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "wazzapi"
-version = "0.1.2"
+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.1.2 → wazzapi-0.3.0}/tests/smoke_test.py

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

{wazzapi-0.1.2 → 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.3.0/tests/test_groups.py

@@ -0,0 +1,285 @@
+from __future__ import annotations
+
+import json
+from collections.abc import Callable
+
+import httpx
+import pytest
+
+from wazzapi import WazzapiClient, models
+
+
+@pytest.mark.parametrize(
+    ("call_factory", "expected_method", "expected_path", "expected_response_type", "response_json"),
+    [
+        (
+            lambda client: client.groups.list(session_name="main", limit=25),
+            "GET",
+            "/api/v1/groups",
+            models.GroupListResponse,
+            {"groups": [], "total": 0},
+        ),
+        (
+            lambda client: client.groups.get("123@g.us", session_name="main"),
+            "GET",
+            "/api/v1/groups/123@g.us",
+            models.GroupDetailResponse,
+            {"id": "123@g.us", "name": "Test Group"},
+        ),
+        (
+            lambda client: client.groups.get_participants("123@g.us", session_name="main"),
+            "GET",
+            "/api/v1/groups/123@g.us/participants",
+            models.GroupParticipantsResponse,
+            {"participants": [{"id": "6281234567890@s.whatsapp.net", "is_admin": True}]},
+        ),
+        (
+            lambda client: client.groups.create({"session_name": "main", "name": "New Group", "participants": ["6281234567890"]}),
+            "POST",
+            "/api/v1/groups/create",
+            models.CreateGroupResponseModel,
+            {"success": True, "jid": "456@g.us", "name": "New Group"},
+        ),
+        (
+            lambda client: client.groups.send_text({"session_name": "main", "group_jid": "123@g.us", "text": "hello"}),
+            "POST",
+            "/api/v1/groups/send",
+            models.SendGroupResponse,
+            {"success": True, "message_id": "msg_1", "status": "queued"},
+        ),
+        (
+            lambda client: client.groups.send_media({
+                "session_name": "main",
+                "group_jid": "123@g.us",
+                "media_url": "https://example.com/img.jpg",
+                "media_type": "image",
+            }),
+            "POST",
+            "/api/v1/groups/send/media",
+            models.SendGroupResponse,
+            {"success": True, "message_id": "msg_2", "status": "queued"},
+        ),
+        (
+            lambda client: client.groups.update_participants({
+                "session_name": "main",
+                "group_jid": "123@g.us",
+                "action": "promote",
+                "participants": ["6281234567890@s.whatsapp.net"],
+            }),
+            "POST",
+            "/api/v1/groups/participants",
+            models.GroupOperationResponseModel,
+            {"success": True, "details": "done"},
+        ),
+        (
+            lambda client: client.groups.add_participant("123@g.us", session_name="main", participant_jid="6281234567890@s.whatsapp.net"),
+            "POST",
+            "/api/v1/groups/123@g.us/participants/add",
+            models.GroupOperationResponseModel,
+            {"success": True, "details": "added"},
+        ),
+        (
+            lambda client: client.groups.remove_participant("123@g.us", session_name="main", participant_jid="6281234567890@s.whatsapp.net"),
+            "POST",
+            "/api/v1/groups/123@g.us/participants/remove",
+            models.GroupOperationResponseModel,
+            {"success": True, "details": "removed"},
+        ),
+        (
+            lambda client: client.groups.get_invite_link("123@g.us", session_name="main"),
+            "POST",
+            "/api/v1/groups/123@g.us/invite-link",
+            models.GroupInviteLinkResponseModel,
+            {"success": True, "invite_link": "https://chat.whatsapp.com/abc"},
+        ),
+        (
+            lambda client: client.groups.get_invite_info({"session_name": "main", "invite_link": "https://chat.whatsapp.com/abc"}),
+            "POST",
+            "/api/v1/groups/invite-info",
+            models.GroupInviteInfoResponseModel,
+            {"success": True, "jid": "789@g.us", "name": "Invited Group"},
+        ),
+        (
+            lambda client: client.groups.join({"session_name": "main", "invite_link": "https://chat.whatsapp.com/abc"}),
+            "POST",
+            "/api/v1/groups/join",
+            models.GroupOperationResponseModel,
+            {"success": True, "details": "joined"},
+        ),
+        (
+            lambda client: client.groups.leave("123@g.us", session_name="main"),
+            "POST",
+            "/api/v1/groups/123@g.us/leave",
+            models.GroupOperationResponseModel,
+            {"success": True, "details": "left"},
+        ),
+        (
+            lambda client: client.groups.set_name("123@g.us", {"session_name": "main", "name": "Renamed"}),
+            "POST",
+            "/api/v1/groups/123@g.us/name",
+            models.GroupOperationResponseModel,
+            {"success": True, "details": "name updated"},
+        ),
+        (
+            lambda client: client.groups.set_topic("123@g.us", {"session_name": "main", "topic": "new topic"}),
+            "POST",
+            "/api/v1/groups/123@g.us/topic",
+            models.GroupOperationResponseModel,
+            {"success": True, "details": "topic updated"},
+        ),
+        (
+            lambda client: client.groups.set_photo("123@g.us", {"session_name": "main", "image_data_uri": "data:image/png;base64,abc"}),
+            "POST",
+            "/api/v1/groups/123@g.us/photo",
+            models.GroupOperationResponseModel,
+            {"success": True, "details": "photo updated"},
+        ),
+        (
+            lambda client: client.groups.set_announce("123@g.us", {"session_name": "main", "announce": True}),
+            "POST",
+            "/api/v1/groups/123@g.us/announce",
+            models.GroupOperationResponseModel,
+            {"success": True, "details": "announce set"},
+        ),
+        (
+            lambda client: client.groups.set_locked("123@g.us", {"session_name": "main", "locked": True}),
+            "POST",
+            "/api/v1/groups/123@g.us/locked",
+            models.GroupOperationResponseModel,
+            {"success": True, "details": "locked set"},
+        ),
+        (
+            lambda client: client.groups.set_ephemeral("123@g.us", {"session_name": "main", "duration": "24h"}),
+            "POST",
+            "/api/v1/groups/123@g.us/ephemeral",
+            models.GroupOperationResponseModel,
+            {"success": True, "details": "ephemeral set"},
+        ),
+    ],
+)
+def test_groups_methods_hit_expected_routes(
+    call_factory: Callable[[WazzapiClient], object],
+    expected_method: str,
+    expected_path: str,
+    expected_response_type: type[object],
+    response_json: dict[str, object],
+) -> 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)
+        seen["body"] = json.loads(request.content.decode("utf-8")) if request.content else None
+        status_code = 201 if request.method == "POST" else 200
+        return httpx.Response(status_code, json=response_json)
+
+    transport = httpx.MockTransport(handler)
+    with WazzapiClient(base_url="https://api.example.com", transport=transport) as client:
+        result = call_factory(client)
+
+    assert seen["method"] == expected_method
+    assert seen["path"] == expected_path
+    assert isinstance(result, expected_response_type)
+
+
+def test_groups_remove_photo_returns_operation_response() -> 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={"success": True, "details": "photo removed"},
+        )
+
+    transport = httpx.MockTransport(handler)
+    with WazzapiClient(base_url="https://api.example.com", transport=transport) as client:
+        result = client.groups.remove_photo("123@g.us", session_name="main")
+
+    assert seen["method"] == "DELETE"
+    assert seen["path"] == "/api/v1/groups/123@g.us/photo"
+    assert seen["query"] == {"session_name": "main"}
+    assert isinstance(result, models.GroupOperationResponseModel)
+    assert result.success is True
+
+
+def test_groups_list_sends_query_params() -> None:
+    seen: dict[str, object] = {}
+
+    def handler(request: httpx.Request) -> httpx.Response:
+        seen["query"] = dict(request.url.params)
+        return httpx.Response(200, json={"groups": [], "total": 0})
+
+    transport = httpx.MockTransport(handler)
+    with WazzapiClient(base_url="https://api.example.com", transport=transport) as client:
+        client.groups.list(session_name="main", limit=10, offset=5)
+
+    assert seen["query"] == {"session_name": "main", "limit": "10", "offset": "5"}
+
+
+def test_groups_get_sends_session_name_query() -> None:
+    seen: dict[str, object] = {}
+
+    def handler(request: httpx.Request) -> httpx.Response:
+        seen["query"] = dict(request.url.params)
+        return httpx.Response(200, json={"id": "123@g.us", "name": "Test"})
+
+    transport = httpx.MockTransport(handler)
+    with WazzapiClient(base_url="https://api.example.com", transport=transport) as client:
+        client.groups.get("123@g.us", session_name="main")
+
+    assert seen["query"] == {"session_name": "main"}
+
+
+def test_groups_add_participant_sends_query_params() -> None:
+    seen: dict[str, object] = {}
+
+    def handler(request: httpx.Request) -> httpx.Response:
+        seen["query"] = dict(request.url.params)
+        return httpx.Response(200, json={"success": True, "details": "added"})
+
+    transport = httpx.MockTransport(handler)
+    with WazzapiClient(base_url="https://api.example.com", transport=transport) as client:
+        client.groups.add_participant(
+            "123@g.us",
+            session_name="main",
+            participant_jid="6281234567890@s.whatsapp.net",
+        )
+
+    assert seen["query"] == {
+        "session_name": "main",
+        "participant_jid": "6281234567890@s.whatsapp.net",
+    }
+
+
+def test_groups_models_are_importable() -> None:
+    from wazzapi.models import (
+        CreateGroupRequest,
+        CreateGroupResponseModel,
+        GroupDetailResponse,
+        GroupInviteInfoResponseModel,
+        GroupInviteLinkResponseModel,
+        GroupListItem,
+        GroupListResponse,
+        GroupOperationResponseModel,
+        GroupParticipantItem,
+        GroupParticipantsResponse,
+        InviteInfoRequest,
+        JoinGroupRequest,
+        SendGroupMediaRequest,
+        SendGroupResponse,
+        SendGroupTextRequest,
+        SetGroupAnnounceRequest,
+        SetGroupEphemeralRequest,
+        SetGroupLockedRequest,
+        SetGroupNameRequest,
+        SetGroupPhotoRequest,
+        SetGroupTopicRequest,
+        UpdateParticipantsRequest,
+    )
+
+    assert GroupListItem is not None
+    assert CreateGroupResponseModel is not None

{wazzapi-0.1.2 → 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.1.2 → wazzapi-0.3.0}/wazzapi/__init__.py

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

{wazzapi-0.1.2 → 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, MessagesResource, TemplatesResource
+from .resources import ContactsResource, DevicesResource, GroupsResource, MessagesResource, TemplatesResource
 
 DEFAULT_BASE_URL = "https://api.wazzapi.com"
 
@@ -39,6 +39,8 @@ class WazzapiClient:
         )
 
         self.contacts = ContactsResource(self)
+        self.devices = DevicesResource(self)
+        self.groups = GroupsResource(self)
         self.messages = MessagesResource(self)
         self.templates = TemplatesResource(self)
 

{wazzapi-0.1.2 → wazzapi-0.3.0}/wazzapi/models/__init__.py

@@ -1,6 +1,10 @@
 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 *
 from .media import __all__ as media_all
 from .messages import *
@@ -10,4 +14,13 @@ from .templates import __all__ as templates_all
 from .webhooks import *
 from .webhooks import __all__ as webhooks_all
 
-__all__ = ["WazzapiModel", *contacts_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.3.0/wazzapi/models/groups.py

@@ -0,0 +1,165 @@
+from __future__ import annotations
+
+from datetime import datetime
+from typing import Any
+
+from .base import WazzapiModel
+
+
+class GroupListItem(WazzapiModel):
+    id: str
+    name: str
+    description: str | None = None
+    owner: str | None = None
+    participants_count: int = 0
+
+
+class GroupListResponse(WazzapiModel):
+    groups: list[GroupListItem]
+    total: int
+
+
+class GroupDetailResponse(WazzapiModel):
+    id: str
+    name: str
+    description: str | None = None
+    owner: str | None = None
+    participants_count: int = 0
+
+
+class GroupParticipantItem(WazzapiModel):
+    id: str
+    is_admin: bool = False
+    is_super_admin: bool = False
+
+
+class GroupParticipantsResponse(WazzapiModel):
+    participants: list[GroupParticipantItem]
+
+
+class GroupOperationResponseModel(WazzapiModel):
+    success: bool
+    details: str
+
+
+class CreateGroupRequest(WazzapiModel):
+    session_name: str
+    name: str
+    participants: list[str]
+
+
+class CreateGroupResponseModel(WazzapiModel):
+    success: bool
+    jid: str
+    name: str
+    owner_jid: str | None = None
+    group_created: str | None = None
+
+
+class SendGroupTextRequest(WazzapiModel):
+    session_name: str
+    group_jid: str
+    text: str
+    message_id: str | None = None
+
+
+class SendGroupMediaRequest(WazzapiModel):
+    session_name: str
+    group_jid: str
+    media_url: str
+    media_type: str
+    caption: str | None = None
+    filename: str | None = None
+
+
+class SendGroupResponse(WazzapiModel):
+    success: bool
+    message_id: str
+    status: str
+    run_id: str | None = None
+
+
+class UpdateParticipantsRequest(WazzapiModel):
+    session_name: str
+    group_jid: str
+    action: str
+    participants: list[str]
+
+
+class GroupInviteLinkResponseModel(WazzapiModel):
+    success: bool
+    invite_link: str
+
+
+class GroupInviteInfoResponseModel(WazzapiModel):
+    success: bool
+    jid: str
+    name: str
+    participants: int = 0
+    owner_jid: str | None = None
+
+
+class InviteInfoRequest(WazzapiModel):
+    session_name: str
+    invite_link: str
+
+
+class JoinGroupRequest(WazzapiModel):
+    session_name: str
+    invite_link: str
+
+
+class SetGroupNameRequest(WazzapiModel):
+    session_name: str
+    name: str
+
+
+class SetGroupTopicRequest(WazzapiModel):
+    session_name: str
+    topic: str
+
+
+class SetGroupPhotoRequest(WazzapiModel):
+    session_name: str
+    image_data_uri: str
+
+
+class SetGroupAnnounceRequest(WazzapiModel):
+    session_name: str
+    announce: bool
+
+
+class SetGroupLockedRequest(WazzapiModel):
+    session_name: str
+    locked: bool
+
+
+class SetGroupEphemeralRequest(WazzapiModel):
+    session_name: str
+    duration: str
+
+
+__all__ = [
+    "CreateGroupRequest",
+    "CreateGroupResponseModel",
+    "GroupDetailResponse",
+    "GroupInviteInfoResponseModel",
+    "GroupInviteLinkResponseModel",
+    "GroupListItem",
+    "GroupListResponse",
+    "GroupOperationResponseModel",
+    "GroupParticipantItem",
+    "GroupParticipantsResponse",
+    "InviteInfoRequest",
+    "JoinGroupRequest",
+    "SendGroupMediaRequest",
+    "SendGroupResponse",
+    "SendGroupTextRequest",
+    "SetGroupAnnounceRequest",
+    "SetGroupEphemeralRequest",
+    "SetGroupLockedRequest",
+    "SetGroupNameRequest",
+    "SetGroupPhotoRequest",
+    "SetGroupTopicRequest",
+    "UpdateParticipantsRequest",
+]

wazzapi-0.3.0/wazzapi/resources/__init__.py

@@ -0,0 +1,13 @@
+from .contacts import ContactsResource
+from .devices import DevicesResource
+from .groups import GroupsResource
+from .messages import MessagesResource
+from .templates import 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"]

wazzapi-0.3.0/wazzapi/resources/groups.py

@@ -0,0 +1,266 @@
+from __future__ import annotations
+
+from typing import Any
+
+from .. import models
+from .base import BaseResource
+
+
+class GroupsResource(BaseResource):
+    def list(
+        self,
+        *,
+        session_name: str,
+        limit: int | None = None,
+        offset: int | None = None,
+    ) -> models.GroupListResponse:
+        return self._client._request(
+            "GET",
+            "/api/v1/groups",
+            params={
+                "session_name": session_name,
+                "limit": limit,
+                "offset": offset,
+            },
+            response_model=models.GroupListResponse,
+        )
+
+    def get(
+        self,
+        group_jid: str,
+        *,
+        session_name: str,
+    ) -> models.GroupDetailResponse:
+        return self._client._request(
+            "GET",
+            f"/api/v1/groups/{group_jid}",
+            params={"session_name": session_name},
+            response_model=models.GroupDetailResponse,
+        )
+
+    def get_participants(
+        self,
+        group_jid: str,
+        *,
+        session_name: str,
+    ) -> models.GroupParticipantsResponse:
+        return self._client._request(
+            "GET",
+            f"/api/v1/groups/{group_jid}/participants",
+            params={"session_name": session_name},
+            response_model=models.GroupParticipantsResponse,
+        )
+
+    def create(
+        self,
+        payload: models.CreateGroupRequest | dict[str, Any],
+    ) -> models.CreateGroupResponseModel:
+        return self._client._request(
+            "POST",
+            "/api/v1/groups/create",
+            json_body=payload,
+            response_model=models.CreateGroupResponseModel,
+        )
+
+    def send_text(
+        self,
+        payload: models.SendGroupTextRequest | dict[str, Any],
+    ) -> models.SendGroupResponse:
+        return self._client._request(
+            "POST",
+            "/api/v1/groups/send",
+            json_body=payload,
+            response_model=models.SendGroupResponse,
+        )
+
+    def send_media(
+        self,
+        payload: models.SendGroupMediaRequest | dict[str, Any],
+    ) -> models.SendGroupResponse:
+        return self._client._request(
+            "POST",
+            "/api/v1/groups/send/media",
+            json_body=payload,
+            response_model=models.SendGroupResponse,
+        )
+
+    def update_participants(
+        self,
+        payload: models.UpdateParticipantsRequest | dict[str, Any],
+    ) -> models.GroupOperationResponseModel:
+        return self._client._request(
+            "POST",
+            "/api/v1/groups/participants",
+            json_body=payload,
+            response_model=models.GroupOperationResponseModel,
+        )
+
+    def add_participant(
+        self,
+        group_jid: str,
+        *,
+        session_name: str,
+        participant_jid: str,
+    ) -> models.GroupOperationResponseModel:
+        return self._client._request(
+            "POST",
+            f"/api/v1/groups/{group_jid}/participants/add",
+            params={
+                "session_name": session_name,
+                "participant_jid": participant_jid,
+            },
+            response_model=models.GroupOperationResponseModel,
+        )
+
+    def remove_participant(
+        self,
+        group_jid: str,
+        *,
+        session_name: str,
+        participant_jid: str,
+    ) -> models.GroupOperationResponseModel:
+        return self._client._request(
+            "POST",
+            f"/api/v1/groups/{group_jid}/participants/remove",
+            params={
+                "session_name": session_name,
+                "participant_jid": participant_jid,
+            },
+            response_model=models.GroupOperationResponseModel,
+        )
+
+    def get_invite_link(
+        self,
+        group_jid: str,
+        *,
+        session_name: str,
+    ) -> models.GroupInviteLinkResponseModel:
+        return self._client._request(
+            "POST",
+            f"/api/v1/groups/{group_jid}/invite-link",
+            params={"session_name": session_name},
+            response_model=models.GroupInviteLinkResponseModel,
+        )
+
+    def get_invite_info(
+        self,
+        payload: models.InviteInfoRequest | dict[str, Any],
+    ) -> models.GroupInviteInfoResponseModel:
+        return self._client._request(
+            "POST",
+            "/api/v1/groups/invite-info",
+            json_body=payload,
+            response_model=models.GroupInviteInfoResponseModel,
+        )
+
+    def join(
+        self,
+        payload: models.JoinGroupRequest | dict[str, Any],
+    ) -> models.GroupOperationResponseModel:
+        return self._client._request(
+            "POST",
+            "/api/v1/groups/join",
+            json_body=payload,
+            response_model=models.GroupOperationResponseModel,
+        )
+
+    def leave(
+        self,
+        group_jid: str,
+        *,
+        session_name: str,
+    ) -> models.GroupOperationResponseModel:
+        return self._client._request(
+            "POST",
+            f"/api/v1/groups/{group_jid}/leave",
+            params={"session_name": session_name},
+            response_model=models.GroupOperationResponseModel,
+        )
+
+    def set_name(
+        self,
+        group_jid: str,
+        payload: models.SetGroupNameRequest | dict[str, Any],
+    ) -> models.GroupOperationResponseModel:
+        return self._client._request(
+            "POST",
+            f"/api/v1/groups/{group_jid}/name",
+            json_body=payload,
+            response_model=models.GroupOperationResponseModel,
+        )
+
+    def set_topic(
+        self,
+        group_jid: str,
+        payload: models.SetGroupTopicRequest | dict[str, Any],
+    ) -> models.GroupOperationResponseModel:
+        return self._client._request(
+            "POST",
+            f"/api/v1/groups/{group_jid}/topic",
+            json_body=payload,
+            response_model=models.GroupOperationResponseModel,
+        )
+
+    def set_photo(
+        self,
+        group_jid: str,
+        payload: models.SetGroupPhotoRequest | dict[str, Any],
+    ) -> models.GroupOperationResponseModel:
+        return self._client._request(
+            "POST",
+            f"/api/v1/groups/{group_jid}/photo",
+            json_body=payload,
+            response_model=models.GroupOperationResponseModel,
+        )
+
+    def remove_photo(
+        self,
+        group_jid: str,
+        *,
+        session_name: str,
+    ) -> models.GroupOperationResponseModel:
+        return self._client._request(
+            "DELETE",
+            f"/api/v1/groups/{group_jid}/photo",
+            params={"session_name": session_name},
+            response_model=models.GroupOperationResponseModel,
+        )
+
+    def set_announce(
+        self,
+        group_jid: str,
+        payload: models.SetGroupAnnounceRequest | dict[str, Any],
+    ) -> models.GroupOperationResponseModel:
+        return self._client._request(
+            "POST",
+            f"/api/v1/groups/{group_jid}/announce",
+            json_body=payload,
+            response_model=models.GroupOperationResponseModel,
+        )
+
+    def set_locked(
+        self,
+        group_jid: str,
+        payload: models.SetGroupLockedRequest | dict[str, Any],
+    ) -> models.GroupOperationResponseModel:
+        return self._client._request(
+            "POST",
+            f"/api/v1/groups/{group_jid}/locked",
+            json_body=payload,
+            response_model=models.GroupOperationResponseModel,
+        )
+
+    def set_ephemeral(
+        self,
+        group_jid: str,
+        payload: models.SetGroupEphemeralRequest | dict[str, Any],
+    ) -> models.GroupOperationResponseModel:
+        return self._client._request(
+            "POST",
+            f"/api/v1/groups/{group_jid}/ephemeral",
+            json_body=payload,
+            response_model=models.GroupOperationResponseModel,
+        )
+
+
+__all__ = ["GroupsResource"]

wazzapi-0.1.2/wazzapi/resources/__init__.py

@@ -1,5 +0,0 @@
-from .contacts import ContactsResource
-from .messages import MessagesResource
-from .templates import TemplatesResource
-
-__all__ = ["ContactsResource", "MessagesResource", "TemplatesResource"]