Metadata-Version: 2.4
Name: mailifica
Version: 1.0.0
Summary: Official Python SDK for Mailifica Email Infrastructure
Home-page: https://github.com/mailifica/mailifica-python
Author: Mailifica
Author-email: Mailifica <team@mailifica.com>
License: MIT
Project-URL: Homepage, https://mailifica.com
Project-URL: Documentation, https://mailifica.com/docs
Project-URL: Repository, https://github.com/mailifica/mailifica-python
Project-URL: Bug Tracker, https://github.com/mailifica/mailifica-python/issues
Keywords: email,transactional-email,mailifica,sdk,api
Classifier: Development Status :: 5 - Production/Stable
Classifier: Intended Audience :: Developers
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: Operating System :: OS Independent
Requires-Python: >=3.8
Description-Content-Type: text/markdown
License-File: LICENSE
Requires-Dist: requests>=2.28.0
Requires-Dist: typing-extensions>=4.0.0; python_version < "3.10"
Dynamic: author
Dynamic: home-page
Dynamic: license-file
Dynamic: requires-python

# Mailifica Python SDK (`mailifica`)

> SDK oficial em Python para a infraestrutura de e-mails transacionais **Mailifica**, com interface drop-in replacement compatível com o Resend.

---

## 📦 Instalação

```bash
pip install mailifica
# ou com Poetry
poetry add mailifica
```

---

## 🚀 Como Usar

### 1. Envio Estático (Estilo Resend)

```python
import mailifica

# Configurar API Key
mailifica.api_key = "ma_live_123456789"

params: mailifica.Emails.SendParams = {
    "from": "onboarding@suaempresa.ao",
    "to": ["cliente@gmail.com"],
    "subject": "Boas-vindas!",
    "html": "<h1>Olá!</h1><p>Seu e-mail transacional foi entregue.</p>",
}

email = mailifica.Emails.send(params)
print("E-mail ID:", email["id"])
```

### 2. Envio Orientado a Objetos / Instância

```python
from mailifica import Mailifica

client = Mailifica("ma_live_123456789")

response = client.emails.send({
    "from": "suporte@suaempresa.ao",
    "to": "usuario@empresa.com",
    "subject": "Notificação",
    "text": "Seu chamado foi atualizado.",
})
```

### 3. Envio em Lote (Batch)

```python
import mailifica

mailifica.api_key = "ma_live_123456789"

batch_response = mailifica.Batch.send([
    {
        "from": "novidades@suaempresa.ao",
        "to": "cliente1@gmail.com",
        "subject": "Atualização Mensal",
        "html": "<p>Novidades do mês</p>",
    },
    {
        "from": "novidades@suaempresa.ao",
        "to": "cliente2@gmail.com",
        "subject": "Atualização Mensal",
        "html": "<p>Novidades do mês</p>",
    }
])
```

### 4. Gestão de Domínios & API Keys

```python
import mailifica

# Criar domínio
domain = mailifica.Domains.create({"name": "meudominio.ao"})

# Verificar registros DNS
verified = mailifica.Domains.verify(domain["id"])

# Listar API Keys
keys = mailifica.ApiKeys.list()
```

### 5. Validação de Webhooks HMAC

```python
from mailifica import Webhooks

is_valid = Webhooks.verify_signature(
    payload=raw_body,
    signature=headers.get("mailifica-signature"),
    secret="seu_webhook_secret"
)
```

---

## 📄 Licença

MIT © [Mailifica](https://mailifica.com)
