rx-player 4.0.0-dev.2023111400 → 4.0.0-dev.2023120600

package/dist/es2017/compat/is_codec_supported.js

@@ -14,6 +14,16 @@
  * limitations under the License.
  */
 import { MediaSource_ } from "./browser_compatibility_types";
+/**
+ * Setting this value limit the number of entries in the support map
+ * preventing important memory usage, value is arbitrary
+ */
+const MAX_SUPPORT_MAP_ENTRIES = 200;
+/**
+ * caching the codec support reduce the amount of call to `isTypeSupported`
+ * and help for performance especially on low-end devices.
+ */
+const supportMap = new Map();
 /**
  * Returns true if the given codec is supported by the browser's MediaSource
  * implementation.
@@ -30,7 +40,18 @@ export default function isCodecSupported(mimeType) {
     /* eslint-disable @typescript-eslint/unbound-method */
     if (typeof MediaSource_.isTypeSupported === "function") {
         /* eslint-enable @typescript-eslint/unbound-method */
-        return MediaSource_.isTypeSupported(mimeType);
+        const cachedSupport = supportMap.get(mimeType);
+        if (cachedSupport !== undefined) {
+            return cachedSupport;
+        }
+        else {
+            const isSupported = MediaSource_.isTypeSupported(mimeType);
+            if (supportMap.size >= MAX_SUPPORT_MAP_ENTRIES) {
+                supportMap.clear();
+            }
+            supportMap.set(mimeType, isSupported);
+            return isSupported;
+        }
     }
     return true;
 }

package/dist/es2017/config.d.ts

