@hyperframes/engine 0.1.0 → 0.1.2

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (107) hide show
  1. package/README.md +78 -0
  2. package/package.json +5 -3
  3. package/src/config.ts +32 -8
  4. package/src/index.ts +15 -17
  5. package/src/services/audioMixer.ts +33 -8
  6. package/src/services/browserManager.ts +7 -2
  7. package/src/services/chunkEncoder.ts +24 -3
  8. package/src/services/fileServer.ts +3 -1
  9. package/src/services/frameCapture.ts +46 -13
  10. package/src/services/parallelCoordinator.ts +25 -5
  11. package/src/services/screenshotService.ts +4 -1
  12. package/src/services/videoFrameExtractor.ts +19 -4
  13. package/src/services/videoFrameInjector.ts +9 -3
  14. package/src/utils/ffprobe.ts +25 -4
  15. package/src/utils/urlDownloader.ts +5 -1
  16. package/dist/config.d.ts +0 -62
  17. package/dist/config.d.ts.map +0 -1
  18. package/dist/config.js +0 -92
  19. package/dist/config.js.map +0 -1
  20. package/dist/config.test.d.ts +0 -2
  21. package/dist/config.test.d.ts.map +0 -1
  22. package/dist/config.test.js +0 -77
  23. package/dist/config.test.js.map +0 -1
  24. package/dist/index.d.ts +0 -49
  25. package/dist/index.d.ts.map +0 -1
  26. package/dist/index.js +0 -55
  27. package/dist/index.js.map +0 -1
  28. package/dist/services/audioMixer.d.ts +0 -11
  29. package/dist/services/audioMixer.d.ts.map +0 -1
  30. package/dist/services/audioMixer.js +0 -306
  31. package/dist/services/audioMixer.js.map +0 -1
  32. package/dist/services/audioMixer.types.d.ts +0 -27
  33. package/dist/services/audioMixer.types.d.ts.map +0 -1
  34. package/dist/services/audioMixer.types.js +0 -2
  35. package/dist/services/audioMixer.types.js.map +0 -1
  36. package/dist/services/browserManager.d.ts +0 -29
  37. package/dist/services/browserManager.d.ts.map +0 -1
  38. package/dist/services/browserManager.js +0 -175
  39. package/dist/services/browserManager.js.map +0 -1
  40. package/dist/services/chunkEncoder.d.ts +0 -32
  41. package/dist/services/chunkEncoder.d.ts.map +0 -1
  42. package/dist/services/chunkEncoder.js +0 -347
  43. package/dist/services/chunkEncoder.js.map +0 -1
  44. package/dist/services/chunkEncoder.test.d.ts +0 -2
  45. package/dist/services/chunkEncoder.test.d.ts.map +0 -1
  46. package/dist/services/chunkEncoder.test.js +0 -24
  47. package/dist/services/chunkEncoder.test.js.map +0 -1
  48. package/dist/services/chunkEncoder.types.d.ts +0 -26
  49. package/dist/services/chunkEncoder.types.d.ts.map +0 -1
  50. package/dist/services/chunkEncoder.types.js +0 -2
  51. package/dist/services/chunkEncoder.types.js.map +0 -1
  52. package/dist/services/fileServer.d.ts +0 -25
  53. package/dist/services/fileServer.d.ts.map +0 -1
  54. package/dist/services/fileServer.js +0 -138
  55. package/dist/services/fileServer.js.map +0 -1
  56. package/dist/services/frameCapture.d.ts +0 -52
  57. package/dist/services/frameCapture.d.ts.map +0 -1
  58. package/dist/services/frameCapture.js +0 -317
  59. package/dist/services/frameCapture.js.map +0 -1
  60. package/dist/services/parallelCoordinator.d.ts +0 -40
  61. package/dist/services/parallelCoordinator.d.ts.map +0 -1
  62. package/dist/services/parallelCoordinator.js +0 -192
  63. package/dist/services/parallelCoordinator.js.map +0 -1
  64. package/dist/services/parallelCoordinator.test.d.ts +0 -2
  65. package/dist/services/parallelCoordinator.test.d.ts.map +0 -1
  66. package/dist/services/parallelCoordinator.test.js +0 -38
  67. package/dist/services/parallelCoordinator.test.js.map +0 -1
  68. package/dist/services/screenshotService.d.ts +0 -28
  69. package/dist/services/screenshotService.d.ts.map +0 -1
  70. package/dist/services/screenshotService.js +0 -190
  71. package/dist/services/screenshotService.js.map +0 -1
  72. package/dist/services/streamingEncoder.d.ts +0 -49
  73. package/dist/services/streamingEncoder.d.ts.map +0 -1
  74. package/dist/services/streamingEncoder.js +0 -227
  75. package/dist/services/streamingEncoder.js.map +0 -1
  76. package/dist/services/videoFrameExtractor.d.ts +0 -65
  77. package/dist/services/videoFrameExtractor.d.ts.map +0 -1
  78. package/dist/services/videoFrameExtractor.js +0 -302
  79. package/dist/services/videoFrameExtractor.js.map +0 -1
  80. package/dist/services/videoFrameInjector.d.ts +0 -17
  81. package/dist/services/videoFrameInjector.d.ts.map +0 -1
  82. package/dist/services/videoFrameInjector.js +0 -92
  83. package/dist/services/videoFrameInjector.js.map +0 -1
  84. package/dist/types.d.ts +0 -79
  85. package/dist/types.d.ts.map +0 -1
  86. package/dist/types.js +0 -8
  87. package/dist/types.js.map +0 -1
  88. package/dist/utils/ffprobe.d.ts +0 -18
  89. package/dist/utils/ffprobe.d.ts.map +0 -1
  90. package/dist/utils/ffprobe.js +0 -137
  91. package/dist/utils/ffprobe.js.map +0 -1
  92. package/dist/utils/gpuEncoder.d.ts +0 -11
  93. package/dist/utils/gpuEncoder.d.ts.map +0 -1
  94. package/dist/utils/gpuEncoder.js +0 -55
  95. package/dist/utils/gpuEncoder.js.map +0 -1
  96. package/dist/utils/parityContract.d.ts +0 -3
  97. package/dist/utils/parityContract.d.ts.map +0 -1
  98. package/dist/utils/parityContract.js +0 -35
  99. package/dist/utils/parityContract.js.map +0 -1
  100. package/dist/utils/runFfmpeg.d.ts +0 -19
  101. package/dist/utils/runFfmpeg.d.ts.map +0 -1
  102. package/dist/utils/runFfmpeg.js +0 -62
  103. package/dist/utils/runFfmpeg.js.map +0 -1
  104. package/dist/utils/urlDownloader.d.ts +0 -3
  105. package/dist/utils/urlDownloader.d.ts.map +0 -1
  106. package/dist/utils/urlDownloader.js +0 -68
  107. package/dist/utils/urlDownloader.js.map +0 -1
