@warlock.js/core 4.0.174 → 4.1.2

package/esm/mail/mail.mjs

@@ -0,0 +1,289 @@
+import { sendMail } from "./send-mail.mjs";
+
+//#region ../../@warlock.js/core/src/mail/mail.ts
+/**
+* Fluent Mail Builder
+*
+* Provides a chainable API for building and sending emails.
+*
+* @example
+* ```typescript
+* await Mail.to("user@example.com")
+*   .subject("Welcome!")
+*   .component(<WelcomeEmail name="John" />)
+*   .send();
+*
+* // With attachments
+* await Mail.to("user@example.com")
+*   .cc("manager@example.com")
+*   .subject("Invoice")
+*   .component(<InvoiceEmail order={order} />)
+*   .attach(pdfBuffer, "invoice.pdf")
+*   .send();
+*
+* // Multi-tenant
+* await Mail.config(tenant.mailSettings)
+*   .to("user@example.com")
+*   .subject("Hello")
+*   .html("<p>World</p>")
+*   .send();
+* ```
+*/
+var Mail = class Mail {
+	/**
+	* Private constructor - use static factory methods
+	*/
+	constructor() {
+		this.options = {};
+	}
+	/**
+	* Create a new mail with recipient
+	*/
+	static to(recipient) {
+		const mail = new Mail();
+		mail.options.to = recipient;
+		return mail;
+	}
+	/**
+	* Create a new mail with custom configuration (multi-tenant)
+	*/
+	static config(config) {
+		const mail = new Mail();
+		mail.options.config = config;
+		return mail;
+	}
+	/**
+	* Create a new mail with named mailer
+	*/
+	static mailer(name) {
+		const mail = new Mail();
+		mail.options.mailer = name;
+		return mail;
+	}
+	/**
+	* Set recipient(s)
+	*/
+	to(recipient) {
+		this.options.to = recipient;
+		return this;
+	}
+	/**
+	* Set CC recipient(s)
+	*/
+	cc(recipient) {
+		this.options.cc = recipient;
+		return this;
+	}
+	/**
+	* Set BCC recipient(s)
+	*/
+	bcc(recipient) {
+		this.options.bcc = recipient;
+		return this;
+	}
+	/**
+	* Set reply-to address
+	*/
+	replyTo(address) {
+		this.options.replyTo = address;
+		return this;
+	}
+	/**
+	* Set from address
+	*/
+	from(address) {
+		this.options.from = address;
+		return this;
+	}
+	/**
+	* Set subject
+	*/
+	subject(subject) {
+		this.options.subject = subject;
+		return this;
+	}
+	/**
+	* Set HTML content
+	*/
+	html(content) {
+		this.options.html = content;
+		return this;
+	}
+	/**
+	* Set plain text content
+	*/
+	text(content) {
+		this.options.text = content;
+		return this;
+	}
+	/**
+	* Set React component as content
+	*/
+	component(element) {
+		this.options.component = element;
+		return this;
+	}
+	/**
+	* Add attachment
+	*/
+	attach(content, filename, contentType) {
+		if (!this.options.attachments) this.options.attachments = [];
+		this.options.attachments.push({
+			filename,
+			content,
+			contentType
+		});
+		return this;
+	}
+	/**
+	* Add multiple attachments
+	*/
+	attachments(attachments) {
+		this.options.attachments = [...this.options.attachments || [], ...attachments];
+		return this;
+	}
+	/**
+	* Attach a file by path
+	*
+	* The file will be read automatically when the email is sent.
+	*
+	* @param path Path to the file
+	* @param filename Optional custom filename (defaults to basename of path)
+	* @param contentType Optional MIME type
+	*
+	* @example
+	* ```typescript
+	* Mail.to("user@example.com")
+	*   .subject("Invoice")
+	*   .html("<p>Please see attached</p>")
+	*   .attachFile("./invoices/2024-001.pdf")
+	*   .attachFile("./terms.pdf", "terms-and-conditions.pdf")
+	*   .send();
+	* ```
+	*/
+	attachFile(path, filename, contentType) {
+		if (!this.options.attachments) this.options.attachments = [];
+		const resolvedFilename = filename || path.split(/[/\\]/).pop() || "attachment";
+		this.options.attachments.push({
+			path,
+			filename: resolvedFilename,
+			contentType
+		});
+		return this;
+	}
+	/**
+	* Set priority
+	*/
+	priority(level) {
+		this.options.priority = level;
+		return this;
+	}
+	/**
+	* Set custom headers
+	*/
+	headers(headers) {
+		this.options.headers = {
+			...this.options.headers,
+			...headers
+		};
+		return this;
+	}
+	/**
+	* Add a custom header
+	*/
+	header(name, value) {
+		this.options.headers = {
+			...this.options.headers,
+			[name]: value
+		};
+		return this;
+	}
+	/**
+	* Set tags for categorization
+	*/
+	tags(tags) {
+		this.options.tags = tags;
+		return this;
+	}
+	/**
+	* Add a tag
+	*/
+	tag(tag) {
+		this.options.tags = [...this.options.tags || [], tag];
+		return this;
+	}
+	/**
+	* Set correlation ID for tracking
+	*/
+	correlationId(id) {
+		this.options.correlationId = id;
+		return this;
+	}
+	/**
+	* Set configuration (multi-tenant)
+	*/
+	withConfig(config) {
+		this.options.config = config;
+		return this;
+	}
+	/**
+	* Set named mailer
+	*/
+	withMailer(name) {
+		this.options.mailer = name;
+		return this;
+	}
+	/**
+	* Set beforeSending event handler
+	*/
+	beforeSending(handler) {
+		this.options.beforeSending = handler;
+		return this;
+	}
+	/**
+	* Set onSent event handler
+	*/
+	onSent(handler) {
+		this.options.onSent = handler;
+		return this;
+	}
+	/**
+	* Set onSuccess event handler
+	*/
+	onSuccess(handler) {
+		this.options.onSuccess = handler;
+		return this;
+	}
+	/**
+	* Set onError event handler
+	*/
+	onError(handler) {
+		this.options.onError = handler;
+		return this;
+	}
+	/**
+	* Get the built options (for debugging)
+	*/
+	getOptions() {
+		return { ...this.options };
+	}
+	/**
+	* Validate the mail before sending
+	*/
+	validate() {
+		if (!this.options.to) throw new Error("Mail recipient (to) is required");
+		if (!this.options.subject) throw new Error("Mail subject is required");
+		if (!this.options.html && !this.options.text && !this.options.component) throw new Error("Mail content (html, text, or component) is required");
+	}
+	/**
+	* Send the email
+	*/
+	async send() {
+		this.validate();
+		return sendMail(this.options);
+	}
+};
+
+//#endregion
+export { Mail };
+//# sourceMappingURL=mail.mjs.map

