@hyperframes/engine 0.1.2 → 0.1.3

package/dist/services/chunkEncoder.js

@@ -0,0 +1,368 @@
+/**
+ * Chunk Encoder Service
+ *
+ * Encodes captured frames into video using FFmpeg.
+ * Supports CPU (libx264) and GPU encoding.
+ */
+import { spawn } from "child_process";
+import { existsSync, mkdirSync, readdirSync, statSync, writeFileSync } from "fs";
+import { join, dirname } from "path";
+import { DEFAULT_CONFIG } from "../config.js";
+import { getCachedGpuEncoder, getGpuEncoderName } from "../utils/gpuEncoder.js";
+import { runFfmpeg } from "../utils/runFfmpeg.js";
+export const ENCODER_PRESETS = {
+    draft: { preset: "ultrafast", quality: 28, codec: "h264" },
+    standard: { preset: "medium", quality: 23, codec: "h264" },
+    high: { preset: "slow", quality: 18, codec: "h264" },
+};
+// Re-export GPU utilities so existing consumers that import from chunkEncoder still work.
+export { detectGpuEncoder } from "../utils/gpuEncoder.js";
+function buildEncoderArgs(options, inputArgs, outputPath, gpuEncoder = null) {
+    const { fps, codec = "h264", preset = "medium", quality = 23, bitrate, pixelFormat = "yuv420p", useGpu = false, } = options;
+    const args = [...inputArgs, "-r", String(fps)];
+    const shouldUseGpu = useGpu && gpuEncoder !== null;
+    if (codec === "h264" || codec === "h265") {
+        if (shouldUseGpu) {
+            const encoderName = getGpuEncoderName(gpuEncoder, codec);
+            args.push("-c:v", encoderName);
+            switch (gpuEncoder) {
+                case "nvenc":
+                    args.push("-preset", preset);
+                    if (bitrate)
+                        args.push("-b:v", bitrate);
+                    else
+                        args.push("-cq", String(quality));
+                    break;
+                case "videotoolbox":
+                    if (bitrate)
+                        args.push("-b:v", bitrate);
+                    else {
+                        const vtQuality = Math.max(0, Math.min(100, 100 - quality * 2));
+                        args.push("-q:v", String(vtQuality));
+                    }
+                    args.push("-allow_sw", "1");
+                    break;
+                case "vaapi":
+                    args.unshift("-vaapi_device", "/dev/dri/renderD128");
+                    args.push("-vf", "format=nv12,hwupload");
+                    if (bitrate)
+                        args.push("-b:v", bitrate);
+                    else
+                        args.push("-qp", String(quality));
+                    break;
+                case "qsv":
+                    args.push("-preset", preset);
+                    if (bitrate)
+                        args.push("-b:v", bitrate);
+                    else
+                        args.push("-global_quality", String(quality));
+                    break;
+            }
+        }
+        else {
+            const encoderName = codec === "h264" ? "libx264" : "libx265";
+            args.push("-c:v", encoderName, "-preset", preset);
+            if (bitrate)
+                args.push("-b:v", bitrate);
+            else
+                args.push("-crf", String(quality));
+        }
+    }
+    else if (codec === "vp9") {
+        args.push("-c:v", "libvpx-vp9", "-b:v", bitrate || "0", "-crf", String(quality));
+        args.push("-deadline", preset === "ultrafast" ? "realtime" : "good");
+    }
+    else if (codec === "prores") {
+        args.push("-c:v", "prores_ks", "-profile:v", preset, "-vendor", "apl0");
+        return [...args, "-y", outputPath];
+    }
+    if (gpuEncoder !== "vaapi") {
+        args.push("-pix_fmt", pixelFormat);
+    }
+    args.push("-y", outputPath);
+    return args;
+}
+export async function encodeFramesFromDir(framesDir, framePattern, outputPath, options, signal, config) {
+    const startTime = Date.now();
+    const outputDir = dirname(outputPath);
+    if (!existsSync(outputDir))
+        mkdirSync(outputDir, { recursive: true });
+    const files = readdirSync(framesDir).filter((f) => f.match(/\.(jpg|jpeg|png)$/i));
+    const frameCount = files.length;
+    if (frameCount === 0) {
+        return {
+            success: false,
+            outputPath,
+            durationMs: Date.now() - startTime,
+            framesEncoded: 0,
+            fileSize: 0,
+            error: "[FFmpeg] No frame files found in directory",
+        };
+    }
+    let gpuEncoder = null;
+    if (options.useGpu) {
+        gpuEncoder = await getCachedGpuEncoder();
+    }
+    const inputPath = join(framesDir, framePattern);
+    const inputArgs = ["-framerate", String(options.fps), "-i", inputPath];
+    const args = buildEncoderArgs(options, inputArgs, outputPath, gpuEncoder);
+    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 encodeTimeout = config?.ffmpegEncodeTimeout ?? DEFAULT_CONFIG.ffmpegEncodeTimeout;
+        const timer = setTimeout(() => {
+            ffmpeg.kill("SIGTERM");
+        }, encodeTimeout);
+        ffmpeg.stderr.on("data", (data) => {
+            stderr += data.toString();
+        });
+        ffmpeg.on("close", (code) => {
+            clearTimeout(timer);
+            if (signal)
+                signal.removeEventListener("abort", onAbort);
+            const durationMs = Date.now() - startTime;
+            if (signal?.aborted) {
+                resolve({
+                    success: false,
+                    outputPath,
+                    durationMs,
+                    framesEncoded: 0,
+                    fileSize: 0,
+                    error: "FFmpeg encode cancelled",
+                });
+                return;
+            }
+            if (code !== 0) {
+                resolve({
+                    success: false,
+                    outputPath,
+                    durationMs,
+                    framesEncoded: 0,
+                    fileSize: 0,
+                    error: `FFmpeg exited with code ${code}`,
+                });
+                return;
+            }
+            const fileSize = existsSync(outputPath) ? statSync(outputPath).size : 0;
+            resolve({ success: true, outputPath, durationMs, framesEncoded: frameCount, fileSize });
+        });
+        ffmpeg.on("error", (err) => {
+            clearTimeout(timer);
+            if (signal)
+                signal.removeEventListener("abort", onAbort);
+            resolve({
+                success: false,
+                outputPath,
+                durationMs: Date.now() - startTime,
+                framesEncoded: 0,
+                fileSize: 0,
+                error: `[FFmpeg] ${err.message}`,
+            });
+        });
+    });
+}
+export async function encodeFramesChunkedConcat(framesDir, framePattern, outputPath, options, chunkSizeFrames, signal) {
+    const start = Date.now();
+    const files = readdirSync(framesDir)
+        .filter((f) => f.match(/\.(jpg|jpeg|png)$/i))
+        .sort();
+    if (files.length === 0) {
+        return {
+            success: false,
+            outputPath,
+            durationMs: Date.now() - start,
+            framesEncoded: 0,
+            fileSize: 0,
+            error: "[FFmpeg] No frame files found in directory",
+        };
+    }
+    const chunkSize = Math.max(30, Math.floor(chunkSizeFrames));
+    const chunkCount = Math.ceil(files.length / chunkSize);
+    const chunkDir = join(dirname(outputPath), "chunk-encode");
+    if (!existsSync(chunkDir))
+        mkdirSync(chunkDir, { recursive: true });
+    const chunkPaths = [];
+    for (let i = 0; i < chunkCount; i++) {
+        if (signal?.aborted) {
+            return {
+                success: false,
+                outputPath,
+                durationMs: Date.now() - start,
+                framesEncoded: 0,
+                fileSize: 0,
+                error: "Chunked encode cancelled",
+            };
+        }
+        const startNumber = i * chunkSize;
+        const framesInChunk = Math.min(chunkSize, files.length - startNumber);
+        const chunkPath = join(chunkDir, `chunk_${String(i).padStart(4, "0")}.mp4`);
+        const inputPath = join(framesDir, framePattern);
+        const inputArgs = [
+            "-framerate",
+            String(options.fps),
+            "-start_number",
+            String(startNumber),
+            "-i",
+            inputPath,
+            "-frames:v",
+            String(framesInChunk),
+        ];
+        let gpuEncoder = null;
+        if (options.useGpu)
+            gpuEncoder = await getCachedGpuEncoder();
+        const args = buildEncoderArgs(options, inputArgs, chunkPath, gpuEncoder);
+        const chunkResult = await new Promise((resolve) => {
+            const ffmpeg = spawn("ffmpeg", args);
+            let stderr = "";
+            ffmpeg.stderr.on("data", (d) => {
+                stderr += d.toString();
+            });
+            ffmpeg.on("close", (code) => {
+                if (code === 0)
+                    resolve({ success: true });
+                else
+                    resolve({ success: false, error: `Chunk ${i} encode failed: ${stderr.slice(-400)}` });
+            });
+            ffmpeg.on("error", (err) => {
+                resolve({ success: false, error: `Chunk ${i} encode error: ${err.message}` });
+            });
+        });
+        if (!chunkResult.success) {
+            return {
+                success: false,
+                outputPath,
+                durationMs: Date.now() - start,
+                framesEncoded: 0,
+                fileSize: 0,
+                error: chunkResult.error,
+            };
+        }
+        chunkPaths.push(chunkPath);
+    }
+    const concatListPath = join(chunkDir, "concat-list.txt");
+    const concatInput = chunkPaths.map((path) => `file '${path.replace(/'/g, "'\\''")}'`).join("\n");
+    writeFileSync(concatListPath, concatInput, "utf-8");
+    const concatArgs = [
+        "-f",
+        "concat",
+        "-safe",
+        "0",
+        "-i",
+        concatListPath,
+        "-c",
+        "copy",
+        "-y",
+        outputPath,
+    ];
+    const concatResult = await new Promise((resolve) => {
+        const ffmpeg = spawn("ffmpeg", concatArgs);
+        let stderr = "";
+        ffmpeg.stderr.on("data", (d) => {
+            stderr += d.toString();
+        });
+        ffmpeg.on("close", (code) => {
+            if (code === 0)
+                resolve({ success: true });
+            else
+                resolve({ success: false, error: `Chunk concat failed: ${stderr.slice(-400)}` });
+        });
+        ffmpeg.on("error", (err) => {
+            resolve({ success: false, error: `Chunk concat error: ${err.message}` });
+        });
+    });
+    if (!concatResult.success) {
+        return {
+            success: false,
+            outputPath,
+            durationMs: Date.now() - start,
+            framesEncoded: 0,
+            fileSize: 0,
+            error: concatResult.error,
+        };
+    }
+    const fileSize = existsSync(outputPath) ? statSync(outputPath).size : 0;
+    return {
+        success: true,
+        outputPath,
+        durationMs: Date.now() - start,
+        framesEncoded: files.length,
+        fileSize,
+    };
+}
+export async function muxVideoWithAudio(videoPath, audioPath, outputPath, signal, config) {
+    const outputDir = dirname(outputPath);
+    if (!existsSync(outputDir))
+        mkdirSync(outputDir, { recursive: true });
+    const args = [
+        "-i",
+        videoPath,
+        "-i",
+        audioPath,
+        "-c:v",
+        "copy",
+        "-c:a",
+        "aac",
+        "-b:a",
+        "192k",
+        "-shortest",
+        "-movflags",
+        "+faststart",
+        "-y",
+        outputPath,
+    ];
+    const processTimeout = config?.ffmpegProcessTimeout ?? DEFAULT_CONFIG.ffmpegProcessTimeout;
+    const result = await runFfmpeg(args, { signal, timeout: processTimeout });
+    if (signal?.aborted) {
+        return {
+            success: false,
+            outputPath,
+            durationMs: result.durationMs,
+            error: "FFmpeg mux cancelled",
+        };
+    }
+    return {
+        success: result.success,
+        outputPath,
+        durationMs: result.durationMs,
+        error: !result.success
+            ? result.exitCode !== null
+                ? `FFmpeg exited with code ${result.exitCode}`
+                : `[FFmpeg] ${result.stderr}`
+            : undefined,
+    };
+}
+export async function applyFaststart(inputPath, outputPath, signal, config) {
+    const args = ["-i", inputPath, "-c", "copy", "-movflags", "+faststart", "-y", outputPath];
+    const processTimeout = config?.ffmpegProcessTimeout ?? DEFAULT_CONFIG.ffmpegProcessTimeout;
+    const result = await runFfmpeg(args, { signal, timeout: processTimeout });
+    if (signal?.aborted) {
+        return {
+            success: false,
+            outputPath,
+            durationMs: result.durationMs,
+            error: "FFmpeg faststart cancelled",
+        };
+    }
+    return {
+        success: result.success,
+        outputPath,
+        durationMs: result.durationMs,
+        error: !result.success
+            ? result.exitCode !== null
+                ? `FFmpeg exited with code ${result.exitCode}`
+                : `[FFmpeg] ${result.stderr}`
+            : undefined,
+    };
+}
+//# sourceMappingURL=chunkEncoder.js.map

