instasave-sdk 1.0.0

package/dist/health.js

@@ -0,0 +1,108 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.HealthChecker = void 0;
+class HealthChecker {
+    constructor() {
+        this.startTime = Date.now();
+        this.errors = [];
+    }
+    async checkHealth() {
+        const errors = [];
+        let status = 'healthy';
+        // Memory check
+        const memoryUsage = process.memoryUsage();
+        const memoryPercentage = (memoryUsage.heapUsed / memoryUsage.heapTotal) * 100;
+        if (memoryPercentage > 90) {
+            errors.push('High memory usage');
+            status = 'unhealthy';
+        }
+        else if (memoryPercentage > 70) {
+            errors.push('Elevated memory usage');
+            status = 'degraded';
+        }
+        // Browser check
+        let browserAvailable = false;
+        let browserVersion;
+        try {
+            const { execSync } = require('child_process');
+            // Try different browser detection methods
+            try {
+                // Try Chrome on macOS
+                browserVersion = execSync('/Applications/Google\\ Chrome.app/Contents/MacOS/Google\\ Chrome --version', { encoding: 'utf8' }).trim();
+                browserAvailable = true;
+            }
+            catch (e) {
+                try {
+                    // Try Chromium
+                    browserVersion = execSync('chromium --version', { encoding: 'utf8' }).trim();
+                    browserAvailable = true;
+                }
+                catch (e2) {
+                    try {
+                        // Try system Chrome
+                        browserVersion = execSync('google-chrome --version', { encoding: 'utf8' }).trim();
+                        browserAvailable = true;
+                    }
+                    catch (e3) {
+                        // Check if Puppeteer executable exists
+                        if (process.env.PUPPETEER_EXECUTABLE_PATH) {
+                            browserVersion = 'Puppeteer Browser';
+                            browserAvailable = true;
+                        }
+                    }
+                }
+            }
+        }
+        catch (e) {
+            // Browser detection failed - but this is not critical for scraping
+            browserVersion = 'Detection failed (scraping may still work)';
+            browserAvailable = false;
+        }
+        // Only add browser error if it's critical
+        if (!browserAvailable && !process.env.PUPPETEER_EXECUTABLE_PATH) {
+            errors.push('No browser found - install Chrome or set PUPPETEER_EXECUTABLE_PATH');
+            status = status === 'healthy' ? 'degraded' : status;
+        }
+        let diskAvailable = 0;
+        let diskPercentage = 0;
+        try {
+            const fs = require('fs');
+            const stats = fs.statSync('.');
+            diskAvailable = stats.size || 0;
+            diskPercentage = 0; // Simplified for demo
+        }
+        catch (e) {
+            errors.push('Disk check failed');
+        }
+        return {
+            status,
+            timestamp: new Date().toISOString(),
+            uptime: Date.now() - this.startTime,
+            memory: {
+                used: memoryUsage.heapUsed,
+                total: memoryUsage.heapTotal,
+                percentage: memoryPercentage
+            },
+            browser: {
+                available: browserAvailable,
+                version: browserVersion
+            },
+            disk: {
+                available: diskAvailable,
+                percentage: diskPercentage
+            },
+            errors
+        };
+    }
+    isHealthy() {
+        return this.errors.length === 0;
+    }
+    addError(error) {
+        this.errors.push(error);
+    }
+    clearErrors() {
+        this.errors = [];
+    }
+}
+exports.HealthChecker = HealthChecker;
+//# sourceMappingURL=health.js.map

