@vforsh/argus-watcher 0.5.2 → 0.5.4

package/dist/cdp/ffmpeg.d.ts

@@ -4,16 +4,19 @@ import type { RecordFormat } from '@vforsh/argus-core';
 import type { VisualCaptureClip, VisualCaptureViewport } from './visualCapture.js';
 /**
  * The ffmpeg side of screen recording: spawning the encoder, building its arguments, and reading
- * the PNG frame headers that size its filter graph.
+ * the frame headers that size its filter graph.
  *
  * Split out of `recording.ts` because none of it touches CDP — the recorder pipes frames into a
  * child process, and that process's argument construction, stderr ring, and ENOENT phrasing are a
  * separate concern from screencast frame pacing.
  */
-/** Dimensions read from a PNG screencast frame. */
-export type PngSize = {
+/** Wire format of the screencast frames piped into ffmpeg. */
+export type FrameCodec = 'png' | 'jpeg';
+/** Dimensions and encoding read from a screencast frame. */
+export type FrameInfo = {
     width: number;
     height: number;
+    codec: FrameCodec;
 };
 type FfmpegChild = ChildProcessByStdio<Writable, null, Readable>;
 /** A running ffmpeg encoder and a promise for its exit. */
@@ -22,16 +25,29 @@ export type FfmpegProcess = {
     /** Resolves on a clean exit; rejects with the tail of stderr otherwise. */
     completion: Promise<void>;
 };
-/** Spawn ffmpeg to encode a PNG frame stream, resolving once the child has actually spawned. */
+/** Spawn ffmpeg to encode a screencast frame stream, resolving once the child has actually spawned. */
 export declare const startFfmpeg: (options: {
     absolutePath: string;
     fps: number;
     format: RecordFormat;
     clip: VisualCaptureClip | undefined;
     viewport: VisualCaptureViewport | undefined;
-    frameSize: PngSize;
+    frame: FrameInfo;
 }) => Promise<FfmpegProcess>;
-export declare const readPngSize: (buffer: Buffer) => PngSize;
+/**
+ * Read the encoding and pixel dimensions of a screencast frame.
+ *
+ * The codec is *detected*, never assumed from the `Page.startScreencast` request: ffmpeg is told
+ * up front which decoder sits on the pipe, and if that disagrees with the bytes it gets, every
+ * frame fails to decode and the encode dies with an empty file. Chrome is not the only producer
+ * here — test fakes and future capture paths feed this too — so the frames are the authority.
+ *
+ * The size matters because a CSS-pixel crop rectangle has to be translated into encoder
+ * coordinates, and the screencast reports no device pixel ratio worth trusting across DPR changes.
+ *
+ * @throws {Error} When the buffer is not a recognizable PNG or JPEG.
+ */
+export declare const readFrameInfo: (buffer: Buffer) => FrameInfo;
 export declare const formatFfmpegError: (error: unknown) => Error;
 export {};
 //# sourceMappingURL=ffmpeg.d.ts.map

package/dist/cdp/ffmpeg.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"ffmpeg.d.ts","sourceRoot":"","sources":["../../src/cdp/ffmpeg.ts"],"names":[],"mappings":"AAAA,OAAO,EAAS,KAAK,mBAAmB,EAAE,MAAM,oBAAoB,CAAA;AACpE,OAAO,KAAK,EAAE,QAAQ,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAA;AACrD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAA;AACtD,OAAO,KAAK,EAAE,iBAAiB,EAAE,qBAAqB,EAAE,MAAM,oBAAoB,CAAA;AAElF;;;;;;;GAOG;AAEH,mDAAmD;AACnD,MAAM,MAAM,OAAO,GAAG;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,CAAA;AAEvD,KAAK,WAAW,GAAG,mBAAmB,CAAC,QAAQ,EAAE,IAAI,EAAE,QAAQ,CAAC,CAAA;AAEhE,2DAA2D;AAC3D,MAAM,MAAM,aAAa,GAAG;IAC3B,KAAK,EAAE,WAAW,CAAA;IAClB,2EAA2E;IAC3E,UAAU,EAAE,OAAO,CAAC,IAAI,CAAC,CAAA;CACzB,CAAA;AAED,gGAAgG;AAChG,eAAO,MAAM,WAAW,GAAU,SAAS;IAC1C,YAAY,EAAE,MAAM,CAAA;IACpB,GAAG,EAAE,MAAM,CAAA;IACX,MAAM,EAAE,YAAY,CAAA;IACpB,IAAI,EAAE,iBAAiB,GAAG,SAAS,CAAA;IACnC,QAAQ,EAAE,qBAAqB,GAAG,SAAS,CAAA;IAC3C,SAAS,EAAE,OAAO,CAAA;CAClB,KAAG,OAAO,CAAC,aAAa,CA+CxB,CAAA;AAgCD,eAAO,MAAM,WAAW,GAAI,QAAQ,MAAM,KAAG,OAmB5C,CAAA;AAOD,eAAO,MAAM,iBAAiB,GAAI,OAAO,OAAO,KAAG,KAMlD,CAAA"}
+{"version":3,"file":"ffmpeg.d.ts","sourceRoot":"","sources":["../../src/cdp/ffmpeg.ts"],"names":[],"mappings":"AAAA,OAAO,EAAS,KAAK,mBAAmB,EAAE,MAAM,oBAAoB,CAAA;AACpE,OAAO,KAAK,EAAE,QAAQ,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAA;AACrD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAA;AACtD,OAAO,KAAK,EAAE,iBAAiB,EAAE,qBAAqB,EAAE,MAAM,oBAAoB,CAAA;AAElF;;;;;;;GAOG;AAEH,8DAA8D;AAC9D,MAAM,MAAM,UAAU,GAAG,KAAK,GAAG,MAAM,CAAA;AAEvC,4DAA4D;AAC5D,MAAM,MAAM,SAAS,GAAG;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,UAAU,CAAA;CAAE,CAAA;AAE5E,KAAK,WAAW,GAAG,mBAAmB,CAAC,QAAQ,EAAE,IAAI,EAAE,QAAQ,CAAC,CAAA;AAEhE,2DAA2D;AAC3D,MAAM,MAAM,aAAa,GAAG;IAC3B,KAAK,EAAE,WAAW,CAAA;IAClB,2EAA2E;IAC3E,UAAU,EAAE,OAAO,CAAC,IAAI,CAAC,CAAA;CACzB,CAAA;AAED,uGAAuG;AACvG,eAAO,MAAM,WAAW,GAAU,SAAS;IAC1C,YAAY,EAAE,MAAM,CAAA;IACpB,GAAG,EAAE,MAAM,CAAA;IACX,MAAM,EAAE,YAAY,CAAA;IACpB,IAAI,EAAE,iBAAiB,GAAG,SAAS,CAAA;IACnC,QAAQ,EAAE,qBAAqB,GAAG,SAAS,CAAA;IAC3C,KAAK,EAAE,SAAS,CAAA;CAChB,KAAG,OAAO,CAAC,aAAa,CA8CxB,CAAA;AAqDD;;;;;;;;;;;;GAYG;AACH,eAAO,MAAM,aAAa,GAAI,QAAQ,MAAM,KAAG,SAW9C,CAAA;AAsDD,eAAO,MAAM,iBAAiB,GAAI,OAAO,OAAO,KAAG,KAMlD,CAAA"}

