@proxyshard/shardx 0.1.1

package/dist/browser.js.map

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

package/dist/geo.d.ts

@@ -0,0 +1,24 @@
+import type { ParsedProxy } from "./proxy.js";
+export type GeoProvider = "ip-api.com" | "ipapi.co" | "ipwho.is";
+export interface GeoInfo {
+    ip: string;
+    country: string;
+    /** ISO-3166 alpha-2. */
+    countryCode: string;
+    region: string;
+    city: string;
+    isp: string;
+    /** IANA. */
+    timezone: string;
+    latitude: number;
+    longitude: number;
+    provider: string;
+    /** Comma-separated ISO-639-1; only ipapi.co populates it. */
+    languages?: string;
+}
+/**
+ * Probe the geo `proxy` exits at, or direct geo when `proxy` is null.
+ * Throws on network error or provider-level fail (e.g. ip-api.com status=fail).
+ */
+export declare function geoCheckVia(proxy: ParsedProxy | null, provider?: GeoProvider | string): Promise<GeoInfo>;
+//# sourceMappingURL=geo.d.ts.map

package/dist/geo.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"geo.d.ts","sourceRoot":"","sources":["../src/geo.ts"],"names":[],"mappings":"AAUA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAE9C,MAAM,MAAM,WAAW,GAAG,YAAY,GAAG,UAAU,GAAG,UAAU,CAAC;AAEjE,MAAM,WAAW,OAAO;IACtB,EAAE,EAAE,MAAM,CAAC;IACX,OAAO,EAAE,MAAM,CAAC;IAChB,wBAAwB;IACxB,WAAW,EAAE,MAAM,CAAC;IACpB,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,MAAM,CAAC;IACb,GAAG,EAAE,MAAM,CAAC;IACZ,YAAY;IACZ,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,EAAE,MAAM,CAAC;IACjB,6DAA6D;IAC7D,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAoED;;;GAGG;AACH,wBAAsB,WAAW,CAC/B,KAAK,EAAE,WAAW,GAAG,IAAI,EACzB,QAAQ,GAAE,WAAW,GAAG,MAAqB,GAC5C,OAAO,CAAC,OAAO,CAAC,CA6ClB"}

package/dist/geo.js

