coffeemail 0.1.0__tar.gz

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

@@ -0,0 +1,42 @@
+name: CI
+
+on:
+  push:
+    branches: [main]
+  pull_request:
+    branches: [main]
+
+jobs:
+  validate:
+    name: Validate (lint + typecheck + test + build)
+    runs-on: ubuntu-latest
+
+    steps:
+      - uses: actions/checkout@v4
+
+      - name: Install uv
+        uses: astral-sh/setup-uv@v5
+        with:
+          version: "latest"
+          enable-cache: true
+
+      - name: Set up Python
+        run: uv python install 3.10
+
+      - name: Install dependencies
+        run: uv sync --extra dev
+
+      - name: Check formatting with Ruff
+        run: uv run ruff format --check .
+
+      - name: Lint with Ruff
+        run: uv run ruff check .
+
+      - name: Typecheck with Mypy
+        run: uv run mypy src tests
+
+      - name: Run Tests
+        run: uv run pytest -v
+
+      - name: Build distribution package
+        run: uv build

coffeemail-0.1.0/.github/workflows/publish.yml

@@ -0,0 +1,61 @@
+name: Publish to PyPI
+
+on:
+  push:
+    branches: [main]
+    tags:
+      - "v*"
+
+jobs:
+  validate-and-publish:
+    name: Build, verify and publish to PyPI
+    runs-on: ubuntu-latest
+    permissions:
+      contents: read
+      id-token: write # Necessário para Trusted Publishing (OIDC) no PyPI
+
+    steps:
+      - uses: actions/checkout@v4
+
+      - name: Install uv
+        uses: astral-sh/setup-uv@v5
+        with:
+          version: "latest"
+          enable-cache: true
+
+      - name: Set up Python
+        run: uv python install 3.10
+
+      - name: Install dependencies
+        run: uv sync --extra dev
+
+      - name: Code quality and tests
+        run: |
+          uv run ruff format --check .
+          uv run ruff check .
+          uv run mypy src tests
+          uv run pytest -v
+
+      - name: Check if current version is already on PyPI
+        id: check_version
+        run: |
+          VERSION=$(python3 -c "import tomllib; print(tomllib.load(open('pyproject.toml', 'rb'))['project']['version'])")
+          echo "Package version: $VERSION"
+          STATUS_CODE=$(curl -s -o /dev/null -w "%{http_code}" "https://pypi.org/pypi/coffeemail/$VERSION/json")
+          if [ "$STATUS_CODE" = "200" ]; then
+            echo "Version $VERSION is already published on PyPI. Skipping publication."
+            echo "should_publish=false" >> "$GITHUB_OUTPUT"
+          else
+            echo "New version $VERSION ready for publication."
+            echo "should_publish=true" >> "$GITHUB_OUTPUT"
+          fi
+
+      - name: Build distribution packages (wheel and sdist)
+        if: steps.check_version.outputs.should_publish == 'true'
+        run: uv build
+
+      - name: Publish to PyPI via Trusted Publishing
+        if: steps.check_version.outputs.should_publish == 'true'
+        uses: pypa/gh-action-pypi-publish@release/v1
+        with:
+          password: ${{ secrets.PYPI_API_TOKEN }}

coffeemail-0.1.0/.gitignore

@@ -0,0 +1,69 @@
+# Byte-compiled / optimized / DLL files
+__pycache__/
+*.py[cod]
+*$py.class
+
+# C extensions
+*.so
+
+# Distribution / packaging
+.Python
+build/
+develop-eggs/
+dist/
+downloads/
+eggs/
+.eggs/
+lib/
+lib64/
+parts/
+sdist/
+var/
+wheels/
+share/python-wheels/
+*.egg-info/
+.installed.cfg
+*.egg
+MANIFEST
+
+# Virtual environments
+.venv/
+env/
+venv/
+ENV/
+env.bak/
+venv.bak/
+
+# Testing and coverage
+.tox/
+.nox/
+.coverage
+.coverage.*
+.cache
+nosetests.xml
+coverage.xml
+*.cover
+*.py,cover
+.hypothesis/
+.pytest_cache/
+cover/
+
+# Type checking & Linters
+.mypy_cache/
+.dmypy.json
+dmypy.json
+.pyre/
+.pytype/
+.ruff_cache/
+
+# IDE & OS
+.DS_Store
+.idea/
+.vscode/
+*.sublime-project
+*.sublime-workspace
+
+# Environment variables
+.env
+.env.*
+!.env.example