package/dist/services/chunkEncoder.js.map

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

package/dist/services/chunkEncoder.types.d.ts

@@ -0,0 +1,26 @@
+export interface EncoderOptions {
+    fps: number;
+    width: number;
+    height: number;
+    codec?: "h264" | "h265" | "vp9" | "prores";
+    preset?: string;
+    quality?: number;
+    bitrate?: string;
+    pixelFormat?: string;
+    useGpu?: boolean;
+}
+export interface EncodeResult {
+    success: boolean;
+    outputPath: string;
+    durationMs: number;
+    framesEncoded: number;
+    fileSize: number;
+    error?: string;
+}
+export interface MuxResult {
+    success: boolean;
+    outputPath: string;
+    durationMs: number;
+    error?: string;
+}
+//# sourceMappingURL=chunkEncoder.types.d.ts.map

package/dist/services/chunkEncoder.types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"chunkEncoder.types.d.ts","sourceRoot":"","sources":["../../src/services/chunkEncoder.types.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,cAAc;IAC7B,GAAG,EAAE,MAAM,CAAC;IACZ,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,CAAC,EAAE,MAAM,GAAG,MAAM,GAAG,KAAK,GAAG,QAAQ,CAAC;IAC3C,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,MAAM,CAAC,EAAE,OAAO,CAAC;CAClB;AAED,MAAM,WAAW,YAAY;IAC3B,OAAO,EAAE,OAAO,CAAC;IACjB,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,EAAE,MAAM,CAAC;IACnB,aAAa,EAAE,MAAM,CAAC;IACtB,QAAQ,EAAE,MAAM,CAAC;IACjB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,SAAS;IACxB,OAAO,EAAE,OAAO,CAAC;IACjB,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,EAAE,MAAM,CAAC;IACnB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB"}

