device-passport 1.1.0 → 1.2.0

package/dist/index.cjs

@@ -1,425 +1,16 @@
 'use strict';
 
-const cdp = require('./shared/device-passport.CLaBZWUV.cjs');
-const evaluator_index = require('./evaluator/index.cjs');
-const memory = require('./shared/device-passport.Cjxlv8xI.cjs');
+const bridge = require('./shared/device-passport.qL4tjwc0.cjs');
+const cdp = require('./shared/device-passport.D9xW6R0B.cjs');
 const geo_index = require('./geo/index.cjs');
-const aligner = require('./shared/device-passport.BPd2-w8e.cjs');
+const memory = require('./shared/device-passport.Cjxlv8xI.cjs');
+const evaluator_index = require('./evaluator/index.cjs');
+const aligner = require('./shared/device-passport.BKtmLzPt.cjs');
+const entropy = require('./shared/device-passport.EK4RX7Xd.cjs');
 require('node:crypto');
 require('node:fs');
 require('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 cdp.formatCanonicalHeaders(this.profile.headers, overrides);
-  }
-  /**
-   * Returns a higher-order fetch function wrapping standard fetch with this passport's canonical persona.
-   */
-  wrapFetch(customFetch) {
-    return cdp.withPassport(this, customFetch);
-  }
-  /**
-   * Alias for wrapFetch.
-   */
-  withPassport(customFetch) {
-    return cdp.withPassport(this, customFetch);
-  }
-  /**
-   * Generates a copy-pasteable cURL command with correct browser headers and User-Agent.
-   */
-  toCurl(url, options) {
-    return cdp.toCurl(this, url, options);
-  }
-  // ==========================================
-  // Heavyweight Browser Automation Adapters
-  // ==========================================
-  /**
-   * Generates Playwright BrowserContext options.
-   * Usage:
-   * ```ts
-   * const context = await browser.newContext(passport.getPlaywrightContext());
-   * ```
-   */
-  getPlaywrightContext() {
-    return cdp.getPlaywrightContext(this.profile);
-  }
-  /**
-   * Returns Puppeteer launch args and page emulation parameters.
-   */
-  getPuppeteerArgs() {
-    return cdp.getPuppeteerArgs(this.profile);
-  }
-  /**
-   * Generates an in-page stealth script to patch runtime JavaScript APIs
-   * (navigator.webdriver, hardwareConcurrency, deviceMemory, WebGL, Client Hints).
-   */
-  getStealthScript() {
-    return cdp.getStealthScript(this.profile);
-  }
-  /**
-   * Injects stealth scripts and extra HTTP headers into a Playwright BrowserContext.
-   */
-  async applyToPlaywright(context) {
-    await cdp.applyToPlaywrightContext(context, this.profile);
-  }
-  /**
-   * Injects stealth scripts and emulation parameters into a Puppeteer Page.
-   */
-  async applyToPuppeteer(page) {
-    await cdp.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 = evaluator_index.detectAllContradictions(this.profile);
-      let estimatedBits = 48;
-      let collisionRisk = "very_low";
-      try {
-        const entropy = evaluator_index.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 memory.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 = cdp.generatePassport(options);
-    if (storage.setSync) {
-      storage.setSync(options.seed, generated2);
-    } else {
-      storage.set(options.seed, generated2).catch(() => {
-      });
-    }
-    return new DevicePassportInstance(generated2);
-  }
-  const generated = cdp.generatePassport(options);
-  return new DevicePassportInstance(generated);
-}
-
-class PassportManager {
-  storage;
-  defaultGeo;
-  defaultOS;
-  defaultBrowser;
-  generator;
-  constructor(options) {
-    if (typeof options?.store === "string") {
-      this.storage = new memory.JSONFileStorage(options.store);
-    } else if (options?.store && typeof options.store.get === "function") {
-      this.storage = options.store;
-    } else {
-      this.storage = new memory.MemoryStorage();
-    }
-    this.defaultGeo = options?.defaultGeo ?? "US";
-    this.defaultOS = options?.defaultOS;
-    this.defaultBrowser = options?.defaultBrowser;
-    this.generator = options?.generator ?? cdp.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,6 +383,18 @@ function formatComparativeMatrixJSON() {
 
 const VERSION = "1.0.0";
 
+exports.AccountProfileManager = bridge.AccountProfileManager;
+exports.DevicePassportInstance = bridge.DevicePassportInstance;
+exports.PROXY_MISSING_NOTE = bridge.PROXY_MISSING_NOTE;
+exports.PROXY_RESOLUTION_NOTE = bridge.PROXY_RESOLUTION_NOTE;
+exports.PassportManager = bridge.PassportManager;
+exports.buildEgoSessionPlan = bridge.buildEgoSessionPlan;
+exports.buildProxyDeclaration = bridge.buildProxyDeclaration;
+exports.createEgoBridge = bridge.createEgoBridge;
+exports.createPassport = bridge.createPassport;
+exports.defaultTaskSpaceName = bridge.defaultTaskSpaceName;
+exports.getEgoNativeBridge = bridge.getEgoNativeBridge;
+exports.getProfileReadiness = bridge.getProfileReadiness;
 exports.ALL_PRESETS = cdp.ALL_PRESETS;
 exports.CANONICAL_HEADER_ORDER = cdp.CANONICAL_HEADER_ORDER;
 exports.CHROME_VERSIONS = cdp.CHROME_VERSIONS;
@@ -825,34 +428,16 @@ exports.parseStructuredBrandList = cdp.parseStructuredBrandList;
 exports.toCurl = cdp.toCurl;
 exports.validateHardwareContradictions = cdp.validateHardwareContradictions;
 exports.withPassport = cdp.withPassport;
-exports.BASELINE_OPTIMAL_ENTROPY = evaluator_index.BASELINE_OPTIMAL_ENTROPY;
-exports.BROWSER_BASELINE_FREQUENCIES = evaluator_index.BROWSER_BASELINE_FREQUENCIES;
-exports.COUNTRY_PRIMARY_LANGUAGES = evaluator_index.COUNTRY_PRIMARY_LANGUAGES;
-exports.COUNTRY_TIMEZONE_MAP = evaluator_index.COUNTRY_TIMEZONE_MAP;
-exports.MIN_STRUCTURAL_ENTROPY = evaluator_index.MIN_STRUCTURAL_ENTROPY;
-exports.OPTIMAL_CHAR_ENTROPY_MAX = evaluator_index.OPTIMAL_CHAR_ENTROPY_MAX;
-exports.OPTIMAL_CHAR_ENTROPY_MIN = evaluator_index.OPTIMAL_CHAR_ENTROPY_MIN;
-exports.OPTIMAL_ENTROPY_MAX = evaluator_index.OPTIMAL_ENTROPY_MAX;
-exports.OPTIMAL_ENTROPY_MIN = evaluator_index.OPTIMAL_ENTROPY_MIN;
-exports.analyzeHeaderEntropy = evaluator_index.analyzeHeaderEntropy;
-exports.calculateKLDivergence = evaluator_index.calculateKLDivergence;
-exports.calculateShannonEntropy = evaluator_index.calculateShannonEntropy;
-exports.calculateStructuralEntropy = evaluator_index.calculateStructuralEntropy;
-exports.detectAllContradictions = evaluator_index.detectAllContradictions;
-exports.detectClientHintsContradictions = evaluator_index.detectClientHintsContradictions;
-exports.detectGeoChronoContradictions = evaluator_index.detectGeoChronoContradictions;
-exports.detectHardwareContradictions = evaluator_index.detectHardwareContradictions;
-exports.detectOSBrowserContradictions = evaluator_index.detectOSBrowserContradictions;
-exports.evaluateCoherence = evaluator_index.evaluateCoherence;
-exports.evaluateGeoAlignment = evaluator_index.evaluateGeoAlignment;
-exports.evaluatePassport = evaluator_index.evaluatePassport;
-exports.JSONFileStorage = memory.JSONFileStorage;
-exports.MemoryStorage = memory.MemoryStorage;
 exports.GEO_LOCALES = geo_index.GEO_LOCALES;
 exports.TIMEZONE_MATRIX = geo_index.TIMEZONE_MATRIX;
 exports.detectGeoFromUrl = geo_index.detectGeoFromUrl;
 exports.getLocaleProfile = geo_index.getLocaleProfile;
 exports.isValidCountryCode = geo_index.isValidCountryCode;
+exports.JSONFileStorage = memory.JSONFileStorage;
+exports.MemoryStorage = memory.MemoryStorage;
+exports.evaluateCoherence = evaluator_index.evaluateCoherence;
+exports.evaluateGeoAlignment = evaluator_index.evaluateGeoAlignment;
+exports.evaluatePassport = evaluator_index.evaluatePassport;
 exports.ALPHA3_TO_ALPHA2 = aligner.ALPHA3_TO_ALPHA2;
 exports.COUNTRY_LOCALES = aligner.COUNTRY_LOCALES;
 exports.COUNTRY_NAME_TO_CODE = aligner.COUNTRY_NAME_TO_CODE;
@@ -880,12 +465,27 @@ exports.normalizeCountryCode = aligner.normalizeCountryCode;
 exports.parseAcceptLanguage = aligner.parseAcceptLanguage;
 exports.toGeoLocation = aligner.toGeoLocation;
 exports.toLocaleProfile = aligner.toLocaleProfile;
+exports.BASELINE_OPTIMAL_ENTROPY = entropy.BASELINE_OPTIMAL_ENTROPY;
+exports.BROWSER_BASELINE_FREQUENCIES = entropy.BROWSER_BASELINE_FREQUENCIES;
+exports.COUNTRY_PRIMARY_LANGUAGES = entropy.COUNTRY_PRIMARY_LANGUAGES;
+exports.COUNTRY_TIMEZONE_MAP = entropy.COUNTRY_TIMEZONE_MAP;
+exports.MIN_STRUCTURAL_ENTROPY = entropy.MIN_STRUCTURAL_ENTROPY;
+exports.OPTIMAL_CHAR_ENTROPY_MAX = entropy.OPTIMAL_CHAR_ENTROPY_MAX;
+exports.OPTIMAL_CHAR_ENTROPY_MIN = entropy.OPTIMAL_CHAR_ENTROPY_MIN;
+exports.OPTIMAL_ENTROPY_MAX = entropy.OPTIMAL_ENTROPY_MAX;
+exports.OPTIMAL_ENTROPY_MIN = entropy.OPTIMAL_ENTROPY_MIN;
+exports.analyzeHeaderEntropy = entropy.analyzeHeaderEntropy;
+exports.calculateKLDivergence = entropy.calculateKLDivergence;
+exports.calculateShannonEntropy = entropy.calculateShannonEntropy;
+exports.calculateStructuralEntropy = entropy.calculateStructuralEntropy;
+exports.detectAllContradictions = entropy.detectAllContradictions;
+exports.detectClientHintsContradictions = entropy.detectClientHintsContradictions;
+exports.detectGeoChronoContradictions = entropy.detectGeoChronoContradictions;
+exports.detectHardwareContradictions = entropy.detectHardwareContradictions;
+exports.detectOSBrowserContradictions = entropy.detectOSBrowserContradictions;
 exports.BENCHMARK_METRICS_METADATA = BENCHMARK_METRICS_METADATA;
 exports.COMPARATIVE_DATASET = COMPARATIVE_DATASET;
-exports.DevicePassportInstance = DevicePassportInstance;
-exports.PassportManager = PassportManager;
 exports.VERSION = VERSION;
-exports.createPassport = createPassport;
 exports.formatComparativeMatrixJSON = formatComparativeMatrixJSON;
 exports.formatComparativeMatrixLaTeX = formatComparativeMatrixLaTeX;
 exports.formatComparativeMatrixMarkdown = formatComparativeMatrixMarkdown;