@openinary/core 1.1.0

package/dist/utils/image/aspect-ratio.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"aspect-ratio.d.ts","sourceRoot":"","sources":["../../../src/utils/image/aspect-ratio.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,OAAO,CAAC;AAC1B,OAAO,EAAE,WAAW,EAAE,MAAM,SAAS,CAAC;AAGtC;;GAEG;AACH,eAAO,MAAM,gBAAgB,GAC3B,OAAO,KAAK,CAAC,KAAK,EAClB,aAAa,MAAM,EACnB,UAAS,WAAsB,KAC9B,OAAO,CAAC,KAAK,CAAC,KAAK,CAuCrB,CAAC"}

package/dist/utils/image/aspect-ratio.js

@@ -0,0 +1,40 @@
+import { getSharpPosition } from './gravity.js';
+/**
+ * Apply aspect ratio transformation to an image
+ */
+export const applyAspectRatio = async (image, aspectParam, gravity = 'center') => {
+    const aspectRatio = aspectParam.split(':');
+    if (aspectRatio.length !== 2) {
+        return image;
+    }
+    const targetRatio = parseFloat(aspectRatio[0]) / parseFloat(aspectRatio[1]);
+    // Get current image metadata
+    const metadata = await image.metadata();
+    const currentWidth = metadata.width || 0;
+    const currentHeight = metadata.height || 0;
+    const currentRatio = currentWidth / currentHeight;
+    // Only transform if ratios differ significantly
+    if (Math.abs(currentRatio - targetRatio) <= 0.01) {
+        return image; // Image already has correct aspect ratio
+    }
+    let newWidth;
+    let newHeight;
+    if (currentRatio > targetRatio) {
+        // Current image is wider, crop width
+        newHeight = currentHeight;
+        newWidth = Math.round(newHeight * targetRatio);
+    }
+    else {
+        // Current image is taller, crop height
+        newWidth = currentWidth;
+        newHeight = Math.round(newWidth / targetRatio);
+    }
+    // Apply aspect ratio crop with specified gravity
+    return image.resize({
+        width: newWidth,
+        height: newHeight,
+        fit: 'cover',
+        position: getSharpPosition(gravity)
+    });
+};
+//# sourceMappingURL=aspect-ratio.js.map

package/dist/utils/image/aspect-ratio.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"aspect-ratio.js","sourceRoot":"","sources":["../../../src/utils/image/aspect-ratio.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,gBAAgB,EAAE,MAAM,WAAW,CAAC;AAE7C;;GAEG;AACH,MAAM,CAAC,MAAM,gBAAgB,GAAG,KAAK,EACnC,KAAkB,EAClB,WAAmB,EACnB,UAAuB,QAAQ,EACT,EAAE;IACxB,MAAM,WAAW,GAAG,WAAW,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;IAC3C,IAAI,WAAW,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAC7B,OAAO,KAAK,CAAC;IACf,CAAC;IAED,MAAM,WAAW,GAAG,UAAU,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC,GAAG,UAAU,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC,CAAC;IAE5E,6BAA6B;IAC7B,MAAM,QAAQ,GAAG,MAAM,KAAK,CAAC,QAAQ,EAAE,CAAC;IACxC,MAAM,YAAY,GAAG,QAAQ,CAAC,KAAK,IAAI,CAAC,CAAC;IACzC,MAAM,aAAa,GAAG,QAAQ,CAAC,MAAM,IAAI,CAAC,CAAC;IAC3C,MAAM,YAAY,GAAG,YAAY,GAAG,aAAa,CAAC;IAElD,gDAAgD;IAChD,IAAI,IAAI,CAAC,GAAG,CAAC,YAAY,GAAG,WAAW,CAAC,IAAI,IAAI,EAAE,CAAC;QACjD,OAAO,KAAK,CAAC,CAAC,yCAAyC;IACzD,CAAC;IAED,IAAI,QAAgB,CAAC;IACrB,IAAI,SAAiB,CAAC;IAEtB,IAAI,YAAY,GAAG,WAAW,EAAE,CAAC;QAC/B,qCAAqC;QACrC,SAAS,GAAG,aAAa,CAAC;QAC1B,QAAQ,GAAG,IAAI,CAAC,KAAK,CAAC,SAAS,GAAG,WAAW,CAAC,CAAC;IACjD,CAAC;SAAM,CAAC;QACN,uCAAuC;QACvC,QAAQ,GAAG,YAAY,CAAC;QACxB,SAAS,GAAG,IAAI,CAAC,KAAK,CAAC,QAAQ,GAAG,WAAW,CAAC,CAAC;IACjD,CAAC;IAED,iDAAiD;IACjD,OAAO,KAAK,CAAC,MAAM,CAAC;QAClB,KAAK,EAAE,QAAQ;QACf,MAAM,EAAE,SAAS;QACjB,GAAG,EAAE,OAAO;QACZ,QAAQ,EAAE,gBAAgB,CAAC,OAAO,CAAC;KACpC,CAAC,CAAC;AACL,CAAC,CAAC"}

