rx-player 3.26.3-dev.2022021400 → 3.27.0-dev.20220317

package/dist/_esm5.processed/parsers/manifest/dash/common/parse_mpd.js

@@ -33,7 +33,6 @@ import getMinimumAndMaximumPosition from "./get_minimum_and_maximum_positions";
 import parseAvailabilityStartTime from "./parse_availability_start_time";
 import parsePeriods from "./parse_periods";
 import resolveBaseURLs from "./resolve_base_urls";
-var DASH_FALLBACK_LIFETIME_WHEN_MINIMUM_UPDATE_PERIOD_EQUAL_0 = config.DASH_FALLBACK_LIFETIME_WHEN_MINIMUM_UPDATE_PERIOD_EQUAL_0;
 /**
  * Checks if xlinks needs to be loaded before actually parsing the manifest.
  * @param {Object} mpdIR
@@ -157,7 +156,7 @@ function parseCompleteIntermediateRepresentation(mpdIR, args, warnings, xlinkInf
     if (rootAttributes.minimumUpdatePeriod !== undefined &&
         rootAttributes.minimumUpdatePeriod >= 0) {
         lifetime = rootAttributes.minimumUpdatePeriod === 0 ?
-            DASH_FALLBACK_LIFETIME_WHEN_MINIMUM_UPDATE_PERIOD_EQUAL_0 :
+            config.getCurrent().DASH_FALLBACK_LIFETIME_WHEN_MINIMUM_UPDATE_PERIOD_EQUAL_0 :
             rootAttributes.minimumUpdatePeriod;
     }
     var _d = getMinimumAndMaximumPosition(parsedPeriods), contentStart = _d[0], contentEnd = _d[1];

package/dist/_esm5.processed/parsers/manifest/smooth/create_parser.js

@@ -48,6 +48,7 @@ var MIME_TYPES = {
     AVC1: "video/mp4",
     H264: "video/mp4",
     TTML: "application/ttml+xml+mp4",
+    DFXP: "application/ttml+xml+mp4",
 };
 /**
  * @param {Object|undefined} parserOptions

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

@@ -17,8 +17,8 @@
  * This file exports types we want to expose to library users.
  * Those types are considered as part of the API.
  */
-export { IConstructorOptions, ILoadVideoOptions, ITransportOptions, IKeySystemOption, ISupplementaryTextTrackOption, ISupplementaryImageTrackOption, IDefaultAudioTrackOption, IDefaultTextTrackOption, INetworkConfigOption, IStartAtOption, ITMAudioTrackListItem as IAvailableAudioTrack, ITMTextTrackListItem as IAvailableTextTrack, ITMVideoTrackListItem as IAvailableVideoTrack, ITMAudioTrack as IAudioTrack, ITMTextTrack as ITextTrack, ITMVideoTrack as IVideoTrack, IAudioTrackPreference, ITextTrackPreference, IVideoTrackPreference, IStreamEvent, IStreamEventData, } from "./core/api";
-export { IPersistentSessionInfo, IPersistentSessionStorage, } from "./core/eme";
+export { IConstructorOptions, ILoadVideoOptions, ITransportOptions, IKeySystemOption, ISupplementaryTextTrackOption, ISupplementaryImageTrackOption, IDefaultAudioTrackOption, IDefaultTextTrackOption, INetworkConfigOption, IStartAtOption, ITMAudioTrackListItem as IAvailableAudioTrack, ITMTextTrackListItem as IAvailableTextTrack, ITMVideoTrackListItem as IAvailableVideoTrack, ITMAudioTrack as IAudioTrack, ITMTextTrack as ITextTrack, ITMVideoTrack as IVideoTrack, IAudioTrackPreference, ITextTrackPreference, IVideoTrackPreference, IBitrateEstimate, IPositionUpdateItem as IPositionUpdate, IPlayerState, IStreamEvent, IStreamEventData, } from "./core/api";
+export { IPersistentSessionInfo, IPersistentSessionStorage, } from "./core/decrypt";
 export { ICustomError as IPlayerError } from "./errors";
 export { IExposedAdaptation as IAdaptation, IExposedManifest as IManifest, IExposedPeriod as IPeriod, IExposedRepresentation as IRepresentation, IExposedSegment as ISegment, IRepresentationFilter, IRepresentationInfos, } from "./manifest";
 export { ICustomSegmentLoader as ISegmentLoader, ICustomManifestLoader as IManifestLoader, } from "./transports";