coffeemail-0.1.0/PKG-INFO

@@ -0,0 +1,179 @@
+Metadata-Version: 2.5
+Name: coffeemail
+Version: 0.1.0
+Summary: SDK oficial do CoffeeMail para Python (Síncrono e Assíncrono com tipagem estrita).
+Project-URL: Homepage, https://coffeemail.com.br
+Project-URL: Documentation, https://docs.coffeemail.com.br
+Project-URL: Repository, https://github.com/coffeemail/coffee-mail-sdk-python
+Author-email: CoffeeMail Team <contato@coffeemail.com.br>
+License: MIT
+Keywords: api,coffeemail,email,sdk,transactional
+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.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Topic :: Communications :: Email
+Classifier: Typing :: Typed
+Requires-Python: >=3.10
+Requires-Dist: httpx>=0.27.0
+Requires-Dist: pydantic>=2.6.0
+Requires-Dist: typing-extensions>=4.10.0
+Provides-Extra: dev
+Requires-Dist: mypy>=1.9.0; extra == 'dev'
+Requires-Dist: pytest-asyncio>=0.23.0; extra == 'dev'
+Requires-Dist: pytest-mock>=3.12.0; extra == 'dev'
+Requires-Dist: pytest>=8.0.0; extra == 'dev'
+Requires-Dist: respx>=0.21.0; extra == 'dev'
+Requires-Dist: ruff>=0.3.0; extra == 'dev'
+Description-Content-Type: text/markdown
+
+# CoffeeMail Python SDK (`coffeemail`)
+
+SDK oficial da **CoffeeMail** para Python, com suporte nativo a operações **Síncronas** e **Assíncronas**, tipagem estrita via **Pydantic v2**, compatibilidade total com PEP 561 (`py.typed`) e padrão de retorno seguro `{ data, error }`.
+
+---
+
+## 📦 Instalação
+
+```bash
+pip install coffeemail
+# ou utilizando uv:
+uv add coffeemail
+# ou utilizando poetry:
+poetry add coffeemail
+```
+
+---
+
+## ⚡ Início Rápido
+
+### 1. Envio Transacional Síncrono (Django, Flask, Scripts)
+
+```python
+from coffeemail import CoffeeMail
+
+# Lê automaticamente a variável de ambiente COFFEEMAIL_API_KEY se omitida:
+client = CoffeeMail()
+
+data, error = client.emails.send(
+    {
+        "from": "contato@seudominio.com.br",
+        "to": "cliente@empresa.com",
+        "subject": "Boas-vindas ao CoffeeMail!",
+        "html": "<h1>Olá, seja bem-vindo!</h1>",
+    }
+)
+
+if error:
+    print(f"Erro ao disparar e-mail: {error.message}")
+else:
+    print(f"E-mail enfileirado com sucesso! ID: {data.id}")
+```
+
+### 2. Envio Assíncrono de Alta Performance (FastAPI, Celery, Temporal)
+
+```python
+import asyncio
+from coffeemail import AsyncCoffeeMail
+
+
+async def main():
+    client = AsyncCoffeeMail()
+
+    response = await client.emails.send(
+        {
+            "from": {"email": "notificacoes@seudominio.com.br", "name": "Notificações"},
+            "to": "destinatario@gmail.com",
+            "subject": "Sua fatura foi gerada",
+            "html": "<p>Acesse o painel para visualizar o boleto.</p>",
+        }
+    )
+
+    if response.error:
+        print(f"Falha: {response.error}")
+        return
+
+    print(f"Status do disparo: {response.data.status}")
+
+
+asyncio.run(main())
+```
+
+---
+
+## 🛡️ Padrão de Resposta Seguro e Ergonomia
+
+Todas as chamadas do SDK retornam uma instância de `CoffeeMailResponse[T]`. Você pode optar pelo estilo que melhor se adapta à sua equipe:
+
+### Desempacotamento de Tupla (Recomendado)
+```python
+data, error = client.emails.get("msg_123")
+if error:
+    print(f"Falha: {error}")
+else:
+    print(f"Status: {data.status}")
+```
+
+### Método `.unwrap()` (Lança Exceção em Caso de Erro)
+```python
+try:
+    email = client.emails.get("msg_123").unwrap()
+    print(f"Entregue em: {email.delivered_at}")
+except CoffeeMailError as err:
+    print(f"Exceção capturada: {err}")
+```
+
+---
+
+## 🧩 Recursos Disponíveis
+
+* **`emails`**: Disparo individual, em lote (`send_batch`), consulta de status, cancelamento de agendamentos e listagem de eventos.
+* **`domains`**: Criação de domínios e verificação de registros DNS (SPF, DKIM, DMARC, MX).
+* **`templates`**: Cadastro de modelos HTML, renderização de pré-visualização (`preview`) e envio de testes.
+* **`audiences`**: Listas de contatos, inclusão em lote (`bulk_add`) e gestão de inscritos.
+* **`broadcasts`**: Campanhas e envios em massa com agendamento.
+* **`suppressions`**: Consulta e gerenciamento de lista de supressão (bounces e unsubscribes).
+* **`webhooks`**: Gerenciamento de endpoints e validação criptográfica de assinaturas HMAC SHA-256.
+* **`stats`**: Consulta de taxas de entrega, abertura e rejeição por período.
+
+---
+
+## 🔒 Validação Criptográfica de Webhooks
+
+Proteja suas rotas contra requisições forjadas validando a assinatura enviada no header `x-coffeemail-signature`:
+
+```python
+from coffeemail import Webhooks
+
+is_valid = Webhooks.verify_signature(
+    payload=request_body_raw,
+    signature=headers.get("x-coffeemail-signature"),
+    secret="whsec_seu_segredo_cadastrado",
+)
+
+if not is_valid:
+    return {"error": "Assinatura inválida"}, 401
+```
+
+---
+
+## 🛠️ Desenvolvimento e Testes
+
+Para contribuir ou rodar os testes localmente:
+
+```bash
+# Instalar dependências de desenvolvimento com uv:
+uv sync --extra dev
+
+# Executar suíte de testes unitários:
+uv run pytest
+
+# Executar checagem estrita de tipos com mypy:
+uv run mypy src
+
+# Executar linter e formatação com ruff:
+uv run ruff check .
+```

