device-passport 1.1.0 → 1.2.0

package/dist/index.d.ts

@@ -1,201 +1,13 @@
-import { PassportGeneratorOptions, DevicePassport, BrowserProfile, OperatingSystemProfile, HardwareProfile, UserAgentClientHints, DevicePassportContext, PassportEvaluation, SupportedPlatform, SupportedBrowserName, SupportedArchitecture, BrandVersion } from './types/index.js';
-export { BenchmarkMetrics, ClientHintsHeaders, ConsistencyCategory, ConsistencyCheck, CpuProfile, DeviceProfile, EntropyAnalysis, EvaluationGrade, EvaluationStatus, GpuProfile, MemoryProfile, ScreenProfile } from './types/index.js';
-import { PlaywrightContextOptions, PuppeteerEmulationOptions } from './adapters/index.js';
-export { CANONICAL_HEADER_ORDER, CdpCommand, CdpPassportPlan, PassportLike, applyCdpPassport, applyToPlaywrightContext, applyToPuppeteerPage, formatCanonicalHeaders, getCdpPlan, getPlaywrightContext, getPuppeteerArgs, getStealthScript, toCurl, withPassport } from './adapters/index.js';
-import { StorageAdapter } from './storage/index.js';
-export { JSONFileStorage, JSONFileStorageOptions, MemoryStorage, MemoryStorageOptions } from './storage/index.js';
-import { L as LocaleProfile } from './shared/device-passport.C_F1vBE8.js';
-export { C as CountryGeoDefinition, G as GeoContext, a as GeoCoordinates, b as GeoLocation, c as GeoOptions, d as LanguageWeight } from './shared/device-passport.C_F1vBE8.js';
+export { A as AccountProfileManager, a as AccountProfileManagerOptions, B as BindProfileOptions, b as BuildEgoSessionPlanOptions, C as CreatePassportInputOptions, c as CreateSessionPlanOptions, D as DevicePassportInstance, E as EgoNativeBridge, P as PROXY_MISSING_NOTE, d as PROXY_RESOLUTION_NOTE, e as PassportManager, f as PassportManagerOptions, g as buildEgoSessionPlan, h as buildProxyDeclaration, i as createEgoBridge, j as createPassport, k as defaultTaskSpaceName, l as getEgoNativeBridge, m as getProfileReadiness } from './shared/device-passport.CDS7xrj8.js';
+import { OperatingSystemProfile, HardwareProfile, SupportedPlatform, SupportedArchitecture, SupportedBrowserName, BrandVersion, UserAgentClientHints, PassportGeneratorOptions, DevicePassport } from './types/index.js';
+export { BenchmarkMetrics, BrowserProfile, CdpCommand, CdpInitScript, CdpPassportPlan, ClientHintsHeaders, ConsistencyCategory, ConsistencyCheck, CpuProfile, DevicePassportContext, DeviceProfile, EgoAccountProfile, EgoLiteBridge, EgoProfile, EgoProfileReadiness, EgoProxyBinding, EgoProxyDeclaration, EgoSessionPlan, EntropyAnalysis, EvaluationGrade, EvaluationStatus, GpuProfile, MemoryProfile, PassportEvaluation, ScreenProfile } from './types/index.js';
 export { ALPHA3_TO_ALPHA2, COUNTRY_LOCALES, COUNTRY_NAME_TO_CODE, CountryLocaleConfig, DEFAULT_ACCEPT_LANGUAGE, DEFAULT_COUNTRY, DEFAULT_LOCALE, DEFAULT_TIMEZONE, GEO_LOCALES, GeoDetectOptions, TIMEZONE_MATRIX, TIMEZONE_TO_COUNTRY, alignGeoContext, detectCountry, detectGeoFromUrl, extractCountryFromProxyUrl, formatAcceptLanguage, getAllSupportedCountries, getCountryConfig, getCountryForTimezone, getDefaultTimezoneForCountry, getLocaleProfile, getTimezoneOffsetMinutes, getTimezonesForCountry, hasCountryConfig, isGeoAligned, isTimezoneAlignedWithCountry, isValidCountryCode, isValidTimezone, listAllTimezones, normalizeCountryCode, parseAcceptLanguage, toGeoLocation, toLocaleProfile } from './geo/index.js';
