@amazon/vinyl 1.0.0

package/dist/vinylTestUtil/types/current/mock/track/MockTrack.js

@@ -0,0 +1,42 @@
+/*
+ * Copyright Amazon.com, Inc. or its affiliates. All Rights Reserved.
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import { RangesImpl } from '@amazon/vinyl-util';
+import { createSpyFactory } from '@amazon/vinyl-util/browserTestUtil';
+import { MockEventHost } from '@amazon/vinyl-util/testUtil';
+const spyFactory = createSpyFactory();
+export class MockTrack extends MockEventHost {
+    get [Symbol.toStringTag]() {
+        return `MockTrack(${this.uri})`;
+    }
+    uri = '';
+    type = '';
+    active = false;
+    fetchedRanges = new RangesImpl();
+    preload = spyFactory('preload');
+    contentTypes = new Set();
+    qualities = null;
+    qualitiesUnfiltered = null;
+    getStreamingQuality = spyFactory('getStreamingQuality');
+    getBufferingQuality = spyFactory('getBufferingQuality');
+    getPlaybackQuality = spyFactory('getPlaybackQuality');
+    extra = undefined;
+    error = null;
+    activate = spyFactory('activate');
+    deactivate = spyFactory('deactivate');
+    clearPrefetch = spyFactory('clearPrefetch');
+    reset = spyFactory('reset');
+    disposed = false;
+    /**
+     * Installs fakes for activate and deactivate to set active status.
+     */
+    implementActivateFakes() {
+        this.activate.and.callFake(() => {
+            this.active = true;
+        });
+        this.deactivate.and.callFake(() => {
+            this.active = false;
+        });
+    }
+}

package/dist/vinylTestUtil/types/current/mock/track/MockTrackController.d.ts

@@ -0,0 +1,20 @@
+import type { Track, TrackController, TrackControllerEventMap, TrackLoadOptions } from '@amazon/vinyl';
+import { MockEventHost } from '@amazon/vinyl-util/testUtil';
+export declare class MockTrackController<TrackLoadOptionsType extends TrackLoadOptions = TrackLoadOptions> extends MockEventHost<TrackControllerEventMap<TrackLoadOptionsType>> implements TrackController<TrackLoadOptionsType> {
+    currentTrack: Track | null;
+    queue: any[];
+    clearPrefetch: import("@amazon/vinyl-util/browserTestUtil").Spy2<() => void>;
+    clearQueue: import("@amazon/vinyl-util/browserTestUtil").Spy2<() => void>;
+    clearTrackCache: import("@amazon/vinyl-util/browserTestUtil").Spy2<() => void>;
+    enqueue: import("@amazon/vinyl-util/browserTestUtil").Spy2<(...loadOptionsList: readonly any[]) => void>;
+    getCachedTrack: import("@amazon/vinyl-util/browserTestUtil").Spy2<(uri: import("@amazon/vinyl").TrackUri) => import("@amazon/vinyl").ReadonlyTrack | null>;
+    getCachedTracks: import("@amazon/vinyl-util/browserTestUtil").Spy2<(() => IterableIterator<import("@amazon/vinyl").ReadonlyTrack>) & (() => any)>;
+    hasNext: import("@amazon/vinyl-util/browserTestUtil").Spy2<(() => boolean) & (() => any)>;
+    isTrackCached: import("@amazon/vinyl-util/browserTestUtil").Spy2<((uri: import("@amazon/vinyl").TrackUri) => boolean) & ((uri: string) => any)>;
+    load: import("@amazon/vinyl-util/browserTestUtil").Spy2<(...loadOptionsList: readonly any[]) => void>;
+    next: import("@amazon/vinyl-util/browserTestUtil").Spy2<() => void>;
+    preload: import("@amazon/vinyl-util/browserTestUtil").Spy2<(...loadOptionsList: readonly any[]) => void>;
+    unload: import("@amazon/vinyl-util/browserTestUtil").Spy2<() => void>;
+    reset: import("@amazon/vinyl-util/browserTestUtil").Spy2<() => void>;
+}
+//# sourceMappingURL=MockTrackController.d.ts.map

