@amazon/vinyl 1.0.0

package/dist/types/current/global/globalRef.js

@@ -0,0 +1,50 @@
+/*
+ * Copyright Amazon.com, Inc. or its affiliates. All Rights Reserved.
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import { getNetworkMetrics, getUserAgentInfo, globalRef, historyLogHandler, toDisposable, } from '@amazon/vinyl-util';
+import { playerRegistryRef } from './PlayerRegistry';
+import { vinylVersion } from './environment';
+/**
+ * For console debugging, gives access to currently active players, logs, and client information.
+ */
+export class VinylGlobal {
+    get players() {
+        return playerRegistryRef.value.players;
+    }
+    /**
+     * Returns the first player.
+     */
+    get player() {
+        return playerRegistryRef.value.players[0];
+    }
+    get logs() {
+        return historyLogHandler.value?.history;
+    }
+    get version() {
+        return vinylVersion.str;
+    }
+    get userAgentInfo() {
+        return getUserAgentInfo();
+    }
+    get network() {
+        return getNetworkMetrics();
+    }
+    /**
+     * Returns the EWMA low estimate for the client's current bandwidth.
+     */
+    get bandwidth() {
+        return this.network.estimatedDownlinkBandwidth.ewmaLow;
+    }
+}
+/**
+ * Set the global vinylGlobal reference for easier console debugging.
+ * Intentionally typed as AnyRecord to prevent API usage from code. This is
+ * intended only for console debugging and the API may change at any time.
+ */
+export const vinylGlobalRef = globalRef(() => {
+    global.vinylGlobal = new VinylGlobal();
+    return toDisposable(() => {
+        delete global.vinylGlobal;
+    });
+});

package/dist/types/current/global/initializeVinylGlobal.d.ts

@@ -0,0 +1,2 @@
+export declare function initializeVinylGlobal(): void;
+//# sourceMappingURL=initializeVinylGlobal.d.ts.map

package/dist/types/current/global/initializeVinylGlobal.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"initializeVinylGlobal.d.ts","sourceRoot":"","sources":["../../../../src/global/initializeVinylGlobal.ts"],"names":[],"mappings":"AAQA,wBAAgB,qBAAqB,SAGpC"}

package/dist/types/current/global/initializeVinylGlobal.js

