@warlock.js/core 5.28.0 → 5.30.0

package/esm/image/image.mjs.map

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

package/esm/index.d.mts

@@ -1,9 +1,11 @@
+import { BadRequestError, ConflictError, CookieJarUnavailableError, ForbiddenError, HttpError, NotAcceptableError, NotAllowedError, ResourceNotFoundError, ServerError, UnAuthorizedError } from "./http/errors/errors.mjs";
 import { normalizeRoutePath } from "./router/normalize-route-path.mjs";
 import { normalizeRequestPath } from "./router/normalize-request-path.mjs";
+import { HttpLoggingConfig, RequestLogSnapshot, RequestLogSource, RequestLoggingOptions, URL_CREDENTIAL_PARAMS, buildRequestLogSnapshot, redactQueryCredentials, redactUrlCredentials, resolveRequestLoggingOptions } from "./http/request-log-snapshot.mjs";
 import { StorageFile } from "./storage/storage-file.mjs";
+import { ScopedStorage } from "./storage/scoped-storage.mjs";
 import { CloudStorageDriverContract, CloudStorageDriverOptions, CloudStorageFileData, DeleteManyResult, EventSubscription, FileVisibility, ListOptions, LocalStorageDriverOptions, PresignedOptions, PresignedUploadOptions, PutDirectoryOptions, PutDirectoryResult, PutFromUrlOptions, PutOptions, R2StorageDriverOptions, ScopedStorageContract, StorageConfigurations, StorageCopyEventPayload, StorageDriverConfig, StorageDriverContract, StorageDriverName, StorageDriverRegistry, StorageDriverType, StorageEventHandler, StorageEventPayload, StorageEventType, StorageFileData, StorageFileInfo, StorageManagerContract, StoragePutEventPayload, TemporaryTokenError, TemporaryTokenPayload, TemporaryTokenValidation } from "./storage/types.mjs";
 import { storageConfig, storageConfigurations } from "./storage/config.mjs";
-import { ScopedStorage } from "./storage/scoped-storage.mjs";
 import { Storage, storage } from "./storage/storage.mjs";
 import { StorageDriverContextStore, storageDriverContext } from "./storage/context/storage-driver-context.mjs";
 import { resolveWithinRoot } from "./storage/utils/contain-path.mjs";
@@ -20,14 +22,15 @@ import { R2Driver } from "./storage/drivers/r2-driver.mjs";
 import { S3Driver } from "./storage/drivers/s3-driver.mjs";
 import { PipeableReactStream, StreamReactResponseOptions, streamReactResponse } from "./http/stream-react-response.mjs";
 import { XMLable } from "./http/xmlable.mjs";
-import { CookieOptions, Response, ResponseStatus, SendBufferOptions, SendFileOptions } from "./http/response.mjs";
+import { CookieOptions, Response, ResponseStatus, SendBufferOptions, SendFileOptions, toSingleLineSseField } from "./http/response.mjs";
 import { Image, ImageFormat, ImageInput, ImageTransformOptions, WatermarkConfig } from "./image/image.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";
 import { CspConfig, DEFAULT_CSP_DIRECTIVES, InvalidCspDirectiveError, applyCspHeader, buildCspHeaderValue, mergeCspDirectives, resolveCspConfig, serializeCspDirectives, validateCspConfigAtBoot, validateCspDirectives } from "./http/csp.mjs";
+import { HttpErrorMapper, HttpErrorMapping } from "./http/error-mapper.mjs";
 import { HttpTracingConfig, TracingContext, TracingHooks, TracingPhaseInfo, TracingRequestEndInfo } from "./http/tracing/tracing.type.mjs";
-import { DecodedAccessToken, HttpConfigurations, PartialMiddleware, RequestEvent, RequestLocals, ResponseEvent, ResponseSSEController, ResponseStreamController, ReturnedResponse } from "./http/types.mjs";
+import { DecodedAccessToken, HttpConfigurations, HttpServerOptions, PartialMiddleware, RequestEvent, RequestLocals, ResponseEvent, ResponseSSEController, ResponseSSEOptions, ResponseStreamController, ResponseStreamOptions, ReturnedResponse } from "./http/types.mjs";
 import { defaultHttpConfigurations, httpConfig } from "./http/config.mjs";
 import { createHttpApplication, stopHttpApplication } from "./http/createHttpApplication.mjs";
 import { requiresDefaultCsrfGuard, runDefaultCsrfGuard } from "./http/csrf-default-guard.mjs";
@@ -41,8 +44,9 @@ import { UPLOADS_DEFAULTS, uploadsConfig } from "./http/uploads-config.mjs";
 import { DetectedImageFormat, GeneratedImageDescriptor, GeneratedImageVariant, ResolvedImageVariantsConfig, UploadedFileQuery, VariantOutputFormat, VariantSourceFormat } from "./http/uploads/image-variant-types.mjs";
 import { GenerateImageVariantsOptions, generateImageVariants } from "./http/uploads/generate-image-variants.mjs";
 import { ImageVariantsConfigError } from "./http/uploads/image-variants-config-error.mjs";
-import { uploadedFileController } from "./http/uploads/uploaded-file.controller.mjs";
-import { BadRequestError, ConflictError, CookieJarUnavailableError, ForbiddenError, HttpError, NotAcceptableError, NotAllowedError, ResourceNotFoundError, ServerError, UnAuthorizedError } from "./http/errors/errors.mjs";
+import { PurgeImageVariantsOptions, purgeImageVariants } from "./http/uploads/purge-image-variants.mjs";
+import { ResolveImageVariantInput, ResolvedImageVariant, resolveImageVariant } from "./http/uploads/resolve-image-variant.mjs";
+import { UploadedFileControllerOptions, createUploadedFileController, uploadedFileController } from "./http/uploads/uploaded-file.controller.mjs";
 import { CacheMiddlewareOptions } from "./http/middleware/cache-response-middleware.mjs";
 import { ConcurrencyLimitOptions } from "./http/middleware/concurrency-limit.middleware.mjs";
 import { IdempotencyOptions } from "./http/middleware/idempotency.middleware.mjs";
@@ -54,8 +58,8 @@ import { createRequestStore, t } from "./http/middleware/inject-request-context.
 import { anyMatch, ipMatches } from "./http/middleware/utils/cidr-match.mjs";
 import { buildIdempotencyCacheKey, hashBody, isValidIdempotencyKey } from "./http/middleware/utils/idempotency-key.mjs";
 import { parseSize } from "./http/middleware/utils/parse-size.mjs";
-import { ClosableServer, FastifyInstance, closeServerWithTimeout, getHttpServer, startHttpServer } from "./http/server.mjs";
-import { registerHttpPlugins } from "./http/plugins.mjs";
+import { ClosableServer, FastifyInstance, beginHttpDrain, closeServerWithTimeout, getHttpServer, startHttpServer, trackConnectionsForDrain } from "./http/server.mjs";
+import { registerHttpPlugins, resolvePublicRoot } from "./http/plugins.mjs";
 import { assertConfiguredHttpPortIsFree, preflightConfiguredHttpPort, remedyLines, shouldPreflightHttpPort } from "./http/boot-port-preflight.mjs";
 import { PortInUseError, assertPortIsAvailable, isPortAvailable } from "./http/port-preflight.mjs";
 import { HttpReadyReport, getHttpReadyReport, resetHttpReadyReport, setHttpReadyReport } from "./http/ready-report.mjs";
@@ -68,6 +72,7 @@ import { ModelResourceRegistry, Serialized, SerializedWire } from "./http/serial
 import { LocalizedObject, getLocalized } from "./utils/get-localized.mjs";
 import { ResourceFieldBuilder } from "./resource/resource-field-builder.mjs";
 import { Resource, ResourceConstructor, ResourceContract } from "./resource/resource.mjs";
+import { NULLABLE_RESOURCE, NullableResource, NullableResourceTarget, isNullableResource, nullable } from "./resource/nullable-resource.mjs";
 import { BaseCastOutput, CastOutput, FieldOutput, ResourceArraySchema, ResourceCastType, ResourceFieldBuilderDateOutputOptions, ResourceFieldConfig, ResourceOutput, ResourceOutputOf, ResourceOutputValueCastType, ResourceSchema, ResourceSelfReference, ResponseBodyOutput, ResponseBodyValue, ResponseSchema, ResponseSchemaOutput } from "./resource/types.mjs";
 import { GroupedRoutesOptions, HttpContext, Middleware, MiddlewareResponse, NamedApiRoute, NamedApiRoutesOptions, PartialPick, RequestControllerContract, RequestHandler, RequestHandlerType, RequestHandlerValidation, RequestMethod, ResourceMethod, RestfulMiddleware, Route, RouteOptions, RouteResource, RouterGroupCallback, RouterStacks } from "./router/types.mjs";
 import { PositionalHandlerSuspect, clearPositionalHandlerSuspects, describePositionalHandlerSuspect, forgetPositionalHandlerSuspects, inspectHandlerSignature, listPositionalHandlerSuspects, looksLikePositionalHandler, reportPositionalHandlerSuspects } from "./router/positional-handler-diagnostics.mjs";
@@ -115,6 +120,7 @@ import { SocketConnector } from "./connectors/socket-connector.mjs";
 import { StorageConnector } from "./connectors/storage.connector.mjs";
 import { CLICommandAction, CLICommandOption, CLICommandOptions, CLICommandPreload, CLICommandSource, CommandActionData, ResolvedCLICommandOption } from "./commands/types.mjs";
 import { CLICommand, command } from "./commands/cli-command.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";
 import { DatabaseLogModel } from "./database/models/database-log/database-log.mjs";
@@ -185,11 +191,11 @@ import { FileValidator, uploadedFileMetadataSchema } from "./validation/validato
 import { ValidationConfiguration } from "./validation/types.mjs";
 import { fileExtensionRule, fileRule, fileTypeRule, imageRule } from "./validation/file/file.mjs";
 import { defineConfig } from "./warlock-config/define-config.mjs";
-import { WarlockConfigManager, isUnknownTsExtensionError, warlockConfigManager } from "./warlock-config/warlock-config.manager.mjs";
+import { WarlockConfigManager, isUnknownTsExtensionError, isUnresolvedConfigImportError, isUnsupportedTypeStrippingError, warlockConfigManager } from "./warlock-config/warlock-config.manager.mjs";
 import { env } from "@mongez/dotenv";
 import { colors } from "@mongez/copper";
 export * from "@mongez/localization";
