@visulima/storage 1.0.9 → 1.0.11

package/dist/transformer/image-transformer.d.ts

@@ -1,576 +1,577 @@
 import { Readable } from 'node:stream';
-import { F as File, g as FileReturn, B as BaseStorage } from "../packem_shared/storage.d-CEM1upWM.js";
-import { I as ImageTransformerConfig, T as TransformResult, R as ResizeOptions, C as CropOptions, g as RotateOptions, h as ImageFormat, i as TransformOptions, S as SharpenOptions, j as BlurOptions, k as MedianOptions, l as CLAHEOptions, m as ConvolveOptions, n as ThresholdOptions, o as BooleanOptions, L as LinearOptions, p as RecombineOptions, q as ModulateOptions, r as TintOptions, G as GreyscaleOptions, s as ColourspaceOptions, E as ExtractChannelOptions, J as JoinChannelOptions, t as BandboolOptions, u as AffineOptions, D as DilateOptions, v as ErodeOptions, P as PipelineColourspaceOptions, w as ToColourspaceOptions, x as RemoveAlphaOptions, y as EnsureAlphaOptions, z as TransformationStep, B as BaseTransformer } from "../packem_shared/types.d-CrUWY4On.js";
+import { F as File, g as FileReturn, B as BaseStorage } from "../packem_shared/storage.d-DwdJrArF.js";
+import { I as ImageTransformerConfig, T as TransformResult, R as ResizeOptions, C as CropOptions, g as RotateOptions, h as ImageFormat, i as TransformOptions, S as SharpenOptions, j as BlurOptions, k as MedianOptions, l as CLAHEOptions, m as ConvolveOptions, n as ThresholdOptions, o as BooleanOptions, L as LinearOptions, p as RecombineOptions, q as ModulateOptions, r as TintOptions, G as GreyscaleOptions, s as ColourspaceOptions, E as ExtractChannelOptions, J as JoinChannelOptions, t as BandboolOptions, u as AffineOptions, D as DilateOptions, v as ErodeOptions, P as PipelineColourspaceOptions, w as ToColourspaceOptions, x as RemoveAlphaOptions, y as EnsureAlphaOptions, z as TransformationStep, B as BaseTransformer } from "../packem_shared/types.d-BEUv414z.js";
+import 'node:timers';
 import 'node:crypto';
 import 'node:http';
 import 'lru-cache';
 /**
-* Image transformer that uses storage backends to retrieve and transform images.
-* @template TFile The file type used by this transformer.
-* @template TFileReturn The return type for file retrieval operations.
-*
-* Supports URL-based transformations with query parameters for on-demand image processing.
-* @example
-* ```ts
-* const transformer = new ImageTransformer(storage, {
-*   maxImageSize: 10 * 1024 * 1024, // 10MB
-*   cache: new Map()
-* });
-*
-* // Programmatic usage - resize an image
-* const result = await transformer.resize('image-id', {
-*   width: 800,
-*   height: 600,
-*   fit: 'cover'
-* });
-*
-* // URL-based transformations
-* // GET /files/image-id?width=300&height=200&fit=cover&quality=80
-* // GET /files/image-id?width=800&quality=90&lossless=true
-* ```
-*
-* ## Supported Query Parameters
-*
-* - `width`: Width in pixels (Number)
-* - `height`: Height in pixels (Number)
-* - `fit`: Resize fit mode - cover/contain/fill/inside/outside
-* - `position`: Position for cover/contain fits - center/top/right/bottom/left etc.
-* - `quality`: Quality for JPEG/WebP (0-100)
-* - `lossless`: Use lossless compression for WebP (Boolean)
-* - `effort`: CPU effort for AVIF (0-10, higher = slower but better)
-* - `alphaQuality`: Quality of alpha layer for WebP (0-100)
-* - `loop`: GIF animation iterations, 0 for infinite (Number)
-* - `delay`: GIF delay between frames in milliseconds (Number)
-*/
+ * Image transformer that uses storage backends to retrieve and transform images.
+ * @template TFile The file type used by this transformer.
+ * @template TFileReturn The return type for file retrieval operations.
+ *
+ * Supports URL-based transformations with query parameters for on-demand image processing.
+ * @example
+ * ```ts
+ * const transformer = new ImageTransformer(storage, {
+ *   maxImageSize: 10 * 1024 * 1024, // 10MB
+ *   cache: new Map()
+ * });
+ *
+ * // Programmatic usage - resize an image
+ * const result = await transformer.resize('image-id', {
+ *   width: 800,
+ *   height: 600,
+ *   fit: 'cover'
+ * });
+ *
+ * // URL-based transformations
+ * // GET /files/image-id?width=300&height=200&fit=cover&quality=80
+ * // GET /files/image-id?width=800&quality=90&lossless=true
+ * ```
+ *
+ * ## Supported Query Parameters
+ *
+ * - `width`: Width in pixels (Number)
+ * - `height`: Height in pixels (Number)
+ * - `fit`: Resize fit mode - cover/contain/fill/inside/outside
+ * - `position`: Position for cover/contain fits - center/top/right/bottom/left etc.
+ * - `quality`: Quality for JPEG/WebP (0-100)
+ * - `lossless`: Use lossless compression for WebP (Boolean)
+ * - `effort`: CPU effort for AVIF (0-10, higher = slower but better)
+ * - `alphaQuality`: Quality of alpha layer for WebP (0-100)
+ * - `loop`: GIF animation iterations, 0 for infinite (Number)
+ * - `delay`: GIF delay between frames in milliseconds (Number)
+ */
 declare class ImageTransformer<TFile extends File = File, TFileReturn extends FileReturn = FileReturn> extends BaseTransformer<ImageTransformerConfig, TransformResult<TFileReturn>, TFile, TFileReturn> {
   /**
-  * Creates a new ImageTransformer instance.
-  * @param storage The storage backend for retrieving and storing image files.
-  * @param config Configuration options for image transformation including cache settings and size limits.
-  */
+   * Creates a new ImageTransformer instance.
+   * @param storage The storage backend for retrieving and storing image files.
+   * @param config Configuration options for image transformation including cache settings and size limits.
+   */
   constructor(storage: BaseStorage<TFile, TFileReturn>, config?: ImageTransformerConfig);
   /**
-  * Returns a sharp() invocation that applies the transformer's configured decompression-bomb defenses.
-  */
+   * Returns a sharp() invocation that applies the transformer's configured decompression-bomb defenses.
+   */
   private openImage;
   /**
-  * Resizes an image to specified dimensions with optional fit mode.
-  * @param fileId Unique identifier of the image file to resize.
-  * @param options Resize options including width, height, and fit mode.
-  * @returns Promise resolving to transformed image result.
-  */
+   * Resizes an image to specified dimensions with optional fit mode.
+   * @param fileId Unique identifier of the image file to resize.
+   * @param options Resize options including width, height, and fit mode.
+   * @returns Promise resolving to transformed image result.
+   */
   resize(fileId: string, options: ResizeOptions): Promise<TransformResult<TFileReturn>>;
   /**
-  * Crops an image to the specified region.
-  * @param fileId Unique identifier of the image file to crop.
-  * @param options Crop options including region coordinates.
-  * @returns Promise resolving to transformed image result.
-  */
+   * Crops an image to the specified region.
+   * @param fileId Unique identifier of the image file to crop.
+   * @param options Crop options including region coordinates.
+   * @returns Promise resolving to transformed image result.
+   */
   crop(fileId: string, options: CropOptions): Promise<TransformResult<TFileReturn>>;
   /**
-  * Rotates an image by the specified angle.
-  * @param fileId Unique identifier of the image file to rotate.
-  * @param options Rotate options including angle.
-  * @returns Promise resolving to transformed image result.
-  */
+   * Rotates an image by the specified angle.
+   * @param fileId Unique identifier of the image file to rotate.
+   * @param options Rotate options including angle.
+   * @returns Promise resolving to transformed image result.
+   */
   rotate(fileId: string, options: RotateOptions): Promise<TransformResult<TFileReturn>>;
   /**
-  * Converts an image to the specified format.
-  * @param fileId Unique identifier of the image file to convert.
-  * @param format Target image format (e.g., "jpeg", "png", "webp").
-  * @param options Additional transform options.
-  * @returns Promise resolving to transformed image result.
-  */
+   * Converts an image to the specified format.
+   * @param fileId Unique identifier of the image file to convert.
+   * @param format Target image format (e.g., "jpeg", "png", "webp").
+   * @param options Additional transform options.
+   * @returns Promise resolving to transformed image result.
+   */
   convertFormat(fileId: string, format: ImageFormat, options?: TransformOptions): Promise<TransformResult<TFileReturn>>;
   /**
-  * Applies sharpening filter to an image.
-  * @param fileId Unique identifier of the image file to sharpen.
-  * @param options Sharpen options including sigma and flat/jagged threshold.
-  * @returns Promise resolving to transformed image result.
-  */
+   * Applies sharpening filter to an image.
+   * @param fileId Unique identifier of the image file to sharpen.
+   * @param options Sharpen options including sigma and flat/jagged threshold.
+   * @returns Promise resolving to transformed image result.
+   */
   sharpen(fileId: string, options?: SharpenOptions): Promise<TransformResult<TFileReturn>>;
   /**
-  * Applies blurring filter to an image.
-  * @param fileId Unique identifier of the image file to blur.
-  * @param options Blur options including sigma.
-  * @returns Promise resolving to transformed image result.
-  */
+   * Applies blurring filter to an image.
+   * @param fileId Unique identifier of the image file to blur.
+   * @param options Blur options including sigma.
+   * @returns Promise resolving to transformed image result.
+   */
   blur(fileId: string, options?: BlurOptions): Promise<TransformResult<TFileReturn>>;
   /**
-  * Applies median filter to an image for noise reduction.
-  * @param fileId Unique identifier of the image file to process.
-  * @param options Median filter options including radius.
-  * @returns Promise resolving to transformed image result.
-  */
+   * Applies median filter to an image for noise reduction.
+   * @param fileId Unique identifier of the image file to process.
+   * @param options Median filter options including radius.
+   * @returns Promise resolving to transformed image result.
+   */
   median(fileId: string, options?: MedianOptions): Promise<TransformResult<TFileReturn>>;
   /**
-  * Applies CLAHE (Contrast Limited Adaptive Histogram Equalization) to an image.
-  * @param fileId Unique identifier of the image file to process.
-  * @param options CLAHE options including width, height, and maxSlope.
-  * @returns Promise resolving to transformed image result.
-  */
+   * Applies CLAHE (Contrast Limited Adaptive Histogram Equalization) to an image.
+   * @param fileId Unique identifier of the image file to process.
+   * @param options CLAHE options including width, height, and maxSlope.
+   * @returns Promise resolving to transformed image result.
+   */
   clahe(fileId: string, options?: CLAHEOptions): Promise<TransformResult<TFileReturn>>;
   /**
-  * Applies convolution kernel to an image.
-  * @param fileId Unique identifier of the image file to process.
-  * @param options Convolve options including kernel matrix.
-  * @returns Promise resolving to transformed image result.
-  */
+   * Applies convolution kernel to an image.
+   * @param fileId Unique identifier of the image file to process.
+   * @param options Convolve options including kernel matrix.
+   * @returns Promise resolving to transformed image result.
+   */
   convolve(fileId: string, options: ConvolveOptions): Promise<TransformResult<TFileReturn>>;
   /**
-  * Applies thresholding to an image to create a binary image.
-  * @param fileId Unique identifier of the image file to process.
-  * @param options Threshold options including threshold value.
-  * @returns Promise resolving to transformed image result.
-  */
+   * Applies thresholding to an image to create a binary image.
+   * @param fileId Unique identifier of the image file to process.
+   * @param options Threshold options including threshold value.
+   * @returns Promise resolving to transformed image result.
+   */
   threshold(fileId: string, options?: ThresholdOptions): Promise<TransformResult<TFileReturn>>;
   /**
-  * Applies boolean operation to an image.
-  * @param fileId Unique identifier of the image file to process.
-  * @param options Boolean operation options including operator and operand.
-  * @returns Promise resolving to transformed image result.
-  */
+   * Applies boolean operation to an image.
+   * @param fileId Unique identifier of the image file to process.
+   * @param options Boolean operation options including operator and operand.
+   * @returns Promise resolving to transformed image result.
+   */
   boolean(fileId: string, options: BooleanOptions): Promise<TransformResult<TFileReturn>>;
   /**
-  * Applies linear transformation to an image.
-  * @param fileId Unique identifier of the image file to process.
-  * @param options Linear transformation options including a and b coefficients.
-  * @returns Promise resolving to transformed image result.
-  */
+   * Applies linear transformation to an image.
+   * @param fileId Unique identifier of the image file to process.
+   * @param options Linear transformation options including a and b coefficients.
+   * @returns Promise resolving to transformed image result.
+   */
   linear(fileId: string, options: LinearOptions): Promise<TransformResult<TFileReturn>>;
   /**
-  * Applies recombine transformation to an image using a matrix.
-  * @param fileId Unique identifier of the image file to process.
-  * @param options Recombine options including matrix coefficients.
-  * @returns Promise resolving to transformed image result.
-  */
+   * Applies recombine transformation to an image using a matrix.
+   * @param fileId Unique identifier of the image file to process.
+   * @param options Recombine options including matrix coefficients.
+   * @returns Promise resolving to transformed image result.
+   */
   recombine(fileId: string, options: RecombineOptions): Promise<TransformResult<TFileReturn>>;
   /**
-  * Applies modulation (brightness, saturation, hue) to an image.
-  * @param fileId Unique identifier of the image file to process.
-  * @param options Modulate options including brightness, saturation, and hue.
-  * @returns Promise resolving to transformed image result.
-  */
+   * Applies modulation (brightness, saturation, hue) to an image.
+   * @param fileId Unique identifier of the image file to process.
+   * @param options Modulate options including brightness, saturation, and hue.
+   * @returns Promise resolving to transformed image result.
+   */
   modulate(fileId: string, options: ModulateOptions): Promise<TransformResult<TFileReturn>>;
   /**
-  * Applies tinting to an image.
-  * @param fileId Unique identifier of the image file to process.
-  * @param options Tint options including RGB color values.
-  * @returns Promise resolving to transformed image result.
-  */
+   * Applies tinting to an image.
+   * @param fileId Unique identifier of the image file to process.
+   * @param options Tint options including RGB color values.
+   * @returns Promise resolving to transformed image result.
+   */
   tint(fileId: string, options: TintOptions): Promise<TransformResult<TFileReturn>>;
   /**
-  * Converts an image to greyscale.
-  * @param fileId Unique identifier of the image file to convert.
-  * @param options Greyscale conversion options.
-  * @returns Promise resolving to transformed image result.
-  */
+   * Converts an image to greyscale.
+   * @param fileId Unique identifier of the image file to convert.
+   * @param options Greyscale conversion options.
+   * @returns Promise resolving to transformed image result.
+   */
   greyscale(fileId: string, options?: GreyscaleOptions): Promise<TransformResult<TFileReturn>>;
   /**
-  * Converts an image to a different colourspace.
-  * @param fileId Unique identifier of the image file to convert.
-  * @param options Colourspace conversion options including target colourspace.
-  * @returns Promise resolving to transformed image result.
-  */
+   * Converts an image to a different colourspace.
+   * @param fileId Unique identifier of the image file to convert.
+   * @param options Colourspace conversion options including target colourspace.
+   * @returns Promise resolving to transformed image result.
+   */
   colourspace(fileId: string, options: ColourspaceOptions): Promise<TransformResult<TFileReturn>>;
   /**
-  * Extracts a specific channel from an image.
-  * @param fileId Unique identifier of the image file to process.
-  * @param options Extract channel options including channel index.
-  * @returns Promise resolving to transformed image result.
-  */
+   * Extracts a specific channel from an image.
+   * @param fileId Unique identifier of the image file to process.
+   * @param options Extract channel options including channel index.
+   * @returns Promise resolving to transformed image result.
+   */
   extractChannel(fileId: string, options: ExtractChannelOptions): Promise<TransformResult<TFileReturn>>;
   /**
-  * Joins channels to an image.
-  * @param fileId Unique identifier of the image file to process.
-  * @param options Join channel options including channel sources.
-  * @returns Promise resolving to transformed image result.
-  */
+   * Joins channels to an image.
+   * @param fileId Unique identifier of the image file to process.
+   * @param options Join channel options including channel sources.
+   * @returns Promise resolving to transformed image result.
+   */
   joinChannel(fileId: string, options: JoinChannelOptions): Promise<TransformResult<TFileReturn>>;
   /**
-  * Applies band boolean operation to an image.
-  * @param fileId Unique identifier of the image file to process.
-  * @param options Band boolean options including operator.
-  * @returns Promise resolving to transformed image result.
-  */
+   * Applies band boolean operation to an image.
+   * @param fileId Unique identifier of the image file to process.
+   * @param options Band boolean options including operator.
+   * @returns Promise resolving to transformed image result.
+   */
   bandbool(fileId: string, options: BandboolOptions): Promise<TransformResult<TFileReturn>>;
   /**
-  * Auto-orients an image based on EXIF orientation data.
-  * @param fileId Unique identifier of the image file to orient.
-  * @param options Additional transform options.
-  * @returns Promise resolving to transformed image result.
-  */
+   * Auto-orients an image based on EXIF orientation data.
+   * @param fileId Unique identifier of the image file to orient.
+   * @param options Additional transform options.
+   * @returns Promise resolving to transformed image result.
+   */
   autoOrient(fileId: string, options?: TransformOptions): Promise<TransformResult<TFileReturn>>;
   /**
-  * Flips an image vertically.
-  * @param fileId Unique identifier of the image file to flip.
-  * @param options Additional transform options.
-  * @returns Promise resolving to transformed image result.
-  */
+   * Flips an image vertically.
+   * @param fileId Unique identifier of the image file to flip.
+   * @param options Additional transform options.
+   * @returns Promise resolving to transformed image result.
+   */
   flip(fileId: string, options?: TransformOptions): Promise<TransformResult<TFileReturn>>;
   /**
-  * Flops an image horizontally.
-  * @param fileId Unique identifier of the image file to flop.
-  * @param options Additional transform options.
-  * @returns Promise resolving to transformed image result.
-  */
+   * Flops an image horizontally.
+   * @param fileId Unique identifier of the image file to flop.
+   * @param options Additional transform options.
+   * @returns Promise resolving to transformed image result.
+   */
   flop(fileId: string, options?: TransformOptions): Promise<TransformResult<TFileReturn>>;
   /**
-  * Flattens an image alpha channel onto a background color.
-  * @param fileId Unique identifier of the image file to flatten.
-  * @param options Additional transform options.
-  * @returns Promise resolving to transformed image result.
-  */
+   * Flattens an image alpha channel onto a background color.
+   * @param fileId Unique identifier of the image file to flatten.
+   * @param options Additional transform options.
+   * @returns Promise resolving to transformed image result.
+   */
   flatten(fileId: string, options?: TransformOptions): Promise<TransformResult<TFileReturn>>;
   /**
-  * Unflattens an image alpha channel.
-  * @param fileId Unique identifier of the image file to unflatten.
-  * @param options Additional transform options.
-  * @returns Promise resolving to transformed image result.
-  */
+   * Unflattens an image alpha channel.
+   * @param fileId Unique identifier of the image file to unflatten.
+   * @param options Additional transform options.
+   * @returns Promise resolving to transformed image result.
+   */
   unflatten(fileId: string, options?: TransformOptions): Promise<TransformResult<TFileReturn>>;
   /**
-  * Applies gamma correction to an image.
-  * @param fileId Unique identifier of the image file to process.
-  * @param options Additional transform options.
-  * @returns Promise resolving to transformed image result.
-  */
+   * Applies gamma correction to an image.
+   * @param fileId Unique identifier of the image file to process.
+   * @param options Additional transform options.
+   * @returns Promise resolving to transformed image result.
+   */
   gamma(fileId: string, options?: TransformOptions): Promise<TransformResult<TFileReturn>>;
   /**
-  * Negates (inverts) an image.
-  * @param fileId Unique identifier of the image file to negate.
-  * @param options Additional transform options.
-  * @returns Promise resolving to transformed image result.
-  */
+   * Negates (inverts) an image.
+   * @param fileId Unique identifier of the image file to negate.
+   * @param options Additional transform options.
+   * @returns Promise resolving to transformed image result.
+   */
   negate(fileId: string, options?: TransformOptions): Promise<TransformResult<TFileReturn>>;
   /**
-  * Normalises an image by enhancing contrast.
-  * @param fileId Unique identifier of the image file to normalise.
-  * @param options Additional transform options.
-  * @returns Promise resolving to transformed image result.
-  */
+   * Normalises an image by enhancing contrast.
+   * @param fileId Unique identifier of the image file to normalise.
+   * @param options Additional transform options.
+   * @returns Promise resolving to transformed image result.
+   */
   normalise(fileId: string, options?: TransformOptions): Promise<TransformResult<TFileReturn>>;
   /**
-  * Applies affine transformation to an image.
-  * @param fileId Unique identifier of the image file to transform.
-  * @param options Affine transformation options including matrix.
-  * @returns Promise resolving to transformed image result.
-  */
+   * Applies affine transformation to an image.
+   * @param fileId Unique identifier of the image file to transform.
+   * @param options Affine transformation options including matrix.
+   * @returns Promise resolving to transformed image result.
+   */
   affine(fileId: string, options: AffineOptions): Promise<TransformResult<TFileReturn>>;
   /**
-  * Applies dilation (morphological operation) to an image.
-  * @param fileId Unique identifier of the image file to process.
-  * @param options Dilate options including iterations.
-  * @returns Promise resolving to transformed image result.
-  */
+   * Applies dilation (morphological operation) to an image.
+   * @param fileId Unique identifier of the image file to process.
+   * @param options Dilate options including iterations.
+   * @returns Promise resolving to transformed image result.
+   */
   dilate(fileId: string, options?: DilateOptions): Promise<TransformResult<TFileReturn>>;
   /**
-  * Applies erosion (morphological operation) to an image.
-  * @param fileId Unique identifier of the image file to process.
-  * @param options Erode options including iterations.
-  * @returns Promise resolving to transformed image result.
-  */
+   * Applies erosion (morphological operation) to an image.
+   * @param fileId Unique identifier of the image file to process.
+   * @param options Erode options including iterations.
+   * @returns Promise resolving to transformed image result.
+   */
   erode(fileId: string, options?: ErodeOptions): Promise<TransformResult<TFileReturn>>;
   /**
-  * Sets pipeline colourspace for an image.
-  * @param fileId Unique identifier of the image file to process.
-  * @param options Pipeline colourspace options including colourspace.
-  * @returns Promise resolving to transformed image result.
-  */
+   * Sets pipeline colourspace for an image.
+   * @param fileId Unique identifier of the image file to process.
+   * @param options Pipeline colourspace options including colourspace.
+   * @returns Promise resolving to transformed image result.
+   */
   pipelineColourspace(fileId: string, options: PipelineColourspaceOptions): Promise<TransformResult<TFileReturn>>;
   /**
-  * Converts colourspace of an image.
-  * @param fileId Unique identifier of the image file to convert.
-  * @param options ToColourspace options including target colourspace.
-  * @returns Promise resolving to transformed image result.
-  */
+   * Converts colourspace of an image.
+   * @param fileId Unique identifier of the image file to convert.
+   * @param options ToColourspace options including target colourspace.
+   * @returns Promise resolving to transformed image result.
+   */
   toColourspace(fileId: string, options: ToColourspaceOptions): Promise<TransformResult<TFileReturn>>;
   /**
-  * Removes alpha channel from an image.
-  * @param fileId Unique identifier of the image file to process.
-  * @param options RemoveAlpha transformation options.
-  * @returns Promise resolving to transformed image result.
-  */
+   * Removes alpha channel from an image.
+   * @param fileId Unique identifier of the image file to process.
+   * @param options RemoveAlpha transformation options.
+   * @returns Promise resolving to transformed image result.
+   */
   removeAlpha(fileId: string, options?: RemoveAlphaOptions): Promise<TransformResult<TFileReturn>>;
   /**
-  * Ensures alpha channel exists in an image.
-  * @param fileId Unique identifier of the image file to process.
-  * @param options EnsureAlpha transformation options.
-  * @returns Promise resolving to transformed image result.
-  */
+   * Ensures alpha channel exists in an image.
+   * @param fileId Unique identifier of the image file to process.
+   * @param options EnsureAlpha transformation options.
+   * @returns Promise resolving to transformed image result.
+   */
   ensureAlpha(fileId: string, options?: EnsureAlphaOptions): Promise<TransformResult<TFileReturn>>;
   /**
-  * Applies a custom transformation pipeline to an image.
-  * @param fileId Unique identifier of the image file to transform.
-  * @param steps Array of transformation steps to apply in sequence.
-  * @returns Promise resolving to transformed image result.
-  */
+   * Applies a custom transformation pipeline to an image.
+   * @param fileId Unique identifier of the image file to transform.
+   * @param steps Array of transformation steps to apply in sequence.
+   * @returns Promise resolving to transformed image result.
+   */
   transform(fileId: string, steps: TransformationStep[]): Promise<TransformResult<TFileReturn>>;
   /**
-  * Streams transform of a file (for large files, falls back to regular transform).
-  * @param fileId Unique identifier of the image file to transform.
-  * @param steps Array of transformation steps to apply in sequence.
-  * @returns Promise resolving to stream with headers and size information.
-  */
+   * Streams transform of a file (for large files, falls back to regular transform).
+   * @param fileId Unique identifier of the image file to transform.
+   * @param steps Array of transformation steps to apply in sequence.
+   * @returns Promise resolving to stream with headers and size information.
+   */
   override transformStream(fileId: string, steps: TransformationStep[]): Promise<{
     headers?: Record<string, string>;
     size?: number;
     stream: Readable;
   }>;
   /**
-  * Applies multiple transformations in sequence using Sharp.
-  * @param buffer The original image buffer.
-  * @param steps Array of transformation steps to apply.
-  * @returns Promise resolving to transformed image buffer.
-  * @private
-  */
+   * Applies multiple transformations in sequence using Sharp.
+   * @param buffer The original image buffer.
+   * @param steps Array of transformation steps to apply.
+   * @returns Promise resolving to transformed image buffer.
+   * @private
+   */
   private applyTransformations;
   /**
-  * Applies resize transformation using Sharp.
-  * @param sharpInstance The Sharp instance to modify.
-  * @param options Resize transformation options.
-  * @returns Modified Sharp instance with resize applied.
-  * @private
-  */
+   * Applies resize transformation using Sharp.
+   * @param sharpInstance The Sharp instance to modify.
+   * @param options Resize transformation options.
+   * @returns Modified Sharp instance with resize applied.
+   * @private
+   */
   private applyResize;
   /**
-  * Applies crop transformation using Sharp.
-  * @param sharpInstance The Sharp instance to modify.
-  * @param options Crop transformation options.
-  * @returns Modified Sharp instance with crop applied.
-  * @private
-  */
+   * Applies crop transformation using Sharp.
+   * @param sharpInstance The Sharp instance to modify.
+   * @param options Crop transformation options.
+   * @returns Modified Sharp instance with crop applied.
+   * @private
+   */
   private applyCrop;
   /**
-  * Applies rotate transformation using Sharp.
-  * @param sharpInstance The Sharp instance to modify.
-  * @param options Rotate transformation options.
-  * @returns Modified Sharp instance with rotation applied.
-  * @private
-  */
+   * Applies rotate transformation using Sharp.
+   * @param sharpInstance The Sharp instance to modify.
+   * @param options Rotate transformation options.
+   * @returns Modified Sharp instance with rotation applied.
+   * @private
+   */
   private applyRotate;
   /**
-  * Applies sharpen transformation using Sharp.
-  * @param sharpInstance The Sharp instance to modify.
-  * @param options Sharpen transformation options.
-  * @returns Modified Sharp instance with sharpening applied.
-  * @private
-  */
+   * Applies sharpen transformation using Sharp.
+   * @param sharpInstance The Sharp instance to modify.
+   * @param options Sharpen transformation options.
+   * @returns Modified Sharp instance with sharpening applied.
+   * @private
+   */
   private applySharpen;
   /**
-  * Applies blur transformation using Sharp.
-  * @param sharpInstance The Sharp instance to modify.
-  * @param options Blur transformation options.
-  * @returns Modified Sharp instance with blurring applied.
-  * @private
-  */
+   * Applies blur transformation using Sharp.
+   * @param sharpInstance The Sharp instance to modify.
+   * @param options Blur transformation options.
+   * @returns Modified Sharp instance with blurring applied.
+   * @private
+   */
   private applyBlur;
   /**
-  * Applies median filter using Sharp.
-  * @param sharpInstance The Sharp instance to modify.
-  * @param options Median transformation options.
-  * @returns Modified Sharp instance with median filter applied.
-  * @private
-  */
+   * Applies median filter using Sharp.
+   * @param sharpInstance The Sharp instance to modify.
+   * @param options Median transformation options.
+   * @returns Modified Sharp instance with median filter applied.
+   * @private
+   */
   private applyMedian;
   /**
-  * Applies CLAHE (Contrast Limited Adaptive Histogram Equalization) using Sharp.
-  * @param sharpInstance The Sharp instance to modify.
-  * @param options CLAHE transformation options.
-  * @returns Modified Sharp instance with CLAHE applied.
-  * @private
-  */
+   * Applies CLAHE (Contrast Limited Adaptive Histogram Equalization) using Sharp.
+   * @param sharpInstance The Sharp instance to modify.
+   * @param options CLAHE transformation options.
+   * @returns Modified Sharp instance with CLAHE applied.
+   * @private
+   */
   private applyCLAHE;
   /**
-  * Applies convolution using Sharp.
-  * @param sharpInstance The Sharp instance to modify.
-  * @param options Convolution transformation options.
-  * @returns Modified Sharp instance with convolution applied.
-  * @private
-  */
+   * Applies convolution using Sharp.
+   * @param sharpInstance The Sharp instance to modify.
+   * @param options Convolution transformation options.
+   * @returns Modified Sharp instance with convolution applied.
+   * @private
+   */
   private applyConvolve;
   /**
-  * Applies threshold using Sharp.
-  * @param sharpInstance The Sharp instance to modify.
-  * @param options Threshold transformation options.
-  * @returns Modified Sharp instance with thresholding applied.
-  * @private
-  */
+   * Applies threshold using Sharp.
+   * @param sharpInstance The Sharp instance to modify.
+   * @param options Threshold transformation options.
+   * @returns Modified Sharp instance with thresholding applied.
+   * @private
+   */
   private applyThreshold;
   /**
-  * Applies boolean operation using Sharp.
-  * @param sharpInstance The Sharp instance to modify.
-  * @param options Boolean operation options.
-  * @returns Modified Sharp instance with boolean operation applied.
-  * @private
-  */
+   * Applies boolean operation using Sharp.
+   * @param sharpInstance The Sharp instance to modify.
+   * @param options Boolean operation options.
+   * @returns Modified Sharp instance with boolean operation applied.
+   * @private
+   */
   private applyBoolean;
   /**
-  * Applies linear transformation using Sharp.
-  * @param sharpInstance The Sharp instance to modify.
-  * @param options Linear transformation options.
-  * @returns Modified Sharp instance with linear transformation applied.
-  * @private
-  */
+   * Applies linear transformation using Sharp.
+   * @param sharpInstance The Sharp instance to modify.
+   * @param options Linear transformation options.
+   * @returns Modified Sharp instance with linear transformation applied.
+   * @private
+   */
   private applyLinear;
   /**
-  * Applies recombine transformation using Sharp.
-  * @param sharpInstance The Sharp instance to modify.
-  * @param options Recombine transformation options.
-  * @returns Modified Sharp instance with recombine applied.
-  * @private
-  */
+   * Applies recombine transformation using Sharp.
+   * @param sharpInstance The Sharp instance to modify.
+   * @param options Recombine transformation options.
+   * @returns Modified Sharp instance with recombine applied.
+   * @private
+   */
   private applyRecombine;
   /**
-  * Applies modulate transformation using Sharp.
-  * @param sharpInstance The Sharp instance to modify.
-  * @param options Modulate transformation options.
-  * @returns Modified Sharp instance with modulation applied.
-  * @private
-  */
+   * Applies modulate transformation using Sharp.
+   * @param sharpInstance The Sharp instance to modify.
+   * @param options Modulate transformation options.
+   * @returns Modified Sharp instance with modulation applied.
+   * @private
+   */
   private applyModulate;
   /**
-  * Applies tint using Sharp.
-  * @param sharpInstance The Sharp instance to modify.
-  * @param options Tint transformation options.
-  * @returns Modified Sharp instance with tinting applied.
-  * @private
-  */
+   * Applies tint using Sharp.
+   * @param sharpInstance The Sharp instance to modify.
+   * @param options Tint transformation options.
+   * @returns Modified Sharp instance with tinting applied.
+   * @private
+   */
   private applyTint;
   /**
-  * Applies greyscale conversion using Sharp.
-  * @param sharpInstance The Sharp instance to modify.
-  * @param options Greyscale transformation options.
-  * @returns Modified Sharp instance converted to greyscale.
-  * @private
-  */
+   * Applies greyscale conversion using Sharp.
+   * @param sharpInstance The Sharp instance to modify.
+   * @param options Greyscale transformation options.
+   * @returns Modified Sharp instance converted to greyscale.
+   * @private
+   */
   private applyGreyscale;
   /**
-  * Applies colourspace conversion using Sharp.
-  * @param sharpInstance The Sharp instance to modify.
-  * @param options Colourspace transformation options.
-  * @returns Modified Sharp instance with colourspace conversion.
-  * @private
-  */
+   * Applies colourspace conversion using Sharp.
+   * @param sharpInstance The Sharp instance to modify.
+   * @param options Colourspace transformation options.
+   * @returns Modified Sharp instance with colourspace conversion.
+   * @private
+   */
   private applyColourspace;
   /**
-  * Extracts channel using Sharp.
-  * @param sharpInstance The Sharp instance to modify.
-  * @param options Channel extraction options including channel index.
-  * @returns Modified Sharp instance with channel extracted.
-  * @private
-  */
+   * Extracts channel using Sharp.
+   * @param sharpInstance The Sharp instance to modify.
+   * @param options Channel extraction options including channel index.
+   * @returns Modified Sharp instance with channel extracted.
+   * @private
+   */
   private applyExtractChannel;
   /**
-  * Joins channels using Sharp.
-  * @param sharpInstance The Sharp instance to modify.
-  * @param options Channel joining options including image sources.
-  * @returns Modified Sharp instance with channels joined.
-  * @private
-  */
+   * Joins channels using Sharp.
+   * @param sharpInstance The Sharp instance to modify.
+   * @param options Channel joining options including image sources.
+   * @returns Modified Sharp instance with channels joined.
+   * @private
+   */
   private applyJoinChannel;
   /**
-  * Applies band boolean operation using Sharp.
-  * @param sharpInstance The Sharp instance to modify.
-  * @param options Band boolean options including operator.
-  * @returns Modified Sharp instance with band boolean operation applied.
-  * @private
-  */
+   * Applies band boolean operation using Sharp.
+   * @param sharpInstance The Sharp instance to modify.
+   * @param options Band boolean options including operator.
+   * @returns Modified Sharp instance with band boolean operation applied.
+   * @private
+   */
   private applyBandbool;
   /**
-  * Applies affine transformation using Sharp.
-  * @param sharpInstance The Sharp instance to modify.
-  * @param options Affine transformation options including matrix.
-  * @returns Modified Sharp instance with affine transformation applied.
-  * @private
-  */
+   * Applies affine transformation using Sharp.
+   * @param sharpInstance The Sharp instance to modify.
+   * @param options Affine transformation options including matrix.
+   * @returns Modified Sharp instance with affine transformation applied.
+   * @private
+   */
   private applyAffine;
   /**
-  * Applies dilation using Sharp.
-  * @param sharpInstance The Sharp instance to modify.
-  * @param options Dilate options including kernel size.
-  * @returns Modified Sharp instance with dilation applied.
-  * @private
-  */
+   * Applies dilation using Sharp.
+   * @param sharpInstance The Sharp instance to modify.
+   * @param options Dilate options including kernel size.
+   * @returns Modified Sharp instance with dilation applied.
+   * @private
+   */
   private applyDilate;
   /**
-  * Applies erosion using Sharp.
-  * @param sharpInstance The Sharp instance to modify.
-  * @param options Erode options including kernel size.
-  * @returns Modified Sharp instance with erosion applied.
-  * @private
-  */
+   * Applies erosion using Sharp.
+   * @param sharpInstance The Sharp instance to modify.
+   * @param options Erode options including kernel size.
+   * @returns Modified Sharp instance with erosion applied.
+   * @private
+   */
   private applyErode;
   /**
-  * Applies pipeline colourspace using Sharp.
-  * @param sharpInstance The Sharp instance to modify.
-  * @param options Pipeline colourspace options including target colourspace.
-  * @returns Modified Sharp instance with pipeline colourspace applied.
-  * @private
-  */
+   * Applies pipeline colourspace using Sharp.
+   * @param sharpInstance The Sharp instance to modify.
+   * @param options Pipeline colourspace options including target colourspace.
+   * @returns Modified Sharp instance with pipeline colourspace applied.
+   * @private
+   */
   private applyPipelineColourspace;
   /**
-  * Applies to colourspace conversion using Sharp.
-  * @param sharpInstance The Sharp instance to modify.
-  * @param options To colourspace options including target colourspace.
-  * @returns Modified Sharp instance with colourspace conversion applied.
-  * @private
-  */
+   * Applies to colourspace conversion using Sharp.
+   * @param sharpInstance The Sharp instance to modify.
+   * @param options To colourspace options including target colourspace.
+   * @returns Modified Sharp instance with colourspace conversion applied.
+   * @private
+   */
   private applyToColourspace;
   /**
-  * Applies remove alpha using Sharp.
-  * @param sharpInstance The Sharp instance to modify.
-  * @param options Remove alpha transformation options.
-  * @returns Modified Sharp instance with alpha channel removed.
-  * @private
-  */
+   * Applies remove alpha using Sharp.
+   * @param sharpInstance The Sharp instance to modify.
+   * @param options Remove alpha transformation options.
+   * @returns Modified Sharp instance with alpha channel removed.
+   * @private
+   */
   private applyRemoveAlpha;
   /**
-  * Applies ensure alpha using Sharp.
-  * @param sharpInstance The Sharp instance to modify.
-  * @param options Ensure alpha transformation options.
-  * @returns Modified Sharp instance with alpha channel ensured.
-  * @private
-  */
+   * Applies ensure alpha using Sharp.
+   * @param sharpInstance The Sharp instance to modify.
+   * @param options Ensure alpha transformation options.
+   * @returns Modified Sharp instance with alpha channel ensured.
+   * @private
+   */
   private applyEnsureAlpha;
   /**
-  * Applies format and quality transformation using Sharp.
-  * @param sharpInstance The Sharp instance to modify.
-  * @param options Format and quality transformation options.
-  * @returns Modified Sharp instance with format and quality settings applied.
-  * @private
-  */
+   * Applies format and quality transformation using Sharp.
+   * @param sharpInstance The Sharp instance to modify.
+   * @param options Format and quality transformation options.
+   * @returns Modified Sharp instance with format and quality settings applied.
+   * @private
+   */
   private applyFormatAndQuality;
   /**
-  * Gets format-specific options for Sharp.
-  * @param options Transform options containing format-specific settings.
-  * @returns Record of format options for Sharp processing.
-  * @private
-  */
+   * Gets format-specific options for Sharp.
+   * @param options Transform options containing format-specific settings.
+   * @returns Record of format options for Sharp processing.
+   * @private
+   */
   private getFormatOptions;
   /**
-  * Validates that the file is a supported image.
-  * @param file The file to validate.
-  * @returns Promise that resolves if validation passes.
-  * @throws Error if file size exceeds limits, wrong content type, unsupported format, or invalid image.
-  * @private
-  */
+   * Validates that the file is a supported image.
+   * @param file The file to validate.
+   * @returns Promise that resolves if validation passes.
+   * @throws Error if file size exceeds limits, wrong content type, unsupported format, or invalid image.
+   * @private
+   */
   private validateImage;
   /**
-  * Creates transformation result with metadata.
-  * @param buffer The transformed image buffer.
-  * @param originalFile The original file information.
-  * @returns Image transformation result with metadata.
-  * @private
-  */
+   * Creates transformation result with metadata.
+   * @param buffer The transformed image buffer.
+   * @param originalFile The original file information.
+   * @returns Image transformation result with metadata.
+   * @private
+   */
   private createTransformResult;
   /**
-  * Generates cache key for transformation.
-  * @param fileId The file identifier.
-  * @param steps Array of transformation steps.
-  * @returns Unique cache key string.
-  * @private
-  */
+   * Generates cache key for transformation.
+   * @param fileId The file identifier.
+   * @param steps Array of transformation steps.
+   * @returns Unique cache key string.
+   * @private
+   */
   private generateCacheKey;
 }
 export { ImageTransformer as default };