@@ -0,0 +1,10 @@
+/*
+ * Copyright Amazon.com, Inc. or its affiliates. All Rights Reserved.
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import { initializeLogging } from '@amazon/vinyl-util';
+import { vinylGlobalRef } from '../global/globalRef';
+export function initializeVinylGlobal() {
+    initializeLogging();
+    vinylGlobalRef.initialize();
+}

package/dist/types/current/index.d.ts

@@ -0,0 +1,132 @@
+/** Auto-generated from build scripts */
+export * from './vinyl/playerConfigFactory';
+export * from './vinyl/createVinylFactories';
+export * from './vinyl/VinylPlayer';
+export * from './vinyl/VinylPatchOptions';
+export * from './vinyl/VinylOptions';
+export * from './vinyl/VinylDeps';
+export * from './vinyl/ReadonlyPlaybackStreamingState';
+export * from './util/media/sourceBuffer';
+export * from './util/media/mediaSource';
+export * from './util/media/getAudioContext';
+export * from './track/createVinylTrackFactories';
+export * from './track/createSegmentDataProvider';
+export * from './track/TrackFactory';
+export * from './track/TrackController';
+export * from './track/TrackBase';
+export * from './track/Track';
+export * from './track/AutoResetController';
+export * from './track/source/SourceTrackBase';
+export * from './track/source/SourceTrack';
+export * from './track/source/SourceObjectTrack';
+export * from './track/source/FixedPlaybackQuality';
+export * from './track/mse/codec';
+export * from './track/mse/MseTrack';
+export * from './track/hls/createUrlHlsManifestProvider';
+export * from './track/hls/createHlsFactories';
+export * from './track/hls/createHlsContentTypesValue';
+export * from './track/hls/createHlsContentStreamFactories';
+export * from './track/hls/createDefaultHlsManifestTransformer';
+export * from './track/hls/buildHlsMediaTimeline';
+export * from './track/hls/HlsTrack';
+export * from './track/hls/HlsMediaQualityMetadataResolver';
+export * from './track/hls/HlsManifestProvider';
+export * from './track/hls/HlsManifestController';
+export * from './track/hls/util/hlsSegmentTime';
+export * from './track/hls/util/hlsByteRangeToMediaRange';
+export * from './track/filters/sampleRateFilter';
+export * from './track/filters/resourceTypeFilter';
+export * from './track/filters/languageFilter';
+export * from './track/filters/keySystemFilter';
+export * from './track/dash/urlDashManifestProvider';
+export * from './track/dash/manifestTransformUtils';
+export * from './track/dash/createSegmentControllerFactory';
+export * from './track/dash/createDefaultDashManifestTransformer';
+export * from './track/dash/createDashManifestProvider';
+export * from './track/dash/createDashFactories';
+export * from './track/dash/createDashContentTypesValue';
+export * from './track/dash/createDashContentStreamFactories';
+export * from './track/dash/buildDashMediaTimeline';
+export * from './track/dash/DashTrack';
+export * from './track/dash/DashMediaQualityMetadataResolver';
+export * from './track/dash/DashManifestProvider';
+export * from './track/dash/DashManifestController';
+export * from './track/dash/util/uriResolution';
+export * from './track/dash/util/mpd';
+export * from './track/dash/util/mimeType';
+export * from './track/dash/timeline/DashRepresentationSegmentProvider';
+export * from './streaming/mediaTimelineLanguageFilter';
+export * from './streaming/mediaTimelineFilter';
+export * from './streaming/createDefaultMediaTimelineTransformer';
+export * from './streaming/StreamingEventMap';
+export * from './streaming/SegmentReference';
+export * from './streaming/SegmentPrefetch';
+export * from './streaming/SegmentDataSlot';
+export * from './streaming/SegmentControllerImpl';
+export * from './streaming/SegmentController';
+export * from './streaming/MediaTimeline';
+export * from './streaming/MediaQualityMetadata';
+export * from './streaming/ManifestController';
+export * from './streaming/DrmInitDataType';
+export * from './streaming/DescriptorRecord';
+export * from './streaming/ContentTypesValue';
+export * from './streaming/ContentStreamingOptions';
+export * from './streaming/ContentStream';
+export * from './streaming/util/segment';
+export * from './streaming/buffering/SourceBufferController';
+export * from './streaming/buffering/MediaSourceController';
+export * from './streaming/buffering/BufferingController';
+export * from './streaming/buffering/error/SourceBufferError';
+export * from './streaming/abr/QualitySelectorImpl';
+export * from './streaming/abr/QualitySelector';
+export * from './playback/nextHasMetadata';
+export * from './playback/ReadonlyPlaybackController';
+export * from './playback/PlaybackSourceImpl';
+export * from './playback/PlaybackSource';
+export * from './playback/PlaybackControllerImpl';
+export * from './playback/PlaybackController';
+export * from './playback/loudness/LoudnessNormalizationControllerImplOptions';
+export * from './playback/loudness/LoudnessNormalizationControllerImpl';
+export * from './playback/loudness/LoudnessNormalizationController';
+export * from './playback/logging/playbackStateLoggingHandler';
+export * from './playback/logging/mediaErrorToJson';
+export * from './playback/error/ReportableMediaError';
+export * from './playback/error/InvalidSeekError';
+export * from './patch/media/patchMediaElement';
+export * from './patch/media/MediaElementPatchOptions';
+export * from './patch/media/HtmlMediaElementPatch';
+export * from './patch/media/patches/createUnreliablePlaybackEventsPatch';
+export * from './patch/media/patches/createPreventStallsPatch';
+export * from './global/initializeVinylGlobal';
+export * from './global/globalRef';
+export * from './global/environment';
+export * from './global/configureVinylGlobal';
+export * from './global/PlayerRegistry';
+export * from './event/ChangeEvent';
+export * from './event/BasicErrorEvent';
+export * from './drm/DrmOptions';
+export * from './drm/DrmKeySystemResolver';
+export * from './drm/DrmKeySystem';
+export * from './drm/DrmControllerImpl';
+export * from './drm/DrmController';
+export * from './drm/CencEncryptionScheme';
+export * from './drm/util/unpackPlayReadyChallenge';
+export * from './drm/util/extractContentId';
+export * from './drm/util/createFairPlaySessionInitData';
+export * from './drm/licenseProvider/defaultLicenseProvider';
+export * from './drm/licenseProvider/LicenseProvider';
+export * from './drm/error/DrmError';
+export * from './drm/dom/WebKitMediaKeys';
+export * from './drm/dom/MSMediaKeys';
+export * from './drm/dom/HTMLMediaElement';
+export * from './drm/commonEme/createDrmErrorHandler';
+export * from './drm/commonEme/WebKitCommonEme';
+export * from './drm/commonEme/StandardCommonEme';
+export * from './drm/commonEme/MsCommonEme';
+export * from './drm/commonEme/EncryptedInitData';
+export * from './drm/commonEme/CommonEmeFactory';
+export * from './drm/commonEme/CommonEme';
+export * from './client/Client';
+export * from './client/CapabilitiesImpl';
+export * from './client/Capabilities';
+//# sourceMappingURL=index.d.ts.map

