versioncam 0.1.1

package/dist/cli/commands/doctor.js

@@ -0,0 +1,130 @@
+import { chromium } from "playwright";
+import { existsSync } from "node:fs";
+import { ffmpegStatus } from "../../render/ffmpeg.js";
+import { ensureApp, probe } from "../../app-server.js";
+import { NO_CONFIG, findConfigFile, loadConfig } from "../../loader.js";
+const NOT_SERVING = "Start the app, point `baseUrl` at where it is served, or add `webServer` to the config.";
+/**
+ * Is the app the config points at serving — and if not, can it be started?
+ *
+ * Not a property of the machine, unlike every other check here, but it is the
+ * next thing that stops a recording and the cheapest one to find out about.
+ * An authoring loop asks this before it writes a clip; without it the first
+ * sign of a stopped dev server is a clip failing on a locator.
+ *
+ * With a `webServer`, this is also the rehearsal for every other command: it
+ * starts the app exactly the way `record` would, reports how long that took,
+ * and stops it again, so a repository finds out its start command is wrong
+ * here rather than halfway into a clip. Without one, any HTTP answer at all
+ * counts as up, including a 401 or a redirect — an app behind a sign-in
+ * answers that way and records perfectly well.
+ */
+async function appCheck(cwd) {
+    let config;
+    try {
+        config = await loadConfig(cwd);
+    }
+    catch (error) {
+        return {
+            name: "app",
+            ok: false,
+            detail: `config did not load: ${error.message}`,
+            fix: "Fix versioncam.config.ts; every other command loads it too.",
+        };
+    }
+    if (!config.webServer) {
+        const answer = await probe(config.baseUrl);
+        return answer.up
+            ? {
+                name: "app",
+                ok: true,
+                detail: `already serving at ${config.baseUrl} — HTTP ${answer.status}`,
+            }
+            : {
+                name: "app",
+                ok: false,
+                detail: `${config.baseUrl} — ${answer.reason}`,
+                fix: NOT_SERVING,
+            };
+    }
+    try {
+        const app = await ensureApp(config);
+        await app.stop();
+        return {
+            name: "app",
+            ok: true,
+            detail: app.started ? `${app.detail} (stopped again)` : app.detail,
+        };
+    }
+    catch (error) {
+        // The first line says what went wrong; the rest is the server's own
+        // output, which is usually where the reason is.
+        const [first, ...rest] = error.message.split("\n");
+        return { name: "app", ok: false, detail: first, fix: rest.join("\n") };
+    }
+}
+/**
+ * Can this machine record and encode?
+ *
+ * Reports every check rather than stopping at the first failure, because the
+ * usual case on a new machine is that two or three things are missing at once
+ * and being told about them one run at a time is tedious.
+ */
+export async function doctor() {
+    const checks = [];
+    const major = Number(process.versions.node.split(".")[0]);
+    checks.push({
+        name: "node",
+        ok: major >= 22,
+        detail: `v${process.versions.node}`,
+        fix: "Install Node 22 or newer.",
+    });
+    let chromiumPath = "";
+    try {
+        chromiumPath = chromium.executablePath();
+    }
+    catch {
+        chromiumPath = "";
+    }
+    checks.push({
+        name: "chromium",
+        ok: chromiumPath !== "" && existsSync(chromiumPath),
+        detail: chromiumPath || "not installed",
+        fix: "npx versioncam install",
+    });
+    const { ffmpeg, ffprobe } = ffmpegStatus();
+    checks.push({
+        name: "ffmpeg",
+        ok: ffmpeg !== null,
+        detail: ffmpeg ?? "not found",
+        fix: "brew install ffmpeg  (or apt install ffmpeg)",
+    });
+    checks.push({
+        name: "ffprobe",
+        ok: ffprobe !== null,
+        detail: ffprobe ?? "not found",
+        fix: "Installs with ffmpeg; ffmpeg-static does not include it.",
+    });
+    const config = findConfigFile(process.cwd());
+    checks.push({
+        name: "config",
+        ok: config !== null,
+        detail: config ?? `no versioncam.config.ts in ${process.cwd()}`,
+        fix: NO_CONFIG,
+    });
+    // Only with a config: without one there is no `baseUrl` to try, and saying
+    // so twice would be noise.
+    if (config !== null)
+        checks.push(await appCheck(process.cwd()));
+    for (const check of checks) {
+        process.stdout.write(`${check.ok ? "✓" : "✗"} ${check.name.padEnd(9)} ${check.detail}\n`);
+        if (!check.ok && check.fix) {
+            for (const line of check.fix.split("\n")) {
+                process.stdout.write(`            ${line}\n`);
+            }
+        }
+    }
+    const failed = checks.filter((c) => !c.ok);
+    return failed.length === 0 ? 0 : 1;
+}
+//# sourceMappingURL=doctor.js.map

