@amazon/vinyl 1.1.1 → 2.0.0

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

@@ -1,7 +1,7 @@
-import type { PrefetchState, QualitySelector } from '../../streaming/abr/QualitySelector';
-import { type Disposable, type LogTarget } from '@amazon/vinyl-util';
+import type { PrefetchState, QualitySelector } from './QualitySelector';
+import { type Disposable, type LogTarget, type Maybe } from '@amazon/vinyl-util';
 import { type ObjectSchema } from '@amazon/vinyl-validation';
-import type { MediaQualityMetadata } from '../../streaming/MediaQualityMetadata';
+import type { MediaQualityMetadata } from '../MediaQualityMetadata';
 import type { ObservableValue } from '@amazon/vinyl-observable';
 export interface QualitySelectorImplOptions {
     /**
@@ -52,6 +52,46 @@ export interface QualitySelectorImplOptions {
      * Default: false
      */
     readonly restrictDecoderChangeOnAudioAbrUp?: boolean;
+    /**
+     * Maximum bandwidth in bits per second a quality may use to be selectable.
+     *
+     * Soft cap: if no qualities fit within the limit (including when set to 0),
+     * the quality with the lowest bandwidth is selected so playback is still
+     * possible.
+     *
+     * Has no effect when {@link strategy} is {@link AbrStrategy.LOWEST} or
+     * {@link AbrStrategy.HIGHEST}, since those strategies pin the selection
+     * regardless of bandwidth.
+     *
+     * Default: null (no limit).
+     */
+    readonly maxBandwidth?: Maybe<number>;
+    /**
+     * Maximum video height, in pixels, a quality may have to be selectable.
+     * Mirrors Shaka's `restrictions.maxHeight`.
+     *
+     * Only affects video qualities; audio (and other non-video) qualities are
+     * never restricted by resolution. Qualities with an unknown height (null)
+     * are treated as within the cap.
+     *
+     * Soft cap: if no video quality fits within the resolution limit, the
+     * quality with the smallest bandwidth is selected so video still plays.
+     *
+     * Has no effect when {@link strategy} is {@link AbrStrategy.LOWEST} or
+     * {@link AbrStrategy.HIGHEST}, since those strategies pin the selection
+     * regardless of resolution.
+     *
+     * Default: null (no limit).
+     */
+    readonly maxHeight?: Maybe<number>;
+    /**
+     * Maximum video width, in pixels, a quality may have to be selectable.
+     * Mirrors Shaka's `restrictions.maxWidth`. Behaves like {@link maxHeight}
+     * but constrains the width dimension.
+     *
+     * Default: null (no limit).
+     */
+    readonly maxWidth?: Maybe<number>;
 }
 export declare enum AbrStrategy {
     /**
@@ -82,6 +122,9 @@ export declare const defaultQualitySelectorImplOptions: {
     readonly bandwidthMultiplierLow: 0.4;
     readonly bandwidthMultiplierHigh: 0.9;
     readonly restrictDecoderChangeOnAudioAbrUp: false;
+    readonly maxBandwidth: null;
+    readonly maxHeight: null;
+    readonly maxWidth: null;
 };
 export interface QualitySelectorImplDeps {
     readonly options: ObservableValue<QualitySelectorImplOptions>;

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

@@ -1 +1 @@
-{"version":3,"file":"QualitySelectorImpl.d.ts","sourceRoot":"","sources":["../../../../../src/streaming/abr/QualitySelectorImpl.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EACR,aAAa,EACb,eAAe,EAClB,MAAM,iCAAiC,CAAA;AACxC,OAAO,EAIH,KAAK,UAAU,EAEf,KAAK,SAAS,EAEjB,MAAM,oBAAoB,CAAA;AAC3B,OAAO,EAKH,KAAK,YAAY,EACpB,MAAM,0BAA0B,CAAA;AACjC,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,kCAAkC,CAAA;AAC5E,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,0BAA0B,CAAA;AAE/D,MAAM,WAAW,0BAA0B;IACvC;;;;;OAKG;IACH,QAAQ,CAAC,mBAAmB,CAAC,EAAE,MAAM,CAAA;IAErC;;;OAGG;IACH,QAAQ,CAAC,kBAAkB,CAAC,EAAE,MAAM,CAAA;IAEpC;;;;OAIG;IACH,QAAQ,CAAC,QAAQ,CAAC,EAAE,WAAW,CAAA;IAE/B;;;;;;;;;OASG;IACH,QAAQ,CAAC,sBAAsB,CAAC,EAAE,MAAM,CAAA;IAExC;;;;;;;;;OASG;IACH,QAAQ,CAAC,uBAAuB,CAAC,EAAE,MAAM,CAAA;IAEzC;;;;;;OAMG;IACH,QAAQ,CAAC,iCAAiC,CAAC,EAAE,OAAO,CAAA;CACvD;AAED,oBAAY,WAAW;IACnB;;OAEG;IACH,MAAM,WAAW;IAEjB;;OAEG;IACH,OAAO,YAAY;IAEnB;;;OAGG;IACH,IAAI,SAAS;IAEb;;;;OAIG;IACH,KAAK,UAAU;CAClB;AAED,eAAO,MAAM,mCAAmC,EAAE,YAAY,CAAC,0BAA0B,CAQnF,CAAA;AAEN,eAAO,MAAM,iCAAiC;;;;;;;CAOC,CAAA;AAE/C,MAAM,WAAW,uBAAuB;IACpC,QAAQ,CAAC,OAAO,EAAE,eAAe,CAAC,0BAA0B,CAAC,CAAA;CAChE;AAED,qBAAa,mBACT,YAAW,eAAe,EAAE,SAAS,EAAE,UAAU;IAEjD,IAAI,CAAC,MAAM,CAAC,WAAW,CAAC,IAAI,MAAM,CAEjC;IAED,QAAQ,CAAC,SAAS,SAAwB;IAC1C,OAAO,CAAC,QAAQ,CACqB;IAErC,OAAO,CAAC,QAAQ,CAAmB;gBAEvB,IAAI,EAAE,uBAAuB;IASzC,IAAI,OAAO,IAAI,QAAQ,CAAC,0BAA0B,CAAC,CAElD;IAED,aAAa,CACT,SAAS,EAAE,SAAS,oBAAoB,EAAE,EAC1C,aAAa,EAAE,aAAa,GAC7B,MAAM;IA0GT,IAAI,QAAQ,IAAI,OAAO,CAEtB;IAED,OAAO;CAGV"}
+{"version":3,"file":"QualitySelectorImpl.d.ts","sourceRoot":"","sources":["../../../../../src/streaming/abr/QualitySelectorImpl.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,aAAa,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAA;AACvE,OAAO,EAIH,KAAK,UAAU,EAEf,KAAK,SAAS,EAEd,KAAK,KAAK,EACb,MAAM,oBAAoB,CAAA;AAC3B,OAAO,EAKH,KAAK,YAAY,EACpB,MAAM,0BAA0B,CAAA;AACjC,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,yBAAyB,CAAA;AACnE,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,0BAA0B,CAAA;AAE/D,MAAM,WAAW,0BAA0B;IACvC;;;;;OAKG;IACH,QAAQ,CAAC,mBAAmB,CAAC,EAAE,MAAM,CAAA;IAErC;;;OAGG;IACH,QAAQ,CAAC,kBAAkB,CAAC,EAAE,MAAM,CAAA;IAEpC;;;;OAIG;IACH,QAAQ,CAAC,QAAQ,CAAC,EAAE,WAAW,CAAA;IAE/B;;;;;;;;;OASG;IACH,QAAQ,CAAC,sBAAsB,CAAC,EAAE,MAAM,CAAA;IAExC;;;;;;;;;OASG;IACH,QAAQ,CAAC,uBAAuB,CAAC,EAAE,MAAM,CAAA;IAEzC;;;;;;OAMG;IACH,QAAQ,CAAC,iCAAiC,CAAC,EAAE,OAAO,CAAA;IAEpD;;;;;;;;;;;;OAYG;IACH,QAAQ,CAAC,YAAY,CAAC,EAAE,KAAK,CAAC,MAAM,CAAC,CAAA;IAErC;;;;;;;;;;;;;;;;OAgBG;IACH,QAAQ,CAAC,SAAS,CAAC,EAAE,KAAK,CAAC,MAAM,CAAC,CAAA;IAElC;;;;;;OAMG;IACH,QAAQ,CAAC,QAAQ,CAAC,EAAE,KAAK,CAAC,MAAM,CAAC,CAAA;CACpC;AAED,oBAAY,WAAW;IACnB;;OAEG;IACH,MAAM,WAAW;IAEjB;;OAEG;IACH,OAAO,YAAY;IAEnB;;;OAGG;IACH,IAAI,SAAS;IAEb;;;;OAIG;IACH,KAAK,UAAU;CAClB;AAED,eAAO,MAAM,mCAAmC,EAAE,YAAY,CAAC,0BAA0B,CAWnF,CAAA;AAEN,eAAO,MAAM,iCAAiC;;;;;;;;;;CAUC,CAAA;AAE/C,MAAM,WAAW,uBAAuB;IACpC,QAAQ,CAAC,OAAO,EAAE,eAAe,CAAC,0BAA0B,CAAC,CAAA;CAChE;AAED,qBAAa,mBACT,YAAW,eAAe,EAAE,SAAS,EAAE,UAAU;IAEjD,IAAI,CAAC,MAAM,CAAC,WAAW,CAAC,IAAI,MAAM,CAEjC;IAED,QAAQ,CAAC,SAAS,SAAwB;IAC1C,OAAO,CAAC,QAAQ,CACqB;IAErC,OAAO,CAAC,QAAQ,CAAmB;gBAEvB,IAAI,EAAE,uBAAuB;IASzC,IAAI,OAAO,IAAI,QAAQ,CAAC,0BAA0B,CAAC,CAElD;IAED,aAAa,CACT,SAAS,EAAE,SAAS,oBAAoB,EAAE,EAC1C,aAAa,EAAE,aAAa,GAC7B,MAAM;IAoJT,IAAI,QAAQ,IAAI,OAAO,CAEtB;IAED,OAAO;CAGV"}

package/dist/types/current/streaming/abr/QualitySelectorImpl.js

@@ -33,6 +33,9 @@ export const qualitySelectorImplOptionsValidator = object({
     bandwidthMultiplierLow: number().optional(),
     bandwidthMultiplierHigh: number().optional(),
     restrictDecoderChangeOnAudioAbrUp: boolean().optional(),
+    maxBandwidth: number().maybe().optional(),
+    maxHeight: number().maybe().optional(),
+    maxWidth: number().maybe().optional(),
 });
 export const defaultQualitySelectorImplOptions = {
     highBufferThreshold: 15,
@@ -41,6 +44,9 @@ export const defaultQualitySelectorImplOptions = {
     bandwidthMultiplierLow: 0.4,
     bandwidthMultiplierHigh: 0.9,
     restrictDecoderChangeOnAudioAbrUp: false,
+    maxBandwidth: null,
+    maxHeight: null,
+    maxWidth: null,
 };
 export class QualitySelectorImpl {
     get [Symbol.toStringTag]() {
@@ -59,7 +65,18 @@ export class QualitySelectorImpl {
         return this._options;
     }
     selectQuality(qualities, prefetchState) {
-        const { strategy, highBufferThreshold, lowBufferThreshold, bandwidthMultiplierLow, bandwidthMultiplierHigh, restrictDecoderChangeOnAudioAbrUp, } = this.options;
+        const { strategy, highBufferThreshold, lowBufferThreshold, bandwidthMultiplierLow, bandwidthMultiplierHigh, restrictDecoderChangeOnAudioAbrUp, maxBandwidth, maxHeight, maxWidth, } = this.options;
+        // A video quality is within the resolution cap when both its width and
+        // height are at or below the configured maxima. Non-video qualities and
+        // qualities with an unknown dimension are never restricted, mirroring
+        // Shaka's restrictions.maxWidth/maxHeight (which only apply to video).
+        const withinResolution = (quality) => quality.contentType !== 'video' ||
+            ((maxHeight == null ||
+                quality.height == null ||
+                quality.height <= maxHeight) &&
+                (maxWidth == null ||
+                    quality.width == null ||
+                    quality.width <= maxWidth));
         const previousQuality = prefetchState.previousQuality;
         // previousIndex will be -1 if the previously playing quality is not within the current qualities list.
         const previousIndex = previousQuality == null
@@ -92,9 +109,13 @@ export class QualitySelectorImpl {
         // Choose bandwidth based on pessimistic network information.
         // If the track is active, take the lesser of the latest recorded bandwidth stat and the weighted
         // average to allow for fast ABR-down in variable conditions.
-        const bandwidth = (prefetchState.active
+        let bandwidth = (prefetchState.active
             ? Math.min(bandwidthEstimate.ewmaLow, bandwidthEstimate.latest)
             : bandwidthEstimate.ewmaLow) * bandwidthMultiplier;
+        // Apply the maxBandwidth cap as a soft upper bound on the bandwidth budget.
+        if (maxBandwidth != null && maxBandwidth < bandwidth) {
+            bandwidth = maxBandwidth;
+        }
         let restrictDecoderId = null;
         let restrictSwitchingGroupIds = null;
         if (previousQuality && previousIndex >= 0) {
@@ -107,14 +128,20 @@ export class QualitySelectorImpl {
             if (previousQuality.bandwidthTotal &&
                 bandwidth < previousQuality.bandwidthTotal) {
                 // Measured bandwidth lower than current streaming bandwidth.
-                if (fetchedTime >= highBufferThreshold) {
+                if (fetchedTime >= highBufferThreshold &&
+                    withinResolution(previousQuality)) {
                     // Do not ABR-down inter-track when there is ample fetched data.
+                    // Skipped if the previous quality now exceeds the resolution
+                    // cap, so a lowered cap takes effect promptly.
                     return previousIndex;
                 }
             }
             else {
-                if (fetchedTime < lowBufferThreshold) {
+                if (fetchedTime < lowBufferThreshold &&
+                    withinResolution(previousQuality)) {
                     // Do not ABR-up inter-track when there is not enough fetched data.
+                    // Skipped if the previous quality now exceeds the resolution
+                    // cap, so a lowered cap takes effect promptly.
                     return previousIndex;
                 }
                 // Measured bandwidth is at least current streaming bandwidth.
@@ -133,10 +160,24 @@ export class QualitySelectorImpl {
             if (restrictDecoderId != null &&
                 quality.decoderId !== restrictDecoderId)
                 return false;
+            // Exclude video qualities above the resolution cap.
+            if (!withinResolution(quality))
+                return false;
             return (quality.bandwidthTotal == null ||
                 quality.bandwidthTotal <= bandwidth);
         });
-        return index === -1 ? qualities.length - 1 : index;
+        if (index !== -1)
+            return index;
+        // No quality fit the bandwidth budget (and resolution cap). Prefer the
+        // smallest quality that still satisfies the resolution cap so a video
+        // above the cap is never selected while a compliant option exists; if
+        // none satisfy the cap, fall back to the overall smallest so video
+        // still plays.
+        for (let i = qualities.length - 1; i >= 0; i--) {
+            if (withinResolution(qualities[i]))
+                return i;
+        }
+        return qualities.length - 1;
     }
     get disposed() {
         return this.disposer.disposed;

package/dist/types/current/streaming/buffering/BufferingController.d.ts

@@ -1,17 +1,12 @@
 import { type AnyRecord, type Clearable, type Disposable, EventHostImpl, type ReadonlyEventHost } from '@amazon/vinyl-util';
 import type { ReadonlyPlaybackController } from '../../playback/ReadonlyPlaybackController';
 import type { SourceBufferController } from './SourceBufferController';
-import type { ReadonlySegmentController } from '../../streaming/SegmentController';
+import type { ReadonlySegmentController } from '../SegmentController';
 import type { BasicErrorEvent } from '../../event/BasicErrorEvent';
 import type { ChangeEvent } from '../../event/ChangeEvent';
-import type { ContentType, MediaQualityMetadata } from '../../streaming/MediaQualityMetadata';
-import { type MediaSourceController } from '../../streaming/buffering/MediaSourceController';
-/**
- * Chrome 52 has decoding errors when duration is set to the mediaPresentationDuration.
- * Adds a slight padding as a workaround.
- * @private
- */
-export declare const DURATION_PADDING = 0.1;
+import type { ContentType, MediaQualityMetadata } from '../MediaQualityMetadata';
+import type { CodecUnsupportedEvent } from '../StreamingEventMap';
+import { type MediaSourceController } from './MediaSourceController';
 /**
  * The interval to throttle polling the buffer.
  * Reset after a seek.
@@ -49,6 +44,16 @@ export interface BufferingControllerEventMap {
      * 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>;
+    /**
+     * A codec the browser reported as supported failed to decode on append and
+     * has been denylisted. Dispatched instead of `error` so the media can be
+     * reloaded and fall back to a codec that decodes.
+     */
+    readonly codecUnsupported: CodecUnsupportedEvent;
 }
 export interface BufferingController extends ReadonlyEventHost<BufferingControllerEventMap>, Clearable, Disposable {
     /**
@@ -78,6 +83,10 @@ export interface BufferingController extends ReadonlyEventHost<BufferingControll
      * True if the stream has buffered the last segment.
      */
     readonly bufferingEnded: boolean;
+    /**
+     * True while the buffer holds any data (false when empty or cleared).
+     */
+    readonly hasData: boolean;
     /**
      * Begins buffering.
      */
@@ -130,6 +139,7 @@ export declare class BufferingControllerImpl extends EventHostImpl<BufferingCont
     readonly deps: BufferingControllerImplDeps;
     readonly contentType: ContentType;
     get [Symbol.toStringTag](): string;
+    readonly logPrefix: string;
     readonly options: BufferingControllerImplOptions;
     private readonly mediaSourceController;
     private readonly playbackController;
@@ -153,6 +163,7 @@ export declare class BufferingControllerImpl extends EventHostImpl<BufferingCont
     private reopen;
     private _error;
     private _bufferingEnded;
+    private _hasData;
     private readonly queue;
     private disposer;
     private _active;
@@ -170,10 +181,6 @@ export declare class BufferingControllerImpl extends EventHostImpl<BufferingCont
      * Returns true if there are active operations.
      */
     get busy(): boolean;
-    /**
-     * Enqueues a duration update.
-     */
-    private refreshDuration;
     /**
      * Resets the throttle and polls the buffer on the next frame.
      */
@@ -231,12 +238,32 @@ export declare class BufferingControllerImpl extends EventHostImpl<BufferingCont
      * Returns true if the last segment has been appended.
      */
     get bufferingEnded(): boolean;
+    get hasData(): boolean;
+    private setHasData;
     private readonly handleError;
+    /**
+     * Attempts to recover from a SourceBuffer decode/append failure caused by a
+     * codec the browser reported as supported but cannot actually decode.
+     *
+     * Denylists the failing quality's codec so subsequent quality selection
+     * avoids it, then clears and retries. Returns true when a fallback was
+     * initiated (the caller should not enter an error state), false otherwise.
+     *
+     * Guards against loops: recovery only proceeds when the codec was newly
+     * denylisted. A repeat failure for an already-denylisted codec (e.g. a
+     * single-codec stream with no alternative) returns false and falls through
+     * to the normal error path, so playback errors out rather than looping.
+     */
+    private tryCodecFallback;
     /**
      * Returns the amount of time buffered at the current media position.
      * @private
      */
     getBufferedTime(): number;
+    /**
+     * Returns true if the playhead has become disconnected from the continuous buffer.
+     */
+    private needsBufferClear;
     /**
      * Cancels any currently buffering fragments and clears the source buffer.
      */

package/dist/types/current/streaming/buffering/BufferingController.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"BufferingController.d.ts","sourceRoot":"","sources":["../../../../../src/streaming/buffering/BufferingController.ts"],"names":[],"mappings":"AAKA,OAAO,EACH,KAAK,SAAS,EACd,KAAK,SAAS,EAId,KAAK,UAAU,EAEf,aAAa,EAQb,KAAK,iBAAiB,EAEzB,MAAM,oBAAoB,CAAA;AAC3B,OAAO,KAAK,EAAE,0BAA0B,EAAE,MAAM,uCAAuC,CAAA;AACvF,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,0BAA0B,CAAA;AACtE,OAAO,KAAK,EAAE,yBAAyB,EAAE,MAAM,+BAA+B,CAAA;AAG9E,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,yBAAyB,CAAA;AAC9D,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAA;AACtD,OAAO,KAAK,EACR,WAAW,EACX,oBAAoB,EACvB,MAAM,kCAAkC,CAAA;AACzC,OAAO,EAAE,KAAK,qBAAqB,EAAE,MAAM,6CAA6C,CAAA;AAGxF;;;;GAIG;AACH,eAAO,MAAM,gBAAgB,MAAM,CAAA;AAEnC;;;;GAIG;AACH,eAAO,MAAM,oBAAoB,MAAM,CAAA;AAEvC;;GAEG;AACH,eAAO,MAAM,mBAAmB,MAAM,CAAA;AAEtC;;;GAGG;AACH,eAAO,MAAM,eAAe,SAAS,CAAA;AAErC;;GAEG;AACH,eAAO,MAAM,uBAAuB,WAAW,CAAA;AAE/C,MAAM,WAAW,2BAA2B;IACxC;;OAEG;IACH,QAAQ,CAAC,KAAK,EAAE,eAAe,CAAA;IAE/B;;OAEG;IACH,QAAQ,CAAC,qBAAqB,EAAE,WAAW,CAAC,oBAAoB,GAAG,IAAI,CAAC,CAAA;IAExE;;;OAGG;IACH,QAAQ,CAAC,sBAAsB,EAAE,WAAW,CAAC,oBAAoB,GAAG,IAAI,CAAC,CAAA;IAEzE;;OAEG;IACH,QAAQ,CAAC,cAAc,EAAE,SAAS,CAAA;CACrC;AAED,MAAM,WAAW,mBACb,SACI,iBAAiB,CAAC,2BAA2B,CAAC,EAC9C,SAAS,EACT,UAAU;IACd;;;;OAIG;IACH,QAAQ,CAAC,KAAK,EAAE,KAAK,GAAG,IAAI,CAAA;IAE5B;;;;;OAKG;IACH,QAAQ,CAAC,gBAAgB,EAAE,oBAAoB,GAAG,IAAI,CAAA;IAEtD;;;;OAIG;IACH,QAAQ,CAAC,eAAe,EAAE,oBAAoB,GAAG,IAAI,CAAA;IAErD;;OAEG;IACH,QAAQ,CAAC,MAAM,EAAE,OAAO,CAAA;IAExB;;OAEG;IACH,QAAQ,CAAC,cAAc,EAAE,OAAO,CAAA;IAEhC;;OAEG;IACH,QAAQ,IAAI,IAAI,CAAA;IAEhB;;OAEG;IACH,UAAU,IAAI,IAAI,CAAA;IAElB;;OAEG;IACH,KAAK,IAAI,IAAI,CAAA;CAChB;AAOD;;;GAGG;AACH,wBAAgB,sBAAsB,SAErC;AAED;;;;;GAKG;AACH,wBAAgB,oBAAoB,CAAC,WAAW,EAAE,WAAW,GAAG,MAAM,GAAG,IAAI,CAE5E;AAED,MAAM,WAAW,2BAA2B;IACxC,QAAQ,CAAC,qBAAqB,EAAE,qBAAqB,CAAA;IACrD,QAAQ,CAAC,iBAAiB,EAAE,yBAAyB,CAAA;IACrD,QAAQ,CAAC,kBAAkB,EAAE,0BAA0B,CAAA;IACvD,QAAQ,CAAC,6BAA6B,EAAE,MAAM,sBAAsB,CAAA;CACvE;AACD,MAAM,WAAW,8BAA8B;IAC3C;;;;OAIG;IACH,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAA;IAE1B;;;OAGG;IACH,QAAQ,CAAC,aAAa,EAAE,OAAO,CAAC,MAAM,CAAC,WAAW,EAAE,MAAM,CAAC,CAAC,CAAA;CAC/D;AAUD;;;GAGG;AACH,qBAAa,uBACT,SAAQ,aAAa,CAAC,2BAA2B,CACjD,YAAW,mBAAmB,EAAE,UAAU;IA2CtC,QAAQ,CAAC,IAAI,EAAE,2BAA2B;IAC1C,QAAQ,CAAC,WAAW,EAAE,WAAW;IA1CrC,IAAI,CAAC,MAAM,CAAC,WAAW,CAAC,IAAI,MAAM,CAEjC;IAED,QAAQ,CAAC,OAAO,EAAE,8BAA8B,CAAA;IAChD,OAAO,CAAC,QAAQ,CAAC,qBAAqB,CAAuB;IAC7D,OAAO,CAAC,QAAQ,CAAC,kBAAkB,CAA4B;IAC/D,OAAO,CAAC,QAAQ,CAAC,iBAAiB,CAA2B;IAE7D,OAAO,CAAC,sBAAsB,CAAsC;IACpE,OAAO,CAAC,SAAS,CAAsB;IAEvC;;OAEG;IACH,OAAO,CAAC,QAAQ,CAAkD;IAClE,OAAO,CAAC,YAAY,CAAI;IAExB;;OAEG;IACH,OAAO,CAAC,iBAAiB,CAAoC;IAE7D;;;;OAIG;IACH,OAAO,CAAC,MAAM,CAAQ;IACtB,OAAO,CAAC,MAAM,CAAqB;IACnC,OAAO,CAAC,eAAe,CAAQ;IAE/B,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAoB;IAE1C,OAAO,CAAC,QAAQ,CAAmB;IACnC,OAAO,CAAC,OAAO,CAAQ;IACvB,OAAO,CAAC,gBAAgB,CAAwB;IAEhD,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAoB;gBAGpC,IAAI,EAAE,2BAA2B,EACjC,WAAW,EAAE,WAAW,EACjC,OAAO,CAAC,EAAE,OAAO,CAAC,8BAA8B,CAAC;IAarD,IAAI,MAAM,IAAI,OAAO,CAEpB;IAED;;OAEG;IACH,QAAQ;IAmCR,UAAU;IAWV,KAAK,IAAI,IAAI;IAUb;;OAEG;IACH,IAAI,IAAI,IAAI,OAAO,CAElB;IAED;;OAEG;IACH,OAAO,CAAC,eAAe;IAYvB;;OAEG;IACH,OAAO,CAAC,mBAAmB,CAK1B;IAED;;;;OAIG;IACH,OAAO,CAAC,QAAQ,CAAC,UAAU,CA2B1B;IAED,OAAO,CAAC,YAAY;IAYpB;;OAEG;IACH,OAAO,KAAK,IAAI,GAEf;IAED;;OAEG;IACH,OAAO,KAAK,IAAI,GAEf;cAEe,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC;IAmF3C,OAAO,CAAC,mBAAmB;IAI3B;;;OAGG;IACH,OAAO,CAAC,WAAW;IAWnB,OAAO,CAAC,gBAAgB;IASxB,OAAO,CAAC,gBAAgB,CAAoC;IAE5D,IAAI,eAAe,IAAI,oBAAoB,GAAG,IAAI,CAEjD;IAED;;OAEG;IACH,IAAI,gBAAgB,IAAI,oBAAoB,GAAG,IAAI,CAElD;IAED,OAAO,KAAK,gBAAgB,QAS3B;IAED;;;OAGG;IACH,OAAO,KAAK,eAAe,QAS1B;IAED;;;;OAIG;IACH,IAAI,KAAK,IAAI,KAAK,GAAG,IAAI,CAExB;IAED;;OAEG;IACH,OAAO,KAAK,eAAe,GAE1B;IAED;;OAEG;IACH,OAAO,KAAK,iBAAiB,GAE5B;IAED;;OAEG;IACH,IAAI,cAAc,IAAI,OAAO,CAE5B;IAED,OAAO,CAAC,QAAQ,CAAC,WAAW,CA8B3B;IAED;;;OAGG;IACH,eAAe,IAAI,MAAM;IAQzB;;OAEG;IACH,KAAK,IAAI,IAAI;IAcb,OAAO,CAAC,YAAY;IAOpB,OAAO,CAAC,kBAAkB;IAS1B;;OAEG;IACH,OAAO,CAAC,qBAAqB,CAK5B;IAED,IAAI,QAAQ,IAAI,OAAO,CAEtB;IAED,OAAO;CAKV"}
+{"version":3,"file":"BufferingController.d.ts","sourceRoot":"","sources":["../../../../../src/streaming/buffering/BufferingController.ts"],"names":[],"mappings":"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"}

