@hyperframes/engine 0.1.0

package/dist/utils/ffprobe.js

@@ -0,0 +1,137 @@
+import { spawn } from "child_process";
+const videoMetadataCache = new Map();
+const audioMetadataCache = new Map();
+function parseFrameRate(frameRateStr) {
+    if (!frameRateStr)
+        return 0;
+    const parts = frameRateStr.split("/");
+    if (parts.length === 2) {
+        const num = parseFloat(parts[0] ?? "");
+        const den = parseFloat(parts[1] ?? "");
+        if (den !== 0)
+            return Math.round((num / den) * 100) / 100;
+    }
+    return parseFloat(frameRateStr) || 0;
+}
+export async function extractVideoMetadata(filePath) {
+    const cached = videoMetadataCache.get(filePath);
+    if (cached) {
+        return cached;
+    }
+    const probePromise = new Promise((resolve, reject) => {
+        const args = ["-v", "quiet", "-print_format", "json", "-show_format", "-show_streams", filePath];
+        const ffprobe = spawn("ffprobe", args);
+        let stdout = "";
+        let stderr = "";
+        ffprobe.stdout.on("data", (data) => {
+            stdout += data.toString();
+        });
+        ffprobe.stderr.on("data", (data) => {
+            stderr += data.toString();
+        });
+        ffprobe.on("close", (code) => {
+            if (code !== 0) {
+                reject(new Error(`[FFmpeg] ffprobe exited with code ${code}: ${stderr}`));
+                return;
+            }
+            try {
+                const output = JSON.parse(stdout);
+                const videoStream = output.streams.find((s) => s.codec_type === "video");
+                if (!videoStream) {
+                    reject(new Error("[FFmpeg] No video stream found"));
+                    return;
+                }
+                const hasAudio = output.streams.some((s) => s.codec_type === "audio");
+                const fps = parseFrameRate(videoStream.avg_frame_rate) || parseFrameRate(videoStream.r_frame_rate);
+                const durationSeconds = output.format.duration ? parseFloat(output.format.duration) : 0;
+                const metadata = {
+                    durationSeconds,
+                    width: videoStream.width || 0,
+                    height: videoStream.height || 0,
+                    fps,
+                    videoCodec: videoStream.codec_name || "unknown",
+                    hasAudio,
+                };
+                resolve(metadata);
+            }
+            catch (parseError) {
+                reject(new Error(`[FFmpeg] Failed to parse ffprobe output: ${parseError instanceof Error ? parseError.message : parseError}`));
+            }
+        });
+        ffprobe.on("error", (err) => {
+            if (err.code === "ENOENT") {
+                reject(new Error("[FFmpeg] ffprobe not found. Please install FFmpeg."));
+            }
+            else {
+                reject(err);
+            }
+        });
+    });
+    videoMetadataCache.set(filePath, probePromise);
+    probePromise.catch(() => {
+        if (videoMetadataCache.get(filePath) === probePromise) {
+            videoMetadataCache.delete(filePath);
+        }
+    });
+    return probePromise;
+}
+export async function extractAudioMetadata(filePath) {
+    const cached = audioMetadataCache.get(filePath);
+    if (cached) {
+        return cached;
+    }
+    const probePromise = new Promise((resolve, reject) => {
+        const args = ["-v", "quiet", "-print_format", "json", "-show_format", "-show_streams", filePath];
+        const ffprobe = spawn("ffprobe", args);
+        let stdout = "";
+        let stderr = "";
+        ffprobe.stdout.on("data", (data) => {
+            stdout += data.toString();
+        });
+        ffprobe.stderr.on("data", (data) => {
+            stderr += data.toString();
+        });
+        ffprobe.on("close", (code) => {
+            if (code !== 0) {
+                reject(new Error(`[FFmpeg] ffprobe exited with code ${code}: ${stderr}`));
+                return;
+            }
+            try {
+                const output = JSON.parse(stdout);
+                const audioStream = output.streams.find((s) => s.codec_type === "audio");
+                if (!audioStream) {
+                    reject(new Error("[FFmpeg] No audio stream found"));
+                    return;
+                }
+                const durationSeconds = output.format.duration ? parseFloat(output.format.duration) : 0;
+                const metadata = {
+                    durationSeconds,
+                    sampleRate: audioStream.sample_rate ? parseInt(audioStream.sample_rate) : 44100,
+                    channels: audioStream.channels || 2,
+                    audioCodec: audioStream.codec_name || "unknown",
+                    bitrate: output.format.bit_rate ? parseInt(output.format.bit_rate) : undefined,
+                };
+                resolve(metadata);
+            }
+            catch (parseError) {
+                reject(new Error(`[FFmpeg] Failed to parse ffprobe output: ${parseError instanceof Error ? parseError.message : parseError}`));
+            }
+        });
+        ffprobe.on("error", (err) => {
+            if (err.code === "ENOENT") {
+                reject(new Error("[FFmpeg] ffprobe not found. Please install FFmpeg."));
+            }
+            else {
+                reject(err);
+            }
+        });
+    });
+    audioMetadataCache.set(filePath, probePromise);
+    probePromise.catch(() => {
+        if (audioMetadataCache.get(filePath) === probePromise) {
+            audioMetadataCache.delete(filePath);
+        }
+    });
+    return probePromise;
+}
+//# sourceMappingURL=ffprobe.js.map

