jumpy-lion 0.1.6-beta.0 → 0.1.6-beta.3

package/dist/browser-process/anti-detect-browser.js

@@ -0,0 +1,142 @@
+/**
+ * anti-detect-browser.ts — Detect whether the running browser is the custom anti-detect build
+ *
+ * Used by fingerprint-injector.ts to decide which JS override modules to skip
+ * (those already handled natively by C++ patches in the anti-detect browser).
+ */
+import { spawnSync } from 'child_process';
+import { existsSync } from 'fs';
+import path from 'path';
+// ─── Detection ────────────────────────────────────────────────────────────────
+/**
+ * Check if the given executable is the anti-detect browser build.
+ *
+ * Detection strategy:
+ *   1. Check for a .anti-detect-version marker file alongside the binary
+ *   2. Check the --version output for the "AntiDetect" build marker
+ *   3. Fall back to false (standard Chrome behavior)
+ *
+ * @param executablePath - Path to the Chrome/Chromium executable
+ */
+export async function isAntiDetectBrowser(executablePath) {
+    if (!executablePath || !existsSync(executablePath)) {
+        return false;
+    }
+    // Strategy 1: Check for marker file alongside the binary
+    // The build process writes a .anti-detect-version file next to the binary
+    const binaryDir = path.dirname(executablePath);
+    const markerFile = path.join(binaryDir, '.anti-detect-version');
+    if (existsSync(markerFile)) {
+        return true;
+    }
+    // Also check the .browser/ directory root
+    const browserDirMarker = path.join(binaryDir, '..', '.anti-detect-version');
+    if (existsSync(browserDirMarker)) {
+        return true;
+    }
+    // Strategy 2: Check --version output for build marker
+    // The anti-detect build adds "AntiDetect/X.Y" to the version string
+    try {
+        const result = spawnSync(executablePath, ['--version'], {
+            encoding: 'utf8',
+            timeout: 5000,
+        });
+        const output = `${result.stdout ?? ''} ${result.stderr ?? ''}`;
+        if (output.includes('AntiDetect')) {
+            return true;
+        }
+    }
+    catch {
+        // Ignore — binary may not support --version in this way
+    }
+    return false;
+}
+/**
+ * Synchronous version for use during browser launch (before async context).
+ */
+export function isAntiDetectBrowserSync(executablePath) {
+    if (!executablePath || !existsSync(executablePath)) {
+        return false;
+    }
+    // Walk up to 5 ancestors looking for the .anti-detect-version marker.
+    // macOS packages the binary at `.../Chromium.app/Contents/MacOS/Chromium`,
+    // and the build script can install the marker next to the `.app`, inside
+    // Contents/, or inside Contents/MacOS/ — so a single depth check is
+    // brittle. 5 levels covers every current build layout.
+    let dir = path.dirname(executablePath);
+    for (let i = 0; i < 5; i++) {
+        if (existsSync(path.join(dir, '.anti-detect-version'))) {
+            return true;
+        }
+        const parent = path.dirname(dir);
+        if (parent === dir)
+            break; // hit filesystem root
+        dir = parent;
+    }
+    try {
+        const result = spawnSync(executablePath, ['--version'], {
+            encoding: 'utf8',
+            timeout: 5000,
+        });
+        const output = `${result.stdout ?? ''} ${result.stderr ?? ''}`;
+        return output.includes('AntiDetect');
+    }
+    catch {
+        return false;
+    }
+}
+// ─── Capability map ───────────────────────────────────────────────────────────
+/**
+ * When useNativeStealth=true, the fingerprint-injector skips the ENTIRE JS override
+ * pipeline — no fingerprint scripts are injected at all. This set exists for
+ * reference/documentation and for any external callers that check individual module
+ * names via shouldSkipJsOverride().
+ *
+ * Primary mechanism: fingerprint-injector.ts early-returns when nativeStealth=true,
+ * before any of these modules are built or injected.
+ *
+ * C++ patch coverage (browser/patches/):
+ *   0001  navigator.webdriver = false
+ *   0002  navigator.platform
+ *   0003  UA-CH (navigator.userAgentData + Sec-CH-UA-* headers)
+ *   0004  WebGL UNMASKED_VENDOR/RENDERER
+ *   0005  CDP automation artifact removal
+ *   0006  screen.width/height/availWidth/availHeight/colorDepth
+ *   0007  Page-level fingerprint seed (cross-process consistency)
+ *   0008  FingerprintConfig CLI ingestion
+ *   0009  Canvas document noise factors (seeded)
+ *   0010  AudioContext noise (seeded)
+ *   0011  getBoundingClientRect / getClientRects noise
+ *   0012  WebGPU adapter info
+ *   0013  queryLocalFonts() → empty
+ *   0015  Runtime.enable console side effects + sourceURL leaks
+ *   cromite-override/0001  hardwareConcurrency / deviceMemory
+ *   cromite-override/0002  canvas pixel shuffle (seeded)
+ *   Cromite built-in        font allowlist, performance.now() clamping
+ */
+export const NATIVE_STEALTH_SKIPS = new Set([
+    'canvas-protection', // patches 0009, co/0002
+    'webgl-spoofing', // patch 0004
+    'audio-spoofing', // patch 0010
+    'client-rect-spoofing', // patch 0011
+    'font-spoofing', // Cromite built-in + patch 0013
+    'performance-spoofing', // Cromite built-in (perf.now clamping)
+    'ua-ch', // patch 0003
+    'platform-consistency', // patches 0002, 0006
+    'runtime-enable-bypass', // patches 0005, 0015
+    'cdp-detection-bypass', // patches 0001, 0005, 0015
+    'webgpu-spoofing', // patch 0012
+    'storage-consistency', // no C++ equivalent — skipped for simplicity
+    'timing-consistency', // Cromite perf.now clamping covers the main vector
+    'locale-spoofing', // Cromite ICU config covers locale
+    'stealth-utils', // no JS overrides needed — C++ handles at source
+    'prototype-integrity', // no JS overrides needed — C++ patches are native
+]);
+/**
+ * Returns true if a given override module should be skipped when using the
+ * anti-detect browser (fully handled by C++ patches).
+ */
+export function shouldSkipJsOverride(moduleName) {
+    return NATIVE_STEALTH_SKIPS.has(moduleName);
+}
+//# sourceMappingURL=anti-detect-browser.js.map