package/esm/mail/mail.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"mail.mjs","names":[],"sources":["../../../../../../@warlock.js/core/src/mail/mail.ts"],"sourcesContent":["import type React from \"react\";\nimport { sendMail } from \"./send-mail\";\nimport type {\n  MailAddress,\n  MailAttachment,\n  MailConfigurations,\n  MailEvents,\n  MailOptions,\n  MailPriority,\n  MailResult,\n} from \"./types\";\n\n/**\n * Fluent Mail Builder\n *\n * Provides a chainable API for building and sending emails.\n *\n * @example\n * ```typescript\n * await Mail.to(\"user@example.com\")\n *   .subject(\"Welcome!\")\n *   .component(<WelcomeEmail name=\"John\" />)\n *   .send();\n *\n * // With attachments\n * await Mail.to(\"user@example.com\")\n *   .cc(\"manager@example.com\")\n *   .subject(\"Invoice\")\n *   .component(<InvoiceEmail order={order} />)\n *   .attach(pdfBuffer, \"invoice.pdf\")\n *   .send();\n *\n * // Multi-tenant\n * await Mail.config(tenant.mailSettings)\n *   .to(\"user@example.com\")\n *   .subject(\"Hello\")\n *   .html(\"<p>World</p>\")\n *   .send();\n * ```\n */\nexport class Mail {\n  private options: Partial<MailOptions> = {};\n\n  /**\n   * Private constructor - use static factory methods\n   */\n  private constructor() {}\n\n  /**\n   * Create a new mail with recipient\n   */\n  public static to(recipient: string | string[]): Mail {\n    const mail = new Mail();\n    mail.options.to = recipient;\n\n    return mail;\n  }\n\n  /**\n   * Create a new mail with custom configuration (multi-tenant)\n   */\n  public static config(config: MailConfigurations): Mail {\n    const mail = new Mail();\n    mail.options.config = config;\n\n    return mail;\n  }\n\n  /**\n   * Create a new mail with named mailer\n   */\n  public static mailer(name: string): Mail {\n    const mail = new Mail();\n    mail.options.mailer = name;\n\n    return mail;\n  }\n\n  /**\n   * Set recipient(s)\n   */\n  public to(recipient: string | string[]): this {\n    this.options.to = recipient;\n\n    return this;\n  }\n\n  /**\n   * Set CC recipient(s)\n   */\n  public cc(recipient: string | string[]): this {\n    this.options.cc = recipient;\n\n    return this;\n  }\n\n  /**\n   * Set BCC recipient(s)\n   */\n  public bcc(recipient: string | string[]): this {\n    this.options.bcc = recipient;\n\n    return this;\n  }\n\n  /**\n   * Set reply-to address\n   */\n  public replyTo(address: string): this {\n    this.options.replyTo = address;\n\n    return this;\n  }\n\n  /**\n   * Set from address\n   */\n  public from(address: MailAddress): this {\n    this.options.from = address;\n\n    return this;\n  }\n\n  /**\n   * Set subject\n   */\n  public subject(subject: string): this {\n    this.options.subject = subject;\n\n    return this;\n  }\n\n  /**\n   * Set HTML content\n   */\n  public html(content: string): this {\n    this.options.html = content;\n\n    return this;\n  }\n\n  /**\n   * Set plain text content\n   */\n  public text(content: string): this {\n    this.options.text = content;\n\n    return this;\n  }\n\n  /**\n   * Set React component as content\n   */\n  public component(element: React.ReactElement): this {\n    this.options.component = element;\n\n    return this;\n  }\n\n  /**\n   * Add attachment\n   */\n  public attach(content: Buffer | string, filename: string, contentType?: string): this {\n    if (!this.options.attachments) {\n      this.options.attachments = [];\n    }\n\n    this.options.attachments.push({\n      filename,\n      content,\n      contentType,\n    });\n\n    return this;\n  }\n\n  /**\n   * Add multiple attachments\n   */\n  public attachments(attachments: MailAttachment[]): this {\n    this.options.attachments = [...(this.options.attachments || []), ...attachments];\n\n    return this;\n  }\n\n  /**\n   * Attach a file by path\n   *\n   * The file will be read automatically when the email is sent.\n   *\n   * @param path Path to the file\n   * @param filename Optional custom filename (defaults to basename of path)\n   * @param contentType Optional MIME type\n   *\n   * @example\n   * ```typescript\n   * Mail.to(\"user@example.com\")\n   *   .subject(\"Invoice\")\n   *   .html(\"<p>Please see attached</p>\")\n   *   .attachFile(\"./invoices/2024-001.pdf\")\n   *   .attachFile(\"./terms.pdf\", \"terms-and-conditions.pdf\")\n   *   .send();\n   * ```\n   */\n  public attachFile(path: string, filename?: string, contentType?: string): this {\n    if (!this.options.attachments) {\n      this.options.attachments = [];\n    }\n\n    // Extract filename from path if not provided\n    const resolvedFilename = filename || path.split(/[/\\\\]/).pop() || \"attachment\";\n\n    this.options.attachments.push({\n      path,\n      filename: resolvedFilename,\n      contentType,\n    });\n\n    return this;\n  }\n\n  /**\n   * Set priority\n   */\n  public priority(level: MailPriority): this {\n    this.options.priority = level;\n\n    return this;\n  }\n\n  /**\n   * Set custom headers\n   */\n  public headers(headers: Record<string, string>): this {\n    this.options.headers = { ...this.options.headers, ...headers };\n\n    return this;\n  }\n\n  /**\n   * Add a custom header\n   */\n  public header(name: string, value: string): this {\n    this.options.headers = { ...this.options.headers, [name]: value };\n\n    return this;\n  }\n\n  /**\n   * Set tags for categorization\n   */\n  public tags(tags: string[]): this {\n    this.options.tags = tags;\n\n    return this;\n  }\n\n  /**\n   * Add a tag\n   */\n  public tag(tag: string): this {\n    this.options.tags = [...(this.options.tags || []), tag];\n\n    return this;\n  }\n\n  /**\n   * Set correlation ID for tracking\n   */\n  public correlationId(id: string): this {\n    this.options.correlationId = id;\n\n    return this;\n  }\n\n  /**\n   * Set configuration (multi-tenant)\n   */\n  public withConfig(config: MailConfigurations): this {\n    this.options.config = config;\n\n    return this;\n  }\n\n  /**\n   * Set named mailer\n   */\n  public withMailer(name: string): this {\n    this.options.mailer = name;\n\n    return this;\n  }\n\n  /**\n   * Set beforeSending event handler\n   */\n  public beforeSending(handler: MailEvents[\"beforeSending\"]): this {\n    this.options.beforeSending = handler;\n\n    return this;\n  }\n\n  /**\n   * Set onSent event handler\n   */\n  public onSent(handler: MailEvents[\"onSent\"]): this {\n    this.options.onSent = handler;\n\n    return this;\n  }\n\n  /**\n   * Set onSuccess event handler\n   */\n  public onSuccess(handler: MailEvents[\"onSuccess\"]): this {\n    this.options.onSuccess = handler;\n\n    return this;\n  }\n\n  /**\n   * Set onError event handler\n   */\n  public onError(handler: MailEvents[\"onError\"]): this {\n    this.options.onError = handler;\n\n    return this;\n  }\n\n  /**\n   * Get the built options (for debugging)\n   */\n  public getOptions(): Partial<MailOptions> {\n    return { ...this.options };\n  }\n\n  /**\n   * Validate the mail before sending\n   */\n  private validate(): void {\n    if (!this.options.to) {\n      throw new Error(\"Mail recipient (to) is required\");\n    }\n\n    if (!this.options.subject) {\n      throw new Error(\"Mail subject is required\");\n    }\n\n    if (!this.options.html && !this.options.text && !this.options.component) {\n      throw new Error(\"Mail content (html, text, or component) is required\");\n    }\n  }\n\n  /**\n   * Send the email\n   */\n  public async send(): Promise<MailResult> {\n    this.validate();\n\n    return sendMail(this.options as MailOptions);\n  }\n}\n"],"mappings":"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"}

