instasave-sdk 1.0.0

package/dist/logger.js

@@ -0,0 +1,151 @@
+"use strict";
+/**
+ * Structured Logger with format: TIMESTAMP | LEVEL | module:function:line - message
+ */
+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.log = void 0;
+const fs = __importStar(require("fs"));
+const path = __importStar(require("path"));
+const LEVEL_PRIORITY = {
+    DEBUG: 0,
+    INFO: 1,
+    WARNING: 2,
+    ERROR: 3
+};
+class Logger {
+    constructor() {
+        this.logFile = null;
+        this.minLevel = 'DEBUG';
+        this.initLogFile();
+        this.minLevel = process.env.LOG_LEVEL || 'DEBUG';
+    }
+    initLogFile() {
+        try {
+            const logsDir = path.join(process.cwd(), 'logs');
+            if (!fs.existsSync(logsDir)) {
+                fs.mkdirSync(logsDir, { recursive: true });
+            }
+            this.logFile = path.join(logsDir, 'app.log');
+            // Rotate if > 10MB
+            if (fs.existsSync(this.logFile)) {
+                const stats = fs.statSync(this.logFile);
+                if (stats.size > 10 * 1024 * 1024) {
+                    const backup = this.logFile + '.old';
+                    if (fs.existsSync(backup))
+                        fs.unlinkSync(backup);
+                    fs.renameSync(this.logFile, backup);
+                }
+            }
+        }
+        catch {
+            this.logFile = null;
+        }
+    }
+    getCallerInfo() {
+        const err = new Error();
+        const stack = err.stack?.split('\n') || [];
+        // Find first stack frame outside logger.ts
+        for (let i = 3; i < stack.length; i++) {
+            const line = stack[i];
+            if (line.includes('logger.ts') || line.includes('logger.js'))
+                continue;
+            // Parse: "at functionName (file:line:col)" or "at file:line:col"
+            const match = line.match(/at\s+(?:(.+?)\s+\()?(?:.*[/\\])?([^/\\]+?):(\d+):\d+\)?/);
+            if (match) {
+                const func = match[1]?.replace(/^Object\./, '') || 'anonymous';
+                const file = match[2]?.replace(/\.[jt]s$/, '') || 'unknown';
+                const lineNum = match[3] || '?';
+                return `${file}:${func}:${lineNum}`;
+            }
+        }
+        return 'unknown:unknown:?';
+    }
+    formatTimestamp() {
+        const now = new Date();
+        return now.toISOString().replace('T', ' ').substring(0, 19);
+    }
+    formatMessage(level, message, ...args) {
+        const timestamp = this.formatTimestamp();
+        const caller = this.getCallerInfo();
+        const levelPadded = level.padEnd(8);
+        // Format args
+        const formattedArgs = args.map(arg => typeof arg === 'object' ? JSON.stringify(arg) : String(arg)).join(' ');
+        const fullMessage = formattedArgs ? `${message} ${formattedArgs}` : message;
+        return `${timestamp} | ${levelPadded} | ${caller} - ${fullMessage}`;
+    }
+    shouldLog(level) {
+        return LEVEL_PRIORITY[level] >= LEVEL_PRIORITY[this.minLevel];
+    }
+    writeToFile(formatted) {
+        if (this.logFile) {
+            try {
+                fs.appendFileSync(this.logFile, formatted + '\n');
+            }
+            catch { }
+        }
+    }
+    log(level, message, ...args) {
+        if (!this.shouldLog(level))
+            return;
+        const formatted = this.formatMessage(level, message, ...args);
+        this.writeToFile(formatted);
+        switch (level) {
+            case 'ERROR':
+                console.error(formatted);
+                break;
+            case 'WARNING':
+                console.warn(formatted);
+                break;
+            default:
+                console.log(formatted);
+        }
+    }
+    debug(message, ...args) {
+        this.log('DEBUG', message, ...args);
+    }
+    info(message, ...args) {
+        this.log('INFO', message, ...args);
+    }
+    warn(message, ...args) {
+        this.log('WARNING', message, ...args);
+    }
+    error(message, ...args) {
+        this.log('ERROR', message, ...args);
+    }
+}
+exports.log = new Logger();
+exports.default = exports.log;
+//# sourceMappingURL=logger.js.map