-export { $registerUseCase, $unregisterUseCase, APP_ROLES, AccessConnector, AggregateExpressionInput, AggregateExpressions, AiConnector, AllRepositoryOptions, AppConfigurations, AppRole, Application, AuthDescriptor, BOOT_SIGNAL_ENV_KEY, BOOT_SIGNAL_VERSION, BadRequestError, BadSchemaUseCaseError, BaseCastOutput, BaseConnector, type BenchmarkChannel, type BenchmarkConfigurations, type BenchmarkErrorResult, type BenchmarkOptions, BenchmarkProfiler, type BenchmarkProfilerOptions, type BenchmarkResult, BenchmarkSnapshots, type BenchmarkSnapshotsOptions, type BenchmarkStats, type BenchmarkSuccessResult, BootContext, BootListener, BootSignal, BootSignalType, BootValidator, CLICommand, type CLICommandAction, type CLICommandOption, type CLICommandOptions, type CLICommandPreload, type CLICommandSource, CacheConnector, type CacheMiddlewareOptions, CachedRepositoryOptions, type CapturedMail, CascadeAdapter, CascadeQueryBuilder, CastOutput, ChunkCallback, ClosableServer, CloudDriver, CloudStorageDriverContract, CloudStorageDriverOptions, CloudStorageFileData, type CommandActionData, type ConcurrencyLimitOptions, ConfigKey, ConfigKeyRegistry, ConfigName, ConfigRegistry, ConfigSpecialHandlers, ConflictError, Connector, ConnectorBuildContext, ConnectorBuildContribution, ConnectorBuildGenerateResult, ConnectorEsbuildPatch, ConnectorLifecyclePhase, ConnectorName, ConnectorPriority, ConnectorsManager, ConsoleChannel, ContainerTypes, CookieJarUnavailableError, CookieOptions, CspConfig, CsrfOriginCheckReason, CsrfOriginVerdict, CursorPaginationOptions, CursorPaginationResult, DEFAULT_CSP_DIRECTIVES, DEFAULT_POSTMAN_BASE_URL, DOSpacesDriver, DatabaseCacheDriver, type DatabaseCacheOptions, DatabaseConnector, DatabaseLog, DatabaseLogModel, DatabaseLogOptions, DecodedAccessToken, DefineResourceOptions, DeleteManyResult, DetectedImageFormat, type DevelopmentModelModuleEntry, type DevelopmentModelModuleState, type DevelopmentModelModules, DevelopmentPostmanResult, EncryptionConfigurations, EncryptionPasswordConfigurations, Environment, EventSubscription, ExistsExceptCurrentIdRuleOptions, ExistsExceptCurrentUserRuleOptions, FastifyInstance, FieldOutput, FileNamingStrategy, FileValidationOptions, FileValidator, FileVisibility, FilterFunction, FilterOperator, FilterOptions, FilterRule, FilterRules, ForbiddenError, GenerateImageVariantsOptions, GeneratedImageDescriptor, GeneratedImageVariant, GroupByFields, GroupedRoutesOptions, HealthCheck, HealthStatus, HeraldConnector, HttpConfigurations, HttpConnector, HttpContext, HttpError, HttpErrorCodes, HttpReadyReport, HttpServerRebuiltListener, HttpTracingConfig, type IdempotencyOptions, Image, ImageFormat, ImageInput, ImageTransformCallback, ImageTransformConfig, ImageTransformOptions, ImageVariantDefinition, ImageVariantFit, ImageVariantOutputFormat, ImageVariantsConfigError, InvalidCspDirectiveError, type IpFilterOptions, ListOptions, LocalDriver, LocalStorageDriverOptions, LocaleDictionaryEntries, LocaleDictionaryError, LocalizedObject, LogConfigurations, LoggerConnector, MAIL_EVENTS, Mail, type MailAddress, type MailAttachment, type MailConfigurations, MailError, type MailErrorCode, type MailEvents, type MailMode, type MailOptions, type MailPriority, type MailResult, MailerConnector, type MailersConfig, type MaintenanceOptions, Middleware, MiddlewareResponse, MimeTypes, ModelResourceRegistry, NamedApiRoute, NamedApiRoutesOptions, NoopChannel, type NormalizedMail, NotAcceptableError, NotAllowedError, NotificationsConnector, OPENAPI_JSON_SCHEMA_DIALECT, OpenApiBuildResult, OpenApiComponents, OpenApiContext, OpenApiDocument, OpenApiOperation, OpenApiParameter, OpenApiRequestBody, OpenApiResponse, OpenApiRouteInput, OpenApiSchema, OpenApiSecurityRequirement, OpenApiSecurityScheme, OpenApiValidationResponseConfig, POSTMAN_COLLECTION_SCHEMA, PaginationMode, PaginationResult, ParsedLocaleDictionary, PartialMiddleware, PartialPick, Path, PipeableReactStream, PipelineOptions, PortInUseError, PositionalHandlerSuspect, PostmanAuth, PostmanAuthEntry, PostmanBody, PostmanCollection, PostmanCollectionOptions, PostmanFolder, PostmanFormParam, PostmanHeader, PostmanItem, PostmanOriginalRequest, PostmanQueryParam, PostmanRequest, PostmanRequestItem, PostmanResponse, PostmanUrl, PostmanVariable, PrefixConfig, PrefixOptions, PresignedOptions, PresignedUploadOptions, PutDirectoryOptions, PutDirectoryResult, PutFromUrlOptions, PutOptions, QueryBuilderContract, Queue, R2Driver, R2StorageDriverOptions, type RateLimitOptions, RegisterConfiguredConnectorsOptions, RegisterResource, RegisteredUseCase, RepositoryAdapterContract, RepositoryConfigurations, RepositoryEvent, RepositoryManager, RepositoryOptions, RepositoryOptionsWithCursor, RepositoryOptionsWithPages, Request, RequestContextStore, RequestController, RequestControllerContract, RequestEvent, RequestHandler, RequestHandlerType, RequestHandlerValidation, RequestLocals, RequestLog, RequestMethod, RequestTranslator, type ResolvedCLICommandOption, ResolvedImageVariantsConfig, Resource, ResourceArraySchema, ResourceCastType, ResourceConstructor, ResourceContract, ResourceFieldBuilder, ResourceFieldBuilderDateOutputOptions, ResourceFieldConfig, ResourceMethod, ResourceNotFoundError, ResourceOutput, ResourceOutputOf, ResourceOutputValueCastType, ResourceSchema, ResourceSelfReference, Response, ResponseBodyOutput, ResponseBodyValue, ResponseEvent, ResponseSSEController, ResponseSchema, ResponseSchemaOutput, ResponseStatus, ResponseStreamController, Restful, RestfulMiddleware, ReturnedResponse, Route, RouteOptions, RouteRegistry, RouteResource, Router, RouterGroupCallback, RouterStacks, RuntimeStrategy, S3Driver, type SESConfigurations, type SMTPConfigurations, SafeFetchOptions, SafeFetchResult, SaveAsOptions, SaveMode, SaveOptions, ScopedStorage, ScopedStorageContract, SeedClock, SeedContext, SeedRecordRef, SeedResult, Seeder, SeederDependencyCycleError, SeederMetadata, SendBufferOptions, SendFileOptions, Serialized, SerializedWire, ServerError, ShutdownListener, SocketAdapterFactory, SocketConnector, SocketOptions, Storage, StorageCapabilityError, StorageConfigurations, StorageConnector, StorageCopyEventPayload, StorageDriverConfig, StorageDriverContextStore, StorageDriverContract, StorageDriverName, StorageDriverRegistry, StorageDriverType, StorageError, StorageErrorOptions, StorageEventHandler, StorageEventPayload, StorageEventType, StorageFile, StorageFileData, StorageFileInfo, StorageManagerContract, StorageNotInitializedError, StoragePutEventPayload, StreamReactResponseOptions, TemporaryTokenError, TemporaryTokenPayload, TemporaryTokenValidation, TracingContext, TracingContextSource, TracingHooks, TracingPhaseInfo, TracingRequestEndInfo, Track, TrackableModel, TypedAllRepositoryOptions, TypedRepositoryOptions, TypedRepositoryOptionsWithCursor, TypedRepositoryOptionsWithPages, UPDATE_MANY_BATCH_SIZE, UPLOADS_DEFAULTS, UnAuthorizedError, UniqueExceptCurrentIdRuleOptions, UniqueExceptCurrentUserRuleOptions, UnknownSeederDependencyError, UploadedFile, UploadedFileImageOptions, UploadedFileJson, UploadedFileQuery, UploadsConfigurations, UploadsImagesConfigurations, UseCase, UseCaseAfterMiddleware, UseCaseBeforeMiddleware, UseCaseBroadcastChannel, UseCaseBroadcastEvent, UseCaseBroadcastOption, UseCaseConfigurations, UseCaseContext, UseCaseErrorResult, UseCaseEventsCallbacksMap, UseCaseGuard, UseCaseHandler, UseCaseOnExecutingContext, UseCaseResult, UseCaseRuntimeOptions, UseCaseWithSchema, ValidationConfiguration, VariantOutputFormat, VariantSourceFormat, WarlockConfig, WarlockConfigManager, WarningSink, WatermarkConfig, WhereOperator, XMLable, addUseCaseHistory, anyMatch, app, appLog, appPath, applyCspHeader, assertConfiguredHttpPortIsFree, assertMailCount, assertMailSent, assertNoReservedConnectorNames, assertPortIsAvailable, assertSitesRequireWebRole, assertUniqueConnectorNames, assetsUrl, bootstrap, broadcastUseCaseResult, buildCspHeaderValue, buildIdempotencyCacheKey, buildOpenApiDocument, buildTracingContext, cachePath, captureMail, clearPositionalHandlerSuspects, clearTestMailbox, closeAllMailers, closeMailer, closeServerWithTimeout, colors, command, config, configPath, configSpecialHandlers, connectorsManager, container, createHttpApplication, createRequestStore, decrypt, defaultHttpConfigurations, defineConfig, defineResource, deriveTraceId, describePositionalHandlerSuspect, dispatchPhase, dispatchRequestEnd, dispatchRequestStart, displayEnvironmentMode, encrypt, ensureFatalIsVisible, env, environment, exampleFromSchema, existsExceptCurrentIdRule, existsExceptCurrentUserRule, fetchLatestVersion, fileExtensionRule, fileRule, fileTypeRule, findMailsBySubject, findMailsTo, fireLifecycleEvent, forgetPositionalHandlerSuspects, generateImageVariants, generateMailId, getDefaultMailConfig, getDevelopmentOpenApiDocument, getDevelopmentPostmanCollection, getHttpReadyReport, getHttpServer, getLastMail, getLocalized, getMailEventName, getMailMode, getMailboxSize, getMailer, getMailerConfig, getMimeType, getPoolStats, getPublicUrl, getRoles, getSites, getSocketServer, getTestMailbox, getUseCase, getUseCaseHistory, getUseCases, globalEventsCallbacksMap, globalUseCasesEvents, hasRole, hashBody, hashPassword, health, hmacHash, httpConfig, imageRule, increaseUseCaseFailedCalls, increaseUseCaseSuccessCalls, inspectHandlerSignature, ipMatches, isAllowedCsrfOrigin, isBootSignal, isDevelopmentMode, isNewerVersion, isPortAvailable, isPrivateOrReservedIp, isProductionMode, isTestMode, isTracingEnabled, isUnknownTsExtensionError, isValidIdempotencyKey, listPositionalHandlerSuspects, loadS3, logResponse, logsPath, looksLikePositionalHandler, mailEvents, matchesDerivedRouteName, measure, mergeCspDirectives, middleware, normalizeOrigin, normalizeRequestPath, normalizeRoutePath, notifyHttpServerRebuilt, onHttpServerRebuilt, openApiToPostmanCollection, originOf, ownOrigin, parseLocaleDictionary, parseRoles, parseSites, parseSize, parseTraceparentTraceId, paths, preflightConfiguredHttpPort, promiseAllObject, publicPath, publicUrl, registerAppConfig, registerConfiguredConnectors, registerDevelopmentOpenApiProvider, registerGroupedTranslationKeys, registerHttpPlugins, registerLocaleDictionary, registerTracingHooks, remedyLines, renderReact, renderReactMail, reportPositionalHandlerSuspects, requestContext, requestMemo, requiresDefaultCsrfGuard, resetHttpReadyReport, resetMailConfig, resetRolesCacheForTests, resetTracingConfigForTests, resolveCspConfig, resolveCsrfOriginVerdict, resolveMailConfig, resolveTracingConfig, resolveWithinRoot, rootPath, routeNameMethodSuffix, router, runDefaultCsrfGuard, runPipeline, safeFetchToBuffer, sanitizePath, seeder, sendBootSignal, sendMail, serializeCspDirectives, servesHttp, setBaseUrl, setConfig, setEnvironment, setHttpReadyReport, setLogConfigurations, setMailConfigurations, setMailMode, shouldPreflightHttpPort, sleep, sluggable, srcPath, startHttpServer, stopHttpApplication, storage, storageConfig, storageConfigurations, storageDriverContext, storagePath, streamReactResponse, t, tempPath, toJson, uniqueExceptCurrentIdRule, uniqueExceptCurrentUserRule, unregisterLocaleDictionary, uploadedFileController, uploadedFileMetadataSchema, uploadsConfig, uploadsPath, uploadsUrl, url, useCase, useComputedModel, useComputedSlug, useCurrentUser, useHashedPassword, useRequest, useRequestStore, validateCspConfigAtBoot, validateCspDirectives, verifyMailer, verifyPassword, warlockConfigManager, warlockPath, wasMailSentTo, wasMailSentWithSubject, wrapResponseInDataKey };
+export { $registerUseCase, $unregisterUseCase, APP_ROLES, AccessConnector, AggregateExpressionInput, AggregateExpressions, AiConnector, AllRepositoryOptions, AppConfigurations, AppRole, Application, AuthDescriptor, BOOT_SIGNAL_ENV_KEY, BOOT_SIGNAL_VERSION, BadRequestError, BadSchemaUseCaseError, BaseCastOutput, BaseConnector, type BenchmarkChannel, type BenchmarkConfigurations, type BenchmarkErrorResult, type BenchmarkOptions, BenchmarkProfiler, type BenchmarkProfilerOptions, type BenchmarkResult, BenchmarkSnapshots, type BenchmarkSnapshotsOptions, type BenchmarkStats, type BenchmarkSuccessResult, BootContext, BootListener, BootSignal, BootSignalType, BootValidator, CLICommand, type CLICommandAction, type CLICommandOption, type CLICommandOptions, type CLICommandPreload, type CLICommandSource, CacheConnector, type CacheMiddlewareOptions, CachedRepositoryOptions, type CapturedMail, CascadeAdapter, CascadeQueryBuilder, CastOutput, ChunkCallback, ClosableServer, CloudDriver, CloudStorageDriverContract, CloudStorageDriverOptions, CloudStorageFileData, type CommandActionData, type ConcurrencyLimitOptions, ConfigKey, ConfigKeyRegistry, ConfigName, ConfigRegistry, ConfigSpecialHandlers, ConflictError, Connector, ConnectorBuildContext, ConnectorBuildContribution, ConnectorBuildGenerateResult, ConnectorEsbuildPatch, ConnectorLifecyclePhase, ConnectorName, ConnectorPriority, ConnectorsManager, ConsoleChannel, ContainerTypes, CookieJarUnavailableError, CookieOptions, CspConfig, CsrfOriginCheckReason, CsrfOriginVerdict, CursorPaginationOptions, CursorPaginationResult, DEFAULT_CSP_DIRECTIVES, DEFAULT_POSTMAN_BASE_URL, DOSpacesDriver, DatabaseCacheDriver, type DatabaseCacheOptions, DatabaseConnector, DatabaseLog, DatabaseLogModel, DatabaseLogOptions, DecodedAccessToken, DefineResourceOptions, DeleteManyResult, DetectedImageFormat, type DevelopmentAppModuleEntry, type DevelopmentAppModules, type DevelopmentModelModuleEntry, type DevelopmentModelModuleState, type DevelopmentModelModules, DevelopmentPostmanResult, EncryptionConfigurations, EncryptionPasswordConfigurations, Environment, EventSubscription, ExistsExceptCurrentIdRuleOptions, ExistsExceptCurrentUserRuleOptions, FastifyInstance, FieldOutput, FileNamingStrategy, FileValidationOptions, FileValidator, FileVisibility, FilterFunction, FilterOperator, FilterOptions, FilterRule, FilterRules, ForbiddenError, GenerateImageVariantsOptions, GeneratedImageDescriptor, GeneratedImageVariant, GroupByFields, GroupedRoutesOptions, HealthCheck, HealthStatus, HeraldConnector, HttpConfigurations, HttpConnector, HttpContext, HttpError, HttpErrorCodes, type HttpErrorMapper, type HttpErrorMapping, HttpLoggingConfig, HttpReadyReport, HttpServerOptions, HttpServerRebuiltListener, HttpTracingConfig, type IdempotencyOptions, Image, ImageFormat, ImageInput, ImageTransformCallback, ImageTransformConfig, ImageTransformOptions, ImageVariantDefinition, ImageVariantFit, ImageVariantOutputFormat, ImageVariantsConfigError, InvalidCspDirectiveError, type IpFilterOptions, ListOptions, LocalDriver, LocalStorageDriverOptions, LocaleDictionaryEntries, LocaleDictionaryError, LocalizedObject, LogConfigurations, LoggerConnector, MAIL_EVENTS, Mail, type MailAddress, type MailAttachment, type MailConfigurations, MailError, type MailErrorCode, type MailEvents, type MailMode, type MailOptions, type MailPriority, type MailResult, MailerConnector, type MailersConfig, type MaintenanceOptions, Middleware, MiddlewareResponse, MimeTypes, ModelResourceRegistry, NULLABLE_RESOURCE, NamedApiRoute, NamedApiRoutesOptions, NoopChannel, type NormalizedMail, NotAcceptableError, NotAllowedError, NotificationsConnector, NullableResource, NullableResourceTarget, OPENAPI_JSON_SCHEMA_DIALECT, OpenApiBuildResult, OpenApiComponents, OpenApiContext, OpenApiDocument, OpenApiOperation, OpenApiParameter, OpenApiRequestBody, OpenApiResponse, OpenApiRouteInput, OpenApiSchema, OpenApiSecurityRequirement, OpenApiSecurityScheme, OpenApiValidationResponseConfig, POSTMAN_COLLECTION_SCHEMA, PaginationMode, PaginationResult, ParsedLocaleDictionary, PartialMiddleware, PartialPick, Path, PipeableReactStream, PipelineOptions, PortInUseError, PositionalHandlerSuspect, PostmanAuth, PostmanAuthEntry, PostmanBody, PostmanCollection, PostmanCollectionOptions, PostmanFolder, PostmanFormParam, PostmanHeader, PostmanItem, PostmanOriginalRequest, PostmanQueryParam, PostmanRequest, PostmanRequestItem, PostmanResponse, PostmanUrl, PostmanVariable, PrefixConfig, PrefixOptions, PresignedOptions, PresignedUploadOptions, PurgeImageVariantsOptions, PutDirectoryOptions, PutDirectoryResult, PutFromUrlOptions, PutOptions, QueryBuilderContract, Queue, R2Driver, R2StorageDriverOptions, type RateLimitOptions, RegisterConfiguredConnectorsOptions, RegisterResource, RegisteredUseCase, RepositoryAdapterContract, RepositoryConfigurations, RepositoryEvent, RepositoryManager, RepositoryOptions, RepositoryOptionsWithCursor, RepositoryOptionsWithPages, Request, RequestContextStore, RequestController, RequestControllerContract, RequestEvent, RequestHandler, RequestHandlerType, RequestHandlerValidation, RequestLocals, RequestLog, RequestLogSnapshot, RequestLogSource, RequestLoggingOptions, RequestMethod, RequestTranslator, ResolveImageVariantInput, type ResolvedCLICommandOption, ResolvedImageVariant, ResolvedImageVariantsConfig, Resource, ResourceArraySchema, ResourceCastType, ResourceConstructor, ResourceContract, ResourceFieldBuilder, ResourceFieldBuilderDateOutputOptions, ResourceFieldConfig, ResourceMethod, ResourceNotFoundError, ResourceOutput, ResourceOutputOf, ResourceOutputValueCastType, ResourceSchema, ResourceSelfReference, Response, ResponseBodyOutput, ResponseBodyValue, ResponseEvent, ResponseSSEController, ResponseSSEOptions, ResponseSchema, ResponseSchemaOutput, ResponseStatus, ResponseStreamController, ResponseStreamOptions, Restful, RestfulMiddleware, ReturnedResponse, Route, RouteOptions, RouteRegistry, RouteResource, Router, RouterGroupCallback, RouterStacks, RuntimeStrategy, S3Driver, type SESConfigurations, type SMTPConfigurations, SafeFetchOptions, SafeFetchResult, SaveAsOptions, SaveMode, SaveOptions, ScopedStorage, ScopedStorageContract, SeedClock, SeedContext, SeedRecordRef, SeedResult, Seeder, SeederDependencyCycleError, SeederMetadata, SendBufferOptions, SendFileOptions, Serialized, SerializedWire, ServerError, ShutdownListener, SocketAdapterFactory, SocketConnector, SocketOptions, Storage, StorageCapabilityError, StorageConfigurations, StorageConnector, StorageCopyEventPayload, StorageDriverConfig, StorageDriverContextStore, StorageDriverContract, StorageDriverName, StorageDriverRegistry, StorageDriverType, StorageError, StorageErrorOptions, StorageEventHandler, StorageEventPayload, StorageEventType, StorageFile, StorageFileData, StorageFileInfo, StorageManagerContract, StorageNotInitializedError, StoragePutEventPayload, StreamReactResponseOptions, TemporaryTokenError, TemporaryTokenPayload, TemporaryTokenValidation, TracingContext, TracingContextSource, TracingHooks, TracingPhaseInfo, TracingRequestEndInfo, Track, TrackableModel, TypedAllRepositoryOptions, TypedRepositoryOptions, TypedRepositoryOptionsWithCursor, TypedRepositoryOptionsWithPages, UPDATE_MANY_BATCH_SIZE, UPLOADS_DEFAULTS, URL_CREDENTIAL_PARAMS, UnAuthorizedError, UniqueExceptCurrentIdRuleOptions, UniqueExceptCurrentUserRuleOptions, UnknownSeederDependencyError, UploadedFile, UploadedFileControllerOptions, UploadedFileImageOptions, UploadedFileJson, UploadedFileQuery, UploadsConfigurations, UploadsImagesConfigurations, UseCase, UseCaseAfterMiddleware, UseCaseBeforeMiddleware, UseCaseBroadcastChannel, UseCaseBroadcastEvent, UseCaseBroadcastOption, UseCaseConfigurations, UseCaseContext, UseCaseErrorResult, UseCaseEventsCallbacksMap, UseCaseGuard, UseCaseHandler, UseCaseOnExecutingContext, UseCaseResult, UseCaseRuntimeOptions, UseCaseWithSchema, ValidationConfiguration, VariantOutputFormat, VariantSourceFormat, WarlockConfig, WarlockConfigManager, WarningSink, WatermarkConfig, WhereOperator, XMLable, addUseCaseHistory, anyMatch, app, appLog, appPath, applyCspHeader, assertConfiguredHttpPortIsFree, assertMailCount, assertMailSent, assertNoReservedConnectorNames, assertPortIsAvailable, assertSitesRequireWebRole, assertUniqueConnectorNames, assetsUrl, beginHttpDrain, bootstrap, broadcastUseCaseResult, buildCspHeaderValue, buildIdempotencyCacheKey, buildOpenApiDocument, buildRequestLogSnapshot, buildTracingContext, cachePath, captureMail, clearPositionalHandlerSuspects, clearTestMailbox, closeAllMailers, closeMailer, closeServerWithTimeout, colors, command, config, configPath, configSpecialHandlers, connectorsManager, container, createHttpApplication, createRequestStore, createUploadedFileController, decrypt, defaultHttpConfigurations, defineConfig, defineResource, deriveTraceId, describePositionalHandlerSuspect, dispatchPhase, dispatchRequestEnd, dispatchRequestStart, displayEnvironmentMode, encrypt, ensureFatalIsVisible, env, environment, exampleFromSchema, existsExceptCurrentIdRule, existsExceptCurrentUserRule, fetchLatestVersion, fileExtensionRule, fileRule, fileTypeRule, findMailsBySubject, findMailsTo, fireLifecycleEvent, forgetPositionalHandlerSuspects, generateImageVariants, generateMailId, getDefaultMailConfig, getDevelopmentOpenApiDocument, getDevelopmentPostmanCollection, getHttpReadyReport, getHttpServer, getLastMail, getLocalized, getMailEventName, getMailMode, getMailboxSize, getMailer, getMailerConfig, getMimeType, getPoolStats, getPublicUrl, getRoles, getSites, getSocketServer, getTestMailbox, getUseCase, getUseCaseHistory, getUseCases, globalEventsCallbacksMap, globalUseCasesEvents, hasRole, hashBody, hashPassword, health, hmacHash, httpConfig, imageRule, increaseUseCaseFailedCalls, increaseUseCaseSuccessCalls, inspectHandlerSignature, ipMatches, isAllowedCsrfOrigin, isBootSignal, isDevelopmentMode, isNewerVersion, isNullableResource, isPortAvailable, isPrivateOrReservedIp, isProductionMode, isTestMode, isTracingEnabled, isUnknownTsExtensionError, isUnresolvedConfigImportError, isUnsupportedTypeStrippingError, isValidIdempotencyKey, listPositionalHandlerSuspects, loadS3, logResponse, logsPath, looksLikePositionalHandler, mailEvents, matchesDerivedRouteName, measure, mergeCspDirectives, middleware, normalizeOrigin, normalizeRequestPath, normalizeRoutePath, notifyHttpServerRebuilt, nullable, onHttpServerRebuilt, openApiToPostmanCollection, originOf, ownOrigin, parseLocaleDictionary, parseRoles, parseSites, parseSize, parseTraceparentTraceId, paths, preflightConfiguredHttpPort, promiseAllObject, publicPath, publicUrl, purgeImageVariants, redactQueryCredentials, redactUrlCredentials, registerAppConfig, registerConfiguredConnectors, registerDevelopmentOpenApiProvider, registerGroupedTranslationKeys, registerHttpPlugins, registerLocaleDictionary, registerTracingHooks, remedyLines, renderReact, renderReactMail, reportPositionalHandlerSuspects, requestContext, requestMemo, requiresDefaultCsrfGuard, resetHttpReadyReport, resetMailConfig, resetRolesCacheForTests, resetTracingConfigForTests, resolveCspConfig, resolveCsrfOriginVerdict, resolveImageVariant, resolveMailConfig, resolvePublicRoot, resolveRequestLoggingOptions, resolveTracingConfig, resolveWithinRoot, rootPath, routeNameMethodSuffix, router, runDefaultCsrfGuard, runPipeline, safeFetchToBuffer, sanitizePath, seeder, sendBootSignal, sendMail, serializeCspDirectives, servesHttp, setBaseUrl, setConfig, setEnvironment, setHttpReadyReport, setLogConfigurations, setMailConfigurations, setMailMode, shouldPreflightHttpPort, sleep, sluggable, srcPath, startHttpServer, stopHttpApplication, storage, storageConfig, storageConfigurations, storageDriverContext, storagePath, streamReactResponse, t, tempPath, toJson, toSingleLineSseField, trackConnectionsForDrain, uniqueExceptCurrentIdRule, uniqueExceptCurrentUserRule, unregisterLocaleDictionary, uploadedFileController, uploadedFileMetadataSchema, uploadsConfig, uploadsPath, uploadsUrl, url, useCase, useComputedModel, useComputedSlug, useCurrentUser, useHashedPassword, useRequest, useRequestStore, validateCspConfigAtBoot, validateCspDirectives, verifyMailer, verifyPassword, warlockConfigManager, warlockPath, wasMailSentTo, wasMailSentWithSubject, wrapResponseInDataKey };
 import "./config/types.mjs";
 import "./http/request.mjs";
 import "./http/serialized.mjs";

