@editframe/assets 0.49.5 → 0.49.7

package/dist/tasks/generateScrubTrack.js

@@ -1,11 +1,10 @@
 import { Probe } from "../Probe.js";
 import { generateFragmentIndex } from "../generateFragmentIndex.js";
 import { idempotentTask } from "../idempotentTask.js";
-import { generateWebmSegmentIndex } from "../generateWebmSegmentIndex.js";
-import { createReadStream } from "node:fs";
+import { generateWebmSegmentIndex, patchWebmForSegmentedServing } from "../generateWebmSegmentIndex.js";
+import { mkdtemp, readFile, rm } from "node:fs/promises";
 import debug from "debug";
-import { PassThrough } from "node:stream";
-import { mkdtemp, rm } from "node:fs/promises";
+import { PassThrough, Readable } from "node:stream";
 import { tmpdir } from "node:os";
 import { basename, join } from "node:path";
 //#region src/tasks/generateScrubTrack.ts
@@ -19,30 +18,26 @@ const generateScrubTrackFromPath = async (absolutePath) => {
 		log("VP9 alpha source: generating WebM scrub track");
 		const tmpDir = await mkdtemp(join(tmpdir(), "ef-scrub-webm-"));
 		const tmpPath = join(tmpDir, "scrub.webm");
-		await probe.transcodeWebmScrubToFile(tmpPath);
-		const scrubTrack = (await generateWebmSegmentIndex(tmpPath, startTimeOffsetMs))[1];
-		if (!scrubTrack) throw new Error("No track 1 in VP9 scrub WebM segment index");
-		const fragmentIndex = { [-1]: {
-			...scrubTrack,
-			track: -1
-		} };
-		const outputStream = createReadStream(tmpPath);
-		outputStream.on("close", () => {
-			rm(tmpDir, {
-				recursive: true,
-				force: true
-			}).catch(() => {});
-		});
-		outputStream.on("error", () => {
+		try {
+			await probe.transcodeWebmScrubToFile(tmpPath);
+			const scrubTrack = (await generateWebmSegmentIndex(tmpPath, startTimeOffsetMs))[1];
+			if (!scrubTrack) throw new Error("No track 1 in VP9 scrub WebM segment index");
+			const fragmentIndex = { [-1]: {
+				...scrubTrack,
+				track: -1
+			} };
+			const buf = await readFile(tmpPath);
+			patchWebmForSegmentedServing(buf);
+			return {
+				stream: Readable.from(buf),
+				fragmentIndex: Promise.resolve(fragmentIndex)
+			};
+		} finally {
 			rm(tmpDir, {
 				recursive: true,
 				force: true
 			}).catch(() => {});
-		});
-		return {
-			stream: outputStream,
-			fragmentIndex: Promise.resolve(fragmentIndex)
-		};
+		}
 	}
 	const scrubStream = probe.createScrubTrackReadstream();
 	const outputStream = new PassThrough();
