@relauts/spotcheck-service 1.0.0

package/dist/playwright/actions.js

@@ -0,0 +1,170 @@
+import { createProcessedScreenshotSaver } from "./processed.js";
+export const PLAYWRIGHT_ACTION_NAMES = [
+    "goto",
+    "goBack",
+    "goForward",
+    "reload",
+    "setContent",
+    "click",
+    "dblclick",
+    "tap",
+    "fill",
+    "clear",
+    "type",
+    "pressSequentially",
+    "press",
+    "check",
+    "uncheck",
+    "setChecked",
+    "selectOption",
+    "selectText",
+    "hover",
+    "focus",
+    "blur",
+    "dragTo",
+    "setInputFiles",
+    "scrollIntoViewIfNeeded",
+    "highlight",
+    "screenshot",
+    "dispatchEvent",
+    "keyboard",
+    "mouse",
+    "touchscreen",
+];
+export function isCoordinates(value) {
+    if (typeof value !== "object" || value === null) {
+        return false;
+    }
+    const record = value;
+    return (typeof record.x === "number" &&
+        Number.isFinite(record.x) &&
+        typeof record.y === "number" &&
+        Number.isFinite(record.y) &&
+        typeof record.click !== "function");
+}
+function toLocator(page, target) {
+    return typeof target === "string" ? page.locator(target) : target;
+}
+function splitPointTarget(targetOrX, yOrOptions, maybeOptions) {
+    if (typeof targetOrX === "number") {
+        if (typeof yOrOptions !== "number" || !Number.isFinite(yOrOptions)) {
+            throw new Error("Y coordinate is required when X is a number");
+        }
+        return { kind: "point", x: targetOrX, y: yOrOptions, options: maybeOptions };
+    }
+    if (isCoordinates(targetOrX)) {
+        return { kind: "point", x: targetOrX.x, y: targetOrX.y, options: yOrOptions };
+    }
+    return { kind: "locator", target: targetOrX, options: yOrOptions };
+}
+async function pointFromTarget(page, target) {
+    if (isCoordinates(target)) {
+        return target;
+    }
+    const box = await toLocator(page, target).boundingBox();
+    if (!box) {
+        throw new Error("Cannot read coordinates; element has no bounding box");
+    }
+    return {
+        x: box.x + box.width / 2,
+        y: box.y + box.height / 2,
+    };
+}
+export function createPageActions(page, directory) {
+    const locator = (target) => toLocator(page, target);
+    const saveScreenshot = createProcessedScreenshotSaver(page, directory);
+    async function afterAction(actionName, run) {
+        const result = await run();
+        await saveScreenshot(actionName);
+        return result;
+    }
+    return {
+        goto: (...args) => afterAction("goto", () => page.goto(...args)),
+        goBack: (...args) => afterAction("goBack", () => page.goBack(...args)),
+        goForward: (...args) => afterAction("goForward", () => page.goForward(...args)),
+        reload: (...args) => afterAction("reload", () => page.reload(...args)),
+        setContent: (...args) => afterAction("setContent", () => page.setContent(...args)),
+        click: async (targetOrX, yOrOptions, maybeOptions) => afterAction("click", async () => {
+            const target = splitPointTarget(targetOrX, yOrOptions, maybeOptions);
+            if (target.kind === "point") {
+                await page.mouse.click(target.x, target.y, target.options);
+                return;
+            }
+            await locator(target.target).click(target.options);
+        }),
+        dblclick: async (targetOrX, yOrOptions, maybeOptions) => afterAction("dblclick", async () => {
+            const target = splitPointTarget(targetOrX, yOrOptions, maybeOptions);
+            if (target.kind === "point") {
+                await page.mouse.dblclick(target.x, target.y, target.options);
+                return;
+            }
+            await locator(target.target).dblclick(target.options);
+        }),
+        tap: async (targetOrX, yOrOptions) => afterAction("tap", async () => {
+            const target = splitPointTarget(targetOrX, yOrOptions);
+            if (target.kind === "point") {
+                await page.touchscreen.tap(target.x, target.y);
+                return;
+            }
+            await locator(target.target).tap(target.options);
+        }),
+        fill: (target, ...args) => afterAction("fill", () => locator(target).fill(...args)),
+        clear: (target, ...args) => afterAction("clear", () => locator(target).clear(...args)),
+        type: (target, ...args) => afterAction("type", () => locator(target).type(...args)),
+        pressSequentially: (target, ...args) => afterAction("pressSequentially", () => locator(target).pressSequentially(...args)),
+        press: (target, ...args) => afterAction("press", () => locator(target).press(...args)),
+        check: (target, ...args) => afterAction("check", () => locator(target).check(...args)),
+        uncheck: (target, ...args) => afterAction("uncheck", () => locator(target).uncheck(...args)),
+        setChecked: (target, ...args) => afterAction("setChecked", () => locator(target).setChecked(...args)),
+        selectOption: (target, ...args) => afterAction("selectOption", () => locator(target).selectOption(...args)),
+        selectText: (target, ...args) => afterAction("selectText", () => locator(target).selectText(...args)),
+        hover: async (targetOrX, yOrOptions, maybeOptions) => afterAction("hover", async () => {
+            const target = splitPointTarget(targetOrX, yOrOptions, maybeOptions);
+            if (target.kind === "point") {
+                await page.mouse.move(target.x, target.y, target.options);
+                return;
+            }
+            await locator(target.target).hover(target.options);
+        }),
+        focus: (target, ...args) => afterAction("focus", () => locator(target).focus(...args)),
+        blur: (target, ...args) => afterAction("blur", () => locator(target).blur(...args)),
+        dragTo: async (source, target, options) => afterAction("dragTo", async () => {
+            if (!isCoordinates(source) && !isCoordinates(target) && options) {
+                await locator(source).dragTo(locator(target), options);
+                return;
+            }
+            const from = await pointFromTarget(page, source);
+            const to = await pointFromTarget(page, target);
+            await page.mouse.move(from.x, from.y);
+            await page.mouse.down();
+            await page.mouse.move(to.x, to.y);
+            await page.mouse.up();
+        }),
+        setInputFiles: (target, ...args) => afterAction("setInputFiles", () => locator(target).setInputFiles(...args)),
+        scrollIntoViewIfNeeded: (target, ...args) => afterAction("scrollIntoViewIfNeeded", () => locator(target).scrollIntoViewIfNeeded(...args)),
+        highlight: (target, ...args) => afterAction("highlight", async () => {
+            await locator(target).highlight(...args);
+        }),
+        screenshot: (target, options) => afterAction("screenshot", () => target === undefined ? page.screenshot() : locator(target).screenshot(options)),
+        dispatchEvent: (target, ...args) => afterAction("dispatchEvent", () => locator(target).dispatchEvent(...args)),
+        keyboard: {
+            down: (...args) => afterAction("keyboard-down", () => page.keyboard.down(...args)),
+            up: (...args) => afterAction("keyboard-up", () => page.keyboard.up(...args)),
+            insertText: (...args) => afterAction("keyboard-insertText", () => page.keyboard.insertText(...args)),
+            type: (...args) => afterAction("keyboard-type", () => page.keyboard.type(...args)),
+            press: (...args) => afterAction("keyboard-press", () => page.keyboard.press(...args)),
+        },
+        mouse: {
+            move: (...args) => afterAction("mouse-move", () => page.mouse.move(...args)),
+            down: (...args) => afterAction("mouse-down", () => page.mouse.down(...args)),
+            up: (...args) => afterAction("mouse-up", () => page.mouse.up(...args)),
+            click: (...args) => afterAction("mouse-click", () => page.mouse.click(...args)),
+            dblclick: (...args) => afterAction("mouse-dblclick", () => page.mouse.dblclick(...args)),
+            wheel: (...args) => afterAction("mouse-wheel", () => page.mouse.wheel(...args)),
+        },
+        touchscreen: {
+            tap: (...args) => afterAction("touchscreen-tap", () => page.touchscreen.tap(...args)),
+        },
+    };
+}
+//# sourceMappingURL=actions.js.map