package/dist/health.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"health.js","sourceRoot":"","sources":["../src/health.ts"],"names":[],"mappings":";;;AAqBA,MAAa,aAAa;IAA1B;QACU,cAAS,GAAW,IAAI,CAAC,GAAG,EAAE,CAAC;QAC/B,WAAM,GAAa,EAAE,CAAC;IAwGhC,CAAC;IAtGC,KAAK,CAAC,WAAW;QACf,MAAM,MAAM,GAAa,EAAE,CAAC;QAC5B,IAAI,MAAM,GAAyC,SAAS,CAAC;QAE7D,eAAe;QACf,MAAM,WAAW,GAAG,OAAO,CAAC,WAAW,EAAE,CAAC;QAC1C,MAAM,gBAAgB,GAAG,CAAC,WAAW,CAAC,QAAQ,GAAG,WAAW,CAAC,SAAS,CAAC,GAAG,GAAG,CAAC;QAE9E,IAAI,gBAAgB,GAAG,EAAE,EAAE,CAAC;YAC1B,MAAM,CAAC,IAAI,CAAC,mBAAmB,CAAC,CAAC;YACjC,MAAM,GAAG,WAAW,CAAC;QACvB,CAAC;aAAM,IAAI,gBAAgB,GAAG,EAAE,EAAE,CAAC;YACjC,MAAM,CAAC,IAAI,CAAC,uBAAuB,CAAC,CAAC;YACrC,MAAM,GAAG,UAAU,CAAC;QACtB,CAAC;QAED,gBAAgB;QAChB,IAAI,gBAAgB,GAAG,KAAK,CAAC;QAC7B,IAAI,cAAkC,CAAC;QAEvC,IAAI,CAAC;YACH,MAAM,EAAE,QAAQ,EAAE,GAAG,OAAO,CAAC,eAAe,CAAC,CAAC;YAE9C,0CAA0C;YAC1C,IAAI,CAAC;gBACH,sBAAsB;gBACtB,cAAc,GAAG,QAAQ,CAAC,4EAA4E,EAAE,EAAE,QAAQ,EAAE,MAAM,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC;gBACrI,gBAAgB,GAAG,IAAI,CAAC;YAC1B,CAAC;YAAC,OAAO,CAAC,EAAE,CAAC;gBACX,IAAI,CAAC;oBACH,eAAe;oBACf,cAAc,GAAG,QAAQ,CAAC,oBAAoB,EAAE,EAAE,QAAQ,EAAE,MAAM,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC;oBAC7E,gBAAgB,GAAG,IAAI,CAAC;gBAC1B,CAAC;gBAAC,OAAO,EAAE,EAAE,CAAC;oBACZ,IAAI,CAAC;wBACH,oBAAoB;wBACpB,cAAc,GAAG,QAAQ,CAAC,yBAAyB,EAAE,EAAE,QAAQ,EAAE,MAAM,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC;wBAClF,gBAAgB,GAAG,IAAI,CAAC;oBAC1B,CAAC;oBAAC,OAAO,EAAE,EAAE,CAAC;wBACZ,uCAAuC;wBACvC,IAAI,OAAO,CAAC,GAAG,CAAC,yBAAyB,EAAE,CAAC;4BAC1C,cAAc,GAAG,mBAAmB,CAAC;4BACrC,gBAAgB,GAAG,IAAI,CAAC;wBAC1B,CAAC;oBACH,CAAC;gBACH,CAAC;YACH,CAAC;QACH,CAAC;QAAC,OAAO,CAAC,EAAE,CAAC;YACX,mEAAmE;YACnE,cAAc,GAAG,4CAA4C,CAAC;YAC9D,gBAAgB,GAAG,KAAK,CAAC;QAC3B,CAAC;QAED,0CAA0C;QAC1C,IAAI,CAAC,gBAAgB,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,yBAAyB,EAAE,CAAC;YAChE,MAAM,CAAC,IAAI,CAAC,oEAAoE,CAAC,CAAC;YAClF,MAAM,GAAG,MAAM,KAAK,SAAS,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC,MAAM,CAAC;QACtD,CAAC;QACD,IAAI,aAAa,GAAG,CAAC,CAAC;QACtB,IAAI,cAAc,GAAG,CAAC,CAAC;QAEvB,IAAI,CAAC;YACH,MAAM,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;YACzB,MAAM,KAAK,GAAG,EAAE,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC;YAC/B,aAAa,GAAG,KAAK,CAAC,IAAI,IAAI,CAAC,CAAC;YAChC,cAAc,GAAG,CAAC,CAAC,CAAC,sBAAsB;QAC5C,CAAC;QAAC,OAAO,CAAC,EAAE,CAAC;YACX,MAAM,CAAC,IAAI,CAAC,mBAAmB,CAAC,CAAC;QACnC,CAAC;QAED,OAAO;YACL,MAAM;YACN,SAAS,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;YACnC,MAAM,EAAE,IAAI,CAAC,GAAG,EAAE,GAAG,IAAI,CAAC,SAAS;YACnC,MAAM,EAAE;gBACN,IAAI,EAAE,WAAW,CAAC,QAAQ;gBAC1B,KAAK,EAAE,WAAW,CAAC,SAAS;gBAC5B,UAAU,EAAE,gBAAgB;aAC7B;YACD,OAAO,EAAE;gBACP,SAAS,EAAE,gBAAgB;gBAC3B,OAAO,EAAE,cAAc;aACxB;YACD,IAAI,EAAE;gBACJ,SAAS,EAAE,aAAa;gBACxB,UAAU,EAAE,cAAc;aAC3B;YACD,MAAM;SACP,CAAC;IACJ,CAAC;IAED,SAAS;QACP,OAAO,IAAI,CAAC,MAAM,CAAC,MAAM,KAAK,CAAC,CAAC;IAClC,CAAC;IAED,QAAQ,CAAC,KAAa;QACpB,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IAC1B,CAAC;IAED,WAAW;QACT,IAAI,CAAC,MAAM,GAAG,EAAE,CAAC;IACnB,CAAC;CACF;AA1GD,sCA0GC"}

