@warlock.js/core 4.0.174 → 4.1.2

package/esm/mail/config.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.mjs","names":[],"sources":["../../../../../../@warlock.js/core/src/mail/config.ts"],"sourcesContent":["import type { MailConfigurations, MailersConfig, MailMode, SMTPConfigurations } from \"./types\";\n\n/**\n * Default mail configurations\n */\nconst defaultConfigurations: Partial<SMTPConfigurations> = {\n  secure: true,\n  tls: true,\n  driver: \"smtp\",\n};\n\n/**\n * Current mail mode\n */\nlet currentMode: MailMode = \"production\";\n\n/**\n * Registered mailers configuration\n */\nlet mailersConfig: MailersConfig = {};\n\n/**\n * Set the mail mode\n *\n * @param mode \"production\" | \"development\" | \"test\"\n *\n * - **production**: Actually sends emails via SMTP\n * - **development**: Logs emails to console without sending\n * - **test**: Captures emails to test mailbox for assertions\n *\n * @example\n * ```typescript\n * // In test setup\n * setMailMode(\"test\");\n *\n * // In development\n * setMailMode(\"development\");\n * ```\n */\nexport function setMailMode(mode: MailMode): void {\n  currentMode = mode;\n}\n\n/**\n * Get the current mail mode\n */\nexport function getMailMode(): MailMode {\n  return currentMode;\n}\n\n/**\n * Check if in production mode\n */\nexport function isProductionMode(): boolean {\n  return currentMode === \"production\";\n}\n\n/**\n * Check if in development mode\n */\nexport function isDevelopmentMode(): boolean {\n  return currentMode === \"development\";\n}\n\n/**\n * Check if in test mode\n */\nexport function isTestMode(): boolean {\n  return currentMode === \"test\";\n}\n\n/**\n * Set mail configurations\n *\n * Supports both simple config and named mailers.\n *\n * @example\n * ```typescript\n * // Simple config (sets as default)\n * setMailConfigurations({\n *   host: \"smtp.gmail.com\",\n *   port: 587,\n *   username: \"...\",\n *   password: \"...\",\n * });\n *\n * // Named mailers\n * setMailConfigurations({\n *   default: { host: \"smtp.sendgrid.net\", ... },\n *   mailers: {\n *     marketing: { host: \"smtp.mailchimp.com\", ... },\n *     transactional: { host: \"smtp.postmark.com\", ... },\n *   },\n * });\n * ```\n */\nexport function setMailConfigurations(config: MailConfigurations | MailersConfig): void {\n  // Check if it's a MailersConfig (has 'default' or 'mailers' key)\n  if (\"default\" in config || \"mailers\" in config) {\n    mailersConfig = config as MailersConfig;\n  } else {\n    // Simple config - set as default\n    mailersConfig = {\n      default: config as MailConfigurations,\n    };\n  }\n}\n\nexport function getDefaultMailConfig(): MailConfigurations {\n  const config = mailersConfig.default;\n  if (!config) return {} as MailConfigurations;\n  if (\"driver\" in config && config.driver === \"ses\") return config;\n\n  return {\n    ...defaultConfigurations,\n    ...config,\n  } as SMTPConfigurations;\n}\n\n/**\n * Get a named mailer configuration\n */\nexport function getMailerConfig(name: string): MailConfigurations | undefined {\n  if (name === \"default\") {\n    return getDefaultMailConfig();\n  }\n\n  const config = mailersConfig.mailers?.[name];\n  if (!config) {\n    return undefined;\n  }\n\n  if (\"driver\" in config && config.driver === \"ses\") return config;\n\n  return {\n    ...defaultConfigurations,\n    ...config,\n  } as SMTPConfigurations;\n}\n\n/**\n * Resolve configuration from options\n * Priority: config > mailer > default\n */\nexport function resolveMailConfig(options: {\n  config?: MailConfigurations;\n  mailer?: string;\n}): MailConfigurations {\n  if (options.config) {\n    // SES config passes through as-is, no defaultConfigurations merge\n    if (\"driver\" in options.config && options.config.driver === \"ses\") {\n      return options.config;\n    }\n\n    return {\n      ...defaultConfigurations,\n      ...options.config,\n    } as SMTPConfigurations;\n  }\n\n  if (options.mailer) {\n    const config = getMailerConfig(options.mailer);\n    if (!config) {\n      throw new Error(`Mailer \"${options.mailer}\" not found in configuration`);\n    }\n    return config;\n  }\n\n  return getDefaultMailConfig();\n}\n\n/**\n * Reset all configurations (useful for testing)\n */\nexport function resetMailConfig(): void {\n  currentMode = \"production\";\n  mailersConfig = {};\n}\n"],"mappings":";;;;AAKA,MAAM,wBAAqD;CACzD,QAAQ;CACR,KAAK;CACL,QAAQ;AACV;;;;AAKA,IAAI,cAAwB;;;;AAK5B,IAAI,gBAA+B,CAAC;;;;;;;;;;;;;;;;;;;AAoBpC,SAAgB,YAAY,MAAsB;CAChD,cAAc;AAChB;;;;AAKA,SAAgB,cAAwB;CACtC,OAAO;AACT;;;;AAKA,SAAgB,mBAA4B;CAC1C,OAAO,gBAAgB;AACzB;;;;AAKA,SAAgB,oBAA6B;CAC3C,OAAO,gBAAgB;AACzB;;;;AAKA,SAAgB,aAAsB;CACpC,OAAO,gBAAgB;AACzB;;;;;;;;;;;;;;;;;;;;;;;;;;AA2BA,SAAgB,sBAAsB,QAAkD;CAEtF,IAAI,aAAa,UAAU,aAAa,QACtC,gBAAgB;MAGhB,gBAAgB,EACd,SAAS,OACX;AAEJ;AAEA,SAAgB,uBAA2C;CACzD,MAAM,SAAS,cAAc;CAC7B,IAAI,CAAC,QAAQ,OAAO,CAAC;CACrB,IAAI,YAAY,UAAU,OAAO,WAAW,OAAO,OAAO;CAE1D,OAAO;EACL,GAAG;EACH,GAAG;CACL;AACF;;;;AAKA,SAAgB,gBAAgB,MAA8C;CAC5E,IAAI,SAAS,WACX,OAAO,qBAAqB;CAG9B,MAAM,SAAS,cAAc,UAAU;CACvC,IAAI,CAAC,QACH;CAGF,IAAI,YAAY,UAAU,OAAO,WAAW,OAAO,OAAO;CAE1D,OAAO;EACL,GAAG;EACH,GAAG;CACL;AACF;;;;;AAMA,SAAgB,kBAAkB,SAGX;CACrB,IAAI,QAAQ,QAAQ;EAElB,IAAI,YAAY,QAAQ,UAAU,QAAQ,OAAO,WAAW,OAC1D,OAAO,QAAQ;EAGjB,OAAO;GACL,GAAG;GACH,GAAG,QAAQ;EACb;CACF;CAEA,IAAI,QAAQ,QAAQ;EAClB,MAAM,SAAS,gBAAgB,QAAQ,MAAM;EAC7C,IAAI,CAAC,QACH,MAAM,IAAI,MAAM,WAAW,QAAQ,OAAO,6BAA6B;EAEzE,OAAO;CACT;CAEA,OAAO,qBAAqB;AAC9B;;;;AAKA,SAAgB,kBAAwB;CACtC,cAAc;CACd,gBAAgB,CAAC;AACnB"}