package/dist/_esm5.processed/transports/dash/image_pipelines.js

@@ -47,6 +47,7 @@ export function imageParser(loadedSegment, content) {
     if (content.segment.isInit) { // image init segment has no use
         return { segmentType: "init",
             initializationData: null,
+            initializationDataSize: 0,
             protectionDataUpdate: false,
             initTimescale: undefined };
     }
@@ -58,6 +59,7 @@ export function imageParser(loadedSegment, content) {
     if (data === null || features.imageParser === null) {
         return { segmentType: "media",
             chunkData: null,
+            chunkSize: 0,
             chunkInfos: { duration: segment.duration,
                 time: segment.time }, chunkOffset: chunkOffset, protectionDataUpdate: false,
             appendWindow: [period.start, period.end] };
@@ -70,6 +72,7 @@ export function imageParser(loadedSegment, content) {
             end: Number.MAX_VALUE,
             timescale: 1,
             type: "bif" },
+        chunkSize: undefined,
         chunkInfos: { time: 0,
             duration: Number.MAX_VALUE }, chunkOffset: chunkOffset, protectionDataUpdate: false,
         appendWindow: [period.start, period.end] };

package/dist/_esm5.processed/transports/dash/segment_parser.js

@@ -36,11 +36,13 @@ export default function generateAudioVideoSegmentParser(_a) {
             if (segment.isInit) {
                 return { segmentType: "init",
                     initializationData: null,
+                    initializationDataSize: 0,
                     protectionDataUpdate: false,
                     initTimescale: undefined };
             }
             return { segmentType: "media",
                 chunkData: null,
+                chunkSize: 0,
                 chunkInfos: null,
                 chunkOffset: 0,
                 protectionDataUpdate: false, appendWindow: appendWindow };
@@ -74,11 +76,11 @@ export default function generateAudioVideoSegmentParser(_a) {
                     var events = getEventsOutOfEMSGs(whitelistedEMSGs, manifest.publishTime);
                     if (events !== undefined) {
                         var needsManifestRefresh = events.needsManifestRefresh, inbandEvents = events.inbandEvents;
-                        return { segmentType: "media", chunkData: chunkData, chunkInfos: chunkInfos, chunkOffset: chunkOffset, appendWindow: appendWindow, inbandEvents: inbandEvents, protectionDataUpdate: protectionDataUpdate, needsManifestRefresh: needsManifestRefresh };
+                        return { segmentType: "media", chunkData: chunkData, chunkSize: chunkData.length, chunkInfos: chunkInfos, chunkOffset: chunkOffset, appendWindow: appendWindow, inbandEvents: inbandEvents, protectionDataUpdate: protectionDataUpdate, needsManifestRefresh: needsManifestRefresh };
                     }
                 }
             }
-            return { segmentType: "media", chunkData: chunkData, chunkInfos: chunkInfos, chunkOffset: chunkOffset, protectionDataUpdate: protectionDataUpdate, appendWindow: appendWindow };
+            return { segmentType: "media", chunkData: chunkData, chunkSize: chunkData.length, chunkInfos: chunkInfos, chunkOffset: chunkOffset, protectionDataUpdate: protectionDataUpdate, appendWindow: appendWindow };
         }
         // we're handling an initialization segment
         var indexRange = segment.indexRange;
@@ -117,6 +119,7 @@ export default function generateAudioVideoSegmentParser(_a) {
         var parsedTimescale = isNullOrUndefined(timescale) ? undefined :
             timescale;
         return { segmentType: "init",
-            initializationData: chunkData, protectionDataUpdate: protectionDataUpdate, initTimescale: parsedTimescale };
+            initializationData: chunkData,
+            initializationDataSize: chunkData.length, protectionDataUpdate: protectionDataUpdate, initTimescale: parsedTimescale };
     };
 }

package/dist/_esm5.processed/transports/dash/text_parser.js

@@ -71,13 +71,14 @@ function parseISOBMFFEmbeddedTextTrack(data, isChunked, content, initTimescale,
         }
         return { segmentType: "init",
             initializationData: null,
+            initializationDataSize: 0,
             protectionDataUpdate: false,
             initTimescale: mdhdTimescale };
     }
     var chunkInfos = getISOBMFFTimingInfos(chunkBytes, isChunked, segment, initTimescale);
     var chunkData = getISOBMFFEmbeddedTextTrackData(content, chunkBytes, chunkInfos, isChunked);
     var chunkOffset = takeFirstSet(segment.timestampOffset, 0);