package/esm/mail/mailer-pool.d.mts

@@ -0,0 +1,31 @@
+import { MailConfigurations } from "./types.mjs";
+import { Transporter } from "nodemailer";
+
+//#region ../../@warlock.js/core/src/mail/mailer-pool.d.ts
+/**
+ * Get or create a mailer transporter from the pool
+ * Nodemailer is eagerly loaded at import time
+ */
+declare function getMailer(config: MailConfigurations): Promise<Transporter>;
+/**
+ * Verify a mailer connection
+ */
+declare function verifyMailer(config: MailConfigurations): Promise<boolean>;
+/**
+ * Close a specific mailer connection
+ */
+declare function closeMailer(config: MailConfigurations): void;
+/**
+ * Close all mailer connections
+ */
+declare function closeAllMailers(): void;
+/**
+ * Get pool statistics
+ */
+declare function getPoolStats(): {
+  size: number;
+  hashes: string[];
+};
+//#endregion
+export { closeAllMailers, closeMailer, getMailer, getPoolStats, verifyMailer };
+//# sourceMappingURL=mailer-pool.d.mts.map

package/esm/mail/mailer-pool.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mailer-pool.d.mts","names":[],"sources":["../../../../../../@warlock.js/core/src/mail/mailer-pool.ts"],"mappings":";;;;;;AA4KA;;iBAAsB,SAAA,CAAU,MAAA,EAAQ,kBAAA,GAAqB,OAAA,CAAQ,WAAA;;;;iBA6C/C,YAAA,CAAa,MAAA,EAAQ,kBAAA,GAAqB,OAAO;;;;iBAcvD,WAAA,CAAY,MAA0B,EAAlB,kBAAkB;;;AA3D0B;iBAyEhE,eAAA,CAAA;;;;iBAYA,YAAA,CAAA;EAAkB,IAAA;EAAc,MAAM;AAAA"}

