recordable 0.1.0

package/dist/timing.js

@@ -0,0 +1,149 @@
+import { isAbsolute, resolve } from "node:path";
+import { getDuration } from "./ffmpeg.js";
+// ─── Gesture timing (single source of truth) ─────────────────────────────────
+//
+// An interactive action isn't instantaneous: the cursor eases to the target,
+// dips to "press", and a click waits a beat to see if it navigated. The runtime
+// *spends* this time; the voiceover compiler must *predict* it, or every wait it
+// computes is short by a gesture and actions drift late. Both import these
+// constants so the prediction can't silently fall out of step.
+/** Cursor "press" dip on click — scale down… */
+export const PRESS_DOWN_MS = 120;
+/** …then settle back. clickEffect spends their sum. */
+export const PRESS_SETTLE_MS = 60;
+/** Total clickEffect cost. */
+const CLICK_PRESS_MS = PRESS_DOWN_MS + PRESS_SETTLE_MS;
+/** Settle beat between arriving at a target and pressing (jitter base). */
+export const PRE_CLICK_MS = 100;
+/** Post-click probe: how long a click waits for a possible navigation to begin. */
+export const NAV_PROBE_MS = 200;
+/** Cursor-move duration bounds; the move eases from its current position. */
+const CURSOR_MOVE_MIN_MS = 150;
+const CURSOR_MOVE_MAX_MS = 700;
+/** Cursor-move duration for a known pixel distance — eased, clamped. */
+export function cursorMoveMs(dist) {
+    return Math.min(CURSOR_MOVE_MAX_MS, Math.max(CURSOR_MOVE_MIN_MS, dist * 0.5));
+}
+/** Compile-time estimate of a cursor move when the distance can't be known (no
+ *  DOM at compile). A single representative value: the true move is distance-
+ *  based, so a marker may still land a few hundred ms off — the overrun warning
+ *  catches the cases that matter. */
+const CURSOR_MOVE_ESTIMATE_MS = 350;
+/** Estimated wall-clock an interactive action spends getting the cursor to its
+ *  target and pressing — *before* its payload (the keystrokes of a `type`, the
+ *  value-set of a `select`). The compiler adds this to elapsed so the next
+ *  narrated word is placed after the gesture, not on top of it. With the cursor
+ *  overlay off, only the real (non-animated) costs remain. */
+export function gestureLeadMs(step, cfg) {
+    const cursor = cfg.cursor ?? true;
+    const move = cursor ? CURSOR_MOVE_ESTIMATE_MS : 0;
+    const press = cursor ? PRE_CLICK_MS + CLICK_PRESS_MS : 0;
+    switch (step.action) {
+        case "click":
+        case "type":
+        case "clear":
+            // type/clear focus the field with the same move-press-probe as a click.
+            return move + press + NAV_PROBE_MS;
+        case "select":
+            // Animates to the control and presses, but sets the value directly — no
+            // mouse click, so no navigation probe.
+            return move + press;
+        case "hover":
+            return move; // moves only — no press
+        default:
+            return 0; // key / waitFor / pause / … — no cursor travel
+    }
+}
+/** How long an action occupies the timeline, so the next wait measures from its end.
+ *  Omitted durations use the config default, never an elastic fit. The cursor's
+ *  travel-and-press to a target (`gestureLeadMs`) is added on top, so a click/type
+ *  doesn't silently push the rest of the paragraph late. */
+export async function actionDurationMs(step, cfg) {
+    const lead = gestureLeadMs(step, cfg);
+    switch (step.action) {
+        case "wait":
+            return step.ms ?? 0;
+        case "insert": {
+            // An inserted clip advances the recorded timeline by its full length; the
+            // overlaid narration plays across it, so this much audio-relative time is
+            // consumed and the next marker's wait is only the remainder. Resolve the
+            // clip against baseDir, the same as the runtime's `_resolveFile`.
+            const p = step.path;
+            const file = isAbsolute(p) ? p : resolve(cfg.baseDir ?? "", p);
+            return (await getDuration(file)) * 1000;
+        }
+        case "zoom":
+        case "resetZoom":
+            return step.duration ?? cfg.zoomDuration ?? 600;
+        case "scroll":
+            return step.duration ?? cfg.scrollDuration ?? 1200;
+        case "type": {
+            // Travel to the field (lead) then the keystrokes. The runtime's `type` sums
+            // its jittered delays to exactly `typingDuration`, so that part agrees.
+            const keys = step.duration ??
+                typingDuration(step.text ?? "", cfg.typingSpeed ?? 7);
+            return lead + keys;
+        }
+        default:
+            return lead; // click / select / hover travel; key / waitFor … are 0
+    }
+}
+// ─── Randomness ──────────────────────────────────────────────────────────────
+/** Returns `base` ± `variance` (defaults to ±50% of base). */
+export function jitter(base, variance = 0.5) {
+    return base + (Math.random() - 0.5) * base * variance * 2;
+}
+// ─── Deterministic typing ──────────────────────────────────────────────────────
+// `type` is jittered for realism yet deterministic in *total* time: the keystroke
+// delays vary but always sum to `typingDuration`. So the voiceover compiler can
+// predict a `type` action's length from the text alone (no stored duration), and
+// the runtime delivers exactly that.
+/** Deterministic 32-bit string hash (FNV-1a). Seeds the typing PRNG so the same
+ *  text always types with the same rhythm (reproducible recordings). */
+export function hashString(s) {
+    let h = 0x811c9dc5;
+    for (let i = 0; i < s.length; i++) {
+        h ^= s.charCodeAt(i);
+        h = Math.imul(h, 0x01000193);
+    }
+    return h >>> 0;
+}
+/** mulberry32 PRNG → a function yielding floats in [0, 1). Pure integer math,
+ *  platform-independent, so a given seed reproduces the same sequence anywhere. */
+export function rng(seed) {
+    let a = seed >>> 0;
+    return () => {
+        a = (a + 0x6d2b79f5) | 0;
+        let t = Math.imul(a ^ (a >>> 15), 1 | a);
+        t = (t + Math.imul(t ^ (t >>> 7), 61 | t)) ^ t;
+        return ((t ^ (t >>> 14)) >>> 0) / 4294967296;
+    };
+}
+/** Total time (ms) a `type` action occupies — a pure function of text length and
+ *  speed (cps). This is the contract the voiceover compiler estimates against, so
+ *  it MUST stay identical to the compiler's `type` estimate. Jitter never alters it. */
+export function typingDuration(text, speed) {
+    return Math.round((text.length / (speed > 0 ? speed : 1)) * 1000);
+}
+/** Per-keystroke delays (ms) that sum to exactly `total`, with seeded, zero-sum
+ *  jitter. Returns `[leadPause, delayAfterChar1, …]` (lead beat + one per code
+ *  point). Punctuation gets a heavier structural weight (a natural micro-pause),
+ *  but all weights are normalised back onto `total` so the sum is invariant. */
+export function typingGaps(text, speed, total = typingDuration(text, speed), amount = 0.35) {
+    const chars = [...text];
+    if (chars.length === 0)
+        return [];
+    const a = Math.min(Math.max(amount, 0), 0.95); // keep weights strictly positive
+    const next = rng(hashString(text));
+    const LEAD_W = 1.2;
+    const PUNCT_W = 1.8;
+    const perturb = (w) => w * (1 + a * (next() - 0.5) * 2);
+    const weights = [perturb(LEAD_W)];
+    for (const ch of chars) {
+        const structural = ch === " " || ch === "." || ch === "," || ch === "\n" ? PUNCT_W : 1;
+        weights.push(perturb(structural));
+    }
+    const sum = weights.reduce((acc, w) => acc + w, 0);
+    return weights.map((w) => (total * w) / sum);
+}
+//# sourceMappingURL=timing.js.map

