@page-scanner/cli 0.1.0

package/dist/cli/args.js

@@ -0,0 +1,388 @@
+/**
+ * The whole argument surface, parsed with `node:util.parseArgs`.
+ *
+ * A CLI that ships one runtime dependency should not spend it on an argument
+ * parser, and the surface here is small enough that the platform's own parser
+ * covers it: one command, a handful of flags, no subcommand trees and no
+ * short aliases beyond `-h` and `-v`.
+ *
+ * Every rejection leaves through `PageScannerError('BAD_REQUEST', …)`, which
+ * the caller turns into exit code 2, so a script never has to read the prose
+ * to know it passed the wrong thing. The messages name the flag, what it
+ * expected and what it got, because that is the whole diagnosis.
+ */
+import { parseArgs as parseNodeArgs } from 'node:util';
+import { PageScannerError } from '../errors.js';
+import { DEFAULT_PAGE_SIZE, EXPORT_FORMAT_IDS, PAGE_SIZE_IDS, VIDEO_HANDLINGS, } from '../protocol.js';
+export const COMMANDS = [
+    'pair',
+    'status',
+    'browsers',
+    'tabs',
+    'scan',
+    'serve',
+    'stop',
+    'help',
+    'version',
+];
+/** Named once and interpolated into USAGE, so the help cannot drift from them. */
+const PAIR_WAIT_SECONDS = 120;
+const TABS_WAIT_SECONDS = 30;
+const SCAN_WAIT_SECONDS = 30;
+const SCAN_TIMEOUT_SECONDS = 120;
+export const USAGE = `page-scanner - capture a whole web page from the command line,
+through the Page Scanner Chrome extension.
+
+Usage:
+  page-scanner pair     [--port <n>] [--rotate] [--wait <s>=${PAIR_WAIT_SECONDS}] [--no-wait]
+                        [--json]
+  page-scanner status   [--json]
+  page-scanner browsers [--json]
+  page-scanner tabs     [--browser <id|label>] [--wait <s>=${TABS_WAIT_SECONDS}] [--json]
+  page-scanner scan     (--url <u> | --tab <id>) [--window <id>]
+                        [--browser <id|label>] [--format pdf|png|jpeg=pdf]
+                        [--page-size auto|a4|letter=a4] [--quality <0-1>]
+                        [--video frame|blank] [--open-editor]
+                        [--out <file|dir>] [--wait <s>=${SCAN_WAIT_SECONDS}]
+                        [--timeout <s>=${SCAN_TIMEOUT_SECONDS}]
+                        [--json]
+  page-scanner serve    [--daemon] [--idle <min>]
+  page-scanner stop     [--json]
+  page-scanner --version | --help          (-v and -h also work)
+
+Commands:
+  pair      Write the port and token the browser needs, then wait for it.
+  status    Say whether there is a pairing, a daemon and a browser.
+  browsers  List the browsers connected right now.
+  tabs      List one browser's windows and tabs.
+  scan      Capture a page and write it to a file.
+  serve     Run the bridge in this terminal, or start it in the background.
+  stop      Stop the background bridge.
+
+--browser takes a browserId or a label, matched without regard to case, and
+is needed only when more than one browser is connected. --wait 0 means do
+not wait at all. --json prints one JSON document on stdout, on success and
+on failure alike.
+
+Exit codes:
+  0  success
+  1  the browser was reached and the work failed
+  2  the arguments were wrong
+  3  no usable browser: none connected, several connected, or the one
+     named is not
+  4  not paired: run \`page-scanner pair\`
+  5  the daemon would not start
+`;
+function badRequest(message, hint) {
+    return new PageScannerError('BAD_REQUEST', message, hint);
+}
+/** Quoting the offending text keeps an empty or space-only value visible. */
+function quote(raw) {
+    return JSON.stringify(raw);
+}
+/**
+ * One numeric gate for every numeric flag. `accept` carries the range, and
+ * `expectation` the same range in words, so the check and the message cannot
+ * describe different things.
+ */
+function requireNumber(flag, raw, expectation, accept) {
+    // Number('') and Number('  ') are both 0, so an empty value would otherwise
+    // pass every range below as a perfectly legal zero.
+    const value = raw.trim() === '' ? Number.NaN : Number(raw);
+    if (!Number.isFinite(value) || !accept(value)) {
+        throw badRequest(`${flag} must be ${expectation} (got ${quote(raw)}).`);
+    }
+    return value;
+}
+const DECIMAL_INTEGER = /^[+-]?\d+$/;
+/**
+ * `Number` is more permissive than "an integer" in three ways that matter
+ * here: it reads `0x10` as 16, it accepts `+7`, and it rounds
+ * `9007199254740993` down to `...992`. The last is the dangerous one, because
+ * a tab id would be quietly turned into a different tab id rather than
+ * rejected.
+ */
+function requireInteger(flag, raw) {
+    if (!DECIMAL_INTEGER.test(raw.trim())) {
+        throw badRequest(`${flag} must be an integer (got ${quote(raw)}).`);
+    }
+    return requireNumber(flag, raw, 'an integer', Number.isSafeInteger);
+}
+function requireSeconds(flag, raw) {
+    return requireNumber(flag, raw, 'a number of seconds, 0 or more', (value) => value >= 0);
+}
+function requireEnum(flag, raw, allowed) {
+    const match = allowed.find((candidate) => candidate === raw);
+    if (match === undefined) {
+        throw badRequest(`${flag} must be one of ${allowed.join(', ')} (got ${quote(raw)}).`);
+    }
+    return match;
+}
+function requireText(flag, raw) {
+    if (raw.trim() === '')
+        throw badRequest(`${flag} needs a value.`);
+    return raw;
+}
+function optionalInteger(flag, raw) {
+    return raw === undefined ? undefined : requireInteger(flag, raw);
+}
+function optionalText(flag, raw) {
+    return raw === undefined ? undefined : requireText(flag, raw);
+}
+/**
+ * `parseArgs` throws its own ERR_PARSE_ARGS_* errors for an unknown option, a
+ * missing value or a stray positional. Those are usage mistakes like any
+ * other, so they become BAD_REQUEST and exit 2 rather than an uncaught crash
+ * with Node's own exit code; the original sentence is the clearest account of
+ * what happened, so it is kept verbatim.
+ */
+function readOptions(read) {
+    try {
+        return read();
+    }
+    catch (error) {
+        const message = error instanceof Error ? error.message : String(error);
+        throw badRequest(message, 'Run `page-scanner --help` for the commands and their options.');
+    }
+}
+/**
+ * `page-scanner scan --help` asks for the help, not for a scan.
+ *
+ * Every command declares `--help`, so this is read AFTER Node has parsed the
+ * whole line. Sweeping the raw tokens for it beforehand was wrong: in
+ * `page-scanner tabs --browser --help` the `--help` is the missing value of
+ * `--browser`, and the sweep turned a usage error into a successful exit 0.
+ */
+function wantsHelp(values) {
+    return values.help === true;
+}
+function parsePair(argv) {
+    const { values } = readOptions(() => parseNodeArgs({
+        args: argv,
+        strict: true,
+        allowPositionals: false,
+        options: {
+            help: { type: 'boolean', short: 'h' },
+            port: { type: 'string' },
+            rotate: { type: 'boolean' },
+            wait: { type: 'string' },
+            'no-wait': { type: 'boolean' },
+            json: { type: 'boolean' },
+        },
+    }));
+    if (wantsHelp(values))
+        return { command: 'help' };
+    // Validate first, then let --no-wait override. Short-circuiting on --no-wait
+    // meant `--wait oops --no-wait` was accepted, so whether a typo was caught
+    // depended on an unrelated flag.
+    const requested = values.wait === undefined ? PAIR_WAIT_SECONDS : requireSeconds('--wait', values.wait);
+    // --no-wait wins over --wait: it is the more explicit of the two, and a
+    // script that sets both meant the one that says "return immediately".
+    const waitSeconds = values['no-wait'] === true ? 0 : requested;
+    return {
+        command: 'pair',
+        port: values.port === undefined
+            ? undefined
+            : requireNumber('--port', values.port, 'an integer from 1 to 65535', 
+            // Port 0 would ask the kernel for any free port, which the browser
+            // then has no way of learning: the pairing file is the only thing
+            // that tells it where to dial.
+            (value) => Number.isInteger(value) && value >= 1 && value <= 65535),
+        rotate: values.rotate === true,
+        waitSeconds,
+        json: values.json === true,
+    };
+}
+function parseStatus(argv) {
+    const { values } = readOptions(() => parseNodeArgs({
+        args: argv,
+        strict: true,
+        allowPositionals: false,
+        options: {
+            help: { type: 'boolean', short: 'h' },
+            json: { type: 'boolean' },
+        },
+    }));
+    if (wantsHelp(values))
+        return { command: 'help' };
+    return { command: 'status', json: values.json === true };
+}
+function parseBrowsers(argv) {
+    const { values } = readOptions(() => parseNodeArgs({
+        args: argv,
+        strict: true,
+        allowPositionals: false,
+        options: {
+            help: { type: 'boolean', short: 'h' },
+            json: { type: 'boolean' },
+        },
+    }));
+    if (wantsHelp(values))
+        return { command: 'help' };
+    return { command: 'browsers', json: values.json === true };
+}
+function parseTabs(argv) {
+    const { values } = readOptions(() => parseNodeArgs({
+        args: argv,
+        strict: true,
+        allowPositionals: false,
+        options: {
+            help: { type: 'boolean', short: 'h' },
+            browser: { type: 'string' },
+            wait: { type: 'string' },
+            json: { type: 'boolean' },
+        },
+    }));
+    if (wantsHelp(values))
+        return { command: 'help' };
+    return {
+        command: 'tabs',
+        browser: optionalText('--browser', values.browser),
+        waitSeconds: values.wait === undefined ? TABS_WAIT_SECONDS : requireSeconds('--wait', values.wait),
+        json: values.json === true,
+    };
+}
+function parseScan(argv) {
+    const { values } = readOptions(() => parseNodeArgs({
+        args: argv,
+        strict: true,
+        allowPositionals: false,
+        options: {
+            help: { type: 'boolean', short: 'h' },
+            url: { type: 'string' },
+            tab: { type: 'string' },
+            window: { type: 'string' },
+            browser: { type: 'string' },
+            format: { type: 'string' },
+            'page-size': { type: 'string' },
+            quality: { type: 'string' },
+            video: { type: 'string' },
+            'open-editor': { type: 'boolean' },
+            out: { type: 'string' },
+            wait: { type: 'string' },
+            timeout: { type: 'string' },
+            json: { type: 'boolean' },
+        },
+    }));
+    if (wantsHelp(values))
+        return { command: 'help' };
+    // Exactly one target. Neither leaves nothing to scan; both would make the
+    // extension choose, and the two mean different things (open a tab, or use
+    // the one already open).
+    if (values.url === undefined && values.tab === undefined) {
+        throw badRequest('scan needs a page to capture: give --url <address> or --tab <id>.', 'Run `page-scanner tabs` to see the tabs that are open.');
+    }
+    if (values.url !== undefined && values.tab !== undefined) {
+        throw badRequest('scan takes --url or --tab, not both.');
+    }
+    return {
+        command: 'scan',
+        url: optionalText('--url', values.url),
+        tabId: optionalInteger('--tab', values.tab),
+        windowId: optionalInteger('--window', values.window),
+        browser: optionalText('--browser', values.browser),
+        format: values.format === undefined
+            ? 'pdf'
+            : requireEnum('--format', values.format, EXPORT_FORMAT_IDS),
+        pageSize: values['page-size'] === undefined
+            ? DEFAULT_PAGE_SIZE
+            : requireEnum('--page-size', values['page-size'], PAGE_SIZE_IDS),
+        quality: values.quality === undefined
+            ? undefined
+            : requireNumber('--quality', values.quality, 'a number greater than 0 and at most 1', (value) => value > 0 && value <= 1),
+        videoHandling: values.video === undefined
+            ? undefined
+            : requireEnum('--video', values.video, VIDEO_HANDLINGS),
+        openEditor: values['open-editor'] === true,
+        out: optionalText('--out', values.out),
+        waitSeconds: values.wait === undefined ? SCAN_WAIT_SECONDS : requireSeconds('--wait', values.wait),
+        timeoutSeconds: values.timeout === undefined
+            ? SCAN_TIMEOUT_SECONDS
+            : requireSeconds('--timeout', values.timeout),
+        json: values.json === true,
+    };
+}
+function parseServe(argv) {
+    const { values } = readOptions(() => parseNodeArgs({
+        args: argv,
+        strict: true,
+        allowPositionals: false,
+        options: {
+            help: { type: 'boolean', short: 'h' },
+            daemon: { type: 'boolean' },
+            idle: { type: 'string' },
+        },
+    }));
+    if (wantsHelp(values))
+        return { command: 'help' };
+    return {
+        command: 'serve',
+        daemon: values.daemon === true,
+        idleMinutes: values.idle === undefined
+            ? undefined
+            : requireNumber('--idle', values.idle, 'a number of minutes, 0 or more', (v) => v >= 0),
+    };
+}
+function parseStop(argv) {
+    const { values } = readOptions(() => parseNodeArgs({
+        args: argv,
+        strict: true,
+        allowPositionals: false,
+        options: {
+            help: { type: 'boolean', short: 'h' },
+            json: { type: 'boolean' },
+        },
+    }));
+    if (wantsHelp(values))
+        return { command: 'help' };
+    return { command: 'stop', json: values.json === true };
+}
+/** The two commands that are also spelled as flags, in both spellings. */
+const COMMAND_FLAGS = new Map([
+    ['--help', 'help'],
+    ['-h', 'help'],
+    ['--version', 'version'],
+    ['-v', 'version'],
+]);
+function isCommandName(value) {
+    return COMMANDS.some((command) => command === value);
+}
+/** What a user may reasonably be asked to type: `help` and `version` are extras. */
+const RUNNABLE_COMMANDS = COMMANDS.filter((command) => command !== 'help' && command !== 'version').join(', ');
+/**
+ * `argv` is what follows the node executable and the script, i.e.
+ * `process.argv.slice(2)`.
+ */
+export function parseArgs(argv) {
+    const first = argv[0];
+    if (first === undefined)
+        return { command: 'help' };
+    const command = COMMAND_FLAGS.get(first) ?? (isCommandName(first) ? first : undefined);
+    if (command === undefined) {
+        throw first.startsWith('-')
+            ? badRequest(`Unknown option ${quote(first)}. A command comes first: one of ${RUNNABLE_COMMANDS}.`)
+            : badRequest(`Unknown command ${quote(first)}. Expected one of ${RUNNABLE_COMMANDS}.`);
+    }
+    const rest = argv.slice(1);
+    switch (command) {
+        case 'pair':
+            return parsePair(rest);
+        case 'status':
+            return parseStatus(rest);
+        case 'browsers':
+            return parseBrowsers(rest);
+        case 'tabs':
+            return parseTabs(rest);
+        case 'scan':
+            return parseScan(rest);
+        case 'serve':
+            return parseServe(rest);
+        case 'stop':
+            return parseStop(rest);
+        case 'help':
+            return { command: 'help' };
+        case 'version':
+            return { command: 'version' };
+    }
+}
+//# sourceMappingURL=args.js.map

