@page-scanner/cli 0.1.0

package/dist/bin.js

@@ -0,0 +1,49 @@
+#!/usr/bin/env node
+/**
+ * The `page-scanner` command. Argument parsing, dispatch, exit code.
+ *
+ * Everything else lives behind `runCommand`, so the same behaviour is
+ * reachable from `import { scan } from '@page-scanner/cli'` without a process.
+ */
+import { parseArgs } from './cli/args.js';
+import { runCommand } from './cli/commands.js';
+import { exitCodeFor, toPageScannerError } from './errors.js';
+const io = {
+    stdout: (text) => void process.stdout.write(text),
+    stderr: (text) => void process.stderr.write(text),
+};
+async function main() {
+    try {
+        const parsed = parseArgs(process.argv.slice(2));
+        return { code: await runCommand(parsed, io), command: parsed.command };
+    }
+    catch (error) {
+        // Only parseArgs can land here, and it failed before it could tell us
+        // whether --json was asked for. The flag is read off the raw argv rather
+        // than assumed absent: `--json` promises one JSON document on stdout for
+        // a failure as much as for a success, and a parse error is the failure a
+        // script is most likely to hit.
+        const failure = toPageScannerError(error);
+        const code = exitCodeFor(failure.code);
+        if (process.argv.slice(2).includes('--json')) {
+            const envelope = { ok: false, code, error: failure.code, message: failure.message };
+            process.stdout.write(`${JSON.stringify(envelope, null, 2)}\n`);
+        }
+        else {
+            process.stderr.write(`${failure.message}\n`);
+            if (failure.hint)
+                process.stderr.write(`${failure.hint}\n`);
+            process.stderr.write('Run `page-scanner --help` for the full surface.\n');
+        }
+        return { code, command: 'help' };
+    }
+}
+const { code, command } = await main();
+process.exitCode = code;
+if (command !== 'serve') {
+    // `fetch` keeps its connection pooled, which holds the event loop open for
+    // several seconds after the answer has been printed. Leave once the streams
+    // have flushed rather than making every command look slow.
+    process.stdout.write('', () => process.exit(code));
+}
+//# sourceMappingURL=bin.js.map

package/dist/bin.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"bin.js","sourceRoot":"","sources":["../src/bin.ts"],"names":[],"mappings":";AACA;;;;;GAKG;AACH,OAAO,EAAE,SAAS,EAAE,MAAM,eAAe,CAAC;AAC1C,OAAO,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAC/C,OAAO,EAAE,WAAW,EAAE,kBAAkB,EAAE,MAAM,aAAa,CAAC;AAE9D,MAAM,EAAE,GAAG;IACT,MAAM,EAAE,CAAC,IAAY,EAAE,EAAE,CAAC,KAAK,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC;IACzD,MAAM,EAAE,CAAC,IAAY,EAAE,EAAE,CAAC,KAAK,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC;CAC1D,CAAC;AAEF,KAAK,UAAU,IAAI;IACjB,IAAI,CAAC;QACH,MAAM,MAAM,GAAG,SAAS,CAAC,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC;QAChD,OAAO,EAAE,IAAI,EAAE,MAAM,UAAU,CAAC,MAAM,EAAE,EAAE,CAAC,EAAE,OAAO,EAAE,MAAM,CAAC,OAAO,EAAE,CAAC;IACzE,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,sEAAsE;QACtE,yEAAyE;QACzE,yEAAyE;QACzE,yEAAyE;QACzE,gCAAgC;QAChC,MAAM,OAAO,GAAG,kBAAkB,CAAC,KAAK,CAAC,CAAC;QAC1C,MAAM,IAAI,GAAG,WAAW,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;QACvC,IAAI,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,QAAQ,CAAC,EAAE,CAAC;YAC7C,MAAM,QAAQ,GAAG,EAAE,EAAE,EAAE,KAAK,EAAE,IAAI,EAAE,KAAK,EAAE,OAAO,CAAC,IAAI,EAAE,OAAO,EAAE,OAAO,CAAC,OAAO,EAAE,CAAC;YACpF,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,GAAG,IAAI,CAAC,SAAS,CAAC,QAAQ,EAAE,IAAI,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC;QACjE,CAAC;aAAM,CAAC;YACN,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,GAAG,OAAO,CAAC,OAAO,IAAI,CAAC,CAAC;YAC7C,IAAI,OAAO,CAAC,IAAI;gBAAE,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,GAAG,OAAO,CAAC,IAAI,IAAI,CAAC,CAAC;YAC5D,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,mDAAmD,CAAC,CAAC;QAC5E,CAAC;QACD,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,MAAM,EAAE,CAAC;IACnC,CAAC;AACH,CAAC;AAED,MAAM,EAAE,IAAI,EAAE,OAAO,EAAE,GAAG,MAAM,IAAI,EAAE,CAAC;AACvC,OAAO,CAAC,QAAQ,GAAG,IAAI,CAAC;AAExB,IAAI,OAAO,KAAK,OAAO,EAAE,CAAC;IACxB,2EAA2E;IAC3E,4EAA4E;IAC5E,2DAA2D;IAC3D,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE,EAAE,GAAG,EAAE,CAAC,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC;AACrD,CAAC"}

