@masonjames/emdash-smtp 0.1.0

package/CHANGELOG.md

@@ -0,0 +1,8 @@
+# Changelog
+
+## 0.1.0
+
+- Initial trusted EmDash SMTP release
+- Full EmDash SMTP provider coverage, including generic SMTP and local sendmail
+- Block Kit admin pages for provider configuration and delivery logs
+- Shared provider catalog with fallback delivery support

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Mason James
+
+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,55 @@
+# `@masonjames/emdash-smtp`
+
+Trusted installation of the EmDash SMTP plugin family.
+
+Use this package when you need the full EmDash SMTP feature set, including transports that cannot run in the EmDash marketplace sandbox.
+
+## Includes
+
+- full shared provider catalog
+- generic SMTP
+- provider-specific SMTP-style setups where a raw transport is required
+- local sendmail / PHP mail analogue
+- Block Kit admin pages for providers and logs
+- delivery fallback support
+
+## Install
+
+```bash
+pnpm add @masonjames/emdash-smtp
+```
+
+## Register in `astro.config.mjs`
+
+```ts
+import { defineConfig } from "astro/config";
+import emdash from "emdash/astro";
+import { emdashSmtp } from "@masonjames/emdash-smtp";
+
+export default defineConfig({
+  integrations: [
+    emdash({
+      plugins: [emdashSmtp()],
+    }),
+  ],
+});
+```
+
+## When to use this package
+
+Choose the trusted package if you need any of the following:
+
+- Generic SMTP
+- local sendmail delivery
+- maximum provider compatibility on Node deployments
+- first-party control via npm and source review
+
+## Do not install both variants together
+
+Choose one runtime path per site:
+
+- `@masonjames/emdash-smtp` for trusted/npm installs
+- `@masonjames/emdash-smtp-marketplace` for marketplace or sandbox installs
+- both distributions identify as `emdash-smtp` inside EmDash
+
+If you need a user-installable marketplace listing and a first-party npm install path, publish both packages as a split pair.

package/dist/index.d.mts

@@ -0,0 +1,10 @@
+import { PluginDescriptor } from "emdash";
+
+//#region src/index.d.ts
+interface EmdashSmtpOptions {
+  label?: string;
+}
+declare function emdashSmtp(options?: EmdashSmtpOptions): PluginDescriptor<EmdashSmtpOptions>;
+//#endregion
+export { EmdashSmtpOptions, emdashSmtp as default, emdashSmtp };
+//# sourceMappingURL=index.d.mts.map

package/dist/index.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.mts","names":[],"sources":["../src/index.ts"],"mappings":";;;UAUiB,iBAAA;EAChB,KAAA;AAAA;AAAA,iBAGe,UAAA,CAAW,OAAA,GAAS,iBAAA,GAAyB,gBAAA,CAAiB,iBAAA"}

package/dist/index.mjs

@@ -0,0 +1,25 @@
+import { SMTP_ADMIN_PAGES, SMTP_ADMIN_WIDGETS, SMTP_PLUGIN_ID, SMTP_PLUGIN_VERSION, collectAllowedHosts } from "@masonjames/emdash-smtp-core";
+
+//#region src/index.ts
+function emdashSmtp(options = {}) {
+	return {
+		id: SMTP_PLUGIN_ID,
+		version: SMTP_PLUGIN_VERSION,
+		entrypoint: "@masonjames/emdash-smtp/plugin",
+		options,
+		capabilities: ["email:provide", "network:fetch"],
+		allowedHosts: collectAllowedHosts("trusted"),
+		storage: { deliveryLogs: { indexes: [
+			"providerId",
+			"status",
+			"createdAt",
+			"source"
+		] } },
+		adminPages: [...SMTP_ADMIN_PAGES],
+		adminWidgets: [...SMTP_ADMIN_WIDGETS]
+	};
+}
+
+//#endregion
+export { emdashSmtp as default, emdashSmtp };
+//# sourceMappingURL=index.mjs.map

