@warlock.js/core 4.1.14 → 4.2.0

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

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

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

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

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

@@ -1,6 +1,6 @@
 import { MailOptions, MailResult } from "./types.mjs";
 
-//#region ../../@warlock.js/core/src/mail/send-mail.d.ts
+//#region ../@warlock.js/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":["../../../../../../@warlock.js/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":["../../../../../../../@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 ../../@warlock.js/core/src/mail/send-mail.ts
+//#region ../@warlock.js/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":["../../../../../../@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":";;;;;;;;;;;;;AAsBA,SAAS,gBAAgB,SAA8B;CACrD,IAAI,OAAO,YAAY,UACrB,OAAO;CAGT,OAAO,IAAI,QAAQ,KAAK,KAAK,QAAQ,QAAQ;AAC/C;;;;AAKA,SAAS,oBAAoB,YAAqD;CAChF,IAAI,CAAC,YACH,OAAO,CAAC;CAGV,OAAO,MAAM,QAAQ,UAAU,IAAI,aAAa,CAAC,UAAU;AAC7D;;;;AAKA,SAAS,YAAY,UAAmD;CACtE,OAAO;AACT;;;;AAKA,SAAS,cAAc,SAAsC;CAC3D,MAAM,SAAS,kBAAkB,OAAO;CAExC,OAAO;EACL,IAAI,oBAAoB,QAAQ,EAAE;EAClC,IAAI,oBAAoB,QAAQ,EAAE;EAClC,KAAK,oBAAoB,QAAQ,GAAG;EACpC,SAAS,QAAQ;EACjB,MAAM,QAAQ,QAAQ,OAAO,QAAQ;GAAE,MAAM;GAAY,SAAS;EAAoB;EACtF,SAAS,QAAQ;EACjB,MAAM,QAAQ;EACd,MAAM,QAAQ;EACd,aAAa,QAAQ,eAAe,CAAC;EACrC,UAAU,QAAQ,YAAY;EAC9B,SAAS,QAAQ,WAAW,CAAC;EAC7B,MAAM,QAAQ,QAAQ,CAAC;EACvB,eAAe,QAAQ;EACvB;CACF;AACF;;;;AAKA,eAAe,kBAAkB,YAM9B;CAED,IAAI,WAAW,MACb,IAAI;EACF,MAAM,UAAU,MAAM,SAAS,WAAW,IAAI;EAC9C,OAAO;GACL,UAAU,WAAW;GACrB;GACA,aAAa,WAAW;GACxB,UAAU,WAAW;GACrB,KAAK,WAAW;EAClB;CACF,SAAS,OAAO;EACd,MAAM,IAAI,UACR,mCAAmC,WAAW,KAAK,KAAK,iBAAiB,QAAQ,MAAM,UAAU,mBACjG,gBACA,iBAAiB,QAAQ,QAAQ,MACnC;CACF;CAIF,OAAO;EACL,UAAU,WAAW;EACrB,SAAS,WAAW;EACpB,aAAa,WAAW;EACxB,UAAU,WAAW;EACrB,KAAK,WAAW;CAClB;AACF;;;;AAKA,eAAe,uBAAuB,YAAwD;CAC5F,MAAM,UAA6B;EACjC,IAAI,WAAW;EACf,MAAM,gBAAgB,WAAW,IAAI;EACrC,SAAS,WAAW;EACpB,UAAU,YAAY,WAAW,QAAQ;CAC3C;CAEA,IAAI,WAAW,GAAG,SAAS,GACzB,QAAQ,KAAK,WAAW;CAG1B,IAAI,WAAW,IAAI,SAAS,GAC1B,QAAQ,MAAM,WAAW;CAG3B,IAAI,WAAW,SACb,QAAQ,UAAU,WAAW;CAG/B,IAAI,WAAW,MACb,QAAQ,OAAO,WAAW;CAG5B,IAAI,WAAW,MACb,QAAQ,OAAO,WAAW;CAG5B,IAAI,WAAW,YAAY,SAAS,GAMlC,QAAQ,eAAc,MAJY,QAAQ,IACxC,WAAW,YAAY,KAAK,QAAQ,kBAAkB,GAAqB,CAAC,CAC9E,GAE0C,KAAK,SAAS;EACtD,UAAU,IAAI;EACd,SAAS,IAAI;EACb,aAAa,IAAI;EACjB,UAAU,IAAI;EACd,KAAK,IAAI;CACX,EAAE;CAGJ,IAAI,OAAO,KAAK,WAAW,OAAO,EAAE,SAAS,GAC3C,QAAQ,UAAU,WAAW;CAG/B,OAAO;AACT;;;;AAKA,eAAe,aACb,SACA,GAAG,MACiC;CACpC,IAAI,CAAC,SACH;CAGF,IAAI;EACF,OAAO,MAAM,QAAQ,GAAG,IAAI;CAC9B,SAAS,OAAO;EACd,IAAI,MAAM,QAAQ,SAAS,iCAAiC,OAAO;EACnE;CACF;AACF;;;;AAKA,eAAe,cACb,QACA,OACA,GAAG,MACa;CAChB,IAAI;EAEF,MAAM,kBACJ,UAAU,kBACN,mBACA,UAAU,SACR,SACA,UAAU,YACR,YACA;EAEV,MAAM,gBAAgB,MAAM,WAAW,QACrC,iBACA,GAAG,IACL;EAGA,MAAM,kBAAkB,MAAM,WAAW,eAAe,QAAQ,OAAO,GAAG,IAAI;EAE9E,OAAO,CAAC,GAAI,iBAAiB,CAAC,GAAI,GAAI,mBAAmB,CAAC,CAAE;CAC9D,SAAS,OAAO;EACd,IAAI,MAAM,QAAQ,SAAS,wBAAwB,OAAO;EAC1D,OAAO,CAAC;CACV;AACF;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAgCA,eAAsB,SAAS,SAA2C;CAExE,MAAM,SAAS,QAAQ,MAAM,eAAe;CAG5C,IAAI,QAAQ,WACV,IAAI;EACF,QAAQ,OAAO,MAAM,gBAAgB,QAAQ,SAAS;CACxD,SAAS,OAAO;EACd,MAAM,YAAY,IAAI,UACpB,qCAAqC,iBAAiB,QAAQ,MAAM,UAAU,mBAC9E,gBACA,iBAAiB,QAAQ,QAAQ,MACnC;EAEA,MAAM,aAAa,QAAQ,SAAS,SAAS,SAAS;EACtD,MAAM,cAAc,QAAQ,SAAS,SAAS,SAAS;EAEvD,MAAM;CACR;CAIF,MAAM,aAAa,cAAc,OAAO;CACxC,MAAM,SAAS,WAAW,OAAO,UAAU;CAG3C,MAAM,eAAe,MAAM,aAAa,QAAQ,eAAe,OAAO;CACtE,MAAM,sBAAsB,MAAM,cAAc,QAAQ,iBAAiB,OAAO;CAGhF,IAAI,iBAAiB,SAAS,oBAAoB,MAAM,MAAM,MAAM,KAAK,GAAG;EAC1E,IAAI,KACF,QAAQ,UACR,aACA,+CACF;EASA,OAAO;GANL,SAAS;GACT,UAAU,CAAC;GACX,UAAU,WAAW;GACrB,UAAU;EAGA;CACd;CAGA,IAAI,WAAW,GAAG;EAChB,IAAI,KACF,QAAQ,UACR,QACA,iCAAiC,WAAW,GAAG,KAAK,IAAI,GAC1D;EAEA,MAAM,SAAqB;GACzB,SAAS;GACT,WAAW,QAAQ,OAAO;GAC1B,UAAU,WAAW;GACrB,UAAU,CAAC;GACX,UAAU;EACZ;EASA,YAAY;GANV;GACA;GACA,2BAAW,IAAI,KAAK;GACpB;EAGiB,CAAC;EAEpB,MAAM,aAAa,QAAQ,WAAW,SAAS,MAAM;EACrD,MAAM,cAAc,QAAQ,WAAW,SAAS,MAAM;EACtD,MAAM,aAAa,QAAQ,QAAQ,SAAS,QAAQ,IAAI;EACxD,MAAM,cAAc,QAAQ,QAAQ,SAAS,QAAQ,IAAI;EAEzD,OAAO;CACT;CAGA,IAAI,kBAAkB,GAAG;EACvB,IAAI,KACF,QAAQ,UACR,OACA,kCAAkC,WAAW,GAAG,KAAK,IAAI,GAC3D;EACA,IAAI,KAAK,QAAQ,UAAU,OAAO,YAAY,WAAW,SAAS;EAElE,IAAI,WAAW,MACb,IAAI,KACF,QAAQ,UACR,OACA,gBAAgB,WAAW,KAAK,OAAO,OACzC;EAGF,MAAM,SAAqB;GACzB,SAAS;GACT,WAAW,OAAO,OAAO;GACzB,UAAU,WAAW;GACrB,UAAU,CAAC;GACX,UAAU;EACZ;EAEA,MAAM,aAAa,QAAQ,WAAW,SAAS,MAAM;EACrD,MAAM,cAAc,QAAQ,WAAW,SAAS,MAAM;EACtD,MAAM,aAAa,QAAQ,QAAQ,SAAS,QAAQ,IAAI;EACxD,MAAM,cAAc,QAAQ,QAAQ,SAAS,QAAQ,IAAI;EAEzD,OAAO;CACT;CAGA,IAAI;EAEF,MAAM,SAAS,MAAM,UADN,kBAAkB,OACG,CAAC;EACrC,MAAM,oBAAoB,MAAM,uBAAuB,UAAU;EAEjE,IAAI,KACF,QAAQ,UACR,QACA,oBAAoB,WAAW,GAAG,KAAK,IAAI,GAC7C;EAEA,MAAM,SAAS,MAAM,OAAO,SAAS,iBAAiB;EAEtD,MAAM,WAAW,OAAO,aAAa,OAAO,YAAY,WAAW,KAAK,CAAC;EACzE,MAAM,WAAW,OAAO,YAAY,CAAC;EAErC,MAAM,SAAqB;GACzB,SAAS,SAAS,SAAS;GAC3B,WAAW,OAAO;GACR;GACA;GACV,UAAU,OAAO;GACjB,UAAU,OAAO;EACnB;EAEA,IAAI,OAAO,SAAS;GAClB,IAAI,QACF,QAAQ,UACR,QACA,+BAA+B,OAAO,UAAU,EAClD;GACA,MAAM,aAAa,QAAQ,WAAW,SAAS,MAAM;GACrD,MAAM,cAAc,QAAQ,WAAW,SAAS,MAAM;EACxD,OACE,IAAI,KACF,QAAQ,UACR,WACA,4BAA4B,SAAS,KAAK,IAAI,GAChD;EAGF,MAAM,aAAa,QAAQ,QAAQ,SAAS,QAAQ,IAAI;EACxD,MAAM,cAAc,QAAQ,QAAQ,SAAS,QAAQ,IAAI;EAEzD,OAAO;CACT,SAAS,OAAO;EACd,MAAM,eAAe,iBAAiB,QAAQ,MAAM,UAAU;EAC9D,IAAI,OAA0B;EAG9B,IAAI,aAAa,SAAS,cAAc,KAAK,aAAa,SAAS,WAAW,GAC5E,OAAO;OACF,IAAI,aAAa,SAAS,gBAAgB,KAAK,aAAa,SAAS,MAAM,GAChF,OAAO;OACF,IAAI,aAAa,SAAS,SAAS,KAAK,aAAa,SAAS,WAAW,GAC9E,OAAO;OACF,IAAI,aAAa,SAAS,MAAM,KAAK,aAAa,SAAS,OAAO,GACvE,OAAO;EAGT,MAAM,YAAY,IAAI,UACpB,wBAAwB,gBACxB,MACA,iBAAiB,QAAQ,QAAQ,MACnC;EAEA,IAAI,MAAM,QAAQ,UAAU,SAAS,UAAU,OAAO;EAEtD,MAAM,aAAa,QAAQ,SAAS,SAAS,SAAS;EACtD,MAAM,cAAc,QAAQ,SAAS,SAAS,SAAS;EACvD,MAAM,aAAa,QAAQ,QAAQ,SAAS,MAAM,SAAS;EAC3D,MAAM,cAAc,QAAQ,QAAQ,SAAS,MAAM,SAAS;EAE5D,MAAM;CACR;AACF"}
+{"version":3,"file":"send-mail.mjs","names":[],"sources":["../../../../../../../@warlock.js/core/src/mail/send-mail.ts"],"sourcesContent":["import { log } from \"@warlock.js/logger\";\nimport { readFile } from \"node:fs/promises\";\nimport type { Options as NodemailerOptions } from \"nodemailer/lib/mailer\";\nimport { isDevelopmentMode, isTestMode, resolveMailConfig } from \"./config\";\nimport { MAIL_EVENTS, generateMailId, mailEvents } from \"./events\";\nimport { getMailer } from \"./mailer-pool\";\nimport { renderReactMail } from \"./react-mail\";\nimport { captureMail } from \"./test-mailbox\";\nimport {\n  MailError,\n  type CapturedMail,\n  type MailAddress,\n  type MailAttachment,\n  type MailOptions,\n  type MailPriority,\n  type MailResult,\n  type NormalizedMail,\n} from \"./types\";\n\n/**\n * Normalize email address to string\n */\nfunction addressToString(address: MailAddress): string {\n  if (typeof address === \"string\") {\n    return address;\n  }\n\n  return `\"${address.name}\" <${address.address}>`;\n}\n\n/**\n * Normalize recipients to array\n */\nfunction normalizeRecipients(recipients: string | string[] | undefined): string[] {\n  if (!recipients) {\n    return [];\n  }\n\n  return Array.isArray(recipients) ? recipients : [recipients];\n}\n\n/**\n * Map priority to nodemailer format\n */\nfunction mapPriority(priority: MailPriority): \"high\" | \"normal\" | \"low\" {\n  return priority;\n}\n\n/**\n * Normalize mail options to internal format\n */\nfunction normalizeMail(options: MailOptions): NormalizedMail {\n  const config = resolveMailConfig(options);\n\n  return {\n    to: normalizeRecipients(options.to),\n    cc: normalizeRecipients(options.cc),\n    bcc: normalizeRecipients(options.bcc),\n    replyTo: options.replyTo,\n    from: options.from || config.from || { name: \"No Reply\", address: \"noreply@localhost\" },\n    subject: options.subject,\n    html: options.html,\n    text: options.text,\n    attachments: options.attachments || [],\n    priority: options.priority || \"normal\",\n    headers: options.headers || {},\n    tags: options.tags || [],\n    correlationId: options.correlationId,\n    config,\n  };\n}\n\n/**\n * Resolve attachment - read file if path is provided\n */\nasync function resolveAttachment(attachment: MailAttachment): Promise<{\n  filename: string;\n  content: Buffer | string;\n  contentType?: string;\n  encoding?: string;\n  cid?: string;\n}> {\n  // If path is provided, read the file\n  if (attachment.path) {\n    try {\n      const content = await readFile(attachment.path);\n      return {\n        filename: attachment.filename,\n        content,\n        contentType: attachment.contentType,\n        encoding: attachment.encoding,\n        cid: attachment.cid,\n      };\n    } catch (error) {\n      throw new MailError(\n        `Failed to read attachment file \"${attachment.path}\": ${error instanceof Error ? error.message : \"Unknown error\"}`,\n        \"CONFIG_ERROR\",\n        error instanceof Error ? error : undefined,\n      );\n    }\n  }\n\n  // Already has content\n  return {\n    filename: attachment.filename,\n    content: attachment.content!,\n    contentType: attachment.contentType,\n    encoding: attachment.encoding,\n    cid: attachment.cid,\n  };\n}\n\n/**\n * Build nodemailer options from normalized mail\n */\nasync function buildNodemailerOptions(normalized: NormalizedMail): Promise<NodemailerOptions> {\n  const options: NodemailerOptions = {\n    to: normalized.to,\n    from: addressToString(normalized.from),\n    subject: normalized.subject,\n    priority: mapPriority(normalized.priority),\n  };\n\n  if (normalized.cc.length > 0) {\n    options.cc = normalized.cc;\n  }\n\n  if (normalized.bcc.length > 0) {\n    options.bcc = normalized.bcc;\n  }\n\n  if (normalized.replyTo) {\n    options.replyTo = normalized.replyTo;\n  }\n\n  if (normalized.html) {\n    options.html = normalized.html;\n  }\n\n  if (normalized.text) {\n    options.text = normalized.text;\n  }\n\n  if (normalized.attachments.length > 0) {\n    // Resolve all attachments (read files if needed)\n    const resolvedAttachments = await Promise.all(\n      normalized.attachments.map((att) => resolveAttachment(att as MailAttachment)),\n    );\n\n    options.attachments = resolvedAttachments.map((att) => ({\n      filename: att.filename,\n      content: att.content,\n      contentType: att.contentType,\n      encoding: att.encoding,\n      cid: att.cid,\n    }));\n  }\n\n  if (Object.keys(normalized.headers).length > 0) {\n    options.headers = normalized.headers;\n  }\n\n  return options;\n}\n\n/**\n * Run per-mail event handler\n */\nasync function runMailEvent<T extends (...args: any[]) => any>(\n  handler: T | undefined,\n  ...args: Parameters<T>\n): Promise<ReturnType<T> | undefined> {\n  if (!handler) {\n    return undefined;\n  }\n\n  try {\n    return await handler(...args);\n  } catch (error) {\n    log.error(\"mail\", \"event\", `Per-mail event handler error: ${error}`);\n    return undefined;\n  }\n}\n\n/**\n * Trigger both global and mail-specific events\n */\nasync function triggerEvents(\n  mailId: string,\n  event: \"beforeSending\" | \"sent\" | \"success\" | \"error\",\n  ...args: any[]\n): Promise<any[]> {\n  try {\n    // Trigger global event (e.g., mail.success)\n    const globalEventName =\n      event === \"beforeSending\"\n        ? \"BEFORE_SENDING\"\n        : event === \"sent\"\n          ? \"SENT\"\n          : event === \"success\"\n            ? \"SUCCESS\"\n            : \"ERROR\";\n\n    const globalResults = await mailEvents.trigger(\n      globalEventName as keyof typeof MAIL_EVENTS,\n      ...args,\n    );\n\n    // Trigger mail-specific event (e.g., mail.$id.success)\n    const specificResults = await mailEvents.triggerForMail(mailId, event, ...args);\n\n    return [...(globalResults || []), ...(specificResults || [])];\n  } catch (error) {\n    log.error(\"mail\", \"event\", `Event handler error: ${error}`);\n    return [];\n  }\n}\n\n/**\n * Send an email\n *\n * @param options Mail options including recipients, content, and configuration\n * @returns Result containing success status, message ID, and accepted/rejected recipients\n *\n * @example\n * ```typescript\n * // Basic usage\n * await sendMail({\n *   to: \"user@example.com\",\n *   subject: \"Hello\",\n *   html: \"<p>World</p>\",\n * });\n *\n * // With React component\n * await sendMail({\n *   to: \"user@example.com\",\n *   subject: \"Welcome!\",\n *   component: <WelcomeEmail name=\"John\" />,\n * });\n *\n * // Track specific mail with events\n * const mailId = generateMailId();\n * mailEvents.onMailSuccess(mailId, (mail, result) => {\n *   console.log(\"This specific mail was sent!\");\n * });\n * await sendMail({ id: mailId, to: \"...\", subject: \"...\", html: \"...\" });\n * ```\n */\nexport async function sendMail(options: MailOptions): Promise<MailResult> {\n  // Generate or use provided mail ID\n  const mailId = options.id || generateMailId();\n\n  // Render React component if provided\n  if (options.component) {\n    try {\n      options.html = await renderReactMail(options.component);\n    } catch (error) {\n      const mailError = new MailError(\n        `Failed to render React component: ${error instanceof Error ? error.message : \"Unknown error\"}`,\n        \"RENDER_ERROR\",\n        error instanceof Error ? error : undefined,\n      );\n\n      await runMailEvent(options.onError, options, mailError);\n      await triggerEvents(mailId, \"error\", options, mailError);\n\n      throw mailError;\n    }\n  }\n\n  // Normalize mail\n  const normalized = normalizeMail(options);\n  const driver = normalized.config.driver || \"smtp\";\n\n  // Run beforeSending event (per-mail, global, and mail-specific)\n  const beforeResult = await runMailEvent(options.beforeSending, options);\n  const globalBeforeResults = await triggerEvents(mailId, \"beforeSending\", options);\n\n  // If any returns false, cancel sending\n  if (beforeResult === false || globalBeforeResults.some((r) => r === false)) {\n    log.info(\n      `mail.${driver}`,\n      \"cancelled\",\n      \"Mail sending cancelled by beforeSending event\",\n    );\n\n    const result: MailResult = {\n      success: false,\n      accepted: [],\n      rejected: normalized.to,\n      response: \"Cancelled by beforeSending event\",\n    };\n\n    return result;\n  }\n\n  // Test mode - capture without sending\n  if (isTestMode()) {\n    log.info(\n      `mail.${driver}`,\n      \"test\",\n      `[TEST MODE] Captured mail to: ${normalized.to.join(\", \")}`,\n    );\n\n    const result: MailResult = {\n      success: true,\n      messageId: `test-${mailId}@localhost`,\n      accepted: normalized.to,\n      rejected: [],\n      response: \"Test mode - mail captured\",\n    };\n\n    const captured: CapturedMail = {\n      options,\n      normalized,\n      timestamp: new Date(),\n      result,\n    };\n\n    captureMail(captured);\n\n    await runMailEvent(options.onSuccess, options, result);\n    await triggerEvents(mailId, \"success\", options, result);\n    await runMailEvent(options.onSent, options, result, null);\n    await triggerEvents(mailId, \"sent\", options, result, null);\n\n    return result;\n  }\n\n  // Development mode - log without sending\n  if (isDevelopmentMode()) {\n    log.info(\n      `mail.${driver}`,\n      \"dev\",\n      `[DEV MODE] Would send mail to: ${normalized.to.join(\", \")}`,\n    );\n    log.info(`mail.${driver}`, \"dev\", `Subject: ${normalized.subject}`);\n\n    if (normalized.html) {\n      log.info(\n        `mail.${driver}`,\n        \"dev\",\n        `HTML length: ${normalized.html.length} chars`,\n      );\n    }\n\n    const result: MailResult = {\n      success: true,\n      messageId: `dev-${mailId}@localhost`,\n      accepted: normalized.to,\n      rejected: [],\n      response: \"Development mode - mail logged\",\n    };\n\n    await runMailEvent(options.onSuccess, options, result);\n    await triggerEvents(mailId, \"success\", options, result);\n    await runMailEvent(options.onSent, options, result, null);\n    await triggerEvents(mailId, \"sent\", options, result, null);\n\n    return result;\n  }\n\n  // Production mode - actually send\n  try {\n    const config = resolveMailConfig(options);\n    const mailer = await getMailer(config);\n    const nodemailerOptions = await buildNodemailerOptions(normalized);\n\n    log.info(\n      `mail.${driver}`,\n      \"send\",\n      `Sending mail to: ${normalized.to.join(\", \")}`,\n    );\n\n    const output = await mailer.sendMail(nodemailerOptions);\n\n    const accepted = output.accepted || (output.messageId ? normalized.to : []);\n    const rejected = output.rejected || [];\n\n    const result: MailResult = {\n      success: accepted.length > 0,\n      messageId: output.messageId,\n      accepted: accepted as string[],\n      rejected: rejected as string[],\n      response: output.response,\n      envelope: output.envelope,\n    };\n\n    if (result.success) {\n      log.success(\n        `mail.${driver}`,\n        \"sent\",\n        `Mail sent successfully (ID: ${result.messageId})`,\n      );\n      await runMailEvent(options.onSuccess, options, result);\n      await triggerEvents(mailId, \"success\", options, result);\n    } else {\n      log.warn(\n        `mail.${driver}`,\n        \"partial\",\n        `Mail partially rejected: ${rejected.join(\", \")}`,\n      );\n    }\n\n    await runMailEvent(options.onSent, options, result, null);\n    await triggerEvents(mailId, \"sent\", options, result, null);\n\n    return result;\n  } catch (error) {\n    const errorMessage = error instanceof Error ? error.message : \"Unknown error\";\n    let code: MailError[\"code\"] = \"UNKNOWN\";\n\n    // Detect error type\n    if (errorMessage.includes(\"ECONNREFUSED\") || errorMessage.includes(\"ENOTFOUND\")) {\n      code = \"CONNECTION_ERROR\";\n    } else if (errorMessage.includes(\"authentication\") || errorMessage.includes(\"auth\")) {\n      code = \"AUTH_ERROR\";\n    } else if (errorMessage.includes(\"timeout\") || errorMessage.includes(\"ETIMEDOUT\")) {\n      code = \"TIMEOUT\";\n    } else if (errorMessage.includes(\"rate\") || errorMessage.includes(\"limit\")) {\n      code = \"RATE_LIMIT\";\n    }\n\n    const mailError = new MailError(\n      `Failed to send mail: ${errorMessage}`,\n      code,\n      error instanceof Error ? error : undefined,\n    );\n\n    log.error(`mail.${driver}`, \"error\", mailError.message);\n\n    await runMailEvent(options.onError, options, mailError);\n    await triggerEvents(mailId, \"error\", options, mailError);\n    await runMailEvent(options.onSent, options, null, mailError);\n    await triggerEvents(mailId, \"sent\", options, null, mailError);\n\n    throw mailError;\n  }\n}\n"],"mappings":"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"}

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