+export { CANONICAL_HEADER_ORDER, PassportLike, applyCdpPassport, formatCanonicalHeaders, getCdpPlan, toCurl, withPassport } from './adapters/index.js';
+export { P as PlaywrightContextOptions, a as PuppeteerEmulationOptions, b as applyToPlaywrightContext, c as applyToPuppeteerPage, g as getPlaywrightContext, d as getPuppeteerArgs, e as getStealthScript } from './shared/device-passport.D7pEnyp2.js';
+export { S as StorageAdapter } from './shared/device-passport.DirQmSd4.js';
+export { JSONFileStorage, JSONFileStorageOptions, MemoryStorage, MemoryStorageOptions } from './storage/index.js';
 export { BASELINE_OPTIMAL_ENTROPY, BROWSER_BASELINE_FREQUENCIES, COUNTRY_PRIMARY_LANGUAGES, COUNTRY_TIMEZONE_MAP, CoherenceEvaluationResult, Contradiction, ContradictionCategory, ContradictionSeverity, EntropyAnalysisResult, HeaderEntropyProfile, MIN_STRUCTURAL_ENTROPY, MathematicalModelFormalism, OPTIMAL_CHAR_ENTROPY_MAX, OPTIMAL_CHAR_ENTROPY_MIN, OPTIMAL_ENTROPY_MAX, OPTIMAL_ENTROPY_MIN, SubspaceEvaluation, analyzeHeaderEntropy, calculateKLDivergence, calculateShannonEntropy, calculateStructuralEntropy, detectAllContradictions, detectClientHintsContradictions, detectGeoChronoContradictions, detectHardwareContradictions, detectOSBrowserContradictions, evaluateCoherence, evaluateGeoAlignment, evaluatePassport } from './evaluator/index.js';
