@hyperframes/producer 0.9.13 → 0.9.15

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

@@ -44,6 +44,8 @@ export interface PadTrimAudioInput {
     audioPath: string;
     /** Path the helper writes the duration-corrected audio to. */
     outputPath: string;
+    /** The PCM `audioPath` was encoded from: a pad, trim or peak correction encodes it instead of decoding the AAC. */
+    sourcePath?: string;
     signal?: AbortSignal;
     /** Deadline for each ffmpeg process; defaults to the engine's `ffmpegProcessTimeout`. */
     timeoutMs?: number;
@@ -126,12 +128,16 @@ export declare function constrainAacTruePeak(input: {
     timeoutMs?: number;
     probeTruePeakDbfs?: (audioPath: string, signal?: AbortSignal) => Promise<number>;
     encodeAac?: AacEncoder;
+    rewriteSource?: SourceRewriter;
 }): Promise<{
     success: boolean;
     error?: string;
     failureReason?: "external_interruption";
     loweredDb?: number;
+    sourceStale?: true;
 }>;
+/** Writes `sourcePath` through `filter` to `outputPath` as float PCM. */
+type SourceRewriter = (sourcePath: string, outputPath: string, filter: string) => Promise<StepResult>;
 export declare function defaultProbeVideoFrameInfo(videoPath: string, signal?: AbortSignal): Promise<ProbeVideoFrameInfo>;
 export declare function runFfprobeJson<T>(args: string[], signal?: AbortSignal): Promise<T>;
 export {};

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

@@ -27,6 +27,7 @@ export interface AssembleStageInput {
     videoOnlyPath: string;
     /** Mixed audio path (only read when `hasAudio` is true). */
     audioOutputPath: string;
+    audioPcmPath?: string;
     /** Final on-disk output. A directory when `format` is `"hls"`. */
     outputPath: string;
     hasAudio: boolean;

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

@@ -41,12 +41,16 @@ export interface AudioStageInput {
     assertNotAborted: () => void;
     /** Where a per-track failure's detail goes. Optional so tests need not pass one. */
     log?: ProducerLogger;
+    /** Leave the delivered PCM in `workDir` for the assemble stage; its owner removes the dir. */
+    keepDeliverySource?: boolean;
 }
 export interface AudioStageResult {
     /** Actual delivery attenuation, for the render warning and metadata. */
     audioLoweredDb?: number;
     /** Always `join(workDir, MIXED_AUDIO_FILENAME)`. */
     audioOutputPath: string;
+    /** The PCM `audioOutputPath` encodes, when `keepDeliverySource` asked for it. */
+    deliverySourcePath?: string;
     /** True iff the audio mix actually produced a file. False when there are no audio elements. */
     hasAudio: boolean;
     /** Wall-clock ms for the audio mix phase. Zero-elements path is near-zero but always set. */

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

@@ -44,7 +44,10 @@ import type { ProducerLogger } from "../../../logger.js";
 import type { ProgressCallback, RenderJob } from "../../renderOrchestrator.js";
 import type { SdrStreamingCapturePlan } from "../capturePlan.js";
 export declare function resolveCaptureStallTimeoutMs(): number;
-type StalledSession = Pick<CaptureSession, "captureMode" | "captureStep">;
+type StalledSession = {
+    captureMode: CaptureSession["captureMode"];
+    captureStep?: string;
+};
 export declare function raceAgainstStall<T>(promise: Promise<T>, deadlineMs: number, input: {
     session: StalledSession;
     frameIndex: number;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@hyperframes/producer",
-  "version": "0.9.13",
+  "version": "0.9.15",
   "description": "HTML-to-video rendering engine using Chrome's BeginFrame API",
   "repository": {
     "type": "git",
@@ -35,11 +35,11 @@
     "postcss": "^8.4.0",
     "puppeteer": "~25.11.0",
     "puppeteer-core": "^25.11.0",
-    "@hyperframes/lint": "0.9.13",
-    "@hyperframes/core": "0.9.13",
-    "@hyperframes/engine": "0.9.13",
-    "@hyperframes/parsers": "0.9.13",
-    "@hyperframes/studio-server": "0.9.13"
+    "@hyperframes/core": "0.9.15",
+    "@hyperframes/engine": "0.9.15",
+    "@hyperframes/lint": "0.9.15",
+    "@hyperframes/parsers": "0.9.15",
+    "@hyperframes/studio-server": "0.9.15"
   },
   "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.9.13"
+    "@hyperframes/aws-lambda": "0.9.15"
   },
   "engines": {
     "node": ">=22"