package/dist/timing.js.map

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

package/dist/utils.d.ts

@@ -0,0 +1,3 @@
+export declare function sleep(ms: number): Promise<void>;
+export declare function truncate(text: string, max?: number): string;
+//# sourceMappingURL=utils.d.ts.map

package/dist/utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"utils.d.ts","sourceRoot":"","sources":["../src/utils.ts"],"names":[],"mappings":"AAEA,wBAAgB,KAAK,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAE/C;AAED,wBAAgB,QAAQ,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,SAAK,GAAG,MAAM,CAEvD"}

package/dist/utils.js

@@ -0,0 +1,8 @@
+// Tiny, dependency-free helpers shared across layers.
+export function sleep(ms) {
+    return new Promise((r) => setTimeout(r, ms));
+}
+export function truncate(text, max = 40) {
+    return text.length > max ? text.slice(0, max) + "…" : text;
+}
+//# sourceMappingURL=utils.js.map

package/dist/utils.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"utils.js","sourceRoot":"","sources":["../src/utils.ts"],"names":[],"mappings":"AAAA,sDAAsD;AAEtD,MAAM,UAAU,KAAK,CAAC,EAAU;IAC9B,OAAO,IAAI,OAAO,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,UAAU,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC;AAC/C,CAAC;AAED,MAAM,UAAU,QAAQ,CAAC,IAAY,EAAE,GAAG,GAAG,EAAE;IAC7C,OAAO,IAAI,CAAC,MAAM,GAAG,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,GAAG,CAAC,GAAG,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC;AAC7D,CAAC"}

