@amazon/vinyl 1.0.0

package/dist/types/current/playback/logging/mediaErrorToJson.d.ts

@@ -0,0 +1,7 @@
+import type { Maybe } from '@amazon/vinyl-util';
+export declare function mediaErrorToJson(error: Maybe<MediaError>): {
+    readonly name: string;
+    readonly message: string;
+    readonly code: number;
+};
+//# sourceMappingURL=mediaErrorToJson.d.ts.map

package/dist/types/current/playback/logging/mediaErrorToJson.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mediaErrorToJson.d.ts","sourceRoot":"","sources":["../../../../../src/playback/logging/mediaErrorToJson.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,oBAAoB,CAAA;AAE/C,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,KAAK,CAAC,UAAU,CAAC,GAAG;IACxD,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;IACrB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAA;IACxB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;CACxB,CAmCA"}

package/dist/types/current/playback/logging/mediaErrorToJson.js

@@ -0,0 +1,40 @@
+/*
+ * Copyright Amazon.com, Inc. or its affiliates. All Rights Reserved.
+ * SPDX-License-Identifier: Apache-2.0
+ */
+export function mediaErrorToJson(error) {
+    let message = 'An unknown media error has occurred.';
+    let name = 'UNKNOWN_MEDIA_ERROR';
+    let code = -1;
+    if (error) {
+        code = error.code;
+        switch (error.code) {
+            case error.MEDIA_ERR_ABORTED: {
+                message = `The requesting of the associated resource was aborted by the user's request.`;
+                name = 'MEDIA_ERR_ABORTED';
+                break;
+            }
+            case error.MEDIA_ERR_NETWORK: {
+                message = 'A network error occurred.';
+                name = 'MEDIA_ERR_NETWORK';
+                break;
+            }
+            case error.MEDIA_ERR_DECODE: {
+                name = 'MEDIA_ERR_DECODE';
+                message =
+                    'An error occurred while trying to decode the media resource.';
+                break;
+            }
+            case error.MEDIA_ERR_SRC_NOT_SUPPORTED: {
+                name = 'MEDIA_ERR_SRC_NOT_SUPPORTED';
+                message = 'The associated resource was not supported.';
+                break;
+            }
+        }
+    }
+    return {
+        name,
+        message,
+        code,
+    };
+}

package/dist/types/current/playback/logging/playbackStateLoggingHandler.d.ts

@@ -0,0 +1,15 @@
+import type { Disposable } from '@amazon/vinyl-util';
+import type { ReadonlyPlaybackController } from '../../playback/ReadonlyPlaybackController';
+/**
+ * The number of seconds to throttle timeupdate logs.
+ * Logs will not be emitted for timeupdate events less than this interval.
+ */
+export declare const TIMEUPDATE_THROTTLE = 5;
+/**
+ * Logs all playback state events.
+ *
+ * @param playbackState The event host with playback events to observe.
+ * @return Returns a disposable handle to remove all added handlers.
+ */
+export declare function playbackStateLoggingHandler(playbackState: ReadonlyPlaybackController): Disposable;
+//# sourceMappingURL=playbackStateLoggingHandler.d.ts.map

package/dist/types/current/playback/logging/playbackStateLoggingHandler.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"playbackStateLoggingHandler.d.ts","sourceRoot":"","sources":["../../../../../src/playback/logging/playbackStateLoggingHandler.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAA;AAGpD,OAAO,KAAK,EAAE,0BAA0B,EAAE,MAAM,uCAAuC,CAAA;AAMvF;;;GAGG;AACH,eAAO,MAAM,mBAAmB,IAAI,CAAA;AAgBpC;;;;;GAKG;AACH,wBAAgB,2BAA2B,CACvC,aAAa,EAAE,0BAA0B,GAC1C,UAAU,CAuDZ"}

package/dist/types/current/playback/logging/playbackStateLoggingHandler.js

