@kvman/kvvideo 0.0.0-stage → 0.1.0

package/dist/record/address.js

@@ -0,0 +1,28 @@
+import { invalid } from "../problems.js";
+// The addresses a recording may open (plan 16 §16.5, ADR 0107, 18): http or https on this computer, without
+// credentials, and never kvman's own. The recorded page's requests to kvman's port are aborted whatever their host,
+// since `0.0.0.0`, `127.0.0.2`, or `[::ffff:127.0.0.1]` reach kvman too.
+const localHosts = new Set(['localhost', '127.0.0.1', '[::1]']);
+function portOf(url) {
+    if (url.port !== '')
+        return Number(url.port);
+    return url.protocol === 'https:' ? 443 : 80;
+}
+/** Whether a request goes to kvman's port, on any host. */
+export function isOwnAddress(url, ownPort) {
+    return ownPort !== null && portOf(url) === ownPort;
+}
+/** The address, when it is one a recording may open. */
+export function localAddress(address, ownPort) {
+    const url = URL.canParse(address) ? new URL(address) : undefined;
+    if (url === undefined || (url.protocol !== 'http:' && url.protocol !== 'https:'))
+        throw invalid(`${address} isn't an http or https address.`, { url: address });
+    if (!localHosts.has(url.hostname))
+        throw invalid(`${address} isn't on this computer: use localhost, 127.0.0.1, or [::1].`, { url: address });
+    if (url.username !== '' || url.password !== '')
+        throw invalid(`${address} has a user name or password.`, { url: address });
+    if (isOwnAddress(url, ownPort))
+        throw invalid(`${address} is kvman's own address, which can't be recorded.`, { url: address });
+    return url;
+}
+//# sourceMappingURL=address.js.map

package/dist/record/address.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"address.js","sourceRoot":"","sources":["../../src/record/address.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,gBAAgB,CAAC;AAEzC,4GAA4G;AAC5G,oHAAoH;AACpH,yEAAyE;AAEzE,MAAM,UAAU,GAAG,IAAI,GAAG,CAAC,CAAC,WAAW,EAAE,WAAW,EAAE,OAAO,CAAC,CAAC,CAAC;AAEhE,SAAS,MAAM,CAAC,GAAQ;IACtB,IAAI,GAAG,CAAC,IAAI,KAAK,EAAE;QAAE,OAAO,MAAM,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;IAC7C,OAAO,GAAG,CAAC,QAAQ,KAAK,QAAQ,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC;AAC9C,CAAC;AAED,2DAA2D;AAC3D,MAAM,UAAU,YAAY,CAAC,GAAQ,EAAE,OAAsB;IAC3D,OAAO,OAAO,KAAK,IAAI,IAAI,MAAM,CAAC,GAAG,CAAC,KAAK,OAAO,CAAC;AACrD,CAAC;AAED,wDAAwD;AACxD,MAAM,UAAU,YAAY,CAAC,OAAe,EAAE,OAAsB;IAClE,MAAM,GAAG,GAAG,GAAG,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,IAAI,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;IACjE,IAAI,GAAG,KAAK,SAAS,IAAI,CAAC,GAAG,CAAC,QAAQ,KAAK,OAAO,IAAI,GAAG,CAAC,QAAQ,KAAK,QAAQ,CAAC;QAAE,MAAM,OAAO,CAAC,GAAG,OAAO,kCAAkC,EAAE,EAAE,GAAG,EAAE,OAAO,EAAE,CAAC,CAAC;IAChK,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,GAAG,CAAC,QAAQ,CAAC;QAAE,MAAM,OAAO,CAAC,GAAG,OAAO,8DAA8D,EAAE,EAAE,GAAG,EAAE,OAAO,EAAE,CAAC,CAAC;IAC7I,IAAI,GAAG,CAAC,QAAQ,KAAK,EAAE,IAAI,GAAG,CAAC,QAAQ,KAAK,EAAE;QAAE,MAAM,OAAO,CAAC,GAAG,OAAO,+BAA+B,EAAE,EAAE,GAAG,EAAE,OAAO,EAAE,CAAC,CAAC;IAC3H,IAAI,YAAY,CAAC,GAAG,EAAE,OAAO,CAAC;QAAE,MAAM,OAAO,CAAC,GAAG,OAAO,mDAAmD,EAAE,EAAE,GAAG,EAAE,OAAO,EAAE,CAAC,CAAC;IAC/H,OAAO,GAAG,CAAC;AACb,CAAC"}

package/dist/record/cursor-script.d.ts

@@ -0,0 +1,2 @@
+export declare const cursorScript = "(() => {\n  const draw = () => {\n    if (document.getElementById('kvvideo-cursor')) return;\n    const dot = document.createElement('div');\n    dot.id = 'kvvideo-cursor';\n    dot.style.cssText = 'position:fixed;inset-inline-start:0;inset-block-start:0;width:18px;height:18px;margin:-9px 0 0 -9px;border-radius:50%;background:rgba(20,20,20,.75);border:2px solid #fff;box-shadow:0 0 4px rgba(0,0,0,.5);pointer-events:none;z-index:2147483647;transform:translate(-100px,-100px)';\n    document.documentElement.appendChild(dot);\n    window.addEventListener('mousemove', (event) => { dot.style.transform = 'translate(' + event.clientX + 'px,' + event.clientY + 'px)'; }, true);\n    window.addEventListener('mousedown', (event) => {\n      const ring = document.createElement('div');\n      ring.className = 'kvvideo-ring';\n      ring.style.cssText = 'position:fixed;inset-inline-start:' + (event.clientX - 22) + 'px;inset-block-start:' + (event.clientY - 22) + 'px;width:44px;height:44px;border-radius:50%;border:3px solid rgba(255,190,0,.9);pointer-events:none;z-index:2147483646';\n      document.documentElement.appendChild(ring);\n      ring.animate([{ opacity: 1, transform: 'scale(.4)' }, { opacity: 0, transform: 'scale(1.3)' }], { duration: 500 }).onfinish = () => ring.remove();\n    }, true);\n  };\n  if (document.documentElement) draw(); else document.addEventListener('DOMContentLoaded', draw);\n})();";
+//# sourceMappingURL=cursor-script.d.ts.map