package/dist/cli/commands/doctor.js.map

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

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

@@ -0,0 +1,16 @@
+/**
+ * Where `dsl.md` sits relative to this module.
+ *
+ * Three levels up from `cli/commands/` reaches the package root from both
+ * `src` and `dist`, which are the same depth — so the built CLI and a test
+ * importing the source find the same file.
+ */
+export declare const DSL_FILE: string;
+/**
+ * Print the DSL reference.
+ *
+ * It exists as a command because the thing that needs it most has no way to
+ * browse a repository: an agent writing a clip asks the tool what the tool can
+ * do. A test holds the file and the class to the same list.
+ */
+export declare function dsl(): Promise<number>;

package/dist/cli/commands/dsl.js

@@ -0,0 +1,22 @@
+import { readFileSync } from "node:fs";
+import { fileURLToPath } from "node:url";
+/**
+ * Where `dsl.md` sits relative to this module.
+ *
+ * Three levels up from `cli/commands/` reaches the package root from both
+ * `src` and `dist`, which are the same depth — so the built CLI and a test
+ * importing the source find the same file.
+ */
+export const DSL_FILE = fileURLToPath(new URL("../../../dsl.md", import.meta.url));
+/**
+ * Print the DSL reference.
+ *
+ * It exists as a command because the thing that needs it most has no way to
+ * browse a repository: an agent writing a clip asks the tool what the tool can
+ * do. A test holds the file and the class to the same list.
+ */
+export async function dsl() {
+    process.stdout.write(readFileSync(DSL_FILE, "utf8"));
+    return 0;
+}
+//# sourceMappingURL=dsl.js.map

package/dist/cli/commands/dsl.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"dsl.js","sourceRoot":"","sources":["../../../src/cli/commands/dsl.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AACvC,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AAEzC;;;;;;GAMG;AACH,MAAM,CAAC,MAAM,QAAQ,GAAG,aAAa,CACnC,IAAI,GAAG,CAAC,iBAAiB,EAAE,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAC5C,CAAC;AAEF;;;;;;GAMG;AACH,MAAM,CAAC,KAAK,UAAU,GAAG;IACvB,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,YAAY,CAAC,QAAQ,EAAE,MAAM,CAAC,CAAC,CAAC;IACrD,OAAO,CAAC,CAAC;AACX,CAAC"}

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

@@ -0,0 +1,8 @@
+/**
+ * One frame of a recording, at the size it will be published.
+ *
+ * The command a reviewer reaches for when a contact sheet's tile is too small
+ * to be sure — is that caption legible, is that control inside the camera —
+ * and the answer has to be the real frame rather than a scaled-down one.
+ */
+export declare function frame(argv: string[]): Promise<number>;

package/dist/cli/commands/frame.js