package/dist/playwright/actions.js.map

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

package/dist/playwright/chromium.d.ts

@@ -0,0 +1,10 @@
+import { type Browser, type LaunchOptions } from "playwright";
+import type { AppConfig } from "../shared/config.js";
+/**
+ * Playwright Chromium defaults only. Extra flags (--no-sandbox, --no-zygote,
+ * GPU off, site-isolation off) are unsafe or break launch/screenshots on some OSes.
+ * Set CHROMIUM_SANDBOX=false only in Linux containers that run as root.
+ */
+export declare function getChromiumLaunchOptions(config: AppConfig): LaunchOptions;
+export declare function launchLightChromium(config: AppConfig): Promise<Browser>;
+export declare function closeBrowser(browser: Browser | undefined): Promise<void>;

package/dist/playwright/chromium.js

@@ -0,0 +1,27 @@
+import { chromium } from "playwright";
+/**
+ * Playwright Chromium defaults only. Extra flags (--no-sandbox, --no-zygote,
+ * GPU off, site-isolation off) are unsafe or break launch/screenshots on some OSes.
+ * Set CHROMIUM_SANDBOX=false only in Linux containers that run as root.
+ */
+export function getChromiumLaunchOptions(config) {
+    return {
+        headless: config.headless,
+        chromiumSandbox: config.chromiumSandbox,
+    };
+}
+export async function launchLightChromium(config) {
+    return chromium.launch(getChromiumLaunchOptions(config));
+}
+export async function closeBrowser(browser) {
+    if (!browser) {
+        return;
+    }
+    try {
+        await browser.close();
+    }
+    catch {
+        // Browser may already be closed during shutdown.
+    }
+}
+//# sourceMappingURL=chromium.js.map

