clearcote 0.1.0

package/LICENSE

@@ -0,0 +1,34 @@
+BSD 3-Clause License
+
+Copyright (c) 2026, Clearcote Labs and the Clearcote contributors
+
+Redistribution and use in source and binary forms, with or without
+modification, are permitted provided that the following conditions are met:
+
+1. Redistributions of source code must retain the above copyright notice, this
+   list of conditions and the following disclaimer.
+
+2. Redistributions in binary form must reproduce the above copyright notice,
+   this list of conditions and the following disclaimer in the documentation
+   and/or other materials provided with the distribution.
+
+3. Neither the name of the copyright holder nor the names of its
+   contributors may be used to endorse or promote products derived from
+   this software without specific prior written permission.
+
+THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS"
+AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
+IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
+DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE LIABLE
+FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
+DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR
+SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER
+CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY,
+OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
+OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
+
+---
+
+This license applies to Clearcote's own source code and patches. Upstream
+components (Chromium, ungoogled-chromium, and others) are distributed under
+their respective licenses; see CREDITS.md.

package/README.md

@@ -0,0 +1,115 @@
+# clearcote (Node / TypeScript SDK)
+
+A **Playwright drop-in** for [Clearcote](https://github.com/clearcotelabs/clearcote-browser) — the
+open, reproducible, anti-fingerprint Chromium build. `launch()` returns a standard Playwright
+`Browser`, so migrating is a one-line import change.
+
+The verified Clearcote binary is **auto-downloaded and SHA-256 checked** on first use, then cached —
+you don't manage zips or paths.
+
+> **Platform:** Clearcote currently ships a **Windows x64** binary, so `launch()` runs on Windows.
+> (The SDK will download + verify the binary on any OS — useful for packaging — but only launches it
+> on Windows. Linux/macOS builds are on the [roadmap](../../ROADMAP.md).)
+
+## Install
+
+```bash
+npm install clearcote
+```
+
+`playwright-core` comes as a dependency — you do **not** need to install Playwright separately or
+run `playwright install` (Clearcote uses its own browser binary).
+
+## Usage
+
+```ts
+import { launch } from "clearcote";
+
+const browser = await launch({
+  fingerprint: "user-7423",        // per-eTLD+1 seed: same seed => same identity, different => unlinkable
+  platform: "windows",
+  timezone: "America/New_York",
+  headless: false,
+});
+
+const page = await browser.newPage();
+await page.goto("https://abrahamjuliot.github.io/creepjs/");
+// ... standard Playwright from here ...
+await browser.close();
+```
+
+Already using Playwright? Swap `chromium.launch(...)` for `launch(...)` from `clearcote` — the
+returned object is a normal Playwright `Browser`.
+
+### Through a proxy (report the proxy's IP, not your host's)
+
+```ts
+const browser = await launch({
+  fingerprint: "user-7423",
+  proxy: { server: "http://host:8080", username: "u", password: "p" }, // standard Playwright option
+  timezone: "America/New_York",
+  webrtcIp: "203.0.113.10",        // make WebRTC report the proxy egress IP
+});
+```
+
+### Persistent profile
+
+```ts
+import { launchPersistentContext } from "clearcote";
+
+const context = await launchPersistentContext("./profile-7423", {
+  fingerprint: "user-7423",
+  platform: "windows",
+});
+```
+
+## Fingerprint options
+
+All optional. Anything not listed here is passed straight through to Playwright
+(`headless`, `proxy`, `args`, `timeout`, `slowMo`, …).
+
+| Option | Switch | Meaning |
+|---|---|---|
+| `fingerprint` | `--fingerprint` | Master seed (per-eTLD+1 farbling root). String or number. |
+| `platform` | `--fingerprint-platform` | `windows` \| `linux` \| `macos`. |
+| `platformVersion` | `--fingerprint-platform-version` | UA-CH platform version. |
+| `brand` | `--fingerprint-brand` | `Chrome` \| `Edge` \| `Opera` \| `Vivaldi`. |
+| `brandVersion` | `--fingerprint-brand-version` | Brand version. |
+| `gpuVendor` | `--fingerprint-gpu-vendor` | WebGL UNMASKED vendor. |
+| `gpuRenderer` | `--fingerprint-gpu-renderer` | WebGL UNMASKED renderer. |
+| `hardwareConcurrency` | `--fingerprint-hardware-concurrency` | `navigator.hardwareConcurrency`. |
+| `location` | `--fingerprint-location` | `"lat,lng"` (only when geo permission is granted). |
+| `timezone` | `--timezone` | IANA timezone, e.g. `America/New_York`. |
+| `webrtcIp` | `--webrtc-ip` | WebRTC egress IP to report (your proxy IP). |
+| `disableGpuFingerprint` | `--disable-gpu-fingerprint` | Turn off GPU/WebGL spoofing. |
+
+## API
+
+- `launch(options?)` → `Promise<Browser>` — launch and get a Playwright `Browser`.
+- `launchPersistentContext(userDataDir, options?)` → `Promise<BrowserContext>`.
+- `executablePath(options?)` → `Promise<string>` — resolve (download/verify if needed) the chrome.exe path, e.g. for raw `chromium.launch({ executablePath })`.
+- `download(options?)` → `Promise<string>` — pre-fetch + verify the binary without launching.
+- `RELEASE` — the pinned release metadata (tag, version, sha256).
+
+## Binary resolution & verification
+
+`launch()` resolves the browser in this order:
+
+1. `executablePath` option, if given;
+2. `CLEARCOTE_BINARY` environment variable, if set;
+3. otherwise **download** the pinned release, **verify its SHA-256** (the hash is baked into this
+   package — it's the trust anchor), extract to a per-version cache, and verify the extracted
+   `chrome.exe` hash too.
+
+Cache location (override with `CLEARCOTE_CACHE`):
+- Windows: `%LOCALAPPDATA%\clearcote\Cache\<tag>`
+- macOS: `~/Library/Caches/clearcote/<tag>`
+- Linux: `${XDG_CACHE_HOME:-~/.cache}/clearcote/<tag>`
+
+A SHA-256 mismatch is a hard error — the SDK refuses to run an unverified binary. You can
+independently confirm the published checksums and GPG signatures on the
+[release page](https://github.com/clearcotelabs/clearcote-browser/releases).
+
+## License
+
+BSD-3-Clause. See [LICENSE](../../LICENSE).

package/dist/download.d.ts

@@ -0,0 +1,12 @@
+export interface DownloadOptions {
+    /** Override the cache directory (default: per-OS user cache dir). */
+    cacheDir?: string;
+    /** Suppress progress logging. */
+    quiet?: boolean;
+}
+/**
+ * Ensure the Clearcote binary is present and verified; return the path to chrome.exe.
+ * Cached per release tag, so subsequent calls are instant.
+ */
+export declare function ensureBinary(opts?: DownloadOptions): Promise<string>;
+//# sourceMappingURL=download.d.ts.map

package/dist/download.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"download.d.ts","sourceRoot":"","sources":["../src/download.ts"],"names":[],"mappings":"AAeA,MAAM,WAAW,eAAe;IAC9B,qEAAqE;IACrE,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,iCAAiC;IACjC,KAAK,CAAC,EAAE,OAAO,CAAC;CACjB;AAqED;;;GAGG;AACH,wBAAsB,YAAY,CAAC,IAAI,GAAE,eAAoB,GAAG,OAAO,CAAC,MAAM,CAAC,CA6C9E"}

package/dist/download.js

@@ -0,0 +1,122 @@
+// Resolve the Clearcote browser binary: use an explicit path / env override if given, otherwise
+// download the pinned release, verify its SHA-256 against the value baked into the SDK, extract
+// it to a per-version cache, and return the path to chrome.exe. The hash check is mandatory —
+// a mismatch throws and the partial download is deleted.
+import { createHash } from "node:crypto";
+import { createReadStream, createWriteStream, existsSync, mkdirSync, readdirSync, writeFileSync } from "node:fs";
+import { rm } from "node:fs/promises";
+import os from "node:os";
+import path from "node:path";
+import { Readable } from "node:stream";
+import { pipeline } from "node:stream/promises";
+import extract from "extract-zip";
+import { RELEASE } from "./release.js";
+function log(quiet, msg) {
+    if (!quiet)
+        process.stderr.write(`[clearcote] ${msg}\n`);
+}
+function defaultCacheRoot() {
+    if (process.env.CLEARCOTE_CACHE)
+        return process.env.CLEARCOTE_CACHE;
+    if (process.platform === "win32") {
+        return path.join(process.env.LOCALAPPDATA || path.join(os.homedir(), "AppData", "Local"), "clearcote", "Cache");
+    }
+    if (process.platform === "darwin") {
+        return path.join(os.homedir(), "Library", "Caches", "clearcote");
+    }
+    return path.join(process.env.XDG_CACHE_HOME || path.join(os.homedir(), ".cache"), "clearcote");
+}
+function findFile(dir, name) {
+    const stack = [dir];
+    while (stack.length) {
+        const cur = stack.pop();
+        let entries;
+        try {
+            entries = readdirSync(cur, { withFileTypes: true });
+        }
+        catch {
+            continue;
+        }
+        for (const e of entries) {
+            const full = path.join(cur, e.name);
+            if (e.isDirectory())
+                stack.push(full);
+            else if (e.name.toLowerCase() === name.toLowerCase())
+                return full;
+        }
+    }
+    return null;
+}
+function sha256File(file) {
+    return new Promise((resolve, reject) => {
+        const hash = createHash("sha256");
+        createReadStream(file)
+            .on("error", reject)
+            .on("data", (d) => hash.update(d))
+            .on("end", () => resolve(hash.digest("hex")));
+    });
+}
+async function downloadTo(url, dest, quiet) {
+    const res = await fetch(url, { redirect: "follow" });
+    if (!res.ok || !res.body) {
+        throw new Error(`Clearcote download failed: HTTP ${res.status} ${res.statusText} for ${url}`);
+    }
+    const total = Number(res.headers.get("content-length")) || RELEASE.size;
+    let seen = 0;
+    let lastPct = -1;
+    const progress = new TransformStream({
+        transform(chunk, controller) {
+            seen += chunk.byteLength;
+            const pct = Math.floor((seen / total) * 100);
+            if (!quiet && pct !== lastPct && pct % 5 === 0) {
+                lastPct = pct;
+                process.stderr.write(`\r[clearcote] downloading ${pct}% (${(seen / 1e6).toFixed(0)}/${(total / 1e6).toFixed(0)} MB)`);
+            }
+            controller.enqueue(chunk);
+        },
+    });
+    await pipeline(Readable.fromWeb(res.body.pipeThrough(progress)), createWriteStream(dest));
+    if (!quiet)
+        process.stderr.write("\n");
+}
+/**
+ * Ensure the Clearcote binary is present and verified; return the path to chrome.exe.
+ * Cached per release tag, so subsequent calls are instant.
+ */
+export async function ensureBinary(opts = {}) {
+    const base = path.join(opts.cacheDir || defaultCacheRoot(), RELEASE.tag);
+    const browserDir = path.join(base, "browser");
+    const marker = path.join(base, ".verified");
+    if (existsSync(marker)) {
+        const cached = findFile(browserDir, "chrome.exe");
+        if (cached)
+            return cached;
+    }
+    mkdirSync(base, { recursive: true });
+    const zipPath = path.join(base, RELEASE.asset);
+    log(opts.quiet, `fetching Clearcote ${RELEASE.version} (${RELEASE.tag}, ~${(RELEASE.size / 1e6).toFixed(0)} MB)`);
+    await downloadTo(RELEASE.url, zipPath, opts.quiet);
+    log(opts.quiet, "verifying SHA-256");
+    const got = await sha256File(zipPath);
+    if (got.toLowerCase() !== RELEASE.sha256.toLowerCase()) {
+        await rm(zipPath, { force: true });
+        throw new Error(`Clearcote archive SHA-256 mismatch — refusing to use it.\n  expected ${RELEASE.sha256}\n  got      ${got}`);
+    }
+    log(opts.quiet, "extracting");
+    await rm(browserDir, { recursive: true, force: true });
+    await extract(zipPath, { dir: browserDir });
+    const exe = findFile(browserDir, "chrome.exe");
+    if (!exe) {
+        throw new Error("Clearcote archive verified but chrome.exe was not found inside it.");
+    }
+    // defense in depth: verify the extracted exe too
+    const exeHash = await sha256File(exe);
+    if (exeHash.toLowerCase() !== RELEASE.exeSha256.toLowerCase()) {
+        throw new Error(`Clearcote chrome.exe SHA-256 mismatch — refusing to use it.\n  expected ${RELEASE.exeSha256}\n  got      ${exeHash}`);
+    }
+    writeFileSync(marker, `${RELEASE.sha256}\n`);
+    await rm(zipPath, { force: true }); // reclaim ~250 MB; keep only the extracted tree
+    log(opts.quiet, `ready: ${exe}`);
+    return exe;
+}
+//# sourceMappingURL=download.js.map

package/dist/download.js.map

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

package/dist/fingerprint.d.ts

@@ -0,0 +1,38 @@
+export interface FingerprintOptions {
+    /**
+     * Master fingerprint seed (the per-eTLD+1 farbling root). Same seed => the same stable
+     * identity across launches; different seeds => unlinkable identities. Any string or number
+     * is accepted (non-numeric seeds are hashed engine-side — they will not crash the renderer).
+     */
+    fingerprint?: string | number;
+    /** Spoofed OS family for UA / UA-CH / navigator.platform. */
+    platform?: "windows" | "linux" | "macos";
+    /** Spoofed platform version (UA-CH high-entropy). */
+    platformVersion?: string;
+    /** Browser brand for UA / UA-CH. */
+    brand?: "Chrome" | "Edge" | "Opera" | "Vivaldi" | (string & {});
+    /** Brand version. */
+    brandVersion?: string;
+    /** WebGL UNMASKED_VENDOR string. */
+    gpuVendor?: string;
+    /** WebGL UNMASKED_RENDERER string. */
+    gpuRenderer?: string;
+    /** navigator.hardwareConcurrency. */
+    hardwareConcurrency?: number;
+    /** Geolocation as "lat,lng" (only returned when the page is granted permission). */
+    location?: string;
+    /** IANA timezone, e.g. "America/New_York". */
+    timezone?: string;
+    /** WebRTC egress IP to report (typically your proxy's public IP). */
+    webrtcIp?: string;
+    /** Turn OFF GPU/WebGL fingerprint spoofing (advertise the real backend). */
+    disableGpuFingerprint?: boolean;
+}
+/** Split an options object into its fingerprint half and the remaining (Playwright) half. */
+export declare function splitFingerprintOptions<T extends FingerprintOptions>(options: T): {
+    fingerprint: FingerprintOptions;
+    rest: Omit<T, keyof FingerprintOptions>;
+};
+/** Build the Chromium switches for a set of fingerprint options. */
+export declare function fingerprintArgs(o: FingerprintOptions): string[];
+//# sourceMappingURL=fingerprint.d.ts.map

package/dist/fingerprint.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"fingerprint.d.ts","sourceRoot":"","sources":["../src/fingerprint.ts"],"names":[],"mappings":"AAGA,MAAM,WAAW,kBAAkB;IACjC;;;;OAIG;IACH,WAAW,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;IAC9B,6DAA6D;IAC7D,QAAQ,CAAC,EAAE,SAAS,GAAG,OAAO,GAAG,OAAO,CAAC;IACzC,qDAAqD;IACrD,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,oCAAoC;IACpC,KAAK,CAAC,EAAE,QAAQ,GAAG,MAAM,GAAG,OAAO,GAAG,SAAS,GAAG,CAAC,MAAM,GAAG,EAAE,CAAC,CAAC;IAChE,qBAAqB;IACrB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,oCAAoC;IACpC,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,sCAAsC;IACtC,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,qCAAqC;IACrC,mBAAmB,CAAC,EAAE,MAAM,CAAC;IAC7B,oFAAoF;IACpF,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,8CAA8C;IAC9C,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,qEAAqE;IACrE,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,4EAA4E;IAC5E,qBAAqB,CAAC,EAAE,OAAO,CAAC;CACjC;AAiBD,6FAA6F;AAC7F,wBAAgB,uBAAuB,CAAC,CAAC,SAAS,kBAAkB,EAClE,OAAO,EAAE,CAAC,GACT;IAAE,WAAW,EAAE,kBAAkB,CAAC;IAAC,IAAI,EAAE,IAAI,CAAC,CAAC,EAAE,MAAM,kBAAkB,CAAC,CAAA;CAAE,CAW9E;AAED,oEAAoE;AACpE,wBAAgB,eAAe,CAAC,CAAC,EAAE,kBAAkB,GAAG,MAAM,EAAE,CAoB/D"}

package/dist/fingerprint.js

@@ -0,0 +1,54 @@
+// Maps the SDK's fingerprint options to the Clearcote Chromium command-line switches.
+// Switch names mirror components/ungoogled/ungoogled_switches.cc (see patches/000-fingerprint-switches.patch).
+const FINGERPRINT_KEYS = [
+    "fingerprint",
+    "platform",
+    "platformVersion",
+    "brand",
+    "brandVersion",
+    "gpuVendor",
+    "gpuRenderer",
+    "hardwareConcurrency",
+    "location",
+    "timezone",
+    "webrtcIp",
+    "disableGpuFingerprint",
+];
+/** Split an options object into its fingerprint half and the remaining (Playwright) half. */
+export function splitFingerprintOptions(options) {
+    const fingerprint = {};
+    const rest = {};
+    for (const [k, v] of Object.entries(options)) {
+        if (FINGERPRINT_KEYS.includes(k)) {
+            fingerprint[k] = v;
+        }
+        else {
+            rest[k] = v;
+        }
+    }
+    return { fingerprint, rest: rest };
+}
+/** Build the Chromium switches for a set of fingerprint options. */
+export function fingerprintArgs(o) {
+    const args = [];
+    const set = (flag, value) => {
+        if (value !== undefined && value !== null && value !== "") {
+            args.push(`--${flag}=${value}`);
+        }
+    };
+    set("fingerprint", o.fingerprint);
+    set("fingerprint-platform", o.platform);
+    set("fingerprint-platform-version", o.platformVersion);
+    set("fingerprint-brand", o.brand);
+    set("fingerprint-brand-version", o.brandVersion);
+    set("fingerprint-gpu-vendor", o.gpuVendor);
+    set("fingerprint-gpu-renderer", o.gpuRenderer);
+    set("fingerprint-hardware-concurrency", o.hardwareConcurrency);
+    set("fingerprint-location", o.location);
+    set("timezone", o.timezone);
+    set("webrtc-ip", o.webrtcIp);
+    if (o.disableGpuFingerprint)
+        args.push("--disable-gpu-fingerprint");
+    return args;
+}
+//# sourceMappingURL=fingerprint.js.map

package/dist/fingerprint.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"fingerprint.js","sourceRoot":"","sources":["../src/fingerprint.ts"],"names":[],"mappings":"AAAA,sFAAsF;AACtF,+GAA+G;AAiC/G,MAAM,gBAAgB,GAAiC;IACrD,aAAa;IACb,UAAU;IACV,iBAAiB;IACjB,OAAO;IACP,cAAc;IACd,WAAW;IACX,aAAa;IACb,qBAAqB;IACrB,UAAU;IACV,UAAU;IACV,UAAU;IACV,uBAAuB;CACxB,CAAC;AAEF,6FAA6F;AAC7F,MAAM,UAAU,uBAAuB,CACrC,OAAU;IAEV,MAAM,WAAW,GAAuB,EAAE,CAAC;IAC3C,MAAM,IAAI,GAA4B,EAAE,CAAC;IACzC,KAAK,MAAM,CAAC,CAAC,EAAE,CAAC,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,OAAO,CAAC,EAAE,CAAC;QAC7C,IAAK,gBAA6B,CAAC,QAAQ,CAAC,CAAC,CAAC,EAAE,CAAC;YAC9C,WAAuC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC;QAClD,CAAC;aAAM,CAAC;YACN,IAAI,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC;QACd,CAAC;IACH,CAAC;IACD,OAAO,EAAE,WAAW,EAAE,IAAI,EAAE,IAAyC,EAAE,CAAC;AAC1E,CAAC;AAED,oEAAoE;AACpE,MAAM,UAAU,eAAe,CAAC,CAAqB;IACnD,MAAM,IAAI,GAAa,EAAE,CAAC;IAC1B,MAAM,GAAG,GAAG,CAAC,IAAY,EAAE,KAAc,EAAE,EAAE;QAC3C,IAAI,KAAK,KAAK,SAAS,IAAI,KAAK,KAAK,IAAI,IAAI,KAAK,KAAK,EAAE,EAAE,CAAC;YAC1D,IAAI,CAAC,IAAI,CAAC,KAAK,IAAI,IAAI,KAAK,EAAE,CAAC,CAAC;QAClC,CAAC;IACH,CAAC,CAAC;IACF,GAAG,CAAC,aAAa,EAAE,CAAC,CAAC,WAAW,CAAC,CAAC;IAClC,GAAG,CAAC,sBAAsB,EAAE,CAAC,CAAC,QAAQ,CAAC,CAAC;IACxC,GAAG,CAAC,8BAA8B,EAAE,CAAC,CAAC,eAAe,CAAC,CAAC;IACvD,GAAG,CAAC,mBAAmB,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC;IAClC,GAAG,CAAC,2BAA2B,EAAE,CAAC,CAAC,YAAY,CAAC,CAAC;IACjD,GAAG,CAAC,wBAAwB,EAAE,CAAC,CAAC,SAAS,CAAC,CAAC;IAC3C,GAAG,CAAC,0BAA0B,EAAE,CAAC,CAAC,WAAW,CAAC,CAAC;IAC/C,GAAG,CAAC,kCAAkC,EAAE,CAAC,CAAC,mBAAmB,CAAC,CAAC;IAC/D,GAAG,CAAC,sBAAsB,EAAE,CAAC,CAAC,QAAQ,CAAC,CAAC;IACxC,GAAG,CAAC,UAAU,EAAE,CAAC,CAAC,QAAQ,CAAC,CAAC;IAC5B,GAAG,CAAC,WAAW,EAAE,CAAC,CAAC,QAAQ,CAAC,CAAC;IAC7B,IAAI,CAAC,CAAC,qBAAqB;QAAE,IAAI,CAAC,IAAI,CAAC,2BAA2B,CAAC,CAAC;IACpE,OAAO,IAAI,CAAC;AACd,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,37 @@
+import type { Browser, BrowserContext, BrowserContextOptions, LaunchOptions as PlaywrightLaunchOptions } from "playwright-core";
+import { type DownloadOptions } from "./download.js";
+import { type FingerprintOptions } from "./fingerprint.js";
+export type { FingerprintOptions } from "./fingerprint.js";
+export type { DownloadOptions } from "./download.js";
+export { RELEASE } from "./release.js";
+/** Options for {@link launch}: Playwright launch options + Clearcote fingerprint options. */
+export interface LaunchOptions extends PlaywrightLaunchOptions, FingerprintOptions {
+}
+/** Options for {@link launchPersistentContext}. */
+export interface PersistentContextOptions extends PlaywrightLaunchOptions, BrowserContextOptions, FingerprintOptions {
+}
+/**
+ * Resolve the Clearcote chrome.exe path, downloading + verifying it if needed.
+ * Order: explicit `executablePath` > `CLEARCOTE_BINARY` env > auto-download.
+ */
+export declare function executablePath(options?: {
+    executablePath?: string;
+} & DownloadOptions): Promise<string>;
+/** Pre-fetch + verify the Clearcote binary without launching it. Returns the chrome.exe path. */
+export declare function download(options?: DownloadOptions): Promise<string>;
+/** Launch Clearcote and return a standard Playwright {@link Browser}. */
+export declare function launch(options?: LaunchOptions): Promise<Browser>;
+/**
+ * Launch Clearcote with a persistent profile directory and return a Playwright
+ * {@link BrowserContext} (cookies, storage, etc. persist in `userDataDir`).
+ */
+export declare function launchPersistentContext(userDataDir: string, options?: PersistentContextOptions): Promise<BrowserContext>;
+declare const _default: {
+    launch: typeof launch;
+    launchPersistentContext: typeof launchPersistentContext;
+    executablePath: typeof executablePath;
+    download: typeof download;
+    RELEASE: import("./release.js").ReleaseInfo;
+};
+export default _default;
+//# 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":"AAaA,OAAO,KAAK,EACV,OAAO,EACP,cAAc,EACd,qBAAqB,EACrB,aAAa,IAAI,uBAAuB,EACzC,MAAM,iBAAiB,CAAC;AACzB,OAAO,EAAgB,KAAK,eAAe,EAAE,MAAM,eAAe,CAAC;AACnE,OAAO,EAA4C,KAAK,kBAAkB,EAAE,MAAM,kBAAkB,CAAC;AAGrG,YAAY,EAAE,kBAAkB,EAAE,MAAM,kBAAkB,CAAC;AAC3D,YAAY,EAAE,eAAe,EAAE,MAAM,eAAe,CAAC;AACrD,OAAO,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AAEvC,6FAA6F;AAC7F,MAAM,WAAW,aAAc,SAAQ,uBAAuB,EAAE,kBAAkB;CAAG;AAErF,mDAAmD;AACnD,MAAM,WAAW,wBACf,SAAQ,uBAAuB,EAC7B,qBAAqB,EACrB,kBAAkB;CAAG;AAYzB;;;GAGG;AACH,wBAAsB,cAAc,CAClC,OAAO,GAAE;IAAE,cAAc,CAAC,EAAE,MAAM,CAAA;CAAE,GAAG,eAAoB,GAC1D,OAAO,CAAC,MAAM,CAAC,CAIjB;AAED,iGAAiG;AACjG,wBAAsB,QAAQ,CAAC,OAAO,GAAE,eAAoB,GAAG,OAAO,CAAC,MAAM,CAAC,CAE7E;AAED,yEAAyE;AACzE,wBAAsB,MAAM,CAAC,OAAO,GAAE,aAAkB,GAAG,OAAO,CAAC,OAAO,CAAC,CAU1E;AAED;;;GAGG;AACH,wBAAsB,uBAAuB,CAC3C,WAAW,EAAE,MAAM,EACnB,OAAO,GAAE,wBAA6B,GACrC,OAAO,CAAC,cAAc,CAAC,CAUzB;;;;;;;;AAED,wBAAsF"}

package/dist/index.js

@@ -0,0 +1,67 @@
+// Clearcote — Playwright drop-in.
+//
+//   import { launch } from "clearcote";
+//   const browser = await launch({ fingerprint: "seed-123", platform: "windows" });
+//   const page = await browser.newPage();
+//   await page.goto("https://abrahamjuliot.github.io/creepjs/");
+//
+// launch() returns a standard Playwright `Browser`, backed by the verified Clearcote binary
+// (auto-downloaded + SHA-256 checked on first use, then cached). Every Playwright launch option
+// (headless, proxy, args, timeout, ...) passes through; the fingerprint options below are added
+// as engine switches.
+import { chromium } from "playwright-core";
+import { ensureBinary } from "./download.js";
+import { fingerprintArgs, splitFingerprintOptions } from "./fingerprint.js";
+import { RELEASE } from "./release.js";
+export { RELEASE } from "./release.js";
+function ensureRunnableHere(exe) {
+    if (process.platform !== "win32") {
+        throw new Error(`Clearcote ${RELEASE.version} ships a Windows x64 binary only — it cannot launch on '${process.platform}'.\n` +
+            `Run on Windows, or pass executablePath to a compatible binary.\n` +
+            `(The binary downloaded and verified fine; it is cached at: ${exe})`);
+    }
+}
+/**
+ * Resolve the Clearcote chrome.exe path, downloading + verifying it if needed.
+ * Order: explicit `executablePath` > `CLEARCOTE_BINARY` env > auto-download.
+ */
+export async function executablePath(options = {}) {
+    if (options.executablePath)
+        return options.executablePath;
+    if (process.env.CLEARCOTE_BINARY)
+        return process.env.CLEARCOTE_BINARY;
+    return ensureBinary({ cacheDir: options.cacheDir, quiet: options.quiet });
+}
+/** Pre-fetch + verify the Clearcote binary without launching it. Returns the chrome.exe path. */
+export async function download(options = {}) {
+    return ensureBinary(options);
+}
+/** Launch Clearcote and return a standard Playwright {@link Browser}. */
+export async function launch(options = {}) {
+    const { executablePath: exeOption, args, ...rest } = options;
+    const { fingerprint, rest: pwOptions } = splitFingerprintOptions(rest);
+    const exe = await executablePath({ executablePath: exeOption });
+    ensureRunnableHere(exe);
+    return chromium.launch({
+        ...pwOptions,
+        executablePath: exe,
+        args: [...fingerprintArgs(fingerprint), ...(args ?? [])],
+    });
+}
+/**
+ * Launch Clearcote with a persistent profile directory and return a Playwright
+ * {@link BrowserContext} (cookies, storage, etc. persist in `userDataDir`).
+ */
+export async function launchPersistentContext(userDataDir, options = {}) {
+    const { executablePath: exeOption, args, ...rest } = options;
+    const { fingerprint, rest: pwOptions } = splitFingerprintOptions(rest);
+    const exe = await executablePath({ executablePath: exeOption });
+    ensureRunnableHere(exe);
+    return chromium.launchPersistentContext(userDataDir, {
+        ...pwOptions,
+        executablePath: exe,
+        args: [...fingerprintArgs(fingerprint), ...(args ?? [])],
+    });
+}
+export default { launch, launchPersistentContext, executablePath, download, RELEASE };
+//# 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/release.d.ts

@@ -0,0 +1,20 @@
+export interface ReleaseInfo {
+    /** Git tag / release the binary comes from. */
+    tag: string;
+    /** Chromium version the build is based on. */
+    version: string;
+    /** Release asset (zip) file name. */
+    asset: string;
+    /** Direct download URL for the asset. */
+    url: string;
+    /** SHA-256 of the zip — verified after download; mismatch is a hard failure. */
+    sha256: string;
+    /** SHA-256 of chrome.exe inside the zip — verified after extraction (defense in depth). */
+    exeSha256: string;
+    /** Expected zip size in bytes (for progress display only). */
+    size: number;
+    /** Platform the binary runs on. */
+    os: NodeJS.Platform;
+}
+export declare const RELEASE: ReleaseInfo;
+//# sourceMappingURL=release.d.ts.map

package/dist/release.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"release.d.ts","sourceRoot":"","sources":["../src/release.ts"],"names":[],"mappings":"AAMA,MAAM,WAAW,WAAW;IAC1B,+CAA+C;IAC/C,GAAG,EAAE,MAAM,CAAC;IACZ,8CAA8C;IAC9C,OAAO,EAAE,MAAM,CAAC;IAChB,qCAAqC;IACrC,KAAK,EAAE,MAAM,CAAC;IACd,yCAAyC;IACzC,GAAG,EAAE,MAAM,CAAC;IACZ,gFAAgF;IAChF,MAAM,EAAE,MAAM,CAAC;IACf,2FAA2F;IAC3F,SAAS,EAAE,MAAM,CAAC;IAClB,8DAA8D;IAC9D,IAAI,EAAE,MAAM,CAAC;IACb,mCAAmC;IACnC,EAAE,EAAE,MAAM,CAAC,QAAQ,CAAC;CACrB;AAED,eAAO,MAAM,OAAO,EAAE,WASrB,CAAC"}

