@hyperframes/engine 0.1.1 → 0.1.2

package/src/services/videoFrameInjector.ts

@@ -71,7 +71,10 @@ export function createVideoFrameInjector(
 ): BeforeCaptureHook | null {
   if (!frameLookup) return null;
 
-  const cacheLimit = Math.max(32, config?.frameDataUriCacheLimit ?? DEFAULT_CONFIG.frameDataUriCacheLimit);
+  const cacheLimit = Math.max(
+    32,
+    config?.frameDataUriCacheLimit ?? DEFAULT_CONFIG.frameDataUriCacheLimit,
+  );
   const frameCache = createFrameDataUriCache(cacheLimit);
   const lastInjectedFrameByVideo = new Map<string, number>();
 
@@ -81,13 +84,16 @@ export function createVideoFrameInjector(
     const updates: Array<{ videoId: string; dataUri: string; frameIndex: number }> = [];
     const activeIds = new Set<string>();
     if (activePayloads.size > 0) {
-      const pendingReads: Array<Promise<{ videoId: string; dataUri: string; frameIndex: number }>> = [];
+      const pendingReads: Array<Promise<{ videoId: string; dataUri: string; frameIndex: number }>> =
+        [];
       for (const [videoId, payload] of activePayloads) {
         activeIds.add(videoId);
         const lastFrameIndex = lastInjectedFrameByVideo.get(videoId);
         if (lastFrameIndex === payload.frameIndex) continue;
         pendingReads.push(
-          frameCache.get(payload.framePath).then((dataUri) => ({ videoId, dataUri, frameIndex: payload.frameIndex })),
+          frameCache
+            .get(payload.framePath)
+            .then((dataUri) => ({ videoId, dataUri, frameIndex: payload.frameIndex })),
         );
       }
       updates.push(...(await Promise.all(pendingReads)));

package/src/utils/ffprobe.ts

@@ -59,7 +59,15 @@ export async function extractVideoMetadata(filePath: string): Promise<VideoMetad
   }
 
   const probePromise = new Promise<VideoMetadata>((resolve, reject) => {
-    const args = ["-v", "quiet", "-print_format", "json", "-show_format", "-show_streams", filePath];
+    const args = [
+      "-v",
+      "quiet",
+      "-print_format",
+      "json",
+      "-show_format",
+      "-show_streams",
+      filePath,
+    ];
 
     const ffprobe = spawn("ffprobe", args);
     let stdout = "";
@@ -87,7 +95,8 @@ export async function extractVideoMetadata(filePath: string): Promise<VideoMetad
         }
 
         const hasAudio = output.streams.some((s) => s.codec_type === "audio");
-        const fps = parseFrameRate(videoStream.avg_frame_rate) || parseFrameRate(videoStream.r_frame_rate);
+        const fps =
+          parseFrameRate(videoStream.avg_frame_rate) || parseFrameRate(videoStream.r_frame_rate);
         const durationSeconds = output.format.duration ? parseFloat(output.format.duration) : 0;
 
         const metadata: VideoMetadata = {
@@ -100,7 +109,11 @@ export async function extractVideoMetadata(filePath: string): Promise<VideoMetad
         };
         resolve(metadata);
       } catch (parseError: unknown) {
-        reject(new Error(`[FFmpeg] Failed to parse ffprobe output: ${parseError instanceof Error ? parseError.message : parseError}`));
+        reject(
+          new Error(
+            `[FFmpeg] Failed to parse ffprobe output: ${parseError instanceof Error ? parseError.message : parseError}`,
+          ),
+        );
       }
     });
 