package/dist/cli/args.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"args.js","sourceRoot":"","sources":["../../src/cli/args.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AACH,OAAO,EAAE,SAAS,IAAI,aAAa,EAAE,MAAM,WAAW,CAAC;AACvD,OAAO,EAAE,gBAAgB,EAAE,MAAM,cAAc,CAAC;AAChD,OAAO,EACL,iBAAiB,EACjB,iBAAiB,EACjB,aAAa,EACb,eAAe,GAIhB,MAAM,gBAAgB,CAAC;AAExB,MAAM,CAAC,MAAM,QAAQ,GAAG;IACtB,MAAM;IACN,QAAQ;IACR,UAAU;IACV,MAAM;IACN,MAAM;IACN,OAAO;IACP,MAAM;IACN,MAAM;IACN,SAAS;CACD,CAAC;AA4EX,kFAAkF;AAClF,MAAM,iBAAiB,GAAG,GAAG,CAAC;AAC9B,MAAM,iBAAiB,GAAG,EAAE,CAAC;AAC7B,MAAM,iBAAiB,GAAG,EAAE,CAAC;AAC7B,MAAM,oBAAoB,GAAG,GAAG,CAAC;AAEjC,MAAM,CAAC,MAAM,KAAK,GAAG;;;;8DAIyC,iBAAiB;;;;6DAIlB,iBAAiB;;;;;yDAKrB,iBAAiB;yCACjC,oBAAoB;;;;;;;;;;;;;;;;;;;;;;;;;;;;CA4B5D,CAAC;AAEF,SAAS,UAAU,CAAC,OAAe,EAAE,IAAa;IAChD,OAAO,IAAI,gBAAgB,CAAC,aAAa,EAAE,OAAO,EAAE,IAAI,CAAC,CAAC;AAC5D,CAAC;AAED,6EAA6E;AAC7E,SAAS,KAAK,CAAC,GAAW;IACxB,OAAO,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,CAAC;AAC7B,CAAC;AAED;;;;GAIG;AACH,SAAS,aAAa,CACpB,IAAY,EACZ,GAAW,EACX,WAAmB,EACnB,MAAkC;IAElC,4EAA4E;IAC5E,oDAAoD;IACpD,MAAM,KAAK,GAAG,GAAG,CAAC,IAAI,EAAE,KAAK,EAAE,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;IAC3D,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAC,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE,CAAC;QAC9C,MAAM,UAAU,CAAC,GAAG,IAAI,YAAY,WAAW,SAAS,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;IAC1E,CAAC;IACD,OAAO,KAAK,CAAC;AACf,CAAC;AAED,MAAM,eAAe,GAAG,YAAY,CAAC;AAErC;;;;;;GAMG;AACH,SAAS,cAAc,CAAC,IAAY,EAAE,GAAW;IAC/C,IAAI,CAAC,eAAe,CAAC,IAAI,CAAC,GAAG,CAAC,IAAI,EAAE,CAAC,EAAE,CAAC;QACtC,MAAM,UAAU,CAAC,GAAG,IAAI,4BAA4B,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;IACtE,CAAC;IACD,OAAO,aAAa,CAAC,IAAI,EAAE,GAAG,EAAE,YAAY,EAAE,MAAM,CAAC,aAAa,CAAC,CAAC;AACtE,CAAC;AAED,SAAS,cAAc,CAAC,IAAY,EAAE,GAAW;IAC/C,OAAO,aAAa,CAAC,IAAI,EAAE,GAAG,EAAE,gCAAgC,EAAE,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,IAAI,CAAC,CAAC,CAAC;AAC3F,CAAC;AAED,SAAS,WAAW,CAAmB,IAAY,EAAE,GAAW,EAAE,OAAqB;IACrF,MAAM,KAAK,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC,SAAS,EAAE,EAAE,CAAC,SAAS,KAAK,GAAG,CAAC,CAAC;IAC7D,IAAI,KAAK,KAAK,SAAS,EAAE,CAAC;QACxB,MAAM,UAAU,CAAC,GAAG,IAAI,mBAAmB,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,SAAS,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;IACxF,CAAC;IACD,OAAO,KAAK,CAAC;AACf,CAAC;AAED,SAAS,WAAW,CAAC,IAAY,EAAE,GAAW;IAC5C,IAAI,GAAG,CAAC,IAAI,EAAE,KAAK,EAAE;QAAE,MAAM,UAAU,CAAC,GAAG,IAAI,iBAAiB,CAAC,CAAC;IAClE,OAAO,GAAG,CAAC;AACb,CAAC;AAED,SAAS,eAAe,CAAC,IAAY,EAAE,GAAuB;IAC5D,OAAO,GAAG,KAAK,SAAS,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,cAAc,CAAC,IAAI,EAAE,GAAG,CAAC,CAAC;AACnE,CAAC;AAED,SAAS,YAAY,CAAC,IAAY,EAAE,GAAuB;IACzD,OAAO,GAAG,KAAK,SAAS,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,WAAW,CAAC,IAAI,EAAE,GAAG,CAAC,CAAC;AAChE,CAAC;AAED;;;;;;GAMG;AACH,SAAS,WAAW,CAAI,IAAa;IACnC,IAAI,CAAC;QACH,OAAO,IAAI,EAAE,CAAC;IAChB,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,MAAM,OAAO,GAAG,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;QACvE,MAAM,UAAU,CAAC,OAAO,EAAE,+DAA+D,CAAC,CAAC;IAC7F,CAAC;AACH,CAAC;AAED;;;;;;;GAOG;AACH,SAAS,SAAS,CAAC,MAAsC;IACvD,OAAO,MAAM,CAAC,IAAI,KAAK,IAAI,CAAC;AAC9B,CAAC;AAED,SAAS,SAAS,CAAC,IAAc;IAC/B,MAAM,EAAE,MAAM,EAAE,GAAG,WAAW,CAAC,GAAG,EAAE,CAClC,aAAa,CAAC;QACZ,IAAI,EAAE,IAAI;QACV,MAAM,EAAE,IAAI;QACZ,gBAAgB,EAAE,KAAK;QACvB,OAAO,EAAE;YACP,IAAI,EAAE,EAAE,IAAI,EAAE,SAAS,EAAE,KAAK,EAAE,GAAG,EAAE;YACrC,IAAI,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;YACxB,MAAM,EAAE,EAAE,IAAI,EAAE,SAAS,EAAE;YAC3B,IAAI,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;YACxB,SAAS,EAAE,EAAE,IAAI,EAAE,SAAS,EAAE;YAC9B,IAAI,EAAE,EAAE,IAAI,EAAE,SAAS,EAAE;SAC1B;KACF,CAAC,CACH,CAAC;IACF,IAAI,SAAS,CAAC,MAAM,CAAC;QAAE,OAAO,EAAE,OAAO,EAAE,MAAM,EAAE,CAAC;IAElD,6EAA6E;IAC7E,2EAA2E;IAC3E,iCAAiC;IACjC,MAAM,SAAS,GACb,MAAM,CAAC,IAAI,KAAK,SAAS,CAAC,CAAC,CAAC,iBAAiB,CAAC,CAAC,CAAC,cAAc,CAAC,QAAQ,EAAE,MAAM,CAAC,IAAI,CAAC,CAAC;IACxF,wEAAwE;IACxE,sEAAsE;IACtE,MAAM,WAAW,GAAG,MAAM,CAAC,SAAS,CAAC,KAAK,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;IAE/D,OAAO;QACL,OAAO,EAAE,MAAM;QACf,IAAI,EACF,MAAM,CAAC,IAAI,KAAK,SAAS;YACvB,CAAC,CAAC,SAAS;YACX,CAAC,CAAC,aAAa,CACX,QAAQ,EACR,MAAM,CAAC,IAAI,EACX,4BAA4B;YAC5B,mEAAmE;YACnE,kEAAkE;YAClE,+BAA+B;YAC/B,CAAC,KAAK,EAAE,EAAE,CAAC,MAAM,CAAC,SAAS,CAAC,KAAK,CAAC,IAAI,KAAK,IAAI,CAAC,IAAI,KAAK,IAAI,KAAK,CACnE;QACP,MAAM,EAAE,MAAM,CAAC,MAAM,KAAK,IAAI;QAC9B,WAAW;QACX,IAAI,EAAE,MAAM,CAAC,IAAI,KAAK,IAAI;KAC3B,CAAC;AACJ,CAAC;AAED,SAAS,WAAW,CAAC,IAAc;IACjC,MAAM,EAAE,MAAM,EAAE,GAAG,WAAW,CAAC,GAAG,EAAE,CAClC,aAAa,CAAC;QACZ,IAAI,EAAE,IAAI;QACV,MAAM,EAAE,IAAI;QACZ,gBAAgB,EAAE,KAAK;QACvB,OAAO,EAAE;YACP,IAAI,EAAE,EAAE,IAAI,EAAE,SAAS,EAAE,KAAK,EAAE,GAAG,EAAE;YACrC,IAAI,EAAE,EAAE,IAAI,EAAE,SAAS,EAAE;SAC1B;KACF,CAAC,CACH,CAAC;IACF,IAAI,SAAS,CAAC,MAAM,CAAC;QAAE,OAAO,EAAE,OAAO,EAAE,MAAM,EAAE,CAAC;IAClD,OAAO,EAAE,OAAO,EAAE,QAAQ,EAAE,IAAI,EAAE,MAAM,CAAC,IAAI,KAAK,IAAI,EAAE,CAAC;AAC3D,CAAC;AAED,SAAS,aAAa,CAAC,IAAc;IACnC,MAAM,EAAE,MAAM,EAAE,GAAG,WAAW,CAAC,GAAG,EAAE,CAClC,aAAa,CAAC;QACZ,IAAI,EAAE,IAAI;QACV,MAAM,EAAE,IAAI;QACZ,gBAAgB,EAAE,KAAK;QACvB,OAAO,EAAE;YACP,IAAI,EAAE,EAAE,IAAI,EAAE,SAAS,EAAE,KAAK,EAAE,GAAG,EAAE;YACrC,IAAI,EAAE,EAAE,IAAI,EAAE,SAAS,EAAE;SAC1B;KACF,CAAC,CACH,CAAC;IACF,IAAI,SAAS,CAAC,MAAM,CAAC;QAAE,OAAO,EAAE,OAAO,EAAE,MAAM,EAAE,CAAC;IAClD,OAAO,EAAE,OAAO,EAAE,UAAU,EAAE,IAAI,EAAE,MAAM,CAAC,IAAI,KAAK,IAAI,EAAE,CAAC;AAC7D,CAAC;AAED,SAAS,SAAS,CAAC,IAAc;IAC/B,MAAM,EAAE,MAAM,EAAE,GAAG,WAAW,CAAC,GAAG,EAAE,CAClC,aAAa,CAAC;QACZ,IAAI,EAAE,IAAI;QACV,MAAM,EAAE,IAAI;QACZ,gBAAgB,EAAE,KAAK;QACvB,OAAO,EAAE;YACP,IAAI,EAAE,EAAE,IAAI,EAAE,SAAS,EAAE,KAAK,EAAE,GAAG,EAAE;YACrC,OAAO,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;YAC3B,IAAI,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;YACxB,IAAI,EAAE,EAAE,IAAI,EAAE,SAAS,EAAE;SAC1B;KACF,CAAC,CACH,CAAC;IACF,IAAI,SAAS,CAAC,MAAM,CAAC;QAAE,OAAO,EAAE,OAAO,EAAE,MAAM,EAAE,CAAC;IAClD,OAAO;QACL,OAAO,EAAE,MAAM;QACf,OAAO,EAAE,YAAY,CAAC,WAAW,EAAE,MAAM,CAAC,OAAO,CAAC;QAClD,WAAW,EACT,MAAM,CAAC,IAAI,KAAK,SAAS,CAAC,CAAC,CAAC,iBAAiB,CAAC,CAAC,CAAC,cAAc,CAAC,QAAQ,EAAE,MAAM,CAAC,IAAI,CAAC;QACvF,IAAI,EAAE,MAAM,CAAC,IAAI,KAAK,IAAI;KAC3B,CAAC;AACJ,CAAC;AAED,SAAS,SAAS,CAAC,IAAc;IAC/B,MAAM,EAAE,MAAM,EAAE,GAAG,WAAW,CAAC,GAAG,EAAE,CAClC,aAAa,CAAC;QACZ,IAAI,EAAE,IAAI;QACV,MAAM,EAAE,IAAI;QACZ,gBAAgB,EAAE,KAAK;QACvB,OAAO,EAAE;YACP,IAAI,EAAE,EAAE,IAAI,EAAE,SAAS,EAAE,KAAK,EAAE,GAAG,EAAE;YACrC,GAAG,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;YACvB,GAAG,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;YACvB,MAAM,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;YAC1B,OAAO,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;YAC3B,MAAM,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;YAC1B,WAAW,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;YAC/B,OAAO,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;YAC3B,KAAK,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;YACzB,aAAa,EAAE,EAAE,IAAI,EAAE,SAAS,EAAE;YAClC,GAAG,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;YACvB,IAAI,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;YACxB,OAAO,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;YAC3B,IAAI,EAAE,EAAE,IAAI,EAAE,SAAS,EAAE;SAC1B;KACF,CAAC,CACH,CAAC;IACF,IAAI,SAAS,CAAC,MAAM,CAAC;QAAE,OAAO,EAAE,OAAO,EAAE,MAAM,EAAE,CAAC;IAElD,0EAA0E;IAC1E,0EAA0E;IAC1E,yBAAyB;IACzB,IAAI,MAAM,CAAC,GAAG,KAAK,SAAS,IAAI,MAAM,CAAC,GAAG,KAAK,SAAS,EAAE,CAAC;QACzD,MAAM,UAAU,CACd,mEAAmE,EACnE,wDAAwD,CACzD,CAAC;IACJ,CAAC;IACD,IAAI,MAAM,CAAC,GAAG,KAAK,SAAS,IAAI,MAAM,CAAC,GAAG,KAAK,SAAS,EAAE,CAAC;QACzD,MAAM,UAAU,CAAC,sCAAsC,CAAC,CAAC;IAC3D,CAAC;IAED,OAAO;QACL,OAAO,EAAE,MAAM;QACf,GAAG,EAAE,YAAY,CAAC,OAAO,EAAE,MAAM,CAAC,GAAG,CAAC;QACtC,KAAK,EAAE,eAAe,CAAC,OAAO,EAAE,MAAM,CAAC,GAAG,CAAC;QAC3C,QAAQ,EAAE,eAAe,CAAC,UAAU,EAAE,MAAM,CAAC,MAAM,CAAC;QACpD,OAAO,EAAE,YAAY,CAAC,WAAW,EAAE,MAAM,CAAC,OAAO,CAAC;QAClD,MAAM,EACJ,MAAM,CAAC,MAAM,KAAK,SAAS;YACzB,CAAC,CAAC,KAAK;YACP,CAAC,CAAC,WAAW,CAAC,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,iBAAiB,CAAC;QAC/D,QAAQ,EACN,MAAM,CAAC,WAAW,CAAC,KAAK,SAAS;YAC/B,CAAC,CAAC,iBAAiB;YACnB,CAAC,CAAC,WAAW,CAAC,aAAa,EAAE,MAAM,CAAC,WAAW,CAAC,EAAE,aAAa,CAAC;QACpE,OAAO,EACL,MAAM,CAAC,OAAO,KAAK,SAAS;YAC1B,CAAC,CAAC,SAAS;YACX,CAAC,CAAC,aAAa,CACX,WAAW,EACX,MAAM,CAAC,OAAO,EACd,uCAAuC,EACvC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,GAAG,CAAC,IAAI,KAAK,IAAI,CAAC,CACnC;QACP,aAAa,EACX,MAAM,CAAC,KAAK,KAAK,SAAS;YACxB,CAAC,CAAC,SAAS;YACX,CAAC,CAAC,WAAW,CAAC,SAAS,EAAE,MAAM,CAAC,KAAK,EAAE,eAAe,CAAC;QAC3D,UAAU,EAAE,MAAM,CAAC,aAAa,CAAC,KAAK,IAAI;QAC1C,GAAG,EAAE,YAAY,CAAC,OAAO,EAAE,MAAM,CAAC,GAAG,CAAC;QACtC,WAAW,EACT,MAAM,CAAC,IAAI,KAAK,SAAS,CAAC,CAAC,CAAC,iBAAiB,CAAC,CAAC,CAAC,cAAc,CAAC,QAAQ,EAAE,MAAM,CAAC,IAAI,CAAC;QACvF,cAAc,EACZ,MAAM,CAAC,OAAO,KAAK,SAAS;YAC1B,CAAC,CAAC,oBAAoB;YACtB,CAAC,CAAC,cAAc,CAAC,WAAW,EAAE,MAAM,CAAC,OAAO,CAAC;QACjD,IAAI,EAAE,MAAM,CAAC,IAAI,KAAK,IAAI;KAC3B,CAAC;AACJ,CAAC;AAED,SAAS,UAAU,CAAC,IAAc;IAChC,MAAM,EAAE,MAAM,EAAE,GAAG,WAAW,CAAC,GAAG,EAAE,CAClC,aAAa,CAAC;QACZ,IAAI,EAAE,IAAI;QACV,MAAM,EAAE,IAAI;QACZ,gBAAgB,EAAE,KAAK;QACvB,OAAO,EAAE;YACP,IAAI,EAAE,EAAE,IAAI,EAAE,SAAS,EAAE,KAAK,EAAE,GAAG,EAAE;YACrC,MAAM,EAAE,EAAE,IAAI,EAAE,SAAS,EAAE;YAC3B,IAAI,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;SACzB;KACF,CAAC,CACH,CAAC;IACF,IAAI,SAAS,CAAC,MAAM,CAAC;QAAE,OAAO,EAAE,OAAO,EAAE,MAAM,EAAE,CAAC;IAClD,OAAO;QACL,OAAO,EAAE,OAAO;QAChB,MAAM,EAAE,MAAM,CAAC,MAAM,KAAK,IAAI;QAC9B,WAAW,EACT,MAAM,CAAC,IAAI,KAAK,SAAS;YACvB,CAAC,CAAC,SAAS;YACX,CAAC,CAAC,aAAa,CAAC,QAAQ,EAAE,MAAM,CAAC,IAAI,EAAE,gCAAgC,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC;KAC5F,CAAC;AACJ,CAAC;AAED,SAAS,SAAS,CAAC,IAAc;IAC/B,MAAM,EAAE,MAAM,EAAE,GAAG,WAAW,CAAC,GAAG,EAAE,CAClC,aAAa,CAAC;QACZ,IAAI,EAAE,IAAI;QACV,MAAM,EAAE,IAAI;QACZ,gBAAgB,EAAE,KAAK;QACvB,OAAO,EAAE;YACP,IAAI,EAAE,EAAE,IAAI,EAAE,SAAS,EAAE,KAAK,EAAE,GAAG,EAAE;YACrC,IAAI,EAAE,EAAE,IAAI,EAAE,SAAS,EAAE;SAC1B;KACF,CAAC,CACH,CAAC;IACF,IAAI,SAAS,CAAC,MAAM,CAAC;QAAE,OAAO,EAAE,OAAO,EAAE,MAAM,EAAE,CAAC;IAClD,OAAO,EAAE,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,CAAC,IAAI,KAAK,IAAI,EAAE,CAAC;AACzD,CAAC;AAED,0EAA0E;AAC1E,MAAM,aAAa,GAAG,IAAI,GAAG,CAAsB;IACjD,CAAC,QAAQ,EAAE,MAAM,CAAC;IAClB,CAAC,IAAI,EAAE,MAAM,CAAC;IACd,CAAC,WAAW,EAAE,SAAS,CAAC;IACxB,CAAC,IAAI,EAAE,SAAS,CAAC;CAClB,CAAC,CAAC;AAEH,SAAS,aAAa,CAAC,KAAa;IAClC,OAAO,QAAQ,CAAC,IAAI,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,OAAO,KAAK,KAAK,CAAC,CAAC;AACvD,CAAC;AAED,oFAAoF;AACpF,MAAM,iBAAiB,GAAG,QAAQ,CAAC,MAAM,CACvC,CAAC,OAAO,EAAE,EAAE,CAAC,OAAO,KAAK,MAAM,IAAI,OAAO,KAAK,SAAS,CACzD,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AAEb;;;GAGG;AACH,MAAM,UAAU,SAAS,CAAC,IAAc;IACtC,MAAM,KAAK,GAAG,IAAI,CAAC,CAAC,CAAC,CAAC;IACtB,IAAI,KAAK,KAAK,SAAS;QAAE,OAAO,EAAE,OAAO,EAAE,MAAM,EAAE,CAAC;IAEpD,MAAM,OAAO,GAAG,aAAa,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,aAAa,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC;IACvF,IAAI,OAAO,KAAK,SAAS,EAAE,CAAC;QAC1B,MAAM,KAAK,CAAC,UAAU,CAAC,GAAG,CAAC;YACzB,CAAC,CAAC,UAAU,CACR,kBAAkB,KAAK,CAAC,KAAK,CAAC,mCAAmC,iBAAiB,GAAG,CACtF;YACH,CAAC,CAAC,UAAU,CAAC,mBAAmB,KAAK,CAAC,KAAK,CAAC,qBAAqB,iBAAiB,GAAG,CAAC,CAAC;IAC3F,CAAC;IAED,MAAM,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;IAE3B,QAAQ,OAAO,EAAE,CAAC;QAChB,KAAK,MAAM;YACT,OAAO,SAAS,CAAC,IAAI,CAAC,CAAC;QACzB,KAAK,QAAQ;YACX,OAAO,WAAW,CAAC,IAAI,CAAC,CAAC;QAC3B,KAAK,UAAU;YACb,OAAO,aAAa,CAAC,IAAI,CAAC,CAAC;QAC7B,KAAK,MAAM;YACT,OAAO,SAAS,CAAC,IAAI,CAAC,CAAC;QACzB,KAAK,MAAM;YACT,OAAO,SAAS,CAAC,IAAI,CAAC,CAAC;QACzB,KAAK,OAAO;YACV,OAAO,UAAU,CAAC,IAAI,CAAC,CAAC;QAC1B,KAAK,MAAM;YACT,OAAO,SAAS,CAAC,IAAI,CAAC,CAAC;QACzB,KAAK,MAAM;YACT,OAAO,EAAE,OAAO,EAAE,MAAM,EAAE,CAAC;QAC7B,KAAK,SAAS;YACZ,OAAO,EAAE,OAAO,EAAE,SAAS,EAAE,CAAC;IAClC,CAAC;AACH,CAAC"}

