@hyperframes/producer 0.8.192 → 0.8.194

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/htmlCompiler.d.ts

@@ -1,4 +1,4 @@
-import { type ResolvedDuration, type UnresolvedElement } from "@hyperframes/core";
+import { type RateSpec, type ResolvedDuration, type UnresolvedElement } from "@hyperframes/core";
 import { type VideoElement, type ImageElement, type AudioElement, type AudioVolumeKeyframe } from "@hyperframes/engine";
 import type { Page } from "puppeteer-core";
 import { type ProducerLogger } from "../logger.js";
@@ -216,6 +216,7 @@ export interface BrowserMediaElement {
     /** True when compilation inferred duration from the fallback source. */
     durationInferred: boolean;
     mediaStart: number;
+    playbackRate: RateSpec;
     loop: boolean;
     hasAudio: boolean;
     volume: number;

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

@@ -1,3 +1,4 @@
+import { type ProducerLogger } from "../../logger.js";
 import type { RenderOutputFormat } from "./renderFormat.js";
 export type ArtifactKind = "file" | "directory";
 export interface ArtifactTransactionFileSystem {
@@ -113,13 +114,14 @@ export declare function buildArtifactExpectation(input: {
 export declare class ArtifactTransaction {
     private readonly kind;
     private readonly fileSystem;
+    private readonly logger;
     readonly destinationPath: string;
     readonly stagingPath: string;
     private readonly transactionDirectory;
     private readonly backupPath;
     private state;
     private readonly durationProbe;
-    constructor(destinationPath: string, kind: ArtifactKind, fileSystem?: ArtifactTransactionFileSystem, durationProbe?: ArtifactDurationProbe);
+    constructor(destinationPath: string, kind: ArtifactKind, fileSystem?: ArtifactTransactionFileSystem, durationProbe?: ArtifactDurationProbe, logger?: Pick<ProducerLogger, "debug">);
     validate(expected?: ArtifactValidationExpectation): Promise<void>;
     private assertReadableNonEmptyDirectory;
     /**

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/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;
@@ -704,6 +706,8 @@ export interface ElementTagScan {
  * live count and uses this only when no such session exists.
  */
 export declare function scanElementTags(html: string): ElementTagScan;
+/** Longest a live probe-page read may hold the render; a busy page otherwise waits out the CDP timeout. */
+export declare const PROBE_READ_TIMEOUT_MS = 5000;
 /**
  * Element count for the short-comp band's gate, WITH PROVENANCE.
  *
@@ -726,7 +730,7 @@ export declare function scanElementTags(html: string): ElementTagScan;
  * the fleet distribution recorded by the baseline release must be measured
  * by the same resolver that later gates routing, or the baseline is invalid.
  */
-export declare function resolveCompositionElementCount(probeSession: Pick<CaptureSession, "isInitialized" | "page"> | null, html: string): Promise<{
+export declare function resolveCompositionElementCount(probeSession: Pick<CaptureSession, "isInitialized" | "page"> | null, html: string, log?: Pick<ProducerLogger, "warn">): Promise<{
     count: number;
     source: "live" | "static";
     byTag?: Readonly<Record<string, number>>;
@@ -759,7 +763,7 @@ export declare function detectAdaptersStatic(html: string): RuntimeAdapterName[]
  * Runtime adapters a composition exercises. Unlike `resolveCompositionElementCount`
  * (one source of truth, for gating), this is observational: unions live + static every render.
  */
-export declare function resolveAdaptersUsed(probeSession: Pick<CaptureSession, "isInitialized" | "page"> | null, html: string): Promise<readonly RuntimeAdapterName[]>;
+export declare function resolveAdaptersUsed(probeSession: Pick<CaptureSession, "isInitialized" | "page"> | null, html: string, log?: Pick<ProducerLogger, "warn">): Promise<readonly RuntimeAdapterName[]>;
 /**
  * Max-merge init telemetry across per-worker capture perf summaries — the
  * success-path channel for PARALLEL renders, whose worker console buffers

package/package.json

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