@@ -0,0 +1,78 @@
+/*
+ * Copyright Amazon.com, Inc. or its affiliates. All Rights Reserved.
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import { createDisposer } from '@amazon/vinyl-util';
+import { logDebug } from '@amazon/vinyl-util';
+import { ALL_PLAYBACK_STATE_EVENTS } from '../../playback/ReadonlyPlaybackController';
+import { throttle } from '@amazon/vinyl-util';
+import { substitute } from '@amazon/vinyl-util';
+import { createLogPrefix } from '@amazon/vinyl-util';
+/**
+ * The number of seconds to throttle timeupdate logs.
+ * Logs will not be emitted for timeupdate events less than this interval.
+ */
+export const TIMEUPDATE_THROTTLE = 5;
+/**
+ * @private
+ */
+const locale = {
+    /**
+     * The timeupdate log message when grouping several updates together.
+     *
+     * Param start - start time
+     * Param end - end time
+     * Param count - number of events
+     */
+    timeupdateLogBatch: 'timeUpdate {start}-{end} x{count}',
+};
+/**
+ * Logs all playback state events.
+ *
+ * @param playbackState The event host with playback events to observe.
+ * @return Returns a disposable handle to remove all added handlers.
+ */
+export function playbackStateLoggingHandler(playbackState) {
+    const target = {
+        logPrefix: createLogPrefix('Playback'),
+    };
+    const disposer = createDisposer();
+    const { add } = disposer;
+    // Log time update events so that sequential time updates are debounced.
+    let timeUpdateCount = 0;
+    let startTime = null;
+    /**
+     * Logs the cumulated timeupdate event counts, resetting the window.
+     */
+    const logTimeupdateBatch = () => {
+        if (startTime == null)
+            return;
+        const currentTime = playbackState.currentTime;
+        logDebug(target, substitute(locale.timeupdateLogBatch, {
+            start: startTime.toFixed(1),
+            end: currentTime.toFixed(1),
+            count: timeUpdateCount,
+        }));
+        timeUpdateCount = 0;
+        startTime = null;
+    };
+    /**
+     * Throttles timeupdate logs to the given interval.
+     */
+    const logTimeupdateBatchThrottled = add(throttle(logTimeupdateBatch, TIMEUPDATE_THROTTLE, { trailing: true }));
+    add(playbackState.on('timeUpdate', () => {
+        timeUpdateCount++;
+        if (startTime == null)
+            startTime = playbackState.currentTime;
+        logTimeupdateBatchThrottled();
+    }));
+    for (const type of ALL_PLAYBACK_STATE_EVENTS) {
+        if (type === 'timeUpdate')
+            continue;
+        add(playbackState.on(type, (event) => {
+            logTimeupdateBatch();
+            logDebug(target, type, event);
+        }));
+    }
+    return disposer;
+}

package/dist/types/current/playback/loudness/LoudnessNormalizationController.d.ts

@@ -0,0 +1,25 @@
+import type { AnyRecord, Clearable, EventHost } from '@amazon/vinyl-util';
+/**
+ * Event map for LoudnessNormalizationController.
+ */
+export interface LoudnessNormalizationControllerEventMap {
+    readonly change: AnyRecord;
+}
+/**
+ * Handles loudness normalization by applying gain adjustments
+ * based on track loudness metadata.
+ */
+export interface LoudnessNormalizationController extends EventHost<LoudnessNormalizationControllerEventMap>, Clearable {
+    /**
+     * Loudness gain adjustment value.
+     */
+    readonly gain: number;
+    /**
+     * Sets the current track's loudness level in LUFS, for the current track
+     * played.
+     *
+     * @param value
+     */
+    setTrackLoudness(value: number | null): void;
+}
+//# sourceMappingURL=LoudnessNormalizationController.d.ts.map