-    return { segmentType: "media", chunkData: chunkData, chunkInfos: chunkInfos, chunkOffset: chunkOffset, protectionDataUpdate: false,
+    return { segmentType: "media", chunkData: chunkData, chunkSize: chunkBytes.length, chunkInfos: chunkInfos, chunkOffset: chunkOffset, protectionDataUpdate: false,
         appendWindow: [period.start, period.end] };
 }
 /**
@@ -97,20 +98,23 @@ function parsePlainTextTrack(data, isChunked, content) {
     if (segment.isInit) {
         return { segmentType: "init",
             initializationData: null,
+            initializationDataSize: 0,
             protectionDataUpdate: false,
             initTimescale: undefined };
     }
     var textTrackData;
+    var chunkSize;
     if (typeof data !== "string") {
         var bytesData = data instanceof Uint8Array ? data :
             new Uint8Array(data);
         textTrackData = utf8ToStr(bytesData);
+        chunkSize = bytesData.length;
     }
     else {
         textTrackData = data;
     }
     var chunkData = getPlainTextTrackData(content, textTrackData, isChunked);
-    return { segmentType: "media", chunkData: chunkData, chunkInfos: null,
+    return { segmentType: "media", chunkData: chunkData, chunkSize: chunkSize, chunkInfos: null,
         chunkOffset: timestampOffset,
         protectionDataUpdate: false,
         appendWindow: [period.start, period.end] };
@@ -136,10 +140,12 @@ export default function generateTextTrackParser(_a) {
             // No data, just return an empty placeholder object
             return segment.isInit ? { segmentType: "init",
                 initializationData: null,
+                initializationDataSize: 0,
                 protectionDataUpdate: false,
                 initTimescale: undefined } :
                 { segmentType: "media",
                     chunkData: null,
+                    chunkSize: 0,
                     chunkInfos: null,
                     chunkOffset: (_a = segment.timestampOffset) !== null && _a !== void 0 ? _a : 0,
                     protectionDataUpdate: false,

package/dist/_esm5.processed/transports/local/segment_parser.js

@@ -26,11 +26,13 @@ export default function segmentParser(loadedSegment, content, initTimescale) {
         if (segment.isInit) {
             return { segmentType: "init",
                 initializationData: null,
+                initializationDataSize: 0,
                 protectionDataUpdate: false,
                 initTimescale: undefined };
         }
         return { segmentType: "media",
             chunkData: null,
+            chunkSize: 0,
             chunkInfos: null,
             chunkOffset: 0,
             protectionDataUpdate: false, appendWindow: appendWindow };
@@ -52,10 +54,11 @@ export default function segmentParser(loadedSegment, content, initTimescale) {
             getMDHDTimescale(chunkData);
         return { segmentType: "init",
             initializationData: chunkData,
+            initializationDataSize: 0,
             initTimescale: timescale !== null && timescale !== void 0 ? timescale : undefined, protectionDataUpdate: protectionDataUpdate };
     }
     var chunkInfos = seemsToBeMP4 ? getISOBMFFTimingInfos(chunkData, false, segment, initTimescale) :
         null; // TODO extract time info from webm
     var chunkOffset = takeFirstSet(segment.timestampOffset, 0);
-    return { segmentType: "media", chunkData: chunkData, chunkInfos: chunkInfos, chunkOffset: chunkOffset, protectionDataUpdate: false, appendWindow: appendWindow };
+    return { segmentType: "media", chunkData: chunkData, chunkSize: chunkData.length, chunkInfos: chunkInfos, chunkOffset: chunkOffset, protectionDataUpdate: false, appendWindow: appendWindow };
 }

package/dist/_esm5.processed/transports/local/text_parser.js

@@ -43,13 +43,14 @@ function parseISOBMFFEmbeddedTextTrack(data, isChunked, content, initTimescale)
         var mdhdTimescale = getMDHDTimescale(chunkBytes);
         return { segmentType: "init",
             initializationData: null,
+            initializationDataSize: 0,
             initTimescale: mdhdTimescale,
             protectionDataUpdate: false };
     }
     var chunkInfos = getISOBMFFTimingInfos(chunkBytes, isChunked, segment, initTimescale);
     var chunkData = getISOBMFFEmbeddedTextTrackData(content, chunkBytes, chunkInfos, isChunked);
     var chunkOffset = takeFirstSet(segment.timestampOffset, 0);
-    return { segmentType: "media", chunkData: chunkData, chunkInfos: chunkInfos, chunkOffset: chunkOffset, protectionDataUpdate: false,
+    return { segmentType: "media", chunkData: chunkData, chunkSize: chunkBytes.length, chunkInfos: chunkInfos, chunkOffset: chunkOffset, protectionDataUpdate: false,
         appendWindow: [period.start, period.end] };
 }
 /**
@@ -67,21 +68,24 @@ function parsePlainTextTrack(data, isChunked, content) {
     if (segment.isInit) {
         return { segmentType: "init",
             initializationData: null,
+            initializationDataSize: 0,
             initTimescale: undefined,
             protectionDataUpdate: false };
     }
     var textTrackData;
+    var chunkSize;
     if (typeof data !== "string") {
         var bytesData = data instanceof Uint8Array ? data :
             new Uint8Array(data);
         textTrackData = utf8ToStr(bytesData);
+        chunkSize = bytesData.length;
     }
     else {
         textTrackData = data;
     }
     var chunkData = getPlainTextTrackData(content, textTrackData, isChunked);
     var chunkOffset = takeFirstSet(segment.timestampOffset, 0);
-    return { segmentType: "media", chunkData: chunkData, chunkInfos: null, chunkOffset: chunkOffset, protectionDataUpdate: false,
+    return { segmentType: "media", chunkData: chunkData, chunkSize: chunkSize, chunkInfos: null, chunkOffset: chunkOffset, protectionDataUpdate: false,
         appendWindow: [period.start, period.end] };
 }
 /**
@@ -100,12 +104,14 @@ export default function textTrackParser(loadedSegment, content, initTimescale) {
         if (segment.isInit) {
             return { segmentType: "init",
                 initializationData: null,
+                initializationDataSize: 0,
                 protectionDataUpdate: false,
                 initTimescale: undefined };
         }
         var chunkOffset = (_a = segment.timestampOffset) !== null && _a !== void 0 ? _a : 0;
         return { segmentType: "media",
             chunkData: null,
+            chunkSize: 0,
             chunkInfos: null, chunkOffset: chunkOffset, protectionDataUpdate: false,
             appendWindow: [period.start, period.end] };
     }

package/dist/_esm5.processed/transports/smooth/pipelines.js

@@ -24,6 +24,42 @@ var __assign = (this && this.__assign) || function () {
     };
     return __assign.apply(this, arguments);
 };
+var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, generator) {
+    function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }
+    return new (P || (P = Promise))(function (resolve, reject) {
+        function fulfilled(value) { try { step(generator.next(value)); } catch (e) { reject(e); } }
+        function rejected(value) { try { step(generator["throw"](value)); } catch (e) { reject(e); } }
+        function step(result) { result.done ? resolve(result.value) : adopt(result.value).then(fulfilled, rejected); }
+        step((generator = generator.apply(thisArg, _arguments || [])).next());
+    });
+};
+var __generator = (this && this.__generator) || function (thisArg, body) {
+    var _ = { label: 0, sent: function() { if (t[0] & 1) throw t[1]; return t[1]; }, trys: [], ops: [] }, f, y, t, g;
+    return g = { next: verb(0), "throw": verb(1), "return": verb(2) }, typeof Symbol === "function" && (g[Symbol.iterator] = function() { return this; }), g;
+    function verb(n) { return function (v) { return step([n, v]); }; }
+    function step(op) {
+        if (f) throw new TypeError("Generator is already executing.");
+        while (_) try {
+            if (f = 1, y && (t = op[0] & 2 ? y["return"] : op[0] ? y["throw"] || ((t = y["return"]) && t.call(y), 0) : y.next) && !(t = t.call(y, op[1])).done) return t;
+            if (y = 0, t) op = [op[0] & 2, t.value];
+            switch (op[0]) {
+                case 0: case 1: t = op; break;
+                case 4: _.label++; return { value: op[1], done: false };
+                case 5: _.label++; y = op[1]; op = [0]; continue;
+                case 7: op = _.ops.pop(); _.trys.pop(); continue;
+                default:
+                    if (!(t = _.trys, t = t.length > 0 && t[t.length - 1]) && (op[0] === 6 || op[0] === 2)) { _ = 0; continue; }
+                    if (op[0] === 3 && (!t || (op[1] > t[0] && op[1] < t[3]))) { _.label = op[1]; break; }
+                    if (op[0] === 6 && _.label < t[1]) { _.label = t[1]; t = op; break; }
+                    if (t && _.label < t[2]) { _.label = t[2]; _.ops.push(op); break; }
+                    if (t[2]) _.ops.pop();
+                    _.trys.pop(); continue;
+            }
+            op = body.call(thisArg, _);
+        } catch (e) { op = [6, e]; y = 0; } finally { f = t = 0; }
+        if (op[0] & 5) throw op[1]; return { value: op[0] ? op[1] : void 0, done: true };
+    }
+};
 import features from "../../features";
 import log from "../../log";
 import Manifest from "../../manifest";
@@ -134,6 +170,7 @@ export default function (options) {
                 if (segment.isInit) {
                     return { segmentType: "init",
                         initializationData: null,
+                        initializationDataSize: 0,
                         protectionDataUpdate: false,
                         initTimescale: undefined };
                 }
@@ -141,6 +178,7 @@ export default function (options) {
                     chunkData: null,
                     chunkInfos: null,
                     chunkOffset: 0,
+                    chunkSize: 0,
                     protectionDataUpdate: false,
                     appendWindow: [undefined, undefined] };
             }
@@ -150,6 +188,7 @@ export default function (options) {
                 var timescale = (_b = (_a = segment.privateInfos) === null || _a === void 0 ? void 0 : _a.smoothInitSegment) === null || _b === void 0 ? void 0 : _b.timescale;
                 return { segmentType: "init",
                     initializationData: data,
+                    initializationDataSize: data.byteLength,
                     // smooth init segments are crafted by hand.
                     // Their timescale is the one from the manifest.
                     initTimescale: timescale,
@@ -169,6 +208,7 @@ export default function (options) {
                 addNextSegments(adaptation, nextSegments, segment);
             }
             return { segmentType: "media", chunkData: chunkData, chunkInfos: chunkInfos, chunkOffset: 0,
+                chunkSize: chunkData.length,
                 protectionDataUpdate: false,
                 appendWindow: [undefined, undefined] };
         },
@@ -207,9 +247,11 @@ export default function (options) {
             var isMP4 = isMP4EmbeddedTrack(representation);
             var _b = representation.mimeType, mimeType = _b === void 0 ? "" : _b, _c = representation.codec, codec = _c === void 0 ? "" : _c;
             var data = loadedSegment.data, isChunked = loadedSegment.isChunked;
+            var chunkSize;
             if (segment.isInit) { // text init segment has no use in HSS
                 return { segmentType: "init",
                     initializationData: null,
+                    initializationDataSize: 0,
                     protectionDataUpdate: false,
                     initTimescale: undefined };
             }
@@ -218,6 +260,7 @@ export default function (options) {
                     chunkData: null,
                     chunkInfos: null,
                     chunkOffset: 0,
+                    chunkSize: 0,
                     protectionDataUpdate: false,
                     appendWindow: [undefined, undefined] };
             }
@@ -236,6 +279,7 @@ export default function (options) {
                     chunkBytes = data instanceof Uint8Array ? data :
                         new Uint8Array(data);
                 }
+                chunkSize = chunkBytes.length;
                 var timingInfos = initTimescale !== undefined ?
                     extractTimingsInfos(chunkBytes, isChunked, initTimescale, segment, manifest.isLive) :
                     null;
@@ -279,6 +323,7 @@ export default function (options) {
                 if (typeof data !== "string") {
                     var bytesData = data instanceof Uint8Array ? data :
                         new Uint8Array(data);
+                    chunkSize = bytesData.length;
                     chunkString = utf8ToStr(bytesData);
                 }
                 else {
@@ -316,27 +361,38 @@ export default function (options) {
                 chunkData: { type: _sdType,
                     data: _sdData,
                     start: segmentStart,
-                    end: segmentEnd, language: language }, chunkInfos: chunkInfos, chunkOffset: chunkOffset, protectionDataUpdate: false,
+                    end: segmentEnd, language: language }, chunkSize: chunkSize, chunkInfos: chunkInfos, chunkOffset: chunkOffset, protectionDataUpdate: false,
                 appendWindow: [undefined, undefined] };
         },
     };
     var imageTrackPipeline = {
         loadSegment: function (url, content, cancelSignal, callbacks) {
-            if (content.segment.isInit || url === null) {
-                // image do not need an init segment. Passthrough directly to the parser
-                return PPromise.resolve({ resultType: "segment-created",
-                    resultData: null });
-            }
-            return request({ url: url, responseType: "arraybuffer",
-                onProgress: callbacks.onProgress, cancelSignal: cancelSignal })
-                .then(function (data) { return ({ resultType: "segment-loaded",
-                resultData: data }); });
+            return __awaiter(this, void 0, void 0, function () {
+                var data;
+                return __generator(this, function (_a) {
+                    switch (_a.label) {
+                        case 0:
+                            if (content.segment.isInit || url === null) {
+                                // image do not need an init segment. Passthrough directly to the parser
+                                return [2 /*return*/, { resultType: "segment-created",
+                                        resultData: null }];
+                            }
+                            return [4 /*yield*/, request({ url: url, responseType: "arraybuffer",
+                                    onProgress: callbacks.onProgress, cancelSignal: cancelSignal })];
+                        case 1:
+                            data = _a.sent();
+                            return [2 /*return*/, { resultType: "segment-loaded",
+                                    resultData: data }];
+                    }
+                });
+            });
         },
         parseSegment: function (loadedSegment, content, _initTimescale) {
             var data = loadedSegment.data, isChunked = loadedSegment.isChunked;
             if (content.segment.isInit) { // image init segment has no use
                 return { segmentType: "init",
                     initializationData: null,
+                    initializationDataSize: 0,
                     protectionDataUpdate: false,
                     initTimescale: undefined };
             }
@@ -349,6 +405,7 @@ export default function (options) {
                     chunkData: null,
                     chunkInfos: null,
                     chunkOffset: 0,
+                    chunkSize: 0,
                     protectionDataUpdate: false,
                     appendWindow: [undefined, undefined] };
             }