package/dist/vinylTestUtil/types/current/mock/track/MockTrackController.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"MockTrackController.d.ts","sourceRoot":"","sources":["../../../../../../test/vinylTestUtil/mock/track/MockTrackController.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EACR,KAAK,EACL,eAAe,EACf,uBAAuB,EACvB,gBAAgB,EACnB,MAAM,eAAe,CAAA;AAEtB,OAAO,EAAE,aAAa,EAAE,MAAM,6BAA6B,CAAA;AAI3D,qBAAa,mBAAmB,CAC5B,oBAAoB,SAAS,gBAAgB,GAAG,gBAAgB,CAEhE,SAAQ,aAAa,CAAC,uBAAuB,CAAC,oBAAoB,CAAC,CACnE,YAAW,eAAe,CAAC,oBAAoB,CAAC;IAEhD,YAAY,EAAE,KAAK,GAAG,IAAI,CAAO;IAEjC,KAAK,EAAE,GAAG,EAAE,CAAK;IAEjB,aAAa,gEAA8B;IAC3C,UAAU,gEAA2B;IACrC,eAAe,gEAAgC;IAC/C,OAAO,kGAAwB;IAC/B,cAAc,6IAA+B;IAC7C,eAAe,mIAAgC;IAC/C,OAAO,mFAAwB;IAC/B,aAAa,mIAA8B;IAC3C,IAAI,kGAAqB;IACzB,IAAI,gEAAqB;IACzB,OAAO,kGAAwB;IAC/B,MAAM,gEAAuB;IAC7B,KAAK,gEAAsB;CAC9B"}

package/dist/vinylTestUtil/types/current/mock/track/MockTrackController.js

