@editframe/assets 0.59.4 → 0.59.6

package/dist/mediabunny-ingest/MediabunnyIngest.js

@@ -0,0 +1,232 @@
+import { adtsToRawAac, stripSeiNalUnits } from "./bitstream.js";
+import debug from "debug";
+import { PassThrough, Writable } from "node:stream";
+import crypto from "node:crypto";
+import { registerMediabunnyServer } from "@mediabunny/server";
+import { ALL_FORMATS, AppendOnlyStreamTarget, AudioSample, AudioSampleSink, AudioSampleSource, EncodedAudioPacketSource, EncodedPacketSink, EncodedVideoPacketSource, FilePathSource, Input, Mp4OutputFormat, Output, UrlSource } from "mediabunny";
+//#region src/mediabunny-ingest/MediabunnyIngest.ts
+const log = debug("ef:assets:mediabunny-ingest");
+registerMediabunnyServer();
+/** Opens a mediabunny `Input` over a URL or local file path, auto-detecting the container/HLS format. */
+function openIngestInput(source) {
+	return new Input({
+		formats: ALL_FORMATS,
+		source: source.type === "url" ? new UrlSource(source.url) : new FilePathSource(source.path)
+	});
+}
+/**
+* Selects the best video track and its best pairable audio track from an
+* input (matching the "ingest only the best audio and video track" ingest
+* policy). For plain progressive files this is just "the" video/audio track;
+* for HLS master playlists, mediabunny's `getPrimaryVideoTrack`/
+* `getPrimaryAudioTrack` already implement bitrate-based ABR selection.
+*
+* Throws if the source has no usable tracks, or if any selected track is
+* still live (open-ended) — ingestion only supports VOD sources.
+*/
+async function selectIngestTracks(input) {
+	const video = await input.getPrimaryVideoTrack();
+	const audio = video ? await video.getPrimaryPairableAudioTrack() ?? await input.getPrimaryAudioTrack() : await input.getPrimaryAudioTrack();
+	if (!video && !audio) throw new Error("No video or audio tracks found in source");
+	for (const track of [video, audio]) if (track && await track.isLive()) throw new Error("Live (open-ended) sources are not supported for ingestion — only VOD sources can be processed");
+	return {
+		video,
+		audio
+	};
+}
+function bridgeToNodeReadable() {
+	const pass = new PassThrough();
+	return {
+		readable: pass,
+		target: new AppendOnlyStreamTarget(Writable.toWeb(pass))
+	};
+}
+/**
+* Zero-bases a track's packet timestamps around its own decode-order first
+* packet, for two reasons:
+*
+* 1. Mediabunny's MP4 muxer rejects packets with negative timestamps outright.
+*    Negative first-packet timestamps are common and legitimate — e.g. AAC
+*    encoder priming samples, or B-frame reordering — and ffmpeg silently
+*    normalizes them by default (`-avoid_negative_ts make_zero`) when remuxing.
+*
+* 2. For *positive* first-packet timestamps (e.g. a source with a non-zero
+*    container-level `format.start_time`, such as Mux's 90kHz start-time
+*    offset), mediabunny's fragmented-MP4 muxer does NOT zero-base decode
+*    timestamps the way its non-fragmented muxer (and the old ffmpeg-CLI
+*    ingest's remux) does — that normalization is explicitly gated behind
+*    `!isFragmented` in mediabunny's isobmff muxer. Left unshifted, that
+*    container-level offset leaks into the produced track's absolute
+*    timestamps, which `generateFragmentIndex` reads assuming DTS starts at
+*    0 (see its "After ffmpeg re-mux, DTS is always 0" comment) — corrupting
+*    its detected `startTimeOffsetMs` by exactly that leaked amount.
+*
+* Shifting every packet by `-firstTimestamp` handles both cases and is a
+* no-op for the common case where the track already starts at t=0. It does
+* NOT erase a genuine B-frame reordering offset (CTS > DTS for the first
+* decode-order packet): that offset is a *relative* property between a
+* packet's own timestamp and its decode-order position, which a uniform
+* shift preserves.
+*/
+async function getTimestampOffset(track) {
+	return -await track.getFirstTimestamp();
+}
+function md5Digest(hash) {
+	const hex = hash.digest("hex");
+	return `${hex.slice(0, 8)}-${hex.slice(8, 12)}-${hex.slice(12, 16)}-${hex.slice(16, 20)}-${hex.slice(20, 32)}`;
+}
+/**
+* Extracts a single video track into a fragmented single-track MP4 stream via
+* packet-copy transmux (no re-encoding — matches the previous ffmpeg `-c:v copy`
+* behavior). SEI NAL units (type 6) are stripped from every packet, mirroring the
+* previous `-bsf:v filter_units=remove_types=6` ffmpeg filter.
+*/
+function extractVideoTrack(track) {
+	const { readable, target } = bridgeToNodeReadable();
+	const hash = crypto.createHash("md5");
+	const digestDeferred = createDeferred();
+	(async () => {
+		const codec = await track.getCodec();
+		if (!codec) throw new Error("Video track has no known codec");
+		const decoderConfig = await track.getDecoderConfig();
+		const isAnnexB = decoderConfig?.description === void 0;
+		const tsOffset = await getTimestampOffset(track);
+		const output = new Output({
+			format: new Mp4OutputFormat({ fastStart: "fragmented" }),
+			target
+		});
+		const source = new EncodedVideoPacketSource(codec);
+		output.addVideoTrack(source);
+		await output.start();
+		const sink = new EncodedPacketSink(track);
+		let isFirst = true;
+		for await (const packet of sink.packets()) {
+			hash.update(packet.data);
+			const strippedData = stripSeiNalUnits(packet.data, isAnnexB);
+			const outPacket = strippedData !== packet.data || tsOffset !== 0 ? packet.clone({
+				data: strippedData,
+				timestamp: packet.timestamp + tsOffset
+			}) : packet;
+			await source.add(outPacket, isFirst && decoderConfig ? { decoderConfig } : void 0);
+			isFirst = false;
+		}
+		await output.finalize();
+	})().then(() => digestDeferred.resolve(md5Digest(hash))).catch((error) => {
+		digestDeferred.reject(error);
+		readable.emit("error", error);
+		readable.destroy(error instanceof Error ? error : new Error(String(error)));
+	});
+	return {
+		stream: readable,
+		digest: digestDeferred.promise
+	};
+}
+/**
+* Extracts a single audio track into a fragmented single-track MP4 stream.
+*
+* - AAC-raw sources (description present) are packet-copied directly.
+* - AAC-ADTS sources (typical of MPEG-TS/HLS demuxed AAC) have their ADTS
+*   headers stripped and an AudioSpecificConfig synthesized, mirroring the
+*   previous `-bsf:a aac_adtstoasc` ffmpeg filter.
+* - Any other codec is decoded and re-encoded to AAC (192kbps), mirroring the
+*   previous `-c:a aac -b:a 192k -ar 48000` ffmpeg re-encode fallback.
+*/
+function extractAudioTrack(track) {
+	const { readable, target } = bridgeToNodeReadable();
+	const hash = crypto.createHash("md5");
+	const digestDeferred = createDeferred();
+	(async () => {
+		const codec = await track.getCodec();
+		const decoderConfig = await track.getDecoderConfig();
+		const isAdtsAac = codec === "aac" && decoderConfig?.description === void 0;
+		const needsReencode = codec !== "aac";
+		const tsOffset = await getTimestampOffset(track);
+		const output = new Output({
+			format: new Mp4OutputFormat({ fastStart: "fragmented" }),
+			target
+		});
+		if (needsReencode) {
+			const source = new AudioSampleSource({
+				codec: "aac",
+				bitrate: 192e3
+			});
+			output.addAudioTrack(source);
+			await output.start();
+			const hashPromise = (async () => {
+				const packetSink = new EncodedPacketSink(track);
+				for await (const packet of packetSink.packets()) hash.update(packet.data);
+			})();
+			const sampleSink = new AudioSampleSink(track);
+			for await (const sample of sampleSink.samples()) try {
+				if (tsOffset === 0) {
+					await source.add(sample);
+					continue;
+				}
+				const shifted = AudioSample.fromAudioBuffer(sample.toAudioBuffer(), sample.timestamp + tsOffset);
+				for (const out of shifted) try {
+					await source.add(out);
+				} finally {
+					out.close();
+				}
+			} finally {
+				sample.close();
+			}
+			await hashPromise;
+			await output.finalize();
+			return;
+		}
+		const source = new EncodedAudioPacketSource("aac");
+		output.addAudioTrack(source);
+		await output.start();
+		const sink = new EncodedPacketSink(track);
+		const [sampleRate, numberOfChannels] = await Promise.all([track.getSampleRate(), track.getNumberOfChannels()]);
+		let isFirst = true;
+		for await (const packet of sink.packets()) {
+			hash.update(packet.data);
+			if (!isAdtsAac) {
+				const outPacket = tsOffset !== 0 ? packet.clone({ timestamp: packet.timestamp + tsOffset }) : packet;
+				await source.add(outPacket, isFirst && decoderConfig ? { decoderConfig } : void 0);
+				isFirst = false;
+				continue;
+			}
+			const raw = adtsToRawAac(packet.data);
+			const outPacket = packet.clone({
+				data: raw.data,
+				timestamp: packet.timestamp + tsOffset
+			});
+			await source.add(outPacket, isFirst ? { decoderConfig: {
+				codec: raw.codec,
+				sampleRate,
+				numberOfChannels,
+				description: raw.audioSpecificConfig
+			} } : void 0);
+			isFirst = false;
+		}
+		await output.finalize();
+	})().then(() => digestDeferred.resolve(md5Digest(hash))).catch((error) => {
+		digestDeferred.reject(error);
+		readable.emit("error", error);
+		readable.destroy(error instanceof Error ? error : new Error(String(error)));
+	});
+	return {
+		stream: readable,
+		digest: digestDeferred.promise
+	};
+}
+function createDeferred() {
+	let resolve;
+	let reject;
+	return {
+		promise: new Promise((res, rej) => {
+			resolve = res;
+			reject = rej;
+		}),
+		resolve,
+		reject
+	};
+}
+log("Mediabunny ingest module loaded");
+//#endregion
+export { extractAudioTrack, extractVideoTrack, openIngestInput, selectIngestTracks };
+
+//# sourceMappingURL=MediabunnyIngest.js.map

