jumpy-lion 0.1.6-beta.21 → 0.1.6-beta.24

package/dist/session/inject-hook.js

@@ -0,0 +1,80 @@
+import { log } from 'crawlee';
+import { assertValidBundle } from './types.js';
+/**
+ * Build the script that runs on every new document and replays per-origin
+ * localStorage / sessionStorage. Exported so unit tests can compile it in
+ * isolation and execute it against a JSDOM-like stub.
+ */
+export function buildStorageInjectionScript(localStorageMap, sessionStorageMap) {
+    const localJson = JSON.stringify(localStorageMap);
+    const sessionJson = JSON.stringify(sessionStorageMap);
+    return `(() => {
+  try {
+    var __cdpcrawler_local = ${localJson};
+    var __cdpcrawler_session = ${sessionJson};
+    var __origin;
+    try { __origin = window.location.origin; } catch (e) { return; }
+    var __localValues = __cdpcrawler_local[__origin];
+    if (__localValues) {
+      for (var __k in __localValues) {
+        if (Object.prototype.hasOwnProperty.call(__localValues, __k)) {
+          try { window.localStorage.setItem(__k, __localValues[__k]); } catch (e) {}
+        }
+      }
+    }
+    var __sessionValues = __cdpcrawler_session[__origin];
+    if (__sessionValues) {
+      for (var __k2 in __sessionValues) {
+        if (Object.prototype.hasOwnProperty.call(__sessionValues, __k2)) {
+          try { window.sessionStorage.setItem(__k2, __sessionValues[__k2]); } catch (e) {}
+        }
+      }
+    }
+  } catch (e) { /* swallow — replay is best-effort */ }
+})();`;
+}
+/**
+ * Cookies + per-origin storage injection. Runs once per page; safe to call before
+ * any navigation. Storage replay is registered as `Page.addScriptToEvaluateOnNewDocument`
+ * so it survives in-page redirects and manual reloads, matching the naver-session-test
+ * pattern.
+ */
+export async function installSessionInjectionHook(page, bundle) {
+    assertValidBundle(bundle);
+    if (bundle.cookies.length > 0) {
+        try {
+            await page.setCookies(bundle.cookies);
+            log.debug('[session] Replayed cookies', { count: bundle.cookies.length });
+        }
+        catch (err) {
+            log.warning('[session] Failed to replay cookies', { err: err.message });
+        }
+    }
+    const hasStorage = Object.keys(bundle.localStorage).length > 0
+        || Object.keys(bundle.sessionStorage).length > 0;
+    if (hasStorage) {
+        try {
+            await page.ensurePageEnabled();
+            const script = buildStorageInjectionScript(bundle.localStorage, bundle.sessionStorage);
+            await page.client.Page.addScriptToEvaluateOnNewDocument({ source: script });
+            log.debug('[session] Registered per-origin storage replay script', {
+                localOrigins: Object.keys(bundle.localStorage).length,
+                sessionOrigins: Object.keys(bundle.sessionStorage).length,
+            });
+        }
+        catch (err) {
+            log.warning('[session] Failed to register storage replay script', { err: err.message });
+        }
+    }
+}
+/**
+ * Manual restore entry point — restores cookies + storage on an arbitrary page,
+ * for advanced users opening extra targets and wanting them to carry the same
+ * web state. The user-data-dir and fingerprintConfig sides of a bundle are
+ * applied at launch time (via launchOptions.sessionBundle) and cannot be
+ * swapped onto a running browser.
+ */
+export async function restoreSession(page, bundle) {
+    await installSessionInjectionHook(page, bundle);
+}
+//# sourceMappingURL=inject-hook.js.map