package/dist/record/cursor-script.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cursor-script.d.ts","sourceRoot":"","sources":["../../src/record/cursor-script.ts"],"names":[],"mappings":"AAGA,eAAO,MAAM,YAAY,24CAiBnB,CAAC"}

package/dist/record/cursor-script.js

@@ -0,0 +1,21 @@
+// The cursor a recording shows (ADR 0107, 19): a browser's recording has no pointer, so the page draws a dot that
+// follows the mouse and a ring at each press. It is added to every page before its own scripts run.
+export const cursorScript = `(() => {
+  const draw = () => {
+    if (document.getElementById('kvvideo-cursor')) return;
+    const dot = document.createElement('div');
+    dot.id = 'kvvideo-cursor';
+    dot.style.cssText = 'position:fixed;inset-inline-start:0;inset-block-start:0;width:18px;height:18px;margin:-9px 0 0 -9px;border-radius:50%;background:rgba(20,20,20,.75);border:2px solid #fff;box-shadow:0 0 4px rgba(0,0,0,.5);pointer-events:none;z-index:2147483647;transform:translate(-100px,-100px)';
+    document.documentElement.appendChild(dot);
+    window.addEventListener('mousemove', (event) => { dot.style.transform = 'translate(' + event.clientX + 'px,' + event.clientY + 'px)'; }, true);
+    window.addEventListener('mousedown', (event) => {
+      const ring = document.createElement('div');
+      ring.className = 'kvvideo-ring';
+      ring.style.cssText = 'position:fixed;inset-inline-start:' + (event.clientX - 22) + 'px;inset-block-start:' + (event.clientY - 22) + 'px;width:44px;height:44px;border-radius:50%;border:3px solid rgba(255,190,0,.9);pointer-events:none;z-index:2147483646';
+      document.documentElement.appendChild(ring);
+      ring.animate([{ opacity: 1, transform: 'scale(.4)' }, { opacity: 0, transform: 'scale(1.3)' }], { duration: 500 }).onfinish = () => ring.remove();
+    }, true);
+  };
+  if (document.documentElement) draw(); else document.addEventListener('DOMContentLoaded', draw);
+})();`;
+//# sourceMappingURL=cursor-script.js.map

package/dist/record/cursor-script.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cursor-script.js","sourceRoot":"","sources":["../../src/record/cursor-script.ts"],"names":[],"mappings":"AAAA,kHAAkH;AAClH,oGAAoG;AAEpG,MAAM,CAAC,MAAM,YAAY,GAAG;;;;;;;;;;;;;;;;;MAiBtB,CAAC"}

package/dist/record/encoder-args.d.ts

@@ -0,0 +1,3 @@
+/** ffmpeg's arguments for a recording's frames, JPEGs on stdin, to an H.264 file of the size (ADR 0107, 25). */
+export declare function recordEncoderArgs(width: number, height: number, output: string): string[];
+//# sourceMappingURL=encoder-args.d.ts.map

package/dist/record/encoder-args.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"encoder-args.d.ts","sourceRoot":"","sources":["../../src/record/encoder-args.ts"],"names":[],"mappings":"AAEA,gHAAgH;AAChH,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,MAAM,EAAE,CASzF"}

package/dist/record/encoder-args.js

@@ -0,0 +1,13 @@
+import { framesPerSecond } from "./frame-writer.js";
+/** ffmpeg's arguments for a recording's frames, JPEGs on stdin, to an H.264 file of the size (ADR 0107, 25). */
+export function recordEncoderArgs(width, height, output) {
+    const fit = `scale=${String(width)}:${String(height)}:force_original_aspect_ratio=decrease,pad=${String(width)}:${String(height)}:(ow-iw)/2:(oh-ih)/2:color=black,format=yuv420p`;
+    return [
+        '-hide_banner', '-loglevel', 'error',
+        '-f', 'image2pipe', '-framerate', String(framesPerSecond), '-c:v', 'mjpeg', '-i', '-',
+        '-vf', fit,
+        '-c:v', 'libx264', '-preset', 'veryfast', '-crf', '18', '-r', String(framesPerSecond),
+        '-an', '-movflags', '+faststart', '-y', output,
+    ];
+}
+//# sourceMappingURL=encoder-args.js.map

package/dist/record/encoder-args.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"encoder-args.js","sourceRoot":"","sources":["../../src/record/encoder-args.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AAEpD,gHAAgH;AAChH,MAAM,UAAU,iBAAiB,CAAC,KAAa,EAAE,MAAc,EAAE,MAAc;IAC7E,MAAM,GAAG,GAAG,SAAS,MAAM,CAAC,KAAK,CAAC,IAAI,MAAM,CAAC,MAAM,CAAC,6CAA6C,MAAM,CAAC,KAAK,CAAC,IAAI,MAAM,CAAC,MAAM,CAAC,iDAAiD,CAAC;IAClL,OAAO;QACL,cAAc,EAAE,WAAW,EAAE,OAAO;QACpC,IAAI,EAAE,YAAY,EAAE,YAAY,EAAE,MAAM,CAAC,eAAe,CAAC,EAAE,MAAM,EAAE,OAAO,EAAE,IAAI,EAAE,GAAG;QACrF,KAAK,EAAE,GAAG;QACV,MAAM,EAAE,SAAS,EAAE,SAAS,EAAE,UAAU,EAAE,MAAM,EAAE,IAAI,EAAE,IAAI,EAAE,MAAM,CAAC,eAAe,CAAC;QACrF,KAAK,EAAE,WAAW,EAAE,YAAY,EAAE,IAAI,EAAE,MAAM;KAC/C,CAAC;AACJ,CAAC"}

