@warlock.js/core 4.1.14 → 4.2.0

package/esm/http/uploads-types.d.mts.map

@@ -1 +1 @@
-{"version":3,"file":"uploads-types.d.mts","names":[],"sources":["../../../../../../@warlock.js/core/src/http/uploads-types.ts"],"mappings":";;;;;;;;;AAyBA;;;;;;;;AAiCI;AAWJ;;;;AAA2D;AAS3D;;;KArDY,aAAA;EAqDkB;AAoB9B;;;;;;;;;;;;EA3DE,MAAA;EAyFA;;;;;AAOgC;AAQlC;;EA9FE,YAAA;EA8F0B;AAAgB;AAiB5C;;;;;EAtGE,EAAA;AAAA;;AAsGwD;AAS1D;;;;AAAiF;AAgBjF;KApHY,YAAA,sBAAkC,aAAa;;;;;;;;KAS/C,kBAAA;AAyIS;AAQrB;;;;;;;;;;;;;;AA6BW;;;AArCU,KArHT,WAAA;;;;;;;;;;EAUV,IAAA,GAAO,kBAAA;;;;;;;;;;EAWP,MAAA,GAAS,YAAA;;;;;;;;EAST,MAAA,GAAS,iBAAA;;;;;;EAOT,QAAA,GAAW,qBAAA;AAAA;;;;;;KAQD,aAAA,GAAgB,IAAI,CAAC,WAAA;;;;;;;;;;;;;;;;KAiBrB,sBAAA,IAA0B,GAAA,EAAK,KAAA,KAAU,KAAK;;;;;;;;KAS9C,oBAAA,GAAuB,qBAAA,GAAwB,sBAAsB;;;;;;;;;;;;;;;KAgBrE,qBAAA;;;;;;EAMV,IAAA;;;;;;EAOA,YAAA;;;;;;;;;EAUA,MAAA,GAAS,YAAY;;;;;;EAOrB,mBAAA;AAAA;;;;;;KAQU,wBAAA;;;;EAIV,MAAA;IAAW,KAAA;IAAe,MAAA;EAAA;;;;EAK1B,OAAA;;;;EAKA,MAAA,GAAS,WAAW;;;;EAKpB,MAAA;;;;EAKA,IAAA;;;;EAKA,SAAA;AAAA"}
+{"version":3,"file":"uploads-types.d.mts","names":[],"sources":["../../../../../../../@warlock.js/core/src/http/uploads-types.ts"],"mappings":";;;;;;;;;AAyBA;;;;;;;;AAiCI;AAWJ;;;;AAA2D;AAS3D;;;KArDY,aAAA;EAqDkB;AAoB9B;;;;;;;;;;;;EA3DE,MAAA;EAyFA;;;;;AAOgC;AAQlC;;EA9FE,YAAA;EA8F0B;AAAgB;AAiB5C;;;;;EAtGE,EAAA;AAAA;;AAsGwD;AAS1D;;;;AAAiF;AAgBjF;KApHY,YAAA,sBAAkC,aAAa;;;;;;;;KAS/C,kBAAA;AAyIS;AAQrB;;;;;;;;;;;;;;AA6BW;;;AArCU,KArHT,WAAA;;;;;;;;;;EAUV,IAAA,GAAO,kBAAA;;;;;;;;;;EAWP,MAAA,GAAS,YAAA;;;;;;;;EAST,MAAA,GAAS,iBAAA;;;;;;EAOT,QAAA,GAAW,qBAAA;AAAA;;;;;;KAQD,aAAA,GAAgB,IAAI,CAAC,WAAA;;;;;;;;;;;;;;;;KAiBrB,sBAAA,IAA0B,GAAA,EAAK,KAAA,KAAU,KAAK;;;;;;;;KAS9C,oBAAA,GAAuB,qBAAA,GAAwB,sBAAsB;;;;;;;;;;;;;;;KAgBrE,qBAAA;;;;;;EAMV,IAAA;;;;;;EAOA,YAAA;;;;;;;;;EAUA,MAAA,GAAS,YAAY;;;;;;EAOrB,mBAAA;AAAA;;;;;;KAQU,wBAAA;;;;EAIV,MAAA;IAAW,KAAA;IAAe,MAAA;EAAA;;;;EAK1B,OAAA;;;;EAKA,MAAA,GAAS,WAAW;;;;EAKpB,MAAA;;;;EAKA,IAAA;;;;EAKA,SAAA;AAAA"}

package/esm/image/image.d.mts

@@ -1,6 +1,6 @@
 import sharp, { FormatEnum } from "sharp";
 
-//#region ../../@warlock.js/core/src/image/image.d.ts
+//#region ../@warlock.js/core/src/image/image.d.ts
 type ImageFormat = keyof FormatEnum;
 type ImageInput = string | Buffer | Uint8Array | ArrayBuffer;
 /**

package/esm/image/image.d.mts.map

@@ -1 +1 @@
-{"version":3,"file":"image.d.mts","names":[],"sources":["../../../../../../@warlock.js/core/src/image/image.ts"],"mappings":"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"}
+{"version":3,"file":"image.d.mts","names":[],"sources":["../../../../../../../@warlock.js/core/src/image/image.ts"],"mappings":"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"}

package/esm/image/image.mjs

@@ -1,6 +1,6 @@
 import { http } from "@mongez/http";
 
-//#region ../../@warlock.js/core/src/image/image.ts
+//#region ../@warlock.js/core/src/image/image.ts
 /**
 * Installation instructions for sharp
 */