package/esm/index.mjs

@@ -50,6 +50,7 @@ import { storageDriverContext } from "./storage/context/storage-driver-context.m
 import { MimeTypes, getMimeType } from "./storage/utils/mime.mjs";
 import { CloudDriver, loadS3 } from "./storage/drivers/cloud-driver.mjs";
 import { DOSpacesDriver } from "./storage/drivers/do-spaces-driver.mjs";
+import { UPLOADS_DEFAULTS, uploadsConfig } from "./http/uploads-config.mjs";
 import { resolveWithinRoot } from "./storage/utils/contain-path.mjs";
 import { LocalDriver } from "./storage/drivers/local-driver.mjs";
 import { R2Driver } from "./storage/drivers/r2-driver.mjs";
@@ -58,16 +59,16 @@ import { Storage, storage } from "./storage/storage.mjs";
 import "./storage/index.mjs";
 import { renderReact } from "./react/index.mjs";
 import { streamReactResponse } from "./http/stream-react-response.mjs";
-import { Response, ResponseStatus } from "./http/response.mjs";
+import { Response, ResponseStatus, toSingleLineSseField } from "./http/response.mjs";
 import { Image } from "./image/image.mjs";
 import "./image/index.mjs";
-import { UPLOADS_DEFAULTS, uploadsConfig } from "./http/uploads-config.mjs";
 import { UploadedFile } from "./http/uploaded-file.mjs";