package/dist/logger.js.map

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

package/dist/memory.d.ts

@@ -0,0 +1,56 @@
+interface MemoryLeak {
+    detected: boolean;
+    severity: 'low' | 'medium' | 'high';
+    growthRate: number;
+    recommendation: string;
+}
+/**
+ * Monitors memory usage and detects potential memory leaks
+ * @class MemoryMonitor
+ */
+export declare class MemoryMonitor {
+    private snapshots;
+    private monitoringInterval;
+    private readonly maxSnapshots;
+    private readonly leakThreshold;
+    /**
+     * Starts memory monitoring
+     * @param intervalMs - Monitoring interval in milliseconds (default: 5000)
+     */
+    startMonitoring(intervalMs?: number): void;
+    /**
+     * Stops memory monitoring
+     */
+    stopMonitoring(): void;
+    /**
+     * Takes a memory usage snapshot
+     */
+    takeSnapshot(): void;
+    /**
+     * Analyzes memory usage for potential leaks
+     * @returns MemoryLeak analysis result
+     */
+    detectLeaks(): MemoryLeak;
+    /**
+     * Gets current memory statistics
+     */
+    getMemoryStats(): {
+        current: {
+            heapUsed: string;
+            heapTotal: string;
+            rss: string;
+        };
+        leak: MemoryLeak;
+        snapshotCount: number;
+    } | null;
+    /**
+     * Forces garbage collection (if --expose-gc flag is used)
+     */
+    forceGC(): boolean;
+    /**
+     * Clears all snapshots
+     */
+    clearSnapshots(): void;
+}
+export {};
+//# sourceMappingURL=memory.d.ts.map

package/dist/memory.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"memory.d.ts","sourceRoot":"","sources":["../src/memory.ts"],"names":[],"mappings":"AASA,UAAU,UAAU;IAClB,QAAQ,EAAE,OAAO,CAAC;IAClB,QAAQ,EAAE,KAAK,GAAG,QAAQ,GAAG,MAAM,CAAC;IACpC,UAAU,EAAE,MAAM,CAAC;IACnB,cAAc,EAAE,MAAM,CAAC;CACxB;AAED;;;GAGG;AACH,qBAAa,aAAa;IACxB,OAAO,CAAC,SAAS,CAAwB;IACzC,OAAO,CAAC,kBAAkB,CAA+B;IACzD,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAO;IACpC,OAAO,CAAC,QAAQ,CAAC,aAAa,CAAoB;IAElD;;;OAGG;IACH,eAAe,CAAC,UAAU,GAAE,MAAa,GAAG,IAAI;IAYhD;;OAEG;IACH,cAAc,IAAI,IAAI;IAQtB;;OAEG;IACH,YAAY,IAAI,IAAI;IAkBpB;;;OAGG;IACH,WAAW,IAAI,UAAU;IA8CzB;;OAEG;IACH,cAAc;;;;;;;;;IAmBd;;OAEG;IACH,OAAO,IAAI,OAAO;IAWlB;;OAEG;IACH,cAAc,IAAI,IAAI;CAIvB"}

package/dist/memory.js

