@editframe/assets 0.30.2-beta.0 → 0.31.0-beta.1

package/dist/index.d.ts

@@ -4,7 +4,8 @@ import { md5Buffer, md5Directory, md5FilePath, md5ReadStream } from "./md5.js";
 import { TaskResult } from "./idempotentTask.js";
 import { generateTrackFragmentIndex, generateTrackFragmentIndexFromPath } from "./tasks/generateTrackFragmentIndex.js";
 import { generateTrack, generateTrackFromPath } from "./tasks/generateTrack.js";
+import { generateScrubTrack, generateScrubTrackFromPath } from "./tasks/generateScrubTrack.js";
 import { findOrCreateCaptions, generateCaptionDataFromPath } from "./tasks/findOrCreateCaptions.js";
 import { cacheImage } from "./tasks/cacheImage.js";
 import { VideoRenderOptions } from "./VideoRenderOptions.js";
-export { type AudioStreamSchema, type AudioTrackFragmentIndex, PacketProbe, type PacketProbeSchema, Probe, type ProbeSchema, type StreamSchema, type TaskResult, type TrackFragmentIndex, type TrackSegment, VideoRenderOptions, type VideoStreamSchema, type VideoTrackFragmentIndex, cacheImage, findOrCreateCaptions, generateCaptionDataFromPath, generateFragmentIndex, generateTrack, generateTrackFragmentIndex, generateTrackFragmentIndexFromPath, generateTrackFromPath, md5Buffer, md5Directory, md5FilePath, md5ReadStream };
+export { type AudioStreamSchema, type AudioTrackFragmentIndex, PacketProbe, type PacketProbeSchema, Probe, type ProbeSchema, type StreamSchema, type TaskResult, type TrackFragmentIndex, type TrackSegment, VideoRenderOptions, type VideoStreamSchema, type VideoTrackFragmentIndex, cacheImage, findOrCreateCaptions, generateCaptionDataFromPath, generateFragmentIndex, generateScrubTrack, generateScrubTrackFromPath, generateTrack, generateTrackFragmentIndex, generateTrackFragmentIndexFromPath, generateTrackFromPath, md5Buffer, md5Directory, md5FilePath, md5ReadStream };

package/dist/index.js

@@ -3,8 +3,9 @@ import { generateFragmentIndex } from "./generateFragmentIndex.js";
 import { md5Buffer, md5Directory, md5FilePath, md5ReadStream } from "./md5.js";
 import { generateTrackFragmentIndex, generateTrackFragmentIndexFromPath } from "./tasks/generateTrackFragmentIndex.js";
 import { generateTrack, generateTrackFromPath } from "./tasks/generateTrack.js";
+import { generateScrubTrack, generateScrubTrackFromPath } from "./tasks/generateScrubTrack.js";
 import { findOrCreateCaptions, generateCaptionDataFromPath } from "./tasks/findOrCreateCaptions.js";
 import { cacheImage } from "./tasks/cacheImage.js";
 import { VideoRenderOptions } from "./VideoRenderOptions.js";
 
-export { PacketProbe, Probe, VideoRenderOptions, cacheImage, findOrCreateCaptions, generateCaptionDataFromPath, generateFragmentIndex, generateTrack, generateTrackFragmentIndex, generateTrackFragmentIndexFromPath, generateTrackFromPath, md5Buffer, md5Directory, md5FilePath, md5ReadStream };
+export { PacketProbe, Probe, VideoRenderOptions, cacheImage, findOrCreateCaptions, generateCaptionDataFromPath, generateFragmentIndex, generateScrubTrack, generateScrubTrackFromPath, generateTrack, generateTrackFragmentIndex, generateTrackFragmentIndexFromPath, generateTrackFromPath, md5Buffer, md5Directory, md5FilePath, md5ReadStream };

package/dist/tasks/generateScrubTrack.d.ts

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

package/dist/tasks/generateScrubTrack.js