@@ -0,0 +1,24 @@
+/*
+ * Copyright Amazon.com, Inc. or its affiliates. All Rights Reserved.
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import { createSpyFactory } from '@amazon/vinyl-util/browserTestUtil';
+import { MockEventHost } from '@amazon/vinyl-util/testUtil';
+const spyFactory = createSpyFactory();
+export class MockTrackController extends MockEventHost {
+    currentTrack = null;
+    queue = [];
+    clearPrefetch = spyFactory('clearPrefetch');
+    clearQueue = spyFactory('clearQueue');
+    clearTrackCache = spyFactory('clearTrackCache');
+    enqueue = spyFactory('enqueue');
+    getCachedTrack = spyFactory('getCachedTrack');
+    getCachedTracks = spyFactory('getCachedTracks');
+    hasNext = spyFactory('hasNext');
+    isTrackCached = spyFactory('isTrackCached');
+    load = spyFactory('load');
+    next = spyFactory('next');
+    preload = spyFactory('preload');
+    unload = spyFactory('unload');
+    reset = spyFactory('reset');
+}

package/dist/vinylTestUtil/types/current/mock/track/MockTrackFactory.d.ts

@@ -0,0 +1,7 @@
+import type { TrackFactory, TrackLoadOptions } from '@amazon/vinyl';
+export declare class MockTrackFactory<TrackLoadOptionsType extends TrackLoadOptions = TrackLoadOptions> implements TrackFactory<TrackLoadOptionsType> {
+    private readonly spyFactory;
+    validate: import("@amazon/vinyl-util/browserTestUtil").Spy2<(options: TrackLoadOptionsType) => void>;
+    createTrack: import("@amazon/vinyl-util/browserTestUtil").Spy2<((options: TrackLoadOptionsType) => import("@amazon/vinyl").Track) & ((options: TrackLoadOptionsType) => any)>;
+}
+//# sourceMappingURL=MockTrackFactory.d.ts.map

package/dist/vinylTestUtil/types/current/mock/track/MockTrackFactory.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"MockTrackFactory.d.ts","sourceRoot":"","sources":["../../../../../../test/vinylTestUtil/mock/track/MockTrackFactory.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,YAAY,EAAE,gBAAgB,EAAE,MAAM,eAAe,CAAA;AAGnE,qBAAa,gBAAgB,CACzB,oBAAoB,SAAS,gBAAgB,GAAG,gBAAgB,CAClE,YAAW,YAAY,CAAC,oBAAoB,CAAC;IAC3C,OAAO,CAAC,QAAQ,CAAC,UAAU,CAC+B;IAE1D,QAAQ,6FAA8B;IACtC,WAAW,mKAAiC;CAC/C"}

package/dist/vinylTestUtil/types/current/mock/track/MockTrackFactory.js

@@ -0,0 +1,10 @@
+/*
+ * Copyright Amazon.com, Inc. or its affiliates. All Rights Reserved.
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import { createSpyFactory } from '@amazon/vinyl-util/browserTestUtil';
+export class MockTrackFactory {
+    spyFactory = createSpyFactory();
+    validate = this.spyFactory('validate');
+    createTrack = this.spyFactory('createTrack');
+}

package/dist/vinylTestUtil/types/current/mock/track/dash/createMockDashDependencies.d.ts

@@ -0,0 +1,21 @@
+import { type ContentType, type DashMediaQualityMetadataResolver, type MediaTimeline } from '@amazon/vinyl';
+import { MockDashManifestController } from '../../../mock/dash/MockDashManifestController';
+import { MockMediaSourceController } from '../../../mock/streaming/buffering/MockMediaSourceController';
+import { MockPlaybackSource } from '../../../mock/playback/MockPlaybackSource';
+import { MockPlaybackController } from '../../../mock/playback/MockPlaybackController';
+import { MockDrmController } from '../../../mock/drm/MockDrmController';
+export declare function createMockDashDependencies(): {
+    readonly contentTypesValue: import("@amazon/vinyl-observable").MutableValueImpl<Promise<Set<ContentType>>>;
+    readonly contentStreamFactory: jasmine.Spy<((contentType: ContentType) => import("@amazon/vinyl").ContentStream) & ((contentType: ContentType) => any)>;
+    readonly manifestController: MockDashManifestController;
+    readonly manifestTransformed: MockDashManifestController;
+    readonly mediaTimeline: import("@amazon/vinyl-observable").MutableValueImpl<Promise<MediaTimeline>>;
+    readonly mediaTimelineTransformed: import("@amazon/vinyl-observable").MutableValueImpl<Promise<MediaTimeline>>;
+    readonly mediaSourceController: MockMediaSourceController;
+    readonly playbackSource: MockPlaybackSource;
+    readonly playbackController: MockPlaybackController;
+    readonly drmController: MockDrmController;
+    readonly mediaQualityMetadataResolver: jasmine.Spy<DashMediaQualityMetadataResolver>;
+};
+export type MockDashDependencies = ReturnType<typeof createMockDashDependencies>;
+//# sourceMappingURL=createMockDashDependencies.d.ts.map

package/dist/vinylTestUtil/types/current/mock/track/dash/createMockDashDependencies.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"createMockDashDependencies.d.ts","sourceRoot":"","sources":["../../../../../../../test/vinylTestUtil/mock/track/dash/createMockDashDependencies.ts"],"names":[],"mappings":"AAKA,OAAO,EACH,KAAK,WAAW,EAEhB,KAAK,gCAAgC,EAErC,KAAK,aAAa,EACrB,MAAM,eAAe,CAAA;AACtB,OAAO,EAAE,0BAA0B,EAAE,MAAM,wCAAwC,CAAA;AACnF,OAAO,EAAE,yBAAyB,EAAE,MAAM,sDAAsD,CAAA;AAChG,OAAO,EAAE,kBAAkB,EAAE,MAAM,oCAAoC,CAAA;AAEvE,OAAO,EAAE,sBAAsB,EAAE,MAAM,wCAAwC,CAAA;AAC/E,OAAO,EAAE,iBAAiB,EAAE,MAAM,8BAA8B,CAAA;AAShE,wBAAgB,0BAA0B;;;;;;;;;;;;EA4BzC;AAED,MAAM,MAAM,oBAAoB,GAAG,UAAU,CAAC,OAAO,0BAA0B,CAAC,CAAA"}

package/dist/vinylTestUtil/types/current/mock/track/dash/createMockDashDependencies.js

@@ -0,0 +1,38 @@
+/*
+ * Copyright Amazon.com, Inc. or its affiliates. All Rights Reserved.
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import { createEmptyMediaQualityMetadata, } from '@amazon/vinyl';
+import { MockDashManifestController } from '../../../mock/dash/MockDashManifestController';
+import { MockMediaSourceController } from '../../../mock/streaming/buffering/MockMediaSourceController';
+import { MockPlaybackSource } from '../../../mock/playback/MockPlaybackSource';
+import { MockContentStream } from '../../../mock/streaming/MockContentStream';
+import { MockPlaybackController } from '../../../mock/playback/MockPlaybackController';
+import { MockDrmController } from '../../../mock/drm/MockDrmController';
+import { createSpyFactory } from '@amazon/vinyl-util/browserTestUtil';
+import { data } from '@amazon/vinyl-observable';
+var createSpy = jasmine.createSpy;
+const emptyTimeline = { periods: [], minBufferTime: 0 };
+const spyFactory = createSpyFactory();
+export function createMockDashDependencies() {
+    const playbackController = new MockPlaybackController();
+    playbackController.seekTo.and.resolveTo(void 0);
+    const manifestController = new MockDashManifestController();
+    return {
+        contentTypesValue: data(Promise.resolve(new Set())),
+        contentStreamFactory: spyFactory('contentStreamFactory').and.callFake((contentType) => {
+            const stream = new MockContentStream();
+            stream.contentType = contentType;
+            return stream;
+        }),
+        manifestController,
+        manifestTransformed: manifestController,
+        mediaTimeline: data(Promise.resolve(emptyTimeline)),
+        mediaTimelineTransformed: data(Promise.resolve(emptyTimeline)),
+        mediaSourceController: new MockMediaSourceController(),
+        playbackSource: new MockPlaybackSource(),
+        playbackController,
+        drmController: new MockDrmController(),
+        mediaQualityMetadataResolver: createSpy().and.callFake(() => createEmptyMediaQualityMetadata()),
+    };
+}

package/dist/vinylTestUtil/types/current/mock/track/hls/createMockHlsDependencies.d.ts

@@ -0,0 +1,21 @@
+import { type ContentType, type HlsMediaQualityMetadataResolver, type MediaTimeline } from '@amazon/vinyl';
+import { MockHlsManifestController } from '../../../mock/hls/MockHlsManifestController';
+import { MockMediaSourceController } from '../../../mock/streaming/buffering/MockMediaSourceController';
+import { MockPlaybackSource } from '../../../mock/playback/MockPlaybackSource';
+import { MockPlaybackController } from '../../../mock/playback/MockPlaybackController';
+import { MockDrmController } from '../../../mock/drm/MockDrmController';
+export declare function createMockHlsDependencies(): {
+    readonly contentTypesValue: import("@amazon/vinyl-observable").MutableValueImpl<Promise<Set<ContentType>>>;
+    readonly contentStreamFactory: jasmine.Spy<((contentType: ContentType) => import("@amazon/vinyl").ContentStream) & ((contentType: ContentType) => any)>;
+    readonly manifestController: MockHlsManifestController;
+    readonly manifestTransformed: import("@amazon/vinyl-observable").MutableValue<Promise<import("@amazon/vinyl").HlsManifestData>>;
+    readonly mediaTimeline: import("@amazon/vinyl-observable").MutableValueImpl<Promise<MediaTimeline>>;
+    readonly mediaTimelineTransformed: import("@amazon/vinyl-observable").MutableValueImpl<Promise<MediaTimeline>>;
+    readonly mediaSourceController: MockMediaSourceController;
+    readonly playbackSource: MockPlaybackSource;
+    readonly playbackController: MockPlaybackController;
+    readonly drmController: MockDrmController;
+    readonly mediaQualityMetadataResolver: jasmine.Spy<HlsMediaQualityMetadataResolver>;
+};
+export type MockHlsDependencies = ReturnType<typeof createMockHlsDependencies>;
+//# sourceMappingURL=createMockHlsDependencies.d.ts.map

package/dist/vinylTestUtil/types/current/mock/track/hls/createMockHlsDependencies.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"createMockHlsDependencies.d.ts","sourceRoot":"","sources":["../../../../../../../test/vinylTestUtil/mock/track/hls/createMockHlsDependencies.ts"],"names":[],"mappings":"AAKA,OAAO,EACH,KAAK,WAAW,EAEhB,KAAK,+BAA+B,EAEpC,KAAK,aAAa,EACrB,MAAM,eAAe,CAAA;AACtB,OAAO,EAAE,yBAAyB,EAAE,MAAM,sCAAsC,CAAA;AAChF,OAAO,EAAE,yBAAyB,EAAE,MAAM,sDAAsD,CAAA;AAChG,OAAO,EAAE,kBAAkB,EAAE,MAAM,oCAAoC,CAAA;AAEvE,OAAO,EAAE,sBAAsB,EAAE,MAAM,wCAAwC,CAAA;AAC/E,OAAO,EAAE,iBAAiB,EAAE,MAAM,8BAA8B,CAAA;AAShE,wBAAgB,yBAAyB;;;;;;;;;;;;EA4BxC;AAED,MAAM,MAAM,mBAAmB,GAAG,UAAU,CAAC,OAAO,yBAAyB,CAAC,CAAA"}

package/dist/vinylTestUtil/types/current/mock/track/hls/createMockHlsDependencies.js

@@ -0,0 +1,38 @@
+/*
+ * Copyright Amazon.com, Inc. or its affiliates. All Rights Reserved.
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import { createEmptyMediaQualityMetadata, } from '@amazon/vinyl';
+import { MockHlsManifestController } from '../../../mock/hls/MockHlsManifestController';
+import { MockMediaSourceController } from '../../../mock/streaming/buffering/MockMediaSourceController';
+import { MockPlaybackSource } from '../../../mock/playback/MockPlaybackSource';
+import { MockContentStream } from '../../../mock/streaming/MockContentStream';
+import { MockPlaybackController } from '../../../mock/playback/MockPlaybackController';
+import { MockDrmController } from '../../../mock/drm/MockDrmController';
+import { createSpyFactory } from '@amazon/vinyl-util/browserTestUtil';
+import { data } from '@amazon/vinyl-observable';
+var createSpy = jasmine.createSpy;
+const emptyTimeline = { periods: [], minBufferTime: 0 };
+const spyFactory = createSpyFactory();
+export function createMockHlsDependencies() {
+    const playbackController = new MockPlaybackController();
+    playbackController.seekTo.and.resolveTo(void 0);
+    const manifestController = new MockHlsManifestController();
+    return {
+        contentTypesValue: data(Promise.resolve(new Set())),
+        contentStreamFactory: spyFactory('contentStreamFactory').and.callFake((contentType) => {
+            const stream = new MockContentStream();
+            stream.contentType = contentType;
+            return stream;
+        }),
+        manifestController,
+        manifestTransformed: manifestController.map((v) => v),
+        mediaTimeline: data(Promise.resolve(emptyTimeline)),
+        mediaTimelineTransformed: data(Promise.resolve(emptyTimeline)),
+        mediaSourceController: new MockMediaSourceController(),
+        playbackSource: new MockPlaybackSource(),
+        playbackController,
+        drmController: new MockDrmController(),
+        mediaQualityMetadataResolver: createSpy().and.callFake(() => createEmptyMediaQualityMetadata()),
+    };
+}

package/dist/vinylTestUtil/types/current/player/createVinylSuite.d.ts

@@ -0,0 +1,41 @@
+import { type VinylDependencyOptions, type VinylPlayer } from '@amazon/vinyl';
+export interface VinylSuiteOptions {
+    /**
+     * The number of seconds before the tests in this suite time out.
+     * Default is 60s.
+     */
+    readonly timeout?: number;
+    /**
+     * If true, will fail the test on error events.
+     * default: true
+     */
+    readonly failOnError?: boolean;
+}
+export declare class VinylSuite<T extends VinylPlayer<any, any> = VinylPlayer> {
+    /**
+     * Constructs a new player.
+     */
+    private readonly playerFactory;
+    protected readonly options?: VinylSuiteOptions | undefined;
+    get [Symbol.toStringTag](): string;
+    readonly logPrefix: string;
+    private _player;
+    get player(): T;
+    private readonly visibilityChangeHandler;
+    constructor(
+    /**
+     * Constructs a new player.
+     */
+    playerFactory: () => T, options?: VinylSuiteOptions | undefined);
+    /**
+     * Initializes jasmine test setup.
+     */
+    init(): void;
+}
+/**
+ * Prepares an integration test for a Vinyl Player.
+ * This will create a player, handle disposal and global cleanup, and watch for window
+ * visibility changes, which can interfere with test results.
+ */
+export declare function createVinylSuite(playerDependencyOptions?: Partial<VinylDependencyOptions>, options?: VinylSuiteOptions): VinylSuite;
+//# sourceMappingURL=createVinylSuite.d.ts.map

