@open-mercato/shared 0.7.1-develop.7150.1.c1941e0c22 → 0.7.1-develop.7151.1.00d0391847

package/.turbo/turbo-build.log

@@ -1,2 +1,2 @@
-[build:shared] found 271 entry points
+[build:shared] found 272 entry points
 [build:shared] built successfully

package/dist/lib/email/config.js

@@ -1,3 +1,5 @@
+import { parseBooleanWithDefault } from "../boolean.js";
+import { getRegisteredEmailTransport } from "./transport.js";
 function normalizeEnvString(value) {
   if (typeof value !== "string") return void 0;
   const trimmed = value.trim();
@@ -6,7 +8,25 @@ function normalizeEnvString(value) {
 function resolveDefaultEmailFromAddress() {
   return normalizeEnvString(process.env.NOTIFICATIONS_EMAIL_FROM) || normalizeEnvString(process.env.EMAIL_FROM) || normalizeEnvString(process.env.ADMIN_EMAIL);
 }
+function isEmailDeliveryDisabled() {
+  const explicitlyDisabled = parseBooleanWithDefault(process.env.OM_DISABLE_EMAIL_DELIVERY, false);
+  if (explicitlyDisabled) return true;
+  const testMode = parseBooleanWithDefault(process.env.OM_TEST_MODE, false);
+  if (!testMode) return false;
+  const testCaptureDeliveryEnabled = process.env.SYSTEM_EMAIL_PROVIDER === "__test_seed__" && parseBooleanWithDefault(process.env.OM_ENABLE_TEST_CHANNEL_SEEDING, false) && parseBooleanWithDefault(process.env.OM_ENABLE_TEST_EMAIL_CAPTURE_DELIVERY, false);
+  return !testCaptureDeliveryEnabled;
+}
+function isEmailDeliveryConfigured() {
+  if (isEmailDeliveryDisabled()) return false;
+  if (!resolveDefaultEmailFromAddress()) return false;
+  const transport = getRegisteredEmailTransport();
+  if (!transport) return false;
+  return transport.isConfigured ? transport.isConfigured() : true;
+}
 export {
+  isEmailDeliveryConfigured,
+  isEmailDeliveryDisabled,
+  normalizeEnvString,
   resolveDefaultEmailFromAddress
 };
 //# sourceMappingURL=config.js.map

package/dist/lib/email/config.js.map

@@ -1,7 +1,7 @@
 {
   "version": 3,
   "sources": ["../../../src/lib/email/config.ts"],
-  "sourcesContent": ["function normalizeEnvString(value: string | null | undefined): string | undefined {\n  if (typeof value !== 'string') return undefined\n  const trimmed = value.trim()\n  return trimmed.length > 0 ? trimmed : undefined\n}\n\nexport function resolveDefaultEmailFromAddress(): string | undefined {\n  return (\n    normalizeEnvString(process.env.NOTIFICATIONS_EMAIL_FROM) ||\n    normalizeEnvString(process.env.EMAIL_FROM) ||\n    normalizeEnvString(process.env.ADMIN_EMAIL)\n  )\n}\n"],
-  "mappings": "AAAA,SAAS,mBAAmB,OAAsD;AAChF,MAAI,OAAO,UAAU,SAAU,QAAO;AACtC,QAAM,UAAU,MAAM,KAAK;AAC3B,SAAO,QAAQ,SAAS,IAAI,UAAU;AACxC;AAEO,SAAS,iCAAqD;AACnE,SACE,mBAAmB,QAAQ,IAAI,wBAAwB,KACvD,mBAAmB,QAAQ,IAAI,UAAU,KACzC,mBAAmB,QAAQ,IAAI,WAAW;AAE9C;",
+  "sourcesContent": ["import { parseBooleanWithDefault } from '../boolean'\nimport { getRegisteredEmailTransport } from './transport'\n\nexport function normalizeEnvString(value: string | null | undefined): string | undefined {\n  if (typeof value !== 'string') return undefined\n  const trimmed = value.trim()\n  return trimmed.length > 0 ? trimmed : undefined\n}\n\nexport function resolveDefaultEmailFromAddress(): string | undefined {\n  return (\n    normalizeEnvString(process.env.NOTIFICATIONS_EMAIL_FROM) ||\n    normalizeEnvString(process.env.EMAIL_FROM) ||\n    normalizeEnvString(process.env.ADMIN_EMAIL)\n  )\n}\n\nexport function isEmailDeliveryDisabled(): boolean {\n  const explicitlyDisabled = parseBooleanWithDefault(process.env.OM_DISABLE_EMAIL_DELIVERY, false)\n  if (explicitlyDisabled) return true\n\n  const testMode = parseBooleanWithDefault(process.env.OM_TEST_MODE, false)\n  if (!testMode) return false\n\n  const testCaptureDeliveryEnabled =\n    process.env.SYSTEM_EMAIL_PROVIDER === '__test_seed__'\n    && parseBooleanWithDefault(process.env.OM_ENABLE_TEST_CHANNEL_SEEDING, false)\n    && parseBooleanWithDefault(process.env.OM_ENABLE_TEST_EMAIL_CAPTURE_DELIVERY, false)\n  return !testCaptureDeliveryEnabled\n}\n\nexport function isEmailDeliveryConfigured(): boolean {\n  if (isEmailDeliveryDisabled()) return false\n  if (!resolveDefaultEmailFromAddress()) return false\n  const transport = getRegisteredEmailTransport()\n  if (!transport) return false\n  return transport.isConfigured ? transport.isConfigured() : true\n}\n"],
+  "mappings": "AAAA,SAAS,+BAA+B;AACxC,SAAS,mCAAmC;AAErC,SAAS,mBAAmB,OAAsD;AACvF,MAAI,OAAO,UAAU,SAAU,QAAO;AACtC,QAAM,UAAU,MAAM,KAAK;AAC3B,SAAO,QAAQ,SAAS,IAAI,UAAU;AACxC;AAEO,SAAS,iCAAqD;AACnE,SACE,mBAAmB,QAAQ,IAAI,wBAAwB,KACvD,mBAAmB,QAAQ,IAAI,UAAU,KACzC,mBAAmB,QAAQ,IAAI,WAAW;AAE9C;AAEO,SAAS,0BAAmC;AACjD,QAAM,qBAAqB,wBAAwB,QAAQ,IAAI,2BAA2B,KAAK;AAC/F,MAAI,mBAAoB,QAAO;AAE/B,QAAM,WAAW,wBAAwB,QAAQ,IAAI,cAAc,KAAK;AACxE,MAAI,CAAC,SAAU,QAAO;AAEtB,QAAM,6BACJ,QAAQ,IAAI,0BAA0B,mBACnC,wBAAwB,QAAQ,IAAI,gCAAgC,KAAK,KACzE,wBAAwB,QAAQ,IAAI,uCAAuC,KAAK;AACrF,SAAO,CAAC;AACV;AAEO,SAAS,4BAAqC;AACnD,MAAI,wBAAwB,EAAG,QAAO;AACtC,MAAI,CAAC,+BAA+B,EAAG,QAAO;AAC9C,QAAM,YAAY,4BAA4B;AAC9C,MAAI,CAAC,UAAW,QAAO;AACvB,SAAO,UAAU,eAAe,UAAU,aAAa,IAAI;AAC7D;",
   "names": []
 }

package/dist/lib/email/send.js

@@ -1,10 +1,13 @@
-import { Resend } from "resend";
 import React from "react";
 import { appendFile, mkdir } from "node:fs/promises";
 import { dirname, join } from "node:path";
 import { tmpdir } from "node:os";
 import { parseBooleanWithDefault } from "../boolean.js";
-import { resolveDefaultEmailFromAddress } from "./config.js";
+import {
+  isEmailDeliveryDisabled,
+  resolveDefaultEmailFromAddress
+} from "./config.js";
+import { getRegisteredEmailTransport } from "./transport.js";
 const DEFAULT_TEST_EMAIL_CAPTURE_PATH = join(tmpdir(), "open-mercato-email-capture.jsonl");
 function resolveTestEmailCapturePath() {
   return process.env.OM_TEST_EMAIL_CAPTURE_PATH?.trim() || DEFAULT_TEST_EMAIL_CAPTURE_PATH;
@@ -56,30 +59,30 @@ async function captureEmailForTests(options) {
   await appendFile(capturePath, `${JSON.stringify(record)}
 `, "utf8");
 }
-async function sendEmail({ to, subject, react, from, replyTo, attachments }) {
-  const emailDisabled = parseBooleanWithDefault(process.env.OM_DISABLE_EMAIL_DELIVERY, false) || parseBooleanWithDefault(process.env.OM_TEST_MODE, false);
-  await captureEmailForTests({ to, subject, react, from, replyTo, attachments });
-  if (emailDisabled) return;
-  const apiKey = process.env.RESEND_API_KEY;
-  if (!apiKey) throw new Error("RESEND_API_KEY is not set");
-  const resend = new Resend(apiKey);
-  const fromAddr = from || resolveDefaultEmailFromAddress();
+async function sendEmail(options) {
+  await captureEmailForTests(options);
+  if (isEmailDeliveryDisabled()) return;
+  const fromAddr = options.from || resolveDefaultEmailFromAddress();
   if (!fromAddr) {
     throw new Error("EMAIL_FROM_NOT_CONFIGURED: set NOTIFICATIONS_EMAIL_FROM, EMAIL_FROM, or ADMIN_EMAIL");
   }
-  const payload = {
-    to,
-    subject,
-    from: fromAddr,
-    react,
-    ...replyTo ? { reply_to: replyTo } : {},
-    ...attachments?.length ? { attachments } : {}
-  };
-  const result = await resend.emails.send(payload);
-  const errorMessage = typeof result?.error === "string" ? result.error : typeof result?.error?.message === "string" ? result.error.message : null;
-  if (errorMessage) {
-    throw new Error(`RESEND_SEND_FAILED: ${errorMessage}`);
+  const transport = getRegisteredEmailTransport();
+  if (!transport) {
+    throw new Error("EMAIL_TRANSPORT_NOT_CONFIGURED: enable an outbound email provider module");
   }
+  await transport.send({
+    to: options.to,
+    subject: options.subject,
+    react: options.react,
+    html: options.html,
+    text: options.text,
+    from: fromAddr,
+    fromIsInstanceDefault: !options.from,
+    replyTo: options.replyTo,
+    attachments: options.attachments,
+    tenantId: options.tenantId,
+    organizationId: options.organizationId
+  });
 }
 export {
   sendEmail

package/dist/lib/email/send.js.map

@@ -1,7 +1,7 @@
 {
   "version": 3,
   "sources": ["../../../src/lib/email/send.ts"],
-  "sourcesContent": ["import { Resend } from 'resend'\nimport React from 'react'\nimport { appendFile, mkdir } from 'node:fs/promises'\nimport { dirname, join } from 'node:path'\nimport { tmpdir } from 'node:os'\nimport { parseBooleanWithDefault } from '../boolean'\nimport { resolveDefaultEmailFromAddress } from './config'\n\nexport type SendEmailOptions = {\n  to: string\n  subject: string\n  react: React.ReactElement\n  from?: string\n  replyTo?: string\n  attachments?: Array<{\n    filename: string\n    content: string\n    contentType?: string\n  }>\n}\n\ntype CapturedEmail = {\n  to: string\n  subject: string\n  from: string | null\n  replyTo: string | null\n  links: string[]\n  text: string\n  capturedAt: string\n}\n\ntype ReactElementProps = {\n  href?: unknown\n  children?: unknown\n}\n\nconst DEFAULT_TEST_EMAIL_CAPTURE_PATH = join(tmpdir(), 'open-mercato-email-capture.jsonl')\n\nfunction resolveTestEmailCapturePath(): string {\n  return process.env.OM_TEST_EMAIL_CAPTURE_PATH?.trim() || DEFAULT_TEST_EMAIL_CAPTURE_PATH\n}\n\nfunction readElementProps(node: React.ReactElement): ReactElementProps {\n  return node.props as ReactElementProps\n}\n\nfunction collectEmailLinks(node: unknown, links: string[] = []): string[] {\n  if (node == null || typeof node === 'boolean') return links\n  if (Array.isArray(node)) {\n    for (const child of node) collectEmailLinks(child, links)\n    return links\n  }\n  if (React.isValidElement(node)) {\n    const props = readElementProps(node)\n    if (typeof props.href === 'string' && props.href.length > 0) links.push(props.href)\n    collectEmailLinks(props.children, links)\n  }\n  return links\n}\n\nfunction collectEmailText(node: unknown, parts: string[] = []): string[] {\n  if (node == null || typeof node === 'boolean') return parts\n  if (typeof node === 'string' || typeof node === 'number') {\n    parts.push(String(node))\n    return parts\n  }\n  if (Array.isArray(node)) {\n    for (const child of node) collectEmailText(child, parts)\n    return parts\n  }\n  if (React.isValidElement(node)) {\n    collectEmailText(readElementProps(node).children, parts)\n  }\n  return parts\n}\n\nasync function captureEmailForTests(options: SendEmailOptions): Promise<void> {\n  if (!parseBooleanWithDefault(process.env.OM_TEST_MODE, false)) return\n\n  const capturePath = resolveTestEmailCapturePath()\n  const record: CapturedEmail = {\n    to: options.to,\n    subject: options.subject,\n    from: options.from ?? resolveDefaultEmailFromAddress() ?? null,\n    replyTo: options.replyTo ?? null,\n    links: collectEmailLinks(options.react),\n    text: collectEmailText(options.react).join(' ').replace(/\\s+/g, ' ').trim(),\n    capturedAt: new Date().toISOString(),\n  }\n\n  await mkdir(dirname(capturePath), { recursive: true })\n  await appendFile(capturePath, `${JSON.stringify(record)}\\n`, 'utf8')\n}\n\nexport async function sendEmail({ to, subject, react, from, replyTo, attachments }: SendEmailOptions) {\n  const emailDisabled =\n    parseBooleanWithDefault(process.env.OM_DISABLE_EMAIL_DELIVERY, false) ||\n    parseBooleanWithDefault(process.env.OM_TEST_MODE, false)\n\n  await captureEmailForTests({ to, subject, react, from, replyTo, attachments })\n\n  if (emailDisabled) return\n\n  const apiKey = process.env.RESEND_API_KEY\n  if (!apiKey) throw new Error('RESEND_API_KEY is not set')\n  const resend = new Resend(apiKey)\n  const fromAddr = from || resolveDefaultEmailFromAddress()\n  if (!fromAddr) {\n    throw new Error('EMAIL_FROM_NOT_CONFIGURED: set NOTIFICATIONS_EMAIL_FROM, EMAIL_FROM, or ADMIN_EMAIL')\n  }\n  const payload = {\n    to,\n    subject,\n    from: fromAddr,\n    react,\n    ...(replyTo ? { reply_to: replyTo } : {}),\n    ...(attachments?.length ? { attachments } : {}),\n  }\n  const result = await resend.emails.send(payload)\n  const errorMessage =\n    typeof (result as any)?.error === 'string'\n      ? (result as any).error\n      : typeof (result as any)?.error?.message === 'string'\n        ? (result as any).error.message\n        : null\n  if (errorMessage) {\n    throw new Error(`RESEND_SEND_FAILED: ${errorMessage}`)\n  }\n}\n"],
-  "mappings": "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",
+  "sourcesContent": ["import React from 'react'\nimport { appendFile, mkdir } from 'node:fs/promises'\nimport { dirname, join } from 'node:path'\nimport { tmpdir } from 'node:os'\nimport { parseBooleanWithDefault } from '../boolean'\nimport {\n  isEmailDeliveryDisabled,\n  resolveDefaultEmailFromAddress,\n} from './config'\nimport { getRegisteredEmailTransport } from './transport'\n\nexport type EmailAttachment = {\n  filename: string\n  content: string\n  contentType?: string\n}\n\nexport type SendEmailOptions = {\n  to: string\n  subject: string\n  react?: React.ReactElement\n  html?: string\n  text?: string\n  from?: string\n  replyTo?: string\n  attachments?: EmailAttachment[]\n  tenantId?: string\n  organizationId?: string | null\n}\n\nexport type ResolvedEmailPayload = {\n  to: string\n  subject: string\n  react?: React.ReactElement\n  html?: string\n  text?: string\n  from: string\n  /**\n   * True when `from` was filled in from the instance-wide environment defaults rather than chosen by\n   * the caller. Transports use this to decide whether a tenant's own configured sender may take\n   * precedence: `from` is never empty by the time it reaches a transport, so without this flag a\n   * per-tenant sender is unreachable. Absent means \"caller chose it\" for older transports.\n   */\n  fromIsInstanceDefault?: boolean\n  replyTo?: string\n  attachments?: EmailAttachment[]\n  tenantId?: string\n  organizationId?: string | null\n}\n\ntype CapturedEmail = {\n  to: string\n  subject: string\n  from: string | null\n  replyTo: string | null\n  links: string[]\n  text: string\n  capturedAt: string\n}\n\ntype ReactElementProps = {\n  href?: unknown\n  children?: unknown\n}\n\nconst DEFAULT_TEST_EMAIL_CAPTURE_PATH = join(tmpdir(), 'open-mercato-email-capture.jsonl')\n\nfunction resolveTestEmailCapturePath(): string {\n  return process.env.OM_TEST_EMAIL_CAPTURE_PATH?.trim() || DEFAULT_TEST_EMAIL_CAPTURE_PATH\n}\n\nfunction readElementProps(node: React.ReactElement): ReactElementProps {\n  return node.props as ReactElementProps\n}\n\nfunction collectEmailLinks(node: unknown, links: string[] = []): string[] {\n  if (node == null || typeof node === 'boolean') return links\n  if (Array.isArray(node)) {\n    for (const child of node) collectEmailLinks(child, links)\n    return links\n  }\n  if (React.isValidElement(node)) {\n    const props = readElementProps(node)\n    if (typeof props.href === 'string' && props.href.length > 0) links.push(props.href)\n    collectEmailLinks(props.children, links)\n  }\n  return links\n}\n\nfunction collectEmailText(node: unknown, parts: string[] = []): string[] {\n  if (node == null || typeof node === 'boolean') return parts\n  if (typeof node === 'string' || typeof node === 'number') {\n    parts.push(String(node))\n    return parts\n  }\n  if (Array.isArray(node)) {\n    for (const child of node) collectEmailText(child, parts)\n    return parts\n  }\n  if (React.isValidElement(node)) {\n    collectEmailText(readElementProps(node).children, parts)\n  }\n  return parts\n}\n\nasync function captureEmailForTests(options: SendEmailOptions): Promise<void> {\n  if (!parseBooleanWithDefault(process.env.OM_TEST_MODE, false)) return\n\n  const capturePath = resolveTestEmailCapturePath()\n  const record: CapturedEmail = {\n    to: options.to,\n    subject: options.subject,\n    from: options.from ?? resolveDefaultEmailFromAddress() ?? null,\n    replyTo: options.replyTo ?? null,\n    links: collectEmailLinks(options.react),\n    text: collectEmailText(options.react).join(' ').replace(/\\s+/g, ' ').trim(),\n    capturedAt: new Date().toISOString(),\n  }\n\n  await mkdir(dirname(capturePath), { recursive: true })\n  await appendFile(capturePath, `${JSON.stringify(record)}\\n`, 'utf8')\n}\n\nexport async function sendEmail(options: SendEmailOptions): Promise<void> {\n  await captureEmailForTests(options)\n  if (isEmailDeliveryDisabled()) return\n\n  const fromAddr = options.from || resolveDefaultEmailFromAddress()\n  if (!fromAddr) {\n    throw new Error('EMAIL_FROM_NOT_CONFIGURED: set NOTIFICATIONS_EMAIL_FROM, EMAIL_FROM, or ADMIN_EMAIL')\n  }\n\n  const transport = getRegisteredEmailTransport()\n  if (!transport) {\n    throw new Error('EMAIL_TRANSPORT_NOT_CONFIGURED: enable an outbound email provider module')\n  }\n\n  await transport.send({\n    to: options.to,\n    subject: options.subject,\n    react: options.react,\n    html: options.html,\n    text: options.text,\n    from: fromAddr,\n    fromIsInstanceDefault: !options.from,\n    replyTo: options.replyTo,\n    attachments: options.attachments,\n    tenantId: options.tenantId,\n    organizationId: options.organizationId,\n  })\n}\n"],
+  "mappings": "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",
   "names": []
 }

package/dist/lib/email/transport.js

@@ -0,0 +1,19 @@
+const EMAIL_TRANSPORT_REGISTRY = /* @__PURE__ */ Symbol.for("open-mercato.email.transport");
+function emailTransportRoot() {
+  return globalThis;
+}
+function registerEmailTransport(transport) {
+  emailTransportRoot()[EMAIL_TRANSPORT_REGISTRY] = transport;
+}
+function getRegisteredEmailTransport() {
+  return emailTransportRoot()[EMAIL_TRANSPORT_REGISTRY] ?? null;
+}
+function clearRegisteredEmailTransportForTests() {
+  emailTransportRoot()[EMAIL_TRANSPORT_REGISTRY] = null;
+}
+export {
+  clearRegisteredEmailTransportForTests,
+  getRegisteredEmailTransport,
+  registerEmailTransport
+};
+//# sourceMappingURL=transport.js.map

package/dist/lib/email/transport.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../src/lib/email/transport.ts"],
+  "sourcesContent": ["import type { ResolvedEmailPayload } from './send'\n\nexport type EmailTransport = {\n  id: string\n  send: (payload: ResolvedEmailPayload) => Promise<void>\n  isConfigured?: () => boolean\n}\n\nconst EMAIL_TRANSPORT_REGISTRY = Symbol.for('open-mercato.email.transport')\n\ntype EmailTransportRegistryGlobal = typeof globalThis & {\n  [EMAIL_TRANSPORT_REGISTRY]?: EmailTransport | null\n}\n\nfunction emailTransportRoot(): EmailTransportRegistryGlobal {\n  return globalThis as EmailTransportRegistryGlobal\n}\n\nexport function registerEmailTransport(transport: EmailTransport): void {\n  emailTransportRoot()[EMAIL_TRANSPORT_REGISTRY] = transport\n}\n\nexport function getRegisteredEmailTransport(): EmailTransport | null {\n  return emailTransportRoot()[EMAIL_TRANSPORT_REGISTRY] ?? null\n}\n\nexport function clearRegisteredEmailTransportForTests(): void {\n  emailTransportRoot()[EMAIL_TRANSPORT_REGISTRY] = null\n}\n"],
+  "mappings": "AAQA,MAAM,2BAA2B,uBAAO,IAAI,8BAA8B;AAM1E,SAAS,qBAAmD;AAC1D,SAAO;AACT;AAEO,SAAS,uBAAuB,WAAiC;AACtE,qBAAmB,EAAE,wBAAwB,IAAI;AACnD;AAEO,SAAS,8BAAqD;AACnE,SAAO,mBAAmB,EAAE,wBAAwB,KAAK;AAC3D;AAEO,SAAS,wCAA8C;AAC5D,qBAAmB,EAAE,wBAAwB,IAAI;AACnD;",
+  "names": []
+}

package/dist/lib/version.js

@@ -1,4 +1,4 @@
-const APP_VERSION = "0.7.1-develop.7150.1.c1941e0c22";
+const APP_VERSION = "0.7.1-develop.7151.1.00d0391847";
 const appVersion = APP_VERSION;
 export {
   APP_VERSION,

package/dist/lib/version.js.map

@@ -1,7 +1,7 @@
 {
   "version": 3,
   "sources": ["../../src/lib/version.ts"],
-  "sourcesContent": ["// Build-time generated version\nexport const APP_VERSION = '0.7.1-develop.7150.1.c1941e0c22';\nexport const appVersion = APP_VERSION;\n"],
+  "sourcesContent": ["// Build-time generated version\nexport const APP_VERSION = '0.7.1-develop.7151.1.00d0391847';\nexport const appVersion = APP_VERSION;\n"],
   "mappings": "AACO,MAAM,cAAc;AACpB,MAAM,aAAa;",
   "names": []
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@open-mercato/shared",
-  "version": "0.7.1-develop.7150.1.c1941e0c22",
+  "version": "0.7.1-develop.7151.1.00d0391847",
   "license": "MIT",
   "type": "module",
   "main": "./dist/index.js",
@@ -113,7 +113,7 @@
     "@mikro-orm/core": "^7.1.8",
     "@mikro-orm/decorators": "^7.1.8",
     "@mikro-orm/postgresql": "^7.1.8",
-    "@open-mercato/cache": "0.7.1-develop.7150.1.c1941e0c22",
+    "@open-mercato/cache": "0.7.1-develop.7151.1.00d0391847",
     "@types/html-to-text": "^9.0.4",
     "@types/sanitize-html": "^2.16.1",
     "dotenv": "^17.4.2",

package/src/lib/email/__tests__/send.test.ts

@@ -2,32 +2,25 @@ import React from 'react'
 import { mkdtemp, readFile, rm } from 'node:fs/promises'
 import { join } from 'node:path'
 import { tmpdir } from 'node:os'
+import { isEmailDeliveryConfigured } from '../config'
 import { sendEmail } from '../send'
-
-var sendMock: jest.Mock
-var ResendMock: jest.Mock
-
-jest.mock('resend', () => {
-  sendMock = jest.fn().mockResolvedValue({ data: { id: 'email-1' } })
-  ResendMock = jest.fn().mockImplementation(() => ({
-    emails: { send: sendMock },
-  }))
-
-  return { Resend: ResendMock }
-})
+import {
+  clearRegisteredEmailTransportForTests,
+  registerEmailTransport,
+} from '../transport'
 
 describe('sendEmail', () => {
   const originalEnv = process.env
+  let sendMock: jest.Mock
   let tempDir: string | null = null
 
   beforeEach(() => {
     process.env = {
       ...originalEnv,
-      RESEND_API_KEY: 'test-key',
       EMAIL_FROM: 'from@example.com',
     }
-    sendMock.mockClear()
-    ResendMock.mockClear()
+    sendMock = jest.fn().mockResolvedValue(undefined)
+    clearRegisteredEmailTransportForTests()
   })
 
   afterEach(async () => {
@@ -36,79 +29,99 @@ describe('sendEmail', () => {
       tempDir = null
     }
     process.env = originalEnv
+    clearRegisteredEmailTransportForTests()
   })
 
-  it('maps replyTo to reply_to in Resend payload', async () => {
+  it('delegates normalized payloads to the registered transport', async () => {
+    registerEmailTransport({ id: 'test', send: sendMock })
+
     await sendEmail({
       to: 'user@example.com',
       subject: 'Hello',
       react: React.createElement('div', null, 'Hi'),
       replyTo: 'reply@example.com',
+      tenantId: 'tenant-1',
+      organizationId: 'org-1',
+      attachments: [
+        {
+          filename: 'invoice.pdf',
+          content: 'dGVzdA==',
+          contentType: 'application/pdf',
+        },
+      ],
     })
 
-    expect(ResendMock).toHaveBeenCalledWith('test-key')
-    expect(sendMock).toHaveBeenCalledWith(
-      expect.objectContaining({
-        to: 'user@example.com',
-        subject: 'Hello',
-        from: 'from@example.com',
-        reply_to: 'reply@example.com',
-      })
-    )
+    expect(sendMock).toHaveBeenCalledWith({
+      to: 'user@example.com',
+      subject: 'Hello',
+      from: 'from@example.com',
+      fromIsInstanceDefault: true,
+      react: expect.any(Object),
+      html: undefined,
+      text: undefined,
+      replyTo: 'reply@example.com',
+      tenantId: 'tenant-1',
+      organizationId: 'org-1',
+      attachments: [
+        {
+          filename: 'invoice.pdf',
+          content: 'dGVzdA==',
+          contentType: 'application/pdf',
+        },
+      ],
+    })
   })
 
-  it('omits reply_to when replyTo is not provided', async () => {
+  it('delegates html and text bodies without provider-specific rendering', async () => {
+    registerEmailTransport({ id: 'test', send: sendMock })
+
     await sendEmail({
       to: 'user@example.com',
       subject: 'Hello',
-      react: React.createElement('div', null, 'Hi'),
+      html: '<p>Hello</p>',
+      text: 'Hello',
     })
 
-    const payload = sendMock.mock.calls[0]?.[0] as Record<string, unknown>
-    expect(payload).toBeDefined()
-    expect(payload.reply_to).toBeUndefined()
+    expect(sendMock).toHaveBeenCalledWith(expect.objectContaining({
+      html: '<p>Hello</p>',
+      text: 'Hello',
+    }))
   })
 
-  it('passes attachments to Resend payload when provided', async () => {
+  it('marks an inherited sender so transports can prefer a tenant-configured one', async () => {
+    registerEmailTransport({ id: 'test', send: sendMock })
+
     await sendEmail({
       to: 'user@example.com',
       subject: 'Hello',
       react: React.createElement('div', null, 'Hi'),
-      attachments: [
-        {
-          filename: 'invoice.pdf',
-          content: 'dGVzdA==',
-          contentType: 'application/pdf',
-        },
-      ],
     })
 
-    expect(sendMock).toHaveBeenCalledWith(
-      expect.objectContaining({
-        attachments: [
-          {
-            filename: 'invoice.pdf',
-            content: 'dGVzdA==',
-            contentType: 'application/pdf',
-          },
-        ],
-      })
-    )
+    expect(sendMock).toHaveBeenCalledWith(expect.objectContaining({
+      fromIsInstanceDefault: true,
+    }))
   })
 
-  it('throws when Resend returns an error', async () => {
-    sendMock.mockResolvedValueOnce({ error: { message: 'invalid domain' } })
+  it('does not mark a sender the caller passed explicitly', async () => {
+    registerEmailTransport({ id: 'test', send: sendMock })
 
-    await expect(sendEmail({
+    await sendEmail({
       to: 'user@example.com',
       subject: 'Hello',
+      from: 'chosen@example.com',
       react: React.createElement('div', null, 'Hi'),
-    })).rejects.toThrow('RESEND_SEND_FAILED: invalid domain')
+    })
+
+    expect(sendMock).toHaveBeenCalledWith(expect.objectContaining({
+      from: 'chosen@example.com',
+      fromIsInstanceDefault: false,
+    }))
   })
 
   it('falls back to NOTIFICATIONS_EMAIL_FROM when EMAIL_FROM is not set', async () => {
     delete process.env.EMAIL_FROM
     process.env.NOTIFICATIONS_EMAIL_FROM = 'notifications@example.com'
+    registerEmailTransport({ id: 'test', send: sendMock })
 
     await sendEmail({
       to: 'user@example.com',
@@ -116,17 +129,16 @@ describe('sendEmail', () => {
       react: React.createElement('div', null, 'Hi'),
     })
 
-    expect(sendMock).toHaveBeenCalledWith(
-      expect.objectContaining({
-        from: 'notifications@example.com',
-      })
-    )
+    expect(sendMock).toHaveBeenCalledWith(expect.objectContaining({
+      from: 'notifications@example.com',
+    }))
   })
 
   it('falls back to ADMIN_EMAIL when sender-specific env vars are not set', async () => {
     delete process.env.EMAIL_FROM
     delete process.env.NOTIFICATIONS_EMAIL_FROM
     process.env.ADMIN_EMAIL = 'admin@example.com'
+    registerEmailTransport({ id: 'test', send: sendMock })
 
     await sendEmail({
       to: 'user@example.com',
@@ -134,17 +146,16 @@ describe('sendEmail', () => {
       react: React.createElement('div', null, 'Hi'),
     })
 
-    expect(sendMock).toHaveBeenCalledWith(
-      expect.objectContaining({
-        from: 'admin@example.com',
-      })
-    )
+    expect(sendMock).toHaveBeenCalledWith(expect.objectContaining({
+      from: 'admin@example.com',
+    }))
   })
 
   it('throws a clear error when no sender address is configured', async () => {
     delete process.env.EMAIL_FROM
     delete process.env.NOTIFICATIONS_EMAIL_FROM
     delete process.env.ADMIN_EMAIL
+    registerEmailTransport({ id: 'test', send: sendMock })
 
     await expect(sendEmail({
       to: 'user@example.com',
@@ -153,9 +164,17 @@ describe('sendEmail', () => {
     })).rejects.toThrow('EMAIL_FROM_NOT_CONFIGURED')
   })
 
-  it('skips external delivery in test mode when email delivery is disabled', async () => {
-    process.env.OM_DISABLE_EMAIL_DELIVERY = '1'
-    delete process.env.RESEND_API_KEY
+  it('throws a clear error when no transport is registered', async () => {
+    await expect(sendEmail({
+      to: 'user@example.com',
+      subject: 'Hello',
+      react: React.createElement('div', null, 'Hi'),
+    })).rejects.toThrow('EMAIL_TRANSPORT_NOT_CONFIGURED')
+  })
+
+  it('skips transport delivery when email delivery is disabled', async () => {
+    process.env.OM_DISABLE_EMAIL_DELIVERY = 'yes'
+    registerEmailTransport({ id: 'test', send: sendMock })
 
     await sendEmail({
       to: 'user@example.com',
@@ -163,16 +182,59 @@ describe('sendEmail', () => {
       react: React.createElement('div', null, 'Hi'),
     })
 
-    expect(ResendMock).not.toHaveBeenCalled()
     expect(sendMock).not.toHaveBeenCalled()
   })
 
+  it('keeps the established boolean tokens for test-mode delivery suppression', async () => {
+    process.env.OM_TEST_MODE = 'on'
+    registerEmailTransport({ id: 'test', send: sendMock })
+
+    await sendEmail({
+      to: 'user@example.com',
+      subject: 'Hello',
+      react: React.createElement('div', null, 'Hi'),
+    })
+
+    expect(sendMock).not.toHaveBeenCalled()
+  })
+
+  it('does not let OM_DISABLE_EMAIL_DELIVERY=0 override test-mode delivery suppression', async () => {
+    process.env.OM_TEST_MODE = '1'
+    process.env.OM_DISABLE_EMAIL_DELIVERY = '0'
+    registerEmailTransport({ id: 'test', send: sendMock })
+
+    await sendEmail({
+      to: 'user@example.com',
+      subject: 'Hello',
+      react: React.createElement('div', null, 'Hi'),
+    })
+
+    expect(sendMock).not.toHaveBeenCalled()
+  })
+
+  it('allows test-mode delivery only for the explicitly enabled capture adapter', async () => {
+    process.env.OM_TEST_MODE = '1'
+    process.env.OM_DISABLE_EMAIL_DELIVERY = '0'
+    process.env.OM_ENABLE_TEST_CHANNEL_SEEDING = 'true'
+    process.env.OM_ENABLE_TEST_EMAIL_CAPTURE_DELIVERY = 'true'
+    process.env.SYSTEM_EMAIL_PROVIDER = '__test_seed__'
+    registerEmailTransport({ id: 'test', send: sendMock })
+
+    await sendEmail({
+      to: 'user@example.com',
+      subject: 'Hello',
+      react: React.createElement('div', null, 'Hi'),
+    })
+
+    expect(sendMock).toHaveBeenCalledTimes(1)
+  })
+
   it('captures email links in OM_TEST_MODE without external delivery', async () => {
     tempDir = await mkdtemp(join(tmpdir(), 'om-email-capture-'))
     const capturePath = join(tempDir, 'emails.jsonl')
     process.env.OM_TEST_MODE = '1'
     process.env.OM_TEST_EMAIL_CAPTURE_PATH = capturePath
-    delete process.env.RESEND_API_KEY
+    registerEmailTransport({ id: 'test', send: sendMock })
 
     await sendEmail({
       to: 'user@example.com',
@@ -191,7 +253,16 @@ describe('sendEmail', () => {
       links: ['https://example.com/portal/invite?token=raw'],
       text: 'Accept your invite Accept',
     }))
-    expect(ResendMock).not.toHaveBeenCalled()
     expect(sendMock).not.toHaveBeenCalled()
   })
+
+  it('reports configured only when a sender and configured transport are present', () => {
+    expect(isEmailDeliveryConfigured()).toBe(false)
+
+    registerEmailTransport({ id: 'test', send: sendMock, isConfigured: () => false })
+    expect(isEmailDeliveryConfigured()).toBe(false)
+
+    registerEmailTransport({ id: 'test', send: sendMock, isConfigured: () => true })
+    expect(isEmailDeliveryConfigured()).toBe(true)
+  })
 })

package/src/lib/email/config.ts

@@ -1,4 +1,7 @@
-function normalizeEnvString(value: string | null | undefined): string | undefined {
+import { parseBooleanWithDefault } from '../boolean'
+import { getRegisteredEmailTransport } from './transport'
+
+export function normalizeEnvString(value: string | null | undefined): string | undefined {
   if (typeof value !== 'string') return undefined
   const trimmed = value.trim()
   return trimmed.length > 0 ? trimmed : undefined
@@ -11,3 +14,25 @@ export function resolveDefaultEmailFromAddress(): string | undefined {
     normalizeEnvString(process.env.ADMIN_EMAIL)
   )
 }
+
+export function isEmailDeliveryDisabled(): boolean {
+  const explicitlyDisabled = parseBooleanWithDefault(process.env.OM_DISABLE_EMAIL_DELIVERY, false)
+  if (explicitlyDisabled) return true
+
+  const testMode = parseBooleanWithDefault(process.env.OM_TEST_MODE, false)
+  if (!testMode) return false
+
+  const testCaptureDeliveryEnabled =
+    process.env.SYSTEM_EMAIL_PROVIDER === '__test_seed__'
+    && parseBooleanWithDefault(process.env.OM_ENABLE_TEST_CHANNEL_SEEDING, false)
+    && parseBooleanWithDefault(process.env.OM_ENABLE_TEST_EMAIL_CAPTURE_DELIVERY, false)
+  return !testCaptureDeliveryEnabled
+}
+
+export function isEmailDeliveryConfigured(): boolean {
+  if (isEmailDeliveryDisabled()) return false
+  if (!resolveDefaultEmailFromAddress()) return false
+  const transport = getRegisteredEmailTransport()
+  if (!transport) return false
+  return transport.isConfigured ? transport.isConfigured() : true
+}

package/src/lib/email/send.ts

@@ -1,22 +1,51 @@
-import { Resend } from 'resend'
 import React from 'react'
 import { appendFile, mkdir } from 'node:fs/promises'
 import { dirname, join } from 'node:path'
 import { tmpdir } from 'node:os'
 import { parseBooleanWithDefault } from '../boolean'
-import { resolveDefaultEmailFromAddress } from './config'
+import {
+  isEmailDeliveryDisabled,
+  resolveDefaultEmailFromAddress,
+} from './config'
+import { getRegisteredEmailTransport } from './transport'
+
+export type EmailAttachment = {
+  filename: string
+  content: string
+  contentType?: string
+}
 
 export type SendEmailOptions = {
   to: string
   subject: string
-  react: React.ReactElement
+  react?: React.ReactElement
+  html?: string
+  text?: string
   from?: string
   replyTo?: string
-  attachments?: Array<{
-    filename: string
-    content: string
-    contentType?: string
-  }>
+  attachments?: EmailAttachment[]
+  tenantId?: string
+  organizationId?: string | null
+}
+
+export type ResolvedEmailPayload = {
+  to: string
+  subject: string
+  react?: React.ReactElement
+  html?: string
+  text?: string
+  from: string
+  /**
+   * True when `from` was filled in from the instance-wide environment defaults rather than chosen by
+   * the caller. Transports use this to decide whether a tenant's own configured sender may take
+   * precedence: `from` is never empty by the time it reaches a transport, so without this flag a
+   * per-tenant sender is unreachable. Absent means "caller chose it" for older transports.
+   */
+  fromIsInstanceDefault?: boolean
+  replyTo?: string
+  attachments?: EmailAttachment[]
+  tenantId?: string
+  organizationId?: string | null
 }
 
 type CapturedEmail = {
@@ -92,38 +121,31 @@ async function captureEmailForTests(options: SendEmailOptions): Promise<void> {
   await appendFile(capturePath, `${JSON.stringify(record)}\n`, 'utf8')
 }
 
-export async function sendEmail({ to, subject, react, from, replyTo, attachments }: SendEmailOptions) {
-  const emailDisabled =
-    parseBooleanWithDefault(process.env.OM_DISABLE_EMAIL_DELIVERY, false) ||
-    parseBooleanWithDefault(process.env.OM_TEST_MODE, false)
-
-  await captureEmailForTests({ to, subject, react, from, replyTo, attachments })
+export async function sendEmail(options: SendEmailOptions): Promise<void> {
+  await captureEmailForTests(options)
+  if (isEmailDeliveryDisabled()) return
 
-  if (emailDisabled) return
-
-  const apiKey = process.env.RESEND_API_KEY
-  if (!apiKey) throw new Error('RESEND_API_KEY is not set')
-  const resend = new Resend(apiKey)
-  const fromAddr = from || resolveDefaultEmailFromAddress()
+  const fromAddr = options.from || resolveDefaultEmailFromAddress()
   if (!fromAddr) {
     throw new Error('EMAIL_FROM_NOT_CONFIGURED: set NOTIFICATIONS_EMAIL_FROM, EMAIL_FROM, or ADMIN_EMAIL')
   }
-  const payload = {
-    to,
-    subject,
-    from: fromAddr,
-    react,
-    ...(replyTo ? { reply_to: replyTo } : {}),
-    ...(attachments?.length ? { attachments } : {}),
-  }
-  const result = await resend.emails.send(payload)
-  const errorMessage =
-    typeof (result as any)?.error === 'string'
-      ? (result as any).error
-      : typeof (result as any)?.error?.message === 'string'
-        ? (result as any).error.message
-        : null
-  if (errorMessage) {
-    throw new Error(`RESEND_SEND_FAILED: ${errorMessage}`)
+
+  const transport = getRegisteredEmailTransport()
+  if (!transport) {
+    throw new Error('EMAIL_TRANSPORT_NOT_CONFIGURED: enable an outbound email provider module')
   }
+
+  await transport.send({
+    to: options.to,
+    subject: options.subject,
+    react: options.react,
+    html: options.html,
+    text: options.text,
+    from: fromAddr,
+    fromIsInstanceDefault: !options.from,
+    replyTo: options.replyTo,
+    attachments: options.attachments,
+    tenantId: options.tenantId,
+    organizationId: options.organizationId,
+  })
 }

package/src/lib/email/transport.ts

@@ -0,0 +1,29 @@
+import type { ResolvedEmailPayload } from './send'
+
+export type EmailTransport = {
+  id: string
+  send: (payload: ResolvedEmailPayload) => Promise<void>
+  isConfigured?: () => boolean
+}
+
+const EMAIL_TRANSPORT_REGISTRY = Symbol.for('open-mercato.email.transport')
+
+type EmailTransportRegistryGlobal = typeof globalThis & {
+  [EMAIL_TRANSPORT_REGISTRY]?: EmailTransport | null
+}
+
+function emailTransportRoot(): EmailTransportRegistryGlobal {
+  return globalThis as EmailTransportRegistryGlobal
+}
+
+export function registerEmailTransport(transport: EmailTransport): void {
+  emailTransportRoot()[EMAIL_TRANSPORT_REGISTRY] = transport
+}
+
+export function getRegisteredEmailTransport(): EmailTransport | null {
+  return emailTransportRoot()[EMAIL_TRANSPORT_REGISTRY] ?? null
+}
+
+export function clearRegisteredEmailTransportForTests(): void {
+  emailTransportRoot()[EMAIL_TRANSPORT_REGISTRY] = null
+}