ts-mailkit 2.1.0 → 3.1.0

package/README.md

@@ -10,7 +10,7 @@ Works seamlessly in **Node.js**, **Cloudflare Workers** (`workerd`), **Bun**, **
 
 - **Type-Safe DTOs**: Strongly-typed Data Transfer Objects for transactional emails (verification, password reset, 2FA, magic links, newsletters).
 - **Pluggable Transports (`IEmailSender`)**: Decoupled transport adapter interface with built-in senders:
-  - `CpaasHttpSender` (Zoho CPaaS transactional API via native `fetch`; `ZeptoMailHttpSender` is a deprecated alias).
+  - `CpaasHttpSender` (Zoho CPaaS transactional API via native `fetch`; rejects requests over 500 recipients before dispatch).
   - `MemoryEmailSender` (In-memory mock transport for unit and integration testing).
   - `ConsoleEmailSender` (Formatted terminal logger for local development).
 - **Zero Runtime Dependencies**: Core uses standard web APIs (global `fetch`), ensuring zero heavy dependencies and complete edge compatibility.
@@ -261,7 +261,9 @@ export class CustomSmtpSender implements IEmailSender {
 `MailKit` exposes four canonical send methods. Bulk methods hit the provider's batch endpoints directly (no client-side loops) and deliver an individual copy to each recipient.
 
 ```ts
-// 1. Bulk manual template: one rendered DTO, delivered individually to every recipient.
+// 1. Bulk manual template: the SAME rendered DTO is delivered individually
+//    to every recipient (one batch call). For per-recipient content, use
+//    sendBulkKnownTemplate below.
 await mailer.sendBulkMail({
   to: ["a@example.com", "b@example.com"],
   template: newsletterDto,
@@ -288,6 +290,8 @@ await mailer.sendBulkKnownTemplate({
 
 Set `CpaasHttpConfig.preferTemplateAlias: true` to send `template_alias` instead of `template_key`. Every transport returns a unified `SendResult` whose `rawResponse` field holds the provider's raw response (typed via the exported `CpaasSuccessResponse` / `CpaasErrorResponse` types).
 
+> **Recipient limit:** Zoho CPaaS accepts at most **500 recipients per request**, counted across `to`, `cc`, and `bcc`. `CpaasHttpSender` validates this before making any network request and throws a `TransportError` when exceeded.
+
 ### 8. Building Upload-Ready Templates
 
 `buildHTMLTemplate` and `buildPlainTextTemplate` turn the canonical `EmailTemplateDto` into content you can upload to a messaging platform:

package/dist/core/client.d.ts

@@ -1,9 +1,8 @@
 import type { IEmailSender } from "../transports/sender.interface.js";
 import type { IEmailRenderer, RenderedEmail } from "../renderers/renderer.interface.js";
 import type { EmailTemplateDto } from "../templates/dto/index.js";
-import { type Recipient, type SendMailOptions, type SendResult } from "./types.js";
-import type { BulkKnownTemplateSendOptions, KnownTemplateSendOptions, SendBulkMailOptions } from "./bulk-types.js";
-export interface SendTemplateOptions {
+import { type BulkKnownTemplateSendOptions, type KnownTemplateSendOptions, type MailAddressOptions, type MailMetadataOptions, type Recipient, type SendBulkMailOptions, type SendMailOptions, type SendResult } from "./types.js";
+export interface SendTemplateOptions extends MailAddressOptions, MailMetadataOptions {
     /**
      * One or more recipient email addresses.
      */
@@ -20,42 +19,10 @@ export interface SendTemplateOptions {
      * Optional sender display name override for this specific email.
      */
     fromName?: string;
-    /**
-     * Optional sender email address override.
-     */
-    from?: Recipient;
-    /**
-     * Optional CC recipients.
-     */
-    cc?: Recipient | Recipient[];
-    /**
-     * Optional BCC recipients.
-     */
-    bcc?: Recipient | Recipient[];
-    /**
-     * Optional Reply-To recipients.
-     */
-    replyTo?: Recipient | Recipient[];
-    /**
-     * Optional file attachments.
-     */
-    attachments?: SendMailOptions["attachments"];
-    /**
-     * Optional custom headers.
-     */
-    headers?: Record<string, string>;
-    /**
-     * Optional tags for tracking.
-     */
-    tags?: string[];
-    /**
-     * Optional metadata.
-     */
-    metadata?: Record<string, string>;
 }
 export interface MailKitOptions {
     /**
-     * The transport adapter used to dispatch emails (e.g. ZeptoMailHttpSender, MemoryEmailSender).
+     * The transport adapter used to dispatch emails (e.g. CpaasHttpSender, MemoryEmailSender).
      */
     transport: IEmailSender;
     /**
@@ -107,15 +74,12 @@ export declare class MailKit {
      */
     sendMail(options: SendTemplateOptions): Promise<SendResult>;
     /**
-     * @deprecated Use {@link sendMail} instead.
-     */
-    send(options: SendTemplateOptions): Promise<SendResult>;
-    /**
-     * Sends a bulk email using a strongly-typed template DTO.
+     * Sends the same rendered template DTO to every recipient in a single batch.
      *
      * 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}.
+     * recipients are not exposed to one another. The content is identical for
+     * everyone; for per-recipient content, use {@link sendBulkKnownTemplate}
+     * with a provider-side template and `mergeInfo`.
      *
      * Example:
      * ```ts

package/dist/core/client.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../../src/core/client.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../../src/core/client.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,mCAAmC,CAAC;AACtE,OAAO,KAAK,EAAE,cAAc,EAAE,aAAa,EAAE,MAAM,oCAAoC,CAAC;AAGxF,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,2BAA2B,CAAC;AAClE,OAAO,EAEL,KAAK,4BAA4B,EACjC,KAAK,wBAAwB,EAC7B,KAAK,kBAAkB,EACvB,KAAK,mBAAmB,EACxB,KAAK,SAAS,EACd,KAAK,mBAAmB,EACxB,KAAK,eAAe,EACpB,KAAK,UAAU,EAChB,MAAM,YAAY,CAAC;AAGpB,MAAM,WAAW,mBAAoB,SAAQ,kBAAkB,EAAE,mBAAmB;IAClF;;OAEG;IACH,EAAE,EAAE,SAAS,GAAG,SAAS,EAAE,CAAC;IAC5B;;OAEG;IACH,QAAQ,EAAE,gBAAgB,CAAC;IAC3B;;OAEG;IACH,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB;;OAEG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,cAAc;IAC7B;;OAEG;IACH,SAAS,EAAE,YAAY,CAAC;IACxB;;OAEG;IACH,QAAQ,CAAC,EAAE,cAAc,CAAC;IAC1B;;OAEG;IACH,WAAW,CAAC,EAAE,SAAS,CAAC;IACxB;;OAEG;IACH,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B;;;OAGG;IACH,iBAAiB,CAAC,EAAE,MAAM,OAAO,CAAC,MAAM,CAAC,GAAG,MAAM,CAAC;CACpD;AAED;;GAEG;AACH,qBAAa,OAAO;IAClB,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAe;IACzC,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAiB;IAC1C,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAC,CAAY;IACzC,OAAO,CAAC,QAAQ,CAAC,gBAAgB,CAAC,CAAS;IAC3C,OAAO,CAAC,QAAQ,CAAC,iBAAiB,CAAC,CAAiC;IAEpE,YAAY,OAAO,EAAE,cAAc,EASlC;IAED;;OAEG;IACH,YAAY,IAAI,YAAY,CAE3B;IAED;;OAEG;IACG,MAAM,CAAC,QAAQ,EAAE,gBAAgB,GAAG,OAAO,CAAC,aAAa,CAAC,CAE/D;IAED;;;;;;;;;;OAUG;IACG,QAAQ,CAAC,OAAO,EAAE,mBAAmB,GAAG,OAAO,CAAC,UAAU,CAAC,CAkChE;IAED;;;;;;;;;;;;;;;OAeG;IACG,YAAY,CAAC,OAAO,EAAE,mBAAmB,GAAG,OAAO,CAAC,UAAU,CAAC,CAiCpE;IAED;;OAEG;IACG,iBAAiB,CAAC,OAAO,EAAE,wBAAwB,GAAG,OAAO,CAAC,UAAU,CAAC,CAY9E;IAED;;;OAGG;IACG,qBAAqB,CAAC,OAAO,EAAE,4BAA4B,GAAG,OAAO,CAAC,UAAU,CAAC,CAYtF;YAEa,eAAe;IAc7B,OAAO,CAAC,aAAa;IAWrB;;;OAGG;IACG,OAAO,CAAC,OAAO,EAAE,eAAe,GAAG,OAAO,CAAC,UAAU,CAAC,CAQ3D;CACF;AAED;;GAEG;AACH,wBAAgB,aAAa,CAAC,OAAO,EAAE,cAAc,GAAG,OAAO,CAE9D"}

package/dist/core/types.d.ts

@@ -1,3 +1,4 @@
+import type { EmailTemplateDto } from "../templates/dto/index.js";
 /**
  * Standard email address representation with optional display name.
  */
@@ -5,6 +6,15 @@ export interface EmailAddress {
     address: string;
     name?: string;
 }
+/**
+ * A recipient with optional provider-side merge variables.
+ */
+export interface BulkRecipient extends EmailAddress {
+    /**
+     * Provider-side merge variables (e.g. Zoho CPaaS `merge_info`).
+     */
+    mergeInfo?: Record<string, string>;
+}
 /**
  * Flexible recipient representation allowing string ('user@example.com'),
  * EmailAddress ({ address: 'user@example.com', name: 'User' }),
@@ -44,22 +54,132 @@ export interface EmailAttachment {
     cid?: string;
 }
 /**
- * Options for sending an email through a transport adapter.
+ * Common sender and recipient addressing options.
  */
-export interface SendMailOptions {
-    to: Recipient | Recipient[];
+export interface MailAddressOptions {
+    /**
+     * Optional sender address override.
+     */
     from?: Recipient;
-    subject: string;
-    html: string;
-    text?: string;
+    /**
+     * Optional CC recipients.
+     */
     cc?: Recipient | Recipient[];
+    /**
+     * Optional BCC recipients.
+     */
     bcc?: Recipient | Recipient[];
+    /**
+     * Optional Reply-To recipients.
+     */
     replyTo?: Recipient | Recipient[];
+    /**
+     * Optional file attachments.
+     */
     attachments?: EmailAttachment[];
+}
+/**
+ * Common custom header, tag, and metadata options.
+ */
+export interface MailMetadataOptions {
+    /**
+     * Optional custom headers.
+     */
     headers?: Record<string, string>;
+    /**
+     * Optional tags for tracking.
+     */
     tags?: string[];
+    /**
+     * Optional metadata.
+     */
     metadata?: Record<string, string>;
 }
+/**
+ * Common provider tracking and reference options.
+ */
+export interface TrackingOptions {
+    /**
+     * Enable or disable click tracking.
+     */
+    trackClicks?: boolean;
+    /**
+     * Enable or disable open tracking.
+     */
+    trackOpens?: boolean;
+    /**
+     * Verified bounce (Return-Path) address.
+     */
+    bounceAddress?: string;
+    /**
+     * Custom reference string to identify the email in your system.
+     */
+    clientReference?: string;
+}
+/**
+ * Options for sending an email through a transport adapter.
+ */
+export interface SendMailOptions extends MailAddressOptions, MailMetadataOptions {
+    to: Recipient | Recipient[];
+    subject: string;
+    html: string;
+    text?: string;
+}
+/**
+ * Transport-level batch of a single raw email content to many recipients.
+ *
+ * The provider delivers an individual copy to each recipient, so recipients
+ * are not exposed to one another.
+ */
+export type BulkSendOptions = SendMailOptions & TrackingOptions;
+/**
+ * Options for sending a single email using a provider-side template.
+ */
+export interface KnownTemplateSendOptions extends MailAddressOptions, TrackingOptions {
+    /**
+     * Provider-side template identifier (e.g. Zoho `template_key`).
+     */
+    templateId: string;
+    /**
+     * Recipient email address.
+     */
+    to: Recipient;
+    /**
+     * Template variable substitutions.
+     */
+    mergeInfo?: Record<string, string>;
+}
+/**
+ * Options for sending a batch of emails using a provider-side template.
+ *
+ * Each recipient may carry its own `mergeInfo` so the provider can
+ * personalize the template per recipient.
+ */
+export interface BulkKnownTemplateSendOptions extends MailAddressOptions, TrackingOptions {
+    /**
+     * Provider-side template identifier (e.g. Zoho `template_key`).
+     */
+    templateId: string;
+    /**
+     * Recipients, each with optional per-recipient merge variables.
+     */
+    to: BulkRecipient[];
+}
+/**
+ * Client-level options for sending the same in-built template DTO to many
+ * recipients. For per-recipient content, use `sendBulkKnownTemplate` with a
+ * provider-side template and `mergeInfo`.
+ */
+export interface SendBulkMailOptions extends MailAddressOptions, MailMetadataOptions, TrackingOptions {
+    /**
+     * Templated email DTO rendered once and sent to every recipient.
+     */
+    template: EmailTemplateDto;
+    /**
+     * One or more recipient email addresses.
+     */
+    to: Recipient | Recipient[];
+}
 /**
  * Result returned by an IEmailSender upon dispatch.
  */
@@ -68,9 +188,5 @@ export interface SendResult {
     messageId?: string;
     /** Raw provider response (e.g. Zoho CPaaS JSON body). */
     rawResponse?: unknown;
-    /**
-     * @deprecated Use `rawResponse` instead.
-     */
-    response?: unknown;
 }
 //# sourceMappingURL=types.d.ts.map

package/dist/core/types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/core/types.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,MAAM,WAAW,YAAY;IAC3B,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAED;;;;GAIG;AACH,MAAM,MAAM,SAAS,GAAG,MAAM,GAAG,YAAY,GAAG;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,IAAI,CAAC,EAAE,MAAM,CAAA;CAAE,CAAC;AAEjF;;;;;;GAMG;AACH,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,MAAM,GAAG,YAAY,CAa7D;AAED;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,SAAS,EAAE,SAAS,GAAG,YAAY,CAcrE;AAED;;GAEG;AACH,wBAAgB,mBAAmB,CAAC,UAAU,CAAC,EAAE,SAAS,GAAG,SAAS,EAAE,GAAG,YAAY,EAAE,CAIxF;AAED;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,QAAQ,EAAE,MAAM,CAAC;IACjB;;OAEG;IACH,OAAO,EAAE,MAAM,GAAG,UAAU,CAAC;IAC7B,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,GAAG,CAAC,EAAE,MAAM,CAAC;CACd;AAED;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,EAAE,EAAE,SAAS,GAAG,SAAS,EAAE,CAAC;IAC5B,IAAI,CAAC,EAAE,SAAS,CAAC;IACjB,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,EAAE,CAAC,EAAE,SAAS,GAAG,SAAS,EAAE,CAAC;IAC7B,GAAG,CAAC,EAAE,SAAS,GAAG,SAAS,EAAE,CAAC;IAC9B,OAAO,CAAC,EAAE,SAAS,GAAG,SAAS,EAAE,CAAC;IAClC,WAAW,CAAC,EAAE,eAAe,EAAE,CAAC;IAChC,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACjC,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;IAChB,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CACnC;AAED;;GAEG;AACH,MAAM,WAAW,UAAU;IACzB,OAAO,EAAE,OAAO,CAAC;IACjB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,yDAAyD;IACzD,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB;;OAEG;IACH,QAAQ,CAAC,EAAE,OAAO,CAAC;CACpB"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/core/types.ts"],"names":[],"mappings":"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"}