package/esm/mail/events.d.mts

@@ -0,0 +1,99 @@
+//#region ../../@warlock.js/core/src/mail/events.d.ts
+/**
+ * Generate a unique mail ID for event namespacing
+ */
+declare function generateMailId(): string;
+/**
+ * Mail event names (global events)
+ */
+declare const MAIL_EVENTS: {
+  readonly BEFORE_SENDING: "mail.beforeSending";
+  readonly SENT: "mail.sent";
+  readonly SUCCESS: "mail.success";
+  readonly ERROR: "mail.error";
+};
+/**
+ * Get namespaced event name for a specific mail
+ * @param mailId Unique mail identifier
+ * @param event Event type
+ * @returns Namespaced event name (e.g., "mail.abc123.success")
+ */
+declare function getMailEventName(mailId: string, event: "beforeSending" | "sent" | "success" | "error"): string;
+/**
+ * Mail events wrapper
+ *
+ * Supports two event patterns:
+ * 1. Global events: `mail.success` - fires for ALL emails
+ * 2. Specific events: `mail.$mailId.success` - fires for ONE email
+ *
+ * ## Usage
+ *
+ * ```typescript
+ * // Global listener - all emails
+ * mailEvents.onSuccess((mail, result) => {
+ *   console.log("Any mail sent:", result.messageId);
+ * });
+ *
+ * // Specific listener - one email by ID
+ * const mailId = generateMailId();
+ * mailEvents.onMailSuccess(mailId, (mail, result) => {
+ *   console.log("This specific mail sent:", result.messageId);
+ * });
+ *
+ * await sendMail({
+ *   id: mailId, // Use the same ID
+ *   to: "user@example.com",
+ *   subject: "Hello",
+ *   html: "<p>World</p>",
+ * });
+ * ```
+ */
+declare const mailEvents: {
+  /**
+   * Trigger a global mail event
+   */
+  trigger: (eventName: keyof typeof MAIL_EVENTS, ...args: any[]) => any;
+  /**
+   * Trigger a specific mail event (by mail ID)
+   */
+  triggerForMail: (mailId: string, event: "beforeSending" | "sent" | "success" | "error", ...args: any[]) => any;
+  /**
+   * Subscribe to global mail events
+   */
+  on: (eventName: keyof typeof MAIL_EVENTS, callback: (...args: any[]) => void) => import("@mongez/events").EventSubscription;
+  /**
+   * Subscribe to beforeSending event (all mails)
+   */
+  onBeforeSending: (callback: (mail: any) => void | Promise<void> | false | Promise<false>) => import("@mongez/events").EventSubscription;
+  /**
+   * Subscribe to sent event (all mails, after attempt)
+   */
+  onSent: (callback: (mail: any, result: any, error: any) => void | Promise<void>) => import("@mongez/events").EventSubscription;
+  /**
+   * Subscribe to success event (all mails)
+   */
+  onSuccess: (callback: (mail: any, result: any) => void | Promise<void>) => import("@mongez/events").EventSubscription;
+  /**
+   * Subscribe to error event (all mails)
+   */
+  onError: (callback: (mail: any, error: any) => void | Promise<void>) => import("@mongez/events").EventSubscription;
+  /**
+   * Subscribe to beforeSending event for a specific mail
+   */
+  onMailBeforeSending: (mailId: string, callback: (mail: any) => void | Promise<void> | false | Promise<false>) => import("@mongez/events").EventSubscription;
+  /**
+   * Subscribe to sent event for a specific mail
+   */
+  onMailSent: (mailId: string, callback: (mail: any, result: any, error: any) => void | Promise<void>) => import("@mongez/events").EventSubscription;
+  /**
+   * Subscribe to success event for a specific mail
+   */
+  onMailSuccess: (mailId: string, callback: (mail: any, result: any) => void | Promise<void>) => import("@mongez/events").EventSubscription;
+  /**
+   * Subscribe to error event for a specific mail
+   */
+  onMailError: (mailId: string, callback: (mail: any, error: any) => void | Promise<void>) => import("@mongez/events").EventSubscription;
+};
+//#endregion
+export { MAIL_EVENTS, generateMailId, getMailEventName, mailEvents };
+//# sourceMappingURL=events.d.mts.map

