@amazon/vinyl 1.2.0 → 1.2.1

package/dist/types/ts4.1/ad/AdController.d.ts

@@ -0,0 +1,243 @@
+import type { ChangeEvent } from '../event/ChangeEvent';
+import type { ReadonlyEventHost } from '@amazon/vinyl-util';
+import type { AdBreakInfo, AdInfo, TrackAds } from './AdBreakInfo';
+import type { AdsProvider } from './AdsProvider';
+/**
+ * Events dispatched by an {@link AdController}. These are provider-agnostic:
+ * an application listens once and receives the same events whether the ads
+ * originate from HLS Interstitials or DASH SCTE-35.
+ */
+export interface AdEventMap {
+    /**
+     * Emitted when the set of known ad breaks for the current media changes,
+     * for example when a live manifest reveals a new break.
+     */
+    readonly currentTrackAdsChange: ChangeEvent<TrackAds | null>;
+    /**
+     * Dispatched when the playhead approaches a midroll or postroll break —
+     * within the break's resolution/preload window — so its ad assets can be
+     * resolved and warmed ahead of entry. Fires once per break as it is
+     * approached (again after a seek back re-arms a replayable break). Prerolls
+     * are preloaded up front and do not emit this.
+     */
+    readonly adPreload: AdBreakEvent;
+    /**
+     * Dispatched when an ad break has been entered — its ads may still be
+     * resolving. An ad break may contain one or more ads.
+     */
+    readonly adBreakEntered: AdBreakEvent;
+    /**
+     * Dispatched when the current ad break has completed: all of its ads
+     * played, were skipped, it hit its playout limit, or it had no ads. Carries
+     * the position at which primary content resumes.
+     */
+    readonly adBreakCompleted: AdBreakCompleteEvent;
+    /**
+     * Dispatched when an ad region has been entered.
+     */
+    readonly adEntered: AdEvent;
+    /**
+     * Dispatched when an ad has started playing.
+     */
+    readonly adPlaying: AdEvent;
+    /**
+     * Dispatched on each playback progress tick while an ad is active, carrying
+     * the elapsed and remaining time for both the current ad and the whole ad
+     * break. Applications should prefer this over deriving ad timing from the
+     * media element's duration.
+     */
+    readonly adTimeUpdate: AdTimeUpdateEvent;
+    /**
+     * Dispatched when an ad has played through 25%.
+     */
+    readonly adFirstQuartile: AdProgressEvent;
+    /**
+     * Dispatched when an ad has played through 50%.
+     */
+    readonly adMidpoint: AdProgressEvent;
+    /**
+     * Dispatched when an ad has played through 75%.
+     */
+    readonly adThirdQuartile: AdProgressEvent;
+    /**
+     * Dispatched when an ad has played through 100%.
+     * Will be dispatched before adCompleted.
+     */
+    readonly adEnded: AdProgressEvent;
+    /**
+     * Dispatched when an ad has stopped playing for any reason such as
+     * ended, error, or skipped.
+     */
+    readonly adCompleted: AdCompleteEvent;
+    /**
+     * An ad list or an individual ad failed to complete.
+     */
+    readonly adError: AdErrorEvent;
+}
+export interface AdErrorEvent {
+    /**
+     * The current ad break when the ad failed to load.
+     */
+    readonly adBreak: AdBreakInfo;
+    /**
+     * If set, the error was from an individual ad.
+     * If not set, the failure was in loading the ad list.
+     */
+    readonly currentAd: AdInfo | null;
+    /**
+     * The source error.
+     */
+    readonly error: any;
+}
+export interface AdEvent {
+    /** The parent ad break */
+    readonly adBreak: AdBreakInfo;
+    /** The ad that triggered this event. */
+    readonly ad: AdInfo;
+    /** The zero-based position of this ad within its break. */
+    readonly index: number;
+    /** The total number of ads in this break. */
+    readonly totalAds: number;
+}
+export interface AdProgressEvent extends AdEvent {
+    /**
+     * The average continuous playback rate for the quartile.
+     * Typically, 1.0 unless playbackRate was altered.
+     */
+    readonly playbackRateAvg: number;
+}
+export interface AdTimeUpdateEvent extends AdEvent {
+    /** Seconds the current ad has played. */
+    readonly adCurrentTime: number;
+    /**
+     * Seconds remaining in the current ad, or null when the ad's duration is
+     * unknown.
+     */
+    readonly adTimeRemaining: number | null;
+    /**
+     * Seconds the current ad break has played, summed across all of its ads so
+     * far (including the current one).
+     */
+    readonly breakCurrentTime: number;
+    /**
+     * Seconds remaining in the current ad break as a whole, or null when the
+     * break's total duration is unknown.
+     */
+    readonly breakTimeRemaining: number | null;
+    /**
+     * Whether the current ad may be skipped right now — false while skipping is
+     * restricted or the break's skip window has not yet opened. Applications
+     * should gate their skip control on this.
+     */
+    readonly canSkip: boolean;
+    /**
+     * Seconds until the ad becomes skippable, or null when there is no pending
+     * skip window (it is already skippable, or skipping is never offered).
+     */
+    readonly skipIn: number | null;
+}
+export interface AdCompleteEvent extends AdEvent {
+    /** The current ad break. */
+    readonly adBreak: AdBreakInfo;
+    /** The reason the ad changed, e.g. 'ended' for completed naturally, or 'skipped' */
+    readonly reason: AdChangeReason;
+}
+export interface AdBreakEvent {
+    /** The ad break. */
+    readonly adBreak: AdBreakInfo;
+}
+export interface AdBreakCompleteEvent extends AdBreakEvent {
+    /**
+     * The absolute media-timeline position, in seconds, at which primary content
+     * resumes after this break. The controller has already resolved the break's
+     * resume offset and playout, so consumers use this position directly.
+     */
+    readonly resumePosition: number;
+    /** The reason the ad break changed, e.g. 'ended' for completed naturally, or 'skipped' */
+    readonly reason: AdChangeReason;
+}
+export type AdChangeReason = 'ended' | 'skipped' | 'contentChange' | 'error';
+export declare const ALL_AD_EVENTS: readonly [
+    "currentTrackAdsChange",
+    "adPreload",
+    "adBreakEntered",
+    "adBreakCompleted",
+    "adFirstQuartile",
+    "adEntered",
+    "adPlaying",
+    "adTimeUpdate",
+    "adMidpoint",
+    "adThirdQuartile",
+    "adEnded",
+    "adCompleted",
+    "adError"
+];
+/**
+ * Read-only view of the ad breaks for the current media and which break, if
+ * any, currently contains the playhead.
+ */
+export interface ReadonlyAdController extends ReadonlyEventHost<AdEventMap> {
+    /**
+     * The ad breaks known for the current media.
+     */
+    readonly currentTrackAds: TrackAds | null;
+    /**
+     * The ad break currently containing the playhead, or null when the
+     * playhead is in primary content.
+     */
+    readonly currentAdBreak: AdBreakInfo | null;
+    /**
+     * The ad currently playing within the active break, or null.
+     */
+    readonly currentAd: AdInfo | null;
+}
+/**
+ * Tracks the ad breaks for the current media and reports when the playhead
+ * enters and exits them.
+ *
+ * The controller is deliberately agnostic of HLS/DASH discovery details: its
+ * input is a list of {@link AdBreakInfo} sourced from an {@link AdsProvider}
+ * (set via {@link setAdsProvider}); it derives the active break from the
+ * playhead by observing the playback controller.
+ */
+export interface AdController extends ReadonlyAdController {
+    /**
+     * Sets the source of ad breaks, or null when no source is active. A
+     * `ReadonlyTrack` satisfies {@link AdsProvider} directly, so the current
+     * playing track can be passed as-is.
+     */
+    setAdsProvider(provider: AdsProvider | null): void;
+    /**
+     * Skips the entire active ad break, advancing past all remaining ads.
+     * No-op when no ad break is active.
+     */
+    skipAdBreak(): void;
+    /**
+     * Skips the currently playing ad. If there are more ads in the break,
+     * the next ad begins. If it's the last ad, the break ends.
+     * No-op when no ad break is active.
+     */
+    skipAd(): void;
+    /**
+     * Skips the current ad with 'error' for the completed reason.
+     * Emits an 'adError' event.
+     * If there are more ads in the break,
+     * the next ad begins. If it's the last ad, the break ends.
+     *
+     * No-op when no ad break is active.
+     */
+    failAd(error: Error): void;
+    /**
+     * Activates the preroll ads.
+     * Does nothing if there is no preroll.
+     * Resolves with the active preroll, or null if there wasn't one.
+     */
+    enterPreroll(): Promise<AdBreakInfo | null>;
+    /**
+     * Activates the next postroll ad.
+     * Does nothing if there is no postroll.
+     * Resolves with the active postroll, or null if there wasn't one.
+     */
+    enterPostroll(): Promise<AdBreakInfo | null>;
+}
+//# sourceMappingURL=AdController.d.ts.map