package/dist/index.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.mjs","names":[],"sources":["../src/index.ts"],"sourcesContent":["import type { PluginDescriptor } from \"emdash\";\n\nimport {\n\tcollectAllowedHosts,\n\tSMTP_ADMIN_PAGES,\n\tSMTP_ADMIN_WIDGETS,\n\tSMTP_PLUGIN_ID,\n\tSMTP_PLUGIN_VERSION,\n} from \"@masonjames/emdash-smtp-core\";\n\nexport interface EmdashSmtpOptions {\n\tlabel?: string;\n}\n\nexport function emdashSmtp(options: EmdashSmtpOptions = {}): PluginDescriptor<EmdashSmtpOptions> {\n\treturn {\n\t\tid: SMTP_PLUGIN_ID,\n\t\tversion: SMTP_PLUGIN_VERSION,\n\t\tentrypoint: \"@masonjames/emdash-smtp/plugin\",\n\t\toptions,\n\t\tcapabilities: [\"email:provide\", \"network:fetch\"],\n\t\tallowedHosts: collectAllowedHosts(\"trusted\"),\n\t\tstorage: {\n\t\t\tdeliveryLogs: {\n\t\t\t\tindexes: [\"providerId\", \"status\", \"createdAt\", \"source\"],\n\t\t\t},\n\t\t},\n\t\tadminPages: [...SMTP_ADMIN_PAGES],\n\t\tadminWidgets: [...SMTP_ADMIN_WIDGETS],\n\t};\n}\n\nexport default emdashSmtp;\n"],"mappings":";;;AAcA,SAAgB,WAAW,UAA6B,EAAE,EAAuC;AAChG,QAAO;EACN,IAAI;EACJ,SAAS;EACT,YAAY;EACZ;EACA,cAAc,CAAC,iBAAiB,gBAAgB;EAChD,cAAc,oBAAoB,UAAU;EAC5C,SAAS,EACR,cAAc,EACb,SAAS;GAAC;GAAc;GAAU;GAAa;GAAS,EACxD,EACD;EACD,YAAY,CAAC,GAAG,iBAAiB;EACjC,cAAc,CAAC,GAAG,mBAAmB;EACrC"}

package/dist/plugin.d.mts

@@ -0,0 +1,7 @@
+import { ResolvedPlugin } from "emdash";
+
+//#region src/plugin.d.ts
+declare function createPlugin(): ResolvedPlugin;
+//#endregion
+export { createPlugin, createPlugin as default };
+//# sourceMappingURL=plugin.d.mts.map

package/dist/plugin.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"plugin.d.mts","names":[],"sources":["../src/plugin.ts"],"mappings":";;;iBAmFgB,YAAA,CAAA,GAAgB,cAAA"}

package/dist/plugin.mjs

@@ -0,0 +1,96 @@
+import { SMTP_ADMIN_PAGES, SMTP_ADMIN_WIDGETS, SMTP_PLUGIN_ID, SMTP_PLUGIN_VERSION, collectAllowedHosts, createDeliveryLogRecord, deliverWithConfiguredProvider, handleAdminInteraction, isDeliveryReady, writeDeliveryLog } from "@masonjames/emdash-smtp-core";
+import { definePlugin } from "emdash";
+import { sendmailSend, smtpSend } from "@masonjames/emdash-smtp-node-transports";
+
+//#region src/plugin.ts
+function createTrustedRuntime(ctx) {
+	return {
+		variant: "trusted",
+		fetch: ctx.http ? (url, init) => ctx.http.fetch(url, init) : void 0,
+		smtpSend,
+		sendmailSend
+	};
+}
+async function logSuccessfulDelivery(ctx, event, source, result) {
+	await writeDeliveryLog(ctx, createDeliveryLogRecord({
+		providerId: result.providerId,
+		status: "sent",
+		message: {
+			to: event.message.to,
+			subject: event.message.subject
+		},
+		source,
+		durationMs: result.durationMs,
+		remoteMessageId: result.remoteMessageId
+	}));
+}
+async function logFailedDelivery(ctx, event, source, error) {
+	await writeDeliveryLog(ctx, createDeliveryLogRecord({
+		providerId: "unknown",
+		status: "failed",
+		message: {
+			to: event.message.to,
+			subject: event.message.subject
+		},
+		source,
+		durationMs: 0,
+		errorMessage: error.message
+	}));
+}
+function createPlugin() {
+	return definePlugin({
+		id: SMTP_PLUGIN_ID,
+		version: SMTP_PLUGIN_VERSION,
+		capabilities: ["email:provide", "network:fetch"],
+		allowedHosts: collectAllowedHosts("trusted"),
+		storage: { deliveryLogs: { indexes: [
+			"providerId",
+			"status",
+			"createdAt",
+			"source"
+		] } },
+		admin: {
+			pages: [...SMTP_ADMIN_PAGES],
+			widgets: [...SMTP_ADMIN_WIDGETS]
+		},
+		hooks: {
+			"email:deliver": {
+				exclusive: true,
+				handler: async (event, ctx) => {
+					const source = event.source || ctx.plugin.id;
+					try {
+						await logSuccessfulDelivery(ctx, event, source, await deliverWithConfiguredProvider({
+							ctx,
+							runtime: createTrustedRuntime(ctx),
+							message: event.message,
+							source
+						}));
+					} catch (error) {
+						const err = error instanceof Error ? error : new Error(String(error));
+						await logFailedDelivery(ctx, event, source, err);
+						throw err;
+					}
+				}
+			},
+			"email:status": { handler: async (_event, ctx) => isDeliveryReady({
+				ctx,
+				runtime: createTrustedRuntime(ctx)
+			}) }
+		},
+		routes: { admin: { handler: (async (routeCtx, ctx) => {
+			return handleAdminInteraction({
+				ctx,
+				variant: "trusted",
+				runtime: createTrustedRuntime(ctx),
+				interaction: routeCtx.input ?? {
+					type: "page_load",
+					page: "/providers"
+				}
+			});
+		}) } }
+	});
+}
+
+//#endregion
+export { createPlugin, createPlugin as default };
+//# sourceMappingURL=plugin.mjs.map