@@ -18,6 +18,7 @@ declare class ConfigHandler {
     _config: {
         DEFAULT_UNMUTED_VOLUME: number;
         DEFAULT_REQUEST_TIMEOUT: number;
+        DEFAULT_CONNECTION_TIMEOUT: number;
         DEFAULT_TEXT_TRACK_MODE: "native" | "html";
         DEFAULT_ENABLE_FAST_SWITCHING: boolean;
         DELTA_POSITION_AFTER_RELOAD: {

package/dist/es2017/core/api/debug/buffer_graph.js

@@ -1,4 +1,4 @@
-const BUFFER_WIDTH_IN_SECONDS = 10000;
+const BUFFER_WIDTH_IN_SECONDS = 30 * 60;
 const COLORS = [
     "#2ab7ca",
     "#fed766",
@@ -65,11 +65,7 @@ export default class SegmentBufferGraph {
         let minimumPosition;
         let maximumPosition;
         if (maximumPoint - minimumPoint > BUFFER_WIDTH_IN_SECONDS) {
-            if (currentTime === undefined) {
-                minimumPosition = minimumPoint;
-                maximumPosition = maximumPoint;
-            }
-            else if (maximumPoint - currentTime < BUFFER_WIDTH_IN_SECONDS / 2) {
+            if (maximumPoint - currentTime < BUFFER_WIDTH_IN_SECONDS / 2) {
                 maximumPosition = maximumPoint;
                 minimumPosition = maximumPoint - BUFFER_WIDTH_IN_SECONDS;
             }

package/dist/es2017/core/api/debug/modules/general_info.js

@@ -141,23 +141,30 @@ export default function constructDebugGeneralInfo(instance, parentElt, cancelSig
                 ]);
                 adaptationsElt.appendChild(textAdaps);
             }
-            const videoBitrates = (_c = (_b = instance.getVideoTrack()) === null || _b === void 0 ? void 0 : _b.representations.map(r => {
-                return r.bitrate;
-            }).filter(bitrate => bitrate !== undefined)) !== null && _c !== void 0 ? _c : [];
-            const audioBitrates = (_e = (_d = instance.getAudioTrack()) === null || _d === void 0 ? void 0 : _d.representations.map(r => {
-                return r.bitrate;
-            }).filter(bitrate => bitrate !== undefined)) !== null && _e !== void 0 ? _e : [];
+            const adaptations = instance.__priv_getCurrentAdaptation();
+            const videoBitratesStr = (_c = (_b = adaptations === null || adaptations === void 0 ? void 0 : adaptations.video) === null || _b === void 0 ? void 0 : _b.representations.map((r) => {
+                var _a;
+                return String((_a = r.bitrate) !== null && _a !== void 0 ? _a : "N/A") +
+                    (r.isSupported ? "" : " U!") +
+                    (r.decipherable !== false ? "" : " E!");
+            })) !== null && _c !== void 0 ? _c : [];
+            const audioBitratesStr = (_e = (_d = adaptations === null || adaptations === void 0 ? void 0 : adaptations.video) === null || _d === void 0 ? void 0 : _d.representations.map((r) => {
+                var _a;
+                return String((_a = r.bitrate) !== null && _a !== void 0 ? _a : "N/A") +
+                    (r.isSupported ? "" : " U!") +
+                    (r.decipherable !== false ? "" : " E!");
+            })) !== null && _e !== void 0 ? _e : [];
             representationsElt.innerHTML = "";
-            if (videoBitrates.length > 0) {
+            if (videoBitratesStr.length > 0) {
                 representationsElt.appendChild(createMetricTitle("vb"));
                 representationsElt.appendChild(createElement("span", {
-                    textContent: videoBitrates.join(" ") + " ",
+                    textContent: videoBitratesStr.join(" ") + " ",
                 }));
             }
-            if (audioBitrates.length > 0) {
+            if (audioBitratesStr.length > 0) {
                 representationsElt.appendChild(createMetricTitle("ab"));
                 representationsElt.appendChild(createElement("span", {
-                    textContent: audioBitrates.join(" ") + " ",
+                    textContent: audioBitratesStr.join(" ") + " ",
                 }));
             }
         }

package/dist/es2017/core/api/option_utils.d.ts

@@ -23,6 +23,8 @@ export type IParsedStartAtOption = {
     percentage: number;
 } | {
     fromLastPosition: number;
+} | {
+    fromLivePosition: number;
 } | {
     fromFirstPosition: number;
 };

package/dist/es2017/core/api/option_utils.js

@@ -259,9 +259,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) {
             const wallClockTime = options.startAt
                 .wallClockTime.getTime() / 1000;
             startAt = objectAssign({}, options.startAt, { wallClockTime });

package/dist/es2017/core/api/public_api.d.ts

@@ -557,6 +557,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}

package/dist/es2017/core/api/public_api.js

@@ -91,7 +91,7 @@ class Player extends EventEmitter {
         // Workaround to support Firefox autoplay on FF 42.
         // See: https://bugzilla.mozilla.org/show_bug.cgi?id=1194624
         videoElement.preload = "auto";
-        this.version = /* PLAYER_VERSION */ "4.0.0-dev.2023111400";
+        this.version = /* PLAYER_VERSION */ "4.0.0-dev.2023120600";
         this.log = log;
         this.state = "STOPPED";
         this.videoElement = videoElement;
@@ -250,7 +250,7 @@ class Player extends EventEmitter {
      * @param {Object} options
      */
     _priv_initializeContentPlayback(options) {
-        var _a, _b, _c, _d;
+        var _a, _b, _c, _d, _e, _f;
         const { autoPlay, defaultAudioTrackSwitchingMode, enableFastSwitching, initialManifest, keySystems, lowLatencyMode, minimumManifestUpdateInterval, requestConfig, onCodecSwitch, startAt, transport, checkMediaSegmentIntegrity, manifestLoader, referenceDateTime, representationFilter, segmentLoader, serverSyncInfos, __priv_manifestUpdateUrl, __priv_patchLastSegmentInSidx, url } = options;
         // Perform multiple checks on the given options
         if (this.videoElement === null) {
@@ -286,6 +286,7 @@ class Player extends EventEmitter {
             const manifestRequestSettings = { lowLatencyMode,
                 maxRetry: (_a = requestConfig.manifest) === null || _a === void 0 ? void 0 : _a.maxRetry,
                 requestTimeout: (_b = requestConfig.manifest) === null || _b === void 0 ? void 0 : _b.timeout,
+                connectionTimeout: (_c = requestConfig.manifest) === null || _c === void 0 ? void 0 : _c.connectionTimeout,
                 minimumManifestUpdateInterval,
                 initialManifest };
             const relyOnVideoVisibilityAndSize = canRelyOnVideoVisibilityAndSize();
@@ -332,8 +333,9 @@ class Player extends EventEmitter {
             const bufferOptions = objectAssign({ enableFastSwitching,
                 onCodecSwitch }, this._priv_bufferOptions);
             const segmentRequestOptions = { lowLatencyMode,
-                maxRetry: (_c = requestConfig.segment) === null || _c === void 0 ? void 0 : _c.maxRetry,
-                requestTimeout: (_d = requestConfig.segment) === null || _d === void 0 ? void 0 : _d.timeout };
+                maxRetry: (_d = requestConfig.segment) === null || _d === void 0 ? void 0 : _d.maxRetry,
+                requestTimeout: (_e = requestConfig.segment) === null || _e === void 0 ? void 0 : _e.timeout,
+                connectionTimeout: (_f = requestConfig.segment) === null || _f === void 0 ? void 0 : _f.connectionTimeout };
             initializer = new features.mediaSourceInit({
                 adaptiveOptions,
                 autoPlay,
@@ -1462,6 +1464,27 @@ class Player extends EventEmitter {
         }
         return 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() {
+        if (this._priv_contentInfos === null) {
+            return null;
+        }
+        const { isDirectFile, manifest } = this._priv_contentInfos;
+        if (isDirectFile) {
+            return undefined;
+        }
+        if ((manifest === null || manifest === void 0 ? void 0 : manifest.isLive) !== true) {
+            return null;
+        }
+        return manifest.getLivePosition();
+    }
     /**
      * Get maximum seek-able position.
      * @returns {number}
@@ -1506,9 +1529,11 @@ class Player extends EventEmitter {
         }
         const segmentBufferStatus = this._priv_contentInfos
             .segmentBuffersStore.getStatus(bufferType);
-        return segmentBufferStatus.type === "initialized" ?
-            segmentBufferStatus.value.getInventory() :
-            null;
+        if (segmentBufferStatus.type === "initialized") {
+            segmentBufferStatus.value.synchronizeInventory();
+            return segmentBufferStatus.value.getInventory();
+        }
+        return null;
     }
     /**
      * /!\ For tools use only! Do not touch!
@@ -2107,5 +2132,5 @@ class Player extends EventEmitter {
         }
     }
 }
-Player.version = /* PLAYER_VERSION */ "4.0.0-dev.2023111400";
+Player.version = /* PLAYER_VERSION */ "4.0.0-dev.2023120600";
 export default Player;

package/dist/es2017/core/fetchers/manifest/manifest_fetcher.d.ts

@@ -171,6 +171,12 @@ export interface IManifestFetcherSettings {
      * `undefined` will lead to a default, large, timeout being used.
      */
     requestTimeout: number | undefined;
+    /**
+     * Connection timeout, in milliseconds, after which the request is canceled
+     * if the responses headers has not being received.
+     * Do not set or set to "undefined" to disable it.
+     */
+    connectionTimeout: number | undefined;
     /** Limit the frequency of Manifest updates. */
     minimumManifestUpdateInterval: number;
     /**

package/dist/es2017/core/fetchers/manifest/manifest_fetcher.js

@@ -18,7 +18,6 @@ import { formatError } from "../../../errors";
 import log from "../../../log";
 import Manifest from "../../../manifest";
 import EventEmitter from "../../../utils/event_emitter";
-import isNullOrUndefined from "../../../utils/is_null_or_undefined";
 import getMonotonicTimeStamp from "../../../utils/monotonic_timestamp";
 import noop from "../../../utils/noop";
 import TaskCanceller from "../../../utils/task_canceller";
@@ -157,13 +156,22 @@ export default class ManifestFetcher extends EventEmitter {
          */
         function callLoaderWithRetries(manifestUrl) {
             const { loadManifest } = pipelines;
-            let requestTimeout = isNullOrUndefined(settings.requestTimeout) ?
+            let requestTimeout = (settings.requestTimeout === undefined) ?
                 config.getCurrent().DEFAULT_REQUEST_TIMEOUT :
                 settings.requestTimeout;
+            let connectionTimeout = (settings.connectionTimeout === undefined) ?
+                config.getCurrent().DEFAULT_CONNECTION_TIMEOUT :
+                settings.connectionTimeout;
             if (requestTimeout < 0) {
                 requestTimeout = undefined;
             }
-            const callLoader = () => loadManifest(manifestUrl, { timeout: requestTimeout }, cancelSignal);
+            if (connectionTimeout < 0) {
+                connectionTimeout = undefined;
+            }
+            const callLoader = () => loadManifest(manifestUrl, {
+                timeout: requestTimeout,
+                connectionTimeout,
+            }, cancelSignal);
             return scheduleRequestPromise(callLoader, backoffSettings, cancelSignal);
         }
     }

package/dist/es2017/core/fetchers/segment/segment_fetcher.d.ts

@@ -135,14 +135,21 @@ export interface ISegmentFetcherOptions {
      * To set to `-1` for no timeout.
      */
     requestTimeout: number;
+    /**
+     * Connection timeout, in milliseconds, after which the request is canceled
+     * if the responses headers has not being received.
+     * Do not set or set to "undefined" to disable it.
+     */
+    connectionTimeout: number | undefined;
 }
 /**
  * @param {string} bufferType
  * @param {Object}
  * @returns {Object}
  */
-export declare function getSegmentFetcherOptions({ maxRetry, lowLatencyMode, requestTimeout }: {
+export declare function getSegmentFetcherOptions({ maxRetry, lowLatencyMode, requestTimeout, connectionTimeout }: {
     maxRetry?: number | undefined;
     requestTimeout?: number | undefined;
+    connectionTimeout?: number | undefined;
     lowLatencyMode: boolean;
 }): ISegmentFetcherOptions;

package/dist/es2017/core/fetchers/segment/segment_fetcher.js

@@ -56,6 +56,8 @@ export default function createSegmentFetcher(bufferType, pipeline, cdnPrioritize
     const requestOptions = {
         timeout: options.requestTimeout < 0 ? undefined :
             options.requestTimeout,
+        connectionTimeout: options.connectionTimeout === undefined ? undefined :
+            options.connectionTimeout < 0 ? undefined : options.connectionTimeout,
     };
     /**
      * Cache audio and video initialization segments.
@@ -283,13 +285,15 @@ export default function createSegmentFetcher(bufferType, pipeline, cdnPrioritize
  * @param {Object}
  * @returns {Object}
  */
-export function getSegmentFetcherOptions({ maxRetry, lowLatencyMode, requestTimeout }) {
-    const { DEFAULT_MAX_REQUESTS_RETRY_ON_ERROR, DEFAULT_REQUEST_TIMEOUT, INITIAL_BACKOFF_DELAY_BASE, MAX_BACKOFF_DELAY_BASE } = config.getCurrent();
+export function getSegmentFetcherOptions({ maxRetry, lowLatencyMode, requestTimeout, connectionTimeout }) {
+    const { DEFAULT_MAX_REQUESTS_RETRY_ON_ERROR, DEFAULT_REQUEST_TIMEOUT, DEFAULT_CONNECTION_TIMEOUT, INITIAL_BACKOFF_DELAY_BASE, MAX_BACKOFF_DELAY_BASE } = config.getCurrent();
     return { maxRetry: maxRetry !== null && maxRetry !== void 0 ? maxRetry : DEFAULT_MAX_REQUESTS_RETRY_ON_ERROR,
         baseDelay: lowLatencyMode ? INITIAL_BACKOFF_DELAY_BASE.LOW_LATENCY :
             INITIAL_BACKOFF_DELAY_BASE.REGULAR,
         maxDelay: lowLatencyMode ? MAX_BACKOFF_DELAY_BASE.LOW_LATENCY :
             MAX_BACKOFF_DELAY_BASE.REGULAR,
-        requestTimeout: isNullOrUndefined(requestTimeout) ? DEFAULT_REQUEST_TIMEOUT :
-            requestTimeout };
+        requestTimeout: (requestTimeout === undefined) ? DEFAULT_REQUEST_TIMEOUT :
+            requestTimeout,
+        connectionTimeout: (connectionTimeout === undefined) ?
+            DEFAULT_CONNECTION_TIMEOUT : connectionTimeout, };
 }

package/dist/es2017/core/fetchers/segment/segment_fetcher_creator.d.ts

@@ -74,4 +74,5 @@ export interface ISegmentFetcherCreatorBackoffOptions {
      * `undefined` will lead to a default, large, timeout being used.
      */
     requestTimeout: number | undefined;
+    connectionTimeout: number | undefined;
 }

package/dist/es2017/core/fetchers/utils/schedule_request.js

@@ -287,7 +287,7 @@ export async function scheduleRequestWithCdns(cdns, cdnPrioritizer, performReque
      * attempts already done for that resource.
      *
      * Returns `undefined` if there's no Cdn left to request the resource.
-     * @param {Array.<Object>}
+     * @param {Array.<Object>} sortedCdns
      * @returns {Object|undefined}
      */
     function getPrioritaryRequestableCdnFromSortedList(sortedCdns) {

package/dist/es2017/core/init/directfile_content_initializer.js

@@ -20,6 +20,7 @@
 import { clearElementSrc } from "../../compat";
 import log from "../../log";
 import assert from "../../utils/assert";
+import isNullOrUndefined from "../../utils/is_null_or_undefined";
 import SharedReference from "../../utils/reference";
 import TaskCanceller from "../../utils/task_canceller";
 import { ContentInitializer } from "./types";
@@ -174,10 +175,10 @@ export default class DirectFileContentInitializer extends ContentInitializer {
  * @returns {number}
  */
 function getDirectFileInitialTime(mediaElement, startAt) {
-    if (startAt == null) {
+    if (isNullOrUndefined(startAt)) {
         return 0;
     }
-    if (startAt.position != null) {
+    if (!isNullOrUndefined(startAt.position)) {
         return startAt.position;
     }
     else if (startAt.wallClockTime != null) {
@@ -187,15 +188,31 @@ function getDirectFileInitialTime(mediaElement, startAt) {
         return startAt.fromFirstPosition;
     }
     const duration = mediaElement.duration;
-    if (duration == null || !isFinite(duration)) {
-        log.warn("startAt.fromLastPosition set but no known duration, " +
-            "beginning at 0.");
-        return 0;
-    }
     if (typeof startAt.fromLastPosition === "number") {
+        if (isNullOrUndefined(duration) || !isFinite(duration)) {
+            log.warn("startAt.fromLastPosition set but no known duration, " +
+                "beginning at 0.");
+            return 0;
+        }
         return Math.max(0, duration + startAt.fromLastPosition);
     }
+    else if (typeof startAt.fromLivePosition === "number") {
+        const livePosition = mediaElement.seekable.length > 0 ?
+            mediaElement.seekable.end(0) :
+            duration;
+        if (isNullOrUndefined(livePosition)) {
+            log.warn("startAt.fromLivePosition set but no known live position, " +
+                "beginning at 0.");
+            return 0;
+        }
+        return Math.max(0, livePosition + startAt.fromLivePosition);
+    }
     else if (startAt.percentage != null) {
+        if (isNullOrUndefined(duration) || !isFinite(duration)) {
+            log.warn("startAt.percentage set but no known duration, " +
+                "beginning at 0.");
+            return 0;
+        }
         const { percentage } = startAt;
         if (percentage >= 100) {
             return duration;

package/dist/es2017/core/init/media_source_content_initializer.d.ts

@@ -160,6 +160,12 @@ export interface IInitializeArguments {
          * `-1` indicates no timeout.
          */
         requestTimeout: number | undefined;
+        /**
+         * Amount of time, in milliseconds, after which a request that hasn't receive
+         * the headers and status code should be aborted and optionnaly retried,
+         * depending on the maxRetry configuration.
+         */
+        connectionTimeout: number | undefined;
         /** Maximum number of time a request on error will be retried. */
         maxRetry: number | undefined;
     };

package/dist/es2017/core/init/media_source_content_initializer.js

@@ -359,7 +359,7 @@ export default class MediaSourceContentInitializer extends ContentInitializer {
                         if (
                         // Data is buffered around the current position
                         obs.currentRange !== null ||
-                            // Or, for whatever reason, playback is already advancing
+                            // Or, for whatever reason, we have no buffer but we're already advancing
                             obs.position > seekedTime + 0.1) {
                             stopListening();
                             playbackObserver.setCurrentTime(obs.position + 0.001);
@@ -512,9 +512,7 @@ export default class MediaSourceContentInitializer extends ContentInitializer {
         contentTimeBoundariesObserver.addEventListener("periodChange", (period) => {
             this.trigger("activePeriodChanged", { period });
         });
-        contentTimeBoundariesObserver.addEventListener("durationUpdate", (newDuration) => {
-            mediaSourceDurationUpdater.updateDuration(newDuration.duration, newDuration.isEnd);
-        });
+        contentTimeBoundariesObserver.addEventListener("endingPositionChange", (x) => mediaSourceDurationUpdater.updateDuration(x.endingPosition, x.isEnd));
         contentTimeBoundariesObserver.addEventListener("endOfStream", () => {
             if (endOfStreamCanceller === null) {
                 endOfStreamCanceller = new TaskCanceller();
@@ -530,8 +528,8 @@ export default class MediaSourceContentInitializer extends ContentInitializer {
                 endOfStreamCanceller = null;
             }
         });
-        const currentDuration = contentTimeBoundariesObserver.getCurrentDuration();
-        mediaSourceDurationUpdater.updateDuration(currentDuration.duration, currentDuration.isEnd);
+        const endInfo = contentTimeBoundariesObserver.getCurrentEndingTime();
+        mediaSourceDurationUpdater.updateDuration(endInfo.endingPosition, endInfo.isEnd);
         return contentTimeBoundariesObserver;
     }
     /**

package/dist/es2017/core/init/utils/content_time_boundaries_observer.d.ts

@@ -22,8 +22,8 @@ import { IStreamOrchestratorPlaybackObservation } from "../../stream";
 /**
  * Observes what's being played and take care of media events relating to time
  * boundaries:
- *   - Emits a `durationUpdate` when the duration of the current content is
- *     known and every time it changes.
+ *   - Emits a `endingPositionChange` when the known maximum playable position
+ *     of the current content is known and every time it changes.
  *   - Emits `endOfStream` API once segments have been pushed until the end and
  *     `resumeStream` if downloads starts back.
  *   - Emits a `periodChange` event when the currently-playing Period seemed to
@@ -56,10 +56,11 @@ export default class ContentTimeBoundariesObserver extends EventEmitter<IContent
      */
     constructor(manifest: Manifest, playbackObserver: IReadOnlyPlaybackObserver<IStreamOrchestratorPlaybackObservation>, bufferTypes: IBufferType[]);
     /**
-     * Returns an estimate of the current duration of the content.
+     * Returns an estimate of the current last position which may be played in
+     * the content at the moment.
      * @returns {Object}
      */
-    getCurrentDuration(): IDurationItem;
+    getCurrentEndingTime(): IEndingPositionInformation;
     /**
      * Method to call any time an Adaptation has been selected.
      *
@@ -126,20 +127,20 @@ export default class ContentTimeBoundariesObserver extends EventEmitter<IContent
     private _addActivelyLoadedPeriod;
     private _removeActivelyLoadedPeriod;
     private _checkCurrentPeriod;
-    private _getManifestDuration;
+    private _getManifestEndTime;
     private _lazilyCreateActiveStreamInfo;
     private _checkEndOfStream;
 }
-export interface IDurationItem {
+export interface IEndingPositionInformation {
     /**
      * The new maximum known position (note that this is the ending position
      * currently known of the current content, it might be superior to the last
      * position at which segments are available and it might also evolve over
      * time), in seconds.
      */
-    duration: number;
+    endingPosition: number;
     /**
-     * If `true`, the communicated `duration` is the actual end of the content.
+     * If `true`, the communicated `endingPosition` is the actual end of the content.
      * It may still be updated due to a track change or to add precision, but it
      * is still a (rough) estimate of the maximum position that content should
      * have.
@@ -147,7 +148,7 @@ export interface IDurationItem {
      * If `false`, this is the currently known maximum position associated to
      * the content, but the content is still evolving (typically, new media
      * segments are still being generated) and as such it can still have a
-     * longer duration in the future.
+     * longer `endingPosition` in the future.
      */
     isEnd: boolean;
 }
@@ -161,10 +162,10 @@ export interface IContentTimeBoundariesObserverEvent {
     /** Triggered when a new `Period` is currently playing. */
     periodChange: Period;
     /**
-     * Triggered when the duration of the currently-playing content became known
-     * or changed.
+     * Triggered when the ending position of the currently-playing content became
+     * known or changed.
      */
-    durationUpdate: IDurationItem;
+    endingPositionChange: IEndingPositionInformation;
     /**
      * Triggered when the last possible chronological segment for all types of
      * buffers has either been pushed or is being pushed to the corresponding

package/dist/es2017/core/init/utils/content_time_boundaries_observer.js

@@ -21,8 +21,8 @@ import TaskCanceller from "../../../utils/task_canceller";
 /**
  * Observes what's being played and take care of media events relating to time
  * boundaries:
- *   - Emits a `durationUpdate` when the duration of the current content is
- *     known and every time it changes.
+ *   - Emits a `endingPositionChange` when the known maximum playable position
+ *     of the current content is known and every time it changes.
  *   - Emits `endOfStream` API once segments have been pushed until the end and
  *     `resumeStream` if downloads starts back.
  *   - Emits a `periodChange` event when the currently-playing Period seemed to
@@ -65,7 +65,7 @@ export default class ContentTimeBoundariesObserver extends EventEmitter {
             }
         }, { includeLastObservation: true, clearSignal: cancelSignal });
         manifest.addEventListener("manifestUpdate", () => {
-            this.trigger("durationUpdate", this._getManifestDuration());
+            this.trigger("endingPositionChange", this._getManifestEndTime());
             if (cancelSignal.isCancelled()) {
                 return;
             }
@@ -73,11 +73,12 @@ export default class ContentTimeBoundariesObserver extends EventEmitter {
         }, cancelSignal);
     }
     /**
-     * Returns an estimate of the current duration of the content.
+     * Returns an estimate of the current last position which may be played in
+     * the content at the moment.
      * @returns {Object}
      */
-    getCurrentDuration() {
-        return this._getManifestDuration();
+    getCurrentEndingTime() {
+        return this._getManifestEndTime();
     }
     /**
      * Method to call any time an Adaptation has been selected.
@@ -106,12 +107,13 @@ export default class ContentTimeBoundariesObserver extends EventEmitter {
                             .updateLastVideoAdaptation(adaptation);
                     }
                     const endingPosition = this._maximumPositionCalculator.getEndingPosition();
-                    const newDuration = endingPosition !== undefined ?
+                    const newEndingPosition = endingPosition !== undefined ?
                         { isEnd: true,
-                            duration: endingPosition } :
+                            endingPosition } :
                         { isEnd: false,
-                            duration: this._maximumPositionCalculator.getMaximumAvailablePosition() };
-                    this.trigger("durationUpdate", newDuration);
+                            endingPosition: this._maximumPositionCalculator
+                                .getMaximumAvailablePosition() };
+                    this.trigger("endingPositionChange", newEndingPosition);
                 }
             }
         }
@@ -238,13 +240,13 @@ export default class ContentTimeBoundariesObserver extends EventEmitter {
             }
         }
     }
-    _getManifestDuration() {
+    _getManifestEndTime() {
         const endingPosition = this._maximumPositionCalculator.getEndingPosition();
         return endingPosition !== undefined ?
             { isEnd: true,
-                duration: endingPosition } :
+                endingPosition } :
             { isEnd: false,
-                duration: this._maximumPositionCalculator.getMaximumAvailablePosition() };
+                endingPosition: this._maximumPositionCalculator.getMaximumAvailablePosition() };
     }
     _lazilyCreateActiveStreamInfo(bufferType) {
         let streamInfo = this._activeStreams.get(bufferType);
@@ -315,9 +317,8 @@ class MaximumPositionCalculator {
      * @returns {number}
      */
     getMaximumAvailablePosition() {
-        var _a;
         if (this._manifest.isDynamic) {
-            return (_a = this._manifest.getLivePosition()) !== null && _a !== void 0 ? _a : this._manifest.getMaximumSafePosition();
+            return this._manifest.getMaximumSafePosition();
         }
         if (this._lastVideoAdaptation === undefined ||
             this._lastAudioAdaptation === undefined) {

package/dist/es2017/core/init/utils/get_initial_time.d.ts

@@ -37,11 +37,25 @@ export interface IInitialTimeOptions {
      */
     fromFirstPosition?: number | null | undefined;
     /**
-     * If set, we should begin at this position relative to the content's end,
-     * in seconds.
+     * If set, we should begin at this position relative to the content's maximum
+     * seekable position, in seconds.
+     *
+     * It should consequently in most cases be a negative value.
      */
     fromLastPosition?: number | null | undefined;
-    /** If set, we should begin at this position relative to the whole duration of
+    /**
+     * If set, we should begin at this position relative to the content's live
+     * edge if it makes sense, in seconds.
+     *
+     * It should consequently in most cases be a negative value.
+     *
+     * If the live edge is unknown or if it does not make sense for the current
+     * content, that position is relative to the content's maximum position
+     * instead.
+     */
+    fromLivePosition?: number | null | undefined;
+    /**
+     * If set, we should begin at this position relative to the whole duration of
      * the content, in percentage.
      */
     percentage?: number | null | undefined;