@masonjames/emdash-smtp-marketplace 0.1.0

package/CHANGELOG.md

@@ -0,0 +1,8 @@
+# Changelog
+
+## 0.1.0
+
+- Initial marketplace-safe EmDash SMTP release
+- HTTP API and OAuth-capable provider coverage for the marketplace-safe EmDash SMTP package
+- Block Kit admin UI for provider configuration, testing, and delivery logs
+- Ready for `emdash plugin bundle` and `emdash plugin publish`

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,62 @@
+# `@masonjames/emdash-smtp-marketplace`
+
+Marketplace-safe EmDash SMTP plugin package.
+
+This package is designed for `emdash plugin bundle` / `emdash plugin publish` and for sandbox-compatible installs where delivery happens through HTTP API and OAuth-based providers. It publishes the same EmDash SMTP plugin identity (`emdash-smtp`) in standard/sandboxed form.
+
+## Includes
+
+- marketplace-safe standard plugin descriptor
+- sandbox entrypoint for EmDash marketplace bundles
+- Block Kit admin pages for provider settings and delivery logs
+- HTTP API and OAuth-capable provider coverage for the sandbox-safe EmDash SMTP package
+
+## Direct config install
+
+```bash
+pnpm add @masonjames/emdash-smtp-marketplace
+```
+
+```ts
+import { defineConfig } from "astro/config";
+import emdash from "emdash/astro";
+import { emdashSmtpMarketplace } from "@masonjames/emdash-smtp-marketplace";
+
+export default defineConfig({
+  integrations: [
+    emdash({
+      sandboxRunner: "@emdash-cms/cloudflare/sandbox",
+      sandboxed: [emdashSmtpMarketplace()],
+    }),
+  ],
+});
+```
+
+## Marketplace publishing
+
+Run these commands from the repo root:
+
+```bash
+pnpm validate:marketplace
+pnpm bundle:marketplace
+pnpm publish:marketplace
+```
+
+That flow ultimately uses `emdash plugin publish --build` for `packages/emdash-smtp-marketplace`.
+
+## Limits of the sandbox variant
+
+The marketplace-safe package intentionally excludes trusted-only transports:
+
+- Generic SMTP
+- local sendmail / PHP mail analogue
+
+Use `@masonjames/emdash-smtp` instead when those transports are required.
+
+## Plugin ID
+
+The marketplace distribution uses the same EmDash plugin ID as the trusted package:
+
+- `emdash-smtp`
+
+Do not install both variants on the same site at the same time.

package/dist/index.d.mts

@@ -0,0 +1,8 @@
+import { PluginDescriptor } from "emdash";
+
+//#region src/index.d.ts
+declare const SMTP_MARKETPLACE_PLUGIN_ID = "emdash-smtp";
+declare function emdashSmtpMarketplace(): PluginDescriptor;
+//#endregion
+export { SMTP_MARKETPLACE_PLUGIN_ID, emdashSmtpMarketplace };
+//# 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":";;;cAUa,0BAAA;AAAA,iBAEG,qBAAA,CAAA,GAAyB,gBAAA"}

package/dist/index.mjs