package/dist/plugin.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"plugin.mjs","names":[],"sources":["../src/plugin.ts"],"sourcesContent":["import { definePlugin } from \"emdash\";\nimport type { PluginContext, ResolvedPlugin } from \"emdash\";\n\nimport {\n\tcollectAllowedHosts,\n\tcreateDeliveryLogRecord,\n\tdeliverWithConfiguredProvider,\n\thandleAdminInteraction,\n\tisDeliveryReady,\n\tSMTP_ADMIN_PAGES,\n\tSMTP_ADMIN_WIDGETS,\n\tSMTP_PLUGIN_ID,\n\tSMTP_PLUGIN_VERSION,\n\ttype AdminInteraction,\n\ttype DeliveryRuntime,\n\ttype SmtpPluginContextLike,\n\twriteDeliveryLog,\n} from \"@masonjames/emdash-smtp-core\";\nimport { sendmailSend, smtpSend } from \"@masonjames/emdash-smtp-node-transports\";\n\nfunction createTrustedRuntime(ctx: PluginContext): DeliveryRuntime {\n\treturn {\n\t\tvariant: \"trusted\",\n\t\tfetch: ctx.http ? (url, init) => ctx.http!.fetch(url, init) : undefined,\n\t\tsmtpSend,\n\t\tsendmailSend,\n\t};\n}\n\ninterface TrustedEmailDeliverEvent {\n\tmessage: {\n\t\tto: string;\n\t\tsubject: string;\n\t\ttext: string;\n\t\thtml?: string;\n\t};\n\tsource: string;\n}\n\nasync function logSuccessfulDelivery(\n\tctx: SmtpPluginContextLike,\n\tevent: TrustedEmailDeliverEvent,\n\tsource: string,\n\tresult: Awaited<ReturnType<typeof deliverWithConfiguredProvider>>,\n): Promise<void> {\n\tawait writeDeliveryLog(\n\t\tctx,\n\t\tcreateDeliveryLogRecord({\n\t\t\tproviderId: result.providerId,\n\t\t\tstatus: \"sent\",\n\t\t\tmessage: {\n\t\t\t\tto: event.message.to,\n\t\t\t\tsubject: event.message.subject,\n\t\t\t},\n\t\t\tsource,\n\t\t\tdurationMs: result.durationMs,\n\t\t\tremoteMessageId: result.remoteMessageId,\n\t\t}),\n\t);\n}\n\nasync function logFailedDelivery(\n\tctx: SmtpPluginContextLike,\n\tevent: TrustedEmailDeliverEvent,\n\tsource: string,\n\terror: Error,\n): Promise<void> {\n\tawait writeDeliveryLog(\n\t\tctx,\n\t\tcreateDeliveryLogRecord({\n\t\t\tproviderId: \"unknown\",\n\t\t\tstatus: \"failed\",\n\t\t\tmessage: {\n\t\t\t\tto: event.message.to,\n\t\t\t\tsubject: event.message.subject,\n\t\t\t},\n\t\t\tsource,\n\t\t\tdurationMs: 0,\n\t\t\terrorMessage: error.message,\n\t\t}),\n\t);\n}\n\nexport function createPlugin(): ResolvedPlugin {\n\treturn definePlugin({\n\t\tid: SMTP_PLUGIN_ID,\n\t\tversion: SMTP_PLUGIN_VERSION,\n\t\tcapabilities: [\"email:provide\", \"network:fetch\"],\n\t\tallowedHosts: collectAllowedHosts(\"trusted\"),\n\t\tstorage: {\n\t\t\tdeliveryLogs: {\n\t\t\t\tindexes: [\"providerId\", \"status\", \"createdAt\", \"source\"],\n\t\t\t},\n\t\t},\n\t\tadmin: {\n\t\t\tpages: [...SMTP_ADMIN_PAGES],\n\t\t\twidgets: [...SMTP_ADMIN_WIDGETS],\n\t\t},\n\t\thooks: {\n\t\t\t\"email:deliver\": {\n\t\t\t\texclusive: true,\n\t\t\t\thandler: async (event: TrustedEmailDeliverEvent, ctx: PluginContext) => {\n\t\t\t\t\tconst source = event.source || ctx.plugin.id;\n\t\t\t\t\ttry {\n\t\t\t\t\t\tconst result = await deliverWithConfiguredProvider({\n\t\t\t\t\t\t\tctx: ctx as unknown as SmtpPluginContextLike,\n\t\t\t\t\t\t\truntime: createTrustedRuntime(ctx),\n\t\t\t\t\t\t\tmessage: event.message,\n\t\t\t\t\t\t\tsource,\n\t\t\t\t\t\t});\n\t\t\t\t\t\tawait logSuccessfulDelivery(\n\t\t\t\t\t\t\tctx as unknown as SmtpPluginContextLike,\n\t\t\t\t\t\t\tevent,\n\t\t\t\t\t\t\tsource,\n\t\t\t\t\t\t\tresult,\n\t\t\t\t\t\t);\n\t\t\t\t\t} catch (error) {\n\t\t\t\t\t\tconst err = error instanceof Error ? error : new Error(String(error));\n\t\t\t\t\t\tawait logFailedDelivery(ctx as unknown as SmtpPluginContextLike, event, source, err);\n\t\t\t\t\t\tthrow err;\n\t\t\t\t\t}\n\t\t\t\t},\n\t\t\t},\n\t\t\t\"email:status\": {\n\t\t\t\thandler: async (_event: unknown, ctx: PluginContext) =>\n\t\t\t\t\tisDeliveryReady({\n\t\t\t\t\t\tctx: ctx as unknown as SmtpPluginContextLike,\n\t\t\t\t\t\truntime: createTrustedRuntime(ctx),\n\t\t\t\t\t}),\n\t\t\t},\n\t\t},\n\t\troutes: {\n\t\t\tadmin: {\n\t\t\t\thandler: (async (\n\t\t\t\t\trouteCtx: { input: unknown; request: unknown },\n\t\t\t\t\tctx: PluginContext,\n\t\t\t\t) => {\n\t\t\t\t\treturn handleAdminInteraction({\n\t\t\t\t\t\tctx: ctx as unknown as SmtpPluginContextLike,\n\t\t\t\t\t\tvariant: \"trusted\",\n\t\t\t\t\t\truntime: createTrustedRuntime(ctx),\n\t\t\t\t\t\tinteraction: (routeCtx.input ?? { type: \"page_load\", page: \"/providers\" }) as AdminInteraction,\n\t\t\t\t\t});\n\t\t\t\t}) as never,\n\t\t\t},\n\t\t},\n\t});\n}\n\nexport default createPlugin;\n"],"mappings":";;;;;AAoBA,SAAS,qBAAqB,KAAqC;AAClE,QAAO;EACN,SAAS;EACT,OAAO,IAAI,QAAQ,KAAK,SAAS,IAAI,KAAM,MAAM,KAAK,KAAK,GAAG;EAC9D;EACA;EACA;;AAaF,eAAe,sBACd,KACA,OACA,QACA,QACgB;AAChB,OAAM,iBACL,KACA,wBAAwB;EACvB,YAAY,OAAO;EACnB,QAAQ;EACR,SAAS;GACR,IAAI,MAAM,QAAQ;GAClB,SAAS,MAAM,QAAQ;GACvB;EACD;EACA,YAAY,OAAO;EACnB,iBAAiB,OAAO;EACxB,CAAC,CACF;;AAGF,eAAe,kBACd,KACA,OACA,QACA,OACgB;AAChB,OAAM,iBACL,KACA,wBAAwB;EACvB,YAAY;EACZ,QAAQ;EACR,SAAS;GACR,IAAI,MAAM,QAAQ;GAClB,SAAS,MAAM,QAAQ;GACvB;EACD;EACA,YAAY;EACZ,cAAc,MAAM;EACpB,CAAC,CACF;;AAGF,SAAgB,eAA+B;AAC9C,QAAO,aAAa;EACnB,IAAI;EACJ,SAAS;EACT,cAAc,CAAC,iBAAiB,gBAAgB;EAChD,cAAc,oBAAoB,UAAU;EAC5C,SAAS,EACR,cAAc,EACb,SAAS;GAAC;GAAc;GAAU;GAAa;GAAS,EACxD,EACD;EACD,OAAO;GACN,OAAO,CAAC,GAAG,iBAAiB;GAC5B,SAAS,CAAC,GAAG,mBAAmB;GAChC;EACD,OAAO;GACN,iBAAiB;IAChB,WAAW;IACX,SAAS,OAAO,OAAiC,QAAuB;KACvE,MAAM,SAAS,MAAM,UAAU,IAAI,OAAO;AAC1C,SAAI;AAOH,YAAM,sBACL,KACA,OACA,QATc,MAAM,8BAA8B;OAC7C;OACL,SAAS,qBAAqB,IAAI;OAClC,SAAS,MAAM;OACf;OACA,CAAC,CAMD;cACO,OAAO;MACf,MAAM,MAAM,iBAAiB,QAAQ,QAAQ,IAAI,MAAM,OAAO,MAAM,CAAC;AACrE,YAAM,kBAAkB,KAAyC,OAAO,QAAQ,IAAI;AACpF,YAAM;;;IAGR;GACD,gBAAgB,EACf,SAAS,OAAO,QAAiB,QAChC,gBAAgB;IACV;IACL,SAAS,qBAAqB,IAAI;IAClC,CAAC,EACH;GACD;EACD,QAAQ,EACP,OAAO,EACN,UAAU,OACT,UACA,QACI;AACJ,UAAO,uBAAuB;IACxB;IACL,SAAS;IACT,SAAS,qBAAqB,IAAI;IAClC,aAAc,SAAS,SAAS;KAAE,MAAM;KAAa,MAAM;KAAc;IACzE,CAAC;MAEH,EACD;EACD,CAAC"}