@@ -362,6 +419,7 @@ export default function (options) {
                     type: "bif" },
                 chunkInfos: { time: 0,
                     duration: Number.MAX_VALUE },
+                chunkSize: undefined,
                 chunkOffset: 0,
                 protectionDataUpdate: false,
                 appendWindow: [undefined, undefined] };

package/dist/_esm5.processed/transports/types.d.ts

@@ -589,6 +589,17 @@ export interface ISegmentParserParsedInitChunk<DataType> {
      * protection initialization data to have been encountered.
      */
     protectionDataUpdate: boolean;
+    /**
+     * Size in bytes of `initializationData`.
+     * `undefined` if unknown.
+     *
+     * Note: In some cases, such as when `initializationData` is under a format
+     * whose size is difficult to estimate (e.g. a JavaScript object), the
+     * `initializationDataSize` may either be set to `undefined` or, if available,
+     * to a sensible estimate (e.g. when a JavaScript object wraps large binary
+     * data, `initializationDataSize` may refer to that binary data only).
+     */
+    initializationDataSize: number | undefined;
 }
 /**
  * Result returned by a segment parser when it parsed a chunk from a media
@@ -606,6 +617,17 @@ export interface ISegmentParserParsedMediaChunk<DataType> {
      * `null` if unknown.
      */
     chunkInfos: IChunkTimeInfo | null;