package/esm/mail/mailer-pool.mjs

@@ -0,0 +1,190 @@
+import { log } from "@warlock.js/logger";
+
+//#region ../../@warlock.js/core/src/mail/mailer-pool.ts
+/**
+* Installation instructions for nodemailer
+*/
+const NODEMAILER_INSTALL_INSTRUCTIONS = `
+Email functionality requires the nodemailer package.
+Install it with:
+
+  warlock add mail
+
+Or manually:
+
+  npm install nodemailer
+  pnpm add nodemailer
+  yarn add nodemailer
+`.trim();
+/**
+* Module availability flag
+*/
+let moduleExists = null;
+/**
+* Cached nodemailer module (loaded at import time)
+*/
+let nodemailerModule;
+let nodemailerLoadPromise = null;
+/**
+* Eagerly load nodemailer module at import time
+*/
+async function loadNodemailerModule() {
+	try {
+		nodemailerModule = (await import("nodemailer")).default;
+		moduleExists = true;
+	} catch {
+		moduleExists = false;
+	}
+}
+nodemailerLoadPromise = loadNodemailerModule();
+const SES_INSTALL_INSTRUCTIONS = `
+AWS SES functionality requires the @aws-sdk/client-sesv2 package.
+Install it with:
+
+  warlock add ses
+
+Or manually:
+
+  npm install @aws-sdk/client-sesv2
+  pnpm add @aws-sdk/client-sesv2
+  yarn add @aws-sdk/client-sesv2
+`.trim();
+let sesModuleExists = null;
+let sesModule;
+let sesLoadPromise = null;
+async function loadSesModule() {
+	try {
+		sesModule = (await import("@aws-sdk/client-sesv2")).default;
+		sesModuleExists = true;
+	} catch {
+		sesModuleExists = false;
+	}
+}
+sesLoadPromise = loadSesModule();
+function isSesConfig(config) {
+	return "driver" in config && config.driver === "ses";
+}
+async function getSesMailer(config) {
+	if (sesModuleExists === null && sesLoadPromise) await sesLoadPromise;
+	if (sesModuleExists === false) throw new Error(`@aws-sdk/client-sesv2 is not installed.\n\n${SES_INSTALL_INSTRUCTIONS}`);
+	const hash = `ses_${config.region}_${config.accessKeyId}`;
+	const existingTransporter = mailerPool.get(hash);
+	if (existingTransporter) return existingTransporter;
+	log.info("mail", "pool", `Creating new SES mailer transport (pool size: ${mailerPool.size + 1})`);
+	const ses = new sesModule.SESv2Client({
+		region: config.region,
+		credentials: {
+			accessKeyId: config.accessKeyId,
+			secretAccessKey: config.secretAccessKey
+		}
+	});
+	const transporter = nodemailerModule.createTransport({ SES: {
+		sesClient: ses,
+		SendEmailCommand: sesModule.SendEmailCommand
+	} });
+	mailerPool.set(hash, transporter);
+	return transporter;
+}
+/**
+* Mailer pool for connection reuse
+* Maps config hash to transporter instance
+*/
+const mailerPool = /* @__PURE__ */ new Map();
+/**
+* Create a hash from mail configuration for pooling
+*/
+function createConfigHash(config) {
+	const key = JSON.stringify({
+		host: config.host,
+		port: config.port,
+		secure: config.secure,
+		auth: config.auth,
+		username: config.username,
+		password: config.password
+	});
+	let hash = 0;
+	for (let i = 0; i < key.length; i++) {
+		const char = key.charCodeAt(i);
+		hash = (hash << 5) - hash + char;
+		hash = hash & hash;
+	}
+	return `mailer_${hash}`;
+}
+/**
+* Get hash for any mailer config
+*/
+function getMailerHash(config) {
+	if (isSesConfig(config)) return `ses_${config.region}_${config.accessKeyId}`;
+	return createConfigHash(config);
+}
+/**
+* Get or create a mailer transporter from the pool
+* Nodemailer is eagerly loaded at import time
+*/
+async function getMailer(config) {
+	if (moduleExists === null && nodemailerLoadPromise) await nodemailerLoadPromise;
+	if (moduleExists === false) throw new Error(`nodemailer is not installed.\n\n${NODEMAILER_INSTALL_INSTRUCTIONS}`);
+	if (isSesConfig(config)) return getSesMailer(config);
+	const hash = getMailerHash(config);
+	const existingTransporter = mailerPool.get(hash);
+	if (existingTransporter) return existingTransporter;
+	log.info("mail", "pool", `Creating new mailer transport (pool size: ${mailerPool.size + 1})`);
+	const { auth, username, password, requireTLS, tls, ...transportConfig } = config;
+	const transporter = nodemailerModule.createTransport({
+		requireTLS: requireTLS ?? tls,
+		auth: auth ?? {
+			user: username,
+			pass: password
+		},
+		...transportConfig
+	});
+	mailerPool.set(hash, transporter);
+	return transporter;
+}
+/**
+* Verify a mailer connection
+*/
+async function verifyMailer(config) {
+	const transporter = await getMailer(config);
+	try {
+		await transporter.verify();
+		return true;
+	} catch {
+		return false;
+	}
+}
+/**
+* Close a specific mailer connection
+*/
+function closeMailer(config) {
+	const hash = getMailerHash(config);
+	const transporter = mailerPool.get(hash);
+	if (transporter) {
+		transporter.close();
+		mailerPool.delete(hash);
+		log.info("mail", "pool", `Closed mailer transport (pool size: ${mailerPool.size})`);
+	}
+}
+/**
+* Close all mailer connections
+*/
+function closeAllMailers() {
+	for (const [hash, transporter] of mailerPool) {
+		transporter.close();
+		mailerPool.delete(hash);
+	}
+	log.info("mail", "pool", "Closed all mailer transports");
+}
+/**
+* Get pool statistics
+*/
+function getPoolStats() {
+	return {
+		size: mailerPool.size,
+		hashes: Array.from(mailerPool.keys())
+	};
+}
+
+//#endregion
+export { closeAllMailers, closeMailer, getMailer, getPoolStats, verifyMailer };
+//# sourceMappingURL=mailer-pool.mjs.map