package/dist/types/ts4.1/ad/AdControllerImpl.d.ts

@@ -0,0 +1,146 @@
+import { EventHostImpl } from '@amazon/vinyl-util';
+import type { AdBreakInfo, AdInfo, TrackAds } from './AdBreakInfo';
+import type { AdController, AdEventMap } from './AdController';
+import type { ReadonlyPlaybackController } from '../playback/ReadonlyPlaybackController';
+import type { AdsProvider } from './AdsProvider';
+/**
+ * The % playhead start tolerance for playback progress when emitting ad progress events.
+ */
+export declare const AD_START_TOLERANCE = 0.05;
+export interface AdControllerImplDeps {
+    readonly playbackController: ReadonlyPlaybackController;
+}
+export interface AdControllerImplOptions {
+    /**
+     * After an ad is set, the number of seconds to wait for playback to begin
+     * before marking the ad as failed.
+     * Default: 15
+     */
+    readonly adLoadTimeout: number;
+    /**
+     * How many seconds ahead of a midroll or postroll break to emit `adPreload`
+     * (so its ad assets can be warmed before the playhead reaches it). Used only
+     * when the break itself carries no {@link AdBreakInfo.resolutionTimeOffset};
+     * a break's own offset always takes precedence.
+     * Default: 10
+     */
+    readonly preloadAheadTime: number;
+}
+export declare const defaultAdControllerImplOptions: AdControllerImplOptions;
+/**
+ * Provider-agnostic {@link AdController}. Holds the discovered ad breaks and
+ * derives enter/exit region events from playhead time updates.
+ *
+ * This controller is the *model* for ad playback: it knows which breaks exist,
+ * which break contains the playhead, and which ad within that break is current.
+ * It does NOT create, preload, or activate any tracks — that is the
+ * responsibility of the {@link TrackController}.
+ *
+ * A break is considered active while `startTime <= currentTime < endTime`,
+ * where `endTime` is `startTime + duration`. Breaks whose duration is unknown
+ * (null) or breaks which restrict `jump` will become active at
+ * `currentTime > startTime`
+ *
+ * This class contains no HLS- or DASH-specific logic; discovery code maps its
+ * protocol's signals to {@link AdBreakInfo} exposed by an
+ * {@link AdsProvider.getAds}, which this controller reads once the provider is
+ * set via {@link AdController.setAdsProvider} (and re-reads on `adsChange`).
+ */
+export declare class AdControllerImpl extends EventHostImpl<AdEventMap> implements AdController {
+    private readonly deps;
+    get [Symbol.toStringTag](): string;
+    private readonly options;
+    private _trackAds;
+    private adsProviderSub;
+    private adsProvider;
+    private midrollAds;
+    private preloadableBreaks;
+    private readonly preloadedBreakIds;
+    private lastPlaybackTime;
+    private pendingAdBreaks;
+    private readonly completeAdBreakIds;
+    private readonly spentBreakIds;
+    private readonly disposer;
+    private adBreakState;
+    private loadingNext;
+    constructor(deps: AdControllerImplDeps, options?: Partial<AdControllerImplOptions>);
+    clearCompletedAds(): void;
+    private isBreakSuppressed;
+    /** The media-time the current ad has actually played, or 0 if not playing. */
+    private adElapsed;
+    /**
+     * Computes whether the current ad may be skipped and, when not yet, how many
+     * seconds remain until it can. A `skip` restriction blocks it outright;
+     * otherwise a resolved skip window gates it by the elapsed break playout, and
+     * with no window the ad is freely skippable.
+     */
+    private resolveSkipState;
+    get currentTrackAds(): (TrackAds | null);
+    private setTrackAds;
+    /**
+     * Returns a function that returns true if the ads provider has changed
+     * since the callback was created.
+     */
+    private providerInterrupted;
+    setAdsProvider(provider: AdsProvider | null): void;
+    enterPreroll(): Promise<AdBreakInfo | null>;
+    enterPostroll(): Promise<AdBreakInfo | null>;
+    private enterRoll;
+    private get hasProvider();
+    skipAdBreak(): void;
+    /**
+     * Marks an ad break as completed (or 'spent' and replayable), emits an `adBreakCompleted` event.
+     */
+    private completeAdBreak;
+    get currentAdBreak(): (AdBreakInfo | null);
+    /**
+     * Marks an ad as completed and emits an `adCompleted` event.
+     */
+    private completeAd;
+    /**
+     * Polls the next pending ad and activates it.
+     * When there are no remaining ads, activates the next ad break (if any).
+     */
+    private nextAdOrBreak;
+    get currentAd(): (AdInfo | null);
+    private get adState();
+    private startAd;
+    /**
+     * Checks if the playhead has entered a time to activate a midroll ad.
+     */
+    private onTimeUpdate;
+    /**
+     * Emits `adPreload` once for each midroll/postroll break the playhead is
+     * approaching — within (the break's {@link AdBreakInfo.resolutionTimeOffset}
+     * or, when absent, the `preloadAheadTime` option) seconds before its start —
+     * so a consumer can resolve and warm the break's assets before entry.
+     * Suppressed (played-once/spent) breaks are skipped.
+     */
+    private checkAdPreload;
+    /**
+     * Main content with ad breaks is playing, check if we have entered a midroll region.
+     */
+    private checkMidrollIngress;
+    /**
+     * Emits events for `adTimeUpdate`, `adFirstQuartile`, `adMidpoint`, and
+     * `adThirdQuartile`.
+     * (Does not emit `adCompleted`)
+     */
+    private emitAdProgressEvents;
+    private emitTimeUpdate;
+    /**
+     * Ads breaks can have a playout limit that may cut off ad playback.
+     * End the ad if that limit is reached.
+     */
+    private enforcePlayoutLimits;
+    private setPendingBreaks;
+    skipAd(): void;
+    failAd(error: Error): void;
+    private endAd;
+    get disposed(): boolean;
+    /**
+     * Disposes this controller, removes all listeners.
+     */
+    dispose(): void;
+}
+//# sourceMappingURL=AdControllerImpl.d.ts.map

