@warlock.js/core 4.0.174 → 4.1.3

package/esm/mail/send-mail.mjs

@@ -0,0 +1,264 @@
+import { isDevelopmentMode, isTestMode, resolveMailConfig } from "./config.mjs";
+import { generateMailId, mailEvents } from "./events.mjs";
+import { getMailer } from "./mailer-pool.mjs";
+import { renderReactMail } from "./react-mail.mjs";
+import { captureMail } from "./test-mailbox.mjs";
+import { MailError } from "./types.mjs";
+import { log } from "@warlock.js/logger";
+import { readFile } from "node:fs/promises";
+
+//#region ../../@warlock.js/core/src/mail/send-mail.ts
+/**
+* Normalize email address to string
+*/
+function addressToString(address) {
+	if (typeof address === "string") return address;
+	return `"${address.name}" <${address.address}>`;
+}
+/**
+* Normalize recipients to array
+*/
+function normalizeRecipients(recipients) {
+	if (!recipients) return [];
+	return Array.isArray(recipients) ? recipients : [recipients];
+}
+/**
+* Map priority to nodemailer format
+*/
+function mapPriority(priority) {
+	return priority;
+}
+/**
+* Normalize mail options to internal format
+*/
+function normalizeMail(options) {
+	const config = resolveMailConfig(options);
+	return {
+		to: normalizeRecipients(options.to),
+		cc: normalizeRecipients(options.cc),
+		bcc: normalizeRecipients(options.bcc),
+		replyTo: options.replyTo,
+		from: options.from || config.from || {
+			name: "No Reply",
+			address: "noreply@localhost"
+		},
+		subject: options.subject,
+		html: options.html,
+		text: options.text,
+		attachments: options.attachments || [],
+		priority: options.priority || "normal",
+		headers: options.headers || {},
+		tags: options.tags || [],
+		correlationId: options.correlationId,
+		config
+	};
+}
+/**
+* Resolve attachment - read file if path is provided
+*/
+async function resolveAttachment(attachment) {
+	if (attachment.path) try {
+		const content = await readFile(attachment.path);
+		return {
+			filename: attachment.filename,
+			content,
+			contentType: attachment.contentType,
+			encoding: attachment.encoding,
+			cid: attachment.cid
+		};
+	} catch (error) {
+		throw new MailError(`Failed to read attachment file "${attachment.path}": ${error instanceof Error ? error.message : "Unknown error"}`, "CONFIG_ERROR", error instanceof Error ? error : void 0);
+	}
+	return {
+		filename: attachment.filename,
+		content: attachment.content,
+		contentType: attachment.contentType,
+		encoding: attachment.encoding,
+		cid: attachment.cid
+	};
+}
+/**
+* Build nodemailer options from normalized mail
+*/
+async function buildNodemailerOptions(normalized) {
+	const options = {
+		to: normalized.to,
+		from: addressToString(normalized.from),
+		subject: normalized.subject,
+		priority: mapPriority(normalized.priority)
+	};
+	if (normalized.cc.length > 0) options.cc = normalized.cc;
+	if (normalized.bcc.length > 0) options.bcc = normalized.bcc;
+	if (normalized.replyTo) options.replyTo = normalized.replyTo;
+	if (normalized.html) options.html = normalized.html;
+	if (normalized.text) options.text = normalized.text;
+	if (normalized.attachments.length > 0) options.attachments = (await Promise.all(normalized.attachments.map((att) => resolveAttachment(att)))).map((att) => ({
+		filename: att.filename,
+		content: att.content,
+		contentType: att.contentType,
+		encoding: att.encoding,
+		cid: att.cid
+	}));
+	if (Object.keys(normalized.headers).length > 0) options.headers = normalized.headers;
+	return options;
+}
+/**
+* Run per-mail event handler
+*/
+async function runMailEvent(handler, ...args) {
+	if (!handler) return;
+	try {
+		return await handler(...args);
+	} catch (error) {
+		log.error("mail", "event", `Per-mail event handler error: ${error}`);
+		return;
+	}
+}
+/**
+* Trigger both global and mail-specific events
+*/
+async function triggerEvents(mailId, event, ...args) {
+	try {
+		const globalEventName = event === "beforeSending" ? "BEFORE_SENDING" : event === "sent" ? "SENT" : event === "success" ? "SUCCESS" : "ERROR";
+		const globalResults = await mailEvents.trigger(globalEventName, ...args);
+		const specificResults = await mailEvents.triggerForMail(mailId, event, ...args);
+		return [...globalResults || [], ...specificResults || []];
+	} catch (error) {
+		log.error("mail", "event", `Event handler error: ${error}`);
+		return [];
+	}
+}
+/**
+* Send an email
+*
+* @param options Mail options including recipients, content, and configuration
+* @returns Result containing success status, message ID, and accepted/rejected recipients
+*
+* @example
+* ```typescript
+* // Basic usage
+* await sendMail({
+*   to: "user@example.com",
+*   subject: "Hello",
+*   html: "<p>World</p>",
+* });
+*
+* // With React component
+* await sendMail({
+*   to: "user@example.com",
+*   subject: "Welcome!",
+*   component: <WelcomeEmail name="John" />,
+* });
+*
+* // Track specific mail with events
+* const mailId = generateMailId();
+* mailEvents.onMailSuccess(mailId, (mail, result) => {
+*   console.log("This specific mail was sent!");
+* });
+* await sendMail({ id: mailId, to: "...", subject: "...", html: "..." });
+* ```
+*/
+async function sendMail(options) {
+	const mailId = options.id || generateMailId();
+	if (options.component) try {
+		options.html = await renderReactMail(options.component);
+	} catch (error) {
+		const mailError = new MailError(`Failed to render React component: ${error instanceof Error ? error.message : "Unknown error"}`, "RENDER_ERROR", error instanceof Error ? error : void 0);
+		await runMailEvent(options.onError, options, mailError);
+		await triggerEvents(mailId, "error", options, mailError);
+		throw mailError;
+	}
+	const normalized = normalizeMail(options);
+	const driver = normalized.config.driver || "smtp";
+	const beforeResult = await runMailEvent(options.beforeSending, options);
+	const globalBeforeResults = await triggerEvents(mailId, "beforeSending", options);
+	if (beforeResult === false || globalBeforeResults.some((r) => r === false)) {
+		log.info(`mail.${driver}`, "cancelled", "Mail sending cancelled by beforeSending event");
+		return {
+			success: false,
+			accepted: [],
+			rejected: normalized.to,
+			response: "Cancelled by beforeSending event"
+		};
+	}
+	if (isTestMode()) {
+		log.info(`mail.${driver}`, "test", `[TEST MODE] Captured mail to: ${normalized.to.join(", ")}`);
+		const result = {
+			success: true,
+			messageId: `test-${mailId}@localhost`,
+			accepted: normalized.to,
+			rejected: [],
+			response: "Test mode - mail captured"
+		};
+		captureMail({
+			options,
+			normalized,
+			timestamp: /* @__PURE__ */ new Date(),
+			result
+		});
+		await runMailEvent(options.onSuccess, options, result);
+		await triggerEvents(mailId, "success", options, result);
+		await runMailEvent(options.onSent, options, result, null);
+		await triggerEvents(mailId, "sent", options, result, null);
+		return result;
+	}
+	if (isDevelopmentMode()) {
+		log.info(`mail.${driver}`, "dev", `[DEV MODE] Would send mail to: ${normalized.to.join(", ")}`);
+		log.info(`mail.${driver}`, "dev", `Subject: ${normalized.subject}`);
+		if (normalized.html) log.info(`mail.${driver}`, "dev", `HTML length: ${normalized.html.length} chars`);
+		const result = {
+			success: true,
+			messageId: `dev-${mailId}@localhost`,
+			accepted: normalized.to,
+			rejected: [],
+			response: "Development mode - mail logged"
+		};
+		await runMailEvent(options.onSuccess, options, result);
+		await triggerEvents(mailId, "success", options, result);
+		await runMailEvent(options.onSent, options, result, null);
+		await triggerEvents(mailId, "sent", options, result, null);
+		return result;
+	}
+	try {
+		const mailer = await getMailer(resolveMailConfig(options));
+		const nodemailerOptions = await buildNodemailerOptions(normalized);
+		log.info(`mail.${driver}`, "send", `Sending mail to: ${normalized.to.join(", ")}`);
+		const output = await mailer.sendMail(nodemailerOptions);
+		const accepted = output.accepted || (output.messageId ? normalized.to : []);
+		const rejected = output.rejected || [];
+		const result = {
+			success: accepted.length > 0,
+			messageId: output.messageId,
+			accepted,
+			rejected,
+			response: output.response,
+			envelope: output.envelope
+		};
+		if (result.success) {
+			log.success(`mail.${driver}`, "sent", `Mail sent successfully (ID: ${result.messageId})`);
+			await runMailEvent(options.onSuccess, options, result);
+			await triggerEvents(mailId, "success", options, result);
+		} else log.warn(`mail.${driver}`, "partial", `Mail partially rejected: ${rejected.join(", ")}`);
+		await runMailEvent(options.onSent, options, result, null);
+		await triggerEvents(mailId, "sent", options, result, null);
+		return result;
+	} catch (error) {
+		const errorMessage = error instanceof Error ? error.message : "Unknown error";
+		let code = "UNKNOWN";
+		if (errorMessage.includes("ECONNREFUSED") || errorMessage.includes("ENOTFOUND")) code = "CONNECTION_ERROR";
+		else if (errorMessage.includes("authentication") || errorMessage.includes("auth")) code = "AUTH_ERROR";
+		else if (errorMessage.includes("timeout") || errorMessage.includes("ETIMEDOUT")) code = "TIMEOUT";
+		else if (errorMessage.includes("rate") || errorMessage.includes("limit")) code = "RATE_LIMIT";
+		const mailError = new MailError(`Failed to send mail: ${errorMessage}`, code, error instanceof Error ? error : void 0);
+		log.error(`mail.${driver}`, "error", mailError.message);
+		await runMailEvent(options.onError, options, mailError);
+		await triggerEvents(mailId, "error", options, mailError);
+		await runMailEvent(options.onSent, options, null, mailError);
+		await triggerEvents(mailId, "sent", options, null, mailError);
+		throw mailError;
+	}
+}
+
+//#endregion
+export { sendMail };
+//# sourceMappingURL=send-mail.mjs.map