package/esm/mail/mailer-pool.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"mailer-pool.mjs","names":[],"sources":["../../../../../../@warlock.js/core/src/mail/mailer-pool.ts"],"sourcesContent":["import { log } from \"@warlock.js/logger\";\nimport type nodemailer from \"nodemailer\";\nimport type { Transporter } from \"nodemailer\";\nimport type { MailConfigurations, SESConfigurations, SMTPConfigurations } from \"./types\";\n\n// ============================================================\n// Eager-loaded Nodemailer Module\n// ============================================================\n\n/**\n * Installation instructions for nodemailer\n */\nconst NODEMAILER_INSTALL_INSTRUCTIONS = `\nEmail functionality requires the nodemailer package.\nInstall it with:\n\n  warlock add mail\n\nOr manually:\n\n  npm install nodemailer\n  pnpm add nodemailer\n  yarn add nodemailer\n`.trim();\n\n/**\n * Module availability flag\n */\nlet moduleExists: boolean | null = null;\n\n/**\n * Cached nodemailer module (loaded at import time)\n */\nlet nodemailerModule: typeof nodemailer;\n\nlet nodemailerLoadPromise: Promise<void> | null = null;\n\n/**\n * Eagerly load nodemailer module at import time\n */\nasync function loadNodemailerModule() {\n  try {\n    const module = await import(\"nodemailer\");\n    nodemailerModule = module.default;\n    moduleExists = true;\n  } catch {\n    moduleExists = false;\n  }\n}\n\n// Kick off eager loading immediately\nnodemailerLoadPromise = loadNodemailerModule();\n\nconst SES_INSTALL_INSTRUCTIONS = `\nAWS SES functionality requires the @aws-sdk/client-sesv2 package.\nInstall it with:\n\n  warlock add ses\n\nOr manually:\n\n  npm install @aws-sdk/client-sesv2\n  pnpm add @aws-sdk/client-sesv2\n  yarn add @aws-sdk/client-sesv2\n`.trim();\n\nlet sesModuleExists: boolean | null = null;\n\nlet sesModule: typeof import(\"@aws-sdk/client-sesv2\");\n\nlet sesLoadPromise: Promise<void> | null = null;\n\nasync function loadSesModule() {\n  try {\n    const module = await import(\"@aws-sdk/client-sesv2\");\n    sesModule = module.default;\n    sesModuleExists = true;\n  } catch {\n    sesModuleExists = false;\n  }\n}\n\nsesLoadPromise = loadSesModule();\n\nfunction isSesConfig(config: MailConfigurations): config is SESConfigurations {\n  return \"driver\" in config && config.driver === \"ses\";\n}\n\nasync function getSesMailer(config: SESConfigurations): Promise<Transporter> {\n  if (sesModuleExists === null && sesLoadPromise) {\n    await sesLoadPromise;\n  }\n\n  if (sesModuleExists === false) {\n    throw new Error(`@aws-sdk/client-sesv2 is not installed.\\n\\n${SES_INSTALL_INSTRUCTIONS}`);\n  }\n\n  const hash = `ses_${config.region}_${config.accessKeyId}`;\n\n  const existingTransporter = mailerPool.get(hash);\n  if (existingTransporter) {\n    return existingTransporter;\n  }\n\n  log.info(\"mail\", \"pool\", `Creating new SES mailer transport (pool size: ${mailerPool.size + 1})`);\n\n  const ses = new sesModule!.SESv2Client({\n    region: config.region,\n    credentials: {\n      accessKeyId: config.accessKeyId,\n      secretAccessKey: config.secretAccessKey,\n    },\n  });\n\n  const transporter = nodemailerModule.createTransport({\n    SES: { sesClient: ses, SendEmailCommand: sesModule.SendEmailCommand },\n  });\n\n  mailerPool.set(hash, transporter);\n\n  return transporter;\n}\n\n// ============================================================\n// Mailer Pool\n// ============================================================\n\n/**\n * Mailer pool for connection reuse\n * Maps config hash to transporter instance\n */\nconst mailerPool = new Map<string, Transporter>();\n\n/**\n * Create a hash from mail configuration for pooling\n */\nfunction createConfigHash(config: SMTPConfigurations): string {\n  const key = JSON.stringify({\n    // SMTP specific fields\n    host: config.host,\n    port: config.port,\n    secure: config.secure,\n    auth: config.auth,\n    username: config.username,\n    password: config.password,\n  });\n\n  // Simple hash function\n  let hash = 0;\n  for (let i = 0; i < key.length; i++) {\n    const char = key.charCodeAt(i);\n    hash = (hash << 5) - hash + char;\n    hash = hash & hash;\n  }\n\n  return `mailer_${hash}`;\n}\n\n/**\n * Get hash for any mailer config\n */\nfunction getMailerHash(config: MailConfigurations): string {\n  if (isSesConfig(config)) {\n    return `ses_${config.region}_${config.accessKeyId}`;\n  }\n  return createConfigHash(config);\n}\n\n/**\n * Get or create a mailer transporter from the pool\n * Nodemailer is eagerly loaded at import time\n */\nexport async function getMailer(config: MailConfigurations): Promise<Transporter> {\n  if (moduleExists === null && nodemailerLoadPromise) {\n    await nodemailerLoadPromise;\n  }\n\n  if (moduleExists === false) {\n    throw new Error(`nodemailer is not installed.\\n\\n${NODEMAILER_INSTALL_INSTRUCTIONS}`);\n  }\n\n  if (isSesConfig(config)) {\n    return getSesMailer(config);\n  }\n\n  const hash = getMailerHash(config);\n\n  // Return existing transporter if available\n  const existingTransporter = mailerPool.get(hash);\n\n  if (existingTransporter) {\n    return existingTransporter;\n  }\n\n  // Create new transporter\n  log.info(\"mail\", \"pool\", `Creating new mailer transport (pool size: ${mailerPool.size + 1})`);\n\n  const { auth, username, password, requireTLS, tls, ...transportConfig } = config;\n\n  const transporter = nodemailerModule.createTransport({\n    requireTLS: requireTLS ?? tls,\n    auth: auth ?? {\n      user: username,\n      pass: password,\n    },\n    ...transportConfig,\n  });\n\n  // Store in pool\n  mailerPool.set(hash, transporter);\n\n  return transporter;\n}\n\n/**\n * Verify a mailer connection\n */\nexport async function verifyMailer(config: MailConfigurations): Promise<boolean> {\n  const transporter = await getMailer(config);\n\n  try {\n    await transporter.verify();\n    return true;\n  } catch {\n    return false;\n  }\n}\n\n/**\n * Close a specific mailer connection\n */\nexport function closeMailer(config: MailConfigurations): void {\n  const hash = getMailerHash(config);\n  const transporter = mailerPool.get(hash);\n\n  if (transporter) {\n    transporter.close();\n    mailerPool.delete(hash);\n    log.info(\"mail\", \"pool\", `Closed mailer transport (pool size: ${mailerPool.size})`);\n  }\n}\n\n/**\n * Close all mailer connections\n */\nexport function closeAllMailers(): void {\n  for (const [hash, transporter] of mailerPool) {\n    transporter.close();\n    mailerPool.delete(hash);\n  }\n\n  log.info(\"mail\", \"pool\", \"Closed all mailer transports\");\n}\n\n/**\n * Get pool statistics\n */\nexport function getPoolStats(): { size: number; hashes: string[] } {\n  return {\n    size: mailerPool.size,\n    hashes: Array.from(mailerPool.keys()),\n  };\n}\n"],"mappings":"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"}

