@visulima/storage 1.0.0-alpha.8 → 1.0.0

package/dist/packem_shared/types.d-CrUWY4On.d.ts

@@ -0,0 +1,720 @@
+import { C as Cache, F as File, g as FileReturn, B as BaseStorage } from "./storage.d-CEM1upWM.js";
+import { Readable } from 'node:stream';
+/**
+* Base transformer configuration with common properties
+*/
+interface BaseTransformerConfig {
+  /** Cache instance to use for caching */
+  cache?: Cache;
+  /** Cache TTL in seconds */
+  cacheTtl?: number;
+  /** Logger instance */
+  logger?: Console;
+  /** Maximum number of cached items */
+  maxCacheSize?: number;
+  /** Supported input formats */
+  supportedFormats?: string[] | undefined;
+}
+/**
+* Abstract base class for all media transformers.
+*
+* Provides a common interface and shared functionality for image, video, and audio transformers.
+* All transformers must implement the abstract methods defined here.
+*/
+declare abstract class BaseTransformer<Config extends BaseTransformerConfig, CacheValue extends object, TFile extends File = File, TFileReturn extends FileReturn = FileReturn> {
+  protected readonly storage: BaseStorage<TFile, TFileReturn>;
+  protected config: Config;
+  protected logger?: Console;
+  protected cache?: Cache<string, CacheValue>;
+  /**
+  * Creates a new BaseTransformer instance with common functionality.
+  * @param storage The storage backend for retrieving and storing files.
+  * @param config Configuration options for the transformer.
+  * @param logger Optional logger instance for logging operations.
+  * @protected
+  */
+  protected constructor(storage: BaseStorage<TFile, TFileReturn>, config: Config, logger?: Console);
+  /**
+  * Transforms a file with the given steps.
+  * @param fileId Unique identifier of the file to transform.
+  * @param steps Array of transformation steps to apply.
+  * @returns Promise resolving to transformation result.
+  */
+  abstract transform(fileId: string, steps: any[]): Promise<any>;
+  /**
+  * Streams transform of a file with the given steps (for large files).
+  * @param fileId Unique identifier of the file to transform.
+  * @param steps Array of transformation steps to apply.
+  * @returns Promise resolving to streaming result with headers, size, and stream.
+  */
+  transformStream?(fileId: string, steps: any[]): Promise<{
+    headers?: Record<string, string>;
+    size?: number;
+    stream: Readable;
+  }>;
+  /**
+  * Clears cache for a specific file or all files.
+  *
+  * Cache keys are `${fileId}:${stepsHash}` (see `generateCacheKey` in subclasses),
+  * so per-file invalidation must iterate keys to find every transform of `fileId`.
+  * Falls back to a full `clear()` when the underlying cache doesn't expose `keys()`.
+  * @param fileId Optional file identifier to clear cache for specific file.
+  */
+  clearCache(fileId?: string): void;
+  /**
+  * Gets cache statistics.
+  * @returns Cache statistics including max size and current size.
+  */
+  getCacheStats(): {
+    maxSize: number;
+    size: number;
+  };
+  /**
+  * Gets content type from transformation result based on format.
+  * @param result Transformation result object containing format information.
+  * @returns Content type string (MIME type).
+  */
+  protected getContentTypeFromResult(result: any): string;
+}
+/**
+* Supported image formats for transformation
+*/
+type ImageFormat = "jpeg" | "png" | "webp" | "avif" | "tiff" | "gif";
+/**
+* Image transformation options
+*/
+interface TransformOptions {
+  /** Quality of alpha layer for WebP (0-100) */
+  alphaQuality?: number;
+  /** Compression level for PNG (0-9) */
+  compressionLevel?: number;
+  /** GIF delay(s) between animation frames (in milliseconds) */
+  delay?: number;
+  /** Effort for AVIF encoding (0-10) */
+  effort?: number;
+  /** Output format */
+  format?: ImageFormat;
+  /** GIF number of animation iterations, use 0 for infinite */
+  loop?: number;
+  /** Whether to use lossless compression for WebP */
+  lossless?: boolean;
+  /** Whether to use progressive encoding for JPEG */
+  progressive?: boolean;
+  /** Quality for JPEG/WebP images (1-100) */
+  quality?: number;
+}
+/**
+* Sharpen transformation options
+*/
+interface SharpenOptions extends TransformOptions {
+  /** M1 for sharpen formula */
+  m1?: number;
+  /** M2 for sharpen formula */
+  m2?: number;
+  /** Sigma for Gaussian blur */
+  sigma?: number;
+  /** X1 for sharpen formula */
+  x1?: number;
+  /** Y2 for sharpen formula */
+  y2?: number;
+  /** Y3 for sharpen formula */
+  y3?: number;
+}
+/**
+* Blur transformation options
+*/
+interface BlurOptions extends TransformOptions {
+  /** M1 for blur formula */
+  m1?: number;
+  /** M2 for blur formula */
+  m2?: number;
+  /** Sigma for Gaussian blur */
+  sigma?: number;
+  /** X1 for blur formula */
+  x1?: number;
+  /** Y2 for blur formula */
+  y2?: number;
+  /** Y3 for blur formula */
+  y3?: number;
+}
+/**
+* Median transformation options
+*/
+interface MedianOptions extends TransformOptions {
+  /** Size of the median filter */
+  size?: number;
+}
+/**
+* CLAHE (Contrast Limited Adaptive Histogram Equalization) options
+*/
+interface CLAHEOptions extends TransformOptions {
+  /** Height of the tile grid */
+  height?: number;
+  /** Maximum slope value for contrast limiting */
+  maxSlope?: number;
+  /** Width of the tile grid */
+  width?: number;
+}
+/**
+* Convolve transformation options
+*/
+interface ConvolveOptions extends TransformOptions {
+  /** Height of the kernel in pixels */
+  height?: number;
+  /** Kernel values as flat array */
+  kernel?: number[];
+  /** Offset value */
+  offset?: number;
+  /** Scale factor */
+  scale?: number;
+  /** Width of the kernel in pixels */
+  width?: number;
+}
+/**
+* Threshold transformation options
+*/
+interface ThresholdOptions extends TransformOptions {
+  /** Alternative spelling for greyscale */
+  grayscale?: boolean;
+  /** Convert to greyscale */
+  greyscale?: boolean;
+  /** Threshold value (0-255) */
+  threshold?: number;
+}
+/**
+* Boolean operation options
+*/
+interface BooleanOptions extends TransformOptions {
+  /** Operand image buffer or path */
+  operand: Buffer | string;
+  /** Boolean operation: and, or, eor */
+  operator: "and" | "or" | "eor";
+  /** Raw operand options */
+  raw?: {
+    channels: number;
+    height: number;
+    width: number;
+  };
+}
+/**
+* Linear transformation options
+*/
+interface LinearOptions extends TransformOptions {
+  /** Multiplier values (per channel or single value) */
+  a?: number | number[];
+  /** Offset values (per channel or single value) */
+  b?: number | number[];
+}
+/**
+* Recombine transformation options
+*/
+interface RecombineOptions extends TransformOptions {
+  /** 3x3 or 4x4 recombination matrix */
+  matrix: number[][];
+}
+/**
+* Modulate transformation options
+*/
+interface ModulateOptions extends TransformOptions {
+  /** Brightness multiplier */
+  brightness?: number;
+  /** Hue rotation in degrees */
+  hue?: number;
+  /** Lightness adjustment */
+  lightness?: number;
+  /** Saturation multiplier */
+  saturation?: number;
+}
+/**
+* Tint transformation options
+*/
+interface TintOptions extends TransformOptions {
+  /** RGB tint values */
+  rgb: [number, number, number] | string;
+}
+/**
+* Greyscale transformation options
+*/
+interface GreyscaleOptions extends TransformOptions {
+  /** Alternative spelling */
+  grayscale?: boolean;
+  /** Convert to greyscale */
+  greyscale?: boolean;
+}
+/**
+* Colourspace transformation options
+*/
+interface ColourspaceOptions extends TransformOptions {
+  /** Target colourspace */
+  colourspace: "srgb" | "rgb" | "cmyk" | "lab" | "b-w";
+}
+/**
+* Channel extraction options
+*/
+interface ExtractChannelOptions extends TransformOptions {
+  /** Channel to extract (0-3 for RGBA) */
+  channel: number;
+}
+/**
+* Options for joining multiple images as color channels into a single image.
+*/
+interface JoinChannelOptions extends TransformOptions {
+  /** Images to join as channels */
+  images: (Buffer | string)[];
+}
+/**
+* Options for performing boolean operations on image bands.
+*/
+interface BandboolOptions extends TransformOptions {
+  /** Boolean operation: and, or, eor */
+  operator: "and" | "or" | "eor";
+}
+/**
+* Options for applying affine transformations (rotation, scaling, shearing, translation) to images.
+*/
+interface AffineOptions extends TransformOptions {
+  /** Background color for areas outside the transformed image */
+  background?: string;
+  /** Interpolation method */
+  interpolation?: "nearest" | "bilinear" | "bicubic" | "nohalo" | "lbb" | "vsqbs";
+  /** 2x3 transformation matrix */
+  matrix: [number, number, number, number, number, number];
+}
+/**
+* Options for applying morphological dilation operation to images.
+*/
+interface DilateOptions extends TransformOptions {
+  /** Kernel size for dilation */
+  kernelSize?: number;
+}
+/**
+* Options for applying morphological erosion operation to images.
+*/
+interface ErodeOptions extends TransformOptions {
+  /** Kernel size for erosion */
+  kernelSize?: number;
+}
+/**
+* Options for setting the colourspace used for internal processing pipeline operations.
+*/
+interface PipelineColourspaceOptions extends TransformOptions {
+  /** Colourspace for internal operations */
+  colourspace: "rgb" | "srgb" | "cmyk" | "lab" | "b-w";
+}
+/**
+* Options for converting images to a target colourspace.
+*/
+interface ToColourspaceOptions extends TransformOptions {
+  /** Target colourspace */
+  colourspace: "srgb" | "rgb" | "cmyk" | "lab" | "b-w";
+}
+/**
+* Remove alpha channel options
+*/
+interface RemoveAlphaOptions extends TransformOptions {
+  /** Background color to composite over alpha channel */
+  background?: string;
+}
+/**
+* Ensure alpha channel options
+*/
+interface EnsureAlphaOptions extends TransformOptions {
+  /** Alpha channel value to add */
+  alpha?: number;
+}
+/**
+* Resize transformation options
+*/
+interface ResizeOptions extends TransformOptions {
+  /** Background color for fill fit */
+  background?: string;
+  /** Whether to skip enlargement during initial load */
+  fastShrinkOnLoad?: boolean;
+  /** Resize fit mode */
+  fit?: "cover" | "contain" | "fill" | "inside" | "outside";
+  /** Height in pixels */
+  height?: number;
+  /** Resize kernel */
+  kernel?: "nearest" | "cubic" | "mitchell" | "lanczos2" | "lanczos3";
+  /** Position for cover/contain fits */
+  position?: string | number;
+  /** Width in pixels */
+  width?: number;
+  /** Whether to avoid enlarging images smaller than specified dimensions */
+  withoutEnlargement?: boolean;
+  /** Whether to avoid reducing images larger than specified dimensions */
+  withoutReduction?: boolean;
+}
+/**
+* Crop transformation options
+*/
+interface CropOptions extends TransformOptions {
+  /** Crop area height */
+  height: number;
+  /** Crop area left offset */
+  left: number;
+  /** Crop area top offset */
+  top: number;
+  /** Crop area width */
+  width: number;
+}
+/**
+* Rotate transformation options
+*/
+interface RotateOptions extends TransformOptions {
+  /** Rotation angle in degrees. Note: angles other than 90°, 180°, and 270° require interpolation and may affect image quality */
+  angle: number;
+  /** Background color for rotation */
+  background?: string;
+}
+/**
+* Transformation pipeline step
+*/
+interface TransformationStep {
+  options: TransformOptions | ResizeOptions | CropOptions | RotateOptions | SharpenOptions | BlurOptions | MedianOptions | CLAHEOptions | ConvolveOptions | ThresholdOptions | BooleanOptions | LinearOptions | RecombineOptions | ModulateOptions | TintOptions | GreyscaleOptions | ColourspaceOptions | ExtractChannelOptions | JoinChannelOptions | BandboolOptions | AffineOptions | DilateOptions | ErodeOptions | PipelineColourspaceOptions | ToColourspaceOptions | RemoveAlphaOptions | EnsureAlphaOptions;
+  type: "resize" | "crop" | "rotate" | "format" | "quality" | "sharpen" | "blur" | "median" | "clahe" | "convolve" | "threshold" | "boolean" | "linear" | "recombine" | "modulate" | "tint" | "greyscale" | "colourspace" | "extractChannel" | "joinChannel" | "bandbool" | "autoOrient" | "flip" | "flop" | "affine" | "dilate" | "erode" | "pipelineColourspace" | "toColourspace" | "removeAlpha" | "ensureAlpha" | "flatten" | "unflatten" | "gamma" | "negate" | "normalise" | "normalize";
+}
+/**
+* Generic transformation pipeline step (for any media type)
+*/
+interface MediaTransformationStep {
+  options: TransformOptions | ResizeOptions | CropOptions | RotateOptions | SharpenOptions | BlurOptions | MedianOptions | CLAHEOptions | ConvolveOptions | ThresholdOptions | BooleanOptions | LinearOptions | RecombineOptions | ModulateOptions | TintOptions | GreyscaleOptions | ColourspaceOptions | ExtractChannelOptions | JoinChannelOptions | BandboolOptions | VideoTransformOptions | VideoResizeOptions | VideoCropOptions | VideoRotateOptions | AudioTransformOptions | AudioChannelMixOptions | AudioResampleOptions;
+  type: "resize" | "crop" | "rotate" | "format" | "quality" | "sharpen" | "blur" | "median" | "clahe" | "convolve" | "threshold" | "boolean" | "linear" | "recombine" | "modulate" | "tint" | "greyscale" | "colourspace" | "extractChannel" | "joinChannel" | "bandbool" | "autoOrient" | "flip" | "flop" | "affine" | "dilate" | "erode" | "flatten" | "unflatten" | "gamma" | "negate" | "normalise" | "normalize" | "codec" | "bitrate" | "frameRate" | "resample" | "channels";
+}
+/**
+* Video transformation options
+*/
+interface VideoTransformOptions extends TransformOptions {
+  /** Video bitrate */
+  bitrate?: number;
+  /** Video codec */
+  codec?: "avc" | "hevc" | "vp8" | "vp9" | "av1";
+  /** Frame rate in Hz */
+  frameRate?: number;
+  /** Key frame interval in seconds */
+  keyFrameInterval?: number;
+}
+/**
+* Audio transformation options
+*/
+interface AudioTransformOptions extends TransformOptions {
+  /** Audio bitrate */
+  bitrate?: number;
+  /** Audio codec */
+  codec?: "aac" | "opus" | "mp3" | "vorbis" | "flac";
+  /** Number of channels */
+  numberOfChannels?: number;
+  /** Sample rate in Hz */
+  sampleRate?: number;
+}
+/**
+* Video resize transformation options
+*/
+interface VideoResizeOptions extends VideoTransformOptions {
+  /** Resize fit mode */
+  fit?: "cover" | "contain" | "fill" | "inside" | "outside";
+  /** Height in pixels */
+  height?: number;
+  /** Position for cover/contain fits */
+  position?: string | number;
+  /** Width in pixels */
+  width?: number;
+  /** Whether to avoid enlarging videos smaller than specified dimensions */
+  withoutEnlargement?: boolean;
+  /** Whether to avoid reducing videos larger than specified dimensions */
+  withoutReduction?: boolean;
+}
+/**
+* Video crop transformation options
+*/
+interface VideoCropOptions extends VideoTransformOptions {
+  /** Crop area height */
+  height: number;
+  /** Crop area left offset */
+  left: number;
+  /** Crop area top offset */
+  top: number;
+  /** Crop area width */
+  width: number;
+}
+/**
+* Video rotate transformation options
+*/
+interface VideoRotateOptions extends VideoTransformOptions {
+  /** Rotation angle in degrees. Note: angles other than 90°, 180°, and 270° require interpolation and may affect video quality */
+  angle: number;
+  /** Background color for rotation */
+  background?: string;
+}
+/**
+* Audio channel mix transformation options
+*/
+interface AudioChannelMixOptions extends AudioTransformOptions {
+  /** Number of output channels */
+  numberOfChannels: number;
+}
+/**
+* Audio resample transformation options
+*/
+interface AudioResampleOptions extends AudioTransformOptions {
+  /** Output sample rate in Hz */
+  sampleRate: number;
+}
+/**
+* Video transformation pipeline step
+*/
+interface VideoTransformationStep {
+  options: VideoTransformOptions | VideoResizeOptions | VideoCropOptions | VideoRotateOptions;
+  type: "resize" | "crop" | "rotate" | "format" | "codec" | "bitrate" | "frameRate";
+}
+/**
+* Audio transformation pipeline step
+*/
+interface AudioTransformationStep {
+  options: AudioTransformOptions | AudioChannelMixOptions | AudioResampleOptions;
+  type: "resample" | "channels" | "format" | "codec" | "bitrate";
+}
+/**
+* Image transformation result
+*/
+interface TransformResult<TFileReturn extends FileReturn = FileReturn> {
+  /** Transformed image buffer */
+  buffer: Buffer;
+  /** Image format */
+  format: string;
+  /** Image height in pixels */
+  height: number;
+  /** Original file information */
+  originalFile: TFileReturn;
+  /** Image size in bytes */
+  size: number;
+  /** Image width in pixels */
+  width: number;
+}
+/**
+* Video transformation result
+*/
+interface VideoTransformResult<TFileReturn extends FileReturn = FileReturn> extends TransformResult<TFileReturn> {
+  /** Video bitrate */
+  bitrate?: number;
+  /** Video duration in seconds */
+  duration: number;
+}
+/**
+* Audio transformation result
+*/
+interface AudioTransformResult<TFileReturn extends FileReturn = FileReturn> extends Omit<TransformResult<TFileReturn>, "width" | "height"> {
+  /** Audio bitrate */
+  bitrate?: number;
+  /** Audio duration in seconds */
+  duration: number;
+  /** Number of channels */
+  numberOfChannels: number;
+  /** Sample rate in Hz */
+  sampleRate: number;
+}
+/**
+* Media transformer configuration (unified config for all transformers)
+*/
+interface MediaTransformerConfig<TFile extends File = File, TFileReturn extends FileReturn = FileReturn> {
+  /** Default audio bitrate */
+  audioBitrate?: number;
+  /** Default audio codec */
+  audioCodec?: "aac" | "opus" | "mp3" | "vorbis" | "flac";
+  /** Audio transformer class (optional, enables audio transformations) */
+  AudioTransformer?: new (storage: BaseStorage<TFile, TFileReturn>, config: AudioTransformerConfig) => BaseTransformer<AudioTransformerConfig, AudioTransformResult<TFileReturn>, TFile, TFileReturn>;
+  /** Cache instance to use for caching */
+  cache?: Cache;
+  /** Cache TTL in seconds */
+  cacheTtl?: number;
+  /** Image transformer class (optional, enables image transformations) */
+  ImageTransformer?: new (storage: BaseStorage<TFile, TFileReturn>, config: ImageTransformerConfig) => BaseTransformer<ImageTransformerConfig, TransformResult<TFileReturn>, TFile, TFileReturn>;
+  /** Logger instance */
+  logger?: Console;
+  /** Maximum audio size to process (in bytes) */
+  maxAudioSize?: number;
+  /** Maximum image size to process (in bytes) */
+  maxImageSize?: number;
+  /** Maximum video size to process (in bytes) */
+  maxVideoSize?: number;
+  /** Save transformed files to storage for reuse */
+  saveTransformedFiles?: boolean;
+  /** Supported audio input formats */
+  supportedAudioFormats?: string[];
+  /** Supported image input formats */
+  supportedImageFormats?: string[];
+  /** Supported video input formats */
+  supportedVideoFormats?: string[];
+  /** Default video bitrate */
+  videoBitrate?: number;
+  /** Default video codec */
+  videoCodec?: "avc" | "hevc" | "vp8" | "vp9" | "av1";
+  /** Video transformer class (optional, enables video transformations) */
+  VideoTransformer?: new (storage: BaseStorage<TFile, TFileReturn>, config: VideoTransformerConfig) => BaseTransformer<VideoTransformerConfig, VideoTransformResult<TFileReturn>, TFile, TFileReturn>;
+}
+/**
+* Unified media transformation result
+*/
+interface MediaTransformResult<TFileReturn extends FileReturn = FileReturn> {
+  /** Video-specific properties */
+  bitrate?: number;
+  /** Transformed media buffer */
+  buffer: Buffer;
+  /** Video/Audio-specific properties */
+  duration?: number;
+  /** Media format */
+  format: string;
+  /** Image/Video-specific properties */
+  height?: number;
+  /** Media type */
+  mediaType: "image" | "video" | "audio";
+  /** Audio-specific properties */
+  numberOfChannels?: number;
+  /** Original file information */
+  originalFile: TFileReturn;
+  /** Audio-specific properties */
+  sampleRate?: number;
+  /** Media size in bytes */
+  size: number;
+  /** Image-specific properties */
+  width?: number;
+}
+/**
+* Query parameters for media transformation
+*/
+interface MediaTransformQuery {
+  /** Apply affine transformation */
+  affine?: boolean;
+  /** Rotation angle in degrees. Note: angles other than 90°, 180°, and 270° require interpolation and may affect media quality */
+  angle?: number;
+  /** Background color for rotation */
+  background?: string;
+  /** Video bitrate in bits per second */
+  bitrate?: number;
+  /** Apply blur effect */
+  blur?: boolean;
+  /** Brightness multiplier for modulation */
+  brightness?: number;
+  /** Apply CLAHE (Contrast Limited Adaptive Histogram Equalization) */
+  clahe?: boolean;
+  /** Video codec */
+  codec?: "avc" | "hevc" | "vp8" | "vp9" | "av1" | "aac" | "opus" | "mp3" | "vorbis" | "flac";
+  /** Crop area height */
+  cropHeight?: number;
+  /** Crop area width */
+  cropWidth?: number;
+  /** Apply dilation */
+  dilate?: boolean;
+  /** Ensure alpha channel */
+  ensureAlpha?: boolean;
+  /** Apply erosion */
+  erode?: boolean;
+  /** Fast shrink on load */
+  fastShrinkOnLoad?: boolean;
+  /** Resize fit mode */
+  fit?: "cover" | "contain" | "fill" | "inside" | "outside";
+  /** Flatten alpha channel */
+  flatten?: boolean;
+  /** Flip image vertically */
+  flip?: boolean;
+  /** Flop image horizontally */
+  flop?: boolean;
+  /** Output format */
+  format?: string;
+  /** Frame rate in Hz */
+  frameRate?: number;
+  /** Apply gamma correction */
+  gamma?: boolean;
+  /** Convert to greyscale */
+  greyscale?: boolean;
+  /** Height in pixels */
+  height?: number;
+  /** Hue rotation in degrees for modulation */
+  hue?: number;
+  /** Resize kernel */
+  kernel?: string;
+  /** Key frame interval in seconds */
+  keyFrameInterval?: number;
+  /** Crop area left offset */
+  left?: number;
+  /** Lightness adjustment for modulation */
+  lightness?: number;
+  /** Apply median filter with specified size */
+  median?: number;
+  /** Apply modulation effects */
+  modulate?: boolean;
+  /** Negate (invert) the image */
+  negate?: boolean;
+  /** Normalise the image */
+  normalise?: boolean;
+  /** Number of channels */
+  numberOfChannels?: number;
+  /** Set pipeline colourspace */
+  pipelineColourspace?: boolean;
+  /** Position for cover/contain fits */
+  position?: string | number;
+  /** Quality (0-100 for images, bitrate for video/audio) */
+  quality?: number;
+  /** Remove alpha channel */
+  removeAlpha?: boolean;
+  /** Sample rate in Hz */
+  sampleRate?: number;
+  /** Saturation multiplier for modulation */
+  saturation?: number;
+  /** Apply sharpening */
+  sharpen?: boolean;
+  /** Apply thresholding with specified value */
+  threshold?: number;
+  /** Apply tinting */
+  tint?: boolean;
+  /** Convert to colourspace */
+  toColourspace?: boolean;
+  /** Crop area top offset */
+  top?: number;
+  /** Unflatten alpha channel */
+  unflatten?: boolean;
+  /** Width in pixels */
+  width?: number;
+  /** Whether to avoid enlarging smaller images */
+  withoutEnlargement?: boolean;
+  /** Whether to avoid reducing larger images */
+  withoutReduction?: boolean;
+}
+/**
+* Image transformer configuration
+*/
+interface ImageTransformerConfig extends BaseTransformerConfig {
+  /** Sharp `failOn` setting controlling which libvips warnings abort decoding. Defaults to `"warning"`. */
+  failOn?: "error" | "none" | "truncated" | "warning";
+  /** Maximum total pixels (width * height) Sharp will decode. Defaults to 268435456 (16k x 16k). */
+  limitInputPixels?: false | number;
+  /** Reject images taller than this many pixels (post-decode metadata check). */
+  maxImageHeight?: number;
+  /** Maximum image size to process (in bytes) */
+  maxImageSize?: number;
+  /** Reject images wider than this many pixels (post-decode metadata check). */
+  maxImageWidth?: number;
+}
+/**
+* Video transformer configuration
+*/
+interface VideoTransformerConfig extends BaseTransformerConfig {
+  /** Default video bitrate */
+  defaultBitrate?: number;
+  /** Default video codec */
+  defaultCodec?: "avc" | "hevc" | "vp8" | "vp9" | "av1";
+  /** Maximum video size to process (in bytes) */
+  maxVideoSize?: number;
+}
+/**
+* Audio transformer configuration
+*/
+interface AudioTransformerConfig extends BaseTransformerConfig {
+  /** Default audio bitrate */
+  defaultBitrate?: number;
+  /** Default audio codec */
+  defaultCodec?: "aac" | "opus" | "mp3" | "vorbis" | "flac";
+  /** Maximum audio size to process (in bytes) */
+  maxAudioSize?: number;
+}
+export { AudioTransformerConfig as A, BaseTransformer as B, CropOptions as C, DilateOptions as D, ExtractChannelOptions as E, VideoTransformResult as F, GreyscaleOptions as G, VideoResizeOptions as H, ImageTransformerConfig as I, JoinChannelOptions as J, VideoCropOptions as K, LinearOptions as L, MediaTransformerConfig as M, VideoRotateOptions as N, VideoTransformOptions as O, PipelineColourspaceOptions as P, VideoTransformationStep as Q, ResizeOptions as R, SharpenOptions as S, TransformResult as T, MediaTransformQuery as U, VideoTransformerConfig as V, MediaTransformationStep as W, MediaTransformResult as a, AudioTransformResult as b, AudioResampleOptions as c, AudioChannelMixOptions as d, AudioTransformOptions as e, AudioTransformationStep as f, RotateOptions as g, ImageFormat as h, TransformOptions as i, BlurOptions as j, MedianOptions as k, CLAHEOptions as l, ConvolveOptions as m, ThresholdOptions as n, BooleanOptions as o, RecombineOptions as p, ModulateOptions as q, TintOptions as r, ColourspaceOptions as s, BandboolOptions as t, AffineOptions as u, ErodeOptions as v, ToColourspaceOptions as w, RemoveAlphaOptions as x, EnsureAlphaOptions as y, TransformationStep as z };