package/dist/cli/commands.d.ts

@@ -0,0 +1,8 @@
+import type { ParsedArgs } from './args.js';
+export interface CommandIo {
+    stdout: (text: string) => void;
+    stderr: (text: string) => void;
+}
+/** Runs one parsed command and returns the process exit code. */
+export declare function runCommand(parsed: ParsedArgs, io: CommandIo): Promise<number>;
+//# sourceMappingURL=commands.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"commands.d.ts","sourceRoot":"","sources":["../../src/cli/commands.ts"],"names":[],"mappings":"AA6BA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,WAAW,CAAC;AAI5C,MAAM,WAAW,SAAS;IACxB,MAAM,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;IAC/B,MAAM,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;CAChC;AA0FD,iEAAiE;AACjE,wBAAsB,UAAU,CAAC,MAAM,EAAE,UAAU,EAAE,EAAE,EAAE,SAAS,GAAG,OAAO,CAAC,MAAM,CAAC,CAqJnF"}

package/dist/cli/commands.js

@@ -0,0 +1,234 @@
+/**
+ * What each command prints, and what it exits with.
+ *
+ * The output contract, which the README states and `bin.test.ts` enforces:
+ *
+ *  - stdout carries the answer and nothing else. For a scan that is one line,
+ *    the absolute path; for a listing it is a column-aligned table. Both are
+ *    meant to be piped.
+ *  - stderr carries anything addressed to a person: progress, warnings, the
+ *    reason something failed.
+ *  - `--json` puts exactly one JSON document on stdout, for success and for
+ *    failure alike, and stderr stays empty. A script should never have to
+ *    parse prose.
+ *  - The pairing token is printed by `pair`, on stdout, and nowhere else ever.
+ */
+import { listBrowsers, listTabs, pair, scan, status, stop, waitForBrowser, } from '../api.js';
+import { exitCodeFor, toPageScannerError } from '../errors.js';
+import { formatBrowsers, formatDuration, formatTabs, formatTruncation } from './format.js';
+import { USAGE } from './args.js';
+import { CLI_VERSION } from '../version.js';
+function line(io, text) {
+    io.stdout(`${text}\n`);
+}
+function note(io, text) {
+    io.stderr(`${text}\n`);
+}
+function json(io, payload) {
+    io.stdout(`${JSON.stringify(payload, null, 2)}\n`);
+}
+/**
+ * Says once, on stderr, that nothing is connected yet, so a person watching a
+ * command that appears to hang knows what it is waiting for and what to do.
+ * Skipped for `--json`, whose consumer is not watching.
+ */
+async function warnIfWaiting(io, waitSeconds, useJson) {
+    if (useJson || waitSeconds <= 0)
+        return;
+    try {
+        const browsers = await listBrowsers();
+        if (browsers.length > 0)
+            return;
+    }
+    catch {
+        // The daemon is not up yet, or something else is wrong. Either way the
+        // real command is about to report it properly.
+        return;
+    }
+    note(io, `Waiting for Chrome to connect (up to ${waitSeconds}s). Open the Page Scanner settings ` +
+        'page and press Connect.');
+}
+function reportScan(io, result, format, useJson) {
+    if (useJson) {
+        json(io, { ok: true, ...result });
+        return;
+    }
+    if (result.truncated)
+        note(io, formatTruncation(result.truncated));
+    if (result.mode === 'raster') {
+        // Worth saying for a PDF, where it is the difference between a document
+        // and a picture of one. For a PNG or a JPEG the output is an image
+        // either way, and the only thing that changed is how it was assembled.
+        note(io, format === 'pdf'
+            ? 'Chrome would not attach its debugger, so this was stitched from screenshots: the ' +
+                "PDF's text is an image, not text."
+            : 'Chrome would not attach its debugger, so this was stitched from screenshots.');
+    }
+    line(io, result.path);
+}
+function reportStatus(io, report, useJson) {
+    if (useJson) {
+        json(io, { ok: true, ...report });
+        return;
+    }
+    const rows = [
+        `page-scanner   ${report.version}`,
+        `pairing        ${report.paired ? `port ${report.bridgePort}` : 'none, run `page-scanner pair`'}`,
+        `config         ${report.configPath}${report.configOwnerOnly ? '' : ' (not owner-only on this platform)'}`,
+        report.daemon.running
+            ? `daemon         running, pid ${report.daemon.pid}, version ${report.daemon.version}`
+            : 'daemon         not running',
+    ];
+    for (const row of rows)
+        line(io, row);
+    if (report.browsers.length === 0) {
+        line(io, 'browsers       none connected');
+        return;
+    }
+    line(io, 'browsers');
+    for (const browser of report.browsers) {
+        line(io, `  ${browser.label} (${browser.browserId}) extension ${browser.extensionVersion}, ` +
+            `connected ${formatDuration(browser.connectedForMs)}`);
+    }
+}
+/** Runs one parsed command and returns the process exit code. */
+export async function runCommand(parsed, io) {
+    try {
+        switch (parsed.command) {
+            case 'help':
+                line(io, USAGE);
+                return 0;
+            case 'version':
+                line(io, CLI_VERSION);
+                return 0;
+            case 'pair': {
+                const result = await pair({
+                    ...(parsed.port !== undefined ? { port: parsed.port } : {}),
+                    rotate: parsed.rotate,
+                });
+                if (parsed.json) {
+                    json(io, { ok: true, ...result });
+                }
+                else {
+                    line(io, '');
+                    line(io, 'Paste these into Chrome: Page Scanner settings, "Local agents".');
+                    line(io, '');
+                    line(io, `  Port   ${result.port}`);
+                    line(io, `  Token  ${result.token}`);
+                    line(io, '');
+                    line(io, `Saved to ${result.configPath}${result.ownerOnly ? ' (owner-readable only).' : '.'}`);
+                    if (!result.ownerOnly) {
+                        note(io, 'Windows does not enforce the owner-only mode this file is written with. On a ' +
+                            'shared machine, restrict it yourself: see the README.');
+                    }
+                    line(io, 'Name the browser too, so an agent can tell your profiles apart, then press Connect.');
+                }
+                if (parsed.waitSeconds > 0) {
+                    if (!parsed.json) {
+                        note(io, `Waiting up to ${parsed.waitSeconds}s for the browser to connect.`);
+                    }
+                    // Not connecting is not a failure of `pair`: the pairing is written
+                    // and correct either way, and the user may simply not have Chrome
+                    // open yet. Say so and exit 0.
+                    try {
+                        const connected = await waitForBrowser({ waitSeconds: parsed.waitSeconds });
+                        if (!parsed.json) {
+                            note(io, `Connected as "${connected.label}" (${connected.browserId}).`);
+                        }
+                    }
+                    catch {
+                        if (!parsed.json) {
+                            note(io, 'No browser connected yet. The pairing is saved; press Connect when ready.');
+                        }
+                    }
+                }
+                return 0;
+            }
+            case 'status':
+                reportStatus(io, await status(), parsed.json);
+                return 0;
+            case 'browsers': {
+                const browsers = await listBrowsers();
+                if (parsed.json) {
+                    json(io, { ok: true, browsers });
+                }
+                else if (browsers.length === 0) {
+                    note(io, 'No browser is connected. Open the Page Scanner settings page in Chrome and press Connect.');
+                    return 3;
+                }
+                else {
+                    line(io, formatBrowsers(browsers));
+                }
+                return 0;
+            }
+            case 'tabs': {
+                await warnIfWaiting(io, parsed.waitSeconds, parsed.json);
+                const result = await listTabs({
+                    ...(parsed.browser !== undefined ? { browser: parsed.browser } : {}),
+                    waitSeconds: parsed.waitSeconds,
+                });
+                if (parsed.json) {
+                    json(io, { ok: true, ...result });
+                }
+                else {
+                    line(io, formatTabs(result.windows, result.tabs));
+                }
+                return 0;
+            }
+            case 'scan': {
+                await warnIfWaiting(io, parsed.waitSeconds, parsed.json);
+                const result = await scan({
+                    ...(parsed.url !== undefined ? { url: parsed.url } : {}),
+                    ...(parsed.tabId !== undefined ? { tabId: parsed.tabId } : {}),
+                    ...(parsed.windowId !== undefined ? { windowId: parsed.windowId } : {}),
+                    ...(parsed.browser !== undefined ? { browser: parsed.browser } : {}),
+                    ...(parsed.quality !== undefined ? { quality: parsed.quality } : {}),
+                    ...(parsed.videoHandling !== undefined ? { videoHandling: parsed.videoHandling } : {}),
+                    ...(parsed.out !== undefined ? { out: parsed.out } : {}),
+                    format: parsed.format,
+                    pageSize: parsed.pageSize,
+                    openEditor: parsed.openEditor,
+                    waitSeconds: parsed.waitSeconds,
+                    timeoutSeconds: parsed.timeoutSeconds,
+                });
+                reportScan(io, result, parsed.format, parsed.json);
+                return 0;
+            }
+            case 'stop': {
+                const wasRunning = await stop();
+                if (parsed.json)
+                    json(io, { ok: true, stopped: wasRunning });
+                else
+                    note(io, wasRunning ? 'Stopped.' : 'No daemon was running.');
+                return 0;
+            }
+            case 'serve': {
+                // Only this branch loads the WebSocket server, so every other command
+                // stays free of `ws`. The Bun binary bundles it either way; the npm
+                // package does not pay for it on a scan.
+                const { runDaemon } = await import('../daemon/run.js');
+                await runDaemon({
+                    detached: parsed.daemon,
+                    ...(parsed.idleMinutes !== undefined ? { idleMinutes: parsed.idleMinutes } : {}),
+                    log: (message) => note(io, message),
+                });
+                return 0;
+            }
+        }
+    }
+    catch (error) {
+        const failure = toPageScannerError(error);
+        const code = exitCodeFor(failure.code);
+        const useJson = 'json' in parsed && parsed.json === true;
+        if (useJson) {
+            json(io, { ok: false, code, error: failure.code, message: failure.message });
+        }
+        else {
+            note(io, failure.message);
+            if (failure.hint)
+                note(io, failure.hint);
+        }
+        return code;
+    }
+}
+//# sourceMappingURL=commands.js.map

