@aws-amplify/core 4.6.2-next.13 → 4.6.2-next.32

package/lib-esm/Util/BackgroundProcessManager.js

@@ -0,0 +1,383 @@
+import { __awaiter, __extends, __generator, __values } from "tslib";
+/**
+ * @private For internal Amplify use.
+ *
+ * Creates a new scope for promises, observables, and other types of work or
+ * processes that may be running in the background. This manager provides
+ * an singular entrypoint to request termination and await completion.
+ *
+ * As work completes on its own prior to close, the manager removes them
+ * from the registry to avoid holding references to completed jobs.
+ */
+var BackgroundProcessManager = /** @class */ (function () {
+    /**
+     * Creates a new manager for promises, observables, and other types
+     * of work that may be running in the background. This manager provides
+     * a centralized mechanism to request termination and await completion.
+     */
+    function BackgroundProcessManager() {
+        /**
+         * A string indicating whether the manager is accepting new work ("Open"),
+         * waiting for work to complete ("Closing"), or fully done with all
+         * submitted work and *not* accepting new jobs ("Closed").
+         */
+        this._state = BackgroundProcessManagerState.Open;
+        /**
+         * The list of outstanding jobs we'll need to wait for upon `close()`
+         */
+        this.jobs = new Set();
+    }
+    BackgroundProcessManager.prototype.add = function (jobOrDescription, optionalDescription) {
+        var job;
+        var description;
+        if (typeof jobOrDescription === 'string') {
+            job = undefined;
+            description = jobOrDescription;
+        }
+        else {
+            job = jobOrDescription;
+            description = optionalDescription;
+        }
+        var error = this.closedFailure(description);
+        if (error)
+            return error;
+        if (job === undefined) {
+            return this.addHook(description);
+        }
+        else if (typeof job === 'function') {
+            return this.addFunction(job, description);
+        }
+        else if (job instanceof BackgroundProcessManager) {
+            return this.addManager(job, description);
+        }
+        else {
+            throw new Error('If `job` is provided, it must be an Observable, Function, or BackgroundProcessManager.');
+        }
+    };
+    /**
+     * Adds a **cleaner** function that doesn't immediately get executed.
+     * Instead, the caller gets a **terminate** function back. The *cleaner* is
+     * invoked only once the mananger *closes* or the returned **terminate**
+     * function is called.
+     *
+     * @param clean The cleanup function.
+     * @param description Optional description to help identify pending jobs.
+     * @returns A terminate function.
+     */
+    BackgroundProcessManager.prototype.addCleaner = function (clean, description) {
+        var _this = this;
+        var _a = this.addHook(description), resolve = _a.resolve, onTerminate = _a.onTerminate;
+        var proxy = function () { return __awaiter(_this, void 0, void 0, function () {
+            return __generator(this, function (_a) {
+                switch (_a.label) {
+                    case 0: return [4 /*yield*/, clean()];
+                    case 1:
+                        _a.sent();
+                        resolve();
+                        return [2 /*return*/];
+                }
+            });
+        }); };
+        onTerminate.then(proxy);
+        return proxy;
+    };
+    BackgroundProcessManager.prototype.addFunction = function (job, description) {
+        // the function we call when we want to try to terminate this job.
+        var terminate;
+        // the promise the job can opt into listening to for termination.
+        var onTerminate = new Promise(function (resolve) {
+            terminate = resolve;
+        });
+        // finally! start the job.
+        var jobResult = job(onTerminate);
+        // depending on what the job gives back, register the result
+        // so we can monitor for completion.
+        if (typeof (jobResult === null || jobResult === void 0 ? void 0 : jobResult.then) === 'function') {
+            this.registerPromise(jobResult, terminate, description);
+        }
+        // At the end of the day, or you know, method call, it doesn't matter
+        // what the return value is at all; we just pass it through to the
+        // caller.
+        return jobResult;
+    };
+    BackgroundProcessManager.prototype.addManager = function (manager, description) {
+        var _this = this;
+        this.addCleaner(function () { return __awaiter(_this, void 0, void 0, function () { return __generator(this, function (_a) {
+            switch (_a.label) {
+                case 0: return [4 /*yield*/, manager.close()];
+                case 1: return [2 /*return*/, _a.sent()];
+            }
+        }); }); }, description);
+    };
+    /**
+     * Creates and registers a fabricated job for processes that need to operate
+     * with callbacks/hooks. The returned `resolve` and `reject`
+     * functions can be used to signal the job is done successfully or not.
+     * The returned `onTerminate` is a promise that will resolve when the
+     * manager is requesting the termination of the job.
+     *
+     * @param description Optional description to help identify pending jobs.
+     * @returns `{ resolve, reject, onTerminate }`
+     */
+    BackgroundProcessManager.prototype.addHook = function (description) {
+        // the resolve/reject functions we'll provide to the caller to signal
+        // the state of the job.
+        var resolve;
+        var reject;
+        // the underlying promise we'll use to manage it, pretty much like
+        // any other promise.
+        var promise = new Promise(function (res, rej) {
+            resolve = res;
+            reject = rej;
+        });
+        // the function we call when we want to try to terminate this job.
+        var terminate;
+        // the promise the job can opt into listening to for termination.
+        var onTerminate = new Promise(function (resolveTerminate) {
+            terminate = resolveTerminate;
+        });
+        this.registerPromise(promise, terminate, description);
+        return {
+            resolve: resolve,
+            reject: reject,
+            onTerminate: onTerminate,
+        };
+    };
+    /**
+     * Adds a Promise based job to the list of jobs for monitoring and listens
+     * for either a success or failure, upon which the job is considered "done"
+     * and removed from the registry.
+     *
+     * @param promise A promise that is on its way to being returned to a
+     * caller, which needs to be tracked as a background job.
+     * @param terminate The termination function to register, which can be
+     * invoked to request the job stop.
+     * @param description Optional description to help identify pending jobs.
+     */
+    BackgroundProcessManager.prototype.registerPromise = function (promise, terminate, description) {
+        var _this = this;
+        var jobEntry = { promise: promise, terminate: terminate, description: description };
+        this.jobs.add(jobEntry);
+        // in all of my testing, it is safe to multi-subscribe to a promise.
+        // so, rather than create another layer of promising, we're just going
+        // to hook into the promise we already have, and when it's done
+        // (successfully or not), we no longer need to wait for it upon close.
+        //
+        // sorry this is a bit hand-wavy:
+        //
+        // i believe we use `.then` and `.catch` instead of `.finally` because
+        // `.finally` is invoked in a different order in the sequence, and this
+        // breaks assumptions throughout and causes failures.
+        promise
+            .then(function () {
+            _this.jobs.delete(jobEntry);
+        })
+            .catch(function () {
+            _this.jobs.delete(jobEntry);
+        });
+    };
+    Object.defineProperty(BackgroundProcessManager.prototype, "length", {
+        /**
+         * The number of jobs being waited on.
+         *
+         * We don't use this for anything. It's just informational for the caller,
+         * and can be used in logging and testing.
+         *
+         * @returns the number of jobs.
+         */
+        get: function () {
+            return this.jobs.size;
+        },
+        enumerable: true,
+        configurable: true
+    });
+    Object.defineProperty(BackgroundProcessManager.prototype, "state", {
+        /**
+         * The execution state of the manager. One of:
+         *
+         * 1. "Open" -> Accepting new jobs
+         * 1. "Closing" -> Not accepting new work. Waiting for jobs to complete.
+         * 1. "Closed" -> Not accepting new work. All submitted jobs are complete.
+         */
+        get: function () {
+            return this._state;
+        },
+        enumerable: true,
+        configurable: true
+    });
+    Object.defineProperty(BackgroundProcessManager.prototype, "pending", {
+        /**
+         * The registered `description` of all still-pending jobs.
+         *
+         * @returns descriptions as an array.
+         */
+        get: function () {
+            return Array.from(this.jobs).map(function (job) { return job.description; });
+        },
+        enumerable: true,
+        configurable: true
+    });
+    Object.defineProperty(BackgroundProcessManager.prototype, "isOpen", {
+        /**
+         * Whether the manager is accepting new jobs.
+         */
+        get: function () {
+            return this._state === BackgroundProcessManagerState.Open;
+        },
+        enumerable: true,
+        configurable: true
+    });
+    Object.defineProperty(BackgroundProcessManager.prototype, "isClosing", {
+        /**
+         * Whether the manager is rejecting new work, but still waiting for
+         * submitted work to complete.
+         */
+        get: function () {
+            return this._state === BackgroundProcessManagerState.Closing;
+        },
+        enumerable: true,
+        configurable: true
+    });
+    Object.defineProperty(BackgroundProcessManager.prototype, "isClosed", {
+        /**
+         * Whether the manager is rejecting work and done waiting for submitted
+         * work to complete.
+         */
+        get: function () {
+            return this._state === BackgroundProcessManagerState.Closed;
+        },
+        enumerable: true,
+        configurable: true
+    });
+    BackgroundProcessManager.prototype.closedFailure = function (description) {
+        if (!this.isOpen) {
+            return Promise.reject(new BackgroundManagerNotOpenError([
+                "The manager is " + this.state + ".",
+                "You tried to add \"" + description + "\".",
+                "Pending jobs: [\n" + this.pending
+                    .map(function (t) { return '    ' + t; })
+                    .join(',\n') + "\n]",
+            ].join('\n')));
+        }
+    };
+    /**
+     * Signals jobs to stop (for those that accept interruptions) and waits
+     * for confirmation that jobs have stopped.
+     *
+     * This immediately puts the manager into a closing state and just begins
+     * to reject new work. After all work in the manager is complete, the
+     * manager goes into a `Completed` state and `close()` returns.
+     *
+     * This call is idempotent.
+     *
+     * If the manager is already closing or closed, `finalCleaup` is not executed.
+     *
+     * @param onClosed
+     * @returns The settled results of each still-running job's promise. If the
+     * manager is already closed, this will contain the results as of when the
+     * manager's `close()` was called in an `Open` state.
+     */
+    BackgroundProcessManager.prototype.close = function () {
+        return __awaiter(this, void 0, void 0, function () {
+            var _a, _b, job;
+            var e_1, _c;
+            return __generator(this, function (_d) {
+                switch (_d.label) {
+                    case 0:
+                        if (!this.isOpen) return [3 /*break*/, 2];
+                        this._state = BackgroundProcessManagerState.Closing;
+                        try {
+                            for (_a = __values(Array.from(this.jobs)), _b = _a.next(); !_b.done; _b = _a.next()) {
+                                job = _b.value;
+                                try {
+                                    job.terminate();
+                                }
+                                catch (error) {
+                                    // Due to potential races with a job's natural completion, it's
+                                    // reasonable to expect the termination call to fail. Hence,
+                                    // not logging as an error.
+                                    console.warn("Failed to send termination signal to job. Error: " + error.message, job);
+                                }
+                            }
+                        }
+                        catch (e_1_1) { e_1 = { error: e_1_1 }; }
+                        finally {
+                            try {
+                                if (_b && !_b.done && (_c = _a.return)) _c.call(_a);
+                            }
+                            finally { if (e_1) throw e_1.error; }
+                        }
+                        // Use `allSettled()` because we want to wait for all to finish. We do
+                        // not want to stop waiting if there is a failure.
+                        this._closingPromise = Promise.allSettled(Array.from(this.jobs).map(function (j) { return j.promise; }));
+                        return [4 /*yield*/, this._closingPromise];
+                    case 1:
+                        _d.sent();
+                        this._state = BackgroundProcessManagerState.Closed;
+                        _d.label = 2;
+                    case 2: return [2 /*return*/, this._closingPromise];
+                }
+            });
+        });
+    };
+    /**
+     * Signals the manager to start accepting work (again) and returns once
+     * the manager is ready to do so.
+     *
+     * If the state is already `Open`, this call is a no-op.
+     *
+     * If the state is `Closed`, this call simply updates state and returns.
+     *
+     * If the state is `Closing`, this call waits for completion before it
+     * updates the state and returns.
+     */
+    BackgroundProcessManager.prototype.open = function () {
+        return __awaiter(this, void 0, void 0, function () {
+            return __generator(this, function (_a) {
+                switch (_a.label) {
+                    case 0:
+                        if (!this.isClosing) return [3 /*break*/, 2];
+                        return [4 /*yield*/, this.close()];
+                    case 1:
+                        _a.sent();
+                        _a.label = 2;
+                    case 2:
+                        this._state = BackgroundProcessManagerState.Open;
+                        return [2 /*return*/];
+                }
+            });
+        });
+    };
+    return BackgroundProcessManager;
+}());
+export { BackgroundProcessManager };
+/**
+ *
+ */
+var BackgroundManagerNotOpenError = /** @class */ (function (_super) {
+    __extends(BackgroundManagerNotOpenError, _super);
+    function BackgroundManagerNotOpenError(message) {
+        return _super.call(this, "BackgroundManagerNotOpenError: " + message) || this;
+    }
+    return BackgroundManagerNotOpenError;
+}(Error));
+export { BackgroundManagerNotOpenError };
+/**
+ * All possible states a `BackgroundProcessManager` instance can be in.
+ */
+export var BackgroundProcessManagerState;
+(function (BackgroundProcessManagerState) {
+    /**
+     * Accepting new jobs.
+     */
+    BackgroundProcessManagerState["Open"] = "Open";
+    /**
+     * Not accepting new jobs. Waiting for submitted jobs to complete.
+     */
+    BackgroundProcessManagerState["Closing"] = "Closing";
+    /**
+     * Not accepting new jobs. All submitted jobs are complete.
+     */
+    BackgroundProcessManagerState["Closed"] = "Closed";
+})(BackgroundProcessManagerState || (BackgroundProcessManagerState = {}));
+//# sourceMappingURL=BackgroundProcessManager.js.map