coffeemail-0.1.0/README.md

@@ -0,0 +1,147 @@
+# CoffeeMail Python SDK (`coffeemail`)
+
+SDK oficial da **CoffeeMail** para Python, com suporte nativo a operações **Síncronas** e **Assíncronas**, tipagem estrita via **Pydantic v2**, compatibilidade total com PEP 561 (`py.typed`) e padrão de retorno seguro `{ data, error }`.
+
+---
+
+## 📦 Instalação
+
+```bash
+pip install coffeemail
+# ou utilizando uv:
+uv add coffeemail
+# ou utilizando poetry:
+poetry add coffeemail
+```
+
+---
+
+## ⚡ Início Rápido
+
+### 1. Envio Transacional Síncrono (Django, Flask, Scripts)
+
+```python
+from coffeemail import CoffeeMail
+
+# Lê automaticamente a variável de ambiente COFFEEMAIL_API_KEY se omitida:
+client = CoffeeMail()
+
+data, error = client.emails.send(
+    {
+        "from": "contato@seudominio.com.br",
+        "to": "cliente@empresa.com",
+        "subject": "Boas-vindas ao CoffeeMail!",
+        "html": "<h1>Olá, seja bem-vindo!</h1>",
+    }
+)
+
+if error:
+    print(f"Erro ao disparar e-mail: {error.message}")
+else:
+    print(f"E-mail enfileirado com sucesso! ID: {data.id}")
+```
+
+### 2. Envio Assíncrono de Alta Performance (FastAPI, Celery, Temporal)
+
+```python
+import asyncio
+from coffeemail import AsyncCoffeeMail
+
+
+async def main():
+    client = AsyncCoffeeMail()
+
+    response = await client.emails.send(
+        {
+            "from": {"email": "notificacoes@seudominio.com.br", "name": "Notificações"},
+            "to": "destinatario@gmail.com",
+            "subject": "Sua fatura foi gerada",
+            "html": "<p>Acesse o painel para visualizar o boleto.</p>",
+        }
+    )
+
+    if response.error:
+        print(f"Falha: {response.error}")
+        return
+
+    print(f"Status do disparo: {response.data.status}")
+
+
+asyncio.run(main())
+```
+
+---
+
+## 🛡️ Padrão de Resposta Seguro e Ergonomia
+
+Todas as chamadas do SDK retornam uma instância de `CoffeeMailResponse[T]`. Você pode optar pelo estilo que melhor se adapta à sua equipe:
+
+### Desempacotamento de Tupla (Recomendado)
+```python
+data, error = client.emails.get("msg_123")
+if error:
+    print(f"Falha: {error}")
+else:
+    print(f"Status: {data.status}")
+```
+
+### Método `.unwrap()` (Lança Exceção em Caso de Erro)
+```python
+try:
+    email = client.emails.get("msg_123").unwrap()
+    print(f"Entregue em: {email.delivered_at}")
+except CoffeeMailError as err:
+    print(f"Exceção capturada: {err}")
+```
+
+---
+
+## 🧩 Recursos Disponíveis
+
+* **`emails`**: Disparo individual, em lote (`send_batch`), consulta de status, cancelamento de agendamentos e listagem de eventos.
+* **`domains`**: Criação de domínios e verificação de registros DNS (SPF, DKIM, DMARC, MX).
+* **`templates`**: Cadastro de modelos HTML, renderização de pré-visualização (`preview`) e envio de testes.
+* **`audiences`**: Listas de contatos, inclusão em lote (`bulk_add`) e gestão de inscritos.
+* **`broadcasts`**: Campanhas e envios em massa com agendamento.
+* **`suppressions`**: Consulta e gerenciamento de lista de supressão (bounces e unsubscribes).
+* **`webhooks`**: Gerenciamento de endpoints e validação criptográfica de assinaturas HMAC SHA-256.
+* **`stats`**: Consulta de taxas de entrega, abertura e rejeição por período.
+
+---
+
+## 🔒 Validação Criptográfica de Webhooks
+
+Proteja suas rotas contra requisições forjadas validando a assinatura enviada no header `x-coffeemail-signature`:
+
+```python
+from coffeemail import Webhooks
+
+is_valid = Webhooks.verify_signature(
+    payload=request_body_raw,
+    signature=headers.get("x-coffeemail-signature"),
+    secret="whsec_seu_segredo_cadastrado",
+)
+
+if not is_valid:
+    return {"error": "Assinatura inválida"}, 401
+```
+
+---
+
+## 🛠️ Desenvolvimento e Testes
+
+Para contribuir ou rodar os testes localmente:
+
+```bash
+# Instalar dependências de desenvolvimento com uv:
+uv sync --extra dev
+
+# Executar suíte de testes unitários:
+uv run pytest
+
+# Executar checagem estrita de tipos com mypy:
+uv run mypy src
+
+# Executar linter e formatação com ruff:
+uv run ruff check .
+```