package/dist/types/current/playback/loudness/LoudnessNormalizationController.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"LoudnessNormalizationController.d.ts","sourceRoot":"","sources":["../../../../../src/playback/loudness/LoudnessNormalizationController.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,SAAS,EAAE,SAAS,EAAE,SAAS,EAAE,MAAM,oBAAoB,CAAA;AAEzE;;GAEG;AACH,MAAM,WAAW,uCAAuC;IACpD,QAAQ,CAAC,MAAM,EAAE,SAAS,CAAA;CAC7B;AAED;;;GAGG;AACH,MAAM,WAAW,+BACb,SAAQ,SAAS,CAAC,uCAAuC,CAAC,EAAE,SAAS;IACrE;;OAEG;IACH,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;IAErB;;;;;OAKG;IACH,gBAAgB,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,GAAG,IAAI,CAAA;CAC/C"}

package/dist/types/current/playback/loudness/LoudnessNormalizationController.js

@@ -0,0 +1,5 @@
+/*
+ * Copyright Amazon.com, Inc. or its affiliates. All Rights Reserved.
+ * SPDX-License-Identifier: Apache-2.0
+ */
+export {};

package/dist/types/current/playback/loudness/LoudnessNormalizationControllerImpl.d.ts

@@ -0,0 +1,44 @@
+import { type LogTarget } from '@amazon/vinyl-util';
+import { EventHostImpl } from '@amazon/vinyl-util';
+import type { LoudnessNormalizationController, LoudnessNormalizationControllerEventMap } from './LoudnessNormalizationController';
+import { type LoudnessNormalizationControllerImplOptions } from './LoudnessNormalizationControllerImplOptions';
+import type { ObservableValue } from '@amazon/vinyl-observable';
+export type LoudnessNormalizationControllerImplDeps = {
+    readonly options: ObservableValue<LoudnessNormalizationControllerImplOptions>;
+};
+/**
+ * Applies gain adjustment based on track loudness metadata from manifest.
+ * This controller normalizes audio loudness to a target level for consistent playback volume.
+ */
+export declare class LoudnessNormalizationControllerImpl extends EventHostImpl<LoudnessNormalizationControllerEventMap> implements LoudnessNormalizationController, LogTarget {
+    private readonly deps;
+    get [Symbol.toStringTag](): string;
+    readonly logPrefix: string;
+    private _gain;
+    private readonly disposer;
+    private trackLoudness;
+    private _options;
+    constructor(deps: LoudnessNormalizationControllerImplDeps);
+    get options(): Required<LoudnessNormalizationControllerImplOptions>;
+    setTrackLoudness(value: number | null): void;
+    /**
+     * Returns the loudness gain value which needs to be applied, for current track playback.
+     */
+    get gain(): number;
+    /**
+     * Sets the loudness gain value for current track playback.
+     *
+     * @param value New gain value to apply
+     */
+    private set gain(value);
+    /**
+     * Update gain value based on current track loudness and target loudness.
+     */
+    private updateGain;
+    /**
+     * Resets the loudness gain Value to max gain value.
+     */
+    clear(): void;
+    dispose(): void;
+}
+//# sourceMappingURL=LoudnessNormalizationControllerImpl.d.ts.map