package/esm/mail/send-mail.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"send-mail.mjs","names":[],"sources":["../../../../../../@warlock.js/core/src/mail/send-mail.ts"],"sourcesContent":["import { log } from \"@warlock.js/logger\";\nimport { readFile } from \"node:fs/promises\";\nimport type { Options as NodemailerOptions } from \"nodemailer/lib/mailer\";\nimport { isDevelopmentMode, isTestMode, resolveMailConfig } from \"./config\";\nimport { MAIL_EVENTS, generateMailId, mailEvents } from \"./events\";\nimport { getMailer } from \"./mailer-pool\";\nimport { renderReactMail } from \"./react-mail\";\nimport { captureMail } from \"./test-mailbox\";\nimport {\n  MailError,\n  type CapturedMail,\n  type MailAddress,\n  type MailAttachment,\n  type MailOptions,\n  type MailPriority,\n  type MailResult,\n  type NormalizedMail,\n} from \"./types\";\n\n/**\n * Normalize email address to string\n */\nfunction addressToString(address: MailAddress): string {\n  if (typeof address === \"string\") {\n    return address;\n  }\n\n  return `\"${address.name}\" <${address.address}>`;\n}\n\n/**\n * Normalize recipients to array\n */\nfunction normalizeRecipients(recipients: string | string[] | undefined): string[] {\n  if (!recipients) {\n    return [];\n  }\n\n  return Array.isArray(recipients) ? recipients : [recipients];\n}\n\n/**\n * Map priority to nodemailer format\n */\nfunction mapPriority(priority: MailPriority): \"high\" | \"normal\" | \"low\" {\n  return priority;\n}\n\n/**\n * Normalize mail options to internal format\n */\nfunction normalizeMail(options: MailOptions): NormalizedMail {\n  const config = resolveMailConfig(options);\n\n  return {\n    to: normalizeRecipients(options.to),\n    cc: normalizeRecipients(options.cc),\n    bcc: normalizeRecipients(options.bcc),\n    replyTo: options.replyTo,\n    from: options.from || config.from || { name: \"No Reply\", address: \"noreply@localhost\" },\n    subject: options.subject,\n    html: options.html,\n    text: options.text,\n    attachments: options.attachments || [],\n    priority: options.priority || \"normal\",\n    headers: options.headers || {},\n    tags: options.tags || [],\n    correlationId: options.correlationId,\n    config,\n  };\n}\n\n/**\n * Resolve attachment - read file if path is provided\n */\nasync function resolveAttachment(attachment: MailAttachment): Promise<{\n  filename: string;\n  content: Buffer | string;\n  contentType?: string;\n  encoding?: string;\n  cid?: string;\n}> {\n  // If path is provided, read the file\n  if (attachment.path) {\n    try {\n      const content = await readFile(attachment.path);\n      return {\n        filename: attachment.filename,\n        content,\n        contentType: attachment.contentType,\n        encoding: attachment.encoding,\n        cid: attachment.cid,\n      };\n    } catch (error) {\n      throw new MailError(\n        `Failed to read attachment file \"${attachment.path}\": ${error instanceof Error ? error.message : \"Unknown error\"}`,\n        \"CONFIG_ERROR\",\n        error instanceof Error ? error : undefined,\n      );\n    }\n  }\n\n  // Already has content\n  return {\n    filename: attachment.filename,\n    content: attachment.content!,\n    contentType: attachment.contentType,\n    encoding: attachment.encoding,\n    cid: attachment.cid,\n  };\n}\n\n/**\n * Build nodemailer options from normalized mail\n */\nasync function buildNodemailerOptions(normalized: NormalizedMail): Promise<NodemailerOptions> {\n  const options: NodemailerOptions = {\n    to: normalized.to,\n    from: addressToString(normalized.from),\n    subject: normalized.subject,\n    priority: mapPriority(normalized.priority),\n  };\n\n  if (normalized.cc.length > 0) {\n    options.cc = normalized.cc;\n  }\n\n  if (normalized.bcc.length > 0) {\n    options.bcc = normalized.bcc;\n  }\n\n  if (normalized.replyTo) {\n    options.replyTo = normalized.replyTo;\n  }\n\n  if (normalized.html) {\n    options.html = normalized.html;\n  }\n\n  if (normalized.text) {\n    options.text = normalized.text;\n  }\n\n  if (normalized.attachments.length > 0) {\n    // Resolve all attachments (read files if needed)\n    const resolvedAttachments = await Promise.all(\n      normalized.attachments.map((att) => resolveAttachment(att as MailAttachment)),\n    );\n\n    options.attachments = resolvedAttachments.map((att) => ({\n      filename: att.filename,\n      content: att.content,\n      contentType: att.contentType,\n      encoding: att.encoding,\n      cid: att.cid,\n    }));\n  }\n\n  if (Object.keys(normalized.headers).length > 0) {\n    options.headers = normalized.headers;\n  }\n\n  return options;\n}\n\n/**\n * Run per-mail event handler\n */\nasync function runMailEvent<T extends (...args: any[]) => any>(\n  handler: T | undefined,\n  ...args: Parameters<T>\n): Promise<ReturnType<T> | undefined> {\n  if (!handler) {\n    return undefined;\n  }\n\n  try {\n    return await handler(...args);\n  } catch (error) {\n    log.error(\"mail\", \"event\", `Per-mail event handler error: ${error}`);\n    return undefined;\n  }\n}\n\n/**\n * Trigger both global and mail-specific events\n */\nasync function triggerEvents(\n  mailId: string,\n  event: \"beforeSending\" | \"sent\" | \"success\" | \"error\",\n  ...args: any[]\n): Promise<any[]> {\n  try {\n    // Trigger global event (e.g., mail.success)\n    const globalEventName =\n      event === \"beforeSending\"\n        ? \"BEFORE_SENDING\"\n        : event === \"sent\"\n          ? \"SENT\"\n          : event === \"success\"\n            ? \"SUCCESS\"\n            : \"ERROR\";\n\n    const globalResults = await mailEvents.trigger(\n      globalEventName as keyof typeof MAIL_EVENTS,\n      ...args,\n    );\n\n    // Trigger mail-specific event (e.g., mail.$id.success)\n    const specificResults = await mailEvents.triggerForMail(mailId, event, ...args);\n\n    return [...(globalResults || []), ...(specificResults || [])];\n  } catch (error) {\n    log.error(\"mail\", \"event\", `Event handler error: ${error}`);\n    return [];\n  }\n}\n\n/**\n * Send an email\n *\n * @param options Mail options including recipients, content, and configuration\n * @returns Result containing success status, message ID, and accepted/rejected recipients\n *\n * @example\n * ```typescript\n * // Basic usage\n * await sendMail({\n *   to: \"user@example.com\",\n *   subject: \"Hello\",\n *   html: \"<p>World</p>\",\n * });\n *\n * // With React component\n * await sendMail({\n *   to: \"user@example.com\",\n *   subject: \"Welcome!\",\n *   component: <WelcomeEmail name=\"John\" />,\n * });\n *\n * // Track specific mail with events\n * const mailId = generateMailId();\n * mailEvents.onMailSuccess(mailId, (mail, result) => {\n *   console.log(\"This specific mail was sent!\");\n * });\n * await sendMail({ id: mailId, to: \"...\", subject: \"...\", html: \"...\" });\n * ```\n */\nexport async function sendMail(options: MailOptions): Promise<MailResult> {\n  // Generate or use provided mail ID\n  const mailId = options.id || generateMailId();\n\n  // Render React component if provided\n  if (options.component) {\n    try {\n      options.html = await renderReactMail(options.component);\n    } catch (error) {\n      const mailError = new MailError(\n        `Failed to render React component: ${error instanceof Error ? error.message : \"Unknown error\"}`,\n        \"RENDER_ERROR\",\n        error instanceof Error ? error : undefined,\n      );\n\n      await runMailEvent(options.onError, options, mailError);\n      await triggerEvents(mailId, \"error\", options, mailError);\n\n      throw mailError;\n    }\n  }\n\n  // Normalize mail\n  const normalized = normalizeMail(options);\n  const driver = normalized.config.driver || \"smtp\";\n\n  // Run beforeSending event (per-mail, global, and mail-specific)\n  const beforeResult = await runMailEvent(options.beforeSending, options);\n  const globalBeforeResults = await triggerEvents(mailId, \"beforeSending\", options);\n\n  // If any returns false, cancel sending\n  if (beforeResult === false || globalBeforeResults.some((r) => r === false)) {\n    log.info(\n      `mail.${driver}`,\n      \"cancelled\",\n      \"Mail sending cancelled by beforeSending event\",\n    );\n\n    const result: MailResult = {\n      success: false,\n      accepted: [],\n      rejected: normalized.to,\n      response: \"Cancelled by beforeSending event\",\n    };\n\n    return result;\n  }\n\n  // Test mode - capture without sending\n  if (isTestMode()) {\n    log.info(\n      `mail.${driver}`,\n      \"test\",\n      `[TEST MODE] Captured mail to: ${normalized.to.join(\", \")}`,\n    );\n\n    const result: MailResult = {\n      success: true,\n      messageId: `test-${mailId}@localhost`,\n      accepted: normalized.to,\n      rejected: [],\n      response: \"Test mode - mail captured\",\n    };\n\n    const captured: CapturedMail = {\n      options,\n      normalized,\n      timestamp: new Date(),\n      result,\n    };\n\n    captureMail(captured);\n\n    await runMailEvent(options.onSuccess, options, result);\n    await triggerEvents(mailId, \"success\", options, result);\n    await runMailEvent(options.onSent, options, result, null);\n    await triggerEvents(mailId, \"sent\", options, result, null);\n\n    return result;\n  }\n\n  // Development mode - log without sending\n  if (isDevelopmentMode()) {\n    log.info(\n      `mail.${driver}`,\n      \"dev\",\n      `[DEV MODE] Would send mail to: ${normalized.to.join(\", \")}`,\n    );\n    log.info(`mail.${driver}`, \"dev\", `Subject: ${normalized.subject}`);\n\n    if (normalized.html) {\n      log.info(\n        `mail.${driver}`,\n        \"dev\",\n        `HTML length: ${normalized.html.length} chars`,\n      );\n    }\n\n    const result: MailResult = {\n      success: true,\n      messageId: `dev-${mailId}@localhost`,\n      accepted: normalized.to,\n      rejected: [],\n      response: \"Development mode - mail logged\",\n    };\n\n    await runMailEvent(options.onSuccess, options, result);\n    await triggerEvents(mailId, \"success\", options, result);\n    await runMailEvent(options.onSent, options, result, null);\n    await triggerEvents(mailId, \"sent\", options, result, null);\n\n    return result;\n  }\n\n  // Production mode - actually send\n  try {\n    const config = resolveMailConfig(options);\n    const mailer = await getMailer(config);\n    const nodemailerOptions = await buildNodemailerOptions(normalized);\n\n    log.info(\n      `mail.${driver}`,\n      \"send\",\n      `Sending mail to: ${normalized.to.join(\", \")}`,\n    );\n\n    const output = await mailer.sendMail(nodemailerOptions);\n\n    const accepted = output.accepted || (output.messageId ? normalized.to : []);\n    const rejected = output.rejected || [];\n\n    const result: MailResult = {\n      success: accepted.length > 0,\n      messageId: output.messageId,\n      accepted: accepted as string[],\n      rejected: rejected as string[],\n      response: output.response,\n      envelope: output.envelope,\n    };\n\n    if (result.success) {\n      log.success(\n        `mail.${driver}`,\n        \"sent\",\n        `Mail sent successfully (ID: ${result.messageId})`,\n      );\n      await runMailEvent(options.onSuccess, options, result);\n      await triggerEvents(mailId, \"success\", options, result);\n    } else {\n      log.warn(\n        `mail.${driver}`,\n        \"partial\",\n        `Mail partially rejected: ${rejected.join(\", \")}`,\n      );\n    }\n\n    await runMailEvent(options.onSent, options, result, null);\n    await triggerEvents(mailId, \"sent\", options, result, null);\n\n    return result;\n  } catch (error) {\n    const errorMessage = error instanceof Error ? error.message : \"Unknown error\";\n    let code: MailError[\"code\"] = \"UNKNOWN\";\n\n    // Detect error type\n    if (errorMessage.includes(\"ECONNREFUSED\") || errorMessage.includes(\"ENOTFOUND\")) {\n      code = \"CONNECTION_ERROR\";\n    } else if (errorMessage.includes(\"authentication\") || errorMessage.includes(\"auth\")) {\n      code = \"AUTH_ERROR\";\n    } else if (errorMessage.includes(\"timeout\") || errorMessage.includes(\"ETIMEDOUT\")) {\n      code = \"TIMEOUT\";\n    } else if (errorMessage.includes(\"rate\") || errorMessage.includes(\"limit\")) {\n      code = \"RATE_LIMIT\";\n    }\n\n    const mailError = new MailError(\n      `Failed to send mail: ${errorMessage}`,\n      code,\n      error instanceof Error ? error : undefined,\n    );\n\n    log.error(`mail.${driver}`, \"error\", mailError.message);\n\n    await runMailEvent(options.onError, options, mailError);\n    await triggerEvents(mailId, \"error\", options, mailError);\n    await runMailEvent(options.onSent, options, null, mailError);\n    await triggerEvents(mailId, \"sent\", options, null, mailError);\n\n    throw mailError;\n  }\n}\n"],"mappings":"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"}