package/dist/record/frame-writer.d.ts

@@ -0,0 +1,8 @@
+export declare const framesPerSecond = 30;
+export type FrameWriter = {
+    frame(data: Buffer, atMs: number): Promise<void>;
+    finish(atMs: number): Promise<number>;
+};
+/** Writes frames to `sink`, timed from `startedAt` (ms); `finish` answers how many slots were written. */
+export declare function frameWriter(sink: (frame: Buffer) => Promise<void>, startedAt: number): FrameWriter;
+//# sourceMappingURL=frame-writer.d.ts.map

package/dist/record/frame-writer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"frame-writer.d.ts","sourceRoot":"","sources":["../../src/record/frame-writer.ts"],"names":[],"mappings":"AAGA,eAAO,MAAM,eAAe,KAAK,CAAC;AAElC,MAAM,MAAM,WAAW,GAAG;IAAE,KAAK,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAAC,MAAM,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAAA;CAAE,CAAC;AAEtH,0GAA0G;AAC1G,wBAAgB,WAAW,CAAC,IAAI,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,EAAE,SAAS,EAAE,MAAM,GAAG,WAAW,CAsBlG"}

package/dist/record/frame-writer.js

@@ -0,0 +1,30 @@
+// A steady 30 frames a second from a screencast that sends a frame only when the picture changes (plan 16 §16.5):
+// each frame is written again, one copy a slot, until the next one comes, and the last until the recording ends.
+export const framesPerSecond = 30;
+/** Writes frames to `sink`, timed from `startedAt` (ms); `finish` answers how many slots were written. */
+export function frameWriter(sink, startedAt) {
+    let previous;
+    let written = 0;
+    const slotAt = (atMs) => Math.max(0, Math.round(((atMs - startedAt) * framesPerSecond) / 1000));
+    const fillTo = async (slot) => {
+        if (previous === undefined)
+            return;
+        while (written < slot) {
+            await sink(previous);
+            written += 1;
+        }
+    };
+    return {
+        frame: async (data, atMs) => {
+            if (previous === undefined)
+                previous = data;
+            await fillTo(slotAt(atMs));
+            previous = data;
+        },
+        finish: async (atMs) => {
+            await fillTo(Math.max(slotAt(atMs), written + 1));
+            return written;
+        },
+    };
+}
+//# sourceMappingURL=frame-writer.js.map

package/dist/record/frame-writer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"frame-writer.js","sourceRoot":"","sources":["../../src/record/frame-writer.ts"],"names":[],"mappings":"AAAA,kHAAkH;AAClH,iHAAiH;AAEjH,MAAM,CAAC,MAAM,eAAe,GAAG,EAAE,CAAC;AAIlC,0GAA0G;AAC1G,MAAM,UAAU,WAAW,CAAC,IAAsC,EAAE,SAAiB;IACnF,IAAI,QAA4B,CAAC;IACjC,IAAI,OAAO,GAAG,CAAC,CAAC;IAChB,MAAM,MAAM,GAAG,CAAC,IAAY,EAAU,EAAE,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,GAAG,SAAS,CAAC,GAAG,eAAe,CAAC,GAAG,IAAI,CAAC,CAAC,CAAC;IAChH,MAAM,MAAM,GAAG,KAAK,EAAE,IAAY,EAAiB,EAAE;QACnD,IAAI,QAAQ,KAAK,SAAS;YAAE,OAAO;QACnC,OAAO,OAAO,GAAG,IAAI,EAAE,CAAC;YACtB,MAAM,IAAI,CAAC,QAAQ,CAAC,CAAC;YACrB,OAAO,IAAI,CAAC,CAAC;QACf,CAAC;IACH,CAAC,CAAC;IACF,OAAO;QACL,KAAK,EAAE,KAAK,EAAE,IAAI,EAAE,IAAI,EAAE,EAAE;YAC1B,IAAI,QAAQ,KAAK,SAAS;gBAAE,QAAQ,GAAG,IAAI,CAAC;YAC5C,MAAM,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC;YAC3B,QAAQ,GAAG,IAAI,CAAC;QAClB,CAAC;QACD,MAAM,EAAE,KAAK,EAAE,IAAI,EAAE,EAAE;YACrB,MAAM,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,MAAM,CAAC,IAAI,CAAC,EAAE,OAAO,GAAG,CAAC,CAAC,CAAC,CAAC;YAClD,OAAO,OAAO,CAAC;QACjB,CAAC;KACF,CAAC;AACJ,CAAC"}

package/dist/record/own-port.d.ts

@@ -0,0 +1,2 @@
+export declare function ownPortOf(home: string | undefined): number | null;
+//# sourceMappingURL=own-port.d.ts.map

package/dist/record/own-port.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"own-port.d.ts","sourceRoot":"","sources":["../../src/record/own-port.ts"],"names":[],"mappings":"AAUA,wBAAgB,SAAS,CAAC,IAAI,EAAE,MAAM,GAAG,SAAS,GAAG,MAAM,GAAG,IAAI,CAWjE"}

package/dist/record/own-port.js

