ts-mailkit 3.0.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`).
+  - `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

@@ -74,11 +74,12 @@ export declare class MailKit {
      */
     sendMail(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":"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;;;;;;;;;;;;;;OAcG;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"}
+{"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

@@ -166,11 +166,13 @@ export interface BulkKnownTemplateSendOptions extends MailAddressOptions, Tracki
     to: BulkRecipient[];
 }
 /**
- * Client-level options for sending a bulk email using the in-built template DTO.
+ * 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 to render and send to every recipient.
+     * Templated email DTO rendered once and sent to every recipient.
      */
     template: EmailTemplateDto;
     /**

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

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/core/types.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/core/types.ts"],"names":[],"mappings":"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"}

package/dist/index.cjs

@@ -259,11 +259,12 @@ var MailKit = class {
 		});
 	}
 	/**
-	* 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
@@ -360,6 +361,11 @@ function createMailKit(options) {
 //#endregion
 //#region src/transports/cpaas/cpaas-sender.ts
 /**
+* 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
@@ -370,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";
@@ -422,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;
@@ -443,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;
@@ -462,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 = {
@@ -770,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;