package/dist/vinylTestUtil/types/current/player/createVinylSuite.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"createVinylSuite.d.ts","sourceRoot":"","sources":["../../../../../test/vinylTestUtil/player/createVinylSuite.ts"],"names":[],"mappings":"AAKA,OAAO,EAEH,KAAK,sBAAsB,EAC3B,KAAK,WAAW,EACnB,MAAM,eAAe,CAAA;AAWtB,MAAM,WAAW,iBAAiB;IAC9B;;;OAGG;IACH,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAA;IAEzB;;;OAGG;IACH,QAAQ,CAAC,WAAW,CAAC,EAAE,OAAO,CAAA;CACjC;AAED,qBAAa,UAAU,CAAC,CAAC,SAAS,WAAW,CAAC,GAAG,EAAE,GAAG,CAAC,GAAG,WAAW;IAuB7D;;OAEG;IACH,OAAO,CAAC,QAAQ,CAAC,aAAa;IAC9B,SAAS,CAAC,QAAQ,CAAC,OAAO,CAAC,EAAE,iBAAiB;IA1BlD,IAAI,CAAC,MAAM,CAAC,WAAW,CAAC,IAAI,MAAM,CAEjC;IACD,QAAQ,CAAC,SAAS,SAAwB;IAE1C,OAAO,CAAC,OAAO,CAAiB;IAEhC,IAAI,MAAM,IAAI,CAAC,CAMd;IAED,OAAO,CAAC,QAAQ,CAAC,uBAAuB,CAIvC;;IAGG;;OAEG;IACc,aAAa,EAAE,MAAM,CAAC,EACpB,OAAO,CAAC,EAAE,iBAAiB,YAAA;IAGlD;;OAEG;IACH,IAAI;CA4BP;AAED;;;;GAIG;AACH,wBAAgB,gBAAgB,CAC5B,uBAAuB,CAAC,EAAE,OAAO,CAAC,sBAAsB,CAAC,EACzD,OAAO,CAAC,EAAE,iBAAiB,GAC5B,UAAU,CASZ"}