package/esm/mail/events.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"events.d.mts","names":[],"sources":["../../../../../../@warlock.js/core/src/mail/events.ts"],"mappings":";;AAMA;;iBAAgB,cAAA,CAAA;;AAAc;AAO9B;cAAa,WAAA;EAAA;;;;;;;;AAab;;;iBAAgB,gBAAA,CACd,MAAA,UACA,KAAqD;AAAA;AAkCvD;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAlCuD,cAkC1C,UAAA;EAsB6B;;;oCAlBN,WAAA,KAAW,IAAA;EA2BK;;;mCAnBlC,KAAA,qDACuC,IAAA;;;;+BAS1B,WAAA,EAAW,QAAA,MAAgB,IAAA,8CAAoB,iBAAA;EAgBV;;;+BAPrC,IAAA,iBAAqB,OAAA,iBAAwB,OAAA,qCAAc,iBAAA;EAcjE;;;sBAPH,IAAA,OAAW,MAAA,OAAa,KAAA,iBAAsB,OAAA,oCAAa,iBAAA;EAOT;;;yBAA/C,IAAA,OAAW,MAAA,iBAAuB,OAAA,oCAAa,iBAAA;EAOhB;;;uBAAjC,IAAA,OAAW,KAAA,iBAAsB,OAAA,oCAAa,iBAAA;;;;wCAUnD,QAAA,GACH,IAAA,iBAAqB,OAAA,iBAAwB,OAAA,qCAAc,iBAAA;EADxD;;;+BAUA,QAAA,GACH,IAAA,OAAW,MAAA,OAAa,KAAA,iBAAsB,OAAA,oCAAa,iBAAA;EAA3D;;;kCAQiB,QAAA,GAAa,IAAA,OAAW,MAAA,iBAAuB,OAAA,oCAAa,iBAAA;EAT1E;;;gCAgBY,QAAA,GAAa,IAAA,OAAW,KAAA,iBAAsB,OAAA,oCAAa,iBAAA;AAAA"}