package/dist/types/current/playback/loudness/LoudnessNormalizationControllerImpl.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"LoudnessNormalizationControllerImpl.d.ts","sourceRoot":"","sources":["../../../../../src/playback/loudness/LoudnessNormalizationControllerImpl.ts"],"names":[],"mappings":"AAKA,OAAO,EAAkB,KAAK,SAAS,EAAE,MAAM,oBAAoB,CAAA;AACnE,OAAO,EAGH,aAAa,EAEhB,MAAM,oBAAoB,CAAA;AAC3B,OAAO,KAAK,EACR,+BAA+B,EAC/B,uCAAuC,EAC1C,MAAM,mCAAmC,CAAA;AAC1C,OAAO,EAEH,KAAK,0CAA0C,EAClD,MAAM,8CAA8C,CAAA;AACrD,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,0BAA0B,CAAA;AAE/D,MAAM,MAAM,uCAAuC,GAAG;IAClD,QAAQ,CAAC,OAAO,EAAE,eAAe,CAAC,0CAA0C,CAAC,CAAA;CAChF,CAAA;AAKD;;;GAGG;AACH,qBAAa,mCACT,SAAQ,aAAa,CAAC,uCAAuC,CAC7D,YAAW,+BAA+B,EAAE,SAAS;IAejD,OAAO,CAAC,QAAQ,CAAC,IAAI;IAbzB,IAAI,CAAC,MAAM,CAAC,WAAW,CAAC,IAAI,MAAM,CAEjC;IACD,QAAQ,CAAC,SAAS,SAAwB;IAE1C,OAAO,CAAC,KAAK,CAAyB;IACtC,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAmB;IAE5C,OAAO,CAAC,aAAa,CAAsB;IAC3C,OAAO,CAAC,QAAQ,CACqC;gBAGhC,IAAI,EAAE,uCAAuC;IAelE,IAAI,OAAO,IAAI,QAAQ,CAAC,0CAA0C,CAAC,CAElE;IAED,gBAAgB,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,GAAG,IAAI;IAK5C;;OAEG;IACH,IAAW,IAAI,IAAI,MAAM,CAExB;IAED;;;;OAIG;IACH,OAAO,KAAK,IAAI,QAYf;IAED;;OAEG;IACH,OAAO,CAAC,UAAU;IAgBlB;;OAEG;IACH,KAAK,IAAI,IAAI;IAIb,OAAO,IAAI,IAAI;CAIlB"}

package/dist/types/current/playback/loudness/LoudnessNormalizationControllerImpl.js

@@ -0,0 +1,95 @@
+/*
+ * Copyright Amazon.com, Inc. or its affiliates. All Rights Reserved.
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import { createDisposer } from '@amazon/vinyl-util';
+import { logDebug, createLogPrefix, EventHostImpl, closeTo, } from '@amazon/vinyl-util';
+import { defaultLoudnessNormalizationControllerImplOptions, } from './LoudnessNormalizationControllerImplOptions';
+const DECIBEL_EXPONENT_BASE = Math.pow(10, 1 / 10);
+const MAX_GAIN_LEVEL = 1.0;
+/**
+ * Applies gain adjustment based on track loudness metadata from manifest.
+ * This controller normalizes audio loudness to a target level for consistent playback volume.
+ */
+export class LoudnessNormalizationControllerImpl extends EventHostImpl {
+    deps;
+    get [Symbol.toStringTag]() {
+        return 'LoudnessNormalizationControllerImpl';
+    }
+    logPrefix = createLogPrefix(this);
+    _gain = MAX_GAIN_LEVEL;
+    disposer = createDisposer();
+    trackLoudness = null;
+    _options = defaultLoudnessNormalizationControllerImplOptions;
+    constructor(deps) {
+        super();
+        this.deps = deps;
+        const { add } = this.disposer;
+        add(deps.options.onData((value) => {
+            this._options = {
+                ...defaultLoudnessNormalizationControllerImplOptions,
+                ...value,
+            };
+            this.updateGain();
+        }));
+    }
+    get options() {
+        return this._options;
+    }
+    setTrackLoudness(value) {
+        this.trackLoudness = value;
+        this.updateGain();
+    }
+    /**
+     * Returns the loudness gain value which needs to be applied, for current track playback.
+     */
+    get gain() {
+        return this._gain;
+    }
+    /**
+     * Sets the loudness gain value for current track playback.
+     *
+     * @param value New gain value to apply
+     */
+    set gain(value) {
+        const previousGain = this._gain;
+        // Emit change event if gain value changed
+        if (!closeTo(previousGain, value)) {
+            this._gain = value;
+            logDebug(this, 'loudness gain adjustment:', {
+                trackLoudness: this.trackLoudness,
+                targetLufs: this.options.targetLufs,
+                gain: value,
+            });
+            this.dispatch('change', {});
+        }
+    }
+    /**
+     * Update gain value based on current track loudness and target loudness.
+     */
+    updateGain() {
+        const { targetLufs, maxGainDb, enabled } = this.options;
+        const trackLoudness = this.trackLoudness;
+        if (trackLoudness == null) {
+            return;
+        }
+        if (trackLoudness <= targetLufs || !enabled) {
+            this.clear();
+            return;
+        }
+        // Calculate gain reduction for louder tracks
+        const dbReduction = Math.min(trackLoudness - targetLufs, maxGainDb);
+        this.gain =
+            MAX_GAIN_LEVEL / Math.pow(DECIBEL_EXPONENT_BASE, dbReduction);
+    }
+    /**
+     * Resets the loudness gain Value to max gain value.
+     */
+    clear() {
+        this.gain = MAX_GAIN_LEVEL;
+    }
+    dispose() {
+        super.dispose();
+        this.disposer.dispose();
+    }
+}