package/dist/session/inject-hook.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"inject-hook.js","sourceRoot":"","sources":["../../src/session/inject-hook.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,GAAG,EAAE,MAAM,SAAS,CAAC;AAG9B,OAAO,EAAE,iBAAiB,EAAuC,MAAM,YAAY,CAAC;AAEpF;;;;GAIG;AACH,MAAM,UAAU,2BAA2B,CACvC,eAA2B,EAC3B,iBAA6B;IAE7B,MAAM,SAAS,GAAG,IAAI,CAAC,SAAS,CAAC,eAAe,CAAC,CAAC;IAClD,MAAM,WAAW,GAAG,IAAI,CAAC,SAAS,CAAC,iBAAiB,CAAC,CAAC;IACtD,OAAO;;+BAEoB,SAAS;iCACP,WAAW;;;;;;;;;;;;;;;;;;;;MAoBtC,CAAC;AACP,CAAC;AAED;;;;;GAKG;AACH,MAAM,CAAC,KAAK,UAAU,2BAA2B,CAAC,IAAa,EAAE,MAAqB;IAClF,iBAAiB,CAAC,MAAM,CAAC,CAAC;IAE1B,IAAI,MAAM,CAAC,OAAO,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QAC5B,IAAI,CAAC;YACD,MAAM,IAAI,CAAC,UAAU,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;YACtC,GAAG,CAAC,KAAK,CAAC,4BAA4B,EAAE,EAAE,KAAK,EAAE,MAAM,CAAC,OAAO,CAAC,MAAM,EAAE,CAAC,CAAC;QAC9E,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACX,GAAG,CAAC,OAAO,CAAC,oCAAoC,EAAE,EAAE,GAAG,EAAG,GAAa,CAAC,OAAO,EAAE,CAAC,CAAC;QACvF,CAAC;IACL,CAAC;IAED,MAAM,UAAU,GAAG,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,YAAY,CAAC,CAAC,MAAM,GAAG,CAAC;WACvD,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,cAAc,CAAC,CAAC,MAAM,GAAG,CAAC,CAAC;IAErD,IAAI,UAAU,EAAE,CAAC;QACb,IAAI,CAAC;YACD,MAAM,IAAI,CAAC,iBAAiB,EAAE,CAAC;YAC/B,MAAM,MAAM,GAAG,2BAA2B,CAAC,MAAM,CAAC,YAAY,EAAE,MAAM,CAAC,cAAc,CAAC,CAAC;YACvF,MAAM,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,gCAAgC,CAAC,EAAE,MAAM,EAAE,MAAM,EAAE,CAAC,CAAC;YAC5E,GAAG,CAAC,KAAK,CAAC,uDAAuD,EAAE;gBAC/D,YAAY,EAAE,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,YAAY,CAAC,CAAC,MAAM;gBACrD,cAAc,EAAE,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,cAAc,CAAC,CAAC,MAAM;aAC5D,CAAC,CAAC;QACP,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACX,GAAG,CAAC,OAAO,CAAC,oDAAoD,EAAE,EAAE,GAAG,EAAG,GAAa,CAAC,OAAO,EAAE,CAAC,CAAC;QACvG,CAAC;IACL,CAAC;AACL,CAAC;AAED;;;;;;GAMG;AACH,MAAM,CAAC,KAAK,UAAU,cAAc,CAAC,IAAa,EAAE,MAAqB;IACrE,MAAM,2BAA2B,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;AACpD,CAAC"}

package/dist/session/save.d.ts

@@ -0,0 +1,21 @@
+import type CdpPage from '../page.js';
+import { type SessionBundle, type SessionBundleProxyMeta } from './types.js';
+export interface SaveSessionOptions {
+    /** Capture and inline the Chrome user-data-dir as a gzipped tar. Default: true. */
+    includeUserDataDir?: boolean;
+    /** Call Storage.flushBrowserCookies before snapshotting cookies. Default: true. */
+    flushCookies?: boolean;
+    /** Override the user-data-dir path; defaults to the path the browser was launched with. */
+    userDataDirPath?: string;
+    /** URLs forwarded to Network.getCookies when Storage.getCookies is unavailable. Default: all cookies. */
+    cookieUrls?: string[];
+    /** Proxy metadata to stamp on the bundle for diagnostics (not replayed on restore). */
+    proxyMeta?: SessionBundleProxyMeta;
+}
+/**
+ * Capture a SessionBundle from a running CdpPage. Bundle is a single JSON-serializable
+ * value suitable for storage in an Apify KV store; pass it back via
+ * `launchOptions.sessionBundle` on a new crawler to reproduce the same browser state.
+ */
+export declare function saveSession(page: CdpPage, options?: SaveSessionOptions): Promise<SessionBundle>;
+//# sourceMappingURL=save.d.ts.map

