apexify.js 5.1.1 → 5.2.0

package/dist/esm/Canvas/extended/CanvasCreator.d.ts

@@ -0,0 +1,33 @@
+import type { CanvasConfig } from "../utils/utils";
+export interface CanvasResults {
+    buffer: Buffer;
+    canvas: CanvasConfig;
+}
+/**
+ * Extended class for canvas creation functionality
+ */
+export declare class CanvasCreator {
+    /**
+     * Extracts a video frame (helper method - will be passed from ApexPainter)
+     */
+    private extractVideoFrame?;
+    /**
+     * Sets the extractVideoFrame method (dependency injection)
+     */
+    setExtractVideoFrame(method: (videoSource: string | Buffer, frameNumber?: number, timeSeconds?: number, outputFormat?: 'jpg' | 'png', quality?: number) => Promise<Buffer | null>): void;
+    /**
+     * Validates canvas configuration.
+     * @private
+     * @param canvas - Canvas configuration to validate
+     */
+    private validateCanvasConfig;
+    /**
+     * Creates a canvas with the given configuration.
+     * Applies rotation, shadow, border effects, background, and stroke.
+     *
+     * @param canvas - Canvas configuration object
+     * @returns Promise<CanvasResults> - Object containing canvas buffer and configuration
+     */
+    createCanvas(canvas: CanvasConfig): Promise<CanvasResults>;
+}
+//# sourceMappingURL=CanvasCreator.d.ts.map

package/dist/esm/Canvas/extended/CanvasCreator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"CanvasCreator.d.ts","sourceRoot":"","sources":["../../../../lib/Canvas/extended/CanvasCreator.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAgBnD,MAAM,WAAW,aAAa;IAC5B,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,YAAY,CAAC;CACtB;AAED;;GAEG;AACH,qBAAa,aAAa;IACxB;;OAEG;IACH,OAAO,CAAC,iBAAiB,CAAC,CAME;IAE5B;;OAEG;IACH,oBAAoB,CAClB,MAAM,EAAE,CACN,WAAW,EAAE,MAAM,GAAG,MAAM,EAC5B,WAAW,CAAC,EAAE,MAAM,EACpB,WAAW,CAAC,EAAE,MAAM,EACpB,YAAY,CAAC,EAAE,KAAK,GAAG,KAAK,EAC5B,OAAO,CAAC,EAAE,MAAM,KACb,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,GAC1B,IAAI;IAIP;;;;OAIG;IACH,OAAO,CAAC,oBAAoB;IAsB5B;;;;;;OAMG;IACG,YAAY,CAAC,MAAM,EAAE,YAAY,GAAG,OAAO,CAAC,aAAa,CAAC;CA2LjE"}

package/dist/esm/Canvas/extended/CanvasCreator.js