@@ -0,0 +1,144 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.MemoryMonitor = void 0;
+const logger_1 = require("./logger");
+/**
+ * Monitors memory usage and detects potential memory leaks
+ * @class MemoryMonitor
+ */
+class MemoryMonitor {
+    constructor() {
+        this.snapshots = [];
+        this.monitoringInterval = null;
+        this.maxSnapshots = 100;
+        this.leakThreshold = 10 * 1024 * 1024; // 10MB growth
+    }
+    /**
+     * Starts memory monitoring
+     * @param intervalMs - Monitoring interval in milliseconds (default: 5000)
+     */
+    startMonitoring(intervalMs = 5000) {
+        if (this.monitoringInterval) {
+            this.stopMonitoring();
+        }
+        this.monitoringInterval = setInterval(() => {
+            this.takeSnapshot();
+        }, intervalMs);
+        logger_1.log.info(`🔍 Memory monitoring started (interval: ${intervalMs}ms)`);
+    }
+    /**
+     * Stops memory monitoring
+     */
+    stopMonitoring() {
+        if (this.monitoringInterval) {
+            clearInterval(this.monitoringInterval);
+            this.monitoringInterval = null;
+            logger_1.log.info('🛑 Memory monitoring stopped');
+        }
+    }
+    /**
+     * Takes a memory usage snapshot
+     */
+    takeSnapshot() {
+        const memoryUsage = process.memoryUsage();
+        const snapshot = {
+            timestamp: Date.now(),
+            heapUsed: memoryUsage.heapUsed,
+            heapTotal: memoryUsage.heapTotal,
+            external: memoryUsage.external,
+            rss: memoryUsage.rss
+        };
+        this.snapshots.push(snapshot);
+        // Keep only recent snapshots
+        if (this.snapshots.length > this.maxSnapshots) {
+            this.snapshots.shift();
+        }
+    }
+    /**
+     * Analyzes memory usage for potential leaks
+     * @returns MemoryLeak analysis result
+     */
+    detectLeaks() {
+        if (this.snapshots.length < 10) {
+            return {
+                detected: false,
+                severity: 'low',
+                growthRate: 0,
+                recommendation: 'Not enough data for analysis'
+            };
+        }
+        // Calculate memory growth rate
+        const recent = this.snapshots.slice(-10);
+        const oldest = recent[0];
+        const newest = recent[recent.length - 1];
+        const timeDiff = newest.timestamp - oldest.timestamp;
+        const memoryDiff = newest.heapUsed - oldest.heapUsed;
+        const growthRate = (memoryDiff / timeDiff) * 1000; // bytes per second
+        let detected = false;
+        let severity = 'low';
+        let recommendation = 'Memory usage is stable';
+        if (memoryDiff > this.leakThreshold) {
+            detected = true;
+            if (growthRate > 1024 * 1024) { // 1MB/s
+                severity = 'high';
+                recommendation = 'Critical: High memory growth detected. Check for unclosed resources.';
+            }
+            else if (growthRate > 512 * 1024) { // 512KB/s
+                severity = 'medium';
+                recommendation = 'Warning: Moderate memory growth detected. Monitor closely.';
+            }
+            else {
+                severity = 'low';
+                recommendation = 'Info: Slow memory growth detected. May be normal operation.';
+            }
+        }
+        return {
+            detected,
+            severity,
+            growthRate,
+            recommendation
+        };
+    }
+    /**
+     * Gets current memory statistics
+     */
+    getMemoryStats() {
+        if (this.snapshots.length === 0) {
+            return null;
+        }
+        const latest = this.snapshots[this.snapshots.length - 1];
+        const leak = this.detectLeaks();
+        return {
+            current: {
+                heapUsed: (latest.heapUsed / 1024 / 1024).toFixed(2) + ' MB',
+                heapTotal: (latest.heapTotal / 1024 / 1024).toFixed(2) + ' MB',
+                rss: (latest.rss / 1024 / 1024).toFixed(2) + ' MB'
+            },
+            leak,
+            snapshotCount: this.snapshots.length
+        };
+    }
+    /**
+     * Forces garbage collection (if --expose-gc flag is used)
+     */
+    forceGC() {
+        if (global.gc) {
+            global.gc();
+            logger_1.log.info('🗑️ Garbage collection forced');
+            return true;
+        }
+        else {
+            logger_1.log.info('⚠️ Garbage collection not available. Run with --expose-gc flag.');
+            return false;
+        }
+    }
+    /**
+     * Clears all snapshots
+     */
+    clearSnapshots() {
+        this.snapshots = [];
+        logger_1.log.info('🧹 Memory snapshots cleared');
+    }
+}
+exports.MemoryMonitor = MemoryMonitor;
+//# sourceMappingURL=memory.js.map