package/dist/utils/ffprobe.js.map

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

package/dist/utils/gpuEncoder.d.ts

@@ -0,0 +1,11 @@
+/**
+ * GPU Encoder Detection
+ *
+ * Shared GPU encoder detection and naming utilities used by both
+ * chunkEncoder and streamingEncoder services.
+ */
+export type GpuEncoder = "nvenc" | "videotoolbox" | "vaapi" | "qsv" | null;
+export declare function detectGpuEncoder(): Promise<GpuEncoder>;
+export declare function getCachedGpuEncoder(): Promise<GpuEncoder>;
+export declare function getGpuEncoderName(encoder: GpuEncoder, codec: "h264" | "h265"): string;
+//# sourceMappingURL=gpuEncoder.d.ts.map

package/dist/utils/gpuEncoder.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"gpuEncoder.d.ts","sourceRoot":"","sources":["../../src/utils/gpuEncoder.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAIH,MAAM,MAAM,UAAU,GAAG,OAAO,GAAG,cAAc,GAAG,OAAO,GAAG,KAAK,GAAG,IAAI,CAAC;AAE3E,wBAAsB,gBAAgB,IAAI,OAAO,CAAC,UAAU,CAAC,CAqB5D;AAID,wBAAsB,mBAAmB,IAAI,OAAO,CAAC,UAAU,CAAC,CAK/D;AAED,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,UAAU,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM,GAAG,MAAM,CAcrF"}

package/dist/utils/gpuEncoder.js

@@ -0,0 +1,55 @@
+/**
+ * GPU Encoder Detection
+ *
+ * Shared GPU encoder detection and naming utilities used by both
+ * chunkEncoder and streamingEncoder services.
+ */
+import { spawn } from "child_process";
+export async function detectGpuEncoder() {
+    return new Promise((resolve) => {
+        const ffmpeg = spawn("ffmpeg", ["-encoders"], {
+            stdio: ["pipe", "pipe", "pipe"],
+        });
+        let stdout = "";
+        ffmpeg.stdout.on("data", (data) => {
+            stdout += data.toString();
+        });
+        ffmpeg.on("close", () => {
+            if (stdout.includes("h264_nvenc"))
+                resolve("nvenc");
+            else if (stdout.includes("h264_videotoolbox"))
+                resolve("videotoolbox");
+            else if (stdout.includes("h264_vaapi"))
+                resolve("vaapi");
+            else if (stdout.includes("h264_qsv"))
+                resolve("qsv");
+            else
+                resolve(null);
+        });
+        ffmpeg.on("error", () => resolve(null));
+    });
+}
+let cachedGpuEncoder = undefined;
+export async function getCachedGpuEncoder() {
+    if (cachedGpuEncoder === undefined) {
+        cachedGpuEncoder = await detectGpuEncoder();
+    }
+    return cachedGpuEncoder;
+}
+export function getGpuEncoderName(encoder, codec) {
+    if (!encoder)
+        return codec === "h264" ? "libx264" : "libx265";
+    switch (encoder) {
+        case "nvenc":
+            return codec === "h264" ? "h264_nvenc" : "hevc_nvenc";
+        case "videotoolbox":
+            return codec === "h264" ? "h264_videotoolbox" : "hevc_videotoolbox";
+        case "vaapi":
+            return codec === "h264" ? "h264_vaapi" : "hevc_vaapi";
+        case "qsv":
+            return codec === "h264" ? "h264_qsv" : "hevc_qsv";
+        default:
+            return codec === "h264" ? "libx264" : "libx265";
+    }
+}
+//# sourceMappingURL=gpuEncoder.js.map