package/dist/session/save.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"save.d.ts","sourceRoot":"","sources":["../../src/session/save.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,OAAO,MAAM,YAAY,CAAC;AAGtC,OAAO,EAEH,KAAK,aAAa,EAGlB,KAAK,sBAAsB,EAE9B,MAAM,YAAY,CAAC;AAEpB,MAAM,WAAW,kBAAkB;IAC/B,mFAAmF;IACnF,kBAAkB,CAAC,EAAE,OAAO,CAAC;IAC7B,mFAAmF;IACnF,YAAY,CAAC,EAAE,OAAO,CAAC;IACvB,2FAA2F;IAC3F,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,yGAAyG;IACzG,UAAU,CAAC,EAAE,MAAM,EAAE,CAAC;IACtB,uFAAuF;IACvF,SAAS,CAAC,EAAE,sBAAsB,CAAC;CACtC;AA6FD;;;;GAIG;AACH,wBAAsB,WAAW,CAAC,IAAI,EAAE,OAAO,EAAE,OAAO,GAAE,kBAAuB,GAAG,OAAO,CAAC,aAAa,CAAC,CAkFzG"}

package/dist/session/save.js

@@ -0,0 +1,163 @@
+import { log } from 'crawlee';
+import { tarUserDataDir } from './tar-data-dir.js';
+import { SCHEMA_VERSION, } from './types.js';
+function originOf(url) {
+    try {
+        return new URL(url).origin;
+    }
+    catch {
+        return '';
+    }
+}
+async function collectCookies(page, urls) {
+    // Storage.getCookies returns cookies across the whole browser, which is what we want
+    // when the user has visited multiple origins. Fall back to Network.getCookies (page-scoped).
+    try {
+        const { Storage } = page.client;
+        if (Storage?.getCookies) {
+            const result = await Storage.getCookies();
+            return result.cookies ?? [];
+        }
+    }
+    catch (err) {
+        log.debug('[session] Storage.getCookies failed, falling back to Network.getCookies', { err: err.message });
+    }
+    return page.getCookies(urls);
+}
+async function collectStorage(page) {
+    const pageUrl = await page.evaluate(() => window.location.href);
+    const origin = originOf(pageUrl);
+    if (!origin) {
+        return { localStorage: {}, sessionStorage: {} };
+    }
+    const result = await page.evaluate(() => {
+        const local = {};
+        const session = {};
+        for (let i = 0; i < window.localStorage.length; i++) {
+            const k = window.localStorage.key(i);
+            if (k != null)
+                local[k] = window.localStorage.getItem(k) ?? '';
+        }
+        for (let i = 0; i < window.sessionStorage.length; i++) {
+            const k = window.sessionStorage.key(i);
+            if (k != null)
+                session[k] = window.sessionStorage.getItem(k) ?? '';
+        }
+        return { local, session };
+    });
+    return {
+        localStorage: Object.keys(result.local).length ? { [origin]: result.local } : {},
+        sessionStorage: Object.keys(result.session).length ? { [origin]: result.session } : {},
+    };
+}
+async function collectBrowserProfile(page) {
+    const profile = await page.evaluate(() => {
+        let webglRenderer = '';
+        let webglVendor = '';
+        try {
+            const canvas = document.createElement('canvas');
+            const gl = canvas.getContext('webgl');
+            if (gl) {
+                const dbg = gl.getExtension('WEBGL_debug_renderer_info');
+                if (dbg) {
+                    webglRenderer = gl.getParameter(dbg.UNMASKED_RENDERER_WEBGL) ?? '';
+                    webglVendor = gl.getParameter(dbg.UNMASKED_VENDOR_WEBGL) ?? '';
+                }
+            }
+        }
+        catch { /* WebGL may be blocked; leave empty */ }
+        return {
+            userAgent: navigator.userAgent,
+            platform: navigator.platform,
+            language: navigator.language,
+            screenWidth: window.screen.width,
+            screenHeight: window.screen.height,
+            devicePixelRatio: window.devicePixelRatio,
+            webglRenderer,
+            webglVendor,
+        };
+    });
+    return profile;
+}
+function readPackageVersion() {
+    // Pulled from package.json at compile time would require tooling; reading it at
+    // runtime keeps things simple and ESM-safe. Falls back gracefully.
+    try {
+        return process.env.npm_package_version ?? '0.0.0';
+    }
+    catch {
+        return '0.0.0';
+    }
+}
+/**
+ * Capture a SessionBundle from a running CdpPage. Bundle is a single JSON-serializable
+ * value suitable for storage in an Apify KV store; pass it back via
+ * `launchOptions.sessionBundle` on a new crawler to reproduce the same browser state.
+ */
+export async function saveSession(page, options = {}) {
+    const { includeUserDataDir = true, flushCookies = true, userDataDirPath, cookieUrls, proxyMeta, } = options;
+    const snapshot = page.getLaunchSnapshot();
+    if (!snapshot.fingerprintConfig) {
+        throw new Error('saveSession: fingerprintConfig is missing from the page launch snapshot. '
+            + 'Ensure the crawler was launched with useNativeStealth and that the page came from the CDPBrowserController.');
+    }
+    if (!snapshot.fingerprint) {
+        throw new Error('saveSession: fingerprint is missing from the page launch snapshot.');
+    }
+    if (!snapshot.resolvedLocale) {
+        throw new Error('saveSession: resolvedLocale is missing from the page launch snapshot.');
+    }
+    if (flushCookies) {
+        try {
+            await page.client
+                .Storage.flushBrowserCookies();
+        }
+        catch (err) {
+            log.debug('[session] Storage.flushBrowserCookies unavailable', { err: err.message });
+        }
+    }
+    const [cookies, storage, browserProfile] = await Promise.all([
+        collectCookies(page, cookieUrls),
+        collectStorage(page),
+        collectBrowserProfile(page),
+    ]);
+    let userDataDir = null;
+    if (includeUserDataDir) {
+        const dirPath = userDataDirPath ?? snapshot.userDataDir;
+        if (dirPath) {
+            userDataDir = await tarUserDataDir(dirPath);
+            if (!userDataDir) {
+                log.warning('[session] userDataDir path did not exist or was unreadable', { dirPath });
+            }
+        }
+        else {
+            log.warning('[session] includeUserDataDir was requested but no userDataDir path was recorded on the page snapshot');
+        }
+    }
+    const fpOpts = (snapshot.fingerprintOptions ?? {});
+    const fingerprintInput = {
+        ...fpOpts,
+        locale: typeof fpOpts.locale === 'string' ? fpOpts.locale : snapshot.resolvedLocale.locale,
+        languages: typeof fpOpts.languages === 'string' ? fpOpts.languages : snapshot.resolvedLocale.languages,
+        timezone: typeof fpOpts.timezone === 'string' ? fpOpts.timezone : snapshot.resolvedLocale.timezone,
+        platform: typeof fpOpts.platform === 'string' ? fpOpts.platform : undefined,
+        seedKey: typeof fpOpts.seedKey === 'string' ? fpOpts.seedKey : undefined,
+        useNonApifyFingerprints: false,
+    };
+    return {
+        schemaVersion: SCHEMA_VERSION,
+        createdAt: new Date().toISOString(),
+        createdBy: { package: 'cdp-crawler', version: readPackageVersion() },
+        cookies,
+        localStorage: storage.localStorage,
+        sessionStorage: storage.sessionStorage,
+        userDataDir,
+        fingerprintConfig: snapshot.fingerprintConfig,
+        fingerprint: snapshot.fingerprint,
+        fingerprintInput,
+        resolvedLocale: snapshot.resolvedLocale,
+        browserProfile,
+        proxyMeta: proxyMeta ?? (snapshot.proxyUrl ? { proxyUrl: snapshot.proxyUrl } : undefined),
+    };
+}
+//# sourceMappingURL=save.js.map