@@ -0,0 +1,72 @@
+import { parseArgs } from "node:util";
+import { existsSync, mkdirSync, writeFileSync } from "node:fs";
+import { join } from "node:path";
+import { launchBrowser } from "../../driver/launch.js";
+import { loadConfig } from "../../loader.js";
+import { readTimeline, renderFrame } from "../../render/render.js";
+import { frameAtMark } from "../../render/sampling.js";
+/**
+ * One frame of a recording, at the size it will be published.
+ *
+ * The command a reviewer reaches for when a contact sheet's tile is too small
+ * to be sure — is that caption legible, is that control inside the camera —
+ * and the answer has to be the real frame rather than a scaled-down one.
+ */
+export async function frame(argv) {
+    const { positionals, values } = parseArgs({
+        args: argv,
+        options: { t: { type: "string" }, at: { type: "string" } },
+        strict: false,
+        allowPositionals: true,
+    });
+    const [id, nth] = positionals;
+    const byTime = values.t;
+    const byBeat = values.at;
+    if (!id ||
+        (nth === undefined && byTime === undefined && byBeat === undefined)) {
+        process.stderr.write("Usage: versioncam frame <id> <n>  (or --t <seconds>, or --at <beat label>)\n");
+        return 1;
+    }
+    const config = await loadConfig(process.cwd());
+    const dir = join(config.recordingsDir, id);
+    if (!existsSync(join(dir, "timeline.json"))) {
+        process.stderr.write(`No recording for "${id}". Run \`versioncam record ${id}\` first.\n`);
+        return 1;
+    }
+    // Seconds and beats are converted here rather than in the renderer: the
+    // frame rate and the marks are the recording's, and the printed file name
+    // should say which frame the time or the beat turned out to be.
+    const timeline = await readTimeline(config, id);
+    let wanted;
+    if (byBeat !== undefined) {
+        const beat = frameAtMark(timeline, byBeat, config.motion.crossfadeFrames);
+        if ("error" in beat) {
+            process.stderr.write(`${beat.error}\n`);
+            return 1;
+        }
+        wanted = beat.frame;
+    }
+    else {
+        wanted =
+            byTime !== undefined
+                ? Math.round(Number(byTime) * timeline.fps)
+                : Number(nth);
+    }
+    if (!Number.isFinite(wanted)) {
+        process.stderr.write(`Not a frame: ${byTime ?? nth}\n`);
+        return 1;
+    }
+    const browser = await launchBrowser();
+    try {
+        const png = await renderFrame(browser, config, { kind: "recording", id, dir }, wanted);
+        mkdirSync(config.outputDir, { recursive: true });
+        const file = join(config.outputDir, `${id}-frame-${wanted}.png`);
+        writeFileSync(file, png);
+        process.stdout.write(`${file}\n`);
+        return 0;
+    }
+    finally {
+        await browser.close();
+    }
+}
+//# sourceMappingURL=frame.js.map

package/dist/cli/commands/frame.js.map

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

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

@@ -0,0 +1,23 @@
+/**
+ * Install the skill, and nothing else.
+ *
+ * The skill is the whole product surface for an agent: one directory — the
+ * orchestration, the authoring brief, the first-run brief — and the reviewer's
+ * file. No config stub, because the first run writes the real one from the
+ * repository, and a stub is a config somebody has to finish by hand.
+ *
+ * By default into `.claude/`, where Claude Code finds both: the skill under
+ * `skills/versioncam/`, the reviewer under `agents/`, where it registers as an
+ * agent whose tools are limited to looking. `--into <dir>` is for a host that
+ * reads skills from elsewhere — which path that is gets checked against the
+ * host's own documentation by whoever needs it, not guessed here — and there
+ * the reviewer goes inside the skill's directory, where the skill looks for it
+ * on a host that cannot register agents.
+ *
+ * It refuses to overwrite rather than merging, and it refuses *everything* if
+ * any one destination exists. A half-installed set is the bad outcome: a new
+ * skill beside an old reviewer file fails in the middle of a round instead of
+ * at the copy. And the prompts are the part of this package people most want
+ * to edit, so a second `init` must never silently discard their edits.
+ */
+export declare function init(argv: string[]): Promise<number>;

package/dist/cli/commands/init.js