-
-/**
- * DevicePassportInstance encapsulates a single concrete, zero-contradiction digital identity persona.
- *
- * Provides runtime adapters for:
- * 1. Lightweight HTTP mode (Fetch, Axios, Undici, Got, cURL) with strict canonical header ordering.
- * 2. Heavyweight browser automation (Playwright, Puppeteer, ego-lite) with deep fingerprint masking.
- * 3. Self-evaluating consistency diagnostics based on empirical telemetry models.
- */
-declare class DevicePassportInstance {
-    readonly profile: DevicePassport;
-    constructor(profile: DevicePassport);
-    /**
-     * Factory method to create an instance from a plain DevicePassport object.
-     */
-    static from(profile: DevicePassport): DevicePassportInstance;
-    get id(): string;
-    get seed(): string;
-    get createdAt(): string;
-    get browser(): BrowserProfile;
-    get os(): OperatingSystemProfile;
-    get hardware(): HardwareProfile;
-    get locale(): LocaleProfile;
-    get headers(): Record<string, string>;
-    get clientHints(): UserAgentClientHints;
-    get context(): DevicePassportContext;
-    get userAgent(): string;
-    get timezone(): string;
-    get playwrightContext(): PlaywrightContextOptions;
-    get puppeteerArgs(): PuppeteerEmulationOptions;
-    get evaluation(): PassportEvaluation | undefined;
-    /**
-     * Returns HTTP headers formatted in strict canonical browser sequence.
-     * Essential for anti-bot evasion against Cloudflare, Akamai, and DataDome.
-     */
-    getHeaders(overrides?: Record<string, string>): Record<string, string>;
-    /**
-     * Returns a higher-order fetch function wrapping standard fetch with this passport's canonical persona.
-     */
-    wrapFetch(customFetch?: typeof fetch): typeof fetch;
-    /**
-     * Alias for wrapFetch.
-     */
-    withPassport(customFetch?: typeof fetch): typeof fetch;
-    /**
-     * Generates a copy-pasteable cURL command with correct browser headers and User-Agent.
-     */
-    toCurl(url: string, options?: {
-        method?: string;
-        data?: any;
-        headers?: Record<string, string>;
-    }): string;
-    /**
-     * Generates Playwright BrowserContext options.
-     * Usage:
-     * ```ts
-     * const context = await browser.newContext(passport.getPlaywrightContext());
-     * ```
-     */
-    getPlaywrightContext(): PlaywrightContextOptions;
-    /**
-     * Returns Puppeteer launch args and page emulation parameters.
-     */
-    getPuppeteerArgs(): PuppeteerEmulationOptions;
-    /**
-     * Generates an in-page stealth script to patch runtime JavaScript APIs
-     * (navigator.webdriver, hardwareConcurrency, deviceMemory, WebGL, Client Hints).
-     */
-    getStealthScript(): string;
-    /**
-     * Injects stealth scripts and extra HTTP headers into a Playwright BrowserContext.
-     */
-    applyToPlaywright(context: any): Promise<void>;
-    /**
-     * Injects stealth scripts and emulation parameters into a Puppeteer Page.
-     */
-    applyToPuppeteer(page: any): Promise<void>;
-    /**
-     * Evaluates cross-layer consistency and Shannon entropy.
-     * Caches the result on `this.profile.evaluation`.
-     */
-    evaluate(forceRecompute?: boolean): PassportEvaluation;
-    /**
-     * Returns the underlying raw DevicePassport data object.
-     */
-    toJSON(): DevicePassport;
-    toString(): string;
-}
-interface CreatePassportInputOptions extends PassportGeneratorOptions {
-    /** Optional file path or storage adapter to persist this passport deterministically */
-    store?: string | StorageAdapter<DevicePassport>;
-}
-/**
- * Universal polymorphic factory for creating a DevicePassportInstance.
- *
- * Supports:
- * - One-line string seed: `createPassport('alice', { geo: 'US' })`
- * - Full options object: `createPassport({ seed: 'bot1', store: './passports.json' })`
- * - Existing raw profile: `createPassport(rawProfile)`
- * - Zero-config ephemeral persona: `createPassport()`
- */
-declare function createPassport(seedOrOptionsOrProfile?: string | CreatePassportInputOptions | DevicePassport, extraOptions?: CreatePassportInputOptions): DevicePassportInstance;
-
-interface PassportManagerOptions {
-    /**
-     * Storage backend for persisting passports:
-     * - String path (e.g. './passports.json') -> creates JSONFileStorage automatically.
-     * - StorageAdapter instance -> custom pluggable storage (Memory, File, Redis, DB).
-     * - Omitted or 'memory' -> uses MemoryStorage.
-     */
-    store?: string | StorageAdapter<DevicePassport>;
-    /**
-     * Default geographic country code for newly generated personas (e.g. 'US', 'GB', 'DE', 'JP').
-     * Defaults to 'US'.
-     */
-    defaultGeo?: string;
-    /**
-     * Default operating system preference ('macOS' | 'Windows').
-     */
-    defaultOS?: SupportedPlatform;
-    /**
-     * Default browser preference ('Chrome' | 'Edge').
-     */
-    defaultBrowser?: SupportedBrowserName;
-    /**
-     * Generator function. Defaults to engine's generatePassport.
-     */
-    generator?: (options?: PassportGeneratorOptions) => DevicePassport;
-}
-/**
- * PassportManager manages fleet-scale digital device identities.
- *
- * Guarantees true sticky identity across runs:
- * Calling `getPassport(seed)` with the same seed (e.g. account ID, proxy IP, username)
- * will consistently return the exact same device passport across restarts and cron jobs.
- */
-declare class PassportManager {
-    readonly storage: StorageAdapter<DevicePassport>;
-    readonly defaultGeo: string;
-    readonly defaultOS?: SupportedPlatform;
-    readonly defaultBrowser?: SupportedBrowserName;
-    private readonly generator;
-    constructor(options?: PassportManagerOptions);
-    /**
-     * Retrieves an existing sticky passport by seed or deterministically generates
-     * and persists a new one if it does not already exist.
-     *
-     * @param seed Deterministic seed (user ID, account handle, proxy IP, worker slot)
-     * @param options Generator options to use if persona needs to be created
-     */
-    getPassport(seed: string | number, options?: PassportGeneratorOptions): Promise<DevicePassportInstance>;
-    /**
-     * Synchronous passport retrieval for environments backed by MemoryStorage or JSONFileStorage.
-     */
-    getPassportSync(seed: string | number, options?: PassportGeneratorOptions): DevicePassportInstance;
-    /**
-     * Forces re-generation and overwrite of a passport for the given seed.
-     */
-    renewPassport(seed: string | number, options?: PassportGeneratorOptions): Promise<DevicePassportInstance>;
-    /**
-     * Check if a passport exists in storage for the given seed.
-     */
-    hasPassport(seed: string | number): Promise<boolean>;
-    /**
-     * Delete a passport from storage.
-     */
-    deletePassport(seed: string | number): Promise<boolean>;
-    /**
-     * Import an existing passport into storage.
-     */
-    importPassport(passport: DevicePassport | DevicePassportInstance): Promise<DevicePassportInstance>;
-    /**
-     * List all stored seeds.
-     */
-    listSeeds(): Promise<string[]>;
-    /**
-     * List all stored passports as DevicePassportInstance objects.
-     */
-    listPassports(): Promise<DevicePassportInstance[]>;
-    /**
-     * Clear all stored passports.
-     */
-    clear(): Promise<void>;
-    /**
-     * Return number of stored personas.
-     */
-    count(): Promise<number>;
-}
+export { C as CountryGeoDefinition, G as GeoContext, a as GeoCoordinates, b as GeoLocation, c as GeoOptions, d as LanguageWeight, L as LocaleProfile } from './shared/device-passport.C_F1vBE8.js';
 
 /**
  * Zero-Contradiction Hardware Matrix for Device Passport.
@@ -472,5 +284,5 @@ declare function formatComparativeMatrixJSON(): string;
  */
 declare const VERSION = "1.0.0";
 