@@ -0,0 +1,26 @@
+import { SMTP_ADMIN_PAGES, SMTP_ADMIN_WIDGETS, SMTP_PLUGIN_ID, SMTP_PLUGIN_VERSION, collectAllowedHosts } from "@masonjames/emdash-smtp-core";
+
+//#region src/index.ts
+const SMTP_MARKETPLACE_PLUGIN_ID = SMTP_PLUGIN_ID;
+function emdashSmtpMarketplace() {
+	return {
+		id: SMTP_MARKETPLACE_PLUGIN_ID,
+		version: SMTP_PLUGIN_VERSION,
+		format: "standard",
+		entrypoint: "@masonjames/emdash-smtp-marketplace/sandbox",
+		capabilities: ["email:provide", "network:fetch"],
+		allowedHosts: collectAllowedHosts("marketplace"),
+		storage: { deliveryLogs: { indexes: [
+			"providerId",
+			"status",
+			"createdAt",
+			"source"
+		] } },
+		adminPages: [...SMTP_ADMIN_PAGES],
+		adminWidgets: [...SMTP_ADMIN_WIDGETS]
+	};
+}
+
+//#endregion
+export { SMTP_MARKETPLACE_PLUGIN_ID, emdashSmtpMarketplace };
+//# 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 const SMTP_MARKETPLACE_PLUGIN_ID = SMTP_PLUGIN_ID;\n\nexport function emdashSmtpMarketplace(): PluginDescriptor {\n\treturn {\n\t\tid: SMTP_MARKETPLACE_PLUGIN_ID,\n\t\tversion: SMTP_PLUGIN_VERSION,\n\t\tformat: \"standard\",\n\t\tentrypoint: \"@masonjames/emdash-smtp-marketplace/sandbox\",\n\t\tcapabilities: [\"email:provide\", \"network:fetch\"],\n\t\tallowedHosts: collectAllowedHosts(\"marketplace\"),\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"],"mappings":";;;AAUA,MAAa,6BAA6B;AAE1C,SAAgB,wBAA0C;AACzD,QAAO;EACN,IAAI;EACJ,SAAS;EACT,QAAQ;EACR,YAAY;EACZ,cAAc,CAAC,iBAAiB,gBAAgB;EAChD,cAAc,oBAAoB,cAAc;EAChD,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/sandbox-entry.d.mts

@@ -0,0 +1,7 @@
+import * as emdash from "emdash";
+
+//#region src/sandbox-entry.d.ts
+declare const _default: emdash.StandardPluginDefinition;
+//#endregion
+export { _default as default };
+//# sourceMappingURL=sandbox-entry.d.mts.map

package/dist/sandbox-entry.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sandbox-entry.d.mts","names":[],"sources":["../src/sandbox-entry.ts"],"mappings":""}

package/dist/sandbox-entry.mjs

@@ -0,0 +1,72 @@
+import { createDeliveryLogRecord, deliverWithConfiguredProvider, handleAdminInteraction, isDeliveryReady, writeDeliveryLog } from "@masonjames/emdash-smtp-core";
+import { definePlugin } from "emdash";
+
+//#region src/sandbox-entry.ts
+function createMarketplaceRuntime(ctx) {
+	return {
+		variant: "marketplace",
+		fetch: ctx.http ? (url, init) => ctx.http.fetch(url, init) : void 0
+	};
+}
+var sandbox_entry_default = definePlugin({
+	hooks: {
+		"email:deliver": {
+			exclusive: true,
+			handler: async (event, ctx) => {
+				const source = event.source || ctx.plugin.id;
+				try {
+					const result = await deliverWithConfiguredProvider({
+						ctx,
+						runtime: createMarketplaceRuntime(ctx),
+						message: event.message,
+						source
+					});
+					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
+					}));
+				} catch (error) {
+					const err = error instanceof Error ? error : new Error(String(error));
+					await writeDeliveryLog(ctx, createDeliveryLogRecord({
+						providerId: "unknown",
+						status: "failed",
+						message: {
+							to: event.message.to,
+							subject: event.message.subject
+						},
+						source,
+						durationMs: 0,
+						errorMessage: err.message
+					}));
+					throw err;
+				}
+			}
+		},
+		"email:status": { handler: async (_event, ctx) => isDeliveryReady({
+			ctx,
+			runtime: createMarketplaceRuntime(ctx)
+		}) }
+	},
+	routes: { admin: { handler: (async (routeCtx, ctx) => {
+		return handleAdminInteraction({
+			ctx,
+			variant: "marketplace",
+			runtime: createMarketplaceRuntime(ctx),
+			interaction: routeCtx.input ?? {
+				type: "page_load",
+				page: "/providers"
+			}
+		});
+	}) } }
+});
+
+//#endregion
+export { sandbox_entry_default as default };
+//# sourceMappingURL=sandbox-entry.mjs.map