package/package.json

@@ -0,0 +1,56 @@
+{
+  "name": "@masonjames/emdash-smtp",
+  "version": "0.1.0",
+  "description": "Trusted full-parity SMTP and transactional email plugin for EmDash",
+  "type": "module",
+  "main": "dist/index.mjs",
+  "types": "dist/index.d.mts",
+  "exports": {
+    ".": {
+      "import": "./dist/index.mjs",
+      "types": "./dist/index.d.mts"
+    },
+    "./plugin": {
+      "import": "./dist/plugin.mjs",
+      "types": "./dist/plugin.d.mts"
+    }
+  },
+  "files": [
+    "dist",
+    "README.md",
+    "CHANGELOG.md"
+  ],
+  "keywords": [
+    "emdash",
+    "emdash-plugin",
+    "smtp",
+    "email",
+    "transactional-email"
+  ],
+  "author": "Mason James",
+  "dependencies": {
+    "@masonjames/emdash-smtp-core": "0.1.0",
+    "@masonjames/emdash-smtp-node-transports": "0.1.0"
+  },
+  "peerDependencies": {
+    "emdash": ">=0.1.0"
+  },
+  "license": "MIT",
+  "publishConfig": {
+    "access": "public"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/masonjames/emdash-smtp.git",
+    "directory": "packages/emdash-smtp"
+  },
+  "homepage": "https://github.com/masonjames/emdash-smtp#readme",
+  "bugs": {
+    "url": "https://github.com/masonjames/emdash-smtp/issues"
+  },
+  "scripts": {
+    "build": "tsdown src/index.ts src/plugin.ts --format esm --dts --clean",
+    "test": "vitest run",
+    "typecheck": "tsc --noEmit -p tsconfig.json"
+  }
+}