npm - ts-mailkit - Versions diffs - 2.0.0 → 2.1.0 - Mend

ts-mailkit 2.0.0 → 2.1.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (37) hide show

package/README.md +114 -63
package/dist/core/bulk-types.d.ts +196 -0
package/dist/core/bulk-types.d.ts.map +1 -0
package/dist/core/client.d.ts +38 -6
package/dist/core/client.d.ts.map +1 -1
package/dist/core/errors.d.ts +3 -0
package/dist/core/errors.d.ts.map +1 -1
package/dist/core/types.d.ts +5 -0
package/dist/core/types.d.ts.map +1 -1
package/dist/index.cjs +926 -754
package/dist/index.cjs.map +1 -1
package/dist/index.d.ts +19 -13
package/dist/index.d.ts.map +1 -1
package/dist/index.js +904 -709
package/dist/index.js.map +1 -1
package/dist/renderers/default/default-renderer.d.ts +2 -2
package/dist/renderers/default/default-renderer.d.ts.map +1 -1
package/dist/renderers/renderer.interface.d.ts +1 -1
package/dist/templates/factory.d.ts +1 -1
package/dist/templates/factory.d.ts.map +1 -1
package/dist/templates/template-builder.d.ts +36 -0
package/dist/templates/template-builder.d.ts.map +1 -0
package/dist/transports/console/console-sender.d.ts +7 -2
package/dist/transports/console/console-sender.d.ts.map +1 -1
package/dist/transports/cpaas/cpaas-sender.d.ts +51 -0
package/dist/transports/cpaas/cpaas-sender.d.ts.map +1 -0
package/dist/transports/cpaas/types.d.ts +133 -0
package/dist/transports/cpaas/types.d.ts.map +1 -0
package/dist/transports/memory/memory-sender.d.ts +26 -6
package/dist/transports/memory/memory-sender.d.ts.map +1 -1
package/dist/transports/sender.interface.d.ts +34 -3
package/dist/transports/sender.interface.d.ts.map +1 -1
package/dist/transports/zeptomail/types.d.ts +5 -46
package/dist/transports/zeptomail/types.d.ts.map +1 -1
package/dist/transports/zeptomail/zeptomail-sender.d.ts +4 -19
package/dist/transports/zeptomail/zeptomail-sender.d.ts.map +1 -1
package/package.json +40 -38

package/dist/index.cjs CHANGED Viewed

@@ -1,802 +1,974 @@
-"use strict";
-var __defProp = Object.defineProperty;
-var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
-var __getOwnPropNames = Object.getOwnPropertyNames;
-var __hasOwnProp = Object.prototype.hasOwnProperty;
-var __export = (target, all) => {
-  for (var name in all)
-    __defProp(target, name, { get: all[name], enumerable: true });
-};
-var __copyProps = (to, from, except, desc) => {
-  if (from && typeof from === "object" || typeof from === "function") {
-    for (let key of __getOwnPropNames(from))
-      if (!__hasOwnProp.call(to, key) && key !== except)
-        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
-  }
-  return to;
-};
-var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
-// src/index.ts
-var index_exports = {};
-__export(index_exports, {
-  ConfigurationError: () => ConfigurationError,
-  ConsoleEmailSender: () => ConsoleEmailSender,
-  DefaultEmailRenderer: () => DefaultEmailRenderer,
-  EmailTemplateFactory: () => EmailTemplateFactory,
-  MailKit: () => MailKit,
-  MailKitError: () => MailKitError,
-  MemoryEmailSender: () => MemoryEmailSender,
-  TemplateError: () => TemplateError,
-  TransportError: () => TransportError,
-  ZeptoMailHttpSender: () => ZeptoMailHttpSender,
-  buildHtml: () => buildHtml,
-  buildPlainText: () => buildPlainText,
-  createMailKit: () => createMailKit,
-  decodeHtmlEntities: () => decodeHtmlEntities,
-  htmlToPlainText: () => htmlToPlainText,
-  isValidHttpUrl: () => isValidHttpUrl,
-  normalizeRecipient: () => normalizeRecipient,
-  normalizeRecipients: () => normalizeRecipients,
-  parseEmailAddress: () => parseEmailAddress
-});
-module.exports = __toCommonJS(index_exports);
-// src/core/types.ts
+Object.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });
+//#region src/core/types.ts
+/**
+* Parses an RFC 5322 formatted address string into an EmailAddress.
+* Supports formats such as:
+* - "user@example.com" -> { address: "user@example.com" }
+* - "Sender Name <sender@example.com>" -> { name: "Sender Name", address: "sender@example.com" }
+* - "\"Sender Name\" <sender@example.com>" -> { name: "Sender Name", address: "sender@example.com" }
+*/
 function parseEmailAddress(input) {
-  if (!input || typeof input !== "string") {
-    return { address: "" };
-  }
-  const trimmed = input.trim();
-  const match = trimmed.match(/^(?:["']?([^"']+)["']?\s+)?<?([^\s<>@]+@[^\s<>@]+)>?$/);
-  if (!match) {
-    return { address: trimmed };
-  }
-  return {
-    address: match[2].trim(),
-    name: match[1]?.trim() || void 0
-  };
+	if (!input || typeof input !== "string") return { address: "" };
+	const trimmed = input.trim();
+	const match = trimmed.match(/^(?:["']?([^"']+)["']?\s+)?<?([^\s<>@]+@[^\s<>@]+)>?$/);
+	if (!match) return { address: trimmed };
+	return {
+		address: match[2].trim(),
+		name: match[1]?.trim() || void 0
+	};
 }
+/**
+* Normalizes a Recipient value into a standardized EmailAddress.
+*/
 function normalizeRecipient(recipient) {
-  if (typeof recipient === "string") {
-    return { address: recipient.trim() };
-  }
-  if ("email" in recipient) {
-    return {
-      address: (recipient.email ?? "").trim(),
-      name: recipient.name?.trim()
-    };
-  }
-  return {
-    address: (recipient.address ?? "").trim(),
-    name: recipient.name?.trim()
-  };
+	if (typeof recipient === "string") return { address: recipient.trim() };
+	if ("email" in recipient) return {
+		address: (recipient.email ?? "").trim(),
+		name: recipient.name?.trim()
+	};
+	return {
+		address: (recipient.address ?? "").trim(),
+		name: recipient.name?.trim()
+	};
 }
+/**
+* Normalizes a single or array of Recipients into an array of EmailAddress.
+*/
 function normalizeRecipients(recipients) {
-  if (!recipients) return [];
-  const list = Array.isArray(recipients) ? recipients : [recipients];
-  return list.map(normalizeRecipient).filter((r) => r.address.length > 0);
+	if (!recipients) return [];
+	return (Array.isArray(recipients) ? recipients : [recipients]).map(normalizeRecipient).filter((r) => r.address.length > 0);
 }
-// src/core/errors.ts
+//#endregion
+//#region src/core/errors.ts
+/**
+* Base error class for all ts-mailkit errors.
+*/
 var MailKitError = class extends Error {
-  constructor(message) {
-    super(message);
-    this.name = "MailKitError";
-    Object.setPrototypeOf(this, new.target.prototype);
-  }
+	constructor(message) {
+		super(message);
+		this.name = "MailKitError";
+		Object.setPrototypeOf(this, new.target.prototype);
+	}
 };
+/**
+* Thrown when transport configuration is missing or invalid.
+*/
 var ConfigurationError = class extends MailKitError {
-  constructor(message) {
-    super(message);
-    this.name = "ConfigurationError";
-    Object.setPrototypeOf(this, new.target.prototype);
-  }
+	constructor(message) {
+		super(message);
+		this.name = "ConfigurationError";
+		Object.setPrototypeOf(this, new.target.prototype);
+	}
 };
+/**
+* Thrown when an email transport fails to dispatch an email.
+*/
 var TransportError = class extends MailKitError {
-  transportName;
-  statusCode;
-  responseBody;
-  cause;
-  constructor(message, options) {
-    super(message);
-    this.name = "TransportError";
-    this.transportName = options.transportName;
-    this.statusCode = options.statusCode;
-    this.responseBody = options.responseBody;
-    this.cause = options.cause;
-    Object.setPrototypeOf(this, new.target.prototype);
-  }
+	transportName;
+	statusCode;
+	responseBody;
+	/** Parsed raw provider response, when available. */
+	rawResponse;
+	cause;
+	constructor(message, options) {
+		super(message);
+		this.name = "TransportError";
+		this.transportName = options.transportName;
+		this.statusCode = options.statusCode;
+		this.responseBody = options.responseBody;
+		this.rawResponse = options.rawResponse;
+		this.cause = options.cause;
+		Object.setPrototypeOf(this, new.target.prototype);
+	}
 };
