clearcote 0.28.1 → 0.30.0

package/README.md

@@ -97,6 +97,51 @@ official Docker image also works: `docker run -d --rm -p 9222:9222 teamflatearth
 [`clearcote-mcp`](https://github.com/clearcotelabs/clearcote-browser/tree/main/mcp) server
 (`npx -y clearcote-mcp` or `pip install clearcote-mcp`) — ~20 tools over one shared stealth browser.
 
+### Many identities on one endpoint (`serveMultiplex`, `clearcote serve`)
+
+One port, one browser per identity, chosen by the connection URL:
+
+```ts
+import { chromium } from "playwright-core";
+// in another process:  npx clearcote serve --port 9222 --idle-timeout 300
+const a = await chromium.connectOverCDP("http://127.0.0.1:9222?fingerprint=acct-1&timezone=Europe/Berlin");
+const b = await chromium.connectOverCDP(`http://127.0.0.1:9222?fingerprint=acct-2&proxy=${encodeURIComponent("socks5://u:p@host:1080")}&geoip=true`);
+```
+
+- Query options: `fingerprint`, `timezone`, `locale`, `proxy`, `geoip`, plus any fingerprint option in kebab-case (`platform`, `hardware-concurrency`, `allow-third-party-cookies`, ...). Unknown options are rejected (400).
+- The same identity reuses its browser. Asking for a running identity with *different* options returns 409 — close it first.
+- `GET /` lists running browsers; `POST /fingerprint/<id>/close` stops one; `--idle-timeout <s>` closes a browser after its last client disconnects; `--max-browsers` caps them (default 16).
+- Behind a reverse proxy, WebSocket URLs honour `X-Forwarded-Host` / `X-Forwarded-Proto`; add the public name with `--allow-host`.
+- Binds `127.0.0.1` by default. Requests a web page could make (cross-site fetches, foreign `Origin`, a `Host` that isn't an IP / `localhost` / allowed) are refused.
+
+In code: `serveMultiplex({ port: 9222, idleTimeoutSec: 300, dataDir: "./profiles" })`.
+
+### `clearcote` command line
+
+```bash
+npx clearcote install [--version 152] [--channel preview]
+npx clearcote info [--quick] [--json] [--proxy <url>]   # alias: doctor
+npx clearcote login [key]      # validates the key, saves it to ~/.clearcote/license.key
+npx clearcote logout
+npx clearcote clear-cache
+npx clearcote serve [--port 9222] ...
+```
+
+`info` never downloads: it reports the SDK, the cached builds, which engine features the binary supports, a launch test (skipped with `--quick`), licence seats, fonts and missing system libraries.
+
+### Engine options (PRO 152 r22+)
+
+| Option | Effect |
+|---|---|
+| `fingerprint: "off"` | No persona at all — for telling whether a problem comes from the spoofing or from your environment. |
+| `fingerprintVoices: false` | Keep the host's own `speechSynthesis` voices under a persona. |
+| `allowThirdPartyCookies: true` | Allow third-party cookies (blocked by default), for embedded sign-in, payment and captcha frames. |
+| `transparentProxy: true` | With a proxy: send the headers a direct connection sends, and report connection timing as a reused connection. |
+
+On an older engine each of these is skipped with a warning; the launch still works.
+
+Also: `licenseThroughProxy: true` (or `CLEARCOTE_LICENSE_THROUGH_PROXY=1`) sends the licence calls through the launch proxy; `releaseChannel: "preview"` (or `CLEARCOTE_RELEASE_CHANNEL`) picks up PRO preview builds; `getSessionSeats()` reports seats in use.
+
 ### Through a proxy (report the proxy's IP, not your host's)
 
 ```ts
