@amazon/vinyl 1.1.1 → 1.2.0

package/dist/index.cjs

@@ -380,7 +380,7 @@ function getAudioContext() {
 // src/client/CapabilitiesImpl.ts
 var CapabilitiesImpl = class {
   constructor(deps) {
-    this.deps = deps;
+    __publicField(this, "deps", deps);
   }
   get mse() {
     return supportsMse();
@@ -729,9 +729,9 @@ var InvalidSeekError = class _InvalidSeekError extends import_vinyl_util8.Report
       import_vinyl_util9.ErrorOrigin.API,
       import_vinyl_util8.ErrorLevel.WARN
     );
-    this.time = time;
-    this.seekable = seekable;
-    this.tolerance = tolerance;
+    __publicField(this, "time", time);
+    __publicField(this, "seekable", seekable);
+    __publicField(this, "tolerance", tolerance);
     Object.setPrototypeOf(this, _InvalidSeekError.prototype);
   }
   get [Symbol.toStringTag]() {
@@ -1567,9 +1567,9 @@ var trackBaseOptionsValidator = /* @__PURE__ */ (0, import_vinyl_validation5.obj
 var TrackBase = class extends import_vinyl_util19.EventHostImpl {
   constructor(uri, type, deps) {
     super();
-    this.uri = uri;
-    this.type = type;
-    this.deps = deps;
+    __publicField(this, "uri", uri);
+    __publicField(this, "type", type);
+    __publicField(this, "deps", deps);
     /**
      * The current load options, if this is an active track.
      */
@@ -1667,7 +1667,7 @@ var import_vinyl_util20 = require("@amazon/vinyl-util");
 var FixedPlaybackQuality = class extends import_vinyl_util20.EventHostImpl {
   constructor(fixedQuality, deps) {
     super();
-    this.deps = deps;
+    __publicField(this, "deps", deps);
     __publicField(this, "_fixedQuality");
     __publicField(this, "_contentTypes", /* @__PURE__ */ new Set());
     __publicField(this, "_isActive", false);
@@ -1851,8 +1851,8 @@ var emptyMediaQualityMetadata = /* @__PURE__ */ createEmptyMediaQualityMetadata(
 var SourceTrackBase = class extends TrackBase {
   constructor(uri, type, src, deps) {
     super(uri, type, deps);
-    this.src = src;
-    this.deps = deps;
+    __publicField(this, "src", src);
+    __publicField(this, "deps", deps);
     __publicField(this, "fixedPlaybackQuality");
     __publicField(this, "_resolvedSrc", null);
     const add = this.disposer.add;
@@ -1938,7 +1938,7 @@ function createSourceObjectTrackFactory(deps) {
 var SourceObjectTrack = class extends SourceTrackBase {
   constructor(uri, type, srcObject, deps) {
     super(uri, type, srcObject, deps);
-    this.deps = deps;
+    __publicField(this, "deps", deps);
   }
   get [Symbol.toStringTag]() {
     return "SourceObjectTrack";
@@ -1979,7 +1979,7 @@ function createSourceTrackFactory(deps) {
 var SourceTrack = class extends SourceTrackBase {
   constructor(uri, type, src, deps) {
     super(uri, type, src, deps);
-    this.deps = deps;
+    __publicField(this, "deps", deps);
   }
   get [Symbol.toStringTag]() {
     return "SourceTrack";
@@ -2041,6 +2041,7 @@ var MseTrack = class extends TrackBase {
         contentTypesPromise.then((contentTypes) => {
           if (this.disposer.disposed) return;
           if ((0, import_vinyl_util27.equalDeep)(this.contentTypes, contentTypes)) return;
+          (0, import_vinyl_util27.logDebug)(this, "content types:", contentTypes);
           this.clearStreams();
           for (const contentType2 of contentTypes) {
             this.createStream(contentType2);
@@ -2365,7 +2366,7 @@ var trackPriority = {
 var TrackControllerImpl = class extends import_vinyl_util30.EventHostImpl {
   constructor(deps, initialOptions) {
     super();
-    this.deps = deps;
+    __publicField(this, "deps", deps);
     // When tracks are preloaded, the cache capacity may expand automatically to accommodate.
     __publicField(this, "_autoPreloadCapacity", 0);
     __publicField(this, "trackCache", /* @__PURE__ */ new import_vinyl_util30.LruCache(0));
@@ -2746,9 +2747,18 @@ function flattenRepresentations(period) {
   return out;
 }
 function calculateDuration(manifest) {
+  if (manifest.MPD.type === "dynamic") return Infinity;
   const mpdDuration = manifest.MPD.mediaPresentationDuration;
   if (mpdDuration != null) return mpdDuration;
-  return calculatePeriodEnd((0, import_vinyl_util33.last)(manifest.MPD.Period));
+  const lastPeriod = (0, import_vinyl_util33.last)(manifest.MPD.Period);
+  if (!lastPeriod) {
+    throw new Error("Unable to determine manifest duration: no periods");
+  }
+  const end = calculatePeriodEnd(lastPeriod);
+  if (end == null) {
+    throw new Error("Unable to determine manifest duration");
+  }
+  return end;
 }
 
 // src/track/dash/util/uriResolution.ts
@@ -3159,16 +3169,84 @@ function resolveAdaptationSetSwitchingGroupIds(adaptationSet, periodId, adaptati
 }
 
 // src/streaming/buffering/MediaSourceController.ts
+var import_vinyl_util43 = require("@amazon/vinyl-util");
+
+// src/util/media/sourceBuffer.ts
+var import_vinyl_util41 = require("@amazon/vinyl-util");
+
+// src/streaming/buffering/error/SourceBufferError.ts
 var import_vinyl_util39 = require("@amazon/vinyl-util");
-var MediaSourceControllerImpl = class extends import_vinyl_util39.EventHostImpl {
+var import_vinyl_util40 = require("@amazon/vinyl-util");
+var SourceBufferError = class _SourceBufferError extends import_vinyl_util40.ReportableError {
+  get [Symbol.toStringTag]() {
+    return "SourceBufferError";
+  }
+  constructor(message = `A SourceBuffer error has occurred.`, origin = import_vinyl_util39.ErrorOrigin.MEDIA) {
+    super(message, origin);
+    Object.setPrototypeOf(this, _SourceBufferError.prototype);
+  }
+};
+
+// src/util/media/sourceBuffer.ts
+var import_vinyl_util42 = require("@amazon/vinyl-util");
+function nextSourceBufferIdle(sourceBuffer) {
+  if (!sourceBuffer) return Promise.resolve();
+  if (!sourceBuffer.updating) return Promise.resolve();
+  return (0, import_vinyl_util41.promise)((resolve, reject) => {
+    const removeListeners = () => {
+      sourceBuffer.removeEventListener("error", onErred);
+      sourceBuffer.removeEventListener("abort", onAborted);
+      sourceBuffer.removeEventListener("update", onEnded);
+    };
+    const onEnded = () => {
+      removeListeners();
+      resolve();
+    };
+    const onErred = (_event) => {
+      removeListeners();
+      reject(new SourceBufferError());
+    };
+    const onAborted = () => {
+      removeListeners();
+      reject(new import_vinyl_util42.AbortError());
+    };
+    sourceBuffer.addEventListener("error", onErred);
+    sourceBuffer.addEventListener("abort", onAborted);
+    sourceBuffer.addEventListener("update", onEnded);
+  });
+}
+
+// src/streaming/buffering/MediaSourceController.ts
+var DURATION_PADDING = 0.1;
+var MediaSourceControllerImpl = class extends import_vinyl_util43.EventHostImpl {
   constructor(deps) {
     super();
-    __publicField(this, "sourceBufferCount", 0);
+    __publicField(this, "deps", deps);
+    __publicField(this, "sourceBuffers", /* @__PURE__ */ new Set());
     __publicField(this, "mediaSource");
-    __publicField(this, "disposer", /* @__PURE__ */ (0, import_vinyl_util39.createDisposer)());
+    __publicField(this, "disposer", /* @__PURE__ */ (0, import_vinyl_util43.createDisposer)());
     __publicField(this, "contentTypes", null);
+    __publicField(this, "durationSet", false);
+    /**
+     * Token for the in-flight duration update; used to discard stale results when
+     * the timeline changes or the source closes mid-fetch.
+     */
+    __publicField(this, "durationToken", 0);
+    __publicField(this, "errorHandler", (error) => {
+      if ((0, import_vinyl_util43.isSilentError)(error)) return;
+      this.dispatch("error", {
+        target: this,
+        error
+      });
+    });
     /**
-     * Emits a 'readyToAppend' event if all source buffers have been created.
+     * Subscription to mediaTimelineTransformed; only attached while the media source is open
+     * so the timeline pipeline isn't forced to evaluate before the source has opened.
+     */
+    __publicField(this, "timelineSub", null);
+    /**
+     * Emits a 'readyToAppend' event if all source buffers have been created and the duration
+     * has been applied to the media source.
      */
     __publicField(this, "checkReady", () => {
       if (this.readyToAppend) this.dispatch("readyToAppend", {});
@@ -3181,20 +3259,18 @@ var MediaSourceControllerImpl = class extends import_vinyl_util39.EventHostImpl
         value.then((contentTypes) => {
           this.contentTypes = contentTypes;
           this.checkReady();
-        }).catch((error) => {
-          this.dispatch("error", {
-            target: this,
-            error
-          });
-        });
+        }).catch(this.errorHandler);
       })
     );
   }
   get [Symbol.toStringTag]() {
     return "MediaSourceControllerImpl";
   }
+  get sourceBufferCount() {
+    return this.sourceBuffers.size;
+  }
   initializeEvents() {
-    const domEvents = new import_vinyl_util39.DomEventHost(
+    const domEvents = new import_vinyl_util43.DomEventHost(
       this.mediaSource
     );
     for (const key of [
@@ -3202,21 +3278,46 @@ var MediaSourceControllerImpl = class extends import_vinyl_util39.EventHostImpl
       "sourceOpen",
       "sourceEnded"
     ]) {
-      domEvents.on((0, import_vinyl_util39.toLowerCase)(key), () => this.dispatch(key, {}));
+      domEvents.on((0, import_vinyl_util43.toLowerCase)(key), () => this.dispatch(key, {}));
     }
+    this.timelineSub = this.deps.mediaTimelineTransformed.onData(() => {
+      this.refreshDuration().catch(this.errorHandler);
+    });
+    this.on("sourceOpen", () => {
+      this.refreshDuration().catch(this.errorHandler);
+    });
+    this.on("sourceClose", () => {
+      this.durationSet = false;
+      ++this.durationToken;
+    });
   }
-  get duration() {
-    return this.mediaSource.duration;
-  }
-  set duration(value) {
+  /**
+   * 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.
+   */
+  async refreshDuration() {
+    const timelinePromise = this.deps.mediaTimelineTransformed.value;
+    const token = ++this.durationToken;
+    const timeline = await timelinePromise;
+    const duration = await timeline.getDuration();
+    const value = duration === Infinity ? LIVE_DURATION : duration + DURATION_PADDING;
+    await Promise.all(Array.from(this.sourceBuffers, nextSourceBufferIdle));
+    if (token !== this.durationToken || this.mediaSource.readyState !== "open" || (0, import_vinyl_util43.closeTo)(this.mediaSource.duration, value, 0.1))
+      return;
+    (0, import_vinyl_util43.logDebug)(this, `setting duration: ${value}`);
     this.mediaSource.duration = value;
+    this.durationSet = true;
+    this.checkReady();
   }
   get readyState() {
     return this.mediaSource.readyState;
   }
   createSourceBuffer(contentType2, mimeType) {
     const mediaSource = this.mediaSource;
-    (0, import_vinyl_util39.logDebug)(
+    (0, import_vinyl_util43.logDebug)(
       this,
       "create source buffer",
       contentType2,
@@ -3232,10 +3333,10 @@ var MediaSourceControllerImpl = class extends import_vinyl_util39.EventHostImpl
       throw new MediaSourceError("error creating source buffer", error);
     }
     sourceBuffer.mode = "sequence";
-    ++this.sourceBufferCount;
+    this.sourceBuffers.add(sourceBuffer);
     this.checkReady();
     const dispose = () => {
-      (0, import_vinyl_util39.logDebug)(
+      (0, import_vinyl_util43.logDebug)(
         this,
         "removing source buffer from media source",
         mediaSource.readyState
@@ -3243,7 +3344,7 @@ var MediaSourceControllerImpl = class extends import_vinyl_util39.EventHostImpl
       if (mediaSource.readyState !== "closed") {
         mediaSource.removeSourceBuffer(sourceBuffer);
       }
-      --this.sourceBufferCount;
+      this.sourceBuffers.delete(sourceBuffer);
     };
     return {
       value: sourceBuffer,
@@ -3251,7 +3352,7 @@ var MediaSourceControllerImpl = class extends import_vinyl_util39.EventHostImpl
     };
   }
   endOfStream(error) {
-    (0, import_vinyl_util39.logDebug)(this, "endOfStream, error:", error);
+    (0, import_vinyl_util43.logDebug)(this, "endOfStream, error:", error);
     this.mediaSource.endOfStream(error);
   }
   createUrl() {
@@ -3259,17 +3360,20 @@ var MediaSourceControllerImpl = class extends import_vinyl_util39.EventHostImpl
   }
   get readyToAppend() {
     var _a;
-    return ((_a = this.contentTypes) == null ? void 0 : _a.size) === this.sourceBufferCount;
+    return this.durationSet && ((_a = this.contentTypes) == null ? void 0 : _a.size) === this.sourceBufferCount;
   }
   dispose() {
+    var _a;
     super.dispose();
+    (_a = this.timelineSub) == null ? void 0 : _a.call(this);
+    this.timelineSub = null;
     this.disposer.dispose();
   }
 };
-var MediaSourceError = class _MediaSourceError extends import_vinyl_util39.ReportableError {
+var MediaSourceError = class _MediaSourceError extends import_vinyl_util43.ReportableError {
   constructor(message, reason) {
-    super(message, import_vinyl_util39.ErrorOrigin.INTERNAL, import_vinyl_util39.ErrorLevel.FATAL);
-    this.reason = reason;
+    super(message, import_vinyl_util43.ErrorOrigin.INTERNAL, import_vinyl_util43.ErrorLevel.FATAL);
+    __publicField(this, "reason", reason);
     Object.setPrototypeOf(this, _MediaSourceError.prototype);
   }
   get [Symbol.toStringTag]() {
@@ -3277,23 +3381,23 @@ var MediaSourceError = class _MediaSourceError extends import_vinyl_util39.Repor
   }
   toJSON() {
     return __spreadProps(__spreadValues({}, super.toJSON()), {
-      reason: (0, import_vinyl_util39.toJson)(this.reason)
+      reason: (0, import_vinyl_util43.toJson)(this.reason)
     });
   }
 };
 
 // src/track/dash/DashManifestController.ts
 var import_vinyl_observable2 = require("@amazon/vinyl-observable");
-var import_vinyl_util40 = require("@amazon/vinyl-util");
+var import_vinyl_util44 = require("@amazon/vinyl-util");
 var DashManifestControllerImpl = class {
   constructor(deps) {
-    this.deps = deps;
+    __publicField(this, "deps", deps);
     __publicField(this, "_data", /* @__PURE__ */ (0, import_vinyl_observable2.data)(
       /* @__PURE__ */ Promise.reject(/* @__PURE__ */ new Error("manifest not loaded"))
     ));
     __publicField(this, "_error", null);
-    __publicField(this, "abortSlot", /* @__PURE__ */ (0, import_vinyl_util40.createAbortSlot)());
-    __publicField(this, "disposer", /* @__PURE__ */ (0, import_vinyl_util40.createDisposer)());
+    __publicField(this, "abortSlot", /* @__PURE__ */ (0, import_vinyl_util44.createAbortSlot)());
+    __publicField(this, "disposer", /* @__PURE__ */ (0, import_vinyl_util44.createDisposer)());
     this._data.value.catch(() => {
     });
     this.refresh();
@@ -3316,7 +3420,7 @@ var DashManifestControllerImpl = class {
    * previous error before starting a new fetch.
    */
   refresh() {
-    (0, import_vinyl_util40.logDebug)(this, "refresh");
+    (0, import_vinyl_util44.logDebug)(this, "refresh");
     this.abort();
     this._error = null;
     const promise2 = this.deps.manifestProvider(this.abortSlot.value);
@@ -3329,7 +3433,7 @@ var DashManifestControllerImpl = class {
    * If the manifest is in an error state, triggers a refresh.
    */
   reset() {
-    (0, import_vinyl_util40.logDebug)(this, "reset");
+    (0, import_vinyl_util44.logDebug)(this, "reset");
     if (this._error) {
       this.refresh();
     }
@@ -3366,59 +3470,12 @@ var DashManifestControllerImpl = class {
 
 // src/streaming/buffering/SourceBufferController.ts
 var import_vinyl_util45 = require("@amazon/vinyl-util");
-
-// src/util/media/sourceBuffer.ts
-var import_vinyl_util43 = require("@amazon/vinyl-util");
-
-// src/streaming/buffering/error/SourceBufferError.ts
-var import_vinyl_util41 = require("@amazon/vinyl-util");
-var import_vinyl_util42 = require("@amazon/vinyl-util");
-var SourceBufferError = class _SourceBufferError extends import_vinyl_util42.ReportableError {
-  get [Symbol.toStringTag]() {
-    return "SourceBufferError";
-  }
-  constructor(message = `A SourceBuffer error has occurred.`, origin = import_vinyl_util41.ErrorOrigin.MEDIA) {
-    super(message, origin);
-    Object.setPrototypeOf(this, _SourceBufferError.prototype);
-  }
-};
-
-// src/util/media/sourceBuffer.ts
-var import_vinyl_util44 = require("@amazon/vinyl-util");
-function nextSourceBufferIdle(sourceBuffer) {
-  if (!sourceBuffer) return Promise.resolve();
-  if (!sourceBuffer.updating) return Promise.resolve();
-  return (0, import_vinyl_util43.promise)((resolve, reject) => {
-    const removeListeners = () => {
-      sourceBuffer.removeEventListener("error", onErred);
-      sourceBuffer.removeEventListener("abort", onAborted);
-      sourceBuffer.removeEventListener("update", onEnded);
-    };
-    const onEnded = () => {
-      removeListeners();
-      resolve();
-    };
-    const onErred = (_event) => {
-      removeListeners();
-      reject(new SourceBufferError());
-    };
-    const onAborted = () => {
-      removeListeners();
-      reject(new import_vinyl_util44.AbortError());
-    };
-    sourceBuffer.addEventListener("error", onErred);
-    sourceBuffer.addEventListener("abort", onAborted);
-    sourceBuffer.addEventListener("update", onEnded);
-  });
-}
-
-// src/streaming/buffering/SourceBufferController.ts
 var APPEND_WINDOW_START_OFFSET = 0.05;
 var APPEND_WINDOW_END_OFFSET = 0.01;
 var READY_TO_APPEND_TIMEOUT = 30;
 var SourceBufferControllerImpl = class {
   constructor(deps, contentType2) {
-    this.contentType = contentType2;
+    __publicField(this, "contentType", contentType2);
     __publicField(this, "sourceBufferRef", null);
     __publicField(this, "mimeType", null);
     __publicField(this, "queue", /* @__PURE__ */ (0, import_vinyl_util45.createTaskQueue)());
@@ -3575,7 +3632,6 @@ var import_vinyl_util46 = require("@amazon/vinyl-util");
 var SEGMENT_START_AFFORDANCE = 0.2;
 
 // src/streaming/buffering/BufferingController.ts
-var DURATION_PADDING = 0.1;
 var POLL_BUFFER_THROTTLE = 0.1;
 var QUOTA_REACHED_SCALE = 0.8;
 var MIN_APPEND_SIZE = 524288;
@@ -3600,8 +3656,8 @@ var defaultBufferingControllerOptions = {
 var BufferingControllerImpl = class extends import_vinyl_util46.EventHostImpl {
   constructor(deps, contentType2, options) {
     super();
-    this.deps = deps;
-    this.contentType = contentType2;
+    __publicField(this, "deps", deps);
+    __publicField(this, "contentType", contentType2);
     __publicField(this, "options");
     __publicField(this, "mediaSourceController");
     __publicField(this, "playbackController");
@@ -3737,7 +3793,6 @@ var BufferingControllerImpl = class extends import_vinyl_util46.EventHostImpl {
     );
     const onMediaSourceOpen2 = () => {
       (0, import_vinyl_util46.logDebug)(this, "media source opened");
-      this.refreshDuration();
       this.pollBufferImmediate();
     };
     if (this.mediaSourceOpen) {
@@ -3748,7 +3803,6 @@ var BufferingControllerImpl = class extends import_vinyl_util46.EventHostImpl {
     add(
       this.segmentController.on("change", () => {
         this.reopen = true;
-        this.refreshDuration();
         this.pollBufferImmediate();
       })
     );
@@ -3778,18 +3832,6 @@ var BufferingControllerImpl = class extends import_vinyl_util46.EventHostImpl {
   get busy() {
     return this.queue.running > 0;
   }
-  /**
-   * Enqueues a duration update.
-   */
-  refreshDuration() {
-    this.sourceBufferController.enqueue(async () => {
-      if (!this.mediaSourceOpen) return;
-      const duration = await this.segmentController.getDuration();
-      const newDuration = duration == null ? LIVE_DURATION : duration + DURATION_PADDING;
-      (0, import_vinyl_util46.logDebug)(this, `setting duration: ${newDuration}`);
-      this.mediaSourceController.duration = newDuration;
-    }).catch(this.handleError);
-  }
   shouldAppend() {
     return this.active && !this.busy && !this.error && !this.mediaSourceClosed && (!this.bufferingEnded || this.reopen) && // Return true if the current buffer is less than the minimum buffer and the playhead has not reached duration.
     this.getBufferedTime() <= this.options.minBuffer;
@@ -4021,7 +4063,7 @@ var SegmentStatus = /* @__PURE__ */ ((SegmentStatus2) => {
 })(SegmentStatus || {});
 var SegmentDataSlot = class {
   constructor(requestSegmentData) {
-    this.requestSegmentData = requestSegmentData;
+    __publicField(this, "requestSegmentData", requestSegmentData);
     /**
      * Called when the status has changed.
      */
@@ -4154,8 +4196,8 @@ var defaultSegmentControllerBaseOptions = {
 var SegmentControllerImpl = class extends import_vinyl_util50.EventHostImpl {
   constructor(deps, contentType2, options) {
     super();
-    this.deps = deps;
-    this.contentType = contentType2;
+    __publicField(this, "deps", deps);
+    __publicField(this, "contentType", contentType2);
     __publicField(this, "_active", false);
     __publicField(this, "_fetchedRanges", /* @__PURE__ */ new import_vinyl_util50.RangesImpl());
     __publicField(this, "_startTime", 0);
@@ -4259,14 +4301,6 @@ var SegmentControllerImpl = class extends import_vinyl_util50.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 last4 = periods[periods.length - 1];
-    return last4.endTime === Infinity ? null : last4.endTime;
-  }
   /**
    * Gets the period at the given time, using a cache for the last returned period.
    */
@@ -4659,7 +4693,8 @@ var qualitySelectorImplOptionsValidator = /* @__PURE__ */ (0, import_vinyl_valid
   strategy: /* @__PURE__ */ (0, import_vinyl_validation12.enumOf)(AbrStrategy).optional(),
   bandwidthMultiplierLow: /* @__PURE__ */ (0, import_vinyl_validation12.number)().optional(),
   bandwidthMultiplierHigh: /* @__PURE__ */ (0, import_vinyl_validation12.number)().optional(),
-  restrictDecoderChangeOnAudioAbrUp: /* @__PURE__ */ (0, import_vinyl_validation12.boolean)().optional()
+  restrictDecoderChangeOnAudioAbrUp: /* @__PURE__ */ (0, import_vinyl_validation12.boolean)().optional(),
+  maxBandwidth: /* @__PURE__ */ (0, import_vinyl_validation12.number)().maybe().optional()
 });
 var defaultQualitySelectorImplOptions = {
   highBufferThreshold: 15,
@@ -4667,7 +4702,8 @@ var defaultQualitySelectorImplOptions = {
   strategy: "best" /* BEST */,
   bandwidthMultiplierLow: 0.4,
   bandwidthMultiplierHigh: 0.9,
-  restrictDecoderChangeOnAudioAbrUp: false
+  restrictDecoderChangeOnAudioAbrUp: false,
+  maxBandwidth: null
 };
 var QualitySelectorImpl = class {
   constructor(deps) {
@@ -4694,7 +4730,8 @@ var QualitySelectorImpl = class {
       lowBufferThreshold,
       bandwidthMultiplierLow,
       bandwidthMultiplierHigh,
-      restrictDecoderChangeOnAudioAbrUp
+      restrictDecoderChangeOnAudioAbrUp,
+      maxBandwidth
     } = this.options;
     const previousQuality = prefetchState.previousQuality;
     const previousIndex = previousQuality == null ? -1 : qualities.findIndex(
@@ -4711,7 +4748,10 @@ var QualitySelectorImpl = class {
     const bandwidthEstimate = (0, import_vinyl_util52.getNetworkMetrics)().estimatedDownlinkBandwidth;
     const bufferRatio = highBufferThreshold > 0 ? (0, import_vinyl_util52.clamp)(fetchedTime / highBufferThreshold, 0, 1) : 1;
     const bandwidthMultiplier = prefetchState.active ? (0, import_vinyl_util52.lerp)(bandwidthMultiplierLow, bandwidthMultiplierHigh, bufferRatio) : bandwidthMultiplierHigh;
-    const bandwidth = (prefetchState.active ? Math.min(bandwidthEstimate.ewmaLow, bandwidthEstimate.latest) : bandwidthEstimate.ewmaLow) * bandwidthMultiplier;
+    let bandwidth = (prefetchState.active ? Math.min(bandwidthEstimate.ewmaLow, bandwidthEstimate.latest) : bandwidthEstimate.ewmaLow) * bandwidthMultiplier;
+    if (maxBandwidth != null && maxBandwidth < bandwidth) {
+      bandwidth = maxBandwidth;
+    }
     let restrictDecoderId = null;
     let restrictSwitchingGroupIds = null;
     if (previousQuality && previousIndex >= 0) {
@@ -4794,7 +4834,7 @@ var import_vinyl_di3 = require("@amazon/vinyl-di");
 var ContentStreamImpl = class extends import_vinyl_util56.EventHostImpl {
   constructor(dependencyFactories, contentType2) {
     super();
-    this.contentType = contentType2;
+    __publicField(this, "contentType", contentType2);
     __publicField(this, "disposer", /* @__PURE__ */ (0, import_vinyl_util56.createDisposer)());
     __publicField(this, "segmentController");
     __publicField(this, "bufferingController");
@@ -5756,7 +5796,7 @@ var import_vinyl_observable4 = require("@amazon/vinyl-observable");
 var import_vinyl_util65 = require("@amazon/vinyl-util");
 var HlsManifestControllerImpl = class {
   constructor(manifestProvider) {
-    this.manifestProvider = manifestProvider;
+    __publicField(this, "manifestProvider", manifestProvider);
     __publicField(this, "_data", /* @__PURE__ */ (0, import_vinyl_observable4.data)(
       /* @__PURE__ */ Promise.reject(/* @__PURE__ */ new Error("manifest not loaded"))
     ));
@@ -6060,17 +6100,21 @@ function buildHlsMediaTimeline(deps, data4) {
     minBufferTime: DEFAULT_MIN_BUFFER_TIME,
     async getDuration() {
       if (cachedDuration != null) return cachedDuration;
-      if (mainPlaylist.variants.length === 0) return null;
-      try {
-        const playlist = await data4.getMediaPlaylist(
-          mainPlaylist.variants[0].uri
+      if (mainPlaylist.variants.length === 0) {
+        throw new Error("Unable to determine HLS duration: no variants");
+      }
+      const playlist = await data4.getMediaPlaylist(
+        mainPlaylist.variants[0].uri
+      );
+      if (!playlist.ended) return Infinity;
+      if (playlist.segments.length === 0) {
+        throw new Error(
+          "Unable to determine HLS duration: no segments in media playlist"
         );
-        let total = 0;
-        for (const seg of playlist.segments) total += seg.duration;
-        cachedDuration = total > 0 ? total : null;
-      } catch (e) {
-        return null;
       }
+      let total = 0;
+      for (const seg of playlist.segments) total += seg.duration;
+      cachedDuration = total;
       return cachedDuration;
     }
   };
@@ -6117,10 +6161,10 @@ var import_vinyl_util70 = require("@amazon/vinyl-util");
 var CommonMediaKeySessionError = class _CommonMediaKeySessionError extends import_vinyl_util70.ReportableError {
   constructor(code, codeStr, systemCode, systemCodeStr) {
     super(codeStr, import_vinyl_util70.ErrorOrigin.DRM, import_vinyl_util70.ErrorLevel.WARN);
-    this.code = code;
-    this.codeStr = codeStr;
-    this.systemCode = systemCode;
-    this.systemCodeStr = systemCodeStr;
+    __publicField(this, "code", code);
+    __publicField(this, "codeStr", codeStr);
+    __publicField(this, "systemCode", systemCode);
+    __publicField(this, "systemCodeStr", systemCodeStr);
     Object.setPrototypeOf(this, _CommonMediaKeySessionError.prototype);
   }
   get [Symbol.toStringTag]() {
@@ -6151,10 +6195,10 @@ var import_vinyl_util72 = require("@amazon/vinyl-util");
 var DrmError = class _DrmError extends import_vinyl_util72.ReportableError {
   constructor(message, extra = null, origin = import_vinyl_util71.ErrorOrigin.DRM, level = import_vinyl_util72.ErrorLevel.FATAL) {
     super(message, origin, level);
-    this.message = message;
-    this.extra = extra;
-    this.origin = origin;
-    this.level = level;
+    __publicField(this, "message", message);
+    __publicField(this, "extra", extra);
+    __publicField(this, "origin", origin);
+    __publicField(this, "level", level);
     Object.setPrototypeOf(this, _DrmError.prototype);
   }
   get [Symbol.toStringTag]() {
@@ -6204,7 +6248,7 @@ var MsCommonEme = class {
 };
 var MsCommonMediaKeySystemAccess = class {
   constructor(keySystem) {
-    this.keySystem = keySystem;
+    __publicField(this, "keySystem", keySystem);
   }
   createMediaKeys() {
     const msMediaKeys = new MSMediaKeys(this.keySystem);
@@ -6215,8 +6259,8 @@ var MsCommonMediaKeySystemAccess = class {
 };
 var MsCommonMediaKeys = class {
   constructor(keySystem, mediaKeys) {
-    this.keySystem = keySystem;
-    this.mediaKeys = mediaKeys;
+    __publicField(this, "keySystem", keySystem);
+    __publicField(this, "mediaKeys", mediaKeys);
   }
   /**
    * Sets the media keys on the given element.
@@ -6251,10 +6295,10 @@ var MsCommonMediaKeys = class {
 var MsCommonMediaKeySession = class extends import_vinyl_util73.EventHostImpl {
   constructor(session, mimeType, initDataType, initData) {
     super();
-    this.session = session;
-    this.mimeType = mimeType;
-    this.initDataType = initDataType;
-    this.initData = initData;
+    __publicField(this, "session", session);
+    __publicField(this, "mimeType", mimeType);
+    __publicField(this, "initDataType", initDataType);
+    __publicField(this, "initData", initData);
     __publicField(this, "_disposed", false);
     __publicField(this, "messageHandler", (event) => {
       this.dispatch("message", {
@@ -6339,8 +6383,8 @@ var StandardCommonEme = class {
 };
 var StandardCommonMediaKeySystemAccess = class {
   constructor(keySystem, access) {
-    this.keySystem = keySystem;
-    this.access = access;
+    __publicField(this, "keySystem", keySystem);
+    __publicField(this, "access", access);
   }
   /**
    * @return {Promise<CommonMediaKeys>}
@@ -6352,8 +6396,8 @@ var StandardCommonMediaKeySystemAccess = class {
 };
 var StandardCommonMediaKeys = class {
   constructor(keySystem, mediaKeys) {
-    this.keySystem = keySystem;
-    this.mediaKeys = mediaKeys;
+    __publicField(this, "keySystem", keySystem);
+    __publicField(this, "mediaKeys", mediaKeys);
   }
   setOnElement(element2) {
     return element2.setMediaKeys(this.mediaKeys);
@@ -6376,10 +6420,10 @@ var StandardCommonMediaKeys = class {
 var StandardCommonMediaKeySession = class extends import_vinyl_util75.EventHostImpl {
   constructor(session, mimeType, initDataType, initData) {
     super();
-    this.session = session;
-    this.mimeType = mimeType;
-    this.initDataType = initDataType;
-    this.initData = initData;
+    __publicField(this, "session", session);
+    __publicField(this, "mimeType", mimeType);
+    __publicField(this, "initDataType", initDataType);
+    __publicField(this, "initData", initData);
     __publicField(this, "_disposed", false);
     __publicField(this, "messageHandler", (event) => {
       this.dispatch("message", {
@@ -6462,7 +6506,7 @@ var WebKitCommonEme = class {
 };
 var WebKitCommonMediaKeySystemAccess = class {
   constructor(keySystem) {
-    this.keySystem = keySystem;
+    __publicField(this, "keySystem", keySystem);
   }
   createMediaKeys() {
     const webKitMediaKeys = new WebKitMediaKeys(this.keySystem);
@@ -6475,8 +6519,8 @@ var WebKitCommonMediaKeySystemAccess = class {
 };
 var WebKitCommonMediaKeys = class {
   constructor(keySystem, mediaKeys) {
-    this.keySystem = keySystem;
-    this.mediaKeys = mediaKeys;
+    __publicField(this, "keySystem", keySystem);
+    __publicField(this, "mediaKeys", mediaKeys);
   }
   /**
    * Sets the media keys on the given element.
@@ -6511,10 +6555,10 @@ var WebKitCommonMediaKeys = class {
 var WebKitCommonMediaKeySession = class extends import_vinyl_util76.EventHostImpl {
   constructor(session, mimeType, initDataType, initData) {
     super();
-    this.session = session;
-    this.mimeType = mimeType;
-    this.initDataType = initDataType;
-    this.initData = initData;
+    __publicField(this, "session", session);
+    __publicField(this, "mimeType", mimeType);
+    __publicField(this, "initDataType", initDataType);
+    __publicField(this, "initData", initData);
     __publicField(this, "_disposed", false);
     __publicField(this, "messageHandler", (event) => {
       this.dispatch("message", {
@@ -6737,7 +6781,7 @@ var LICENSE_TIMEOUT_MESSAGE = "License provider timed out after {time}s";
 var DrmControllerImpl = class extends import_vinyl_util84.EventHostImpl {
   constructor(deps, options) {
     super();
-    this.deps = deps;
+    __publicField(this, "deps", deps);
     __publicField(this, "optionsBase");
     __publicField(this, "options");
     __publicField(this, "mediaKeys", null);
@@ -7265,7 +7309,7 @@ var MAX_GAIN_LEVEL = 1;
 var LoudnessNormalizationControllerImpl = class extends import_vinyl_util86.EventHostImpl {
   constructor(deps) {
     super();
-    this.deps = deps;
+    __publicField(this, "deps", deps);
     __publicField(this, "logPrefix", /* @__PURE__ */ (0, import_vinyl_util86.createLogPrefix)(this));
     __publicField(this, "_gain", MAX_GAIN_LEVEL);
     __publicField(this, "disposer", /* @__PURE__ */ (0, import_vinyl_util85.createDisposer)());
@@ -7350,7 +7394,7 @@ var defaultResetControllerOptions = {
 var AutoResetControllerImpl = class extends import_vinyl_util87.EventHostImpl {
   constructor(deps, options) {
     super();
-    this.deps = deps;
+    __publicField(this, "deps", deps);
     __publicField(this, "options");
     __publicField(this, "_error", null);
     __publicField(this, "watchSub", null);
@@ -7374,38 +7418,50 @@ var AutoResetControllerImpl = class extends import_vinyl_util87.EventHostImpl {
   }
   setError(error) {
     if (!this.options.enabled || this._error) return;
-    if (error instanceof import_vinyl_util87.ReportableError && error.origin === import_vinyl_util87.ErrorOrigin.SERVICE_INTERNAL) {
+    if (error instanceof import_vinyl_util87.RequestError && error.response == null) {
       this._error = error;
-      this.setWatching(true);
+      this.setResetPending(true);
     }
   }
-  setWatching(value) {
+  get resetPending() {
+    return this.watchSub != null;
+  }
+  setResetPending(value) {
     var _a;
-    (0, import_vinyl_util87.logDebug)(this, "setWatching", value);
+    if (this.resetPending === value) {
+      (0, import_vinyl_util87.logDebug)(this, "setResetPending", value, "no-op");
+      return;
+    }
+    (0, import_vinyl_util87.logDebug)(this, "setResetPending", value);
     (_a = this.watchSub) == null ? void 0 : _a.call(this);
     this.watchSub = null;
-    if (!value) return;
-    const networkState = (0, import_vinyl_util87.getNetworkState)();
-    const { add, dispose: watchSub } = (0, import_vinyl_util87.createDisposer)();
-    this.watchSub = watchSub;
-    add(
-      networkState.on("online", () => {
-        (0, import_vinyl_util87.logDebug)(this, "online, emitting reset");
-        this.reset();
-      })
-    );
-    const intervalId = setTimeout(() => {
-      if (this.currentRetry++ < this.options.maxRetries) {
-        if (networkState.onLine) {
-          (0, import_vinyl_util87.logDebug)(this, "interval, emitting reset");
+    if (value) {
+      const networkState = (0, import_vinyl_util87.getNetworkState)();
+      const { add, dispose: watchSub } = (0, import_vinyl_util87.createDisposer)();
+      this.watchSub = watchSub;
+      add(
+        networkState.on("online", () => {
+          (0, import_vinyl_util87.logDebug)(this, "online, emitting reset");
           this.reset();
+        })
+      );
+      const intervalId = setTimeout(() => {
+        if (this.currentRetry++ < this.options.maxRetries) {
+          if (networkState.onLine) {
+            (0, import_vinyl_util87.logDebug)(this, "interval, emitting reset");
+            this.reset();
+          }
+        } else {
+          (0, import_vinyl_util87.logDebug)(this, "max retries exhausted, pausing playback");
+          this.setResetPending(false);
         }
-      } else {
-        (0, import_vinyl_util87.logDebug)(this, "max retries exhausted, pausing playback");
-        this.setWatching(false);
-      }
-    }, this.options.retryInterval * 1e3);
-    add(() => clearTimeout(intervalId));
+      }, this.options.retryInterval * 1e3);
+      add(() => clearTimeout(intervalId));
+    }
+    this.dispatch("resetPendingChange", {
+      previous: !value,
+      current: value
+    });
   }
   reset() {
     if (!this._error) return;
@@ -7415,7 +7471,7 @@ var AutoResetControllerImpl = class extends import_vinyl_util87.EventHostImpl {
   clear() {
     if (!this._error) return;
     this._error = null;
-    this.setWatching(false);
+    this.setResetPending(false);
   }
   get disposed() {
     return this.disposer.disposed;
@@ -7488,7 +7544,7 @@ var locale2 = {
 var DEFAULT_MAX_PLAYERS = 5;
 var PlayerRegistryImpl = class {
   constructor(maxPlayersWarning = DEFAULT_MAX_PLAYERS) {
-    this.maxPlayersWarning = maxPlayersWarning;
+    __publicField(this, "maxPlayersWarning", maxPlayersWarning);
     __publicField(this, "_players", []);
     __publicField(this, "gaveMaxPlayersWarning", false);
   }
@@ -7533,7 +7589,7 @@ var import_vinyl_util91 = require("@amazon/vinyl-util");
 var import_vinyl_util90 = require("@amazon/vinyl-util");
 var vinylVersion = /* @__PURE__ */ (0, import_vinyl_util90.parseVersion)(
   /* istanbul ignore next */
-  "1.1.1"
+  "1.2.0"
 );
 
 // src/global/globalRef.ts
@@ -7636,6 +7692,9 @@ var VinylPlayer = class extends import_vinyl_util93.EventHostImpl {
   get trackController() {
     return this.deps.trackController;
   }
+  get autoResetController() {
+    return this.deps.autoResetController;
+  }
   redispatchSubControllerEvents() {
     const add = this.disposer.add;
     add(
@@ -7712,11 +7771,16 @@ var VinylPlayer = class extends import_vinyl_util93.EventHostImpl {
   }
   initializeAutoResetHandling() {
     const { add } = this.disposer;
-    const { autoResetController } = this.deps;
     this.on("error", (event) => {
-      autoResetController.setError(event.error);
+      this.autoResetController.setError(event.error);
     });
-    add(autoResetController.on("reset", () => this.reset()));
+    add(this.autoResetController.on("reset", () => this.reset()));
+    add(
+      this.autoResetController.on(
+        "resetPendingChange",
+        (event) => this.dispatch("resetPendingChange", event)
+      )
+    );
   }
   initializePreferredLanguageHandling() {
     const { add } = this.disposer;
@@ -7787,6 +7851,17 @@ var VinylPlayer = class extends import_vinyl_util93.EventHostImpl {
   get error() {
     return this._error;
   }
+  /**
+   * True when an error has interrupted playback and an automatic reset
+   * is scheduled. This distinguishes transient, potentially recoverable
+   * errors (such as a brief network outage) from terminal errors that
+   * will not trigger a reset on their own.
+   *
+   * Listen to `resetPendingChange` events for changes.
+   */
+  get resetPending() {
+    return this.autoResetController.resetPending;
+  }
   get hasMetadata() {
     return this.playbackController.hasMetadata;
   }
@@ -7863,6 +7938,7 @@ var VinylPlayer = class extends import_vinyl_util93.EventHostImpl {
     this.drmController.reset();
     this.playbackController.reset();
     this.trackController.reset();
+    this.autoResetController.clear();
     this.dispatch("reset", {});
   }
   //----------------------------------------------------