@nymbalhq/adapter-smtp 0.0.0-stage → 1.1.0

package/dist/index.d.ts

@@ -0,0 +1,21 @@
+import { Logger, EmailAdapter, AdapterContext } from '@nymbalhq/types';
+
+interface SmtpEmailAdapterConfig {
+    from?: string;
+    smtp?: {
+        host: string;
+        port: number;
+        user?: string;
+        pass?: string;
+        secure?: boolean;
+    };
+}
+declare function createSmtpEmailAdapter(deps: {
+    logger: Logger;
+    config?: SmtpEmailAdapterConfig;
+}): EmailAdapter;
+
+/** The kernel's entry: `email: { provider: 'smtp', config: SmtpEmailAdapterConfig }`. */
+declare function createAdapter(ctx: AdapterContext): EmailAdapter;
+
+export { type SmtpEmailAdapterConfig, createAdapter, createSmtpEmailAdapter };

package/dist/index.js

@@ -0,0 +1,89 @@
+// src/index.ts
+import { ConfigError } from "@nymbalhq/types";
+
+// src/smtp-adapter.ts
+import nodemailer from "nodemailer";
+import {
+  AdapterError,
+  EVT_CART_ABANDONED,
+  EVT_CUSTOMER_CREATED,
+  EVT_ORDER_PLACED,
+  EVT_ORDER_SHIPPED,
+  renderEmailTemplate
+} from "@nymbalhq/types";
+function createSmtpEmailAdapter(deps) {
+  const log = deps.logger.child({ adapter: "email", provider: "smtp" });
+  let cfg = deps.config ?? {};
+  let transporter = null;
+  function ensureTransport() {
+    if (transporter) return transporter;
+    if (!cfg.smtp) {
+      throw new AdapterError("email.misconfigured", "SMTP provider selected but smtp.host not set");
+    }
+    transporter = nodemailer.createTransport({
+      host: cfg.smtp.host,
+      port: cfg.smtp.port,
+      secure: cfg.smtp.secure ?? cfg.smtp.port === 465,
+      ...cfg.smtp.user !== void 0 && cfg.smtp.pass !== void 0 ? { auth: { user: cfg.smtp.user, pass: cfg.smtp.pass } } : {}
+    });
+    return transporter;
+  }
+  return {
+    kind: "email",
+    providerName: "smtp",
+    capabilities: () => ["transactional", "list-sync"],
+    producesEvents: [],
+    consumesEvents: [EVT_ORDER_PLACED, EVT_ORDER_SHIPPED, EVT_CUSTOMER_CREATED, EVT_CART_ABANDONED],
+    async initialize(rawConfig) {
+      cfg = { ...cfg, ...rawConfig };
+      ensureTransport();
+    },
+    async healthCheck() {
+      try {
+        await ensureTransport().verify();
+        return { status: "healthy", detail: "SMTP verified" };
+      } catch (err) {
+        return {
+          status: "degraded",
+          detail: `SMTP verify failed: ${err instanceof Error ? err.message : String(err)}`
+        };
+      }
+    },
+    async sendTransactional(params) {
+      const rendered = renderEmailTemplate(params.template, params.vars);
+      const info = await ensureTransport().sendMail({
+        from: cfg.from ?? "no-reply@nymbal.dev",
+        to: params.to,
+        subject: rendered.subject,
+        text: rendered.text,
+        html: rendered.html
+      });
+      return { messageId: info.messageId ?? null, accepted: (info.accepted ?? []).length > 0 };
+    },
+    async syncCustomerToList(customer) {
+      log.debug({ customerId: customer.customerId }, "email.syncCustomerToList (stub)");
+    },
+    async removeCustomerFromList(customerId) {
+      log.debug({ customerId }, "email.removeCustomerFromList (stub)");
+    }
+  };
+}
+
+// src/index.ts
+function createAdapter(ctx) {
+  if (ctx.slot !== "email") {
+    throw new ConfigError(`@nymbalhq/adapter-smtp serves email, not ${ctx.slot}`, {
+      code: "adapter.wrong_slot",
+      context: { slot: ctx.slot }
+    });
+  }
+  return createSmtpEmailAdapter({
+    logger: ctx.logger,
+    config: ctx.config
+  });
+}
+export {
+  createAdapter,
+  createSmtpEmailAdapter
+};
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/index.ts","../src/smtp-adapter.ts"],"sourcesContent":["import { ConfigError, type AdapterContext, type EmailAdapter } from '@nymbalhq/types'\nimport { createSmtpEmailAdapter, type SmtpEmailAdapterConfig } from './smtp-adapter.js'\n\nexport { createSmtpEmailAdapter, type SmtpEmailAdapterConfig }\n\n/** The kernel's entry: `email: { provider: 'smtp', config: SmtpEmailAdapterConfig }`. */\nexport function createAdapter(ctx: AdapterContext): EmailAdapter {\n  if (ctx.slot !== 'email') {\n    throw new ConfigError(`@nymbalhq/adapter-smtp serves email, not ${ctx.slot}`, {\n      code: 'adapter.wrong_slot',\n      context: { slot: ctx.slot },\n    })\n  }\n  return createSmtpEmailAdapter({\n    logger: ctx.logger,\n    config: ctx.config as SmtpEmailAdapterConfig,\n  })\n}\n","import nodemailer, { type Transporter } from 'nodemailer'\nimport {\n  AdapterError,\n  EVT_CART_ABANDONED,\n  EVT_CUSTOMER_CREATED,\n  EVT_ORDER_PLACED,\n  EVT_ORDER_SHIPPED,\n  renderEmailTemplate,\n  type CustomerProfile,\n  type EmailAdapter,\n  type Logger,\n  type TransactionalEmail,\n} from '@nymbalhq/types'\n\nexport interface SmtpEmailAdapterConfig {\n  from?: string\n  smtp?: {\n    host: string\n    port: number\n    user?: string\n    pass?: string\n    secure?: boolean\n  }\n}\n\nexport function createSmtpEmailAdapter(deps: {\n  logger: Logger\n  config?: SmtpEmailAdapterConfig\n}): EmailAdapter {\n  const log = deps.logger.child({ adapter: 'email', provider: 'smtp' })\n  let cfg: SmtpEmailAdapterConfig = deps.config ?? {}\n  let transporter: Transporter | null = null\n\n  function ensureTransport(): Transporter {\n    if (transporter) return transporter\n    if (!cfg.smtp) {\n      throw new AdapterError('email.misconfigured', 'SMTP provider selected but smtp.host not set')\n    }\n    transporter = nodemailer.createTransport({\n      host: cfg.smtp.host,\n      port: cfg.smtp.port,\n      secure: cfg.smtp.secure ?? cfg.smtp.port === 465,\n      ...(cfg.smtp.user !== undefined && cfg.smtp.pass !== undefined\n        ? { auth: { user: cfg.smtp.user, pass: cfg.smtp.pass } }\n        : {}),\n    })\n    return transporter\n  }\n\n  return {\n    kind: 'email',\n    providerName: 'smtp',\n    capabilities: () => ['transactional', 'list-sync'],\n    producesEvents: [],\n    consumesEvents: [EVT_ORDER_PLACED, EVT_ORDER_SHIPPED, EVT_CUSTOMER_CREATED, EVT_CART_ABANDONED],\n    async initialize(rawConfig) {\n      cfg = { ...cfg, ...(rawConfig as SmtpEmailAdapterConfig) }\n      ensureTransport()\n    },\n    async healthCheck() {\n      try {\n        await ensureTransport().verify()\n        return { status: 'healthy', detail: 'SMTP verified' }\n      } catch (err) {\n        return {\n          status: 'degraded',\n          detail: `SMTP verify failed: ${err instanceof Error ? err.message : String(err)}`,\n        }\n      }\n    },\n\n    async sendTransactional(params: TransactionalEmail) {\n      const rendered = renderEmailTemplate(params.template, params.vars)\n      const info = await ensureTransport().sendMail({\n        from: cfg.from ?? 'no-reply@nymbal.dev',\n        to: params.to,\n        subject: rendered.subject,\n        text: rendered.text,\n        html: rendered.html,\n      })\n      return { messageId: info.messageId ?? null, accepted: (info.accepted ?? []).length > 0 }\n    },\n\n    async syncCustomerToList(customer: CustomerProfile) {\n      log.debug({ customerId: customer.customerId }, 'email.syncCustomerToList (stub)')\n    },\n\n    async removeCustomerFromList(customerId: string) {\n      log.debug({ customerId }, 'email.removeCustomerFromList (stub)')\n    },\n  }\n}\n"],"mappings":";AAAA,SAAS,mBAA2D;;;ACApE,OAAO,gBAAsC;AAC7C;AAAA,EACE;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,OAKK;AAaA,SAAS,uBAAuB,MAGtB;AACf,QAAM,MAAM,KAAK,OAAO,MAAM,EAAE,SAAS,SAAS,UAAU,OAAO,CAAC;AACpE,MAAI,MAA8B,KAAK,UAAU,CAAC;AAClD,MAAI,cAAkC;AAEtC,WAAS,kBAA+B;AACtC,QAAI,YAAa,QAAO;AACxB,QAAI,CAAC,IAAI,MAAM;AACb,YAAM,IAAI,aAAa,uBAAuB,8CAA8C;AAAA,IAC9F;AACA,kBAAc,WAAW,gBAAgB;AAAA,MACvC,MAAM,IAAI,KAAK;AAAA,MACf,MAAM,IAAI,KAAK;AAAA,MACf,QAAQ,IAAI,KAAK,UAAU,IAAI,KAAK,SAAS;AAAA,MAC7C,GAAI,IAAI,KAAK,SAAS,UAAa,IAAI,KAAK,SAAS,SACjD,EAAE,MAAM,EAAE,MAAM,IAAI,KAAK,MAAM,MAAM,IAAI,KAAK,KAAK,EAAE,IACrD,CAAC;AAAA,IACP,CAAC;AACD,WAAO;AAAA,EACT;AAEA,SAAO;AAAA,IACL,MAAM;AAAA,IACN,cAAc;AAAA,IACd,cAAc,MAAM,CAAC,iBAAiB,WAAW;AAAA,IACjD,gBAAgB,CAAC;AAAA,IACjB,gBAAgB,CAAC,kBAAkB,mBAAmB,sBAAsB,kBAAkB;AAAA,IAC9F,MAAM,WAAW,WAAW;AAC1B,YAAM,EAAE,GAAG,KAAK,GAAI,UAAqC;AACzD,sBAAgB;AAAA,IAClB;AAAA,IACA,MAAM,cAAc;AAClB,UAAI;AACF,cAAM,gBAAgB,EAAE,OAAO;AAC/B,eAAO,EAAE,QAAQ,WAAW,QAAQ,gBAAgB;AAAA,MACtD,SAAS,KAAK;AACZ,eAAO;AAAA,UACL,QAAQ;AAAA,UACR,QAAQ,uBAAuB,eAAe,QAAQ,IAAI,UAAU,OAAO,GAAG,CAAC;AAAA,QACjF;AAAA,MACF;AAAA,IACF;AAAA,IAEA,MAAM,kBAAkB,QAA4B;AAClD,YAAM,WAAW,oBAAoB,OAAO,UAAU,OAAO,IAAI;AACjE,YAAM,OAAO,MAAM,gBAAgB,EAAE,SAAS;AAAA,QAC5C,MAAM,IAAI,QAAQ;AAAA,QAClB,IAAI,OAAO;AAAA,QACX,SAAS,SAAS;AAAA,QAClB,MAAM,SAAS;AAAA,QACf,MAAM,SAAS;AAAA,MACjB,CAAC;AACD,aAAO,EAAE,WAAW,KAAK,aAAa,MAAM,WAAW,KAAK,YAAY,CAAC,GAAG,SAAS,EAAE;AAAA,IACzF;AAAA,IAEA,MAAM,mBAAmB,UAA2B;AAClD,UAAI,MAAM,EAAE,YAAY,SAAS,WAAW,GAAG,iCAAiC;AAAA,IAClF;AAAA,IAEA,MAAM,uBAAuB,YAAoB;AAC/C,UAAI,MAAM,EAAE,WAAW,GAAG,qCAAqC;AAAA,IACjE;AAAA,EACF;AACF;;;ADrFO,SAAS,cAAc,KAAmC;AAC/D,MAAI,IAAI,SAAS,SAAS;AACxB,UAAM,IAAI,YAAY,4CAA4C,IAAI,IAAI,IAAI;AAAA,MAC5E,MAAM;AAAA,MACN,SAAS,EAAE,MAAM,IAAI,KAAK;AAAA,IAC5B,CAAC;AAAA,EACH;AACA,SAAO,uBAAuB;AAAA,IAC5B,QAAQ,IAAI;AAAA,IACZ,QAAQ,IAAI;AAAA,EACd,CAAC;AACH;","names":[]}

package/package.json

@@ -1,6 +1,47 @@
 {
   "name": "@nymbalhq/adapter-smtp",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
+  "version": "1.1.0",
+  "description": "SMTP email for Nymbal: the `smtp` email provider (nodemailer)",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/nymbalhq/nymbal.git",
+    "directory": "packages/adapter-smtp"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "type": "module",
+  "engines": {
+    "node": ">=22"
+  },
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    }
+  },
+  "files": [
+    "dist"
+  ],
+  "dependencies": {
+    "@nymbalhq/types": "1.1.0"
+  },
+  "peerDependencies": {
+    "nodemailer": "^6.9.16"
+  },
+  "devDependencies": {
+    "@types/nodemailer": "^6.4.17",
+    "nodemailer": "^6.9.16",
+    "tsup": "^8.3.5",
+    "typescript": "^5.6.3",
+    "vitest": "^3.0.0"
+  },
+  "scripts": {
+    "build": "tsup",
+    "dev": "tsup --watch",
+    "typecheck": "tsc -p tsconfig.json --noEmit"
+  }
 }

package/README.md

@@ -1,3 +0,0 @@
-# Temporary Holding Version
-
-This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.