instasave-sdk 1.2.6 → 1.2.8

package/dist/download/download-engine.js

@@ -0,0 +1,177 @@
+"use strict";
+/**
+ * Download engine - HTTP download with retries
+ */
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.DownloadEngine = void 0;
+const axios_1 = __importDefault(require("axios"));
+const fs = __importStar(require("fs"));
+const path = __importStar(require("path"));
+const crypto = __importStar(require("crypto"));
+const logger_1 = require("../utils/logger");
+class DownloadEngine {
+    constructor() {
+        this.tempDir = './temp';
+        this.defaultTimeout = 30000;
+        this.ensureTempDir();
+    }
+    async download(params) {
+        const { url, destPath, filename, onProgress, timeout = this.defaultTimeout } = params;
+        return this.downloadWithRetry(url, destPath, filename, 3, timeout, onProgress);
+    }
+    async downloadWithRetry(url, destPath, filename, maxRetries, timeout, onProgress) {
+        let attempt = 0;
+        let lastError = null;
+        while (attempt < maxRetries) {
+            attempt++;
+            const retryDelay = Math.pow(2, attempt - 1) * 1000;
+            try {
+                logger_1.log.debug(`⬇️  Downloading ${filename} (attempt ${attempt}/${maxRetries})`);
+                return await this.performDownload(url, destPath, timeout, onProgress);
+            }
+            catch (error) {
+                lastError = error;
+                logger_1.log.warn(`⬇️  Download attempt ${attempt} failed: ${lastError.message}`);
+                if (attempt < maxRetries) {
+                    logger_1.log.debug(`⬇️  Retrying in ${retryDelay}ms...`);
+                    await this.sleep(retryDelay);
+                }
+            }
+        }
+        return {
+            success: false,
+            bytes: 0,
+            path: '',
+            error: lastError?.message || 'Unknown error'
+        };
+    }
+    async performDownload(url, destPath, timeout, onProgress) {
+        const tempFilePath = path.join(this.tempDir, `${Date.now()}-${Math.random().toString(36).substr(2, 9)}`);
+        const response = await (0, axios_1.default)({
+            method: 'GET',
+            url: url,
+            responseType: 'stream',
+            timeout: timeout,
+            maxRedirects: 5,
+            headers: {
+                'User-Agent': 'Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/120.0.0.0 Safari/537.36',
+                'Accept': 'image/webp,image/apng,image/*,*/*;q=0.8',
+                'Accept-Language': 'en-US,en;q=0.9',
+                'Referer': 'https://www.instagram.com/'
+            }
+        });
+        const totalBytes = parseInt(response.headers['content-length'] || '0', 10);
+        let downloadedBytes = 0;
+        return new Promise((resolve, reject) => {
+            const writer = fs.createWriteStream(tempFilePath);
+            response.data.on('data', (chunk) => {
+                downloadedBytes += chunk.length;
+                if (totalBytes > 0 && onProgress) {
+                    const percent = Math.round((downloadedBytes / totalBytes) * 100);
+                    onProgress(percent);
+                }
+            });
+            response.data.pipe(writer);
+            writer.on('finish', () => {
+                try {
+                    fs.renameSync(tempFilePath, destPath);
+                    this.cleanupTemp('');
+                    resolve({
+                        success: true,
+                        bytes: downloadedBytes,
+                        path: destPath
+                    });
+                }
+                catch (error) {
+                    this.cleanupTemp(tempFilePath);
+                    reject(error);
+                }
+            });
+            writer.on('error', (error) => {
+                this.cleanupTemp(tempFilePath);
+                reject(error);
+            });
+        });
+    }
+    getFileNameFromUrl(url) {
+        try {
+            const urlObj = new URL(url);
+            const pathname = urlObj.pathname;
+            const filename = path.basename(pathname);
+            return filename || `image-${Date.now()}.jpg`;
+        }
+        catch {
+            return `image-${Date.now()}.jpg`;
+        }
+    }
+    getFileFormat(url) {
+        const filename = this.getFileNameFromUrl(url);
+        const ext = path.extname(filename).toLowerCase();
+        return ext.replace('.', '') || 'jpg';
+    }
+    async getFileHash(filePath) {
+        return new Promise((resolve, reject) => {
+            const hash = crypto.createHash('md5');
+            const stream = fs.createReadStream(filePath);
+            stream.on('data', (data) => hash.update(data));
+            stream.on('end', () => resolve(hash.digest('hex')));
+            stream.on('error', reject);
+        });
+    }
+    ensureTempDir() {
+        if (!fs.existsSync(this.tempDir)) {
+            fs.mkdirSync(this.tempDir, { recursive: true });
+        }
+    }
+    cleanupTemp(filePath) {
+        try {
+            if (filePath && fs.existsSync(filePath)) {
+                fs.unlinkSync(filePath);
+            }
+        }
+        catch (error) {
+            logger_1.log.debug(`Failed to cleanup temp file: ${error}`);
+        }
+    }
+    sleep(ms) {
+        return new Promise(resolve => setTimeout(resolve, ms));
+    }
+}
+exports.DownloadEngine = DownloadEngine;
+//# sourceMappingURL=download-engine.js.map