+import { URL_CREDENTIAL_PARAMS, buildRequestLogSnapshot, redactQueryCredentials, redactUrlCredentials, resolveRequestLoggingOptions } from "./http/request-log-snapshot.mjs";
 import { Request } from "./http/request.mjs";
 import { Router, router } from "./router/router.mjs";
 import "./router/index.mjs";
-import { registerHttpPlugins } from "./http/plugins.mjs";
-import { closeServerWithTimeout, getHttpServer, startHttpServer } from "./http/server.mjs";
+import { registerHttpPlugins, resolvePublicRoot } from "./http/plugins.mjs";
+import { beginHttpDrain, closeServerWithTimeout, getHttpServer, startHttpServer, trackConnectionsForDrain } from "./http/server.mjs";
 import { createHttpApplication, stopHttpApplication } from "./http/createHttpApplication.mjs";
 import { RequestLog } from "./http/database/RequestLog.mjs";
 import { logResponse, wrapResponseInDataKey } from "./http/events.mjs";
@@ -78,7 +79,9 @@ import { health } from "./http/health.mjs";
 import { RequestController } from "./http/request-controller.mjs";
 import { ImageVariantsConfigError } from "./http/uploads/image-variants-config-error.mjs";
 import { generateImageVariants } from "./http/uploads/generate-image-variants.mjs";
-import { uploadedFileController } from "./http/uploads/uploaded-file.controller.mjs";
+import { purgeImageVariants } from "./http/uploads/purge-image-variants.mjs";
+import { resolveImageVariant } from "./http/uploads/resolve-image-variant.mjs";
+import { createUploadedFileController, uploadedFileController } from "./http/uploads/uploaded-file.controller.mjs";
 import { buildIdempotencyCacheKey, hashBody, isValidIdempotencyKey } from "./http/middleware/utils/idempotency-key.mjs";
 import { anyMatch, ipMatches } from "./http/middleware/utils/cidr-match.mjs";
 import { parseSize } from "./http/middleware/utils/parse-size.mjs";
@@ -136,7 +139,7 @@ import { StorageConnector } from "./connectors/storage.connector.mjs";
 import { ConnectorsManager, connectorsManager } from "./connectors/connectors-manager.mjs";
 import { assertNoReservedConnectorNames } from "./connectors/assert-no-reserved-connector-names.mjs";
 import { assertUniqueConnectorNames } from "./connectors/assert-unique-connector-names.mjs";
-import { WarlockConfigManager, isUnknownTsExtensionError, warlockConfigManager } from "./warlock-config/warlock-config.manager.mjs";
+import { WarlockConfigManager, isUnknownTsExtensionError, isUnresolvedConfigImportError, isUnsupportedTypeStrippingError, warlockConfigManager } from "./warlock-config/warlock-config.manager.mjs";
 import { registerConfiguredConnectors } from "./connectors/register-configured-connectors.mjs";
 import "./connectors/index.mjs";
 import { seeder } from "./database/seeds/seeder.mjs";
@@ -153,6 +156,7 @@ import "./localization/index.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 { getDevelopmentOpenApiDocument, getDevelopmentPostmanCollection, registerDevelopmentOpenApiProvider } from "./openapi/development-openapi-provider.mjs";
+import { NULLABLE_RESOURCE, isNullableResource, nullable } from "./resource/nullable-resource.mjs";
 import { OPENAPI_JSON_SCHEMA_DIALECT, buildOpenApiDocument } from "./openapi/build-openapi-document.mjs";
 import "./openapi/index.mjs";
 import { CascadeQueryBuilder } from "./repositories/adapters/cascade/cascade-query-builder.mjs";
@@ -183,4 +187,4 @@ import { colors } from "@mongez/copper";
 
 export * from "@mongez/localization"
 
