@amazon/vinyl 1.1.1 → 2.0.0

package/dist/types/current/streaming/ManifestControllerImpl.js

@@ -0,0 +1,104 @@
+/*
+ * Copyright Amazon.com, Inc. or its affiliates. All Rights Reserved.
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import { data } from '@amazon/vinyl-observable';
+import { createAbortSlot, createDisposer, EventHostImpl, logDebug, } from '@amazon/vinyl-util';
+export class ManifestControllerImpl {
+    deps;
+    get [Symbol.toStringTag]() {
+        return 'ManifestControllerImpl';
+    }
+    get logPrefix() {
+        return 'ManifestControllerImpl';
+    }
+    _data;
+    _error = null;
+    abortSlot = createAbortSlot();
+    disposer = createDisposer();
+    events = new EventHostImpl();
+    manifestSpanArmed = true;
+    constructor(deps) {
+        this.deps = deps;
+        // Kick off the initial manifest request. requestManifest() attaches its
+        // own rejection handler, so the stored promise never rejects unhandled.
+        this._data = data(this.requestManifest());
+    }
+    on(type, handler, options) {
+        return this.events.on(type, handler, options);
+    }
+    hasAnyListeners() {
+        return this.events.hasAnyListeners();
+    }
+    hasListeners(type) {
+        return this.events.hasListeners(type);
+    }
+    __eventMapType = this.events.__eventMapType;
+    /**
+     * The most recent error from the manifest provider, or null.
+     */
+    get error() {
+        return this._error;
+    }
+    refresh() {
+        logDebug(this, 'refresh');
+        this._data.value = this.requestManifest();
+    }
+    requestManifest() {
+        this.abortSlot.abort();
+        this._error = null;
+        const promise = this.deps.manifestProvider(this.abortSlot.value);
+        this.measureLoadSpan(promise);
+        promise.catch((error) => {
+            this._error = error;
+        });
+        return promise;
+    }
+    /**
+     * Measures the initial manifest fetch as a load span, re-arming on failure
+     * so a recovered load is still measured.
+     */
+    measureLoadSpan(promise) {
+        if (!this.manifestSpanArmed)
+            return;
+        this.manifestSpanArmed = false;
+        const startTime = Date.now();
+        promise.then(() => this.events.dispatch('loadSpanMeasured', {
+            kind: 'manifest',
+            startTime,
+            endTime: Date.now(),
+        }), () => (this.manifestSpanArmed = true));
+    }
+    reset() {
+        logDebug(this, 'reset');
+        if (this._error) {
+            this.refresh();
+        }
+    }
+    get value() {
+        return this._data.value;
+    }
+    get changeId() {
+        return this._data.changeId;
+    }
+    getValue() {
+        return this._data.getValue();
+    }
+    onData(callback) {
+        return this._data.onData(callback);
+    }
+    map(fn) {
+        return this._data.map(fn);
+    }
+    pick(key) {
+        return this._data.pick(key);
+    }
+    get disposed() {
+        return this.disposer.disposed;
+    }
+    dispose() {
+        this.abortSlot.abort();
+        this.disposer.dispose();
+        this.events.dispose();
+    }
+}

package/dist/types/current/streaming/MediaQualityMetadata.d.ts

@@ -1,12 +1,20 @@
 import { type Maybe, type MutableDeep } from '@amazon/vinyl-util';
 import type { ObjectSchema } from '@amazon/vinyl-validation';
-import { type DescriptorRecord } from '../streaming/DescriptorRecord';
-import type { DrmInitDataType } from '../streaming/DrmInitDataType';
+import { type DescriptorRecord } from './DescriptorRecord';
+import type { DrmInitDataType } from './DrmInitDataType';
 import type { CencEncryptionScheme } from '../drm/CencEncryptionScheme';
 import { DrmKeySystem } from '../drm/DrmKeySystem';
 import type { FrameRate } from '@amazon/vinyl-mpd-parser';
 export type ContentType = 'audio' | 'video' | 'text';
 export declare const ALL_CONTENT_TYPES: ["video", "audio", "text"];
+/**
+ * The content types that can be restricted via an allow list (see
+ * `VinylOptions.allowedContentTypes`). Text is intentionally excluded: text
+ * tracks (subtitles / closed captions) are governed by caption selection, not
+ * by the content-type allow list, so they always remain available.
+ */
+export type RestrictableContentType = Exclude<ContentType, 'text'>;
+export declare const RESTRICTABLE_CONTENT_TYPES: ["video", "audio"];
 /**
  * Contains media formatting and encryption metadata.
  */
