@warlock.js/core 5.0.2 → 5.2.0

package/esm/logger/fatal-visibility.mjs

@@ -0,0 +1,31 @@
+import { log } from "@warlock.js/logger";
+
+//#region core/src/logger/fatal-visibility.ts
+/**
+* Guarantee a fatal boot error reaches the terminal.
+*
+* `log.fatal(...)` fans out over `Logger.channels` and does NOTHING when that
+* list is empty or holds only non-terminal channels — which is the normal
+* shape of a production `src/config/log.ts` (`production: { channels: [new
+* FileLog()] }`), and the shape of every app that ships no `log` config at all,
+* because `LoggerConnector.start()` returns early and never calls
+* `log.configure`. A boot failure reported only through `log.fatal` in that
+* window is a boot failure nobody ever sees: the process exits non-zero having
+* written nothing to stdout or stderr, and a supervising `warlock start` can
+* only report that no output was captured.
+*
+* This is the same guarantee `captureAnyUnhandledRejection` already makes for
+* an `uncaughtException` (see `@warlock.js/logger`), applied to the failures a
+* connector catches itself and therefore never lets reach that handler.
+*
+* Skipped when a terminal channel exists, so a configured `ConsoleLog` is
+* never doubled.
+*/
+function ensureFatalIsVisible(error) {
+	if (log.channels.some((channel) => channel.terminal !== false)) return;
+	console.error(error);
+}
+
+//#endregion
+export { ensureFatalIsVisible };
+//# sourceMappingURL=fatal-visibility.mjs.map

package/esm/logger/fatal-visibility.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"fatal-visibility.mjs","names":[],"sources":["C:/Work/Warlock.js/core/src/logger/fatal-visibility.ts"],"sourcesContent":["import { log } from \"@warlock.js/logger\";\n\n/**\n * Guarantee a fatal boot error reaches the terminal.\n *\n * `log.fatal(...)` fans out over `Logger.channels` and does NOTHING when that\n * list is empty or holds only non-terminal channels — which is the normal\n * shape of a production `src/config/log.ts` (`production: { channels: [new\n * FileLog()] }`), and the shape of every app that ships no `log` config at all,\n * because `LoggerConnector.start()` returns early and never calls\n * `log.configure`. A boot failure reported only through `log.fatal` in that\n * window is a boot failure nobody ever sees: the process exits non-zero having\n * written nothing to stdout or stderr, and a supervising `warlock start` can\n * only report that no output was captured.\n *\n * This is the same guarantee `captureAnyUnhandledRejection` already makes for\n * an `uncaughtException` (see `@warlock.js/logger`), applied to the failures a\n * connector catches itself and therefore never lets reach that handler.\n *\n * Skipped when a terminal channel exists, so a configured `ConsoleLog` is\n * never doubled.\n */\nexport function ensureFatalIsVisible(error: unknown): void {\n  const hasTerminalChannel = log.channels.some((channel) => channel.terminal !== false);\n\n  if (hasTerminalChannel) {\n    return;\n  }\n\n  console.error(error);\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;AAsBA,SAAgB,qBAAqB,OAAsB;CAGzD,IAF2B,IAAI,SAAS,MAAM,YAAY,QAAQ,aAAa,KAE1D,GACnB;CAGF,QAAQ,MAAM,KAAK;AACrB"}

package/esm/logger/index.d.mts

@@ -1,2 +1,3 @@
+import { ensureFatalIsVisible } from "./fatal-visibility.mjs";
 import { LogConfigurations } from "./types.mjs";
 import { setLogConfigurations } from "./logger.mjs";

package/esm/logger/index.mjs

@@ -1,3 +1,4 @@
+import { ensureFatalIsVisible } from "./fatal-visibility.mjs";
 import { setLogConfigurations } from "./logger.mjs";
 
 export {  };

package/esm/logger/logger.d.mts

@@ -1,6 +1,6 @@
 import { LogConfigurations } from "./types.mjs";
 