@@ -1,6 +1,6 @@
 import { CapturedMail } from "./types.mjs";
 
-//#region ../../@warlock.js/core/src/mail/test-mailbox.d.ts
+//#region ../@warlock.js/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":["../../../../../../@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"}
+{"version":3,"file":"test-mailbox.d.mts","names":[],"sources":["../../../../../../../@warlock.js/core/src/mail/test-mailbox.ts"],"mappings":";;;;;;iBA2EgB,WAAA,CAAY,IAAkB,EAAZ,YAAY;;;;iBAO9B,cAAA,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"}

package/esm/mail/test-mailbox.mjs

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

package/esm/mail/types.d.mts

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

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

@@ -1 +1 @@
-{"version":3,"file":"types.d.mts","names":[],"sources":["../../../../../../@warlock.js/core/src/mail/types.ts"],"mappings":";;;;;;AAMA;KAAY,iBAAA;EACV,MAAA;EACA,WAAA;EACA,eAAA;EACA,MAAA;EACA,IAAA,GAAO,WAAW;AAAA;;;;KAMR,kBAAA,GAAqB,kBAAA,GAAqB,iBAAiB;AAAvE;;;AAAA,KAKY,QAAA;AAL2D;AAKvE;;AALuE,KAU3D,YAAA;;AALQ;AAKpB;KAKY,WAAA;EAGN,IAAA;EACA,OAAO;AAAA;AAJb;;;;AAAA,KAWY,cAAA;EACV,QAAA;EACA,WAAA;EACA,QAAA;EACA,GAAA;AAAA;EAGI,OAAA,EAAS,MAAM;EACf,IAAA;AAAA;EAGA,OAAA;EACA,IAAA;AAAA;;;;AAAI;AAqEV;;;;;;;;;;;;;AAwBoB;AAMpB;;;;;;;;;;;;;;AAQ6C;AAM7C;;;;;;;;;;;;;AAQM;AAON;;;;AAAyB;AAezB;;;;;;;;;;;;;KA1EY,kBAAA,GAAqB,aAAA,CAAc,OAAA;EA+FR;;;EA3FrC,MAAA;EA2EA;;;;EAtEA,GAAA;EA0EA;;;;EArEA,QAAA;EAwES;;;;EAnET,QAAA;EAwEa;;;;EAnEb,IAAA,GAAO,WAAW;AAAA;;;;KAMR,aAAA;EAiEuD;AAAA;AAMnE;EAnEE,OAAA,GAAU,kBAAA;;;;EAIV,OAAA,GAAU,MAAA,SAAe,kBAAA;AAAA;;;;KAMf,UAAA;EACV,OAAA;EACA,SAAA;EACA,QAAA;EACA,QAAA;EACA,QAAA;EACA,QAAA;IACE,IAAA;IACA,EAAA;EAAA;AAAA;;;;KAOQ,aAAA;;;;;KAeA,UAAA;EA8DV;;;;EAzDA,aAAA,IAAiB,IAAA,EAAM,WAAA,YAAuB,OAAA,iBAAwB,OAAA;EA8DtE;;;EA1DA,MAAA,IACE,IAAA,EAAM,WAAA,EACN,MAAA,EAAQ,UAAA,SACR,KAAA,EAAO,SAAA,mBACG,OAAA;EA4DF;;;EAxDV,SAAA,IAAa,IAAA,EAAM,WAAA,EAAa,MAAA,EAAQ,UAAA,YAAsB,OAAA;EAiEjD;;;EA7Db,OAAA,IAAW,IAAA,EAAM,WAAA,EAAa,KAAA,EAAO,SAAA,YAAqB,OAAA;AAAA;;;;KAMhD,WAAA;EAkDV;;;;;;;;;;;EAtCA,EAAA;EAGA,EAAA;EACA,EAAA;EACA,GAAA;EACA,OAAA;EAGA,OAAA;EACA,IAAA;EACA,IAAA;EACA,SAAA,GAAY,KAAA,CAAM,YAAA;EAGlB,MAAA,GAAS,kBAAA;EACT,MAAA;EACA,IAAA,GAAO,WAAA;EAGP,WAAA,GAAc,cAAA;EAGd,QAAA,GAAW,YAAA;EACX,OAAA,GAAU,MAAA;EACV,IAAA;EAGA,aAAA;AAAA,IACE,UAAA;;;;KAKQ,cAAA;EACV,EAAA;EACA,EAAA;EACA,GAAA;EACA,OAAA;EACA,IAAA,EAAM,WAAA;EACN,OAAA;EACA,IAAA;EACA,IAAA;EACA,WAAA,EAAa,cAAA;EACb,QAAA,EAAU,YAAA;EACV,OAAA,EAAS,MAAA;EACT,IAAA;EACA,aAAA;EACA,MAAA,EAAQ,kBAAA;AAAA;;;;KAME,YAAA;EACV,OAAA,EAAS,WAAA;EACT,UAAA,EAAY,cAAA;EACZ,SAAA,EAAW,IAAA;EACX,MAAA,GAAS,UAAA;EACT,KAAA,GAAQ,SAAA;AAAA;;;;cAMG,SAAA,SAAkB,KAAA;EAAA,SACb,IAAA,EAAM,aAAA;EAAA,SACN,aAAA,GAAgB,KAAA;cAEb,OAAA,UAAiB,IAAA,EAAM,aAAA,EAAe,aAAA,GAAgB,KAAA;AAAA"}
+{"version":3,"file":"types.d.mts","names":[],"sources":["../../../../../../../@warlock.js/core/src/mail/types.ts"],"mappings":";;;;;;AAMA;KAAY,iBAAA;EACV,MAAA;EACA,WAAA;EACA,eAAA;EACA,MAAA;EACA,IAAA,GAAO,WAAW;AAAA;;;;KAMR,kBAAA,GAAqB,kBAAA,GAAqB,iBAAiB;AAAvE;;;AAAA,KAKY,QAAA;AAL2D;AAKvE;;AALuE,KAU3D,YAAA;;AALQ;AAKpB;KAKY,WAAA;EAGN,IAAA;EACA,OAAO;AAAA;AAJb;;;;AAAA,KAWY,cAAA;EACV,QAAA;EACA,WAAA;EACA,QAAA;EACA,GAAA;AAAA;EAGI,OAAA,EAAS,MAAM;EACf,IAAA;AAAA;EAGA,OAAA;EACA,IAAA;AAAA;;;;AAAI;AAqEV;;;;;;;;;;;;;AAwBoB;AAMpB;;;;;;;;;;;;;;AAQ6C;AAM7C;;;;;;;;;;;;;AAQM;AAON;;;;AAAyB;AAezB;;;;;;;;;;;;;KA1EY,kBAAA,GAAqB,aAAA,CAAc,OAAA;EA+FR;;;EA3FrC,MAAA;EA2EA;;;;EAtEA,GAAA;EA0EA;;;;EArEA,QAAA;EAwES;;;;EAnET,QAAA;EAwEa;;;;EAnEb,IAAA,GAAO,WAAW;AAAA;;;;KAMR,aAAA;EAiEuD;AAAA;AAMnE;EAnEE,OAAA,GAAU,kBAAA;;;;EAIV,OAAA,GAAU,MAAA,SAAe,kBAAA;AAAA;;;;KAMf,UAAA;EACV,OAAA;EACA,SAAA;EACA,QAAA;EACA,QAAA;EACA,QAAA;EACA,QAAA;IACE,IAAA;IACA,EAAA;EAAA;AAAA;;;;KAOQ,aAAA;;;;;KAeA,UAAA;EA8DV;;;;EAzDA,aAAA,IAAiB,IAAA,EAAM,WAAA,YAAuB,OAAA,iBAAwB,OAAA;EA8DtE;;;EA1DA,MAAA,IACE,IAAA,EAAM,WAAA,EACN,MAAA,EAAQ,UAAA,SACR,KAAA,EAAO,SAAA,mBACG,OAAA;EA4DF;;;EAxDV,SAAA,IAAa,IAAA,EAAM,WAAA,EAAa,MAAA,EAAQ,UAAA,YAAsB,OAAA;EAiEjD;;;EA7Db,OAAA,IAAW,IAAA,EAAM,WAAA,EAAa,KAAA,EAAO,SAAA,YAAqB,OAAA;AAAA;;;;KAMhD,WAAA;EAkDV;;;;;;;;;;;EAtCA,EAAA;EAGA,EAAA;EACA,EAAA;EACA,GAAA;EACA,OAAA;EAGA,OAAA;EACA,IAAA;EACA,IAAA;EACA,SAAA,GAAY,KAAA,CAAM,YAAA;EAGlB,MAAA,GAAS,kBAAA;EACT,MAAA;EACA,IAAA,GAAO,WAAA;EAGP,WAAA,GAAc,cAAA;EAGd,QAAA,GAAW,YAAA;EACX,OAAA,GAAU,MAAA;EACV,IAAA;EAGA,aAAA;AAAA,IACE,UAAA;;;;KAKQ,cAAA;EACV,EAAA;EACA,EAAA;EACA,GAAA;EACA,OAAA;EACA,IAAA,EAAM,WAAA;EACN,OAAA;EACA,IAAA;EACA,IAAA;EACA,WAAA,EAAa,cAAA;EACb,QAAA,EAAU,YAAA;EACV,OAAA,EAAS,MAAA;EACT,IAAA;EACA,aAAA;EACA,MAAA,EAAQ,kBAAA;AAAA;;;;KAME,YAAA;EACV,OAAA,EAAS,WAAA;EACT,UAAA,EAAY,cAAA;EACZ,SAAA,EAAW,IAAA;EACX,MAAA,GAAS,UAAA;EACT,KAAA,GAAQ,SAAA;AAAA;;;;cAMG,SAAA,SAAkB,KAAA;EAAA,SACb,IAAA,EAAM,aAAA;EAAA,SACN,aAAA,GAAgB,KAAA;cAEb,OAAA,UAAiB,IAAA,EAAM,aAAA,EAAe,aAAA,GAAgB,KAAA;AAAA"}