package/dist/cli/commands.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"commands.js","sourceRoot":"","sources":["../../src/cli/commands.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AACH,OAAO,EACL,YAAY,EACZ,QAAQ,EACR,IAAI,EACJ,IAAI,EACJ,MAAM,EACN,IAAI,EACJ,cAAc,GAGf,MAAM,WAAW,CAAC;AACnB,OAAO,EAAE,WAAW,EAAE,kBAAkB,EAAE,MAAM,cAAc,CAAC;AAC/D,OAAO,EAAE,cAAc,EAAE,cAAc,EAAE,UAAU,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAC;AAG3F,OAAO,EAAE,KAAK,EAAE,MAAM,WAAW,CAAC;AAClC,OAAO,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAO5C,SAAS,IAAI,CAAC,EAAa,EAAE,IAAY;IACvC,EAAE,CAAC,MAAM,CAAC,GAAG,IAAI,IAAI,CAAC,CAAC;AACzB,CAAC;AAED,SAAS,IAAI,CAAC,EAAa,EAAE,IAAY;IACvC,EAAE,CAAC,MAAM,CAAC,GAAG,IAAI,IAAI,CAAC,CAAC;AACzB,CAAC;AAED,SAAS,IAAI,CAAC,EAAa,EAAE,OAAgB;IAC3C,EAAE,CAAC,MAAM,CAAC,GAAG,IAAI,CAAC,SAAS,CAAC,OAAO,EAAE,IAAI,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC;AACrD,CAAC;AAED;;;;GAIG;AACH,KAAK,UAAU,aAAa,CAAC,EAAa,EAAE,WAAmB,EAAE,OAAgB;IAC/E,IAAI,OAAO,IAAI,WAAW,IAAI,CAAC;QAAE,OAAO;IACxC,IAAI,CAAC;QACH,MAAM,QAAQ,GAAG,MAAM,YAAY,EAAE,CAAC;QACtC,IAAI,QAAQ,CAAC,MAAM,GAAG,CAAC;YAAE,OAAO;IAClC,CAAC;IAAC,MAAM,CAAC;QACP,uEAAuE;QACvE,+CAA+C;QAC/C,OAAO;IACT,CAAC;IACD,IAAI,CACF,EAAE,EACF,wCAAwC,WAAW,qCAAqC;QACtF,yBAAyB,CAC5B,CAAC;AACJ,CAAC;AAED,SAAS,UAAU,CACjB,EAAa,EACb,MAAkB,EAClB,MAAsB,EACtB,OAAgB;IAEhB,IAAI,OAAO,EAAE,CAAC;QACZ,IAAI,CAAC,EAAE,EAAE,EAAE,EAAE,EAAE,IAAI,EAAE,GAAG,MAAM,EAAE,CAAC,CAAC;QAClC,OAAO;IACT,CAAC;IACD,IAAI,MAAM,CAAC,SAAS;QAAE,IAAI,CAAC,EAAE,EAAE,gBAAgB,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC,CAAC;IACnE,IAAI,MAAM,CAAC,IAAI,KAAK,QAAQ,EAAE,CAAC;QAC7B,wEAAwE;QACxE,mEAAmE;QACnE,uEAAuE;QACvE,IAAI,CACF,EAAE,EACF,MAAM,KAAK,KAAK;YACd,CAAC,CAAC,mFAAmF;gBACjF,mCAAmC;YACvC,CAAC,CAAC,8EAA8E,CACnF,CAAC;IACJ,CAAC;IACD,IAAI,CAAC,EAAE,EAAE,MAAM,CAAC,IAAI,CAAC,CAAC;AACxB,CAAC;AAED,SAAS,YAAY,CAAC,EAAa,EAAE,MAAoB,EAAE,OAAgB;IACzE,IAAI,OAAO,EAAE,CAAC;QACZ,IAAI,CAAC,EAAE,EAAE,EAAE,EAAE,EAAE,IAAI,EAAE,GAAG,MAAM,EAAE,CAAC,CAAC;QAClC,OAAO;IACT,CAAC;IACD,MAAM,IAAI,GAAG;QACX,kBAAkB,MAAM,CAAC,OAAO,EAAE;QAClC,kBAAkB,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,QAAQ,MAAM,CAAC,UAAU,EAAE,CAAC,CAAC,CAAC,+BAA+B,EAAE;QACjG,kBAAkB,MAAM,CAAC,UAAU,GAAG,MAAM,CAAC,eAAe,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,oCAAoC,EAAE;QAC1G,MAAM,CAAC,MAAM,CAAC,OAAO;YACnB,CAAC,CAAC,+BAA+B,MAAM,CAAC,MAAM,CAAC,GAAG,aAAa,MAAM,CAAC,MAAM,CAAC,OAAO,EAAE;YACtF,CAAC,CAAC,4BAA4B;KACjC,CAAC;IACF,KAAK,MAAM,GAAG,IAAI,IAAI;QAAE,IAAI,CAAC,EAAE,EAAE,GAAG,CAAC,CAAC;IACtC,IAAI,MAAM,CAAC,QAAQ,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACjC,IAAI,CAAC,EAAE,EAAE,+BAA+B,CAAC,CAAC;QAC1C,OAAO;IACT,CAAC;IACD,IAAI,CAAC,EAAE,EAAE,UAAU,CAAC,CAAC;IACrB,KAAK,MAAM,OAAO,IAAI,MAAM,CAAC,QAAQ,EAAE,CAAC;QACtC,IAAI,CACF,EAAE,EACF,KAAK,OAAO,CAAC,KAAK,KAAK,OAAO,CAAC,SAAS,eAAe,OAAO,CAAC,gBAAgB,IAAI;YACjF,aAAa,cAAc,CAAC,OAAO,CAAC,cAAc,CAAC,EAAE,CACxD,CAAC;IACJ,CAAC;AACH,CAAC;AAED,iEAAiE;AACjE,MAAM,CAAC,KAAK,UAAU,UAAU,CAAC,MAAkB,EAAE,EAAa;IAChE,IAAI,CAAC;QACH,QAAQ,MAAM,CAAC,OAAO,EAAE,CAAC;YACvB,KAAK,MAAM;gBACT,IAAI,CAAC,EAAE,EAAE,KAAK,CAAC,CAAC;gBAChB,OAAO,CAAC,CAAC;YAEX,KAAK,SAAS;gBACZ,IAAI,CAAC,EAAE,EAAE,WAAW,CAAC,CAAC;gBACtB,OAAO,CAAC,CAAC;YAEX,KAAK,MAAM,CAAC,CAAC,CAAC;gBACZ,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC;oBACxB,GAAG,CAAC,MAAM,CAAC,IAAI,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,MAAM,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;oBAC3D,MAAM,EAAE,MAAM,CAAC,MAAM;iBACtB,CAAC,CAAC;gBACH,IAAI,MAAM,CAAC,IAAI,EAAE,CAAC;oBAChB,IAAI,CAAC,EAAE,EAAE,EAAE,EAAE,EAAE,IAAI,EAAE,GAAG,MAAM,EAAE,CAAC,CAAC;gBACpC,CAAC;qBAAM,CAAC;oBACN,IAAI,CAAC,EAAE,EAAE,EAAE,CAAC,CAAC;oBACb,IAAI,CAAC,EAAE,EAAE,iEAAiE,CAAC,CAAC;oBAC5E,IAAI,CAAC,EAAE,EAAE,EAAE,CAAC,CAAC;oBACb,IAAI,CAAC,EAAE,EAAE,YAAY,MAAM,CAAC,IAAI,EAAE,CAAC,CAAC;oBACpC,IAAI,CAAC,EAAE,EAAE,YAAY,MAAM,CAAC,KAAK,EAAE,CAAC,CAAC;oBACrC,IAAI,CAAC,EAAE,EAAE,EAAE,CAAC,CAAC;oBACb,IAAI,CACF,EAAE,EACF,YAAY,MAAM,CAAC,UAAU,GAAG,MAAM,CAAC,SAAS,CAAC,CAAC,CAAC,yBAAyB,CAAC,CAAC,CAAC,GAAG,EAAE,CACrF,CAAC;oBACF,IAAI,CAAC,MAAM,CAAC,SAAS,EAAE,CAAC;wBACtB,IAAI,CACF,EAAE,EACF,+EAA+E;4BAC7E,uDAAuD,CAC1D,CAAC;oBACJ,CAAC;oBACD,IAAI,CACF,EAAE,EACF,qFAAqF,CACtF,CAAC;gBACJ,CAAC;gBAED,IAAI,MAAM,CAAC,WAAW,GAAG,CAAC,EAAE,CAAC;oBAC3B,IAAI,CAAC,MAAM,CAAC,IAAI,EAAE,CAAC;wBACjB,IAAI,CAAC,EAAE,EAAE,iBAAiB,MAAM,CAAC,WAAW,+BAA+B,CAAC,CAAC;oBAC/E,CAAC;oBACD,oEAAoE;oBACpE,kEAAkE;oBAClE,+BAA+B;oBAC/B,IAAI,CAAC;wBACH,MAAM,SAAS,GAAG,MAAM,cAAc,CAAC,EAAE,WAAW,EAAE,MAAM,CAAC,WAAW,EAAE,CAAC,CAAC;wBAC5E,IAAI,CAAC,MAAM,CAAC,IAAI,EAAE,CAAC;4BACjB,IAAI,CAAC,EAAE,EAAE,iBAAiB,SAAS,CAAC,KAAK,MAAM,SAAS,CAAC,SAAS,IAAI,CAAC,CAAC;wBAC1E,CAAC;oBACH,CAAC;oBAAC,MAAM,CAAC;wBACP,IAAI,CAAC,MAAM,CAAC,IAAI,EAAE,CAAC;4BACjB,IAAI,CAAC,EAAE,EAAE,2EAA2E,CAAC,CAAC;wBACxF,CAAC;oBACH,CAAC;gBACH,CAAC;gBACD,OAAO,CAAC,CAAC;YACX,CAAC;YAED,KAAK,QAAQ;gBACX,YAAY,CAAC,EAAE,EAAE,MAAM,MAAM,EAAE,EAAE,MAAM,CAAC,IAAI,CAAC,CAAC;gBAC9C,OAAO,CAAC,CAAC;YAEX,KAAK,UAAU,CAAC,CAAC,CAAC;gBAChB,MAAM,QAAQ,GAAG,MAAM,YAAY,EAAE,CAAC;gBACtC,IAAI,MAAM,CAAC,IAAI,EAAE,CAAC;oBAChB,IAAI,CAAC,EAAE,EAAE,EAAE,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,CAAC,CAAC;gBACnC,CAAC;qBAAM,IAAI,QAAQ,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;oBACjC,IAAI,CACF,EAAE,EACF,2FAA2F,CAC5F,CAAC;oBACF,OAAO,CAAC,CAAC;gBACX,CAAC;qBAAM,CAAC;oBACN,IAAI,CAAC,EAAE,EAAE,cAAc,CAAC,QAAQ,CAAC,CAAC,CAAC;gBACrC,CAAC;gBACD,OAAO,CAAC,CAAC;YACX,CAAC;YAED,KAAK,MAAM,CAAC,CAAC,CAAC;gBACZ,MAAM,aAAa,CAAC,EAAE,EAAE,MAAM,CAAC,WAAW,EAAE,MAAM,CAAC,IAAI,CAAC,CAAC;gBACzD,MAAM,MAAM,GAAG,MAAM,QAAQ,CAAC;oBAC5B,GAAG,CAAC,MAAM,CAAC,OAAO,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,MAAM,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;oBACpE,WAAW,EAAE,MAAM,CAAC,WAAW;iBAChC,CAAC,CAAC;gBACH,IAAI,MAAM,CAAC,IAAI,EAAE,CAAC;oBAChB,IAAI,CAAC,EAAE,EAAE,EAAE,EAAE,EAAE,IAAI,EAAE,GAAG,MAAM,EAAE,CAAC,CAAC;gBACpC,CAAC;qBAAM,CAAC;oBACN,IAAI,CAAC,EAAE,EAAE,UAAU,CAAC,MAAM,CAAC,OAAO,EAAE,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC;gBACpD,CAAC;gBACD,OAAO,CAAC,CAAC;YACX,CAAC;YAED,KAAK,MAAM,CAAC,CAAC,CAAC;gBACZ,MAAM,aAAa,CAAC,EAAE,EAAE,MAAM,CAAC,WAAW,EAAE,MAAM,CAAC,IAAI,CAAC,CAAC;gBACzD,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC;oBACxB,GAAG,CAAC,MAAM,CAAC,GAAG,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,GAAG,EAAE,MAAM,CAAC,GAAG,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;oBACxD,GAAG,CAAC,MAAM,CAAC,KAAK,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,MAAM,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;oBAC9D,GAAG,CAAC,MAAM,CAAC,QAAQ,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,QAAQ,EAAE,MAAM,CAAC,QAAQ,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;oBACvE,GAAG,CAAC,MAAM,CAAC,OAAO,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,MAAM,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;oBACpE,GAAG,CAAC,MAAM,CAAC,OAAO,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,MAAM,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;oBACpE,GAAG,CAAC,MAAM,CAAC,aAAa,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,aAAa,EAAE,MAAM,CAAC,aAAa,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;oBACtF,GAAG,CAAC,MAAM,CAAC,GAAG,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,GAAG,EAAE,MAAM,CAAC,GAAG,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;oBACxD,MAAM,EAAE,MAAM,CAAC,MAAM;oBACrB,QAAQ,EAAE,MAAM,CAAC,QAAQ;oBACzB,UAAU,EAAE,MAAM,CAAC,UAAU;oBAC7B,WAAW,EAAE,MAAM,CAAC,WAAW;oBAC/B,cAAc,EAAE,MAAM,CAAC,cAAc;iBACtC,CAAC,CAAC;gBACH,UAAU,CAAC,EAAE,EAAE,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,IAAI,CAAC,CAAC;gBACnD,OAAO,CAAC,CAAC;YACX,CAAC;YAED,KAAK,MAAM,CAAC,CAAC,CAAC;gBACZ,MAAM,UAAU,GAAG,MAAM,IAAI,EAAE,CAAC;gBAChC,IAAI,MAAM,CAAC,IAAI;oBAAE,IAAI,CAAC,EAAE,EAAE,EAAE,EAAE,EAAE,IAAI,EAAE,OAAO,EAAE,UAAU,EAAE,CAAC,CAAC;;oBACxD,IAAI,CAAC,EAAE,EAAE,UAAU,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC,wBAAwB,CAAC,CAAC;gBAClE,OAAO,CAAC,CAAC;YACX,CAAC;YAED,KAAK,OAAO,CAAC,CAAC,CAAC;gBACb,sEAAsE;gBACtE,oEAAoE;gBACpE,yCAAyC;gBACzC,MAAM,EAAE,SAAS,EAAE,GAAG,MAAM,MAAM,CAAC,kBAAkB,CAAC,CAAC;gBACvD,MAAM,SAAS,CAAC;oBACd,QAAQ,EAAE,MAAM,CAAC,MAAM;oBACvB,GAAG,CAAC,MAAM,CAAC,WAAW,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,WAAW,EAAE,MAAM,CAAC,WAAW,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;oBAChF,GAAG,EAAE,CAAC,OAAO,EAAE,EAAE,CAAC,IAAI,CAAC,EAAE,EAAE,OAAO,CAAC;iBACpC,CAAC,CAAC;gBACH,OAAO,CAAC,CAAC;YACX,CAAC;QACH,CAAC;IACH,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,MAAM,OAAO,GAAG,kBAAkB,CAAC,KAAK,CAAC,CAAC;QAC1C,MAAM,IAAI,GAAG,WAAW,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;QACvC,MAAM,OAAO,GAAG,MAAM,IAAI,MAAM,IAAI,MAAM,CAAC,IAAI,KAAK,IAAI,CAAC;QACzD,IAAI,OAAO,EAAE,CAAC;YACZ,IAAI,CAAC,EAAE,EAAE,EAAE,EAAE,EAAE,KAAK,EAAE,IAAI,EAAE,KAAK,EAAE,OAAO,CAAC,IAAI,EAAE,OAAO,EAAE,OAAO,CAAC,OAAO,EAAE,CAAC,CAAC;QAC/E,CAAC;aAAM,CAAC;YACN,IAAI,CAAC,EAAE,EAAE,OAAO,CAAC,OAAO,CAAC,CAAC;YAC1B,IAAI,OAAO,CAAC,IAAI;gBAAE,IAAI,CAAC,EAAE,EAAE,OAAO,CAAC,IAAI,CAAC,CAAC;QAC3C,CAAC;QACD,OAAO,IAAI,CAAC;IACd,CAAC;AACH,CAAC"}