package/dist/browser-process/anti-detect-browser.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"anti-detect-browser.js","sourceRoot":"","sources":["../../src/browser-process/anti-detect-browser.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,SAAS,EAAE,MAAM,eAAe,CAAC;AAC1C,OAAO,EAAE,UAAU,EAAE,MAAM,IAAI,CAAC;AAChC,OAAO,IAAI,MAAM,MAAM,CAAC;AAExB,iFAAiF;AAEjF;;;;;;;;;GASG;AACH,MAAM,CAAC,KAAK,UAAU,mBAAmB,CAAC,cAAsB;IAC5D,IAAI,CAAC,cAAc,IAAI,CAAC,UAAU,CAAC,cAAc,CAAC,EAAE,CAAC;QACjD,OAAO,KAAK,CAAC;IACjB,CAAC;IAED,yDAAyD;IACzD,0EAA0E;IAC1E,MAAM,SAAS,GAAG,IAAI,CAAC,OAAO,CAAC,cAAc,CAAC,CAAC;IAC/C,MAAM,UAAU,GAAG,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,sBAAsB,CAAC,CAAC;IAChE,IAAI,UAAU,CAAC,UAAU,CAAC,EAAE,CAAC;QACzB,OAAO,IAAI,CAAC;IAChB,CAAC;IAED,0CAA0C;IAC1C,MAAM,gBAAgB,GAAG,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,IAAI,EAAE,sBAAsB,CAAC,CAAC;IAC5E,IAAI,UAAU,CAAC,gBAAgB,CAAC,EAAE,CAAC;QAC/B,OAAO,IAAI,CAAC;IAChB,CAAC;IAED,sDAAsD;IACtD,oEAAoE;IACpE,IAAI,CAAC;QACD,MAAM,MAAM,GAAG,SAAS,CAAC,cAAc,EAAE,CAAC,WAAW,CAAC,EAAE;YACpD,QAAQ,EAAE,MAAM;YAChB,OAAO,EAAE,IAAI;SAChB,CAAC,CAAC;QACH,MAAM,MAAM,GAAG,GAAG,MAAM,CAAC,MAAM,IAAI,EAAE,IAAI,MAAM,CAAC,MAAM,IAAI,EAAE,EAAE,CAAC;QAC/D,IAAI,MAAM,CAAC,QAAQ,CAAC,YAAY,CAAC,EAAE,CAAC;YAChC,OAAO,IAAI,CAAC;QAChB,CAAC;IACL,CAAC;IAAC,MAAM,CAAC;QACL,wDAAwD;IAC5D,CAAC;IAED,OAAO,KAAK,CAAC;AACjB,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,uBAAuB,CAAC,cAAsB;IAC1D,IAAI,CAAC,cAAc,IAAI,CAAC,UAAU,CAAC,cAAc,CAAC,EAAE,CAAC;QACjD,OAAO,KAAK,CAAC;IACjB,CAAC;IAED,sEAAsE;IACtE,2EAA2E;IAC3E,yEAAyE;IACzE,oEAAoE;IACpE,uDAAuD;IACvD,IAAI,GAAG,GAAG,IAAI,CAAC,OAAO,CAAC,cAAc,CAAC,CAAC;IACvC,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC;QACzB,IAAI,UAAU,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,sBAAsB,CAAC,CAAC,EAAE,CAAC;YACrD,OAAO,IAAI,CAAC;QAChB,CAAC;QACD,MAAM,MAAM,GAAG,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;QACjC,IAAI,MAAM,KAAK,GAAG;YAAE,MAAM,CAAC,sBAAsB;QACjD,GAAG,GAAG,MAAM,CAAC;IACjB,CAAC;IAED,IAAI,CAAC;QACD,MAAM,MAAM,GAAG,SAAS,CAAC,cAAc,EAAE,CAAC,WAAW,CAAC,EAAE;YACpD,QAAQ,EAAE,MAAM;YAChB,OAAO,EAAE,IAAI;SAChB,CAAC,CAAC;QACH,MAAM,MAAM,GAAG,GAAG,MAAM,CAAC,MAAM,IAAI,EAAE,IAAI,MAAM,CAAC,MAAM,IAAI,EAAE,EAAE,CAAC;QAC/D,OAAO,MAAM,CAAC,QAAQ,CAAC,YAAY,CAAC,CAAC;IACzC,CAAC;IAAC,MAAM,CAAC;QACL,OAAO,KAAK,CAAC;IACjB,CAAC;AACL,CAAC;AAED,iFAAiF;AAEjF;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AACH,MAAM,CAAC,MAAM,oBAAoB,GAAG,IAAI,GAAG,CAAC;IACxC,mBAAmB,EAAQ,wBAAwB;IACnD,gBAAgB,EAAW,aAAa;IACxC,gBAAgB,EAAW,aAAa;IACxC,sBAAsB,EAAK,aAAa;IACxC,eAAe,EAAY,gCAAgC;IAC3D,sBAAsB,EAAK,uCAAuC;IAClE,OAAO,EAAoB,aAAa;IACxC,sBAAsB,EAAK,qBAAqB;IAChD,uBAAuB,EAAI,qBAAqB;IAChD,sBAAsB,EAAK,2BAA2B;IACtD,iBAAiB,EAAU,aAAa;IACxC,qBAAqB,EAAM,6CAA6C;IACxE,oBAAoB,EAAO,mDAAmD;IAC9E,iBAAiB,EAAU,mCAAmC;IAC9D,eAAe,EAAY,iDAAiD;IAC5E,qBAAqB,EAAM,kDAAkD;CAChF,CAAC,CAAC;AAEH;;;GAGG;AACH,MAAM,UAAU,oBAAoB,CAAC,UAAkB;IACnD,OAAO,oBAAoB,CAAC,GAAG,CAAC,UAAU,CAAC,CAAC;AAChD,CAAC"}