package/dist/download/download-engine.js.map

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

package/dist/download/download-manager.d.ts

@@ -0,0 +1,18 @@
+/**
+ * Download manager - main API for downloading images
+ */
+import { MediaData } from '../types';
+import { DownloadOptions, DownloadResult } from './types';
+export declare function downloadImages(data: MediaData, options: DownloadOptions): Promise<DownloadResult>;
+export declare class DownloadManager {
+    private engine;
+    private duplicateCache;
+    constructor();
+    downloadImages(data: MediaData, options: DownloadOptions): Promise<DownloadResult>;
+    generateFilename(data: MediaData, index: number, pattern: string, ext: string): string;
+    private checkDuplicate;
+    private hashString;
+    private sanitizeFilename;
+    private createDirectory;
+}
+//# sourceMappingURL=download-manager.d.ts.map

package/dist/download/download-manager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"download-manager.d.ts","sourceRoot":"","sources":["../../src/download/download-manager.ts"],"names":[],"mappings":"AAAA;;GAEG;AAKH,OAAO,EAAE,SAAS,EAAE,MAAM,UAAU,CAAC;AAErC,OAAO,EACL,eAAe,EACf,cAAc,EAGf,MAAM,SAAS,CAAC;AAEjB,wBAAsB,cAAc,CAClC,IAAI,EAAE,SAAS,EACf,OAAO,EAAE,eAAe,GACvB,OAAO,CAAC,cAAc,CAAC,CAGzB;AAED,qBAAa,eAAe;IAC1B,OAAO,CAAC,MAAM,CAAiB;IAC/B,OAAO,CAAC,cAAc,CAAc;;IAO9B,cAAc,CAClB,IAAI,EAAE,SAAS,EACf,OAAO,EAAE,eAAe,GACvB,OAAO,CAAC,cAAc,CAAC;IAmI1B,gBAAgB,CACd,IAAI,EAAE,SAAS,EACf,KAAK,EAAE,MAAM,EACb,OAAO,EAAE,MAAM,EACf,GAAG,EAAE,MAAM,GACV,MAAM;YAsBK,cAAc;IAmC5B,OAAO,CAAC,UAAU;IAUlB,OAAO,CAAC,gBAAgB;IAMxB,OAAO,CAAC,eAAe;CAKxB"}

package/dist/download/download-manager.js

