document360-capture 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Saravana Kumar
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,80 @@
+# document360-capture
+
+CLI that captures product screenshots from Playwright specs. Login once, capture many. Companion to [document360-writer](../writer/).
+
+## Why
+
+Doc-screenshot pipelines hit two walls in practice:
+
+1. **MFA + per-run login.** Spinning up Chromium for every capture and asking the human to log in each time burns time and rules out repeatable runs.
+2. **Annotation by hand.** Adding arrows, numbered callouts, and redactions in an image editor is the slowest part of doc maintenance.
+
+This CLI solves both: `d360-capture auth` opens Chromium once, the human logs in (MFA at their own pace), and a Playwright `storageState` is saved. Every `d360-capture capture` after that reuses the session. Specs declare what to highlight/redact/annotate; the CLI composites SVG overlays via `sharp` after the raw capture lands.
+
+## Install
+
+```bash
+npm install -g document360-capture
+```
+
+Postinstall downloads the Chromium binary via `npx playwright install chromium`.
+
+## Quick start
+
+```bash
+cd <your-repo>
+d360-capture init                 # one-time per project — writes .d360-capture.json
+d360-capture auth --env staging   # one-time per machine — log in, press Enter when done
+d360-capture capture              # run every spec in captureDir
+d360-capture capture <spec-id>    # run one spec
+```
+
+## Commands
+
+| Command | Description |
+|---|---|
+| `d360-capture init` | Interactive setup. Writes `.d360-capture.json` at repo root. |
+| `d360-capture auth [--env <name>]` | Open Chromium; log in at your own pace; press Enter to save session. |
+| `d360-capture capture [<spec-id>] [--env <name>] [--no-annotate]` | Run one or all specs. Default-on annotation overlay. |
+| `d360-capture list` | List discovered specs and last-capture times. |
+| `d360-capture doctor` | Validate config, auth-state, browser, and capture dir. |
+| `d360-capture status` | Print resolved config (secrets redacted). |
+
+## Spec helpers
+
+Specs in your `captureDir` import three helpers:
+
+```typescript
+import { test } from '@playwright/test';
+import { waitPastLogin, dumpAnnotations, type Placeholder } from 'document360-capture/helpers';
+
+const PLACEHOLDER: Placeholder = {
+  id: 'settings-variables-add-modal',
+  saveTo: 'user-docs/_screenshots/settings-variables-add-modal.raw.png',
+  highlight: ['button:has-text("+ Add")'],
+  annotations: [{ target: 'input[name="key"]', label: '1', text: 'Use proj.* prefix' }],
+  redact: ['[data-testid="topbar-user-email"]'],
+};
+
+test(PLACEHOLDER.id, async ({ page }) => {
+  await page.goto(process.env.CAPTURE_START_URL!);
+  await waitPastLogin(page, new RegExp(process.env.CAPTURE_AUTH_BOUNDARY!));
+
+  await page.click('[aria-label="Open Settings"]');
+  await page.click('a:has-text("Variables")');
+  await page.click('button:has-text("+ Add")');
+  await page.waitForSelector('[role="dialog"]', { state: 'visible' });
+
+  await page.locator('[role="dialog"]').first().screenshot({ path: PLACEHOLDER.saveTo });
+  await dumpAnnotations(page, PLACEHOLDER);
+});
+```
+
+## Config files
+
+- **`<repo>/.d360-capture.json`** (committed): paths, viewport, environments (startUrl + authBoundaryUrlPattern per env), annotation toggle.
+- **`~/.document360-capture/auth-states/<projectId>/<env>.json`** (per-machine, never commit): Playwright `storageState`.
+
+## License
+
+MIT

package/dist/annotate/compose.d.ts

@@ -0,0 +1,7 @@
+export type AnnotateResult = {
+    id: string;
+    ok: boolean;
+    reason?: string;
+    finalPath?: string;
+};
+export declare function composeAnnotations(outputDir: string, enabled: boolean): Promise<AnnotateResult[]>;

package/dist/annotate/compose.js