package/dist/browser-process/anti-detect-config.d.ts

@@ -0,0 +1,102 @@
+/**
+ * anti-detect-config.ts — Generate and manage FingerprintConfig JSON for the anti-detect browser
+ *
+ * Called by browser.ts before launching the browser when useNativeStealth is enabled.
+ * Translates the fingerprint-generator BrowserFingerprintWithHeaders output into
+ * the --fingerprint-config JSON schema consumed by the C++ FingerprintConfig class.
+ */
+import type { BrowserFingerprintWithHeaders } from 'fingerprint-generator';
+import type { ResolvedLocale } from '../fingerprinting/locale-resolver.js';
+export interface FingerprintConfigUaBrand {
+    brand: string;
+    version: string;
+    full_version?: string;
+}
+export interface FingerprintConfigBattery {
+    charging: boolean;
+    level: number;
+    chargingTime: number;
+    dischargingTime: number;
+}
+export interface FingerprintConfigJson {
+    version: 1;
+    /** 64-bit seed (number, as JSON doesn't support BigInt) */
+    seed: number;
+    /** Primary brand name for Sec-CH-UA fallback (e.g. "Google Chrome") */
+    brandName: string;
+    /** IANA timezone id, e.g. "Asia/Seoul". Consumed by C++ patches + CDP override. */
+    timezone?: string;
+    navigator: {
+        platform: string;
+        /** BCP-47 primary locale, e.g. "ko-KR". Drives navigator.language + ICU default. */
+        language?: string;
+        /** Comma-separated accept-languages, e.g. "en-US,en;q=0.9" */
+        languages?: string;
+        hardwareConcurrency: number;
+        deviceMemory: number;
+        userAgent: string;
+        userAgentData?: {
+            brands: FingerprintConfigUaBrand[];
+            mobile: boolean;
+            platform: string;
+            platformVersion: string;
+            architecture: string;
+            bitness: string;
+            model: string;
+            uaFullVersion: string;
+            fullVersionList: FingerprintConfigUaBrand[];
+        };
+    };
+    webgl: {
+        vendor: string;
+        renderer: string;
+    };
+    screen: {
+        width: number;
+        height: number;
+        availWidth: number;
+        availHeight: number;
+        colorDepth: number;
+        pixelRatio: number;
+    };
+    fonts?: {
+        allowlist: string;
+    };
+    battery: FingerprintConfigBattery;
+    noise: {
+        canvas: boolean;
+        audio: boolean;
+        rects: boolean;
+        measureText: boolean;
+    };
+    timing: {
+        performanceNowResolutionMs: number;
+    };
+    webgpu?: {
+        vendor: string;
+        architecture: string;
+        device: string;
+        description: string;
+    };
+}
+/**
+ * Generate a FingerprintConfig JSON object from fingerprint-generator output.
+ *
+ * @param fingerprint - BrowserFingerprintWithHeaders from fingerprint-generator
+ * @param sessionId - Session identifier used to derive the seed (proxy session ID, etc.)
+ * @param resolvedLocale - Pre-resolved locale/languages/timezone triple. When provided,
+ *   these values win over anything derived from fingerprint-generator headers so that a
+ *   user-supplied `locale: 'ko-KR'` coherently propagates to every locale surface
+ *   (Accept-Language, navigator.language, Intl defaults, timezone).
+ */
+export declare function generateFingerprintConfig(fingerprint: BrowserFingerprintWithHeaders, sessionId?: string, resolvedLocale?: ResolvedLocale): FingerprintConfigJson;
+/**
+ * Write the fingerprint config to a temp file and return the path.
+ * The caller is responsible for deleting the file after the browser exits.
+ */
+export declare function writeTempFingerprintConfig(config: FingerprintConfigJson): Promise<string>;
+/**
+ * Delete the temp config file after the browser has exited.
+ */
+export declare function cleanupTempFingerprintConfig(filePath: string): Promise<void>;
+//# sourceMappingURL=anti-detect-config.d.ts.map

