emdash-aws-ses 1.0.2 → 1.0.4

package/README.md

@@ -0,0 +1,159 @@
+# emdash-aws-ses
+
+A standalone, lightweight SMTP email transport plugin for **EmDash CMS** designed to route all system emails securely through **Amazon SES (Simple Email Service)**.
+
+By registering exclusively with EmDash’s mail delivery hooks, this plugin routes all native transactional emails (including passwordless magic links, collaborator invitations, and system notifications) through your AWS infrastructure.
+
+---
+
+## Features
+
+*   **Exclusive Email Routing:** Intercepts the global EmDash `email:deliver` hook with `exclusive: true` to route all outgoing mail using secure SMTP transport powered by `nodemailer`.
+*   **Interactive Block Kit UI:** Provides a built-in, responsive configuration and test dashboard directly inside the EmDash administrative panel.
+*   **Secure Database Persistence:** Saves your SMTP credentials securely inside your active database (SQLite or PostgreSQL) via the native EmDash key-value (`ctx.kv`) store.
+*   **Built-in Diagnostics:** Validates SMTP server handshakes and sends HTML/plaintext test emails to any recipient directly from the visual test tab.
+
+---
+
+## Prerequisites
+
+Before installing the plugin, ensure you have configured your AWS environment:
+1.  **Verified Identity:** Confirm that your sender domain (e.g., `your-domain.com`) or specific email address (e.g., `info@your-domain.com`) is verified in your **Amazon SES** console. Unverified identities will be rejected by AWS.
+2.  **SMTP Credentials:** Go to the *SMTP Settings* tab in your Amazon SES console and click **Create SMTP Credentials** to generate a dedicated IAM SMTP Username and SMTP Password.
+
+---
+
+## Installation
+
+Install the package into your main Astro + EmDash website directory:
+
+### From the public npm registry (Recommended):
+```bash
+npm install emdash-aws-ses
+```
+
+### From a local development directory:
+```bash
+npm install ../path/to/emdash-aws-ses
+```
+
+---
+
+## Integration in Astro
+
+To enable the plugin, import and register `awsSesPlugin()` inside the `plugins` array of the EmDash integration in your `astro.config.mjs` file:
+
+```javascript
+// astro.config.mjs
+import "dotenv/config";
+
+import node from "@astrojs/node";
+import react from "@astrojs/react";
+import { defineConfig } from "astro/config";
+import emdash, { local } from "emdash/astro";
+import { sqlite } from "emdash/db";
+
+// 1. Import the plugin
+import { awsSesPlugin } from "emdash-aws-ses";
+
+export default defineConfig({
+	output: "server",
+	adapter: node({
+		mode: "standalone",
+	}),
+	image: {
+		layout: "constrained",
+		responsiveStyles: true,
+	},
+	integrations: [
+		react(),
+		emdash({
+			database: sqlite({
+				// Dynamic SQLite database resolution for Coolify
+				url: process.env.NODE_ENV === "production"
+					? "file:/app/data/data.db"
+					: "file:./data.db",
+			}),
+			storage: local({
+				// Dynamic persistent directory mapping for Coolify
+				directory: process.env.NODE_ENV === "production"
+					? "/app/data/uploads"
+					: "./uploads",
+				baseUrl: "/_emdash/api/media/file",
+			}),
+			// 2. Register your plugin here
+			plugins: [
+				awsSesPlugin(),
+			],
+		}),
+	],
+	devToolbar: { enabled: false },
+});
+```
+
+---
+
+## Configuration & Usage
+
+Once your application is running, navigate to your CMS admin panel at `https://your-domain.com/_emdash/admin`.
+
+### 1. SMTP Settings Panel
+Go to **Settings** -> **Plugins** -> **AWS SES Settings** and fill out the interactive configuration form:
+
+| Field | Description | Example |
+| :--- | :--- | :--- |
+| **SMTP Host** | The SMTP endpoint host provided by Amazon SES. | `email-smtp.us-east-1.amazonaws.com` |
+| **SMTP Port** | The secure SMTP port (STARTTLS or SSL/TLS). | `587` (Recommended) or `465` |
+| **SMTP Username** | Your dedicated IAM SMTP Username generated in AWS. | `AKIA...` |
+| **SMTP Password** | Your dedicated IAM SMTP Password generated in AWS. | `xxxXXXxxx` |
+| **AWS Region** | The geographic AWS region where your SES is hosted. | `us-east-1` |
+| **Default From Address** | A verified and authorized sender email address in AWS. | `noreply@your-domain.com` |
+| **From Name** | The display name recipients will see. | `Your Company` |
+| **Reply-To Address** | An optional reply-to address for user responses. | `support@your-domain.com` |
+
+Click **Save Settings** to write your changes securely to the database.
+
+### 2. Testing the Connection
+Navigate to the **Test & Status** tab inside the plugin's dashboard to diagnose the pipeline:
+*   Click **Test Connection** to trigger an on-demand SMTP handshake validation.
+*   Type an email address in the **Recipient Email** field and click **Send Test** to send a test HTML and plaintext message.
+
+---
+
+## Under the Hood (Developer Reference)
+
+The plugin implements the standard `SandboxedPlugin` interface exposed by EmDash.
+
+### `plugin:install` Lifecycle Hook
+Fires automatically when the plugin is registered in the CMS. It seeds default SMTP values (`email-smtp.us-east-1.amazonaws.com` on port `587`) securely inside `ctx.kv` to ensure a smooth first-time startup.
+
+### `email:deliver` Event Handler
+Registers with `exclusive: true`. This setting commands EmDash to bypass any default local SMTP transporters or falling-back configurations, sending the `EmailDeliverEvent` payload directly to the custom SES transport handler.
+
+---
+
+## Local Development
+
+If you want to contribute to this plugin, modify the source code, or test it locally, you must compile the TypeScript files into executable JavaScript:
+
+1. Clone the repository and navigate to the directory:
+   ```bash
+   git clone https://github.com/ab6162/emdash-aws-ses.git
+   cd emdash-aws-ses
+   ```
+
+2. Install the local development dependencies:
+   ```bash
+   npm install
+   ```
+
+3. Build the distribution files:
+   ```bash
+   npm run build
+   ```
+
+This will generate the `/dist` directory containing the ESM and CommonJS compiled outputs.
+
+## License
+
+This project is licensed under the MIT License. See the `LICENSE` file for more details.