package/esm/image/image.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"image.mjs","names":[],"sources":["../../../../../../@warlock.js/core/src/image/image.ts"],"sourcesContent":["import { http } from \"@mongez/http\";\r\nimport type sharp from \"sharp\";\r\nimport type { FormatEnum } from \"sharp\";\r\n\r\n// ============================================================\r\n// Eager-loaded Sharp Module\r\n// ============================================================\r\n\r\n/**\r\n * Installation instructions for sharp\r\n */\r\nconst SHARP_INSTALL_INSTRUCTIONS = `\r\nImage processing requires the sharp package.\r\nInstall it with:\r\n\r\n  warlock add image\r\n\r\nOr manually:\r\n\r\n  npm install sharp\r\n  pnpm add sharp\r\n  yarn add sharp\r\n`.trim();\r\n\r\n/**\r\n * Module availability flag\r\n */\r\nlet moduleExists: boolean | null = null;\r\n\r\n/**\r\n * Cached sharp function (loaded at import time)\r\n */\r\nlet sharpFn: typeof sharp;\r\n\r\n/**\r\n * Eagerly load sharp module at import time\r\n */\r\nasync function loadSharpModule() {\r\n  try {\r\n    const module = await import(\"sharp\");\r\n    sharpFn = module.default;\r\n    moduleExists = true;\r\n  } catch {\r\n    moduleExists = false;\r\n  }\r\n}\r\n\r\n// Kick off eager loading immediately\r\nloadSharpModule();\r\n\r\n// ============================================================\r\n// Types\r\n// ============================================================\r\n\r\nexport type ImageFormat = keyof FormatEnum;\r\n\r\nexport type ImageInput = string | Buffer | Uint8Array | ArrayBuffer;\r\n\r\n/**\r\n * Watermark configuration for deferred execution\r\n */\r\nexport type WatermarkConfig = {\r\n  image: ImageInput | Image;\r\n  options: sharp.OverlayOptions;\r\n};\r\n\r\n/**\r\n * Operation descriptor for deferred pipeline execution.\r\n * All operations are stored and executed at save/toBuffer time.\r\n */\r\ntype ImageOperation =\r\n  | { type: \"resize\"; options: sharp.ResizeOptions }\r\n  | { type: \"crop\"; options: sharp.Region }\r\n  | { type: \"rotate\"; angle: number }\r\n  | { type: \"flip\" }\r\n  | { type: \"flop\" }\r\n  | { type: \"blur\"; sigma: number }\r\n  | { type: \"sharpen\"; options?: sharp.SharpenOptions }\r\n  | { type: \"blackAndWhite\" }\r\n  | { type: \"opacity\"; value: number }\r\n  | { type: \"negate\"; options?: sharp.NegateOptions }\r\n  | { type: \"tint\"; color: sharp.Color }\r\n  | { type: \"trim\"; options?: sharp.TrimOptions }\r\n  | { type: \"watermark\"; config: WatermarkConfig }\r\n  | { type: \"watermarks\"; configs: WatermarkConfig[] };\r\n\r\n/**\r\n * Transformation options that can be applied in batch via `apply()` method.\r\n *\r\n * **Execution Order (when using apply()):**\r\n * 1. resize - Resize first to work with correct dimensions\r\n * 2. crop - Crop after resize to extract the desired region\r\n * 3. rotate - Rotation after sizing\r\n * 4. flip/flop - Mirror operations\r\n * 5. blackAndWhite/grayscale - Color space conversion\r\n * 6. blur - Blur effect\r\n * 7. sharpen - Sharpen effect\r\n * 8. tint - Color overlay\r\n * 9. negate - Invert colors\r\n * 10. opacity - Transparency (applied via composite)\r\n * 11. format/quality - Applied on save/export\r\n */\r\nexport type ImageTransformOptions = {\r\n  /**\r\n   * Output quality (1-100), applied based on final format\r\n   */\r\n  quality?: number;\r\n  /**\r\n   * Output format (jpeg, png, webp, avif, etc.)\r\n   */\r\n  format?: ImageFormat;\r\n  /**\r\n   * Resize options\r\n   */\r\n  resize?: sharp.ResizeOptions;\r\n  /**\r\n   * Crop/extract region\r\n   */\r\n  crop?: sharp.Region;\r\n  /**\r\n   * Rotation angle in degrees\r\n   */\r\n  rotate?: number;\r\n  /**\r\n   * Flip vertically (top to bottom)\r\n   */\r\n  flip?: boolean;\r\n  /**\r\n   * Flop horizontally (left to right)\r\n   */\r\n  flop?: boolean;\r\n  /**\r\n   * Convert to black and white\r\n   */\r\n  blackAndWhite?: boolean;\r\n  /**\r\n   * Alias for blackAndWhite\r\n   */\r\n  grayscale?: boolean;\r\n  /**\r\n   * Blur sigma (must be >= 0.3)\r\n   */\r\n  blur?: number;\r\n  /**\r\n   * Sharpen options\r\n   */\r\n  sharpen?: sharp.SharpenOptions | boolean;\r\n  /**\r\n   * Tint color\r\n   */\r\n  tint?: sharp.Color;\r\n  /**\r\n   * Negate/invert colors\r\n   */\r\n  negate?: sharp.NegateOptions | boolean;\r\n  /**\r\n   * Opacity (0-100)\r\n   */\r\n  opacity?: number;\r\n  /**\r\n   * Trim options\r\n   */\r\n  trim?: sharp.TrimOptions | boolean;\r\n  /**\r\n   * Single watermark\r\n   */\r\n  watermark?: WatermarkConfig;\r\n  /**\r\n   * Multiple watermarks\r\n   */\r\n  watermarks?: WatermarkConfig[];\r\n};\r\n\r\n/**\r\n * Internal options stored for deferred application\r\n */\r\ntype InternalOptions = {\r\n  quality?: number;\r\n  format?: ImageFormat;\r\n};\r\n\r\n/**\r\n * Image manipulation class with deferred pipeline execution.\r\n *\r\n * **Important:** This class requires the `sharp` package to be installed.\r\n * Install it with: `warlock add image` or `npm install sharp`\r\n *\r\n * Sharp is lazy-loaded on the first async operation (save, toBuffer, etc.),\r\n * so the constructor and all chainable methods remain synchronous.\r\n *\r\n * All operations are synchronous and stored as descriptors.\r\n * The pipeline is executed only when calling output methods:\r\n * - `save()` - Save to file\r\n * - `toBuffer()` - Get as buffer\r\n * - `toBase64()` - Get as base64 string\r\n * - `toDataUrl()` - Get as data URL\r\n *\r\n * @example\r\n * ```typescript\r\n * // All chaining is synchronous - single await at the end\r\n * await new Image(\"photo.jpg\")\r\n *   .resize({ width: 800 })\r\n *   .watermark(\"logo.png\", { gravity: \"southeast\" })\r\n *   .quality(85)\r\n *   .save(\"output.jpg\");\r\n * ```\r\n */\r\nexport class Image {\r\n  /**\r\n   * Image options that will be applied on save/export\r\n   */\r\n  protected options: InternalOptions = {};\r\n\r\n  /**\r\n   * Deferred operations pipeline\r\n   */\r\n  protected operations: ImageOperation[] = [];\r\n\r\n  /**\r\n   * Cached metadata to avoid repeated async calls\r\n   */\r\n  protected cachedMetadata: sharp.Metadata | null = null;\r\n\r\n  /**\r\n   * Whether the pipeline has been executed\r\n   */\r\n  protected pipelineExecuted = false;\r\n\r\n  /**\r\n   * Sharp image object\r\n   */\r\n  public readonly image: sharp.Sharp;\r\n\r\n  /**\r\n   * Formats that support quality option\r\n   */\r\n  protected static readonly QUALITY_FORMATS = [\"jpeg\", \"jpg\", \"webp\", \"avif\", \"tiff\", \"heif\"];\r\n\r\n  /**\r\n   * Constructor\r\n   */\r\n  public constructor(image: ImageInput | sharp.Sharp) {\r\n    if (moduleExists === false) {\r\n      throw new Error(`sharp is not installed.\\n\\n${SHARP_INSTALL_INSTRUCTIONS}`);\r\n    }\r\n\r\n    // Check if it's already a sharp instance\r\n    if (image instanceof Object && \"clone\" in image && typeof image.clone === \"function\") {\r\n      this.image = image as sharp.Sharp;\r\n    } else {\r\n      this.image = sharpFn(image as ImageInput);\r\n    }\r\n  }\r\n\r\n  /**\r\n   * Create image instance from file path\r\n   */\r\n  public static fromFile(path: string): Image {\r\n    return new Image(path);\r\n  }\r\n\r\n  /**\r\n   * Create image instance from buffer\r\n   */\r\n  public static fromBuffer(buffer: Buffer): Image {\r\n    return new Image(buffer);\r\n  }\r\n\r\n  /**\r\n   * Create image instance from url\r\n   */\r\n  public static async fromUrl(url: string): Promise<Image> {\r\n    const { data, error } = await http.get<ArrayBuffer>(url, {\r\n      responseType: \"arrayBuffer\",\r\n    });\r\n\r\n    if (error || !data) {\r\n      throw new Error(\r\n        `Failed to load image from URL \"${url}\": ${error?.message ?? \"Empty response received\"}`,\r\n      );\r\n    }\r\n\r\n    return new Image(Buffer.from(data));\r\n  }\r\n\r\n  /**\r\n   * Add an operation to the deferred pipeline\r\n   */\r\n  protected addOperation(operation: ImageOperation): this {\r\n    this.operations.push(operation);\r\n\r\n    return this;\r\n  }\r\n\r\n  /**\r\n   * Apply multiple transformations at once with a predefined execution order.\r\n   *\r\n   * This method ensures transformations are applied in a logical order:\r\n   * resize → crop → rotate → flip/flop → colorspace → effects → opacity → format\r\n   *\r\n   * For custom ordering, use individual chained methods instead.\r\n   */\r\n  public apply(options: ImageTransformOptions): this {\r\n    // 1. Resize first to work with correct dimensions\r\n    if (options.resize) {\r\n      this.resize(options.resize);\r\n    }\r\n\r\n    // 2. Crop after resize\r\n    if (options.crop) {\r\n      this.crop(options.crop);\r\n    }\r\n\r\n    // 3. Rotation\r\n    if (options.rotate !== undefined) {\r\n      this.rotate(options.rotate);\r\n    }\r\n\r\n    // 4. Mirror operations\r\n    if (options.flip) {\r\n      this.flip();\r\n    }\r\n\r\n    if (options.flop) {\r\n      this.flop();\r\n    }\r\n\r\n    // 5. Color space conversion\r\n    if (options.blackAndWhite || options.grayscale) {\r\n      this.blackAndWhite();\r\n    }\r\n\r\n    // 6. Blur effect\r\n    if (options.blur !== undefined) {\r\n      this.blur(options.blur);\r\n    }\r\n\r\n    // 7. Sharpen effect\r\n    if (options.sharpen) {\r\n      const sharpenOptions = typeof options.sharpen === \"boolean\" ? undefined : options.sharpen;\r\n      this.sharpen(sharpenOptions);\r\n    }\r\n\r\n    // 8. Tint color\r\n    if (options.tint) {\r\n      this.tint(options.tint);\r\n    }\r\n\r\n    // 9. Negate/invert\r\n    if (options.negate) {\r\n      const negateOptions = typeof options.negate === \"boolean\" ? undefined : options.negate;\r\n      this.negate(negateOptions);\r\n    }\r\n\r\n    // 10. Trim edges\r\n    if (options.trim) {\r\n      const trimOptions = typeof options.trim === \"boolean\" ? undefined : options.trim;\r\n      this.trim(trimOptions);\r\n    }\r\n\r\n    // 11. Watermarks\r\n    if (options.watermark) {\r\n      this.watermark(options.watermark.image, options.watermark.options);\r\n    }\r\n\r\n    if (options.watermarks) {\r\n      this.watermarks(options.watermarks);\r\n    }\r\n\r\n    // 12. Opacity (applied via composite)\r\n    if (options.opacity !== undefined) {\r\n      this.opacity(options.opacity);\r\n    }\r\n\r\n    // 13. Store format/quality for deferred application\r\n    if (options.format) {\r\n      this.format(options.format);\r\n    }\r\n\r\n    if (options.quality !== undefined) {\r\n      this.quality(options.quality);\r\n    }\r\n\r\n    return this;\r\n  }\r\n\r\n  /**\r\n   * Set image opacity (0-100)\r\n   */\r\n  public opacity(value: number): this {\r\n    if (value < 0 || value > 100) {\r\n      throw new Error(\"Opacity must be between 0 and 100\");\r\n    }\r\n\r\n    return this.addOperation({ type: \"opacity\", value });\r\n  }\r\n\r\n  /**\r\n   * Convert image to black and white\r\n   */\r\n  public blackAndWhite(): this {\r\n    return this.addOperation({ type: \"blackAndWhite\" });\r\n  }\r\n\r\n  /**\r\n   * Alias for blackAndWhite\r\n   */\r\n  public grayscale(): this {\r\n    return this.blackAndWhite();\r\n  }\r\n\r\n  /**\r\n   * Get image dimensions (cached after first call)\r\n   */\r\n  public async dimensions(): Promise<{\r\n    width: number | undefined;\r\n    height: number | undefined;\r\n  }> {\r\n    const metadata = await this.metadata();\r\n\r\n    return { width: metadata.width, height: metadata.height };\r\n  }\r\n\r\n  /**\r\n   * Get image metadata (cached after first call)\r\n   *\r\n   * The metadata is cached to avoid repeated async operations.\r\n   * Use `refreshMetadata()` to force a fresh fetch.\r\n   */\r\n  public async metadata(): Promise<sharp.Metadata> {\r\n    if (!this.cachedMetadata) {\r\n      this.cachedMetadata = await this.image.metadata();\r\n    }\r\n\r\n    return this.cachedMetadata;\r\n  }\r\n\r\n  /**\r\n   * Force refresh of cached metadata\r\n   *\r\n   * Call this after transformations if you need updated metadata.\r\n   */\r\n  public async refreshMetadata(): Promise<sharp.Metadata> {\r\n    this.cachedMetadata = await this.image.metadata();\r\n\r\n    return this.cachedMetadata;\r\n  }\r\n\r\n  /**\r\n   * Clear cached metadata\r\n   */\r\n  public clearMetadataCache(): this {\r\n    this.cachedMetadata = null;\r\n\r\n    return this;\r\n  }\r\n\r\n  /**\r\n   * Resize image\r\n   */\r\n  public resize(options: sharp.ResizeOptions): this {\r\n    if (typeof options.width !== \"undefined\" && !options.width) {\r\n      delete options.width;\r\n    }\r\n\r\n    if (typeof options.height !== \"undefined\" && !options.height) {\r\n      delete options.height;\r\n    }\r\n\r\n    return this.addOperation({ type: \"resize\", options });\r\n  }\r\n\r\n  /**\r\n   * Crop/extract a region from the image\r\n   */\r\n  public crop(options: sharp.Region): this {\r\n    return this.addOperation({ type: \"crop\", options });\r\n  }\r\n\r\n  /**\r\n   * Set image quality (1-100)\r\n   * Quality is stored and applied when saving/exporting\r\n   * based on the final format.\r\n   */\r\n  public quality(quality: number): this {\r\n    if (quality < 1 || quality > 100) {\r\n      throw new Error(\"Quality must be between 1 and 100\");\r\n    }\r\n\r\n    this.options.quality = quality;\r\n\r\n    return this;\r\n  }\r\n\r\n  /**\r\n   * Execute the deferred pipeline - apply all stored operations\r\n   */\r\n  protected async executePipeline(): Promise<sharp.Sharp> {\r\n    if (this.pipelineExecuted) {\r\n      return this.image;\r\n    }\r\n\r\n    for (const operation of this.operations) {\r\n      await this.executeOperation(this.image, operation);\r\n    }\r\n\r\n    await this.applyFormatAndQuality(this.image);\r\n\r\n    this.pipelineExecuted = true;\r\n\r\n    return this.image;\r\n  }\r\n\r\n  /**\r\n   * Execute a single operation\r\n   */\r\n  protected async executeOperation(image: sharp.Sharp, operation: ImageOperation): Promise<void> {\r\n    switch (operation.type) {\r\n      case \"resize\":\r\n        image.resize(operation.options);\r\n        break;\r\n\r\n      case \"crop\":\r\n        image.extract(operation.options);\r\n        break;\r\n\r\n      case \"rotate\":\r\n        image.rotate(operation.angle);\r\n        break;\r\n\r\n      case \"flip\":\r\n        image.flip();\r\n        break;\r\n\r\n      case \"flop\":\r\n        image.flop();\r\n        break;\r\n\r\n      case \"blur\":\r\n        image.blur(operation.sigma);\r\n        break;\r\n\r\n      case \"sharpen\":\r\n        image.sharpen(operation.options);\r\n        break;\r\n\r\n      case \"blackAndWhite\":\r\n        image.toColourspace(\"b-w\");\r\n        break;\r\n\r\n      case \"opacity\": {\r\n        const alpha = Math.round((operation.value / 100) * 255);\r\n        const alphaPixel = Buffer.from([255, 255, 255, alpha]);\r\n        image.composite([\r\n          {\r\n            blend: \"dest-in\",\r\n            input: alphaPixel,\r\n          },\r\n        ]);\r\n        break;\r\n      }\r\n\r\n      case \"negate\":\r\n        image.negate(operation.options);\r\n        break;\r\n\r\n      case \"tint\":\r\n        image.tint(operation.color);\r\n        break;\r\n\r\n      case \"trim\":\r\n        image.trim(operation.options);\r\n        break;\r\n\r\n      case \"watermark\": {\r\n        const buffer = await this.resolveImageBuffer(operation.config.image);\r\n        image.composite([\r\n          {\r\n            input: buffer,\r\n            ...operation.config.options,\r\n          },\r\n        ]);\r\n        break;\r\n      }\r\n\r\n      case \"watermarks\": {\r\n        const buffers = await Promise.all(\r\n          operation.configs.map((config) => this.resolveImageBuffer(config.image)),\r\n        );\r\n        image.composite(\r\n          operation.configs.map((config, index) => ({\r\n            input: buffers[index],\r\n            ...config.options,\r\n          })),\r\n        );\r\n        break;\r\n      }\r\n    }\r\n  }\r\n\r\n  /**\r\n   * Resolve an image input to a buffer\r\n   */\r\n  protected async resolveImageBuffer(input: ImageInput | Image): Promise<Buffer> {\r\n    if (input instanceof Image) {\r\n      // For Image instances, get buffer without applying options (raw buffer)\r\n      return input.image.toBuffer();\r\n    }\r\n\r\n    // For other inputs (path, buffer, etc.), create temp sharp instance\r\n    const tempImage = sharpFn(input);\r\n\r\n    return tempImage.toBuffer();\r\n  }\r\n\r\n  /**\r\n   * Apply format and quality options.\r\n   * If no format is explicitly set, preserves the original format and applies\r\n   * quality appropriately based on the format type.\r\n   */\r\n  protected async applyFormatAndQuality(image: sharp.Sharp): Promise<void> {\r\n    const { quality, format } = this.options;\r\n\r\n    if (format) {\r\n      // Explicit format specified\r\n      const formatOptions = quality ? { quality } : undefined;\r\n      image.toFormat(format, formatOptions);\r\n      return;\r\n    }\r\n\r\n    if (quality === undefined) {\r\n      // No quality or format set, nothing to apply\r\n      return;\r\n    }\r\n\r\n    // Quality is set but no format specified - detect original format\r\n    const metadata = await this.metadata();\r\n    const originalFormat = metadata.format;\r\n\r\n    if (!originalFormat) {\r\n      // Cannot detect format, default to webp with quality\r\n      image.webp({ quality });\r\n      return;\r\n    }\r\n\r\n    // Apply quality based on original format\r\n    if (Image.QUALITY_FORMATS.includes(originalFormat)) {\r\n      // Format supports quality option\r\n      image.toFormat(originalFormat as ImageFormat, { quality });\r\n    } else if (originalFormat === \"png\") {\r\n      // PNG uses compressionLevel (0-9) instead of quality\r\n      // Map quality 1-100 to compressionLevel 9-0 (higher quality = lower compression)\r\n      const compressionLevel = Math.round(9 - (quality / 100) * 9);\r\n      image.png({ compressionLevel });\r\n    } else if (originalFormat === \"gif\") {\r\n      // GIF doesn't support quality, just preserve format\r\n      image.gif();\r\n    }\r\n    // Unknown format: preserve as-is (no quality applied)\r\n  }\r\n\r\n  /**\r\n   * Save to file\r\n   */\r\n  public async save(path: string): Promise<sharp.OutputInfo> {\r\n    const image = await this.executePipeline();\r\n\r\n    return image.toFile(path);\r\n  }\r\n\r\n  /**\r\n   * Convert to webp and save to file\r\n   */\r\n  public async saveAsWebp(path: string): Promise<sharp.OutputInfo> {\r\n    // Override format to webp\r\n    this.options.format = \"webp\";\r\n    const image = await this.executePipeline();\r\n\r\n    return image.toFile(path);\r\n  }\r\n\r\n  /**\r\n   * Change the file format\r\n   */\r\n  public format(format: ImageFormat): this {\r\n    this.options.format = format;\r\n\r\n    return this;\r\n  }\r\n\r\n  /**\r\n   * Add watermark (deferred - executed at save time)\r\n   */\r\n  public watermark(image: ImageInput | Image, options: sharp.OverlayOptions = {}): this {\r\n    return this.addOperation({\r\n      type: \"watermark\",\r\n      config: { image, options },\r\n    });\r\n  }\r\n\r\n  /**\r\n   * Add multiple watermarks (deferred - executed at save time)\r\n   */\r\n  public watermarks(configs: WatermarkConfig[]): this {\r\n    return this.addOperation({\r\n      type: \"watermarks\",\r\n      configs,\r\n    });\r\n  }\r\n\r\n  /**\r\n   * Rotate image\r\n   */\r\n  public rotate(angle: number): this {\r\n    return this.addOperation({ type: \"rotate\", angle });\r\n  }\r\n\r\n  /**\r\n   * Flip image vertically (top to bottom)\r\n   */\r\n  public flip(): this {\r\n    return this.addOperation({ type: \"flip\" });\r\n  }\r\n\r\n  /**\r\n   * Flop image horizontally (left to right)\r\n   */\r\n  public flop(): this {\r\n    return this.addOperation({ type: \"flop\" });\r\n  }\r\n\r\n  /**\r\n   * Blur image\r\n   */\r\n  public blur(sigma: number): this {\r\n    if (sigma < 0.3) {\r\n      throw new Error(\"Blur sigma must be at least 0.3\");\r\n    }\r\n\r\n    return this.addOperation({ type: \"blur\", sigma });\r\n  }\r\n\r\n  /**\r\n   * Convert to base64\r\n   */\r\n  public async toBase64(): Promise<string> {\r\n    const image = await this.executePipeline();\r\n    const buffer = await image.toBuffer();\r\n\r\n    return buffer.toString(\"base64\");\r\n  }\r\n\r\n  /**\r\n   * Convert to data URL (base64 with mime type prefix)\r\n   */\r\n  public async toDataUrl(): Promise<string> {\r\n    const metadata = await this.metadata();\r\n    const format = this.options.format || metadata.format || \"png\";\r\n    const mimeType = `image/${format === \"jpg\" ? \"jpeg\" : format}`;\r\n    const base64 = await this.toBase64();\r\n\r\n    return `data:${mimeType};base64,${base64}`;\r\n  }\r\n\r\n  /**\r\n   * Sharpen image\r\n   */\r\n  public sharpen(options?: sharp.SharpenOptions): this {\r\n    return this.addOperation({ type: \"sharpen\", options });\r\n  }\r\n\r\n  /**\r\n   * Negate/invert image colors\r\n   */\r\n  public negate(options?: sharp.NegateOptions): this {\r\n    return this.addOperation({ type: \"negate\", options });\r\n  }\r\n\r\n  /**\r\n   * Tint image with a color\r\n   */\r\n  public tint(color: sharp.Color): this {\r\n    return this.addOperation({ type: \"tint\", color });\r\n  }\r\n\r\n  /**\r\n   * Trim edges from the image\r\n   */\r\n  public trim(options?: sharp.TrimOptions): this {\r\n    return this.addOperation({ type: \"trim\", options });\r\n  }\r\n\r\n  /**\r\n   * Convert to buffer\r\n   */\r\n  public async toBuffer(): Promise<Buffer> {\r\n    const image = await this.executePipeline();\r\n\r\n    return image.toBuffer();\r\n  }\r\n\r\n  /**\r\n   * Clone the image for separate transformations\r\n   */\r\n  public clone(): Image {\r\n    const clonedImage = new Image(this.image.clone());\r\n    clonedImage.options = { ...this.options };\r\n    clonedImage.operations = [...this.operations];\r\n    clonedImage.cachedMetadata = this.cachedMetadata ? { ...this.cachedMetadata } : null;\r\n\r\n    return clonedImage;\r\n  }\r\n\r\n  /**\r\n   * Get the current stored options\r\n   */\r\n  public getOptions(): Readonly<InternalOptions> {\r\n    return { ...this.options };\r\n  }\r\n\r\n  /**\r\n   * Get the pending operations count\r\n   */\r\n  public getPendingOperationsCount(): number {\r\n    return this.operations.length;\r\n  }\r\n\r\n  /**\r\n   * Reset all stored options\r\n   */\r\n  public resetOptions(): this {\r\n    this.options = {};\r\n\r\n    return this;\r\n  }\r\n\r\n  /**\r\n   * Clear all pending operations\r\n   */\r\n  public clearOperations(): this {\r\n    this.operations = [];\r\n    this.pipelineExecuted = false;\r\n\r\n    return this;\r\n  }\r\n\r\n  /**\r\n   * Reset the image to its initial state (clear operations and options)\r\n   */\r\n  public reset(): this {\r\n    this.operations = [];\r\n    this.options = {};\r\n    this.pipelineExecuted = false;\r\n    this.cachedMetadata = null;\r\n\r\n    return this;\r\n  }\r\n}\r\n"],"mappings":"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"}
+{"version":3,"file":"image.mjs","names":[],"sources":["../../../../../../../@warlock.js/core/src/image/image.ts"],"sourcesContent":["import { http } from \"@mongez/http\";\r\nimport type sharp from \"sharp\";\r\nimport type { FormatEnum } from \"sharp\";\r\n\r\n// ============================================================\r\n// Eager-loaded Sharp Module\r\n// ============================================================\r\n\r\n/**\r\n * Installation instructions for sharp\r\n */\r\nconst SHARP_INSTALL_INSTRUCTIONS = `\r\nImage processing requires the sharp package.\r\nInstall it with:\r\n\r\n  warlock add image\r\n\r\nOr manually:\r\n\r\n  npm install sharp\r\n  pnpm add sharp\r\n  yarn add sharp\r\n`.trim();\r\n\r\n/**\r\n * Module availability flag\r\n */\r\nlet moduleExists: boolean | null = null;\r\n\r\n/**\r\n * Cached sharp function (loaded at import time)\r\n */\r\nlet sharpFn: typeof sharp;\r\n\r\n/**\r\n * Eagerly load sharp module at import time\r\n */\r\nasync function loadSharpModule() {\r\n  try {\r\n    const module = await import(\"sharp\");\r\n    sharpFn = module.default;\r\n    moduleExists = true;\r\n  } catch {\r\n    moduleExists = false;\r\n  }\r\n}\r\n\r\n// Kick off eager loading immediately\r\nloadSharpModule();\r\n\r\n// ============================================================\r\n// Types\r\n// ============================================================\r\n\r\nexport type ImageFormat = keyof FormatEnum;\r\n\r\nexport type ImageInput = string | Buffer | Uint8Array | ArrayBuffer;\r\n\r\n/**\r\n * Watermark configuration for deferred execution\r\n */\r\nexport type WatermarkConfig = {\r\n  image: ImageInput | Image;\r\n  options: sharp.OverlayOptions;\r\n};\r\n\r\n/**\r\n * Operation descriptor for deferred pipeline execution.\r\n * All operations are stored and executed at save/toBuffer time.\r\n */\r\ntype ImageOperation =\r\n  | { type: \"resize\"; options: sharp.ResizeOptions }\r\n  | { type: \"crop\"; options: sharp.Region }\r\n  | { type: \"rotate\"; angle: number }\r\n  | { type: \"flip\" }\r\n  | { type: \"flop\" }\r\n  | { type: \"blur\"; sigma: number }\r\n  | { type: \"sharpen\"; options?: sharp.SharpenOptions }\r\n  | { type: \"blackAndWhite\" }\r\n  | { type: \"opacity\"; value: number }\r\n  | { type: \"negate\"; options?: sharp.NegateOptions }\r\n  | { type: \"tint\"; color: sharp.Color }\r\n  | { type: \"trim\"; options?: sharp.TrimOptions }\r\n  | { type: \"watermark\"; config: WatermarkConfig }\r\n  | { type: \"watermarks\"; configs: WatermarkConfig[] };\r\n\r\n/**\r\n * Transformation options that can be applied in batch via `apply()` method.\r\n *\r\n * **Execution Order (when using apply()):**\r\n * 1. resize - Resize first to work with correct dimensions\r\n * 2. crop - Crop after resize to extract the desired region\r\n * 3. rotate - Rotation after sizing\r\n * 4. flip/flop - Mirror operations\r\n * 5. blackAndWhite/grayscale - Color space conversion\r\n * 6. blur - Blur effect\r\n * 7. sharpen - Sharpen effect\r\n * 8. tint - Color overlay\r\n * 9. negate - Invert colors\r\n * 10. opacity - Transparency (applied via composite)\r\n * 11. format/quality - Applied on save/export\r\n */\r\nexport type ImageTransformOptions = {\r\n  /**\r\n   * Output quality (1-100), applied based on final format\r\n   */\r\n  quality?: number;\r\n  /**\r\n   * Output format (jpeg, png, webp, avif, etc.)\r\n   */\r\n  format?: ImageFormat;\r\n  /**\r\n   * Resize options\r\n   */\r\n  resize?: sharp.ResizeOptions;\r\n  /**\r\n   * Crop/extract region\r\n   */\r\n  crop?: sharp.Region;\r\n  /**\r\n   * Rotation angle in degrees\r\n   */\r\n  rotate?: number;\r\n  /**\r\n   * Flip vertically (top to bottom)\r\n   */\r\n  flip?: boolean;\r\n  /**\r\n   * Flop horizontally (left to right)\r\n   */\r\n  flop?: boolean;\r\n  /**\r\n   * Convert to black and white\r\n   */\r\n  blackAndWhite?: boolean;\r\n  /**\r\n   * Alias for blackAndWhite\r\n   */\r\n  grayscale?: boolean;\r\n  /**\r\n   * Blur sigma (must be >= 0.3)\r\n   */\r\n  blur?: number;\r\n  /**\r\n   * Sharpen options\r\n   */\r\n  sharpen?: sharp.SharpenOptions | boolean;\r\n  /**\r\n   * Tint color\r\n   */\r\n  tint?: sharp.Color;\r\n  /**\r\n   * Negate/invert colors\r\n   */\r\n  negate?: sharp.NegateOptions | boolean;\r\n  /**\r\n   * Opacity (0-100)\r\n   */\r\n  opacity?: number;\r\n  /**\r\n   * Trim options\r\n   */\r\n  trim?: sharp.TrimOptions | boolean;\r\n  /**\r\n   * Single watermark\r\n   */\r\n  watermark?: WatermarkConfig;\r\n  /**\r\n   * Multiple watermarks\r\n   */\r\n  watermarks?: WatermarkConfig[];\r\n};\r\n\r\n/**\r\n * Internal options stored for deferred application\r\n */\r\ntype InternalOptions = {\r\n  quality?: number;\r\n  format?: ImageFormat;\r\n};\r\n\r\n/**\r\n * Image manipulation class with deferred pipeline execution.\r\n *\r\n * **Important:** This class requires the `sharp` package to be installed.\r\n * Install it with: `warlock add image` or `npm install sharp`\r\n *\r\n * Sharp is lazy-loaded on the first async operation (save, toBuffer, etc.),\r\n * so the constructor and all chainable methods remain synchronous.\r\n *\r\n * All operations are synchronous and stored as descriptors.\r\n * The pipeline is executed only when calling output methods:\r\n * - `save()` - Save to file\r\n * - `toBuffer()` - Get as buffer\r\n * - `toBase64()` - Get as base64 string\r\n * - `toDataUrl()` - Get as data URL\r\n *\r\n * @example\r\n * ```typescript\r\n * // All chaining is synchronous - single await at the end\r\n * await new Image(\"photo.jpg\")\r\n *   .resize({ width: 800 })\r\n *   .watermark(\"logo.png\", { gravity: \"southeast\" })\r\n *   .quality(85)\r\n *   .save(\"output.jpg\");\r\n * ```\r\n */\r\nexport class Image {\r\n  /**\r\n   * Image options that will be applied on save/export\r\n   */\r\n  protected options: InternalOptions = {};\r\n\r\n  /**\r\n   * Deferred operations pipeline\r\n   */\r\n  protected operations: ImageOperation[] = [];\r\n\r\n  /**\r\n   * Cached metadata to avoid repeated async calls\r\n   */\r\n  protected cachedMetadata: sharp.Metadata | null = null;\r\n\r\n  /**\r\n   * Whether the pipeline has been executed\r\n   */\r\n  protected pipelineExecuted = false;\r\n\r\n  /**\r\n   * Sharp image object\r\n   */\r\n  public readonly image: sharp.Sharp;\r\n\r\n  /**\r\n   * Formats that support quality option\r\n   */\r\n  protected static readonly QUALITY_FORMATS = [\"jpeg\", \"jpg\", \"webp\", \"avif\", \"tiff\", \"heif\"];\r\n\r\n  /**\r\n   * Constructor\r\n   */\r\n  public constructor(image: ImageInput | sharp.Sharp) {\r\n    if (moduleExists === false) {\r\n      throw new Error(`sharp is not installed.\\n\\n${SHARP_INSTALL_INSTRUCTIONS}`);\r\n    }\r\n\r\n    // Check if it's already a sharp instance\r\n    if (image instanceof Object && \"clone\" in image && typeof image.clone === \"function\") {\r\n      this.image = image as sharp.Sharp;\r\n    } else {\r\n      this.image = sharpFn(image as ImageInput);\r\n    }\r\n  }\r\n\r\n  /**\r\n   * Create image instance from file path\r\n   */\r\n  public static fromFile(path: string): Image {\r\n    return new Image(path);\r\n  }\r\n\r\n  /**\r\n   * Create image instance from buffer\r\n   */\r\n  public static fromBuffer(buffer: Buffer): Image {\r\n    return new Image(buffer);\r\n  }\r\n\r\n  /**\r\n   * Create image instance from url\r\n   */\r\n  public static async fromUrl(url: string): Promise<Image> {\r\n    const { data, error } = await http.get<ArrayBuffer>(url, {\r\n      responseType: \"arrayBuffer\",\r\n    });\r\n\r\n    if (error || !data) {\r\n      throw new Error(\r\n        `Failed to load image from URL \"${url}\": ${error?.message ?? \"Empty response received\"}`,\r\n      );\r\n    }\r\n\r\n    return new Image(Buffer.from(data));\r\n  }\r\n\r\n  /**\r\n   * Add an operation to the deferred pipeline\r\n   */\r\n  protected addOperation(operation: ImageOperation): this {\r\n    this.operations.push(operation);\r\n\r\n    return this;\r\n  }\r\n\r\n  /**\r\n   * Apply multiple transformations at once with a predefined execution order.\r\n   *\r\n   * This method ensures transformations are applied in a logical order:\r\n   * resize → crop → rotate → flip/flop → colorspace → effects → opacity → format\r\n   *\r\n   * For custom ordering, use individual chained methods instead.\r\n   */\r\n  public apply(options: ImageTransformOptions): this {\r\n    // 1. Resize first to work with correct dimensions\r\n    if (options.resize) {\r\n      this.resize(options.resize);\r\n    }\r\n\r\n    // 2. Crop after resize\r\n    if (options.crop) {\r\n      this.crop(options.crop);\r\n    }\r\n\r\n    // 3. Rotation\r\n    if (options.rotate !== undefined) {\r\n      this.rotate(options.rotate);\r\n    }\r\n\r\n    // 4. Mirror operations\r\n    if (options.flip) {\r\n      this.flip();\r\n    }\r\n\r\n    if (options.flop) {\r\n      this.flop();\r\n    }\r\n\r\n    // 5. Color space conversion\r\n    if (options.blackAndWhite || options.grayscale) {\r\n      this.blackAndWhite();\r\n    }\r\n\r\n    // 6. Blur effect\r\n    if (options.blur !== undefined) {\r\n      this.blur(options.blur);\r\n    }\r\n\r\n    // 7. Sharpen effect\r\n    if (options.sharpen) {\r\n      const sharpenOptions = typeof options.sharpen === \"boolean\" ? undefined : options.sharpen;\r\n      this.sharpen(sharpenOptions);\r\n    }\r\n\r\n    // 8. Tint color\r\n    if (options.tint) {\r\n      this.tint(options.tint);\r\n    }\r\n\r\n    // 9. Negate/invert\r\n    if (options.negate) {\r\n      const negateOptions = typeof options.negate === \"boolean\" ? undefined : options.negate;\r\n      this.negate(negateOptions);\r\n    }\r\n\r\n    // 10. Trim edges\r\n    if (options.trim) {\r\n      const trimOptions = typeof options.trim === \"boolean\" ? undefined : options.trim;\r\n      this.trim(trimOptions);\r\n    }\r\n\r\n    // 11. Watermarks\r\n    if (options.watermark) {\r\n      this.watermark(options.watermark.image, options.watermark.options);\r\n    }\r\n\r\n    if (options.watermarks) {\r\n      this.watermarks(options.watermarks);\r\n    }\r\n\r\n    // 12. Opacity (applied via composite)\r\n    if (options.opacity !== undefined) {\r\n      this.opacity(options.opacity);\r\n    }\r\n\r\n    // 13. Store format/quality for deferred application\r\n    if (options.format) {\r\n      this.format(options.format);\r\n    }\r\n\r\n    if (options.quality !== undefined) {\r\n      this.quality(options.quality);\r\n    }\r\n\r\n    return this;\r\n  }\r\n\r\n  /**\r\n   * Set image opacity (0-100)\r\n   */\r\n  public opacity(value: number): this {\r\n    if (value < 0 || value > 100) {\r\n      throw new Error(\"Opacity must be between 0 and 100\");\r\n    }\r\n\r\n    return this.addOperation({ type: \"opacity\", value });\r\n  }\r\n\r\n  /**\r\n   * Convert image to black and white\r\n   */\r\n  public blackAndWhite(): this {\r\n    return this.addOperation({ type: \"blackAndWhite\" });\r\n  }\r\n\r\n  /**\r\n   * Alias for blackAndWhite\r\n   */\r\n  public grayscale(): this {\r\n    return this.blackAndWhite();\r\n  }\r\n\r\n  /**\r\n   * Get image dimensions (cached after first call)\r\n   */\r\n  public async dimensions(): Promise<{\r\n    width: number | undefined;\r\n    height: number | undefined;\r\n  }> {\r\n    const metadata = await this.metadata();\r\n\r\n    return { width: metadata.width, height: metadata.height };\r\n  }\r\n\r\n  /**\r\n   * Get image metadata (cached after first call)\r\n   *\r\n   * The metadata is cached to avoid repeated async operations.\r\n   * Use `refreshMetadata()` to force a fresh fetch.\r\n   */\r\n  public async metadata(): Promise<sharp.Metadata> {\r\n    if (!this.cachedMetadata) {\r\n      this.cachedMetadata = await this.image.metadata();\r\n    }\r\n\r\n    return this.cachedMetadata;\r\n  }\r\n\r\n  /**\r\n   * Force refresh of cached metadata\r\n   *\r\n   * Call this after transformations if you need updated metadata.\r\n   */\r\n  public async refreshMetadata(): Promise<sharp.Metadata> {\r\n    this.cachedMetadata = await this.image.metadata();\r\n\r\n    return this.cachedMetadata;\r\n  }\r\n\r\n  /**\r\n   * Clear cached metadata\r\n   */\r\n  public clearMetadataCache(): this {\r\n    this.cachedMetadata = null;\r\n\r\n    return this;\r\n  }\r\n\r\n  /**\r\n   * Resize image\r\n   */\r\n  public resize(options: sharp.ResizeOptions): this {\r\n    if (typeof options.width !== \"undefined\" && !options.width) {\r\n      delete options.width;\r\n    }\r\n\r\n    if (typeof options.height !== \"undefined\" && !options.height) {\r\n      delete options.height;\r\n    }\r\n\r\n    return this.addOperation({ type: \"resize\", options });\r\n  }\r\n\r\n  /**\r\n   * Crop/extract a region from the image\r\n   */\r\n  public crop(options: sharp.Region): this {\r\n    return this.addOperation({ type: \"crop\", options });\r\n  }\r\n\r\n  /**\r\n   * Set image quality (1-100)\r\n   * Quality is stored and applied when saving/exporting\r\n   * based on the final format.\r\n   */\r\n  public quality(quality: number): this {\r\n    if (quality < 1 || quality > 100) {\r\n      throw new Error(\"Quality must be between 1 and 100\");\r\n    }\r\n\r\n    this.options.quality = quality;\r\n\r\n    return this;\r\n  }\r\n\r\n  /**\r\n   * Execute the deferred pipeline - apply all stored operations\r\n   */\r\n  protected async executePipeline(): Promise<sharp.Sharp> {\r\n    if (this.pipelineExecuted) {\r\n      return this.image;\r\n    }\r\n\r\n    for (const operation of this.operations) {\r\n      await this.executeOperation(this.image, operation);\r\n    }\r\n\r\n    await this.applyFormatAndQuality(this.image);\r\n\r\n    this.pipelineExecuted = true;\r\n\r\n    return this.image;\r\n  }\r\n\r\n  /**\r\n   * Execute a single operation\r\n   */\r\n  protected async executeOperation(image: sharp.Sharp, operation: ImageOperation): Promise<void> {\r\n    switch (operation.type) {\r\n      case \"resize\":\r\n        image.resize(operation.options);\r\n        break;\r\n\r\n      case \"crop\":\r\n        image.extract(operation.options);\r\n        break;\r\n\r\n      case \"rotate\":\r\n        image.rotate(operation.angle);\r\n        break;\r\n\r\n      case \"flip\":\r\n        image.flip();\r\n        break;\r\n\r\n      case \"flop\":\r\n        image.flop();\r\n        break;\r\n\r\n      case \"blur\":\r\n        image.blur(operation.sigma);\r\n        break;\r\n\r\n      case \"sharpen\":\r\n        image.sharpen(operation.options);\r\n        break;\r\n\r\n      case \"blackAndWhite\":\r\n        image.toColourspace(\"b-w\");\r\n        break;\r\n\r\n      case \"opacity\": {\r\n        const alpha = Math.round((operation.value / 100) * 255);\r\n        const alphaPixel = Buffer.from([255, 255, 255, alpha]);\r\n        image.composite([\r\n          {\r\n            blend: \"dest-in\",\r\n            input: alphaPixel,\r\n          },\r\n        ]);\r\n        break;\r\n      }\r\n\r\n      case \"negate\":\r\n        image.negate(operation.options);\r\n        break;\r\n\r\n      case \"tint\":\r\n        image.tint(operation.color);\r\n        break;\r\n\r\n      case \"trim\":\r\n        image.trim(operation.options);\r\n        break;\r\n\r\n      case \"watermark\": {\r\n        const buffer = await this.resolveImageBuffer(operation.config.image);\r\n        image.composite([\r\n          {\r\n            input: buffer,\r\n            ...operation.config.options,\r\n          },\r\n        ]);\r\n        break;\r\n      }\r\n\r\n      case \"watermarks\": {\r\n        const buffers = await Promise.all(\r\n          operation.configs.map((config) => this.resolveImageBuffer(config.image)),\r\n        );\r\n        image.composite(\r\n          operation.configs.map((config, index) => ({\r\n            input: buffers[index],\r\n            ...config.options,\r\n          })),\r\n        );\r\n        break;\r\n      }\r\n    }\r\n  }\r\n\r\n  /**\r\n   * Resolve an image input to a buffer\r\n   */\r\n  protected async resolveImageBuffer(input: ImageInput | Image): Promise<Buffer> {\r\n    if (input instanceof Image) {\r\n      // For Image instances, get buffer without applying options (raw buffer)\r\n      return input.image.toBuffer();\r\n    }\r\n\r\n    // For other inputs (path, buffer, etc.), create temp sharp instance\r\n    const tempImage = sharpFn(input);\r\n\r\n    return tempImage.toBuffer();\r\n  }\r\n\r\n  /**\r\n   * Apply format and quality options.\r\n   * If no format is explicitly set, preserves the original format and applies\r\n   * quality appropriately based on the format type.\r\n   */\r\n  protected async applyFormatAndQuality(image: sharp.Sharp): Promise<void> {\r\n    const { quality, format } = this.options;\r\n\r\n    if (format) {\r\n      // Explicit format specified\r\n      const formatOptions = quality ? { quality } : undefined;\r\n      image.toFormat(format, formatOptions);\r\n      return;\r\n    }\r\n\r\n    if (quality === undefined) {\r\n      // No quality or format set, nothing to apply\r\n      return;\r\n    }\r\n\r\n    // Quality is set but no format specified - detect original format\r\n    const metadata = await this.metadata();\r\n    const originalFormat = metadata.format;\r\n\r\n    if (!originalFormat) {\r\n      // Cannot detect format, default to webp with quality\r\n      image.webp({ quality });\r\n      return;\r\n    }\r\n\r\n    // Apply quality based on original format\r\n    if (Image.QUALITY_FORMATS.includes(originalFormat)) {\r\n      // Format supports quality option\r\n      image.toFormat(originalFormat as ImageFormat, { quality });\r\n    } else if (originalFormat === \"png\") {\r\n      // PNG uses compressionLevel (0-9) instead of quality\r\n      // Map quality 1-100 to compressionLevel 9-0 (higher quality = lower compression)\r\n      const compressionLevel = Math.round(9 - (quality / 100) * 9);\r\n      image.png({ compressionLevel });\r\n    } else if (originalFormat === \"gif\") {\r\n      // GIF doesn't support quality, just preserve format\r\n      image.gif();\r\n    }\r\n    // Unknown format: preserve as-is (no quality applied)\r\n  }\r\n\r\n  /**\r\n   * Save to file\r\n   */\r\n  public async save(path: string): Promise<sharp.OutputInfo> {\r\n    const image = await this.executePipeline();\r\n\r\n    return image.toFile(path);\r\n  }\r\n\r\n  /**\r\n   * Convert to webp and save to file\r\n   */\r\n  public async saveAsWebp(path: string): Promise<sharp.OutputInfo> {\r\n    // Override format to webp\r\n    this.options.format = \"webp\";\r\n    const image = await this.executePipeline();\r\n\r\n    return image.toFile(path);\r\n  }\r\n\r\n  /**\r\n   * Change the file format\r\n   */\r\n  public format(format: ImageFormat): this {\r\n    this.options.format = format;\r\n\r\n    return this;\r\n  }\r\n\r\n  /**\r\n   * Add watermark (deferred - executed at save time)\r\n   */\r\n  public watermark(image: ImageInput | Image, options: sharp.OverlayOptions = {}): this {\r\n    return this.addOperation({\r\n      type: \"watermark\",\r\n      config: { image, options },\r\n    });\r\n  }\r\n\r\n  /**\r\n   * Add multiple watermarks (deferred - executed at save time)\r\n   */\r\n  public watermarks(configs: WatermarkConfig[]): this {\r\n    return this.addOperation({\r\n      type: \"watermarks\",\r\n      configs,\r\n    });\r\n  }\r\n\r\n  /**\r\n   * Rotate image\r\n   */\r\n  public rotate(angle: number): this {\r\n    return this.addOperation({ type: \"rotate\", angle });\r\n  }\r\n\r\n  /**\r\n   * Flip image vertically (top to bottom)\r\n   */\r\n  public flip(): this {\r\n    return this.addOperation({ type: \"flip\" });\r\n  }\r\n\r\n  /**\r\n   * Flop image horizontally (left to right)\r\n   */\r\n  public flop(): this {\r\n    return this.addOperation({ type: \"flop\" });\r\n  }\r\n\r\n  /**\r\n   * Blur image\r\n   */\r\n  public blur(sigma: number): this {\r\n    if (sigma < 0.3) {\r\n      throw new Error(\"Blur sigma must be at least 0.3\");\r\n    }\r\n\r\n    return this.addOperation({ type: \"blur\", sigma });\r\n  }\r\n\r\n  /**\r\n   * Convert to base64\r\n   */\r\n  public async toBase64(): Promise<string> {\r\n    const image = await this.executePipeline();\r\n    const buffer = await image.toBuffer();\r\n\r\n    return buffer.toString(\"base64\");\r\n  }\r\n\r\n  /**\r\n   * Convert to data URL (base64 with mime type prefix)\r\n   */\r\n  public async toDataUrl(): Promise<string> {\r\n    const metadata = await this.metadata();\r\n    const format = this.options.format || metadata.format || \"png\";\r\n    const mimeType = `image/${format === \"jpg\" ? \"jpeg\" : format}`;\r\n    const base64 = await this.toBase64();\r\n\r\n    return `data:${mimeType};base64,${base64}`;\r\n  }\r\n\r\n  /**\r\n   * Sharpen image\r\n   */\r\n  public sharpen(options?: sharp.SharpenOptions): this {\r\n    return this.addOperation({ type: \"sharpen\", options });\r\n  }\r\n\r\n  /**\r\n   * Negate/invert image colors\r\n   */\r\n  public negate(options?: sharp.NegateOptions): this {\r\n    return this.addOperation({ type: \"negate\", options });\r\n  }\r\n\r\n  /**\r\n   * Tint image with a color\r\n   */\r\n  public tint(color: sharp.Color): this {\r\n    return this.addOperation({ type: \"tint\", color });\r\n  }\r\n\r\n  /**\r\n   * Trim edges from the image\r\n   */\r\n  public trim(options?: sharp.TrimOptions): this {\r\n    return this.addOperation({ type: \"trim\", options });\r\n  }\r\n\r\n  /**\r\n   * Convert to buffer\r\n   */\r\n  public async toBuffer(): Promise<Buffer> {\r\n    const image = await this.executePipeline();\r\n\r\n    return image.toBuffer();\r\n  }\r\n\r\n  /**\r\n   * Clone the image for separate transformations\r\n   */\r\n  public clone(): Image {\r\n    const clonedImage = new Image(this.image.clone());\r\n    clonedImage.options = { ...this.options };\r\n    clonedImage.operations = [...this.operations];\r\n    clonedImage.cachedMetadata = this.cachedMetadata ? { ...this.cachedMetadata } : null;\r\n\r\n    return clonedImage;\r\n  }\r\n\r\n  /**\r\n   * Get the current stored options\r\n   */\r\n  public getOptions(): Readonly<InternalOptions> {\r\n    return { ...this.options };\r\n  }\r\n\r\n  /**\r\n   * Get the pending operations count\r\n   */\r\n  public getPendingOperationsCount(): number {\r\n    return this.operations.length;\r\n  }\r\n\r\n  /**\r\n   * Reset all stored options\r\n   */\r\n  public resetOptions(): this {\r\n    this.options = {};\r\n\r\n    return this;\r\n  }\r\n\r\n  /**\r\n   * Clear all pending operations\r\n   */\r\n  public clearOperations(): this {\r\n    this.operations = [];\r\n    this.pipelineExecuted = false;\r\n\r\n    return this;\r\n  }\r\n\r\n  /**\r\n   * Reset the image to its initial state (clear operations and options)\r\n   */\r\n  public reset(): this {\r\n    this.operations = [];\r\n    this.options = {};\r\n    this.pipelineExecuted = false;\r\n    this.cachedMetadata = null;\r\n\r\n    return this;\r\n  }\r\n}\r\n"],"mappings":"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"}