package/dist/types/current/index.d.ts.map

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

package/dist/types/current/index.js

@@ -0,0 +1,131 @@
+/** Auto-generated from build scripts */
+export * from './vinyl/playerConfigFactory';
+export * from './vinyl/createVinylFactories';
+export * from './vinyl/VinylPlayer';
+export * from './vinyl/VinylPatchOptions';
+export * from './vinyl/VinylOptions';
+export * from './vinyl/VinylDeps';
+export * from './vinyl/ReadonlyPlaybackStreamingState';
+export * from './util/media/sourceBuffer';
+export * from './util/media/mediaSource';
+export * from './util/media/getAudioContext';
+export * from './track/createVinylTrackFactories';
+export * from './track/createSegmentDataProvider';
+export * from './track/TrackFactory';
+export * from './track/TrackController';
+export * from './track/TrackBase';
+export * from './track/Track';
+export * from './track/AutoResetController';
+export * from './track/source/SourceTrackBase';
+export * from './track/source/SourceTrack';
+export * from './track/source/SourceObjectTrack';
+export * from './track/source/FixedPlaybackQuality';
+export * from './track/mse/codec';
+export * from './track/mse/MseTrack';
+export * from './track/hls/createUrlHlsManifestProvider';
+export * from './track/hls/createHlsFactories';
+export * from './track/hls/createHlsContentTypesValue';
+export * from './track/hls/createHlsContentStreamFactories';
+export * from './track/hls/createDefaultHlsManifestTransformer';
+export * from './track/hls/buildHlsMediaTimeline';
+export * from './track/hls/HlsTrack';
+export * from './track/hls/HlsMediaQualityMetadataResolver';
+export * from './track/hls/HlsManifestProvider';
+export * from './track/hls/HlsManifestController';
+export * from './track/hls/util/hlsSegmentTime';
+export * from './track/hls/util/hlsByteRangeToMediaRange';
+export * from './track/filters/sampleRateFilter';
+export * from './track/filters/resourceTypeFilter';
+export * from './track/filters/languageFilter';
+export * from './track/filters/keySystemFilter';
+export * from './track/dash/urlDashManifestProvider';
+export * from './track/dash/manifestTransformUtils';
+export * from './track/dash/createSegmentControllerFactory';
+export * from './track/dash/createDefaultDashManifestTransformer';
+export * from './track/dash/createDashManifestProvider';
+export * from './track/dash/createDashFactories';
+export * from './track/dash/createDashContentTypesValue';
+export * from './track/dash/createDashContentStreamFactories';
+export * from './track/dash/buildDashMediaTimeline';
+export * from './track/dash/DashTrack';
+export * from './track/dash/DashMediaQualityMetadataResolver';
+export * from './track/dash/DashManifestProvider';
+export * from './track/dash/DashManifestController';
+export * from './track/dash/util/uriResolution';
+export * from './track/dash/util/mpd';
+export * from './track/dash/util/mimeType';
+export * from './track/dash/timeline/DashRepresentationSegmentProvider';
+export * from './streaming/mediaTimelineLanguageFilter';
+export * from './streaming/mediaTimelineFilter';
+export * from './streaming/createDefaultMediaTimelineTransformer';
+export * from './streaming/StreamingEventMap';
+export * from './streaming/SegmentReference';
+export * from './streaming/SegmentPrefetch';
+export * from './streaming/SegmentDataSlot';
+export * from './streaming/SegmentControllerImpl';
+export * from './streaming/SegmentController';
+export * from './streaming/MediaTimeline';
+export * from './streaming/MediaQualityMetadata';
+export * from './streaming/ManifestController';
+export * from './streaming/DrmInitDataType';
+export * from './streaming/DescriptorRecord';
+export * from './streaming/ContentTypesValue';
+export * from './streaming/ContentStreamingOptions';
+export * from './streaming/ContentStream';
+export * from './streaming/util/segment';
+export * from './streaming/buffering/SourceBufferController';
+export * from './streaming/buffering/MediaSourceController';
+export * from './streaming/buffering/BufferingController';
+export * from './streaming/buffering/error/SourceBufferError';
+export * from './streaming/abr/QualitySelectorImpl';
+export * from './streaming/abr/QualitySelector';
+export * from './playback/nextHasMetadata';
+export * from './playback/ReadonlyPlaybackController';
+export * from './playback/PlaybackSourceImpl';
+export * from './playback/PlaybackSource';
+export * from './playback/PlaybackControllerImpl';
+export * from './playback/PlaybackController';
+export * from './playback/loudness/LoudnessNormalizationControllerImplOptions';
+export * from './playback/loudness/LoudnessNormalizationControllerImpl';
+export * from './playback/loudness/LoudnessNormalizationController';
+export * from './playback/logging/playbackStateLoggingHandler';
+export * from './playback/logging/mediaErrorToJson';
+export * from './playback/error/ReportableMediaError';
+export * from './playback/error/InvalidSeekError';
+export * from './patch/media/patchMediaElement';
+export * from './patch/media/MediaElementPatchOptions';
+export * from './patch/media/HtmlMediaElementPatch';
+export * from './patch/media/patches/createUnreliablePlaybackEventsPatch';
+export * from './patch/media/patches/createPreventStallsPatch';
+export * from './global/initializeVinylGlobal';
+export * from './global/globalRef';
+export * from './global/environment';
+export * from './global/configureVinylGlobal';
+export * from './global/PlayerRegistry';
+export * from './event/ChangeEvent';
+export * from './event/BasicErrorEvent';
+export * from './drm/DrmOptions';
+export * from './drm/DrmKeySystemResolver';
+export * from './drm/DrmKeySystem';
+export * from './drm/DrmControllerImpl';
+export * from './drm/DrmController';
+export * from './drm/CencEncryptionScheme';
+export * from './drm/util/unpackPlayReadyChallenge';
+export * from './drm/util/extractContentId';
+export * from './drm/util/createFairPlaySessionInitData';
+export * from './drm/licenseProvider/defaultLicenseProvider';
+export * from './drm/licenseProvider/LicenseProvider';
+export * from './drm/error/DrmError';
+export * from './drm/dom/WebKitMediaKeys';
+export * from './drm/dom/MSMediaKeys';
+export * from './drm/dom/HTMLMediaElement';
+export * from './drm/commonEme/createDrmErrorHandler';
+export * from './drm/commonEme/WebKitCommonEme';
+export * from './drm/commonEme/StandardCommonEme';
+export * from './drm/commonEme/MsCommonEme';
+export * from './drm/commonEme/EncryptedInitData';
+export * from './drm/commonEme/CommonEmeFactory';
+export * from './drm/commonEme/CommonEme';
+export * from './client/Client';
+export * from './client/CapabilitiesImpl';
+export * from './client/Capabilities';