@@ -0,0 +1,109 @@
+import { parseArgs } from "node:util";
+import { existsSync } from "node:fs";
+import { copyFile, mkdir, readdir } from "node:fs/promises";
+import { dirname, join, relative, resolve } from "node:path";
+import { fileURLToPath } from "node:url";
+/**
+ * The plugin directory inside this package, as installed.
+ *
+ * `dist/cli/commands/init.js` sits three levels under the package root, and
+ * `plugin/` is shipped beside `dist/` by the `files` list in package.json.
+ */
+const PLUGIN_DIR = resolve(dirname(fileURLToPath(import.meta.url)), "..", "..", "..", "plugin");
+/** What `init --claude` wrote before the package was published, which the new skill replaces. */
+const OLD_INSTALL = [
+    join(".claude", "skills", "demos-author"),
+    join(".claude", "agents", "demo-author.md"),
+    join(".claude", "agents", "demo-reviewer.md"),
+];
+/** Every file under `dir`, as paths relative to it. */
+async function filesUnder(dir) {
+    const entries = await readdir(dir, { recursive: true, withFileTypes: true });
+    return entries
+        .filter((e) => e.isFile())
+        .map((e) => relative(dir, join(e.parentPath, e.name)))
+        .sort();
+}
+/**
+ * Install the skill, and nothing else.
+ *
+ * The skill is the whole product surface for an agent: one directory — the
+ * orchestration, the authoring brief, the first-run brief — and the reviewer's
+ * file. No config stub, because the first run writes the real one from the
+ * repository, and a stub is a config somebody has to finish by hand.
+ *
+ * By default into `.claude/`, where Claude Code finds both: the skill under
+ * `skills/versioncam/`, the reviewer under `agents/`, where it registers as an
+ * agent whose tools are limited to looking. `--into <dir>` is for a host that
+ * reads skills from elsewhere — which path that is gets checked against the
+ * host's own documentation by whoever needs it, not guessed here — and there
+ * the reviewer goes inside the skill's directory, where the skill looks for it
+ * on a host that cannot register agents.
+ *
+ * It refuses to overwrite rather than merging, and it refuses *everything* if
+ * any one destination exists. A half-installed set is the bad outcome: a new
+ * skill beside an old reviewer file fails in the middle of a round instead of
+ * at the copy. And the prompts are the part of this package people most want
+ * to edit, so a second `init` must never silently discard their edits.
+ */
+export async function init(argv) {
+    const { values } = parseArgs({
+        args: argv,
+        options: {
+            force: { type: "boolean", default: false },
+            into: { type: "string" },
+            claude: { type: "boolean", default: false },
+        },
+        strict: false,
+        allowPositionals: true,
+    });
+    if (values.claude === true) {
+        process.stderr.write("`--claude` is gone: `versioncam init` installs into .claude/ by default, and `--into <dir>` puts the skill somewhere else.\n");
+        return 1;
+    }
+    const skillDir = join(PLUGIN_DIR, "skills", "versioncam");
+    const reviewer = join(PLUGIN_DIR, "agents", "versioncam-reviewer.md");
+    if (!existsSync(skillDir) || !existsSync(reviewer)) {
+        process.stderr.write(`No skill at ${skillDir}.\n` +
+            "Reinstall versioncam, or run this from an installed copy.\n");
+        return 1;
+    }
+    const cwd = process.cwd();
+    const into = values.into;
+    const skillTarget = into
+        ? resolve(cwd, into, "versioncam")
+        : join(cwd, ".claude", "skills", "versioncam");
+    const reviewerTarget = into
+        ? join(skillTarget, "versioncam-reviewer.md")
+        : join(cwd, ".claude", "agents", "versioncam-reviewer.md");
+    const copies = (await filesUnder(skillDir)).map((file) => ({
+        from: join(skillDir, file),
+        to: join(skillTarget, file),
+    }));
+    copies.push({ from: reviewer, to: reviewerTarget });
+    const existing = copies.filter((c) => existsSync(c.to));
+    if (existing.length > 0 && values.force !== true) {
+        process.stderr.write(`Already there:\n` +
+            existing.map((c) => `  ${relative(cwd, c.to)}\n`).join("") +
+            "Nothing was copied. Pass --force to overwrite.\n");
+        return 1;
+    }
+    for (const { from, to } of copies) {
+        await mkdir(dirname(to), { recursive: true });
+        await copyFile(from, to);
+        process.stdout.write(`${relative(cwd, to)}\n`);
+    }
+    if (into) {
+        process.stdout.write(`\nThe reviewer is ${relative(cwd, reviewerTarget)}. A host that can register agents should register it as versioncam-reviewer; one that cannot, the skill reads it from there.\n`);
+    }
+    // Two skills answering the same request is worse than either alone.
+    const old = OLD_INSTALL.filter((path) => existsSync(join(cwd, path)));
+    if (old.length > 0) {
+        process.stdout.write(`\nAn older install is still here, and replaced by this one — remove it:\n` +
+            old.map((path) => `  ${path}\n`).join(""));
+    }
+    process.stdout.write(`\nInstalled. Ask your agent: /versioncam "<what the clip should show>"\n` +
+        "The first run sets this repository up. Documentation: https://version.cam\n");
+    return 0;
+}
+//# sourceMappingURL=init.js.map

package/dist/cli/commands/init.js.map

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

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

@@ -0,0 +1 @@
+export declare function inspect(argv: string[]): Promise<number>;

package/dist/cli/commands/inspect.js

