kambasms 1.0.0__tar.gz

kambasms-1.0.0/PKG-INFO

@@ -0,0 +1,20 @@
+Metadata-Version: 2.4
+Name: kambasms
+Version: 1.0.0
+Summary: SDK oficial da KambaSMS para envio de mensagens SMS em Angola
+Author-email: KambaSMS <support@kambasms.ao>
+License: MIT
+Project-URL: Homepage, https://github.com/FranciiscoCampos170/kamba_sms_python_sdk
+Project-URL: Repository, https://github.com/FranciiscoCampos170/kamba_sms_python_sdk
+Project-URL: Issues, https://github.com/FranciiscoCampos170/kamba_sms_python_sdk/issues
+Keywords: sms,angola,kambasms,api,messaging
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.8
+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: License :: OSI Approved :: MIT License
+Classifier: Operating System :: OS Independent
+Requires-Python: >=3.8
+Description-Content-Type: text/markdown

kambasms-1.0.0/kambasms/__init__.py

@@ -0,0 +1,12 @@
+from .client import KambaClient
+from .resources.sms import SmsResource
+from .resources.account import AccountResource
+from .exceptions import KambaError, KambaValidationError, KambaAPIError
+
+class KambaSMS(KambaClient):
+    def __init__(self, api_key: str, base_url: str = "https://nexasms-api.onrender.com"):
+        super().__init__(api_key, base_url)
+        self.sms = SmsResource(self)
+        self.account = AccountResource(self)
+
+__all__ = ["KambaSMS", "KambaError", "KambaValidationError", "KambaAPIError"]

kambasms-1.0.0/kambasms/client.py

@@ -0,0 +1,36 @@
+import json
+import urllib.request
+import urllib.error
+from typing import Any
+from .exceptions import KambaError, KambaAPIError
+
+class KambaClient:
+    def __init__(self, api_key: str, base_url: str = "https://nexasms-api.onrender.com"):
+        if not api_key:
+            raise KambaError("A apiKey é obrigatória para inicializar o KambaSMS.")
+        self._api_key = api_key
+        self._base_url = base_url.rstrip("/")
+
+    def request(self, method: str, endpoint: str, data: dict | None = None) -> dict[str, Any]:
+        url = f"{self._base_url}{endpoint}"
+        headers = {
+            "Content-Type": "application/json",
+            "x-api-key": self._api_key,
+        }
+
+        body = json.dumps(data).encode("utf-8") if data else None
+        req = urllib.request.Request(url, data=body, headers=headers, method=method)
+
+        try:
+            with urllib.request.urlopen(req, timeout=30) as response:
+                return json.loads(response.read().decode("utf-8"))
+        except urllib.error.HTTPError as e:
+            error_body = e.read().decode("utf-8")
+            try:
+                error_data = json.loads(error_body)
+                message = error_data.get("error", "Erro desconhecido na API KambaSMS")
+            except json.JSONDecodeError:
+                message = "Erro desconhecido na API KambaSMS"
+            raise KambaAPIError(message, e.code, error_data if isinstance(error_data, dict) else {}) from e
+        except urllib.error.URLError as e:
+            raise KambaError(f"Erro de rede: {e.reason}") from e

kambasms-1.0.0/kambasms/examples/example.py

@@ -0,0 +1,25 @@
+from kambasms import KambaSMS, KambaValidationError, KambaAPIError
+
+client = KambaSMS(api_key="kamba_tua_chave_de_teste_aqui")
+
+try:
+    balance = client.account.get_balance()
+    print(f"✅ Saldo atual: {balance['balance']} SMS")
+
+    sms = client.sms.send(
+        to="+244923456789",
+        text="Teste do SDK Python KambaSMS.",
+        sender_id="KAMBA"
+    )
+    print(f"✅ SMS Enviado! ID: {sms['message_id']} | Saldo: {sms['remaining_balance']}")
+
+    # Teste de validação (deve falhar no cliente)
+    try:
+        client.sms.send(to="923456789", text="Visite www.kambasms.ao 🚀", sender_id="KAMBA")
+    except KambaValidationError as e:
+        print(f"🛡️ Validação funcionou: {e}")
+
+except KambaAPIError as e:
+    print(f"❌ Erro API ({e.status_code}): {e}")
+except Exception as e:
+    print(f"❌ Erro: {e}")