package/dist/utils/image/background.d.ts

@@ -0,0 +1,6 @@
+import { BackgroundColor } from './types';
+/**
+ * Parse background color from hex format or "transparent" keyword
+ */
+export declare const parseBackgroundColor: (background?: string) => BackgroundColor;
+//# sourceMappingURL=background.d.ts.map

package/dist/utils/image/background.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"background.d.ts","sourceRoot":"","sources":["../../../src/utils/image/background.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,MAAM,SAAS,CAAC;AAE1C;;GAEG;AACH,eAAO,MAAM,oBAAoB,GAAI,aAAa,MAAM,KAAG,eAoB1D,CAAC"}

package/dist/utils/image/background.js

@@ -0,0 +1,22 @@
+/**
+ * Parse background color from hex format or "transparent" keyword
+ */
+export const parseBackgroundColor = (background) => {
+    if (!background) {
+        return { r: 255, g: 255, b: 255, alpha: 1 }; // Default white
+    }
+    if (background.toLowerCase() === 'transparent') {
+        return { r: 0, g: 0, b: 0, alpha: 0 }; // Transparent
+    }
+    const hex = background.replace('#', '');
+    if (hex.length === 6) {
+        return {
+            r: parseInt(hex.substr(0, 2), 16),
+            g: parseInt(hex.substr(2, 2), 16),
+            b: parseInt(hex.substr(4, 2), 16),
+            alpha: 1
+        };
+    }
+    return { r: 255, g: 255, b: 255, alpha: 1 }; // Default white if invalid
+};
+//# sourceMappingURL=background.js.map

package/dist/utils/image/background.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"background.js","sourceRoot":"","sources":["../../../src/utils/image/background.ts"],"names":[],"mappings":"AAEA;;GAEG;AACH,MAAM,CAAC,MAAM,oBAAoB,GAAG,CAAC,UAAmB,EAAmB,EAAE;IAC3E,IAAI,CAAC,UAAU,EAAE,CAAC;QAChB,OAAO,EAAE,CAAC,EAAE,GAAG,EAAE,CAAC,EAAE,GAAG,EAAE,CAAC,EAAE,GAAG,EAAE,KAAK,EAAE,CAAC,EAAE,CAAC,CAAC,gBAAgB;IAC/D,CAAC;IAED,IAAI,UAAU,CAAC,WAAW,EAAE,KAAK,aAAa,EAAE,CAAC;QAC/C,OAAO,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,KAAK,EAAE,CAAC,EAAE,CAAC,CAAC,cAAc;IACvD,CAAC;IAED,MAAM,GAAG,GAAG,UAAU,CAAC,OAAO,CAAC,GAAG,EAAE,EAAE,CAAC,CAAC;IACxC,IAAI,GAAG,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACrB,OAAO;YACL,CAAC,EAAE,QAAQ,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC;YACjC,CAAC,EAAE,QAAQ,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC;YACjC,CAAC,EAAE,QAAQ,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC;YACjC,KAAK,EAAE,CAAC;SACT,CAAC;IACJ,CAAC;IAED,OAAO,EAAE,CAAC,EAAE,GAAG,EAAE,CAAC,EAAE,GAAG,EAAE,CAAC,EAAE,GAAG,EAAE,KAAK,EAAE,CAAC,EAAE,CAAC,CAAC,2BAA2B;AAC1E,CAAC,CAAC"}