@@ -0,0 +1,129 @@
+// Live geo lookup for proxies — mirrors `geo_check_via` in
+// `src-tauri/src/proxy.rs`. Supports the same three providers
+// (ip-api.com / ipapi.co / ipwho.is). HTTP/HTTPS proxies use undici's
+// ProxyAgent; SOCKS5 uses socks-proxy-agent (the only well-supported
+// fetch-compatible SOCKS5 dispatcher in Node land).
+import { ProxyAgent, fetch as undiciFetch } from "undici";
+import { SocksProxyAgent } from "socks-proxy-agent";
+import { request as httpRequest } from "node:http";
+import { request as httpsRequest } from "node:https";
+const URLS = {
+    "ip-api.com": "http://ip-api.com/json/?fields=status,message,query,country,countryCode,regionName,city,isp,timezone,lat,lon",
+    "ipapi.co": "https://ipapi.co/json/",
+    "ipwho.is": "https://ipwho.is/",
+};
+function proxyUrl(p, scheme) {
+    if (p.username || p.password) {
+        const u = encodeURIComponent(p.username ?? "");
+        const pw = encodeURIComponent(p.password ?? "");
+        return `${scheme}://${u}:${pw}@${p.host}:${p.port}`;
+    }
+    return `${scheme}://${p.host}:${p.port}`;
+}
+async function fetchJson(url, proxy, timeoutMs) {
+    const ctl = new AbortController();
+    const timer = setTimeout(() => ctl.abort(), timeoutMs);
+    try {
+        if (!proxy) {
+            const r = await undiciFetch(url, { signal: ctl.signal });
+            if (!r.ok)
+                throw new Error(`geo HTTP ${r.status}`);
+            return await r.json();
+        }
+        if (proxy.scheme === "socks5") {
+            // socks-proxy-agent works with the global fetch on Node 18+
+            // by piggy-backing onto http(s).request via dispatcher fallback.
+            // We hand-roll a request through http/https so we keep dependency
+            // surface small and DNS resolves through the proxy.
+            const agent = new SocksProxyAgent(proxyUrl(proxy, "socks5h"));
+            return await new Promise((resolve, reject) => {
+                const u = new URL(url);
+                const reqFn = u.protocol === "https:" ? httpsRequest : httpRequest;
+                const req = reqFn({
+                    host: u.hostname,
+                    port: u.port || (u.protocol === "https:" ? 443 : 80),
+                    path: u.pathname + u.search,
+                    method: "GET",
+                    agent,
+                    signal: ctl.signal,
+                }, (res) => {
+                    const chunks = [];
+                    res.on("data", (c) => chunks.push(c));
+                    res.on("end", () => {
+                        if (typeof res.statusCode === "number" && (res.statusCode < 200 || res.statusCode >= 300)) {
+                            reject(new Error(`geo HTTP ${res.statusCode}`));
+                            return;
+                        }
+                        try {
+                            resolve(JSON.parse(Buffer.concat(chunks).toString("utf8")));
+                        }
+                        catch (e) {
+                            reject(e);
+                        }
+                    });
+                });
+                req.on("error", reject);
+                req.end();
+            });
+        }
+        // HTTP / HTTPS proxy via undici dispatcher.
+        const dispatcher = new ProxyAgent(proxyUrl(proxy, proxy.scheme));
+        const r = await undiciFetch(url, { signal: ctl.signal, dispatcher });
+        if (!r.ok)
+            throw new Error(`geo HTTP ${r.status}`);
+        return await r.json();
+    }
+    finally {
+        clearTimeout(timer);
+    }
+}
+/**
+ * Probe the geo `proxy` exits at, or direct geo when `proxy` is null.
+ * Throws on network error or provider-level fail (e.g. ip-api.com status=fail).
+ */
+export async function geoCheckVia(proxy, provider = "ip-api.com") {
+    const url = URLS[provider] ?? URLS["ip-api.com"];
+    const body = await fetchJson(url, proxy, 8000);
+    const s = (k) => (typeof body[k] === "string" ? body[k] : "");
+    const f = (k) => {
+        const v = body[k];
+        const n = typeof v === "number" ? v : Number(v);
+        return Number.isFinite(n) ? n : 0;
+    };
+    if (provider === "ip-api.com") {
+        if (s("status") === "fail")
+            throw new Error(`ip-api.com: ${s("message") || "unknown error"}`);
+        return {
+            ip: s("query"), country: s("country"), countryCode: s("countryCode"),
+            region: s("regionName"), city: s("city"), isp: s("isp"),
+            timezone: s("timezone"), latitude: f("lat"), longitude: f("lon"),
+            provider,
+        };
+    }
+    if (provider === "ipapi.co") {
+        return {
+            ip: s("ip"), country: s("country_name"), countryCode: s("country_code"),
+            region: s("region"), city: s("city"), isp: s("org"),
+            timezone: s("timezone"), latitude: f("latitude"), longitude: f("longitude"),
+            provider, languages: s("languages"),
+        };
+    }
+    if (provider === "ipwho.is") {
+        const conn = (body["connection"] && typeof body["connection"] === "object") ? body["connection"] : {};
+        const tz = (body["timezone"] && typeof body["timezone"] === "object") ? body["timezone"] : {};
+        return {
+            ip: s("ip"), country: s("country"), countryCode: s("country_code"),
+            region: s("region"), city: s("city"),
+            isp: (typeof conn.isp === "string" ? conn.isp : "") || "",
+            timezone: (typeof tz.id === "string" ? tz.id : "") || "",
+            latitude: f("latitude"), longitude: f("longitude"),
+            provider,
+        };
+    }
+    return {
+        ip: s("query"), country: s("country"), countryCode: s("countryCode"),
+        region: "", city: "", isp: "", timezone: "",
+        latitude: 0, longitude: 0, provider,
+    };
+}
+//# sourceMappingURL=geo.js.map

package/dist/geo.js.map

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