package/dist/playwright/chromium.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"chromium.js","sourceRoot":"","sources":["../../src/playwright/chromium.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAoC,MAAM,YAAY,CAAC;AAGxE;;;;GAIG;AACH,MAAM,UAAU,wBAAwB,CAAC,MAAiB;IACxD,OAAO;QACL,QAAQ,EAAE,MAAM,CAAC,QAAQ;QACzB,eAAe,EAAE,MAAM,CAAC,eAAe;KACxC,CAAC;AACJ,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,mBAAmB,CAAC,MAAiB;IACzD,OAAO,QAAQ,CAAC,MAAM,CAAC,wBAAwB,CAAC,MAAM,CAAC,CAAC,CAAC;AAC3D,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,YAAY,CAAC,OAA4B;IAC7D,IAAI,CAAC,OAAO,EAAE,CAAC;QACb,OAAO;IACT,CAAC;IAED,IAAI,CAAC;QACH,MAAM,OAAO,CAAC,KAAK,EAAE,CAAC;IACxB,CAAC;IAAC,MAAM,CAAC;QACP,iDAAiD;IACnD,CAAC;AACH,CAAC"}

package/dist/playwright/index.d.ts

@@ -0,0 +1,2 @@
+import { type AppConfig } from "../shared/config.js";
+export declare function runApp(config?: AppConfig): Promise<string>;

package/dist/playwright/index.js