package/dist/utils/gpuEncoder.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"gpuEncoder.js","sourceRoot":"","sources":["../../src/utils/gpuEncoder.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,KAAK,EAAE,MAAM,eAAe,CAAC;AAItC,MAAM,CAAC,KAAK,UAAU,gBAAgB;IACpC,OAAO,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,EAAE;QAC7B,MAAM,MAAM,GAAG,KAAK,CAAC,QAAQ,EAAE,CAAC,WAAW,CAAC,EAAE;YAC5C,KAAK,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC;SAChC,CAAC,CAAC;QACH,IAAI,MAAM,GAAG,EAAE,CAAC;QAEhB,MAAM,CAAC,MAAM,CAAC,EAAE,CAAC,MAAM,EAAE,CAAC,IAAI,EAAE,EAAE;YAChC,MAAM,IAAI,IAAI,CAAC,QAAQ,EAAE,CAAC;QAC5B,CAAC,CAAC,CAAC;QAEH,MAAM,CAAC,EAAE,CAAC,OAAO,EAAE,GAAG,EAAE;YACtB,IAAI,MAAM,CAAC,QAAQ,CAAC,YAAY,CAAC;gBAAE,OAAO,CAAC,OAAO,CAAC,CAAC;iBAC/C,IAAI,MAAM,CAAC,QAAQ,CAAC,mBAAmB,CAAC;gBAAE,OAAO,CAAC,cAAc,CAAC,CAAC;iBAClE,IAAI,MAAM,CAAC,QAAQ,CAAC,YAAY,CAAC;gBAAE,OAAO,CAAC,OAAO,CAAC,CAAC;iBACpD,IAAI,MAAM,CAAC,QAAQ,CAAC,UAAU,CAAC;gBAAE,OAAO,CAAC,KAAK,CAAC,CAAC;;gBAChD,OAAO,CAAC,IAAI,CAAC,CAAC;QACrB,CAAC,CAAC,CAAC;QAEH,MAAM,CAAC,EAAE,CAAC,OAAO,EAAE,GAAG,EAAE,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC;IAC1C,CAAC,CAAC,CAAC;AACL,CAAC;AAED,IAAI,gBAAgB,GAA2B,SAAS,CAAC;AAEzD,MAAM,CAAC,KAAK,UAAU,mBAAmB;IACvC,IAAI,gBAAgB,KAAK,SAAS,EAAE,CAAC;QACnC,gBAAgB,GAAG,MAAM,gBAAgB,EAAE,CAAC;IAC9C,CAAC;IACD,OAAO,gBAAgB,CAAC;AAC1B,CAAC;AAED,MAAM,UAAU,iBAAiB,CAAC,OAAmB,EAAE,KAAsB;IAC3E,IAAI,CAAC,OAAO;QAAE,OAAO,KAAK,KAAK,MAAM,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,SAAS,CAAC;IAC9D,QAAQ,OAAO,EAAE,CAAC;QAChB,KAAK,OAAO;YACV,OAAO,KAAK,KAAK,MAAM,CAAC,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,YAAY,CAAC;QACxD,KAAK,cAAc;YACjB,OAAO,KAAK,KAAK,MAAM,CAAC,CAAC,CAAC,mBAAmB,CAAC,CAAC,CAAC,mBAAmB,CAAC;QACtE,KAAK,OAAO;YACV,OAAO,KAAK,KAAK,MAAM,CAAC,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,YAAY,CAAC;QACxD,KAAK,KAAK;YACR,OAAO,KAAK,KAAK,MAAM,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC,UAAU,CAAC;QACpD;YACE,OAAO,KAAK,KAAK,MAAM,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,SAAS,CAAC;IACpD,CAAC;AACH,CAAC"}

package/dist/utils/parityContract.d.ts