+    /**
+     * Size in bytes of `chunkData`.
+     * `undefined` if unknown.
+     *
+     * Note: In some cases, such as when `chunkData` is under a format whose size
+     * is difficult to estimate (e.g. a JavaScript object), the `chunkSize` may
+     * either be set to `undefined` or, if available, to a sensible estimate (e.g.
+     * when a JavaScript object wraps large binary data, `chunkSize` may refer to
+     * that binary data only).
+     */
+    chunkSize: number | undefined;
     /**
      * time offset, in seconds, to add to the absolute timed data defined in
      * `chunkData` to obtain the "real" wanted effective time.

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

@@ -0,0 +1,12 @@
+declare type IDeepPartial<T> = {
+    [P in keyof T]?: IDeepPartial<T[P]>;
+};
+declare type ISourcesArgument<T> = Array<IDeepPartial<T> | unknown>;
+/**
+ * Deeply merge nested objects
+ * @param target
+ * @param sources
+ * @returns output : merged object
+ */
+export default function deepMerge<T>(target: T, ...sources: ISourcesArgument<T>): T;
+export {};

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

@@ -0,0 +1,53 @@
+var __spreadArray = (this && this.__spreadArray) || function (to, from, pack) {
+    if (pack || arguments.length === 2) for (var i = 0, l = from.length, ar; i < l; i++) {
+        if (ar || !(i in from)) {
+            if (!ar) ar = Array.prototype.slice.call(from, 0, i);
+            ar[i] = from[i];
+        }
+    }
+    return to.concat(ar || Array.prototype.slice.call(from));
+};
+import objectAssign from "./object_assign";
+/**
+ * Check if an item is an object
+ * @param item
+ * @returns {boolean}
+ */
+function isObject(item) {
+    return (item !== null
+        && item !== undefined
+        && !Array.isArray(item)
+        && typeof item === "object");
+}
+/**
+ * Deeply merge nested objects
+ * @param target
+ * @param sources
+ * @returns output : merged object
+ */
+export default function deepMerge(target) {
+    var _a, _b;
+    var sources = [];
+    for (var _i = 1; _i < arguments.length; _i++) {
+        sources[_i - 1] = arguments[_i];
+    }
+    if (sources.length === 0) {
+        return target;
+    }
+    var source = sources.shift();
+    if (isObject(target) && isObject(source)) {
+        for (var key in source) {
+            if (isObject(source[key])) {
+                if (target[key] === undefined) {
+                    objectAssign(target, (_a = {}, _a[key] = {}, _a));
+                }
+                var newTarget = target[key];
+                deepMerge(newTarget, source[key]);
+            }
+            else {
+                objectAssign(target, (_b = {}, _b[key] = source[key], _b));
+            }
+        }
+    }
+    return deepMerge.apply(void 0, __spreadArray([target], sources, false));
+}

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