package/dist/services/chunkEncoder.types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=chunkEncoder.types.js.map

package/dist/services/chunkEncoder.types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"chunkEncoder.types.js","sourceRoot":"","sources":["../../src/services/chunkEncoder.types.ts"],"names":[],"mappings":""}

package/dist/services/fileServer.d.ts

@@ -0,0 +1,25 @@
+/**
+ * File Server
+ *
+ * Lightweight HTTP server that serves a project directory to headless Chrome.
+ * Optionally injects scripts into index.html on-the-fly (e.g. runtime, bridge).
+ * Framework-agnostic — the caller decides what scripts to inject.
+ */
+export interface FileServerOptions {
+    projectDir: string;
+    compiledDir?: string;
+    port?: number;
+    /** Scripts injected into <head> of index.html. Default: none. */
+    headScripts?: string[];
+    /** Scripts injected before </body> of index.html. Default: none. */
+    bodyScripts?: string[];
+    /** Strip embedded runtime scripts from HTML before injection. Default: true. */
+    stripEmbeddedRuntime?: boolean;
+}
+export interface FileServerHandle {
+    url: string;
+    port: number;
+    close: () => void;
+}
+export declare function createFileServer(options: FileServerOptions): Promise<FileServerHandle>;
+//# sourceMappingURL=fileServer.d.ts.map

