seenwa 0.1.0__tar.gz

seenwa-0.1.0/.gitignore

@@ -0,0 +1,7 @@
+__pycache__/
+*.pyc
+.pytest_cache/
+.venv/
+dist/
+build/
+*.egg-info/

seenwa-0.1.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Seen
+
+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.

seenwa-0.1.0/PKG-INFO

@@ -0,0 +1,28 @@
+Metadata-Version: 2.5
+Name: seenwa
+Version: 0.1.0
+Summary: Official Python SDK for the Seen WhatsApp Business API.
+Project-URL: Homepage, https://seen.com
+License: MIT
+License-File: LICENSE
+Requires-Python: >=3.8
+Requires-Dist: requests>=2.31.0
+Description-Content-Type: text/markdown
+
+# seenwa
+
+Python SDK for the Seen WhatsApp Business API.
+
+## Install
+
+```bash
+pip install seenwa
+```
+
+## Usage
+
+```python
+from seenwa import SeenClient
+
+client = SeenClient(api_key="YOUR_API_KEY")
+```

seenwa-0.1.0/README.md

@@ -0,0 +1,17 @@
+# seenwa
+
+Python SDK for the Seen WhatsApp Business API.
+
+## Install
+
+```bash
+pip install seenwa
+```
+
+## Usage
+
+```python
+from seenwa import SeenClient
+
+client = SeenClient(api_key="YOUR_API_KEY")
+```

seenwa-0.1.0/pyproject.toml

@@ -0,0 +1,23 @@
+[build-system]
+requires = ["hatchling"]
+build-backend = "hatchling.build"
+
+[project]
+name = "seenwa"
+version = "0.1.0"
+description = "Official Python SDK for the Seen WhatsApp Business API."
+readme = "README.md"
+requires-python = ">=3.8"
+license = { text = "MIT" }
+dependencies = [
+    "requests>=2.31.0",
+]
+
+[project.urls]
+Homepage = "https://seen.com"
+
+[tool.hatch.build.targets.wheel]
+packages = ["src/seenwa"]
+
+[tool.pytest.ini_options]
+testpaths = ["tests"]

seenwa-0.1.0/src/seenwa/__init__.py

@@ -0,0 +1,4 @@
+from .client import SeenClient
+from .errors import SeenAPIError
+
+__all__ = ["SeenClient", "SeenAPIError"]

seenwa-0.1.0/src/seenwa/client.py

@@ -0,0 +1,36 @@
+from typing import Any, Optional
+
+import requests
+
+from .errors import SeenAPIError
+
+DEFAULT_BASE_URL = "https://api.seen.com/api/v1"
+
+
+class SeenClient:
+    def __init__(self, api_key: str, base_url: str = DEFAULT_BASE_URL):
+        self.api_key = api_key
+        self.base_url = base_url.rstrip("/")
+        self._session = requests.Session()
+
+    def request(self, method: str, path: str, json: Optional[dict] = None) -> Any:
+        response = self._session.request(
+            method,
+            f"{self.base_url}{path}",
+            json=json,
+            headers={"x-api-key": self.api_key},
+        )
+
+        try:
+            payload = response.json()
+        except ValueError:
+            payload = None
+
+        if not response.ok or payload is None:
+            raise SeenAPIError(
+                f"Seen API request failed with status {response.status_code}",
+                response.status_code,
+                payload,
+            )
+
+        return payload["data"]

seenwa-0.1.0/src/seenwa/errors.py

@@ -0,0 +1,5 @@
+class SeenAPIError(Exception):
+    def __init__(self, message: str, status: int, body=None):
+        super().__init__(message)
+        self.status = status
+        self.body = body

seenwa-0.1.0/tests/test_client.py

@@ -0,0 +1,6 @@
+from seenwa import SeenClient
+
+
+def test_constructs_with_default_base_url():
+    client = SeenClient(api_key="test-key")
+    assert client.base_url == "https://api.seen.com/api/v1"