emdash-aws-ses 1.0.0

package/dist/index.cjs

@@ -0,0 +1,43 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/index.ts
+var index_exports = {};
+__export(index_exports, {
+  awsSesPlugin: () => awsSesPlugin
+});
+module.exports = __toCommonJS(index_exports);
+function awsSesPlugin() {
+  return {
+    id: "emdash-aws-ses",
+    version: "1.0.0",
+    format: "standard",
+    entrypoint: "emdash-aws-ses/sandbox",
+    options: {},
+    capabilities: ["hooks.email-transport:register"],
+    adminPages: [
+      { path: "/settings", label: "AWS SES Settings", icon: "mail" },
+      { path: "/test", label: "Test & Status", icon: "send" }
+    ]
+  };
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  awsSesPlugin
+});

package/dist/index.js

@@ -0,0 +1,18 @@
+// src/index.ts
+function awsSesPlugin() {
+  return {
+    id: "emdash-aws-ses",
+    version: "1.0.0",
+    format: "standard",
+    entrypoint: "emdash-aws-ses/sandbox",
+    options: {},
+    capabilities: ["hooks.email-transport:register"],
+    adminPages: [
+      { path: "/settings", label: "AWS SES Settings", icon: "mail" },
+      { path: "/test", label: "Test & Status", icon: "send" }
+    ]
+  };
+}
+export {
+  awsSesPlugin
+};

package/dist/sandbox-entry.cjs

