@amazon/vinyl 1.1.1 → 1.2.1

package/dist/types/current/util/media/codecOverrides.d.ts

@@ -0,0 +1,33 @@
+/**
+ * An explicit application-provided decision to allow or deny a codec,
+ * bypassing the browser's support detection.
+ *
+ *  - `'allow'` forces the codec to be treated as supported even if the browser
+ *    reports it unsupported (e.g. to opt in to a codec the app knows the
+ *    platform can decode via an external path).
+ *  - `'deny'` forces the codec to be treated as unsupported even if the browser
+ *    reports it supported (e.g. to work around a browser that falsely claims
+ *    support, or to exclude a codec by policy).
+ */
+export type CodecOverride = 'allow' | 'deny';
+/**
+ * Explicit codec allow/deny overrides. Keys are RFC 6381 codec strings or
+ * prefixes (matched case-insensitively against the start of each codec in a
+ * mimeType's `codecs=` list, so `"hvc1"` matches `"hvc1.2.20000000.L123.B0"`).
+ *
+ * An override supersedes the browser's support detection entirely. When a
+ * mimeType contains multiple codecs, a `'deny'` on any of them denies the
+ * mimeType; an `'allow'` applies only when no codec is denied.
+ */
+export type CodecOverrides = Readonly<Record<string, CodecOverride>>;
+/**
+ * Resolves the effective override decision for a mimeType against a set of
+ * {@link CodecOverrides}, or undefined when no override applies (in which case
+ * the caller should fall back to normal support detection).
+ *
+ * A `'deny'` on any contained codec wins over an `'allow'` on another, so an
+ * explicit deny is never silently overridden by an allow elsewhere in the
+ * mimeType.
+ */
+export declare function resolveCodecOverride(mimeType: string, overrides: CodecOverrides | undefined): CodecOverride | undefined;
+//# sourceMappingURL=codecOverrides.d.ts.map

package/dist/types/current/util/media/codecOverrides.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"codecOverrides.d.ts","sourceRoot":"","sources":["../../../../../src/util/media/codecOverrides.ts"],"names":[],"mappings":"AAOA;;;;;;;;;;GAUG;AACH,MAAM,MAAM,aAAa,GAAG,OAAO,GAAG,MAAM,CAAA;AAE5C;;;;;;;;GAQG;AACH,MAAM,MAAM,cAAc,GAAG,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,aAAa,CAAC,CAAC,CAAA;AAEpE;;;;;;;;GAQG;AACH,wBAAgB,oBAAoB,CAChC,QAAQ,EAAE,MAAM,EAChB,SAAS,EAAE,cAAc,GAAG,SAAS,GACtC,aAAa,GAAG,SAAS,CAmB3B"}

package/dist/types/current/util/media/codecOverrides.js

@@ -0,0 +1,37 @@
+/*
+ * Copyright Amazon.com, Inc. or its affiliates. All Rights Reserved.
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import { extractCodecs } from './codecSupport';
+/**
+ * Resolves the effective override decision for a mimeType against a set of
+ * {@link CodecOverrides}, or undefined when no override applies (in which case
+ * the caller should fall back to normal support detection).
+ *
+ * A `'deny'` on any contained codec wins over an `'allow'` on another, so an
+ * explicit deny is never silently overridden by an allow elsewhere in the
+ * mimeType.
+ */
+export function resolveCodecOverride(mimeType, overrides) {
+    if (!overrides)
+        return undefined;
+    const entries = Object.entries(overrides);
+    if (entries.length === 0)
+        return undefined;
+    const codecs = extractCodecs(mimeType);
+    if (codecs.length === 0)
+        return undefined;
+    let sawAllow = false;
+    for (const codec of codecs) {
+        const lower = codec.toLowerCase();
+        for (const [key, decision] of entries) {
+            if (!lower.startsWith(key.toLowerCase()))
+                continue;
+            // A deny anywhere wins immediately; otherwise remember the allow.
+            if (decision === 'deny')
+                return 'deny';
+            sawAllow = true;
+        }
+    }
+    return sawAllow ? 'allow' : undefined;
+}