@@ -122,7 +167,9 @@ const browser = await launch({
 });
 ```
 
-Anything you set explicitly wins over `geoip`. With no proxy it uses your direct connection's IP. The lookup needs an **http(s) proxy** — SOCKS proxies are skipped (set `timezone`/`acceptLanguage` yourself).
+Anything you set explicitly wins over `geoip`. With no proxy it uses your direct connection's IP. The lookup goes through the proxy — http(s) and SOCKS5 (with username/password) alike.
+
+The whole lookup has one deadline, `CLEARCOTE_GEOIP_TIMEOUT_SECONDS` (default 20). If the region can't be resolved in time, `launch()` throws `GeoipError` (code `GEOIP_UNRESOLVED`) **before** any browser starts, instead of launching with this machine's clock and language. If you set both `timezone` and `acceptLanguage` yourself, it warns and launches anyway.
 
 Geo data comes from the offline [geoip-all-in-one](https://github.com/daijro/geoip-all-in-one) MaxMind database (downloaded + cached on first use; GPL-3.0 data, the same source Camoufox uses) — more accurate than a single online API — with `ip-api.com` as a fallback.
 
@@ -433,25 +480,28 @@ contacts the license backend).
 <!-- The rows below mirror site/lib/tiers.ts, which is the single source of truth for the
      free/PRO split. If you change one, change the other (and the sibling SDK README). -->
 
-The identity surface is **free in full**. PRO does not unlock "more spoofing" — every fingerprint
-control below is in the free build. What PRO adds is behavioural realism that needs recorded data
-or engine work held out of the public tree, plus the licensing itself.
-
-| Capability | Free | PRO |
-|---|:---:|:---:|
-| Seeded personas (`fingerprint`), per-site farbling | ✅ | ✅ |
-| Canvas / WebGL / audio / font identity controls | ✅ | ✅ |
-| All 18 metadata overrides (`screenWidth`, `deviceMemory`, `gpuVendor`, …) | ✅ | ✅ |
-| `light_stealth` preset | ✅ | ✅ |
-| TLS ClientHello profile (`tlsProfile`) | ✅ | ✅ |
-| Proxy + `geoip` locale/timezone coherence | ✅ | ✅ |
-| Humanized input (`humanize`) — synthetic bézier paths | ✅ | ✅ |
-| **Humanized input — real recorded human trajectories** | — | ✅ |
-| **Coalesced pointer samples** (`getCoalescedEvents` realism) | — | ✅ |
-| **Coherent WebRTC srflx fabrication** (`webrtcIp`) | — | ✅ |
-| **WebRTC host-candidate concealment** (`.local` names) | — | ✅ |
-| **Request-header hygiene** on revalidation | — | ✅ |
-| Floating-concurrency licensing + run-token gate | — | ✅ |
+The identity surface is **free in full**. A licence does not unlock "more spoofing" — every fingerprint
+control below is in the open build. The licensed build adds behavioural realism that needs recorded
+data or engine work held out of the public tree. **It is free with GitHub for one browser at a time**
+(sign in at [clearcotelabs.com](https://clearcotelabs.com/pricing#free), needs SDK 0.29.0+); **PRO**
+runs as many browsers at once as you need and adds email support.
+
+| Capability | Open source | Free with GitHub | PRO |
+|---|:---:|:---:|:---:|
+| Seeded personas (`fingerprint`), per-site farbling | ✅ | ✅ | ✅ |
+| Canvas / WebGL / audio / font identity controls | ✅ | ✅ | ✅ |
+| All 18 metadata overrides (`screenWidth`, `deviceMemory`, `gpuVendor`, …) | ✅ | ✅ | ✅ |
+| `light_stealth` preset | ✅ | ✅ | ✅ |
+| TLS ClientHello profile (`tlsProfile`) | ✅ | ✅ | ✅ |
+| Proxy + `geoip` locale/timezone coherence | ✅ | ✅ | ✅ |
+| Humanized input (`humanize`) — synthetic bézier paths | ✅ | ✅ | ✅ |
+| **Humanized input — real recorded human trajectories** | — | ✅ | ✅ |
+| **Coalesced pointer samples** (`getCoalescedEvents` realism) | — | ✅ | ✅ |
+| **Coherent WebRTC srflx fabrication** (`webrtcIp`) | — | ✅ | ✅ |
+| **WebRTC host-candidate concealment** (`.local` names) | — | ✅ | ✅ |
+| **Request-header hygiene** on revalidation | — | ✅ | ✅ |
+| Floating-concurrency licensing + run-token gate | — | 1 browser | ✅ unlimited |
+| Email support from the owner | — | — | ✅ |
 
 The mouse tier is decided **at runtime** from a signed claim in the run-token — same SDK call,
 same `humanize: true`. With a valid PRO lease the motion comes from recorded human trajectories;

package/dist/clearcote-cli.d.ts

@@ -0,0 +1,3 @@
+#!/usr/bin/env node
+export {};
+//# sourceMappingURL=clearcote-cli.d.ts.map

package/dist/clearcote-cli.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"clearcote-cli.d.ts","sourceRoot":"","sources":["../src/clearcote-cli.ts"],"names":[],"mappings":""}

package/dist/clearcote-cli.js

@@ -0,0 +1,9 @@
+#!/usr/bin/env node
+// `clearcote` command-line entry. All logic lives in ./cli-commands.ts so it can be imported and
+// tested without running anything; this file only runs it.
+import { main } from "./cli-commands.js";
+main().catch((e) => {
+    process.stderr.write(`clearcote: ${e.message}\n`);
+    process.exitCode = 1;
+});
+//# sourceMappingURL=clearcote-cli.js.map

package/dist/clearcote-cli.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"clearcote-cli.js","sourceRoot":"","sources":["../src/clearcote-cli.ts"],"names":[],"mappings":";AACA,iGAAiG;AACjG,2DAA2D;AAC3D,OAAO,EAAE,IAAI,EAAE,MAAM,mBAAmB,CAAC;AAEzC,IAAI,EAAE,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,EAAE;IACjB,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,cAAe,CAAW,CAAC,OAAO,IAAI,CAAC,CAAC;IAC7D,OAAO,CAAC,QAAQ,GAAG,CAAC,CAAC;AACvB,CAAC,CAAC,CAAC"}

package/dist/cli-commands.d.ts

@@ -0,0 +1,62 @@
+import { type SessionSeats } from "./index.js";
+export declare const USAGE: string;
+/** What `info` reports. Also the `--json` shape. */
+export interface InfoReport {
+    sdk: {
+        version: string;
+        node: string;
+        platform: string;
+    };
+    license: {
+        source: string;
+        key?: string;
+        seats?: SessionSeats;
+    };
+    binary: {
+        source: "CLEARCOTE_BINARY" | "cache" | "none";
+        path?: string;
+        tag?: string;
+        cached: Array<{
+            tag: string;
+            path: string;
+        }>;
+        pinnedFree: string;
+        releaseChannel: string;
+    };
+    engineFeatures?: Record<string, boolean>;
+    launch?: {
+        tested: boolean;
+        ok?: boolean;
+        version?: string;
+        error?: string;
+        missingLibs?: string[];
+        reason?: string;
+    };
+    fonts?: {
+        bundled: boolean;
+        note: string;
+    };
+    geoip: {
+        databaseCached: boolean;
+        path: string;
+        proxy?: {
+            exitIp?: string;
+            country?: string;
+            timezone?: string;
+            acceptLanguage?: string;
+            error?: string;
+        };
+    };
+}
+export declare function buildInfo(flags: {
+    quick?: boolean;
+    proxy?: string;
+}): Promise<InfoReport>;
+export declare function main(argv?: string[]): Promise<void>;
+/** `--proxy scheme://user:pass@host:port` as a launch proxy option with the credentials split out. */
+export declare function proxyOption(url: string): {
+    server: string;
+    username?: string;
+    password?: string;
+};
+//# sourceMappingURL=cli-commands.d.ts.map