@@ -0,0 +1,23 @@
+import { readFileSync } from 'node:fs';
+import path from 'node:path';
+import { z } from '@kvman/sdk';
+// kvman's own port, so a recording never reaches kvman's API as the person (ADR 0107, 18). kvman sets `KVMAN_HOME`
+// in its environment and keeps its port in `<home>/kvman.lock` (plan 01 §1.2, §1.3). With no home, no lock, or a lock
+// without a port, no port is kvman's.
+const lockSchema = z.object({ pid: z.number(), port: z.number().int().positive().optional() });
+export function ownPortOf(home) {
+    if (home === undefined || home === '')
+        return null;
+    let text;
+    try {
+        text = readFileSync(path.join(home, 'kvman.lock'), 'utf8');
+    }
+    catch (error) {
+        if (error instanceof Error && 'code' in error && error.code === 'ENOENT')
+            return null;
+        throw error;
+    }
+    const lock = lockSchema.safeParse(JSON.parse(text));
+    return lock.success && lock.data.port !== undefined ? lock.data.port : null;
+}
+//# sourceMappingURL=own-port.js.map

package/dist/record/own-port.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"own-port.js","sourceRoot":"","sources":["../../src/record/own-port.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AACvC,OAAO,IAAI,MAAM,WAAW,CAAC;AAC7B,OAAO,EAAE,CAAC,EAAE,MAAM,YAAY,CAAC;AAE/B,mHAAmH;AACnH,sHAAsH;AACtH,sCAAsC;AAEtC,MAAM,UAAU,GAAG,CAAC,CAAC,MAAM,CAAC,EAAE,GAAG,EAAE,CAAC,CAAC,MAAM,EAAE,EAAE,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,EAAE,EAAE,CAAC,CAAC;AAE/F,MAAM,UAAU,SAAS,CAAC,IAAwB;IAChD,IAAI,IAAI,KAAK,SAAS,IAAI,IAAI,KAAK,EAAE;QAAE,OAAO,IAAI,CAAC;IACnD,IAAI,IAAY,CAAC;IACjB,IAAI,CAAC;QACH,IAAI,GAAG,YAAY,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,YAAY,CAAC,EAAE,MAAM,CAAC,CAAC;IAC7D,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,IAAI,KAAK,YAAY,KAAK,IAAI,MAAM,IAAI,KAAK,IAAI,KAAK,CAAC,IAAI,KAAK,QAAQ;YAAE,OAAO,IAAI,CAAC;QACtF,MAAM,KAAK,CAAC;IACd,CAAC;IACD,MAAM,IAAI,GAAG,UAAU,CAAC,SAAS,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC;IACpD,OAAO,IAAI,CAAC,OAAO,IAAI,IAAI,CAAC,IAAI,CAAC,IAAI,KAAK,SAAS,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC;AAC9E,CAAC"}

package/dist/record/pointer.d.ts

@@ -0,0 +1,9 @@
+import type { Page } from 'playwright-core';
+export type Pointer = {
+    x: number;
+    y: number;
+};
+export declare function glideTo(page: Page, from: Pointer, to: Pointer): Promise<Pointer>;
+/** The center of the first visible match of a target, scrolled into view. */
+export declare function centerOf(page: Page, target: string): Promise<Pointer>;
+//# sourceMappingURL=pointer.d.ts.map

package/dist/record/pointer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pointer.d.ts","sourceRoot":"","sources":["../../src/record/pointer.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,iBAAiB,CAAC;AAQ5C,MAAM,MAAM,OAAO,GAAG;IAAE,CAAC,EAAE,MAAM,CAAC;IAAC,CAAC,EAAE,MAAM,CAAA;CAAE,CAAC;AAE/C,wBAAsB,OAAO,CAAC,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,OAAO,EAAE,EAAE,EAAE,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC,CAOtF;AAED,6EAA6E;AAC7E,wBAAsB,QAAQ,CAAC,IAAI,EAAE,IAAI,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAO3E"}

package/dist/record/pointer.js

@@ -0,0 +1,23 @@
+// The mouse as the viewer sees it (ADR 0107, 19): it glides to each target over 600 ms, in 30 moves, so the drawn
+// cursor travels instead of jumping.
+const glideMoves = 30;
+const glideMs = 600;
+export async function glideTo(page, from, to) {
+    for (let move = 1; move <= glideMoves; move += 1) {
+        const share = move / glideMoves;
+        await page.mouse.move(from.x + (to.x - from.x) * share, from.y + (to.y - from.y) * share);
+        await page.waitForTimeout(glideMs / glideMoves);
+    }
+    return to;
+}
+/** The center of the first visible match of a target, scrolled into view. */
+export async function centerOf(page, target) {
+    const element = page.locator(target).first();
+    await element.waitFor({ state: 'visible', timeout: 10_000 });
+    await element.scrollIntoViewIfNeeded({ timeout: 10_000 });
+    const box = await element.boundingBox({ timeout: 10_000 });
+    if (box === null)
+        throw new Error(`${target} has no box on the page`);
+    return { x: box.x + box.width / 2, y: box.y + box.height / 2 };
+}
+//# sourceMappingURL=pointer.js.map

