npm - @fluidframework/task-manager - Versions diffs - 2.0.0-internal.2.2.1 → 2.0.0-internal.2.3.1 - Mend

@fluidframework/task-manager 2.0.0-internal.2.2.1 → 2.0.0-internal.2.3.1

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (15) hide show

package/.eslintrc.js +19 -7
package/README.md +23 -4
package/dist/packageVersion.d.ts +1 -1
package/dist/packageVersion.js +1 -1
package/dist/packageVersion.js.map +1 -1
package/dist/taskManager.js +8 -8
package/dist/taskManager.js.map +1 -1
package/lib/packageVersion.d.ts +1 -1
package/lib/packageVersion.js +1 -1
package/lib/packageVersion.js.map +1 -1
package/lib/taskManager.js +8 -8
package/lib/taskManager.js.map +1 -1
package/package.json +17 -18
package/src/packageVersion.ts +1 -1
package/src/taskManager.ts +8 -8

package/.eslintrc.js CHANGED Viewed

@@ -4,11 +4,23 @@
  */
 module.exports = {
-    "extends": [
-        require.resolve("@fluidframework/eslint-config-fluid"),
-        "prettier"
-    ],
-    "parserOptions": {
-        "project": ["./tsconfig.json", "./src/test/tsconfig.json"]
+    extends: [require.resolve("@fluidframework/eslint-config-fluid/minimal"), "prettier"],
+    parserOptions: {
+        project: ["./tsconfig.json", "./src/test/tsconfig.json"],
     },
-}
+    rules: {
+        // This library is used in the browser, so we don't want dependencies on most node libraries.
+        "import/no-nodejs-modules": ["error", { allow: ["events"] }],
+    },
+    overrides: [
+        {
+            // Rules only for test files
+            files: ["*.spec.ts", "src/test/**"],
+            rules: {
+                // Test files are run in node only so additional node libraries can be used.
+                "import/no-nodejs-modules": ["error", { allow: ["assert", "events", "fs", "path"] }],
+            },
+        },
+    ],
+};

package/README.md CHANGED Viewed

@@ -1,8 +1,10 @@
 # @fluidframework/task-manager
 <!-- AUTO-GENERATED-CONTENT:START (README_SIMPLE:scripts=FALSE) -->
-<!-- This section is automatically generated.
-To update it, edit docs/md-magic.config.js  then run 'npm run build:md-magic' in the docs folder. -->
+<!-- prettier-ignore-start -->
+<!-- This section is automatically generated. To update it, make the appropriate changes to docs/md-magic.config.js or the embedded content, then run 'npm run build:md-magic' in the docs folder. -->
 ## Installation
@@ -18,12 +20,26 @@ API documentation for **@fluidframework/task-manager** is available at <https://
 ## Contribution Guidelines
