@amazon/vinyl 1.1.0 → 1.2.0

package/dist/types/ts3.7/vinyl/createVinylFactories.d.ts

@@ -18,7 +18,7 @@ import { LoudnessNormalizationControllerImpl } from '../playback/loudness/Loudne
 import { AutoResetControllerImpl, AutoResetControllerImplDeps, AutoResetControllerImplOptions } from '../track/AutoResetController';
 import { Dependencies, Factories } from '@amazon/vinyl-di';
 import { ContentStreamingOptions } from '../streaming/ContentStreamingOptions';
-import { VinylOptions } from '../vinyl/VinylOptions';
+import { VinylOptions } from './VinylOptions';
 import { ObservableValue } from '@amazon/vinyl-observable';
 /**
  * Configuration used by the default dependency factories for Vinyl.
@@ -81,15 +81,13 @@ export declare function createVinylFactories(options: VinylDependencyOptions): {
     }) => LoudnessNormalizationControllerImpl;
     capabilities: (deps: CapabilitiesImplDeps) => CapabilitiesImpl;
     requestInterceptor: () => typeof noop;
-    trackFactory: (deps: VinylTrackFactoryDeps) => import("../track/TrackFactory").TrackFactory<import("..").SourceObjectTrackLoadOptions | import("..").SourceTrackLoadOptions | import("..").DashTrackLoadOptions | import("..").HlsTrackLoadOptions>;
+    trackFactory: (deps: VinylTrackFactoryDeps) => import("..").TrackFactory<import("..").SourceObjectTrackLoadOptions | import("..").SourceTrackLoadOptions | import("..").DashTrackLoadOptions | import("..").HlsTrackLoadOptions>;
     trackController: (deps: TrackControllerImplDeps<any>) => TrackControllerImpl<any>;
-    drmKeySystemResolver: () => import("../drm/DrmKeySystemResolver").DrmKeySystemResolver;
+    drmKeySystemResolver: () => import("..").DrmKeySystemResolver;
     drmController: (deps: DrmControllerImplDeps) => DrmControllerImpl;
     commonEme: typeof commonEmeFactory;
     autoResetController: (deps: AutoResetControllerImplDeps) => AutoResetControllerImpl;
-    createDashFactories: (deps: import("../track/dash/createDashFactories").DashFactoryDeps) => (/**
-     * Configuration for segmented streaming tracks (hls / dash).
-     */ loadOptions: import("..").DashTrackLoadOptions) => {
+    createDashFactories: (deps: import("..").DashFactoryDeps) => (loadOptions: import("..").DashTrackLoadOptions) => {
         contentTypesValue: typeof import("..").createDashContentTypesValue;
         baseUrlSelector: () => import("..").BaseUrlSelector;
         segmentRequestInit: () => import("@amazon/vinyl-util").Maybe<Readonly<Omit<RequestInit, "signal">>>;
@@ -112,7 +110,7 @@ export declare function createVinylFactories(options: VinylDependencyOptions): {
         contentStreamFactory: typeof import("..").createContentStreamFactory;
         qualitySelector: (deps: {
             options: ObservableValue<Pick<VinylOptions, "abr">>;
-        }) => import("../streaming/abr/QualitySelectorImpl").QualitySelectorImpl;
+        }) => import("..").QualitySelectorImpl;
         manifestTransformed: typeof import("..").createDefaultDashManifestTransformer;
         mediaTimeline: (deps: import("..").BuildDashMediaTimelineDeps & {
             readonly manifestTransformed: ObservableValue<Promise<import("..").DashManifestData>>;
@@ -124,12 +122,12 @@ export declare function createVinylFactories(options: VinylDependencyOptions): {
         }>>;
         playbackController: import("@amazon/vinyl-di").Factory<import("..").PlaybackController>;
         playbackSource: import("@amazon/vinyl-di").Factory<import("..").PlaybackSource>;
-        drmKeySystemResolver: import("@amazon/vinyl-di").Factory<import("../drm/DrmKeySystemResolver").DrmKeySystemResolver>;
+        drmKeySystemResolver: import("@amazon/vinyl-di").Factory<import("..").DrmKeySystemResolver>;
         requestInterceptor: import("@amazon/vinyl-di").Factory<import("@amazon/vinyl-util").RequestInterceptor>;
         drmController: import("@amazon/vinyl-di").Factory<import("..").DrmController>;
         capabilities: import("@amazon/vinyl-di").Factory<import("..").Capabilities>;
     };
-    createHlsFactories: (deps: import("../track/hls/createHlsFactories").HlsFactoryDeps) => (loadOptions: import("..").HlsTrackLoadOptions) => {
+    createHlsFactories: (deps: import("..").HlsFactoryDeps) => (loadOptions: import("..").HlsTrackLoadOptions) => {
         contentTypesValue: typeof import("..").createHlsContentTypesValue;
         manifestController: () => import("..").HlsManifestControllerImpl;
         manifestTransformed: typeof import("..").createDefaultHlsManifestTransformer;
@@ -149,7 +147,7 @@ export declare function createVinylFactories(options: VinylDependencyOptions): {
         contentStreamFactory: typeof import("..").createContentStreamFactory;
         qualitySelector: (deps: {
             options: ObservableValue<Pick<VinylOptions, "abr">>;
-        }) => import("../streaming/abr/QualitySelectorImpl").QualitySelectorImpl;
+        }) => import("..").QualitySelectorImpl;
         mediaTimeline: (deps: import("..").BuildHlsMediaTimelineDeps & {
             readonly manifestTransformed: ObservableValue<Promise<import("..").HlsManifestData>>;
         }) => ObservableValue<Promise<import("..").MediaTimeline>>;
@@ -160,7 +158,7 @@ export declare function createVinylFactories(options: VinylDependencyOptions): {
         }>>;
         playbackController: import("@amazon/vinyl-di").Factory<import("..").PlaybackController>;
         playbackSource: import("@amazon/vinyl-di").Factory<import("..").PlaybackSource>;
-        drmKeySystemResolver: import("@amazon/vinyl-di").Factory<import("../drm/DrmKeySystemResolver").DrmKeySystemResolver>;
+        drmKeySystemResolver: import("@amazon/vinyl-di").Factory<import("..").DrmKeySystemResolver>;
         requestInterceptor: import("@amazon/vinyl-di").Factory<import("@amazon/vinyl-util").RequestInterceptor>;
         drmController: import("@amazon/vinyl-di").Factory<import("..").DrmController>;
         capabilities: import("@amazon/vinyl-di").Factory<import("..").Capabilities>;

package/dist/types/ts4.1/drm/DrmController.d.ts

@@ -1,9 +1,9 @@
 import type { AnyRecord, Maybe, ReadonlyAbort, ReadonlyEventHost } from '@amazon/vinyl-util';
 import type { DrmInitDataType } from '../streaming/DrmInitDataType';
-import type { DrmKeySystem } from '../drm/DrmKeySystem';
+import type { DrmKeySystem } from './DrmKeySystem';
 import type { MediaFormatMetadata } from '../streaming/MediaQualityMetadata';
 import type { BasicErrorEvent } from '../event/BasicErrorEvent';
-import type { DrmOptions } from '../drm/DrmOptions';
+import type { DrmOptions } from './DrmOptions';
 export interface DrmControllerEventMap {
     /**
      * A DRM error occurred.

package/dist/types/ts4.1/drm/DrmControllerImpl.d.ts

@@ -1,8 +1,8 @@
 import type { Maybe, ReadonlyAbort } from '@amazon/vinyl-util';
 import { EventHostImpl } from '@amazon/vinyl-util';
-import type { DrmOptions } from '../drm/DrmOptions';
-import type { DrmController, DrmControllerEventMap, DrmKeySystemSupport } from '../drm/DrmController';
-import type { CommonEme, CommonMediaKeyMessageEvent, CommonMediaKeys, CommonMediaKeySession } from '../drm/commonEme/CommonEme';
+import type { DrmOptions } from './DrmOptions';
+import type { DrmController, DrmControllerEventMap, DrmKeySystemSupport } from './DrmController';
+import type { CommonEme, CommonMediaKeyMessageEvent, CommonMediaKeys, CommonMediaKeySession } from './commonEme/CommonEme';
 import type { MediaFormatMetadata } from '../streaming/MediaQualityMetadata';
 /**
  * The number of seconds a license request will be allowed before timing out.

package/dist/types/ts4.1/drm/DrmKeySystemResolver.d.ts

@@ -1,5 +1,5 @@
 import type { ReadonlyRecord } from '@amazon/vinyl-util';
-import { DrmKeySystem } from '../drm/DrmKeySystem';
+import { DrmKeySystem } from './DrmKeySystem';
 /**
  * Given a ContentProtection schemeIdUri, returns the {@link DrmKeySystem} it represents.
  * Not all scheme ids will match to a DrmKeySystem. If none are matched, null is returned.

package/dist/types/ts4.1/drm/DrmOptions.d.ts

@@ -3,7 +3,7 @@ import type { DrmInitDataType } from '../streaming/DrmInitDataType';
 import type { MediaFormatMetadata } from '../streaming/MediaQualityMetadata';
 import type { ObjectSchema, ValueSchema } from '@amazon/vinyl-validation';
 import { DrmKeySystem } from './DrmKeySystem';
-import type { LicenseProvider, LicenseServerOptions } from '../drm/licenseProvider/LicenseProvider';
+import type { LicenseProvider, LicenseServerOptions } from './licenseProvider/LicenseProvider';
 /**
  * DrmRobustness is the requested security level for audio or video decryption.
  */

package/dist/types/ts4.1/drm/commonEme/CommonEme.d.ts

@@ -2,10 +2,10 @@
  * An common interface to unify multiple EME implementations.
  * @module
  */
-import type { DrmKeySystem } from '../../drm/DrmKeySystem';
+import type { DrmKeySystem } from '../DrmKeySystem';
 import type { Json, ReadonlyEventHost, Unsubscribe } from '@amazon/vinyl-util';
 import { ReportableError } from '@amazon/vinyl-util';
-import type { EncryptedInitData } from '../../drm/commonEme/EncryptedInitData';
+import type { EncryptedInitData } from './EncryptedInitData';
 import type { DrmInitDataType } from '../../streaming/DrmInitDataType';
 import type { BasicErrorEvent } from '../../event/BasicErrorEvent';
 /**

package/dist/types/ts4.1/drm/commonEme/CommonEmeFactory.d.ts

@@ -1,4 +1,4 @@
-import type { CommonEme } from '../../drm/commonEme/CommonEme';
+import type { CommonEme } from './CommonEme';
 /**
  * Common EME Factory provides the first supported implementation of CommonEme.
  * The priority is WebKit, Standard, then MS.

package/dist/types/ts4.1/drm/commonEme/MsCommonEme.d.ts

@@ -2,7 +2,7 @@ import type { Disposable, Unsubscribe } from '@amazon/vinyl-util';
 import { EventHostImpl } from '@amazon/vinyl-util';
 import type { CommonEme, CommonMediaKeys, CommonMediaKeySession, CommonMediaKeySessionEventMap, CommonMediaKeySystemAccess } from './CommonEme';
 import { MediaKeySessionErrorType } from './CommonEme';
-import type { DrmKeySystem } from '../../drm/DrmKeySystem';
+import type { DrmKeySystem } from '../DrmKeySystem';
 import type { EncryptedInitData } from './EncryptedInitData';
 import type { DrmInitDataType } from '../../streaming/DrmInitDataType';
 declare global {

package/dist/types/ts4.1/drm/commonEme/StandardCommonEme.d.ts

@@ -1,7 +1,7 @@
 import type { Disposable, Unsubscribe } from '@amazon/vinyl-util';
 import { EventHostImpl } from '@amazon/vinyl-util';
 import type { CommonEme, CommonMediaEncryptedEvent, CommonMediaKeys, CommonMediaKeySession, CommonMediaKeySessionEventMap, CommonMediaKeySystemAccess } from './CommonEme';
-import type { DrmKeySystem } from '../../drm/DrmKeySystem';
+import type { DrmKeySystem } from '../DrmKeySystem';
 import type { EncryptedInitData } from './EncryptedInitData';
 import type { DrmInitDataType } from '../../streaming/DrmInitDataType';
 /**

package/dist/types/ts4.1/drm/commonEme/WebKitCommonEme.d.ts

@@ -3,8 +3,8 @@ import type { Disposable } from '@amazon/vinyl-util';
 import { EventHostImpl } from '@amazon/vinyl-util';
 import type { CommonEme, CommonMediaEncryptedEvent, CommonMediaKeys, CommonMediaKeySession, CommonMediaKeySessionEventMap, CommonMediaKeySystemAccess } from './CommonEme';
 import { MediaKeySessionErrorType } from './CommonEme';
-import type { DrmKeySystem } from '../../drm/DrmKeySystem';
-import type { EncryptedInitData } from '../../drm/commonEme/EncryptedInitData';
+import type { DrmKeySystem } from '../DrmKeySystem';
+import type { EncryptedInitData } from './EncryptedInitData';
 import type { DrmInitDataType } from '../../streaming/DrmInitDataType';
 declare global {
     interface HTMLMediaElementEventMap extends HTMLElementEventMap {

package/dist/types/ts4.1/drm/licenseProvider/LicenseProvider.d.ts

@@ -1,5 +1,5 @@
 import type { Maybe, ReadonlyAbort } from '@amazon/vinyl-util';
-import type { DrmKeySystem } from '../../drm/DrmKeySystem';
+import type { DrmKeySystem } from '../DrmKeySystem';
 import type { ObjectSchema } from '@amazon/vinyl-validation';
 /**
  * LicenseProvider handles requesting DRM licenses for specific key systems.

package/dist/types/ts4.1/global/environment.d.ts

@@ -1,6 +1,10 @@
+declare global {
+    var __VINYL_VERSION__: string | undefined;
+}
 /**
- * process.env.VINYL_VERSION will be null in node unit tests, but in the built library it is
- * replaced by the webpack DefinePlugin with the package.version.
+ * `globalThis.__VINYL_VERSION__` is replaced at build time with the package.version via
+ * esbuild's `define` option. In unit tests and unbundled dev builds the replacement does not
+ * happen and the global is undefined, so we fall through to a placeholder version.
  */
 export declare const vinylVersion: import("@amazon/vinyl-util").Version;
 //# sourceMappingURL=environment.d.ts.map

package/dist/types/ts4.1/patch/media/patches/createPreventStallsPatch.d.ts

@@ -1,4 +1,4 @@
-import type { HtmlMediaElementPatch } from '../../../patch/media/HtmlMediaElementPatch';
+import type { HtmlMediaElementPatch } from '../HtmlMediaElementPatch';
 /**
  * The number of timeupdate events stuck at the same position before attempting to jiggle the playhead.
  * @private

package/dist/types/ts4.1/patch/media/patches/createUnreliablePlaybackEventsPatch.d.ts

@@ -1,4 +1,4 @@
-import type { HtmlMediaElementPatch } from '../../../patch/media/HtmlMediaElementPatch';
+import type { HtmlMediaElementPatch } from '../HtmlMediaElementPatch';
 /**
  * The interval (in seconds) to poll for time progress in a media element.
  *

package/dist/types/ts4.1/playback/PlaybackControllerImpl.d.ts

@@ -3,7 +3,7 @@ import { EventHostImpl } from '@amazon/vinyl-util';
 import type { PlaybackController } from './PlaybackController';
 import type { PlaybackControllerEventMap } from './ReadonlyPlaybackController';
 import { PlaybackReadyState } from './ReadonlyPlaybackController';
-import type { LoudnessNormalizationController } from '../playback/loudness/LoudnessNormalizationController';
+import type { LoudnessNormalizationController } from './loudness/LoudnessNormalizationController';
 export interface PlaybackControllerImplOptions {
     /**
      * An affordance when comparing the last currentTime and the new currentTime after a seek.

package/dist/types/ts4.1/playback/logging/playbackStateLoggingHandler.d.ts

@@ -1,5 +1,5 @@
 import type { Disposable } from '@amazon/vinyl-util';
-import type { ReadonlyPlaybackController } from '../../playback/ReadonlyPlaybackController';
+import type { ReadonlyPlaybackController } from '../ReadonlyPlaybackController';
 /**
  * The number of seconds to throttle timeupdate logs.
  * Logs will not be emitted for timeupdate events less than this interval.

package/dist/types/ts4.1/playback/nextHasMetadata.d.ts

@@ -1,4 +1,4 @@
-import type { PlaybackControllerEventMap, ReadonlyPlaybackController } from '../playback/ReadonlyPlaybackController';
+import type { PlaybackControllerEventMap, ReadonlyPlaybackController } from './ReadonlyPlaybackController';
 import type { AnyRecord, NextEventAsPromiseOptions } from '@amazon/vinyl-util';
 export declare function nextHasMetadata(controller: ReadonlyPlaybackController, options?: NextEventAsPromiseOptions<PlaybackControllerEventMap, 'loadedMetadata'>): Promise<AnyRecord>;
 //# sourceMappingURL=nextHasMetadata.d.ts.map

package/dist/types/ts4.1/streaming/ContentStream.d.ts

@@ -1,9 +1,9 @@
 import type { Disposable, Maybe, ReadonlyEventHost, ReadonlyRanges } from '@amazon/vinyl-util';
 import { EventHostImpl } from '@amazon/vinyl-util';
-import type { StreamingEventMap } from '../streaming/StreamingEventMap';
-import type { SegmentController } from '../streaming/SegmentController';
-import type { BufferingController } from '../streaming/buffering/BufferingController';
-import type { ContentType, MediaQualityMetadata } from '../streaming/MediaQualityMetadata';
+import type { StreamingEventMap } from './StreamingEventMap';
+import type { SegmentController } from './SegmentController';
+import type { BufferingController } from './buffering/BufferingController';
+import type { ContentType, MediaQualityMetadata } from './MediaQualityMetadata';
 import type { Factories } from '@amazon/vinyl-di';
 /**
  * Creates a new ContentStream for the given content type.

package/dist/types/ts4.1/streaming/ContentStreamingOptions.d.ts

@@ -1,5 +1,5 @@
-import type { SegmentControllerImplOptions } from '../streaming/SegmentControllerImpl';
-import type { BufferingControllerImplOptions } from '../streaming/buffering/BufferingController';
+import type { SegmentControllerImplOptions } from './SegmentControllerImpl';
+import type { BufferingControllerImplOptions } from './buffering/BufferingController';
 export interface ContentStreamingOptions {
     /**
      * Configuration for the segment controller.

package/dist/types/ts4.1/streaming/MediaQualityMetadata.d.ts

@@ -1,7 +1,7 @@
 import type { Maybe, MutableDeep } from '@amazon/vinyl-util';
 import type { ObjectSchema } from '@amazon/vinyl-validation';
-import type { DescriptorRecord } from '../streaming/DescriptorRecord';
-import type { DrmInitDataType } from '../streaming/DrmInitDataType';
+import type { DescriptorRecord } from './DescriptorRecord';
+import type { DrmInitDataType } from './DrmInitDataType';
 import type { CencEncryptionScheme } from '../drm/CencEncryptionScheme';
 import { DrmKeySystem } from '../drm/DrmKeySystem';
 import type { FrameRate } from '@amazon/vinyl-mpd-parser';

package/dist/types/ts4.1/streaming/MediaTimeline.d.ts

@@ -1,6 +1,6 @@
-import type { SegmentReference } from '../streaming/SegmentReference';
-import type { SegmentDataProvider } from '../streaming/SegmentDataSlot';
-import type { MediaQualityMetadata } from '../streaming/MediaQualityMetadata';
+import type { SegmentReference } from './SegmentReference';
+import type { SegmentDataProvider } from './SegmentDataSlot';
+import type { MediaQualityMetadata } from './MediaQualityMetadata';
 /**
  * Represents a single quality within a period, providing access to its metadata
  * and segment data.
@@ -34,9 +34,10 @@ export interface MediaTimeline {
     readonly minBufferTime: number;
     /**
      * The total duration of the media, in seconds.
-     * Returns null if duration cannot be determined.
+     * Returns `Infinity` for live streams.
+     * Rejects when there are no segments to derive a duration from.
      */
-    getDuration?(): Promise<number | null>;
+    getDuration(): Promise<number>;
 }
 /**
  * Gets the period spanning the given presentation time.

package/dist/types/ts4.1/streaming/SegmentController.d.ts

@@ -1,7 +1,7 @@
 import type { AnyRecord, Disposable, ReadonlyAbort, ReadonlyEventHost, ReadonlyRanges } from '@amazon/vinyl-util';
-import type { SegmentReference } from '../streaming/SegmentReference';
+import type { SegmentReference } from './SegmentReference';
 import type { ChangeEvent } from '../event/ChangeEvent';
-import type { MediaQualityMetadata } from '../streaming/MediaQualityMetadata';
+import type { MediaQualityMetadata } from './MediaQualityMetadata';
 /**
  * Forward-snap tolerance, in seconds, applied when looking up a segment by time.
  *
@@ -48,11 +48,6 @@ export interface ReadonlySegmentController extends ReadonlyEventHost<SegmentCont
      * The most recently requested quality metadata.
      */
     readonly streamingQuality: MediaQualityMetadata | null;
-    /**
-     * The duration of the media, in seconds.
-     * Returns null if duration cannot be determined.
-     */
-    getDuration(): Promise<number | null>;
     /**
      * Returns a Promise for a segment covering the given time, with quality chosen by
      * the configured `QualitySelector`. Resolves to `null` if no media exists at that

package/dist/types/ts4.1/streaming/SegmentControllerImpl.d.ts

@@ -1,12 +1,12 @@
 import type { ReadonlyAbort, ReadonlyRanges } from '@amazon/vinyl-util';
 import { EventHostImpl } from '@amazon/vinyl-util';
 import type { ReadonlyPlaybackController } from '../playback/ReadonlyPlaybackController';
-import type { PrefetchOptions, SegmentController, SegmentControllerEventMap } from '../streaming/SegmentController';
-import type { SegmentReference } from '../streaming/SegmentReference';
-import type { ContentType, MediaQualityMetadata } from '../streaming/MediaQualityMetadata';
+import type { PrefetchOptions, SegmentController, SegmentControllerEventMap } from './SegmentController';
+import type { SegmentReference } from './SegmentReference';
+import type { ContentType, MediaQualityMetadata } from './MediaQualityMetadata';
 import type { ObservableValue } from '@amazon/vinyl-observable';
-import type { MediaTimeline } from '../streaming/MediaTimeline';
-import type { QualitySelector } from '../streaming/abr/QualitySelector';
+import type { MediaTimeline } from './MediaTimeline';
+import type { QualitySelector } from './abr/QualitySelector';
 /**
  * The interval to check if additional segments should be prefetched.
  */
@@ -74,7 +74,6 @@ export declare class SegmentControllerImpl extends EventHostImpl<SegmentControll
     private _cachedPeriod;
     constructor(deps: SegmentControllerImplDeps, contentType: ContentType, options?: Partial<SegmentControllerImplOptions>);
     get error(): (Error | null);
-    getDuration(): Promise<number | null>;
     /**
      * Gets the period at the given time, using a cache for the last returned period.
      */

package/dist/types/ts4.1/streaming/SegmentReference.d.ts

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

package/dist/types/ts4.1/streaming/StreamingEventMap.d.ts

@@ -1,5 +1,5 @@
 import type { ChangeEvent } from '../event/ChangeEvent';
-import type { ContentType, MediaQualityMetadata } from '../streaming/MediaQualityMetadata';
+import type { ContentType, MediaQualityMetadata } from './MediaQualityMetadata';
 import type { BasicErrorEvent } from '../event/BasicErrorEvent';
 import type { AnyRecord } from '@amazon/vinyl-util';
 /**

package/dist/types/ts4.1/streaming/abr/QualitySelector.d.ts

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

package/dist/types/ts4.1/streaming/abr/QualitySelectorImpl.d.ts

@@ -1,7 +1,7 @@
-import type { PrefetchState, QualitySelector } from '../../streaming/abr/QualitySelector';
-import type { Disposable, LogTarget } from '@amazon/vinyl-util';
+import type { PrefetchState, QualitySelector } from './QualitySelector';
+import type { Disposable, LogTarget, 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,20 @@ 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>;
 }
 export declare enum AbrStrategy {
     /**
@@ -82,6 +96,7 @@ export declare const defaultQualitySelectorImplOptions: {
     readonly bandwidthMultiplierLow: 0.4;
     readonly bandwidthMultiplierHigh: 0.9;
     readonly restrictDecoderChangeOnAudioAbrUp: false;
+    readonly maxBandwidth: null;
 };
 export interface QualitySelectorImplDeps {
     readonly options: ObservableValue<QualitySelectorImplOptions>;

package/dist/types/ts4.1/streaming/buffering/BufferingController.d.ts

@@ -2,17 +2,11 @@ import type { AnyRecord, Clearable, Disposable, ReadonlyEventHost } from '@amazo
 import { EventHostImpl } 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 { MediaSourceController } from './MediaSourceController';
 /**
  * The interval to throttle polling the buffer.
  * Reset after a seek.
@@ -168,10 +162,6 @@ export declare class BufferingControllerImpl extends EventHostImpl<BufferingCont
     deactivate(): void;
     reset(): void;
     get busy(): boolean;
-    /**
-     * Enqueues a duration update.
-     */
-    private refreshDuration;
     /**
      * Resets the throttle and polls the buffer on the next frame.
      */

package/dist/types/ts4.1/streaming/buffering/MediaSourceController.d.ts

@@ -1,8 +1,16 @@
 import type { AnyRecord, Disposable, Json, LogTarget, ReadonlyEventHost } from '@amazon/vinyl-util';
 import { EventHostImpl, 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.
@@ -23,7 +31,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;
     /**
@@ -36,20 +45,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.
      */
@@ -73,21 +74,46 @@ 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 sourceBuffers;
     private readonly mediaSource;
     private readonly disposer;
     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 get sourceBufferCount();
+    private readonly errorHandler;
+    /**
+     * 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.
+     */
+    private timelineSub;
     private initializeEvents;
-    get duration(): number;
-    set duration(value: number);
+    /**
+     * 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;

package/dist/types/ts4.1/streaming/buffering/SourceBufferController.d.ts

@@ -1,6 +1,6 @@
 import type { Disposable, LogTarget, ReadonlyRanges, Task } from '@amazon/vinyl-util';
 import type { MediaSourceController } from './MediaSourceController';
-import type { ContentType } from '../../streaming/MediaQualityMetadata';
+import type { ContentType } from '../MediaQualityMetadata';
 export declare const APPEND_WINDOW_START_OFFSET = 0.05;
 export declare const APPEND_WINDOW_END_OFFSET = 0.01;
 export declare const READY_TO_APPEND_TIMEOUT = 30;

package/dist/types/ts4.1/streaming/createDefaultMediaTimelineTransformer.d.ts

@@ -1,7 +1,7 @@
 import type { ObservableValue } from '@amazon/vinyl-observable';
 import type { Capabilities } from '../client/Capabilities';
 import type { DrmController } from '../drm/DrmController';
-import type { MediaTimeline } from '../streaming/MediaTimeline';
+import type { MediaTimeline } from './MediaTimeline';
 export interface DefaultMediaTimelineTransformerDeps {
     readonly capabilities: Capabilities;
     readonly drmController: DrmController;

package/dist/types/ts4.1/streaming/mediaTimelineFilter.d.ts

@@ -1,5 +1,5 @@
-import type { MediaTimeline } from '../streaming/MediaTimeline';
-import type { MediaQualityMetadata } from '../streaming/MediaQualityMetadata';
+import type { MediaTimeline } from './MediaTimeline';
+import type { MediaQualityMetadata } from './MediaQualityMetadata';
 import type { FilterPredicate, FilterPredicateAsync, Maybe } from '@amazon/vinyl-util';
 /**
  * Filters qualities in a MediaTimeline using a synchronous predicate.
@@ -14,5 +14,5 @@ export declare function filterTimelineQualitiesAsync(filter: FilterPredicateAsyn
 /**
  * Creates a language filter predicate for use with filterTimelineQualities.
  */
-export { createLanguageFilter } from '../streaming/mediaTimelineLanguageFilter';
+export { createLanguageFilter } from './mediaTimelineLanguageFilter';
 //# sourceMappingURL=mediaTimelineFilter.d.ts.map

package/dist/types/ts4.1/streaming/mediaTimelineLanguageFilter.d.ts

@@ -1,4 +1,4 @@
-import type { MediaQualityMetadata } from '../streaming/MediaQualityMetadata';
+import type { MediaQualityMetadata } from './MediaQualityMetadata';
 import type { FilterPredicate } from '@amazon/vinyl-util';
 /**
  * Creates a filter predicate that keeps qualities matching the preferred language.

package/dist/types/ts4.1/streaming/util/segment.d.ts

@@ -1,4 +1,4 @@
-import type { MediaSegmentMetadata } from '../../streaming/SegmentReference';
+import type { MediaSegmentMetadata } from '../SegmentReference';
 /**
  * Returns the segment whose range covers `time` (`startTime <= time < endTime`), or
  * — when `affordance > 0` — the next segment if `time` falls within `affordance`