package/esm/index.d.mts

@@ -59,6 +59,7 @@ import { displayEnvironmentMode } from "./bootstrap/setup.mjs";
 import { DatabaseCacheDriver, DatabaseCacheOptions } from "./cache/database-cache-driver.mjs";
 import { Connector, ConnectorLifecyclePhase, ConnectorName, ConnectorPriority } from "./connectors/types.mjs";
 import { BaseConnector } from "./connectors/base-connector.mjs";
+import { AccessConnector } from "./connectors/access-connector.mjs";
 import { CacheConnector } from "./connectors/cache-connector.mjs";
 import { HeraldConnector } from "./connectors/herald-connector.mjs";
 import { ConnectorsManager, connectorsManager } from "./connectors/connectors-manager.mjs";
@@ -66,6 +67,7 @@ import { DatabaseConnector } from "./connectors/database-connector.mjs";
 import { HttpConnector } from "./connectors/http-connector.mjs";
 import { LoggerConnector } from "./connectors/logger-connector.mjs";
 import { MailerConnector } from "./connectors/mail-connector.mjs";
+import { NotificationsConnector } from "./connectors/notifications-connector.mjs";
 import { SocketConnector } from "./connectors/socket-connector.mjs";
 import { StorageConnector } from "./connectors/storage.connector.mjs";
 import { CLICommandAction, CLICommandOption, CLICommandOptions, CLICommandPreload, CLICommandSource, CommandActionData, ResolvedCLICommandOption } from "./cli/types.mjs";