@@ -0,0 +1,223 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.CanvasCreator = void 0;
+const canvas_1 = require("@napi-rs/canvas");
+const path_1 = __importDefault(require("path"));
+const fs_1 = __importDefault(require("fs"));
+const errorUtils_1 = require("../utils/errorUtils");
+const utils_1 = require("../utils/utils");
+const enhancedPatternRenderer_1 = require("../utils/Patterns/enhancedPatternRenderer");
+const simpleProfessionalFilters_1 = require("../utils/Image/simpleProfessionalFilters");
+/**
+ * Extended class for canvas creation functionality
+ */
+class CanvasCreator {
+    /**
+     * Extracts a video frame (helper method - will be passed from ApexPainter)
+     */
+    extractVideoFrame;
+    /**
+     * Sets the extractVideoFrame method (dependency injection)
+     */
+    setExtractVideoFrame(method) {
+        this.extractVideoFrame = method;
+    }
+    /**
+     * Validates canvas configuration.
+     * @private
+     * @param canvas - Canvas configuration to validate
+     */
+    validateCanvasConfig(canvas) {
+        if (!canvas) {
+            throw new Error("createCanvas: canvas configuration is required.");
+        }
+        if (canvas.width !== undefined && (typeof canvas.width !== 'number' || canvas.width <= 0)) {
+            throw new Error("createCanvas: width must be a positive number.");
+        }
+        if (canvas.height !== undefined && (typeof canvas.height !== 'number' || canvas.height <= 0)) {
+            throw new Error("createCanvas: height must be a positive number.");
+        }
+        if (canvas.opacity !== undefined && (typeof canvas.opacity !== 'number' || canvas.opacity < 0 || canvas.opacity > 1)) {
+            throw new Error("createCanvas: opacity must be a number between 0 and 1.");
+        }
+        if (canvas.zoom?.scale !== undefined && (typeof canvas.zoom.scale !== 'number' || canvas.zoom.scale <= 0)) {
+            throw new Error("createCanvas: zoom.scale must be a positive number.");
+        }
+    }
+    /**
+     * Creates a canvas with the given configuration.
+     * Applies rotation, shadow, border effects, background, and stroke.
+     *
+     * @param canvas - Canvas configuration object
+     * @returns Promise<CanvasResults> - Object containing canvas buffer and configuration
+     */
+    async createCanvas(canvas) {
+        try {
+            // Validate canvas configuration
+            this.validateCanvasConfig(canvas);
+            // Handle inherit sizing
+            if (canvas.customBg?.inherit) {
+                let p = canvas.customBg.source;
+                if (!/^https?:\/\//i.test(p))
+                    p = path_1.default.join(process.cwd(), p);
+                try {
+                    const img = await (0, canvas_1.loadImage)(p);
+                    canvas.width = img.width;
+                    canvas.height = img.height;
+                }
+                catch (e) {
+                    const errorMessage = e instanceof Error ? e.message : String(e);
+                    throw new Error(`createCanvas: Failed to load image for inherit sizing: ${errorMessage}`);
+                }
+            }
+            // Handle video background inherit sizing
+            if (canvas.videoBg && this.extractVideoFrame) {
+                try {
+                    const frameBuffer = await this.extractVideoFrame(canvas.videoBg.source, canvas.videoBg.frame ?? 0, canvas.videoBg.time, canvas.videoBg.format || 'jpg', canvas.videoBg.quality || 2);
+                    if (frameBuffer) {
+                        const img = await (0, canvas_1.loadImage)(frameBuffer);
+                        if (!canvas.width)
+                            canvas.width = img.width;
+                        if (!canvas.height)
+                            canvas.height = img.height;
+                    }
+                }
+                catch (e) {
+                    console.warn('createCanvas: Failed to extract video frame for sizing, using defaults');
+                }
+            }
+            // Use final width/height after inherit
+            const width = canvas.width ?? 500;
+            const height = canvas.height ?? 500;
+            const { x = 0, y = 0, rotation = 0, borderRadius = 0, borderPosition = 'all', opacity = 1, colorBg, customBg, gradientBg, videoBg, patternBg, noiseBg, blendMode, zoom, stroke, shadow, blur } = canvas;
+            // Validate background configuration
+            const bgSources = [
+                canvas.colorBg ? 'colorBg' : null,
+                canvas.gradientBg ? 'gradientBg' : null,
+                canvas.customBg ? 'customBg' : null
+            ].filter(Boolean);
+            if (bgSources.length > 1) {
+                throw new Error(`createCanvas: only one of colorBg, gradientBg, or customBg can be used. You provided: ${bgSources.join(', ')}`);
+            }
+            const cv = (0, canvas_1.createCanvas)(width, height);
+            const ctx = (0, errorUtils_1.getCanvasContext)(cv);
+            ctx.globalAlpha = opacity;
+            // ---- BACKGROUND (clipped) ----
+            ctx.save();
+            (0, utils_1.applyRotation)(ctx, rotation, x, y, width, height);
+            (0, utils_1.buildPath)(ctx, x, y, width, height, borderRadius, borderPosition);
+            ctx.clip();
+            (0, utils_1.applyCanvasZoom)(ctx, width, height, zoom);
+            ctx.translate(x, y);
+            if (typeof blendMode === 'string') {
+                ctx.globalCompositeOperation = blendMode;
+            }
+            // Draw background - videoBg takes priority, then customBg, then gradientBg, then colorBg
+            if (videoBg && this.extractVideoFrame) {
+                try {
+                    // For videoBg, always use PNG format to ensure compatibility with loadImage
+                    const frameBuffer = await this.extractVideoFrame(videoBg.source, videoBg.frame ?? 0, videoBg.time, 'png', // Force PNG format for videoBg
+                    2);
+                    if (frameBuffer && frameBuffer.length > 0) {
+                        let videoImg;
+                        try {
+                            videoImg = await (0, canvas_1.loadImage)(frameBuffer);
+                        }
+                        catch (bufferError) {
+                            // If loading from buffer fails, try saving to temp file and loading from file
+                            const tempFramePath = path_1.default.join(process.cwd(), '.temp-frames', `video-bg-temp-${Date.now()}.png`);
+                            const frameDir = path_1.default.dirname(tempFramePath);
+                            if (!fs_1.default.existsSync(frameDir)) {
+                                fs_1.default.mkdirSync(frameDir, { recursive: true });
+                            }
+                            fs_1.default.writeFileSync(tempFramePath, frameBuffer);
+                            videoImg = await (0, canvas_1.loadImage)(tempFramePath);
+                            // Cleanup temp file after loading
+                            if (fs_1.default.existsSync(tempFramePath)) {
+                                fs_1.default.unlinkSync(tempFramePath);
+                            }
+                        }
+                        if (videoImg && videoImg.width > 0 && videoImg.height > 0) {
+                            ctx.globalAlpha = videoBg.opacity ?? 1;
+                            ctx.drawImage(videoImg, 0, 0, width, height);
+                            ctx.globalAlpha = opacity;
+                        }
+                        else {
+                            throw new Error(`Extracted video frame has invalid dimensions: ${videoImg?.width}x${videoImg?.height}`);
+                        }
+                    }
+                    else {
+                        throw new Error('Frame extraction returned empty buffer');
+                    }
+                }
+                catch (e) {
+                    const errorMsg = e instanceof Error ? e.message : 'Unknown error';
+                    if (errorMsg.includes('FFMPEG NOT FOUND') || errorMsg.includes('FFmpeg')) {
+                        throw e;
+                    }
+                    throw new Error(`createCanvas: videoBg extraction failed: ${errorMsg}`);
+                }
+            }
+            else if (customBg) {
+                // Draw custom background with filters and opacity support
+                await (0, utils_1.customBackground)(ctx, { ...canvas, blur });
+                // Apply filters to background if specified
+                if (customBg.filters && customBg.filters.length > 0) {
+                    const tempCanvas = (0, canvas_1.createCanvas)(width, height);
+                    const tempCtx = tempCanvas.getContext('2d');
+                    if (tempCtx) {
+                        tempCtx.drawImage(cv, 0, 0);
+                        await (0, simpleProfessionalFilters_1.applySimpleProfessionalFilters)(tempCtx, customBg.filters, width, height);
+                        ctx.clearRect(0, 0, width, height);
+                        ctx.globalAlpha = customBg.opacity ?? 1;
+                        ctx.drawImage(tempCanvas, 0, 0);
+                        ctx.globalAlpha = opacity;
+                    }
+                }
+                else if (customBg.opacity !== undefined && customBg.opacity !== 1) {
+                    ctx.globalAlpha = customBg.opacity;
+                    await (0, utils_1.customBackground)(ctx, { ...canvas, blur });
+                    ctx.globalAlpha = opacity;
+                }
+                else {
+                    await (0, utils_1.customBackground)(ctx, { ...canvas, blur });
+                }
+            }
+            else if (gradientBg) {
+                await (0, utils_1.drawBackgroundGradient)(ctx, { ...canvas, blur });
+            }
+            else {
+                // Default to black background if no background is specified
+                await (0, utils_1.drawBackgroundColor)(ctx, { ...canvas, blur, colorBg: colorBg ?? '#000' });
+            }
+            if (patternBg)
+                await enhancedPatternRenderer_1.EnhancedPatternRenderer.renderPattern(ctx, cv, patternBg);
+            if (noiseBg)
+                (0, utils_1.applyNoise)(ctx, width, height, noiseBg.intensity ?? 0.05);
+            ctx.restore();
+            // Apply shadow effect
+            if (shadow) {
+                ctx.save();
+                (0, utils_1.buildPath)(ctx, x, y, width, height, borderRadius, borderPosition);
+                (0, utils_1.applyShadow)(ctx, shadow, x, y, width, height);
+                ctx.restore();
+            }
+            // Apply stroke effect
+            if (stroke) {
+                ctx.save();
+                (0, utils_1.buildPath)(ctx, x, y, width, height, borderRadius, borderPosition);
+                (0, utils_1.applyStroke)(ctx, stroke, x, y, width, height);
+                ctx.restore();
+            }
+            return { buffer: cv.toBuffer('image/png'), canvas };
+        }
+        catch (error) {
+            throw new Error(`createCanvas failed: ${(0, errorUtils_1.getErrorMessage)(error)}`);
+        }
+    }
+}
+exports.CanvasCreator = CanvasCreator;
+//# sourceMappingURL=CanvasCreator.js.map

package/dist/esm/Canvas/extended/CanvasCreator.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"CanvasCreator.js","sourceRoot":"","sources":["../../../../lib/Canvas/extended/CanvasCreator.ts"],"names":[],"mappings":";;;;;;AAAA,4CAAyE;AACzE,gDAAwB;AACxB,4CAAoB;AAEpB,oDAAwE;AACxE,0CAUwB;AACxB,uFAAoF;AACpF,wFAA0F;AAO1F;;GAEG;AACH,MAAa,aAAa;IACxB;;OAEG;IACK,iBAAiB,CAMG;IAE5B;;OAEG;IACH,oBAAoB,CAClB,MAM2B;QAE3B,IAAI,CAAC,iBAAiB,GAAG,MAAM,CAAC;IAClC,CAAC;IAED;;;;OAIG;IACK,oBAAoB,CAAC,MAAoB;QAC/C,IAAI,CAAC,MAAM,EAAE,CAAC;YACZ,MAAM,IAAI,KAAK,CAAC,iDAAiD,CAAC,CAAC;QACrE,CAAC;QAED,IAAI,MAAM,CAAC,KAAK,KAAK,SAAS,IAAI,CAAC,OAAO,MAAM,CAAC,KAAK,KAAK,QAAQ,IAAI,MAAM,CAAC,KAAK,IAAI,CAAC,CAAC,EAAE,CAAC;YAC1F,MAAM,IAAI,KAAK,CAAC,gDAAgD,CAAC,CAAC;QACpE,CAAC;QAED,IAAI,MAAM,CAAC,MAAM,KAAK,SAAS,IAAI,CAAC,OAAO,MAAM,CAAC,MAAM,KAAK,QAAQ,IAAI,MAAM,CAAC,MAAM,IAAI,CAAC,CAAC,EAAE,CAAC;YAC7F,MAAM,IAAI,KAAK,CAAC,iDAAiD,CAAC,CAAC;QACrE,CAAC;QAED,IAAI,MAAM,CAAC,OAAO,KAAK,SAAS,IAAI,CAAC,OAAO,MAAM,CAAC,OAAO,KAAK,QAAQ,IAAI,MAAM,CAAC,OAAO,GAAG,CAAC,IAAI,MAAM,CAAC,OAAO,GAAG,CAAC,CAAC,EAAE,CAAC;YACrH,MAAM,IAAI,KAAK,CAAC,yDAAyD,CAAC,CAAC;QAC7E,CAAC;QAED,IAAI,MAAM,CAAC,IAAI,EAAE,KAAK,KAAK,SAAS,IAAI,CAAC,OAAO,MAAM,CAAC,IAAI,CAAC,KAAK,KAAK,QAAQ,IAAI,MAAM,CAAC,IAAI,CAAC,KAAK,IAAI,CAAC,CAAC,EAAE,CAAC;YAC1G,MAAM,IAAI,KAAK,CAAC,qDAAqD,CAAC,CAAC;QACzE,CAAC;IACH,CAAC;IAED;;;;;;OAMG;IACH,KAAK,CAAC,YAAY,CAAC,MAAoB;QACrC,IAAI,CAAC;YACH,gCAAgC;YAChC,IAAI,CAAC,oBAAoB,CAAC,MAAM,CAAC,CAAC;YAElC,wBAAwB;YACxB,IAAI,MAAM,CAAC,QAAQ,EAAE,OAAO,EAAE,CAAC;gBAC7B,IAAI,CAAC,GAAG,MAAM,CAAC,QAAQ,CAAC,MAAM,CAAC;gBAC/B,IAAI,CAAC,eAAe,CAAC,IAAI,CAAC,CAAC,CAAC;oBAAE,CAAC,GAAG,cAAI,CAAC,IAAI,CAAC,OAAO,CAAC,GAAG,EAAE,EAAE,CAAC,CAAC,CAAC;gBAC9D,IAAI,CAAC;oBACH,MAAM,GAAG,GAAG,MAAM,IAAA,kBAAS,EAAC,CAAC,CAAC,CAAC;oBAC/B,MAAM,CAAC,KAAK,GAAG,GAAG,CAAC,KAAK,CAAC;oBACzB,MAAM,CAAC,MAAM,GAAG,GAAG,CAAC,MAAM,CAAC;gBAC7B,CAAC;gBAAC,OAAO,CAAU,EAAE,CAAC;oBACpB,MAAM,YAAY,GAAG,CAAC,YAAY,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC;oBAChE,MAAM,IAAI,KAAK,CAAC,0DAA0D,YAAY,EAAE,CAAC,CAAC;gBAC5F,CAAC;YACH,CAAC;YAED,yCAAyC;YACzC,IAAI,MAAM,CAAC,OAAO,IAAI,IAAI,CAAC,iBAAiB,EAAE,CAAC;gBAC7C,IAAI,CAAC;oBACH,MAAM,WAAW,GAAG,MAAM,IAAI,CAAC,iBAAiB,CAC9C,MAAM,CAAC,OAAO,CAAC,MAAM,EACrB,MAAM,CAAC,OAAO,CAAC,KAAK,IAAI,CAAC,EACzB,MAAM,CAAC,OAAO,CAAC,IAAI,EACnB,MAAM,CAAC,OAAO,CAAC,MAAM,IAAI,KAAK,EAC9B,MAAM,CAAC,OAAO,CAAC,OAAO,IAAI,CAAC,CAC5B,CAAC;oBACF,IAAI,WAAW,EAAE,CAAC;wBAChB,MAAM,GAAG,GAAG,MAAM,IAAA,kBAAS,EAAC,WAAW,CAAC,CAAC;wBACzC,IAAI,CAAC,MAAM,CAAC,KAAK;4BAAE,MAAM,CAAC,KAAK,GAAG,GAAG,CAAC,KAAK,CAAC;wBAC5C,IAAI,CAAC,MAAM,CAAC,MAAM;4BAAE,MAAM,CAAC,MAAM,GAAG,GAAG,CAAC,MAAM,CAAC;oBACjD,CAAC;gBACH,CAAC;gBAAC,OAAO,CAAU,EAAE,CAAC;oBACpB,OAAO,CAAC,IAAI,CAAC,wEAAwE,CAAC,CAAC;gBACzF,CAAC;YACH,CAAC;YAED,uCAAuC;YACvC,MAAM,KAAK,GAAG,MAAM,CAAC,KAAK,IAAI,GAAG,CAAC;YAClC,MAAM,MAAM,GAAG,MAAM,CAAC,MAAM,IAAI,GAAG,CAAC;YAEpC,MAAM,EACJ,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,CAAC,EACZ,QAAQ,GAAG,CAAC,EACZ,YAAY,GAAG,CAAC,EAChB,cAAc,GAAG,KAAK,EACtB,OAAO,GAAG,CAAC,EACX,OAAO,EAAE,QAAQ,EAAE,UAAU,EAAE,OAAO,EACtC,SAAS,EAAE,OAAO,EAAE,SAAS,EAC7B,IAAI,EAAE,MAAM,EAAE,MAAM,EACpB,IAAI,EACL,GAAG,MAAM,CAAC;YAEX,oCAAoC;YACpC,MAAM,SAAS,GAAG;gBAChB,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,IAAI;gBACjC,MAAM,CAAC,UAAU,CAAC,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,IAAI;gBACvC,MAAM,CAAC,QAAQ,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC,IAAI;aACpC,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;YAElB,IAAI,SAAS,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;gBACzB,MAAM,IAAI,KAAK,CAAC,yFAAyF,SAAS,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;YACnI,CAAC;YAED,MAAM,EAAE,GAAG,IAAA,qBAAY,EAAC,KAAK,EAAE,MAAM,CAAC,CAAC;YACvC,MAAM,GAAG,GAAG,IAAA,6BAAgB,EAAC,EAAE,CAAC,CAAC;YAEjC,GAAG,CAAC,WAAW,GAAG,OAAO,CAAC;YAE1B,iCAAiC;YACjC,GAAG,CAAC,IAAI,EAAE,CAAC;YACX,IAAA,qBAAa,EAAC,GAAG,EAAE,QAAQ,EAAE,CAAC,EAAE,CAAC,EAAE,KAAK,EAAE,MAAM,CAAC,CAAC;YAElD,IAAA,iBAAS,EAAC,GAAG,EAAE,CAAC,EAAE,CAAC,EAAE,KAAK,EAAE,MAAM,EAAE,YAAY,EAAE,cAAc,CAAC,CAAC;YAClE,GAAG,CAAC,IAAI,EAAE,CAAC;YAEX,IAAA,uBAAe,EAAC,GAAG,EAAE,KAAK,EAAE,MAAM,EAAE,IAAI,CAAC,CAAC;YAE1C,GAAG,CAAC,SAAS,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;YACpB,IAAI,OAAO,SAAS,KAAK,QAAQ,EAAE,CAAC;gBAClC,GAAG,CAAC,wBAAwB,GAAG,SAAqC,CAAC;YACvE,CAAC;YAED,yFAAyF;YACzF,IAAI,OAAO,IAAI,IAAI,CAAC,iBAAiB,EAAE,CAAC;gBACtC,IAAI,CAAC;oBACH,4EAA4E;oBAC5E,MAAM,WAAW,GAAG,MAAM,IAAI,CAAC,iBAAiB,CAC9C,OAAO,CAAC,MAAM,EACd,OAAO,CAAC,KAAK,IAAI,CAAC,EAClB,OAAO,CAAC,IAAI,EACZ,KAAK,EAAE,+BAA+B;oBACtC,CAAC,CACF,CAAC;oBACF,IAAI,WAAW,IAAI,WAAW,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;wBAC1C,IAAI,QAAQ,CAAC;wBACb,IAAI,CAAC;4BACH,QAAQ,GAAG,MAAM,IAAA,kBAAS,EAAC,WAAW,CAAC,CAAC;wBAC1C,CAAC;wBAAC,OAAO,WAAW,EAAE,CAAC;4BACrB,8EAA8E;4BAC9E,MAAM,aAAa,GAAG,cAAI,CAAC,IAAI,CAAC,OAAO,CAAC,GAAG,EAAE,EAAE,cAAc,EAAE,iBAAiB,IAAI,CAAC,GAAG,EAAE,MAAM,CAAC,CAAC;4BAClG,MAAM,QAAQ,GAAG,cAAI,CAAC,OAAO,CAAC,aAAa,CAAC,CAAC;4BAC7C,IAAI,CAAC,YAAE,CAAC,UAAU,CAAC,QAAQ,CAAC,EAAE,CAAC;gCAC7B,YAAE,CAAC,SAAS,CAAC,QAAQ,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;4BAC9C,CAAC;4BACD,YAAE,CAAC,aAAa,CAAC,aAAa,EAAE,WAAW,CAAC,CAAC;4BAC7C,QAAQ,GAAG,MAAM,IAAA,kBAAS,EAAC,aAAa,CAAC,CAAC;4BAC1C,kCAAkC;4BAClC,IAAI,YAAE,CAAC,UAAU,CAAC,aAAa,CAAC,EAAE,CAAC;gCACjC,YAAE,CAAC,UAAU,CAAC,aAAa,CAAC,CAAC;4BAC/B,CAAC;wBACH,CAAC;wBAED,IAAI,QAAQ,IAAI,QAAQ,CAAC,KAAK,GAAG,CAAC,IAAI,QAAQ,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;4BAC1D,GAAG,CAAC,WAAW,GAAG,OAAO,CAAC,OAAO,IAAI,CAAC,CAAC;4BACvC,GAAG,CAAC,SAAS,CAAC,QAAQ,EAAE,CAAC,EAAE,CAAC,EAAE,KAAK,EAAE,MAAM,CAAC,CAAC;4BAC7C,GAAG,CAAC,WAAW,GAAG,OAAO,CAAC;wBAC5B,CAAC;6BAAM,CAAC;4BACN,MAAM,IAAI,KAAK,CAAC,iDAAiD,QAAQ,EAAE,KAAK,IAAI,QAAQ,EAAE,MAAM,EAAE,CAAC,CAAC;wBAC1G,CAAC;oBACH,CAAC;yBAAM,CAAC;wBACN,MAAM,IAAI,KAAK,CAAC,wCAAwC,CAAC,CAAC;oBAC5D,CAAC;gBACH,CAAC;gBAAC,OAAO,CAAU,EAAE,CAAC;oBACpB,MAAM,QAAQ,GAAG,CAAC,YAAY,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,eAAe,CAAC;oBAClE,IAAI,QAAQ,CAAC,QAAQ,CAAC,kBAAkB,CAAC,IAAI,QAAQ,CAAC,QAAQ,CAAC,QAAQ,CAAC,EAAE,CAAC;wBACzE,MAAM,CAAC,CAAC;oBACV,CAAC;oBACD,MAAM,IAAI,KAAK,CAAC,4CAA4C,QAAQ,EAAE,CAAC,CAAC;gBAC1E,CAAC;YACH,CAAC;iBAAM,IAAI,QAAQ,EAAE,CAAC;gBACpB,0DAA0D;gBAC1D,MAAM,IAAA,wBAAgB,EAAC,GAAG,EAAE,EAAE,GAAG,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC;gBACjD,2CAA2C;gBAC3C,IAAI,QAAQ,CAAC,OAAO,IAAI,QAAQ,CAAC,OAAO,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;oBACpD,MAAM,UAAU,GAAG,IAAA,qBAAY,EAAC,KAAK,EAAE,MAAM,CAAC,CAAC;oBAC/C,MAAM,OAAO,GAAG,UAAU,CAAC,UAAU,CAAC,IAAI,CAAkB,CAAC;oBAC7D,IAAI,OAAO,EAAE,CAAC;wBACZ,OAAO,CAAC,SAAS,CAAC,EAAE,EAAE,CAAC,EAAE,CAAC,CAAC,CAAC;wBAC5B,MAAM,IAAA,0DAA8B,EAAC,OAAO,EAAE,QAAQ,CAAC,OAAO,EAAE,KAAK,EAAE,MAAM,CAAC,CAAC;wBAC/E,GAAG,CAAC,SAAS,CAAC,CAAC,EAAE,CAAC,EAAE,KAAK,EAAE,MAAM,CAAC,CAAC;wBACnC,GAAG,CAAC,WAAW,GAAG,QAAQ,CAAC,OAAO,IAAI,CAAC,CAAC;wBACxC,GAAG,CAAC,SAAS,CAAC,UAAU,EAAE,CAAC,EAAE,CAAC,CAAC,CAAC;wBAChC,GAAG,CAAC,WAAW,GAAG,OAAO,CAAC;oBAC5B,CAAC;gBACH,CAAC;qBAAM,IAAI,QAAQ,CAAC,OAAO,KAAK,SAAS,IAAI,QAAQ,CAAC,OAAO,KAAK,CAAC,EAAE,CAAC;oBACpE,GAAG,CAAC,WAAW,GAAG,QAAQ,CAAC,OAAO,CAAC;oBACnC,MAAM,IAAA,wBAAgB,EAAC,GAAG,EAAE,EAAE,GAAG,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC;oBACjD,GAAG,CAAC,WAAW,GAAG,OAAO,CAAC;gBAC5B,CAAC;qBAAM,CAAC;oBACN,MAAM,IAAA,wBAAgB,EAAC,GAAG,EAAE,EAAE,GAAG,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC;gBACnD,CAAC;YACH,CAAC;iBAAM,IAAI,UAAU,EAAE,CAAC;gBACtB,MAAM,IAAA,8BAAsB,EAAC,GAAG,EAAE,EAAE,GAAG,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC;YACzD,CAAC;iBAAM,CAAC;gBACN,4DAA4D;gBAC5D,MAAM,IAAA,2BAAmB,EAAC,GAAG,EAAE,EAAE,GAAG,MAAM,EAAE,IAAI,EAAE,OAAO,EAAE,OAAO,IAAI,MAAM,EAAE,CAAC,CAAC;YAClF,CAAC;YAED,IAAI,SAAS;gBAAE,MAAM,iDAAuB,CAAC,aAAa,CAAC,GAAG,EAAE,EAAE,EAAE,SAAS,CAAC,CAAC;YAC/E,IAAI,OAAO;gBAAE,IAAA,kBAAU,EAAC,GAAG,EAAE,KAAK,EAAE,MAAM,EAAE,OAAO,CAAC,SAAS,IAAI,IAAI,CAAC,CAAC;YAEvE,GAAG,CAAC,OAAO,EAAE,CAAC;YAEd,sBAAsB;YACtB,IAAI,MAAM,EAAE,CAAC;gBACX,GAAG,CAAC,IAAI,EAAE,CAAC;gBACX,IAAA,iBAAS,EAAC,GAAG,EAAE,CAAC,EAAE,CAAC,EAAE,KAAK,EAAE,MAAM,EAAE,YAAY,EAAE,cAAc,CAAC,CAAC;gBAClE,IAAA,mBAAW,EAAC,GAAG,EAAE,MAAM,EAAE,CAAC,EAAE,CAAC,EAAE,KAAK,EAAE,MAAM,CAAC,CAAC;gBAC9C,GAAG,CAAC,OAAO,EAAE,CAAC;YAChB,CAAC;YAED,sBAAsB;YACtB,IAAI,MAAM,EAAE,CAAC;gBACX,GAAG,CAAC,IAAI,EAAE,CAAC;gBACX,IAAA,iBAAS,EAAC,GAAG,EAAE,CAAC,EAAE,CAAC,EAAE,KAAK,EAAE,MAAM,EAAE,YAAY,EAAE,cAAc,CAAC,CAAC;gBAClE,IAAA,mBAAW,EAAC,GAAG,EAAE,MAAM,EAAE,CAAC,EAAE,CAAC,EAAE,KAAK,EAAE,MAAM,CAAC,CAAC;gBAC9C,GAAG,CAAC,OAAO,EAAE,CAAC;YAChB,CAAC;YAED,OAAO,EAAE,MAAM,EAAE,EAAE,CAAC,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,EAAE,CAAC;QACtD,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,MAAM,IAAI,KAAK,CAAC,wBAAwB,IAAA,4BAAe,EAAC,KAAK,CAAC,EAAE,CAAC,CAAC;QACpE,CAAC;IACH,CAAC;CACF;AAxPD,sCAwPC"}

