@bitmagic/asset-core 0.2.24 → 0.2.25-dev.1

package/dist/trailer/beat-cut.js

@@ -0,0 +1,232 @@
+/**
+ * Snap a shot list onto a beat grid (or plain seconds) and emit an EDL.
+ *
+ * A shot says WHICH source frame to start on and HOW LONG to hold, in beats when there is music
+ * and in seconds when there is not; this turns that into the frame-exact `edl.json` the renderer
+ * consumes. It is the TypeScript port of the make-trailer skill's `beat-edl.py`, so creators need
+ * no Python.
+ *
+ * Each cut's target time comes straight from the beat grid, and the frame count is the difference
+ * against the frames ACTUALLY emitted so far — not against the previous target. That matters for
+ * speed-ramped clips: at 0.5x the output length is forced to an even number of frames, so a clip
+ * whose beat-target is odd lands one frame long. Measuring from actual output makes the next clip
+ * absorb that frame instead of every later cut inheriting it.
+ *
+ * A title cue with `"at": "last-clip"` is resolved to cover the final clip (the end card), so it
+ * survives regeneration without hand-editing output times.
+ */
+import * as fs from 'fs';
+import { TrailerError } from './errors.js';
+import { warn } from './io.js';
+function isRecord(value) {
+    return typeof value === 'object' && value !== null && !Array.isArray(value);
+}
+function finiteNumber(value, ctx) {
+    if (typeof value !== 'number' || !Number.isFinite(value)) {
+        throw new TrailerError(`${ctx}: expected a number, got ${JSON.stringify(value)}`);
+    }
+    return value;
+}
+function parseShot(raw, index) {
+    const ctx = `shots[${index}]`;
+    if (!isRecord(raw))
+        throw new TrailerError(`${ctx}: expected an object`);
+    const shot = {
+        in: finiteNumber(raw.in, `${ctx}.in`),
+        label: typeof raw.label === 'string' && raw.label.length > 0 ? raw.label : `shot ${index + 1}`,
+    };
+    if (shot.in < 0 || !Number.isInteger(shot.in))
+        throw new TrailerError(`${ctx}.in: expected a frame index >= 0`);
+    if (raw.beats !== undefined) {
+        shot.beats = finiteNumber(raw.beats, `${ctx}.beats`);
+        if (shot.beats <= 0)
+            throw new TrailerError(`${ctx}.beats: must be > 0`);
+    }
+    if (raw.seconds !== undefined) {
+        shot.seconds = finiteNumber(raw.seconds, `${ctx}.seconds`);
+        if (shot.seconds <= 0)
+            throw new TrailerError(`${ctx}.seconds: must be > 0`);
+    }
+    if (shot.beats === undefined && shot.seconds === undefined) {
+        throw new TrailerError(`${ctx} ("${shot.label}"): needs "beats" (with music) or "seconds"`);
+    }
+    if (raw.speed !== undefined)
+        shot.speed = finiteNumber(raw.speed, `${ctx}.speed`);
+    if (raw.ui !== undefined) {
+        if (typeof raw.ui !== 'boolean')
+            throw new TrailerError(`${ctx}.ui: expected true or false`);
+        shot.ui = raw.ui;
+    }
+    if (raw.transition !== undefined) {
+        if (raw.transition !== 'cut' && raw.transition !== 'crossfade') {
+            throw new TrailerError(`${ctx}.transition: expected "cut" or "crossfade"`);
+        }
+        shot.transition = raw.transition;
+    }
+    if (raw.transitionDuration !== undefined) {
+        shot.transitionDuration = finiteNumber(raw.transitionDuration, `${ctx}.transitionDuration`);
+    }
+    return shot;
+}
+function parseTitle(raw, index) {
+    const ctx = `titles[${index}]`;
+    if (!isRecord(raw))
+        throw new TrailerError(`${ctx}: expected an object`);
+    if (typeof raw.text !== 'string')
+        throw new TrailerError(`${ctx}.text: expected a string`);
+    const title = { text: raw.text, at: 0 };
+    if (raw.at === 'last-clip')
+        title.at = 'last-clip';
+    else
+        title.at = finiteNumber(raw.at, `${ctx}.at`);
+    if (raw.dur !== undefined)
+        title.dur = finiteNumber(raw.dur, `${ctx}.dur`);
+    if (typeof raw.sub === 'string')
+        title.sub = raw.sub;
+    if (typeof raw.note === 'string')
+        title.note = raw.note;
+    if (raw.style === 'title' || raw.style === 'line' || raw.style === 'card')
+        title.style = raw.style;
+    return title;
+}
+/** Parse a shots document: either a bare array of shots or `{ version, shots, titles? }`. */
+export function parseShots(raw, source) {
+    const shotsRaw = Array.isArray(raw) ? raw : isRecord(raw) ? raw.shots : undefined;
+    if (!Array.isArray(shotsRaw))
+        throw new TrailerError(`${source}: expected a "shots" array`);
+    if (shotsRaw.length === 0)
+        throw new TrailerError(`${source}: "shots" is empty — nothing to cut`);
+    const file = { version: 1, shots: shotsRaw.map(parseShot) };
+    if (isRecord(raw)) {
+        if (raw.version !== undefined && raw.version !== 1) {
+            throw new TrailerError(`${source}: unsupported version ${JSON.stringify(raw.version)} (this CLI writes version 1)`);
+        }
+        if (typeof raw.recording === 'string')
+            file.recording = raw.recording;
+        if (typeof raw.notes === 'string')
+            file.notes = raw.notes;
+        if (raw.titles !== undefined) {
+            if (!Array.isArray(raw.titles))
+                throw new TrailerError(`${source}: "titles" must be an array`);
+            file.titles = raw.titles.map(parseTitle);
+        }
+    }
+    return file;
+}
+export function loadShots(filePath) {
+    if (!fs.existsSync(filePath))
+        throw new TrailerError(`Shots file not found: ${filePath}`);
+    let raw;
+    try {
+        raw = JSON.parse(fs.readFileSync(filePath, 'utf-8'));
+    }
+    catch (err) {
+        throw new TrailerError(`Invalid JSON in ${filePath}: ${err instanceof Error ? err.message : String(err)}`);
+    }
+    return parseShots(raw, filePath);
+}
+/**
+ * Turn shots into frame-exact clips. With `beats` every cut lands on the grid counted from the
+ * downbeat; without, each shot's `seconds` decides its length. Returns the EDL plus the numbers
+ * the command prints so the author can judge the fit.
+ */
+export function cutShots(shots, beats, fps, options = {}) {
+    if (!Number.isFinite(fps) || fps <= 0)
+        throw new TrailerError(`invalid fps: ${fps}`);
+    const grid = beats?.beatTimes ?? null;
+    const start = beats?.downbeatIndex ?? 0;
+    const t0 = grid !== null ? grid[start] : 0;
+    if (grid !== null && (t0 === undefined || grid.length < 2)) {
+        throw new TrailerError('The beat grid has too few beats to cut on — check the music file or pass --bpm.');
+    }
+    const clips = [];
+    let cum = start;
+    let emitted = 0;
+    let worst = 0;
+    let truncatedAt;
+    for (const shot of shots.shots) {
+        const speed = shot.speed ?? 1.0;
+        let need;
+        let suffix;
+        if (grid !== null && shot.beats !== undefined) {
+            const next = cum + shot.beats;
+            if (next >= grid.length) {
+                truncatedAt = shot.label;
+                break;
+            }
+            const target = Math.round((grid[next] - t0) * fps);
+            need = target - emitted;
+            cum = next;
+            suffix = `[${shot.beats}b]`;
+        }
+        else if (shot.seconds !== undefined) {
+            need = Math.round(shot.seconds * fps);
+            suffix = `[${shot.seconds}s]`;
+        }
+        else {
+            throw new TrailerError(`Shot "${shot.label}" is timed in beats but there is no beat grid — pass --music (or --beats), or give it "seconds".`);
+        }
+        const src = Math.max(1, Math.round(need * speed));
+        const actual = Math.round(src / speed);
+        emitted += actual;
+        if (grid !== null && shot.beats !== undefined) {
+            const target = Math.round((grid[cum] - t0) * fps);
+            worst = Math.max(worst, (Math.abs(emitted - target) / fps) * 1000);
+        }
+        let inFrame = shot.in;
+        if (options.frameCount !== undefined && inFrame + src > options.frameCount) {
+            const shifted = Math.max(0, options.frameCount - src);
+            warn(`shot "${shot.label}" runs past the recording's last frame — starting it at ${shifted} instead of ${inFrame}`);
+            inFrame = shifted;
+        }
+        const clip = {
+            in: inFrame,
+            out: inFrame + src,
+            speed,
+            transition: shot.transition ?? 'cut',
+            label: `${shot.label} ${suffix}`,
+        };
+        if (shot.transitionDuration !== undefined)
+            clip.transitionDuration = shot.transitionDuration;
+        if (shot.ui !== undefined)
+            clip.ui = shot.ui;
+        clips.push(clip);
+    }
+    if (clips.length === 0) {
+        throw new TrailerError(`Not a single shot fits the music: "${truncatedAt ?? shots.shots[0].label}" already runs past the end of the track.`);
+    }
+    const totalSec = emitted / fps;
+    const edl = { version: 1, targetDuration: Math.round(totalSec * 100) / 100, clips };
+    if (shots.titles !== undefined && shots.titles.length > 0) {
+        const last = clips[clips.length - 1];
+        const lastDur = Math.round(last.out - last.in) / ((last.speed ?? 1) * fps);
+        edl.titles = shots.titles.map((title) => {
+            const { at, dur, ...rest } = title;
+            if (at === 'last-clip') {
+                return { ...rest, at: Math.round((totalSec - lastDur) * 1000) / 1000, dur: Math.round(lastDur * 1000) / 1000 };
+            }
+            return { ...rest, at, dur: dur ?? 2.5 };
+        });
+    }
+    const result = {
+        edl,
+        beatsUsed: grid !== null ? cum - start : 0,
+        totalSec,
+        worstCutErrorMs: worst,
+    };
+    if (truncatedAt !== undefined)
+        result.truncatedAt = truncatedAt;
+    return result;
+}
+/** The one-line summary `bitmagic trailer cut` prints, mirroring the Python script's. */
+export function describeCut(result, beats) {
+    const parts = [
+        beats !== null ? `bpm=${beats.bpm.toFixed(2)}` : 'no beat grid',
+        `clips=${result.edl.clips.length}`,
+        beats !== null ? `beats=${result.beatsUsed}` : null,
+        `total=${result.totalSec.toFixed(3)}s`,
+        beats !== null ? `worst cut error=${result.worstCutErrorMs.toFixed(1)} ms` : null,
+    ].filter((p) => p !== null);
+    return parts.join('  ');
+}
+//# sourceMappingURL=beat-cut.js.map