package/esm/mail/events.mjs

@@ -0,0 +1,129 @@
+import { Random } from "@mongez/reinforcements";
+import events from "@mongez/events";
+
+//#region ../../@warlock.js/core/src/mail/events.ts
+/**
+* Generate a unique mail ID for event namespacing
+*/
+function generateMailId() {
+	return "M" + Random.int(32);
+}
+/**
+* Mail event names (global events)
+*/
+const MAIL_EVENTS = {
+	BEFORE_SENDING: "mail.beforeSending",
+	SENT: "mail.sent",
+	SUCCESS: "mail.success",
+	ERROR: "mail.error"
+};
+/**
+* Get namespaced event name for a specific mail
+* @param mailId Unique mail identifier
+* @param event Event type
+* @returns Namespaced event name (e.g., "mail.abc123.success")
+*/
+function getMailEventName(mailId, event) {
+	return `mail.${mailId}.${event}`;
+}
+/**
+* Mail events wrapper
+*
+* Supports two event patterns:
+* 1. Global events: `mail.success` - fires for ALL emails
+* 2. Specific events: `mail.$mailId.success` - fires for ONE email
+*
+* ## Usage
+*
+* ```typescript
+* // Global listener - all emails
+* mailEvents.onSuccess((mail, result) => {
+*   console.log("Any mail sent:", result.messageId);
+* });
+*
+* // Specific listener - one email by ID
+* const mailId = generateMailId();
+* mailEvents.onMailSuccess(mailId, (mail, result) => {
+*   console.log("This specific mail sent:", result.messageId);
+* });
+*
+* await sendMail({
+*   id: mailId, // Use the same ID
+*   to: "user@example.com",
+*   subject: "Hello",
+*   html: "<p>World</p>",
+* });
+* ```
+*/
+const mailEvents = {
+	/**
+	* Trigger a global mail event
+	*/
+	trigger: (eventName, ...args) => {
+		return events.trigger(MAIL_EVENTS[eventName], ...args);
+	},
+	/**
+	* Trigger a specific mail event (by mail ID)
+	*/
+	triggerForMail: (mailId, event, ...args) => {
+		return events.trigger(getMailEventName(mailId, event), ...args);
+	},
+	/**
+	* Subscribe to global mail events
+	*/
+	on: (eventName, callback) => {
+		return events.subscribe(MAIL_EVENTS[eventName], callback);
+	},
+	/**
+	* Subscribe to beforeSending event (all mails)
+	*/
+	onBeforeSending: (callback) => {
+		return events.subscribe(MAIL_EVENTS.BEFORE_SENDING, callback);
+	},
+	/**
+	* Subscribe to sent event (all mails, after attempt)
+	*/
+	onSent: (callback) => {
+		return events.subscribe(MAIL_EVENTS.SENT, callback);
+	},
+	/**
+	* Subscribe to success event (all mails)
+	*/
+	onSuccess: (callback) => {
+		return events.subscribe(MAIL_EVENTS.SUCCESS, callback);
+	},
+	/**
+	* Subscribe to error event (all mails)
+	*/
+	onError: (callback) => {
+		return events.subscribe(MAIL_EVENTS.ERROR, callback);
+	},
+	/**
+	* Subscribe to beforeSending event for a specific mail
+	*/
+	onMailBeforeSending: (mailId, callback) => {
+		return events.subscribe(getMailEventName(mailId, "beforeSending"), callback);
+	},
+	/**
+	* Subscribe to sent event for a specific mail
+	*/
+	onMailSent: (mailId, callback) => {
+		return events.subscribe(getMailEventName(mailId, "sent"), callback);
+	},
+	/**
+	* Subscribe to success event for a specific mail
+	*/
+	onMailSuccess: (mailId, callback) => {
+		return events.subscribe(getMailEventName(mailId, "success"), callback);
+	},
+	/**
+	* Subscribe to error event for a specific mail
+	*/
+	onMailError: (mailId, callback) => {
+		return events.subscribe(getMailEventName(mailId, "error"), callback);
+	}
+};
+
+//#endregion
+export { MAIL_EVENTS, generateMailId, getMailEventName, mailEvents };
+//# sourceMappingURL=events.mjs.map