package/lib-esm/Util/BackgroundProcessManager.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"BackgroundProcessManager.js","sourceRoot":"","sources":["../../src/Util/BackgroundProcessManager.ts"],"names":[],"mappings":";AAAA;;;;;;;;;GASG;AACH;IAeC;;;;OAIG;IACH;QAnBA;;;;WAIG;QACK,WAAM,GAAG,6BAA6B,CAAC,IAAI,CAAC;QAIpD;;WAEG;QACK,SAAI,GAAG,IAAI,GAAG,EAAY,CAAC;IAOpB,CAAC;IAyDhB,sCAAG,GAAH,UAAI,gBAAiB,EAAE,mBAAoB;QAC1C,IAAI,GAAG,CAAC;QACR,IAAI,WAAmB,CAAC;QAExB,IAAI,OAAO,gBAAgB,KAAK,QAAQ,EAAE;YACzC,GAAG,GAAG,SAAS,CAAC;YAChB,WAAW,GAAG,gBAAgB,CAAC;SAC/B;aAAM;YACN,GAAG,GAAG,gBAAgB,CAAC;YACvB,WAAW,GAAG,mBAAmB,CAAC;SAClC;QAED,IAAM,KAAK,GAAG,IAAI,CAAC,aAAa,CAAC,WAAW,CAAC,CAAC;QAC9C,IAAI,KAAK;YAAE,OAAO,KAAK,CAAC;QAExB,IAAI,GAAG,KAAK,SAAS,EAAE;YACtB,OAAO,IAAI,CAAC,OAAO,CAAC,WAAW,CAAC,CAAC;SACjC;aAAM,IAAI,OAAO,GAAG,KAAK,UAAU,EAAE;YACrC,OAAO,IAAI,CAAC,WAAW,CAAC,GAAG,EAAE,WAAW,CAAC,CAAC;SAC1C;aAAM,IAAI,GAAG,YAAY,wBAAwB,EAAE;YACnD,OAAO,IAAI,CAAC,UAAU,CAAC,GAAG,EAAE,WAAW,CAAC,CAAC;SACzC;aAAM;YACN,MAAM,IAAI,KAAK,CACd,wFAAwF,CACxF,CAAC;SACF;IACF,CAAC;IAED;;;;;;;;;OASG;IACH,6CAAU,GAAV,UACC,KAAuB,EACvB,WAAoB;QAFrB,iBAcC;QAVM,IAAA,8BAAoD,EAAlD,oBAAO,EAAE,4BAAyC,CAAC;QAE3D,IAAM,KAAK,GAAG;;;4BACb,qBAAM,KAAK,EAAE,EAAA;;wBAAb,SAAa,CAAC;wBACd,OAAO,EAAE,CAAC;;;;aACV,CAAC;QAEF,WAAW,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QAExB,OAAO,KAAK,CAAC;IACd,CAAC;IAUO,8CAAW,GAAnB,UAAoB,GAAG,EAAE,WAAW;QACnC,kEAAkE;QAClE,IAAI,SAAS,CAAC;QAEd,iEAAiE;QACjE,IAAM,WAAW,GAAG,IAAI,OAAO,CAAC,UAAA,OAAO;YACtC,SAAS,GAAG,OAAO,CAAC;QACrB,CAAC,CAAC,CAAC;QAEH,0BAA0B;QAC1B,IAAM,SAAS,GAAG,GAAG,CAAC,WAAW,CAAC,CAAC;QAEnC,4DAA4D;QAC5D,oCAAoC;QACpC,IAAI,QAAO,SAAS,aAAT,SAAS,uBAAT,SAAS,CAAE,IAAI,CAAA,KAAK,UAAU,EAAE;YAC1C,IAAI,CAAC,eAAe,CAAC,SAAS,EAAE,SAAS,EAAE,WAAW,CAAC,CAAC;SACxD;QAED,qEAAqE;QACrE,kEAAkE;QAClE,UAAU;QACV,OAAO,SAAS,CAAC;IAClB,CAAC;IAEO,6CAAU,GAAlB,UAAmB,OAAiC,EAAE,WAAoB;QAA1E,iBAEC;QADA,IAAI,CAAC,UAAU,CAAC;;wBAAY,qBAAM,OAAO,CAAC,KAAK,EAAE,EAAA;wBAArB,sBAAA,SAAqB,EAAA;;iBAAA,EAAE,WAAW,CAAC,CAAC;IACjE,CAAC;IAED;;;;;;;;;OASG;IACK,0CAAO,GAAf,UAAgB,WAAoB;QACnC,qEAAqE;QACrE,wBAAwB;QACxB,IAAI,OAAmC,CAAC;QACxC,IAAI,MAA+B,CAAC;QAEpC,kEAAkE;QAClE,qBAAqB;QACrB,IAAM,OAAO,GAAG,IAAI,OAAO,CAAC,UAAC,GAAG,EAAE,GAAG;YACpC,OAAO,GAAG,GAAG,CAAC;YACd,MAAM,GAAG,GAAG,CAAC;QACd,CAAC,CAAC,CAAC;QAEH,kEAAkE;QAClE,IAAI,SAAS,CAAC;QAEd,iEAAiE;QACjE,IAAM,WAAW,GAAG,IAAI,OAAO,CAAC,UAAA,gBAAgB;YAC/C,SAAS,GAAG,gBAAgB,CAAC;QAC9B,CAAC,CAAC,CAAC;QAEH,IAAI,CAAC,eAAe,CAAC,OAAO,EAAE,SAAS,EAAE,WAAW,CAAC,CAAC;QAEtD,OAAO;YACN,OAAO,SAAA;YACP,MAAM,QAAA;YACN,WAAW,aAAA;SACX,CAAC;IACH,CAAC;IAED;;;;;;;;;;OAUG;IACK,kDAAe,GAAvB,UACC,OAAU,EACV,SAAqB,EACrB,WAAoB;QAHrB,iBA0BC;QArBA,IAAM,QAAQ,GAAG,EAAE,OAAO,SAAA,EAAE,SAAS,WAAA,EAAE,WAAW,aAAA,EAAE,CAAC;QACrD,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;QAExB,oEAAoE;QACpE,sEAAsE;QACtE,+DAA+D;QAC/D,sEAAsE;QAEtE,EAAE;QACF,iCAAiC;QACjC,EAAE;QACF,sEAAsE;QACtE,uEAAuE;QACvE,qDAAqD;QACrD,OAAO;aACL,IAAI,CAAC;YACL,KAAI,CAAC,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC;QAC5B,CAAC,CAAC;aACD,KAAK,CAAC;YACN,KAAI,CAAC,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC;QAC5B,CAAC,CAAC,CAAC;IACL,CAAC;IAUD,sBAAI,4CAAM;QARV;;;;;;;WAOG;aACH;YACC,OAAO,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC;QACvB,CAAC;;;OAAA;IASD,sBAAI,2CAAK;QAPT;;;;;;WAMG;aACH;YACC,OAAO,IAAI,CAAC,MAAM,CAAC;QACpB,CAAC;;;OAAA;IAOD,sBAAI,6CAAO;QALX;;;;WAIG;aACH;YACC,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,GAAG,CAAC,UAAA,GAAG,IAAI,OAAA,GAAG,CAAC,WAAW,EAAf,CAAe,CAAC,CAAC;QAC1D,CAAC;;;OAAA;IAKD,sBAAI,4CAAM;QAHV;;WAEG;aACH;YACC,OAAO,IAAI,CAAC,MAAM,KAAK,6BAA6B,CAAC,IAAI,CAAC;QAC3D,CAAC;;;OAAA;IAMD,sBAAI,+CAAS;QAJb;;;WAGG;aACH;YACC,OAAO,IAAI,CAAC,MAAM,KAAK,6BAA6B,CAAC,OAAO,CAAC;QAC9D,CAAC;;;OAAA;IAMD,sBAAI,8CAAQ;QAJZ;;;WAGG;aACH;YACC,OAAO,IAAI,CAAC,MAAM,KAAK,6BAA6B,CAAC,MAAM,CAAC;QAC7D,CAAC;;;OAAA;IAEO,gDAAa,GAArB,UAAsB,WAAmB;QACxC,IAAI,CAAC,IAAI,CAAC,MAAM,EAAE;YACjB,OAAO,OAAO,CAAC,MAAM,CACpB,IAAI,6BAA6B,CAChC;gBACC,oBAAkB,IAAI,CAAC,KAAK,MAAG;gBAC/B,wBAAqB,WAAW,QAAI;gBACpC,sBAAoB,IAAI,CAAC,OAAO;qBAC9B,GAAG,CAAC,UAAA,CAAC,IAAI,OAAA,MAAM,GAAG,CAAC,EAAV,CAAU,CAAC;qBACpB,IAAI,CAAC,KAAK,CAAC,QAAK;aAClB,CAAC,IAAI,CAAC,IAAI,CAAC,CACZ,CACD,CAAC;SACF;IACF,CAAC;IAED;;;;;;;;;;;;;;;;OAgBG;IACG,wCAAK,GAAX;;;;;;;6BACK,IAAI,CAAC,MAAM,EAAX,wBAAW;wBACd,IAAI,CAAC,MAAM,GAAG,6BAA6B,CAAC,OAAO,CAAC;;4BACpD,KAAkB,KAAA,SAAA,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,CAAA,4CAAE;gCAA9B,GAAG;gCACb,IAAI;oCACH,GAAG,CAAC,SAAS,EAAE,CAAC;iCAChB;gCAAC,OAAO,KAAK,EAAE;oCACf,+DAA+D;oCAC/D,4DAA4D;oCAC5D,2BAA2B;oCAC3B,OAAO,CAAC,IAAI,CACX,sDAAoD,KAAK,CAAC,OAAS,EACnE,GAAG,CACH,CAAC;iCACF;6BACD;;;;;;;;;wBAED,sEAAsE;wBACtE,kDAAkD;wBAClD,IAAI,CAAC,eAAe,GAAG,OAAO,CAAC,UAAU,CACxC,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,GAAG,CAAC,UAAA,CAAC,IAAI,OAAA,CAAC,CAAC,OAAO,EAAT,CAAS,CAAC,CACzC,CAAC;wBAEF,qBAAM,IAAI,CAAC,eAAe,EAAA;;wBAA1B,SAA0B,CAAC;wBAC3B,IAAI,CAAC,MAAM,GAAG,6BAA6B,CAAC,MAAM,CAAC;;4BAGpD,sBAAO,IAAI,CAAC,eAAsB,EAAC;;;;KACnC;IAED;;;;;;;;;;OAUG;IACG,uCAAI,GAAV;;;;;6BACK,IAAI,CAAC,SAAS,EAAd,wBAAc;wBACjB,qBAAM,IAAI,CAAC,KAAK,EAAE,EAAA;;wBAAlB,SAAkB,CAAC;;;wBAGpB,IAAI,CAAC,MAAM,GAAG,6BAA6B,CAAC,IAAI,CAAC;;;;;KACjD;IACF,+BAAC;AAAD,CAAC,AA9XD,IA8XC;;AAED;;GAEG;AACH;IAAmD,iDAAK;IACvD,uCAAY,OAAe;eAC1B,kBAAM,oCAAkC,OAAS,CAAC;IACnD,CAAC;IACF,oCAAC;AAAD,CAAC,AAJD,CAAmD,KAAK,GAIvD;;AAED;;GAEG;AACH,MAAM,CAAN,IAAY,6BAeX;AAfD,WAAY,6BAA6B;IACxC;;OAEG;IACH,8CAAa,CAAA;IAEb;;OAEG;IACH,oDAAmB,CAAA;IAEnB;;OAEG;IACH,kDAAiB,CAAA;AAClB,CAAC,EAfW,6BAA6B,KAA7B,6BAA6B,QAexC"}