package/dist/utils/image/compression.d.ts

@@ -0,0 +1,44 @@
+import { TransformParams, OptimizationResult } from './types';
+export declare class Compression {
+    private static readonly FORMAT_PRIORITIES;
+    /**
+     * Optimizes an image with intelligent compression
+     * If format is not explicitly specified, encodes in all supported formats and returns the smallest one
+     */
+    optimizeForDelivery(inputPath: string, params: TransformParams, userAgent?: string, acceptHeader?: string): Promise<OptimizationResult>;
+    /**
+     * Prepares the base pipeline with preliminary optimizations
+     */
+    private preparePipeline;
+    /**
+     * Applies format encoding to the pipeline
+     */
+    private applyFormat;
+    /**
+     * Analyzes image content to optimize compression (simplified for speed)
+     */
+    private analyzeImage;
+    /**
+     * Determines optimal format based on content and browser support
+     */
+    private determineOptimalFormat;
+    /**
+     * Calculates optimal quality based on content (simplified for speed).
+     * If userQuality is provided, it takes precedence over automatic calculation.
+     */
+    private calculateOptimalQuality;
+    /**
+     * Determines maximum dimension based on content type
+     */
+    private getMaxDimension;
+    /**
+     * Determines the optimal format for a browser without doing full optimization
+     * This is used for cache key generation
+     */
+    determineOptimalFormatForCache(userAgent?: string, acceptHeader?: string, originalFormat?: string): string;
+    /**
+     * Checks browser support for a format
+     */
+    private supportsFormat;
+}
+//# sourceMappingURL=compression.d.ts.map

package/dist/utils/image/compression.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"compression.d.ts","sourceRoot":"","sources":["../../../src/utils/image/compression.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,eAAe,EAA8B,kBAAkB,EAAE,MAAM,SAAS,CAAC;AAG1F,qBAAa,WAAW;IACtB,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,iBAAiB,CAKvC;IAEF;;;OAGG;IACG,mBAAmB,CACvB,SAAS,EAAE,MAAM,EACjB,MAAM,EAAE,eAAe,EACvB,SAAS,CAAC,EAAE,MAAM,EAClB,YAAY,CAAC,EAAE,MAAM,GACpB,OAAO,CAAC,kBAAkB,CAAC;IA4J9B;;OAEG;IACH,OAAO,CAAC,eAAe;IAyBvB;;OAEG;IACH,OAAO,CAAC,WAAW;IA4CnB;;OAEG;YACW,YAAY;IAmB1B;;OAEG;IACH,OAAO,CAAC,sBAAsB;IAgC9B;;;OAGG;IACH,OAAO,CAAC,uBAAuB;IAkC/B;;OAEG;IACH,OAAO,CAAC,eAAe;IAMvB;;;OAGG;IACH,8BAA8B,CAC5B,SAAS,CAAC,EAAE,MAAM,EAClB,YAAY,CAAC,EAAE,MAAM,EACrB,cAAc,CAAC,EAAE,MAAM,GACtB,MAAM;IAwBT;;OAEG;IACH,OAAO,CAAC,cAAc;CAwCvB"}

package/dist/utils/image/compression.js