@@ -0,0 +1,3 @@
+export declare const MEDIA_VISUAL_STYLE_PROPERTIES: readonly ["width", "height", "top", "left", "right", "bottom", "inset", "object-fit", "object-position", "z-index", "opacity", "visibility", "filter", "mix-blend-mode", "backdrop-filter", "border-radius", "overflow", "clip-path", "mask", "mask-image", "mask-size", "mask-position", "mask-repeat", "transform", "transform-origin", "box-sizing"];
+export declare function quantizeTimeToFrame(timeSeconds: number, fps: number): number;
+//# sourceMappingURL=parityContract.d.ts.map

package/dist/utils/parityContract.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"parityContract.d.ts","sourceRoot":"","sources":["../../src/utils/parityContract.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,6BAA6B,yVA2BhC,CAAC;AAEX,wBAAgB,mBAAmB,CAAC,WAAW,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,MAAM,CAK5E"}

package/dist/utils/parityContract.js

@@ -0,0 +1,35 @@
+export const MEDIA_VISUAL_STYLE_PROPERTIES = [
+    "width",
+    "height",
+    "top",
+    "left",
+    "right",
+    "bottom",
+    "inset",
+    "object-fit",
+    "object-position",
+    "z-index",
+    "opacity",
+    "visibility",
+    "filter",
+    "mix-blend-mode",
+    "backdrop-filter",
+    "border-radius",
+    "overflow",
+    "clip-path",
+    "mask",
+    "mask-image",
+    "mask-size",
+    "mask-position",
+    "mask-repeat",
+    "transform",
+    "transform-origin",
+    "box-sizing",
+];
+export function quantizeTimeToFrame(timeSeconds, fps) {
+    const safeFps = Number.isFinite(fps) && fps > 0 ? fps : 30;
+    const safeTime = Number.isFinite(timeSeconds) && timeSeconds > 0 ? timeSeconds : 0;
+    const frameIndex = Math.floor(safeTime * safeFps + 1e-9);
+    return frameIndex / safeFps;
+}
+//# sourceMappingURL=parityContract.js.map

package/dist/utils/parityContract.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"parityContract.js","sourceRoot":"","sources":["../../src/utils/parityContract.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,6BAA6B,GAAG;IAC3C,OAAO;IACP,QAAQ;IACR,KAAK;IACL,MAAM;IACN,OAAO;IACP,QAAQ;IACR,OAAO;IACP,YAAY;IACZ,iBAAiB;IACjB,SAAS;IACT,SAAS;IACT,YAAY;IACZ,QAAQ;IACR,gBAAgB;IAChB,iBAAiB;IACjB,eAAe;IACf,UAAU;IACV,WAAW;IACX,MAAM;IACN,YAAY;IACZ,WAAW;IACX,eAAe;IACf,aAAa;IACb,WAAW;IACX,kBAAkB;IAClB,YAAY;CACJ,CAAC;AAEX,MAAM,UAAU,mBAAmB,CAAC,WAAmB,EAAE,GAAW;IAClE,MAAM,OAAO,GAAG,MAAM,CAAC,QAAQ,CAAC,GAAG,CAAC,IAAI,GAAG,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC;IAC3D,MAAM,QAAQ,GAAG,MAAM,CAAC,QAAQ,CAAC,WAAW,CAAC,IAAI,WAAW,GAAG,CAAC,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC,CAAC;IACnF,MAAM,UAAU,GAAG,IAAI,CAAC,KAAK,CAAC,QAAQ,GAAG,OAAO,GAAG,IAAI,CAAC,CAAC;IACzD,OAAO,UAAU,GAAG,OAAO,CAAC;AAC9B,CAAC"}

package/dist/utils/runFfmpeg.d.ts

@@ -0,0 +1,19 @@
+/**
+ * Shared FFmpeg process runner.
+ *
+ * Extracts the repeated spawn-stderr-timeout-abort-close-error pattern
+ * that appears across audioMixer and chunkEncoder into a single helper.
+ */
+export interface RunFfmpegOptions {
+    signal?: AbortSignal;
+    timeout?: number;
+    onStderr?: (line: string) => void;
+}
+export interface RunFfmpegResult {
+    success: boolean;
+    exitCode: number | null;
+    stderr: string;
+    durationMs: number;
+}
+export declare function runFfmpeg(args: string[], opts?: RunFfmpegOptions): Promise<RunFfmpegResult>;
+//# sourceMappingURL=runFfmpeg.d.ts.map