package/dist/types/current/playback/loudness/LoudnessNormalizationControllerImplOptions.d.ts

@@ -0,0 +1,28 @@
+import type { ObjectSchema } from '@amazon/vinyl-validation';
+/**
+ * Options for configuring the loudness normalization controller.
+ */
+export interface LoudnessNormalizationControllerImplOptions {
+    /**
+     * If true, applies loudness Normalization to the current track played.
+     * Default: false
+     */
+    readonly enabled: boolean;
+    /**
+     * Target loudness level in LUFS (Loudness Units relative to Full Scale).
+     * Default: -14.0 dB
+     */
+    readonly targetLufs?: number;
+    /**
+     * Maximum gain reduction to apply in dB.
+     * Default: 10 Db
+     */
+    readonly maxGainDb?: number;
+}
+export declare const defaultLoudnessNormalizationControllerImplOptions: {
+    readonly enabled: false;
+    readonly targetLufs: -14;
+    readonly maxGainDb: 10;
+};
+export declare const loudnessNormalizationControllerImplOptionsValidator: ObjectSchema<LoudnessNormalizationControllerImplOptions>;
+//# sourceMappingURL=LoudnessNormalizationControllerImplOptions.d.ts.map

package/dist/types/current/playback/loudness/LoudnessNormalizationControllerImplOptions.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"LoudnessNormalizationControllerImplOptions.d.ts","sourceRoot":"","sources":["../../../../../src/playback/loudness/LoudnessNormalizationControllerImplOptions.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,0BAA0B,CAAA;AAG5D;;GAEG;AACH,MAAM,WAAW,0CAA0C;IACvD;;;OAGG;IACH,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAA;IAEzB;;;OAGG;IACH,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAA;IAE5B;;;OAGG;IACH,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAA;CAC9B;AAED,eAAO,MAAM,iDAAiD;;;;CAIC,CAAA;AAE/D,eAAO,MAAM,mDAAmD,EAAE,YAAY,CAAC,0CAA0C,CAKnH,CAAA"}

package/dist/types/current/playback/loudness/LoudnessNormalizationControllerImplOptions.js

