multiwa 1.0.0__tar.gz

multiwa-1.0.0/.gitignore

@@ -0,0 +1,81 @@
+# Dependencies
+node_modules/
+.pnpm-store/
+
+# Build outputs
+dist/
+.next/
+.turbo/
+*.tsbuildinfo
+
+# TypeScript compiled output in src directories
+apps/*/src/**/*.js
+apps/*/src/**/*.d.ts
+apps/*/src/**/*.d.ts.map
+apps/*/src/**/*.js.map
+packages/*/src/**/*.js
+packages/*/src/**/*.d.ts
+packages/*/src/**/*.d.ts.map
+packages/*/src/**/*.js.map
+
+# Environment
+.env
+.env.local
+.env.*.local
+.env.production
+.env.staging
+packages/database/.env
+
+# SSL Certificates
+*.pem
+*.key
+*.crt
+docker/nginx/ssl/
+
+# IDE
+.vscode/
+.idea/
+*.swp
+*.swo
+
+# OS
+.DS_Store
+Thumbs.db
+
+# Logs
+logs/
+*.log
+npm-debug.log*
+pnpm-debug.log*
+
+# Testing
+coverage/
+
+# Python cache
+__pycache__/
+*.pyc
+
+# WhatsApp sessions
+sessions/
+.wwebjs_auth/
+.wwebjs_cache/
+
+# Plugins runtime data
+plugins/*/node_modules/
+
+# Temporary
+.tmp/
+tmp/
+temp/
+
+# Local-only working notes (never public)
+/findings.md
+/progress.md
+/task_plan.md
+/docs/superpowers/
+
+# Internal-only operational notes and SOPs (never public)
+/architecture/
+
+# Docusaurus
+docs-site/.docusaurus/

multiwa-1.0.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 MultiWA
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

multiwa-1.0.0/PKG-INFO

@@ -0,0 +1,177 @@
+Metadata-Version: 2.4
+Name: multiwa
+Version: 1.0.0
+Summary: Official Python SDK for the MultiWA WhatsApp Business API Gateway.
+Project-URL: Homepage, https://github.com/ribato22/MultiWA/tree/main/packages/sdk-python#readme
+Project-URL: Repository, https://github.com/ribato22/MultiWA
+Project-URL: Issues, https://github.com/ribato22/MultiWA/issues
+Project-URL: Changelog, https://github.com/ribato22/MultiWA/blob/main/CHANGELOG.md
+Author: MultiWA Team
+License: MIT
+License-File: LICENSE
+Keywords: api,automation,gateway,messaging,multiwa,whatsapp,whatsapp-api
+Classifier: Development Status :: 4 - Beta
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.9
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Topic :: Communications :: Chat
+Classifier: Topic :: Software Development :: Libraries :: Python Modules
+Classifier: Typing :: Typed
+Requires-Python: >=3.9
+Requires-Dist: httpx>=0.24.0
+Requires-Dist: pydantic>=2.0.0
+Provides-Extra: dev
+Requires-Dist: black>=23.0.0; extra == 'dev'
+Requires-Dist: mypy>=1.0.0; extra == 'dev'
+Requires-Dist: pytest-asyncio>=0.21.0; extra == 'dev'
+Requires-Dist: pytest>=7.0.0; extra == 'dev'
+Requires-Dist: ruff>=0.1.0; extra == 'dev'
+Description-Content-Type: text/markdown
+
+# MultiWA Python SDK
+
+Official Python SDK for [MultiWA](https://github.com/ribato22/multiwa) - WhatsApp Business API Gateway.
+
+## Installation
+
+The SDK is available in this repository today. Public registry publishing
+(`multiwa` on PyPI) is tracked as a release follow-up and is **not yet
+verified**, so do not assume `pip install multiwa` resolves to this package
+on the registry.
+
+Until the registry release is verified, install from this repository:
+
+```bash
+# From the MultiWA monorepo (recommended for contributors)
+pip install -e packages/sdk-python
+
+# From a git ref
+pip install "multiwa @ git+https://github.com/ribato22/MultiWA.git#subdirectory=packages/sdk-python"
+```
+
+## Quick Start
+
+```python
+from multiwa import MultiWA
+
+# Initialize the client. base_url must include the API prefix /api/v1.
+#   Local dev: http://localhost:3000/api/v1
+#   Docker:    http://localhost:3333/api/v1
+#   Prod:      https://your-multiwa-instance.com/api/v1
+client = MultiWA(
+    base_url="https://your-multiwa-instance.com/api/v1",
+    api_key="your-api-key",
+)
+
+# Send a text message
+result = client.messages.send_text(
+    profile_id="your-profile-id",
+    to="6281234567890",
+    text="Hello from MultiWA Python SDK!"
+)
+
+print(result)
+```
+
+## Features
+
+### Messages
+
+```python
+# Send text
+client.messages.send_text(profile_id, to, text)
+
+# Send image
+client.messages.send_image(profile_id, to, url="https://...", caption="Check this!")
+
+# Send video
+client.messages.send_video(profile_id, to, url="https://...", caption="Watch this!")
+
+# Send document
+client.messages.send_document(profile_id, to, url="https://...", filename="report.pdf")
+
+# Send location
+client.messages.send_location(profile_id, to, latitude=-6.2088, longitude=106.8456)
+
+# Send contact
+client.messages.send_contact(profile_id, to, name="John Doe", phone="+6281234567890")
+
+# Send poll
+client.messages.send_poll(
+    profile_id, to,
+    question="What's your favorite color?",
+    options=["Red", "Green", "Blue"]
+)
+```
+
+### Broadcasts
+
+```python
+# Create broadcast
+client.broadcasts.create(
+    profile_id="...",
+    name="Promo Campaign",
+    recipients=["6281234567890", "6281234567891"],
+    template_id="template-uuid"
+)
+
+# List broadcasts
+broadcasts = client.broadcasts.list(profile_id)
+```
+
+### Contacts
+
+```python
+# Create contact
+client.contacts.create(
+    profile_id="...",
+    phone="6281234567890",
+    name="John Doe",
+    tags=["customer", "vip"]
+)
+
+# List contacts
+contacts = client.contacts.list(profile_id)
+```
+
+### Webhooks
+
+```python
+# Create webhook
+client.webhooks.create(
+    profile_id="...",
+    url="https://your-webhook.com/whatsapp",
+    events=["message.received", "message.sent"]
+)
+```
+
+## Async Support
+
+```python
+import asyncio
+from multiwa import AsyncMultiWA
+
+async def main():
+    client = AsyncMultiWA(
+        base_url="https://your-multiwa-instance.com/api",
+        api_key="your-api-key"
+    )
+    
+    result = await client.messages.send_text(
+        profile_id="...",
+        to="6281234567890",
+        text="Hello async!"
+    )
+    print(result)
+
+asyncio.run(main())
+```
+
+## License
+
+MIT - See [LICENSE](LICENSE) for details.

multiwa-1.0.0/README.md

@@ -0,0 +1,142 @@
+# MultiWA Python SDK
+
+Official Python SDK for [MultiWA](https://github.com/ribato22/multiwa) - WhatsApp Business API Gateway.
+
+## Installation
+
+The SDK is available in this repository today. Public registry publishing
+(`multiwa` on PyPI) is tracked as a release follow-up and is **not yet
+verified**, so do not assume `pip install multiwa` resolves to this package
+on the registry.
+
+Until the registry release is verified, install from this repository:
+
+```bash
+# From the MultiWA monorepo (recommended for contributors)
+pip install -e packages/sdk-python
+
+# From a git ref
+pip install "multiwa @ git+https://github.com/ribato22/MultiWA.git#subdirectory=packages/sdk-python"
+```
+
+## Quick Start
+
+```python
+from multiwa import MultiWA
+
+# Initialize the client. base_url must include the API prefix /api/v1.
+#   Local dev: http://localhost:3000/api/v1
+#   Docker:    http://localhost:3333/api/v1
+#   Prod:      https://your-multiwa-instance.com/api/v1
+client = MultiWA(
+    base_url="https://your-multiwa-instance.com/api/v1",
+    api_key="your-api-key",
+)
+
+# Send a text message
+result = client.messages.send_text(
+    profile_id="your-profile-id",
+    to="6281234567890",
+    text="Hello from MultiWA Python SDK!"
+)
+
+print(result)
+```
+
+## Features
+
+### Messages
+
+```python
+# Send text
+client.messages.send_text(profile_id, to, text)
+
+# Send image
+client.messages.send_image(profile_id, to, url="https://...", caption="Check this!")
+
+# Send video
+client.messages.send_video(profile_id, to, url="https://...", caption="Watch this!")
+
+# Send document
+client.messages.send_document(profile_id, to, url="https://...", filename="report.pdf")
+
+# Send location
+client.messages.send_location(profile_id, to, latitude=-6.2088, longitude=106.8456)
+
+# Send contact
+client.messages.send_contact(profile_id, to, name="John Doe", phone="+6281234567890")
+
+# Send poll
+client.messages.send_poll(
+    profile_id, to,
+    question="What's your favorite color?",
+    options=["Red", "Green", "Blue"]
+)
+```
+
+### Broadcasts
+
+```python
+# Create broadcast
+client.broadcasts.create(
+    profile_id="...",
+    name="Promo Campaign",
+    recipients=["6281234567890", "6281234567891"],
+    template_id="template-uuid"
+)
+
+# List broadcasts
+broadcasts = client.broadcasts.list(profile_id)
+```
+
+### Contacts
+
+```python
+# Create contact
+client.contacts.create(
+    profile_id="...",
+    phone="6281234567890",
+    name="John Doe",
+    tags=["customer", "vip"]
+)
+
+# List contacts
+contacts = client.contacts.list(profile_id)
+```
+
+### Webhooks
+
+```python
+# Create webhook
+client.webhooks.create(
+    profile_id="...",
+    url="https://your-webhook.com/whatsapp",
+    events=["message.received", "message.sent"]
+)
+```
+
+## Async Support
+
+```python
+import asyncio
+from multiwa import AsyncMultiWA
+
+async def main():
+    client = AsyncMultiWA(
+        base_url="https://your-multiwa-instance.com/api",
+        api_key="your-api-key"
+    )
+    
+    result = await client.messages.send_text(
+        profile_id="...",
+        to="6281234567890",
+        text="Hello async!"
+    )
+    print(result)
+
+asyncio.run(main())
+```
+
+## License
+
+MIT - See [LICENSE](LICENSE) for details.

multiwa-1.0.0/multiwa/__init__.py

@@ -0,0 +1,31 @@
+"""
+MultiWA Python SDK
+
+Official Python SDK for MultiWA - WhatsApp Business API Gateway.
+"""
+
+from .client import MultiWA, AsyncMultiWA
+from .webhooks import verify_webhook_signature
+from .types import (
+    Message,
+    MessageResult,
+    Contact,
+    Broadcast,
+    Template,
+    Profile,
+    Webhook,
+)
+
+__version__ = "1.0.0"
+__all__ = [
+    "MultiWA",
+    "AsyncMultiWA",
+    "Message",
+    "MessageResult",
+    "Contact",
+    "Broadcast",
+    "Template",
+    "Profile",
+    "Webhook",
+    "verify_webhook_signature",
+]

multiwa-1.0.0/multiwa/broadcasts.py

@@ -0,0 +1,147 @@
+"""
+MultiWA Python SDK - Broadcasts Client
+
+Client for managing broadcast campaigns.
+"""
+
+from typing import Optional, List, Dict, Any
+import httpx
+
+from .types import Broadcast
+
+
+class BroadcastsClient:
+    """Synchronous Broadcasts API client"""
+    
+    def __init__(self, http: httpx.Client):
+        self._http = http
+    
+    def create(
+        self,
+        profile_id: str,
+        name: str,
+        recipients: List[str],
+        template_id: Optional[str] = None,
+        message: Optional[str] = None,
+        schedule_at: Optional[str] = None,
+    ) -> Broadcast:
+        """Create a new broadcast campaign"""
+        response = self._http.post("/broadcasts", json={
+            "profileId": profile_id,
+            "name": name,
+            "recipients": recipients,
+            "templateId": template_id,
+            "message": message,
+            "scheduleAt": schedule_at,
+        })
+        response.raise_for_status()
+        return Broadcast(**response.json())
+    
+    def get(self, broadcast_id: str) -> Broadcast:
+        """Get a broadcast by ID"""
+        response = self._http.get(f"/broadcasts/{broadcast_id}")
+        response.raise_for_status()
+        return Broadcast(**response.json())
+    
+    def list(
+        self,
+        profile_id: str,
+        limit: int = 50,
+        offset: int = 0,
+        status: Optional[str] = None,
+    ) -> List[Broadcast]:
+        """List broadcasts for a profile"""
+        params: Dict[str, Any] = {
+            "limit": limit,
+            "offset": offset,
+        }
+        if status:
+            params["status"] = status
+            
+        response = self._http.get(f"/broadcasts/profile/{profile_id}", params=params)
+        response.raise_for_status()
+        return [Broadcast(**b) for b in response.json()]
+    
+    def start(self, broadcast_id: str) -> Broadcast:
+        """Start a broadcast"""
+        response = self._http.post(f"/broadcasts/{broadcast_id}/start")
+        response.raise_for_status()
+        return Broadcast(**response.json())
+    
+    def pause(self, broadcast_id: str) -> Broadcast:
+        """Pause a broadcast"""
+        response = self._http.post(f"/broadcasts/{broadcast_id}/pause")
+        response.raise_for_status()
+        return Broadcast(**response.json())
+    
+    def cancel(self, broadcast_id: str) -> Broadcast:
+        """Cancel a broadcast"""
+        response = self._http.post(f"/broadcasts/{broadcast_id}/cancel")
+        response.raise_for_status()
+        return Broadcast(**response.json())
+    
+    def delete(self, broadcast_id: str) -> Dict[str, bool]:
+        """Delete a broadcast"""
+        response = self._http.delete(f"/broadcasts/{broadcast_id}")
+        response.raise_for_status()
+        return response.json()
+    
+    def stats(self, broadcast_id: str) -> Dict[str, Any]:
+        """Get broadcast statistics"""
+        response = self._http.get(f"/broadcasts/{broadcast_id}/stats")
+        response.raise_for_status()
+        return response.json()
+
+
+class AsyncBroadcastsClient:
+    """Asynchronous Broadcasts API client"""
+    
+    def __init__(self, http: httpx.AsyncClient):
+        self._http = http
+    
+    async def create(
+        self,
+        profile_id: str,
+        name: str,
+        recipients: List[str],
+        template_id: Optional[str] = None,
+        message: Optional[str] = None,
+        schedule_at: Optional[str] = None,
+    ) -> Broadcast:
+        """Create a new broadcast campaign"""
+        response = await self._http.post("/broadcasts", json={
+            "profileId": profile_id,
+            "name": name,
+            "recipients": recipients,
+            "templateId": template_id,
+            "message": message,
+            "scheduleAt": schedule_at,
+        })
+        response.raise_for_status()
+        return Broadcast(**response.json())
+    
+    async def get(self, broadcast_id: str) -> Broadcast:
+        """Get a broadcast by ID"""
+        response = await self._http.get(f"/broadcasts/{broadcast_id}")
+        response.raise_for_status()
+        return Broadcast(**response.json())
+    
+    async def list(
+        self,
+        profile_id: str,
+        limit: int = 50,
+        offset: int = 0,
+    ) -> List[Broadcast]:
+        """List broadcasts for a profile"""
+        response = await self._http.get(
+            f"/broadcasts/profile/{profile_id}",
+            params={"limit": limit, "offset": offset}
+        )
+        response.raise_for_status()
+        return [Broadcast(**b) for b in response.json()]
+    
+    async def start(self, broadcast_id: str) -> Broadcast:
+        """Start a broadcast"""
+        response = await self._http.post(f"/broadcasts/{broadcast_id}/start")
+        response.raise_for_status()
+        return Broadcast(**response.json())