package/dist/cli-commands.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli-commands.d.ts","sourceRoot":"","sources":["../src/cli-commands.ts"],"names":[],"mappings":"AAiBA,OAAO,EAcL,KAAK,YAAY,EAClB,MAAM,YAAY,CAAC;AAcpB,eAAO,MAAM,KAAK,QAqBiF,CAAC;AAWpG,oDAAoD;AACpD,MAAM,WAAW,UAAU;IACzB,GAAG,EAAE;QAAE,OAAO,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,MAAM,CAAA;KAAE,CAAC;IACzD,OAAO,EAAE;QAAE,MAAM,EAAE,MAAM,CAAC;QAAC,GAAG,CAAC,EAAE,MAAM,CAAC;QAAC,KAAK,CAAC,EAAE,YAAY,CAAA;KAAE,CAAC;IAChE,MAAM,EAAE;QACN,MAAM,EAAE,kBAAkB,GAAG,OAAO,GAAG,MAAM,CAAC;QAC9C,IAAI,CAAC,EAAE,MAAM,CAAC;QACd,GAAG,CAAC,EAAE,MAAM,CAAC;QACb,MAAM,EAAE,KAAK,CAAC;YAAE,GAAG,EAAE,MAAM,CAAC;YAAC,IAAI,EAAE,MAAM,CAAA;SAAE,CAAC,CAAC;QAC7C,UAAU,EAAE,MAAM,CAAC;QACnB,cAAc,EAAE,MAAM,CAAC;KACxB,CAAC;IACF,cAAc,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACzC,MAAM,CAAC,EAAE;QAAE,MAAM,EAAE,OAAO,CAAC;QAAC,EAAE,CAAC,EAAE,OAAO,CAAC;QAAC,OAAO,CAAC,EAAE,MAAM,CAAC;QAAC,KAAK,CAAC,EAAE,MAAM,CAAC;QAAC,WAAW,CAAC,EAAE,MAAM,EAAE,CAAC;QAAC,MAAM,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;IACtH,KAAK,CAAC,EAAE;QAAE,OAAO,EAAE,OAAO,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC;IAC3C,KAAK,EAAE;QAAE,cAAc,EAAE,OAAO,CAAC;QAAC,IAAI,EAAE,MAAM,CAAC;QAAC,KAAK,CAAC,EAAE;YAAE,MAAM,CAAC,EAAE,MAAM,CAAC;YAAC,OAAO,CAAC,EAAE,MAAM,CAAC;YAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;YAAC,cAAc,CAAC,EAAE,MAAM,CAAC;YAAC,KAAK,CAAC,EAAE,MAAM,CAAA;SAAE,CAAA;KAAE,CAAC;CAC7J;AAYD,wBAAsB,SAAS,CAAC,KAAK,EAAE;IAAE,KAAK,CAAC,EAAE,OAAO,CAAC;IAAC,KAAK,CAAC,EAAE,MAAM,CAAA;CAAE,GAAG,OAAO,CAAC,UAAU,CAAC,CAkE/F;AAyDD,wBAAsB,IAAI,CAAC,IAAI,WAAwB,GAAG,OAAO,CAAC,IAAI,CAAC,CA0HtE;AAED,sGAAsG;AACtG,wBAAgB,WAAW,CAAC,GAAG,EAAE,MAAM,GAAG;IAAE,MAAM,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,EAAE,MAAM,CAAA;CAAE,CAKjG"}