@@ -113,6 +121,14 @@ export interface MediaQualityMetadata extends MediaFormatMetadata {
      * Specifies the language of the content, using a code as defined by RFC 5646.
      */
     readonly lang: string | null;
+    /**
+     * Media characteristics / accessibility roles describing this rendition,
+     * e.g. `public.accessibility.describes-video` (HLS CHARACTERISTICS) or a
+     * DASH Role / Accessibility scheme value such as `description`. Used to keep
+     * accessibility renditions (e.g. audio description) from being auto-selected
+     * by default. Empty when none are signaled.
+     */
+    readonly characteristics: readonly string[];
     /**
      * Identifies the group this quality belongs to (e.g. the adaptation set).
      */

package/dist/types/current/streaming/MediaQualityMetadata.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"MediaQualityMetadata.d.ts","sourceRoot":"","sources":["../../../../src/streaming/MediaQualityMetadata.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"MediaQualityMetadata.d.ts","sourceRoot":"","sources":["../../../../src/streaming/MediaQualityMetadata.ts"],"names":[],"mappings":"AAKA,OAAO,EAEH,KAAK,KAAK,EACV,KAAK,WAAW,EACnB,MAAM,oBAAoB,CAAA;AAC3B,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,0BAA0B,CAAA;AAU5D,OAAO,EACH,KAAK,gBAAgB,EAGxB,MAAM,oBAAoB,CAAA;AAE3B,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAA;AACxD,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,6BAA6B,CAAA;AACvE,OAAO,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAA;AAClD,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,0BAA0B,CAAA;AAEzD,MAAM,MAAM,WAAW,GAAG,OAAO,GAAG,OAAO,GAAG,MAAM,CAAA;AAEpD,eAAO,MAAM,iBAAiB,4BAII,CAAA;AAElC;;;;;GAKG;AACH,MAAM,MAAM,uBAAuB,GAAG,OAAO,CAAC,WAAW,EAAE,MAAM,CAAC,CAAA;AAElE,eAAO,MAAM,0BAA0B,oBAGO,CAAA;AAE9C;;GAEG;AACH,MAAM,WAAW,mBAAmB;IAChC;;;OAGG;IACH,QAAQ,CAAC,WAAW,EAAE,WAAW,GAAG,IAAI,CAAA;IAExC;;;;OAIG;IACH,QAAQ,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAA;IAEhC;;OAEG;IACH,QAAQ,CAAC,YAAY,EAAE,eAAe,GAAG,IAAI,CAAA;IAE7C;;OAEG;IACH,QAAQ,CAAC,gBAAgB,EAAE,oBAAoB,GAAG,IAAI,CAAA;IAEtD;;OAEG;IACH,QAAQ,CAAC,kBAAkB,EAAE,SAAS,aAAa,EAAE,CAAA;CACxD;AAED;;;GAGG;AACH,MAAM,WAAW,aAAa;IAC1B;;OAEG;IACH,QAAQ,CAAC,SAAS,EAAE,YAAY,CAAA;IAEhC;;OAEG;IACH,QAAQ,CAAC,IAAI,CAAC,EAAE,KAAK,CAAC,MAAM,CAAC,CAAA;IAE7B;;OAEG;IACH,QAAQ,CAAC,GAAG,CAAC,EAAE,KAAK,CAAC,MAAM,CAAC,CAAA;CAC/B;AAED,eAAO,MAAM,sBAAsB,EAAE,YAAY,CAAC,aAAa,CAKzD,CAAA;AAEN,eAAO,MAAM,4BAA4B,EAAE,YAAY,CAAC,mBAAmB,CAOrE,CAAA;AAEN;;GAEG;AACH,MAAM,WAAW,oBAAqB,SAAQ,mBAAmB;IAC7D;;;;OAIG;IACH,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAA;IAE1B;;;OAGG;IACH,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAA;IAE1B;;;OAGG;IACH,QAAQ,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI,CAAA;IAE9B;;;OAGG;IACH,QAAQ,CAAC,SAAS,EAAE,MAAM,GAAG,IAAI,CAAA;IAEjC;;;;;OAKG;IACH,QAAQ,CAAC,cAAc,EAAE,MAAM,GAAG,IAAI,CAAA;IAEtC;;;;OAIG;IACH,QAAQ,CAAC,iBAAiB,EAAE,SAAS,MAAM,EAAE,GAAG,IAAI,CAAA;IAEpD;;OAEG;IACH,QAAQ,CAAC,SAAS,EAAE,SAAS,GAAG,IAAI,CAAA;IAEpC;;OAEG;IACH,QAAQ,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,CAAA;IAE7B;;OAEG;IACH,QAAQ,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI,CAAA;IAE9B;;OAEG;IACH,QAAQ,CAAC,sBAAsB,EAAE,gBAAgB,CAAA;IAEjD;;OAEG;IACH,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAAA;IAE5B;;;;;;OAMG;IACH,QAAQ,CAAC,eAAe,EAAE,SAAS,MAAM,EAAE,CAAA;IAE3C;;OAEG;IACH,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAA;IAExB;;;;;;;;;OASG;IACH,QAAQ,CAAC,iBAAiB,EAAE,SAAS,MAAM,EAAE,GAAG,IAAI,CAAA;CACvD;AAED;;GAEG;AACH,wBAAgB,8BAA8B,IAAI,WAAW,CAAC,mBAAmB,CAAC,CAQjF;AAED;;GAEG;AACH,wBAAgB,+BAA+B,IAAI,WAAW,CAAC,oBAAoB,CAAC,CAkBnF;AAED,eAAO,MAAM,6BAA6B,EAAE,YAAY,CAAC,oBAAoB,CAgBvE,CAAA"}

package/dist/types/current/streaming/MediaQualityMetadata.js

@@ -4,13 +4,17 @@
  */
 import { createShortUid, } from '@amazon/vinyl-util';
 import { array, enumOf, isOneOf, number, object, string, tuple, } from '@amazon/vinyl-validation';
-import { descriptorRecordValidator, descriptorValidator, } from '../streaming/DescriptorRecord';
+import { descriptorRecordValidator, descriptorValidator, } from './DescriptorRecord';
 import { DrmKeySystem } from '../drm/DrmKeySystem';
 export const ALL_CONTENT_TYPES = [
     'video',
     'audio',
     'text',
 ];
+export const RESTRICTABLE_CONTENT_TYPES = [
+    'video',
+    'audio',
+];
 export const drmProtectionValidator = descriptorValidator.extend({
     keySystem: enumOf(DrmKeySystem),
     pro: string().maybe().optional(),
@@ -52,6 +56,7 @@ export function createEmptyMediaQualityMetadata() {
         height: null,
         width: null,
         lang: null,
+        characteristics: [],
         groupId: createShortUid(),
         switchingGroupIds: null,
     };
@@ -68,6 +73,7 @@ export const mediaQualityMetadataValidator = mediaFormatMetadataValidator.extend
     supplementalProperties: descriptorRecordValidator,
     width: number().orNull(),
     lang: string().orNull(),
+    characteristics: array(string()).readonly(),
     groupId: string(),
     switchingGroupIds: array(string()).readonly().orNull(),
 });

package/dist/types/current/streaming/MediaTimeline.d.ts

@@ -1,6 +1,7 @@
-import type { SegmentReference } from '../streaming/SegmentReference';
-import type { SegmentDataProvider } from '../streaming/SegmentDataSlot';
-import type { MediaQualityMetadata } from '../streaming/MediaQualityMetadata';
+import type { SegmentReference } from './SegmentReference';
+import type { SegmentDataProvider } from './SegmentDataSlot';
+import type { MediaQualityMetadata } from './MediaQualityMetadata';
+import type { AdBreakList } from '../ad/AdBreakInfo';
 /**
  * Represents a single quality within a period, providing access to its metadata
  * and segment data.
@@ -32,11 +33,17 @@ export interface MediaTimeline {
      * The minimum duration of the buffer that a client should maintain for uninterrupted playback.
      */
     readonly minBufferTime: number;
+    /**
+     * Ad breaks discovered from the media presentation (e.g. HLS Interstitials,
+     * DASH SCTE-35). Empty when the stream carries no ad signals.
+     */
+    getAdBreaks(): Promise<AdBreakList>;
     /**
      * The total duration of the media, in seconds.
-     * Returns null if duration cannot be determined.
+     * Returns `Infinity` for live streams.
+     * Rejects when there are no segments to derive a duration from.
      */
-    getDuration?(): Promise<number | null>;
+    getDuration(): Promise<number>;
 }
 /**
  * Gets the period spanning the given presentation time.

package/dist/types/current/streaming/MediaTimeline.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"MediaTimeline.d.ts","sourceRoot":"","sources":["../../../../src/streaming/MediaTimeline.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,8BAA8B,CAAA;AACpE,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,6BAA6B,CAAA;AACtE,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,kCAAkC,CAAA;AAG5E;;;GAGG;AACH,MAAM,WAAW,gBAAgB;IAC7B,QAAQ,CAAC,QAAQ,EAAE,oBAAoB,CAAA;IAEvC;;;;;OAKG;IACH,UAAU,CACN,IAAI,EAAE,MAAM,EACZ,UAAU,CAAC,EAAE,MAAM,GACpB,OAAO,CAAC,gBAAgB,CAAC,mBAAmB,CAAC,GAAG,IAAI,CAAC,CAAA;CAC3D;AAED;;GAEG;AACH,MAAM,WAAW,WAAW;IACxB,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAA;IAC1B,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAA;IACxB,QAAQ,CAAC,SAAS,EAAE,SAAS,gBAAgB,EAAE,CAAA;CAClD;AAED;;GAEG;AACH,MAAM,WAAW,aAAa;IAC1B,QAAQ,CAAC,OAAO,EAAE,SAAS,WAAW,EAAE,CAAA;IAExC;;OAEG;IACH,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAA;IAE9B;;;OAGG;IACH,WAAW,CAAC,IAAI,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAAA;CACzC;AAED;;GAEG;AACH,wBAAgB,oBAAoB,CAChC,QAAQ,EAAE,aAAa,EACvB,IAAI,EAAE,MAAM,GACb,WAAW,GAAG,IAAI,CAQpB"}
+{"version":3,"file":"MediaTimeline.d.ts","sourceRoot":"","sources":["../../../../src/streaming/MediaTimeline.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAA;AAC1D,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,mBAAmB,CAAA;AAC5D,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,wBAAwB,CAAA;AAElE,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAA;AAEpD;;;GAGG;AACH,MAAM,WAAW,gBAAgB;IAC7B,QAAQ,CAAC,QAAQ,EAAE,oBAAoB,CAAA;IAEvC;;;;;OAKG;IACH,UAAU,CACN,IAAI,EAAE,MAAM,EACZ,UAAU,CAAC,EAAE,MAAM,GACpB,OAAO,CAAC,gBAAgB,CAAC,mBAAmB,CAAC,GAAG,IAAI,CAAC,CAAA;CAC3D;AAED;;GAEG;AACH,MAAM,WAAW,WAAW;IACxB,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAA;IAC1B,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAA;IACxB,QAAQ,CAAC,SAAS,EAAE,SAAS,gBAAgB,EAAE,CAAA;CAClD;AAED;;GAEG;AACH,MAAM,WAAW,aAAa;IAC1B,QAAQ,CAAC,OAAO,EAAE,SAAS,WAAW,EAAE,CAAA;IAExC;;OAEG;IACH,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAA;IAE9B;;;OAGG;IACH,WAAW,IAAI,OAAO,CAAC,WAAW,CAAC,CAAA;IAEnC;;;;OAIG;IACH,WAAW,IAAI,OAAO,CAAC,MAAM,CAAC,CAAA;CACjC;AAED;;GAEG;AACH,wBAAgB,oBAAoB,CAChC,QAAQ,EAAE,aAAa,EACvB,IAAI,EAAE,MAAM,GACb,WAAW,GAAG,IAAI,CAQpB"}

package/dist/types/current/streaming/SegmentController.d.ts

@@ -1,7 +1,8 @@
 import type { AnyRecord, Disposable, ReadonlyAbort, ReadonlyEventHost, ReadonlyRanges } from '@amazon/vinyl-util';
-import type { SegmentReference } from '../streaming/SegmentReference';
+import type { SegmentReference } from './SegmentReference';
 import type { ChangeEvent } from '../event/ChangeEvent';
-import type { MediaQualityMetadata } from '../streaming/MediaQualityMetadata';
+import type { MediaQualityMetadata } from './MediaQualityMetadata';
+import type { LoadSpanMeasurement } from './LoadMetric';
 /**
  * Forward-snap tolerance, in seconds, applied when looking up a segment by time.
  *
@@ -32,6 +33,10 @@ export interface SegmentControllerEventMap {
      * This is dispatched when a new quality is requested.
      */
     readonly streamingQualityChange: ChangeEvent<MediaQualityMetadata | null>;
+    /**
+     * The first init or media segment fetch of this stream completed.
+     */
+    readonly loadSpanMeasured: LoadSpanMeasurement;
 }
 /**
  * The SegmentController provides segments to buffer for the given time.
@@ -48,11 +53,6 @@ export interface ReadonlySegmentController extends ReadonlyEventHost<SegmentCont
      * The most recently requested quality metadata.
      */
     readonly streamingQuality: MediaQualityMetadata | null;