package/dist/mediabunny-ingest/MediabunnyIngest.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"MediabunnyIngest.js","names":["NodeWritable"],"sources":["../../src/mediabunny-ingest/MediabunnyIngest.ts"],"mappings":"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"}

package/dist/mediabunny-ingest/bitstream.cjs

@@ -0,0 +1,118 @@
+//#region src/mediabunny-ingest/bitstream.ts
+/**
+* Bitstream-level helpers used by the mediabunny-based ingest pipeline.
+*
+* These replace two ffmpeg bitstream filters that the old ffmpeg-CLI ingest
+* path relied on:
+*
+*   -bsf:v filter_units=remove_types=6   (strip SEI NAL units — see stripSeiNalUnits)
+*   -bsf:a aac_adtstoasc                 (ADTS -> raw AAC — see adtsToRawAac)
+*/
+const SEI_NAL_UNIT_TYPE = 6;
+function concatUint8Arrays(chunks, totalLength) {
+	const out = new Uint8Array(totalLength);
+	let offset = 0;
+	for (const chunk of chunks) {
+		out.set(chunk, offset);
+		offset += chunk.length;
+	}
+	return out;
+}
+/**
+* Strips SEI (Supplemental Enhancement Information, NAL unit type 6) NAL units
+* from an AVC access unit. Some WebCodecs VideoDecoder implementations hang or
+* crash on certain SEI payloads, so these are dropped — mirroring the
+* `-bsf:v filter_units=remove_types=6` ffmpeg filter used by the previous
+* ffmpeg-CLI ingest path.
+*
+* @param data - The packet's encoded data, as produced by mediabunny's
+*   `EncodedPacketSink`.
+* @param isAnnexB - Whether the AVC bitstream is in Annex B (start-code
+*   delimited) format rather than canonical (4-byte length-prefixed) format.
+*   Per the Mediabunny Codec Registry, this is true iff the track's decoder
+*   config `description` is `undefined`.
+*/
+function stripSeiNalUnits(data, isAnnexB) {
+	return isAnnexB ? stripSeiAnnexB(data) : stripSeiLengthPrefixed(data);
+}
+function stripSeiLengthPrefixed(data) {
+	const kept = [];
+	let keptLength = 0;
+	let offset = 0;
+	while (offset + 4 <= data.length) {
+		const len = data[offset] << 24 | data[offset + 1] << 16 | data[offset + 2] << 8 | data[offset + 3];
+		const nalStart = offset + 4;
+		const nalEnd = nalStart + len;
+		if (len < 0 || nalEnd > data.length || nalStart >= data.length) return data;
+		if ((data[nalStart] & 31) !== SEI_NAL_UNIT_TYPE) {
+			const nalu = data.subarray(offset, nalEnd);
+			kept.push(nalu);
+			keptLength += nalu.length;
+		}
+		offset = nalEnd;
+	}
+	if (offset !== data.length) return data;
+	return concatUint8Arrays(kept, keptLength);
+}
+function stripSeiAnnexB(data) {
+	const starts = findAnnexBNaluStarts(data);
+	if (starts.length === 0) return data;
+	const kept = [];
+	let keptLength = 0;
+	for (let i = 0; i < starts.length; i++) {
+		const { prefixStart, nalStart } = starts[i];
+		const nalEnd = i + 1 < starts.length ? starts[i + 1].prefixStart : data.length;
+		if ((data[nalStart] & 31) !== SEI_NAL_UNIT_TYPE) {
+			const chunk = data.subarray(prefixStart, nalEnd);
+			kept.push(chunk);
+			keptLength += chunk.length;
+		}
+	}
+	return concatUint8Arrays(kept, keptLength);
+}
+/** Finds every Annex B start code (0x000001 or 0x00000001) and the NALU byte right after it. */
+function findAnnexBNaluStarts(data) {
+	const starts = [];
+	for (let i = 0; i + 2 < data.length; i++) if (data[i] === 0 && data[i + 1] === 0 && data[i + 2] === 1) {
+		const isFourByte = i > 0 && data[i - 1] === 0;
+		starts.push({
+			prefixStart: isFourByte ? i - 1 : i,
+			nalStart: i + 3
+		});
+	}
+	return starts;
+}
+/**
+* Converts a single ADTS-framed AAC packet (as produced by mediabunny when
+* reading AAC out of an MPEG-TS/HLS source) into raw AAC frame data plus the
+* AudioSpecificConfig an MP4 muxer needs out-of-band. Mirrors ffmpeg's
+* `aac_adtstoasc` bitstream filter.
+*
+* Only single-AAC-frame ADTS packets (`number_of_raw_data_blocks == 0`) are
+* supported — this covers the overwhelming majority of real-world HLS/Mux
+* output. Multi-block ADTS packets throw so the caller can fall back to a
+* decode/re-encode path instead of silently mis-parsing audio.
+*/
+function adtsToRawAac(data) {
+	if (data.length < 7) throw new Error("ADTS packet too short to contain a header");
+	if (data[0] !== 255 || (data[1] & 240) !== 240) throw new Error("Data does not start with an ADTS sync word");
+	const headerLength = (data[1] & 1) === 1 ? 7 : 9;
+	const profile = data[2] >> 6 & 3;
+	const samplingFrequencyIndex = data[2] >> 2 & 15;
+	const channelConfiguration = (data[2] & 1) << 2 | data[3] >> 6 & 3;
+	const numberOfRawDataBlocks = data[6] & 3;
+	if (numberOfRawDataBlocks !== 0) throw new Error(`Multi-block ADTS packets (number_of_raw_data_blocks=${numberOfRawDataBlocks}) are not supported`);
+	const audioObjectType = profile + 1;
+	const ascValue = audioObjectType << 11 | samplingFrequencyIndex << 7 | channelConfiguration << 3;
+	const audioSpecificConfig = new Uint8Array([ascValue >> 8 & 255, ascValue & 255]);
+	return {
+		data: data.subarray(headerLength),
+		audioSpecificConfig,
+		codec: `mp4a.40.${audioObjectType}`
+	};
+}
+//#endregion
+exports.adtsToRawAac = adtsToRawAac;
+exports.stripSeiNalUnits = stripSeiNalUnits;
+
+//# sourceMappingURL=bitstream.cjs.map