@@ -0,0 +1,65 @@
+import { readdirSync, readFileSync, existsSync, copyFileSync } from 'node:fs';
+import { join } from 'node:path';
+import sharp from 'sharp';
+import { highlightSvg, redactSvg, annotationSvg } from './svg.js';
+async function annotateOne(jsonPath) {
+    const data = JSON.parse(readFileSync(jsonPath, 'utf8'));
+    if (!existsSync(data.rawPath))
+        return { id: data.id, ok: false, reason: `raw missing: ${data.rawPath}` };
+    const meta = await sharp(data.rawPath).metadata();
+    const width = meta.width ?? 1440;
+    const height = meta.height ?? 900;
+    const parts = [];
+    for (const h of data.highlight)
+        parts.push(highlightSvg(h.bbox));
+    for (const r of data.redact)
+        parts.push(redactSvg(r.bbox));
+    for (const a of data.annotations)
+        parts.push(annotationSvg(a.label, a.text, a.bbox, width));
+    if (parts.length === 0) {
+        await sharp(data.rawPath).toFile(data.finalPath);
+        return { id: data.id, ok: true, finalPath: data.finalPath };
+    }
+    const svg = `<svg xmlns="http://www.w3.org/2000/svg" width="${width}" height="${height}">${parts.join('')}</svg>`;
+    await sharp(data.rawPath)
+        .composite([{ input: Buffer.from(svg), top: 0, left: 0 }])
+        .toFile(data.finalPath);
+    return { id: data.id, ok: true, finalPath: data.finalPath };
+}
+async function copyRawAsFinal(outputDir) {
+    const files = readdirSync(outputDir).filter(f => f.endsWith('.raw.png'));
+    const results = [];
+    for (const f of files) {
+        const rawPath = join(outputDir, f);
+        const finalPath = rawPath.replace(/\.raw\.png$/, '.png');
+        try {
+            copyFileSync(rawPath, finalPath);
+            results.push({ id: f.replace(/\.raw\.png$/, ''), ok: true, finalPath });
+        }
+        catch (err) {
+            results.push({ id: f, ok: false, reason: String(err) });
+        }
+    }
+    return results;
+}
+export async function composeAnnotations(outputDir, enabled) {
+    if (!existsSync(outputDir))
+        return [];
+    if (!enabled)
+        return copyRawAsFinal(outputDir);
+    const files = readdirSync(outputDir).filter(f => f.endsWith('.annotations.json'));
+    if (files.length === 0)
+        return copyRawAsFinal(outputDir);
+    const results = [];
+    for (const f of files) {
+        const jsonPath = join(outputDir, f);
+        try {
+            results.push(await annotateOne(jsonPath));
+        }
+        catch (err) {
+            results.push({ id: f, ok: false, reason: String(err) });
+        }
+    }
+    return results;
+}
+//# sourceMappingURL=compose.js.map

package/dist/annotate/compose.js.map

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

package/dist/annotate/svg.d.ts

@@ -0,0 +1,5 @@
+import type { Bbox } from '../helpers/types.js';
+export declare function escapeXml(s: string): string;
+export declare function highlightSvg(bbox: Bbox): string;
+export declare function redactSvg(bbox: Bbox): string;
+export declare function annotationSvg(label: string, text: string, bbox: Bbox, canvasW: number): string;

package/dist/annotate/svg.js