package/dist/host.d.ts

@@ -0,0 +1,10 @@
+/** Logical CPU count (SMT threads). Falls back to 8 if `os.cpus()` is empty. */
+export declare function hostLogicalCores(): number;
+/** Physical RAM in GiB, best-effort per OS. `null` on failure. */
+export declare function hostRamGb(): number | null;
+/** Round host RAM to Chrome's deviceMemory bucket {8,16,32}; null → 16. */
+export declare function hostRamBucketGb(): number;
+export type Size = readonly [width: number, height: number];
+/** Primary monitor (width, height) in CSS pixels, or null on failure. */
+export declare function hostScreenSize(): Size | null;
+//# sourceMappingURL=host.d.ts.map

package/dist/host.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"host.d.ts","sourceRoot":"","sources":["../src/host.ts"],"names":[],"mappings":"AAUA,gFAAgF;AAChF,wBAAgB,gBAAgB,IAAI,MAAM,CAOzC;AAED,kEAAkE;AAClE,wBAAgB,SAAS,IAAI,MAAM,GAAG,IAAI,CAkCzC;AAED,2EAA2E;AAC3E,wBAAgB,eAAe,IAAI,MAAM,CAMxC;AAID,MAAM,MAAM,IAAI,GAAG,SAAS,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,CAAC;AAK5D,yEAAyE;AACzE,wBAAgB,cAAc,IAAI,IAAI,GAAG,IAAI,CAU5C"}

package/dist/host.js