package/dist/record/pointer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"pointer.js","sourceRoot":"","sources":["../../src/record/pointer.ts"],"names":[],"mappings":"AAEA,kHAAkH;AAClH,qCAAqC;AAErC,MAAM,UAAU,GAAG,EAAE,CAAC;AACtB,MAAM,OAAO,GAAG,GAAG,CAAC;AAIpB,MAAM,CAAC,KAAK,UAAU,OAAO,CAAC,IAAU,EAAE,IAAa,EAAE,EAAW;IAClE,KAAK,IAAI,IAAI,GAAG,CAAC,EAAE,IAAI,IAAI,UAAU,EAAE,IAAI,IAAI,CAAC,EAAE,CAAC;QACjD,MAAM,KAAK,GAAG,IAAI,GAAG,UAAU,CAAC;QAChC,MAAM,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC,GAAG,IAAI,CAAC,CAAC,CAAC,GAAG,KAAK,EAAE,IAAI,CAAC,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC,GAAG,IAAI,CAAC,CAAC,CAAC,GAAG,KAAK,CAAC,CAAC;QAC1F,MAAM,IAAI,CAAC,cAAc,CAAC,OAAO,GAAG,UAAU,CAAC,CAAC;IAClD,CAAC;IACD,OAAO,EAAE,CAAC;AACZ,CAAC;AAED,6EAA6E;AAC7E,MAAM,CAAC,KAAK,UAAU,QAAQ,CAAC,IAAU,EAAE,MAAc;IACvD,MAAM,OAAO,GAAG,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,KAAK,EAAE,CAAC;IAC7C,MAAM,OAAO,CAAC,OAAO,CAAC,EAAE,KAAK,EAAE,SAAS,EAAE,OAAO,EAAE,MAAM,EAAE,CAAC,CAAC;IAC7D,MAAM,OAAO,CAAC,sBAAsB,CAAC,EAAE,OAAO,EAAE,MAAM,EAAE,CAAC,CAAC;IAC1D,MAAM,GAAG,GAAG,MAAM,OAAO,CAAC,WAAW,CAAC,EAAE,OAAO,EAAE,MAAM,EAAE,CAAC,CAAC;IAC3D,IAAI,GAAG,KAAK,IAAI;QAAE,MAAM,IAAI,KAAK,CAAC,GAAG,MAAM,yBAAyB,CAAC,CAAC;IACtE,OAAO,EAAE,CAAC,EAAE,GAAG,CAAC,CAAC,GAAG,GAAG,CAAC,KAAK,GAAG,CAAC,EAAE,CAAC,EAAE,GAAG,CAAC,CAAC,GAAG,GAAG,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;AACjE,CAAC"}

package/dist/record/recorder.d.ts

@@ -0,0 +1,24 @@
+import type { Browser } from 'playwright-core';
+import { type Program } from '../programs/run-program.ts';
+import type { Step } from './steps.ts';
+export type RecordPlan = {
+    url: string;
+    steps: readonly Step[];
+    width: number;
+    height: number;
+    folder: string;
+    ownPort: number | null;
+    ffmpeg: Program;
+    signal: AbortSignal;
+    now(): number;
+};
+export type Recording = {
+    video: string;
+    durationMs: number;
+    steps: {
+        do: Step['do'];
+        atMs: number;
+    }[];
+};
+export declare function record(browser: Browser, plan: RecordPlan): Promise<Recording>;
+//# sourceMappingURL=recorder.d.ts.map

package/dist/record/recorder.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"recorder.d.ts","sourceRoot":"","sources":["../../src/record/recorder.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,OAAO,EAAwB,MAAM,iBAAiB,CAAC;AAErE,OAAO,EAAa,KAAK,OAAO,EAAE,MAAM,4BAA4B,CAAC;AAQrE,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,YAAY,CAAC;AAMvC,MAAM,MAAM,UAAU,GAAG;IAAE,GAAG,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,SAAS,IAAI,EAAE,CAAC;IAAC,KAAK,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IAAC,MAAM,EAAE,OAAO,CAAC;IAAC,MAAM,EAAE,WAAW,CAAC;IAAC,GAAG,IAAI,MAAM,CAAA;CAAE,CAAC;AAE7L,MAAM,MAAM,SAAS,GAAG;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,UAAU,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE;QAAE,EAAE,EAAE,IAAI,CAAC,IAAI,CAAC,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,EAAE,CAAA;CAAE,CAAC;AAqCzG,wBAAsB,MAAM,CAAC,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,UAAU,GAAG,OAAO,CAAC,SAAS,CAAC,CAqBnF"}

package/dist/record/recorder.js

@@ -0,0 +1,69 @@
+import path from 'node:path';
+import { startPiped } from "../programs/piped-program.js";
+import { lastLines } from "../programs/run-program.js";
+import { kvvideoProblem } from "../problems.js";
+import { isOwnAddress } from "./address.js";
+import { cursorScript } from "./cursor-script.js";
+import { recordEncoderArgs } from "./encoder-args.js";
+import { frameWriter } from "./frame-writer.js";
+import { pausesAfter, runStep } from "./run-step.js";
+import { startScreencast } from "./screencast.js";
+const firstLine = (error) => (error instanceof Error ? (error.message.split('\n').find((line) => line.trim() !== '') ?? error.name) : String(error)).trim();
+async function contextFor(browser, plan) {
+    const context = await browser.newContext({ viewport: { width: plan.width, height: plan.height }, deviceScaleFactor: 1 });
+    await context.route((url) => isOwnAddress(url, plan.ownPort), (route) => route.abort('blockedbyclient'));
+    await context.addInitScript(cursorScript);
+    return context;
+}
+async function open(page, url) {
+    try {
+        await page.goto(url, { waitUntil: 'load', timeout: 30_000 });
+    }
+    catch (error) {
+        throw kvvideoProblem('STEP_FAILED', `The page ${url} didn't load: ${firstLine(error)}`, { step: 0, reason: firstLine(error) });
+    }
+}
+async function play(page, plan, startedAt) {
+    await page.waitForTimeout(500);
+    let pointer = { x: plan.width / 2, y: plan.height / 2 };
+    await page.mouse.move(pointer.x, pointer.y);
+    const done = [];
+    for (const [index, step] of plan.steps.entries()) {
+        done.push({ do: step.do, atMs: Math.round(plan.now() - startedAt) });
+        try {
+            pointer = await runStep(page, step, pointer);
+        }
+        catch (error) {
+            throw kvvideoProblem('STEP_FAILED', `Step ${String(index + 1)} (${step.do}) failed: ${firstLine(error)}`, { step: index + 1, reason: firstLine(error) });
+        }
+        if (pausesAfter(step))
+            await page.waitForTimeout(400);
+    }
+    await page.waitForTimeout(1000);
+    return done;
+}
+export async function record(browser, plan) {
+    const context = await contextFor(browser, plan);
+    const page = await context.newPage();
+    await open(page, plan.url);
+    const video = path.join(plan.folder, 'recording.mp4');
+    const stopEncoder = new AbortController();
+    const encoder = await startPiped(plan.ffmpeg, recordEncoderArgs(plan.width, plan.height, video), AbortSignal.any([plan.signal, stopEncoder.signal]));
+    try {
+        const startedAt = plan.now();
+        const writer = frameWriter((frame) => encoder.write(frame), startedAt);
+        const screencast = await startScreencast(page, plan, (frame, atMs) => writer.frame(frame, atMs), plan.now);
+        const steps = await play(page, plan, startedAt).finally(() => screencast.stop());
+        const endedAt = plan.now();
+        await writer.finish(endedAt);
+        const run = await encoder.end();
+        if (run.exitCode !== 0)
+            throw kvvideoProblem('RENDER_FAILED', `ffmpeg couldn't encode the recording (exit ${String(run.exitCode)}).`, { reason: lastLines(run.output) });
+        return { video, durationMs: Math.round(endedAt - startedAt), steps };
+    }
+    finally {
+        stopEncoder.abort();
+        await context.close();
+    }
+}
+//# sourceMappingURL=recorder.js.map

