@videojs/spf 10.0.0-beta.1 → 10.0.0-beta.11

package/dist/default/core/task.js

@@ -0,0 +1,122 @@
+import { generateId } from "./utils/generate-id.js";
+
+//#region src/core/task.ts
+/**
+* Generic reusable task that wraps an async run function.
+*
+* Owns its own AbortController so it can always be aborted independently.
+* Optionally composes an external AbortSignal so that a parent's cancellation
+* propagates into the task's work without requiring the caller to track the
+* task separately.
+*
+* Ordering guarantee: `value` is written before `status` transitions to `'done'`;
+* `error` is written before `status` transitions to `'error'`. Any reader
+* observing `status === 'done'` is guaranteed `value` is already present.
+*/
+var Task = class {
+	id;
+	#runFn;
+	#abortController = new AbortController();
+	#signal;
+	#status = "pending";
+	#value = void 0;
+	#error = void 0;
+	constructor(runFn, config) {
+		this.#runFn = runFn;
+		const rawId = config?.id;
+		this.id = typeof rawId === "function" ? rawId() : rawId ?? generateId();
+		this.#signal = config?.signal ? AbortSignal.any([this.#abortController.signal, config.signal]) : this.#abortController.signal;
+	}
+	get status() {
+		return this.#status;
+	}
+	get value() {
+		return this.#value;
+	}
+	get error() {
+		return this.#error;
+	}
+	async run() {
+		this.#status = "running";
+		try {
+			const result = await this.#runFn(this.#signal);
+			this.#value = result;
+			this.#status = "done";
+			return result;
+		} catch (e) {
+			this.#error = e;
+			this.#status = "error";
+			throw e;
+		}
+	}
+	abort() {
+		this.#abortController.abort();
+	}
+};
+/**
+* Runs tasks concurrently, deduplicated by task id.
+*
+* If a task with a given id is already in flight, subsequent schedule() calls
+* for that id are silently ignored until the first completes. Tasks are stored
+* so abortAll() can cancel any in-flight work (e.g. on engine cleanup).
+*/
+var ConcurrentRunner = class {
+	#pending = /* @__PURE__ */ new Map();
+	schedule(task) {
+		if (this.#pending.has(task.id)) return;
+		this.#pending.set(task.id, task);
+		task.run().catch((error) => {
+			if (!(error instanceof Error && error.name === "AbortError")) throw error;
+		}).finally(() => {
+			this.#pending.delete(task.id);
+		});
+	}
+	abortAll() {
+		for (const task of this.#pending.values()) task.abort();
+		this.#pending.clear();
+	}
+};
+/**
+* Runs tasks one at a time in submission order.
+*
+* Each schedule() call returns a Promise that resolves or rejects with the
+* task's result when it is eventually executed. Tasks wait in queue until the
+* prior task completes.
+*
+* Serialization is achieved by chaining each task's run() onto the tail of a
+* shared promise chain — no explicit queue or drain loop needed.
+*
+* abortAll() aborts all pending (not yet started) tasks and the currently
+* in-flight task. Pending tasks still run briefly but receive an aborted
+* signal and are expected to exit early.
+*/
+var SerialRunner = class {
+	#chain = Promise.resolve();
+	#pending = /* @__PURE__ */ new Set();
+	#current = null;
+	schedule(task) {
+		const t = task;
+		this.#pending.add(t);
+		const result = this.#chain.then(() => {
+			this.#pending.delete(t);
+			this.#current = t;
+			return task.run();
+		}).finally(() => {
+			this.#current = null;
+		});
+		this.#chain = result.then(() => {}, () => {});
+		return result;
+	}
+	abortAll() {
+		for (const task of this.#pending) task.abort();
+		this.#pending.clear();
+		this.#current?.abort();
+	}
+	destroy() {
+		this.abortAll();
+	}
+};
+
+//#endregion
+export { ConcurrentRunner, SerialRunner, Task };
+//# sourceMappingURL=task.js.map

package/dist/default/core/task.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"task.js","names":["#runFn","#abortController","#signal","#status","#value","#error","#pending","#chain","#current"],"sources":["../../../src/core/task.ts"],"sourcesContent":["import { generateId } from './utils/generate-id';\n\n// =============================================================================\n// DeepReadonly\n// =============================================================================\n\n/** Recursively marks all properties as readonly. */\nexport type DeepReadonly<T> = T extends (infer U)[]\n  ? ReadonlyArray<DeepReadonly<U>>\n  : T extends object\n    ? { readonly [K in keyof T]: DeepReadonly<T[K]> }\n    : T;\n\n// =============================================================================\n// Task\n// =============================================================================\n\nexport type TaskStatus = 'pending' | 'running' | 'done' | 'error';\n\n/**\n * Configuration for a Task.\n */\nexport interface TaskConfig {\n  /**\n   * Identifier for this task.\n   * - string: used as-is\n   * - () => string: called once at construction time\n   * - undefined: a unique ID is generated via generateId()\n   */\n  id?: string | (() => string);\n\n  /**\n   * Optional external AbortSignal to compose with the task's internal one.\n   * The task's work is aborted when either the internal controller (via abort())\n   * or this external signal fires — whichever comes first.\n   */\n  signal?: AbortSignal;\n}\n\n/**\n * Minimal contract for a schedulable unit of async work.\n */\nexport interface TaskLike<TValue = void, TError = unknown> {\n  readonly id: string;\n  readonly status: TaskStatus;\n  readonly value: DeepReadonly<TValue> | undefined;\n  readonly error: DeepReadonly<TError> | undefined;\n  run(): Promise<TValue>;\n  abort(): void;\n}\n\n/**\n * Generic reusable task that wraps an async run function.\n *\n * Owns its own AbortController so it can always be aborted independently.\n * Optionally composes an external AbortSignal so that a parent's cancellation\n * propagates into the task's work without requiring the caller to track the\n * task separately.\n *\n * Ordering guarantee: `value` is written before `status` transitions to `'done'`;\n * `error` is written before `status` transitions to `'error'`. Any reader\n * observing `status === 'done'` is guaranteed `value` is already present.\n */\nexport class Task<TValue = void, TError = unknown> implements TaskLike<TValue, TError> {\n  readonly id: string;\n  readonly #runFn: (signal: AbortSignal) => Promise<TValue>;\n  readonly #abortController = new AbortController();\n  readonly #signal: AbortSignal;\n\n  #status: TaskStatus = 'pending';\n  #value: TValue | undefined = undefined;\n  #error: TError | undefined = undefined;\n\n  constructor(runFn: (signal: AbortSignal) => Promise<TValue>, config?: TaskConfig) {\n    this.#runFn = runFn;\n    const rawId = config?.id;\n    this.id = typeof rawId === 'function' ? rawId() : (rawId ?? generateId());\n    this.#signal = config?.signal\n      ? AbortSignal.any([this.#abortController.signal, config.signal])\n      : this.#abortController.signal;\n  }\n\n  get status(): TaskStatus {\n    return this.#status;\n  }\n\n  get value(): DeepReadonly<TValue> | undefined {\n    return this.#value as DeepReadonly<TValue> | undefined;\n  }\n\n  get error(): DeepReadonly<TError> | undefined {\n    return this.#error as DeepReadonly<TError> | undefined;\n  }\n\n  async run(): Promise<TValue> {\n    this.#status = 'running';\n    try {\n      const result = await this.#runFn(this.#signal);\n      this.#value = result; // value before status — ordering guarantee\n      this.#status = 'done';\n      return result;\n    } catch (e) {\n      this.#error = e as TError; // error before status — ordering guarantee\n      this.#status = 'error';\n      throw e;\n    }\n  }\n\n  abort(): void {\n    this.#abortController.abort();\n  }\n}\n\n// =============================================================================\n// ConcurrentRunner\n// =============================================================================\n\n/**\n * Runs tasks concurrently, deduplicated by task id.\n *\n * If a task with a given id is already in flight, subsequent schedule() calls\n * for that id are silently ignored until the first completes. Tasks are stored\n * so abortAll() can cancel any in-flight work (e.g. on engine cleanup).\n */\nexport class ConcurrentRunner {\n  readonly #pending = new Map<string, TaskLike<unknown, unknown>>();\n\n  schedule<TValue = void, TError = unknown>(task: TaskLike<TValue, TError>): void {\n    if (this.#pending.has(task.id)) return;\n\n    this.#pending.set(task.id, task as TaskLike<unknown, unknown>);\n    task\n      .run()\n      .catch((error) => {\n        if (!(error instanceof Error && error.name === 'AbortError')) throw error;\n      })\n      .finally(() => {\n        this.#pending.delete(task.id);\n      });\n  }\n\n  abortAll(): void {\n    for (const task of this.#pending.values()) task.abort();\n    this.#pending.clear();\n  }\n}\n\n// =============================================================================\n// SerialRunner\n// =============================================================================\n\n/**\n * Runs tasks one at a time in submission order.\n *\n * Each schedule() call returns a Promise that resolves or rejects with the\n * task's result when it is eventually executed. Tasks wait in queue until the\n * prior task completes.\n *\n * Serialization is achieved by chaining each task's run() onto the tail of a\n * shared promise chain — no explicit queue or drain loop needed.\n *\n * abortAll() aborts all pending (not yet started) tasks and the currently\n * in-flight task. Pending tasks still run briefly but receive an aborted\n * signal and are expected to exit early.\n */\nexport class SerialRunner {\n  #chain: Promise<unknown> = Promise.resolve();\n  readonly #pending = new Set<TaskLike<unknown, unknown>>();\n  #current: TaskLike<unknown, unknown> | null = null;\n\n  schedule<TValue = void, TError = unknown>(task: TaskLike<TValue, TError>): Promise<TValue> {\n    const t = task as TaskLike<unknown, unknown>;\n    this.#pending.add(t);\n\n    const result = this.#chain\n      .then(() => {\n        this.#pending.delete(t);\n        this.#current = t;\n        return task.run();\n      })\n      .finally(() => {\n        this.#current = null;\n      });\n\n    // Advance the chain regardless of whether this task succeeds or fails.\n    this.#chain = result.then(\n      () => {},\n      () => {}\n    );\n\n    return result as Promise<TValue>;\n  }\n\n  abortAll(): void {\n    for (const task of this.#pending) task.abort();\n    this.#pending.clear();\n    this.#current?.abort();\n  }\n\n  destroy(): void {\n    this.abortAll();\n  }\n}\n"],"mappings":";;;;;;;;;;;;;;;AA+DA,IAAa,OAAb,MAAuF;CACrF,AAAS;CACT,CAASA;CACT,CAASC,kBAAmB,IAAI,iBAAiB;CACjD,CAASC;CAET,UAAsB;CACtB,SAA6B;CAC7B,SAA6B;CAE7B,YAAY,OAAiD,QAAqB;AAChF,QAAKF,QAAS;EACd,MAAM,QAAQ,QAAQ;AACtB,OAAK,KAAK,OAAO,UAAU,aAAa,OAAO,GAAI,SAAS,YAAY;AACxE,QAAKE,SAAU,QAAQ,SACnB,YAAY,IAAI,CAAC,MAAKD,gBAAiB,QAAQ,OAAO,OAAO,CAAC,GAC9D,MAAKA,gBAAiB;;CAG5B,IAAI,SAAqB;AACvB,SAAO,MAAKE;;CAGd,IAAI,QAA0C;AAC5C,SAAO,MAAKC;;CAGd,IAAI,QAA0C;AAC5C,SAAO,MAAKC;;CAGd,MAAM,MAAuB;AAC3B,QAAKF,SAAU;AACf,MAAI;GACF,MAAM,SAAS,MAAM,MAAKH,MAAO,MAAKE,OAAQ;AAC9C,SAAKE,QAAS;AACd,SAAKD,SAAU;AACf,UAAO;WACA,GAAG;AACV,SAAKE,QAAS;AACd,SAAKF,SAAU;AACf,SAAM;;;CAIV,QAAc;AACZ,QAAKF,gBAAiB,OAAO;;;;;;;;;;AAejC,IAAa,mBAAb,MAA8B;CAC5B,CAASK,0BAAW,IAAI,KAAyC;CAEjE,SAA0C,MAAsC;AAC9E,MAAI,MAAKA,QAAS,IAAI,KAAK,GAAG,CAAE;AAEhC,QAAKA,QAAS,IAAI,KAAK,IAAI,KAAmC;AAC9D,OACG,KAAK,CACL,OAAO,UAAU;AAChB,OAAI,EAAE,iBAAiB,SAAS,MAAM,SAAS,cAAe,OAAM;IACpE,CACD,cAAc;AACb,SAAKA,QAAS,OAAO,KAAK,GAAG;IAC7B;;CAGN,WAAiB;AACf,OAAK,MAAM,QAAQ,MAAKA,QAAS,QAAQ,CAAE,MAAK,OAAO;AACvD,QAAKA,QAAS,OAAO;;;;;;;;;;;;;;;;;AAsBzB,IAAa,eAAb,MAA0B;CACxB,SAA2B,QAAQ,SAAS;CAC5C,CAASA,0BAAW,IAAI,KAAiC;CACzD,WAA8C;CAE9C,SAA0C,MAAiD;EACzF,MAAM,IAAI;AACV,QAAKA,QAAS,IAAI,EAAE;EAEpB,MAAM,SAAS,MAAKC,MACjB,WAAW;AACV,SAAKD,QAAS,OAAO,EAAE;AACvB,SAAKE,UAAW;AAChB,UAAO,KAAK,KAAK;IACjB,CACD,cAAc;AACb,SAAKA,UAAW;IAChB;AAGJ,QAAKD,QAAS,OAAO,WACb,UACA,GACP;AAED,SAAO;;CAGT,WAAiB;AACf,OAAK,MAAM,QAAQ,MAAKD,QAAU,MAAK,OAAO;AAC9C,QAAKA,QAAS,OAAO;AACrB,QAAKE,SAAU,OAAO;;CAGxB,UAAgB;AACd,OAAK,UAAU"}