@@ -0,0 +1,142 @@
+// Host machine introspection — logical CPU count, physical RAM and the
+// primary monitor resolution. Mirrors `host_logical_cores`, `host_ram_gb`,
+// `host_ram_bucket_gb` in `src-tauri/src/lib.rs`.
+//
+// All probes are best-effort: a thrown error returns `null` (or the
+// documented fallback) instead of propagating.
+import { cpus, platform as osPlatform } from "node:os";
+import { execFileSync, execSync } from "node:child_process";
+import { readFileSync } from "node:fs";
+/** Logical CPU count (SMT threads). Falls back to 8 if `os.cpus()` is empty. */
+export function hostLogicalCores() {
+    try {
+        const n = cpus().length;
+        return n > 0 ? n : 8;
+    }
+    catch {
+        return 8;
+    }
+}
+/** Physical RAM in GiB, best-effort per OS. `null` on failure. */
+export function hostRamGb() {
+    const plat = osPlatform();
+    try {
+        if (plat === "darwin") {
+            const out = execFileSync("sysctl", ["-n", "hw.memsize"], { stdio: ["ignore", "pipe", "ignore"], timeout: 2000 }).toString().trim();
+            const bytes = Number(out);
+            if (!Number.isFinite(bytes) || bytes <= 0)
+                return null;
+            return Math.floor(bytes / (1024 ** 3));
+        }
+        if (plat === "linux") {
+            const txt = readFileSync("/proc/meminfo", "utf8");
+            for (const line of txt.split("\n")) {
+                if (line.startsWith("MemTotal:")) {
+                    const kb = Number(line.split(/\s+/)[1]);
+                    if (!Number.isFinite(kb) || kb <= 0)
+                        return null;
+                    return Math.floor(kb / (1024 * 1024));
+                }
+            }
+            return null;
+        }
+        if (plat === "win32") {
+            const out = execSync('powershell -NoProfile -Command "(Get-CimInstance Win32_ComputerSystem).TotalPhysicalMemory"', { stdio: ["ignore", "pipe", "ignore"], timeout: 4000 }).toString().trim();
+            const bytes = Number(out);
+            if (!Number.isFinite(bytes) || bytes <= 0)
+                return null;
+            return Math.floor(bytes / (1024 ** 3));
+        }
+    }
+    catch {
+        return null;
+    }
+    return null;
+}
+/** Round host RAM to Chrome's deviceMemory bucket {8,16,32}; null → 16. */
+export function hostRamBucketGb() {
+    const gb = hostRamGb();
+    if (gb === null)
+        return 16;
+    if (gb >= 32)
+        return 32;
+    if (gb >= 16)
+        return 16;
+    return 8;
+}
+const MAC_RES_RE = /Resolution:\s*(\d+)\s*x\s*(\d+)/g;
+const XRANDR_CUR_RE = /^\s*(\d+)x(\d+)[^\n]*\*/m;
+/** Primary monitor (width, height) in CSS pixels, or null on failure. */
+export function hostScreenSize() {
+    const plat = osPlatform();
+    try {
+        if (plat === "darwin")
+            return macScreenSize();
+        if (plat === "win32")
+            return windowsScreenSize();
+        if (plat === "linux")
+            return linuxScreenSize();
+    }
+    catch {
+        return null;
+    }
+    return null;
+}
+function macScreenSize() {
+    // `system_profiler SPDisplaysDataType` reports panel resolution, matching
+    // what the launcher's primary_monitor() returns post-scale.
+    let out;
+    try {
+        out = execFileSync("system_profiler", ["SPDisplaysDataType"], { stdio: ["ignore", "pipe", "ignore"], timeout: 4000 }).toString();
+    }
+    catch {
+        return null;
+    }
+    let best = null;
+    for (const m of out.matchAll(MAC_RES_RE)) {
+        const w = Number(m[1]);
+        const h = Number(m[2]);
+        if (!Number.isFinite(w) || !Number.isFinite(h))
+            continue;
+        if (best === null || w * h > best[0] * best[1])
+            best = [w, h];
+    }
+    return best;
+}
+function windowsScreenSize() {
+    try {
+        const out = execSync('powershell -NoProfile -Command ' +
+            '"Add-Type -AssemblyName System.Windows.Forms; ' +
+            '$s=[System.Windows.Forms.Screen]::PrimaryScreen.Bounds; ' +
+            '\\"$($s.Width)x$($s.Height)\\""', { stdio: ["ignore", "pipe", "ignore"], timeout: 4000 }).toString().trim();
+        const m = /^(\d+)x(\d+)$/.exec(out);
+        if (m) {
+            const w = Number(m[1]);
+            const h = Number(m[2]);
+            if (w > 0 && h > 0)
+                return [w, h];
+        }
+    }
+    catch {
+        return null;
+    }
+    return null;
+}
+function linuxScreenSize() {
+    let out;
+    try {
+        out = execFileSync("xrandr", ["--query"], { stdio: ["ignore", "pipe", "ignore"], timeout: 4000 }).toString();
+    }
+    catch {
+        return null;
+    }
+    const m = XRANDR_CUR_RE.exec(out);
+    if (m) {
+        const w = Number(m[1]);
+        const h = Number(m[2]);
+        if (w > 0 && h > 0)
+            return [w, h];
+    }
+    return null;
+}
+//# sourceMappingURL=host.js.map

