rx-player 4.0.0-beta.1 → 4.0.0-beta.2

package/dist/_esm5.processed/manifest/period.js

@@ -42,7 +42,7 @@ var Period = /** @class */ (function () {
                 .map(function (adaptation) {
                 var newAdaptation = new Adaptation(adaptation, { representationFilter: representationFilter });
                 if (newAdaptation.representations.length > 0 && !newAdaptation.isSupported) {
-                    var error = new MediaError("MANIFEST_INCOMPATIBLE_CODECS_ERROR", "An Adaptation contains only incompatible codecs.");
+                    var error = new MediaError("MANIFEST_INCOMPATIBLE_CODECS_ERROR", "An Adaptation contains only incompatible codecs.", { adaptation: newAdaptation });
                     _this.contentWarnings.push(error);
                 }
                 return newAdaptation;
@@ -53,7 +53,7 @@ var Period = /** @class */ (function () {
             if (filteredAdaptations.every(function (adaptation) { return !adaptation.isSupported; }) &&
                 adaptationsForType.length > 0 &&
                 (type === "video" || type === "audio")) {
-                throw new MediaError("MANIFEST_INCOMPATIBLE_CODECS_ERROR", "No supported " + type + " adaptations");
+                throw new MediaError("MANIFEST_INCOMPATIBLE_CODECS_ERROR", "No supported " + type + " adaptations", { adaptation: undefined });
             }
             if (filteredAdaptations.length > 0) {
                 acc[type] = filteredAdaptations;

package/dist/_esm5.processed/manifest/representation.d.ts

@@ -14,15 +14,36 @@
  * limitations under the License.
  */
 import { ICdnMetadata, IContentProtections, IParsedRepresentation } from "../parsers/manifest";
-import { ITrackType, IHDRInformation } from "../public_types";
+import { IAudioRepresentation, ITrackType, IHDRInformation, IVideoRepresentation } from "../public_types";
 import { IRepresentationIndex } from "./representation_index";
 /**
  * Normalized Representation structure.
  * @class Representation
  */
 declare class Representation {
-    /** ID uniquely identifying the Representation in the Adaptation. */
+    /**
+     * ID uniquely identifying the `Representation` in its parent `Adaptation`.
+     *
+     * This identifier might be linked to an identifier present in the original
+     * Manifest file, it is thus the identifier to use to determine if a
+     * `Representation` from a refreshed `Manifest` is actually the same one than
+     * one in the previously loaded Manifest (as long as the `Adaptation` and
+     * `Period` are also the same).
+     *
+     * For a globally unique identifier regardless of the `Adaptation`, `Period`
+     * or even `Manifest`, you can rely on `uniqueId` instead.
+     */
     readonly id: string;
+    /**
+     * Globally unique identifier for this `Representation` object.
+     *
+     * This identifier is guaranteed to be unique for any `Representation`s of all
+     * `Manifest` objects created in the current JS Realm.
+     * As such, it can be used as an identifier for the JS object itself, whereas
+     * `id` is the identifier for the original Manifest's Representation in the
+     * scope of its parent `Adaptation`.
+     */
+    readonly uniqueId: string;
     /**
      * Interface allowing to get information about segments available for this
      * Representation.
@@ -165,6 +186,16 @@ declare class Representation {
         systemId: string;
         data: Uint8Array;
     }>): boolean;
+    /**
+     * Format Representation as an `IAudioRepresentation`.
+     * @returns {Object}
+     */
+    toAudioRepresentation(): IAudioRepresentation;
+    /**
+     * Format Representation as an `IVideoRepresentation`.
+     * @returns {Object}
+     */
+    toVideoRepresentation(): IVideoRepresentation;
     /**
      * Returns `true` if this Representation can be played (that is: not
      * undecipherable and with a supported codec).

package/dist/_esm5.processed/manifest/representation.js

@@ -16,6 +16,8 @@
 import { isCodecSupported } from "../compat";
 import log from "../log";
 import areArraysOfNumbersEqual from "../utils/are_arrays_of_numbers_equal";
+import idGenerator from "../utils/id_generator";
+var generateRepresentationUniqueId = idGenerator();
 /**
  * Normalized Representation structure.
  * @class Representation
@@ -26,6 +28,7 @@ var Representation = /** @class */ (function () {
      */
     function Representation(args, opts) {
         this.id = args.id;
+        this.uniqueId = generateRepresentationUniqueId();
         this.bitrate = args.bitrate;
         this.codec = args.codecs;
         if (args.height !== undefined) {
@@ -225,6 +228,24 @@ var Representation = /** @class */ (function () {
             values: data });
         return true;
     };
+    /**
+     * Format Representation as an `IAudioRepresentation`.
+     * @returns {Object}
+     */
+    Representation.prototype.toAudioRepresentation = function () {
+        var _a = this, id = _a.id, bitrate = _a.bitrate, codec = _a.codec, isSupported = _a.isSupported, decipherable = _a.decipherable;
+        return { id: id, bitrate: bitrate, codec: codec, isCodecSupported: isSupported,
+            seemsDecipherable: decipherable };
+    };
+    /**
+     * Format Representation as an `IVideoRepresentation`.
+     * @returns {Object}
+     */
+    Representation.prototype.toVideoRepresentation = function () {
+        var _a = this, id = _a.id, bitrate = _a.bitrate, frameRate = _a.frameRate, width = _a.width, height = _a.height, codec = _a.codec, hdrInfo = _a.hdrInfo, isSupported = _a.isSupported, decipherable = _a.decipherable;
+        return { id: id, bitrate: bitrate, frameRate: frameRate, width: width, height: height, codec: codec, hdrInfo: hdrInfo, isCodecSupported: isSupported,
+            seemsDecipherable: decipherable };
+    };
     /**
      * Returns `true` if this Representation can be played (that is: not
      * undecipherable and with a supported codec).

package/dist/_esm5.processed/manifest/utils.js

@@ -22,9 +22,7 @@ import isNullOrUndefined from "../utils/is_null_or_undefined";
  */
 export function areSameContent(content1, content2) {
     return (content1.segment.id === content2.segment.id &&
-        content1.representation.id === content2.representation.id &&
-        content1.adaptation.id === content2.adaptation.id &&
-        content1.period.id === content2.period.id);
+        content1.representation.uniqueId === content2.representation.uniqueId);
 }
 /**
  * Get string describing a given ISegment, useful for log functions.

package/dist/_esm5.processed/parsers/manifest/dash/js-parser/parse_from_document.d.ts

@@ -17,7 +17,7 @@ import { IMPDParserArguments } from "../common";
 import { IDashParserResponse } from "../parsers_types";
 /**
  * Parse MPD through the JS parser, on a `Document` instance.
- * @param {Document} manifest - Original manifest as returned by the server
+ * @param {Document} document - Original manifest as returned by the server
  * @param {Object} args - Various parsing options and information.
  * @returns {Object} - Response returned by the DASH-JS parser.
  */

package/dist/_esm5.processed/parsers/manifest/dash/js-parser/parse_from_document.js

@@ -20,7 +20,7 @@ import { createMPDIntermediateRepresentation, } from "./node_parsers/MPD";
 import { createPeriodIntermediateRepresentation, } from "./node_parsers/Period";
 /**
  * Parse MPD through the JS parser, on a `Document` instance.
- * @param {Document} manifest - Original manifest as returned by the server
+ * @param {Document} document - Original manifest as returned by the server
  * @param {Object} args - Various parsing options and information.
  * @returns {Object} - Response returned by the DASH-JS parser.
  */

package/dist/_esm5.processed/parsers/manifest/dash/wasm-parser/ts/dash-wasm-parser.js

@@ -230,6 +230,7 @@ var DashWasmParser = /** @class */ (function () {
                         "Unknown error";
                     log.warn("DW: Could not create DASH-WASM parser:", message);
                     _this.status = "failure";
+                    throw err;
                 });
                 return [2 /*return*/, this._initProm];
             });

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

@@ -14,10 +14,11 @@
  * limitations under the License.
  */
 import { IPersistentSessionInfoV0, IPersistentSessionInfoV1, IPersistentSessionInfoV2, IPersistentSessionInfoV3, IPersistentSessionInfoV4 } from "./core/decrypt";
-import { EncryptedMediaError, MediaError, NetworkError, OtherError } from "./errors";
+import { IMediaErrorTrackContext, EncryptedMediaError, MediaError, NetworkError, OtherError } from "./errors";
 import Manifest from "./manifest";
 import { ILocalManifest } from "./parsers/manifest/local";
 import { IMetaPlaylist } from "./parsers/manifest/metaplaylist/metaplaylist_parser";
+export { IMediaErrorTrackContext };
 /**
  * This file defines and exports types we want to expose to library users.
  * Those types are considered as part of the API.
@@ -584,6 +585,8 @@ export interface IAudioRepresentation {
     id: string | number;
     bitrate?: number | undefined;
     codec?: string | undefined;
+    isCodecSupported?: boolean | undefined;
+    seemsDecipherable?: boolean | undefined;
 }
 /** Audio track returned by the RxPlayer. */
 export interface IAudioTrack {
@@ -609,7 +612,7 @@ export interface ITextTrack {
      * Kept equal to `language` if the attempt failed.
      */
     normalized: string;
-    forced?: boolean | undefined;
+    forced: boolean | undefined;
     closedCaption: boolean;
     label?: string | undefined;
     id: number | string;
@@ -626,6 +629,8 @@ export interface IVideoRepresentation {
     codec?: string | undefined;
     frameRate?: number | undefined;
     hdrInfo?: IHDRInformation | undefined;
+    isCodecSupported?: boolean | undefined;
+    seemsDecipherable?: boolean | undefined;
 }
 /** Video track returned by the RxPlayer. */
 export interface IVideoTrack {
@@ -786,8 +791,14 @@ export interface ITrackUpdateEventPayload {
     "manual" | // Manually and explicitely updated
     "trickmode-enabled" | // Video trickmode tracks being enabled
     "trickmode-disabled" | // Video trickmode tracks being disabled
+    "no-playable-representation" | // Previous track had no playable Representation
     string;
 }
+export interface IRepresentationListUpdateContext {
+    period: IPeriod;
+    trackType: ITrackType;
+    reason: "decipherability-update" | string;
+}
 export interface ILockedVideoRepresentationsSettings {
     representations: string[];
     periodId?: string | undefined;
@@ -814,4 +825,3 @@ export interface ITextTrackSetting {
     trackId: string;
     periodId?: string | undefined;
 }
-export {};

package/dist/_esm5.processed/tools/TextTrackRenderer/text_track_renderer.js

@@ -52,7 +52,7 @@ var TextTrackRenderer = /** @class */ (function () {
             args.timeOffset :
             0;
         this._segmentBuffer.pushChunkSync({ inventoryInfos: null,
-            data: { initSegment: null,
+            data: { initSegmentUniqueId: null,
                 codec: args.type, timestampOffset: timestampOffset, appendWindow: [0, Infinity],
                 chunk: { start: 0,
                     end: Number.MAX_VALUE,

package/dist/_esm5.processed/transports/smooth/isobmff/create_boxes.d.ts

@@ -18,7 +18,7 @@
  * @param {Number} height
  * @param {Number} hRes - horizontal resolution, eg 72
  * @param {Number} vRes - vertical resolution, eg 72
- * @param {string} encDepth
+ * @param {string} encName
  * @param {Number} colorDepth - eg 24
  * @param {Uint8Array} avcc - Uint8Array representing the avcC atom
  * @returns {Uint8Array}
@@ -29,7 +29,7 @@ declare function createAVC1Box(width: number, height: number, hRes: number, vRes
  * @param {Number} height
  * @param {Number} hRes - horizontal resolution, eg 72
  * @param {Number} vRes - vertical resolution, eg 72
- * @param {string} encDepth
+ * @param {string} encName
  * @param {Number} colorDepth - eg 24
  * @param {Uint8Array} avcc - Uint8Array representing the avcC atom
  * @param {Uint8Array} sinf - Uint8Array representing the sinf atom
@@ -43,8 +43,6 @@ declare function createENCVBox(width: number, height: number, hRes: number, vRes
  * @param {Number} packetSize
  * @param {Number} sampleRate
  * @param {Uint8Array} esds - Uint8Array representing the esds atom
- * @param {Uint8Array} [sinf] - Uint8Array representing the sinf atom,
- * only if name == "enca"
  * @returns {Uint8Array}
  */
 declare function createMP4ABox(drefIdx: number, channelsCount: number, sampleSize: number, packetSize: number, sampleRate: number, esds: Uint8Array): Uint8Array;
@@ -61,7 +59,7 @@ declare function createMP4ABox(drefIdx: number, channelsCount: number, sampleSiz
  */
 declare function createENCABox(drefIdx: number, channelsCount: number, sampleSize: number, packetSize: number, sampleRate: number, esds: Uint8Array, sinf: Uint8Array): Uint8Array;
 /**
- * @param {url} Uint8Array
+ * @param {Uint8Array} url
  * @returns {Uint8Array}
  */
 declare function createDREFBox(url: Uint8Array): Uint8Array;
@@ -151,7 +149,7 @@ declare function createSAIZBox(sencContent: Uint8Array): Uint8Array;
  */
 declare function createSMHDBox(): Uint8Array;
 /**
- * @param {Array.<Uint8Array>} representations - arrays of Uint8Array,
+ * @param {Array.<Uint8Array>} reps - arrays of Uint8Array,
  * typically [avc1] or [encv, avc1]
  * @returns {Uint8Array}
  */

package/dist/_esm5.processed/transports/smooth/isobmff/create_boxes.js

@@ -21,7 +21,7 @@ import { hexToBytes, strToUtf8, } from "../../../utils/string_parsing";
  * @param {Number} height
  * @param {Number} hRes - horizontal resolution, eg 72
  * @param {Number} vRes - vertical resolution, eg 72
- * @param {string} encDepth
+ * @param {string} encName
  * @param {Number} colorDepth - eg 24
  * @param {Uint8Array} avcc - Uint8Array representing the avcC atom
  * @returns {Uint8Array}
@@ -46,7 +46,7 @@ function createAVC1Box(width, height, hRes, vRes, encName, colorDepth, avcc) {
  * @param {Number} height
  * @param {Number} hRes - horizontal resolution, eg 72
  * @param {Number} vRes - vertical resolution, eg 72
- * @param {string} encDepth
+ * @param {string} encName
  * @param {Number} colorDepth - eg 24
  * @param {Uint8Array} avcc - Uint8Array representing the avcC atom
  * @param {Uint8Array} sinf - Uint8Array representing the sinf atom
@@ -74,8 +74,6 @@ function createENCVBox(width, height, hRes, vRes, encName, colorDepth, avcc, sin
  * @param {Number} packetSize
  * @param {Number} sampleRate
  * @param {Uint8Array} esds - Uint8Array representing the esds atom
- * @param {Uint8Array} [sinf] - Uint8Array representing the sinf atom,
- * only if name == "enca"
  * @returns {Uint8Array}
  */
 function createMP4ABox(drefIdx, channelsCount, sampleSize, packetSize, sampleRate, esds) {
@@ -96,7 +94,7 @@ function createENCABox(drefIdx, channelsCount, sampleSize, packetSize, sampleRat
     return createBox("enca", concat(6, itobe2(drefIdx), 8, itobe2(channelsCount), itobe2(sampleSize), 2, itobe2(packetSize), itobe2(sampleRate), 2, esds, sinf));
 }
 /**
- * @param {url} Uint8Array
+ * @param {Uint8Array} url
  * @returns {Uint8Array}
  */
 function createDREFBox(url) {
@@ -291,7 +289,7 @@ function createSMHDBox() {
     return createBox("smhd", new Uint8Array(8));
 }
 /**
- * @param {Array.<Uint8Array>} representations - arrays of Uint8Array,
+ * @param {Array.<Uint8Array>} reps - arrays of Uint8Array,
  * typically [avc1] or [encv, avc1]
  * @returns {Uint8Array}
  */

package/dist/_esm5.processed/utils/is_null_or_undefined.d.ts

@@ -19,6 +19,6 @@
  * not always understood by newcomers to the code, and which can be overused when
  * only one of the possibility can arise.
  * @param {*} x
- * @returns {*}
+ * @returns {boolean}
  */
 export default function isNullOrUndefined(x: unknown): x is null | undefined | void;

package/dist/_esm5.processed/utils/is_null_or_undefined.js

@@ -19,7 +19,7 @@
  * not always understood by newcomers to the code, and which can be overused when
  * only one of the possibility can arise.
  * @param {*} x
- * @returns {*}
+ * @returns {boolean}
  */
 export default function isNullOrUndefined(x) {
     return x === null || x === undefined;