@@ -14,6 +14,7 @@
  * limitations under the License.
  */
 import { Observable } from "rxjs";
+import { CancellationSignal } from "./task_canceller";
 /**
  * A value behind a shared reference, meaning that any update to its value from
  * anywhere can be retrieved from any other parts of the code in posession of
@@ -55,6 +56,7 @@ export interface ISharedReference<T> {
     getValue(): T;
     /** Update the value of this shared reference. */
     setValue(newVal: T): void;
+    setValueIfChanged(newVal: T): void;
     /**
      * Returns an Observable which synchronously emits the current value (unless
      * the `skipCurrentValue` argument has been set to `true`) and then each time
@@ -63,6 +65,21 @@ export interface ISharedReference<T> {
      * @returns {Observable}
      */
     asObservable(skipCurrentValue?: boolean): Observable<T>;
+    /**
+     * Allows to register a callback to be called each time the value inside the
+     * reference is updated.
+     * @param {Function} cb - Callback to be called each time the reference is
+     * updated. Takes the new value im argument.
+     * @param {Object} [options]
+     * @param {Object} [options.clearSignal] - Allows to provide a
+     * CancellationSignal which will unregister the callback when it emits.
+     * @param {boolean} [options.emitCurrentValue] - If `true`, the callback will
+     * also be immediately called with the current value.
+     */
+    onUpdate(cb: (val: T) => void, options?: {
+        clearSignal?: CancellationSignal;
+        emitCurrentValue?: boolean;
+    }): void;
     /**
      * Indicate that no new values will be emitted.
      * Allows to automatically close all Observables generated from this shared
@@ -93,8 +110,20 @@ export interface ISharedReference<T> {
  * the code that some logic is not supposed to update the referenced value.
  */
 export interface IReadOnlySharedReference<T> {
+    /** Get the last value set on that reference. */
     getValue(): T;
+    /**
+     * Returns an Observable notifying this reference's value each time it is
+     * updated.
+     *
+     * Also emit its current value on subscription unless its argument is set to
+     * `true`.
+     */
     asObservable(skipCurrentValue?: boolean): Observable<T>;
+    onUpdate(cb: (val: T) => void, options?: {
+        clearSignal?: CancellationSignal;
+        emitCurrentValue?: boolean;
+    }): void;
 }
 /**
  * Create an `ISharedReference` object encapsulating the mutable `initialValue`