nodejs-insta-private-api-mqt 1.3.84 → 1.3.86

package/dist/dist/core/state.d.ts

@@ -0,0 +1,605 @@
+declare const fs: any;
+declare const path: any;
+declare const util: any;
+declare const CookieJar: any;
+declare const Chance: any;
+declare const Constants: any;
+declare const EventEmitter: any;
+declare const SESSION_FILE: any;
+declare const SESSION_BACKUP: any;
+declare class State {
+    constructor();
+    get appVersion(): any;
+    get appVersionCode(): any;
+    get signatureKey(): any;
+    get signatureVersion(): any;
+    get fbAnalyticsApplicationId(): any;
+    get bloksVersionId(): any;
+    get clientSessionId(): any;
+    get pigeonSessionId(): any;
+    get appUserAgent(): string;
+    get iosUserAgent(): string;
+    get iosResolution(): any;
+    get packageName(): any;
+    extractCookie(key: any): any;
+    extractCookieValue(key: any): any;
+    get cookieCsrfToken(): any;
+    get cookieUserId(): any;
+    set cookieUserId(val: any);
+    get cookieUsername(): any;
+    hasValidAuthorization(): boolean;
+    updateAuthorization(): void;
+    refreshAuthorization(newAuthToken: any): boolean;
+    serializeCookieJar(): Promise<any>;
+    deserializeCookieJar(serialized: any): Promise<void>;
+    /**
+     * Return a plain-object ready to be JSON.stringify-ed and saved to disk.
+     */
+    serialize(): Promise<{
+        constants: any;
+        cookies: any;
+        deviceString: any;
+        deviceId: any;
+        uuid: any;
+        phoneId: any;
+        adid: any;
+        build: any;
+        authorization: any;
+        igWWWClaim: any;
+        igURur: any;
+        mid: any;
+        country: any;
+        countryCode: any;
+        locale: any;
+        passwordEncryptionKeyId: any;
+        passwordEncryptionPubKey: any;
+        language: any;
+        timezoneOffset: any;
+        connectionTypeHeader: any;
+        capabilitiesHeader: any;
+        requestId: any;
+        traySessionId: any;
+        userId: any;
+    }>;
+    /**
+     * Merge data from a saved session into this State instance.
+     * Safe: does NOT overwrite prototype getters (like appVersion).
+     */
+    deserialize(state: any): Promise<void>;
+    saveSessionToFile(filePath?: any, backupPath?: any): Promise<boolean>;
+    loadSessionFromFile(filePath?: any, backupPath?: any): Promise<boolean>;
+    saveSession(): Promise<boolean>;
+    loadSession(): Promise<boolean>;
+    generateDevice(seed: any): void;
+    regenerateDevice(seed?: string): void;
+    /**
+     * Set a custom device to emulate when connecting to Instagram.
+     * This allows you to choose which phone model Instagram sees.
+     *
+     * @param {Object} deviceConfig - The device configuration
+     * @param {string} deviceConfig.manufacturer - Phone manufacturer (e.g., 'samsung', 'huawei', 'google')
+     * @param {string} deviceConfig.model - Phone model code (e.g., 'SM-S928B' for Samsung S25 Ultra)
+     * @param {string} deviceConfig.device - Device codename (e.g., 'e3q' for S25 Ultra)
+     * @param {string} deviceConfig.androidVersion - Android version (e.g., '15')
+     * @param {number} deviceConfig.androidApiLevel - Android API level (e.g., 35 for Android 15)
+     * @param {string} deviceConfig.resolution - Screen resolution (e.g., '1440x3120')
+     * @param {string} deviceConfig.dpi - Screen density (e.g., '505dpi')
+     * @param {string} deviceConfig.chipset - Chipset name (e.g., 'qcom')
+     * @param {string} deviceConfig.build - Build number (optional)
+     *
+     * @example
+     * // Samsung Galaxy S25 Ultra
+     * state.setCustomDevice({
+     *   manufacturer: 'samsung',
+     *   model: 'SM-S928B',
+     *   device: 'e3q',
+     *   androidVersion: '15',
+     *   androidApiLevel: 35,
+     *   resolution: '1440x3120',
+     *   dpi: '505dpi',
+     *   chipset: 'qcom'
+     * });
+     */
+    setCustomDevice(deviceConfig: any): any;
+    /**
+     * Get a list of popular preset devices that can be used with setCustomDevice()
+     * @returns {Object} Object containing preset device configurations
+     */
+    getPresetDevices(): {
+        'Samsung Galaxy S25 Ultra': {
+            manufacturer: string;
+            model: string;
+            device: string;
+            androidVersion: string;
+            androidApiLevel: number;
+            resolution: string;
+            dpi: string;
+            chipset: string;
+            build: string;
+        };
+        'Samsung Galaxy S24 Ultra': {
+            manufacturer: string;
+            model: string;
+            device: string;
+            androidVersion: string;
+            androidApiLevel: number;
+            resolution: string;
+            dpi: string;
+            chipset: string;
+            build: string;
+        };
+        'Samsung Galaxy S23 Ultra': {
+            manufacturer: string;
+            model: string;
+            device: string;
+            androidVersion: string;
+            androidApiLevel: number;
+            resolution: string;
+            dpi: string;
+            chipset: string;
+            build: string;
+        };
+        'Samsung Galaxy Z Fold 5': {
+            manufacturer: string;
+            model: string;
+            device: string;
+            androidVersion: string;
+            androidApiLevel: number;
+            resolution: string;
+            dpi: string;
+            chipset: string;
+            build: string;
+        };
+        'Huawei P60 Pro': {
+            manufacturer: string;
+            model: string;
+            device: string;
+            androidVersion: string;
+            androidApiLevel: number;
+            resolution: string;
+            dpi: string;
+            chipset: string;
+            build: string;
+        };
+        'Huawei Mate 60 Pro': {
+            manufacturer: string;
+            model: string;
+            device: string;
+            androidVersion: string;
+            androidApiLevel: number;
+            resolution: string;
+            dpi: string;
+            chipset: string;
+            build: string;
+        };
+        'Google Pixel 8 Pro': {
+            manufacturer: string;
+            model: string;
+            device: string;
+            androidVersion: string;
+            androidApiLevel: number;
+            resolution: string;
+            dpi: string;
+            chipset: string;
+            build: string;
+        };
+        'Google Pixel 9 Pro': {
+            manufacturer: string;
+            model: string;
+            device: string;
+            androidVersion: string;
+            androidApiLevel: number;
+            resolution: string;
+            dpi: string;
+            chipset: string;
+            build: string;
+        };
+        'OnePlus 12': {
+            manufacturer: string;
+            model: string;
+            device: string;
+            androidVersion: string;
+            androidApiLevel: number;
+            resolution: string;
+            dpi: string;
+            chipset: string;
+            build: string;
+        };
+        'Xiaomi 14 Ultra': {
+            manufacturer: string;
+            model: string;
+            device: string;
+            androidVersion: string;
+            androidApiLevel: number;
+            resolution: string;
+            dpi: string;
+            chipset: string;
+            build: string;
+        };
+        'Xiaomi Redmi Note 13 Pro': {
+            manufacturer: string;
+            model: string;
+            device: string;
+            androidVersion: string;
+            androidApiLevel: number;
+            resolution: string;
+            dpi: string;
+            chipset: string;
+            build: string;
+        };
+        'OPPO Find X7 Ultra': {
+            manufacturer: string;
+            model: string;
+            device: string;
+            androidVersion: string;
+            androidApiLevel: number;
+            resolution: string;
+            dpi: string;
+            chipset: string;
+            build: string;
+            platform: string;
+        };
+        'iPhone 16 Pro Max': {
+            platform: string;
+            iosDeviceModel: string;
+            iosDeviceName: string;
+            iosVersion: string;
+            resolution: string;
+            chipset: string;
+        };
+        'iPhone 16 Pro': {
+            platform: string;
+            iosDeviceModel: string;
+            iosDeviceName: string;
+            iosVersion: string;
+            resolution: string;
+            chipset: string;
+        };
+        'iPhone 16 Plus': {
+            platform: string;
+            iosDeviceModel: string;
+            iosDeviceName: string;
+            iosVersion: string;
+            resolution: string;
+            chipset: string;
+        };
+        'iPhone 16': {
+            platform: string;
+            iosDeviceModel: string;
+            iosDeviceName: string;
+            iosVersion: string;
+            resolution: string;
+            chipset: string;
+        };
+        'iPhone 15 Pro Max': {
+            platform: string;
+            iosDeviceModel: string;
+            iosDeviceName: string;
+            iosVersion: string;
+            resolution: string;
+            chipset: string;
+        };
+        'iPhone 15 Pro': {
+            platform: string;
+            iosDeviceModel: string;
+            iosDeviceName: string;
+            iosVersion: string;
+            resolution: string;
+            chipset: string;
+        };
+        'iPhone 15 Plus': {
+            platform: string;
+            iosDeviceModel: string;
+            iosDeviceName: string;
+            iosVersion: string;
+            resolution: string;
+            chipset: string;
+        };
+        'iPhone 15': {
+            platform: string;
+            iosDeviceModel: string;
+            iosDeviceName: string;
+            iosVersion: string;
+            resolution: string;
+            chipset: string;
+        };
+        'iPhone 14 Pro Max': {
+            platform: string;
+            iosDeviceModel: string;
+            iosDeviceName: string;
+            iosVersion: string;
+            resolution: string;
+            chipset: string;
+        };
+        'iPhone 14 Pro': {
+            platform: string;
+            iosDeviceModel: string;
+            iosDeviceName: string;
+            iosVersion: string;
+            resolution: string;
+            chipset: string;
+        };
+        'iPhone 14 Plus': {
+            platform: string;
+            iosDeviceModel: string;
+            iosDeviceName: string;
+            iosVersion: string;
+            resolution: string;
+            chipset: string;
+        };
+        'iPhone 14': {
+            platform: string;
+            iosDeviceModel: string;
+            iosDeviceName: string;
+            iosVersion: string;
+            resolution: string;
+            chipset: string;
+        };
+        'iPhone 13 Pro Max': {
+            platform: string;
+            iosDeviceModel: string;
+            iosDeviceName: string;
+            iosVersion: string;
+            resolution: string;
+            chipset: string;
+        };
+        'iPhone 13 Pro': {
+            platform: string;
+            iosDeviceModel: string;
+            iosDeviceName: string;
+            iosVersion: string;
+            resolution: string;
+            chipset: string;
+        };
+        'iPhone 13': {
+            platform: string;
+            iosDeviceModel: string;
+            iosDeviceName: string;
+            iosVersion: string;
+            resolution: string;
+            chipset: string;
+        };
+        'iPhone 12 Pro Max': {
+            platform: string;
+            iosDeviceModel: string;
+            iosDeviceName: string;
+            iosVersion: string;
+            resolution: string;
+            chipset: string;
+        };
+        'iPhone 12 Pro': {
+            platform: string;
+            iosDeviceModel: string;
+            iosDeviceName: string;
+            iosVersion: string;
+            resolution: string;
+            chipset: string;
+        };
+        'iPhone 12': {
+            platform: string;
+            iosDeviceModel: string;
+            iosDeviceName: string;
+            iosVersion: string;
+            resolution: string;
+            chipset: string;
+        };
+        'iPad Pro 12.9 (6th gen)': {
+            platform: string;
+            iosDeviceModel: string;
+            iosDeviceName: string;
+            iosVersion: string;
+            resolution: string;
+            chipset: string;
+        };
+        'iPad Pro 11 (4th gen)': {
+            platform: string;
+            iosDeviceModel: string;
+            iosDeviceName: string;
+            iosVersion: string;
+            resolution: string;
+            chipset: string;
+        };
+        'iPad Air (5th gen)': {
+            platform: string;
+            iosDeviceModel: string;
+            iosDeviceName: string;
+            iosVersion: string;
+            resolution: string;
+            chipset: string;
+        };
+    };
+    /**
+     * Get only iOS device presets
+     * @returns {Object} Object containing iOS device configurations
+     */
+    getIOSDevices(): {};
+    /**
+     * Get only Android device presets
+     * @returns {Object} Object containing Android device configurations
+     */
+    getAndroidDevices(): {};
+    /**
+     * Set an iOS device to emulate
+     * @param {Object} iosConfig - iOS device configuration
+     * @returns {string} The iOS User-Agent
+     */
+    setIOSDevice(iosConfig: any): string;
+    /**
+     * Switch to iOS platform with a preset device
+     * @param {string} presetName - Name of the iOS preset (e.g., 'iPhone 16 Pro Max')
+     * @returns {string|null} iOS User-Agent if successful, null if preset not found
+     */
+    useIOSDevice(presetName: any): string;
+    /**
+     * Switch to Android platform with a preset device
+     * @param {string} presetName - Name of the Android preset (e.g., 'Samsung Galaxy S25 Ultra')
+     * @returns {string|null} Device string if successful, null if preset not found
+     */
+    useAndroidDevice(presetName: any): any;
+    /**
+     * Switch platform between iOS and Android
+     * @param {string} targetPlatform - 'ios' or 'android'
+     * @param {string} devicePreset - Optional device preset name
+     */
+    switchPlatform(targetPlatform: any, devicePreset?: any): any;
+    /**
+     * Get current platform info
+     * @returns {Object} Current platform and device information
+     */
+    getPlatformInfo(): {
+        iosDeviceModel: any;
+        iosDeviceName: any;
+        iosVersion: any;
+        iosAppVersion: any;
+        platform: any;
+        userAgent: string;
+        packageName: any;
+        deviceId: any;
+    } | {
+        deviceString: any;
+        build: any;
+        platform: any;
+        userAgent: string;
+        packageName: any;
+        deviceId: any;
+    };
+    /**
+     * List all available device presets grouped by platform
+     * @returns {Object} Devices grouped by platform
+     */
+    listAllDevices(): {
+        android: string[];
+        ios: string[];
+    };
+    /**
+     * Quick method to set a device from presets by name
+     * @param {string} presetName - Name of the preset (e.g., 'Samsung Galaxy S25 Ultra')
+     * @returns {string|null} Device string if successful, null if preset not found
+     *
+     * @example
+     * state.usePresetDevice('Samsung Galaxy S25 Ultra');
+     * state.usePresetDevice('Huawei P60 Pro');
+     * state.usePresetDevice('Google Pixel 8 Pro');
+     */
+    usePresetDevice(presetName: any): any;
+    /**
+     * Get the current device info being emulated
+     * @returns {Object} Current device configuration
+     */
+    getCurrentDeviceInfo(): {
+        deviceString: any;
+        deviceId: any;
+        uuid: any;
+        phoneId: any;
+        adid: any;
+        build: any;
+        userAgent: string;
+    };
+    generateTemporaryGuid(seed: any, lifetime: any): any;
+    clearCookies(): void;
+    listCookies(): any[];
+    logStateSummary(): void;
+    /**
+     * Subscribe to internal state events (non-invasive).
+     * Events emitted:
+     *  - 'session_saved' => (filePath)
+     *  - 'session_save_failed' => (err)
+     *  - 'session_loaded' => (filePath)
+     *  - 'session_load_failed' => (err)
+     *  - 'cookies_cleared'
+     *  - 'device_regenerated'
+     *  - 'session_file_changed' => (eventType, filename)
+     */
+    on(event: any, listener: any): void;
+    off(event: any, listener: any): void;
+    once(event: any, listener: any): void;
+    /**
+     * Atomic save with retries and backup rotation.
+     * Attempts to write to a temp file, rename into place (atomic on most OSes),
+     * and maintain up to `_maxBackupCopies` rotated backups.
+     */
+    safeSaveSessionToFile(filePath?: any, backupPath?: any, opts?: {}): Promise<boolean>;
+    _rotateAndWriteBackup(filePath: any, backupPath: any, maxBackups: any): Promise<void>;
+    /**
+     * Safe load with retries. Emits session_loaded/session_load_failed events.
+     */
+    safeLoadSessionFromFile(filePath?: any, backupPath?: any, opts?: {}): Promise<boolean>;
+    /**
+     * Validate minimal session integrity: ensure cookie jar has expected cookies or parsed authorization
+     */
+    validateSession(): boolean;
+    /**
+     * Merge cookies from another serialized jar or CookieJar instance into current cookieJar.
+     * Accepts: serialized object/string (as used by serializeCookieJar) or CookieJar instance.
+     */
+    mergeCookieJarFrom(other: any): Promise<boolean>;
+    /**
+     * Export a minimal session object (useful for sending to remote storage or IPC).
+     */
+    exportMinimalSession(): Promise<{
+        deviceId: any;
+        deviceString: any;
+        uuid: any;
+        phoneId: any;
+        adid: any;
+        build: any;
+        authorization: any;
+        cookies: any;
+    }>;
+    /**
+     * Import minimal session object (merges cookies if present and sets fields).
+     */
+    importMinimalSession(minObj?: {}): Promise<boolean>;
+    /**
+     * Set proxy URL (persists only in-memory; use saveSessionToFile to persist).
+     */
+    setProxyUrl(url: any): any;
+    clearProxyUrl(): boolean;
+    /**
+     * Mark checkpoint metadata object (stores arbitrary checkpoint info).
+     */
+    markCheckpoint(obj: any): boolean;
+    clearCheckpoint(): boolean;
+    /**
+     * Ensure session file has safe permissions (owner read/write only)
+     */
+    ensureFilePermissions(filePath?: any): boolean;
+    /**
+     * Watch the session file for external changes and emit 'session_file_changed'.
+     * Note: uses fs.watchFile which is more portable; call stopWatchingSessionFile() to stop.
+     */
+    watchSessionFile(filePath?: any, intervalMs?: number): boolean;
+    stopWatchingSessionFile(filePath?: any): boolean;
+    /**
+     * If device looks missing or invalid, regenerate device fields.
+     * Condition: deviceId missing or doesn't start with expected prefix.
+     */
+    refreshDeviceIfMissingOrOld(seed?: string): boolean;
+    /**
+     * Refresh authorization state from cookies (useful after merging cookies).
+     */
+    refreshAuthFromCookies(): boolean;
+    /**
+     * Safe load helper that tries to load, validate, and optionally attempt fallback to backup copies.
+     * If `validate` is true, will call validateSession() and throw if invalid.
+     */
+    loadAndValidateSession(filePath?: any, backupPath?: any, opts?: {}): Promise<boolean>;
+    _tryLoadRotatedBackups(backupPath: any, opts?: {}): Promise<boolean>;
+    /**
+     * Clear all session data (cookies + auth + device optional).
+     * If `preserveDevice` is true, device fields are kept.
+     */
+    clearAllSession(preserveDevice?: boolean): boolean;
+    /**
+     * Quick helper: get value of cookie if exists, or null (non-throwing).
+     */
+    getCookieValueSafe(key: any): any;
+    /**
+     * Convenience: set default save/retry options
+     */
+    setSaveRetryOptions({ retries, delayMs, maxBackups }?: {}): {
+        retries: any;
+        delayMs: any;
+        maxBackups: any;
+    };
+}