package/dist/types/current/util/media/codecSupport.d.ts

@@ -0,0 +1,6 @@
+/**
+ * Extracts the individual codec strings from a mimeType's `codecs=` parameter.
+ * Returns an empty array when no codecs parameter is present.
+ */
+export declare function extractCodecs(mimeType: string): string[];
+//# sourceMappingURL=codecSupport.d.ts.map

package/dist/types/current/util/media/codecSupport.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"codecSupport.d.ts","sourceRoot":"","sources":["../../../../../src/util/media/codecSupport.ts"],"names":[],"mappings":"AAKA;;;GAGG;AACH,wBAAgB,aAAa,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,EAAE,CAOxD"}

package/dist/types/current/util/media/codecSupport.js

@@ -0,0 +1,17 @@
+/*
+ * Copyright Amazon.com, Inc. or its affiliates. All Rights Reserved.
+ * SPDX-License-Identifier: Apache-2.0
+ */
+/**
+ * Extracts the individual codec strings from a mimeType's `codecs=` parameter.
+ * Returns an empty array when no codecs parameter is present.
+ */
+export function extractCodecs(mimeType) {
+    const match = /codecs\s*=\s*"?([^"]*)"?/i.exec(mimeType);
+    if (!match || !match[1])
+        return [];
+    return match[1]
+        .split(',')
+        .map((c) => c.trim())
+        .filter((c) => c.length > 0);
+}

package/dist/types/current/util/media/mimeType.d.ts

@@ -0,0 +1,8 @@
+/**
+ * Extracts the container subtype from a MIME type, lowercased — the portion
+ * after the `/`, ignoring any parameters. For example
+ * `video/webm; codecs="vp9"` → `webm` and `audio/mp4` → `mp4`. Returns an empty
+ * string when the MIME type has no subtype.
+ */
+export declare function mimeSubtype(mimeType: string): string;
+//# sourceMappingURL=mimeType.d.ts.map

package/dist/types/current/util/media/mimeType.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mimeType.d.ts","sourceRoot":"","sources":["../../../../../src/util/media/mimeType.ts"],"names":[],"mappings":"AAKA;;;;;GAKG;AACH,wBAAgB,WAAW,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAEpD"}

package/dist/types/current/util/media/mimeType.js

@@ -0,0 +1,13 @@
+/*
+ * Copyright Amazon.com, Inc. or its affiliates. All Rights Reserved.
+ * SPDX-License-Identifier: Apache-2.0
+ */
+/**
+ * Extracts the container subtype from a MIME type, lowercased — the portion
+ * after the `/`, ignoring any parameters. For example
+ * `video/webm; codecs="vp9"` → `webm` and `audio/mp4` → `mp4`. Returns an empty
+ * string when the MIME type has no subtype.
+ */
+export function mimeSubtype(mimeType) {
+    return mimeType.split(';', 1)[0].trim().toLowerCase().split('/')[1] ?? '';
+}