package/dist/esm/Canvas/extended/ChartCreator.d.ts

@@ -0,0 +1,26 @@
+/**
+ * Extended class for chart creation functionality
+ */
+export declare class ChartCreator {
+    /**
+     * Creates a chart based on the specified type.
+     *
+     * @param chartType - Type of chart to create ('pie', 'bar', 'horizontalBar', 'line')
+     * @param data - Chart data (type depends on chartType)
+     * @param options - Chart options (type depends on chartType)
+     * @returns Promise<Buffer> - Chart image buffer
+     */
+    createChart(chartType: 'pie', data: import('../utils/Charts/piechart').PieSlice[], options?: import('../utils/Charts/piechart').PieChartOptions): Promise<Buffer>;
+    createChart(chartType: 'bar', data: import('../utils/Charts/barchart').BarChartData[], options?: import('../utils/Charts/barchart').BarChartOptions): Promise<Buffer>;
+    createChart(chartType: 'horizontalBar', data: import('../utils/Charts/horizontalbarchart').HorizontalBarChartData[], options?: import('../utils/Charts/horizontalbarchart').HorizontalBarChartOptions): Promise<Buffer>;
+    createChart(chartType: 'line', data: import('../utils/Charts/linechart').LineSeries[], options?: import('../utils/Charts/linechart').LineChartOptions): Promise<Buffer>;
+    /**
+     * Creates a comparison chart with two charts side by side or top/bottom.
+     * Each chart can be of any type (pie, bar, horizontalBar, line, donut) with its own data and config.
+     *
+     * @param options - Comparison chart configuration
+     * @returns Promise<Buffer> - Comparison chart image buffer
+     */
+    createComparisonChart(options: import('../utils/Charts/comparisonchart').ComparisonChartOptions): Promise<Buffer>;
+}
+//# sourceMappingURL=ChartCreator.d.ts.map

