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

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_loader.js

@@ -15,14 +15,13 @@
  */
 import { CustomLoaderError } from "../../errors";
 import isNullOrUndefined from "../../utils/is_null_or_undefined";
-import PPromise from "../../utils/promise";
 /**
  * @param {Function} customSegmentLoader
  * @param {Object} cancelSignal
  * @returns {Promise}
  */
 function loadInitSegment(customSegmentLoader, cancelSignal) {
-    return new PPromise(function (res, rej) {
+    return new Promise(function (res, rej) {
         /** `true` when the custom segmentLoader should not be active anymore. */
         var hasFinished = false;
         /**
@@ -77,7 +76,7 @@ function loadInitSegment(customSegmentLoader, cancelSignal) {
  * @returns {Observable}
  */
 function loadSegment(segment, customSegmentLoader, cancelSignal) {
-    return new PPromise(function (res, rej) {
+    return new Promise(function (res, rej) {
         /** `true` when the custom segmentLoader should not be active anymore. */
         var hasFinished = 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/metaplaylist/pipelines.js

@@ -29,7 +29,6 @@ import Manifest from "../../manifest";
 import parseMetaPlaylist from "../../parsers/manifest/metaplaylist";
 import isNullOrUndefined from "../../utils/is_null_or_undefined";
 import objectAssign from "../../utils/object_assign";
-import PPromise from "../../utils/promise";
 import generateManifestLoader from "./manifest_loader";
 /**
  * Get base - real - content from an offseted metaplaylist content.
@@ -98,7 +97,7 @@ export default function (options) {
             function handleParsedResult(parsedResult) {
                 if (parsedResult.type === "done") {
                     var manifest = new Manifest(parsedResult.value, options);
-                    return PPromise.resolve({ manifest: manifest });
+                    return Promise.resolve({ manifest: manifest });
                 }
                 var parsedValue = parsedResult.value;
                 var loaderProms = parsedValue.ressources.map(function (resource) {
@@ -111,7 +110,7 @@ export default function (options) {
                         return transport.manifest.loadManifest(resource.url, cancelSignal);
                     }
                 });
-                return PPromise.all(loaderProms).then(function (parsedReqs) {
+                return Promise.all(loaderProms).then(function (parsedReqs) {
                     var loadedRessources = parsedReqs.map(function (e) { return e.manifest; });
                     return handleParsedResult(parsedResult.value.continue(loadedRessources));
                 });

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

@@ -24,12 +24,47 @@ 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";
 import { getMDAT } from "../../parsers/containers/isobmff";
 import createSmoothManifestParser, { SmoothRepresentationIndex, } from "../../parsers/manifest/smooth";
-import PPromise from "../../utils/promise";
 import request from "../../utils/request";
 import { strToUtf8, utf8ToStr, } from "../../utils/string_parsing";
 import warnOnce from "../../utils/warn_once";
@@ -69,7 +104,7 @@ export default function (options) {
         // TODO (v4.x.x) Remove that function
         resolveManifestUrl: function (url, cancelSignal) {
             if (url === undefined) {
-                return PPromise.resolve(undefined);
+                return Promise.resolve(undefined);
             }
             var resolving;
             if (WSX_REG.test(url)) {
@@ -86,7 +121,7 @@ export default function (options) {
                 });
             }
             else {
-                resolving = PPromise.resolve(url);
+                resolving = Promise.resolve(url);
             }
             var token = extractToken(url);
             return resolving.then(function (_url) {
@@ -134,6 +169,7 @@ export default function (options) {
                 if (segment.isInit) {
                     return { segmentType: "init",
                         initializationData: null,
+                        initializationDataSize: 0,
                         protectionDataUpdate: false,
                         initTimescale: undefined };
                 }
@@ -141,6 +177,7 @@ export default function (options) {
                     chunkData: null,
                     chunkInfos: null,
                     chunkOffset: 0,
+                    chunkSize: 0,
                     protectionDataUpdate: false,
                     appendWindow: [undefined, undefined] };
             }
@@ -150,6 +187,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 +207,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] };
         },
@@ -177,7 +216,7 @@ export default function (options) {
         loadSegment: function (url, content, cancelSignal, callbacks) {
             var segment = content.segment, representation = content.representation;
             if (segment.isInit || url === null) {
-                return PPromise.resolve({ resultType: "segment-created",
+                return Promise.resolve({ resultType: "segment-created",
                     resultData: null });
             }
             var isMP4 = isMP4EmbeddedTrack(representation);
@@ -207,9 +246,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 +259,7 @@ export default function (options) {
                     chunkData: null,
                     chunkInfos: null,
                     chunkOffset: 0,
+                    chunkSize: 0,
                     protectionDataUpdate: false,
                     appendWindow: [undefined, undefined] };
             }
@@ -236,6 +278,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 +322,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 +360,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 +404,7 @@ export default function (options) {
                     chunkData: null,
                     chunkInfos: null,
                     chunkOffset: 0,
+                    chunkSize: 0,
                     protectionDataUpdate: false,
                     appendWindow: [undefined, undefined] };
             }
@@ -362,6 +418,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/smooth/segment_loader.js

@@ -26,7 +26,6 @@ var __assign = (this && this.__assign) || function () {
 };
 import { CustomLoaderError } from "../../errors";
 import assert from "../../utils/assert";
-import PPromise from "../../utils/promise";
 import request from "../../utils/request";
 import byteRange from "../utils/byte_range";
 import checkISOBMFFIntegrity from "../utils/check_isobmff_integrity";
@@ -98,11 +97,11 @@ var generateSegmentLoader = function (_a) {
                     }
                     responseData = new Uint8Array(0);
             }
-            return PPromise.resolve({ resultType: "segment-created",
+            return Promise.resolve({ resultType: "segment-created",
                 resultData: responseData });
         }
         else if (url === null) {
-            return PPromise.resolve({ resultType: "segment-created",
+            return Promise.resolve({ resultType: "segment-created",
                 resultData: null });
         }
         else {
@@ -110,7 +109,7 @@ var generateSegmentLoader = function (_a) {
             if (typeof customSegmentLoader !== "function") {
                 return regularSegmentLoader(url, content, callbacks, cancelSignal, checkMediaSegmentIntegrity);
             }
-            return new PPromise(function (res, rej) {
+            return new Promise(function (res, rej) {
                 /** `true` when the custom segmentLoader should not be active anymore. */
                 var hasFinished = false;
                 /**

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/transports/utils/call_custom_manifest_loader.js

@@ -14,10 +14,9 @@
  * limitations under the License.
  */
 import { CustomLoaderError } from "../../errors";
-import PPromise from "../../utils/promise";
 export default function callCustomManifestLoader(customManifestLoader, fallbackManifestLoader) {
     return function (url, cancelSignal) {
-        return new PPromise(function (res, rej) {
+        return new Promise(function (res, rej) {
             var timeAPIsDelta = Date.now() - performance.now();
             /** `true` when the custom segmentLoader should not be active anymore. */
             var hasFinished = false;

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

@@ -13,7 +13,6 @@
  * See the License for the specific language governing permissions and
  * limitations under the License.
  */
-import PPromise from "./promise";
 /**
  * Wait the given `delay`, resolving the Promise when finished.
  *
@@ -28,7 +27,7 @@ import PPromise from "./promise";
  * cancellation with the corresponding `CancellationError`.
  */
 export default function cancellableSleep(delay, cancellationSignal) {
-    return new PPromise(function (res, rej) {
+    return new Promise(function (res, rej) {
         var timeout = setTimeout(function () {
             unregisterCancelSignal();
             res();

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

@@ -15,7 +15,6 @@
  */
 import { from as observableFrom, Observable, of as observableOf, } from "rxjs";
 import isNullOrUndefined from "./is_null_or_undefined";
-import PPromise from "./promise";
 /**
  * Try to cast the given value into an observable.
  * StraightForward - test first for an Observable then for a Promise.
@@ -26,8 +25,7 @@ function castToObservable(value) {
     if (value instanceof Observable) {
         return value;
     }
-    else if (value instanceof PPromise ||
-        value instanceof Promise ||
+    else if (value instanceof Promise ||
         (!isNullOrUndefined(value) &&
             typeof value.then === "function")) {
         return observableFrom(value);

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`