@@ -0,0 +1,345 @@
+import sharp from 'sharp';
+import logger, { serializeError } from '../logger.js';
+export class Compression {
+    static FORMAT_PRIORITIES = {
+        avif: { quality: 0.9, savings: 0.7 }, // AVIF: Excellent compression, slightly lower quality acceptable
+        webp: { quality: 0.95, savings: 0.6 }, // WebP: Good compression, high quality
+        jpeg: { quality: 1.0, savings: 0.3 }, // JPEG: Standard compression, full quality
+        png: { quality: 1.0, savings: 0.1 } // PNG: Lossless, minimal compression
+    };
+    /**
+     * Optimizes an image with intelligent compression
+     * If format is not explicitly specified, encodes in all supported formats and returns the smallest one
+     */
+    async optimizeForDelivery(inputPath, params, userAgent, acceptHeader) {
+        const originalBuffer = await sharp(inputPath).toBuffer();
+        const originalSize = originalBuffer.length;
+        // CONTENT ANALYSIS
+        const analysis = await this.analyzeImage(inputPath);
+        const metadata = await sharp(inputPath).metadata();
+        // If format is explicitly specified, use it directly (no size comparison needed)
+        if (params.format) {
+            const explicitFormat = params.format === 'jpg' ? 'jpeg' : params.format;
+            const userQuality = params.quality ? parseInt(String(params.quality)) : undefined;
+            const optimalQuality = this.calculateOptimalQuality(analysis, originalSize, explicitFormat, userQuality);
+            let pipeline = this.preparePipeline(inputPath, analysis, metadata, originalSize);
+            // Apply the explicit format
+            pipeline = this.applyFormat(pipeline, explicitFormat, optimalQuality);
+            const optimizedBuffer = await pipeline.toBuffer();
+            const optimizedSize = optimizedBuffer.length;
+            const savings = ((originalSize - optimizedSize) / originalSize) * 100;
+            const compressionRatio = originalSize / optimizedSize;
+            return {
+                buffer: optimizedBuffer,
+                format: explicitFormat,
+                originalSize,
+                optimizedSize,
+                savings,
+                compressionRatio
+            };
+        }
+        // FORMAT SIZE COMPARISON: Encode in all supported formats and compare sizes
+        const supportsAVIF = this.supportsFormat('avif', userAgent, acceptHeader);
+        const supportsWebP = this.supportsFormat('webp', userAgent, acceptHeader);
+        logger.debug({
+            userAgent,
+            acceptHeader,
+            supportsAVIF,
+            supportsWebP
+        }, 'Browser format support detection');
+        const formatsToTest = [];
+        const originalFormat = metadata.format;
+        const hasTransparency = metadata.hasAlpha;
+        // Modern browsers: Test AVIF, WebP, and JPEG (plus PNG if original is PNG)
+        if (supportsAVIF) {
+            formatsToTest.push('avif', 'webp', 'jpeg');
+            // If original is PNG, also test PNG to compare sizes (AVIF/WebP support transparency too)
+            if (originalFormat === 'png') {
+                formatsToTest.push('png');
+                logger.debug('Testing formats: AVIF, WebP, JPEG, PNG (original is PNG)');
+            }
+            else {
+                logger.debug('Testing formats: AVIF, WebP, JPEG');
+            }
+        }
+        // Browsers with WebP but not AVIF: Test WebP and JPEG (plus PNG if original is PNG)
+        else if (supportsWebP) {
+            formatsToTest.push('webp', 'jpeg');
+            // If original is PNG, also test PNG to compare sizes (WebP supports transparency)
+            if (originalFormat === 'png') {
+                formatsToTest.push('png');
+                logger.debug('Testing formats: WebP, JPEG, PNG (original is PNG)');
+            }
+            else {
+                logger.debug('Testing formats: WebP, JPEG');
+            }
+        }
+        // Older browsers: Use JPEG/PNG (keep original format if PNG for transparency)
+        else {
+            // Preserve PNG for transparency, otherwise use JPEG
+            if (originalFormat === 'png' && hasTransparency) {
+                formatsToTest.push('png');
+                logger.debug('Testing format: PNG (preserving transparency, legacy browser)');
+            }
+            else {
+                formatsToTest.push('jpeg');
+                logger.debug('Testing format: JPEG (legacy browser)');
+            }
+        }
+        // Encode in all formats and compare sizes
+        const results = [];
+        const userQuality = params.quality ? parseInt(String(params.quality)) : undefined;
+        for (const format of formatsToTest) {
+            try {
+                const quality = this.calculateOptimalQuality(analysis, originalSize, format, userQuality);
+                let pipeline = this.preparePipeline(inputPath, analysis, metadata, originalSize);
+                pipeline = this.applyFormat(pipeline, format, quality);
+                const buffer = await pipeline.toBuffer();
+                results.push({
+                    format,
+                    buffer,
+                    size: buffer.length
+                });
+            }
+            catch (error) {
+                // If encoding fails for a format, skip it
+                logger.debug({ error: serializeError(error), format }, `Failed to encode in ${format}, skipping`);
+            }
+        }
+        // Find the smallest format
+        if (results.length === 0) {
+            // Fallback: use JPEG
+            const quality = this.calculateOptimalQuality(analysis, originalSize, 'jpeg', userQuality);
+            let pipeline = this.preparePipeline(inputPath, analysis, metadata, originalSize);
+            pipeline = this.applyFormat(pipeline, 'jpeg', quality);
+            const buffer = await pipeline.toBuffer();
+            return {
+                buffer,
+                format: 'jpeg',
+                originalSize,
+                optimizedSize: buffer.length,
+                savings: ((originalSize - buffer.length) / originalSize) * 100,
+                compressionRatio: originalSize / buffer.length
+            };
+        }
+        // Sort by size and pick the smallest
+        results.sort((a, b) => a.size - b.size);
+        const bestResult = results[0];
+        // Normalize format (jpg -> jpeg)
+        const normalizedFormat = bestResult.format === 'jpg' ? 'jpeg' : bestResult.format;
+        logger.debug({
+            testedFormats: results.map(r => ({ format: r.format, size: r.size })),
+            selectedFormat: normalizedFormat,
+            selectedSize: bestResult.size,
+            originalSize
+        }, 'Format size comparison results');
+        const savings = ((originalSize - bestResult.size) / originalSize) * 100;
+        const compressionRatio = originalSize / bestResult.size;
+        return {
+            buffer: bestResult.buffer,
+            format: normalizedFormat,
+            originalSize,
+            optimizedSize: bestResult.size,
+            savings,
+            compressionRatio
+        };
+    }
+    /**
+     * Prepares the base pipeline with preliminary optimizations
+     */
+    preparePipeline(inputPath, analysis, metadata, originalSize) {
+        let pipeline = sharp(inputPath);
+        // Resolution reduction only for extremely large files
+        if (originalSize > 5 * 1024 * 1024) { // > 5MB
+            const maxDimension = this.getMaxDimension(analysis);
+            if (metadata.width > maxDimension || metadata.height > maxDimension) {
+                pipeline = pipeline.resize(maxDimension, maxDimension, {
+                    fit: 'inside',
+                    withoutEnlargement: true
+                });
+            }
+        }
+        // Remove metadata to save space
+        pipeline = pipeline.withMetadata();
+        return pipeline;
+    }
+    /**
+     * Applies format encoding to the pipeline
+     */
+    applyFormat(pipeline, format, quality) {
+        switch (format) {
+            case 'avif':
+                return pipeline.avif({
+                    quality,
+                    effort: 1,
+                    chromaSubsampling: '4:2:0'
+                });
+            case 'webp':
+                return pipeline.webp({
+                    quality,
+                    effort: 1,
+                    smartSubsample: false
+                });
+            case 'jpeg':
+            case 'jpg':
+                return pipeline.jpeg({
+                    quality,
+                    progressive: false,
+                    mozjpeg: false,
+                    chromaSubsampling: '4:2:0'
+                });
+            case 'png':
+                return pipeline.png({
+                    compressionLevel: 3,
+                    adaptiveFiltering: false
+                });
+            default:
+                // PNG fallback
+                return pipeline.png({
+                    compressionLevel: 3,
+                    adaptiveFiltering: false
+                });
+        }
+    }
+    /**
+     * Analyzes image content to optimize compression (simplified for speed)
+     */
+    async analyzeImage(inputPath) {
+        const image = sharp(inputPath);
+        const metadata = await image.metadata();
+        // Simplified analysis based only on metadata (no expensive stats calculation)
+        const isPhotographic = metadata.channels >= 3; // RGB or more channels
+        const hasText = false;
+        const hasSharpEdges = false; // Skip expensive edge detection
+        const complexity = 0.5; // Default medium complexity
+        return {
+            hasText,
+            hasSharpEdges,
+            isPhotographic,
+            dominantColors: metadata.channels || 3,
+            complexity
+        };
+    }
+    /**
+     * Determines optimal format based on content and browser support
+     */
+    determineOptimalFormat(analysis, fileSize, userAgent, acceptHeader, explicitFormat) {
+        // If format is explicitly specified, use it (TypeScript ensures it's valid)
+        if (explicitFormat) {
+            // Normalize jpg to jpeg
+            return explicitFormat === 'jpg' ? 'jpeg' : explicitFormat;
+        }
+        // Check support for modern formats
+        const supportsAVIF = this.supportsFormat('avif', userAgent, acceptHeader);
+        const supportsWebP = this.supportsFormat('webp', userAgent, acceptHeader);
+        // NEW DEFAULT: Prefer AVIF by default if supported
+        if (supportsAVIF) {
+            return 'avif';
+        }
+        // Fallback to WebP if supported
+        if (supportsWebP) {
+            return 'webp';
+        }
+        // JPEG fallback for compatibility
+        return 'jpeg';
+    }
+    /**
+     * Calculates optimal quality based on content (simplified for speed).
+     * If userQuality is provided, it takes precedence over automatic calculation.
+     */
+    calculateOptimalQuality(analysis, fileSize, format, userQuality) {
+        if (userQuality !== undefined && !isNaN(userQuality) && userQuality >= 1 && userQuality <= 100) {
+            return userQuality;
+        }
+        let baseQuality = 85;
+        // Simplified format-specific adjustments
+        switch (format) {
+            case 'avif':
+                baseQuality = 80; // AVIF can handle slightly lower quality
+                break;
+            case 'webp':
+                baseQuality = 85;
+                break;
+            case 'jpeg':
+                baseQuality = 90; // Higher quality for JPEG
+                break;
+            case 'png':
+                return 100; // PNG is lossless, no quality adjustment needed
+        }
+        // Simplified size-based adjustment (less aggressive)
+        if (fileSize > 5 * 1024 * 1024)
+            baseQuality -= 5; // Only for very large files
+        // Limits (higher minimum quality)
+        return Math.max(70, Math.min(95, baseQuality));
+    }
+    /**
+     * Determines maximum dimension based on content type
+     */
+    getMaxDimension(analysis) {
+        if (analysis.hasText)
+            return 2560; // Text requires higher resolution
+        if (analysis.isPhotographic)
+            return 1920; // Standard photos
+        return 1600; // Other content
+    }
+    /**
+     * Determines the optimal format for a browser without doing full optimization
+     * This is used for cache key generation
+     */
+    determineOptimalFormatForCache(userAgent, acceptHeader, originalFormat) {
+        // If format is explicitly specified, we wouldn't call this, but handle it anyway
+        const supportsAVIF = this.supportsFormat('avif', userAgent, acceptHeader);
+        const supportsWebP = this.supportsFormat('webp', userAgent, acceptHeader);
+        // Prefer AVIF if supported (best compression)
+        if (supportsAVIF) {
+            return 'avif';
+        }
+        // Fallback to WebP if supported
+        if (supportsWebP) {
+            return 'webp';
+        }
+        // For legacy browsers, preserve PNG if original is PNG (for transparency)
+        // Otherwise use JPEG
+        if (originalFormat === 'png') {
+            return 'png';
+        }
+        return 'jpeg';
+    }
+    /**
+     * Checks browser support for a format
+     */
+    supportsFormat(format, userAgent, acceptHeader) {
+        // First check Accept header - most reliable method
+        if (acceptHeader) {
+            const acceptLower = acceptHeader.toLowerCase();
+            if (format === 'avif' && acceptLower.includes('image/avif')) {
+                return true;
+            }
+            if (format === 'webp' && acceptLower.includes('image/webp')) {
+                return true;
+            }
+        }
+        if (!userAgent) {
+            // If no user agent, assume modern browser supports AVIF and WebP
+            // This handles cases where Accept header might not be sent
+            return format === 'avif' || format === 'webp';
+        }
+        const ua = userAgent.toLowerCase();
+        switch (format) {
+            case 'avif':
+                // Chrome 85+ (released Aug 2020), Firefox 93+ (released Oct 2021), Safari 16+ (released Sep 2022), Edge 122+
+                return ((ua.includes('chrome') && !ua.includes('edg') && parseInt(ua.match(/chrome\/(\d+)/)?.[1] || '0') >= 85) ||
+                    (ua.includes('firefox') && parseInt(ua.match(/firefox\/(\d+)/)?.[1] || '0') >= 93) ||
+                    (ua.includes('safari') && !ua.includes('chrome') && parseInt(ua.match(/version\/(\d+)/)?.[1] || '0') >= 16) ||
+                    (ua.includes('edg') && parseInt(ua.match(/edg\/(\d+)/)?.[1] || '0') >= 122));
+            case 'webp':
+                // Very broad support now - almost all modern browsers
+                return !ua.includes('msie') &&
+                    !ua.includes('trident') &&
+                    !(ua.includes('edge') && parseInt(ua.match(/edge\/(\d+)/)?.[1] || '0') < 18);
+            default:
+                return true;
+        }
+    }
+}
+//# sourceMappingURL=compression.js.map