package/dist/utils/runFfmpeg.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"runFfmpeg.d.ts","sourceRoot":"","sources":["../../src/utils/runFfmpeg.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAIH,MAAM,WAAW,gBAAgB;IAC/B,MAAM,CAAC,EAAE,WAAW,CAAC;IACrB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,QAAQ,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;CACnC;AAED,MAAM,WAAW,eAAe;IAC9B,OAAO,EAAE,OAAO,CAAC;IACjB,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;IACxB,MAAM,EAAE,MAAM,CAAC;IACf,UAAU,EAAE,MAAM,CAAC;CACpB;AAID,wBAAsB,SAAS,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE,IAAI,CAAC,EAAE,gBAAgB,GAAG,OAAO,CAAC,eAAe,CAAC,CAwDjG"}

package/dist/utils/runFfmpeg.js

@@ -0,0 +1,62 @@
+/**
+ * Shared FFmpeg process runner.
+ *
+ * Extracts the repeated spawn-stderr-timeout-abort-close-error pattern
+ * that appears across audioMixer and chunkEncoder into a single helper.
+ */
+import { spawn } from "child_process";
+const DEFAULT_TIMEOUT = 300_000;
+export async function runFfmpeg(args, opts) {
+    const startMs = Date.now();
+    const signal = opts?.signal;
+    const timeout = opts?.timeout ?? DEFAULT_TIMEOUT;
+    const onStderr = opts?.onStderr;
+    return new Promise((resolve) => {
+        const ffmpeg = spawn("ffmpeg", args);
+        let stderr = "";
+        const onAbort = () => {
+            ffmpeg.kill("SIGTERM");
+        };
+        if (signal) {
+            if (signal.aborted) {
+                ffmpeg.kill("SIGTERM");
+            }
+            else {
+                signal.addEventListener("abort", onAbort, { once: true });
+            }
+        }
+        const timer = setTimeout(() => {
+            ffmpeg.kill("SIGTERM");
+        }, timeout);
+        ffmpeg.stderr.on("data", (data) => {
+            const chunk = data.toString();
+            stderr += chunk;
+            if (onStderr) {
+                onStderr(chunk);
+            }
+        });
+        ffmpeg.on("close", (code) => {
+            clearTimeout(timer);
+            if (signal)
+                signal.removeEventListener("abort", onAbort);
+            resolve({
+                success: !signal?.aborted && code === 0,
+                exitCode: code,
+                stderr,
+                durationMs: Date.now() - startMs,
+            });
+        });
+        ffmpeg.on("error", (err) => {
+            clearTimeout(timer);
+            if (signal)
+                signal.removeEventListener("abort", onAbort);
+            resolve({
+                success: false,
+                exitCode: null,
+                stderr: err.message,
+                durationMs: Date.now() - startMs,
+            });
+        });
+    });
+}
+//# sourceMappingURL=runFfmpeg.js.map

