@amazon/vinyl 1.2.0 → 2.0.4

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

@@ -0,0 +1,58 @@
+import type { Timestamp } from '@amazon/vinyl-util';
+import type { TrackUri } from '../track/Track';
+/**
+ * The stage of the track-load journey a {@link LoadSpanMeasurement} describes.
+ *
+ * - `manifest`: fetching and parsing the DASH/HLS manifest.
+ * - `license`: the DRM license request/response exchange.
+ * - `initSegment`: fetching the initialization segment.
+ * - `firstSegment`: fetching the first media segment.
+ */
+export type LoadSpanKind = 'manifest' | 'license' | 'initSegment' | 'firstSegment';
+/**
+ * A timed span for one stage of a track load.
+ *
+ * Dispatched by the controller that owns the stage. Emitters attribute the span
+ * to the track it was measured for at the source (see {@link trackUri}); the
+ * player republishes it as a {@link LoadSpanEvent}. When the emitter cannot know
+ * the owning track, `trackUri` is omitted and the span is dropped rather than
+ * misattributed.
+ */
+export interface LoadSpanMeasurement {
+    readonly kind: LoadSpanKind;
+    /**
+     * When the stage began, as a unix millisecond timestamp.
+     */
+    readonly startTime: Timestamp;
+    /**
+     * When the stage completed, as a unix millisecond timestamp.
+     */
+    readonly endTime: Timestamp;
+    /**
+     * The track this span was measured for, stamped at the source by the
+     * emitter that knows which track initiated the load. Omitted only when the
+     * initiating track is not yet known (e.g. an encrypted event handled before
+     * buffering DRM info is set).
+     */
+    readonly trackUri?: TrackUri;
+}
+/**
+ * A {@link LoadSpanMeasurement} attributed to the track it was measured for.
+ *
+ * Emitted on the player as the `loadSpan` event.
+ */
+export interface LoadSpanEvent extends LoadSpanMeasurement {
+    readonly trackUri: TrackUri;
+}
+/**
+ * Player-level load metric events.
+ */
+export interface LoadMetricEventMap {
+    /**
+     * A stage of a track load completed. Reports the time span of the stage
+     * together with the track it belongs to. Consumers measuring end-to-end
+     * load latency key on the first event per `kind` and `trackUri`.
+     */
+    readonly loadSpan: LoadSpanEvent;
+}
+//# sourceMappingURL=LoadMetric.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"LoadMetric.d.ts","sourceRoot":"","sources":["../../../../src/streaming/LoadMetric.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,oBAAoB,CAAA;AACnD,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAA;AAE9C;;;;;;;GAOG;AACH,MAAM,MAAM,YAAY,GAClB,UAAU,GACV,SAAS,GACT,aAAa,GACb,cAAc,CAAA;AAEpB;;;;;;;;GAQG;AACH,MAAM,WAAW,mBAAmB;IAChC,QAAQ,CAAC,IAAI,EAAE,YAAY,CAAA;IAE3B;;OAEG;IACH,QAAQ,CAAC,SAAS,EAAE,SAAS,CAAA;IAE7B;;OAEG;IACH,QAAQ,CAAC,OAAO,EAAE,SAAS,CAAA;IAE3B;;;;;OAKG;IACH,QAAQ,CAAC,QAAQ,CAAC,EAAE,QAAQ,CAAA;CAC/B;AAED;;;;GAIG;AACH,MAAM,WAAW,aAAc,SAAQ,mBAAmB;IACtD,QAAQ,CAAC,QAAQ,EAAE,QAAQ,CAAA;CAC9B;AAED;;GAEG;AACH,MAAM,WAAW,kBAAkB;IAC/B;;;;OAIG;IACH,QAAQ,CAAC,QAAQ,EAAE,aAAa,CAAA;CACnC"}

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

@@ -0,0 +1,5 @@
+/*
+ * Copyright Amazon.com, Inc. or its affiliates. All Rights Reserved.
+ * SPDX-License-Identifier: Apache-2.0
+ */
+export {};

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

@@ -1,5 +1,16 @@
 import type { ObservableValue } from '@amazon/vinyl-observable';