package/dist/memory.js.map

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

package/dist/metrics.d.ts

@@ -0,0 +1,19 @@
+export interface ScrapingMetrics {
+    totalRequests: number;
+    successfulRequests: number;
+    failedRequests: number;
+    averageResponseTime: number;
+    totalImagesExtracted: number;
+    totalDataSize: number;
+    errorsByType: Record<string, number>;
+    requestsByHour: Record<string, number>;
+}
+export declare class MetricsCollector {
+    private metrics;
+    private responseTimes;
+    recordRequest(success: boolean, responseTime: number, imageCount?: number, dataSize?: number, error?: string): void;
+    getMetrics(): ScrapingMetrics;
+    getPrometheusMetrics(): string;
+    reset(): void;
+}
+//# sourceMappingURL=metrics.d.ts.map

package/dist/metrics.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"metrics.d.ts","sourceRoot":"","sources":["../src/metrics.ts"],"names":[],"mappings":"AACA,MAAM,WAAW,eAAe;IAC9B,aAAa,EAAE,MAAM,CAAC;IACtB,kBAAkB,EAAE,MAAM,CAAC;IAC3B,cAAc,EAAE,MAAM,CAAC;IACvB,mBAAmB,EAAE,MAAM,CAAC;IAC5B,oBAAoB,EAAE,MAAM,CAAC;IAC7B,aAAa,EAAE,MAAM,CAAC;IACtB,YAAY,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACrC,cAAc,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CACxC;AAED,qBAAa,gBAAgB;IAC3B,OAAO,CAAC,OAAO,CASb;IAEF,OAAO,CAAC,aAAa,CAAgB;IAErC,aAAa,CAAC,OAAO,EAAE,OAAO,EAAE,YAAY,EAAE,MAAM,EAAE,UAAU,GAAE,MAAU,EAAE,QAAQ,GAAE,MAAU,EAAE,KAAK,CAAC,EAAE,MAAM,GAAG,IAAI;IAuBzH,UAAU,IAAI,eAAe;IAI7B,oBAAoB,IAAI,MAAM;IAwB9B,KAAK,IAAI,IAAI;CAad"}

package/dist/metrics.js

@@ -0,0 +1,79 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.MetricsCollector = void 0;
+class MetricsCollector {
+    constructor() {
+        this.metrics = {
+            totalRequests: 0,
+            successfulRequests: 0,
+            failedRequests: 0,
+            averageResponseTime: 0,
+            totalImagesExtracted: 0,
+            totalDataSize: 0,
+            errorsByType: {},
+            requestsByHour: {}
+        };
+        this.responseTimes = [];
+    }
+    recordRequest(success, responseTime, imageCount = 0, dataSize = 0, error) {
+        this.metrics.totalRequests++;
+        this.responseTimes.push(responseTime);
+        if (success) {
+            this.metrics.successfulRequests++;
+            this.metrics.totalImagesExtracted += imageCount;
+            this.metrics.totalDataSize += dataSize;
+        }
+        else {
+            this.metrics.failedRequests++;
+            if (error) {
+                this.metrics.errorsByType[error] = (this.metrics.errorsByType[error] || 0) + 1;
+            }
+        }
+        // Update average response time
+        this.metrics.averageResponseTime = this.responseTimes.reduce((a, b) => a + b, 0) / this.responseTimes.length;
+        // Track requests by hour
+        const hour = new Date().getHours().toString();
+        this.metrics.requestsByHour[hour] = (this.metrics.requestsByHour[hour] || 0) + 1;
+    }
+    getMetrics() {
+        return { ...this.metrics };
+    }
+    getPrometheusMetrics() {
+        return `
+# HELP instasave_requests_total Total number of scraping requests
+# TYPE instasave_requests_total counter
+instasave_requests_total ${this.metrics.totalRequests}
+
+# HELP instasave_requests_successful_total Successful scraping requests
+# TYPE instasave_requests_successful_total counter
+instasave_requests_successful_total ${this.metrics.successfulRequests}
+
+# HELP instasave_requests_failed_total Failed scraping requests
+# TYPE instasave_requests_failed_total counter
+instasave_requests_failed_total ${this.metrics.failedRequests}
+
+# HELP instasave_response_time_avg Average response time in milliseconds
+# TYPE instasave_response_time_avg gauge
+instasave_response_time_avg ${this.metrics.averageResponseTime}
+
+# HELP instasave_images_extracted_total Total images extracted
+# TYPE instasave_images_extracted_total counter
+instasave_images_extracted_total ${this.metrics.totalImagesExtracted}
+`.trim();
+    }
+    reset() {
+        this.metrics = {
+            totalRequests: 0,
+            successfulRequests: 0,
+            failedRequests: 0,
+            averageResponseTime: 0,
+            totalImagesExtracted: 0,
+            totalDataSize: 0,
+            errorsByType: {},
+            requestsByHour: {}
+        };
+        this.responseTimes = [];
+    }
+}
+exports.MetricsCollector = MetricsCollector;
+//# sourceMappingURL=metrics.js.map