package/dist/bridge/server.d.ts

@@ -0,0 +1,97 @@
+/**
+ * The server half of the bridge: one WebSocket listener, many browsers.
+ *
+ * Chrome runs a separate copy of the extension in every profile, so a machine
+ * with a work profile and a personal profile has two extensions dialling in
+ * here. Each announces a `browserId` and a `label` in its handshake, and a
+ * caller names one of those when it asks for something.
+ *
+ * Bound to 127.0.0.1 only. Three checks on every connection: the `Origin` has
+ * to be a `chrome-extension://` one (which stops a web page in any browser
+ * talking to us), the first frame has to carry the shared token (which stops
+ * any other program on this machine doing so, since a local process can forge
+ * an Origin header), and the protocol number has to match.
+ *
+ * Ported from mcp/src/bridge-server.js with three defects fixed:
+ *
+ *  - Pending requests were keyed `req-N` in one map shared by every browser,
+ *    so a reply from one profile could settle a request sent to another. Each
+ *    connection now owns its own map and its own counter, and a frame is only
+ *    matched against the map of the socket it arrived on.
+ *  - `close()` cleared the pending timers without settling the promises, so a
+ *    caller waiting on a scan when the server shut down waited for ever. Every
+ *    outstanding request is now rejected, on disconnect and on shutdown.
+ *  - There were no connection events and no way to wait for one, which is what
+ *    `--wait` needs: the extension's service worker retires after about thirty
+ *    seconds and reconnects when it wakes.
+ */
+import { EventEmitter } from 'node:events';
+import { type ScanRequest, type ScanResultResponse, type TabsResponse } from '../protocol.js';
+/** How long a request waits for a browser to answer before it is given up on. */
+export declare const DEFAULT_REQUEST_TIMEOUT_MS = 120000;
+/** Close codes. 4000-4999 is the range an application may define. */
+export declare const CLOSE_REPLACED = 4000;
+export declare const CLOSE_BAD_TOKEN = 4001;
+export declare const CLOSE_BAD_PROTOCOL = 4002;
+export declare const CLOSE_BAD_ORIGIN = 4003;
+export declare const CLOSE_NO_HANDSHAKE = 4008;
+export interface ConnectedBrowser {
+    browserId: string;
+    label: string;
+    extensionVersion: string;
+    connectedForMs: number;
+}
+export interface BridgeServerOptions {
+    port: number;
+    token: string;
+    log?: (message: string) => void;
+    requestTimeoutMs?: number;
+    /** Injectable so the tests are not at the mercy of the wall clock. */
+    now?: () => number;
+}
+export declare class BridgeServer extends EventEmitter {
+    /**
+     * The port actually in use. It starts as the one that was asked for and
+     * becomes the bound one once `start()` resolves, which is the difference
+     * that matters when 0 was requested: `daemon.json` records this, and a
+     * recorded 0 would send the extension nowhere.
+     */
+    port: number;
+    private readonly token;
+    private readonly log;
+    private readonly requestTimeoutMs;
+    private readonly now;
+    private readonly browsers;
+    private wss;
+    constructor(options: BridgeServerOptions);
+    /** Resolves with the port actually bound, which matters when 0 was asked for. */
+    start(): Promise<number>;
+    private accept;
+    private rejectPending;
+    private describe;
+    /** Everything currently paired and connected. */
+    listBrowsers(): ConnectedBrowser[];
+    /**
+     * Picks the browser a request meant.
+     *
+     * With one browser connected, naming it is optional: that is the common case
+     * and making a caller look it up first would be noise. With several, the
+     * caller has to choose, and the error says what the options are. A label
+     * works as well as an id, because an id is a uuid nobody wants to type.
+     */
+    resolveBrowser(browserId?: string): string;
+    /**
+     * Waits for a browser to connect, which is what `--wait` is for: Chrome
+     * retires the extension's service worker after about thirty seconds of
+     * silence, and it dials back in when something wakes it.
+     */
+    waitForBrowser({ timeoutMs, browserId, }: {
+        timeoutMs: number;
+        browserId?: string;
+    }): Promise<string>;
+    private request;
+    listTabs(browserId: string, timeoutMs?: number): Promise<TabsResponse>;
+    scan(browserId: string, request: Omit<ScanRequest, 'type' | 'id'>, timeoutMs?: number): Promise<ScanResultResponse>;
+    close(): Promise<void>;
+}
+//# sourceMappingURL=server.d.ts.map