package/dist/default/core/types/index.js

@@ -0,0 +1,15 @@
+//#region src/core/types/index.ts
+function isResolvedTrack(track) {
+	return "segments" in track;
+}
+/**
+* Check if a presentation has duration (at least one track resolved).
+* Narrows type to include required duration.
+*/
+function hasPresentationDuration(presentation) {
+	return presentation.duration !== void 0;
+}
+
+//#endregion
+export { hasPresentationDuration, isResolvedTrack };
+//# sourceMappingURL=index.js.map

package/dist/default/core/types/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","names":[],"sources":["../../../../src/core/types/index.ts"],"sourcesContent":["/**\n * Core SPF Types\n *\n * Based on CMAF-HAM (Common Media Application Format - Hypothetical Application Model)\n * Protocol-agnostic representation of streaming media content.\n *\n * @see https://github.com/AcademySoftwareFoundation/common-media-library\n */\n\n// =============================================================================\n// Base Types\n// =============================================================================\n\n/**\n * Base identifier type for all HAM objects.\n */\nexport interface Ham {\n  id: string;\n}\n\n/**\n * Addressable resource with optional byte range.\n */\nexport interface AddressableObject {\n  url: string;\n  byteRange?: {\n    start: number;\n    end: number;\n  };\n}\n\n// =============================================================================\n// Platform-agnostic Media Element\n// =============================================================================\n\n/**\n * Platform-agnostic media element interface.\n * Captures minimal shape needed for orchestration without DOM dependencies.\n * HTMLMediaElement satisfies this interface.\n */\nexport interface MediaElementLike {\n  preload: string;\n}\n\n// =============================================================================\n// Time and Duration\n// =============================================================================\n\n/**\n * Time span with start time and duration.\n * Used for segments and other timed ranges.\n */\nexport interface TimeSpan {\n  startTime: number;\n  duration: number;\n}\n\n// =============================================================================\n// Enums\n// =============================================================================\n\n/**\n * Track content type.\n */\nexport type TrackType = 'video' | 'audio' | 'text';\n\n// =============================================================================\n// Frame Rate\n// =============================================================================\n\n/**\n * Video frame rate expressed as numerator/denominator.\n *\n * Examples:\n * - 30 fps: { frameRateNumerator: 30 }\n * - 29.97 fps: { frameRateNumerator: 30000, frameRateDenominator: 1001 }\n */\nexport interface FrameRate {\n  frameRateNumerator: number;\n  frameRateDenominator?: number;\n}\n\n// =============================================================================\n// Partially Resolved Tracks (before media playlist is fetched)\n// =============================================================================\n\n/**\n * Generic type for partially resolved tracks.\n * Removes fields that come from media playlist parsing.\n *\n * @param T - Track type to make partially resolved (must extend Track)\n */\nexport type PartiallyResolved<T extends Track = Track> = Omit<T, 'segments' | 'initialization' | keyof TimeSpan> & {\n  segments?: never;\n  duration?: never;\n  startTime?: never;\n  initialization?: never;\n};\n\n/**\n * Partially resolved video track from multivariant playlist.\n * Has metadata but no segments or initialization yet (media playlist not fetched).\n */\nexport type PartiallyResolvedVideoTrack = PartiallyResolved<VideoTrack>;\n\n/**\n * Partially resolved audio track from multivariant playlist.\n * Has metadata but no segments or initialization yet (media playlist not fetched).\n */\nexport type PartiallyResolvedAudioTrack = PartiallyResolved<AudioTrack>;\n\n// =============================================================================\n// Resolved Track Types (with segments from media playlist)\n// =============================================================================\n\n/**\n * Base track type containing common properties for all resolved tracks.\n * A resolved track has segments, duration, and initialization data.\n * All URLs are fully qualified (parsers resolve relative URLs).\n */\n/**\n * Track startTime is always 0 (for future multi-period support).\n */\nexport type Track = Ham &\n  AddressableObject &\n  TimeSpan & {\n    type: TrackType;\n    codecs?: string[]; // Optional per HLS spec\n    mimeType: string;\n    language?: string | undefined;\n    bandwidth: number;\n    initialization?: AddressableObject;\n    segments: Segment[];\n  };\n\n/**\n * Resolved video track with segments.\n */\nexport type VideoTrack = Track &\n  Required<Pick<Track, 'initialization' | 'codecs'>> & {\n    type: 'video';\n\n    // Optional metadata from multivariant (per HLS spec)\n    width?: number;\n    height?: number;\n    frameRate?: FrameRate;\n    audioGroupId?: string;\n  };\n\n/**\n * Resolved audio track with segments.\n */\nexport type AudioTrack = Track &\n  Required<Pick<Track, 'initialization' | 'codecs'>> & {\n    type: 'audio';\n    groupId: string;\n    name: string;\n    sampleRate: number;\n    channels: number;\n    default?: boolean;\n    autoselect?: boolean;\n  };\n\n/**\n * Resolved text track with segments.\n */\nexport type TextTrack = Track & {\n  type: 'text';\n  groupId: string;\n  label: string;\n  kind: 'subtitles' | 'captions';\n  default?: boolean;\n  autoselect?: boolean;\n  forced?: boolean;\n};\n\n/**\n * Partially resolved text track from multivariant playlist.\n * Has metadata but no segments or initialization yet (media playlist not fetched).\n */\nexport type PartiallyResolvedTextTrack = PartiallyResolved<TextTrack>;\n\n/**\n * Unresolved text track (alias for backwards compatibility).\n\n/**\n * Union of all resolved track types.\n */\nexport type ResolvedTrack = VideoTrack | AudioTrack | TextTrack;\n\n/**\n * Union of all partially resolved track types.\n */\nexport type PartiallyResolvedTrack =\n  | PartiallyResolvedVideoTrack\n  | PartiallyResolvedAudioTrack\n  | PartiallyResolvedTextTrack;\n\n/**\n * Union of all unresolved track types (alias for backwards compatibility).\n\n// =============================================================================\n// Switching and Selection Sets\n// =============================================================================\n\n/**\n * Generic switching set type.\n * A group of tracks that can be switched between seamlessly.\n *\n * @param T - Track type (VideoTrack, AudioTrack, or TextTrack)\n */\nexport type SwitchingSetOf<T extends Track = Track> = Ham & {\n  type: T['type'];\n  tracks: (PartiallyResolved<T> | T)[];\n};\n\n/**\n * Video switching set - contains only video tracks (partially resolved or fully resolved).\n */\nexport type VideoSwitchingSet = SwitchingSetOf<VideoTrack>;\n\n/**\n * Audio switching set - contains only audio tracks (partially resolved or fully resolved).\n */\nexport type AudioSwitchingSet = SwitchingSetOf<AudioTrack>;\n\n/**\n * Text switching set - contains only text tracks (partially resolved or fully resolved).\n */\nexport type TextSwitchingSet = SwitchingSetOf<TextTrack>;\n\n/**\n * Switching set - a group of tracks that can be switched between seamlessly.\n * Discriminated by track type.\n */\nexport type SwitchingSet = VideoSwitchingSet | AudioSwitchingSet | TextSwitchingSet;\n\n/**\n * Generic selection set type.\n * Groups switching sets by track type.\n *\n * @param T - Track type (VideoTrack, AudioTrack, or TextTrack)\n */\nexport type SelectionSetOf<T extends Track = Track> = Ham & {\n  type: T['type'];\n  switchingSets: SwitchingSetOf<T>[];\n};\n\n/**\n * Video selection set - contains only video switching sets.\n */\nexport type VideoSelectionSet = SelectionSetOf<VideoTrack>;\n\n/**\n * Audio selection set - contains only audio switching sets.\n */\nexport type AudioSelectionSet = SelectionSetOf<AudioTrack>;\n\n/**\n * Text selection set - contains only text switching sets.\n */\nexport type TextSelectionSet = SelectionSetOf<TextTrack>;\n\n/**\n * Selection set - groups switching sets by track type.\n * Discriminated union ensures type-safe track access.\n */\nexport type SelectionSet = VideoSelectionSet | AudioSelectionSet | TextSelectionSet;\n\n// =============================================================================\n// Segment\n// =============================================================================\n\n/**\n * Media segment with timing information.\n * Follows CMAF-HAM composition pattern.\n */\nexport type Segment = Ham & AddressableObject & TimeSpan;\n\n// =============================================================================\n// Media Playlist Info\n// =============================================================================\n\n/**\n * Intermediate representation of a parsed media playlist.\n * Used internally before assembling into full Track structure.\n */\nexport interface MediaPlaylistInfo {\n  version: number;\n  targetDuration: number;\n  playlistType: 'VOD' | 'EVENT' | undefined;\n  initSegment: AddressableObject | null;\n  segments: Segment[];\n  duration: number;\n  endList: boolean;\n}\n\n// =============================================================================\n// Presentation\n// =============================================================================\n\n/**\n * Presentation - a single playable period of content.\n * Uses TimeSpan fields (startTime always 0, duration optional until track resolved).\n *\n * Extends AddressableObject so `url` contains the original manifest URL.\n * All URLs are fully qualified (parsers resolve relative URLs).\n */\nexport type Presentation = Ham &\n  AddressableObject &\n  Partial<TimeSpan> & {\n    selectionSets: SelectionSet[];\n  };\n\n// =============================================================================\n// Type Guards\n// =============================================================================\n\n/**\n * Check if a track is resolved (has segments).\n * Works for all track types with overloaded signatures for type narrowing.\n */\nexport function isResolvedTrack(track: PartiallyResolvedVideoTrack | VideoTrack): track is VideoTrack;\nexport function isResolvedTrack(track: PartiallyResolvedAudioTrack | AudioTrack): track is AudioTrack;\nexport function isResolvedTrack(track: PartiallyResolvedTextTrack | TextTrack): track is TextTrack;\nexport function isResolvedTrack(track: PartiallyResolvedTrack | ResolvedTrack): track is ResolvedTrack;\nexport function isResolvedTrack(track: PartiallyResolvedTrack | ResolvedTrack): track is ResolvedTrack {\n  return 'segments' in track;\n}\n\n/**\n * Check if a presentation has duration (at least one track resolved).\n * Narrows type to include required duration.\n */\nexport function hasPresentationDuration(\n  presentation: Presentation\n): presentation is Presentation & { duration: number } {\n  return presentation.duration !== undefined;\n}\n"],"mappings":";AAsUA,SAAgB,gBAAgB,OAAuE;AACrG,QAAO,cAAc;;;;;;AAOvB,SAAgB,wBACd,cACqD;AACrD,QAAO,aAAa,aAAa"}