@@ -0,0 +1,232 @@
+"use strict";
+/**
+ * Download manager - main API for downloading images
+ */
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.DownloadManager = void 0;
+exports.downloadImages = downloadImages;
+const fs = __importStar(require("fs"));
+const path = __importStar(require("path"));
+const logger_1 = require("../utils/logger");
+const download_engine_1 = require("./download-engine");
+async function downloadImages(data, options) {
+    const manager = new DownloadManager();
+    return manager.downloadImages(data, options);
+}
+class DownloadManager {
+    constructor() {
+        this.engine = new download_engine_1.DownloadEngine();
+        this.duplicateCache = new Set();
+    }
+    async downloadImages(data, options) {
+        const startTime = Date.now();
+        const { savePath, getFile = 'save', filename = '{username}_{postid}_{index}.{ext}', skipDuplicates = false, createSubfolders = false, onProgress, timeout = 30000 } = options;
+        if (!data.media || data.media.length === 0) {
+            return {
+                success: true,
+                total: 0,
+                downloaded: 0,
+                failed: 0,
+                skipped: 0,
+                files: [],
+                errors: [],
+                totalBytes: 0,
+                duration: Date.now() - startTime
+            };
+        }
+        let actualPath = savePath;
+        if (createSubfolders && data.profile_name) {
+            actualPath = path.join(savePath, this.sanitizeFilename(data.profile_name));
+        }
+        this.createDirectory(actualPath);
+        const files = [];
+        const errors = [];
+        let downloaded = 0;
+        let failed = 0;
+        let skipped = 0;
+        let totalBytes = 0;
+        for (let i = 0; i < data.media.length; i++) {
+            const mediaItem = data.media[i];
+            const current = i + 1;
+            const total = data.media.length;
+            const percent = Math.round((current / total) * 100);
+            if (onProgress) {
+                onProgress(percent, current, total);
+            }
+            try {
+                const ext = this.engine.getFileFormat(mediaItem.url);
+                const generatedFilename = this.generateFilename(data, i, filename, ext);
+                const destPath = path.join(actualPath, generatedFilename);
+                if (getFile === false) {
+                    files.push({
+                        index: i,
+                        url: mediaItem.url,
+                        path: destPath,
+                        filename: generatedFilename,
+                        bytes: 0,
+                        format: ext
+                    });
+                    continue;
+                }
+                if (skipDuplicates) {
+                    const tempPath = path.join('./temp', `check-${Date.now()}`);
+                    const isDuplicate = await this.checkDuplicate(mediaItem.url, tempPath);
+                    if (isDuplicate) {
+                        skipped++;
+                        logger_1.log.debug(`⬇️  Skipped duplicate: ${generatedFilename}`);
+                        continue;
+                    }
+                }
+                const result = await this.engine.download({
+                    url: mediaItem.url,
+                    destPath: destPath,
+                    filename: generatedFilename,
+                    timeout: timeout
+                });
+                if (result.success) {
+                    downloaded++;
+                    totalBytes += result.bytes;
+                    files.push({
+                        index: i,
+                        url: mediaItem.url,
+                        path: result.path,
+                        filename: generatedFilename,
+                        bytes: result.bytes,
+                        format: ext
+                    });
+                    logger_1.log.debug(`⬇️  Downloaded: ${generatedFilename}`);
+                }
+                else {
+                    failed++;
+                    errors.push({
+                        index: i,
+                        url: mediaItem.url,
+                        code: 'DOWNLOAD_FAILED',
+                        message: result.error || 'Unknown download error'
+                    });
+                    logger_1.log.warn(`⬇️  Failed to download: ${generatedFilename}`);
+                }
+            }
+            catch (error) {
+                failed++;
+                errors.push({
+                    index: i,
+                    url: mediaItem.url,
+                    code: 'ERROR',
+                    message: error instanceof Error ? error.message : String(error)
+                });
+                logger_1.log.error(`⬇️  Error downloading ${mediaItem.url}:`, error);
+            }
+        }
+        return {
+            success: failed === 0,
+            total: data.media.length,
+            downloaded,
+            failed,
+            skipped,
+            files,
+            errors,
+            totalBytes,
+            duration: Date.now() - startTime
+        };
+    }
+    generateFilename(data, index, pattern, ext) {
+        const postId = data.post_id || 'unknown';
+        const username = this.sanitizeFilename(data.profile_name || 'user');
+        const platform = data.platform || 'instagram';
+        const timestamp = Date.now();
+        const paddedIndex = (index + 1).toString().padStart(2, '0');
+        let filename = pattern
+            .replace('{username}', username)
+            .replace('{postid}', postId)
+            .replace('{index}', paddedIndex)
+            .replace('{platform}', platform)
+            .replace('{timestamp}', timestamp.toString())
+            .replace('{ext}', ext);
+        if (!path.extname(filename)) {
+            filename = `${filename}.${ext}`;
+        }
+        return filename;
+    }
+    async checkDuplicate(url, tempPath) {
+        const urlHash = this.hashString(url);
+        if (this.duplicateCache.has(urlHash)) {
+            return true;
+        }
+        try {
+            const downloadResult = await this.engine.download({
+                url: url,
+                destPath: tempPath,
+                filename: 'temp-check',
+                timeout: 5000
+            });
+            if (!downloadResult.success) {
+                return false;
+            }
+            const hash = await this.engine.getFileHash(tempPath);
+            this.duplicateCache.add(hash);
+            this.duplicateCache.add(urlHash);
+            if (fs.existsSync(tempPath)) {
+                fs.unlinkSync(tempPath);
+            }
+            return false;
+        }
+        catch {
+            return false;
+        }
+    }
+    hashString(str) {
+        let hash = 0;
+        for (let i = 0; i < str.length; i++) {
+            const char = str.charCodeAt(i);
+            hash = ((hash << 5) - hash) + char;
+            hash = hash & hash;
+        }
+        return hash.toString(16);
+    }
+    sanitizeFilename(filename) {
+        return filename
+            .replace(/[^a-zA-Z0-9\-_.]/g, '_')
+            .substring(0, 100);
+    }
+    createDirectory(dirPath) {
+        if (!fs.existsSync(dirPath)) {
+            fs.mkdirSync(dirPath, { recursive: true });
+        }
+    }
+}
+exports.DownloadManager = DownloadManager;
+//# sourceMappingURL=download-manager.js.map