package/dist/utils/runFfmpeg.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"runFfmpeg.js","sourceRoot":"","sources":["../../src/utils/runFfmpeg.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,KAAK,EAAE,MAAM,eAAe,CAAC;AAetC,MAAM,eAAe,GAAG,OAAO,CAAC;AAEhC,MAAM,CAAC,KAAK,UAAU,SAAS,CAAC,IAAc,EAAE,IAAuB;IACrE,MAAM,OAAO,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;IAC3B,MAAM,MAAM,GAAG,IAAI,EAAE,MAAM,CAAC;IAC5B,MAAM,OAAO,GAAG,IAAI,EAAE,OAAO,IAAI,eAAe,CAAC;IACjD,MAAM,QAAQ,GAAG,IAAI,EAAE,QAAQ,CAAC;IAEhC,OAAO,IAAI,OAAO,CAAkB,CAAC,OAAO,EAAE,EAAE;QAC9C,MAAM,MAAM,GAAG,KAAK,CAAC,QAAQ,EAAE,IAAI,CAAC,CAAC;QACrC,IAAI,MAAM,GAAG,EAAE,CAAC;QAEhB,MAAM,OAAO,GAAG,GAAG,EAAE;YACnB,MAAM,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;QACzB,CAAC,CAAC;QAEF,IAAI,MAAM,EAAE,CAAC;YACX,IAAI,MAAM,CAAC,OAAO,EAAE,CAAC;gBACnB,MAAM,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;YACzB,CAAC;iBAAM,CAAC;gBACN,MAAM,CAAC,gBAAgB,CAAC,OAAO,EAAE,OAAO,EAAE,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC;YAC5D,CAAC;QACH,CAAC;QAED,MAAM,KAAK,GAAG,UAAU,CAAC,GAAG,EAAE;YAC5B,MAAM,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;QACzB,CAAC,EAAE,OAAO,CAAC,CAAC;QAEZ,MAAM,CAAC,MAAM,CAAC,EAAE,CAAC,MAAM,EAAE,CAAC,IAAY,EAAE,EAAE;YACxC,MAAM,KAAK,GAAG,IAAI,CAAC,QAAQ,EAAE,CAAC;YAC9B,MAAM,IAAI,KAAK,CAAC;YAChB,IAAI,QAAQ,EAAE,CAAC;gBACb,QAAQ,CAAC,KAAK,CAAC,CAAC;YAClB,CAAC;QACH,CAAC,CAAC,CAAC;QAEH,MAAM,CAAC,EAAE,CAAC,OAAO,EAAE,CAAC,IAAI,EAAE,EAAE;YAC1B,YAAY,CAAC,KAAK,CAAC,CAAC;YACpB,IAAI,MAAM;gBAAE,MAAM,CAAC,mBAAmB,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;YACzD,OAAO,CAAC;gBACN,OAAO,EAAE,CAAC,MAAM,EAAE,OAAO,IAAI,IAAI,KAAK,CAAC;gBACvC,QAAQ,EAAE,IAAI;gBACd,MAAM;gBACN,UAAU,EAAE,IAAI,CAAC,GAAG,EAAE,GAAG,OAAO;aACjC,CAAC,CAAC;QACL,CAAC,CAAC,CAAC;QAEH,MAAM,CAAC,EAAE,CAAC,OAAO,EAAE,CAAC,GAAG,EAAE,EAAE;YACzB,YAAY,CAAC,KAAK,CAAC,CAAC;YACpB,IAAI,MAAM;gBAAE,MAAM,CAAC,mBAAmB,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;YACzD,OAAO,CAAC;gBACN,OAAO,EAAE,KAAK;gBACd,QAAQ,EAAE,IAAI;gBACd,MAAM,EAAE,GAAG,CAAC,OAAO;gBACnB,UAAU,EAAE,IAAI,CAAC,GAAG,EAAE,GAAG,OAAO;aACjC,CAAC,CAAC;QACL,CAAC,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;AACL,CAAC"}

package/dist/utils/urlDownloader.d.ts

@@ -0,0 +1,3 @@
+export declare function downloadToTemp(url: string, destDir: string, timeoutMs?: number): Promise<string>;
+export declare function isHttpUrl(path: string): boolean;
+//# sourceMappingURL=urlDownloader.d.ts.map

package/dist/utils/urlDownloader.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"urlDownloader.d.ts","sourceRoot":"","sources":["../../src/utils/urlDownloader.ts"],"names":[],"mappings":"AAgBA,wBAAsB,cAAc,CAAC,GAAG,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,SAAS,GAAE,MAAe,GAAG,OAAO,CAAC,MAAM,CAAC,CAyD9G;AAED,wBAAgB,SAAS,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAE/C"}

package/dist/utils/urlDownloader.js