package/dist/validate.d.ts

@@ -0,0 +1,8 @@
+import type { RecordableConfig, VoiceoverConfig } from "./config.js";
+/** Validate a recording-config object (JSON `config`, frontmatter, or a caller).
+ *  Returns it typed; throws {@link RecordableError} `CONFIG_INVALID` on a bad shape. */
+export declare function parseConfig(input: unknown): RecordableConfig;
+/** Validate a `voiceover` frontmatter block. Returns it typed; throws
+ *  {@link RecordableError} `CONFIG_INVALID` on a bad shape. */
+export declare function parseVoiceover(input: unknown): VoiceoverConfig;
+//# sourceMappingURL=validate.d.ts.map

package/dist/validate.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"validate.d.ts","sourceRoot":"","sources":["../src/validate.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,gBAAgB,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AA0CrE;wFACwF;AACxF,wBAAgB,WAAW,CAAC,KAAK,EAAE,OAAO,GAAG,gBAAgB,CAS5D;AAED;+DAC+D;AAC/D,wBAAgB,cAAc,CAAC,KAAK,EAAE,OAAO,GAAG,eAAe,CAS9D"}

package/dist/validate.js

@@ -0,0 +1,54 @@
+import * as z from "zod";
+import { RecordableError } from "./errors.js";
+import { ConfigSchema } from "./config.js";
+// ─── Boundary validation ─────────────────────────────────────────────────────
+//
+// Untrusted config enters from JSON `config` blocks, Markdown frontmatter, and
+// programmatic callers. Zod checks the shape *at the boundary* so a bad value
+// (or a typo'd key) fails with a clear message here, not as a confusing crash
+// deep in a run. Action shapes are validated separately by the manifest in
+// `actions.ts` (which also generates the published JSON Schema) — not duplicated here.
+// Validate against a copy of the config schema with every `.default()` stripped
+// and each field made optional. A provided config then passes through with only
+// its own keys (defaults are applied later, when resolving against DEFAULT_CONFIG),
+// so the config-layering in `Recordable` stays intact. `.partial()` alone is not
+// enough — the inner `.default()` still fills missing keys.
+const ConfigInputSchema = z.strictObject(Object.fromEntries(Object.entries(ConfigSchema.shape).map(([key, field]) => [
+    key,
+    (field instanceof z.ZodDefault ? field.def.innerType : field).optional(),
+])));
+const VoiceoverSchema = z.strictObject({
+    provider: z.string().optional(),
+    voiceId: z.string().optional(),
+    modelId: z.string().optional(),
+    apiKey: z.string().optional(),
+    voiceSettings: z.record(z.string(), z.number()).optional(),
+    format: z.string().optional(),
+});
+/** One readable line per issue: `<label>.<path>: <message>`. */
+function describe(label, issues) {
+    const parts = issues.map((issue) => {
+        const path = issue.path.join(".");
+        return `${path ? `${label}.${path}` : label}: ${issue.message}`;
+    });
+    return parts.join("; ");
+}
+/** Validate a recording-config object (JSON `config`, frontmatter, or a caller).
+ *  Returns it typed; throws {@link RecordableError} `CONFIG_INVALID` on a bad shape. */
+export function parseConfig(input) {
+    const result = ConfigInputSchema.safeParse(input ?? {});
+    if (!result.success) {
+        throw new RecordableError("CONFIG_INVALID", `Invalid config — ${describe("config", result.error.issues)}`);
+    }
+    return result.data;
+}
+/** Validate a `voiceover` frontmatter block. Returns it typed; throws
+ *  {@link RecordableError} `CONFIG_INVALID` on a bad shape. */
+export function parseVoiceover(input) {
+    const result = VoiceoverSchema.safeParse(input ?? {});
+    if (!result.success) {
+        throw new RecordableError("CONFIG_INVALID", `Invalid voiceover config — ${describe("voiceover", result.error.issues)}`);
+    }
+    return result.data;
+}
+//# sourceMappingURL=validate.js.map