-Please refer to our [Github Wiki](https://github.com/microsoft/FluidFramework/wiki/Contributing) for an overview of our contribution guidelines.
+There are many ways to [contribute](https://github.com/microsoft/FluidFramework/blob/main/CONTRIBUTING.md) to Fluid.
+-   Participate in Q&A in our [GitHub Discussions](https://github.com/microsoft/FluidFramework/discussions).
+-   [Submit bugs](https://github.com/microsoft/FluidFramework/issues) and help us verify fixes as they are checked in.
+-   Review the [source code changes](https://github.com/microsoft/FluidFramework/pulls).
+-   [Contribute bug fixes](https://github.com/microsoft/FluidFramework/blob/main/CONTRIBUTING.md).
+Detailed instructions for working in the repo can be found in the [Wiki](https://github.com/microsoft/FluidFramework/wiki).
+This project has adopted the [Microsoft Open Source Code of Conduct](https://opensource.microsoft.com/codeofconduct/).
+For more information see the [Code of Conduct FAQ](https://opensource.microsoft.com/codeofconduct/faq/) or contact [opencode@microsoft.com](mailto:opencode@microsoft.com) with any additional questions or comments.
+This project may contain Microsoft trademarks or logos for Microsoft projects, products, or services.
+Use of these trademarks or logos must follow Microsoft’s [Trademark & Brand Guidelines](https://www.microsoft.com/trademarks).
+Use of Microsoft trademarks or logos in modified versions of this project must not cause confusion or imply Microsoft sponsorship.
 ## Help
 Not finding what you're looking for in this README?
-Check out our [Github Wiki](https://github.com/microsoft/FluidFramework/wiki) or [fluidframework.com](https://fluidframework.com/docs/).
+Check out our [GitHub Wiki](https://github.com/microsoft/FluidFramework/wiki) or [fluidframework.com](https://fluidframework.com/docs/).
 Still not finding what you're looking for? Please [file an issue](https://github.com/microsoft/FluidFramework/wiki/Submitting-Bugs-and-Feature-Requests).
 Thank you!
@@ -33,4 +49,7 @@ Thank you!
 This project may contain Microsoft trademarks or logos for Microsoft projects, products, or services.
 Use of these trademarks or logos must follow Microsoft's [Trademark & Brand Guidelines](https://www.microsoft.com/en-us/legal/intellectualproperty/trademarks/usage/general).
 Use of Microsoft trademarks or logos in modified versions of this project must not cause confusion or imply Microsoft sponsorship.
+<!-- prettier-ignore-end -->
 <!-- AUTO-GENERATED-CONTENT:END -->

package/dist/packageVersion.d.ts CHANGED Viewed

@@ -5,5 +5,5 @@
  * THIS IS AN AUTOGENERATED FILE. DO NOT EDIT THIS FILE DIRECTLY
  */
 export declare const pkgName = "@fluidframework/task-manager";
-export declare const pkgVersion = "2.0.0-internal.2.2.1";
+export declare const pkgVersion = "2.0.0-internal.2.3.1";
 //# sourceMappingURL=packageVersion.d.ts.map

package/dist/packageVersion.js CHANGED Viewed

@@ -8,5 +8,5 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.pkgVersion = exports.pkgName = void 0;
 exports.pkgName = "@fluidframework/task-manager";
-exports.pkgVersion = "2.0.0-internal.2.2.1";
+exports.pkgVersion = "2.0.0-internal.2.3.1";
 //# sourceMappingURL=packageVersion.js.map

package/dist/packageVersion.js.map CHANGED Viewed

	@@ -1 +1 @@
1	- {"version":3,"file":"packageVersion.js","sourceRoot":"","sources":["../src/packageVersion.ts"],"names":[],"mappings":";AAAA;;;;;GAKG;;;AAEU,QAAA,OAAO,GAAG,8BAA8B,CAAC;AACzC,QAAA,UAAU,GAAG,sBAAsB,CAAC","sourcesContent":["/!\n Copyright (c) Microsoft Corporation and contributors. All rights reserved.\n * Licensed under the MIT License.\n \n THIS IS AN AUTOGENERATED FILE. DO NOT EDIT THIS FILE DIRECTLY\n */\n\nexport const pkgName = \"@fluidframework/task-manager\";\nexport const pkgVersion = \"2.0.0-internal.2.2.1\";\n"]}
1	+ {"version":3,"file":"packageVersion.js","sourceRoot":"","sources":["../src/packageVersion.ts"],"names":[],"mappings":";AAAA;;;;;GAKG;;;AAEU,QAAA,OAAO,GAAG,8BAA8B,CAAC;AACzC,QAAA,UAAU,GAAG,sBAAsB,CAAC","sourcesContent":["/!\n Copyright (c) Microsoft Corporation and contributors. All rights reserved.\n * Licensed under the MIT License.\n \n THIS IS AN AUTOGENERATED FILE. DO NOT EDIT THIS FILE DIRECTLY\n */\n\nexport const pkgName = \"@fluidframework/task-manager\";\nexport const pkgVersion = \"2.0.0-internal.2.3.1\";\n"]}

package/dist/taskManager.js CHANGED Viewed

@@ -313,8 +313,8 @@ class TaskManager extends shared_object_base_1.SharedObject {
         }
         if (this.readOnlyInfo.readonly === true) {
             const error = this.readOnlyInfo.permissions === true ?
-                new Error(`Attempted to volunteer with read-only permissions: ${taskId}`) :
-                new Error(`Attempted to volunteer in read-only state: ${taskId}`);
+                new Error("Attempted to volunteer with read-only permissions") :
+                new Error("Attempted to volunteer in read-only state");
             throw error;
         }
         if (!this.isAttached()) {
@@ -324,7 +324,7 @@ class TaskManager extends shared_object_base_1.SharedObject {
             return true;
         }
         if (!this.connected) {
-            throw new Error(`Attempted to volunteer in disconnected state: ${taskId}`);
+            throw new Error("Attempted to volunteer in disconnected state");
         }
         // This promise works even if we already have an outstanding volunteer op.
         const lockAcquireP = new Promise((resolve, reject) => {
@@ -351,14 +351,14 @@ class TaskManager extends shared_object_base_1.SharedObject {
                 this.abandonWatcher.off("abandon", checkIfAbandoned);
                 this.connectionWatcher.off("disconnect", rejectOnDisconnect);
                 this.completedWatcher.off("completed", checkIfCompleted);
-                reject(new Error(`Abandoned before acquiring task assignment: ${taskId}`));
+                reject(new Error("Abandoned before acquiring task assignment"));
             };
             const rejectOnDisconnect = () => {
                 this.queueWatcher.off("queueChange", checkIfAcquiredLock);
                 this.abandonWatcher.off("abandon", checkIfAbandoned);
                 this.connectionWatcher.off("disconnect", rejectOnDisconnect);
                 this.completedWatcher.off("completed", checkIfCompleted);
-                reject(new Error(`Disconnected before acquiring task assignment: ${taskId}`));
+                reject(new Error("Disconnected before acquiring task assignment"));
             };
             const checkIfCompleted = (eventTaskId) => {
                 if (eventTaskId !== taskId) {
@@ -388,7 +388,7 @@ class TaskManager extends shared_object_base_1.SharedObject {
             return;
         }
         if (this.readOnlyInfo.readonly === true && this.readOnlyInfo.permissions === true) {
-            throw new Error(`Attempted to subscribe with read-only permissions: ${taskId}`);
+            throw new Error("Attempted to subscribe with read-only permissions");
         }
         const submitVolunteerOp = () => {
             this.submitVolunteerOp(taskId);
@@ -515,13 +515,13 @@ class TaskManager extends shared_object_base_1.SharedObject {
      */
     complete(taskId) {
         if (!this.assigned(taskId)) {
-            throw new Error(`Attempted to mark task as complete while not being assigned: ${taskId}`);
+            throw new Error("Attempted to mark task as complete while not being assigned");
         }
         // If we are detached we will simulate auto-ack for the complete op. Therefore we only need to send the op if
         // we are attached. Additionally, we don't need to check if we are connected while detached.
         if (this.isAttached()) {
             if (!this.connected) {
-                throw new Error(`Attempted to complete task in disconnected state: ${taskId}`);
+                throw new Error("Attempted to complete task in disconnected state");
             }
             this.submitCompleteOp(taskId);
         }

package/dist/taskManager.js.map CHANGED Viewed

	@@ -1 +1 @@
1	- {"version":3,"file":"taskManager.js","sourceRoot":"","sources":["../src/taskManager.ts"],"names":[],"mappings":";AAAA;;;GAGG;;;AAEH,mCAAsC;AAEtC,+DAAsD;AACtD,+EAA8F;AAQ9F,+DAA4D;AAC5D,2EAA6G;AAE7G,6DAA0D;AA+B1D,MAAM,gBAAgB,GAAG,QAAQ,CAAC;AAElC;;GAEG;AACH,MAAM,mBAAmB,GAAG,aAAa,CAAC;AAG1C;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAyFG;AACH,MAAa,WAAY,SAAQ,iCAAgC;IAoE7D;;;;;;OAMG;IACH,YAAY,EAAU,EAAE,OAA+B,EAAE,UAA8B;QACnF,KAAK,CAAC,EAAE,EAAE,OAAO,EAAE,UAAU,EAAE,oBAAoB,CAAC,CAAC;QAvDzD;;;WAGG;QACc,eAAU,GAA0B,IAAI,GAAG,EAAE,CAAC;QAE/D,2GAA2G;QAC1F,cAAS,GAAiB,IAAI,qBAAY,EAAE,CAAC;QAC9D,sFAAsF;QACrE,iBAAY,GAAiB,IAAI,qBAAY,EAAE,CAAC;QACjE,qFAAqF;QACpE,mBAAc,GAAiB,IAAI,qBAAY,EAAE,CAAC;QACnE,8EAA8E;QAC7D,sBAAiB,GAAiB,IAAI,qBAAY,EAAE,CAAC;QACtE,qFAAqF;QACpE,qBAAgB,GAAiB,IAAI,qBAAY,EAAE,CAAC;QAE7D,cAAS,GAAW,CAAC,CAAC,CAAC;QAC/B;;WAEG;QACc,qBAAgB,GAA4B,IAAI,GAAG,EAAE,CAAC;QAEvE;;WAEG;QACc,oBAAe,GAAgB,IAAI,GAAG,EAAE,CAAC;QAE1D;;WAEG;QACc,0BAAqB,GAA0B,IAAI,GAAG,EAAE,CAAC;QA0BtE,IAAI,CAAC,SAAS,CAAC,EAAE,CAAC,WAAW,EAAE,CAAC,MAAc,EAAE,QAAgB,EAAE,KAAc,EAAE,SAAiB,EAAE,EAAE;YACnG,0FAA0F;YAC1F,0GAA0G;YAC1G,IAAI,OAAO,CAAC,SAAS,IAAI,KAAK,EAAE;gBAC5B,MAAM,SAAS,GAAG,IAAI,CAAC,gBAAgB,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;gBACpD,IAAA,qBAAM,EAAC,SAAS,KAAK,SAAS,EAAE,KAAK,CAAC,qBAAqB,CAAC,CAAC;gBAC7D,oGAAoG;gBACpG,IAAI,SAAS,KAAK,SAAS,CAAC,SAAS,EAAE;oBACnC,IAAA,qBAAM,EAAC,SAAS,CAAC,IAAI,KAAK,WAAW,EAAE,KAAK,CAAC,0BAA0B,CAAC,CAAC;oBACzE,kEAAkE;oBAClE,IAAI,CAAC,gBAAgB,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;iBACxC;aACJ;YAED,IAAI,CAAC,gBAAgB,CAAC,MAAM,EAAE,QAAQ,CAAC,CAAC;QAC5C,CAAC,CAAC,CAAC;QAEH,IAAI,CAAC,SAAS,CAAC,EAAE,CAAC,SAAS,EAAE,CAAC,MAAc,EAAE,QAAgB,EAAE,KAAc,EAAE,SAAiB,EAAE,EAAE;YACjG,IAAI,OAAO,CAAC,SAAS,IAAI,KAAK,EAAE;gBAC5B,MAAM,SAAS,GAAG,IAAI,CAAC,gBAAgB,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;gBACpD,IAAA,qBAAM,EAAC,SAAS,KAAK,SAAS,EAAE,KAAK,CAAC,qBAAqB,CAAC,CAAC;gBAC7D,oGAAoG;gBACpG,IAAI,SAAS,KAAK,SAAS,CAAC,SAAS,EAAE;oBACnC,IAAA,qBAAM,EAAC,SAAS,CAAC,IAAI,KAAK,SAAS,EAAE,KAAK,CAAC,0BAA0B,CAAC,CAAC;oBACvE,kEAAkE;oBAClE,IAAI,CAAC,gBAAgB,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;iBACxC;aACJ;YAED,IAAI,CAAC,qBAAqB,CAAC,MAAM,EAAE,QAAQ,CAAC,CAAC;QACjD,CAAC,CAAC,CAAC;QAEH,IAAI,CAAC,SAAS,CAAC,EAAE,CAAC,UAAU,EAAE,CAAC,MAAc,EAAE,QAAgB,EAAE,KAAc,EAAE,SAAiB,EAAE,EAAE;YAClG,IAAI,OAAO,CAAC,SAAS,IAAI,KAAK,EAAE;gBAC5B,MAAM,SAAS,GAAG,IAAI,CAAC,gBAAgB,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;gBACpD,IAAA,qBAAM,EAAC,SAAS,KAAK,SAAS,EAAE,KAAK,CAAC,mBAAmB,CAAC,CAAC;gBAC3D,uFAAuF;gBACvF,IAAI,SAAS,KAAK,SAAS,CAAC,SAAS,EAAE;oBACnC,IAAA,qBAAM,EAAC,SAAS,CAAC,IAAI,KAAK,UAAU,EAAE,KAAK,CAAC,wBAAwB,CAAC,CAAC;oBACtE,kEAAkE;oBAClE,IAAI,CAAC,gBAAgB,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;iBACxC;gBAED,qDAAqD;gBACrD,MAAM,UAAU,GAAG,IAAI,CAAC,qBAAqB,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;gBAC1D,IAAA,qBAAM,EAAC,UAAU,KAAK,SAAS,IAAI,UAAU,CAAC,MAAM,GAAG,CAAC,EAAE,KAAK,CAAC,yBAAyB,CAAC,CAAC;gBAC3F,MAAM,OAAO,GAAG,UAAU,CAAC,KAAK,EAAE,CAAC;gBACnC,IAAA,qBAAM,EAAC,OAAO,KAAK,SAAS,EAAE,KAAK,CAAC,2CAA2C,CAAC,CAAC;aACpF;YAED,2FAA2F;YAC3F,IAAI,CAAC,KAAK,EAAE;gBACR,IAAI,CAAC,UAAU,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;gBAC/B,IAAI,CAAC,gBAAgB,CAAC,IAAI,CAAC,WAAW,EAAE,MAAM,CAAC,CAAC;gBAChD,IAAI,CAAC,IAAI,CAAC,WAAW,EAAE,MAAM,CAAC,CAAC;aAClC;QACL,CAAC,CAAC,CAAC;QAEH,OAAO,CAAC,SAAS,EAAE,CAAC,EAAE,CAAC,cAAc,EAAE,CAAC,QAAgB,EAAE,EAAE;YACxD,IAAI,CAAC,yBAAyB,CAAC,QAAQ,CAAC,CAAC;QAC7C,CAAC,CAAC,CAAC;QAEH,IAAI,CAAC,YAAY,CAAC,EAAE,CAAC,aAAa,EAAE,CAAC,MAAc,EAAE,aAAqB,EAAE,aAAqB,EAAE,EAAE;YACjG,sGAAsG;YACtG,IAAI,aAAa,KAAK,mBAAmB,EAAE;gBACvC,IAAI,CAAC,IAAI,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;gBAC1B,OAAO;aACV;YAED,4FAA4F;YAC5F,IAAI,IAAI,CAAC,QAAQ,KAAK,SAAS,EAAE;gBAC7B,OAAO;aACV;YAED,IAAI,aAAa,KAAK,IAAI,CAAC,QAAQ,IAAI,aAAa,KAAK,IAAI,CAAC,QAAQ,EAAE;gBACpE,IAAI,CAAC,IAAI,CAAC,UAAU,EAAE,MAAM,CAAC,CAAC;aACjC;iBAAM,IAAI,aAAa,KAAK,IAAI,CAAC,QAAQ,IAAI,aAAa,KAAK,IAAI,CAAC,QAAQ,EAAE;gBAC3E,IAAI,CAAC,IAAI,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;aAC7B;QACL,CAAC,CAAC,CAAC;QAEH,IAAI,CAAC,iBAAiB,CAAC,EAAE,CAAC,YAAY,EAAE,GAAG,EAAE;YACzC,IAAA,qBAAM,EAAC,IAAI,CAAC,QAAQ,KAAK,SAAS,EAAE,KAAK,CAAC,uCAAuC,CAAC,CAAC;YAEnF,sGAAsG;YACtG,2EAA2E;YAC3E,8FAA8F;YAC9F,gEAAgE;YAChE,KAAK,MAAM,CAAC,MAAM,EAAE,WAAW,CAAC,IAAI,IAAI,CAAC,UAAU,CAAC,OAAO,EAAE,EAAE;gBAC3D,IAAI,IAAI,CAAC,UAAU,EAAE,IAAI,WAAW,CAAC,CAAC,CAAC,KAAK,IAAI,CAAC,QAAQ,EAAE;oBACvD,IAAI,CAAC,IAAI,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;iBAC7B;aACJ;YAED,iFAAiF;YACjF,IAAI,CAAC,gBAAgB,CAAC,KAAK,EAAE,CAAC;QAClC,CAAC,CAAC,CAAC;IACP,CAAC;IA9KD;;;;;;OAMG;IACI,MAAM,CAAC,MAAM,CAAC,OAA+B,EAAE,EAAW;QAC7D,OAAO,OAAO,CAAC,aAAa,CAAC,EAAE,EAAE,uCAAkB,CAAC,IAAI,CAAgB,CAAC;IAC7E,CAAC;IAED;;;;OAIG;IACI,MAAM,CAAC,UAAU;QACpB,OAAO,IAAI,uCAAkB,EAAE,CAAC;IACpC,CAAC;IAmCD;;OAEG;IACH,IAAY,QAAQ;QAChB,OAAO,IAAI,CAAC,UAAU,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC,CAAC,mBAAmB,CAAC;IAC3E,CAAC;IAED;;OAEG;IACH,IAAY,YAAY;QACpB,OAAO,IAAI,CAAC,OAAO,CAAC,YAAY,CAAC,YAAY,CAAC;IAClD,CAAC;IA+GO,iBAAiB,CAAC,MAAc;QACpC,MAAM,EAAE,GAAmC;YACvC,IAAI,EAAE,WAAW;YACjB,MAAM;SACT,CAAC;QACF,MAAM,SAAS,GAAe;YAC1B,IAAI,EAAE,WAAW;YACjB,SAAS,EAAE,EAAE,IAAI,CAAC,SAAS;SAC9B,CAAC;QACF,IAAI,CAAC,kBAAkB,CAAC,EAAE,EAAE,SAAS,CAAC,SAAS,CAAC,CAAC;QACjD,IAAI,CAAC,gBAAgB,CAAC,GAAG,CAAC,MAAM,EAAE,SAAS,CAAC,CAAC;IACjD,CAAC;IAEO,eAAe,CAAC,MAAc;QAClC,MAAM,EAAE,GAAiC;YACrC,IAAI,EAAE,SAAS;YACf,MAAM;SACT,CAAC;QACF,MAAM,SAAS,GAAe;YAC1B,IAAI,EAAE,SAAS;YACf,SAAS,EAAE,EAAE,IAAI,CAAC,SAAS;SAC9B,CAAC;QACF,IAAI,CAAC,kBAAkB,CAAC,EAAE,EAAE,SAAS,CAAC,SAAS,CAAC,CAAC;QACjD,IAAI,CAAC,gBAAgB,CAAC,GAAG,CAAC,MAAM,EAAE,SAAS,CAAC,CAAC;IACjD,CAAC;IAEO,gBAAgB,CAAC,MAAc;;QACnC,MAAM,EAAE,GAAmC;YACvC,IAAI,EAAE,UAAU;YAChB,MAAM;SACT,CAAC;QACF,MAAM,SAAS,GAAe;YAC1B,IAAI,EAAE,UAAU;YAChB,SAAS,EAAE,EAAE,IAAI,CAAC,SAAS;SAC9B,CAAC;QAEF,IAAI,IAAI,CAAC,qBAAqB,CAAC,GAAG,CAAC,MAAM,CAAC,EAAE;YACxC,MAAA,IAAI,CAAC,qBAAqB,CAAC,GAAG,CAAC,MAAM,CAAC,0CAAE,IAAI,CAAC,SAAS,CAAC,SAAS,CAAC,CAAC;SACrE;aAAM;YACH,IAAI,CAAC,qBAAqB,CAAC,GAAG,CAAC,MAAM,EAAE,CAAC,SAAS,CAAC,SAAS,CAAC,CAAC,CAAC;SACjE;QAED,IAAI,CAAC,kBAAkB,CAAC,EAAE,EAAE,SAAS,CAAC,SAAS,CAAC,CAAC;QACjD,IAAI,CAAC,gBAAgB,CAAC,GAAG,CAAC,MAAM,EAAE,SAAS,CAAC,CAAC;IACjD,CAAC;IAED;;OAEG;IACI,KAAK,CAAC,gBAAgB,CAAC,MAAc;QACxC,2CAA2C;QAC3C,IAAI,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC,EAAE;YACvB,OAAO,IAAI,CAAC;SACf;QAED,IAAI,IAAI,CAAC,YAAY,CAAC,QAAQ,KAAK,IAAI,EAAE;YACrC,MAAM,KAAK,GAAG,IAAI,CAAC,YAAY,CAAC,WAAW,KAAK,IAAI,CAAC,CAAC;gBAClD,IAAI,KAAK,CAAC,sDAAsD,MAAM,EAAE,CAAC,CAAC,CAAC;gBAC3E,IAAI,KAAK,CAAC,8CAA8C,MAAM,EAAE,CAAC,CAAC;YACtE,MAAM,KAAK,CAAC;SACf;QAED,IAAI,CAAC,IAAI,CAAC,UAAU,EAAE,EAAE;YACpB,yCAAyC;YACzC,IAAA,qBAAM,EAAC,IAAI,CAAC,QAAQ,KAAK,SAAS,EAAE,KAAK,CAAC,sCAAsC,CAAC,CAAC;YAClF,IAAI,CAAC,gBAAgB,CAAC,MAAM,EAAE,IAAI,CAAC,QAAQ,CAAC,CAAC;YAC7C,OAAO,IAAI,CAAC;SACf;QAED,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE;YACjB,MAAM,IAAI,KAAK,CAAC,iDAAiD,MAAM,EAAE,CAAC,CAAC;SAC9E;QAED,0EAA0E;QAC1E,MAAM,YAAY,GAAG,IAAI,OAAO,CAAU,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE;YAC1D,MAAM,mBAAmB,GAAG,CAAC,WAAmB,EAAE,EAAE;gBAChD,IAAI,WAAW,KAAK,MAAM,EAAE;oBACxB,OAAO;iBACV;gBAED,kGAAkG;gBAClG,qGAAqG;gBACrG,kGAAkG;gBAClG,IAAI,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,gBAAgB,CAAC,GAAG,CAAC,MAAM,CAAC,EAAE;oBAC7D,IAAI,CAAC,YAAY,CAAC,GAAG,CAAC,aAAa,EAAE,mBAAmB,CAAC,CAAC;oBAC1D,IAAI,CAAC,cAAc,CAAC,GAAG,CAAC,SAAS,EAAE,gBAAgB,CAAC,CAAC;oBACrD,IAAI,CAAC,iBAAiB,CAAC,GAAG,CAAC,YAAY,EAAE,kBAAkB,CAAC,CAAC;oBAC7D,IAAI,CAAC,gBAAgB,CAAC,GAAG,CAAC,WAAW,EAAE,gBAAgB,CAAC,CAAC;oBACzD,OAAO,CAAC,IAAI,CAAC,CAAC;iBACjB;YACL,CAAC,CAAC;YAEF,MAAM,gBAAgB,GAAG,CAAC,WAAmB,EAAE,EAAE;gBAC7C,IAAI,WAAW,KAAK,MAAM,EAAE;oBACxB,OAAO;iBACV;gBAED,IAAI,CAAC,YAAY,CAAC,GAAG,CAAC,aAAa,EAAE,mBAAmB,CAAC,CAAC;gBAC1D,IAAI,CAAC,cAAc,CAAC,GAAG,CAAC,SAAS,EAAE,gBAAgB,CAAC,CAAC;gBACrD,IAAI,CAAC,iBAAiB,CAAC,GAAG,CAAC,YAAY,EAAE,kBAAkB,CAAC,CAAC;gBAC7D,IAAI,CAAC,gBAAgB,CAAC,GAAG,CAAC,WAAW,EAAE,gBAAgB,CAAC,CAAC;gBACzD,MAAM,CAAC,IAAI,KAAK,CAAC,+CAA+C,MAAM,EAAE,CAAC,CAAC,CAAC;YAC/E,CAAC,CAAC;YAEF,MAAM,kBAAkB,GAAG,GAAG,EAAE;gBAC5B,IAAI,CAAC,YAAY,CAAC,GAAG,CAAC,aAAa,EAAE,mBAAmB,CAAC,CAAC;gBAC1D,IAAI,CAAC,cAAc,CAAC,GAAG,CAAC,SAAS,EAAE,gBAAgB,CAAC,CAAC;gBACrD,IAAI,CAAC,iBAAiB,CAAC,GAAG,CAAC,YAAY,EAAE,kBAAkB,CAAC,CAAC;gBAC7D,IAAI,CAAC,gBAAgB,CAAC,GAAG,CAAC,WAAW,EAAE,gBAAgB,CAAC,CAAC;gBACzD,MAAM,CAAC,IAAI,KAAK,CAAC,kDAAkD,MAAM,EAAE,CAAC,CAAC,CAAC;YAClF,CAAC,CAAC;YAEF,MAAM,gBAAgB,GAAG,CAAC,WAAmB,EAAE,EAAE;gBAC7C,IAAI,WAAW,KAAK,MAAM,EAAE;oBACxB,OAAO;iBACV;gBAED,IAAI,CAAC,YAAY,CAAC,GAAG,CAAC,aAAa,EAAE,mBAAmB,CAAC,CAAC;gBAC1D,IAAI,CAAC,cAAc,CAAC,GAAG,CAAC,SAAS,EAAE,gBAAgB,CAAC,CAAC;gBACrD,IAAI,CAAC,iBAAiB,CAAC,GAAG,CAAC,YAAY,EAAE,kBAAkB,CAAC,CAAC;gBAC7D,IAAI,CAAC,gBAAgB,CAAC,GAAG,CAAC,WAAW,EAAE,gBAAgB,CAAC,CAAC;gBACzD,OAAO,CAAC,KAAK,CAAC,CAAC;YACnB,CAAC,CAAC;YAEF,IAAI,CAAC,YAAY,CAAC,EAAE,CAAC,aAAa,EAAE,mBAAmB,CAAC,CAAC;YACzD,IAAI,CAAC,cAAc,CAAC,EAAE,CAAC,SAAS,EAAE,gBAAgB,CAAC,CAAC;YACpD,IAAI,CAAC,iBAAiB,CAAC,EAAE,CAAC,YAAY,EAAE,kBAAkB,CAAC,CAAC;YAC5D,IAAI,CAAC,gBAAgB,CAAC,EAAE,CAAC,WAAW,EAAE,gBAAgB,CAAC,CAAC;QAC5D,CAAC,CAAC,CAAC;QAEH,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,EAAE;YACtB,IAAI,CAAC,iBAAiB,CAAC,MAAM,CAAC,CAAC;SAClC;QACD,OAAO,YAAY,CAAC;IACxB,CAAC;IAED;;OAEG;IACI,eAAe,CAAC,MAAc;QACjC,IAAI,IAAI,CAAC,UAAU,CAAC,MAAM,CAAC,EAAE;YACzB,OAAO;SACV;QAED,IAAI,IAAI,CAAC,YAAY,CAAC,QAAQ,KAAK,IAAI,IAAI,IAAI,CAAC,YAAY,CAAC,WAAW,KAAK,IAAI,EAAE;YAC/E,MAAM,IAAI,KAAK,CAAC,sDAAsD,MAAM,EAAE,CAAC,CAAC;SACnF;QAED,MAAM,iBAAiB,GAAG,GAAG,EAAE;YAC3B,IAAI,CAAC,iBAAiB,CAAC,MAAM,CAAC,CAAC;QACnC,CAAC,CAAC;QAEF,MAAM,iBAAiB,GAAG,GAAG,EAAE;YAC3B,6DAA6D;YAC7D,IAAI,CAAC,iBAAiB,CAAC,IAAI,CAAC,SAAS,EAAE,iBAAiB,CAAC,CAAC;QAC9D,CAAC,CAAC;QAEF,MAAM,gBAAgB,GAAG,CAAC,WAAmB,EAAE,EAAE;YAC7C,IAAI,WAAW,KAAK,MAAM,EAAE;gBACxB,OAAO;aACV;YAED,IAAI,CAAC,cAAc,CAAC,GAAG,CAAC,SAAS,EAAE,gBAAgB,CAAC,CAAC;YACrD,IAAI,CAAC,iBAAiB,CAAC,GAAG,CAAC,YAAY,EAAE,iBAAiB,CAAC,CAAC;YAC5D,IAAI,CAAC,iBAAiB,CAAC,GAAG,CAAC,SAAS,EAAE,iBAAiB,CAAC,CAAC;YACzD,IAAI,CAAC,gBAAgB,CAAC,GAAG,CAAC,WAAW,EAAE,gBAAgB,CAAC,CAAC;YAEzD,IAAI,CAAC,eAAe,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;QACxC,CAAC,CAAC;QAEF,MAAM,gBAAgB,GAAG,CAAC,WAAmB,EAAE,EAAE;YAC7C,IAAI,WAAW,KAAK,MAAM,EAAE;gBACxB,OAAO;aACV;YAED,IAAI,CAAC,cAAc,CAAC,GAAG,CAAC,SAAS,EAAE,gBAAgB,CAAC,CAAC;YACrD,IAAI,CAAC,iBAAiB,CAAC,GAAG,CAAC,YAAY,EAAE,iBAAiB,CAAC,CAAC;YAC5D,IAAI,CAAC,iBAAiB,CAAC,GAAG,CAAC,SAAS,EAAE,iBAAiB,CAAC,CAAC;YACzD,IAAI,CAAC,gBAAgB,CAAC,GAAG,CAAC,WAAW,EAAE,gBAAgB,CAAC,CAAC;YAEzD,IAAI,CAAC,eAAe,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;QACxC,CAAC,CAAC;QAEF,IAAI,CAAC,cAAc,CAAC,EAAE,CAAC,SAAS,EAAE,gBAAgB,CAAC,CAAC;QACpD,IAAI,CAAC,iBAAiB,CAAC,EAAE,CAAC,YAAY,EAAE,iBAAiB,CAAC,CAAC;QAC3D,IAAI,CAAC,gBAAgB,CAAC,EAAE,CAAC,WAAW,EAAE,gBAAgB,CAAC,CAAC;QAExD,IAAI,CAAC,IAAI,CAAC,UAAU,EAAE,EAAE;YACpB,yCAAyC;YACzC,IAAA,qBAAM,EAAC,IAAI,CAAC,QAAQ,KAAK,SAAS,EAAE,KAAK,CAAC,sCAAsC,CAAC,CAAC;YAClF,IAAI,CAAC,gBAAgB,CAAC,MAAM,EAAE,IAAI,CAAC,QAAQ,CAAC,CAAC;YAC7C,uGAAuG;YACvG,wGAAwG;YACxG,cAAc;YACd,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,UAAU,EAAE,GAAG,EAAE;gBAC/B,IAAI,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,EAAE;oBACrB,+FAA+F;oBAC/F,sCAAsC;oBACtC,OAAO;iBACV;qBAAM,IAAI,IAAI,CAAC,SAAS,EAAE;oBACvB,iBAAiB,EAAE,CAAC;iBACvB;qBAAM;oBACH,IAAI,CAAC,iBAAiB,CAAC,IAAI,CAAC,SAAS,EAAE,GAAG,EAAE;wBACxC,iBAAiB,EAAE,CAAC;oBACxB,CAAC,CAAC,CAAC;iBACN;YACL,CAAC,CAAC,CAAC;SACN;aAAM,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE;YACxB,sFAAsF;YACtF,iBAAiB,EAAE,CAAC;SACvB;aAAM,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,EAAE;YACvD,iBAAiB,EAAE,CAAC;SACvB;QACD,IAAI,CAAC,eAAe,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;IACrC,CAAC;IAED;;OAEG;IACI,OAAO,CAAC,MAAc;QACzB,uGAAuG;QACvG,6GAA6G;QAC7G,cAAc;QACd,IAAI,CAAC,IAAI,CAAC,UAAU,CAAC,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,EAAE;YAClD,gBAAgB;YAChB,OAAO;SACV;QAED,IAAI,CAAC,IAAI,CAAC,UAAU,EAAE,EAAE;YACpB,yCAAyC;YACzC,IAAA,qBAAM,EAAC,IAAI,CAAC,QAAQ,KAAK,SAAS,EAAE,KAAK,CAAC,2BAA2B,CAAC,CAAC;YACvE,IAAI,CAAC,qBAAqB,CAAC,MAAM,EAAE,IAAI,CAAC,QAAQ,CAAC,CAAC;YAClD,IAAI,CAAC,cAAc,CAAC,IAAI,CAAC,SAAS,EAAE,MAAM,CAAC,CAAC;YAC5C,OAAO;SACV;QAED,+FAA+F;QAC/F,IAAI,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,EAAE;YACrB,IAAI,CAAC,eAAe,CAAC,MAAM,CAAC,CAAC;SAChC;QACD,IAAI,CAAC,cAAc,CAAC,IAAI,CAAC,SAAS,EAAE,MAAM,CAAC,CAAC;IAChD,CAAC;IAED;;OAEG;IACI,QAAQ,CAAC,MAAc;;QAC1B,IAAI,IAAI,CAAC,UAAU,EAAE,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE;YACtC,OAAO,KAAK,CAAC;SAChB;QAED,MAAM,eAAe,GAAG,MAAA,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,MAAM,CAAC,0CAAG,CAAC,CAAC,CAAC;QACzD,OAAO,eAAe,KAAK,SAAS;eAC7B,eAAe,KAAK,IAAI,CAAC,QAAQ;eACjC,CAAC,IAAI,CAAC,gBAAgB,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;IAC9C,CAAC;IAED;;OAEG;IACI,MAAM,CAAC,MAAc;;QACxB,IAAI,IAAI,CAAC,UAAU,EAAE,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE;YACtC,OAAO,KAAK,CAAC;SAChB;QAED,IAAA,qBAAM,EAAC,IAAI,CAAC,QAAQ,KAAK,SAAS,EAAE,KAAK,CAAC,0BAA0B,CAAC,CAAC;QAEtE,MAAM,WAAW,GAAG,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;QAChD,wEAAwE;QACxE,OAAO,CACH,CAAC,MAAA,WAAW,aAAX,WAAW,uBAAX,WAAW,CAAE,QAAQ,CAAC,IAAI,CAAC,QAAQ,CAAC,mCAAI,KAAK,CAAC;eAC5C,CAAC,IAAI,CAAC,gBAAgB,CAAC,GAAG,CAAC,MAAM,CAAC,CACxC;eACM,CAAA,MAAA,IAAI,CAAC,gBAAgB,CAAC,GAAG,CAAC,MAAM,CAAC,0CAAE,IAAI,MAAK,WAAW,CAAC;IACnE,CAAC;IAED;;OAEG;IACI,UAAU,CAAC,MAAc;QAC5B,OAAO,IAAI,CAAC,eAAe,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;IAC5C,CAAC;IAED;;OAEG;IACI,QAAQ,CAAC,MAAc;QAC1B,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC,EAAE;YACxB,MAAM,IAAI,KAAK,CAAC,gEAAgE,MAAM,EAAE,CAAC,CAAC;SAC7F;QAED,6GAA6G;QAC7G,4FAA4F;QAC5F,IAAI,IAAI,CAAC,UAAU,EAAE,EAAE;YACnB,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE;gBACjB,MAAM,IAAI,KAAK,CAAC,qDAAqD,MAAM,EAAE,CAAC,CAAC;aAClF;YACD,IAAI,CAAC,gBAAgB,CAAC,MAAM,CAAC,CAAC;SACjC;QAED,IAAI,CAAC,UAAU,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;QAC/B,IAAI,CAAC,gBAAgB,CAAC,IAAI,CAAC,WAAW,EAAE,MAAM,CAAC,CAAC;QAChD,IAAI,CAAC,IAAI,CAAC,WAAW,EAAE,MAAM,CAAC,CAAC;IACnC,CAAC;IAED;;OAEG;IACI,YAAY;QACf,kGAAkG;QAClG,+GAA+G;QAC/G,8GAA8G;QAC9G,2BAA2B;QAC3B,OAAO,IAAI,CAAC,SAAS,CAAC;IAC1B,CAAC;IAED;;;;;OAKG;IACO,aAAa,CAAC,UAA4B;QAChD,IAAI,IAAI,CAAC,OAAO,CAAC,QAAQ,KAAK,SAAS,EAAE;YACrC,uGAAuG;YACvG,oCAAoC;YACpC,IAAI,CAAC,6BAA6B,EAAE,CAAC;SACxC;aAAM;YACH,sGAAsG;YACtG,yGAAyG;YACzG,kBAAkB;YAClB,IAAI,CAAC,yBAAyB,CAAC,mBAAmB,CAAC,CAAC;SACvD;QAED,wDAAwD;QACxD,MAAM,WAAW,GAAG,IAAI,GAAG,EAAoB,CAAC;QAChD,IAAI,CAAC,UAAU,CAAC,OAAO,CAAC,CAAC,KAAe,EAAE,MAAc,EAAE,EAAE;YACxD,IAAI,KAAK,CAAC,MAAM,GAAG,CAAC,EAAE;gBAClB,WAAW,CAAC,GAAG,CAAC,MAAM,EAAE,KAAK,CAAC,CAAC;aAClC;QACL,CAAC,CAAC,CAAC;QACH,MAAM,OAAO,GAAG,CAAC,GAAG,WAAW,CAAC,OAAO,EAAE,CAAC,CAAC;QAC3C,OAAO,IAAA,4CAAuB,EAAC,gBAAgB,EAAE,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC,CAAC,CAAC;IAC9E,CAAC;IAED;;;OAGG;IACO,KAAK,CAAC,QAAQ,CAAC,OAA+B;QACpD,MAAM,OAAO,GAAG,MAAM,IAAA,2BAAY,EAAuB,OAAO,EAAE,gBAAgB,CAAC,CAAC;QACpF,OAAO,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,EAAE,aAAa,CAAC,EAAE,EAAE;YACxC,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,MAAM,EAAE,aAAa,CAAC,CAAC;QAC/C,CAAC,CAAC,CAAC;QACH,IAAI,CAAC,uBAAuB,EAAE,CAAC;IACnC,CAAC;IAED;;OAEG;IACO,mBAAmB,KAAK,CAAC;IAEnC;;;OAGG;IACO,YAAY;QAClB,IAAI,CAAC,iBAAiB,CAAC,IAAI,CAAC,YAAY,CAAC,CAAC;IAC9C,CAAC;IAED;;;OAGG;IACO,SAAS;QACf,IAAI,CAAC,iBAAiB,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;IAC3C,CAAC;IAED,EAAE;IACF;;;;OAIG;IACO,YAAY,KAAK,CAAC;IAE5B;;;;;;;;OAQG;IACO,WAAW,CAAC,OAAkC,EAAE,KAAc,EAAE,eAAwB;QAC9F,IAAI,OAAO,CAAC,IAAI,KAAK,kCAAW,CAAC,SAAS,EAAE;YACxC,MAAM,EAAE,GAAG,OAAO,CAAC,QAAiC,CAAC;YACrD,MAAM,SAAS,GAAG,eAAyB,CAAC;YAE5C,QAAQ,EAAE,CAAC,IAAI,EAAE;gBACb,KAAK,WAAW;oBACZ,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,WAAW,EAAE,EAAE,CAAC,MAAM,EAAE,OAAO,CAAC,QAAQ,EAAE,KAAK,EAAE,SAAS,CAAC,CAAC;oBAChF,MAAM;gBAEV,KAAK,SAAS;oBACV,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,SAAS,EAAE,EAAE,CAAC,MAAM,EAAE,OAAO,CAAC,QAAQ,EAAE,KAAK,EAAE,SAAS,CAAC,CAAC;oBAC9E,MAAM;gBAEV,KAAK,UAAU;oBACX,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,UAAU,EAAE,EAAE,CAAC,MAAM,EAAE,OAAO,CAAC,QAAQ,EAAE,KAAK,EAAE,SAAS,CAAC,CAAC;oBAC/E,MAAM;gBAEV;oBACI,MAAM,IAAI,KAAK,CAAC,mBAAmB,CAAC,CAAC;aAC5C;SACJ;IACL,CAAC;IAEO,gBAAgB,CAAC,MAAc,EAAE,QAAgB;QACrD,MAAM,UAAU,GAAG,IAAI,CAAC,qBAAqB,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;QAC1D,IAAI,UAAU,KAAK,SAAS,IAAI,UAAU,CAAC,MAAM,GAAG,CAAC,EAAE;YACnD,wEAAwE;YACxE,OAAO;SACV;QAED,kGAAkG;QAClG,IAAI,IAAI,CAAC,OAAO,CAAC,SAAS,EAAE,CAAC,UAAU,EAAE,CAAC,GAAG,CAAC,QAAQ,CAAC,IAAI,IAAI,CAAC,QAAQ,KAAK,mBAAmB,EAAE;YAC9F,yEAAyE;YACzE,IAAI,WAAW,GAAG,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;YAC9C,IAAI,WAAW,KAAK,SAAS,EAAE;gBAC3B,WAAW,GAAG,EAAE,CAAC;gBACjB,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,MAAM,EAAE,WAAW,CAAC,CAAC;aAC5C;YAED,MAAM,aAAa,GAAG,WAAW,CAAC,CAAC,CAAC,CAAC;YACrC,WAAW,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;YAC3B,MAAM,aAAa,GAAG,WAAW,CAAC,CAAC,CAAC,CAAC;YACrC,IAAI,aAAa,KAAK,aAAa,EAAE;gBACjC,IAAI,CAAC,YAAY,CAAC,IAAI,CAAC,aAAa,EAAE,MAAM,EAAE,aAAa,EAAE,aAAa,CAAC,CAAC;aAC/E;SAEJ;IACL,CAAC;IAEO,qBAAqB,CAAC,MAAc,EAAE,QAAgB;QAC1D,MAAM,WAAW,GAAG,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;QAChD,IAAI,WAAW,KAAK,SAAS,EAAE;YAC3B,OAAO;SACV;QAED,MAAM,aAAa,GAAG,QAAQ,KAAK,mBAAmB,CAAC,CAAC,CAAC,mBAAmB,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC;QAC9F,MAAM,aAAa,GAAG,WAAW,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC;QACpD,IAAI,aAAa,KAAK,CAAC,CAAC,EAAE;YACtB,WAAW,CAAC,MAAM,CAAC,aAAa,EAAE,CAAC,CAAC,CAAC;YACrC,yDAAyD;YACzD,IAAI,WAAW,CAAC,MAAM,KAAK,CAAC,EAAE;gBAC1B,IAAI,CAAC,UAAU,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;aAClC;SACJ;QACD,MAAM,aAAa,GAAG,WAAW,CAAC,CAAC,CAAC,CAAC;QACrC,IAAI,aAAa,KAAK,aAAa,EAAE;YACjC,IAAI,CAAC,YAAY,CAAC,IAAI,CAAC,aAAa,EAAE,MAAM,EAAE,aAAa,EAAE,aAAa,CAAC,CAAC;SAC/E;IACL,CAAC;IAEO,yBAAyB,CAAC,QAAgB;QAC9C,KAAK,MAAM,MAAM,IAAI,IAAI,CAAC,UAAU,CAAC,IAAI,EAAE,EAAE;YACzC,IAAI,CAAC,qBAAqB,CAAC,MAAM,EAAE,QAAQ,CAAC,CAAC;SAChD;IACL,CAAC;IAED;;;OAGG;IACK,6BAA6B;QACjC,IAAA,qBAAM,EAAC,IAAI,CAAC,OAAO,CAAC,QAAQ,KAAK,SAAS,EAAE,KAAK,CAAC,6CAA6C,CAAC,CAAC;QACjG,KAAK,MAAM,WAAW,IAAI,IAAI,CAAC,UAAU,CAAC,MAAM,EAAE,EAAE;YAChD,MAAM,aAAa,GAAG,WAAW,CAAC,OAAO,CAAC,mBAAmB,CAAC,CAAC;YAC/D,IAAI,aAAa,KAAK,CAAC,CAAC,EAAE;gBACtB,WAAW,CAAC,aAAa,CAAC,GAAG,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC;aACtD;SACJ;IACL,CAAC;IAED,kGAAkG;IAClG,kCAAkC;IAC1B,uBAAuB;QAC3B,MAAM,MAAM,GAAG,IAAI,CAAC,OAAO,CAAC,SAAS,EAAE,CAAC;QACxC,KAAK,MAAM,CAAC,MAAM,EAAE,WAAW,CAAC,IAAI,IAAI,CAAC,UAAU,EAAE;YACjD,MAAM,mBAAmB,GAAG,WAAW,CAAC,MAAM,CAAC,CAAC,QAAQ,EAAE,EAAE,CAAC,MAAM,CAAC,SAAS,CAAC,QAAQ,CAAC,KAAK,SAAS,CAAC,CAAC;YACvG,IAAI,WAAW,CAAC,MAAM,KAAK,mBAAmB,CAAC,MAAM,EAAE;gBACnD,IAAI,mBAAmB,CAAC,MAAM,KAAK,CAAC,EAAE;oBAClC,IAAI,CAAC,UAAU,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;iBAClC;qBAAM;oBACH,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,MAAM,EAAE,mBAAmB,CAAC,CAAC;iBACpD;gBACD,IAAI,CAAC,YAAY,CAAC,IAAI,CAAC,aAAa,EAAE,MAAM,CAAC,CAAC;aACjD;SACJ;IACL,CAAC;IAEM,cAAc;QACjB,MAAM,IAAI,KAAK,CAAC,iBAAiB,CAAC,CAAC;IACvC,CAAC;CACJ;AA3qBD,kCA2qBC","sourcesContent":["/!\n Copyright (c) Microsoft Corporation and contributors. All rights reserved.\n * Licensed under the MIT License.\n /\n\nimport { EventEmitter } from \"events\";\n\nimport { assert } from \"@fluidframework/common-utils\";\nimport { ISequencedDocumentMessage, MessageType } from \"@fluidframework/protocol-definitions\";\nimport {\n IChannelAttributes,\n IFluidDataStoreRuntime,\n IChannelStorageService,\n IChannelFactory,\n} from \"@fluidframework/datastore-definitions\";\nimport { ISummaryTreeWithStats } from \"@fluidframework/runtime-definitions\";\nimport { readAndParse } from \"@fluidframework/driver-utils\";\nimport { createSingleBlobSummary, IFluidSerializer, SharedObject } from \"@fluidframework/shared-object-base\";\nimport { ReadOnlyInfo } from \"@fluidframework/container-definitions\";\nimport { TaskManagerFactory } from \"./taskManagerFactory\";\nimport { ITaskManager, ITaskManagerEvents } from \"./interfaces\";\n\n/\n Description of a task manager operation\n /\ntype ITaskManagerOperation =\n ITaskManagerVolunteerOperation \|\n ITaskManagerAbandonOperation \|\n ITaskManagerCompletedOperation;\n\ninterface ITaskManagerVolunteerOperation {\n type: \"volunteer\";\n taskId: string;\n}\n\ninterface ITaskManagerAbandonOperation {\n type: \"abandon\";\n taskId: string;\n}\n\ninterface ITaskManagerCompletedOperation {\n type: \"complete\";\n taskId: string;\n}\n\ninterface IPendingOp {\n type: \"volunteer\" \| \"abandon\" \| \"complete\";\n messageId: number;\n}\n\nconst snapshotFileName = \"header\";\n\n/\n Placeholder clientId for detached scenarios.\n /\nconst placeholderClientId = \"placeholder\";\n\n\n/\n The TaskManager distributed data structure tracks queues of clients that want to exclusively run a task.\n \n @remarks\n \n For an in-depth overview, see [TaskManager](https://fluidframework.com/docs/data-structures/task-manager/).\n \n ### Creation\n \n To create a `TaskManager`, call the static create method:\n \n ```typescript\n * const taskManager = TaskManager.create(this.runtime, id);\n * ```\n \n ### Usage\n \n To volunteer for a task, use the `volunteerForTask()` method. This returns a Promise that will resolve once the\n * client has acquired exclusive rights to run the task, or reject if the client is removed from the queue without\n * acquiring the rights.\n \n ```typescript\n * taskManager.volunteerForTask(\"NameOfTask\")\n * .then(() => { doTheTask(); })\n * .catch((err) => { console.error(err); });\n * ```\n \n Alternatively, you can indefinitely volunteer for a task with the synchronous `subscribeToTask()` method. This\n * method does not return a value, therefore you need to rely on eventing to know when you have acquired the rights\n * to run the task (see below).\n \n ```typescript\n * taskManager.subscribeToTask(\"NameOfTask\");\n * ```\n \n To check if the local client is currently subscribed to a task, use the `subscribed()` method.\n * ```typescript\n * if (taskManager.subscribed(\"NameOfTask\")) {\n * console.log(\"This client is currently subscribed to the task.\");\n * }\n * ```\n \n To release the rights to the task, use the `abandon()` method. The next client in the queue will then get the\n * rights to run the task.\n \n ```typescript\n * taskManager.abandon(\"NameOfTask\");\n * ```\n \n To inspect your state in the queue, you can use the `queued()` and `assigned()` methods.\n \n ```typescript\n * if (taskManager.queued(\"NameOfTask\")) {\n * console.log(\"This client is somewhere in the queue, potentially even having the task assignment.\");\n * }\n \n if (taskManager.assigned(\"NameOfTask\")) {\n * console.log(\"This client currently has the rights to run the task\");\n * }\n * ```\n \n To signal to other connected clients that a task is completed, use the `complete()` method. This will release all\n * clients from the queue and emit the \"completed\" event.\n \n ```typescript\n * taskManager.complete(\"NameOfTask\");\n * ```\n \n ### Eventing\n \n `TaskManager` is an `EventEmitter`, and will emit events when a task is assigned to the client, when the task\n * assignment is lost, and when a task was completed by another client.\n \n ```typescript\n * taskManager.on(\"assigned\", (taskId: string) => {\n * console.log(`Client was assigned task: ${taskId}`);\n * });\n \n taskManager.on(\"lost\", (taskId: string) => {\n * console.log(`Client released task: ${taskId}`);\n * });\n \n taskManager.on(\"completed\", (taskId: string) => {\n * console.log(`Another client completed task: ${taskId}`);\n * });\n * ```\n \n These can be useful if the logic to volunteer for a task is separated from the logic to perform the task, such as\n * when using the `subscribeToTask()` method.\n /\nexport class TaskManager extends SharedObject<ITaskManagerEvents> implements ITaskManager {\n /\n Create a new TaskManager\n \n @param runtime - data store runtime the new task queue belongs to\n * @param id - optional name of the task queue\n * @returns newly create task queue (but not attached yet)\n /\n public static create(runtime: IFluidDataStoreRuntime, id?: string) {\n return runtime.createChannel(id, TaskManagerFactory.Type) as TaskManager;\n }\n\n /\n Get a factory for TaskManager to register with the data store.\n \n @returns a factory that creates and load TaskManager\n /\n public static getFactory(): IChannelFactory {\n return new TaskManagerFactory();\n }\n\n /\n Mapping of taskId to a queue of clientIds that are waiting on the task. Maintains the consensus state of the\n * queue, even if we know we've submitted an op that should eventually modify the queue.\n /\n private readonly taskQueues: Map<string, string[]> = new Map();\n\n // opWatcher emits for every op on this data store. This is just a repackaging of processCore into events.\n private readonly opWatcher: EventEmitter = new EventEmitter();\n // queueWatcher emits an event whenever the consensus state of the task queues changes\n private readonly queueWatcher: EventEmitter = new EventEmitter();\n // abandonWatcher emits an event whenever the local client calls abandon() on a task.\n private readonly abandonWatcher: EventEmitter = new EventEmitter();\n // connectionWatcher emits an event whenever we get connected or disconnected.\n private readonly connectionWatcher: EventEmitter = new EventEmitter();\n // completedWatcher emits an event whenever the local client receives a completed op.\n private readonly completedWatcher: EventEmitter = new EventEmitter();\n\n private messageId: number = -1;\n /\n Tracks the most recent pending op for a given task\n /\n private readonly latestPendingOps: Map<string, IPendingOp> = new Map();\n\n /\n Tracks tasks that are this client is currently subscribed to.\n /\n private readonly subscribedTasks: Set<string> = new Set();\n\n /\n Map to track tasks that have pending complete ops.\n /\n private readonly pendingCompletedTasks: Map<string, number[]> = new Map();\n\n /\n Returns the clientId. Will return a placeholder if the runtime is detached and not yet assigned a clientId.\n /\n private get clientId(): string \| undefined {\n return this.isAttached() ? this.runtime.clientId : placeholderClientId;\n }\n\n /\n Returns a ReadOnlyInfo object to determine current read/write permissions.\n /\n private get readOnlyInfo(): ReadOnlyInfo {\n return this.runtime.deltaManager.readOnlyInfo;\n }\n\n /\n Constructs a new task manager. If the object is non-local an id and service interfaces will\n * be provided\n \n @param runtime - data store runtime the task queue belongs to\n * @param id - optional name of the task queue\n /\n constructor(id: string, runtime: IFluidDataStoreRuntime, attributes: IChannelAttributes) {\n super(id, runtime, attributes, \"fluid_taskManager_\");\n\n this.opWatcher.on(\"volunteer\", (taskId: string, clientId: string, local: boolean, messageId: number) => {\n // We're tracking local ops from this connection. Filter out local ops during \"connecting\"\n // state since these were sent on the prior connection and were already cleared from the latestPendingOps.\n if (runtime.connected && local) {\n const pendingOp = this.latestPendingOps.get(taskId);\n assert(pendingOp !== undefined, 0x07b / \"Unexpected op\" /);\n // Need to check the id, since it's possible to volunteer and abandon multiple times before the acks\n if (messageId === pendingOp.messageId) {\n assert(pendingOp.type === \"volunteer\", 0x07c / \"Unexpected op type\" /);\n // Delete the pending, because we no longer have an outstanding op\n this.latestPendingOps.delete(taskId);\n }\n }\n\n this.addClientToQueue(taskId, clientId);\n });\n\n this.opWatcher.on(\"abandon\", (taskId: string, clientId: string, local: boolean, messageId: number) => {\n if (runtime.connected && local) {\n const pendingOp = this.latestPendingOps.get(taskId);\n assert(pendingOp !== undefined, 0x07d / \"Unexpected op\" /);\n // Need to check the id, since it's possible to abandon and volunteer multiple times before the acks\n if (messageId === pendingOp.messageId) {\n assert(pendingOp.type === \"abandon\", 0x07e / \"Unexpected op type\" /);\n // Delete the pending, because we no longer have an outstanding op\n this.latestPendingOps.delete(taskId);\n }\n }\n\n this.removeClientFromQueue(taskId, clientId);\n });\n\n this.opWatcher.on(\"complete\", (taskId: string, clientId: string, local: boolean, messageId: number) => {\n if (runtime.connected && local) {\n const pendingOp = this.latestPendingOps.get(taskId);\n assert(pendingOp !== undefined, 0x400 / Unexpected op /);\n // Need to check the id, since it's possible to complete multiple times before the acks\n if (messageId === pendingOp.messageId) {\n assert(pendingOp.type === \"complete\", 0x401 / Unexpected op type /);\n // Delete the pending, because we no longer have an outstanding op\n this.latestPendingOps.delete(taskId);\n }\n\n // Remove complete op from this.pendingCompletedTasks\n const pendingIds = this.pendingCompletedTasks.get(taskId);\n assert(pendingIds !== undefined && pendingIds.length > 0, 0x402 / pendingIds is empty /);\n const removed = pendingIds.shift();\n assert(removed === messageId, 0x403 / Removed complete op id does not match /);\n }\n\n // For clients in queue, we need to remove them from the queue and raise the proper events.\n if (!local) {\n this.taskQueues.delete(taskId);\n this.completedWatcher.emit(\"completed\", taskId);\n this.emit(\"completed\", taskId);\n }\n });\n\n runtime.getQuorum().on(\"removeMember\", (clientId: string) => {\n this.removeClientFromAllQueues(clientId);\n });\n\n this.queueWatcher.on(\"queueChange\", (taskId: string, oldLockHolder: string, newLockHolder: string) => {\n // If oldLockHolder is placeholderClientId we need to emit the task was lost during the attach process\n if (oldLockHolder === placeholderClientId) {\n this.emit(\"lost\", taskId);\n return;\n }\n\n // Exit early if we are still catching up on reconnect -- we can't be the leader yet anyway.\n if (this.clientId === undefined) {\n return;\n }\n\n if (oldLockHolder !== this.clientId && newLockHolder === this.clientId) {\n this.emit(\"assigned\", taskId);\n } else if (oldLockHolder === this.clientId && newLockHolder !== this.clientId) {\n this.emit(\"lost\", taskId);\n }\n });\n\n this.connectionWatcher.on(\"disconnect\", () => {\n assert(this.clientId !== undefined, 0x1d3 / \"Missing client id on disconnect\" /);\n\n // We don't modify the taskQueues on disconnect (they still reflect the latest known consensus state).\n // After reconnect these will get cleaned up by observing the clientLeaves.\n // However we do need to recognize that we lost the lock if we had it. Calls to .queued() and\n // .assigned() are also connection-state-aware to be consistent.\n for (const [taskId, clientQueue] of this.taskQueues.entries()) {\n if (this.isAttached() && clientQueue[0] === this.clientId) {\n this.emit(\"lost\", taskId);\n }\n }\n\n // All of our outstanding ops will be for the old clientId even if they get ack'd\n this.latestPendingOps.clear();\n });\n }\n\n private submitVolunteerOp(taskId: string) {\n const op: ITaskManagerVolunteerOperation = {\n type: \"volunteer\",\n taskId,\n };\n const pendingOp: IPendingOp = {\n type: \"volunteer\",\n messageId: ++this.messageId,\n };\n this.submitLocalMessage(op, pendingOp.messageId);\n this.latestPendingOps.set(taskId, pendingOp);\n }\n\n private submitAbandonOp(taskId: string) {\n const op: ITaskManagerAbandonOperation = {\n type: \"abandon\",\n taskId,\n };\n const pendingOp: IPendingOp = {\n type: \"abandon\",\n messageId: ++this.messageId,\n };\n this.submitLocalMessage(op, pendingOp.messageId);\n this.latestPendingOps.set(taskId, pendingOp);\n }\n\n private submitCompleteOp(taskId: string) {\n const op: ITaskManagerCompletedOperation = {\n type: \"complete\",\n taskId,\n };\n const pendingOp: IPendingOp = {\n type: \"complete\",\n messageId: ++this.messageId,\n };\n\n if (this.pendingCompletedTasks.has(taskId)) {\n this.pendingCompletedTasks.get(taskId)?.push(pendingOp.messageId);\n } else {\n this.pendingCompletedTasks.set(taskId, [pendingOp.messageId]);\n }\n\n this.submitLocalMessage(op, pendingOp.messageId);\n this.latestPendingOps.set(taskId, pendingOp);\n }\n\n /\n {@inheritDoc ITaskManager.volunteerForTask}\n /\n public async volunteerForTask(taskId: string) {\n // If we have the lock, resolve immediately\n if (this.assigned(taskId)) {\n return true;\n }\n\n if (this.readOnlyInfo.readonly === true) {\n const error = this.readOnlyInfo.permissions === true ?\n new Error(`Attempted to volunteer with read-only permissions: ${taskId}`) :\n new Error(`Attempted to volunteer in read-only state: ${taskId}`);\n throw error;\n }\n\n if (!this.isAttached()) {\n // Simulate auto-ack in detached scenario\n assert(this.clientId !== undefined, 0x472 / clientId should not be undefined /);\n this.addClientToQueue(taskId, this.clientId);\n return true;\n }\n\n if (!this.connected) {\n throw new Error(`Attempted to volunteer in disconnected state: ${taskId}`);\n }\n\n // This promise works even if we already have an outstanding volunteer op.\n const lockAcquireP = new Promise<boolean>((resolve, reject) => {\n const checkIfAcquiredLock = (eventTaskId: string) => {\n if (eventTaskId !== taskId) {\n return;\n }\n\n // Also check pending ops here because it's possible we are currently in the queue from a previous\n // lock attempt, but have an outstanding abandon AND the outstanding volunteer for this lock attempt.\n // If we reach the head of the queue based on the previous lock attempt, we don't want to resolve.\n if (this.assigned(taskId) && !this.latestPendingOps.has(taskId)) {\n this.queueWatcher.off(\"queueChange\", checkIfAcquiredLock);\n this.abandonWatcher.off(\"abandon\", checkIfAbandoned);\n this.connectionWatcher.off(\"disconnect\", rejectOnDisconnect);\n this.completedWatcher.off(\"completed\", checkIfCompleted);\n resolve(true);\n }\n };\n\n const checkIfAbandoned = (eventTaskId: string) => {\n if (eventTaskId !== taskId) {\n return;\n }\n\n this.queueWatcher.off(\"queueChange\", checkIfAcquiredLock);\n this.abandonWatcher.off(\"abandon\", checkIfAbandoned);\n this.connectionWatcher.off(\"disconnect\", rejectOnDisconnect);\n this.completedWatcher.off(\"completed\", checkIfCompleted);\n reject(new Error(`Abandoned before acquiring task assignment: ${taskId}`));\n };\n\n const rejectOnDisconnect = () => {\n this.queueWatcher.off(\"queueChange\", checkIfAcquiredLock);\n this.abandonWatcher.off(\"abandon\", checkIfAbandoned);\n this.connectionWatcher.off(\"disconnect\", rejectOnDisconnect);\n this.completedWatcher.off(\"completed\", checkIfCompleted);\n reject(new Error(`Disconnected before acquiring task assignment: ${taskId}`));\n };\n\n const checkIfCompleted = (eventTaskId: string) => {\n if (eventTaskId !== taskId) {\n return;\n }\n\n this.queueWatcher.off(\"queueChange\", checkIfAcquiredLock);\n this.abandonWatcher.off(\"abandon\", checkIfAbandoned);\n this.connectionWatcher.off(\"disconnect\", rejectOnDisconnect);\n this.completedWatcher.off(\"completed\", checkIfCompleted);\n resolve(false);\n };\n\n this.queueWatcher.on(\"queueChange\", checkIfAcquiredLock);\n this.abandonWatcher.on(\"abandon\", checkIfAbandoned);\n this.connectionWatcher.on(\"disconnect\", rejectOnDisconnect);\n this.completedWatcher.on(\"completed\", checkIfCompleted);\n });\n\n if (!this.queued(taskId)) {\n this.submitVolunteerOp(taskId);\n }\n return lockAcquireP;\n }\n\n /\n {@inheritDoc ITaskManager.subscribeToTask}\n /\n public subscribeToTask(taskId: string) {\n if (this.subscribed(taskId)) {\n return;\n }\n\n if (this.readOnlyInfo.readonly === true && this.readOnlyInfo.permissions === true) {\n throw new Error(`Attempted to subscribe with read-only permissions: ${taskId}`);\n }\n\n const submitVolunteerOp = () => {\n this.submitVolunteerOp(taskId);\n };\n\n const disconnectHandler = () => {\n // Wait to be connected again and then re-submit volunteer op\n this.connectionWatcher.once(\"connect\", submitVolunteerOp);\n };\n\n const checkIfAbandoned = (eventTaskId: string) => {\n if (eventTaskId !== taskId) {\n return;\n }\n\n this.abandonWatcher.off(\"abandon\", checkIfAbandoned);\n this.connectionWatcher.off(\"disconnect\", disconnectHandler);\n this.connectionWatcher.off(\"connect\", submitVolunteerOp);\n this.completedWatcher.off(\"completed\", checkIfCompleted);\n\n this.subscribedTasks.delete(taskId);\n };\n\n const checkIfCompleted = (eventTaskId: string) => {\n if (eventTaskId !== taskId) {\n return;\n }\n\n this.abandonWatcher.off(\"abandon\", checkIfAbandoned);\n this.connectionWatcher.off(\"disconnect\", disconnectHandler);\n this.connectionWatcher.off(\"connect\", submitVolunteerOp);\n this.completedWatcher.off(\"completed\", checkIfCompleted);\n\n this.subscribedTasks.delete(taskId);\n };\n\n this.abandonWatcher.on(\"abandon\", checkIfAbandoned);\n this.connectionWatcher.on(\"disconnect\", disconnectHandler);\n this.completedWatcher.on(\"completed\", checkIfCompleted);\n\n if (!this.isAttached()) {\n // Simulate auto-ack in detached scenario\n assert(this.clientId !== undefined, 0x473 / clientId should not be undefined /);\n this.addClientToQueue(taskId, this.clientId);\n // Because we volunteered with placeholderClientId, we need to wait for when we attach and are assigned\n // a real clientId. At that point we should re-enter the queue with a real volunteer op (assuming we are\n // connected).\n this.runtime.once(\"attached\", () => {\n if (this.queued(taskId)) {\n // If we are already queued, then we were able to replace the placeholderClientId with our real\n // clientId and no action is required.\n return;\n } else if (this.connected) {\n submitVolunteerOp();\n } else {\n this.connectionWatcher.once(\"connect\", () => {\n submitVolunteerOp();\n });\n }\n });\n } else if (!this.connected) {\n // If we are disconnected (and attached), wait to be connected and submit volunteer op\n disconnectHandler();\n } else if (!this.assigned(taskId) && !this.queued(taskId)) {\n submitVolunteerOp();\n }\n this.subscribedTasks.add(taskId);\n }\n\n /\n {@inheritDoc ITaskManager.abandon}\n /\n public abandon(taskId: string) {\n // Always allow abandon if the client is subscribed to allow clients to unsubscribe while disconnected.\n // Otherwise, we should check to make sure the client is both connected queued for the task before sending an\n // abandon op.\n if (!this.subscribed(taskId) && !this.queued(taskId)) {\n // Nothing to do\n return;\n }\n\n if (!this.isAttached()) {\n // Simulate auto-ack in detached scenario\n assert(this.clientId !== undefined, 0x474 / clientId is undefined /);\n this.removeClientFromQueue(taskId, this.clientId);\n this.abandonWatcher.emit(\"abandon\", taskId);\n return;\n }\n\n // If we're subscribed but not queued, we don't need to submit an abandon op (probably offline)\n if (this.queued(taskId)) {\n this.submitAbandonOp(taskId);\n }\n this.abandonWatcher.emit(\"abandon\", taskId);\n }\n\n /\n {@inheritDoc ITaskManager.assigned}\n /\n public assigned(taskId: string) {\n if (this.isAttached() && !this.connected) {\n return false;\n }\n\n const currentAssignee = this.taskQueues.get(taskId)?.[0];\n return currentAssignee !== undefined\n && currentAssignee === this.clientId\n && !this.latestPendingOps.has(taskId);\n }\n\n /\n {@inheritDoc ITaskManager.queued}\n /\n public queued(taskId: string) {\n if (this.isAttached() && !this.connected) {\n return false;\n }\n\n assert(this.clientId !== undefined, 0x07f / \"clientId undefined\" /);\n\n const clientQueue = this.taskQueues.get(taskId);\n // If we have no queue for the taskId, then no one has signed up for it.\n return (\n (clientQueue?.includes(this.clientId) ?? false)\n && !this.latestPendingOps.has(taskId)\n )\n \|\| this.latestPendingOps.get(taskId)?.type === \"volunteer\";\n }\n\n /\n {@inheritDoc ITaskManager.subscribed}\n /\n public subscribed(taskId: string): boolean {\n return this.subscribedTasks.has(taskId);\n }\n\n /\n {@inheritDoc ITaskManager.complete}\n /\n public complete(taskId: string): void {\n if (!this.assigned(taskId)) {\n throw new Error(`Attempted to mark task as complete while not being assigned: ${taskId}`);\n }\n\n // If we are detached we will simulate auto-ack for the complete op. Therefore we only need to send the op if\n // we are attached. Additionally, we don't need to check if we are connected while detached.\n if (this.isAttached()) {\n if (!this.connected) {\n throw new Error(`Attempted to complete task in disconnected state: ${taskId}`);\n }\n this.submitCompleteOp(taskId);\n }\n\n this.taskQueues.delete(taskId);\n this.completedWatcher.emit(\"completed\", taskId);\n this.emit(\"completed\", taskId);\n }\n\n /\n {@inheritDoc ITaskManager.canVolunteer}\n /\n public canVolunteer(): boolean {\n // A client can volunteer for a task if it's both connected to the delta stream and in write mode.\n // this.connected reflects that condition, but is unintuitive and may be changed in the future. This API allows\n // us to make changes to this.connected without affecting our guidance on how to check if a client is eligible\n // to volunteer for a task.\n return this.connected;\n }\n\n /\n Create a summary for the task manager\n \n @returns the summary of the current state of the task manager\n * @internal\n /\n protected summarizeCore(serializer: IFluidSerializer): ISummaryTreeWithStats {\n if (this.runtime.clientId !== undefined) {\n // If the runtime has been assigned an actual clientId by now, we can replace the placeholder clientIds\n // and maintain the task assignment.\n this.replacePlaceholderInAllQueues();\n } else {\n // If the runtime has still not been assigned a clientId, we should not summarize with the placeholder\n // clientIds and instead remove them from the queues and require the client to re-volunteer when assigned\n // a new clientId.\n this.removeClientFromAllQueues(placeholderClientId);\n }\n\n // Only include tasks if there are clients in the queue.\n const filteredMap = new Map<string, string[]>();\n this.taskQueues.forEach((queue: string[], taskId: string) => {\n if (queue.length > 0) {\n filteredMap.set(taskId, queue);\n }\n });\n const content = [...filteredMap.entries()];\n return createSingleBlobSummary(snapshotFileName, JSON.stringify(content));\n }\n\n /\n {@inheritDoc @fluidframework/shared-object-base#SharedObject.loadCore}\n * @internal\n /\n protected async loadCore(storage: IChannelStorageService): Promise<void> {\n const content = await readAndParse<[string, string[]][]>(storage, snapshotFileName);\n content.forEach(([taskId, clientIdQueue]) => {\n this.taskQueues.set(taskId, clientIdQueue);\n });\n this.scrubClientsNotInQuorum();\n }\n\n /\n @internal\n /\n protected initializeLocalCore() { }\n\n /\n {@inheritDoc @fluidframework/shared-object-base#SharedObject.onDisconnect}\n * @internal\n /\n protected onDisconnect() {\n this.connectionWatcher.emit(\"disconnect\");\n }\n\n /\n {@inheritDoc @fluidframework/shared-object-base#SharedObject.onConnect}\n * @internal\n /\n protected onConnect() {\n this.connectionWatcher.emit(\"connect\");\n }\n\n //\n /\n Override resubmit core to avoid resubmission on reconnect. On disconnect we accept our removal from the\n * queues, and leave it up to the user to decide whether they want to attempt to re-enter a queue on reconnect.\n * @internal\n /\n protected reSubmitCore() { }\n\n /\n Process a task manager operation\n \n @param message - the message to prepare\n * @param local - whether the message was sent by the local client\n * @param localOpMetadata - For local client messages, this is the metadata that was submitted with the message.\n * For messages from a remote client, this will be undefined.\n * @internal\n /\n protected processCore(message: ISequencedDocumentMessage, local: boolean, localOpMetadata: unknown) {\n if (message.type === MessageType.Operation) {\n const op = message.contents as ITaskManagerOperation;\n const messageId = localOpMetadata as number;\n\n switch (op.type) {\n case \"volunteer\":\n this.opWatcher.emit(\"volunteer\", op.taskId, message.clientId, local, messageId);\n break;\n\n case \"abandon\":\n this.opWatcher.emit(\"abandon\", op.taskId, message.clientId, local, messageId);\n break;\n\n case \"complete\":\n this.opWatcher.emit(\"complete\", op.taskId, message.clientId, local, messageId);\n break;\n\n default:\n throw new Error(\"Unknown operation\");\n }\n }\n }\n\n private addClientToQueue(taskId: string, clientId: string) {\n const pendingIds = this.pendingCompletedTasks.get(taskId);\n if (pendingIds !== undefined && pendingIds.length > 0) {\n // Ignore the volunteer op if we know this task is about to be completed\n return;\n }\n\n // Ensure that the clientId exists in the quorum, or it is placeholderClientId (detached scenario)\n if (this.runtime.getQuorum().getMembers().has(clientId) \|\| this.clientId === placeholderClientId) {\n // Create the queue if it doesn't exist, and push the client on the back.\n let clientQueue = this.taskQueues.get(taskId);\n if (clientQueue === undefined) {\n clientQueue = [];\n this.taskQueues.set(taskId, clientQueue);\n }\n\n const oldLockHolder = clientQueue[0];\n clientQueue.push(clientId);\n const newLockHolder = clientQueue[0];\n if (newLockHolder !== oldLockHolder) {\n this.queueWatcher.emit(\"queueChange\", taskId, oldLockHolder, newLockHolder);\n }\n\n }\n }\n\n private removeClientFromQueue(taskId: string, clientId: string) {\n const clientQueue = this.taskQueues.get(taskId);\n if (clientQueue === undefined) {\n return;\n }\n\n const oldLockHolder = clientId === placeholderClientId ? placeholderClientId : clientQueue[0];\n const clientIdIndex = clientQueue.indexOf(clientId);\n if (clientIdIndex !== -1) {\n clientQueue.splice(clientIdIndex, 1);\n // Clean up the queue if there are no more clients in it.\n if (clientQueue.length === 0) {\n this.taskQueues.delete(taskId);\n }\n }\n const newLockHolder = clientQueue[0];\n if (newLockHolder !== oldLockHolder) {\n this.queueWatcher.emit(\"queueChange\", taskId, oldLockHolder, newLockHolder);\n }\n }\n\n private removeClientFromAllQueues(clientId: string) {\n for (const taskId of this.taskQueues.keys()) {\n this.removeClientFromQueue(taskId, clientId);\n }\n }\n\n /\n Will replace all instances of the placeholderClientId with the current clientId. This should only be called when\n * transitioning from detached to attached and this.runtime.clientId is defined.\n /\n private replacePlaceholderInAllQueues() {\n assert(this.runtime.clientId !== undefined, 0x475 / this.runtime.clientId should be defined */);\n for (const clientQueue of this.taskQueues.values()) {\n const clientIdIndex = clientQueue.indexOf(placeholderClientId);\n if (clientIdIndex !== -1) {\n clientQueue[clientIdIndex] = this.runtime.clientId;\n }\n }\n }\n\n // This seems like it should be unnecessary if we can trust to receive the join/leave messages and\n // also have an accurate snapshot.\n private scrubClientsNotInQuorum() {\n const quorum = this.runtime.getQuorum();\n for (const [taskId, clientQueue] of this.taskQueues) {\n const filteredClientQueue = clientQueue.filter((clientId) => quorum.getMember(clientId) !== undefined);\n if (clientQueue.length !== filteredClientQueue.length) {\n if (filteredClientQueue.length === 0) {\n this.taskQueues.delete(taskId);\n } else {\n this.taskQueues.set(taskId, filteredClientQueue);\n }\n this.queueWatcher.emit(\"queueChange\", taskId);\n }\n }\n }\n\n public applyStashedOp() {\n throw new Error(\"not implemented\");\n }\n}\n"]}
1	+ {"version":3,"file":"taskManager.js","sourceRoot":"","sources":["../src/taskManager.ts"],"names":[],"mappings":"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","sourcesContent":["/!\n Copyright (c) Microsoft Corporation and contributors. All rights reserved.\n * Licensed under the MIT License.\n /\n\nimport { EventEmitter } from \"events\";\n\nimport { assert } from \"@fluidframework/common-utils\";\nimport { ISequencedDocumentMessage, MessageType } from \"@fluidframework/protocol-definitions\";\nimport {\n IChannelAttributes,\n IFluidDataStoreRuntime,\n IChannelStorageService,\n IChannelFactory,\n} from \"@fluidframework/datastore-definitions\";\nimport { ISummaryTreeWithStats } from \"@fluidframework/runtime-definitions\";\nimport { readAndParse } from \"@fluidframework/driver-utils\";\nimport { createSingleBlobSummary, IFluidSerializer, SharedObject } from \"@fluidframework/shared-object-base\";\nimport { ReadOnlyInfo } from \"@fluidframework/container-definitions\";\nimport { TaskManagerFactory } from \"./taskManagerFactory\";\nimport { ITaskManager, ITaskManagerEvents } from \"./interfaces\";\n\n/\n Description of a task manager operation\n /\ntype ITaskManagerOperation =\n ITaskManagerVolunteerOperation \|\n ITaskManagerAbandonOperation \|\n ITaskManagerCompletedOperation;\n\ninterface ITaskManagerVolunteerOperation {\n type: \"volunteer\";\n taskId: string;\n}\n\ninterface ITaskManagerAbandonOperation {\n type: \"abandon\";\n taskId: string;\n}\n\ninterface ITaskManagerCompletedOperation {\n type: \"complete\";\n taskId: string;\n}\n\ninterface IPendingOp {\n type: \"volunteer\" \| \"abandon\" \| \"complete\";\n messageId: number;\n}\n\nconst snapshotFileName = \"header\";\n\n/\n Placeholder clientId for detached scenarios.\n /\nconst placeholderClientId = \"placeholder\";\n\n\n/\n The TaskManager distributed data structure tracks queues of clients that want to exclusively run a task.\n \n @remarks\n \n For an in-depth overview, see [TaskManager](https://fluidframework.com/docs/data-structures/task-manager/).\n \n ### Creation\n \n To create a `TaskManager`, call the static create method:\n \n ```typescript\n * const taskManager = TaskManager.create(this.runtime, id);\n * ```\n \n ### Usage\n \n To volunteer for a task, use the `volunteerForTask()` method. This returns a Promise that will resolve once the\n * client has acquired exclusive rights to run the task, or reject if the client is removed from the queue without\n * acquiring the rights.\n \n ```typescript\n * taskManager.volunteerForTask(\"NameOfTask\")\n * .then(() => { doTheTask(); })\n * .catch((err) => { console.error(err); });\n * ```\n \n Alternatively, you can indefinitely volunteer for a task with the synchronous `subscribeToTask()` method. This\n * method does not return a value, therefore you need to rely on eventing to know when you have acquired the rights\n * to run the task (see below).\n \n ```typescript\n * taskManager.subscribeToTask(\"NameOfTask\");\n * ```\n \n To check if the local client is currently subscribed to a task, use the `subscribed()` method.\n * ```typescript\n * if (taskManager.subscribed(\"NameOfTask\")) {\n * console.log(\"This client is currently subscribed to the task.\");\n * }\n * ```\n \n To release the rights to the task, use the `abandon()` method. The next client in the queue will then get the\n * rights to run the task.\n \n ```typescript\n * taskManager.abandon(\"NameOfTask\");\n * ```\n \n To inspect your state in the queue, you can use the `queued()` and `assigned()` methods.\n \n ```typescript\n * if (taskManager.queued(\"NameOfTask\")) {\n * console.log(\"This client is somewhere in the queue, potentially even having the task assignment.\");\n * }\n \n if (taskManager.assigned(\"NameOfTask\")) {\n * console.log(\"This client currently has the rights to run the task\");\n * }\n * ```\n \n To signal to other connected clients that a task is completed, use the `complete()` method. This will release all\n * clients from the queue and emit the \"completed\" event.\n \n ```typescript\n * taskManager.complete(\"NameOfTask\");\n * ```\n \n ### Eventing\n \n `TaskManager` is an `EventEmitter`, and will emit events when a task is assigned to the client, when the task\n * assignment is lost, and when a task was completed by another client.\n \n ```typescript\n * taskManager.on(\"assigned\", (taskId: string) => {\n * console.log(`Client was assigned task: ${taskId}`);\n * });\n \n taskManager.on(\"lost\", (taskId: string) => {\n * console.log(`Client released task: ${taskId}`);\n * });\n \n taskManager.on(\"completed\", (taskId: string) => {\n * console.log(`Another client completed task: ${taskId}`);\n * });\n * ```\n \n These can be useful if the logic to volunteer for a task is separated from the logic to perform the task, such as\n * when using the `subscribeToTask()` method.\n /\nexport class TaskManager extends SharedObject<ITaskManagerEvents> implements ITaskManager {\n /\n Create a new TaskManager\n \n @param runtime - data store runtime the new task queue belongs to\n * @param id - optional name of the task queue\n * @returns newly create task queue (but not attached yet)\n /\n public static create(runtime: IFluidDataStoreRuntime, id?: string) {\n return runtime.createChannel(id, TaskManagerFactory.Type) as TaskManager;\n }\n\n /\n Get a factory for TaskManager to register with the data store.\n \n @returns a factory that creates and load TaskManager\n /\n public static getFactory(): IChannelFactory {\n return new TaskManagerFactory();\n }\n\n /\n Mapping of taskId to a queue of clientIds that are waiting on the task. Maintains the consensus state of the\n * queue, even if we know we've submitted an op that should eventually modify the queue.\n /\n private readonly taskQueues: Map<string, string[]> = new Map();\n\n // opWatcher emits for every op on this data store. This is just a repackaging of processCore into events.\n private readonly opWatcher: EventEmitter = new EventEmitter();\n // queueWatcher emits an event whenever the consensus state of the task queues changes\n private readonly queueWatcher: EventEmitter = new EventEmitter();\n // abandonWatcher emits an event whenever the local client calls abandon() on a task.\n private readonly abandonWatcher: EventEmitter = new EventEmitter();\n // connectionWatcher emits an event whenever we get connected or disconnected.\n private readonly connectionWatcher: EventEmitter = new EventEmitter();\n // completedWatcher emits an event whenever the local client receives a completed op.\n private readonly completedWatcher: EventEmitter = new EventEmitter();\n\n private messageId: number = -1;\n /\n Tracks the most recent pending op for a given task\n /\n private readonly latestPendingOps: Map<string, IPendingOp> = new Map();\n\n /\n Tracks tasks that are this client is currently subscribed to.\n /\n private readonly subscribedTasks: Set<string> = new Set();\n\n /\n Map to track tasks that have pending complete ops.\n /\n private readonly pendingCompletedTasks: Map<string, number[]> = new Map();\n\n /\n Returns the clientId. Will return a placeholder if the runtime is detached and not yet assigned a clientId.\n /\n private get clientId(): string \| undefined {\n return this.isAttached() ? this.runtime.clientId : placeholderClientId;\n }\n\n /\n Returns a ReadOnlyInfo object to determine current read/write permissions.\n /\n private get readOnlyInfo(): ReadOnlyInfo {\n return this.runtime.deltaManager.readOnlyInfo;\n }\n\n /\n Constructs a new task manager. If the object is non-local an id and service interfaces will\n * be provided\n \n @param runtime - data store runtime the task queue belongs to\n * @param id - optional name of the task queue\n /\n constructor(id: string, runtime: IFluidDataStoreRuntime, attributes: IChannelAttributes) {\n super(id, runtime, attributes, \"fluid_taskManager_\");\n\n this.opWatcher.on(\"volunteer\", (taskId: string, clientId: string, local: boolean, messageId: number) => {\n // We're tracking local ops from this connection. Filter out local ops during \"connecting\"\n // state since these were sent on the prior connection and were already cleared from the latestPendingOps.\n if (runtime.connected && local) {\n const pendingOp = this.latestPendingOps.get(taskId);\n assert(pendingOp !== undefined, 0x07b / \"Unexpected op\" /);\n // Need to check the id, since it's possible to volunteer and abandon multiple times before the acks\n if (messageId === pendingOp.messageId) {\n assert(pendingOp.type === \"volunteer\", 0x07c / \"Unexpected op type\" /);\n // Delete the pending, because we no longer have an outstanding op\n this.latestPendingOps.delete(taskId);\n }\n }\n\n this.addClientToQueue(taskId, clientId);\n });\n\n this.opWatcher.on(\"abandon\", (taskId: string, clientId: string, local: boolean, messageId: number) => {\n if (runtime.connected && local) {\n const pendingOp = this.latestPendingOps.get(taskId);\n assert(pendingOp !== undefined, 0x07d / \"Unexpected op\" /);\n // Need to check the id, since it's possible to abandon and volunteer multiple times before the acks\n if (messageId === pendingOp.messageId) {\n assert(pendingOp.type === \"abandon\", 0x07e / \"Unexpected op type\" /);\n // Delete the pending, because we no longer have an outstanding op\n this.latestPendingOps.delete(taskId);\n }\n }\n\n this.removeClientFromQueue(taskId, clientId);\n });\n\n this.opWatcher.on(\"complete\", (taskId: string, clientId: string, local: boolean, messageId: number) => {\n if (runtime.connected && local) {\n const pendingOp = this.latestPendingOps.get(taskId);\n assert(pendingOp !== undefined, 0x400 / Unexpected op /);\n // Need to check the id, since it's possible to complete multiple times before the acks\n if (messageId === pendingOp.messageId) {\n assert(pendingOp.type === \"complete\", 0x401 / Unexpected op type /);\n // Delete the pending, because we no longer have an outstanding op\n this.latestPendingOps.delete(taskId);\n }\n\n // Remove complete op from this.pendingCompletedTasks\n const pendingIds = this.pendingCompletedTasks.get(taskId);\n assert(pendingIds !== undefined && pendingIds.length > 0, 0x402 / pendingIds is empty /);\n const removed = pendingIds.shift();\n assert(removed === messageId, 0x403 / Removed complete op id does not match /);\n }\n\n // For clients in queue, we need to remove them from the queue and raise the proper events.\n if (!local) {\n this.taskQueues.delete(taskId);\n this.completedWatcher.emit(\"completed\", taskId);\n this.emit(\"completed\", taskId);\n }\n });\n\n runtime.getQuorum().on(\"removeMember\", (clientId: string) => {\n this.removeClientFromAllQueues(clientId);\n });\n\n this.queueWatcher.on(\"queueChange\", (taskId: string, oldLockHolder: string, newLockHolder: string) => {\n // If oldLockHolder is placeholderClientId we need to emit the task was lost during the attach process\n if (oldLockHolder === placeholderClientId) {\n this.emit(\"lost\", taskId);\n return;\n }\n\n // Exit early if we are still catching up on reconnect -- we can't be the leader yet anyway.\n if (this.clientId === undefined) {\n return;\n }\n\n if (oldLockHolder !== this.clientId && newLockHolder === this.clientId) {\n this.emit(\"assigned\", taskId);\n } else if (oldLockHolder === this.clientId && newLockHolder !== this.clientId) {\n this.emit(\"lost\", taskId);\n }\n });\n\n this.connectionWatcher.on(\"disconnect\", () => {\n assert(this.clientId !== undefined, 0x1d3 / \"Missing client id on disconnect\" /);\n\n // We don't modify the taskQueues on disconnect (they still reflect the latest known consensus state).\n // After reconnect these will get cleaned up by observing the clientLeaves.\n // However we do need to recognize that we lost the lock if we had it. Calls to .queued() and\n // .assigned() are also connection-state-aware to be consistent.\n for (const [taskId, clientQueue] of this.taskQueues.entries()) {\n if (this.isAttached() && clientQueue[0] === this.clientId) {\n this.emit(\"lost\", taskId);\n }\n }\n\n // All of our outstanding ops will be for the old clientId even if they get ack'd\n this.latestPendingOps.clear();\n });\n }\n\n private submitVolunteerOp(taskId: string) {\n const op: ITaskManagerVolunteerOperation = {\n type: \"volunteer\",\n taskId,\n };\n const pendingOp: IPendingOp = {\n type: \"volunteer\",\n messageId: ++this.messageId,\n };\n this.submitLocalMessage(op, pendingOp.messageId);\n this.latestPendingOps.set(taskId, pendingOp);\n }\n\n private submitAbandonOp(taskId: string) {\n const op: ITaskManagerAbandonOperation = {\n type: \"abandon\",\n taskId,\n };\n const pendingOp: IPendingOp = {\n type: \"abandon\",\n messageId: ++this.messageId,\n };\n this.submitLocalMessage(op, pendingOp.messageId);\n this.latestPendingOps.set(taskId, pendingOp);\n }\n\n private submitCompleteOp(taskId: string) {\n const op: ITaskManagerCompletedOperation = {\n type: \"complete\",\n taskId,\n };\n const pendingOp: IPendingOp = {\n type: \"complete\",\n messageId: ++this.messageId,\n };\n\n if (this.pendingCompletedTasks.has(taskId)) {\n this.pendingCompletedTasks.get(taskId)?.push(pendingOp.messageId);\n } else {\n this.pendingCompletedTasks.set(taskId, [pendingOp.messageId]);\n }\n\n this.submitLocalMessage(op, pendingOp.messageId);\n this.latestPendingOps.set(taskId, pendingOp);\n }\n\n /\n {@inheritDoc ITaskManager.volunteerForTask}\n /\n public async volunteerForTask(taskId: string) {\n // If we have the lock, resolve immediately\n if (this.assigned(taskId)) {\n return true;\n }\n\n if (this.readOnlyInfo.readonly === true) {\n const error = this.readOnlyInfo.permissions === true ?\n new Error(\"Attempted to volunteer with read-only permissions\") :\n new Error(\"Attempted to volunteer in read-only state\");\n throw error;\n }\n\n if (!this.isAttached()) {\n // Simulate auto-ack in detached scenario\n assert(this.clientId !== undefined, 0x472 / clientId should not be undefined /);\n this.addClientToQueue(taskId, this.clientId);\n return true;\n }\n\n if (!this.connected) {\n throw new Error(\"Attempted to volunteer in disconnected state\");\n }\n\n // This promise works even if we already have an outstanding volunteer op.\n const lockAcquireP = new Promise<boolean>((resolve, reject) => {\n const checkIfAcquiredLock = (eventTaskId: string) => {\n if (eventTaskId !== taskId) {\n return;\n }\n\n // Also check pending ops here because it's possible we are currently in the queue from a previous\n // lock attempt, but have an outstanding abandon AND the outstanding volunteer for this lock attempt.\n // If we reach the head of the queue based on the previous lock attempt, we don't want to resolve.\n if (this.assigned(taskId) && !this.latestPendingOps.has(taskId)) {\n this.queueWatcher.off(\"queueChange\", checkIfAcquiredLock);\n this.abandonWatcher.off(\"abandon\", checkIfAbandoned);\n this.connectionWatcher.off(\"disconnect\", rejectOnDisconnect);\n this.completedWatcher.off(\"completed\", checkIfCompleted);\n resolve(true);\n }\n };\n\n const checkIfAbandoned = (eventTaskId: string) => {\n if (eventTaskId !== taskId) {\n return;\n }\n\n this.queueWatcher.off(\"queueChange\", checkIfAcquiredLock);\n this.abandonWatcher.off(\"abandon\", checkIfAbandoned);\n this.connectionWatcher.off(\"disconnect\", rejectOnDisconnect);\n this.completedWatcher.off(\"completed\", checkIfCompleted);\n reject(new Error(\"Abandoned before acquiring task assignment\"));\n };\n\n const rejectOnDisconnect = () => {\n this.queueWatcher.off(\"queueChange\", checkIfAcquiredLock);\n this.abandonWatcher.off(\"abandon\", checkIfAbandoned);\n this.connectionWatcher.off(\"disconnect\", rejectOnDisconnect);\n this.completedWatcher.off(\"completed\", checkIfCompleted);\n reject(new Error(\"Disconnected before acquiring task assignment\"));\n };\n\n const checkIfCompleted = (eventTaskId: string) => {\n if (eventTaskId !== taskId) {\n return;\n }\n\n this.queueWatcher.off(\"queueChange\", checkIfAcquiredLock);\n this.abandonWatcher.off(\"abandon\", checkIfAbandoned);\n this.connectionWatcher.off(\"disconnect\", rejectOnDisconnect);\n this.completedWatcher.off(\"completed\", checkIfCompleted);\n resolve(false);\n };\n\n this.queueWatcher.on(\"queueChange\", checkIfAcquiredLock);\n this.abandonWatcher.on(\"abandon\", checkIfAbandoned);\n this.connectionWatcher.on(\"disconnect\", rejectOnDisconnect);\n this.completedWatcher.on(\"completed\", checkIfCompleted);\n });\n\n if (!this.queued(taskId)) {\n this.submitVolunteerOp(taskId);\n }\n return lockAcquireP;\n }\n\n /\n {@inheritDoc ITaskManager.subscribeToTask}\n /\n public subscribeToTask(taskId: string) {\n if (this.subscribed(taskId)) {\n return;\n }\n\n if (this.readOnlyInfo.readonly === true && this.readOnlyInfo.permissions === true) {\n throw new Error(\"Attempted to subscribe with read-only permissions\");\n }\n\n const submitVolunteerOp = () => {\n this.submitVolunteerOp(taskId);\n };\n\n const disconnectHandler = () => {\n // Wait to be connected again and then re-submit volunteer op\n this.connectionWatcher.once(\"connect\", submitVolunteerOp);\n };\n\n const checkIfAbandoned = (eventTaskId: string) => {\n if (eventTaskId !== taskId) {\n return;\n }\n\n this.abandonWatcher.off(\"abandon\", checkIfAbandoned);\n this.connectionWatcher.off(\"disconnect\", disconnectHandler);\n this.connectionWatcher.off(\"connect\", submitVolunteerOp);\n this.completedWatcher.off(\"completed\", checkIfCompleted);\n\n this.subscribedTasks.delete(taskId);\n };\n\n const checkIfCompleted = (eventTaskId: string) => {\n if (eventTaskId !== taskId) {\n return;\n }\n\n this.abandonWatcher.off(\"abandon\", checkIfAbandoned);\n this.connectionWatcher.off(\"disconnect\", disconnectHandler);\n this.connectionWatcher.off(\"connect\", submitVolunteerOp);\n this.completedWatcher.off(\"completed\", checkIfCompleted);\n\n this.subscribedTasks.delete(taskId);\n };\n\n this.abandonWatcher.on(\"abandon\", checkIfAbandoned);\n this.connectionWatcher.on(\"disconnect\", disconnectHandler);\n this.completedWatcher.on(\"completed\", checkIfCompleted);\n\n if (!this.isAttached()) {\n // Simulate auto-ack in detached scenario\n assert(this.clientId !== undefined, 0x473 / clientId should not be undefined /);\n this.addClientToQueue(taskId, this.clientId);\n // Because we volunteered with placeholderClientId, we need to wait for when we attach and are assigned\n // a real clientId. At that point we should re-enter the queue with a real volunteer op (assuming we are\n // connected).\n this.runtime.once(\"attached\", () => {\n if (this.queued(taskId)) {\n // If we are already queued, then we were able to replace the placeholderClientId with our real\n // clientId and no action is required.\n return;\n } else if (this.connected) {\n submitVolunteerOp();\n } else {\n this.connectionWatcher.once(\"connect\", () => {\n submitVolunteerOp();\n });\n }\n });\n } else if (!this.connected) {\n // If we are disconnected (and attached), wait to be connected and submit volunteer op\n disconnectHandler();\n } else if (!this.assigned(taskId) && !this.queued(taskId)) {\n submitVolunteerOp();\n }\n this.subscribedTasks.add(taskId);\n }\n\n /\n {@inheritDoc ITaskManager.abandon}\n /\n public abandon(taskId: string) {\n // Always allow abandon if the client is subscribed to allow clients to unsubscribe while disconnected.\n // Otherwise, we should check to make sure the client is both connected queued for the task before sending an\n // abandon op.\n if (!this.subscribed(taskId) && !this.queued(taskId)) {\n // Nothing to do\n return;\n }\n\n if (!this.isAttached()) {\n // Simulate auto-ack in detached scenario\n assert(this.clientId !== undefined, 0x474 / clientId is undefined /);\n this.removeClientFromQueue(taskId, this.clientId);\n this.abandonWatcher.emit(\"abandon\", taskId);\n return;\n }\n\n // If we're subscribed but not queued, we don't need to submit an abandon op (probably offline)\n if (this.queued(taskId)) {\n this.submitAbandonOp(taskId);\n }\n this.abandonWatcher.emit(\"abandon\", taskId);\n }\n\n /\n {@inheritDoc ITaskManager.assigned}\n /\n public assigned(taskId: string) {\n if (this.isAttached() && !this.connected) {\n return false;\n }\n\n const currentAssignee = this.taskQueues.get(taskId)?.[0];\n return currentAssignee !== undefined\n && currentAssignee === this.clientId\n && !this.latestPendingOps.has(taskId);\n }\n\n /\n {@inheritDoc ITaskManager.queued}\n /\n public queued(taskId: string) {\n if (this.isAttached() && !this.connected) {\n return false;\n }\n\n assert(this.clientId !== undefined, 0x07f / \"clientId undefined\" /);\n\n const clientQueue = this.taskQueues.get(taskId);\n // If we have no queue for the taskId, then no one has signed up for it.\n return (\n (clientQueue?.includes(this.clientId) ?? false)\n && !this.latestPendingOps.has(taskId)\n )\n \|\| this.latestPendingOps.get(taskId)?.type === \"volunteer\";\n }\n\n /\n {@inheritDoc ITaskManager.subscribed}\n /\n public subscribed(taskId: string): boolean {\n return this.subscribedTasks.has(taskId);\n }\n\n /\n {@inheritDoc ITaskManager.complete}\n /\n public complete(taskId: string): void {\n if (!this.assigned(taskId)) {\n throw new Error(\"Attempted to mark task as complete while not being assigned\");\n }\n\n // If we are detached we will simulate auto-ack for the complete op. Therefore we only need to send the op if\n // we are attached. Additionally, we don't need to check if we are connected while detached.\n if (this.isAttached()) {\n if (!this.connected) {\n throw new Error(\"Attempted to complete task in disconnected state\");\n }\n this.submitCompleteOp(taskId);\n }\n\n this.taskQueues.delete(taskId);\n this.completedWatcher.emit(\"completed\", taskId);\n this.emit(\"completed\", taskId);\n }\n\n /\n {@inheritDoc ITaskManager.canVolunteer}\n /\n public canVolunteer(): boolean {\n // A client can volunteer for a task if it's both connected to the delta stream and in write mode.\n // this.connected reflects that condition, but is unintuitive and may be changed in the future. This API allows\n // us to make changes to this.connected without affecting our guidance on how to check if a client is eligible\n // to volunteer for a task.\n return this.connected;\n }\n\n /\n Create a summary for the task manager\n \n @returns the summary of the current state of the task manager\n * @internal\n /\n protected summarizeCore(serializer: IFluidSerializer): ISummaryTreeWithStats {\n if (this.runtime.clientId !== undefined) {\n // If the runtime has been assigned an actual clientId by now, we can replace the placeholder clientIds\n // and maintain the task assignment.\n this.replacePlaceholderInAllQueues();\n } else {\n // If the runtime has still not been assigned a clientId, we should not summarize with the placeholder\n // clientIds and instead remove them from the queues and require the client to re-volunteer when assigned\n // a new clientId.\n this.removeClientFromAllQueues(placeholderClientId);\n }\n\n // Only include tasks if there are clients in the queue.\n const filteredMap = new Map<string, string[]>();\n this.taskQueues.forEach((queue: string[], taskId: string) => {\n if (queue.length > 0) {\n filteredMap.set(taskId, queue);\n }\n });\n const content = [...filteredMap.entries()];\n return createSingleBlobSummary(snapshotFileName, JSON.stringify(content));\n }\n\n /\n {@inheritDoc @fluidframework/shared-object-base#SharedObject.loadCore}\n * @internal\n /\n protected async loadCore(storage: IChannelStorageService): Promise<void> {\n const content = await readAndParse<[string, string[]][]>(storage, snapshotFileName);\n content.forEach(([taskId, clientIdQueue]) => {\n this.taskQueues.set(taskId, clientIdQueue);\n });\n this.scrubClientsNotInQuorum();\n }\n\n /\n @internal\n /\n protected initializeLocalCore() { }\n\n /\n {@inheritDoc @fluidframework/shared-object-base#SharedObject.onDisconnect}\n * @internal\n /\n protected onDisconnect() {\n this.connectionWatcher.emit(\"disconnect\");\n }\n\n /\n {@inheritDoc @fluidframework/shared-object-base#SharedObject.onConnect}\n * @internal\n /\n protected onConnect() {\n this.connectionWatcher.emit(\"connect\");\n }\n\n //\n /\n Override resubmit core to avoid resubmission on reconnect. On disconnect we accept our removal from the\n * queues, and leave it up to the user to decide whether they want to attempt to re-enter a queue on reconnect.\n * @internal\n /\n protected reSubmitCore() { }\n\n /\n Process a task manager operation\n \n @param message - the message to prepare\n * @param local - whether the message was sent by the local client\n * @param localOpMetadata - For local client messages, this is the metadata that was submitted with the message.\n * For messages from a remote client, this will be undefined.\n * @internal\n /\n protected processCore(message: ISequencedDocumentMessage, local: boolean, localOpMetadata: unknown) {\n if (message.type === MessageType.Operation) {\n const op = message.contents as ITaskManagerOperation;\n const messageId = localOpMetadata as number;\n\n switch (op.type) {\n case \"volunteer\":\n this.opWatcher.emit(\"volunteer\", op.taskId, message.clientId, local, messageId);\n break;\n\n case \"abandon\":\n this.opWatcher.emit(\"abandon\", op.taskId, message.clientId, local, messageId);\n break;\n\n case \"complete\":\n this.opWatcher.emit(\"complete\", op.taskId, message.clientId, local, messageId);\n break;\n\n default:\n throw new Error(\"Unknown operation\");\n }\n }\n }\n\n private addClientToQueue(taskId: string, clientId: string) {\n const pendingIds = this.pendingCompletedTasks.get(taskId);\n if (pendingIds !== undefined && pendingIds.length > 0) {\n // Ignore the volunteer op if we know this task is about to be completed\n return;\n }\n\n // Ensure that the clientId exists in the quorum, or it is placeholderClientId (detached scenario)\n if (this.runtime.getQuorum().getMembers().has(clientId) \|\| this.clientId === placeholderClientId) {\n // Create the queue if it doesn't exist, and push the client on the back.\n let clientQueue = this.taskQueues.get(taskId);\n if (clientQueue === undefined) {\n clientQueue = [];\n this.taskQueues.set(taskId, clientQueue);\n }\n\n const oldLockHolder = clientQueue[0];\n clientQueue.push(clientId);\n const newLockHolder = clientQueue[0];\n if (newLockHolder !== oldLockHolder) {\n this.queueWatcher.emit(\"queueChange\", taskId, oldLockHolder, newLockHolder);\n }\n\n }\n }\n\n private removeClientFromQueue(taskId: string, clientId: string) {\n const clientQueue = this.taskQueues.get(taskId);\n if (clientQueue === undefined) {\n return;\n }\n\n const oldLockHolder = clientId === placeholderClientId ? placeholderClientId : clientQueue[0];\n const clientIdIndex = clientQueue.indexOf(clientId);\n if (clientIdIndex !== -1) {\n clientQueue.splice(clientIdIndex, 1);\n // Clean up the queue if there are no more clients in it.\n if (clientQueue.length === 0) {\n this.taskQueues.delete(taskId);\n }\n }\n const newLockHolder = clientQueue[0];\n if (newLockHolder !== oldLockHolder) {\n this.queueWatcher.emit(\"queueChange\", taskId, oldLockHolder, newLockHolder);\n }\n }\n\n private removeClientFromAllQueues(clientId: string) {\n for (const taskId of this.taskQueues.keys()) {\n this.removeClientFromQueue(taskId, clientId);\n }\n }\n\n /\n Will replace all instances of the placeholderClientId with the current clientId. This should only be called when\n * transitioning from detached to attached and this.runtime.clientId is defined.\n /\n private replacePlaceholderInAllQueues() {\n assert(this.runtime.clientId !== undefined, 0x475 / this.runtime.clientId should be defined */);\n for (const clientQueue of this.taskQueues.values()) {\n const clientIdIndex = clientQueue.indexOf(placeholderClientId);\n if (clientIdIndex !== -1) {\n clientQueue[clientIdIndex] = this.runtime.clientId;\n }\n }\n }\n\n // This seems like it should be unnecessary if we can trust to receive the join/leave messages and\n // also have an accurate snapshot.\n private scrubClientsNotInQuorum() {\n const quorum = this.runtime.getQuorum();\n for (const [taskId, clientQueue] of this.taskQueues) {\n const filteredClientQueue = clientQueue.filter((clientId) => quorum.getMember(clientId) !== undefined);\n if (clientQueue.length !== filteredClientQueue.length) {\n if (filteredClientQueue.length === 0) {\n this.taskQueues.delete(taskId);\n } else {\n this.taskQueues.set(taskId, filteredClientQueue);\n }\n this.queueWatcher.emit(\"queueChange\", taskId);\n }\n }\n }\n\n public applyStashedOp() {\n throw new Error(\"not implemented\");\n }\n}\n"]}

package/lib/packageVersion.d.ts CHANGED Viewed

@@ -5,5 +5,5 @@
  * THIS IS AN AUTOGENERATED FILE. DO NOT EDIT THIS FILE DIRECTLY
  */
 export declare const pkgName = "@fluidframework/task-manager";
-export declare const pkgVersion = "2.0.0-internal.2.2.1";
+export declare const pkgVersion = "2.0.0-internal.2.3.1";
 //# sourceMappingURL=packageVersion.d.ts.map

package/lib/packageVersion.js CHANGED Viewed

@@ -5,5 +5,5 @@
  * THIS IS AN AUTOGENERATED FILE. DO NOT EDIT THIS FILE DIRECTLY
  */
 export const pkgName = "@fluidframework/task-manager";
-export const pkgVersion = "2.0.0-internal.2.2.1";
+export const pkgVersion = "2.0.0-internal.2.3.1";
 //# sourceMappingURL=packageVersion.js.map

package/lib/packageVersion.js.map CHANGED Viewed

	@@ -1 +1 @@
1	- {"version":3,"file":"packageVersion.js","sourceRoot":"","sources":["../src/packageVersion.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,MAAM,CAAC,MAAM,OAAO,GAAG,8BAA8B,CAAC;AACtD,MAAM,CAAC,MAAM,UAAU,GAAG,sBAAsB,CAAC","sourcesContent":["/!\n Copyright (c) Microsoft Corporation and contributors. All rights reserved.\n * Licensed under the MIT License.\n \n THIS IS AN AUTOGENERATED FILE. DO NOT EDIT THIS FILE DIRECTLY\n */\n\nexport const pkgName = \"@fluidframework/task-manager\";\nexport const pkgVersion = \"2.0.0-internal.2.2.1\";\n"]}
1	+ {"version":3,"file":"packageVersion.js","sourceRoot":"","sources":["../src/packageVersion.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,MAAM,CAAC,MAAM,OAAO,GAAG,8BAA8B,CAAC;AACtD,MAAM,CAAC,MAAM,UAAU,GAAG,sBAAsB,CAAC","sourcesContent":["/!\n Copyright (c) Microsoft Corporation and contributors. All rights reserved.\n * Licensed under the MIT License.\n \n THIS IS AN AUTOGENERATED FILE. DO NOT EDIT THIS FILE DIRECTLY\n */\n\nexport const pkgName = \"@fluidframework/task-manager\";\nexport const pkgVersion = \"2.0.0-internal.2.3.1\";\n"]}

package/lib/taskManager.js CHANGED Viewed

@@ -310,8 +310,8 @@ export class TaskManager extends SharedObject {
         }
         if (this.readOnlyInfo.readonly === true) {
             const error = this.readOnlyInfo.permissions === true ?
-                new Error(`Attempted to volunteer with read-only permissions: ${taskId}`) :
-                new Error(`Attempted to volunteer in read-only state: ${taskId}`);
+                new Error("Attempted to volunteer with read-only permissions") :
+                new Error("Attempted to volunteer in read-only state");
             throw error;
         }
         if (!this.isAttached()) {
@@ -321,7 +321,7 @@ export class TaskManager extends SharedObject {
             return true;
         }
         if (!this.connected) {
-            throw new Error(`Attempted to volunteer in disconnected state: ${taskId}`);
+            throw new Error("Attempted to volunteer in disconnected state");
         }
         // This promise works even if we already have an outstanding volunteer op.
         const lockAcquireP = new Promise((resolve, reject) => {
@@ -348,14 +348,14 @@ export class TaskManager extends SharedObject {
                 this.abandonWatcher.off("abandon", checkIfAbandoned);
                 this.connectionWatcher.off("disconnect", rejectOnDisconnect);
                 this.completedWatcher.off("completed", checkIfCompleted);
-                reject(new Error(`Abandoned before acquiring task assignment: ${taskId}`));
+                reject(new Error("Abandoned before acquiring task assignment"));
             };
             const rejectOnDisconnect = () => {
                 this.queueWatcher.off("queueChange", checkIfAcquiredLock);
                 this.abandonWatcher.off("abandon", checkIfAbandoned);
                 this.connectionWatcher.off("disconnect", rejectOnDisconnect);
                 this.completedWatcher.off("completed", checkIfCompleted);
-                reject(new Error(`Disconnected before acquiring task assignment: ${taskId}`));
+                reject(new Error("Disconnected before acquiring task assignment"));
             };
             const checkIfCompleted = (eventTaskId) => {
                 if (eventTaskId !== taskId) {
@@ -385,7 +385,7 @@ export class TaskManager extends SharedObject {
             return;
         }
         if (this.readOnlyInfo.readonly === true && this.readOnlyInfo.permissions === true) {
-            throw new Error(`Attempted to subscribe with read-only permissions: ${taskId}`);
+            throw new Error("Attempted to subscribe with read-only permissions");
         }
         const submitVolunteerOp = () => {
             this.submitVolunteerOp(taskId);
@@ -512,13 +512,13 @@ export class TaskManager extends SharedObject {
      */
     complete(taskId) {
         if (!this.assigned(taskId)) {
-            throw new Error(`Attempted to mark task as complete while not being assigned: ${taskId}`);
+            throw new Error("Attempted to mark task as complete while not being assigned");
         }
         // If we are detached we will simulate auto-ack for the complete op. Therefore we only need to send the op if
         // we are attached. Additionally, we don't need to check if we are connected while detached.
         if (this.isAttached()) {
             if (!this.connected) {
-                throw new Error(`Attempted to complete task in disconnected state: ${taskId}`);
+                throw new Error("Attempted to complete task in disconnected state");
             }
             this.submitCompleteOp(taskId);
         }

package/lib/taskManager.js.map CHANGED Viewed

	@@ -1 +1 @@
1	- {"version":3,"file":"taskManager.js","sourceRoot":"","sources":["../src/taskManager.ts"],"names":[],"mappings":"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","sourcesContent":["/!\n Copyright (c) Microsoft Corporation and contributors. All rights reserved.\n * Licensed under the MIT License.\n /\n\nimport { EventEmitter } from \"events\";\n\nimport { assert } from \"@fluidframework/common-utils\";\nimport { ISequencedDocumentMessage, MessageType } from \"@fluidframework/protocol-definitions\";\nimport {\n IChannelAttributes,\n IFluidDataStoreRuntime,\n IChannelStorageService,\n IChannelFactory,\n} from \"@fluidframework/datastore-definitions\";\nimport { ISummaryTreeWithStats } from \"@fluidframework/runtime-definitions\";\nimport { readAndParse } from \"@fluidframework/driver-utils\";\nimport { createSingleBlobSummary, IFluidSerializer, SharedObject } from \"@fluidframework/shared-object-base\";\nimport { ReadOnlyInfo } from \"@fluidframework/container-definitions\";\nimport { TaskManagerFactory } from \"./taskManagerFactory\";\nimport { ITaskManager, ITaskManagerEvents } from \"./interfaces\";\n\n/\n Description of a task manager operation\n /\ntype ITaskManagerOperation =\n ITaskManagerVolunteerOperation \|\n ITaskManagerAbandonOperation \|\n ITaskManagerCompletedOperation;\n\ninterface ITaskManagerVolunteerOperation {\n type: \"volunteer\";\n taskId: string;\n}\n\ninterface ITaskManagerAbandonOperation {\n type: \"abandon\";\n taskId: string;\n}\n\ninterface ITaskManagerCompletedOperation {\n type: \"complete\";\n taskId: string;\n}\n\ninterface IPendingOp {\n type: \"volunteer\" \| \"abandon\" \| \"complete\";\n messageId: number;\n}\n\nconst snapshotFileName = \"header\";\n\n/\n Placeholder clientId for detached scenarios.\n /\nconst placeholderClientId = \"placeholder\";\n\n\n/\n The TaskManager distributed data structure tracks queues of clients that want to exclusively run a task.\n \n @remarks\n \n For an in-depth overview, see [TaskManager](https://fluidframework.com/docs/data-structures/task-manager/).\n \n ### Creation\n \n To create a `TaskManager`, call the static create method:\n \n ```typescript\n * const taskManager = TaskManager.create(this.runtime, id);\n * ```\n \n ### Usage\n \n To volunteer for a task, use the `volunteerForTask()` method. This returns a Promise that will resolve once the\n * client has acquired exclusive rights to run the task, or reject if the client is removed from the queue without\n * acquiring the rights.\n \n ```typescript\n * taskManager.volunteerForTask(\"NameOfTask\")\n * .then(() => { doTheTask(); })\n * .catch((err) => { console.error(err); });\n * ```\n \n Alternatively, you can indefinitely volunteer for a task with the synchronous `subscribeToTask()` method. This\n * method does not return a value, therefore you need to rely on eventing to know when you have acquired the rights\n * to run the task (see below).\n \n ```typescript\n * taskManager.subscribeToTask(\"NameOfTask\");\n * ```\n \n To check if the local client is currently subscribed to a task, use the `subscribed()` method.\n * ```typescript\n * if (taskManager.subscribed(\"NameOfTask\")) {\n * console.log(\"This client is currently subscribed to the task.\");\n * }\n * ```\n \n To release the rights to the task, use the `abandon()` method. The next client in the queue will then get the\n * rights to run the task.\n \n ```typescript\n * taskManager.abandon(\"NameOfTask\");\n * ```\n \n To inspect your state in the queue, you can use the `queued()` and `assigned()` methods.\n \n ```typescript\n * if (taskManager.queued(\"NameOfTask\")) {\n * console.log(\"This client is somewhere in the queue, potentially even having the task assignment.\");\n * }\n \n if (taskManager.assigned(\"NameOfTask\")) {\n * console.log(\"This client currently has the rights to run the task\");\n * }\n * ```\n \n To signal to other connected clients that a task is completed, use the `complete()` method. This will release all\n * clients from the queue and emit the \"completed\" event.\n \n ```typescript\n * taskManager.complete(\"NameOfTask\");\n * ```\n \n ### Eventing\n \n `TaskManager` is an `EventEmitter`, and will emit events when a task is assigned to the client, when the task\n * assignment is lost, and when a task was completed by another client.\n \n ```typescript\n * taskManager.on(\"assigned\", (taskId: string) => {\n * console.log(`Client was assigned task: ${taskId}`);\n * });\n \n taskManager.on(\"lost\", (taskId: string) => {\n * console.log(`Client released task: ${taskId}`);\n * });\n \n taskManager.on(\"completed\", (taskId: string) => {\n * console.log(`Another client completed task: ${taskId}`);\n * });\n * ```\n \n These can be useful if the logic to volunteer for a task is separated from the logic to perform the task, such as\n * when using the `subscribeToTask()` method.\n /\nexport class TaskManager extends SharedObject<ITaskManagerEvents> implements ITaskManager {\n /\n Create a new TaskManager\n \n @param runtime - data store runtime the new task queue belongs to\n * @param id - optional name of the task queue\n * @returns newly create task queue (but not attached yet)\n /\n public static create(runtime: IFluidDataStoreRuntime, id?: string) {\n return runtime.createChannel(id, TaskManagerFactory.Type) as TaskManager;\n }\n\n /\n Get a factory for TaskManager to register with the data store.\n \n @returns a factory that creates and load TaskManager\n /\n public static getFactory(): IChannelFactory {\n return new TaskManagerFactory();\n }\n\n /\n Mapping of taskId to a queue of clientIds that are waiting on the task. Maintains the consensus state of the\n * queue, even if we know we've submitted an op that should eventually modify the queue.\n /\n private readonly taskQueues: Map<string, string[]> = new Map();\n\n // opWatcher emits for every op on this data store. This is just a repackaging of processCore into events.\n private readonly opWatcher: EventEmitter = new EventEmitter();\n // queueWatcher emits an event whenever the consensus state of the task queues changes\n private readonly queueWatcher: EventEmitter = new EventEmitter();\n // abandonWatcher emits an event whenever the local client calls abandon() on a task.\n private readonly abandonWatcher: EventEmitter = new EventEmitter();\n // connectionWatcher emits an event whenever we get connected or disconnected.\n private readonly connectionWatcher: EventEmitter = new EventEmitter();\n // completedWatcher emits an event whenever the local client receives a completed op.\n private readonly completedWatcher: EventEmitter = new EventEmitter();\n\n private messageId: number = -1;\n /\n Tracks the most recent pending op for a given task\n /\n private readonly latestPendingOps: Map<string, IPendingOp> = new Map();\n\n /\n Tracks tasks that are this client is currently subscribed to.\n /\n private readonly subscribedTasks: Set<string> = new Set();\n\n /\n Map to track tasks that have pending complete ops.\n /\n private readonly pendingCompletedTasks: Map<string, number[]> = new Map();\n\n /\n Returns the clientId. Will return a placeholder if the runtime is detached and not yet assigned a clientId.\n /\n private get clientId(): string \| undefined {\n return this.isAttached() ? this.runtime.clientId : placeholderClientId;\n }\n\n /\n Returns a ReadOnlyInfo object to determine current read/write permissions.\n /\n private get readOnlyInfo(): ReadOnlyInfo {\n return this.runtime.deltaManager.readOnlyInfo;\n }\n\n /\n Constructs a new task manager. If the object is non-local an id and service interfaces will\n * be provided\n \n @param runtime - data store runtime the task queue belongs to\n * @param id - optional name of the task queue\n /\n constructor(id: string, runtime: IFluidDataStoreRuntime, attributes: IChannelAttributes) {\n super(id, runtime, attributes, \"fluid_taskManager_\");\n\n this.opWatcher.on(\"volunteer\", (taskId: string, clientId: string, local: boolean, messageId: number) => {\n // We're tracking local ops from this connection. Filter out local ops during \"connecting\"\n // state since these were sent on the prior connection and were already cleared from the latestPendingOps.\n if (runtime.connected && local) {\n const pendingOp = this.latestPendingOps.get(taskId);\n assert(pendingOp !== undefined, 0x07b / \"Unexpected op\" /);\n // Need to check the id, since it's possible to volunteer and abandon multiple times before the acks\n if (messageId === pendingOp.messageId) {\n assert(pendingOp.type === \"volunteer\", 0x07c / \"Unexpected op type\" /);\n // Delete the pending, because we no longer have an outstanding op\n this.latestPendingOps.delete(taskId);\n }\n }\n\n this.addClientToQueue(taskId, clientId);\n });\n\n this.opWatcher.on(\"abandon\", (taskId: string, clientId: string, local: boolean, messageId: number) => {\n if (runtime.connected && local) {\n const pendingOp = this.latestPendingOps.get(taskId);\n assert(pendingOp !== undefined, 0x07d / \"Unexpected op\" /);\n // Need to check the id, since it's possible to abandon and volunteer multiple times before the acks\n if (messageId === pendingOp.messageId) {\n assert(pendingOp.type === \"abandon\", 0x07e / \"Unexpected op type\" /);\n // Delete the pending, because we no longer have an outstanding op\n this.latestPendingOps.delete(taskId);\n }\n }\n\n this.removeClientFromQueue(taskId, clientId);\n });\n\n this.opWatcher.on(\"complete\", (taskId: string, clientId: string, local: boolean, messageId: number) => {\n if (runtime.connected && local) {\n const pendingOp = this.latestPendingOps.get(taskId);\n assert(pendingOp !== undefined, 0x400 / Unexpected op /);\n // Need to check the id, since it's possible to complete multiple times before the acks\n if (messageId === pendingOp.messageId) {\n assert(pendingOp.type === \"complete\", 0x401 / Unexpected op type /);\n // Delete the pending, because we no longer have an outstanding op\n this.latestPendingOps.delete(taskId);\n }\n\n // Remove complete op from this.pendingCompletedTasks\n const pendingIds = this.pendingCompletedTasks.get(taskId);\n assert(pendingIds !== undefined && pendingIds.length > 0, 0x402 / pendingIds is empty /);\n const removed = pendingIds.shift();\n assert(removed === messageId, 0x403 / Removed complete op id does not match /);\n }\n\n // For clients in queue, we need to remove them from the queue and raise the proper events.\n if (!local) {\n this.taskQueues.delete(taskId);\n this.completedWatcher.emit(\"completed\", taskId);\n this.emit(\"completed\", taskId);\n }\n });\n\n runtime.getQuorum().on(\"removeMember\", (clientId: string) => {\n this.removeClientFromAllQueues(clientId);\n });\n\n this.queueWatcher.on(\"queueChange\", (taskId: string, oldLockHolder: string, newLockHolder: string) => {\n // If oldLockHolder is placeholderClientId we need to emit the task was lost during the attach process\n if (oldLockHolder === placeholderClientId) {\n this.emit(\"lost\", taskId);\n return;\n }\n\n // Exit early if we are still catching up on reconnect -- we can't be the leader yet anyway.\n if (this.clientId === undefined) {\n return;\n }\n\n if (oldLockHolder !== this.clientId && newLockHolder === this.clientId) {\n this.emit(\"assigned\", taskId);\n } else if (oldLockHolder === this.clientId && newLockHolder !== this.clientId) {\n this.emit(\"lost\", taskId);\n }\n });\n\n this.connectionWatcher.on(\"disconnect\", () => {\n assert(this.clientId !== undefined, 0x1d3 / \"Missing client id on disconnect\" /);\n\n // We don't modify the taskQueues on disconnect (they still reflect the latest known consensus state).\n // After reconnect these will get cleaned up by observing the clientLeaves.\n // However we do need to recognize that we lost the lock if we had it. Calls to .queued() and\n // .assigned() are also connection-state-aware to be consistent.\n for (const [taskId, clientQueue] of this.taskQueues.entries()) {\n if (this.isAttached() && clientQueue[0] === this.clientId) {\n this.emit(\"lost\", taskId);\n }\n }\n\n // All of our outstanding ops will be for the old clientId even if they get ack'd\n this.latestPendingOps.clear();\n });\n }\n\n private submitVolunteerOp(taskId: string) {\n const op: ITaskManagerVolunteerOperation = {\n type: \"volunteer\",\n taskId,\n };\n const pendingOp: IPendingOp = {\n type: \"volunteer\",\n messageId: ++this.messageId,\n };\n this.submitLocalMessage(op, pendingOp.messageId);\n this.latestPendingOps.set(taskId, pendingOp);\n }\n\n private submitAbandonOp(taskId: string) {\n const op: ITaskManagerAbandonOperation = {\n type: \"abandon\",\n taskId,\n };\n const pendingOp: IPendingOp = {\n type: \"abandon\",\n messageId: ++this.messageId,\n };\n this.submitLocalMessage(op, pendingOp.messageId);\n this.latestPendingOps.set(taskId, pendingOp);\n }\n\n private submitCompleteOp(taskId: string) {\n const op: ITaskManagerCompletedOperation = {\n type: \"complete\",\n taskId,\n };\n const pendingOp: IPendingOp = {\n type: \"complete\",\n messageId: ++this.messageId,\n };\n\n if (this.pendingCompletedTasks.has(taskId)) {\n this.pendingCompletedTasks.get(taskId)?.push(pendingOp.messageId);\n } else {\n this.pendingCompletedTasks.set(taskId, [pendingOp.messageId]);\n }\n\n this.submitLocalMessage(op, pendingOp.messageId);\n this.latestPendingOps.set(taskId, pendingOp);\n }\n\n /\n {@inheritDoc ITaskManager.volunteerForTask}\n /\n public async volunteerForTask(taskId: string) {\n // If we have the lock, resolve immediately\n if (this.assigned(taskId)) {\n return true;\n }\n\n if (this.readOnlyInfo.readonly === true) {\n const error = this.readOnlyInfo.permissions === true ?\n new Error(`Attempted to volunteer with read-only permissions: ${taskId}`) :\n new Error(`Attempted to volunteer in read-only state: ${taskId}`);\n throw error;\n }\n\n if (!this.isAttached()) {\n // Simulate auto-ack in detached scenario\n assert(this.clientId !== undefined, 0x472 / clientId should not be undefined /);\n this.addClientToQueue(taskId, this.clientId);\n return true;\n }\n\n if (!this.connected) {\n throw new Error(`Attempted to volunteer in disconnected state: ${taskId}`);\n }\n\n // This promise works even if we already have an outstanding volunteer op.\n const lockAcquireP = new Promise<boolean>((resolve, reject) => {\n const checkIfAcquiredLock = (eventTaskId: string) => {\n if (eventTaskId !== taskId) {\n return;\n }\n\n // Also check pending ops here because it's possible we are currently in the queue from a previous\n // lock attempt, but have an outstanding abandon AND the outstanding volunteer for this lock attempt.\n // If we reach the head of the queue based on the previous lock attempt, we don't want to resolve.\n if (this.assigned(taskId) && !this.latestPendingOps.has(taskId)) {\n this.queueWatcher.off(\"queueChange\", checkIfAcquiredLock);\n this.abandonWatcher.off(\"abandon\", checkIfAbandoned);\n this.connectionWatcher.off(\"disconnect\", rejectOnDisconnect);\n this.completedWatcher.off(\"completed\", checkIfCompleted);\n resolve(true);\n }\n };\n\n const checkIfAbandoned = (eventTaskId: string) => {\n if (eventTaskId !== taskId) {\n return;\n }\n\n this.queueWatcher.off(\"queueChange\", checkIfAcquiredLock);\n this.abandonWatcher.off(\"abandon\", checkIfAbandoned);\n this.connectionWatcher.off(\"disconnect\", rejectOnDisconnect);\n this.completedWatcher.off(\"completed\", checkIfCompleted);\n reject(new Error(`Abandoned before acquiring task assignment: ${taskId}`));\n };\n\n const rejectOnDisconnect = () => {\n this.queueWatcher.off(\"queueChange\", checkIfAcquiredLock);\n this.abandonWatcher.off(\"abandon\", checkIfAbandoned);\n this.connectionWatcher.off(\"disconnect\", rejectOnDisconnect);\n this.completedWatcher.off(\"completed\", checkIfCompleted);\n reject(new Error(`Disconnected before acquiring task assignment: ${taskId}`));\n };\n\n const checkIfCompleted = (eventTaskId: string) => {\n if (eventTaskId !== taskId) {\n return;\n }\n\n this.queueWatcher.off(\"queueChange\", checkIfAcquiredLock);\n this.abandonWatcher.off(\"abandon\", checkIfAbandoned);\n this.connectionWatcher.off(\"disconnect\", rejectOnDisconnect);\n this.completedWatcher.off(\"completed\", checkIfCompleted);\n resolve(false);\n };\n\n this.queueWatcher.on(\"queueChange\", checkIfAcquiredLock);\n this.abandonWatcher.on(\"abandon\", checkIfAbandoned);\n this.connectionWatcher.on(\"disconnect\", rejectOnDisconnect);\n this.completedWatcher.on(\"completed\", checkIfCompleted);\n });\n\n if (!this.queued(taskId)) {\n this.submitVolunteerOp(taskId);\n }\n return lockAcquireP;\n }\n\n /\n {@inheritDoc ITaskManager.subscribeToTask}\n /\n public subscribeToTask(taskId: string) {\n if (this.subscribed(taskId)) {\n return;\n }\n\n if (this.readOnlyInfo.readonly === true && this.readOnlyInfo.permissions === true) {\n throw new Error(`Attempted to subscribe with read-only permissions: ${taskId}`);\n }\n\n const submitVolunteerOp = () => {\n this.submitVolunteerOp(taskId);\n };\n\n const disconnectHandler = () => {\n // Wait to be connected again and then re-submit volunteer op\n this.connectionWatcher.once(\"connect\", submitVolunteerOp);\n };\n\n const checkIfAbandoned = (eventTaskId: string) => {\n if (eventTaskId !== taskId) {\n return;\n }\n\n this.abandonWatcher.off(\"abandon\", checkIfAbandoned);\n this.connectionWatcher.off(\"disconnect\", disconnectHandler);\n this.connectionWatcher.off(\"connect\", submitVolunteerOp);\n this.completedWatcher.off(\"completed\", checkIfCompleted);\n\n this.subscribedTasks.delete(taskId);\n };\n\n const checkIfCompleted = (eventTaskId: string) => {\n if (eventTaskId !== taskId) {\n return;\n }\n\n this.abandonWatcher.off(\"abandon\", checkIfAbandoned);\n this.connectionWatcher.off(\"disconnect\", disconnectHandler);\n this.connectionWatcher.off(\"connect\", submitVolunteerOp);\n this.completedWatcher.off(\"completed\", checkIfCompleted);\n\n this.subscribedTasks.delete(taskId);\n };\n\n this.abandonWatcher.on(\"abandon\", checkIfAbandoned);\n this.connectionWatcher.on(\"disconnect\", disconnectHandler);\n this.completedWatcher.on(\"completed\", checkIfCompleted);\n\n if (!this.isAttached()) {\n // Simulate auto-ack in detached scenario\n assert(this.clientId !== undefined, 0x473 / clientId should not be undefined /);\n this.addClientToQueue(taskId, this.clientId);\n // Because we volunteered with placeholderClientId, we need to wait for when we attach and are assigned\n // a real clientId. At that point we should re-enter the queue with a real volunteer op (assuming we are\n // connected).\n this.runtime.once(\"attached\", () => {\n if (this.queued(taskId)) {\n // If we are already queued, then we were able to replace the placeholderClientId with our real\n // clientId and no action is required.\n return;\n } else if (this.connected) {\n submitVolunteerOp();\n } else {\n this.connectionWatcher.once(\"connect\", () => {\n submitVolunteerOp();\n });\n }\n });\n } else if (!this.connected) {\n // If we are disconnected (and attached), wait to be connected and submit volunteer op\n disconnectHandler();\n } else if (!this.assigned(taskId) && !this.queued(taskId)) {\n submitVolunteerOp();\n }\n this.subscribedTasks.add(taskId);\n }\n\n /\n {@inheritDoc ITaskManager.abandon}\n /\n public abandon(taskId: string) {\n // Always allow abandon if the client is subscribed to allow clients to unsubscribe while disconnected.\n // Otherwise, we should check to make sure the client is both connected queued for the task before sending an\n // abandon op.\n if (!this.subscribed(taskId) && !this.queued(taskId)) {\n // Nothing to do\n return;\n }\n\n if (!this.isAttached()) {\n // Simulate auto-ack in detached scenario\n assert(this.clientId !== undefined, 0x474 / clientId is undefined /);\n this.removeClientFromQueue(taskId, this.clientId);\n this.abandonWatcher.emit(\"abandon\", taskId);\n return;\n }\n\n // If we're subscribed but not queued, we don't need to submit an abandon op (probably offline)\n if (this.queued(taskId)) {\n this.submitAbandonOp(taskId);\n }\n this.abandonWatcher.emit(\"abandon\", taskId);\n }\n\n /\n {@inheritDoc ITaskManager.assigned}\n /\n public assigned(taskId: string) {\n if (this.isAttached() && !this.connected) {\n return false;\n }\n\n const currentAssignee = this.taskQueues.get(taskId)?.[0];\n return currentAssignee !== undefined\n && currentAssignee === this.clientId\n && !this.latestPendingOps.has(taskId);\n }\n\n /\n {@inheritDoc ITaskManager.queued}\n /\n public queued(taskId: string) {\n if (this.isAttached() && !this.connected) {\n return false;\n }\n\n assert(this.clientId !== undefined, 0x07f / \"clientId undefined\" /);\n\n const clientQueue = this.taskQueues.get(taskId);\n // If we have no queue for the taskId, then no one has signed up for it.\n return (\n (clientQueue?.includes(this.clientId) ?? false)\n && !this.latestPendingOps.has(taskId)\n )\n \|\| this.latestPendingOps.get(taskId)?.type === \"volunteer\";\n }\n\n /\n {@inheritDoc ITaskManager.subscribed}\n /\n public subscribed(taskId: string): boolean {\n return this.subscribedTasks.has(taskId);\n }\n\n /\n {@inheritDoc ITaskManager.complete}\n /\n public complete(taskId: string): void {\n if (!this.assigned(taskId)) {\n throw new Error(`Attempted to mark task as complete while not being assigned: ${taskId}`);\n }\n\n // If we are detached we will simulate auto-ack for the complete op. Therefore we only need to send the op if\n // we are attached. Additionally, we don't need to check if we are connected while detached.\n if (this.isAttached()) {\n if (!this.connected) {\n throw new Error(`Attempted to complete task in disconnected state: ${taskId}`);\n }\n this.submitCompleteOp(taskId);\n }\n\n this.taskQueues.delete(taskId);\n this.completedWatcher.emit(\"completed\", taskId);\n this.emit(\"completed\", taskId);\n }\n\n /\n {@inheritDoc ITaskManager.canVolunteer}\n /\n public canVolunteer(): boolean {\n // A client can volunteer for a task if it's both connected to the delta stream and in write mode.\n // this.connected reflects that condition, but is unintuitive and may be changed in the future. This API allows\n // us to make changes to this.connected without affecting our guidance on how to check if a client is eligible\n // to volunteer for a task.\n return this.connected;\n }\n\n /\n Create a summary for the task manager\n \n @returns the summary of the current state of the task manager\n * @internal\n /\n protected summarizeCore(serializer: IFluidSerializer): ISummaryTreeWithStats {\n if (this.runtime.clientId !== undefined) {\n // If the runtime has been assigned an actual clientId by now, we can replace the placeholder clientIds\n // and maintain the task assignment.\n this.replacePlaceholderInAllQueues();\n } else {\n // If the runtime has still not been assigned a clientId, we should not summarize with the placeholder\n // clientIds and instead remove them from the queues and require the client to re-volunteer when assigned\n // a new clientId.\n this.removeClientFromAllQueues(placeholderClientId);\n }\n\n // Only include tasks if there are clients in the queue.\n const filteredMap = new Map<string, string[]>();\n this.taskQueues.forEach((queue: string[], taskId: string) => {\n if (queue.length > 0) {\n filteredMap.set(taskId, queue);\n }\n });\n const content = [...filteredMap.entries()];\n return createSingleBlobSummary(snapshotFileName, JSON.stringify(content));\n }\n\n /\n {@inheritDoc @fluidframework/shared-object-base#SharedObject.loadCore}\n * @internal\n /\n protected async loadCore(storage: IChannelStorageService): Promise<void> {\n const content = await readAndParse<[string, string[]][]>(storage, snapshotFileName);\n content.forEach(([taskId, clientIdQueue]) => {\n this.taskQueues.set(taskId, clientIdQueue);\n });\n this.scrubClientsNotInQuorum();\n }\n\n /\n @internal\n /\n protected initializeLocalCore() { }\n\n /\n {@inheritDoc @fluidframework/shared-object-base#SharedObject.onDisconnect}\n * @internal\n /\n protected onDisconnect() {\n this.connectionWatcher.emit(\"disconnect\");\n }\n\n /\n {@inheritDoc @fluidframework/shared-object-base#SharedObject.onConnect}\n * @internal\n /\n protected onConnect() {\n this.connectionWatcher.emit(\"connect\");\n }\n\n //\n /\n Override resubmit core to avoid resubmission on reconnect. On disconnect we accept our removal from the\n * queues, and leave it up to the user to decide whether they want to attempt to re-enter a queue on reconnect.\n * @internal\n /\n protected reSubmitCore() { }\n\n /\n Process a task manager operation\n \n @param message - the message to prepare\n * @param local - whether the message was sent by the local client\n * @param localOpMetadata - For local client messages, this is the metadata that was submitted with the message.\n * For messages from a remote client, this will be undefined.\n * @internal\n /\n protected processCore(message: ISequencedDocumentMessage, local: boolean, localOpMetadata: unknown) {\n if (message.type === MessageType.Operation) {\n const op = message.contents as ITaskManagerOperation;\n const messageId = localOpMetadata as number;\n\n switch (op.type) {\n case \"volunteer\":\n this.opWatcher.emit(\"volunteer\", op.taskId, message.clientId, local, messageId);\n break;\n\n case \"abandon\":\n this.opWatcher.emit(\"abandon\", op.taskId, message.clientId, local, messageId);\n break;\n\n case \"complete\":\n this.opWatcher.emit(\"complete\", op.taskId, message.clientId, local, messageId);\n break;\n\n default:\n throw new Error(\"Unknown operation\");\n }\n }\n }\n\n private addClientToQueue(taskId: string, clientId: string) {\n const pendingIds = this.pendingCompletedTasks.get(taskId);\n if (pendingIds !== undefined && pendingIds.length > 0) {\n // Ignore the volunteer op if we know this task is about to be completed\n return;\n }\n\n // Ensure that the clientId exists in the quorum, or it is placeholderClientId (detached scenario)\n if (this.runtime.getQuorum().getMembers().has(clientId) \|\| this.clientId === placeholderClientId) {\n // Create the queue if it doesn't exist, and push the client on the back.\n let clientQueue = this.taskQueues.get(taskId);\n if (clientQueue === undefined) {\n clientQueue = [];\n this.taskQueues.set(taskId, clientQueue);\n }\n\n const oldLockHolder = clientQueue[0];\n clientQueue.push(clientId);\n const newLockHolder = clientQueue[0];\n if (newLockHolder !== oldLockHolder) {\n this.queueWatcher.emit(\"queueChange\", taskId, oldLockHolder, newLockHolder);\n }\n\n }\n }\n\n private removeClientFromQueue(taskId: string, clientId: string) {\n const clientQueue = this.taskQueues.get(taskId);\n if (clientQueue === undefined) {\n return;\n }\n\n const oldLockHolder = clientId === placeholderClientId ? placeholderClientId : clientQueue[0];\n const clientIdIndex = clientQueue.indexOf(clientId);\n if (clientIdIndex !== -1) {\n clientQueue.splice(clientIdIndex, 1);\n // Clean up the queue if there are no more clients in it.\n if (clientQueue.length === 0) {\n this.taskQueues.delete(taskId);\n }\n }\n const newLockHolder = clientQueue[0];\n if (newLockHolder !== oldLockHolder) {\n this.queueWatcher.emit(\"queueChange\", taskId, oldLockHolder, newLockHolder);\n }\n }\n\n private removeClientFromAllQueues(clientId: string) {\n for (const taskId of this.taskQueues.keys()) {\n this.removeClientFromQueue(taskId, clientId);\n }\n }\n\n /\n Will replace all instances of the placeholderClientId with the current clientId. This should only be called when\n * transitioning from detached to attached and this.runtime.clientId is defined.\n /\n private replacePlaceholderInAllQueues() {\n assert(this.runtime.clientId !== undefined, 0x475 / this.runtime.clientId should be defined */);\n for (const clientQueue of this.taskQueues.values()) {\n const clientIdIndex = clientQueue.indexOf(placeholderClientId);\n if (clientIdIndex !== -1) {\n clientQueue[clientIdIndex] = this.runtime.clientId;\n }\n }\n }\n\n // This seems like it should be unnecessary if we can trust to receive the join/leave messages and\n // also have an accurate snapshot.\n private scrubClientsNotInQuorum() {\n const quorum = this.runtime.getQuorum();\n for (const [taskId, clientQueue] of this.taskQueues) {\n const filteredClientQueue = clientQueue.filter((clientId) => quorum.getMember(clientId) !== undefined);\n if (clientQueue.length !== filteredClientQueue.length) {\n if (filteredClientQueue.length === 0) {\n this.taskQueues.delete(taskId);\n } else {\n this.taskQueues.set(taskId, filteredClientQueue);\n }\n this.queueWatcher.emit(\"queueChange\", taskId);\n }\n }\n }\n\n public applyStashedOp() {\n throw new Error(\"not implemented\");\n }\n}\n"]}
1	+ {"version":3,"file":"taskManager.js","sourceRoot":"","sources":["../src/taskManager.ts"],"names":[],"mappings":"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","sourcesContent":["/!\n Copyright (c) Microsoft Corporation and contributors. All rights reserved.\n * Licensed under the MIT License.\n /\n\nimport { EventEmitter } from \"events\";\n\nimport { assert } from \"@fluidframework/common-utils\";\nimport { ISequencedDocumentMessage, MessageType } from \"@fluidframework/protocol-definitions\";\nimport {\n IChannelAttributes,\n IFluidDataStoreRuntime,\n IChannelStorageService,\n IChannelFactory,\n} from \"@fluidframework/datastore-definitions\";\nimport { ISummaryTreeWithStats } from \"@fluidframework/runtime-definitions\";\nimport { readAndParse } from \"@fluidframework/driver-utils\";\nimport { createSingleBlobSummary, IFluidSerializer, SharedObject } from \"@fluidframework/shared-object-base\";\nimport { ReadOnlyInfo } from \"@fluidframework/container-definitions\";\nimport { TaskManagerFactory } from \"./taskManagerFactory\";\nimport { ITaskManager, ITaskManagerEvents } from \"./interfaces\";\n\n/\n Description of a task manager operation\n /\ntype ITaskManagerOperation =\n ITaskManagerVolunteerOperation \|\n ITaskManagerAbandonOperation \|\n ITaskManagerCompletedOperation;\n\ninterface ITaskManagerVolunteerOperation {\n type: \"volunteer\";\n taskId: string;\n}\n\ninterface ITaskManagerAbandonOperation {\n type: \"abandon\";\n taskId: string;\n}\n\ninterface ITaskManagerCompletedOperation {\n type: \"complete\";\n taskId: string;\n}\n\ninterface IPendingOp {\n type: \"volunteer\" \| \"abandon\" \| \"complete\";\n messageId: number;\n}\n\nconst snapshotFileName = \"header\";\n\n/\n Placeholder clientId for detached scenarios.\n /\nconst placeholderClientId = \"placeholder\";\n\n\n/\n The TaskManager distributed data structure tracks queues of clients that want to exclusively run a task.\n \n @remarks\n \n For an in-depth overview, see [TaskManager](https://fluidframework.com/docs/data-structures/task-manager/).\n \n ### Creation\n \n To create a `TaskManager`, call the static create method:\n \n ```typescript\n * const taskManager = TaskManager.create(this.runtime, id);\n * ```\n \n ### Usage\n \n To volunteer for a task, use the `volunteerForTask()` method. This returns a Promise that will resolve once the\n * client has acquired exclusive rights to run the task, or reject if the client is removed from the queue without\n * acquiring the rights.\n \n ```typescript\n * taskManager.volunteerForTask(\"NameOfTask\")\n * .then(() => { doTheTask(); })\n * .catch((err) => { console.error(err); });\n * ```\n \n Alternatively, you can indefinitely volunteer for a task with the synchronous `subscribeToTask()` method. This\n * method does not return a value, therefore you need to rely on eventing to know when you have acquired the rights\n * to run the task (see below).\n \n ```typescript\n * taskManager.subscribeToTask(\"NameOfTask\");\n * ```\n \n To check if the local client is currently subscribed to a task, use the `subscribed()` method.\n * ```typescript\n * if (taskManager.subscribed(\"NameOfTask\")) {\n * console.log(\"This client is currently subscribed to the task.\");\n * }\n * ```\n \n To release the rights to the task, use the `abandon()` method. The next client in the queue will then get the\n * rights to run the task.\n \n ```typescript\n * taskManager.abandon(\"NameOfTask\");\n * ```\n \n To inspect your state in the queue, you can use the `queued()` and `assigned()` methods.\n \n ```typescript\n * if (taskManager.queued(\"NameOfTask\")) {\n * console.log(\"This client is somewhere in the queue, potentially even having the task assignment.\");\n * }\n \n if (taskManager.assigned(\"NameOfTask\")) {\n * console.log(\"This client currently has the rights to run the task\");\n * }\n * ```\n \n To signal to other connected clients that a task is completed, use the `complete()` method. This will release all\n * clients from the queue and emit the \"completed\" event.\n \n ```typescript\n * taskManager.complete(\"NameOfTask\");\n * ```\n \n ### Eventing\n \n `TaskManager` is an `EventEmitter`, and will emit events when a task is assigned to the client, when the task\n * assignment is lost, and when a task was completed by another client.\n \n ```typescript\n * taskManager.on(\"assigned\", (taskId: string) => {\n * console.log(`Client was assigned task: ${taskId}`);\n * });\n \n taskManager.on(\"lost\", (taskId: string) => {\n * console.log(`Client released task: ${taskId}`);\n * });\n \n taskManager.on(\"completed\", (taskId: string) => {\n * console.log(`Another client completed task: ${taskId}`);\n * });\n * ```\n \n These can be useful if the logic to volunteer for a task is separated from the logic to perform the task, such as\n * when using the `subscribeToTask()` method.\n /\nexport class TaskManager extends SharedObject<ITaskManagerEvents> implements ITaskManager {\n /\n Create a new TaskManager\n \n @param runtime - data store runtime the new task queue belongs to\n * @param id - optional name of the task queue\n * @returns newly create task queue (but not attached yet)\n /\n public static create(runtime: IFluidDataStoreRuntime, id?: string) {\n return runtime.createChannel(id, TaskManagerFactory.Type) as TaskManager;\n }\n\n /\n Get a factory for TaskManager to register with the data store.\n \n @returns a factory that creates and load TaskManager\n /\n public static getFactory(): IChannelFactory {\n return new TaskManagerFactory();\n }\n\n /\n Mapping of taskId to a queue of clientIds that are waiting on the task. Maintains the consensus state of the\n * queue, even if we know we've submitted an op that should eventually modify the queue.\n /\n private readonly taskQueues: Map<string, string[]> = new Map();\n\n // opWatcher emits for every op on this data store. This is just a repackaging of processCore into events.\n private readonly opWatcher: EventEmitter = new EventEmitter();\n // queueWatcher emits an event whenever the consensus state of the task queues changes\n private readonly queueWatcher: EventEmitter = new EventEmitter();\n // abandonWatcher emits an event whenever the local client calls abandon() on a task.\n private readonly abandonWatcher: EventEmitter = new EventEmitter();\n // connectionWatcher emits an event whenever we get connected or disconnected.\n private readonly connectionWatcher: EventEmitter = new EventEmitter();\n // completedWatcher emits an event whenever the local client receives a completed op.\n private readonly completedWatcher: EventEmitter = new EventEmitter();\n\n private messageId: number = -1;\n /\n Tracks the most recent pending op for a given task\n /\n private readonly latestPendingOps: Map<string, IPendingOp> = new Map();\n\n /\n Tracks tasks that are this client is currently subscribed to.\n /\n private readonly subscribedTasks: Set<string> = new Set();\n\n /\n Map to track tasks that have pending complete ops.\n /\n private readonly pendingCompletedTasks: Map<string, number[]> = new Map();\n\n /\n Returns the clientId. Will return a placeholder if the runtime is detached and not yet assigned a clientId.\n /\n private get clientId(): string \| undefined {\n return this.isAttached() ? this.runtime.clientId : placeholderClientId;\n }\n\n /\n Returns a ReadOnlyInfo object to determine current read/write permissions.\n /\n private get readOnlyInfo(): ReadOnlyInfo {\n return this.runtime.deltaManager.readOnlyInfo;\n }\n\n /\n Constructs a new task manager. If the object is non-local an id and service interfaces will\n * be provided\n \n @param runtime - data store runtime the task queue belongs to\n * @param id - optional name of the task queue\n /\n constructor(id: string, runtime: IFluidDataStoreRuntime, attributes: IChannelAttributes) {\n super(id, runtime, attributes, \"fluid_taskManager_\");\n\n this.opWatcher.on(\"volunteer\", (taskId: string, clientId: string, local: boolean, messageId: number) => {\n // We're tracking local ops from this connection. Filter out local ops during \"connecting\"\n // state since these were sent on the prior connection and were already cleared from the latestPendingOps.\n if (runtime.connected && local) {\n const pendingOp = this.latestPendingOps.get(taskId);\n assert(pendingOp !== undefined, 0x07b / \"Unexpected op\" /);\n // Need to check the id, since it's possible to volunteer and abandon multiple times before the acks\n if (messageId === pendingOp.messageId) {\n assert(pendingOp.type === \"volunteer\", 0x07c / \"Unexpected op type\" /);\n // Delete the pending, because we no longer have an outstanding op\n this.latestPendingOps.delete(taskId);\n }\n }\n\n this.addClientToQueue(taskId, clientId);\n });\n\n this.opWatcher.on(\"abandon\", (taskId: string, clientId: string, local: boolean, messageId: number) => {\n if (runtime.connected && local) {\n const pendingOp = this.latestPendingOps.get(taskId);\n assert(pendingOp !== undefined, 0x07d / \"Unexpected op\" /);\n // Need to check the id, since it's possible to abandon and volunteer multiple times before the acks\n if (messageId === pendingOp.messageId) {\n assert(pendingOp.type === \"abandon\", 0x07e / \"Unexpected op type\" /);\n // Delete the pending, because we no longer have an outstanding op\n this.latestPendingOps.delete(taskId);\n }\n }\n\n this.removeClientFromQueue(taskId, clientId);\n });\n\n this.opWatcher.on(\"complete\", (taskId: string, clientId: string, local: boolean, messageId: number) => {\n if (runtime.connected && local) {\n const pendingOp = this.latestPendingOps.get(taskId);\n assert(pendingOp !== undefined, 0x400 / Unexpected op /);\n // Need to check the id, since it's possible to complete multiple times before the acks\n if (messageId === pendingOp.messageId) {\n assert(pendingOp.type === \"complete\", 0x401 / Unexpected op type /);\n // Delete the pending, because we no longer have an outstanding op\n this.latestPendingOps.delete(taskId);\n }\n\n // Remove complete op from this.pendingCompletedTasks\n const pendingIds = this.pendingCompletedTasks.get(taskId);\n assert(pendingIds !== undefined && pendingIds.length > 0, 0x402 / pendingIds is empty /);\n const removed = pendingIds.shift();\n assert(removed === messageId, 0x403 / Removed complete op id does not match /);\n }\n\n // For clients in queue, we need to remove them from the queue and raise the proper events.\n if (!local) {\n this.taskQueues.delete(taskId);\n this.completedWatcher.emit(\"completed\", taskId);\n this.emit(\"completed\", taskId);\n }\n });\n\n runtime.getQuorum().on(\"removeMember\", (clientId: string) => {\n this.removeClientFromAllQueues(clientId);\n });\n\n this.queueWatcher.on(\"queueChange\", (taskId: string, oldLockHolder: string, newLockHolder: string) => {\n // If oldLockHolder is placeholderClientId we need to emit the task was lost during the attach process\n if (oldLockHolder === placeholderClientId) {\n this.emit(\"lost\", taskId);\n return;\n }\n\n // Exit early if we are still catching up on reconnect -- we can't be the leader yet anyway.\n if (this.clientId === undefined) {\n return;\n }\n\n if (oldLockHolder !== this.clientId && newLockHolder === this.clientId) {\n this.emit(\"assigned\", taskId);\n } else if (oldLockHolder === this.clientId && newLockHolder !== this.clientId) {\n this.emit(\"lost\", taskId);\n }\n });\n\n this.connectionWatcher.on(\"disconnect\", () => {\n assert(this.clientId !== undefined, 0x1d3 / \"Missing client id on disconnect\" /);\n\n // We don't modify the taskQueues on disconnect (they still reflect the latest known consensus state).\n // After reconnect these will get cleaned up by observing the clientLeaves.\n // However we do need to recognize that we lost the lock if we had it. Calls to .queued() and\n // .assigned() are also connection-state-aware to be consistent.\n for (const [taskId, clientQueue] of this.taskQueues.entries()) {\n if (this.isAttached() && clientQueue[0] === this.clientId) {\n this.emit(\"lost\", taskId);\n }\n }\n\n // All of our outstanding ops will be for the old clientId even if they get ack'd\n this.latestPendingOps.clear();\n });\n }\n\n private submitVolunteerOp(taskId: string) {\n const op: ITaskManagerVolunteerOperation = {\n type: \"volunteer\",\n taskId,\n };\n const pendingOp: IPendingOp = {\n type: \"volunteer\",\n messageId: ++this.messageId,\n };\n this.submitLocalMessage(op, pendingOp.messageId);\n this.latestPendingOps.set(taskId, pendingOp);\n }\n\n private submitAbandonOp(taskId: string) {\n const op: ITaskManagerAbandonOperation = {\n type: \"abandon\",\n taskId,\n };\n const pendingOp: IPendingOp = {\n type: \"abandon\",\n messageId: ++this.messageId,\n };\n this.submitLocalMessage(op, pendingOp.messageId);\n this.latestPendingOps.set(taskId, pendingOp);\n }\n\n private submitCompleteOp(taskId: string) {\n const op: ITaskManagerCompletedOperation = {\n type: \"complete\",\n taskId,\n };\n const pendingOp: IPendingOp = {\n type: \"complete\",\n messageId: ++this.messageId,\n };\n\n if (this.pendingCompletedTasks.has(taskId)) {\n this.pendingCompletedTasks.get(taskId)?.push(pendingOp.messageId);\n } else {\n this.pendingCompletedTasks.set(taskId, [pendingOp.messageId]);\n }\n\n this.submitLocalMessage(op, pendingOp.messageId);\n this.latestPendingOps.set(taskId, pendingOp);\n }\n\n /\n {@inheritDoc ITaskManager.volunteerForTask}\n /\n public async volunteerForTask(taskId: string) {\n // If we have the lock, resolve immediately\n if (this.assigned(taskId)) {\n return true;\n }\n\n if (this.readOnlyInfo.readonly === true) {\n const error = this.readOnlyInfo.permissions === true ?\n new Error(\"Attempted to volunteer with read-only permissions\") :\n new Error(\"Attempted to volunteer in read-only state\");\n throw error;\n }\n\n if (!this.isAttached()) {\n // Simulate auto-ack in detached scenario\n assert(this.clientId !== undefined, 0x472 / clientId should not be undefined /);\n this.addClientToQueue(taskId, this.clientId);\n return true;\n }\n\n if (!this.connected) {\n throw new Error(\"Attempted to volunteer in disconnected state\");\n }\n\n // This promise works even if we already have an outstanding volunteer op.\n const lockAcquireP = new Promise<boolean>((resolve, reject) => {\n const checkIfAcquiredLock = (eventTaskId: string) => {\n if (eventTaskId !== taskId) {\n return;\n }\n\n // Also check pending ops here because it's possible we are currently in the queue from a previous\n // lock attempt, but have an outstanding abandon AND the outstanding volunteer for this lock attempt.\n // If we reach the head of the queue based on the previous lock attempt, we don't want to resolve.\n if (this.assigned(taskId) && !this.latestPendingOps.has(taskId)) {\n this.queueWatcher.off(\"queueChange\", checkIfAcquiredLock);\n this.abandonWatcher.off(\"abandon\", checkIfAbandoned);\n this.connectionWatcher.off(\"disconnect\", rejectOnDisconnect);\n this.completedWatcher.off(\"completed\", checkIfCompleted);\n resolve(true);\n }\n };\n\n const checkIfAbandoned = (eventTaskId: string) => {\n if (eventTaskId !== taskId) {\n return;\n }\n\n this.queueWatcher.off(\"queueChange\", checkIfAcquiredLock);\n this.abandonWatcher.off(\"abandon\", checkIfAbandoned);\n this.connectionWatcher.off(\"disconnect\", rejectOnDisconnect);\n this.completedWatcher.off(\"completed\", checkIfCompleted);\n reject(new Error(\"Abandoned before acquiring task assignment\"));\n };\n\n const rejectOnDisconnect = () => {\n this.queueWatcher.off(\"queueChange\", checkIfAcquiredLock);\n this.abandonWatcher.off(\"abandon\", checkIfAbandoned);\n this.connectionWatcher.off(\"disconnect\", rejectOnDisconnect);\n this.completedWatcher.off(\"completed\", checkIfCompleted);\n reject(new Error(\"Disconnected before acquiring task assignment\"));\n };\n\n const checkIfCompleted = (eventTaskId: string) => {\n if (eventTaskId !== taskId) {\n return;\n }\n\n this.queueWatcher.off(\"queueChange\", checkIfAcquiredLock);\n this.abandonWatcher.off(\"abandon\", checkIfAbandoned);\n this.connectionWatcher.off(\"disconnect\", rejectOnDisconnect);\n this.completedWatcher.off(\"completed\", checkIfCompleted);\n resolve(false);\n };\n\n this.queueWatcher.on(\"queueChange\", checkIfAcquiredLock);\n this.abandonWatcher.on(\"abandon\", checkIfAbandoned);\n this.connectionWatcher.on(\"disconnect\", rejectOnDisconnect);\n this.completedWatcher.on(\"completed\", checkIfCompleted);\n });\n\n if (!this.queued(taskId)) {\n this.submitVolunteerOp(taskId);\n }\n return lockAcquireP;\n }\n\n /\n {@inheritDoc ITaskManager.subscribeToTask}\n /\n public subscribeToTask(taskId: string) {\n if (this.subscribed(taskId)) {\n return;\n }\n\n if (this.readOnlyInfo.readonly === true && this.readOnlyInfo.permissions === true) {\n throw new Error(\"Attempted to subscribe with read-only permissions\");\n }\n\n const submitVolunteerOp = () => {\n this.submitVolunteerOp(taskId);\n };\n\n const disconnectHandler = () => {\n // Wait to be connected again and then re-submit volunteer op\n this.connectionWatcher.once(\"connect\", submitVolunteerOp);\n };\n\n const checkIfAbandoned = (eventTaskId: string) => {\n if (eventTaskId !== taskId) {\n return;\n }\n\n this.abandonWatcher.off(\"abandon\", checkIfAbandoned);\n this.connectionWatcher.off(\"disconnect\", disconnectHandler);\n this.connectionWatcher.off(\"connect\", submitVolunteerOp);\n this.completedWatcher.off(\"completed\", checkIfCompleted);\n\n this.subscribedTasks.delete(taskId);\n };\n\n const checkIfCompleted = (eventTaskId: string) => {\n if (eventTaskId !== taskId) {\n return;\n }\n\n this.abandonWatcher.off(\"abandon\", checkIfAbandoned);\n this.connectionWatcher.off(\"disconnect\", disconnectHandler);\n this.connectionWatcher.off(\"connect\", submitVolunteerOp);\n this.completedWatcher.off(\"completed\", checkIfCompleted);\n\n this.subscribedTasks.delete(taskId);\n };\n\n this.abandonWatcher.on(\"abandon\", checkIfAbandoned);\n this.connectionWatcher.on(\"disconnect\", disconnectHandler);\n this.completedWatcher.on(\"completed\", checkIfCompleted);\n\n if (!this.isAttached()) {\n // Simulate auto-ack in detached scenario\n assert(this.clientId !== undefined, 0x473 / clientId should not be undefined /);\n this.addClientToQueue(taskId, this.clientId);\n // Because we volunteered with placeholderClientId, we need to wait for when we attach and are assigned\n // a real clientId. At that point we should re-enter the queue with a real volunteer op (assuming we are\n // connected).\n this.runtime.once(\"attached\", () => {\n if (this.queued(taskId)) {\n // If we are already queued, then we were able to replace the placeholderClientId with our real\n // clientId and no action is required.\n return;\n } else if (this.connected) {\n submitVolunteerOp();\n } else {\n this.connectionWatcher.once(\"connect\", () => {\n submitVolunteerOp();\n });\n }\n });\n } else if (!this.connected) {\n // If we are disconnected (and attached), wait to be connected and submit volunteer op\n disconnectHandler();\n } else if (!this.assigned(taskId) && !this.queued(taskId)) {\n submitVolunteerOp();\n }\n this.subscribedTasks.add(taskId);\n }\n\n /\n {@inheritDoc ITaskManager.abandon}\n /\n public abandon(taskId: string) {\n // Always allow abandon if the client is subscribed to allow clients to unsubscribe while disconnected.\n // Otherwise, we should check to make sure the client is both connected queued for the task before sending an\n // abandon op.\n if (!this.subscribed(taskId) && !this.queued(taskId)) {\n // Nothing to do\n return;\n }\n\n if (!this.isAttached()) {\n // Simulate auto-ack in detached scenario\n assert(this.clientId !== undefined, 0x474 / clientId is undefined /);\n this.removeClientFromQueue(taskId, this.clientId);\n this.abandonWatcher.emit(\"abandon\", taskId);\n return;\n }\n\n // If we're subscribed but not queued, we don't need to submit an abandon op (probably offline)\n if (this.queued(taskId)) {\n this.submitAbandonOp(taskId);\n }\n this.abandonWatcher.emit(\"abandon\", taskId);\n }\n\n /\n {@inheritDoc ITaskManager.assigned}\n /\n public assigned(taskId: string) {\n if (this.isAttached() && !this.connected) {\n return false;\n }\n\n const currentAssignee = this.taskQueues.get(taskId)?.[0];\n return currentAssignee !== undefined\n && currentAssignee === this.clientId\n && !this.latestPendingOps.has(taskId);\n }\n\n /\n {@inheritDoc ITaskManager.queued}\n /\n public queued(taskId: string) {\n if (this.isAttached() && !this.connected) {\n return false;\n }\n\n assert(this.clientId !== undefined, 0x07f / \"clientId undefined\" /);\n\n const clientQueue = this.taskQueues.get(taskId);\n // If we have no queue for the taskId, then no one has signed up for it.\n return (\n (clientQueue?.includes(this.clientId) ?? false)\n && !this.latestPendingOps.has(taskId)\n )\n \|\| this.latestPendingOps.get(taskId)?.type === \"volunteer\";\n }\n\n /\n {@inheritDoc ITaskManager.subscribed}\n /\n public subscribed(taskId: string): boolean {\n return this.subscribedTasks.has(taskId);\n }\n\n /\n {@inheritDoc ITaskManager.complete}\n /\n public complete(taskId: string): void {\n if (!this.assigned(taskId)) {\n throw new Error(\"Attempted to mark task as complete while not being assigned\");\n }\n\n // If we are detached we will simulate auto-ack for the complete op. Therefore we only need to send the op if\n // we are attached. Additionally, we don't need to check if we are connected while detached.\n if (this.isAttached()) {\n if (!this.connected) {\n throw new Error(\"Attempted to complete task in disconnected state\");\n }\n this.submitCompleteOp(taskId);\n }\n\n this.taskQueues.delete(taskId);\n this.completedWatcher.emit(\"completed\", taskId);\n this.emit(\"completed\", taskId);\n }\n\n /\n {@inheritDoc ITaskManager.canVolunteer}\n /\n public canVolunteer(): boolean {\n // A client can volunteer for a task if it's both connected to the delta stream and in write mode.\n // this.connected reflects that condition, but is unintuitive and may be changed in the future. This API allows\n // us to make changes to this.connected without affecting our guidance on how to check if a client is eligible\n // to volunteer for a task.\n return this.connected;\n }\n\n /\n Create a summary for the task manager\n \n @returns the summary of the current state of the task manager\n * @internal\n /\n protected summarizeCore(serializer: IFluidSerializer): ISummaryTreeWithStats {\n if (this.runtime.clientId !== undefined) {\n // If the runtime has been assigned an actual clientId by now, we can replace the placeholder clientIds\n // and maintain the task assignment.\n this.replacePlaceholderInAllQueues();\n } else {\n // If the runtime has still not been assigned a clientId, we should not summarize with the placeholder\n // clientIds and instead remove them from the queues and require the client to re-volunteer when assigned\n // a new clientId.\n this.removeClientFromAllQueues(placeholderClientId);\n }\n\n // Only include tasks if there are clients in the queue.\n const filteredMap = new Map<string, string[]>();\n this.taskQueues.forEach((queue: string[], taskId: string) => {\n if (queue.length > 0) {\n filteredMap.set(taskId, queue);\n }\n });\n const content = [...filteredMap.entries()];\n return createSingleBlobSummary(snapshotFileName, JSON.stringify(content));\n }\n\n /\n {@inheritDoc @fluidframework/shared-object-base#SharedObject.loadCore}\n * @internal\n /\n protected async loadCore(storage: IChannelStorageService): Promise<void> {\n const content = await readAndParse<[string, string[]][]>(storage, snapshotFileName);\n content.forEach(([taskId, clientIdQueue]) => {\n this.taskQueues.set(taskId, clientIdQueue);\n });\n this.scrubClientsNotInQuorum();\n }\n\n /\n @internal\n /\n protected initializeLocalCore() { }\n\n /\n {@inheritDoc @fluidframework/shared-object-base#SharedObject.onDisconnect}\n * @internal\n /\n protected onDisconnect() {\n this.connectionWatcher.emit(\"disconnect\");\n }\n\n /\n {@inheritDoc @fluidframework/shared-object-base#SharedObject.onConnect}\n * @internal\n /\n protected onConnect() {\n this.connectionWatcher.emit(\"connect\");\n }\n\n //\n /\n Override resubmit core to avoid resubmission on reconnect. On disconnect we accept our removal from the\n * queues, and leave it up to the user to decide whether they want to attempt to re-enter a queue on reconnect.\n * @internal\n /\n protected reSubmitCore() { }\n\n /\n Process a task manager operation\n \n @param message - the message to prepare\n * @param local - whether the message was sent by the local client\n * @param localOpMetadata - For local client messages, this is the metadata that was submitted with the message.\n * For messages from a remote client, this will be undefined.\n * @internal\n /\n protected processCore(message: ISequencedDocumentMessage, local: boolean, localOpMetadata: unknown) {\n if (message.type === MessageType.Operation) {\n const op = message.contents as ITaskManagerOperation;\n const messageId = localOpMetadata as number;\n\n switch (op.type) {\n case \"volunteer\":\n this.opWatcher.emit(\"volunteer\", op.taskId, message.clientId, local, messageId);\n break;\n\n case \"abandon\":\n this.opWatcher.emit(\"abandon\", op.taskId, message.clientId, local, messageId);\n break;\n\n case \"complete\":\n this.opWatcher.emit(\"complete\", op.taskId, message.clientId, local, messageId);\n break;\n\n default:\n throw new Error(\"Unknown operation\");\n }\n }\n }\n\n private addClientToQueue(taskId: string, clientId: string) {\n const pendingIds = this.pendingCompletedTasks.get(taskId);\n if (pendingIds !== undefined && pendingIds.length > 0) {\n // Ignore the volunteer op if we know this task is about to be completed\n return;\n }\n\n // Ensure that the clientId exists in the quorum, or it is placeholderClientId (detached scenario)\n if (this.runtime.getQuorum().getMembers().has(clientId) \|\| this.clientId === placeholderClientId) {\n // Create the queue if it doesn't exist, and push the client on the back.\n let clientQueue = this.taskQueues.get(taskId);\n if (clientQueue === undefined) {\n clientQueue = [];\n this.taskQueues.set(taskId, clientQueue);\n }\n\n const oldLockHolder = clientQueue[0];\n clientQueue.push(clientId);\n const newLockHolder = clientQueue[0];\n if (newLockHolder !== oldLockHolder) {\n this.queueWatcher.emit(\"queueChange\", taskId, oldLockHolder, newLockHolder);\n }\n\n }\n }\n\n private removeClientFromQueue(taskId: string, clientId: string) {\n const clientQueue = this.taskQueues.get(taskId);\n if (clientQueue === undefined) {\n return;\n }\n\n const oldLockHolder = clientId === placeholderClientId ? placeholderClientId : clientQueue[0];\n const clientIdIndex = clientQueue.indexOf(clientId);\n if (clientIdIndex !== -1) {\n clientQueue.splice(clientIdIndex, 1);\n // Clean up the queue if there are no more clients in it.\n if (clientQueue.length === 0) {\n this.taskQueues.delete(taskId);\n }\n }\n const newLockHolder = clientQueue[0];\n if (newLockHolder !== oldLockHolder) {\n this.queueWatcher.emit(\"queueChange\", taskId, oldLockHolder, newLockHolder);\n }\n }\n\n private removeClientFromAllQueues(clientId: string) {\n for (const taskId of this.taskQueues.keys()) {\n this.removeClientFromQueue(taskId, clientId);\n }\n }\n\n /\n Will replace all instances of the placeholderClientId with the current clientId. This should only be called when\n * transitioning from detached to attached and this.runtime.clientId is defined.\n /\n private replacePlaceholderInAllQueues() {\n assert(this.runtime.clientId !== undefined, 0x475 / this.runtime.clientId should be defined */);\n for (const clientQueue of this.taskQueues.values()) {\n const clientIdIndex = clientQueue.indexOf(placeholderClientId);\n if (clientIdIndex !== -1) {\n clientQueue[clientIdIndex] = this.runtime.clientId;\n }\n }\n }\n\n // This seems like it should be unnecessary if we can trust to receive the join/leave messages and\n // also have an accurate snapshot.\n private scrubClientsNotInQuorum() {\n const quorum = this.runtime.getQuorum();\n for (const [taskId, clientQueue] of this.taskQueues) {\n const filteredClientQueue = clientQueue.filter((clientId) => quorum.getMember(clientId) !== undefined);\n if (clientQueue.length !== filteredClientQueue.length) {\n if (filteredClientQueue.length === 0) {\n this.taskQueues.delete(taskId);\n } else {\n this.taskQueues.set(taskId, filteredClientQueue);\n }\n this.queueWatcher.emit(\"queueChange\", taskId);\n }\n }\n }\n\n public applyStashedOp() {\n throw new Error(\"not implemented\");\n }\n}\n"]}

package/package.json CHANGED Viewed

@@ -1,6 +1,6 @@
 {
   "name": "@fluidframework/task-manager",
-  "version": "2.0.0-internal.2.2.1",
+  "version": "2.0.0-internal.2.3.1",
   "description": "Distributed data structure for queueing exclusive tasks",
   "homepage": "https://fluidframework.com",
   "repository": {
@@ -64,25 +64,26 @@
   "dependencies": {
     "@fluidframework/common-definitions": "^0.20.1",
     "@fluidframework/common-utils": "^1.0.0",
-    "@fluidframework/container-definitions": ">=2.0.0-internal.2.2.1 <2.0.0-internal.3.0.0",
-    "@fluidframework/container-runtime-definitions": ">=2.0.0-internal.2.2.1 <2.0.0-internal.3.0.0",
-    "@fluidframework/core-interfaces": ">=2.0.0-internal.2.2.1 <2.0.0-internal.3.0.0",
-    "@fluidframework/datastore-definitions": ">=2.0.0-internal.2.2.1 <2.0.0-internal.3.0.0",
-    "@fluidframework/driver-utils": ">=2.0.0-internal.2.2.1 <2.0.0-internal.3.0.0",
+    "@fluidframework/container-definitions": ">=2.0.0-internal.2.3.1 <2.0.0-internal.3.0.0",
+    "@fluidframework/container-runtime-definitions": ">=2.0.0-internal.2.3.1 <2.0.0-internal.3.0.0",
+    "@fluidframework/core-interfaces": ">=2.0.0-internal.2.3.1 <2.0.0-internal.3.0.0",
+    "@fluidframework/datastore-definitions": ">=2.0.0-internal.2.3.1 <2.0.0-internal.3.0.0",
+    "@fluidframework/driver-utils": ">=2.0.0-internal.2.3.1 <2.0.0-internal.3.0.0",
     "@fluidframework/protocol-definitions": "^1.1.0",
-    "@fluidframework/runtime-definitions": ">=2.0.0-internal.2.2.1 <2.0.0-internal.3.0.0",
-    "@fluidframework/shared-object-base": ">=2.0.0-internal.2.2.1 <2.0.0-internal.3.0.0"
+    "@fluidframework/runtime-definitions": ">=2.0.0-internal.2.3.1 <2.0.0-internal.3.0.0",
+    "@fluidframework/shared-object-base": ">=2.0.0-internal.2.3.1 <2.0.0-internal.3.0.0",
+    "events": "^3.1.0"
   },
   "devDependencies": {
-    "@fluid-experimental/task-manager-previous": "npm:@fluid-experimental/task-manager@2.0.0-internal.2.1.0",
-    "@fluid-internal/stochastic-test-utils": ">=2.0.0-internal.2.2.1 <2.0.0-internal.3.0.0",
-    "@fluid-internal/test-dds-utils": ">=2.0.0-internal.2.2.1 <2.0.0-internal.3.0.0",
+    "@fluid-internal/stochastic-test-utils": ">=2.0.0-internal.2.3.1 <2.0.0-internal.3.0.0",
+    "@fluid-internal/test-dds-utils": ">=2.0.0-internal.2.3.1 <2.0.0-internal.3.0.0",
     "@fluid-tools/build-cli": "^0.7.0",
     "@fluidframework/build-common": "^1.1.0",
     "@fluidframework/build-tools": "^0.7.0",
-    "@fluidframework/eslint-config-fluid": "^1.2.0",
-    "@fluidframework/mocha-test-setup": ">=2.0.0-internal.2.2.1 <2.0.0-internal.3.0.0",
-    "@fluidframework/test-runtime-utils": ">=2.0.0-internal.2.2.1 <2.0.0-internal.3.0.0",
+    "@fluidframework/eslint-config-fluid": "^2.0.0",
+    "@fluidframework/mocha-test-setup": ">=2.0.0-internal.2.3.1 <2.0.0-internal.3.0.0",
+    "@fluidframework/task-manager-previous": "npm:@fluidframework/task-manager@2.0.0-internal.2.3.0",
+    "@fluidframework/test-runtime-utils": ">=2.0.0-internal.2.3.1 <2.0.0-internal.3.0.0",
     "@microsoft/api-extractor": "^7.22.2",
     "@rushstack/eslint-config": "^2.5.1",
     "@types/mocha": "^9.1.1",
@@ -99,10 +100,8 @@
     "typescript": "~4.5.5"
   },
   "typeValidation": {
-    "disabled": true,
-    "version": "2.0.0-internal.2.2.0",
-    "baselineRange": ">=2.0.0-internal.2.1.0 <2.0.0-internal.2.2.0",
-    "baselineVersion": "2.0.0-internal.2.1.0",
+    "version": "2.0.0-internal.2.3.1",
+    "baselineRange": "2.0.0-internal.2.3.0",
     "broken": {}
   }
 }

package/src/packageVersion.ts CHANGED Viewed

@@ -6,4 +6,4 @@
  */
 export const pkgName = "@fluidframework/task-manager";
-export const pkgVersion = "2.0.0-internal.2.2.1";
+export const pkgVersion = "2.0.0-internal.2.3.1";

package/src/taskManager.ts CHANGED Viewed

@@ -380,8 +380,8 @@ export class TaskManager extends SharedObject<ITaskManagerEvents> implements ITa
         if (this.readOnlyInfo.readonly === true) {
             const error = this.readOnlyInfo.permissions === true ?
-                new Error(`Attempted to volunteer with read-only permissions: ${taskId}`) :
-                new Error(`Attempted to volunteer in read-only state: ${taskId}`);
+                new Error("Attempted to volunteer with read-only permissions") :
+                new Error("Attempted to volunteer in read-only state");
             throw error;
         }
@@ -393,7 +393,7 @@ export class TaskManager extends SharedObject<ITaskManagerEvents> implements ITa
         }
         if (!this.connected) {
-            throw new Error(`Attempted to volunteer in disconnected state: ${taskId}`);
+            throw new Error("Attempted to volunteer in disconnected state");
         }
         // This promise works even if we already have an outstanding volunteer op.
@@ -424,7 +424,7 @@ export class TaskManager extends SharedObject<ITaskManagerEvents> implements ITa
                 this.abandonWatcher.off("abandon", checkIfAbandoned);
                 this.connectionWatcher.off("disconnect", rejectOnDisconnect);
                 this.completedWatcher.off("completed", checkIfCompleted);
-                reject(new Error(`Abandoned before acquiring task assignment: ${taskId}`));
+                reject(new Error("Abandoned before acquiring task assignment"));
             };
             const rejectOnDisconnect = () => {
@@ -432,7 +432,7 @@ export class TaskManager extends SharedObject<ITaskManagerEvents> implements ITa
                 this.abandonWatcher.off("abandon", checkIfAbandoned);
                 this.connectionWatcher.off("disconnect", rejectOnDisconnect);
                 this.completedWatcher.off("completed", checkIfCompleted);
-                reject(new Error(`Disconnected before acquiring task assignment: ${taskId}`));
+                reject(new Error("Disconnected before acquiring task assignment"));
             };
             const checkIfCompleted = (eventTaskId: string) => {
@@ -468,7 +468,7 @@ export class TaskManager extends SharedObject<ITaskManagerEvents> implements ITa
         }
         if (this.readOnlyInfo.readonly === true && this.readOnlyInfo.permissions === true) {
-            throw new Error(`Attempted to subscribe with read-only permissions: ${taskId}`);
+            throw new Error("Attempted to subscribe with read-only permissions");
         }
         const submitVolunteerOp = () => {
@@ -611,14 +611,14 @@ export class TaskManager extends SharedObject<ITaskManagerEvents> implements ITa
      */
     public complete(taskId: string): void {
         if (!this.assigned(taskId)) {
-            throw new Error(`Attempted to mark task as complete while not being assigned: ${taskId}`);
+            throw new Error("Attempted to mark task as complete while not being assigned");
         }
         // If we are detached we will simulate auto-ack for the complete op. Therefore we only need to send the op if
         // we are attached. Additionally, we don't need to check if we are connected while detached.
         if (this.isAttached()) {
             if (!this.connected) {
-                throw new Error(`Attempted to complete task in disconnected state: ${taskId}`);
+                throw new Error("Attempted to complete task in disconnected state");
             }
             this.submitCompleteOp(taskId);
         }