package/dist/trailer/beat-cut.js.map

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

package/dist/trailer/capture.d.ts

@@ -0,0 +1,102 @@
+export type CaptureCodec = 'avc' | 'vp9';
+export declare const CHUNK_HEADER_BYTES = 5;
+export declare const CAPTURE_FPS = 60;
+/** Where ffmpeg drops the extracted PNGs before they are renamed onto the recorder's frame indices. */
+export declare const EXTRACT_DIR = ".extract";
+export declare function isCaptureCodec(value: unknown): value is CaptureCodec;
+/** The elementary stream written during the recording. */
+export declare function elementaryName(codec: CaptureCodec): string;
+/** The playable file kept next to the frames. */
+export declare function containerName(codec: CaptureCodec): string;
+export interface ChunkMessage {
+    frameIndex: number;
+    key: boolean;
+    bytes: Buffer;
+}
+/** Split a binary message into its header and chunk bytes; null when it cannot be one. */
+export declare function parseChunkMessage(data: Buffer): ChunkMessage | null;
+/**
+ * Which frame indices arrived. Chrome's encoders emit one chunk per frame in input order, so a
+ * gap here is a frame the recorder itself reported as failed; `finalizeFrames` fills it from a
+ * neighbour after extraction, the way `FrameSequencer` does for raw frames.
+ */
+export declare class ChunkLedger {
+    private next;
+    readonly present: number[];
+    readonly missing: number[];
+    /** Whether this chunk is new (a late or duplicate index is ignored). */
+    accept(frameIndex: number): boolean;
+    /** Mark the tail up to the recorder's declared count as missing. */
+    finish(frameCount: number): void;
+    get received(): number;
+    /** One past the highest index seen (or declared). */
+    get expected(): number;
+}
+/** The 32-byte IVF file header (VP9, timebase 1/60). */
+export declare function ivfHeader(width: number, height: number, frameCount: number): Buffer;
+/** Appends chunks to the elementary stream as they arrive; closes with the IVF count patched in. */
+export declare class CaptureWriter {
+    readonly codec: CaptureCodec;
+    private readonly width;
+    private readonly height;
+    readonly filePath: string;
+    private readonly fd;
+    private frames;
+    private closed;
+    constructor(codec: CaptureCodec, dir: string, width: number, height: number);
+    append(frameIndex: number, bytes: Buffer): void;
+    close(): void;
+}
+/**
+ * `-c copy` into a container. The raw H.264 demuxer would otherwise take its timing from the
+ * encoder's VUI (Chrome's software encoder writes a 120 Hz tick), so the frame rate is forced on
+ * the input and the timestamps regenerated.
+ */
+export declare function remuxArgs(codec: CaptureCodec, dir: string): string[];
+/**
+ * One PNG per decoded frame, in decode order, into `.extract/`. `-vsync 0` (the spelling every
+ * ffmpeg since 4.x accepts) stops ffmpeg from duplicating or dropping frames to hit a rate.
+ */
+export declare function extractArgs(codec: CaptureCodec, dir: string): string[];
+/**
+ * Rename the extracted PNGs onto the frame indices the ledger says they belong to, then fill
+ * every hole up to the declared count by copying the previous frame (or the first one, for a
+ * leading gap) so `<name>_%06d.png` stays aligned with the recorder's frame clock. Returns the
+ * same `{written, missing}` the raw path reports.
+ */
+export declare function finalizeFrames(dir: string, recordingName: string, ledger: ChunkLedger, frameCount: number): {
+    written: number;
+    missing: number[];
+};
+/**
+ * Mirrors game-play-agent's `isSafePathSegment`, additionally refusing the two dot segments its
+ * regex technically admits — `..` would resolve the recording directory to its parent. The
+ * recorder only ever sends `gameplay_recording_<timestamp>`, so nothing real is refused.
+ */
+export declare function isSafeRecordingName(value: string): boolean;
+/** Run ffmpeg to completion; the error text on failure, null on success. Never throws. */
+export declare function runCaptureTool(binary: string, args: string[]): Promise<string | null>;
+export interface FinishCaptureOptions {
+    dir: string;
+    recordingName: string;
+    writer: CaptureWriter;
+    ledger: ChunkLedger;
+    /** The recorder's declared frame count; the ledger's high-water mark when it never said. */
+    frameCount: number | null;
+    /** An error the session already hit (a failed append); skips the ffmpeg steps. */
+    error?: string | null;
+    ffmpegBinary?: string;
+    /** `muxing` once, then `extracting` with the PNG count every two seconds. */
+    onProgress?: (phase: 'muxing' | 'extracting', frames: number) => void;
+}
+/**
+ * After stop: close the elementary stream, remux it into `capture.mp4`/`.webm`, extract one PNG per
+ * frame and put them on the recorder's frame indices (`finalizeFrames`). Resolves with what a
+ * `stopped` reply carries; an ffmpeg failure is reported in `error`, never thrown.
+ */
+export declare function finishCapture(options: FinishCaptureOptions): Promise<{
+    written: number;
+    missing: number[];
+    error: string | null;
+}>;
+//# sourceMappingURL=capture.d.ts.map

