django-anysms 0.1.0__tar.gz

django_anysms-0.1.0/.github/dependabot.yml

@@ -0,0 +1,6 @@
+version: 2
+updates:
+  - package-ecosystem: github-actions
+    directory: /
+    schedule:
+      interval: weekly

django_anysms-0.1.0/.github/workflows/ci.yml

@@ -0,0 +1,50 @@
+name: CI
+
+on:
+  push:
+  pull_request:
+
+jobs:
+  test:
+    runs-on: ubuntu-latest
+    strategy:
+      fail-fast: false
+      matrix:
+        include:
+          - {python: "3.10", django: "~=5.2.0"}
+          - {python: "3.11", django: "~=5.2.0"}
+          - {python: "3.12", django: "~=5.2.0"}
+          - {python: "3.12", django: "~=6.0.0"}
+          - {python: "3.13", django: "~=5.2.0"}
+          - {python: "3.13", django: "~=6.0.0"}
+    steps:
+      - uses: actions/checkout@v4
+      - uses: actions/setup-python@v5
+        with:
+          python-version: ${{ matrix.python }}
+          cache: pip
+      - run: python -m pip install -e '.[test,twilio]' "Django${{ matrix.django }}"
+      - run: python -m pytest -q
+      - run: python -m ruff check .
+      - run: python -m ruff format --check .
+      - run: python -m mypy django_anysms
+
+  build:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+      - uses: actions/setup-python@v5
+        with:
+          python-version: "3.13"
+          cache: pip
+      - run: python -m pip install build
+      - run: python -m build
+      - name: Verify core and Twilio extra installation
+        run: |
+          python -m venv /tmp/django-anysms-wheel
+          wheel=$(realpath "$(find dist -name '*.whl' -print -quit)")
+          /tmp/django-anysms-wheel/bin/python -m pip install "$wheel"
+          cd /tmp
+          /tmp/django-anysms-wheel/bin/python -c "import django_anysms"
+          /tmp/django-anysms-wheel/bin/python -m pip install "${wheel}[twilio]"
+          /tmp/django-anysms-wheel/bin/python -c "from django_anysms.providers.twilio import TwilioProvider"

django_anysms-0.1.0/.github/workflows/release.yml

