@fluidframework/task-manager 2.0.0-internal.7.2.2 → 2.0.0-internal.7.4.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (65) hide show
  1. package/CHANGELOG.md +8 -0
  2. package/README.md +1 -2
  3. package/api-extractor-lint.json +13 -0
  4. package/api-extractor.json +9 -1
  5. package/api-report/task-manager.api.md +8 -11
  6. package/dist/{index.js → index.cjs} +2 -2
  7. package/dist/index.cjs.map +1 -0
  8. package/dist/{interfaces.js → interfaces.cjs} +1 -1
  9. package/dist/interfaces.cjs.map +1 -0
  10. package/dist/interfaces.d.ts +3 -6
  11. package/dist/interfaces.d.ts.map +1 -1
  12. package/dist/{packageVersion.js → packageVersion.cjs} +2 -2
  13. package/dist/packageVersion.cjs.map +1 -0
  14. package/dist/packageVersion.d.ts +1 -1
  15. package/dist/task-manager-alpha.d.ts +27 -0
  16. package/dist/task-manager-beta.d.ts +45 -0
  17. package/dist/task-manager-public.d.ts +45 -0
  18. package/dist/task-manager-untrimmed.d.ts +335 -0
  19. package/dist/{taskManager.js → taskManager.cjs} +4 -12
  20. package/dist/taskManager.cjs.map +1 -0
  21. package/dist/taskManager.d.ts +2 -10
  22. package/dist/taskManager.d.ts.map +1 -1
  23. package/dist/{taskManagerFactory.js → taskManagerFactory.cjs} +3 -3
  24. package/dist/taskManagerFactory.cjs.map +1 -0
  25. package/dist/tsdoc-metadata.json +1 -1
  26. package/lib/index.d.ts +2 -8
  27. package/lib/index.d.ts.map +1 -1
  28. package/lib/{index.js → index.mjs} +2 -2
  29. package/lib/index.mjs.map +1 -0
  30. package/lib/interfaces.d.ts +3 -6
  31. package/lib/interfaces.d.ts.map +1 -1
  32. package/lib/{interfaces.js → interfaces.mjs} +1 -1
  33. package/lib/interfaces.mjs.map +1 -0
  34. package/lib/packageVersion.d.ts +1 -1
  35. package/lib/{packageVersion.js → packageVersion.mjs} +2 -2
  36. package/lib/packageVersion.mjs.map +1 -0
  37. package/lib/task-manager-alpha.d.ts +27 -0
  38. package/lib/task-manager-beta.d.ts +45 -0
  39. package/lib/task-manager-public.d.ts +45 -0
  40. package/lib/task-manager-untrimmed.d.ts +335 -0
  41. package/lib/taskManager.d.ts +3 -11
  42. package/lib/taskManager.d.ts.map +1 -1
  43. package/lib/{taskManager.js → taskManager.mjs} +4 -12
  44. package/lib/taskManager.mjs.map +1 -0
  45. package/lib/taskManagerFactory.d.ts +1 -1
  46. package/lib/taskManagerFactory.d.ts.map +1 -1
  47. package/lib/{taskManagerFactory.js → taskManagerFactory.mjs} +3 -3
  48. package/lib/taskManagerFactory.mjs.map +1 -0
  49. package/package.json +50 -30
  50. package/src/interfaces.ts +3 -6
  51. package/src/packageVersion.ts +1 -1
  52. package/src/taskManager.ts +2 -10
  53. package/tsc-multi.test.json +4 -0
  54. package/tsconfig.json +5 -3
  55. package/dist/index.js.map +0 -1
  56. package/dist/interfaces.js.map +0 -1
  57. package/dist/packageVersion.js.map +0 -1
  58. package/dist/taskManager.js.map +0 -1
  59. package/dist/taskManagerFactory.js.map +0 -1
  60. package/lib/index.js.map +0 -1
  61. package/lib/interfaces.js.map +0 -1
  62. package/lib/packageVersion.js.map +0 -1
  63. package/lib/taskManager.js.map +0 -1
  64. package/lib/taskManagerFactory.js.map +0 -1
  65. package/tsconfig.esnext.json +0 -7