package/dist/index.cjs

@@ -259,17 +259,12 @@ var MailKit = class {
 		});
 	}
 	/**
-	* @deprecated Use {@link sendMail} instead.
-	*/
-	async send(options) {
-		return await this.sendMail(options);
-	}
-	/**
-	* Sends a bulk email using a strongly-typed template DTO.
+	* Sends the same rendered template DTO to every recipient in a single batch.
 	*
 	* 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}.
+	* recipients are not exposed to one another. The content is identical for
+	* everyone; for per-recipient content, use {@link sendBulkKnownTemplate}
+	* with a provider-side template and `mergeInfo`.
 	*
 	* Example:
 	* ```ts
@@ -301,7 +296,9 @@ var MailKit = class {
 			tags: options.tags,
 			metadata: options.metadata,
 			trackClicks: options.trackClicks,
-			trackOpens: options.trackOpens
+			trackOpens: options.trackOpens,
+			bounceAddress: options.bounceAddress,
+			clientReference: options.clientReference
 		});
 	}
 	/**
@@ -364,7 +361,12 @@ function createMailKit(options) {
 //#endregion
 //#region src/transports/cpaas/cpaas-sender.ts
 /**
-* Zoho CPaaS (formerly ZeptoMail) transactional email HTTP transport adapter.
+* Zoho CPaaS accepts at most 500 recipients per request, counted across
+* `to`, `cc`, and `bcc`.
+*/
+const CPAAS_MAX_RECIPIENTS = 500;
+/**
+* Zoho CPaaS transactional email HTTP transport adapter.
 *
 * Uses the standard global `fetch` API for zero-dependency, universal edge
 * compatibility (Node.js, Bun, Deno, Cloudflare Workers).
@@ -374,6 +376,9 @@ function createMailKit(options) {
 * - `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`)
+*
+* Requests exceeding Zoho's 500-recipient limit (across `to`, `cc`, and `bcc`)
+* are rejected before any network call is made.
 */
 var CpaasHttpSender = class {
 	name = "cpaas";
@@ -426,7 +431,16 @@ var CpaasHttpSender = class {
 		const payload = this.buildBatchTemplatePayload(options);
 		return await this.post(`${this.apiBase}/email/template/batch`, payload);
 	}
+	/**
+	* Guards against requests that exceed Zoho CPaaS's per-request recipient
+	* limit, counted across `to`, `cc`, and `bcc`.
+	*/
+	assertRecipientLimit(to, cc, bcc) {
+		const total = normalizeRecipients(to).length + normalizeRecipients(cc).length + normalizeRecipients(bcc).length;
+		if (total > CPAAS_MAX_RECIPIENTS) throw new TransportError(`CpaasHttpSender: Too many recipients (${total}). Zoho CPaaS accepts at most ${CPAAS_MAX_RECIPIENTS} recipients per request across to, cc, and bcc.`, { transportName: this.name });
+	}
 	buildSendPayload(options) {
+		this.assertRecipientLimit(options.to, options.cc, options.bcc);
 		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;
@@ -447,6 +461,7 @@ var CpaasHttpSender = class {
 		return payload;
 	}
 	buildTemplatePayload(options) {
+		this.assertRecipientLimit(options.to, options.cc, options.bcc);
 		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;
@@ -466,6 +481,7 @@ var CpaasHttpSender = class {
 		return payload;
 	}
 	buildBatchTemplatePayload(options) {
+		this.assertRecipientLimit(options.to, options.cc, options.bcc);
 		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 = {
@@ -570,8 +586,7 @@ var CpaasHttpSender = class {
 		return {
 			success: true,
 			messageId: responseData?.data?.[0]?.message_id,
-			rawResponse: responseData,
-			response: responseData
+			rawResponse: responseData
 		};
 	}
 };
@@ -592,12 +607,10 @@ var MemoryEmailSender = class {
 	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
+			rawResponse: { id: messageId }
 		};
 	}
 	async send(options) {
@@ -739,12 +752,10 @@ var ConsoleEmailSender = class {
 		}
 		lines.push(`└${separator}┘\n`);
 		this.log(lines.join("\n"));
-		const rawResponse = { logged: true };
 		return {
 			success: true,
 			messageId,
-			rawResponse,
-			response: rawResponse
+			rawResponse: { logged: true }
 		};
 	}
 };
@@ -779,130 +790,152 @@ var EmailTemplateFactory = class EmailTemplateFactory {
 	buildFooter(brandName) {
 		return this.footerResolver(brandName);
 	}
+	arrangePlainTextWithExtras(base, extraMessage, footer) {
+		const parts = [base];
+		if (extraMessage) parts.push(htmlToPlainText(extraMessage));
+		if (footer) parts.push(htmlToPlainText(footer));
+		return parts.join("\n\n");
+	}
 	/**
 	* Welcome / email-verification email sent after registration.
 	*/
 	createEmailVerification(params) {
-		const { username, verificationUrl, otp, brandName } = params;
+		const { username, verificationUrl, otp, brandName, logoUrl, extraMessage, footer } = 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.`;
+		const resolvedExtraMessage = extraMessage ?? this.defaultSecurityMessage;
+		const resolvedFooter = footer ?? this.buildFooter(brand);
+		const plainTextBody = htmlToPlainText(body) + `\n\nYour verification code is: ${otp}\n\nAlternatively, verify here:\n${verificationUrl}`;
 		return {
 			subject: "Verify Your Email Address",
 			header: `Welcome to ${brand}!`,
 			body,
-			logoUrl: this.defaultLogoUrl,
+			logoUrl: logoUrl ?? this.defaultLogoUrl,
 			otpCode: otp,
 			actionUrl: verificationUrl,
 			actionText: "Verify Email",
-			extraMessage: this.defaultSecurityMessage,
-			footer: this.buildFooter(brand),
+			extraMessage: resolvedExtraMessage,
+			footer: resolvedFooter,
 			userName: username,
 			fromName: brand,
-			noHtmlMessage: htmlToPlainText(body) + `\n\nYour verification code is: ${otp}\n\nAlternatively, verify here:\n${verificationUrl}`
+			noHtmlMessage: this.arrangePlainTextWithExtras(plainTextBody, resolvedExtraMessage, resolvedFooter)
 		};
 	}
 	/**
 	* Password-reset email with an optional OTP code and action link.
 	*/
 	createPasswordReset(params) {
-		const { username, resetUrl, otp = "", brandName } = params;
+		const { username, resetUrl, otp = "", brandName, logoUrl, extraMessage, footer } = 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}` : "";
+		const resolvedExtraMessage = extraMessage ?? this.defaultSecurityMessage;
+		const resolvedFooter = footer ?? this.buildFooter(brand);
+		const plainTextBody = htmlToPlainText(body) + plainTextOtp + `\n\nAlternatively, you can use the following link to reset your password:\n${resetUrl}`;
 		return {
 			subject: "Password Reset Request",
 			header: "Reset Your Password",
 			body,
-			logoUrl: this.defaultLogoUrl,
+			logoUrl: logoUrl ?? this.defaultLogoUrl,
 			otpCode: otp || void 0,
 			actionUrl: resetUrl,
 			actionText: "Reset Password",
-			extraMessage: this.defaultSecurityMessage,
-			footer: this.buildFooter(brand),
+			extraMessage: resolvedExtraMessage,
+			footer: resolvedFooter,
 			userName: username,
 			fromName: brand,
-			noHtmlMessage: htmlToPlainText(body) + plainTextOtp + `\n\nAlternatively, you can use the following link to reset your password:\n${resetUrl}`
+			noHtmlMessage: this.arrangePlainTextWithExtras(plainTextBody, resolvedExtraMessage, resolvedFooter)
 		};
 	}
 	/**
 	* Generic plain message email (no action button, no OTP).
 	*/
 	createSimpleMessage(params) {
-		const { subject, header, body, brandName } = params;
+		const { subject, header, body, brandName, logoUrl, extraMessage, footer } = params;
 		const brand = this.resolveBrand(brandName);
+		const resolvedFooter = footer ?? this.buildFooter(brand);
 		return {
 			subject,
 			header,
 			body,
-			logoUrl: this.defaultLogoUrl,
-			footer: this.buildFooter(brand),
+			logoUrl: logoUrl ?? this.defaultLogoUrl,
+			extraMessage,
+			footer: resolvedFooter,
 			fromName: brand,
-			noHtmlMessage: htmlToPlainText(body)
+			noHtmlMessage: this.arrangePlainTextWithExtras(htmlToPlainText(body), extraMessage, resolvedFooter)
 		};
 	}
 	/**
 	* Newsletter / announcement email with an optional hero image and CTA button.
 	*/
 	createNewsLetter(params) {
-		const { subject, header, body, imageUrl, actionUrl, actionText, brandName, logoUrl } = params;
+		const { subject, header, body, imageUrl, actionUrl, actionText, brandName, logoUrl, extraMessage, footer } = params;
 		const brand = this.resolveBrand(brandName);
-		let noHtmlMessage = htmlToPlainText(body);
-		if (actionUrl) noHtmlMessage += `\n\n${actionText || "Learn more"}: ${actionUrl}`;
+		const resolvedFooter = footer ?? this.buildFooter(brand);
+		let plainTextBody = htmlToPlainText(body);
+		if (actionUrl) plainTextBody += `\n\n${actionText || "Learn more"}: ${actionUrl}`;
 		return {
 			subject,
 			header,
 			body,
-			logoUrl: logoUrl || this.defaultLogoUrl,
+			logoUrl: logoUrl ?? this.defaultLogoUrl,
 			imageUrl,
 			actionUrl,
 			actionText,
-			footer: this.buildFooter(brand),
+			extraMessage,
+			footer: resolvedFooter,
 			fromName: brand,
-			noHtmlMessage
+			noHtmlMessage: this.arrangePlainTextWithExtras(plainTextBody, extraMessage, resolvedFooter)
 		};
 	}
 	/**
 	* Two-factor authentication email with OTP code and optional magic link.
 	*/
 	create2FAEmail(params) {
-		const { username, otp, magicLink = "", brandName } = params;
+		const { username, otp, magicLink = "", brandName, logoUrl, extraMessage, footer } = 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}` : "";
+		const resolvedExtraMessage = extraMessage ?? this.defaultSecurityMessage;
+		const resolvedFooter = footer ?? this.buildFooter(brand);
+		const plainTextBody = htmlToPlainText(body) + `\n\nYour verification code is: ${otp}` + plainLink;
 		return {
 			subject: "Your Login Verification Code",
 			header: "Two-Factor Authentication",
 			body,
-			logoUrl: this.defaultLogoUrl,
+			logoUrl: logoUrl ?? this.defaultLogoUrl,
 			otpCode: otp,
 			actionUrl: magicLink || void 0,
 			actionText: magicLink ? "Verify Login" : void 0,
-			extraMessage: this.defaultSecurityMessage,
-			footer: this.buildFooter(brand),
+			extraMessage: resolvedExtraMessage,
+			footer: resolvedFooter,
 			userName: username,
 			fromName: brand,
-			noHtmlMessage: htmlToPlainText(body) + `\n\nYour verification code is: ${otp}` + plainLink
+			noHtmlMessage: this.arrangePlainTextWithExtras(plainTextBody, resolvedExtraMessage, resolvedFooter)
 		};
 	}
 	/**
 	* Magic link sign-in email (no OTP, button only).
 	*/
 	createMagicLinkEmail(params) {
-		const { username, magicLink, brandName } = params;
+		const { username, magicLink, brandName, logoUrl, extraMessage, footer } = params;
 		const brand = this.resolveBrand(brandName);
 		const body = `Hi ${username},<br/>Click the button below to sign in. No password needed.`;
+		const resolvedExtraMessage = extraMessage ?? this.defaultSecurityMessage;
+		const resolvedFooter = footer ?? this.buildFooter(brand);
+		const plainTextBody = htmlToPlainText(body) + `\n\nSign in here:\n${magicLink}`;
 		return {
 			subject: "Your Magic Link",
 			header: `Sign In to ${brand}`,
 			body,
-			logoUrl: this.defaultLogoUrl,
+			logoUrl: logoUrl ?? this.defaultLogoUrl,
 			actionUrl: magicLink,
 			actionText: "Sign In",
-			extraMessage: this.defaultSecurityMessage,
-			footer: this.buildFooter(brand),
+			extraMessage: resolvedExtraMessage,
+			footer: resolvedFooter,
 			userName: username,
 			fromName: brand,
-			noHtmlMessage: htmlToPlainText(body) + `\n\nSign in here:\n${magicLink}`
+			noHtmlMessage: this.arrangePlainTextWithExtras(plainTextBody, resolvedExtraMessage, resolvedFooter)
 		};
 	}
 	static _defaultInstance;
@@ -959,7 +992,6 @@ exports.MailKitError = MailKitError;
 exports.MemoryEmailSender = MemoryEmailSender;
 exports.TemplateError = TemplateError;
 exports.TransportError = TransportError;
-exports.ZeptoMailHttpSender = CpaasHttpSender;
 exports.buildHTMLTemplate = buildHTMLTemplate;
 exports.buildHtml = buildHtml;
 exports.buildPlainText = buildPlainText;