@@ -0,0 +1,15 @@
+/*
+ * Copyright Amazon.com, Inc. or its affiliates. All Rights Reserved.
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import { boolean, number, object } from '@amazon/vinyl-validation';
+export const defaultLoudnessNormalizationControllerImplOptions = {
+    enabled: false,
+    targetLufs: -14.0,
+    maxGainDb: 10.0,
+};
+export const loudnessNormalizationControllerImplOptionsValidator = object({
+    enabled: boolean(),
+    targetLufs: number().optional(),
+    maxGainDb: number().optional(),
+});

package/dist/types/current/playback/nextHasMetadata.d.ts

@@ -0,0 +1,4 @@
+import type { PlaybackControllerEventMap, ReadonlyPlaybackController } from '../playback/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/current/playback/nextHasMetadata.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"nextHasMetadata.d.ts","sourceRoot":"","sources":["../../../../src/playback/nextHasMetadata.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EACR,0BAA0B,EAC1B,0BAA0B,EAC7B,MAAM,uCAAuC,CAAA;AAC9C,OAAO,EACH,KAAK,SAAS,EAEd,KAAK,yBAAyB,EACjC,MAAM,oBAAoB,CAAA;AAE3B,wBAAgB,eAAe,CAC3B,UAAU,EAAE,0BAA0B,EACtC,OAAO,CAAC,EAAE,yBAAyB,CAC/B,0BAA0B,EAC1B,gBAAgB,CACnB,GACF,OAAO,CAAC,SAAS,CAAC,CAGpB"}

package/dist/types/current/playback/nextHasMetadata.js

@@ -0,0 +1,10 @@
+/*
+ * Copyright Amazon.com, Inc. or its affiliates. All Rights Reserved.
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import { nextEventAsPromise, } from '@amazon/vinyl-util';
+export function nextHasMetadata(controller, options) {
+    if (controller.hasMetadata)
+        return Promise.resolve({});
+    return nextEventAsPromise(controller, 'loadedMetadata', options);
+}

package/dist/types/current/streaming/ContentStream.d.ts

@@ -0,0 +1,116 @@
+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 Factories } from '@amazon/vinyl-di';
+/**
+ * Creates a new ContentStream for the given content type.
+ */
+export type ContentStreamFactory = (contentType: ContentType) => ContentStream;
+export interface ContentStream extends ReadonlyEventHost<StreamingEventMap>, Disposable {
+    /**
+     * The content type for this stream.
+     * E.g. 'audio' or 'video'
+     */
+    readonly contentType: ContentType;
+    /**
+     * The prefetched time ranges.
+     */
+    readonly fetchedRanges: ReadonlyRanges;
+    /**
+     * The quality currently being requested.
+     */
+    readonly streamingQuality: MediaQualityMetadata | null;
+    /**
+     * The quality of the currently buffered media for this stream.
+     */
+    readonly bufferingQuality: MediaQualityMetadata | null;
+    /**
+     * The quality for the currently buffered media at currentTime for this stream.
+     */
+    readonly playbackQuality: MediaQualityMetadata | null;
+    /**
+     * The error, if in an error state.
+     */
+    readonly error: Error | null;
+    /**
+     * True if the last segment has been appended.
+     */
+    readonly bufferingEnded: boolean;
+    /**
+     * Starts prefetching with the given priority and prefetch start time.
+     * @param options
+     */
+    preload(options: ContentStreamPreloadOptions): void;
+    clearPrefetch(): void;
+    /**
+     * Resets the track to recover from error states.
+     * Resets both the segment controller and buffering controller to clear failed segments and error conditions.
+     */
+    reset(): void;
+    /**
+     * Activates the content stream, activating sub-controllers.
+     */
+    activate(options: ContentStreamActivateOptions): void;
+    /**
+     * Deactivates the content stream, deactivating sub-controllers.
+     */
+    deactivate(): void;
+}
+export interface ContentStreamPreloadOptions {
+    /**
+     * Track priority for prefetching.
+     * Higher values take precedence.
+     */
+    readonly prefetchPriority: number;
+    /**
+     * The media presentation time (in seconds) to begin prefetching.
+     */
+    readonly startTime?: Maybe<number>;
+}
+export interface ContentStreamActivateOptions {
+    /**
+     * The media presentation time (in seconds) to seek to.
+     */
+    readonly startTime?: Maybe<number>;
+}
+export interface ContentStreamImplDeps {
+    readonly bufferingController: BufferingController;
+    readonly segmentController: SegmentController;
+}
+export declare class ContentStreamImpl extends EventHostImpl<StreamingEventMap> implements ContentStream {
+    readonly contentType: ContentType;
+    private disposer;
+    private readonly segmentController;
+    private readonly bufferingController;
+    constructor(dependencyFactories: Factories<ContentStreamImplDeps>, contentType: ContentType);
+    preload(options: ContentStreamPreloadOptions): void;
+    get fetchedRanges(): ReadonlyRanges;
+    get streamingQuality(): MediaQualityMetadata | null;
+    get bufferingQuality(): MediaQualityMetadata | null;
+    get playbackQuality(): MediaQualityMetadata | null;
+    get bufferingEnded(): boolean;
+    get error(): Error | null;
+    /**
+     * Clears all fetched fragments and source buffers. Streaming will resume.
+     * This should be called if a change has been made where the user would expect an immediate change,
+     * for example, changing streaming quality from SD to HD.
+     */
+    clearPrefetch(): void;
+    /**
+     * Resets the track to recover from error states.
+     * Resets both the segment controller and buffering controller to clear failed segments and error conditions.
+     */
+    reset(): void;
+    activate(options: ContentStreamActivateOptions): void;
+    deactivate(): void;
+    dispose(): void;
+}
+/**
+ * The `Factory` to create a function which satisfies `ContentStreamFactory`.
+ */
+export declare function createContentStreamFactory(deps: {
+    readonly createContentStreamFactories: (contentType: ContentType) => Factories<ContentStreamImplDeps>;
+}): (contentType: ContentType) => ContentStreamImpl;
+//# sourceMappingURL=ContentStream.d.ts.map