package/esm/mail/types.mjs

@@ -1,4 +1,4 @@
-//#region ../../@warlock.js/core/src/mail/types.ts
+//#region ../@warlock.js/core/src/mail/types.ts
 /**
 * Mail error class
 */

package/esm/mail/types.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"types.mjs","names":[],"sources":["../../../../../../@warlock.js/core/src/mail/types.ts"],"sourcesContent":["import type SMTPTransport from \"nodemailer/lib/smtp-transport\";\nimport type React from \"react\";\n\n/**\n * AWS SES mail configuration\n */\nexport type SESConfigurations = {\n  driver: \"ses\";\n  accessKeyId: string;\n  secretAccessKey: string;\n  region: string;\n  from?: MailAddress;\n};\n\n/**\n * Any mail configuration (SMTP or SES)\n */\nexport type MailConfigurations = SMTPConfigurations | SESConfigurations;\n\n/**\n * Mail mode determines how emails are handled\n */\nexport type MailMode = \"production\" | \"development\" | \"test\";\n\n/**\n * Mail priority levels\n */\nexport type MailPriority = \"high\" | \"normal\" | \"low\";\n\n/**\n * Email address with optional name\n */\nexport type MailAddress =\n  | string\n  | {\n      name: string;\n      address: string;\n    };\n\n/**\n * Mail attachment\n * Supports both buffer/string content and file paths\n */\nexport type MailAttachment = {\n  filename: string;\n  contentType?: string;\n  encoding?: \"base64\" | \"binary\" | \"hex\";\n  cid?: string; // Content-ID for inline attachments\n} & (\n  | {\n      content: Buffer | string;\n      path?: never;\n    }\n  | {\n      content?: never;\n      path: string; // File path - will be read automatically\n    }\n);\n\n/**\n * Mail configuration for SMTP transport\n *\n * ## Basic Configuration\n *\n * ```typescript\n * setMailConfigurations({\n *   host: \"smtp.gmail.com\",\n *   port: 587,\n *   secure: false,           // true for 465, false for other ports\n *   tls: true,               // Use STARTTLS\n *   username: \"user@gmail.com\",\n *   password: \"app-password\",\n *   from: { name: \"My App\", address: \"noreply@myapp.com\" },\n * });\n * ```\n *\n * ## Configuration Options\n *\n * | Option | Type | Default | Description |\n * |--------|------|---------|-------------|\n * | `host` | `string` | - | SMTP server hostname (e.g., \"smtp.gmail.com\") |\n * | `port` | `number` | 587 | SMTP port. Common: 25, 465 (SSL), 587 (TLS) |\n * | `secure` | `boolean` | false | Use SSL/TLS. Set `true` for port 465 |\n * | `tls` | `boolean` | true | Enable STARTTLS upgrade. For port 587 |\n * | `requireTLS` | `boolean` | - | Fail if STARTTLS upgrade fails |\n * | `username` | `string` | - | SMTP auth username (convenience alias) |\n * | `password` | `string` | - | SMTP auth password (convenience alias) |\n * | `auth` | `object` | - | Full auth object: `{ user, pass, type }` |\n * | `from` | `MailAddress` | - | Default sender for all emails |\n *\n * ## Provider Examples\n *\n * ### Gmail\n * ```typescript\n * { host: \"smtp.gmail.com\", port: 587, tls: true, username: \"...\", password: \"...\" }\n * ```\n *\n * ### SendGrid\n * ```typescript\n * { host: \"smtp.sendgrid.net\", port: 587, username: \"apikey\", password: \"SG.xxx\" }\n * ```\n *\n * ### AWS SES\n * ```typescript\n * { host: \"email-smtp.us-east-1.amazonaws.com\", port: 587, username: \"...\", password: \"...\" }\n * ```\n *\n * ### Mailgun\n * ```typescript\n * { host: \"smtp.mailgun.org\", port: 587, username: \"postmaster@...\", password: \"...\" }\n * ```\n *\n * ## Multi-tenant Usage\n *\n * For multi-tenant apps, pass config per-mail instead of globally:\n * ```typescript\n * await sendMail({\n *   config: tenant.mailSettings,  // Tenant-specific config\n *   to: \"user@example.com\",\n *   subject: \"Hello\",\n *   html: \"<p>World</p>\",\n * });\n * ```\n */\nexport type SMTPConfigurations = SMTPTransport.Options & {\n  /**\n   * Transport driver type\n   */\n  driver?: \"smtp\";\n  /**\n   * Enable STARTTLS upgrade (alias for requireTLS)\n   * Set to `true` for port 587\n   */\n  tls?: boolean;\n  /**\n   * SMTP authentication username\n   * Convenience alias - can also use `auth.user`\n   */\n  username?: string;\n  /**\n   * SMTP authentication password\n   * Convenience alias - can also use `auth.pass`\n   */\n  password?: string;\n  /**\n   * Default sender for all emails\n   * Can be string (\"noreply@app.com\") or object ({ name, address })\n   */\n  from?: MailAddress;\n};\n\n/**\n * Named mailers configuration\n */\nexport type MailersConfig = {\n  /**\n   * Default mailer configuration\n   */\n  default?: MailConfigurations;\n  /**\n   * Named mailer configurations\n   */\n  mailers?: Record<string, MailConfigurations>;\n};\n\n/**\n * Mail result after sending\n */\nexport type MailResult = {\n  success: boolean;\n  messageId?: string;\n  accepted: string[];\n  rejected: string[];\n  response?: string;\n  envelope?: {\n    from: string;\n    to: string[];\n  };\n};\n\n/**\n * Error codes for mail operations\n */\nexport type MailErrorCode =\n  | \"CONNECTION_ERROR\"\n  | \"AUTH_ERROR\"\n  | \"RATE_LIMIT\"\n  | \"INVALID_ADDRESS\"\n  | \"REJECTED\"\n  | \"TIMEOUT\"\n  | \"RENDER_ERROR\"\n  | \"CONFIG_ERROR\"\n  | \"UNKNOWN\";\n\n/**\n * Mail event callbacks (per-mail)\n * For global events, use mailEvents.on() from events.ts\n */\nexport type MailEvents = {\n  /**\n   * Called before sending the email\n   * Can be used to modify the mail or cancel sending\n   */\n  beforeSending?: (mail: MailOptions) => void | Promise<void> | false | Promise<false>;\n  /**\n   * Called after send attempt (success or failure)\n   */\n  onSent?: (\n    mail: MailOptions,\n    result: MailResult | null,\n    error: MailError | null,\n  ) => void | Promise<void>;\n  /**\n   * Called only on successful send\n   */\n  onSuccess?: (mail: MailOptions, result: MailResult) => void | Promise<void>;\n  /**\n   * Called only on error\n   */\n  onError?: (mail: MailOptions, error: MailError) => void | Promise<void>;\n};\n\n/**\n * Mail options for sending\n */\nexport type MailOptions = {\n  /**\n   * Unique mail ID for event namespacing\n   * If not provided, one will be auto-generated\n   *\n   * Use this to subscribe to events for a specific mail:\n   * ```typescript\n   * const mailId = generateMailId();\n   * mailEvents.onMailSuccess(mailId, (mail, result) => { ... });\n   * await sendMail({ id: mailId, to: \"...\", subject: \"...\", html: \"...\" });\n   * ```\n   */\n  id?: string;\n\n  // Recipients\n  to: string | string[];\n  cc?: string | string[];\n  bcc?: string | string[];\n  replyTo?: string;\n\n  // Content\n  subject: string;\n  html?: string;\n  text?: string;\n  component?: React.ReactElement;\n\n  // Configuration\n  config?: MailConfigurations;\n  mailer?: string;\n  from?: MailAddress;\n\n  // Attachments\n  attachments?: MailAttachment[];\n\n  // Options\n  priority?: MailPriority;\n  headers?: Record<string, string>;\n  tags?: string[];\n\n  // Meta\n  correlationId?: string;\n} & MailEvents;\n\n/**\n * Internal normalized mail data\n */\nexport type NormalizedMail = {\n  to: string[];\n  cc: string[];\n  bcc: string[];\n  replyTo?: string;\n  from: MailAddress;\n  subject: string;\n  html?: string;\n  text?: string;\n  attachments: MailAttachment[];\n  priority: MailPriority;\n  headers: Record<string, string>;\n  tags: string[];\n  correlationId?: string;\n  config: MailConfigurations;\n};\n\n/**\n * Captured mail for test mode\n */\nexport type CapturedMail = {\n  options: MailOptions;\n  normalized: NormalizedMail;\n  timestamp: Date;\n  result?: MailResult;\n  error?: MailError;\n};\n\n/**\n * Mail error class\n */\nexport class MailError extends Error {\n  public readonly code: MailErrorCode;\n  public readonly originalError?: Error;\n\n  public constructor(message: string, code: MailErrorCode, originalError?: Error) {\n    super(message);\n    this.name = \"MailError\";\n    this.code = code;\n    this.originalError = originalError;\n  }\n}\n"],"mappings":";;;;AA8SA,IAAa,YAAb,cAA+B,MAAM;CAInC,AAAO,YAAY,SAAiB,MAAqB,eAAuB;EAC9E,MAAM,OAAO;EACb,KAAK,OAAO;EACZ,KAAK,OAAO;EACZ,KAAK,gBAAgB;CACvB;AACF"}
+{"version":3,"file":"types.mjs","names":[],"sources":["../../../../../../../@warlock.js/core/src/mail/types.ts"],"sourcesContent":["import type SMTPTransport from \"nodemailer/lib/smtp-transport\";\nimport type React from \"react\";\n\n/**\n * AWS SES mail configuration\n */\nexport type SESConfigurations = {\n  driver: \"ses\";\n  accessKeyId: string;\n  secretAccessKey: string;\n  region: string;\n  from?: MailAddress;\n};\n\n/**\n * Any mail configuration (SMTP or SES)\n */\nexport type MailConfigurations = SMTPConfigurations | SESConfigurations;\n\n/**\n * Mail mode determines how emails are handled\n */\nexport type MailMode = \"production\" | \"development\" | \"test\";\n\n/**\n * Mail priority levels\n */\nexport type MailPriority = \"high\" | \"normal\" | \"low\";\n\n/**\n * Email address with optional name\n */\nexport type MailAddress =\n  | string\n  | {\n      name: string;\n      address: string;\n    };\n\n/**\n * Mail attachment\n * Supports both buffer/string content and file paths\n */\nexport type MailAttachment = {\n  filename: string;\n  contentType?: string;\n  encoding?: \"base64\" | \"binary\" | \"hex\";\n  cid?: string; // Content-ID for inline attachments\n} & (\n  | {\n      content: Buffer | string;\n      path?: never;\n    }\n  | {\n      content?: never;\n      path: string; // File path - will be read automatically\n    }\n);\n\n/**\n * Mail configuration for SMTP transport\n *\n * ## Basic Configuration\n *\n * ```typescript\n * setMailConfigurations({\n *   host: \"smtp.gmail.com\",\n *   port: 587,\n *   secure: false,           // true for 465, false for other ports\n *   tls: true,               // Use STARTTLS\n *   username: \"user@gmail.com\",\n *   password: \"app-password\",\n *   from: { name: \"My App\", address: \"noreply@myapp.com\" },\n * });\n * ```\n *\n * ## Configuration Options\n *\n * | Option | Type | Default | Description |\n * |--------|------|---------|-------------|\n * | `host` | `string` | - | SMTP server hostname (e.g., \"smtp.gmail.com\") |\n * | `port` | `number` | 587 | SMTP port. Common: 25, 465 (SSL), 587 (TLS) |\n * | `secure` | `boolean` | false | Use SSL/TLS. Set `true` for port 465 |\n * | `tls` | `boolean` | true | Enable STARTTLS upgrade. For port 587 |\n * | `requireTLS` | `boolean` | - | Fail if STARTTLS upgrade fails |\n * | `username` | `string` | - | SMTP auth username (convenience alias) |\n * | `password` | `string` | - | SMTP auth password (convenience alias) |\n * | `auth` | `object` | - | Full auth object: `{ user, pass, type }` |\n * | `from` | `MailAddress` | - | Default sender for all emails |\n *\n * ## Provider Examples\n *\n * ### Gmail\n * ```typescript\n * { host: \"smtp.gmail.com\", port: 587, tls: true, username: \"...\", password: \"...\" }\n * ```\n *\n * ### SendGrid\n * ```typescript\n * { host: \"smtp.sendgrid.net\", port: 587, username: \"apikey\", password: \"SG.xxx\" }\n * ```\n *\n * ### AWS SES\n * ```typescript\n * { host: \"email-smtp.us-east-1.amazonaws.com\", port: 587, username: \"...\", password: \"...\" }\n * ```\n *\n * ### Mailgun\n * ```typescript\n * { host: \"smtp.mailgun.org\", port: 587, username: \"postmaster@...\", password: \"...\" }\n * ```\n *\n * ## Multi-tenant Usage\n *\n * For multi-tenant apps, pass config per-mail instead of globally:\n * ```typescript\n * await sendMail({\n *   config: tenant.mailSettings,  // Tenant-specific config\n *   to: \"user@example.com\",\n *   subject: \"Hello\",\n *   html: \"<p>World</p>\",\n * });\n * ```\n */\nexport type SMTPConfigurations = SMTPTransport.Options & {\n  /**\n   * Transport driver type\n   */\n  driver?: \"smtp\";\n  /**\n   * Enable STARTTLS upgrade (alias for requireTLS)\n   * Set to `true` for port 587\n   */\n  tls?: boolean;\n  /**\n   * SMTP authentication username\n   * Convenience alias - can also use `auth.user`\n   */\n  username?: string;\n  /**\n   * SMTP authentication password\n   * Convenience alias - can also use `auth.pass`\n   */\n  password?: string;\n  /**\n   * Default sender for all emails\n   * Can be string (\"noreply@app.com\") or object ({ name, address })\n   */\n  from?: MailAddress;\n};\n\n/**\n * Named mailers configuration\n */\nexport type MailersConfig = {\n  /**\n   * Default mailer configuration\n   */\n  default?: MailConfigurations;\n  /**\n   * Named mailer configurations\n   */\n  mailers?: Record<string, MailConfigurations>;\n};\n\n/**\n * Mail result after sending\n */\nexport type MailResult = {\n  success: boolean;\n  messageId?: string;\n  accepted: string[];\n  rejected: string[];\n  response?: string;\n  envelope?: {\n    from: string;\n    to: string[];\n  };\n};\n\n/**\n * Error codes for mail operations\n */\nexport type MailErrorCode =\n  | \"CONNECTION_ERROR\"\n  | \"AUTH_ERROR\"\n  | \"RATE_LIMIT\"\n  | \"INVALID_ADDRESS\"\n  | \"REJECTED\"\n  | \"TIMEOUT\"\n  | \"RENDER_ERROR\"\n  | \"CONFIG_ERROR\"\n  | \"UNKNOWN\";\n\n/**\n * Mail event callbacks (per-mail)\n * For global events, use mailEvents.on() from events.ts\n */\nexport type MailEvents = {\n  /**\n   * Called before sending the email\n   * Can be used to modify the mail or cancel sending\n   */\n  beforeSending?: (mail: MailOptions) => void | Promise<void> | false | Promise<false>;\n  /**\n   * Called after send attempt (success or failure)\n   */\n  onSent?: (\n    mail: MailOptions,\n    result: MailResult | null,\n    error: MailError | null,\n  ) => void | Promise<void>;\n  /**\n   * Called only on successful send\n   */\n  onSuccess?: (mail: MailOptions, result: MailResult) => void | Promise<void>;\n  /**\n   * Called only on error\n   */\n  onError?: (mail: MailOptions, error: MailError) => void | Promise<void>;\n};\n\n/**\n * Mail options for sending\n */\nexport type MailOptions = {\n  /**\n   * Unique mail ID for event namespacing\n   * If not provided, one will be auto-generated\n   *\n   * Use this to subscribe to events for a specific mail:\n   * ```typescript\n   * const mailId = generateMailId();\n   * mailEvents.onMailSuccess(mailId, (mail, result) => { ... });\n   * await sendMail({ id: mailId, to: \"...\", subject: \"...\", html: \"...\" });\n   * ```\n   */\n  id?: string;\n\n  // Recipients\n  to: string | string[];\n  cc?: string | string[];\n  bcc?: string | string[];\n  replyTo?: string;\n\n  // Content\n  subject: string;\n  html?: string;\n  text?: string;\n  component?: React.ReactElement;\n\n  // Configuration\n  config?: MailConfigurations;\n  mailer?: string;\n  from?: MailAddress;\n\n  // Attachments\n  attachments?: MailAttachment[];\n\n  // Options\n  priority?: MailPriority;\n  headers?: Record<string, string>;\n  tags?: string[];\n\n  // Meta\n  correlationId?: string;\n} & MailEvents;\n\n/**\n * Internal normalized mail data\n */\nexport type NormalizedMail = {\n  to: string[];\n  cc: string[];\n  bcc: string[];\n  replyTo?: string;\n  from: MailAddress;\n  subject: string;\n  html?: string;\n  text?: string;\n  attachments: MailAttachment[];\n  priority: MailPriority;\n  headers: Record<string, string>;\n  tags: string[];\n  correlationId?: string;\n  config: MailConfigurations;\n};\n\n/**\n * Captured mail for test mode\n */\nexport type CapturedMail = {\n  options: MailOptions;\n  normalized: NormalizedMail;\n  timestamp: Date;\n  result?: MailResult;\n  error?: MailError;\n};\n\n/**\n * Mail error class\n */\nexport class MailError extends Error {\n  public readonly code: MailErrorCode;\n  public readonly originalError?: Error;\n\n  public constructor(message: string, code: MailErrorCode, originalError?: Error) {\n    super(message);\n    this.name = \"MailError\";\n    this.code = code;\n    this.originalError = originalError;\n  }\n}\n"],"mappings":";;;;AA8SA,IAAa,YAAb,cAA+B,MAAM;CAInC,AAAO,YAAY,SAAiB,MAAqB,eAAuB;EAC9E,MAAM,OAAO;EACb,KAAK,OAAO;EACZ,KAAK,OAAO;EACZ,KAAK,gBAAgB;CACvB;AACF"}