package/dist/vinylTestUtil/types/current/player/createVinylSuite.js

@@ -0,0 +1,75 @@
+/*
+ * Copyright Amazon.com, Inc. or its affiliates. All Rights Reserved.
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import { createVinylPlayer, } from '@amazon/vinyl';
+import { createLogPrefix, getGlobalRegistry, IllegalStateError, logDebug, } from '@amazon/vinyl-util';
+import { setTestTimeout } from '@amazon/vinyl-util/browserTestUtil';
+import { mediaRef } from '../player/mediaRef';
+export class VinylSuite {
+    playerFactory;
+    options;
+    get [Symbol.toStringTag]() {
+        return 'VinylSuite';
+    }
+    logPrefix = createLogPrefix(this);
+    _player = null;
+    get player() {
+        if (!this._player)
+            throw new IllegalStateError('player cannot be accessed outside of a test');
+        return this._player;
+    }
+    visibilityChangeHandler = () => {
+        if (document.visibilityState === 'hidden') {
+            fail('The window must remain visible during the tests.');
+        }
+    };
+    constructor(
+    /**
+     * Constructs a new player.
+     */
+    playerFactory, options) {
+        this.playerFactory = playerFactory;
+        this.options = options;
+    }
+    /**
+     * Initializes jasmine test setup.
+     */
+    init() {
+        let playerErrorSub = null;
+        setTestTimeout(this.options?.timeout ?? 60);
+        beforeEach(() => {
+            document.addEventListener('visibilitychange', this.visibilityChangeHandler);
+            this._player = this.playerFactory();
+            if (this.options?.failOnError !== false) {
+                playerErrorSub = this._player.on('error', (e) => {
+                    fail(e);
+                });
+            }
+        });
+        afterEach(() => {
+            logDebug(this, 'disposing');
+            if (playerErrorSub)
+                playerErrorSub();
+            this._player?.dispose();
+            this._player = null;
+            document.removeEventListener('visibilitychange', this.visibilityChangeHandler);
+            getGlobalRegistry().reset();
+        });
+    }
+}
+/**
+ * Prepares an integration test for a Vinyl Player.
+ * This will create a player, handle disposal and global cleanup, and watch for window
+ * visibility changes, which can interfere with test results.
+ */
+export function createVinylSuite(playerDependencyOptions, options) {
+    const suite = new VinylSuite(() => {
+        return createVinylPlayer({
+            ...playerDependencyOptions,
+            media: mediaRef.value,
+        });
+    }, options);
+    suite.init();
+    return suite;
+}