package/dist/release.js

@@ -0,0 +1,16 @@
+// Pinned Clearcote release the SDK downloads and verifies.
+// Bumping the SDK to a new browser build = updating these constants (and the version in
+// package.json). The sha256 is the SINGLE trust anchor for the auto-download: if you trust
+// this package, the hash check guarantees you run exactly the published, signed binary.
+// Published checksums + GPG signatures live on the release page.
+export const RELEASE = {
+    tag: "v0.1.0-pre.2",
+    version: "149.0.7827.114",
+    asset: "clearcote-149.0.7827.114-windows-x64.zip",
+    url: "https://github.com/clearcotelabs/clearcote-browser/releases/download/v0.1.0-pre.2/clearcote-149.0.7827.114-windows-x64.zip",
+    sha256: "4071aa06add252caa274c4f52dfe2e8eaede4eb37cf55be6fb6f8e3c28bcf256",
+    exeSha256: "5743595256c89c6874804bf3315acce592fc7f1883760c8d380c010151a73b23",
+    size: 253015969,
+    os: "win32",
+};
+//# sourceMappingURL=release.js.map

package/dist/release.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"release.js","sourceRoot":"","sources":["../src/release.ts"],"names":[],"mappings":"AAAA,2DAA2D;AAC3D,wFAAwF;AACxF,2FAA2F;AAC3F,wFAAwF;AACxF,iEAAiE;AAqBjE,MAAM,CAAC,MAAM,OAAO,GAAgB;IAClC,GAAG,EAAE,cAAc;IACnB,OAAO,EAAE,gBAAgB;IACzB,KAAK,EAAE,0CAA0C;IACjD,GAAG,EAAE,4HAA4H;IACjI,MAAM,EAAE,kEAAkE;IAC1E,SAAS,EAAE,kEAAkE;IAC7E,IAAI,EAAE,SAAS;IACf,EAAE,EAAE,OAAO;CACZ,CAAC"}

