Add Mailpit email transport

2026-08-17 16:35:14 -04:00
parent 67ab6b78bd
commit 1853eaa963
23 changed files with 567 additions and 148 deletions
@@ -0,0 +1,16 @@
+# @beenvoice/email
+
+Server-only email transport shared by Beenvoice delivery paths.
+
+- `EMAIL_PROVIDER=mailpit` uses local SMTP and is rejected in production.
+- `EMAIL_PROVIDER=smtp` uses any configured SMTP-compatible provider.
+- `EMAIL_PROVIDER=resend` uses the Resend HTTP API and supports idempotency keys.
+
+Local development defaults to Mailpit at `127.0.0.1:1028`; its web UI is at
+`http://localhost:8028`. Start it with the web development dependencies and send
+a representative message with a PDF attachment:
+
+```bash
+bun run --filter @beenvoice/web docker:up
+bun run email:preview
+```