package/dist/default/core/utils/generate-id.js

@@ -0,0 +1,21 @@
+//#region src/core/utils/generate-id.ts
+/**
+* Generate unique ID for HAM objects.
+*
+* Uses timestamp + random number for sufficient uniqueness.
+* IDs are strings without decimals.
+*
+* @returns Unique string ID in format: timestamp-random
+*
+* @example
+* ```ts
+* const id = generateId();  // "1738423156789-542891"
+* ```
+*/
+function generateId() {
+	return `${Date.now()}-${Math.floor(Math.random() * 1e6)}`;
+}
+
+//#endregion
+export { generateId };
+//# sourceMappingURL=generate-id.js.map

package/dist/default/core/utils/generate-id.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"generate-id.js","names":[],"sources":["../../../../src/core/utils/generate-id.ts"],"sourcesContent":["/**\n * Generate unique ID for HAM objects.\n *\n * Uses timestamp + random number for sufficient uniqueness.\n * IDs are strings without decimals.\n *\n * @returns Unique string ID in format: timestamp-random\n *\n * @example\n * ```ts\n * const id = generateId();  // \"1738423156789-542891\"\n * ```\n */\nexport function generateId(): string {\n  return `${Date.now()}-${Math.floor(Math.random() * 1000000)}`;\n}\n"],"mappings":";;;;;;;;;;;;;;AAaA,SAAgB,aAAqB;AACnC,QAAO,GAAG,KAAK,KAAK,CAAC,GAAG,KAAK,MAAM,KAAK,QAAQ,GAAG,IAAQ"}

