rx-player 4.0.0-dev.2023121900 → 4.0.0-rc.1

package/.eslintrc.js

@@ -176,6 +176,8 @@ module.exports = {
     "@typescript-eslint/no-namespace": "error",
     "@typescript-eslint/no-non-null-assertion": "error",
     "@typescript-eslint/no-this-alias": "error",
+    // Might be enabled in the future, for now this is too much work:
+    "@typescript-eslint/no-unsafe-enum-comparison": ["off"],
     "@typescript-eslint/no-unnecessary-boolean-literal-compare": "error",
     "@typescript-eslint/no-unnecessary-qualifier": "error",
     "@typescript-eslint/no-unnecessary-type-arguments": "error",

package/.github/workflows/checks.yml

@@ -10,7 +10,7 @@ on:
     types: [opened, synchronize, reopened]
 
 jobs:
-  check:
+  typechecking_and_linting:
 
     runs-on: ubuntu-latest
 
@@ -28,6 +28,24 @@ jobs:
         cache: 'npm'
     - run: npm install
     - run: npm run check
+
+  unit_tests:
+
+    runs-on: ubuntu-latest
+
+    strategy:
+      matrix:
+        node-version: [16.x]
+        # See supported Node.js release schedule at https://nodejs.org/en/about/releases/
+
+    steps:
+    - uses: actions/checkout@v2
+    - name: Use Node.js ${{ matrix.node-version }}
+      uses: actions/setup-node@v2
+      with:
+        node-version: ${{ matrix.node-version }}
+        cache: 'npm'
+    - run: npm install
     - run: npm run test:unit
 
   integration_linux:
@@ -46,56 +64,15 @@ jobs:
       with:
         node-version: ${{ matrix.node-version }}
         cache: 'npm'
+    - uses: actions-rs/toolchain@v1
+      with:
+        toolchain: stable
     # needed for integration & memory tests codecs support
     - run: sudo add-apt-repository multiverse && sudo apt update && sudo apt install -y ubuntu-restricted-extras
     - run: npm install
+    - run: rustup target add wasm32-unknown-unknown
+    - run: npm run build
     # Firefox seems to have issue with integration tests on GitHub actions only
     # TODO to check
     - run: node tests/integration/run.mjs --bchromehl
     - run: npm run test:memory
-
-  # Windows seems to be a lot less stable for some reason.
-  # TODO debug?
-  # integration_windows:
-
-  #   runs-on: windows-latest
-
-  #   strategy:
-  #     matrix:
-  #       node-version: [16.x]
-  #       # See supported Node.js release schedule at https://nodejs.org/en/about/releases/
-
-  #   steps:
-  #   - uses: actions/checkout@v2
-  #   - name: Use Node.js ${{ matrix.node-version }}
-  #     uses: actions/setup-node@v2
-  #     with:
-  #       node-version: ${{ matrix.node-version }}
-  #       cache: 'npm'
-  #   - run: npm install
-  #   # Firefox seems to have issue with integration tests on GitHub actions only
-  #   # TODO to check
-  #   - run: node tests/integration/run.mjs --bchromehl
-  #   - run: npm run test:memory
-
-  # MacOS seems to be a lot less stable for some reason.
-  # TODO debug?
-  # integration_macos:
-
-  #   runs-on: macos-latest
-
-  #   strategy:
-  #     matrix:
-  #       node-version: [16.x]
-  #       # See supported Node.js release schedule at https://nodejs.org/en/about/releases/
-
-  #   steps:
-  #   - uses: actions/checkout@v2
-  #   - name: Use Node.js ${{ matrix.node-version }}
-  #     uses: actions/setup-node@v2
-  #     with:
-  #       node-version: ${{ matrix.node-version }}
-  #       cache: 'npm'
-  #   - run: npm install
-  #   - run: npm run test:integration:gh-actions
-  #   - run: npm run test:memory

package/CHANGELOG.md

@@ -1,95 +1,4 @@
-## v4.0.0-dev.2023121900 (2023-12-19)
-
-### Changes
-
-  - A `representationFilter`'s advertised `codec` has now been renamed to `codecs` and is an Array when defined [#1332]
-
-### Features
-
-  - Add `getLivePosition` RxPlayer method [#1300]
-  - Add `startAt.fromLivePosition` `loadVideo` option [#1300]
-  - add `connectionTimeout` property to the `requestConfig` `loadVideo` option for both the manifest and segment requests to set a timeout just linked to HTTP connection establishment [#1319]
-  - Add the possibility to set a new `keySystems` option on the `reload` API [#1308]
-
-### Bug fixes
-
-  - Fix subtitles "blinking" in some specific conditions, especially with some DASH low-latency contents [#1314]
-  - DASH: Fix Period overlap resolution logic for when the first Period is removed [#1311]
-  - TTML: Fix handling of the `tts:lineHeight` attribute [#1320]
-  - Fix import of the `LOCAL_MANIFEST` experimental feature
-  - Smooth: Rely on a defined `segmentLoader` when playing smooth streaming contents.
-  - Avoid very rarely skipping segments which initially were too big to be pushed due to memory limitations [#1323]
-  - Tizen (Samsung TVs): Try again to work around all potential issues that could arise due to tizen seeking back by itself [#1327]
-
-### Other improvements
-
-  - Provide both commonJS and ES6-style exports to improve compatibilities with applications
-  - DASH: rely on SCTE214 `supplementalCodecs` instead of `codecs` if it's supported to better support backward compatible Dolby Vision contents [#1307]
-  - DASH: Provide better support of the `availabilityTimeOffset` attribute [#1300]
-  - DEBUG_ELEMENT: Add unsupported and undecipherable bitrates to the debug element [#1321]
-  - DEBUG_ELEMENT: update buffer graph maximum size so it becomes more readable for lengthy contents [#1316]
-  - DEBUG_ELEMENT: always synchronize inventory of segments before rendering it [#1317]
-  - Remove remaining RxPlayer dependency removing possibility of some application-side bundling errors [#1312]
-  - Add cache when checking for codec support, improving performance on some devices and potentially working around some xbox bugs on long-lived pages [#1324]
-  - Add exception to text Garbage collection logic to avoid unnecessarily reload text segments frequently [#1325]
-  - Demo: Fix switching mode toggle [#1328]
-  - Demo: Add possibility to see the debug element in the demo page
-  - Demo: Fix reporting of live position in demo page [#1313]
-
-
-## v4.0.0-beta.3 (2023-10-19)
-
-### Changes
-
-  - The `MediaError`'s `trackInfo` property is now an array renamed as `tracksInfo` and similar `MediaError` are grouped in one [#1264]
-  - The `manifestUpdateUrl` `loadVideo` option has been removed as it was unused [#1276]
-  - The `/dist` directory in the project has been removed [#1270]
-
-### Bug fixes
-
-  - Fix adaptive logic on some legacy Edge browsers [#1302]
-
-### Other improvements
-
-  - `newAvailablePeriods` is now sent lazily at the time new Periods are considered to improve performance [#1265]
-  - Implement better error messages by not repeating the Error Type in it [#1290]
-  - All import path to the RxPlayer now depend on the same RxPlayer modular build (and not just the minimal, as before) [#1301]
-
-
-## v4.0.0-beta.2 (2023-06-27)
-
-### Changes
-
-  - If all Representations from the current track become undecipherable, automatically switch to another track (also send a `trackUpdate` event) instead of stopping on error [#1234]
-  - Only send `MediaError` errors with the `NO_PLAYABLE_REPRESENTATION` error code when no Representation from all tracks of a given type can be played [#1234]
-
-### Features
-
-  - Add `representationListUpdate` event for when the list of available Representation for a current track changes [#1240]
-  - Add `"no-playable-representation"` as a `reason` for `trackUpdate` events when the track switch is due to encrypted Representations [#1234]
-
-### Other improvements
-
-  - DRM: Reload when playback is unexpectedly frozen with encrypted but only decipherable data in the buffer to work-around rare encryption-related issues [#1236]
-
-
-## v4.0.0-beta.1 (2023-03-08)
-
-### Bug fixes
-
-  - (v4.0.0-beta.0-only issue) Fix memory leak
-  - (v4.0.0-beta.0-only issue) Fix MediaSource duration when the maximum buffered end is inferior to current duration but superior to calculated duration
-  - (v4.0.0-beta.0-only issue) Fix `stopAtEnd` option by also switching to STOPPED state on ended
-  - (v4.0.0-beta.0-only issue) Fix some target's support by not relying on `Promise.prototype.finally` anymore [#1224]
-  - (v4.0.0-beta.0-only issue) For dynamic contents, always set a very high duration [#1220]
-  - (v4.0.0-beta.0-only issue) DRM: Fix fallbacking for an already-played content by checking key statuses initially linked to a MediaKeySession
-
-### Other improvements
-
-  - Based on the v3.30.0 of which it inherits all the features, bug fixes and other improvements
-
-
-## v4.0.0-beta.0 (2023-01-27)
+## v4.0.0-rc.1 (2024-01-24)
 
 ### Changes
 
@@ -150,9 +59,19 @@
   - Remove public types `IDefaultAudioTrackOption` and `IDefaultTextTrackOption`. Those are the types respectively for `defaultAudioTrack` and `defaultTextTrack` `loadVideo` options which have been removed
   - Remove public types `IAudioTrackPreference`, `ITextTrackPreference` and `IVideoTrackPreference` as the corresponding API do not exist anymore.
   - Stop officially supporting the Internet Explorer 11 browser
+  - The `MediaError`'s `trackInfo` property is now an array renamed as `tracksInfo` and similar `MediaError` are grouped in one [#1264]
+  - The `manifestUpdateUrl` `loadVideo` option has been removed as it was unused [#1276]
+  - `volumeChange` events are now sending both the audio volume and the muted status [#1348]
+  - `mute`/`unMute`/`isMute` now rely on the `HTMLMediaElement`'s `muted` property and not the audio volume [#1348]
+  - A `representationFilter`'s advertised `codec` has now been renamed to `codecs` and is an Array when defined [#1332]
+  - `DASH_WASM` and `DEBUG_ELEMENT` are not experimental features anymore [#1339]
+  - The `parseBifThumbnails` function is not an experimental tool anymore [#1339]
+  - If all Representations from the current track become undecipherable, automatically switch to another track (also send a `trackUpdate` event) instead of stopping on error [#1234]
+  - Only send `MediaError` errors with the `NO_PLAYABLE_REPRESENTATION` error code when no Representation from all tracks of a given type can be played [#1234]
 
 ### Features
 
+  - Add `MULTI_THREAD` experimental feature to enable multithreading capabilities through a WebWorker
   - `setAudioTrack`, `setVideoTrack` and `setTextTrack` now may take an object in argument, with the track's id set as a `trackId` property, to allow new features
   - Add `switchingMode` optional property to `setVideoTrack` and `setAudioTrack`, to configure the way in which the RxPlayer switches between the previous and new track
   - Add optional `periodId` property to `setAudioTrack`, `setVideoTrack` and `setTextTrack`, to allow setting the track of another, future or past, Period.
@@ -164,45 +83,79 @@
   - Add `lockVideoRepresentations`, `lockAudioRepresentations`, `getLockedVideoRepresentations`, `getLockedAudioRepresentations`, `unlockVideoRepresentations` and `unlockAudioRepresentations` methods to allow a complex selection of Representations that are currently allowed to play.
   - Add `getVideoRepresentation` and `getAudioRepresentation` method to retrieve information on the currently loaded representations [#1144]
   - Add `audioRepresentationChange` and `videoRepresentationChange` events to be notified when the currently-loaded Representation for the current Period changes.
-  - Add `updateContentUrls` API, allowing to update the Manifest's URL during playback [#1182]
-  - DASH: implement forced-subtitles, adding the `forced` property to the audio tracks API and selecting by default a forced text track linked to the audio track's language if present [#1187]
   - Add `getContentUrls` allowing to retrieve the one or several known URLs through which the current Manifest or content is reachable.
   - Add `videoResolutionLimit` constructor option allowing to automatically limit a video Representation's resolution.
   - Add `newAvailablePeriods` event to signal new Period on which a track and/or Representation choice can be made
   - Add `brokenRepresentationsLock` event for when a Representations lock could not be respected anymore
   - Add `trackUpdate` event for when a track has been updated for any type and Period
-  - Add  `distinctiveIdentifier` property in the `keySystems` option (given to the `loadVideo` method) to have full control over the MediaKeySystemConfiguration of the same name in the chosen key system [#1148]
-  - Add  `persistentState`  property in the `keySystems` option (given to the `loadVideo` method) to have full control over the MediaKeySystemConfiguration of the same name in the chosen key system [#1148]
+  - Add `distinctiveIdentifier` property in the `keySystems` option (given to the `loadVideo` method) to have full control over the MediaKeySystemConfiguration of the same name in the chosen key system [#1148]
+  - Add `persistentState`  property in the `keySystems` option (given to the `loadVideo` method) to have full control over the MediaKeySystemConfiguration of the same name in the chosen key system [#1148]
   - Add `keySystems[].onKeyOutputRestricted` and `keySystems[].onKeyInternalError` properties to configure the RxPlayer's behavior when a key switches to the status respectively `"output-restricted"` and `"internal-error"`
   - Add `audioCapabilitiesConfig` and `videoCapabilitiesConfig` properties in the `keySystems` option (given to the `loadVideo` method)  to allow advanced configuration of respectively the "audioCapabilities" and "videoCapabilities" in the asked MediaKeySystemConfiguration [#1148]
-  - Add `ISegmentLoaderContext` public type for the first argument of the `segmentLoader` API
-  - Add `IRepresentationFilterRepresentation` public type for the first argument of the `representationFilter` API
-  - Add `IRepresentationContext` public type for the second argument of the `representationFilter` API
-  - Add `IManifestLoaderInfo` public type for the first argument of the `manifestLoader` API
-  - Add `IPeriodChangeEvent` public type to define the properties send through a `periodChange` event
-  - Add `IPeriod` public type to define a Period object returned by methods like `getAvailablePeriods` or `getCurrentPeriod`
-  - Add `IVideoTrackSwitchingMode` public type to define the type of the `switchingMode` property optionally given to `setAudioTrack`
-  - Add `IAudioRepresentationsSwitchingMode` public type to define the type of the `switchingMode` property optionally given to `lockAudioRepresentations`
-  - Add `IVideoRepresentationsSwitchingMode` public type to define the type of the `switchingMode` property optionally given to `lockAudioRepresentations`
-  - Add `IBrokenRepresentationsLockContext` public type to define the type sent as a payload of the `brokenRepresentationsLock` event
-  - Add `ITrackUpdateEventPayload` public type to define the type sent as a payload of the `trackUpdate` event
-  - Add `ILockedVideoRepresentationsSettings` public type to define the object that should be given to the new `lockVideoRepresentation` method
-  - Add `ILockedAudioRepresentationsSettings` public type to define the object that should be given to the new `lockAudioRepresentation` method
-  - Add `IAudioTrackSetting` public type to define the object that may be given to the `setAudioTrack` method
-  - Add `IVideoTrackSetting` public type to define the object that may be given to the `setVideoTrack` method
-  - Add `ITextTrackSetting` public type to define the object that may be given to the `setTextTrack` method
+  - Add `representationListUpdate` event for when the list of available Representation for a current track changes [#1240]
+  - add `connectionTimeout` property to the `requestConfig` `loadVideo` option for both the manifest and segment requests to set a timeout just linked to HTTP connection establishment [#1319]
+  - Add `relativeResumingPosition` property to the `setVideoTrack`and `setAudioTrack` options [#1331]
+  - types: export type `ICompatibleKeySystem` to the public API [#1340]
+  - types: Add `ISegmentLoaderContext` public type for the first argument of the `segmentLoader` API
+  - types: Add `IRepresentationFilterRepresentation` public type for the first argument of the `representationFilter` API
+  - types: Add `IRepresentationContext` public type for the second argument of the `representationFilter` API
+  - types: Add `IManifestLoaderInfo` public type for the first argument of the `manifestLoader` API
+  - types: Add `IPeriodChangeEvent` public type to define the properties send through a `periodChange` event
+  - types: Add `IPeriod` public type to define a Period object returned by methods like `getAvailablePeriods` or `getCurrentPeriod`
+  - types: Add `IVideoTrackSwitchingMode` public type to define the type of the `switchingMode` property optionally given to `setAudioTrack`
+  - types: Add `IAudioRepresentationsSwitchingMode` public type to define the type of the `switchingMode` property optionally given to `lockAudioRepresentations`
+  - types: Add `IVideoRepresentationsSwitchingMode` public type to define the type of the `switchingMode` property optionally given to `lockAudioRepresentations`
+  - types: Add `IBrokenRepresentationsLockContext` public type to define the type sent as a payload of the `brokenRepresentationsLock` event
+  - types: Add `ITrackUpdateEventPayload` public type to define the type sent as a payload of the `trackUpdate` event
+  - types: Add `ILockedVideoRepresentationsSettings` public type to define the object that should be given to the new `lockVideoRepresentation` method
+  - types: Add `ILockedAudioRepresentationsSettings` public type to define the object that should be given to the new `lockAudioRepresentation` method
+  - types: Add `IAudioTrackSetting` public type to define the object that may be given to the `setAudioTrack` method
+  - types: Add `IVideoTrackSetting` public type to define the object that may be given to the `setVideoTrack` method
+  - types: Add `ITextTrackSetting` public type to define the object that may be given to the `setTextTrack` method
 
 ### Bug fixes
 
-  - Fix segment requesting error when playing a DASH content without an url and without BaseURL elements [#1192]
-  - API: Stop sending events if the content is stopped due to a side-effect of one of the event handler [#1197]
-  - text-tracks/ttml: fix inconsistent line spacing when resizing the `textTrackElement` [#1191]
-  - DRM: Fix race condition leading to a JS error instead of a `NO_PLAYABLE_REPRESENTATION` [#1201]
-  - DRM/Compat: Renew MediaKeys at each `loadVideo` on all WebOS (LG TV) platforms to work around issues [#1188]
+  - Tizen (Samsung TVs): Try again to work around all potential issues that could arise due to tizen seeking back by itself [#1327, #1355]
 
 ### Other improvements
 
-  - Remove dependency to RxJS, improving the debugging experience and preventing some uncaught Error from being thrown
+  - Provide both commonJS and ES6-style exports to improve compatibilities with applications
+  - Implement better error messages by not repeating the Error Type in it [#1290]
+  - DRM: Reload when playback is unexpectedly frozen with encrypted but only decipherable data in the buffer to work-around rare encryption-related issues [#1236]
+  - Add cache when checking for codec support, improving performance on some devices and potentially working around some xbox bugs on long-lived pages [#1324]
+  - Demo: Add possibility to see the debug element in the demo page
+
+
+## v3.33.0 (2024-01-24)
+
+### Features
+
+  - Add `getLivePosition` RxPlayer method [#1300]
+  - Add `startAt.fromLivePosition` `loadVideo` option [#1300]
+  - Add the possibility to set a new `keySystems` option on the `reload` API [#1308]
+
+### Bug fixes
+
+  - Fix subtitles "blinking" in some specific conditions, especially with some DASH low-latency contents [#1314]
+  - DASH: Fix Period overlap resolution logic for when the first Period is removed [#1311]
+  - TTML: Fix handling of the `tts:lineHeight` attribute [#1320]
+  - Fix import of the `LOCAL_MANIFEST` experimental feature
+  - Avoid very rarely skipping segments which initially were too big to be pushed due to memory limitations [#1323]
+  - Fix issue arising when using track APIs at the exact last possible position of a Period with no consecutive Period [#1337]
+  - Starting at the end (through a `startAt` `loadVideo` option) or reloading at the end led to the restart of the content [#1338]
+  - DRM/Safari: also perform Safari DRM work-arounds when the page is launched from the dock [#1351, #1356]
+
+### Other improvements
+
+  - DASH: rely on SCTE214 `supplementalCodecs` instead of `codecs` if it's supported to better support backward compatible Dolby Vision contents [#1307]
+  - DASH: Provide better support of the `availabilityTimeOffset` attribute [#1300]
+  - DEBUG_ELEMENT: Add unsupported and undecipherable bitrates to the debug element [#1321]
+  - DEBUG_ELEMENT: update buffer graph maximum size so it becomes more readable for lengthy contents [#1316]
+  - DEBUG_ELEMENT: always synchronize inventory of segments before rendering it [#1317]
+  - Remove remaining RxPlayer dependency removing possibility of some application-side bundling errors [#1312]
+  - Add exception to text Garbage collection logic to avoid unnecessarily reload text segments frequently [#1325]
+  - Avoid logging too much the buffer's content when our debugging UI or the demo is used [#1341]
+  - Demo: Fix reporting of live position in demo page [#1313]
 
 
 ## v3.32.1 (2023-10-19)

package/CONTRIBUTING.md

@@ -47,6 +47,17 @@ the `features` object exported at `/src/features`. This is to reduce bundle size
 when an application doesn't need all of the RxPlayer's features.
 
 
+### Multithreading
+
+Some parts of the code are intented to be runnable in a WebWorker. In that
+environment some API, more specifically DOM-related API, are not available
+directly (if some interaction with the DOM is needed, it will have to go through
+an asynchronous `postMessage` round-trip).
+
+Whether the code needs to be runnable or not in a WebWorker is generally
+documented in the `README.md` of concerned directories.
+
+
 
 ## Code style
 

package/FILES.md

@@ -114,6 +114,14 @@ Defines a common `Manifest` class, regardless of the streaming technology (DASH,
 HSS...). This class is then used by the rest of the RxPlayer, to allow
 interaction with it without considering the underlying technology used.
 
+### `src/mse/`: MSE abstractions
+
+Abstraction over Media Source Extensions API, which are the browser API allowing
+to buffer media.
+
+This allows to provide a common API to the rest of the RxPlayer's code
+regardless of the environment (e.g. in a WebWorker without MSE API or in an
+environment with MSE API).
 
 ### `src/transports/`: Streaming protocols implementation
 
@@ -141,12 +149,6 @@ The parsed data being either:
   - image containers: BIF
 
 
-### `src/typings/`: Typescript typings
-
-This directory contains only declaration files for TypeScript. It is
-automatically added as a `typeRoots` when the TypeScript code is transpiled.
-
-
 ### `src/utils/`: Util functions
 
 This directory contains general helpers which are used in different parts of the

package/VERSION

@@ -1 +1 @@
-4.0.0-dev.2023121900
+4.0.0-rc.1

package/dist/_esm5.processed/compat/browser_detection.d.ts

@@ -39,4 +39,6 @@ declare let isWebOs2022: boolean;
 declare let isPanasonic: boolean;
 /** `true` for the PlayStation 5 game console. */
 declare let isPlayStation5: boolean;
-export { isEdgeChromium, isIE11, isIEOrEdge, isFirefox, isPanasonic, isPlayStation5, isSafariDesktop, isSafariMobile, isSamsungBrowser, isTizen, isWebOs, isWebOs2021, isWebOs2022, };
+/** `true` for the Xbox game consoles. */
+declare let isXbox: boolean;
+export { isEdgeChromium, isIE11, isIEOrEdge, isFirefox, isPanasonic, isPlayStation5, isXbox, isSafariDesktop, isSafariMobile, isSamsungBrowser, isTizen, isWebOs, isWebOs2021, isWebOs2022, };

package/dist/_esm5.processed/compat/browser_detection.js

@@ -40,8 +40,10 @@ var isWebOs2022 = false;
 var isPanasonic = false;
 /** `true` for the PlayStation 5 game console. */
 var isPlayStation5 = false;
+/** `true` for the Xbox game consoles. */
+var isXbox = false;
 ((function findCurrentBrowser() {
-    var _a, _b;
+    var _a, _b, _c;
     if (isNode) {
         return;
     }
@@ -66,9 +68,24 @@ var isPlayStation5 = false;
         /iPad|iPhone|iPod/.test(navigator.platform)) {
         isSafariMobile = true;
     }
-    else if (Object.prototype.toString.call(window.HTMLElement).indexOf("Constructor") >= 0 ||
+    else if (
+    // the following statement check if the window.safari contains the method
+    // "pushNotification", this condition is not met when using web app from the dock
+    // on macOS, this is why we also check userAgent.
+    Object.prototype.toString.call(window.HTMLElement).indexOf("Constructor") >= 0 ||
         ((_b = (_a = window.safari) === null || _a === void 0 ? void 0 : _a.pushNotification) === null || _b === void 0 ? void 0 : _b.toString()) ===
-            "[object SafariRemoteNotification]") {
+            "[object SafariRemoteNotification]" ||
+        // browsers are lying: Chrome reports both as Chrome and Safari in user
+        // agent string, So to detect Safari we have to check for the Safari string
+        // and the absence of the Chrome string
+        // eslint-disable-next-line max-len
+        // @see https://developer.mozilla.org/en-US/docs/Web/HTTP/Browser_detection_using_the_user_agent#which_part_of_the_user_agent_contains_the_information_you_are_looking_for
+        ((/Safari\/(\d+)/).test(navigator.userAgent) &&
+            // Safari should contain Version/ in userAgent
+            (/Version\/(\d+)/).test(navigator.userAgent) &&
+            (((_c = navigator.vendor) === null || _c === void 0 ? void 0 : _c.indexOf("Apple")) !== -1) &&
+            !(/Chrome\/(\d+)/).test(navigator.userAgent) &&
+            !(/Chromium\/(\d+)/).test(navigator.userAgent))) {
         isSafariDesktop = true;
     }
     // 2 - Find out specific device/platform information
@@ -99,5 +116,8 @@ var isPlayStation5 = false;
     else if (/[Pp]anasonic/.test(navigator.userAgent)) {
         isPanasonic = true;
     }
+    else if (navigator.userAgent.indexOf("Xbox") !== -1) {
+        isXbox = true;
+    }
 })());
-export { isEdgeChromium, isIE11, isIEOrEdge, isFirefox, isPanasonic, isPlayStation5, isSafariDesktop, isSafariMobile, isSamsungBrowser, isTizen, isWebOs, isWebOs2021, isWebOs2022, };
+export { isEdgeChromium, isIE11, isIEOrEdge, isFirefox, isPanasonic, isPlayStation5, isXbox, isSafariDesktop, isSafariMobile, isSamsungBrowser, isTizen, isWebOs, isWebOs2021, isWebOs2022, };

package/dist/_esm5.processed/compat/should_prevent_seeking_at_0_initially.d.ts

@@ -0,0 +1,14 @@
+/**
+ * We noticed that on Xbox game consoles and Universal windows platforms
+ * (presumably an Edge version is in cause here), the browser didn't send
+ * a "seeking" event if we were seeking at a 0 position initially.
+ *
+ * We could theoretically never seek at 0 initially as the initial position of
+ * an HTMLMediaElement should be at 0 anyway, but we still do it as a safe
+ * solution, as many devices have a buggy integration of HTML5 media API.
+ *
+ * This function returns `true` when we should avoid doing so, for now only for
+ * the non-standard behavior of those Edge platforms.
+ * @returns {number}
+ */
+export default function shouldPreventSeekingAt0Initially(): boolean;

package/dist/_esm5.processed/compat/should_prevent_seeking_at_0_initially.js

@@ -0,0 +1,17 @@
+import { isIEOrEdge, isXbox } from "./browser_detection";
+/**
+ * We noticed that on Xbox game consoles and Universal windows platforms
+ * (presumably an Edge version is in cause here), the browser didn't send
+ * a "seeking" event if we were seeking at a 0 position initially.
+ *
+ * We could theoretically never seek at 0 initially as the initial position of
+ * an HTMLMediaElement should be at 0 anyway, but we still do it as a safe
+ * solution, as many devices have a buggy integration of HTML5 media API.
+ *
+ * This function returns `true` when we should avoid doing so, for now only for
+ * the non-standard behavior of those Edge platforms.
+ * @returns {number}
+ */
+export default function shouldPreventSeekingAt0Initially() {
+    return isXbox || isIEOrEdge;
+}

package/dist/_esm5.processed/config.d.ts

@@ -39,6 +39,7 @@ declare class ConfigHandler {
         DEFAULT_MAX_BUFFER_BEHIND: number;
         DEFAULT_MAX_VIDEO_BUFFER_SIZE: number;
         MAXIMUM_MAX_BUFFER_AHEAD: Partial<Record<"audio" | "video" | "image" | "text", number>>;
+        MINIMUM_MAX_BUFFER_AHEAD: Partial<Record<"audio" | "video" | "image" | "text", number>>;
         MAXIMUM_MAX_BUFFER_BEHIND: Partial<Record<"audio" | "video" | "image" | "text", number>>;
         DEFAULT_INITIAL_BITRATES: {
             audio: number;

package/dist/_esm5.processed/core/api/option_utils.d.ts

@@ -24,6 +24,8 @@ export type IParsedStartAtOption = {
     percentage: number;
 } | {
     fromLastPosition: number;
+} | {
+    fromLivePosition: number;
 } | {
     fromFirstPosition: number;
 };
@@ -125,6 +127,8 @@ declare function checkReloadOptions(options?: {
         position?: number;
         relative?: number;
     };
+    keySystems?: IKeySystemOption[];
+    autoPlay?: boolean;
 }): void;
 /**
  * Parse options given to loadVideo and set default options as found

package/dist/_esm5.processed/core/api/option_utils.js

@@ -255,6 +255,12 @@ function checkReloadOptions(options) {
         ((_d = options === null || options === void 0 ? void 0 : options.reloadAt) === null || _d === void 0 ? void 0 : _d.relative) !== undefined) {
         throw new Error("API: reload - Invalid 'reloadAt.relative' option format.");
     }
+    if (!Array.isArray(options === null || options === void 0 ? void 0 : options.keySystems) && (options === null || options === void 0 ? void 0 : options.keySystems) !== undefined) {
+        throw new Error("API: reload - Invalid 'keySystems' option format.");
+    }
+    if ((options === null || options === void 0 ? void 0 : options.autoPlay) !== undefined && typeof options.autoPlay !== "boolean") {
+        throw new Error("API: reload - Invalid 'autoPlay' option format.");
+    }
 }
 /**
  * Parse options given to loadVideo and set default options as found
@@ -456,9 +462,8 @@ function parseLoadVideoOptions(options) {
             "an \"html\" textTrackMode. It will be ignored.");
     }
     if (!isNullOrUndefined(options.startAt)) {
-        // TODO Better way to express that in TypeScript?
-        if (options.startAt.wallClockTime
-            instanceof Date) {
+        if ("wallClockTime" in options.startAt
+            && options.startAt.wallClockTime instanceof Date) {
             var wallClockTime = options.startAt
                 .wallClockTime.getTime() / 1000;
             startAt = objectAssign({}, options.startAt, { wallClockTime: wallClockTime });

package/dist/_esm5.processed/core/api/public_api.d.ts

@@ -16,7 +16,7 @@
 import { IErrorCode, IErrorType } from "../../errors";
 import { IFeature } from "../../features";
 import Manifest from "../../manifest";
-import { IAdaptation, IAudioTrack, IAudioTrackPreference, IAvailableAudioTrack, IAvailableTextTrack, IAvailableVideoTrack, IBifThumbnail, IBitrateEstimate, IConstructorOptions, IDecipherabilityUpdateContent, IKeySystemConfigurationOutput, ILoadVideoOptions, IPeriod, IPlayerError, IPlayerState, IPositionUpdate, IRepresentation, IStreamEvent, ITextTrack, ITextTrackPreference, IVideoTrack, IVideoTrackPreference } from "../../public_types";
+import { IAdaptation, IAudioTrack, IAudioTrackPreference, IAvailableAudioTrack, IAvailableTextTrack, IAvailableVideoTrack, IBifThumbnail, IBitrateEstimate, IConstructorOptions, IDecipherabilityUpdateContent, IKeySystemConfigurationOutput, IKeySystemOption, ILoadVideoOptions, IPeriod, IPlayerError, IPlayerState, IPositionUpdate, IRepresentation, IStreamEvent, ITextTrack, ITextTrackPreference, IVideoTrack, IVideoTrackPreference } from "../../public_types";
 import EventEmitter, { IListener } from "../../utils/event_emitter";
 import Logger from "../../utils/logger";
 import { IBufferedChunk, IBufferType } from "../segment_buffers";
@@ -169,6 +169,7 @@ declare class Player extends EventEmitter<IPublicAPIEvent> {
             position?: number;
             relative?: number;
         };
+        keySystems?: IKeySystemOption[];
         autoPlay?: boolean;
     }): void;
     createDebugElement(element: HTMLElement): {
@@ -716,6 +717,15 @@ declare class Player extends EventEmitter<IPublicAPIEvent> {
      * @returns {number}
      */
     getMinimumPosition(): number | null;
+    /**
+     * Returns the current position for live contents.
+     *
+     * Returns `null` if no content is loaded or if the current loaded content is
+     * not considered as a live content.
+     * Returns `undefined` if that live position is currently unknown.
+     * @returns {number}
+     */
+    getLivePosition(): number | undefined | null;
     /**
      * Get maximum seek-able position.
      * @returns {number}