package/esm/react/index.d.mts

@@ -1,6 +1,6 @@
 import { ComponentType, ReactElement, ReactNode } from "react";
 
-//#region ../../@warlock.js/core/src/react/index.d.ts
+//#region ../@warlock.js/core/src/react/index.d.ts
 /**
  * Render a React element/component to HTML string
  *

package/esm/react/index.d.mts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.mts","names":[],"sources":["../../../../../../@warlock.js/core/src/react/index.ts"],"mappings":";;;;;AAgEA;;;;;;;;;iBAAgB,WAAA,CAAY,YAAA,EAAc,YAAA,GAAe,aAAA,GAAgB,SAAA"}
+{"version":3,"file":"index.d.mts","names":[],"sources":["../../../../../../../@warlock.js/core/src/react/index.ts"],"mappings":";;;;;AAgEA;;;;;;;;;iBAAgB,WAAA,CAAY,YAAA,EAAc,YAAA,GAAe,aAAA,GAAgB,SAAA"}

package/esm/react/index.mjs

@@ -1,4 +1,4 @@
-//#region ../../@warlock.js/core/src/react/index.ts
+//#region ../@warlock.js/core/src/react/index.ts
 /**
 * Installation instructions for React
 */

package/esm/react/index.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"index.mjs","names":[],"sources":["../../../../../../@warlock.js/core/src/react/index.ts"],"sourcesContent":["import type { ComponentType, ReactElement, ReactNode } from \"react\";\n\n// ============================================================\n// Eager-loaded React Modules\n// ============================================================\n\n/**\n * Installation instructions for React\n */\nconst REACT_INSTALL_INSTRUCTIONS = `\nReact SSR functionality requires React packages.\nInstall them with:\n\n  warlock add react\n\nOr manually:\n\n  npm install react react-dom\n  pnpm add react react-dom\n  yarn add react react-dom\n`.trim();\n\n/**\n * Module availability flag\n */\nlet moduleExists: boolean | null = null;\n\n/**\n * Cached React modules (loaded at import time)\n */\nlet react: typeof import(\"react\");\nlet reactDomServer: typeof import(\"react-dom/server\");\n\n/**\n * Eagerly load React modules at import time\n */\nasync function loadReactModules() {\n  try {\n    react = await import(\"react\");\n    reactDomServer = await import(\"react-dom/server\");\n    moduleExists = true;\n  } catch {\n    moduleExists = false;\n  }\n}\n\n// Kick off eager loading immediately\nloadReactModules();\n\n// ============================================================\n// Render Function\n// ============================================================\n\n/**\n * Render a React element/component to HTML string\n *\n * **Important:** This function requires React packages to be installed.\n * Install them with: `warlock add react` or `yarn add react react-dom`\n *\n * @example\n * ```typescript\n * const html = renderReact(<WelcomeEmail name=\"John\" />);\n * ```\n */\nexport function renderReact(reactElement: ReactElement | ComponentType | ReactNode): string {\n  if (moduleExists === false) {\n    throw new Error(`react is not installed.\\n\\n${REACT_INSTALL_INSTRUCTIONS}`);\n  }\n\n  if (typeof reactElement === \"function\") {\n    reactElement = react.createElement(reactElement);\n  }\n\n  return reactDomServer.renderToString(reactElement);\n}\n"],"mappings":";;;;AASA,MAAM,6BAA6B;;;;;;;;;;;EAWjC,KAAK;;;;AAKP,IAAI,eAA+B;;;;AAKnC,IAAI;AACJ,IAAI;;;;AAKJ,eAAe,mBAAmB;CAChC,IAAI;EACF,QAAQ,MAAM,OAAO;EACrB,iBAAiB,MAAM,OAAO;EAC9B,eAAe;CACjB,QAAQ;EACN,eAAe;CACjB;AACF;AAGA,iBAAiB;;;;;;;;;;;;AAiBjB,SAAgB,YAAY,cAAgE;CAC1F,IAAI,iBAAiB,OACnB,MAAM,IAAI,MAAM,8BAA8B,4BAA4B;CAG5E,IAAI,OAAO,iBAAiB,YAC1B,eAAe,MAAM,cAAc,YAAY;CAGjD,OAAO,eAAe,eAAe,YAAY;AACnD"}
+{"version":3,"file":"index.mjs","names":[],"sources":["../../../../../../../@warlock.js/core/src/react/index.ts"],"sourcesContent":["import type { ComponentType, ReactElement, ReactNode } from \"react\";\n\n// ============================================================\n// Eager-loaded React Modules\n// ============================================================\n\n/**\n * Installation instructions for React\n */\nconst REACT_INSTALL_INSTRUCTIONS = `\nReact SSR functionality requires React packages.\nInstall them with:\n\n  warlock add react\n\nOr manually:\n\n  npm install react react-dom\n  pnpm add react react-dom\n  yarn add react react-dom\n`.trim();\n\n/**\n * Module availability flag\n */\nlet moduleExists: boolean | null = null;\n\n/**\n * Cached React modules (loaded at import time)\n */\nlet react: typeof import(\"react\");\nlet reactDomServer: typeof import(\"react-dom/server\");\n\n/**\n * Eagerly load React modules at import time\n */\nasync function loadReactModules() {\n  try {\n    react = await import(\"react\");\n    reactDomServer = await import(\"react-dom/server\");\n    moduleExists = true;\n  } catch {\n    moduleExists = false;\n  }\n}\n\n// Kick off eager loading immediately\nloadReactModules();\n\n// ============================================================\n// Render Function\n// ============================================================\n\n/**\n * Render a React element/component to HTML string\n *\n * **Important:** This function requires React packages to be installed.\n * Install them with: `warlock add react` or `yarn add react react-dom`\n *\n * @example\n * ```typescript\n * const html = renderReact(<WelcomeEmail name=\"John\" />);\n * ```\n */\nexport function renderReact(reactElement: ReactElement | ComponentType | ReactNode): string {\n  if (moduleExists === false) {\n    throw new Error(`react is not installed.\\n\\n${REACT_INSTALL_INSTRUCTIONS}`);\n  }\n\n  if (typeof reactElement === \"function\") {\n    reactElement = react.createElement(reactElement);\n  }\n\n  return reactDomServer.renderToString(reactElement);\n}\n"],"mappings":";;;;AASA,MAAM,6BAA6B;;;;;;;;;;;EAWjC,KAAK;;;;AAKP,IAAI,eAA+B;;;;AAKnC,IAAI;AACJ,IAAI;;;;AAKJ,eAAe,mBAAmB;CAChC,IAAI;EACF,QAAQ,MAAM,OAAO;EACrB,iBAAiB,MAAM,OAAO;EAC9B,eAAe;CACjB,QAAQ;EACN,eAAe;CACjB;AACF;AAGA,iBAAiB;;;;;;;;;;;;AAiBjB,SAAgB,YAAY,cAAgE;CAC1F,IAAI,iBAAiB,OACnB,MAAM,IAAI,MAAM,8BAA8B,4BAA4B;CAG5E,IAAI,OAAO,iBAAiB,YAC1B,eAAe,MAAM,cAAc,YAAY;CAGjD,OAAO,eAAe,eAAe,YAAY;AACnD"}