@@ -136,13 +138,14 @@ import { uniqueExceptCurrentUserRule } from "./validation/database/unique-except
 import { FileValidator, uploadedFileMetadataSchema } from "./validation/validators/file-validator.mjs";
 import { ValidationConfiguration } from "./validation/types.mjs";
 import { fileExtensionRule, fileRule, fileTypeRule, imageRule } from "./validation/file/file.mjs";
+import { DecoratorLoweringPlugin, lowerStage3Decorators } from "./vite/lower-stage3-decorators.mjs";
 import { WarlockConfig } from "./warlock-config/types.mjs";
 import { defineConfig } from "./warlock-config/define-config.mjs";
-import { WarlockConfigManager, warlockConfigManager } from "./warlock-config/warlock-config.manager.mjs";
+import { WarlockConfigManager, isUnknownTsExtensionError, warlockConfigManager } from "./warlock-config/warlock-config.manager.mjs";
 import { env } from "@mongez/dotenv";
 import { colors } from "@mongez/copper";
 export * from "@mongez/localization";
-export { $registerUseCase, $unregisterUseCase, AllRepositoryOptions, AppConfigurations, Application, BadRequestError, BadSchemaUseCaseError, BaseConnector, BaseHealthChecker, type BenchmarkChannel, type BenchmarkConfigurations, type BenchmarkErrorResult, type BenchmarkOptions, BenchmarkProfiler, type BenchmarkProfilerOptions, type BenchmarkResult, BenchmarkSnapshots, type BenchmarkSnapshotsOptions, type BenchmarkStats, type BenchmarkSuccessResult, CLICommand, CLICommandAction, CLICommandOption, CLICommandOptions, CLICommandPreload, CLICommandSource, CacheConnector, type CacheMiddlewareOptions, CachedRepositoryOptions, type CapturedMail, CascadeAdapter, CascadeQueryBuilder, ChunkCallback, CloudDriver, CloudStorageDriverContract, CloudStorageDriverOptions, CloudStorageFileData, CommandActionData, type ConcurrencyLimitOptions, ConfigKey, ConfigKeyRegistry, ConfigName, ConfigRegistry, ConfigSpecialHandlers, ConflictError, Connector, ConnectorLifecyclePhase, ConnectorName, ConnectorPriority, ConnectorsManager, ConsoleChannel, ContainerTypes, CookieOptions, CursorPaginationOptions, CursorPaginationResult, DOSpacesDriver, DatabaseCacheDriver, type DatabaseCacheOptions, DatabaseConnector, DatabaseLog, DatabaseLogModel, DatabaseLogOptions, DefineResourceOptions, DeleteManyResult, EncryptionConfigurations, EncryptionPasswordConfigurations, Environment, EslintHealthChecker, EventSubscription, ExistsExceptCurrentIdRuleOptions, ExistsExceptCurrentUserRuleOptions, FastifyInstance, FileNamingStrategy, FileValidationOptions, FileValidator, FileVisibility, FilesOrchestrator, FilterFunction, FilterOperator, FilterOptions, FilterRule, FilterRules, ForbiddenError, GroupedRoutesOptions, HeraldConnector, HttpConfigurations, HttpConnector, HttpError, HttpErrorCodes, type IdempotencyOptions, Image, ImageFormat, ImageInput, ImageTransformCallback, ImageTransformConfig, ImageTransformOptions, type IpFilterOptions, ListOptions, LocalDriver, LocalStorageDriverOptions, LocalizedObject, LogConfigurations, LoggerConnector, MAIL_EVENTS, Mail, type MailAddress, type MailAttachment, type MailConfigurations, MailError, type MailErrorCode, type MailEvents, type MailMode, type MailOptions, type MailPriority, type MailResult, MailerConnector, type MailersConfig, type MaintenanceOptions, Middleware, MiddlewareResponse, MimeTypes, NoopChannel, type NormalizedMail, NotAcceptableError, NotAllowedError, PaginationMode, PaginationResult, PartialMiddleware, PartialPick, PipelineOptions, PrefixConfig, PrefixOptions, PresignedOptions, PresignedUploadOptions, PutDirectoryOptions, PutDirectoryResult, PutOptions, QueryBuilderContract, Queue, R2Driver, R2StorageDriverOptions, type RateLimitOptions, RegisterResource, RegisteredUseCase, RepositoryAdapterContract, RepositoryConfigurations, RepositoryEvent, RepositoryManager, RepositoryOptions, RepositoryOptionsWithCursor, RepositoryOptionsWithPages, Request, RequestContextStore, RequestController, RequestControllerContract, RequestEvent, RequestHandler, RequestHandlerType, RequestHandlerValidation, RequestLog, RequestMethod, ResolvedCLICommandOption, Resource, ResourceArraySchema, ResourceCastType, ResourceConstructor, ResourceContract, ResourceFieldBuilder, ResourceFieldBuilderDateOutputOptions, ResourceFieldConfig, ResourceMethod, ResourceNotFoundError, ResourceOutputValueCastType, ResourceSchema, ResourceSelfReference, Response, ResponseBodyValue, ResponseEvent, ResponseSSEController, ResponseSchema, ResponseStatus, ResponseStreamController, Restful, RestfulMiddleware, ReturnedResponse, Route, RouteOptions, RouteResource, Router, RouterGroupCallback, RouterStacks, S3Driver, type SESConfigurations, type SMTPConfigurations, SaveAsOptions, SaveMode, SaveOptions, ScopedStorage, ScopedStorageContract, SeedResult, Seeder, SeederMetadata, SendBufferOptions, SendFileOptions, ServerError, SocketConnector, SocketOptions, Storage, StorageConfigurations, StorageConnector, StorageCopyEventPayload, StorageDriverConfig, StorageDriverContextStore, StorageDriverContract, StorageDriverName, StorageDriverRegistry, StorageDriverType, StorageEventHandler, StorageEventPayload, StorageEventType, StorageFile, StorageFileData, StorageFileInfo, StorageManagerContract, StoragePutEventPayload, TemporaryTokenError, TemporaryTokenPayload, TemporaryTokenValidation, TypedAllRepositoryOptions, TypedRepositoryOptions, TypedRepositoryOptionsWithCursor, TypedRepositoryOptionsWithPages, TypescriptHealthChecker, UPLOADS_DEFAULTS, UnAuthorizedError, UniqueExceptCurrentIdRuleOptions, UniqueExceptCurrentUserRuleOptions, UploadedFile, UploadedFileImageOptions, UploadsConfigurations, UseCase, UseCaseAfterMiddleware, UseCaseBeforeMiddleware, UseCaseBroadcastChannel, UseCaseBroadcastEvent, UseCaseBroadcastOption, UseCaseConfigurations, UseCaseContext, UseCaseErrorResult, UseCaseEventsCallbacksMap, UseCaseGuard, UseCaseHandler, UseCaseOnExecutingContext, UseCaseResult, UseCaseRuntimeOptions, UseCaseWithSchema, ValidationConfiguration, WarlockConfig, WarlockConfigManager, WatermarkConfig, WhereOperator, addUseCaseHistory, anyMatch, app, appLog, appPath, assertMailCount, assertMailSent, assetsUrl, bootstrap, broadcastUseCaseResult, buildIdempotencyCacheKey, cachePath, captureMail, clearTestMailbox, closeAllMailers, closeMailer, colors, command, config, configPath, configSpecialHandlers, connectorsManager, container, createHttpApplication, createRequestStore, decrypt, defaultHttpConfigurations, defineConfig, defineResource, displayEnvironmentMode, encrypt, env, environment, existsExceptCurrentIdRule, existsExceptCurrentUserRule, expectJson, fileExtensionRule, fileRule, fileTypeRule, filesOrchestrator, findMailsBySubject, findMailsTo, fireLifecycleEvent, fromRequest, generateMailId, getDefaultMailConfig, getHttpServer, getLastMail, getLocalized, getMailEventName, getMailMode, getMailboxSize, getMailer, getMailerConfig, getMimeType, getPoolStats, getSocketServer, getTestMailbox, getTestServerUrl, getUseCase, getUseCaseHistory, getUseCases, globalEventsCallbacksMap, globalUseCasesEvents, hashBody, hashPassword, hmacHash, httpConfig, imageRule, increaseUseCaseFailedCalls, increaseUseCaseSuccessCalls, ipMatches, isDevelopmentMode, isProductionMode, isTestMode, isTestServerRunning, isValidIdempotencyKey, loadS3, logResponse, logsPath, mailEvents, measure, middleware, onCleanup, parseJsonResponse, parseSize, paths, promiseAllObject, publicPath, publicUrl, registerAppConfig, registerHttpPlugins, renderReact, renderReactMail, requestContext, resetMailConfig, resolveMailConfig, rootPath, router, runPipeline, sanitizePath, seeder, sendMail, setBaseUrl, setEnvironment, setLogConfigurations, setMailConfigurations, setMailMode, setupTest, sleep, sluggable, srcPath, startHttpServer, startHttpTestServer, stopHttpApplication, stopHttpTestServer, storage, storageConfig, storageConfigurations, storageDriverContext, storagePath, t, tempPath, testDelete, testGet, testPatch, testPost, testPut, testRequest, toJson, uniqueExceptCurrentIdRule, uniqueExceptCurrentUserRule, uploadedFileMetadataSchema, uploadsConfig, uploadsPath, uploadsUrl, url, useCase, useComputedModel, useComputedSlug, useCurrentUser, useHashedPassword, useRequest, useRequestStore, verifyMailer, verifyPassword, warlockConfigManager, warlockPath, wasMailSentTo, wasMailSentWithSubject, wrapResponseInDataKey };
+export { $registerUseCase, $unregisterUseCase, AccessConnector, AllRepositoryOptions, AppConfigurations, Application, BadRequestError, BadSchemaUseCaseError, BaseConnector, BaseHealthChecker, type BenchmarkChannel, type BenchmarkConfigurations, type BenchmarkErrorResult, type BenchmarkOptions, BenchmarkProfiler, type BenchmarkProfilerOptions, type BenchmarkResult, BenchmarkSnapshots, type BenchmarkSnapshotsOptions, type BenchmarkStats, type BenchmarkSuccessResult, CLICommand, CLICommandAction, CLICommandOption, CLICommandOptions, CLICommandPreload, CLICommandSource, CacheConnector, type CacheMiddlewareOptions, CachedRepositoryOptions, type CapturedMail, CascadeAdapter, CascadeQueryBuilder, ChunkCallback, CloudDriver, CloudStorageDriverContract, CloudStorageDriverOptions, CloudStorageFileData, CommandActionData, type ConcurrencyLimitOptions, ConfigKey, ConfigKeyRegistry, ConfigName, ConfigRegistry, ConfigSpecialHandlers, ConflictError, Connector, ConnectorLifecyclePhase, ConnectorName, ConnectorPriority, ConnectorsManager, ConsoleChannel, ContainerTypes, CookieOptions, CursorPaginationOptions, CursorPaginationResult, DOSpacesDriver, DatabaseCacheDriver, type DatabaseCacheOptions, DatabaseConnector, DatabaseLog, DatabaseLogModel, DatabaseLogOptions, DecoratorLoweringPlugin, DefineResourceOptions, DeleteManyResult, EncryptionConfigurations, EncryptionPasswordConfigurations, Environment, EslintHealthChecker, EventSubscription, ExistsExceptCurrentIdRuleOptions, ExistsExceptCurrentUserRuleOptions, FastifyInstance, FileNamingStrategy, FileValidationOptions, FileValidator, FileVisibility, FilesOrchestrator, FilterFunction, FilterOperator, FilterOptions, FilterRule, FilterRules, ForbiddenError, GroupedRoutesOptions, HeraldConnector, HttpConfigurations, HttpConnector, HttpError, HttpErrorCodes, type IdempotencyOptions, Image, ImageFormat, ImageInput, ImageTransformCallback, ImageTransformConfig, ImageTransformOptions, type IpFilterOptions, ListOptions, LocalDriver, LocalStorageDriverOptions, LocalizedObject, LogConfigurations, LoggerConnector, MAIL_EVENTS, Mail, type MailAddress, type MailAttachment, type MailConfigurations, MailError, type MailErrorCode, type MailEvents, type MailMode, type MailOptions, type MailPriority, type MailResult, MailerConnector, type MailersConfig, type MaintenanceOptions, Middleware, MiddlewareResponse, MimeTypes, NoopChannel, type NormalizedMail, NotAcceptableError, NotAllowedError, NotificationsConnector, PaginationMode, PaginationResult, PartialMiddleware, PartialPick, PipelineOptions, PrefixConfig, PrefixOptions, PresignedOptions, PresignedUploadOptions, PutDirectoryOptions, PutDirectoryResult, PutOptions, QueryBuilderContract, Queue, R2Driver, R2StorageDriverOptions, type RateLimitOptions, RegisterResource, RegisteredUseCase, RepositoryAdapterContract, RepositoryConfigurations, RepositoryEvent, RepositoryManager, RepositoryOptions, RepositoryOptionsWithCursor, RepositoryOptionsWithPages, Request, RequestContextStore, RequestController, RequestControllerContract, RequestEvent, RequestHandler, RequestHandlerType, RequestHandlerValidation, RequestLog, RequestMethod, ResolvedCLICommandOption, Resource, ResourceArraySchema, ResourceCastType, ResourceConstructor, ResourceContract, ResourceFieldBuilder, ResourceFieldBuilderDateOutputOptions, ResourceFieldConfig, ResourceMethod, ResourceNotFoundError, ResourceOutputValueCastType, ResourceSchema, ResourceSelfReference, Response, ResponseBodyValue, ResponseEvent, ResponseSSEController, ResponseSchema, ResponseStatus, ResponseStreamController, Restful, RestfulMiddleware, ReturnedResponse, Route, RouteOptions, RouteResource, Router, RouterGroupCallback, RouterStacks, S3Driver, type SESConfigurations, type SMTPConfigurations, SaveAsOptions, SaveMode, SaveOptions, ScopedStorage, ScopedStorageContract, SeedResult, Seeder, SeederMetadata, SendBufferOptions, SendFileOptions, ServerError, SocketConnector, SocketOptions, Storage, StorageConfigurations, StorageConnector, StorageCopyEventPayload, StorageDriverConfig, StorageDriverContextStore, StorageDriverContract, StorageDriverName, StorageDriverRegistry, StorageDriverType, StorageEventHandler, StorageEventPayload, StorageEventType, StorageFile, StorageFileData, StorageFileInfo, StorageManagerContract, StoragePutEventPayload, TemporaryTokenError, TemporaryTokenPayload, TemporaryTokenValidation, TypedAllRepositoryOptions, TypedRepositoryOptions, TypedRepositoryOptionsWithCursor, TypedRepositoryOptionsWithPages, TypescriptHealthChecker, UPLOADS_DEFAULTS, UnAuthorizedError, UniqueExceptCurrentIdRuleOptions, UniqueExceptCurrentUserRuleOptions, UploadedFile, UploadedFileImageOptions, UploadsConfigurations, UseCase, UseCaseAfterMiddleware, UseCaseBeforeMiddleware, UseCaseBroadcastChannel, UseCaseBroadcastEvent, UseCaseBroadcastOption, UseCaseConfigurations, UseCaseContext, UseCaseErrorResult, UseCaseEventsCallbacksMap, UseCaseGuard, UseCaseHandler, UseCaseOnExecutingContext, UseCaseResult, UseCaseRuntimeOptions, UseCaseWithSchema, ValidationConfiguration, WarlockConfig, WarlockConfigManager, WatermarkConfig, WhereOperator, addUseCaseHistory, anyMatch, app, appLog, appPath, assertMailCount, assertMailSent, assetsUrl, bootstrap, broadcastUseCaseResult, buildIdempotencyCacheKey, cachePath, captureMail, clearTestMailbox, closeAllMailers, closeMailer, colors, command, config, configPath, configSpecialHandlers, connectorsManager, container, createHttpApplication, createRequestStore, decrypt, defaultHttpConfigurations, defineConfig, defineResource, displayEnvironmentMode, encrypt, env, environment, existsExceptCurrentIdRule, existsExceptCurrentUserRule, expectJson, fileExtensionRule, fileRule, fileTypeRule, filesOrchestrator, findMailsBySubject, findMailsTo, fireLifecycleEvent, fromRequest, generateMailId, getDefaultMailConfig, getHttpServer, getLastMail, getLocalized, getMailEventName, getMailMode, getMailboxSize, getMailer, getMailerConfig, getMimeType, getPoolStats, getSocketServer, getTestMailbox, getTestServerUrl, getUseCase, getUseCaseHistory, getUseCases, globalEventsCallbacksMap, globalUseCasesEvents, hashBody, hashPassword, hmacHash, httpConfig, imageRule, increaseUseCaseFailedCalls, increaseUseCaseSuccessCalls, ipMatches, isDevelopmentMode, isProductionMode, isTestMode, isTestServerRunning, isUnknownTsExtensionError, isValidIdempotencyKey, loadS3, logResponse, logsPath, lowerStage3Decorators, mailEvents, measure, middleware, onCleanup, parseJsonResponse, parseSize, paths, promiseAllObject, publicPath, publicUrl, registerAppConfig, registerHttpPlugins, renderReact, renderReactMail, requestContext, resetMailConfig, resolveMailConfig, rootPath, router, runPipeline, sanitizePath, seeder, sendMail, setBaseUrl, setEnvironment, setLogConfigurations, setMailConfigurations, setMailMode, setupTest, sleep, sluggable, srcPath, startHttpServer, startHttpTestServer, stopHttpApplication, stopHttpTestServer, storage, storageConfig, storageConfigurations, storageDriverContext, storagePath, t, tempPath, testDelete, testGet, testPatch, testPost, testPut, testRequest, toJson, uniqueExceptCurrentIdRule, uniqueExceptCurrentUserRule, uploadedFileMetadataSchema, uploadsConfig, uploadsPath, uploadsUrl, url, useCase, useComputedModel, useComputedSlug, useCurrentUser, useHashedPassword, useRequest, useRequestStore, verifyMailer, verifyPassword, warlockConfigManager, warlockPath, wasMailSentTo, wasMailSentWithSubject, wrapResponseInDataKey };
 import "./config/types.mjs";
 import "./storage/types.mjs";
 import "./validation/types.mjs";