@@ -0,0 +1,32 @@
+import { parseArgs } from "node:util";
+import { launchBrowser } from "../../driver/launch.js";
+import { loadConfig } from "../../loader.js";
+import { formatInventory, inspectPage } from "../../inspect/inspect.js";
+import { drivingApp } from "../app.js";
+import { openAppPage } from "./open-app.js";
+export async function inspect(argv) {
+    const { positionals, values } = parseArgs({
+        args: argv,
+        options: { json: { type: "boolean" } },
+        strict: false,
+        allowPositionals: true,
+    });
+    const config = await loadConfig(process.cwd());
+    const path = positionals[0] ?? "/";
+    return drivingApp(config, async () => {
+        const browser = await launchBrowser();
+        try {
+            const { page, context } = await openAppPage(browser, config, path);
+            const inventory = await inspectPage(page);
+            process.stdout.write(values.json
+                ? `${JSON.stringify(inventory, null, 2)}\n`
+                : `${formatInventory(inventory)}\n`);
+            await context.close();
+            return 0;
+        }
+        finally {
+            await browser.close();
+        }
+    });
+}
+//# sourceMappingURL=inspect.js.map

package/dist/cli/commands/inspect.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"inspect.js","sourceRoot":"","sources":["../../../src/cli/commands/inspect.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,WAAW,CAAC;AACtC,OAAO,EAAE,aAAa,EAAE,MAAM,wBAAwB,CAAC;AACvD,OAAO,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAC7C,OAAO,EAAE,eAAe,EAAE,WAAW,EAAE,MAAM,0BAA0B,CAAC;AACxE,OAAO,EAAE,UAAU,EAAE,MAAM,WAAW,CAAC;AACvC,OAAO,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAE5C,MAAM,CAAC,KAAK,UAAU,OAAO,CAAC,IAAc;IAC1C,MAAM,EAAE,WAAW,EAAE,MAAM,EAAE,GAAG,SAAS,CAAC;QACxC,IAAI,EAAE,IAAI;QACV,OAAO,EAAE,EAAE,IAAI,EAAE,EAAE,IAAI,EAAE,SAAS,EAAE,EAAE;QACtC,MAAM,EAAE,KAAK;QACb,gBAAgB,EAAE,IAAI;KACvB,CAAC,CAAC;IAEH,MAAM,MAAM,GAAG,MAAM,UAAU,CAAC,OAAO,CAAC,GAAG,EAAE,CAAC,CAAC;IAC/C,MAAM,IAAI,GAAI,WAAW,CAAC,CAAC,CAAwB,IAAI,GAAG,CAAC;IAE3D,OAAO,UAAU,CAAC,MAAM,EAAE,KAAK,IAAI,EAAE;QACnC,MAAM,OAAO,GAAG,MAAM,aAAa,EAAE,CAAC;QACtC,IAAI,CAAC;YACH,MAAM,EAAE,IAAI,EAAE,OAAO,EAAE,GAAG,MAAM,WAAW,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,CAAC;YACnE,MAAM,SAAS,GAAG,MAAM,WAAW,CAAC,IAAI,CAAC,CAAC;YAC1C,OAAO,CAAC,MAAM,CAAC,KAAK,CAClB,MAAM,CAAC,IAAI;gBACT,CAAC,CAAC,GAAG,IAAI,CAAC,SAAS,CAAC,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC,IAAI;gBAC3C,CAAC,CAAC,GAAG,eAAe,CAAC,SAAS,CAAC,IAAI,CACtC,CAAC;YACF,MAAM,OAAO,CAAC,KAAK,EAAE,CAAC;YACtB,OAAO,CAAC,CAAC;QACX,CAAC;gBAAS,CAAC;YACT,MAAM,OAAO,CAAC,KAAK,EAAE,CAAC;QACxB,CAAC;IACH,CAAC,CAAC,CAAC;AACL,CAAC"}

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