package/esm/mail/test-mailbox.d.mts

@@ -0,0 +1,50 @@
+import { CapturedMail } from "./types.mjs";
+
+//#region ../../@warlock.js/core/src/mail/test-mailbox.d.ts
+/**
+ * Add a mail to the test mailbox
+ */
+declare function captureMail(mail: CapturedMail): void;
+/**
+ * Get all captured mails
+ */
+declare function getTestMailbox(): CapturedMail[];
+/**
+ * Get the last captured mail
+ */
+declare function getLastMail(): CapturedMail | undefined;
+/**
+ * Find mails by recipient
+ */
+declare function findMailsTo(email: string): CapturedMail[];
+/**
+ * Find mails by subject (partial match)
+ */
+declare function findMailsBySubject(subject: string): CapturedMail[];
+/**
+ * Check if a mail was sent to a specific recipient
+ */
+declare function wasMailSentTo(email: string): boolean;
+/**
+ * Check if a mail with specific subject was sent
+ */
+declare function wasMailSentWithSubject(subject: string): boolean;
+/**
+ * Get mailbox size
+ */
+declare function getMailboxSize(): number;
+/**
+ * Clear the test mailbox
+ */
+declare function clearTestMailbox(): void;
+/**
+ * Assert helper for testing
+ */
+declare function assertMailSent(predicate: (mail: CapturedMail) => boolean): CapturedMail;
+/**
+ * Assert that a specific number of mails were sent
+ */
+declare function assertMailCount(count: number): void;
+//#endregion
+export { assertMailCount, assertMailSent, captureMail, clearTestMailbox, findMailsBySubject, findMailsTo, getLastMail, getMailboxSize, getTestMailbox, wasMailSentTo, wasMailSentWithSubject };
+//# sourceMappingURL=test-mailbox.d.mts.map