package/dist/types/current/patch/media/HtmlMediaElementPatch.d.ts

@@ -0,0 +1,3 @@
+import type { Patch } from '@amazon/vinyl-util';
+export type HtmlMediaElementPatch = Patch<HTMLMediaElement, HTMLMediaElementEventMap>;
+//# sourceMappingURL=HtmlMediaElementPatch.d.ts.map

package/dist/types/current/patch/media/HtmlMediaElementPatch.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"HtmlMediaElementPatch.d.ts","sourceRoot":"","sources":["../../../../../src/patch/media/HtmlMediaElementPatch.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,oBAAoB,CAAA;AAE/C,MAAM,MAAM,qBAAqB,GAAG,KAAK,CACrC,gBAAgB,EAChB,wBAAwB,CAC3B,CAAA"}

package/dist/types/current/patch/media/HtmlMediaElementPatch.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/patch/media/MediaElementPatchOptions.d.ts

@@ -0,0 +1,19 @@
+export interface MediaElementPatchOptions {
+    /**
+     * Playback events 'playing' and 'waiting' are unreliable after seeking.
+     *
+     * Risks for false positive: LOW. Timing of emitted playing events may be subtly
+     * different, but they will not be duplicated.
+     * Risks for false negative: MEDIUM. Certain playback events on affected platforms will be missed.
+     */
+    readonly unreliablePlaybackEvents?: boolean;
+    /**
+     * The affected user agent gets into a state where playback can become stalled and needs help getting unstuck.
+     */
+    readonly preventStalls?: boolean;
+}
+/**
+ * Aggregates flags for toggling patches.
+ */
+export declare const defaultMediaElementPatchOptions: import("@amazon/vinyl-util").Lazy<Required<MediaElementPatchOptions>>;
+//# sourceMappingURL=MediaElementPatchOptions.d.ts.map