package/dist/host.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,97 @@
+import { type Browser as PatchrightBrowser } from "patchright";
+import { Runtime, type ProgressCb } from "./runtime.js";
+import { FingerprintLibrary, Profile } from "./profile.js";
+import { type LaunchOptions, type BrowserSession } from "./browser.js";
+import { type GeoInfo } from "./geo.js";
+export interface ShardXOptions {
+    /** Where the engine, Widevine, and bundled fingerprint library live
+     *  (defaults to the per-OS app-data dir). */
+    cacheDir?: string;
+    progress?: ProgressCb;
+    /** Per-profile user-data-dir root (cookies, IndexedDB, cache).
+     *  Defaults to `./shardx-profiles/` next to the running script. */
+    profilesDir?: string;
+}
+export type LaunchInput = string | Profile | Record<string, unknown>;
+export interface ShardXLaunchOptions extends LaunchOptions {
+    /** When `fingerprint` is omitted, pick a random profile filtered by this platform substring. */
+    platform?: string;
+    /** When true, re-pick hardware_concurrency / device_memory / platform_version before launch. */
+    randomize?: boolean;
+}
+export interface ProxyCheckResult {
+    udpMs: number | null;
+    geo: GeoInfo;
+    wouldEnableQuic: boolean;
+    wouldSetWebrtc: "auto" | "tcp_only";
+}
+export declare class ShardX {
+    readonly runtime: Runtime;
+    readonly library: FingerprintLibrary;
+    private readonly browser;
+    constructor(opts?: ShardXOptions);
+    /** All bundled fingerprint ids, optionally filtered by `navigator.platform`.
+     *  Auto-installs the fingerprint library on first call. */
+    listProfiles(opts?: {
+        platform?: string;
+    }): Promise<string[]>;
+    /** Pick a random profile from the library.  Auto-installs on first call. */
+    randomProfile(opts?: {
+        platform?: string;
+    }): Promise<Profile>;
+    /**
+     * Launch a profile.
+     *
+     * @param fingerprint  Profile id, `Profile` instance, plain dict, or `null`/omitted to pick random.
+     * @param opts.platform  When picking random, filter by `navigator.platform` substring.
+     * @param opts.randomize When true, freshly randomise hw_concurrency / device_memory / platform_version.
+     *                       (Same logic the desktop launcher applies when re-picking a GPU.)
+     * All other options forwarded to `Browser.launch` (proxy, cdp, headless, webrtc, screenMode, …).
+     */
+    launch(fingerprint?: LaunchInput | null, opts?: ShardXLaunchOptions): Promise<BrowserSession>;
+    /**
+     * Launch a profile AND connect patchright in one call.  Returns an
+     * object with the patchright `Browser`, the raw `BrowserSession`, and
+     * a `close()` that tears both down.
+     *
+     * Requires `patchright` (`npm install patchright`) as an optional
+     * peer-dependency.
+     *
+     * @example
+     * const { browser, close } = await sdk.session({ fingerprint: "win-rtx4060", proxy: "socks5://…" });
+     * try {
+     *   const page = await browser.contexts()[0].newPage();
+     *   await page.goto("https://example.com");
+     * } finally {
+     *   await close();
+     * }
+     */
+    session(opts?: ShardXLaunchOptions & {
+        fingerprint?: LaunchInput | null;
+    }): Promise<{
+        browser: PatchrightBrowser;
+        session: BrowserSession;
+        close: () => Promise<void>;
+    }>;
+    /**
+     * Validate a proxy URL before binding it to a profile. Returns the same
+     * data the launcher uses to decide QUIC + WebRTC policy.
+     */
+    checkProxy(proxyUrl: string): Promise<ProxyCheckResult>;
+}
+export { Runtime, defaultCacheDir, PUB_BASE, CHROMIUM_VERSION, hostSpec } from "./runtime.js";
+export type { ProgressCb, HostSpec, Archive } from "./runtime.js";
+export { Profile, FingerprintLibrary, userDataDir } from "./profile.js";
+export { Browser, BrowserSession } from "./browser.js";
+export type { LaunchOptions, WebRtcMode, ScreenMode } from "./browser.js";
+export { parseProxy, probeUdp, proxyToArg } from "./proxy.js";
+export type { ParsedProxy } from "./proxy.js";
+export { randomizeHardware, randomizePlatformVersion, MAC_HW_CONFIGS, X86_CORES, MACOS_PLATFORM_VERSIONS, WINDOWS_PLATFORM_VERSIONS, LINUX_PLATFORM_VERSIONS, } from "./randomize.js";
+export { hostLogicalCores, hostRamGb, hostRamBucketGb, hostScreenSize, } from "./host.js";
+export type { Size } from "./host.js";
+export { applyScreenStrategy, defaultScreenModeFor } from "./screen.js";
+export type { ScreenStrategy } from "./screen.js";
+export { geoCheckVia } from "./geo.js";
+export type { GeoInfo, GeoProvider } from "./geo.js";
+export { hasAutoFields, resolveAutoFields } from "./autoResolve.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

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

package/dist/index.js