coffeemail-0.1.0/pyproject.toml

@@ -0,0 +1,97 @@
+[build-system]
+requires = ["hatchling"]
+build-backend = "hatchling.build"
+
+[project]
+name = "coffeemail"
+version = "0.1.0"
+description = "SDK oficial do CoffeeMail para Python (Síncrono e Assíncrono com tipagem estrita)."
+readme = "README.md"
+license = { text = "MIT" }
+requires-python = ">=3.10"
+authors = [
+    { name = "CoffeeMail Team", email = "contato@coffeemail.com.br" },
+]
+keywords = ["email", "transactional", "coffeemail", "sdk", "api"]
+classifiers = [
+    "Development Status :: 4 - Beta",
+    "Intended Audience :: Developers",
+    "License :: OSI Approved :: MIT License",
+    "Programming Language :: Python :: 3",
+    "Programming Language :: Python :: 3.10",
+    "Programming Language :: Python :: 3.11",
+    "Programming Language :: Python :: 3.12",
+    "Topic :: Communications :: Email",
+    "Typing :: Typed",
+]
+dependencies = [
+    "httpx>=0.27.0",
+    "pydantic>=2.6.0",
+    "typing-extensions>=4.10.0",
+]
+
+[project.optional-dependencies]
+dev = [
+    "mypy>=1.9.0",
+    "pytest>=8.0.0",
+    "pytest-asyncio>=0.23.0",
+    "pytest-mock>=3.12.0",
+    "respx>=0.21.0",
+    "ruff>=0.3.0",
+]
+
+[project.urls]
+Homepage = "https://coffeemail.com.br"
+Documentation = "https://docs.coffeemail.com.br"
+Repository = "https://github.com/coffeemail/coffee-mail-sdk-python"
+
+[tool.hatch.build.targets.wheel]
+packages = ["src/coffeemail"]
+
+[tool.ruff]
+line-length = 100
+target-version = "py310"
+
+[tool.ruff.lint]
+select = [
+    "E",   # pycodestyle errors
+    "W",   # pycodestyle warnings
+    "F",   # pyflakes
+    "I",   # isort
+    "B",   # flake8-bugbear
+    "C4",  # flake8-comprehensions
+    "UP",  # pyupgrade
+    "ARG", # flake8-unused-arguments
+    "SIM", # flake8-simplify
+    "TCH", # flake8-type-checking
+]
+ignore = ["E501"]
+
+[tool.ruff.lint.isort]
+known-first-party = ["coffeemail"]
+
+[tool.mypy]
+plugins = ["pydantic.mypy"]
+python_version = "3.10"
+strict = true
+warn_return_any = true
+warn_unused_configs = true
+disallow_untyped_defs = true
+disallow_incomplete_defs = true
+check_untyped_defs = true
+disallow_untyped_decorators = true
+no_implicit_optional = true
+warn_redundant_casts = true
+warn_unused_ignores = true
+warn_no_return = true
+
+[tool.pydantic-mypy]
+init_forbid_extra = true
+init_typed = true
+warn_required_dynamic_aliases = true
+
+[tool.pytest.ini_options]
+minversion = "8.0"
+addopts = "-ra -q --strict-markers"
+testpaths = ["tests"]
+asyncio_mode = "auto"

