@amazon/vinyl 1.1.1 → 2.0.0

package/dist/types/current/patch/media/patchMediaElement.js

@@ -4,7 +4,7 @@
  */
 import { patchTargetFromFlags } from '@amazon/vinyl-util';
 import { createUnreliablePlaybackEventsPatch } from './patches/createUnreliablePlaybackEventsPatch';
-import { createPreventStallsPatch } from '../../patch/media/patches/createPreventStallsPatch';
+import { createPreventStallsPatch } from './patches/createPreventStallsPatch';
 /**
  * Applies patches corresponding to the patch flags on the given media element.
  *

package/dist/types/current/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/current/patch/media/patches/createPreventStallsPatch.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"createPreventStallsPatch.d.ts","sourceRoot":"","sources":["../../../../../../src/patch/media/patches/createPreventStallsPatch.ts"],"names":[],"mappings":"AAiBA,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,qCAAqC,CAAA;AAEhF;;;GAGG;AACH,eAAO,MAAM,mBAAmB,KAAK,CAAA;AAErC;;;;GAIG;AACH,wBAAgB,wBAAwB,CACpC,KAAK,EAAE,gBAAgB,GACxB,qBAAqB,CAmCvB;AAED;;GAEG;AACH,wBAAgB,0BAA0B,IAAI,OAAO,CAEpD"}
+{"version":3,"file":"createPreventStallsPatch.d.ts","sourceRoot":"","sources":["../../../../../../src/patch/media/patches/createPreventStallsPatch.ts"],"names":[],"mappings":"AAiBA,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,0BAA0B,CAAA;AAErE;;;GAGG;AACH,eAAO,MAAM,mBAAmB,KAAK,CAAA;AAErC;;;;GAIG;AACH,wBAAgB,wBAAwB,CACpC,KAAK,EAAE,gBAAgB,GACxB,qBAAqB,CAmCvB;AAED;;GAEG;AACH,wBAAgB,0BAA0B,IAAI,OAAO,CAEpD"}

package/dist/types/current/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/current/patch/media/patches/createUnreliablePlaybackEventsPatch.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"createUnreliablePlaybackEventsPatch.d.ts","sourceRoot":"","sources":["../../../../../../src/patch/media/patches/createUnreliablePlaybackEventsPatch.ts"],"names":[],"mappings":"AAaA,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,qCAAqC,CAAA;AAEhF;;;;GAIG;AACH,eAAO,MAAM,+BAA+B,MAAM,CAAA;AAElD;;GAEG;AACH,eAAO,MAAM,sBAAsB,MAAM,CAAA;AAEzC;;GAEG;AACH,eAAO,MAAM,sBAAsB,MAAM,CAAA;AA6BzC;;;GAGG;AACH,wBAAgB,mCAAmC,CAC/C,KAAK,EAAE,gBAAgB,GACxB,qBAAqB,CAyMvB;AAED;;;GAGG;AACH,wBAAgB,qCAAqC,IAAI,OAAO,CAM/D"}
+{"version":3,"file":"createUnreliablePlaybackEventsPatch.d.ts","sourceRoot":"","sources":["../../../../../../src/patch/media/patches/createUnreliablePlaybackEventsPatch.ts"],"names":[],"mappings":"AAaA,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,0BAA0B,CAAA;AAErE;;;;GAIG;AACH,eAAO,MAAM,+BAA+B,MAAM,CAAA;AAElD;;GAEG;AACH,eAAO,MAAM,sBAAsB,MAAM,CAAA;AAEzC;;GAEG;AACH,eAAO,MAAM,sBAAsB,MAAM,CAAA;AA6BzC;;;GAGG;AACH,wBAAgB,mCAAmC,CAC/C,KAAK,EAAE,gBAAgB,GACxB,qBAAqB,CAyMvB;AAED;;;GAGG;AACH,wBAAgB,qCAAqC,IAAI,OAAO,CAM/D"}

package/dist/types/current/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.
@@ -56,6 +56,7 @@ export declare class PlaybackControllerImpl extends EventHostImpl<PlaybackContro
     private _playing;
     private _seeking;
     private _waiting;
+    private _seekId;
     private userVolume;
     private _pendingPlay;
     private playAbort;

package/dist/types/current/playback/PlaybackControllerImpl.d.ts.map

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

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

@@ -5,11 +5,11 @@
 import { Abort, AbortError, Browser, clamp, closeTo, createDisposer, createTimeRangesReader, DomEventHost, ErrorLevel, ErrorOrigin, EventHostImpl, getUserAgentInfo, hasBrowser, logDebug, logInfo, logWarn, nextEventAsPromise, onAny, ownKeys, TimeoutSlot, toLowerCase, withAbort, withTimeout, } from '@amazon/vinyl-util';
 import { LIVE_DURATION } from './PlaybackController';
 import { PlaybackReadyState, playedReasons, waitedReasons, } from './ReadonlyPlaybackController';
-import { InvalidSeekError } from '../playback/error/InvalidSeekError';
-import { playbackStateLoggingHandler } from '../playback/logging/playbackStateLoggingHandler';
+import { InvalidSeekError } from './error/InvalidSeekError';
+import { playbackStateLoggingHandler } from './logging/playbackStateLoggingHandler';
 import { createChangeEventTrigger } from '../event/ChangeEvent';
-import { nextHasMetadata } from '../playback/nextHasMetadata';
-import { ReportableMediaError } from '../playback/error/ReportableMediaError';
+import { nextHasMetadata } from './nextHasMetadata';
+import { ReportableMediaError } from './error/ReportableMediaError';
 export const defaultPlaybackControllerImplOptions = {
     loopTimeAffordance: 2,
     minSeekableBuffer: -1, // Default comes from getMinSeekableBufferDefault()
@@ -36,6 +36,8 @@ export class PlaybackControllerImpl extends EventHostImpl {
     _playing = false;
     _seeking = false;
     _waiting = false;
+    // Monotonic counter identifying the most recent seekTo call.
+    _seekId = 0;
     // default user volume (0.0 to 1.0 scale)
     userVolume = 1.0;
     _pendingPlay = null;
@@ -125,6 +127,7 @@ export class PlaybackControllerImpl extends EventHostImpl {
             'pause',
             'play',
             'playing',
+            'resize',
             'seeking',
             'waiting',
             'waitingForKey',
@@ -175,16 +178,25 @@ export class PlaybackControllerImpl extends EventHostImpl {
             this._waiting = false;
             this.dispatch('waited', info);
         });
+        // Only advance the observed position forward; a backward timeUpdate
+        // (e.g. one arriving just before a backward seek) must not shrink a
+        // play's measured progress.
+        let lastKnownTime = this.currentTime;
+        this.on('timeUpdate', () => {
+            if (this.currentTime > lastKnownTime)
+                lastKnownTime = this.currentTime;
+        });
         // playing state + played event
         let startedTime = 0;
         this.operationEvent(this, 'playing', playedReasons, () => {
             this._playing = true;
             startedTime = this.currentTime;
+            lastKnownTime = startedTime;
         }, (info) => {
             this._playing = false;
             this.dispatch('played', {
                 ...info,
-                playbackTime: this.currentTime - startedTime,
+                playbackTime: lastKnownTime - startedTime,
             });
         });
     }
@@ -384,7 +396,11 @@ export class PlaybackControllerImpl extends EventHostImpl {
             this.pendingPlay = withAbort((async () => {
                 await nextHasMetadata(this);
                 playAbort.throwIfAborted();
-                await withTimeout(this.media.play(), this.options.playTimeout, 'play() timed out after {time}s', ErrorOrigin.INTERNAL, ErrorLevel.SILENT);
+                await withTimeout(this.media.play(), this.options.playTimeout, {
+                    message: 'play() timed out after {time}s',
+                    origin: ErrorOrigin.INTERNAL,
+                    level: ErrorLevel.SILENT,
+                });
             })(), playAbort)
                 .catch((reason) => {
                 this.dispatch('playRejected', { reason });
@@ -411,20 +427,43 @@ export class PlaybackControllerImpl extends EventHostImpl {
     }
     async seekTo(time, tolerance = 0.5) {
         logDebug(this, `seekTo: ${time}`);
+        // Claim this seek as the newest. A seek that parks on an await (e.g. waiting for loadedMetadata) can resume
+        // AFTER a later-issued seek has already applied its target.
+        const seekId = ++this._seekId;
+        const superseded = () => {
+            if (this._seekId === seekId)
+                return false;
+            logDebug(this, `seekTo: ${time} superseded by a newer seek`);
+            return true;
+        };
         const nextEvent = (type) => {
-            return withAbort(withTimeout(nextEventAsPromise(this, type), this.options.seekTimeout, `seek timed out on ${type} event after {time}s`, ErrorOrigin.INTERNAL, ErrorLevel.WARN), this.disposeAbort);
+            return nextEventAsPromise(this, type, {
+                timeout: this.options.seekTimeout,
+                timeoutMessage: `seek timed out on ${type} event after {time}s`,
+                timeoutOrigin: ErrorOrigin.INTERNAL,
+                timeoutLevel: ErrorLevel.WARN,
+                abort: this.disposeAbort,
+            });
         };
         // Cannot seek until there are seekable ranges.
         if (!this.hasMetadata) {
             await nextEvent('loadedMetadata');
+            // A newer seek was issued while we waited — it already applied (or
+            // will apply) its target. Don't overwrite it with this stale one.
+            if (superseded())
+                return;
         }
         const seekable = this.seekable;
         const range = seekable.getRangeAt(clamp(time, 0, this.duration), tolerance);
         if (range == null) {
-            logWarn(this, `seekTo: seek outside of seekable ranges, seek ignored`);
+            logWarn(this, `seekTo: seek outside of seekable ranges, seek ignored`, seekable.ranges);
             throw new InvalidSeekError(time, seekable, tolerance);
         }
-        const clampedTime = Math.max(Math.min(time, range[1] - this.options.minSeekableBuffer), range[0]);
+        // The end-of-range buffer exists only so playback can resume near the
+        // end; when paused there's nothing to keep playing, so allow seeking
+        // right up to the range end.
+        const seekableBuffer = this.paused ? 0 : this.options.minSeekableBuffer;
+        const clampedTime = Math.max(Math.min(time, range[1] - seekableBuffer), range[0]);
         // No-op check
         logDebug(this, `seekTo operation, requested: ${time}, actual: ${clampedTime}`);
         if (closeTo(clampedTime, this.currentTime, tolerance)) {

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

@@ -27,7 +27,7 @@ export interface PlaybackSource {
     load(): void;
     /**
      * Determines whether the media element is allowed to have a remote playback UI.
-     * (Note: AirPlay does not support remote playback for Dash)
+     * (Note: AirPlay does not support remote playback for MSE)
      */
     disableRemotePlayback: boolean;
 }

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