@@ -0,0 +1,33 @@
+/**
+ * The Playwright this package drives: its version, and the CLI that ships
+ * with it.
+ *
+ * Resolved from versioncam's own dependency rather than the app's, because
+ * they need not agree. Playwright is pinned exactly here — a new Chromium
+ * changes every captured pixel, so an upgrade is an event with a changelog
+ * entry, never a range — while the app may have a Playwright of its own for
+ * its tests, at any version. `npx playwright install` resolves the app's and
+ * installs the Chromium *it* expects, which is how a machine ends up with a
+ * browser and `doctor` still saying there is none.
+ */
+export declare function pinnedPlaywright(): {
+    version: string;
+    cli: string;
+};
+/**
+ * The command `versioncam install` runs, as argv.
+ *
+ * Both Chromium builds, deliberately: recording is headless and uses the
+ * headless shell, while `login` and `preview` open a window a person uses
+ * and need the full browser.
+ */
+export declare function installArgv(node: string, cli: string, withDeps: boolean): string[];
+/**
+ * Install the Chromium this version of versioncam records with.
+ *
+ * `--with-deps` adds the system libraries Chromium needs on a bare Linux
+ * image, which is the usual state of a CI runner and asks for root there.
+ * The command it runs is printed first: in a CI log, which Playwright
+ * installed which browser is the first question when something differs.
+ */
+export declare function install(argv: string[]): Promise<number>;

package/dist/cli/commands/install.js

@@ -0,0 +1,66 @@
+import { spawn } from "node:child_process";
+import { createRequire } from "node:module";
+import { dirname, join } from "node:path";
+import { parseArgs } from "node:util";
+/**
+ * The Playwright this package drives: its version, and the CLI that ships
+ * with it.
+ *
+ * Resolved from versioncam's own dependency rather than the app's, because
+ * they need not agree. Playwright is pinned exactly here — a new Chromium
+ * changes every captured pixel, so an upgrade is an event with a changelog
+ * entry, never a range — while the app may have a Playwright of its own for
+ * its tests, at any version. `npx playwright install` resolves the app's and
+ * installs the Chromium *it* expects, which is how a machine ends up with a
+ * browser and `doctor` still saying there is none.
+ */
+export function pinnedPlaywright() {
+    const require = createRequire(import.meta.url);
+    const manifest = require.resolve("playwright/package.json");
+    const { version } = require(manifest);
+    return { version, cli: join(dirname(manifest), "cli.js") };
+}
+/**
+ * The command `versioncam install` runs, as argv.
+ *
+ * Both Chromium builds, deliberately: recording is headless and uses the
+ * headless shell, while `login` and `preview` open a window a person uses
+ * and need the full browser.
+ */
+export function installArgv(node, cli, withDeps) {
+    return [
+        node,
+        cli,
+        "install",
+        ...(withDeps ? ["--with-deps"] : []),
+        "chromium",
+    ];
+}
+/**
+ * Install the Chromium this version of versioncam records with.
+ *
+ * `--with-deps` adds the system libraries Chromium needs on a bare Linux
+ * image, which is the usual state of a CI runner and asks for root there.
+ * The command it runs is printed first: in a CI log, which Playwright
+ * installed which browser is the first question when something differs.
+ */
+export async function install(argv) {
+    const { values } = parseArgs({
+        args: argv,
+        options: { "with-deps": { type: "boolean" } },
+        strict: false,
+    });
+    const playwright = pinnedPlaywright();
+    const [command, ...args] = installArgv(process.execPath, playwright.cli, values["with-deps"] === true);
+    process.stdout.write(`Chromium for Playwright ${playwright.version}, the version versioncam records with:\n` +
+        `  ${[command, ...args].join(" ")}\n`);
+    return new Promise((resolve) => {
+        const child = spawn(command, args, { stdio: "inherit" });
+        child.on("error", (error) => {
+            process.stderr.write(`Could not run the installer: ${error.message}\n`);
+            resolve(1);
+        });
+        child.on("exit", (code) => resolve(code ?? 1));
+    });
+}
+//# sourceMappingURL=install.js.map