@@ -0,0 +1,68 @@
+import { createWriteStream, existsSync, mkdirSync } from "fs";
+import { createHash } from "crypto";
+import { join, extname } from "path";
+import { Readable } from "stream";
+import { finished } from "stream/promises";
+const downloadPathCache = new Map();
+const inFlightDownloads = new Map();
+function getFilenameFromUrl(url) {
+    const hash = createHash("md5").update(url).digest("hex").slice(0, 12);
+    const urlObj = new URL(url);
+    const ext = extname(urlObj.pathname) || ".mp4";
+    return `download_${hash}${ext}`;
+}
+export async function downloadToTemp(url, destDir, timeoutMs = 300000) {
+    const cachedPath = downloadPathCache.get(url);
+    if (cachedPath && existsSync(cachedPath)) {
+        return cachedPath;
+    }
+    const inFlight = inFlightDownloads.get(url);
+    if (inFlight) {
+        return inFlight;
+    }
+    if (!existsSync(destDir)) {
+        mkdirSync(destDir, { recursive: true });
+    }
+    const filename = getFilenameFromUrl(url);
+    const localPath = join(destDir, filename);
+    if (existsSync(localPath)) {
+        downloadPathCache.set(url, localPath);
+        return localPath;
+    }
+    const downloadPromise = (async () => {
+        try {
+            const controller = new AbortController();
+            const timeoutId = setTimeout(() => controller.abort(), timeoutMs);
+            const response = await fetch(url, { signal: controller.signal });
+            clearTimeout(timeoutId);
+            if (!response.ok) {
+                throw new Error(`HTTP ${response.status}: ${response.statusText}`);
+            }
+            if (!response.body) {
+                throw new Error("Response body is empty");
+            }
+            const fileStream = createWriteStream(localPath);
+            // eslint-disable-next-line @typescript-eslint/no-explicit-any
+            const readableStream = Readable.fromWeb(response.body);
+            await finished(readableStream.pipe(fileStream));
+            downloadPathCache.set(url, localPath);
+            return localPath;
+        }
+        catch (err) {
+            const message = err instanceof Error ? err.message : String(err);
+            if (message.includes("aborted")) {
+                throw new Error(`[URLDownloader] Download timeout after ${timeoutMs / 1000}s: ${url}`);
+            }
+            throw new Error(`[URLDownloader] Download failed: ${message}`);
+        }
+        finally {
+            inFlightDownloads.delete(url);
+        }
+    })();
+    inFlightDownloads.set(url, downloadPromise);
+    return downloadPromise;
+}
+export function isHttpUrl(path) {
+    return path.startsWith("http://") || path.startsWith("https://");
+}
+//# sourceMappingURL=urlDownloader.js.map

package/dist/utils/urlDownloader.js.map

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

package/package.json

@@ -0,0 +1,30 @@
+{
+  "name": "@hyperframes/engine",
+  "version": "0.1.0",
+  "description": "Seekable web page to video rendering engine (Puppeteer + FFmpeg)",
+  "type": "module",
+  "main": "./src/index.ts",
+  "types": "./src/index.ts",
+  "exports": {
+    ".": "./src/index.ts"
+  },
+  "scripts": {
+    "build": "tsc",
+    "typecheck": "tsc --noEmit"
+  },
+  "dependencies": {
+    "@hono/node-server": "^1.13.0",
+    "@hyperframes/core": "workspace:*",
+    "hono": "^4.6.0",
+    "linkedom": "^0.18.12",
+    "puppeteer": "^24.0.0",
+    "puppeteer-core": "^24.39.1"
+  },
+  "devDependencies": {
+    "@types/node": "^22.10.1",
+    "typescript": "^5.7.2"
+  },
+  "engines": {
+    "node": ">=22"
+  }
+}

package/src/cdp-headless-experimental.d.ts

@@ -0,0 +1,54 @@
+/**
+ * Type augmentation for Chrome's HeadlessExperimental CDP domain.
+ *
+ * Puppeteer's CDPSession.send() is typed against devtools-protocol's
+ * ProtocolMapping.Commands, which does not include HeadlessExperimental.
+ * This module augmentation adds proper types so we can call these methods
+ * without unsafe `as any` casts.
+ */
+
+/** Parameters for HeadlessExperimental.beginFrame */
+interface HeadlessExperimentalBeginFrameRequest {
+  /** Timestamp in milliseconds since epoch for the frame */
+  frameTimeTicks: number;
+  /** Interval in milliseconds between frames */
+  interval: number;
+  /** If true, do not produce display updates (warmup mode) */
+  noDisplayUpdates?: boolean;
+  /** Optional screenshot configuration */
+  screenshot?: {
+    format: "jpeg" | "png";
+    quality?: number;
+    optimizeForSpeed?: boolean;
+  };
+}
+
+/** Response from HeadlessExperimental.beginFrame */
+interface HeadlessExperimentalBeginFrameResponse {
+  /** Whether the compositor reported visual damage */
+  hasDamage: boolean;
+  /** Base64-encoded screenshot data (present only when screenshot was requested and hasDamage is true) */
+  screenshotData?: string;
+}
+
+export {};
+
+declare module "devtools-protocol/types/protocol-mapping.js" {
+  // Merge into the existing ProtocolMapping namespace
+  export namespace ProtocolMapping {
+    interface Commands {
+      "HeadlessExperimental.enable": {
+        paramsType: [];
+        returnType: void;
+      };
+      "HeadlessExperimental.disable": {
+        paramsType: [];
+        returnType: void;
+      };
+      "HeadlessExperimental.beginFrame": {
+        paramsType: [HeadlessExperimentalBeginFrameRequest];
+        returnType: HeadlessExperimentalBeginFrameResponse;
+      };
+    }
+  }
+}