package/dist/default/core/utils/track-selection.js

@@ -0,0 +1,31 @@
+//#region src/core/utils/track-selection.ts
+/**
+* Map track type to selected track ID property key in state.
+*/
+const SelectedTrackIdKeyByType = {
+	video: "selectedVideoTrackId",
+	audio: "selectedAudioTrackId",
+	text: "selectedTextTrackId"
+};
+/**
+* Get selected track from state by type.
+* Returns properly typed track (partially or fully resolved) or undefined.
+* Type parameter T is inferred from the type argument.
+*
+* @example
+* const videoTrack = getSelectedTrack(state, 'video');
+* if (videoTrack && isResolvedTrack(videoTrack)) {
+*   // videoTrack is VideoTrack
+* }
+*/
+function getSelectedTrack(state, type) {
+	const { presentation } = state;
+	/** @TODO Consider moving and reusing isUnresolved(presentation) (CJP) */
+	if (!presentation || !("id" in presentation)) return void 0;
+	const trackId = state[SelectedTrackIdKeyByType[type]];
+	return presentation.selectionSets.find(({ type: selectionSetType }) => selectionSetType === type)?.switchingSets[0]?.tracks.find(({ id }) => id === trackId);
+}
+
+//#endregion
+export { SelectedTrackIdKeyByType, getSelectedTrack };
+//# sourceMappingURL=track-selection.js.map

package/dist/default/core/utils/track-selection.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"track-selection.js","names":[],"sources":["../../../../src/core/utils/track-selection.ts"],"sourcesContent":["import type {\n  AddressableObject,\n  AudioTrack,\n  PartiallyResolvedAudioTrack,\n  PartiallyResolvedTextTrack,\n  PartiallyResolvedVideoTrack,\n  Presentation,\n  TextTrack,\n  TrackType,\n  VideoTrack,\n} from '../types';\n\n/**\n * State shape for track selection.\n * Minimal shape containing presentation and selected track IDs.\n */\nexport interface TrackSelectionState {\n  presentation?: AddressableObject | Presentation | undefined;\n  selectedVideoTrackId?: string | undefined;\n  selectedAudioTrackId?: string | undefined;\n  selectedTextTrackId?: string | undefined;\n}\n\n/**\n * Map track type to selected track ID property key in state.\n */\nexport const SelectedTrackIdKeyByType = {\n  video: 'selectedVideoTrackId',\n  audio: 'selectedAudioTrackId',\n  text: 'selectedTextTrackId',\n} as const;\n\n/**\n * Map track type to buffer owner property key.\n * Used for SourceBuffer references in owners.\n */\nexport const BufferKeyByType = {\n  video: 'videoBuffer',\n  audio: 'audioBuffer',\n} as const;\n\n/**\n * Get selected track from state by type.\n * Returns properly typed track (partially or fully resolved) or undefined.\n * Type parameter T is inferred from the type argument.\n *\n * @example\n * const videoTrack = getSelectedTrack(state, 'video');\n * if (videoTrack && isResolvedTrack(videoTrack)) {\n *   // videoTrack is VideoTrack\n * }\n */\nexport function getSelectedTrack<T extends TrackType>(\n  state: TrackSelectionState,\n  type: T\n): T extends 'video'\n  ? PartiallyResolvedVideoTrack | VideoTrack | undefined\n  : T extends 'audio'\n    ? PartiallyResolvedAudioTrack | AudioTrack | undefined\n    : T extends 'text'\n      ? PartiallyResolvedTextTrack | TextTrack | undefined\n      : never {\n  const { presentation } = state;\n\n  /** @TODO Consider moving and reusing isUnresolved(presentation) (CJP) */\n  if (!presentation || !('id' in presentation)) return undefined as any;\n\n  // Get track ID based on type\n  const trackIdKey = SelectedTrackIdKeyByType[type];\n  const trackId = state[trackIdKey];\n  return presentation.selectionSets\n    .find(({ type: selectionSetType }) => selectionSetType === type)\n    ?.switchingSets[0]?.tracks.find(({ id }) => id === trackId) as any;\n}\n"],"mappings":";;;;AA0BA,MAAa,2BAA2B;CACtC,OAAO;CACP,OAAO;CACP,MAAM;CACP;;;;;;;;;;;;AAsBD,SAAgB,iBACd,OACA,MAOY;CACZ,MAAM,EAAE,iBAAiB;;AAGzB,KAAI,CAAC,gBAAgB,EAAE,QAAQ,cAAe,QAAO;CAIrD,MAAM,UAAU,MADG,yBAAyB;AAE5C,QAAO,aAAa,cACjB,MAAM,EAAE,MAAM,uBAAuB,qBAAqB,KAAK,EAC9D,cAAc,IAAI,OAAO,MAAM,EAAE,SAAS,OAAO,QAAQ"}