package/esm/index.mjs

@@ -76,6 +76,7 @@ import "./cache/index.mjs";
 import { CLICommand, command } from "./cli/cli-command.mjs";
 import { ConnectorLifecyclePhase, ConnectorPriority } from "./connectors/types.mjs";
 import { BaseConnector } from "./connectors/base-connector.mjs";
+import { AccessConnector } from "./connectors/access-connector.mjs";
 import { CacheConnector } from "./connectors/cache-connector.mjs";
 import { HeraldConnector } from "./connectors/herald-connector.mjs";
 import { DatabaseConnector } from "./connectors/database-connector.mjs";
@@ -93,6 +94,7 @@ import { sendMail } from "./mail/send-mail.mjs";
 import { Mail } from "./mail/mail.mjs";
 import "./mail/index.mjs";
 import { MailerConnector } from "./connectors/mail-connector.mjs";
+import { NotificationsConnector } from "./connectors/notifications-connector.mjs";
 import { SocketConnector } from "./connectors/socket-connector.mjs";
 import { StorageConnector } from "./connectors/storage.connector.mjs";
 import { ConnectorsManager, connectorsManager } from "./connectors/connectors-manager.mjs";
@@ -100,7 +102,7 @@ import "./connectors/index.mjs";
 import { seeder } from "./database/seeds/seeder.mjs";
 import { useComputedModel, useComputedSlug, useHashedPassword } from "./database/utils.mjs";
 import "./database/index.mjs";