package/dist/bridge/server.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"server.d.ts","sourceRoot":"","sources":["../../src/bridge/server.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AACH,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAK3C,OAAO,EAQL,KAAK,WAAW,EAChB,KAAK,kBAAkB,EACvB,KAAK,YAAY,EAClB,MAAM,gBAAgB,CAAC;AAGxB,iFAAiF;AACjF,eAAO,MAAM,0BAA0B,SAAU,CAAC;AAKlD,qEAAqE;AACrE,eAAO,MAAM,cAAc,OAAO,CAAC;AACnC,eAAO,MAAM,eAAe,OAAO,CAAC;AACpC,eAAO,MAAM,kBAAkB,OAAO,CAAC;AACvC,eAAO,MAAM,gBAAgB,OAAO,CAAC;AACrC,eAAO,MAAM,kBAAkB,OAAO,CAAC;AAEvC,MAAM,WAAW,gBAAgB;IAC/B,SAAS,EAAE,MAAM,CAAC;IAClB,KAAK,EAAE,MAAM,CAAC;IACd,gBAAgB,EAAE,MAAM,CAAC;IACzB,cAAc,EAAE,MAAM,CAAC;CACxB;AAED,MAAM,WAAW,mBAAmB;IAClC,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;IACd,GAAG,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,IAAI,CAAC;IAChC,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,sEAAsE;IACtE,GAAG,CAAC,EAAE,MAAM,MAAM,CAAC;CACpB;AAmBD,qBAAa,YAAa,SAAQ,YAAY;IAC5C;;;;;OAKG;IACH,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAS;IAC/B,OAAO,CAAC,QAAQ,CAAC,GAAG,CAA4B;IAChD,OAAO,CAAC,QAAQ,CAAC,gBAAgB,CAAS;IAC1C,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAe;IACnC,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAmC;IAC5D,OAAO,CAAC,GAAG,CAAgC;gBAE/B,OAAO,EAAE,mBAAmB;IASxC,iFAAiF;IACjF,KAAK,IAAI,OAAO,CAAC,MAAM,CAAC;IAoBxB,OAAO,CAAC,MAAM;IAoHd,OAAO,CAAC,aAAa;IAQrB,OAAO,CAAC,QAAQ;IAShB,iDAAiD;IACjD,YAAY,IAAI,gBAAgB,EAAE;IAIlC;;;;;;;OAOG;IACH,cAAc,CAAC,SAAS,CAAC,EAAE,MAAM,GAAG,MAAM;IAyC1C;;;;OAIG;IACH,cAAc,CAAC,EACb,SAAS,EACT,SAAS,GACV,EAAE;QACD,SAAS,EAAE,MAAM,CAAC;QAClB,SAAS,CAAC,EAAE,MAAM,CAAC;KACpB,GAAG,OAAO,CAAC,MAAM,CAAC;IAyCnB,OAAO,CAAC,OAAO;IAqCT,QAAQ,CAAC,SAAS,EAAE,MAAM,EAAE,SAAS,SAAwB,GAAG,OAAO,CAAC,YAAY,CAAC;IAQrF,IAAI,CACR,SAAS,EAAE,MAAM,EACjB,OAAO,EAAE,IAAI,CAAC,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC,EACzC,SAAS,SAAwB,GAChC,OAAO,CAAC,kBAAkB,CAAC;IAQxB,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;CAW7B"}

package/dist/bridge/server.js