package/src/config.test.ts

@@ -0,0 +1,95 @@
+import { describe, it, expect, beforeEach, afterEach } from "vitest";
+import { resolveConfig, DEFAULT_CONFIG } from "./config.js";
+
+describe("resolveConfig", () => {
+  const savedEnv = new Map<string, string | undefined>();
+
+  function setEnv(key: string, value: string) {
+    savedEnv.set(key, process.env[key]);
+    process.env[key] = value;
+  }
+
+  beforeEach(() => {
+    savedEnv.clear();
+  });
+
+  afterEach(() => {
+    for (const [key, value] of savedEnv) {
+      if (value === undefined) {
+        delete process.env[key];
+      } else {
+        process.env[key] = value;
+      }
+    }
+  });
+
+  it("returns defaults when no overrides or env vars are set", () => {
+    const config = resolveConfig();
+    expect(config.fps).toBe(30);
+    expect(config.quality).toBe("standard");
+    expect(config.format).toBe("jpeg");
+    expect(config.jpegQuality).toBe(80);
+    expect(config.debug).toBe(false);
+  });
+
+  it("applies explicit overrides over defaults", () => {
+    const config = resolveConfig({ fps: 60, debug: true });
+    expect(config.fps).toBe(60);
+    expect(config.debug).toBe(true);
+    // Non-overridden fields remain at defaults
+    expect(config.quality).toBe("standard");
+  });
+
+  it("reads numeric env vars with PRODUCER_ prefix", () => {
+    setEnv("PRODUCER_MAX_WORKERS", "4");
+    setEnv("PRODUCER_CORES_PER_WORKER", "3");
+
+    const config = resolveConfig();
+    expect(config.concurrency).toBe(4);
+    expect(config.coresPerWorker).toBe(3);
+  });
+
+  it("reads boolean env vars (true/false strings)", () => {
+    setEnv("PRODUCER_DISABLE_GPU", "true");
+    setEnv("PRODUCER_ENABLE_BROWSER_POOL", "true");
+
+    const config = resolveConfig();
+    expect(config.disableGpu).toBe(true);
+    expect(config.enableBrowserPool).toBe(true);
+  });
+
+  it("treats non-'true' boolean env vars as false", () => {
+    setEnv("PRODUCER_DISABLE_GPU", "yes");
+
+    const config = resolveConfig();
+    expect(config.disableGpu).toBe(false);
+  });
+
+  it("explicit overrides take precedence over env vars", () => {
+    setEnv("PRODUCER_CORES_PER_WORKER", "5");
+
+    const config = resolveConfig({ coresPerWorker: 8 });
+    expect(config.coresPerWorker).toBe(8);
+  });
+
+  it("falls back to defaults for invalid numeric env vars", () => {
+    setEnv("PRODUCER_CORES_PER_WORKER", "not-a-number");
+
+    const config = resolveConfig();
+    expect(config.coresPerWorker).toBe(DEFAULT_CONFIG.coresPerWorker);
+  });
+
+  it("clamps chunkSizeFrames to minimum of 120", () => {
+    setEnv("PRODUCER_CHUNK_SIZE_FRAMES", "50");
+
+    const config = resolveConfig();
+    expect(config.chunkSizeFrames).toBe(120);
+  });
+
+  it("clamps frameDataUriCacheLimit to minimum of 32", () => {
+    setEnv("PRODUCER_FRAME_DATA_URI_CACHE_LIMIT", "10");
+
+    const config = resolveConfig();
+    expect(config.frameDataUriCacheLimit).toBe(32);
+  });
+});