package/dist/download/download-manager.js.map

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

package/dist/download/download-scrape.d.ts

@@ -0,0 +1,32 @@
+/**
+ * Download Scrape API
+ * Download image from URL with optional Base64 conversion
+ *
+ * Flow:
+ * - useBase64 = true:  Download → Base64 → File
+ * - useBase64 = false: Direct Download → File
+ */
+export interface DownloadScrapeOptions {
+    useBase64?: boolean;
+    outputPath?: string;
+    filename?: string;
+    timeout?: number;
+    retries?: number;
+}
+export interface DownloadScrapeResult {
+    success: boolean;
+    url: string;
+    localPath: string;
+    filename: string;
+    format: string;
+    bytes: number;
+    error?: string;
+}
+export declare function downloadScrape(url: string, options?: DownloadScrapeOptions): Promise<DownloadScrapeResult>;
+export declare class DownloadScrapeEngine {
+    private defaultOptions;
+    constructor(defaultOptions?: DownloadScrapeOptions);
+    download(url: string, options?: DownloadScrapeOptions): Promise<DownloadScrapeResult>;
+    downloadBatch(urls: string[], options?: DownloadScrapeOptions): Promise<DownloadScrapeResult[]>;
+}
+//# sourceMappingURL=download-scrape.d.ts.map

package/dist/download/download-scrape.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"download-scrape.d.ts","sourceRoot":"","sources":["../../src/download/download-scrape.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAOH,MAAM,WAAW,qBAAqB;IACpC,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,oBAAoB;IACnC,OAAO,EAAE,OAAO,CAAC;IACjB,GAAG,EAAE,MAAM,CAAC;IACZ,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AA6BD,wBAAsB,cAAc,CAClC,GAAG,EAAE,MAAM,EACX,OAAO,GAAE,qBAA0B,GAClC,OAAO,CAAC,oBAAoB,CAAC,CAqF/B;AAGD,qBAAa,oBAAoB;IAC/B,OAAO,CAAC,cAAc,CAAwB;gBAElC,cAAc,GAAE,qBAA0B;IAIhD,QAAQ,CACZ,GAAG,EAAE,MAAM,EACX,OAAO,GAAE,qBAA0B,GAClC,OAAO,CAAC,oBAAoB,CAAC;IAI1B,aAAa,CACjB,IAAI,EAAE,MAAM,EAAE,EACd,OAAO,GAAE,qBAA0B,GAClC,OAAO,CAAC,oBAAoB,EAAE,CAAC;CAKnC"}

package/dist/download/download-scrape.js