package/dist/esm/Canvas/extended/ChartCreator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ChartCreator.d.ts","sourceRoot":"","sources":["../../../../lib/Canvas/extended/ChartCreator.ts"],"names":[],"mappings":"AAOA;;GAEG;AACH,qBAAa,YAAY;IACvB;;;;;;;OAOG;IACG,WAAW,CACf,SAAS,EAAE,KAAK,EAChB,IAAI,EAAE,OAAO,0BAA0B,EAAE,QAAQ,EAAE,EACnD,OAAO,CAAC,EAAE,OAAO,0BAA0B,EAAE,eAAe,GAC3D,OAAO,CAAC,MAAM,CAAC;IACZ,WAAW,CACf,SAAS,EAAE,KAAK,EAChB,IAAI,EAAE,OAAO,0BAA0B,EAAE,YAAY,EAAE,EACvD,OAAO,CAAC,EAAE,OAAO,0BAA0B,EAAE,eAAe,GAC3D,OAAO,CAAC,MAAM,CAAC;IACZ,WAAW,CACf,SAAS,EAAE,eAAe,EAC1B,IAAI,EAAE,OAAO,oCAAoC,EAAE,sBAAsB,EAAE,EAC3E,OAAO,CAAC,EAAE,OAAO,oCAAoC,EAAE,yBAAyB,GAC/E,OAAO,CAAC,MAAM,CAAC;IACZ,WAAW,CACf,SAAS,EAAE,MAAM,EACjB,IAAI,EAAE,OAAO,2BAA2B,EAAE,UAAU,EAAE,EACtD,OAAO,CAAC,EAAE,OAAO,2BAA2B,EAAE,gBAAgB,GAC7D,OAAO,CAAC,MAAM,CAAC;IA4BlB;;;;;;OAMG;IACG,qBAAqB,CACzB,OAAO,EAAE,OAAO,iCAAiC,EAAE,sBAAsB,GACxE,OAAO,CAAC,MAAM,CAAC;CAOnB"}