-export interface ManifestController<T> extends ObservableValue<T> {
+import type { ReadonlyAbort, ReadonlyEventHost } from '@amazon/vinyl-util';
+import type { LoadSpanMeasurement } from './LoadMetric';
+/**
+ * Events a manifest controller dispatches.
+ */
+export interface ManifestControllerEventMap {
+    /**
+     * The initial manifest fetch completed.
+     */
+    readonly loadSpanMeasured: LoadSpanMeasurement;
+}
+export interface ManifestController<T> extends ObservableValue<T>, ReadonlyEventHost<ManifestControllerEventMap> {
     /**
      * Manually triggers a reload of the manifest.
      * A manifest reload will not clear currently fetched or buffered segments.
@@ -10,4 +21,8 @@ export interface ManifestController<T> extends ObservableValue<T> {
      */
     reset(): void;
 }
+/**
+ * Provides a manifest.
+ */
+export type ManifestProvider<T> = (abort?: ReadonlyAbort) => Promise<T>;
 //# sourceMappingURL=ManifestController.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"ManifestController.d.ts","sourceRoot":"","sources":["../../../../src/streaming/ManifestController.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,0BAA0B,CAAA;AAE/D,MAAM,WAAW,kBAAkB,CAAC,CAAC,CAAE,SAAQ,eAAe,CAAC,CAAC,CAAC;IAC7D;;;OAGG;IACH,OAAO,IAAI,IAAI,CAAA;IAEf;;OAEG;IACH,KAAK,IAAI,IAAI,CAAA;CAChB"}
+{"version":3,"file":"ManifestController.d.ts","sourceRoot":"","sources":["../../../../src/streaming/ManifestController.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,0BAA0B,CAAA;AAC/D,OAAO,KAAK,EAAE,aAAa,EAAE,iBAAiB,EAAE,MAAM,oBAAoB,CAAA;AAC1E,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,cAAc,CAAA;AAEvD;;GAEG;AACH,MAAM,WAAW,0BAA0B;IACvC;;OAEG;IACH,QAAQ,CAAC,gBAAgB,EAAE,mBAAmB,CAAA;CACjD;AAED,MAAM,WAAW,kBAAkB,CAAC,CAAC,CACjC,SAAQ,eAAe,CAAC,CAAC,CAAC,EAAE,iBAAiB,CAAC,0BAA0B,CAAC;IACzE;;;OAGG;IACH,OAAO,IAAI,IAAI,CAAA;IAEf;;OAEG;IACH,KAAK,IAAI,IAAI,CAAA;CAChB;AAED;;GAEG;AACH,MAAM,MAAM,gBAAgB,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,EAAE,aAAa,KAAK,OAAO,CAAC,CAAC,CAAC,CAAA"}

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

@@ -0,0 +1,43 @@
+import { type MutableValue } from '@amazon/vinyl-observable';
+import { type EventHandler, type SignalOptions, type Unsubscribe } from '@amazon/vinyl-util';
+import type { ManifestController, ManifestControllerEventMap, ManifestProvider } from './ManifestController';
+export interface ManifestControllerImplDeps<T> {
+    readonly manifestProvider: ManifestProvider<T>;
+}
+export declare class ManifestControllerImpl<T> implements ManifestController<Promise<T>> {
+    private readonly deps;
+    get [Symbol.toStringTag](): string;
+    get logPrefix(): string;
+    private readonly _data;
+    private _error;
+    private readonly abortSlot;
+    private readonly disposer;
+    private readonly events;
+    private manifestSpanArmed;
+    constructor(deps: ManifestControllerImplDeps<T>);
+    on<K extends keyof ManifestControllerEventMap>(type: K, handler: EventHandler<ManifestControllerEventMap[K]>, options?: SignalOptions): Unsubscribe;
+    hasAnyListeners(): boolean;
+    hasListeners(type: keyof ManifestControllerEventMap): boolean;
+    readonly __eventMapType: import("@amazon/vinyl-util").Covariant<ManifestControllerEventMap>;
+    /**
+     * The most recent error from the manifest provider, or null.
+     */
+    get error(): Error | null;
+    refresh(): void;
+    private requestManifest;
+    /**
+     * Measures the initial manifest fetch as a load span, re-arming on failure
+     * so a recovered load is still measured.
+     */
+    private measureLoadSpan;
+    reset(): void;
+    get value(): Promise<T>;
+    get changeId(): number;
+    getValue(): Promise<T>;
+    onData(callback: (value: Promise<T>, previous?: Promise<T>) => void): () => void;
+    map<U>(fn: (value: Promise<T>) => U): import("@amazon/vinyl-observable").ObservableValue<U>;
+    pick<K extends keyof NonNullable<Promise<T>>>(key: K): MutableValue<Promise<T>[K]>;
+    get disposed(): boolean;
+    dispose(): void;
+}
+//# sourceMappingURL=ManifestControllerImpl.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"ManifestControllerImpl.d.ts","sourceRoot":"","sources":["../../../../src/streaming/ManifestControllerImpl.ts"],"names":[],"mappings":"AAKA,OAAO,EAAQ,KAAK,YAAY,EAAE,MAAM,0BAA0B,CAAA;AAClE,OAAO,EAGH,KAAK,YAAY,EAGjB,KAAK,aAAa,EAClB,KAAK,WAAW,EACnB,MAAM,oBAAoB,CAAA;AAC3B,OAAO,KAAK,EACR,kBAAkB,EAClB,0BAA0B,EAC1B,gBAAgB,EACnB,MAAM,sBAAsB,CAAA;AAE7B,MAAM,WAAW,0BAA0B,CAAC,CAAC;IACzC,QAAQ,CAAC,gBAAgB,EAAE,gBAAgB,CAAC,CAAC,CAAC,CAAA;CACjD;AAED,qBAAa,sBAAsB,CAAC,CAAC,CAAE,YAAW,kBAAkB,CAChE,OAAO,CAAC,CAAC,CAAC,CACb;IAgBe,OAAO,CAAC,QAAQ,CAAC,IAAI;IAfjC,IAAI,CAAC,MAAM,CAAC,WAAW,CAAC,IAAI,MAAM,CAEjC;IAED,IAAI,SAAS,IAAI,MAAM,CAEtB;IAED,OAAO,CAAC,QAAQ,CAAC,KAAK,CAA0B;IAChD,OAAO,CAAC,MAAM,CAAqB;IACnC,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAoB;IAC9C,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAmB;IAC5C,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAkD;IACzE,OAAO,CAAC,iBAAiB,CAAO;gBAEH,IAAI,EAAE,0BAA0B,CAAC,CAAC,CAAC;IAMhE,EAAE,CAAC,CAAC,SAAS,MAAM,0BAA0B,EACzC,IAAI,EAAE,CAAC,EACP,OAAO,EAAE,YAAY,CAAC,0BAA0B,CAAC,CAAC,CAAC,CAAC,EACpD,OAAO,CAAC,EAAE,aAAa,GACxB,WAAW;IAId,eAAe,IAAI,OAAO;IAI1B,YAAY,CAAC,IAAI,EAAE,MAAM,0BAA0B,GAAG,OAAO;IAI7D,QAAQ,CAAC,cAAc,qEAA6B;IAEpD;;OAEG;IACH,IAAI,KAAK,IAAI,KAAK,GAAG,IAAI,CAExB;IAED,OAAO,IAAI,IAAI;IAKf,OAAO,CAAC,eAAe;IAWvB;;;OAGG;IACH,OAAO,CAAC,eAAe;IAevB,KAAK,IAAI,IAAI;IAOb,IAAI,KAAK,IAAI,OAAO,CAAC,CAAC,CAAC,CAEtB;IAED,IAAI,QAAQ,IAAI,MAAM,CAErB;IAED,QAAQ,IAAI,OAAO,CAAC,CAAC,CAAC;IAItB,MAAM,CACF,QAAQ,EAAE,CAAC,KAAK,EAAE,OAAO,CAAC,CAAC,CAAC,EAAE,QAAQ,CAAC,EAAE,OAAO,CAAC,CAAC,CAAC,KAAK,IAAI,GAC7D,MAAM,IAAI;IAIb,GAAG,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,KAAK,EAAE,OAAO,CAAC,CAAC,CAAC,KAAK,CAAC;IAInC,IAAI,CAAC,CAAC,SAAS,MAAM,WAAW,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,EAAE,GAAG,EAAE,CAAC;IAIpD,IAAI,QAAQ,IAAI,OAAO,CAEtB;IAED,OAAO,IAAI,IAAI;CAKlB"}

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

@@ -7,6 +7,14 @@ 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":"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"}

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

@@ -11,6 +11,10 @@ export const ALL_CONTENT_TYPES = [
     '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 './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,6 +33,11 @@ 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 `Infinity` for live streams.

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,oBAAoB,CAAA;AAC1D,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,mBAAmB,CAAA;AAC5D,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,wBAAwB,CAAA;AAGlE;;;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;;;;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"}
+{"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

@@ -2,6 +2,7 @@ import type { AnyRecord, Disposable, ReadonlyAbort, ReadonlyEventHost, ReadonlyR
 import type { SegmentReference } from './SegmentReference';
 import type { ChangeEvent } from '../event/ChangeEvent';
 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.

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,oBAAoB,CAAA;AAC1D,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,sBAAsB,CAAA;AACvD,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,wBAAwB,CAAA;AAElE;;;;;;;;;;;;;;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;;;;;;;;;;;;;;;;;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

@@ -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;
@@ -109,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":"AAMA,OAAO,EAKH,aAAa,EAUb,KAAK,aAAa,EAClB,KAAK,cAAc,EAGtB,MAAM,oBAAoB,CAAA;AAC3B,OAAO,KAAK,EAAE,0BAA0B,EAAE,MAAM,wCAAwC,CAAA;AACxF,OAAO,EACH,KAAK,eAAe,EAEpB,KAAK,iBAAiB,EACtB,KAAK,yBAAyB,EACjC,MAAM,qBAAqB,CAAA;AAgB5B,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAA;AAC1D,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,aAAa,EAAE,MAAM,iBAAiB,CAAA;AAEpD,OAAO,KAAK,EAAiB,eAAe,EAAE,MAAM,uBAAuB,CAAA;AAE3E;;GAEG;AACH,eAAO,MAAM,sBAAsB,IAAI,CAAA;AAEvC,MAAM,WAAW,yBAAyB;IACtC,QAAQ,CAAC,kBAAkB,EAAE,0BAA0B,CAAA;IAEvD,QAAQ,CAAC,wBAAwB,EAAE,eAAe,CAAC,OAAO,CAAC,aAAa,CAAC,CAAC,CAAA;IAE1E,QAAQ,CAAC,eAAe,EAAE,eAAe,CAAA;CAC5C;AAED,MAAM,WAAW,4BAA4B;IACzC;;;OAGG;IACH,QAAQ,CAAC,cAAc,EAAE,MAAM,CAAA;IAE/B;;;OAGG;IACH,QAAQ,CAAC,gBAAgB,EAAE,MAAM,CAAA;IAEjC;;;OAGG;IACH,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAA;CAC9B;AAED,eAAO,MAAM,mCAAmC,EAAE,4BAK7C,CAAA;AAEL;;;;;;GAMG;AACH,qBAAa,qBACT,SAAQ,aAAa,CAAC,yBAAyB,CAC/C,YAAW,iBAAiB;IA+CxB,QAAQ,CAAC,IAAI,EAAE,yBAAyB;IACxC,QAAQ,CAAC,WAAW,EAAE,WAAW;IA9CrC,IAAI,CAAC,MAAM,CAAC,WAAW,CAAC,IAAI,MAAM,CAEjC;IAED,OAAO,CAAC,OAAO,CAAQ;IACvB,IAAI,MAAM,IAAI,OAAO,CAEpB;IAED,OAAO,CAAC,QAAQ,CAAC,cAAc,CAAmB;IAClD,OAAO,CAAC,UAAU,CAAI;IAEtB;;;;OAIG;IACH,OAAO,CAAC,QAAQ,CAAC,kBAAkB,CAAqC;IACxE,OAAO,CAAC,QAAQ,CAAC,cAAc,CAA0C;IAEzE,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAmB;IAC5C,QAAQ,CAAC,OAAO,EAAE,4BAA4B,CAAA;IAE9C,OAAO,CAAC,mBAAmB,CACI;IAE/B;;OAEG;IACH,OAAO,CAAC,KAAK,CAAQ;IACrB,OAAO,CAAC,WAAW,CAAQ;IAC3B,OAAO,CAAC,MAAM,CAAqB;IAEnC,OAAO,CAAC,aAAa,CAA2B;IAChD,OAAO,CAAC,UAAU,CAA2B;IAG7C,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAc;IAEpC;;OAEG;IACH,OAAO,CAAC,aAAa,CAA2B;gBAGnC,IAAI,EAAE,yBAAyB,EAC/B,WAAW,EAAE,WAAW,EACjC,OAAO,CAAC,EAAE,OAAO,CAAC,4BAA4B,CAAC;IA2BnD,IAAI,KAAK,IAAI,KAAK,GAAG,IAAI,CAExB;IAED;;OAEG;YACW,eAAe;IAc7B;;;;OAIG;IACH,SAAS,CAAC,OAAO,EAAE,OAAO,CAAC,eAAe,CAAC;IAS3C,IAAI,SAAS,IAAI,MAAM,CAEtB;IAED,IAAI,qBAAqB,IAAI,MAAM,CAElC;IAED;;OAEG;IACH,OAAO,KAAK,aAAa,GAIxB;IAED;;;OAGG;IACH,OAAO,KAAK,qBAAqB,GAIhC;IAED;;OAEG;IACH,OAAO,KAAK,mBAAmB,GAI9B;IAED;;;OAGG;IACH,OAAO,CAAC,mBAAmB;IAmC3B;;OAEG;IACH,OAAO,CAAC,qBAAqB;IAS7B,OAAO,CAAC,YAAY,CA+CnB;IAED,OAAO,CAAC,oBAAoB,CAO3B;IAED,IAAI,aAAa,IAAI,cAAc,CAElC;IAED;;OAEG;IACH,IAAI,WAAW,IAAI,MAAM,CAOxB;IAED,OAAO,CAAC,iBAAiB,CAAoC;IAE7D,IAAI,gBAAgB,IAAI,oBAAoB,GAAG,IAAI,CAElD;IAED,OAAO,KAAK,gBAAgB,QAS3B;IAED,UAAU,CACN,IAAI,EAAE,MAAM,EACZ,KAAK,CAAC,EAAE,aAAa,GACtB,OAAO,CAAC,gBAAgB,CAAC,WAAW,CAAC,GAAG,IAAI,CAAC;YAgBlC,WAAW;IAmCzB;;;OAGG;YACW,gBAAgB;IAK9B;;;;OAIG;YACW,iBAAiB;IAM/B;;;OAGG;YACW,aAAa;IAiD3B;;OAEG;IACH,OAAO,CAAC,mBAAmB;IAS3B;;;OAGG;YACW,iBAAiB;IAmD/B;;;;OAIG;IACH,QAAQ,IAAI,IAAI;IAiBhB;;;;OAIG;IACH,UAAU,IAAI,IAAI;IAWlB,KAAK,IAAI,IAAI;IAiBb,KAAK,IAAI,IAAI;IAOb;;;OAGG;IACH,OAAO,CAAC,SAAS;IAajB,IAAI,QAAQ,IAAI,OAAO,CAEtB;IAED,OAAO,IAAI,IAAI;CAQlB"}
+{"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,7 +2,8 @@
  * 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 { 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';
@@ -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 = {
@@ -212,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)
@@ -229,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;
     }
@@ -279,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.
@@ -314,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.
@@ -367,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/StreamingEventMap.d.ts

@@ -2,6 +2,8 @@ import type { ChangeEvent } from '../event/ChangeEvent';
 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,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;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"}