@@ -0,0 +1,335 @@
1
+ /**
2
+ * Contains a distributed data structure, {@link ITaskManager}, to track the queues of clients that want to
3
+ * exclusively run tasks.
4
+ *
5
+ * @packageDocumentation
6
+ */
7
+
8
+ import { IChannelAttributes } from '@fluidframework/datastore-definitions';
9
+ import { IChannelFactory } from '@fluidframework/datastore-definitions';
10
+ import { IChannelStorageService } from '@fluidframework/datastore-definitions';
11
+ import { IFluidDataStoreRuntime } from '@fluidframework/datastore-definitions';
12
+ import { IFluidSerializer } from '@fluidframework/shared-object-base';
13
+ import { ISequencedDocumentMessage } from '@fluidframework/protocol-definitions';
14
+ import { ISharedObject } from '@fluidframework/shared-object-base';
15
+ import { ISharedObjectEvents } from '@fluidframework/shared-object-base';
16
+ import { ISummaryTreeWithStats } from '@fluidframework/runtime-definitions';
17
+ import { SharedObject } from '@fluidframework/shared-object-base';
18
+
19
+ /**
20
+ * A distributed data structure that tracks queues of clients that want to exclusively run a task.
21
+ *
22
+ * @example Creation
23
+ *
24
+ * To create a {@link TaskManager}, call the static create method:
25
+ *
26
+ * ```typescript
27
+ * const taskManager = TaskManager.create(this.runtime, id);
28
+ * ```
29
+ *
30
+ * @example Usage
31
+ *
32
+ * To volunteer for a task, use the {@link ITaskManager.volunteerForTask} method.
33
+ * This returns a Promise that will resolve once the client has acquired exclusive rights to run the task,
34
+ * or reject if the client is removed from the queue without acquiring the rights.
35
+ *
36
+ * ```typescript
37
+ * taskManager.volunteerForTask("NameOfTask")
38
+ * .then(() => { doTheTask(); })
39
+ * .catch((err) => { console.error(err); });
40
+ * ```
41
+ *
42
+ * Alternatively, you can indefinitely volunteer for a task with the synchronous {@link ITaskManager.subscribeToTask}
43
+ * method. This method does not return a value, therefore you need to rely on eventing to know when you have acquired
44
+ * the rights to run the task (see below).
45
+ *
46
+ * ```typescript
47
+ * taskManager.subscribeToTask("NameOfTask");
48
+ * ```
49
+ *
50
+ * To check if the local client is currently subscribed to a task, use the {@link ITaskManager.subscribed} method.
51
+ *
52
+ * ```typescript
53
+ * if (taskManager.subscribed("NameOfTask")) {
54
+ * console.log("This client is currently subscribed to the task.");
55
+ * }
56
+ * ```
57
+ *
58
+ * To release the rights to the task, use the {@link ITaskManager.abandon} method.
59
+ * The next client in the queue will then get the rights to run the task.
60
+ *
61
+ * ```typescript
62
+ * taskManager.abandon("NameOfTask");
63
+ * ```
64
+ *
65
+ * To inspect your state in the queue, you can use the {@link ITaskManager.queued} and {@link ITaskManager.assigned}
66
+ * methods.
67
+ *
68
+ * ```typescript
69
+ * if (taskManager.queued("NameOfTask")) {
70
+ * console.log("This client is somewhere in the queue, potentially even having the task assignment.");
71
+ * }
72
+ *
73
+ * if (taskManager.assigned("NameOfTask")) {
74
+ * console.log("This client currently has the rights to run the task");
75
+ * }
76
+ * ```
77
+ *
78
+ * To signal to other connected clients that a task is completed, use the {@link ITaskManager.complete} method.
79
+ * This will release all clients from the queue and emit the "completed" event.
80
+ *
81
+ * ```typescript
82
+ * taskManager.complete("NameOfTask");
83
+ * ```
84
+ *
85
+ * @example Eventing
86
+ *
87
+ * `ITaskManager` will emit events when a task is assigned to the client, when the task assignment is lost,
88
+ * and when a task was completed by another client.
89
+ *
90
+ * ```typescript
91
+ * taskManager.on("assigned", (taskId: string) => {
92
+ * console.log(`Client was assigned task: ${taskId}`);
93
+ * });
94
+ *
95
+ * taskManager.on("lost", (taskId: string) => {
96
+ * console.log(`Client released task: ${taskId}`);
97
+ * });
98
+ *
99
+ * taskManager.on("completed", (taskId: string) => {
100
+ * console.log(`Another client completed task: ${taskId}`);
101
+ * });
102
+ * ```
103
+ *
104
+ * These can be useful if the logic to volunteer for a task is separated from the logic to perform the task, such as
105
+ * when using {@link ITaskManager.subscribeToTask}.
106
+ *
107
+ * See {@link ITaskManagerEvents} for more details.
108
+ * @internal
109
+ */
110
+ export declare interface ITaskManager extends ISharedObject<ITaskManagerEvents> {
111
+ /**
112
+ * Volunteer for the task. Returns a promise that resolves `true` if the task is assigned to the local client and
113
+ * `false` if the task was completed by another client. It rejects if the local client abandoned the task or
114
+ * disconnected while in queue.
115
+ * @param taskId - Identifier for the task
116
+ */
117
+ volunteerForTask(taskId: string): Promise<boolean>;
118
+ /**
119
+ * Continuously volunteer for the task. Watch the "assigned" event to determine if the task is assigned.
120
+ * The local client will automatically re-enter the queue if it disconnects.
121
+ * @param taskId - Identifier for the task
122
+ */
123
+ subscribeToTask(taskId: string): void;
124
+ /**
125
+ * Exit the queue, releasing the task if currently assigned.
126
+ * @param taskId - Identifier for the task
127
+ */
128
+ abandon(taskId: string): void;
129
+ /**
130
+ * Check whether this client is the current assignee for the task and there is no outstanding abandon op that
131
+ * would abandon the assignment.
132
+ * @param taskId - Identifier for the task
133
+ */
134
+ assigned(taskId: string): boolean;
135
+ /**
136
+ * Check whether this client is either the current assignee, in queue, or we expect they will be in queue after
137
+ * outstanding ops have been ack'd.
138
+ * @param taskId - Identifier for the task
139
+ */
140
+ queued(taskId: string): boolean;
141
+ /**
142
+ * Check whether this client is currently subscribed to the task.
143
+ * @param taskId - Identifier for the task
144
+ */
145
+ subscribed(taskId: string): boolean;
146
+ /**
147
+ * Marks a task as completed and releases all clients from its queue.
148
+ * @param taskId - Identifier for the task
149
+ */
150
+ complete(taskId: string): void;
151
+ /**
152
+ * Check whether this client can currently volunteer for a task.
153
+ */
154
+ canVolunteer(): boolean;
155
+ }
156
+
157
+ /**
158
+ * Events emitted by {@link TaskManager}.
159
+ * @internal
160
+ */
161
+ export declare interface ITaskManagerEvents extends ISharedObjectEvents {
162
+ /**
163
+ * Fires when a task has been exclusively assigned to the client.
164
+ *
165
+ * @remarks Does not account for known pending ops, but instead only reflects the current state.
166
+ *
167
+ * @eventProperty
168
+ */
169
+ (event: "assigned", listener: TaskEventListener): any;
170
+ /**
171
+ * Fires when a task the client is queued for is completed.
172
+ *
173
+ * @eventProperty
174
+ */
175
+ (event: "completed", listener: TaskEventListener): any;
176
+ /**
177
+ * Fires when the task assignment is lost by the local client.
178
+ *
179
+ * @remarks This could be due to the client disconnecting or by manually calling {@link ITaskManager.abandon}.
180
+ *
181
+ * @eventProperty
182
+ */
183
+ (event: "lost", listener: TaskEventListener): any;
184
+ }
185
+
186
+ /**
187
+ * Describes the event listener format for {@link ITaskManagerEvents} events.
188
+ *
189
+ * @param taskId - The unique identifier of the related task.
190
+ * @internal
191
+ */
192
+ export declare type TaskEventListener = (taskId: string) => void;
193
+
194
+ /**
195
+ * {@inheritDoc ITaskManager}
196
+ *
197
+ * @sealed
198
+ * @internal
199
+ */
200
+ export declare class TaskManager extends SharedObject<ITaskManagerEvents> implements ITaskManager {
201
+ /**
202
+ * Create a new TaskManager
203
+ *
204
+ * @param runtime - data store runtime the new task queue belongs to
205
+ * @param id - optional name of the task queue
206
+ * @returns newly create task queue (but not attached yet)
207
+ */
208
+ static create(runtime: IFluidDataStoreRuntime, id?: string): TaskManager;
209
+ /**
210
+ * Get a factory for TaskManager to register with the data store.
211
+ *
212
+ * @returns a factory that creates and load TaskManager
213
+ */
214
+ static getFactory(): IChannelFactory;
215
+ /**
216
+ * Mapping of taskId to a queue of clientIds that are waiting on the task. Maintains the consensus state of the
217
+ * queue, even if we know we've submitted an op that should eventually modify the queue.
218
+ */
219
+ private readonly taskQueues;
220
+ private readonly opWatcher;
221
+ private readonly queueWatcher;
222
+ private readonly abandonWatcher;
223
+ private readonly connectionWatcher;
224
+ private readonly completedWatcher;
225
+ private messageId;
226
+ /**
227
+ * Tracks the most recent pending op for a given task
228
+ */
229
+ private readonly latestPendingOps;
230
+ /**
231
+ * Tracks tasks that are this client is currently subscribed to.
232
+ */
233
+ private readonly subscribedTasks;
234
+ /**
235
+ * Map to track tasks that have pending complete ops.
236
+ */
237
+ private readonly pendingCompletedTasks;
238
+ /**
239
+ * Returns the clientId. Will return a placeholder if the runtime is detached and not yet assigned a clientId.
240
+ */
241
+ private get clientId();
242
+ /**
243
+ * Returns a ReadOnlyInfo object to determine current read/write permissions.
244
+ */
245
+ private get readOnlyInfo();
246
+ /**
247
+ * Constructs a new task manager. If the object is non-local an id and service interfaces will
248
+ * be provided
249
+ *
250
+ * @param runtime - data store runtime the task queue belongs to
251
+ * @param id - optional name of the task queue
252
+ */
253
+ constructor(id: string, runtime: IFluidDataStoreRuntime, attributes: IChannelAttributes);
254
+ private submitVolunteerOp;
255
+ private submitAbandonOp;
256
+ private submitCompleteOp;
257
+ /**
258
+ * {@inheritDoc ITaskManager.volunteerForTask}
259
+ */
260
+ volunteerForTask(taskId: string): Promise<boolean>;
261
+ /**
262
+ * {@inheritDoc ITaskManager.subscribeToTask}
263
+ */
264
+ subscribeToTask(taskId: string): void;
265
+ /**
266
+ * {@inheritDoc ITaskManager.abandon}
267
+ */
268
+ abandon(taskId: string): void;
269
+ /**
270
+ * {@inheritDoc ITaskManager.assigned}
271
+ */
272
+ assigned(taskId: string): boolean;
273
+ /**
274
+ * {@inheritDoc ITaskManager.queued}
275
+ */
276
+ queued(taskId: string): boolean;
277
+ /**
278
+ * {@inheritDoc ITaskManager.subscribed}
279
+ */
280
+ subscribed(taskId: string): boolean;
281
+ /**
282
+ * {@inheritDoc ITaskManager.complete}
283
+ */
284
+ complete(taskId: string): void;
285
+ /**
286
+ * {@inheritDoc ITaskManager.canVolunteer}
287
+ */
288
+ canVolunteer(): boolean;
289
+ /**
290
+ * Create a summary for the task manager
291
+ *
292
+ * @returns the summary of the current state of the task manager
293
+ */
294
+ protected summarizeCore(serializer: IFluidSerializer): ISummaryTreeWithStats;
295
+ /**
296
+ * {@inheritDoc @fluidframework/shared-object-base#SharedObject.loadCore}
297
+ */
298
+ protected loadCore(storage: IChannelStorageService): Promise<void>;
299
+ /***/
300
+ protected initializeLocalCore(): void;
301
+ /**
302
+ * {@inheritDoc @fluidframework/shared-object-base#SharedObject.onDisconnect}
303
+ */
304
+ protected onDisconnect(): void;
305
+ /**
306
+ * {@inheritDoc @fluidframework/shared-object-base#SharedObject.onConnect}
307
+ */
308
+ protected onConnect(): void;
309
+ /**
310
+ * Override resubmit core to avoid resubmission on reconnect. On disconnect we accept our removal from the
311
+ * queues, and leave it up to the user to decide whether they want to attempt to re-enter a queue on reconnect.
312
+ */
313
+ protected reSubmitCore(): void;
314
+ /**
315
+ * Process a task manager operation
316
+ *
317
+ * @param message - the message to prepare
318
+ * @param local - whether the message was sent by the local client
319
+ * @param localOpMetadata - For local client messages, this is the metadata that was submitted with the message.
320
+ * For messages from a remote client, this will be undefined.
321
+ */
322
+ protected processCore(message: ISequencedDocumentMessage, local: boolean, localOpMetadata: unknown): void;
323
+ private addClientToQueue;
324
+ private removeClientFromQueue;
325
+ private removeClientFromAllQueues;
326
+ /**
327
+ * Will replace all instances of the placeholderClientId with the current clientId. This should only be called when
328
+ * transitioning from detached to attached and this.runtime.clientId is defined.
329
+ */
330
+ private replacePlaceholderInAllQueues;
331
+ private scrubClientsNotInQuorum;
332
+ applyStashedOp(): void;
333
+ }
334
+
335
+ export { }
@@ -6,12 +6,12 @@ import { ISequencedDocumentMessage } from "@fluidframework/protocol-definitions"
6
6
  import { IChannelAttributes, IFluidDataStoreRuntime, IChannelStorageService, IChannelFactory } from "@fluidframework/datastore-definitions";