package/dist/types/current/vinyl/ReadonlyPlaybackStreamingState.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"ReadonlyPlaybackStreamingState.d.ts","sourceRoot":"","sources":["../../../../src/vinyl/ReadonlyPlaybackStreamingState.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,oBAAoB,CAAA;AAC3D,OAAO,KAAK,EAAE,aAAa,EAAE,sBAAsB,EAAE,MAAM,eAAe,CAAA;AAE1E;;;;;;;;;;;;;;GAcG;AAEH,MAAM,WAAW,8BACb,SAAQ,iBAAiB,CAAC,aAAa,CAAC,EAAE,sBAAsB;IAChE;;;;;;OAMG;IACH,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAA;IAE5B;;;;OAIG;IACH,QAAQ,CAAC,kBAAkB,EAAE,MAAM,CAAA;CACtC"}
+{"version":3,"file":"ReadonlyPlaybackStreamingState.d.ts","sourceRoot":"","sources":["../../../../src/vinyl/ReadonlyPlaybackStreamingState.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,oBAAoB,CAAA;AAC3D,OAAO,KAAK,EAAE,aAAa,EAAE,sBAAsB,EAAE,MAAM,gBAAgB,CAAA;AAE3E;;;;;;;;;;;;;;GAcG;AAEH,MAAM,WAAW,8BACb,SAAQ,iBAAiB,CAAC,aAAa,CAAC,EAAE,sBAAsB;IAChE;;;;;;OAMG;IACH,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAA;IAE5B;;;;OAIG;IACH,QAAQ,CAAC,kBAAkB,EAAE,MAAM,CAAA;CACtC"}

package/dist/types/current/vinyl/VinylDeps.d.ts

@@ -7,7 +7,7 @@ import type { TrackLoadOptions } from '../track/TrackFactory';
 import type { DrmController } from '../drm/DrmController';
 import type { AutoResetController } from '../track/AutoResetController';
 import type { MutableValue } from '@amazon/vinyl-observable';
-import type { VinylOptions } from '../vinyl/VinylOptions';
+import type { VinylOptions } from './VinylOptions';
 export interface VinylDeps<TrackLoadOptionsType extends TrackLoadOptions = VinylTrackLoadOptions, OptionsType = VinylOptions> {
     /**
      * A mutable provider for configuration options.

package/dist/types/current/vinyl/VinylDeps.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"VinylDeps.d.ts","sourceRoot":"","sources":["../../../../src/vinyl/VinylDeps.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,uBAAuB,CAAA;AACzD,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,+BAA+B,CAAA;AACvE,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,2BAA2B,CAAA;AAC/D,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,mCAAmC,CAAA;AAC9E,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,yBAAyB,CAAA;AAC9D,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,sBAAsB,CAAA;AAC5D,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAA;AACxD,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,6BAA6B,CAAA;AACtE,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,0BAA0B,CAAA;AAC5D,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,sBAAsB,CAAA;AAExD,MAAM,WAAW,SAAS,CACtB,oBAAoB,SAAS,gBAAgB,GAAG,qBAAqB,EACrE,WAAW,GAAG,YAAY;IAE1B;;OAEG;IACH,QAAQ,CAAC,OAAO,EAAE,YAAY,CAAC,WAAW,CAAC,CAAA;IAE3C;;OAEG;IACH,QAAQ,CAAC,kBAAkB,EAAE,kBAAkB,CAAA;IAE/C;;OAEG;IACH,QAAQ,CAAC,cAAc,EAAE,cAAc,CAAA;IAEvC;;OAEG;IACH,QAAQ,CAAC,YAAY,EAAE,YAAY,CAAA;IAEnC;;OAEG;IACH,QAAQ,CAAC,eAAe,EAAE,eAAe,CAAC,oBAAoB,CAAC,CAAA;IAE/D;;OAEG;IACH,QAAQ,CAAC,aAAa,EAAE,aAAa,CAAA;IAErC;;OAEG;IACH,QAAQ,CAAC,mBAAmB,EAAE,mBAAmB,CAAA;CACpD"}
+{"version":3,"file":"VinylDeps.d.ts","sourceRoot":"","sources":["../../../../src/vinyl/VinylDeps.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,wBAAwB,CAAA;AAC1D,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,gCAAgC,CAAA;AACxE,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,4BAA4B,CAAA;AAChE,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,oCAAoC,CAAA;AAC/E,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,0BAA0B,CAAA;AAC/D,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAA;AAC7D,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAA;AACzD,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,8BAA8B,CAAA;AACvE,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,0BAA0B,CAAA;AAC5D,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAA;AAElD,MAAM,WAAW,SAAS,CACtB,oBAAoB,SAAS,gBAAgB,GAAG,qBAAqB,EACrE,WAAW,GAAG,YAAY;IAE1B;;OAEG;IACH,QAAQ,CAAC,OAAO,EAAE,YAAY,CAAC,WAAW,CAAC,CAAA;IAE3C;;OAEG;IACH,QAAQ,CAAC,kBAAkB,EAAE,kBAAkB,CAAA;IAE/C;;OAEG;IACH,QAAQ,CAAC,cAAc,EAAE,cAAc,CAAA;IAEvC;;OAEG;IACH,QAAQ,CAAC,YAAY,EAAE,YAAY,CAAA;IAEnC;;OAEG;IACH,QAAQ,CAAC,eAAe,EAAE,eAAe,CAAC,oBAAoB,CAAC,CAAA;IAE/D;;OAEG;IACH,QAAQ,CAAC,aAAa,EAAE,aAAa,CAAA;IAErC;;OAEG;IACH,QAAQ,CAAC,mBAAmB,EAAE,mBAAmB,CAAA;CACpD"}

package/dist/types/current/vinyl/VinylOptions.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"VinylOptions.d.ts","sourceRoot":"","sources":["../../../../src/vinyl/VinylOptions.ts"],"names":[],"mappings":"AAKA,OAAO,EAEH,KAAK,0BAA0B,EAElC,MAAM,qCAAqC,CAAA;AAC5C,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,0BAA0B,CAAA;AAE5D,OAAO,EAEH,KAAK,0CAA0C,EAElD,MAAM,gEAAgE,CAAA;AAEvE,MAAM,WAAW,YAAY;IACzB;;OAEG;IACH,QAAQ,CAAC,GAAG,EAAE,0BAA0B,CAAA;IAExC,QAAQ,CAAC,qBAAqB,EAAE,0CAA0C,CAAA;IAE1E;;;;OAIG;IACH,QAAQ,CAAC,sBAAsB,EAAE,MAAM,GAAG,IAAI,CAAA;CACjD;AAED,eAAO,MAAM,mBAAmB,EAAE,YAIjC,CAAA;AAED,eAAO,MAAM,qBAAqB,EAAE,YAAY,CAAC,YAAY,CAI3D,CAAA"}
+{"version":3,"file":"VinylOptions.d.ts","sourceRoot":"","sources":["../../../../src/vinyl/VinylOptions.ts"],"names":[],"mappings":"AAKA,OAAO,EAEH,KAAK,0BAA0B,EAElC,MAAM,sCAAsC,CAAA;AAC7C,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,0BAA0B,CAAA;AAE5D,OAAO,EAEH,KAAK,0CAA0C,EAElD,MAAM,iEAAiE,CAAA;AAExE,MAAM,WAAW,YAAY;IACzB;;OAEG;IACH,QAAQ,CAAC,GAAG,EAAE,0BAA0B,CAAA;IAExC,QAAQ,CAAC,qBAAqB,EAAE,0CAA0C,CAAA;IAE1E;;;;OAIG;IACH,QAAQ,CAAC,sBAAsB,EAAE,MAAM,GAAG,IAAI,CAAA;CACjD;AAED,eAAO,MAAM,mBAAmB,EAAE,YAIjC,CAAA;AAED,eAAO,MAAM,qBAAqB,EAAE,YAAY,CAAC,YAAY,CAI3D,CAAA"}

package/dist/types/current/vinyl/VinylPatchOptions.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"VinylPatchOptions.d.ts","sourceRoot":"","sources":["../../../../src/vinyl/VinylPatchOptions.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,wBAAwB,EAAE,MAAM,wCAAwC,CAAA;AAItF;;;GAGG;AACH,MAAM,WAAW,iBAAiB;IAC9B,QAAQ,CAAC,KAAK,EAAE,wBAAwB,CAAA;CAC3C;AAED,eAAO,MAAM,mBAAmB,sDAI9B,CAAA"}
+{"version":3,"file":"VinylPatchOptions.d.ts","sourceRoot":"","sources":["../../../../src/vinyl/VinylPatchOptions.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,wBAAwB,EAAE,MAAM,yCAAyC,CAAA;AAIvF;;;GAGG;AACH,MAAM,WAAW,iBAAiB;IAC9B,QAAQ,CAAC,KAAK,EAAE,wBAAwB,CAAA;CAC3C;AAED,eAAO,MAAM,mBAAmB,sDAI9B,CAAA"}

package/dist/types/current/vinyl/VinylPlayer.d.ts

@@ -11,14 +11,28 @@ import type { DefaultVinylFactories, InferVinylOverrideDependencyType, VinylDepe
 import type { VinylDeps } from './VinylDeps';
 import type { Capabilities } from '../client/Capabilities';
 import { type ContentType, type MediaQualityMetadata } from '../streaming/MediaQualityMetadata';
-import type { ReadonlyPlaybackStreamingState } from '../vinyl/ReadonlyPlaybackStreamingState';
+import type { ReadonlyPlaybackStreamingState } from './ReadonlyPlaybackStreamingState';
 import { type StreamingEventMap } from '../streaming/StreamingEventMap';
 import type { InferObservableValueType } from '@amazon/vinyl-observable';
-import type { VinylOptions } from '../vinyl/VinylOptions';
+import type { VinylOptions } from './VinylOptions';
+import type { ChangeEvent } from '../event/ChangeEvent';
 /**
  * Events the Vinyl Player emits.
  */
 export interface VinylPlayerEventMap<TrackLoadOptionsType extends TrackLoadOptions = VinylTrackLoadOptions> extends PlaybackControllerEventMap, TrackControllerEventMap<TrackLoadOptionsType>, StreamingEventMap {
+    /**
+     * Dispatched when {@link VinylPlayer.resetPending} changes.
+     *
+     * `current` is true when the player has hit a transient, potentially
+     * recoverable error (e.g. a network outage) and an automatic reset
+     * attempt is scheduled. `current` is false once the pending reset is
+     * emitted, the error is cleared, or all retries are exhausted.
+     *
+     * If `resetPending` becomes false while {@link VinylPlayer.error} is
+     * still non-null, all automatic reset attempts have been exhausted
+     * and playback will not recover without user action.
+     */
+    readonly resetPendingChange: ChangeEvent<boolean>;
 }
 /**
  * A Vinyl Media Player.
@@ -32,6 +46,7 @@ export declare class VinylPlayer<TrackLoadOptionsType extends TrackLoadOptions =
     private get drmController();
     private get playbackController();
     private get trackController();
+    private get autoResetController();
     /**
      * Provides information about the client, such as device and browser capabilities.
      */
@@ -81,6 +96,15 @@ export declare class VinylPlayer<TrackLoadOptionsType extends TrackLoadOptions =
      * The last error reported.
      */
     get error(): Error | null;
+    /**
+     * True when an error has interrupted playback and an automatic reset
+     * is scheduled. This distinguishes transient, potentially recoverable
+     * errors (such as a brief network outage) from terminal errors that
+     * will not trigger a reset on their own.
+     *
+     * Listen to `resetPendingChange` events for changes.
+     */
+    get resetPending(): boolean;
     get hasMetadata(): boolean;
     get loop(): boolean;
     set loop(value: boolean);

package/dist/types/current/vinyl/VinylPlayer.d.ts.map

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

package/dist/types/current/vinyl/VinylPlayer.js

@@ -31,6 +31,9 @@ export class VinylPlayer extends EventHostImpl {
     get trackController() {
         return this.deps.trackController;
     }
+    get autoResetController() {
+        return this.deps.autoResetController;
+    }
     /**
      * Provides information about the client, such as device and browser capabilities.
      */
@@ -118,11 +121,11 @@ export class VinylPlayer extends EventHostImpl {
         // On an error, notify the auto reset controller which will
         // monitor network changes and periodically request a reset.
         const { add } = this.disposer;
-        const { autoResetController } = this.deps;
         this.on('error', (event) => {
-            autoResetController.setError(event.error);
+            this.autoResetController.setError(event.error);
         });
-        add(autoResetController.on('reset', () => this.reset()));
+        add(this.autoResetController.on('reset', () => this.reset()));
+        add(this.autoResetController.on('resetPendingChange', (event) => this.dispatch('resetPendingChange', event)));
     }
     initializePreferredLanguageHandling() {
         const { add } = this.disposer;
@@ -195,6 +198,17 @@ export class VinylPlayer extends EventHostImpl {
     get error() {
         return this._error;
     }
+    /**
+     * True when an error has interrupted playback and an automatic reset
+     * is scheduled. This distinguishes transient, potentially recoverable
+     * errors (such as a brief network outage) from terminal errors that
+     * will not trigger a reset on their own.
+     *
+     * Listen to `resetPendingChange` events for changes.
+     */
+    get resetPending() {
+        return this.autoResetController.resetPending;
+    }
     get hasMetadata() {
         return this.playbackController.hasMetadata;
     }
@@ -271,6 +285,7 @@ export class VinylPlayer extends EventHostImpl {
         this.drmController.reset();
         this.playbackController.reset();
         this.trackController.reset();
+        this.autoResetController.clear();
         this.dispatch('reset', {});
     }
     //----------------------------------------------------

package/dist/types/current/vinyl/createVinylFactories.d.ts

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

package/dist/types/current/vinyl/createVinylFactories.d.ts.map

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

package/dist/types/current/vinyl/createVinylFactories.js

@@ -19,8 +19,8 @@ import { defaultDrmKeySystemResolver } from '../drm/DrmKeySystemResolver';
 import { LoudnessNormalizationControllerImpl } from '../playback/loudness/LoudnessNormalizationControllerImpl';
 import { AutoResetControllerImpl, } from '../track/AutoResetController';
 import { validateFactories } from '@amazon/vinyl-di';
-import { defaultVinylOptions, vinylOptionsValidator, } from '../vinyl/VinylOptions';
-import { playerConfigFactory } from '../vinyl/playerConfigFactory';
+import { defaultVinylOptions, vinylOptionsValidator, } from './VinylOptions';
+import { playerConfigFactory } from './playerConfigFactory';
 /**
  * Creates the dependency factories for a standard player.
  *

package/dist/types/ts3.7/ad/AdBreakInfo.d.ts

@@ -0,0 +1,160 @@
+import { TrackUri } from '../track/Track';
+import { ValueProvider } from '@amazon/vinyl-util';
+export interface TrackAds {
+    /**
+     * The URI of the parent track.
+     */
+    readonly trackUri: TrackUri;
+    /**
+     * An array of the ad breaks for this track.
+     */
+    readonly adBreaks: AdBreakList;
+}
+/**
+ * Where an ad break is scheduled relative to the main content.
+ *
+ *  - `preroll`  - before content playback begins (start time at or near 0).
+ *  - `midroll`  - during content playback.
+ *  - `postroll` - at the end of content playback.
+ */
+export type AdBreakPlacement = 'preroll' | 'midroll' | 'postroll';
+/**
+ * Restrictions on user interaction during an ad break.
+ */
+export interface AdRestriction {
+    /**
+     * When true, the user should not be allowed to skip this ad.
+     *
+     * This is not enforced by the player; the application is expected
+     * to respect this flag when showing ad skip controls.
+     */
+    readonly skip?: boolean;
+    /**
+     * When true, the user should not be allowed to seek past this ad.
+     */
+    readonly jump?: boolean;
+}
+/**
+ * A provider-agnostic description of a single ad break on the media timeline.
+ *
+ * An ad break is a span of the presentation that carries advertising rather
+ * than primary content. The same shape is produced from HLS Interstitials
+ * (EXT-X-DATERANGE with `CLASS="com.apple.hls.interstitial"`) and, in the
+ * future, from DASH SCTE-35 splice signals, so applications observe one
+ * interface regardless of the streaming protocol.
+ *
+ * Times are expressed on the player's media timeline, in seconds, so they can
+ * be compared directly against the media's current time.
+ */
+export interface AdBreakInfo {
+    /**
+     * A stable identifier for this ad break, unique within the current media
+     * presentation. Derived from the source signal (e.g. the HLS DATERANGE ID).
+     */
+    readonly id: string;
+    /**
+     * The start time of the ad break on the media timeline, in seconds.
+     */
+    readonly startTime: number;
+    /**
+     * The duration of the ad break in seconds, or null when unknown (e.g. a
+     * still-open live break that has not yet resolved its end).
+     */
+    readonly duration: number | null;
+    /**
+     * The scheduled placement of the break relative to primary content.
+     */
+    readonly placement: AdBreakPlacement;
+    /**
+     * The individual ad assets that make up this break, in playback order.
+     */
+    readonly ads: ValueProvider<AdList>;
+    /**
+     * Restrictions on user interaction during this ad break.
+     */
+    readonly restrict: AdRestriction;
+    /**
+     * When true, this break plays at most once for the presentation and is not
+     * replayed even if the playhead re-crosses it (e.g. after a seek back). When
+     * false, the break may replay each time the playhead re-enters its region.
+     *
+     * (An HLS interstitial sets this from a `CUE=ONCE` hint.)
+     */
+    readonly once: boolean;
+    /**
+     * The offset, in seconds, from this break's scheduled {@link startTime} at
+     * which primary content resumes after the break. A signed value: 0 resumes
+     * in place (the break is purely additive). `null` means no resume offset was
+     * specified, in which case content resumes advanced by the break's actual
+     * playout duration (i.e. the break replaces that much primary content) —
+     * this is distinct from an explicit 0.
+     *
+     * (An HLS interstitial sets this from `X-RESUME-OFFSET`.)
+     */
+    readonly resumeOffset: number | null;
+    /**
+     * The maximum total playout time of the whole break, in seconds, summed
+     * across all of its ads, or `null` when the break's playout is uncapped.
+     * Distinct from {@link duration} (the break's timeline span) and from an
+     * individual {@link AdInfo.duration}.
+     *
+     * (An HLS interstitial sets this from `X-PLAYOUT-LIMIT`.)
+     */
+    readonly playoutLimit: number | null;
+    /**
+     * How far ahead of this break's {@link startTime}, in seconds, the player
+     * should resolve and preload the break's ad assets so they are ready when
+     * the playhead reaches it. `null` when the source specifies no offset, in
+     * which case the controller falls back to its `preloadAheadTime` option.
+     * Applies to midroll and postroll breaks; prerolls are preloaded up front.
+     *
+     * (An HLS interstitial sets this from `X-RESOLUTION-TIME-OFFSET`.)
+     */
+    readonly resolutionTimeOffset: number | null;
+    /**
+     * The window during which the user may skip this break, or a provider
+     * resolving to `null` when the break carries no skip window (skippability is
+     * then governed by {@link AdRestriction.skip}). Resolved lazily because, like
+     * {@link ads}, it may require fetching the break's asset list.
+     *
+     * (An HLS interstitial sets this from the `X-ASSET-LIST` `SKIP-CONTROL`.)
+     */
+    readonly skipControl: ValueProvider<SkipControl | null>;
+}
+/**
+ * Describes when a user may skip an ad break: skipping becomes available
+ * {@link offset} seconds into the break and remains offered for {@link duration}
+ * seconds (or the rest of the break when null).
+ */
+export interface SkipControl {
+    /** Seconds from the break start at which skipping becomes available. */
+    readonly offset: number;
+    /**
+     * Seconds the skip control remains offered after {@link offset}, or `null`
+     * to offer it for the remainder of the break.
+     */
+    readonly duration: number | null;
+}
+/**
+ * An ad break list, sorted by start time ascendingly.
+ */
+export type AdBreakList = readonly AdBreakInfo[];
+/**
+ * A single ad within an {@link AdBreakInfo}.
+ */
+export interface AdInfo {
+    /** A stable identifier for this ad within its break. */
+    readonly id: string;
+    /** The start time of this ad on the media timeline, in seconds. */
+    readonly startTime: number;
+    /** The duration of this ad in seconds, or null when unknown. */
+    readonly duration: number | null;
+    /**
+     * The URI of the ad asset, when the source signal provides one directly
+     * (e.g. an HLS interstitial `X-ASSET-URI`). Null when the ad is described
+     * only indirectly.
+     */
+    readonly uri: TrackUri | null;
+}
+export type AdList = readonly AdInfo[];
+//# sourceMappingURL=AdBreakInfo.d.ts.map