@@ -0,0 +1,42 @@
+export function escapeXml(s) {
+    return s.replace(/[<>&"']/g, c => ({ '<': '&lt;', '>': '&gt;', '&': '&amp;', '"': '&quot;', "'": '&apos;' }[c]));
+}
+export function highlightSvg(bbox) {
+    const pad = 4;
+    const x = Math.max(0, bbox.x - pad);
+    const y = Math.max(0, bbox.y - pad);
+    const w = bbox.width + pad * 2;
+    const h = bbox.height + pad * 2;
+    return `<rect x="${x}" y="${y}" width="${w}" height="${h}" rx="6" ry="6" fill="rgba(255,213,0,0.18)" stroke="#f5a623" stroke-width="2.5"/>`;
+}
+export function redactSvg(bbox) {
+    return `<rect x="${bbox.x}" y="${bbox.y}" width="${bbox.width}" height="${bbox.height}" fill="#1f2328"/>`;
+}
+export function annotationSvg(label, text, bbox, canvasW) {
+    const r = 14;
+    const cx = bbox.x + bbox.width + r + 4;
+    const cy = bbox.y + bbox.height / 2;
+    const textPad = 8;
+    const fontSize = 13;
+    const approxCharWidth = 7.2;
+    const textWidth = text.length * approxCharWidth + textPad * 2;
+    const textHeight = fontSize + textPad * 2;
+    let textX = cx + r + 6;
+    let textY = cy - textHeight / 2;
+    if (textX + textWidth > canvasW) {
+        textX = bbox.x - textWidth - r - 6;
+        if (textX < 0) {
+            textX = bbox.x;
+            textY = bbox.y - textHeight - 6;
+            if (textY < 0)
+                textY = bbox.y + bbox.height + 6;
+        }
+    }
+    return [
+        `<circle cx="${cx}" cy="${cy}" r="${r}" fill="#d1242f" stroke="#fff" stroke-width="2"/>`,
+        `<text x="${cx}" y="${cy + 5}" font-family="-apple-system,Segoe UI,sans-serif" font-size="14" font-weight="700" fill="#fff" text-anchor="middle">${escapeXml(label)}</text>`,
+        `<rect x="${textX}" y="${textY}" width="${textWidth}" height="${textHeight}" rx="4" ry="4" fill="#1f2328" stroke="#fff" stroke-width="1.5"/>`,
+        `<text x="${textX + textPad}" y="${textY + textPad + fontSize - 2}" font-family="-apple-system,Segoe UI,sans-serif" font-size="${fontSize}" fill="#fff">${escapeXml(text)}</text>`,
+    ].join('');
+}
+//# sourceMappingURL=svg.js.map

package/dist/annotate/svg.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"svg.js","sourceRoot":"","sources":["../../src/annotate/svg.ts"],"names":[],"mappings":"AAEA,MAAM,UAAU,SAAS,CAAC,CAAS;IACjC,OAAO,CAAC,CAAC,OAAO,CAAC,UAAU,EAAE,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,GAAG,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,EAAE,GAAG,EAAE,OAAO,EAAE,GAAG,EAAE,QAAQ,EAAE,GAAG,EAAE,QAAQ,EAAE,CAAC,CAAC,CAAE,CAAC,CAAC,CAAC;AACpH,CAAC;AAED,MAAM,UAAU,YAAY,CAAC,IAAU;IACrC,MAAM,GAAG,GAAG,CAAC,CAAC;IACd,MAAM,CAAC,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,CAAC,GAAG,GAAG,CAAC,CAAC;IACpC,MAAM,CAAC,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,CAAC,GAAG,GAAG,CAAC,CAAC;IACpC,MAAM,CAAC,GAAG,IAAI,CAAC,KAAK,GAAG,GAAG,GAAG,CAAC,CAAC;IAC/B,MAAM,CAAC,GAAG,IAAI,CAAC,MAAM,GAAG,GAAG,GAAG,CAAC,CAAC;IAChC,OAAO,YAAY,CAAC,QAAQ,CAAC,YAAY,CAAC,aAAa,CAAC,mFAAmF,CAAC;AAC9I,CAAC;AAED,MAAM,UAAU,SAAS,CAAC,IAAU;IAClC,OAAO,YAAY,IAAI,CAAC,CAAC,QAAQ,IAAI,CAAC,CAAC,YAAY,IAAI,CAAC,KAAK,aAAa,IAAI,CAAC,MAAM,oBAAoB,CAAC;AAC5G,CAAC;AAED,MAAM,UAAU,aAAa,CAAC,KAAa,EAAE,IAAY,EAAE,IAAU,EAAE,OAAe;IACpF,MAAM,CAAC,GAAG,EAAE,CAAC;IACb,MAAM,EAAE,GAAG,IAAI,CAAC,CAAC,GAAG,IAAI,CAAC,KAAK,GAAG,CAAC,GAAG,CAAC,CAAC;IACvC,MAAM,EAAE,GAAG,IAAI,CAAC,CAAC,GAAG,IAAI,CAAC,MAAM,GAAG,CAAC,CAAC;IAEpC,MAAM,OAAO,GAAG,CAAC,CAAC;IAClB,MAAM,QAAQ,GAAG,EAAE,CAAC;IACpB,MAAM,eAAe,GAAG,GAAG,CAAC;IAC5B,MAAM,SAAS,GAAG,IAAI,CAAC,MAAM,GAAG,eAAe,GAAG,OAAO,GAAG,CAAC,CAAC;IAC9D,MAAM,UAAU,GAAG,QAAQ,GAAG,OAAO,GAAG,CAAC,CAAC;IAE1C,IAAI,KAAK,GAAG,EAAE,GAAG,CAAC,GAAG,CAAC,CAAC;IACvB,IAAI,KAAK,GAAG,EAAE,GAAG,UAAU,GAAG,CAAC,CAAC;IAChC,IAAI,KAAK,GAAG,SAAS,GAAG,OAAO,EAAE,CAAC;QAChC,KAAK,GAAG,IAAI,CAAC,CAAC,GAAG,SAAS,GAAG,CAAC,GAAG,CAAC,CAAC;QACnC,IAAI,KAAK,GAAG,CAAC,EAAE,CAAC;YACd,KAAK,GAAG,IAAI,CAAC,CAAC,CAAC;YACf,KAAK,GAAG,IAAI,CAAC,CAAC,GAAG,UAAU,GAAG,CAAC,CAAC;YAChC,IAAI,KAAK,GAAG,CAAC;gBAAE,KAAK,GAAG,IAAI,CAAC,CAAC,GAAG,IAAI,CAAC,MAAM,GAAG,CAAC,CAAC;QAClD,CAAC;IACH,CAAC;IAED,OAAO;QACL,eAAe,EAAE,SAAS,EAAE,QAAQ,CAAC,mDAAmD;QACxF,YAAY,EAAE,QAAQ,EAAE,GAAG,CAAC,uHAAuH,SAAS,CAAC,KAAK,CAAC,SAAS;QAC5K,YAAY,KAAK,QAAQ,KAAK,YAAY,SAAS,aAAa,UAAU,mEAAmE;QAC7I,YAAY,KAAK,GAAG,OAAO,QAAQ,KAAK,GAAG,OAAO,GAAG,QAAQ,GAAG,CAAC,gEAAgE,QAAQ,iBAAiB,SAAS,CAAC,IAAI,CAAC,SAAS;KACnL,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;AACb,CAAC"}

package/dist/cli.d.ts

@@ -0,0 +1,2 @@
+#!/usr/bin/env node
+export {};

package/dist/cli.js

@@ -0,0 +1,66 @@
+#!/usr/bin/env node
+import { Command } from 'commander';
+import { createRequire } from 'node:module';
+import { initCommand } from './commands/init.js';
+import { authCommand } from './commands/auth.js';
+import { captureCommand } from './commands/capture.js';
+import { listCommand } from './commands/list.js';
+import { doctorCommand } from './commands/doctor.js';
+import { statusCommand } from './commands/status.js';
+const require = createRequire(import.meta.url);
+const pkg = require('../package.json');
+const program = new Command();
+program
+    .name('d360-capture')
+    .description('Capture product screenshots from Playwright specs. Login once, capture many.')
+    .version(pkg.version);
+program
+    .command('init')
+    .description('Interactive setup. Writes .d360-capture.json at repo root.')
+    .action(async () => {
+    await initCommand();
+});
+program
+    .command('auth')
+    .description('Open Chromium for interactive login. Press ENTER when done to save the session.')
+    .option('-e, --env <name>', 'Environment name (default: defaultEnvironment from config)')
+    .action(async (opts) => {
+    await authCommand(opts);
+});
+program
+    .command('capture [spec-id]')
+    .description('Run one spec by id, or all specs if omitted.')
+    .option('-e, --env <name>', 'Environment name (default: defaultEnvironment from config)')
+    .option('--no-annotate', 'Skip annotation overlay; emit raw screenshots only')
+    .action(async (specId, opts) => {
+    const exit = await captureCommand(specId, opts);
+    if (exit !== 0)
+        process.exit(exit);
+});
+program
+    .command('list')
+    .description('List discovered specs and their last-capture times.')
+    .action(async () => {
+    await listCommand();
+});
+program
+    .command('doctor')
+    .description('Validate config, auth-state, and browser install.')
+    .option('-e, --env <name>', 'Environment to check')
+    .action(async (opts) => {
+    const exit = await doctorCommand(opts);
+    if (exit !== 0)
+        process.exit(exit);
+});
+program
+    .command('status')
+    .description('Print resolved config and auth-state freshness.')
+    .action(async () => {
+    await statusCommand();
+});
+program.parseAsync(process.argv).catch(err => {
+    console.error('');
+    console.error(`✗ ${err.message}`);
+    process.exit(1);
+});
+//# sourceMappingURL=cli.js.map

package/dist/cli.js.map

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

package/dist/commands/auth.d.ts

@@ -0,0 +1,4 @@
+export type AuthOptions = {
+    env?: string;
+};
+export declare function authCommand(opts: AuthOptions): Promise<void>;

package/dist/commands/auth.js

@@ -0,0 +1,52 @@
+import { chromium } from 'playwright';
+import { findProjectConfigPath, readProjectConfig, resolveEnv, } from '../config/projectConfig.js';
+import { authStatePath, ensureAuthStateDir } from '../config/authState.js';
+export async function authCommand(opts) {
+    const cfg = readProjectConfig(findProjectConfigPath());
+    const { name: envName, env } = resolveEnv(cfg, opts.env);
+    ensureAuthStateDir(cfg.projectId);
+    const savePath = authStatePath(cfg.projectId, envName);
+    console.log('');
+    console.log(`Opening Chromium against ${env.startUrl}`);
+    console.log(`Auth-state will save to: ${savePath}`);
+    console.log('');
+    const browser = await chromium.launch({
+        headless: false,
+        args: ['--start-maximized'],
+    });
+    const context = await browser.newContext({ viewport: null });
+    const page = await context.newPage();
+    await page.goto(env.startUrl, { waitUntil: 'domcontentloaded' });
+    console.log('────────────────────────────────────────────────────────────');
+    console.log('  Log in fully (MFA included) at your own pace.');
+    console.log('  When you reach the post-login app, come back to this');
+    console.log('  terminal and press ENTER to save the session.');
+    console.log('────────────────────────────────────────────────────────────');
+    console.log('');
+    const safetyInterval = setInterval(() => {
+        void context.storageState({ path: savePath }).catch(() => { });
+    }, 30_000);
+    try {
+        await waitForEnter();
+        await context.storageState({ path: savePath });
+        console.log('');
+        console.log(`✓ Session saved to ${savePath}`);
+        console.log('  This file contains session cookies — never commit it to git.');
+    }
+    finally {
+        clearInterval(safetyInterval);
+        await browser.close().catch(() => { });
+    }
+}
+function waitForEnter() {
+    return new Promise(resolve => {
+        const onData = () => {
+            process.stdin.off('data', onData);
+            process.stdin.pause();
+            resolve();
+        };
+        process.stdin.resume();
+        process.stdin.once('data', onData);
+    });
+}
+//# sourceMappingURL=auth.js.map

package/dist/commands/auth.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"auth.js","sourceRoot":"","sources":["../../src/commands/auth.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AACtC,OAAO,EACL,qBAAqB,EACrB,iBAAiB,EACjB,UAAU,GACX,MAAM,4BAA4B,CAAC;AACpC,OAAO,EAAE,aAAa,EAAE,kBAAkB,EAAE,MAAM,wBAAwB,CAAC;AAM3E,MAAM,CAAC,KAAK,UAAU,WAAW,CAAC,IAAiB;IACjD,MAAM,GAAG,GAAG,iBAAiB,CAAC,qBAAqB,EAAE,CAAC,CAAC;IACvD,MAAM,EAAE,IAAI,EAAE,OAAO,EAAE,GAAG,EAAE,GAAG,UAAU,CAAC,GAAG,EAAE,IAAI,CAAC,GAAG,CAAC,CAAC;IACzD,kBAAkB,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC;IAClC,MAAM,QAAQ,GAAG,aAAa,CAAC,GAAG,CAAC,SAAS,EAAE,OAAO,CAAC,CAAC;IAEvD,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;IAChB,OAAO,CAAC,GAAG,CAAC,4BAA4B,GAAG,CAAC,QAAQ,EAAE,CAAC,CAAC;IACxD,OAAO,CAAC,GAAG,CAAC,4BAA4B,QAAQ,EAAE,CAAC,CAAC;IACpD,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;IAEhB,MAAM,OAAO,GAAG,MAAM,QAAQ,CAAC,MAAM,CAAC;QACpC,QAAQ,EAAE,KAAK;QACf,IAAI,EAAE,CAAC,mBAAmB,CAAC;KAC5B,CAAC,CAAC;IACH,MAAM,OAAO,GAAG,MAAM,OAAO,CAAC,UAAU,CAAC,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC,CAAC;IAC7D,MAAM,IAAI,GAAG,MAAM,OAAO,CAAC,OAAO,EAAE,CAAC;IAErC,MAAM,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,QAAQ,EAAE,EAAE,SAAS,EAAE,kBAAkB,EAAE,CAAC,CAAC;IAEjE,OAAO,CAAC,GAAG,CAAC,8DAA8D,CAAC,CAAC;IAC5E,OAAO,CAAC,GAAG,CAAC,iDAAiD,CAAC,CAAC;IAC/D,OAAO,CAAC,GAAG,CAAC,wDAAwD,CAAC,CAAC;IACtE,OAAO,CAAC,GAAG,CAAC,iDAAiD,CAAC,CAAC;IAC/D,OAAO,CAAC,GAAG,CAAC,8DAA8D,CAAC,CAAC;IAC5E,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;IAEhB,MAAM,cAAc,GAAG,WAAW,CAAC,GAAG,EAAE;QACtC,KAAK,OAAO,CAAC,YAAY,CAAC,EAAE,IAAI,EAAE,QAAQ,EAAE,CAAC,CAAC,KAAK,CAAC,GAAG,EAAE,GAAE,CAAC,CAAC,CAAC;IAChE,CAAC,EAAE,MAAM,CAAC,CAAC;IAEX,IAAI,CAAC;QACH,MAAM,YAAY,EAAE,CAAC;QACrB,MAAM,OAAO,CAAC,YAAY,CAAC,EAAE,IAAI,EAAE,QAAQ,EAAE,CAAC,CAAC;QAC/C,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;QAChB,OAAO,CAAC,GAAG,CAAC,sBAAsB,QAAQ,EAAE,CAAC,CAAC;QAC9C,OAAO,CAAC,GAAG,CAAC,gEAAgE,CAAC,CAAC;IAChF,CAAC;YAAS,CAAC;QACT,aAAa,CAAC,cAAc,CAAC,CAAC;QAC9B,MAAM,OAAO,CAAC,KAAK,EAAE,CAAC,KAAK,CAAC,GAAG,EAAE,GAAE,CAAC,CAAC,CAAC;IACxC,CAAC;AACH,CAAC;AAED,SAAS,YAAY;IACnB,OAAO,IAAI,OAAO,CAAC,OAAO,CAAC,EAAE;QAC3B,MAAM,MAAM,GAAG,GAAS,EAAE;YACxB,OAAO,CAAC,KAAK,CAAC,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;YAClC,OAAO,CAAC,KAAK,CAAC,KAAK,EAAE,CAAC;YACtB,OAAO,EAAE,CAAC;QACZ,CAAC,CAAC;QACF,OAAO,CAAC,KAAK,CAAC,MAAM,EAAE,CAAC;QACvB,OAAO,CAAC,KAAK,CAAC,IAAI,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACrC,CAAC,CAAC,CAAC;AACL,CAAC"}

package/dist/commands/capture.d.ts

@@ -0,0 +1,5 @@
+export type CaptureOptions = {
+    env?: string;
+    noAnnotate?: boolean;
+};
+export declare function captureCommand(specId: string | undefined, opts: CaptureOptions): Promise<number>;

package/dist/commands/capture.js

@@ -0,0 +1,77 @@
+import { existsSync } from 'node:fs';
+import { isAbsolute, resolve } from 'node:path';
+import { findProjectConfigPath, readProjectConfig, resolveEnv, } from '../config/projectConfig.js';
+import { authStatePath, getAuthStateInfo } from '../config/authState.js';
+import { writeRuntimePlaywrightConfig } from '../runner/playwrightConfig.js';
+import { runSpecs } from '../runner/runSpecs.js';
+import { looksLikeSessionExpiry } from '../runner/expiryDetect.js';
+import { composeAnnotations } from '../annotate/compose.js';
+export async function captureCommand(specId, opts) {
+    const cwd = process.cwd();
+    const cfg = readProjectConfig(findProjectConfigPath(cwd));
+    const { name: envName, env } = resolveEnv(cfg, opts.env);
+    const info = getAuthStateInfo(cfg.projectId, envName);
+    if (!info.exists) {
+        console.error('');
+        console.error(`✗ No saved session for env "${envName}".`);
+        console.error(`  Expected at: ${info.path}`);
+        console.error(`  Run: d360-capture auth --env ${envName}`);
+        return 2;
+    }
+    const captureDirAbs = isAbsolute(cfg.captureDir) ? cfg.captureDir : resolve(cwd, cfg.captureDir);
+    if (!existsSync(captureDirAbs)) {
+        console.error(`✗ Capture directory missing: ${captureDirAbs}`);
+        console.error('  Generate at least one spec there before running capture.');
+        return 2;
+    }
+    const configPath = writeRuntimePlaywrightConfig({
+        cwd,
+        cfg,
+        envName,
+        storageStatePath: authStatePath(cfg.projectId, envName),
+    });
+    console.log('');
+    console.log(`▶ Running specs against ${envName} (${env.startUrl})`);
+    if (specId)
+        console.log(`  Single spec: ${specId}`);
+    else
+        console.log(`  All specs in ${cfg.captureDir}`);
+    console.log('');
+    const result = await runSpecs({
+        cwd,
+        configPath,
+        startUrl: env.startUrl,
+        authBoundaryUrlPattern: env.authBoundaryUrlPattern,
+        specId,
+        captureDirAbs,
+    });
+    if (result.exitCode !== 0) {
+        const combined = result.stdout + '\n' + result.stderr;
+        if (looksLikeSessionExpiry(combined)) {
+            console.error('');
+            console.error(`✗ Session expired or invalid for env "${envName}".`);
+            console.error(`  Run: d360-capture auth --env ${envName}`);
+            console.error('  Then re-run d360-capture capture.');
+            return 2;
+        }
+        console.error('');
+        console.error(`✗ Playwright exited with code ${result.exitCode}`);
+        return result.exitCode;
+    }
+    const annotateEnabled = !opts.noAnnotate && cfg.annotation.enabled;
+    const outputDirAbs = isAbsolute(cfg.outputDir) ? cfg.outputDir : resolve(cwd, cfg.outputDir);
+    console.log('');
+    console.log(annotateEnabled ? '▶ Annotating screenshots...' : '▶ Skipping annotation (--no-annotate or config off)');
+    const annotated = await composeAnnotations(outputDirAbs, annotateEnabled);
+    const ok = annotated.filter(r => r.ok).length;
+    const failed = annotated.filter(r => !r.ok);
+    console.log('');
+    console.log(`✓ ${ok} screenshot${ok === 1 ? '' : 's'} ready in ${cfg.outputDir}`);
+    if (failed.length > 0) {
+        console.log(`✗ ${failed.length} annotation failure${failed.length === 1 ? '' : 's'}:`);
+        for (const f of failed)
+            console.log(`    - ${f.id}: ${f.reason}`);
+    }
+    return failed.length === 0 ? 0 : 1;
+}
+//# sourceMappingURL=capture.js.map

package/dist/commands/capture.js.map

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

package/dist/commands/doctor.d.ts

@@ -0,0 +1,4 @@
+export type DoctorOptions = {
+    env?: string;
+};
+export declare function doctorCommand(opts: DoctorOptions): Promise<number>;

package/dist/commands/doctor.js

@@ -0,0 +1,88 @@
+import { existsSync, readFileSync } from 'node:fs';
+import { isAbsolute, resolve } from 'node:path';
+import { createRequire } from 'node:module';
+import { findProjectConfigPath, readProjectConfig, resolveEnv, } from '../config/projectConfig.js';
+import { getAuthStateInfo } from '../config/authState.js';
+const require = createRequire(import.meta.url);
+export async function doctorCommand(opts) {
+    const cwd = process.cwd();
+    let failures = 0;
+    const ok = (msg) => console.log(`  ✓ ${msg}`);
+    const fail = (msg) => {
+        console.log(`  ✗ ${msg}`);
+        failures++;
+    };
+    console.log('');
+    console.log('Checking document360-capture setup...');
+    console.log('');
+    const cfgPath = findProjectConfigPath(cwd);
+    if (!existsSync(cfgPath)) {
+        fail(`Project config missing at ${cfgPath} — run \`d360-capture init\``);
+        return 2;
+    }
+    ok(`Project config: ${cfgPath}`);
+    let cfg;
+    try {
+        cfg = readProjectConfig(cfgPath);
+        ok(`Config parses; projectId="${cfg.projectId}"`);
+    }
+    catch (err) {
+        fail(`Config invalid: ${err.message}`);
+        return 2;
+    }
+    const captureDirAbs = isAbsolute(cfg.captureDir) ? cfg.captureDir : resolve(cwd, cfg.captureDir);
+    if (existsSync(captureDirAbs))
+        ok(`Capture dir exists: ${cfg.captureDir}`);
+    else
+        fail(`Capture dir missing: ${cfg.captureDir}`);
+    let env;
+    try {
+        env = resolveEnv(cfg, opts.env);
+        ok(`Environment "${env.name}" resolved (startUrl=${env.env.startUrl})`);
+    }
+    catch (err) {
+        fail(`Environment resolve failed: ${err.message}`);
+        return 1;
+    }
+    const info = getAuthStateInfo(cfg.projectId, env.name);
+    if (info.exists) {
+        const ageDays = info.ageMs != null ? Math.floor(info.ageMs / 86_400_000) : null;
+        ok(`Auth-state present (${ageDays}d old): ${info.path}`);
+        try {
+            const parsed = JSON.parse(readFileSync(info.path, 'utf8'));
+            if (parsed && typeof parsed === 'object')
+                ok('Auth-state parses as JSON');
+            else
+                fail('Auth-state is not a valid object');
+        }
+        catch (err) {
+            fail(`Auth-state unreadable: ${err.message}`);
+        }
+    }
+    else {
+        fail(`Auth-state missing for "${env.name}" — run \`d360-capture auth --env ${env.name}\``);
+    }
+    try {
+        const playwrightPkg = require.resolve('playwright/package.json');
+        const pkg = JSON.parse(readFileSync(playwrightPkg, 'utf8'));
+        ok(`playwright@${pkg.version} installed`);
+    }
+    catch {
+        fail('playwright not resolvable — reinstall document360-capture');
+    }
+    try {
+        require.resolve('@playwright/test/cli.js');
+        ok('@playwright/test CLI resolvable');
+    }
+    catch {
+        fail('@playwright/test CLI not resolvable — reinstall document360-capture');
+    }
+    console.log('');
+    if (failures === 0)
+        console.log('All checks passed.');
+    else
+        console.log(`${failures} check${failures === 1 ? '' : 's'} failed.`);
+    console.log('');
+    return failures === 0 ? 0 : 1;
+}
+//# sourceMappingURL=doctor.js.map

package/dist/commands/doctor.js.map

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

package/dist/commands/init.d.ts

@@ -0,0 +1 @@
+export declare function initCommand(): Promise<void>;