package/dist/session/save.js.map

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

package/dist/session/tar-data-dir.d.ts

@@ -0,0 +1,13 @@
+import type { SessionBundleUserDataDir } from './types.js';
+/**
+ * Pack a Chrome user-data-dir into a base64-encoded gzipped tar suitable for
+ * inclusion inside a JSON session bundle. Returns null when the directory does
+ * not exist (caller's choice whether to treat that as fatal).
+ */
+export declare function tarUserDataDir(dirPath: string): Promise<SessionBundleUserDataDir | null>;
+/**
+ * Extract a previously captured user-data-dir blob into destPath. Caller is
+ * responsible for ensuring destPath is empty (or will be merged into).
+ */
+export declare function untarUserDataDir(payload: SessionBundleUserDataDir, destPath: string): Promise<void>;
+//# sourceMappingURL=tar-data-dir.d.ts.map

package/dist/session/tar-data-dir.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tar-data-dir.d.ts","sourceRoot":"","sources":["../../src/session/tar-data-dir.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EAAE,wBAAwB,EAAE,MAAM,YAAY,CAAC;AAmD3D;;;;GAIG;AACH,wBAAsB,cAAc,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,wBAAwB,GAAG,IAAI,CAAC,CAkC9F;AAED;;;GAGG;AACH,wBAAsB,gBAAgB,CAAC,OAAO,EAAE,wBAAwB,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAYzG"}