-//#region ../core/src/logger/logger.d.ts
+//#region core/src/logger/logger.d.ts
 declare function setLogConfigurations(options: LogConfigurations): void;
 //#endregion
 export { setLogConfigurations };

package/esm/logger/logger.d.mts.map

@@ -1 +1 @@
-{"version":3,"file":"logger.d.mts","names":[],"sources":["../../../../../../../core/src/logger/logger.ts"],"mappings":";;;iBAKgB,oBAAA,CAAqB,OAA0B,EAAjB,iBAAiB"}
+{"version":3,"file":"logger.d.mts","names":[],"sources":["C:/Work/Warlock.js/core/src/logger/logger.ts"],"mappings":";;;iBAKgB,oBAAA,CAAqB,OAA0B,EAAjB,iBAAiB"}

package/esm/logger/logger.mjs

@@ -2,7 +2,7 @@ import { environment } from "../utils/environment.mjs";
 import "../utils/index.mjs";
 import { log } from "@warlock.js/logger";
 
-//#region ../core/src/logger/logger.ts
+//#region core/src/logger/logger.ts
 function setLogConfigurations(options) {
 	const channels = [];
 	const envChannels = options[environment()]?.channels;

package/esm/logger/logger.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"logger.mjs","names":[],"sources":["../../../../../../../core/src/logger/logger.ts"],"sourcesContent":["import type { LogChannel } from \"@warlock.js/logger\";\r\nimport { log } from \"@warlock.js/logger\";\r\nimport { environment } from \"../utils\";\r\nimport type { LogConfigurations } from \"./types\";\r\n\r\nexport function setLogConfigurations(options: LogConfigurations) {\r\n  // log configurations\r\n  const channels: LogChannel[] = [];\r\n\r\n  const env = environment();\r\n\r\n  const envChannels = options[env as \"development\" | \"production\"]?.channels;\r\n  const defaultChannels = options.channels;\r\n\r\n  if (defaultChannels) {\r\n    channels.push(...defaultChannels);\r\n  }\r\n\r\n  if (envChannels) {\r\n    channels.push(...envChannels);\r\n  }\r\n\r\n  log.configure({\r\n    channels,\r\n  });\r\n}\r\n"],"mappings":";;;;;AAKA,SAAgB,qBAAqB,SAA4B;CAE/D,MAAM,WAAyB,CAAC;CAIhC,MAAM,cAAc,QAFR,YAEkB,EAAkC,EAAE;CAClE,MAAM,kBAAkB,QAAQ;CAEhC,IAAI,iBACF,SAAS,KAAK,GAAG,eAAe;CAGlC,IAAI,aACF,SAAS,KAAK,GAAG,WAAW;CAG9B,IAAI,UAAU,EACZ,SACF,CAAC;AACH"}
+{"version":3,"file":"logger.mjs","names":[],"sources":["C:/Work/Warlock.js/core/src/logger/logger.ts"],"sourcesContent":["import type { LogChannel } from \"@warlock.js/logger\";\r\nimport { log } from \"@warlock.js/logger\";\r\nimport { environment } from \"../utils\";\r\nimport type { LogConfigurations } from \"./types\";\r\n\r\nexport function setLogConfigurations(options: LogConfigurations) {\r\n  // log configurations\r\n  const channels: LogChannel[] = [];\r\n\r\n  const env = environment();\r\n\r\n  const envChannels = options[env as \"development\" | \"production\"]?.channels;\r\n  const defaultChannels = options.channels;\r\n\r\n  if (defaultChannels) {\r\n    channels.push(...defaultChannels);\r\n  }\r\n\r\n  if (envChannels) {\r\n    channels.push(...envChannels);\r\n  }\r\n\r\n  log.configure({\r\n    channels,\r\n  });\r\n}\r\n"],"mappings":";;;;;AAKA,SAAgB,qBAAqB,SAA4B;CAE/D,MAAM,WAAyB,CAAC;CAIhC,MAAM,cAAc,QAFR,YAEkB,IAAoC;CAClE,MAAM,kBAAkB,QAAQ;CAEhC,IAAI,iBACF,SAAS,KAAK,GAAG,eAAe;CAGlC,IAAI,aACF,SAAS,KAAK,GAAG,WAAW;CAG9B,IAAI,UAAU,EACZ,SACF,CAAC;AACH"}