@@ -0,0 +1,70 @@
+name: Release
+
+on:
+  push:
+    branches:
+      - main
+
+permissions: {}
+
+jobs:
+  release:
+    name: Release Please
+    runs-on: ubuntu-latest
+    permissions:
+      contents: write
+      issues: write
+      pull-requests: write
+    outputs:
+      release_created: ${{ steps.release.outputs.release_created }}
+      tag_name: ${{ steps.release.outputs.tag_name }}
+    steps:
+      - id: release
+        uses: googleapis/release-please-action@5c625bfb5d1ff62eadeeb3772007f7f66fdcf071  # v4
+        with:
+          config-file: release-please-config.json
+          manifest-file: .release-please-manifest.json
+
+  build:
+    name: Build distributions
+    needs: release
+    if: ${{ needs.release.outputs.release_created == 'true' }}
+    runs-on: ubuntu-latest
+    permissions:
+      contents: read
+    steps:
+      - uses: actions/checkout@11d5960a326750d5838078e36cf38b85af677262  # v4
+        with:
+          ref: ${{ needs.release.outputs.tag_name }}
+      - uses: actions/setup-python@a26af69be951a213d495a4c3e4e4022e16d87065  # v5
+        with:
+          python-version: "3.13"
+      - name: Install build tools
+        run: python -m pip install "build>=1.2,<2" "twine>=6,<7"
+      - name: Build distributions with Hatchling
+        run: python -m build
+      - name: Validate distributions
+        run: python -m twine check dist/*
+      - uses: actions/upload-artifact@ea165f8d65b6e75b540449e92b4886f43607fa02  # v4
+        with:
+          name: python-package-distributions
+          path: dist/
+          if-no-files-found: error
+
+  publish:
+    name: Publish distributions to PyPI
+    needs: build
+    runs-on: ubuntu-latest
+    environment:
+      name: pypi
+      url: https://pypi.org/p/django-anysms
+    permissions:
+      id-token: write
+    steps:
+      - uses: actions/download-artifact@d3f86a106a0bac45b974a628896c90dbdf5c8093  # v4
+        with:
+          name: python-package-distributions
+          path: dist/
+      - uses: pypa/gh-action-pypi-publish@dc37677b2e1c63e2034f94d8a5b11f265b73ba33  # release/v1
+        with:
+          packages-dir: dist/

django_anysms-0.1.0/.gitignore

@@ -0,0 +1,10 @@
+__pycache__/
+*.py[cod]
+.pytest_cache/
+.mypy_cache/
+.ruff_cache/
+.venv/
+build/
+dist/
+*.egg-info/
+

django_anysms-0.1.0/.release-please-manifest.json

@@ -0,0 +1 @@
+{".":"0.1.0"}

django_anysms-0.1.0/CHANGELOG.md

@@ -0,0 +1,31 @@
+# Changelog
+
+## 0.1.0 (2026-09-05)
+
+
+### Features
+
+* add normalized messaging value objects ([203e63c](https://github.com/davisilvarafacho/django-anysms/commit/203e63c8f58a2dbc370ff3816b8be8067c7e6dfc))
+* add SMS and WhatsApp message contracts ([0d3eac3](https://github.com/davisilvarafacho/django-anysms/commit/0d3eac3be160de9981ced7e9576399b57d2c8534))
+* add Twilio provider boundary ([7831691](https://github.com/davisilvarafacho/django-anysms/commit/78316913bdaa03bc3e69505d7ae93ff4f5fbba58))
+* resolve providers from Django settings ([11efcbb](https://github.com/davisilvarafacho/django-anysms/commit/11efcbbc97d71a0fd47f2b7bac56928d934f3e92))
+* send SMS messages through Twilio ([9ac8a00](https://github.com/davisilvarafacho/django-anysms/commit/9ac8a00f6f170b86a2b0b4907a8696045b207f8a))
+* send WhatsApp messages through Twilio ([7f0eb2d](https://github.com/davisilvarafacho/django-anysms/commit/7f0eb2da5c869b243388355a0d91a559587d4fa1))
+* validate and parse Twilio delivery callbacks ([85788cd](https://github.com/davisilvarafacho/django-anysms/commit/85788cd41234b046689388a30c09b85c126a6131))
+
+
+### Bug Fixes
+
+* close django-anysms v0.1 review gaps ([32a592c](https://github.com/davisilvarafacho/django-anysms/commit/32a592cdca6821f64a41a128490d0d4d7189db20))
+* harden release automation ([28bd02a](https://github.com/davisilvarafacho/django-anysms/commit/28bd02aa7210857ca3169894a093bcf0d452cbf9))
+* validate Twilio SID types before sending ([91418cb](https://github.com/davisilvarafacho/django-anysms/commit/91418cbe2b63622d9129c58bce71d539404587a9))
+
+
+### Documentation
+
+* define django-anysms v0.1 design ([b049966](https://github.com/davisilvarafacho/django-anysms/commit/b049966365e894c3545259b20a8d06c3f124633b))
+* design automated PyPI releases ([ea23409](https://github.com/davisilvarafacho/django-anysms/commit/ea23409b627fda31c69b6c8482f595dd921381ed))
+* explain automated release setup ([29b2f33](https://github.com/davisilvarafacho/django-anysms/commit/29b2f33800fabdb63c9b09d8b74cd2d86c2f5764))
+* plan automated PyPI releases ([e0523f2](https://github.com/davisilvarafacho/django-anysms/commit/e0523f275b492d236ba41c13745d273e6ea410a2))
+* plan django-anysms v0.1 implementation ([693b1e7](https://github.com/davisilvarafacho/django-anysms/commit/693b1e7f6abc99f1cc0b4bfb2062b171686d08ff))
+* publish django-anysms v0.1 usage and CI ([39aef43](https://github.com/davisilvarafacho/django-anysms/commit/39aef43b2f50c6efdbc3e2a484aaaf45cf8e06ae))

django_anysms-0.1.0/PKG-INFO

@@ -0,0 +1,237 @@
+Metadata-Version: 2.4
+Name: django-anysms
+Version: 0.1.0
+Summary: Provider-independent SMS and WhatsApp messaging for Django
+Requires-Python: <3.14,>=3.10
+Requires-Dist: django<6.1,>=5.2
+Provides-Extra: test
+Requires-Dist: build>=1.2; extra == 'test'
+Requires-Dist: mypy>=1.17; extra == 'test'
+Requires-Dist: pytest-django>=4.11; extra == 'test'
+Requires-Dist: pytest>=8.4; extra == 'test'
+Requires-Dist: pyyaml<7,>=6.0; extra == 'test'
+Requires-Dist: ruff>=0.12; extra == 'test'
+Requires-Dist: tomli>=2.0; (python_version < '3.11') and extra == 'test'
+Requires-Dist: twine<7,>=6; extra == 'test'
+Provides-Extra: twilio
+Requires-Dist: twilio<10,>=9.11; extra == 'twilio'
+Description-Content-Type: text/markdown
+
+# django-anysms
+
+Envio de SMS e WhatsApp com uma API Django consistente e provedores
+intercambiáveis. A versão 0.1 inclui Twilio, mensagens síncronas e parsing
+validado de callbacks de entrega.
+
+## Instalação
+
+```bash
+python -m pip install django-anysms
+python -m pip install 'django-anysms[twilio]'
+```
+
+A v0.1 suporta Python 3.10–3.13, Django 5.2 LTS e Django 6.0. O SDK da
+Twilio é opcional e não é importado pelo core.
+
+## Configuração
+
+Configure aliases em suas settings Django:
+
+```python
+import os
+
+ANYSMS = {
+    "DEFAULT": "twilio",
+    "PROVIDERS": {
+        "twilio": {
+            "CLASS": "django_anysms.providers.twilio.TwilioProvider",
+            "OPTIONS": {
+                "account_sid": os.environ["TWILIO_ACCOUNT_SID"],
+                "auth_token": os.environ["TWILIO_AUTH_TOKEN"],
+                "from_": "+5511999999999",
+            },
+        },
+    },
+}
+```
+
+O pacote não precisa ser adicionado a `INSTALLED_APPS`.
+
+## SMS
+
+```python
+from django_anysms import SMSMessage
+
+result = SMSMessage(
+    to="+5511888888888",
+    body="Seu código é 123456",
+    status_callback="https://example.com/webhooks/twilio/status/",
+).send()
+
+print(result.message_id, result.status)
+```
+
+Cada mensagem possui exatamente um destinatário em formato E.164. Números
+nacionais não são corrigidos ou completados automaticamente.
+
+Um recurso específico pode ser informado sem contaminar a API comum:
+
+```python
+message = SMSMessage(
+    to="+5511888888888",
+    body="Olá",
+    provider_options={
+        "twilio": {"messaging_service_sid": "MG..."},
+    },
+)
+message.send(using="twilio")
+```
+
+## WhatsApp
+
+Texto livre dentro de uma conversa permitida pelo WhatsApp:
+
+```python
+from django_anysms import WhatsAppMessage
+
+WhatsAppMessage(
+    to="+5511888888888",
+    body="Seu pedido saiu para entrega.",
+).send()
+```
+
+Mensagem proativa com um Content Template aprovado:
+
+```python
+WhatsAppMessage(
+    to="+5511888888888",
+    content_sid="HX0123456789abcdef0123456789abcdef",
+    variables={"1": "Rafael", "2": "15/08/2026"},
+).send()
+```
+
+`body` e `content_sid` são mutuamente exclusivos. O provider adiciona o
+prefixo `whatsapp:`; a API pública recebe somente E.164.
+
+## Provider explícito
+
+Settings são opcionais quando a aplicação precisa de credenciais dinâmicas:
+
+```python
+from django_anysms import SMSMessage
+from django_anysms.providers.twilio import TwilioProvider
+
+provider = TwilioProvider(
+    account_sid="AC...",
+    auth_token="...",
+    from_="+5511999999999",
+)
+
+result = SMSMessage(to="+5511888888888", body="Olá").send(provider=provider)
+```
+
+A prioridade é: instância em `provider=`, alias em `using=` e, por último,
+`ANYSMS["DEFAULT"]`. `provider` e `using` não podem ser usados juntos.
+
+## Erros
+
+Falhas esperadas herdam de `AnySMSError`. Por padrão elas são lançadas. Para
+um fluxo compatível com `fail_silently`, use:
+
+```python
+result = message.send(fail_silently=True)
+if not result.accepted:
+    report(result.error)
+```
+
+`accepted=True` significa que o provedor aceitou a chamada, não que a
+mensagem chegou ao aparelho. Não há retry automático para evitar duplicatas
+após falhas ambíguas.
+
+A hierarquia pública inclui `ConfigurationError`, `MessageValidationError`,
+`ProviderNotInstalledError`, `ProviderError`, `InvalidWebhookSignature` e
+`InvalidWebhookPayload`, todos em `django_anysms.exceptions`.
+
+## Callback de entrega
+
+A aplicação controla sua própria URL e persistência. Exemplo de view:
+
+```python
+from django.http import HttpRequest, HttpResponse
+from django.views.decorators.csrf import csrf_exempt
+
+from django_anysms.exceptions import InvalidWebhookPayload, InvalidWebhookSignature
+from django_anysms.registry import get_provider
+
+
+@csrf_exempt
+def twilio_status(request: HttpRequest) -> HttpResponse:
+    provider = get_provider("twilio")
+    try:
+        event = provider.parse_webhook(
+            public_url=request.build_absolute_uri(),
+            form=request.POST,
+            signature=request.headers.get("X-Twilio-Signature"),
+        )
+    except InvalidWebhookSignature:
+        return HttpResponse(status=403)
+    except InvalidWebhookPayload:
+        return HttpResponse(status=400)
+
+    consume_delivery_event(event)
+    return HttpResponse(status=204)
+```
+
+Em ambientes com proxy, `public_url` precisa ser exatamente a URL pública
+assinada pela Twilio. A biblioteca valida a assinatura antes de projetar o
+payload.
+
+`DeliveryEvent.raw` preserva o formulário decodificado completo, inclusive
+campos desconhecidos e valores repetidos. Tanto ele quanto `SendResult.raw`
+podem conter telefones e outros dados pessoais; não registre ou persista esses
+mappings sem uma política adequada.
+
+Callbacks podem chegar fora de ordem. A v0.1 não persiste, deduplica ou ordena
+eventos, e o status inicial existe apenas em `SendResult`.
+
+## Brasil
+
+Regras de sender, horário, operadora e delivery report mudam fora do ciclo de
+release da biblioteca. Consulte regularmente as
+[diretrizes oficiais da Twilio para SMS no Brasil](https://www.twilio.com/en-us/guidelines/br/sms).
+
+## Fora da v0.1
+
+Mensagens recebidas, MMS/mídia, lotes, agendamento, models, views prontas,
+signals, async/Celery, retries, fallback entre provedores, normalização de
+números e gerenciamento de templates não fazem parte desta versão.
+
+O design completo está em
+[`docs/superpowers/specs/2026-08-15-django-anysms-v01-design.md`](docs/superpowers/specs/2026-08-15-django-anysms-v01-design.md).
+
+## Releases
+
+O projeto usa [Release Please](https://github.com/googleapis/release-please)
+com Conventional Commits. Pushes em `main` atualizam uma Release PR; ao
+mesclá-la, o mesmo workflow cria a tag e a GitHub Release, constrói sdist e
+wheel com Hatchling e publica no PyPI via Trusted Publisher (OIDC). Releases
+criadas manualmente no GitHub não são publicadas.
+
+Antes do primeiro release:
+
+1. Em **Settings > Actions > General > Workflow permissions**, habilite
+   **Allow GitHub Actions to create and approve pull requests**.
+2. Crie o environment `pypi` em **Settings > Environments**. Proteções e
+   aprovação manual são opcionais.
+3. No PyPI, configure um
+   [Trusted Publisher](https://docs.pypi.org/trusted-publishers/adding-a-publisher/)
+   — ou um pending publisher para o primeiro upload — com estes valores:
+
+   - Owner: `davisilvarafacho`
+   - Repository: `django-anysms`
+   - Workflow: `release.yml`
+   - Environment: `pypi`
+
+O workflow não usa `PYPI_API_TOKEN`. A primeira Release PR publica `v0.1.0`;
+as próximas versões são calculadas a partir dos commits `feat`, `fix` e
+mudanças incompatíveis.

django_anysms-0.1.0/README.md

@@ -0,0 +1,218 @@
+# django-anysms
+
+Envio de SMS e WhatsApp com uma API Django consistente e provedores
+intercambiáveis. A versão 0.1 inclui Twilio, mensagens síncronas e parsing
+validado de callbacks de entrega.
+
+## Instalação
+
+```bash
+python -m pip install django-anysms
+python -m pip install 'django-anysms[twilio]'
+```
+
+A v0.1 suporta Python 3.10–3.13, Django 5.2 LTS e Django 6.0. O SDK da
+Twilio é opcional e não é importado pelo core.
+
+## Configuração
+
+Configure aliases em suas settings Django:
+
+```python
+import os
+
+ANYSMS = {
+    "DEFAULT": "twilio",
+    "PROVIDERS": {
+        "twilio": {
+            "CLASS": "django_anysms.providers.twilio.TwilioProvider",
+            "OPTIONS": {
+                "account_sid": os.environ["TWILIO_ACCOUNT_SID"],
+                "auth_token": os.environ["TWILIO_AUTH_TOKEN"],
+                "from_": "+5511999999999",
+            },
+        },
+    },
+}
+```
+
+O pacote não precisa ser adicionado a `INSTALLED_APPS`.
+
+## SMS
+
+```python
+from django_anysms import SMSMessage
+
+result = SMSMessage(
+    to="+5511888888888",
+    body="Seu código é 123456",
+    status_callback="https://example.com/webhooks/twilio/status/",
+).send()
+
+print(result.message_id, result.status)
+```
+
+Cada mensagem possui exatamente um destinatário em formato E.164. Números
+nacionais não são corrigidos ou completados automaticamente.
+
+Um recurso específico pode ser informado sem contaminar a API comum:
+
+```python
+message = SMSMessage(
+    to="+5511888888888",
+    body="Olá",
+    provider_options={
+        "twilio": {"messaging_service_sid": "MG..."},
+    },
+)
+message.send(using="twilio")
+```
+
+## WhatsApp
+
+Texto livre dentro de uma conversa permitida pelo WhatsApp:
+
+```python
+from django_anysms import WhatsAppMessage
+
+WhatsAppMessage(
+    to="+5511888888888",
+    body="Seu pedido saiu para entrega.",
+).send()
+```
+
+Mensagem proativa com um Content Template aprovado:
+
+```python
+WhatsAppMessage(
+    to="+5511888888888",
+    content_sid="HX0123456789abcdef0123456789abcdef",
+    variables={"1": "Rafael", "2": "15/08/2026"},
+).send()
+```
+
+`body` e `content_sid` são mutuamente exclusivos. O provider adiciona o
+prefixo `whatsapp:`; a API pública recebe somente E.164.
+
+## Provider explícito
+
+Settings são opcionais quando a aplicação precisa de credenciais dinâmicas:
+
+```python
+from django_anysms import SMSMessage
+from django_anysms.providers.twilio import TwilioProvider
+
+provider = TwilioProvider(
+    account_sid="AC...",
+    auth_token="...",
+    from_="+5511999999999",
+)
+
+result = SMSMessage(to="+5511888888888", body="Olá").send(provider=provider)
+```
+
+A prioridade é: instância em `provider=`, alias em `using=` e, por último,
+`ANYSMS["DEFAULT"]`. `provider` e `using` não podem ser usados juntos.
+
+## Erros
+
+Falhas esperadas herdam de `AnySMSError`. Por padrão elas são lançadas. Para
+um fluxo compatível com `fail_silently`, use:
+
+```python
+result = message.send(fail_silently=True)
+if not result.accepted:
+    report(result.error)
+```
+
+`accepted=True` significa que o provedor aceitou a chamada, não que a
+mensagem chegou ao aparelho. Não há retry automático para evitar duplicatas
+após falhas ambíguas.
+
+A hierarquia pública inclui `ConfigurationError`, `MessageValidationError`,
+`ProviderNotInstalledError`, `ProviderError`, `InvalidWebhookSignature` e
+`InvalidWebhookPayload`, todos em `django_anysms.exceptions`.
+
+## Callback de entrega
+
+A aplicação controla sua própria URL e persistência. Exemplo de view:
+
+```python
+from django.http import HttpRequest, HttpResponse
+from django.views.decorators.csrf import csrf_exempt
+
+from django_anysms.exceptions import InvalidWebhookPayload, InvalidWebhookSignature
+from django_anysms.registry import get_provider
+
+
+@csrf_exempt
+def twilio_status(request: HttpRequest) -> HttpResponse:
+    provider = get_provider("twilio")
+    try:
+        event = provider.parse_webhook(
+            public_url=request.build_absolute_uri(),
+            form=request.POST,
+            signature=request.headers.get("X-Twilio-Signature"),
+        )
+    except InvalidWebhookSignature:
+        return HttpResponse(status=403)
+    except InvalidWebhookPayload:
+        return HttpResponse(status=400)
+
+    consume_delivery_event(event)
+    return HttpResponse(status=204)
+```
+
+Em ambientes com proxy, `public_url` precisa ser exatamente a URL pública
+assinada pela Twilio. A biblioteca valida a assinatura antes de projetar o
+payload.
+
+`DeliveryEvent.raw` preserva o formulário decodificado completo, inclusive
+campos desconhecidos e valores repetidos. Tanto ele quanto `SendResult.raw`
+podem conter telefones e outros dados pessoais; não registre ou persista esses
+mappings sem uma política adequada.
+
+Callbacks podem chegar fora de ordem. A v0.1 não persiste, deduplica ou ordena
+eventos, e o status inicial existe apenas em `SendResult`.
+
+## Brasil
+
+Regras de sender, horário, operadora e delivery report mudam fora do ciclo de
+release da biblioteca. Consulte regularmente as
+[diretrizes oficiais da Twilio para SMS no Brasil](https://www.twilio.com/en-us/guidelines/br/sms).
+
+## Fora da v0.1
+
+Mensagens recebidas, MMS/mídia, lotes, agendamento, models, views prontas,
+signals, async/Celery, retries, fallback entre provedores, normalização de
+números e gerenciamento de templates não fazem parte desta versão.
+
+O design completo está em
+[`docs/superpowers/specs/2026-08-15-django-anysms-v01-design.md`](docs/superpowers/specs/2026-08-15-django-anysms-v01-design.md).
+
+## Releases
+
+O projeto usa [Release Please](https://github.com/googleapis/release-please)
+com Conventional Commits. Pushes em `main` atualizam uma Release PR; ao
+mesclá-la, o mesmo workflow cria a tag e a GitHub Release, constrói sdist e
+wheel com Hatchling e publica no PyPI via Trusted Publisher (OIDC). Releases
+criadas manualmente no GitHub não são publicadas.
+
+Antes do primeiro release:
+
+1. Em **Settings > Actions > General > Workflow permissions**, habilite
+   **Allow GitHub Actions to create and approve pull requests**.
+2. Crie o environment `pypi` em **Settings > Environments**. Proteções e
+   aprovação manual são opcionais.
+3. No PyPI, configure um
+   [Trusted Publisher](https://docs.pypi.org/trusted-publishers/adding-a-publisher/)
+   — ou um pending publisher para o primeiro upload — com estes valores:
+
+   - Owner: `davisilvarafacho`
+   - Repository: `django-anysms`
+   - Workflow: `release.yml`
+   - Environment: `pypi`
+
+O workflow não usa `PYPI_API_TOKEN`. A primeira Release PR publica `v0.1.0`;
+as próximas versões são calculadas a partir dos commits `feat`, `fix` e
+mudanças incompatíveis.

django_anysms-0.1.0/django_anysms/__init__.py

@@ -0,0 +1,17 @@
+from .events import Channel, DeliveryEvent, MessageStatus
+from .exceptions import AnySMSError
+from .messages import SMSMessage, WhatsAppMessage
+from .results import SendResult
+
+__version__ = "0.1.0"
+
+__all__ = [
+    "AnySMSError",
+    "Channel",
+    "DeliveryEvent",
+    "MessageStatus",
+    "SMSMessage",
+    "SendResult",
+    "WhatsAppMessage",
+    "__version__",
+]

django_anysms-0.1.0/django_anysms/base.py

@@ -0,0 +1,35 @@
+from abc import ABC, abstractmethod
+from collections.abc import Iterator
+from typing import TYPE_CHECKING, Protocol
+
+if TYPE_CHECKING:
+    from .events import DeliveryEvent
+    from .messages import SMSMessage, WhatsAppMessage
+    from .results import SendResult
+
+
+class MultiValueForm(Protocol):
+    def __iter__(self) -> Iterator[str]: ...
+
+    def getlist(self, key: str) -> list[str]: ...
+
+    def get(self, key: str, default: str | None = None) -> str | None: ...
+
+
+class BaseProvider(ABC):
+    name: str
+
+    @abstractmethod
+    def send_sms(self, message: "SMSMessage") -> "SendResult": ...
+
+    @abstractmethod
+    def send_whatsapp(self, message: "WhatsAppMessage") -> "SendResult": ...
+
+    @abstractmethod
+    def parse_webhook(
+        self,
+        *,
+        public_url: str,
+        form: MultiValueForm,
+        signature: str | None,
+    ) -> "DeliveryEvent": ...