@@ -71,7 +71,10 @@ export function createVideoFrameInjector(
71
71
  ): BeforeCaptureHook | null {
72
72
  if (!frameLookup) return null;
73
73
 
74
- const cacheLimit = Math.max(32, config?.frameDataUriCacheLimit ?? DEFAULT_CONFIG.frameDataUriCacheLimit);
74
+ const cacheLimit = Math.max(
75
+ 32,
76
+ config?.frameDataUriCacheLimit ?? DEFAULT_CONFIG.frameDataUriCacheLimit,
77
+ );
75
78
  const frameCache = createFrameDataUriCache(cacheLimit);
76
79
  const lastInjectedFrameByVideo = new Map<string, number>();
77
80
 
@@ -81,13 +84,16 @@ export function createVideoFrameInjector(
81
84
  const updates: Array<{ videoId: string; dataUri: string; frameIndex: number }> = [];
82
85
  const activeIds = new Set<string>();
83
86
  if (activePayloads.size > 0) {
84
- const pendingReads: Array<Promise<{ videoId: string; dataUri: string; frameIndex: number }>> = [];
87
+ const pendingReads: Array<Promise<{ videoId: string; dataUri: string; frameIndex: number }>> =
88
+ [];
85
89
  for (const [videoId, payload] of activePayloads) {
86
90
  activeIds.add(videoId);
87
91
  const lastFrameIndex = lastInjectedFrameByVideo.get(videoId);
88
92
  if (lastFrameIndex === payload.frameIndex) continue;
89
93
  pendingReads.push(
90
- frameCache.get(payload.framePath).then((dataUri) => ({ videoId, dataUri, frameIndex: payload.frameIndex })),
94
+ frameCache
95
+ .get(payload.framePath)
96
+ .then((dataUri) => ({ videoId, dataUri, frameIndex: payload.frameIndex })),
91
97
  );
92
98
  }
93
99
  updates.push(...(await Promise.all(pendingReads)));
@@ -59,7 +59,15 @@ export async function extractVideoMetadata(filePath: string): Promise<VideoMetad
59
59
  }
60
60
 
61
61
  const probePromise = new Promise<VideoMetadata>((resolve, reject) => {
62
- const args = ["-v", "quiet", "-print_format", "json", "-show_format", "-show_streams", filePath];
62
+ const args = [
63
+ "-v",
64
+ "quiet",
65
+ "-print_format",
66
+ "json",
67
+ "-show_format",
68
+ "-show_streams",
69
+ filePath,
70
+ ];
63
71
 
64
72
  const ffprobe = spawn("ffprobe", args);
65
73
  let stdout = "";
@@ -87,7 +95,8 @@ export async function extractVideoMetadata(filePath: string): Promise<VideoMetad
87
95
  }
88
96
 
89
97
  const hasAudio = output.streams.some((s) => s.codec_type === "audio");
90
- const fps = parseFrameRate(videoStream.avg_frame_rate) || parseFrameRate(videoStream.r_frame_rate);
98
+ const fps =
99
+ parseFrameRate(videoStream.avg_frame_rate) || parseFrameRate(videoStream.r_frame_rate);
91
100
  const durationSeconds = output.format.duration ? parseFloat(output.format.duration) : 0;
92
101
 
93
102
  const metadata: VideoMetadata = {
@@ -100,7 +109,11 @@ export async function extractVideoMetadata(filePath: string): Promise<VideoMetad
100
109
  };
101
110
  resolve(metadata);
102
111
  } catch (parseError: unknown) {
103
- reject(new Error(`[FFmpeg] Failed to parse ffprobe output: ${parseError instanceof Error ? parseError.message : parseError}`));
112
+ reject(
113
+ new Error(
114
+ `[FFmpeg] Failed to parse ffprobe output: ${parseError instanceof Error ? parseError.message : parseError}`,
115
+ ),
116
+ );
104
117
  }
105
118
  });