7
7
  import { ISummaryTreeWithStats } from "@fluidframework/runtime-definitions";
8
8
  import { IFluidSerializer, SharedObject } from "@fluidframework/shared-object-base";
9
- import { ITaskManager, ITaskManagerEvents } from "./interfaces";
9
+ import { ITaskManager, ITaskManagerEvents } from "./interfaces.mjs";
10
10
  /**
11
11
  * {@inheritDoc ITaskManager}
12
12
  *
13
13
  * @sealed
14
- * @public
14
+ * @internal
15
15
  */
16
16
  export declare class TaskManager extends SharedObject<ITaskManagerEvents> implements ITaskManager {
17
17
  /**
@@ -106,32 +106,25 @@ export declare class TaskManager extends SharedObject<ITaskManagerEvents> implem
106
106
  * Create a summary for the task manager
107
107
  *
108
108
  * @returns the summary of the current state of the task manager
109
- * @internal
110
109
  */
111
110
  protected summarizeCore(serializer: IFluidSerializer): ISummaryTreeWithStats;
112
111
  /**
113
112
  * {@inheritDoc @fluidframework/shared-object-base#SharedObject.loadCore}
114
- * @internal
115
113
  */
116
114
  protected loadCore(storage: IChannelStorageService): Promise<void>;
117
- /**
118
- * @internal
119
- */
115
+ /***/
120
116
  protected initializeLocalCore(): void;
121
117
  /**
122
118
  * {@inheritDoc @fluidframework/shared-object-base#SharedObject.onDisconnect}
123
- * @internal
124
119
  */
125
120
  protected onDisconnect(): void;
126
121
  /**
127
122
  * {@inheritDoc @fluidframework/shared-object-base#SharedObject.onConnect}
128
- * @internal
129
123
  */
130
124
  protected onConnect(): void;
131
125
  /**
132
126
  * Override resubmit core to avoid resubmission on reconnect. On disconnect we accept our removal from the
133
127
  * queues, and leave it up to the user to decide whether they want to attempt to re-enter a queue on reconnect.
134
- * @internal
135
128
  */
136
129
  protected reSubmitCore(): void;
137
130
  /**
@@ -141,7 +134,6 @@ export declare class TaskManager extends SharedObject<ITaskManagerEvents> implem
141
134
  * @param local - whether the message was sent by the local client
142
135
  * @param localOpMetadata - For local client messages, this is the metadata that was submitted with the message.
143
136
  * For messages from a remote client, this will be undefined.
144
- * @internal
145
137
  */
146
138
  protected processCore(message: ISequencedDocumentMessage, local: boolean, localOpMetadata: unknown): void;
147
139
  private addClientToQueue;
@@ -1 +1 @@
1
- {"version":3,"file":"taskManager.d.ts","sourceRoot":"","sources":["../src/taskManager.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAKH,OAAO,EAAE,yBAAyB,EAAe,MAAM,sCAAsC,CAAC;AAC9F,OAAO,EACN,kBAAkB,EAClB,sBAAsB,EACtB,sBAAsB,EACtB,eAAe,EACf,MAAM,uCAAuC,CAAC;AAC/C,OAAO,EAAE,qBAAqB,EAAE,MAAM,qCAAqC,CAAC;AAE5E,OAAO,EAEN,gBAAgB,EAChB,YAAY,EACZ,MAAM,oCAAoC,CAAC;AAG5C,OAAO,EAAE,YAAY,EAAE,kBAAkB,EAAE,MAAM,cAAc,CAAC;AAqChE;;;;;GAKG;AACH,qBAAa,WAAY,SAAQ,YAAY,CAAC,kBAAkB,CAAE,YAAW,YAAY;IACxF;;;;;;OAMG;WACW,MAAM,CAAC,OAAO,EAAE,sBAAsB,EAAE,EAAE,CAAC,EAAE,MAAM;IAIjE;;;;OAIG;WACW,UAAU,IAAI,eAAe;IAI3C;;;OAGG;IACH,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAoC;IAG/D,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAoC;IAE9D,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAoC;IAEjE,OAAO,CAAC,QAAQ,CAAC,cAAc,CAAoC;IAEnE,OAAO,CAAC,QAAQ,CAAC,iBAAiB,CAAoC;IAEtE,OAAO,CAAC,QAAQ,CAAC,gBAAgB,CAAoC;IAErE,OAAO,CAAC,SAAS,CAAc;IAC/B;;OAEG;IACH,OAAO,CAAC,QAAQ,CAAC,gBAAgB,CAAsC;IAEvE;;OAEG;IACH,OAAO,CAAC,QAAQ,CAAC,eAAe,CAA0B;IAE1D;;OAEG;IACH,OAAO,CAAC,QAAQ,CAAC,qBAAqB,CAAoC;IAE1E;;OAEG;IACH,OAAO,KAAK,QAAQ,GAEnB;IAED;;OAEG;IACH,OAAO,KAAK,YAAY,GAEvB;IAED;;;;;;OAMG;gBACS,EAAE,EAAE,MAAM,EAAE,OAAO,EAAE,sBAAsB,EAAE,UAAU,EAAE,kBAAkB;IAwHvF,OAAO,CAAC,iBAAiB;IAazB,OAAO,CAAC,eAAe;IAavB,OAAO,CAAC,gBAAgB;IAoBxB;;OAEG;IACU,gBAAgB,CAAC,MAAM,EAAE,MAAM;IAwF5C;;OAEG;IACI,eAAe,CAAC,MAAM,EAAE,MAAM;IA6ErC;;OAEG;IACI,OAAO,CAAC,MAAM,EAAE,MAAM;IAwB7B;;OAEG;IACI,QAAQ,CAAC,MAAM,EAAE,MAAM;IAa9B;;OAEG;IACI,MAAM,CAAC,MAAM,EAAE,MAAM;IAgB5B;;OAEG;IACI,UAAU,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO;IAI1C;;OAEG;IACI,QAAQ,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI;IAmBrC;;OAEG;IACI,YAAY,IAAI,OAAO;IAQ9B;;;;;OAKG;IACH,SAAS,CAAC,aAAa,CAAC,UAAU,EAAE,gBAAgB,GAAG,qBAAqB;IAuB5E;;;OAGG;cACa,QAAQ,CAAC,OAAO,EAAE,sBAAsB,GAAG,OAAO,CAAC,IAAI,CAAC;IAQxE;;OAEG;IACH,SAAS,CAAC,mBAAmB;IAE7B;;;OAGG;IACH,SAAS,CAAC,YAAY;IAItB;;;OAGG;IACH,SAAS,CAAC,SAAS;IAKnB;;;;OAIG;IACH,SAAS,CAAC,YAAY;IAEtB;;;;;;;;OAQG;IACH,SAAS,CAAC,WAAW,CACpB,OAAO,EAAE,yBAAyB,EAClC,KAAK,EAAE,OAAO,EACd,eAAe,EAAE,OAAO;IAyBzB,OAAO,CAAC,gBAAgB;IA4BxB,OAAO,CAAC,qBAAqB;IAsB7B,OAAO,CAAC,yBAAyB;IAMjC;;;OAGG;IACH,OAAO,CAAC,6BAA6B;IAerC,OAAO,CAAC,uBAAuB;IAiBxB,cAAc;CAGrB"}
1
+ {"version":3,"file":"taskManager.d.ts","sourceRoot":"","sources":["../src/taskManager.ts"],"names":[],"mappings":"AAAA;;;GAGG;OAKI,EAAE,yBAAyB,EAAe,MAAM,sCAAsC;OACtF,EACN,kBAAkB,EAClB,sBAAsB,EACtB,sBAAsB,EACtB,eAAe,EACf,MAAM,uCAAuC;OACvC,EAAE,qBAAqB,EAAE,MAAM,qCAAqC;OAEpE,EAEN,gBAAgB,EAChB,YAAY,EACZ,MAAM,oCAAoC;OAGpC,EAAE,YAAY,EAAE,kBAAkB,EAAE;AAqC3C;;;;;GAKG;AACH,qBAAa,WAAY,SAAQ,YAAY,CAAC,kBAAkB,CAAE,YAAW,YAAY;IACxF;;;;;;OAMG;WACW,MAAM,CAAC,OAAO,EAAE,sBAAsB,EAAE,EAAE,CAAC,EAAE,MAAM;IAIjE;;;;OAIG;WACW,UAAU,IAAI,eAAe;IAI3C;;;OAGG;IACH,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAoC;IAG/D,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAoC;IAE9D,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAoC;IAEjE,OAAO,CAAC,QAAQ,CAAC,cAAc,CAAoC;IAEnE,OAAO,CAAC,QAAQ,CAAC,iBAAiB,CAAoC;IAEtE,OAAO,CAAC,QAAQ,CAAC,gBAAgB,CAAoC;IAErE,OAAO,CAAC,SAAS,CAAc;IAC/B;;OAEG;IACH,OAAO,CAAC,QAAQ,CAAC,gBAAgB,CAAsC;IAEvE;;OAEG;IACH,OAAO,CAAC,QAAQ,CAAC,eAAe,CAA0B;IAE1D;;OAEG;IACH,OAAO,CAAC,QAAQ,CAAC,qBAAqB,CAAoC;IAE1E;;OAEG;IACH,OAAO,KAAK,QAAQ,GAEnB;IAED;;OAEG;IACH,OAAO,KAAK,YAAY,GAEvB;IAED;;;;;;OAMG;gBACS,EAAE,EAAE,MAAM,EAAE,OAAO,EAAE,sBAAsB,EAAE,UAAU,EAAE,kBAAkB;IAwHvF,OAAO,CAAC,iBAAiB;IAazB,OAAO,CAAC,eAAe;IAavB,OAAO,CAAC,gBAAgB;IAoBxB;;OAEG;IACU,gBAAgB,CAAC,MAAM,EAAE,MAAM;IAwF5C;;OAEG;IACI,eAAe,CAAC,MAAM,EAAE,MAAM;IA6ErC;;OAEG;IACI,OAAO,CAAC,MAAM,EAAE,MAAM;IAwB7B;;OAEG;IACI,QAAQ,CAAC,MAAM,EAAE,MAAM;IAa9B;;OAEG;IACI,MAAM,CAAC,MAAM,EAAE,MAAM;IAgB5B;;OAEG;IACI,UAAU,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO;IAI1C;;OAEG;IACI,QAAQ,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI;IAmBrC;;OAEG;IACI,YAAY,IAAI,OAAO;IAQ9B;;;;OAIG;IACH,SAAS,CAAC,aAAa,CAAC,UAAU,EAAE,gBAAgB,GAAG,qBAAqB;IAuB5E;;OAEG;cACa,QAAQ,CAAC,OAAO,EAAE,sBAAsB,GAAG,OAAO,CAAC,IAAI,CAAC;IAQxE,KAAK;IACL,SAAS,CAAC,mBAAmB;IAE7B;;OAEG;IACH,SAAS,CAAC,YAAY;IAItB;;OAEG;IACH,SAAS,CAAC,SAAS;IAKnB;;;OAGG;IACH,SAAS,CAAC,YAAY;IAEtB;;;;;;;OAOG;IACH,SAAS,CAAC,WAAW,CACpB,OAAO,EAAE,yBAAyB,EAClC,KAAK,EAAE,OAAO,EACd,eAAe,EAAE,OAAO;IAyBzB,OAAO,CAAC,gBAAgB;IA4BxB,OAAO,CAAC,qBAAqB;IAsB7B,OAAO,CAAC,yBAAyB;IAMjC;;;OAGG;IACH,OAAO,CAAC,6BAA6B;IAerC,OAAO,CAAC,uBAAuB;IAiBxB,cAAc;CAGrB"}
@@ -7,7 +7,7 @@ import { assert } from "@fluidframework/core-utils";
7
7
  import { MessageType } from "@fluidframework/protocol-definitions";
8
8
  import { readAndParse } from "@fluidframework/driver-utils";
9
9
  import { createSingleBlobSummary, SharedObject, } from "@fluidframework/shared-object-base";
10
- import { TaskManagerFactory } from "./taskManagerFactory";
10
+ import { TaskManagerFactory } from "./taskManagerFactory.mjs";
11
11
  const snapshotFileName = "header";
12
12
  /**
13
13
  * Placeholder clientId for detached scenarios.
@@ -17,7 +17,7 @@ const placeholderClientId = "placeholder";
17
17
  * {@inheritDoc ITaskManager}
18
18
  *
19
19
  * @sealed
20
- * @public
20
+ * @internal
21
21
  */
22
22
  export class TaskManager extends SharedObject {
23
23
  /**
@@ -453,7 +453,6 @@ export class TaskManager extends SharedObject {
453
453
  * Create a summary for the task manager
454
454
  *
455
455
  * @returns the summary of the current state of the task manager
456
- * @internal
457
456
  */
458
457
  summarizeCore(serializer) {
459
458
  if (this.runtime.clientId !== undefined) {
@@ -479,7 +478,6 @@ export class TaskManager extends SharedObject {
479
478
  }
480
479
  /**
481
480
  * {@inheritDoc @fluidframework/shared-object-base#SharedObject.loadCore}
482
- * @internal
483
481
  */
484
482
  async loadCore(storage) {
485
483
  const content = await readAndParse(storage, snapshotFileName);
@@ -488,20 +486,16 @@ export class TaskManager extends SharedObject {
488
486
  });
489
487
  this.scrubClientsNotInQuorum();
490
488
  }
491
- /**
492
- * @internal
493
- */
489
+ /***/
494
490
  initializeLocalCore() { }
495
491
  /**
496
492
  * {@inheritDoc @fluidframework/shared-object-base#SharedObject.onDisconnect}
497
- * @internal
498
493
  */
499
494
  onDisconnect() {
500
495
  this.connectionWatcher.emit("disconnect");
501
496
  }
502
497
  /**
503
498
  * {@inheritDoc @fluidframework/shared-object-base#SharedObject.onConnect}
504
- * @internal
505
499
  */
506
500
  onConnect() {
507
501
  this.connectionWatcher.emit("connect");
@@ -510,7 +504,6 @@ export class TaskManager extends SharedObject {
510
504
  /**
511
505
  * Override resubmit core to avoid resubmission on reconnect. On disconnect we accept our removal from the
512
506
  * queues, and leave it up to the user to decide whether they want to attempt to re-enter a queue on reconnect.
513
- * @internal
514
507
  */
515
508
  reSubmitCore() { }
516
509
  /**
@@ -520,7 +513,6 @@ export class TaskManager extends SharedObject {
520
513
  * @param local - whether the message was sent by the local client
521
514
  * @param localOpMetadata - For local client messages, this is the metadata that was submitted with the message.
522
515
  * For messages from a remote client, this will be undefined.
523
- * @internal
524
516
  */
525
517
  processCore(message, local, localOpMetadata) {
526
518
  if (message.type === MessageType.Operation) {
@@ -622,4 +614,4 @@ export class TaskManager extends SharedObject {
622
614
  // do nothing...
623
615
  }
624
616
  }
625
- //# sourceMappingURL=taskManager.js.map
617
+ //# sourceMappingURL=taskManager.mjs.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"taskManager.mjs","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/core-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 * @internal\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 */\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 */\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\tprotected initializeLocalCore() {}\n\n\t/**\n\t * {@inheritDoc @fluidframework/shared-object-base#SharedObject.onDisconnect}\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 */\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 */\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 */\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"]}
@@ -3,7 +3,7 @@
3
3
  * Licensed under the MIT License.
4
4
  */
5
5
  import { IChannelAttributes, IFluidDataStoreRuntime, IChannelServices, IChannelFactory } from "@fluidframework/datastore-definitions";
6
- import { ITaskManager } from "./interfaces";
6
+ import { ITaskManager } from "./interfaces.mjs";
7
7
  /**
8
8
  * The factory that defines the task queue
9
9
  */
@@ -1 +1 @@
1
- {"version":3,"file":"taskManagerFactory.d.ts","sourceRoot":"","sources":["../src/taskManagerFactory.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EACN,kBAAkB,EAClB,sBAAsB,EACtB,gBAAgB,EAChB,eAAe,EACf,MAAM,uCAAuC,CAAC;AAE/C,OAAO,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AAG5C;;GAEG;AACH,qBAAa,kBAAmB,YAAW,eAAe;IACzD,gBAAuB,IAAI,oDAAoD;IAE/E,gBAAuB,UAAU,EAAE,kBAAkB,CAInD;IAEF,IAAW,IAAI,WAEd;IAED,IAAW,UAAU,uBAEpB;IAED;;OAEG;IACU,IAAI,CAChB,OAAO,EAAE,sBAAsB,EAC/B,EAAE,EAAE,MAAM,EACV,QAAQ,EAAE,gBAAgB,EAC1B,UAAU,EAAE,kBAAkB,GAC5B,OAAO,CAAC,YAAY,CAAC;IAMjB,MAAM,CAAC,QAAQ,EAAE,sBAAsB,EAAE,EAAE,EAAE,MAAM,GAAG,YAAY;CAKzE"}
1
+ {"version":3,"file":"taskManagerFactory.d.ts","sourceRoot":"","sources":["../src/taskManagerFactory.ts"],"names":[],"mappings":"AAAA;;;GAGG;OAEI,EACN,kBAAkB,EAClB,sBAAsB,EACtB,gBAAgB,EAChB,eAAe,EACf,MAAM,uCAAuC;OAEvC,EAAE,YAAY,EAAE;AAGvB;;GAEG;AACH,qBAAa,kBAAmB,YAAW,eAAe;IACzD,gBAAuB,IAAI,oDAAoD;IAE/E,gBAAuB,UAAU,EAAE,kBAAkB,CAInD;IAEF,IAAW,IAAI,WAEd;IAED,IAAW,UAAU,uBAEpB;IAED;;OAEG;IACU,IAAI,CAChB,OAAO,EAAE,sBAAsB,EAC/B,EAAE,EAAE,MAAM,EACV,QAAQ,EAAE,gBAAgB,EAC1B,UAAU,EAAE,kBAAkB,GAC5B,OAAO,CAAC,YAAY,CAAC;IAMjB,MAAM,CAAC,QAAQ,EAAE,sBAAsB,EAAE,EAAE,EAAE,MAAM,GAAG,YAAY;CAKzE"}
@@ -2,8 +2,8 @@
2
2
  * Copyright (c) Microsoft Corporation and contributors. All rights reserved.
3
3
  * Licensed under the MIT License.
4
4
  */
5
- import { TaskManager } from "./taskManager";
6
- import { pkgVersion } from "./packageVersion";
5
+ import { TaskManager } from "./taskManager.mjs";
6
+ import { pkgVersion } from "./packageVersion.mjs";
7
7
  /**
8
8
  * The factory that defines the task queue
9
9
  */
@@ -34,4 +34,4 @@ TaskManagerFactory.Attributes = {
34
34
  snapshotFormatVersion: "0.1",
35
35
  packageVersion: pkgVersion,
36
36
  };
37
- //# sourceMappingURL=taskManagerFactory.js.map
37
+ //# sourceMappingURL=taskManagerFactory.mjs.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"taskManagerFactory.mjs","sourceRoot":"","sources":["../src/taskManagerFactory.ts"],"names":[],"mappings":"AAAA;;;GAGG;OAQI,EAAE,WAAW,EAAE;OAEf,EAAE,UAAU,EAAE;AAErB;;GAEG;AACH,MAAM,OAAO,kBAAkB;IAS9B,IAAW,IAAI;QACd,OAAO,kBAAkB,CAAC,IAAI,CAAC;IAChC,CAAC;IAED,IAAW,UAAU;QACpB,OAAO,kBAAkB,CAAC,UAAU,CAAC;IACtC,CAAC;IAED;;OAEG;IACI,KAAK,CAAC,IAAI,CAChB,OAA+B,EAC/B,EAAU,EACV,QAA0B,EAC1B,UAA8B;QAE9B,MAAM,SAAS,GAAG,IAAI,WAAW,CAAC,EAAE,EAAE,OAAO,EAAE,UAAU,CAAC,CAAC;QAC3D,MAAM,SAAS,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;QAC/B,OAAO,SAAS,CAAC;IAClB,CAAC;IAEM,MAAM,CAAC,QAAgC,EAAE,EAAU;QACzD,MAAM,SAAS,GAAG,IAAI,WAAW,CAAC,EAAE,EAAE,QAAQ,EAAE,IAAI,CAAC,UAAU,CAAC,CAAC;QACjE,SAAS,CAAC,eAAe,EAAE,CAAC;QAC5B,OAAO,SAAS,CAAC;IAClB,CAAC;;AAlCsB,uBAAI,GAAG,gDAAgD,CAAC;AAExD,6BAAU,GAAuB;IACvD,IAAI,EAAE,kBAAkB,CAAC,IAAI;IAC7B,qBAAqB,EAAE,KAAK;IAC5B,cAAc,EAAE,UAAU;CAC1B,CAAC","sourcesContent":["/*!\n * Copyright (c) Microsoft Corporation and contributors. All rights reserved.\n * Licensed under the MIT License.\n */\n\nimport {\n\tIChannelAttributes,\n\tIFluidDataStoreRuntime,\n\tIChannelServices,\n\tIChannelFactory,\n} from \"@fluidframework/datastore-definitions\";\nimport { TaskManager } from \"./taskManager\";\nimport { ITaskManager } from \"./interfaces\";\nimport { pkgVersion } from \"./packageVersion\";\n\n/**\n * The factory that defines the task queue\n */\nexport class TaskManagerFactory implements IChannelFactory {\n\tpublic static readonly Type = \"https://graph.microsoft.com/types/task-manager\";\n\n\tpublic static readonly Attributes: IChannelAttributes = {\n\t\ttype: TaskManagerFactory.Type,\n\t\tsnapshotFormatVersion: \"0.1\",\n\t\tpackageVersion: pkgVersion,\n\t};\n\n\tpublic get type() {\n\t\treturn TaskManagerFactory.Type;\n\t}\n\n\tpublic get attributes() {\n\t\treturn TaskManagerFactory.Attributes;\n\t}\n\n\t/**\n\t * {@inheritDoc @fluidframework/datastore-definitions#IChannelFactory.load}\n\t */\n\tpublic async load(\n\t\truntime: IFluidDataStoreRuntime,\n\t\tid: string,\n\t\tservices: IChannelServices,\n\t\tattributes: IChannelAttributes,\n\t): Promise<ITaskManager> {\n\t\tconst taskQueue = new TaskManager(id, runtime, attributes);\n\t\tawait taskQueue.load(services);\n\t\treturn taskQueue;\n\t}\n\n\tpublic create(document: IFluidDataStoreRuntime, id: string): ITaskManager {\n\t\tconst taskQueue = new TaskManager(id, document, this.attributes);\n\t\ttaskQueue.initializeLocal();\n\t\treturn taskQueue;\n\t}\n}\n"]}