dex-connector-resend 0.1.0__tar.gz

dex_connector_resend-0.1.0/.gitignore

@@ -0,0 +1,6 @@
+/.dex-local/dexcli
+/.dex-local/dex-server-zd
+/.dex-local/data/
+/.dex-local/cli.log
+/.dex-local/visualize.json
+/.dex-local/visualize.err

dex_connector_resend-0.1.0/PKG-INFO

@@ -0,0 +1,50 @@
+Metadata-Version: 2.5
+Name: dex-connector-resend
+Version: 0.1.0
+Summary: Resend connector for Dex Flows
+License-Expression: MIT
+Requires-Python: >=3.11
+Requires-Dist: dex-connectors-sdk==0.1.0
+Requires-Dist: dex-python-sdk>=1.28.0
+Requires-Dist: httpx>=0.27
+Description-Content-Type: text/markdown
+
+# Resend connector for Python
+
+Install with `pip install dex-connector-resend==0.1.0`. The package requires
+`dex-connectors-sdk==0.1.0` and `dex-python-sdk>=1.28.0`, and implements the
+manifest operations `sendEmail` (Mutation) and `getEmail` (Query) with the same
+branches, defaults, and failure classification as the Go module.
+
+## Operations
+
+| Operation | Factory | Happy branch | Optional branches |
+| --- | --- | --- | --- |
+| `sendEmail` | `new_send_email_step` | `sent` | `providerRejected`, `invalidResponse`, `defect` |
+| `getEmail` | `new_get_email_step` | `found` | `notFound`, `providerRejected`, `invalidResponse`, `defect` |
+
+`sendEmail` sends the stable Dex call ID in `Idempotency-Key`. Resend keeps
+keys for 24 hours; the default one-hour retry budget stays within that window,
+so keep any per-Step retry override shorter than 24 hours. A 409
+`concurrent_idempotent_requests` retries with the same key, while
+`invalid_idempotent_request` selects `providerRejected`. 408, 429, 5xx, and
+transport failures retry; other 4xx responses select `providerRejected`.
+
+## Authorization
+
+Create a Dex Web connection named `resend` as described in the
+[connector README](../README.md#authorization). The API key travels only in the
+`Authorization` header and is resolved anew for every attempt.
+
+## Example
+
+[`examples/welcome_email`](examples/welcome_email/flow.py) checks the request,
+sends it with `new_send_email_step`, and records the Resend email ID. Run the
+Worker with `uv run python -m examples.welcome_email.worker` after
+`dexcli dev` has loaded a project containing the `resend` connection.
+
+## Tests
+
+`resendmock.Mock` scripts both operations and defaults to the manifest mock
+answers. Run `uv run pytest tests` for provider parity and manifest contract
+checks.

dex_connector_resend-0.1.0/README.md

@@ -0,0 +1,39 @@
+# Resend connector for Python
+
+Install with `pip install dex-connector-resend==0.1.0`. The package requires
+`dex-connectors-sdk==0.1.0` and `dex-python-sdk>=1.28.0`, and implements the
+manifest operations `sendEmail` (Mutation) and `getEmail` (Query) with the same
+branches, defaults, and failure classification as the Go module.
+
+## Operations
+
+| Operation | Factory | Happy branch | Optional branches |
+| --- | --- | --- | --- |
+| `sendEmail` | `new_send_email_step` | `sent` | `providerRejected`, `invalidResponse`, `defect` |
+| `getEmail` | `new_get_email_step` | `found` | `notFound`, `providerRejected`, `invalidResponse`, `defect` |
+
+`sendEmail` sends the stable Dex call ID in `Idempotency-Key`. Resend keeps
+keys for 24 hours; the default one-hour retry budget stays within that window,
+so keep any per-Step retry override shorter than 24 hours. A 409
+`concurrent_idempotent_requests` retries with the same key, while
+`invalid_idempotent_request` selects `providerRejected`. 408, 429, 5xx, and
+transport failures retry; other 4xx responses select `providerRejected`.
+
+## Authorization
+
+Create a Dex Web connection named `resend` as described in the
+[connector README](../README.md#authorization). The API key travels only in the
+`Authorization` header and is resolved anew for every attempt.
+
+## Example
+
+[`examples/welcome_email`](examples/welcome_email/flow.py) checks the request,
+sends it with `new_send_email_step`, and records the Resend email ID. Run the
+Worker with `uv run python -m examples.welcome_email.worker` after
+`dexcli dev` has loaded a project containing the `resend` connection.
+
+## Tests
+
+`resendmock.Mock` scripts both operations and defaults to the manifest mock
+answers. Run `uv run pytest tests` for provider parity and manifest contract
+checks.

dex_connector_resend-0.1.0/examples/welcome_email/__init__.py

@@ -0,0 +1,3 @@
+# Copyright (c) 2026 Super Durable
+# SPDX-License-Identifier: MIT
+"""Resend welcome email example Flow."""

dex_connector_resend-0.1.0/examples/welcome_email/flow.py

@@ -0,0 +1,88 @@
+# Copyright (c) 2026 Super Durable
+# SPDX-License-Identifier: MIT
+"""Runnable welcome email Flow using the Resend sendEmail Mutation."""
+
+from dataclasses import dataclass, field
+
+import dex
+from dex_connectors.sdk import MutationResult
+
+from dex_connectors.resend import Connection, SendEmailInput, SentEmail, new_send_email_step
+
+FLOW_TYPE = "ResendWelcomeEmail"
+CONNECTION_NAME = "resend"
+_SEND_STEP_TYPE = "SendEmail"
+_OUTCOME = dex.Attribute("resend-welcome-email-outcome", SentEmail)
+
+
+@dataclass(frozen=True, slots=True)
+class WelcomeEmailRequest:
+    """Sender on a Resend-verified domain, recipients, subject, and HTML body."""
+
+    from_address: str = field(metadata={"dex_json_name": "from"})
+    to: tuple[str, ...]
+    subject: str
+    html: str
+
+
+def map_to_send_email_input(request: WelcomeEmailRequest) -> SendEmailInput:
+    """Send the request unchanged; Resend deduplicates retries by Call ID."""
+    return SendEmailInput(request.from_address, request.to, request.subject, request.html)
+
+
+# dex:group group-id:welcome-email group-label:"Welcome email"
+# dex:explanation text:"Check the welcome email fields before calling Resend."
+class _PrepareRequest(dex.Step[WelcomeEmailRequest]):
+    def get_step_type(self) -> str:
+        return "PrepareRequest"
+
+    def execute(self, context: dex.Context, input: WelcomeEmailRequest) -> dex.StepDecision:
+        if not input.from_address.strip() or not input.to or not input.subject.strip() or not input.html:
+            return dex.force_fail("from, to, subject, and html are required")
+        return dex.go_to(dex.StepRef(_SEND_STEP_TYPE), input)
+
+
+# dex:group group-id:welcome-email group-label:"Welcome email"
+# dex:explanation text:"Record the Resend email ID and complete the Flow."
+class _CompleteRequest(dex.Step[MutationResult[SentEmail]]):
+    def get_step_type(self) -> str:
+        return "CompleteRequest"
+
+    def execute(self, context: dex.Context, input: MutationResult[SentEmail]) -> dex.StepDecision:
+        _OUTCOME.set(context, input.value)
+        return dex.graceful_complete(input.value)
+
+
+class WelcomeEmailFlow(dex.Flow[WelcomeEmailRequest]):
+    """Send one welcome email through the static resend connection."""
+
+    def __init__(self, connection: Connection) -> None:
+        if connection.reference.name != CONNECTION_NAME:
+            raise ValueError("welcome email requires the static resend connection")
+        self._prepare = _PrepareRequest()
+        self._complete = _CompleteRequest()
+        self._send = new_send_email_step(
+            step_type=_SEND_STEP_TYPE,
+            step_input_type=WelcomeEmailRequest,
+            annotations={
+                "groupId": "resend",
+                "groupLabel": "Resend",
+                "explanation": "Send the welcome email through Resend.",
+            },
+            connection=connection,
+            connection_name=CONNECTION_NAME,
+            map_to_operation_input=map_to_send_email_input,
+            sent=self._complete,
+        )
+
+    def get_flow_type(self) -> str:
+        """Return the stable Flow identity used in Dex Web."""
+        return FLOW_TYPE
+
+    def get_steps(self) -> dex.StepList[WelcomeEmailRequest]:
+        """Register request check, provider send, and completion Steps."""
+        return dex.StepList.start_step(self._prepare).other_steps(self._send, self._complete)
+
+    def get_persistence_schema(self) -> dex.PersistenceSchema:
+        """Persist the Resend email identifier."""
+        return dex.PersistenceSchema.of(_OUTCOME)

dex_connector_resend-0.1.0/examples/welcome_email/worker.py

@@ -0,0 +1,51 @@
+# Copyright (c) 2026 Super Durable
+# SPDX-License-Identifier: MIT
+"""Worker entrypoint for the Resend welcome email Flow."""
+
+import asyncio
+import os
+import tempfile
+from pathlib import Path
+
+import dex
+from dex_connectors.sdk.projectconfig import load_from_environment
+
+from dex_connectors.resend import new_project_connection
+
+from .flow import CONNECTION_NAME, WelcomeEmailFlow
+
+
+async def run_worker() -> None:
+    """Load the named Dex Web connection and send welcome emails."""
+    project = await load_from_environment()
+    connection = None
+    cache = None
+    try:
+        connection = new_project_connection(project, CONNECTION_NAME)
+        registry = dex.Registry([WelcomeEmailFlow(connection)], allow_async_handlers=True)
+        cache_directory = os.environ.get(
+            "DEX_BLOB_CACHE_DIR", str(Path(tempfile.gettempdir()) / "dex-resend-welcome-email-blobs")
+        )
+        cache = dex.open_blob_cache(dex.BlobCacheConfig(cache_directory, 1 << 30))
+        worker = dex.AsyncWorker(
+            registry,
+            cache,
+            dex.WorkerOptions(server_address=os.environ.get("DEX_FLOW_SERVICE_ADDRESS", "localhost:8801")),
+        )
+        async with worker:
+            await worker.start()
+    finally:
+        if connection is not None:
+            await connection.aclose()
+        if cache is not None:
+            cache.close()
+        await project.close()
+
+
+def main() -> None:
+    """Run until the Worker stops or the process receives an interrupt."""
+    asyncio.run(run_worker())
+
+
+if __name__ == "__main__":
+    main()

dex_connector_resend-0.1.0/pyproject.toml

@@ -0,0 +1,37 @@
+[build-system]
+requires = ["hatchling>=1.27"]
+build-backend = "hatchling.build"
+
+[project]
+name = "dex-connector-resend"
+version = "0.1.0"
+description = "Resend connector for Dex Flows"
+readme = "README.md"
+requires-python = ">=3.11"
+license = "MIT"
+dependencies = ["dex-connectors-sdk==0.1.0", "dex-python-sdk>=1.28.0", "httpx>=0.27"]
+
+[dependency-groups]
+dev = ["pytest>=8", "pytest-asyncio>=0.24", "mypy>=1.13", "ruff>=0.7", "pyyaml>=6", "types-PyYAML>=6"]
+
+[tool.hatch.build.targets.wheel]
+packages = ["src/dex_connectors"]
+
+[tool.pytest.ini_options]
+testpaths = ["tests"]
+pythonpath = [".", "src"]
+asyncio_mode = "auto"
+asyncio_default_fixture_loop_scope = "function"
+
+[tool.mypy]
+python_version = "3.11"
+strict = true
+mypy_path = "src"
+explicit_package_bases = true
+
+[tool.ruff]
+target-version = "py311"
+line-length = 110
+
+[tool.ruff.lint]
+select = ["E", "F", "I", "UP", "B"]

dex_connector_resend-0.1.0/src/dex_connectors/resend/__init__.py

@@ -0,0 +1,50 @@
+# Copyright (c) 2026 Super Durable
+# SPDX-License-Identifier: MIT
+"""Resend email operations for Dex connector Steps."""
+
+from .client import (
+    CONNECTOR_ID,
+    DEFECT,
+    FOUND,
+    GET_EMAIL_DEFINITION,
+    INVALID_RESPONSE,
+    NOT_FOUND,
+    PROVIDER_REJECTED,
+    SEND_EMAIL_DEFINITION,
+    SENT,
+    Client,
+    Config,
+    Credentials,
+    GetEmailOperation,
+    SendEmailOperation,
+)
+from .connection import Connection, new_connection, new_connection_with_operations, new_project_connection
+from .models import Email, GetEmailInput, SendEmailInput, SentEmail
+from .steps import new_get_email_step, new_send_email_step
+
+__all__ = [
+    "Client",
+    "Config",
+    "Connection",
+    "Credentials",
+    "Email",
+    "GetEmailInput",
+    "GetEmailOperation",
+    "SendEmailInput",
+    "SendEmailOperation",
+    "SentEmail",
+    "new_connection",
+    "new_connection_with_operations",
+    "new_get_email_step",
+    "new_project_connection",
+    "new_send_email_step",
+    "CONNECTOR_ID",
+    "DEFECT",
+    "FOUND",
+    "GET_EMAIL_DEFINITION",
+    "INVALID_RESPONSE",
+    "NOT_FOUND",
+    "PROVIDER_REJECTED",
+    "SEND_EMAIL_DEFINITION",
+    "SENT",
+]