-export { ALL_PRESETS, BENCHMARK_METRICS_METADATA, BrandVersion, BrowserProfile, CHROME_VERSIONS, COMPARATIVE_DATASET, DevicePassport, DevicePassportContext, DevicePassportInstance, EDGE_VERSIONS, HardwareProfile, LocaleProfile, MACOS_PRESETS, OperatingSystemProfile, PassportEvaluation, PassportGeneratorOptions, PassportManager, PlaywrightContextOptions, PuppeteerEmulationOptions, StorageAdapter, SupportedArchitecture, SupportedBrowserName, SupportedPlatform, UserAgentClientHints, VERSION, WINDOWS_PRESETS, buildUserAgent, createDeterministicPRNG, createMulberry32, createPassport, fnv1a, formatComparativeMatrixJSON, formatComparativeMatrixLaTeX, formatComparativeMatrixMarkdown, formatStructuredBrandList, generateBrandVersions, generateDevicePassport, generatePassport, generateUserAgentClientHints, getApifyHeadersIfAvailable, getHardwarePresets, getPixelProtectionConfig, getPixelProtectionScript, getStaticFallbackHeaders, murmur3, parseStructuredBrandList, runComparativeBenchmark, validateHardwareContradictions };
-export type { BenchmarkReportSummary, CanvasNoiseConfig, ClientHintsGenerateOptions, CreatePassportInputOptions, DeviceMatrixPreset, LibraryBenchmarkProfile, MetricMetadata, MetricScore, PassportManagerOptions };
+export { ALL_PRESETS, BENCHMARK_METRICS_METADATA, BrandVersion, CHROME_VERSIONS, COMPARATIVE_DATASET, DevicePassport, EDGE_VERSIONS, HardwareProfile, MACOS_PRESETS, OperatingSystemProfile, PassportGeneratorOptions, SupportedArchitecture, SupportedBrowserName, SupportedPlatform, UserAgentClientHints, VERSION, WINDOWS_PRESETS, buildUserAgent, createDeterministicPRNG, createMulberry32, fnv1a, formatComparativeMatrixJSON, formatComparativeMatrixLaTeX, formatComparativeMatrixMarkdown, formatStructuredBrandList, generateBrandVersions, generateDevicePassport, generatePassport, generateUserAgentClientHints, getApifyHeadersIfAvailable, getHardwarePresets, getPixelProtectionConfig, getPixelProtectionScript, getStaticFallbackHeaders, murmur3, parseStructuredBrandList, runComparativeBenchmark, validateHardwareContradictions };
+export type { BenchmarkReportSummary, CanvasNoiseConfig, ClientHintsGenerateOptions, DeviceMatrixPreset, LibraryBenchmarkProfile, MetricMetadata, MetricScore };

package/dist/index.mjs

@@ -1,425 +1,14 @@
-import { f as formatCanonicalHeaders, w as withPassport, t as toCurl, d as getPlaywrightContext, e as getPuppeteerArgs, h as getStealthScript, b as applyToPlaywrightContext, c as applyToPuppeteerPage, i as generatePassport } from './shared/device-passport.NHw_f6HT.mjs';
-export { A as ALL_PRESETS, C as CANONICAL_HEADER_ORDER, j as CHROME_VERSIONS, E as EDGE_VERSIONS, M as MACOS_PRESETS, W as WINDOWS_PRESETS, a as applyCdpPassport, k as buildUserAgent, l as createDeterministicPRNG, m as createMulberry32, n as fnv1a, o as formatStructuredBrandList, p as generateBrandVersions, q as generateDevicePassport, r as generateUserAgentClientHints, s as getApifyHeadersIfAvailable, g as getCdpPlan, u as getHardwarePresets, v as getPixelProtectionConfig, x as getPixelProtectionScript, y as getStaticFallbackHeaders, z as murmur3, B as parseStructuredBrandList, D as validateHardwareContradictions } from './shared/device-passport.NHw_f6HT.mjs';
-import { detectAllContradictions, analyzeHeaderEntropy } from './evaluator/index.mjs';
-export { BASELINE_OPTIMAL_ENTROPY, BROWSER_BASELINE_FREQUENCIES, COUNTRY_PRIMARY_LANGUAGES, COUNTRY_TIMEZONE_MAP, MIN_STRUCTURAL_ENTROPY, OPTIMAL_CHAR_ENTROPY_MAX, OPTIMAL_CHAR_ENTROPY_MIN, OPTIMAL_ENTROPY_MAX, OPTIMAL_ENTROPY_MIN, calculateKLDivergence, calculateShannonEntropy, calculateStructuralEntropy, detectClientHintsContradictions, detectGeoChronoContradictions, detectHardwareContradictions, detectOSBrowserContradictions, evaluateCoherence, evaluateGeoAlignment, evaluatePassport } from './evaluator/index.mjs';
-import { J as JSONFileStorage, M as MemoryStorage } from './shared/device-passport.CyQtcZeD.mjs';
+export { A as AccountProfileManager, D as DevicePassportInstance, P as PROXY_MISSING_NOTE, a as PROXY_RESOLUTION_NOTE, h as PassportManager, b as buildEgoSessionPlan, c as buildProxyDeclaration, d as createEgoBridge, i as createPassport, e as defaultTaskSpaceName, g as getEgoNativeBridge, f as getProfileReadiness } from './shared/device-passport.kekU28UM.mjs';
+export { A as ALL_PRESETS, C as CANONICAL_HEADER_ORDER, i as CHROME_VERSIONS, E as EDGE_VERSIONS, M as MACOS_PRESETS, W as WINDOWS_PRESETS, a as applyCdpPassport, b as applyToPlaywrightContext, c as applyToPuppeteerPage, j as buildUserAgent, k as createDeterministicPRNG, l as createMulberry32, m as fnv1a, f as formatCanonicalHeaders, n as formatStructuredBrandList, o as generateBrandVersions, p as generateDevicePassport, q as generatePassport, r as generateUserAgentClientHints, s as getApifyHeadersIfAvailable, g as getCdpPlan, u as getHardwarePresets, v as getPixelProtectionConfig, x as getPixelProtectionScript, d as getPlaywrightContext, e as getPuppeteerArgs, y as getStaticFallbackHeaders, h as getStealthScript, z as murmur3, B as parseStructuredBrandList, t as toCurl, D as validateHardwareContradictions, w as withPassport } from './shared/device-passport.gNo82fQ5.mjs';
 export { GEO_LOCALES, TIMEZONE_MATRIX, detectGeoFromUrl, getLocaleProfile, isValidCountryCode } from './geo/index.mjs';