package/dist/validate.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"validate.js","sourceRoot":"","sources":["../src/validate.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,CAAC,MAAM,KAAK,CAAC;AACzB,OAAO,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAC9C,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAG3C,gFAAgF;AAChF,EAAE;AACF,+EAA+E;AAC/E,8EAA8E;AAC9E,8EAA8E;AAC9E,2EAA2E;AAC3E,uFAAuF;AAEvF,gFAAgF;AAChF,gFAAgF;AAChF,oFAAoF;AACpF,iFAAiF;AACjF,4DAA4D;AAC5D,MAAM,iBAAiB,GAAG,CAAC,CAAC,YAAY,CACtC,MAAM,CAAC,WAAW,CAChB,MAAM,CAAC,OAAO,CAAC,YAAY,CAAC,KAAK,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,GAAG,EAAE,KAAK,CAAC,EAAE,EAAE,CAAC;IACvD,GAAG;IACH,CAAC,KAAK,YAAY,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC,KAAK,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,QAAQ,EAAE;CACzE,CAAC,CACH,CACF,CAAC;AAEF,MAAM,eAAe,GAAG,CAAC,CAAC,YAAY,CAAC;IACrC,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAC/B,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAC9B,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAC9B,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAC7B,aAAa,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,QAAQ,EAAE;IAC1D,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;CAC9B,CAAC,CAAC;AAEH,gEAAgE;AAChE,SAAS,QAAQ,CAAC,KAAa,EAAE,MAA0B;IACzD,MAAM,KAAK,GAAG,MAAM,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE;QACjC,MAAM,IAAI,GAAG,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;QAClC,OAAO,GAAG,IAAI,CAAC,CAAC,CAAC,GAAG,KAAK,IAAI,IAAI,EAAE,CAAC,CAAC,CAAC,KAAK,KAAK,KAAK,CAAC,OAAO,EAAE,CAAC;IAClE,CAAC,CAAC,CAAC;IACH,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AAC1B,CAAC;AAED;wFACwF;AACxF,MAAM,UAAU,WAAW,CAAC,KAAc;IACxC,MAAM,MAAM,GAAG,iBAAiB,CAAC,SAAS,CAAC,KAAK,IAAI,EAAE,CAAC,CAAC;IACxD,IAAI,CAAC,MAAM,CAAC,OAAO,EAAE,CAAC;QACpB,MAAM,IAAI,eAAe,CACvB,gBAAgB,EAChB,oBAAoB,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC,KAAK,CAAC,MAAM,CAAC,EAAE,CAC9D,CAAC;IACJ,CAAC;IACD,OAAO,MAAM,CAAC,IAAwB,CAAC;AACzC,CAAC;AAED;+DAC+D;AAC/D,MAAM,UAAU,cAAc,CAAC,KAAc;IAC3C,MAAM,MAAM,GAAG,eAAe,CAAC,SAAS,CAAC,KAAK,IAAI,EAAE,CAAC,CAAC;IACtD,IAAI,CAAC,MAAM,CAAC,OAAO,EAAE,CAAC;QACpB,MAAM,IAAI,eAAe,CACvB,gBAAgB,EAChB,8BAA8B,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC,KAAK,CAAC,MAAM,CAAC,EAAE,CAC3E,CAAC;IACJ,CAAC;IACD,OAAO,MAAM,CAAC,IAAI,CAAC;AACrB,CAAC"}

package/dist/video/recorder.d.ts