@@ -0,0 +1,102 @@
+import { Probe } from "../Probe.js";
+import { generateFragmentIndex } from "../generateFragmentIndex.js";
+import { idempotentTask } from "../idempotentTask.js";
+import debug from "debug";
+import { PassThrough } from "node:stream";
+import { basename } from "node:path";
+
+//#region src/tasks/generateScrubTrack.ts
+const log = debug("ef:generateScrubTrack");
+const generateScrubTrackFromPath = async (absolutePath) => {
+	log(`Generating scrub track for ${absolutePath}`);
+	const probe = await Probe.probePath(absolutePath);
+	if (probe.videoStreams.length === 0) throw new Error("No video stream found for scrub track generation");
+	const scrubStream = probe.createScrubTrackReadstream();
+	let startTimeOffsetMs;
+	if (probe.format.start_time && Number(probe.format.start_time) !== 0) {
+		startTimeOffsetMs = Number(probe.format.start_time) * 1e3;
+		log(`Extracted format start_time offset: ${probe.format.start_time}s (${startTimeOffsetMs}ms)`);
+	} else {
+		const videoStream = probe.videoStreams[0];
+		if (videoStream && videoStream.start_time && Number(videoStream.start_time) !== 0) {
+			startTimeOffsetMs = Number(videoStream.start_time) * 1e3;
+			log(`Extracted video stream start_time offset: ${videoStream.start_time}s (${startTimeOffsetMs}ms)`);
+		}
+	}
+	const outputStream = new PassThrough();
+	const indexStream = new PassThrough();
+	scrubStream.pipe(outputStream, { end: false });
+	scrubStream.pipe(indexStream);
+	let sourceStreamEnded = false;
+	scrubStream.on("end", () => {
+		sourceStreamEnded = true;
+	});
+	scrubStream.on("error", (error) => {
+		outputStream.destroy(error);
+		indexStream.destroy(error);
+	});
+	const scrubTrackId = -1;
+	const fragmentIndexPromise = generateFragmentIndex(indexStream, startTimeOffsetMs, { 1: scrubTrackId });
+	fragmentIndexPromise.then(() => {
+		if (sourceStreamEnded) outputStream.end();
+		else scrubStream.once("end", () => {
+			outputStream.end();
+		});
+	}).catch((error) => {
+		outputStream.destroy(error);
+	});
+	return {
+		stream: outputStream,
+		fragmentIndex: fragmentIndexPromise
+	};
+};
+const generateScrubTrackTask = idempotentTask({
+	label: "scrub-track",
+	filename: (absolutePath) => `${basename(absolutePath)}.scrub-track.mp4`,
+	runner: async (absolutePath) => {
+		const probe = await Probe.probePath(absolutePath);
+		if (probe.videoStreams.length === 0) throw new Error("No video stream found for scrub track generation");
+		const scrubStream = probe.createScrubTrackReadstream();
+		const finalStream = new PassThrough();
+		let progressTimeout = null;
+		const resetProgressTimeout = () => {
+			if (progressTimeout) clearTimeout(progressTimeout);
+			progressTimeout = setTimeout(() => {
+				if (!finalStream.destroyed) {
+					console.warn(`Progress timeout triggered for scrub track - no activity for 30 seconds`);
+					finalStream.destroy(/* @__PURE__ */ new Error("Scrub track generation timeout"));
+				}
+			}, 3e4);
+		};
+		resetProgressTimeout();
+		scrubStream.on("data", () => {
+			resetProgressTimeout();
+		});
+		scrubStream.on("end", () => {
+			resetProgressTimeout();
+			finalStream.end();
+		});
+		scrubStream.on("error", (error) => {
+			if (progressTimeout) clearTimeout(progressTimeout);
+			finalStream.destroy(error);
+		});
+		scrubStream.pipe(finalStream, { end: false });
+		finalStream.on("end", () => {
+			if (progressTimeout) clearTimeout(progressTimeout);
+		});
+		return finalStream;
+	}
+});
+const generateScrubTrack = async (cacheRoot, absolutePath) => {
+	try {
+		return await generateScrubTrackTask(cacheRoot, absolutePath);
+	} catch (error) {
+		console.error(error);
+		console.trace("Error generating scrub track", error);
+		throw error;
+	}
+};
+
+//#endregion
+export { generateScrubTrack, generateScrubTrackFromPath };
+//# sourceMappingURL=generateScrubTrack.js.map

