fix(engine): hand an empty audio track back instead of failing the render

ffmpeg exits 0 and writes a structurally valid but EMPTY wav whenever a clip's
trim starts past the end of its source — `-ss 10 -t 5` on a 2 s file. That
track reached `new OfflineAudioContext(channels, 0, rate)`, which throws
NotSupportedError, and the error travels past the mixer's per-track failure
collector: one mis-set `data-media-start` on one clip with one enabled effect
took the WHOLE render down with a RenderQualityError.

An empty track has nothing to process, so applyAudioFxChain now hands the input
back the way it already does for a chain with nothing enabled — before paying
for a browser to decide it. The runtime stub guards the same case at the point
the constructor would actually blow up, since it is reachable by any other
caller of the injected script.

The test falsifies against the real browser path: removing the guard
reproduces `NotSupportedError: The number of frames provided (0) is less than
the minimum bound (1)`.
This commit is contained in:
Vance Ingalls
2026-08-08 10:35:02 -07:00
parent 4bcc7e1882
commit 43c88961b2
3 changed files with 35 additions and 0 deletions
@@ -81,6 +81,11 @@ async function render(
const chain: HfAudioFxChain = parseAudioFxChain(chainJson);
const channels = Math.max(1, planes.length);
const frames = planes[0]?.length ?? 0;
// Nothing to process, and `new OfflineAudioContext(ch, 0, rate)` throws — an
// error the render treats as fatal. applyAudioFxChain screens empty tracks
// out before they reach the browser; this is the same guard at the point the
// constructor would actually blow up.
if (frames === 0) return planes;
const parsedAutomation = automationJson
? resolveAutomation(parseAutomation(automationJson), chain)
: null;
@@ -253,3 +253,25 @@ describe("browser render", () => {
expect(readWav(outPath).samples.length).toBeGreaterThan(0);
}, 180_000);
});
/**
* ffmpeg exits 0 and writes a structurally valid but EMPTY wav whenever a
* clip's trim starts past the end of its source (`-ss 10 -t 5` on a 2 s file).
* That track used to reach `new OfflineAudioContext(ch, 0, rate)`, which throws
* — and the error travels past the mixer's per-track failure collector, so one
* mis-set `data-media-start` took the whole render down.
*/
describe("an empty track", () => {
it("is handed back untouched rather than failing the render", async () => {
const input = join(dir, "empty.wav");
writeWav(input, new Float32Array(0), SR);
const output = join(dir, "out.wav");
// Returns the input path, the same contract as a chain with nothing enabled
// — and without paying for a browser to decide it.
await expect(
applyAudioFxChain(input, chainOf("peaking"), output, { trackId: "t" }),
).resolves.toBe(input);
expect(existsSync(output)).toBe(false);
});
});
@@ -194,6 +194,14 @@ export async function applyAudioFxChain(
const { samples, sampleRate, channels } = readWav(inputWav);
const planes = deinterleave(samples, channels);
// An empty track has nothing to process — and an OfflineAudioContext of zero
// length throws, which is fatal for the WHOLE render rather than this track:
// the error travels past the mixer's per-track failure collector. ffmpeg
// writes an empty but structurally valid WAV whenever a clip's trim starts
// past the end of its source, so one mis-set `data-media-start` used to take
// the render down. Guarded here as well as in the runtime so an empty track
// never costs a browser.
if ((planes[0]?.length ?? 0) === 0) return inputWav;
// Audio processing needs no GPU or special capture mode; a plain sandboxed
// browser is enough, and the lease pool reuses one across tracks.