package/dist/record/recorder.js.map

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

package/dist/record/register-record.d.ts

@@ -0,0 +1,3 @@
+import type { Ctx } from '@kvman/sdk';
+export declare function registerRecord(ctx: Ctx): void;
+//# sourceMappingURL=register-record.d.ts.map

package/dist/record/register-record.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"register-record.d.ts","sourceRoot":"","sources":["../../src/record/register-record.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,GAAG,EAAE,MAAM,YAAY,CAAC;AAetC,wBAAgB,cAAc,CAAC,GAAG,EAAE,GAAG,GAAG,IAAI,CA+B7C"}

package/dist/record/register-record.js

@@ -0,0 +1,49 @@
+import { performance } from 'node:perf_hooks';
+import { launchChannel } from "../browser/launch.js";
+import { startBrowser } from "../browser/start-browser.js";
+import { answerPath } from "../files/answer-path.js";
+import { placeOutput, workFolder } from "../files/place-output.js";
+import { outputPath } from "../files/workspace-paths.js";
+import { programOf } from "../programs/programs.js";
+import { localAddress } from "./address.js";
+import { ownPortOf } from "./own-port.js";
+import { record } from "./recorder.js";
+import { recordInputSchema, recordOutputSchema } from "./steps.js";
+// `video record` (plan 16 §16.5): every address and the output are checked before a browser starts; the browser is
+// closed when the call ends, fails, or is cancelled, and the work folder removed.
+export function registerRecord(ctx) {
+    ctx.registerCommand('kvvideo.clip.record', {
+        description: 'Records a page of an app running on this computer, with its steps, as an MP4 file in the workspace.',
+        input: recordInputSchema,
+        output: recordOutputSchema,
+        public: true,
+        retries: 0,
+        timeoutMs: 600_000,
+        handle: async (input) => {
+            const root = ctx.job.workspace.path;
+            const ownPort = ownPortOf(process.env['KVMAN_HOME']);
+            const url = localAddress(input.url, ownPort).href;
+            for (const step of input.steps ?? [])
+                if (step.do === 'goto')
+                    localAddress(step.url, ownPort);
+            const output = outputPath(root, input.file, '.mp4', input.replace === true);
+            const ffmpeg = await programOf(ctx, 'ffmpeg');
+            const browser = await startBrowser(await ctx.settings.get('kvvideo.browser'), launchChannel);
+            const work = workFolder();
+            const stop = () => void browser.close();
+            ctx.job.signal.addEventListener('abort', stop, { once: true });
+            try {
+                const plan = { url, steps: input.steps ?? [], width: input.width ?? 1280, height: input.height ?? 720, folder: work.folder, ownPort, ffmpeg, signal: ctx.job.signal, now: () => performance.now() };
+                const recording = await record(browser, plan);
+                placeOutput(recording.video, output);
+                return { file: answerPath(root, output), durationMs: recording.durationMs, steps: recording.steps };
+            }
+            finally {
+                ctx.job.signal.removeEventListener('abort', stop);
+                await browser.close();
+                work.remove();
+            }
+        },
+    });
+}
+//# sourceMappingURL=register-record.js.map

package/dist/record/register-record.js.map

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

package/dist/record/run-step.d.ts

@@ -0,0 +1,7 @@
+import type { Page } from 'playwright-core';
+import { type Pointer } from './pointer.ts';
+import type { Step } from './steps.ts';
+export declare function runStep(page: Page, step: Step, pointer: Pointer): Promise<Pointer>;
+/** Whether the page is held a moment after the step, so the viewer sees what it did. */
+export declare function pausesAfter(step: Step): boolean;
+//# sourceMappingURL=run-step.d.ts.map

package/dist/record/run-step.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"run-step.d.ts","sourceRoot":"","sources":["../../src/record/run-step.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,iBAAiB,CAAC;AAC5C,OAAO,EAAqB,KAAK,OAAO,EAAE,MAAM,cAAc,CAAC;AAC/D,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,YAAY,CAAC;AAgBvC,wBAAsB,OAAO,CAAC,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,OAAO,EAAE,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC,CA+BxF;AAED,wFAAwF;AACxF,wBAAgB,WAAW,CAAC,IAAI,EAAE,IAAI,GAAG,OAAO,CAE/C"}

package/dist/record/run-step.js