-    /**
-     * The duration of the media, in seconds.
-     * Returns null if duration cannot be determined.
-     */
-    getDuration(): Promise<number | null>;
     /**
      * Returns a Promise for a segment covering the given time, with quality chosen by
      * the configured `QualitySelector`. Resolves to `null` if no media exists at that

package/dist/types/current/streaming/SegmentController.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"SegmentController.d.ts","sourceRoot":"","sources":["../../../../src/streaming/SegmentController.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EACR,SAAS,EACT,UAAU,EACV,aAAa,EACb,iBAAiB,EACjB,cAAc,EACjB,MAAM,oBAAoB,CAAA;AAC3B,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,8BAA8B,CAAA;AACpE,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAA;AACtD,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,kCAAkC,CAAA;AAE5E;;;;;;;;;;;;;;GAcG;AACH,eAAO,MAAM,wBAAwB,MAAM,CAAA;AAE3C,MAAM,WAAW,yBAAyB;IACtC;;OAEG;IACH,QAAQ,CAAC,mBAAmB,EAAE,SAAS,CAAA;IAEvC;;OAEG;IACH,QAAQ,CAAC,MAAM,EAAE,SAAS,CAAA;IAE1B;;;OAGG;IACH,QAAQ,CAAC,sBAAsB,EAAE,WAAW,CAAC,oBAAoB,GAAG,IAAI,CAAC,CAAA;CAC5E;AAED;;;;GAIG;AACH,MAAM,WAAW,yBAA0B,SAAQ,iBAAiB,CAAC,yBAAyB,CAAC;IAC3F,QAAQ,CAAC,KAAK,EAAE,KAAK,GAAG,IAAI,CAAA;IAE5B;;OAEG;IACH,QAAQ,CAAC,aAAa,EAAE,cAAc,CAAA;IAEtC;;OAEG;IACH,QAAQ,CAAC,gBAAgB,EAAE,oBAAoB,GAAG,IAAI,CAAA;IAEtD;;;OAGG;IACH,WAAW,IAAI,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAAA;IAErC;;;;;;;;;;;;;;;;;OAiBG;IACH,UAAU,CACN,IAAI,EAAE,MAAM,EACZ,KAAK,CAAC,EAAE,aAAa,GACtB,OAAO,CAAC,gBAAgB,CAAC,WAAW,CAAC,GAAG,IAAI,CAAC,CAAA;CACnD;AAED;;GAEG;AACH,MAAM,WAAW,eAAe;IAC5B;;OAEG;IACH,QAAQ,CAAC,qBAAqB,EAAE,MAAM,CAAA;IAEtC;;OAEG;IACH,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAA;CAC7B;AAED;;;GAGG;AACH,MAAM,WAAW,iBACb,SAAQ,yBAAyB,EAAE,UAAU;IAC7C;;OAEG;IACH,SAAS,CAAC,OAAO,EAAE,OAAO,CAAC,eAAe,CAAC,GAAG,IAAI,CAAA;IAElD;;;OAGG;IACH,KAAK,IAAI,IAAI,CAAA;IAEb;;;OAGG;IACH,QAAQ,IAAI,IAAI,CAAA;IAEhB;;OAEG;IACH,UAAU,IAAI,IAAI,CAAA;IAElB;;OAEG;IACH,KAAK,IAAI,IAAI,CAAA;CAChB"}
+{"version":3,"file":"SegmentController.d.ts","sourceRoot":"","sources":["../../../../src/streaming/SegmentController.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EACR,SAAS,EACT,UAAU,EACV,aAAa,EACb,iBAAiB,EACjB,cAAc,EACjB,MAAM,oBAAoB,CAAA;AAC3B,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAA;AAC1D,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,sBAAsB,CAAA;AACvD,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,wBAAwB,CAAA;AAClE,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,cAAc,CAAA;AAEvD;;;;;;;;;;;;;;GAcG;AACH,eAAO,MAAM,wBAAwB,MAAM,CAAA;AAE3C,MAAM,WAAW,yBAAyB;IACtC;;OAEG;IACH,QAAQ,CAAC,mBAAmB,EAAE,SAAS,CAAA;IAEvC;;OAEG;IACH,QAAQ,CAAC,MAAM,EAAE,SAAS,CAAA;IAE1B;;;OAGG;IACH,QAAQ,CAAC,sBAAsB,EAAE,WAAW,CAAC,oBAAoB,GAAG,IAAI,CAAC,CAAA;IAEzE;;OAEG;IACH,QAAQ,CAAC,gBAAgB,EAAE,mBAAmB,CAAA;CACjD;AAED;;;;GAIG;AACH,MAAM,WAAW,yBAA0B,SAAQ,iBAAiB,CAAC,yBAAyB,CAAC;IAC3F,QAAQ,CAAC,KAAK,EAAE,KAAK,GAAG,IAAI,CAAA;IAE5B;;OAEG;IACH,QAAQ,CAAC,aAAa,EAAE,cAAc,CAAA;IAEtC;;OAEG;IACH,QAAQ,CAAC,gBAAgB,EAAE,oBAAoB,GAAG,IAAI,CAAA;IAEtD;;;;;;;;;;;;;;;;;OAiBG;IACH,UAAU,CACN,IAAI,EAAE,MAAM,EACZ,KAAK,CAAC,EAAE,aAAa,GACtB,OAAO,CAAC,gBAAgB,CAAC,WAAW,CAAC,GAAG,IAAI,CAAC,CAAA;CACnD;AAED;;GAEG;AACH,MAAM,WAAW,eAAe;IAC5B;;OAEG;IACH,QAAQ,CAAC,qBAAqB,EAAE,MAAM,CAAA;IAEtC;;OAEG;IACH,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAA;CAC7B;AAED;;;GAGG;AACH,MAAM,WAAW,iBACb,SAAQ,yBAAyB,EAAE,UAAU;IAC7C;;OAEG;IACH,SAAS,CAAC,OAAO,EAAE,OAAO,CAAC,eAAe,CAAC,GAAG,IAAI,CAAA;IAElD;;;OAGG;IACH,KAAK,IAAI,IAAI,CAAA;IAEb;;;OAGG;IACH,QAAQ,IAAI,IAAI,CAAA;IAEhB;;OAEG;IACH,UAAU,IAAI,IAAI,CAAA;IAElB;;OAEG;IACH,KAAK,IAAI,IAAI,CAAA;CAChB"}

package/dist/types/current/streaming/SegmentControllerImpl.d.ts

@@ -1,11 +1,11 @@
 import { EventHostImpl, type ReadonlyAbort, type ReadonlyRanges } from '@amazon/vinyl-util';
 import type { ReadonlyPlaybackController } from '../playback/ReadonlyPlaybackController';
-import { type PrefetchOptions, type SegmentController, type SegmentControllerEventMap } from '../streaming/SegmentController';
-import type { SegmentReference } from '../streaming/SegmentReference';
-import type { ContentType, MediaQualityMetadata } from '../streaming/MediaQualityMetadata';
+import { type PrefetchOptions, type SegmentController, type SegmentControllerEventMap } from './SegmentController';
+import type { SegmentReference } from './SegmentReference';
+import type { ContentType, MediaQualityMetadata } from './MediaQualityMetadata';
 import type { ObservableValue } from '@amazon/vinyl-observable';
-import type { MediaTimeline } from '../streaming/MediaTimeline';
-import type { QualitySelector } from '../streaming/abr/QualitySelector';
+import type { MediaTimeline } from './MediaTimeline';
+import type { QualitySelector } from './abr/QualitySelector';
 /**
  * The interval to check if additional segments should be prefetched.
  */