package/dist/default/dom/features/end-of-stream.js

@@ -0,0 +1,169 @@
+import { isResolvedTrack } from "../../core/types/index.js";
+import { combineLatest } from "../../core/reactive/combine-latest.js";
+import { getSelectedTrack } from "../../core/utils/track-selection.js";
+
+//#region src/dom/features/end-of-stream.ts
+/**
+* Check if the last segment of a track has been appended to a SourceBuffer.
+*
+* Checks by segment ID rather than a pipeline flag, so it is robust across
+* quality switches (different tracks have different segment IDs) and
+* back-buffer flushes (flushed segment IDs are removed from the model).
+*/
+function isLastSegmentAppended(segments, actor) {
+	if (segments.length === 0) return true;
+	const lastSeg = segments[segments.length - 1];
+	if (!lastSeg) return false;
+	return actor?.snapshot.context.segments.some((s) => s.id === lastSeg.id && !s.partial) ?? false;
+}
+/**
+* Check if the last segment has been appended for each selected track.
+*
+* Handles video-only, audio-only, and video+audio scenarios.
+* A track with no segments (e.g. unresolved) is considered not ready.
+*/
+function hasLastSegmentLoaded(state, owners) {
+	const videoTrack = state.selectedVideoTrackId ? getSelectedTrack(state, "video") : void 0;
+	const audioTrack = state.selectedAudioTrackId ? getSelectedTrack(state, "audio") : void 0;
+	if (videoTrack && !isResolvedTrack(videoTrack)) return false;
+	if (audioTrack && !isResolvedTrack(audioTrack)) return false;
+	if (videoTrack && isResolvedTrack(videoTrack)) {
+		if (!isLastSegmentAppended(videoTrack.segments, owners.videoBufferActor)) return false;
+	}
+	if (audioTrack && isResolvedTrack(audioTrack)) {
+		if (!isLastSegmentAppended(audioTrack.segments, owners.audioBufferActor)) return false;
+	}
+	return true;
+}
+/**
+* Check if we can call endOfStream.
+*/
+function canEndStream(state, owners) {
+	return !!(owners.mediaSource && state.presentation);
+}
+/**
+* Check if we should call endOfStream.
+*/
+function shouldEndStream(state, owners) {
+	if (!canEndStream(state, owners)) return false;
+	const { mediaSource, mediaElement } = owners;
+	if (mediaSource.readyState !== "open") return false;
+	if (mediaElement && mediaElement.readyState < HTMLMediaElement.HAVE_METADATA) return false;
+	const hasVideoTrack = !!state.selectedVideoTrackId;
+	const hasAudioTrack = !!state.selectedAudioTrackId;
+	if (hasVideoTrack && !owners.videoBuffer) return false;
+	if (hasAudioTrack && !owners.audioBuffer) return false;
+	if (owners.videoBufferActor?.snapshot.status === "updating") return false;
+	if (owners.audioBufferActor?.snapshot.status === "updating") return false;
+	if (!hasLastSegmentLoaded(state, owners)) return false;
+	if (mediaElement) {
+		const videoTrack = hasVideoTrack ? getSelectedTrack(state, "video") : void 0;
+		const audioTrack = hasAudioTrack ? getSelectedTrack(state, "audio") : void 0;
+		const refTrack = videoTrack && isResolvedTrack(videoTrack) ? videoTrack : audioTrack && isResolvedTrack(audioTrack) ? audioTrack : void 0;
+		if (refTrack && refTrack.segments.length > 0) {
+			const lastSeg = refTrack.segments[refTrack.segments.length - 1];
+			if (mediaElement.currentTime < lastSeg.startTime) return false;
+		}
+	}
+	return true;
+}
+/**
+* Wait for all currently-updating SourceBufferActors to finish.
+* Uses actor status rather than raw SourceBuffer.updating so the wait is
+* aligned with the same abstraction that owns all buffer operations.
+*/
+function waitForSourceBuffersReady(owners) {
+	const updatingActors = [owners.videoBufferActor, owners.audioBufferActor].filter((actor) => actor !== void 0 && actor.snapshot.status === "updating");
+	if (updatingActors.length === 0) return Promise.resolve();
+	return Promise.all(updatingActors.map((actor) => new Promise((resolve) => {
+		const unsub = actor.subscribe((snapshot) => {
+			if (snapshot.status !== "updating") {
+				unsub();
+				resolve();
+			}
+		});
+	}))).then(() => void 0);
+}
+/**
+* Get the highest buffered end time across all active SourceBuffers.
+* Used to set the final duration from actual container timestamps rather
+* than playlist metadata, which handles both shorter and longer cases.
+*/
+function getMaxBufferedEnd(owners) {
+	let max = 0;
+	for (const buf of [owners.videoBuffer, owners.audioBuffer]) if (buf && buf.buffered.length > 0) {
+		const end = buf.buffered.end(buf.buffered.length - 1);
+		if (end > max) max = end;
+	}
+	return max;
+}
+/**
+* End of stream task (module-level, pure).
+* Sets the final duration from actual buffered end time, then calls endOfStream().
+*/
+const endOfStreamTask = async ({ currentOwners }, _context) => {
+	const { mediaSource } = currentOwners;
+	if (mediaSource.readyState === "ended") return;
+	await waitForSourceBuffersReady(currentOwners);
+	if (mediaSource.readyState !== "open") return;
+	const bufferedEnd = getMaxBufferedEnd(currentOwners);
+	if (bufferedEnd > 0) mediaSource.duration = bufferedEnd;
+	mediaSource.endOfStream();
+	await new Promise((resolve) => requestAnimationFrame(resolve));
+};
+/**
+* Call endOfStream when the last segment has been appended.
+* This signals to the browser that the stream is complete.
+*
+* Per the MSE spec, appendBuffer() remains valid after endOfStream() —
+* seeks that require re-appending earlier segments will still work.
+* What becomes blocked is calling endOfStream() again, addSourceBuffer(),
+* and MediaSource.duration updates.
+*/
+function endOfStream({ state, owners }) {
+	let hasEnded = false;
+	let destroyed = false;
+	const activeActorUnsubs = [];
+	const runEvaluate = async () => {
+		if (destroyed) return;
+		const currentState = state.current;
+		const currentOwners = owners.current;
+		if (hasEnded) {
+			if (currentOwners.mediaSource?.readyState !== "open") return;
+			hasEnded = false;
+		}
+		if (!shouldEndStream(currentState, currentOwners)) return;
+		hasEnded = true;
+		try {
+			await endOfStreamTask({ currentOwners }, {});
+		} catch (error) {
+			console.error("Failed to call endOfStream:", error);
+		}
+	};
+	const cleanupOwners = owners.subscribe((currentOwners) => {
+		activeActorUnsubs.forEach((u) => u());
+		activeActorUnsubs.length = 0;
+		for (const actor of [currentOwners.videoBufferActor, currentOwners.audioBufferActor]) {
+			if (!actor) continue;
+			let isFirst = true;
+			activeActorUnsubs.push(actor.subscribe(() => {
+				if (isFirst) {
+					isFirst = false;
+					return;
+				}
+				runEvaluate();
+			}));
+		}
+	});
+	const cleanupCombineLatest = combineLatest([state, owners]).subscribe(async () => runEvaluate());
+	return () => {
+		destroyed = true;
+		activeActorUnsubs.forEach((u) => u());
+		cleanupOwners();
+		cleanupCombineLatest();
+	};
+}
+
+//#endregion
+export { endOfStream };
+//# sourceMappingURL=end-of-stream.js.map