-export { $registerUseCase, $unregisterUseCase, APP_ROLES, AccessConnector, AiConnector, Application, BOOT_SIGNAL_ENV_KEY, BOOT_SIGNAL_VERSION, BadRequestError, BadSchemaUseCaseError, BaseConnector, BenchmarkProfiler, BenchmarkSnapshots, CLICommand, CacheConnector, CascadeAdapter, CascadeQueryBuilder, CloudDriver, ConfigSpecialHandlers, ConflictError, ConnectorLifecyclePhase, ConnectorPriority, ConnectorsManager, ConsoleChannel, CookieJarUnavailableError, DEFAULT_CSP_DIRECTIVES, DEFAULT_POSTMAN_BASE_URL, DOSpacesDriver, DatabaseCacheDriver, DatabaseConnector, DatabaseLog, DatabaseLogModel, FileValidator, ForbiddenError, HeraldConnector, HttpConnector, HttpError, HttpErrorCodes, Image, ImageVariantsConfigError, InvalidCspDirectiveError, LocalDriver, LocaleDictionaryError, LoggerConnector, MAIL_EVENTS, Mail, MailError, MailerConnector, MimeTypes, NoopChannel, NotAcceptableError, NotAllowedError, NotificationsConnector, OPENAPI_JSON_SCHEMA_DIALECT, POSTMAN_COLLECTION_SCHEMA, Path, PortInUseError, Queue, R2Driver, RegisterResource, RepositoryManager, Request, RequestController, RequestLog, Resource, ResourceFieldBuilder, ResourceNotFoundError, Response, ResponseStatus, Restful, RouteRegistry, Router, S3Driver, ScopedStorage, SeederDependencyCycleError, ServerError, SocketConnector, Storage, StorageCapabilityError, StorageConnector, StorageError, StorageFile, StorageNotInitializedError, UPDATE_MANY_BATCH_SIZE, UPLOADS_DEFAULTS, UnAuthorizedError, UnknownSeederDependencyError, UploadedFile, WarlockConfigManager, addUseCaseHistory, anyMatch, app, appLog, appPath, applyCspHeader, assertConfiguredHttpPortIsFree, assertMailCount, assertMailSent, assertNoReservedConnectorNames, assertPortIsAvailable, assertSitesRequireWebRole, assertUniqueConnectorNames, assetsUrl, bootstrap, broadcastUseCaseResult, buildCspHeaderValue, buildIdempotencyCacheKey, buildOpenApiDocument, buildTracingContext, cachePath, captureMail, clearPositionalHandlerSuspects, clearTestMailbox, closeAllMailers, closeMailer, closeServerWithTimeout, colors, command, config, configPath, configSpecialHandlers, connectorsManager, container, createHttpApplication, createRequestStore, decrypt, defaultHttpConfigurations, defineConfig, defineResource, deriveTraceId, describePositionalHandlerSuspect, dispatchPhase, dispatchRequestEnd, dispatchRequestStart, displayEnvironmentMode, encrypt, ensureFatalIsVisible, env, environment, exampleFromSchema, existsExceptCurrentIdRule, existsExceptCurrentUserRule, fetchLatestVersion, fileExtensionRule, fileRule, fileTypeRule, findMailsBySubject, findMailsTo, fireLifecycleEvent, forgetPositionalHandlerSuspects, generateImageVariants, generateMailId, getDefaultMailConfig, getDevelopmentOpenApiDocument, getDevelopmentPostmanCollection, getHttpReadyReport, getHttpServer, getLastMail, getLocalized, getMailEventName, getMailMode, getMailboxSize, getMailer, getMailerConfig, getMimeType, getPoolStats, getPublicUrl, getRoles, getSites, getSocketServer, getTestMailbox, getUseCase, getUseCaseHistory, getUseCases, globalEventsCallbacksMap, globalUseCasesEvents, hasRole, hashBody, hashPassword, health, hmacHash, httpConfig, imageRule, increaseUseCaseFailedCalls, increaseUseCaseSuccessCalls, inspectHandlerSignature, ipMatches, isAllowedCsrfOrigin, isBootSignal, isDevelopmentMode, isNewerVersion, isPortAvailable, isPrivateOrReservedIp, isProductionMode, isTestMode, isTracingEnabled, isUnknownTsExtensionError, isValidIdempotencyKey, listPositionalHandlerSuspects, loadS3, logResponse, logsPath, looksLikePositionalHandler, mailEvents, matchesDerivedRouteName, measure, mergeCspDirectives, middleware, normalizeOrigin, normalizeRequestPath, normalizeRoutePath, notifyHttpServerRebuilt, onHttpServerRebuilt, openApiToPostmanCollection, originOf, ownOrigin, parseLocaleDictionary, parseRoles, parseSites, parseSize, parseTraceparentTraceId, paths, preflightConfiguredHttpPort, promiseAllObject, publicPath, publicUrl, registerAppConfig, registerConfiguredConnectors, registerDevelopmentOpenApiProvider, registerGroupedTranslationKeys, registerHttpPlugins, registerLocaleDictionary, registerTracingHooks, remedyLines, renderReact, renderReactMail, reportPositionalHandlerSuspects, requestContext, requestMemo, requiresDefaultCsrfGuard, resetHttpReadyReport, resetMailConfig, resetRolesCacheForTests, resetTracingConfigForTests, resolveCspConfig, resolveCsrfOriginVerdict, resolveMailConfig, resolveTracingConfig, resolveWithinRoot, rootPath, routeNameMethodSuffix, router, runDefaultCsrfGuard, runPipeline, safeFetchToBuffer, sanitizePath, seeder, sendBootSignal, sendMail, serializeCspDirectives, servesHttp, setBaseUrl, setConfig, setEnvironment, setHttpReadyReport, setLogConfigurations, setMailConfigurations, setMailMode, shouldPreflightHttpPort, sleep, sluggable, srcPath, startHttpServer, stopHttpApplication, storage, storageConfig, storageConfigurations, storageDriverContext, storagePath, streamReactResponse, t, tempPath, toJson, uniqueExceptCurrentIdRule, uniqueExceptCurrentUserRule, unregisterLocaleDictionary, uploadedFileController, uploadedFileMetadataSchema, uploadsConfig, uploadsPath, uploadsUrl, url, useCase, useComputedModel, useComputedSlug, useCurrentUser, useHashedPassword, useRequest, useRequestStore, validateCspConfigAtBoot, validateCspDirectives, verifyMailer, verifyPassword, warlockConfigManager, warlockPath, wasMailSentTo, wasMailSentWithSubject, wrapResponseInDataKey };
+export { $registerUseCase, $unregisterUseCase, APP_ROLES, AccessConnector, AiConnector, Application, BOOT_SIGNAL_ENV_KEY, BOOT_SIGNAL_VERSION, BadRequestError, BadSchemaUseCaseError, BaseConnector, BenchmarkProfiler, BenchmarkSnapshots, CLICommand, CacheConnector, CascadeAdapter, CascadeQueryBuilder, CloudDriver, ConfigSpecialHandlers, ConflictError, ConnectorLifecyclePhase, ConnectorPriority, ConnectorsManager, ConsoleChannel, CookieJarUnavailableError, DEFAULT_CSP_DIRECTIVES, DEFAULT_POSTMAN_BASE_URL, DOSpacesDriver, DatabaseCacheDriver, DatabaseConnector, DatabaseLog, DatabaseLogModel, FileValidator, ForbiddenError, HeraldConnector, HttpConnector, HttpError, HttpErrorCodes, Image, ImageVariantsConfigError, InvalidCspDirectiveError, LocalDriver, LocaleDictionaryError, LoggerConnector, MAIL_EVENTS, Mail, MailError, MailerConnector, MimeTypes, NULLABLE_RESOURCE, NoopChannel, NotAcceptableError, NotAllowedError, NotificationsConnector, OPENAPI_JSON_SCHEMA_DIALECT, POSTMAN_COLLECTION_SCHEMA, Path, PortInUseError, Queue, R2Driver, RegisterResource, RepositoryManager, Request, RequestController, RequestLog, Resource, ResourceFieldBuilder, ResourceNotFoundError, Response, ResponseStatus, Restful, RouteRegistry, Router, S3Driver, ScopedStorage, SeederDependencyCycleError, ServerError, SocketConnector, Storage, StorageCapabilityError, StorageConnector, StorageError, StorageFile, StorageNotInitializedError, UPDATE_MANY_BATCH_SIZE, UPLOADS_DEFAULTS, URL_CREDENTIAL_PARAMS, UnAuthorizedError, UnknownSeederDependencyError, UploadedFile, WarlockConfigManager, addUseCaseHistory, anyMatch, app, appLog, appPath, applyCspHeader, assertConfiguredHttpPortIsFree, assertMailCount, assertMailSent, assertNoReservedConnectorNames, assertPortIsAvailable, assertSitesRequireWebRole, assertUniqueConnectorNames, assetsUrl, beginHttpDrain, bootstrap, broadcastUseCaseResult, buildCspHeaderValue, buildIdempotencyCacheKey, buildOpenApiDocument, buildRequestLogSnapshot, buildTracingContext, cachePath, captureMail, clearPositionalHandlerSuspects, clearTestMailbox, closeAllMailers, closeMailer, closeServerWithTimeout, colors, command, config, configPath, configSpecialHandlers, connectorsManager, container, createHttpApplication, createRequestStore, createUploadedFileController, decrypt, defaultHttpConfigurations, defineConfig, defineResource, deriveTraceId, describePositionalHandlerSuspect, dispatchPhase, dispatchRequestEnd, dispatchRequestStart, displayEnvironmentMode, encrypt, ensureFatalIsVisible, env, environment, exampleFromSchema, existsExceptCurrentIdRule, existsExceptCurrentUserRule, fetchLatestVersion, fileExtensionRule, fileRule, fileTypeRule, findMailsBySubject, findMailsTo, fireLifecycleEvent, forgetPositionalHandlerSuspects, generateImageVariants, generateMailId, getDefaultMailConfig, getDevelopmentOpenApiDocument, getDevelopmentPostmanCollection, getHttpReadyReport, getHttpServer, getLastMail, getLocalized, getMailEventName, getMailMode, getMailboxSize, getMailer, getMailerConfig, getMimeType, getPoolStats, getPublicUrl, getRoles, getSites, getSocketServer, getTestMailbox, getUseCase, getUseCaseHistory, getUseCases, globalEventsCallbacksMap, globalUseCasesEvents, hasRole, hashBody, hashPassword, health, hmacHash, httpConfig, imageRule, increaseUseCaseFailedCalls, increaseUseCaseSuccessCalls, inspectHandlerSignature, ipMatches, isAllowedCsrfOrigin, isBootSignal, isDevelopmentMode, isNewerVersion, isNullableResource, isPortAvailable, isPrivateOrReservedIp, isProductionMode, isTestMode, isTracingEnabled, isUnknownTsExtensionError, isUnresolvedConfigImportError, isUnsupportedTypeStrippingError, isValidIdempotencyKey, listPositionalHandlerSuspects, loadS3, logResponse, logsPath, looksLikePositionalHandler, mailEvents, matchesDerivedRouteName, measure, mergeCspDirectives, middleware, normalizeOrigin, normalizeRequestPath, normalizeRoutePath, notifyHttpServerRebuilt, nullable, onHttpServerRebuilt, openApiToPostmanCollection, originOf, ownOrigin, parseLocaleDictionary, parseRoles, parseSites, parseSize, parseTraceparentTraceId, paths, preflightConfiguredHttpPort, promiseAllObject, publicPath, publicUrl, purgeImageVariants, redactQueryCredentials, redactUrlCredentials, registerAppConfig, registerConfiguredConnectors, registerDevelopmentOpenApiProvider, registerGroupedTranslationKeys, registerHttpPlugins, registerLocaleDictionary, registerTracingHooks, remedyLines, renderReact, renderReactMail, reportPositionalHandlerSuspects, requestContext, requestMemo, requiresDefaultCsrfGuard, resetHttpReadyReport, resetMailConfig, resetRolesCacheForTests, resetTracingConfigForTests, resolveCspConfig, resolveCsrfOriginVerdict, resolveImageVariant, resolveMailConfig, resolvePublicRoot, resolveRequestLoggingOptions, resolveTracingConfig, resolveWithinRoot, rootPath, routeNameMethodSuffix, router, runDefaultCsrfGuard, runPipeline, safeFetchToBuffer, sanitizePath, seeder, sendBootSignal, sendMail, serializeCspDirectives, servesHttp, setBaseUrl, setConfig, setEnvironment, setHttpReadyReport, setLogConfigurations, setMailConfigurations, setMailMode, shouldPreflightHttpPort, sleep, sluggable, srcPath, startHttpServer, stopHttpApplication, storage, storageConfig, storageConfigurations, storageDriverContext, storagePath, streamReactResponse, t, tempPath, toJson, toSingleLineSseField, trackConnectionsForDrain, uniqueExceptCurrentIdRule, uniqueExceptCurrentUserRule, unregisterLocaleDictionary, uploadedFileController, uploadedFileMetadataSchema, uploadsConfig, uploadsPath, uploadsUrl, url, useCase, useComputedModel, useComputedSlug, useCurrentUser, useHashedPassword, useRequest, useRequestStore, validateCspConfigAtBoot, validateCspDirectives, verifyMailer, verifyPassword, warlockConfigManager, warlockPath, wasMailSentTo, wasMailSentWithSubject, wrapResponseInDataKey };

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