@@ -0,0 +1,57 @@
+import { type Page } from "puppeteer";
+import { type Logger } from "../logger.js";
+import { type InsertOptions, type ResolvedConfig } from "../config.js";
+import { type Segment } from "./stitch.js";
+/**
+ * Recorded-time position now: finalised segment time plus the in-flight segment's
+ * elapsed time (`frames / fps`). Off-camera (paused) stretches capture no frames,
+ * so they never advance this clock — audio lands in recorded time.
+ */
+export declare function timelineMs(completedMs: number, segmentFrames: number, fps: number, capturing: boolean): number;
+export declare class Recorder {
+    private readonly getCfg;
+    private readonly log;
+    private tmpDirPath;
+    private segmentList;
+    private currentSegment;
+    private cdp;
+    private ffmpegProc;
+    private frameTicker;
+    private latestFrame;
+    private segmentFrames;
+    private segmentFps;
+    private captureError;
+    private completedMs;
+    constructor(getCfg: () => ResolvedConfig, log: Logger);
+    /** True while a segment is actively capturing frames. */
+    get capturing(): boolean;
+    /** The captured + inserted segments, in timeline order (for stitching). */
+    get segments(): Segment[];
+    /** The temp working directory holding segment files. */
+    get tmpDir(): string;
+    /** Recorded-time position now: finalised segments + the in-flight segment. */
+    currentTimelineMs(): number;
+    /** Create the temp working directory for segment files. Call once before use. */
+    init(): void;
+    /** Lazily create the CDP session used for screencast capture. */
+    private _ensureCdp;
+    /** Begin capturing into a fresh segment. No-op if already capturing. */
+    begin(page: Page): Promise<void>;
+    /** End the active segment, flushing ffmpeg and keeping it only if it has frames.
+     *  Pass `silent` to skip the "pause" log (used by `insert`, which seals the
+     *  current segment as an internal step rather than a user-visible pause). */
+    end(silent?: boolean): Promise<void>;
+    /**
+     * Seal the active segment (silently), normalize the clip to the recording's
+     * resolution / fps / codec / pixel format, and append it as the next segment.
+     * Fades (ms) are recorded on the segment and applied at stitch time. Doesn't
+     * touch recording *intent* — if capture was active the run loop lazily begins a
+     * fresh segment before the next action, so recording resumes on its own.
+     */
+    insert(path: string, options?: InsertOptions): Promise<void>;
+    /** Detach the CDP session. Call after the final segment is sealed. */
+    dispose(): Promise<void>;
+    /** Remove the temp working directory. Call once the output is written. */
+    removeTmp(): void;
+}
+//# sourceMappingURL=recorder.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"recorder.d.ts","sourceRoot":"","sources":["../../src/video/recorder.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,KAAK,IAAI,EAAmB,MAAM,WAAW,CAAC;AAGvD,OAAO,EAAE,KAAK,MAAM,EAAE,MAAM,cAAc,CAAC;AAC3C,OAAO,EAAE,KAAK,aAAa,EAAE,KAAK,cAAc,EAAE,MAAM,cAAc,CAAC;AACvE,OAAO,EAAE,KAAK,OAAO,EAAE,MAAM,aAAa,CAAC;AAa3C;;;;GAIG;AACH,wBAAgB,UAAU,CACxB,WAAW,EAAE,MAAM,EACnB,aAAa,EAAE,MAAM,EACrB,GAAG,EAAE,MAAM,EACX,SAAS,EAAE,OAAO,GACjB,MAAM,CAGR;AAED,qBAAa,QAAQ;IAiBjB,OAAO,CAAC,QAAQ,CAAC,MAAM;IACvB,OAAO,CAAC,QAAQ,CAAC,GAAG;IAjBtB,OAAO,CAAC,UAAU,CAAM;IACxB,OAAO,CAAC,WAAW,CAAiB;IACpC,OAAO,CAAC,cAAc,CAAM;IAC5B,OAAO,CAAC,GAAG,CAA2B;IACtC,OAAO,CAAC,UAAU,CAA6B;IAC/C,OAAO,CAAC,WAAW,CAA+C;IAClE,OAAO,CAAC,WAAW,CAAuB;IAC1C,OAAO,CAAC,aAAa,CAAK;IAC1B,OAAO,CAAC,UAAU,CAAK;IAEvB,OAAO,CAAC,YAAY,CAAsB;IAG1C,OAAO,CAAC,WAAW,CAAK;gBAGL,MAAM,EAAE,MAAM,cAAc,EAC5B,GAAG,EAAE,MAAM;IAG9B,yDAAyD;IACzD,IAAI,SAAS,IAAI,OAAO,CAEvB;IAED,2EAA2E;IAC3E,IAAI,QAAQ,IAAI,OAAO,EAAE,CAExB;IAED,wDAAwD;IACxD,IAAI,MAAM,IAAI,MAAM,CAEnB;IAED,8EAA8E;IAC9E,iBAAiB,IAAI,MAAM;IAK3B,iFAAiF;IACjF,IAAI,IAAI,IAAI;IAIZ,iEAAiE;YACnD,UAAU;IAaxB,wEAAwE;IAClE,KAAK,CAAC,IAAI,EAAE,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC;IAsEtC;;iFAE6E;IACvE,GAAG,CAAC,MAAM,UAAQ,GAAG,OAAO,CAAC,IAAI,CAAC;IA2CxC;;;;;;OAMG;IACG,MAAM,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,GAAE,aAAkB,GAAG,OAAO,CAAC,IAAI,CAAC;IAuCtE,sEAAsE;IAChE,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;IAO9B,0EAA0E;IAC1E,SAAS,IAAI,IAAI;CAGlB"}