@@ -128,7 +141,15 @@ export async function extractAudioMetadata(filePath: string): Promise<AudioMetad
   }
 
   const probePromise = new Promise<AudioMetadata>((resolve, reject) => {
-    const args = ["-v", "quiet", "-print_format", "json", "-show_format", "-show_streams", filePath];
+    const args = [
+      "-v",
+      "quiet",
+      "-print_format",
+      "json",
+      "-show_format",
+      "-show_streams",
+      filePath,
+    ];
 
     const ffprobe = spawn("ffprobe", args);
     let stdout = "";

package/src/utils/urlDownloader.ts

@@ -14,7 +14,11 @@ function getFilenameFromUrl(url: string): string {
   return `download_${hash}${ext}`;
 }
 
-export async function downloadToTemp(url: string, destDir: string, timeoutMs: number = 300000): Promise<string> {
+export async function downloadToTemp(
+  url: string,
+  destDir: string,
+  timeoutMs: number = 300000,
+): Promise<string> {
   const cachedPath = downloadPathCache.get(url);
   if (cachedPath && existsSync(cachedPath)) {
     return cachedPath;

package/LICENSE

@@ -1,21 +0,0 @@
-MIT License
-
-Copyright (c) 2026 HeyGen
-
-Permission is hereby granted, free of charge, to any person obtaining a copy
-of this software and associated documentation files (the "Software"), to deal
-in the Software without restriction, including without limitation the rights
-to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
-copies of the Software, and to permit persons to whom the Software is
-furnished to do so, subject to the following conditions:
-
-The above copyright notice and this permission notice shall be included in all
-copies or substantial portions of the Software.
-
-THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
-IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
-FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
-AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
-LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
-OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
-SOFTWARE.

package/dist/config.d.ts

@@ -1,62 +0,0 @@
-/**
- * Engine Configuration
- *
- * Typed configuration for the rendering pipeline. Replaces the PRODUCER_*
- * env var sprawl with a structured interface. Env vars still work as
- * fallbacks for backward compatibility during migration.
- */
-/**
- * Full engine configuration. All fields are wired through the config
- * object; env vars serve as backward-compatible fallbacks resolved
- * in `resolveConfig()`.
- */
-export interface EngineConfig {
-    fps: 24 | 30 | 60;
-    quality: "draft" | "standard" | "high";
-    format: "jpeg" | "png";
-    jpegQuality: number;
-    /** Max worker count. "auto" uses CPU-based heuristic. */
-    concurrency: number | "auto";
-    /** CPU cores allocated per worker. */
-    coresPerWorker: number;
-    /** Minimum frames before parallel workers are used. */
-    minParallelFrames: number;
-    /** Frame count threshold for "large render" heuristics. */
-    largeRenderThreshold: number;
-    chromePath?: string;
-    disableGpu: boolean;
-    enableBrowserPool: boolean;
-    browserTimeout: number;
-    protocolTimeout: number;
-    /** Expected Chromium major version (optional validation). */
-    expectedChromiumMajor?: number;
-    /** Force screenshot capture mode (skip BeginFrame even on Linux). */
-    forceScreenshot: boolean;
-    enableChunkedEncode: boolean;
-    chunkSizeFrames: number;
-    enableStreamingEncode: boolean;
-    /** Timeout for FFmpeg frame encoding (ms). Default: 600_000 */
-    ffmpegEncodeTimeout: number;
-    /** Timeout for FFmpeg mux/faststart processes (ms). Default: 300_000 */
-    ffmpegProcessTimeout: number;
-    /** Timeout for FFmpeg streaming encode (ms). Default: 600_000 */
-    ffmpegStreamingTimeout: number;
-    audioGain: number;
-    frameDataUriCacheLimit: number;
-    playerReadyTimeout: number;
-    renderReadyTimeout: number;
-    /** Verify Hyperframe runtime SHA256 checksums. */
-    verifyRuntime: boolean;
-    /** Custom manifest path for Hyperframe runtime. */
-    runtimeManifestPath?: string;
-    debug: boolean;
-}
-/** Default configuration — sensible for Hyperframes compositions. */
-export declare const DEFAULT_CONFIG: EngineConfig;
-/**
- * Resolve configuration by merging: defaults ← env vars ← explicit overrides.
- * Env vars provide backward compatibility during migration; explicit config
- * takes precedence over everything.
- */
-export declare function resolveConfig(overrides?: Partial<EngineConfig>): EngineConfig;
-//# sourceMappingURL=config.d.ts.map

package/dist/config.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH;;;;GAIG;AACH,MAAM,WAAW,YAAY;IAE3B,GAAG,EAAE,EAAE,GAAG,EAAE,GAAG,EAAE,CAAC;IAClB,OAAO,EAAE,OAAO,GAAG,UAAU,GAAG,MAAM,CAAC;IACvC,MAAM,EAAE,MAAM,GAAG,KAAK,CAAC;IACvB,WAAW,EAAE,MAAM,CAAC;IAGpB,yDAAyD;IACzD,WAAW,EAAE,MAAM,GAAG,MAAM,CAAC;IAC7B,sCAAsC;IACtC,cAAc,EAAE,MAAM,CAAC;IACvB,uDAAuD;IACvD,iBAAiB,EAAE,MAAM,CAAC;IAC1B,2DAA2D;IAC3D,oBAAoB,EAAE,MAAM,CAAC;IAG7B,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,UAAU,EAAE,OAAO,CAAC;IACpB,iBAAiB,EAAE,OAAO,CAAC;IAC3B,cAAc,EAAE,MAAM,CAAC;IACvB,eAAe,EAAE,MAAM,CAAC;IACxB,6DAA6D;IAC7D,qBAAqB,CAAC,EAAE,MAAM,CAAC;IAC/B,qEAAqE;IACrE,eAAe,EAAE,OAAO,CAAC;IAGzB,mBAAmB,EAAE,OAAO,CAAC;IAC7B,eAAe,EAAE,MAAM,CAAC;IACxB,qBAAqB,EAAE,OAAO,CAAC;IAG/B,+DAA+D;IAC/D,mBAAmB,EAAE,MAAM,CAAC;IAC5B,wEAAwE;IACxE,oBAAoB,EAAE,MAAM,CAAC;IAC7B,iEAAiE;IACjE,sBAAsB,EAAE,MAAM,CAAC;IAG/B,SAAS,EAAE,MAAM,CAAC;IAClB,sBAAsB,EAAE,MAAM,CAAC;IAG/B,kBAAkB,EAAE,MAAM,CAAC;IAC3B,kBAAkB,EAAE,MAAM,CAAC;IAG3B,kDAAkD;IAClD,aAAa,EAAE,OAAO,CAAC;IACvB,mDAAmD;IACnD,mBAAmB,CAAC,EAAE,MAAM,CAAC;IAG7B,KAAK,EAAE,OAAO,CAAC;CAChB;AAED,qEAAqE;AACrE,eAAO,MAAM,cAAc,EAAE,YAkC5B,CAAC;AAEF;;;;GAIG;AACH,wBAAgB,aAAa,CAAC,SAAS,CAAC,EAAE,OAAO,CAAC,YAAY,CAAC,GAAG,YAAY,CA6D7E"}

package/dist/config.js

@@ -1,92 +0,0 @@
-/**
- * Engine Configuration
- *
- * Typed configuration for the rendering pipeline. Replaces the PRODUCER_*
- * env var sprawl with a structured interface. Env vars still work as
- * fallbacks for backward compatibility during migration.
- */
-/** Default configuration — sensible for Hyperframes compositions. */
-export const DEFAULT_CONFIG = {
-    fps: 30,
-    quality: "standard",
-    format: "jpeg",
-    jpegQuality: 80,
-    concurrency: "auto",
-    coresPerWorker: 2.5,
-    minParallelFrames: 120,
-    largeRenderThreshold: 1000,
-    disableGpu: false,
-    enableBrowserPool: false,
-    browserTimeout: 120_000,
-    protocolTimeout: 300_000,
-    forceScreenshot: false,
-    enableChunkedEncode: false,
-    chunkSizeFrames: 360,
-    enableStreamingEncode: false,
-    ffmpegEncodeTimeout: 600_000,
-    ffmpegProcessTimeout: 300_000,
-    ffmpegStreamingTimeout: 600_000,
-    audioGain: 1.35,
-    frameDataUriCacheLimit: 256,
-    playerReadyTimeout: 45_000,
-    renderReadyTimeout: 15_000,
-    verifyRuntime: true,
-    debug: false,
-};
-/**
- * Resolve configuration by merging: defaults ← env vars ← explicit overrides.
- * Env vars provide backward compatibility during migration; explicit config
- * takes precedence over everything.
- */
-export function resolveConfig(overrides) {
-    const env = (key) => process.env[key];
-    const envNum = (key, fallback) => {
-        const raw = env(key);
-        if (raw === undefined || raw === "")
-            return fallback;
-        const n = Number(raw);
-        return Number.isFinite(n) ? n : fallback;
-    };
-    const envBool = (key, fallback) => {
-        const raw = env(key);
-        if (raw === undefined)
-            return fallback;
-        return raw === "true";
-    };
-    // Env-var layer (backward compat)
-    const fromEnv = {
-        concurrency: env("PRODUCER_MAX_WORKERS") ? Number(env("PRODUCER_MAX_WORKERS")) : undefined,
-        coresPerWorker: envNum("PRODUCER_CORES_PER_WORKER", DEFAULT_CONFIG.coresPerWorker),
-        minParallelFrames: envNum("PRODUCER_MIN_PARALLEL_FRAMES", DEFAULT_CONFIG.minParallelFrames),
-        largeRenderThreshold: envNum("PRODUCER_LARGE_RENDER_THRESHOLD", DEFAULT_CONFIG.largeRenderThreshold),
-        chromePath: env("PRODUCER_HEADLESS_SHELL_PATH"),
-        disableGpu: envBool("PRODUCER_DISABLE_GPU", DEFAULT_CONFIG.disableGpu),
-        enableBrowserPool: envBool("PRODUCER_ENABLE_BROWSER_POOL", DEFAULT_CONFIG.enableBrowserPool),
-        browserTimeout: envNum("PRODUCER_PUPPETEER_LAUNCH_TIMEOUT_MS", DEFAULT_CONFIG.browserTimeout),
-        protocolTimeout: envNum("PRODUCER_PUPPETEER_PROTOCOL_TIMEOUT_MS", DEFAULT_CONFIG.protocolTimeout),
-        expectedChromiumMajor: env("PRODUCER_EXPECTED_CHROMIUM_MAJOR")
-            ? Number(env("PRODUCER_EXPECTED_CHROMIUM_MAJOR"))
-            : undefined,
-        forceScreenshot: envBool("PRODUCER_FORCE_SCREENSHOT", DEFAULT_CONFIG.forceScreenshot),
-        enableChunkedEncode: envBool("PRODUCER_ENABLE_CHUNKED_ENCODE", DEFAULT_CONFIG.enableChunkedEncode),
-        chunkSizeFrames: Math.max(120, envNum("PRODUCER_CHUNK_SIZE_FRAMES", DEFAULT_CONFIG.chunkSizeFrames)),
-        enableStreamingEncode: envBool("PRODUCER_ENABLE_STREAMING_ENCODE", DEFAULT_CONFIG.enableStreamingEncode),
-        ffmpegEncodeTimeout: envNum("FFMPEG_ENCODE_TIMEOUT_MS", DEFAULT_CONFIG.ffmpegEncodeTimeout),
-        ffmpegProcessTimeout: envNum("FFMPEG_PROCESS_TIMEOUT_MS", DEFAULT_CONFIG.ffmpegProcessTimeout),
-        ffmpegStreamingTimeout: envNum("FFMPEG_STREAMING_TIMEOUT_MS", DEFAULT_CONFIG.ffmpegStreamingTimeout),
-        audioGain: envNum("PRODUCER_AUDIO_GAIN", DEFAULT_CONFIG.audioGain),
-        frameDataUriCacheLimit: Math.max(32, envNum("PRODUCER_FRAME_DATA_URI_CACHE_LIMIT", DEFAULT_CONFIG.frameDataUriCacheLimit)),
-        playerReadyTimeout: envNum("PRODUCER_PLAYER_READY_TIMEOUT_MS", DEFAULT_CONFIG.playerReadyTimeout),
-        renderReadyTimeout: envNum("PRODUCER_RENDER_READY_TIMEOUT_MS", DEFAULT_CONFIG.renderReadyTimeout),
-        verifyRuntime: env("PRODUCER_VERIFY_HYPERFRAME_RUNTIME") !== "false",
-        runtimeManifestPath: env("PRODUCER_HYPERFRAME_MANIFEST_PATH"),
-    };
-    // Remove undefined values so they don't override defaults
-    const cleanEnv = Object.fromEntries(Object.entries(fromEnv).filter(([, v]) => v !== undefined));
-    return {
-        ...DEFAULT_CONFIG,
-        ...cleanEnv,
-        ...overrides,
-    };
-}
-//# sourceMappingURL=config.js.map

package/dist/config.js.map

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

package/dist/index.d.ts

@@ -1,49 +0,0 @@
-/**
- * @hyperframes/engine
- *
- * Seekable web page to video rendering engine.
- * Framework-agnostic: works with GSAP, Lottie, Three.js, CSS animations,
- * or any web content that implements the window.__hf seek protocol.
- *
- * ## Error Convention
- *
- * Engine services use three error strategies depending on the operation type:
- *
- * - **Orchestration services throw on failure.** Browser launch, session init,
- *   frame capture, and CDP operations propagate errors as thrown exceptions.
- *   Callers are expected to catch and handle (e.g. frameCapture, browserManager,
- *   screenshotService, videoFrameExtractor.extractVideoFramesRange).
- *
- * - **FFmpeg process wrappers return `{ success, error? }` result objects.**
- *   Encoding, muxing, audio mixing, and streaming encode operations never reject.
- *   They resolve with a result that includes `success: boolean` and an optional
- *   `error` string (e.g. chunkEncoder, audioMixer, streamingEncoder).
- *
- * - **Cleanup and teardown functions never throw.** Browser close, session close,
- *   temp directory removal, and resource release swallow errors via `.catch(() => {})`
- *   to avoid masking the original failure (e.g. releaseBrowser, closeCaptureSession,
- *   FrameLookupTable.cleanup).
- *
- * - **Optional lookups return `T | undefined` or `T | null`.**
- *   Functions that may legitimately find nothing (resolveHeadlessShellPath,
- *   getFrameAtTime, detectGpuEncoder) return a nullable value instead of throwing.
- *
- */
-export type { HfProtocol, HfMediaElement, CaptureOptions, CaptureResult, CaptureBufferResult, CapturePerfSummary, } from "./types.js";
-export { resolveConfig, DEFAULT_CONFIG, type EngineConfig } from "./config.js";
-export { acquireBrowser, releaseBrowser, resolveHeadlessShellPath, buildChromeArgs, ENABLE_BROWSER_POOL, type BuildChromeArgsOptions, type CaptureMode, type AcquiredBrowser, } from "./services/browserManager.js";
-export { createCaptureSession, initializeSession, closeCaptureSession, captureFrame, captureFrameToBuffer, getCompositionDuration, getCapturePerfSummary, prepareCaptureSessionForReuse, type CaptureSession, type BeforeCaptureHook, } from "./services/frameCapture.js";
-export { beginFrameCapture, pageScreenshotCapture, getCdpSession, injectVideoFramesBatch, syncVideoFrameVisibility, cdpSessionCache, type BeginFrameResult, } from "./services/screenshotService.js";
-export { encodeFramesFromDir, encodeFramesChunkedConcat, muxVideoWithAudio, applyFaststart, detectGpuEncoder, ENCODER_PRESETS, type GpuEncoder, } from "./services/chunkEncoder.js";
-export type { EncoderOptions, EncodeResult, MuxResult, } from "./services/chunkEncoder.types.js";
-export { spawnStreamingEncoder, createFrameReorderBuffer, type StreamingEncoder, type StreamingEncoderOptions, type StreamingEncoderResult, type FrameReorderBuffer, } from "./services/streamingEncoder.js";
-export { parseVideoElements, extractVideoFramesRange, extractAllVideoFrames, getFrameAtTime, createFrameLookupTable, FrameLookupTable, type VideoElement, type ExtractedFrames, type ExtractionOptions, type ExtractionResult, } from "./services/videoFrameExtractor.js";
-export { createVideoFrameInjector } from "./services/videoFrameInjector.js";
-export { parseAudioElements, processCompositionAudio, } from "./services/audioMixer.js";
-export type { AudioElement, AudioTrack, MixResult, } from "./services/audioMixer.types.js";
-export { calculateOptimalWorkers, distributeFrames, executeParallelCapture, mergeWorkerFrames, getSystemResources, type WorkerTask, type WorkerResult, type ParallelProgress, } from "./services/parallelCoordinator.js";
-export { createFileServer, type FileServerOptions, type FileServerHandle } from "./services/fileServer.js";
-export { quantizeTimeToFrame, MEDIA_VISUAL_STYLE_PROPERTIES } from "@hyperframes/core";
-export { extractVideoMetadata, extractAudioMetadata, type VideoMetadata, type AudioMetadata } from "./utils/ffprobe.js";
-export { downloadToTemp, isHttpUrl } from "./utils/urlDownloader.js";
-//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA8BG;AAGH,YAAY,EACV,UAAU,EACV,cAAc,EACd,cAAc,EACd,aAAa,EACb,mBAAmB,EACnB,kBAAkB,GACnB,MAAM,YAAY,CAAC;AAGpB,OAAO,EAAE,aAAa,EAAE,cAAc,EAAE,KAAK,YAAY,EAAE,MAAM,aAAa,CAAC;AAG/E,OAAO,EACL,cAAc,EACd,cAAc,EACd,wBAAwB,EACxB,eAAe,EACf,mBAAmB,EACnB,KAAK,sBAAsB,EAC3B,KAAK,WAAW,EAChB,KAAK,eAAe,GACrB,MAAM,8BAA8B,CAAC;AAGtC,OAAO,EACL,oBAAoB,EACpB,iBAAiB,EACjB,mBAAmB,EACnB,YAAY,EACZ,oBAAoB,EACpB,sBAAsB,EACtB,qBAAqB,EACrB,6BAA6B,EAC7B,KAAK,cAAc,EACnB,KAAK,iBAAiB,GACvB,MAAM,4BAA4B,CAAC;AAGpC,OAAO,EACL,iBAAiB,EACjB,qBAAqB,EACrB,aAAa,EACb,sBAAsB,EACtB,wBAAwB,EACxB,eAAe,EACf,KAAK,gBAAgB,GACtB,MAAM,iCAAiC,CAAC;AAGzC,OAAO,EACL,mBAAmB,EACnB,yBAAyB,EACzB,iBAAiB,EACjB,cAAc,EACd,gBAAgB,EAChB,eAAe,EACf,KAAK,UAAU,GAChB,MAAM,4BAA4B,CAAC;AACpC,YAAY,EACV,cAAc,EACd,YAAY,EACZ,SAAS,GACV,MAAM,kCAAkC,CAAC;AAE1C,OAAO,EACL,qBAAqB,EACrB,wBAAwB,EACxB,KAAK,gBAAgB,EACrB,KAAK,uBAAuB,EAC5B,KAAK,sBAAsB,EAC3B,KAAK,kBAAkB,GACxB,MAAM,gCAAgC,CAAC;AAGxC,OAAO,EACL,kBAAkB,EAClB,uBAAuB,EACvB,qBAAqB,EACrB,cAAc,EACd,sBAAsB,EACtB,gBAAgB,EAChB,KAAK,YAAY,EACjB,KAAK,eAAe,EACpB,KAAK,iBAAiB,EACtB,KAAK,gBAAgB,GACtB,MAAM,mCAAmC,CAAC;AAE3C,OAAO,EAAE,wBAAwB,EAAE,MAAM,kCAAkC,CAAC;AAE5E,OAAO,EACL,kBAAkB,EAClB,uBAAuB,GACxB,MAAM,0BAA0B,CAAC;AAClC,YAAY,EACV,YAAY,EACZ,UAAU,EACV,SAAS,GACV,MAAM,gCAAgC,CAAC;AAGxC,OAAO,EACL,uBAAuB,EACvB,gBAAgB,EAChB,sBAAsB,EACtB,iBAAiB,EACjB,kBAAkB,EAClB,KAAK,UAAU,EACf,KAAK,YAAY,EACjB,KAAK,gBAAgB,GACtB,MAAM,mCAAmC,CAAC;AAG3C,OAAO,EAAE,gBAAgB,EAAE,KAAK,iBAAiB,EAAE,KAAK,gBAAgB,EAAE,MAAM,0BAA0B,CAAC;AAG3G,OAAO,EAAE,mBAAmB,EAAE,6BAA6B,EAAE,MAAM,mBAAmB,CAAC;AAEvF,OAAO,EAAE,oBAAoB,EAAE,oBAAoB,EAAE,KAAK,aAAa,EAAE,KAAK,aAAa,EAAE,MAAM,oBAAoB,CAAC;AAExH,OAAO,EAAE,cAAc,EAAE,SAAS,EAAE,MAAM,0BAA0B,CAAC"}

package/dist/index.js

@@ -1,55 +0,0 @@
-/**
- * @hyperframes/engine
- *
- * Seekable web page to video rendering engine.
- * Framework-agnostic: works with GSAP, Lottie, Three.js, CSS animations,
- * or any web content that implements the window.__hf seek protocol.
- *
- * ## Error Convention
- *
- * Engine services use three error strategies depending on the operation type:
- *
- * - **Orchestration services throw on failure.** Browser launch, session init,
- *   frame capture, and CDP operations propagate errors as thrown exceptions.
- *   Callers are expected to catch and handle (e.g. frameCapture, browserManager,
- *   screenshotService, videoFrameExtractor.extractVideoFramesRange).
- *
- * - **FFmpeg process wrappers return `{ success, error? }` result objects.**
- *   Encoding, muxing, audio mixing, and streaming encode operations never reject.
- *   They resolve with a result that includes `success: boolean` and an optional
- *   `error` string (e.g. chunkEncoder, audioMixer, streamingEncoder).
- *
- * - **Cleanup and teardown functions never throw.** Browser close, session close,
- *   temp directory removal, and resource release swallow errors via `.catch(() => {})`
- *   to avoid masking the original failure (e.g. releaseBrowser, closeCaptureSession,
- *   FrameLookupTable.cleanup).
- *
- * - **Optional lookups return `T | undefined` or `T | null`.**
- *   Functions that may legitimately find nothing (resolveHeadlessShellPath,
- *   getFrameAtTime, detectGpuEncoder) return a nullable value instead of throwing.
- *
- */
-// ── Configuration ──────────────────────────────────────────────────────────────
-export { resolveConfig, DEFAULT_CONFIG } from "./config.js";
-// ── Browser management ─────────────────────────────────────────────────────────
-export { acquireBrowser, releaseBrowser, resolveHeadlessShellPath, buildChromeArgs, ENABLE_BROWSER_POOL, } from "./services/browserManager.js";
-// ── Frame capture pipeline ──────────────────────────────────────────────────────
-export { createCaptureSession, initializeSession, closeCaptureSession, captureFrame, captureFrameToBuffer, getCompositionDuration, getCapturePerfSummary, prepareCaptureSessionForReuse, } from "./services/frameCapture.js";
-// ── Screenshot (BeginFrame) ─────────────────────────────────────────────────────
-export { beginFrameCapture, pageScreenshotCapture, getCdpSession, injectVideoFramesBatch, syncVideoFrameVisibility, cdpSessionCache, } from "./services/screenshotService.js";
-// ── Encoding ───────────────────────────────────────────────────────────────────
-export { encodeFramesFromDir, encodeFramesChunkedConcat, muxVideoWithAudio, applyFaststart, detectGpuEncoder, ENCODER_PRESETS, } from "./services/chunkEncoder.js";
-export { spawnStreamingEncoder, createFrameReorderBuffer, } from "./services/streamingEncoder.js";
-// ── Media processing ───────────────────────────────────────────────────────────
-export { parseVideoElements, extractVideoFramesRange, extractAllVideoFrames, getFrameAtTime, createFrameLookupTable, FrameLookupTable, } from "./services/videoFrameExtractor.js";
-export { createVideoFrameInjector } from "./services/videoFrameInjector.js";
-export { parseAudioElements, processCompositionAudio, } from "./services/audioMixer.js";
-// ── Parallel rendering ─────────────────────────────────────────────────────────
-export { calculateOptimalWorkers, distributeFrames, executeParallelCapture, mergeWorkerFrames, getSystemResources, } from "./services/parallelCoordinator.js";
-// ── File server ────────────────────────────────────────────────────────────────
-export { createFileServer } from "./services/fileServer.js";
-// ── Utilities ──────────────────────────────────────────────────────────────────
-export { quantizeTimeToFrame, MEDIA_VISUAL_STYLE_PROPERTIES } from "@hyperframes/core";
-export { extractVideoMetadata, extractAudioMetadata } from "./utils/ffprobe.js";
-export { downloadToTemp, isHttpUrl } from "./utils/urlDownloader.js";
-//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA8BG;AAYH,kFAAkF;AAClF,OAAO,EAAE,aAAa,EAAE,cAAc,EAAqB,MAAM,aAAa,CAAC;AAE/E,kFAAkF;AAClF,OAAO,EACL,cAAc,EACd,cAAc,EACd,wBAAwB,EACxB,eAAe,EACf,mBAAmB,GAIpB,MAAM,8BAA8B,CAAC;AAEtC,mFAAmF;AACnF,OAAO,EACL,oBAAoB,EACpB,iBAAiB,EACjB,mBAAmB,EACnB,YAAY,EACZ,oBAAoB,EACpB,sBAAsB,EACtB,qBAAqB,EACrB,6BAA6B,GAG9B,MAAM,4BAA4B,CAAC;AAEpC,mFAAmF;AACnF,OAAO,EACL,iBAAiB,EACjB,qBAAqB,EACrB,aAAa,EACb,sBAAsB,EACtB,wBAAwB,EACxB,eAAe,GAEhB,MAAM,iCAAiC,CAAC;AAEzC,kFAAkF;AAClF,OAAO,EACL,mBAAmB,EACnB,yBAAyB,EACzB,iBAAiB,EACjB,cAAc,EACd,gBAAgB,EAChB,eAAe,GAEhB,MAAM,4BAA4B,CAAC;AAOpC,OAAO,EACL,qBAAqB,EACrB,wBAAwB,GAKzB,MAAM,gCAAgC,CAAC;AAExC,kFAAkF;AAClF,OAAO,EACL,kBAAkB,EAClB,uBAAuB,EACvB,qBAAqB,EACrB,cAAc,EACd,sBAAsB,EACtB,gBAAgB,GAKjB,MAAM,mCAAmC,CAAC;AAE3C,OAAO,EAAE,wBAAwB,EAAE,MAAM,kCAAkC,CAAC;AAE5E,OAAO,EACL,kBAAkB,EAClB,uBAAuB,GACxB,MAAM,0BAA0B,CAAC;AAOlC,kFAAkF;AAClF,OAAO,EACL,uBAAuB,EACvB,gBAAgB,EAChB,sBAAsB,EACtB,iBAAiB,EACjB,kBAAkB,GAInB,MAAM,mCAAmC,CAAC;AAE3C,kFAAkF;AAClF,OAAO,EAAE,gBAAgB,EAAiD,MAAM,0BAA0B,CAAC;AAE3G,kFAAkF;AAClF,OAAO,EAAE,mBAAmB,EAAE,6BAA6B,EAAE,MAAM,mBAAmB,CAAC;AAEvF,OAAO,EAAE,oBAAoB,EAAE,oBAAoB,EAA0C,MAAM,oBAAoB,CAAC;AAExH,OAAO,EAAE,cAAc,EAAE,SAAS,EAAE,MAAM,0BAA0B,CAAC"}

package/dist/services/audioMixer.d.ts

@@ -1,11 +0,0 @@
-/**
- * Audio Mixer Service
- *
- * Processes and mixes audio tracks using FFmpeg.
- */
-import { type EngineConfig } from "../config.js";
-import type { AudioElement, MixResult } from "./audioMixer.types.js";
-export type { AudioElement, AudioTrack, MixResult } from "./audioMixer.types.js";
-export declare function parseAudioElements(html: string): AudioElement[];
-export declare function processCompositionAudio(elements: AudioElement[], baseDir: string, workDir: string, outputPath: string, totalDuration: number, signal?: AbortSignal, config?: Partial<Pick<EngineConfig, "ffmpegProcessTimeout" | "audioGain">>): Promise<MixResult>;
-//# sourceMappingURL=audioMixer.d.ts.map

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

@@ -1 +0,0 @@
-{"version":3,"file":"audioMixer.d.ts","sourceRoot":"","sources":["../../src/services/audioMixer.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAOH,OAAO,EAAkB,KAAK,YAAY,EAAE,MAAM,cAAc,CAAC;AAEjE,OAAO,KAAK,EAAE,YAAY,EAAc,SAAS,EAAE,MAAM,uBAAuB,CAAC;AAEjF,YAAY,EAAE,YAAY,EAAE,UAAU,EAAE,SAAS,EAAE,MAAM,uBAAuB,CAAC;AASjF,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,MAAM,GAAG,YAAY,EAAE,CAuD/D;AAyMD,wBAAsB,uBAAuB,CAC3C,QAAQ,EAAE,YAAY,EAAE,EACxB,OAAO,EAAE,MAAM,EACf,OAAO,EAAE,MAAM,EACf,UAAU,EAAE,MAAM,EAClB,aAAa,EAAE,MAAM,EACrB,MAAM,CAAC,EAAE,WAAW,EACpB,MAAM,CAAC,EAAE,OAAO,CAAC,IAAI,CAAC,YAAY,EAAE,sBAAsB,GAAG,WAAW,CAAC,CAAC,GACzE,OAAO,CAAC,SAAS,CAAC,CAuGpB"}