@coastweb/emdash-plugin-cloudflare-email 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 immber (Jessie Rushing) & CoastWeb, LLC
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,60 @@
+# @coastweb/emdash-plugin-cloudflare-email
+
+An [EmDash CMS](https://docs.emdashcms.com/introduction/) plugin that adds email sending through [Cloudflare Email Service](https://developers.cloudflare.com/email-service/) as an email provider.
+
+## Requirements
+
+**Cloudflare Workers only.** This plugin uses Cloudflare's `cloudflare:email` runtime API, which is only available on Cloudflare Workers. This plugin will not work on Node.js deployments.
+
+You must have [Cloudflare Email Service](https://developers.cloudflare.com/email-service/) (available in public beta) enabled on the same Cloudflare account where you are deploying your emdash worker.  You will need to configure a sending domain in Cloudflare before you can use this plugin.
+
+## Installation
+
+```bash
+npm install @coastweb/@coastweb/emdash-plugin-cloudflare-email
+```
+
+### 1. Add the `SEND_EMAIL` binding in `wrangler.jsonc` on your emdashcms worker
+
+```jsonc
+{
+  "send_email": [
+    {
+      "name": "SEND_EMAIL"
+    }
+  ]
+}
+```
+
+### 2. Register the plugin in `astro.config.mjs`
+
+```js
+import { cloudflareEmailPlugin } from "@coastweb/emdash-plugin-cloudflare-email";
+
+export default defineConfig({
+  integrations: [
+    emdash({
+      plugins: [cloudflareEmailPlugin()],
+      // ...
+    }),
+  ],
+});
+```
+
+The plugin must be in `plugins: []` (trusted mode), not `sandboxed: []`, because it requires access to the `SEND_EMAIL` Cloudflare binding.
+
+### 3. Set the from address
+
+After deploying, go to your EmDash admin and navigate to **Plugins → Cloudflare Email → Settings**. Enter a sender from address — this must be an address for a domain you have already configured in Cloudflare Email Service.
+
+## How it works
+
+This plugin registers as the `email:deliver` transport for EmDash's email pipeline. When another plugin (such as a forms plugin) calls `ctx.email.send()`, this plugin handles delivery by:
+
+1. Reading the configured `from` address from plugin settings
+2. Building a MIME message (plain text, or multipart `text/plain` + `text/html` if HTML is provided)
+3. Sending via the Cloudflare `SEND_EMAIL` Workers binding
+
+## License
+
+MIT

package/dist/index.d.ts

@@ -0,0 +1,5 @@
+import { PluginDescriptor } from 'emdash';
+
+declare function cloudflareEmailPlugin(): PluginDescriptor;
+
+export { cloudflareEmailPlugin };

package/dist/index.mjs

@@ -0,0 +1,15 @@
+// src/index.ts
+function cloudflareEmailPlugin() {
+  return {
+    id: "cloudflare-email",
+    version: "0.1.0",
+    format: "standard",
+    entrypoint: "emdash-plugin-cloudflare-email/sandbox",
+    options: {},
+    capabilities: ["email:provide"],
+    adminPages: [{ path: "/settings", label: "Cloudflare Email Settings", icon: "settings" }]
+  };
+}
+export {
+  cloudflareEmailPlugin
+};

package/dist/sandbox-entry.mjs

@@ -0,0 +1,105 @@
+// src/sandbox-entry.ts
+import { definePlugin } from "emdash";
+function buildMimeMessage(from, to, subject, text, html) {
+  const boundary = `----=_Part_${Date.now()}`;
+  const lines = [
+    `From: ${from}`,
+    `To: ${to}`,
+    `Subject: ${subject}`,
+    `MIME-Version: 1.0`
+  ];
+  if (html) {
+    lines.push(`Content-Type: multipart/alternative; boundary="${boundary}"`, ``);
+    lines.push(`--${boundary}`);
+    lines.push(`Content-Type: text/plain; charset=UTF-8`, ``, text, ``);
+    lines.push(`--${boundary}`);
+    lines.push(`Content-Type: text/html; charset=UTF-8`, ``, html, ``);
+    lines.push(`--${boundary}--`);
+  } else {
+    lines.push(`Content-Type: text/plain; charset=UTF-8`, ``, text);
+  }
+  return lines.join("\r\n");
+}
+var sandbox_entry_default = definePlugin({
+  hooks: {
+    "email:deliver": {
+      exclusive: true,
+      handler: async (event, ctx) => {
+        const from = await ctx.kv.get("settings:from");
+        if (!from) {
+          throw new Error(
+            "From address not configured. Set it in the Cloudflare Email plugin settings."
+          );
+        }
+        const { env } = await import("cloudflare:workers");
+        const binding = env.SEND_EMAIL;
+        if (!binding) {
+          throw new Error(
+            "SEND_EMAIL binding not found. Ensure send_email is configured in wrangler.jsonc."
+          );
+        }
+        const { message } = event;
+        const { EmailMessage } = await import("cloudflare:email");
+        const raw = buildMimeMessage(from, message.to, message.subject, message.text, message.html);
+        const emailMessage = new EmailMessage(from, message.to, raw);
+        await binding.send(emailMessage);
+      }
+    }
+  },
+  routes: {
+    admin: {
+      handler: async (routeCtx, ctx) => {
+        const interaction = routeCtx.input;
+        if (interaction.type === "form_submit" && interaction.action_id === "save_settings") {
+          const from2 = interaction.values?.from ?? "";
+          await ctx.kv.set("settings:from", from2);
+          return {
+            blocks: [
+              { type: "header", text: "Cloudflare Email Settings" },
+              {
+                type: "form",
+                block_id: "settings",
+                fields: [
+                  {
+                    type: "text_input",
+                    action_id: "from",
+                    label: "From address",
+                    initial_value: from2
+                  }
+                ],
+                submit: { label: "Save", action_id: "save_settings" }
+              }
+            ],
+            toast: { message: "Settings saved", type: "success" }
+          };
+        }
+        const from = await ctx.kv.get("settings:from") ?? "";
+        return {
+          blocks: [
+            { type: "header", text: "Cloudflare Email Settings" },
+            {
+              type: "context",
+              text: "Must be an address for a domain you have already configured in Cloudflare Email Service"
+            },
+            {
+              type: "form",
+              block_id: "settings",
+              fields: [
+                {
+                  type: "text_input",
+                  action_id: "from",
+                  label: "From address",
+                  initial_value: from
+                }
+              ],
+              submit: { label: "Save", action_id: "save_settings" }
+            }
+          ]
+        };
+      }
+    }
+  }
+});
+export {
+  sandbox_entry_default as default
+};

package/package.json

@@ -0,0 +1,22 @@
+{
+  "name": "@coastweb/emdash-plugin-cloudflare-email",
+  "version": "0.1.0",
+  "type": "module",
+  "exports": {
+    ".": { "import": "./dist/index.mjs", "types": "./dist/index.d.ts" },
+    "./sandbox": { "import": "./dist/sandbox-entry.mjs" }
+  },
+  "files": ["dist"],
+  "scripts": {
+    "build": "tsup",
+    "dev": "tsup --watch"
+  },
+  "peerDependencies": {
+    "emdash": "*"
+  },
+  "devDependencies": {
+    "@cloudflare/workers-types": "^4.20260426.1",
+    "tsup": "^8.5.1",
+    "typescript": "^5.9.3"
+  }
+}