package/dist/utils/image/compression.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"compression.js","sourceRoot":"","sources":["../../../src/utils/image/compression.ts"],"names":[],"mappings":"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"}

package/dist/utils/image/gravity.d.ts

@@ -0,0 +1,6 @@
+import { GravityMode } from './types';
+/**
+ * Map gravity to Sharp position values
+ */
+export declare const getSharpPosition: (gravity: GravityMode) => string;
+//# sourceMappingURL=gravity.d.ts.map

package/dist/utils/image/gravity.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"gravity.d.ts","sourceRoot":"","sources":["../../../src/utils/image/gravity.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,SAAS,CAAC;AAEtC;;GAEG;AACH,eAAO,MAAM,gBAAgB,GAAI,SAAS,WAAW,KAAG,MAmBvD,CAAC"}

package/dist/utils/image/gravity.js

@@ -0,0 +1,24 @@
+/**
+ * Map gravity to Sharp position values
+ */
+export const getSharpPosition = (gravity) => {
+    switch (gravity) {
+        case 'center':
+            return 'center';
+        case 'north':
+            return 'top';
+        case 'south':
+            return 'bottom';
+        case 'east':
+            return 'right';
+        case 'west':
+            return 'left';
+        case 'face':
+            return 'attention'; // Sharp's attention strategy focuses on interesting features
+        case 'auto':
+            return 'entropy'; // Sharp's entropy strategy focuses on high-contrast areas
+        default:
+            return 'center';
+    }
+};
+//# sourceMappingURL=gravity.js.map