@@ -0,0 +1,329 @@
+/**
+ * The server half of the bridge: one WebSocket listener, many browsers.
+ *
+ * Chrome runs a separate copy of the extension in every profile, so a machine
+ * with a work profile and a personal profile has two extensions dialling in
+ * here. Each announces a `browserId` and a `label` in its handshake, and a
+ * caller names one of those when it asks for something.
+ *
+ * Bound to 127.0.0.1 only. Three checks on every connection: the `Origin` has
+ * to be a `chrome-extension://` one (which stops a web page in any browser
+ * talking to us), the first frame has to carry the shared token (which stops
+ * any other program on this machine doing so, since a local process can forge
+ * an Origin header), and the protocol number has to match.
+ *
+ * Ported from mcp/src/bridge-server.js with three defects fixed:
+ *
+ *  - Pending requests were keyed `req-N` in one map shared by every browser,
+ *    so a reply from one profile could settle a request sent to another. Each
+ *    connection now owns its own map and its own counter, and a frame is only
+ *    matched against the map of the socket it arrived on.
+ *  - `close()` cleared the pending timers without settling the promises, so a
+ *    caller waiting on a scan when the server shut down waited for ever. Every
+ *    outstanding request is now rejected, on disconnect and on shutdown.
+ *  - There were no connection events and no way to wait for one, which is what
+ *    `--wait` needs: the extension's service worker retires after about thirty
+ *    seconds and reconnects when it wakes.
+ */
+import { EventEmitter } from 'node:events';
+import { WebSocketServer } from 'ws';
+import { PageScannerError } from '../errors.js';
+import { BRIDGE_PROTOCOL_VERSION, helloAck, helloReject, isHelloFrame, isPingFrame, parseInbound, } from '../protocol.js';
+import { tokensMatch } from './tokens.js';
+/** How long a request waits for a browser to answer before it is given up on. */
+export const DEFAULT_REQUEST_TIMEOUT_MS = 120_000;
+/** A connection that never says hello is not allowed to linger. */
+const HANDSHAKE_TIMEOUT_MS = 10_000;
+/** Close codes. 4000-4999 is the range an application may define. */
+export const CLOSE_REPLACED = 4000;
+export const CLOSE_BAD_TOKEN = 4001;
+export const CLOSE_BAD_PROTOCOL = 4002;
+export const CLOSE_BAD_ORIGIN = 4003;
+export const CLOSE_NO_HANDSHAKE = 4008;
+export class BridgeServer extends EventEmitter {
+    /**
+     * The port actually in use. It starts as the one that was asked for and
+     * becomes the bound one once `start()` resolves, which is the difference
+     * that matters when 0 was requested: `daemon.json` records this, and a
+     * recorded 0 would send the extension nowhere.
+     */
+    port;
+    token;
+    log;
+    requestTimeoutMs;
+    now;
+    browsers = new Map();
+    wss = null;
+    constructor(options) {
+        super();
+        this.port = options.port;
+        this.token = options.token;
+        this.log = options.log ?? (() => { });
+        this.requestTimeoutMs = options.requestTimeoutMs ?? DEFAULT_REQUEST_TIMEOUT_MS;
+        this.now = options.now ?? Date.now;
+    }
+    /** Resolves with the port actually bound, which matters when 0 was asked for. */
+    start() {
+        return new Promise((resolve, reject) => {
+            const wss = new WebSocketServer({ host: '127.0.0.1', port: this.port });
+            this.wss = wss;
+            const onError = (error) => reject(error);
+            wss.once('error', onError);
+            wss.on('listening', () => {
+                wss.off('error', onError);
+                // Keep listening for later errors, or an EPIPE takes the process down.
+                wss.on('error', (error) => this.log(`bridge socket error: ${error.message}`));
+                const address = wss.address();
+                const bound = typeof address === 'object' && address !== null ? address.port : this.port;
+                this.port = bound;
+                this.log(`bridge listening on 127.0.0.1:${bound}`);
+                resolve(bound);
+            });
+            wss.on('connection', (socket, request) => this.accept(socket, request));
+        });
+    }
+    accept(socket, request) {
+        const origin = request.headers.origin ?? '';
+        if (!origin.startsWith('chrome-extension://')) {
+            this.log(`refused a connection from origin ${origin || '(none)'}`);
+            socket.close(CLOSE_BAD_ORIGIN, 'extension origins only');
+            return;
+        }
+        let entry = null;
+        const handshakeTimer = setTimeout(() => {
+            if (!entry)
+                socket.close(CLOSE_NO_HANDSHAKE, 'no handshake');
+        }, HANDSHAKE_TIMEOUT_MS);
+        const refuse = (code, reason, spoken) => {
+            if (spoken !== undefined) {
+                // Say why before closing: the settings page can show this, where a bare
+                // close code leaves the user guessing.
+                try {
+                    socket.send(JSON.stringify(helloReject(spoken)));
+                }
+                catch {
+                    // The socket is going away regardless.
+                }
+            }
+            socket.close(code, reason);
+        };
+        socket.on('message', (data) => {
+            const frame = parseInbound(String(data));
+            if (!frame)
+                return;
+            if (isHelloFrame(frame)) {
+                if (entry)
+                    return;
+                if (frame.protocol !== BRIDGE_PROTOCOL_VERSION) {
+                    this.log(`refused protocol ${frame.protocol}, this server speaks ${BRIDGE_PROTOCOL_VERSION}`);
+                    clearTimeout(handshakeTimer);
+                    refuse(CLOSE_BAD_PROTOCOL, 'protocol mismatch', `This Page Scanner speaks bridge protocol ${frame.protocol}, and page-scanner speaks ` +
+                        `${BRIDGE_PROTOCOL_VERSION}. Update whichever is older.`);
+                    return;
+                }
+                if (!tokensMatch(frame.token, this.token)) {
+                    this.log('refused a connection with a bad token');
+                    clearTimeout(handshakeTimer);
+                    refuse(CLOSE_BAD_TOKEN, 'bad token', "That token does not match this machine's pairing. Run `page-scanner pair` and " +
+                        'paste the new one.');
+                    return;
+                }
+                clearTimeout(handshakeTimer);
+                // A profile that reconnects replaces its old socket rather than doubling
+                // up, and the requests waiting on the old socket fail rather than hang.
+                const previous = this.browsers.get(frame.browserId);
+                if (previous) {
+                    this.rejectPending(previous, 'The browser reconnected while this request was in flight.');
+                    previous.socket.close(CLOSE_REPLACED, 'replaced');
+                }
+                entry = {
+                    socket,
+                    browserId: frame.browserId,
+                    label: frame.label || 'Chrome',
+                    version: frame.extensionVersion,
+                    since: this.now(),
+                    pending: new Map(),
+                    nextId: 0,
+                };
+                this.browsers.set(frame.browserId, entry);
+                socket.send(JSON.stringify(helloAck()));
+                this.log(`browser "${entry.label}" connected (${entry.browserId})`);
+                this.emit('browser-connected', this.describe(entry));
+                return;
+            }
+            // Nothing is answered before the handshake, and a ping is only there to
+            // keep Chrome's service worker alive.
+            if (!entry || isPingFrame(frame))
+                return;
+            const waiting = entry.pending.get(frame.id);
+            if (!waiting)
+                return;
+            clearTimeout(waiting.timer);
+            entry.pending.delete(frame.id);
+            if (frame.type === 'error') {
+                waiting.reject(new PageScannerError('SCAN_FAILED', frame.message || 'The scan failed.'));
+            }
+            else {
+                waiting.resolve(frame);
+            }
+        });
+        socket.on('close', () => {
+            clearTimeout(handshakeTimer);
+            if (!entry)
+                return;
+            const current = this.browsers.get(entry.browserId);
+            this.rejectPending(entry, 'The browser disconnected before it answered.');
+            // Only forget the browser if this socket is still the one registered: a
+            // replaced socket closes after its successor has already taken the slot.
+            if (current === entry) {
+                this.browsers.delete(entry.browserId);
+                this.log(`browser ${entry.browserId} disconnected`);
+                this.emit('browser-disconnected', { browserId: entry.browserId, label: entry.label });
+            }
+        });
+        socket.on('error', () => socket.close());
+    }
+    rejectPending(entry, message) {
+        for (const [id, waiting] of entry.pending) {
+            clearTimeout(waiting.timer);
+            entry.pending.delete(id);
+            waiting.reject(new PageScannerError('BROWSER_GONE', message));
+        }
+    }
+    describe(entry) {
+        return {
+            browserId: entry.browserId,
+            label: entry.label,
+            extensionVersion: entry.version,
+            connectedForMs: this.now() - entry.since,
+        };
+    }
+    /** Everything currently paired and connected. */
+    listBrowsers() {
+        return [...this.browsers.values()].map((entry) => this.describe(entry));
+    }
+    /**
+     * Picks the browser a request meant.
+     *
+     * With one browser connected, naming it is optional: that is the common case
+     * and making a caller look it up first would be noise. With several, the
+     * caller has to choose, and the error says what the options are. A label
+     * works as well as an id, because an id is a uuid nobody wants to type.
+     */
+    resolveBrowser(browserId) {
+        const connected = this.listBrowsers();
+        const listing = connected.map((b) => `${b.label} (${b.browserId})`).join(', ');
+        if (browserId) {
+            if (this.browsers.has(browserId))
+                return browserId;
+            const byLabel = connected.filter((b) => b.label.toLowerCase() === browserId.toLowerCase());
+            const only = byLabel[0];
+            if (byLabel.length === 1 && only)
+                return only.browserId;
+            if (byLabel.length > 1) {
+                throw new PageScannerError('AMBIGUOUS_BROWSER', `More than one connected browser is called "${browserId}", so name one by id. ` +
+                    `Connected: ${listing}.`);
+            }
+            throw new PageScannerError('UNKNOWN_BROWSER', `No connected browser with id or label "${browserId}".` +
+                (listing ? ` Connected: ${listing}.` : ' None are connected.'));
+        }
+        const first = connected[0];
+        if (!first) {
+            throw new PageScannerError('NO_BROWSER', 'No browser is connected.', 'Open the Page Scanner settings page in Chrome and press Connect. ' +
+                'Run `page-scanner pair` first if it has never been paired.');
+        }
+        if (connected.length > 1) {
+            throw new PageScannerError('AMBIGUOUS_BROWSER', `More than one browser is connected, so name one with --browser. Connected: ${listing}.`);
+        }
+        return first.browserId;
+    }
+    /**
+     * Waits for a browser to connect, which is what `--wait` is for: Chrome
+     * retires the extension's service worker after about thirty seconds of
+     * silence, and it dials back in when something wakes it.
+     */
+    waitForBrowser({ timeoutMs, browserId, }) {
+        try {
+            return Promise.resolve(this.resolveBrowser(browserId));
+        }
+        catch (error) {
+            // Only "nothing is connected" is worth waiting through. Two browsers
+            // connected, or a name that does not match one, will not fix itself.
+            if (!(error instanceof PageScannerError) || error.code !== 'NO_BROWSER') {
+                return Promise.reject(error);
+            }
+            if (timeoutMs <= 0)
+                return Promise.reject(error);
+        }
+        return new Promise((resolve, reject) => {
+            const settle = (fn) => {
+                clearTimeout(timer);
+                this.off('browser-connected', onConnected);
+                fn();
+            };
+            const onConnected = () => {
+                try {
+                    const id = this.resolveBrowser(browserId);
+                    settle(() => resolve(id));
+                }
+                catch {
+                    // Not the one asked for, or still ambiguous. Keep waiting.
+                }
+            };
+            const timer = setTimeout(() => {
+                settle(() => reject(new PageScannerError('NO_BROWSER', `No browser connected within ${Math.round(timeoutMs / 1000)}s.`, 'Open the Page Scanner settings page in Chrome and press Connect.')));
+            }, timeoutMs);
+            this.on('browser-connected', onConnected);
+        });
+    }
+    request(browserId, payload, timeoutMs) {
+        const entry = this.browsers.get(browserId);
+        if (!entry) {
+            throw new PageScannerError('BROWSER_GONE', `Browser ${browserId} is no longer connected.`);
+        }
+        entry.nextId += 1;
+        const id = `req-${entry.nextId}`;
+        return new Promise((resolve, reject) => {
+            const timer = setTimeout(() => {
+                entry.pending.delete(id);
+                reject(new PageScannerError('TIMEOUT', `The browser did not answer in ${Math.round(timeoutMs / 1000)}s.`));
+            }, timeoutMs);
+            entry.pending.set(id, { resolve, reject, timer });
+            try {
+                entry.socket.send(JSON.stringify({ ...payload, id }));
+            }
+            catch (error) {
+                clearTimeout(timer);
+                entry.pending.delete(id);
+                reject(new PageScannerError('BROWSER_GONE', error instanceof Error ? error.message : String(error)));
+            }
+        });
+    }
+    async listTabs(browserId, timeoutMs = this.requestTimeoutMs) {
+        const answer = await this.request(browserId, { type: 'list-tabs' }, timeoutMs);
+        if (answer.type !== 'tabs') {
+            throw new PageScannerError('SCAN_FAILED', 'The browser answered list-tabs with a scan.');
+        }
+        return answer;
+    }
+    async scan(browserId, request, timeoutMs = this.requestTimeoutMs) {
+        const answer = await this.request(browserId, { type: 'scan', ...request }, timeoutMs);
+        if (answer.type !== 'scan-result') {
+            throw new PageScannerError('SCAN_FAILED', 'The browser answered a scan with a tab list.');
+        }
+        return answer;
+    }
+    async close() {
+        for (const entry of this.browsers.values()) {
+            this.rejectPending(entry, 'The bridge shut down before the browser answered.');
+            entry.socket.close(1001, 'server shutting down');
+        }
+        this.browsers.clear();
+        const wss = this.wss;
+        this.wss = null;
+        if (!wss)
+            return;
+        await new Promise((resolve) => wss.close(() => resolve()));
+    }
+}
+//# sourceMappingURL=server.js.map