package/dist/video/recorder.js

@@ -0,0 +1,238 @@
+import { spawn } from "node:child_process";
+import { existsSync, mkdtempSync, rmSync } from "node:fs";
+import { join } from "node:path";
+import { tmpdir } from "node:os";
+import { FFMPEG_PATH, getDuration, runFfmpeg } from "../ffmpeg.js";
+import { RecordableError } from "../errors.js";
+// ─── Video layer: capture ────────────────────────────────────────────────────
+//
+// Captures the page via CDP `Page.startScreencast`, pipes JPEG frames into ffmpeg
+// at a steady fps to produce one MP4 per captured stretch, and tracks the
+// recorded-time clock the audio layer positions clips against. Stitching the
+// segments into the final video lives in `./stitch.ts`.
+//
+// Segments are started lazily and ended on pause, so off-camera gaps (page loads,
+// logins, data setup) leave no trace. Config is read through `getCfg` on each call
+// so runtime changes take effect.
+/**
+ * Recorded-time position now: finalised segment time plus the in-flight segment's
+ * elapsed time (`frames / fps`). Off-camera (paused) stretches capture no frames,
+ * so they never advance this clock — audio lands in recorded time.
+ */
+export function timelineMs(completedMs, segmentFrames, fps, capturing) {
+    const current = capturing && fps > 0 ? (segmentFrames / fps) * 1000 : 0;
+    return completedMs + current;
+}
+export class Recorder {
+    getCfg;
+    log;
+    tmpDirPath = "";
+    segmentList = [];
+    currentSegment = "";
+    cdp = null;
+    ffmpegProc = null;
+    frameTicker = null;
+    latestFrame = null;
+    segmentFrames = 0;
+    segmentFps = 0;
+    // A spawn/encode failure on the capture ffmpeg, surfaced at the next end().
+    captureError = null;
+    // Timeline clock (recorded time, ms) summed over finalised segments.
+    completedMs = 0;
+    constructor(getCfg, log) {
+        this.getCfg = getCfg;
+        this.log = log;
+    }
+    /** True while a segment is actively capturing frames. */
+    get capturing() {
+        return this.ffmpegProc !== null;
+    }
+    /** The captured + inserted segments, in timeline order (for stitching). */
+    get segments() {
+        return this.segmentList;
+    }
+    /** The temp working directory holding segment files. */
+    get tmpDir() {
+        return this.tmpDirPath;
+    }
+    /** Recorded-time position now: finalised segments + the in-flight segment. */
+    currentTimelineMs() {
+        const fps = this.segmentFps || this.getCfg().fps;
+        return timelineMs(this.completedMs, this.segmentFrames, fps, this.capturing);
+    }
+    /** Create the temp working directory for segment files. Call once before use. */
+    init() {
+        this.tmpDirPath = mkdtempSync(join(tmpdir(), "recordable-"));
+    }
+    /** Lazily create the CDP session used for screencast capture. */
+    async _ensureCdp(page) {
+        if (this.cdp)
+            return this.cdp;
+        const cdp = await page.createCDPSession();
+        cdp.on("Page.screencastFrame", (frame) => {
+            this.latestFrame = Buffer.from(frame.data, "base64");
+            cdp
+                .send("Page.screencastFrameAck", { sessionId: frame.sessionId })
+                .catch(() => { });
+        });
+        this.cdp = cdp;
+        return cdp;
+    }
+    /** Begin capturing into a fresh segment. No-op if already capturing. */
+    async begin(page) {
+        if (this.ffmpegProc)
+            return;
+        const cfg = this.getCfg();
+        const idx = this.segmentList.length;
+        const file = join(this.tmpDirPath, `seg-${String(idx).padStart(3, "0")}.mp4`);
+        const { width, height } = cfg.viewport;
+        const fps = cfg.fps;
+        // Encode a stream of JPEG frames piped on stdin into an MP4 segment.
+        const proc = spawn(FFMPEG_PATH, [
+            "-y",
+            "-f",
+            "image2pipe",
+            "-framerate",
+            String(fps),
+            "-i",
+            "pipe:0",
+            "-r",
+            String(fps),
+            "-c:v",
+            cfg.videoCodec,
+            "-preset",
+            cfg.videoPreset,
+            "-crf",
+            String(cfg.videoCrf),
+            "-pix_fmt",
+            "yuv420p",
+            "-vf",
+            "pad=ceil(iw/2)*2:ceil(ih/2)*2", // libx264 needs even dimensions
+            file,
+        ], { stdio: ["pipe", "ignore", "ignore"] });
+        proc.on("error", (e) => {
+            // Encoding is async; remember the failure and surface it at end() rather
+            // than silently dropping a frameless, invalid segment.
+            this.captureError = e;
+            this.log.error(`ffmpeg: ${String(e)}`);
+        });
+        this.ffmpegProc = proc;
+        this.currentSegment = file;
+        this.segmentFrames = 0;
+        this.segmentFps = fps;
+        this.latestFrame = null;
+        // Begin the screencast and push the most recent frame at a steady fps so the
+        // output is constant-frame-rate even when the page is idle.
+        const cdp = await this._ensureCdp(page);
+        await cdp.send("Page.startScreencast", {
+            format: "jpeg",
+            quality: 90,
+            maxWidth: width,
+            maxHeight: height,
+            everyNthFrame: 1,
+        });
+        this.frameTicker = setInterval(() => {
+            const p = this.ffmpegProc;
+            if (!p || !p.stdin?.writable || !this.latestFrame)
+                return;
+            p.stdin.write(this.latestFrame);
+            this.segmentFrames++;
+        }, Math.max(1, Math.round(1000 / fps)));
+        this.log("Record", idx === 0 ? "start" : `resume (segment ${idx + 1})`);
+    }
+    /** End the active segment, flushing ffmpeg and keeping it only if it has frames.
+     *  Pass `silent` to skip the "pause" log (used by `insert`, which seals the
+     *  current segment as an internal step rather than a user-visible pause). */
+    async end(silent = false) {
+        if (!this.ffmpegProc)
+            return;
+        if (this.frameTicker) {
+            clearInterval(this.frameTicker);
+            this.frameTicker = null;
+        }
+        await this.cdp?.send("Page.stopScreencast").catch(() => { });
+        const proc = this.ffmpegProc;
+        this.ffmpegProc = null;
+        const frames = this.segmentFrames;
+        // Flush stdin and wait for ffmpeg to finish writing the file.
+        await new Promise((resolve) => {
+            proc.once("close", () => resolve());
+            try {
+                proc.stdin?.end();
+            }
+            catch {
+                resolve();
+            }
+        });
+        if (this.captureError) {
+            const e = this.captureError;
+            this.captureError = null;
+            throw new RecordableError("FFMPEG_FAILED", `recording capture failed: ${e.message}`, { cause: e });
+        }
+        // Only keep segments that actually captured frames (avoids empty/invalid mp4).
+        if (this.currentSegment && frames > 0) {
+            this.segmentList.push({ path: this.currentSegment, fadeIn: 0, fadeOut: 0 });
+            this.completedMs +=
+                (frames / (this.segmentFps || this.getCfg().fps)) * 1000;
+        }
+        this.currentSegment = "";
+        this.latestFrame = null;
+        if (!silent)
+            this.log("Record", "pause");
+    }
+    /**
+     * Seal the active segment (silently), normalize the clip to the recording's
+     * resolution / fps / codec / pixel format, and append it as the next segment.
+     * Fades (ms) are recorded on the segment and applied at stitch time. Doesn't
+     * touch recording *intent* — if capture was active the run loop lazily begins a
+     * fresh segment before the next action, so recording resumes on its own.
+     */
+    async insert(path, options = {}) {
+        if (!existsSync(path))
+            throw new RecordableError("FILE_NOT_FOUND", `insert: file not found: ${path}`);
+        await this.end(true);
+        const cfg = this.getCfg();
+        const idx = this.segmentList.length;
+        const file = join(this.tmpDirPath, `seg-${String(idx).padStart(3, "0")}.mp4`);
+        const { width, height } = cfg.viewport;
+        // Letterbox-fit to the viewport and conform fps/codec/pixel format so the clip
+        // is concat-compatible with the captured segments.
+        await runFfmpeg([
+            "-y",
+            "-i",
+            path,
+            "-an",
+            "-vf",
+            `scale=${width}:${height}:force_original_aspect_ratio=decrease,` +
+                `pad=${width}:${height}:(ow-iw)/2:(oh-ih)/2,setsar=1,fps=${cfg.fps}`,
+            "-c:v",
+            cfg.videoCodec,
+            "-preset",
+            cfg.videoPreset,
+            "-crf",
+            String(cfg.videoCrf),
+            "-pix_fmt",
+            "yuv420p",
+            file,
+        ]);
+        this.segmentList.push({
+            path: file,
+            fadeIn: Math.max(0, options.fadeIn ?? 0) / 1000,
+            fadeOut: Math.max(0, options.fadeOut ?? 0) / 1000,
+        });
+        this.completedMs += (await getDuration(file)) * 1000;
+    }
+    /** Detach the CDP session. Call after the final segment is sealed. */
+    async dispose() {
+        if (this.cdp) {
+            await this.cdp.detach().catch(() => { });
+            this.cdp = null;
+        }
+    }
+    /** Remove the temp working directory. Call once the output is written. */
+    removeTmp() {
+        if (this.tmpDirPath)
+            rmSync(this.tmpDirPath, { recursive: true, force: true });
+    }
+}
+//# sourceMappingURL=recorder.js.map