package/lib-esm/Util/DateUtils.js

@@ -4,22 +4,7 @@
  *
  * @see https://github.com/aws/aws-sdk-js/blob/6edf586dcc1de7fe8fbfbbd9a0d2b1847921e6e1/lib/util.js#L262
  */
-var __read = (this && this.__read) || function (o, n) {
-    var m = typeof Symbol === "function" && o[Symbol.iterator];
-    if (!m) return o;
-    var i = m.call(o), r, ar = [], e;
-    try {
-        while ((n === void 0 || n-- > 0) && !(r = i.next()).done) ar.push(r.value);
-    }
-    catch (error) { e = { error: error }; }
-    finally {
-        try {
-            if (r && !r.done && (m = i["return"])) m.call(i);
-        }
-        finally { if (e) throw e.error; }
-    }
-    return ar;
-};
+import { __read } from "tslib";
 // Comment - TODO: remove
 var FIVE_MINUTES_IN_MS = 1000 * 60 * 5;
 export var DateUtils = {

package/lib-esm/Util/DateUtils.js.map

@@ -1 +1 @@
-{"version":3,"file":"DateUtils.js","sourceRoot":"","sources":["../../src/Util/DateUtils.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;;;;;;;;;;;;;;;;;AAEH,yBAAyB;AAEzB,IAAM,kBAAkB,GAAG,IAAI,GAAG,EAAE,GAAG,CAAC,CAAC;AAEzC,MAAM,CAAC,IAAM,SAAS,GAAG;IACxB;;OAEG;IACH,WAAW,EAAE,CAAC;IAEd,sBAAsB;QACrB,IAAI,SAAS,CAAC,WAAW,EAAE;YAC1B,OAAO,IAAI,IAAI,CAAC,IAAI,IAAI,EAAE,CAAC,OAAO,EAAE,GAAG,SAAS,CAAC,WAAW,CAAC,CAAC;SAC9D;aAAM;YACN,OAAO,IAAI,IAAI,EAAE,CAAC;SAClB;IACF,CAAC;IAED;;OAEG;IACH,cAAc;QACb,OAAO,SAAS,CAAC,WAAW,CAAC;IAC9B,CAAC;IAED,uBAAuB,EAAvB,UAAwB,IAA+C;QAA/C,qBAAA,EAAA,OAAa,SAAS,CAAC,sBAAsB,EAAE;QACtE,OAAO,IAAI,CAAC,WAAW,EAAE,CAAC,OAAO,CAAC,gBAAgB,EAAE,EAAE,CAAC,CAAC;IACzD,CAAC;IAED,uBAAuB,EAAvB,UAAwB,MAAc;QAC/B,IAAA,8EAEL,EAFQ,YAAI,EAAE,aAAK,EAAE,WAAG,EAAE,YAAI,EAAE,cAAM,EAAE,cAExC,CAAC;QAEF,OAAO,IAAI,IAAI,CACd,IAAI,CAAC,GAAG,CACP,MAAM,CAAC,IAAI,CAAC,EACZ,MAAM,CAAC,KAAK,CAAC,GAAG,CAAC,EACjB,MAAM,CAAC,GAAG,CAAC,EACX,MAAM,CAAC,IAAI,CAAC,EACZ,MAAM,CAAC,MAAM,CAAC,EACd,MAAM,CAAC,MAAM,CAAC,CACd,CACD,CAAC;IACH,CAAC;IAED,aAAa,EAAb,UAAc,UAAgB;QAC7B,2EAA2E;QAC3E,OAAO,CACN,IAAI,CAAC,GAAG,CACP,UAAU,CAAC,OAAO,EAAE,GAAG,SAAS,CAAC,sBAAsB,EAAE,CAAC,OAAO,EAAE,CACnE,IAAI,kBAAkB,CACvB,CAAC;IACH,CAAC;IAED,gBAAgB,EAAhB,UAAiB,KAAU;QAC1B,IAAI,CAAC,KAAK,CAAC,QAAQ,IAAI,CAAC,KAAK,CAAC,QAAQ,CAAC,OAAO,EAAE;YAC/C,OAAO,KAAK,CAAC;SACb;QAEO,IAAA,gCAAO,CAAoB;QAEnC,OAAO,OAAO,CACb,CAAC,qBAAqB,EAAE,2BAA2B,CAAC,CAAC,QAAQ,CAC5D,OAAO,CAAC,kBAAkB,CAAC,CAC3B;YACA,CAAC,OAAO,CAAC,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC,CAC/B,CAAC;IACH,CAAC;IAED;;OAEG;IACH,cAAc,EAAd,UAAe,MAAc;QAC5B,SAAS,CAAC,WAAW,GAAG,MAAM,CAAC;IAChC,CAAC;CACD,CAAC"}
+{"version":3,"file":"DateUtils.js","sourceRoot":"","sources":["../../src/Util/DateUtils.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;;AAEH,yBAAyB;AAEzB,IAAM,kBAAkB,GAAG,IAAI,GAAG,EAAE,GAAG,CAAC,CAAC;AAEzC,MAAM,CAAC,IAAM,SAAS,GAAG;IACxB;;OAEG;IACH,WAAW,EAAE,CAAC;IAEd,sBAAsB;QACrB,IAAI,SAAS,CAAC,WAAW,EAAE;YAC1B,OAAO,IAAI,IAAI,CAAC,IAAI,IAAI,EAAE,CAAC,OAAO,EAAE,GAAG,SAAS,CAAC,WAAW,CAAC,CAAC;SAC9D;aAAM;YACN,OAAO,IAAI,IAAI,EAAE,CAAC;SAClB;IACF,CAAC;IAED;;OAEG;IACH,cAAc;QACb,OAAO,SAAS,CAAC,WAAW,CAAC;IAC9B,CAAC;IAED,uBAAuB,EAAvB,UAAwB,IAA+C;QAA/C,qBAAA,EAAA,OAAa,SAAS,CAAC,sBAAsB,EAAE;QACtE,OAAO,IAAI,CAAC,WAAW,EAAE,CAAC,OAAO,CAAC,gBAAgB,EAAE,EAAE,CAAC,CAAC;IACzD,CAAC;IAED,uBAAuB,EAAvB,UAAwB,MAAc;QAC/B,IAAA,8EAEL,EAFQ,YAAI,EAAE,aAAK,EAAE,WAAG,EAAE,YAAI,EAAE,cAAM,EAAE,cAExC,CAAC;QAEF,OAAO,IAAI,IAAI,CACd,IAAI,CAAC,GAAG,CACP,MAAM,CAAC,IAAI,CAAC,EACZ,MAAM,CAAC,KAAK,CAAC,GAAG,CAAC,EACjB,MAAM,CAAC,GAAG,CAAC,EACX,MAAM,CAAC,IAAI,CAAC,EACZ,MAAM,CAAC,MAAM,CAAC,EACd,MAAM,CAAC,MAAM,CAAC,CACd,CACD,CAAC;IACH,CAAC;IAED,aAAa,EAAb,UAAc,UAAgB;QAC7B,2EAA2E;QAC3E,OAAO,CACN,IAAI,CAAC,GAAG,CACP,UAAU,CAAC,OAAO,EAAE,GAAG,SAAS,CAAC,sBAAsB,EAAE,CAAC,OAAO,EAAE,CACnE,IAAI,kBAAkB,CACvB,CAAC;IACH,CAAC;IAED,gBAAgB,EAAhB,UAAiB,KAAU;QAC1B,IAAI,CAAC,KAAK,CAAC,QAAQ,IAAI,CAAC,KAAK,CAAC,QAAQ,CAAC,OAAO,EAAE;YAC/C,OAAO,KAAK,CAAC;SACb;QAEO,IAAA,gCAAO,CAAoB;QAEnC,OAAO,OAAO,CACb,CAAC,qBAAqB,EAAE,2BAA2B,CAAC,CAAC,QAAQ,CAC5D,OAAO,CAAC,kBAAkB,CAAC,CAC3B;YACA,CAAC,OAAO,CAAC,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC,CAC/B,CAAC;IACH,CAAC;IAED;;OAEG;IACH,cAAc,EAAd,UAAe,MAAc;QAC5B,SAAS,CAAC,WAAW,GAAG,MAAM,CAAC;IAChC,CAAC;CACD,CAAC"}

package/lib-esm/Util/Reachability.js

@@ -1,14 +1,4 @@
-var __values = (this && this.__values) || function(o) {
-    var s = typeof Symbol === "function" && Symbol.iterator, m = s && o[s], i = 0;
-    if (m) return m.call(o);
-    if (o && typeof o.length === "number") return {
-        next: function () {
-            if (o && i >= o.length) o = void 0;
-            return { value: o && o[i++], done: !o };
-        }
-    };
-    throw new TypeError(s ? "Object is not iterable." : "Symbol.iterator is not defined.");
-};
+import { __values } from "tslib";
 import { browserOrNode, isWebWorker } from '@aws-amplify/core';
 import Observable from 'zen-observable-ts';
 var ReachabilityNavigator = /** @class */ (function () {

package/lib-esm/Util/Reachability.js.map

@@ -1 +1 @@
-{"version":3,"file":"Reachability.js","sourceRoot":"","sources":["../../src/Util/Reachability.ts"],"names":[],"mappings":";;;;;;;;;;;AAAA,OAAO,EAAE,aAAa,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAC/D,OAAO,UAA6B,MAAM,mBAAmB,CAAC;AAM9D;IAAA;IA8CA,CAAC;IAzCA,8CAAc,GAAd,UAAe,OAAa;QAC3B,IAAI,aAAa,EAAE,CAAC,MAAM,EAAE;YAC3B,OAAO,UAAU,CAAC,IAAI,CAAC,CAAC,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC;SAC3C;QAED,IAAM,SAAS,GAAG,WAAW,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,MAAM,CAAC;QAEhD,OAAO,IAAI,UAAU,CAAC,UAAA,QAAQ;YAC7B,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,EAAE,SAAS,CAAC,SAAS,CAAC,MAAM,EAAE,CAAC,CAAC;YAEtD,IAAM,YAAY,GAAG,cAAM,OAAA,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC,EAA/B,CAA+B,CAAC;YAC3D,IAAM,aAAa,GAAG,cAAM,OAAA,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC,EAAhC,CAAgC,CAAC;YAE7D,SAAS,CAAC,gBAAgB,CAAC,QAAQ,EAAE,YAAY,CAAC,CAAC;YACnD,SAAS,CAAC,gBAAgB,CAAC,SAAS,EAAE,aAAa,CAAC,CAAC;YAErD,qBAAqB,CAAC,UAAU,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;YAEhD,OAAO;gBACN,SAAS,CAAC,mBAAmB,CAAC,QAAQ,EAAE,YAAY,CAAC,CAAC;gBACtD,SAAS,CAAC,mBAAmB,CAAC,SAAS,EAAE,aAAa,CAAC,CAAC;gBAExD,qBAAqB,CAAC,UAAU,GAAG,qBAAqB,CAAC,UAAU,CAAC,MAAM,CACzE,UAAA,SAAS,IAAI,OAAA,SAAS,KAAK,QAAQ,EAAtB,CAAsB,CACnC,CAAC;YACH,CAAC,CAAC;QACH,CAAC,CAAC,CAAC;IACJ,CAAC;IAED,oEAAoE;IACrD,uCAAiB,GAAhC,UAAiC,MAAqB;;gCAC1C,QAAQ;YAClB,IAAI,QAAQ,CAAC,MAAM,EAAE;gBACpB,qBAAqB,CAAC,UAAU,GAAG,qBAAqB,CAAC,UAAU,CAAC,MAAM,CACzE,UAAA,SAAS,IAAI,OAAA,SAAS,KAAK,QAAQ,EAAtB,CAAsB,CACnC,CAAC;;aAEF;YACD,QAAQ,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;;;YAPvB,KAAuB,IAAA,KAAA,SAAA,qBAAqB,CAAC,UAAU,CAAA,gBAAA;gBAAlD,IAAM,QAAQ,WAAA;wBAAR,QAAQ;aAQlB;;;;;;;;;IACF,CAAC;IA5Cc,gCAAU,GAErB,EAAE,CAAC;IA2CR,4BAAC;CAAA,AA9CD,IA8CC;eA9CoB,qBAAqB"}
+{"version":3,"file":"Reachability.js","sourceRoot":"","sources":["../../src/Util/Reachability.ts"],"names":[],"mappings":";AAAA,OAAO,EAAE,aAAa,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAC/D,OAAO,UAA6B,MAAM,mBAAmB,CAAC;AAM9D;IAAA;IA8CA,CAAC;IAzCA,8CAAc,GAAd,UAAe,OAAa;QAC3B,IAAI,aAAa,EAAE,CAAC,MAAM,EAAE;YAC3B,OAAO,UAAU,CAAC,IAAI,CAAC,CAAC,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC;SAC3C;QAED,IAAM,SAAS,GAAG,WAAW,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,MAAM,CAAC;QAEhD,OAAO,IAAI,UAAU,CAAC,UAAA,QAAQ;YAC7B,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,EAAE,SAAS,CAAC,SAAS,CAAC,MAAM,EAAE,CAAC,CAAC;YAEtD,IAAM,YAAY,GAAG,cAAM,OAAA,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC,EAA/B,CAA+B,CAAC;YAC3D,IAAM,aAAa,GAAG,cAAM,OAAA,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC,EAAhC,CAAgC,CAAC;YAE7D,SAAS,CAAC,gBAAgB,CAAC,QAAQ,EAAE,YAAY,CAAC,CAAC;YACnD,SAAS,CAAC,gBAAgB,CAAC,SAAS,EAAE,aAAa,CAAC,CAAC;YAErD,qBAAqB,CAAC,UAAU,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;YAEhD,OAAO;gBACN,SAAS,CAAC,mBAAmB,CAAC,QAAQ,EAAE,YAAY,CAAC,CAAC;gBACtD,SAAS,CAAC,mBAAmB,CAAC,SAAS,EAAE,aAAa,CAAC,CAAC;gBAExD,qBAAqB,CAAC,UAAU,GAAG,qBAAqB,CAAC,UAAU,CAAC,MAAM,CACzE,UAAA,SAAS,IAAI,OAAA,SAAS,KAAK,QAAQ,EAAtB,CAAsB,CACnC,CAAC;YACH,CAAC,CAAC;QACH,CAAC,CAAC,CAAC;IACJ,CAAC;IAED,oEAAoE;IACrD,uCAAiB,GAAhC,UAAiC,MAAqB;;gCAC1C,QAAQ;YAClB,IAAI,QAAQ,CAAC,MAAM,EAAE;gBACpB,qBAAqB,CAAC,UAAU,GAAG,qBAAqB,CAAC,UAAU,CAAC,MAAM,CACzE,UAAA,SAAS,IAAI,OAAA,SAAS,KAAK,QAAQ,EAAtB,CAAsB,CACnC,CAAC;;aAEF;YACD,QAAQ,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;;;YAPvB,KAAuB,IAAA,KAAA,SAAA,qBAAqB,CAAC,UAAU,CAAA,gBAAA;gBAAlD,IAAM,QAAQ,WAAA;wBAAR,QAAQ;aAQlB;;;;;;;;;IACF,CAAC;IA5Cc,gCAAU,GAErB,EAAE,CAAC;IA2CR,4BAAC;CAAA,AA9CD,IA8CC;eA9CoB,qBAAqB"}

package/lib-esm/Util/Retry.d.ts

@@ -8,7 +8,7 @@ export declare const isNonRetryableError: (obj: any) => obj is NonRetryableError
  * @private
  * Internal use of Amplify only
  */
-export declare function retry(functionToRetry: Function, args: any[], delayFn: DelayFunction, attempt?: number): any;
+export declare function retry<T>(functionToRetry: (...args: any[]) => T, args: any[], delayFn: DelayFunction, onTerminate?: Promise<void>): Promise<T>;
 /**
  * @private
  * Internal use of Amplify only
@@ -18,4 +18,4 @@ export declare function jitteredBackoff(maxDelayMs?: number): DelayFunction;
  * @private
  * Internal use of Amplify only
  */
-export declare const jitteredExponentialRetry: (functionToRetry: Function, args: any[], maxDelayMs?: number) => any;
+export declare const jitteredExponentialRetry: <T>(functionToRetry: (...args: any[]) => T, args: any[], maxDelayMs?: number, onTerminate?: Promise<void>) => Promise<T>;