package/esm/mail/test-mailbox.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"test-mailbox.d.mts","names":[],"sources":["../../../../../../@warlock.js/core/src/mail/test-mailbox.ts"],"mappings":";;;;;;iBA2EgB,WAAA,CAAY,IAAkB,EAAZ,YAAY;;;;iBAO9B,cAAA,CAAA,GAAkB,YAAY;;;;iBAO9B,WAAA,CAAA,GAAe,YAAY;;;;iBAO3B,WAAA,CAAY,KAAA,WAAgB,YAAY;;;;iBAUxC,kBAAA,CAAmB,OAAA,WAAkB,YAAY;;;;iBAOjD,aAAA,CAAc,KAAa;;;;iBAO3B,sBAAA,CAAuB,OAAe;;;;iBAOtC,cAAA,CAAA;;;;iBAOA,gBAAA,CAAA;;;;iBAOA,cAAA,CAAe,SAAA,GAAY,IAAA,EAAM,YAAA,eAA2B,YAAY;;;;iBAaxE,eAAA,CAAgB,KAAa"}

package/esm/mail/test-mailbox.mjs

@@ -0,0 +1,79 @@
+//#region ../../@warlock.js/core/src/mail/test-mailbox.ts
+/**
+* Test mailbox for capturing sent emails in test mode
+*/
+let testMailbox = [];
+/**
+* Add a mail to the test mailbox
+*/
+function captureMail(mail) {
+	testMailbox.push(mail);
+}
+/**
+* Get all captured mails
+*/
+function getTestMailbox() {
+	return [...testMailbox];
+}
+/**
+* Get the last captured mail
+*/
+function getLastMail() {
+	return testMailbox[testMailbox.length - 1];
+}
+/**
+* Find mails by recipient
+*/
+function findMailsTo(email) {
+	return testMailbox.filter((mail) => {
+		return (Array.isArray(mail.options.to) ? mail.options.to : [mail.options.to]).includes(email);
+	});
+}
+/**
+* Find mails by subject (partial match)
+*/
+function findMailsBySubject(subject) {
+	return testMailbox.filter((mail) => mail.options.subject.includes(subject));
+}
+/**
+* Check if a mail was sent to a specific recipient
+*/
+function wasMailSentTo(email) {
+	return findMailsTo(email).length > 0;
+}
+/**
+* Check if a mail with specific subject was sent
+*/
+function wasMailSentWithSubject(subject) {
+	return testMailbox.some((mail) => mail.options.subject === subject);
+}
+/**
+* Get mailbox size
+*/
+function getMailboxSize() {
+	return testMailbox.length;
+}
+/**
+* Clear the test mailbox
+*/
+function clearTestMailbox() {
+	testMailbox = [];
+}
+/**
+* Assert helper for testing
+*/
+function assertMailSent(predicate) {
+	const mail = testMailbox.find(predicate);
+	if (!mail) throw new Error("No mail matching the predicate was found in the test mailbox");
+	return mail;
+}
+/**
+* Assert that a specific number of mails were sent
+*/
+function assertMailCount(count) {
+	if (testMailbox.length !== count) throw new Error(`Expected ${count} mails to be sent, but found ${testMailbox.length}`);
+}
+
+//#endregion
+export { assertMailCount, assertMailSent, captureMail, clearTestMailbox, findMailsBySubject, findMailsTo, getLastMail, getMailboxSize, getTestMailbox, wasMailSentTo, wasMailSentWithSubject };
+//# sourceMappingURL=test-mailbox.mjs.map