package/dist/video/recorder.js.map

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

package/dist/video/stitch.d.ts

@@ -0,0 +1,15 @@
+import { type Logger } from "../logger.js";
+import type { ResolvedConfig } from "../config.js";
+/**
+ * One piece of the final timeline: a captured stretch or an inserted clip.
+ * `fadeIn`/`fadeOut` (seconds) are non-zero only for inserted clips and request
+ * a cross-fade with the neighbouring piece (or with black at the timeline ends).
+ */
+export interface Segment {
+    path: string;
+    fadeIn: number;
+    fadeOut: number;
+}
+/** Stitch `segs` into `out`, choosing move / join / cross-fade automatically. */
+export declare function stitch(segs: Segment[], cfg: ResolvedConfig, log: Logger, out: string, tmpDir: string): Promise<void>;
+//# sourceMappingURL=stitch.d.ts.map

package/dist/video/stitch.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"stitch.d.ts","sourceRoot":"","sources":["../../src/video/stitch.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,KAAK,MAAM,EAAE,MAAM,cAAc,CAAC;AAC3C,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AASnD;;;;GAIG;AACH,MAAM,WAAW,OAAO;IACtB,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,iFAAiF;AACjF,wBAAsB,MAAM,CAC1B,IAAI,EAAE,OAAO,EAAE,EACf,GAAG,EAAE,cAAc,EACnB,GAAG,EAAE,MAAM,EACX,GAAG,EAAE,MAAM,EACX,MAAM,EAAE,MAAM,GACb,OAAO,CAAC,IAAI,CAAC,CASf"}