jumpy-lion 0.1.0 → 0.1.2

package/dist/fingerprinting/fingerprint-injector.d.ts

@@ -0,0 +1,157 @@
+/**
+ * Enhanced CDP Fingerprint Injector for 2025
+ *
+ * This module provides advanced fingerprint spoofing and anti-detection capabilities
+ * specifically designed to bypass hardcore fingerprinting techniques used in 2025.
+ *
+ * Key Features:
+ *
+ * 1. **WebGPU Fingerprinting Protection**:
+ *    - Spoofs GPU adapter information and capabilities
+ *    - Fakes GPU uptime to appear as if the GPU has been running for 24-72 hours
+ *    - Intercepts timestamp queries to prevent timing-based detection
+ *
+ * 2. **Platform Consistency (1:1 Fingerprinting)**:
+ *    - Ensures all browser properties match the specified platform (Win32, MacIntel, Linux)
+ *    - Synchronizes navigator properties, screen metrics, and WebGL/WebGPU values
+ *    - Platform-specific GPU configurations for realistic fingerprints
+ *
+ * 3. **Runtime.enable Bypass**:
+ *    - Prevents CDP detection through console.log(Error) technique
+ *    - Intercepts and blocks Runtime.enable calls
+ *    - Modifies Error stack traces to hide automation
+ *
+ * 4. **Advanced Canvas Protection**:
+ *    - Adds controlled noise to canvas operations
+ *    - Protects against both 2D and WebGL canvas fingerprinting
+ *    - Includes font measurement variations
+ *
+ * 5. **WebRTC IP Leak Prevention**:
+ *    - Filters STUN servers to prevent IP leaks
+ *    - Provides fake but consistent device IDs
+ *    - Modifies ICE candidates and statistics
+ *
+ * 6. **Audio Context Spoofing**:
+ *    - Adds noise to audio processing to prevent fingerprinting
+ *    - Works with both AudioContext and OfflineAudioContext
+ *
+ * 7. **Client Rect Variations**:
+ *    - Adds small variations to getBoundingClientRect results
+ *    - Makes automation harder to detect through DOM measurements
+ *
+ * 8. **Mouse Movement Humanization**:
+ *    - Generates bezier curve movements instead of straight lines
+ *    - Adds random variations to mouse paths
+ *
+ * Usage:
+ * ```typescript
+ * await CdpFingerprintInjector.injectFingerprint(page, fingerprint, {
+ *     enableAdvancedStealth: true,
+ *     bypassRuntimeEnable: true,
+ *     platform: 'Win32', // Spoof as Windows for better evasion on Apify Linux
+ *     spoofWebGL: true,
+ *     spoofAudioContext: true,
+ *     spoofClientRects: true,
+ *     humanizeInteractions: true,
+ *     spoofFonts: true, // New: Hide Linux-specific fonts
+ *     spoofPerformance: true, // New: Windows-like timing characteristics
+ *     spoofLocale: true, // New: Consistent Windows locale formatting
+ *     useFingerprintDefaults: true // Use fingerprint-generator Windows values
+ * });
+ * ```
+ */
+import type { BrowserFingerprintWithHeaders } from 'fingerprint-generator';
+import type CdpPage from "../page.js";
+interface Viewport {
+    width: number;
+    height: number;
+    deviceScaleFactor: number;
+    mobile: boolean;
+}
+/**
+ * Humanization options for simulating realistic user behavior
+ * All options are disabled by default for performance
+ */
+interface HumanizationOptions {
+    /** Enable mouse movement humanization (Bezier curves, natural movement). Default: false */
+    mouse?: boolean;
+    /** Enable keyboard humanization (realistic typing delays). Default: false */
+    keyboard?: boolean;
+    /** Enable scroll humanization (natural physics, momentum). Default: false */
+    scroll?: boolean;
+}
+interface AttachOptions {
+    debug?: boolean;
+    timezone?: string;
+    proxyUrl?: string;
+    detectTimezone?: boolean;
+    viewport?: Viewport;
+    enableAdvancedStealth?: boolean;
+    bypassRuntimeEnable?: boolean;
+    /** @deprecated Use humanization.mouse instead */
+    humanizeInteractions?: boolean;
+    spoofWebGL?: boolean;
+    spoofAudioContext?: boolean;
+    spoofClientRects?: boolean;
+    maskAutomationFlags?: boolean;
+    platform?: 'Win32' | 'MacIntel' | 'Linux x86_64';
+    spoofFonts?: boolean;
+    spoofPerformance?: boolean;
+    spoofLocale?: boolean;
+    useExperimentalFingerprints?: boolean;
+    useFingerprintDefaults?: boolean;
+    /** Enable CDP detection bypass (iframe, eval, sourceURL hiding) */
+    bypassCDPDetection?: boolean;
+    /** Enable storage API consistency (quota, IndexedDB, CacheStorage) */
+    spoofStorage?: boolean;
+    /** Enable timing consistency (Date.now, performance.now alignment) */
+    spoofTiming?: boolean;
+    /** Enable DataDome-specific bypass (JS challenges, proof-of-work) */
+    enableDataDomeBypass?: boolean;
+    /**
+     * Alias for enableDataDomeBypass - enables all DataDome-specific protections
+     * When true, injects enhanced bypass early in the script chain
+     */
+    bypassDatadome?: boolean;
+    /**
+     * Humanization options for simulating realistic user behavior.
+     * All options are disabled by default for performance.
+     * Enable specific options to simulate human-like interactions.
+     */
+    humanization?: HumanizationOptions;
+}
+export declare class CdpFingerprintInjector {
+    private page;
+    constructor(page: CdpPage);
+    /**
+     * Get recommended settings for Apify platform
+     * These settings are optimized for running headful Chrome on Apify (Linux)
+     * but spoofed to appear as Windows for better anti-bot evasion.
+     *
+     * Note: Humanization is disabled by default for performance.
+     * Use getDataDomeSettings() or enable humanization manually for anti-bot sites.
+     */
+    static getApifyRecommendedSettings(): AttachOptions;
+    /**
+     * Get settings specifically optimized for DataDome-protected sites.
+     * Enables all humanization features for maximum anti-bot evasion.
+     */
+    static getDataDomeSettings(): AttachOptions;
+    static injectFingerprint(page: CdpPage, fingerprint: BrowserFingerprintWithHeaders, options?: AttachOptions): Promise<void>;
+    private setViewport;
+    private setExtraHTTPHeaders;
+    private getTimezoneFromIp;
+    private setTimezoneOverride;
+    private injectStealthProtections;
+    /**
+     * Create a debug script that logs fingerprint override status to the console
+     */
+    private createDebugScript;
+    /**
+     * Extract relevant data from fingerprint for overrides
+     */
+    private extractFingerprintData;
+    attachToPage(browserFingerprintWithHeaders: BrowserFingerprintWithHeaders, options?: AttachOptions): Promise<void>;
+}
+export {};
+//# sourceMappingURL=fingerprint-injector.d.ts.map