package/dist/browser-process/anti-detect-config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"anti-detect-config.d.ts","sourceRoot":"","sources":["../../src/browser-process/anti-detect-config.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAOH,OAAO,KAAK,EAAE,6BAA6B,EAAE,MAAM,uBAAuB,CAAC;AAE3E,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,sCAAsC,CAAC;AAI3E,MAAM,WAAW,wBAAwB;IACrC,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,MAAM,CAAC;IAChB,YAAY,CAAC,EAAE,MAAM,CAAC;CACzB;AAED,MAAM,WAAW,wBAAwB;IACrC,QAAQ,EAAE,OAAO,CAAC;IAClB,KAAK,EAAE,MAAM,CAAC;IACd,YAAY,EAAE,MAAM,CAAC;IACrB,eAAe,EAAE,MAAM,CAAC;CAC3B;AAED,MAAM,WAAW,qBAAqB;IAClC,OAAO,EAAE,CAAC,CAAC;IACX,2DAA2D;IAC3D,IAAI,EAAE,MAAM,CAAC;IACb,uEAAuE;IACvE,SAAS,EAAE,MAAM,CAAC;IAClB,mFAAmF;IACnF,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE;QACP,QAAQ,EAAE,MAAM,CAAC;QACjB,oFAAoF;QACpF,QAAQ,CAAC,EAAE,MAAM,CAAC;QAClB,8DAA8D;QAC9D,SAAS,CAAC,EAAE,MAAM,CAAC;QACnB,mBAAmB,EAAE,MAAM,CAAC;QAC5B,YAAY,EAAE,MAAM,CAAC;QACrB,SAAS,EAAE,MAAM,CAAC;QAClB,aAAa,CAAC,EAAE;YACZ,MAAM,EAAE,wBAAwB,EAAE,CAAC;YACnC,MAAM,EAAE,OAAO,CAAC;YAChB,QAAQ,EAAE,MAAM,CAAC;YACjB,eAAe,EAAE,MAAM,CAAC;YACxB,YAAY,EAAE,MAAM,CAAC;YACrB,OAAO,EAAE,MAAM,CAAC;YAChB,KAAK,EAAE,MAAM,CAAC;YACd,aAAa,EAAE,MAAM,CAAC;YACtB,eAAe,EAAE,wBAAwB,EAAE,CAAC;SAC/C,CAAC;KACL,CAAC;IACF,KAAK,EAAE;QACH,MAAM,EAAE,MAAM,CAAC;QACf,QAAQ,EAAE,MAAM,CAAC;KACpB,CAAC;IACF,MAAM,EAAE;QACJ,KAAK,EAAE,MAAM,CAAC;QACd,MAAM,EAAE,MAAM,CAAC;QACf,UAAU,EAAE,MAAM,CAAC;QACnB,WAAW,EAAE,MAAM,CAAC;QACpB,UAAU,EAAE,MAAM,CAAC;QACnB,UAAU,EAAE,MAAM,CAAC;KACtB,CAAC;IACF,KAAK,CAAC,EAAE;QACJ,SAAS,EAAE,MAAM,CAAC;KACrB,CAAC;IACF,OAAO,EAAE,wBAAwB,CAAC;IAClC,KAAK,EAAE;QACH,MAAM,EAAE,OAAO,CAAC;QAChB,KAAK,EAAE,OAAO,CAAC;QACf,KAAK,EAAE,OAAO,CAAC;QACf,WAAW,EAAE,OAAO,CAAC;KACxB,CAAC;IACF,MAAM,EAAE;QACJ,0BAA0B,EAAE,MAAM,CAAC;KACtC,CAAC;IACF,MAAM,CAAC,EAAE;QACL,MAAM,EAAE,MAAM,CAAC;QACf,YAAY,EAAE,MAAM,CAAC;QACrB,MAAM,EAAE,MAAM,CAAC;QACf,WAAW,EAAE,MAAM,CAAC;KACvB,CAAC;CACL;AAID;;;;;;;;;GASG;AACH,wBAAgB,yBAAyB,CACrC,WAAW,EAAE,6BAA6B,EAC1C,SAAS,CAAC,EAAE,MAAM,EAClB,cAAc,CAAC,EAAE,cAAc,GAChC,qBAAqB,CA8KvB;AAED;;;GAGG;AACH,wBAAsB,0BAA0B,CAAC,MAAM,EAAE,qBAAqB,GAAG,OAAO,CAAC,MAAM,CAAC,CAM/F;AAED;;GAEG;AACH,wBAAsB,4BAA4B,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAMlF"}

package/dist/browser-process/anti-detect-config.js