package/dist/index.cjs

@@ -0,0 +1,44 @@
+"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"],
+    allowedHosts: [],
+    adminPages: [
+      { path: "/settings", label: "AWS SES Settings", icon: "mail" },
+      { path: "/test", label: "AWS SES Test & Status", icon: "send" }
+    ]
+  };
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  awsSesPlugin
+});

package/dist/index.d.ts

@@ -0,0 +1,2 @@
+import type { PluginDescriptor } from "emdash";
+export declare function awsSesPlugin(): PluginDescriptor;

package/{src/index.ts → dist/index.js}

@@ -1,6 +1,5 @@
-import type { PluginDescriptor } from "emdash";
-
-export function awsSesPlugin(): PluginDescriptor {
+// src/index.ts
+function awsSesPlugin() {
   return {
     id: "emdash-aws-ses",
     version: "1.0.0",
@@ -11,7 +10,10 @@ export function awsSesPlugin(): PluginDescriptor {
     allowedHosts: [],
     adminPages: [
       { path: "/settings", label: "AWS SES Settings", icon: "mail" },
-      { path: "/test", label: "AWS SES Test & Status", icon: "send" },
-    ],
+      { path: "/test", label: "AWS SES Test & Status", icon: "send" }
+    ]
   };
 }
+export {
+  awsSesPlugin
+};

package/dist/sandbox-entry.cjs

@@ -0,0 +1,390 @@
+"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_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" }
+      },
+      { type: "divider" },
+      { type: "header", text: "Email Provider Activation" },
+      { type: "section", text: "To activate AWS SES as your active email provider, go to Settings > Email in the EmDash admin and select emdash-aws-ses from the list. This routes all EmDash email (magic links, invites, notifications) through AWS SES." }
+    ]
+  };
+}
+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 = {
+  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.d.ts

@@ -0,0 +1,127 @@
+import type { SandboxedRouteContext, PluginContext, EmailDeliverEvent, LifecycleEvent } from "emdash/plugin";
+declare const _default: {
+    hooks: {
+        "plugin:install": (_event: LifecycleEvent, ctx: PluginContext) => Promise<void>;
+        "email:deliver": {
+            exclusive: true;
+            handler: ({ message, source }: EmailDeliverEvent, ctx: PluginContext) => Promise<void>;
+        };
+    };
+    routes: {
+        admin: {
+            handler: (routeCtx: SandboxedRouteContext, ctx: PluginContext) => Promise<{
+                blocks: ({
+                    type: string;
+                    text: string;
+                    block_id?: undefined;
+                    fields?: undefined;
+                    submit?: undefined;
+                } | {
+                    text?: undefined;
+                    type: string;
+                    block_id?: undefined;
+                    fields?: undefined;
+                    submit?: undefined;
+                } | {
+                    text?: undefined;
+                    type: string;
+                    block_id: string;
+                    fields: ({
+                        type: string;
+                        action_id: string;
+                        label: string;
+                        initial_value: string;
+                        placeholder: string;
+                        min?: undefined;
+                        max?: undefined;
+                    } | {
+                        placeholder?: undefined;
+                        type: string;
+                        action_id: string;
+                        label: string;
+                        initial_value: number;
+                        min: number;
+                        max: number;
+                    } | {
+                        placeholder?: undefined;
+                        min?: undefined;
+                        max?: undefined;
+                        type: string;
+                        action_id: string;
+                        label: string;
+                        initial_value: string;
+                    })[];
+                    submit: {
+                        label: string;
+                        action_id: string;
+                    };
+                })[];
+            } | {
+                blocks: Record<string, unknown>[];
+            } | {
+                blocks: ({
+                    type: string;
+                    text: string;
+                    block_id?: undefined;
+                    fields?: undefined;
+                    submit?: undefined;
+                } | {
+                    text?: undefined;
+                    type: string;
+                    block_id?: undefined;
+                    fields?: undefined;
+                    submit?: undefined;
+                } | {
+                    text?: undefined;
+                    type: string;
+                    block_id: string;
+                    fields: ({
+                        type: string;
+                        action_id: string;
+                        label: string;
+                        initial_value: string;
+                        placeholder: string;
+                        min?: undefined;
+                        max?: undefined;
+                    } | {
+                        placeholder?: undefined;
+                        type: string;
+                        action_id: string;
+                        label: string;
+                        initial_value: number;
+                        min: number;
+                        max: number;
+                    } | {
+                        placeholder?: undefined;
+                        min?: undefined;
+                        max?: undefined;
+                        type: string;
+                        action_id: string;
+                        label: string;
+                        initial_value: string;
+                    })[];
+                    submit: {
+                        label: string;
+                        action_id: string;
+                    };
+                } | {
+                    type: string;
+                    title: string;
+                    description: string;
+                    variant: string;
+                })[];
+                toast: {
+                    message: string;
+                    type: string;
+                };
+            } | {
+                blocks: Record<string, unknown>[];
+                toast: {
+                    message: string;
+                    type: string;
+                };
+            }>;
+        };
+    };
+};
+export default _default;

package/{src/sandbox-entry.ts → dist/sandbox-entry.js}

@@ -1,20 +1,6 @@
-import type { SandboxedPlugin, SandboxedRouteContext, PluginContext, EmailDeliverEvent, LifecycleEvent } from "emdash/plugin";
+// src/sandbox-entry.ts
 import nodemailer from "nodemailer";
-import type { Transporter } from "nodemailer";
-import type { BlockInteraction } from "@emdash-cms/blocks";
-
-interface SesSettings {
-  smtpHost: string;
-  smtpPort: number;
-  smtpUser: string;
-  smtpPassword: string;
-  region: string;
-  defaultFrom: string;
-  fromName: string;
-  replyTo: string;
-}
-
-async function getSettings(ctx: PluginContext): Promise<SesSettings> {
+async function getSettings(ctx) {
   const defaults = {
     smtpHost: "email-smtp.us-east-1.amazonaws.com",
     smtpPort: 587,
@@ -23,20 +9,18 @@ async function getSettings(ctx: PluginContext): Promise<SesSettings> {
     fromName: "",
     replyTo: "",
     smtpUser: "",
-    smtpPassword: "",
+    smtpPassword: ""
   };
-
   const [smtpHost, smtpPortRaw, smtpUser, smtpPassword, region, defaultFrom, fromName, replyTo] = await Promise.all([
-    ctx.kv.get<string>("settings:smtpHost"),
-    ctx.kv.get<number>("settings:smtpPort"),
-    ctx.kv.get<string>("settings:smtpUser"),
-    ctx.kv.get<string>("settings:smtpPassword"),
-    ctx.kv.get<string>("settings:region"),
-    ctx.kv.get<string>("settings:defaultFrom"),
-    ctx.kv.get<string>("settings:fromName"),
-    ctx.kv.get<string>("settings:replyTo"),
+    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),
@@ -45,33 +29,30 @@ async function getSettings(ctx: PluginContext): Promise<SesSettings> {
     region: region ?? defaults.region,
     defaultFrom: defaultFrom ?? defaults.defaultFrom,
     fromName: fromName ?? defaults.fromName,
-    replyTo: replyTo ?? defaults.replyTo,
+    replyTo: replyTo ?? defaults.replyTo
   };
 }
-
-function createTransporter(settings: SesSettings): Transporter {
+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,
+      pass: settings.smtpPassword
     },
     tls: {
-      rejectUnauthorized: true,
+      rejectUnauthorized: true
     },
     requireTLS,
-    connectionTimeout: 10000,
-    greetingTimeout: 10000,
-    socketTimeout: 10000,
+    connectionTimeout: 1e4,
+    greetingTimeout: 1e4,
+    socketTimeout: 1e4
   });
 }
-
-async function validateSMTP(ctx: PluginContext): Promise<{ ok: boolean; error?: string }> {
+async function validateSMTP(ctx) {
   try {
     const settings = await getSettings(ctx);
     if (!settings.smtpHost || !settings.smtpUser || !settings.smtpPassword) {
@@ -85,8 +66,7 @@ async function validateSMTP(ctx: PluginContext): Promise<{ ok: boolean; error?:
     return { ok: false, error: `Connection failed: ${message}` };
   }
 }
-
-async function sendTestEmail(ctx: PluginContext, recipient: string): Promise<{ ok: boolean; error?: string }> {
+async function sendTestEmail(ctx, recipient) {
   try {
     const settings = await getSettings(ctx);
     if (!settings.defaultFrom) {
@@ -99,7 +79,7 @@ async function sendTestEmail(ctx: PluginContext, recipient: string): Promise<{ o
       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 || undefined,
+      replyTo: settings.replyTo || void 0
     });
     return { ok: true };
   } catch (err) {
@@ -107,10 +87,8 @@ async function sendTestEmail(ctx: PluginContext, recipient: string): Promise<{ o
     return { ok: false, error: `Send failed: ${message}` };
   }
 }
-
-async function renderSettingsPage(ctx: PluginContext) {
+async function renderSettingsPage(ctx) {
   const settings = await getSettings(ctx);
-
   return {
     blocks: [
       { type: "header", text: "AWS SES Settings" },
@@ -125,7 +103,7 @@ async function renderSettingsPage(ctx: PluginContext) {
             action_id: "smtpHost",
             label: "SMTP Host",
             initial_value: settings.smtpHost,
-            placeholder: "email-smtp.us-east-1.amazonaws.com",
+            placeholder: "email-smtp.us-east-1.amazonaws.com"
           },
           {
             type: "number_input",
@@ -133,73 +111,69 @@ async function renderSettingsPage(ctx: PluginContext) {
             label: "SMTP Port",
             initial_value: settings.smtpPort,
             min: 1,
-            max: 65535,
+            max: 65535
           },
           {
             type: "text_input",
             action_id: "smtpUser",
             label: "SMTP Username",
             initial_value: settings.smtpUser,
-            placeholder: "AWS SES SMTP username (IAM Access Key ID)",
+            placeholder: "AWS SES SMTP username (IAM Access Key ID)"
           },
           {
             type: "secret_input",
             action_id: "smtpPassword",
             label: "SMTP Password",
-            initial_value: "",
+            initial_value: ""
           },
           {
             type: "text_input",
             action_id: "region",
             label: "AWS Region",
             initial_value: settings.region,
-            placeholder: "us-east-1",
+            placeholder: "us-east-1"
           },
           {
             type: "text_input",
             action_id: "defaultFrom",
             label: "Default From Address",
             initial_value: settings.defaultFrom,
-            placeholder: "noreply@example.com",
+            placeholder: "noreply@example.com"
           },
           {
             type: "text_input",
             action_id: "fromName",
             label: "From Name",
             initial_value: settings.fromName,
-            placeholder: "My Site",
+            placeholder: "My Site"
           },
           {
             type: "text_input",
             action_id: "replyTo",
             label: "Reply-To Address",
             initial_value: settings.replyTo,
-            placeholder: "support@example.com",
-          },
+            placeholder: "support@example.com"
+          }
         ],
-        submit: { label: "Save Settings", action_id: "save_settings" },
+        submit: { label: "Save Settings", action_id: "save_settings" }
       },
       { type: "divider" },
       { type: "header", text: "Email Provider Activation" },
-      { type: "section", text: "To activate AWS SES as your active email provider, go to Settings > Email in the EmDash admin and select emdash-aws-ses from the list. This routes all EmDash email (magic links, invites, notifications) through AWS SES." },
-    ],
+      { type: "section", text: "To activate AWS SES as your active email provider, go to Settings > Email in the EmDash admin and select emdash-aws-ses from the list. This routes all EmDash email (magic links, invites, notifications) through AWS SES." }
+    ]
   };
 }
-
-function getDefaultEndpoint(region: string): string {
+function getDefaultEndpoint(region) {
   return `email-smtp.${region}.amazonaws.com`;
 }
-
-async function saveSettings(ctx: PluginContext, values: Record<string, unknown>) {
+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);
   }
@@ -225,38 +199,30 @@ async function saveSettings(ctx: PluginContext, values: Record<string, unknown>)
     await ctx.kv.set("settings:replyTo", values.replyTo);
   }
 }
-
-async function renderTestPage(
-  ctx: PluginContext,
-  validation?: { ok: boolean; error?: string } | null,
-  sendResult?: { ok: boolean; error?: string; recipient?: string } | null,
-) {
+async function renderTestPage(ctx, validation, sendResult) {
   const settings = await getSettings(ctx);
-
-  const blocks: Array<Record<string, unknown>> = [
+  const blocks = [
     { type: "header", text: "AWS SES Test & Status" },
     { type: "section", text: `Current endpoint: ${settings.smtpHost}:${settings.smtpPort} (${settings.region})` },
-    { type: "divider" },
+    { type: "divider" }
   ];
-
   if (validation) {
     if (validation.ok) {
       blocks.push({
         type: "banner",
         title: "Connection verified",
         description: "SMTP credentials are valid.",
-        variant: "default",
+        variant: "default"
       });
     } else {
       blocks.push({
         type: "banner",
         title: "Connection failed",
         description: validation.error,
-        variant: "error",
+        variant: "error"
       });
     }
   }
-
   blocks.push(
     { type: "section", text: "Test your SMTP connection and verify your credentials are correct." },
     {
@@ -265,33 +231,31 @@ async function renderTestPage(
         {
           type: "button",
           label: "Test Connection",
-          action_id: "validate",
-        },
-      ],
+          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." },
+    { 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",
+        variant: "default"
       });
     } else {
       blocks.push({
         type: "banner",
         title: "Email send failed",
         description: sendResult.error,
-        variant: "error",
+        variant: "error"
       });
     }
   }
-
   blocks.push({
     type: "form",
     block_id: "test_form",
@@ -301,57 +265,48 @@ async function renderTestPage(
         action_id: "recipient",
         label: "Recipient Email",
         placeholder: "you@example.com",
-        initial_value: sendResult?.ok ? "" : undefined,
-      },
+        initial_value: sendResult?.ok ? "" : void 0
+      }
     ],
-    submit: { label: "Send Test", action_id: "send_test" },
+    submit: { label: "Send Test", action_id: "send_test" }
   });
-
   return { blocks };
 }
-
-export default {
+var sandbox_entry_default = {
   hooks: {
-    "plugin:install": async (_event: LifecycleEvent, ctx: PluginContext) => {
+    "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 }: EmailDeliverEvent, ctx: PluginContext) => {
+      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 || undefined,
+          replyTo: settings.replyTo || void 0
         });
-
         ctx.log.info(`Email sent via AWS SES to ${message.to}`, { source });
-      },
-    },
+      }
+    }
   },