package/dist/metrics.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"metrics.js","sourceRoot":"","sources":["../src/metrics.ts"],"names":[],"mappings":";;;AAYA,MAAa,gBAAgB;IAA7B;QACU,YAAO,GAAoB;YACjC,aAAa,EAAE,CAAC;YAChB,kBAAkB,EAAE,CAAC;YACrB,cAAc,EAAE,CAAC;YACjB,mBAAmB,EAAE,CAAC;YACtB,oBAAoB,EAAE,CAAC;YACvB,aAAa,EAAE,CAAC;YAChB,YAAY,EAAE,EAAE;YAChB,cAAc,EAAE,EAAE;SACnB,CAAC;QAEM,kBAAa,GAAa,EAAE,CAAC;IAkEvC,CAAC;IAhEC,aAAa,CAAC,OAAgB,EAAE,YAAoB,EAAE,aAAqB,CAAC,EAAE,WAAmB,CAAC,EAAE,KAAc;QAChH,IAAI,CAAC,OAAO,CAAC,aAAa,EAAE,CAAC;QAC7B,IAAI,CAAC,aAAa,CAAC,IAAI,CAAC,YAAY,CAAC,CAAC;QAEtC,IAAI,OAAO,EAAE,CAAC;YACZ,IAAI,CAAC,OAAO,CAAC,kBAAkB,EAAE,CAAC;YAClC,IAAI,CAAC,OAAO,CAAC,oBAAoB,IAAI,UAAU,CAAC;YAChD,IAAI,CAAC,OAAO,CAAC,aAAa,IAAI,QAAQ,CAAC;QACzC,CAAC;aAAM,CAAC;YACN,IAAI,CAAC,OAAO,CAAC,cAAc,EAAE,CAAC;YAC9B,IAAI,KAAK,EAAE,CAAC;gBACV,IAAI,CAAC,OAAO,CAAC,YAAY,CAAC,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC,OAAO,CAAC,YAAY,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC;YACjF,CAAC;QACH,CAAC;QAED,+BAA+B;QAC/B,IAAI,CAAC,OAAO,CAAC,mBAAmB,GAAG,IAAI,CAAC,aAAa,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC,GAAG,IAAI,CAAC,aAAa,CAAC,MAAM,CAAC;QAE7G,yBAAyB;QACzB,MAAM,IAAI,GAAG,IAAI,IAAI,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,EAAE,CAAC;QAC9C,IAAI,CAAC,OAAO,CAAC,cAAc,CAAC,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,OAAO,CAAC,cAAc,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC;IACnF,CAAC;IAED,UAAU;QACR,OAAO,EAAE,GAAG,IAAI,CAAC,OAAO,EAAE,CAAC;IAC7B,CAAC;IAED,oBAAoB;QAClB,OAAO;;;2BAGgB,IAAI,CAAC,OAAO,CAAC,aAAa;;;;sCAIf,IAAI,CAAC,OAAO,CAAC,kBAAkB;;;;kCAInC,IAAI,CAAC,OAAO,CAAC,cAAc;;;;8BAI/B,IAAI,CAAC,OAAO,CAAC,mBAAmB;;;;mCAI3B,IAAI,CAAC,OAAO,CAAC,oBAAoB;CACnE,CAAC,IAAI,EAAE,CAAC;IACP,CAAC;IAED,KAAK;QACH,IAAI,CAAC,OAAO,GAAG;YACb,aAAa,EAAE,CAAC;YAChB,kBAAkB,EAAE,CAAC;YACrB,cAAc,EAAE,CAAC;YACjB,mBAAmB,EAAE,CAAC;YACtB,oBAAoB,EAAE,CAAC;YACvB,aAAa,EAAE,CAAC;YAChB,YAAY,EAAE,EAAE;YAChB,cAAc,EAAE,EAAE;SACnB,CAAC;QACF,IAAI,CAAC,aAAa,GAAG,EAAE,CAAC;IAC1B,CAAC;CACF;AA9ED,4CA8EC"}