-export { A as ALPHA3_TO_ALPHA2, C as COUNTRY_LOCALES, b as COUNTRY_NAME_TO_CODE, D as DEFAULT_ACCEPT_LANGUAGE, c as DEFAULT_COUNTRY, d as DEFAULT_LOCALE, f as DEFAULT_TIMEZONE, T as TIMEZONE_TO_COUNTRY, a as alignGeoContext, g as detectCountry, e as extractCountryFromProxyUrl, i as formatAcceptLanguage, j as getAllSupportedCountries, k as getCountryConfig, l as getCountryForTimezone, m as getDefaultTimezoneForCountry, n as getTimezoneOffsetMinutes, o as getTimezonesForCountry, h as hasCountryConfig, p as isGeoAligned, q as isTimezoneAlignedWithCountry, r as isValidTimezone, s as listAllTimezones, u as normalizeCountryCode, v as parseAcceptLanguage, w as toGeoLocation, t as toLocaleProfile } from './shared/device-passport.BBf9OKap.mjs';
+export { J as JSONFileStorage, M as MemoryStorage } from './shared/device-passport.CyQtcZeD.mjs';
+export { evaluateCoherence, evaluateGeoAlignment, evaluatePassport } from './evaluator/index.mjs';
+export { A as ALPHA3_TO_ALPHA2, C as COUNTRY_LOCALES, b as COUNTRY_NAME_TO_CODE, D as DEFAULT_ACCEPT_LANGUAGE, c as DEFAULT_COUNTRY, d as DEFAULT_LOCALE, f as DEFAULT_TIMEZONE, T as TIMEZONE_TO_COUNTRY, a as alignGeoContext, g as detectCountry, e as extractCountryFromProxyUrl, i as formatAcceptLanguage, j as getAllSupportedCountries, k as getCountryConfig, l as getCountryForTimezone, m as getDefaultTimezoneForCountry, n as getTimezoneOffsetMinutes, o as getTimezonesForCountry, h as hasCountryConfig, p as isGeoAligned, q as isTimezoneAlignedWithCountry, r as isValidTimezone, s as listAllTimezones, u as normalizeCountryCode, v as parseAcceptLanguage, w as toGeoLocation, t as toLocaleProfile } from './shared/device-passport.BPQj0qdT.mjs';
+export { B as BASELINE_OPTIMAL_ENTROPY, c as BROWSER_BASELINE_FREQUENCIES, C as COUNTRY_PRIMARY_LANGUAGES, e as COUNTRY_TIMEZONE_MAP, M as MIN_STRUCTURAL_ENTROPY, O as OPTIMAL_CHAR_ENTROPY_MAX, f as OPTIMAL_CHAR_ENTROPY_MIN, g as OPTIMAL_ENTROPY_MAX, h as OPTIMAL_ENTROPY_MIN, a as analyzeHeaderEntropy, i as calculateKLDivergence, j as calculateShannonEntropy, k as calculateStructuralEntropy, d as detectAllContradictions, l as detectClientHintsContradictions, b as detectGeoChronoContradictions, m as detectHardwareContradictions, n as detectOSBrowserContradictions } from './shared/device-passport.BGfRcQNh.mjs';
 import 'node:crypto';
 import 'node:fs';
 import 'node:path';
 
