jumpy-lion 0.1.6-beta.7 → 1.0.0-beta.0

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

@@ -1,6 +1,6 @@
+import type { BaseLaunchBrowserOptions, FingerprintOptions, HumanizationOptions } from './launch-options.js';
 import { BrowserProcess } from './process.js';
-import { type FingerprintConfigJson } from './anti-detect-config.js';
-import type { ResolvedLocale } from '../fingerprinting/locale-resolver.js';
+export type { FingerprintOptions, HumanizationOptions };
 export interface BuildStealthArgsEnv {
     /** Override the platform. Defaults to `process.platform`. */
     platform?: NodeJS.Platform;
@@ -9,108 +9,41 @@ export interface BuildStealthArgsEnv {
  * Build the stealth argv list. Exported for unit tests so we can assert exact flag
  * sets without booting a browser.
  *
- * The `usingAntiDetectBrowser` flag is retained as a hook for future native-stealth-only
- * divergence, but is not currently needed — every flag in this set is either covered
- * identically by Cromite's C++ patches (no conflict) or orthogonal to them.
+ * When `usingAntiDetectBrowser` is true, the renderer-backgrounding and
+ * (on macOS) native-window-occlusion features are disabled regardless of
+ * env vars, because cromite patch D26 hides the only page-JS tell those
+ * flags would otherwise expose (document.hidden / rAF throttling). This
+ * fixes the "page goes blank until I refocus the window" symptom on
+ * headful macOS launches driven by CDP.
  */
 export declare function buildStealthArgs(env?: BuildStealthArgsEnv & {
     usingAntiDetectBrowser?: boolean;
 }): string[];
 /**
- * Humanization options for simulating realistic user behavior
- * All options are disabled by default for performance
+ * Process-layer launch options: everything in BaseLaunchBrowserOptions
+ * (the single shared declaration in launch-options.ts) plus the spawn-time
+ * fields only this layer knows about.
  */
-export interface HumanizationOptions {
-    /** Enable mouse movement humanization. Default: false */
-    mouse?: boolean;
-    /** Enable keyboard humanization. Default: false */
-    keyboard?: boolean;
-    /** Enable scroll humanization. Default: false */
-    scroll?: boolean;
-}
-export interface LaunchBrowserOptions {
+/**
+ * Resolve the platform-overrides config for an anti-detect browser launch, or
+ * THROW. The anti-detect binary exists to spoof; launching it without a config
+ * silently ships the host identity (navigator.platform / userAgent / WebGL all
+ * real) - the "30% of sessions are detectable and nobody notices" failure mode.
+ *
+ * Resolution order: the per-session config (stamped by browser-plugin.ts) first,
+ * then the static browser/config/default_fingerprint.json. If both are absent
+ * (per-session missing AND the default loader fails or yields nothing), this
+ * throws so the launch aborts instead of leaking. `loadStaticDefault` is injected
+ * so the dynamic-import path can be scripted in tests.
+ */
+export declare function resolveAntiDetectFingerprintConfig(perSessionConfig: any, loadStaticDefault: () => Promise<any>): Promise<any>;
+export interface LaunchBrowserOptions extends BaseLaunchBrowserOptions {
     anonymizedProxyUrl?: string;
     debuggingPort?: number;
-    windowWidth?: number;
-    windowHeight?: number;
-    ignoreHttpsErrors?: boolean;
-    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 */
     enableStealthMode?: boolean;
     /** Populate profile with realistic user data. Default: true */
     populateProfile?: boolean;
-    /**
-     * Reuse a specific Chrome user data directory across runs.
-     * When provided, this directory is preserved by default.
-     */
-    userDataDir?: string;
-    /**
-     * Force keeping or cleaning the profile directory on close.
-     * Defaults to true for temporary profiles and false for custom userDataDir.
-     */
-    keepUserDataDir?: boolean;
-    /**
-     * DNS-over-HTTPS endpoint template, for example:
-     * https://cloudflare-dns.com/dns-query
-     */
-    dnsOverHttpsServer?: string;
-    /** Chromium secure DNS mode. Default: 'secure' when dnsOverHttpsServer is set. */
-    secureDnsMode?: 'off' | 'automatic' | 'secure';
-    /**
-     * WebRTC IP handling policy. Recommended stealth value:
-     * disable_non_proxied_udp
-     */
-    webrtcIpHandlingPolicy?: 'default' | 'default_public_interface_only' | 'default_public_and_private_interfaces' | 'disable_non_proxied_udp';
-    fingerprintOptions?: {
-        enableAdvancedStealth?: boolean;
-        bypassRuntimeEnable?: boolean;
-        spoofWebGL?: boolean;
-        spoofAudioContext?: boolean;
-        spoofClientRects?: boolean;
-        maskAutomationFlags?: boolean;
-        spoofFonts?: boolean;
-        spoofPerformance?: boolean;
-        spoofLocale?: boolean;
-        useExperimentalFingerprints?: boolean;
-        useFingerprintDefaults?: boolean;
-        platform?: 'Win32' | 'MacIntel' | 'Linux x86_64';
-        bypassCDPDetection?: boolean;
-        spoofStorage?: boolean;
-        spoofTiming?: boolean;
-        enableDataDomeBypass?: boolean;
-        /** WebRTC policy inside page scripts. Default: 'spoof'. */
-        webRtcPolicy?: 'spoof' | 'disable';
-        /** 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":"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"}
+{"version":3,"file":"browser.d.ts","sourceRoot":"","sources":["../../src/browser-process/browser.ts"],"names":[],"mappings":"AAUA,OAAO,KAAK,EAAE,wBAAwB,EAAE,kBAAkB,EAAE,mBAAmB,EAAE,MAAM,qBAAqB,CAAC;AAC7G,OAAO,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AAK9C,YAAY,EAAE,kBAAkB,EAAE,mBAAmB,EAAE,CAAC;AA8MxD,MAAM,WAAW,mBAAmB;IAChC,6DAA6D;IAC7D,QAAQ,CAAC,EAAE,MAAM,CAAC,QAAQ,CAAC;CAC9B;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,gBAAgB,CAAC,GAAG,GAAE,mBAAmB,GAAG;IAAE,sBAAsB,CAAC,EAAE,OAAO,CAAA;CAAO,GAAG,MAAM,EAAE,CAW/G;AACD;;;;GAIG;AAEH;;;;;;;;;;;GAWG;AACH,wBAAsB,kCAAkC,CACpD,gBAAgB,EAAE,GAAG,EACrB,iBAAiB,EAAE,MAAM,OAAO,CAAC,GAAG,CAAC,GACtC,OAAO,CAAC,GAAG,CAAC,CAUd;AAED,MAAM,WAAW,oBAAqB,SAAQ,wBAAwB;IAClE,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAC5B,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,uEAAuE;IACvE,iBAAiB,CAAC,EAAE,OAAO,CAAC;IAC5B,+DAA+D;IAC/D,eAAe,CAAC,EAAE,OAAO,CAAC;CAC7B;AAED,eAAO,MAAM,2BAA2B,mBACpB,MAAM,YACb,oBAAoB,KAC9B,OAAO,CAAC,cAAc,CA4axB,CAAC;AA+CF,eAAO,MAAM,qBAAqB,QAAa,OAAO,CAAC,MAAM,CAO5D,CAAC;AAEF,eAAO,MAAM,iCAAiC,aAAmB,oBAAoB,4BAqBpF,CAAC"}