@warlock.js/core 5.31.0 → 5.32.0

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

@@ -1,7 +1,8 @@
 import { StorageDriverName } from "../storage/types.mjs";
+import "../storage/index.mjs";
 import { Image, ImageFormat, ImageTransformOptions } from "../image/image.mjs";
+import "../image/index.mjs";
 import { FileValidationOptions } from "./uploaded-file.mjs";
-
 //#region ../../packages/core/src/http/uploads-types.d.ts
 /**
  * Prefix options for file path generation
@@ -24,7 +25,7 @@ import { FileValidationOptions } from "./uploaded-file.mjs";
  * // → a7x9/image.png
  * ```
  */
-type PrefixOptions = {
+export type PrefixOptions = {
   /**
    * Date format string using tokens:
    * - `dd`: Day (01-31)
@@ -65,7 +66,7 @@ type PrefixOptions = {
  * - `string`: Static prefix string (e.g., "avatar-", "user-123-")
  * - `PrefixOptions`: Full control over format, randomness, and output mode
  */
-type PrefixConfig = boolean | string | PrefixOptions;
+export type PrefixConfig = boolean | string | PrefixOptions;
 /**
  * File naming strategy
  *
@@ -73,7 +74,7 @@ type PrefixConfig = boolean | string | PrefixOptions;
  * - `"original"`: Use the original uploaded filename (sanitized)
  * - `string`: Custom filename (extension auto-appended from original file)
  */
-type FileNamingStrategy = "random" | "original" | (string & {});
+export type FileNamingStrategy = "random" | "original" | (string & {});
 /**
  * Options for saving uploaded files
  *
@@ -92,7 +93,7 @@ type FileNamingStrategy = "random" | "original" | (string & {});
  * });
  * ```
  */
-type SaveOptions = {
+export type SaveOptions = {
   /**
    * Filename strategy
    *
@@ -133,7 +134,7 @@ type SaveOptions = {
  *
  * Same as SaveOptions but without name/prefix since the full path is explicit.
  */
-type SaveAsOptions = Omit<SaveOptions, "name" | "prefix">;
+export type SaveAsOptions = Omit<SaveOptions, "name" | "prefix">;
 /**
  * Image transformation callback function
  *
@@ -149,7 +150,7 @@ type SaveAsOptions = Omit<SaveOptions, "name" | "prefix">;
  * );
  * ```
  */
-type ImageTransformCallback = (img: Image) => Image;
+export type ImageTransformCallback = (img: Image) => Image;
 /**
  * Image transformation configuration
  *
@@ -157,7 +158,7 @@ type ImageTransformCallback = (img: Image) => Image;
  * - An options object with predefined transforms
  * - A callback function for full control
  */
-type ImageTransformConfig = ImageTransformOptions | ImageTransformCallback;
+export type ImageTransformConfig = ImageTransformOptions | ImageTransformCallback;
 /**
  * Uploads configuration for app config
  *
@@ -172,7 +173,7 @@ type ImageTransformConfig = ImageTransformOptions | ImageTransformCallback;
  * }
  * ```
  */
-type UploadsConfigurations = {
+export type UploadsConfigurations = {
   /**
    * Default naming strategy for uploaded files
    *
@@ -216,11 +217,11 @@ type UploadsConfigurations = {
 /**
  * Output formats a client may request with `&format=` on an image variant
  */
-type ImageVariantOutputFormat = "avif" | "webp";
+export type ImageVariantOutputFormat = "avif" | "webp";
 /**
  * How an image variant fits into its box, see sharp's `fit` resize option
  */
-type ImageVariantFit = "cover" | "contain" | "inside";
+export type ImageVariantFit = "cover" | "contain" | "inside";
 /**
  * One named image variant
  *
@@ -229,7 +230,7 @@ type ImageVariantFit = "cover" | "contain" | "inside";
  * { width: 640, height: 480, fit: "cover", quality: 80 }
  * ```
  */
-type ImageVariantDefinition = {
+export type ImageVariantDefinition = {
   /**
    * Target width in pixels, a positive integer up to 8192
    */
@@ -272,7 +273,7 @@ type ImageVariantDefinition = {
  * }
  * ```
  */
-type UploadsImagesConfigurations = {
+export type UploadsImagesConfigurations = {
   /**
    * The named variants a client may request with `?variant=<name>`
    */
@@ -302,8 +303,10 @@ type UploadsImagesConfigurations = {
    *
    * @default storage.root(".cache/image-variants")
    */
-  cacheDirectory?: string; /** Maximum total cached derivative bytes. Default 512 MiB. */
-  maxCacheBytes?: number; /** Maximum derivative age in seconds, measured from generation. Default 7 days. */
+  cacheDirectory?: string;
+  /** Maximum total cached derivative bytes. Default 512 MiB. */
+  maxCacheBytes?: number;
+  /** Maximum derivative age in seconds, measured from generation. Default 7 days. */
   maxCacheAge?: number;
 };
 /**
@@ -311,7 +314,7 @@ type UploadsImagesConfigurations = {
  *
  * These are stored internally and applied before saving.
  */
-type UploadedFileImageOptions = {
+export type UploadedFileImageOptions = {
   /**
    * Resize dimensions
    */
@@ -341,5 +344,4 @@ type UploadedFileImageOptions = {
   grayscale?: boolean;
 };
 //#endregion
-export { FileNamingStrategy, ImageTransformCallback, ImageTransformConfig, ImageVariantDefinition, ImageVariantFit, ImageVariantOutputFormat, PrefixConfig, PrefixOptions, SaveAsOptions, SaveOptions, UploadedFileImageOptions, UploadsConfigurations, UploadsImagesConfigurations };
 //# sourceMappingURL=uploads-types.d.mts.map

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

@@ -1 +1 @@
-{"version":3,"file":"uploads-types.d.mts","names":[],"sources":["../../../../../../../../packages/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;;;AAsJ0B;AAMtC;;;;AAAoC;AAKpC;;;;AAA2B;AAU3B;;;;;KAvJY,WAAA;EAuKV;;;;;AAcO;AAkBT;;;EA7LE,IAAA,GAAO,kBAAA;EAiMY;;;;;;;;;EAtLnB,MAAA,GAAS,YAAA;EA6LU;;;;;;;EApLnB,MAAA,GAAS,iBAAA;EAyNC;;;;;EAlNV,QAAA,GAAW,qBAAA;AAAA;;;;;;KAQD,aAAA,GAAgB,IAAI,CAAC,WAAA;;AAuOtB;;;;;;;;;;;;;;KAtNC,sBAAA,IAA0B,GAAA,EAAK,KAAA,KAAU,KAAK;;;;;;;;KAS9C,oBAAA,GAAuB,qBAAA,GAAwB,sBAAsB;;;;;;;;;;;;;;;KAgBrE,qBAAA;;;;;;EAMV,IAAA;;;;;;EAOA,YAAA;;;;;;;;;EAUA,MAAA,GAAS,YAAA;;;;;;EAOT,mBAAA;;;;;;;;;;;;EAaA,MAAA,GAAS,2BAA2B;AAAA;;;;KAM1B,wBAAA;;;;KAKA,eAAA;;;;;;;;;KAUA,sBAAA;;;;EAIV,KAAA;;;;EAKA,MAAA;;;;;;EAOA,GAAA,GAAM,eAAe;;;;EAKrB,OAAA;;;;;;;;EASA,OAAA;AAAA;;;;;;;;;;;;;;;;KAkBU,2BAAA;;;;EAIV,QAAA,EAAU,QAAA,CAAS,MAAA,SAAe,sBAAA;;;;;;EAOlC,OAAA,YAAmB,wBAAA;;;;;;EAOnB,cAAA;;;;;;EAOA,eAAA;;;;;;;;EASA,cAAA;EAGA,aAAA;EAGA,WAAA;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":["../../../../../../../../packages/core/src/http/uploads-types.ts"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;YAyBY;;;;;;;;;;;;;;EAcV;;;;;;;;;EAUA;;;;;;;;EASA;;;;;;;;;;YAWU,kCAAkC;;;;;;;;YASlC;;;;;;;;;;;;;;;;;;;YAoBA;;;;;;;;;;EAUV,OAAO;;;;;;;;;;EAWP,SAAS;;;;;;;;EAST,SAAS;;;;;;EAOT,WAAW;;;;;;;YAQD,gBAAgB,KAAK;;;;;;;;;;;;;;;;YAiBrB,0BAA0B,KAAK,UAAU;;;;;;;;YASzC,uBAAuB,wBAAwB;;;;;;;;;;;;;;;YAgB/C;;;;;;EAMV;;;;;;EAOA;;;;;;;;;EAUA,SAAS;;;;;;EAOT;;;;;;;;;;;;EAaA,SAAS;;;;;YAMC;;;;YAKA;;;;;;;;;YAUA;;;;EAIV;;;;EAKA;;;;;;EAOA,MAAM;;;;EAKN;;;;;;;;EASA;;;;;;;;;;;;;;;;;YAkBU;;;;EAIV,UAAU,SAAS,eAAe;;;;;;EAOlC,mBAAmB;;;;;;EAOnB;;;;;;EAOA;;;;;;;;EASA;;EAGA;;EAGA;;;;;;;YAQU;;;;EAIV;IAAW;IAAe;;;;;EAK1B;;;;EAKA,SAAS;;;;EAKT;;;;EAKA;;;;EAKA"}

package/esm/http/xmlable.d.mts

@@ -6,9 +6,8 @@
  * feed package) never imports core — a `Sitemap` satisfies `XMLable` just by
  * having a `toXML()` method.
  */
-interface XMLable {
+export interface XMLable {
   toXML(): string;
 }
 //#endregion
-export { XMLable };
 //# sourceMappingURL=xmlable.d.mts.map

package/esm/http/xmlable.d.mts.map

@@ -1 +1 @@
-{"version":3,"file":"xmlable.d.mts","names":[],"sources":["../../../../../../../../packages/core/src/http/xmlable.ts"],"mappings":";;AAOA;;;;AACO;;UADU,OAAA;EACf,KAAK;AAAA"}
+{"version":3,"file":"xmlable.d.mts","names":[],"sources":["../../../../../../../../packages/core/src/http/xmlable.ts"],"mappings":";;;;;;;;iBAOiB;EACf"}

package/esm/image/image.d.mts

@@ -1,12 +1,11 @@
 import sharp, { FormatEnum } from "sharp";
-
 //#region ../../packages/core/src/image/image.d.ts
-type ImageFormat = keyof FormatEnum;
-type ImageInput = string | Buffer | Uint8Array | ArrayBuffer;
+export type ImageFormat = keyof FormatEnum;
+export type ImageInput = string | Buffer | Uint8Array | ArrayBuffer;
 /**
  * Watermark configuration for deferred execution
  */
-type WatermarkConfig = {
+export type WatermarkConfig = {
   image: ImageInput | Image;
   options: sharp.OverlayOptions;
 };
@@ -70,7 +69,7 @@ type ImageOperation = {
  * 10. opacity - Transparency (applied via composite)
  * 11. format/quality - Applied on save/export
  */
-type ImageTransformOptions = {
+export type ImageTransformOptions = {
   /**
    * Output quality (1-100), applied based on final format
    */
@@ -174,7 +173,7 @@ type InternalOptions = {
  *   .save("output.jpg");
  * ```
  */
-declare class Image {
+export declare class Image {
   /**
    * Image options that will be applied on save/export
    */
@@ -386,5 +385,5 @@ declare class Image {
   reset(): this;
 }
 //#endregion
-export { Image, ImageFormat, ImageInput, ImageTransformOptions, WatermarkConfig };
+export {};
 //# sourceMappingURL=image.d.mts.map

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

@@ -1 +1 @@
-{"version":3,"file":"image.d.mts","names":[],"sources":["../../../../../../../../packages/core/src/image/image.ts"],"mappings":"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"}
+{"version":3,"file":"image.d.mts","names":[],"sources":["../../../../../../../../packages/core/src/image/image.ts"],"mappings":";;YAkIY,oBAAoB;YAEpB,sBAAsB,SAAS,aAAa;;;;YAK5C;EACV,OAAO,aAAa;EACpB,SAAS,MAAM;;;;;;KAOZ;EACC;EAAgB,SAAS,MAAM;;EAC/B;EAAc,SAAS,MAAM;;EAC7B;EAAgB;;EAChB;;EACA;;EACA;EAAc;;EACd;EAAiB,UAAU,MAAM;;EACjC;;EACA;EAAiB;;EACjB;EAAgB,UAAU,MAAM;;EAChC;EAAc,OAAO,MAAM;;EAC3B;EAAc,UAAU,MAAM;;EAC9B;EAAmB,QAAQ;;EAC3B;EAAoB,SAAS;;;;;;;;;;;;;;;;;;YAkBvB;;;;EAIV;;;;EAIA,SAAS;;;;EAIT,SAAS,MAAM;;;;EAIf,OAAO,MAAM;;;;EAIb;;;;EAIA;;;;EAIA;;;;EAIA;;;;EAIA;;;;EAIA;;;;EAIA,UAAU,MAAM;;;;EAIhB,OAAO,MAAM;;;;EAIb,SAAS,MAAM;;;;EAIf;;;;EAIA,OAAO,MAAM;;;;EAIb,YAAY;;;;EAIZ,aAAa;;;;;KAMV;EACH;EACA,SAAS;;;;;;;;;;;;;;;;;;;;;;;;;;;;;qBA8BE;;;;YAID,SAAS;;;;YAKT,YAAY;;;;YAKZ,gBAAgB,MAAM;;;;YAKtB;;;;WAKM,OAAO,MAAM;;;;4BAKH;;;;EAK1B,YAAmB,OAAO,aAAa,MAAM;;;;SAa/B,SAAS,eAAe;;;;SAOxB,WAAW,QAAQ,SAAS;;;;SAOtB,QAAQ,cAAc,QAAQ;;;;YAgBxC,aAAa,WAAW;;;;;;;;;EAc3B,MAAM,SAAS;;;;EAuFf,QAAQ;;;;EAWR;;;;EAOA;;;;EAOM,cAAc;IACzB;IACA;;;;;;;;EAaW,YAAY,QAAQ,MAAM;;;;;;EAa1B,mBAAmB,QAAQ,MAAM;;;;EASvC;;;;EASA,OAAO,SAAS,MAAM;;;;EAetB,KAAK,SAAS,MAAM;;;;;;EASpB,QAAQ;;;;YAaC,mBAAmB,QAAQ,MAAM;;;;YA2BjC,iBACd,OAAO,MAAM,OACb,WAAW,gBACX,SAAQ,MAAM,mBACb;;;;YAqFa,mBAAmB,OAAO,aAAa,QAAQ,QAAQ;;;;;;YAiBvD,sBAAsB,OAAO,MAAM,QAAQ;;;;EA4C9C,KAAK,eAAe,QAAQ,MAAM;;;;EASlC,WAAW,eAAe,QAAQ,MAAM;;;;EAW9C,OAAO,QAAQ;;;;EASf,UAAU,OAAO,aAAa,OAAO,UAAS,MAAM;;;;EAUpD,WAAW,SAAS;;;;EAUpB,OAAO;;;;EAOP;;;;EAOA;;;;EAOA,KAAK;;;;EAWC,YAAY;;;;EAUZ,aAAa;;;;EAYnB,QAAQ,UAAU,MAAM;;;;EAOxB,OAAO,UAAU,MAAM;;;;EAOvB,KAAK,OAAO,MAAM;;;;EAOlB,KAAK,UAAU,MAAM;;;;EAOf,YAAY,QAAQ;;;;EAS1B,SAAS;;;;EAYT,cAAc,SAAS;;;;EAOvB;;;;EAOA;;;;EASA;;;;EAUA"}

package/esm/image/image.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"image.mjs","names":[],"sources":["../../../../../../../../packages/core/src/image/image.ts"],"sourcesContent":["import { createRequire } from \"node:module\";\nimport type sharp from \"sharp\";\nimport type { FormatEnum } from \"sharp\";\nimport { safeFetchToBuffer } from \"../storage/utils/safe-fetch\";\n\n// ============================================================\n// Lazily Resolved Sharp Module\n// ============================================================\n\n/**\n * Installation instructions for sharp\n */\nconst SHARP_INSTALL_INSTRUCTIONS = `\nImage processing requires the sharp package.\nInstall it with:\n\n  warlock add image\n\nOr manually:\n\n  npm install sharp\n  pnpm add sharp\n  yarn add sharp\n`.trim();\n\n/**\n * Cached sharp function, populated by the first `resolveSharp()` call\n */\nlet sharpFn: typeof sharp | null = null;\n\n/**\n * Whether the resolution attempt already ran (success or failure)\n */\nlet sharpResolved = false;\n\n/**\n * Why the resolution failed, when it failed for a reason other than absence.\n *\n * Cached and re-thrown on every later call: the resolution attempt runs exactly\n * once, so without this the second construction would fall through to the\n * \"not installed\" branch and report a different, wrong cause.\n */\nlet sharpLoadError: Error | null = null;\n\n/**\n * `new Error(message, { cause })` is ES2022, and this package still compiles\n * against the ES2020 lib (see #16), where `Error` is typed as taking a message\n * only. Node has supported the option since v16, so this is the type layer\n * catching up with the runtime, not a change in what the code does.\n */\ntype ErrorWithCauseConstructor = new (message: string, options: { cause: unknown }) => Error;\n\nconst ErrorWithCause = Error as ErrorWithCauseConstructor;\n\n/**\n * Whether `error` says sharp itself is absent, as opposed to present but broken.\n *\n * Both halves are load-bearing. `MODULE_NOT_FOUND` alone is not enough: a\n * dependency missing *inside* sharp raises the very same code (`Cannot find\n * module 'color'`), and treating that as absence would tell the operator to\n * install a package they already have. So the message has to name the specifier\n * `'sharp'` exactly — quoted, which is also what keeps `'sharp-cli'` and friends\n * from matching.\n */\nfunction isSharpMissing(error: unknown): boolean {\n  if (!(error instanceof Error)) return false;\n\n  return (\n    (error as NodeJS.ErrnoException).code === \"MODULE_NOT_FOUND\" &&\n    error.message.includes(\"Cannot find module 'sharp'\")\n  );\n}\n\n/**\n * Resolve sharp synchronously, on first use.\n *\n * Resolution is deliberately *lazy* and *synchronous*:\n *\n * - Lazy, because a top-level require would drag sharp's native binary into\n *   every `import \"@warlock.js/core\"`, including apps that never touch images.\n * - Synchronous, because the `Image` constructor is synchronous. An async\n *   import kicked off at module load leaves a window in which the module is\n *   neither loaded nor known to be missing, and a constructor running inside\n *   that window has no correct answer to give.\n *\n * `createRequire` gives an ESM-safe `require`, and the outcome — module, absence\n * or load failure — is cached, so the resolution runs exactly once per process.\n * The failure *reason* is cached too, not just the fact of it: every call after\n * a failed load has to report the same cause as the first one.\n *\n * @throws when sharp is not installed, or is installed but cannot be loaded\n */\nfunction resolveSharp(): typeof sharp {\n  if (!sharpResolved) {\n    sharpResolved = true;\n\n    try {\n      const require = createRequire(import.meta.url);\n      const module = require(\"sharp\");\n      sharpFn = (module.default ?? module) as typeof sharp;\n    } catch (error) {\n      sharpFn = null;\n\n      if (!isSharpMissing(error)) {\n        // sharp is there, it just would not load — almost always a binary built\n        // for another platform. Its own error names the runtime and the fix, so\n        // it is inlined *and* chained: a terminal that never prints `cause`\n        // must still show the text that actually helps.\n        sharpLoadError = new ErrorWithCause(`Failed to load \"sharp\": ${(error as Error).message}`, {\n          cause: error,\n        });\n      }\n    }\n  }\n\n  if (sharpLoadError) {\n    throw sharpLoadError;\n  }\n\n  if (!sharpFn) {\n    throw new Error(`sharp is not installed.\\n\\n${SHARP_INSTALL_INSTRUCTIONS}`);\n  }\n\n  return sharpFn;\n}\n\n// ============================================================\n// Types\n// ============================================================\n\nexport type ImageFormat = keyof FormatEnum;\n\nexport type ImageInput = string | Buffer | Uint8Array | ArrayBuffer;\n\n/**\n * Watermark configuration for deferred execution\n */\nexport type WatermarkConfig = {\n  image: ImageInput | Image;\n  options: sharp.OverlayOptions;\n};\n\n/**\n * Operation descriptor for deferred pipeline execution.\n * All operations are stored and executed at save/toBuffer time.\n */\ntype ImageOperation =\n  | { type: \"resize\"; options: sharp.ResizeOptions }\n  | { type: \"crop\"; options: sharp.Region }\n  | { type: \"rotate\"; angle: number }\n  | { type: \"flip\" }\n  | { type: \"flop\" }\n  | { type: \"blur\"; sigma: number }\n  | { type: \"sharpen\"; options?: sharp.SharpenOptions }\n  | { type: \"blackAndWhite\" }\n  | { type: \"opacity\"; value: number }\n  | { type: \"negate\"; options?: sharp.NegateOptions }\n  | { type: \"tint\"; color: sharp.Color }\n  | { type: \"trim\"; options?: sharp.TrimOptions }\n  | { type: \"watermark\"; config: WatermarkConfig }\n  | { type: \"watermarks\"; configs: WatermarkConfig[] };\n\n/**\n * Transformation options that can be applied in batch via `apply()` method.\n *\n * **Execution Order (when using apply()):**\n * 1. resize - Resize first to work with correct dimensions\n * 2. crop - Crop after resize to extract the desired region\n * 3. rotate - Rotation after sizing\n * 4. flip/flop - Mirror operations\n * 5. blackAndWhite/grayscale - Color space conversion\n * 6. blur - Blur effect\n * 7. sharpen - Sharpen effect\n * 8. tint - Color overlay\n * 9. negate - Invert colors\n * 10. opacity - Transparency (applied via composite)\n * 11. format/quality - Applied on save/export\n */\nexport type ImageTransformOptions = {\n  /**\n   * Output quality (1-100), applied based on final format\n   */\n  quality?: number;\n  /**\n   * Output format (jpeg, png, webp, avif, etc.)\n   */\n  format?: ImageFormat;\n  /**\n   * Resize options\n   */\n  resize?: sharp.ResizeOptions;\n  /**\n   * Crop/extract region\n   */\n  crop?: sharp.Region;\n  /**\n   * Rotation angle in degrees\n   */\n  rotate?: number;\n  /**\n   * Flip vertically (top to bottom)\n   */\n  flip?: boolean;\n  /**\n   * Flop horizontally (left to right)\n   */\n  flop?: boolean;\n  /**\n   * Convert to black and white\n   */\n  blackAndWhite?: boolean;\n  /**\n   * Alias for blackAndWhite\n   */\n  grayscale?: boolean;\n  /**\n   * Blur sigma (must be >= 0.3)\n   */\n  blur?: number;\n  /**\n   * Sharpen options\n   */\n  sharpen?: sharp.SharpenOptions | boolean;\n  /**\n   * Tint color\n   */\n  tint?: sharp.Color;\n  /**\n   * Negate/invert colors\n   */\n  negate?: sharp.NegateOptions | boolean;\n  /**\n   * Opacity (0-100)\n   */\n  opacity?: number;\n  /**\n   * Trim options\n   */\n  trim?: sharp.TrimOptions | boolean;\n  /**\n   * Single watermark\n   */\n  watermark?: WatermarkConfig;\n  /**\n   * Multiple watermarks\n   */\n  watermarks?: WatermarkConfig[];\n};\n\n/**\n * Internal options stored for deferred application\n */\ntype InternalOptions = {\n  quality?: number;\n  format?: ImageFormat;\n};\n\n/**\n * Image manipulation class with deferred pipeline execution.\n *\n * **Important:** This class requires the `sharp` package to be installed.\n * Install it with: `warlock add image` or `npm install sharp`\n *\n * Sharp is resolved synchronously on the first construction that needs it, so\n * the constructor and all chainable methods remain synchronous, and a missing\n * sharp throws at construction rather than at some later await.\n *\n * All operations are synchronous and stored as descriptors.\n * The pipeline is executed only when calling output methods:\n * - `save()` - Save to file\n * - `toBuffer()` - Get as buffer\n * - `toBase64()` - Get as base64 string\n * - `toDataUrl()` - Get as data URL\n *\n * @example\n * ```typescript\n * // All chaining is synchronous - single await at the end\n * await new Image(\"photo.jpg\")\n *   .resize({ width: 800 })\n *   .watermark(\"logo.png\", { gravity: \"southeast\" })\n *   .quality(85)\n *   .save(\"output.jpg\");\n * ```\n */\nexport class Image {\n  /**\n   * Image options that will be applied on save/export\n   */\n  protected options: InternalOptions = {};\n\n  /**\n   * Deferred operations pipeline\n   */\n  protected operations: ImageOperation[] = [];\n\n  /**\n   * Cached metadata to avoid repeated async calls\n   */\n  protected cachedMetadata: sharp.Metadata | null = null;\n\n  /**\n   * Whether the pipeline has been executed\n   */\n  protected pipelineExecuted = false;\n\n  /**\n   * Sharp image object\n   */\n  public readonly image: sharp.Sharp;\n\n  /**\n   * Formats that support quality option\n   */\n  protected static readonly QUALITY_FORMATS = [\"jpeg\", \"jpg\", \"webp\", \"avif\", \"tiff\", \"heif\"];\n\n  /**\n   * Constructor\n   */\n  public constructor(image: ImageInput | sharp.Sharp) {\n    // An existing sharp instance carries its own module — short-circuit before\n    // resolving sharp, so cloning never pays for (or fails on) a module load.\n    if (image instanceof Object && \"clone\" in image && typeof image.clone === \"function\") {\n      this.image = image as sharp.Sharp;\n    } else {\n      this.image = resolveSharp()(image as ImageInput);\n    }\n  }\n\n  /**\n   * Create image instance from file path\n   */\n  public static fromFile(path: string): Image {\n    return new Image(path);\n  }\n\n  /**\n   * Create image instance from buffer\n   */\n  public static fromBuffer(buffer: Buffer): Image {\n    return new Image(buffer);\n  }\n\n  /**\n   * Create image instance from url\n   */\n  public static async fromUrl(url: string): Promise<Image> {\n    // SSRF-guarded: scheme allowlist, private-IP deny (incl. redirects), size cap, timeout\n    const { buffer, ok, status, statusText } = await safeFetchToBuffer(url);\n\n    if (!ok || buffer.length === 0) {\n      throw new Error(\n        `Failed to load image from URL \"${url}\": ${ok ? \"Empty response received\" : `${status} ${statusText}`}`,\n      );\n    }\n\n    return new Image(buffer);\n  }\n\n  /**\n   * Add an operation to the deferred pipeline\n   */\n  protected addOperation(operation: ImageOperation): this {\n    this.operations.push(operation);\n\n    return this;\n  }\n\n  /**\n   * Apply multiple transformations at once with a predefined execution order.\n   *\n   * This method ensures transformations are applied in a logical order:\n   * resize → crop → rotate → flip/flop → colorspace → effects → opacity → format\n   *\n   * For custom ordering, use individual chained methods instead.\n   */\n  public apply(options: ImageTransformOptions): this {\n    // 1. Resize first to work with correct dimensions\n    if (options.resize) {\n      this.resize(options.resize);\n    }\n\n    // 2. Crop after resize\n    if (options.crop) {\n      this.crop(options.crop);\n    }\n\n    // 3. Rotation\n    if (options.rotate !== undefined) {\n      this.rotate(options.rotate);\n    }\n\n    // 4. Mirror operations\n    if (options.flip) {\n      this.flip();\n    }\n\n    if (options.flop) {\n      this.flop();\n    }\n\n    // 5. Color space conversion\n    if (options.blackAndWhite || options.grayscale) {\n      this.blackAndWhite();\n    }\n\n    // 6. Blur effect\n    if (options.blur !== undefined) {\n      this.blur(options.blur);\n    }\n\n    // 7. Sharpen effect\n    if (options.sharpen) {\n      const sharpenOptions = typeof options.sharpen === \"boolean\" ? undefined : options.sharpen;\n      this.sharpen(sharpenOptions);\n    }\n\n    // 8. Tint color\n    if (options.tint) {\n      this.tint(options.tint);\n    }\n\n    // 9. Negate/invert\n    if (options.negate) {\n      const negateOptions = typeof options.negate === \"boolean\" ? undefined : options.negate;\n      this.negate(negateOptions);\n    }\n\n    // 10. Trim edges\n    if (options.trim) {\n      const trimOptions = typeof options.trim === \"boolean\" ? undefined : options.trim;\n      this.trim(trimOptions);\n    }\n\n    // 11. Watermarks\n    if (options.watermark) {\n      this.watermark(options.watermark.image, options.watermark.options);\n    }\n\n    if (options.watermarks) {\n      this.watermarks(options.watermarks);\n    }\n\n    // 12. Opacity (applied via composite)\n    if (options.opacity !== undefined) {\n      this.opacity(options.opacity);\n    }\n\n    // 13. Store format/quality for deferred application\n    if (options.format) {\n      this.format(options.format);\n    }\n\n    if (options.quality !== undefined) {\n      this.quality(options.quality);\n    }\n\n    return this;\n  }\n\n  /**\n   * Set image opacity (0-100)\n   */\n  public opacity(value: number): this {\n    if (value < 0 || value > 100) {\n      throw new Error(\"Opacity must be between 0 and 100\");\n    }\n\n    return this.addOperation({ type: \"opacity\", value });\n  }\n\n  /**\n   * Convert image to black and white\n   */\n  public blackAndWhite(): this {\n    return this.addOperation({ type: \"blackAndWhite\" });\n  }\n\n  /**\n   * Alias for blackAndWhite\n   */\n  public grayscale(): this {\n    return this.blackAndWhite();\n  }\n\n  /**\n   * Get image dimensions (cached after first call)\n   */\n  public async dimensions(): Promise<{\n    width: number | undefined;\n    height: number | undefined;\n  }> {\n    const metadata = await this.metadata();\n\n    return { width: metadata.width, height: metadata.height };\n  }\n\n  /**\n   * Get image metadata (cached after first call)\n   *\n   * The metadata is cached to avoid repeated async operations.\n   * Use `refreshMetadata()` to force a fresh fetch.\n   */\n  public async metadata(): Promise<sharp.Metadata> {\n    if (!this.cachedMetadata) {\n      this.cachedMetadata = await this.image.metadata();\n    }\n\n    return this.cachedMetadata;\n  }\n\n  /**\n   * Force refresh of cached metadata\n   *\n   * Call this after transformations if you need updated metadata.\n   */\n  public async refreshMetadata(): Promise<sharp.Metadata> {\n    this.cachedMetadata = await this.image.metadata();\n\n    return this.cachedMetadata;\n  }\n\n  /**\n   * Clear cached metadata\n   */\n  public clearMetadataCache(): this {\n    this.cachedMetadata = null;\n\n    return this;\n  }\n\n  /**\n   * Resize image\n   */\n  public resize(options: sharp.ResizeOptions): this {\n    if (typeof options.width !== \"undefined\" && !options.width) {\n      delete options.width;\n    }\n\n    if (typeof options.height !== \"undefined\" && !options.height) {\n      delete options.height;\n    }\n\n    return this.addOperation({ type: \"resize\", options });\n  }\n\n  /**\n   * Crop/extract a region from the image\n   */\n  public crop(options: sharp.Region): this {\n    return this.addOperation({ type: \"crop\", options });\n  }\n\n  /**\n   * Set image quality (1-100)\n   * Quality is stored and applied when saving/exporting\n   * based on the final format.\n   */\n  public quality(quality: number): this {\n    if (quality < 1 || quality > 100) {\n      throw new Error(\"Quality must be between 1 and 100\");\n    }\n\n    this.options.quality = quality;\n\n    return this;\n  }\n\n  /**\n   * Execute the deferred pipeline - apply all stored operations\n   */\n  protected async executePipeline(): Promise<sharp.Sharp> {\n    if (this.pipelineExecuted) {\n      return this.image;\n    }\n\n    // sharp's composite() REPLACES the previous list, so every layer is\n    // collected and applied in a single call, in operation order.\n    const layers: sharp.OverlayOptions[] = [];\n\n    for (const operation of this.operations) {\n      await this.executeOperation(this.image, operation, layers);\n    }\n\n    if (layers.length > 0) {\n      this.image.composite(layers);\n    }\n\n    await this.applyFormatAndQuality(this.image);\n\n    this.pipelineExecuted = true;\n\n    return this.image;\n  }\n\n  /**\n   * Execute a single operation\n   */\n  protected async executeOperation(\n    image: sharp.Sharp,\n    operation: ImageOperation,\n    layers: sharp.OverlayOptions[] = [],\n  ): Promise<void> {\n    switch (operation.type) {\n      case \"resize\":\n        image.resize(operation.options);\n        break;\n\n      case \"crop\":\n        image.extract(operation.options);\n        break;\n\n      case \"rotate\":\n        image.rotate(operation.angle);\n        break;\n\n      case \"flip\":\n        image.flip();\n        break;\n\n      case \"flop\":\n        image.flop();\n        break;\n\n      case \"blur\":\n        image.blur(operation.sigma);\n        break;\n\n      case \"sharpen\":\n        image.sharpen(operation.options);\n        break;\n\n      case \"blackAndWhite\":\n        image.toColourspace(\"b-w\");\n        break;\n\n      case \"opacity\": {\n        const alpha = Math.round((operation.value / 100) * 255);\n        const alphaPixel = Buffer.from([255, 255, 255, alpha]);\n        layers.push({\n          blend: \"dest-in\",\n          input: alphaPixel,\n          raw: { width: 1, height: 1, channels: 4 },\n          tile: true,\n        });\n        break;\n      }\n\n      case \"negate\":\n        image.negate(operation.options);\n        break;\n\n      case \"tint\":\n        image.tint(operation.color);\n        break;\n\n      case \"trim\":\n        image.trim(operation.options);\n        break;\n\n      case \"watermark\": {\n        const buffer = await this.resolveImageBuffer(operation.config.image);\n        layers.push({\n          input: buffer,\n          ...operation.config.options,\n        });\n        break;\n      }\n\n      case \"watermarks\": {\n        const buffers = await Promise.all(\n          operation.configs.map((config) => this.resolveImageBuffer(config.image)),\n        );\n        operation.configs.forEach((config, index) => {\n          layers.push({\n            input: buffers[index],\n            ...config.options,\n          });\n        });\n        break;\n      }\n    }\n  }\n\n  /**\n   * Resolve an image input to a buffer\n   */\n  protected async resolveImageBuffer(input: ImageInput | Image): Promise<Buffer> {\n    if (input instanceof Image) {\n      // For Image instances, get buffer without applying options (raw buffer)\n      return input.image.toBuffer();\n    }\n\n    // For other inputs (path, buffer, etc.), create temp sharp instance\n    const tempImage = resolveSharp()(input);\n\n    return tempImage.toBuffer();\n  }\n\n  /**\n   * Apply format and quality options.\n   * If no format is explicitly set, preserves the original format and applies\n   * quality appropriately based on the format type.\n   */\n  protected async applyFormatAndQuality(image: sharp.Sharp): Promise<void> {\n    const { quality, format } = this.options;\n\n    if (format) {\n      // Explicit format specified\n      const formatOptions = quality ? { quality } : undefined;\n      image.toFormat(format, formatOptions);\n      return;\n    }\n\n    if (quality === undefined) {\n      // No quality or format set, nothing to apply\n      return;\n    }\n\n    // Quality is set but no format specified - detect original format\n    const metadata = await this.metadata();\n    const originalFormat = metadata.format;\n\n    if (!originalFormat) {\n      // Cannot detect format, default to webp with quality\n      image.webp({ quality });\n      return;\n    }\n\n    // Apply quality based on original format\n    if (Image.QUALITY_FORMATS.includes(originalFormat)) {\n      // Format supports quality option\n      image.toFormat(originalFormat as ImageFormat, { quality });\n    } else if (originalFormat === \"png\") {\n      // PNG uses compressionLevel (0-9) instead of quality\n      // Map quality 1-100 to compressionLevel 9-0 (higher quality = lower compression)\n      const compressionLevel = Math.round(9 - (quality / 100) * 9);\n      image.png({ compressionLevel });\n    } else if (originalFormat === \"gif\") {\n      // GIF doesn't support quality, just preserve format\n      image.gif();\n    }\n    // Unknown format: preserve as-is (no quality applied)\n  }\n\n  /**\n   * Save to file\n   */\n  public async save(path: string): Promise<sharp.OutputInfo> {\n    const image = await this.executePipeline();\n\n    return image.toFile(path);\n  }\n\n  /**\n   * Convert to webp and save to file\n   */\n  public async saveAsWebp(path: string): Promise<sharp.OutputInfo> {\n    // Override format to webp\n    this.options.format = \"webp\";\n    const image = await this.executePipeline();\n\n    return image.toFile(path);\n  }\n\n  /**\n   * Change the file format\n   */\n  public format(format: ImageFormat): this {\n    this.options.format = format;\n\n    return this;\n  }\n\n  /**\n   * Add watermark (deferred - executed at save time)\n   */\n  public watermark(image: ImageInput | Image, options: sharp.OverlayOptions = {}): this {\n    return this.addOperation({\n      type: \"watermark\",\n      config: { image, options },\n    });\n  }\n\n  /**\n   * Add multiple watermarks (deferred - executed at save time)\n   */\n  public watermarks(configs: WatermarkConfig[]): this {\n    return this.addOperation({\n      type: \"watermarks\",\n      configs,\n    });\n  }\n\n  /**\n   * Rotate image\n   */\n  public rotate(angle: number): this {\n    return this.addOperation({ type: \"rotate\", angle });\n  }\n\n  /**\n   * Flip image vertically (top to bottom)\n   */\n  public flip(): this {\n    return this.addOperation({ type: \"flip\" });\n  }\n\n  /**\n   * Flop image horizontally (left to right)\n   */\n  public flop(): this {\n    return this.addOperation({ type: \"flop\" });\n  }\n\n  /**\n   * Blur image\n   */\n  public blur(sigma: number): this {\n    if (sigma < 0.3) {\n      throw new Error(\"Blur sigma must be at least 0.3\");\n    }\n\n    return this.addOperation({ type: \"blur\", sigma });\n  }\n\n  /**\n   * Convert to base64\n   */\n  public async toBase64(): Promise<string> {\n    const image = await this.executePipeline();\n    const buffer = await image.toBuffer();\n\n    return buffer.toString(\"base64\");\n  }\n\n  /**\n   * Convert to data URL (base64 with mime type prefix)\n   */\n  public async toDataUrl(): Promise<string> {\n    const metadata = await this.metadata();\n    const format = this.options.format || metadata.format || \"png\";\n    const mimeType = `image/${format === \"jpg\" ? \"jpeg\" : format}`;\n    const base64 = await this.toBase64();\n\n    return `data:${mimeType};base64,${base64}`;\n  }\n\n  /**\n   * Sharpen image\n   */\n  public sharpen(options?: sharp.SharpenOptions): this {\n    return this.addOperation({ type: \"sharpen\", options });\n  }\n\n  /**\n   * Negate/invert image colors\n   */\n  public negate(options?: sharp.NegateOptions): this {\n    return this.addOperation({ type: \"negate\", options });\n  }\n\n  /**\n   * Tint image with a color\n   */\n  public tint(color: sharp.Color): this {\n    return this.addOperation({ type: \"tint\", color });\n  }\n\n  /**\n   * Trim edges from the image\n   */\n  public trim(options?: sharp.TrimOptions): this {\n    return this.addOperation({ type: \"trim\", options });\n  }\n\n  /**\n   * Convert to buffer\n   */\n  public async toBuffer(): Promise<Buffer> {\n    const image = await this.executePipeline();\n\n    return image.toBuffer();\n  }\n\n  /**\n   * Clone the image for separate transformations\n   */\n  public clone(): Image {\n    const clonedImage = new Image(this.image.clone());\n    clonedImage.options = { ...this.options };\n    clonedImage.operations = [...this.operations];\n    clonedImage.cachedMetadata = this.cachedMetadata ? { ...this.cachedMetadata } : null;\n\n    return clonedImage;\n  }\n\n  /**\n   * Get the current stored options\n   */\n  public getOptions(): Readonly<InternalOptions> {\n    return { ...this.options };\n  }\n\n  /**\n   * Get the pending operations count\n   */\n  public getPendingOperationsCount(): number {\n    return this.operations.length;\n  }\n\n  /**\n   * Reset all stored options\n   */\n  public resetOptions(): this {\n    this.options = {};\n\n    return this;\n  }\n\n  /**\n   * Clear all pending operations\n   */\n  public clearOperations(): this {\n    this.operations = [];\n    this.pipelineExecuted = false;\n\n    return this;\n  }\n\n  /**\n   * Reset the image to its initial state (clear operations and options)\n   */\n  public reset(): this {\n    this.operations = [];\n    this.options = {};\n    this.pipelineExecuted = false;\n    this.cachedMetadata = null;\n\n    return this;\n  }\n}\n"],"mappings":";;;;;;;AAYA,MAAM,6BAA6B;;;;;;;;;;;EAWjC,KAAK;;;;AAKP,IAAI,UAA+B;;;;AAKnC,IAAI,gBAAgB;;;;;;;;AASpB,IAAI,iBAA+B;AAUnC,MAAM,iBAAiB;;;;;;;;;;;AAYvB,SAAS,eAAe,OAAyB;CAC/C,IAAI,EAAE,iBAAiB,QAAQ,OAAO;CAEtC,OACG,MAAgC,SAAS,sBAC1C,MAAM,QAAQ,SAAS,4BAA4B;AAEvD;;;;;;;;;;;;;;;;;;;;AAqBA,SAAS,eAA6B;CACpC,IAAI,CAAC,eAAe;EAClB,gBAAgB;EAEhB,IAAI;GAEF,MAAM,SADU,cAAc,OAAO,KAAK,GACrB,CAAC,CAAC,OAAO;GAC9B,UAAW,OAAO,WAAW;EAC/B,SAAS,OAAO;GACd,UAAU;GAEV,IAAI,CAAC,eAAe,KAAK,GAKvB,iBAAiB,IAAI,eAAe,2BAA4B,MAAgB,WAAW,EACzF,OAAO,MACT,CAAC;EAEL;CACF;CAEA,IAAI,gBACF,MAAM;CAGR,IAAI,CAAC,SACH,MAAM,IAAI,MAAM,8BAA8B,4BAA4B;CAG5E,OAAO;AACT;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAgKA,IAAa,QAAb,MAAa,MAAM;;yBA6B2B;GAAC;GAAQ;GAAO;GAAQ;GAAQ;GAAQ;EAAM;;;;;CAK1F,AAAO,YAAY,OAAiC;iBA9Bf,CAAC;oBAKG,CAAC;wBAKQ;0BAKrB;EAkB3B,IAAI,iBAAiB,UAAU,WAAW,SAAS,OAAO,MAAM,UAAU,YACxE,KAAK,QAAQ;OAEb,KAAK,QAAQ,aAAa,CAAC,CAAC,KAAmB;CAEnD;;;;CAKA,OAAc,SAAS,MAAqB;EAC1C,OAAO,IAAI,MAAM,IAAI;CACvB;;;;CAKA,OAAc,WAAW,QAAuB;EAC9C,OAAO,IAAI,MAAM,MAAM;CACzB;;;;CAKA,aAAoB,QAAQ,KAA6B;EAEvD,MAAM,EAAE,QAAQ,IAAI,QAAQ,eAAe,MAAM,kBAAkB,GAAG;EAEtE,IAAI,CAAC,MAAM,OAAO,WAAW,GAC3B,MAAM,IAAI,MACR,kCAAkC,IAAI,KAAK,KAAK,4BAA4B,GAAG,OAAO,GAAG,cAC3F;EAGF,OAAO,IAAI,MAAM,MAAM;CACzB;;;;CAKA,AAAU,aAAa,WAAiC;EACtD,KAAK,WAAW,KAAK,SAAS;EAE9B,OAAO;CACT;;;;;;;;;CAUA,AAAO,MAAM,SAAsC;EAEjD,IAAI,QAAQ,QACV,KAAK,OAAO,QAAQ,MAAM;EAI5B,IAAI,QAAQ,MACV,KAAK,KAAK,QAAQ,IAAI;EAIxB,IAAI,QAAQ,WAAW,QACrB,KAAK,OAAO,QAAQ,MAAM;EAI5B,IAAI,QAAQ,MACV,KAAK,KAAK;EAGZ,IAAI,QAAQ,MACV,KAAK,KAAK;EAIZ,IAAI,QAAQ,iBAAiB,QAAQ,WACnC,KAAK,cAAc;EAIrB,IAAI,QAAQ,SAAS,QACnB,KAAK,KAAK,QAAQ,IAAI;EAIxB,IAAI,QAAQ,SAAS;GACnB,MAAM,iBAAiB,OAAO,QAAQ,YAAY,YAAY,SAAY,QAAQ;GAClF,KAAK,QAAQ,cAAc;EAC7B;EAGA,IAAI,QAAQ,MACV,KAAK,KAAK,QAAQ,IAAI;EAIxB,IAAI,QAAQ,QAAQ;GAClB,MAAM,gBAAgB,OAAO,QAAQ,WAAW,YAAY,SAAY,QAAQ;GAChF,KAAK,OAAO,aAAa;EAC3B;EAGA,IAAI,QAAQ,MAAM;GAChB,MAAM,cAAc,OAAO,QAAQ,SAAS,YAAY,SAAY,QAAQ;GAC5E,KAAK,KAAK,WAAW;EACvB;EAGA,IAAI,QAAQ,WACV,KAAK,UAAU,QAAQ,UAAU,OAAO,QAAQ,UAAU,OAAO;EAGnE,IAAI,QAAQ,YACV,KAAK,WAAW,QAAQ,UAAU;EAIpC,IAAI,QAAQ,YAAY,QACtB,KAAK,QAAQ,QAAQ,OAAO;EAI9B,IAAI,QAAQ,QACV,KAAK,OAAO,QAAQ,MAAM;EAG5B,IAAI,QAAQ,YAAY,QACtB,KAAK,QAAQ,QAAQ,OAAO;EAG9B,OAAO;CACT;;;;CAKA,AAAO,QAAQ,OAAqB;EAClC,IAAI,QAAQ,KAAK,QAAQ,KACvB,MAAM,IAAI,MAAM,mCAAmC;EAGrD,OAAO,KAAK,aAAa;GAAE,MAAM;GAAW;EAAM,CAAC;CACrD;;;;CAKA,AAAO,gBAAsB;EAC3B,OAAO,KAAK,aAAa,EAAE,MAAM,gBAAgB,CAAC;CACpD;;;;CAKA,AAAO,YAAkB;EACvB,OAAO,KAAK,cAAc;CAC5B;;;;CAKA,MAAa,aAGV;EACD,MAAM,WAAW,MAAM,KAAK,SAAS;EAErC,OAAO;GAAE,OAAO,SAAS;GAAO,QAAQ,SAAS;EAAO;CAC1D;;;;;;;CAQA,MAAa,WAAoC;EAC/C,IAAI,CAAC,KAAK,gBACR,KAAK,iBAAiB,MAAM,KAAK,MAAM,SAAS;EAGlD,OAAO,KAAK;CACd;;;;;;CAOA,MAAa,kBAA2C;EACtD,KAAK,iBAAiB,MAAM,KAAK,MAAM,SAAS;EAEhD,OAAO,KAAK;CACd;;;;CAKA,AAAO,qBAA2B;EAChC,KAAK,iBAAiB;EAEtB,OAAO;CACT;;;;CAKA,AAAO,OAAO,SAAoC;EAChD,IAAI,OAAO,QAAQ,UAAU,eAAe,CAAC,QAAQ,OACnD,OAAO,QAAQ;EAGjB,IAAI,OAAO,QAAQ,WAAW,eAAe,CAAC,QAAQ,QACpD,OAAO,QAAQ;EAGjB,OAAO,KAAK,aAAa;GAAE,MAAM;GAAU;EAAQ,CAAC;CACtD;;;;CAKA,AAAO,KAAK,SAA6B;EACvC,OAAO,KAAK,aAAa;GAAE,MAAM;GAAQ;EAAQ,CAAC;CACpD;;;;;;CAOA,AAAO,QAAQ,SAAuB;EACpC,IAAI,UAAU,KAAK,UAAU,KAC3B,MAAM,IAAI,MAAM,mCAAmC;EAGrD,KAAK,QAAQ,UAAU;EAEvB,OAAO;CACT;;;;CAKA,MAAgB,kBAAwC;EACtD,IAAI,KAAK,kBACP,OAAO,KAAK;EAKd,MAAM,SAAiC,CAAC;EAExC,KAAK,MAAM,aAAa,KAAK,YAC3B,MAAM,KAAK,iBAAiB,KAAK,OAAO,WAAW,MAAM;EAG3D,IAAI,OAAO,SAAS,GAClB,KAAK,MAAM,UAAU,MAAM;EAG7B,MAAM,KAAK,sBAAsB,KAAK,KAAK;EAE3C,KAAK,mBAAmB;EAExB,OAAO,KAAK;CACd;;;;CAKA,MAAgB,iBACd,OACA,WACA,SAAiC,CAAC,GACnB;EACf,QAAQ,UAAU,MAAlB;GACE,KAAK;IACH,MAAM,OAAO,UAAU,OAAO;IAC9B;GAEF,KAAK;IACH,MAAM,QAAQ,UAAU,OAAO;IAC/B;GAEF,KAAK;IACH,MAAM,OAAO,UAAU,KAAK;IAC5B;GAEF,KAAK;IACH,MAAM,KAAK;IACX;GAEF,KAAK;IACH,MAAM,KAAK;IACX;GAEF,KAAK;IACH,MAAM,KAAK,UAAU,KAAK;IAC1B;GAEF,KAAK;IACH,MAAM,QAAQ,UAAU,OAAO;IAC/B;GAEF,KAAK;IACH,MAAM,cAAc,KAAK;IACzB;GAEF,KAAK,WAAW;IACd,MAAM,QAAQ,KAAK,MAAO,UAAU,QAAQ,MAAO,GAAG;IACtD,MAAM,aAAa,OAAO,KAAK;KAAC;KAAK;KAAK;KAAK;IAAK,CAAC;IACrD,OAAO,KAAK;KACV,OAAO;KACP,OAAO;KACP,KAAK;MAAE,OAAO;MAAG,QAAQ;MAAG,UAAU;KAAE;KACxC,MAAM;IACR,CAAC;IACD;GACF;GAEA,KAAK;IACH,MAAM,OAAO,UAAU,OAAO;IAC9B;GAEF,KAAK;IACH,MAAM,KAAK,UAAU,KAAK;IAC1B;GAEF,KAAK;IACH,MAAM,KAAK,UAAU,OAAO;IAC5B;GAEF,KAAK,aAAa;IAChB,MAAM,SAAS,MAAM,KAAK,mBAAmB,UAAU,OAAO,KAAK;IACnE,OAAO,KAAK;KACV,OAAO;KACP,GAAG,UAAU,OAAO;IACtB,CAAC;IACD;GACF;GAEA,KAAK,cAAc;IACjB,MAAM,UAAU,MAAM,QAAQ,IAC5B,UAAU,QAAQ,KAAK,WAAW,KAAK,mBAAmB,OAAO,KAAK,CAAC,CACzE;IACA,UAAU,QAAQ,SAAS,QAAQ,UAAU;KAC3C,OAAO,KAAK;MACV,OAAO,QAAQ;MACf,GAAG,OAAO;KACZ,CAAC;IACH,CAAC;IACD;GACF;EACF;CACF;;;;CAKA,MAAgB,mBAAmB,OAA4C;EAC7E,IAAI,iBAAiB,OAEnB,OAAO,MAAM,MAAM,SAAS;EAM9B,OAFkB,aAAa,CAAC,CAAC,KAElB,CAAC,CAAC,SAAS;CAC5B;;;;;;CAOA,MAAgB,sBAAsB,OAAmC;EACvE,MAAM,EAAE,SAAS,WAAW,KAAK;EAEjC,IAAI,QAAQ;GAEV,MAAM,gBAAgB,UAAU,EAAE,QAAQ,IAAI;GAC9C,MAAM,SAAS,QAAQ,aAAa;GACpC;EACF;EAEA,IAAI,YAAY,QAEd;EAKF,MAAM,kBAAiB,MADA,KAAK,SAAS,EACN,CAAC;EAEhC,IAAI,CAAC,gBAAgB;GAEnB,MAAM,KAAK,EAAE,QAAQ,CAAC;GACtB;EACF;EAGA,IAAI,MAAM,gBAAgB,SAAS,cAAc,GAE/C,MAAM,SAAS,gBAA+B,EAAE,QAAQ,CAAC;OACpD,IAAI,mBAAmB,OAAO;GAGnC,MAAM,mBAAmB,KAAK,MAAM,IAAK,UAAU,MAAO,CAAC;GAC3D,MAAM,IAAI,EAAE,iBAAiB,CAAC;EAChC,OAAO,IAAI,mBAAmB,OAE5B,MAAM,IAAI;CAGd;;;;CAKA,MAAa,KAAK,MAAyC;EAGzD,QAAO,MAFa,KAAK,gBAAgB,EAE7B,CAAC,OAAO,IAAI;CAC1B;;;;CAKA,MAAa,WAAW,MAAyC;EAE/D,KAAK,QAAQ,SAAS;EAGtB,QAAO,MAFa,KAAK,gBAAgB,EAE7B,CAAC,OAAO,IAAI;CAC1B;;;;CAKA,AAAO,OAAO,QAA2B;EACvC,KAAK,QAAQ,SAAS;EAEtB,OAAO;CACT;;;;CAKA,AAAO,UAAU,OAA2B,UAAgC,CAAC,GAAS;EACpF,OAAO,KAAK,aAAa;GACvB,MAAM;GACN,QAAQ;IAAE;IAAO;GAAQ;EAC3B,CAAC;CACH;;;;CAKA,AAAO,WAAW,SAAkC;EAClD,OAAO,KAAK,aAAa;GACvB,MAAM;GACN;EACF,CAAC;CACH;;;;CAKA,AAAO,OAAO,OAAqB;EACjC,OAAO,KAAK,aAAa;GAAE,MAAM;GAAU;EAAM,CAAC;CACpD;;;;CAKA,AAAO,OAAa;EAClB,OAAO,KAAK,aAAa,EAAE,MAAM,OAAO,CAAC;CAC3C;;;;CAKA,AAAO,OAAa;EAClB,OAAO,KAAK,aAAa,EAAE,MAAM,OAAO,CAAC;CAC3C;;;;CAKA,AAAO,KAAK,OAAqB;EAC/B,IAAI,QAAQ,IACV,MAAM,IAAI,MAAM,iCAAiC;EAGnD,OAAO,KAAK,aAAa;GAAE,MAAM;GAAQ;EAAM,CAAC;CAClD;;;;CAKA,MAAa,WAA4B;EAIvC,QAAO,OAFc,MADD,KAAK,gBAAgB,EACf,CAAC,SAAS,EAEvB,CAAC,SAAS,QAAQ;CACjC;;;;CAKA,MAAa,YAA6B;EACxC,MAAM,WAAW,MAAM,KAAK,SAAS;EACrC,MAAM,SAAS,KAAK,QAAQ,UAAU,SAAS,UAAU;EAIzD,OAAO,QAAQ,SAHW,WAAW,QAAQ,SAAS,SAG9B,UAAU,MAFb,KAAK,SAAS;CAGrC;;;;CAKA,AAAO,QAAQ,SAAsC;EACnD,OAAO,KAAK,aAAa;GAAE,MAAM;GAAW;EAAQ,CAAC;CACvD;;;;CAKA,AAAO,OAAO,SAAqC;EACjD,OAAO,KAAK,aAAa;GAAE,MAAM;GAAU;EAAQ,CAAC;CACtD;;;;CAKA,AAAO,KAAK,OAA0B;EACpC,OAAO,KAAK,aAAa;GAAE,MAAM;GAAQ;EAAM,CAAC;CAClD;;;;CAKA,AAAO,KAAK,SAAmC;EAC7C,OAAO,KAAK,aAAa;GAAE,MAAM;GAAQ;EAAQ,CAAC;CACpD;;;;CAKA,MAAa,WAA4B;EAGvC,QAAO,MAFa,KAAK,gBAAgB,EAE7B,CAAC,SAAS;CACxB;;;;CAKA,AAAO,QAAe;EACpB,MAAM,cAAc,IAAI,MAAM,KAAK,MAAM,MAAM,CAAC;EAChD,YAAY,UAAU,EAAE,GAAG,KAAK,QAAQ;EACxC,YAAY,aAAa,CAAC,GAAG,KAAK,UAAU;EAC5C,YAAY,iBAAiB,KAAK,iBAAiB,EAAE,GAAG,KAAK,eAAe,IAAI;EAEhF,OAAO;CACT;;;;CAKA,AAAO,aAAwC;EAC7C,OAAO,EAAE,GAAG,KAAK,QAAQ;CAC3B;;;;CAKA,AAAO,4BAAoC;EACzC,OAAO,KAAK,WAAW;CACzB;;;;CAKA,AAAO,eAAqB;EAC1B,KAAK,UAAU,CAAC;EAEhB,OAAO;CACT;;;;CAKA,AAAO,kBAAwB;EAC7B,KAAK,aAAa,CAAC;EACnB,KAAK,mBAAmB;EAExB,OAAO;CACT;;;;CAKA,AAAO,QAAc;EACnB,KAAK,aAAa,CAAC;EACnB,KAAK,UAAU,CAAC;EAChB,KAAK,mBAAmB;EACxB,KAAK,iBAAiB;EAEtB,OAAO;CACT;AACF"}
+{"version":3,"file":"image.mjs","names":[],"sources":["../../../../../../../../packages/core/src/image/image.ts"],"sourcesContent":["import { createRequire } from \"node:module\";\nimport type sharp from \"sharp\";\nimport type { FormatEnum } from \"sharp\";\nimport { safeFetchToBuffer } from \"../storage/utils/safe-fetch\";\n\n// ============================================================\n// Lazily Resolved Sharp Module\n// ============================================================\n\n/**\n * Installation instructions for sharp\n */\nconst SHARP_INSTALL_INSTRUCTIONS = `\nImage processing requires the sharp package.\nInstall it with:\n\n  warlock add image\n\nOr manually:\n\n  npm install sharp\n  pnpm add sharp\n  yarn add sharp\n`.trim();\n\n/**\n * Cached sharp function, populated by the first `resolveSharp()` call\n */\nlet sharpFn: typeof sharp | null = null;\n\n/**\n * Whether the resolution attempt already ran (success or failure)\n */\nlet sharpResolved = false;\n\n/**\n * Why the resolution failed, when it failed for a reason other than absence.\n *\n * Cached and re-thrown on every later call: the resolution attempt runs exactly\n * once, so without this the second construction would fall through to the\n * \"not installed\" branch and report a different, wrong cause.\n */\nlet sharpLoadError: Error | null = null;\n\n/**\n * `new Error(message, { cause })` is ES2022, and this package still compiles\n * against the ES2020 lib (see #16), where `Error` is typed as taking a message\n * only. Node has supported the option since v16, so this is the type layer\n * catching up with the runtime, not a change in what the code does.\n */\ntype ErrorWithCauseConstructor = new (message: string, options: { cause: unknown }) => Error;\n\nconst ErrorWithCause = Error as ErrorWithCauseConstructor;\n\n/**\n * Whether `error` says sharp itself is absent, as opposed to present but broken.\n *\n * Both halves are load-bearing. `MODULE_NOT_FOUND` alone is not enough: a\n * dependency missing *inside* sharp raises the very same code (`Cannot find\n * module 'color'`), and treating that as absence would tell the operator to\n * install a package they already have. So the message has to name the specifier\n * `'sharp'` exactly — quoted, which is also what keeps `'sharp-cli'` and friends\n * from matching.\n */\nfunction isSharpMissing(error: unknown): boolean {\n  if (!(error instanceof Error)) return false;\n\n  return (\n    (error as NodeJS.ErrnoException).code === \"MODULE_NOT_FOUND\" &&\n    error.message.includes(\"Cannot find module 'sharp'\")\n  );\n}\n\n/**\n * Resolve sharp synchronously, on first use.\n *\n * Resolution is deliberately *lazy* and *synchronous*:\n *\n * - Lazy, because a top-level require would drag sharp's native binary into\n *   every `import \"@warlock.js/core\"`, including apps that never touch images.\n * - Synchronous, because the `Image` constructor is synchronous. An async\n *   import kicked off at module load leaves a window in which the module is\n *   neither loaded nor known to be missing, and a constructor running inside\n *   that window has no correct answer to give.\n *\n * `createRequire` gives an ESM-safe `require`, and the outcome — module, absence\n * or load failure — is cached, so the resolution runs exactly once per process.\n * The failure *reason* is cached too, not just the fact of it: every call after\n * a failed load has to report the same cause as the first one.\n *\n * @throws when sharp is not installed, or is installed but cannot be loaded\n */\nfunction resolveSharp(): typeof sharp {\n  if (!sharpResolved) {\n    sharpResolved = true;\n\n    try {\n      const require = createRequire(import.meta.url);\n      const module = require(\"sharp\");\n      sharpFn = (module.default ?? module) as typeof sharp;\n    } catch (error) {\n      sharpFn = null;\n\n      if (!isSharpMissing(error)) {\n        // sharp is there, it just would not load — almost always a binary built\n        // for another platform. Its own error names the runtime and the fix, so\n        // it is inlined *and* chained: a terminal that never prints `cause`\n        // must still show the text that actually helps.\n        sharpLoadError = new ErrorWithCause(`Failed to load \"sharp\": ${(error as Error).message}`, {\n          cause: error,\n        });\n      }\n    }\n  }\n\n  if (sharpLoadError) {\n    throw sharpLoadError;\n  }\n\n  if (!sharpFn) {\n    throw new Error(`sharp is not installed.\\n\\n${SHARP_INSTALL_INSTRUCTIONS}`);\n  }\n\n  return sharpFn;\n}\n\n// ============================================================\n// Types\n// ============================================================\n\nexport type ImageFormat = keyof FormatEnum;\n\nexport type ImageInput = string | Buffer | Uint8Array | ArrayBuffer;\n\n/**\n * Watermark configuration for deferred execution\n */\nexport type WatermarkConfig = {\n  image: ImageInput | Image;\n  options: sharp.OverlayOptions;\n};\n\n/**\n * Operation descriptor for deferred pipeline execution.\n * All operations are stored and executed at save/toBuffer time.\n */\ntype ImageOperation =\n  | { type: \"resize\"; options: sharp.ResizeOptions }\n  | { type: \"crop\"; options: sharp.Region }\n  | { type: \"rotate\"; angle: number }\n  | { type: \"flip\" }\n  | { type: \"flop\" }\n  | { type: \"blur\"; sigma: number }\n  | { type: \"sharpen\"; options?: sharp.SharpenOptions }\n  | { type: \"blackAndWhite\" }\n  | { type: \"opacity\"; value: number }\n  | { type: \"negate\"; options?: sharp.NegateOptions }\n  | { type: \"tint\"; color: sharp.Color }\n  | { type: \"trim\"; options?: sharp.TrimOptions }\n  | { type: \"watermark\"; config: WatermarkConfig }\n  | { type: \"watermarks\"; configs: WatermarkConfig[] };\n\n/**\n * Transformation options that can be applied in batch via `apply()` method.\n *\n * **Execution Order (when using apply()):**\n * 1. resize - Resize first to work with correct dimensions\n * 2. crop - Crop after resize to extract the desired region\n * 3. rotate - Rotation after sizing\n * 4. flip/flop - Mirror operations\n * 5. blackAndWhite/grayscale - Color space conversion\n * 6. blur - Blur effect\n * 7. sharpen - Sharpen effect\n * 8. tint - Color overlay\n * 9. negate - Invert colors\n * 10. opacity - Transparency (applied via composite)\n * 11. format/quality - Applied on save/export\n */\nexport type ImageTransformOptions = {\n  /**\n   * Output quality (1-100), applied based on final format\n   */\n  quality?: number;\n  /**\n   * Output format (jpeg, png, webp, avif, etc.)\n   */\n  format?: ImageFormat;\n  /**\n   * Resize options\n   */\n  resize?: sharp.ResizeOptions;\n  /**\n   * Crop/extract region\n   */\n  crop?: sharp.Region;\n  /**\n   * Rotation angle in degrees\n   */\n  rotate?: number;\n  /**\n   * Flip vertically (top to bottom)\n   */\n  flip?: boolean;\n  /**\n   * Flop horizontally (left to right)\n   */\n  flop?: boolean;\n  /**\n   * Convert to black and white\n   */\n  blackAndWhite?: boolean;\n  /**\n   * Alias for blackAndWhite\n   */\n  grayscale?: boolean;\n  /**\n   * Blur sigma (must be >= 0.3)\n   */\n  blur?: number;\n  /**\n   * Sharpen options\n   */\n  sharpen?: sharp.SharpenOptions | boolean;\n  /**\n   * Tint color\n   */\n  tint?: sharp.Color;\n  /**\n   * Negate/invert colors\n   */\n  negate?: sharp.NegateOptions | boolean;\n  /**\n   * Opacity (0-100)\n   */\n  opacity?: number;\n  /**\n   * Trim options\n   */\n  trim?: sharp.TrimOptions | boolean;\n  /**\n   * Single watermark\n   */\n  watermark?: WatermarkConfig;\n  /**\n   * Multiple watermarks\n   */\n  watermarks?: WatermarkConfig[];\n};\n\n/**\n * Internal options stored for deferred application\n */\ntype InternalOptions = {\n  quality?: number;\n  format?: ImageFormat;\n};\n\n/**\n * Image manipulation class with deferred pipeline execution.\n *\n * **Important:** This class requires the `sharp` package to be installed.\n * Install it with: `warlock add image` or `npm install sharp`\n *\n * Sharp is resolved synchronously on the first construction that needs it, so\n * the constructor and all chainable methods remain synchronous, and a missing\n * sharp throws at construction rather than at some later await.\n *\n * All operations are synchronous and stored as descriptors.\n * The pipeline is executed only when calling output methods:\n * - `save()` - Save to file\n * - `toBuffer()` - Get as buffer\n * - `toBase64()` - Get as base64 string\n * - `toDataUrl()` - Get as data URL\n *\n * @example\n * ```typescript\n * // All chaining is synchronous - single await at the end\n * await new Image(\"photo.jpg\")\n *   .resize({ width: 800 })\n *   .watermark(\"logo.png\", { gravity: \"southeast\" })\n *   .quality(85)\n *   .save(\"output.jpg\");\n * ```\n */\nexport class Image {\n  /**\n   * Image options that will be applied on save/export\n   */\n  protected options: InternalOptions = {};\n\n  /**\n   * Deferred operations pipeline\n   */\n  protected operations: ImageOperation[] = [];\n\n  /**\n   * Cached metadata to avoid repeated async calls\n   */\n  protected cachedMetadata: sharp.Metadata | null = null;\n\n  /**\n   * Whether the pipeline has been executed\n   */\n  protected pipelineExecuted = false;\n\n  /**\n   * Sharp image object\n   */\n  public readonly image: sharp.Sharp;\n\n  /**\n   * Formats that support quality option\n   */\n  protected static readonly QUALITY_FORMATS = [\"jpeg\", \"jpg\", \"webp\", \"avif\", \"tiff\", \"heif\"];\n\n  /**\n   * Constructor\n   */\n  public constructor(image: ImageInput | sharp.Sharp) {\n    // An existing sharp instance carries its own module — short-circuit before\n    // resolving sharp, so cloning never pays for (or fails on) a module load.\n    if (image instanceof Object && \"clone\" in image && typeof image.clone === \"function\") {\n      this.image = image as sharp.Sharp;\n    } else {\n      this.image = resolveSharp()(image as ImageInput);\n    }\n  }\n\n  /**\n   * Create image instance from file path\n   */\n  public static fromFile(path: string): Image {\n    return new Image(path);\n  }\n\n  /**\n   * Create image instance from buffer\n   */\n  public static fromBuffer(buffer: Buffer): Image {\n    return new Image(buffer);\n  }\n\n  /**\n   * Create image instance from url\n   */\n  public static async fromUrl(url: string): Promise<Image> {\n    // SSRF-guarded: scheme allowlist, private-IP deny (incl. redirects), size cap, timeout\n    const { buffer, ok, status, statusText } = await safeFetchToBuffer(url);\n\n    if (!ok || buffer.length === 0) {\n      throw new Error(\n        `Failed to load image from URL \"${url}\": ${ok ? \"Empty response received\" : `${status} ${statusText}`}`,\n      );\n    }\n\n    return new Image(buffer);\n  }\n\n  /**\n   * Add an operation to the deferred pipeline\n   */\n  protected addOperation(operation: ImageOperation): this {\n    this.operations.push(operation);\n\n    return this;\n  }\n\n  /**\n   * Apply multiple transformations at once with a predefined execution order.\n   *\n   * This method ensures transformations are applied in a logical order:\n   * resize → crop → rotate → flip/flop → colorspace → effects → opacity → format\n   *\n   * For custom ordering, use individual chained methods instead.\n   */\n  public apply(options: ImageTransformOptions): this {\n    // 1. Resize first to work with correct dimensions\n    if (options.resize) {\n      this.resize(options.resize);\n    }\n\n    // 2. Crop after resize\n    if (options.crop) {\n      this.crop(options.crop);\n    }\n\n    // 3. Rotation\n    if (options.rotate !== undefined) {\n      this.rotate(options.rotate);\n    }\n\n    // 4. Mirror operations\n    if (options.flip) {\n      this.flip();\n    }\n\n    if (options.flop) {\n      this.flop();\n    }\n\n    // 5. Color space conversion\n    if (options.blackAndWhite || options.grayscale) {\n      this.blackAndWhite();\n    }\n\n    // 6. Blur effect\n    if (options.blur !== undefined) {\n      this.blur(options.blur);\n    }\n\n    // 7. Sharpen effect\n    if (options.sharpen) {\n      const sharpenOptions = typeof options.sharpen === \"boolean\" ? undefined : options.sharpen;\n      this.sharpen(sharpenOptions);\n    }\n\n    // 8. Tint color\n    if (options.tint) {\n      this.tint(options.tint);\n    }\n\n    // 9. Negate/invert\n    if (options.negate) {\n      const negateOptions = typeof options.negate === \"boolean\" ? undefined : options.negate;\n      this.negate(negateOptions);\n    }\n\n    // 10. Trim edges\n    if (options.trim) {\n      const trimOptions = typeof options.trim === \"boolean\" ? undefined : options.trim;\n      this.trim(trimOptions);\n    }\n\n    // 11. Watermarks\n    if (options.watermark) {\n      this.watermark(options.watermark.image, options.watermark.options);\n    }\n\n    if (options.watermarks) {\n      this.watermarks(options.watermarks);\n    }\n\n    // 12. Opacity (applied via composite)\n    if (options.opacity !== undefined) {\n      this.opacity(options.opacity);\n    }\n\n    // 13. Store format/quality for deferred application\n    if (options.format) {\n      this.format(options.format);\n    }\n\n    if (options.quality !== undefined) {\n      this.quality(options.quality);\n    }\n\n    return this;\n  }\n\n  /**\n   * Set image opacity (0-100)\n   */\n  public opacity(value: number): this {\n    if (value < 0 || value > 100) {\n      throw new Error(\"Opacity must be between 0 and 100\");\n    }\n\n    return this.addOperation({ type: \"opacity\", value });\n  }\n\n  /**\n   * Convert image to black and white\n   */\n  public blackAndWhite(): this {\n    return this.addOperation({ type: \"blackAndWhite\" });\n  }\n\n  /**\n   * Alias for blackAndWhite\n   */\n  public grayscale(): this {\n    return this.blackAndWhite();\n  }\n\n  /**\n   * Get image dimensions (cached after first call)\n   */\n  public async dimensions(): Promise<{\n    width: number | undefined;\n    height: number | undefined;\n  }> {\n    const metadata = await this.metadata();\n\n    return { width: metadata.width, height: metadata.height };\n  }\n\n  /**\n   * Get image metadata (cached after first call)\n   *\n   * The metadata is cached to avoid repeated async operations.\n   * Use `refreshMetadata()` to force a fresh fetch.\n   */\n  public async metadata(): Promise<sharp.Metadata> {\n    if (!this.cachedMetadata) {\n      this.cachedMetadata = await this.image.metadata();\n    }\n\n    return this.cachedMetadata;\n  }\n\n  /**\n   * Force refresh of cached metadata\n   *\n   * Call this after transformations if you need updated metadata.\n   */\n  public async refreshMetadata(): Promise<sharp.Metadata> {\n    this.cachedMetadata = await this.image.metadata();\n\n    return this.cachedMetadata;\n  }\n\n  /**\n   * Clear cached metadata\n   */\n  public clearMetadataCache(): this {\n    this.cachedMetadata = null;\n\n    return this;\n  }\n\n  /**\n   * Resize image\n   */\n  public resize(options: sharp.ResizeOptions): this {\n    if (typeof options.width !== \"undefined\" && !options.width) {\n      delete options.width;\n    }\n\n    if (typeof options.height !== \"undefined\" && !options.height) {\n      delete options.height;\n    }\n\n    return this.addOperation({ type: \"resize\", options });\n  }\n\n  /**\n   * Crop/extract a region from the image\n   */\n  public crop(options: sharp.Region): this {\n    return this.addOperation({ type: \"crop\", options });\n  }\n\n  /**\n   * Set image quality (1-100)\n   * Quality is stored and applied when saving/exporting\n   * based on the final format.\n   */\n  public quality(quality: number): this {\n    if (quality < 1 || quality > 100) {\n      throw new Error(\"Quality must be between 1 and 100\");\n    }\n\n    this.options.quality = quality;\n\n    return this;\n  }\n\n  /**\n   * Execute the deferred pipeline - apply all stored operations\n   */\n  protected async executePipeline(): Promise<sharp.Sharp> {\n    if (this.pipelineExecuted) {\n      return this.image;\n    }\n\n    // sharp's composite() REPLACES the previous list, so every layer is\n    // collected and applied in a single call, in operation order.\n    const layers: sharp.OverlayOptions[] = [];\n\n    for (const operation of this.operations) {\n      await this.executeOperation(this.image, operation, layers);\n    }\n\n    if (layers.length > 0) {\n      this.image.composite(layers);\n    }\n\n    await this.applyFormatAndQuality(this.image);\n\n    this.pipelineExecuted = true;\n\n    return this.image;\n  }\n\n  /**\n   * Execute a single operation\n   */\n  protected async executeOperation(\n    image: sharp.Sharp,\n    operation: ImageOperation,\n    layers: sharp.OverlayOptions[] = [],\n  ): Promise<void> {\n    switch (operation.type) {\n      case \"resize\":\n        image.resize(operation.options);\n        break;\n\n      case \"crop\":\n        image.extract(operation.options);\n        break;\n\n      case \"rotate\":\n        image.rotate(operation.angle);\n        break;\n\n      case \"flip\":\n        image.flip();\n        break;\n\n      case \"flop\":\n        image.flop();\n        break;\n\n      case \"blur\":\n        image.blur(operation.sigma);\n        break;\n\n      case \"sharpen\":\n        image.sharpen(operation.options);\n        break;\n\n      case \"blackAndWhite\":\n        image.toColourspace(\"b-w\");\n        break;\n\n      case \"opacity\": {\n        const alpha = Math.round((operation.value / 100) * 255);\n        const alphaPixel = Buffer.from([255, 255, 255, alpha]);\n        layers.push({\n          blend: \"dest-in\",\n          input: alphaPixel,\n          raw: { width: 1, height: 1, channels: 4 },\n          tile: true,\n        });\n        break;\n      }\n\n      case \"negate\":\n        image.negate(operation.options);\n        break;\n\n      case \"tint\":\n        image.tint(operation.color);\n        break;\n\n      case \"trim\":\n        image.trim(operation.options);\n        break;\n\n      case \"watermark\": {\n        const buffer = await this.resolveImageBuffer(operation.config.image);\n        layers.push({\n          input: buffer,\n          ...operation.config.options,\n        });\n        break;\n      }\n\n      case \"watermarks\": {\n        const buffers = await Promise.all(\n          operation.configs.map((config) => this.resolveImageBuffer(config.image)),\n        );\n        operation.configs.forEach((config, index) => {\n          layers.push({\n            input: buffers[index],\n            ...config.options,\n          });\n        });\n        break;\n      }\n    }\n  }\n\n  /**\n   * Resolve an image input to a buffer\n   */\n  protected async resolveImageBuffer(input: ImageInput | Image): Promise<Buffer> {\n    if (input instanceof Image) {\n      // For Image instances, get buffer without applying options (raw buffer)\n      return input.image.toBuffer();\n    }\n\n    // For other inputs (path, buffer, etc.), create temp sharp instance\n    const tempImage = resolveSharp()(input);\n\n    return tempImage.toBuffer();\n  }\n\n  /**\n   * Apply format and quality options.\n   * If no format is explicitly set, preserves the original format and applies\n   * quality appropriately based on the format type.\n   */\n  protected async applyFormatAndQuality(image: sharp.Sharp): Promise<void> {\n    const { quality, format } = this.options;\n\n    if (format) {\n      // Explicit format specified\n      const formatOptions = quality ? { quality } : undefined;\n      image.toFormat(format, formatOptions);\n      return;\n    }\n\n    if (quality === undefined) {\n      // No quality or format set, nothing to apply\n      return;\n    }\n\n    // Quality is set but no format specified - detect original format\n    const metadata = await this.metadata();\n    const originalFormat = metadata.format;\n\n    if (!originalFormat) {\n      // Cannot detect format, default to webp with quality\n      image.webp({ quality });\n      return;\n    }\n\n    // Apply quality based on original format\n    if (Image.QUALITY_FORMATS.includes(originalFormat)) {\n      // Format supports quality option\n      image.toFormat(originalFormat as ImageFormat, { quality });\n    } else if (originalFormat === \"png\") {\n      // PNG uses compressionLevel (0-9) instead of quality\n      // Map quality 1-100 to compressionLevel 9-0 (higher quality = lower compression)\n      const compressionLevel = Math.round(9 - (quality / 100) * 9);\n      image.png({ compressionLevel });\n    } else if (originalFormat === \"gif\") {\n      // GIF doesn't support quality, just preserve format\n      image.gif();\n    }\n    // Unknown format: preserve as-is (no quality applied)\n  }\n\n  /**\n   * Save to file\n   */\n  public async save(path: string): Promise<sharp.OutputInfo> {\n    const image = await this.executePipeline();\n\n    return image.toFile(path);\n  }\n\n  /**\n   * Convert to webp and save to file\n   */\n  public async saveAsWebp(path: string): Promise<sharp.OutputInfo> {\n    // Override format to webp\n    this.options.format = \"webp\";\n    const image = await this.executePipeline();\n\n    return image.toFile(path);\n  }\n\n  /**\n   * Change the file format\n   */\n  public format(format: ImageFormat): this {\n    this.options.format = format;\n\n    return this;\n  }\n\n  /**\n   * Add watermark (deferred - executed at save time)\n   */\n  public watermark(image: ImageInput | Image, options: sharp.OverlayOptions = {}): this {\n    return this.addOperation({\n      type: \"watermark\",\n      config: { image, options },\n    });\n  }\n\n  /**\n   * Add multiple watermarks (deferred - executed at save time)\n   */\n  public watermarks(configs: WatermarkConfig[]): this {\n    return this.addOperation({\n      type: \"watermarks\",\n      configs,\n    });\n  }\n\n  /**\n   * Rotate image\n   */\n  public rotate(angle: number): this {\n    return this.addOperation({ type: \"rotate\", angle });\n  }\n\n  /**\n   * Flip image vertically (top to bottom)\n   */\n  public flip(): this {\n    return this.addOperation({ type: \"flip\" });\n  }\n\n  /**\n   * Flop image horizontally (left to right)\n   */\n  public flop(): this {\n    return this.addOperation({ type: \"flop\" });\n  }\n\n  /**\n   * Blur image\n   */\n  public blur(sigma: number): this {\n    if (sigma < 0.3) {\n      throw new Error(\"Blur sigma must be at least 0.3\");\n    }\n\n    return this.addOperation({ type: \"blur\", sigma });\n  }\n\n  /**\n   * Convert to base64\n   */\n  public async toBase64(): Promise<string> {\n    const image = await this.executePipeline();\n    const buffer = await image.toBuffer();\n\n    return buffer.toString(\"base64\");\n  }\n\n  /**\n   * Convert to data URL (base64 with mime type prefix)\n   */\n  public async toDataUrl(): Promise<string> {\n    const metadata = await this.metadata();\n    const format = this.options.format || metadata.format || \"png\";\n    const mimeType = `image/${format === \"jpg\" ? \"jpeg\" : format}`;\n    const base64 = await this.toBase64();\n\n    return `data:${mimeType};base64,${base64}`;\n  }\n\n  /**\n   * Sharpen image\n   */\n  public sharpen(options?: sharp.SharpenOptions): this {\n    return this.addOperation({ type: \"sharpen\", options });\n  }\n\n  /**\n   * Negate/invert image colors\n   */\n  public negate(options?: sharp.NegateOptions): this {\n    return this.addOperation({ type: \"negate\", options });\n  }\n\n  /**\n   * Tint image with a color\n   */\n  public tint(color: sharp.Color): this {\n    return this.addOperation({ type: \"tint\", color });\n  }\n\n  /**\n   * Trim edges from the image\n   */\n  public trim(options?: sharp.TrimOptions): this {\n    return this.addOperation({ type: \"trim\", options });\n  }\n\n  /**\n   * Convert to buffer\n   */\n  public async toBuffer(): Promise<Buffer> {\n    const image = await this.executePipeline();\n\n    return image.toBuffer();\n  }\n\n  /**\n   * Clone the image for separate transformations\n   */\n  public clone(): Image {\n    const clonedImage = new Image(this.image.clone());\n    clonedImage.options = { ...this.options };\n    clonedImage.operations = [...this.operations];\n    clonedImage.cachedMetadata = this.cachedMetadata ? { ...this.cachedMetadata } : null;\n\n    return clonedImage;\n  }\n\n  /**\n   * Get the current stored options\n   */\n  public getOptions(): Readonly<InternalOptions> {\n    return { ...this.options };\n  }\n\n  /**\n   * Get the pending operations count\n   */\n  public getPendingOperationsCount(): number {\n    return this.operations.length;\n  }\n\n  /**\n   * Reset all stored options\n   */\n  public resetOptions(): this {\n    this.options = {};\n\n    return this;\n  }\n\n  /**\n   * Clear all pending operations\n   */\n  public clearOperations(): this {\n    this.operations = [];\n    this.pipelineExecuted = false;\n\n    return this;\n  }\n\n  /**\n   * Reset the image to its initial state (clear operations and options)\n   */\n  public reset(): this {\n    this.operations = [];\n    this.options = {};\n    this.pipelineExecuted = false;\n    this.cachedMetadata = null;\n\n    return this;\n  }\n}\n"],"mappings":";;;;;;;AAYA,MAAM,6BAA6B;;;;;;;;;;;EAWjC,KAAK;;;;AAKP,IAAI,UAA+B;;;;AAKnC,IAAI,gBAAgB;;;;;;;;AASpB,IAAI,iBAA+B;AAUnC,MAAM,iBAAiB;;;;;;;;;;;AAYvB,SAAS,eAAe,OAAyB;CAC/C,IAAI,EAAE,iBAAiB,QAAQ,OAAO;CAEtC,OACG,MAAgC,SAAS,sBAC1C,MAAM,QAAQ,SAAS,4BAA4B;AAEvD;;;;;;;;;;;;;;;;;;;;AAqBA,SAAS,eAA6B;CACpC,IAAI,CAAC,eAAe;EAClB,gBAAgB;EAEhB,IAAI;GAEF,MAAM,SADU,cAAc,YAAY,GACrB,CAAC,CAAC,OAAO;GAC9B,UAAW,OAAO,WAAW;EAC/B,SAAS,OAAO;GACd,UAAU;GAEV,IAAI,CAAC,eAAe,KAAK,GAKvB,iBAAiB,IAAI,eAAe,2BAA4B,MAAgB,WAAW,EACzF,OAAO,MACT,CAAC;EAEL;CACF;CAEA,IAAI,gBACF,MAAM;CAGR,IAAI,CAAC,SACH,MAAM,IAAI,MAAM,8BAA8B,4BAA4B;CAG5E,OAAO;AACT;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAgKA,IAAa,QAAb,MAAa,MAAM;;yBA6B2B;GAAC;GAAQ;GAAO;GAAQ;GAAQ;GAAQ;EAAM;;;;;CAK1F,AAAO,YAAY,OAAiC;iBA9Bf,CAAC;oBAKG,CAAC;wBAKQ;0BAKrB;EAkB3B,IAAI,iBAAiB,UAAU,WAAW,SAAS,OAAO,MAAM,UAAU,YACxE,KAAK,QAAQ;OAEb,KAAK,QAAQ,aAAa,CAAC,CAAC,KAAmB;CAEnD;;;;CAKA,OAAc,SAAS,MAAqB;EAC1C,OAAO,IAAI,MAAM,IAAI;CACvB;;;;CAKA,OAAc,WAAW,QAAuB;EAC9C,OAAO,IAAI,MAAM,MAAM;CACzB;;;;CAKA,aAAoB,QAAQ,KAA6B;EAEvD,MAAM,EAAE,QAAQ,IAAI,QAAQ,eAAe,MAAM,kBAAkB,GAAG;EAEtE,IAAI,CAAC,MAAM,OAAO,WAAW,GAC3B,MAAM,IAAI,MACR,kCAAkC,IAAI,KAAK,KAAK,4BAA4B,GAAG,OAAO,GAAG,cAC3F;EAGF,OAAO,IAAI,MAAM,MAAM;CACzB;;;;CAKA,AAAU,aAAa,WAAiC;EACtD,KAAK,WAAW,KAAK,SAAS;EAE9B,OAAO;CACT;;;;;;;;;CAUA,AAAO,MAAM,SAAsC;EAEjD,IAAI,QAAQ,QACV,KAAK,OAAO,QAAQ,MAAM;EAI5B,IAAI,QAAQ,MACV,KAAK,KAAK,QAAQ,IAAI;EAIxB,IAAI,QAAQ,WAAW,QACrB,KAAK,OAAO,QAAQ,MAAM;EAI5B,IAAI,QAAQ,MACV,KAAK,KAAK;EAGZ,IAAI,QAAQ,MACV,KAAK,KAAK;EAIZ,IAAI,QAAQ,iBAAiB,QAAQ,WACnC,KAAK,cAAc;EAIrB,IAAI,QAAQ,SAAS,QACnB,KAAK,KAAK,QAAQ,IAAI;EAIxB,IAAI,QAAQ,SAAS;GACnB,MAAM,iBAAiB,OAAO,QAAQ,YAAY,YAAY,SAAY,QAAQ;GAClF,KAAK,QAAQ,cAAc;EAC7B;EAGA,IAAI,QAAQ,MACV,KAAK,KAAK,QAAQ,IAAI;EAIxB,IAAI,QAAQ,QAAQ;GAClB,MAAM,gBAAgB,OAAO,QAAQ,WAAW,YAAY,SAAY,QAAQ;GAChF,KAAK,OAAO,aAAa;EAC3B;EAGA,IAAI,QAAQ,MAAM;GAChB,MAAM,cAAc,OAAO,QAAQ,SAAS,YAAY,SAAY,QAAQ;GAC5E,KAAK,KAAK,WAAW;EACvB;EAGA,IAAI,QAAQ,WACV,KAAK,UAAU,QAAQ,UAAU,OAAO,QAAQ,UAAU,OAAO;EAGnE,IAAI,QAAQ,YACV,KAAK,WAAW,QAAQ,UAAU;EAIpC,IAAI,QAAQ,YAAY,QACtB,KAAK,QAAQ,QAAQ,OAAO;EAI9B,IAAI,QAAQ,QACV,KAAK,OAAO,QAAQ,MAAM;EAG5B,IAAI,QAAQ,YAAY,QACtB,KAAK,QAAQ,QAAQ,OAAO;EAG9B,OAAO;CACT;;;;CAKA,AAAO,QAAQ,OAAqB;EAClC,IAAI,QAAQ,KAAK,QAAQ,KACvB,MAAM,IAAI,MAAM,mCAAmC;EAGrD,OAAO,KAAK,aAAa;GAAE,MAAM;GAAW;EAAM,CAAC;CACrD;;;;CAKA,AAAO,gBAAsB;EAC3B,OAAO,KAAK,aAAa,EAAE,MAAM,gBAAgB,CAAC;CACpD;;;;CAKA,AAAO,YAAkB;EACvB,OAAO,KAAK,cAAc;CAC5B;;;;CAKA,MAAa,aAGV;EACD,MAAM,WAAW,MAAM,KAAK,SAAS;EAErC,OAAO;GAAE,OAAO,SAAS;GAAO,QAAQ,SAAS;EAAO;CAC1D;;;;;;;CAQA,MAAa,WAAoC;EAC/C,IAAI,CAAC,KAAK,gBACR,KAAK,iBAAiB,MAAM,KAAK,MAAM,SAAS;EAGlD,OAAO,KAAK;CACd;;;;;;CAOA,MAAa,kBAA2C;EACtD,KAAK,iBAAiB,MAAM,KAAK,MAAM,SAAS;EAEhD,OAAO,KAAK;CACd;;;;CAKA,AAAO,qBAA2B;EAChC,KAAK,iBAAiB;EAEtB,OAAO;CACT;;;;CAKA,AAAO,OAAO,SAAoC;EAChD,IAAI,OAAO,QAAQ,UAAU,eAAe,CAAC,QAAQ,OACnD,OAAO,QAAQ;EAGjB,IAAI,OAAO,QAAQ,WAAW,eAAe,CAAC,QAAQ,QACpD,OAAO,QAAQ;EAGjB,OAAO,KAAK,aAAa;GAAE,MAAM;GAAU;EAAQ,CAAC;CACtD;;;;CAKA,AAAO,KAAK,SAA6B;EACvC,OAAO,KAAK,aAAa;GAAE,MAAM;GAAQ;EAAQ,CAAC;CACpD;;;;;;CAOA,AAAO,QAAQ,SAAuB;EACpC,IAAI,UAAU,KAAK,UAAU,KAC3B,MAAM,IAAI,MAAM,mCAAmC;EAGrD,KAAK,QAAQ,UAAU;EAEvB,OAAO;CACT;;;;CAKA,MAAgB,kBAAwC;EACtD,IAAI,KAAK,kBACP,OAAO,KAAK;EAKd,MAAM,SAAiC,CAAC;EAExC,KAAK,MAAM,aAAa,KAAK,YAC3B,MAAM,KAAK,iBAAiB,KAAK,OAAO,WAAW,MAAM;EAG3D,IAAI,OAAO,SAAS,GAClB,KAAK,MAAM,UAAU,MAAM;EAG7B,MAAM,KAAK,sBAAsB,KAAK,KAAK;EAE3C,KAAK,mBAAmB;EAExB,OAAO,KAAK;CACd;;;;CAKA,MAAgB,iBACd,OACA,WACA,SAAiC,CAAC,GACnB;EACf,QAAQ,UAAU,MAAlB;GACE,KAAK;IACH,MAAM,OAAO,UAAU,OAAO;IAC9B;GAEF,KAAK;IACH,MAAM,QAAQ,UAAU,OAAO;IAC/B;GAEF,KAAK;IACH,MAAM,OAAO,UAAU,KAAK;IAC5B;GAEF,KAAK;IACH,MAAM,KAAK;IACX;GAEF,KAAK;IACH,MAAM,KAAK;IACX;GAEF,KAAK;IACH,MAAM,KAAK,UAAU,KAAK;IAC1B;GAEF,KAAK;IACH,MAAM,QAAQ,UAAU,OAAO;IAC/B;GAEF,KAAK;IACH,MAAM,cAAc,KAAK;IACzB;GAEF,KAAK,WAAW;IACd,MAAM,QAAQ,KAAK,MAAO,UAAU,QAAQ,MAAO,GAAG;IACtD,MAAM,aAAa,OAAO,KAAK;KAAC;KAAK;KAAK;KAAK;IAAK,CAAC;IACrD,OAAO,KAAK;KACV,OAAO;KACP,OAAO;KACP,KAAK;MAAE,OAAO;MAAG,QAAQ;MAAG,UAAU;KAAE;KACxC,MAAM;IACR,CAAC;IACD;GACF;GAEA,KAAK;IACH,MAAM,OAAO,UAAU,OAAO;IAC9B;GAEF,KAAK;IACH,MAAM,KAAK,UAAU,KAAK;IAC1B;GAEF,KAAK;IACH,MAAM,KAAK,UAAU,OAAO;IAC5B;GAEF,KAAK,aAAa;IAChB,MAAM,SAAS,MAAM,KAAK,mBAAmB,UAAU,OAAO,KAAK;IACnE,OAAO,KAAK;KACV,OAAO;KACP,GAAG,UAAU,OAAO;IACtB,CAAC;IACD;GACF;GAEA,KAAK,cAAc;IACjB,MAAM,UAAU,MAAM,QAAQ,IAC5B,UAAU,QAAQ,KAAK,WAAW,KAAK,mBAAmB,OAAO,KAAK,CAAC,CACzE;IACA,UAAU,QAAQ,SAAS,QAAQ,UAAU;KAC3C,OAAO,KAAK;MACV,OAAO,QAAQ;MACf,GAAG,OAAO;KACZ,CAAC;IACH,CAAC;IACD;GACF;EACF;CACF;;;;CAKA,MAAgB,mBAAmB,OAA4C;EAC7E,IAAI,iBAAiB,OAEnB,OAAO,MAAM,MAAM,SAAS;EAM9B,OAFkB,aAAa,CAAC,CAAC,KAElB,CAAC,CAAC,SAAS;CAC5B;;;;;;CAOA,MAAgB,sBAAsB,OAAmC;EACvE,MAAM,EAAE,SAAS,WAAW,KAAK;EAEjC,IAAI,QAAQ;GAEV,MAAM,gBAAgB,UAAU,EAAE,QAAQ,IAAI;GAC9C,MAAM,SAAS,QAAQ,aAAa;GACpC;EACF;EAEA,IAAI,YAAY,QAEd;EAKF,MAAM,kBAAiB,MADA,KAAK,SAAS,EACN,CAAC;EAEhC,IAAI,CAAC,gBAAgB;GAEnB,MAAM,KAAK,EAAE,QAAQ,CAAC;GACtB;EACF;EAGA,IAAI,MAAM,gBAAgB,SAAS,cAAc,GAE/C,MAAM,SAAS,gBAA+B,EAAE,QAAQ,CAAC;OACpD,IAAI,mBAAmB,OAAO;GAGnC,MAAM,mBAAmB,KAAK,MAAM,IAAK,UAAU,MAAO,CAAC;GAC3D,MAAM,IAAI,EAAE,iBAAiB,CAAC;EAChC,OAAO,IAAI,mBAAmB,OAE5B,MAAM,IAAI;CAGd;;;;CAKA,MAAa,KAAK,MAAyC;EAGzD,QAAO,MAFa,KAAK,gBAAgB,EAE7B,CAAC,OAAO,IAAI;CAC1B;;;;CAKA,MAAa,WAAW,MAAyC;EAE/D,KAAK,QAAQ,SAAS;EAGtB,QAAO,MAFa,KAAK,gBAAgB,EAE7B,CAAC,OAAO,IAAI;CAC1B;;;;CAKA,AAAO,OAAO,QAA2B;EACvC,KAAK,QAAQ,SAAS;EAEtB,OAAO;CACT;;;;CAKA,AAAO,UAAU,OAA2B,UAAgC,CAAC,GAAS;EACpF,OAAO,KAAK,aAAa;GACvB,MAAM;GACN,QAAQ;IAAE;IAAO;GAAQ;EAC3B,CAAC;CACH;;;;CAKA,AAAO,WAAW,SAAkC;EAClD,OAAO,KAAK,aAAa;GACvB,MAAM;GACN;EACF,CAAC;CACH;;;;CAKA,AAAO,OAAO,OAAqB;EACjC,OAAO,KAAK,aAAa;GAAE,MAAM;GAAU;EAAM,CAAC;CACpD;;;;CAKA,AAAO,OAAa;EAClB,OAAO,KAAK,aAAa,EAAE,MAAM,OAAO,CAAC;CAC3C;;;;CAKA,AAAO,OAAa;EAClB,OAAO,KAAK,aAAa,EAAE,MAAM,OAAO,CAAC;CAC3C;;;;CAKA,AAAO,KAAK,OAAqB;EAC/B,IAAI,QAAQ,IACV,MAAM,IAAI,MAAM,iCAAiC;EAGnD,OAAO,KAAK,aAAa;GAAE,MAAM;GAAQ;EAAM,CAAC;CAClD;;;;CAKA,MAAa,WAA4B;EAIvC,QAAO,OAFc,MADD,KAAK,gBAAgB,EACf,CAAC,SAAS,EAEvB,CAAC,SAAS,QAAQ;CACjC;;;;CAKA,MAAa,YAA6B;EACxC,MAAM,WAAW,MAAM,KAAK,SAAS;EACrC,MAAM,SAAS,KAAK,QAAQ,UAAU,SAAS,UAAU;EAIzD,OAAO,QAAQ,SAHW,WAAW,QAAQ,SAAS,SAG9B,UAAU,MAFb,KAAK,SAAS;CAGrC;;;;CAKA,AAAO,QAAQ,SAAsC;EACnD,OAAO,KAAK,aAAa;GAAE,MAAM;GAAW;EAAQ,CAAC;CACvD;;;;CAKA,AAAO,OAAO,SAAqC;EACjD,OAAO,KAAK,aAAa;GAAE,MAAM;GAAU;EAAQ,CAAC;CACtD;;;;CAKA,AAAO,KAAK,OAA0B;EACpC,OAAO,KAAK,aAAa;GAAE,MAAM;GAAQ;EAAM,CAAC;CAClD;;;;CAKA,AAAO,KAAK,SAAmC;EAC7C,OAAO,KAAK,aAAa;GAAE,MAAM;GAAQ;EAAQ,CAAC;CACpD;;;;CAKA,MAAa,WAA4B;EAGvC,QAAO,MAFa,KAAK,gBAAgB,EAE7B,CAAC,SAAS;CACxB;;;;CAKA,AAAO,QAAe;EACpB,MAAM,cAAc,IAAI,MAAM,KAAK,MAAM,MAAM,CAAC;EAChD,YAAY,UAAU,EAAE,GAAG,KAAK,QAAQ;EACxC,YAAY,aAAa,CAAC,GAAG,KAAK,UAAU;EAC5C,YAAY,iBAAiB,KAAK,iBAAiB,EAAE,GAAG,KAAK,eAAe,IAAI;EAEhF,OAAO;CACT;;;;CAKA,AAAO,aAAwC;EAC7C,OAAO,EAAE,GAAG,KAAK,QAAQ;CAC3B;;;;CAKA,AAAO,4BAAoC;EACzC,OAAO,KAAK,WAAW;CACzB;;;;CAKA,AAAO,eAAqB;EAC1B,KAAK,UAAU,CAAC;EAEhB,OAAO;CACT;;;;CAKA,AAAO,kBAAwB;EAC7B,KAAK,aAAa,CAAC;EACnB,KAAK,mBAAmB;EAExB,OAAO;CACT;;;;CAKA,AAAO,QAAc;EACnB,KAAK,aAAa,CAAC;EACnB,KAAK,UAAU,CAAC;EAChB,KAAK,mBAAmB;EACxB,KAAK,iBAAiB;EAEtB,OAAO;CACT;AACF"}

package/esm/image/index.d.mts

@@ -1 +1,2 @@
-import { Image, ImageFormat, ImageInput, ImageTransformOptions, WatermarkConfig } from "./image.mjs";
+import { Image, ImageFormat, ImageInput, ImageTransformOptions, WatermarkConfig } from "./image.mjs";
+export { Image, ImageFormat, ImageInput, ImageTransformOptions, WatermarkConfig };

package/esm/image/index.mjs

@@ -1,3 +1,3 @@
 import { Image } from "./image.mjs";
 
-export {  };
+export { Image };

package/esm/index.d.mts

@@ -23,10 +23,12 @@ import { DOSpacesDriver } from "./storage/drivers/do-spaces-driver.mjs";
 import { LocalDriver } from "./storage/drivers/local-driver.mjs";
 import { R2Driver } from "./storage/drivers/r2-driver.mjs";
 import { S3Driver } from "./storage/drivers/s3-driver.mjs";
+import "./storage/index.mjs";
 import { PipeableReactStream, StreamReactResponseOptions, streamReactResponse } from "./http/stream-react-response.mjs";
 import { XMLable } from "./http/xmlable.mjs";
 import { CookieOptions, Response, ResponseStatus, SendBufferOptions, SendFileOptions, toSingleLineSseField } from "./http/response.mjs";
 import { Image, ImageFormat, ImageInput, ImageTransformOptions, WatermarkConfig } from "./image/image.mjs";
+import "./image/index.mjs";
 import { FileNamingStrategy, ImageTransformCallback, ImageTransformConfig, ImageVariantDefinition, ImageVariantFit, ImageVariantOutputFormat, PrefixConfig, PrefixOptions, SaveAsOptions, SaveOptions, UploadedFileImageOptions, UploadsConfigurations, UploadsImagesConfigurations } from "./http/uploads-types.mjs";
 import { FileValidationOptions, UploadedFile, UploadedFileJson } from "./http/uploaded-file.mjs";
 import { Request, RequestTranslator } from "./http/request.mjs";
@@ -74,6 +76,7 @@ import { TracingContextSource, buildTracingContext, dispatchPhase, dispatchReque
 import { RequestContextStore, requestContext, useCurrentUser, useRequest, useRequestStore } from "./http/context/request-context.mjs";
 import { requestMemo } from "./http/context/request-memo.mjs";
 import { ModelResourceRegistry, Serialized, SerializedWire } from "./http/serialized.mjs";
+import "./http/index.mjs";
 import { LocalizedObject, getLocalized } from "./utils/get-localized.mjs";
 import { ResourceFieldBuilder } from "./resource/resource-field-builder.mjs";
 import { Resource, ResourceConstructor, ResourceContract } from "./resource/resource.mjs";
@@ -86,6 +89,7 @@ import { RouteNameTakenError } from "./router/route-name-taken-error.mjs";
 import { RouteRegistry } from "./router/route-registry.mjs";
 import { Router, router } from "./router/router.mjs";
 import { AUTH_GUARD_MARKER, isAuthGuardMiddleware, isUnguardedMutatingRoute, markAuthGuard, reportUnguardedMutatingRoutes, resetUnguardedRouteReports } from "./router/unguarded-route-diagnostics.mjs";
+import "./router/index.mjs";
 import { app } from "./application/app.mjs";
 import { Environment, RuntimeStrategy, environment, setEnvironment } from "./utils/environment.mjs";
 import { APP_ROLES, AppRole, assertSitesRequireWebRole, getRoles, getSites, hasRole, parseRoles, parseSites, resetRolesCacheForTests, servesHttp } from "./application/roles.mjs";
@@ -93,6 +97,7 @@ import { Application, BootContext, BootListener, BootValidator, ShutdownListener
 import { BOOT_SIGNAL_ENV_KEY, BOOT_SIGNAL_VERSION, BootSignal, BootSignalType, isBootSignal, sendBootSignal } from "./application/boot-signal.mjs";
 import { AppConfigurations } from "./application/application-config-types.mjs";
 import { getPublicUrl } from "./application/public-url.mjs";
+import "./application/index.mjs";
 import { BenchmarkSnapshots } from "./benchmark/benchmark-snapshots.mjs";
 import { BenchmarkProfiler } from "./benchmark/profiler.mjs";
 import { BenchmarkChannel, BenchmarkConfigurations, BenchmarkErrorResult, BenchmarkOptions, BenchmarkProfilerOptions, BenchmarkResult, BenchmarkSnapshotsOptions, BenchmarkStats, BenchmarkSuccessResult } from "./benchmark/types.mjs";
@@ -102,12 +107,14 @@ import { NoopChannel } from "./benchmark/channels/noop.channel.mjs";
 import { bootstrap } from "./bootstrap.mjs";
 import { displayEnvironmentMode } from "./bootstrap/setup.mjs";
 import { DatabaseCacheDriver, DatabaseCacheOptions } from "./cache/database-cache-driver.mjs";
+import "./cache/index.mjs";
 import { ConfigKey, ConfigKeyRegistry, ConfigName, ConfigRegistry } from "./config/types.mjs";
 import { config } from "./config/config-getter.mjs";
 import { registerAppConfig } from "./config/config-handlers.mjs";
 import { ConfigIssue, ConfigModuleEntry, ConfigOf, ConfigSchema, ConfigSchemaOptions, InvalidConfigError, assertValidConfigModules, defineConfigSchema, formatConfigIssues, isConfigSchema, validateConfigValue } from "./config/config-schema.mjs";
 import { setConfig } from "./config/config-setter.mjs";
 import { ConfigSpecialHandlers, configSpecialHandlers } from "./config/config-special-handlers.mjs";
+import "./config/index.mjs";
 import { WarlockConfig } from "./warlock-config/types.mjs";
 import { Connector, ConnectorBuildContext, ConnectorBuildContribution, ConnectorBuildGenerateResult, ConnectorEsbuildPatch, ConnectorLifecyclePhase, ConnectorName, ConnectorPriority } from "./connectors/types.mjs";
 import { BaseConnector } from "./connectors/base-connector.mjs";
@@ -126,8 +133,10 @@ import { NotificationsConnector } from "./connectors/notifications-connector.mjs
 import { RegisterConfiguredConnectorsOptions, registerConfiguredConnectors } from "./connectors/register-configured-connectors.mjs";
 import { SocketConnector } from "./connectors/socket-connector.mjs";
 import { StorageConnector } from "./connectors/storage.connector.mjs";
+import "./connectors/index.mjs";
 import { CLICommandAction, CLICommandOption, CLICommandOptions, CLICommandPreload, CLICommandSource, CommandActionData, ResolvedCLICommandOption } from "./commands/types.mjs";
 import { CLICommand, command } from "./commands/cli-command.mjs";
+import "./commands/index.mjs";
 import { DevelopmentAppModuleEntry, DevelopmentAppModules } from "./container/development-app-modules.mjs";
 import { DevelopmentModelModuleEntry, DevelopmentModelModuleState, DevelopmentModelModules } from "./container/development-model-modules.mjs";
 import { ContainerTypes, container } from "./container/index.mjs";
@@ -136,6 +145,7 @@ import { SeedClock, SeedContext, SeedRecordRef, SeedResult, SeederMetadata, Trac
 import { Seeder, seeder } from "./database/seeds/seeder.mjs";
 import { SeederDependencyCycleError, UnknownSeederDependencyError } from "./database/seeds/seeder.errors.mjs";
 import { useComputedModel, useComputedSlug, useHashedPassword } from "./database/utils.mjs";
+import "./database/index.mjs";
 import { decrypt, encrypt } from "./encryption/encrypt.mjs";
 import { hmacHash } from "./encryption/hash.mjs";
 import { hashPassword, verifyPassword } from "./encryption/password.mjs";
@@ -143,6 +153,7 @@ import { EncryptionConfigurations, EncryptionPasswordConfigurations } from "./en
 import { ensureFatalIsVisible } from "./logger/fatal-visibility.mjs";
 import { LogConfigurations } from "./logger/types.mjs";
 import { setLogConfigurations } from "./logger/logger.mjs";
+import "./logger/index.mjs";
 import { LocaleDictionaryEntries, LocaleDictionaryError, ParsedLocaleDictionary, parseLocaleDictionary } from "./localization/parse-locale-dictionary.mjs";
 import { registerGroupedTranslationKeys, registerLocaleDictionary, unregisterLocaleDictionary } from "./localization/register-locale-dictionary.mjs";
 import { CapturedMail, MailAddress, MailAttachment, MailConfigurations, MailError, MailErrorCode, MailEvents, MailMode, MailOptions, MailPriority, MailResult, MailersConfig, NormalizedMail, SESConfigurations, SMTPConfigurations } from "./mail/types.mjs";
@@ -153,12 +164,14 @@ import { renderReactMail } from "./mail/react-mail.mjs";
 import { sendMail } from "./mail/send-mail.mjs";
 import { Mail } from "./mail/mail.mjs";
 import { assertMailCount, assertMailSent, captureMail, clearTestMailbox, findMailsBySubject, findMailsTo, getLastMail, getMailboxSize, getTestMailbox, wasMailSentTo, wasMailSentWithSubject } from "./mail/test-mailbox.mjs";
+import "./mail/index.mjs";
 import { PostmanAuth, PostmanAuthEntry, PostmanBody, PostmanCollection, PostmanCollectionOptions, PostmanFolder, PostmanFormParam, PostmanHeader, PostmanItem, PostmanOriginalRequest, PostmanQueryParam, PostmanRequest, PostmanRequestItem, PostmanResponse, PostmanUrl, PostmanVariable } from "./openapi/postman/postman-types.mjs";
 import { AuthDescriptor, OpenApiBuildResult, OpenApiComponents, OpenApiContext, OpenApiDocument, OpenApiOperation, OpenApiParameter, OpenApiRequestBody, OpenApiResponse, OpenApiRouteInput, OpenApiSchema, OpenApiSecurityRequirement, OpenApiSecurityScheme, OpenApiValidationResponseConfig, WarningSink } from "./openapi/types.mjs";
 import { DevelopmentPostmanResult, getDevelopmentOpenApiDocument, getDevelopmentPostmanCollection, registerDevelopmentOpenApiProvider } from "./openapi/development-openapi-provider.mjs";
 import { OPENAPI_JSON_SCHEMA_DIALECT, buildOpenApiDocument } from "./openapi/build-openapi-document.mjs";
 import { exampleFromSchema } from "./openapi/postman/example-from-schema.mjs";
 import { DEFAULT_POSTMAN_BASE_URL, POSTMAN_COLLECTION_SCHEMA, openApiToPostmanCollection } from "./openapi/postman/openapi-to-postman-collection.mjs";
+import "./openapi/index.mjs";
 import { renderReact } from "./react/index.mjs";
 import { RepositoryManager } from "./repositories/repository.manager.mjs";
 import { RepositoryAdapterContract } from "./repositories/contracts/repository-adapter.contract.mjs";
@@ -166,11 +179,15 @@ import { AllRepositoryOptions, CachedRepositoryOptions, ChunkCallback, CursorPag
 import { AggregateExpressionInput, AggregateExpressions, GroupByFields, QueryBuilderContract } from "./repositories/contracts/query-builder.contract.mjs";
 import { CascadeAdapter, UPDATE_MANY_BATCH_SIZE } from "./repositories/adapters/cascade/cascade-adapter.mjs";
 import { CascadeQueryBuilder } from "./repositories/adapters/cascade/cascade-query-builder.mjs";
+import "./repositories/index.mjs";
 import { DefineResourceOptions, defineResource } from "./resource/define-resource.mjs";
 import { RegisterResource } from "./resource/register-resource.mjs";
+import "./resource/index.mjs";
 import { Restful } from "./restful/restful.mjs";
+import "./restful/index.mjs";
 import { SocketAdapterFactory, SocketOptions } from "./socket/types.mjs";
 import { getSocketServer } from "./socket/utils.mjs";
+import "./socket/index.mjs";
 import { RegisteredUseCase, UseCase, UseCaseAfterMiddleware, UseCaseBeforeMiddleware, UseCaseBroadcastChannel, UseCaseBroadcastEvent, UseCaseBroadcastOption, UseCaseConfigurations, UseCaseContext, UseCaseErrorResult, UseCaseEventsCallbacksMap, UseCaseGuard, UseCaseHandler, UseCaseOnExecutingContext, UseCaseResult, UseCaseRuntimeOptions, UseCaseWithSchema } from "./use-cases/types.mjs";
 import { useCase } from "./use-cases/use-case.mjs";
 import { broadcastUseCaseResult } from "./use-cases/use-case-broadcast.mjs";
@@ -178,6 +195,7 @@ import { fireLifecycleEvent, globalEventsCallbacksMap, globalUseCasesEvents } fr
 import { PipelineOptions, runPipeline } from "./use-cases/use-case-pipeline.mjs";
 import { BadSchemaUseCaseError } from "./use-cases/use-case.errors.mjs";
 import { $registerUseCase, $unregisterUseCase, addUseCaseHistory, getUseCase, getUseCaseHistory, getUseCases, increaseUseCaseFailedCalls, increaseUseCaseSuccessCalls } from "./use-cases/use-cases-registry.mjs";
+import "./use-cases/index.mjs";
 import { appLog } from "./utils/app-log.mjs";
 import { ClockSource, clock, setClockSource } from "./utils/clock.mjs";
 import { DatabaseLog, DatabaseLogOptions } from "./utils/database-log.mjs";
@@ -193,6 +211,7 @@ import { sluggable } from "./utils/sluggable.mjs";
 import { toJson } from "./utils/to-json.mjs";
 import { assetsUrl, publicUrl, setBaseUrl, uploadsUrl, url } from "./utils/urls.mjs";
 import { isNewerVersion } from "./utils/version-compare.mjs";
+import "./utils/index.mjs";
 import { existsExceptCurrentIdRule } from "./validation/database/exists-except-current-id.mjs";
 import { existsExceptCurrentUserRule } from "./validation/database/exists-except-current-user.mjs";
 import { ExistsExceptCurrentIdRuleOptions, ExistsExceptCurrentUserRuleOptions, UniqueExceptCurrentIdRuleOptions, UniqueExceptCurrentUserRuleOptions } from "./validation/database/types.mjs";
@@ -201,8 +220,10 @@ import { uniqueExceptCurrentUserRule } from "./validation/database/unique-except
 import { FileValidator, uploadedFileMetadataSchema } from "./validation/validators/file-validator.mjs";
 import { ValidationConfiguration, ValidationResponseConfiguration } from "./validation/types.mjs";
 import { fileExtensionRule, fileRule, fileTypeRule, imageRule } from "./validation/file/file.mjs";
+import "./validation/index.mjs";
 import { defineConfig } from "./warlock-config/define-config.mjs";
 import { WarlockConfigManager, isUnknownTsExtensionError, isUnresolvedConfigImportError, isUnsupportedTypeStrippingError, warlockConfigManager } from "./warlock-config/warlock-config.manager.mjs";
+import "./warlock-config/index.mjs";
 import { env } from "@mongez/dotenv";
 import { colors } from "@mongez/copper";
 export * from "@mongez/localization";

package/esm/loader/app-module-importer.d.mts

@@ -11,7 +11,6 @@
  * The state lives on `globalThis` because the framework can be loaded twice in
  * one worker (vite-node copy and native copy) and both must see the same hook.
  */
-type AppModuleImporter = (fileUrl: string) => Promise<unknown>;
+export type AppModuleImporter = (fileUrl: string) => Promise<unknown>;
 //#endregion
-export { AppModuleImporter };
 //# sourceMappingURL=app-module-importer.d.mts.map

package/esm/loader/app-module-importer.d.mts.map

@@ -1 +1 @@
-{"version":3,"file":"app-module-importer.d.mts","names":[],"sources":["../../../../../../../../packages/core/src/loader/app-module-importer.ts"],"mappings":";;AAYA;;;;AAA4D;;;;;;;KAAhD,iBAAA,IAAqB,OAAA,aAAoB,OAAO"}
+{"version":3,"file":"app-module-importer.d.mts","names":[],"sources":["../../../../../../../../packages/core/src/loader/app-module-importer.ts"],"mappings":";;;;;;;;;;;;;YAYY,qBAAqB,oBAAoB"}

package/esm/localization/index.mjs

@@ -1,4 +1,4 @@
 import { LocaleDictionaryError, parseLocaleDictionary } from "./parse-locale-dictionary.mjs";
 import { registerGroupedTranslationKeys, registerLocaleDictionary, unregisterLocaleDictionary } from "./register-locale-dictionary.mjs";
 
-export {  };
+export { LocaleDictionaryError, parseLocaleDictionary, registerGroupedTranslationKeys, registerLocaleDictionary, unregisterLocaleDictionary };

package/esm/localization/parse-locale-dictionary.d.mts

@@ -1,12 +1,12 @@
 //#region ../../packages/core/src/localization/parse-locale-dictionary.d.ts
-type LocaleDictionaryEntries = Record<string, Record<string, string>>;
-type ParsedLocaleDictionary = {
+export type LocaleDictionaryEntries = Record<string, Record<string, string>>;
+export type ParsedLocaleDictionary = {
   sourceFile: string;
   group: string;
   entries: LocaleDictionaryEntries;
 };
 /** A source error that always names both the locale file and the offending JSON key. */
-declare class LocaleDictionaryError extends Error {
+export declare class LocaleDictionaryError extends Error {
   readonly sourceFile: string;
   readonly key: string;
   /** Stable Warlock error code; `warlock explain WL1007` prints the fix. */
@@ -14,7 +14,7 @@ declare class LocaleDictionaryError extends Error {
   constructor(sourceFile: string, key: string, detail: string);
 }
 /** Parses one locale dictionary source without reading the filesystem or loading application code. */
-declare function parseLocaleDictionary(input: {
+export declare function parseLocaleDictionary(input: {
   sourceFile: string;
   source: string;
   /**
@@ -26,5 +26,4 @@ declare function parseLocaleDictionary(input: {
   localeCodes?: readonly string[];
 }): ParsedLocaleDictionary;
 //#endregion
-export { LocaleDictionaryEntries, LocaleDictionaryError, ParsedLocaleDictionary, parseLocaleDictionary };
 //# sourceMappingURL=parse-locale-dictionary.d.mts.map

package/esm/localization/parse-locale-dictionary.d.mts.map

@@ -1 +1 @@
-{"version":3,"file":"parse-locale-dictionary.d.mts","names":[],"sources":["../../../../../../../../packages/core/src/localization/parse-locale-dictionary.ts"],"mappings":";KAAY,uBAAA,GAA0B,MAAM,SAAS,MAAA;AAAA,KAEzC,sBAAA;EACV,UAAA;EACA,KAAA;EACA,OAAA,EAAS,uBAAuB;AAAA;AAHlC;AAAA,cAca,qBAAA,SAA8B,KAAK;EAAA,SAK5B,UAAA;EAAA,SACA,GAAA;EAnBlB;EAAA,SAegB,IAAA;cAGE,UAAA,UACA,GAAA,UAChB,MAAA;AAAA;;iBAsOY,qBAAA,CAAsB,KAAA;EACpC,UAAA;EACA,MAAA;;;;;;EAMA,gBAAA;EACA,WAAA;AAAA,IACE,sBAAsB"}
+{"version":3,"file":"parse-locale-dictionary.d.mts","names":[],"sources":["../../../../../../../../packages/core/src/localization/parse-locale-dictionary.ts"],"mappings":";YAAY,0BAA0B,eAAe;YAEzC;EACV;EACA;EACA,SAAS;;;qBAWE,8BAA8B;WAKvB;WACA;;WAJF;EAEhB,YACkB,oBACA,aAChB;;;wBAsOY,sBAAsB;EACpC;EACA;;;;;;EAMA;EACA;IACE"}

package/esm/localization/parse-locale-dictionary.mjs

@@ -1,7 +1,7 @@
 //#region ../../packages/core/src/localization/parse-locale-dictionary.ts
 const SEGMENT = /^[A-Za-z_][A-Za-z0-9_-]*$/;
 const LOCALE_CODE = /^[A-Za-z][A-Za-z0-9]*(?:-[A-Za-z0-9]+)*$/;
-const FORBIDDEN_SEGMENTS = new Set([
+const FORBIDDEN_SEGMENTS = /* @__PURE__ */ new Set([
 	"__proto__",
 	"prototype",
 	"constructor"