package/esm/mail/events.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"events.mjs","names":[],"sources":["../../../../../../@warlock.js/core/src/mail/events.ts"],"sourcesContent":["import events from \"@mongez/events\";\nimport { Random } from \"@mongez/reinforcements\";\n\n/**\n * Generate a unique mail ID for event namespacing\n */\nexport function generateMailId(): string {\n  return \"M\" + Random.int(32);\n}\n\n/**\n * Mail event names (global events)\n */\nexport const MAIL_EVENTS = {\n  BEFORE_SENDING: \"mail.beforeSending\",\n  SENT: \"mail.sent\",\n  SUCCESS: \"mail.success\",\n  ERROR: \"mail.error\",\n} as const;\n\n/**\n * Get namespaced event name for a specific mail\n * @param mailId Unique mail identifier\n * @param event Event type\n * @returns Namespaced event name (e.g., \"mail.abc123.success\")\n */\nexport function getMailEventName(\n  mailId: string,\n  event: \"beforeSending\" | \"sent\" | \"success\" | \"error\",\n): string {\n  return `mail.${mailId}.${event}`;\n}\n\n/**\n * Mail events wrapper\n *\n * Supports two event patterns:\n * 1. Global events: `mail.success` - fires for ALL emails\n * 2. Specific events: `mail.$mailId.success` - fires for ONE email\n *\n * ## Usage\n *\n * ```typescript\n * // Global listener - all emails\n * mailEvents.onSuccess((mail, result) => {\n *   console.log(\"Any mail sent:\", result.messageId);\n * });\n *\n * // Specific listener - one email by ID\n * const mailId = generateMailId();\n * mailEvents.onMailSuccess(mailId, (mail, result) => {\n *   console.log(\"This specific mail sent:\", result.messageId);\n * });\n *\n * await sendMail({\n *   id: mailId, // Use the same ID\n *   to: \"user@example.com\",\n *   subject: \"Hello\",\n *   html: \"<p>World</p>\",\n * });\n * ```\n */\nexport const mailEvents = {\n  /**\n   * Trigger a global mail event\n   */\n  trigger: (eventName: keyof typeof MAIL_EVENTS, ...args: any[]) => {\n    return events.trigger(MAIL_EVENTS[eventName], ...args);\n  },\n\n  /**\n   * Trigger a specific mail event (by mail ID)\n   */\n  triggerForMail: (\n    mailId: string,\n    event: \"beforeSending\" | \"sent\" | \"success\" | \"error\",\n    ...args: any[]\n  ) => {\n    return events.trigger(getMailEventName(mailId, event), ...args);\n  },\n\n  /**\n   * Subscribe to global mail events\n   */\n  on: (eventName: keyof typeof MAIL_EVENTS, callback: (...args: any[]) => void) => {\n    return events.subscribe(MAIL_EVENTS[eventName], callback);\n  },\n\n  // === GLOBAL EVENT HELPERS ===\n\n  /**\n   * Subscribe to beforeSending event (all mails)\n   */\n  onBeforeSending: (callback: (mail: any) => void | Promise<void> | false | Promise<false>) => {\n    return events.subscribe(MAIL_EVENTS.BEFORE_SENDING, callback);\n  },\n\n  /**\n   * Subscribe to sent event (all mails, after attempt)\n   */\n  onSent: (callback: (mail: any, result: any, error: any) => void | Promise<void>) => {\n    return events.subscribe(MAIL_EVENTS.SENT, callback);\n  },\n\n  /**\n   * Subscribe to success event (all mails)\n   */\n  onSuccess: (callback: (mail: any, result: any) => void | Promise<void>) => {\n    return events.subscribe(MAIL_EVENTS.SUCCESS, callback);\n  },\n\n  /**\n   * Subscribe to error event (all mails)\n   */\n  onError: (callback: (mail: any, error: any) => void | Promise<void>) => {\n    return events.subscribe(MAIL_EVENTS.ERROR, callback);\n  },\n\n  // === SPECIFIC MAIL EVENT HELPERS ===\n\n  /**\n   * Subscribe to beforeSending event for a specific mail\n   */\n  onMailBeforeSending: (\n    mailId: string,\n    callback: (mail: any) => void | Promise<void> | false | Promise<false>,\n  ) => {\n    return events.subscribe(getMailEventName(mailId, \"beforeSending\"), callback);\n  },\n\n  /**\n   * Subscribe to sent event for a specific mail\n   */\n  onMailSent: (\n    mailId: string,\n    callback: (mail: any, result: any, error: any) => void | Promise<void>,\n  ) => {\n    return events.subscribe(getMailEventName(mailId, \"sent\"), callback);\n  },\n\n  /**\n   * Subscribe to success event for a specific mail\n   */\n  onMailSuccess: (mailId: string, callback: (mail: any, result: any) => void | Promise<void>) => {\n    return events.subscribe(getMailEventName(mailId, \"success\"), callback);\n  },\n\n  /**\n   * Subscribe to error event for a specific mail\n   */\n  onMailError: (mailId: string, callback: (mail: any, error: any) => void | Promise<void>) => {\n    return events.subscribe(getMailEventName(mailId, \"error\"), callback);\n  },\n};\n"],"mappings":";;;;;;;AAMA,SAAgB,iBAAyB;CACvC,OAAO,MAAM,OAAO,IAAI,EAAE;AAC5B;;;;AAKA,MAAa,cAAc;CACzB,gBAAgB;CAChB,MAAM;CACN,SAAS;CACT,OAAO;AACT;;;;;;;AAQA,SAAgB,iBACd,QACA,OACQ;CACR,OAAO,QAAQ,OAAO,GAAG;AAC3B;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AA+BA,MAAa,aAAa;;;;CAIxB,UAAU,WAAqC,GAAG,SAAgB;EAChE,OAAO,OAAO,QAAQ,YAAY,YAAY,GAAG,IAAI;CACvD;;;;CAKA,iBACE,QACA,OACA,GAAG,SACA;EACH,OAAO,OAAO,QAAQ,iBAAiB,QAAQ,KAAK,GAAG,GAAG,IAAI;CAChE;;;;CAKA,KAAK,WAAqC,aAAuC;EAC/E,OAAO,OAAO,UAAU,YAAY,YAAY,QAAQ;CAC1D;;;;CAOA,kBAAkB,aAA2E;EAC3F,OAAO,OAAO,UAAU,YAAY,gBAAgB,QAAQ;CAC9D;;;;CAKA,SAAS,aAA2E;EAClF,OAAO,OAAO,UAAU,YAAY,MAAM,QAAQ;CACpD;;;;CAKA,YAAY,aAA+D;EACzE,OAAO,OAAO,UAAU,YAAY,SAAS,QAAQ;CACvD;;;;CAKA,UAAU,aAA8D;EACtE,OAAO,OAAO,UAAU,YAAY,OAAO,QAAQ;CACrD;;;;CAOA,sBACE,QACA,aACG;EACH,OAAO,OAAO,UAAU,iBAAiB,QAAQ,eAAe,GAAG,QAAQ;CAC7E;;;;CAKA,aACE,QACA,aACG;EACH,OAAO,OAAO,UAAU,iBAAiB,QAAQ,MAAM,GAAG,QAAQ;CACpE;;;;CAKA,gBAAgB,QAAgB,aAA+D;EAC7F,OAAO,OAAO,UAAU,iBAAiB,QAAQ,SAAS,GAAG,QAAQ;CACvE;;;;CAKA,cAAc,QAAgB,aAA8D;EAC1F,OAAO,OAAO,UAAU,iBAAiB,QAAQ,OAAO,GAAG,QAAQ;CACrE;AACF"}

