@amazon/vinyl 1.1.1 → 1.2.1

package/dist/types/ts4.7/track/source/SourceObjectTrack.d.ts

@@ -1,9 +1,9 @@
 import type { PlaybackSource } from '../../playback/PlaybackSource';
-import type { TrackTypeId, TrackUri } from '../../track/Track';
-import { type TrackBaseDeps } from '../../track/TrackBase';
-import { type TrackFactory, type TrackLoadOptions } from '../../track/TrackFactory';
+import type { TrackTypeId, TrackUri } from '../Track';
+import { type TrackBaseDeps } from '../TrackBase';
+import { type TrackFactory, type TrackLoadOptions } from '../TrackFactory';
 import { type Maybe } from '@amazon/vinyl-util';
-import { SourceTrackBase, type SourceTrackBaseOptions } from '../../track/source/SourceTrackBase';
+import { SourceTrackBase, type SourceTrackBaseOptions } from './SourceTrackBase';
 /**
  * Dependencies for a SourceObjectTrack.
  */

package/dist/types/ts4.7/track/source/SourceTrack.d.ts

@@ -1,8 +1,8 @@
-import type { TrackTypeId, TrackUri } from '../../track/Track';
-import { type TrackBaseDeps } from '../../track/TrackBase';
-import { type TrackFactory, type TrackLoadOptions } from '../../track/TrackFactory';
+import type { TrackTypeId, TrackUri } from '../Track';
+import { type TrackBaseDeps } from '../TrackBase';
+import { type TrackFactory, type TrackLoadOptions } from '../TrackFactory';
 import { type Maybe } from '@amazon/vinyl-util';
-import { SourceTrackBase, type SourceTrackBaseOptions } from '../../track/source/SourceTrackBase';
+import { SourceTrackBase, type SourceTrackBaseOptions } from './SourceTrackBase';
 import type { PlaybackSource } from '../../playback/PlaybackSource';
 /**
  * Dependencies for a SourceTrack.

package/dist/types/ts4.7/track/source/SourceTrackBase.d.ts

@@ -1,5 +1,5 @@
-import { TrackBase, type TrackBaseDeps, type TrackBaseOptions } from '../../track/TrackBase';
-import type { TrackEventMap, TrackPreloadOptions, TrackTypeId, TrackUri } from '../../track/Track';
+import { TrackBase, type TrackBaseDeps, type TrackBaseOptions } from '../TrackBase';
+import type { TrackEventMap, TrackPreloadOptions, TrackTypeId, TrackUri } from '../Track';
 import { type Maybe, type ReadonlySet } from '@amazon/vinyl-util';
 import { type ContentType, type MediaQualityMetadata } from '../../streaming/MediaQualityMetadata';
 import type { ObjectSchema } from '@amazon/vinyl-validation';

package/dist/types/ts4.7/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/ts4.7/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/ts4.7/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/ts4.7/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/ts4.7/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/ts4.7/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): {
     }) => 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) => {
+    createDashFactories: (deps: import("..").DashFactoryDeps) => (loadOptions: import("..").DashTrackLoadOptions) => {
         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): {
         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): {
         }>>;
         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) => {
+    createHlsFactories: (deps: import("..").HlsFactoryDeps) => (loadOptions: import("..").HlsTrackLoadOptions) => {
         contentTypesValue: typeof import("..").createHlsContentTypesValue;
         manifestController: () => import("..").HlsManifestControllerImpl;
         manifestTransformed: typeof import("..").createDefaultHlsManifestTransformer;
@@ -149,7 +147,7 @@ export declare function createVinylFactories(options: VinylDependencyOptions): {
         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): {
         }>>;
         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/unit/types/current/ad/AdController.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=AdController.test.d.ts.map

package/dist/unit/types/current/ad/AdController.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"AdController.test.d.ts","sourceRoot":"","sources":["../../../../../test/unit/ad/AdController.test.ts"],"names":[],"mappings":""}

package/dist/unit/types/current/ad/AdController.test.js

@@ -0,0 +1,10 @@
+/*
+ * Copyright Amazon.com, Inc. or its affiliates. All Rights Reserved.
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import { expectTypeStrictlyEquals } from '@amazon/vinyl-util/browserTestUtil';
+describe('ALL_AD_EVENTS', () => {
+    it('provides a comprehensive list of all ad controller state events', () => {
+        expectTypeStrictlyEquals(true);
+    });
+});

package/dist/unit/types/current/ad/AdControllerImpl.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=AdControllerImpl.test.d.ts.map

package/dist/unit/types/current/ad/AdControllerImpl.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"AdControllerImpl.test.d.ts","sourceRoot":"","sources":["../../../../../test/unit/ad/AdControllerImpl.test.ts"],"names":[],"mappings":""}