package/dist/mediabunny-ingest/bitstream.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"bitstream.cjs","names":[],"sources":["../../src/mediabunny-ingest/bitstream.ts"],"mappings":"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"}

package/dist/mediabunny-ingest/bitstream.js

@@ -0,0 +1,117 @@
+//#region src/mediabunny-ingest/bitstream.ts
+/**
+* Bitstream-level helpers used by the mediabunny-based ingest pipeline.
+*
+* These replace two ffmpeg bitstream filters that the old ffmpeg-CLI ingest
+* path relied on:
+*
+*   -bsf:v filter_units=remove_types=6   (strip SEI NAL units — see stripSeiNalUnits)
+*   -bsf:a aac_adtstoasc                 (ADTS -> raw AAC — see adtsToRawAac)
+*/
+const SEI_NAL_UNIT_TYPE = 6;
+function concatUint8Arrays(chunks, totalLength) {
+	const out = new Uint8Array(totalLength);
+	let offset = 0;
+	for (const chunk of chunks) {
+		out.set(chunk, offset);
+		offset += chunk.length;
+	}
+	return out;
+}
+/**
+* Strips SEI (Supplemental Enhancement Information, NAL unit type 6) NAL units
+* from an AVC access unit. Some WebCodecs VideoDecoder implementations hang or
+* crash on certain SEI payloads, so these are dropped — mirroring the
+* `-bsf:v filter_units=remove_types=6` ffmpeg filter used by the previous
+* ffmpeg-CLI ingest path.
+*
+* @param data - The packet's encoded data, as produced by mediabunny's
+*   `EncodedPacketSink`.
+* @param isAnnexB - Whether the AVC bitstream is in Annex B (start-code
+*   delimited) format rather than canonical (4-byte length-prefixed) format.
+*   Per the Mediabunny Codec Registry, this is true iff the track's decoder
+*   config `description` is `undefined`.
+*/
+function stripSeiNalUnits(data, isAnnexB) {
+	return isAnnexB ? stripSeiAnnexB(data) : stripSeiLengthPrefixed(data);
+}
+function stripSeiLengthPrefixed(data) {
+	const kept = [];
+	let keptLength = 0;
+	let offset = 0;
+	while (offset + 4 <= data.length) {
+		const len = data[offset] << 24 | data[offset + 1] << 16 | data[offset + 2] << 8 | data[offset + 3];
+		const nalStart = offset + 4;
+		const nalEnd = nalStart + len;
+		if (len < 0 || nalEnd > data.length || nalStart >= data.length) return data;
+		if ((data[nalStart] & 31) !== SEI_NAL_UNIT_TYPE) {
+			const nalu = data.subarray(offset, nalEnd);
+			kept.push(nalu);
+			keptLength += nalu.length;
+		}
+		offset = nalEnd;
+	}
+	if (offset !== data.length) return data;
+	return concatUint8Arrays(kept, keptLength);
+}
+function stripSeiAnnexB(data) {
+	const starts = findAnnexBNaluStarts(data);
+	if (starts.length === 0) return data;
+	const kept = [];
+	let keptLength = 0;
+	for (let i = 0; i < starts.length; i++) {
+		const { prefixStart, nalStart } = starts[i];
+		const nalEnd = i + 1 < starts.length ? starts[i + 1].prefixStart : data.length;
+		if ((data[nalStart] & 31) !== SEI_NAL_UNIT_TYPE) {
+			const chunk = data.subarray(prefixStart, nalEnd);
+			kept.push(chunk);
+			keptLength += chunk.length;
+		}
+	}
+	return concatUint8Arrays(kept, keptLength);
+}
+/** Finds every Annex B start code (0x000001 or 0x00000001) and the NALU byte right after it. */
+function findAnnexBNaluStarts(data) {
+	const starts = [];
+	for (let i = 0; i + 2 < data.length; i++) if (data[i] === 0 && data[i + 1] === 0 && data[i + 2] === 1) {
+		const isFourByte = i > 0 && data[i - 1] === 0;
+		starts.push({
+			prefixStart: isFourByte ? i - 1 : i,
+			nalStart: i + 3
+		});
+	}
+	return starts;
+}
+/**
+* Converts a single ADTS-framed AAC packet (as produced by mediabunny when
+* reading AAC out of an MPEG-TS/HLS source) into raw AAC frame data plus the
+* AudioSpecificConfig an MP4 muxer needs out-of-band. Mirrors ffmpeg's
+* `aac_adtstoasc` bitstream filter.
+*
+* Only single-AAC-frame ADTS packets (`number_of_raw_data_blocks == 0`) are
+* supported — this covers the overwhelming majority of real-world HLS/Mux
+* output. Multi-block ADTS packets throw so the caller can fall back to a
+* decode/re-encode path instead of silently mis-parsing audio.
+*/
+function adtsToRawAac(data) {
+	if (data.length < 7) throw new Error("ADTS packet too short to contain a header");
+	if (data[0] !== 255 || (data[1] & 240) !== 240) throw new Error("Data does not start with an ADTS sync word");
+	const headerLength = (data[1] & 1) === 1 ? 7 : 9;
+	const profile = data[2] >> 6 & 3;
+	const samplingFrequencyIndex = data[2] >> 2 & 15;
+	const channelConfiguration = (data[2] & 1) << 2 | data[3] >> 6 & 3;
+	const numberOfRawDataBlocks = data[6] & 3;
+	if (numberOfRawDataBlocks !== 0) throw new Error(`Multi-block ADTS packets (number_of_raw_data_blocks=${numberOfRawDataBlocks}) are not supported`);
+	const audioObjectType = profile + 1;
+	const ascValue = audioObjectType << 11 | samplingFrequencyIndex << 7 | channelConfiguration << 3;
+	const audioSpecificConfig = new Uint8Array([ascValue >> 8 & 255, ascValue & 255]);
+	return {
+		data: data.subarray(headerLength),
+		audioSpecificConfig,
+		codec: `mp4a.40.${audioObjectType}`
+	};
+}
+//#endregion
+export { adtsToRawAac, stripSeiNalUnits };
+
+//# sourceMappingURL=bitstream.js.map