package/esm/repositories/adapters/cascade/cascade-adapter.d.mts

@@ -3,7 +3,7 @@ import { ChunkCallback, CursorPaginationOptions, CursorPaginationResult, Paginat
 import { QueryBuilderContract as QueryBuilderContract$1 } from "../../contracts/query-builder.contract.mjs";
 import { ChildModel, Model } from "@warlock.js/cascade";
 
-//#region ../../@warlock.js/core/src/repositories/adapters/cascade/cascade-adapter.d.ts
+//#region ../@warlock.js/core/src/repositories/adapters/cascade/cascade-adapter.d.ts
 /**
  * Cascade adapter for Cascade-Next ORM
  * Implements RepositoryAdapterContract for @warlock.js/cascade

package/esm/repositories/adapters/cascade/cascade-adapter.d.mts.map

@@ -1 +1 @@
-{"version":3,"file":"cascade-adapter.d.mts","names":[],"sources":["../../../../../../../../@warlock.js/core/src/repositories/adapters/cascade/cascade-adapter.ts"],"mappings":";;;;;;;;;;;AAiBA;cAAa,cAAA,WAAyB,KAAA,kBAAuB,yBAAA,CAA0B,CAAA;EAAA,QAK1D,KAAA;EALS;;;;cAKT,KAAA,EAAO,UAAA,CAAW,CAAA;EAS7B;;;EAAT,KAAA,CAAA,GAAS,sBAAA,CAAqB,CAAA;EAyCY;;;EAlC1C,cAAA,CAAe,cAAA;EA8DU;;;EAnCnB,IAAA,CAAK,EAAA,QAAU,OAAA,CAAQ,CAAA;EAkEa;;;EA3DpC,MAAA,CAAO,MAAA,UAAgB,KAAA,QAAa,OAAA,CAAQ,CAAA;EA4HG;;;EArHrD,cAAA,CAAe,KAAA,EAAO,CAAA;EA8HlB;;;EAvHJ,gBAAA,CAAiB,IAAA,QAAY,CAAA;EAkI0B;;;EA3HvD,qBAAA,CAAA;EA5E6E;;;EAmFvE,MAAA,CAAO,IAAA,QAAY,OAAA,CAAQ,CAAA;EAnF6C;;;EA0FxE,MAAA,CAAO,EAAA,OAAS,IAAA,QAAY,OAAA,CAAQ,CAAA;EArFJ;;;EAkGhC,MAAA,CAAO,EAAA,QAAU,OAAA;EAzFO;;;EAoGxB,UAAA,CAAW,MAAA,OAAa,IAAA,QAAY,OAAA;EAlE/B;;;EAwFL,UAAA,CAAW,MAAA,QAAc,OAAA;EAjFlB;;;EA2GP,KAAA,CAAM,MAAA,SAAe,OAAA;EApG3B;;;EAqHM,QAAA,CAAS,IAAA,UAAc,KAAA,WAAgB,OAAA,CAAQ,gBAAA,CAAiB,CAAA;EA9GrD;;;EAqHX,cAAA,CACX,OAAA,EAAS,uBAAA,GACR,OAAA,CAAQ,sBAAA,CAAuB,CAAA;EAzGd;;;EAoHP,KAAA,CAAM,IAAA,UAAc,QAAA,EAAU,aAAA,CAAc,CAAA,IAAK,OAAA;EA7G1C;;;EAwHb,WAAA,CAAY,IAAA,QAAY,CAAA;AAAA"}
+{"version":3,"file":"cascade-adapter.d.mts","names":[],"sources":["../../../../../../../../../@warlock.js/core/src/repositories/adapters/cascade/cascade-adapter.ts"],"mappings":";;;;;;;;;;;AAiBA;cAAa,cAAA,WAAyB,KAAA,kBAAuB,yBAAA,CAA0B,CAAA;EAAA,QAK1D,KAAA;EALS;;;;cAKT,KAAA,EAAO,UAAA,CAAW,CAAA;EAS7B;;;EAAT,KAAA,IAAS,sBAAA,CAAqB,CAAA;EAyCY;;;EAlC1C,cAAA,CAAe,cAAA;EA8DU;;;EAnCnB,IAAA,CAAK,EAAA,QAAU,OAAA,CAAQ,CAAA;EAkEa;;;EA3DpC,MAAA,CAAO,MAAA,UAAgB,KAAA,QAAa,OAAA,CAAQ,CAAA;EA4HG;;;EArHrD,cAAA,CAAe,KAAA,EAAO,CAAA;EA8HlB;;;EAvHJ,gBAAA,CAAiB,IAAA,QAAY,CAAA;EAkI0B;;;EA3HvD,qBAAA;EA5E6E;;;EAmFvE,MAAA,CAAO,IAAA,QAAY,OAAA,CAAQ,CAAA;EAnF6C;;;EA0FxE,MAAA,CAAO,EAAA,OAAS,IAAA,QAAY,OAAA,CAAQ,CAAA;EArFJ;;;EAkGhC,MAAA,CAAO,EAAA,QAAU,OAAA;EAzFO;;;EAoGxB,UAAA,CAAW,MAAA,OAAa,IAAA,QAAY,OAAA;EAlE/B;;;EAwFL,UAAA,CAAW,MAAA,QAAc,OAAA;EAjFlB;;;EA2GP,KAAA,CAAM,MAAA,SAAe,OAAA;EApG3B;;;EAqHM,QAAA,CAAS,IAAA,UAAc,KAAA,WAAgB,OAAA,CAAQ,gBAAA,CAAiB,CAAA;EA9GrD;;;EAqHX,cAAA,CACX,OAAA,EAAS,uBAAA,GACR,OAAA,CAAQ,sBAAA,CAAuB,CAAA;EAzGd;;;EAoHP,KAAA,CAAM,IAAA,UAAc,QAAA,EAAU,aAAA,CAAc,CAAA,IAAK,OAAA;EA7G1C;;;EAwHb,WAAA,CAAY,IAAA,QAAY,CAAA;AAAA"}

package/esm/repositories/adapters/cascade/cascade-adapter.mjs

@@ -1,7 +1,7 @@
 import { CascadeQueryBuilder } from "./cascade-query-builder.mjs";
 import { Model } from "@warlock.js/cascade";
 
-//#region ../../@warlock.js/core/src/repositories/adapters/cascade/cascade-adapter.ts
+//#region ../@warlock.js/core/src/repositories/adapters/cascade/cascade-adapter.ts
 /**
 * Cascade adapter for Cascade-Next ORM
 * Implements RepositoryAdapterContract for @warlock.js/cascade

package/esm/repositories/adapters/cascade/cascade-adapter.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"cascade-adapter.mjs","names":[],"sources":["../../../../../../../../@warlock.js/core/src/repositories/adapters/cascade/cascade-adapter.ts"],"sourcesContent":["import { type ChildModel, Model } from \"@warlock.js/cascade\";\nimport type {\n  ChunkCallback,\n  CursorPaginationOptions,\n  CursorPaginationResult,\n  PaginationResult,\n  QueryBuilderContract,\n  RepositoryAdapterContract,\n} from \"../../contracts\";\nimport { CascadeQueryBuilder } from \"./cascade-query-builder\";\n\n/**\n * Cascade adapter for Cascade-Next ORM\n * Implements RepositoryAdapterContract for @warlock.js/cascade\n *\n * @template T - The model instance type\n */\nexport class CascadeAdapter<T extends Model<any>> implements RepositoryAdapterContract<T> {\n  /**\n   * Constructor\n   * @param model - Cascade-Next Model class\n   */\n  public constructor(private model: ChildModel<T>) {}\n\n  // ============================================================================\n  // QUERY BUILDING\n  // ============================================================================\n\n  /**\n   * {@inheritDoc RepositoryAdapterContract.query}\n   */\n  public query(): QueryBuilderContract<T> {\n    return new CascadeQueryBuilder<T>(this.model.query());\n  }\n\n  /**\n   * Register all events\n   */\n  public registerEvents(eventsCallback: any): any[] {\n    const events: any[] = [];\n\n    const modelEvents = this.model.events();\n\n    events.push(\n      modelEvents.onCreated((model) => {\n        eventsCallback(model);\n      }),\n      modelEvents.onUpdated((model) => {\n        eventsCallback(model);\n      }),\n      modelEvents.onDeleted((model) => {\n        eventsCallback(model);\n      }),\n    );\n\n    return events;\n  }\n\n  // ============================================================================\n  // CRUD OPERATIONS\n  // ============================================================================\n\n  /**\n   * {@inheritDoc RepositoryAdapterContract.find}\n   */\n  public async find(id: any): Promise<T | null> {\n    return await this.model.find(id);\n  }\n\n  /**\n   * {@inheritDoc RepositoryAdapterContract.findBy}\n   */\n  public async findBy(column: string, value: any): Promise<T | null> {\n    return (await this.query().where(column, value).first()) as T | null;\n  }\n\n  /**\n   * {@inheritDoc RepositoryAdapterContract.serializeModel}\n   */\n  public serializeModel(model: T): any {\n    return model.toSnapshot();\n  }\n\n  /**\n   * {@inheritDoc RepositoryAdapterContract.deserializeModel}\n   */\n  public deserializeModel(data: any): T {\n    return this.model.fromSnapshot(data);\n  }\n\n  /**\n   * {@inheritDoc RepositoryAdapterContract.resolveRepositoryName}\n   */\n  public resolveRepositoryName(): string {\n    return this.model.table;\n  }\n\n  /**\n   * {@inheritDoc RepositoryAdapterContract.create}\n   */\n  public async create(data: any): Promise<T> {\n    return this.model.create(data);\n  }\n\n  /**\n   * {@inheritDoc RepositoryAdapterContract.update}\n   */\n  public async update(id: any, data: any): Promise<T> {\n    const model = id instanceof Model ? id : await this.model.find(id);\n    if (!model) {\n      throw new Error(`Model not found with id ${id}`);\n    }\n\n    await model.save({ merge: data });\n    return model as T;\n  }\n\n  /**\n   * {@inheritDoc RepositoryAdapterContract.delete}\n   */\n  public async delete(id: any): Promise<void> {\n    await this.model.delete({ id });\n  }\n\n  // ============================================================================\n  // BULK OPERATIONS\n  // ============================================================================\n\n  /**\n   * {@inheritDoc RepositoryAdapterContract.updateMany}\n   */\n  public async updateMany(filter: any, data: any): Promise<number> {\n    const query = this.query();\n\n    // Apply filter\n    if (typeof filter === \"object\") {\n      query.where(filter);\n    }\n\n    // Get matching records\n    const records = await query.get();\n\n    // Update each record\n    for (const record of records) {\n      await this.update(record.id, data);\n    }\n\n    return records.length;\n  }\n\n  /**\n   * {@inheritDoc RepositoryAdapterContract.deleteMany}\n   */\n  public async deleteMany(filter: any): Promise<number> {\n    const query = this.query();\n\n    // Apply filter\n    if (typeof filter === \"object\") {\n      query.where(filter);\n    }\n\n    // Get matching records\n    const records = await query.get();\n\n    // Delete each record\n    for (const record of records) {\n      await record.destroy();\n    }\n\n    return records.length;\n  }\n\n  // ============================================================================\n  // COUNTING\n  // ============================================================================\n\n  /**\n   * {@inheritDoc RepositoryAdapterContract.count}\n   */\n  public async count(filter?: any): Promise<number> {\n    const query = this.query();\n\n    if (filter && typeof filter === \"object\") {\n      query.where(filter);\n    }\n\n    return query.count();\n  }\n\n  // ============================================================================\n  // PAGINATION\n  // ============================================================================\n\n  /**\n   * {@inheritDoc RepositoryAdapterContract.paginate}\n   */\n  public async paginate(page: number, limit: number): Promise<PaginationResult<T>> {\n    return this.query().paginate(page, limit);\n  }\n\n  /**\n   * {@inheritDoc RepositoryAdapterContract.cursorPaginate}\n   */\n  public async cursorPaginate(\n    options: CursorPaginationOptions,\n  ): Promise<CursorPaginationResult<T>> {\n    return this.query().cursorPaginate(options);\n  }\n\n  // ============================================================================\n  // CHUNKING\n  // ============================================================================\n\n  /**\n   * {@inheritDoc RepositoryAdapterContract.chunk}\n   */\n  public async chunk(size: number, callback: ChunkCallback<T>): Promise<void> {\n    return this.query().chunk(size, callback);\n  }\n\n  // ============================================================================\n  // MODEL CREATION\n  // ============================================================================\n\n  /**\n   * {@inheritDoc RepositoryAdapterContract.createModel}\n   */\n  public createModel(data: any): T {\n    return new (this.model as any)(data) as T;\n  }\n}\n"],"mappings":";;;;;;;;;;AAiBA,IAAa,iBAAb,MAA0F;;;;;CAKxF,AAAO,YAAY,AAAQ,OAAsB;EAAtB;CAAuB;;;;CASlD,AAAO,QAAiC;EACtC,OAAO,IAAI,oBAAuB,KAAK,MAAM,MAAM,CAAC;CACtD;;;;CAKA,AAAO,eAAe,gBAA4B;EAChD,MAAM,SAAgB,CAAC;EAEvB,MAAM,cAAc,KAAK,MAAM,OAAO;EAEtC,OAAO,KACL,YAAY,WAAW,UAAU;GAC/B,eAAe,KAAK;EACtB,CAAC,GACD,YAAY,WAAW,UAAU;GAC/B,eAAe,KAAK;EACtB,CAAC,GACD,YAAY,WAAW,UAAU;GAC/B,eAAe,KAAK;EACtB,CAAC,CACH;EAEA,OAAO;CACT;;;;CASA,MAAa,KAAK,IAA4B;EAC5C,OAAO,MAAM,KAAK,MAAM,KAAK,EAAE;CACjC;;;;CAKA,MAAa,OAAO,QAAgB,OAA+B;EACjE,OAAQ,MAAM,KAAK,MAAM,EAAE,MAAM,QAAQ,KAAK,EAAE,MAAM;CACxD;;;;CAKA,AAAO,eAAe,OAAe;EACnC,OAAO,MAAM,WAAW;CAC1B;;;;CAKA,AAAO,iBAAiB,MAAc;EACpC,OAAO,KAAK,MAAM,aAAa,IAAI;CACrC;;;;CAKA,AAAO,wBAAgC;EACrC,OAAO,KAAK,MAAM;CACpB;;;;CAKA,MAAa,OAAO,MAAuB;EACzC,OAAO,KAAK,MAAM,OAAO,IAAI;CAC/B;;;;CAKA,MAAa,OAAO,IAAS,MAAuB;EAClD,MAAM,QAAQ,cAAc,QAAQ,KAAK,MAAM,KAAK,MAAM,KAAK,EAAE;EACjE,IAAI,CAAC,OACH,MAAM,IAAI,MAAM,2BAA2B,IAAI;EAGjD,MAAM,MAAM,KAAK,EAAE,OAAO,KAAK,CAAC;EAChC,OAAO;CACT;;;;CAKA,MAAa,OAAO,IAAwB;EAC1C,MAAM,KAAK,MAAM,OAAO,EAAE,GAAG,CAAC;CAChC;;;;CASA,MAAa,WAAW,QAAa,MAA4B;EAC/D,MAAM,QAAQ,KAAK,MAAM;EAGzB,IAAI,OAAO,WAAW,UACpB,MAAM,MAAM,MAAM;EAIpB,MAAM,UAAU,MAAM,MAAM,IAAI;EAGhC,KAAK,MAAM,UAAU,SACnB,MAAM,KAAK,OAAO,OAAO,IAAI,IAAI;EAGnC,OAAO,QAAQ;CACjB;;;;CAKA,MAAa,WAAW,QAA8B;EACpD,MAAM,QAAQ,KAAK,MAAM;EAGzB,IAAI,OAAO,WAAW,UACpB,MAAM,MAAM,MAAM;EAIpB,MAAM,UAAU,MAAM,MAAM,IAAI;EAGhC,KAAK,MAAM,UAAU,SACnB,MAAM,OAAO,QAAQ;EAGvB,OAAO,QAAQ;CACjB;;;;CASA,MAAa,MAAM,QAA+B;EAChD,MAAM,QAAQ,KAAK,MAAM;EAEzB,IAAI,UAAU,OAAO,WAAW,UAC9B,MAAM,MAAM,MAAM;EAGpB,OAAO,MAAM,MAAM;CACrB;;;;CASA,MAAa,SAAS,MAAc,OAA6C;EAC/E,OAAO,KAAK,MAAM,EAAE,SAAS,MAAM,KAAK;CAC1C;;;;CAKA,MAAa,eACX,SACoC;EACpC,OAAO,KAAK,MAAM,EAAE,eAAe,OAAO;CAC5C;;;;CASA,MAAa,MAAM,MAAc,UAA2C;EAC1E,OAAO,KAAK,MAAM,EAAE,MAAM,MAAM,QAAQ;CAC1C;;;;CASA,AAAO,YAAY,MAAc;EAC/B,OAAO,IAAK,KAAK,MAAc,IAAI;CACrC;AACF"}
+{"version":3,"file":"cascade-adapter.mjs","names":[],"sources":["../../../../../../../../../@warlock.js/core/src/repositories/adapters/cascade/cascade-adapter.ts"],"sourcesContent":["import { type ChildModel, Model } from \"@warlock.js/cascade\";\nimport type {\n  ChunkCallback,\n  CursorPaginationOptions,\n  CursorPaginationResult,\n  PaginationResult,\n  QueryBuilderContract,\n  RepositoryAdapterContract,\n} from \"../../contracts\";\nimport { CascadeQueryBuilder } from \"./cascade-query-builder\";\n\n/**\n * Cascade adapter for Cascade-Next ORM\n * Implements RepositoryAdapterContract for @warlock.js/cascade\n *\n * @template T - The model instance type\n */\nexport class CascadeAdapter<T extends Model<any>> implements RepositoryAdapterContract<T> {\n  /**\n   * Constructor\n   * @param model - Cascade-Next Model class\n   */\n  public constructor(private model: ChildModel<T>) {}\n\n  // ============================================================================\n  // QUERY BUILDING\n  // ============================================================================\n\n  /**\n   * {@inheritDoc RepositoryAdapterContract.query}\n   */\n  public query(): QueryBuilderContract<T> {\n    return new CascadeQueryBuilder<T>(this.model.query());\n  }\n\n  /**\n   * Register all events\n   */\n  public registerEvents(eventsCallback: any): any[] {\n    const events: any[] = [];\n\n    const modelEvents = this.model.events();\n\n    events.push(\n      modelEvents.onCreated((model) => {\n        eventsCallback(model);\n      }),\n      modelEvents.onUpdated((model) => {\n        eventsCallback(model);\n      }),\n      modelEvents.onDeleted((model) => {\n        eventsCallback(model);\n      }),\n    );\n\n    return events;\n  }\n\n  // ============================================================================\n  // CRUD OPERATIONS\n  // ============================================================================\n\n  /**\n   * {@inheritDoc RepositoryAdapterContract.find}\n   */\n  public async find(id: any): Promise<T | null> {\n    return await this.model.find(id);\n  }\n\n  /**\n   * {@inheritDoc RepositoryAdapterContract.findBy}\n   */\n  public async findBy(column: string, value: any): Promise<T | null> {\n    return (await this.query().where(column, value).first()) as T | null;\n  }\n\n  /**\n   * {@inheritDoc RepositoryAdapterContract.serializeModel}\n   */\n  public serializeModel(model: T): any {\n    return model.toSnapshot();\n  }\n\n  /**\n   * {@inheritDoc RepositoryAdapterContract.deserializeModel}\n   */\n  public deserializeModel(data: any): T {\n    return this.model.fromSnapshot(data);\n  }\n\n  /**\n   * {@inheritDoc RepositoryAdapterContract.resolveRepositoryName}\n   */\n  public resolveRepositoryName(): string {\n    return this.model.table;\n  }\n\n  /**\n   * {@inheritDoc RepositoryAdapterContract.create}\n   */\n  public async create(data: any): Promise<T> {\n    return this.model.create(data);\n  }\n\n  /**\n   * {@inheritDoc RepositoryAdapterContract.update}\n   */\n  public async update(id: any, data: any): Promise<T> {\n    const model = id instanceof Model ? id : await this.model.find(id);\n    if (!model) {\n      throw new Error(`Model not found with id ${id}`);\n    }\n\n    await model.save({ merge: data });\n    return model as T;\n  }\n\n  /**\n   * {@inheritDoc RepositoryAdapterContract.delete}\n   */\n  public async delete(id: any): Promise<void> {\n    await this.model.delete({ id });\n  }\n\n  // ============================================================================\n  // BULK OPERATIONS\n  // ============================================================================\n\n  /**\n   * {@inheritDoc RepositoryAdapterContract.updateMany}\n   */\n  public async updateMany(filter: any, data: any): Promise<number> {\n    const query = this.query();\n\n    // Apply filter\n    if (typeof filter === \"object\") {\n      query.where(filter);\n    }\n\n    // Get matching records\n    const records = await query.get();\n\n    // Update each record\n    for (const record of records) {\n      await this.update(record.id, data);\n    }\n\n    return records.length;\n  }\n\n  /**\n   * {@inheritDoc RepositoryAdapterContract.deleteMany}\n   */\n  public async deleteMany(filter: any): Promise<number> {\n    const query = this.query();\n\n    // Apply filter\n    if (typeof filter === \"object\") {\n      query.where(filter);\n    }\n\n    // Get matching records\n    const records = await query.get();\n\n    // Delete each record\n    for (const record of records) {\n      await record.destroy();\n    }\n\n    return records.length;\n  }\n\n  // ============================================================================\n  // COUNTING\n  // ============================================================================\n\n  /**\n   * {@inheritDoc RepositoryAdapterContract.count}\n   */\n  public async count(filter?: any): Promise<number> {\n    const query = this.query();\n\n    if (filter && typeof filter === \"object\") {\n      query.where(filter);\n    }\n\n    return query.count();\n  }\n\n  // ============================================================================\n  // PAGINATION\n  // ============================================================================\n\n  /**\n   * {@inheritDoc RepositoryAdapterContract.paginate}\n   */\n  public async paginate(page: number, limit: number): Promise<PaginationResult<T>> {\n    return this.query().paginate(page, limit);\n  }\n\n  /**\n   * {@inheritDoc RepositoryAdapterContract.cursorPaginate}\n   */\n  public async cursorPaginate(\n    options: CursorPaginationOptions,\n  ): Promise<CursorPaginationResult<T>> {\n    return this.query().cursorPaginate(options);\n  }\n\n  // ============================================================================\n  // CHUNKING\n  // ============================================================================\n\n  /**\n   * {@inheritDoc RepositoryAdapterContract.chunk}\n   */\n  public async chunk(size: number, callback: ChunkCallback<T>): Promise<void> {\n    return this.query().chunk(size, callback);\n  }\n\n  // ============================================================================\n  // MODEL CREATION\n  // ============================================================================\n\n  /**\n   * {@inheritDoc RepositoryAdapterContract.createModel}\n   */\n  public createModel(data: any): T {\n    return new (this.model as any)(data) as T;\n  }\n}\n"],"mappings":";;;;;;;;;;AAiBA,IAAa,iBAAb,MAA0F;;;;;CAKxF,AAAO,YAAY,AAAQ,OAAsB;EAAtB;CAAuB;;;;CASlD,AAAO,QAAiC;EACtC,OAAO,IAAI,oBAAuB,KAAK,MAAM,MAAM,CAAC;CACtD;;;;CAKA,AAAO,eAAe,gBAA4B;EAChD,MAAM,SAAgB,CAAC;EAEvB,MAAM,cAAc,KAAK,MAAM,OAAO;EAEtC,OAAO,KACL,YAAY,WAAW,UAAU;GAC/B,eAAe,KAAK;EACtB,CAAC,GACD,YAAY,WAAW,UAAU;GAC/B,eAAe,KAAK;EACtB,CAAC,GACD,YAAY,WAAW,UAAU;GAC/B,eAAe,KAAK;EACtB,CAAC,CACH;EAEA,OAAO;CACT;;;;CASA,MAAa,KAAK,IAA4B;EAC5C,OAAO,MAAM,KAAK,MAAM,KAAK,EAAE;CACjC;;;;CAKA,MAAa,OAAO,QAAgB,OAA+B;EACjE,OAAQ,MAAM,KAAK,MAAM,CAAC,CAAC,MAAM,QAAQ,KAAK,CAAC,CAAC,MAAM;CACxD;;;;CAKA,AAAO,eAAe,OAAe;EACnC,OAAO,MAAM,WAAW;CAC1B;;;;CAKA,AAAO,iBAAiB,MAAc;EACpC,OAAO,KAAK,MAAM,aAAa,IAAI;CACrC;;;;CAKA,AAAO,wBAAgC;EACrC,OAAO,KAAK,MAAM;CACpB;;;;CAKA,MAAa,OAAO,MAAuB;EACzC,OAAO,KAAK,MAAM,OAAO,IAAI;CAC/B;;;;CAKA,MAAa,OAAO,IAAS,MAAuB;EAClD,MAAM,QAAQ,cAAc,QAAQ,KAAK,MAAM,KAAK,MAAM,KAAK,EAAE;EACjE,IAAI,CAAC,OACH,MAAM,IAAI,MAAM,2BAA2B,IAAI;EAGjD,MAAM,MAAM,KAAK,EAAE,OAAO,KAAK,CAAC;EAChC,OAAO;CACT;;;;CAKA,MAAa,OAAO,IAAwB;EAC1C,MAAM,KAAK,MAAM,OAAO,EAAE,GAAG,CAAC;CAChC;;;;CASA,MAAa,WAAW,QAAa,MAA4B;EAC/D,MAAM,QAAQ,KAAK,MAAM;EAGzB,IAAI,OAAO,WAAW,UACpB,MAAM,MAAM,MAAM;EAIpB,MAAM,UAAU,MAAM,MAAM,IAAI;EAGhC,KAAK,MAAM,UAAU,SACnB,MAAM,KAAK,OAAO,OAAO,IAAI,IAAI;EAGnC,OAAO,QAAQ;CACjB;;;;CAKA,MAAa,WAAW,QAA8B;EACpD,MAAM,QAAQ,KAAK,MAAM;EAGzB,IAAI,OAAO,WAAW,UACpB,MAAM,MAAM,MAAM;EAIpB,MAAM,UAAU,MAAM,MAAM,IAAI;EAGhC,KAAK,MAAM,UAAU,SACnB,MAAM,OAAO,QAAQ;EAGvB,OAAO,QAAQ;CACjB;;;;CASA,MAAa,MAAM,QAA+B;EAChD,MAAM,QAAQ,KAAK,MAAM;EAEzB,IAAI,UAAU,OAAO,WAAW,UAC9B,MAAM,MAAM,MAAM;EAGpB,OAAO,MAAM,MAAM;CACrB;;;;CASA,MAAa,SAAS,MAAc,OAA6C;EAC/E,OAAO,KAAK,MAAM,CAAC,CAAC,SAAS,MAAM,KAAK;CAC1C;;;;CAKA,MAAa,eACX,SACoC;EACpC,OAAO,KAAK,MAAM,CAAC,CAAC,eAAe,OAAO;CAC5C;;;;CASA,MAAa,MAAM,MAAc,UAA2C;EAC1E,OAAO,KAAK,MAAM,CAAC,CAAC,MAAM,MAAM,QAAQ;CAC1C;;;;CASA,AAAO,YAAY,MAAc;EAC/B,OAAO,IAAK,KAAK,MAAc,IAAI;CACrC;AACF"}

package/esm/repositories/adapters/cascade/cascade-query-builder.d.mts

@@ -2,7 +2,7 @@ import { ChunkCallback, CursorPaginationOptions, CursorPaginationResult, FilterO
 import { QueryBuilderContract as QueryBuilderContract$1 } from "../../contracts/query-builder.contract.mjs";
 import { Model, QueryBuilderContract } from "@warlock.js/cascade";
 
-//#region ../../@warlock.js/core/src/repositories/adapters/cascade/cascade-query-builder.d.ts
+//#region ../@warlock.js/core/src/repositories/adapters/cascade/cascade-query-builder.d.ts
 /**
  * Cascade query builder wrapper
  * Wraps Cascade-Next's ModelAggregate to implement QueryBuilderContract

package/esm/repositories/adapters/cascade/cascade-query-builder.d.mts.map

@@ -1 +1 @@
-{"version":3,"file":"cascade-query-builder.d.mts","names":[],"sources":["../../../../../../../../@warlock.js/core/src/repositories/adapters/cascade/cascade-query-builder.ts"],"mappings":";;;;;;;;;AAsBA;;cAAa,mBAAA,WAA8B,KAAA,aAAkB,sBAAA,CAAqB,CAAA;EAAA,QAKrD,KAAA;EALqD;;;;cAKrD,KAAA,EAAO,oBAAA,CAA4B,CAAA;EA8CtB;;;EArCjC,KAAA,CAAM,KAAA,UAAe,KAAA;EACrB,KAAA,CAAM,KAAA,UAAe,QAAA,EAAU,aAAA,EAAe,KAAA;EAC9C,KAAA,CAAM,UAAA,EAAY,MAAA;EAClB,KAAA,CAAM,QAAA,GAAW,KAAA;EAiOM;;;EAvMvB,MAAA,CAAA;EAqNqD;;;EA9MrD,OAAA,CAAQ,KAAA,UAAe,KAAA;EACvB,OAAA,CAAQ,KAAA,UAAe,QAAA,EAAU,aAAA,EAAe,KAAA;EAChD,OAAA,CAAQ,UAAA,EAAY,MAAA;EAgQ8B;;;EA5OlD,OAAA,CAAQ,KAAA,UAAe,MAAA;EAxEiD;;;EAgFxE,UAAA,CAAW,KAAA,UAAe,MAAA;EAhF0B;;;EAwFpD,SAAA,CAAU,KAAA;EAnFiB;;;EA2F3B,YAAA,CAAa,KAAA;EAlFP;;;EA0FN,YAAA,CAAa,KAAA,UAAe,KAAA;EAzFG;;;EAiG/B,SAAA,CAAU,KAAA,UAAe,OAAA;EAhGP;;;EAwGlB,SAAA,CAAU,MAAA,UAAgB,SAAA,YAAqB,KAAA;EAvGzC;;;EAmHN,MAAA,CAAO,MAAA;EACP,MAAA,CAAA,GAAU,MAAA;EAlFV;;;EA+FA,QAAA,CAAS,MAAA;EACT,QAAA,CAAA,GAAY,MAAA;EA/FZ;;;EAgHA,OAAA,CAAQ,KAAA,UAAe,SAAA;EA5Ff;;;EAoGR,MAAA,CAAO,OAAA,EAAS,MAAA;EA5FU;;;EAuG1B,MAAA,CAAO,KAAA;EAvFM;;;EAmGb,KAAA,CAAM,KAAA;EAnFN;;;EA2FA,MAAA,CAAO,MAAA;EAnFG;;;EA2FV,IAAA,CAAK,KAAA;EA/EE;;;EA0FP,YAAA,CAAa,OAAA,EAAS,WAAA,QAAmB,IAAA,OAAW,OAAA,EAAS,aAAA;EA5EpD;;;EAyFH,GAAA,CAAA,GAAO,OAAA,CAAQ,CAAA;EAvEb;;;EA8EF,KAAA,CAAA,GAAS,OAAA,CAAQ,CAAA;EAtEhB;;;EA6ED,KAAA,CAAA,GAAS,OAAA;EAtDT;;;EA6DA,QAAA,CAAS,IAAA,UAAc,KAAA,WAAgB,OAAA,CAAQ,gBAAA,CAAiB,CAAA;EA7CjE;;;;;;;;EAkEC,cAAA,CACX,OAAA,EAAS,uBAAA,GACR,OAAA,CAAQ,sBAAA,CAAuB,CAAA;EA5CN;;;EAyEf,KAAA,CAAM,IAAA,UAAc,QAAA,EAAU,aAAA,CAAc,CAAA,IAAK,OAAA;EA3DjD;;;EAsEN,IAAA,CAAK,QAAA;EA/DwB;;;EAuE7B,QAAA,CAAA,GAAY,SAAA;EAlDN;;;EAmEN,KAAA,CAAA;AAAA"}
+{"version":3,"file":"cascade-query-builder.d.mts","names":[],"sources":["../../../../../../../../../@warlock.js/core/src/repositories/adapters/cascade/cascade-query-builder.ts"],"mappings":";;;;;;;;;AAsBA;;cAAa,mBAAA,WAA8B,KAAA,aAAkB,sBAAA,CAAqB,CAAA;EAAA,QAKrD,KAAA;EALqD;;;;cAKrD,KAAA,EAAO,oBAAA,CAA4B,CAAA;EA8CtB;;;EArCjC,KAAA,CAAM,KAAA,UAAe,KAAA;EACrB,KAAA,CAAM,KAAA,UAAe,QAAA,EAAU,aAAA,EAAe,KAAA;EAC9C,KAAA,CAAM,UAAA,EAAY,MAAA;EAClB,KAAA,CAAM,QAAA,GAAW,KAAA;EAiOM;;;EAvMvB,MAAA;EAqNqD;;;EA9MrD,OAAA,CAAQ,KAAA,UAAe,KAAA;EACvB,OAAA,CAAQ,KAAA,UAAe,QAAA,EAAU,aAAA,EAAe,KAAA;EAChD,OAAA,CAAQ,UAAA,EAAY,MAAA;EAgQ8B;;;EA5OlD,OAAA,CAAQ,KAAA,UAAe,MAAA;EAxEiD;;;EAgFxE,UAAA,CAAW,KAAA,UAAe,MAAA;EAhF0B;;;EAwFpD,SAAA,CAAU,KAAA;EAnFiB;;;EA2F3B,YAAA,CAAa,KAAA;EAlFP;;;EA0FN,YAAA,CAAa,KAAA,UAAe,KAAA;EAzFG;;;EAiG/B,SAAA,CAAU,KAAA,UAAe,OAAA;EAhGP;;;EAwGlB,SAAA,CAAU,MAAA,UAAgB,SAAA,YAAqB,KAAA;EAvGzC;;;EAmHN,MAAA,CAAO,MAAA;EACP,MAAA,IAAU,MAAA;EAlFV;;;EA+FA,QAAA,CAAS,MAAA;EACT,QAAA,IAAY,MAAA;EA/FZ;;;EAgHA,OAAA,CAAQ,KAAA,UAAe,SAAA;EA5Ff;;;EAoGR,MAAA,CAAO,OAAA,EAAS,MAAA;EA5FU;;;EAuG1B,MAAA,CAAO,KAAA;EAvFM;;;EAmGb,KAAA,CAAM,KAAA;EAnFN;;;EA2FA,MAAA,CAAO,MAAA;EAnFG;;;EA2FV,IAAA,CAAK,KAAA;EA/EE;;;EA0FP,YAAA,CAAa,OAAA,EAAS,WAAA,QAAmB,IAAA,OAAW,OAAA,EAAS,aAAA;EA5EpD;;;EAyFH,GAAA,IAAO,OAAA,CAAQ,CAAA;EAvEb;;;EA8EF,KAAA,IAAS,OAAA,CAAQ,CAAA;EAtEhB;;;EA6ED,KAAA,IAAS,OAAA;EAtDT;;;EA6DA,QAAA,CAAS,IAAA,UAAc,KAAA,WAAgB,OAAA,CAAQ,gBAAA,CAAiB,CAAA;EA7CjE;;;;;;;;EAkEC,cAAA,CACX,OAAA,EAAS,uBAAA,GACR,OAAA,CAAQ,sBAAA,CAAuB,CAAA;EA5CN;;;EAyEf,KAAA,CAAM,IAAA,UAAc,QAAA,EAAU,aAAA,CAAc,CAAA,IAAK,OAAA;EA3DjD;;;EAsEN,IAAA,CAAK,QAAA;EA/DwB;;;EAuE7B,QAAA,IAAY,SAAA;EAlDN;;;EAmEN,KAAA;AAAA"}

package/esm/repositories/adapters/cascade/cascade-query-builder.mjs

@@ -1,6 +1,6 @@
 import { FilterApplicator } from "./filter-applicator.mjs";
 
-//#region ../../@warlock.js/core/src/repositories/adapters/cascade/cascade-query-builder.ts
+//#region ../@warlock.js/core/src/repositories/adapters/cascade/cascade-query-builder.ts
 /**
 * Cascade query builder wrapper
 * Wraps Cascade-Next's ModelAggregate to implement QueryBuilderContract

package/esm/repositories/adapters/cascade/cascade-query-builder.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"cascade-query-builder.mjs","names":[],"sources":["../../../../../../../../@warlock.js/core/src/repositories/adapters/cascade/cascade-query-builder.ts"],"sourcesContent":["import type {\n  QueryBuilderContract as CascadeQueryBuilderContract,\n  Model,\n} from \"@warlock.js/cascade\";\nimport type {\n  ChunkCallback,\n  CursorPaginationOptions,\n  CursorPaginationResult,\n  FilterOptions,\n  FilterRules,\n  PaginationResult,\n  QueryBuilderContract,\n  WhereOperator,\n} from \"../../contracts\";\nimport { FilterApplicator } from \"./filter-applicator\";\n\n/**\n * Cascade query builder wrapper\n * Wraps Cascade-Next's ModelAggregate to implement QueryBuilderContract\n *\n * @template T - The model instance type\n */\nexport class CascadeQueryBuilder<T extends Model> implements QueryBuilderContract<T> {\n  /**\n   * Constructor\n   * @param query - Cascade-Next QueryBuilder instance\n   */\n  public constructor(private query: CascadeQueryBuilderContract<T>) {}\n\n  // ============================================================================\n  // WHERE CLAUSES\n  // ============================================================================\n\n  /**\n   * {@inheritDoc QueryBuilderContract.where}\n   */\n  public where(field: string, value: any): this;\n  public where(field: string, operator: WhereOperator, value: any): this;\n  public where(conditions: Record<string, any>): this;\n  public where(callback: (query: this) => void): this;\n  public where(\n    fieldOrConditionsOrCallback: string | Record<string, any> | ((query: this) => void),\n    operatorOrValue?: WhereOperator | any,\n    value?: any,\n  ): this {\n    if (typeof fieldOrConditionsOrCallback === \"function\") {\n      // Callback\n      fieldOrConditionsOrCallback(this);\n    } else if (typeof fieldOrConditionsOrCallback === \"object\") {\n      // Object conditions\n      this.query.where(fieldOrConditionsOrCallback);\n    } else if (value !== undefined) {\n      // Field, operator, value\n      this.query.where(fieldOrConditionsOrCallback, operatorOrValue, value);\n    } else {\n      // Field, value\n      this.query.where(fieldOrConditionsOrCallback, operatorOrValue);\n    }\n\n    return this;\n  }\n\n  /**\n   * Pretty display the query in terminal\n   */\n  public pretty() {\n    return this.query.pretty();\n  }\n\n  /**\n   * {@inheritDoc QueryBuilderContract.orWhere}\n   */\n  public orWhere(field: string, value: any): this;\n  public orWhere(field: string, operator: WhereOperator, value: any): this;\n  public orWhere(conditions: Record<string, any>): this;\n  public orWhere(\n    fieldOrConditions: string | Record<string, any>,\n    operatorOrValue?: WhereOperator | any,\n    value?: any,\n  ): this {\n    if (typeof fieldOrConditions === \"object\") {\n      this.query.orWhere(fieldOrConditions);\n    } else if (value !== undefined) {\n      this.query.orWhere(fieldOrConditions, operatorOrValue, value);\n    } else {\n      this.query.orWhere(fieldOrConditions, operatorOrValue);\n    }\n\n    return this;\n  }\n\n  /**\n   * {@inheritDoc QueryBuilderContract.whereIn}\n   */\n  public whereIn(field: string, values: any[]): this {\n    this.query.whereIn(field, values);\n    return this;\n  }\n\n  /**\n   * {@inheritDoc QueryBuilderContract.whereNotIn}\n   */\n  public whereNotIn(field: string, values: any[]): this {\n    this.query.whereNotIn(field, values);\n    return this;\n  }\n\n  /**\n   * {@inheritDoc QueryBuilderContract.whereNull}\n   */\n  public whereNull(field: string): this {\n    this.query.whereNull(field);\n    return this;\n  }\n\n  /**\n   * {@inheritDoc QueryBuilderContract.whereNotNull}\n   */\n  public whereNotNull(field: string): this {\n    this.query.whereNotNull(field);\n    return this;\n  }\n\n  /**\n   * {@inheritDoc QueryBuilderContract.whereBetween}\n   */\n  public whereBetween(field: string, range: [any, any]): this {\n    this.query.whereBetween(field, range);\n    return this;\n  }\n\n  /**\n   * {@inheritDoc QueryBuilderContract.whereLike}\n   */\n  public whereLike(field: string, pattern: string): this {\n    this.query.whereLike(field, pattern);\n    return this;\n  }\n\n  /**\n   * {@inheritDoc QueryBuilderContract.similarTo}\n   */\n  public similarTo(column: string, embedding: number[], alias?: string): this {\n    this.query.similarTo(column, embedding, alias);\n    return this;\n  }\n\n  // ============================================================================\n  // SELECT / PROJECTION\n  // ============================================================================\n\n  /**\n   * {@inheritDoc QueryBuilderContract.select}\n   */\n  public select(fields: string[]): this;\n  public select(...fields: string[]): this;\n  public select(...fields: any[]): this {\n    if (Array.isArray(fields[0])) {\n      this.query.select(fields[0]);\n    } else {\n      this.query.select(fields);\n    }\n    return this;\n  }\n\n  /**\n   * {@inheritDoc QueryBuilderContract.deselect}\n   */\n  public deselect(fields: string[]): this;\n  public deselect(...fields: string[]): this;\n  public deselect(...fields: any[]): this {\n    if (Array.isArray(fields[0])) {\n      this.query.deselect(fields[0]);\n    } else {\n      this.query.deselect(fields);\n    }\n    return this;\n  }\n\n  // ============================================================================\n  // ORDERING\n  // ============================================================================\n\n  /**\n   * {@inheritDoc QueryBuilderContract.orderBy}\n   */\n  public orderBy(field: string, direction: \"asc\" | \"desc\" = \"asc\"): this {\n    this.query.orderBy(field, direction);\n    return this;\n  }\n\n  /**\n   * {@inheritDoc QueryBuilderContract.sortBy}\n   */\n  public sortBy(orderBy: Record<string, \"asc\" | \"desc\">): this {\n    // Apply each order clause individually\n    for (const [field, direction] of Object.entries(orderBy)) {\n      this.query.orderBy(field, direction);\n    }\n    return this;\n  }\n\n  /**\n   * {@inheritDoc QueryBuilderContract.random}\n   */\n  public random(limit: number): this {\n    this.query.orderByRandom(limit);\n    return this;\n  }\n\n  // ============================================================================\n  // LIMITING\n  // ============================================================================\n\n  /**\n   * {@inheritDoc QueryBuilderContract.limit}\n   */\n  public limit(limit: number): this {\n    this.query.limit(limit);\n    return this;\n  }\n\n  /**\n   * {@inheritDoc QueryBuilderContract.offset}\n   */\n  public offset(offset: number): this {\n    this.query.offset(offset);\n    return this;\n  }\n\n  /**\n   * {@inheritDoc QueryBuilderContract.skip}\n   */\n  public skip(count: number): this {\n    return this.offset(count);\n  }\n\n  // ============================================================================\n  // FILTERING (Repository-specific)\n  // ============================================================================\n\n  /**\n   * {@inheritDoc QueryBuilderContract.applyFilters}\n   */\n  public applyFilters(filters: FilterRules<this>, data: any, options: FilterOptions): this {\n    const applicator = new FilterApplicator();\n    applicator.apply(this.query as any, filters, data, options);\n    return this;\n  }\n\n  // ============================================================================\n  // EXECUTION\n  // ============================================================================\n\n  /**\n   * {@inheritDoc QueryBuilderContract.get}\n   */\n  public async get(): Promise<T[]> {\n    return this.query.get();\n  }\n\n  /**\n   * {@inheritDoc QueryBuilderContract.first}\n   */\n  public async first(): Promise<T | null> {\n    return this.query.first();\n  }\n\n  /**\n   * {@inheritDoc QueryBuilderContract.count}\n   */\n  public async count(): Promise<number> {\n    return this.query.count();\n  }\n\n  /**\n   * {@inheritDoc QueryBuilderContract.paginate}\n   */\n  public async paginate(page: number, limit: number): Promise<PaginationResult<T>> {\n    const result = await this.query.paginate({ limit, page });\n\n    // Convert Cascade-Next pagination to repository format\n    return {\n      data: result.data,\n      pagination: {\n        ...result.pagination,\n        result: result.data.length,\n      },\n    };\n  }\n\n  /**\n   * {@inheritDoc QueryBuilderContract.cursorPaginate}\n   *\n   * NOTE: This method is a pure executor.\n   * The caller (e.g. RepositoryManager._listImpl) is responsible for applying\n   * the cursor WHERE condition and ORDER BY BEFORE calling this method,\n   * so that the cursor column is always the primary sort key.\n   */\n  public async cursorPaginate(\n    options: CursorPaginationOptions,\n  ): Promise<CursorPaginationResult<T>> {\n    const { limit, cursor, cursorColumn = \"id\" } = options;\n\n    // Fetch limit + 1 to detect whether more pages exist\n    this.limit(limit + 1);\n\n    const results = await this.get();\n    const hasMore = results.length > limit;\n\n    // Drop the extra record used for the hasMore check\n    const documents = hasMore ? results.slice(0, limit) : results;\n\n    const nextCursor = hasMore ? (documents[documents.length - 1] as any)[cursorColumn] : undefined;\n\n    return {\n      data: documents,\n      pagination: {\n        limit,\n        result: documents.length,\n        hasMore,\n        nextCursor,\n        prevCursor: cursor,\n      },\n    };\n  }\n\n  /**\n   * {@inheritDoc QueryBuilderContract.chunk}\n   */\n  public async chunk(size: number, callback: ChunkCallback<T>): Promise<void> {\n    return this.query.chunk(size, callback);\n  }\n\n  // ============================================================================\n  // UTILITIES\n  // ============================================================================\n\n  /**\n   * {@inheritDoc QueryBuilderContract.with}\n   */\n  public with(relation: string): this {\n    this.query.with(relation);\n    return this;\n  }\n\n  /**\n   * {@inheritDoc QueryBuilderContract.joinWith}\n   */\n  public joinWith(...relations: string[]): this {\n    if (this.query.joinWith) {\n      this.query.joinWith(...relations);\n    } else {\n      console.warn(\n        \"[Repository] joinWith is not supported by the underlying query builder. Falling back to with.\",\n      );\n      for (const relation of relations) {\n        this.query.with(relation);\n      }\n    }\n    return this;\n  }\n\n  /**\n   * {@inheritDoc QueryBuilderContract.clone}\n   */\n  public clone(): this {\n    return new CascadeQueryBuilder(this.query.clone()) as this;\n  }\n}\n"],"mappings":"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"}
+{"version":3,"file":"cascade-query-builder.mjs","names":[],"sources":["../../../../../../../../../@warlock.js/core/src/repositories/adapters/cascade/cascade-query-builder.ts"],"sourcesContent":["import type {\n  QueryBuilderContract as CascadeQueryBuilderContract,\n  Model,\n} from \"@warlock.js/cascade\";\nimport type {\n  ChunkCallback,\n  CursorPaginationOptions,\n  CursorPaginationResult,\n  FilterOptions,\n  FilterRules,\n  PaginationResult,\n  QueryBuilderContract,\n  WhereOperator,\n} from \"../../contracts\";\nimport { FilterApplicator } from \"./filter-applicator\";\n\n/**\n * Cascade query builder wrapper\n * Wraps Cascade-Next's ModelAggregate to implement QueryBuilderContract\n *\n * @template T - The model instance type\n */\nexport class CascadeQueryBuilder<T extends Model> implements QueryBuilderContract<T> {\n  /**\n   * Constructor\n   * @param query - Cascade-Next QueryBuilder instance\n   */\n  public constructor(private query: CascadeQueryBuilderContract<T>) {}\n\n  // ============================================================================\n  // WHERE CLAUSES\n  // ============================================================================\n\n  /**\n   * {@inheritDoc QueryBuilderContract.where}\n   */\n  public where(field: string, value: any): this;\n  public where(field: string, operator: WhereOperator, value: any): this;\n  public where(conditions: Record<string, any>): this;\n  public where(callback: (query: this) => void): this;\n  public where(\n    fieldOrConditionsOrCallback: string | Record<string, any> | ((query: this) => void),\n    operatorOrValue?: WhereOperator | any,\n    value?: any,\n  ): this {\n    if (typeof fieldOrConditionsOrCallback === \"function\") {\n      // Callback\n      fieldOrConditionsOrCallback(this);\n    } else if (typeof fieldOrConditionsOrCallback === \"object\") {\n      // Object conditions\n      this.query.where(fieldOrConditionsOrCallback);\n    } else if (value !== undefined) {\n      // Field, operator, value\n      this.query.where(fieldOrConditionsOrCallback, operatorOrValue, value);\n    } else {\n      // Field, value\n      this.query.where(fieldOrConditionsOrCallback, operatorOrValue);\n    }\n\n    return this;\n  }\n\n  /**\n   * Pretty display the query in terminal\n   */\n  public pretty() {\n    return this.query.pretty();\n  }\n\n  /**\n   * {@inheritDoc QueryBuilderContract.orWhere}\n   */\n  public orWhere(field: string, value: any): this;\n  public orWhere(field: string, operator: WhereOperator, value: any): this;\n  public orWhere(conditions: Record<string, any>): this;\n  public orWhere(\n    fieldOrConditions: string | Record<string, any>,\n    operatorOrValue?: WhereOperator | any,\n    value?: any,\n  ): this {\n    if (typeof fieldOrConditions === \"object\") {\n      this.query.orWhere(fieldOrConditions);\n    } else if (value !== undefined) {\n      this.query.orWhere(fieldOrConditions, operatorOrValue, value);\n    } else {\n      this.query.orWhere(fieldOrConditions, operatorOrValue);\n    }\n\n    return this;\n  }\n\n  /**\n   * {@inheritDoc QueryBuilderContract.whereIn}\n   */\n  public whereIn(field: string, values: any[]): this {\n    this.query.whereIn(field, values);\n    return this;\n  }\n\n  /**\n   * {@inheritDoc QueryBuilderContract.whereNotIn}\n   */\n  public whereNotIn(field: string, values: any[]): this {\n    this.query.whereNotIn(field, values);\n    return this;\n  }\n\n  /**\n   * {@inheritDoc QueryBuilderContract.whereNull}\n   */\n  public whereNull(field: string): this {\n    this.query.whereNull(field);\n    return this;\n  }\n\n  /**\n   * {@inheritDoc QueryBuilderContract.whereNotNull}\n   */\n  public whereNotNull(field: string): this {\n    this.query.whereNotNull(field);\n    return this;\n  }\n\n  /**\n   * {@inheritDoc QueryBuilderContract.whereBetween}\n   */\n  public whereBetween(field: string, range: [any, any]): this {\n    this.query.whereBetween(field, range);\n    return this;\n  }\n\n  /**\n   * {@inheritDoc QueryBuilderContract.whereLike}\n   */\n  public whereLike(field: string, pattern: string): this {\n    this.query.whereLike(field, pattern);\n    return this;\n  }\n\n  /**\n   * {@inheritDoc QueryBuilderContract.similarTo}\n   */\n  public similarTo(column: string, embedding: number[], alias?: string): this {\n    this.query.similarTo(column, embedding, alias);\n    return this;\n  }\n\n  // ============================================================================\n  // SELECT / PROJECTION\n  // ============================================================================\n\n  /**\n   * {@inheritDoc QueryBuilderContract.select}\n   */\n  public select(fields: string[]): this;\n  public select(...fields: string[]): this;\n  public select(...fields: any[]): this {\n    if (Array.isArray(fields[0])) {\n      this.query.select(fields[0]);\n    } else {\n      this.query.select(fields);\n    }\n    return this;\n  }\n\n  /**\n   * {@inheritDoc QueryBuilderContract.deselect}\n   */\n  public deselect(fields: string[]): this;\n  public deselect(...fields: string[]): this;\n  public deselect(...fields: any[]): this {\n    if (Array.isArray(fields[0])) {\n      this.query.deselect(fields[0]);\n    } else {\n      this.query.deselect(fields);\n    }\n    return this;\n  }\n\n  // ============================================================================\n  // ORDERING\n  // ============================================================================\n\n  /**\n   * {@inheritDoc QueryBuilderContract.orderBy}\n   */\n  public orderBy(field: string, direction: \"asc\" | \"desc\" = \"asc\"): this {\n    this.query.orderBy(field, direction);\n    return this;\n  }\n\n  /**\n   * {@inheritDoc QueryBuilderContract.sortBy}\n   */\n  public sortBy(orderBy: Record<string, \"asc\" | \"desc\">): this {\n    // Apply each order clause individually\n    for (const [field, direction] of Object.entries(orderBy)) {\n      this.query.orderBy(field, direction);\n    }\n    return this;\n  }\n\n  /**\n   * {@inheritDoc QueryBuilderContract.random}\n   */\n  public random(limit: number): this {\n    this.query.orderByRandom(limit);\n    return this;\n  }\n\n  // ============================================================================\n  // LIMITING\n  // ============================================================================\n\n  /**\n   * {@inheritDoc QueryBuilderContract.limit}\n   */\n  public limit(limit: number): this {\n    this.query.limit(limit);\n    return this;\n  }\n\n  /**\n   * {@inheritDoc QueryBuilderContract.offset}\n   */\n  public offset(offset: number): this {\n    this.query.offset(offset);\n    return this;\n  }\n\n  /**\n   * {@inheritDoc QueryBuilderContract.skip}\n   */\n  public skip(count: number): this {\n    return this.offset(count);\n  }\n\n  // ============================================================================\n  // FILTERING (Repository-specific)\n  // ============================================================================\n\n  /**\n   * {@inheritDoc QueryBuilderContract.applyFilters}\n   */\n  public applyFilters(filters: FilterRules<this>, data: any, options: FilterOptions): this {\n    const applicator = new FilterApplicator();\n    applicator.apply(this.query as any, filters, data, options);\n    return this;\n  }\n\n  // ============================================================================\n  // EXECUTION\n  // ============================================================================\n\n  /**\n   * {@inheritDoc QueryBuilderContract.get}\n   */\n  public async get(): Promise<T[]> {\n    return this.query.get();\n  }\n\n  /**\n   * {@inheritDoc QueryBuilderContract.first}\n   */\n  public async first(): Promise<T | null> {\n    return this.query.first();\n  }\n\n  /**\n   * {@inheritDoc QueryBuilderContract.count}\n   */\n  public async count(): Promise<number> {\n    return this.query.count();\n  }\n\n  /**\n   * {@inheritDoc QueryBuilderContract.paginate}\n   */\n  public async paginate(page: number, limit: number): Promise<PaginationResult<T>> {\n    const result = await this.query.paginate({ limit, page });\n\n    // Convert Cascade-Next pagination to repository format\n    return {\n      data: result.data,\n      pagination: {\n        ...result.pagination,\n        result: result.data.length,\n      },\n    };\n  }\n\n  /**\n   * {@inheritDoc QueryBuilderContract.cursorPaginate}\n   *\n   * NOTE: This method is a pure executor.\n   * The caller (e.g. RepositoryManager._listImpl) is responsible for applying\n   * the cursor WHERE condition and ORDER BY BEFORE calling this method,\n   * so that the cursor column is always the primary sort key.\n   */\n  public async cursorPaginate(\n    options: CursorPaginationOptions,\n  ): Promise<CursorPaginationResult<T>> {\n    const { limit, cursor, cursorColumn = \"id\" } = options;\n\n    // Fetch limit + 1 to detect whether more pages exist\n    this.limit(limit + 1);\n\n    const results = await this.get();\n    const hasMore = results.length > limit;\n\n    // Drop the extra record used for the hasMore check\n    const documents = hasMore ? results.slice(0, limit) : results;\n\n    const nextCursor = hasMore ? (documents[documents.length - 1] as any)[cursorColumn] : undefined;\n\n    return {\n      data: documents,\n      pagination: {\n        limit,\n        result: documents.length,\n        hasMore,\n        nextCursor,\n        prevCursor: cursor,\n      },\n    };\n  }\n\n  /**\n   * {@inheritDoc QueryBuilderContract.chunk}\n   */\n  public async chunk(size: number, callback: ChunkCallback<T>): Promise<void> {\n    return this.query.chunk(size, callback);\n  }\n\n  // ============================================================================\n  // UTILITIES\n  // ============================================================================\n\n  /**\n   * {@inheritDoc QueryBuilderContract.with}\n   */\n  public with(relation: string): this {\n    this.query.with(relation);\n    return this;\n  }\n\n  /**\n   * {@inheritDoc QueryBuilderContract.joinWith}\n   */\n  public joinWith(...relations: string[]): this {\n    if (this.query.joinWith) {\n      this.query.joinWith(...relations);\n    } else {\n      console.warn(\n        \"[Repository] joinWith is not supported by the underlying query builder. Falling back to with.\",\n      );\n      for (const relation of relations) {\n        this.query.with(relation);\n      }\n    }\n    return this;\n  }\n\n  /**\n   * {@inheritDoc QueryBuilderContract.clone}\n   */\n  public clone(): this {\n    return new CascadeQueryBuilder(this.query.clone()) as this;\n  }\n}\n"],"mappings":"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"}

package/esm/repositories/adapters/cascade/filter-applicator.mjs

@@ -1,6 +1,6 @@
 import { isEmpty } from "@mongez/supportive-is";
 
-//#region ../../@warlock.js/core/src/repositories/adapters/cascade/filter-applicator.ts
+//#region ../@warlock.js/core/src/repositories/adapters/cascade/filter-applicator.ts
 /**
 * Applies repository filters to a Cascade-Next query builder
 * Translates repository filter rules into Cascade query builder method calls