package/dist/esm/Canvas/extended/ChartCreator.js

@@ -0,0 +1,50 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ChartCreator = void 0;
+const piechart_1 = require("../utils/Charts/piechart");
+const barchart_1 = require("../utils/Charts/barchart");
+const horizontalbarchart_1 = require("../utils/Charts/horizontalbarchart");
+const linechart_1 = require("../utils/Charts/linechart");
+const comparisonchart_1 = require("../utils/Charts/comparisonchart");
+const errorUtils_1 = require("../utils/errorUtils");
+/**
+ * Extended class for chart creation functionality
+ */
+class ChartCreator {
+    async createChart(chartType, data, options = {}) {
+        try {
+            switch (chartType) {
+                case 'pie':
+                    return await (0, piechart_1.createPieChart)(data, options);
+                case 'bar':
+                    return await (0, barchart_1.createBarChart)(data, options);
+                case 'horizontalBar':
+                    return await (0, horizontalbarchart_1.createHorizontalBarChart)(data, options);
+                case 'line':
+                    return await (0, linechart_1.createLineChart)(data, options);
+                default:
+                    throw new Error(`Unsupported chart type: ${chartType}`);
+            }
+        }
+        catch (error) {
+            throw new Error(`createChart failed for type '${chartType}': ${(0, errorUtils_1.getErrorMessage)(error)}`);
+        }
+    }
+    /**
+     * Creates a comparison chart with two charts side by side or top/bottom.
+     * Each chart can be of any type (pie, bar, horizontalBar, line, donut) with its own data and config.
+     *
+     * @param options - Comparison chart configuration
+     * @returns Promise<Buffer> - Comparison chart image buffer
+     */
+    async createComparisonChart(options) {
+        try {
+            return await (0, comparisonchart_1.createComparisonChart)(options);
+        }
+        catch (error) {
+            throw new Error(`createComparisonChart failed: ${(0, errorUtils_1.getErrorMessage)(error)}`);
+        }
+    }
+}
+exports.ChartCreator = ChartCreator;
+//# sourceMappingURL=ChartCreator.js.map