package/dist/utils/image/gravity.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"gravity.js","sourceRoot":"","sources":["../../../src/utils/image/gravity.ts"],"names":[],"mappings":"AAEA;;GAEG;AACH,MAAM,CAAC,MAAM,gBAAgB,GAAG,CAAC,OAAoB,EAAU,EAAE;IAC/D,QAAQ,OAAO,EAAE,CAAC;QAChB,KAAK,QAAQ;YACX,OAAO,QAAQ,CAAC;QAClB,KAAK,OAAO;YACV,OAAO,KAAK,CAAC;QACf,KAAK,OAAO;YACV,OAAO,QAAQ,CAAC;QAClB,KAAK,MAAM;YACT,OAAO,OAAO,CAAC;QACjB,KAAK,MAAM;YACT,OAAO,MAAM,CAAC;QAChB,KAAK,MAAM;YACT,OAAO,WAAW,CAAC,CAAC,6DAA6D;QACnF,KAAK,MAAM;YACT,OAAO,SAAS,CAAC,CAAC,0DAA0D;QAC9E;YACE,OAAO,QAAQ,CAAC;IACpB,CAAC;AACH,CAAC,CAAC"}

package/dist/utils/image/index.d.ts

@@ -0,0 +1,8 @@
+import { TransformParams } from './types';
+export * from './types';
+export * from './param-registry';
+/**
+ * Transform an image with the specified parameters
+ */
+export declare const transformImage: (inputPath: string, params: TransformParams) => Promise<Buffer>;
+//# sourceMappingURL=index.d.ts.map

