@page-scanner/cli 0.1.1 → 0.2.0

package/README.md

@@ -73,10 +73,15 @@ page-scanner pair     [--port <n>] [--rotate] [--wait <s>=120] [--no-wait] [--js
 page-scanner status   [--json]
 page-scanner browsers [--json]
 page-scanner tabs     [--browser <id|label>] [--wait <s>=30] [--json]
-page-scanner scan     (--url <u> | --tab <id>) [--window <id>] [--browser <id|label>]
+page-scanner scan     (--url <u>... | --urls <file|-> | --tab <id>) [--window <id>]
+                      [--name <template>] [--markdown beside|only]
+                      [--browser <id|label>]
                       [--format pdf|png|jpeg=pdf] [--page-size auto|a4|letter=a4]
-                      [--quality <0-1>] [--video frame|blank] [--open-editor]
+                      [--quality <0-1>] [--video frame|blank]
+                      [--scheme auto|light|dark]
+                      [--page-width window|a4|letter] [--open-editor]
                       [--out <file|dir>] [--wait <s>=30] [--timeout <s>=120] [--json]
+page-scanner diff     <old> <new> [--out <file>] [--json]
 page-scanner serve    [--daemon] [--idle <min>]
 page-scanner stop
 page-scanner --version | --help
@@ -90,10 +95,47 @@ and a directory otherwise, in which case the browser's suggested filename is use
 Parent directories are created. A relative path is relative to **your** working directory, not the
 daemon's, which is why the daemon hands the bytes back rather than writing them itself.
 
+`--page-width` lays the page out at the width of a sheet before capturing it, the way a narrow
+window would, so the PDF prints at 1:1 rather than being scaled down. `window`, the default, is
+the width the browser has the page at. A 1280 px window on A4 is scaled to 55 %, which puts 16 px
+body text at 6.5 pt; `--page-width a4` puts it at 12.
+
+`--scheme` picks which of a page's two themes to capture, for a page that has both. `auto`, the
+default, is whichever the browser is showing; `light` and `dark` force one. It applies to the PDF
+as well as the preview, which is the point: Chrome prints every page in the light scheme unless it
+is told otherwise, so without this a dark page produced a white PDF.
+
 `--page-size` decides what a PDF is laid onto. `a4` and `letter` slice the capture across printable
 sheets with a half-inch margin; `auto` is one page the exact size of the capture, which is not
 printable and which Acrobat clamps past 200 inches.
 
+`--url` more than once, or `--urls <file>` (one address to a line, `#` for a comment, `-` for
+standard input), scans a list, one page at a time, into `--out`, which is then a directory. Each
+path is printed as its file is written; a page that fails is reported on stderr and the rest carry
+on, and the exit code is 1 if any failed. Up to 1,000 addresses a run.
+
+`--name` names the file inside `--out`: `{n}` (the page's place in the list), `{host}`, `{name}`
+(the browser's suggested name), `{date}`, `{time}` (when the run started) and `{ext}`, which is
+added when left out. A `/` makes a subdirectory:
+
+```bash
+page-scanner scan --urls reading.txt --out ~/Captures/ --name '{date}/{n}-{host}'
+```
+
+`--markdown beside` also writes the page's text as a `.md` next to the file, read from the page
+itself rather than from the PDF, and prints its path on a second line; `--markdown only` writes the
+`.md` alone. With `--json`, the result carries the title, address, capture time, language and
+headings as `page`. Pictures are left out of the text.
+
+`page-scanner diff <old> <new>` says what changed between two captures, with no browser: two
+Markdown files (or two PDFs with the `.md` beside them) a passage at a time, printed as `diff -u`
+prints it, or two PNGs pixel by pixel, writing the newer one with the changed regions outlined. It
+exits 0 when nothing changed and 1 when something did.
+
+There is no scheduler here: cron, launchd and Task Scheduler run the command at a time. Start the
+daemon at login with `page-scanner serve --daemon --idle 0` so the extension is connected when the
+schedule fires. The documentation has an example for each.
+
 `--wait 0` means do not wait at all. Chrome retires the extension's service worker after about
 thirty seconds of silence, so the default wait exists to cover the reconnect that follows.
 
@@ -140,6 +182,9 @@ a sentence naming the gap.
 | 4    | not paired                                                                    |
 | 5    | the daemon would not start                                                    |
 
+`diff` uses the codes the way `diff` itself does: `0` when the two captures are the same, `1` when
+something changed, and `2` for anything it cannot compare.
+
 ## The daemon
 
 The extension is the WebSocket **client**: nothing outside Chrome can open a connection into a
@@ -197,11 +242,14 @@ loopback port is reachable by everything running as you. So:
 ## Using it from Node
 
 ```js
-import { scan, listTabs } from '@page-scanner/cli';
+import { scan, scanMany, listTabs } from '@page-scanner/cli';
 
 const { tabs } = await listTabs();
 const result = await scan({ tabId: tabs[0].tabId, out: './out/', format: 'pdf' });
 console.log(result.path, result.selectableText);
+
+// A list, one page at a time, with a result for each.
+const batch = await scanMany(['https://example.com/a', 'https://example.com/b'], { out: './out/' });
 ```
 
 The package's main entry point does not load `ws`: the bridge runs in the daemon, which is a
@@ -215,7 +263,8 @@ the only one that pulls the WebSocket server in.
 - `chrome.debugger` cannot attach while DevTools is open on the same tab. Close it, or scan a
   different tab.
 - A page larger than 60,000 CSS pixels on a side is captured up to that limit, and the result says
-  so in `truncated`.
+  so in `truncated`. The extension's settings page can raise the height's limit to 120,000 or
+  240,000, and a scan from here follows it.
 - One pairing per machine, shared by every browser profile that connects to it.
 
 ## Licence

package/dist/api.d.ts

@@ -1,5 +1,5 @@
 import type { PairingConfig } from './config.js';
-import type { ExportFormatId, PageSizeId, TabSummary, TruncationReport, VideoHandling, WindowSummary } from './protocol.js';
+import type { CaptureWidth, ColorSchemePreference, ExportFormatId, StructuredHeading, PageSizeId, TabSummary, TruncationReport, VideoHandling, WindowSummary } from './protocol.js';
 import { stopDaemon, type ConnectOptions } from './daemon/client.js';
 import type { ConnectedBrowser } from './bridge/server.js';
 export interface CommonOptions extends ConnectOptions {
@@ -16,16 +16,48 @@ export interface ScanOptions extends CommonOptions {
     pageSize?: PageSizeId;
     quality?: number;
     videoHandling?: VideoHandling;
+    colorScheme?: ColorSchemePreference;
+    captureWidth?: CaptureWidth;
     openEditor?: boolean;
     /** A file, or a directory to put the browser's suggested filename in. */
     out?: string;
+    /**
+     * The file's name inside `out` (or the working directory), as a template:
+     * `{n}`, `{host}`, `{name}`, `{date}`, `{time}`, `{ext}` (#59). Not with an
+     * `out` that names the file itself.
+     */
+    name?: string;
+    /**
+     * The page's text as Markdown (#61): `beside` writes a `.md` next to the
+     * file, `only` writes the `.md` and no file, `inline` puts the text in the
+     * result instead of on disk. Each also puts the page's title, address,
+     * capture time, language and headings in the result as `page`.
+     */
+    markdown?: MarkdownMode;
     /** What a relative `out` is relative to. Defaults to process.cwd(). */
     cwd?: string;
     /** How long to give the browser to produce the capture. */
     timeoutSeconds?: number;
 }
+/** Where the page's text goes: beside the file, instead of it, or into the result. */
+export declare const MARKDOWN_MODES: readonly ["beside", "only", "inline"];
+export type MarkdownMode = (typeof MARKDOWN_MODES)[number];
+/** The page as text, and what it is (#61). */
+export interface PageText {
+    title: string;
+    url: string;
+    /** ISO 8601, UTC. */
+    capturedAt: string;
+    /** The page's own `lang`, or null when it names none. */
+    language: string | null;
+    headings: StructuredHeading[];
+    /** Where the Markdown was written, for `beside` and `only`. */
+    markdownPath?: string;
+    /** The Markdown itself, for `inline`. */
+    markdown?: string;
+}
 export interface ScanResult {
-    /** Absolute path of the file this wrote. */
+    /** Absolute path of the file this wrote: the `.md` itself for `markdown: 'only'`. */
     path: string;
     width: number;
     height: number;
@@ -36,6 +68,8 @@ export interface ScanResult {
     truncated: TruncationReport | null;
     browserId: string;
     fileName: string;
+    /** The page as text, when `markdown` asked for it. */
+    page?: PageText;
 }
 export interface TabsResult {
     browserId: string;
@@ -80,7 +114,53 @@ export declare function waitForBrowser(options?: CommonOptions): Promise<{
     label: string;
 }>;
 export declare function listTabs(options?: CommonOptions): Promise<TabsResult>;
+/**
+ * Refuses a `--name` or an `--out` that cannot work for `files` files, before
+ * anything is asked of the daemon or the browser.
+ */
+export declare function checkOutput(options: Pick<ScanOptions, 'out' | 'name' | 'cwd'>, files: number): void;
 export declare function scan(options: ScanOptions): Promise<ScanResult>;
+/** One address of a batch: what it wrote, or why it did not. */
+export type BatchItem = ({
+    url: string;
+    ok: true;
+} & ScanResult) | {
+    url: string;
+    ok: false;
+    error: {
+        code: string;
+        message: string;
+        hint?: string;
+    };
+};
+export interface BatchResult {
+    /** One per address that was tried, in the list's order. */
+    results: BatchItem[];
+    written: number;
+    failed: number;
+    /**
+     * Set when a failure ended the batch early (no pairing, no browser, no
+     * daemon), so the addresses after `results` were not tried.
+     */
+    stopped?: {
+        code: string;
+        message: string;
+        hint?: string;
+    };
+}
+export interface BatchOptions extends Omit<ScanOptions, 'url' | 'tabId'> {
+    /** Called as each address finishes, for a caller that reports as it goes. */
+    onItem?: (item: BatchItem, index: number) => void;
+}
+/**
+ * Scans each address in turn and writes a file for each (#59). A page that
+ * fails is reported and the next one is scanned; a failure no later page
+ * could get past ends the batch. Files that two pages would give the same
+ * name are told apart with `-2`, `-3`.
+ */
+export declare function scanMany(urls: readonly string[], options?: BatchOptions): Promise<BatchResult>;
+/** What `scanMany` refuses before it starts: an empty or oversized list, or an unusable name. */
+export declare function checkBatch(urls: readonly string[], options: Pick<ScanOptions, 'out' | 'name' | 'cwd'>): void;
 /** Everything `page-scanner status` reports, without starting a daemon. */
 export declare function status(): Promise<StatusReport>;
 export { stopDaemon as stop };

package/dist/api.d.ts.map

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

package/dist/api.js

@@ -6,12 +6,15 @@
  * the WebSocket server; `@page-scanner/cli/daemon` is the subpath that does.
  */
 import { ensureConfig, readConfig, configPath, configFileIsOwnerOnly } from './config.js';
-import { PAIR_COMMAND, PageScannerError } from './errors.js';
-import { resolveOutputPath, writeScanFile } from './output.js';
+import { PAIR_COMMAND, PageScannerError, toPageScannerError } from './errors.js';
+import { outputNamesAFile, resolveOutputPath, withExtension, writeScanFile, writeTextFile, } from './output.js';
+import { MAX_BATCH_URLS, checkNameTemplate, endsTheBatch, fillNameTemplate, uniqueName, } from './batch.js';
 import { DEFAULT_PAGE_SIZE } from './protocol.js';
 import { connectDaemon, stopDaemon } from './daemon/client.js';
 import { readDaemonState } from './daemon/state.js';
 import { CLI_VERSION } from './version.js';
+/** Where the page's text goes: beside the file, instead of it, or into the result. */
+export const MARKDOWN_MODES = ['beside', 'only', 'inline'];
 function requirePairing() {
     const config = readConfig();
     if (!config.token) {
@@ -63,15 +66,151 @@ export async function listTabs(options = {}) {
         timeoutMs: waitMs,
     }, waitMs + 30_000);
 }
+/**
+ * Refuses a `--name` or an `--out` that cannot work for `files` files, before
+ * anything is asked of the daemon or the browser.
+ */
+export function checkOutput(options, files) {
+    if (options.name !== undefined)
+        checkNameTemplate(options.name);
+    if (options.out !== undefined && outputNamesAFile(options.out, options.cwd)) {
+        if (options.name !== undefined) {
+            throw new PageScannerError('BAD_REQUEST', `--out ${JSON.stringify(options.out)} names a file, so there is nothing for --name to name.`, 'Give --out a directory (end it with a slash if it does not exist yet).');
+        }
+        if (files > 1) {
+            throw new PageScannerError('BAD_REQUEST', `--out ${JSON.stringify(options.out)} names one file, and this scans ${files} pages.`, 'Give --out a directory (end it with a slash if it does not exist yet).');
+        }
+    }
+}
+/**
+ * Writes what the daemon answered to `target`, and the page's text where
+ * `markdown` says, and reports it. Nothing is written when the text was asked
+ * for and did not come: an extension from before #61 ignores the request and
+ * sends the file alone.
+ */
+function deliver(answer, target, options) {
+    const mode = options.markdown;
+    if (mode !== undefined && !answer.structured) {
+        throw new PageScannerError('SCAN_FAILED', 'This version of Page Scanner in Chrome does not send the page’s text.', 'Update the extension (chrome://extensions, then Update), and scan again.');
+    }
+    const text = answer.structured;
+    const page = text && {
+        title: text.title,
+        url: text.url,
+        capturedAt: new Date(text.capturedAt).toISOString(),
+        language: text.language,
+        headings: text.headings,
+    };
+    if (mode === 'only' && text && page) {
+        writeTextFile(target, text.markdown);
+        page.markdownPath = target;
+    }
+    else {
+        writeScanFile(target, answer.bytesBase64);
+        if (mode === 'beside' && text && page) {
+            page.markdownPath = withExtension(target, 'md');
+            writeTextFile(page.markdownPath, text.markdown);
+        }
+        if (mode === 'inline' && text && page)
+            page.markdown = text.markdown;
+    }
+    return {
+        path: target,
+        width: answer.width,
+        height: answer.height,
+        mode: answer.mode,
+        selectableText: mode !== 'only' && answer.mode === 'vector' && (options.format ?? 'pdf') === 'pdf',
+        truncated: answer.truncated,
+        browserId: answer.browserId,
+        fileName: answer.fileName,
+        ...(page ? { page } : {}),
+    };
+}
 export async function scan(options) {
     requirePairing();
     if ((options.url === undefined) === (options.tabId === undefined)) {
         throw new PageScannerError('BAD_REQUEST', 'Give exactly one of url and tabId.');
     }
+    checkOutput(options, 1);
+    const answer = await requestScan(options);
+    // The daemon hands back bytes, not a path. It may have been started hours
+    // ago from another directory; only this process knows what a relative
+    // `--out` means.
+    const name = options.name === undefined
+        ? answer.fileName
+        : fillNameTemplate(options.name, {
+            index: 1,
+            count: 1,
+            url: options.url ?? '',
+            suggested: answer.fileName,
+            startedAt: new Date(),
+        });
+    const target = resolveOutputPath(options.out, name, options.cwd);
+    return deliver(answer, target, options);
+}
+/**
+ * Scans each address in turn and writes a file for each (#59). A page that
+ * fails is reported and the next one is scanned; a failure no later page
+ * could get past ends the batch. Files that two pages would give the same
+ * name are told apart with `-2`, `-3`.
+ */
+export async function scanMany(urls, options = {}) {
+    requirePairing();
+    checkBatch(urls, options);
+    const { onItem, ...scanOptions } = options;
+    const startedAt = new Date();
+    const taken = new Set();
+    const result = { results: [], written: 0, failed: 0 };
+    for (const [index, url] of urls.entries()) {
+        let item;
+        try {
+            const answer = await requestScan({ ...scanOptions, url });
+            const name = uniqueName(options.name === undefined
+                ? answer.fileName
+                : fillNameTemplate(options.name, {
+                    index: index + 1,
+                    count: urls.length,
+                    url,
+                    suggested: answer.fileName,
+                    startedAt,
+                }), taken);
+            const target = resolveOutputPath(options.out, name, options.cwd);
+            item = { url, ok: true, ...deliver(answer, target, scanOptions) };
+            result.written += 1;
+        }
+        catch (thrown) {
+            const error = toPageScannerError(thrown);
+            const reason = {
+                code: error.code,
+                message: error.message,
+                ...(error.hint !== undefined ? { hint: error.hint } : {}),
+            };
+            if (endsTheBatch(error)) {
+                result.stopped = reason;
+                break;
+            }
+            item = { url, ok: false, error: reason };
+            result.failed += 1;
+        }
+        result.results.push(item);
+        onItem?.(item, index);
+    }
+    return result;
+}
+/** What `scanMany` refuses before it starts: an empty or oversized list, or an unusable name. */
+export function checkBatch(urls, options) {
+    if (urls.length === 0)
+        throw new PageScannerError('BAD_REQUEST', 'The list has no addresses.');
+    if (urls.length > MAX_BATCH_URLS) {
+        throw new PageScannerError('BAD_REQUEST', `The list has ${urls.length} addresses; one run takes up to ${MAX_BATCH_URLS}.`);
+    }
+    checkOutput(options, urls.length);
+}
+async function requestScan(options) {
     const waitMs = Math.round((options.waitSeconds ?? 30) * 1000);
     const scanMs = Math.round((options.timeoutSeconds ?? 120) * 1000);
     const daemon = await connectDaemon(options);
-    const answer = await daemon.call('scan', {
+    return daemon.call('scan', {
         ...(options.browser !== undefined ? { browserId: options.browser } : {}),
         ...(options.url !== undefined ? { url: options.url } : {}),
         ...(options.tabId !== undefined ? { tabId: options.tabId } : {}),
@@ -80,25 +219,15 @@ export async function scan(options) {
         pageSize: options.pageSize ?? DEFAULT_PAGE_SIZE,
         ...(options.quality !== undefined ? { quality: options.quality } : {}),
         ...(options.videoHandling !== undefined ? { videoHandling: options.videoHandling } : {}),
+        ...(options.colorScheme !== undefined ? { colorScheme: options.colorScheme } : {}),
+        ...(options.captureWidth !== undefined ? { captureWidth: options.captureWidth } : {}),
         ...(options.openEditor !== undefined ? { openEditor: options.openEditor } : {}),
+        ...(options.markdown !== undefined
+            ? { structured: options.markdown === 'only' ? 'only' : 'alongside' }
+            : {}),
         timeoutMs: waitMs,
         scanTimeoutMs: scanMs,
     }, waitMs + scanMs);
-    // The daemon hands back bytes, not a path. It may have been started hours
-    // ago from another directory; only this process knows what a relative
-    // `--out` means.
-    const target = resolveOutputPath(options.out, answer.fileName, options.cwd);
-    writeScanFile(target, answer.bytesBase64);
-    return {
-        path: target,
-        width: answer.width,
-        height: answer.height,
-        mode: answer.mode,
-        selectableText: answer.mode === 'vector' && (options.format ?? 'pdf') === 'pdf',
-        truncated: answer.truncated,
-        browserId: answer.browserId,
-        fileName: answer.fileName,
-    };
 }
 /** Everything `page-scanner status` reports, without starting a daemon. */
 export async function status() {

package/dist/api.js.map

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

package/dist/batch.d.ts

@@ -0,0 +1,60 @@
+/**
+ * Scanning a list of addresses in one go (#59), and naming what that writes.
+ *
+ * A batch is the single scan run once per address, in order, by the client:
+ * nothing about it crosses the bridge, so the extension and the wire contract
+ * are the same for one page or a hundred. One at a time on purpose. Each scan
+ * opens a tab and lays the page out at its full height, and several of those
+ * at once in the user's own Chrome is a machine that stops responding.
+ *
+ * Every file lands where the caller said, on their own disk. There is no
+ * record of what was captured anywhere else, which is what keeps this from
+ * becoming the capture history the product deliberately does not have.
+ */
+import { PageScannerError } from './errors.js';
+/** More than a morning's reading list; a longer one is split across runs. */
+export declare const MAX_BATCH_URLS = 1000;
+/** The placeholders a name template may use. */
+export declare const NAME_FIELDS: readonly ["n", "host", "name", "date", "time", "ext"];
+export type NameField = (typeof NAME_FIELDS)[number];
+/**
+ * An address list as a file holds it: one to a line, blank lines and lines
+ * starting with `#` ignored, surrounding space trimmed.
+ */
+export declare function readUrlList(text: string): string[];
+/** Refuses a template that names a field there is no value for, before any page is scanned. */
+export declare function checkNameTemplate(template: string): void;
+export interface NameContext {
+    /** 1-based position in the list. */
+    index: number;
+    /** How many addresses the list has, which sets how wide {n} is. */
+    count: number;
+    url: string;
+    /** The name the browser suggested, e.g. `example-com-docs-20260923-1102.pdf`. */
+    suggested: string;
+    /** When the batch started, so every file of one run shares its date and time. */
+    startedAt: Date;
+}
+/**
+ * A template filled in for one page: `{n}` its place in the list, padded to
+ * the list's length, `{host}` the address's host with dots as hyphens,
+ * `{name}` the browser's suggested name without its extension, `{date}` and
+ * `{time}` when the batch started (local, `YYYYMMDD` and `HHMM`), `{ext}` the
+ * format's extension. A template without `{ext}` gets it on the end. A `/`
+ * makes a subdirectory of the output directory.
+ */
+export declare function fillNameTemplate(template: string, context: NameContext): string;
+/**
+ * The name again with `-2`, `-3` before its extension until it is one this
+ * batch has not written, so two pages that suggest the same name (the same
+ * site in the same minute) do not overwrite each other. Compared without
+ * regard to case, as macOS and Windows compare file names.
+ */
+export declare function uniqueName(name: string, taken: Set<string>): string;
+/**
+ * Whether a failure ends the whole batch rather than just its page: nothing
+ * paired, no browser to scan with, no daemon. Every later page would fail the
+ * same way, each after its own wait.
+ */
+export declare function endsTheBatch(error: PageScannerError): boolean;
+//# sourceMappingURL=batch.d.ts.map

package/dist/batch.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"batch.d.ts","sourceRoot":"","sources":["../src/batch.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AACH,OAAO,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAC;AAE/C,6EAA6E;AAC7E,eAAO,MAAM,cAAc,OAAO,CAAC;AAEnC,gDAAgD;AAChD,eAAO,MAAM,WAAW,uDAAwD,CAAC;AACjF,MAAM,MAAM,SAAS,GAAG,CAAC,OAAO,WAAW,CAAC,CAAC,MAAM,CAAC,CAAC;AAIrD;;;GAGG;AACH,wBAAgB,WAAW,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,EAAE,CAKlD;AAED,+FAA+F;AAC/F,wBAAgB,iBAAiB,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI,CAmBxD;AAED,MAAM,WAAW,WAAW;IAC1B,oCAAoC;IACpC,KAAK,EAAE,MAAM,CAAC;IACd,mEAAmE;IACnE,KAAK,EAAE,MAAM,CAAC;IACd,GAAG,EAAE,MAAM,CAAC;IACZ,iFAAiF;IACjF,SAAS,EAAE,MAAM,CAAC;IAClB,iFAAiF;IACjF,SAAS,EAAE,IAAI,CAAC;CACjB;AAkBD;;;;;;;GAOG;AACH,wBAAgB,gBAAgB,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,WAAW,GAAG,MAAM,CAqB/E;AAED;;;;;GAKG;AACH,wBAAgB,UAAU,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,GAAG,CAAC,MAAM,CAAC,GAAG,MAAM,CAUnE;AAED;;;;GAIG;AACH,wBAAgB,YAAY,CAAC,KAAK,EAAE,gBAAgB,GAAG,OAAO,CAS7D"}

package/dist/batch.js

@@ -0,0 +1,116 @@
+/**
+ * Scanning a list of addresses in one go (#59), and naming what that writes.
+ *
+ * A batch is the single scan run once per address, in order, by the client:
+ * nothing about it crosses the bridge, so the extension and the wire contract
+ * are the same for one page or a hundred. One at a time on purpose. Each scan
+ * opens a tab and lays the page out at its full height, and several of those
+ * at once in the user's own Chrome is a machine that stops responding.
+ *
+ * Every file lands where the caller said, on their own disk. There is no
+ * record of what was captured anywhere else, which is what keeps this from
+ * becoming the capture history the product deliberately does not have.
+ */
+import { PageScannerError } from './errors.js';
+/** More than a morning's reading list; a longer one is split across runs. */
+export const MAX_BATCH_URLS = 1000;
+/** The placeholders a name template may use. */
+export const NAME_FIELDS = ['n', 'host', 'name', 'date', 'time', 'ext'];
+const PLACEHOLDER = /\{([^{}]*)\}/g;
+/**
+ * An address list as a file holds it: one to a line, blank lines and lines
+ * starting with `#` ignored, surrounding space trimmed.
+ */
+export function readUrlList(text) {
+    return text
+        .split(/\r?\n/)
+        .map((line) => line.trim())
+        .filter((line) => line !== '' && !line.startsWith('#'));
+}
+/** Refuses a template that names a field there is no value for, before any page is scanned. */
+export function checkNameTemplate(template) {
+    if (template.trim() === '') {
+        throw new PageScannerError('BAD_REQUEST', '--name needs a value.');
+    }
+    for (const [, field] of template.matchAll(PLACEHOLDER)) {
+        if (!NAME_FIELDS.some((known) => known === field)) {
+            throw new PageScannerError('BAD_REQUEST', `--name has an unknown placeholder {${field}}.`, `The placeholders are ${NAME_FIELDS.map((known) => `{${known}}`).join(', ')}.`);
+        }
+    }
+    if (template.split(/[\\/]/).some((segment) => segment === '..')) {
+        throw new PageScannerError('BAD_REQUEST', '--name may not climb out of the output directory with "..".');
+    }
+}
+/** Windows refuses these in a file name, and a control character is trouble anywhere. */
+// eslint-disable-next-line no-control-regex
+const UNSAFE = /[<>:"|?*\u0000-\u001f]/g;
+function pad(value, width) {
+    return String(value).padStart(width, '0');
+}
+function hostOf(url) {
+    try {
+        return new URL(url).hostname.replace(/^www\./, '').replace(/\./g, '-') || 'page';
+    }
+    catch {
+        return 'page';
+    }
+}
+/**
+ * A template filled in for one page: `{n}` its place in the list, padded to
+ * the list's length, `{host}` the address's host with dots as hyphens,
+ * `{name}` the browser's suggested name without its extension, `{date}` and
+ * `{time}` when the batch started (local, `YYYYMMDD` and `HHMM`), `{ext}` the
+ * format's extension. A template without `{ext}` gets it on the end. A `/`
+ * makes a subdirectory of the output directory.
+ */
+export function fillNameTemplate(template, context) {
+    const dot = context.suggested.lastIndexOf('.');
+    const ext = dot > 0 ? context.suggested.slice(dot + 1) : '';
+    const at = context.startedAt;
+    const values = {
+        n: pad(context.index, String(context.count).length),
+        host: hostOf(context.url),
+        name: dot > 0 ? context.suggested.slice(0, dot) : context.suggested,
+        date: `${at.getFullYear()}${pad(at.getMonth() + 1, 2)}${pad(at.getDate(), 2)}`,
+        time: `${pad(at.getHours(), 2)}${pad(at.getMinutes(), 2)}`,
+        ext,
+    };
+    const filled = template.replace(PLACEHOLDER, (_, field) => values[field].replace(/[\\/]/g, '-'));
+    const named = template.includes('{ext}') || !ext ? filled : `${filled}.${ext}`;
+    return named
+        .split(/[\\/]/)
+        .map((segment) => segment.replace(UNSAFE, '-').trim())
+        .filter((segment) => segment !== '' && segment !== '.' && segment !== '..')
+        .join('/');
+}
+/**
+ * The name again with `-2`, `-3` before its extension until it is one this
+ * batch has not written, so two pages that suggest the same name (the same
+ * site in the same minute) do not overwrite each other. Compared without
+ * regard to case, as macOS and Windows compare file names.
+ */
+export function uniqueName(name, taken) {
+    const dot = name.lastIndexOf('.');
+    const slash = name.lastIndexOf('/');
+    const cut = dot > slash + 1 ? dot : name.length;
+    let candidate = name;
+    for (let copy = 2; taken.has(candidate.toLowerCase()); copy++) {
+        candidate = `${name.slice(0, cut)}-${copy}${name.slice(cut)}`;
+    }
+    taken.add(candidate.toLowerCase());
+    return candidate;
+}
+/**
+ * Whether a failure ends the whole batch rather than just its page: nothing
+ * paired, no browser to scan with, no daemon. Every later page would fail the
+ * same way, each after its own wait.
+ */
+export function endsTheBatch(error) {
+    return (error.code === 'NOT_PAIRED' ||
+        error.code === 'NO_BROWSER' ||
+        error.code === 'AMBIGUOUS_BROWSER' ||
+        error.code === 'UNKNOWN_BROWSER' ||
+        error.code === 'DAEMON_FAILED' ||
+        error.code === 'PORT_IN_USE');
+}
+//# sourceMappingURL=batch.js.map