package/dist/index.d.ts

@@ -0,0 +1,101 @@
+import { Page } from 'puppeteer';
+import { InstagramPostData, MediaData } from './types';
+import { FastAuthManager, LoginCredentials } from './auth-fast';
+import { PluginManager, Plugin, ScrapingOptions, WorkflowTask } from './plugins';
+export * from './types';
+export * from './auth-fast';
+export * from './plugins';
+export * from './metrics';
+export * from './health';
+export * from './platforms';
+/**
+ * Executes predefined workflows for platform interaction automation
+ * @class WorkflowExecutor
+ */
+export declare class WorkflowExecutor {
+    /**
+     * Pauses execution for specified milliseconds
+     */
+    private sleep;
+    /**
+     * Executes a workflow from JSON file or array
+     */
+    executeWorkflow(page: Page, workflowOrPath: string | WorkflowTask[]): Promise<void>;
+}
+/**
+ * Main media scraper class with multi-platform support
+ * @class MediaScraper
+ */
+export declare class MediaScraper {
+    private workflowExecutor;
+    private metricsCollector;
+    private healthChecker;
+    private pluginManager;
+    private authManager;
+    private currentScrapeId;
+    private stepCallback;
+    /**
+     * Creates a new MediaScraper instance
+     */
+    constructor();
+    /**
+     * Register a plugin (platform or utility)
+     */
+    use(plugin: Plugin): void;
+    /**
+     * Login to Instagram
+     */
+    login(credentials: LoginCredentials): Promise<boolean>;
+    /**
+     * Logout and clear session
+     */
+    logout(): Promise<void>;
+    /**
+     * Universal scrape method - automatically detects platform
+     */
+    scrape(url: string, options?: ScrapingOptions): Promise<MediaData>;
+    /**
+     * Scrape Instagram post (backward compatible method)
+     * @deprecated Use scrape() instead for multi-platform support
+     */
+    scrapePost(url: string, options?: ScrapingOptions): Promise<InstagramPostData>;
+    private saveToFile;
+    /**
+     * Set callback for step tracking
+     */
+    setStepCallback(callback: (stepData: any) => void): void;
+    /**
+     * Gets current metrics
+     */
+    getMetrics(): import("./metrics").ScrapingMetrics;
+    /**
+     * Gets health status
+     */
+    getHealth(): Promise<import("./health").HealthStatus>;
+    /**
+     * Gets Prometheus-formatted metrics
+     */
+    getPrometheusMetrics(): string;
+    /**
+     * Get plugin manager for advanced plugin operations
+     */
+    getPluginManager(): PluginManager;
+    /**
+     * Get auth manager for advanced auth operations
+     */
+    getAuthManager(): FastAuthManager;
+    refreshSession(): Promise<boolean>;
+    /**
+     * Pauses execution for specified milliseconds
+     */
+    private sleep;
+}
+/**
+ * Backward compatibility alias
+ * @deprecated Use MediaScraper instead
+ */
+export declare class InstaScraper extends MediaScraper {
+    constructor();
+}
+export { log } from './logger';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAKA,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAGjC,OAAO,EAAE,iBAAiB,EAAE,SAAS,EAAgB,MAAM,SAAS,CAAC;AACrE,OAAO,EAAE,eAAe,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAC;AAChE,OAAO,EAAE,aAAa,EAAE,MAAM,EAAkB,eAAe,EAAE,YAAY,EAAE,MAAM,WAAW,CAAC;AASjG,cAAc,SAAS,CAAC;AACxB,cAAc,aAAa,CAAC;AAC5B,cAAc,WAAW,CAAC;AAC1B,cAAc,WAAW,CAAC;AAC1B,cAAc,UAAU,CAAC;AACzB,cAAc,aAAa,CAAC;AAE5B;;;GAGG;AACH,qBAAa,gBAAgB;IAC3B;;OAEG;IACH,OAAO,CAAC,KAAK;IAIb;;OAEG;IACG,eAAe,CAAC,IAAI,EAAE,IAAI,EAAE,cAAc,EAAE,MAAM,GAAG,YAAY,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC;CA+H1F;AAED;;;GAGG;AACH,qBAAa,YAAY;IACvB,OAAO,CAAC,gBAAgB,CAAmB;IAC3C,OAAO,CAAC,gBAAgB,CAAmB;IAC3C,OAAO,CAAC,aAAa,CAAgB;IACrC,OAAO,CAAC,aAAa,CAAgB;IACrC,OAAO,CAAC,WAAW,CAAkB;IACrC,OAAO,CAAC,eAAe,CAAuB;IAC9C,OAAO,CAAC,YAAY,CAA0C;IAE9D;;OAEG;;IAYH;;OAEG;IACH,GAAG,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI;IAIzB;;OAEG;IACG,KAAK,CAAC,WAAW,EAAE,gBAAgB,GAAG,OAAO,CAAC,OAAO,CAAC;IAqB5D;;OAEG;IACG,MAAM,IAAI,OAAO,CAAC,IAAI,CAAC;IAI7B;;OAEG;IACG,MAAM,CAAC,GAAG,EAAE,MAAM,EAAE,OAAO,GAAE,eAAoB,GAAG,OAAO,CAAC,SAAS,CAAC;IAmK5E;;;OAGG;IACG,UAAU,CAAC,GAAG,EAAE,MAAM,EAAE,OAAO,GAAE,eAAoB,GAAG,OAAO,CAAC,iBAAiB,CAAC;YAiB1E,UAAU;IAaxB;;OAEG;IACH,eAAe,CAAC,QAAQ,EAAE,CAAC,QAAQ,EAAE,GAAG,KAAK,IAAI;IAIjD;;OAEG;IACH,UAAU;IAIV;;OAEG;IACG,SAAS;IAIf;;OAEG;IACH,oBAAoB,IAAI,MAAM;IAI9B;;OAEG;IACH,gBAAgB,IAAI,aAAa;IAIjC;;OAEG;IACH,cAAc,IAAI,eAAe;IAI3B,cAAc,IAAI,OAAO,CAAC,OAAO,CAAC;IAuBxC;;OAEG;IACH,OAAO,CAAC,KAAK;CAGd;AAED;;;GAGG;AACH,qBAAa,YAAa,SAAQ,YAAY;;CAK7C;AAGD,OAAO,EAAE,GAAG,EAAE,MAAM,UAAU,CAAC"}