package/dist/bridge/server.js.map

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

package/dist/bridge/tokens.d.ts

@@ -0,0 +1,10 @@
+/**
+ * Constant-time token comparison.
+ *
+ * The lengths are compared separately because `timingSafeEqual` throws on a
+ * length mismatch rather than returning false, and a thrown error inside a
+ * socket handler would be a worse leak than the length itself, which an
+ * attacker can already guess from the protocol.
+ */
+export declare function tokensMatch(a: string, b: string): boolean;
+//# sourceMappingURL=tokens.d.ts.map

package/dist/bridge/tokens.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tokens.d.ts","sourceRoot":"","sources":["../../src/bridge/tokens.ts"],"names":[],"mappings":"AAEA;;;;;;;GAOG;AACH,wBAAgB,WAAW,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,GAAG,OAAO,CAIzD"}

package/dist/bridge/tokens.js

@@ -0,0 +1,15 @@
+import { timingSafeEqual } from 'node:crypto';
+/**
+ * Constant-time token comparison.
+ *
+ * The lengths are compared separately because `timingSafeEqual` throws on a
+ * length mismatch rather than returning false, and a thrown error inside a
+ * socket handler would be a worse leak than the length itself, which an
+ * attacker can already guess from the protocol.
+ */
+export function tokensMatch(a, b) {
+    const left = Buffer.from(String(a));
+    const right = Buffer.from(String(b));
+    return left.length === right.length && timingSafeEqual(left, right);
+}
+//# sourceMappingURL=tokens.js.map