@@ -0,0 +1,159 @@
+"use strict";
+/**
+ * Download Scrape API
+ * Download image from URL with optional Base64 conversion
+ *
+ * Flow:
+ * - useBase64 = true:  Download → Base64 → File
+ * - useBase64 = false: Direct Download → File
+ */
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.DownloadScrapeEngine = void 0;
+exports.downloadScrape = downloadScrape;
+const axios_1 = __importDefault(require("axios"));
+const fs = __importStar(require("fs"));
+const path = __importStar(require("path"));
+const logger_1 = require("../utils/logger");
+function detectFormat(contentType) {
+    if (!contentType)
+        return 'jpg';
+    const mimeMap = {
+        'image/jpeg': 'jpg',
+        'image/jpg': 'jpg',
+        'image/png': 'png',
+        'image/webp': 'webp',
+        'image/gif': 'gif',
+        'image/bmp': 'bmp',
+        'image/svg+xml': 'svg'
+    };
+    const mime = contentType.split(';')[0].toLowerCase().trim();
+    return mimeMap[mime] || 'jpg';
+}
+function generateFilename(format) {
+    const timestamp = Date.now();
+    const random = Math.random().toString(36).substring(2, 8);
+    return `img_${timestamp}_${random}.${format}`;
+}
+async function sleep(ms) {
+    return new Promise(resolve => setTimeout(resolve, ms));
+}
+async function downloadScrape(url, options = {}) {
+    const { useBase64 = true, outputPath = './downloads', filename, timeout = 30000, retries = 3 } = options;
+    let attempt = 0;
+    let lastError = null;
+    while (attempt < retries) {
+        attempt++;
+        const retryDelay = Math.pow(2, attempt - 1) * 1000;
+        try {
+            logger_1.log.debug(`⬇️  DownloadScrape: ${url} (attempt ${attempt}/${retries})`);
+            // 1. Download image as buffer
+            const response = await axios_1.default.get(url, {
+                responseType: 'arraybuffer',
+                timeout: timeout,
+                headers: {
+                    'User-Agent': 'Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36',
+                    'Accept': 'image/webp,image/apng,image/*,*/*;q=0.8',
+                    'Referer': 'https://www.instagram.com/'
+                }
+            });
+            // 2. Detect format
+            const format = detectFormat(response.headers['content-type']);
+            const actualFilename = filename || generateFilename(format);
+            const destPath = path.join(outputPath, actualFilename);
+            // 3. Ensure output directory exists
+            if (!fs.existsSync(outputPath)) {
+                fs.mkdirSync(outputPath, { recursive: true });
+            }
+            // 4. Save file
+            if (useBase64) {
+                // Download → Base64 → File
+                const base64 = Buffer.from(response.data).toString('base64');
+                fs.writeFileSync(destPath, base64, 'base64');
+                logger_1.log.debug(`⬇️  Saved (Base64): ${destPath}`);
+            }
+            else {
+                // Direct Download → File
+                fs.writeFileSync(destPath, response.data);
+                logger_1.log.debug(`⬇️  Saved (Direct): ${destPath}`);
+            }
+            // 5. Get file stats
+            const stats = fs.statSync(destPath);
+            return {
+                success: true,
+                url: url,
+                localPath: destPath,
+                filename: actualFilename,
+                format: format,
+                bytes: stats.size
+            };
+        }
+        catch (error) {
+            lastError = error;
+            logger_1.log.warn(`⬇️  DownloadScrape attempt ${attempt} failed: ${lastError.message}`);
+            if (attempt < retries) {
+                logger_1.log.debug(`⬇️  Retrying in ${retryDelay}ms...`);
+                await sleep(retryDelay);
+            }
+        }
+    }
+    // All retries failed
+    return {
+        success: false,
+        url: url,
+        localPath: '',
+        filename: filename || '',
+        format: '',
+        bytes: 0,
+        error: lastError?.message || 'Unknown error'
+    };
+}
+// Export class for advanced usage
+class DownloadScrapeEngine {
+    constructor(defaultOptions = {}) {
+        this.defaultOptions = defaultOptions;
+    }
+    async download(url, options = {}) {
+        return downloadScrape(url, { ...this.defaultOptions, ...options });
+    }
+    async downloadBatch(urls, options = {}) {
+        return Promise.all(urls.map(url => this.download(url, options)));
+    }
+}
+exports.DownloadScrapeEngine = DownloadScrapeEngine;
+//# sourceMappingURL=download-scrape.js.map