@@ -0,0 +1,328 @@
+/**
+ * anti-detect-config.ts — Generate and manage FingerprintConfig JSON for the anti-detect browser
+ *
+ * Called by browser.ts before launching the browser when useNativeStealth is enabled.
+ * Translates the fingerprint-generator BrowserFingerprintWithHeaders output into
+ * the --fingerprint-config JSON schema consumed by the C++ FingerprintConfig class.
+ */
+import fs from 'fs/promises';
+import os from 'os';
+import path from 'path';
+import crypto from 'crypto';
+// ─── Generation ───────────────────────────────────────────────────────────────
+/**
+ * Generate a FingerprintConfig JSON object from fingerprint-generator output.
+ *
+ * @param fingerprint - BrowserFingerprintWithHeaders from fingerprint-generator
+ * @param sessionId - Session identifier used to derive the seed (proxy session ID, etc.)
+ * @param resolvedLocale - Pre-resolved locale/languages/timezone triple. When provided,
+ *   these values win over anything derived from fingerprint-generator headers so that a
+ *   user-supplied `locale: 'ko-KR'` coherently propagates to every locale surface
+ *   (Accept-Language, navigator.language, Intl defaults, timezone).
+ */
+export function generateFingerprintConfig(fingerprint, sessionId, resolvedLocale) {
+    const fp = fingerprint.fingerprint;
+    const headers = fingerprint.headers;
+    // Seed derivation:
+    //   - With a sessionId (proxy session tag) → deterministic: same session ID
+    //     always yields the same seed so cookies/IP/canvas/audio stay coherent
+    //     across requests within the session. This is the common production path.
+    //   - Without a sessionId (harvest runs, ad-hoc launches) → per-process
+    //     random. Without this, the fingerprint-generator macOS/Chrome pool
+    //     emits exactly one UA across many runs, so sessionId-less calls would
+    //     all produce the same seed and therefore the same canvas/audio noise
+    //     hash across every session — a cross-session correlation signal.
+    const seedSource = sessionId
+        ? `${sessionId}|${fp.navigator?.userAgent ?? ''}`
+        : `${crypto.randomBytes(16).toString('hex')}|${fp.navigator?.userAgent ?? ''}`;
+    const seedHash = crypto.createHash('sha256').update(seedSource).digest();
+    // Take first 8 bytes as a number (JavaScript number precision is sufficient for 53-bit ints)
+    const seed = seedHash.readUInt32BE(0) * 0x100000000 + seedHash.readUInt32BE(4);
+    // Navigator platform
+    // navigator.platform (legacy) and navigator.userAgentData.platform (UA-CH)
+    // are DIFFERENT APIs with DIFFERENT values:
+    //   navigator.platform                  → 'MacIntel' | 'Win32' | 'Linux x86_64'
+    //   navigator.userAgentData.platform    → 'macOS'    | 'Windows' | 'Linux'
+    // Previously this code collapsed both to the UA-CH form, which made
+    // navigator.platform report "macOS" in both the main frame and workers —
+    // that is a Chrome invariant violation (real Chrome always returns
+    // "MacIntel" from navigator.platform regardless of architecture).
+    //
+    // Keep the two values separate:
+    //   platform     → legacy form, stored in config.navigator.platform
+    //   uaChPlatform → UA-CH form, stored in config.navigator.userAgentData.platform
+    //                  and used for battery/platform-specific heuristics below.
+    const platform = fp.navigator?.platform ?? 'Win32';
+    const legacyToUaCH = {
+        'Win32': 'Windows',
+        'MacIntel': 'macOS',
+        'Linux x86_64': 'Linux',
+    };
+    const uaChPlatform = legacyToUaCH[platform] ?? platform;
+    // UA-CH brands from fingerprint
+    const uaData = fp.navigator?.userAgentData;
+    const brands = uaData?.brands ?? [];
+    const fullVersionList = uaData?.fullVersionList ?? brands;
+    const uaBrands = brands.map((b, i) => ({
+        brand: b.brand,
+        version: b.version,
+        full_version: fullVersionList[i]?.version ?? b.version,
+    }));
+    // WebGL from fingerprint. Real Chrome 147 on Apple Silicon leaks the
+    // exact chip variant verbatim ("ANGLE (Apple, ANGLE Metal Renderer:
+    // Apple M4 Pro, Unspecified Version)"), confirmed against a user's
+    // shipping Chrome + CreepJS verdict. Matching that behavior is safer than
+    // sanitizing to a generic M1 — anti-bot ML models expect the raw string,
+    // and the hardware leak is not a Chrome-level invariant violation.
+    const videoCard = fp.videoCard;
+    const webglVendor = videoCard?.vendor ?? 'Google Inc. (NVIDIA)';
+    const webglRenderer = videoCard?.renderer
+        ?? 'ANGLE (NVIDIA, NVIDIA GeForce RTX 3060 Direct3D11 vs_5_0 ps_5_0, D3D11)';
+    // Screen
+    const screen = fp.screen;
+    // User agent from headers (most accurate source)
+    const userAgent = headers['user-agent']
+        ?? fp.navigator?.userAgent
+        ?? '';
+    // Accept-language: prefer the pre-resolved triple (so a user-supplied locale wins)
+    // and fall back to fingerprint headers when no resolution happened.
+    //
+    // Important: the C++ FingerprintConfig reader splits this string on commas and
+    // feeds each entry verbatim into `navigator.languages` (the JS array). Real Chrome's
+    // navigator.languages never carries q-values — those are HTTP Accept-Language
+    // semantics only. If we leave `"en-US,en;q=0.9"` in the config, the JS array leaks
+    // `"en;q=0.9"` which is an instant detectable anomaly. Strip q-values here so the
+    // config field is the clean list; the HTTP header flows from the same field and
+    // will also be q-less, which is a valid (if less common) real-browser pattern.
+    const rawAcceptLanguage = resolvedLocale?.languages
+        ?? headers['accept-language']
+        ?? headers['Accept-Language'];
+    const acceptLanguage = rawAcceptLanguage
+        ? rawAcceptLanguage.split(',').map((l) => l.split(';')[0].trim()).filter(Boolean).join(',')
+        : undefined;
+    const navLanguage = resolvedLocale?.locale;
+    const timezone = resolvedLocale?.timezone;
+    // Primary brand name — extract from UA-CH brands or derive from User-Agent
+    const brandName = extractBrandName(uaBrands, userAgent);
+    // Battery — generate realistic values based on target platform.
+    // Uses UA-CH platform names ('Windows'|'macOS'|'Linux') for the desktop/mac checks.
+    const battery = generateBatteryConfig(uaChPlatform, seed);
+    // deviceMemory: spec requires the value be one of {0.25, 0.5, 1, 2, 4, 8}
+    // (https://www.w3.org/TR/device-memory/#sec-device-memory-js-api). Exposing
+    // anything outside this set — in particular the real 32 on a 32 GB machine —
+    // is an immediate "bot" signal for any vendor that checks.
+    const rawDeviceMemory = fp.navigator?.deviceMemory ?? 8;
+    const deviceMemory = clampDeviceMemoryToSpecBuckets(rawDeviceMemory);
+    // colorDepth: real Chrome privacy-reduces to 24 regardless of display HDR
+    // capability. 30 is the raw macOS value that leaks through when we don't cap.
+    const rawColorDepth = screen?.colorDepth ?? 24;
+    const colorDepth = Math.min(rawColorDepth, 24);
+    const config = {
+        version: 1,
+        seed,
+        brandName,
+        ...(timezone && { timezone }),
+        navigator: {
+            platform, // legacy form: 'MacIntel' | 'Win32' | 'Linux x86_64'
+            ...(navLanguage && { language: navLanguage }),
+            ...(acceptLanguage && { languages: acceptLanguage }),
+            hardwareConcurrency: fp.navigator?.hardwareConcurrency ?? 8,
+            deviceMemory,
+            userAgent,
+            ...(uaBrands.length > 0 && {
+                userAgentData: {
+                    brands: uaBrands,
+                    mobile: uaData?.mobile ?? false,
+                    platform: uaData?.platform ?? uaChPlatform,
+                    platformVersion: uaData?.platformVersion ?? '15.0.0',
+                    architecture: uaData?.architecture ?? 'x86',
+                    bitness: uaData?.bitness ?? '64',
+                    model: uaData?.model ?? '',
+                    uaFullVersion: uaData?.uaFullVersion ?? extractFullVersion(userAgent),
+                    fullVersionList: uaBrands,
+                },
+            }),
+        },
+        webgl: {
+            vendor: webglVendor,
+            renderer: webglRenderer,
+        },
+        screen: {
+            width: screen?.width ?? 1920,
+            height: screen?.height ?? 1080,
+            availWidth: screen?.availWidth ?? screen?.width ?? 1920,
+            availHeight: screen?.availHeight ?? (screen?.height ? screen.height - 40 : 1040),
+            colorDepth,
+            pixelRatio: screen?.devicePixelRatio ?? 1,
+        },
+        battery,
+        noise: {
+            canvas: true,
+            audio: true,
+            rects: true,
+            measureText: true,
+        },
+        timing: {
+            performanceNowResolutionMs: 1,
+        },
+    };
+    // WebGPU — from explicit webgpu field on fingerprint (non-Apify profiles), or
+    // derived from WebGL vendor as a fallback (Apify fingerprints have no webgpu data).
+    const webgpuData = fp.webgpu;
+    const derivedWebGPUVendor = webgpuData?.vendor ?? deriveWebGPUVendorFromWebGL(webglVendor);
+    if (derivedWebGPUVendor) {
+        config.webgpu = {
+            vendor: derivedWebGPUVendor,
+            architecture: webgpuData?.architecture ?? '',
+            device: webgpuData?.device ?? '',
+            description: webgpuData?.description ?? '',
+        };
+    }
+    return config;
+}
+/**
+ * Write the fingerprint config to a temp file and return the path.
+ * The caller is responsible for deleting the file after the browser exits.
+ */
+export async function writeTempFingerprintConfig(config) {
+    const tmpDir = os.tmpdir();
+    const fileName = `fp-${Date.now()}-${Math.random().toString(36).slice(2)}.json`;
+    const filePath = path.join(tmpDir, fileName);
+    await fs.writeFile(filePath, JSON.stringify(config, null, 2), 'utf8');
+    return filePath;
+}
+/**
+ * Delete the temp config file after the browser has exited.
+ */
+export async function cleanupTempFingerprintConfig(filePath) {
+    try {
+        await fs.unlink(filePath);
+    }
+    catch {
+        // Non-fatal — temp file will be cleaned by OS eventually
+    }
+}
+// ─── Helpers ──────────────────────────────────────────────────────────────────
+/**
+ * Clamp a raw device-memory-in-GB value to the buckets required by the
+ * Device Memory API spec (https://www.w3.org/TR/device-memory/). Chrome
+ * always quantizes to {0.25, 0.5, 1, 2, 4, 8}. Returning anything outside
+ * this set — especially the real value on >8 GB machines — is an instant
+ * anti-bot detection signal.
+ *
+ * Rule (per spec): the returned value is the closest bucket that is less
+ * than or equal to the actual value, capped at 8.
+ */
+function clampDeviceMemoryToSpecBuckets(raw) {
+    const buckets = [0.25, 0.5, 1, 2, 4, 8];
+    if (!Number.isFinite(raw) || raw <= 0)
+        return 8;
+    if (raw >= 8)
+        return 8;
+    let bucket = buckets[0];
+    for (const b of buckets) {
+        if (b <= raw)
+            bucket = b;
+    }
+    return bucket;
+}
+/** Extract full Chrome version string from User-Agent (e.g. "Chrome/136.0.7103.0") */
+function extractFullVersion(userAgent) {
+    const match = userAgent.match(/Chrome\/(\d+\.\d+\.\d+\.\d+)/);
+    return match?.[1] ?? '136.0.0.0';
+}
+/**
+ * Extract primary brand name from UA-CH brands or User-Agent string.
+ * Returns the non-Chromium, non-greased brand (e.g. "Google Chrome").
+ */
+function extractBrandName(brands, userAgent) {
+    for (const b of brands) {
+        if (b.brand !== 'Chromium' && !b.brand.startsWith('Not')) {
+            return b.brand;
+        }
+    }
+    // Fallback: derive from User-Agent header
+    if (userAgent.includes('Edg/'))
+        return 'Microsoft Edge';
+    if (userAgent.includes('OPR/'))
+        return 'Opera';
+    if (userAgent.includes('Brave'))
+        return 'Brave';
+    return 'Google Chrome';
+}
+/**
+ * Generate realistic battery values based on platform and seed.
+ * Desktop machines are typically plugged in (charging=true, level=1.0).
+ * Uses seed for deterministic but varied values across sessions.
+ */
+function generateBatteryConfig(platform, seed) {
+    // Seeded PRNG for deterministic variation
+    const rng = seedRng(seed);
+    const isDesktop = platform === 'Windows' || platform === 'Linux';
+    const isMac = platform === 'macOS';
+    if (isDesktop) {
+        // Desktop: almost always plugged in, full battery
+        // ~90% chance fully charged, ~10% chance slightly below
+        if (rng() < 0.9) {
+            return { charging: true, level: 1.0, chargingTime: 0, dischargingTime: Infinity };
+        }
+        // Simulate charging desktop with near-full battery
+        const level = 0.85 + rng() * 0.14; // 0.85-0.99
+        return {
+            charging: true,
+            level: Math.round(level * 100) / 100,
+            chargingTime: Math.floor(rng() * 1800), // 0-30min remaining
+            dischargingTime: Infinity,
+        };
+    }
+    if (isMac) {
+        // MacBooks: ~70% plugged in, sometimes on battery
+        const charging = rng() < 0.7;
+        if (charging) {
+            const level = 0.6 + rng() * 0.4; // 0.60-1.0
+            return {
+                charging: true,
+                level: Math.round(level * 100) / 100,
+                chargingTime: level >= 1.0 ? 0 : Math.floor((1.0 - level) * 7200),
+                dischargingTime: Infinity,
+            };
+        }
+        const level = 0.3 + rng() * 0.65; // 0.30-0.95
+        return {
+            charging: false,
+            level: Math.round(level * 100) / 100,
+            chargingTime: Infinity,
+            dischargingTime: Math.floor(level * 14400), // proportional to level
+        };
+    }
+    // Default: plugged-in desktop
+    return { charging: true, level: 1.0, chargingTime: 0, dischargingTime: Infinity };
+}
+/** Simple seeded PRNG (mulberry32) returning [0, 1) */
+function seedRng(seed) {
+    let s = seed | 0;
+    return () => {
+        s = (s + 0x6D2B79F5) | 0;
+        let t = Math.imul(s ^ (s >>> 15), 1 | s);
+        t = (t + Math.imul(t ^ (t >>> 7), 61 | t)) ^ t;
+        return ((t ^ (t >>> 14)) >>> 0) / 4294967296;
+    };
+}
+/**
+ * Derive a WebGPU vendor string from the WebGL unmasked vendor string.
+ * Used as a fallback when no explicit webgpu profile data is available (Apify fingerprints).
+ * e.g. "Google Inc. (NVIDIA)" → "nvidia"
+ */
+function deriveWebGPUVendorFromWebGL(webglVendor) {
+    const v = webglVendor.toLowerCase();
+    if (v.includes('nvidia'))
+        return 'nvidia';
+    if (v.includes('amd') || v.includes('ati'))
+        return 'amd';
+    if (v.includes('intel'))
+        return 'intel';
+    if (v.includes('apple'))
+        return 'apple';
+    return '';
+}
+//# sourceMappingURL=anti-detect-config.js.map