@@ -0,0 +1,130 @@
+// Top-level façade — bundles the runtime, fingerprint library, and
+// browser launcher. Mirrors the Python `ShardX` class.
+import { chromium } from "patchright";
+import { Runtime } from "./runtime.js";
+import { FingerprintLibrary, Profile } from "./profile.js";
+import { Browser } from "./browser.js";
+import { randomizeHardware, randomizePlatformVersion } from "./randomize.js";
+import { parseProxy, probeUdp } from "./proxy.js";
+import { geoCheckVia } from "./geo.js";
+export class ShardX {
+    runtime;
+    library;
+    browser;
+    constructor(opts = {}) {
+        this.runtime = new Runtime(opts);
+        this.library = new FingerprintLibrary(this.runtime);
+        this.browser = new Browser(this.runtime);
+    }
+    /** All bundled fingerprint ids, optionally filtered by `navigator.platform`.
+     *  Auto-installs the fingerprint library on first call. */
+    async listProfiles(opts = {}) {
+        await this.runtime.install();
+        return opts.platform ? Array.from(this.library.filter({ platform: opts.platform })) : this.library.ids();
+    }
+    /** Pick a random profile from the library.  Auto-installs on first call. */
+    async randomProfile(opts = {}) {
+        const ids = await this.listProfiles(opts);
+        if (ids.length === 0) {
+            throw new Error(`No bundled profiles found${opts.platform ? ` for platform=${opts.platform}` : ""}. Did you call ensureInstalled()?`);
+        }
+        return this.library.load(ids[Math.floor(Math.random() * ids.length)]);
+    }
+    /**
+     * Launch a profile.
+     *
+     * @param fingerprint  Profile id, `Profile` instance, plain dict, or `null`/omitted to pick random.
+     * @param opts.platform  When picking random, filter by `navigator.platform` substring.
+     * @param opts.randomize When true, freshly randomise hw_concurrency / device_memory / platform_version.
+     *                       (Same logic the desktop launcher applies when re-picking a GPU.)
+     * All other options forwarded to `Browser.launch` (proxy, cdp, headless, webrtc, screenMode, …).
+     */
+    async launch(fingerprint, opts = {}) {
+        await this.runtime.install();
+        let profile;
+        if (fingerprint == null) {
+            profile = await this.randomProfile({ platform: opts.platform });
+        }
+        else if (typeof fingerprint === "string") {
+            profile = this.library.load(fingerprint);
+        }
+        else if (fingerprint instanceof Profile) {
+            profile = fingerprint;
+        }
+        else if (typeof fingerprint === "object") {
+            profile = new Profile(fingerprint);
+        }
+        else {
+            throw new TypeError(`fingerprint must be string | Profile | object | null; got ${typeof fingerprint}`);
+        }
+        if (opts.randomize) {
+            randomizeHardware(profile.config, profile.id);
+            randomizePlatformVersion(profile.config);
+        }
+        const { platform: _p, randomize: _r, ...launchOpts } = opts;
+        return this.browser.launch(profile, launchOpts);
+    }
+    /**
+     * Launch a profile AND connect patchright in one call.  Returns an
+     * object with the patchright `Browser`, the raw `BrowserSession`, and
+     * a `close()` that tears both down.
+     *
+     * Requires `patchright` (`npm install patchright`) as an optional
+     * peer-dependency.
+     *
+     * @example
+     * const { browser, close } = await sdk.session({ fingerprint: "win-rtx4060", proxy: "socks5://…" });
+     * try {
+     *   const page = await browser.contexts()[0].newPage();
+     *   await page.goto("https://example.com");
+     * } finally {
+     *   await close();
+     * }
+     */
+    async session(opts = {}) {
+        const { fingerprint, ...launchOpts } = opts;
+        const sess = await this.launch(fingerprint ?? null, { ...launchOpts, cdp: true });
+        if (!sess.cdpUrl) {
+            await sess.stop();
+            throw new Error("CDP endpoint unavailable — engine failed to expose remote-debugging port");
+        }
+        const browser = await chromium.connectOverCDP(sess.cdpUrl);
+        return {
+            browser,
+            session: sess,
+            async close() {
+                try {
+                    await browser.close();
+                }
+                catch { /* ignore */ }
+                await sess.stop();
+            },
+        };
+    }
+    /**
+     * Validate a proxy URL before binding it to a profile. Returns the same
+     * data the launcher uses to decide QUIC + WebRTC policy.
+     */
+    async checkProxy(proxyUrl) {
+        const parsed = parseProxy(proxyUrl);
+        const udpMs = parsed.scheme === "socks5" ? await probeUdp(parsed) : null;
+        const geo = await geoCheckVia(parsed);
+        const udpOk = udpMs !== null;
+        return {
+            udpMs,
+            geo,
+            wouldEnableQuic: udpOk,
+            wouldSetWebrtc: udpOk ? "auto" : "tcp_only",
+        };
+    }
+}
+export { Runtime, defaultCacheDir, PUB_BASE, CHROMIUM_VERSION, hostSpec } from "./runtime.js";
+export { Profile, FingerprintLibrary, userDataDir } from "./profile.js";
+export { Browser, BrowserSession } from "./browser.js";
+export { parseProxy, probeUdp, proxyToArg } from "./proxy.js";
+export { randomizeHardware, randomizePlatformVersion, MAC_HW_CONFIGS, X86_CORES, MACOS_PLATFORM_VERSIONS, WINDOWS_PLATFORM_VERSIONS, LINUX_PLATFORM_VERSIONS, } from "./randomize.js";
+export { hostLogicalCores, hostRamGb, hostRamBucketGb, hostScreenSize, } from "./host.js";
+export { applyScreenStrategy, defaultScreenModeFor } from "./screen.js";
+export { geoCheckVia } from "./geo.js";
+export { hasAutoFields, resolveAutoFields } from "./autoResolve.js";
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

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

