device-passport 1.1.0 → 1.2.0

package/dist/index.d.cts

@@ -1,201 +1,13 @@
-import { PassportGeneratorOptions, DevicePassport, BrowserProfile, OperatingSystemProfile, HardwareProfile, UserAgentClientHints, DevicePassportContext, PassportEvaluation, SupportedPlatform, SupportedBrowserName, SupportedArchitecture, BrandVersion } from './types/index.cjs';
-export { BenchmarkMetrics, ClientHintsHeaders, ConsistencyCategory, ConsistencyCheck, CpuProfile, DeviceProfile, EntropyAnalysis, EvaluationGrade, EvaluationStatus, GpuProfile, MemoryProfile, ScreenProfile } from './types/index.cjs';
-import { PlaywrightContextOptions, PuppeteerEmulationOptions } from './adapters/index.cjs';
-export { CANONICAL_HEADER_ORDER, CdpCommand, CdpPassportPlan, PassportLike, applyCdpPassport, applyToPlaywrightContext, applyToPuppeteerPage, formatCanonicalHeaders, getCdpPlan, getPlaywrightContext, getPuppeteerArgs, getStealthScript, toCurl, withPassport } from './adapters/index.cjs';
-import { StorageAdapter } from './storage/index.cjs';
-export { JSONFileStorage, JSONFileStorageOptions, MemoryStorage, MemoryStorageOptions } from './storage/index.cjs';
-import { L as LocaleProfile } from './shared/device-passport.C_F1vBE8.cjs';
-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.cjs';
+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.CfLes-lq.cjs';
+import { OperatingSystemProfile, HardwareProfile, SupportedPlatform, SupportedArchitecture, SupportedBrowserName, BrandVersion, UserAgentClientHints, PassportGeneratorOptions, DevicePassport } from './types/index.cjs';
+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.cjs';
 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.cjs';
+export { CANONICAL_HEADER_ORDER, PassportLike, applyCdpPassport, formatCanonicalHeaders, getCdpPlan, toCurl, withPassport } from './adapters/index.cjs';
+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.CsOWqPIr.cjs';
+export { S as StorageAdapter } from './shared/device-passport.DirQmSd4.cjs';
+export { JSONFileStorage, JSONFileStorageOptions, MemoryStorage, MemoryStorageOptions } from './storage/index.cjs';
 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.cjs';
-
-/**
- * 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.cjs';
 
 /**
  * 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.d.mts

@@ -1,201 +1,13 @@
-import { PassportGeneratorOptions, DevicePassport, BrowserProfile, OperatingSystemProfile, HardwareProfile, UserAgentClientHints, DevicePassportContext, PassportEvaluation, SupportedPlatform, SupportedBrowserName, SupportedArchitecture, BrandVersion } from './types/index.mjs';
-export { BenchmarkMetrics, ClientHintsHeaders, ConsistencyCategory, ConsistencyCheck, CpuProfile, DeviceProfile, EntropyAnalysis, EvaluationGrade, EvaluationStatus, GpuProfile, MemoryProfile, ScreenProfile } from './types/index.mjs';
-import { PlaywrightContextOptions, PuppeteerEmulationOptions } from './adapters/index.mjs';
-export { CANONICAL_HEADER_ORDER, CdpCommand, CdpPassportPlan, PassportLike, applyCdpPassport, applyToPlaywrightContext, applyToPuppeteerPage, formatCanonicalHeaders, getCdpPlan, getPlaywrightContext, getPuppeteerArgs, getStealthScript, toCurl, withPassport } from './adapters/index.mjs';
-import { StorageAdapter } from './storage/index.mjs';
-export { JSONFileStorage, JSONFileStorageOptions, MemoryStorage, MemoryStorageOptions } from './storage/index.mjs';
-import { L as LocaleProfile } from './shared/device-passport.C_F1vBE8.mjs';
-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.mjs';
+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.dVEqzSEb.mjs';
+import { OperatingSystemProfile, HardwareProfile, SupportedPlatform, SupportedArchitecture, SupportedBrowserName, BrandVersion, UserAgentClientHints, PassportGeneratorOptions, DevicePassport } from './types/index.mjs';
+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.mjs';
 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.mjs';
+export { CANONICAL_HEADER_ORDER, PassportLike, applyCdpPassport, formatCanonicalHeaders, getCdpPlan, toCurl, withPassport } from './adapters/index.mjs';
+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.ZBspe4ZW.mjs';
+export { S as StorageAdapter } from './shared/device-passport.DirQmSd4.mjs';
+export { JSONFileStorage, JSONFileStorageOptions, MemoryStorage, MemoryStorageOptions } from './storage/index.mjs';
 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.mjs';
-
-/**
- * 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.mjs';
 
 /**
  * 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 };