package/dist/sandbox-entry.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"sandbox-entry.mjs","names":[],"sources":["../src/sandbox-entry.ts"],"sourcesContent":["import { definePlugin } from \"emdash\";\nimport type { PluginContext } from \"emdash\";\n\nimport {\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\";\n\nfunction createMarketplaceRuntime(ctx: PluginContext): DeliveryRuntime {\n\treturn {\n\t\tvariant: \"marketplace\",\n\t\tfetch: ctx.http ? (url, init) => ctx.http!.fetch(url, init) : undefined,\n\t};\n}\n\ninterface MarketplaceEmailDeliverEvent {\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\nexport default definePlugin({\n\thooks: {\n\t\t\"email:deliver\": {\n\t\t\texclusive: true,\n\t\t\thandler: async (event: MarketplaceEmailDeliverEvent, ctx: PluginContext) => {\n\t\t\t\tconst source = event.source || ctx.plugin.id;\n\t\t\t\ttry {\n\t\t\t\t\tconst result = await deliverWithConfiguredProvider({\n\t\t\t\t\t\tctx: ctx as unknown as SmtpPluginContextLike,\n\t\t\t\t\t\truntime: createMarketplaceRuntime(ctx),\n\t\t\t\t\t\tmessage: event.message,\n\t\t\t\t\t\tsource,\n\t\t\t\t\t});\n\t\t\t\t\tawait writeDeliveryLog(\n\t\t\t\t\t\tctx as unknown as SmtpPluginContextLike,\n\t\t\t\t\t\tcreateDeliveryLogRecord({\n\t\t\t\t\t\t\tproviderId: result.providerId,\n\t\t\t\t\t\t\tstatus: \"sent\",\n\t\t\t\t\t\t\tmessage: {\n\t\t\t\t\t\t\t\tto: event.message.to,\n\t\t\t\t\t\t\t\tsubject: event.message.subject,\n\t\t\t\t\t\t\t},\n\t\t\t\t\t\t\tsource,\n\t\t\t\t\t\t\tdurationMs: result.durationMs,\n\t\t\t\t\t\t\tremoteMessageId: result.remoteMessageId,\n\t\t\t\t\t\t}),\n\t\t\t\t\t);\n\t\t\t\t} catch (error) {\n\t\t\t\t\tconst err = error instanceof Error ? error : new Error(String(error));\n\t\t\t\t\tawait writeDeliveryLog(\n\t\t\t\t\t\tctx as unknown as SmtpPluginContextLike,\n\t\t\t\t\t\tcreateDeliveryLogRecord({\n\t\t\t\t\t\t\tproviderId: \"unknown\",\n\t\t\t\t\t\t\tstatus: \"failed\",\n\t\t\t\t\t\t\tmessage: {\n\t\t\t\t\t\t\t\tto: event.message.to,\n\t\t\t\t\t\t\t\tsubject: event.message.subject,\n\t\t\t\t\t\t\t},\n\t\t\t\t\t\t\tsource,\n\t\t\t\t\t\t\tdurationMs: 0,\n\t\t\t\t\t\t\terrorMessage: err.message,\n\t\t\t\t\t\t}),\n\t\t\t\t\t);\n\t\t\t\t\tthrow err;\n\t\t\t\t}\n\t\t\t},\n\t\t},\n\t\t\"email:status\": {\n\t\t\thandler: async (_event: unknown, ctx: PluginContext) =>\n\t\t\t\tisDeliveryReady({\n\t\t\t\t\tctx: ctx as unknown as SmtpPluginContextLike,\n\t\t\t\t\truntime: createMarketplaceRuntime(ctx),\n\t\t\t\t}),\n\t\t},\n\t},\n\troutes: {\n\t\tadmin: {\n\t\t\thandler: (async (\n\t\t\t\trouteCtx: { input: unknown; request: unknown },\n\t\t\t\tctx: PluginContext,\n\t\t\t) => {\n\t\t\t\treturn handleAdminInteraction({\n\t\t\t\t\tctx: ctx as unknown as SmtpPluginContextLike,\n\t\t\t\t\tvariant: \"marketplace\",\n\t\t\t\t\truntime: createMarketplaceRuntime(ctx),\n\t\t\t\t\tinteraction: (routeCtx.input ?? { type: \"page_load\", page: \"/providers\" }) as AdminInteraction,\n\t\t\t\t});\n\t\t\t}) as never,\n\t\t},\n\t},\n});\n"],"mappings":";;;;AAkBA,SAAS,yBAAyB,KAAqC;AACtE,QAAO;EACN,SAAS;EACT,OAAO,IAAI,QAAQ,KAAK,SAAS,IAAI,KAAM,MAAM,KAAK,KAAK,GAAG;EAC9D;;AAaF,4BAAe,aAAa;CAC3B,OAAO;EACN,iBAAiB;GAChB,WAAW;GACX,SAAS,OAAO,OAAqC,QAAuB;IAC3E,MAAM,SAAS,MAAM,UAAU,IAAI,OAAO;AAC1C,QAAI;KACH,MAAM,SAAS,MAAM,8BAA8B;MAC7C;MACL,SAAS,yBAAyB,IAAI;MACtC,SAAS,MAAM;MACf;MACA,CAAC;AACF,WAAM,iBACL,KACA,wBAAwB;MACvB,YAAY,OAAO;MACnB,QAAQ;MACR,SAAS;OACR,IAAI,MAAM,QAAQ;OAClB,SAAS,MAAM,QAAQ;OACvB;MACD;MACA,YAAY,OAAO;MACnB,iBAAiB,OAAO;MACxB,CAAC,CACF;aACO,OAAO;KACf,MAAM,MAAM,iBAAiB,QAAQ,QAAQ,IAAI,MAAM,OAAO,MAAM,CAAC;AACrE,WAAM,iBACL,KACA,wBAAwB;MACvB,YAAY;MACZ,QAAQ;MACR,SAAS;OACR,IAAI,MAAM,QAAQ;OAClB,SAAS,MAAM,QAAQ;OACvB;MACD;MACA,YAAY;MACZ,cAAc,IAAI;MAClB,CAAC,CACF;AACD,WAAM;;;GAGR;EACD,gBAAgB,EACf,SAAS,OAAO,QAAiB,QAChC,gBAAgB;GACV;GACL,SAAS,yBAAyB,IAAI;GACtC,CAAC,EACH;EACD;CACD,QAAQ,EACP,OAAO,EACN,UAAU,OACT,UACA,QACI;AACJ,SAAO,uBAAuB;GACxB;GACL,SAAS;GACT,SAAS,yBAAyB,IAAI;GACtC,aAAc,SAAS,SAAS;IAAE,MAAM;IAAa,MAAM;IAAc;GACzE,CAAC;KAEH,EACD;CACD,CAAC"}

package/package.json

@@ -0,0 +1,57 @@
+{
+  "name": "@masonjames/emdash-smtp-marketplace",
+  "version": "0.1.0",
+  "description": "Marketplace-safe 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"
+    },
+    "./sandbox": {
+      "import": "./dist/sandbox-entry.mjs",
+      "types": "./dist/sandbox-entry.d.mts"
+    }
+  },
+  "files": [
+    "dist",
+    "README.md",
+    "CHANGELOG.md",
+    "icon.png",
+    "screenshots"
+  ],
+  "keywords": [
+    "emdash",
+    "emdash-plugin",
+    "marketplace",
+    "smtp",
+    "email"
+  ],
+  "author": "Mason James",
+  "dependencies": {
+    "@masonjames/emdash-smtp-core": "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-marketplace"
+  },
+  "homepage": "https://github.com/masonjames/emdash-smtp#readme",
+  "bugs": {
+    "url": "https://github.com/masonjames/emdash-smtp/issues"
+  },
+  "scripts": {
+    "build": "tsdown src/index.ts src/sandbox-entry.ts --format esm --dts --clean",
+    "test": "vitest run",
+    "typecheck": "tsc --noEmit -p tsconfig.json"
+  }
+}