package/dist/profile.d.ts

@@ -0,0 +1,26 @@
+import type { Runtime } from "./runtime.js";
+export declare class Profile {
+    readonly id: string;
+    config: Record<string, unknown>;
+    constructor(config: Record<string, unknown>, id?: string);
+    static fromFile(path: string): Profile;
+    /** Shallow merge: object values are merged one level deep, scalars replaced. */
+    withOverride(overrides: Record<string, unknown>): Profile;
+    get platform(): string;
+    get hasWebGPU(): boolean;
+}
+export declare class FingerprintLibrary {
+    private readonly runtime;
+    constructor(runtime: Runtime);
+    ids(): string[];
+    filter(opts?: {
+        platform?: string;
+    }): Generator<string>;
+    load(fingerprintId: string): Profile;
+}
+/** Per-profile state (cookies / IndexedDB / cache) — preserved across
+ *  launches. Defaults to `./shardx-profiles/<id>/` next to the running
+ *  script. Override per launch with `userDataDir` or per SDK with
+ *  `new ShardX({ profilesDir })`. */
+export declare function userDataDir(runtime: Runtime, profileId: string, base?: string): string;
+//# sourceMappingURL=profile.d.ts.map

package/dist/profile.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"profile.d.ts","sourceRoot":"","sources":["../src/profile.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AAE5C,qBAAa,OAAO;IAClB,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;gBAEpB,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,EAAE,CAAC,EAAE,MAAM;IAKxD,MAAM,CAAC,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO;IAMtC,gFAAgF;IAChF,YAAY,CAAC,SAAS,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,OAAO;IAazD,IAAI,QAAQ,IAAI,MAAM,CAGrB;IAED,IAAI,SAAS,IAAI,OAAO,CAKvB;CACF;AAED,qBAAa,kBAAkB;IACjB,OAAO,CAAC,QAAQ,CAAC,OAAO;gBAAP,OAAO,EAAE,OAAO;IAE7C,GAAG,IAAI,MAAM,EAAE;IAOd,MAAM,CAAC,IAAI,GAAE;QAAE,QAAQ,CAAC,EAAE,MAAM,CAAA;KAAO,GAAG,SAAS,CAAC,MAAM,CAAC;IAY5D,IAAI,CAAC,aAAa,EAAE,MAAM,GAAG,OAAO;CAQrC;AAED;;;qCAGqC;AACrC,wBAAgB,WAAW,CAAC,OAAO,EAAE,OAAO,EAAE,SAAS,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,GAAG,MAAM,CAKtF"}