package/dist/browser-process/anti-detect-config.js.map

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

package/dist/browser-process/browser.d.ts

@@ -1,4 +1,6 @@
 import { BrowserProcess } from './process.js';
+import { type FingerprintConfigJson } from './anti-detect-config.js';
+import type { ResolvedLocale } from '../fingerprinting/locale-resolver.js';
 /**
  * Humanization options for simulating realistic user behavior
  * All options are disabled by default for performance
@@ -20,6 +22,17 @@ export interface LaunchBrowserOptions {
     headless?: boolean;
     executablePath?: string;
     useExperimentalFingerprints?: boolean;
+    /**
+     * Use the native anti-detect browser (Cromite-based custom build) for
+     * fingerprint spoofing at the C++ level. When true and the anti-detect
+     * browser is installed (via postinstall.js), it will be used instead of
+     * system Chrome. JS-level overrides for C++-handled properties are skipped,
+     * reducing the injection bundle from ~150KB to ~40KB.
+     *
+     * Falls back silently to system Chrome if the anti-detect binary is not found.
+     * Default: false
+     */
+    useNativeStealth?: boolean;
     /** Whether to start the browser maximized and fullscreen. Default: true */
     maximizeWindow?: boolean;
     /** Enable all stealth arguments for anti-bot evasion. Default: true */
