@aws-amplify/core 6.0.1-api-v6-models.9351bcf.0 → 6.0.1-api-v6-models.891fe0d.0

package/lib/BackgroundProcessManager/BackgroundManagerNotOpenError.js

@@ -1,28 +1,11 @@
 "use strict";
 // Copyright Amazon.com, Inc. or its affiliates. All Rights Reserved.
 // SPDX-License-Identifier: Apache-2.0
-var __extends = (this && this.__extends) || (function () {
-    var extendStatics = function (d, b) {
-        extendStatics = Object.setPrototypeOf ||
-            ({ __proto__: [] } instanceof Array && function (d, b) { d.__proto__ = b; }) ||
-            function (d, b) { for (var p in b) if (Object.prototype.hasOwnProperty.call(b, p)) d[p] = b[p]; };
-        return extendStatics(d, b);
-    };
-    return function (d, b) {
-        if (typeof b !== "function" && b !== null)
-            throw new TypeError("Class extends value " + String(b) + " is not a constructor or null");
-        extendStatics(d, b);
-        function __() { this.constructor = d; }
-        d.prototype = b === null ? Object.create(b) : (__.prototype = b.prototype, new __());
-    };
-})();
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.BackgroundManagerNotOpenError = void 0;
-var BackgroundManagerNotOpenError = /** @class */ (function (_super) {
-    __extends(BackgroundManagerNotOpenError, _super);
-    function BackgroundManagerNotOpenError(message) {
-        return _super.call(this, "BackgroundManagerNotOpenError: ".concat(message)) || this;
+class BackgroundManagerNotOpenError extends Error {
+    constructor(message) {
+        super(`BackgroundManagerNotOpenError: ${message}`);
     }
-    return BackgroundManagerNotOpenError;
-}(Error));
+}
 exports.BackgroundManagerNotOpenError = BackgroundManagerNotOpenError;

package/lib/BackgroundProcessManager/BackgroundProcessManager.js

@@ -1,57 +1,10 @@
 "use strict";
 // Copyright Amazon.com, Inc. or its affiliates. All Rights Reserved.
 // SPDX-License-Identifier: Apache-2.0
-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 (g && (g = 0, op[0] && (_ = 0)), _) 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 };
-    }
-};
-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.");
-};
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.BackgroundProcessManager = void 0;
-var BackgroundManagerNotOpenError_1 = require("./BackgroundManagerNotOpenError");
-var types_1 = require("./types");
+const BackgroundManagerNotOpenError_1 = require("./BackgroundManagerNotOpenError");
+const types_1 = require("./types");
 /**
  * @private For internal Amplify use.
  *
@@ -62,13 +15,13 @@ var types_1 = require("./types");
  * 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 () {
+class BackgroundProcessManager {
     /**
      * 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() {
+    constructor() {
         /**
          * A string indicating whether the manager is accepting new work ("Open"),
          * waiting for work to complete ("Closing"), or fully done with all
@@ -80,9 +33,9 @@ var BackgroundProcessManager = /** @class */ (function () {
          */
         this.jobs = new Set();
     }
-    BackgroundProcessManager.prototype.add = function (jobOrDescription, optionalDescription) {
-        var job;
-        var description;
+    add(jobOrDescription, optionalDescription) {
+        let job;
+        let description;
         if (typeof jobOrDescription === 'string') {
             job = undefined;
             description = jobOrDescription;
@@ -91,7 +44,7 @@ var BackgroundProcessManager = /** @class */ (function () {
             job = jobOrDescription;
             description = optionalDescription;
         }
-        var error = this.closedFailure(description);
+        const error = this.closedFailure(description);
         if (error)
             return error;
         if (job === undefined) {
@@ -106,7 +59,7 @@ var BackgroundProcessManager = /** @class */ (function () {
         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
@@ -117,51 +70,37 @@ var BackgroundProcessManager = /** @class */ (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*/];
-                }
-            });
-        }); };
+    addCleaner(clean, description) {
+        const { resolve, onTerminate } = this.addHook(description);
+        const proxy = async () => {
+            await clean();
+            resolve();
+        };
         onTerminate.then(proxy);
         return proxy;
-    };
-    BackgroundProcessManager.prototype.addFunction = function (job, description) {
+    }
+    addFunction(job, description) {
         // the function we call when we want to try to terminate this job.
-        var terminate;
+        let terminate;
         // the promise the job can opt into listening to for termination.
-        var onTerminate = new Promise(function (resolve) {
+        const onTerminate = new Promise(resolve => {
             terminate = resolve;
         });
         // finally! start the job.
-        var jobResult = job(onTerminate);
+        const 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') {
+        if (typeof 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);
-    };
+    }
+    addManager(manager, description) {
+        this.addCleaner(async () => await manager.close(), description);
+    }
     /**
      * Creates and registers a fabricated job for processes that need to operate
      * with callbacks/hooks. The returned `resolve` and `reject`
@@ -172,30 +111,30 @@ var BackgroundProcessManager = /** @class */ (function () {
      * @param description Optional description to help identify pending jobs.
      * @returns `{ resolve, reject, onTerminate }`
      */
-    BackgroundProcessManager.prototype.addHook = function (description) {
+    addHook(description) {
         // the resolve/reject functions we'll provide to the caller to signal
         // the state of the job.
-        var resolve;
-        var reject;
+        let resolve;
+        let reject;
         // the underlying promise we'll use to manage it, pretty much like
         // any other promise.
-        var promise = new Promise(function (res, rej) {
+        const promise = new Promise((res, rej) => {
             resolve = res;
             reject = rej;
         });
         // the function we call when we want to try to terminate this job.
-        var terminate;
+        let terminate;
         // the promise the job can opt into listening to for termination.
-        var onTerminate = new Promise(function (resolveTerminate) {
+        const onTerminate = new Promise(resolveTerminate => {
             terminate = resolveTerminate;
         });
         this.registerPromise(promise, terminate, description);
         return {
-            resolve: resolve,
-            reject: reject,
-            onTerminate: onTerminate,
+            resolve,
+            reject,
+            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"
@@ -207,9 +146,8 @@ var BackgroundProcessManager = /** @class */ (function () {
      * 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 };
+    registerPromise(promise, terminate, description) {
+        const jobEntry = { promise, terminate, 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
@@ -222,97 +160,73 @@ var BackgroundProcessManager = /** @class */ (function () {
         // `.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);
+            .then(() => {
+            this.jobs.delete(jobEntry);
         })
-            .catch(function () {
-            _this.jobs.delete(jobEntry);
+            .catch(() => {
+            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: false,
-        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: false,
-        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: false,
-        configurable: true
-    });
-    Object.defineProperty(BackgroundProcessManager.prototype, "isOpen", {
-        /**
-         * Whether the manager is accepting new jobs.
-         */
-        get: function () {
-            return this._state === types_1.BackgroundProcessManagerState.Open;
-        },
-        enumerable: false,
-        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 === types_1.BackgroundProcessManagerState.Closing;
-        },
-        enumerable: false,
-        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 === types_1.BackgroundProcessManagerState.Closed;
-        },
-        enumerable: false,
-        configurable: true
-    });
-    BackgroundProcessManager.prototype.closedFailure = function (description) {
+    }
+    /**
+     * 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() {
+        return this.jobs.size;
+    }
+    /**
+     * 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() {
+        return this._state;
+    }
+    /**
+     * The registered `description` of all still-pending jobs.
+     *
+     * @returns descriptions as an array.
+     */
+    get pending() {
+        return Array.from(this.jobs).map(job => job.description);
+    }
+    /**
+     * Whether the manager is accepting new jobs.
+     */
+    get isOpen() {
+        return this._state === types_1.BackgroundProcessManagerState.Open;
+    }
+    /**
+     * Whether the manager is rejecting new work, but still waiting for
+     * submitted work to complete.
+     */
+    get isClosing() {
+        return this._state === types_1.BackgroundProcessManagerState.Closing;
+    }
+    /**
+     * Whether the manager is rejecting work and done waiting for submitted
+     * work to complete.
+     */
+    get isClosed() {
+        return this._state === types_1.BackgroundProcessManagerState.Closed;
+    }
+    closedFailure(description) {
         if (!this.isOpen) {
             return Promise.reject(new BackgroundManagerNotOpenError_1.BackgroundManagerNotOpenError([
-                "The manager is ".concat(this.state, "."),
-                "You tried to add \"".concat(description, "\"."),
-                "Pending jobs: [\n".concat(this.pending
-                    .map(function (t) { return '    ' + t; })
-                    .join(',\n'), "\n]"),
+                `The manager is ${this.state}.`,
+                `You tried to add "${description}".`,
+                `Pending jobs: [\n${this.pending
+                    .map(t => '    ' + t)
+                    .join(',\n')}\n]`,
             ].join('\n')));
         }
-    };
+    }
     /**
      * Signals jobs to stop (for those that accept interruptions) and waits
      * for confirmation that jobs have stopped.
@@ -330,49 +244,28 @@ var BackgroundProcessManager = /** @class */ (function () {
      * 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 = types_1.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: ".concat(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 = types_1.BackgroundProcessManagerState.Closed;
-                        _d.label = 2;
-                    case 2: return [2 /*return*/, this._closingPromise];
+    async close() {
+        if (this.isOpen) {
+            this._state = types_1.BackgroundProcessManagerState.Closing;
+            for (const job of Array.from(this.jobs)) {
+                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);
+                }
+            }
+            // 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(j => j.promise));
+            await this._closingPromise;
+            this._state = types_1.BackgroundProcessManagerState.Closed;
+        }
+        return this._closingPromise;
+    }
     /**
      * Signals the manager to start accepting work (again) and returns once
      * the manager is ready to do so.
@@ -384,23 +277,11 @@ var BackgroundProcessManager = /** @class */ (function () {
      * 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 = types_1.BackgroundProcessManagerState.Open;
-                        return [2 /*return*/];
-                }
-            });
-        });
-    };
-    return BackgroundProcessManager;
-}());
+    async open() {
+        if (this.isClosing) {
+            await this.close();
+        }
+        this._state = types_1.BackgroundProcessManagerState.Open;
+    }
+}
 exports.BackgroundProcessManager = BackgroundProcessManager;