package/dist/tasks/generateScrubTrack.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"generateScrubTrack.js","names":["startTimeOffsetMs: number | undefined","progressTimeout: NodeJS.Timeout | null"],"sources":["../../src/tasks/generateScrubTrack.ts"],"sourcesContent":["import { idempotentTask } from \"../idempotentTask.js\";\nimport debug from \"debug\";\nimport { basename } from \"node:path\";\nimport { PassThrough } from \"node:stream\";\nimport { Probe } from \"../Probe.js\";\nimport { generateFragmentIndex } from \"../generateFragmentIndex.js\";\n\nconst log = debug(\"ef:generateScrubTrack\");\n\nexport const generateScrubTrackFromPath = async (\n  absolutePath: string,\n) => {\n  log(`Generating scrub track for ${absolutePath}`);\n\n  const probe = await Probe.probePath(absolutePath);\n\n  // Check if video stream exists\n  if (probe.videoStreams.length === 0) {\n    throw new Error(\"No video stream found for scrub track generation\");\n  }\n\n  // Get the scrub track stream from FFmpeg (low-res transcoded video)\n  const scrubStream = probe.createScrubTrackReadstream();\n\n  // Extract timing offset from probe metadata (same logic as generateTrackFragmentIndex)\n  let startTimeOffsetMs: number | undefined;\n\n  // First check format-level start_time\n  if (probe.format.start_time && Number(probe.format.start_time) !== 0) {\n    startTimeOffsetMs = Number(probe.format.start_time) * 1000;\n    log(\n      `Extracted format start_time offset: ${probe.format.start_time}s (${startTimeOffsetMs}ms)`,\n    );\n  } else {\n    // Check for video stream start_time (more common)\n    const videoStream = probe.videoStreams[0];\n    if (\n      videoStream &&\n      videoStream.start_time &&\n      Number(videoStream.start_time) !== 0\n    ) {\n      startTimeOffsetMs = Number(videoStream.start_time) * 1000;\n      log(\n        `Extracted video stream start_time offset: ${videoStream.start_time}s (${startTimeOffsetMs}ms)`,\n      );\n    }\n  }\n\n  // Create a PassThrough to tee the stream\n  const outputStream = new PassThrough();\n  const indexStream = new PassThrough();\n\n  // Pipe data but DON'T end outputStream automatically - we'll control this\n  scrubStream.pipe(outputStream, { end: false });\n  scrubStream.pipe(indexStream);\n\n  // Track when the source stream ends (but don't end output yet)\n  let sourceStreamEnded = false;\n  scrubStream.on(\"end\", () => {\n    sourceStreamEnded = true;\n  });\n\n  scrubStream.on(\"error\", (error) => {\n    outputStream.destroy(error);\n    indexStream.destroy(error);\n  });\n\n  // Generate fragment index from the scrub track stream\n  // Use a special track ID to identify scrub track (e.g., -1 or \"scrub\")\n  // We'll use a negative track ID to distinguish from regular tracks\n  const scrubTrackId = -1;\n  const trackIdMapping = { 1: scrubTrackId }; // Single track 1 -> scrub track ID\n\n  const fragmentIndexPromise = generateFragmentIndex(\n    indexStream,\n    startTimeOffsetMs,\n    trackIdMapping,\n  );\n\n  // End outputStream only after BOTH source ends AND fragment index completes\n  fragmentIndexPromise\n    .then(() => {\n      if (sourceStreamEnded) {\n        outputStream.end();\n      } else {\n        // If fragment index completes first, wait for stream to end\n        scrubStream.once(\"end\", () => {\n          outputStream.end();\n        });\n      }\n    })\n    .catch((error) => {\n      outputStream.destroy(error);\n    });\n\n  // Return both the stream and the index\n  return {\n    stream: outputStream,\n    fragmentIndex: fragmentIndexPromise,\n  };\n};\n\nexport const generateScrubTrackTask = idempotentTask({\n  label: \"scrub-track\",\n  filename: (absolutePath: string) =>\n    `${basename(absolutePath)}.scrub-track.mp4`,\n  runner: async (absolutePath: string) => {\n    const probe = await Probe.probePath(absolutePath);\n    \n    if (probe.videoStreams.length === 0) {\n      throw new Error(\"No video stream found for scrub track generation\");\n    }\n\n    // Get the scrub track stream from FFmpeg\n    const scrubStream = probe.createScrubTrackReadstream();\n\n    // Wrap in PassThrough with timeout handling to ensure stream completes\n    const finalStream = new PassThrough();\n\n    // Monitor progress and extend timeout based on actual work\n    let progressTimeout: NodeJS.Timeout | null = null;\n\n    const resetProgressTimeout = () => {\n      if (progressTimeout) {\n        clearTimeout(progressTimeout);\n      }\n\n      progressTimeout = setTimeout(() => {\n        if (!finalStream.destroyed) {\n          console.warn(\n            `Progress timeout triggered for scrub track - no activity for 30 seconds`,\n          );\n          finalStream.destroy(new Error(\"Scrub track generation timeout\"));\n        }\n      }, 30000); // 30 second sliding timeout (longer for transcoding)\n    };\n\n    // Start the initial timeout\n    resetProgressTimeout();\n\n    // Monitor data flow to detect active work\n    scrubStream.on(\"data\", () => {\n      resetProgressTimeout(); // Reset timeout when we see data\n    });\n\n    scrubStream.on(\"end\", () => {\n      resetProgressTimeout(); // Reset timeout when stream ends\n      finalStream.end();\n    });\n\n    scrubStream.on(\"error\", (error) => {\n      if (progressTimeout) {\n        clearTimeout(progressTimeout);\n      }\n      finalStream.destroy(error);\n    });\n\n    // Pipe data through\n    scrubStream.pipe(finalStream, { end: false });\n\n    // Clean up timeout when stream ends\n    finalStream.on(\"end\", () => {\n      if (progressTimeout) {\n        clearTimeout(progressTimeout);\n      }\n    });\n\n    return finalStream;\n  },\n});\n\nexport const generateScrubTrack = async (\n  cacheRoot: string,\n  absolutePath: string,\n) => {\n  try {\n    return await generateScrubTrackTask(cacheRoot, absolutePath);\n  } catch (error) {\n    console.error(error);\n    console.trace(\"Error generating scrub track\", error);\n    throw error;\n  }\n};\n\n"],"mappings":";;;;;;;;AAOA,MAAM,MAAM,MAAM,wBAAwB;AAE1C,MAAa,6BAA6B,OACxC,iBACG;AACH,KAAI,8BAA8B,eAAe;CAEjD,MAAM,QAAQ,MAAM,MAAM,UAAU,aAAa;AAGjD,KAAI,MAAM,aAAa,WAAW,EAChC,OAAM,IAAI,MAAM,mDAAmD;CAIrE,MAAM,cAAc,MAAM,4BAA4B;CAGtD,IAAIA;AAGJ,KAAI,MAAM,OAAO,cAAc,OAAO,MAAM,OAAO,WAAW,KAAK,GAAG;AACpE,sBAAoB,OAAO,MAAM,OAAO,WAAW,GAAG;AACtD,MACE,uCAAuC,MAAM,OAAO,WAAW,KAAK,kBAAkB,KACvF;QACI;EAEL,MAAM,cAAc,MAAM,aAAa;AACvC,MACE,eACA,YAAY,cACZ,OAAO,YAAY,WAAW,KAAK,GACnC;AACA,uBAAoB,OAAO,YAAY,WAAW,GAAG;AACrD,OACE,6CAA6C,YAAY,WAAW,KAAK,kBAAkB,KAC5F;;;CAKL,MAAM,eAAe,IAAI,aAAa;CACtC,MAAM,cAAc,IAAI,aAAa;AAGrC,aAAY,KAAK,cAAc,EAAE,KAAK,OAAO,CAAC;AAC9C,aAAY,KAAK,YAAY;CAG7B,IAAI,oBAAoB;AACxB,aAAY,GAAG,aAAa;AAC1B,sBAAoB;GACpB;AAEF,aAAY,GAAG,UAAU,UAAU;AACjC,eAAa,QAAQ,MAAM;AAC3B,cAAY,QAAQ,MAAM;GAC1B;CAKF,MAAM,eAAe;CAGrB,MAAM,uBAAuB,sBAC3B,aACA,mBAJqB,EAAE,GAAG,cAAc,CAMzC;AAGD,sBACG,WAAW;AACV,MAAI,kBACF,cAAa,KAAK;MAGlB,aAAY,KAAK,aAAa;AAC5B,gBAAa,KAAK;IAClB;GAEJ,CACD,OAAO,UAAU;AAChB,eAAa,QAAQ,MAAM;GAC3B;AAGJ,QAAO;EACL,QAAQ;EACR,eAAe;EAChB;;AAGH,MAAa,yBAAyB,eAAe;CACnD,OAAO;CACP,WAAW,iBACT,GAAG,SAAS,aAAa,CAAC;CAC5B,QAAQ,OAAO,iBAAyB;EACtC,MAAM,QAAQ,MAAM,MAAM,UAAU,aAAa;AAEjD,MAAI,MAAM,aAAa,WAAW,EAChC,OAAM,IAAI,MAAM,mDAAmD;EAIrE,MAAM,cAAc,MAAM,4BAA4B;EAGtD,MAAM,cAAc,IAAI,aAAa;EAGrC,IAAIC,kBAAyC;EAE7C,MAAM,6BAA6B;AACjC,OAAI,gBACF,cAAa,gBAAgB;AAG/B,qBAAkB,iBAAiB;AACjC,QAAI,CAAC,YAAY,WAAW;AAC1B,aAAQ,KACN,0EACD;AACD,iBAAY,wBAAQ,IAAI,MAAM,iCAAiC,CAAC;;MAEjE,IAAM;;AAIX,wBAAsB;AAGtB,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;AAGF,cAAY,KAAK,aAAa,EAAE,KAAK,OAAO,CAAC;AAG7C,cAAY,GAAG,aAAa;AAC1B,OAAI,gBACF,cAAa,gBAAgB;IAE/B;AAEF,SAAO;;CAEV,CAAC;AAEF,MAAa,qBAAqB,OAChC,WACA,iBACG;AACH,KAAI;AACF,SAAO,MAAM,uBAAuB,WAAW,aAAa;UACrD,OAAO;AACd,UAAQ,MAAM,MAAM;AACpB,UAAQ,MAAM,gCAAgC,MAAM;AACpD,QAAM"}

