@holo-js/mail 0.2.5 → 0.3.0

package/dist/{chunk-BQCGZOVF.mjs → chunk-7CZAQPEH.mjs}

@@ -1,5 +1,4 @@
 // src/contracts-types.ts
-import { defineMailConfig } from "@holo-js/config";
 var HOLO_MAIL_DEFINITION_MARKER = /* @__PURE__ */ Symbol.for("holo-js.mail.definition");
 var BUILT_IN_MAIL_DRIVERS = ["preview", "log", "fake", "smtp"];
 var MAIL_PRIORITY_VALUES = ["high", "normal", "low"];
@@ -505,7 +504,6 @@ function attachContent(content, options) {
 }
 
 export {
-  defineMailConfig,
   HOLO_MAIL_DEFINITION_MARKER,
   BUILT_IN_MAIL_DRIVERS,
   MAIL_PRIORITY_VALUES,

package/dist/chunk-YPNVXZL6.mjs

@@ -0,0 +1,219 @@
+// src/config.ts
+import { registerConfigNormalizer } from "@holo-js/config/registry";
+function normalizeMailEnvironment(value, fallback = "development") {
+  return value === "development" || value === "production" || value === "test" ? value : fallback;
+}
+var DEFAULT_MAILER_NAME = "preview";
+var DEFAULT_MAIL_PREVIEW_PATH = ".holo-js/runtime/mail-preview";
+var DEFAULT_SMTP_HOST = "127.0.0.1";
+var DEFAULT_SMTP_PORT = 1025;
+var DEFAULT_MAIL_QUEUE_CONFIG = Object.freeze({
+  queued: false,
+  connection: void 0,
+  queue: void 0,
+  afterCommit: false
+});
+var holoMailDefaults = Object.freeze({
+  default: DEFAULT_MAILER_NAME,
+  from: void 0,
+  replyTo: void 0,
+  queue: DEFAULT_MAIL_QUEUE_CONFIG,
+  preview: Object.freeze({
+    allowedEnvironments: Object.freeze(["development"])
+  }),
+  markdown: Object.freeze({
+    wrapper: void 0
+  }),
+  mailers: Object.freeze({
+    preview: Object.freeze({
+      name: "preview",
+      driver: "preview",
+      from: void 0,
+      replyTo: void 0,
+      queue: DEFAULT_MAIL_QUEUE_CONFIG,
+      path: DEFAULT_MAIL_PREVIEW_PATH
+    }),
+    log: Object.freeze({
+      name: "log",
+      driver: "log",
+      from: void 0,
+      replyTo: void 0,
+      queue: DEFAULT_MAIL_QUEUE_CONFIG,
+      logBodies: false
+    }),
+    fake: Object.freeze({
+      name: "fake",
+      driver: "fake",
+      from: void 0,
+      replyTo: void 0,
+      queue: DEFAULT_MAIL_QUEUE_CONFIG
+    }),
+    smtp: Object.freeze({
+      name: "smtp",
+      driver: "smtp",
+      from: void 0,
+      replyTo: void 0,
+      queue: DEFAULT_MAIL_QUEUE_CONFIG,
+      host: DEFAULT_SMTP_HOST,
+      port: DEFAULT_SMTP_PORT,
+      secure: false
+    })
+  })
+});
+function normalizeOptionalMailString(value, label) {
+  if (typeof value === "undefined") {
+    return void 0;
+  }
+  const normalized = value.trim();
+  if (!normalized) {
+    throw new Error(`[Holo Mail] ${label} must be a non-empty string when provided.`);
+  }
+  return normalized;
+}
+function isValidMailAddress(email) {
+  if (email.includes(" ")) {
+    return false;
+  }
+  const parts = email.split("@");
+  return parts.length === 2 && parts[0].length > 0 && parts[1].length > 0;
+}
+function normalizeMailAddress(address, label) {
+  if (!address) {
+    return void 0;
+  }
+  const email = normalizeOptionalMailString(address.email, `${label} email`)?.toLowerCase();
+  if (!email || !isValidMailAddress(email)) {
+    throw new Error(`[Holo Mail] ${label} email must be a valid email address.`);
+  }
+  const name = normalizeOptionalMailString(address.name, `${label} name`);
+  return Object.freeze({
+    email,
+    ...name ? { name } : {}
+  });
+}
+function normalizeMailQueueConfig(queue, fallback = holoMailDefaults.queue) {
+  return Object.freeze({
+    queued: queue?.queued ?? fallback.queued,
+    connection: normalizeOptionalMailString(queue?.connection, "Mail queue connection") ?? fallback.connection,
+    queue: normalizeOptionalMailString(queue?.queue, "Mail queue name") ?? fallback.queue,
+    afterCommit: queue?.afterCommit ?? fallback.afterCommit
+  });
+}
+function normalizeMailPreviewEnvironments(environments) {
+  if (typeof environments === "undefined") {
+    return holoMailDefaults.preview.allowedEnvironments;
+  }
+  const normalized = /* @__PURE__ */ new Set();
+  for (const environment of environments) {
+    if (environment !== "development" && environment !== "production" && environment !== "test") {
+      throw new Error("[Holo Mail] Mail preview environments must be development, production, or test.");
+    }
+    normalized.add(environment);
+  }
+  return Object.freeze([...normalized]);
+}
+function normalizeMailMailerConfig(name, config, fallback) {
+  const normalizedName = normalizeOptionalMailString(name, "Mail mailer name");
+  const driver = normalizeOptionalMailString(config.driver, `Mail mailer "${name}" driver`);
+  if (!normalizedName || !driver) {
+    throw new Error("[Holo Mail] Mailers must define a name and driver.");
+  }
+  const base = {
+    name: normalizedName,
+    driver,
+    from: normalizeMailAddress(config.from, `Mail mailer "${name}" from`) ?? fallback?.from,
+    replyTo: normalizeMailAddress(config.replyTo, `Mail mailer "${name}" replyTo`) ?? fallback?.replyTo,
+    queue: normalizeMailQueueConfig(config.queue, fallback?.queue ?? holoMailDefaults.queue)
+  };
+  if (driver === "preview") {
+    const previewFallback = fallback?.driver === "preview" ? fallback : void 0;
+    return Object.freeze({
+      ...base,
+      driver: "preview",
+      path: normalizeOptionalMailString(config.path, `Mail mailer "${name}" preview path`) ?? previewFallback?.path ?? DEFAULT_MAIL_PREVIEW_PATH
+    });
+  }
+  if (driver === "log") {
+    const logFallback = fallback?.driver === "log" ? fallback : void 0;
+    return Object.freeze({
+      ...base,
+      driver: "log",
+      logBodies: config.logBodies ?? logFallback?.logBodies ?? false
+    });
+  }
+  if (driver === "fake") {
+    return Object.freeze({
+      ...base,
+      driver: "fake"
+    });
+  }
+  if (driver === "smtp") {
+    const smtpFallback = fallback?.driver === "smtp" ? fallback : void 0;
+    const rawPort = config.port;
+    const normalizedPort = typeof rawPort === "number" ? rawPort : typeof rawPort === "string" && rawPort.trim() ? Number(rawPort.trim()) : smtpFallback?.port ?? DEFAULT_SMTP_PORT;
+    if (!Number.isFinite(normalizedPort) || normalizedPort <= 0) {
+      throw new Error(`[Holo Mail] Mail mailer "${name}" SMTP port must be a positive number.`);
+    }
+    return Object.freeze({
+      ...base,
+      driver: "smtp",
+      host: normalizeOptionalMailString(config.host, `Mail mailer "${name}" SMTP host`) ?? smtpFallback?.host ?? DEFAULT_SMTP_HOST,
+      port: normalizedPort,
+      secure: config.secure ?? smtpFallback?.secure ?? false,
+      user: normalizeOptionalMailString(config.user, `Mail mailer "${name}" SMTP user`) ?? smtpFallback?.user ?? void 0,
+      password: normalizeOptionalMailString(config.password, `Mail mailer "${name}" SMTP password`) ?? smtpFallback?.password ?? void 0
+    });
+  }
+  const customFields = Object.fromEntries(
+    Object.entries(config).filter(([key]) => key !== "driver" && key !== "from" && key !== "replyTo" && key !== "queue")
+  );
+  return Object.freeze({
+    ...base,
+    ...customFields
+  });
+}
+function normalizeMailConfig(config = {}) {
+  const mergedMailers = {
+    ...holoMailDefaults.mailers
+  };
+  for (const [name, mailer] of Object.entries(config.mailers ?? {})) {
+    mergedMailers[name] = normalizeMailMailerConfig(name, mailer, mergedMailers[name]);
+  }
+  const defaultMailer = normalizeOptionalMailString(config.default, "Default mailer") ?? holoMailDefaults.default;
+  if (!mergedMailers[defaultMailer]) {
+    throw new Error(
+      `[Holo Mail] default mailer "${defaultMailer}" is not configured. Available mailers: ${Object.keys(mergedMailers).join(", ")}`
+    );
+  }
+  return Object.freeze({
+    default: defaultMailer,
+    from: normalizeMailAddress(config.from, "Mail from") ?? holoMailDefaults.from,
+    replyTo: normalizeMailAddress(config.replyTo, "Mail replyTo") ?? holoMailDefaults.replyTo,
+    queue: normalizeMailQueueConfig(config.queue),
+    preview: Object.freeze({
+      allowedEnvironments: normalizeMailPreviewEnvironments(config.preview?.allowedEnvironments)
+    }),
+    markdown: Object.freeze({
+      wrapper: normalizeOptionalMailString(config.markdown?.wrapper, "Mail markdown wrapper") ?? holoMailDefaults.markdown.wrapper
+    }),
+    mailers: Object.freeze(mergedMailers)
+  });
+}
+function defineMailConfig(config) {
+  return Object.freeze({ ...config });
+}
+registerConfigNormalizer({
+  name: "mail",
+  normalize: normalizeMailConfig
+});
+
+export {
+  normalizeMailEnvironment,
+  DEFAULT_MAILER_NAME,
+  DEFAULT_MAIL_PREVIEW_PATH,
+  DEFAULT_SMTP_HOST,
+  DEFAULT_SMTP_PORT,
+  holoMailDefaults,
+  normalizeMailConfig,
+  defineMailConfig
+};

package/dist/config.d.ts

@@ -0,0 +1,119 @@
+type HoloAppEnv = 'development' | 'production' | 'test';
+declare function normalizeMailEnvironment(value: string | undefined, fallback?: HoloAppEnv): HoloAppEnv;
+interface HoloMailAddressConfig {
+    readonly email: string;
+    readonly name?: string;
+}
+interface HoloMailQueueConfig {
+    readonly queued?: boolean;
+    readonly connection?: string;
+    readonly queue?: string;
+    readonly afterCommit?: boolean;
+}
+interface HoloMailPreviewConfig {
+    readonly allowedEnvironments?: readonly HoloAppEnv[];
+}
+interface HoloMailMarkdownConfig {
+    readonly wrapper?: string;
+}
+interface BaseMailDriverConfig {
+    readonly driver: string;
+    readonly from?: HoloMailAddressConfig;
+    readonly replyTo?: HoloMailAddressConfig;
+    readonly queue?: HoloMailQueueConfig;
+}
+interface PreviewMailDriverConfig extends BaseMailDriverConfig {
+    readonly driver: 'preview';
+    readonly path?: string;
+}
+interface LogMailDriverConfig extends BaseMailDriverConfig {
+    readonly driver: 'log';
+    readonly logBodies?: boolean;
+}
+interface FakeMailDriverConfig extends BaseMailDriverConfig {
+    readonly driver: 'fake';
+}
+interface SmtpMailDriverConfig extends BaseMailDriverConfig {
+    readonly driver: 'smtp';
+    readonly host?: string;
+    readonly port?: number | string;
+    readonly secure?: boolean;
+    readonly user?: string;
+    readonly password?: string;
+}
+type HoloMailMailerConfig = PreviewMailDriverConfig | LogMailDriverConfig | FakeMailDriverConfig | SmtpMailDriverConfig | (BaseMailDriverConfig & Record<string, unknown>);
+interface HoloMailConfig {
+    readonly default?: string;
+    readonly from?: HoloMailAddressConfig;
+    readonly replyTo?: HoloMailAddressConfig;
+    readonly queue?: HoloMailQueueConfig;
+    readonly preview?: HoloMailPreviewConfig;
+    readonly markdown?: HoloMailMarkdownConfig;
+    readonly mailers?: Readonly<Record<string, HoloMailMailerConfig>>;
+}
+interface NormalizedHoloMailAddressConfig {
+    readonly email: string;
+    readonly name?: string;
+}
+interface NormalizedHoloMailQueueConfig {
+    readonly queued: boolean;
+    readonly connection?: string;
+    readonly queue?: string;
+    readonly afterCommit: boolean;
+}
+interface NormalizedHoloMailPreviewConfig {
+    readonly allowedEnvironments: readonly HoloAppEnv[];
+}
+interface NormalizedHoloMailMarkdownConfig {
+    readonly wrapper?: string;
+}
+interface NormalizedBaseMailDriverConfig {
+    readonly name: string;
+    readonly driver: string;
+    readonly from?: NormalizedHoloMailAddressConfig;
+    readonly replyTo?: NormalizedHoloMailAddressConfig;
+    readonly queue: NormalizedHoloMailQueueConfig;
+}
+interface NormalizedPreviewMailDriverConfig extends NormalizedBaseMailDriverConfig {
+    readonly driver: 'preview';
+    readonly path: string;
+}
+interface NormalizedLogMailDriverConfig extends NormalizedBaseMailDriverConfig {
+    readonly driver: 'log';
+    readonly logBodies: boolean;
+}
+interface NormalizedFakeMailDriverConfig extends NormalizedBaseMailDriverConfig {
+    readonly driver: 'fake';
+}
+interface NormalizedSmtpMailDriverConfig extends NormalizedBaseMailDriverConfig {
+    readonly driver: 'smtp';
+    readonly host: string;
+    readonly port: number;
+    readonly secure: boolean;
+    readonly user?: string;
+    readonly password?: string;
+}
+type NormalizedHoloMailMailerConfig = NormalizedPreviewMailDriverConfig | NormalizedLogMailDriverConfig | NormalizedFakeMailDriverConfig | NormalizedSmtpMailDriverConfig | NormalizedBaseMailDriverConfig;
+interface NormalizedHoloMailConfig {
+    readonly default: string;
+    readonly from?: NormalizedHoloMailAddressConfig;
+    readonly replyTo?: NormalizedHoloMailAddressConfig;
+    readonly queue: NormalizedHoloMailQueueConfig;
+    readonly preview: NormalizedHoloMailPreviewConfig;
+    readonly markdown: NormalizedHoloMailMarkdownConfig;
+    readonly mailers: Readonly<Record<string, NormalizedHoloMailMailerConfig>>;
+}
+declare const DEFAULT_MAILER_NAME = "preview";
+declare const DEFAULT_MAIL_PREVIEW_PATH = ".holo-js/runtime/mail-preview";
+declare const DEFAULT_SMTP_HOST = "127.0.0.1";
+declare const DEFAULT_SMTP_PORT = 1025;
+declare const holoMailDefaults: Readonly<NormalizedHoloMailConfig>;
+declare function normalizeMailConfig(config?: HoloMailConfig): NormalizedHoloMailConfig;
+declare function defineMailConfig<TConfig extends HoloMailConfig>(config: TConfig): Readonly<TConfig>;
+declare module '@holo-js/config' {
+    interface HoloConfigRegistry {
+        mail: NormalizedHoloMailConfig;
+    }
+}
+
+export { type BaseMailDriverConfig, DEFAULT_MAILER_NAME, DEFAULT_MAIL_PREVIEW_PATH, DEFAULT_SMTP_HOST, DEFAULT_SMTP_PORT, type FakeMailDriverConfig, type HoloAppEnv, type HoloMailAddressConfig, type HoloMailConfig, type HoloMailMailerConfig, type HoloMailMarkdownConfig, type HoloMailPreviewConfig, type HoloMailQueueConfig, type LogMailDriverConfig, type NormalizedBaseMailDriverConfig, type NormalizedFakeMailDriverConfig, type NormalizedHoloMailAddressConfig, type NormalizedHoloMailConfig, type NormalizedHoloMailMailerConfig, type NormalizedHoloMailMarkdownConfig, type NormalizedHoloMailPreviewConfig, type NormalizedHoloMailQueueConfig, type NormalizedLogMailDriverConfig, type NormalizedPreviewMailDriverConfig, type NormalizedSmtpMailDriverConfig, type PreviewMailDriverConfig, type SmtpMailDriverConfig, defineMailConfig, holoMailDefaults, normalizeMailConfig, normalizeMailEnvironment };

package/dist/config.mjs

@@ -0,0 +1,20 @@
+import {
+  DEFAULT_MAILER_NAME,
+  DEFAULT_MAIL_PREVIEW_PATH,
+  DEFAULT_SMTP_HOST,
+  DEFAULT_SMTP_PORT,
+  defineMailConfig,
+  holoMailDefaults,
+  normalizeMailConfig,
+  normalizeMailEnvironment
+} from "./chunk-YPNVXZL6.mjs";
+export {
+  DEFAULT_MAILER_NAME,
+  DEFAULT_MAIL_PREVIEW_PATH,
+  DEFAULT_SMTP_HOST,
+  DEFAULT_SMTP_PORT,
+  defineMailConfig,
+  holoMailDefaults,
+  normalizeMailConfig,
+  normalizeMailEnvironment
+};

package/dist/contracts.d.ts

@@ -1,5 +1,5 @@
-import { HoloAppEnv, NormalizedHoloMailConfig } from '@holo-js/config';
-export { defineMailConfig } from '@holo-js/config';
+import { HoloAppEnv, NormalizedHoloMailConfig } from './config.js';
+export { defineMailConfig } from './config.js';
 
 declare const HOLO_MAIL_DEFINITION_MARKER: unique symbol;
 declare const BUILT_IN_MAIL_DRIVERS: readonly ["preview", "log", "fake", "smtp"];

package/dist/contracts.mjs

@@ -10,7 +10,6 @@ import {
   createAttachmentResolutionPlan,
   createAttachmentResolutionPlans,
   defineMail,
-  defineMailConfig,
   inferMimeTypeFromName,
   isAttachmentQueueSafe,
   isMailDefinition,
@@ -18,7 +17,10 @@ import {
   normalizeMailDefinition,
   resolveAttachmentDefinition,
   resolveNormalizedAttachment
-} from "./chunk-BQCGZOVF.mjs";
+} from "./chunk-7CZAQPEH.mjs";
+import {
+  defineMailConfig
+} from "./chunk-YPNVXZL6.mjs";
 export {
   BUILT_IN_MAIL_DRIVERS,
   HOLO_MAIL_DEFINITION_MARKER,

package/dist/index.d.ts

@@ -1,21 +1,7 @@
-import { ResolvedMail, MailDriverExecutionContext, MailSendResult, MailPreviewPolicy, MailPreviewFormat, MailRuntimeBindings, MailDefinition, MailDefinitionInput, MailOverrideInput, MailPreviewResult, PendingMailSend, RegisteredMailDriver, MailDriver, RegisterMailDriverOptions } from './contracts.js';
+export { HoloMailConfig, NormalizedHoloMailConfig, defineMailConfig, holoMailDefaults, normalizeMailConfig } from './config.js';
+import { MailPreviewPolicy, MailPreviewFormat, ResolvedMail, MailDriverExecutionContext, MailSendResult, MailRuntimeBindings, MailDefinition, MailDefinitionInput, MailOverrideInput, MailPreviewResult, PendingMailSend, RegisteredMailDriver, MailDriver, RegisterMailDriverOptions } from './contracts.js';
 export { BuiltInMailDriverRegistry, HoloMailDriverRegistry, MailAddress, MailAddressInput, MailAttachmentBase, MailAttachmentContent, MailAttachmentDisposition, MailAttachmentHelperOptions, MailAttachmentInput, MailAttachmentMetadata, MailAttachmentResolutionContext, MailAttachmentResolutionPlan, MailContentAttachment, MailContentAttachmentHelperOptions, MailContentSourceKind, MailDelayValue, MailDriverName, MailJsonObject, MailJsonValue, MailPathAttachment, MailPreviewInput, MailPriority, MailQueueOptions, MailRecipientsInput, MailRenderPreviewInput, MailRenderSource, MailResolvableAttachment, MailResolvedAttachmentPayload, MailSendInput, MailSendOptions, MailStorageAttachment, MailStorageAttachmentHelperOptions, MailViewRenderInput, MailViewRenderer, ResolvedMailAttachment, attachContent, attachFromPath, attachFromStorage, createAttachmentMetadata, createAttachmentResolutionPlan, createAttachmentResolutionPlans, defineMail, inferMimeTypeFromName, isAttachmentQueueSafe, isMailDefinition, mergeMailDefinitionInputs, normalizeMailDefinition, resolveAttachmentDefinition, resolveNormalizedAttachment } from './contracts.js';
-export { HoloMailConfig, NormalizedHoloMailConfig, defineMailConfig } from '@holo-js/config';
 
-interface FakeSentMail {
-    readonly messageId: string;
-    readonly createdAt: Date;
-    readonly mail: Readonly<ResolvedMail>;
-    readonly context: Readonly<MailDriverExecutionContext>;
-    readonly result: Readonly<MailSendResult>;
-}
-interface MailPreviewArtifact {
-    readonly messageId: string;
-    readonly createdAt: Date;
-    readonly mail: Readonly<ResolvedMail>;
-    readonly context: Readonly<MailDriverExecutionContext>;
-    readonly result: Readonly<MailSendResult>;
-}
 declare class MailError extends Error {
     readonly code: string;
     constructor(message: string, code?: string, options?: ErrorOptions);
@@ -39,6 +25,21 @@ declare class MailSendError extends MailError {
         readonly message?: string;
     }, options?: ErrorOptions);
 }
+
+interface FakeSentMail {
+    readonly messageId: string;
+    readonly createdAt: Date;
+    readonly mail: Readonly<ResolvedMail>;
+    readonly context: Readonly<MailDriverExecutionContext>;
+    readonly result: Readonly<MailSendResult>;
+}
+interface MailPreviewArtifact {
+    readonly messageId: string;
+    readonly createdAt: Date;
+    readonly mail: Readonly<ResolvedMail>;
+    readonly context: Readonly<MailDriverExecutionContext>;
+    readonly result: Readonly<MailSendResult>;
+}
 interface MailRuntimeFacade {
     sendMail(mail: MailDefinition | MailDefinitionInput, overrides?: MailOverrideInput): PendingMailSend<MailSendResult>;
     previewMail(mail: MailDefinition | MailDefinitionInput, overrides?: MailOverrideInput): Promise<MailPreviewResult>;
@@ -67,10 +68,13 @@ declare const mailRegistryInternals: {
     normalizeDriverName: typeof normalizeDriverName;
 };
 
+declare function loadMailPluginDrivers(projectRoot?: string, pluginNames?: readonly string[]): Promise<void>;
+declare function resetMailPluginDrivers(): void;
+
 declare const mail: Readonly<{
     previewMail: typeof previewMail;
     renderMailPreview: typeof renderMailPreview;
     sendMail: typeof sendMail;
 }>;
 
-export { type FakeSentMail, MailDefinition, MailDefinitionInput, MailDriver, MailDriverExecutionContext, MailError, MailOverrideInput, type MailPreviewArtifact, MailPreviewDisabledError, MailPreviewFormat, MailPreviewFormatUnavailableError, MailPreviewPolicy, MailPreviewResult, MailRuntimeBindings, MailSendError, MailSendResult, PendingMailSend, RegisterMailDriverOptions, RegisteredMailDriver, ResolvedMail, configureMailRuntime, mail as default, getMailRuntime, getMailRuntimeBindings, getRegisteredMailDriver, listFakeSentMails, listPreviewMailArtifacts, listRegisteredMailDrivers, mailRegistryInternals, previewMail, registerMailDriver, renderMailPreview, resetFakeSentMails, resetMailDriverRegistry, resetMailRuntime, resetPreviewMailArtifacts, sendMail };
+export { type FakeSentMail, MailDefinition, MailDefinitionInput, MailDriver, MailDriverExecutionContext, MailError, MailOverrideInput, type MailPreviewArtifact, MailPreviewDisabledError, MailPreviewFormat, MailPreviewFormatUnavailableError, MailPreviewPolicy, MailPreviewResult, MailRuntimeBindings, MailSendError, MailSendResult, PendingMailSend, RegisterMailDriverOptions, RegisteredMailDriver, ResolvedMail, configureMailRuntime, mail as default, getMailRuntime, getMailRuntimeBindings, getRegisteredMailDriver, listFakeSentMails, listPreviewMailArtifacts, listRegisteredMailDrivers, loadMailPluginDrivers, mailRegistryInternals, previewMail, registerMailDriver, renderMailPreview, resetFakeSentMails, resetMailDriverRegistry, resetMailPluginDrivers, resetMailRuntime, resetPreviewMailArtifacts, sendMail };

package/dist/index.mjs

@@ -13,17 +13,58 @@ import {
   normalizeMailDefinition,
   resolveAttachmentDefinition,
   resolveNormalizedAttachment
-} from "./chunk-BQCGZOVF.mjs";
+} from "./chunk-7CZAQPEH.mjs";
+import {
+  defineMailConfig,
+  holoMailDefaults,
+  normalizeMailConfig,
+  normalizeMailEnvironment
+} from "./chunk-YPNVXZL6.mjs";
 
 // src/runtime.ts
 import { randomUUID } from "crypto";
 import { mkdir, realpath, writeFile } from "fs/promises";
 import { tmpdir } from "os";
 import { join, resolve, sep } from "path";
-import {
-  holoMailDefaults,
-  normalizeAppEnv
-} from "@holo-js/config";
+
+// src/markdown.ts
+function escapeHtml(value) {
+  return value.replaceAll("&", "&amp;").replaceAll("<", "&lt;").replaceAll(">", "&gt;").replaceAll('"', "&quot;").replaceAll("'", "&#039;");
+}
+function isSafeMailHref(href) {
+  const trimmed = href.trim();
+  if (trimmed.startsWith("#") || trimmed.startsWith("/") || trimmed.startsWith("./") || trimmed.startsWith("../")) return true;
+  try {
+    const url = new URL(trimmed);
+    return url.protocol === "https:" || url.protocol === "http:" || url.protocol === "mailto:";
+  } catch {
+    return false;
+  }
+}
+function renderMarkdownInline(markdown) {
+  return escapeHtml(markdown).replace(/\[([^\]]+)\]\(([^)]+)\)/g, (_match, label, href) => {
+    return isSafeMailHref(href) ? `<a href="${escapeHtml(href)}">${label}</a>` : label;
+  }).replace(/`([^`]+)`/g, "<code>$1</code>").replace(/\*\*([^*]+)\*\*/g, "<strong>$1</strong>").replace(/\*([^*]+)\*/g, "<em>$1</em>");
+}
+function stripMarkdownSyntax(markdown) {
+  return markdown.replace(/\[([^\]]+)\]\(([^)]+)\)/g, "$1 ($2)").replace(/`([^`]+)`/g, "$1").replace(/\*\*([^*]+)\*\*/g, "$1").replace(/\*([^*]+)\*/g, "$1").replace(/^#{1,6}\s+/gm, "").replace(/^[-*]\s+/gm, "").trim();
+}
+function renderMarkdown(markdown) {
+  const blocks = markdown.trim().split(/\n\s*\n/g).map((block) => block.trim()).filter(Boolean);
+  return blocks.map((block) => {
+    const lines = block.split("\n").map((line) => line.trim()).filter(Boolean);
+    if (lines.every((line) => /^[-*]\s+/.test(line))) {
+      return `<ul>${lines.map((line) => `<li>${renderMarkdownInline(line.replace(/^[-*]\s+/, ""))}</li>`).join("")}</ul>`;
+    }
+    const heading = lines.length === 1 ? lines[0].match(/^(#{1,6})\s+(.+)$/) : null;
+    if (heading) {
+      const [, markers, title] = heading;
+      const level = markers.length;
+      return `<h${level}>${renderMarkdownInline(title)}</h${level}>`;
+    }
+    return `<p>${lines.map(renderMarkdownInline).join("<br />")}</p>`;
+  }).join("\n");
+}
 
 // src/registry.ts
 function normalizeDriverName(value) {
@@ -55,6 +96,9 @@ function registerMailDriver(name, driver, options = {}) {
 function getRegisteredMailDriver(name) {
   return getRegistry().get(normalizeDriverName(name));
 }
+function unregisterMailDriver(name) {
+  return getRegistry().delete(normalizeDriverName(name));
+}
 function listRegisteredMailDrivers() {
   return Object.freeze([...getRegistry().values()]);
 }
@@ -66,12 +110,66 @@ var mailRegistryInternals = {
   normalizeDriverName
 };
 
-// src/runtime.ts
-var HOLO_MAIL_DELIVER_JOB = "holo.mail.deliver";
-var LOCAL_ATTACHMENT_ROOTS = Object.freeze([
-  tmpdir(),
-  resolve(process.cwd(), "storage")
-]);
+// src/plugins.ts
+import {
+  loadHoloPluginContributionModules,
+  loadHoloPluginDefinitions
+} from "@holo-js/kernel";
+var loadedProjectRoots = /* @__PURE__ */ new Set();
+var registeredPluginDrivers = /* @__PURE__ */ new Map();
+function isRecord(value) {
+  return !!value && typeof value === "object" && !Array.isArray(value);
+}
+function resolveMailDriver(moduleValue, packageName, driverName) {
+  const candidate = isRecord(moduleValue) && typeof moduleValue.default !== "undefined" ? moduleValue.default : isRecord(moduleValue) && typeof moduleValue.driver !== "undefined" ? moduleValue.driver : moduleValue;
+  if (!isRecord(candidate) || typeof candidate.send !== "function") {
+    throw new Error(`[@holo-js/mail] Plugin ${packageName} mail driver "${driverName}" must export send().`);
+  }
+  return {
+    send: candidate.send
+  };
+}
+async function loadMailPluginDrivers(projectRoot = process.cwd(), pluginNames = []) {
+  const loadKey = `${projectRoot}\0${[...pluginNames].sort().join("\0")}`;
+  if (loadedProjectRoots.has(loadKey)) {
+    return;
+  }
+  const plugins = await loadHoloPluginDefinitions(projectRoot, pluginNames);
+  const contributions = await loadHoloPluginContributionModules(projectRoot, plugins, "mail", "drivers");
+  for (const contribution of contributions) {
+    const previous = getRegisteredMailDriver(contribution.name);
+    const driver = resolveMailDriver(contribution.module, contribution.plugin.packageName, contribution.name);
+    registerMailDriver(
+      contribution.name,
+      driver,
+      { replaceExisting: true }
+    );
+    const registered = getRegisteredMailDriver(contribution.name);
+    if (registered) {
+      const existingPluginDriver = registeredPluginDrivers.get(registered.name);
+      registeredPluginDrivers.set(registered.name, {
+        driver,
+        previous: existingPluginDriver ? existingPluginDriver.previous : previous?.driver
+      });
+    }
+  }
+  loadedProjectRoots.add(loadKey);
+}
+function resetMailPluginDrivers() {
+  for (const [driverName, registered] of registeredPluginDrivers) {
+    if (getRegisteredMailDriver(driverName)?.driver !== registered.driver) {
+      continue;
+    }
+    unregisterMailDriver(driverName);
+    if (registered.previous) {
+      registerMailDriver(driverName, registered.previous, { replaceExisting: true });
+    }
+  }
+  loadedProjectRoots.clear();
+  registeredPluginDrivers.clear();
+}
+
+// src/errors.ts
 var MailError = class extends Error {
   code;
   constructor(message, code = "MAIL_ERROR", options) {
@@ -118,6 +216,52 @@ var MailSendError = class extends MailError {
     this.driver = details.driver;
   }
 };
+
+// src/preview.ts
+function escapePreviewHtml(value) {
+  return value.replaceAll("&", "&amp;").replaceAll("<", "&lt;").replaceAll(">", "&gt;").replaceAll('"', "&quot;").replaceAll("'", "&#39;");
+}
+function formatPreviewAddress(address) {
+  return address.name ? `${escapePreviewHtml(address.name)} &lt;${escapePreviewHtml(address.email)}&gt;` : escapePreviewHtml(address.email);
+}
+function createMailPreviewHtml(preview) {
+  const header = [
+    `<h1>${escapePreviewHtml(preview.subject)}</h1>`,
+    `<p><strong>From:</strong> ${formatPreviewAddress(preview.from)}</p>`,
+    `<p><strong>Reply-To:</strong> ${formatPreviewAddress(preview.replyTo)}</p>`,
+    `<p><strong>To:</strong> ${preview.to.map(formatPreviewAddress).join(", ")}</p>`,
+    preview.cc.length > 0 ? `<p><strong>Cc:</strong> ${preview.cc.map(formatPreviewAddress).join(", ")}</p>` : "",
+    preview.bcc.length > 0 ? `<p><strong>Bcc:</strong> ${preview.bcc.map(formatPreviewAddress).join(", ")}</p>` : ""
+  ].filter(Boolean).join("");
+  const body = preview.html ? `<pre>${escapePreviewHtml(preview.html)}</pre>` : preview.text ? `<pre>${escapePreviewHtml(preview.text)}</pre>` : "<p>No rendered content is available.</p>";
+  return `<!doctype html><html><head><meta charset="utf-8"><title>${escapePreviewHtml(preview.subject)}</title></head><body>${header}${body}</body></html>`;
+}
+function createMailPreviewResponse(preview, format) {
+  if (format === "json") {
+    return new Response(JSON.stringify(preview, null, 2), {
+      status: 200,
+      headers: { "content-type": "application/json; charset=utf-8" }
+    });
+  }
+  if (format === "text") {
+    if (typeof preview.text !== "string") throw new MailPreviewFormatUnavailableError(format);
+    return new Response(preview.text, {
+      status: 200,
+      headers: { "content-type": "text/plain; charset=utf-8" }
+    });
+  }
+  return new Response(createMailPreviewHtml(preview), {
+    status: 200,
+    headers: { "content-type": "text/html; charset=utf-8" }
+  });
+}
+
+// src/runtime.ts
+var HOLO_MAIL_DELIVER_JOB = "holo.mail.deliver";
+var LOCAL_ATTACHMENT_ROOTS = Object.freeze([
+  tmpdir(),
+  resolve(process.cwd(), "storage")
+]);
 function getRuntimeState() {
   const runtime = globalThis;
   runtime.__holoMailRuntime__ ??= {};
@@ -249,7 +393,7 @@ function getResolvedConfig() {
   return getRuntimeBindings().config ?? holoMailDefaults;
 }
 function resolveCurrentEnvironment() {
-  return normalizeAppEnv(process.env.APP_ENV ?? process.env.NODE_ENV);
+  return normalizeMailEnvironment(process.env.APP_ENV ?? process.env.NODE_ENV);
 }
 function createPreviewPolicy(config = getResolvedConfig()) {
   return Object.freeze({
@@ -263,50 +407,8 @@ function assertPreviewEnabled(config = getResolvedConfig()) {
     throw new MailPreviewDisabledError(policy);
   }
 }
-function createPreviewHtml(preview) {
-  const header = [
-    `<h1>${escapeHtml(preview.subject)}</h1>`,
-    `<p><strong>From:</strong> ${formatAddress(preview.from)}</p>`,
-    `<p><strong>Reply-To:</strong> ${formatAddress(preview.replyTo)}</p>`,
-    `<p><strong>To:</strong> ${preview.to.map(formatAddress).join(", ")}</p>`,
-    preview.cc.length > 0 ? `<p><strong>Cc:</strong> ${preview.cc.map(formatAddress).join(", ")}</p>` : "",
-    preview.bcc.length > 0 ? `<p><strong>Bcc:</strong> ${preview.bcc.map(formatAddress).join(", ")}</p>` : ""
-  ].filter(Boolean).join("");
-  const body = preview.html ? `<pre>${escapeHtml(preview.html)}</pre>` : preview.text ? `<pre>${escapeHtml(preview.text)}</pre>` : "<p>No rendered content is available.</p>";
-  return `<!doctype html><html><head><meta charset="utf-8"><title>${escapeHtml(preview.subject)}</title></head><body>${header}${body}</body></html>`;
-}
-function escapeHtml(value) {
-  return value.replaceAll("&", "&amp;").replaceAll("<", "&lt;").replaceAll(">", "&gt;").replaceAll('"', "&quot;").replaceAll("'", "&#39;");
-}
-function formatAddress(address) {
-  return address.name ? `${escapeHtml(address.name)} &lt;${escapeHtml(address.email)}&gt;` : escapeHtml(address.email);
-}
 function renderPreviewResponse(preview, format) {
-  if (format === "json") {
-    return new Response(JSON.stringify(preview, null, 2), {
-      status: 200,
-      headers: {
-        "content-type": "application/json; charset=utf-8"
-      }
-    });
-  }
-  if (format === "text") {
-    if (typeof preview.text !== "string") {
-      throw new MailPreviewFormatUnavailableError(format);
-    }
-    return new Response(preview.text, {
-      status: 200,
-      headers: {
-        "content-type": "text/plain; charset=utf-8"
-      }
-    });
-  }
-  return new Response(createPreviewHtml(preview), {
-    status: 200,
-    headers: {
-      "content-type": "text/html; charset=utf-8"
-    }
-  });
+  return createMailPreviewResponse(preview, format);
 }
 function getMailerConfig(mailer, config = getResolvedConfig()) {
   const mailerConfig = config.mailers[mailer];
@@ -641,6 +743,21 @@ function resolveDriver(mail2, options, config) {
     implementation: registered.driver
   });
 }
+function isMailDriverNotRegisteredError(error) {
+  return error instanceof MailError && error.code === "MAIL_DRIVER_NOT_REGISTERED";
+}
+async function resolveDriverWithPluginFallback(mail2, options, config) {
+  try {
+    return resolveDriver(mail2, options, config);
+  } catch (error) {
+    if (!isMailDriverNotRegisteredError(error)) {
+      throw error;
+    }
+  }
+  const state = getRuntimeState();
+  await loadMailPluginDrivers(state.projectRoot, state.pluginNames);
+  return resolveDriver(mail2, options, config);
+}
 function resolveDriverByName(mailer, driver) {
   const builtIn = builtInDrivers[driver];
   if (builtIn) {
@@ -663,6 +780,18 @@ function resolveDriverByName(mailer, driver) {
     implementation: registered.driver
   });
 }
+async function resolveDriverByNameWithPluginFallback(mailer, driver) {
+  try {
+    return resolveDriverByName(mailer, driver);
+  } catch (error) {
+    if (!isMailDriverNotRegisteredError(error)) {
+      throw error;
+    }
+  }
+  const state = getRuntimeState();
+  await loadMailPluginDrivers(state.projectRoot, state.pluginNames);
+  return resolveDriverByName(mailer, driver);
+}
 function serializeQueuedAttachment(attachment) {
   return Object.freeze({
     source: attachment.source,
@@ -748,7 +877,7 @@ async function deliverResolvedMail(mail2, resolvedDriver, context) {
   }
 }
 async function runQueuedMailDelivery(payload) {
-  const resolvedDriver = resolveDriverByName(payload.mailer, payload.driver);
+  const resolvedDriver = await resolveDriverByNameWithPluginFallback(payload.mailer, payload.driver);
   const context = Object.freeze({
     messageId: payload.messageId,
     mailer: payload.mailer,
@@ -817,14 +946,6 @@ async function renderView(input) {
   }
   return html;
 }
-function stripMarkdownSyntax(markdown) {
-  return markdown.replace(/\[([^\]]+)\]\(([^)]+)\)/g, "$1 ($2)").replace(/`([^`]+)`/g, "$1").replace(/\*\*([^*]+)\*\*/g, "$1").replace(/\*([^*]+)\*/g, "$1").replace(/^#{1,6}\s+/gm, "").replace(/^[-*]\s+/gm, "").trim();
-}
-function renderMarkdownInline(markdown) {
-  return escapeHtml(markdown).replace(/\[([^\]]+)\]\(([^)]+)\)/g, (_match, label, href) => {
-    return isSafeMailHref(href) ? `<a href="${escapeHtml(href)}">${label}</a>` : label;
-  }).replace(/`([^`]+)`/g, "<code>$1</code>").replace(/\*\*([^*]+)\*\*/g, "<strong>$1</strong>").replace(/\*([^*]+)\*/g, "<em>$1</em>");
-}
 async function resolveLocalAttachmentPath(path) {
   const resolvedPath = await realpath(path);
   const allowedRoots = await Promise.all(LOCAL_ATTACHMENT_ROOTS.map(async (root) => await realpath(root).catch(() => null)));
@@ -833,37 +954,6 @@ async function resolveLocalAttachmentPath(path) {
   }
   throw new MailError("[@holo-js/mail] Path attachments must resolve inside an allowed attachment directory.", "MAIL_ATTACHMENT_UNSAFE_PATH");
 }
-function isSafeMailHref(href) {
-  const trimmed = href.trim();
-  if (trimmed.startsWith("#") || trimmed.startsWith("/") || trimmed.startsWith("./") || trimmed.startsWith("../")) {
-    return true;
-  }
-  try {
-    const url = new URL(trimmed);
-    return url.protocol === "https:" || url.protocol === "http:" || url.protocol === "mailto:";
-  } catch {
-    return false;
-  }
-}
-function renderMarkdown(markdown) {
-  const blocks = markdown.trim().split(/\n\s*\n/g).map((block) => block.trim()).filter(Boolean);
-  return blocks.map((block) => {
-    const lines = block.split("\n").map((line) => line.trim()).filter(Boolean);
-    if (lines.length === 0) {
-      return "";
-    }
-    if (lines.every((line) => /^[-*]\s+/.test(line))) {
-      return `<ul>${lines.map((line) => `<li>${renderMarkdownInline(line.replace(/^[-*]\s+/, ""))}</li>`).join("")}</ul>`;
-    }
-    const heading = lines.length === 1 ? lines[0].match(/^(#{1,6})\s+(.+)$/) : null;
-    if (heading) {
-      const [, markers, title] = heading;
-      const level = markers.length;
-      return `<h${level}>${renderMarkdownInline(title)}</h${level}>`;
-    }
-    return `<p>${lines.map(renderMarkdownInline).join("<br />")}</p>`;
-  }).join("\n");
-}
 function resolveMailerName(mail2, config) {
   return mail2.mailer ?? config.default;
 }
@@ -1027,7 +1117,7 @@ var PendingSend = class {
   async #execute(execution = {}) {
     const options = Object.freeze({ ...this.#options });
     const config = getResolvedConfig();
-    const resolvedDriver = resolveDriver(this.#mail, options, config);
+    const resolvedDriver = await resolveDriverWithPluginFallback(this.#mail, options, config);
     const plan = resolveQueuePlan(this.#mail, options, resolvedDriver.mailer, config);
     const messageId = randomUUID();
     const prepared = await prepareMailSend(this.#mail, plan.queued);
@@ -1093,7 +1183,18 @@ function resolveMailInput(mail2, overrides) {
   return normalizeMailDefinition(mergeMailDefinitionInputs(mail2, overrides));
 }
 function configureMailRuntime(bindings) {
-  getRuntimeState().bindings = bindings;
+  const state = getRuntimeState();
+  if (!bindings) {
+    state.bindings = void 0;
+    state.projectRoot = void 0;
+    state.pluginNames = void 0;
+    return;
+  }
+  const { projectRoot, plugins, ...runtimeBindings } = bindings;
+  state.bindings = runtimeBindings;
+  const normalizedProjectRoot = typeof projectRoot === "string" ? projectRoot.trim() : "";
+  state.projectRoot = normalizedProjectRoot ? normalizedProjectRoot : void 0;
+  state.pluginNames = Object.freeze([...new Set((plugins ?? []).map((plugin) => plugin.trim()).filter((plugin) => plugin.length > 0))]);
 }
 function getMailRuntimeBindings() {
   return getRuntimeBindings();
@@ -1101,12 +1202,15 @@ function getMailRuntimeBindings() {
 function resetMailRuntime() {
   const state = getRuntimeState();
   state.bindings = void 0;
+  state.projectRoot = void 0;
+  state.pluginNames = void 0;
   state.fakeSent = void 0;
   state.previewArtifacts = void 0;
   state.loadQueueModule = void 0;
   state.loadDbModule = void 0;
   state.loadNodemailerModule = void 0;
   state.loadStorageModule = void 0;
+  resetMailPluginDrivers();
 }
 function sendMail(mail2, overrides) {
   return new PendingSend(resolveMailInput(mail2, overrides));
@@ -1163,7 +1267,6 @@ function getMailRuntime() {
 }
 
 // src/index.ts
-import { defineMailConfig } from "@holo-js/config";
 var mail = Object.freeze({
   previewMail,
   renderMailPreview,
@@ -1188,20 +1291,24 @@ export {
   getMailRuntime,
   getMailRuntimeBindings,
   getRegisteredMailDriver,
+  holoMailDefaults,
   inferMimeTypeFromName,
   isAttachmentQueueSafe,
   isMailDefinition,
   listFakeSentMails,
   listPreviewMailArtifacts,
   listRegisteredMailDrivers,
+  loadMailPluginDrivers,
   mailRegistryInternals,
   mergeMailDefinitionInputs,
+  normalizeMailConfig,
   normalizeMailDefinition,
   previewMail,
   registerMailDriver,
   renderMailPreview,
   resetFakeSentMails,
   resetMailDriverRegistry,
+  resetMailPluginDrivers,
   resetMailRuntime,
   resetPreviewMailArtifacts,
   resolveAttachmentDefinition,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@holo-js/mail",
-  "version": "0.2.5",
+  "version": "0.3.0",
   "description": "Holo-JS Framework - mail contracts, preview helpers, and fluent send helpers",
   "type": "module",
   "license": "MIT",
@@ -10,6 +10,11 @@
       "import": "./dist/index.mjs",
       "default": "./dist/index.mjs"
     },
+    "./config": {
+      "types": "./dist/config.d.ts",
+      "import": "./dist/config.mjs",
+      "default": "./dist/config.mjs"
+    },
     "./contracts": {
       "types": "./dist/contracts.d.ts",
       "import": "./dist/contracts.mjs",
@@ -28,12 +33,13 @@
     "test": "vitest --run"
   },
   "dependencies": {
-    "@holo-js/config": "^0.2.5",
+    "@holo-js/config": "^0.3.0",
+    "@holo-js/kernel": "^0.3.0",
     "nodemailer": "^6.10.1"
   },
   "peerDependencies": {
-    "@holo-js/queue": "^0.2.5",
-    "@holo-js/storage": "^0.2.5"
+    "@holo-js/queue": "^0.3.0",
+    "@holo-js/storage": "^0.3.0"
   },
   "peerDependenciesMeta": {
     "@holo-js/queue": {