package/dist/cli/commands/install.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"install.js","sourceRoot":"","sources":["../../../src/cli/commands/install.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,MAAM,oBAAoB,CAAC;AAC3C,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAC5C,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAC1C,OAAO,EAAE,SAAS,EAAE,MAAM,WAAW,CAAC;AAEtC;;;;;;;;;;;GAWG;AACH,MAAM,UAAU,gBAAgB;IAC9B,MAAM,OAAO,GAAG,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;IAC/C,MAAM,QAAQ,GAAG,OAAO,CAAC,OAAO,CAAC,yBAAyB,CAAC,CAAC;IAC5D,MAAM,EAAE,OAAO,EAAE,GAAG,OAAO,CAAC,QAAQ,CAAwB,CAAC;IAC7D,OAAO,EAAE,OAAO,EAAE,GAAG,EAAE,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,EAAE,QAAQ,CAAC,EAAE,CAAC;AAC7D,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,WAAW,CACzB,IAAY,EACZ,GAAW,EACX,QAAiB;IAEjB,OAAO;QACL,IAAI;QACJ,GAAG;QACH,SAAS;QACT,GAAG,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,aAAa,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;QACpC,UAAU;KACX,CAAC;AACJ,CAAC;AAED;;;;;;;GAOG;AACH,MAAM,CAAC,KAAK,UAAU,OAAO,CAAC,IAAc;IAC1C,MAAM,EAAE,MAAM,EAAE,GAAG,SAAS,CAAC;QAC3B,IAAI,EAAE,IAAI;QACV,OAAO,EAAE,EAAE,WAAW,EAAE,EAAE,IAAI,EAAE,SAAS,EAAE,EAAE;QAC7C,MAAM,EAAE,KAAK;KACd,CAAC,CAAC;IACH,MAAM,UAAU,GAAG,gBAAgB,EAAE,CAAC;IACtC,MAAM,CAAC,OAAO,EAAE,GAAG,IAAI,CAAC,GAAG,WAAW,CACpC,OAAO,CAAC,QAAQ,EAChB,UAAU,CAAC,GAAG,EACd,MAAM,CAAC,WAAW,CAAC,KAAK,IAAI,CAC7B,CAAC;IACF,OAAO,CAAC,MAAM,CAAC,KAAK,CAClB,2BAA2B,UAAU,CAAC,OAAO,0CAA0C;QACrF,KAAK,CAAC,OAAO,EAAE,GAAG,IAAI,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,IAAI,CACxC,CAAC;IACF,OAAO,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,EAAE;QAC7B,MAAM,KAAK,GAAG,KAAK,CAAC,OAAO,EAAE,IAAI,EAAE,EAAE,KAAK,EAAE,SAAS,EAAE,CAAC,CAAC;QACzD,KAAK,CAAC,EAAE,CAAC,OAAO,EAAE,CAAC,KAAK,EAAE,EAAE;YAC1B,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,gCAAgC,KAAK,CAAC,OAAO,IAAI,CAAC,CAAC;YACxE,OAAO,CAAC,CAAC,CAAC,CAAC;QACb,CAAC,CAAC,CAAC;QACH,KAAK,CAAC,EAAE,CAAC,MAAM,EAAE,CAAC,IAAI,EAAE,EAAE,CAAC,OAAO,CAAC,IAAI,IAAI,CAAC,CAAC,CAAC,CAAC;IACjD,CAAC,CAAC,CAAC;AACL,CAAC"}

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

@@ -0,0 +1,10 @@
+/**
+ * Sign in once, by hand, and keep the session.
+ *
+ * Every app authenticates differently, and scripting a sign-in means putting
+ * credentials somewhere a recorder can read them. A saved browser session
+ * avoids both: a person signs in the way they always do, and recordings reuse
+ * the result. It is still a credential — the config's path should be
+ * gitignored, and it is inside the recorder's own output directory by default.
+ */
+export declare function login(): Promise<number>;

package/dist/cli/commands/login.js

@@ -0,0 +1,49 @@
+import { launchBrowser } from "../../driver/launch.js";
+import { mkdir } from "node:fs/promises";
+import { dirname } from "node:path";
+import { loadConfig } from "../../loader.js";
+import { drivingApp } from "../app.js";
+/**
+ * Sign in once, by hand, and keep the session.
+ *
+ * Every app authenticates differently, and scripting a sign-in means putting
+ * credentials somewhere a recorder can read them. A saved browser session
+ * avoids both: a person signs in the way they always do, and recordings reuse
+ * the result. It is still a credential — the config's path should be
+ * gitignored, and it is inside the recorder's own output directory by default.
+ */
+export async function login() {
+    const config = await loadConfig(process.cwd());
+    const auth = config.auth;
+    if (!auth?.storageState) {
+        process.stderr.write('`versioncam login` needs `auth: { storageState: "..." }` in the config.\n' +
+            "An app that signs in with a `login` hook does not need this command.\n");
+        return 1;
+    }
+    const storageState = auth.storageState;
+    return drivingApp(config, async () => {
+        const browser = await launchBrowser({ headless: false });
+        try {
+            const context = await browser.newContext({ viewport: config.viewport });
+            const page = await context.newPage();
+            await page.goto(config.baseUrl);
+            process.stdout.write(`Sign in to ${config.baseUrl} in the window that opened.\n` +
+                "Press Enter here when you are done. ");
+            await new Promise((resolve) => {
+                process.stdin.resume();
+                process.stdin.once("data", () => {
+                    process.stdin.pause();
+                    resolve();
+                });
+            });
+            await mkdir(dirname(storageState), { recursive: true });
+            await context.storageState({ path: storageState });
+        }
+        finally {
+            await browser.close();
+        }
+        process.stdout.write(`\nSaved the session to ${storageState}\n`);
+        return 0;
+    });
+}
+//# sourceMappingURL=login.js.map