106
119
 
@@ -128,7 +141,15 @@ export async function extractAudioMetadata(filePath: string): Promise<AudioMetad
128
141
  }
129
142
 
130
143
  const probePromise = new Promise<AudioMetadata>((resolve, reject) => {
131
- const args = ["-v", "quiet", "-print_format", "json", "-show_format", "-show_streams", filePath];
144
+ const args = [
145
+ "-v",
146
+ "quiet",
147
+ "-print_format",
148
+ "json",
149
+ "-show_format",
150
+ "-show_streams",
151
+ filePath,
152
+ ];
132
153
 
133
154
  const ffprobe = spawn("ffprobe", args);
134
155
  let stdout = "";
@@ -14,7 +14,11 @@ function getFilenameFromUrl(url: string): string {
14
14
  return `download_${hash}${ext}`;
15
15
  }
16
16
 
17
- export async function downloadToTemp(url: string, destDir: string, timeoutMs: number = 300000): Promise<string> {
17
+ export async function downloadToTemp(
18
+ url: string,
19
+ destDir: string,
20
+ timeoutMs: number = 300000,
21
+ ): Promise<string> {
18
22
  const cachedPath = downloadPathCache.get(url);
19
23
  if (cachedPath && existsSync(cachedPath)) {
20
24
  return cachedPath;
package/dist/config.d.ts DELETED
@@ -1,62 +0,0 @@
1
- /**
2
- * Engine Configuration
3
- *
4
- * Typed configuration for the rendering pipeline. Replaces the PRODUCER_*
5
- * env var sprawl with a structured interface. Env vars still work as
6
- * fallbacks for backward compatibility during migration.
7
- */
8
- /**
9
- * Full engine configuration. All fields are wired through the config
10
- * object; env vars serve as backward-compatible fallbacks resolved
11
- * in `resolveConfig()`.
12
- */
13
- export interface EngineConfig {
14
- fps: 24 | 30 | 60;
15
- quality: "draft" | "standard" | "high";
16
- format: "jpeg" | "png";
17
- jpegQuality: number;
18
- /** Max worker count. "auto" uses CPU-based heuristic. */
19
- concurrency: number | "auto";
20
- /** CPU cores allocated per worker. */
21
- coresPerWorker: number;
22
- /** Minimum frames before parallel workers are used. */
23
- minParallelFrames: number;
24
- /** Frame count threshold for "large render" heuristics. */
25
- largeRenderThreshold: number;
26
- chromePath?: string;
27
- disableGpu: boolean;
28
- enableBrowserPool: boolean;
29
- browserTimeout: number;
30
- protocolTimeout: number;
31
- /** Expected Chromium major version (optional validation). */
32
- expectedChromiumMajor?: number;
33
- /** Force screenshot capture mode (skip BeginFrame even on Linux). */
34
- forceScreenshot: boolean;
35
- enableChunkedEncode: boolean;
36
- chunkSizeFrames: number;
37
- enableStreamingEncode: boolean;
38
- /** Timeout for FFmpeg frame encoding (ms). Default: 600_000 */
39
- ffmpegEncodeTimeout: number;
40
- /** Timeout for FFmpeg mux/faststart processes (ms). Default: 300_000 */
41
- ffmpegProcessTimeout: number;
42
- /** Timeout for FFmpeg streaming encode (ms). Default: 600_000 */
43
- ffmpegStreamingTimeout: number;
44
- audioGain: number;
45
- frameDataUriCacheLimit: number;
46
- playerReadyTimeout: number;
47
- renderReadyTimeout: number;
48
- /** Verify Hyperframe runtime SHA256 checksums. */
49
- verifyRuntime: boolean;
50
- /** Custom manifest path for Hyperframe runtime. */
51
- runtimeManifestPath?: string;
52
- debug: boolean;
53
- }
54
- /** Default configuration — sensible for Hyperframes compositions. */
55
- export declare const DEFAULT_CONFIG: EngineConfig;
56
- /**
57
- * Resolve configuration by merging: defaults ← env vars ← explicit overrides.
58
- * Env vars provide backward compatibility during migration; explicit config
59
- * takes precedence over everything.
60
- */
61
- export declare function resolveConfig(overrides?: Partial<EngineConfig>): EngineConfig;
62
- //# sourceMappingURL=config.d.ts.map
@@ -1 +0,0 @@
1
- {"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 DELETED
@@ -1,92 +0,0 @@
1
- /**
2
- * Engine Configuration
3
- *
4
- * Typed configuration for the rendering pipeline. Replaces the PRODUCER_*
5
- * env var sprawl with a structured interface. Env vars still work as
6
- * fallbacks for backward compatibility during migration.
7
- */
8
- /** Default configuration — sensible for Hyperframes compositions. */
9
- export const DEFAULT_CONFIG = {
10
- fps: 30,
11
- quality: "standard",
12
- format: "jpeg",
13
- jpegQuality: 80,
14
- concurrency: "auto",
15
- coresPerWorker: 2.5,
16
- minParallelFrames: 120,
17
- largeRenderThreshold: 1000,
18
- disableGpu: false,
19
- enableBrowserPool: false,
20
- browserTimeout: 120_000,
21
- protocolTimeout: 300_000,
22
- forceScreenshot: false,
23
- enableChunkedEncode: false,
24
- chunkSizeFrames: 360,
25
- enableStreamingEncode: false,
26
- ffmpegEncodeTimeout: 600_000,
27
- ffmpegProcessTimeout: 300_000,
28
- ffmpegStreamingTimeout: 600_000,
29
- audioGain: 1.35,
30
- frameDataUriCacheLimit: 256,
31
- playerReadyTimeout: 45_000,
32
- renderReadyTimeout: 15_000,
33
- verifyRuntime: true,
34
- debug: false,
35
- };
36
- /**
37
- * Resolve configuration by merging: defaults ← env vars ← explicit overrides.
38
- * Env vars provide backward compatibility during migration; explicit config
39
- * takes precedence over everything.
40
- */
41
- export function resolveConfig(overrides) {
42
- const env = (key) => process.env[key];
43
- const envNum = (key, fallback) => {
44
- const raw = env(key);
45
- if (raw === undefined || raw === "")
46
- return fallback;
47
- const n = Number(raw);
48
- return Number.isFinite(n) ? n : fallback;
49
- };
50
- const envBool = (key, fallback) => {
51
- const raw = env(key);
52
- if (raw === undefined)
53
- return fallback;
54
- return raw === "true";
55
- };
56
- // Env-var layer (backward compat)
57
- const fromEnv = {
58
- concurrency: env("PRODUCER_MAX_WORKERS") ? Number(env("PRODUCER_MAX_WORKERS")) : undefined,
59
- coresPerWorker: envNum("PRODUCER_CORES_PER_WORKER", DEFAULT_CONFIG.coresPerWorker),
60
- minParallelFrames: envNum("PRODUCER_MIN_PARALLEL_FRAMES", DEFAULT_CONFIG.minParallelFrames),
61
- largeRenderThreshold: envNum("PRODUCER_LARGE_RENDER_THRESHOLD", DEFAULT_CONFIG.largeRenderThreshold),
62
- chromePath: env("PRODUCER_HEADLESS_SHELL_PATH"),
63
- disableGpu: envBool("PRODUCER_DISABLE_GPU", DEFAULT_CONFIG.disableGpu),
64
- enableBrowserPool: envBool("PRODUCER_ENABLE_BROWSER_POOL", DEFAULT_CONFIG.enableBrowserPool),
65
- browserTimeout: envNum("PRODUCER_PUPPETEER_LAUNCH_TIMEOUT_MS", DEFAULT_CONFIG.browserTimeout),
66
- protocolTimeout: envNum("PRODUCER_PUPPETEER_PROTOCOL_TIMEOUT_MS", DEFAULT_CONFIG.protocolTimeout),
67
- expectedChromiumMajor: env("PRODUCER_EXPECTED_CHROMIUM_MAJOR")
68
- ? Number(env("PRODUCER_EXPECTED_CHROMIUM_MAJOR"))
69
- : undefined,
70
- forceScreenshot: envBool("PRODUCER_FORCE_SCREENSHOT", DEFAULT_CONFIG.forceScreenshot),
71
- enableChunkedEncode: envBool("PRODUCER_ENABLE_CHUNKED_ENCODE", DEFAULT_CONFIG.enableChunkedEncode),
72
- chunkSizeFrames: Math.max(120, envNum("PRODUCER_CHUNK_SIZE_FRAMES", DEFAULT_CONFIG.chunkSizeFrames)),
73
- enableStreamingEncode: envBool("PRODUCER_ENABLE_STREAMING_ENCODE", DEFAULT_CONFIG.enableStreamingEncode),
74
- ffmpegEncodeTimeout: envNum("FFMPEG_ENCODE_TIMEOUT_MS", DEFAULT_CONFIG.ffmpegEncodeTimeout),
75
- ffmpegProcessTimeout: envNum("FFMPEG_PROCESS_TIMEOUT_MS", DEFAULT_CONFIG.ffmpegProcessTimeout),
76
- ffmpegStreamingTimeout: envNum("FFMPEG_STREAMING_TIMEOUT_MS", DEFAULT_CONFIG.ffmpegStreamingTimeout),
77
- audioGain: envNum("PRODUCER_AUDIO_GAIN", DEFAULT_CONFIG.audioGain),
78
- frameDataUriCacheLimit: Math.max(32, envNum("PRODUCER_FRAME_DATA_URI_CACHE_LIMIT", DEFAULT_CONFIG.frameDataUriCacheLimit)),
79
- playerReadyTimeout: envNum("PRODUCER_PLAYER_READY_TIMEOUT_MS", DEFAULT_CONFIG.playerReadyTimeout),
80
- renderReadyTimeout: envNum("PRODUCER_RENDER_READY_TIMEOUT_MS", DEFAULT_CONFIG.renderReadyTimeout),
81
- verifyRuntime: env("PRODUCER_VERIFY_HYPERFRAME_RUNTIME") !== "false",
82
- runtimeManifestPath: env("PRODUCER_HYPERFRAME_MANIFEST_PATH"),
83
- };
84
- // Remove undefined values so they don't override defaults
85
- const cleanEnv = Object.fromEntries(Object.entries(fromEnv).filter(([, v]) => v !== undefined));
86
- return {
87
- ...DEFAULT_CONFIG,
88
- ...cleanEnv,
89
- ...overrides,
90
- };
91
- }
92
- //# sourceMappingURL=config.js.map
@@ -1 +0,0 @@
1
- {"version":3,"file":"config.js","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"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"}
@@ -1,2 +0,0 @@
1
- export {};
2
- //# sourceMappingURL=config.test.d.ts.map
@@ -1 +0,0 @@
1
- {"version":3,"file":"config.test.d.ts","sourceRoot":"","sources":["../src/config.test.ts"],"names":[],"mappings":""}
@@ -1,77 +0,0 @@
1
- import { describe, it, expect, beforeEach, afterEach } from "vitest";
2
- import { resolveConfig, DEFAULT_CONFIG } from "./config.js";
3
- describe("resolveConfig", () => {
4
- const savedEnv = new Map();
5
- function setEnv(key, value) {
6
- savedEnv.set(key, process.env[key]);
7
- process.env[key] = value;
8
- }
9
- beforeEach(() => {
10
- savedEnv.clear();
11
- });
12
- afterEach(() => {
13
- for (const [key, value] of savedEnv) {
14
- if (value === undefined) {
15
- delete process.env[key];
16
- }
17
- else {
18
- process.env[key] = value;
19
- }
20
- }
21
- });
22
- it("returns defaults when no overrides or env vars are set", () => {
23
- const config = resolveConfig();
24
- expect(config.fps).toBe(30);
25
- expect(config.quality).toBe("standard");
26
- expect(config.format).toBe("jpeg");
27
- expect(config.jpegQuality).toBe(80);
28
- expect(config.debug).toBe(false);
29
- });
30
- it("applies explicit overrides over defaults", () => {
31
- const config = resolveConfig({ fps: 60, debug: true });
32
- expect(config.fps).toBe(60);
33
- expect(config.debug).toBe(true);
34
- // Non-overridden fields remain at defaults
35
- expect(config.quality).toBe("standard");
36
- });
37
- it("reads numeric env vars with PRODUCER_ prefix", () => {
38
- setEnv("PRODUCER_MAX_WORKERS", "4");
39
- setEnv("PRODUCER_CORES_PER_WORKER", "3");
40
- const config = resolveConfig();
41
- expect(config.concurrency).toBe(4);
42
- expect(config.coresPerWorker).toBe(3);
43
- });
44
- it("reads boolean env vars (true/false strings)", () => {
45
- setEnv("PRODUCER_DISABLE_GPU", "true");
46
- setEnv("PRODUCER_ENABLE_BROWSER_POOL", "true");
47
- const config = resolveConfig();
48
- expect(config.disableGpu).toBe(true);
49
- expect(config.enableBrowserPool).toBe(true);
50
- });
51
- it("treats non-'true' boolean env vars as false", () => {
52
- setEnv("PRODUCER_DISABLE_GPU", "yes");
53
- const config = resolveConfig();
54
- expect(config.disableGpu).toBe(false);
55
- });
56
- it("explicit overrides take precedence over env vars", () => {
57
- setEnv("PRODUCER_CORES_PER_WORKER", "5");
58
- const config = resolveConfig({ coresPerWorker: 8 });
59
- expect(config.coresPerWorker).toBe(8);
60
- });
61
- it("falls back to defaults for invalid numeric env vars", () => {
62
- setEnv("PRODUCER_CORES_PER_WORKER", "not-a-number");
63
- const config = resolveConfig();
64
- expect(config.coresPerWorker).toBe(DEFAULT_CONFIG.coresPerWorker);
65
- });
66
- it("clamps chunkSizeFrames to minimum of 120", () => {
67
- setEnv("PRODUCER_CHUNK_SIZE_FRAMES", "50");
68
- const config = resolveConfig();
69
- expect(config.chunkSizeFrames).toBe(120);
70
- });
71
- it("clamps frameDataUriCacheLimit to minimum of 32", () => {
72
- setEnv("PRODUCER_FRAME_DATA_URI_CACHE_LIMIT", "10");
73
- const config = resolveConfig();
74
- expect(config.frameDataUriCacheLimit).toBe(32);
75
- });
76
- });
77
- //# sourceMappingURL=config.test.js.map
@@ -1 +0,0 @@
1
- {"version":3,"file":"config.test.js","sourceRoot":"","sources":["../src/config.test.ts"],"names":[],"mappings":"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"}
package/dist/index.d.ts DELETED
@@ -1,49 +0,0 @@
1
- /**
2
- * @hyperframes/engine
3
- *
4
- * Seekable web page to video rendering engine.
5
- * Framework-agnostic: works with GSAP, Lottie, Three.js, CSS animations,
6
- * or any web content that implements the window.__hf seek protocol.
7
- *
8
- * ## Error Convention
9
- *
10
- * Engine services use three error strategies depending on the operation type:
11
- *
12
- * - **Orchestration services throw on failure.** Browser launch, session init,
13
- * frame capture, and CDP operations propagate errors as thrown exceptions.
14
- * Callers are expected to catch and handle (e.g. frameCapture, browserManager,
15
- * screenshotService, videoFrameExtractor.extractVideoFramesRange).
16
- *
17
- * - **FFmpeg process wrappers return `{ success, error? }` result objects.**
18
- * Encoding, muxing, audio mixing, and streaming encode operations never reject.
19
- * They resolve with a result that includes `success: boolean` and an optional
20
- * `error` string (e.g. chunkEncoder, audioMixer, streamingEncoder).
21
- *
22
- * - **Cleanup and teardown functions never throw.** Browser close, session close,
23
- * temp directory removal, and resource release swallow errors via `.catch(() => {})`
24
- * to avoid masking the original failure (e.g. releaseBrowser, closeCaptureSession,
25
- * FrameLookupTable.cleanup).
26
- *
27
- * - **Optional lookups return `T | undefined` or `T | null`.**
28
- * Functions that may legitimately find nothing (resolveHeadlessShellPath,
29
- * getFrameAtTime, detectGpuEncoder) return a nullable value instead of throwing.
30
- *
31
- */
32
- export type { HfProtocol, HfMediaElement, CaptureOptions, CaptureResult, CaptureBufferResult, CapturePerfSummary, } from "./types.js";
33
- export { resolveConfig, DEFAULT_CONFIG, type EngineConfig } from "./config.js";
34
- export { acquireBrowser, releaseBrowser, resolveHeadlessShellPath, buildChromeArgs, ENABLE_BROWSER_POOL, type BuildChromeArgsOptions, type CaptureMode, type AcquiredBrowser, } from "./services/browserManager.js";
35
- export { createCaptureSession, initializeSession, closeCaptureSession, captureFrame, captureFrameToBuffer, getCompositionDuration, getCapturePerfSummary, prepareCaptureSessionForReuse, type CaptureSession, type BeforeCaptureHook, } from "./services/frameCapture.js";
36
- export { beginFrameCapture, pageScreenshotCapture, getCdpSession, injectVideoFramesBatch, syncVideoFrameVisibility, cdpSessionCache, type BeginFrameResult, } from "./services/screenshotService.js";
37
- export { encodeFramesFromDir, encodeFramesChunkedConcat, muxVideoWithAudio, applyFaststart, detectGpuEncoder, ENCODER_PRESETS, type GpuEncoder, } from "./services/chunkEncoder.js";
38
- export type { EncoderOptions, EncodeResult, MuxResult, } from "./services/chunkEncoder.types.js";
39
- export { spawnStreamingEncoder, createFrameReorderBuffer, type StreamingEncoder, type StreamingEncoderOptions, type StreamingEncoderResult, type FrameReorderBuffer, } from "./services/streamingEncoder.js";
40
- export { parseVideoElements, extractVideoFramesRange, extractAllVideoFrames, getFrameAtTime, createFrameLookupTable, FrameLookupTable, type VideoElement, type ExtractedFrames, type ExtractionOptions, type ExtractionResult, } from "./services/videoFrameExtractor.js";
41
- export { createVideoFrameInjector } from "./services/videoFrameInjector.js";
42
- export { parseAudioElements, processCompositionAudio, } from "./services/audioMixer.js";
43
- export type { AudioElement, AudioTrack, MixResult, } from "./services/audioMixer.types.js";
44
- export { calculateOptimalWorkers, distributeFrames, executeParallelCapture, mergeWorkerFrames, getSystemResources, type WorkerTask, type WorkerResult, type ParallelProgress, } from "./services/parallelCoordinator.js";
45
- export { createFileServer, type FileServerOptions, type FileServerHandle } from "./services/fileServer.js";
46
- export { quantizeTimeToFrame, MEDIA_VISUAL_STYLE_PROPERTIES } from "@hyperframes/core";
47
- export { extractVideoMetadata, extractAudioMetadata, type VideoMetadata, type AudioMetadata } from "./utils/ffprobe.js";
48
- export { downloadToTemp, isHttpUrl } from "./utils/urlDownloader.js";
49
- //# sourceMappingURL=index.d.ts.map
@@ -1 +0,0 @@
1
- {"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 DELETED
@@ -1,55 +0,0 @@
1
- /**
2
- * @hyperframes/engine
3
- *
4
- * Seekable web page to video rendering engine.
5
- * Framework-agnostic: works with GSAP, Lottie, Three.js, CSS animations,
6
- * or any web content that implements the window.__hf seek protocol.
7
- *
8
- * ## Error Convention
9
- *
10
- * Engine services use three error strategies depending on the operation type:
11
- *
12
- * - **Orchestration services throw on failure.** Browser launch, session init,
13
- * frame capture, and CDP operations propagate errors as thrown exceptions.
14
- * Callers are expected to catch and handle (e.g. frameCapture, browserManager,
15
- * screenshotService, videoFrameExtractor.extractVideoFramesRange).
16
- *
17
- * - **FFmpeg process wrappers return `{ success, error? }` result objects.**
18
- * Encoding, muxing, audio mixing, and streaming encode operations never reject.
19
- * They resolve with a result that includes `success: boolean` and an optional
20
- * `error` string (e.g. chunkEncoder, audioMixer, streamingEncoder).
21
- *
22
- * - **Cleanup and teardown functions never throw.** Browser close, session close,
23
- * temp directory removal, and resource release swallow errors via `.catch(() => {})`
24
- * to avoid masking the original failure (e.g. releaseBrowser, closeCaptureSession,
25
- * FrameLookupTable.cleanup).
26
- *
27
- * - **Optional lookups return `T | undefined` or `T | null`.**
28
- * Functions that may legitimately find nothing (resolveHeadlessShellPath,
29
- * getFrameAtTime, detectGpuEncoder) return a nullable value instead of throwing.
30
- *
31
- */
32
- // ── Configuration ──────────────────────────────────────────────────────────────
33
- export { resolveConfig, DEFAULT_CONFIG } from "./config.js";
34
- // ── Browser management ─────────────────────────────────────────────────────────
35
- export { acquireBrowser, releaseBrowser, resolveHeadlessShellPath, buildChromeArgs, ENABLE_BROWSER_POOL, } from "./services/browserManager.js";
36
- // ── Frame capture pipeline ──────────────────────────────────────────────────────
37
- export { createCaptureSession, initializeSession, closeCaptureSession, captureFrame, captureFrameToBuffer, getCompositionDuration, getCapturePerfSummary, prepareCaptureSessionForReuse, } from "./services/frameCapture.js";
38
- // ── Screenshot (BeginFrame) ─────────────────────────────────────────────────────
39
- export { beginFrameCapture, pageScreenshotCapture, getCdpSession, injectVideoFramesBatch, syncVideoFrameVisibility, cdpSessionCache, } from "./services/screenshotService.js";
40
- // ── Encoding ───────────────────────────────────────────────────────────────────
41
- export { encodeFramesFromDir, encodeFramesChunkedConcat, muxVideoWithAudio, applyFaststart, detectGpuEncoder, ENCODER_PRESETS, } from "./services/chunkEncoder.js";
42
- export { spawnStreamingEncoder, createFrameReorderBuffer, } from "./services/streamingEncoder.js";
43
- // ── Media processing ───────────────────────────────────────────────────────────
44
- export { parseVideoElements, extractVideoFramesRange, extractAllVideoFrames, getFrameAtTime, createFrameLookupTable, FrameLookupTable, } from "./services/videoFrameExtractor.js";
45
- export { createVideoFrameInjector } from "./services/videoFrameInjector.js";
46
- export { parseAudioElements, processCompositionAudio, } from "./services/audioMixer.js";
47
- // ── Parallel rendering ─────────────────────────────────────────────────────────
48
- export { calculateOptimalWorkers, distributeFrames, executeParallelCapture, mergeWorkerFrames, getSystemResources, } from "./services/parallelCoordinator.js";
49
- // ── File server ────────────────────────────────────────────────────────────────
50
- export { createFileServer } from "./services/fileServer.js";
51
- // ── Utilities ──────────────────────────────────────────────────────────────────
52
- export { quantizeTimeToFrame, MEDIA_VISUAL_STYLE_PROPERTIES } from "@hyperframes/core";
53
- export { extractVideoMetadata, extractAudioMetadata } from "./utils/ffprobe.js";
54
- export { downloadToTemp, isHttpUrl } from "./utils/urlDownloader.js";
55
- //# sourceMappingURL=index.js.map
package/dist/index.js.map DELETED
@@ -1 +0,0 @@
1
- {"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"}
@@ -1,11 +0,0 @@
1
- /**
2
- * Audio Mixer Service
3
- *
4
- * Processes and mixes audio tracks using FFmpeg.
5
- */
6
- import { type EngineConfig } from "../config.js";
7
- import type { AudioElement, MixResult } from "./audioMixer.types.js";
8
- export type { AudioElement, AudioTrack, MixResult } from "./audioMixer.types.js";
9
- export declare function parseAudioElements(html: string): AudioElement[];
10
- export declare function processCompositionAudio(elements: AudioElement[], baseDir: string, workDir: string, outputPath: string, totalDuration: number, signal?: AbortSignal, config?: Partial<Pick<EngineConfig, "ffmpegProcessTimeout" | "audioGain">>): Promise<MixResult>;
11
- //# sourceMappingURL=audioMixer.d.ts.map
@@ -1 +0,0 @@
1
- {"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"}