@hyperframes/producer 0.8.191 → 0.8.193

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

@@ -219,6 +219,8 @@ export interface RemoteProjectFile {
     readonly url: string;
     /** A file of only this video's audio, when one was stored: the audio mix reads it, not the video. */
     readonly audioSidecarUrl?: string;
+    /** The file's stored ffprobe JSON: the plan reads it instead of probing the file over the network. */
+    readonly probeFactsUrl?: string;
     readonly sha256: string;
     readonly sizeBytes: number;
 }

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

@@ -0,0 +1,4 @@
+export declare function wantsProbeFacts(path: string): boolean;
+/** `unavailable`: no ffprobe on this machine. `none`: the file cannot be probed. */
+export type ProbeFactsOutcome = "built" | "none" | "unavailable";
+export declare function buildProbeFacts(inputPath: string, outputPath: string, signal?: AbortSignal): Promise<ProbeFactsOutcome>;

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

@@ -24,6 +24,12 @@ export declare function worstSubTimelineWaitOutcome(perfs: CapturePerfSummary[])
 export declare function pushWorkerDedupPerfs(results: ReadonlyArray<{
     perf?: CapturePerfSummary;
 }>, sink: CapturePerfSummary[]): void;
+/** Adds each worker's page-error console lines to `sink`, once per distinct line. */
+export declare function pushWorkerPageErrors(results: ReadonlyArray<{
+    pageErrorLines?: string[];
+}>, sink: string[]): void;
+/** The console lines plus the workers' page-error lines the console does not already hold. */
+export declare function withWorkerPageErrors(consoleLines: string[], workerLines: string[]): string[];
 /**
  * Collapse per-session/per-worker static-dedup perf into one render-level
  * outcome. enabled/armed = OR across workers (they run the same gates on the

package/dist/services/render/stages/audioStage.d.ts

@@ -17,7 +17,7 @@
  *   - `perfStages.audioProcessMs` is set whether or not the call ran.
  */
 import type { Fps } from "@hyperframes/core";
-import { type AudioProcessingFailure } from "@hyperframes/engine";
+import { type AudioProcessingFailure, type MixResult } from "@hyperframes/engine";
 import type { CompositionMetadata } from "../shared.js";
 import type { ProducerLogger } from "../../../logger.js";
 export interface AudioStageInput {
@@ -59,5 +59,7 @@ export interface AudioStageResult {
     audioError?: string;
     /** Bounded typed causes for policy, telemetry, and caller classification. */
     audioFailures?: AudioProcessingFailure[];
+    /** Wall ms per phase of the audio mix. */
+    audioPhaseMs?: MixResult["phaseMs"];
 }
 export declare function runAudioStage(input: AudioStageInput): Promise<AudioStageResult>;

package/dist/services/render/stages/extractVideosStage.d.ts

@@ -27,7 +27,7 @@
  *     machines (symlinks don't survive S3 / GCS round-trips). Default
  *     `false` preserves the in-process renderer's symlink behavior.
  */
-import { type CaptureVideoMetadataHint, type EngineConfig, type ExtractedFrames, type ExtractionResult, type FrameLookupTable, type HdrTransfer, type VideoExtractionFailureKind, type VideoColorSpace, classifyVideoExtractionError, extractAllVideoFrames } from "@hyperframes/engine";
+import { type CaptureVideoMetadataHint, type EngineConfig, type ExtractionResult, type FrameLookupTable, type HdrTransfer, type VideoExtractionFailureKind, type VideoColorSpace, classifyVideoExtractionError, extractAllVideoFrames } from "@hyperframes/engine";
 import { type RenderJob } from "../../renderOrchestrator.js";
 import { type CompositionMetadata } from "../shared.js";
 import type { ProducerLogger } from "../../../logger.js";
@@ -127,4 +127,19 @@ export declare function runExtractVideosStage(input: ExtractVideosStageInput): P
  * to composition.audios. Both the file AND the element must declare audio —
  * a muted <video> whose source contains audio should not leak into the render.
  */
-export declare function appendAutoDetectedVideoAudio(composition: Pick<CompositionMetadata, "videos" | "audios">, extracted: ExtractedFrames[]): void;
+export declare function appendAutoDetectedVideoAudio(composition: Pick<CompositionMetadata, "videos" | "audios">, extracted: ReadonlyArray<{
+    videoId: string;
+    metadata: {
+        hasAudio: boolean;
+    };
+}>): void;
+/**
+ * The audio-only form of the extract stage: which videos carry sound takes a probe per source, not their frames.
+ * Each video is moved to its extraction window first, as extraction does, so its sound lands where its picture does.
+ */
+export declare function appendVideoAudioFromProbe(input: {
+    projectDir: string;
+    compiledDir: string;
+    composition: CompositionMetadata;
+    urlByAbsentLocalPath?: ReadonlyMap<string, string>;
+}): Promise<void>;

package/dist/services/renderOrchestrator.d.ts

@@ -603,6 +603,8 @@ export declare function executeDiskCaptureWithAdaptiveRetry(options: {
     frameRangeStart?: number;
     /** Mutated in place — replaced each attempt so only the final attempt's worker perf survives (see retry reset below). */
     dedupPerfs: CapturePerfSummary[];
+    /** Mutated in place: the workers' page-error console lines, for the render's error count. */
+    pageErrorLines?: string[];
 }): Promise<CaptureAttemptSummary[]>;
 export type RenderConfigInput = Omit<RenderConfig, "fps"> & {
     fps: FpsInput;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@hyperframes/producer",
-  "version": "0.8.191",
+  "version": "0.8.193",
   "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/lint": "0.8.191",
-    "@hyperframes/core": "0.8.191",
-    "@hyperframes/parsers": "0.8.191",
-    "@hyperframes/studio-server": "0.8.191",
-    "@hyperframes/engine": "0.8.191"
+    "@hyperframes/engine": "0.8.193",
+    "@hyperframes/core": "0.8.193",
+    "@hyperframes/parsers": "0.8.193",
+    "@hyperframes/lint": "0.8.193",
+    "@hyperframes/studio-server": "0.8.193"
   },
   "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.191"
+    "@hyperframes/aws-lambda": "0.8.193"
   },
   "engines": {
     "node": ">=22"