package/dist/vinylTestUtil/types/current/player/mediaRef.d.ts

@@ -0,0 +1,6 @@
+/**
+ * For reliable integ tests on 3P devices, there should be a single media element.
+ * When using the media element, unload any sources and reset any state after each test.
+ */
+export declare const mediaRef: import("@amazon/vinyl-util").Lazy<HTMLMediaElement>;
+//# sourceMappingURL=mediaRef.d.ts.map

package/dist/vinylTestUtil/types/current/player/mediaRef.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mediaRef.d.ts","sourceRoot":"","sources":["../../../../../test/vinylTestUtil/player/mediaRef.ts"],"names":[],"mappings":"AAOA;;;GAGG;AACH,eAAO,MAAM,QAAQ,qDAMnB,CAAA"}

package/dist/vinylTestUtil/types/current/player/mediaRef.js

@@ -0,0 +1,24 @@
+/*
+ * Copyright Amazon.com, Inc. or its affiliates. All Rights Reserved.
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import { lazy } from '@amazon/vinyl-util';
+/**
+ * For reliable integ tests on 3P devices, there should be a single media element.
+ * When using the media element, unload any sources and reset any state after each test.
+ */
+export const mediaRef = lazy(() => {
+    const media = document.createElement('video');
+    media.muted = true;
+    media.playsInline = true; // needed for iOS
+    media.disableRemotePlayback = true; // Disables casting. Needed for ManagedMediaSource
+    return media;
+});
+afterEach(() => {
+    if (mediaRef.constructed) {
+        // Reset the media element.
+        const media = mediaRef.value;
+        media.removeAttribute('src');
+        media.load();
+    }
+});