kambasms-1.0.0/kambasms/exceptions.py

@@ -0,0 +1,14 @@
+class KambaError(Exception):
+    """Exceção base da KambaSMS."""
+    pass
+
+class KambaValidationError(KambaError):
+    """Erro de validação no lado do cliente."""
+    pass
+
+class KambaAPIError(KambaError):
+    """Erro retornado pela API KambaSMS."""
+    def __init__(self, message: str, status_code: int, details: dict | None = None):
+        super().__init__(message)
+        self.status_code = status_code
+        self.details = details or {}

kambasms-1.0.0/kambasms/resources/account.py

@@ -0,0 +1,11 @@
+from ..client import KambaClient
+
+class AccountResource:
+    def __init__(self, client: KambaClient):
+        self._client = client
+
+    def get_balance(self) -> dict:
+        return self._client.request("GET", "/credits/balance")
+
+    def get_history(self, limit: int = 100) -> list[dict]:
+        return self._client.request("GET", f"/messages?limit={limit}")

kambasms-1.0.0/kambasms/resources/sms.py

@@ -0,0 +1,33 @@
+from datetime import datetime
+from ..client import KambaClient
+from ..validators import validate_angolan_phone, validate_message_content
+
+class SmsResource:
+    def __init__(self, client: KambaClient):
+        self._client = client
+
+    def send(self, to: str, text: str, sender_id: str | None = None) -> dict:
+        validate_angolan_phone(to)
+        validate_message_content(text)
+        payload = {"to": to, "text": text}
+        if sender_id:
+            payload["sender_id"] = sender_id
+        return self._client.request("POST", "/messages/send", payload)
+
+    def send_bulk(self, name: str, sender_id: str, text: str, recipients: list[str]) -> dict:
+        validate_message_content(text)
+        for phone in recipients:
+            validate_angolan_phone(phone)
+        if len(recipients) > 1000:
+            raise ValueError("O limite máximo é de 1000 destinatários por envio em massa.")
+        return self._client.request("POST", "/messages/bulk", {
+            "name": name, "sender_id": sender_id, "text": text, "recipients": recipients
+        })
+
+    def schedule(self, to: str, text: str, sender_id: str, scheduled_at: str | datetime) -> dict:
+        validate_angolan_phone(to)
+        validate_message_content(text)
+        ts = scheduled_at.isoformat() if isinstance(scheduled_at, datetime) else scheduled_at
+        return self._client.request("POST", "/messages/schedule", {
+            "to": to, "text": text, "sender_id": sender_id, "scheduled_at": ts
+        })

kambasms-1.0.0/kambasms/validators.py

@@ -0,0 +1,28 @@
+import re
+from .exceptions import KambaValidationError
+
+_PHONE_REGEX = re.compile(r'^\+244[0-9]{9}$')
+_URL_REGEX = re.compile(r'https?://|www\.|\.com\b|\.ao\b|\.net\b|\.org\b|\.co\b|\.io\b', re.IGNORECASE)
+_EMOJI_REGEX = re.compile(
+    r'[\U0001F600-\U0001F64F\U0001F300-\U0001F5FF\U0001F680-\U0001F6FF\U00002600-\U000026FF\U00002700-\U000027BF]'
+)
+
+def validate_angolan_phone(phone: str) -> None:
+    if not _PHONE_REGEX.match(phone):
+        raise KambaValidationError(
+            f"Número de telefone inválido: '{phone}'. Deve ser +244 seguido de 9 dígitos (ex: +244923456789)."
+        )
+
+def validate_message_content(text: str) -> None:
+    if _URL_REGEX.search(text):
+        raise KambaValidationError(
+            "Mensagens com links ou URLs não são permitidas. As operadoras angolanas filtram este conteúdo como spam."
+        )
+    if len(text) > 160:
+        raise KambaValidationError(
+            f"Mensagem demasiado longa ({len(text)}/160 caracteres). O limite é de 160 caracteres por SMS."
+        )
+    if _EMOJI_REGEX.search(text):
+        raise KambaValidationError(
+            "Emojis não são suportados. As operadoras angolanas podem bloquear ou cobrar múltiplos SMS por mensagens com emojis."
+        )