@@ -0,0 +1,64 @@
+import { loadConfig } from "../shared/config.js";
+import { logger } from "../shared/logger.js";
+import { isMainModule } from "../shared/main-module.js";
+import { closeBrowser, launchLightChromium } from "./chromium.js";
+import { createPageActions } from "./actions.js";
+let activeBrowser;
+let shuttingDown = false;
+async function shutdown(exitCode, reason) {
+    if (shuttingDown) {
+        process.exit(exitCode);
+    }
+    shuttingDown = true;
+    logger.info(reason);
+    await closeBrowser(activeBrowser);
+    activeBrowser = undefined;
+    process.exit(exitCode);
+}
+export async function runApp(config = loadConfig()) {
+    logger.info(`Launching Chromium (headless=${config.headless}, sandbox=${config.chromiumSandbox}, viewport=${config.viewportWidth}x${config.viewportHeight})`);
+    activeBrowser = await launchLightChromium(config);
+    try {
+        const page = await activeBrowser.newPage({
+            viewport: {
+                width: config.viewportWidth,
+                height: config.viewportHeight,
+            },
+        });
+        page.setDefaultNavigationTimeout(config.navigationTimeoutMs);
+        const actions = createPageActions(page, config.processedDir);
+        logger.info(`Navigating to ${config.targetUrl}`);
+        await actions.goto(config.targetUrl, {
+            waitUntil: "domcontentloaded",
+            timeout: config.navigationTimeoutMs,
+        });
+        logger.info("Clicking xpath=//a");
+        await actions.click("xpath=//a");
+        const loadedUrl = page.url();
+        logger.info(`Loaded ${loadedUrl}`);
+        return loadedUrl;
+    }
+    finally {
+        await closeBrowser(activeBrowser);
+        activeBrowser = undefined;
+        logger.info("Browser closed");
+    }
+}
+function registerShutdownHandlers() {
+    const onSignal = (signal) => {
+        void shutdown(0, `Received ${signal}, shutting down`);
+    };
+    process.once("SIGINT", onSignal);
+    process.once("SIGTERM", onSignal);
+}
+async function main() {
+    registerShutdownHandlers();
+    await runApp();
+}
+if (isMainModule(import.meta.url)) {
+    main().catch((error) => {
+        logger.error("Fatal error", error);
+        void shutdown(1, "Exiting after fatal error");
+    });
+}
+//# sourceMappingURL=index.js.map