package/dist/types/current/streaming/ContentStream.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ContentStream.d.ts","sourceRoot":"","sources":["../../../../src/streaming/ContentStream.ts"],"names":[],"mappings":"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"}

package/dist/types/current/streaming/ContentStream.js

@@ -0,0 +1,94 @@
+/*
+ * Copyright Amazon.com, Inc. or its affiliates. All Rights Reserved.
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import { createDisposer, EventHostImpl, redispatchEvents, } from '@amazon/vinyl-util';
+import { createContainer } from '@amazon/vinyl-di';
+export class ContentStreamImpl extends EventHostImpl {
+    contentType;
+    disposer = createDisposer();
+    segmentController;
+    bufferingController;
+    constructor(dependencyFactories, contentType) {
+        super();
+        this.contentType = contentType;
+        const { add } = this.disposer;
+        const deps = add(createContainer(dependencyFactories)).dependencies;
+        this.segmentController = deps.segmentController;
+        redispatchEvents(this, this.segmentController, ['fetchedRangesChange']);
+        this.bufferingController = deps.bufferingController;
+        redispatchEvents(this, this.segmentController, [
+            'streamingQualityChange',
+        ]);
+        redispatchEvents(this, this.bufferingController, [
+            'bufferingQualityChange',
+            'playbackQualityChange',
+            'bufferingEnded',
+            'error',
+        ]);
+    }
+    preload(options) {
+        this.segmentController.configure({
+            startTime: options.startTime ?? 0,
+            trackPrefetchPriority: options.prefetchPriority,
+        });
+    }
+    get fetchedRanges() {
+        return this.segmentController.fetchedRanges;
+    }
+    get streamingQuality() {
+        return this.segmentController.streamingQuality ?? null;
+    }
+    get bufferingQuality() {
+        return this.bufferingController.bufferingQuality ?? null;
+    }
+    get playbackQuality() {
+        return this.bufferingController.playbackQuality ?? null;
+    }
+    get bufferingEnded() {
+        return this.bufferingController.bufferingEnded;
+    }
+    get error() {
+        return this.bufferingController.error ?? this.segmentController.error;
+    }
+    /**
+     * Clears all fetched fragments and source buffers. Streaming will resume.
+     * This should be called if a change has been made where the user would expect an immediate change,
+     * for example, changing streaming quality from SD to HD.
+     */
+    clearPrefetch() {
+        this.segmentController.clear();
+        this.bufferingController.clear();
+    }
+    /**
+     * Resets the track to recover from error states.
+     * Resets both the segment controller and buffering controller to clear failed segments and error conditions.
+     */
+    reset() {
+        this.segmentController.reset();
+        this.bufferingController.reset();
+    }
+    activate(options) {
+        this.segmentController.configure({
+            startTime: options.startTime ?? 0,
+        });
+        this.segmentController.activate();
+        this.bufferingController.activate();
+    }
+    deactivate() {
+        this.segmentController.deactivate();
+        this.bufferingController.deactivate();
+    }
+    dispose() {
+        super.dispose();
+        this.disposer.dispose();
+    }
+}
+/**
+ * The `Factory` to create a function which satisfies `ContentStreamFactory`.
+ */
+export function createContentStreamFactory(deps) {
+    return ((contentType) => {
+        return new ContentStreamImpl(deps.createContentStreamFactories(contentType), contentType);
+    });
+}

