initial code (#2)

* feat: initial code port from hyperframes-internal Port all OSS-ready packages from the internal monorepo: - @hyperframes/core — shared types, HTML generation, GSAP utilities, runtime - @hyperframes/cli — CLI for creating, previewing, and rendering compositions - @hyperframes/engine — framework-agnostic rendering engine (BeginFrame + FFmpeg) - @hyperframes/producer — video rendering pipeline (Puppeteer + FFmpeg) - @hyperframes/ui-player — browser-based video player component - @hyperframes/studio — composition editor (React frontend + Hono backend) Includes regression test suite with Docker-based test harness. All HeyGen-internal references, deployment infrastructure, and proprietary assets have been removed. Package names migrated from @app/* to @hyperframes/*. Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com> * fix: scrub internal codenames and stale references from OSS port - Replace static.heygen.ai runtime URLs in test fixtures - Remove internal CDN publish script (publish-hyperframe-runtime.ts) - Replace sandbox-studio, sandbox-interceptor, __magicEditRuntime with neutral names (studio, hyperframe-runtime, __hyperframeRuntime) - Fix stale Vault API / localhost references in docs - Remove broken deprecated_studio link Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com> * fix: remove remaining internal codenames and stale references - Delete stale producer README.md and PIPELINE.md (referenced nonexistent files) - Replace "Cerberus" codename with "HyperFrames" in test design reviews - Replace magic-edit postMessage identifiers with hf-preview/hf-parent - Rename debug-magic-edit-timeline.ts to debug-timeline.ts - Replace "Motion Cut" with "HyperFrames" in Timeline comments - Fix studio/CLI references to nonexistent archive package (use local data/projects/ dir, stub render proxy) Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com> --------- Co-authored-by: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
2026-09-10 22:20:14 +00:00 · 2026-03-21 22:43:56 -07:00
parent 10621e7903
commit 9f8e5ba5a1
401 changed files with 54545 additions and 2 deletions
@@ -0,0 +1,81 @@
+/**
+ * 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";
+
+export interface RunFfmpegOptions {
+  signal?: AbortSignal;
+  timeout?: number;
+  onStderr?: (line: string) => void;
+}
+
+export interface RunFfmpegResult {
+  success: boolean;
+  exitCode: number | null;
+  stderr: string;
+  durationMs: number;
+}
+
+const DEFAULT_TIMEOUT = 300_000;
+
+export async function runFfmpeg(args: string[], opts?: RunFfmpegOptions): Promise<RunFfmpegResult> {
+  const startMs = Date.now();
+  const signal = opts?.signal;
+  const timeout = opts?.timeout ?? DEFAULT_TIMEOUT;
+  const onStderr = opts?.onStderr;
+
+  return new Promise<RunFfmpegResult>((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: Buffer) => {
+      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,
+      });
+    });
+  });
+}