package/dist/playwright/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/playwright/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,UAAU,EAAkB,MAAM,qBAAqB,CAAC;AACjE,OAAO,EAAE,MAAM,EAAE,MAAM,qBAAqB,CAAC;AAC7C,OAAO,EAAE,YAAY,EAAE,MAAM,0BAA0B,CAAC;AACxD,OAAO,EAAE,YAAY,EAAE,mBAAmB,EAAE,MAAM,eAAe,CAAC;AAClE,OAAO,EAAE,iBAAiB,EAAE,MAAM,cAAc,CAAC;AAEjD,IAAI,aAAkC,CAAC;AACvC,IAAI,YAAY,GAAG,KAAK,CAAC;AAEzB,KAAK,UAAU,QAAQ,CAAC,QAAgB,EAAE,MAAc;IACtD,IAAI,YAAY,EAAE,CAAC;QACjB,OAAO,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;IACzB,CAAC;IAED,YAAY,GAAG,IAAI,CAAC;IACpB,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;IACpB,MAAM,YAAY,CAAC,aAAa,CAAC,CAAC;IAClC,aAAa,GAAG,SAAS,CAAC;IAC1B,OAAO,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;AACzB,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,MAAM,CAAC,SAAoB,UAAU,EAAE;IAC3D,MAAM,CAAC,IAAI,CACT,gCAAgC,MAAM,CAAC,QAAQ,aAAa,MAAM,CAAC,eAAe,cAAc,MAAM,CAAC,aAAa,IAAI,MAAM,CAAC,cAAc,GAAG,CACjJ,CAAC;IACF,aAAa,GAAG,MAAM,mBAAmB,CAAC,MAAM,CAAC,CAAC;IAElD,IAAI,CAAC;QACH,MAAM,IAAI,GAAG,MAAM,aAAa,CAAC,OAAO,CAAC;YACvC,QAAQ,EAAE;gBACR,KAAK,EAAE,MAAM,CAAC,aAAa;gBAC3B,MAAM,EAAE,MAAM,CAAC,cAAc;aAC9B;SACF,CAAC,CAAC;QACH,IAAI,CAAC,2BAA2B,CAAC,MAAM,CAAC,mBAAmB,CAAC,CAAC;QAC7D,MAAM,OAAO,GAAG,iBAAiB,CAAC,IAAI,EAAE,MAAM,CAAC,YAAY,CAAC,CAAC;QAE7D,MAAM,CAAC,IAAI,CAAC,iBAAiB,MAAM,CAAC,SAAS,EAAE,CAAC,CAAC;QACjD,MAAM,OAAO,CAAC,IAAI,CAAC,MAAM,CAAC,SAAS,EAAE;YACnC,SAAS,EAAE,kBAAkB;YAC7B,OAAO,EAAE,MAAM,CAAC,mBAAmB;SACpC,CAAC,CAAC;QAEH,MAAM,CAAC,IAAI,CAAC,oBAAoB,CAAC,CAAC;QAClC,MAAM,OAAO,CAAC,KAAK,CAAC,WAAW,CAAC,CAAC;QAEjC,MAAM,SAAS,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;QAC7B,MAAM,CAAC,IAAI,CAAC,UAAU,SAAS,EAAE,CAAC,CAAC;QACnC,OAAO,SAAS,CAAC;IACnB,CAAC;YAAS,CAAC;QACT,MAAM,YAAY,CAAC,aAAa,CAAC,CAAC;QAClC,aAAa,GAAG,SAAS,CAAC;QAC1B,MAAM,CAAC,IAAI,CAAC,gBAAgB,CAAC,CAAC;IAChC,CAAC;AACH,CAAC;AAED,SAAS,wBAAwB;IAC/B,MAAM,QAAQ,GAAG,CAAC,MAAsB,EAAQ,EAAE;QAChD,KAAK,QAAQ,CAAC,CAAC,EAAE,YAAY,MAAM,iBAAiB,CAAC,CAAC;IACxD,CAAC,CAAC;IAEF,OAAO,CAAC,IAAI,CAAC,QAAQ,EAAE,QAAQ,CAAC,CAAC;IACjC,OAAO,CAAC,IAAI,CAAC,SAAS,EAAE,QAAQ,CAAC,CAAC;AACpC,CAAC;AAED,KAAK,UAAU,IAAI;IACjB,wBAAwB,EAAE,CAAC;IAC3B,MAAM,MAAM,EAAE,CAAC;AACjB,CAAC;AAED,IAAI,YAAY,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC;IAClC,IAAI,EAAE,CAAC,KAAK,CAAC,CAAC,KAAc,EAAE,EAAE;QAC9B,MAAM,CAAC,KAAK,CAAC,aAAa,EAAE,KAAK,CAAC,CAAC;QACnC,KAAK,QAAQ,CAAC,CAAC,EAAE,2BAA2B,CAAC,CAAC;IAChD,CAAC,CAAC,CAAC;AACL,CAAC"}

package/dist/playwright/processed.d.ts

@@ -0,0 +1,11 @@
+import type { Page } from "playwright";
+export declare const PROCESSED_DIR: string;
+export declare const SAVED_RUNS_SUBDIR = "saved-runs";
+export declare function getLatestWebpPath(directory?: string): Promise<string | undefined>;
+export declare function savedRunScreenshotStem(historyFile: string): string;
+export declare function getSavedRunScreenshotRelPath(processedDir: string, historyFile: string): Promise<string>;
+export declare function savedRunQuestionFolder(sequence: number, id: string): string;
+export declare function savedRunItemScreenshotDir(processedDir: string, historyFile: string, sequence: number, id: string): string;
+export declare function getSavedRunItemScreenshotRelPaths(processedDir: string, historyFile: string, sequence: number, id: string): Promise<string[]>;
+export declare function waitForScreenshotReady(page: Page): Promise<void>;
+export declare function createProcessedScreenshotSaver(page: Page, directory?: string): (actionName: string) => Promise<string>;

package/dist/playwright/processed.js