package/esm/mail/test-mailbox.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"test-mailbox.mjs","names":[],"sources":["../../../../../../@warlock.js/core/src/mail/test-mailbox.ts"],"sourcesContent":["/**\n * Test Mailbox for Mail v2\n *\n * Provides utilities for capturing and asserting sent emails in test mode.\n *\n * ## Setup\n *\n * ```typescript\n * import { setMailMode, clearTestMailbox } from \"@warlock.js/core/mail/v2\";\n *\n * beforeEach(() => {\n *   setMailMode(\"test\");\n *   clearTestMailbox();\n * });\n * ```\n *\n * ## Usage\n *\n * ```typescript\n * import { sendMail, getTestMailbox, findMailsTo } from \"@warlock.js/core/mail/v2\";\n *\n * // Send email in test mode\n * await sendMail({\n *   to: \"user@example.com\",\n *   subject: \"Welcome!\",\n *   html: \"<p>Hello</p>\",\n * });\n *\n * // Get all captured mails\n * const mails = getTestMailbox();\n * expect(mails).toHaveLength(1);\n * expect(mails[0].options.subject).toBe(\"Welcome!\");\n *\n * // Find specific mails\n * const userMails = findMailsTo(\"user@example.com\");\n * expect(userMails).toHaveLength(1);\n *\n * // Check if mail was sent\n * expect(wasMailSentTo(\"user@example.com\")).toBe(true);\n * expect(wasMailSentWithSubject(\"Welcome!\")).toBe(true);\n * ```\n *\n * ## Assertion Helpers\n *\n * ```typescript\n * // Assert a mail matching a predicate was sent\n * const mail = assertMailSent(m => m.options.to === \"user@example.com\");\n * expect(mail.options.subject).toBe(\"Welcome!\");\n *\n * // Assert exact count\n * assertMailCount(2); // throws if count doesn't match\n * ```\n *\n * ## Captured Mail Structure\n *\n * Each captured mail contains:\n * - `options` - Original MailOptions passed to sendMail\n * - `normalized` - Normalized mail data (arrays, addresses resolved)\n * - `timestamp` - When the mail was captured\n * - `result` - MailResult (in test mode, always success)\n * - `error` - MailError if sending failed (null in test mode)\n *\n * @module test-mailbox\n */\n\nimport type { CapturedMail } from \"./types\";\n\n/**\n * Test mailbox for capturing sent emails in test mode\n */\nlet testMailbox: CapturedMail[] = [];\n\n/**\n * Add a mail to the test mailbox\n */\nexport function captureMail(mail: CapturedMail): void {\n  testMailbox.push(mail);\n}\n\n/**\n * Get all captured mails\n */\nexport function getTestMailbox(): CapturedMail[] {\n  return [...testMailbox];\n}\n\n/**\n * Get the last captured mail\n */\nexport function getLastMail(): CapturedMail | undefined {\n  return testMailbox[testMailbox.length - 1];\n}\n\n/**\n * Find mails by recipient\n */\nexport function findMailsTo(email: string): CapturedMail[] {\n  return testMailbox.filter((mail) => {\n    const to = Array.isArray(mail.options.to) ? mail.options.to : [mail.options.to];\n    return to.includes(email);\n  });\n}\n\n/**\n * Find mails by subject (partial match)\n */\nexport function findMailsBySubject(subject: string): CapturedMail[] {\n  return testMailbox.filter((mail) => mail.options.subject.includes(subject));\n}\n\n/**\n * Check if a mail was sent to a specific recipient\n */\nexport function wasMailSentTo(email: string): boolean {\n  return findMailsTo(email).length > 0;\n}\n\n/**\n * Check if a mail with specific subject was sent\n */\nexport function wasMailSentWithSubject(subject: string): boolean {\n  return testMailbox.some((mail) => mail.options.subject === subject);\n}\n\n/**\n * Get mailbox size\n */\nexport function getMailboxSize(): number {\n  return testMailbox.length;\n}\n\n/**\n * Clear the test mailbox\n */\nexport function clearTestMailbox(): void {\n  testMailbox = [];\n}\n\n/**\n * Assert helper for testing\n */\nexport function assertMailSent(predicate: (mail: CapturedMail) => boolean): CapturedMail {\n  const mail = testMailbox.find(predicate);\n\n  if (!mail) {\n    throw new Error(\"No mail matching the predicate was found in the test mailbox\");\n  }\n\n  return mail;\n}\n\n/**\n * Assert that a specific number of mails were sent\n */\nexport function assertMailCount(count: number): void {\n  if (testMailbox.length !== count) {\n    throw new Error(`Expected ${count} mails to be sent, but found ${testMailbox.length}`);\n  }\n}\n"],"mappings":";;;;AAsEA,IAAI,cAA8B,CAAC;;;;AAKnC,SAAgB,YAAY,MAA0B;CACpD,YAAY,KAAK,IAAI;AACvB;;;;AAKA,SAAgB,iBAAiC;CAC/C,OAAO,CAAC,GAAG,WAAW;AACxB;;;;AAKA,SAAgB,cAAwC;CACtD,OAAO,YAAY,YAAY,SAAS;AAC1C;;;;AAKA,SAAgB,YAAY,OAA+B;CACzD,OAAO,YAAY,QAAQ,SAAS;EAElC,QADW,MAAM,QAAQ,KAAK,QAAQ,EAAE,IAAI,KAAK,QAAQ,KAAK,CAAC,KAAK,QAAQ,EAAE,GACpE,SAAS,KAAK;CAC1B,CAAC;AACH;;;;AAKA,SAAgB,mBAAmB,SAAiC;CAClE,OAAO,YAAY,QAAQ,SAAS,KAAK,QAAQ,QAAQ,SAAS,OAAO,CAAC;AAC5E;;;;AAKA,SAAgB,cAAc,OAAwB;CACpD,OAAO,YAAY,KAAK,EAAE,SAAS;AACrC;;;;AAKA,SAAgB,uBAAuB,SAA0B;CAC/D,OAAO,YAAY,MAAM,SAAS,KAAK,QAAQ,YAAY,OAAO;AACpE;;;;AAKA,SAAgB,iBAAyB;CACvC,OAAO,YAAY;AACrB;;;;AAKA,SAAgB,mBAAyB;CACvC,cAAc,CAAC;AACjB;;;;AAKA,SAAgB,eAAe,WAA0D;CACvF,MAAM,OAAO,YAAY,KAAK,SAAS;CAEvC,IAAI,CAAC,MACH,MAAM,IAAI,MAAM,8DAA8D;CAGhF,OAAO;AACT;;;;AAKA,SAAgB,gBAAgB,OAAqB;CACnD,IAAI,YAAY,WAAW,OACzB,MAAM,IAAI,MAAM,YAAY,MAAM,+BAA+B,YAAY,QAAQ;AAEzF"}