@@ -0,0 +1,49 @@
+import { centerOf, glideTo } from "./pointer.js";
+// What each step does on the page (plan 16 §16.5). It answers where the mouse is afterwards.
+const scrollStep = 100;
+async function scroll(page, pixels) {
+    let left = pixels;
+    while (left !== 0) {
+        const part = Math.sign(left) * Math.min(scrollStep, Math.abs(left));
+        await page.mouse.wheel(0, part);
+        await page.waitForTimeout(30);
+        left -= part;
+    }
+}
+export async function runStep(page, step, pointer) {
+    switch (step.do) {
+        case 'goto':
+            await page.goto(step.url, { waitUntil: 'load', timeout: 30_000 });
+            return pointer;
+        case 'click': {
+            const at = await glideTo(page, pointer, await centerOf(page, step.target));
+            await page.mouse.click(at.x, at.y);
+            return at;
+        }
+        case 'type': {
+            const at = await glideTo(page, pointer, await centerOf(page, step.target));
+            await page.mouse.click(at.x, at.y);
+            await page.keyboard.type(step.text, { delay: 50 });
+            return at;
+        }
+        case 'press':
+            await page.keyboard.press(step.key);
+            return pointer;
+        case 'hover':
+            return glideTo(page, pointer, await centerOf(page, step.target));
+        case 'scroll':
+            await scroll(page, step.pixels);
+            return pointer;
+        case 'wait':
+            await page.waitForTimeout(step.ms);
+            return pointer;
+        case 'waitFor':
+            await page.locator(step.target).first().waitFor({ state: 'visible', timeout: 10_000 });
+            return pointer;
+    }
+}
+/** Whether the page is held a moment after the step, so the viewer sees what it did. */
+export function pausesAfter(step) {
+    return step.do !== 'wait' && step.do !== 'waitFor';
+}
+//# sourceMappingURL=run-step.js.map

package/dist/record/run-step.js.map

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

package/dist/record/screencast.d.ts

@@ -0,0 +1,9 @@
+import type { Page } from 'playwright-core';
+export type Screencast = {
+    stop(): Promise<void>;
+};
+export declare function startScreencast(page: Page, size: {
+    width: number;
+    height: number;
+}, onFrame: (data: Buffer, atMs: number) => Promise<void>, now: () => number): Promise<Screencast>;
+//# sourceMappingURL=screencast.d.ts.map

package/dist/record/screencast.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"screencast.d.ts","sourceRoot":"","sources":["../../src/record/screencast.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,iBAAiB,CAAC;AAS5C,MAAM,MAAM,UAAU,GAAG;IAAE,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC,CAAA;CAAE,CAAC;AAEnD,wBAAsB,eAAe,CAAC,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,EAAE,OAAO,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,EAAE,GAAG,EAAE,MAAM,MAAM,GAAG,OAAO,CAAC,UAAU,CAAC,CA4BzL"}

package/dist/record/screencast.js

@@ -0,0 +1,38 @@
+import { z } from '@kvman/sdk';
+// The page's screencast (plan 16 §16.5): Chrome sends a JPEG frame when the picture changes, and the next one only
+// after the last is acknowledged, so frames are handled one at a time, in order, at the pace the writer takes them. A
+// frame that can't be handled stops the rest, and `stop` throws its error.
+const frameSchema = z.object({ data: z.string(), sessionId: z.number() });
+export async function startScreencast(page, size, onFrame, now) {
+    const session = await page.context().newCDPSession(page);
+    let handled = Promise.resolve();
+    let stopped = false;
+    let failure;
+    session.on('Page.screencastFrame', (event) => {
+        const frame = frameSchema.parse(event);
+        const atMs = now();
+        handled = handled.then(async () => {
+            if (stopped || failure !== undefined)
+                return;
+            try {
+                await onFrame(Buffer.from(frame.data, 'base64'), atMs);
+                await session.send('Page.screencastFrameAck', { sessionId: frame.sessionId });
+            }
+            catch (error) {
+                failure = error;
+            }
+        });
+    });
+    await session.send('Page.startScreencast', { format: 'jpeg', quality: 90, maxWidth: size.width, maxHeight: size.height, everyNthFrame: 1 });
+    return {
+        stop: async () => {
+            stopped = true;
+            await session.send('Page.stopScreencast');
+            await handled;
+            await session.detach();
+            if (failure !== undefined)
+                throw failure;
+        },
+    };
+}
+//# sourceMappingURL=screencast.js.map