+/**
+* Thrown when template rendering or DTO validation fails.
+*/
 var TemplateError = class extends MailKitError {
-  constructor(message) {
-    super(message);
-    this.name = "TemplateError";
-    Object.setPrototypeOf(this, new.target.prototype);
-  }
+	constructor(message) {
+		super(message);
+		this.name = "TemplateError";
+		Object.setPrototypeOf(this, new.target.prototype);
+	}
 };
-// src/renderers/utils/html-to-plaintext.ts
+//#endregion
+//#region src/renderers/utils/html-to-plaintext.ts
+/**
+* Decodes common HTML entities into their plain text equivalents.
+*/
 function decodeHtmlEntities(text) {
-  return text.replace(/&nbsp;/gi, " ").replace(/&amp;/gi, "&").replace(/&lt;/gi, "<").replace(/&gt;/gi, ">").replace(/&quot;/gi, '"').replace(/&#39;/gi, "'").replace(/&copy;/gi, "\xA9").replace(/&reg;/gi, "\xAE").replace(/&trade;/gi, "\u2122");
+	return text.replace(/&nbsp;/gi, " ").replace(/&amp;/gi, "&").replace(/&lt;/gi, "<").replace(/&gt;/gi, ">").replace(/&quot;/gi, "\"").replace(/&#39;/gi, "'").replace(/&copy;/gi, "©").replace(/&reg;/gi, "®").replace(/&trade;/gi, "™");
 }
+/**
+* Strips HTML tags and normalizes whitespace into readable plain text.
+* Converts <br>, <p>, and <div> into appropriate line breaks.
+*/
 function htmlToPlainText(html) {
-  if (!html) return "";
-  return decodeHtmlEntities(
-    html.replace(/<br\s*\/?>/gi, "\n").replace(/<\/p>/gi, "\n\n").replace(/<\/div>/gi, "\n").replace(/<\/h[1-6]>/gi, "\n\n").replace(/<[^>]*>/g, "")
-  ).replace(/[ \t]+/g, " ").replace(/\n\s*\n\s*\n+/g, "\n\n").trim();
+	if (!html) return "";
+	return decodeHtmlEntities(html.replace(/<br\s*\/?>/gi, "\n").replace(/<\/p>/gi, "\n\n").replace(/<\/div>/gi, "\n").replace(/<\/h[1-6]>/gi, "\n\n").replace(/<[^>]*>/g, "")).replace(/[ \t]+/g, " ").replace(/\n\s*\n\s*\n+/g, "\n\n").trim();
 }
-// src/renderers/default/default-renderer.ts
+//#endregion
+//#region src/renderers/default/default-renderer.ts
+/**
+* Validates whether a string is a valid HTTP or HTTPS URL.
+*/
 function isValidHttpUrl(urlString) {
-  if (!urlString || typeof urlString !== "string") return false;
-  try {
-    const url = new URL(urlString.trim());
-    return (url.protocol === "http:" || url.protocol === "https:") && url.hostname.length > 0;
-  } catch {
-    return false;
-  }
+	if (!urlString || typeof urlString !== "string") return false;
+	try {
+		const url = new URL(urlString.trim());
+		return (url.protocol === "http:" || url.protocol === "https:") && url.hostname.length > 0;
+	} catch {
+		return false;
+	}
 }
+/**
+* Builds a plain-text fallback string from an email DTO.
+*/
 function buildPlainText(dto) {
-  if (dto.noHtmlMessage) {
-    return dto.noHtmlMessage;
-  }
-  const divider = "\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500";
-  const parts = [];
-  if (dto.header) {
-    parts.push(dto.header, divider);
-  }
-  if (dto.body) {
-    parts.push(htmlToPlainText(dto.body));
-  }
-  if (dto.otpCode) {
-    parts.push(`Verification Code: ${dto.otpCode}`);
-  }
-  if (dto.actionText && dto.actionUrl) {
-    parts.push(`${dto.actionText}: ${dto.actionUrl}`);
-  }
-  if (dto.extraMessage) {
-    parts.push(htmlToPlainText(dto.extraMessage));
-  }
-  if (dto.footer) {
-    parts.push(`${divider}
-${htmlToPlainText(dto.footer)}`);
-  }
-  return parts.join("\n\n");
+	if (dto.noHtmlMessage) return dto.noHtmlMessage;
+	const divider = "──────────────────────────────";
+	const parts = [];
+	if (dto.header) parts.push(dto.header, divider);
+	if (dto.body) parts.push(htmlToPlainText(dto.body));
+	if (dto.otpCode) parts.push(`Verification Code: ${dto.otpCode}`);
+	if (dto.actionText && dto.actionUrl) parts.push(`${dto.actionText}: ${dto.actionUrl}`);
+	if (dto.extraMessage) parts.push(htmlToPlainText(dto.extraMessage));
+	if (dto.footer) parts.push(`${divider}\n${htmlToPlainText(dto.footer)}`);
+	return parts.join("\n\n");
 }
+/**
+* Builds a responsive, styled HTML email document from an email DTO.
+*/
 function buildHtml(dto, options = {}) {
-  const primaryColor = options.primaryColor || "#4f46e5";
-  const fontFamily = options.fontFamily || "-apple-system, BlinkMacSystemFont, 'Segoe UI', Roboto, Helvetica, Arial, sans-serif";
-  const maxWidth = options.maxWidth || "600px";
-  const parts = [
-    `<!DOCTYPE html>`,
-    `<html lang="en">`,
-    `<head>`,
-    `<meta charset="UTF-8">`,
-    `<meta name="viewport" content="width=device-width, initial-scale=1.0">`,
-    `<title>${dto.subject}</title>`,
-    `</head>`,
-    `<body style="margin:0;padding:24px 16px;background-color:#f9fafb;font-family:${fontFamily};color:#1f2937;line-height:1.6;">`,
-    `<div style="max-width:${maxWidth};margin:0 auto;background-color:#ffffff;padding:32px 28px;border-radius:8px;box-shadow:0 1px 3px rgba(0,0,0,0.1);border:1px solid #f3f4f6;">`
-  ];
-  const logoCandidate = dto.logoUrl ?? options.logoUrl;
-  if (logoCandidate && isValidHttpUrl(logoCandidate)) {
-    const validLogo = logoCandidate.trim();
-    parts.push(
-      `<div style="margin-bottom:24px;text-align:center;">`,
-      `  <img src="${validLogo}" alt="${dto.fromName || "Logo"}" style="max-height:48px;max-width:200px;height:auto;width:auto;display:inline-block;border:0;outline:none;text-decoration:none;" />`,
-      `</div>`
-    );
-  }
-  if (dto.imageUrl) {
-    parts.push(
-      `<div style="margin-bottom:24px;text-align:center;">`,
-      `  <img src="${dto.imageUrl}" alt="Header" style="max-width:100%;height:auto;border-radius:6px;" />`,
-      `</div>`
-    );
-  }
-  if (dto.header) {
-    parts.push(
-      `<h2 style="margin:0 0 16px;font-size:1.5rem;font-weight:700;color:#111827;letter-spacing:-0.025em;">${dto.header}</h2>`
-    );
-  }
-  if (dto.body) {
-    parts.push(`<div style="margin:0 0 20px;font-size:1rem;color:#374151;">${dto.body}</div>`);
-  }
-  if (dto.otpCode) {
-    parts.push(
-      `<div style="margin:24px 0;padding:20px;background-color:#f3f4f6;border-radius:8px;text-align:center;">`,
-      `  <span style="font-size:2rem;letter-spacing:0.5rem;font-weight:700;color:#111827;font-family:monospace;">${dto.otpCode}</span>`,
-      `</div>`
-    );
-  }
-  if (dto.actionUrl && dto.actionText) {
-    parts.push(
-      `<div style="margin:24px 0;text-align:center;">`,
-      `  <a href="${dto.actionUrl}" style="display:inline-block;padding:12px 28px;background-color:${primaryColor};color:#ffffff;border-radius:6px;text-decoration:none;font-weight:600;font-size:1rem;text-align:center;box-sizing:border-box;">${dto.actionText}</a>`,
-      `</div>`
-    );
-  }
-  if (dto.extraMessage) {
-    parts.push(
-      `<div style="margin:20px 0 0;font-size:0.875rem;color:#6b7280;line-height:1.5;">${dto.extraMessage}</div>`
-    );
-  }
-  if (dto.footer) {
-    parts.push(
-      `<div style="margin-top:32px;padding-top:20px;border-top:1px solid #e5e7eb;font-size:0.75rem;color:#9ca3af;text-align:center;">${dto.footer}</div>`
-    );
-  }
-  parts.push(`</div>`, `</body>`, `</html>`);
-  return parts.join("\n");
+	const primaryColor = options.primaryColor || "#4f46e5";
+	const fontFamily = options.fontFamily || "-apple-system, BlinkMacSystemFont, 'Segoe UI', Roboto, Helvetica, Arial, sans-serif";
+	const maxWidth = options.maxWidth || "600px";
+	const parts = [
+		`<!DOCTYPE html>`,
+		`<html lang="en">`,
+		`<head>`,
+		`<meta charset="UTF-8">`,
+		`<meta name="viewport" content="width=device-width, initial-scale=1.0">`,
+		`<title>${dto.subject}</title>`,
+		`</head>`,
+		`<body style="margin:0;padding:24px 16px;background-color:#f9fafb;font-family:${fontFamily};color:#1f2937;line-height:1.6;">`,
+		`<div style="max-width:${maxWidth};margin:0 auto;background-color:#ffffff;padding:32px 28px;border-radius:8px;box-shadow:0 1px 3px rgba(0,0,0,0.1);border:1px solid #f3f4f6;">`
+	];
+	const logoCandidate = dto.logoUrl ?? options.logoUrl;
+	if (logoCandidate && isValidHttpUrl(logoCandidate)) {
+		const validLogo = logoCandidate.trim();
+		parts.push(`<div style="margin-bottom:24px;text-align:center;">`, `  <img src="${validLogo}" alt="${dto.fromName || "Logo"}" style="max-height:48px;max-width:200px;height:auto;width:auto;display:inline-block;border:0;outline:none;text-decoration:none;" />`, `</div>`);
+	}
+	if (dto.imageUrl) parts.push(`<div style="margin-bottom:24px;text-align:center;">`, `  <img src="${dto.imageUrl}" alt="Header" style="max-width:100%;height:auto;border-radius:6px;" />`, `</div>`);
+	if (dto.header) parts.push(`<h2 style="margin:0 0 16px;font-size:1.5rem;font-weight:700;color:#111827;letter-spacing:-0.025em;">${dto.header}</h2>`);
+	if (dto.body) parts.push(`<div style="margin:0 0 20px;font-size:1rem;color:#374151;">${dto.body}</div>`);
+	if (dto.otpCode) parts.push(`<div style="margin:24px 0;padding:20px;background-color:#f3f4f6;border-radius:8px;text-align:center;">`, `  <span style="font-size:2rem;letter-spacing:0.5rem;font-weight:700;color:#111827;font-family:monospace;">${dto.otpCode}</span>`, `</div>`);
+	if (dto.actionUrl && dto.actionText) parts.push(`<div style="margin:24px 0;text-align:center;">`, `  <a href="${dto.actionUrl}" style="display:inline-block;padding:12px 28px;background-color:${primaryColor};color:#ffffff;border-radius:6px;text-decoration:none;font-weight:600;font-size:1rem;text-align:center;box-sizing:border-box;">${dto.actionText}</a>`, `</div>`);
+	if (dto.extraMessage) parts.push(`<div style="margin:20px 0 0;font-size:0.875rem;color:#6b7280;line-height:1.5;">${dto.extraMessage}</div>`);
+	if (dto.footer) parts.push(`<div style="margin-top:32px;padding-top:20px;border-top:1px solid #e5e7eb;font-size:0.75rem;color:#9ca3af;text-align:center;">${dto.footer}</div>`);
+	parts.push(`</div>`, `</body>`, `</html>`);
+	return parts.join("\n");
 }
+/**
+* Default HTML and plain-text email renderer for ts-mailkit.
+*/
 var DefaultEmailRenderer = class {
-  options;
-  constructor(options = {}) {
-    this.options = options;
-  }
-  render(dto) {
-    return {
-      html: buildHtml(dto, this.options),
-      text: buildPlainText(dto)
-    };
-  }
+	options;
+	constructor(options = {}) {
+		this.options = options;
+	}
+	render(dto) {
+		return {
+			html: buildHtml(dto, this.options),
+			text: buildPlainText(dto)
+		};
+	}
 };
-// src/core/client.ts
+//#endregion
+//#region src/core/client.ts
+/**
+* Main email client and orchestration service for ts-mailkit.
+*/
 var MailKit = class {
-  transport;
-  renderer;
-  defaultFrom;
-  defaultBrandName;
-  brandNameResolver;
-  constructor(options) {
-    if (!options.transport) {
-      throw new ConfigurationError("MailKit: A transport adapter (IEmailSender) is required.");
-    }
-    this.transport = options.transport;
-    this.renderer = options.renderer ?? new DefaultEmailRenderer();
-    this.defaultFrom = options.defaultFrom;
-    this.defaultBrandName = options.defaultBrandName;
-    this.brandNameResolver = options.brandNameResolver;
-  }
-  /**
-   * Returns the underlying transport instance.
-   */
-  getTransport() {
-    return this.transport;
-  }
-  /**
-   * Renders an email DTO to HTML and plain text without dispatching.
-   */
-  async render(template) {
-    return await this.renderer.render(template);
-  }
-  /**
-   * Sends an email using a strongly-typed template DTO.
-   *
-   * Example:
-   * ```ts
-   * await mailer.send({
-   *   to: 'user@example.com',
-   *   template: myDto,
-   * });
-   * ```
-   */
-  async send(options) {
-    const template = options.template;
-    const recipientName = options.toName ?? template.userName;
-    let resolvedFromName = options.fromName ?? template.fromName;
-    if (!resolvedFromName && this.brandNameResolver) {
-      resolvedFromName = await this.brandNameResolver();
-    }
-    if (!resolvedFromName) {
-      resolvedFromName = this.defaultBrandName;
-    }
-    const rendered = await this.renderer.render(template);
-    const plaintextBody = template.noHtmlMessage ?? rendered.text;
-    let toRecipients;
-    if (typeof options.to === "string" && recipientName) {
-      toRecipients = { address: options.to, name: recipientName };
-    } else {
-      toRecipients = options.to;
-    }
-    let from = options.from ?? this.defaultFrom;
-    if (resolvedFromName && from) {
-      const normalizedFrom = normalizeRecipient(from);
-      from = { address: normalizedFrom.address, name: resolvedFromName };
-    }
-    return await this.sendRaw({
-      to: toRecipients,
-      from,
-      subject: template.subject,
-      html: rendered.html,
-      text: plaintextBody,
-      cc: options.cc,
-      bcc: options.bcc,
-      replyTo: options.replyTo,
-      attachments: options.attachments,
-      headers: options.headers,
-      tags: options.tags,
-      metadata: options.metadata
-    });
-  }
-  /**
-   * Dispatches a raw, pre-rendered email directly through the transport.
-   * If `options.text` is omitted, plain text is automatically derived from `options.html`.
-   */
-  async sendRaw(options) {
-    const from = options.from ?? this.defaultFrom;
-    const text = options.text ?? (options.html ? htmlToPlainText(options.html) : void 0);
-    return await this.transport.send({
-      ...options,
-      from,
-      text
-    });
-  }
+	transport;
+	renderer;
+	defaultFrom;
+	defaultBrandName;
+	brandNameResolver;
+	constructor(options) {
+		if (!options.transport) throw new ConfigurationError("MailKit: A transport adapter (IEmailSender) is required.");
+		this.transport = options.transport;
+		this.renderer = options.renderer ?? new DefaultEmailRenderer();
+		this.defaultFrom = options.defaultFrom;
+		this.defaultBrandName = options.defaultBrandName;
+		this.brandNameResolver = options.brandNameResolver;
+	}
+	/**
+	* Returns the underlying transport instance.
+	*/
+	getTransport() {
+		return this.transport;
+	}
+	/**
+	* Renders an email DTO to HTML and plain text without dispatching.
+	*/
+	async render(template) {
+		return await this.renderer.render(template);
+	}
+	/**
+	* Sends an email using a strongly-typed template DTO.
+	*
+	* Example:
+	* ```ts
+	* await mailer.sendMail({
+	*   to: 'user@example.com',
+	*   template: myDto,
+	* });
+	* ```
+	*/
+	async sendMail(options) {
+		const template = options.template;
+		const recipientName = options.toName ?? template.userName;
+		const resolvedFromName = await this.resolveFromName(template, options.fromName);
+		const rendered = await this.renderer.render(template);
+		const plaintextBody = template.noHtmlMessage ?? rendered.text;
+		let toRecipients;
+		if (typeof options.to === "string" && recipientName) toRecipients = {
+			address: options.to,
+			name: recipientName
+		};
+		else toRecipients = options.to;
+		const from = this.applyFromName(options.from ?? this.defaultFrom, resolvedFromName);
+		return await this.sendRaw({
+			to: toRecipients,
+			from,
+			subject: template.subject,
+			html: rendered.html,
+			text: plaintextBody,
+			cc: options.cc,
+			bcc: options.bcc,
+			replyTo: options.replyTo,
+			attachments: options.attachments,
+			headers: options.headers,
+			tags: options.tags,
+			metadata: options.metadata
+		});
+	}
+	/**
+	* @deprecated Use {@link sendMail} instead.
+	*/
+	async send(options) {
+		return await this.sendMail(options);
+	}
+	/**
+	* Sends a bulk email using a strongly-typed template DTO.
+	*
+	* The transport delivers an individual copy to each recipient, so
+	* recipients are not exposed to one another. Per-recipient personalization
+	* is available via {@link sendBulkKnownTemplate}.
+	*
+	* Example:
+	* ```ts
+	* await mailer.sendBulkMail({
+	*   to: ['a@example.com', 'b@example.com'],
+	*   template: myDto,
+	* });
+	* ```
+	*/
+	async sendBulkMail(options) {
+		const transport = this.transport;
+		if (typeof transport.sendBulk !== "function") throw new ConfigurationError("MailKit: The configured transport does not support bulk sending (sendBulk).");
+		const template = options.template;
+		const resolvedFromName = await this.resolveFromName(template);
+		const rendered = await this.renderer.render(template);
+		const plaintextBody = template.noHtmlMessage ?? rendered.text;
+		const from = this.applyFromName(options.from ?? this.defaultFrom, resolvedFromName);
+		return await transport.sendBulk({
+			to: options.to,
+			from,
+			subject: template.subject,
+			html: rendered.html,
+			text: plaintextBody,
+			cc: options.cc,
+			bcc: options.bcc,
+			replyTo: options.replyTo,
+			attachments: options.attachments,
+			headers: options.headers,
+			tags: options.tags,
+			metadata: options.metadata,
+			trackClicks: options.trackClicks,
+			trackOpens: options.trackOpens
+		});
+	}
+	/**
+	* Sends a single email using a provider-side template.
+	*/
+	async sendKnownTemplate(options) {
+		const transport = this.transport;
+		if (typeof transport.sendKnownTemplate !== "function") throw new ConfigurationError("MailKit: The configured transport does not support template sending (sendKnownTemplate).");
+		return await transport.sendKnownTemplate({
+			...options,
+			from: options.from ?? this.defaultFrom
+		});
+	}
+	/**
+	* Sends a bulk email using a provider-side template with optional
+	* per-recipient merge data.
+	*/
+	async sendBulkKnownTemplate(options) {
+		const transport = this.transport;
+		if (typeof transport.sendBulkKnownTemplate !== "function") throw new ConfigurationError("MailKit: The configured transport does not support bulk template sending (sendBulkKnownTemplate).");
+		return await transport.sendBulkKnownTemplate({
+			...options,
+			from: options.from ?? this.defaultFrom
+		});
+	}
+	async resolveFromName(template, explicitFromName) {
+		let resolved = explicitFromName ?? template.fromName;
+		if (!resolved && this.brandNameResolver) resolved = await this.brandNameResolver();
+		if (!resolved) resolved = this.defaultBrandName;
+		return resolved;
+	}
+	applyFromName(from, fromName) {
+		if (fromName && from) return {
+			address: normalizeRecipient(from).address,
+			name: fromName
+		};
+		return from;
+	}
+	/**
+	* Dispatches a raw, pre-rendered email directly through the transport.
+	* If `options.text` is omitted, plain text is automatically derived from `options.html`.
+	*/
+	async sendRaw(options) {
+		const from = options.from ?? this.defaultFrom;
+		const text = options.text ?? (options.html ? htmlToPlainText(options.html) : void 0);
+		return await this.transport.send({
+			...options,
+			from,
+			text
+		});
+	}
 };
+/**
+* Convenience factory to create a MailKit client instance.
+*/
 function createMailKit(options) {
-  return new MailKit(options);
+	return new MailKit(options);
 }
-// src/transports/zeptomail/zeptomail-sender.ts
-var ZeptoMailHttpSender = class {
-  name = "zeptomail";
-  apiUrl;
-  authHeader;
-  defaultFrom;
-  fetchImpl;
-  constructor(config) {
-    if (!config.apiToken || typeof config.apiToken !== "string") {
-      throw new ConfigurationError("ZeptoMailHttpSender: Missing or invalid apiToken.");
-    }
-    if (!config.from) {
-      throw new ConfigurationError("ZeptoMailHttpSender: Missing required default from address.");
-    }
-    const host = (config.apiHost || "api.zeptomail.com").replace(/^https?:\/\//, "").replace(/\/+$/, "");
-    this.apiUrl = `https://${host}/v1.1/email`;
-    const token = config.apiToken.trim();
-    this.authHeader = token.startsWith("Zoho-") ? token : `Zoho-enczapikey ${token}`;
-    this.defaultFrom = normalizeRecipient(config.from);
-    if (!this.defaultFrom.address) {
-      throw new ConfigurationError("ZeptoMailHttpSender: Configured from address must not be empty.");
-    }
-    this.fetchImpl = config.fetch ?? globalThis.fetch;
-    if (typeof this.fetchImpl !== "function") {
-      throw new ConfigurationError(
-        "ZeptoMailHttpSender: No global fetch implementation found. Pass a custom fetch to ZeptoMailHttpConfig if running on Node < 18."
-      );
-    }
-  }
-  /**
-   * Dispatches an email using Zoho ZeptoMail API v1.1.
-   */
-  async send(options) {
-    const toRecipients = normalizeRecipients(options.to);
-    if (toRecipients.length === 0) {
-      throw new TransportError("ZeptoMailHttpSender: At least one recipient (to) must be specified.", {
-        transportName: this.name
-      });
-    }
-    const resolvedFrom = options.from ? normalizeRecipient(options.from) : this.defaultFrom;
-    const payload = {
-      from: {
-        address: resolvedFrom.address,
-        name: resolvedFrom.name
-      },
-      to: toRecipients.map((r) => ({
-        email_address: {
-          address: r.address,
-          name: r.name || ""
-        }
-      })),
-      subject: options.subject,
-      htmlbody: options.html,
-      textbody: options.text
-    };
-    if (options.cc) {
-      const ccList = normalizeRecipients(options.cc);
-      if (ccList.length > 0) {
-        payload.cc = ccList.map((r) => ({
-          email_address: { address: r.address, name: r.name || "" }
-        }));
-      }
-    }
-    if (options.bcc) {
-      const bccList = normalizeRecipients(options.bcc);
-      if (bccList.length > 0) {
-        payload.bcc = bccList.map((r) => ({
-          email_address: { address: r.address, name: r.name || "" }
-        }));
-      }
-    }
-    if (options.replyTo) {
-      const replyToList = normalizeRecipients(options.replyTo);
-      if (replyToList.length > 0) {
-        payload.reply_to = replyToList.map((r) => ({
-          address: r.address,
-          name: r.name
-        }));
-      }
-    }
-    if (options.attachments && options.attachments.length > 0) {
-      payload.attachments = options.attachments.map((att) => {
-        let contentBase64;
-        if (typeof att.content === "string") {
-          contentBase64 = att.content;
-        } else {
-          if (typeof Buffer !== "undefined") {
-            contentBase64 = Buffer.from(att.content).toString("base64");
-          } else {
-            let binary = "";
-            const bytes = new Uint8Array(att.content);
-            for (let i = 0; i < bytes.byteLength; i++) {
-              binary += String.fromCharCode(bytes[i]);
-            }
-            contentBase64 = btoa(binary);
-          }
-        }
-        return {
-          name: att.filename,
-          content: contentBase64,
-          mime_type: att.mimeType || att.contentType || "application/octet-stream",
-          cid: att.cid
-        };
-      });
-    }
-    let response;
-    try {
-      response = await this.fetchImpl(this.apiUrl, {
-        method: "POST",
-        headers: {
-          Accept: "application/json",
-          "Content-Type": "application/json",
-          Authorization: this.authHeader
-        },
-        body: JSON.stringify(payload)
-      });
-    } catch (err) {
-      throw new TransportError(`ZeptoMailHttpSender: Network request failed: ${err instanceof Error ? err.message : String(err)}`, {
-        transportName: this.name,
-        cause: err
-      });
-    }
-    const responseText = await response.text();
-    let responseData;
-    try {
-      responseData = responseText ? JSON.parse(responseText) : {};
-    } catch {
-      responseData = { raw: responseText };
-    }
-    if (!response.ok) {
-      const errorMessage = responseData?.error?.message || responseData?.message || `HTTP ${response.status}: ${responseText || response.statusText}`;
-      throw new TransportError(`ZeptoMailHttpSender: Failed to send email - ${errorMessage}`, {
-        transportName: this.name,
-        statusCode: response.status,
-        responseBody: responseText
-      });
-    }
-    const messageId = responseData?.data?.[0]?.message_id;
-    return {
-      success: true,
-      messageId,
-      response: responseData
-    };
-  }
+//#endregion
+//#region src/transports/cpaas/cpaas-sender.ts
+/**
+* Zoho CPaaS (formerly ZeptoMail) transactional email HTTP transport adapter.
+*
+* Uses the standard global `fetch` API for zero-dependency, universal edge
+* compatibility (Node.js, Bun, Deno, Cloudflare Workers).
+*
+* Supports:
+* - `send` — single raw email (`POST /v1.1/email`)
+* - `sendBulk` — batch raw email (`POST /v1.1/email/batch`)
+* - `sendKnownTemplate` — single template email (`POST /v1.1/email/template`)
+* - `sendBulkKnownTemplate` — batch template email (`POST /v1.1/email/template/batch`)
+*/
+var CpaasHttpSender = class {
+	name = "cpaas";
+	apiBase;
+	authHeader;
+	defaultFrom;
+	preferTemplateAlias;
+	fetchImpl;
+	constructor(config) {
+		if (!config.apiToken || typeof config.apiToken !== "string") throw new ConfigurationError("CpaasHttpSender: Missing or invalid apiToken.");
+		if (!config.from) throw new ConfigurationError("CpaasHttpSender: Missing required default from address.");
+		const host = (config.apiHost || "cpaas.zoho.com").replace(/^https?:\/\//, "").replace(/\/+$/, "");
+		this.apiBase = `https://${host}/v1.1`;
+		const token = config.apiToken.trim();
+		this.authHeader = token.startsWith("Zoho-") ? token : `Zoho-enczapikey ${token}`;
+		this.defaultFrom = normalizeRecipient(config.from);
+		if (!this.defaultFrom.address) throw new ConfigurationError("CpaasHttpSender: Configured from address must not be empty.");
+		this.preferTemplateAlias = config.preferTemplateAlias ?? false;
+		const fetchImpl = config.fetch ?? globalThis.fetch;
+		if (typeof fetchImpl !== "function") throw new ConfigurationError("CpaasHttpSender: No global fetch implementation found. Pass a custom fetch to CpaasHttpConfig if running on Node < 18.");
+		this.fetchImpl = fetchImpl.bind(globalThis);
+	}
+	/**
+	* Dispatches a single raw email using Zoho CPaaS API.
+	*/
+	async send(options) {
+		const payload = this.buildSendPayload(options);
+		return await this.post(`${this.apiBase}/email`, payload);
+	}
+	/**
+	* Dispatches a batch of a single raw email content to many recipients.
+	* The provider delivers an individual copy to each recipient.
+	*/
+	async sendBulk(options) {
+		const payload = this.buildSendPayload(options);
+		return await this.post(`${this.apiBase}/email/batch`, payload);
+	}
+	/**
+	* Dispatches a single email using a provider-side template.
+	*/
+	async sendKnownTemplate(options) {
+		const payload = this.buildTemplatePayload(options);
+		return await this.post(`${this.apiBase}/email/template`, payload);
+	}
+	/**
+	* Dispatches a batch of emails using a provider-side template, with
+	* optional per-recipient merge data.
+	*/
+	async sendBulkKnownTemplate(options) {
+		const payload = this.buildBatchTemplatePayload(options);
+		return await this.post(`${this.apiBase}/email/template/batch`, payload);
+	}
+	buildSendPayload(options) {
+		const toRecipients = normalizeRecipients(options.to);
+		if (toRecipients.length === 0) throw new TransportError("CpaasHttpSender: At least one recipient (to) must be specified.", { transportName: this.name });
+		const resolvedFrom = options.from ? normalizeRecipient(options.from) : this.defaultFrom;
+		const payload = {
+			from: {
+				address: resolvedFrom.address,
+				name: resolvedFrom.name
+			},
+			to: toRecipients.map((r) => ({ email_address: {
+				address: r.address,
+				name: r.name || ""
+			} })),
+			subject: options.subject,
+			htmlbody: options.html,
+			textbody: options.text
+		};
+		this.applyCommon(payload, options);
+		return payload;
+	}
+	buildTemplatePayload(options) {
+		const toRecipients = normalizeRecipients(options.to);
+		if (toRecipients.length === 0) throw new TransportError("CpaasHttpSender: At least one recipient (to) must be specified.", { transportName: this.name });
+		const resolvedFrom = options.from ? normalizeRecipient(options.from) : this.defaultFrom;
+		const payload = {
+			...this.templateRef(options.templateId),
+			from: {
+				address: resolvedFrom.address,
+				name: resolvedFrom.name
+			},
+			to: toRecipients.map((r) => ({ email_address: {
+				address: r.address,
+				name: r.name || ""
+			} }))
+		};
+		if (options.mergeInfo) payload.merge_info = options.mergeInfo;
+		this.applyCommon(payload, options);
+		return payload;
+	}
+	buildBatchTemplatePayload(options) {
+		if (!options.to || options.to.length === 0) throw new TransportError("CpaasHttpSender: At least one recipient (to) must be specified.", { transportName: this.name });
+		const resolvedFrom = options.from ? normalizeRecipient(options.from) : this.defaultFrom;
+		const payload = {
+			...this.templateRef(options.templateId),
+			from: {
+				address: resolvedFrom.address,
+				name: resolvedFrom.name
+			},
+			to: options.to.map((r) => ({
+				email_address: {
+					address: r.address,
+					name: r.name || ""
+				},
+				...r.mergeInfo ? { merge_info: r.mergeInfo } : {}
+			}))
+		};
+		this.applyCommon(payload, options);
+		return payload;
+	}
+	templateRef(templateId) {
+		return this.preferTemplateAlias ? { template_alias: templateId } : { template_key: templateId };
+	}
+	applyCommon(payload, options) {
+		if (options.cc) {
+			const ccList = normalizeRecipients(options.cc);
+			if (ccList.length > 0) payload.cc = ccList.map((r) => ({ email_address: {
+				address: r.address,
+				name: r.name || ""
+			} }));
+		}
+		if (options.bcc) {
+			const bccList = normalizeRecipients(options.bcc);
+			if (bccList.length > 0) payload.bcc = bccList.map((r) => ({ email_address: {
+				address: r.address,
+				name: r.name || ""
+			} }));
+		}
+		if (options.replyTo) {
+			const replyToList = normalizeRecipients(options.replyTo);
+			if (replyToList.length > 0) payload.reply_to = replyToList.map((r) => ({
+				address: r.address,
+				name: r.name
+			}));
+		}
+		if (options.attachments && options.attachments.length > 0) payload.attachments = options.attachments.map((att) => this.toAttachmentPayload(att));
+		if (options.trackClicks !== void 0) payload.track_clicks = options.trackClicks;
+		if (options.trackOpens !== void 0) payload.track_opens = options.trackOpens;
+		if (options.bounceAddress !== void 0) payload.bounce_address = options.bounceAddress;
+		if (options.clientReference !== void 0) payload.client_reference = options.clientReference;
+	}
+	toAttachmentPayload(att) {
+		let contentBase64;
+		if (typeof att.content === "string") contentBase64 = att.content;
+		else if (typeof Buffer !== "undefined") contentBase64 = Buffer.from(att.content).toString("base64");
+		else {
+			let binary = "";
+			const bytes = new Uint8Array(att.content);
+			for (let i = 0; i < bytes.byteLength; i++) binary += String.fromCharCode(bytes[i]);
+			contentBase64 = btoa(binary);
+		}
+		return {
+			name: att.filename,
+			content: contentBase64,
+			mime_type: att.mimeType || att.contentType || "application/octet-stream",
+			cid: att.cid
+		};
+	}
+	async post(url, payload) {
+		let response;
+		try {
+			response = await this.fetchImpl(url, {
+				method: "POST",
+				headers: {
+					Accept: "application/json",
+					"Content-Type": "application/json",
+					Authorization: this.authHeader
+				},
+				body: JSON.stringify(payload)
+			});
+		} catch (err) {
+			throw new TransportError(`CpaasHttpSender: Network request failed: ${err instanceof Error ? err.message : String(err)}`, {
+				transportName: this.name,
+				cause: err
+			});
+		}
+		const responseText = await response.text();
+		let responseData;
+		try {
+			responseData = responseText ? JSON.parse(responseText) : {};
+		} catch {
+			responseData = { raw: responseText };
+		}
+		if (!response.ok) {
+			const errorMessage = responseData?.data?.message || responseData?.error?.message || responseData?.message || `HTTP ${response.status}: ${responseText || response.statusText}`;
+			throw new TransportError(`CpaasHttpSender: Failed to send email - ${errorMessage}`, {
+				transportName: this.name,
+				statusCode: response.status,
+				responseBody: responseText,
+				rawResponse: responseData
+			});
+		}
+		return {
+			success: true,
+			messageId: responseData?.data?.[0]?.message_id,
+			rawResponse: responseData,
+			response: responseData
+		};
+	}
 };
-// src/transports/memory/memory-sender.ts
+//#endregion
+//#region src/transports/memory/memory-sender.ts
+/**
+* In-memory email sender for automated testing, local development, and CI environments.
+* Captures all dispatched emails and provides inspection methods.
+*/
 var MemoryEmailSender = class {
-  name = "memory";
-  sentMails = [];
-  nextId = 1;
-  async send(options) {
-    this.sentMails.push({ ...options });
-    const messageId = `mem-${this.nextId++}-${Date.now()}`;
-    return {
-      success: true,
-      messageId,
-      response: { id: messageId }
-    };
-  }
-  /**
-   * Returns a copy of all emails sent through this transport instance.
-   */
-  getSentMails() {
-    return [...this.sentMails];
-  }
-  /**
-   * Returns the most recent email sent, or undefined if no emails have been sent.
-   */
-  getLastMail() {
-    return this.sentMails.length > 0 ? { ...this.sentMails[this.sentMails.length - 1] } : void 0;
-  }
-  /**
-   * Clears all recorded sent emails.
-   */
-  clear() {
-    this.sentMails = [];
-  }
-  /**
-   * Returns the total count of sent emails.
-   */
-  count() {
-    return this.sentMails.length;
-  }
+	name = "memory";
+	sentMails = [];
+	sentBulkMails = [];
+	sentTemplateMails = [];
+	sentBulkTemplateMails = [];
+	nextId = 1;
+	result(prefix) {
+		const id = this.nextId++;
+		const messageId = prefix ? `mem-${prefix}-${id}-${Date.now()}` : `mem-${id}-${Date.now()}`;
+		const rawResponse = { id: messageId };
+		return {
+			success: true,
+			messageId,
+			rawResponse,
+			response: rawResponse
+		};
+	}
+	async send(options) {
+		this.sentMails.push({ ...options });
+		return this.result();
+	}
+	async sendBulk(options) {
+		this.sentBulkMails.push({ ...options });
+		return this.result("bulk");
+	}
+	async sendKnownTemplate(options) {
+		this.sentTemplateMails.push({ ...options });
+		return this.result("tpl");
+	}
+	async sendBulkKnownTemplate(options) {
+		this.sentBulkTemplateMails.push({ ...options });
+		return this.result("bulk-tpl");
+	}
+	/**
+	* Returns a copy of all single emails sent through this transport instance.
+	*/
+	getSentMails() {
+		return [...this.sentMails];
+	}
+	/**
+	* Returns the most recent single email sent, or undefined if none have been sent.
+	*/
+	getLastMail() {
+		return this.sentMails.length > 0 ? { ...this.sentMails[this.sentMails.length - 1] } : void 0;
+	}
+	/**
+	* Returns a copy of all bulk emails sent through this transport instance.
+	*/
+	getSentBulkMails() {
+		return [...this.sentBulkMails];
+	}
+	/**
+	* Returns a copy of all single template emails sent through this transport instance.
+	*/
+	getSentTemplateMails() {
+		return [...this.sentTemplateMails];
+	}
+	/**
+	* Returns a copy of all bulk template emails sent through this transport instance.
+	*/
+	getSentBulkTemplateMails() {
+		return [...this.sentBulkTemplateMails];
+	}
+	/**
+	* Clears all recorded emails.
+	*/
+	clear() {
+		this.sentMails = [];
+		this.sentBulkMails = [];
+		this.sentTemplateMails = [];
+		this.sentBulkTemplateMails = [];
+	}
+	/**
+	* Returns the total count of single emails sent.
+	*/
+	count() {
+		return this.sentMails.length;
+	}
 };
-// src/transports/console/console-sender.ts
+//#endregion
+//#region src/transports/console/console-sender.ts
+/**
+* Console logger transport that prints dispatched emails to stdout/stderr.
+* Ideal for development and debugging.
+*/
 var ConsoleEmailSender = class {
-  name = "console";
-  log;
-  includeHtml;
-  nextId = 1;
-  constructor(options = {}) {
-    this.log = options.logger ?? console.log;
-    this.includeHtml = options.includeHtml ?? false;
-  }
-  async send(options) {
-    const to = normalizeRecipients(options.to).map((r) => r.name ? `${r.name} <${r.address}>` : r.address).join(", ");
-    const from = options.from ? JSON.stringify(options.from) : "(default)";
-    const messageId = `console-${this.nextId++}-${Date.now()}`;
-    const separator = "\u2500".repeat(60);
-    const lines = [
-      `
-\u250C${separator}\u2510`,
-      `\u2502 [ts-mailkit:console] DISPATCHED EMAIL (${messageId})`,
-      `\u251C${separator}\u2524`,
-      `\u2502 From:    ${from}`,
-      `\u2502 To:      ${to}`,
-      `\u2502 Subject: ${options.subject}`,
-      `\u251C${separator}\u2524`
-    ];
-    if (options.text) {
-      lines.push("\u2502 Text Body:");
-      for (const line of options.text.split("\n")) {
-        lines.push(`\u2502   ${line}`);
-      }
-    }
-    if (this.includeHtml && options.html) {
-      lines.push("\u2502 HTML Body:");
-      for (const line of options.html.split("\n")) {
-        lines.push(`\u2502   ${line}`);
-      }
-    }
-    lines.push(`\u2514${separator}\u2518
-`);
-    this.log(lines.join("\n"));
-    return {
-      success: true,
-      messageId,
-      response: { logged: true }
-    };
-  }
+	name = "console";
+	log;
+	includeHtml;
+	nextId = 1;
+	constructor(options = {}) {
+		this.log = options.logger ?? console.log;
+		this.includeHtml = options.includeHtml ?? false;
+	}
+	async send(options) {
+		return this.logDispatch({
+			kind: "EMAIL",
+			to: options.to,
+			from: options.from,
+			subject: options.subject,
+			text: options.text,
+			html: options.html
+		});
+	}
+	async sendBulk(options) {
+		return this.logDispatch({
+			kind: "BULK EMAIL",
+			to: options.to,
+			from: options.from,
+			subject: options.subject,
+			text: options.text,
+			html: options.html
+		});
+	}
+	async sendKnownTemplate(options) {
+		return this.logDispatch({
+			kind: "TEMPLATE EMAIL",
+			to: options.to,
+			from: options.from,
+			templateId: options.templateId
+		});
+	}
+	async sendBulkKnownTemplate(options) {
+		return this.logDispatch({
+			kind: "BULK TEMPLATE EMAIL",
+			to: options.to,
+			from: options.from,
+			templateId: options.templateId
+		});
+	}
+	logDispatch(entry) {
+		const to = normalizeRecipients(entry.to).map((r) => r.name ? `${r.name} <${r.address}>` : r.address).join(", ");
+		const from = entry.from ? JSON.stringify(entry.from) : "(default)";
+		const messageId = `console-${this.nextId++}-${Date.now()}`;
+		const separator = "─".repeat(60);
+		const lines = [
+			`\n┌${separator}┐`,
+			`│ [ts-mailkit:console] DISPATCHED ${entry.kind} (${messageId})`,
+			`├${separator}┤`,
+			`│ From:    ${from}`,
+			`│ To:      ${to}`
+		];
+		if (entry.subject !== void 0) lines.push(`│ Subject: ${entry.subject}`);
+		if (entry.templateId !== void 0) lines.push(`│ Template: ${entry.templateId}`);
+		lines.push(`├${separator}┤`);
+		if (entry.text) {
+			lines.push("│ Text Body:");
+			for (const line of entry.text.split("\n")) lines.push(`│   ${line}`);
+		}
+		if (this.includeHtml && entry.html) {
+			lines.push("│ HTML Body:");
+			for (const line of entry.html.split("\n")) lines.push(`│   ${line}`);
+		}
+		lines.push(`└${separator}┘\n`);
+		this.log(lines.join("\n"));
+		const rawResponse = { logged: true };
+		return {
+			success: true,
+			messageId,
+			rawResponse,
+			response: rawResponse
+		};
+	}
 };
-// src/templates/factory.ts
-var DEFAULT_SECURITY_MESSAGE = "If you did not request this, please ignore this email or contact support if you have concerns.";
+//#endregion
+//#region src/templates/factory.ts
+const DEFAULT_SECURITY_MESSAGE = "If you did not request this, please ignore this email or contact support if you have concerns.";
 function defaultFooter(brandName) {
-  return `&copy; ${(/* @__PURE__ */ new Date()).getFullYear()} ${brandName}. All rights reserved.`;
+	return `&copy; ${(/* @__PURE__ */ new Date()).getFullYear()} ${brandName}. All rights reserved.`;
 }
-var EmailTemplateFactory = class _EmailTemplateFactory {
-  defaultBrandName;
-  defaultSecurityMessage;
-  footerResolver;
-  defaultLogoUrl;
-  constructor(config = {}) {
-    this.defaultBrandName = config.brandName || "Application";
-    this.defaultSecurityMessage = config.securityMessage || DEFAULT_SECURITY_MESSAGE;
-    this.defaultLogoUrl = config.logoUrl;
-    if (typeof config.footer === "function") {
-      this.footerResolver = config.footer;
-    } else if (typeof config.footer === "string") {
-      const fixedFooter = config.footer;
-      this.footerResolver = () => fixedFooter;
-    } else {
-      this.footerResolver = defaultFooter;
-    }
-  }
-  resolveBrand(override) {
-    return override || this.defaultBrandName;
-  }
-  buildFooter(brandName) {
-    return this.footerResolver(brandName);
-  }
-  /**
-   * Welcome / email-verification email sent after registration.
-   */
-  createEmailVerification(params) {
-    const { username, verificationUrl, otp, brandName } = params;
-    const brand = this.resolveBrand(brandName);
-    const body = `Hi ${username},<br/>Thank you for signing up. Use the code below or click the button to verify your email address.`;
-    return {
-      subject: "Verify Your Email Address",
-      header: `Welcome to ${brand}!`,
-      body,
-      logoUrl: this.defaultLogoUrl,
-      otpCode: otp,
-      actionUrl: verificationUrl,
-      actionText: "Verify Email",
-      extraMessage: this.defaultSecurityMessage,
-      footer: this.buildFooter(brand),
-      userName: username,
-      fromName: brand,
-      noHtmlMessage: htmlToPlainText(body) + `
-Your verification code is: ${otp}
-Alternatively, verify here:
-${verificationUrl}`
-    };
-  }
-  /**
-   * Password-reset email with an optional OTP code and action link.
-   */
-  createPasswordReset(params) {
-    const { username, resetUrl, otp = "", brandName } = params;
-    const brand = this.resolveBrand(brandName);
-    const body = `Hi ${username},<br/>We received a request to reset your password. Use the OTP code below or click the button to proceed.`;
-    const plainTextOtp = otp ? `
-Your OTP code is: ${otp}` : "";
-    return {
-      subject: "Password Reset Request",
-      header: "Reset Your Password",
-      body,
-      logoUrl: this.defaultLogoUrl,
-      otpCode: otp || void 0,
-      actionUrl: resetUrl,
-      actionText: "Reset Password",
-      extraMessage: this.defaultSecurityMessage,
-      footer: this.buildFooter(brand),
-      userName: username,
-      fromName: brand,
-      noHtmlMessage: htmlToPlainText(body) + plainTextOtp + `
-Alternatively, you can use the following link to reset your password:
-${resetUrl}`
-    };
-  }
-  /**
-   * Generic plain message email (no action button, no OTP).
-   */
-  createSimpleMessage(params) {
-    const { subject, header, body, brandName } = params;
-    const brand = this.resolveBrand(brandName);
-    return {
-      subject,
-      header,
-      body,
-      logoUrl: this.defaultLogoUrl,
-      footer: this.buildFooter(brand),
-      fromName: brand,
-      noHtmlMessage: htmlToPlainText(body)
-    };
-  }
-  /**
-   * Newsletter / announcement email with an optional hero image and CTA button.
-   */
-  createNewsLetter(params) {
-    const { subject, header, body, imageUrl, actionUrl, actionText, brandName, logoUrl } = params;
-    const brand = this.resolveBrand(brandName);
-    let noHtmlMessage = htmlToPlainText(body);
-    if (actionUrl) {
-      noHtmlMessage += `
-${actionText || "Learn more"}: ${actionUrl}`;
-    }
-    return {
-      subject,
-      header,
-      body,
-      logoUrl: logoUrl || this.defaultLogoUrl,
-      imageUrl,
-      actionUrl,
-      actionText,
-      footer: this.buildFooter(brand),
-      fromName: brand,
-      noHtmlMessage
-    };
-  }
-  /**
-   * Two-factor authentication email with OTP code and optional magic link.
-   */
-  create2FAEmail(params) {
-    const { username, otp, magicLink = "", brandName } = params;
-    const brand = this.resolveBrand(brandName);
-    const body = `Hi ${username},<br/>Use the code below or click the button to complete your login.`;
-    const plainLink = magicLink ? `
-Alternatively, verify here:
-${magicLink}` : "";
-    return {
-      subject: "Your Login Verification Code",
-      header: "Two-Factor Authentication",
-      body,
-      logoUrl: this.defaultLogoUrl,
-      otpCode: otp,
-      actionUrl: magicLink || void 0,
-      actionText: magicLink ? "Verify Login" : void 0,
-      extraMessage: this.defaultSecurityMessage,
-      footer: this.buildFooter(brand),
-      userName: username,
-      fromName: brand,
-      noHtmlMessage: htmlToPlainText(body) + `
+/**
+* Factory for creating pre-populated, type-safe email template DTOs.
+*/
+var EmailTemplateFactory = class EmailTemplateFactory {
+	defaultBrandName;
+	defaultSecurityMessage;
+	footerResolver;
+	defaultLogoUrl;
+	constructor(config = {}) {
+		this.defaultBrandName = config.brandName || "Application";
+		this.defaultSecurityMessage = config.securityMessage || DEFAULT_SECURITY_MESSAGE;
+		this.defaultLogoUrl = config.logoUrl;
+		if (typeof config.footer === "function") this.footerResolver = config.footer;
+		else if (typeof config.footer === "string") {
+			const fixedFooter = config.footer;
+			this.footerResolver = () => fixedFooter;
+		} else this.footerResolver = defaultFooter;
+	}
+	resolveBrand(override) {
+		return override || this.defaultBrandName;
+	}
+	buildFooter(brandName) {
+		return this.footerResolver(brandName);
+	}
+	/**
+	* Welcome / email-verification email sent after registration.
+	*/
+	createEmailVerification(params) {
+		const { username, verificationUrl, otp, brandName } = params;
+		const brand = this.resolveBrand(brandName);
+		const body = `Hi ${username},<br/>Thank you for signing up. Use the code below or click the button to verify your email address.`;
+		return {
+			subject: "Verify Your Email Address",
+			header: `Welcome to ${brand}!`,
+			body,
+			logoUrl: this.defaultLogoUrl,
+			otpCode: otp,
+			actionUrl: verificationUrl,
+			actionText: "Verify Email",
+			extraMessage: this.defaultSecurityMessage,
+			footer: this.buildFooter(brand),
+			userName: username,
+			fromName: brand,
+			noHtmlMessage: htmlToPlainText(body) + `\n\nYour verification code is: ${otp}\n\nAlternatively, verify here:\n${verificationUrl}`
+		};
+	}
+	/**
+	* Password-reset email with an optional OTP code and action link.
+	*/
+	createPasswordReset(params) {
+		const { username, resetUrl, otp = "", brandName } = params;
+		const brand = this.resolveBrand(brandName);
+		const body = `Hi ${username},<br/>We received a request to reset your password. Use the OTP code below or click the button to proceed.`;
+		const plainTextOtp = otp ? `\n\nYour OTP code is: ${otp}` : "";
+		return {
+			subject: "Password Reset Request",
+			header: "Reset Your Password",
+			body,
+			logoUrl: this.defaultLogoUrl,
+			otpCode: otp || void 0,
+			actionUrl: resetUrl,
+			actionText: "Reset Password",
+			extraMessage: this.defaultSecurityMessage,
+			footer: this.buildFooter(brand),
+			userName: username,
+			fromName: brand,
+			noHtmlMessage: htmlToPlainText(body) + plainTextOtp + `\n\nAlternatively, you can use the following link to reset your password:\n${resetUrl}`
+		};
+	}
+	/**
+	* Generic plain message email (no action button, no OTP).
+	*/
+	createSimpleMessage(params) {
+		const { subject, header, body, brandName } = params;
+		const brand = this.resolveBrand(brandName);
+		return {
+			subject,
+			header,
+			body,
+			logoUrl: this.defaultLogoUrl,
+			footer: this.buildFooter(brand),
+			fromName: brand,
+			noHtmlMessage: htmlToPlainText(body)
+		};
+	}
+	/**
+	* Newsletter / announcement email with an optional hero image and CTA button.
+	*/
+	createNewsLetter(params) {
+		const { subject, header, body, imageUrl, actionUrl, actionText, brandName, logoUrl } = params;
+		const brand = this.resolveBrand(brandName);
+		let noHtmlMessage = htmlToPlainText(body);
+		if (actionUrl) noHtmlMessage += `\n\n${actionText || "Learn more"}: ${actionUrl}`;
+		return {
+			subject,
+			header,
+			body,
+			logoUrl: logoUrl || this.defaultLogoUrl,
+			imageUrl,
+			actionUrl,
+			actionText,
+			footer: this.buildFooter(brand),
+			fromName: brand,
+			noHtmlMessage
+		};
+	}
+	/**
+	* Two-factor authentication email with OTP code and optional magic link.
+	*/
+	create2FAEmail(params) {
+		const { username, otp, magicLink = "", brandName } = params;
+		const brand = this.resolveBrand(brandName);
+		const body = `Hi ${username},<br/>Use the code below or click the button to complete your login.`;
+		const plainLink = magicLink ? `\n\nAlternatively, verify here:\n${magicLink}` : "";
+		return {
+			subject: "Your Login Verification Code",
+			header: "Two-Factor Authentication",
+			body,
+			logoUrl: this.defaultLogoUrl,
+			otpCode: otp,
+			actionUrl: magicLink || void 0,
+			actionText: magicLink ? "Verify Login" : void 0,
+			extraMessage: this.defaultSecurityMessage,
+			footer: this.buildFooter(brand),
+			userName: username,
+			fromName: brand,
+			noHtmlMessage: htmlToPlainText(body) + `\n\nYour verification code is: ${otp}` + plainLink
+		};
+	}
+	/**
+	* Magic link sign-in email (no OTP, button only).
+	*/
+	createMagicLinkEmail(params) {
+		const { username, magicLink, brandName } = params;
+		const brand = this.resolveBrand(brandName);
+		const body = `Hi ${username},<br/>Click the button below to sign in. No password needed.`;
+		return {
+			subject: "Your Magic Link",
+			header: `Sign In to ${brand}`,
+			body,
+			logoUrl: this.defaultLogoUrl,
+			actionUrl: magicLink,
+			actionText: "Sign In",
+			extraMessage: this.defaultSecurityMessage,
+			footer: this.buildFooter(brand),
+			userName: username,
+			fromName: brand,
+			noHtmlMessage: htmlToPlainText(body) + `\n\nSign in here:\n${magicLink}`
+		};
+	}
+	static _defaultInstance;
+	static get defaultInstance() {
+		if (!this._defaultInstance) this._defaultInstance = new EmailTemplateFactory();
+		return this._defaultInstance;
+	}
+	static createEmailVerification(params) {
+		return this.defaultInstance.createEmailVerification(params);
+	}
+	static createPasswordReset(params) {
+		return this.defaultInstance.createPasswordReset(params);
+	}
+	static createSimpleMessage(params) {
+		return this.defaultInstance.createSimpleMessage(params);
+	}
+	static createNewsLetter(params) {
+		return this.defaultInstance.createNewsLetter(params);
+	}
+	static create2FAEmail(params) {
+		return this.defaultInstance.create2FAEmail(params);
+	}
+	static createMagicLinkEmail(params) {
+		return this.defaultInstance.createMagicLinkEmail(params);
+	}
+};
-Your verification code is: ${otp}` + plainLink
-    };
-  }
-  /**
-   * Magic link sign-in email (no OTP, button only).
-   */
-  createMagicLinkEmail(params) {
-    const { username, magicLink, brandName } = params;
-    const brand = this.resolveBrand(brandName);
-    const body = `Hi ${username},<br/>Click the button below to sign in. No password needed.`;
-    return {
-      subject: "Your Magic Link",
-      header: `Sign In to ${brand}`,
-      body,
-      logoUrl: this.defaultLogoUrl,
-      actionUrl: magicLink,
-      actionText: "Sign In",
-      extraMessage: this.defaultSecurityMessage,
-      footer: this.buildFooter(brand),
-      userName: username,
-      fromName: brand,
-      noHtmlMessage: htmlToPlainText(body) + `
+//#endregion
+//#region src/templates/template-builder.ts
+/**
+* Builds an upload-ready HTML template from the canonical {@link EmailTemplateDto}.
+*
+* The output can be uploaded to a messaging platform (Zoho CPaaS, SendGrid, etc.)
+* as a provider-side template.
+*/
+function buildHTMLTemplate(dto, options = {}) {
+	return buildHtml(dto, options);
+}
+/**
+* Builds an upload-ready plain-text template from the canonical {@link EmailTemplateDto}.
+*/
+function buildPlainTextTemplate(dto, _options) {
+	return buildPlainText(dto);
+}
-Sign in here:
-${magicLink}`
-    };
-  }
-  // ─── Default Static Instance ──────────────────────────────────────────────
-  static _defaultInstance;
-  static get defaultInstance() {
-    if (!this._defaultInstance) {
-      this._defaultInstance = new _EmailTemplateFactory();
-    }
-    return this._defaultInstance;
-  }
-  static createEmailVerification(params) {
-    return this.defaultInstance.createEmailVerification(params);
-  }
-  static createPasswordReset(params) {
-    return this.defaultInstance.createPasswordReset(params);
-  }
-  static createSimpleMessage(params) {
-    return this.defaultInstance.createSimpleMessage(params);
-  }
-  static createNewsLetter(params) {
-    return this.defaultInstance.createNewsLetter(params);
-  }
-  static create2FAEmail(params) {
-    return this.defaultInstance.create2FAEmail(params);
-  }
-  static createMagicLinkEmail(params) {
-    return this.defaultInstance.createMagicLinkEmail(params);
-  }
-};
-// Annotate the CommonJS export names for ESM import in node:
-0 && (module.exports = {
-  ConfigurationError,
-  ConsoleEmailSender,
-  DefaultEmailRenderer,
-  EmailTemplateFactory,
-  MailKit,
-  MailKitError,
-  MemoryEmailSender,
-  TemplateError,
-  TransportError,
-  ZeptoMailHttpSender,
-  buildHtml,
-  buildPlainText,
-  createMailKit,
-  decodeHtmlEntities,
-  htmlToPlainText,
-  isValidHttpUrl,
-  normalizeRecipient,
-  normalizeRecipients,
-  parseEmailAddress
-});
+//#endregion
+exports.ConfigurationError = ConfigurationError;
+exports.ConsoleEmailSender = ConsoleEmailSender;
+exports.CpaasHttpSender = CpaasHttpSender;
+exports.DefaultEmailRenderer = DefaultEmailRenderer;
+exports.EmailTemplateFactory = EmailTemplateFactory;
+exports.MailKit = MailKit;
+exports.MailKitError = MailKitError;
+exports.MemoryEmailSender = MemoryEmailSender;
+exports.TemplateError = TemplateError;
+exports.TransportError = TransportError;
+exports.ZeptoMailHttpSender = CpaasHttpSender;
+exports.buildHTMLTemplate = buildHTMLTemplate;
+exports.buildHtml = buildHtml;
+exports.buildPlainText = buildPlainText;
+exports.buildPlainTextTemplate = buildPlainTextTemplate;
+exports.createMailKit = createMailKit;
+exports.decodeHtmlEntities = decodeHtmlEntities;
+exports.htmlToPlainText = htmlToPlainText;
+exports.isValidHttpUrl = isValidHttpUrl;
+exports.normalizeRecipient = normalizeRecipient;
+exports.normalizeRecipients = normalizeRecipients;
+exports.parseEmailAddress = parseEmailAddress;
 //# sourceMappingURL=index.cjs.map