package/dist/utils/image/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/utils/image/index.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,eAAe,EAAE,MAAM,SAAS,CAAC;AA2B1C,cAAc,SAAS,CAAC;AACxB,cAAc,kBAAkB,CAAC;AAEjC;;GAEG;AACH,eAAO,MAAM,cAAc,GAAU,WAAW,MAAM,EAAE,QAAQ,eAAe,KAAG,OAAO,CAAC,MAAM,CAsD/F,CAAC"}

package/dist/utils/image/index.js

@@ -0,0 +1,77 @@
+import sharp from 'sharp';
+import { readFile } from 'fs/promises';
+import Psd from '@webtoon/psd';
+import { applyAspectRatio } from './aspect-ratio.js';
+import { applyRotation } from './rotation.js';
+import { applyQuality } from './quality.js';
+import { applyResizeComposite } from './param-registry.js';
+import { applyRoundCorners } from './round-corners.js';
+/**
+ * Decode a PSD file into a Sharp instance via raw RGBA pixel data.
+ * Sharp cannot read PSD natively; @webtoon/psd composites all layers first.
+ * The output is encoded as PNG so the temp-file step in processImage can read it.
+ */
+async function decodePsd(inputPath) {
+    const fileBuffer = await readFile(inputPath);
+    const arrayBuffer = fileBuffer.buffer.slice(fileBuffer.byteOffset, fileBuffer.byteOffset + fileBuffer.byteLength);
+    const psd = Psd.parse(arrayBuffer);
+    const pixelData = await psd.composite();
+    return sharp(Buffer.from(pixelData), {
+        raw: { width: psd.width, height: psd.height, channels: 4 },
+    }).png();
+}
+// Re-export types for backward compatibility
+export * from './types.js';
+export * from './param-registry.js';
+/**
+ * Transform an image with the specified parameters
+ */
+export const transformImage = async (inputPath, params) => {
+    let image = inputPath.toLowerCase().endsWith('.psd')
+        ? await decodePsd(inputPath)
+        : sharp(inputPath);
+    // Convert TransformParams to a record for easier access
+    const paramsRecord = {
+        ...(params.rotate && { rotate: String(params.rotate) }),
+        ...(params.aspect && { aspect: params.aspect }),
+        ...(params.width && { width: params.width }),
+        ...(params.height && { height: params.height }),
+        ...(params.resize && { resize: params.resize }),
+        ...(params.crop && { crop: params.crop }),
+        ...(params.gravity && { gravity: params.gravity }),
+        ...(params.background && { background: params.background }),
+        ...(params.quality && { quality: String(params.quality) }),
+        ...(params.format && { format: params.format }),
+        ...(params.radius && { radius: params.radius }),
+    };
+    // 1. Apply rotation (if specified)
+    if (params.rotate) {
+        image = applyRotation(image, params.rotate, params.background);
+    }
+    // 2. Apply aspect ratio (if specified)
+    if (params.aspect) {
+        image = await applyAspectRatio(image, params.aspect, params.gravity);
+        // Sharp only honors one resize() per pipeline, so a following resize would
+        // override the aspect-ratio crop. Materialize the crop into a buffer first.
+        if (params.resize || params.width || params.height) {
+            image = sharp(await image.toBuffer());
+        }
+    }
+    // 3. Apply resize (if width or height specified)
+    if (params.resize || params.width || params.height) {
+        image = await applyResizeComposite(image, '', paramsRecord);
+    }
+    // 4. Apply rounded corners (if specified)
+    if (params.radius) {
+        image = await applyRoundCorners(image, params.radius, params.background);
+        // applyRoundCorners always returns a pipeline backed by a PNG buffer
+        // (alpha-capable), so the intermediate toBuffer() in processImage will
+        // correctly preserve transparency or the filled background color.
+    }
+    // 5. Apply quality (if specified)
+    if (params.quality) {
+        image = applyQuality(image, params.quality);
+    }
+    return await image.toBuffer();
+};
+//# sourceMappingURL=index.js.map

package/dist/utils/image/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/utils/image/index.ts"],"names":[],"mappings":"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"}