@@ -0,0 +1,391 @@
+"use strict";
+var __create = Object.create;
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __getProtoOf = Object.getPrototypeOf;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__getProtoOf(mod)) : {}, __copyProps(
+  // If the importer is in node compatibility mode or this is not an ESM
+  // file that has been converted to a CommonJS file using a Babel-
+  // compatible transform (i.e. "__esModule" has not been set), then set
+  // "default" to the CommonJS "module.exports" for node compatibility.
+  isNodeMode || !mod || !mod.__esModule ? __defProp(target, "default", { value: mod, enumerable: true }) : target,
+  mod
+));
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/sandbox-entry.ts
+var sandbox_entry_exports = {};
+__export(sandbox_entry_exports, {
+  default: () => sandbox_entry_default
+});
+module.exports = __toCommonJS(sandbox_entry_exports);
+var import_emdash = require("emdash");
+var import_nodemailer = __toESM(require("nodemailer"), 1);
+async function getSettings(ctx) {
+  const defaults = {
+    smtpHost: "email-smtp.us-east-1.amazonaws.com",
+    smtpPort: 587,
+    region: "us-east-1",
+    defaultFrom: "",
+    fromName: "",
+    replyTo: "",
+    smtpUser: "",
+    smtpPassword: ""
+  };
+  const [smtpHost, smtpPortRaw, smtpUser, smtpPassword, region, defaultFrom, fromName, replyTo] = await Promise.all([
+    ctx.kv.get("settings:smtpHost"),
+    ctx.kv.get("settings:smtpPort"),
+    ctx.kv.get("settings:smtpUser"),
+    ctx.kv.get("settings:smtpPassword"),
+    ctx.kv.get("settings:region"),
+    ctx.kv.get("settings:defaultFrom"),
+    ctx.kv.get("settings:fromName"),
+    ctx.kv.get("settings:replyTo")
+  ]);
+  return {
+    smtpHost: smtpHost ?? defaults.smtpHost,
+    smtpPort: Number(smtpPortRaw ?? defaults.smtpPort),
+    smtpUser: smtpUser ?? defaults.smtpUser,
+    smtpPassword: smtpPassword ?? defaults.smtpPassword,
+    region: region ?? defaults.region,
+    defaultFrom: defaultFrom ?? defaults.defaultFrom,
+    fromName: fromName ?? defaults.fromName,
+    replyTo: replyTo ?? defaults.replyTo
+  };
+}
+function createTransporter(settings) {
+  const secure = settings.smtpPort === 465;
+  const requireTLS = settings.smtpPort === 587 || settings.smtpPort === 25 || settings.smtpPort === 2587;
+  return import_nodemailer.default.createTransport({
+    host: settings.smtpHost,
+    port: settings.smtpPort,
+    secure,
+    auth: {
+      user: settings.smtpUser,
+      pass: settings.smtpPassword
+    },
+    tls: {
+      rejectUnauthorized: true
+    },
+    requireTLS,
+    connectionTimeout: 1e4,
+    greetingTimeout: 1e4,
+    socketTimeout: 1e4
+  });
+}
+async function validateSMTP(ctx) {
+  try {
+    const settings = await getSettings(ctx);
+    if (!settings.smtpHost || !settings.smtpUser || !settings.smtpPassword) {
+      return { ok: false, error: "SMTP settings are incomplete. Please configure host, user, and password." };
+    }
+    const transporter = createTransporter(settings);
+    await transporter.verify();
+    return { ok: true };
+  } catch (err) {
+    const message = err instanceof Error ? err.message : String(err);
+    return { ok: false, error: `Connection failed: ${message}` };
+  }
+}
+async function sendTestEmail(ctx, recipient) {
+  try {
+    const settings = await getSettings(ctx);
+    if (!settings.defaultFrom) {
+      return { ok: false, error: "Default From address is not configured." };
+    }
+    const transporter = createTransporter(settings);
+    await transporter.sendMail({
+      from: settings.fromName ? `"${settings.fromName}" <${settings.defaultFrom}>` : settings.defaultFrom,
+      to: recipient,
+      subject: "Test email from EmDash + AWS SES",
+      text: "This is a test email sent via Amazon SES from your EmDash CMS.",
+      html: "<p>This is a test email sent via <strong>Amazon SES</strong> from your EmDash CMS.</p>",
+      replyTo: settings.replyTo || void 0
+    });
+    return { ok: true };
+  } catch (err) {
+    const message = err instanceof Error ? err.message : String(err);
+    return { ok: false, error: `Send failed: ${message}` };
+  }
+}
+async function renderSettingsPage(ctx) {
+  const settings = await getSettings(ctx);
+  return {
+    blocks: [
+      { type: "header", text: "AWS SES Settings" },
+      { type: "section", text: "Configure your Amazon SES SMTP transport. All settings are stored in the plugin KV store." },
+      { type: "divider" },
+      {
+        type: "form",
+        block_id: "settings",
+        fields: [
+          {
+            type: "text_input",
+            action_id: "smtpHost",
+            label: "SMTP Host",
+            initial_value: settings.smtpHost,
+            placeholder: "email-smtp.us-east-1.amazonaws.com"
+          },
+          {
+            type: "number_input",
+            action_id: "smtpPort",
+            label: "SMTP Port",
+            initial_value: settings.smtpPort,
+            min: 1,
+            max: 65535
+          },
+          {
+            type: "text_input",
+            action_id: "smtpUser",
+            label: "SMTP Username",
+            initial_value: settings.smtpUser,
+            placeholder: "AWS SES SMTP username (IAM Access Key ID)"
+          },
+          {
+            type: "secret_input",
+            action_id: "smtpPassword",
+            label: "SMTP Password",
+            initial_value: ""
+          },
+          {
+            type: "text_input",
+            action_id: "region",
+            label: "AWS Region",
+            initial_value: settings.region,
+            placeholder: "us-east-1"
+          },
+          {
+            type: "text_input",
+            action_id: "defaultFrom",
+            label: "Default From Address",
+            initial_value: settings.defaultFrom,
+            placeholder: "noreply@example.com"
+          },
+          {
+            type: "text_input",
+            action_id: "fromName",
+            label: "From Name",
+            initial_value: settings.fromName,
+            placeholder: "My Site"
+          },
+          {
+            type: "text_input",
+            action_id: "replyTo",
+            label: "Reply-To Address",
+            initial_value: settings.replyTo,
+            placeholder: "support@example.com"
+          }
+        ],
+        submit: { label: "Save Settings", action_id: "save_settings" }
+      }
+    ]
+  };
+}
+function getDefaultEndpoint(region) {
+  return `email-smtp.${region}.amazonaws.com`;
+}
+async function saveSettings(ctx, values) {
+  const currentSettings = await getSettings(ctx);
+  if (typeof values.region === "string" && values.region.length > 0 && values.region !== currentSettings.region) {
+    const oldEndpoint = getDefaultEndpoint(currentSettings.region);
+    if (!currentSettings.smtpHost || currentSettings.smtpHost === oldEndpoint) {
+      values.smtpHost = getDefaultEndpoint(values.region);
+    }
+  }
+  if (typeof values.smtpHost === "string" && values.smtpHost.length > 0) {
+    await ctx.kv.set("settings:smtpHost", values.smtpHost);
+  }
+  if (typeof values.smtpPort === "number" && values.smtpPort >= 1 && values.smtpPort <= 65535) {
+    await ctx.kv.set("settings:smtpPort", values.smtpPort);
+  }
+  if (typeof values.smtpUser === "string" && values.smtpUser.length > 0) {
+    await ctx.kv.set("settings:smtpUser", values.smtpUser);
+  }
+  if (typeof values.smtpPassword === "string" && values.smtpPassword.length > 0) {
+    await ctx.kv.set("settings:smtpPassword", values.smtpPassword);
+  }
+  if (typeof values.region === "string" && values.region.length > 0) {
+    await ctx.kv.set("settings:region", values.region);
+  }
+  if (typeof values.defaultFrom === "string") {
+    await ctx.kv.set("settings:defaultFrom", values.defaultFrom);
+  }
+  if (typeof values.fromName === "string") {
+    await ctx.kv.set("settings:fromName", values.fromName);
+  }
+  if (typeof values.replyTo === "string") {
+    await ctx.kv.set("settings:replyTo", values.replyTo);
+  }
+}
+async function renderTestPage(ctx, validation, sendResult) {
+  const settings = await getSettings(ctx);
+  const blocks = [
+    { type: "header", text: "AWS SES Test & Status" },
+    { type: "section", text: `Current endpoint: ${settings.smtpHost}:${settings.smtpPort} (${settings.region})` },
+    { type: "divider" }
+  ];
+  if (validation) {
+    if (validation.ok) {
+      blocks.push({
+        type: "banner",
+        title: "Connection verified",
+        description: "SMTP credentials are valid.",
+        variant: "default"
+      });
+    } else {
+      blocks.push({
+        type: "banner",
+        title: "Connection failed",
+        description: validation.error,
+        variant: "error"
+      });
+    }
+  }
+  blocks.push(
+    { type: "section", text: "Test your SMTP connection and verify your credentials are correct." },
+    {
+      type: "actions",
+      elements: [
+        {
+          type: "button",
+          label: "Test Connection",
+          action_id: "validate"
+        }
+      ]
+    },
+    { type: "divider" },
+    { type: "header", text: "Send Test Email" },
+    { type: "section", text: "Send a test email to verify the full transport pipeline. Enter a recipient address below." }
+  );
+  if (sendResult) {
+    if (sendResult.ok) {
+      blocks.push({
+        type: "banner",
+        title: "Email sent",
+        description: `Test email sent successfully to ${sendResult.recipient}.`,
+        variant: "default"
+      });
+    } else {
+      blocks.push({
+        type: "banner",
+        title: "Email send failed",
+        description: sendResult.error,
+        variant: "error"
+      });
+    }
+  }
+  blocks.push({
+    type: "form",
+    block_id: "test_form",
+    fields: [
+      {
+        type: "text_input",
+        action_id: "recipient",
+        label: "Recipient Email",
+        placeholder: "you@example.com",
+        initial_value: sendResult?.ok ? "" : void 0
+      }
+    ],
+    submit: { label: "Send Test", action_id: "send_test" }
+  });
+  return { blocks };
+}
+var sandbox_entry_default = (0, import_emdash.definePlugin)({
+  id: "emdash-aws-ses",
+  version: "1.0.0",
+  capabilities: ["hooks.email-transport:register"],
+  hooks: {
+    "plugin:install": async (_event, ctx) => {
+      await ctx.kv.set("settings:smtpHost", "email-smtp.us-east-1.amazonaws.com");
+      await ctx.kv.set("settings:smtpPort", 587);
+      await ctx.kv.set("settings:region", "us-east-1");
+      ctx.log.info("AWS SES plugin defaults seeded");
+    },
+    "email:deliver": {
+      exclusive: true,
+      handler: async ({ message, source }, ctx) => {
+        const settings = await getSettings(ctx);
+        const transporter = createTransporter(settings);
+        await transporter.sendMail({
+          from: settings.fromName ? `"${settings.fromName}" <${settings.defaultFrom}>` : settings.defaultFrom,
+          to: message.to,
+          subject: message.subject,
+          text: message.text,
+          html: message.html,
+          replyTo: settings.replyTo || void 0
+        });
+        ctx.log.info(`Email sent via AWS SES to ${message.to}`, { source });
+      }
+    }
+  },
+  routes: {
+    admin: {
+      handler: async (routeCtx, ctx) => {
+        const interaction = routeCtx.input;
+        if (interaction.type === "page_load" && (!interaction.page || interaction.page === "/")) {
+          return renderSettingsPage(ctx);
+        }
+        if (interaction.type === "page_load" && interaction.page === "/settings") {
+          return renderSettingsPage(ctx);
+        }
+        if (interaction.type === "form_submit" && interaction.action_id === "save_settings") {
+          await saveSettings(ctx, interaction.values ?? {});
+          const settingsPage = await renderSettingsPage(ctx);
+          const settingsBlocks = settingsPage.blocks;
+          return {
+            blocks: [
+              settingsBlocks[0],
+              {
+                type: "banner",
+                title: "Settings saved",
+                description: "Your AWS SES configuration has been updated successfully.",
+                variant: "default"
+              },
+              ...settingsBlocks.slice(1)
+            ],
+            toast: { message: "Settings saved successfully", type: "success" }
+          };
+        }
+        if (interaction.type === "page_load" && interaction.page === "/test") {
+          return renderTestPage(ctx);
+        }
+        if (interaction.type === "block_action" && interaction.action_id === "validate") {
+          const result = await validateSMTP(ctx);
+          return {
+            ...await renderTestPage(ctx, result),
+            toast: result.ok ? { message: "Connection verified successfully", type: "success" } : { message: result.error ?? "Validation failed", type: "error" }
+          };
+        }
+        if (interaction.type === "form_submit" && interaction.action_id === "send_test") {
+          const recipient = interaction.values?.recipient?.trim();
+          if (!recipient) {
+            return {
+              ...await renderTestPage(ctx),
+              toast: { message: "Please enter a recipient email", type: "error" }
+            };
+          }
+          const result = await sendTestEmail(ctx, recipient);
+          return {
+            ...await renderTestPage(ctx, null, { ...result, recipient }),
+            toast: result.ok ? { message: `Test email sent to ${recipient}`, type: "success" } : { message: result.error ?? "Send failed", type: "error" }
+          };
+        }
+        return { blocks: [] };
+      }
+    }
+  }
+});

