@amazon/vinyl 1.1.1 → 1.2.1

package/dist/types/ts4.7/ad/AdsProvider.d.ts

@@ -0,0 +1,28 @@
+import type { AnyRecord, ReadonlyEventHost } from '@amazon/vinyl-util';
+import type { TrackAds } from './AdBreakInfo';
+/**
+ * Events dispatched by an {@link AdsProvider}.
+ */
+export interface AdsProviderEventMap {
+    /**
+     * The set of ads has changed; consumers should re-read via
+     * {@link AdsProvider.getAds}.
+     */
+    readonly adsChange: AnyRecord;
+}
+/**
+ * The minimal surface an {@link AdController} needs to source its ad breaks:
+ * a resolver for the current break list, plus an `adsChange` event to signal
+ * when that list changes. A {@link ReadonlyTrack} satisfies this directly, so
+ * the current playing track can be passed as-is; applications may also
+ * implement it to supply ads out of band (e.g. from an external ad server).
+ */
+export interface AdsProvider extends ReadonlyEventHost<AdsProviderEventMap> {
+    /**
+     * Resolves to the provider's current ad breaks. The result may change over
+     * the provider's lifetime; each `adsChange` event indicates that a
+     * subsequent call may return different breaks.
+     */
+    getAds(): Promise<TrackAds>;
+}
+//# sourceMappingURL=AdsProvider.d.ts.map

package/dist/types/ts4.7/ad/defaultAdLoadOptionsResolver.d.ts

@@ -0,0 +1,12 @@
+import type { AdInfo } from './AdBreakInfo';
+import type { VinylTrackLoadOptions } from '../track/createVinylTrackFactories';
+import { ReportableError } from '@amazon/vinyl-util';
+export declare function defaultAdLoadOptionsResolver(adInfo: AdInfo): Promise<VinylTrackLoadOptions>;
+/**
+ * An error indicating that a method was called with illegal arguments.
+ */
+export declare class UnresolvableAdError extends ReportableError {
+    get [Symbol.toStringTag](): string;
+    constructor(message: string);
+}
+//# sourceMappingURL=defaultAdLoadOptionsResolver.d.ts.map

package/dist/types/ts4.7/ad/discoverHlsInterstitials.d.ts

@@ -0,0 +1,22 @@
+import type { HlsMediaPlaylist } from '@amazon/vinyl-hls-parser';
+import type { AdBreakList } from './AdBreakInfo';
+/**
+ * Discovers HLS Interstitial ad breaks from a parsed media playlist and maps
+ * them to the provider-agnostic {@link AdBreakInfo} model.
+ *
+ * HLS Interstitials (Apple's SGAI primitive) are carried as EXT-X-DATERANGE
+ * tags with `CLASS="com.apple.hls.interstitial"`. Each such range is anchored
+ * to a wall-clock `START-DATE`; this function converts that to a media-timeline
+ * start time by correlating it with the playlist's EXT-X-PROGRAM-DATE-TIME
+ * anchor. When the playlist carries no program date-time, and the range's
+ * start-date is not otherwise resolvable, the break is anchored to the start of
+ * the timeline (pre-roll) as a best effort.
+ *
+ * @param playlist The parsed HLS media playlist.
+ * @param baseUrl  The URL of the media playlist, used to resolve relative
+ *   `X-ASSET-URI` values.
+ * @param contentDuration The total content duration in seconds, if known, used
+ *   to classify post-rolls. Pass null/undefined for live or unknown durations.
+ */
+export declare function discoverHlsInterstitials(playlist: HlsMediaPlaylist, baseUrl: string, contentDuration?: number | null): Promise<AdBreakList>;
+//# sourceMappingURL=discoverHlsInterstitials.d.ts.map

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