package/dist/mediabunny-ingest/bitstream.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"bitstream.js","names":[],"sources":["../../src/mediabunny-ingest/bitstream.ts"],"mappings":"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"}

package/dist/tasks/generateScrubTrack.d.cts

@@ -1,9 +1,10 @@
 import { TrackFragmentIndex } from "../Probe.cjs";
 import { TaskResult } from "../idempotentTask.cjs";
+import { Readable } from "node:stream";
 
 //#region src/tasks/generateScrubTrack.d.ts
 declare const generateScrubTrackFromPath: (absolutePath: string) => Promise<{
-  stream: any;
+  stream: Readable;
   fragmentIndex: Promise<Record<number, TrackFragmentIndex>>;
 }>;
 declare const generateScrubTrack: (cacheRoot: string, absolutePath: string) => Promise<TaskResult>;

package/dist/tasks/generateScrubTrack.d.ts

@@ -1,9 +1,10 @@
 import { TrackFragmentIndex } from "../Probe.js";
 import { TaskResult } from "../idempotentTask.js";
+import { Readable } from "node:stream";
 
 //#region src/tasks/generateScrubTrack.d.ts
 declare const generateScrubTrackFromPath: (absolutePath: string) => Promise<{
-  stream: any;
+  stream: Readable;
   fragmentIndex: Promise<Record<number, TrackFragmentIndex>>;
 }>;
 declare const generateScrubTrack: (cacheRoot: string, absolutePath: string) => Promise<TaskResult>;