-
   routes: {
     admin: {
-      handler: async (routeCtx: SandboxedRouteContext, ctx: PluginContext) => {
-        const interaction = routeCtx.input as BlockInteraction;
-
+      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);
@@ -363,47 +318,42 @@ export default {
                 type: "banner",
                 title: "Settings saved",
                 description: "Your AWS SES configuration has been updated successfully.",
-                variant: "default",
+                variant: "default"
               },
-              ...settingsBlocks.slice(1),
+              ...settingsBlocks.slice(1)
             ],
-            toast: { message: "Settings saved successfully", type: "success" },
+            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" },
+            ...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 as string)?.trim();
+          const recipient = interaction.values?.recipient?.trim();
           if (!recipient) {
             return {
-              ...(await renderTestPage(ctx)),
-              toast: { message: "Please enter a recipient email", type: "error" },
+              ...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" },
+            ...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: [] };
-      },
-    },
-  },
-} satisfies SandboxedPlugin;
+      }
+    }
+  }
+};
+export {
+  sandbox_entry_default as default
+};

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "emdash-aws-ses",
-  "version": "1.0.2",
+  "version": "1.0.4",
   "description": "Amazon SES SMTP email transport plugin for EmDash CMS",
   "license": "MIT",
   "keywords": [
@@ -10,7 +10,18 @@
     "astro",
     "aws"
   ],
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/ab6162/emdash-aws-ses.git"
+  },
+  "bugs": {
+    "url": "https://github.com/ab6162/emdash-aws-ses/issues"
+  },
+  "homepage": "https://github.com/ab6162/emdash-aws-ses#readme",
   "type": "module",
+  "files": [
+    "dist"
+  ],
   "main": "./dist/index.cjs",
   "module": "./dist/index.js",
   "types": "./dist/index.d.ts",
@@ -27,7 +38,7 @@
     }
   },
   "scripts": {
-    "build": "tsup src/index.ts src/sandbox-entry.ts --format cjs,esm --clean"
+    "build": "tsup src/index.ts src/sandbox-entry.ts --format cjs,esm --clean && tsc --emitDeclarationOnly"
   },
   "peerDependencies": {
     "emdash": "^0.29.0"

package/.gitattributes

@@ -1,2 +0,0 @@
-# Auto detect text files and perform LF normalization
-* text=auto

package/tsconfig.json

@@ -1,14 +0,0 @@
-{
-  "compilerOptions": {
-    "target": "ES2022",
-    "module": "NodeNext",
-    "moduleResolution": "NodeNext",
-    "strict": true,
-    "noImplicitAny": false, // <--- Añade esto para silenciar los 'any' implícitos
-    "esModuleInterop": true,
-    "skipLibCheck": true,
-    "declaration": true,
-    "outDir": "./dist"
-  },
-  "include": ["src"]
-}