package/dist/record/screencast.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"screencast.js","sourceRoot":"","sources":["../../src/record/screencast.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,CAAC,EAAE,MAAM,YAAY,CAAC;AAE/B,mHAAmH;AACnH,sHAAsH;AACtH,2EAA2E;AAE3E,MAAM,WAAW,GAAG,CAAC,CAAC,MAAM,CAAC,EAAE,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,EAAE,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC;AAI1E,MAAM,CAAC,KAAK,UAAU,eAAe,CAAC,IAAU,EAAE,IAAuC,EAAE,OAAsD,EAAE,GAAiB;IAClK,MAAM,OAAO,GAAG,MAAM,IAAI,CAAC,OAAO,EAAE,CAAC,aAAa,CAAC,IAAI,CAAC,CAAC;IACzD,IAAI,OAAO,GAAkB,OAAO,CAAC,OAAO,EAAE,CAAC;IAC/C,IAAI,OAAO,GAAG,KAAK,CAAC;IACpB,IAAI,OAAgB,CAAC;IACrB,OAAO,CAAC,EAAE,CAAC,sBAAsB,EAAE,CAAC,KAAc,EAAE,EAAE;QACpD,MAAM,KAAK,GAAG,WAAW,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;QACvC,MAAM,IAAI,GAAG,GAAG,EAAE,CAAC;QACnB,OAAO,GAAG,OAAO,CAAC,IAAI,CAAC,KAAK,IAAI,EAAE;YAChC,IAAI,OAAO,IAAI,OAAO,KAAK,SAAS;gBAAE,OAAO;YAC7C,IAAI,CAAC;gBACH,MAAM,OAAO,CAAC,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,EAAE,QAAQ,CAAC,EAAE,IAAI,CAAC,CAAC;gBACvD,MAAM,OAAO,CAAC,IAAI,CAAC,yBAAyB,EAAE,EAAE,SAAS,EAAE,KAAK,CAAC,SAAS,EAAE,CAAC,CAAC;YAChF,CAAC;YAAC,OAAO,KAAK,EAAE,CAAC;gBACf,OAAO,GAAG,KAAK,CAAC;YAClB,CAAC;QACH,CAAC,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;IACH,MAAM,OAAO,CAAC,IAAI,CAAC,sBAAsB,EAAE,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,EAAE,EAAE,QAAQ,EAAE,IAAI,CAAC,KAAK,EAAE,SAAS,EAAE,IAAI,CAAC,MAAM,EAAE,aAAa,EAAE,CAAC,EAAE,CAAC,CAAC;IAC5I,OAAO;QACL,IAAI,EAAE,KAAK,IAAI,EAAE;YACf,OAAO,GAAG,IAAI,CAAC;YACf,MAAM,OAAO,CAAC,IAAI,CAAC,qBAAqB,CAAC,CAAC;YAC1C,MAAM,OAAO,CAAC;YACd,MAAM,OAAO,CAAC,MAAM,EAAE,CAAC;YACvB,IAAI,OAAO,KAAK,SAAS;gBAAE,MAAM,OAAO,CAAC;QAC3C,CAAC;KACF,CAAC;AACJ,CAAC"}

package/dist/record/steps.d.ts

@@ -0,0 +1,71 @@
+import { z } from '@kvman/sdk';
+export declare const stepSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
+    do: z.ZodLiteral<"goto">;
+    url: z.ZodString;
+}, z.core.$strict>, z.ZodObject<{
+    do: z.ZodLiteral<"click">;
+    target: z.ZodString;
+}, z.core.$strict>, z.ZodObject<{
+    do: z.ZodLiteral<"type">;
+    target: z.ZodString;
+    text: z.ZodString;
+}, z.core.$strict>, z.ZodObject<{
+    do: z.ZodLiteral<"press">;
+    key: z.ZodString;
+}, z.core.$strict>, z.ZodObject<{
+    do: z.ZodLiteral<"hover">;
+    target: z.ZodString;
+}, z.core.$strict>, z.ZodObject<{
+    do: z.ZodLiteral<"scroll">;
+    pixels: z.ZodNumber;
+}, z.core.$strict>, z.ZodObject<{
+    do: z.ZodLiteral<"wait">;
+    ms: z.ZodNumber;
+}, z.core.$strict>, z.ZodObject<{
+    do: z.ZodLiteral<"waitFor">;
+    target: z.ZodString;
+}, z.core.$strict>], "do">;
+/** One step of a recording. */
+export type Step = z.output<typeof stepSchema>;
+export declare const recordInputSchema: z.ZodObject<{
+    url: z.ZodString;
+    steps: z.ZodExactOptional<z.ZodArray<z.ZodDiscriminatedUnion<[z.ZodObject<{
+        do: z.ZodLiteral<"goto">;
+        url: z.ZodString;
+    }, z.core.$strict>, z.ZodObject<{
+        do: z.ZodLiteral<"click">;
+        target: z.ZodString;
+    }, z.core.$strict>, z.ZodObject<{
+        do: z.ZodLiteral<"type">;
+        target: z.ZodString;
+        text: z.ZodString;
+    }, z.core.$strict>, z.ZodObject<{
+        do: z.ZodLiteral<"press">;
+        key: z.ZodString;
+    }, z.core.$strict>, z.ZodObject<{
+        do: z.ZodLiteral<"hover">;
+        target: z.ZodString;
+    }, z.core.$strict>, z.ZodObject<{
+        do: z.ZodLiteral<"scroll">;
+        pixels: z.ZodNumber;
+    }, z.core.$strict>, z.ZodObject<{
+        do: z.ZodLiteral<"wait">;
+        ms: z.ZodNumber;
+    }, z.core.$strict>, z.ZodObject<{
+        do: z.ZodLiteral<"waitFor">;
+        target: z.ZodString;
+    }, z.core.$strict>], "do">>>;
+    file: z.ZodString;
+    width: z.ZodExactOptional<z.ZodNumber>;
+    height: z.ZodExactOptional<z.ZodNumber>;
+    replace: z.ZodExactOptional<z.ZodBoolean>;
+}, z.core.$strict>;
+export declare const recordOutputSchema: z.ZodObject<{
+    file: z.ZodString;
+    durationMs: z.ZodNumber;
+    steps: z.ZodArray<z.ZodObject<{
+        do: z.ZodString;
+        atMs: z.ZodNumber;
+    }, z.core.$strip>>;
+}, z.core.$strip>;
+//# sourceMappingURL=steps.d.ts.map

package/dist/record/steps.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"steps.d.ts","sourceRoot":"","sources":["../../src/record/steps.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,YAAY,CAAC;AAO/B,eAAO,MAAM,UAAU;;;;;;;;;;;;;;;;;;;;;;;;;0BASrB,CAAC;AAEH,+BAA+B;AAC/B,MAAM,MAAM,IAAI,GAAG,CAAC,CAAC,MAAM,CAAC,OAAO,UAAU,CAAC,CAAC;AAI/C,eAAO,MAAM,iBAAiB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;kBAO5B,CAAC;AAEH,eAAO,MAAM,kBAAkB;;;;;;;iBAI7B,CAAC"}