package/dist/sandbox-entry.js

@@ -0,0 +1,360 @@
+// src/sandbox-entry.ts
+import { definePlugin } from "emdash";
+import nodemailer from "nodemailer";
+async function getSettings(ctx) {
+  const defaults = {
+    smtpHost: "email-smtp.us-east-1.amazonaws.com",
+    smtpPort: 587,
+    region: "us-east-1",
+    defaultFrom: "",
+    fromName: "",
+    replyTo: "",
+    smtpUser: "",
+    smtpPassword: ""
+  };
+  const [smtpHost, smtpPortRaw, smtpUser, smtpPassword, region, defaultFrom, fromName, replyTo] = await Promise.all([
+    ctx.kv.get("settings:smtpHost"),
+    ctx.kv.get("settings:smtpPort"),
+    ctx.kv.get("settings:smtpUser"),
+    ctx.kv.get("settings:smtpPassword"),
+    ctx.kv.get("settings:region"),
+    ctx.kv.get("settings:defaultFrom"),
+    ctx.kv.get("settings:fromName"),
+    ctx.kv.get("settings:replyTo")
+  ]);
+  return {
+    smtpHost: smtpHost ?? defaults.smtpHost,
+    smtpPort: Number(smtpPortRaw ?? defaults.smtpPort),
+    smtpUser: smtpUser ?? defaults.smtpUser,
+    smtpPassword: smtpPassword ?? defaults.smtpPassword,
+    region: region ?? defaults.region,
+    defaultFrom: defaultFrom ?? defaults.defaultFrom,
+    fromName: fromName ?? defaults.fromName,
+    replyTo: replyTo ?? defaults.replyTo
+  };
+}
+function createTransporter(settings) {
+  const secure = settings.smtpPort === 465;
+  const requireTLS = settings.smtpPort === 587 || settings.smtpPort === 25 || settings.smtpPort === 2587;
+  return nodemailer.createTransport({
+    host: settings.smtpHost,
+    port: settings.smtpPort,
+    secure,
+    auth: {
+      user: settings.smtpUser,
+      pass: settings.smtpPassword
+    },
+    tls: {
+      rejectUnauthorized: true
+    },
+    requireTLS,
+    connectionTimeout: 1e4,
+    greetingTimeout: 1e4,
+    socketTimeout: 1e4
+  });
+}
+async function validateSMTP(ctx) {
+  try {
+    const settings = await getSettings(ctx);
+    if (!settings.smtpHost || !settings.smtpUser || !settings.smtpPassword) {
+      return { ok: false, error: "SMTP settings are incomplete. Please configure host, user, and password." };
+    }
+    const transporter = createTransporter(settings);
+    await transporter.verify();
+    return { ok: true };
+  } catch (err) {
+    const message = err instanceof Error ? err.message : String(err);
+    return { ok: false, error: `Connection failed: ${message}` };
+  }
+}
+async function sendTestEmail(ctx, recipient) {
+  try {
+    const settings = await getSettings(ctx);
+    if (!settings.defaultFrom) {
+      return { ok: false, error: "Default From address is not configured." };
+    }
+    const transporter = createTransporter(settings);
+    await transporter.sendMail({
+      from: settings.fromName ? `"${settings.fromName}" <${settings.defaultFrom}>` : settings.defaultFrom,
+      to: recipient,
+      subject: "Test email from EmDash + AWS SES",
+      text: "This is a test email sent via Amazon SES from your EmDash CMS.",
+      html: "<p>This is a test email sent via <strong>Amazon SES</strong> from your EmDash CMS.</p>",
+      replyTo: settings.replyTo || void 0
+    });
+    return { ok: true };
+  } catch (err) {
+    const message = err instanceof Error ? err.message : String(err);
+    return { ok: false, error: `Send failed: ${message}` };
+  }
+}
+async function renderSettingsPage(ctx) {
+  const settings = await getSettings(ctx);
+  return {
+    blocks: [
+      { type: "header", text: "AWS SES Settings" },
+      { type: "section", text: "Configure your Amazon SES SMTP transport. All settings are stored in the plugin KV store." },
+      { type: "divider" },
+      {
+        type: "form",
+        block_id: "settings",
+        fields: [
+          {
+            type: "text_input",
+            action_id: "smtpHost",
+            label: "SMTP Host",
+            initial_value: settings.smtpHost,
+            placeholder: "email-smtp.us-east-1.amazonaws.com"
+          },
+          {
+            type: "number_input",
+            action_id: "smtpPort",
+            label: "SMTP Port",
+            initial_value: settings.smtpPort,
+            min: 1,
+            max: 65535
+          },
+          {
+            type: "text_input",
+            action_id: "smtpUser",
+            label: "SMTP Username",
+            initial_value: settings.smtpUser,
+            placeholder: "AWS SES SMTP username (IAM Access Key ID)"
+          },
+          {
+            type: "secret_input",
+            action_id: "smtpPassword",
+            label: "SMTP Password",
+            initial_value: ""
+          },
+          {
+            type: "text_input",
+            action_id: "region",
+            label: "AWS Region",
+            initial_value: settings.region,
+            placeholder: "us-east-1"
+          },
+          {
+            type: "text_input",
+            action_id: "defaultFrom",
+            label: "Default From Address",
+            initial_value: settings.defaultFrom,
+            placeholder: "noreply@example.com"
+          },
+          {
+            type: "text_input",
+            action_id: "fromName",
+            label: "From Name",
+            initial_value: settings.fromName,
+            placeholder: "My Site"
+          },
+          {
+            type: "text_input",
+            action_id: "replyTo",
+            label: "Reply-To Address",
+            initial_value: settings.replyTo,
+            placeholder: "support@example.com"
+          }
+        ],
+        submit: { label: "Save Settings", action_id: "save_settings" }
+      }
+    ]
+  };
+}
+function getDefaultEndpoint(region) {
+  return `email-smtp.${region}.amazonaws.com`;
+}
+async function saveSettings(ctx, values) {
+  const currentSettings = await getSettings(ctx);
+  if (typeof values.region === "string" && values.region.length > 0 && values.region !== currentSettings.region) {
+    const oldEndpoint = getDefaultEndpoint(currentSettings.region);
+    if (!currentSettings.smtpHost || currentSettings.smtpHost === oldEndpoint) {
+      values.smtpHost = getDefaultEndpoint(values.region);
+    }
+  }
+  if (typeof values.smtpHost === "string" && values.smtpHost.length > 0) {
+    await ctx.kv.set("settings:smtpHost", values.smtpHost);
+  }
+  if (typeof values.smtpPort === "number" && values.smtpPort >= 1 && values.smtpPort <= 65535) {
+    await ctx.kv.set("settings:smtpPort", values.smtpPort);
+  }
+  if (typeof values.smtpUser === "string" && values.smtpUser.length > 0) {
+    await ctx.kv.set("settings:smtpUser", values.smtpUser);
+  }
+  if (typeof values.smtpPassword === "string" && values.smtpPassword.length > 0) {
+    await ctx.kv.set("settings:smtpPassword", values.smtpPassword);
+  }
+  if (typeof values.region === "string" && values.region.length > 0) {
+    await ctx.kv.set("settings:region", values.region);
+  }
+  if (typeof values.defaultFrom === "string") {
+    await ctx.kv.set("settings:defaultFrom", values.defaultFrom);
+  }
+  if (typeof values.fromName === "string") {
+    await ctx.kv.set("settings:fromName", values.fromName);
+  }
+  if (typeof values.replyTo === "string") {
+    await ctx.kv.set("settings:replyTo", values.replyTo);
+  }
+}
+async function renderTestPage(ctx, validation, sendResult) {
+  const settings = await getSettings(ctx);
+  const blocks = [
+    { type: "header", text: "AWS SES Test & Status" },
+    { type: "section", text: `Current endpoint: ${settings.smtpHost}:${settings.smtpPort} (${settings.region})` },
+    { type: "divider" }
+  ];
+  if (validation) {
+    if (validation.ok) {
+      blocks.push({
+        type: "banner",
+        title: "Connection verified",
+        description: "SMTP credentials are valid.",
+        variant: "default"
+      });
+    } else {
+      blocks.push({
+        type: "banner",
+        title: "Connection failed",
+        description: validation.error,
+        variant: "error"
+      });
+    }
+  }
+  blocks.push(
+    { type: "section", text: "Test your SMTP connection and verify your credentials are correct." },
+    {
+      type: "actions",
+      elements: [
+        {
+          type: "button",
+          label: "Test Connection",
+          action_id: "validate"
+        }
+      ]
+    },
+    { type: "divider" },
+    { type: "header", text: "Send Test Email" },
+    { type: "section", text: "Send a test email to verify the full transport pipeline. Enter a recipient address below." }
+  );
+  if (sendResult) {
+    if (sendResult.ok) {
+      blocks.push({
+        type: "banner",
+        title: "Email sent",
+        description: `Test email sent successfully to ${sendResult.recipient}.`,
+        variant: "default"
+      });
+    } else {
+      blocks.push({
+        type: "banner",
+        title: "Email send failed",
+        description: sendResult.error,
+        variant: "error"
+      });
+    }
+  }
+  blocks.push({
+    type: "form",
+    block_id: "test_form",
+    fields: [
+      {
+        type: "text_input",
+        action_id: "recipient",
+        label: "Recipient Email",
+        placeholder: "you@example.com",
+        initial_value: sendResult?.ok ? "" : void 0
+      }
+    ],
+    submit: { label: "Send Test", action_id: "send_test" }
+  });
+  return { blocks };
+}
+var sandbox_entry_default = definePlugin({
+  id: "emdash-aws-ses",
+  version: "1.0.0",
+  capabilities: ["hooks.email-transport:register"],
+  hooks: {
+    "plugin:install": async (_event, ctx) => {
+      await ctx.kv.set("settings:smtpHost", "email-smtp.us-east-1.amazonaws.com");
+      await ctx.kv.set("settings:smtpPort", 587);
+      await ctx.kv.set("settings:region", "us-east-1");
+      ctx.log.info("AWS SES plugin defaults seeded");
+    },
+    "email:deliver": {
+      exclusive: true,
+      handler: async ({ message, source }, ctx) => {
+        const settings = await getSettings(ctx);
+        const transporter = createTransporter(settings);
+        await transporter.sendMail({
+          from: settings.fromName ? `"${settings.fromName}" <${settings.defaultFrom}>` : settings.defaultFrom,
+          to: message.to,
+          subject: message.subject,
+          text: message.text,
+          html: message.html,
+          replyTo: settings.replyTo || void 0
+        });
+        ctx.log.info(`Email sent via AWS SES to ${message.to}`, { source });
+      }
+    }
+  },
+  routes: {
+    admin: {
+      handler: async (routeCtx, ctx) => {
+        const interaction = routeCtx.input;
+        if (interaction.type === "page_load" && (!interaction.page || interaction.page === "/")) {
+          return renderSettingsPage(ctx);
+        }
+        if (interaction.type === "page_load" && interaction.page === "/settings") {
+          return renderSettingsPage(ctx);
+        }
+        if (interaction.type === "form_submit" && interaction.action_id === "save_settings") {
+          await saveSettings(ctx, interaction.values ?? {});
+          const settingsPage = await renderSettingsPage(ctx);
+          const settingsBlocks = settingsPage.blocks;
+          return {
+            blocks: [
+              settingsBlocks[0],
+              {
+                type: "banner",
+                title: "Settings saved",
+                description: "Your AWS SES configuration has been updated successfully.",
+                variant: "default"
+              },
+              ...settingsBlocks.slice(1)
+            ],
+            toast: { message: "Settings saved successfully", type: "success" }
+          };
+        }
+        if (interaction.type === "page_load" && interaction.page === "/test") {
+          return renderTestPage(ctx);
+        }
+        if (interaction.type === "block_action" && interaction.action_id === "validate") {
+          const result = await validateSMTP(ctx);
+          return {
+            ...await renderTestPage(ctx, result),
+            toast: result.ok ? { message: "Connection verified successfully", type: "success" } : { message: result.error ?? "Validation failed", type: "error" }
+          };
+        }
+        if (interaction.type === "form_submit" && interaction.action_id === "send_test") {
+          const recipient = interaction.values?.recipient?.trim();
+          if (!recipient) {
+            return {
+              ...await renderTestPage(ctx),
+              toast: { message: "Please enter a recipient email", type: "error" }
+            };
+          }
+          const result = await sendTestEmail(ctx, recipient);
+          return {
+            ...await renderTestPage(ctx, null, { ...result, recipient }),
+            toast: result.ok ? { message: `Test email sent to ${recipient}`, type: "success" } : { message: result.error ?? "Send failed", type: "error" }
+          };
+        }
+        return { blocks: [] };
+      }
+    }
+  }
+});
+export {
+  sandbox_entry_default as default
+};

package/package.json

@@ -0,0 +1,46 @@
+{
+  "name": "emdash-aws-ses",
+  "version": "1.0.0",
+  "description": "Amazon SES SMTP email transport plugin for EmDash CMS",
+  "license": "MIT",
+  "keywords": [
+    "emdash",
+    "emdash-plugin",
+    "aws-ses",
+    "astro",
+    "aws"
+  ],
+  "type": "module",
+  "main": "./dist/index.cjs",
+  "module": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "files": [
+    "dist"
+  ],
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js",
+      "require": "./dist/index.cjs"
+    },
+    "./sandbox": {
+      "types": "./dist/sandbox-entry.d.ts",
+      "import": "./dist/sandbox-entry.js",
+      "require": "./dist/sandbox-entry.cjs"
+    }
+  },
+  "scripts": {
+    "build": "tsup src/index.ts src/sandbox-entry.ts --format cjs,esm --clean"
+  },
+  "peerDependencies": {
+    "emdash": "^0.29.0"
+  },
+  "dependencies": {
+    "nodemailer": "^9.0.3"
+  },
+  "devDependencies": {
+    "@types/nodemailer": "^8.0.1",
+    "typescript": "^7.0.2",
+    "tsup": "^8.5.1"
+  }
+}