package/dist/bridge/tokens.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tokens.js","sourceRoot":"","sources":["../../src/bridge/tokens.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAE9C;;;;;;;GAOG;AACH,MAAM,UAAU,WAAW,CAAC,CAAS,EAAE,CAAS;IAC9C,MAAM,IAAI,GAAG,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC;IACpC,MAAM,KAAK,GAAG,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC;IACrC,OAAO,IAAI,CAAC,MAAM,KAAK,KAAK,CAAC,MAAM,IAAI,eAAe,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC;AACtE,CAAC"}

package/dist/cli/args.d.ts

@@ -0,0 +1,63 @@
+import { type ExportFormatId, type PageSizeId, type VideoHandling } from '../protocol.js';
+export declare const COMMANDS: readonly ["pair", "status", "browsers", "tabs", "scan", "serve", "stop", "help", "version"];
+export type CommandName = (typeof COMMANDS)[number];
+export interface PairArgs {
+    command: 'pair';
+    port?: number;
+    rotate: boolean;
+    waitSeconds: number;
+    json: boolean;
+}
+export interface StatusArgs {
+    command: 'status';
+    json: boolean;
+}
+export interface BrowsersArgs {
+    command: 'browsers';
+    json: boolean;
+}
+export interface TabsArgs {
+    command: 'tabs';
+    browser?: string;
+    waitSeconds: number;
+    json: boolean;
+}
+export interface ScanArgs {
+    command: 'scan';
+    url?: string;
+    tabId?: number;
+    windowId?: number;
+    browser?: string;
+    format: ExportFormatId;
+    pageSize: PageSizeId;
+    quality?: number;
+    videoHandling?: VideoHandling;
+    openEditor: boolean;
+    out?: string;
+    waitSeconds: number;
+    timeoutSeconds: number;
+    json: boolean;
+}
+export interface ServeArgs {
+    command: 'serve';
+    daemon: boolean;
+    idleMinutes?: number;
+}
+export interface StopArgs {
+    command: 'stop';
+    json: boolean;
+}
+export interface HelpArgs {
+    command: 'help';
+}
+export interface VersionArgs {
+    command: 'version';
+}
+export type ParsedArgs = PairArgs | StatusArgs | BrowsersArgs | TabsArgs | ScanArgs | ServeArgs | StopArgs | HelpArgs | VersionArgs;
+export declare const USAGE = "page-scanner - capture a whole web page from the command line,\nthrough the Page Scanner Chrome extension.\n\nUsage:\n  page-scanner pair     [--port <n>] [--rotate] [--wait <s>=120] [--no-wait]\n                        [--json]\n  page-scanner status   [--json]\n  page-scanner browsers [--json]\n  page-scanner tabs     [--browser <id|label>] [--wait <s>=30] [--json]\n  page-scanner scan     (--url <u> | --tab <id>) [--window <id>]\n                        [--browser <id|label>] [--format pdf|png|jpeg=pdf]\n                        [--page-size auto|a4|letter=a4] [--quality <0-1>]\n                        [--video frame|blank] [--open-editor]\n                        [--out <file|dir>] [--wait <s>=30]\n                        [--timeout <s>=120]\n                        [--json]\n  page-scanner serve    [--daemon] [--idle <min>]\n  page-scanner stop     [--json]\n  page-scanner --version | --help          (-v and -h also work)\n\nCommands:\n  pair      Write the port and token the browser needs, then wait for it.\n  status    Say whether there is a pairing, a daemon and a browser.\n  browsers  List the browsers connected right now.\n  tabs      List one browser's windows and tabs.\n  scan      Capture a page and write it to a file.\n  serve     Run the bridge in this terminal, or start it in the background.\n  stop      Stop the background bridge.\n\n--browser takes a browserId or a label, matched without regard to case, and\nis needed only when more than one browser is connected. --wait 0 means do\nnot wait at all. --json prints one JSON document on stdout, on success and\non failure alike.\n\nExit codes:\n  0  success\n  1  the browser was reached and the work failed\n  2  the arguments were wrong\n  3  no usable browser: none connected, several connected, or the one\n     named is not\n  4  not paired: run `page-scanner pair`\n  5  the daemon would not start\n";
+/**
+ * `argv` is what follows the node executable and the script, i.e.
+ * `process.argv.slice(2)`.
+ */
+export declare function parseArgs(argv: string[]): ParsedArgs;
+//# sourceMappingURL=args.d.ts.map