@@ -1,4 +1,4 @@
-//#region ../core/src/loader/app-module-importer.d.ts
+//#region ../../packages/core/src/loader/app-module-importer.d.ts
 /**
  * How the framework imports APPLICATION modules (config, routes, events, ...).
  *

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

@@ -1 +1 @@
-{"version":3,"file":"app-module-importer.d.mts","names":[],"sources":["../../../../../../../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":";;AAYA;;;;AAA4D;;;;;;;KAAhD,iBAAA,IAAqB,OAAA,aAAoB,OAAO"}

package/esm/loader/app-module-importer.mjs

@@ -1,4 +1,4 @@
-//#region ../core/src/loader/app-module-importer.ts
+//#region ../../packages/core/src/loader/app-module-importer.ts
 const IMPORTER_KEY = Symbol.for("warlock.core.appModuleImporter");
 /**
 * Install (or clear, with `undefined`) the importer used for app modules.

package/esm/loader/app-module-importer.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"app-module-importer.mjs","names":[],"sources":["../../../../../../../core/src/loader/app-module-importer.ts"],"sourcesContent":["/**\n * How the framework imports APPLICATION modules (config, routes, events, ...).\n *\n * Dev and start use native `import()` — one module graph, nothing to do. Under\n * Vitest the test files run through vite-node while a native `import()` from\n * framework code does not, so one worker would hold two copies of every app\n * class and `instanceof` would fail. `setupTest({ importModule })` installs a\n * hook here so app modules are imported from inside the test's own graph.\n *\n * The state lives on `globalThis` because the framework can be loaded twice in\n * one worker (vite-node copy and native copy) and both must see the same hook.\n */\nexport type AppModuleImporter = (fileUrl: string) => Promise<unknown>;\n\nconst IMPORTER_KEY = Symbol.for(\"warlock.core.appModuleImporter\");\n\ntype ImporterHolder = { [IMPORTER_KEY]?: AppModuleImporter };\n\n/**\n * Install (or clear, with `undefined`) the importer used for app modules.\n */\nexport function setAppModuleImporter(importer: AppModuleImporter | undefined): void {\n  (globalThis as ImporterHolder)[IMPORTER_KEY] = importer;\n}\n\n/**\n * Import an app module through the installed hook, else natively.\n */\nexport async function importAppModule(fileUrl: string): Promise<any> {\n  const importer = (globalThis as ImporterHolder)[IMPORTER_KEY];\n\n  if (importer) return importer(fileUrl);\n\n  return import(fileUrl);\n}\n"],"mappings":";AAcA,MAAM,eAAe,OAAO,IAAI,gCAAgC;;;;AAOhE,SAAgB,qBAAqB,UAA+C;CAClF,AAAC,WAA8B,gBAAgB;AACjD;;;;AAKA,eAAsB,gBAAgB,SAA+B;CACnE,MAAM,WAAY,WAA8B;CAEhD,IAAI,UAAU,OAAO,SAAS,OAAO;CAErC,OAAO,OAAO;AAChB"}
+{"version":3,"file":"app-module-importer.mjs","names":[],"sources":["../../../../../../../../packages/core/src/loader/app-module-importer.ts"],"sourcesContent":["/**\n * How the framework imports APPLICATION modules (config, routes, events, ...).\n *\n * Dev and start use native `import()` — one module graph, nothing to do. Under\n * Vitest the test files run through vite-node while a native `import()` from\n * framework code does not, so one worker would hold two copies of every app\n * class and `instanceof` would fail. `setupTest({ importModule })` installs a\n * hook here so app modules are imported from inside the test's own graph.\n *\n * The state lives on `globalThis` because the framework can be loaded twice in\n * one worker (vite-node copy and native copy) and both must see the same hook.\n */\nexport type AppModuleImporter = (fileUrl: string) => Promise<unknown>;\n\nconst IMPORTER_KEY = Symbol.for(\"warlock.core.appModuleImporter\");\n\ntype ImporterHolder = { [IMPORTER_KEY]?: AppModuleImporter };\n\n/**\n * Install (or clear, with `undefined`) the importer used for app modules.\n */\nexport function setAppModuleImporter(importer: AppModuleImporter | undefined): void {\n  (globalThis as ImporterHolder)[IMPORTER_KEY] = importer;\n}\n\n/**\n * Import an app module through the installed hook, else natively.\n */\nexport async function importAppModule(fileUrl: string): Promise<any> {\n  const importer = (globalThis as ImporterHolder)[IMPORTER_KEY];\n\n  if (importer) return importer(fileUrl);\n\n  return import(fileUrl);\n}\n"],"mappings":";AAcA,MAAM,eAAe,OAAO,IAAI,gCAAgC;;;;AAOhE,SAAgB,qBAAqB,UAA+C;CAClF,AAAC,WAA8B,gBAAgB;AACjD;;;;AAKA,eAAsB,gBAAgB,SAA+B;CACnE,MAAM,WAAY,WAA8B;CAEhD,IAAI,UAAU,OAAO,SAAS,OAAO;CAErC,OAAO,OAAO;AAChB"}

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