kambasms-1.0.0/kambasms.egg-info/PKG-INFO

@@ -0,0 +1,20 @@
+Metadata-Version: 2.4
+Name: kambasms
+Version: 1.0.0
+Summary: SDK oficial da KambaSMS para envio de mensagens SMS em Angola
+Author-email: KambaSMS <support@kambasms.ao>
+License: MIT
+Project-URL: Homepage, https://github.com/FranciiscoCampos170/kamba_sms_python_sdk
+Project-URL: Repository, https://github.com/FranciiscoCampos170/kamba_sms_python_sdk
+Project-URL: Issues, https://github.com/FranciiscoCampos170/kamba_sms_python_sdk/issues
+Keywords: sms,angola,kambasms,api,messaging
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.8
+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: License :: OSI Approved :: MIT License
+Classifier: Operating System :: OS Independent
+Requires-Python: >=3.8
+Description-Content-Type: text/markdown

kambasms-1.0.0/kambasms.egg-info/SOURCES.txt

@@ -0,0 +1,14 @@
+README.md
+pyproject.toml
+kambasms/__init__.py
+kambasms/client.py
+kambasms/exceptions.py
+kambasms/validators.py
+kambasms.egg-info/PKG-INFO
+kambasms.egg-info/SOURCES.txt
+kambasms.egg-info/dependency_links.txt
+kambasms.egg-info/top_level.txt
+kambasms/examples/example.py
+kambasms/resources/__init__.py
+kambasms/resources/account.py
+kambasms/resources/sms.py

kambasms-1.0.0/kambasms.egg-info/dependency_links.txt

@@ -0,0 +1 @@
+

kambasms-1.0.0/kambasms.egg-info/top_level.txt

@@ -0,0 +1 @@
+kambasms

kambasms-1.0.0/pyproject.toml

@@ -0,0 +1,29 @@
+[build-system]
+requires = ["setuptools>=61.0", "wheel"]
+build-backend = "setuptools.build_meta"
+
+[project]
+name = "kambasms"
+version = "1.0.0"
+description = "SDK oficial da KambaSMS para envio de mensagens SMS em Angola"
+readme = "README.md"
+license = {text = "MIT"}
+authors = [{name = "KambaSMS", email = "support@kambasms.ao"}]
+keywords = ["sms", "angola", "kambasms", "api", "messaging"]
+classifiers = [
+    "Programming Language :: Python :: 3",
+    "Programming Language :: Python :: 3.8",
+    "Programming Language :: Python :: 3.9",
+    "Programming Language :: Python :: 3.10",
+    "Programming Language :: Python :: 3.11",
+    "Programming Language :: Python :: 3.12",
+    "License :: OSI Approved :: MIT License",
+    "Operating System :: OS Independent",
+]
+requires-python = ">=3.8"
+dependencies = []
+
+[project.urls]
+Homepage = "https://github.com/FranciiscoCampos170/kamba_sms_python_sdk"
+Repository = "https://github.com/FranciiscoCampos170/kamba_sms_python_sdk"
+Issues = "https://github.com/FranciiscoCampos170/kamba_sms_python_sdk/issues"

kambasms-1.0.0/setup.cfg

@@ -0,0 +1,4 @@
+[egg_info]
+tag_build = 
+tag_date = 0
+