package/esm/logger/types.d.mts

@@ -1,6 +1,6 @@
 import { LogChannel } from "@warlock.js/logger";
 
-//#region ../core/src/logger/types.d.ts
+//#region core/src/logger/types.d.ts
 type EnvironmentConfigurations = {
   /**
    * List of logging channels

package/esm/logger/types.d.mts.map

@@ -1 +1 @@
-{"version":3,"file":"types.d.mts","names":[],"sources":["../../../../../../../core/src/logger/types.ts"],"mappings":";;;KAEK,yBAAA;;AAFgD;;EAMnD,QAAA,EAAU,UAAU;EAAA;;;;;EAMpB,OAAA;AAAA;AAAA,KAEU,iBAAA;;;;;EAKV,QAAA,GAAW,UAAA;EAiB2B;;;EAbtC,OAAA;EAAA;;;;EAKA,WAAA,GAAc,yBAAA;EAQd;;;EAJA,IAAA,GAAO,yBAAA;;;;EAIP,UAAA,GAAa,yBAAA;AAAA"}
+{"version":3,"file":"types.d.mts","names":[],"sources":["C:/Work/Warlock.js/core/src/logger/types.ts"],"mappings":";;;KAEK,yBAAA;;AAFgD;;EAMnD,QAAA,EAAU,UAAU;EAAA;;;;;EAMpB,OAAA;AAAA;AAAA,KAEU,iBAAA;;;;;EAKV,QAAA,GAAW,UAAA;EAiB2B;;;EAbtC,OAAA;EAAA;;;;EAKA,WAAA,GAAc,yBAAA;EAQd;;;EAJA,IAAA,GAAO,yBAAA;;;;EAIP,UAAA,GAAa,yBAAA;AAAA"}

package/esm/mail/config.d.mts

@@ -1,6 +1,6 @@
 import { MailConfigurations, MailMode, MailersConfig } from "./types.mjs";
 
-//#region ../core/src/mail/config.d.ts
+//#region core/src/mail/config.d.ts
 /**
  * Set the mail mode
  *

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

@@ -1 +1 @@
-{"version":3,"file":"config.d.mts","names":[],"sources":["../../../../../../../core/src/mail/config.ts"],"mappings":";;;;;AAuCA;;;;AAA0C;AAO1C;;;;AAAuC;AAOvC;;;;AAAgC;AAOhC;iBArBgB,WAAA,CAAY,IAAc,EAAR,QAAQ;;;AAqBT;iBAdjB,WAAA,IAAe,QAAQ;;;;iBAOvB,gBAAA;AA2ChB;;;AAAA,iBApCgB,iBAAA;;;;iBAOA,UAAA;AA6BgE;AAYhF;;;;AAA0D;AAc1D;;;;AAAiE;AAsBjE;;;;;;;;;;AAGsB;AA2BtB;;;AA9EgF,iBAAhE,qBAAA,CAAsB,MAAA,EAAQ,kBAAA,GAAqB,aAAa;AAAA,iBAYhE,oBAAA,IAAwB,kBAAkB;;;;iBAc1C,eAAA,CAAgB,IAAA,WAAe,kBAAkB;;;;;iBAsBjD,iBAAA,CAAkB,OAAA;EAChC,MAAA,GAAS,kBAAA;EACT,MAAA;AAAA,IACE,kBAAkB;;;;iBA2BN,eAAA"}
+{"version":3,"file":"config.d.mts","names":[],"sources":["C:/Work/Warlock.js/core/src/mail/config.ts"],"mappings":";;;;;AAuCA;;;;AAA0C;AAO1C;;;;AAAuC;AAOvC;;;;AAAgC;AAOhC;iBArBgB,WAAA,CAAY,IAAc,EAAR,QAAQ;;;AAqBT;iBAdjB,WAAA,CAAA,GAAe,QAAQ;;;;iBAOvB,gBAAA,CAAA;AA2ChB;;;AAAA,iBApCgB,iBAAA,CAAA;;;;iBAOA,UAAA,CAAA;AA6BgE;AAYhF;;;;AAA0D;AAc1D;;;;AAAiE;AAsBjE;;;;;;;;;;AAGsB;AA2BtB;;;AA9EgF,iBAAhE,qBAAA,CAAsB,MAAA,EAAQ,kBAAA,GAAqB,aAAa;AAAA,iBAYhE,oBAAA,CAAA,GAAwB,kBAAkB;;;;iBAc1C,eAAA,CAAgB,IAAA,WAAe,kBAAkB;;;;;iBAsBjD,iBAAA,CAAkB,OAAA;EAChC,MAAA,GAAS,kBAAA;EACT,MAAA;AAAA,IACE,kBAAkB;;;;iBA2BN,eAAA,CAAA"}

package/esm/mail/config.mjs

@@ -1,4 +1,4 @@
-//#region ../core/src/mail/config.ts
+//#region core/src/mail/config.ts
 /**
 * Default mail configurations
 */

package/esm/mail/config.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"config.mjs","names":[],"sources":["../../../../../../../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"}
+{"version":3,"file":"config.mjs","names":[],"sources":["C:/Work/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

@@ -1,4 +1,4 @@
-//#region ../core/src/mail/events.d.ts
+//#region core/src/mail/events.d.ts
 /**
  * Generate a unique mail ID for event namespacing
  */

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

@@ -1 +1 @@
-{"version":3,"file":"events.d.mts","names":[],"sources":["../../../../../../../core/src/mail/events.ts"],"mappings":";;AAMA;;iBAAgB,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"}
+{"version":3,"file":"events.d.mts","names":[],"sources":["C:/Work/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

@@ -1,7 +1,7 @@
 import { Random } from "@mongez/reinforcements";
 import events from "@mongez/events";
 
-//#region ../core/src/mail/events.ts
+//#region core/src/mail/events.ts
 /**
 * Generate a unique mail ID for event namespacing
 */

package/esm/mail/events.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"events.mjs","names":[],"sources":["../../../../../../../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"}
+{"version":3,"file":"events.mjs","names":[],"sources":["C:/Work/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/mail.d.mts

@@ -1,7 +1,7 @@
 import { MailAddress, MailAttachment, MailConfigurations, MailEvents, MailOptions, MailPriority, MailResult } from "./types.mjs";
 import React from "react";
 
-//#region ../core/src/mail/mail.d.ts
+//#region core/src/mail/mail.d.ts
 /**
  * Fluent Mail Builder
  *

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

@@ -1 +1 @@
-{"version":3,"file":"mail.d.mts","names":[],"sources":["../../../../../../../core/src/mail/mail.ts"],"mappings":";;;;;;AAwCA;;;;;;;;;;;;;;;;;;;;;;;;;;cAAa,IAAA;EAAA,QACH,OAAA;EAUwC;;;EAAA,QALzC,WAAA;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,IAAc,OAAA,CAAQ,WAAA;;;;UAOrB,QAAA;;;;EAiBK,IAAA,IAAQ,OAAA,CAAQ,UAAA;AAAA"}
+{"version":3,"file":"mail.d.mts","names":[],"sources":["C:/Work/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"}

package/esm/mail/mail.mjs

@@ -1,6 +1,6 @@
 import { sendMail } from "./send-mail.mjs";
 
-//#region ../core/src/mail/mail.ts
+//#region core/src/mail/mail.ts
 /**
 * Fluent Mail Builder
 *

package/esm/mail/mail.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"mail.mjs","names":[],"sources":["../../../../../../../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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"}
+{"version":3,"file":"mail.mjs","names":[],"sources":["C:/Work/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

@@ -1,7 +1,7 @@
 import { MailConfigurations } from "./types.mjs";
 import { Transporter } from "nodemailer";
 
-//#region ../core/src/mail/mailer-pool.d.ts
+//#region core/src/mail/mailer-pool.d.ts
 /**
  * Get or create a mailer transporter from the pool
  * Nodemailer is eagerly loaded at import time

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

@@ -1 +1 @@
-{"version":3,"file":"mailer-pool.d.mts","names":[],"sources":["../../../../../../../core/src/mail/mailer-pool.ts"],"mappings":";;;;;;AAiLA;;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;;;;iBAYA,YAAA;EAAkB,IAAA;EAAc,MAAM;AAAA"}
+{"version":3,"file":"mailer-pool.d.mts","names":[],"sources":["C:/Work/Warlock.js/core/src/mail/mailer-pool.ts"],"mappings":";;;;;;AAoLA;;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

@@ -1,6 +1,6 @@
 import { log } from "@warlock.js/logger";
 
-//#region ../core/src/mail/mailer-pool.ts
+//#region core/src/mail/mailer-pool.ts
 /**
 * Installation instructions for nodemailer
 */
@@ -67,6 +67,8 @@ function isSesConfig(config) {
 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}`);
+	if (moduleExists === null && nodemailerLoadPromise) await nodemailerLoadPromise;
+	if (moduleExists === false) throw new Error(`nodemailer is not installed.\n\n${NODEMAILER_INSTALL_INSTRUCTIONS}`);
 	const hash = `ses_${config.region}_${config.accessKeyId}`;
 	const existingTransporter = mailerPool.get(hash);
 	if (existingTransporter) return existingTransporter;

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

@@ -1 +1 @@
-{"version":3,"file":"mailer-pool.mjs","names":[],"sources":["../../../../../../../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  // PRECONDITION: callers must already have awaited `nodemailerLoadPromise` — `getMailer` does, at\n  // its own guard above, before it dispatches here. This function reads `nodemailerModule` WITHOUT\n  // resolving it, and is safe only because it is unexported with a single call site. Exporting it,\n  // or adding a caller outside `getMailer`, reintroduces defect #20: a synchronous read of a module\n  // whose load was started and never awaited. Tracked as #29.\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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"}
+{"version":3,"file":"mailer-pool.mjs","names":[],"sources":["C:/Work/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  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  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":";;;;;;AAYA,MAAM,kCAAkC;;;;;;;;;;;EAWtC,KAAK;;;;AAKP,IAAI,eAA+B;;;;AAKnC,IAAI;AAEJ,IAAI,wBAA8C;;;;AAKlD,eAAe,uBAAuB;CACpC,IAAI;EAEF,oBAAmB,MADE,OAAO,eACF;EAC1B,eAAe;CACjB,QAAQ;EACN,eAAe;CACjB;AACF;AAGA,wBAAwB,qBAAqB;AAE7C,MAAM,2BAA2B;;;;;;;;;;;EAW/B,KAAK;AAEP,IAAI,kBAAkC;AAEtC,IAAI;AAEJ,IAAI,iBAAuC;AAE3C,eAAe,gBAAgB;CAC7B,IAAI;EAEF,aAAY,MADS,OAAO,0BACT;EACnB,kBAAkB;CACpB,QAAQ;EACN,kBAAkB;CACpB;AACF;AAEA,iBAAiB,cAAc;AAE/B,SAAS,YAAY,QAAyD;CAC5E,OAAO,YAAY,UAAU,OAAO,WAAW;AACjD;AAEA,eAAe,aAAa,QAAiD;CAC3E,IAAI,oBAAoB,QAAQ,gBAC9B,MAAM;CAGR,IAAI,oBAAoB,OACtB,MAAM,IAAI,MAAM,8CAA8C,0BAA0B;CAG1F,IAAI,iBAAiB,QAAQ,uBAC3B,MAAM;CAGR,IAAI,iBAAiB,OACnB,MAAM,IAAI,MAAM,mCAAmC,iCAAiC;CAGtF,MAAM,OAAO,OAAO,OAAO,OAAO,GAAG,OAAO;CAE5C,MAAM,sBAAsB,WAAW,IAAI,IAAI;CAC/C,IAAI,qBACF,OAAO;CAGT,IAAI,KAAK,QAAQ,QAAQ,iDAAiD,WAAW,OAAO,EAAE,EAAE;CAEhG,MAAM,MAAM,IAAI,UAAW,YAAY;EACrC,QAAQ,OAAO;EACf,aAAa;GACX,aAAa,OAAO;GACpB,iBAAiB,OAAO;EAC1B;CACF,CAAC;CAED,MAAM,cAAc,iBAAiB,gBAAgB,EACnD,KAAK;EAAE,WAAW;EAAK,kBAAkB,UAAU;CAAiB,EACtE,CAAC;CAED,WAAW,IAAI,MAAM,WAAW;CAEhC,OAAO;AACT;;;;;AAUA,MAAM,6BAAa,IAAI,IAAyB;;;;AAKhD,SAAS,iBAAiB,QAAoC;CAC5D,MAAM,MAAM,KAAK,UAAU;EAEzB,MAAM,OAAO;EACb,MAAM,OAAO;EACb,QAAQ,OAAO;EACf,MAAM,OAAO;EACb,UAAU,OAAO;EACjB,UAAU,OAAO;CACnB,CAAC;CAGD,IAAI,OAAO;CACX,KAAK,IAAI,IAAI,GAAG,IAAI,IAAI,QAAQ,KAAK;EACnC,MAAM,OAAO,IAAI,WAAW,CAAC;EAC7B,QAAQ,QAAQ,KAAK,OAAO;EAC5B,OAAO,OAAO;CAChB;CAEA,OAAO,UAAU;AACnB;;;;AAKA,SAAS,cAAc,QAAoC;CACzD,IAAI,YAAY,MAAM,GACpB,OAAO,OAAO,OAAO,OAAO,GAAG,OAAO;CAExC,OAAO,iBAAiB,MAAM;AAChC;;;;;AAMA,eAAsB,UAAU,QAAkD;CAChF,IAAI,iBAAiB,QAAQ,uBAC3B,MAAM;CAGR,IAAI,iBAAiB,OACnB,MAAM,IAAI,MAAM,mCAAmC,iCAAiC;CAGtF,IAAI,YAAY,MAAM,GACpB,OAAO,aAAa,MAAM;CAG5B,MAAM,OAAO,cAAc,MAAM;CAGjC,MAAM,sBAAsB,WAAW,IAAI,IAAI;CAE/C,IAAI,qBACF,OAAO;CAIT,IAAI,KAAK,QAAQ,QAAQ,6CAA6C,WAAW,OAAO,EAAE,EAAE;CAE5F,MAAM,EAAE,MAAM,UAAU,UAAU,YAAY,KAAK,GAAG,oBAAoB;CAE1E,MAAM,cAAc,iBAAiB,gBAAgB;EACnD,YAAY,cAAc;EAC1B,MAAM,QAAQ;GACZ,MAAM;GACN,MAAM;EACR;EACA,GAAG;CACL,CAAC;CAGD,WAAW,IAAI,MAAM,WAAW;CAEhC,OAAO;AACT;;;;AAKA,eAAsB,aAAa,QAA8C;CAC/E,MAAM,cAAc,MAAM,UAAU,MAAM;CAE1C,IAAI;EACF,MAAM,YAAY,OAAO;EACzB,OAAO;CACT,QAAQ;EACN,OAAO;CACT;AACF;;;;AAKA,SAAgB,YAAY,QAAkC;CAC5D,MAAM,OAAO,cAAc,MAAM;CACjC,MAAM,cAAc,WAAW,IAAI,IAAI;CAEvC,IAAI,aAAa;EACf,YAAY,MAAM;EAClB,WAAW,OAAO,IAAI;EACtB,IAAI,KAAK,QAAQ,QAAQ,uCAAuC,WAAW,KAAK,EAAE;CACpF;AACF;;;;AAKA,SAAgB,kBAAwB;CACtC,KAAK,MAAM,CAAC,MAAM,gBAAgB,YAAY;EAC5C,YAAY,MAAM;EAClB,WAAW,OAAO,IAAI;CACxB;CAEA,IAAI,KAAK,QAAQ,QAAQ,8BAA8B;AACzD;;;;AAKA,SAAgB,eAAmD;CACjE,OAAO;EACL,MAAM,WAAW;EACjB,QAAQ,MAAM,KAAK,WAAW,KAAK,CAAC;CACtC;AACF"}

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

@@ -1,6 +1,6 @@
 import React from "react";
 
-//#region ../core/src/mail/react-mail.d.ts
+//#region core/src/mail/react-mail.d.ts
 /**
  * Render a React element to HTML for email
  *

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

@@ -1 +1 @@
-{"version":3,"file":"react-mail.d.mts","names":[],"sources":["../../../../../../../core/src/mail/react-mail.ts"],"mappings":";;;;;AAiCA;;;;;;;iBAAsB,eAAA,CACpB,OAAA,EAAS,KAAA,CAAM,YAAA,GAAe,KAAA,CAAM,aAAA,GACnC,OAAA"}
+{"version":3,"file":"react-mail.d.mts","names":[],"sources":["C:/Work/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

@@ -1,6 +1,6 @@
 import { renderReact } from "../react/index.mjs";
 
-//#region ../core/src/mail/react-mail.ts
+//#region core/src/mail/react-mail.ts
 /**
 * Create a complete HTML page from rendered content
 */

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

@@ -1 +1 @@
-{"version":3,"file":"react-mail.mjs","names":[],"sources":["../../../../../../../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"}
+{"version":3,"file":"react-mail.mjs","names":[],"sources":["C:/Work/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

@@ -1,6 +1,6 @@
 import { MailOptions, MailResult } from "./types.mjs";
 
-//#region ../core/src/mail/send-mail.d.ts
+//#region core/src/mail/send-mail.d.ts
 /**
  * Send an email
  *

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

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

package/esm/mail/send-mail.mjs

@@ -7,7 +7,7 @@ import { MailError } from "./types.mjs";
 import { log } from "@warlock.js/logger";
 import { readFile } from "node:fs/promises";
 
-//#region ../core/src/mail/send-mail.ts
+//#region core/src/mail/send-mail.ts
 /**
 * Normalize email address to string
 */

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

@@ -1 +1 @@
-{"version":3,"file":"send-mail.mjs","names":[],"sources":["../../../../../../../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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"}
+{"version":3,"file":"send-mail.mjs","names":[],"sources":["C:/Work/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

@@ -1,6 +1,6 @@
 import { CapturedMail } from "./types.mjs";
 
-//#region ../core/src/mail/test-mailbox.d.ts
+//#region core/src/mail/test-mailbox.d.ts
 /**
  * Add a mail to the test mailbox
  */

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

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

@@ -1,4 +1,4 @@
-//#region ../core/src/mail/test-mailbox.ts
+//#region core/src/mail/test-mailbox.ts
 /**
 * Test mailbox for capturing sent emails in test mode
 */

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

@@ -1 +1 @@
-{"version":3,"file":"test-mailbox.mjs","names":[],"sources":["../../../../../../../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,EACrE,CAAC,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,CAAC,CAAC,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"}
+{"version":3,"file":"test-mailbox.mjs","names":[],"sources":["C:/Work/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"}

package/esm/mail/types.d.mts

@@ -1,7 +1,7 @@
 import React from "react";
 import SMTPTransport from "nodemailer/lib/smtp-transport";
 
-//#region ../core/src/mail/types.d.ts
+//#region core/src/mail/types.d.ts
 /**
  * AWS SES mail configuration
  */