@hyperframes/engine 0.8.162 → 0.8.163

package/dist/services/audioMixer.js

@@ -892,6 +892,7 @@ async function mixThroughMasterBus(tracks, masterChain, outputPath, workDir, tot
 export async function processCompositionAudio(elements, baseDir, workDir, outputPath, totalDuration, signal, config, compiledDir) {
     const startMs = Date.now();
     const tracks = [];
+    const preparedTracks = new Array(elements.length);
     const failures = [];
     // Grouped members are diverted here instead of `tracks` during element
     // processing, then summed into one processed track per group before the
@@ -922,7 +923,7 @@ export async function processCompositionAudio(elements, baseDir, workDir, output
         else
             signal.addEventListener("abort", () => internalController.abort(), { once: true });
     }
-    await Promise.all(elements.map(async (element) => {
+    await Promise.all(elements.map(async (element, index) => {
         if (effectiveSignal.aborted) {
             failures.push({
                 stage: "cancelled",
@@ -1097,27 +1098,7 @@ export async function processCompositionAudio(elements, baseDir, workDir, output
                 ...(element.fadeOut ? { fadeOut: element.fadeOut } : {}),
                 ...(tailSeconds > 0 ? { tailSeconds } : {}),
             };
-            // A grouped member keeps every bit of its OWN processing above
-            // (FX, envelope) exactly like an ungrouped track — it just lands in
-            // the group's bucket instead of the flat list, to be summed into one
-            // processed bus below rather than mixed directly.
-            if (element.groupId) {
-                const bucket = groupTracks.get(element.groupId);
-                if (bucket)
-                    bucket.push(track);
-                else
-                    groupTracks.set(element.groupId, [track]);
-                if (!groupMeta.has(element.groupId)) {
-                    groupMeta.set(element.groupId, {
-                        ...(element.groupFxChain ? { fxChain: element.groupFxChain } : {}),
-                        ...(element.groupAutomation ? { automation: element.groupAutomation } : {}),
-                        volume: element.groupVolume ?? 1,
-                    });
-                }
-            }
-            else {
-                tracks.push(track);
-            }
+            preparedTracks[index] = track;
         }
         catch (err) {
             // An FX failure is fatal for the whole mix. Every other failure mode
@@ -1147,6 +1128,30 @@ export async function processCompositionAudio(elements, baseDir, workDir, output
         }
         throw err;
     });
+    // FFmpeg's floating-point sum depends on input order. Keep parallel prep,
+    // but assemble flat tracks, group members and groups in authored order.
+    elements.forEach((element, index) => {
+        const track = preparedTracks[index];
+        if (!track)
+            return;
+        if (element.groupId) {
+            const bucket = groupTracks.get(element.groupId);
+            if (bucket)
+                bucket.push(track);
+            else
+                groupTracks.set(element.groupId, [track]);
+            if (!groupMeta.has(element.groupId)) {
+                groupMeta.set(element.groupId, {
+                    ...(element.groupFxChain ? { fxChain: element.groupFxChain } : {}),
+                    ...(element.groupAutomation ? { automation: element.groupAutomation } : {}),
+                    volume: element.groupVolume ?? 1,
+                });
+            }
+        }
+        else {
+            tracks.push(track);
+        }
+    });
     // Never turn a per-track preparation failure into a successful partial mix.
     // The producer only surfaces audio failures when `success` is false; mixing
     // the remaining tracks made the omitted cue indistinguishable from a valid

package/dist/utils/runFfmpeg.d.ts

@@ -48,5 +48,5 @@ export declare function ffmpegStatsReader(onStats: (stats: FfmpegStats) => void)
  */
 export declare function formatFfmpegError(exitCode: number | null, stderr: string, tailLines?: number): string;
 /** formatFfmpegError, led by the timeout when this process was killed at its deadline. */
-export declare function describeFfmpegFailure(result: Pick<RunFfmpegResult, "exitCode" | "stderr" | "terminationReason">, timeoutMs: number): string;
+export declare function describeFfmpegFailure(result: Pick<RunFfmpegResult, "exitCode" | "signal" | "stderr" | "terminationReason">, timeoutMs: number): string;
 export declare function runFfmpeg(args: string[], opts?: RunFfmpegOptions): Promise<RunFfmpegResult>;

package/dist/utils/runFfmpeg.js

@@ -97,10 +97,16 @@ export function formatFfmpegError(exitCode, stderr, tailLines = DEFAULT_STDERR_T
 /** formatFfmpegError, led by the timeout when this process was killed at its deadline. */
 export function describeFfmpegFailure(result, timeoutMs) {
     const error = formatFfmpegError(result.exitCode, result.stderr);
-    if (result.terminationReason !== "deadline")
+    if (result.terminationReason === "deadline") {
+        return (`FFmpeg timed out after ${timeoutMs} ms (ffmpegProcessTimeout; long renders can raise ` +
+            `FFMPEG_PROCESS_TIMEOUT_MS). ${error}`);
+    }
+    if (result.exitCode !== null)
         return error;
-    return (`FFmpeg timed out after ${timeoutMs} ms (ffmpegProcessTimeout; long renders can raise ` +
-        `FFMPEG_PROCESS_TIMEOUT_MS). ${error}`);
+    const signalOrRequestedStop = result.terminationReason === "exit" ? result.signal : result.terminationReason;
+    return signalOrRequestedStop
+        ? `FFmpeg ended without an exit code (${signalOrRequestedStop}). ${error}`
+        : error;
 }
 function spawnFfmpeg(args) {
     // windowsHide: ffmpeg/ffprobe are console-subsystem binaries, so without

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@hyperframes/engine",
-  "version": "0.8.162",
+  "version": "0.8.163",
   "description": "Seekable web page to video rendering engine (Puppeteer + FFmpeg)",
   "repository": {
     "type": "git",
@@ -50,8 +50,8 @@
     "linkedom": "^0.18.12",
     "puppeteer": "^25.8.0",
     "puppeteer-core": "^25.8.0",
-    "@hyperframes/core": "^0.8.162",
-    "@hyperframes/parsers": "^0.8.162"
+    "@hyperframes/core": "^0.8.163",
+    "@hyperframes/parsers": "^0.8.163"
   },
   "devDependencies": {
     "@types/node": "^25.0.10",