@@ -70,6 +83,19 @@ export interface LaunchBrowserOptions {
         /** Humanization options (all disabled by default) */
         humanization?: HumanizationOptions;
     };
+    /**
+     * Pre-generated FingerprintConfig JSON to pass via --fingerprint-config to the
+     * anti-detect browser. When provided, this overrides the static default_fingerprint.json
+     * so that each browser instance gets unique C++-level hardware fingerprints (GPU, screen,
+     * CPU count, device memory) derived from the real device profile.
+     */
+    fingerprintConfig?: FingerprintConfigJson;
+    /**
+     * Pre-resolved locale triple from `resolveLocale()`. Drives `--lang`,
+     * `--fingerprint-accept-language` (when native-stealth is active), and the LANG/LC_ALL
+     * env vars passed to the spawned Chrome process.
+     */
+    resolvedLocale?: ResolvedLocale;
 }
 export declare const launchBrowserWithNewProfile: (executablePath: string, options?: LaunchBrowserOptions) => Promise<BrowserProcess>;
 export declare const createTempUserDataDir: () => Promise<string>;

package/dist/browser-process/browser.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"browser.d.ts","sourceRoot":"","sources":["../../src/browser-process/browser.ts"],"names":[],"mappings":"AAQA,OAAO,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AAoD9C;;;GAGG;AACH,MAAM,WAAW,mBAAmB;IAChC,yDAAyD;IACzD,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,mDAAmD;IACnD,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,iDAAiD;IACjD,MAAM,CAAC,EAAE,OAAO,CAAC;CACpB;AAED,MAAM,WAAW,oBAAoB;IACjC,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAC5B,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,iBAAiB,CAAC,EAAE,OAAO,CAAC;IAC5B,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,2BAA2B,CAAC,EAAE,OAAO,CAAC;IACtC,2EAA2E;IAC3E,cAAc,CAAC,EAAE,OAAO,CAAC;IACzB,uEAAuE;IACvE,iBAAiB,CAAC,EAAE,OAAO,CAAC;IAC5B,+DAA+D;IAC/D,eAAe,CAAC,EAAE,OAAO,CAAC;IAC1B;;;OAGG;IACH,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB;;;OAGG;IACH,eAAe,CAAC,EAAE,OAAO,CAAC;IAC1B;;;OAGG;IACH,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAC5B,kFAAkF;IAClF,aAAa,CAAC,EAAE,KAAK,GAAG,WAAW,GAAG,QAAQ,CAAC;IAC/C;;;OAGG;IACH,sBAAsB,CAAC,EAAE,SAAS,GAAG,+BAA+B,GAAG,uCAAuC,GAAG,yBAAyB,CAAC;IAC3I,kBAAkB,CAAC,EAAE;QACjB,qBAAqB,CAAC,EAAE,OAAO,CAAC;QAChC,mBAAmB,CAAC,EAAE,OAAO,CAAC;QAC9B,UAAU,CAAC,EAAE,OAAO,CAAC;QACrB,iBAAiB,CAAC,EAAE,OAAO,CAAC;QAC5B,gBAAgB,CAAC,EAAE,OAAO,CAAC;QAC3B,mBAAmB,CAAC,EAAE,OAAO,CAAC;QAC9B,UAAU,CAAC,EAAE,OAAO,CAAC;QACrB,gBAAgB,CAAC,EAAE,OAAO,CAAC;QAC3B,WAAW,CAAC,EAAE,OAAO,CAAC;QACtB,2BAA2B,CAAC,EAAE,OAAO,CAAC;QACtC,sBAAsB,CAAC,EAAE,OAAO,CAAC;QACjC,QAAQ,CAAC,EAAE,OAAO,GAAG,UAAU,GAAG,cAAc,CAAC;QAEjD,kBAAkB,CAAC,EAAE,OAAO,CAAC;QAC7B,YAAY,CAAC,EAAE,OAAO,CAAC;QACvB,WAAW,CAAC,EAAE,OAAO,CAAC;QACtB,oBAAoB,CAAC,EAAE,OAAO,CAAC;QAC/B,2DAA2D;QAC3D,YAAY,CAAC,EAAE,OAAO,GAAG,SAAS,CAAC;QACnC,qDAAqD;QACrD,YAAY,CAAC,EAAE,mBAAmB,CAAC;KACtC,CAAC;CACL;AAED,eAAO,MAAM,2BAA2B,mBACpB,MAAM,YACb,oBAAoB,KAC9B,OAAO,CAAC,cAAc,CA6HxB,CAAC;AAEF,eAAO,MAAM,qBAAqB,QAAa,OAAO,CAAC,MAAM,CAwC5D,CAAC;AAEF,eAAO,MAAM,iCAAiC,aAAmB,oBAAoB,4BAKpF,CAAC"}
+{"version":3,"file":"browser.d.ts","sourceRoot":"","sources":["../../src/browser-process/browser.ts"],"names":[],"mappings":"AAQA,OAAO,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AAI9C,OAAO,EAA8B,KAAK,qBAAqB,EAAE,MAAM,yBAAyB,CAAC;AACjG,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,sCAAsC,CAAC;AAmD3E;;;GAGG;AACH,MAAM,WAAW,mBAAmB;IAChC,yDAAyD;IACzD,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,mDAAmD;IACnD,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,iDAAiD;IACjD,MAAM,CAAC,EAAE,OAAO,CAAC;CACpB;AAED,MAAM,WAAW,oBAAoB;IACjC,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAC5B,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,iBAAiB,CAAC,EAAE,OAAO,CAAC;IAC5B,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,2BAA2B,CAAC,EAAE,OAAO,CAAC;IACtC;;;;;;;;;OASG;IACH,gBAAgB,CAAC,EAAE,OAAO,CAAC;IAC3B,2EAA2E;IAC3E,cAAc,CAAC,EAAE,OAAO,CAAC;IACzB,uEAAuE;IACvE,iBAAiB,CAAC,EAAE,OAAO,CAAC;IAC5B,+DAA+D;IAC/D,eAAe,CAAC,EAAE,OAAO,CAAC;IAC1B;;;OAGG;IACH,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB;;;OAGG;IACH,eAAe,CAAC,EAAE,OAAO,CAAC;IAC1B;;;OAGG;IACH,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAC5B,kFAAkF;IAClF,aAAa,CAAC,EAAE,KAAK,GAAG,WAAW,GAAG,QAAQ,CAAC;IAC/C;;;OAGG;IACH,sBAAsB,CAAC,EAAE,SAAS,GAAG,+BAA+B,GAAG,uCAAuC,GAAG,yBAAyB,CAAC;IAC3I,kBAAkB,CAAC,EAAE;QACjB,qBAAqB,CAAC,EAAE,OAAO,CAAC;QAChC,mBAAmB,CAAC,EAAE,OAAO,CAAC;QAC9B,UAAU,CAAC,EAAE,OAAO,CAAC;QACrB,iBAAiB,CAAC,EAAE,OAAO,CAAC;QAC5B,gBAAgB,CAAC,EAAE,OAAO,CAAC;QAC3B,mBAAmB,CAAC,EAAE,OAAO,CAAC;QAC9B,UAAU,CAAC,EAAE,OAAO,CAAC;QACrB,gBAAgB,CAAC,EAAE,OAAO,CAAC;QAC3B,WAAW,CAAC,EAAE,OAAO,CAAC;QACtB,2BAA2B,CAAC,EAAE,OAAO,CAAC;QACtC,sBAAsB,CAAC,EAAE,OAAO,CAAC;QACjC,QAAQ,CAAC,EAAE,OAAO,GAAG,UAAU,GAAG,cAAc,CAAC;QAEjD,kBAAkB,CAAC,EAAE,OAAO,CAAC;QAC7B,YAAY,CAAC,EAAE,OAAO,CAAC;QACvB,WAAW,CAAC,EAAE,OAAO,CAAC;QACtB,oBAAoB,CAAC,EAAE,OAAO,CAAC;QAC/B,2DAA2D;QAC3D,YAAY,CAAC,EAAE,OAAO,GAAG,SAAS,CAAC;QACnC,qDAAqD;QACrD,YAAY,CAAC,EAAE,mBAAmB,CAAC;KACtC,CAAC;IACF;;;;;OAKG;IACH,iBAAiB,CAAC,EAAE,qBAAqB,CAAC;IAC1C;;;;OAIG;IACH,cAAc,CAAC,EAAE,cAAc,CAAC;CACnC;AAED,eAAO,MAAM,2BAA2B,mBACpB,MAAM,YACb,oBAAoB,KAC9B,OAAO,CAAC,cAAc,CAwNxB,CAAC;AAEF,eAAO,MAAM,qBAAqB,QAAa,OAAO,CAAC,MAAM,CAwC5D,CAAC;AAEF,eAAO,MAAM,iCAAiC,aAAmB,oBAAoB,4BA2BpF,CAAC"}