package/package.json

@@ -0,0 +1,57 @@
+{
+  "name": "clearcote",
+  "version": "0.1.0",
+  "description": "Playwright drop-in for the Clearcote anti-fingerprint Chromium build. launch() returns a standard Playwright Browser backed by the verified Clearcote binary, which is auto-downloaded and SHA-256 checked.",
+  "type": "module",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    }
+  },
+  "files": [
+    "dist",
+    "README.md"
+  ],
+  "engines": {
+    "node": ">=18"
+  },
+  "scripts": {
+    "build": "tsc -p tsconfig.json",
+    "clean": "node -e \"require('fs').rmSync('dist',{recursive:true,force:true})\"",
+    "prepublishOnly": "npm run clean && npm run build"
+  },
+  "dependencies": {
+    "extract-zip": "^2.0.1",
+    "playwright-core": "^1.49.0"
+  },
+  "devDependencies": {
+    "@types/node": "^22.0.0",
+    "typescript": "^5.6.0"
+  },
+  "keywords": [
+    "clearcote",
+    "playwright",
+    "puppeteer",
+    "chromium",
+    "anti-detect",
+    "anti-fingerprint",
+    "fingerprint",
+    "farbling",
+    "automation",
+    "stealth",
+    "ungoogled"
+  ],
+  "license": "BSD-3-Clause",
+  "homepage": "https://github.com/clearcotelabs/clearcote-browser",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/clearcotelabs/clearcote-browser.git",
+    "directory": "sdk/node"
+  },
+  "bugs": {
+    "url": "https://github.com/clearcotelabs/clearcote-browser/issues"
+  }
+}