@@ -44,6 +44,7 @@ export declare class SegmentControllerImpl extends EventHostImpl<SegmentControll
     readonly deps: SegmentControllerImplDeps;
     readonly contentType: ContentType;
     get [Symbol.toStringTag](): string;
+    readonly logPrefix: string;
     private _active;
     get active(): boolean;
     private readonly _fetchedRanges;
@@ -64,6 +65,8 @@ export declare class SegmentControllerImpl extends EventHostImpl<SegmentControll
     private ended;
     private prefetching;
     private _error;
+    private initSpanArmed;
+    private firstSegmentSpanArmed;
     private timeUpdateSub;
     private seekingSub;
     private readonly abort;
@@ -73,7 +76,6 @@ export declare class SegmentControllerImpl extends EventHostImpl<SegmentControll
     private _cachedPeriod;
     constructor(deps: SegmentControllerImplDeps, contentType: ContentType, options?: Partial<SegmentControllerImplOptions>);
     get error(): Error | null;
-    getDuration(): Promise<number | null>;
     /**
      * Gets the period at the given time, using a cache for the last returned period.
      */
@@ -110,6 +112,15 @@ export declare class SegmentControllerImpl extends EventHostImpl<SegmentControll
     private getNextTimeToPrefetch;
     private pollPrefetch;
     private prefetchErrorHandler;