@@ -1,9 +1,9 @@
 import { type AnyRecord, type Maybe, type ReadonlyAbort, type 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.7/drm/DrmControllerImpl.d.ts

@@ -1,7 +1,7 @@
 import { EventHostImpl, type Maybe, type ReadonlyAbort } 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.7/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.7/drm/DrmOptions.d.ts

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

package/dist/types/ts4.7/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.7/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.7/drm/commonEme/MsCommonEme.d.ts

@@ -1,6 +1,6 @@
 import { type Disposable, EventHostImpl, type Unsubscribe } from '@amazon/vinyl-util';
 import { type CommonEme, type CommonMediaKeys, type CommonMediaKeySession, type CommonMediaKeySessionEventMap, type CommonMediaKeySystemAccess, 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.7/drm/commonEme/StandardCommonEme.d.ts

@@ -1,6 +1,6 @@
 import { type Disposable, EventHostImpl, type Unsubscribe } 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.7/drm/commonEme/WebKitCommonEme.d.ts

@@ -2,8 +2,8 @@ import type { Unsubscribe } from '@amazon/vinyl-util';
 import { type Disposable, 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.7/drm/licenseProvider/LicenseProvider.d.ts

@@ -1,5 +1,5 @@
 import { type Maybe, type 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.7/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.7/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.7/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.7/playback/PlaybackControllerImpl.d.ts

@@ -1,7 +1,7 @@
 import { EventHostImpl, type ReadonlyRanges } from '@amazon/vinyl-util';
 import { type PlaybackController } from './PlaybackController';
 import { type PlaybackControllerEventMap, 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.
@@ -41,7 +41,7 @@ export declare const defaultPlaybackControllerImplOptions: {
  * Firefox can but if the playhead reaches the end of track before the media stream is closed, an 'ended' event
  * will never fire.
  */
-export declare function getMinSeekableBufferDefault(): 2 | 5;
+export declare function getMinSeekableBufferDefault(): 5 | 2;
 export interface PlaybackControllerImplDeps {
     readonly media: HTMLMediaElement;
     readonly loudnessNormalizationController: LoudnessNormalizationController;

package/dist/types/ts4.7/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.7/playback/nextHasMetadata.d.ts

@@ -1,4 +1,4 @@
-import type { PlaybackControllerEventMap, ReadonlyPlaybackController } from '../playback/ReadonlyPlaybackController';
+import type { PlaybackControllerEventMap, ReadonlyPlaybackController } from './ReadonlyPlaybackController';
 import { type AnyRecord, type 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.7/streaming/AudioOptions.d.ts

@@ -0,0 +1,39 @@
+import type { ObjectSchema } from '@amazon/vinyl-validation';
+/**
+ * Criteria used to pick which audio rendition to play.
+ */
+export interface AudioSelection {
+    /**
+     * Preferred language(s) for audio content, as RFC 5646 codes (e.g. `'en'`,
+     * `'ja'`, `'fr-CA'`). May be a single tag or an ordered list of tags —
+     * earlier entries are preferred, with the best relatedness match kept for
+     * each period (audio without a language tag is always kept). `null` (the
+     * default) is NOT "no preference": it orders by the platform's
+     * `navigator.languages`. To keep every language, this option is not the
+     * mechanism — omit language content or pass a tag matching all.
+     */
+    readonly language?: string | readonly string[] | null;
+    /**
+     * Opt in to audio-description (a.k.a. described-video / DVS) audio: audio
+     * renditions carrying an accessibility "describes video" characteristic that
+     * narrate on-screen action. `false` (the default) keeps them out of the
+     * automatic default-audio selection — they are chosen only when this is set.
+     * When `true`, a description rendition is preferred where one exists for the
+     * selected language. Changing this reselects audio immediately.
+     */
+    readonly descriptive?: boolean;
+}
+/**
+ * Declarative audio configuration. Mirrors `VinylOptions.text`: the audio
+ * rendition is chosen from {@link selection}; changing it reselects audio
+ * immediately.
+ */
+export interface AudioOptions {
+    /**
+     * The audio selection criteria (language / descriptive).
+     */
+    readonly selection?: AudioSelection;
+}
+export declare const defaultAudioOptions: AudioOptions;
+export declare const audioOptionsValidator: ObjectSchema<AudioOptions>;
+//# sourceMappingURL=AudioOptions.d.ts.map

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

@@ -1,8 +1,8 @@
 import { type Disposable, EventHostImpl, type Maybe, type ReadonlyEventHost, type ReadonlyRanges } 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.7/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.7/streaming/LoadMetric.d.ts

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

package/dist/types/ts4.7/streaming/ManifestControllerImpl.d.ts

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

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

@@ -1,7 +1,7 @@
 import { type Maybe, type 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.7/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.7/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.7/streaming/SegmentControllerImpl.d.ts

@@ -1,11 +1,11 @@
 import { EventHostImpl, type ReadonlyAbort, type ReadonlyRanges } from '@amazon/vinyl-util';
 import type { ReadonlyPlaybackController } from '../playback/ReadonlyPlaybackController';
-import { type PrefetchOptions, type SegmentController, type SegmentControllerEventMap } from '../streaming/SegmentController';
-import type { SegmentReference } from '../streaming/SegmentReference';
-import type { ContentType, MediaQualityMetadata } from '../streaming/MediaQualityMetadata';
+import { type PrefetchOptions, type SegmentController, type 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.
  */
@@ -73,7 +73,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.7/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.7/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.7/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.7/streaming/abr/QualitySelectorImpl.d.ts

@@ -1,7 +1,7 @@
-import type { PrefetchState, QualitySelector } from '../../streaming/abr/QualitySelector';
-import { type Disposable, type LogTarget } from '@amazon/vinyl-util';
+import type { PrefetchState, QualitySelector } from './QualitySelector';
+import { type Disposable, type LogTarget, type Maybe } from '@amazon/vinyl-util';
 import { type ObjectSchema } from '@amazon/vinyl-validation';
-import type { MediaQualityMetadata } from '../../streaming/MediaQualityMetadata';
+import type { MediaQualityMetadata } from '../MediaQualityMetadata';
 import type { ObservableValue } from '@amazon/vinyl-observable';
 export interface QualitySelectorImplOptions {
     /**
@@ -52,6 +52,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.7/streaming/buffering/BufferingController.d.ts

@@ -1,17 +1,11 @@
 import { type AnyRecord, type Clearable, type Disposable, EventHostImpl, type ReadonlyEventHost } from '@amazon/vinyl-util';
 import type { ReadonlyPlaybackController } from '../../playback/ReadonlyPlaybackController';
 import type { SourceBufferController } from './SourceBufferController';
-import type { ReadonlySegmentController } from '../../streaming/SegmentController';
+import type { ReadonlySegmentController } from '../SegmentController';
 import type { BasicErrorEvent } from '../../event/BasicErrorEvent';
 import type { ChangeEvent } from '../../event/ChangeEvent';
-import type { ContentType, MediaQualityMetadata } from '../../streaming/MediaQualityMetadata';
-import { type MediaSourceController } from '../../streaming/buffering/MediaSourceController';
-/**
- * Chrome 52 has decoding errors when duration is set to the mediaPresentationDuration.
- * Adds a slight padding as a workaround.
- * @private
- */
-export declare const DURATION_PADDING = 0.1;
+import type { ContentType, MediaQualityMetadata } from '../MediaQualityMetadata';
+import { type MediaSourceController } from './MediaSourceController';
 /**
  * The interval to throttle polling the buffer.
  * Reset after a seek.
@@ -170,10 +164,6 @@ export declare class BufferingControllerImpl extends EventHostImpl<BufferingCont
      * Returns true if there are active operations.
      */
     get busy(): boolean;
-    /**
-     * Enqueues a duration update.
-     */
-    private refreshDuration;
     /**
      * Resets the throttle and polls the buffer on the next frame.
      */