@amazon/vinyl 3.1.0 → 3.2.1

package/dist/index.cjs

@@ -84,6 +84,7 @@ __export(index_exports, {
   MsCommonMediaKeySystemAccess: () => MsCommonMediaKeySystemAccess,
   MsCommonMediaKeys: () => MsCommonMediaKeys,
   MseTrack: () => MseTrack,
+  PLAYOUT_LIMIT_TOLERANCE: () => PLAYOUT_LIMIT_TOLERANCE,
   PLAY_READY_KEY_SYSTEMS: () => PLAY_READY_KEY_SYSTEMS,
   POLL_BUFFER_THROTTLE: () => POLL_BUFFER_THROTTLE,
   PREFETCH_POLL_THROTTLE: () => PREFETCH_POLL_THROTTLE,
@@ -353,6 +354,7 @@ var AdError = class _AdError extends import_vinyl_util.ReportableError {
 
 // src/ad/AdControllerImpl.ts
 var AD_START_TOLERANCE = 0.05;
+var PLAYOUT_LIMIT_TOLERANCE = 1;
 var defaultAdControllerImplOptions = {
   adLoadTimeout: 15,
   preloadAheadTime: 10
@@ -843,23 +845,29 @@ var AdControllerImpl = class extends import_vinyl_util2.EventHostImpl {
     });
   }
   /**
-   * Ads breaks can have a playout limit that may cut off ad playback.
-   * End the ad if that limit is reached.
+   * Enforces the break-level playout limit (X-PLAYOUT-LIMIT): a budget shared
+   * across all of the break's ads. When cumulative playout reaches it, the
+   * whole break ends, dropping any ads that have not started.
+   *
+   * This is deliberately NOT a per-ad cap. Each ad asset is its own source and
+   * ends on its media `ended` (see the 'ended' handler), which is what advances
+   * a multi-ad break. Ending an ad at its declared per-ad DURATION instead would
+   * truncate the real asset whenever a packager under-declares it — e.g. rounds
+   * a 6.732s asset down to a whole-second 6 — cutting off the fractional tail.
    */
   enforcePlayoutLimits(adState) {
+    if (!adState.started) return;
+    const { parentBreak } = adState;
+    const limit = parentBreak.adBreak.playoutLimit;
+    if (limit == null) return;
     const pC = this.deps.playbackController;
-    const { ad, parentBreak } = adState;
-    if (adState.started) {
-      const elapsed = Math.max(0, pC.currentTime - adState.timeStart);
-      const adBreak = parentBreak.adBreak;
-      const limit = adBreak.playoutLimit;
-      if (limit != null && parentBreak.playoutElapsed + elapsed >= limit) {
-        parentBreak.clear();
-        this.endAd(adState);
-      } else if (ad.duration != null && elapsed >= ad.duration) {
-        this.endAd(adState);
-      }
+    const elapsed = Math.max(0, pC.currentTime - adState.timeStart);
+    if (parentBreak.playoutElapsed + elapsed < limit) return;
+    if (isFinite(pC.duration) && pC.duration > 0 && pC.duration - pC.currentTime <= PLAYOUT_LIMIT_TOLERANCE) {
+      return;
     }
+    parentBreak.clear();
+    this.endAd(adState);
   }
   setPendingBreaks(newPending) {
     this.pendingAdBreaks = newPending.filter(
@@ -2104,6 +2112,10 @@ var DrmControllerImpl = class extends import_vinyl_util24.EventHostImpl {
     __publicField(this, "bufferingTrackUri", null);
     __publicField(this, "sessionAbort", null);
     __publicField(this, "pendingMessageProps", null);
+    // Armed per track load; latches on the first session so only the
+    // critical-path session's EME/CDM setup is measured.
+    __publicField(this, "keySetupSpanArmed", true);
+    __publicField(this, "keySetupSpanStart", null);
     __publicField(this, "disposer", /* @__PURE__ */ (0, import_vinyl_util24.createDisposer)());
     __publicField(this, "checkIsSupportedCached", /* @__PURE__ */ (0, import_vinyl_util24.memoize)(
       async (params) => {
@@ -2269,6 +2281,7 @@ var DrmControllerImpl = class extends import_vinyl_util24.EventHostImpl {
     if (!hasMimeType(drmInfo)) {
       throw new DrmError("Encrypted content must have a mimeType.");
     }
+    this.markKeySetupStart();
     const mediaKeys = await this.attachMediaKeys(drmInfo);
     this.abortIfDisposed();
     const keySystemOptions = (_a = this.options.keySystems[mediaKeys.keySystem]) != null ? _a : this.options.keySystems["*"];
@@ -2313,6 +2326,28 @@ var DrmControllerImpl = class extends import_vinyl_util24.EventHostImpl {
     });
     return newSession;
   }
+  /**
+   * Captures the key-setup span start at the top of the session-creation path
+   * (before media keys are attached), latching so only the first session of
+   * the current track load is measured.
+   */
+  markKeySetupStart() {
+    if (!this.keySetupSpanArmed) return;
+    this.keySetupSpanArmed = false;
+    this.keySetupSpanStart = Date.now();
+  }
+  dispatchLoadSpan(kind, startTime, endTime, messageProps) {
+    this.dispatch("loadSpanMeasured", __spreadValues(__spreadValues({
+      kind,
+      startTime,
+      endTime,
+      mimeType: messageProps.mimeType
+    }, messageProps.trackUri != null && {
+      trackUri: messageProps.trackUri
+    }), messageProps.contentType != null && {
+      contentType: messageProps.contentType
+    }));
+  }
   initializeForPlayback(drmInfo, options) {
     var _a;
     (0, import_vinyl_util24.logDebug)(this, "initializeForPlayback", drmInfo);
@@ -2336,6 +2371,8 @@ var DrmControllerImpl = class extends import_vinyl_util24.EventHostImpl {
     this.drmInfo = drmInfo;
     this.bufferingTrackUri = (_a = options == null ? void 0 : options.trackUri) != null ? _a : null;
     this.sessionAbort = (_b = options == null ? void 0 : options.abort) != null ? _b : null;
+    this.keySetupSpanArmed = true;
+    this.keySetupSpanStart = null;
   }
   /**
    * If the drm metadata contains initialization data for the current key system, create a new session.
@@ -2347,6 +2384,7 @@ var DrmControllerImpl = class extends import_vinyl_util24.EventHostImpl {
       this.handleError(new DrmError("DRM not supported."));
       return;
     }
+    this.markKeySetupStart();
     const mediaKeys = await this.attachMediaKeys(drmInfo);
     const drmProtection = (_a = drmInfo.contentProtections.find((cP) => {
       return cP.keySystem === mediaKeys.keySystem;
@@ -2485,7 +2523,9 @@ var DrmControllerImpl = class extends import_vinyl_util24.EventHostImpl {
           event,
           // Captured per session, so a concurrent preloaded track's
           // license exchange keeps its own attribution.
-          trackUri
+          trackUri,
+          mimeType: drmInfo.mimeType,
+          contentType: drmInfo.contentType
         }),
         LICENSE_TIMEOUT,
         { message: LICENSE_TIMEOUT_MESSAGE }
@@ -2507,6 +2547,15 @@ var DrmControllerImpl = class extends import_vinyl_util24.EventHostImpl {
     this.pendingMessageProps = messageProps;
     const keySystem = mediaKeys.keySystem;
     (0, import_vinyl_util24.logDebug)(this, "message", keySystem, event.message.byteLength);
+    if (this.keySetupSpanStart != null) {
+      this.dispatchLoadSpan(
+        "keySetup",
+        this.keySetupSpanStart,
+        Date.now(),
+        messageProps
+      );
+      this.keySetupSpanStart = null;
+    }
     const keySystemOptions = (_a = this.options.keySystems[keySystem]) != null ? _a : this.options.keySystems["*"];
     const licenseServerOptionsProvider = keySystemOptions == null ? void 0 : keySystemOptions.licenseServer;
     const licenseServerOptions = (_b = (0, import_vinyl_util24.clone)(await (0, import_vinyl_util24.resolveValueProvider)(licenseServerOptionsProvider))) != null ? _b : {};
@@ -2528,13 +2577,12 @@ var DrmControllerImpl = class extends import_vinyl_util24.EventHostImpl {
       challenge
     );
     if (this.disposed) return;
-    this.dispatch("loadSpanMeasured", __spreadValues({
-      kind: "license",
-      startTime: licenseSpanStart,
-      endTime: Date.now()
-    }, messageProps.trackUri != null && {
-      trackUri: messageProps.trackUri
-    }));
+    this.dispatchLoadSpan(
+      "license",
+      licenseSpanStart,
+      Date.now(),
+      messageProps
+    );
     this.pendingMessageProps = null;
     if (session.disposed) return;
     (0, import_vinyl_util24.logDebug)(this, "update");
@@ -2777,7 +2825,7 @@ function configureVinylGlobal(options) {
 var import_vinyl_util27 = require("@amazon/vinyl-util");
 var vinylVersion = /* @__PURE__ */ (0, import_vinyl_util27.parseVersion)(
   /* istanbul ignore next */
-  "3.1.0"
+  "3.2.1"
 );
 
 // src/global/globalRef.ts
@@ -2976,6 +3024,7 @@ var PlaybackNetworkState = /* @__PURE__ */ ((PlaybackNetworkState2) => {
 })(PlaybackNetworkState || {});
 
 // src/playback/createStallMonitor.ts
+var PROGRESS_EPSILON = 1e-6;
 function createStallMonitor(controller, callbacks, options = {}) {
   var _a, _b;
   const stallThresholdMs = ((_a = options.stallThreshold) != null ? _a : 1) * 1e3;
@@ -2984,6 +3033,7 @@ function createStallMonitor(controller, callbacks, options = {}) {
   let lastProgressAt = Date.now();
   let inStall = false;
   let pollId = null;
+  const { add, dispose } = (0, import_vinyl_util30.createDisposer)();
   const endStall = (reason) => {
     if (!inStall) return;
     inStall = false;
@@ -3000,6 +3050,7 @@ function createStallMonitor(controller, callbacks, options = {}) {
     clearInterval(pollId);
     pollId = null;
   };
+  add(stopPoll);
   const startPoll = () => {
     if (pollId != null) return;
     pollId = setInterval(() => {
@@ -3015,17 +3066,18 @@ function createStallMonitor(controller, callbacks, options = {}) {
     observedPlaying = false;
     stopPoll();
   };
-  const { add, dispose } = (0, import_vinyl_util30.createDisposer)();
   add(
     controller.on("playing", () => {
       if (inStall) endStall("playing" /* PLAYING */);
-      else lastProgressAt = Date.now();
+      lastProgressAt = Date.now();
       observedPlaying = true;
       startPoll();
     })
   );
   add(
-    controller.on("timeUpdate", () => {
+    controller.on("timeUpdate", ({ previous, current }) => {
+      if (previous != null && current - previous <= PROGRESS_EPSILON)
+        return;
       if (inStall) endStall("playing" /* PLAYING */);
       lastProgressAt = Date.now();
     })
@@ -3033,13 +3085,7 @@ function createStallMonitor(controller, callbacks, options = {}) {
   add(controller.on("pause", () => suspend("pause" /* PAUSE */)));
   add(controller.on("seeking", () => suspend("seeking" /* SEEKING */)));
   add(controller.on("emptied", () => suspend("emptied" /* EMPTIED */)));
-  let stopped = false;
-  return () => {
-    if (stopped) return;
-    stopped = true;
-    stopPoll();
-    dispose();
-  };
+  return dispose;
 }
 
 // src/playback/error/InvalidSeekError.ts
@@ -5108,16 +5154,102 @@ function filterContentTypes(contentTypes, allowedContentTypes) {
 // src/streaming/createDefaultMediaTimelineTransformer.ts
 var import_vinyl_observable2 = require("@amazon/vinyl-observable");
 
+// src/streaming/MediaQualityMetadata.ts
+var import_vinyl_util53 = require("@amazon/vinyl-util");
+var import_vinyl_validation10 = require("@amazon/vinyl-validation");
+
+// src/streaming/DescriptorRecord.ts
+var import_vinyl_validation9 = require("@amazon/vinyl-validation");
+var import_vinyl_util52 = require("@amazon/vinyl-util");
+function getDescriptorValue(record4, uri, id) {
+  var _a, _b;
+  let arr = record4[uri];
+  if (!arr) return null;
+  if (id !== void 0) arr = arr.filter((descriptor) => descriptor.id === id);
+  return (_b = (_a = (0, import_vinyl_util52.first)(arr)) == null ? void 0 : _a.value) != null ? _b : null;
+}
+var descriptorValidator = /* @__PURE__ */ (0, import_vinyl_validation9.object)({
+  id: /* @__PURE__ */ (0, import_vinyl_validation9.string)().maybe().optional(),
+  value: /* @__PURE__ */ (0, import_vinyl_validation9.string)().maybe().optional()
+});
+var descriptorRecordValidator = /* @__PURE__ */ (0, import_vinyl_validation9.record)(/* @__PURE__ */ (0, import_vinyl_validation9.string)(), /* @__PURE__ */ (0, import_vinyl_validation9.array)(descriptorValidator).readonly().orUndefined());
+
+// src/streaming/MediaQualityMetadata.ts
+var ALL_CONTENT_TYPES = [
+  "video",
+  "audio",
+  "text"
+];
+var RESTRICTABLE_CONTENT_TYPES = [
+  "video",
+  "audio"
+];
+var drmProtectionValidator = /* @__PURE__ */ descriptorValidator.extend({
+  keySystem: /* @__PURE__ */ (0, import_vinyl_validation10.enumOf)(DrmKeySystem),
+  pro: /* @__PURE__ */ (0, import_vinyl_validation10.string)().maybe().optional(),
+  pssh: /* @__PURE__ */ (0, import_vinyl_validation10.string)().maybe().optional()
+});
+var mediaFormatMetadataValidator = /* @__PURE__ */ (0, import_vinyl_validation10.object)({
+  contentProtections: /* @__PURE__ */ (0, import_vinyl_validation10.array)(drmProtectionValidator).readonly(),
+  contentType: /* @__PURE__ */ (0, import_vinyl_validation10.isOneOf)("audio", "video", "text").orNull(),
+  initDataType: /* @__PURE__ */ (0, import_vinyl_validation10.string)().orNull(),
+  encryptionScheme: /* @__PURE__ */ (0, import_vinyl_validation10.string)().orNull(),
+  mimeType: /* @__PURE__ */ (0, import_vinyl_validation10.string)().orNull()
+});
+function createEmptyMediaFormatMetadata() {
+  return {
+    contentType: null,
+    mimeType: null,
+    initDataType: null,
+    encryptionScheme: null,
+    contentProtections: []
+  };
+}
+function createEmptyMediaQualityMetadata() {
+  return __spreadProps(__spreadValues({}, createEmptyMediaFormatMetadata()), {
+    decoderId: (0, import_vinyl_util53.createShortUid)(),
+    qualityId: (0, import_vinyl_util53.createShortUid)(),
+    codecs: null,
+    bandwidth: null,
+    bandwidthTotal: null,
+    supplementalProperties: {},
+    audioSamplingRate: null,
+    frameRate: null,
+    height: null,
+    width: null,
+    lang: null,
+    characteristics: [],
+    groupId: (0, import_vinyl_util53.createShortUid)(),
+    switchingGroupIds: null
+  });
+}
+var mediaQualityMetadataValidator = /* @__PURE__ */ mediaFormatMetadataValidator.extend({
+  audioSamplingRate: /* @__PURE__ */ (0, import_vinyl_validation10.array)(/* @__PURE__ */ (0, import_vinyl_validation10.number)()).readonly().orNull(),
+  bandwidth: /* @__PURE__ */ (0, import_vinyl_validation10.number)().orNull(),
+  bandwidthTotal: /* @__PURE__ */ (0, import_vinyl_validation10.number)().orNull(),
+  codecs: /* @__PURE__ */ (0, import_vinyl_validation10.string)().orNull(),
+  decoderId: /* @__PURE__ */ (0, import_vinyl_validation10.string)(),
+  frameRate: /* @__PURE__ */ (0, import_vinyl_validation10.tuple)(/* @__PURE__ */ (0, import_vinyl_validation10.number)(), /* @__PURE__ */ (0, import_vinyl_validation10.number)()).readonly().orNull(),
+  height: /* @__PURE__ */ (0, import_vinyl_validation10.number)().orNull(),
+  qualityId: /* @__PURE__ */ (0, import_vinyl_validation10.string)(),
+  supplementalProperties: descriptorRecordValidator,
+  width: /* @__PURE__ */ (0, import_vinyl_validation10.number)().orNull(),
+  lang: /* @__PURE__ */ (0, import_vinyl_validation10.string)().orNull(),
+  characteristics: /* @__PURE__ */ (0, import_vinyl_validation10.array)(/* @__PURE__ */ (0, import_vinyl_validation10.string)()).readonly(),
+  groupId: /* @__PURE__ */ (0, import_vinyl_validation10.string)(),
+  switchingGroupIds: /* @__PURE__ */ (0, import_vinyl_validation10.array)(/* @__PURE__ */ (0, import_vinyl_validation10.string)()).readonly().orNull()
+});
+
 // src/streaming/mediaTimelineFilter.ts
-var import_vinyl_util54 = require("@amazon/vinyl-util");
+var import_vinyl_util56 = require("@amazon/vinyl-util");
 
 // src/streaming/mediaTimelineLanguageFilter.ts
-var import_vinyl_util53 = require("@amazon/vinyl-util");
+var import_vinyl_util55 = require("@amazon/vinyl-util");
 
 // src/track/filters/languageFilter.ts
-var import_vinyl_util52 = require("@amazon/vinyl-util");
+var import_vinyl_util54 = require("@amazon/vinyl-util");
 function throwLanguagesUnsupported() {
-  throw new import_vinyl_util52.MediaUnsupportedError(
+  throw new import_vinyl_util54.MediaUnsupportedError(
     "No content matching preferred language",
     "language"
   );
@@ -5347,9 +5479,9 @@ function languageRelatedness(target, candidate) {
   return 1;
 }
 function findBestLanguageMatch(target, available) {
-  return (0, import_vinyl_util52.max)(
+  return (0, import_vinyl_util54.max)(
     available,
-    (0, import_vinyl_util52.compareBy)((lang) => languageRelatedness(target, lang))
+    (0, import_vinyl_util54.compareBy)((lang) => languageRelatedness(target, lang))
   );
 }
 
@@ -5373,7 +5505,7 @@ function createLanguageFilter(preferredLanguage, contentType2) {
     }
     return best;
   };
-  const bestScoreForPeriod = (0, import_vinyl_util53.memoize)(
+  const bestScoreForPeriod = (0, import_vinyl_util55.memoize)(
     (array6) => {
       let best = 0;
       for (const quality of Array.from(array6)) {
@@ -5396,10 +5528,17 @@ function createLanguageFilter(preferredLanguage, contentType2) {
 }
 
 // src/streaming/mediaTimelineFilter.ts
+function assertMediaStreamsRetained(original, filtered, throwError) {
+  for (const contentType2 of RESTRICTABLE_CONTENT_TYPES) {
+    if (original.some((q) => q.metadata.contentType === contentType2) && !filtered.some((q) => q.metadata.contentType === contentType2)) {
+      throwError();
+    }
+  }
+}
 function filterTimelineQualities(filter, throwError, timeline) {
   if (!filter) return timeline;
-  const mapMetadataArray = (0, import_vinyl_util54.memoize)(
-    (qualities) => (0, import_vinyl_util54.map)(qualities, (q) => q.metadata),
+  const mapMetadataArray = (0, import_vinyl_util56.memoize)(
+    (qualities) => (0, import_vinyl_util56.map)(qualities, (q) => q.metadata),
     (qualities) => qualities,
     1
   );
@@ -5407,16 +5546,14 @@ function filterTimelineQualities(filter, throwError, timeline) {
     const filtered = period.qualities.filter(
       (q, index) => filter(q.metadata, index, mapMetadataArray(period.qualities))
     );
+    assertMediaStreamsRetained(period.qualities, filtered, throwError);
     return __spreadProps(__spreadValues({}, period), { qualities: filtered });
   });
-  if (periods.some((p) => p.qualities.length === 0)) {
-    throwError();
-  }
   return __spreadProps(__spreadValues({}, timeline), { periods });
 }
 async function filterTimelineQualitiesAsync(filter, throwError, timeline) {
-  const mapMetadataArray = (0, import_vinyl_util54.memoize)(
-    (qualities) => (0, import_vinyl_util54.map)(qualities, (q) => q.metadata),
+  const mapMetadataArray = (0, import_vinyl_util56.memoize)(
+    (qualities) => (0, import_vinyl_util56.map)(qualities, (q) => q.metadata),
     (qualities) => qualities,
     1
   );
@@ -5429,18 +5566,16 @@ async function filterTimelineQualitiesAsync(filter, throwError, timeline) {
         filtered.push(period.qualities[i]);
       }
     }
+    assertMediaStreamsRetained(period.qualities, filtered, throwError);
     periods.push(__spreadProps(__spreadValues({}, period), { qualities: filtered }));
   }
-  if (periods.some((p) => p.qualities.length === 0)) {
-    throwError();
-  }
   return __spreadProps(__spreadValues({}, timeline), { periods });
 }
 
 // src/streaming/mediaTimelineAccessibilityFilter.ts
-var import_vinyl_util55 = require("@amazon/vinyl-util");
+var import_vinyl_util57 = require("@amazon/vinyl-util");
 function throwNoPlayableAudio() {
-  throw new import_vinyl_util55.MediaUnsupportedError("No playable audio rendition", "audio");
+  throw new import_vinyl_util57.MediaUnsupportedError("No playable audio rendition", "audio");
 }
 var AUDIO_DESCRIPTION_CHARACTERISTICS = [
   "public.accessibility.describes-video",
@@ -5452,7 +5587,7 @@ function isAudioDescription(quality) {
   );
 }
 function createAudioDescriptionFilter(preferDescription) {
-  const periodFlags = (0, import_vinyl_util55.memoize)(
+  const periodFlags = (0, import_vinyl_util57.memoize)(
     (array6) => {
       let hasDescription = false;
       let hasMain = false;
@@ -5479,9 +5614,9 @@ function createAudioDescriptionFilter(preferDescription) {
 }
 
 // src/track/filters/resourceTypeFilter.ts
-var import_vinyl_util56 = require("@amazon/vinyl-util");
+var import_vinyl_util58 = require("@amazon/vinyl-util");
 function throwMimeTypesUnsupported() {
-  throw new import_vinyl_util56.MediaUnsupportedError(
+  throw new import_vinyl_util58.MediaUnsupportedError(
     "No resource type supported (container/codec).",
     "resource-type"
   );
@@ -5492,9 +5627,9 @@ function canPlayMimeType(deps, metadata) {
 }
 
 // src/track/filters/keySystemFilter.ts
-var import_vinyl_util57 = require("@amazon/vinyl-util");
+var import_vinyl_util59 = require("@amazon/vinyl-util");
 function throwKeySystemsUnsupported() {
-  throw new import_vinyl_util57.MediaUnsupportedError("No key system supported.", "key-system");
+  throw new import_vinyl_util59.MediaUnsupportedError("No key system supported.", "key-system");
 }
 async function canPlayKeySystem(deps, metadata) {
   if (!metadata.contentProtections.length) return true;
@@ -5502,32 +5637,37 @@ async function canPlayKeySystem(deps, metadata) {
 }
 
 // src/track/filters/sampleRateFilter.ts
-var import_vinyl_util58 = require("@amazon/vinyl-util");
+var import_vinyl_util60 = require("@amazon/vinyl-util");
 function throwSamplingRatesUnsupported() {
-  throw new import_vinyl_util58.MediaUnsupportedError("No supported sample rate", "sampling-rate");
+  throw new import_vinyl_util60.MediaUnsupportedError("No supported sample rate", "sampling-rate");
 }
 function withinAudioSampleRateRange(options, metadata, _index, array6) {
   var _a;
   if (metadata.contentType !== "audio") return true;
-  const samplingRate = (0, import_vinyl_util58.last)(metadata.audioSamplingRate);
+  const samplingRate = (0, import_vinyl_util60.last)(metadata.audioSamplingRate);
   if (!samplingRate) return true;
-  const audioRates = () => (0, import_vinyl_util58.map)(
+  const { minSampleRate } = options;
+  const maxSampleRate = (_a = options.maxSampleRate) != null ? _a : options.capabilities.sampleRate;
+  const audioRates = () => (0, import_vinyl_util60.map)(
     array6,
-    (item) => item.contentType === "audio" ? (0, import_vinyl_util58.last)(item.audioSamplingRate) : void 0
+    (item) => item.contentType === "audio" ? (0, import_vinyl_util60.last)(item.audioSamplingRate) : void 0
   ).filter((rate) => rate != null);
-  const { minSampleRate } = options;
+  const outOfBandFallback = () => {
+    const rates = audioRates();
+    const inBand = (rate) => (minSampleRate == null || rate >= minSampleRate) && (!maxSampleRate || rate <= maxSampleRate);
+    if (rates.some(inBand)) return void 0;
+    const decodable = maxSampleRate ? rates.filter((rate) => rate <= maxSampleRate) : rates;
+    return decodable.length ? (0, import_vinyl_util60.max)(decodable) : (0, import_vinyl_util60.min)(rates);
+  };
   if (minSampleRate != null && samplingRate < minSampleRate) {
-    const rates2 = audioRates();
-    return (0, import_vinyl_util58.every)(rates2, (rate) => rate < minSampleRate) && samplingRate === (0, import_vinyl_util58.max)(rates2);
+    return samplingRate === outOfBandFallback();
   }
-  const maxSampleRate = (_a = options.maxSampleRate) != null ? _a : options.capabilities.sampleRate;
   if (!maxSampleRate) return true;
-  if ((0, import_vinyl_util58.hasBrowser)(import_vinyl_util58.Browser.FIREFOX)) {
+  if ((0, import_vinyl_util60.hasBrowser)(import_vinyl_util60.Browser.FIREFOX)) {
     return samplingRate <= 48e3;
   }
   if (samplingRate <= maxSampleRate) return true;
-  const rates = audioRates();
-  return (0, import_vinyl_util58.every)(rates, (rate) => rate > maxSampleRate) && samplingRate === (0, import_vinyl_util58.min)(rates);
+  return samplingRate === outOfBandFallback();
 }
 
 // src/util/media/codecOverrides.ts
@@ -5614,33 +5754,17 @@ function createDefaultMediaTimelineTransformer(deps) {
   });
 }
 
-// src/streaming/DescriptorRecord.ts
-var import_vinyl_validation9 = require("@amazon/vinyl-validation");
-var import_vinyl_util59 = require("@amazon/vinyl-util");
-function getDescriptorValue(record4, uri, id) {
-  var _a, _b;
-  let arr = record4[uri];
-  if (!arr) return null;
-  if (id !== void 0) arr = arr.filter((descriptor) => descriptor.id === id);
-  return (_b = (_a = (0, import_vinyl_util59.first)(arr)) == null ? void 0 : _a.value) != null ? _b : null;
-}
-var descriptorValidator = /* @__PURE__ */ (0, import_vinyl_validation9.object)({
-  id: /* @__PURE__ */ (0, import_vinyl_validation9.string)().maybe().optional(),
-  value: /* @__PURE__ */ (0, import_vinyl_validation9.string)().maybe().optional()
-});
-var descriptorRecordValidator = /* @__PURE__ */ (0, import_vinyl_validation9.record)(/* @__PURE__ */ (0, import_vinyl_validation9.string)(), /* @__PURE__ */ (0, import_vinyl_validation9.array)(descriptorValidator).readonly().orUndefined());
-
 // src/streaming/ManifestControllerImpl.ts
 var import_vinyl_observable3 = require("@amazon/vinyl-observable");
-var import_vinyl_util60 = require("@amazon/vinyl-util");
+var import_vinyl_util61 = require("@amazon/vinyl-util");
 var ManifestControllerImpl = class {
   constructor(deps) {
     __publicField(this, "deps", deps);
     __publicField(this, "_data");
     __publicField(this, "_error", null);
-    __publicField(this, "abortSlot", /* @__PURE__ */ (0, import_vinyl_util60.createAbortSlot)());
-    __publicField(this, "disposer", /* @__PURE__ */ (0, import_vinyl_util60.createDisposer)());
-    __publicField(this, "events", /* @__PURE__ */ new import_vinyl_util60.EventHostImpl());
+    __publicField(this, "abortSlot", /* @__PURE__ */ (0, import_vinyl_util61.createAbortSlot)());
+    __publicField(this, "disposer", /* @__PURE__ */ (0, import_vinyl_util61.createDisposer)());
+    __publicField(this, "events", /* @__PURE__ */ new import_vinyl_util61.EventHostImpl());
     __publicField(this, "manifestSpanArmed", true);
     __publicField(this, "__eventMapType", this.events.__eventMapType);
     this._data = (0, import_vinyl_observable3.data)(this.requestManifest());
@@ -5667,7 +5791,7 @@ var ManifestControllerImpl = class {
     return this._error;
   }
   refresh() {
-    (0, import_vinyl_util60.logDebug)(this, "refresh");
+    (0, import_vinyl_util61.logDebug)(this, "refresh");
     this._data.value = this.requestManifest();
   }
   requestManifest() {
@@ -5698,7 +5822,7 @@ var ManifestControllerImpl = class {
     );
   }
   reset() {
-    (0, import_vinyl_util60.logDebug)(this, "reset");
+    (0, import_vinyl_util61.logDebug)(this, "reset");
     if (this._error) {
       this.refresh();
     }
@@ -5731,74 +5855,6 @@ var ManifestControllerImpl = class {
   }
 };
 
-// src/streaming/MediaQualityMetadata.ts
-var import_vinyl_util61 = require("@amazon/vinyl-util");
-var import_vinyl_validation10 = require("@amazon/vinyl-validation");
-var ALL_CONTENT_TYPES = [
-  "video",
-  "audio",
-  "text"
-];
-var RESTRICTABLE_CONTENT_TYPES = [
-  "video",
-  "audio"
-];
-var drmProtectionValidator = /* @__PURE__ */ descriptorValidator.extend({
-  keySystem: /* @__PURE__ */ (0, import_vinyl_validation10.enumOf)(DrmKeySystem),
-  pro: /* @__PURE__ */ (0, import_vinyl_validation10.string)().maybe().optional(),
-  pssh: /* @__PURE__ */ (0, import_vinyl_validation10.string)().maybe().optional()
-});
-var mediaFormatMetadataValidator = /* @__PURE__ */ (0, import_vinyl_validation10.object)({
-  contentProtections: /* @__PURE__ */ (0, import_vinyl_validation10.array)(drmProtectionValidator).readonly(),
-  contentType: /* @__PURE__ */ (0, import_vinyl_validation10.isOneOf)("audio", "video", "text").orNull(),
-  initDataType: /* @__PURE__ */ (0, import_vinyl_validation10.string)().orNull(),
-  encryptionScheme: /* @__PURE__ */ (0, import_vinyl_validation10.string)().orNull(),
-  mimeType: /* @__PURE__ */ (0, import_vinyl_validation10.string)().orNull()
-});
-function createEmptyMediaFormatMetadata() {
-  return {
-    contentType: null,
-    mimeType: null,
-    initDataType: null,
-    encryptionScheme: null,
-    contentProtections: []
-  };
-}
-function createEmptyMediaQualityMetadata() {
-  return __spreadProps(__spreadValues({}, createEmptyMediaFormatMetadata()), {
-    decoderId: (0, import_vinyl_util61.createShortUid)(),
-    qualityId: (0, import_vinyl_util61.createShortUid)(),
-    codecs: null,
-    bandwidth: null,
-    bandwidthTotal: null,
-    supplementalProperties: {},
-    audioSamplingRate: null,
-    frameRate: null,
-    height: null,
-    width: null,
-    lang: null,
-    characteristics: [],
-    groupId: (0, import_vinyl_util61.createShortUid)(),
-    switchingGroupIds: null
-  });
-}
-var mediaQualityMetadataValidator = /* @__PURE__ */ mediaFormatMetadataValidator.extend({
-  audioSamplingRate: /* @__PURE__ */ (0, import_vinyl_validation10.array)(/* @__PURE__ */ (0, import_vinyl_validation10.number)()).readonly().orNull(),
-  bandwidth: /* @__PURE__ */ (0, import_vinyl_validation10.number)().orNull(),
-  bandwidthTotal: /* @__PURE__ */ (0, import_vinyl_validation10.number)().orNull(),
-  codecs: /* @__PURE__ */ (0, import_vinyl_validation10.string)().orNull(),
-  decoderId: /* @__PURE__ */ (0, import_vinyl_validation10.string)(),
-  frameRate: /* @__PURE__ */ (0, import_vinyl_validation10.tuple)(/* @__PURE__ */ (0, import_vinyl_validation10.number)(), /* @__PURE__ */ (0, import_vinyl_validation10.number)()).readonly().orNull(),
-  height: /* @__PURE__ */ (0, import_vinyl_validation10.number)().orNull(),
-  qualityId: /* @__PURE__ */ (0, import_vinyl_validation10.string)(),
-  supplementalProperties: descriptorRecordValidator,
-  width: /* @__PURE__ */ (0, import_vinyl_validation10.number)().orNull(),
-  lang: /* @__PURE__ */ (0, import_vinyl_validation10.string)().orNull(),
-  characteristics: /* @__PURE__ */ (0, import_vinyl_validation10.array)(/* @__PURE__ */ (0, import_vinyl_validation10.string)()).readonly(),
-  groupId: /* @__PURE__ */ (0, import_vinyl_validation10.string)(),
-  switchingGroupIds: /* @__PURE__ */ (0, import_vinyl_validation10.array)(/* @__PURE__ */ (0, import_vinyl_validation10.string)()).readonly().orNull()
-});
-
 // src/streaming/MediaTimeline.ts
 var import_vinyl_util62 = require("@amazon/vinyl-util");
 function getMediaPeriodAtTime(timeline, time) {
@@ -7955,10 +8011,7 @@ var MseTrack = class extends TrackBase {
     this.deps = deps;
     add(
       deps.contentTypesValue.onData((contentTypesPromise) => {
-        contentTypesPromise.then((value) => {
-          this.setContentTypes(value);
-          this.validateRequiredContentTypesPlayable();
-        }).catch(this.errorHandler);
+        contentTypesPromise.then((value) => this.setContentTypes(value)).catch(this.errorHandler);
       })
     );
     this.on("streamingQualityChange", (event) => {
@@ -8059,33 +8112,8 @@ var MseTrack = class extends TrackBase {
           });
         }
       }
-      this.validateRequiredContentTypesPlayable();
     });
   }
-  /**
-   * Fails fast when a media content type the manifest declared (audio/video)
-   * has no playable qualities left after timeline filtering. Its stream can
-   * never create a source buffer, so without this the track waits forever for
-   * a source buffer that never arrives, surfacing only as an opaque
-   * `readyToAppend` timeout. Runs once both the required content types and the
-   * filtered timeline qualities are known (either order).
-   */
-  validateRequiredContentTypesPlayable() {
-    const qualities = this._qualities;
-    if (!qualities) return;
-    const present = new Set(qualities.map((q) => q.contentType));
-    for (const contentType2 of this._contentTypes) {
-      if (!present.has(contentType2)) {
-        this.errorHandler(
-          new import_vinyl_util80.MediaUnsupportedError(
-            `No playable ${contentType2} rendition`,
-            `no-playable-${contentType2}`
-          )
-        );
-        return;
-      }
-    }
-  }
   async getAds() {
     const timeline = await this.deps.mediaTimeline.value;
     return {
@@ -10482,6 +10510,7 @@ var VinylPlayer = class extends import_vinyl_util99.EventHostImpl {
     playerRegistryRef.value.addPlayer(this);
     this.redispatchSubControllerEvents();
     this.redispatchCurrentTrackEvents();
+    this.initializeLoadSpanLogging();
     this.initializeAutoResetHandling();
   }
   get [Symbol.toStringTag]() {
@@ -10499,6 +10528,26 @@ var VinylPlayer = class extends import_vinyl_util99.EventHostImpl {
   get autoResetController() {
     return this.deps.autoResetController;
   }
+  /**
+   * Logs each republished load span once at the verbose level, formatting its
+   * bounds as ISO date strings and its duration in milliseconds.
+   */
+  initializeLoadSpanLogging() {
+    this.disposer.add(
+      this.on("loadSpan", (span) => {
+        if ((0, import_vinyl_util99.getLogLevel)() > import_vinyl_util99.LogLevel.VERBOSE) return;
+        (0, import_vinyl_util99.logVerbose)(this, "loadSpan", {
+          kind: span.kind,
+          trackUri: span.trackUri,
+          mimeType: span.mimeType,
+          contentType: span.contentType,
+          startTime: new Date(span.startTime).toISOString(),
+          endTime: new Date(span.endTime).toISOString(),
+          durationMs: (span.endTime - span.startTime).toFixed(2)
+        });
+      })
+    );
+  }
   redispatchSubControllerEvents() {
     const add = this.disposer.add;
     add(