package/dist/types/ts4.1/ad/AdError.d.ts

@@ -0,0 +1,6 @@
+import { ErrorLevel, ReportableError } from '@amazon/vinyl-util';
+export declare class AdError extends ReportableError {
+    get [Symbol.toStringTag](): string;
+    constructor(message: string, origin?: string, level?: ErrorLevel);
+}
+//# sourceMappingURL=AdError.d.ts.map

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

@@ -43,7 +43,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.1/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.1/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.1/streaming/ManifestControllerImpl.d.ts

@@ -0,0 +1,40 @@
+import type { MutableValue } from '@amazon/vinyl-observable';
+import type { EventHandler, SignalOptions, 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>;
+    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.1/streaming/buffering/codecDenylist.d.ts

@@ -0,0 +1,23 @@
+/**
+ * Records every codec in the given mimeType as denylisted. Returns true if any
+ * codec was newly added (i.e. was not already denylisted), false if all codecs
+ * were already present. The return value lets callers bound retry loops: a
+ * repeat failure for an already-denylisted codec should not trigger another
+ * fallback attempt.
+ */
+export declare function denylistCodecsFromMimeType(mimeType: string): boolean;
+/**
+ * Returns true when any codec in the given mimeType has been denylisted.
+ */
+export declare function isMimeTypeDenylisted(mimeType: string): boolean;
+/**
+ * Returns the currently denylisted codec strings (lowercased). Primarily for
+ * diagnostics and testing.
+ */
+export declare function getDenylistedCodecs(): readonly string[];
+/**
+ * Clears the runtime codec denylist. Intended for tests and for re-detecting
+ * support (e.g. after an environment change).
+ */
+export declare function clearCodecDenylist(): void;
+//# sourceMappingURL=codecDenylist.d.ts.map

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

@@ -0,0 +1,30 @@
+import type { RestrictableContentType } from './MediaQualityMetadata';
+import type { ContentTypesValue } from './ContentTypesValue';
+import type { ObservableValue } from '@amazon/vinyl-observable';
+export interface AllowedContentTypesValueDeps {
+    /**
+     * The unfiltered content types present in the manifest.
+     */
+    readonly baseContentTypesValue: ContentTypesValue;
+    /**
+     * The player options. The `allowedContentTypes` allow list restricts which
+     * media content types are streamed; `null` means no restriction.
+     */
+    readonly options: ObservableValue<{
+        readonly allowedContentTypes: readonly RestrictableContentType[] | null;
+    }>;
+}
+/**
+ * Wraps a {@link ContentTypesValue} with the `allowedContentTypes` allow list
+ * from the player options. When the allow list is set, only media content
+ * types (`'audio'`, `'video'`) in the list are emitted; other media streams
+ * are ignored. When it is `null`, the underlying content types pass through
+ * unchanged. Text is never restricted by the allow list and always passes
+ * through (captions are governed by caption selection).
+ *
+ * Because the result is derived from the `allowedContentTypes` option via
+ * {@link combineData}, changing the option re-emits a newly filtered set, which
+ * reloads the track using only the allowed content types.
+ */
+export declare function createAllowedContentTypesValue(deps: AllowedContentTypesValueDeps): ContentTypesValue;
+//# sourceMappingURL=createAllowedContentTypesValue.d.ts.map