@@ -157,6 +157,11 @@ export interface PlaybackControllerEventMap {
      * Fired periodically as the browser loads a resource.
      */
     readonly progress: ProgressEvent;
+    /**
+     * Fired when the intrinsic dimensions of the media (e.g. a video's width or
+     * height) change, including once they first become known.
+     */
+    readonly resize: AnyRecord;
     /**
      * Fired when the playback rate has changed.
      */
@@ -225,7 +230,7 @@ export declare enum WaitedReason {
  * A list of all events that cause the 2nd-order 'waited' event.
  */
 export declare const waitedReasons: readonly [WaitedReason.PLAYING, WaitedReason.PAUSE, WaitedReason.EMPTIED, WaitedReason.SEEKING];
-export declare const ALL_PLAYBACK_STATE_EVENTS: readonly ["abort", "canPlay", "canPlayThrough", "durationChange", "emptied", "ended", "error", "playIsPendingChange", "loadedData", "loadedMetadata", "loadStart", "looped", "mutedChange", "pause", "play", "playRejected", "played", "playing", "progress", "rateChange", "readyStateChange", "reset", "seeked", "seeking", "timeUpdate", "volumeChange", "waited", "waiting", "waitingForKey"];
+export declare const ALL_PLAYBACK_STATE_EVENTS: readonly ["abort", "canPlay", "canPlayThrough", "durationChange", "emptied", "ended", "error", "playIsPendingChange", "loadedData", "loadedMetadata", "loadStart", "looped", "mutedChange", "pause", "play", "playRejected", "played", "playing", "progress", "rateChange", "readyStateChange", "reset", "resize", "seeked", "seeking", "timeUpdate", "volumeChange", "waited", "waiting", "waitingForKey"];
 export declare enum PlaybackReadyState {
     /**
      * No information is available about the media resource.

package/dist/types/current/playback/ReadonlyPlaybackController.d.ts.map

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

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

@@ -71,6 +71,7 @@ export const ALL_PLAYBACK_STATE_EVENTS = [
     'rateChange',
     'readyStateChange',
     'reset',
+    'resize',
     'seeked',
     'seeking',
     'timeUpdate',

package/dist/types/current/playback/error/ReportableMediaError.js

@@ -3,7 +3,7 @@
  * SPDX-License-Identifier: Apache-2.0
  */
 import { ErrorLevel, ErrorOrigin, ReportableError, } from '@amazon/vinyl-util';
-import { mediaErrorToJson } from '../../playback/logging/mediaErrorToJson';
+import { mediaErrorToJson } from '../logging/mediaErrorToJson';
 /**
  * An error from the media element
  */

package/dist/types/current/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/current/playback/logging/playbackStateLoggingHandler.d.ts.map

@@ -1 +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"}
+{"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,+BAA+B,CAAA;AAM/E;;;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

@@ -4,7 +4,7 @@
  */
 import { createDisposer } from '@amazon/vinyl-util';
 import { logDebug } from '@amazon/vinyl-util';
-import { ALL_PLAYBACK_STATE_EVENTS } from '../../playback/ReadonlyPlaybackController';
+import { ALL_PLAYBACK_STATE_EVENTS } from '../ReadonlyPlaybackController';
 import { throttle } from '@amazon/vinyl-util';
 import { substitute } from '@amazon/vinyl-util';
 import { createLogPrefix } from '@amazon/vinyl-util';

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

@@ -1 +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"}
+{"version":3,"file":"nextHasMetadata.d.ts","sourceRoot":"","sources":["../../../../src/playback/nextHasMetadata.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EACR,0BAA0B,EAC1B,0BAA0B,EAC7B,MAAM,8BAA8B,CAAA;AACrC,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/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.
@@ -38,6 +38,10 @@ export interface ContentStream extends ReadonlyEventHost<StreamingEventMap>, Dis
      * True if the last segment has been appended.
      */
     readonly bufferingEnded: boolean;
+    /**
+     * True while this stream's buffer holds any data.
+     */
+    readonly hasData: boolean;
     /**
      * Starts prefetching with the given priority and prefetch start time.
      * @param options
@@ -52,7 +56,7 @@ export interface ContentStream extends ReadonlyEventHost<StreamingEventMap>, Dis
     /**
      * Activates the content stream, activating sub-controllers.
      */
-    activate(options: ContentStreamActivateOptions): void;
+    activate(options: Maybe<ContentStreamActivateOptions>): void;
     /**
      * Deactivates the content stream, deactivating sub-controllers.
      */
@@ -81,6 +85,8 @@ export interface ContentStreamImplDeps {
 }
 export declare class ContentStreamImpl extends EventHostImpl<StreamingEventMap> implements ContentStream {
     readonly contentType: ContentType;
+    get [Symbol.toStringTag](): string;
+    readonly logPrefix: string;
     private disposer;
     private readonly segmentController;
     private readonly bufferingController;
@@ -90,6 +96,7 @@ export declare class ContentStreamImpl extends EventHostImpl<StreamingEventMap>
     get streamingQuality(): MediaQualityMetadata | null;
     get bufferingQuality(): MediaQualityMetadata | null;
     get playbackQuality(): MediaQualityMetadata | null;
+    get hasData(): boolean;
     get bufferingEnded(): boolean;
     get error(): Error | null;
     /**

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

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

@@ -2,20 +2,30 @@
  * 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 { createDisposer, createLogPrefix, EventHostImpl, logDebug, redispatchEvents, } from '@amazon/vinyl-util';
 import { createContainer } from '@amazon/vinyl-di';
 export class ContentStreamImpl extends EventHostImpl {
     contentType;
+    get [Symbol.toStringTag]() {
+        return `ContentStream_${this.contentType}`;
+    }
+    // Assigned in the constructor body: a field initializer runs before the
+    // contentType param-property, so it would capture `undefined`.
+    logPrefix;
     disposer = createDisposer();
     segmentController;
     bufferingController;
     constructor(dependencyFactories, contentType) {
         super();
         this.contentType = contentType;
+        this.logPrefix = createLogPrefix(`ContentStream_${contentType}`);
         const { add } = this.disposer;
         const deps = add(createContainer(dependencyFactories)).dependencies;
         this.segmentController = deps.segmentController;
-        redispatchEvents(this, this.segmentController, ['fetchedRangesChange']);
+        redispatchEvents(this, this.segmentController, [
+            'fetchedRangesChange',
+            'loadSpanMeasured',
+        ]);
         this.bufferingController = deps.bufferingController;
         redispatchEvents(this, this.segmentController, [
             'streamingQualityChange',
@@ -24,7 +34,9 @@ export class ContentStreamImpl extends EventHostImpl {
             'bufferingQualityChange',
             'playbackQualityChange',
             'bufferingEnded',
+            'hasDataChange',
             'error',
+            'codecUnsupported',
         ]);
     }
     preload(options) {
@@ -45,6 +57,9 @@ export class ContentStreamImpl extends EventHostImpl {
     get playbackQuality() {
         return this.bufferingController.playbackQuality ?? null;
     }
+    get hasData() {
+        return this.bufferingController.hasData;
+    }
     get bufferingEnded() {
         return this.bufferingController.bufferingEnded;
     }
@@ -57,6 +72,7 @@ export class ContentStreamImpl extends EventHostImpl {
      * for example, changing streaming quality from SD to HD.
      */
     clearPrefetch() {
+        logDebug(this, 'clearPrefetch');
         this.segmentController.clear();
         this.bufferingController.clear();
     }
@@ -69,6 +85,7 @@ export class ContentStreamImpl extends EventHostImpl {
         this.bufferingController.reset();
     }
     activate(options) {
+        logDebug(this, 'activate');
         this.segmentController.configure({
             startTime: options.startTime ?? 0,
         });

package/dist/types/current/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/current/streaming/ContentStreamingOptions.d.ts.map

@@ -1 +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"}
+{"version":3,"file":"ContentStreamingOptions.d.ts","sourceRoot":"","sources":["../../../../src/streaming/ContentStreamingOptions.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,4BAA4B,EAAE,MAAM,yBAAyB,CAAA;AAC3E,OAAO,KAAK,EAAE,8BAA8B,EAAE,MAAM,iCAAiC,CAAA;AAErF,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/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/current/streaming/LoadMetric.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"LoadMetric.d.ts","sourceRoot":"","sources":["../../../../src/streaming/LoadMetric.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,oBAAoB,CAAA;AACnD,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAA;AAE9C;;;;;;;GAOG;AACH,MAAM,MAAM,YAAY,GAClB,UAAU,GACV,SAAS,GACT,aAAa,GACb,cAAc,CAAA;AAEpB;;;;;;;;GAQG;AACH,MAAM,WAAW,mBAAmB;IAChC,QAAQ,CAAC,IAAI,EAAE,YAAY,CAAA;IAE3B;;OAEG;IACH,QAAQ,CAAC,SAAS,EAAE,SAAS,CAAA;IAE7B;;OAEG;IACH,QAAQ,CAAC,OAAO,EAAE,SAAS,CAAA;IAE3B;;;;;OAKG;IACH,QAAQ,CAAC,QAAQ,CAAC,EAAE,QAAQ,CAAA;CAC/B;AAED;;;;GAIG;AACH,MAAM,WAAW,aAAc,SAAQ,mBAAmB;IACtD,QAAQ,CAAC,QAAQ,EAAE,QAAQ,CAAA;CAC9B;AAED;;GAEG;AACH,MAAM,WAAW,kBAAkB;IAC/B;;;;OAIG;IACH,QAAQ,CAAC,QAAQ,EAAE,aAAa,CAAA;CACnC"}

package/dist/types/current/streaming/LoadMetric.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/ManifestController.d.ts

@@ -1,5 +1,16 @@
 import type { ObservableValue } from '@amazon/vinyl-observable';
-export interface ManifestController<T> extends ObservableValue<T> {
+import type { ReadonlyAbort, ReadonlyEventHost } from '@amazon/vinyl-util';
+import type { LoadSpanMeasurement } from './LoadMetric';
+/**
+ * Events a manifest controller dispatches.
+ */
+export interface ManifestControllerEventMap {
+    /**
+     * The initial manifest fetch completed.
+     */
+    readonly loadSpanMeasured: LoadSpanMeasurement;
+}
+export interface ManifestController<T> extends ObservableValue<T>, ReadonlyEventHost<ManifestControllerEventMap> {
     /**
      * Manually triggers a reload of the manifest.
      * A manifest reload will not clear currently fetched or buffered segments.
@@ -10,4 +21,8 @@ export interface ManifestController<T> extends ObservableValue<T> {
      */
     reset(): void;
 }
+/**
+ * Provides a manifest.
+ */
+export type ManifestProvider<T> = (abort?: ReadonlyAbort) => Promise<T>;
 //# sourceMappingURL=ManifestController.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"ManifestController.d.ts","sourceRoot":"","sources":["../../../../src/streaming/ManifestController.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,0BAA0B,CAAA;AAE/D,MAAM,WAAW,kBAAkB,CAAC,CAAC,CAAE,SAAQ,eAAe,CAAC,CAAC,CAAC;IAC7D;;;OAGG;IACH,OAAO,IAAI,IAAI,CAAA;IAEf;;OAEG;IACH,KAAK,IAAI,IAAI,CAAA;CAChB"}
+{"version":3,"file":"ManifestController.d.ts","sourceRoot":"","sources":["../../../../src/streaming/ManifestController.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,0BAA0B,CAAA;AAC/D,OAAO,KAAK,EAAE,aAAa,EAAE,iBAAiB,EAAE,MAAM,oBAAoB,CAAA;AAC1E,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,cAAc,CAAA;AAEvD;;GAEG;AACH,MAAM,WAAW,0BAA0B;IACvC;;OAEG;IACH,QAAQ,CAAC,gBAAgB,EAAE,mBAAmB,CAAA;CACjD;AAED,MAAM,WAAW,kBAAkB,CAAC,CAAC,CACjC,SAAQ,eAAe,CAAC,CAAC,CAAC,EAAE,iBAAiB,CAAC,0BAA0B,CAAC;IACzE;;;OAGG;IACH,OAAO,IAAI,IAAI,CAAA;IAEf;;OAEG;IACH,KAAK,IAAI,IAAI,CAAA;CAChB;AAED;;GAEG;AACH,MAAM,MAAM,gBAAgB,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,EAAE,aAAa,KAAK,OAAO,CAAC,CAAC,CAAC,CAAA"}

package/dist/types/current/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/current/streaming/ManifestControllerImpl.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ManifestControllerImpl.d.ts","sourceRoot":"","sources":["../../../../src/streaming/ManifestControllerImpl.ts"],"names":[],"mappings":"AAKA,OAAO,EAAQ,KAAK,YAAY,EAAE,MAAM,0BAA0B,CAAA;AAClE,OAAO,EAGH,KAAK,YAAY,EAGjB,KAAK,aAAa,EAClB,KAAK,WAAW,EACnB,MAAM,oBAAoB,CAAA;AAC3B,OAAO,KAAK,EACR,kBAAkB,EAClB,0BAA0B,EAC1B,gBAAgB,EACnB,MAAM,sBAAsB,CAAA;AAE7B,MAAM,WAAW,0BAA0B,CAAC,CAAC;IACzC,QAAQ,CAAC,gBAAgB,EAAE,gBAAgB,CAAC,CAAC,CAAC,CAAA;CACjD;AAED,qBAAa,sBAAsB,CAAC,CAAC,CAAE,YAAW,kBAAkB,CAChE,OAAO,CAAC,CAAC,CAAC,CACb;IAgBe,OAAO,CAAC,QAAQ,CAAC,IAAI;IAfjC,IAAI,CAAC,MAAM,CAAC,WAAW,CAAC,IAAI,MAAM,CAEjC;IAED,IAAI,SAAS,IAAI,MAAM,CAEtB;IAED,OAAO,CAAC,QAAQ,CAAC,KAAK,CAA0B;IAChD,OAAO,CAAC,MAAM,CAAqB;IACnC,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAoB;IAC9C,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAmB;IAC5C,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAkD;IACzE,OAAO,CAAC,iBAAiB,CAAO;gBAEH,IAAI,EAAE,0BAA0B,CAAC,CAAC,CAAC;IAMhE,EAAE,CAAC,CAAC,SAAS,MAAM,0BAA0B,EACzC,IAAI,EAAE,CAAC,EACP,OAAO,EAAE,YAAY,CAAC,0BAA0B,CAAC,CAAC,CAAC,CAAC,EACpD,OAAO,CAAC,EAAE,aAAa,GACxB,WAAW;IAId,eAAe,IAAI,OAAO;IAI1B,YAAY,CAAC,IAAI,EAAE,MAAM,0BAA0B,GAAG,OAAO;IAI7D,QAAQ,CAAC,cAAc,qEAA6B;IAEpD;;OAEG;IACH,IAAI,KAAK,IAAI,KAAK,GAAG,IAAI,CAExB;IAED,OAAO,IAAI,IAAI;IAKf,OAAO,CAAC,eAAe;IAWvB;;;OAGG;IACH,OAAO,CAAC,eAAe;IAevB,KAAK,IAAI,IAAI;IAOb,IAAI,KAAK,IAAI,OAAO,CAAC,CAAC,CAAC,CAEtB;IAED,IAAI,QAAQ,IAAI,MAAM,CAErB;IAED,QAAQ,IAAI,OAAO,CAAC,CAAC,CAAC;IAItB,MAAM,CACF,QAAQ,EAAE,CAAC,KAAK,EAAE,OAAO,CAAC,CAAC,CAAC,EAAE,QAAQ,CAAC,EAAE,OAAO,CAAC,CAAC,CAAC,KAAK,IAAI,GAC7D,MAAM,IAAI;IAIb,GAAG,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,KAAK,EAAE,OAAO,CAAC,CAAC,CAAC,KAAK,CAAC;IAInC,IAAI,CAAC,CAAC,SAAS,MAAM,WAAW,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,EAAE,GAAG,EAAE,CAAC;IAIpD,IAAI,QAAQ,IAAI,OAAO,CAEtB;IAED,OAAO,IAAI,IAAI;CAKlB"}