package/dist/tasks/generateTrackFragmentIndex.js

@@ -29,6 +29,18 @@ const generateTrackFragmentIndexFromPath = async (absolutePath) => {
 		const singleTrackIndexes = await generateFragmentIndex(probe.createTrackReadstream(streamIndex), startTimeOffsetMs, { 0: trackId });
 		Object.assign(trackFragmentIndexes, singleTrackIndexes);
 	}
+	if (probe.videoStreams.length > 0) try {
+		log("Generating scrub track fragment index");
+		const scrubStream = probe.createScrubTrackReadstream();
+		const scrubTrackId = -1;
+		const scrubFragmentIndex = await generateFragmentIndex(scrubStream, startTimeOffsetMs, { 0: scrubTrackId });
+		if (scrubFragmentIndex[scrubTrackId]) {
+			trackFragmentIndexes[scrubTrackId] = scrubFragmentIndex[scrubTrackId];
+			log("Scrub track fragment index generated successfully");
+		}
+	} catch (error) {
+		log(`Failed to generate scrub track fragment index: ${error}`);
+	}
 	return trackFragmentIndexes;
 };
 const generateTrackFragmentIndexTask = idempotentTask({

package/dist/tasks/generateTrackFragmentIndex.js.map

@@ -1 +1 @@
-{"version":3,"file":"generateTrackFragmentIndex.js","names":["startTimeOffsetMs: number | undefined","trackFragmentIndexes: Record<number, TrackFragmentIndex>"],"sources":["../../src/tasks/generateTrackFragmentIndex.ts"],"sourcesContent":["import { idempotentTask } from \"../idempotentTask.js\";\nimport debug from \"debug\";\nimport { basename } from \"node:path\";\nimport { Probe } from \"../Probe.js\";\nimport { generateFragmentIndex } from \"../generateFragmentIndex.js\";\nimport type { TrackFragmentIndex } from \"../Probe.js\";\n\nexport const generateTrackFragmentIndexFromPath = async (\n  absolutePath: string,\n) => {\n  const log = debug(\"ef:generateTrackFragment\");\n  const probe = await Probe.probePath(absolutePath);\n\n  // Extract timing offset from probe metadata (same logic as processISOBMFF.ts)\n  let startTimeOffsetMs: number | undefined;\n\n  // First check format-level start_time\n  if (probe.format.start_time && Number(probe.format.start_time) !== 0) {\n    startTimeOffsetMs = Number(probe.format.start_time) * 1000;\n    log(`Extracted format start_time offset: ${probe.format.start_time}s (${startTimeOffsetMs}ms)`);\n  } else {\n    // Check for video stream start_time (more common)\n    const videoStream = probe.streams.find(stream => stream.codec_type === 'video');\n    if (videoStream && videoStream.start_time && Number(videoStream.start_time) !== 0) {\n      startTimeOffsetMs = Number(videoStream.start_time) * 1000;\n      log(`Extracted video stream start_time offset: ${videoStream.start_time}s (${startTimeOffsetMs}ms)`);\n    } else {\n      log(\"No format/stream timing offset found - will detect from composition time\");\n    }\n  }\n\n  log(`Generating track fragment index for ${absolutePath} using single-track approach`);\n\n  // FIXED: Generate fragment indexes from individual single-track files\n  // This ensures byte offsets match the actual single-track files that clients will request\n  const trackFragmentIndexes: Record<number, TrackFragmentIndex> = {};\n\n  // Process each audio/video stream as a separate track\n  for (let streamIndex = 0; streamIndex < probe.streams.length; streamIndex++) {\n    const stream = probe.streams[streamIndex]!;\n\n    // Only process audio and video streams\n    if (stream.codec_type !== 'audio' && stream.codec_type !== 'video') {\n      continue;\n    }\n\n    const trackId = streamIndex + 1; // Convert to 1-based track ID\n    log(`Processing track ${trackId} (${stream.codec_type})`);\n\n    // Generate single-track file and its fragment index\n    const trackStream = probe.createTrackReadstream(streamIndex);\n    const trackIdMapping = { 0: trackId }; // Map single-track stream index 0 to original track ID\n\n    const singleTrackIndexes = await generateFragmentIndex(\n      trackStream,\n      startTimeOffsetMs,\n      trackIdMapping\n    );\n\n    // Merge the single-track index into the combined result\n    Object.assign(trackFragmentIndexes, singleTrackIndexes);\n  }\n\n  return trackFragmentIndexes;\n};\n\nconst generateTrackFragmentIndexTask = idempotentTask({\n  label: \"trackFragmentIndex\",\n  filename: (absolutePath) => `${basename(absolutePath)}.tracks.json`,\n  runner: async (absolutePath: string) => {\n    const index = await generateTrackFragmentIndexFromPath(absolutePath);\n    return JSON.stringify(index, null, 2);\n  },\n});\n\nexport const generateTrackFragmentIndex = async (\n  cacheRoot: string,\n  absolutePath: string,\n) => {\n  try {\n    return await generateTrackFragmentIndexTask(cacheRoot, absolutePath);\n  } catch (error) {\n    console.trace(\"Error generating track fragment index\", error);\n    throw error;\n  }\n};\n"],"mappings":";;;;;;;AAOA,MAAa,qCAAqC,OAChD,iBACG;CACH,MAAM,MAAM,MAAM,2BAA2B;CAC7C,MAAM,QAAQ,MAAM,MAAM,UAAU,aAAa;CAGjD,IAAIA;AAGJ,KAAI,MAAM,OAAO,cAAc,OAAO,MAAM,OAAO,WAAW,KAAK,GAAG;AACpE,sBAAoB,OAAO,MAAM,OAAO,WAAW,GAAG;AACtD,MAAI,uCAAuC,MAAM,OAAO,WAAW,KAAK,kBAAkB,KAAK;QAC1F;EAEL,MAAM,cAAc,MAAM,QAAQ,MAAK,WAAU,OAAO,eAAe,QAAQ;AAC/E,MAAI,eAAe,YAAY,cAAc,OAAO,YAAY,WAAW,KAAK,GAAG;AACjF,uBAAoB,OAAO,YAAY,WAAW,GAAG;AACrD,OAAI,6CAA6C,YAAY,WAAW,KAAK,kBAAkB,KAAK;QAEpG,KAAI,2EAA2E;;AAInF,KAAI,uCAAuC,aAAa,8BAA8B;CAItF,MAAMC,uBAA2D,EAAE;AAGnE,MAAK,IAAI,cAAc,GAAG,cAAc,MAAM,QAAQ,QAAQ,eAAe;EAC3E,MAAM,SAAS,MAAM,QAAQ;AAG7B,MAAI,OAAO,eAAe,WAAW,OAAO,eAAe,QACzD;EAGF,MAAM,UAAU,cAAc;AAC9B,MAAI,oBAAoB,QAAQ,IAAI,OAAO,WAAW,GAAG;EAMzD,MAAM,qBAAqB,MAAM,sBAHb,MAAM,sBAAsB,YAAY,EAK1D,mBAJqB,EAAE,GAAG,SAAS,CAMpC;AAGD,SAAO,OAAO,sBAAsB,mBAAmB;;AAGzD,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,OACxC,WACA,iBACG;AACH,KAAI;AACF,SAAO,MAAM,+BAA+B,WAAW,aAAa;UAC7D,OAAO;AACd,UAAQ,MAAM,yCAAyC,MAAM;AAC7D,QAAM"}
+{"version":3,"file":"generateTrackFragmentIndex.js","names":["startTimeOffsetMs: number | undefined","trackFragmentIndexes: Record<number, TrackFragmentIndex>"],"sources":["../../src/tasks/generateTrackFragmentIndex.ts"],"sourcesContent":["import { idempotentTask } from \"../idempotentTask.js\";\nimport debug from \"debug\";\nimport { basename } from \"node:path\";\nimport { Probe } from \"../Probe.js\";\nimport { generateFragmentIndex } from \"../generateFragmentIndex.js\";\nimport type { TrackFragmentIndex } from \"../Probe.js\";\n\nexport const generateTrackFragmentIndexFromPath = async (\n  absolutePath: string,\n) => {\n  const log = debug(\"ef:generateTrackFragment\");\n  const probe = await Probe.probePath(absolutePath);\n\n  // Extract timing offset from probe metadata (same logic as processISOBMFF.ts)\n  let startTimeOffsetMs: number | undefined;\n\n  // First check format-level start_time\n  if (probe.format.start_time && Number(probe.format.start_time) !== 0) {\n    startTimeOffsetMs = Number(probe.format.start_time) * 1000;\n    log(\n      `Extracted format start_time offset: ${probe.format.start_time}s (${startTimeOffsetMs}ms)`,\n    );\n  } else {\n    // Check for video stream start_time (more common)\n    const videoStream = probe.streams.find(\n      (stream) => stream.codec_type === \"video\",\n    );\n    if (\n      videoStream &&\n      videoStream.start_time &&\n      Number(videoStream.start_time) !== 0\n    ) {\n      startTimeOffsetMs = Number(videoStream.start_time) * 1000;\n      log(\n        `Extracted video stream start_time offset: ${videoStream.start_time}s (${startTimeOffsetMs}ms)`,\n      );\n    } else {\n      log(\n        \"No format/stream timing offset found - will detect from composition time\",\n      );\n    }\n  }\n\n  log(\n    `Generating track fragment index for ${absolutePath} using single-track approach`,\n  );\n\n  // FIXED: Generate fragment indexes from individual single-track files\n  // This ensures byte offsets match the actual single-track files that clients will request\n  const trackFragmentIndexes: Record<number, TrackFragmentIndex> = {};\n\n  // Process each audio/video stream as a separate track\n  for (let streamIndex = 0; streamIndex < probe.streams.length; streamIndex++) {\n    const stream = probe.streams[streamIndex]!;\n\n    // Only process audio and video streams\n    if (stream.codec_type !== \"audio\" && stream.codec_type !== \"video\") {\n      continue;\n    }\n\n    const trackId = streamIndex + 1; // Convert to 1-based track ID\n    log(`Processing track ${trackId} (${stream.codec_type})`);\n\n    // Generate single-track file and its fragment index\n    const trackStream = probe.createTrackReadstream(streamIndex);\n    const trackIdMapping = { 0: trackId }; // Map single-track stream index 0 to original track ID\n\n    const singleTrackIndexes = await generateFragmentIndex(\n      trackStream,\n      startTimeOffsetMs,\n      trackIdMapping,\n    );\n\n    // Merge the single-track index into the combined result\n    Object.assign(trackFragmentIndexes, singleTrackIndexes);\n  }\n\n  // Generate scrub track fragment index if video stream exists\n  if (probe.videoStreams.length > 0) {\n    try {\n      log(\"Generating scrub track fragment index\");\n      // Generate scrub track stream and fragment index directly (don't generate full file)\n      const scrubStream = probe.createScrubTrackReadstream();\n      const scrubTrackId = -1;\n      const trackIdMapping = { 0: scrubTrackId }; // Map single-track stream index 0 to scrub track ID -1\n\n      const scrubFragmentIndex = await generateFragmentIndex(\n        scrubStream,\n        startTimeOffsetMs,\n        trackIdMapping,\n      );\n\n      if (scrubFragmentIndex[scrubTrackId]) {\n        trackFragmentIndexes[scrubTrackId] = scrubFragmentIndex[scrubTrackId]!;\n        log(\"Scrub track fragment index generated successfully\");\n      }\n    } catch (error) {\n      log(`Failed to generate scrub track fragment index: ${error}`);\n      // Don't fail the entire operation if scrub track generation fails\n    }\n  }\n\n  return trackFragmentIndexes;\n};\n\nconst generateTrackFragmentIndexTask = idempotentTask({\n  label: \"trackFragmentIndex\",\n  filename: (absolutePath) => `${basename(absolutePath)}.tracks.json`,\n  runner: async (absolutePath: string) => {\n    const index = await generateTrackFragmentIndexFromPath(absolutePath);\n    return JSON.stringify(index, null, 2);\n  },\n});\n\nexport const generateTrackFragmentIndex = async (\n  cacheRoot: string,\n  absolutePath: string,\n) => {\n  try {\n    return await generateTrackFragmentIndexTask(cacheRoot, absolutePath);\n  } catch (error) {\n    console.trace(\"Error generating track fragment index\", error);\n    throw error;\n  }\n};\n"],"mappings":";;;;;;;AAOA,MAAa,qCAAqC,OAChD,iBACG;CACH,MAAM,MAAM,MAAM,2BAA2B;CAC7C,MAAM,QAAQ,MAAM,MAAM,UAAU,aAAa;CAGjD,IAAIA;AAGJ,KAAI,MAAM,OAAO,cAAc,OAAO,MAAM,OAAO,WAAW,KAAK,GAAG;AACpE,sBAAoB,OAAO,MAAM,OAAO,WAAW,GAAG;AACtD,MACE,uCAAuC,MAAM,OAAO,WAAW,KAAK,kBAAkB,KACvF;QACI;EAEL,MAAM,cAAc,MAAM,QAAQ,MAC/B,WAAW,OAAO,eAAe,QACnC;AACD,MACE,eACA,YAAY,cACZ,OAAO,YAAY,WAAW,KAAK,GACnC;AACA,uBAAoB,OAAO,YAAY,WAAW,GAAG;AACrD,OACE,6CAA6C,YAAY,WAAW,KAAK,kBAAkB,KAC5F;QAED,KACE,2EACD;;AAIL,KACE,uCAAuC,aAAa,8BACrD;CAID,MAAMC,uBAA2D,EAAE;AAGnE,MAAK,IAAI,cAAc,GAAG,cAAc,MAAM,QAAQ,QAAQ,eAAe;EAC3E,MAAM,SAAS,MAAM,QAAQ;AAG7B,MAAI,OAAO,eAAe,WAAW,OAAO,eAAe,QACzD;EAGF,MAAM,UAAU,cAAc;AAC9B,MAAI,oBAAoB,QAAQ,IAAI,OAAO,WAAW,GAAG;EAMzD,MAAM,qBAAqB,MAAM,sBAHb,MAAM,sBAAsB,YAAY,EAK1D,mBAJqB,EAAE,GAAG,SAAS,CAMpC;AAGD,SAAO,OAAO,sBAAsB,mBAAmB;;AAIzD,KAAI,MAAM,aAAa,SAAS,EAC9B,KAAI;AACF,MAAI,wCAAwC;EAE5C,MAAM,cAAc,MAAM,4BAA4B;EACtD,MAAM,eAAe;EAGrB,MAAM,qBAAqB,MAAM,sBAC/B,aACA,mBAJqB,EAAE,GAAG,cAAc,CAMzC;AAED,MAAI,mBAAmB,eAAe;AACpC,wBAAqB,gBAAgB,mBAAmB;AACxD,OAAI,oDAAoD;;UAEnD,OAAO;AACd,MAAI,kDAAkD,QAAQ;;AAKlE,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,OACxC,WACA,iBACG;AACH,KAAI;AACF,SAAO,MAAM,+BAA+B,WAAW,aAAa;UAC7D,OAAO;AACd,UAAQ,MAAM,yCAAyC,MAAM;AAC7D,QAAM"}

package/dist/truncateDecimal.js.map

@@ -1 +1 @@
-{"version":3,"file":"truncateDecimal.js","names":[],"sources":["../src/truncateDecimal.ts"],"sourcesContent":["// Helper to calculate AAC frame-aligned segment durations for audio\nexport function truncateDecimal(num: number, decimals: number) {\n  const factor = 10 ** decimals;\n  return Math.trunc(num * factor) / factor;\n}"],"mappings":";AACA,SAAgB,gBAAgB,KAAa,UAAkB;CAC7D,MAAM,SAAS,MAAM;AACrB,QAAO,KAAK,MAAM,MAAM,OAAO,GAAG"}
+{"version":3,"file":"truncateDecimal.js","names":[],"sources":["../src/truncateDecimal.ts"],"sourcesContent":["// Helper to calculate AAC frame-aligned segment durations for audio\nexport function truncateDecimal(num: number, decimals: number) {\n  const factor = 10 ** decimals;\n  return Math.trunc(num * factor) / factor;\n}\n"],"mappings":";AACA,SAAgB,gBAAgB,KAAa,UAAkB;CAC7D,MAAM,SAAS,MAAM;AACrB,QAAO,KAAK,MAAM,MAAM,OAAO,GAAG"}

package/package.json

@@ -1,13 +1,13 @@
 {
   "name": "@editframe/assets",
-  "version": "0.30.2-beta.0",
+  "version": "0.31.0-beta.1",
   "description": "",
   "type": "module",
   "scripts": {
     "typecheck": "tsc --noEmit --emitDeclarationOnly false",
     "build": "tsdown",
     "build:watch": "tsdown --watch",
-    "typedoc": "typedoc --json ./types.json --plugin typedoc-plugin-zod --excludeExternals ./src && jq -c . ./types.json > ./types.tmp.json && mv ./types.tmp.json ./types.json"
+    "typedoc": "(typedoc --json ./types.json --plugin typedoc-plugin-zod --excludeExternals ./src || true) && ([ -f ./types.json ] && jq -c . ./types.json > ./types.tmp.json && mv ./types.tmp.json ./types.json || true)"
   },
   "author": "",
   "license": "UNLICENSED",

package/tsdown.config.ts

@@ -10,4 +10,3 @@ export default defineConfig(
     },
   }),
 );
-