@hyperframes/producer 0.8.157 → 0.8.159

package/dist/index.js

@@ -1,4 +1,5 @@
 // src/services/renderOrchestrator.ts
+import { audioFailureDiagnostics as audioFailureDiagnostics2 } from "@hyperframes/engine";
 import {
   existsSync as existsSync16,
   mkdirSync as mkdirSync9,
@@ -1271,15 +1272,17 @@ var EncoderInterruptedError = class extends Error {
   retryable = true;
   /** Retained inside the producer for diagnostics; never copied to the wire envelope. */
   diagnosticMessage;
-  constructor(prefix, diagnosticMessage) {
+  audioFailures;
+  constructor(prefix, diagnosticMessage, audioFailures = []) {
     super(`${prefix}: encoder process was interrupted by the host lifecycle`);
     this.name = "EncoderInterruptedError";
     this.diagnosticMessage = diagnosticMessage;
+    this.audioFailures = audioFailures;
   }
 };
 function encoderFailureError(prefix, result) {
   const message = `${prefix}: ${result.error ?? "unknown encoder failure"}`;
-  return result.failureReason === "external_interruption" ? new EncoderInterruptedError(prefix, message) : new Error(message);
+  return result.failureReason === "external_interruption" ? new EncoderInterruptedError(prefix, message, result.audioFailures) : new Error(message);
 }
 
 // src/services/render/renderExecutionContext.ts
@@ -8647,8 +8650,12 @@ function appendAutoDetectedVideoAudio(composition, extracted) {
 import { join as join17 } from "node:path";
 import {
   MIXED_AUDIO_FILENAME,
+  audioFailureDiagnostics,
   processCompositionAudio
 } from "@hyperframes/engine";
+function triggerFirst(failures, trigger) {
+  return [trigger, ...(failures ?? []).filter((failure) => failure !== trigger)];
+}
 async function runAudioStage(input) {
   const {
     projectDir,
@@ -8714,7 +8721,8 @@ async function runAudioStage(input) {
     if (interrupted) {
       throw encoderFailureError("Audio processing failed", {
         error: interrupted.detail,
-        failureReason: "external_interruption"
+        failureReason: "external_interruption",
+        audioFailures: audioFailureDiagnostics(triggerFirst(audioResult.failures, interrupted))
       });
     }
     hasAudio = audioResult.success;
@@ -12170,6 +12178,7 @@ async function executeRenderPipeline(input) {
             message: `Audio mix failed; output would be video-only: ${audioResult.audioError}`,
             details: {
               mediaType: "audio",
+              audioFailures: audioFailureDiagnostics2(audioFailures),
               failureReasons: [...new Set(audioFailures.map((failure) => failure.reason))],
               failureStages: [...new Set(audioFailures.map((failure) => failure.stage))],
               failureOwner,
@@ -14911,6 +14920,7 @@ import {
 import { quantizeTimeToFrame, MEDIA_VISUAL_STYLE_PROPERTIES } from "@hyperframes/engine";
 
 // src/services/distributed/plan.ts
+import { audioFailureDiagnostics as audioFailureDiagnostics3 } from "@hyperframes/engine";
 import {
   copyFileSync as copyFileSync5,
   cpSync as cpSync2,
@@ -15691,6 +15701,7 @@ function applyDistributedAudioWarningPolicy(job, audioError, audioFailures = [],
         message: `Audio mix failed; output would be video-only: ${audioError}`,
         details: {
           mediaType: "audio",
+          audioFailures: audioFailureDiagnostics3(audioFailures),
           failureReasons: [...new Set(audioFailures.map((failure) => failure.reason))],
           failureStages: [...new Set(audioFailures.map((failure) => failure.stage))],
           failureOwner,

package/dist/public-server.js

@@ -19,6 +19,7 @@ import { streamSSE } from "hono/streaming";
 import { serve as serve2 } from "@hono/node-server";
 
 // src/services/renderOrchestrator.ts
+import { audioFailureDiagnostics as audioFailureDiagnostics2 } from "@hyperframes/engine";
 import {
   existsSync as existsSync16,
   mkdirSync as mkdirSync9,
@@ -1291,15 +1292,17 @@ var EncoderInterruptedError = class extends Error {
   retryable = true;
   /** Retained inside the producer for diagnostics; never copied to the wire envelope. */
   diagnosticMessage;
-  constructor(prefix, diagnosticMessage) {
+  audioFailures;
+  constructor(prefix, diagnosticMessage, audioFailures = []) {
     super(`${prefix}: encoder process was interrupted by the host lifecycle`);
     this.name = "EncoderInterruptedError";
     this.diagnosticMessage = diagnosticMessage;
+    this.audioFailures = audioFailures;
   }
 };
 function encoderFailureError(prefix, result) {
   const message = `${prefix}: ${result.error ?? "unknown encoder failure"}`;
-  return result.failureReason === "external_interruption" ? new EncoderInterruptedError(prefix, message) : new Error(message);
+  return result.failureReason === "external_interruption" ? new EncoderInterruptedError(prefix, message, result.audioFailures) : new Error(message);
 }
 
 // src/services/render/renderExecutionContext.ts
@@ -8630,8 +8633,12 @@ function appendAutoDetectedVideoAudio(composition, extracted) {
 import { join as join17 } from "node:path";
 import {
   MIXED_AUDIO_FILENAME,
+  audioFailureDiagnostics,
   processCompositionAudio
 } from "@hyperframes/engine";
+function triggerFirst(failures, trigger) {
+  return [trigger, ...(failures ?? []).filter((failure) => failure !== trigger)];
+}
 async function runAudioStage(input) {
   const {
     projectDir,
@@ -8697,7 +8704,8 @@ async function runAudioStage(input) {
     if (interrupted) {
       throw encoderFailureError("Audio processing failed", {
         error: interrupted.detail,
-        failureReason: "external_interruption"
+        failureReason: "external_interruption",
+        audioFailures: audioFailureDiagnostics(triggerFirst(audioResult.failures, interrupted))
       });
     }
     hasAudio = audioResult.success;
@@ -12153,6 +12161,7 @@ async function executeRenderPipeline(input) {
             message: `Audio mix failed; output would be video-only: ${audioResult.audioError}`,
             details: {
               mediaType: "audio",
+              audioFailures: audioFailureDiagnostics2(audioFailures),
               failureReasons: [...new Set(audioFailures.map((failure) => failure.reason))],
               failureStages: [...new Set(audioFailures.map((failure) => failure.stage))],
               failureOwner,

package/dist/services/distributed/plan.d.ts

@@ -1,30 +1,3 @@
-/**
- * Activity A of the distributed render pipeline.
- *
- * `buildLocalExecutionPlan(projectDir, config, executionPlanDir)` composes the
- * existing render stages (compile → probe → extract videos → audio → freeze)
- * into a self-contained local execution directory that downstream chunk
- * workers consume:
- *
- *     <planDir>/
- *     ├── plan.json
- *     ├── compiled/                # compileForRender output (self-contained)
- *     ├── video-frames/            # per-video JPEG sequences (dereferenced)
- *     ├── audio.m4a                # only when composition has audio
- *     └── meta/
- *         ├── composition.json
- *         ├── encoder.json         # LockedRenderConfig
- *         └── chunks.json
- *
- * Pure function over local paths. No networking. Two invocations with the
- * same inputs produce the same execution-plan hash. Transport adapters use
- * that representation either through the legacy v1 `plan()` wrapper or the
- * v2 manifest/CAS publisher.
- *
- * Banned configurations (GPU encode, hardware browser GL, system primary
- * fonts) are rejected at plan time via `planValidation.ts` so chunk workers
- * never have to handle them.
- */
 import { type CanvasResolution } from "@hyperframes/core";
 import { type EngineConfig, type VideoFrameFormat, type AudioProcessingFailure } from "@hyperframes/engine";
 import { type ProducerLogger } from "../../logger.js";

package/dist/services/render/encoderInterruption.d.ts

@@ -1,6 +1,8 @@
+import type { AudioFailureDiagnostic } from "@hyperframes/engine";
 interface EncoderFailureResult {
     error?: string;
     failureReason?: "external_interruption";
+    audioFailures?: AudioFailureDiagnostic[];
 }
 /** A host/process lifecycle interruption that is safe to retry on a fresh producer. */
 export declare class EncoderInterruptedError extends Error {
@@ -9,7 +11,8 @@ export declare class EncoderInterruptedError extends Error {
     readonly retryable: true;
     /** Retained inside the producer for diagnostics; never copied to the wire envelope. */
     readonly diagnosticMessage: string;
-    constructor(prefix: string, diagnosticMessage: string);
+    readonly audioFailures: AudioFailureDiagnostic[];
+    constructor(prefix: string, diagnosticMessage: string, audioFailures?: AudioFailureDiagnostic[]);
 }
 export declare function encoderFailureError(prefix: string, result: EncoderFailureResult): Error;
 export {};

package/dist/services/render/frameLevelsTestFixtures.d.ts

@@ -0,0 +1,4 @@
+export declare const FFMPEG: string;
+export declare const HAS_FFMPEG: boolean;
+/** Mean grey level of every frame of an encoded video, 0-255. */
+export declare function frameLevels(videoPath: string, width: number, height: number): number[];

package/dist/services/renderOrchestrator.d.ts

@@ -1,34 +1,3 @@
-/**
- * Render Orchestrator Service
- *
- * `executeRenderJob` is the in-process entry point that composes the
- * pipeline's six stages. Each stage lives in its own module under
- * `./render/stages/` so the pure-function primitives can be reused by
- * the distributed render path without dragging the orchestrator's
- * cleanup and observability scaffolding with them.
- *
- *   Stage 1  compile         → services/render/stages/compileStage.ts
- *   Stage 1b probe           → services/render/stages/probeStage.ts
- *            (browser-driven duration discovery + media reconciliation;
- *            grouped with Stage 1 in the perf summary)
- *   Stage 2  extract videos  → services/render/stages/extractVideosStage.ts
- *   Stage 3  audio           → services/render/stages/audioStage.ts
- *   Stage 4  capture         → services/render/stages/captureStage.ts
- *                              services/render/stages/captureStreamingStage.ts
- *                              services/render/stages/captureHdrStage.ts
- *   Stage 5  encode          → services/render/stages/encodeStage.ts
- *   Stage 6  assemble        → services/render/stages/assembleStage.ts
- *
- * Resources spawned by stages (file server, capture sessions, streaming
- * encoders, raw HDR frame files) are tracked in the orchestrator's
- * `try/finally` so a stage throwing mid-pipeline doesn't leak Chrome
- * processes or ffmpeg subprocesses.
- *
- * Heavy observability: every stage records timing into `perfStages`,
- * errors carry full context, and failures produce a diagnostic summary
- * (browser console tail, memory peaks, capture attempts, HDR
- * diagnostics).
- */
 import { type CanvasResolution, type Fps, type FpsInput, type HfVfxCapture } from "@hyperframes/core";
 import { type EngineConfig, type ExtractionPhaseBreakdown, type VideoFrameFormat, type CaptureOptions, type CaptureVideoMetadataHint, type CaptureSession, type BeforeCaptureHook, type ParallelProgress, type WorkerTask, type CapturePerfSummary, type CaptureWarning, type SubTimelineWaitOutcome, type WorkerSizing, type StaticVerificationOutcome, type CaptureFailureKind, type MotionBlurOptions } from "@hyperframes/engine";
 import { type ProducerLogger } from "../logger.js";

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@hyperframes/producer",
-  "version": "0.8.157",
+  "version": "0.8.159",
   "description": "HTML-to-video rendering engine using Chrome's BeginFrame API",
   "repository": {
     "type": "git",
@@ -35,11 +35,11 @@
     "postcss": "^8.4.0",
     "puppeteer": "^25.2.1",
     "puppeteer-core": "^25.2.1",
-    "@hyperframes/core": "0.8.157",
-    "@hyperframes/engine": "0.8.157",
-    "@hyperframes/lint": "0.8.157",
-    "@hyperframes/parsers": "0.8.157",
-    "@hyperframes/studio-server": "0.8.157"
+    "@hyperframes/parsers": "0.8.159",
+    "@hyperframes/core": "0.8.159",
+    "@hyperframes/studio-server": "0.8.159",
+    "@hyperframes/engine": "0.8.159",
+    "@hyperframes/lint": "0.8.159"
   },
   "devDependencies": {
     "@types/node": "^25.0.10",
@@ -48,7 +48,7 @@
     "tsx": "^4.21.0",
     "typescript": "^5.7.2",
     "vitest": "^4.1.11",
-    "@hyperframes/aws-lambda": "0.8.157"
+    "@hyperframes/aws-lambda": "0.8.159"
   },
   "engines": {
     "node": ">=22"