package/dist/parallel.d.ts

@@ -0,0 +1,59 @@
+import { InstagramPostData, ScrapingOptions } from './index';
+/**
+ * Parallel processing manager for Instagram scraping
+ * @class ParallelProcessor
+ */
+export declare class ParallelProcessor {
+    private workerPool;
+    private tasks;
+    private maxWorkers;
+    /**
+     * Creates a new ParallelProcessor
+     * @param maxWorkers - Maximum number of worker threads (default: 4)
+     */
+    constructor(maxWorkers?: number);
+    /**
+     * Initializes the worker thread pool
+     */
+    private initializeWorkerPool;
+    /**
+     * Handles messages from worker threads
+     */
+    private handleWorkerMessage;
+    /**
+     * Handles worker errors
+     */
+    private handleWorkerError;
+    /**
+     * Scrapes multiple Instagram posts in parallel
+     * @param urls - Array of Instagram post URLs
+     * @param options - Scraping options
+     * @returns Promise<InstagramPostData[]>
+     */
+    scrapeMultiple(urls: string[], options?: ScrapingOptions): Promise<InstagramPostData[]>;
+    /**
+     * Executes tasks using available workers
+     */
+    private executeTasks;
+    /**
+     * Gets processing statistics
+     */
+    getStats(): {
+        totalTasks: number;
+        completed: number;
+        failed: number;
+        running: number;
+        pending: number;
+        availableWorkers: number;
+        busyWorkers: number;
+    };
+    /**
+     * Generates unique task ID
+     */
+    private generateTaskId;
+    /**
+     * Shuts down all workers
+     */
+    shutdown(): Promise<void>;
+}
+//# sourceMappingURL=parallel.d.ts.map

package/dist/parallel.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"parallel.d.ts","sourceRoot":"","sources":["../src/parallel.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,iBAAiB,EAAE,eAAe,EAAE,MAAM,SAAS,CAAC;AAqB7D;;;GAGG;AACH,qBAAa,iBAAiB;IAC5B,OAAO,CAAC,UAAU,CAAa;IAC/B,OAAO,CAAC,KAAK,CAAwC;IACrD,OAAO,CAAC,UAAU,CAAS;IAE3B;;;OAGG;gBACS,UAAU,GAAE,MAAU;IAUlC;;OAEG;IACH,OAAO,CAAC,oBAAoB;IAiB5B;;OAEG;IACH,OAAO,CAAC,mBAAmB;IAwB3B;;OAEG;IACH,OAAO,CAAC,iBAAiB;IAiBzB;;;;;OAKG;IACG,cAAc,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE,OAAO,GAAE,eAAoB,GAAG,OAAO,CAAC,iBAAiB,EAAE,CAAC;IAgCjG;;OAEG;YACW,YAAY;IA2D1B;;OAEG;IACH,QAAQ;;;;;;;;;IAkBR;;OAEG;IACH,OAAO,CAAC,cAAc;IAItB;;OAEG;IACG,QAAQ,IAAI,OAAO,CAAC,IAAI,CAAC;CAMhC"}