-class DevicePassportInstance {
-  profile;
-  constructor(profile) {
-    if (!profile) {
-      throw new Error("[DevicePassportInstance] Profile cannot be null or undefined");
-    }
-    this.profile = profile;
-  }
-  /**
-   * Factory method to create an instance from a plain DevicePassport object.
-   */
-  static from(profile) {
-    return new DevicePassportInstance(profile);
-  }
-  // ==========================================
-  // Getters for core profile facets
-  // ==========================================
-  get id() {
-    return this.profile.id;
-  }
-  get seed() {
-    return this.profile.seed;
-  }
-  get createdAt() {
-    return this.profile.createdAt;
-  }
-  get browser() {
-    return this.profile.browser;
-  }
-  get os() {
-    return this.profile.os;
-  }
-  get hardware() {
-    return this.profile.hardware;
-  }
-  get locale() {
-    return this.profile.locale;
-  }
-  get headers() {
-    return this.profile.headers;
-  }
-  get clientHints() {
-    return this.profile.clientHints;
-  }
-  get context() {
-    return this.profile.context;
-  }
-  get userAgent() {
-    return this.profile.headers["user-agent"] || this.profile.browser.userAgent;
-  }
-  get timezone() {
-    return this.profile.locale.timezone;
-  }
-  get playwrightContext() {
-    return this.getPlaywrightContext();
-  }
-  get puppeteerArgs() {
-    return this.getPuppeteerArgs();
-  }
-  get evaluation() {
-    return this.profile.evaluation;
-  }
-  // ==========================================
-  // Lightweight HTTP Mode Adapters
-  // ==========================================
-  /**
-   * Returns HTTP headers formatted in strict canonical browser sequence.
-   * Essential for anti-bot evasion against Cloudflare, Akamai, and DataDome.
-   */
-  getHeaders(overrides) {
-    return formatCanonicalHeaders(this.profile.headers, overrides);
-  }
-  /**
-   * Returns a higher-order fetch function wrapping standard fetch with this passport's canonical persona.
-   */
-  wrapFetch(customFetch) {
-    return withPassport(this, customFetch);
-  }
-  /**
-   * Alias for wrapFetch.
-   */
-  withPassport(customFetch) {
-    return withPassport(this, customFetch);
-  }
-  /**
-   * Generates a copy-pasteable cURL command with correct browser headers and User-Agent.
-   */
-  toCurl(url, options) {
-    return toCurl(this, url, options);
-  }
-  // ==========================================
-  // Heavyweight Browser Automation Adapters
-  // ==========================================
-  /**
-   * Generates Playwright BrowserContext options.
-   * Usage:
-   * ```ts
-   * const context = await browser.newContext(passport.getPlaywrightContext());
-   * ```
-   */
-  getPlaywrightContext() {
-    return getPlaywrightContext(this.profile);
-  }
-  /**
-   * Returns Puppeteer launch args and page emulation parameters.
-   */
-  getPuppeteerArgs() {
-    return getPuppeteerArgs(this.profile);
-  }
-  /**
-   * Generates an in-page stealth script to patch runtime JavaScript APIs
-   * (navigator.webdriver, hardwareConcurrency, deviceMemory, WebGL, Client Hints).
-   */
-  getStealthScript() {
-    return getStealthScript(this.profile);
-  }
-  /**
-   * Injects stealth scripts and extra HTTP headers into a Playwright BrowserContext.
-   */
-  async applyToPlaywright(context) {
-    await applyToPlaywrightContext(context, this.profile);
-  }
-  /**
-   * Injects stealth scripts and emulation parameters into a Puppeteer Page.
-   */
-  async applyToPuppeteer(page) {
-    await applyToPuppeteerPage(page, this.profile);
-  }
-  // ==========================================
-  // Consistency & Diagnostics
-  // ==========================================
-  /**
-   * Evaluates cross-layer consistency and Shannon entropy.
-   * Caches the result on `this.profile.evaluation`.
-   */
-  evaluate(forceRecompute = false) {
-    if (this.profile.evaluation && !forceRecompute) {
-      return this.profile.evaluation;
-    }
-    try {
-      const contradictions = detectAllContradictions(this.profile);
-      let estimatedBits = 48;
-      let collisionRisk = "very_low";
-      try {
-        const entropy = analyzeHeaderEntropy(this.profile.headers);
-        if (entropy) {
-          estimatedBits = entropy.estimatedBits;
-          collisionRisk = entropy.collisionRisk;
-        }
-      } catch {
-      }
-      const totalPenalty = contradictions.reduce((sum, c) => sum + c.impactPenalty, 0);
-      const overallScore = Math.max(0, Math.min(100, Math.round(100 - totalPenalty)));
-      const status = overallScore >= 90 ? "PASS" : overallScore >= 70 ? "WARN" : "FAIL";
-      const grade = overallScore >= 95 ? "A+" : overallScore >= 85 ? "A" : overallScore >= 70 ? "B" : overallScore >= 50 ? "C" : "F";
-      const checks = [
-        {
-          id: "chk_os_ua_alignment",
-          name: "OS and User-Agent Alignment",
-          category: "os_ua_alignment",
-          passed: !contradictions.some((c) => c.category === "os_browser"),
-          score: contradictions.some((c) => c.category === "os_browser") ? 0 : 100,
-          weight: 1.5,
-          message: contradictions.find((c) => c.category === "os_browser")?.description ?? "User-Agent and Operating System are fully coherent"
-        },
-        {
-          id: "chk_hardware_plausibility",
-          name: "Hardware and GPU Plausibility",
-          category: "hardware_plausibility",
-          passed: !contradictions.some((c) => c.category === "hardware_system"),
-          score: contradictions.some((c) => c.category === "hardware_system") ? 0 : 100,
-          weight: 2,
-          message: contradictions.find((c) => c.category === "hardware_system")?.description ?? "GPU renderer, CPU architecture and RAM are physically plausible"
-        },
-        {
-          id: "chk_geo_locale_coherence",
-          name: "Geo and Locale Coherence",
-          category: "geo_locale_coherence",
-          passed: !contradictions.some((c) => c.category === "geo_chrono"),
-          score: contradictions.some((c) => c.category === "geo_chrono") ? 0 : 100,
-          weight: 1.5,
-          message: contradictions.find((c) => c.category === "geo_chrono")?.description ?? "Timezone, country, and Accept-Language are geographically locked"
-        },
-        {
-          id: "chk_client_hints_entropy",
-          name: "Client Hints RFC 8942 Compliance",
-          category: "client_hints_entropy",
-          passed: !contradictions.some((c) => c.category === "client_hints"),
-          score: contradictions.some((c) => c.category === "client_hints") ? 0 : 100,
-          weight: 1.5,
-          message: contradictions.find((c) => c.category === "client_hints")?.description ?? "User-Agent Client Hints headers strictly match W3C and Chromium freeze specifications"
-        }
-      ];
-      const evaluation = {
-        overallScore,
-        status,
-        grade,
-        checks,
-        entropyAnalysis: {
-          estimatedBits,
-          collisionRisk
-        },
-        evaluatedAt: (/* @__PURE__ */ new Date()).toISOString()
-      };
-      this.profile.evaluation = evaluation;
-      return evaluation;
-    } catch {
-      if (this.profile.evaluation) {
-        return this.profile.evaluation;
-      }
-      const baseline = {
-        overallScore: 100,
-        status: "PASS",
-        grade: "A+",
-        checks: [],
-        evaluatedAt: (/* @__PURE__ */ new Date()).toISOString()
-      };
-      this.profile.evaluation = baseline;
-      return baseline;
-    }
-  }
-  // ==========================================
-  // Serialization
-  // ==========================================
-  /**
-   * Returns the underlying raw DevicePassport data object.
-   */
-  toJSON() {
-    return this.profile;
-  }
-  toString() {
-    const { id, browser, os, locale } = this.profile;
-    return `[DevicePassport ${id} | ${browser?.name ?? "Browser"} ${browser?.version ?? ""} on ${os?.platform ?? "OS"} | ${locale?.language ?? "Locale"}]`;
-  }
-}
-function createPassport(seedOrOptionsOrProfile, extraOptions) {
-  if (seedOrOptionsOrProfile instanceof DevicePassportInstance) {
-    return seedOrOptionsOrProfile;
-  }
-  if (seedOrOptionsOrProfile && typeof seedOrOptionsOrProfile === "object" && "id" in seedOrOptionsOrProfile && "clientHints" in seedOrOptionsOrProfile && "headers" in seedOrOptionsOrProfile) {
-    return new DevicePassportInstance(seedOrOptionsOrProfile);
-  }
-  let options = {};
-  if (typeof seedOrOptionsOrProfile === "string") {
-    options = { ...extraOptions, seed: seedOrOptionsOrProfile };
-  } else if (seedOrOptionsOrProfile && typeof seedOrOptionsOrProfile === "object") {
-    options = { ...seedOrOptionsOrProfile };
-  } else if (extraOptions) {
-    options = { ...extraOptions };
-  }
-  if (options.store && options.seed) {
-    const storage = typeof options.store === "string" ? new JSONFileStorage({ filePath: options.store }) : options.store;
-    if (storage.hasSync && storage.hasSync(options.seed)) {
-      const existing = storage.getSync(options.seed);
-      if (existing) return new DevicePassportInstance(existing);
-    }
-    const generated2 = generatePassport(options);
-    if (storage.setSync) {
-      storage.setSync(options.seed, generated2);
-    } else {
-      storage.set(options.seed, generated2).catch(() => {
-      });
-    }
-    return new DevicePassportInstance(generated2);
-  }
-  const generated = generatePassport(options);
-  return new DevicePassportInstance(generated);
-}
-
-class PassportManager {
-  storage;
-  defaultGeo;
-  defaultOS;
-  defaultBrowser;
-  generator;
-  constructor(options) {
-    if (typeof options?.store === "string") {
-      this.storage = new JSONFileStorage(options.store);
-    } else if (options?.store && typeof options.store.get === "function") {
-      this.storage = options.store;
-    } else {
-      this.storage = new MemoryStorage();
-    }
-    this.defaultGeo = options?.defaultGeo ?? "US";
-    this.defaultOS = options?.defaultOS;
-    this.defaultBrowser = options?.defaultBrowser;
-    this.generator = options?.generator ?? generatePassport;
-  }
-  /**
-   * Retrieves an existing sticky passport by seed or deterministically generates
-   * and persists a new one if it does not already exist.
-   *
-   * @param seed Deterministic seed (user ID, account handle, proxy IP, worker slot)
-   * @param options Generator options to use if persona needs to be created
-   */
-  async getPassport(seed, options) {
-    const seedStr = String(seed);
-    const existing = await this.storage.get(seedStr);
-    if (existing) {
-      return new DevicePassportInstance(existing);
-    }
-    const mergedOptions = {
-      seed: seedStr,
-      country: options?.country ?? this.defaultGeo,
-      os: options?.os ?? this.defaultOS,
-      browser: options?.browser ?? this.defaultBrowser,
-      ...options
-    };
-    const profile = this.generator(mergedOptions);
-    await this.storage.set(seedStr, profile);
-    return new DevicePassportInstance(profile);
-  }
-  /**
-   * Synchronous passport retrieval for environments backed by MemoryStorage or JSONFileStorage.
-   */
-  getPassportSync(seed, options) {
-    const seedStr = String(seed);
-    const syncStore = this.storage;
-    if (typeof syncStore.getSync === "function") {
-      const existing = syncStore.getSync(seedStr);
-      if (existing) {
-        return new DevicePassportInstance(existing);
-      }
-      const mergedOptions = {
-        seed: seedStr,
-        country: options?.country ?? this.defaultGeo,
-        os: options?.os ?? this.defaultOS,
-        browser: options?.browser ?? this.defaultBrowser,
-        ...options
-      };
-      const profile = this.generator(mergedOptions);
-      if (typeof syncStore.setSync === "function") {
-        syncStore.setSync(seedStr, profile);
-      }
-      return new DevicePassportInstance(profile);
-    }
-    throw new Error(
-      "[PassportManager] Current storage adapter does not support synchronous operations. Use await manager.getPassport(seed) instead."
-    );
-  }
-  /**
-   * Forces re-generation and overwrite of a passport for the given seed.
-   */
-  async renewPassport(seed, options) {
-    const seedStr = String(seed);
-    const mergedOptions = {
-      seed: seedStr,
-      country: options?.country ?? this.defaultGeo,
-      os: options?.os ?? this.defaultOS,
-      browser: options?.browser ?? this.defaultBrowser,
-      ...options
-    };
-    const profile = this.generator(mergedOptions);
-    await this.storage.set(seedStr, profile);
-    return new DevicePassportInstance(profile);
-  }
-  /**
-   * Check if a passport exists in storage for the given seed.
-   */
-  async hasPassport(seed) {
-    return this.storage.has(String(seed));
-  }
-  /**
-   * Delete a passport from storage.
-   */
-  async deletePassport(seed) {
-    return this.storage.delete(String(seed));
-  }
-  /**
-   * Import an existing passport into storage.
-   */
-  async importPassport(passport) {
-    const raw = passport instanceof DevicePassportInstance ? passport.toJSON() : passport;
-    await this.storage.set(raw.seed, raw);
-    return new DevicePassportInstance(raw);
-  }
-  /**
-   * List all stored seeds.
-   */
-  async listSeeds() {
-    return this.storage.keys();
-  }
-  /**
-   * List all stored passports as DevicePassportInstance objects.
-   */
-  async listPassports() {
-    const keys = await this.storage.keys();
-    const instances = [];
-    for (const key of keys) {
-      const item = await this.storage.get(key);
-      if (item) {
-        instances.push(new DevicePassportInstance(item));
-      }
-    }
-    return instances;
-  }
-  /**
-   * Clear all stored passports.
-   */
-  async clear() {
-    await this.storage.clear();
-  }
-  /**
-   * Return number of stored personas.
-   */
-  async count() {
-    const keys = await this.storage.keys();
-    return keys.length;
-  }
-}
-
 const BENCHMARK_METRICS_METADATA = {
   clientHintsSupport: {
     id: "clientHintsSupport",
@@ -792,4 +381,4 @@ function formatComparativeMatrixJSON() {
 
 const VERSION = "1.0.0";
 
-export { BENCHMARK_METRICS_METADATA, COMPARATIVE_DATASET, DevicePassportInstance, JSONFileStorage, MemoryStorage, PassportManager, VERSION, analyzeHeaderEntropy, applyToPlaywrightContext, applyToPuppeteerPage, createPassport, detectAllContradictions, formatCanonicalHeaders, formatComparativeMatrixJSON, formatComparativeMatrixLaTeX, formatComparativeMatrixMarkdown, generatePassport, getPlaywrightContext, getPuppeteerArgs, getStealthScript, runComparativeBenchmark, toCurl, withPassport };
+export { BENCHMARK_METRICS_METADATA, COMPARATIVE_DATASET, VERSION, formatComparativeMatrixJSON, formatComparativeMatrixLaTeX, formatComparativeMatrixMarkdown, runComparativeBenchmark };