@editframe/elements 0.20.4-beta.0 → 0.23.6-beta.0

package/dist/elements/EFMedia/AssetMediaEngine.js

@@ -1,3 +1,4 @@
+import { withSpan } from "../../otel/tracingHelpers.js";
 import { BaseMediaEngine } from "./BaseMediaEngine.js";
 import { convertToScaledTime, roundToMilliseconds } from "./shared/PrecisionUtils.js";
 var AssetMediaEngine = class AssetMediaEngine extends BaseMediaEngine {
@@ -10,10 +11,8 @@ var AssetMediaEngine = class AssetMediaEngine extends BaseMediaEngine {
 	static async fetch(host, urlGenerator, src) {
 		const engine = new AssetMediaEngine(host, src);
 		const url = urlGenerator.generateTrackFragmentIndexUrl(src);
-		const data = await engine.fetchManifest(url);
-		engine.data = data;
-		const longestFragment = Object.values(engine.data).reduce((max, fragment) => Math.max(max, fragment.duration / fragment.timescale), 0);
-		engine.durationMs = longestFragment * 1e3;
+		engine.data = await engine.fetchManifest(url);
+		engine.durationMs = Object.values(engine.data).reduce((max, fragment) => Math.max(max, fragment.duration / fragment.timescale), 0) * 1e3;
 		if (src.startsWith("/")) engine.src = src.slice(1);
 		return engine;
 	}
@@ -25,7 +24,7 @@ var AssetMediaEngine = class AssetMediaEngine extends BaseMediaEngine {
 	}
 	get videoRendition() {
 		const videoTrack = this.videoTrackIndex;
-		if (!videoTrack || videoTrack.track === void 0) return void 0;
+		if (!videoTrack || videoTrack.track === void 0) return;
 		return {
 			trackId: videoTrack.track,
 			src: this.src,
@@ -34,7 +33,7 @@ var AssetMediaEngine = class AssetMediaEngine extends BaseMediaEngine {
 	}
 	get audioRendition() {
 		const audioTrack = this.audioTrackIndex;
-		if (!audioTrack || audioTrack.track === void 0) return void 0;
+		if (!audioTrack || audioTrack.track === void 0) return;
 		return {
 			trackId: audioTrack.track,
 			src: this.src
@@ -67,25 +66,37 @@ var AssetMediaEngine = class AssetMediaEngine extends BaseMediaEngine {
 		return `/@ef-track/${this.src}?trackId=${trackId}&segmentId=${segmentId}`;
 	}
 	async fetchInitSegment(rendition, signal) {
-		if (!rendition.trackId) throw new Error("[fetchInitSegment] Track ID is required for asset metadata");
-		const url = this.buildInitSegmentUrl(rendition.trackId);
-		const initSegment = this.data[rendition.trackId]?.initSegment;
-		if (!initSegment) throw new Error("Init segment not found");
-		const headers = { Range: `bytes=${initSegment.offset}-${initSegment.offset + initSegment.size - 1}` };
-		return this.fetchMediaWithHeaders(url, headers, signal);
+		return withSpan("assetEngine.fetchInitSegment", {
+			trackId: rendition.trackId || -1,
+			src: rendition.src
+		}, void 0, async (span) => {
+			if (!rendition.trackId) throw new Error("[fetchInitSegment] Track ID is required for asset metadata");
+			const url = this.buildInitSegmentUrl(rendition.trackId);
+			const initSegment = this.data[rendition.trackId]?.initSegment;
+			if (!initSegment) throw new Error("Init segment not found");
+			span.setAttribute("offset", initSegment.offset);
+			span.setAttribute("size", initSegment.size);
+			const headers = { Range: `bytes=${initSegment.offset}-${initSegment.offset + initSegment.size - 1}` };
+			return this.fetchMediaWithHeaders(url, headers, signal);
+		});
 	}
 	async fetchMediaSegment(segmentId, rendition, signal) {
-		if (!rendition.trackId) throw new Error("[fetchMediaSegment] Track ID is required for asset metadata");
-		if (segmentId === void 0) throw new Error("Segment ID is not available");
-		const url = this.buildMediaSegmentUrl(rendition.trackId, segmentId);
-		const mediaSegment = this.data[rendition.trackId]?.segments[segmentId];
-		if (!mediaSegment) throw new Error("Media segment not found");
-		const headers = { Range: `bytes=${mediaSegment.offset}-${mediaSegment.offset + mediaSegment.size - 1}` };
-		return this.fetchMediaWithHeaders(url, headers, signal);
-	}
-	/**
-	* Calculate audio segments for variable-duration segments using track fragment index
-	*/
+		return withSpan("assetEngine.fetchMediaSegment", {
+			segmentId,
+			trackId: rendition.trackId || -1,
+			src: rendition.src
+		}, void 0, async (span) => {
+			if (!rendition.trackId) throw new Error("[fetchMediaSegment] Track ID is required for asset metadata");
+			if (segmentId === void 0) throw new Error("Segment ID is not available");
+			const url = this.buildMediaSegmentUrl(rendition.trackId, segmentId);
+			const mediaSegment = this.data[rendition.trackId]?.segments[segmentId];
+			if (!mediaSegment) throw new Error("Media segment not found");
+			span.setAttribute("offset", mediaSegment.offset);
+			span.setAttribute("size", mediaSegment.size);
+			const headers = { Range: `bytes=${mediaSegment.offset}-${mediaSegment.offset + mediaSegment.size - 1}` };
+			return this.fetchMediaWithHeaders(url, headers, signal);
+		});
+	}
 	calculateAudioSegmentRange(fromMs, toMs, rendition, _durationMs) {
 		if (fromMs >= toMs || !rendition.trackId) {
 			console.warn(`calculateAudioSegmentRange: invalid fromMs ${fromMs} toMs ${toMs} rendition ${JSON.stringify(rendition)}`);
@@ -124,9 +135,7 @@ var AssetMediaEngine = class AssetMediaEngine extends BaseMediaEngine {
 		const track = this.data[rendition.trackId];
 		if (!track) throw new Error("Track not found");
 		const { timescale, segments } = track;
-		const startTimeOffsetMs = "startTimeOffsetMs" in rendition && rendition.startTimeOffsetMs || 0;
-		const offsetSeekTimeMs = roundToMilliseconds(seekTimeMs + startTimeOffsetMs);
-		const scaledSeekTime = convertToScaledTime(offsetSeekTimeMs, timescale);
+		const scaledSeekTime = convertToScaledTime(roundToMilliseconds(seekTimeMs + ("startTimeOffsetMs" in rendition && rendition.startTimeOffsetMs || 0)), timescale);
 		for (let i = segments.length - 1; i >= 0; i--) {
 			const segment = segments[i];
 			const segmentEndTime = segment.cts + segment.duration;
@@ -149,13 +158,7 @@ var AssetMediaEngine = class AssetMediaEngine extends BaseMediaEngine {
 		}
 		return nearestSegmentIndex;
 	}
-	getScrubVideoRendition() {
-		return void 0;
-	}
-	/**
-	* Get preferred buffer configuration for this media engine
-	* AssetMediaEngine uses lower buffering since segments are already optimized
-	*/
+	getScrubVideoRendition() {}
 	getBufferConfig() {
 		return {
 			videoBufferDurationMs: 2e3,

package/dist/elements/EFMedia/BaseMediaEngine.js

@@ -1,3 +1,4 @@
+import { withSpan } from "../../otel/tracingHelpers.js";
 import { RequestDeduplicator } from "../../transcoding/cache/RequestDeduplicator.js";
 import { SizeAwareLRUCache } from "../../utils/LRUCache.js";
 const mediaCache = new SizeAwareLRUCache(100 * 1024 * 1024);
@@ -6,60 +7,73 @@ var BaseMediaEngine = class {
 	constructor(host) {
 		this.host = host;
 	}
-	/**
-	* Get video rendition if available. Returns undefined for audio-only assets.
-	* Callers should handle undefined gracefully.
-	*/
 	getVideoRendition() {
 		return this.videoRendition;
 	}
-	/**
-	* Get audio rendition if available. Returns undefined for video-only assets.
-	* Callers should handle undefined gracefully.
-	*/
 	getAudioRendition() {
 		return this.audioRendition;
 	}
-	/**
-	* Generate cache key for segment requests
-	*/
 	getSegmentCacheKey(segmentId, rendition) {
 		return `${rendition.src}-${rendition.id}-${segmentId}-${rendition.trackId}`;
 	}
-	/**
-	* Unified fetch method with caching and global deduplication
-	* All requests (media, manifest, init segments) go through this method
-	*/
 	async fetchWithCache(url, options) {
-		const { responseType, headers, signal } = options;
-		const cacheKey = headers ? `${url}:${JSON.stringify(headers)}` : url;
-		const cached = mediaCache.get(cacheKey);
-		if (cached) {
-			if (signal) return this.handleAbortForCachedRequest(cached, signal);
-			return cached;
-		}
-		const promise = globalRequestDeduplicator.executeRequest(cacheKey, async () => {
-			try {
-				const response = await this.host.fetch(url, { headers });
-				if (responseType === "json") return response.json();
-				return response.arrayBuffer();
-			} catch (error) {
+		return withSpan("mediaEngine.fetchWithCache", {
+			url: url.length > 100 ? `${url.substring(0, 100)}...` : url,
+			responseType: options.responseType,
+			hasHeaders: !!options.headers
+		}, void 0, async (span) => {
+			const t0 = performance.now();
+			const { responseType, headers, signal } = options;
+			const cacheKey = headers ? `${url}:${JSON.stringify(headers)}` : url;
+			const t1 = performance.now();
+			const cached = mediaCache.get(cacheKey);
+			const t2 = performance.now();
+			span.setAttribute("cacheLookupMs", Math.round((t2 - t1) * 1e3) / 1e3);
+			if (cached) {
+				span.setAttribute("cacheHit", true);
+				if (signal) {
+					const t3 = performance.now();
+					const result$1 = await this.handleAbortForCachedRequest(cached, signal);
+					const t4 = performance.now();
+					span.setAttribute("handleAbortMs", Math.round((t4 - t3) * 100) / 100);
+					span.setAttribute("totalCacheHitMs", Math.round((t4 - t0) * 100) / 100);
+					return result$1;
+				}
+				span.setAttribute("totalCacheHitMs", Math.round((t2 - t0) * 100) / 100);
+				return cached;
+			}
+			span.setAttribute("cacheHit", false);
+			const promise = globalRequestDeduplicator.executeRequest(cacheKey, async () => {
+				const fetchStart = performance.now();
+				try {
+					const response = await this.host.fetch(url, { headers });
+					const fetchEnd = performance.now();
+					span.setAttribute("fetchMs", fetchEnd - fetchStart);
+					if (responseType === "json") return response.json();
+					const buffer = await response.arrayBuffer();
+					span.setAttribute("sizeBytes", buffer.byteLength);
+					return buffer;
+				} catch (error) {
+					if (error instanceof DOMException && error.name === "AbortError") mediaCache.delete(cacheKey);
+					throw error;
+				}
+			});
+			mediaCache.set(cacheKey, promise);
+			promise.catch((error) => {
 				if (error instanceof DOMException && error.name === "AbortError") mediaCache.delete(cacheKey);
-				throw error;
+			});
+			if (signal) {
+				const result$1 = await this.handleAbortForCachedRequest(promise, signal);
+				const tEnd$1 = performance.now();
+				span.setAttribute("totalFetchMs", Math.round((tEnd$1 - t0) * 100) / 100);
+				return result$1;
 			}
+			const result = await promise;
+			const tEnd = performance.now();
+			span.setAttribute("totalFetchMs", Math.round((tEnd - t0) * 100) / 100);
+			return result;
 		});
-		mediaCache.set(cacheKey, promise);
-		promise.catch((error) => {
-			if (error instanceof DOMException && error.name === "AbortError") mediaCache.delete(cacheKey);
-		});
-		if (signal) return this.handleAbortForCachedRequest(promise, signal);
-		return promise;
-	}
-	/**
-	* Handles abort logic for a cached request without affecting the underlying fetch
-	* This allows multiple instances to share the same cached request while each
-	* manages their own abort behavior
-	*/
+	}
 	handleAbortForCachedRequest(promise, signal) {
 		if (signal.aborted) throw new DOMException("Aborted", "AbortError");
 		return Promise.race([promise, new Promise((_, reject) => {
@@ -99,39 +113,22 @@ var BaseMediaEngine = class {
 	async fetchMediaCacheWithHeaders(url, headers, signal) {
 		return this.fetchMediaWithHeaders(url, headers, signal);
 	}
-	/**
-	* Fetch media segment with built-in deduplication
-	* Now uses global deduplication for all requests
-	*/
 	async fetchMediaSegmentWithDeduplication(segmentId, rendition, _signal) {
 		const cacheKey = this.getSegmentCacheKey(segmentId, rendition);
 		return globalRequestDeduplicator.executeRequest(cacheKey, async () => {
 			return this.fetchMediaSegment(segmentId, rendition);
 		});
 	}
-	/**
-	* Check if a segment is currently being fetched
-	*/
 	isSegmentBeingFetched(segmentId, rendition) {
 		const cacheKey = this.getSegmentCacheKey(segmentId, rendition);
 		return globalRequestDeduplicator.isPending(cacheKey);
 	}
-	/**
-	* Get count of active segment requests (for debugging/monitoring)
-	*/
 	getActiveSegmentRequestCount() {
 		return globalRequestDeduplicator.getPendingCount();
 	}
-	/**
-	* Cancel all active segment requests (for cleanup)
-	*/
 	cancelAllSegmentRequests() {
 		globalRequestDeduplicator.clear();
 	}
-	/**
-	* Calculate audio segments needed for a time range
-	* Each media engine implements this based on their segment structure
-	*/
 	calculateAudioSegmentRange(fromMs, toMs, rendition, durationMs) {
 		if (fromMs >= toMs) return [];
 		const segments = [];
@@ -169,37 +166,24 @@ var BaseMediaEngine = class {
 		}
 		return segments;
 	}
-	/**
-	* Check if a segment is cached for a given rendition
-	* This needs to check the URL-based cache since that's where segments are actually stored
-	*/
 	isSegmentCached(segmentId, rendition) {
 		try {
 			const maybeJitEngine = this;
 			if (maybeJitEngine.urlGenerator && typeof maybeJitEngine.urlGenerator.generateSegmentUrl === "function") {
 				if (!rendition.id) return false;
 				const segmentUrl = maybeJitEngine.urlGenerator.generateSegmentUrl(segmentId, rendition.id, maybeJitEngine);
-				const urlIsCached = mediaCache.has(segmentUrl);
-				return urlIsCached;
+				return mediaCache.has(segmentUrl);
 			}
 			const cacheKey = `${rendition.src}-${rendition.id || "default"}-${segmentId}-${rendition.trackId}`;
-			const isCached = mediaCache.has(cacheKey);
-			return isCached;
+			return mediaCache.has(cacheKey);
 		} catch (error) {
 			console.warn(`🎬 BaseMediaEngine: Error checking if segment ${segmentId} is cached:`, error);
 			return false;
 		}
 	}
-	/**
-	* Get cached segment IDs from a list for a given rendition
-	*/
 	getCachedSegments(segmentIds, rendition) {
 		return new Set(segmentIds.filter((id) => this.isSegmentCached(id, rendition)));
 	}
-	/**
-	* Extract thumbnail canvases at multiple timestamps efficiently
-	* Default implementation provides helpful error information
-	*/
 	async extractThumbnails(timestamps) {
 		const engineName = this.constructor.name;
 		console.warn(`${engineName}: extractThumbnails not properly implemented. This MediaEngine type does not support thumbnail generation. Supported engines: JitMediaEngine. Requested ${timestamps.length} thumbnail${timestamps.length === 1 ? "" : "s"}.`);

package/dist/elements/EFMedia/BufferedSeekingInput.d.ts

@@ -37,7 +37,7 @@ export declare class BufferedSeekingInput {
     getVideoTrack(trackId: number): Promise<InputVideoTrack>;
     getFirstVideoTrack(): Promise<InputVideoTrack | undefined>;
     getFirstAudioTrack(): Promise<InputAudioTrack | undefined>;
-    getTrackIterator(track: InputTrack): AsyncIterator<MediaSample, any, undefined>;
+    getTrackIterator(track: InputTrack): AsyncIterator<MediaSample, any, any>;
     createTrackSampleSink(track: InputTrack): AudioSampleSink | VideoSampleSink;
     createTrackIterator(track: InputTrack): AsyncGenerator<import('mediabunny').VideoSample, void, unknown> | AsyncGenerator<import('mediabunny').AudioSample, void, unknown>;
     createTrackBuffer(track: InputTrack): SampleBuffer;

package/dist/elements/EFMedia/BufferedSeekingInput.js

@@ -1,7 +1,8 @@
+import { withSpan } from "../../otel/tracingHelpers.js";
 import { roundToMilliseconds } from "./shared/PrecisionUtils.js";
 import { SampleBuffer } from "../SampleBuffer.js";
 import { AudioSampleSink, BufferSource, Input, InputAudioTrack, InputVideoTrack, MP4, VideoSampleSink } from "mediabunny";
-const defaultOptions = {
+var defaultOptions = {
 	videoBufferSize: 30,
 	audioBufferSize: 100,
 	startTimeOffsetMs: 0
@@ -13,12 +14,10 @@ var BufferedSeekingInput = class {
 		this.trackBuffers = /* @__PURE__ */ new Map();
 		this.trackIteratorCreationPromises = /* @__PURE__ */ new Map();
 		this.trackSeekPromises = /* @__PURE__ */ new Map();
-		const bufferSource = new BufferSource(arrayBuffer);
-		const input = new Input({
-			source: bufferSource,
+		this.input = new Input({
+			source: new BufferSource(arrayBuffer),
 			formats: [MP4]
 		});
-		this.input = input;
 		this.options = {
 			...defaultOptions,
 			...options
@@ -34,8 +33,7 @@ var BufferedSeekingInput = class {
 		return buffer ? Object.freeze([...buffer.getContents()]) : [];
 	}
 	getBufferTimestamps(trackId) {
-		const contents = this.getBufferContents(trackId);
-		return contents.map((sample) => sample.timestamp || 0);
+		return this.getBufferContents(trackId).map((sample) => sample.timestamp || 0);
 	}
 	clearBuffer(trackId) {
 		const buffer = this.trackBuffers.get(trackId);
@@ -45,30 +43,25 @@ var BufferedSeekingInput = class {
 		return this.input.computeDuration();
 	}
 	async getTrack(trackId) {
-		const tracks = await this.input.getTracks();
-		const track = tracks.find((track$1) => track$1.id === trackId);
+		const track = (await this.input.getTracks()).find((track$1) => track$1.id === trackId);
 		if (!track) throw new Error(`Track ${trackId} not found`);
 		return track;
 	}
 	async getAudioTrack(trackId) {
-		const tracks = await this.input.getAudioTracks();
-		const track = tracks.find((track$1) => track$1.id === trackId && track$1.type === "audio");
+		const track = (await this.input.getAudioTracks()).find((track$1) => track$1.id === trackId && track$1.type === "audio");
 		if (!track) throw new Error(`Track ${trackId} not found`);
 		return track;
 	}
 	async getVideoTrack(trackId) {
-		const tracks = await this.input.getVideoTracks();
-		const track = tracks.find((track$1) => track$1.id === trackId && track$1.type === "video");
+		const track = (await this.input.getVideoTracks()).find((track$1) => track$1.id === trackId && track$1.type === "video");
 		if (!track) throw new Error(`Track ${trackId} not found`);
 		return track;
 	}
 	async getFirstVideoTrack() {
-		const tracks = await this.input.getVideoTracks();
-		return tracks[0];
+		return (await this.input.getVideoTracks())[0];
 	}
 	async getFirstAudioTrack() {
-		const tracks = await this.input.getAudioTracks();
-		return tracks[0];
+		return (await this.input.getAudioTracks())[0];
 	}
 	getTrackIterator(track) {
 		if (this.trackIterators.has(track.id)) return this.trackIterators.get(track.id);
@@ -82,18 +75,15 @@ var BufferedSeekingInput = class {
 		throw new Error(`Unsupported track type ${track.type}`);
 	}
 	createTrackIterator(track) {
-		const sampleSink = this.createTrackSampleSink(track);
-		return sampleSink.samples();
+		return this.createTrackSampleSink(track).samples();
 	}
 	createTrackBuffer(track) {
 		if (track.type === "audio") {
 			const bufferSize$1 = this.options.audioBufferSize;
-			const sampleBuffer$1 = new SampleBuffer(bufferSize$1);
-			return sampleBuffer$1;
+			return new SampleBuffer(bufferSize$1);
 		}
 		const bufferSize = this.options.videoBufferSize;
-		const sampleBuffer = new SampleBuffer(bufferSize);
-		return sampleBuffer;
+		return new SampleBuffer(bufferSize);
 	}
 	getTrackBuffer(track) {
 		const maybeTrackBuffer = this.trackBuffers.get(track.id);
@@ -103,21 +93,29 @@ var BufferedSeekingInput = class {
 		return trackBuffer;
 	}
 	async seek(trackId, timeMs) {
-		const mediaTimeMs = timeMs + this.startTimeOffsetMs;
-		const roundedMediaTimeMs = roundToMilliseconds(mediaTimeMs);
-		const existingSeek = this.trackSeekPromises.get(trackId);
-		if (existingSeek) await existingSeek;
-		const seekPromise = this.seekSafe(trackId, roundedMediaTimeMs);
-		this.trackSeekPromises.set(trackId, seekPromise);
-		try {
-			return await seekPromise;
-		} finally {
-			this.trackSeekPromises.delete(trackId);
-		}
+		return withSpan("bufferedInput.seek", {
+			trackId,
+			timeMs,
+			startTimeOffsetMs: this.startTimeOffsetMs
+		}, void 0, async (span) => {
+			const roundedMediaTimeMs = roundToMilliseconds(timeMs + this.startTimeOffsetMs);
+			span.setAttribute("roundedMediaTimeMs", roundedMediaTimeMs);
+			const existingSeek = this.trackSeekPromises.get(trackId);
+			if (existingSeek) {
+				span.setAttribute("waitedForExistingSeek", true);
+				await existingSeek;
+			}
+			const seekPromise = this.seekSafe(trackId, roundedMediaTimeMs);
+			this.trackSeekPromises.set(trackId, seekPromise);
+			try {
+				return await seekPromise;
+			} finally {
+				this.trackSeekPromises.delete(trackId);
+			}
+		});
 	}
 	async resetIterator(track) {
-		const trackBuffer = this.trackBuffers.get(track.id);
-		trackBuffer?.clear();
+		this.trackBuffers.get(track.id)?.clear();
 		const ongoingIteratorCreation = this.trackIteratorCreationPromises.get(track.id);
 		if (ongoingIteratorCreation) await ongoingIteratorCreation;
 		const iterator = this.trackIterators.get(track.id);
@@ -128,50 +126,108 @@ var BufferedSeekingInput = class {
 	}
 	#seekLock;
 	async seekSafe(trackId, timeMs) {
-		if (this.#seekLock) await this.#seekLock.promise;
-		const seekLock = Promise.withResolvers();
-		this.#seekLock = seekLock;
-		try {
-			const track = await this.getTrack(trackId);
-			const trackBuffer = this.getTrackBuffer(track);
-			const roundedTimeMs = roundToMilliseconds(timeMs);
-			const firstTimestampMs = roundToMilliseconds(await track.getFirstTimestamp() * 1e3);
-			if (roundedTimeMs < firstTimestampMs) {
-				console.error("Seeking outside bounds of input", {
-					roundedTimeMs,
-					firstTimestampMs
-				});
-				throw new NoSample(`Seeking outside bounds of input ${roundedTimeMs} < ${firstTimestampMs}`);
+		return withSpan("bufferedInput.seekSafe", {
+			trackId,
+			timeMs
+		}, void 0, async (span) => {
+			if (this.#seekLock) {
+				span.setAttribute("waitedForSeekLock", true);
+				await this.#seekLock.promise;
 			}
-			const bufferContents = trackBuffer.getContents();
-			if (bufferContents.length > 0) {
-				const bufferStartMs = roundToMilliseconds(trackBuffer.firstTimestamp * 1e3);
-				if (roundedTimeMs < bufferStartMs) await this.resetIterator(track);
+			const seekLock = Promise.withResolvers();
+			this.#seekLock = seekLock;
+			try {
+				const track = await this.getTrack(trackId);
+				span.setAttribute("trackType", track.type);
+				const trackBuffer = this.getTrackBuffer(track);
+				const roundedTimeMs = roundToMilliseconds(timeMs);
+				const firstTimestampMs = roundToMilliseconds(await track.getFirstTimestamp() * 1e3);
+				span.setAttribute("firstTimestampMs", firstTimestampMs);
+				if (roundedTimeMs < firstTimestampMs) {
+					console.error("Seeking outside bounds of input", {
+						roundedTimeMs,
+						firstTimestampMs
+					});
+					throw new NoSample(`Seeking outside bounds of input ${roundedTimeMs} < ${firstTimestampMs}`);
+				}
+				const bufferContents = trackBuffer.getContents();
+				span.setAttribute("bufferContentsLength", bufferContents.length);
+				if (bufferContents.length > 0) {
+					const bufferStartMs = roundToMilliseconds(trackBuffer.firstTimestamp * 1e3);
+					span.setAttribute("bufferStartMs", bufferStartMs);
+					if (roundedTimeMs < bufferStartMs) {
+						span.setAttribute("resetIterator", true);
+						await this.resetIterator(track);
+					}
+				}
+				const alreadyInBuffer = trackBuffer.find(timeMs);
+				if (alreadyInBuffer) {
+					span.setAttribute("foundInBuffer", true);
+					span.setAttribute("bufferSize", trackBuffer.length);
+					const contents$1 = trackBuffer.getContents();
+					if (contents$1.length > 0) span.setAttribute("bufferTimestamps", contents$1.map((s) => Math.round((s.timestamp || 0) * 1e3)).slice(0, 10).join(","));
+					return alreadyInBuffer;
+				}
+				span.setAttribute("foundInBuffer", false);
+				span.setAttribute("bufferSize", trackBuffer.length);
+				span.setAttribute("requestedTimeMs", Math.round(timeMs));
+				const contents = trackBuffer.getContents();
+				if (contents.length > 0) {
+					const firstSample = contents[0];
+					const lastSample = contents[contents.length - 1];
+					if (firstSample && lastSample) {
+						const bufferStartMs = Math.round((firstSample.timestamp || 0) * 1e3);
+						const bufferEndMs = Math.round(((lastSample.timestamp || 0) + (lastSample.duration || 0)) * 1e3);
+						span.setAttribute("bufferStartMs", bufferStartMs);
+						span.setAttribute("bufferEndMs", bufferEndMs);
+						span.setAttribute("bufferRangeMs", `${bufferStartMs}-${bufferEndMs}`);
+					}
+				}
+				const iterator = this.getTrackIterator(track);
+				let iterationCount = 0;
+				const decodeStart = performance.now();
+				while (true) {
+					iterationCount++;
+					const iterStart = performance.now();
+					const { done, value: decodedSample } = await iterator.next();
+					const iterEnd = performance.now();
+					if (iterationCount <= 5) span.setAttribute(`iter${iterationCount}Ms`, Math.round((iterEnd - iterStart) * 100) / 100);
+					if (decodedSample) {
+						trackBuffer.push(decodedSample);
+						if (iterationCount <= 5) span.setAttribute(`iter${iterationCount}Timestamp`, Math.round((decodedSample.timestamp || 0) * 1e3));
+					}
+					const foundSample = trackBuffer.find(roundedTimeMs);
+					if (foundSample) {
+						const decodeEnd = performance.now();
+						span.setAttribute("iterationCount", iterationCount);
+						span.setAttribute("decodeMs", Math.round((decodeEnd - decodeStart) * 100) / 100);
+						span.setAttribute("avgIterMs", Math.round((decodeEnd - decodeStart) / iterationCount * 100) / 100);
+						span.setAttribute("foundSample", true);
+						span.setAttribute("foundTimestamp", Math.round((foundSample.timestamp || 0) * 1e3));
+						return foundSample;
+					}
+					if (done) break;
+				}
+				span.setAttribute("iterationCount", iterationCount);
+				span.setAttribute("reachedEnd", true);
+				const finalBufferContents = trackBuffer.getContents();
+				if (finalBufferContents.length > 0) {
+					const lastSample = finalBufferContents[finalBufferContents.length - 1];
+					const lastSampleEndMs = roundToMilliseconds(((lastSample?.timestamp || 0) + (lastSample?.duration || 0)) * 1e3);
+					const trackDurationMs = await track.computeDuration() * 1e3;
+					const isSeekingToTrackEnd = roundToMilliseconds(timeMs) === roundToMilliseconds(trackDurationMs);
+					const isAtEndOfTrack = roundToMilliseconds(timeMs) >= lastSampleEndMs;
+					if (isSeekingToTrackEnd && isAtEndOfTrack) {
+						span.setAttribute("returnedLastSample", true);
+						return lastSample;
+					}
+				}
+				throw new NoSample(`Sample not found for time ${timeMs} in ${track.type} track ${trackId}`);
+			} finally {
+				this.#seekLock = void 0;
+				seekLock.resolve();
 			}
-			const alreadyInBuffer = trackBuffer.find(timeMs);
-			if (alreadyInBuffer) return alreadyInBuffer;
-			const iterator = this.getTrackIterator(track);
-			while (true) {
-				const { done, value: decodedSample } = await iterator.next();
-				if (decodedSample) trackBuffer.push(decodedSample);
-				const foundSample = trackBuffer.find(roundedTimeMs);
-				if (foundSample) return foundSample;
-				if (done) break;
-			}
-			const finalBufferContents = trackBuffer.getContents();
-			if (finalBufferContents.length > 0) {
-				const lastSample = finalBufferContents[finalBufferContents.length - 1];
-				const lastSampleEndMs = roundToMilliseconds(((lastSample?.timestamp || 0) + (lastSample?.duration || 0)) * 1e3);
-				const trackDurationMs = await track.computeDuration() * 1e3;
-				const isSeekingToTrackEnd = roundToMilliseconds(timeMs) === roundToMilliseconds(trackDurationMs);
-				const isAtEndOfTrack = roundToMilliseconds(timeMs) >= lastSampleEndMs;
-				if (isSeekingToTrackEnd && isAtEndOfTrack) return lastSample;
-			}
-			throw new NoSample(`Sample not found for time ${timeMs} in ${track.type} track ${trackId}`);
-		} finally {
-			this.#seekLock = void 0;
-			seekLock.resolve();
-		}
+		});
 	}
 };
 export { BufferedSeekingInput };