@@ -1,4 +1,4 @@
-//#region ../core/src/localization/parse-locale-dictionary.d.ts
+//#region ../../packages/core/src/localization/parse-locale-dictionary.d.ts
 type LocaleDictionaryEntries = Record<string, Record<string, string>>;
 type ParsedLocaleDictionary = {
   sourceFile: string;
@@ -15,7 +15,12 @@ declare class LocaleDictionaryError extends Error {
 declare function parseLocaleDictionary(input: {
   sourceFile: string;
   source: string;
-  defaultNamespace: string;
+  /**
+   * The group used when the file declares no `$group`. A function is called
+   * only in that case, so a namespace that cannot be derived (e.g. from a
+   * folder name) never fails a file that names its own `$group`.
+   */
+  defaultNamespace: string | (() => string);
   localeCodes?: readonly string[];
 }): ParsedLocaleDictionary;
 //#endregion

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

@@ -1 +1 @@
-{"version":3,"file":"parse-locale-dictionary.d.mts","names":[],"sources":["../../../../../../../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,SAE5B,UAAA;EAAA,SACA,GAAA;cADA,UAAA,UACA,GAAA,UAChB,MAAA;AAAA;;iBAgOY,qBAAA,CAAsB,KAAA;EACpC,UAAA;EACA,MAAA;EACA,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":";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,SAE5B,UAAA;EAAA,SACA,GAAA;cADA,UAAA,UACA,GAAA,UAChB,MAAA;AAAA;;iBAsOY,qBAAA,CAAsB,KAAA;EACpC,UAAA;EACA,MAAA;EA5OW;;;;;EAkPX,gBAAA;EACA,WAAA;AAAA,IACE,sBAAsB"}

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

@@ -1,4 +1,4 @@
-//#region ../core/src/localization/parse-locale-dictionary.ts
+//#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([
@@ -153,6 +153,10 @@ function explicitGroup(sourceFile, value) {
 	}
 	return value;
 }
+function defaultGroup(sourceFile, defaultNamespace) {
+	const namespace = typeof defaultNamespace === "function" ? defaultNamespace() : defaultNamespace;
+	return namespace === "" ? "" : explicitGroup(sourceFile, namespace);
+}
 function isObject(value) {
 	return value instanceof Map;
 }
@@ -198,7 +202,7 @@ function parseLocaleDictionary(input) {
 	if (!isObject(parsed)) fail(sourceFile, "$", "root JSON value must be an object");
 	const groupValue = parsed.get("$group");
 	if (groupValue !== void 0 && typeof groupValue !== "string") fail(sourceFile, "$group", "'$group' must be a string");
-	const group = groupValue === void 0 ? defaultNamespace === "" ? "" : explicitGroup(sourceFile, defaultNamespace) : explicitGroup(sourceFile, groupValue);
+	const group = groupValue === void 0 ? defaultGroup(sourceFile, defaultNamespace) : explicitGroup(sourceFile, groupValue);
 	const entries = Object.create(null);
 	const rootEntries = new Map(parsed);
 	rootEntries.delete("$group");

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

@@ -1 +1 @@
-{"version":3,"file":"parse-locale-dictionary.mjs","names":[],"sources":["../../../../../../../core/src/localization/parse-locale-dictionary.ts"],"sourcesContent":["export type LocaleDictionaryEntries = Record<string, Record<string, string>>;\n\nexport type ParsedLocaleDictionary = {\n  sourceFile: string;\n  group: string;\n  entries: LocaleDictionaryEntries;\n};\n\ntype JsonValue = string | number | boolean | null | JsonObject | JsonValue[];\ntype JsonObject = Map<string, JsonValue>;\n\nconst SEGMENT = /^[A-Za-z_][A-Za-z0-9_-]*$/;\nconst LOCALE_CODE = /^[A-Za-z][A-Za-z0-9]*(?:-[A-Za-z0-9]+)*$/;\nconst FORBIDDEN_SEGMENTS = new Set([\"__proto__\", \"prototype\", \"constructor\"]);\n\n/** A source error that always names both the locale file and the offending JSON key. */\nexport class LocaleDictionaryError extends Error {\n  public constructor(\n    public readonly sourceFile: string,\n    public readonly key: string,\n    detail: string,\n  ) {\n    super(`Cannot parse route locales in \"${sourceFile}\" at \"${key}\": ${detail}.`);\n    this.name = \"LocaleDictionaryError\";\n  }\n}\n\nfunction fail(sourceFile: string, key: string, detail: string): never {\n  throw new LocaleDictionaryError(sourceFile, key, detail);\n}\n\n/** A deliberately small JSON parser: unlike JSON.parse, it preserves duplicate property names. */\nclass StrictJsonParser {\n  private offset = 0;\n\n  public constructor(\n    private readonly sourceFile: string,\n    private readonly source: string,\n  ) {}\n\n  public parse(): JsonValue {\n    if (this.source.charCodeAt(0) === 0xfeff) this.offset = 1;\n    const value = this.value(\"$\");\n    this.whitespace();\n    if (this.offset !== this.source.length) this.invalid(\"$\", \"unexpected trailing JSON\");\n    return value;\n  }\n\n  private value(key: string): JsonValue {\n    this.whitespace();\n    const character = this.source[this.offset];\n    if (character === \"{\") return this.object(key);\n    if (character === \"[\") return this.array(key);\n    if (character === '\"') return this.string(key);\n    if (this.source.startsWith(\"true\", this.offset)) return this.literal(\"true\", true);\n    if (this.source.startsWith(\"false\", this.offset)) return this.literal(\"false\", false);\n    if (this.source.startsWith(\"null\", this.offset)) return this.literal(\"null\", null);\n    if (character === \"-\" || (character !== undefined && /[0-9]/.test(character)))\n      return this.number(key);\n    this.invalid(key, \"invalid JSON value\");\n  }\n\n  private object(key: string): JsonObject {\n    this.offset++;\n    this.whitespace();\n    const object = new Map<string, JsonValue>();\n    if (this.source[this.offset] === \"}\") {\n      this.offset++;\n      return object;\n    }\n    while (true) {\n      this.whitespace();\n      if (this.source[this.offset] !== '\"') this.invalid(key, \"object keys must be JSON strings\");\n      const property = this.string(key);\n      const propertyKey = `${key}.${property}`;\n      if (object.has(property)) this.invalid(propertyKey, \"duplicate JSON property\");\n      this.whitespace();\n      if (this.source[this.offset] !== \":\")\n        this.invalid(propertyKey, \"expected ':' after object key\");\n      this.offset++;\n      object.set(property, this.value(propertyKey));\n      this.whitespace();\n      const separator = this.source[this.offset];\n      if (separator === \"}\") {\n        this.offset++;\n        return object;\n      }\n      if (separator !== \",\") this.invalid(key, \"expected ',' or '}' in object\");\n      this.offset++;\n    }\n  }\n\n  private array(key: string): JsonValue[] {\n    this.offset++;\n    this.whitespace();\n    const values: JsonValue[] = [];\n    if (this.source[this.offset] === \"]\") {\n      this.offset++;\n      return values;\n    }\n    while (true) {\n      values.push(this.value(key));\n      this.whitespace();\n      const separator = this.source[this.offset];\n      if (separator === \"]\") {\n        this.offset++;\n        return values;\n      }\n      if (separator !== \",\") this.invalid(key, \"expected ',' or ']' in array\");\n      this.offset++;\n    }\n  }\n\n  private string(key: string): string {\n    const start = this.offset++;\n    let escaped = false;\n    while (this.offset < this.source.length) {\n      const character = this.source[this.offset++];\n      if (escaped) {\n        escaped = false;\n        continue;\n      }\n      if (character === \"\\\\\") {\n        escaped = true;\n        continue;\n      }\n      if (character === '\"') {\n        try {\n          return JSON.parse(this.source.slice(start, this.offset)) as string;\n        } catch {\n          this.invalid(key, \"invalid JSON string\");\n        }\n      }\n      if (character !== undefined && character.charCodeAt(0) < 0x20)\n        this.invalid(key, \"unescaped control character in JSON string\");\n    }\n    this.invalid(key, \"unterminated JSON string\");\n  }\n\n  private number(key: string): number {\n    const match = /-?(?:0|[1-9][0-9]*)(?:\\.[0-9]+)?(?:[eE][+-]?[0-9]+)?/y;\n    match.lastIndex = this.offset;\n    const token = match.exec(this.source)?.[0];\n    if (token === undefined) this.invalid(key, \"invalid JSON number\");\n    this.offset += token.length;\n    return Number(token);\n  }\n\n  private literal<T extends boolean | null>(written: string, value: T): T {\n    this.offset += written.length;\n    return value;\n  }\n\n  private whitespace(): void {\n    while (this.offset < this.source.length) {\n      const character = this.source[this.offset];\n      if (character === undefined || !\" \\t\\n\\r\".includes(character)) return;\n      this.offset++;\n    }\n  }\n\n  private invalid(key: string, detail: string): never {\n    fail(this.sourceFile, key, detail);\n  }\n}\n\nfunction assertNamespaceSegment(sourceFile: string, segment: string, key: string): void {\n  if (!SEGMENT.test(segment)) fail(sourceFile, key, \"segments must match [A-Za-z_][A-Za-z0-9_-]*\");\n  if (FORBIDDEN_SEGMENTS.has(segment)) fail(sourceFile, key, \"segments cannot be reserved\");\n}\n\nfunction assertSegment(sourceFile: string, segment: string, key: string): void {\n  if (segment.includes(\".\")) fail(sourceFile, key, \"JSON keys cannot contain '.'\");\n  assertNamespaceSegment(sourceFile, segment, key);\n}\n\nfunction explicitGroup(sourceFile: string, value: string): string {\n  if (value === \"\") fail(sourceFile, \"$group\", \"'$group' cannot be empty\");\n  for (const segment of value.split(\".\")) {\n    if (segment === \"\") fail(sourceFile, \"$group\", \"'$group' cannot contain empty segments\");\n    assertNamespaceSegment(sourceFile, segment, \"$group\");\n  }\n  return value;\n}\n\nfunction isObject(value: JsonValue): value is JsonObject {\n  return value instanceof Map;\n}\n\nfunction readLeaf(\n  sourceFile: string,\n  key: string,\n  value: JsonObject,\n  localeCodes: readonly string[] | undefined,\n): Record<string, string> {\n  const locales = localeCodes === undefined ? undefined : new Set(localeCodes);\n  const entry: Record<string, string> = Object.create(null) as Record<string, string>;\n  for (const [locale, translation] of value) {\n    if (!LOCALE_CODE.test(locale)) fail(sourceFile, `${key}.${locale}`, \"invalid locale code\");\n    if (typeof translation !== \"string\")\n      fail(sourceFile, `${key}.${locale}`, \"locale values must be strings\");\n    if (locales !== undefined && !locales.has(locale))\n      fail(sourceFile, `${key}.${locale}`, \"unknown locale code\");\n    entry[locale] = translation;\n  }\n  if (localeCodes !== undefined)\n    for (const locale of localeCodes)\n      if (!(locale in entry)) fail(sourceFile, key, `missing locale code \"${locale}\"`);\n  return entry;\n}\n\nfunction collectEntries(\n  sourceFile: string,\n  object: JsonObject,\n  group: string,\n  localeCodes: readonly string[] | undefined,\n  entries: LocaleDictionaryEntries,\n  nested: boolean,\n): void {\n  if (nested && object.size === 0) fail(sourceFile, group, \"nested objects cannot be empty\");\n  for (const [segment, value] of object) {\n    const key = group === \"\" ? segment : `${group}.${segment}`;\n    if (segment === \"$group\") fail(sourceFile, key, \"'$group' is only allowed at the root\");\n    assertSegment(sourceFile, segment, key);\n    if (!isObject(value)) fail(sourceFile, key, \"entries must be locale objects or nested objects\");\n    if (value.has(\"$group\"))\n      fail(sourceFile, `${key}.$group`, \"'$group' is only allowed at the root\");\n    const values = [...value.values()];\n    const hasString = values.some((item) => typeof item === \"string\");\n    const allObjects = values.every(isObject);\n    if (hasString) {\n      if (!values.every((item) => typeof item === \"string\"))\n        fail(sourceFile, key, \"cannot mix locale values with nested entries\");\n      entries[key] = readLeaf(sourceFile, key, value, localeCodes);\n      continue;\n    }\n    if (!allObjects) fail(sourceFile, key, \"cannot mix locale values with nested entries\");\n    if (localeCodes !== undefined && [...value.keys()].some((child) => localeCodes.includes(child)))\n      fail(sourceFile, key, \"cannot mix locale codes with nested entries\");\n    collectEntries(sourceFile, value, key, localeCodes, entries, true);\n  }\n}\n\n/** Parses one locale dictionary source without reading the filesystem or loading application code. */\nexport function parseLocaleDictionary(input: {\n  sourceFile: string;\n  source: string;\n  defaultNamespace: string;\n  localeCodes?: readonly string[];\n}): ParsedLocaleDictionary {\n  const { sourceFile, source, defaultNamespace, localeCodes } = input;\n  const parsed = new StrictJsonParser(sourceFile, source).parse();\n  if (!isObject(parsed)) fail(sourceFile, \"$\", \"root JSON value must be an object\");\n  const groupValue = parsed.get(\"$group\");\n  if (groupValue !== undefined && typeof groupValue !== \"string\")\n    fail(sourceFile, \"$group\", \"'$group' must be a string\");\n  const group =\n    groupValue === undefined\n      ? defaultNamespace === \"\"\n        ? \"\"\n        : explicitGroup(sourceFile, defaultNamespace)\n      : explicitGroup(sourceFile, groupValue);\n  const entries: LocaleDictionaryEntries = Object.create(null) as LocaleDictionaryEntries;\n  const rootEntries = new Map(parsed);\n  rootEntries.delete(\"$group\");\n  collectEntries(sourceFile, rootEntries, group, localeCodes, entries, false);\n  return { sourceFile, group, entries };\n}\n"],"mappings":"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"}
+{"version":3,"file":"parse-locale-dictionary.mjs","names":[],"sources":["../../../../../../../../packages/core/src/localization/parse-locale-dictionary.ts"],"sourcesContent":["export type LocaleDictionaryEntries = Record<string, Record<string, string>>;\n\nexport type ParsedLocaleDictionary = {\n  sourceFile: string;\n  group: string;\n  entries: LocaleDictionaryEntries;\n};\n\ntype JsonValue = string | number | boolean | null | JsonObject | JsonValue[];\ntype JsonObject = Map<string, JsonValue>;\n\nconst SEGMENT = /^[A-Za-z_][A-Za-z0-9_-]*$/;\nconst LOCALE_CODE = /^[A-Za-z][A-Za-z0-9]*(?:-[A-Za-z0-9]+)*$/;\nconst FORBIDDEN_SEGMENTS = new Set([\"__proto__\", \"prototype\", \"constructor\"]);\n\n/** A source error that always names both the locale file and the offending JSON key. */\nexport class LocaleDictionaryError extends Error {\n  public constructor(\n    public readonly sourceFile: string,\n    public readonly key: string,\n    detail: string,\n  ) {\n    super(`Cannot parse route locales in \"${sourceFile}\" at \"${key}\": ${detail}.`);\n    this.name = \"LocaleDictionaryError\";\n  }\n}\n\nfunction fail(sourceFile: string, key: string, detail: string): never {\n  throw new LocaleDictionaryError(sourceFile, key, detail);\n}\n\n/** A deliberately small JSON parser: unlike JSON.parse, it preserves duplicate property names. */\nclass StrictJsonParser {\n  private offset = 0;\n\n  public constructor(\n    private readonly sourceFile: string,\n    private readonly source: string,\n  ) {}\n\n  public parse(): JsonValue {\n    if (this.source.charCodeAt(0) === 0xfeff) this.offset = 1;\n    const value = this.value(\"$\");\n    this.whitespace();\n    if (this.offset !== this.source.length) this.invalid(\"$\", \"unexpected trailing JSON\");\n    return value;\n  }\n\n  private value(key: string): JsonValue {\n    this.whitespace();\n    const character = this.source[this.offset];\n    if (character === \"{\") return this.object(key);\n    if (character === \"[\") return this.array(key);\n    if (character === '\"') return this.string(key);\n    if (this.source.startsWith(\"true\", this.offset)) return this.literal(\"true\", true);\n    if (this.source.startsWith(\"false\", this.offset)) return this.literal(\"false\", false);\n    if (this.source.startsWith(\"null\", this.offset)) return this.literal(\"null\", null);\n    if (character === \"-\" || (character !== undefined && /[0-9]/.test(character)))\n      return this.number(key);\n    this.invalid(key, \"invalid JSON value\");\n  }\n\n  private object(key: string): JsonObject {\n    this.offset++;\n    this.whitespace();\n    const object = new Map<string, JsonValue>();\n    if (this.source[this.offset] === \"}\") {\n      this.offset++;\n      return object;\n    }\n    while (true) {\n      this.whitespace();\n      if (this.source[this.offset] !== '\"') this.invalid(key, \"object keys must be JSON strings\");\n      const property = this.string(key);\n      const propertyKey = `${key}.${property}`;\n      if (object.has(property)) this.invalid(propertyKey, \"duplicate JSON property\");\n      this.whitespace();\n      if (this.source[this.offset] !== \":\")\n        this.invalid(propertyKey, \"expected ':' after object key\");\n      this.offset++;\n      object.set(property, this.value(propertyKey));\n      this.whitespace();\n      const separator = this.source[this.offset];\n      if (separator === \"}\") {\n        this.offset++;\n        return object;\n      }\n      if (separator !== \",\") this.invalid(key, \"expected ',' or '}' in object\");\n      this.offset++;\n    }\n  }\n\n  private array(key: string): JsonValue[] {\n    this.offset++;\n    this.whitespace();\n    const values: JsonValue[] = [];\n    if (this.source[this.offset] === \"]\") {\n      this.offset++;\n      return values;\n    }\n    while (true) {\n      values.push(this.value(key));\n      this.whitespace();\n      const separator = this.source[this.offset];\n      if (separator === \"]\") {\n        this.offset++;\n        return values;\n      }\n      if (separator !== \",\") this.invalid(key, \"expected ',' or ']' in array\");\n      this.offset++;\n    }\n  }\n\n  private string(key: string): string {\n    const start = this.offset++;\n    let escaped = false;\n    while (this.offset < this.source.length) {\n      const character = this.source[this.offset++];\n      if (escaped) {\n        escaped = false;\n        continue;\n      }\n      if (character === \"\\\\\") {\n        escaped = true;\n        continue;\n      }\n      if (character === '\"') {\n        try {\n          return JSON.parse(this.source.slice(start, this.offset)) as string;\n        } catch {\n          this.invalid(key, \"invalid JSON string\");\n        }\n      }\n      if (character !== undefined && character.charCodeAt(0) < 0x20)\n        this.invalid(key, \"unescaped control character in JSON string\");\n    }\n    this.invalid(key, \"unterminated JSON string\");\n  }\n\n  private number(key: string): number {\n    const match = /-?(?:0|[1-9][0-9]*)(?:\\.[0-9]+)?(?:[eE][+-]?[0-9]+)?/y;\n    match.lastIndex = this.offset;\n    const token = match.exec(this.source)?.[0];\n    if (token === undefined) this.invalid(key, \"invalid JSON number\");\n    this.offset += token.length;\n    return Number(token);\n  }\n\n  private literal<T extends boolean | null>(written: string, value: T): T {\n    this.offset += written.length;\n    return value;\n  }\n\n  private whitespace(): void {\n    while (this.offset < this.source.length) {\n      const character = this.source[this.offset];\n      if (character === undefined || !\" \\t\\n\\r\".includes(character)) return;\n      this.offset++;\n    }\n  }\n\n  private invalid(key: string, detail: string): never {\n    fail(this.sourceFile, key, detail);\n  }\n}\n\nfunction assertNamespaceSegment(sourceFile: string, segment: string, key: string): void {\n  if (!SEGMENT.test(segment)) fail(sourceFile, key, \"segments must match [A-Za-z_][A-Za-z0-9_-]*\");\n  if (FORBIDDEN_SEGMENTS.has(segment)) fail(sourceFile, key, \"segments cannot be reserved\");\n}\n\nfunction assertSegment(sourceFile: string, segment: string, key: string): void {\n  if (segment.includes(\".\")) fail(sourceFile, key, \"JSON keys cannot contain '.'\");\n  assertNamespaceSegment(sourceFile, segment, key);\n}\n\nfunction explicitGroup(sourceFile: string, value: string): string {\n  if (value === \"\") fail(sourceFile, \"$group\", \"'$group' cannot be empty\");\n  for (const segment of value.split(\".\")) {\n    if (segment === \"\") fail(sourceFile, \"$group\", \"'$group' cannot contain empty segments\");\n    assertNamespaceSegment(sourceFile, segment, \"$group\");\n  }\n  return value;\n}\n\nfunction defaultGroup(sourceFile: string, defaultNamespace: string | (() => string)): string {\n  const namespace = typeof defaultNamespace === \"function\" ? defaultNamespace() : defaultNamespace;\n\n  return namespace === \"\" ? \"\" : explicitGroup(sourceFile, namespace);\n}\n\nfunction isObject(value: JsonValue): value is JsonObject {\n  return value instanceof Map;\n}\n\nfunction readLeaf(\n  sourceFile: string,\n  key: string,\n  value: JsonObject,\n  localeCodes: readonly string[] | undefined,\n): Record<string, string> {\n  const locales = localeCodes === undefined ? undefined : new Set(localeCodes);\n  const entry: Record<string, string> = Object.create(null) as Record<string, string>;\n  for (const [locale, translation] of value) {\n    if (!LOCALE_CODE.test(locale)) fail(sourceFile, `${key}.${locale}`, \"invalid locale code\");\n    if (typeof translation !== \"string\")\n      fail(sourceFile, `${key}.${locale}`, \"locale values must be strings\");\n    if (locales !== undefined && !locales.has(locale))\n      fail(sourceFile, `${key}.${locale}`, \"unknown locale code\");\n    entry[locale] = translation;\n  }\n  if (localeCodes !== undefined)\n    for (const locale of localeCodes)\n      if (!(locale in entry)) fail(sourceFile, key, `missing locale code \"${locale}\"`);\n  return entry;\n}\n\nfunction collectEntries(\n  sourceFile: string,\n  object: JsonObject,\n  group: string,\n  localeCodes: readonly string[] | undefined,\n  entries: LocaleDictionaryEntries,\n  nested: boolean,\n): void {\n  if (nested && object.size === 0) fail(sourceFile, group, \"nested objects cannot be empty\");\n  for (const [segment, value] of object) {\n    const key = group === \"\" ? segment : `${group}.${segment}`;\n    if (segment === \"$group\") fail(sourceFile, key, \"'$group' is only allowed at the root\");\n    assertSegment(sourceFile, segment, key);\n    if (!isObject(value)) fail(sourceFile, key, \"entries must be locale objects or nested objects\");\n    if (value.has(\"$group\"))\n      fail(sourceFile, `${key}.$group`, \"'$group' is only allowed at the root\");\n    const values = [...value.values()];\n    const hasString = values.some((item) => typeof item === \"string\");\n    const allObjects = values.every(isObject);\n    if (hasString) {\n      if (!values.every((item) => typeof item === \"string\"))\n        fail(sourceFile, key, \"cannot mix locale values with nested entries\");\n      entries[key] = readLeaf(sourceFile, key, value, localeCodes);\n      continue;\n    }\n    if (!allObjects) fail(sourceFile, key, \"cannot mix locale values with nested entries\");\n    if (localeCodes !== undefined && [...value.keys()].some((child) => localeCodes.includes(child)))\n      fail(sourceFile, key, \"cannot mix locale codes with nested entries\");\n    collectEntries(sourceFile, value, key, localeCodes, entries, true);\n  }\n}\n\n/** Parses one locale dictionary source without reading the filesystem or loading application code. */\nexport function parseLocaleDictionary(input: {\n  sourceFile: string;\n  source: string;\n  /**\n   * The group used when the file declares no `$group`. A function is called\n   * only in that case, so a namespace that cannot be derived (e.g. from a\n   * folder name) never fails a file that names its own `$group`.\n   */\n  defaultNamespace: string | (() => string);\n  localeCodes?: readonly string[];\n}): ParsedLocaleDictionary {\n  const { sourceFile, source, defaultNamespace, localeCodes } = input;\n  const parsed = new StrictJsonParser(sourceFile, source).parse();\n  if (!isObject(parsed)) fail(sourceFile, \"$\", \"root JSON value must be an object\");\n  const groupValue = parsed.get(\"$group\");\n  if (groupValue !== undefined && typeof groupValue !== \"string\")\n    fail(sourceFile, \"$group\", \"'$group' must be a string\");\n  const group =\n    groupValue === undefined\n      ? defaultGroup(sourceFile, defaultNamespace)\n      : explicitGroup(sourceFile, groupValue);\n  const entries: LocaleDictionaryEntries = Object.create(null) as LocaleDictionaryEntries;\n  const rootEntries = new Map(parsed);\n  rootEntries.delete(\"$group\");\n  collectEntries(sourceFile, rootEntries, group, localeCodes, entries, false);\n  return { sourceFile, group, entries };\n}\n"],"mappings":"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"}

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

@@ -1,4 +1,4 @@
-//#region ../core/src/localization/register-locale-dictionary.d.ts
+//#region ../../packages/core/src/localization/register-locale-dictionary.d.ts
 declare function registerGroupedTranslationKeys(sourceFile: string, keys: readonly string[]): void;
 /** Undo JSON entries during HMR while preserving unrelated global translations. */
 declare function unregisterLocaleDictionary(sourceFile: string): void;

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

@@ -1 +1 @@
-{"version":3,"file":"register-locale-dictionary.d.mts","names":[],"sources":["../../../../../../../core/src/localization/register-locale-dictionary.ts"],"mappings":";iBAwBgB,8BAAA,CAA+B,UAAA,UAAoB,IAAuB;AAA1F;AAAA,iBAKgB,0BAAA,CAA2B,UAAkB;AAAA,iBAyB7C,wBAAA,CAAyB,KAAA;EACvC,UAAA;EACA,MAAA;EACA,gBAAA;AAAA"}
+{"version":3,"file":"register-locale-dictionary.d.mts","names":[],"sources":["../../../../../../../../packages/core/src/localization/register-locale-dictionary.ts"],"mappings":";iBAwBgB,8BAAA,CAA+B,UAAA,UAAoB,IAAuB;AAA1F;AAAA,iBAKgB,0BAAA,CAA2B,UAAkB;AAAA,iBAyB7C,wBAAA,CAAyB,KAAA;EACvC,UAAA;EACA,MAAA;EACA,gBAAA;AAAA"}

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

@@ -2,7 +2,7 @@ import { parseLocaleDictionary } from "./parse-locale-dictionary.mjs";
 import config from "@mongez/config";
 import { getTranslationsList, groupedTranslations, setTranslationsList } from "@mongez/localization";
 
-//#region ../core/src/localization/register-locale-dictionary.ts
+//#region ../../packages/core/src/localization/register-locale-dictionary.ts
 const owners = /* @__PURE__ */ new Map();
 const keysBySource = /* @__PURE__ */ new Map();
 function claim(sourceFile, kind, keys) {