@zintrust/cloudflare-email-proxy 2.1.3

package/README.md

@@ -0,0 +1,65 @@
+# @zintrust/cloudflare-email-proxy
+
+Cloudflare Worker service that exposes a small HTTPS API for Cloudflare Email Routing sends.
+
+Docs: https://zintrust.com/mail
+
+This is intended for server-to-server use when a ZinTrust app runs outside Cloudflare Workers but still wants to use the built-in `MAIL_DRIVER=cl` or `MAIL_DRIVER=cloudflare` path.
+
+## Endpoint
+
+All requests are `POST` and require signed request headers.
+
+- `/zin/mail/cloudflare/send` → `{ binding?, message }` → `{ ok: true, messageId? }`
+
+## Required bindings
+
+- `SEND_EMAIL` send_email binding
+
+If your binding name is not `SEND_EMAIL`, set Worker var `MAIL_CLOUDFLARE_BINDING` or pass `binding` in the signed payload.
+
+Optional but recommended:
+
+- `ZT_NONCES` KV binding for replay protection
+
+## Required secrets / vars
+
+Secret:
+
+- `MAIL_CLOUDFLARE_PROXY_SECRET` shared signing secret used to verify requests
+- `APP_KEY` fallback shared signing secret if `MAIL_CLOUDFLARE_PROXY_SECRET` is not set
+
+Optional vars:
+
+- `ZT_PROXY_SIGNING_WINDOW_MS` default `60000`
+- `ZT_MAX_BODY_BYTES` default `131072`
+
+## Deploy
+
+From this package directory:
+
+```bash
+wrangler deploy
+```
+
+Set secrets:
+
+```bash
+wrangler secret put MAIL_CLOUDFLARE_PROXY_SECRET
+```
+
+## Use from ZinTrust
+
+Configure your app:
+
+- `MAIL_DRIVER=cl`
+- `MAIL_CLOUDFLARE_PROXY_URL=https://<your-worker-host>`
+- `MAIL_CLOUDFLARE_PROXY_KEY_ID=k1`
+- `MAIL_CLOUDFLARE_PROXY_SECRET=super-secret-shared-key`
+- `MAIL_CLOUDFLARE_BINDING=SEND_EMAIL` if needed
+
+Then use `Mail.send(...)` as normal.
+
+## License
+
+This package and its dependencies are MIT licensed, permitting free commercial use.

package/dist/build-manifest.json

@@ -0,0 +1,37 @@
+{
+  "name": "@zintrust/cloudflare-email-proxy",
+  "version": "2.1.3",
+  "buildDate": "2026-05-27T04:04:24.860Z",
+  "buildEnvironment": {
+    "node": "v22.22.1",
+    "platform": "darwin",
+    "arch": "arm64"
+  },
+  "git": {
+    "commit": "c82f6263",
+    "branch": "release"
+  },
+  "package": {
+    "engines": {
+      "node": ">=20.0.0"
+    },
+    "dependencies": [],
+    "peerDependencies": [
+      "@zintrust/core"
+    ]
+  },
+  "files": {
+    "build-manifest.json": {
+      "size": 836,
+      "sha256": "93369490a28e61401c8b3cd1db2461f88d133616d8d254d9de72bbab6598c8c2"
+    },
+    "index.d.ts": {
+      "size": 90,
+      "sha256": "578d6be2afb098df77accb6f0292cc41b8cc722c02ae86afcb4b9b88d94e1559"
+    },
+    "index.js": {
+      "size": 295,
+      "sha256": "72cf3b42eb23cd171b5c4fa447a24f914bc67d0f9317bfea9f8f5c17916b6110"
+    }
+  }
+}

package/dist/index.d.ts

@@ -0,0 +1 @@
+export { ZintrustEmailProxy, ZintrustEmailProxy as default } from '@zintrust/core/proxy';

package/dist/index.js

@@ -0,0 +1 @@
+export { ZintrustEmailProxy, ZintrustEmailProxy as default } from '@zintrust/core/proxy';

package/package.json

@@ -0,0 +1,38 @@
+{
+  "name": "@zintrust/cloudflare-email-proxy",
+  "version": "2.1.3",
+  "description": "Cloudflare email proxy package for ZinTrust.",
+  "type": "module",
+  "private": false,
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "default": "./dist/index.js"
+    }
+  },
+  "files": [
+    "dist"
+  ],
+  "engines": {
+    "node": ">=20.0.0"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "peerDependencies": {
+    "@zintrust/core": "*"
+  },
+  "keywords": [
+    "zintrust",
+    "cloudflare",
+    "email",
+    "mail",
+    "proxy",
+    "workers"
+  ],
+  "scripts": {
+    "build": "tsc -p tsconfig.json && tsc-alias -p tsconfig.json",
+    "prepublishOnly": "npm run build",
+    "type-check": "tsc -p tsconfig.json --noEmit"
+  }
+}