package/dist/esm/Canvas/extended/ChartCreator.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ChartCreator.js","sourceRoot":"","sources":["../../../../lib/Canvas/extended/ChartCreator.ts"],"names":[],"mappings":";;;AAAA,uDAA0D;AAC1D,uDAA0D;AAC1D,2EAA8E;AAC9E,yDAA4D;AAC5D,qEAAwE;AACxE,oDAAsD;AAEtD;;GAEG;AACH,MAAa,YAAY;IA6BvB,KAAK,CAAC,WAAW,CACf,SAAmD,EACnD,IAAS,EACT,UAAe,EAAE;QAEjB,IAAI,CAAC;YACH,QAAQ,SAAS,EAAE,CAAC;gBAClB,KAAK,KAAK;oBACR,OAAO,MAAM,IAAA,yBAAc,EAAC,IAAI,EAAE,OAAO,CAAC,CAAC;gBAE7C,KAAK,KAAK;oBACR,OAAO,MAAM,IAAA,yBAAc,EAAC,IAAI,EAAE,OAAO,CAAC,CAAC;gBAE7C,KAAK,eAAe;oBAClB,OAAO,MAAM,IAAA,6CAAwB,EAAC,IAAI,EAAE,OAAO,CAAC,CAAC;gBAEvD,KAAK,MAAM;oBACT,OAAO,MAAM,IAAA,2BAAe,EAAC,IAAI,EAAE,OAAO,CAAC,CAAC;gBAE9C;oBACE,MAAM,IAAI,KAAK,CAAC,2BAA2B,SAAS,EAAE,CAAC,CAAC;YAC5D,CAAC;QACH,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,MAAM,IAAI,KAAK,CAAC,gCAAgC,SAAS,MAAM,IAAA,4BAAe,EAAC,KAAK,CAAC,EAAE,CAAC,CAAC;QAC3F,CAAC;IACH,CAAC;IAED;;;;;;OAMG;IACH,KAAK,CAAC,qBAAqB,CACzB,OAAyE;QAEzE,IAAI,CAAC;YACH,OAAO,MAAM,IAAA,uCAAqB,EAAC,OAAO,CAAC,CAAC;QAC9C,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,MAAM,IAAI,KAAK,CAAC,iCAAiC,IAAA,4BAAe,EAAC,KAAK,CAAC,EAAE,CAAC,CAAC;QAC7E,CAAC;IACH,CAAC;CACF;AAxED,oCAwEC"}

