@visulima/storage 1.0.0-alpha.1 → 1.0.0-alpha.3

package/dist/transformer/types.d.ts

@@ -0,0 +1,652 @@
+import type { BaseStorage } from "../storage/storage.d.ts";
+import type { File, FileReturn } from "../storage/utils/index.d.ts";
+import type { Cache } from "../utils/cache.d.ts";
+import type BaseTransformer from "./base-transformer.d.ts";
+/**
+ * Supported image formats for transformation
+ */
+export type ImageFormat = "jpeg" | "png" | "webp" | "avif" | "tiff" | "gif";
+/**
+ * Image transformation options
+ */
+export 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
+ */
+export 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
+ */
+export 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
+ */
+export interface MedianOptions extends TransformOptions {
+    /** Size of the median filter */
+    size?: number;
+}
+/**
+ * CLAHE (Contrast Limited Adaptive Histogram Equalization) options
+ */
+export 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
+ */
+export 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
+ */
+export interface ThresholdOptions extends TransformOptions {
+    /** Alternative spelling for greyscale */
+    grayscale?: boolean;
+    /** Convert to greyscale */
+    greyscale?: boolean;
+    /** Threshold value (0-255) */
+    threshold?: number;
+}
+/**
+ * Boolean operation options
+ */
+export 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
+ */
+export 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
+ */
+export interface RecombineOptions extends TransformOptions {
+    /** 3x3 or 4x4 recombination matrix */
+    matrix: number[][];
+}
+/**
+ * Modulate transformation options
+ */
+export 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
+ */
+export interface TintOptions extends TransformOptions {
+    /** RGB tint values */
+    rgb: [number, number, number] | string;
+}
+/**
+ * Greyscale transformation options
+ */
+export interface GreyscaleOptions extends TransformOptions {
+    /** Alternative spelling */
+    grayscale?: boolean;
+    /** Convert to greyscale */
+    greyscale?: boolean;
+}
+/**
+ * Colourspace transformation options
+ */
+export interface ColourspaceOptions extends TransformOptions {
+    /** Target colourspace */
+    colourspace: "srgb" | "rgb" | "cmyk" | "lab" | "b-w";
+}
+/**
+ * Channel extraction options
+ */
+export 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.
+ */
+export interface JoinChannelOptions extends TransformOptions {
+    /** Images to join as channels */
+    images: (Buffer | string)[];
+}
+/**
+ * Options for performing boolean operations on image bands.
+ */
+export interface BandboolOptions extends TransformOptions {
+    /** Boolean operation: and, or, eor */
+    operator: "and" | "or" | "eor";
+}
+/**
+ * Options for applying affine transformations (rotation, scaling, shearing, translation) to images.
+ */
+export 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.
+ */
+export interface DilateOptions extends TransformOptions {
+    /** Kernel size for dilation */
+    kernelSize?: number;
+}
+/**
+ * Options for applying morphological erosion operation to images.
+ */
+export interface ErodeOptions extends TransformOptions {
+    /** Kernel size for erosion */
+    kernelSize?: number;
+}
+/**
+ * Options for setting the colourspace used for internal processing pipeline operations.
+ */
+export interface PipelineColourspaceOptions extends TransformOptions {
+    /** Colourspace for internal operations */
+    colourspace: "rgb" | "srgb" | "cmyk" | "lab" | "b-w";
+}
+/**
+ * Options for converting images to a target colourspace.
+ */
+export interface ToColourspaceOptions extends TransformOptions {
+    /** Target colourspace */
+    colourspace: "srgb" | "rgb" | "cmyk" | "lab" | "b-w";
+}
+/**
+ * Remove alpha channel options
+ */
+export interface RemoveAlphaOptions extends TransformOptions {
+    /** Background color to composite over alpha channel */
+    background?: string;
+}
+/**
+ * Ensure alpha channel options
+ */
+export interface EnsureAlphaOptions extends TransformOptions {
+    /** Alpha channel value to add */
+    alpha?: number;
+}
+/**
+ * Resize transformation options
+ */
+export 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
+ */
+export 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
+ */
+export 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
+ */
+export 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)
+ */
+export 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
+ */
+export 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
+ */
+export 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
+ */
+export 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
+ */
+export 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
+ */
+export 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
+ */
+export interface AudioChannelMixOptions extends AudioTransformOptions {
+    /** Number of output channels */
+    numberOfChannels: number;
+}
+/**
+ * Audio resample transformation options
+ */
+export interface AudioResampleOptions extends AudioTransformOptions {
+    /** Output sample rate in Hz */
+    sampleRate: number;
+}
+/**
+ * Video transformation pipeline step
+ */
+export interface VideoTransformationStep {
+    options: VideoTransformOptions | VideoResizeOptions | VideoCropOptions | VideoRotateOptions;
+    type: "resize" | "crop" | "rotate" | "format" | "codec" | "bitrate" | "frameRate";
+}
+/**
+ * Audio transformation pipeline step
+ */
+export interface AudioTransformationStep {
+    options: AudioTransformOptions | AudioChannelMixOptions | AudioResampleOptions;
+    type: "resample" | "channels" | "format" | "codec" | "bitrate";
+}
+/**
+ * Image transformation result
+ */
+export 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
+ */
+export interface VideoTransformResult<TFileReturn extends FileReturn = FileReturn> extends TransformResult<TFileReturn> {
+    /** Video bitrate */
+    bitrate?: number;
+    /** Video duration in seconds */
+    duration: number;
+}
+/**
+ * Audio transformation result
+ */
+export 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)
+ */
+export 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
+ */
+export 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
+ */
+export 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;
+}
+/**
+ * Base transformer configuration with common properties
+ */
+export 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;
+}
+/**
+ * Image transformer configuration
+ */
+export interface ImageTransformerConfig extends BaseTransformerConfig {
+    /** Maximum image size to process (in bytes) */
+    maxImageSize?: number;
+}
+/**
+ * Video transformer configuration
+ */
+export 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
+ */
+export 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;
+}

package/dist/transformer/utils.d.ts

@@ -0,0 +1,33 @@
+import type { FileReturn } from "../storage/utils/index.d.ts";
+/**
+ * Check if a content type is valid for a specific media type.
+ * @param contentType MIME content type string to validate
+ * @param expectedType Expected media type ('image', 'video', or 'audio')
+ * @returns True if the content type is valid for the expected media type
+ */
+export declare const isValidMediaType: (contentType: string | undefined, expectedType: "image" | "video" | "audio") => boolean;
+/**
+ * Get format (extension) from content type using mime package.
+ * @param contentType MIME content type string to extract format from
+ * @returns Format string or undefined if not found
+ */
+export declare const getFormatFromContentType: (contentType: string | undefined) => string | undefined;
+/**
+ * Validate a media file for a specific type with size and format checks.
+ * @param file File to validate
+ * @param expectedType Expected media type ('image', 'video', or 'audio')
+ * @param config Validation configuration with optional maxSize and supportedFormats
+ * @param config.maxSize Maximum allowed file size in bytes
+ * @param config.supportedFormats Array of supported file formats
+ * @throws Error if validation fails (size exceeded, wrong type, or unsupported format)
+ */
+export declare const validateMediaFile: (file: FileReturn, expectedType: "image" | "video" | "audio", config?: {
+    maxSize?: number;
+    supportedFormats?: string[];
+}) => void;
+/**
+ * Validate that a content type is known and supported by the mime package.
+ * @param contentType MIME content type string to check
+ * @returns True if the content type is known and has a registered extension
+ */
+export declare const isKnownContentType: (contentType: string | undefined) => boolean;