@aws-amplify/core 4.6.2-next.20 → 4.6.2-next.36

package/lib/Util/BackgroundProcessManager.d.ts

@@ -0,0 +1,204 @@
+/**
+ * @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.
+ */
+export declare class 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").
+     */
+    private _state;
+    private _closingPromise;
+    /**
+     * The list of outstanding jobs we'll need to wait for upon `close()`
+     */
+    private jobs;
+    /**
+     * 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.
+     */
+    constructor();
+    /**
+     * Executes an async `job` function, passing the return value through to
+     * the caller, registering it as a running job in the manager. When the
+     * manager *closes*, it will `await` the job.
+     *
+     * @param job The function to execute.
+     * @param description Optional description to help identify pending jobs.
+     * @returns The return value from the given function.
+     */
+    add<T>(job: () => Promise<T>, description?: string): Promise<T>;
+    /**
+     * Executes an async `job` function, passing the return value through to
+     * the caller, registering it as a running job in the manager. When the
+     * manager *closes*, it will request termination by resolving the
+     * provided `onTerminate` promise. It will then `await` the job, so it is
+     * important that the job still `resolve()` or `reject()` when responding
+     * to a termination request.
+     *
+     * @param job The function to execute.
+     * @param description Optional description to help identify pending jobs.
+     * @returns The return value from the given function.
+     */
+    add<T>(job: (onTerminate: Promise<void>) => Promise<T>, description?: string): Promise<T>;
+    /**
+     * Create a no-op job, registers it with the manager, and returns hooks
+     * to the caller to signal the job's completion and respond to termination
+     * requests.
+     *
+     * When the manager closes, the no-op job will be `await`-ed, so its
+     * important to always `resolve()` or `reject()` when done responding to an
+     * `onTerminate` signal.
+     * @param description Optional description to help identify pending jobs.
+     * @returns Job promise hooks + onTerminate signaling promise
+     */
+    add(description?: string): {
+        resolve: (value?: unknown) => void;
+        reject: (reason?: any) => void;
+        onTerminate: Promise<void>;
+    };
+    /**
+     * Adds another job manager to await on at the time of closing. the inner
+     * manager's termination is signaled when this manager's `close()` is
+     * called for.
+     *
+     * @param job The inner job manager to await.
+     * @param description Optional description to help identify pending jobs.
+     */
+    add(job: BackgroundProcessManager, description?: string): any;
+    /**
+     * 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.
+     */
+    addCleaner<T>(clean: () => Promise<T>, description?: string): () => Promise<void>;
+    private addFunction;
+    private addManager;
+    /**
+     * 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 }`
+     */
+    private addHook;
+    /**
+     * 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.
+     */
+    private registerPromise;
+    /**
+     * 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 length(): number;
+    /**
+     * 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 state(): BackgroundProcessManagerState;
+    /**
+     * The registered `description` of all still-pending jobs.
+     *
+     * @returns descriptions as an array.
+     */
+    get pending(): string[];
+    /**
+     * Whether the manager is accepting new jobs.
+     */
+    get isOpen(): boolean;
+    /**
+     * Whether the manager is rejecting new work, but still waiting for
+     * submitted work to complete.
+     */
+    get isClosing(): boolean;
+    /**
+     * Whether the manager is rejecting work and done waiting for submitted
+     * work to complete.
+     */
+    get isClosed(): boolean;
+    private closedFailure;
+    /**
+     * 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.
+     */
+    close(): Promise<any>;
+    /**
+     * 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.
+     */
+    open(): Promise<void>;
+}
+/**
+ *
+ */
+export declare class BackgroundManagerNotOpenError extends Error {
+    constructor(message: string);
+}
+/**
+ * All possible states a `BackgroundProcessManager` instance can be in.
+ */
+export declare enum BackgroundProcessManagerState {
+    /**
+     * Accepting new jobs.
+     */
+    Open = "Open",
+    /**
+     * Not accepting new jobs. Waiting for submitted jobs to complete.
+     */
+    Closing = "Closing",
+    /**
+     * Not accepting new jobs. All submitted jobs are complete.
+     */
+    Closed = "Closed"
+}

package/lib/Util/BackgroundProcessManager.js

@@ -0,0 +1,385 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+var tslib_1 = require("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 tslib_1.__awaiter(_this, void 0, void 0, function () {
+            return tslib_1.__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 tslib_1.__awaiter(_this, void 0, void 0, function () { return tslib_1.__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 tslib_1.__awaiter(this, void 0, void 0, function () {
+            var _a, _b, job;
+            var e_1, _c;
+            return tslib_1.__generator(this, function (_d) {
+                switch (_d.label) {
+                    case 0:
+                        if (!this.isOpen) return [3 /*break*/, 2];
+                        this._state = BackgroundProcessManagerState.Closing;
+                        try {
+                            for (_a = tslib_1.__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 tslib_1.__awaiter(this, void 0, void 0, function () {
+            return tslib_1.__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;
+}());
+exports.BackgroundProcessManager = BackgroundProcessManager;
+/**
+ *
+ */
+var BackgroundManagerNotOpenError = /** @class */ (function (_super) {
+    tslib_1.__extends(BackgroundManagerNotOpenError, _super);
+    function BackgroundManagerNotOpenError(message) {
+        return _super.call(this, "BackgroundManagerNotOpenError: " + message) || this;
+    }
+    return BackgroundManagerNotOpenError;
+}(Error));
+exports.BackgroundManagerNotOpenError = BackgroundManagerNotOpenError;
+/**
+ * All possible states a `BackgroundProcessManager` instance can be in.
+ */
+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 = exports.BackgroundProcessManagerState || (exports.BackgroundProcessManagerState = {}));
+//# sourceMappingURL=BackgroundProcessManager.js.map

package/lib/Util/BackgroundProcessManager.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"BackgroundProcessManager.js","sourceRoot":"","sources":["../../src/Util/BackgroundProcessManager.ts"],"names":[],"mappings":"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"}

package/lib/Util/Constants.js

@@ -1,6 +1,6 @@
 "use strict";
 /*
- * Copyright 2017-2019 Amazon.com, Inc. or its affiliates. All Rights Reserved.
+ * Copyright 2017-2022 Amazon.com, Inc. or its affiliates. All Rights Reserved.
  *
  * Licensed under the Apache License, Version 2.0 (the "License"). You may not use this file except in compliance with
  * the License. A copy of the License is located at

package/lib/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>;