package/dist/trailer/capture.d.ts.map

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

package/dist/trailer/capture.js

@@ -0,0 +1,268 @@
+/**
+ * The video side of the recording stream: the file a sink appends encoded chunks to during a
+ * recording, and the ffmpeg steps that turn it into `capture.mp4` and the PNG frames after stop.
+ * Two sinks run it: the CLI's `bitmagic dev` WebSocket (cli/src/editor/recording-stream.ts) and
+ * game-play-agent's chunked-HTTP sink for the web Creator.
+ *
+ * The recorder's worker encodes every frame with WebCodecs (see game/src/debug/RecordStream.ts)
+ * and sends `[frameIndex u32 LE][keyframe u8][chunk bytes]`. H.264 arrives as Annex B — SPS/PPS
+ * inline on every keyframe — so appending the chunks gives a valid `.h264` elementary stream; VP9
+ * has no such framing, so its chunks go into an IVF file (a 32-byte header and a 12-byte header
+ * per frame). Both remux with `-c copy` and both extract the same `<name>_%06d.png` sequence the
+ * trailer pipeline reads, numbered from 0 like every other reader in `@bitmagic/asset-core/trailer`.
+ *
+ * Pure helpers, testable without a socket or ffmpeg, plus `finishCapture`, which runs them.
+ */
+import { spawn } from 'child_process';
+import * as fs from 'fs';
+import * as path from 'path';
+import { frameFileName } from './timeline-types.js';
+export const CHUNK_HEADER_BYTES = 5;
+export const CAPTURE_FPS = 60;
+/** Where ffmpeg drops the extracted PNGs before they are renamed onto the recorder's frame indices. */
+export const EXTRACT_DIR = '.extract';
+export function isCaptureCodec(value) {
+    return value === 'avc' || value === 'vp9';
+}
+/** The elementary stream written during the recording. */
+export function elementaryName(codec) {
+    return codec === 'avc' ? 'capture.h264' : 'capture.ivf';
+}
+/** The playable file kept next to the frames. */
+export function containerName(codec) {
+    return codec === 'avc' ? 'capture.mp4' : 'capture.webm';
+}
+/** Split a binary message into its header and chunk bytes; null when it cannot be one. */
+export function parseChunkMessage(data) {
+    if (data.length <= CHUNK_HEADER_BYTES)
+        return null;
+    return { frameIndex: data.readUInt32LE(0), key: data[4] === 1, bytes: data.subarray(CHUNK_HEADER_BYTES) };
+}
+/**
+ * Which frame indices arrived. Chrome's encoders emit one chunk per frame in input order, so a
+ * gap here is a frame the recorder itself reported as failed; `finalizeFrames` fills it from a
+ * neighbour after extraction, the way `FrameSequencer` does for raw frames.
+ */
+export class ChunkLedger {
+    constructor() {
+        this.next = 0;
+        this.present = [];
+        this.missing = [];
+    }
+    /** Whether this chunk is new (a late or duplicate index is ignored). */
+    accept(frameIndex) {
+        if (frameIndex < this.next)
+            return false;
+        while (this.next < frameIndex) {
+            this.missing.push(this.next);
+            this.next++;
+        }
+        this.present.push(frameIndex);
+        this.next++;
+        return true;
+    }
+    /** Mark the tail up to the recorder's declared count as missing. */
+    finish(frameCount) {
+        while (this.next < frameCount) {
+            this.missing.push(this.next);
+            this.next++;
+        }
+    }
+    get received() {
+        return this.present.length;
+    }
+    /** One past the highest index seen (or declared). */
+    get expected() {
+        return this.next;
+    }
+}
+/** The 32-byte IVF file header (VP9, timebase 1/60). */
+export function ivfHeader(width, height, frameCount) {
+    const header = Buffer.alloc(32);
+    header.write('DKIF', 0, 'ascii');
+    header.writeUInt16LE(0, 4);
+    header.writeUInt16LE(32, 6);
+    header.write('VP90', 8, 'ascii');
+    header.writeUInt16LE(width, 12);
+    header.writeUInt16LE(height, 14);
+    header.writeUInt32LE(CAPTURE_FPS, 16);
+    header.writeUInt32LE(1, 20);
+    header.writeUInt32LE(frameCount, 24);
+    header.writeUInt32LE(0, 28);
+    return header;
+}
+function writeAll(fd, bytes, position) {
+    let offset = 0;
+    while (offset < bytes.length) {
+        offset += fs.writeSync(fd, bytes, offset, bytes.length - offset, position === undefined ? null : position + offset);
+    }
+}
+/** Appends chunks to the elementary stream as they arrive; closes with the IVF count patched in. */
+export class CaptureWriter {
+    constructor(codec, dir, width, height) {
+        this.codec = codec;
+        this.width = width;
+        this.height = height;
+        this.frames = 0;
+        this.closed = false;
+        this.filePath = path.join(dir, elementaryName(codec));
+        this.fd = fs.openSync(this.filePath, 'w');
+        if (codec === 'vp9')
+            writeAll(this.fd, ivfHeader(width, height, 0));
+    }
+    append(frameIndex, bytes) {
+        if (this.closed)
+            return;
+        if (this.codec === 'vp9') {
+            const frameHeader = Buffer.alloc(12);
+            frameHeader.writeUInt32LE(bytes.length, 0);
+            frameHeader.writeBigUInt64LE(BigInt(frameIndex), 4);
+            writeAll(this.fd, frameHeader);
+        }
+        writeAll(this.fd, bytes);
+        this.frames++;
+    }
+    close() {
+        if (this.closed)
+            return;
+        this.closed = true;
+        if (this.codec === 'vp9')
+            writeAll(this.fd, ivfHeader(this.width, this.height, this.frames), 0);
+        fs.closeSync(this.fd);
+    }
+}
+/**
+ * `-c copy` into a container. The raw H.264 demuxer would otherwise take its timing from the
+ * encoder's VUI (Chrome's software encoder writes a 120 Hz tick), so the frame rate is forced on
+ * the input and the timestamps regenerated.
+ */
+export function remuxArgs(codec, dir) {
+    return [
+        '-v', 'error', '-y',
+        '-fflags', '+genpts', '-r', String(CAPTURE_FPS),
+        '-i', path.join(dir, elementaryName(codec)),
+        '-c', 'copy',
+        ...(codec === 'avc' ? ['-movflags', '+faststart'] : []),
+        path.join(dir, containerName(codec)),
+    ];
+}
+/**
+ * One PNG per decoded frame, in decode order, into `.extract/`. `-vsync 0` (the spelling every
+ * ffmpeg since 4.x accepts) stops ffmpeg from duplicating or dropping frames to hit a rate.
+ */
+export function extractArgs(codec, dir) {
+    return [
+        '-v', 'error', '-y',
+        '-i', path.join(dir, containerName(codec)),
+        '-vsync', '0', '-start_number', '0',
+        '-pix_fmt', 'rgb24', '-c:v', 'png', '-compression_level', '1',
+        path.join(dir, EXTRACT_DIR, 'f_%06d.png'),
+    ];
+}
+/**
+ * Rename the extracted PNGs onto the frame indices the ledger says they belong to, then fill
+ * every hole up to the declared count by copying the previous frame (or the first one, for a
+ * leading gap) so `<name>_%06d.png` stays aligned with the recorder's frame clock. Returns the
+ * same `{written, missing}` the raw path reports.
+ */
+export function finalizeFrames(dir, recordingName, ledger, frameCount) {
+    const extractDir = path.join(dir, EXTRACT_DIR);
+    const files = fs.existsSync(extractDir)
+        ? fs.readdirSync(extractDir).filter((name) => /^f_\d{6}\.png$/.test(name)).sort()
+        : [];
+    const missing = new Set(ledger.missing);
+    const have = new Map();
+    ledger.present.forEach((index, i) => {
+        if (i < files.length) {
+            const dest = path.join(dir, frameFileName(recordingName, index));
+            fs.renameSync(path.join(extractDir, files[i]), dest);
+            have.set(index, dest);
+        }
+        else {
+            missing.add(index);
+        }
+    });
+    const total = Math.max(frameCount, ledger.expected);
+    const first = [...have.keys()].sort((a, b) => a - b)[0];
+    let previous = first === undefined ? null : have.get(first);
+    for (let index = 0; index < total; index++) {
+        const own = have.get(index);
+        if (own !== undefined) {
+            previous = own;
+            continue;
+        }
+        missing.add(index);
+        if (previous !== null) {
+            const dest = path.join(dir, frameFileName(recordingName, index));
+            fs.copyFileSync(previous, dest);
+            previous = dest;
+        }
+    }
+    fs.rmSync(extractDir, { recursive: true, force: true });
+    return { written: total, missing: [...missing].sort((a, b) => a - b) };
+}
+/**
+ * Mirrors game-play-agent's `isSafePathSegment`, additionally refusing the two dot segments its
+ * regex technically admits — `..` would resolve the recording directory to its parent. The
+ * recorder only ever sends `gameplay_recording_<timestamp>`, so nothing real is refused.
+ */
+export function isSafeRecordingName(value) {
+    return /^[A-Za-z0-9_\-.]+$/.test(value) && value !== '.' && value !== '..';
+}
+/** Run ffmpeg to completion; the error text on failure, null on success. Never throws. */
+export function runCaptureTool(binary, args) {
+    return new Promise((resolve) => {
+        let child;
+        try {
+            child = spawn(binary, args, { stdio: ['ignore', 'ignore', 'pipe'] });
+        }
+        catch (error) {
+            resolve(`ffmpeg could not start: ${error instanceof Error ? error.message : String(error)}`);
+            return;
+        }
+        let stderr = '';
+        child.stderr.on('data', (chunk) => { stderr = (stderr + chunk.toString()).slice(-4000); });
+        child.on('error', (error) => resolve(`ffmpeg is not available on this machine (${error.message}) — install ffmpeg to record`));
+        child.on('close', (code) => {
+            resolve(code === 0 ? null : `ffmpeg exited with code ${code}: ${stderr.trim().split('\n').slice(-3).join(' | ')}`);
+        });
+    });
+}
+function countPngs(dir) {
+    try {
+        return fs.readdirSync(dir).filter((name) => name.endsWith('.png')).length;
+    }
+    catch {
+        return 0;
+    }
+}
+/**
+ * After stop: close the elementary stream, remux it into `capture.mp4`/`.webm`, extract one PNG per
+ * frame and put them on the recorder's frame indices (`finalizeFrames`). Resolves with what a
+ * `stopped` reply carries; an ffmpeg failure is reported in `error`, never thrown.
+ */
+export async function finishCapture(options) {
+    const { dir, recordingName, writer, ledger } = options;
+    const binary = options.ffmpegBinary ?? 'ffmpeg';
+    writer.close();
+    const declared = options.frameCount ?? ledger.expected;
+    ledger.finish(declared);
+    options.onProgress?.('muxing', 0);
+    let error = options.error ?? null;
+    if (error === null)
+        error = await runCaptureTool(binary, remuxArgs(writer.codec, dir));
+    if (error === null) {
+        fs.rmSync(writer.filePath, { force: true });
+        const extractDir = path.join(dir, EXTRACT_DIR);
+        fs.mkdirSync(extractDir, { recursive: true });
+        const ticker = options.onProgress === undefined
+            ? null
+            : setInterval(() => options.onProgress?.('extracting', countPngs(extractDir)), 2000);
+        error = await runCaptureTool(binary, extractArgs(writer.codec, dir));
+        if (ticker !== null)
+            clearInterval(ticker);
+    }
+    const result = finalizeFrames(dir, recordingName, ledger, declared);
+    return { ...result, error };
+}
+//# sourceMappingURL=capture.js.map

package/dist/trailer/capture.js.map

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