coffeemail-0.1.0/specs/SDD_ROADMAP.md

@@ -0,0 +1,98 @@
+# Planejamento de Implementação SDD: CoffeeMail Python SDK
+
+Este documento estabelece o cronograma de entrega baseado em **Spec-Driven Development (SDD)**, com critérios de aceite, etapas de validação e integração ao **CoffeeMail SDK Workbench**.
+
+---
+
+## 🎯 Metodologia de Trabalho
+
+Cada fase segue o ciclo rigoroso de SDD:
+1. **Especificação do Contrato**: Validação de parâmetros, tipos Pydantic e assinaturas públicas.
+2. **Testes Unitários / Mock First**: Escrita dos testes com `pytest` e `respx` simulando respostas da API antes da implementação final.
+3. **Implementação da Lógica**: Desenvolvimento com Clean Code e SOLID, sem complexidade acidental.
+4. **Verificação Estrita**: Execução do linter `ruff` e do type checker `mypy --strict`.
+5. **Homologação no Workbench**: Conexão com o `runner-python` na porta 4002 para auditoria na interface visual.
+
+---
+
+## 📋 Fases do Roadmap
+
+### **Fase 1: Fundação do Core, Tipos e Clientes Base**
+* **Objetivo**: Estruturar transporte HTTP resiliente (síncrono e assíncrono), envelope de resposta e autenticação.
+* **Tarefas**:
+  - Implementar hierarquia de exceções em `coffeemail.core.errors`.
+  - Implementar envelope `CoffeeMailResponse[T]` com suporte a desempacotamento de tupla e `.unwrap()`.
+  - Implementar camada HTTP com `httpx.Client` e `httpx.AsyncClient` em `coffeemail.core.http`.
+  - Implementar cliente principal `CoffeeMail` e `AsyncCoffeeMail`.
+  - Implementar introspecção de chave `client.introspect()`.
+* **Critérios de Aceite**:
+  - Testes passando com 100% de cobertura para validação de chave nula/inválida.
+  - Headers corretos (`User-Agent: coffeemail-python/0.1.0`, `Authorization`, `Accept-Language`).
+
+---
+
+### **Fase 2: Módulo de E-mails Transacionais (`emails`)**
+* **Objetivo**: Implementar o principal recurso do SDK, cobrindo envios simples, em lote, consultas e eventos.
+* **Tarefas**:
+  - Modelar DTOs Pydantic v2: `SendEmailPayload`, `SendEmailResponse`, `EmailDetail`, `BatchSendEmailResult`, etc.
+  - Implementar normalização de destinatários: aceitar string (`"user@dominio.com"`), dicionário (`{"name": "...", "email": "..."}`) ou listas de ambos.
+  - Implementar suporte a anexos: aceitar string base64, bytes brutos ou caminho de arquivo local (`pathlib.Path` / `str`).
+  - Implementar métodos: `send`, `send_batch`, `get`, `list`, `cancel`, `get_events`, `list_tags`.
+* **Critérios de Aceite**:
+  - Mapeamento correto de `snake_case` para o payload `camelCase` esperado pela API CoffeeMail.
+  - Testes unitários com `respx` simulando requisições com múltiplos anexos e parâmetros de agendamento.
+
+---
+
+### **Fase 3: Módulos de Domínios (`domains`) e Webhooks (`webhooks`)**
+* **Objetivo**: Configuração de remetentes autorizados e recebimento seguro de eventos.
+* **Tarefas**:
+  - Implementar métodos de domínios: `list`, `get`, `create`, `verify`, `get_health`, `delete`.
+  - Implementar verificação de registros DNS (SPF, DKIM, DMARC, MX).
+  - Implementar gestão de endpoints de Webhook: `list`, `get`, `create`, `update`, `toggle`, `rotate_secret`, `test`, `list_deliveries`.
+  - Implementar utilitário criptográfico `webhooks.verify_signature` com verificação de timestamp e tolerância a drift de relógio.
+* **Critérios de Aceite**:
+  - Testes unitários comprovando rejeição de assinaturas HMAC inválidas ou com timestamp expirado.
+
+---
+
+### **Fase 4: Modelos (`templates`) e Pré-visualização**
+* **Objetivo**: Gestão de templates HTML e renderização de prévias.
+* **Tarefas**:
+  - Implementar métodos: `list`, `get`, `create`, `update`, `delete`.
+  - Implementar `preview` suportando tanto ID de modelo existente quanto código HTML bruto com variáveis de substituição.
+  - Implementar `test_send` para envio de prova.
+* **Critérios de Aceite**:
+  - Retorno consistente com envelopamento `{ templates: [...] }`.
+
+---
+
+### **Fase 5: Audiências (`audiences`), Contatos (`contacts`) e Campanhas (`broadcasts`)**
+* **Objetivo**: Gerenciamento de listas de e-mail e envios em massa.
+* **Tarefas**:
+  - Implementar gestão de audiências e contatos aninhados (`audiences.contacts`).
+  - Adicionar atalhos ergonômicos no topo de `audiences` (`list_contacts`, `create_contact`, `bulk_add_contacts`).
+  - Implementar módulo de campanhas `broadcasts` (`list`, `get`, `create`, `send`, `cancel`, `delete`).
+* **Critérios de Aceite**:
+  - Tipagem completa de atributos personalizados de contatos (`attributes: dict[str, Any]`).
+
+---
+
+### **Fase 6: Supressões (`suppressions`) e Estatísticas (`stats`)**
+* **Objetivo**: Controle de reputação de remetente e visualização analítica.
+* **Tarefas**:
+  - Implementar `suppressions` para consulta e exclusão de bounces/unsubscribes.
+  - Implementar `stats` para recuperação de taxas de abertura, entrega e rejeição por período.
+* **Critérios de Aceite**:
+  - Validação de formatação de datas ISO 8601 nos filtros de estatísticas.
+
+---
+
+### **Fase 7: Integração com o Workbench e Runner Python**
+* **Objetivo**: Criar o backend `coffee-mail-sdk-workbench/backends/runner-python` consumindo o pacote local.
+* **Tarefas**:
+  - Criar mini-backend em FastAPI ou Flask na porta 4002 implementando a Runner Specification API.
+  - Habilitar o seletor "Python Runner" no front-end web do Workbench.
+  - Executar bateria completa de testes de ponta a ponta na interface visual.
+* **Critérios de Aceite**:
+  - 100% dos botões e formulários do Workbench funcionando igualmente no Runner Node e no Runner Python.