package/dist/types/current/streaming/ContentStreamingOptions.d.ts

@@ -0,0 +1,13 @@
+import type { SegmentControllerImplOptions } from '../streaming/SegmentControllerImpl';
+import type { BufferingControllerImplOptions } from '../streaming/buffering/BufferingController';
+export interface ContentStreamingOptions {
+    /**
+     * Configuration for the segment controller.
+     */
+    readonly segmentController?: Partial<SegmentControllerImplOptions>;
+    /**
+     * Configuration for the buffering controller.
+     */
+    readonly buffering?: Partial<BufferingControllerImplOptions>;
+}
+//# sourceMappingURL=ContentStreamingOptions.d.ts.map

package/dist/types/current/streaming/ContentStreamingOptions.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ContentStreamingOptions.d.ts","sourceRoot":"","sources":["../../../../src/streaming/ContentStreamingOptions.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,4BAA4B,EAAE,MAAM,mCAAmC,CAAA;AACrF,OAAO,KAAK,EAAE,8BAA8B,EAAE,MAAM,2CAA2C,CAAA;AAE/F,MAAM,WAAW,uBAAuB;IACpC;;OAEG;IACH,QAAQ,CAAC,iBAAiB,CAAC,EAAE,OAAO,CAAC,4BAA4B,CAAC,CAAA;IAElE;;OAEG;IACH,QAAQ,CAAC,SAAS,CAAC,EAAE,OAAO,CAAC,8BAA8B,CAAC,CAAA;CAC/D"}

package/dist/types/current/streaming/ContentStreamingOptions.js

@@ -0,0 +1,5 @@
+/*
+ * Copyright Amazon.com, Inc. or its affiliates. All Rights Reserved.
+ * SPDX-License-Identifier: Apache-2.0
+ */
+export {};

package/dist/types/current/streaming/ContentTypesValue.d.ts

@@ -0,0 +1,8 @@
+import type { ContentType } from './MediaQualityMetadata';
+import type { ObservableValue } from '@amazon/vinyl-observable';
+import type { ReadonlySet } from '@amazon/vinyl-util';
+/**
+ * Provides the content types to create streams for.
+ */
+export type ContentTypesValue = ObservableValue<Promise<ReadonlySet<ContentType>>>;
+//# sourceMappingURL=ContentTypesValue.d.ts.map

package/dist/types/current/streaming/ContentTypesValue.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ContentTypesValue.d.ts","sourceRoot":"","sources":["../../../../src/streaming/ContentTypesValue.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,wBAAwB,CAAA;AACzD,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,0BAA0B,CAAA;AAC/D,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAA;AAErD;;GAEG;AACH,MAAM,MAAM,iBAAiB,GAAG,eAAe,CAC3C,OAAO,CAAC,WAAW,CAAC,WAAW,CAAC,CAAC,CACpC,CAAA"}