package/dist/download/download-scrape.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"download-scrape.js","sourceRoot":"","sources":["../../src/download/download-scrape.ts"],"names":[],"mappings":";AAAA;;;;;;;GAOG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAoDH,wCAwFC;AA1ID,kDAA0B;AAC1B,uCAAyB;AACzB,2CAA6B;AAC7B,4CAAsC;AAoBtC,SAAS,YAAY,CAAC,WAA+B;IACnD,IAAI,CAAC,WAAW;QAAE,OAAO,KAAK,CAAC;IAE/B,MAAM,OAAO,GAA2B;QACtC,YAAY,EAAE,KAAK;QACnB,WAAW,EAAE,KAAK;QAClB,WAAW,EAAE,KAAK;QAClB,YAAY,EAAE,MAAM;QACpB,WAAW,EAAE,KAAK;QAClB,WAAW,EAAE,KAAK;QAClB,eAAe,EAAE,KAAK;KACvB,CAAC;IAEF,MAAM,IAAI,GAAG,WAAW,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,WAAW,EAAE,CAAC,IAAI,EAAE,CAAC;IAC5D,OAAO,OAAO,CAAC,IAAI,CAAC,IAAI,KAAK,CAAC;AAChC,CAAC;AAED,SAAS,gBAAgB,CAAC,MAAc;IACtC,MAAM,SAAS,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;IAC7B,MAAM,MAAM,GAAG,IAAI,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC,SAAS,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;IAC1D,OAAO,OAAO,SAAS,IAAI,MAAM,IAAI,MAAM,EAAE,CAAC;AAChD,CAAC;AAED,KAAK,UAAU,KAAK,CAAC,EAAU;IAC7B,OAAO,IAAI,OAAO,CAAC,OAAO,CAAC,EAAE,CAAC,UAAU,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC,CAAC;AACzD,CAAC;AAEM,KAAK,UAAU,cAAc,CAClC,GAAW,EACX,UAAiC,EAAE;IAEnC,MAAM,EACJ,SAAS,GAAG,IAAI,EAChB,UAAU,GAAG,aAAa,EAC1B,QAAQ,EACR,OAAO,GAAG,KAAK,EACf,OAAO,GAAG,CAAC,EACZ,GAAG,OAAO,CAAC;IAEZ,IAAI,OAAO,GAAG,CAAC,CAAC;IAChB,IAAI,SAAS,GAAiB,IAAI,CAAC;IAEnC,OAAO,OAAO,GAAG,OAAO,EAAE,CAAC;QACzB,OAAO,EAAE,CAAC;QACV,MAAM,UAAU,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,OAAO,GAAG,CAAC,CAAC,GAAG,IAAI,CAAC;QAEnD,IAAI,CAAC;YACH,YAAG,CAAC,KAAK,CAAC,uBAAuB,GAAG,aAAa,OAAO,IAAI,OAAO,GAAG,CAAC,CAAC;YAExE,8BAA8B;YAC9B,MAAM,QAAQ,GAAG,MAAM,eAAK,CAAC,GAAG,CAAC,GAAG,EAAE;gBACpC,YAAY,EAAE,aAAa;gBAC3B,OAAO,EAAE,OAAO;gBAChB,OAAO,EAAE;oBACP,YAAY,EAAE,8DAA8D;oBAC5E,QAAQ,EAAE,yCAAyC;oBACnD,SAAS,EAAE,4BAA4B;iBACxC;aACF,CAAC,CAAC;YAEH,mBAAmB;YACnB,MAAM,MAAM,GAAG,YAAY,CAAC,QAAQ,CAAC,OAAO,CAAC,cAAc,CAAC,CAAC,CAAC;YAC9D,MAAM,cAAc,GAAG,QAAQ,IAAI,gBAAgB,CAAC,MAAM,CAAC,CAAC;YAC5D,MAAM,QAAQ,GAAG,IAAI,CAAC,IAAI,CAAC,UAAU,EAAE,cAAc,CAAC,CAAC;YAEvD,oCAAoC;YACpC,IAAI,CAAC,EAAE,CAAC,UAAU,CAAC,UAAU,CAAC,EAAE,CAAC;gBAC/B,EAAE,CAAC,SAAS,CAAC,UAAU,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;YAChD,CAAC;YAED,eAAe;YACf,IAAI,SAAS,EAAE,CAAC;gBACd,2BAA2B;gBAC3B,MAAM,MAAM,GAAG,MAAM,CAAC,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC;gBAC7D,EAAE,CAAC,aAAa,CAAC,QAAQ,EAAE,MAAM,EAAE,QAAQ,CAAC,CAAC;gBAC7C,YAAG,CAAC,KAAK,CAAC,uBAAuB,QAAQ,EAAE,CAAC,CAAC;YAC/C,CAAC;iBAAM,CAAC;gBACN,yBAAyB;gBACzB,EAAE,CAAC,aAAa,CAAC,QAAQ,EAAE,QAAQ,CAAC,IAAI,CAAC,CAAC;gBAC1C,YAAG,CAAC,KAAK,CAAC,uBAAuB,QAAQ,EAAE,CAAC,CAAC;YAC/C,CAAC;YAED,oBAAoB;YACpB,MAAM,KAAK,GAAG,EAAE,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC;YAEpC,OAAO;gBACL,OAAO,EAAE,IAAI;gBACb,GAAG,EAAE,GAAG;gBACR,SAAS,EAAE,QAAQ;gBACnB,QAAQ,EAAE,cAAc;gBACxB,MAAM,EAAE,MAAM;gBACd,KAAK,EAAE,KAAK,CAAC,IAAI;aAClB,CAAC;QAEJ,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,SAAS,GAAG,KAAc,CAAC;YAC3B,YAAG,CAAC,IAAI,CAAC,8BAA8B,OAAO,YAAY,SAAS,CAAC,OAAO,EAAE,CAAC,CAAC;YAE/E,IAAI,OAAO,GAAG,OAAO,EAAE,CAAC;gBACtB,YAAG,CAAC,KAAK,CAAC,mBAAmB,UAAU,OAAO,CAAC,CAAC;gBAChD,MAAM,KAAK,CAAC,UAAU,CAAC,CAAC;YAC1B,CAAC;QACH,CAAC;IACH,CAAC;IAED,qBAAqB;IACrB,OAAO;QACL,OAAO,EAAE,KAAK;QACd,GAAG,EAAE,GAAG;QACR,SAAS,EAAE,EAAE;QACb,QAAQ,EAAE,QAAQ,IAAI,EAAE;QACxB,MAAM,EAAE,EAAE;QACV,KAAK,EAAE,CAAC;QACR,KAAK,EAAE,SAAS,EAAE,OAAO,IAAI,eAAe;KAC7C,CAAC;AACJ,CAAC;AAED,kCAAkC;AAClC,MAAa,oBAAoB;IAG/B,YAAY,iBAAwC,EAAE;QACpD,IAAI,CAAC,cAAc,GAAG,cAAc,CAAC;IACvC,CAAC;IAED,KAAK,CAAC,QAAQ,CACZ,GAAW,EACX,UAAiC,EAAE;QAEnC,OAAO,cAAc,CAAC,GAAG,EAAE,EAAE,GAAG,IAAI,CAAC,cAAc,EAAE,GAAG,OAAO,EAAE,CAAC,CAAC;IACrE,CAAC;IAED,KAAK,CAAC,aAAa,CACjB,IAAc,EACd,UAAiC,EAAE;QAEnC,OAAO,OAAO,CAAC,GAAG,CAChB,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE,CAAC,IAAI,CAAC,QAAQ,CAAC,GAAG,EAAE,OAAO,CAAC,CAAC,CAC7C,CAAC;IACJ,CAAC;CACF;AAtBD,oDAsBC"}

package/dist/download/index.d.ts

@@ -0,0 +1,4 @@
+export * from './types';
+export { DownloadManager, downloadImages } from './download-manager';
+export { downloadScrape, DownloadScrapeEngine, DownloadScrapeOptions, DownloadScrapeResult } from './download-scrape';
+//# sourceMappingURL=index.d.ts.map

package/dist/download/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/download/index.ts"],"names":[],"mappings":"AAAA,cAAc,SAAS,CAAC;AACxB,OAAO,EAAE,eAAe,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAC;AACrE,OAAO,EAAE,cAAc,EAAE,oBAAoB,EAAE,qBAAqB,EAAE,oBAAoB,EAAE,MAAM,mBAAmB,CAAC"}