package/dist/cli-commands.js

@@ -0,0 +1,333 @@
+// clearcote — manage the browser binary, diagnose a setup, save a licence key, run a CDP endpoint.
+//
+//   clearcote install [--version 152] [--channel preview]   download + verify the binary
+//   clearcote info    [--quick] [--json] [--proxy URL]      diagnostics (alias: doctor)
+//   clearcote update  [--channel preview]                   fetch a newer build if one exists
+//   clearcote clear-cache                                   delete every cached binary
+//   clearcote login   [key]                                 save a licence key (validated first)
+//   clearcote logout                                        remove the saved key
+//   clearcote serve   [--port 9222] [--idle-timeout 300] …  multi-identity CDP endpoint
+//
+// `info` never downloads: it reports what is already cached and what a launch would resolve to.
+import { parseArgs } from "node:util";
+import * as readline from "node:readline";
+import { existsSync, readdirSync, readFileSync, rmSync, statSync } from "node:fs";
+import { spawnSync } from "node:child_process";
+import { dirname, join } from "node:path";
+import { download, launch, getSessionSeats, saveLicenseKey, removeLicenseKey, licenseKeySource, licenseKeyPath, resolveLicenseKey, resolveGeoDetailed, resolveReleaseChannel, engineSupportsSwitch, serveMultiplex, RELEASE, } from "./index.js";
+import { defaultCacheRoot, listCachedBuilds } from "./download.js";
+import { geoCacheRoot } from "./geoip.js";
+import { GATED_ENGINE_SWITCHES } from "./launchopts.js";
+import { toProxySpec } from "./net.js";
+const SDK_VERSION = (() => {
+    try {
+        return JSON.parse(readFileSync(new URL("../package.json", import.meta.url), "utf8")).version;
+    }
+    catch {
+        return "unknown";
+    }
+})();
+export const USAGE = `clearcote ${SDK_VERSION} — manage and diagnose the Clearcote browser.
+
+USAGE
+  clearcote install [--version <v>] [--channel stable|preview]
+  clearcote info [--quick] [--json] [--proxy <url>]      (alias: doctor)
+  clearcote update [--channel stable|preview]
+  clearcote clear-cache
+  clearcote login [key]
+  clearcote logout
+  clearcote serve [--port 9222] [--host 127.0.0.1] [--idle-timeout <s>] [--data-dir <dir>]
+                  [--max-browsers 16] [--allow-origin <origin>]... [--allow-host <name>]... [--headed]
+                  [--fingerprint <seed>] [--platform <os>] [--proxy <url>] [--timezone <tz>]
+                  [--accept-language <l>] [--geoip]
+
+INFO FLAGS
+  --quick          skip everything that needs the network or a launch (seat count, launch test)
+  --json           machine-readable output
+  --proxy <url>    resolve the exit IP, timezone and language a launch through this proxy would use
+
+ENVIRONMENT
+  CLEARCOTE_LICENSE_KEY, CLEARCOTE_RELEASE_CHANNEL, CLEARCOTE_GEOIP_TIMEOUT_SECONDS,
+  CLEARCOTE_LICENSE_THROUGH_PROXY, CLEARCOTE_BINARY, CLEARCOTE_CACHE, CLEARCOTE_SERVE_IDLE_TIMEOUT`;
+function out(line = "") {
+    process.stdout.write(line + "\n");
+}
+function fail(msg, code = 1) {
+    process.stderr.write(`clearcote: ${msg}\n`);
+    process.exit(code);
+}
+function geoDbPath() {
+    return join(geoCacheRoot(), "geoip-aio-all.mmdb");
+}
+function missingSharedLibs(exe) {
+    if (process.platform !== "linux")
+        return [];
+    const r = spawnSync("ldd", ["--", exe], { encoding: "utf8" });
+    return (r.stdout || "").split("\n").filter((l) => l.includes("not found")).map((l) => l.trim().split(" ")[0]);
+}
+export async function buildInfo(flags) {
+    const src = licenseKeySource();
+    let channel;
+    try {
+        channel = resolveReleaseChannel();
+    }
+    catch (e) {
+        channel = `invalid (${e.message})`;
+    }
+    const cached = listCachedBuilds();
+    const envBinary = process.env.CLEARCOTE_BINARY;
+    const pick = envBinary ? { path: envBinary } : cached[0];
+    const report = {
+        sdk: { version: SDK_VERSION, node: process.version, platform: `${process.platform}-${process.arch}` },
+        license: { source: src.source, ...(src.masked ? { key: src.masked } : {}) },
+        binary: {
+            source: envBinary ? "CLEARCOTE_BINARY" : pick ? "cache" : "none",
+            ...(pick ? { path: pick.path } : {}),
+            ...(!envBinary && pick ? { tag: pick.tag } : {}),
+            cached,
+            pinnedFree: `${RELEASE.version} (${RELEASE.tag})`,
+            releaseChannel: channel,
+        },
+        geoip: { databaseCached: existsSync(geoDbPath()), path: geoDbPath() },
+    };
+    if (pick && existsSync(pick.path)) {
+        report.engineFeatures = Object.fromEntries(["proxy-auth", "socks5-credentials", "socks5-udp", ...Object.keys(GATED_ENGINE_SWITCHES).map((s) => s.slice(2))]
+            .map((name) => [name, engineSupportsSwitch(pick.path, name)]));
+    }
+    if (process.platform === "linux" && pick) {
+        const template = join(dirname(pick.path), "fonts", "fonts.conf.template");
+        report.fonts = existsSync(template)
+            ? { bundled: true, note: "metric-compatible Windows font clones are bundled with this build" }
+            : { bundled: false, note: "this build ships no font bundle; a Windows persona on this host may render with Linux fonts" };
+    }
+    if (!flags.quick && src.source !== "none") {
+        report.license.seats = await getSessionSeats();
+    }
+    if (flags.quick) {
+        report.launch = { tested: false, reason: "skipped (--quick)" };
+    }
+    else if (!pick) {
+        report.launch = { tested: false, reason: "no binary installed — run: clearcote install" };
+    }
+    else {
+        try {
+            const b = await launch({ executablePath: pick.path, headless: true, quiet: true, ephemeralProfile: false });
+            const version = b.version();
+            await b.close();
+            report.launch = { tested: true, ok: true, version };
+        }
+        catch (e) {
+            const libs = missingSharedLibs(pick.path);
+            report.launch = { tested: true, ok: false, error: e.message.split("\n")[0], ...(libs.length ? { missingLibs: libs } : {}) };
+        }
+    }
+    if (flags.proxy) {
+        const r = await resolveGeoDetailed(flags.proxy, { quiet: true });
+        report.geoip.proxy = r.geo && r.geo.timezone
+            ? { exitIp: r.geo.ip, country: r.geo.country, timezone: r.geo.timezone, acceptLanguage: r.geo.acceptLanguage }
+            : { error: r.reason };
+    }
+    return report;
+}
+function printInfo(r) {
+    const ok = (b) => (b ? "yes" : "no");
+    out(`clearcote SDK   ${r.sdk.version}  (node ${r.sdk.node}, ${r.sdk.platform})`);
+    out(`Licence         ${r.license.source === "none" ? "none (free build)" : `${r.license.key} from ${r.license.source}`}`);
+    const seats = r.license.seats;
+    if (seats) {
+        if (seats.state === "ok")
+            out(`Seats           ${seats.used} of ${seats.limit ?? "unlimited"} in use${seats.plan ? `  (plan: ${seats.plan})` : ""}`);
+        else
+            out(`Seats           unavailable: ${seats.reason ?? seats.state}`);
+    }
+    out(`Binary          ${r.binary.path ? `${r.binary.path}${r.binary.tag ? `  [${r.binary.tag}]` : ""} (${r.binary.source})` : "not installed — run: clearcote install"}`);
+    out(`Release channel ${r.binary.releaseChannel}`);
+    out(`Free pin        ${r.binary.pinnedFree}`);
+    if (r.binary.cached.length > 1)
+        out(`Also cached     ${r.binary.cached.slice(1).map((c) => c.tag).join(", ")}`);
+    if (r.engineFeatures) {
+        out(`Engine support  ${Object.entries(r.engineFeatures).map(([k, v]) => `${k}=${ok(v)}`).join("  ")}`);
+    }
+    if (r.launch) {
+        if (!r.launch.tested)
+            out(`Launch test     ${r.launch.reason}`);
+        else if (r.launch.ok)
+            out(`Launch test     ok (${r.launch.version})`);
+        else {
+            out(`Launch test     FAILED: ${r.launch.error}`);
+            for (const lib of r.launch.missingLibs ?? [])
+                out(`                missing library: ${lib}`);
+        }
+    }
+    if (r.fonts)
+        out(`Fonts           ${r.fonts.note}`);
+    out(`GeoIP database  ${r.geoip.databaseCached ? "cached" : "not cached (downloaded on first geoip launch)"}`);
+    if (r.geoip.proxy) {
+        const p = r.geoip.proxy;
+        out(p.error ? `Proxy geo       FAILED: ${p.error}` : `Proxy geo       exit ${p.exitIp} (${p.country})  timezone ${p.timezone}  language ${p.acceptLanguage}`);
+    }
+}
+async function promptKey() {
+    if (!process.stdin.isTTY) {
+        fail("no key given. Run `clearcote login <key>`, or copy a key from https://www.clearcotelabs.com/dashboard/licenses");
+    }
+    const rl = readline.createInterface({ input: process.stdin, output: process.stderr });
+    const key = await new Promise((resolve) => rl.question("Paste your licence key (https://www.clearcotelabs.com/dashboard/licenses): ", (a) => resolve(a)));
+    rl.close();
+    return key.trim();
+}
+function dirSize(p) {
+    let total = 0;
+    try {
+        for (const e of readdirSync(p, { withFileTypes: true })) {
+            const full = join(p, e.name);
+            total += e.isDirectory() ? dirSize(full) : statSync(full).size;
+        }
+    }
+    catch { /* unreadable — skip */ }
+    return total;
+}
+export async function main(argv = process.argv.slice(2)) {
+    const [cmd, ...rest] = argv;
+    if (!cmd || cmd === "-h" || cmd === "--help" || cmd === "help") {
+        out(USAGE);
+        return;
+    }
+    if (cmd === "version" || cmd === "--version") {
+        out(SDK_VERSION);
+        return;
+    }
+    if (cmd === "info" || cmd === "doctor") {
+        const { values } = parseArgs({ args: rest, options: { quick: { type: "boolean" }, "no-launch": { type: "boolean" }, json: { type: "boolean" }, proxy: { type: "string" } } });
+        const report = await buildInfo({ quick: !!(values.quick || values["no-launch"]), proxy: values.proxy });
+        if (values.json)
+            out(JSON.stringify(report, null, 2));
+        else
+            printInfo(report);
+        return;
+    }
+    if (cmd === "install" || cmd === "update") {
+        const { values } = parseArgs({ args: rest, options: { version: { type: "string" }, channel: { type: "string" } } });
+        const releaseChannel = resolveReleaseChannel(values.channel);
+        const licenseKey = resolveLicenseKey();
+        const path = await download({
+            version: values.version,
+            releaseChannel,
+            licenseKey,
+            // update: re-resolve the newest build instead of reusing the SDK's pin (free) — PRO always asks the server
+            ...(cmd === "update" ? { autoUpdate: true } : {}),
+        });
+        out(path);
+        return;
+    }
+    if (cmd === "clear-cache") {
+        const root = defaultCacheRoot();
+        if (!existsSync(root)) {
+            out(`nothing to clear (${root} does not exist)`);
+            return;
+        }
+        // Only build directories: a CLEARCOTE_CACHE pointing at $HOME or a shared directory must not
+        // become `rm -rf` of that directory. A build dir carries a .verified marker once complete; a
+        // half-finished download has the build-tag name but no marker yet.
+        let bytes = 0;
+        const removed = [];
+        for (const name of readdirSync(root)) {
+            const dir = join(root, name);
+            let isDir = false;
+            try {
+                isDir = statSync(dir).isDirectory();
+            }
+            catch { /* vanished */ }
+            if (!isDir)
+                continue;
+            if (!existsSync(join(dir, ".verified")) && !/^(pro-\d|v\d)/.test(name))
+                continue;
+            bytes += dirSize(dir);
+            rmSync(dir, { recursive: true, force: true });
+            removed.push(name);
+        }
+        out(removed.length
+            ? `removed ${removed.length} cached build${removed.length === 1 ? "" : "s"} from ${root} (${(bytes / 1e6).toFixed(0)} MB)`
+            : `no cached builds in ${root}`);
+        return;
+    }
+    if (cmd === "login") {
+        const key = rest[0] ?? (await promptKey());
+        if (!key)
+            fail("empty key");
+        const seats = await getSessionSeats({ licenseKey: key });
+        if (seats.state === "invalid")
+            fail(`the licence server rejected this key (${seats.reason}). Nothing was saved.`);
+        const where = saveLicenseKey(key);
+        out(`saved to ${where}`);
+        if (seats.state === "ok")
+            out(`valid: ${seats.used} of ${seats.limit ?? "unlimited"} seats in use${seats.plan ? `, plan ${seats.plan}` : ""}`);
+        else
+            out(`note: could not confirm the key right now (${seats.reason}); it was saved anyway`);
+        return;
+    }
+    if (cmd === "logout") {
+        const removed = removeLicenseKey();
+        out(removed ? `removed ${licenseKeyPath()}` : "no saved key");
+        if (process.env.CLEARCOTE_LICENSE_KEY)
+            out("note: CLEARCOTE_LICENSE_KEY is still set in this environment and will keep being used");
+        return;
+    }
+    if (cmd === "serve") {
+        const { values } = parseArgs({
+            args: rest,
+            options: {
+                port: { type: "string" }, host: { type: "string" }, "idle-timeout": { type: "string" }, "data-dir": { type: "string" },
+                "max-browsers": { type: "string" }, "allow-origin": { type: "string", multiple: true }, "allow-host": { type: "string", multiple: true }, headed: { type: "boolean" },
+                fingerprint: { type: "string" }, platform: { type: "string" }, proxy: { type: "string" }, timezone: { type: "string" },
+                "accept-language": { type: "string" }, geoip: { type: "boolean" }, quiet: { type: "boolean" },
+            },
+        });
+        const num = (name, v) => {
+            if (v === undefined)
+                return undefined;
+            const n = Number(v);
+            if (!Number.isFinite(n) || n < 0)
+                fail(`--${name} must be a non-negative number`);
+            return n;
+        };
+        const srv = await serveMultiplex({
+            port: num("port", values.port) ?? 9222,
+            host: values.host,
+            idleTimeoutSec: num("idle-timeout", values["idle-timeout"]),
+            dataDir: values["data-dir"],
+            maxBrowsers: num("max-browsers", values["max-browsers"]),
+            allowOrigins: values["allow-origin"],
+            allowHosts: values["allow-host"],
+            headless: !values.headed,
+            quiet: values.quiet,
+            ...(values.fingerprint ? { fingerprint: values.fingerprint } : {}),
+            ...(values.platform ? { platform: values.platform } : {}),
+            // Split user:pass out of the URL: Chromium rejects a --proxy-server that carries credentials
+            // and goes DIRECT, so passing the URL through whole leaked the host's real IP.
+            ...(values.proxy ? { proxy: proxyOption(values.proxy) } : {}),
+            ...(values.timezone ? { timezone: values.timezone } : {}),
+            ...(values["accept-language"] ? { acceptLanguage: values["accept-language"] } : {}),
+            ...(values.geoip ? { geoip: true } : {}),
+        });
+        const stop = () => { void srv.close().then(() => process.exit(0)); };
+        process.once("SIGINT", stop);
+        process.once("SIGTERM", stop);
+        return; // keep running
+    }
+    fail(`unknown command '${cmd}'. Run \`clearcote --help\`.`, 2);
+}
+/** `--proxy scheme://user:pass@host:port` as a launch proxy option with the credentials split out. */
+export function proxyOption(url) {
+    let spec;
+    try {
+        spec = toProxySpec(url);
+    }
+    catch {
+        spec = null;
+    }
+    if (!spec)
+        fail(`--proxy must be a URL such as http://user:pass@host:8080 or socks5://host:1080`);
+    return { server: spec.server, ...(spec.username ? { username: spec.username } : {}), ...(spec.password ? { password: spec.password } : {}) };
+}
+//# sourceMappingURL=cli-commands.js.map