package/dist/esm/Canvas/extended/GIFCreator.d.ts

@@ -0,0 +1,43 @@
+import type { GIFOptions, GIFResults } from "../utils/utils";
+/**
+ * Extended class for GIF creation functionality
+ */
+export declare class GIFCreator {
+    /**
+     * Validates GIF options and frames.
+     * @private
+     * @param gifFrames - GIF frames to validate
+     * @param options - GIF options to validate
+     */
+    private validateGIFOptions;
+    /**
+     * Resizes an image to target dimensions
+     * @private
+     */
+    private resizeImage;
+    /**
+     * Creates a file output stream
+     * @private
+     */
+    private createOutputStream;
+    /**
+     * Creates a buffer stream with getBuffer method
+     * @private
+     */
+    private createBufferStream;
+    /**
+     * Creates a GIF from frames
+     *
+     * @param gifFrames - Array of frames with background and duration
+     * @param options - GIF creation options
+     * @returns Promise<GIFResults | Buffer | string | Array<{ attachment: NodeJS.ReadableStream | any; name: string }> | undefined>
+     */
+    createGIF(gifFrames: {
+        background: string;
+        duration: number;
+    }[], options: GIFOptions): Promise<GIFResults | Buffer | string | Array<{
+        attachment: NodeJS.ReadableStream | any;
+        name: string;
+    }> | undefined>;
+}
+//# sourceMappingURL=GIFCreator.d.ts.map

package/dist/esm/Canvas/extended/GIFCreator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"GIFCreator.d.ts","sourceRoot":"","sources":["../../../../lib/Canvas/extended/GIFCreator.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,UAAU,EAAE,UAAU,EAAE,MAAM,gBAAgB,CAAC;AAG7D;;GAEG;AACH,qBAAa,UAAU;IACrB;;;;;OAKG;IACH,OAAO,CAAC,kBAAkB;IAuB1B;;;OAGG;YACW,WAAW;IAOzB;;;OAGG;IACH,OAAO,CAAC,kBAAkB;IAI1B;;;OAGG;IACH,OAAO,CAAC,kBAAkB;IAiB1B;;;;;;OAMG;IACG,SAAS,CACb,SAAS,EAAE;QAAE,UAAU,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,MAAM,CAAA;KAAE,EAAE,EACrD,OAAO,EAAE,UAAU,GAClB,OAAO,CAAC,UAAU,GAAG,MAAM,GAAG,MAAM,GAAG,KAAK,CAAC;QAAE,UAAU,EAAE,MAAM,CAAC,cAAc,GAAG,GAAG,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC,GAAG,SAAS,CAAC;CA6ExH"}

package/dist/esm/Canvas/extended/GIFCreator.js