package/dist/default/dom/features/end-of-stream.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"end-of-stream.js","names":[],"sources":["../../../../src/dom/features/end-of-stream.ts"],"sourcesContent":["import { combineLatest } from '../../core/reactive/combine-latest';\nimport type { WritableState } from '../../core/state/create-state';\nimport type { Presentation } from '../../core/types';\nimport { isResolvedTrack } from '../../core/types';\nimport { getSelectedTrack, type TrackSelectionState } from '../../core/utils/track-selection';\nimport type { SourceBufferActor } from '../media/source-buffer-actor';\n\nexport interface EndOfStreamState extends TrackSelectionState {\n  presentation?: Presentation;\n}\n\nexport interface EndOfStreamOwners {\n  mediaSource?: MediaSource;\n  mediaElement?: HTMLMediaElement | undefined;\n  videoBuffer?: SourceBuffer;\n  audioBuffer?: SourceBuffer;\n  videoBufferActor?: SourceBufferActor;\n  audioBufferActor?: SourceBufferActor;\n}\n\n// ## When to call endOfStream()\n//\n// Per the MSE spec, endOfStream() should be called once the last media\n// segments — temporally speaking — have been completely appended to all\n// active SourceBuffers. Specifically it signals two things:\n//   1. The temporally latest segments for both audio and video have been\n//      appended (i.e. the buffer covers the end of the stream content).\n//   2. The MediaSource will transition from 'open' to 'ended'. Appending\n//      additional (earlier) segments after this — e.g. for a seek-back or\n//      back-buffer refill — will re-open the MediaSource, at which point\n//      endOfStream() must be called again once loading reaches the end.\n//\n// The browser uses this signal to finalise MediaSource.duration and allow\n// the media element to fire the `ended` event. Without it, playback stalls\n// at the end of the buffered range waiting for data that will never arrive.\n//\n// The \"any track\" qualifier is intentional: per the HLS spec, all renditions\n// in a switching set are time-aligned, so the last segment of any rendition\n// covers the same end-of-stream content. We don't need to be tied to the\n// currently selected track.\n//\n// The right long-term condition is therefore:\n//   - The last segment of the video content (from any resolved video track)\n//     has been completely appended to the video SourceBuffer, AND\n//   - The last segment of the audio content (from any resolved audio track)\n//     has been completely appended to the audio SourceBuffer (when active), AND\n//   - currentTime is within the time range of that last segment.\n//\n// The currentTime gate prevents unnecessary re-invocations when back-buffer\n// refills or other mid-stream appends briefly re-open the MediaSource while\n// the user is far from the end.\n//\n/**\n * Check if the last segment of a track has been appended to a SourceBuffer.\n *\n * Checks by segment ID rather than a pipeline flag, so it is robust across\n * quality switches (different tracks have different segment IDs) and\n * back-buffer flushes (flushed segment IDs are removed from the model).\n */\nfunction isLastSegmentAppended(segments: readonly { id: string }[], actor: SourceBufferActor | undefined): boolean {\n  if (segments.length === 0) return true;\n  const lastSeg = segments[segments.length - 1];\n  if (!lastSeg) return false;\n  // A partial segment is still streaming — the last segment is not ready until\n  // its entry is present and not marked partial.\n  return actor?.snapshot.context.segments.some((s) => s.id === lastSeg.id && !s.partial) ?? false;\n}\n\n/**\n * Check if the last segment has been appended for each selected track.\n *\n * Handles video-only, audio-only, and video+audio scenarios.\n * A track with no segments (e.g. unresolved) is considered not ready.\n */\nexport function hasLastSegmentLoaded(state: EndOfStreamState, owners: EndOfStreamOwners): boolean {\n  const videoTrack = state.selectedVideoTrackId ? getSelectedTrack(state, 'video') : undefined;\n  const audioTrack = state.selectedAudioTrackId ? getSelectedTrack(state, 'audio') : undefined;\n\n  // An unresolved track means we don't yet know its segments — cannot be done.\n  // Fast-paths the quality-switch window: when selectedVideoTrackId has changed\n  // to a new (unresolved) track, we cannot yet determine if its last segment\n  // is loaded.\n  if (videoTrack && !isResolvedTrack(videoTrack)) return false;\n  if (audioTrack && !isResolvedTrack(audioTrack)) return false;\n\n  if (videoTrack && isResolvedTrack(videoTrack)) {\n    if (!isLastSegmentAppended(videoTrack.segments, owners.videoBufferActor)) return false;\n  }\n\n  if (audioTrack && isResolvedTrack(audioTrack)) {\n    if (!isLastSegmentAppended(audioTrack.segments, owners.audioBufferActor)) return false;\n  }\n\n  return true;\n}\n\n/**\n * Check if we can call endOfStream.\n */\nexport function canEndStream(state: EndOfStreamState, owners: EndOfStreamOwners): boolean {\n  return !!(owners.mediaSource && state.presentation);\n}\n\n/**\n * Check if we should call endOfStream.\n */\nexport function shouldEndStream(state: EndOfStreamState, owners: EndOfStreamOwners): boolean {\n  if (!canEndStream(state, owners)) return false;\n\n  const { mediaSource, mediaElement } = owners;\n\n  // MediaSource must be open\n  if (mediaSource!.readyState !== 'open') return false;\n\n  // CRITICAL: MediaElement must have metadata before calling endOfStream\n  // Calling endOfStream before HAVE_METADATA causes DEMUXER_ERROR\n  // https://github.com/chromium/chromium/blob/main/media/filters/chunk_demuxer.cc\n  if (mediaElement && mediaElement.readyState < HTMLMediaElement.HAVE_METADATA) {\n    return false;\n  }\n\n  // SourceBuffers must exist for selected tracks before we can end the stream\n  // (otherwise we'd close the MediaSource before SourceBuffers are created)\n  const hasVideoTrack = !!state.selectedVideoTrackId;\n  const hasAudioTrack = !!state.selectedAudioTrackId;\n\n  if (hasVideoTrack && !owners.videoBuffer) return false;\n  if (hasAudioTrack && !owners.audioBuffer) return false;\n\n  // SourceBufferActors must be idle — setting duration while a SourceBuffer is\n  // updating throws InvalidStateError. The actor subscriber in endOfStream() will\n  // re-evaluate when each actor transitions back to idle.\n  if (owners.videoBufferActor?.snapshot.status === 'updating') return false;\n  if (owners.audioBufferActor?.snapshot.status === 'updating') return false;\n\n  // Last segment must be appended for each selected track\n  if (!hasLastSegmentLoaded(state, owners)) return false;\n\n  // currentTime must have reached the last segment. Guards against re-ending\n  // the stream when a back-buffer remove() re-opens the MediaSource while the\n  // user is far from the end (remove() re-opens 'ended' → 'open' per MSE spec,\n  // same as appendBuffer()).\n  if (mediaElement) {\n    const videoTrack = hasVideoTrack ? getSelectedTrack(state, 'video') : undefined;\n    const audioTrack = hasAudioTrack ? getSelectedTrack(state, 'audio') : undefined;\n    const refTrack =\n      videoTrack && isResolvedTrack(videoTrack)\n        ? videoTrack\n        : audioTrack && isResolvedTrack(audioTrack)\n          ? audioTrack\n          : undefined;\n    if (refTrack && refTrack.segments.length > 0) {\n      const lastSeg = refTrack.segments[refTrack.segments.length - 1]!;\n      if (mediaElement.currentTime < lastSeg.startTime) return false;\n    }\n  }\n\n  return true;\n}\n\n/**\n * Wait for all currently-updating SourceBufferActors to finish.\n * Uses actor status rather than raw SourceBuffer.updating so the wait is\n * aligned with the same abstraction that owns all buffer operations.\n */\nfunction waitForSourceBuffersReady(owners: EndOfStreamOwners): Promise<void> {\n  const updatingActors = [owners.videoBufferActor, owners.audioBufferActor].filter(\n    (actor): actor is SourceBufferActor => actor !== undefined && actor.snapshot.status === 'updating'\n  );\n\n  if (updatingActors.length === 0) return Promise.resolve();\n\n  return Promise.all(\n    updatingActors.map(\n      (actor) =>\n        new Promise<void>((resolve) => {\n          const unsub = actor.subscribe((snapshot) => {\n            if (snapshot.status !== 'updating') {\n              unsub();\n              resolve();\n            }\n          });\n        })\n    )\n  ).then(() => undefined);\n}\n\n/**\n * Get the highest buffered end time across all active SourceBuffers.\n * Used to set the final duration from actual container timestamps rather\n * than playlist metadata, which handles both shorter and longer cases.\n */\nfunction getMaxBufferedEnd(owners: EndOfStreamOwners): number {\n  let max = 0;\n  for (const buf of [owners.videoBuffer, owners.audioBuffer]) {\n    if (buf && buf.buffered.length > 0) {\n      const end = buf.buffered.end(buf.buffered.length - 1);\n      if (end > max) max = end;\n    }\n  }\n  return max;\n}\n\n/**\n * End of stream task (module-level, pure).\n * Sets the final duration from actual buffered end time, then calls endOfStream().\n */\nconst endOfStreamTask = async (\n  { currentOwners }: { currentOwners: EndOfStreamOwners },\n  _context: object\n): Promise<void> => {\n  const { mediaSource } = currentOwners;\n\n  // Double-check MediaSource isn't already ended (in case of race)\n  if (mediaSource!.readyState === 'ended') {\n    return;\n  }\n\n  // Wait for any in-progress SourceBuffer operations to finish before calling\n  // endOfStream() — the MSE spec forbids it while any buffer has updating === true.\n  await waitForSourceBuffersReady(currentOwners);\n\n  // Re-check after the async wait\n  if (mediaSource!.readyState !== 'open') return;\n\n  // Set the final duration from actual buffered container timestamps.\n  // This is more accurate than the playlist-derived duration and correctly\n  // handles both shorter (common with CMAF) and longer actual media durations.\n  // Per MSE spec, endOfStream() will only *increase* duration if needed, so\n  // setting it here first ensures the value from the buffer wins in all cases.\n  const bufferedEnd = getMaxBufferedEnd(currentOwners);\n  if (bufferedEnd > 0) {\n    mediaSource!.duration = bufferedEnd;\n  }\n\n  mediaSource!.endOfStream();\n\n  // Wait a frame to allow async state updates to flush\n  await new Promise((resolve) => requestAnimationFrame(resolve));\n};\n\n/**\n * Call endOfStream when the last segment has been appended.\n * This signals to the browser that the stream is complete.\n *\n * Per the MSE spec, appendBuffer() remains valid after endOfStream() —\n * seeks that require re-appending earlier segments will still work.\n * What becomes blocked is calling endOfStream() again, addSourceBuffer(),\n * and MediaSource.duration updates.\n */\nexport function endOfStream({\n  state,\n  owners,\n}: {\n  state: WritableState<EndOfStreamState>;\n  owners: WritableState<EndOfStreamOwners>;\n}): () => void {\n  let hasEnded = false;\n  let destroyed = false;\n  const activeActorUnsubs: Array<() => void> = [];\n\n  const runEvaluate = async () => {\n    if (destroyed) return;\n    const currentState = state.current;\n    const currentOwners = owners.current;\n    if (hasEnded) {\n      // Per the MSE spec, calling appendBuffer() on a SourceBuffer when\n      // readyState is 'ended' automatically transitions it back to 'open'.\n      // This happens on seek-back after end-of-stream — allow endOfStream()\n      // to be called again once the last segment is reloaded.\n      if (currentOwners.mediaSource?.readyState !== 'open') return;\n      hasEnded = false;\n    }\n    if (!shouldEndStream(currentState, currentOwners)) return;\n\n    // Set flag before awaiting to close the re-entry window between\n    // endOfStream() being called and the async task completing.\n    hasEnded = true;\n    try {\n      await endOfStreamTask({ currentOwners }, {});\n    } catch (error) {\n      console.error('Failed to call endOfStream:', error);\n    }\n  };\n\n  // Subscribe to actor snapshot changes so endOfStream re-evaluates when a\n  // segment is appended (actor context updated), not just on state/owners changes.\n  // Re-subscribe whenever owners changes (actors may have appeared or changed).\n  const cleanupOwners = owners.subscribe((currentOwners) => {\n    activeActorUnsubs.forEach((u) => u());\n    activeActorUnsubs.length = 0;\n\n    for (const actor of [currentOwners.videoBufferActor, currentOwners.audioBufferActor]) {\n      if (!actor) continue;\n      // Skip the immediate fire — the combineLatest subscription handles the\n      // initial evaluation. Only react to subsequent snapshot changes.\n      let isFirst = true;\n      activeActorUnsubs.push(\n        actor.subscribe(() => {\n          if (isFirst) {\n            isFirst = false;\n            return;\n          }\n          runEvaluate();\n        })\n      );\n    }\n  });\n\n  const cleanupCombineLatest = combineLatest([state, owners]).subscribe(async () => runEvaluate());\n\n  return () => {\n    destroyed = true;\n    activeActorUnsubs.forEach((u) => u());\n    cleanupOwners();\n    cleanupCombineLatest();\n  };\n}\n"],"mappings":"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"}