package/dist/cli-commands.js.map

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

package/dist/download.d.ts

@@ -28,6 +28,12 @@ export interface DownloadOptions {
      * (or bare `"r7"`), which also requires a license. Also set via `CLEARCOTE_BROWSER_VERSION`.
      */
     version?: string;
+    /**
+     * PRO release channel: `"stable"` (default) or `"preview"`. Preview selects the newest build
+     * available for this platform — a newer preview when one exists, otherwise stable. An exact
+     * version pin overrides the channel. Also set via `CLEARCOTE_RELEASE_CHANNEL`.
+     */
+    releaseChannel?: ReleaseChannel;
 }
 /** A resolved release to fetch — either the pinned {@link RELEASE} or one discovered at runtime. */
 interface ResolvedRelease extends ReleaseInfo {
@@ -38,6 +44,8 @@ interface ResolvedRelease extends ReleaseInfo {
     /** URL of the public signing key (auto-update only). */
     keyUrl?: string;
 }
+/** Per-OS cache root for downloaded browsers (CLEARCOTE_CACHE overrides). */
+export declare function defaultCacheRoot(): string;
 export declare const MANIFEST = ".manifest.json";
 /**
  * Snapshot every extracted file's size next to the tree, so a LATER launch can tell a healthy
@@ -108,7 +116,17 @@ export declare function ensureVersion(selector: string, opts?: {
     apiBase?: string;
     cacheDir?: string;
     quiet?: boolean;
+    releaseChannel?: string;
 }): Promise<string>;
+/** Release channel for PRO builds: "stable" (default) or "preview". */
+export type ReleaseChannel = "stable" | "preview";
+/**
+ * Resolve the release channel: explicit option > CLEARCOTE_RELEASE_CHANNEL > "stable".
+ * Unknown values throw, so a typo never silently selects a different build.
+ */
+export declare function resolveReleaseChannel(explicit?: string, env?: Record<string, string | undefined>): ReleaseChannel;
+/** The PRO download URL for a platform, version selector and channel. */
+export declare function proDownloadUrl(baseUrl: string, plat: "windows" | "linux", version?: string, channel?: ReleaseChannel): string;
 /** Options for {@link proEnsureBinary}. */
 export interface ProDownloadOptions {
     /** License API base (default: `CLEARCOTE_LICENSE_API` env or clearcotelabs.com). */
@@ -119,6 +137,8 @@ export interface ProDownloadOptions {
     quiet?: boolean;
     /** Request a specific PRO major/version; the server returns the newest match. */
     version?: string;
+    /** "preview" gets the newest build for this platform, preview or stable (default "stable"). */
+    releaseChannel?: ReleaseChannel;
 }
 /**
  * Download + verify the PRO (license-gated) browser and return its chrome path.
@@ -136,5 +156,13 @@ export declare function proEnsureBinary(licenseKey: string, opts?: ProDownloadOp
  * Cached per release tag, so subsequent calls are instant.
  */
 export declare function ensureBinary(opts?: DownloadOptions): Promise<string>;
+/**
+ * Verified browser builds already in the cache, newest first (by directory mtime). Never downloads
+ * and never deletes: unlike cachedBinary(), a damaged entry is simply left out of the list.
+ */
+export declare function listCachedBuilds(cacheDir?: string): Array<{
+    tag: string;
+    path: string;
+}>;
 export {};
 //# sourceMappingURL=download.d.ts.map

package/dist/download.d.ts.map

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