package/esm/mail/react-mail.d.mts

@@ -0,0 +1,16 @@
+import React from "react";
+
+//#region ../../@warlock.js/core/src/mail/react-mail.d.ts
+/**
+ * Render a React element to HTML for email
+ *
+ * - Uses @react-email/render when installed (full react-email pipeline)
+ * - Falls back to react-dom/server renderToStaticMarkup otherwise
+ *
+ * **Note:** This function requires React packages to be installed.
+ * Install them with: `warlock add react` or `npm install react react-dom`
+ */
+declare function renderReactMail(element: React.ReactElement | React.ComponentType): Promise<string>;
+//#endregion
+export { renderReactMail };
+//# sourceMappingURL=react-mail.d.mts.map

package/esm/mail/react-mail.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"react-mail.d.mts","names":[],"sources":["../../../../../../@warlock.js/core/src/mail/react-mail.ts"],"mappings":";;;;;AAiCA;;;;;;;iBAAsB,eAAA,CACpB,OAAA,EAAS,KAAA,CAAM,YAAA,GAAe,KAAA,CAAM,aAAA,GACnC,OAAA"}

package/esm/mail/react-mail.mjs

@@ -0,0 +1,39 @@
+import { renderReact } from "../react/index.mjs";
+
+//#region ../../@warlock.js/core/src/mail/react-mail.ts
+/**
+* Create a complete HTML page from rendered content
+*/
+function createHtmlPage(html) {
+	const styles = [];
+	const links = [];
+	const body = html.replace(/<style.*?<\/style>|<link.*?>/gims, (match) => {
+		if (match.startsWith("<style")) styles.push(match);
+		else links.push(match);
+		return "";
+	});
+	return `<!doctype html><html>${`<head>${links.join("")}${styles.join("")}</head>`}<body>${body}</body></html>`;
+}
+/**
+* Render a React element to HTML for email
+*
+* - Uses @react-email/render when installed (full react-email pipeline)
+* - Falls back to react-dom/server renderToStaticMarkup otherwise
+*
+* **Note:** This function requires React packages to be installed.
+* Install them with: `warlock add react` or `npm install react react-dom`
+*/
+async function renderReactMail(element) {
+	const React = await import("react");
+	const reactElement = typeof element === "function" ? React.createElement(element) : element;
+	try {
+		const { render } = await import("@react-email/render");
+		return await render(reactElement);
+	} catch {
+		return createHtmlPage(renderReact(reactElement));
+	}
+}
+
+//#endregion
+export { renderReactMail };
+//# sourceMappingURL=react-mail.mjs.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"react-mail.mjs","names":[],"sources":["../../../../../../@warlock.js/core/src/mail/react-mail.ts"],"sourcesContent":["import type React from \"react\";\nimport { renderReact } from \"../react\";\n\n/**\n * Create a complete HTML page from rendered content\n */\nfunction createHtmlPage(html: string): string {\n  const styles: string[] = [];\n  const links: string[] = [];\n\n  const body = html.replace(/<style.*?<\\/style>|<link.*?>/gims, (match: string) => {\n    if (match.startsWith(\"<style\")) {\n      styles.push(match);\n    } else {\n      links.push(match);\n    }\n    return \"\";\n  });\n\n  const head = `<head>${links.join(\"\")}${styles.join(\"\")}</head>`;\n\n  return `<!doctype html><html>${head}<body>${body}</body></html>`;\n}\n\n/**\n * Render a React element to HTML for email\n *\n * - Uses @react-email/render when installed (full react-email pipeline)\n * - Falls back to react-dom/server renderToStaticMarkup otherwise\n *\n * **Note:** This function requires React packages to be installed.\n * Install them with: `warlock add react` or `npm install react react-dom`\n */\nexport async function renderReactMail(\n  element: React.ReactElement | React.ComponentType,\n): Promise<string> {\n  const React = await import(\"react\");\n  const reactElement = typeof element === \"function\" ? React.createElement(element) : element;\n\n  try {\n    const { render } = await import(\"@react-email/render\");\n    return await render(reactElement as React.ReactElement);\n  } catch {\n    // @react-email/render not installed — graceful fallback\n    const content = renderReact(reactElement);\n    return createHtmlPage(content);\n  }\n}\n"],"mappings":";;;;;;AAMA,SAAS,eAAe,MAAsB;CAC5C,MAAM,SAAmB,CAAC;CAC1B,MAAM,QAAkB,CAAC;CAEzB,MAAM,OAAO,KAAK,QAAQ,qCAAqC,UAAkB;EAC/E,IAAI,MAAM,WAAW,QAAQ,GAC3B,OAAO,KAAK,KAAK;OAEjB,MAAM,KAAK,KAAK;EAElB,OAAO;CACT,CAAC;CAID,OAAO,wBAAwB,SAFT,MAAM,KAAK,EAAE,IAAI,OAAO,KAAK,EAAE,EAAE,SAEnB,QAAQ,KAAK;AACnD;;;;;;;;;;AAWA,eAAsB,gBACpB,SACiB;CACjB,MAAM,QAAQ,MAAM,OAAO;CAC3B,MAAM,eAAe,OAAO,YAAY,aAAa,MAAM,cAAc,OAAO,IAAI;CAEpF,IAAI;EACF,MAAM,EAAE,WAAW,MAAM,OAAO;EAChC,OAAO,MAAM,OAAO,YAAkC;CACxD,QAAQ;EAGN,OAAO,eADS,YAAY,YACA,CAAC;CAC/B;AACF"}

package/esm/mail/send-mail.d.mts

@@ -0,0 +1,37 @@
+import { MailOptions, MailResult } from "./types.mjs";
+
+//#region ../../@warlock.js/core/src/mail/send-mail.d.ts
+/**
+ * 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: "..." });
+ * ```
+ */
+declare function sendMail(options: MailOptions): Promise<MailResult>;
+//#endregion
+export { sendMail };
+//# sourceMappingURL=send-mail.d.mts.map

package/esm/mail/send-mail.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"send-mail.d.mts","names":[],"sources":["../../../../../../@warlock.js/core/src/mail/send-mail.ts"],"mappings":";;;;;AAwPA;;;;;;;;;;;;;AAAwE;;;;;;;;;;;;;;;iBAAlD,QAAA,CAAS,OAAA,EAAS,WAAA,GAAc,OAAA,CAAQ,UAAA"}