package/dist/session/tar-data-dir.js

@@ -0,0 +1,107 @@
+import { Buffer } from 'buffer';
+import { promises as fs } from 'fs';
+import path from 'path';
+import * as tar from 'tar';
+/**
+ * Files / subpaths we never include in the bundled tar. These are either
+ * process-bound singletons (which break restore on a new Chrome instance) or
+ * regenerable caches whose absence costs nothing on restore.
+ */
+const ALWAYS_SKIP_PATTERNS = [
+    /(^|\/)SingletonCookie$/,
+    /(^|\/)SingletonLock$/,
+    /(^|\/)SingletonSocket$/,
+    /(^|\/)LOCK$/,
+    /(^|\/)CrashpadMetrics-.*$/,
+    /(^|\/)Crashpad(\/|$)/,
+    /(^|\/)BrowserMetrics(\/|$)/,
+    /(^|\/)GrShaderCache(\/|$)/,
+    /(^|\/)ShaderCache(\/|$)/,
+    /(^|\/)GraphiteDawnCache(\/|$)/,
+    /(^|\/)GPUCache(\/|$)/,
+    /(^|\/)Code Cache(\/|$)/,
+    /(^|\/)component_crx_cache(\/|$)/,
+    /\.tmp$/,
+];
+function shouldSkip(relPath) {
+    return ALWAYS_SKIP_PATTERNS.some((p) => (typeof p === 'string' ? relPath === p : p.test(relPath)));
+}
+async function countFiles(root) {
+    let count = 0;
+    async function walk(dir, rel) {
+        let entries;
+        try {
+            entries = await fs.readdir(dir, { withFileTypes: true });
+        }
+        catch {
+            return;
+        }
+        for (const e of entries) {
+            const childRel = rel ? `${rel}/${e.name}` : e.name;
+            if (shouldSkip(childRel))
+                continue;
+            if (e.isDirectory()) {
+                await walk(path.join(dir, e.name), childRel);
+            }
+            else if (e.isFile()) {
+                count++;
+            }
+        }
+    }
+    await walk(root, '');
+    return count;
+}
+/**
+ * Pack a Chrome user-data-dir into a base64-encoded gzipped tar suitable for
+ * inclusion inside a JSON session bundle. Returns null when the directory does
+ * not exist (caller's choice whether to treat that as fatal).
+ */
+export async function tarUserDataDir(dirPath) {
+    try {
+        const st = await fs.stat(dirPath);
+        if (!st.isDirectory())
+            return null;
+    }
+    catch {
+        return null;
+    }
+    const capturedFiles = await countFiles(dirPath);
+    const chunks = [];
+    await new Promise((resolve, reject) => {
+        const stream = tar.create({
+            gzip: true,
+            cwd: dirPath,
+            portable: true,
+            follow: false,
+            filter: (p) => !shouldSkip(p.replace(/^\.?\//, '')),
+        }, ['.']);
+        stream.on('data', (chunk) => chunks.push(chunk));
+        stream.on('end', () => resolve());
+        stream.on('error', reject);
+    });
+    const buf = Buffer.concat(chunks);
+    return {
+        encoding: 'base64+gzip+tar',
+        bytes: buf.toString('base64'),
+        sizeBytes: buf.length,
+        capturedFiles,
+    };
+}
+/**
+ * Extract a previously captured user-data-dir blob into destPath. Caller is
+ * responsible for ensuring destPath is empty (or will be merged into).
+ */
+export async function untarUserDataDir(payload, destPath) {
+    if (payload.encoding !== 'base64+gzip+tar') {
+        throw new Error(`Unsupported userDataDir encoding: ${payload.encoding}`);
+    }
+    await fs.mkdir(destPath, { recursive: true });
+    const buf = Buffer.from(payload.bytes, 'base64');
+    await new Promise((resolve, reject) => {
+        const extractor = tar.extract({ cwd: destPath, strip: 0 });
+        extractor.on('finish', () => resolve());
+        extractor.on('error', reject);
+        extractor.end(buf);
+    });
+}
+//# sourceMappingURL=tar-data-dir.js.map

package/dist/session/tar-data-dir.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tar-data-dir.js","sourceRoot":"","sources":["../../src/session/tar-data-dir.ts"],"names":[],"mappings":"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"}

package/dist/session/types.d.ts

@@ -0,0 +1,80 @@
+import type { BrowserFingerprintWithHeaders } from 'fingerprint-generator';
+import type { FingerprintConfigJson } from '../browser-process/anti-detect-config.js';
+import type { ResolvedLocale } from '../fingerprinting/locale-resolver.js';
+import type { Cookie } from '../page.js';
+export declare const SCHEMA_VERSION: 1;
+/**
+ * Snapshot of launch-time inputs that saveSession() needs to read off a CdpPage
+ * to assemble a bundle. Populated by CDPBrowserController before handing the
+ * page to user code, so saveSession is a pure call against the page surface.
+ */
+export interface LaunchSnapshot {
+    fingerprintConfig?: FingerprintConfigJson;
+    fingerprintOptions?: Record<string, unknown>;
+    resolvedLocale?: ResolvedLocale;
+    fingerprint?: BrowserFingerprintWithHeaders;
+    userDataDir?: string;
+    proxyUrl?: string;
+    /** Set when the page was launched from a previously-saved bundle. */
+    sessionBundle?: SessionBundle;
+}
+/**
+ * Cookie shape as accepted by CDP `Network.setCookie`. Aliased to the Cookie
+ * already used across CdpPage so save/restore round-trips byte-for-byte.
+ */
+export type SerializedCookie = Cookie;
+/** Origin → key-value map for localStorage / sessionStorage. */
+export type StorageMap = Record<string, Record<string, string>>;
+export interface SessionBundleUserDataDir {
+    encoding: 'base64+gzip+tar';
+    bytes: string;
+    sizeBytes: number;
+    capturedFiles: number;
+}
+export interface SessionBundleBrowserProfile {
+    userAgent: string;
+    platform: string;
+    language: string;
+    screenWidth: number;
+    screenHeight: number;
+    devicePixelRatio: number;
+    webglRenderer: string;
+    webglVendor: string;
+}
+export interface SessionBundleFingerprintInput {
+    locale?: string;
+    languages?: string;
+    timezone?: string;
+    platform?: string;
+    seedKey?: string;
+    /** Pinned on restore so the captured fingerprintConfig is not regenerated. */
+    useNonApifyFingerprints: false;
+    /** Any other fingerprintOptions keys carried through verbatim. */
+    [key: string]: unknown;
+}
+export interface SessionBundleProxyMeta {
+    proxyUrl?: string;
+    sessionId?: string;
+    countryCode?: string;
+}
+export interface SessionBundle {
+    schemaVersion: typeof SCHEMA_VERSION;
+    createdAt: string;
+    createdBy?: {
+        package: 'cdp-crawler';
+        version: string;
+    };
+    cookies: SerializedCookie[];
+    localStorage: StorageMap;
+    sessionStorage: StorageMap;
+    userDataDir: SessionBundleUserDataDir | null;
+    fingerprintConfig: FingerprintConfigJson;
+    fingerprint: BrowserFingerprintWithHeaders;
+    fingerprintInput: SessionBundleFingerprintInput;
+    resolvedLocale: ResolvedLocale;
+    browserProfile: SessionBundleBrowserProfile;
+    proxyMeta?: SessionBundleProxyMeta;
+}
+/** Runtime guard so a hand-edited / partial bundle fails fast with a clear message. */
+export declare function assertValidBundle(value: unknown): asserts value is SessionBundle;
+//# sourceMappingURL=types.d.ts.map

package/dist/session/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/session/types.ts"],"names":[],"mappings":"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"}

package/dist/session/types.js

@@ -0,0 +1,29 @@
+export const SCHEMA_VERSION = 1;
+/** Runtime guard so a hand-edited / partial bundle fails fast with a clear message. */
+export function assertValidBundle(value) {
+    if (!value || typeof value !== 'object') {
+        throw new Error('Invalid session bundle: expected an object');
+    }
+    const b = value;
+    if (b.schemaVersion !== SCHEMA_VERSION) {
+        throw new Error(`Unsupported session bundle schemaVersion: ${String(b.schemaVersion)} (expected ${SCHEMA_VERSION})`);
+    }
+    for (const key of ['cookies', 'localStorage', 'sessionStorage', 'fingerprintConfig', 'fingerprint', 'fingerprintInput', 'resolvedLocale', 'browserProfile']) {
+        if (b[key] === undefined || b[key] === null) {
+            throw new Error(`Invalid session bundle: missing required key "${key}"`);
+        }
+    }
+    if (!Array.isArray(b.cookies)) {
+        throw new Error('Invalid session bundle: "cookies" must be an array');
+    }
+    if (b.userDataDir !== null && typeof b.userDataDir !== 'object') {
+        throw new Error('Invalid session bundle: "userDataDir" must be an object or null');
+    }
+    if (b.userDataDir) {
+        const u = b.userDataDir;
+        if (u.encoding !== 'base64+gzip+tar' || typeof u.bytes !== 'string') {
+            throw new Error('Invalid session bundle: malformed userDataDir payload');
+        }
+    }
+}
+//# sourceMappingURL=types.js.map

package/dist/session/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/session/types.ts"],"names":[],"mappings":"AAMA,MAAM,CAAC,MAAM,cAAc,GAAG,CAAU,CAAC;AAoFzC,uFAAuF;AACvF,MAAM,UAAU,iBAAiB,CAAC,KAAc;IAC5C,IAAI,CAAC,KAAK,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;QACtC,MAAM,IAAI,KAAK,CAAC,4CAA4C,CAAC,CAAC;IAClE,CAAC;IACD,MAAM,CAAC,GAAG,KAAgC,CAAC;IAC3C,IAAI,CAAC,CAAC,aAAa,KAAK,cAAc,EAAE,CAAC;QACrC,MAAM,IAAI,KAAK,CACX,6CAA6C,MAAM,CAAC,CAAC,CAAC,aAAa,CAAC,cAAc,cAAc,GAAG,CACtG,CAAC;IACN,CAAC;IACD,KAAK,MAAM,GAAG,IAAI,CAAC,SAAS,EAAE,cAAc,EAAE,gBAAgB,EAAE,mBAAmB,EAAE,aAAa,EAAE,kBAAkB,EAAE,gBAAgB,EAAE,gBAAgB,CAAU,EAAE,CAAC;QACnK,IAAI,CAAC,CAAC,GAAG,CAAC,KAAK,SAAS,IAAI,CAAC,CAAC,GAAG,CAAC,KAAK,IAAI,EAAE,CAAC;YAC1C,MAAM,IAAI,KAAK,CAAC,iDAAiD,GAAG,GAAG,CAAC,CAAC;QAC7E,CAAC;IACL,CAAC;IACD,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,OAAO,CAAC,EAAE,CAAC;QAC5B,MAAM,IAAI,KAAK,CAAC,oDAAoD,CAAC,CAAC;IAC1E,CAAC;IACD,IAAI,CAAC,CAAC,WAAW,KAAK,IAAI,IAAI,OAAO,CAAC,CAAC,WAAW,KAAK,QAAQ,EAAE,CAAC;QAC9D,MAAM,IAAI,KAAK,CAAC,iEAAiE,CAAC,CAAC;IACvF,CAAC;IACD,IAAI,CAAC,CAAC,WAAW,EAAE,CAAC;QAChB,MAAM,CAAC,GAAG,CAAC,CAAC,WAAsC,CAAC;QACnD,IAAI,CAAC,CAAC,QAAQ,KAAK,iBAAiB,IAAI,OAAO,CAAC,CAAC,KAAK,KAAK,QAAQ,EAAE,CAAC;YAClE,MAAM,IAAI,KAAK,CAAC,uDAAuD,CAAC,CAAC;QAC7E,CAAC;IACL,CAAC;AACL,CAAC"}