package/dist/services/fileServer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"fileServer.d.ts","sourceRoot":"","sources":["../../src/services/fileServer.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAkGH,MAAM,WAAW,iBAAiB;IAChC,UAAU,EAAE,MAAM,CAAC;IACnB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,iEAAiE;IACjE,WAAW,CAAC,EAAE,MAAM,EAAE,CAAC;IACvB,oEAAoE;IACpE,WAAW,CAAC,EAAE,MAAM,EAAE,CAAC;IACvB,gFAAgF;IAChF,oBAAoB,CAAC,EAAE,OAAO,CAAC;CAChC;AAED,MAAM,WAAW,gBAAgB;IAC/B,GAAG,EAAE,MAAM,CAAC;IACZ,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,IAAI,CAAC;CACnB;AAED,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,iBAAiB,GAAG,OAAO,CAAC,gBAAgB,CAAC,CAsDtF"}

package/dist/services/fileServer.js

@@ -0,0 +1,138 @@
+/**
+ * File Server
+ *
+ * Lightweight HTTP server that serves a project directory to headless Chrome.
+ * Optionally injects scripts into index.html on-the-fly (e.g. runtime, bridge).
+ * Framework-agnostic — the caller decides what scripts to inject.
+ */
+import { Hono } from "hono";
+import { serve } from "@hono/node-server";
+import { readFileSync, existsSync, statSync } from "node:fs";
+import { join, extname } from "node:path";
+const MIME_TYPES = {
+    ".html": "text/html; charset=utf-8",
+    ".css": "text/css; charset=utf-8",
+    ".js": "application/javascript; charset=utf-8",
+    ".json": "application/json; charset=utf-8",
+    ".png": "image/png",
+    ".jpg": "image/jpeg",
+    ".jpeg": "image/jpeg",
+    ".gif": "image/gif",
+    ".svg": "image/svg+xml",
+    ".webp": "image/webp",
+    ".mp4": "video/mp4",
+    ".webm": "video/webm",
+    ".mp3": "audio/mpeg",
+    ".wav": "audio/wav",
+    ".ogg": "audio/ogg",
+    ".aac": "audio/aac",
+    ".woff": "font/woff",
+    ".woff2": "font/woff2",
+    ".ttf": "font/ttf",
+    ".otf": "font/otf",
+};
+function stripEmbeddedRuntimeScripts(html) {
+    if (!html)
+        return html;
+    const scriptRe = /<script\b[^>]*>[\s\S]*?<\/script>/gi;
+    const runtimeSrcMarkers = [
+        "hyperframe.runtime.iife.js",
+        "hyperframes-runtime.modular.inline.js",
+        "data-hyperframes-preview-runtime",
+    ];
+    const runtimeInlineMarkers = [
+        "__hyperframeRuntimeBootstrapped",
+        "__hyperframeRuntime",
+        "__hyperframeRuntimeTeardown",
+        "window.__player =",
+        "window.__playerReady",
+        "window.__renderReady",
+    ];
+    const shouldStrip = (block) => {
+        const lowered = block.toLowerCase();
+        for (const marker of runtimeSrcMarkers) {
+            if (lowered.includes(marker.toLowerCase())) {
+                return true;
+            }
+        }
+        for (const marker of runtimeInlineMarkers) {
+            if (block.includes(marker)) {
+                return true;
+            }
+        }
+        return false;
+    };
+    return html.replace(scriptRe, (block) => (shouldStrip(block) ? "" : block));
+}
+function injectScriptsIntoHtml(html, headScripts, bodyScripts, stripEmbedded) {
+    if (stripEmbedded) {
+        html = stripEmbeddedRuntimeScripts(html);
+    }
+    if (headScripts.length > 0) {
+        const headTags = headScripts.map((src) => `<script>${src}</script>`).join("\n");
+        if (html.includes("</head>")) {
+            html = html.replace("</head>", () => `${headTags}\n</head>`);
+        }
+        else if (html.includes("<body")) {
+            html = html.replace("<body", () => `${headTags}\n<body`);
+        }
+        else {
+            html = headTags + "\n" + html;
+        }
+    }
+    if (bodyScripts.length > 0) {
+        const bodyTags = bodyScripts.map((src) => `<script>${src}</script>`).join("\n");
+        if (html.includes("</body>")) {
+            html = html.replace("</body>", () => `${bodyTags}\n</body>`);
+        }
+        else {
+            html = html + "\n" + bodyTags;
+        }
+    }
+    return html;
+}
+export function createFileServer(options) {
+    const { projectDir, compiledDir, port = 0, stripEmbeddedRuntime = true } = options;
+    const headScripts = options.headScripts ?? [];
+    const bodyScripts = options.bodyScripts ?? [];
+    const app = new Hono();
+    app.get("/*", (c) => {
+        let requestPath = c.req.path;
+        if (requestPath === "/")
+            requestPath = "/index.html";
+        // Remove leading slash
+        const relativePath = requestPath.replace(/^\//, "");
+        const compiledPath = compiledDir ? join(compiledDir, relativePath) : null;
+        const hasCompiledFile = Boolean(compiledPath && existsSync(compiledPath) && statSync(compiledPath).isFile());
+        const filePath = hasCompiledFile ? compiledPath : join(projectDir, relativePath);
+        if (!existsSync(filePath) || !statSync(filePath).isFile()) {
+            return c.text("Not found", 404);
+        }
+        const ext = extname(filePath).toLowerCase();
+        const contentType = MIME_TYPES[ext] || "application/octet-stream";
+        if (ext === ".html") {
+            const rawHtml = readFileSync(filePath, "utf-8");
+            const html = relativePath === "index.html"
+                ? injectScriptsIntoHtml(rawHtml, headScripts, bodyScripts, stripEmbeddedRuntime)
+                : rawHtml;
+            return c.text(html, 200, { "Content-Type": contentType });
+        }
+        const content = readFileSync(filePath);
+        return new Response(content, {
+            status: 200,
+            headers: { "Content-Type": contentType },
+        });
+    });
+    return new Promise((resolve) => {
+        const server = serve({ fetch: app.fetch, port }, (info) => {
+            const actualPort = info.port;
+            const url = `http://localhost:${actualPort}`;
+            resolve({
+                url,
+                port: actualPort,
+                close: () => server.close(),
+            });
+        });
+    });
+}
+//# sourceMappingURL=fileServer.js.map

package/dist/services/fileServer.js.map

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

package/dist/services/frameCapture.d.ts

@@ -0,0 +1,52 @@
+/**
+ * Frame Capture Service
+ *
+ * Uses Puppeteer to capture frames from any web page implementing the
+ * window.__hf seek protocol. Navigates to a file server URL, waits for
+ * the page to expose window.__hf, then captures frames deterministically
+ * via Chrome's BeginFrame API or Page.captureScreenshot fallback.
+ */
+import { type Browser, type Page } from "puppeteer-core";
+import { type CaptureMode } from "./browserManager.js";
+import { type EngineConfig } from "../config.js";
+import type { CaptureOptions, CaptureResult, CaptureBufferResult, CapturePerfSummary } from "../types.js";
+export type { CaptureOptions, CaptureResult, CaptureBufferResult, CapturePerfSummary };
+/** Called after seeking, before screenshot. Use for video frame injection or other pre-capture work. */
+export type BeforeCaptureHook = (page: Page, time: number) => Promise<void>;
+export interface CaptureSession {
+    browser: Browser;
+    page: Page;
+    options: CaptureOptions;
+    serverUrl: string;
+    outputDir: string;
+    onBeforeCapture: BeforeCaptureHook | null;
+    isInitialized: boolean;
+    browserConsoleBuffer: string[];
+    capturePerf: {
+        frames: number;
+        seekMs: number;
+        beforeCaptureMs: number;
+        screenshotMs: number;
+        totalMs: number;
+    };
+    captureMode: CaptureMode;
+    beginFrameTimeTicks: number;
+    beginFrameIntervalMs: number;
+    beginFrameHasDamageCount: number;
+    beginFrameNoDamageCount: number;
+    /** Optional producer config — when set, overrides module-level env var constants. */
+    config?: Partial<EngineConfig>;
+}
+export declare function createCaptureSession(serverUrl: string, outputDir: string, options: CaptureOptions, onBeforeCapture?: BeforeCaptureHook | null, config?: Partial<EngineConfig>): Promise<CaptureSession>;
+export declare function initializeSession(session: CaptureSession): Promise<void>;
+export declare function captureFrame(session: CaptureSession, frameIndex: number, time: number): Promise<CaptureResult>;
+/**
+ * Capture a frame and return the screenshot as a Buffer instead of writing to disk.
+ * Used by the streaming encode pipeline to pipe frames directly to FFmpeg stdin.
+ */
+export declare function captureFrameToBuffer(session: CaptureSession, frameIndex: number, time: number): Promise<CaptureBufferResult>;
+export declare function closeCaptureSession(session: CaptureSession): Promise<void>;
+export declare function prepareCaptureSessionForReuse(session: CaptureSession, outputDir: string, onBeforeCapture: BeforeCaptureHook | null): void;
+export declare function getCompositionDuration(session: CaptureSession): Promise<number>;
+export declare function getCapturePerfSummary(session: CaptureSession): CapturePerfSummary;
+//# sourceMappingURL=frameCapture.d.ts.map