@hyperframes/producer 0.8.173 → 0.8.174

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

@@ -66,4 +66,6 @@ export declare function assemble(planDir: string, chunkPaths: readonly string[],
      */
     cfr?: boolean;
 }): Promise<AssembleResult>;
+/** Chunks that carry their audio are stitched under one index, the same bytes as the S3 stitch. */
+export declare function chunksAreStitchedMp4(planDir: string, cfr: boolean): boolean;
 export {};

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

@@ -0,0 +1,38 @@
+interface Box {
+    type: string;
+    start: number;
+    bodyStart: number;
+    end: number;
+}
+/** Reads bytes `[start, end)`; returns fewer past the end of the object. */
+export type ReadRange = (start: number, end: number) => Promise<Buffer>;
+export interface Mp4Layout {
+    ftyp: Buffer;
+    moov: Buffer;
+    /** File offsets of the mdat payload, `[payloadStart, payloadEnd)`. */
+    payloadStart: number;
+    payloadEnd: number;
+}
+/** Reads a chunk's ftyp and moov and locates its mdat payload without reading the payload. */
+export declare function readMp4Layout(read: ReadRange): Promise<Mp4Layout>;
+export interface TrackTable {
+    trak: Box;
+    handler: string;
+    timescale: number;
+    /** Media time the edit list starts presenting at (the AAC priming on audio). */
+    mediaTime: number;
+    stsd: Buffer;
+    durations: number[];
+    sizes: number[];
+    /** Per-sample keyframe flags; `null` when every sample is one (no stss). */
+    sync: boolean[] | null;
+    samplesPerChunk: number[];
+    chunkOffsets: number[];
+}
+/** Each track's sample tables, expanded to one entry per sample (and per chunk). */
+export declare function readTracks(moov: Buffer): TrackTable[];
+export declare function buildStitchedHeader(layouts: readonly Mp4Layout[]): Buffer;
+/** Local join: the stitched header, then each chunk's mdat payload in order. Like the ffmpeg
+ * join, it writes in a work folder beside `outputPath` and renames only a finished file there. */
+export declare function writeStitchedMp4(chunkPaths: readonly string[], outputPath: string): Promise<void>;
+export {};

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

@@ -269,8 +269,8 @@ export declare class ChunkExceedsWorkerTimeoutError extends Error {
     constructor(predictedChunkSeconds: number, workerTimeoutSeconds: number);
 }
 /**
- * The `maxParallelChunks` a plan uses: explicit chunking flags win; otherwise one wave across
- * `workerConcurrency`, widened so each chunk fits `workerTimeoutSeconds`; with neither, 16.
+ * The `maxParallelChunks` a plan uses: an explicit value, else one wave across `workerConcurrency`
+ * (16 if unknown), widened to fit `workerTimeoutSeconds` unless chunkSize/targetChunkFrames pin it.
  */
 export declare function resolveMaxParallelChunks(config: Pick<DistributedRenderConfig, "maxParallelChunks" | "chunkSize" | "targetChunkFrames" | "workerTimeoutSeconds" | "workerConcurrency">, totalFrames: number, 
 /** Output pixels per frame, after supersampling. */
@@ -396,4 +396,4 @@ export declare function buildLocalExecutionPlan(projectDir: string, config: Dist
  * @deprecated Use `planV2()` or `planV2WithPublisher()` for new integrations.
  * This wrapper, its layout, and its result shape remain supported.
  */
-export declare function plan(projectDir: string, config: DistributedRenderConfig, planDir: string): Promise<PlanResult>;
+export declare function plan(projectDir: string, config: DistributedRenderConfig, planDir: string, options?: Pick<BuildLocalExecutionPlanOptions, "chunksCarryAudio">): Promise<PlanResult>;

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

@@ -111,5 +111,20 @@ export declare function buildPadTrimAudioArgs(audioPath: string, outputPath: str
  * for the assembled video.
  */
 export declare function padOrTrimAudioToVideoFrameCount(input: PadTrimAudioInput): Promise<PadTrimAudioResult>;
+/**
+ * The true-peak half of {@link padOrTrimAudioToVideoFrameCount}, for AAC already encoded at its
+ * exact length: measures once and re-encodes only when the peak is over the ceiling.
+ */
+export declare function constrainAacTruePeak(input: {
+    audioPath: string;
+    targetDurationSeconds: number;
+    signal?: AbortSignal;
+    timeoutMs?: number;
+}): Promise<{
+    success: boolean;
+    error?: string;
+    failureReason?: "external_interruption";
+    loweredDb?: number;
+}>;
 export declare function defaultProbeVideoFrameInfo(videoPath: string, signal?: AbortSignal): Promise<ProbeVideoFrameInfo>;
 export declare function runFfprobeJson<T>(args: string[], signal?: AbortSignal): Promise<T>;

package/package.json

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