package/dist/types/current/streaming/buffering/BufferingController.js

@@ -2,15 +2,10 @@
  * Copyright Amazon.com, Inc. or its affiliates. All Rights Reserved.
  * SPDX-License-Identifier: Apache-2.0
  */
-import { createAbortSlot, createDisposer, createTaskQueue, EventHostImpl, getLogLevel, isSilentError, LinkedList, logDebug, LogLevel, logVerbose, logWarn, throttle, } from '@amazon/vinyl-util';
-import { LIVE_DURATION } from '../../playback/PlaybackController';
-import { SEGMENT_START_AFFORDANCE } from '../../streaming/SegmentController';
-/**
- * Chrome 52 has decoding errors when duration is set to the mediaPresentationDuration.
- * Adds a slight padding as a workaround.
- * @private
- */
-export const DURATION_PADDING = 0.1;
+import { createAbortSlot, createDisposer, createLogPrefix, createTaskQueue, EventHostImpl, getLogLevel, isSilentError, LinkedList, logDebug, LogLevel, logVerbose, logWarn, throttle, } from '@amazon/vinyl-util';
+import { SEGMENT_START_AFFORDANCE } from '../SegmentController';
+import { SourceBufferError } from './error/SourceBufferError';
+import { denylistCodecsFromMimeType } from './codecDenylist';
 /**
  * The interval to throttle polling the buffer.
  * Reset after a seek.
@@ -65,8 +60,11 @@ export class BufferingControllerImpl extends EventHostImpl {
     deps;
     contentType;
     get [Symbol.toStringTag]() {
-        return 'BufferingControllerImpl';
+        return `Buffering_${this.contentType}`;
     }
+    // Assigned in the constructor body: a field initializer runs before the
+    // contentType param-property, so it would capture `undefined`.
+    logPrefix;
     options;
     mediaSourceController;
     playbackController;
@@ -90,6 +88,7 @@ export class BufferingControllerImpl extends EventHostImpl {
     reopen = false;
     _error = null;
     _bufferingEnded = false;
+    _hasData = false;
     queue = createTaskQueue();
     disposer = createDisposer();
     _active = false;
@@ -99,6 +98,7 @@ export class BufferingControllerImpl extends EventHostImpl {
         super();
         this.deps = deps;
         this.contentType = contentType;
+        this.logPrefix = createLogPrefix(`Buffering_${contentType}`);
         this.options = {
             ...defaultBufferingControllerOptions,
             ...options,
@@ -124,11 +124,11 @@ export class BufferingControllerImpl extends EventHostImpl {
         this.sourceBufferController = add(this.deps.sourceBufferControllerFactory());
         add(this.playbackController.on('timeUpdate', this.pollBuffer));
         add(this.playbackController.on('seeking', () => {
-            this.clear();
+            this.reopen = true; // prevents a no-op when 'ended'
+            this.pollBufferImmediate();
         }));
         const onMediaSourceOpen = () => {
             logDebug(this, 'media source opened');
-            this.refreshDuration();
             this.pollBufferImmediate();
         };
         if (this.mediaSourceOpen) {
@@ -139,7 +139,6 @@ export class BufferingControllerImpl extends EventHostImpl {
         }
         add(this.segmentController.on('change', () => {
             this.reopen = true;
-            this.refreshDuration();
             this.pollBufferImmediate();
         }));
     }
@@ -169,24 +168,12 @@ export class BufferingControllerImpl extends EventHostImpl {
     get busy() {
         return this.queue.running > 0;
     }
-    /**
-     * Enqueues a duration update.
-     */
-    refreshDuration() {
-        this.sourceBufferController.enqueue(async () => {
-            if (!this.mediaSourceOpen)
-                return; // Cannot set duration when media source is not open.
-            const duration = await this.segmentController.getDuration();
-            // For live streams, set the duration to LIVE_DURATION; not all browsers support +Infinity duration.
-            const newDuration = duration == null ? LIVE_DURATION : duration + DURATION_PADDING;
-            logDebug(this, `setting duration: ${newDuration}`);
-            this.mediaSourceController.duration = newDuration;
-        }).catch(this.handleError);
-    }
     /**
      * Resets the throttle and polls the buffer on the next frame.
      */
     pollBufferImmediate = () => {
+        if (!this.active)
+            return;
         this.pollBuffer.reset();
         setTimeout(() => {
             if (this.active)
@@ -207,6 +194,10 @@ export class BufferingControllerImpl extends EventHostImpl {
         if (!this.shouldAppend())
             return;
         this.reopen = false;
+        if (this.needsBufferClear()) {
+            this.clear(); // After the clear, the buffer state will reset and re-poll.
+            return;
+        }
         this.queue
             .enqueue(() => this.appendNext())
             .catch(this.handleError)
@@ -304,6 +295,7 @@ export class BufferingControllerImpl extends EventHostImpl {
         }
         if (!tail)
             this.refreshHead(); // Update quality immediately if buffer was empty
+        this.setHasData(true);
     }
     abortCurrentSegment() {
         this.segmentAbort.abort();
@@ -391,6 +383,16 @@ export class BufferingControllerImpl extends EventHostImpl {
     get bufferingEnded() {
         return this._bufferingEnded;
     }
+    get hasData() {
+        return this._hasData;
+    }
+    setHasData(value) {
+        if (this._hasData === value)
+            return;
+        const previous = this._hasData;
+        this._hasData = value;
+        this.dispatch('hasDataChange', { previous, current: value });
+    }
     handleError = (error) => {
         if ('name' in error && error.name === 'QuotaExceededError') {
             const contentType = this.bufferingQuality?.contentType;
@@ -407,6 +409,11 @@ export class BufferingControllerImpl extends EventHostImpl {
                 }
             }
         }
+        if (this.tryCodecFallback(error)) {
+            // The failing codec was denylisted and playback will retry with a
+            // different quality; do not enter an error state.
+            return;
+        }
         if (!isSilentError(error)) {
             // Set this controller to an error state. If in an error state, buffering will
             // not continue.
@@ -417,6 +424,38 @@ export class BufferingControllerImpl extends EventHostImpl {
             });
         }
     };
+    /**
+     * Attempts to recover from a SourceBuffer decode/append failure caused by a
+     * codec the browser reported as supported but cannot actually decode.
+     *
+     * Denylists the failing quality's codec so subsequent quality selection
+     * avoids it, then clears and retries. Returns true when a fallback was
+     * initiated (the caller should not enter an error state), false otherwise.
+     *
+     * Guards against loops: recovery only proceeds when the codec was newly
+     * denylisted. A repeat failure for an already-denylisted codec (e.g. a
+     * single-codec stream with no alternative) returns false and falls through
+     * to the normal error path, so playback errors out rather than looping.
+     */
+    tryCodecFallback(error) {
+        if (!(error instanceof SourceBufferError))
+            return false;
+        const quality = this.bufferingQuality;
+        const mimeType = quality?.mimeType;
+        const contentType = quality?.contentType;
+        if (!mimeType || !contentType)
+            return false;
+        // denylistCodecsFromMimeType returns false if all codecs were already
+        // denylisted, which bounds recovery to one attempt per codec.
+        if (!denylistCodecsFromMimeType(mimeType))
+            return false;
+        logWarn(this, 'SourceBuffer append failed; denylisting codec and requesting reload:', mimeType);
+        // A decode failure poisons the MediaSource, so in-place recovery is not
+        // possible. Signal a recoverable codec failure; the player reloads the
+        // track, and the denylist steers selection to a codec that decodes.
+        this.dispatch('codecUnsupported', { mimeType, contentType });
+        return true;
+    }
     /**
      * Returns the amount of time buffered at the current media position.
      * @private
@@ -430,6 +469,19 @@ export class BufferingControllerImpl extends EventHostImpl {
             return 0;
         return range[1] - time;
     }
+    /**
+     * Returns true if the playhead has become disconnected from the continuous buffer.
+     */
+    needsBufferClear() {
+        const buffered = this.sourceBufferController.buffered;
+        if (buffered.empty)
+            return false;
+        const time = this.playbackController.currentTime;
+        // The source buffer allows multiple ranges, but buffering produces a
+        // single contiguous range in practice.
+        const range = buffered.ranges[0];
+        return time < range[0] - 0.01 || time > range[1] + 0.5;
+    }
     /**
      * Cancels any currently buffering fragments and clears the source buffer.
      */
@@ -460,6 +512,7 @@ export class BufferingControllerImpl extends EventHostImpl {
         this._bufferingEnded = false;
         this.bufferingQuality = null;
         this.playbackQuality = null;
+        this.setHasData(false);
     }
     /**
      * Finish any partial appends and clear the source buffer.

package/dist/types/current/streaming/buffering/MediaSourceController.d.ts

@@ -1,7 +1,15 @@
 import { type AnyRecord, type Disposable, EventHostImpl, type Json, type LogTarget, type ReadonlyEventHost, ReportableError } from '@amazon/vinyl-util';
-import type { ContentTypesValue } from '../../streaming/ContentTypesValue';
+import type { ObservableValue } from '@amazon/vinyl-observable';
+import type { ContentTypesValue } from '../ContentTypesValue';
 import type { BasicErrorEvent } from '../../event/BasicErrorEvent';
-import type { ContentType } from '../../streaming/MediaQualityMetadata';
+import type { ContentType } from '../MediaQualityMetadata';
+import type { MediaTimeline } from '../MediaTimeline';
+/**
+ * Chrome 52 has decoding errors when duration is set to the mediaPresentationDuration.
+ * Adds a slight padding as a workaround.
+ * @private
+ */
+export declare const DURATION_PADDING = 0.1;
 export interface SourceBufferRef extends Disposable {
     /**
      * The source buffer.
@@ -22,7 +30,8 @@ export interface MediaSourceControllerEventMap {
      */
     readonly sourceOpen: AnyRecord;
     /**
-     * All source buffers have been created and data may be appended.
+     * All source buffers have been created, the media source duration has been set, and data
+     * may be appended.
      */
     readonly readyToAppend: AnyRecord;
     /**
@@ -35,20 +44,12 @@ export interface ReadonlyMediaSourceController extends ReadonlyEventHost<MediaSo
      * Returns the parent media source ready state.
      */
     readonly readyState: ReadyState;
-    /**
-     * Gets the media source's duration.
-     */
-    readonly duration: number;
     /**
      * True if all source buffers have been created and data may be appended.
      */
     readonly readyToAppend: boolean;
 }
 export interface MediaSourceController extends ReadonlyMediaSourceController {
-    /**
-     * Sets/gets the media source's duration.
-     */
-    duration: number;
     /**
      * Constructs a new SourceBuffer with the given content type and mime type.
      */
@@ -59,9 +60,17 @@ export interface MediaSourceController extends ReadonlyMediaSourceController {
      */
     endOfStream(error?: EndOfStreamError): void;
     /**
-     * Creates an Object URL to use as the source for this stream.
+     * Creates the internal media source.
+     * Returns an Object URL to use as the source for this stream.
+     *
+     * Implementation note:
+     * Only the first
+     */
+    activate(): string;
+    /**
+     * Deactivates the controller, disposing underlying resources.
      */
-    createUrl(): string;
+    deactivate(): void;
 }
 export interface MediaSourceControllerImplDeps {
     /**
@@ -72,25 +81,47 @@ export interface MediaSourceControllerImplDeps {
      * Provides the streams that must be created before appending.
      */
     readonly contentTypesValue: ContentTypesValue;
+    /**
+     * The media timeline used to determine duration.
+     */
+    readonly mediaTimelineTransformed: ObservableValue<Promise<MediaTimeline>>;
 }
 export declare class MediaSourceControllerImpl extends EventHostImpl<MediaSourceControllerEventMap> implements MediaSourceController, LogTarget {
+    private readonly deps;
     get [Symbol.toStringTag](): string;
-    private sourceBufferCount;
-    private readonly mediaSource;
-    private readonly disposer;
+    private readonly sourceBuffers;
+    private mediaSource;
+    private objectUrl;
+    private activateDisposer;
     private contentTypes;
+    private durationSet;
+    /**
+     * Token for the in-flight duration update; used to discard stale results when
+     * the timeline changes or the source closes mid-fetch.
+     */
+    private durationToken;
     constructor(deps: MediaSourceControllerImplDeps);
-    private initializeEvents;
-    get duration(): number;
-    set duration(value: number);
+    get active(): boolean;
+    activate(): string;
+    deactivate(): void;
+    private get sourceBufferCount();
+    private readonly errorHandler;
+    /**
+     * Sets the duration on the media source from the current media timeline.
+     * Live streams use LIVE_DURATION since not all browsers support +Infinity duration.
+     *
+     * MSE throws InvalidStateError if duration is set while any source buffer is updating,
+     * so we wait for all tracked source buffers to be idle first.
+     */
+    private refreshDuration;
     get readyState(): ReadyState;
     createSourceBuffer(contentType: ContentType, mimeType: string): SourceBufferRef;
     /**
-     * Emits a 'readyToAppend' event if all source buffers have been created.
+     * Emits a 'readyToAppend' event if all source buffers have been created and the duration
+     * has been applied to the media source.
      */
     private readonly checkReady;
     endOfStream(error?: EndOfStreamError): void;
-    createUrl(): string;
     get readyToAppend(): boolean;
     dispose(): void;
 }

package/dist/types/current/streaming/buffering/MediaSourceController.d.ts.map

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