package/esm/mail/index.d.mts

@@ -0,0 +1,8 @@
+import { CapturedMail, MailAddress, MailAttachment, MailConfigurations, MailError, MailErrorCode, MailEvents, MailMode, MailOptions, MailPriority, MailResult, MailersConfig, NormalizedMail, SESConfigurations, SMTPConfigurations } from "./types.mjs";
+import { getDefaultMailConfig, getMailMode, getMailerConfig, isDevelopmentMode, isProductionMode, isTestMode, resetMailConfig, resolveMailConfig, setMailConfigurations, setMailMode } from "./config.mjs";
+import { MAIL_EVENTS, generateMailId, getMailEventName, mailEvents } from "./events.mjs";
+import { closeAllMailers, closeMailer, getMailer, getPoolStats, verifyMailer } from "./mailer-pool.mjs";
+import { renderReactMail } from "./react-mail.mjs";
+import { sendMail } from "./send-mail.mjs";
+import { Mail } from "./mail.mjs";
+import { assertMailCount, assertMailSent, captureMail, clearTestMailbox, findMailsBySubject, findMailsTo, getLastMail, getMailboxSize, getTestMailbox, wasMailSentTo, wasMailSentWithSubject } from "./test-mailbox.mjs";

package/esm/mail/index.mjs