package/dist/cdp/ffmpeg.js

@@ -1,8 +1,7 @@
 import { spawn } from 'node:child_process';
-/** Spawn ffmpeg to encode a PNG frame stream, resolving once the child has actually spawned. */
+/** Spawn ffmpeg to encode a screencast frame stream, resolving once the child has actually spawned. */
 export const startFfmpeg = async (options) => {
     const ffmpeg = process.env.ARGUS_FFMPEG?.trim() || 'ffmpeg';
-    const filter = buildVideoFilter(options);
     const args = [
         '-hide_banner',
         '-loglevel',
@@ -12,12 +11,12 @@ export const startFfmpeg = async (options) => {
         '-framerate',
         String(options.fps),
         '-vcodec',
-        'png',
+        options.frame.codec === 'jpeg' ? 'mjpeg' : 'png',
         '-i',
         'pipe:0',
         '-an',
         '-vf',
-        filter,
+        buildVideoFilter(options),
         ...buildEncoderArgs(options.format),
         '-y',
         options.absolutePath,
@@ -46,43 +45,104 @@ export const startFfmpeg = async (options) => {
     return { child, completion };
 };
 const buildVideoFilter = (options) => {
-    if (!options.clip) {
-        return 'scale=trunc(iw/2)*2:trunc(ih/2)*2,format=yuv420p';
+    const geometry = options.clip ? buildCropFilter(options.clip, options.viewport, options.frame) : 'scale=trunc(iw/2)*2:trunc(ih/2)*2';
+    if (options.format !== 'gif') {
+        return `${geometry},format=yuv420p`;
     }
-    if (!options.viewport) {
+    /**
+     * One-pass palette generation, because the frames arrive on a pipe.
+     *
+     * The usual high-quality GIF recipe runs `palettegen` over the whole file and only then
+     * `paletteuse`, which needs two passes over a seekable input. A live screencast has neither,
+     * so this builds a palette per frame (`stats_mode=single`) and tells `paletteuse` to expect a
+     * new one each time (`new=1`). Slightly larger files than a global palette, no second pass,
+     * and no banding on the gradients that make up most app UI.
+     */
+    return `${geometry},split[gifsrc][gifpal];[gifpal]palettegen=stats_mode=single[pal];[gifsrc][pal]paletteuse=new=1:dither=sierra2_4a`;
+};
+const buildCropFilter = (clip, viewport, frameSize) => {
+    if (!viewport) {
         throw new Error('Unable to compute viewport size for recording crop');
     }
-    const ratioX = options.frameSize.width / options.viewport.width;
-    const ratioY = options.frameSize.height / options.viewport.height;
-    const x = clampEven(options.clip.x * ratioX, 0, options.frameSize.width - 2);
-    const y = clampEven(options.clip.y * ratioY, 0, options.frameSize.height - 2);
-    const width = clampEven(options.clip.width * ratioX, 2, options.frameSize.width - x);
-    const height = clampEven(options.clip.height * ratioY, 2, options.frameSize.height - y);
-    return `crop=${width}:${height}:${x}:${y},format=yuv420p`;
+    const ratioX = frameSize.width / viewport.width;
+    const ratioY = frameSize.height / viewport.height;
+    const x = clampEven(clip.x * ratioX, 0, frameSize.width - 2);
+    const y = clampEven(clip.y * ratioY, 0, frameSize.height - 2);
+    const width = clampEven(clip.width * ratioX, 2, frameSize.width - x);
+    const height = clampEven(clip.height * ratioY, 2, frameSize.height - y);
+    return `crop=${width}:${height}:${x}:${y}`;
 };
 const buildEncoderArgs = (format) => {
+    if (format === 'gif') {
+        return ['-loop', '0', '-f', 'gif'];
+    }
     if (format === 'webm') {
-        return ['-c:v', 'libvpx', '-deadline', 'realtime', '-cpu-used', '5', '-b:v', '1M', '-f', 'webm'];
+        // VP9 at constant quality: the old flat 1M VP8 bitrate smeared any 2x-DPR canvas.
+        return ['-c:v', 'libvpx-vp9', '-deadline', 'realtime', '-cpu-used', '5', '-crf', '32', '-b:v', '0', '-row-mt', '1', '-f', 'webm'];
     }
     // yuv420p + H.264 keeps files playable in Finder, QuickTime, iOS Photos, Slack, and browsers.
     return ['-c:v', 'libx264', '-preset', 'veryfast', '-crf', '23', '-movflags', '+faststart', '-f', 'mp4'];
 };
-export const readPngSize = (buffer) => {
-    if (buffer.length < 24 ||
-        buffer[0] !== 0x89 ||
-        buffer[1] !== 0x50 ||
-        buffer[2] !== 0x4e ||
-        buffer[3] !== 0x47 ||
-        buffer[4] !== 0x0d ||
-        buffer[5] !== 0x0a ||
-        buffer[6] !== 0x1a ||
-        buffer[7] !== 0x0a) {
-        throw new Error('Expected PNG screencast frame');
+/**
+ * Read the encoding and pixel dimensions of a screencast frame.
+ *
+ * The codec is *detected*, never assumed from the `Page.startScreencast` request: ffmpeg is told
+ * up front which decoder sits on the pipe, and if that disagrees with the bytes it gets, every
+ * frame fails to decode and the encode dies with an empty file. Chrome is not the only producer
+ * here — test fakes and future capture paths feed this too — so the frames are the authority.
+ *
+ * The size matters because a CSS-pixel crop rectangle has to be translated into encoder
+ * coordinates, and the screencast reports no device pixel ratio worth trusting across DPR changes.
+ *
+ * @throws {Error} When the buffer is not a recognizable PNG or JPEG.
+ */
+export const readFrameInfo = (buffer) => {
+    if (isPng(buffer)) {
+        return { width: buffer.readUInt32BE(16), height: buffer.readUInt32BE(20), codec: 'png' };
+    }
+    const jpegSize = readJpegSize(buffer);
+    if (jpegSize) {
+        return { ...jpegSize, codec: 'jpeg' };
+    }
+    throw new Error('Expected a PNG or JPEG screencast frame');
+};
+const isPng = (buffer) => buffer.length >= 24 &&
+    buffer[0] === 0x89 &&
+    buffer[1] === 0x50 &&
+    buffer[2] === 0x4e &&
+    buffer[3] === 0x47 &&
+    buffer[4] === 0x0d &&
+    buffer[5] === 0x0a &&
+    buffer[6] === 0x1a &&
+    buffer[7] === 0x0a;
+/** Frame-header markers (SOF0-SOF15) that carry dimensions, minus the four that are not frame headers. */
+const JPEG_NON_SOF_MARKERS = new Set([0xc4, 0xc8, 0xcc]);
+const readJpegSize = (buffer) => {
+    if (buffer.length < 4 || buffer[0] !== 0xff || buffer[1] !== 0xd8) {
+        return null;
+    }
+    let offset = 2;
+    while (offset + 3 < buffer.length) {
+        if (buffer[offset] !== 0xff) {
+            offset += 1;
+            continue;
+        }
+        const marker = buffer[offset + 1];
+        // Padding fill bytes and the standalone markers carry no length field.
+        if (marker === 0xff || marker === 0x01 || (marker >= 0xd0 && marker <= 0xd9)) {
+            offset += 2;
+            continue;
+        }
+        const segmentLength = buffer.readUInt16BE(offset + 2);
+        if (marker >= 0xc0 && marker <= 0xcf && !JPEG_NON_SOF_MARKERS.has(marker)) {
+            if (offset + 9 > buffer.length) {
+                return null;
+            }
+            return { width: buffer.readUInt16BE(offset + 7), height: buffer.readUInt16BE(offset + 5) };
+        }
+        offset += 2 + segmentLength;
     }
-    return {
-        width: buffer.readUInt32BE(16),
-        height: buffer.readUInt32BE(20),
-    };
+    return null;
 };
 const clampEven = (value, min, max) => {
     const clamped = Math.min(max, Math.max(min, Math.floor(value)));

package/dist/cdp/ffmpeg.js.map

@@ -1 +1 @@
-{"version":3,"file":"ffmpeg.js","sourceRoot":"","sources":["../../src/cdp/ffmpeg.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAA4B,MAAM,oBAAoB,CAAA;AA0BpE,gGAAgG;AAChG,MAAM,CAAC,MAAM,WAAW,GAAG,KAAK,EAAE,OAOjC,EAA0B,EAAE;IAC5B,MAAM,MAAM,GAAG,OAAO,CAAC,GAAG,CAAC,YAAY,EAAE,IAAI,EAAE,IAAI,QAAQ,CAAA;IAC3D,MAAM,MAAM,GAAG,gBAAgB,CAAC,OAAO,CAAC,CAAA;IACxC,MAAM,IAAI,GAAG;QACZ,cAAc;QACd,WAAW;QACX,OAAO;QACP,IAAI;QACJ,YAAY;QACZ,YAAY;QACZ,MAAM,CAAC,OAAO,CAAC,GAAG,CAAC;QACnB,SAAS;QACT,KAAK;QACL,IAAI;QACJ,QAAQ;QACR,KAAK;QACL,KAAK;QACL,MAAM;QACN,GAAG,gBAAgB,CAAC,OAAO,CAAC,MAAM,CAAC;QACnC,IAAI;QACJ,OAAO,CAAC,YAAY;KACpB,CAAA;IACD,MAAM,KAAK,GAAG,KAAK,CAAC,MAAM,EAAE,IAAI,EAAE,EAAE,KAAK,EAAE,CAAC,MAAM,EAAE,QAAQ,EAAE,MAAM,CAAC,EAAE,CAAC,CAAA;IACxE,IAAI,MAAM,GAAG,EAAE,CAAA;IACf,KAAK,CAAC,MAAM,CAAC,WAAW,CAAC,MAAM,CAAC,CAAA;IAChC,KAAK,CAAC,MAAM,CAAC,EAAE,CAAC,MAAM,EAAE,CAAC,KAAK,EAAE,EAAE;QACjC,MAAM,GAAG,GAAG,MAAM,GAAG,KAAK,EAAE,CAAC,KAAK,CAAC,CAAC,IAAI,CAAC,CAAA;IAC1C,CAAC,CAAC,CAAA;IAEF,MAAM,UAAU,GAAG,IAAI,OAAO,CAAO,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE;QACxD,KAAK,CAAC,IAAI,CAAC,OAAO,EAAE,CAAC,KAAK,EAAE,EAAE,CAAC,MAAM,CAAC,iBAAiB,CAAC,KAAK,CAAC,CAAC,CAAC,CAAA;QAChE,KAAK,CAAC,IAAI,CAAC,OAAO,EAAE,CAAC,IAAI,EAAE,EAAE;YAC5B,IAAI,IAAI,KAAK,CAAC,EAAE,CAAC;gBAChB,OAAO,EAAE,CAAA;gBACT,OAAM;YACP,CAAC;YACD,MAAM,CAAC,IAAI,KAAK,CAAC,gCAAgC,IAAI,IAAI,SAAS,GAAG,MAAM,CAAC,CAAC,CAAC,KAAK,MAAM,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAA;QAC5G,CAAC,CAAC,CAAA;IACH,CAAC,CAAC,CAAA;IACF,KAAK,UAAU,CAAC,KAAK,CAAC,GAAG,EAAE,GAAE,CAAC,CAAC,CAAA;IAE/B,MAAM,IAAI,OAAO,CAAO,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE;QAC3C,KAAK,CAAC,IAAI,CAAC,OAAO,EAAE,GAAG,EAAE,CAAC,OAAO,EAAE,CAAC,CAAA;QACpC,KAAK,CAAC,IAAI,CAAC,OAAO,EAAE,CAAC,KAAK,EAAE,EAAE,CAAC,MAAM,CAAC,iBAAiB,CAAC,KAAK,CAAC,CAAC,CAAC,CAAA;IACjE,CAAC,CAAC,CAAA;IAEF,OAAO,EAAE,KAAK,EAAE,UAAU,EAAE,CAAA;AAC7B,CAAC,CAAA;AAED,MAAM,gBAAgB,GAAG,CAAC,OAIzB,EAAU,EAAE;IACZ,IAAI,CAAC,OAAO,CAAC,IAAI,EAAE,CAAC;QACnB,OAAO,kDAAkD,CAAA;IAC1D,CAAC;IACD,IAAI,CAAC,OAAO,CAAC,QAAQ,EAAE,CAAC;QACvB,MAAM,IAAI,KAAK,CAAC,oDAAoD,CAAC,CAAA;IACtE,CAAC;IAED,MAAM,MAAM,GAAG,OAAO,CAAC,SAAS,CAAC,KAAK,GAAG,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAA;IAC/D,MAAM,MAAM,GAAG,OAAO,CAAC,SAAS,CAAC,MAAM,GAAG,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAA;IACjE,MAAM,CAAC,GAAG,SAAS,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,GAAG,MAAM,EAAE,CAAC,EAAE,OAAO,CAAC,SAAS,CAAC,KAAK,GAAG,CAAC,CAAC,CAAA;IAC5E,MAAM,CAAC,GAAG,SAAS,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,GAAG,MAAM,EAAE,CAAC,EAAE,OAAO,CAAC,SAAS,CAAC,MAAM,GAAG,CAAC,CAAC,CAAA;IAC7E,MAAM,KAAK,GAAG,SAAS,CAAC,OAAO,CAAC,IAAI,CAAC,KAAK,GAAG,MAAM,EAAE,CAAC,EAAE,OAAO,CAAC,SAAS,CAAC,KAAK,GAAG,CAAC,CAAC,CAAA;IACpF,MAAM,MAAM,GAAG,SAAS,CAAC,OAAO,CAAC,IAAI,CAAC,MAAM,GAAG,MAAM,EAAE,CAAC,EAAE,OAAO,CAAC,SAAS,CAAC,MAAM,GAAG,CAAC,CAAC,CAAA;IACvF,OAAO,QAAQ,KAAK,IAAI,MAAM,IAAI,CAAC,IAAI,CAAC,iBAAiB,CAAA;AAC1D,CAAC,CAAA;AAED,MAAM,gBAAgB,GAAG,CAAC,MAAoB,EAAY,EAAE;IAC3D,IAAI,MAAM,KAAK,MAAM,EAAE,CAAC;QACvB,OAAO,CAAC,MAAM,EAAE,QAAQ,EAAE,WAAW,EAAE,UAAU,EAAE,WAAW,EAAE,GAAG,EAAE,MAAM,EAAE,IAAI,EAAE,IAAI,EAAE,MAAM,CAAC,CAAA;IACjG,CAAC;IAED,8FAA8F;IAC9F,OAAO,CAAC,MAAM,EAAE,SAAS,EAAE,SAAS,EAAE,UAAU,EAAE,MAAM,EAAE,IAAI,EAAE,WAAW,EAAE,YAAY,EAAE,IAAI,EAAE,KAAK,CAAC,CAAA;AACxG,CAAC,CAAA;AAED,MAAM,CAAC,MAAM,WAAW,GAAG,CAAC,MAAc,EAAW,EAAE;IACtD,IACC,MAAM,CAAC,MAAM,GAAG,EAAE;QAClB,MAAM,CAAC,CAAC,CAAC,KAAK,IAAI;QAClB,MAAM,CAAC,CAAC,CAAC,KAAK,IAAI;QAClB,MAAM,CAAC,CAAC,CAAC,KAAK,IAAI;QAClB,MAAM,CAAC,CAAC,CAAC,KAAK,IAAI;QAClB,MAAM,CAAC,CAAC,CAAC,KAAK,IAAI;QAClB,MAAM,CAAC,CAAC,CAAC,KAAK,IAAI;QAClB,MAAM,CAAC,CAAC,CAAC,KAAK,IAAI;QAClB,MAAM,CAAC,CAAC,CAAC,KAAK,IAAI,EACjB,CAAC;QACF,MAAM,IAAI,KAAK,CAAC,+BAA+B,CAAC,CAAA;IACjD,CAAC;IAED,OAAO;QACN,KAAK,EAAE,MAAM,CAAC,YAAY,CAAC,EAAE,CAAC;QAC9B,MAAM,EAAE,MAAM,CAAC,YAAY,CAAC,EAAE,CAAC;KAC/B,CAAA;AACF,CAAC,CAAA;AAED,MAAM,SAAS,GAAG,CAAC,KAAa,EAAE,GAAW,EAAE,GAAW,EAAU,EAAE;IACrE,MAAM,OAAO,GAAG,IAAI,CAAC,GAAG,CAAC,GAAG,EAAE,IAAI,CAAC,GAAG,CAAC,GAAG,EAAE,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC,CAAA;IAC/D,OAAO,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,KAAK,CAAC,OAAO,GAAG,CAAC,CAAC,GAAG,CAAC,CAAC,CAAA;AAChD,CAAC,CAAA;AAED,MAAM,CAAC,MAAM,iBAAiB,GAAG,CAAC,KAAc,EAAS,EAAE;IAC1D,MAAM,SAAS,GAAG,KAA8B,CAAA;IAChD,IAAI,SAAS,CAAC,IAAI,KAAK,QAAQ,EAAE,CAAC;QACjC,OAAO,IAAI,KAAK,CAAC,wEAAwE,CAAC,CAAA;IAC3F,CAAC;IACD,OAAO,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,KAAK,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAA;AACjE,CAAC,CAAA"}
+{"version":3,"file":"ffmpeg.js","sourceRoot":"","sources":["../../src/cdp/ffmpeg.ts"],"names":[],"mappings":"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"}

package/dist/cdp/recording.d.ts

@@ -1,9 +1,11 @@
-import type { RecordRequest, RecordStartRequest, RecordStartResponse, RecordStopRequest, RecordStopResponse } from '@vforsh/argus-core';
+import type { RecordRequest, RecordStartRequest, RecordStartResponse, RecordStatusSummary, RecordStopRequest, RecordStopResponse } from '@vforsh/argus-core';
 import type { CdpSessionHandle } from './connection.js';
 export type Recorder = {
     capture: (request: RecordRequest) => Promise<RecordStopResponse>;
     start: (request: RecordStartRequest) => Promise<RecordStartResponse>;
     stop: (request: RecordStopRequest) => Promise<RecordStopResponse>;
+    /** Live recording summary, or `null` when nothing is recording. */
+    status: () => RecordStatusSummary | null;
     onDetached: (reason?: string) => void;
 };
 export declare const createRecorder: (options: {

package/dist/cdp/recording.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"recording.d.ts","sourceRoot":"","sources":["../../src/cdp/recording.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAgB,aAAa,EAAE,kBAAkB,EAAE,mBAAmB,EAAE,iBAAiB,EAAE,kBAAkB,EAAE,MAAM,oBAAoB,CAAA;AACrJ,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,iBAAiB,CAAA;AAqCvD,MAAM,MAAM,QAAQ,GAAG;IACtB,OAAO,EAAE,CAAC,OAAO,EAAE,aAAa,KAAK,OAAO,CAAC,kBAAkB,CAAC,CAAA;IAChE,KAAK,EAAE,CAAC,OAAO,EAAE,kBAAkB,KAAK,OAAO,CAAC,mBAAmB,CAAC,CAAA;IACpE,IAAI,EAAE,CAAC,OAAO,EAAE,iBAAiB,KAAK,OAAO,CAAC,kBAAkB,CAAC,CAAA;IACjE,UAAU,EAAE,CAAC,MAAM,CAAC,EAAE,MAAM,KAAK,IAAI,CAAA;CACrC,CAAA;AAED,eAAO,MAAM,cAAc,GAAI,SAAS;IACvC,OAAO,EAAE,gBAAgB,CAAA;IACzB,WAAW,CAAC,EAAE,gBAAgB,CAAA;IAC9B,YAAY,EAAE,MAAM,CAAA;IACpB,sBAAsB,CAAC,EAAE,CAAC,SAAS,EAAE,OAAO,KAAK,IAAI,CAAA;CACrD,KAAG,QA+JH,CAAA"}
+{"version":3,"file":"recording.d.ts","sourceRoot":"","sources":["../../src/cdp/recording.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAEX,aAAa,EACb,kBAAkB,EAClB,mBAAmB,EACnB,mBAAmB,EAEnB,iBAAiB,EACjB,kBAAkB,EAClB,MAAM,oBAAoB,CAAA;AAE3B,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,iBAAiB,CAAA;AAgCvD,MAAM,MAAM,QAAQ,GAAG;IACtB,OAAO,EAAE,CAAC,OAAO,EAAE,aAAa,KAAK,OAAO,CAAC,kBAAkB,CAAC,CAAA;IAChE,KAAK,EAAE,CAAC,OAAO,EAAE,kBAAkB,KAAK,OAAO,CAAC,mBAAmB,CAAC,CAAA;IACpE,IAAI,EAAE,CAAC,OAAO,EAAE,iBAAiB,KAAK,OAAO,CAAC,kBAAkB,CAAC,CAAA;IACjE,mEAAmE;IACnE,MAAM,EAAE,MAAM,mBAAmB,GAAG,IAAI,CAAA;IACxC,UAAU,EAAE,CAAC,MAAM,CAAC,EAAE,MAAM,KAAK,IAAI,CAAA;CACrC,CAAA;AAED,eAAO,MAAM,cAAc,GAAI,SAAS;IACvC,OAAO,EAAE,gBAAgB,CAAA;IACzB,WAAW,CAAC,EAAE,gBAAgB,CAAA;IAC9B,YAAY,EAAE,MAAM,CAAA;IACpB,sBAAsB,CAAC,EAAE,CAAC,SAAS,EAAE,OAAO,KAAK,IAAI,CAAA;CACrD,KAAG,QAgSH,CAAA"}