@@ -84,15 +79,17 @@ const generateScrubTrackTask = idempotentTask({
 			log("VP9 alpha source: generating WebM scrub track for cache");
 			const tmpDir = await mkdtemp(join(tmpdir(), "ef-scrub-webm-"));
 			const tmpPath = join(tmpDir, "scrub.webm");
-			await probe.transcodeWebmScrubToFile(tmpPath);
-			const fileStream = createReadStream(tmpPath);
-			fileStream.on("close", () => {
+			try {
+				await probe.transcodeWebmScrubToFile(tmpPath);
+				const buf = await readFile(tmpPath);
+				patchWebmForSegmentedServing(buf);
+				return Readable.from(buf);
+			} finally {
 				rm(tmpDir, {
 					recursive: true,
 					force: true
 				}).catch(() => {});
-			});
-			return fileStream;
+			}
 		}
 		const scrubStream = probe.createScrubTrackReadstream();
 		const finalStream = new PassThrough();

package/dist/tasks/generateScrubTrack.js.map

@@ -1 +1 @@
-{"version":3,"file":"generateScrubTrack.js","names":[],"sources":["../../src/tasks/generateScrubTrack.ts"],"mappings":"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"}
+{"version":3,"file":"generateScrubTrack.js","names":[],"sources":["../../src/tasks/generateScrubTrack.ts"],"mappings":";;;;;;;;;;AAeA,MAAM,MAAM,MAAM,wBAAwB;AAE1C,MAAa,6BAA6B,OAAO,iBAAyB;AACxE,KAAI,8BAA8B,eAAe;CAEjD,MAAM,QAAQ,MAAM,MAAM,UAAU,aAAa;AAEjD,KAAI,MAAM,aAAa,WAAW,EAChC,OAAM,IAAI,MAAM,mDAAmD;CAGrE,MAAM,oBAAoB,MAAM;AAEhC,KAAI,MAAM,eAAe;AACvB,MAAI,gDAAgD;EAEpD,MAAM,SAAS,MAAM,QAAQ,KAAK,QAAQ,EAAE,iBAAiB,CAAC;EAC9D,MAAM,UAAU,KAAK,QAAQ,aAAa;AAE1C,MAAI;AACF,SAAM,MAAM,yBAAyB,QAAQ;GAM7C,MAAM,cADW,MAAM,yBAAyB,SAAS,kBAAkB,EAC/C;AAC5B,OAAI,CAAC,WAAY,OAAM,IAAI,MAAM,6CAA6C;GAC9E,MAAM,gBAAoD,GACvD,KAAK;IAAE,GAAG;IAAY,OAAO;IAAI,EACnC;GAMD,MAAM,MAAM,MAAM,SAAS,QAAQ;AACnC,gCAA6B,IAAI;AAEjC,UAAO;IACL,QAAQ,SAAS,KAAK,IAAI;IAC1B,eAAe,QAAQ,QAAQ,cAAc;IAC9C;YACO;AACR,MAAG,QAAQ;IAAE,WAAW;IAAM,OAAO;IAAM,CAAC,CAAC,YAAY,GAAG;;;CAKhE,MAAM,cAAc,MAAM,4BAA4B;CAEtD,MAAM,eAAe,IAAI,aAAa;CACtC,MAAM,cAAc,IAAI,aAAa;AAErC,aAAY,KAAK,cAAc,EAAE,KAAK,OAAO,CAAC;AAC9C,aAAY,KAAK,YAAY;CAE7B,IAAI,oBAAoB;AACxB,aAAY,GAAG,aAAa;AAC1B,sBAAoB;GACpB;AAEF,aAAY,GAAG,UAAU,UAAU;AACjC,eAAa,QAAQ,MAAM;AAC3B,cAAY,QAAQ,MAAM;GAC1B;CAIF,MAAM,uBAAuB,sBAC3B,aACA,mBAJqB,EAAE,GAAG,IAAa,CAMxC;AAED,sBACG,WAAW;AACV,MAAI,kBACF,cAAa,KAAK;MAElB,aAAY,KAAK,aAAa;AAC5B,gBAAa,KAAK;IAClB;GAEJ,CACD,OAAO,UAAU;AAChB,eAAa,QAAQ,MAAM;GAC3B;AAEJ,QAAO;EAAE,QAAQ;EAAc,eAAe;EAAsB;;AAGtE,MAAa,yBAAyB,eAAe;CACnD,OAAO;CACP,WAAW,iBAAyB;EAElC,MAAM,MAAM,aAAa,SAAS,QAAQ,GAAG,SAAS;AACtD,SAAO,GAAG,SAAS,aAAa,CAAC,eAAe;;CAElD,QAAQ,OAAO,iBAAyB;EACtC,MAAM,QAAQ,MAAM,MAAM,UAAU,aAAa;AAEjD,MAAI,MAAM,aAAa,WAAW,EAChC,OAAM,IAAI,MAAM,mDAAmD;AAGrE,MAAI,MAAM,eAAe;AACvB,OAAI,0DAA0D;GAE9D,MAAM,SAAS,MAAM,QAAQ,KAAK,QAAQ,EAAE,iBAAiB,CAAC;GAC9D,MAAM,UAAU,KAAK,QAAQ,aAAa;AAE1C,OAAI;AACF,UAAM,MAAM,yBAAyB,QAAQ;IAM7C,MAAM,MAAM,MAAM,SAAS,QAAQ;AACnC,iCAA6B,IAAI;AACjC,WAAO,SAAS,KAAK,IAAI;aACjB;AACR,OAAG,QAAQ;KAAE,WAAW;KAAM,OAAO;KAAM,CAAC,CAAC,YAAY,GAAG;;;EAKhE,MAAM,cAAc,MAAM,4BAA4B;EACtD,MAAM,cAAc,IAAI,aAAa;EAErC,IAAI,kBAAyC;EAE7C,MAAM,6BAA6B;AACjC,OAAI,gBACF,cAAa,gBAAgB;AAG/B,qBAAkB,iBAAiB;AACjC,QAAI,CAAC,YAAY,WAAW;AAC1B,aAAQ,KAAK,0EAA0E;AACvF,iBAAY,wBAAQ,IAAI,MAAM,iCAAiC,CAAC;;MAEjE,IAAM;;AAGX,wBAAsB;AAEtB,cAAY,GAAG,cAAc;AAC3B,yBAAsB;IACtB;AAEF,cAAY,GAAG,aAAa;AAC1B,yBAAsB;AACtB,eAAY,KAAK;IACjB;AAEF,cAAY,GAAG,UAAU,UAAU;AACjC,OAAI,gBACF,cAAa,gBAAgB;AAE/B,eAAY,QAAQ,MAAM;IAC1B;AAEF,cAAY,KAAK,aAAa,EAAE,KAAK,OAAO,CAAC;AAE7C,cAAY,GAAG,aAAa;AAC1B,OAAI,gBACF,cAAa,gBAAgB;IAE/B;AAEF,SAAO;;CAEV,CAAC;AAEF,MAAa,qBAAqB,OAAO,WAAmB,iBAAyB;AACnF,KAAI;AACF,SAAO,MAAM,uBAAuB,WAAW,aAAa;UACrD,OAAO;AACd,UAAQ,MAAM,MAAM;AACpB,UAAQ,MAAM,gCAAgC,MAAM;AACpD,QAAM"}

package/dist/tasks/generateTrack.cjs

@@ -3,28 +3,45 @@ const require_Probe = require("../Probe.cjs");
 const require_idempotentTask = require("../idempotentTask.cjs");
 const require_generateWebmSegmentIndex = require("../generateWebmSegmentIndex.cjs");
 const require_generateSingleTrack = require("../generateSingleTrack.cjs");
+let node_fs_promises = require("node:fs/promises");
 let debug = require("debug");
 debug = require_runtime.__toESM(debug);
 let node_stream = require("node:stream");
-let node_fs_promises = require("node:fs/promises");
+let node_os = require("node:os");
 let node_path = require("node:path");
 //#region src/tasks/generateTrack.ts
+/** Target segment duration for keyframe-aligned WebM. Each cluster in the
+*  output is independently decodable, so the segment carving in
+*  generateWebmSegmentIndex can produce safe byte-range slices. */
+const VP9_ALPHA_SEGMENT_MS = 2e3;
 const generateTrackFromPath = async (absolutePath, trackId) => {
 	const log = (0, debug.default)("ef:generateTrackFragment");
 	log(`Generating track ${trackId} for ${absolutePath}`);
-	if ((await require_Probe.Probe.probePath(absolutePath)).hasAlphaVideo) {
-		log(`VP9 alpha WebM: copying source with Segment size + SeekHead patched`);
-		const buf = await (0, node_fs_promises.readFile)(absolutePath);
-		require_generateWebmSegmentIndex.patchWebmForSegmentedServing(buf);
-		return node_stream.Readable.from(buf);
+	const probe = await require_Probe.Probe.probePath(absolutePath);
+	if (probe.hasAlphaVideo) {
+		log(`VP9 alpha WebM: re-encoding with forced keyframes every ${VP9_ALPHA_SEGMENT_MS}ms`);
+		const tmpDir = await (0, node_fs_promises.mkdtemp)((0, node_path.join)((0, node_os.tmpdir)(), "ef-vp9-alpha-"));
+		const tmpPath = (0, node_path.join)(tmpDir, "track.webm");
+		try {
+			await probe.transcodeWebmKeyframeAligned(tmpPath, VP9_ALPHA_SEGMENT_MS);
+			const buf = await (0, node_fs_promises.readFile)(tmpPath);
+			require_generateWebmSegmentIndex.patchWebmForSegmentedServing(buf);
+			return node_stream.Readable.from(buf);
+		} finally {
+			(0, node_fs_promises.rm)(tmpDir, {
+				recursive: true,
+				force: true
+			}).catch(() => {});
+		}
 	}
 	return (await require_generateSingleTrack.generateSingleTrackFromPath(absolutePath, trackId)).stream;
 };
 const generateTrackTask = require_idempotentTask.idempotentTask({
 	label: "track",
 	filename: (absolutePath, _trackId) => {
-		const ext = absolutePath.endsWith(".webm") ? "webm" : "mp4";
-		return `${(0, node_path.basename)(absolutePath)}.track-1.${ext}`;
+		const lower = absolutePath.toLowerCase();
+		const isWebm = lower.endsWith(".webm") || /[._]webm[._]/.test(lower);
+		return `${(0, node_path.basename)(absolutePath)}.track-1.${isWebm ? "webm" : "mp4"}`;
 	},
 	runner: generateTrackFromPath
 });
@@ -42,5 +59,6 @@ const generateTrack = async (cacheRoot, absolutePath, url) => {
 //#endregion
 exports.generateTrack = generateTrack;
 exports.generateTrackFromPath = generateTrackFromPath;
+exports.generateTrackTask = generateTrackTask;
 
 //# sourceMappingURL=generateTrack.cjs.map

package/dist/tasks/generateTrack.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"generateTrack.cjs","names":["Probe","Readable","generateSingleTrackFromPath","idempotentTask"],"sources":["../../src/tasks/generateTrack.ts"],"mappings":";;;;;;;;;;;AASA,MAAa,wBAAwB,OAAO,cAAsB,YAAoB;CACpF,MAAM,OAAA,GAAA,MAAA,SAAY,2BAA2B;AAC7C,KAAI,oBAAoB,QAAQ,OAAO,eAAe;AAYtD,MAVc,MAAMA,cAAAA,MAAM,UAAU,aAAa,EAUvC,eAAe;AACvB,MAAI,sEAAsE;EAC1E,MAAM,MAAM,OAAA,GAAA,iBAAA,UAAe,aAAa;AACxC,mCAAA,6BAA6B,IAAI;AACjC,SAAOC,YAAAA,SAAS,KAAK,IAAI;;AAI3B,SADe,MAAMC,4BAAAA,4BAA4B,cAAc,QAAQ,EACzD;;AAGhB,MAAa,oBAAoBC,uBAAAA,eAAe;CAC9C,OAAO;CACP,WAAW,cAAsB,aAAqB;EAEpD,MAAM,MAAM,aAAa,SAAS,QAAQ,GAAG,SAAS;AACtD,SAAO,IAAA,GAAA,UAAA,UAAY,aAAa,CAAC,WAAW;;CAE9C,QAAQ;CACT,CAAC;AAEF,MAAa,gBAAgB,OAAO,WAAmB,cAAsB,QAAgB;AAC3F,KAAI;EACF,MAAM,UAAU,IAAI,IAAI,mBAAmB,MAAM,CAAC,aAAa,IAAI,UAAU;AAC7E,MAAI,YAAY,KACd,OAAM,IAAI,MACR,kHACD;AAEH,SAAO,MAAM,kBAAkB,WAAW,cAAc,OAAO,QAAQ,CAAC;UACjE,OAAO;AACd,UAAQ,MAAM,MAAM;AACpB,UAAQ,MAAM,0BAA0B,MAAM;AAC9C,QAAM"}
+{"version":3,"file":"generateTrack.cjs","names":["Probe","Readable","generateSingleTrackFromPath","idempotentTask"],"sources":["../../src/tasks/generateTrack.ts"],"mappings":";;;;;;;;;;;;;;;AAaA,MAAM,uBAAuB;AAE7B,MAAa,wBAAwB,OAAO,cAAsB,YAAoB;CACpF,MAAM,OAAA,GAAA,MAAA,SAAY,2BAA2B;AAC7C,KAAI,oBAAoB,QAAQ,OAAO,eAAe;CAEtD,MAAM,QAAQ,MAAMA,cAAAA,MAAM,UAAU,aAAa;AAYjD,KAAI,MAAM,eAAe;AACvB,MAAI,2DAA2D,qBAAqB,IAAI;EACxF,MAAM,SAAS,OAAA,GAAA,iBAAA,UAAA,GAAA,UAAA,OAAA,GAAA,QAAA,SAA2B,EAAE,gBAAgB,CAAC;EAC7D,MAAM,WAAA,GAAA,UAAA,MAAe,QAAQ,aAAa;AAC1C,MAAI;AACF,SAAM,MAAM,6BAA6B,SAAS,qBAAqB;GACvE,MAAM,MAAM,OAAA,GAAA,iBAAA,UAAe,QAAQ;AACnC,oCAAA,6BAA6B,IAAI;AACjC,UAAOC,YAAAA,SAAS,KAAK,IAAI;YACjB;AACR,IAAA,GAAA,iBAAA,IAAG,QAAQ;IAAE,WAAW;IAAM,OAAO;IAAM,CAAC,CAAC,YAAY,GAAG;;;AAKhE,SADe,MAAMC,4BAAAA,4BAA4B,cAAc,QAAQ,EACzD;;AAGhB,MAAa,oBAAoBC,uBAAAA,eAAe;CAC9C,OAAO;CACP,WAAW,cAAsB,aAAqB;EAKpD,MAAM,QAAQ,aAAa,aAAa;EACxC,MAAM,SAAS,MAAM,SAAS,QAAQ,IAAI,eAAe,KAAK,MAAM;AACpE,SAAO,IAAA,GAAA,UAAA,UAAY,aAAa,CAAC,WAAW,SAAS,SAAS;;CAEhE,QAAQ;CACT,CAAC;AAEF,MAAa,gBAAgB,OAAO,WAAmB,cAAsB,QAAgB;AAC3F,KAAI;EACF,MAAM,UAAU,IAAI,IAAI,mBAAmB,MAAM,CAAC,aAAa,IAAI,UAAU;AAC7E,MAAI,YAAY,KACd,OAAM,IAAI,MACR,kHACD;AAEH,SAAO,MAAM,kBAAkB,WAAW,cAAc,OAAO,QAAQ,CAAC;UACjE,OAAO;AACd,UAAQ,MAAM,MAAM;AACpB,UAAQ,MAAM,0BAA0B,MAAM;AAC9C,QAAM"}

package/dist/tasks/generateTrack.js

@@ -2,27 +2,44 @@ import { Probe } from "../Probe.js";
 import { idempotentTask } from "../idempotentTask.js";
 import { patchWebmForSegmentedServing } from "../generateWebmSegmentIndex.js";
 import { generateSingleTrackFromPath } from "../generateSingleTrack.js";
+import { mkdtemp, readFile, rm } from "node:fs/promises";
 import debug from "debug";
 import { Readable } from "node:stream";
-import { readFile } from "node:fs/promises";
-import { basename } from "node:path";
+import { tmpdir } from "node:os";
+import { basename, join } from "node:path";
 //#region src/tasks/generateTrack.ts
+/** Target segment duration for keyframe-aligned WebM. Each cluster in the
+*  output is independently decodable, so the segment carving in
+*  generateWebmSegmentIndex can produce safe byte-range slices. */
+const VP9_ALPHA_SEGMENT_MS = 2e3;
 const generateTrackFromPath = async (absolutePath, trackId) => {
 	const log = debug("ef:generateTrackFragment");
 	log(`Generating track ${trackId} for ${absolutePath}`);
-	if ((await Probe.probePath(absolutePath)).hasAlphaVideo) {
-		log(`VP9 alpha WebM: copying source with Segment size + SeekHead patched`);
-		const buf = await readFile(absolutePath);
-		patchWebmForSegmentedServing(buf);
-		return Readable.from(buf);
+	const probe = await Probe.probePath(absolutePath);
+	if (probe.hasAlphaVideo) {
+		log(`VP9 alpha WebM: re-encoding with forced keyframes every ${VP9_ALPHA_SEGMENT_MS}ms`);
+		const tmpDir = await mkdtemp(join(tmpdir(), "ef-vp9-alpha-"));
+		const tmpPath = join(tmpDir, "track.webm");
+		try {
+			await probe.transcodeWebmKeyframeAligned(tmpPath, VP9_ALPHA_SEGMENT_MS);
+			const buf = await readFile(tmpPath);
+			patchWebmForSegmentedServing(buf);
+			return Readable.from(buf);
+		} finally {
+			rm(tmpDir, {
+				recursive: true,
+				force: true
+			}).catch(() => {});
+		}
 	}
 	return (await generateSingleTrackFromPath(absolutePath, trackId)).stream;
 };
 const generateTrackTask = idempotentTask({
 	label: "track",
 	filename: (absolutePath, _trackId) => {
-		const ext = absolutePath.endsWith(".webm") ? "webm" : "mp4";
-		return `${basename(absolutePath)}.track-1.${ext}`;
+		const lower = absolutePath.toLowerCase();
+		const isWebm = lower.endsWith(".webm") || /[._]webm[._]/.test(lower);
+		return `${basename(absolutePath)}.track-1.${isWebm ? "webm" : "mp4"}`;
 	},
 	runner: generateTrackFromPath
 });
@@ -38,6 +55,6 @@ const generateTrack = async (cacheRoot, absolutePath, url) => {
 	}
 };
 //#endregion
-export { generateTrack, generateTrackFromPath };
+export { generateTrack, generateTrackFromPath, generateTrackTask };
 
 //# sourceMappingURL=generateTrack.js.map

package/dist/tasks/generateTrack.js.map

@@ -1 +1 @@
-{"version":3,"file":"generateTrack.js","names":[],"sources":["../../src/tasks/generateTrack.ts"],"mappings":";;;;;;;;;AASA,MAAa,wBAAwB,OAAO,cAAsB,YAAoB;CACpF,MAAM,MAAM,MAAM,2BAA2B;AAC7C,KAAI,oBAAoB,QAAQ,OAAO,eAAe;AAYtD,MAVc,MAAM,MAAM,UAAU,aAAa,EAUvC,eAAe;AACvB,MAAI,sEAAsE;EAC1E,MAAM,MAAM,MAAM,SAAS,aAAa;AACxC,+BAA6B,IAAI;AACjC,SAAO,SAAS,KAAK,IAAI;;AAI3B,SADe,MAAM,4BAA4B,cAAc,QAAQ,EACzD;;AAGhB,MAAa,oBAAoB,eAAe;CAC9C,OAAO;CACP,WAAW,cAAsB,aAAqB;EAEpD,MAAM,MAAM,aAAa,SAAS,QAAQ,GAAG,SAAS;AACtD,SAAO,GAAG,SAAS,aAAa,CAAC,WAAW;;CAE9C,QAAQ;CACT,CAAC;AAEF,MAAa,gBAAgB,OAAO,WAAmB,cAAsB,QAAgB;AAC3F,KAAI;EACF,MAAM,UAAU,IAAI,IAAI,mBAAmB,MAAM,CAAC,aAAa,IAAI,UAAU;AAC7E,MAAI,YAAY,KACd,OAAM,IAAI,MACR,kHACD;AAEH,SAAO,MAAM,kBAAkB,WAAW,cAAc,OAAO,QAAQ,CAAC;UACjE,OAAO;AACd,UAAQ,MAAM,MAAM;AACpB,UAAQ,MAAM,0BAA0B,MAAM;AAC9C,QAAM"}
+{"version":3,"file":"generateTrack.js","names":[],"sources":["../../src/tasks/generateTrack.ts"],"mappings":";;;;;;;;;;;;;AAaA,MAAM,uBAAuB;AAE7B,MAAa,wBAAwB,OAAO,cAAsB,YAAoB;CACpF,MAAM,MAAM,MAAM,2BAA2B;AAC7C,KAAI,oBAAoB,QAAQ,OAAO,eAAe;CAEtD,MAAM,QAAQ,MAAM,MAAM,UAAU,aAAa;AAYjD,KAAI,MAAM,eAAe;AACvB,MAAI,2DAA2D,qBAAqB,IAAI;EACxF,MAAM,SAAS,MAAM,QAAQ,KAAK,QAAQ,EAAE,gBAAgB,CAAC;EAC7D,MAAM,UAAU,KAAK,QAAQ,aAAa;AAC1C,MAAI;AACF,SAAM,MAAM,6BAA6B,SAAS,qBAAqB;GACvE,MAAM,MAAM,MAAM,SAAS,QAAQ;AACnC,gCAA6B,IAAI;AACjC,UAAO,SAAS,KAAK,IAAI;YACjB;AACR,MAAG,QAAQ;IAAE,WAAW;IAAM,OAAO;IAAM,CAAC,CAAC,YAAY,GAAG;;;AAKhE,SADe,MAAM,4BAA4B,cAAc,QAAQ,EACzD;;AAGhB,MAAa,oBAAoB,eAAe;CAC9C,OAAO;CACP,WAAW,cAAsB,aAAqB;EAKpD,MAAM,QAAQ,aAAa,aAAa;EACxC,MAAM,SAAS,MAAM,SAAS,QAAQ,IAAI,eAAe,KAAK,MAAM;AACpE,SAAO,GAAG,SAAS,aAAa,CAAC,WAAW,SAAS,SAAS;;CAEhE,QAAQ;CACT,CAAC;AAEF,MAAa,gBAAgB,OAAO,WAAmB,cAAsB,QAAgB;AAC3F,KAAI;EACF,MAAM,UAAU,IAAI,IAAI,mBAAmB,MAAM,CAAC,aAAa,IAAI,UAAU;AAC7E,MAAI,YAAY,KACd,OAAM,IAAI,MACR,kHACD;AAEH,SAAO,MAAM,kBAAkB,WAAW,cAAc,OAAO,QAAQ,CAAC;UACjE,OAAO;AACd,UAAQ,MAAM,MAAM;AACpB,UAAQ,MAAM,0BAA0B,MAAM;AAC9C,QAAM"}

package/dist/tasks/generateTrackFragmentIndex.cjs

@@ -3,37 +3,18 @@ const require_Probe = require("../Probe.cjs");
 const require_generateFragmentIndex = require("../generateFragmentIndex.cjs");
 const require_idempotentTask = require("../idempotentTask.cjs");
 const require_generateWebmSegmentIndex = require("../generateWebmSegmentIndex.cjs");
+const require_generateTrack = require("./generateTrack.cjs");
 let debug = require("debug");
 debug = require_runtime.__toESM(debug);
 let node_path = require("node:path");
 //#region src/tasks/generateTrackFragmentIndex.ts
-const generateTrackFragmentIndexFromPath = async (absolutePath) => {
-	const log = (0, debug.default)("ef:generateTrackFragment");
-	const probe = await require_Probe.Probe.probePath(absolutePath);
+const log = (0, debug.default)("ef:generateTrackFragment");
+/**
+* Build the fragment index for an MP4 source — produces a fragmented MP4
+* stream per track and an MP4 scrub track, indexes each via mp4box.
+*/
+async function generateMp4FragmentIndexFromPath(probe) {
 	const startTimeOffsetMs = probe.startTimeOffsetMs;
-	if (startTimeOffsetMs !== void 0) log(`Extracted start_time offset: ${startTimeOffsetMs}ms`);
-	else log("No format/stream timing offset found - will detect from composition time");
-	if (probe.hasAlphaVideo) {
-		log(`VP9 alpha WebM: using EBML cluster index (no transcoding)`);
-		const webmIndex = await require_generateWebmSegmentIndex.generateWebmSegmentIndex(absolutePath, startTimeOffsetMs);
-		const scrubResult = await (async () => {
-			try {
-				log("Generating VP9 WebM scrub track fragment index for alpha source");
-				const { generateScrubTrackFromPath } = await Promise.resolve().then(() => require("./generateScrubTrack.cjs"));
-				const { fragmentIndex } = await generateScrubTrackFromPath(absolutePath);
-				const result = await fragmentIndex;
-				log("VP9 scrub track fragment index generated successfully");
-				return result;
-			} catch (error) {
-				log(`Failed to generate VP9 scrub track fragment index: ${error}`);
-				return null;
-			}
-		})();
-		const trackFragmentIndexes = { ...webmIndex };
-		if (scrubResult) Object.assign(trackFragmentIndexes, scrubResult);
-		return trackFragmentIndexes;
-	}
-	log(`Generating track fragment index for ${absolutePath} using single-track approach`);
 	const trackTasks = probe.streams.map((stream, streamIndex) => {
 		if (stream.codec_type !== "audio" && stream.codec_type !== "video") return null;
 		const trackId = streamIndex + 1;
@@ -56,17 +37,58 @@ const generateTrackFragmentIndexFromPath = async (absolutePath) => {
 	for (const result of trackResults) Object.assign(trackFragmentIndexes, result);
 	if (scrubResult) Object.assign(trackFragmentIndexes, scrubResult);
 	return trackFragmentIndexes;
+}
+/**
+* Build the fragment index for a VP9-alpha WebM source. The byte ranges
+* reference `cachedTrackPath` — the keyframe-aligned re-encoded WebM that
+* `generateTrackFragmentIndex` materializes upstream. Indexing the original
+* source instead would point to clusters that aren't decodable in isolation.
+*/
+async function generateVp9AlphaFragmentIndexFromPath(probe, cachedTrackPath) {
+	log(`VP9 alpha WebM: building index from re-encoded cache ${cachedTrackPath}`);
+	const webmIndex = await require_generateWebmSegmentIndex.generateWebmSegmentIndex(cachedTrackPath, probe.startTimeOffsetMs);
+	let scrubResult = null;
+	try {
+		log("Generating VP9 WebM scrub track fragment index for alpha source");
+		const { generateScrubTrackFromPath } = await Promise.resolve().then(() => require("./generateScrubTrack.cjs"));
+		const { fragmentIndex } = await generateScrubTrackFromPath(probe.absolutePath);
+		scrubResult = await fragmentIndex;
+		log("VP9 scrub track fragment index generated successfully");
+	} catch (error) {
+		log(`Failed to generate VP9 scrub track fragment index: ${error}`);
+	}
+	const trackFragmentIndexes = { ...webmIndex };
+	if (scrubResult) Object.assign(trackFragmentIndexes, scrubResult);
+	return trackFragmentIndexes;
+}
+/**
+* Public entry — dispatches MP4 vs VP9 alpha based on probe inspection.
+*
+* VP9 alpha sources require `cachedTrackPath` to be the path of the cached
+* keyframe-aligned re-encode. Use `generateTrackFragmentIndex` (the
+* orchestrator below) to materialize that cache automatically.
+*/
+const generateTrackFragmentIndexFromPath = async (absolutePath, cachedTrackPath) => {
+	const probe = await require_Probe.Probe.probePath(absolutePath);
+	if (probe.startTimeOffsetMs !== void 0) log(`Extracted start_time offset: ${probe.startTimeOffsetMs}ms`);
+	if (probe.hasAlphaVideo) {
+		if (!cachedTrackPath) throw new Error("VP9 alpha sources require cachedTrackPath; call generateTrackFragmentIndex (orchestrator) instead.");
+		return generateVp9AlphaFragmentIndexFromPath(probe, cachedTrackPath);
+	}
+	log(`Generating MP4 track fragment index for ${absolutePath}`);
+	return generateMp4FragmentIndexFromPath(probe);
 };
 const generateTrackFragmentIndexTask = require_idempotentTask.idempotentTask({
 	label: "trackFragmentIndex",
-	filename: (absolutePath) => `${(0, node_path.basename)(absolutePath)}.tracks.json`,
-	runner: async (absolutePath) => {
-		const index = await generateTrackFragmentIndexFromPath(absolutePath);
+	filename: (absolutePath, _cachedTrackPath) => `${(0, node_path.basename)(absolutePath)}.tracks.json`,
+	runner: async (absolutePath, cachedTrackPath) => {
+		const index = await generateTrackFragmentIndexFromPath(absolutePath, cachedTrackPath);
 		return JSON.stringify(index, null, 2);
 	}
 });
 const generateTrackFragmentIndex = async (cacheRoot, absolutePath) => {
 	try {
+		if ((await require_Probe.Probe.probePath(absolutePath)).hasAlphaVideo) return await generateTrackFragmentIndexTask(cacheRoot, absolutePath, (await require_generateTrack.generateTrackTask(cacheRoot, absolutePath, 1)).cachePath);
 		return await generateTrackFragmentIndexTask(cacheRoot, absolutePath);
 	} catch (error) {
 		console.trace("Error generating track fragment index", error);

package/dist/tasks/generateTrackFragmentIndex.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"generateTrackFragmentIndex.cjs","names":["Probe","generateWebmSegmentIndex","generateFragmentIndex","idempotentTask"],"sources":["../../src/tasks/generateTrackFragmentIndex.ts"],"mappings":";;;;;;;;;AAQA,MAAa,qCAAqC,OAAO,iBAAyB;CAChF,MAAM,OAAA,GAAA,MAAA,SAAY,2BAA2B;CAC7C,MAAM,QAAQ,MAAMA,cAAAA,MAAM,UAAU,aAAa;CAEjD,MAAM,oBAAoB,MAAM;AAChC,KAAI,sBAAsB,KAAA,EACxB,KAAI,gCAAgC,kBAAkB,IAAI;KAE1D,KAAI,2EAA2E;AAOjF,KAAI,MAAM,eAAe;AACvB,MAAI,4DAA4D;EAChE,MAAM,YAAY,MAAMC,iCAAAA,yBAAyB,cAAc,kBAAkB;EAkBjF,MAAM,cAAc,OAdmD,YAAY;AACjF,OAAI;AACF,QAAI,kEAAkE;IACtE,MAAM,EAAE,+BAA+B,MAAA,QAAA,SAAA,CAAA,WAAA,QAAM,2BAAA,CAAA;IAC7C,MAAM,EAAE,kBAAkB,MAAM,2BAA2B,aAAa;IACxE,MAAM,SAAS,MAAM;AACrB,QAAI,wDAAwD;AAC5D,WAAO;YACA,OAAO;AACd,QAAI,sDAAsD,QAAQ;AAClE,WAAO;;MAEP;EAGJ,MAAM,uBAA2D,EAAE,GAAG,WAAW;AACjF,MAAI,YAAa,QAAO,OAAO,sBAAsB,YAAY;AACjE,SAAO;;AAIT,KAAI,uCAAuC,aAAa,8BAA8B;CAEtF,MAAM,aAAa,MAAM,QACtB,KAAK,QAAQ,gBAAgB;AAC5B,MAAI,OAAO,eAAe,WAAW,OAAO,eAAe,QACzD,QAAO;EAET,MAAM,UAAU,cAAc;AAC9B,MAAI,oBAAoB,QAAQ,IAAI,OAAO,WAAW,GAAG;AAGzD,SAAOC,8BAAAA,sBAFa,MAAM,sBAAsB,YAAY,EAElB,mBADnB,EAAE,GAAG,SAAS,CACuC;GAC5E,CACD,QAAQ,SAA8D,SAAS,KAAK;CAEvF,MAAM,YACJ,MAAM,aAAa,SAAS,KACvB,YAAY;AACX,MAAI;AACF,OAAI,wCAAwC;GAE5C,MAAM,SAAS,MAAMA,8BAAAA,sBADD,MAAM,4BAA4B,EACE,mBAAmB,EAAE,GAAG,IAAI,CAAC;AACrF,OAAI,oDAAoD;AACxD,UAAO;WACA,OAAO;AACd,OAAI,kDAAkD,QAAQ;AAC9D,UAAO;;KAEP,GACJ,QAAQ,QAAQ,KAAK;CAE3B,MAAM,CAAC,cAAc,eAAe,MAAM,QAAQ,IAAI,CAAC,QAAQ,IAAI,WAAW,EAAE,UAAU,CAAC;CAE3F,MAAM,uBAA2D,EAAE;AACnE,MAAK,MAAM,UAAU,aACnB,QAAO,OAAO,sBAAsB,OAAO;AAE7C,KAAI,YACF,QAAO,OAAO,sBAAsB,YAAY;AAGlD,QAAO;;AAGT,MAAM,iCAAiCC,uBAAAA,eAAe;CACpD,OAAO;CACP,WAAW,iBAAiB,IAAA,GAAA,UAAA,UAAY,aAAa,CAAC;CACtD,QAAQ,OAAO,iBAAyB;EACtC,MAAM,QAAQ,MAAM,mCAAmC,aAAa;AACpE,SAAO,KAAK,UAAU,OAAO,MAAM,EAAE;;CAExC,CAAC;AAEF,MAAa,6BAA6B,OAAO,WAAmB,iBAAyB;AAC3F,KAAI;AACF,SAAO,MAAM,+BAA+B,WAAW,aAAa;UAC7D,OAAO;AACd,UAAQ,MAAM,yCAAyC,MAAM;AAC7D,QAAM"}
+{"version":3,"file":"generateTrackFragmentIndex.cjs","names":["generateFragmentIndex","generateWebmSegmentIndex","Probe","idempotentTask","generateTrackTask"],"sources":["../../src/tasks/generateTrackFragmentIndex.ts"],"mappings":";;;;;;;;;;AASA,MAAM,OAAA,GAAA,MAAA,SAAY,2BAA2B;;;;;AAM7C,eAAe,iCACb,OAC6C;CAC7C,MAAM,oBAAoB,MAAM;CAEhC,MAAM,aAAa,MAAM,QACtB,KAAK,QAAQ,gBAAgB;AAC5B,MAAI,OAAO,eAAe,WAAW,OAAO,eAAe,QACzD,QAAO;EAET,MAAM,UAAU,cAAc;AAC9B,MAAI,oBAAoB,QAAQ,IAAI,OAAO,WAAW,GAAG;AAGzD,SAAOA,8BAAAA,sBAFa,MAAM,sBAAsB,YAAY,EAElB,mBADnB,EAAE,GAAG,SAAS,CACuC;GAC5E,CACD,QAAQ,SAA8D,SAAS,KAAK;CAEvF,MAAM,YACJ,MAAM,aAAa,SAAS,KACvB,YAAY;AACX,MAAI;AACF,OAAI,wCAAwC;GAE5C,MAAM,SAAS,MAAMA,8BAAAA,sBADD,MAAM,4BAA4B,EACE,mBAAmB,EAAE,GAAG,IAAI,CAAC;AACrF,OAAI,oDAAoD;AACxD,UAAO;WACA,OAAO;AACd,OAAI,kDAAkD,QAAQ;AAC9D,UAAO;;KAEP,GACJ,QAAQ,QAAQ,KAAK;CAE3B,MAAM,CAAC,cAAc,eAAe,MAAM,QAAQ,IAAI,CAAC,QAAQ,IAAI,WAAW,EAAE,UAAU,CAAC;CAE3F,MAAM,uBAA2D,EAAE;AACnE,MAAK,MAAM,UAAU,aAAc,QAAO,OAAO,sBAAsB,OAAO;AAC9E,KAAI,YAAa,QAAO,OAAO,sBAAsB,YAAY;AACjE,QAAO;;;;;;;;AAST,eAAe,sCACb,OACA,iBAC6C;AAC7C,KAAI,wDAAwD,kBAAkB;CAC9E,MAAM,YAAY,MAAMC,iCAAAA,yBAAyB,iBAAiB,MAAM,kBAAkB;CAI1F,IAAI,cAAyD;AAC7D,KAAI;AACF,MAAI,kEAAkE;EACtE,MAAM,EAAE,+BAA+B,MAAA,QAAA,SAAA,CAAA,WAAA,QAAM,2BAAA,CAAA;EAC7C,MAAM,EAAE,kBAAkB,MAAM,2BAA2B,MAAM,aAAa;AAC9E,gBAAc,MAAM;AACpB,MAAI,wDAAwD;UACrD,OAAO;AACd,MAAI,sDAAsD,QAAQ;;CAGpE,MAAM,uBAA2D,EAAE,GAAG,WAAW;AACjF,KAAI,YAAa,QAAO,OAAO,sBAAsB,YAAY;AACjE,QAAO;;;;;;;;;AAUT,MAAa,qCAAqC,OAChD,cACA,oBACG;CACH,MAAM,QAAQ,MAAMC,cAAAA,MAAM,UAAU,aAAa;AAEjD,KAAI,MAAM,sBAAsB,KAAA,EAC9B,KAAI,gCAAgC,MAAM,kBAAkB,IAAI;AAGlE,KAAI,MAAM,eAAe;AACvB,MAAI,CAAC,gBACH,OAAM,IAAI,MACR,qGACD;AAEH,SAAO,sCAAsC,OAAO,gBAAgB;;AAGtE,KAAI,2CAA2C,eAAe;AAC9D,QAAO,iCAAiC,MAAM;;AAKhD,MAAM,iCAAiCC,uBAAAA,eAAe;CACpD,OAAO;CACP,WAAW,cAAsB,qBAC/B,IAAA,GAAA,UAAA,UAAY,aAAa,CAAC;CAC5B,QAAQ,OAAO,cAAsB,oBAA6B;EAChE,MAAM,QAAQ,MAAM,mCAAmC,cAAc,gBAAgB;AACrF,SAAO,KAAK,UAAU,OAAO,MAAM,EAAE;;CAExC,CAAC;AAEF,MAAa,6BAA6B,OAAO,WAAmB,iBAAyB;AAC3F,KAAI;AAKF,OADc,MAAMD,cAAAA,MAAM,UAAU,aAAa,EACvC,cAER,QAAO,MAAM,+BAA+B,WAAW,eADnC,MAAME,sBAAAA,kBAAkB,WAAW,cAAc,EAAE,EACU,UAAU;AAE7F,SAAO,MAAM,+BAA+B,WAAW,aAAa;UAC7D,OAAO;AACd,UAAQ,MAAM,yCAAyC,MAAM;AAC7D,QAAM"}

package/dist/tasks/generateTrackFragmentIndex.d.cts

@@ -2,7 +2,14 @@ import { TrackFragmentIndex } from "../Probe.cjs";
 import { TaskResult } from "../idempotentTask.cjs";
 
 //#region src/tasks/generateTrackFragmentIndex.d.ts
-declare const generateTrackFragmentIndexFromPath: (absolutePath: string) => Promise<Record<number, TrackFragmentIndex>>;
+/**
+ * Public entry — dispatches MP4 vs VP9 alpha based on probe inspection.
+ *
+ * VP9 alpha sources require `cachedTrackPath` to be the path of the cached
+ * keyframe-aligned re-encode. Use `generateTrackFragmentIndex` (the
+ * orchestrator below) to materialize that cache automatically.
+ */
+declare const generateTrackFragmentIndexFromPath: (absolutePath: string, cachedTrackPath?: string) => Promise<Record<number, TrackFragmentIndex>>;
 declare const generateTrackFragmentIndex: (cacheRoot: string, absolutePath: string) => Promise<TaskResult>;
 //#endregion
 export { generateTrackFragmentIndex, generateTrackFragmentIndexFromPath };

package/dist/tasks/generateTrackFragmentIndex.d.ts

@@ -2,7 +2,14 @@ import { TrackFragmentIndex } from "../Probe.js";
 import { TaskResult } from "../idempotentTask.js";
 
 //#region src/tasks/generateTrackFragmentIndex.d.ts
-declare const generateTrackFragmentIndexFromPath: (absolutePath: string) => Promise<Record<number, TrackFragmentIndex>>;
+/**
+ * Public entry — dispatches MP4 vs VP9 alpha based on probe inspection.
+ *
+ * VP9 alpha sources require `cachedTrackPath` to be the path of the cached
+ * keyframe-aligned re-encode. Use `generateTrackFragmentIndex` (the
+ * orchestrator below) to materialize that cache automatically.
+ */
+declare const generateTrackFragmentIndexFromPath: (absolutePath: string, cachedTrackPath?: string) => Promise<Record<number, TrackFragmentIndex>>;
 declare const generateTrackFragmentIndex: (cacheRoot: string, absolutePath: string) => Promise<TaskResult>;
 //#endregion
 export { generateTrackFragmentIndex, generateTrackFragmentIndexFromPath };

package/dist/tasks/generateTrackFragmentIndex.js

@@ -2,36 +2,17 @@ import { Probe } from "../Probe.js";
 import { generateFragmentIndex } from "../generateFragmentIndex.js";
 import { idempotentTask } from "../idempotentTask.js";
 import { generateWebmSegmentIndex } from "../generateWebmSegmentIndex.js";
+import { generateTrackTask } from "./generateTrack.js";
 import debug from "debug";
 import { basename } from "node:path";
 //#region src/tasks/generateTrackFragmentIndex.ts
-const generateTrackFragmentIndexFromPath = async (absolutePath) => {
-	const log = debug("ef:generateTrackFragment");
-	const probe = await Probe.probePath(absolutePath);
+const log = debug("ef:generateTrackFragment");
+/**
+* Build the fragment index for an MP4 source — produces a fragmented MP4
+* stream per track and an MP4 scrub track, indexes each via mp4box.
+*/
+async function generateMp4FragmentIndexFromPath(probe) {
 	const startTimeOffsetMs = probe.startTimeOffsetMs;
-	if (startTimeOffsetMs !== void 0) log(`Extracted start_time offset: ${startTimeOffsetMs}ms`);
-	else log("No format/stream timing offset found - will detect from composition time");
-	if (probe.hasAlphaVideo) {
-		log(`VP9 alpha WebM: using EBML cluster index (no transcoding)`);
-		const webmIndex = await generateWebmSegmentIndex(absolutePath, startTimeOffsetMs);
-		const scrubResult = await (async () => {
-			try {
-				log("Generating VP9 WebM scrub track fragment index for alpha source");
-				const { generateScrubTrackFromPath } = await import("./generateScrubTrack.js");
-				const { fragmentIndex } = await generateScrubTrackFromPath(absolutePath);
-				const result = await fragmentIndex;
-				log("VP9 scrub track fragment index generated successfully");
-				return result;
-			} catch (error) {
-				log(`Failed to generate VP9 scrub track fragment index: ${error}`);
-				return null;
-			}
-		})();
-		const trackFragmentIndexes = { ...webmIndex };
-		if (scrubResult) Object.assign(trackFragmentIndexes, scrubResult);
-		return trackFragmentIndexes;
-	}
-	log(`Generating track fragment index for ${absolutePath} using single-track approach`);
 	const trackTasks = probe.streams.map((stream, streamIndex) => {
 		if (stream.codec_type !== "audio" && stream.codec_type !== "video") return null;
 		const trackId = streamIndex + 1;
@@ -54,17 +35,58 @@ const generateTrackFragmentIndexFromPath = async (absolutePath) => {
 	for (const result of trackResults) Object.assign(trackFragmentIndexes, result);
 	if (scrubResult) Object.assign(trackFragmentIndexes, scrubResult);
 	return trackFragmentIndexes;
+}
+/**
+* Build the fragment index for a VP9-alpha WebM source. The byte ranges
+* reference `cachedTrackPath` — the keyframe-aligned re-encoded WebM that
+* `generateTrackFragmentIndex` materializes upstream. Indexing the original
+* source instead would point to clusters that aren't decodable in isolation.
+*/
+async function generateVp9AlphaFragmentIndexFromPath(probe, cachedTrackPath) {
+	log(`VP9 alpha WebM: building index from re-encoded cache ${cachedTrackPath}`);
+	const webmIndex = await generateWebmSegmentIndex(cachedTrackPath, probe.startTimeOffsetMs);
+	let scrubResult = null;
+	try {
+		log("Generating VP9 WebM scrub track fragment index for alpha source");
+		const { generateScrubTrackFromPath } = await import("./generateScrubTrack.js");
+		const { fragmentIndex } = await generateScrubTrackFromPath(probe.absolutePath);
+		scrubResult = await fragmentIndex;
+		log("VP9 scrub track fragment index generated successfully");
+	} catch (error) {
+		log(`Failed to generate VP9 scrub track fragment index: ${error}`);
+	}
+	const trackFragmentIndexes = { ...webmIndex };
+	if (scrubResult) Object.assign(trackFragmentIndexes, scrubResult);
+	return trackFragmentIndexes;
+}
+/**
+* Public entry — dispatches MP4 vs VP9 alpha based on probe inspection.
+*
+* VP9 alpha sources require `cachedTrackPath` to be the path of the cached
+* keyframe-aligned re-encode. Use `generateTrackFragmentIndex` (the
+* orchestrator below) to materialize that cache automatically.
+*/
+const generateTrackFragmentIndexFromPath = async (absolutePath, cachedTrackPath) => {
+	const probe = await Probe.probePath(absolutePath);
+	if (probe.startTimeOffsetMs !== void 0) log(`Extracted start_time offset: ${probe.startTimeOffsetMs}ms`);
+	if (probe.hasAlphaVideo) {
+		if (!cachedTrackPath) throw new Error("VP9 alpha sources require cachedTrackPath; call generateTrackFragmentIndex (orchestrator) instead.");
+		return generateVp9AlphaFragmentIndexFromPath(probe, cachedTrackPath);
+	}
+	log(`Generating MP4 track fragment index for ${absolutePath}`);
+	return generateMp4FragmentIndexFromPath(probe);
 };
 const generateTrackFragmentIndexTask = idempotentTask({
 	label: "trackFragmentIndex",
-	filename: (absolutePath) => `${basename(absolutePath)}.tracks.json`,
-	runner: async (absolutePath) => {
-		const index = await generateTrackFragmentIndexFromPath(absolutePath);
+	filename: (absolutePath, _cachedTrackPath) => `${basename(absolutePath)}.tracks.json`,
+	runner: async (absolutePath, cachedTrackPath) => {
+		const index = await generateTrackFragmentIndexFromPath(absolutePath, cachedTrackPath);
 		return JSON.stringify(index, null, 2);
 	}
 });
 const generateTrackFragmentIndex = async (cacheRoot, absolutePath) => {
 	try {
+		if ((await Probe.probePath(absolutePath)).hasAlphaVideo) return await generateTrackFragmentIndexTask(cacheRoot, absolutePath, (await generateTrackTask(cacheRoot, absolutePath, 1)).cachePath);
 		return await generateTrackFragmentIndexTask(cacheRoot, absolutePath);
 	} catch (error) {
 		console.trace("Error generating track fragment index", error);

package/dist/tasks/generateTrackFragmentIndex.js.map

@@ -1 +1 @@
-{"version":3,"file":"generateTrackFragmentIndex.js","names":[],"sources":["../../src/tasks/generateTrackFragmentIndex.ts"],"mappings":";;;;;;;AAQA,MAAa,qCAAqC,OAAO,iBAAyB;CAChF,MAAM,MAAM,MAAM,2BAA2B;CAC7C,MAAM,QAAQ,MAAM,MAAM,UAAU,aAAa;CAEjD,MAAM,oBAAoB,MAAM;AAChC,KAAI,sBAAsB,KAAA,EACxB,KAAI,gCAAgC,kBAAkB,IAAI;KAE1D,KAAI,2EAA2E;AAOjF,KAAI,MAAM,eAAe;AACvB,MAAI,4DAA4D;EAChE,MAAM,YAAY,MAAM,yBAAyB,cAAc,kBAAkB;EAkBjF,MAAM,cAAc,OAdmD,YAAY;AACjF,OAAI;AACF,QAAI,kEAAkE;IACtE,MAAM,EAAE,+BAA+B,MAAM,OAAO;IACpD,MAAM,EAAE,kBAAkB,MAAM,2BAA2B,aAAa;IACxE,MAAM,SAAS,MAAM;AACrB,QAAI,wDAAwD;AAC5D,WAAO;YACA,OAAO;AACd,QAAI,sDAAsD,QAAQ;AAClE,WAAO;;MAEP;EAGJ,MAAM,uBAA2D,EAAE,GAAG,WAAW;AACjF,MAAI,YAAa,QAAO,OAAO,sBAAsB,YAAY;AACjE,SAAO;;AAIT,KAAI,uCAAuC,aAAa,8BAA8B;CAEtF,MAAM,aAAa,MAAM,QACtB,KAAK,QAAQ,gBAAgB;AAC5B,MAAI,OAAO,eAAe,WAAW,OAAO,eAAe,QACzD,QAAO;EAET,MAAM,UAAU,cAAc;AAC9B,MAAI,oBAAoB,QAAQ,IAAI,OAAO,WAAW,GAAG;AAGzD,SAAO,sBAFa,MAAM,sBAAsB,YAAY,EAElB,mBADnB,EAAE,GAAG,SAAS,CACuC;GAC5E,CACD,QAAQ,SAA8D,SAAS,KAAK;CAEvF,MAAM,YACJ,MAAM,aAAa,SAAS,KACvB,YAAY;AACX,MAAI;AACF,OAAI,wCAAwC;GAE5C,MAAM,SAAS,MAAM,sBADD,MAAM,4BAA4B,EACE,mBAAmB,EAAE,GAAG,IAAI,CAAC;AACrF,OAAI,oDAAoD;AACxD,UAAO;WACA,OAAO;AACd,OAAI,kDAAkD,QAAQ;AAC9D,UAAO;;KAEP,GACJ,QAAQ,QAAQ,KAAK;CAE3B,MAAM,CAAC,cAAc,eAAe,MAAM,QAAQ,IAAI,CAAC,QAAQ,IAAI,WAAW,EAAE,UAAU,CAAC;CAE3F,MAAM,uBAA2D,EAAE;AACnE,MAAK,MAAM,UAAU,aACnB,QAAO,OAAO,sBAAsB,OAAO;AAE7C,KAAI,YACF,QAAO,OAAO,sBAAsB,YAAY;AAGlD,QAAO;;AAGT,MAAM,iCAAiC,eAAe;CACpD,OAAO;CACP,WAAW,iBAAiB,GAAG,SAAS,aAAa,CAAC;CACtD,QAAQ,OAAO,iBAAyB;EACtC,MAAM,QAAQ,MAAM,mCAAmC,aAAa;AACpE,SAAO,KAAK,UAAU,OAAO,MAAM,EAAE;;CAExC,CAAC;AAEF,MAAa,6BAA6B,OAAO,WAAmB,iBAAyB;AAC3F,KAAI;AACF,SAAO,MAAM,+BAA+B,WAAW,aAAa;UAC7D,OAAO;AACd,UAAQ,MAAM,yCAAyC,MAAM;AAC7D,QAAM"}
+{"version":3,"file":"generateTrackFragmentIndex.js","names":[],"sources":["../../src/tasks/generateTrackFragmentIndex.ts"],"mappings":";;;;;;;;AASA,MAAM,MAAM,MAAM,2BAA2B;;;;;AAM7C,eAAe,iCACb,OAC6C;CAC7C,MAAM,oBAAoB,MAAM;CAEhC,MAAM,aAAa,MAAM,QACtB,KAAK,QAAQ,gBAAgB;AAC5B,MAAI,OAAO,eAAe,WAAW,OAAO,eAAe,QACzD,QAAO;EAET,MAAM,UAAU,cAAc;AAC9B,MAAI,oBAAoB,QAAQ,IAAI,OAAO,WAAW,GAAG;AAGzD,SAAO,sBAFa,MAAM,sBAAsB,YAAY,EAElB,mBADnB,EAAE,GAAG,SAAS,CACuC;GAC5E,CACD,QAAQ,SAA8D,SAAS,KAAK;CAEvF,MAAM,YACJ,MAAM,aAAa,SAAS,KACvB,YAAY;AACX,MAAI;AACF,OAAI,wCAAwC;GAE5C,MAAM,SAAS,MAAM,sBADD,MAAM,4BAA4B,EACE,mBAAmB,EAAE,GAAG,IAAI,CAAC;AACrF,OAAI,oDAAoD;AACxD,UAAO;WACA,OAAO;AACd,OAAI,kDAAkD,QAAQ;AAC9D,UAAO;;KAEP,GACJ,QAAQ,QAAQ,KAAK;CAE3B,MAAM,CAAC,cAAc,eAAe,MAAM,QAAQ,IAAI,CAAC,QAAQ,IAAI,WAAW,EAAE,UAAU,CAAC;CAE3F,MAAM,uBAA2D,EAAE;AACnE,MAAK,MAAM,UAAU,aAAc,QAAO,OAAO,sBAAsB,OAAO;AAC9E,KAAI,YAAa,QAAO,OAAO,sBAAsB,YAAY;AACjE,QAAO;;;;;;;;AAST,eAAe,sCACb,OACA,iBAC6C;AAC7C,KAAI,wDAAwD,kBAAkB;CAC9E,MAAM,YAAY,MAAM,yBAAyB,iBAAiB,MAAM,kBAAkB;CAI1F,IAAI,cAAyD;AAC7D,KAAI;AACF,MAAI,kEAAkE;EACtE,MAAM,EAAE,+BAA+B,MAAM,OAAO;EACpD,MAAM,EAAE,kBAAkB,MAAM,2BAA2B,MAAM,aAAa;AAC9E,gBAAc,MAAM;AACpB,MAAI,wDAAwD;UACrD,OAAO;AACd,MAAI,sDAAsD,QAAQ;;CAGpE,MAAM,uBAA2D,EAAE,GAAG,WAAW;AACjF,KAAI,YAAa,QAAO,OAAO,sBAAsB,YAAY;AACjE,QAAO;;;;;;;;;AAUT,MAAa,qCAAqC,OAChD,cACA,oBACG;CACH,MAAM,QAAQ,MAAM,MAAM,UAAU,aAAa;AAEjD,KAAI,MAAM,sBAAsB,KAAA,EAC9B,KAAI,gCAAgC,MAAM,kBAAkB,IAAI;AAGlE,KAAI,MAAM,eAAe;AACvB,MAAI,CAAC,gBACH,OAAM,IAAI,MACR,qGACD;AAEH,SAAO,sCAAsC,OAAO,gBAAgB;;AAGtE,KAAI,2CAA2C,eAAe;AAC9D,QAAO,iCAAiC,MAAM;;AAKhD,MAAM,iCAAiC,eAAe;CACpD,OAAO;CACP,WAAW,cAAsB,qBAC/B,GAAG,SAAS,aAAa,CAAC;CAC5B,QAAQ,OAAO,cAAsB,oBAA6B;EAChE,MAAM,QAAQ,MAAM,mCAAmC,cAAc,gBAAgB;AACrF,SAAO,KAAK,UAAU,OAAO,MAAM,EAAE;;CAExC,CAAC;AAEF,MAAa,6BAA6B,OAAO,WAAmB,iBAAyB;AAC3F,KAAI;AAKF,OADc,MAAM,MAAM,UAAU,aAAa,EACvC,cAER,QAAO,MAAM,+BAA+B,WAAW,eADnC,MAAM,kBAAkB,WAAW,cAAc,EAAE,EACU,UAAU;AAE7F,SAAO,MAAM,+BAA+B,WAAW,aAAa;UAC7D,OAAO;AACd,UAAQ,MAAM,yCAAyC,MAAM;AAC7D,QAAM"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@editframe/assets",
-  "version": "0.49.5",
+  "version": "0.49.7",
   "description": "",
   "repository": {
     "type": "git",