package/dist/fingerprinting/fingerprint-injector.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"fingerprint-injector.d.ts","sourceRoot":"","sources":["../../src/fingerprinting/fingerprint-injector.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6DG;AAGH,OAAO,KAAK,EAAE,6BAA6B,EAAE,MAAM,uBAAuB,CAAC;AAG3E,OAAO,KAAK,OAAO,MAAM,YAAY,CAAC;AAoCtC,UAAU,QAAQ;IACd,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IACf,iBAAiB,EAAE,MAAM,CAAC;IAC1B,MAAM,EAAE,OAAO,CAAC;CACnB;AAED;;;GAGG;AACH,UAAU,mBAAmB;IACzB,2FAA2F;IAC3F,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,6EAA6E;IAC7E,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,6EAA6E;IAC7E,MAAM,CAAC,EAAE,OAAO,CAAC;CACpB;AAED,UAAU,aAAa;IACnB,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,cAAc,CAAC,EAAE,OAAO,CAAC;IACzB,QAAQ,CAAC,EAAE,QAAQ,CAAC;IAEpB,qBAAqB,CAAC,EAAE,OAAO,CAAC;IAChC,mBAAmB,CAAC,EAAE,OAAO,CAAC;IAC9B,iDAAiD;IACjD,oBAAoB,CAAC,EAAE,OAAO,CAAC;IAC/B,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,iBAAiB,CAAC,EAAE,OAAO,CAAC;IAC5B,gBAAgB,CAAC,EAAE,OAAO,CAAC;IAC3B,mBAAmB,CAAC,EAAE,OAAO,CAAC;IAC9B,QAAQ,CAAC,EAAE,OAAO,GAAG,UAAU,GAAG,cAAc,CAAC;IAEjD,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,gBAAgB,CAAC,EAAE,OAAO,CAAC;IAC3B,WAAW,CAAC,EAAE,OAAO,CAAC;IAEtB,2BAA2B,CAAC,EAAE,OAAO,CAAC;IAEtC,sBAAsB,CAAC,EAAE,OAAO,CAAC;IAEjC,mEAAmE;IACnE,kBAAkB,CAAC,EAAE,OAAO,CAAC;IAC7B,sEAAsE;IACtE,YAAY,CAAC,EAAE,OAAO,CAAC;IACvB,sEAAsE;IACtE,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,qEAAqE;IACrE,oBAAoB,CAAC,EAAE,OAAO,CAAC;IAC/B;;;OAGG;IACH,cAAc,CAAC,EAAE,OAAO,CAAC;IACzB;;;;OAIG;IACH,YAAY,CAAC,EAAE,mBAAmB,CAAC;CACtC;AAMD,qBAAa,sBAAsB;IAC/B,OAAO,CAAC,IAAI,CAAU;gBAEV,IAAI,EAAE,OAAO;IAIzB;;;;;;;OAOG;IACH,MAAM,CAAC,2BAA2B,IAAI,aAAa;IAmCnD;;;OAGG;IACH,MAAM,CAAC,mBAAmB,IAAI,aAAa;WA0B9B,iBAAiB,CAC1B,IAAI,EAAE,OAAO,EACb,WAAW,EAAE,6BAA6B,EAC1C,OAAO,CAAC,EAAE,aAAa,GACxB,OAAO,CAAC,IAAI,CAAC;YAKF,WAAW;YAyDX,mBAAmB;YAInB,iBAAiB;YAcjB,mBAAmB;YAMnB,wBAAwB;IAKtC;;OAEG;IACH,OAAO,CAAC,iBAAiB;IAyGzB;;OAEG;IACH,OAAO,CAAC,sBAAsB;IA8DjB,YAAY,CACrB,6BAA6B,EAAE,6BAA6B,EAC5D,OAAO,CAAC,EAAE,aAAa,GACxB,OAAO,CAAC,IAAI,CAAC;CA+RnB"}