-import { WarlockConfigManager, warlockConfigManager } from "./warlock-config/warlock-config.manager.mjs";
+import { WarlockConfigManager, isUnknownTsExtensionError, warlockConfigManager } from "./warlock-config/warlock-config.manager.mjs";
 import { BaseHealthChecker } from "./dev-server/health-checker/checkers/base-health-checker.mjs";
 import { EslintHealthChecker } from "./dev-server/health-checker/checkers/eslint-health-checker.mjs";
 import { TypescriptHealthChecker } from "./dev-server/health-checker/checkers/typescript-health-checker.mjs";
@@ -135,6 +137,8 @@ import { $registerUseCase, $unregisterUseCase, addUseCaseHistory, getUseCase, ge
 import { useCase } from "./use-cases/use-case.mjs";
 import "./use-cases/index.mjs";
 import "./validation/index.mjs";
+import { lowerStage3Decorators } from "./vite/lower-stage3-decorators.mjs";
+import "./vite/index.mjs";
 import { defineConfig } from "./warlock-config/define-config.mjs";
 import "./warlock-config/index.mjs";
 import { env } from "@mongez/dotenv";
@@ -142,4 +146,4 @@ import { colors } from "@mongez/copper";
 
 export * from "@mongez/localization"
 
-export { $registerUseCase, $unregisterUseCase, Application, BadRequestError, BadSchemaUseCaseError, BaseConnector, BaseHealthChecker, BenchmarkProfiler, BenchmarkSnapshots, CLICommand, CacheConnector, CascadeAdapter, CascadeQueryBuilder, CloudDriver, ConfigSpecialHandlers, ConflictError, ConnectorLifecyclePhase, ConnectorPriority, ConnectorsManager, ConsoleChannel, DOSpacesDriver, DatabaseCacheDriver, DatabaseConnector, DatabaseLog, DatabaseLogModel, EslintHealthChecker, FileValidator, FilesOrchestrator, ForbiddenError, HeraldConnector, HttpConnector, HttpError, HttpErrorCodes, Image, LocalDriver, LoggerConnector, MAIL_EVENTS, Mail, MailError, MailerConnector, MimeTypes, NoopChannel, NotAcceptableError, NotAllowedError, Queue, R2Driver, RegisterResource, RepositoryManager, Request, RequestController, RequestLog, Resource, ResourceFieldBuilder, ResourceNotFoundError, Response, ResponseStatus, Restful, Router, S3Driver, ScopedStorage, ServerError, SocketConnector, Storage, StorageConnector, StorageFile, TypescriptHealthChecker, UPLOADS_DEFAULTS, UnAuthorizedError, UploadedFile, WarlockConfigManager, addUseCaseHistory, anyMatch, app, appLog, appPath, assertMailCount, assertMailSent, assetsUrl, bootstrap, broadcastUseCaseResult, buildIdempotencyCacheKey, cachePath, captureMail, clearTestMailbox, closeAllMailers, closeMailer, colors, command, config, configPath, configSpecialHandlers, connectorsManager, container, createHttpApplication, createRequestStore, decrypt, defaultHttpConfigurations, defineConfig, defineResource, displayEnvironmentMode, encrypt, env, environment, existsExceptCurrentIdRule, existsExceptCurrentUserRule, expectJson, fileExtensionRule, fileRule, fileTypeRule, filesOrchestrator, findMailsBySubject, findMailsTo, fireLifecycleEvent, fromRequest, generateMailId, getDefaultMailConfig, getHttpServer, getLastMail, getLocalized, getMailEventName, getMailMode, getMailboxSize, getMailer, getMailerConfig, getMimeType, getPoolStats, getSocketServer, getTestMailbox, getTestServerUrl, getUseCase, getUseCaseHistory, getUseCases, globalEventsCallbacksMap, globalUseCasesEvents, hashBody, hashPassword, hmacHash, httpConfig, imageRule, increaseUseCaseFailedCalls, increaseUseCaseSuccessCalls, ipMatches, isDevelopmentMode, isProductionMode, isTestMode, isTestServerRunning, isValidIdempotencyKey, loadS3, logResponse, logsPath, mailEvents, measure, middleware, onCleanup, parseJsonResponse, parseSize, paths, promiseAllObject, publicPath, publicUrl, registerAppConfig, registerHttpPlugins, renderReact, renderReactMail, requestContext, resetMailConfig, resolveMailConfig, rootPath, router, runPipeline, sanitizePath, seeder, sendMail, setBaseUrl, setEnvironment, setLogConfigurations, setMailConfigurations, setMailMode, setupTest, sleep, sluggable, srcPath, startHttpServer, startHttpTestServer, stopHttpApplication, stopHttpTestServer, storage, storageConfig, storageConfigurations, storageDriverContext, storagePath, t, tempPath, testDelete, testGet, testPatch, testPost, testPut, testRequest, toJson, uniqueExceptCurrentIdRule, uniqueExceptCurrentUserRule, uploadedFileMetadataSchema, uploadsConfig, uploadsPath, uploadsUrl, url, useCase, useComputedModel, useComputedSlug, useCurrentUser, useHashedPassword, useRequest, useRequestStore, verifyMailer, verifyPassword, warlockConfigManager, warlockPath, wasMailSentTo, wasMailSentWithSubject, wrapResponseInDataKey };
+export { $registerUseCase, $unregisterUseCase, AccessConnector, Application, BadRequestError, BadSchemaUseCaseError, BaseConnector, BaseHealthChecker, BenchmarkProfiler, BenchmarkSnapshots, CLICommand, CacheConnector, CascadeAdapter, CascadeQueryBuilder, CloudDriver, ConfigSpecialHandlers, ConflictError, ConnectorLifecyclePhase, ConnectorPriority, ConnectorsManager, ConsoleChannel, DOSpacesDriver, DatabaseCacheDriver, DatabaseConnector, DatabaseLog, DatabaseLogModel, EslintHealthChecker, FileValidator, FilesOrchestrator, ForbiddenError, HeraldConnector, HttpConnector, HttpError, HttpErrorCodes, Image, LocalDriver, LoggerConnector, MAIL_EVENTS, Mail, MailError, MailerConnector, MimeTypes, NoopChannel, NotAcceptableError, NotAllowedError, NotificationsConnector, Queue, R2Driver, RegisterResource, RepositoryManager, Request, RequestController, RequestLog, Resource, ResourceFieldBuilder, ResourceNotFoundError, Response, ResponseStatus, Restful, Router, S3Driver, ScopedStorage, ServerError, SocketConnector, Storage, StorageConnector, StorageFile, TypescriptHealthChecker, UPLOADS_DEFAULTS, UnAuthorizedError, UploadedFile, WarlockConfigManager, addUseCaseHistory, anyMatch, app, appLog, appPath, assertMailCount, assertMailSent, assetsUrl, bootstrap, broadcastUseCaseResult, buildIdempotencyCacheKey, cachePath, captureMail, clearTestMailbox, closeAllMailers, closeMailer, colors, command, config, configPath, configSpecialHandlers, connectorsManager, container, createHttpApplication, createRequestStore, decrypt, defaultHttpConfigurations, defineConfig, defineResource, displayEnvironmentMode, encrypt, env, environment, existsExceptCurrentIdRule, existsExceptCurrentUserRule, expectJson, fileExtensionRule, fileRule, fileTypeRule, filesOrchestrator, findMailsBySubject, findMailsTo, fireLifecycleEvent, fromRequest, generateMailId, getDefaultMailConfig, getHttpServer, getLastMail, getLocalized, getMailEventName, getMailMode, getMailboxSize, getMailer, getMailerConfig, getMimeType, getPoolStats, getSocketServer, getTestMailbox, getTestServerUrl, getUseCase, getUseCaseHistory, getUseCases, globalEventsCallbacksMap, globalUseCasesEvents, hashBody, hashPassword, hmacHash, httpConfig, imageRule, increaseUseCaseFailedCalls, increaseUseCaseSuccessCalls, ipMatches, isDevelopmentMode, isProductionMode, isTestMode, isTestServerRunning, isUnknownTsExtensionError, isValidIdempotencyKey, loadS3, logResponse, logsPath, lowerStage3Decorators, mailEvents, measure, middleware, onCleanup, parseJsonResponse, parseSize, paths, promiseAllObject, publicPath, publicUrl, registerAppConfig, registerHttpPlugins, renderReact, renderReactMail, requestContext, resetMailConfig, resolveMailConfig, rootPath, router, runPipeline, sanitizePath, seeder, sendMail, setBaseUrl, setEnvironment, setLogConfigurations, setMailConfigurations, setMailMode, setupTest, sleep, sluggable, srcPath, startHttpServer, startHttpTestServer, stopHttpApplication, stopHttpTestServer, storage, storageConfig, storageConfigurations, storageDriverContext, storagePath, t, tempPath, testDelete, testGet, testPatch, testPost, testPut, testRequest, toJson, uniqueExceptCurrentIdRule, uniqueExceptCurrentUserRule, uploadedFileMetadataSchema, uploadsConfig, uploadsPath, uploadsUrl, url, useCase, useComputedModel, useComputedSlug, useCurrentUser, useHashedPassword, useRequest, useRequestStore, verifyMailer, verifyPassword, warlockConfigManager, warlockPath, wasMailSentTo, wasMailSentWithSubject, wrapResponseInDataKey };

package/esm/logger/logger.d.mts

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

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

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

package/esm/logger/logger.mjs

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

package/esm/logger/logger.mjs.map

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

package/esm/logger/types.d.mts

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

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

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

package/esm/mail/config.d.mts

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

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

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

package/esm/mail/config.mjs

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

package/esm/mail/config.mjs.map

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

package/esm/mail/events.d.mts

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

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

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

package/esm/mail/events.mjs

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

package/esm/mail/events.mjs.map

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

package/esm/mail/mail.d.mts

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

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

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

package/esm/mail/mail.mjs

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

package/esm/mail/mail.mjs.map

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

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

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

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

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

package/esm/mail/mailer-pool.mjs

@@ -1,6 +1,6 @@
 import { log } from "@warlock.js/logger";
 
-//#region ../../@warlock.js/core/src/mail/mailer-pool.ts
+//#region ../@warlock.js/core/src/mail/mailer-pool.ts
 /**
 * Installation instructions for nodemailer
 */