package/dist/types/current/patch/media/MediaElementPatchOptions.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"MediaElementPatchOptions.d.ts","sourceRoot":"","sources":["../../../../../src/patch/media/MediaElementPatchOptions.ts"],"names":[],"mappings":"AASA,MAAM,WAAW,wBAAwB;IACrC;;;;;;OAMG;IACH,QAAQ,CAAC,wBAAwB,CAAC,EAAE,OAAO,CAAA;IAE3C;;OAEG;IACH,QAAQ,CAAC,aAAa,CAAC,EAAE,OAAO,CAAA;CACnC;AAED;;GAEG;AACH,eAAO,MAAM,+BAA+B,uEAO1C,CAAA"}

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

@@ -0,0 +1,16 @@
+/*
+ * Copyright Amazon.com, Inc. or its affiliates. All Rights Reserved.
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import { lazy } from '@amazon/vinyl-util';
+import { requiresUnreliablePlaybackEventsPatch } from './patches/createUnreliablePlaybackEventsPatch';
+import { requiresPreventStallsPatch } from '../../patch/media/patches/createPreventStallsPatch';
+/**
+ * Aggregates flags for toggling patches.
+ */
+export const defaultMediaElementPatchOptions = lazy(() => {
+    return {
+        unreliablePlaybackEvents: requiresUnreliablePlaybackEventsPatch(),
+        preventStalls: requiresPreventStallsPatch(),
+    };
+});

package/dist/types/current/patch/media/patchMediaElement.d.ts

@@ -0,0 +1,9 @@
+import { type PatchedRef } from '@amazon/vinyl-util';
+import type { MediaElementPatchOptions } from './MediaElementPatchOptions';
+/**
+ * Applies patches corresponding to the patch flags on the given media element.
+ *
+ * Adds logging for fabricated or squelched events.
+ */
+export declare function patchMediaElement<T extends HTMLMediaElement = HTMLMediaElement>(media: T, options: MediaElementPatchOptions): PatchedRef<T>;
+//# sourceMappingURL=patchMediaElement.d.ts.map

package/dist/types/current/patch/media/patchMediaElement.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"patchMediaElement.d.ts","sourceRoot":"","sources":["../../../../../src/patch/media/patchMediaElement.ts"],"names":[],"mappings":"AAKA,OAAO,EAAE,KAAK,UAAU,EAAwB,MAAM,oBAAoB,CAAA;AAC1E,OAAO,KAAK,EAAE,wBAAwB,EAAE,MAAM,4BAA4B,CAAA;AAI1E;;;;GAIG;AACH,wBAAgB,iBAAiB,CAC7B,CAAC,SAAS,gBAAgB,GAAG,gBAAgB,EAC/C,KAAK,EAAE,CAAC,EAAE,OAAO,EAAE,wBAAwB,GAAG,UAAU,CAAC,CAAC,CAAC,CAO5D"}

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

@@ -0,0 +1,15 @@
+/*
+ * Copyright Amazon.com, Inc. or its affiliates. All Rights Reserved.
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import { patchTargetFromFlags } from '@amazon/vinyl-util';
+import { createUnreliablePlaybackEventsPatch } from './patches/createUnreliablePlaybackEventsPatch';
+import { createPreventStallsPatch } from '../../patch/media/patches/createPreventStallsPatch';
+/**
+ * Applies patches corresponding to the patch flags on the given media element.
+ *
+ * Adds logging for fabricated or squelched events.
+ */
+export function patchMediaElement(media, options) {
+    return patchTargetFromFlags(media, options, ['unreliablePlaybackEvents', createUnreliablePlaybackEventsPatch], ['preventStalls', createPreventStallsPatch]);
+}

package/dist/types/current/patch/media/patches/createPreventStallsPatch.d.ts