@@ -0,0 +1,183 @@
+import fs from "node:fs/promises";
+import path from "node:path";
+export const PROCESSED_DIR = path.resolve(process.cwd(), "processed");
+export const SAVED_RUNS_SUBDIR = "saved-runs";
+export async function getLatestWebpPath(directory = PROCESSED_DIR) {
+    let entries;
+    try {
+        entries = await fs.readdir(directory, { withFileTypes: true });
+    }
+    catch (error) {
+        if (error.code === "ENOENT") {
+            return undefined;
+        }
+        throw error;
+    }
+    const webpFiles = entries.filter((entry) => entry.isFile() && entry.name.toLowerCase().endsWith(".webp"));
+    if (webpFiles.length === 0) {
+        return undefined;
+    }
+    const ranked = await Promise.all(webpFiles.map(async (entry) => {
+        const filePath = path.join(directory, entry.name);
+        const stats = await fs.stat(filePath);
+        return { filePath, mtimeMs: stats.mtimeMs, name: entry.name };
+    }));
+    ranked.sort((left, right) => {
+        if (right.mtimeMs !== left.mtimeMs) {
+            return right.mtimeMs - left.mtimeMs;
+        }
+        return right.name.localeCompare(left.name);
+    });
+    return ranked[0]?.filePath;
+}
+async function latestWebpFrom(filePaths) {
+    if (filePaths.length === 0) {
+        return undefined;
+    }
+    const ranked = await Promise.all(filePaths.map(async (filePath) => {
+        const stats = await fs.stat(filePath);
+        return { filePath, mtimeMs: stats.mtimeMs, name: path.basename(filePath) };
+    }));
+    ranked.sort((left, right) => {
+        if (right.mtimeMs !== left.mtimeMs) {
+            return right.mtimeMs - left.mtimeMs;
+        }
+        return right.name.localeCompare(left.name);
+    });
+    return ranked[0]?.filePath;
+}
+function isSafeEntryName(name) {
+    return name !== "." && name !== ".." && !name.includes("/") && !name.includes("\\");
+}
+export function savedRunScreenshotStem(historyFile) {
+    return historyFile.replace(/\.json$/i, "");
+}
+export async function getSavedRunScreenshotRelPath(processedDir, historyFile) {
+    const stem = savedRunScreenshotStem(historyFile);
+    const runDir = path.join(processedDir, SAVED_RUNS_SUBDIR, stem);
+    let entries;
+    try {
+        entries = await fs.readdir(runDir, { withFileTypes: true });
+    }
+    catch (error) {
+        if (error.code === "ENOENT") {
+            return "";
+        }
+        throw error;
+    }
+    const files = [];
+    for (const entry of entries) {
+        if (!isSafeEntryName(entry.name)) {
+            continue;
+        }
+        if (entry.isFile() && entry.name.toLowerCase().endsWith(".webp")) {
+            files.push(path.join(runDir, entry.name));
+            continue;
+        }
+        if (entry.isDirectory()) {
+            const nested = await getLatestWebpPath(path.join(runDir, entry.name));
+            if (nested) {
+                files.push(nested);
+            }
+        }
+    }
+    const latest = await latestWebpFrom(files);
+    if (!latest) {
+        return "";
+    }
+    const rel = path.relative(runDir, latest).split(path.sep).join("/");
+    if (!rel || rel.startsWith("..") || path.isAbsolute(rel)) {
+        return "";
+    }
+    return `${stem}/${rel}`;
+}
+function sanitizePathSegment(value) {
+    const cleaned = value
+        .trim()
+        .replace(/[^a-zA-Z0-9_-]+/g, "-")
+        .replace(/-+/g, "-")
+        .replace(/^-|-$/g, "");
+    if (!cleaned || cleaned === "." || cleaned === "..") {
+        return "id";
+    }
+    return cleaned;
+}
+export function savedRunQuestionFolder(sequence, id) {
+    return `${String(sequence).padStart(4, "0")}-${sanitizePathSegment(id)}`;
+}
+export function savedRunItemScreenshotDir(processedDir, historyFile, sequence, id) {
+    return path.join(processedDir, SAVED_RUNS_SUBDIR, savedRunScreenshotStem(historyFile), savedRunQuestionFolder(sequence, id));
+}
+export async function getSavedRunItemScreenshotRelPaths(processedDir, historyFile, sequence, id) {
+    const stem = savedRunScreenshotStem(historyFile);
+    const folder = savedRunQuestionFolder(sequence, id);
+    const dir = savedRunItemScreenshotDir(processedDir, historyFile, sequence, id);
+    let entries;
+    try {
+        entries = await fs.readdir(dir, { withFileTypes: true });
+    }
+    catch (error) {
+        if (error.code === "ENOENT") {
+            return [];
+        }
+        throw error;
+    }
+    return entries
+        .filter((entry) => entry.isFile() &&
+        isSafeEntryName(entry.name) &&
+        entry.name.toLowerCase().endsWith(".webp"))
+        .map((entry) => entry.name)
+        .sort((left, right) => left.localeCompare(right))
+        .map((name) => `${stem}/${folder}/${name}`);
+}
+const SCREENSHOT_LOAD_TIMEOUT_MS = 5_000;
+const SCREENSHOT_PAINT_SETTLE_MS = 200;
+function sanitizeActionName(actionName) {
+    return actionName.replace(/[^a-zA-Z0-9._-]+/g, "-");
+}
+function timestamp() {
+    return new Date().toISOString().replace(/[:.]/g, "-");
+}
+async function ignoreFailure(run) {
+    try {
+        await run();
+    }
+    catch {
+        // Still capture whatever is on screen.
+    }
+}
+export async function waitForScreenshotReady(page) {
+    if (page.isClosed()) {
+        return;
+    }
+    await ignoreFailure(() => page.waitForLoadState("load", { timeout: SCREENSHOT_LOAD_TIMEOUT_MS }));
+    await ignoreFailure(() => page.evaluate(`(settleMs) => new Promise((resolve) => {
+        const finish = () => {
+          void document.documentElement.offsetHeight;
+          requestAnimationFrame(() => {
+            requestAnimationFrame(() => {
+              window.setTimeout(resolve, settleMs);
+            });
+          });
+        };
+        if (document.readyState === "complete") {
+          finish();
+          return;
+        }
+        window.addEventListener("load", finish, { once: true });
+        window.setTimeout(finish, 1000);
+      })`, SCREENSHOT_PAINT_SETTLE_MS));
+}
+export function createProcessedScreenshotSaver(page, directory = PROCESSED_DIR) {
+    let sequence = 0;
+    return async function saveProcessedScreenshot(actionName) {
+        sequence += 1;
+        await fs.mkdir(directory, { recursive: true });
+        const fileName = `${timestamp()}-${String(sequence).padStart(4, "0")}-${sanitizeActionName(actionName)}.webp`;
+        const filePath = path.join(directory, fileName);
+        await waitForScreenshotReady(page);
+        await page.screenshot({ path: filePath, type: "webp" });
+        return filePath;
+    };
+}
+//# sourceMappingURL=processed.js.map

package/dist/playwright/processed.js.map

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

package/dist/playwright/session.d.ts

@@ -0,0 +1,28 @@
+import type { Browser, Page } from "playwright";
+import type { AppConfig } from "../shared/config.js";
+export declare const BROWSER_SESSION_RESET_MESSAGE = "Browser session was reset. Started a new browser.";
+export interface PageEnsureResult {
+    readonly page: Page;
+    readonly sessionReset: boolean;
+}
+export interface SessionStatus {
+    readonly open: boolean;
+    readonly url: string;
+}
+export declare class BrowserClosedError extends Error {
+    constructor(message?: string);
+}
+export interface BrowserSession {
+    isOpen(): boolean;
+    getStatus(): SessionStatus;
+    ensurePage(config: AppConfig): Promise<PageEnsureResult>;
+    close(): Promise<void>;
+    goBack(): Promise<SessionStatus>;
+    goForward(): Promise<SessionStatus>;
+    reload(): Promise<SessionStatus>;
+}
+export interface BrowserSessionDeps {
+    launch?(config: AppConfig): Promise<Browser>;
+    screenshotDir?: string;
+}
+export declare function createBrowserSession(deps?: BrowserSessionDeps): BrowserSession;