@fluidframework/task-manager 2.0.0-internal.4.2.1 → 2.0.0-internal.4.3.0

package/lib/taskManager.js

@@ -14,92 +14,9 @@ const snapshotFileName = "header";
  */
 const placeholderClientId = "placeholder";
 /**
- * The TaskManager distributed data structure tracks queues of clients that want to exclusively run a task.
+ * {@inheritDoc ITaskManager}
  *
- * @remarks
- *
- * ### Creation
- *
- * To create a `TaskManager`, call the static create method:
- *
- * ```typescript
- * const taskManager = TaskManager.create(this.runtime, id);
- * ```
- *
- * ### Usage
- *
- * To volunteer for a task, use the `volunteerForTask()` method.  This returns a Promise that will resolve once the
- * client has acquired exclusive rights to run the task, or reject if the client is removed from the queue without
- * acquiring the rights.
- *
- * ```typescript
- * taskManager.volunteerForTask("NameOfTask")
- *     .then(() => { doTheTask(); })
- *     .catch((err) => { console.error(err); });
- * ```
- *
- * Alternatively, you can indefinitely volunteer for a task with the synchronous `subscribeToTask()` method. This
- * method does not return a value, therefore you need to rely on eventing to know when you have acquired the rights
- * to run the task (see below).
- *
- * ```typescript
- * taskManager.subscribeToTask("NameOfTask");
- * ```
- *
- * To check if the local client is currently subscribed to a task, use the `subscribed()` method.
- * ```typescript
- * if (taskManager.subscribed("NameOfTask")) {
- *     console.log("This client is currently subscribed to the task.");
- * }
- * ```
- *
- * To release the rights to the task, use the `abandon()` method.  The next client in the queue will then get the
- * rights to run the task.
- *
- * ```typescript
- * taskManager.abandon("NameOfTask");
- * ```
- *
- * To inspect your state in the queue, you can use the `queued()` and `assigned()` methods.
- *
- * ```typescript
- * if (taskManager.queued("NameOfTask")) {
- *     console.log("This client is somewhere in the queue, potentially even having the task assignment.");
- * }
- *
- * if (taskManager.assigned("NameOfTask")) {
- *     console.log("This client currently has the rights to run the task");
- * }
- * ```
- *
- * To signal to other connected clients that a task is completed, use the `complete()` method. This will release all
- * clients from the queue and emit the "completed" event.
- *
- * ```typescript
- * taskManager.complete("NameOfTask");
- * ```
- *
- * ### Eventing
- *
- * `TaskManager` is an `EventEmitter`, and will emit events when a task is assigned to the client, when the task
- * assignment is lost, and when a task was completed by another client.
- *
- * ```typescript
- * taskManager.on("assigned", (taskId: string) => {
- *     console.log(`Client was assigned task: ${taskId}`);
- * });
- *
- * taskManager.on("lost", (taskId: string) => {
- *     console.log(`Client released task: ${taskId}`);
- * });
- *
- * taskManager.on("completed", (taskId: string) => {
- *     console.log(`Another client completed task: ${taskId}`);
- * });
- * ```
- *
- * These can be useful if the logic to volunteer for a task is separated from the logic to perform the task, such as
- * when using the `subscribeToTask()` method.
+ * @sealed
  */
 export class TaskManager extends SharedObject {
     /**
@@ -704,7 +621,7 @@ export class TaskManager extends SharedObject {
         }
     }
     applyStashedOp() {
-        throw new Error("not implemented");
+        // do nothing...
     }
 }
 //# sourceMappingURL=taskManager.js.map

package/lib/taskManager.js.map

@@ -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\tIChannelAttributes,\n\tIFluidDataStoreRuntime,\n\tIChannelStorageService,\n\tIChannelFactory,\n} from \"@fluidframework/datastore-definitions\";\nimport { ISummaryTreeWithStats } from \"@fluidframework/runtime-definitions\";\nimport { readAndParse } from \"@fluidframework/driver-utils\";\nimport {\n\tcreateSingleBlobSummary,\n\tIFluidSerializer,\n\tSharedObject,\n} 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\t| ITaskManagerVolunteerOperation\n\t| ITaskManagerAbandonOperation\n\t| ITaskManagerCompletedOperation;\n\ninterface ITaskManagerVolunteerOperation {\n\ttype: \"volunteer\";\n\ttaskId: string;\n}\n\ninterface ITaskManagerAbandonOperation {\n\ttype: \"abandon\";\n\ttaskId: string;\n}\n\ninterface ITaskManagerCompletedOperation {\n\ttype: \"complete\";\n\ttaskId: string;\n}\n\ninterface IPendingOp {\n\ttype: \"volunteer\" | \"abandon\" | \"complete\";\n\tmessageId: number;\n}\n\nconst snapshotFileName = \"header\";\n\n/**\n * Placeholder clientId for detached scenarios.\n */\nconst placeholderClientId = \"placeholder\";\n\n/**\n * The TaskManager distributed data structure tracks queues of clients that want to exclusively run a task.\n *\n * @remarks\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\t/**\n\t * Create a new TaskManager\n\t *\n\t * @param runtime - data store runtime the new task queue belongs to\n\t * @param id - optional name of the task queue\n\t * @returns newly create task queue (but not attached yet)\n\t */\n\tpublic static create(runtime: IFluidDataStoreRuntime, id?: string) {\n\t\treturn runtime.createChannel(id, TaskManagerFactory.Type) as TaskManager;\n\t}\n\n\t/**\n\t * Get a factory for TaskManager to register with the data store.\n\t *\n\t * @returns a factory that creates and load TaskManager\n\t */\n\tpublic static getFactory(): IChannelFactory {\n\t\treturn new TaskManagerFactory();\n\t}\n\n\t/**\n\t * Mapping of taskId to a queue of clientIds that are waiting on the task.  Maintains the consensus state of the\n\t * queue, even if we know we've submitted an op that should eventually modify the queue.\n\t */\n\tprivate readonly taskQueues: Map<string, string[]> = new Map();\n\n\t// opWatcher emits for every op on this data store.  This is just a repackaging of processCore into events.\n\tprivate readonly opWatcher: EventEmitter = new EventEmitter();\n\t// queueWatcher emits an event whenever the consensus state of the task queues changes\n\tprivate readonly queueWatcher: EventEmitter = new EventEmitter();\n\t// abandonWatcher emits an event whenever the local client calls abandon() on a task.\n\tprivate readonly abandonWatcher: EventEmitter = new EventEmitter();\n\t// connectionWatcher emits an event whenever we get connected or disconnected.\n\tprivate readonly connectionWatcher: EventEmitter = new EventEmitter();\n\t// completedWatcher emits an event whenever the local client receives a completed op.\n\tprivate readonly completedWatcher: EventEmitter = new EventEmitter();\n\n\tprivate messageId: number = -1;\n\t/**\n\t * Tracks the most recent pending op for a given task\n\t */\n\tprivate readonly latestPendingOps: Map<string, IPendingOp> = new Map();\n\n\t/**\n\t * Tracks tasks that are this client is currently subscribed to.\n\t */\n\tprivate readonly subscribedTasks: Set<string> = new Set();\n\n\t/**\n\t * Map to track tasks that have pending complete ops.\n\t */\n\tprivate readonly pendingCompletedTasks: Map<string, number[]> = new Map();\n\n\t/**\n\t * Returns the clientId. Will return a placeholder if the runtime is detached and not yet assigned a clientId.\n\t */\n\tprivate get clientId(): string | undefined {\n\t\treturn this.isAttached() ? this.runtime.clientId : placeholderClientId;\n\t}\n\n\t/**\n\t * Returns a ReadOnlyInfo object to determine current read/write permissions.\n\t */\n\tprivate get readOnlyInfo(): ReadOnlyInfo {\n\t\treturn this.runtime.deltaManager.readOnlyInfo;\n\t}\n\n\t/**\n\t * Constructs a new task manager. If the object is non-local an id and service interfaces will\n\t * be provided\n\t *\n\t * @param runtime - data store runtime the task queue belongs to\n\t * @param id - optional name of the task queue\n\t */\n\tconstructor(id: string, runtime: IFluidDataStoreRuntime, attributes: IChannelAttributes) {\n\t\tsuper(id, runtime, attributes, \"fluid_taskManager_\");\n\n\t\tthis.opWatcher.on(\n\t\t\t\"volunteer\",\n\t\t\t(taskId: string, clientId: string, local: boolean, messageId: number) => {\n\t\t\t\t// We're tracking local ops from this connection. Filter out local ops during \"connecting\"\n\t\t\t\t// state since these were sent on the prior connection and were already cleared from the latestPendingOps.\n\t\t\t\tif (runtime.connected && local) {\n\t\t\t\t\tconst pendingOp = this.latestPendingOps.get(taskId);\n\t\t\t\t\tassert(pendingOp !== undefined, 0x07b /* \"Unexpected op\" */);\n\t\t\t\t\t// Need to check the id, since it's possible to volunteer and abandon multiple times before the acks\n\t\t\t\t\tif (messageId === pendingOp.messageId) {\n\t\t\t\t\t\tassert(pendingOp.type === \"volunteer\", 0x07c /* \"Unexpected op type\" */);\n\t\t\t\t\t\t// Delete the pending, because we no longer have an outstanding op\n\t\t\t\t\t\tthis.latestPendingOps.delete(taskId);\n\t\t\t\t\t}\n\t\t\t\t}\n\n\t\t\t\tthis.addClientToQueue(taskId, clientId);\n\t\t\t},\n\t\t);\n\n\t\tthis.opWatcher.on(\n\t\t\t\"abandon\",\n\t\t\t(taskId: string, clientId: string, local: boolean, messageId: number) => {\n\t\t\t\tif (runtime.connected && local) {\n\t\t\t\t\tconst pendingOp = this.latestPendingOps.get(taskId);\n\t\t\t\t\tassert(pendingOp !== undefined, 0x07d /* \"Unexpected op\" */);\n\t\t\t\t\t// Need to check the id, since it's possible to abandon and volunteer multiple times before the acks\n\t\t\t\t\tif (messageId === pendingOp.messageId) {\n\t\t\t\t\t\tassert(pendingOp.type === \"abandon\", 0x07e /* \"Unexpected op type\" */);\n\t\t\t\t\t\t// Delete the pending, because we no longer have an outstanding op\n\t\t\t\t\t\tthis.latestPendingOps.delete(taskId);\n\t\t\t\t\t}\n\t\t\t\t}\n\n\t\t\t\tthis.removeClientFromQueue(taskId, clientId);\n\t\t\t},\n\t\t);\n\n\t\tthis.opWatcher.on(\n\t\t\t\"complete\",\n\t\t\t(taskId: string, clientId: string, local: boolean, messageId: number) => {\n\t\t\t\tif (runtime.connected && local) {\n\t\t\t\t\tconst pendingOp = this.latestPendingOps.get(taskId);\n\t\t\t\t\tassert(pendingOp !== undefined, 0x400 /* Unexpected op */);\n\t\t\t\t\t// Need to check the id, since it's possible to complete multiple times before the acks\n\t\t\t\t\tif (messageId === pendingOp.messageId) {\n\t\t\t\t\t\tassert(pendingOp.type === \"complete\", 0x401 /* Unexpected op type */);\n\t\t\t\t\t\t// Delete the pending, because we no longer have an outstanding op\n\t\t\t\t\t\tthis.latestPendingOps.delete(taskId);\n\t\t\t\t\t}\n\n\t\t\t\t\t// Remove complete op from this.pendingCompletedTasks\n\t\t\t\t\tconst pendingIds = this.pendingCompletedTasks.get(taskId);\n\t\t\t\t\tassert(\n\t\t\t\t\t\tpendingIds !== undefined && pendingIds.length > 0,\n\t\t\t\t\t\t0x402 /* pendingIds is empty */,\n\t\t\t\t\t);\n\t\t\t\t\tconst removed = pendingIds.shift();\n\t\t\t\t\tassert(\n\t\t\t\t\t\tremoved === messageId,\n\t\t\t\t\t\t0x403 /* Removed complete op id does not match */,\n\t\t\t\t\t);\n\t\t\t\t}\n\n\t\t\t\t// For clients in queue, we need to remove them from the queue and raise the proper events.\n\t\t\t\tif (!local) {\n\t\t\t\t\tthis.taskQueues.delete(taskId);\n\t\t\t\t\tthis.completedWatcher.emit(\"completed\", taskId);\n\t\t\t\t\tthis.emit(\"completed\", taskId);\n\t\t\t\t}\n\t\t\t},\n\t\t);\n\n\t\truntime.getQuorum().on(\"removeMember\", (clientId: string) => {\n\t\t\tthis.removeClientFromAllQueues(clientId);\n\t\t});\n\n\t\tthis.queueWatcher.on(\n\t\t\t\"queueChange\",\n\t\t\t(taskId: string, oldLockHolder: string, newLockHolder: string) => {\n\t\t\t\t// If oldLockHolder is placeholderClientId we need to emit the task was lost during the attach process\n\t\t\t\tif (oldLockHolder === placeholderClientId) {\n\t\t\t\t\tthis.emit(\"lost\", taskId);\n\t\t\t\t\treturn;\n\t\t\t\t}\n\n\t\t\t\t// Exit early if we are still catching up on reconnect -- we can't be the leader yet anyway.\n\t\t\t\tif (this.clientId === undefined) {\n\t\t\t\t\treturn;\n\t\t\t\t}\n\n\t\t\t\tif (oldLockHolder !== this.clientId && newLockHolder === this.clientId) {\n\t\t\t\t\tthis.emit(\"assigned\", taskId);\n\t\t\t\t} else if (oldLockHolder === this.clientId && newLockHolder !== this.clientId) {\n\t\t\t\t\tthis.emit(\"lost\", taskId);\n\t\t\t\t}\n\t\t\t},\n\t\t);\n\n\t\tthis.connectionWatcher.on(\"disconnect\", () => {\n\t\t\tassert(this.clientId !== undefined, 0x1d3 /* \"Missing client id on disconnect\" */);\n\n\t\t\t// We don't modify the taskQueues on disconnect (they still reflect the latest known consensus state).\n\t\t\t// After reconnect these will get cleaned up by observing the clientLeaves.\n\t\t\t// However we do need to recognize that we lost the lock if we had it.  Calls to .queued() and\n\t\t\t// .assigned() are also connection-state-aware to be consistent.\n\t\t\tfor (const [taskId, clientQueue] of this.taskQueues.entries()) {\n\t\t\t\tif (this.isAttached() && clientQueue[0] === this.clientId) {\n\t\t\t\t\tthis.emit(\"lost\", taskId);\n\t\t\t\t}\n\t\t\t}\n\n\t\t\t// All of our outstanding ops will be for the old clientId even if they get ack'd\n\t\t\tthis.latestPendingOps.clear();\n\t\t});\n\t}\n\n\tprivate submitVolunteerOp(taskId: string) {\n\t\tconst op: ITaskManagerVolunteerOperation = {\n\t\t\ttype: \"volunteer\",\n\t\t\ttaskId,\n\t\t};\n\t\tconst pendingOp: IPendingOp = {\n\t\t\ttype: \"volunteer\",\n\t\t\tmessageId: ++this.messageId,\n\t\t};\n\t\tthis.submitLocalMessage(op, pendingOp.messageId);\n\t\tthis.latestPendingOps.set(taskId, pendingOp);\n\t}\n\n\tprivate submitAbandonOp(taskId: string) {\n\t\tconst op: ITaskManagerAbandonOperation = {\n\t\t\ttype: \"abandon\",\n\t\t\ttaskId,\n\t\t};\n\t\tconst pendingOp: IPendingOp = {\n\t\t\ttype: \"abandon\",\n\t\t\tmessageId: ++this.messageId,\n\t\t};\n\t\tthis.submitLocalMessage(op, pendingOp.messageId);\n\t\tthis.latestPendingOps.set(taskId, pendingOp);\n\t}\n\n\tprivate submitCompleteOp(taskId: string) {\n\t\tconst op: ITaskManagerCompletedOperation = {\n\t\t\ttype: \"complete\",\n\t\t\ttaskId,\n\t\t};\n\t\tconst pendingOp: IPendingOp = {\n\t\t\ttype: \"complete\",\n\t\t\tmessageId: ++this.messageId,\n\t\t};\n\n\t\tif (this.pendingCompletedTasks.has(taskId)) {\n\t\t\tthis.pendingCompletedTasks.get(taskId)?.push(pendingOp.messageId);\n\t\t} else {\n\t\t\tthis.pendingCompletedTasks.set(taskId, [pendingOp.messageId]);\n\t\t}\n\n\t\tthis.submitLocalMessage(op, pendingOp.messageId);\n\t\tthis.latestPendingOps.set(taskId, pendingOp);\n\t}\n\n\t/**\n\t * {@inheritDoc ITaskManager.volunteerForTask}\n\t */\n\tpublic async volunteerForTask(taskId: string) {\n\t\t// If we have the lock, resolve immediately\n\t\tif (this.assigned(taskId)) {\n\t\t\treturn true;\n\t\t}\n\n\t\tif (this.readOnlyInfo.readonly === true) {\n\t\t\tconst error =\n\t\t\t\tthis.readOnlyInfo.permissions === true\n\t\t\t\t\t? new Error(\"Attempted to volunteer with read-only permissions\")\n\t\t\t\t\t: new Error(\"Attempted to volunteer in read-only state\");\n\t\t\tthrow error;\n\t\t}\n\n\t\tif (!this.isAttached()) {\n\t\t\t// Simulate auto-ack in detached scenario\n\t\t\tassert(this.clientId !== undefined, 0x472 /* clientId should not be undefined */);\n\t\t\tthis.addClientToQueue(taskId, this.clientId);\n\t\t\treturn true;\n\t\t}\n\n\t\tif (!this.connected) {\n\t\t\tthrow new Error(\"Attempted to volunteer in disconnected state\");\n\t\t}\n\n\t\t// This promise works even if we already have an outstanding volunteer op.\n\t\tconst lockAcquireP = new Promise<boolean>((resolve, reject) => {\n\t\t\tconst checkIfAcquiredLock = (eventTaskId: string) => {\n\t\t\t\tif (eventTaskId !== taskId) {\n\t\t\t\t\treturn;\n\t\t\t\t}\n\n\t\t\t\t// Also check pending ops here because it's possible we are currently in the queue from a previous\n\t\t\t\t// lock attempt, but have an outstanding abandon AND the outstanding volunteer for this lock attempt.\n\t\t\t\t// If we reach the head of the queue based on the previous lock attempt, we don't want to resolve.\n\t\t\t\tif (this.assigned(taskId) && !this.latestPendingOps.has(taskId)) {\n\t\t\t\t\tthis.queueWatcher.off(\"queueChange\", checkIfAcquiredLock);\n\t\t\t\t\tthis.abandonWatcher.off(\"abandon\", checkIfAbandoned);\n\t\t\t\t\tthis.connectionWatcher.off(\"disconnect\", rejectOnDisconnect);\n\t\t\t\t\tthis.completedWatcher.off(\"completed\", checkIfCompleted);\n\t\t\t\t\tresolve(true);\n\t\t\t\t}\n\t\t\t};\n\n\t\t\tconst checkIfAbandoned = (eventTaskId: string) => {\n\t\t\t\tif (eventTaskId !== taskId) {\n\t\t\t\t\treturn;\n\t\t\t\t}\n\n\t\t\t\tthis.queueWatcher.off(\"queueChange\", checkIfAcquiredLock);\n\t\t\t\tthis.abandonWatcher.off(\"abandon\", checkIfAbandoned);\n\t\t\t\tthis.connectionWatcher.off(\"disconnect\", rejectOnDisconnect);\n\t\t\t\tthis.completedWatcher.off(\"completed\", checkIfCompleted);\n\t\t\t\treject(new Error(\"Abandoned before acquiring task assignment\"));\n\t\t\t};\n\n\t\t\tconst rejectOnDisconnect = () => {\n\t\t\t\tthis.queueWatcher.off(\"queueChange\", checkIfAcquiredLock);\n\t\t\t\tthis.abandonWatcher.off(\"abandon\", checkIfAbandoned);\n\t\t\t\tthis.connectionWatcher.off(\"disconnect\", rejectOnDisconnect);\n\t\t\t\tthis.completedWatcher.off(\"completed\", checkIfCompleted);\n\t\t\t\treject(new Error(\"Disconnected before acquiring task assignment\"));\n\t\t\t};\n\n\t\t\tconst checkIfCompleted = (eventTaskId: string) => {\n\t\t\t\tif (eventTaskId !== taskId) {\n\t\t\t\t\treturn;\n\t\t\t\t}\n\n\t\t\t\tthis.queueWatcher.off(\"queueChange\", checkIfAcquiredLock);\n\t\t\t\tthis.abandonWatcher.off(\"abandon\", checkIfAbandoned);\n\t\t\t\tthis.connectionWatcher.off(\"disconnect\", rejectOnDisconnect);\n\t\t\t\tthis.completedWatcher.off(\"completed\", checkIfCompleted);\n\t\t\t\tresolve(false);\n\t\t\t};\n\n\t\t\tthis.queueWatcher.on(\"queueChange\", checkIfAcquiredLock);\n\t\t\tthis.abandonWatcher.on(\"abandon\", checkIfAbandoned);\n\t\t\tthis.connectionWatcher.on(\"disconnect\", rejectOnDisconnect);\n\t\t\tthis.completedWatcher.on(\"completed\", checkIfCompleted);\n\t\t});\n\n\t\tif (!this.queued(taskId)) {\n\t\t\tthis.submitVolunteerOp(taskId);\n\t\t}\n\t\treturn lockAcquireP;\n\t}\n\n\t/**\n\t * {@inheritDoc ITaskManager.subscribeToTask}\n\t */\n\tpublic subscribeToTask(taskId: string) {\n\t\tif (this.subscribed(taskId)) {\n\t\t\treturn;\n\t\t}\n\n\t\tif (this.readOnlyInfo.readonly === true && this.readOnlyInfo.permissions === true) {\n\t\t\tthrow new Error(\"Attempted to subscribe with read-only permissions\");\n\t\t}\n\n\t\tconst submitVolunteerOp = () => {\n\t\t\tthis.submitVolunteerOp(taskId);\n\t\t};\n\n\t\tconst disconnectHandler = () => {\n\t\t\t// Wait to be connected again and then re-submit volunteer op\n\t\t\tthis.connectionWatcher.once(\"connect\", submitVolunteerOp);\n\t\t};\n\n\t\tconst checkIfAbandoned = (eventTaskId: string) => {\n\t\t\tif (eventTaskId !== taskId) {\n\t\t\t\treturn;\n\t\t\t}\n\n\t\t\tthis.abandonWatcher.off(\"abandon\", checkIfAbandoned);\n\t\t\tthis.connectionWatcher.off(\"disconnect\", disconnectHandler);\n\t\t\tthis.connectionWatcher.off(\"connect\", submitVolunteerOp);\n\t\t\tthis.completedWatcher.off(\"completed\", checkIfCompleted);\n\n\t\t\tthis.subscribedTasks.delete(taskId);\n\t\t};\n\n\t\tconst checkIfCompleted = (eventTaskId: string) => {\n\t\t\tif (eventTaskId !== taskId) {\n\t\t\t\treturn;\n\t\t\t}\n\n\t\t\tthis.abandonWatcher.off(\"abandon\", checkIfAbandoned);\n\t\t\tthis.connectionWatcher.off(\"disconnect\", disconnectHandler);\n\t\t\tthis.connectionWatcher.off(\"connect\", submitVolunteerOp);\n\t\t\tthis.completedWatcher.off(\"completed\", checkIfCompleted);\n\n\t\t\tthis.subscribedTasks.delete(taskId);\n\t\t};\n\n\t\tthis.abandonWatcher.on(\"abandon\", checkIfAbandoned);\n\t\tthis.connectionWatcher.on(\"disconnect\", disconnectHandler);\n\t\tthis.completedWatcher.on(\"completed\", checkIfCompleted);\n\n\t\tif (!this.isAttached()) {\n\t\t\t// Simulate auto-ack in detached scenario\n\t\t\tassert(this.clientId !== undefined, 0x473 /* clientId should not be undefined */);\n\t\t\tthis.addClientToQueue(taskId, this.clientId);\n\t\t\t// Because we volunteered with placeholderClientId, we need to wait for when we attach and are assigned\n\t\t\t// a real clientId. At that point we should re-enter the queue with a real volunteer op (assuming we are\n\t\t\t// connected).\n\t\t\tthis.runtime.once(\"attached\", () => {\n\t\t\t\tif (this.queued(taskId)) {\n\t\t\t\t\t// If we are already queued, then we were able to replace the placeholderClientId with our real\n\t\t\t\t\t// clientId and no action is required.\n\t\t\t\t\treturn;\n\t\t\t\t} else if (this.connected) {\n\t\t\t\t\tsubmitVolunteerOp();\n\t\t\t\t} else {\n\t\t\t\t\tthis.connectionWatcher.once(\"connect\", () => {\n\t\t\t\t\t\tsubmitVolunteerOp();\n\t\t\t\t\t});\n\t\t\t\t}\n\t\t\t});\n\t\t} else if (!this.connected) {\n\t\t\t// If we are disconnected (and attached), wait to be connected and submit volunteer op\n\t\t\tdisconnectHandler();\n\t\t} else if (!this.assigned(taskId) && !this.queued(taskId)) {\n\t\t\tsubmitVolunteerOp();\n\t\t}\n\t\tthis.subscribedTasks.add(taskId);\n\t}\n\n\t/**\n\t * {@inheritDoc ITaskManager.abandon}\n\t */\n\tpublic abandon(taskId: string) {\n\t\t// Always allow abandon if the client is subscribed to allow clients to unsubscribe while disconnected.\n\t\t// Otherwise, we should check to make sure the client is both connected queued for the task before sending an\n\t\t// abandon op.\n\t\tif (!this.subscribed(taskId) && !this.queued(taskId)) {\n\t\t\t// Nothing to do\n\t\t\treturn;\n\t\t}\n\n\t\tif (!this.isAttached()) {\n\t\t\t// Simulate auto-ack in detached scenario\n\t\t\tassert(this.clientId !== undefined, 0x474 /* clientId is undefined */);\n\t\t\tthis.removeClientFromQueue(taskId, this.clientId);\n\t\t\tthis.abandonWatcher.emit(\"abandon\", taskId);\n\t\t\treturn;\n\t\t}\n\n\t\t// If we're subscribed but not queued, we don't need to submit an abandon op (probably offline)\n\t\tif (this.queued(taskId)) {\n\t\t\tthis.submitAbandonOp(taskId);\n\t\t}\n\t\tthis.abandonWatcher.emit(\"abandon\", taskId);\n\t}\n\n\t/**\n\t * {@inheritDoc ITaskManager.assigned}\n\t */\n\tpublic assigned(taskId: string) {\n\t\tif (this.isAttached() && !this.connected) {\n\t\t\treturn false;\n\t\t}\n\n\t\tconst currentAssignee = this.taskQueues.get(taskId)?.[0];\n\t\treturn (\n\t\t\tcurrentAssignee !== undefined &&\n\t\t\tcurrentAssignee === this.clientId &&\n\t\t\t!this.latestPendingOps.has(taskId)\n\t\t);\n\t}\n\n\t/**\n\t * {@inheritDoc ITaskManager.queued}\n\t */\n\tpublic queued(taskId: string) {\n\t\tif (this.isAttached() && !this.connected) {\n\t\t\treturn false;\n\t\t}\n\n\t\tassert(this.clientId !== undefined, 0x07f /* \"clientId undefined\" */);\n\n\t\tconst clientQueue = this.taskQueues.get(taskId);\n\t\t// If we have no queue for the taskId, then no one has signed up for it.\n\t\treturn (\n\t\t\t((clientQueue?.includes(this.clientId) ?? false) &&\n\t\t\t\t!this.latestPendingOps.has(taskId)) ||\n\t\t\tthis.latestPendingOps.get(taskId)?.type === \"volunteer\"\n\t\t);\n\t}\n\n\t/**\n\t * {@inheritDoc ITaskManager.subscribed}\n\t */\n\tpublic subscribed(taskId: string): boolean {\n\t\treturn this.subscribedTasks.has(taskId);\n\t}\n\n\t/**\n\t * {@inheritDoc ITaskManager.complete}\n\t */\n\tpublic complete(taskId: string): void {\n\t\tif (!this.assigned(taskId)) {\n\t\t\tthrow new Error(\"Attempted to mark task as complete while not being assigned\");\n\t\t}\n\n\t\t// If we are detached we will simulate auto-ack for the complete op. Therefore we only need to send the op if\n\t\t// we are attached. Additionally, we don't need to check if we are connected while detached.\n\t\tif (this.isAttached()) {\n\t\t\tif (!this.connected) {\n\t\t\t\tthrow new Error(\"Attempted to complete task in disconnected state\");\n\t\t\t}\n\t\t\tthis.submitCompleteOp(taskId);\n\t\t}\n\n\t\tthis.taskQueues.delete(taskId);\n\t\tthis.completedWatcher.emit(\"completed\", taskId);\n\t\tthis.emit(\"completed\", taskId);\n\t}\n\n\t/**\n\t * {@inheritDoc ITaskManager.canVolunteer}\n\t */\n\tpublic canVolunteer(): boolean {\n\t\t// A client can volunteer for a task if it's both connected to the delta stream and in write mode.\n\t\t// this.connected reflects that condition, but is unintuitive and may be changed in the future. This API allows\n\t\t// us to make changes to this.connected without affecting our guidance on how to check if a client is eligible\n\t\t// to volunteer for a task.\n\t\treturn this.connected;\n\t}\n\n\t/**\n\t * Create a summary for the task manager\n\t *\n\t * @returns the summary of the current state of the task manager\n\t * @internal\n\t */\n\tprotected summarizeCore(serializer: IFluidSerializer): ISummaryTreeWithStats {\n\t\tif (this.runtime.clientId !== undefined) {\n\t\t\t// If the runtime has been assigned an actual clientId by now, we can replace the placeholder clientIds\n\t\t\t// and maintain the task assignment.\n\t\t\tthis.replacePlaceholderInAllQueues();\n\t\t} else {\n\t\t\t// If the runtime has still not been assigned a clientId, we should not summarize with the placeholder\n\t\t\t// clientIds and instead remove them from the queues and require the client to re-volunteer when assigned\n\t\t\t// a new clientId.\n\t\t\tthis.removeClientFromAllQueues(placeholderClientId);\n\t\t}\n\n\t\t// Only include tasks if there are clients in the queue.\n\t\tconst filteredMap = new Map<string, string[]>();\n\t\tthis.taskQueues.forEach((queue: string[], taskId: string) => {\n\t\t\tif (queue.length > 0) {\n\t\t\t\tfilteredMap.set(taskId, queue);\n\t\t\t}\n\t\t});\n\t\tconst content = [...filteredMap.entries()];\n\t\treturn createSingleBlobSummary(snapshotFileName, JSON.stringify(content));\n\t}\n\n\t/**\n\t * {@inheritDoc @fluidframework/shared-object-base#SharedObject.loadCore}\n\t * @internal\n\t */\n\tprotected async loadCore(storage: IChannelStorageService): Promise<void> {\n\t\tconst content = await readAndParse<[string, string[]][]>(storage, snapshotFileName);\n\t\tcontent.forEach(([taskId, clientIdQueue]) => {\n\t\t\tthis.taskQueues.set(taskId, clientIdQueue);\n\t\t});\n\t\tthis.scrubClientsNotInQuorum();\n\t}\n\n\t/**\n\t * @internal\n\t */\n\tprotected initializeLocalCore() {}\n\n\t/**\n\t * {@inheritDoc @fluidframework/shared-object-base#SharedObject.onDisconnect}\n\t * @internal\n\t */\n\tprotected onDisconnect() {\n\t\tthis.connectionWatcher.emit(\"disconnect\");\n\t}\n\n\t/**\n\t * {@inheritDoc @fluidframework/shared-object-base#SharedObject.onConnect}\n\t * @internal\n\t */\n\tprotected onConnect() {\n\t\tthis.connectionWatcher.emit(\"connect\");\n\t}\n\n\t//\n\t/**\n\t * Override resubmit core to avoid resubmission on reconnect.  On disconnect we accept our removal from the\n\t * queues, and leave it up to the user to decide whether they want to attempt to re-enter a queue on reconnect.\n\t * @internal\n\t */\n\tprotected reSubmitCore() {}\n\n\t/**\n\t * Process a task manager operation\n\t *\n\t * @param message - the message to prepare\n\t * @param local - whether the message was sent by the local client\n\t * @param localOpMetadata - For local client messages, this is the metadata that was submitted with the message.\n\t * For messages from a remote client, this will be undefined.\n\t * @internal\n\t */\n\tprotected processCore(\n\t\tmessage: ISequencedDocumentMessage,\n\t\tlocal: boolean,\n\t\tlocalOpMetadata: unknown,\n\t) {\n\t\tif (message.type === MessageType.Operation) {\n\t\t\tconst op = message.contents as ITaskManagerOperation;\n\t\t\tconst messageId = localOpMetadata as number;\n\n\t\t\tswitch (op.type) {\n\t\t\t\tcase \"volunteer\":\n\t\t\t\t\tthis.opWatcher.emit(\"volunteer\", op.taskId, message.clientId, local, messageId);\n\t\t\t\t\tbreak;\n\n\t\t\t\tcase \"abandon\":\n\t\t\t\t\tthis.opWatcher.emit(\"abandon\", op.taskId, message.clientId, local, messageId);\n\t\t\t\t\tbreak;\n\n\t\t\t\tcase \"complete\":\n\t\t\t\t\tthis.opWatcher.emit(\"complete\", op.taskId, message.clientId, local, messageId);\n\t\t\t\t\tbreak;\n\n\t\t\t\tdefault:\n\t\t\t\t\tthrow new Error(\"Unknown operation\");\n\t\t\t}\n\t\t}\n\t}\n\n\tprivate addClientToQueue(taskId: string, clientId: string) {\n\t\tconst pendingIds = this.pendingCompletedTasks.get(taskId);\n\t\tif (pendingIds !== undefined && pendingIds.length > 0) {\n\t\t\t// Ignore the volunteer op if we know this task is about to be completed\n\t\t\treturn;\n\t\t}\n\n\t\t// Ensure that the clientId exists in the quorum, or it is placeholderClientId (detached scenario)\n\t\tif (\n\t\t\tthis.runtime.getQuorum().getMembers().has(clientId) ||\n\t\t\tthis.clientId === placeholderClientId\n\t\t) {\n\t\t\t// Create the queue if it doesn't exist, and push the client on the back.\n\t\t\tlet clientQueue = this.taskQueues.get(taskId);\n\t\t\tif (clientQueue === undefined) {\n\t\t\t\tclientQueue = [];\n\t\t\t\tthis.taskQueues.set(taskId, clientQueue);\n\t\t\t}\n\n\t\t\tconst oldLockHolder = clientQueue[0];\n\t\t\tclientQueue.push(clientId);\n\t\t\tconst newLockHolder = clientQueue[0];\n\t\t\tif (newLockHolder !== oldLockHolder) {\n\t\t\t\tthis.queueWatcher.emit(\"queueChange\", taskId, oldLockHolder, newLockHolder);\n\t\t\t}\n\t\t}\n\t}\n\n\tprivate removeClientFromQueue(taskId: string, clientId: string) {\n\t\tconst clientQueue = this.taskQueues.get(taskId);\n\t\tif (clientQueue === undefined) {\n\t\t\treturn;\n\t\t}\n\n\t\tconst oldLockHolder =\n\t\t\tclientId === placeholderClientId ? placeholderClientId : clientQueue[0];\n\t\tconst clientIdIndex = clientQueue.indexOf(clientId);\n\t\tif (clientIdIndex !== -1) {\n\t\t\tclientQueue.splice(clientIdIndex, 1);\n\t\t\t// Clean up the queue if there are no more clients in it.\n\t\t\tif (clientQueue.length === 0) {\n\t\t\t\tthis.taskQueues.delete(taskId);\n\t\t\t}\n\t\t}\n\t\tconst newLockHolder = clientQueue[0];\n\t\tif (newLockHolder !== oldLockHolder) {\n\t\t\tthis.queueWatcher.emit(\"queueChange\", taskId, oldLockHolder, newLockHolder);\n\t\t}\n\t}\n\n\tprivate removeClientFromAllQueues(clientId: string) {\n\t\tfor (const taskId of this.taskQueues.keys()) {\n\t\t\tthis.removeClientFromQueue(taskId, clientId);\n\t\t}\n\t}\n\n\t/**\n\t * Will replace all instances of the placeholderClientId with the current clientId. This should only be called when\n\t * transitioning from detached to attached and this.runtime.clientId is defined.\n\t */\n\tprivate replacePlaceholderInAllQueues() {\n\t\tassert(\n\t\t\tthis.runtime.clientId !== undefined,\n\t\t\t0x475 /* this.runtime.clientId should be defined */,\n\t\t);\n\t\tfor (const clientQueue of this.taskQueues.values()) {\n\t\t\tconst clientIdIndex = clientQueue.indexOf(placeholderClientId);\n\t\t\tif (clientIdIndex !== -1) {\n\t\t\t\tclientQueue[clientIdIndex] = this.runtime.clientId;\n\t\t\t}\n\t\t}\n\t}\n\n\t// This seems like it should be unnecessary if we can trust to receive the join/leave messages and\n\t// also have an accurate snapshot.\n\tprivate scrubClientsNotInQuorum() {\n\t\tconst quorum = this.runtime.getQuorum();\n\t\tfor (const [taskId, clientQueue] of this.taskQueues) {\n\t\t\tconst filteredClientQueue = clientQueue.filter(\n\t\t\t\t(clientId) => quorum.getMember(clientId) !== undefined,\n\t\t\t);\n\t\t\tif (clientQueue.length !== filteredClientQueue.length) {\n\t\t\t\tif (filteredClientQueue.length === 0) {\n\t\t\t\t\tthis.taskQueues.delete(taskId);\n\t\t\t\t} else {\n\t\t\t\t\tthis.taskQueues.set(taskId, filteredClientQueue);\n\t\t\t\t}\n\t\t\t\tthis.queueWatcher.emit(\"queueChange\", taskId);\n\t\t\t}\n\t\t}\n\t}\n\n\tpublic applyStashedOp() {\n\t\tthrow new Error(\"not implemented\");\n\t}\n}\n"]}
+{"version":3,"file":"taskManager.js","sourceRoot":"","sources":["../src/taskManager.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,YAAY,EAAE,MAAM,QAAQ,CAAC;AAEtC,OAAO,EAAE,MAAM,EAAE,MAAM,8BAA8B,CAAC;AACtD,OAAO,EAA6B,WAAW,EAAE,MAAM,sCAAsC,CAAC;AAQ9F,OAAO,EAAE,YAAY,EAAE,MAAM,8BAA8B,CAAC;AAC5D,OAAO,EACN,uBAAuB,EAEvB,YAAY,GACZ,MAAM,oCAAoC,CAAC;AAE5C,OAAO,EAAE,kBAAkB,EAAE,MAAM,sBAAsB,CAAC;AA+B1D,MAAM,gBAAgB,GAAG,QAAQ,CAAC;AAElC;;GAEG;AACH,MAAM,mBAAmB,GAAG,aAAa,CAAC;AAE1C;;;;GAIG;AACH,MAAM,OAAO,WAAY,SAAQ,YAAgC;IAoEhE;;;;;;OAMG;IACH,YAAY,EAAU,EAAE,OAA+B,EAAE,UAA8B;QACtF,KAAK,CAAC,EAAE,EAAE,OAAO,EAAE,UAAU,EAAE,oBAAoB,CAAC,CAAC;QAvDtD;;;WAGG;QACc,eAAU,GAA0B,IAAI,GAAG,EAAE,CAAC;QAE/D,2GAA2G;QAC1F,cAAS,GAAiB,IAAI,YAAY,EAAE,CAAC;QAC9D,sFAAsF;QACrE,iBAAY,GAAiB,IAAI,YAAY,EAAE,CAAC;QACjE,qFAAqF;QACpE,mBAAc,GAAiB,IAAI,YAAY,EAAE,CAAC;QACnE,8EAA8E;QAC7D,sBAAiB,GAAiB,IAAI,YAAY,EAAE,CAAC;QACtE,qFAAqF;QACpE,qBAAgB,GAAiB,IAAI,YAAY,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;QA0BzE,IAAI,CAAC,SAAS,CAAC,EAAE,CAChB,WAAW,EACX,CAAC,MAAc,EAAE,QAAgB,EAAE,KAAc,EAAE,SAAiB,EAAE,EAAE;YACvE,0FAA0F;YAC1F,0GAA0G;YAC1G,IAAI,OAAO,CAAC,SAAS,IAAI,KAAK,EAAE;gBAC/B,MAAM,SAAS,GAAG,IAAI,CAAC,gBAAgB,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;gBACpD,MAAM,CAAC,SAAS,KAAK,SAAS,EAAE,KAAK,CAAC,qBAAqB,CAAC,CAAC;gBAC7D,oGAAoG;gBACpG,IAAI,SAAS,KAAK,SAAS,CAAC,SAAS,EAAE;oBACtC,MAAM,CAAC,SAAS,CAAC,IAAI,KAAK,WAAW,EAAE,KAAK,CAAC,0BAA0B,CAAC,CAAC;oBACzE,kEAAkE;oBAClE,IAAI,CAAC,gBAAgB,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;iBACrC;aACD;YAED,IAAI,CAAC,gBAAgB,CAAC,MAAM,EAAE,QAAQ,CAAC,CAAC;QACzC,CAAC,CACD,CAAC;QAEF,IAAI,CAAC,SAAS,CAAC,EAAE,CAChB,SAAS,EACT,CAAC,MAAc,EAAE,QAAgB,EAAE,KAAc,EAAE,SAAiB,EAAE,EAAE;YACvE,IAAI,OAAO,CAAC,SAAS,IAAI,KAAK,EAAE;gBAC/B,MAAM,SAAS,GAAG,IAAI,CAAC,gBAAgB,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;gBACpD,MAAM,CAAC,SAAS,KAAK,SAAS,EAAE,KAAK,CAAC,qBAAqB,CAAC,CAAC;gBAC7D,oGAAoG;gBACpG,IAAI,SAAS,KAAK,SAAS,CAAC,SAAS,EAAE;oBACtC,MAAM,CAAC,SAAS,CAAC,IAAI,KAAK,SAAS,EAAE,KAAK,CAAC,0BAA0B,CAAC,CAAC;oBACvE,kEAAkE;oBAClE,IAAI,CAAC,gBAAgB,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;iBACrC;aACD;YAED,IAAI,CAAC,qBAAqB,CAAC,MAAM,EAAE,QAAQ,CAAC,CAAC;QAC9C,CAAC,CACD,CAAC;QAEF,IAAI,CAAC,SAAS,CAAC,EAAE,CAChB,UAAU,EACV,CAAC,MAAc,EAAE,QAAgB,EAAE,KAAc,EAAE,SAAiB,EAAE,EAAE;YACvE,IAAI,OAAO,CAAC,SAAS,IAAI,KAAK,EAAE;gBAC/B,MAAM,SAAS,GAAG,IAAI,CAAC,gBAAgB,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;gBACpD,MAAM,CAAC,SAAS,KAAK,SAAS,EAAE,KAAK,CAAC,mBAAmB,CAAC,CAAC;gBAC3D,uFAAuF;gBACvF,IAAI,SAAS,KAAK,SAAS,CAAC,SAAS,EAAE;oBACtC,MAAM,CAAC,SAAS,CAAC,IAAI,KAAK,UAAU,EAAE,KAAK,CAAC,wBAAwB,CAAC,CAAC;oBACtE,kEAAkE;oBAClE,IAAI,CAAC,gBAAgB,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;iBACrC;gBAED,qDAAqD;gBACrD,MAAM,UAAU,GAAG,IAAI,CAAC,qBAAqB,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;gBAC1D,MAAM,CACL,UAAU,KAAK,SAAS,IAAI,UAAU,CAAC,MAAM,GAAG,CAAC,EACjD,KAAK,CAAC,yBAAyB,CAC/B,CAAC;gBACF,MAAM,OAAO,GAAG,UAAU,CAAC,KAAK,EAAE,CAAC;gBACnC,MAAM,CACL,OAAO,KAAK,SAAS,EACrB,KAAK,CAAC,2CAA2C,CACjD,CAAC;aACF;YAED,2FAA2F;YAC3F,IAAI,CAAC,KAAK,EAAE;gBACX,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;aAC/B;QACF,CAAC,CACD,CAAC;QAEF,OAAO,CAAC,SAAS,EAAE,CAAC,EAAE,CAAC,cAAc,EAAE,CAAC,QAAgB,EAAE,EAAE;YAC3D,IAAI,CAAC,yBAAyB,CAAC,QAAQ,CAAC,CAAC;QAC1C,CAAC,CAAC,CAAC;QAEH,IAAI,CAAC,YAAY,CAAC,EAAE,CACnB,aAAa,EACb,CAAC,MAAc,EAAE,aAAqB,EAAE,aAAqB,EAAE,EAAE;YAChE,sGAAsG;YACtG,IAAI,aAAa,KAAK,mBAAmB,EAAE;gBAC1C,IAAI,CAAC,IAAI,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;gBAC1B,OAAO;aACP;YAED,4FAA4F;YAC5F,IAAI,IAAI,CAAC,QAAQ,KAAK,SAAS,EAAE;gBAChC,OAAO;aACP;YAED,IAAI,aAAa,KAAK,IAAI,CAAC,QAAQ,IAAI,aAAa,KAAK,IAAI,CAAC,QAAQ,EAAE;gBACvE,IAAI,CAAC,IAAI,CAAC,UAAU,EAAE,MAAM,CAAC,CAAC;aAC9B;iBAAM,IAAI,aAAa,KAAK,IAAI,CAAC,QAAQ,IAAI,aAAa,KAAK,IAAI,CAAC,QAAQ,EAAE;gBAC9E,IAAI,CAAC,IAAI,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;aAC1B;QACF,CAAC,CACD,CAAC;QAEF,IAAI,CAAC,iBAAiB,CAAC,EAAE,CAAC,YAAY,EAAE,GAAG,EAAE;YAC5C,MAAM,CAAC,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;gBAC9D,IAAI,IAAI,CAAC,UAAU,EAAE,IAAI,WAAW,CAAC,CAAC,CAAC,KAAK,IAAI,CAAC,QAAQ,EAAE;oBAC1D,IAAI,CAAC,IAAI,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;iBAC1B;aACD;YAED,iFAAiF;YACjF,IAAI,CAAC,gBAAgB,CAAC,KAAK,EAAE,CAAC;QAC/B,CAAC,CAAC,CAAC;IACJ,CAAC;IAhMD;;;;;;OAMG;IACI,MAAM,CAAC,MAAM,CAAC,OAA+B,EAAE,EAAW;QAChE,OAAO,OAAO,CAAC,aAAa,CAAC,EAAE,EAAE,kBAAkB,CAAC,IAAI,CAAgB,CAAC;IAC1E,CAAC;IAED;;;;OAIG;IACI,MAAM,CAAC,UAAU;QACvB,OAAO,IAAI,kBAAkB,EAAE,CAAC;IACjC,CAAC;IAmCD;;OAEG;IACH,IAAY,QAAQ;QACnB,OAAO,IAAI,CAAC,UAAU,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC,CAAC,mBAAmB,CAAC;IACxE,CAAC;IAED;;OAEG;IACH,IAAY,YAAY;QACvB,OAAO,IAAI,CAAC,OAAO,CAAC,YAAY,CAAC,YAAY,CAAC;IAC/C,CAAC;IAiIO,iBAAiB,CAAC,MAAc;QACvC,MAAM,EAAE,GAAmC;YAC1C,IAAI,EAAE,WAAW;YACjB,MAAM;SACN,CAAC;QACF,MAAM,SAAS,GAAe;YAC7B,IAAI,EAAE,WAAW;YACjB,SAAS,EAAE,EAAE,IAAI,CAAC,SAAS;SAC3B,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;IAC9C,CAAC;IAEO,eAAe,CAAC,MAAc;QACrC,MAAM,EAAE,GAAiC;YACxC,IAAI,EAAE,SAAS;YACf,MAAM;SACN,CAAC;QACF,MAAM,SAAS,GAAe;YAC7B,IAAI,EAAE,SAAS;YACf,SAAS,EAAE,EAAE,IAAI,CAAC,SAAS;SAC3B,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;IAC9C,CAAC;IAEO,gBAAgB,CAAC,MAAc;;QACtC,MAAM,EAAE,GAAmC;YAC1C,IAAI,EAAE,UAAU;YAChB,MAAM;SACN,CAAC;QACF,MAAM,SAAS,GAAe;YAC7B,IAAI,EAAE,UAAU;YAChB,SAAS,EAAE,EAAE,IAAI,CAAC,SAAS;SAC3B,CAAC;QAEF,IAAI,IAAI,CAAC,qBAAqB,CAAC,GAAG,CAAC,MAAM,CAAC,EAAE;YAC3C,MAAA,IAAI,CAAC,qBAAqB,CAAC,GAAG,CAAC,MAAM,CAAC,0CAAE,IAAI,CAAC,SAAS,CAAC,SAAS,CAAC,CAAC;SAClE;aAAM;YACN,IAAI,CAAC,qBAAqB,CAAC,GAAG,CAAC,MAAM,EAAE,CAAC,SAAS,CAAC,SAAS,CAAC,CAAC,CAAC;SAC9D;QAED,IAAI,CAAC,kBAAkB,CAAC,EAAE,EAAE,SAAS,CAAC,SAAS,CAAC,CAAC;QACjD,IAAI,CAAC,gBAAgB,CAAC,GAAG,CAAC,MAAM,EAAE,SAAS,CAAC,CAAC;IAC9C,CAAC;IAED;;OAEG;IACI,KAAK,CAAC,gBAAgB,CAAC,MAAc;QAC3C,2CAA2C;QAC3C,IAAI,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC,EAAE;YAC1B,OAAO,IAAI,CAAC;SACZ;QAED,IAAI,IAAI,CAAC,YAAY,CAAC,QAAQ,KAAK,IAAI,EAAE;YACxC,MAAM,KAAK,GACV,IAAI,CAAC,YAAY,CAAC,WAAW,KAAK,IAAI;gBACrC,CAAC,CAAC,IAAI,KAAK,CAAC,mDAAmD,CAAC;gBAChE,CAAC,CAAC,IAAI,KAAK,CAAC,2CAA2C,CAAC,CAAC;YAC3D,MAAM,KAAK,CAAC;SACZ;QAED,IAAI,CAAC,IAAI,CAAC,UAAU,EAAE,EAAE;YACvB,yCAAyC;YACzC,MAAM,CAAC,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;SACZ;QAED,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE;YACpB,MAAM,IAAI,KAAK,CAAC,8CAA8C,CAAC,CAAC;SAChE;QAED,0EAA0E;QAC1E,MAAM,YAAY,GAAG,IAAI,OAAO,CAAU,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE;YAC7D,MAAM,mBAAmB,GAAG,CAAC,WAAmB,EAAE,EAAE;gBACnD,IAAI,WAAW,KAAK,MAAM,EAAE;oBAC3B,OAAO;iBACP;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;oBAChE,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;iBACd;YACF,CAAC,CAAC;YAEF,MAAM,gBAAgB,GAAG,CAAC,WAAmB,EAAE,EAAE;gBAChD,IAAI,WAAW,KAAK,MAAM,EAAE;oBAC3B,OAAO;iBACP;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,4CAA4C,CAAC,CAAC,CAAC;YACjE,CAAC,CAAC;YAEF,MAAM,kBAAkB,GAAG,GAAG,EAAE;gBAC/B,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,CAAC,CAAC,CAAC;YACpE,CAAC,CAAC;YAEF,MAAM,gBAAgB,GAAG,CAAC,WAAmB,EAAE,EAAE;gBAChD,IAAI,WAAW,KAAK,MAAM,EAAE;oBAC3B,OAAO;iBACP;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;YAChB,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;QACzD,CAAC,CAAC,CAAC;QAEH,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,EAAE;YACzB,IAAI,CAAC,iBAAiB,CAAC,MAAM,CAAC,CAAC;SAC/B;QACD,OAAO,YAAY,CAAC;IACrB,CAAC;IAED;;OAEG;IACI,eAAe,CAAC,MAAc;QACpC,IAAI,IAAI,CAAC,UAAU,CAAC,MAAM,CAAC,EAAE;YAC5B,OAAO;SACP;QAED,IAAI,IAAI,CAAC,YAAY,CAAC,QAAQ,KAAK,IAAI,IAAI,IAAI,CAAC,YAAY,CAAC,WAAW,KAAK,IAAI,EAAE;YAClF,MAAM,IAAI,KAAK,CAAC,mDAAmD,CAAC,CAAC;SACrE;QAED,MAAM,iBAAiB,GAAG,GAAG,EAAE;YAC9B,IAAI,CAAC,iBAAiB,CAAC,MAAM,CAAC,CAAC;QAChC,CAAC,CAAC;QAEF,MAAM,iBAAiB,GAAG,GAAG,EAAE;YAC9B,6DAA6D;YAC7D,IAAI,CAAC,iBAAiB,CAAC,IAAI,CAAC,SAAS,EAAE,iBAAiB,CAAC,CAAC;QAC3D,CAAC,CAAC;QAEF,MAAM,gBAAgB,GAAG,CAAC,WAAmB,EAAE,EAAE;YAChD,IAAI,WAAW,KAAK,MAAM,EAAE;gBAC3B,OAAO;aACP;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;QACrC,CAAC,CAAC;QAEF,MAAM,gBAAgB,GAAG,CAAC,WAAmB,EAAE,EAAE;YAChD,IAAI,WAAW,KAAK,MAAM,EAAE;gBAC3B,OAAO;aACP;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;QACrC,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;YACvB,yCAAyC;YACzC,MAAM,CAAC,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;gBAClC,IAAI,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,EAAE;oBACxB,+FAA+F;oBAC/F,sCAAsC;oBACtC,OAAO;iBACP;qBAAM,IAAI,IAAI,CAAC,SAAS,EAAE;oBAC1B,iBAAiB,EAAE,CAAC;iBACpB;qBAAM;oBACN,IAAI,CAAC,iBAAiB,CAAC,IAAI,CAAC,SAAS,EAAE,GAAG,EAAE;wBAC3C,iBAAiB,EAAE,CAAC;oBACrB,CAAC,CAAC,CAAC;iBACH;YACF,CAAC,CAAC,CAAC;SACH;aAAM,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE;YAC3B,sFAAsF;YACtF,iBAAiB,EAAE,CAAC;SACpB;aAAM,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,EAAE;YAC1D,iBAAiB,EAAE,CAAC;SACpB;QACD,IAAI,CAAC,eAAe,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;IAClC,CAAC;IAED;;OAEG;IACI,OAAO,CAAC,MAAc;QAC5B,uGAAuG;QACvG,6GAA6G;QAC7G,cAAc;QACd,IAAI,CAAC,IAAI,CAAC,UAAU,CAAC,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,EAAE;YACrD,gBAAgB;YAChB,OAAO;SACP;QAED,IAAI,CAAC,IAAI,CAAC,UAAU,EAAE,EAAE;YACvB,yCAAyC;YACzC,MAAM,CAAC,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;SACP;QAED,+FAA+F;QAC/F,IAAI,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,EAAE;YACxB,IAAI,CAAC,eAAe,CAAC,MAAM,CAAC,CAAC;SAC7B;QACD,IAAI,CAAC,cAAc,CAAC,IAAI,CAAC,SAAS,EAAE,MAAM,CAAC,CAAC;IAC7C,CAAC;IAED;;OAEG;IACI,QAAQ,CAAC,MAAc;;QAC7B,IAAI,IAAI,CAAC,UAAU,EAAE,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE;YACzC,OAAO,KAAK,CAAC;SACb;QAED,MAAM,eAAe,GAAG,MAAA,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,MAAM,CAAC,0CAAG,CAAC,CAAC,CAAC;QACzD,OAAO,CACN,eAAe,KAAK,SAAS;YAC7B,eAAe,KAAK,IAAI,CAAC,QAAQ;YACjC,CAAC,IAAI,CAAC,gBAAgB,CAAC,GAAG,CAAC,MAAM,CAAC,CAClC,CAAC;IACH,CAAC;IAED;;OAEG;IACI,MAAM,CAAC,MAAc;;QAC3B,IAAI,IAAI,CAAC,UAAU,EAAE,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE;YACzC,OAAO,KAAK,CAAC;SACb;QAED,MAAM,CAAC,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,CACN,CAAC,CAAC,MAAA,WAAW,aAAX,WAAW,uBAAX,WAAW,CAAE,QAAQ,CAAC,IAAI,CAAC,QAAQ,CAAC,mCAAI,KAAK,CAAC;YAC/C,CAAC,IAAI,CAAC,gBAAgB,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;YACpC,CAAA,MAAA,IAAI,CAAC,gBAAgB,CAAC,GAAG,CAAC,MAAM,CAAC,0CAAE,IAAI,MAAK,WAAW,CACvD,CAAC;IACH,CAAC;IAED;;OAEG;IACI,UAAU,CAAC,MAAc;QAC/B,OAAO,IAAI,CAAC,eAAe,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;IACzC,CAAC;IAED;;OAEG;IACI,QAAQ,CAAC,MAAc;QAC7B,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC,EAAE;YAC3B,MAAM,IAAI,KAAK,CAAC,6DAA6D,CAAC,CAAC;SAC/E;QAED,6GAA6G;QAC7G,4FAA4F;QAC5F,IAAI,IAAI,CAAC,UAAU,EAAE,EAAE;YACtB,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE;gBACpB,MAAM,IAAI,KAAK,CAAC,kDAAkD,CAAC,CAAC;aACpE;YACD,IAAI,CAAC,gBAAgB,CAAC,MAAM,CAAC,CAAC;SAC9B;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;IAChC,CAAC;IAED;;OAEG;IACI,YAAY;QAClB,kGAAkG;QAClG,+GAA+G;QAC/G,8GAA8G;QAC9G,2BAA2B;QAC3B,OAAO,IAAI,CAAC,SAAS,CAAC;IACvB,CAAC;IAED;;;;;OAKG;IACO,aAAa,CAAC,UAA4B;QACnD,IAAI,IAAI,CAAC,OAAO,CAAC,QAAQ,KAAK,SAAS,EAAE;YACxC,uGAAuG;YACvG,oCAAoC;YACpC,IAAI,CAAC,6BAA6B,EAAE,CAAC;SACrC;aAAM;YACN,sGAAsG;YACtG,yGAAyG;YACzG,kBAAkB;YAClB,IAAI,CAAC,yBAAyB,CAAC,mBAAmB,CAAC,CAAC;SACpD;QAED,wDAAwD;QACxD,MAAM,WAAW,GAAG,IAAI,GAAG,EAAoB,CAAC;QAChD,IAAI,CAAC,UAAU,CAAC,OAAO,CAAC,CAAC,KAAe,EAAE,MAAc,EAAE,EAAE;YAC3D,IAAI,KAAK,CAAC,MAAM,GAAG,CAAC,EAAE;gBACrB,WAAW,CAAC,GAAG,CAAC,MAAM,EAAE,KAAK,CAAC,CAAC;aAC/B;QACF,CAAC,CAAC,CAAC;QACH,MAAM,OAAO,GAAG,CAAC,GAAG,WAAW,CAAC,OAAO,EAAE,CAAC,CAAC;QAC3C,OAAO,uBAAuB,CAAC,gBAAgB,EAAE,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC,CAAC,CAAC;IAC3E,CAAC;IAED;;;OAGG;IACO,KAAK,CAAC,QAAQ,CAAC,OAA+B;QACvD,MAAM,OAAO,GAAG,MAAM,YAAY,CAAuB,OAAO,EAAE,gBAAgB,CAAC,CAAC;QACpF,OAAO,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,EAAE,aAAa,CAAC,EAAE,EAAE;YAC3C,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,MAAM,EAAE,aAAa,CAAC,CAAC;QAC5C,CAAC,CAAC,CAAC;QACH,IAAI,CAAC,uBAAuB,EAAE,CAAC;IAChC,CAAC;IAED;;OAEG;IACO,mBAAmB,KAAI,CAAC;IAElC;;;OAGG;IACO,YAAY;QACrB,IAAI,CAAC,iBAAiB,CAAC,IAAI,CAAC,YAAY,CAAC,CAAC;IAC3C,CAAC;IAED;;;OAGG;IACO,SAAS;QAClB,IAAI,CAAC,iBAAiB,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;IACxC,CAAC;IAED,EAAE;IACF;;;;OAIG;IACO,YAAY,KAAI,CAAC;IAE3B;;;;;;;;OAQG;IACO,WAAW,CACpB,OAAkC,EAClC,KAAc,EACd,eAAwB;QAExB,IAAI,OAAO,CAAC,IAAI,KAAK,WAAW,CAAC,SAAS,EAAE;YAC3C,MAAM,EAAE,GAAG,OAAO,CAAC,QAAiC,CAAC;YACrD,MAAM,SAAS,GAAG,eAAyB,CAAC;YAE5C,QAAQ,EAAE,CAAC,IAAI,EAAE;gBAChB,KAAK,WAAW;oBACf,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,WAAW,EAAE,EAAE,CAAC,MAAM,EAAE,OAAO,CAAC,QAAQ,EAAE,KAAK,EAAE,SAAS,CAAC,CAAC;oBAChF,MAAM;gBAEP,KAAK,SAAS;oBACb,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,SAAS,EAAE,EAAE,CAAC,MAAM,EAAE,OAAO,CAAC,QAAQ,EAAE,KAAK,EAAE,SAAS,CAAC,CAAC;oBAC9E,MAAM;gBAEP,KAAK,UAAU;oBACd,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,UAAU,EAAE,EAAE,CAAC,MAAM,EAAE,OAAO,CAAC,QAAQ,EAAE,KAAK,EAAE,SAAS,CAAC,CAAC;oBAC/E,MAAM;gBAEP;oBACC,MAAM,IAAI,KAAK,CAAC,mBAAmB,CAAC,CAAC;aACtC;SACD;IACF,CAAC;IAEO,gBAAgB,CAAC,MAAc,EAAE,QAAgB;QACxD,MAAM,UAAU,GAAG,IAAI,CAAC,qBAAqB,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;QAC1D,IAAI,UAAU,KAAK,SAAS,IAAI,UAAU,CAAC,MAAM,GAAG,CAAC,EAAE;YACtD,wEAAwE;YACxE,OAAO;SACP;QAED,kGAAkG;QAClG,IACC,IAAI,CAAC,OAAO,CAAC,SAAS,EAAE,CAAC,UAAU,EAAE,CAAC,GAAG,CAAC,QAAQ,CAAC;YACnD,IAAI,CAAC,QAAQ,KAAK,mBAAmB,EACpC;YACD,yEAAyE;YACzE,IAAI,WAAW,GAAG,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;YAC9C,IAAI,WAAW,KAAK,SAAS,EAAE;gBAC9B,WAAW,GAAG,EAAE,CAAC;gBACjB,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,MAAM,EAAE,WAAW,CAAC,CAAC;aACzC;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;gBACpC,IAAI,CAAC,YAAY,CAAC,IAAI,CAAC,aAAa,EAAE,MAAM,EAAE,aAAa,EAAE,aAAa,CAAC,CAAC;aAC5E;SACD;IACF,CAAC;IAEO,qBAAqB,CAAC,MAAc,EAAE,QAAgB;QAC7D,MAAM,WAAW,GAAG,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;QAChD,IAAI,WAAW,KAAK,SAAS,EAAE;YAC9B,OAAO;SACP;QAED,MAAM,aAAa,GAClB,QAAQ,KAAK,mBAAmB,CAAC,CAAC,CAAC,mBAAmB,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC;QACzE,MAAM,aAAa,GAAG,WAAW,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC;QACpD,IAAI,aAAa,KAAK,CAAC,CAAC,EAAE;YACzB,WAAW,CAAC,MAAM,CAAC,aAAa,EAAE,CAAC,CAAC,CAAC;YACrC,yDAAyD;YACzD,IAAI,WAAW,CAAC,MAAM,KAAK,CAAC,EAAE;gBAC7B,IAAI,CAAC,UAAU,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;aAC/B;SACD;QACD,MAAM,aAAa,GAAG,WAAW,CAAC,CAAC,CAAC,CAAC;QACrC,IAAI,aAAa,KAAK,aAAa,EAAE;YACpC,IAAI,CAAC,YAAY,CAAC,IAAI,CAAC,aAAa,EAAE,MAAM,EAAE,aAAa,EAAE,aAAa,CAAC,CAAC;SAC5E;IACF,CAAC;IAEO,yBAAyB,CAAC,QAAgB;QACjD,KAAK,MAAM,MAAM,IAAI,IAAI,CAAC,UAAU,CAAC,IAAI,EAAE,EAAE;YAC5C,IAAI,CAAC,qBAAqB,CAAC,MAAM,EAAE,QAAQ,CAAC,CAAC;SAC7C;IACF,CAAC;IAED;;;OAGG;IACK,6BAA6B;QACpC,MAAM,CACL,IAAI,CAAC,OAAO,CAAC,QAAQ,KAAK,SAAS,EACnC,KAAK,CAAC,6CAA6C,CACnD,CAAC;QACF,KAAK,MAAM,WAAW,IAAI,IAAI,CAAC,UAAU,CAAC,MAAM,EAAE,EAAE;YACnD,MAAM,aAAa,GAAG,WAAW,CAAC,OAAO,CAAC,mBAAmB,CAAC,CAAC;YAC/D,IAAI,aAAa,KAAK,CAAC,CAAC,EAAE;gBACzB,WAAW,CAAC,aAAa,CAAC,GAAG,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC;aACnD;SACD;IACF,CAAC;IAED,kGAAkG;IAClG,kCAAkC;IAC1B,uBAAuB;QAC9B,MAAM,MAAM,GAAG,IAAI,CAAC,OAAO,CAAC,SAAS,EAAE,CAAC;QACxC,KAAK,MAAM,CAAC,MAAM,EAAE,WAAW,CAAC,IAAI,IAAI,CAAC,UAAU,EAAE;YACpD,MAAM,mBAAmB,GAAG,WAAW,CAAC,MAAM,CAC7C,CAAC,QAAQ,EAAE,EAAE,CAAC,MAAM,CAAC,SAAS,CAAC,QAAQ,CAAC,KAAK,SAAS,CACtD,CAAC;YACF,IAAI,WAAW,CAAC,MAAM,KAAK,mBAAmB,CAAC,MAAM,EAAE;gBACtD,IAAI,mBAAmB,CAAC,MAAM,KAAK,CAAC,EAAE;oBACrC,IAAI,CAAC,UAAU,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;iBAC/B;qBAAM;oBACN,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,MAAM,EAAE,mBAAmB,CAAC,CAAC;iBACjD;gBACD,IAAI,CAAC,YAAY,CAAC,IAAI,CAAC,aAAa,EAAE,MAAM,CAAC,CAAC;aAC9C;SACD;IACF,CAAC;IAEM,cAAc;QACpB,gBAAgB;IACjB,CAAC;CACD","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\tIChannelAttributes,\n\tIFluidDataStoreRuntime,\n\tIChannelStorageService,\n\tIChannelFactory,\n} from \"@fluidframework/datastore-definitions\";\nimport { ISummaryTreeWithStats } from \"@fluidframework/runtime-definitions\";\nimport { readAndParse } from \"@fluidframework/driver-utils\";\nimport {\n\tcreateSingleBlobSummary,\n\tIFluidSerializer,\n\tSharedObject,\n} 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\t| ITaskManagerVolunteerOperation\n\t| ITaskManagerAbandonOperation\n\t| ITaskManagerCompletedOperation;\n\ninterface ITaskManagerVolunteerOperation {\n\ttype: \"volunteer\";\n\ttaskId: string;\n}\n\ninterface ITaskManagerAbandonOperation {\n\ttype: \"abandon\";\n\ttaskId: string;\n}\n\ninterface ITaskManagerCompletedOperation {\n\ttype: \"complete\";\n\ttaskId: string;\n}\n\ninterface IPendingOp {\n\ttype: \"volunteer\" | \"abandon\" | \"complete\";\n\tmessageId: number;\n}\n\nconst snapshotFileName = \"header\";\n\n/**\n * Placeholder clientId for detached scenarios.\n */\nconst placeholderClientId = \"placeholder\";\n\n/**\n * {@inheritDoc ITaskManager}\n *\n * @sealed\n */\nexport class TaskManager extends SharedObject<ITaskManagerEvents> implements ITaskManager {\n\t/**\n\t * Create a new TaskManager\n\t *\n\t * @param runtime - data store runtime the new task queue belongs to\n\t * @param id - optional name of the task queue\n\t * @returns newly create task queue (but not attached yet)\n\t */\n\tpublic static create(runtime: IFluidDataStoreRuntime, id?: string) {\n\t\treturn runtime.createChannel(id, TaskManagerFactory.Type) as TaskManager;\n\t}\n\n\t/**\n\t * Get a factory for TaskManager to register with the data store.\n\t *\n\t * @returns a factory that creates and load TaskManager\n\t */\n\tpublic static getFactory(): IChannelFactory {\n\t\treturn new TaskManagerFactory();\n\t}\n\n\t/**\n\t * Mapping of taskId to a queue of clientIds that are waiting on the task.  Maintains the consensus state of the\n\t * queue, even if we know we've submitted an op that should eventually modify the queue.\n\t */\n\tprivate readonly taskQueues: Map<string, string[]> = new Map();\n\n\t// opWatcher emits for every op on this data store.  This is just a repackaging of processCore into events.\n\tprivate readonly opWatcher: EventEmitter = new EventEmitter();\n\t// queueWatcher emits an event whenever the consensus state of the task queues changes\n\tprivate readonly queueWatcher: EventEmitter = new EventEmitter();\n\t// abandonWatcher emits an event whenever the local client calls abandon() on a task.\n\tprivate readonly abandonWatcher: EventEmitter = new EventEmitter();\n\t// connectionWatcher emits an event whenever we get connected or disconnected.\n\tprivate readonly connectionWatcher: EventEmitter = new EventEmitter();\n\t// completedWatcher emits an event whenever the local client receives a completed op.\n\tprivate readonly completedWatcher: EventEmitter = new EventEmitter();\n\n\tprivate messageId: number = -1;\n\t/**\n\t * Tracks the most recent pending op for a given task\n\t */\n\tprivate readonly latestPendingOps: Map<string, IPendingOp> = new Map();\n\n\t/**\n\t * Tracks tasks that are this client is currently subscribed to.\n\t */\n\tprivate readonly subscribedTasks: Set<string> = new Set();\n\n\t/**\n\t * Map to track tasks that have pending complete ops.\n\t */\n\tprivate readonly pendingCompletedTasks: Map<string, number[]> = new Map();\n\n\t/**\n\t * Returns the clientId. Will return a placeholder if the runtime is detached and not yet assigned a clientId.\n\t */\n\tprivate get clientId(): string | undefined {\n\t\treturn this.isAttached() ? this.runtime.clientId : placeholderClientId;\n\t}\n\n\t/**\n\t * Returns a ReadOnlyInfo object to determine current read/write permissions.\n\t */\n\tprivate get readOnlyInfo(): ReadOnlyInfo {\n\t\treturn this.runtime.deltaManager.readOnlyInfo;\n\t}\n\n\t/**\n\t * Constructs a new task manager. If the object is non-local an id and service interfaces will\n\t * be provided\n\t *\n\t * @param runtime - data store runtime the task queue belongs to\n\t * @param id - optional name of the task queue\n\t */\n\tconstructor(id: string, runtime: IFluidDataStoreRuntime, attributes: IChannelAttributes) {\n\t\tsuper(id, runtime, attributes, \"fluid_taskManager_\");\n\n\t\tthis.opWatcher.on(\n\t\t\t\"volunteer\",\n\t\t\t(taskId: string, clientId: string, local: boolean, messageId: number) => {\n\t\t\t\t// We're tracking local ops from this connection. Filter out local ops during \"connecting\"\n\t\t\t\t// state since these were sent on the prior connection and were already cleared from the latestPendingOps.\n\t\t\t\tif (runtime.connected && local) {\n\t\t\t\t\tconst pendingOp = this.latestPendingOps.get(taskId);\n\t\t\t\t\tassert(pendingOp !== undefined, 0x07b /* \"Unexpected op\" */);\n\t\t\t\t\t// Need to check the id, since it's possible to volunteer and abandon multiple times before the acks\n\t\t\t\t\tif (messageId === pendingOp.messageId) {\n\t\t\t\t\t\tassert(pendingOp.type === \"volunteer\", 0x07c /* \"Unexpected op type\" */);\n\t\t\t\t\t\t// Delete the pending, because we no longer have an outstanding op\n\t\t\t\t\t\tthis.latestPendingOps.delete(taskId);\n\t\t\t\t\t}\n\t\t\t\t}\n\n\t\t\t\tthis.addClientToQueue(taskId, clientId);\n\t\t\t},\n\t\t);\n\n\t\tthis.opWatcher.on(\n\t\t\t\"abandon\",\n\t\t\t(taskId: string, clientId: string, local: boolean, messageId: number) => {\n\t\t\t\tif (runtime.connected && local) {\n\t\t\t\t\tconst pendingOp = this.latestPendingOps.get(taskId);\n\t\t\t\t\tassert(pendingOp !== undefined, 0x07d /* \"Unexpected op\" */);\n\t\t\t\t\t// Need to check the id, since it's possible to abandon and volunteer multiple times before the acks\n\t\t\t\t\tif (messageId === pendingOp.messageId) {\n\t\t\t\t\t\tassert(pendingOp.type === \"abandon\", 0x07e /* \"Unexpected op type\" */);\n\t\t\t\t\t\t// Delete the pending, because we no longer have an outstanding op\n\t\t\t\t\t\tthis.latestPendingOps.delete(taskId);\n\t\t\t\t\t}\n\t\t\t\t}\n\n\t\t\t\tthis.removeClientFromQueue(taskId, clientId);\n\t\t\t},\n\t\t);\n\n\t\tthis.opWatcher.on(\n\t\t\t\"complete\",\n\t\t\t(taskId: string, clientId: string, local: boolean, messageId: number) => {\n\t\t\t\tif (runtime.connected && local) {\n\t\t\t\t\tconst pendingOp = this.latestPendingOps.get(taskId);\n\t\t\t\t\tassert(pendingOp !== undefined, 0x400 /* Unexpected op */);\n\t\t\t\t\t// Need to check the id, since it's possible to complete multiple times before the acks\n\t\t\t\t\tif (messageId === pendingOp.messageId) {\n\t\t\t\t\t\tassert(pendingOp.type === \"complete\", 0x401 /* Unexpected op type */);\n\t\t\t\t\t\t// Delete the pending, because we no longer have an outstanding op\n\t\t\t\t\t\tthis.latestPendingOps.delete(taskId);\n\t\t\t\t\t}\n\n\t\t\t\t\t// Remove complete op from this.pendingCompletedTasks\n\t\t\t\t\tconst pendingIds = this.pendingCompletedTasks.get(taskId);\n\t\t\t\t\tassert(\n\t\t\t\t\t\tpendingIds !== undefined && pendingIds.length > 0,\n\t\t\t\t\t\t0x402 /* pendingIds is empty */,\n\t\t\t\t\t);\n\t\t\t\t\tconst removed = pendingIds.shift();\n\t\t\t\t\tassert(\n\t\t\t\t\t\tremoved === messageId,\n\t\t\t\t\t\t0x403 /* Removed complete op id does not match */,\n\t\t\t\t\t);\n\t\t\t\t}\n\n\t\t\t\t// For clients in queue, we need to remove them from the queue and raise the proper events.\n\t\t\t\tif (!local) {\n\t\t\t\t\tthis.taskQueues.delete(taskId);\n\t\t\t\t\tthis.completedWatcher.emit(\"completed\", taskId);\n\t\t\t\t\tthis.emit(\"completed\", taskId);\n\t\t\t\t}\n\t\t\t},\n\t\t);\n\n\t\truntime.getQuorum().on(\"removeMember\", (clientId: string) => {\n\t\t\tthis.removeClientFromAllQueues(clientId);\n\t\t});\n\n\t\tthis.queueWatcher.on(\n\t\t\t\"queueChange\",\n\t\t\t(taskId: string, oldLockHolder: string, newLockHolder: string) => {\n\t\t\t\t// If oldLockHolder is placeholderClientId we need to emit the task was lost during the attach process\n\t\t\t\tif (oldLockHolder === placeholderClientId) {\n\t\t\t\t\tthis.emit(\"lost\", taskId);\n\t\t\t\t\treturn;\n\t\t\t\t}\n\n\t\t\t\t// Exit early if we are still catching up on reconnect -- we can't be the leader yet anyway.\n\t\t\t\tif (this.clientId === undefined) {\n\t\t\t\t\treturn;\n\t\t\t\t}\n\n\t\t\t\tif (oldLockHolder !== this.clientId && newLockHolder === this.clientId) {\n\t\t\t\t\tthis.emit(\"assigned\", taskId);\n\t\t\t\t} else if (oldLockHolder === this.clientId && newLockHolder !== this.clientId) {\n\t\t\t\t\tthis.emit(\"lost\", taskId);\n\t\t\t\t}\n\t\t\t},\n\t\t);\n\n\t\tthis.connectionWatcher.on(\"disconnect\", () => {\n\t\t\tassert(this.clientId !== undefined, 0x1d3 /* \"Missing client id on disconnect\" */);\n\n\t\t\t// We don't modify the taskQueues on disconnect (they still reflect the latest known consensus state).\n\t\t\t// After reconnect these will get cleaned up by observing the clientLeaves.\n\t\t\t// However we do need to recognize that we lost the lock if we had it.  Calls to .queued() and\n\t\t\t// .assigned() are also connection-state-aware to be consistent.\n\t\t\tfor (const [taskId, clientQueue] of this.taskQueues.entries()) {\n\t\t\t\tif (this.isAttached() && clientQueue[0] === this.clientId) {\n\t\t\t\t\tthis.emit(\"lost\", taskId);\n\t\t\t\t}\n\t\t\t}\n\n\t\t\t// All of our outstanding ops will be for the old clientId even if they get ack'd\n\t\t\tthis.latestPendingOps.clear();\n\t\t});\n\t}\n\n\tprivate submitVolunteerOp(taskId: string) {\n\t\tconst op: ITaskManagerVolunteerOperation = {\n\t\t\ttype: \"volunteer\",\n\t\t\ttaskId,\n\t\t};\n\t\tconst pendingOp: IPendingOp = {\n\t\t\ttype: \"volunteer\",\n\t\t\tmessageId: ++this.messageId,\n\t\t};\n\t\tthis.submitLocalMessage(op, pendingOp.messageId);\n\t\tthis.latestPendingOps.set(taskId, pendingOp);\n\t}\n\n\tprivate submitAbandonOp(taskId: string) {\n\t\tconst op: ITaskManagerAbandonOperation = {\n\t\t\ttype: \"abandon\",\n\t\t\ttaskId,\n\t\t};\n\t\tconst pendingOp: IPendingOp = {\n\t\t\ttype: \"abandon\",\n\t\t\tmessageId: ++this.messageId,\n\t\t};\n\t\tthis.submitLocalMessage(op, pendingOp.messageId);\n\t\tthis.latestPendingOps.set(taskId, pendingOp);\n\t}\n\n\tprivate submitCompleteOp(taskId: string) {\n\t\tconst op: ITaskManagerCompletedOperation = {\n\t\t\ttype: \"complete\",\n\t\t\ttaskId,\n\t\t};\n\t\tconst pendingOp: IPendingOp = {\n\t\t\ttype: \"complete\",\n\t\t\tmessageId: ++this.messageId,\n\t\t};\n\n\t\tif (this.pendingCompletedTasks.has(taskId)) {\n\t\t\tthis.pendingCompletedTasks.get(taskId)?.push(pendingOp.messageId);\n\t\t} else {\n\t\t\tthis.pendingCompletedTasks.set(taskId, [pendingOp.messageId]);\n\t\t}\n\n\t\tthis.submitLocalMessage(op, pendingOp.messageId);\n\t\tthis.latestPendingOps.set(taskId, pendingOp);\n\t}\n\n\t/**\n\t * {@inheritDoc ITaskManager.volunteerForTask}\n\t */\n\tpublic async volunteerForTask(taskId: string) {\n\t\t// If we have the lock, resolve immediately\n\t\tif (this.assigned(taskId)) {\n\t\t\treturn true;\n\t\t}\n\n\t\tif (this.readOnlyInfo.readonly === true) {\n\t\t\tconst error =\n\t\t\t\tthis.readOnlyInfo.permissions === true\n\t\t\t\t\t? new Error(\"Attempted to volunteer with read-only permissions\")\n\t\t\t\t\t: new Error(\"Attempted to volunteer in read-only state\");\n\t\t\tthrow error;\n\t\t}\n\n\t\tif (!this.isAttached()) {\n\t\t\t// Simulate auto-ack in detached scenario\n\t\t\tassert(this.clientId !== undefined, 0x472 /* clientId should not be undefined */);\n\t\t\tthis.addClientToQueue(taskId, this.clientId);\n\t\t\treturn true;\n\t\t}\n\n\t\tif (!this.connected) {\n\t\t\tthrow new Error(\"Attempted to volunteer in disconnected state\");\n\t\t}\n\n\t\t// This promise works even if we already have an outstanding volunteer op.\n\t\tconst lockAcquireP = new Promise<boolean>((resolve, reject) => {\n\t\t\tconst checkIfAcquiredLock = (eventTaskId: string) => {\n\t\t\t\tif (eventTaskId !== taskId) {\n\t\t\t\t\treturn;\n\t\t\t\t}\n\n\t\t\t\t// Also check pending ops here because it's possible we are currently in the queue from a previous\n\t\t\t\t// lock attempt, but have an outstanding abandon AND the outstanding volunteer for this lock attempt.\n\t\t\t\t// If we reach the head of the queue based on the previous lock attempt, we don't want to resolve.\n\t\t\t\tif (this.assigned(taskId) && !this.latestPendingOps.has(taskId)) {\n\t\t\t\t\tthis.queueWatcher.off(\"queueChange\", checkIfAcquiredLock);\n\t\t\t\t\tthis.abandonWatcher.off(\"abandon\", checkIfAbandoned);\n\t\t\t\t\tthis.connectionWatcher.off(\"disconnect\", rejectOnDisconnect);\n\t\t\t\t\tthis.completedWatcher.off(\"completed\", checkIfCompleted);\n\t\t\t\t\tresolve(true);\n\t\t\t\t}\n\t\t\t};\n\n\t\t\tconst checkIfAbandoned = (eventTaskId: string) => {\n\t\t\t\tif (eventTaskId !== taskId) {\n\t\t\t\t\treturn;\n\t\t\t\t}\n\n\t\t\t\tthis.queueWatcher.off(\"queueChange\", checkIfAcquiredLock);\n\t\t\t\tthis.abandonWatcher.off(\"abandon\", checkIfAbandoned);\n\t\t\t\tthis.connectionWatcher.off(\"disconnect\", rejectOnDisconnect);\n\t\t\t\tthis.completedWatcher.off(\"completed\", checkIfCompleted);\n\t\t\t\treject(new Error(\"Abandoned before acquiring task assignment\"));\n\t\t\t};\n\n\t\t\tconst rejectOnDisconnect = () => {\n\t\t\t\tthis.queueWatcher.off(\"queueChange\", checkIfAcquiredLock);\n\t\t\t\tthis.abandonWatcher.off(\"abandon\", checkIfAbandoned);\n\t\t\t\tthis.connectionWatcher.off(\"disconnect\", rejectOnDisconnect);\n\t\t\t\tthis.completedWatcher.off(\"completed\", checkIfCompleted);\n\t\t\t\treject(new Error(\"Disconnected before acquiring task assignment\"));\n\t\t\t};\n\n\t\t\tconst checkIfCompleted = (eventTaskId: string) => {\n\t\t\t\tif (eventTaskId !== taskId) {\n\t\t\t\t\treturn;\n\t\t\t\t}\n\n\t\t\t\tthis.queueWatcher.off(\"queueChange\", checkIfAcquiredLock);\n\t\t\t\tthis.abandonWatcher.off(\"abandon\", checkIfAbandoned);\n\t\t\t\tthis.connectionWatcher.off(\"disconnect\", rejectOnDisconnect);\n\t\t\t\tthis.completedWatcher.off(\"completed\", checkIfCompleted);\n\t\t\t\tresolve(false);\n\t\t\t};\n\n\t\t\tthis.queueWatcher.on(\"queueChange\", checkIfAcquiredLock);\n\t\t\tthis.abandonWatcher.on(\"abandon\", checkIfAbandoned);\n\t\t\tthis.connectionWatcher.on(\"disconnect\", rejectOnDisconnect);\n\t\t\tthis.completedWatcher.on(\"completed\", checkIfCompleted);\n\t\t});\n\n\t\tif (!this.queued(taskId)) {\n\t\t\tthis.submitVolunteerOp(taskId);\n\t\t}\n\t\treturn lockAcquireP;\n\t}\n\n\t/**\n\t * {@inheritDoc ITaskManager.subscribeToTask}\n\t */\n\tpublic subscribeToTask(taskId: string) {\n\t\tif (this.subscribed(taskId)) {\n\t\t\treturn;\n\t\t}\n\n\t\tif (this.readOnlyInfo.readonly === true && this.readOnlyInfo.permissions === true) {\n\t\t\tthrow new Error(\"Attempted to subscribe with read-only permissions\");\n\t\t}\n\n\t\tconst submitVolunteerOp = () => {\n\t\t\tthis.submitVolunteerOp(taskId);\n\t\t};\n\n\t\tconst disconnectHandler = () => {\n\t\t\t// Wait to be connected again and then re-submit volunteer op\n\t\t\tthis.connectionWatcher.once(\"connect\", submitVolunteerOp);\n\t\t};\n\n\t\tconst checkIfAbandoned = (eventTaskId: string) => {\n\t\t\tif (eventTaskId !== taskId) {\n\t\t\t\treturn;\n\t\t\t}\n\n\t\t\tthis.abandonWatcher.off(\"abandon\", checkIfAbandoned);\n\t\t\tthis.connectionWatcher.off(\"disconnect\", disconnectHandler);\n\t\t\tthis.connectionWatcher.off(\"connect\", submitVolunteerOp);\n\t\t\tthis.completedWatcher.off(\"completed\", checkIfCompleted);\n\n\t\t\tthis.subscribedTasks.delete(taskId);\n\t\t};\n\n\t\tconst checkIfCompleted = (eventTaskId: string) => {\n\t\t\tif (eventTaskId !== taskId) {\n\t\t\t\treturn;\n\t\t\t}\n\n\t\t\tthis.abandonWatcher.off(\"abandon\", checkIfAbandoned);\n\t\t\tthis.connectionWatcher.off(\"disconnect\", disconnectHandler);\n\t\t\tthis.connectionWatcher.off(\"connect\", submitVolunteerOp);\n\t\t\tthis.completedWatcher.off(\"completed\", checkIfCompleted);\n\n\t\t\tthis.subscribedTasks.delete(taskId);\n\t\t};\n\n\t\tthis.abandonWatcher.on(\"abandon\", checkIfAbandoned);\n\t\tthis.connectionWatcher.on(\"disconnect\", disconnectHandler);\n\t\tthis.completedWatcher.on(\"completed\", checkIfCompleted);\n\n\t\tif (!this.isAttached()) {\n\t\t\t// Simulate auto-ack in detached scenario\n\t\t\tassert(this.clientId !== undefined, 0x473 /* clientId should not be undefined */);\n\t\t\tthis.addClientToQueue(taskId, this.clientId);\n\t\t\t// Because we volunteered with placeholderClientId, we need to wait for when we attach and are assigned\n\t\t\t// a real clientId. At that point we should re-enter the queue with a real volunteer op (assuming we are\n\t\t\t// connected).\n\t\t\tthis.runtime.once(\"attached\", () => {\n\t\t\t\tif (this.queued(taskId)) {\n\t\t\t\t\t// If we are already queued, then we were able to replace the placeholderClientId with our real\n\t\t\t\t\t// clientId and no action is required.\n\t\t\t\t\treturn;\n\t\t\t\t} else if (this.connected) {\n\t\t\t\t\tsubmitVolunteerOp();\n\t\t\t\t} else {\n\t\t\t\t\tthis.connectionWatcher.once(\"connect\", () => {\n\t\t\t\t\t\tsubmitVolunteerOp();\n\t\t\t\t\t});\n\t\t\t\t}\n\t\t\t});\n\t\t} else if (!this.connected) {\n\t\t\t// If we are disconnected (and attached), wait to be connected and submit volunteer op\n\t\t\tdisconnectHandler();\n\t\t} else if (!this.assigned(taskId) && !this.queued(taskId)) {\n\t\t\tsubmitVolunteerOp();\n\t\t}\n\t\tthis.subscribedTasks.add(taskId);\n\t}\n\n\t/**\n\t * {@inheritDoc ITaskManager.abandon}\n\t */\n\tpublic abandon(taskId: string) {\n\t\t// Always allow abandon if the client is subscribed to allow clients to unsubscribe while disconnected.\n\t\t// Otherwise, we should check to make sure the client is both connected queued for the task before sending an\n\t\t// abandon op.\n\t\tif (!this.subscribed(taskId) && !this.queued(taskId)) {\n\t\t\t// Nothing to do\n\t\t\treturn;\n\t\t}\n\n\t\tif (!this.isAttached()) {\n\t\t\t// Simulate auto-ack in detached scenario\n\t\t\tassert(this.clientId !== undefined, 0x474 /* clientId is undefined */);\n\t\t\tthis.removeClientFromQueue(taskId, this.clientId);\n\t\t\tthis.abandonWatcher.emit(\"abandon\", taskId);\n\t\t\treturn;\n\t\t}\n\n\t\t// If we're subscribed but not queued, we don't need to submit an abandon op (probably offline)\n\t\tif (this.queued(taskId)) {\n\t\t\tthis.submitAbandonOp(taskId);\n\t\t}\n\t\tthis.abandonWatcher.emit(\"abandon\", taskId);\n\t}\n\n\t/**\n\t * {@inheritDoc ITaskManager.assigned}\n\t */\n\tpublic assigned(taskId: string) {\n\t\tif (this.isAttached() && !this.connected) {\n\t\t\treturn false;\n\t\t}\n\n\t\tconst currentAssignee = this.taskQueues.get(taskId)?.[0];\n\t\treturn (\n\t\t\tcurrentAssignee !== undefined &&\n\t\t\tcurrentAssignee === this.clientId &&\n\t\t\t!this.latestPendingOps.has(taskId)\n\t\t);\n\t}\n\n\t/**\n\t * {@inheritDoc ITaskManager.queued}\n\t */\n\tpublic queued(taskId: string) {\n\t\tif (this.isAttached() && !this.connected) {\n\t\t\treturn false;\n\t\t}\n\n\t\tassert(this.clientId !== undefined, 0x07f /* \"clientId undefined\" */);\n\n\t\tconst clientQueue = this.taskQueues.get(taskId);\n\t\t// If we have no queue for the taskId, then no one has signed up for it.\n\t\treturn (\n\t\t\t((clientQueue?.includes(this.clientId) ?? false) &&\n\t\t\t\t!this.latestPendingOps.has(taskId)) ||\n\t\t\tthis.latestPendingOps.get(taskId)?.type === \"volunteer\"\n\t\t);\n\t}\n\n\t/**\n\t * {@inheritDoc ITaskManager.subscribed}\n\t */\n\tpublic subscribed(taskId: string): boolean {\n\t\treturn this.subscribedTasks.has(taskId);\n\t}\n\n\t/**\n\t * {@inheritDoc ITaskManager.complete}\n\t */\n\tpublic complete(taskId: string): void {\n\t\tif (!this.assigned(taskId)) {\n\t\t\tthrow new Error(\"Attempted to mark task as complete while not being assigned\");\n\t\t}\n\n\t\t// If we are detached we will simulate auto-ack for the complete op. Therefore we only need to send the op if\n\t\t// we are attached. Additionally, we don't need to check if we are connected while detached.\n\t\tif (this.isAttached()) {\n\t\t\tif (!this.connected) {\n\t\t\t\tthrow new Error(\"Attempted to complete task in disconnected state\");\n\t\t\t}\n\t\t\tthis.submitCompleteOp(taskId);\n\t\t}\n\n\t\tthis.taskQueues.delete(taskId);\n\t\tthis.completedWatcher.emit(\"completed\", taskId);\n\t\tthis.emit(\"completed\", taskId);\n\t}\n\n\t/**\n\t * {@inheritDoc ITaskManager.canVolunteer}\n\t */\n\tpublic canVolunteer(): boolean {\n\t\t// A client can volunteer for a task if it's both connected to the delta stream and in write mode.\n\t\t// this.connected reflects that condition, but is unintuitive and may be changed in the future. This API allows\n\t\t// us to make changes to this.connected without affecting our guidance on how to check if a client is eligible\n\t\t// to volunteer for a task.\n\t\treturn this.connected;\n\t}\n\n\t/**\n\t * Create a summary for the task manager\n\t *\n\t * @returns the summary of the current state of the task manager\n\t * @internal\n\t */\n\tprotected summarizeCore(serializer: IFluidSerializer): ISummaryTreeWithStats {\n\t\tif (this.runtime.clientId !== undefined) {\n\t\t\t// If the runtime has been assigned an actual clientId by now, we can replace the placeholder clientIds\n\t\t\t// and maintain the task assignment.\n\t\t\tthis.replacePlaceholderInAllQueues();\n\t\t} else {\n\t\t\t// If the runtime has still not been assigned a clientId, we should not summarize with the placeholder\n\t\t\t// clientIds and instead remove them from the queues and require the client to re-volunteer when assigned\n\t\t\t// a new clientId.\n\t\t\tthis.removeClientFromAllQueues(placeholderClientId);\n\t\t}\n\n\t\t// Only include tasks if there are clients in the queue.\n\t\tconst filteredMap = new Map<string, string[]>();\n\t\tthis.taskQueues.forEach((queue: string[], taskId: string) => {\n\t\t\tif (queue.length > 0) {\n\t\t\t\tfilteredMap.set(taskId, queue);\n\t\t\t}\n\t\t});\n\t\tconst content = [...filteredMap.entries()];\n\t\treturn createSingleBlobSummary(snapshotFileName, JSON.stringify(content));\n\t}\n\n\t/**\n\t * {@inheritDoc @fluidframework/shared-object-base#SharedObject.loadCore}\n\t * @internal\n\t */\n\tprotected async loadCore(storage: IChannelStorageService): Promise<void> {\n\t\tconst content = await readAndParse<[string, string[]][]>(storage, snapshotFileName);\n\t\tcontent.forEach(([taskId, clientIdQueue]) => {\n\t\t\tthis.taskQueues.set(taskId, clientIdQueue);\n\t\t});\n\t\tthis.scrubClientsNotInQuorum();\n\t}\n\n\t/**\n\t * @internal\n\t */\n\tprotected initializeLocalCore() {}\n\n\t/**\n\t * {@inheritDoc @fluidframework/shared-object-base#SharedObject.onDisconnect}\n\t * @internal\n\t */\n\tprotected onDisconnect() {\n\t\tthis.connectionWatcher.emit(\"disconnect\");\n\t}\n\n\t/**\n\t * {@inheritDoc @fluidframework/shared-object-base#SharedObject.onConnect}\n\t * @internal\n\t */\n\tprotected onConnect() {\n\t\tthis.connectionWatcher.emit(\"connect\");\n\t}\n\n\t//\n\t/**\n\t * Override resubmit core to avoid resubmission on reconnect.  On disconnect we accept our removal from the\n\t * queues, and leave it up to the user to decide whether they want to attempt to re-enter a queue on reconnect.\n\t * @internal\n\t */\n\tprotected reSubmitCore() {}\n\n\t/**\n\t * Process a task manager operation\n\t *\n\t * @param message - the message to prepare\n\t * @param local - whether the message was sent by the local client\n\t * @param localOpMetadata - For local client messages, this is the metadata that was submitted with the message.\n\t * For messages from a remote client, this will be undefined.\n\t * @internal\n\t */\n\tprotected processCore(\n\t\tmessage: ISequencedDocumentMessage,\n\t\tlocal: boolean,\n\t\tlocalOpMetadata: unknown,\n\t) {\n\t\tif (message.type === MessageType.Operation) {\n\t\t\tconst op = message.contents as ITaskManagerOperation;\n\t\t\tconst messageId = localOpMetadata as number;\n\n\t\t\tswitch (op.type) {\n\t\t\t\tcase \"volunteer\":\n\t\t\t\t\tthis.opWatcher.emit(\"volunteer\", op.taskId, message.clientId, local, messageId);\n\t\t\t\t\tbreak;\n\n\t\t\t\tcase \"abandon\":\n\t\t\t\t\tthis.opWatcher.emit(\"abandon\", op.taskId, message.clientId, local, messageId);\n\t\t\t\t\tbreak;\n\n\t\t\t\tcase \"complete\":\n\t\t\t\t\tthis.opWatcher.emit(\"complete\", op.taskId, message.clientId, local, messageId);\n\t\t\t\t\tbreak;\n\n\t\t\t\tdefault:\n\t\t\t\t\tthrow new Error(\"Unknown operation\");\n\t\t\t}\n\t\t}\n\t}\n\n\tprivate addClientToQueue(taskId: string, clientId: string) {\n\t\tconst pendingIds = this.pendingCompletedTasks.get(taskId);\n\t\tif (pendingIds !== undefined && pendingIds.length > 0) {\n\t\t\t// Ignore the volunteer op if we know this task is about to be completed\n\t\t\treturn;\n\t\t}\n\n\t\t// Ensure that the clientId exists in the quorum, or it is placeholderClientId (detached scenario)\n\t\tif (\n\t\t\tthis.runtime.getQuorum().getMembers().has(clientId) ||\n\t\t\tthis.clientId === placeholderClientId\n\t\t) {\n\t\t\t// Create the queue if it doesn't exist, and push the client on the back.\n\t\t\tlet clientQueue = this.taskQueues.get(taskId);\n\t\t\tif (clientQueue === undefined) {\n\t\t\t\tclientQueue = [];\n\t\t\t\tthis.taskQueues.set(taskId, clientQueue);\n\t\t\t}\n\n\t\t\tconst oldLockHolder = clientQueue[0];\n\t\t\tclientQueue.push(clientId);\n\t\t\tconst newLockHolder = clientQueue[0];\n\t\t\tif (newLockHolder !== oldLockHolder) {\n\t\t\t\tthis.queueWatcher.emit(\"queueChange\", taskId, oldLockHolder, newLockHolder);\n\t\t\t}\n\t\t}\n\t}\n\n\tprivate removeClientFromQueue(taskId: string, clientId: string) {\n\t\tconst clientQueue = this.taskQueues.get(taskId);\n\t\tif (clientQueue === undefined) {\n\t\t\treturn;\n\t\t}\n\n\t\tconst oldLockHolder =\n\t\t\tclientId === placeholderClientId ? placeholderClientId : clientQueue[0];\n\t\tconst clientIdIndex = clientQueue.indexOf(clientId);\n\t\tif (clientIdIndex !== -1) {\n\t\t\tclientQueue.splice(clientIdIndex, 1);\n\t\t\t// Clean up the queue if there are no more clients in it.\n\t\t\tif (clientQueue.length === 0) {\n\t\t\t\tthis.taskQueues.delete(taskId);\n\t\t\t}\n\t\t}\n\t\tconst newLockHolder = clientQueue[0];\n\t\tif (newLockHolder !== oldLockHolder) {\n\t\t\tthis.queueWatcher.emit(\"queueChange\", taskId, oldLockHolder, newLockHolder);\n\t\t}\n\t}\n\n\tprivate removeClientFromAllQueues(clientId: string) {\n\t\tfor (const taskId of this.taskQueues.keys()) {\n\t\t\tthis.removeClientFromQueue(taskId, clientId);\n\t\t}\n\t}\n\n\t/**\n\t * Will replace all instances of the placeholderClientId with the current clientId. This should only be called when\n\t * transitioning from detached to attached and this.runtime.clientId is defined.\n\t */\n\tprivate replacePlaceholderInAllQueues() {\n\t\tassert(\n\t\t\tthis.runtime.clientId !== undefined,\n\t\t\t0x475 /* this.runtime.clientId should be defined */,\n\t\t);\n\t\tfor (const clientQueue of this.taskQueues.values()) {\n\t\t\tconst clientIdIndex = clientQueue.indexOf(placeholderClientId);\n\t\t\tif (clientIdIndex !== -1) {\n\t\t\t\tclientQueue[clientIdIndex] = this.runtime.clientId;\n\t\t\t}\n\t\t}\n\t}\n\n\t// This seems like it should be unnecessary if we can trust to receive the join/leave messages and\n\t// also have an accurate snapshot.\n\tprivate scrubClientsNotInQuorum() {\n\t\tconst quorum = this.runtime.getQuorum();\n\t\tfor (const [taskId, clientQueue] of this.taskQueues) {\n\t\t\tconst filteredClientQueue = clientQueue.filter(\n\t\t\t\t(clientId) => quorum.getMember(clientId) !== undefined,\n\t\t\t);\n\t\t\tif (clientQueue.length !== filteredClientQueue.length) {\n\t\t\t\tif (filteredClientQueue.length === 0) {\n\t\t\t\t\tthis.taskQueues.delete(taskId);\n\t\t\t\t} else {\n\t\t\t\t\tthis.taskQueues.set(taskId, filteredClientQueue);\n\t\t\t\t}\n\t\t\t\tthis.queueWatcher.emit(\"queueChange\", taskId);\n\t\t\t}\n\t\t}\n\t}\n\n\tpublic applyStashedOp() {\n\t\t// do nothing...\n\t}\n}\n"]}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@fluidframework/task-manager",
-  "version": "2.0.0-internal.4.2.1",
+  "version": "2.0.0-internal.4.3.0",
   "description": "Distributed data structure for queueing exclusive tasks",
   "homepage": "https://fluidframework.com",
   "repository": {
@@ -37,27 +37,27 @@
   "dependencies": {
     "@fluidframework/common-definitions": "^0.20.1",
     "@fluidframework/common-utils": "^1.1.1",
-    "@fluidframework/container-definitions": ">=2.0.0-internal.4.2.1 <2.0.0-internal.4.3.0",
-    "@fluidframework/container-runtime-definitions": ">=2.0.0-internal.4.2.1 <2.0.0-internal.4.3.0",
-    "@fluidframework/core-interfaces": ">=2.0.0-internal.4.2.1 <2.0.0-internal.4.3.0",
-    "@fluidframework/datastore-definitions": ">=2.0.0-internal.4.2.1 <2.0.0-internal.4.3.0",
-    "@fluidframework/driver-utils": ">=2.0.0-internal.4.2.1 <2.0.0-internal.4.3.0",
+    "@fluidframework/container-definitions": ">=2.0.0-internal.4.3.0 <2.0.0-internal.4.4.0",
+    "@fluidframework/container-runtime-definitions": ">=2.0.0-internal.4.3.0 <2.0.0-internal.4.4.0",
+    "@fluidframework/core-interfaces": ">=2.0.0-internal.4.3.0 <2.0.0-internal.4.4.0",
+    "@fluidframework/datastore-definitions": ">=2.0.0-internal.4.3.0 <2.0.0-internal.4.4.0",
+    "@fluidframework/driver-utils": ">=2.0.0-internal.4.3.0 <2.0.0-internal.4.4.0",
     "@fluidframework/protocol-definitions": "^1.1.0",
-    "@fluidframework/runtime-definitions": ">=2.0.0-internal.4.2.1 <2.0.0-internal.4.3.0",
-    "@fluidframework/shared-object-base": ">=2.0.0-internal.4.2.1 <2.0.0-internal.4.3.0",
+    "@fluidframework/runtime-definitions": ">=2.0.0-internal.4.3.0 <2.0.0-internal.4.4.0",
+    "@fluidframework/shared-object-base": ">=2.0.0-internal.4.3.0 <2.0.0-internal.4.4.0",
     "events": "^3.1.0"
   },
   "devDependencies": {
     "@fluid-experimental/task-manager-previous": "npm:@fluid-experimental/task-manager@2.0.0-internal.2.1.1",
-    "@fluid-internal/stochastic-test-utils": ">=2.0.0-internal.4.2.1 <2.0.0-internal.4.3.0",
-    "@fluid-internal/test-dds-utils": ">=2.0.0-internal.4.2.1 <2.0.0-internal.4.3.0",
+    "@fluid-internal/stochastic-test-utils": ">=2.0.0-internal.4.3.0 <2.0.0-internal.4.4.0",
+    "@fluid-internal/test-dds-utils": ">=2.0.0-internal.4.3.0 <2.0.0-internal.4.4.0",
     "@fluid-tools/build-cli": "^0.17.0",
     "@fluidframework/build-common": "^1.1.0",
     "@fluidframework/build-tools": "^0.17.0",
     "@fluidframework/eslint-config-fluid": "^2.0.0",
-    "@fluidframework/mocha-test-setup": ">=2.0.0-internal.4.2.1 <2.0.0-internal.4.3.0",
+    "@fluidframework/mocha-test-setup": ">=2.0.0-internal.4.3.0 <2.0.0-internal.4.4.0",
     "@fluidframework/task-manager-previous": "npm:@fluidframework/task-manager@2.0.0-internal.4.1.0",
-    "@fluidframework/test-runtime-utils": ">=2.0.0-internal.4.2.1 <2.0.0-internal.4.3.0",
+    "@fluidframework/test-runtime-utils": ">=2.0.0-internal.4.3.0 <2.0.0-internal.4.4.0",
     "@microsoft/api-extractor": "^7.34.4",
     "@types/mocha": "^9.1.1",
     "@types/node": "^14.18.38",

package/src/index.ts

@@ -3,5 +3,12 @@
  * Licensed under the MIT License.
  */
 
-export { ITaskManager, ITaskManagerEvents } from "./interfaces";
+/**
+ * Contains a distributed data structure, {@link ITaskManager}, to track the queues of clients that want to
+ * exclusively run tasks.
+ *
+ * @packageDocumentation
+ */
+
+export { ITaskManager, ITaskManagerEvents, TaskEventListener } from "./interfaces";
 export { TaskManager } from "./taskManager";

package/src/interfaces.ts

@@ -5,19 +5,132 @@
 
 import { ISharedObject, ISharedObjectEvents } from "@fluidframework/shared-object-base";
 
+/**
+ * Describes the event listener format for {@link ITaskManagerEvents} events.
+ *
+ * @param taskId - The unique identifier of the related task.
+ */
+export type TaskEventListener = (taskId: string) => void;
+
 /**
  * Events emitted by {@link TaskManager}.
  */
 export interface ITaskManagerEvents extends ISharedObjectEvents {
 	/**
-	 * Notifies when the local client has reached the front of the queue, left the queue, or a task was completed.
-	 * Does not account for known pending ops, but instead only reflects the current state.
+	 * Fires when a task has been exclusively assigned to the client.
+	 *
+	 * @remarks Does not account for known pending ops, but instead only reflects the current state.
+	 *
+	 * @eventProperty
+	 */
+	(event: "assigned", listener: TaskEventListener);
+
+	/**
+	 * Fires when a task the client is queued for is completed.
+	 *
+	 * @eventProperty
+	 */
+	(event: "completed", listener: TaskEventListener);
+
+	/**
+	 * Fires when the task assignment is lost by the local client.
+	 *
+	 * @remarks This could be due to the client disconnecting or by manually calling {@link ITaskManager.abandon}.
+	 *
+	 * @eventProperty
 	 */
-	(event: "assigned" | "completed" | "lost", listener: (taskId: string) => void);
+	(event: "lost", listener: TaskEventListener);
 }
 
 /**
- * Task manager interface
+ * A distributed data structure that tracks queues of clients that want to exclusively run a task.
+ *
+ * @example Creation
+ *
+ * To create a {@link TaskManager}, call the static create method:
+ *
+ * ```typescript
+ * const taskManager = TaskManager.create(this.runtime, id);
+ * ```
+ *
+ * @example Usage
+ *
+ * To volunteer for a task, use the {@link ITaskManager.volunteerForTask} method.
+ * This returns a Promise that will resolve once the client has acquired exclusive rights to run the task,
+ * or reject if the client is removed from the queue without acquiring the rights.
+ *
+ * ```typescript
+ * taskManager.volunteerForTask("NameOfTask")
+ *     .then(() => { doTheTask(); })
+ *     .catch((err) => { console.error(err); });
+ * ```
+ *
+ * Alternatively, you can indefinitely volunteer for a task with the synchronous {@link ITaskManager.subscribeToTask}
+ * method. This method does not return a value, therefore you need to rely on eventing to know when you have acquired
+ * the rights to run the task (see below).
+ *
+ * ```typescript
+ * taskManager.subscribeToTask("NameOfTask");
+ * ```
+ *
+ * To check if the local client is currently subscribed to a task, use the {@link ITaskManager.subscribed} method.
+ *
+ * ```typescript
+ * if (taskManager.subscribed("NameOfTask")) {
+ *     console.log("This client is currently subscribed to the task.");
+ * }
+ * ```
+ *
+ * To release the rights to the task, use the {@link ITaskManager.abandon} method.
+ * The next client in the queue will then get the rights to run the task.
+ *
+ * ```typescript
+ * taskManager.abandon("NameOfTask");
+ * ```
+ *
+ * To inspect your state in the queue, you can use the {@link ITaskManager.queued} and {@link ITaskManager.assigned}
+ * methods.
+ *
+ * ```typescript
+ * if (taskManager.queued("NameOfTask")) {
+ *     console.log("This client is somewhere in the queue, potentially even having the task assignment.");
+ * }
+ *
+ * if (taskManager.assigned("NameOfTask")) {
+ *     console.log("This client currently has the rights to run the task");
+ * }
+ * ```
+ *
+ * To signal to other connected clients that a task is completed, use the {@link ITaskManager.complete} method.
+ * This will release all clients from the queue and emit the "completed" event.
+ *
+ * ```typescript
+ * taskManager.complete("NameOfTask");
+ * ```
+ *
+ * @example Eventing
+ *
+ * `ITaskManager` will emit events when a task is assigned to the client, when the task assignment is lost,
+ * and when a task was completed by another client.
+ *
+ * ```typescript
+ * taskManager.on("assigned", (taskId: string) => {
+ *     console.log(`Client was assigned task: ${taskId}`);
+ * });
+ *
+ * taskManager.on("lost", (taskId: string) => {
+ *     console.log(`Client released task: ${taskId}`);
+ * });
+ *
+ * taskManager.on("completed", (taskId: string) => {
+ *     console.log(`Another client completed task: ${taskId}`);
+ * });
+ * ```
+ *
+ * These can be useful if the logic to volunteer for a task is separated from the logic to perform the task, such as
+ * when using {@link ITaskManager.subscribeToTask}.
+ *
+ * See {@link ITaskManagerEvents} for more details.
  */
 export interface ITaskManager extends ISharedObject<ITaskManagerEvents> {
 	/**

package/src/packageVersion.ts

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

package/src/taskManager.ts

@@ -60,92 +60,9 @@ const snapshotFileName = "header";
 const placeholderClientId = "placeholder";
 
 /**
- * The TaskManager distributed data structure tracks queues of clients that want to exclusively run a task.
+ * {@inheritDoc ITaskManager}
  *
- * @remarks
- *
- * ### Creation
- *
- * To create a `TaskManager`, call the static create method:
- *
- * ```typescript
- * const taskManager = TaskManager.create(this.runtime, id);
- * ```
- *
- * ### Usage
- *
- * To volunteer for a task, use the `volunteerForTask()` method.  This returns a Promise that will resolve once the
- * client has acquired exclusive rights to run the task, or reject if the client is removed from the queue without
- * acquiring the rights.
- *
- * ```typescript
- * taskManager.volunteerForTask("NameOfTask")
- *     .then(() => { doTheTask(); })
- *     .catch((err) => { console.error(err); });
- * ```
- *
- * Alternatively, you can indefinitely volunteer for a task with the synchronous `subscribeToTask()` method. This
- * method does not return a value, therefore you need to rely on eventing to know when you have acquired the rights
- * to run the task (see below).
- *
- * ```typescript
- * taskManager.subscribeToTask("NameOfTask");
- * ```
- *
- * To check if the local client is currently subscribed to a task, use the `subscribed()` method.
- * ```typescript
- * if (taskManager.subscribed("NameOfTask")) {
- *     console.log("This client is currently subscribed to the task.");
- * }
- * ```
- *
- * To release the rights to the task, use the `abandon()` method.  The next client in the queue will then get the
- * rights to run the task.
- *
- * ```typescript
- * taskManager.abandon("NameOfTask");
- * ```
- *
- * To inspect your state in the queue, you can use the `queued()` and `assigned()` methods.
- *
- * ```typescript
- * if (taskManager.queued("NameOfTask")) {
- *     console.log("This client is somewhere in the queue, potentially even having the task assignment.");
- * }
- *
- * if (taskManager.assigned("NameOfTask")) {
- *     console.log("This client currently has the rights to run the task");
- * }
- * ```
- *
- * To signal to other connected clients that a task is completed, use the `complete()` method. This will release all
- * clients from the queue and emit the "completed" event.
- *
- * ```typescript
- * taskManager.complete("NameOfTask");
- * ```
- *
- * ### Eventing
- *
- * `TaskManager` is an `EventEmitter`, and will emit events when a task is assigned to the client, when the task
- * assignment is lost, and when a task was completed by another client.
- *
- * ```typescript
- * taskManager.on("assigned", (taskId: string) => {
- *     console.log(`Client was assigned task: ${taskId}`);
- * });
- *
- * taskManager.on("lost", (taskId: string) => {
- *     console.log(`Client released task: ${taskId}`);
- * });
- *
- * taskManager.on("completed", (taskId: string) => {
- *     console.log(`Another client completed task: ${taskId}`);
- * });
- * ```
- *
- * These can be useful if the logic to volunteer for a task is separated from the logic to perform the task, such as
- * when using the `subscribeToTask()` method.
+ * @sealed
  */
 export class TaskManager extends SharedObject<ITaskManagerEvents> implements ITaskManager {
 	/**
@@ -861,6 +778,6 @@ export class TaskManager extends SharedObject<ITaskManagerEvents> implements ITa
 	}
 
 	public applyStashedOp() {
-		throw new Error("not implemented");
+		// do nothing...
 	}
 }