@@ -0,0 +1,10 @@
+import { getDefaultMailConfig, getMailMode, getMailerConfig, isDevelopmentMode, isProductionMode, isTestMode, resetMailConfig, resolveMailConfig, setMailConfigurations, setMailMode } from "./config.mjs";
+import { MAIL_EVENTS, generateMailId, getMailEventName, mailEvents } from "./events.mjs";
+import { closeAllMailers, closeMailer, getMailer, getPoolStats, verifyMailer } from "./mailer-pool.mjs";
+import { renderReactMail } from "./react-mail.mjs";
+import { assertMailCount, assertMailSent, captureMail, clearTestMailbox, findMailsBySubject, findMailsTo, getLastMail, getMailboxSize, getTestMailbox, wasMailSentTo, wasMailSentWithSubject } from "./test-mailbox.mjs";
+import { MailError } from "./types.mjs";
+import { sendMail } from "./send-mail.mjs";
+import { Mail } from "./mail.mjs";
+
+export {  };

package/esm/mail/mail.d.mts

@@ -0,0 +1,178 @@
+import { MailAddress, MailAttachment, MailConfigurations, MailEvents, MailOptions, MailPriority, MailResult } from "./types.mjs";
+import React from "react";
+
+//#region ../../@warlock.js/core/src/mail/mail.d.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();
+ * ```
+ */
+declare class Mail {
+  private options;
+  /**
+   * Private constructor - use static factory methods
+   */
+  private constructor();
+  /**
+   * Create a new mail with recipient
+   */
+  static to(recipient: string | string[]): Mail;
+  /**
+   * Create a new mail with custom configuration (multi-tenant)
+   */
+  static config(config: MailConfigurations): Mail;
+  /**
+   * Create a new mail with named mailer
+   */
+  static mailer(name: string): Mail;
+  /**
+   * Set recipient(s)
+   */
+  to(recipient: string | string[]): this;
+  /**
+   * Set CC recipient(s)
+   */
+  cc(recipient: string | string[]): this;
+  /**
+   * Set BCC recipient(s)
+   */
+  bcc(recipient: string | string[]): this;
+  /**
+   * Set reply-to address
+   */
+  replyTo(address: string): this;
+  /**
+   * Set from address
+   */
+  from(address: MailAddress): this;
+  /**
+   * Set subject
+   */
+  subject(subject: string): this;
+  /**
+   * Set HTML content
+   */
+  html(content: string): this;
+  /**
+   * Set plain text content
+   */
+  text(content: string): this;
+  /**
+   * Set React component as content
+   */
+  component(element: React.ReactElement): this;
+  /**
+   * Add attachment
+   */
+  attach(content: Buffer | string, filename: string, contentType?: string): this;
+  /**
+   * Add multiple attachments
+   */
+  attachments(attachments: MailAttachment[]): 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: string, filename?: string, contentType?: string): this;
+  /**
+   * Set priority
+   */
+  priority(level: MailPriority): this;
+  /**
+   * Set custom headers
+   */
+  headers(headers: Record<string, string>): this;
+  /**
+   * Add a custom header
+   */
+  header(name: string, value: string): this;
+  /**
+   * Set tags for categorization
+   */
+  tags(tags: string[]): this;
+  /**
+   * Add a tag
+   */
+  tag(tag: string): this;
+  /**
+   * Set correlation ID for tracking
+   */
+  correlationId(id: string): this;
+  /**
+   * Set configuration (multi-tenant)
+   */
+  withConfig(config: MailConfigurations): this;
+  /**
+   * Set named mailer
+   */
+  withMailer(name: string): this;
+  /**
+   * Set beforeSending event handler
+   */
+  beforeSending(handler: MailEvents["beforeSending"]): this;
+  /**
+   * Set onSent event handler
+   */
+  onSent(handler: MailEvents["onSent"]): this;
+  /**
+   * Set onSuccess event handler
+   */
+  onSuccess(handler: MailEvents["onSuccess"]): this;
+  /**
+   * Set onError event handler
+   */
+  onError(handler: MailEvents["onError"]): this;
+  /**
+   * Get the built options (for debugging)
+   */
+  getOptions(): Partial<MailOptions>;
+  /**
+   * Validate the mail before sending
+   */
+  private validate;
+  /**
+   * Send the email
+   */
+  send(): Promise<MailResult>;
+}
+//#endregion
+export { Mail };
+//# sourceMappingURL=mail.d.mts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"mail.d.mts","names":[],"sources":["../../../../../../@warlock.js/core/src/mail/mail.ts"],"mappings":";;;;;;AAwCA;;;;;;;;;;;;;;;;;;;;;;;;;;cAAa,IAAA;EAAA,QACH,OAAA;EAUwC;;;EAAA,QALzC,WAAA,CAAA;EAe2C;;;EAAA,OAVpC,EAAA,CAAG,SAAA,sBAA+B,IAAA;EA8BzC;;;EAAA,OApBO,MAAA,CAAO,MAAA,EAAQ,kBAAA,GAAqB,IAAA;EAsC3C;;;EAAA,OA5BO,MAAA,CAAO,IAAA,WAAe,IAAA;EA8C7B;;;EApCA,EAAA,CAAG,SAAA;EA6CK;;;EApCR,EAAA,CAAG,SAAA;EAsDE;;;EA7CL,GAAA,CAAI,SAAA;EAsDM;;;EA7CV,OAAA,CAAQ,OAAA;EAsDyB;;;EA7CjC,IAAA,CAAK,OAAA,EAAS,WAAA;EA8DF;;;EArDZ,OAAA,CAAQ,OAAA;EA8EoC;;;EArE5C,IAAA,CAAK,OAAA;EAkGL;;;EAzFA,IAAA,CAAK,OAAA;EAkGE;;;EAzFP,SAAA,CAAU,OAAA,EAAS,KAAA,CAAM,YAAA;EA2GzB;;;EAlGA,MAAA,CAAO,OAAA,EAAS,MAAA,WAAiB,QAAA,UAAkB,WAAA;EAoHnD;;;EAnGA,WAAA,CAAY,WAAA,EAAa,cAAA;EA4Gd;;;;;;;;;;;;;;;;;;;EAnFX,UAAA,CAAW,IAAA,UAAc,QAAA,WAAmB,WAAA;EAwJZ;AAAA;;EApIhC,QAAA,CAAS,KAAA,EAAO,YAAA;;;;EAShB,OAAA,CAAQ,OAAA,EAAS,MAAA;;;;EASjB,MAAA,CAAO,IAAA,UAAc,KAAA;;;;EASrB,IAAA,CAAK,IAAA;;;;EASL,GAAA,CAAI,GAAA;;;;EASJ,aAAA,CAAc,EAAA;;;;EASd,UAAA,CAAW,MAAA,EAAQ,kBAAA;;;;EASnB,UAAA,CAAW,IAAA;;;;EASX,aAAA,CAAc,OAAA,EAAS,UAAA;;;;EASvB,MAAA,CAAO,OAAA,EAAS,UAAA;;;;EAShB,SAAA,CAAU,OAAA,EAAS,UAAA;;;;EASnB,OAAA,CAAQ,OAAA,EAAS,UAAA;;;;EASjB,UAAA,CAAA,GAAc,OAAA,CAAQ,WAAA;;;;UAOrB,QAAA;;;;EAiBK,IAAA,CAAA,GAAQ,OAAA,CAAQ,UAAA;AAAA"}