package/dist/cli/args.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"args.d.ts","sourceRoot":"","sources":["../../src/cli/args.ts"],"names":[],"mappings":"AAeA,OAAO,EAKL,KAAK,cAAc,EACnB,KAAK,UAAU,EACf,KAAK,aAAa,EACnB,MAAM,gBAAgB,CAAC;AAExB,eAAO,MAAM,QAAQ,6FAUX,CAAC;AAEX,MAAM,MAAM,WAAW,GAAG,CAAC,OAAO,QAAQ,CAAC,CAAC,MAAM,CAAC,CAAC;AAEpD,MAAM,WAAW,QAAQ;IACvB,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,OAAO,CAAC;IAChB,WAAW,EAAE,MAAM,CAAC;IACpB,IAAI,EAAE,OAAO,CAAC;CACf;AAED,MAAM,WAAW,UAAU;IACzB,OAAO,EAAE,QAAQ,CAAC;IAClB,IAAI,EAAE,OAAO,CAAC;CACf;AAED,MAAM,WAAW,YAAY;IAC3B,OAAO,EAAE,UAAU,CAAC;IACpB,IAAI,EAAE,OAAO,CAAC;CACf;AAED,MAAM,WAAW,QAAQ;IACvB,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,WAAW,EAAE,MAAM,CAAC;IACpB,IAAI,EAAE,OAAO,CAAC;CACf;AAED,MAAM,WAAW,QAAQ;IACvB,OAAO,EAAE,MAAM,CAAC;IAChB,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,cAAc,CAAC;IACvB,QAAQ,EAAE,UAAU,CAAC;IACrB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,aAAa,CAAC,EAAE,aAAa,CAAC;IAC9B,UAAU,EAAE,OAAO,CAAC;IACpB,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,cAAc,EAAE,MAAM,CAAC;IACvB,IAAI,EAAE,OAAO,CAAC;CACf;AAED,MAAM,WAAW,SAAS;IACxB,OAAO,EAAE,OAAO,CAAC;IACjB,MAAM,EAAE,OAAO,CAAC;IAChB,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED,MAAM,WAAW,QAAQ;IACvB,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,OAAO,CAAC;CACf;AAED,MAAM,WAAW,QAAQ;IACvB,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,WAAW;IAC1B,OAAO,EAAE,SAAS,CAAC;CACpB;AAED,MAAM,MAAM,UAAU,GAClB,QAAQ,GACR,UAAU,GACV,YAAY,GACZ,QAAQ,GACR,QAAQ,GACR,SAAS,GACT,QAAQ,GACR,QAAQ,GACR,WAAW,CAAC;AAQhB,eAAO,MAAM,KAAK,22DA0CjB,CAAC;AAkVF;;;GAGG;AACH,wBAAgB,SAAS,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,UAAU,CAmCpD"}