package/dist/default/dom/features/load-segments.js

@@ -0,0 +1,188 @@
+import { createState } from "../../core/state/create-state.js";
+import { sampleBandwidth } from "../../core/abr/bandwidth-estimator.js";
+import { DEFAULT_FORWARD_BUFFER_CONFIG } from "../../core/buffer/forward-buffer.js";
+import { isResolvedTrack } from "../../core/types/index.js";
+import { ChunkedStreamIterable } from "../network/chunked-stream-iterable.js";
+import { fetchResolvable } from "../network/fetch.js";
+import { combineLatest } from "../../core/reactive/combine-latest.js";
+import "../../all.js";
+import { getSelectedTrack } from "../../core/utils/track-selection.js";
+import { createSegmentLoaderActor } from "./segment-loader-actor.js";
+
+//#region src/dom/features/load-segments.ts
+const ActorKeyByType = {
+	video: "videoBufferActor",
+	audio: "audioBufferActor"
+};
+function createTrackedFetch(throughput, onSample) {
+	return async (addressable, options) => {
+		const { minChunkSize, ...fetchOptions } = options ?? {};
+		const response = await fetchResolvable(addressable, fetchOptions);
+		if (!response.body) throw new Error("Response has no body");
+		const body = response.body;
+		return { [Symbol.asyncIterator]: async function* () {
+			let chunkStart = performance.now();
+			for await (const chunk of new ChunkedStreamIterable(body, ...minChunkSize !== void 0 ? [{ minChunkSize }] : [])) {
+				const elapsed = performance.now() - chunkStart;
+				const next = sampleBandwidth(throughput.current, elapsed, chunk.byteLength);
+				throughput.patch(next);
+				throughput.flush();
+				onSample?.(next);
+				yield chunk;
+				chunkStart = performance.now();
+			}
+		} };
+	};
+}
+/**
+* Non-tracking fetch: eagerly starts the request and returns the response body
+* as a lazy chunk iterable. Used for audio tracks which don't sample bandwidth.
+* Pass `minChunkSize: Infinity` to accumulate the full body as a single chunk
+* (equivalent to arrayBuffer() but through the same streaming path).
+*/
+async function fetchStream(addressable, options) {
+	const { minChunkSize, ...fetchOptions } = options ?? {};
+	const response = await fetchResolvable(addressable, fetchOptions);
+	if (!response.body) throw new Error("Response has no body");
+	return new ChunkedStreamIterable(response.body, ...minChunkSize !== void 0 ? [{ minChunkSize }] : []);
+}
+function selectLoadingInputs([segmentsCanLoad, state], type) {
+	const { playbackInitiated, preload, currentTime } = state;
+	return {
+		playbackInitiated,
+		preload,
+		currentTime,
+		track: getSelectedTrack(state, type),
+		segmentsCanLoad
+	};
+}
+/**
+* Equality function encoding the condition hierarchy for relevant changes.
+*
+* Pre-play (!playbackInitiated):
+*   Only preload changes matter. currentTime and resolvedTrackId are ignored
+*   (track changes not supported pre-play; currentTime value is used at
+*   trigger time but changes don't re-trigger).
+*
+* playbackInitiated transition:
+*   Always fires (handled in the subscriber; preload='auto' suppression
+*   applied there since equality functions have no memory of prior values).
+*
+* Post-play (playbackInitiated):
+*   resolvedTrackId changes (track switch or previously-unresolved track
+*   resolving) and currentTime changes both trigger. preload is irrelevant.
+*/
+const segmentStartFor = (currentTime, track) => {
+	if (currentTime == null) return void 0;
+	return track?.segments.find(({ startTime, duration }, i, segments) => currentTime >= startTime && (currentTime < startTime + duration || i === segments.length - 1))?.startTime;
+};
+/**
+* Returns true when the inputs are equal (no meaningful change — don't fire).
+* Returns false when the inputs differ in a way that requires a new message.
+*
+* This IS the shouldLoadSegments logic, expressed as an equality function.
+*/
+function loadingInputsEq(prevState, curState) {
+	if (!curState.segmentsCanLoad) return true;
+	if (!curState.playbackInitiated) {
+		if (curState.preload === "none") return true;
+		return curState.preload === prevState.preload;
+	}
+	if (!prevState.playbackInitiated && curState.playbackInitiated) {
+		if (prevState.preload !== "auto") return false;
+	}
+	if (!curState.track || !isResolvedTrack(curState.track)) return true;
+	if (prevState.track?.id !== curState.track.id && isResolvedTrack(curState.track)) return false;
+	return segmentStartFor(prevState.currentTime, curState.track) === segmentStartFor(curState.currentTime, curState.track);
+}
+/**
+* Load segments orchestration — Reactor layer.
+*
+* Sends typed load messages to a SegmentLoaderActor when relevant conditions
+* change. Uses targeted subscriptions rather than broad combineLatest so only
+* meaningful state changes trigger evaluation.
+*
+* Condition hierarchy (see SegmentLoadingKey for detail):
+*
+*   !playbackInitiated
+*     preload==='none' (or unset)  → dormant; no trigger
+*     preload==='metadata'         → trigger on transition to 'metadata'
+*     preload==='auto'             → trigger on transition to 'auto'
+*
+*   !playbackInitiated → playbackInitiated
+*     preload !== 'auto'           → trigger (message shape changes)
+*     preload === 'auto'           → suppressed (was already full-range mode;
+*                                    let segmentStart take over post-play)
+*                                    KNOWN LIMITATION: seek-before-play with
+*                                    preload='auto' is not supported — if the
+*                                    user seeks before pressing play, the
+*                                    first re-send is delayed until the next
+*                                    segment boundary crossing post-play.
+*
+*   playbackInitiated
+*     resolvedTrackId changes      → trigger
+*     segmentStart(currentTime) changes → trigger (segment boundary only)
+*
+* @example
+* const cleanup = loadSegments({ state, owners }, { type: 'video' });
+*/
+function loadSegments({ state, owners }, config) {
+	const { type } = config;
+	const actorKey = ActorKeyByType[type];
+	const initialBandwidth = state.current.bandwidthState;
+	const throughput = createState(initialBandwidth ?? {
+		fastEstimate: 0,
+		fastTotalWeight: 0,
+		slowEstimate: 0,
+		slowTotalWeight: 0,
+		bytesSampled: 0
+	});
+	const fetchBytes = type === "video" ? createTrackedFetch(throughput, initialBandwidth !== void 0 ? (next) => {
+		state.patch({ bandwidthState: next });
+		state.flush();
+	} : void 0) : fetchStream;
+	const segmentLoader = createState(void 0);
+	const unsubActorLifecycle = owners.subscribe((o) => o[actorKey], (actor) => {
+		if (actor) segmentLoader.patch(createSegmentLoaderActor(actor, fetchBytes));
+		else if (!actor && segmentLoader.current) {
+			segmentLoader.current.destroy();
+			segmentLoader.patch(void 0);
+		}
+		return () => {
+			segmentLoader.current?.destroy();
+			segmentLoader.patch(void 0);
+		};
+	});
+	const segmentsCanLoad = createState(false);
+	const unsubscribeCanLoadSegments = combineLatest([state, segmentLoader]).subscribe(([currentState, currentSegmentLoader]) => {
+		const track = getSelectedTrack(currentState, type);
+		const trackResolved = !!track && isResolvedTrack(track);
+		const segmentLoaderActorExists = !!currentSegmentLoader;
+		segmentsCanLoad.patch(trackResolved && segmentLoaderActorExists);
+	});
+	const unsubscribeShouldLoadSegments = combineLatest([segmentsCanLoad, state]).subscribe(([segmentsCanLoad, state]) => selectLoadingInputs([segmentsCanLoad, state], type), ({ preload, playbackInitiated, currentTime, track }) => {
+		if (!(preload === "auto" || !!playbackInitiated))
+ /** @ts-expect-error */
+		segmentLoader.current?.send({
+			type: "load",
+			track
+		});
+		else segmentLoader.current?.send({
+			type: "load",
+			track,
+			range: {
+				start: currentTime,
+				end: currentTime + DEFAULT_FORWARD_BUFFER_CONFIG.bufferDuration
+			}
+		});
+	}, { equalityFn: loadingInputsEq });
+	return () => {
+		unsubscribeCanLoadSegments();
+		unsubscribeShouldLoadSegments();
+		unsubActorLifecycle();
+	};
+}
+
+//#endregion
+export { loadSegments };
+//# sourceMappingURL=load-segments.js.map