package/dist/tasks/generateTrack.d.cts

@@ -1,7 +1,8 @@
 import { TaskResult } from "../idempotentTask.cjs";
+import { Readable } from "node:stream";
 
 //#region src/tasks/generateTrack.d.ts
-declare const generateTrackFromPath: (absolutePath: string, trackId: number) => Promise<any>;
+declare const generateTrackFromPath: (absolutePath: string, trackId: number) => Promise<Readable>;
 declare const generateTrack: (cacheRoot: string, absolutePath: string, url: string) => Promise<TaskResult>;
 //#endregion
 export { generateTrack, generateTrackFromPath };

package/dist/tasks/generateTrack.d.ts

@@ -1,7 +1,8 @@
 import { TaskResult } from "../idempotentTask.js";
+import { Readable } from "node:stream";
 
 //#region src/tasks/generateTrack.d.ts
-declare const generateTrackFromPath: (absolutePath: string, trackId: number) => Promise<any>;
+declare const generateTrackFromPath: (absolutePath: string, trackId: number) => Promise<Readable>;
 declare const generateTrack: (cacheRoot: string, absolutePath: string, url: string) => Promise<TaskResult>;
 //#endregion
 export { generateTrack, generateTrackFromPath };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@editframe/assets",
-  "version": "0.59.4",
+  "version": "0.59.6",
   "description": "",
   "repository": {
     "type": "git",
@@ -17,7 +17,9 @@
   "author": "",
   "license": "SEE LICENSE IN LICENSE-FULL.md",
   "dependencies": {
+    "@mediabunny/server": "^1.52.0",
     "debug": "^4.3.5",
+    "mediabunny": "^1.50.8",
     "ora": "^8.0.1",
     "zod": "^3.23.8"
   },