@@ -0,0 +1,157 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.GIFCreator = void 0;
+const canvas_1 = require("@napi-rs/canvas");
+const gifencoder_1 = __importDefault(require("gifencoder"));
+const stream_1 = require("stream");
+const fs_1 = __importDefault(require("fs"));
+const errorUtils_1 = require("../utils/errorUtils");
+/**
+ * Extended class for GIF creation functionality
+ */
+class GIFCreator {
+    /**
+     * Validates GIF options and frames.
+     * @private
+     * @param gifFrames - GIF frames to validate
+     * @param options - GIF options to validate
+     */
+    validateGIFOptions(gifFrames, options) {
+        if (!gifFrames || gifFrames.length === 0) {
+            throw new Error("createGIF: At least one frame is required.");
+        }
+        for (const frame of gifFrames) {
+            if (!frame.background) {
+                throw new Error("createGIF: Each frame must have a background property.");
+            }
+            if (typeof frame.duration !== 'number' || frame.duration < 0) {
+                throw new Error("createGIF: Each frame duration must be a non-negative number.");
+            }
+        }
+        if (options.outputFormat === "file" && !options.outputFile) {
+            throw new Error("createGIF: outputFile is required when outputFormat is 'file'.");
+        }
+        if (options.repeat !== undefined && (typeof options.repeat !== "number" || options.repeat < 0)) {
+            throw new Error("createGIF: repeat must be a non-negative number or undefined.");
+        }
+        if (options.quality !== undefined && (typeof options.quality !== "number" || options.quality < 1 || options.quality > 20)) {
+            throw new Error("createGIF: quality must be a number between 1 and 20 or undefined.");
+        }
+    }
+    /**
+     * Resizes an image to target dimensions
+     * @private
+     */
+    async resizeImage(image, targetWidth, targetHeight) {
+        const canvas = (0, canvas_1.createCanvas)(targetWidth, targetHeight);
+        const ctx = canvas.getContext("2d");
+        ctx.drawImage(image, 0, 0, targetWidth, targetHeight);
+        return canvas;
+    }
+    /**
+     * Creates a file output stream
+     * @private
+     */
+    createOutputStream(outputFile) {
+        return fs_1.default.createWriteStream(outputFile);
+    }
+    /**
+     * Creates a buffer stream with getBuffer method
+     * @private
+     */
+    createBufferStream() {
+        const bufferStream = new stream_1.PassThrough();
+        const chunks = [];
+        bufferStream.on('data', (chunk) => {
+            chunks.push(chunk);
+        });
+        const extendedStream = bufferStream;
+        extendedStream.getBuffer = function () {
+            return Buffer.concat(chunks);
+        };
+        extendedStream.chunks = chunks;
+        return extendedStream;
+    }
+    /**
+     * Creates a GIF from frames
+     *
+     * @param gifFrames - Array of frames with background and duration
+     * @param options - GIF creation options
+     * @returns Promise<GIFResults | Buffer | string | Array<{ attachment: NodeJS.ReadableStream | any; name: string }> | undefined>
+     */
+    async createGIF(gifFrames, options) {
+        try {
+            this.validateGIFOptions(gifFrames, options);
+            const canvasWidth = options.width || 1200;
+            const canvasHeight = options.height || 1200;
+            const encoder = new gifencoder_1.default(canvasWidth, canvasHeight);
+            const useBufferStream = options.outputFormat !== "file";
+            const outputStream = useBufferStream
+                ? this.createBufferStream()
+                : (options.outputFile ? this.createOutputStream(options.outputFile) : this.createBufferStream());
+            encoder.createReadStream().pipe(outputStream);
+            encoder.start();
+            encoder.setRepeat(options.repeat || 0);
+            encoder.setQuality(options.quality || 10);
+            const canvas = (0, canvas_1.createCanvas)(canvasWidth, canvasHeight);
+            const ctx = (0, errorUtils_1.getCanvasContext)(canvas);
+            for (const frame of gifFrames) {
+                const image = await (0, canvas_1.loadImage)(frame.background);
+                const resizedImage = await this.resizeImage(image, canvasWidth, canvasHeight);
+                ctx.clearRect(0, 0, canvas.width, canvas.height);
+                ctx.drawImage(resizedImage, 0, 0);
+                if (options.watermark?.enable) {
+                    const watermark = await (0, canvas_1.loadImage)(options.watermark.url);
+                    ctx.drawImage(watermark, 10, canvasHeight - watermark.height - 10);
+                }
+                if (options.textOverlay) {
+                    ctx.font = `${options.textOverlay.fontSize || 20}px Arial`;
+                    ctx.fillStyle = options.textOverlay.fontColor || "white";
+                    ctx.fillText(options.textOverlay.text, options.textOverlay.x || 10, options.textOverlay.y || 30);
+                }
+                encoder.setDelay(frame.duration);
+                encoder.addFrame(ctx);
+            }
+            encoder.finish();
+            if (options.outputFormat === "file") {
+                outputStream.end();
+                await new Promise((resolve) => outputStream.on("finish", () => resolve()));
+            }
+            else if (options.outputFormat === "base64") {
+                await new Promise((resolve) => {
+                    outputStream.on("end", () => resolve());
+                    outputStream.end();
+                });
+                if ('getBuffer' in outputStream && typeof outputStream.getBuffer === 'function') {
+                    return outputStream.getBuffer().toString("base64");
+                }
+                throw new Error("createGIF: Unable to get buffer for base64 output.");
+            }
+            else if (options.outputFormat === "attachment") {
+                const gifStream = encoder.createReadStream();
+                return [{ attachment: gifStream, name: "gif.js" }];
+            }
+            else if (options.outputFormat === "buffer") {
+                await new Promise((resolve) => {
+                    outputStream.on("end", () => resolve());
+                    outputStream.end();
+                });
+                if ('getBuffer' in outputStream && typeof outputStream.getBuffer === 'function') {
+                    return outputStream.getBuffer();
+                }
+                throw new Error("createGIF: Unable to get buffer for buffer output.");
+            }
+            else {
+                throw new Error("Invalid output format. Supported formats are 'file', 'base64', 'attachment', and 'buffer'.");
+            }
+        }
+        catch (error) {
+            throw new Error(`createGIF failed: ${(0, errorUtils_1.getErrorMessage)(error)}`);
+        }
+    }
+}
+exports.GIFCreator = GIFCreator;
+//# sourceMappingURL=GIFCreator.js.map

package/dist/esm/Canvas/extended/GIFCreator.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"GIFCreator.js","sourceRoot":"","sources":["../../../../lib/Canvas/extended/GIFCreator.ts"],"names":[],"mappings":"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"}