package/dist/cli/commands/login.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"login.js","sourceRoot":"","sources":["../../../src/cli/commands/login.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,wBAAwB,CAAC;AACvD,OAAO,EAAE,KAAK,EAAE,MAAM,kBAAkB,CAAC;AACzC,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACpC,OAAO,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAC7C,OAAO,EAAE,UAAU,EAAE,MAAM,WAAW,CAAC;AAEvC;;;;;;;;GAQG;AACH,MAAM,CAAC,KAAK,UAAU,KAAK;IACzB,MAAM,MAAM,GAAG,MAAM,UAAU,CAAC,OAAO,CAAC,GAAG,EAAE,CAAC,CAAC;IAC/C,MAAM,IAAI,GAAG,MAAM,CAAC,IAAI,CAAC;IAEzB,IAAI,CAAC,IAAI,EAAE,YAAY,EAAE,CAAC;QACxB,OAAO,CAAC,MAAM,CAAC,KAAK,CAClB,2EAA2E;YACzE,wEAAwE,CAC3E,CAAC;QACF,OAAO,CAAC,CAAC;IACX,CAAC;IAED,MAAM,YAAY,GAAG,IAAI,CAAC,YAAY,CAAC;IACvC,OAAO,UAAU,CAAC,MAAM,EAAE,KAAK,IAAI,EAAE;QACnC,MAAM,OAAO,GAAG,MAAM,aAAa,CAAC,EAAE,QAAQ,EAAE,KAAK,EAAE,CAAC,CAAC;QACzD,IAAI,CAAC;YACH,MAAM,OAAO,GAAG,MAAM,OAAO,CAAC,UAAU,CAAC,EAAE,QAAQ,EAAE,MAAM,CAAC,QAAQ,EAAE,CAAC,CAAC;YACxE,MAAM,IAAI,GAAG,MAAM,OAAO,CAAC,OAAO,EAAE,CAAC;YACrC,MAAM,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;YAEhC,OAAO,CAAC,MAAM,CAAC,KAAK,CAClB,cAAc,MAAM,CAAC,OAAO,+BAA+B;gBACzD,sCAAsC,CACzC,CAAC;YACF,MAAM,IAAI,OAAO,CAAO,CAAC,OAAO,EAAE,EAAE;gBAClC,OAAO,CAAC,KAAK,CAAC,MAAM,EAAE,CAAC;gBACvB,OAAO,CAAC,KAAK,CAAC,IAAI,CAAC,MAAM,EAAE,GAAG,EAAE;oBAC9B,OAAO,CAAC,KAAK,CAAC,KAAK,EAAE,CAAC;oBACtB,OAAO,EAAE,CAAC;gBACZ,CAAC,CAAC,CAAC;YACL,CAAC,CAAC,CAAC;YAEH,MAAM,KAAK,CAAC,OAAO,CAAC,YAAY,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;YACxD,MAAM,OAAO,CAAC,YAAY,CAAC,EAAE,IAAI,EAAE,YAAY,EAAE,CAAC,CAAC;QACrD,CAAC;gBAAS,CAAC;YACT,MAAM,OAAO,CAAC,KAAK,EAAE,CAAC;QACxB,CAAC;QAED,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,0BAA0B,YAAY,IAAI,CAAC,CAAC;QACjE,OAAO,CAAC,CAAC;IACX,CAAC,CAAC,CAAC;AACL,CAAC"}

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

@@ -0,0 +1 @@
+export declare function measure(argv: string[]): Promise<number>;