+    /**
+     * Requests init-segment data, measuring the first fetch as a load span.
+     */
+    private requestInitData;
+    /**
+     * Requests media-segment data, measuring the first fetch as a load span.
+     */
+    private requestSegmentData;
+    private measureLoadSpan;
     get fetchedRanges(): ReadonlyRanges;
     /**
      * Gets the number of seconds currently prefetched.

package/dist/types/current/streaming/SegmentControllerImpl.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"SegmentControllerImpl.d.ts","sourceRoot":"","sources":["../../../../src/streaming/SegmentControllerImpl.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"SegmentControllerImpl.d.ts","sourceRoot":"","sources":["../../../../src/streaming/SegmentControllerImpl.ts"],"names":[],"mappings":"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"}

package/dist/types/current/streaming/SegmentControllerImpl.js

@@ -2,12 +2,13 @@
  * Copyright Amazon.com, Inc. or its affiliates. All Rights Reserved.
  * SPDX-License-Identifier: Apache-2.0
  */
-import { Abort, clone, closeTo, createDisposer, EventHostImpl, getNetworkState, getOrSet, isSilentError, logDebug, logError, noop, rangeIntersects, RangesImpl, throttle, withAbort, } from '@amazon/vinyl-util';
-import { SEGMENT_START_AFFORDANCE, } from '../streaming/SegmentController';
-import { SegmentDataSlot, SegmentStatus, } from '../streaming/SegmentDataSlot';
-import { defaultTrackPriority, enqueueSegmentPrefetch, immediatePrefetchPriority, } from '../streaming/SegmentPrefetch';
-import { getSegmentAtTime, getSegmentInsertionIndexAtTime, } from '../streaming/util/segment';
-import { getMediaPeriodAtTime, } from '../streaming/MediaTimeline';
+import { Abort, clone, closeTo, createDisposer, createLogPrefix, EventHostImpl, getNetworkState, getOrSet, isSilentError, logDebug, logError, noop, rangeIntersects, RangesImpl, throttle, withAbort, } from '@amazon/vinyl-util';
+import { isMimeTypeDenylisted } from './buffering/codecDenylist';
+import { SEGMENT_START_AFFORDANCE, } from './SegmentController';
+import { SegmentDataSlot, SegmentStatus, } from './SegmentDataSlot';
+import { defaultTrackPriority, enqueueSegmentPrefetch, immediatePrefetchPriority, } from './SegmentPrefetch';
+import { getSegmentAtTime, getSegmentInsertionIndexAtTime, } from './util/segment';
+import { getMediaPeriodAtTime } from './MediaTimeline';
 /**
  * The interval to check if additional segments should be prefetched.
  */