@@ -0,0 +1,17 @@
+import type { HtmlMediaElementPatch } from '../../../patch/media/HtmlMediaElementPatch';
+/**
+ * The number of timeupdate events stuck at the same position before attempting to jiggle the playhead.
+ * @private
+ */
+export declare const MAX_UNCHANGED_COUNT = 10;
+/**
+ * On affected UAs, playback can become stuck. timeupdate events are observed but playback position is never changing.
+ * This patch applies a workaround which will pause and play again after max number of timeupdate events with no
+ * actual time progression.
+ */
+export declare function createPreventStallsPatch(media: HTMLMediaElement): HtmlMediaElementPatch;
+/**
+ * Returns true if stall detection should be enabled for the current user agent.
+ */
+export declare function requiresPreventStallsPatch(): boolean;
+//# sourceMappingURL=createPreventStallsPatch.d.ts.map

package/dist/types/current/patch/media/patches/createPreventStallsPatch.d.ts.map

@@ -0,0 +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"}

package/dist/types/current/patch/media/patches/createPreventStallsPatch.js

@@ -0,0 +1,55 @@
+/*
+ * Copyright Amazon.com, Inc. or its affiliates. All Rights Reserved.
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import { Browser, closeTo, createDisposer, createLogPrefix, DomEventHost, hasBrowser, logInfo, logWarn, noop, } from '@amazon/vinyl-util';
+/**
+ * The number of timeupdate events stuck at the same position before attempting to jiggle the playhead.
+ * @private
+ */
+export const MAX_UNCHANGED_COUNT = 10;
+/**
+ * On affected UAs, playback can become stuck. timeupdate events are observed but playback position is never changing.
+ * This patch applies a workaround which will pause and play again after max number of timeupdate events with no
+ * actual time progression.
+ */
+export function createPreventStallsPatch(media) {
+    const { add, dispose } = createDisposer();
+    const domEvents = add(new DomEventHost(media));
+    const pathTarget = {
+        logPrefix: createLogPrefix('createPreventStallsPatch'),
+    };
+    let unchangedCount = 0;
+    let attemptedFix = false;
+    let previousTime = media.currentTime;
+    domEvents.on('timeupdate', () => {
+        if (media.paused)
+            return;
+        if (closeTo(media.currentTime, previousTime, 0.01)) {
+            if (++unchangedCount >= MAX_UNCHANGED_COUNT && !attemptedFix) {
+                logWarn(pathTarget, `Detected stall at time ${media.currentTime}, attempting fix`);
+                attemptedFix = true;
+                unchangedCount = 0;
+                media.pause();
+                media.play().catch(noop);
+            }
+        }
+        else {
+            if (attemptedFix) {
+                logInfo(pathTarget, 'stall ended');
+                attemptedFix = false;
+            } // Unstuck
+            unchangedCount = 0;
+            previousTime = media.currentTime;
+        }
+    });
+    return {
+        dispose,
+    };
+}
+/**
+ * Returns true if stall detection should be enabled for the current user agent.
+ */
+export function requiresPreventStallsPatch() {
+    return hasBrowser(Browser.EDGE_LEGACY);
+}

package/dist/types/current/patch/media/patches/createUnreliablePlaybackEventsPatch.d.ts

@@ -0,0 +1,26 @@
+import type { HtmlMediaElementPatch } from '../../../patch/media/HtmlMediaElementPatch';
+/**
+ * The interval (in seconds) to poll for time progress in a media element.
+ *
+ * @private
+ */
+export declare const UNRELIABLE_EVENTS_POLL_INTERVAL = 0.2;
+/**
+ * Minimum amount of time playback must be stalled before fabricating a waiting event.
+ */
+export declare const MIN_STALLED_BEFORE_FAB = 0.8;
+/**
+ * Minimum amount of time playback must be progressing before fabricating a playing event.
+ */
+export declare const MIN_PLAYING_BEFORE_FAB = 0.4;
+/**
+ * Playback events such as playing, canPlay, and waiting are unreliable on this platform.
+ * Watch playback state and fabricate events when necessary.
+ */
+export declare function createUnreliablePlaybackEventsPatch(media: HTMLMediaElement): HtmlMediaElementPatch;
+/**
+ * Chrome <= 53 has unreliable waiting events.
+ * Safari, and Edge Legacy miss playing events after seeking.
+ */
+export declare function requiresUnreliablePlaybackEventsPatch(): boolean;
+//# sourceMappingURL=createUnreliablePlaybackEventsPatch.d.ts.map

package/dist/types/current/patch/media/patches/createUnreliablePlaybackEventsPatch.d.ts.map

@@ -0,0 +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"}