@@ -28,8 +29,11 @@ export class SegmentControllerImpl extends EventHostImpl {
     deps;
     contentType;
     get [Symbol.toStringTag]() {
-        return 'SegmentControllerImpl';
+        return `Segment_${this.contentType}`;
     }
+    // Assigned in the constructor body: a field initializer runs before the
+    // contentType param-property, so it would capture `undefined`.
+    logPrefix;
     _active = false;
     get active() {
         return this._active;
@@ -52,6 +56,11 @@ export class SegmentControllerImpl extends EventHostImpl {
     ended = false;
     prefetching = false;
     _error = null;
+    // Load-span metrics latch on the first init/media fetch attempt (the flag
+    // is cleared when the request is issued) and re-arm if that attempt fails,
+    // so a recovered load is still measured.
+    initSpanArmed = true;
+    firstSegmentSpanArmed = true;
     timeUpdateSub = null;
     seekingSub = null;
     // When disposed, aborts in-flight operations.
@@ -64,6 +73,7 @@ export class SegmentControllerImpl extends EventHostImpl {
         super();
         this.deps = deps;
         this.contentType = contentType;
+        this.logPrefix = createLogPrefix(`Segment_${contentType}`);
         logDebug(this, 'constructed');
         const { add } = this.disposer;
         this.options = {
@@ -85,16 +95,6 @@ export class SegmentControllerImpl extends EventHostImpl {
     get error() {
         return this._error;
     }
-    async getDuration() {
-        const timeline = await this.deps.mediaTimelineTransformed.value;
-        if (timeline.getDuration)
-            return timeline.getDuration();
-        const periods = timeline.periods;
-        if (periods.length === 0)
-            return null;
-        const last = periods[periods.length - 1];
-        return last.endTime === Infinity ? null : last.endTime;
-    }
     /**
      * Gets the period at the given time, using a cache for the last returned period.
      */
@@ -222,8 +222,8 @@ export class SegmentControllerImpl extends EventHostImpl {
                 return;
             }
             await withAbort(Promise.all([
-                slot.initData.request(),
-                slot.data.request(),
+                this.requestInitData(slot),
+                this.requestSegmentData(slot),
             ]), this.abort);
         }, this.contentType, this.prefetchingPriority)
             .catch(this.prefetchErrorHandler)
@@ -239,11 +239,46 @@ export class SegmentControllerImpl extends EventHostImpl {
     prefetchErrorHandler = (error) => {
         // Only log the error for prefetch failures, it will get reported if/when it is attempted
         // to be buffered.
-        if (!isSilentError(error)) {
+        if (!this.disposed && !isSilentError(error)) {
             logError(this, 'Error prefetching segment', error);
             this._error = error;
         }
     };
+    /**
+     * Requests init-segment data, measuring the first fetch as a load span.
+     */
+    requestInitData(slot) {
+        const request = slot.initData.request();
+        if (this.initSpanArmed) {
+            this.initSpanArmed = false;
+            this.measureLoadSpan('initSegment', request);
+        }
+        return request;
+    }
+    /**
+     * Requests media-segment data, measuring the first fetch as a load span.
+     */
+    requestSegmentData(slot) {
+        const request = slot.data.request();
+        if (this.firstSegmentSpanArmed) {
+            this.firstSegmentSpanArmed = false;
+            this.measureLoadSpan('firstSegment', request);
+        }
+        return request;
+    }
+    measureLoadSpan(kind, request) {
+        const startTime = Date.now();
+        request.then(() => this.dispatch('loadSpanMeasured', {
+            kind,
+            startTime,
+            endTime: Date.now(),
+        }), () => {
+            if (kind === 'initSegment')
+                this.initSpanArmed = true;
+            else
+                this.firstSegmentSpanArmed = true;
+        });
+    }
     get fetchedRanges() {
         return this._fetchedRanges;
     }
@@ -289,8 +324,8 @@ export class SegmentControllerImpl extends EventHostImpl {
         // If prefetch failed, try again now that the segment is actively needed:
         this.resetSlot(streamingSlot);
         const initAndDataPromise = Promise.all([
-            streamingSlot.initData.request(),
-            streamingSlot.data.request(),
+            this.requestInitData(streamingSlot),
+            this.requestSegmentData(streamingSlot),
         ]);
         // If the requested time is close to the start of the next segment, immediately start prefetching the next
         // segment, and not resolving until both are cached.
@@ -324,7 +359,10 @@ export class SegmentControllerImpl extends EventHostImpl {
         const slot = await this.getSlotAtTime(time);
         if (!slot)
             return;
-        await Promise.all([slot.initData.request(), slot.data.request()]);
+        await Promise.all([
+            this.requestInitData(slot),
+            this.requestSegmentData(slot),
+        ]);
     }
     /**
      * Gets a streaming segment slot that spans the given time, or null if there is no media at that time.
@@ -377,8 +415,17 @@ export class SegmentControllerImpl extends EventHostImpl {
         const period = await this.getPeriodAtTime(time);
         if (!period)
             return null;
-        // Filter qualities to this content type.
-        const filteredQualities = period.qualities.filter((q) => q.metadata.contentType === this.contentType);
+        // Filter qualities to this content type, excluding any whose codec has
+        // been denylisted at runtime after a decode/append failure (the browser
+        // claimed support it does not actually have). If every quality for this
+        // content type is denylisted, fall back to the unfiltered set so
+        // playback still attempts something rather than stalling silently.
+        const contentTypeQualities = period.qualities.filter((q) => q.metadata.contentType === this.contentType);
+        const playableQualities = contentTypeQualities.filter((q) => !q.metadata.mimeType ||
+            !isMimeTypeDenylisted(q.metadata.mimeType));
+        const filteredQualities = playableQualities.length > 0
+            ? playableQualities
+            : contentTypeQualities;
         if (filteredQualities.length === 0)
             return null;
         // Gets the preceding segment encoding metadata for quality selection.

package/dist/types/current/streaming/SegmentReference.d.ts

@@ -1,4 +1,4 @@
-import type { MediaQualityMetadata } from '../streaming/MediaQualityMetadata';
+import type { MediaQualityMetadata } from './MediaQualityMetadata';
 export interface MediaSegmentMetadata {
     /**
      * The timestamp offset of the segment.

package/dist/types/current/streaming/SegmentReference.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"SegmentReference.d.ts","sourceRoot":"","sources":["../../../../src/streaming/SegmentReference.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,kCAAkC,CAAA;AAE5E,MAAM,WAAW,oBAAoB;IACjC;;;;;;OAMG;IACH,QAAQ,CAAC,eAAe,EAAE,MAAM,CAAA;IAEhC;;;;OAIG;IACH,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAA;IAE1B;;;;OAIG;IACH,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAA;CAC3B;AAED,MAAM,WAAW,oBAAoB,CAAC,CAAC;IACnC;;OAEG;IACH,QAAQ,CAAC,OAAO,EAAE,oBAAoB,CAAA;IAEtC;;;;;OAKG;IACH,QAAQ,CAAC,QAAQ,EAAE,CAAC,CAAA;CACvB;AAED,MAAM,WAAW,qBAAqB,CAAC,CAAC,CAAE,SAAQ,oBAAoB;IAClE;;OAEG;IACH,QAAQ,CAAC,IAAI,EAAE,CAAC,CAAA;CACnB;AAED;;GAEG;AACH,MAAM,WAAW,gBAAgB,CAAC,CAAC,CAC/B,SAAQ,oBAAoB,CAAC,CAAC,CAAC,EAAE,qBAAqB,CAAC,CAAC,CAAC;CAAG"}
+{"version":3,"file":"SegmentReference.d.ts","sourceRoot":"","sources":["../../../../src/streaming/SegmentReference.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,wBAAwB,CAAA;AAElE,MAAM,WAAW,oBAAoB;IACjC;;;;;;OAMG;IACH,QAAQ,CAAC,eAAe,EAAE,MAAM,CAAA;IAEhC;;;;OAIG;IACH,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAA;IAE1B;;;;OAIG;IACH,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAA;CAC3B;AAED,MAAM,WAAW,oBAAoB,CAAC,CAAC;IACnC;;OAEG;IACH,QAAQ,CAAC,OAAO,EAAE,oBAAoB,CAAA;IAEtC;;;;;OAKG;IACH,QAAQ,CAAC,QAAQ,EAAE,CAAC,CAAA;CACvB;AAED,MAAM,WAAW,qBAAqB,CAAC,CAAC,CAAE,SAAQ,oBAAoB;IAClE;;OAEG;IACH,QAAQ,CAAC,IAAI,EAAE,CAAC,CAAA;CACnB;AAED;;GAEG;AACH,MAAM,WAAW,gBAAgB,CAAC,CAAC,CAC/B,SAAQ,oBAAoB,CAAC,CAAC,CAAC,EAAE,qBAAqB,CAAC,CAAC,CAAC;CAAG"}

package/dist/types/current/streaming/StreamingEventMap.d.ts

@@ -1,7 +1,9 @@
 import type { ChangeEvent } from '../event/ChangeEvent';
-import type { ContentType, MediaQualityMetadata } from '../streaming/MediaQualityMetadata';
+import type { ContentType, MediaQualityMetadata } from './MediaQualityMetadata';
 import type { BasicErrorEvent } from '../event/BasicErrorEvent';
 import type { AnyRecord } from '@amazon/vinyl-util';
+import type { SeekRange } from '../track/SeekRange';
+import type { LoadSpanMeasurement } from './LoadMetric';
 /**
  * Events a track dispatches related to streaming quality and status.
  */
@@ -32,6 +34,10 @@ export interface StreamingEventMap {
      * The last segment has finished appending.
      */
     readonly bufferingEnded: AnyRecord;
+    /**
+     * The buffer went from empty to holding data, or back to empty.
+     */
+    readonly hasDataChange: ChangeEvent<boolean>;
     /**
      * Dispatched when a streaming error occurs.
      */
@@ -48,10 +54,41 @@ export interface StreamingEventMap {
      * The available unfiltered qualities for the current period have changed.
      */
     readonly qualitiesUnfilteredChange: ChangeEvent<readonly MediaQualityMetadata[]>;
+    /**
+     * A codec the browser reported as supported failed to decode on append and
+     * has been denylisted at runtime. The current media should be reloaded so
+     * quality selection can fall back to a codec that decodes. Recoverable:
+     * this is dispatched instead of an `error`, and the player reloads the
+     * track in response.
+     */
+    readonly codecUnsupported: CodecUnsupportedEvent;
+    /**
+     * The seekable range on the media timeline has changed.
+     */
+    readonly seekRangeChange: ChangeEvent<SeekRange | null>;
+    /**
+     * A stage of the track load completed. Rather than redispatch this raw
+     * measurement, the player attributes it to the current track and
+     * republishes it as the `loadSpan` event.
+     */
+    readonly loadSpanMeasured: LoadSpanMeasurement;
+}
+/**
+ * Payload for {@link StreamingEventMap.codecUnsupported}.
+ */
+export interface CodecUnsupportedEvent {
+    /**
+     * The mimeType (including the failing codec) that was denylisted.
+     */
+    readonly mimeType: string;
+    /**
+     * The content type of the stream whose append failed.
+     */
+    readonly contentType: ContentType;
 }
 /**
  * All streaming-related events a track may emit.
  * These will be bubbled by the player.
  */
-export declare const ALL_STREAMING_EVENTS: readonly ["contentTypesChange", "fetchedRangesChange", "streamingQualityChange", "bufferingQualityChange", "playbackQualityChange", "bufferingEnded", "error", "reset", "qualitiesChange", "qualitiesUnfilteredChange"];
+export declare const ALL_STREAMING_EVENTS: readonly ["contentTypesChange", "fetchedRangesChange", "streamingQualityChange", "bufferingQualityChange", "playbackQualityChange", "bufferingEnded", "hasDataChange", "error", "reset", "qualitiesChange", "qualitiesUnfilteredChange", "codecUnsupported", "seekRangeChange", "loadSpanMeasured"];
 //# sourceMappingURL=StreamingEventMap.d.ts.map

package/dist/types/current/streaming/StreamingEventMap.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"StreamingEventMap.d.ts","sourceRoot":"","sources":["../../../../src/streaming/StreamingEventMap.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAA;AACtD,OAAO,KAAK,EACR,WAAW,EACX,oBAAoB,EACvB,MAAM,kCAAkC,CAAA;AACzC,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,yBAAyB,CAAA;AAC9D,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,oBAAoB,CAAA;AAEnD;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAC9B;;OAEG;IACH,QAAQ,CAAC,kBAAkB,EAAE,WAAW,CAAC,WAAW,CAAC,WAAW,CAAC,CAAC,CAAA;IAElE;;OAEG;IACH,QAAQ,CAAC,mBAAmB,EAAE,SAAS,CAAA;IAEvC;;;OAGG;IACH,QAAQ,CAAC,sBAAsB,EAAE,WAAW,CAAC,oBAAoB,GAAG,IAAI,CAAC,CAAA;IAEzE;;;OAGG;IACH,QAAQ,CAAC,sBAAsB,EAAE,WAAW,CAAC,oBAAoB,GAAG,IAAI,CAAC,CAAA;IAEzE;;OAEG;IACH,QAAQ,CAAC,qBAAqB,EAAE,WAAW,CAAC,oBAAoB,GAAG,IAAI,CAAC,CAAA;IAExE;;OAEG;IACH,QAAQ,CAAC,cAAc,EAAE,SAAS,CAAA;IAElC;;OAEG;IACH,QAAQ,CAAC,KAAK,EAAE,eAAe,CAAA;IAE/B;;OAEG;IACH,QAAQ,CAAC,KAAK,EAAE,SAAS,CAAA;IAEzB;;OAEG;IACH,QAAQ,CAAC,eAAe,EAAE,WAAW,CAAC,SAAS,oBAAoB,EAAE,CAAC,CAAA;IAEtE;;OAEG;IACH,QAAQ,CAAC,yBAAyB,EAAE,WAAW,CAC3C,SAAS,oBAAoB,EAAE,CAClC,CAAA;CACJ;AAED;;;GAGG;AACH,eAAO,MAAM,oBAAoB,yNAWwB,CAAA"}
+{"version":3,"file":"StreamingEventMap.d.ts","sourceRoot":"","sources":["../../../../src/streaming/StreamingEventMap.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,sBAAsB,CAAA;AACvD,OAAO,KAAK,EAAE,WAAW,EAAE,oBAAoB,EAAE,MAAM,wBAAwB,CAAA;AAC/E,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,0BAA0B,CAAA;AAC/D,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,oBAAoB,CAAA;AACnD,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,oBAAoB,CAAA;AACnD,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,cAAc,CAAA;AAEvD;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAC9B;;OAEG;IACH,QAAQ,CAAC,kBAAkB,EAAE,WAAW,CAAC,WAAW,CAAC,WAAW,CAAC,CAAC,CAAA;IAElE;;OAEG;IACH,QAAQ,CAAC,mBAAmB,EAAE,SAAS,CAAA;IAEvC;;;OAGG;IACH,QAAQ,CAAC,sBAAsB,EAAE,WAAW,CAAC,oBAAoB,GAAG,IAAI,CAAC,CAAA;IAEzE;;;OAGG;IACH,QAAQ,CAAC,sBAAsB,EAAE,WAAW,CAAC,oBAAoB,GAAG,IAAI,CAAC,CAAA;IAEzE;;OAEG;IACH,QAAQ,CAAC,qBAAqB,EAAE,WAAW,CAAC,oBAAoB,GAAG,IAAI,CAAC,CAAA;IAExE;;OAEG;IACH,QAAQ,CAAC,cAAc,EAAE,SAAS,CAAA;IAElC;;OAEG;IACH,QAAQ,CAAC,aAAa,EAAE,WAAW,CAAC,OAAO,CAAC,CAAA;IAE5C;;OAEG;IACH,QAAQ,CAAC,KAAK,EAAE,eAAe,CAAA;IAE/B;;OAEG;IACH,QAAQ,CAAC,KAAK,EAAE,SAAS,CAAA;IAEzB;;OAEG;IACH,QAAQ,CAAC,eAAe,EAAE,WAAW,CAAC,SAAS,oBAAoB,EAAE,CAAC,CAAA;IAEtE;;OAEG;IACH,QAAQ,CAAC,yBAAyB,EAAE,WAAW,CAC3C,SAAS,oBAAoB,EAAE,CAClC,CAAA;IAED;;;;;;OAMG;IACH,QAAQ,CAAC,gBAAgB,EAAE,qBAAqB,CAAA;IAEhD;;OAEG;IACH,QAAQ,CAAC,eAAe,EAAE,WAAW,CAAC,SAAS,GAAG,IAAI,CAAC,CAAA;IAEvD;;;;OAIG;IACH,QAAQ,CAAC,gBAAgB,EAAE,mBAAmB,CAAA;CACjD;AAED;;GAEG;AACH,MAAM,WAAW,qBAAqB;IAClC;;OAEG;IACH,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAA;IAEzB;;OAEG;IACH,QAAQ,CAAC,WAAW,EAAE,WAAW,CAAA;CACpC;AAED;;;GAGG;AACH,eAAO,MAAM,oBAAoB,qSAewB,CAAA"}

package/dist/types/current/streaming/StreamingEventMap.js

@@ -13,8 +13,12 @@ export const ALL_STREAMING_EVENTS = [
     'bufferingQualityChange',
     'playbackQualityChange',
     'bufferingEnded',
+    'hasDataChange',
     'error',
     'reset',
     'qualitiesChange',
     'qualitiesUnfilteredChange',
+    'codecUnsupported',
+    'seekRangeChange',
+    'loadSpanMeasured',
 ];

package/dist/types/current/streaming/abr/QualitySelector.d.ts

@@ -1,4 +1,4 @@
-import type { MediaQualityMetadata } from '../../streaming/MediaQualityMetadata';
+import type { MediaQualityMetadata } from '../MediaQualityMetadata';
 export interface PrefetchState {
     /**
      * The number of seconds currently prefetched.

package/dist/types/current/streaming/abr/QualitySelector.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"QualitySelector.d.ts","sourceRoot":"","sources":["../../../../../src/streaming/abr/QualitySelector.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,kCAAkC,CAAA;AAE5E,MAAM,WAAW,aAAa;IAC1B;;OAEG;IACH,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAA;IAE5B;;;OAGG;IACH,QAAQ,CAAC,eAAe,EAAE,oBAAoB,GAAG,IAAI,CAAA;IAErD;;OAEG;IACH,QAAQ,CAAC,MAAM,EAAE,OAAO,CAAA;CAC3B;AAED,MAAM,WAAW,eAAe;IAC5B;;;;;;;;;;;;OAYG;IACH,aAAa,CACT,SAAS,EAAE,SAAS,oBAAoB,EAAE,EAC1C,aAAa,EAAE,aAAa,GAC7B,MAAM,CAAA;CACZ"}
+{"version":3,"file":"QualitySelector.d.ts","sourceRoot":"","sources":["../../../../../src/streaming/abr/QualitySelector.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,yBAAyB,CAAA;AAEnE,MAAM,WAAW,aAAa;IAC1B;;OAEG;IACH,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAA;IAE5B;;;OAGG;IACH,QAAQ,CAAC,eAAe,EAAE,oBAAoB,GAAG,IAAI,CAAA;IAErD;;OAEG;IACH,QAAQ,CAAC,MAAM,EAAE,OAAO,CAAA;CAC3B;AAED,MAAM,WAAW,eAAe;IAC5B;;;;;;;;;;;;OAYG;IACH,aAAa,CACT,SAAS,EAAE,SAAS,oBAAoB,EAAE,EAC1C,aAAa,EAAE,aAAa,GAC7B,MAAM,CAAA;CACZ"}