@dxos/async 0.5.0 → 0.5.1-main.0ec204c

package/dist/lib/node/meta.json

@@ -1 +1 @@
-{"inputs":{"packages/common/async/src/callback.ts":{"bytes":1550,"imports":[],"format":"esm"},"packages/common/async/src/chain.ts":{"bytes":1661,"imports":[],"format":"esm"},"packages/common/async/src/debounce.ts":{"bytes":1235,"imports":[],"format":"esm"},"packages/common/async/src/errors.ts":{"bytes":2956,"imports":[],"format":"esm"},"packages/common/async/src/timeout.ts":{"bytes":7402,"imports":[{"path":"@dxos/context","kind":"import-statement","external":true},{"path":"packages/common/async/src/callback.ts","kind":"import-statement","original":"./callback"},{"path":"packages/common/async/src/errors.ts","kind":"import-statement","original":"./errors"}],"format":"esm"},"packages/common/async/src/event-emitter.ts":{"bytes":4168,"imports":[{"path":"packages/common/async/src/timeout.ts","kind":"import-statement","original":"./timeout"}],"format":"esm"},"packages/common/async/src/events.ts":{"bytes":34729,"imports":[{"path":"@dxos/context","kind":"import-statement","external":true}],"format":"esm"},"packages/common/async/src/latch.ts":{"bytes":4311,"imports":[{"path":"@dxos/invariant","kind":"import-statement","external":true}],"format":"esm"},"packages/common/async/src/trigger.ts":{"bytes":7611,"imports":[{"path":"packages/common/async/src/errors.ts","kind":"import-statement","original":"./errors"},{"path":"packages/common/async/src/timeout.ts","kind":"import-statement","original":"./timeout"}],"format":"esm"},"packages/common/async/src/observable.ts":{"bytes":17867,"imports":[{"path":"zen-observable","kind":"import-statement","external":true},{"path":"zen-push","kind":"import-statement","external":true},{"path":"packages/common/async/src/trigger.ts","kind":"import-statement","original":"./trigger"}],"format":"esm"},"packages/common/async/src/observable-value.ts":{"bytes":6522,"imports":[{"path":"@dxos/util","kind":"import-statement","external":true}],"format":"esm"},"packages/common/async/src/mutex.ts":{"bytes":12151,"imports":[{"path":"@dxos/debug","kind":"import-statement","external":true},{"path":"@dxos/util","kind":"import-statement","external":true}],"format":"esm"},"packages/common/async/src/sink.ts":{"bytes":2003,"imports":[{"path":"packages/common/async/src/trigger.ts","kind":"import-statement","original":"./trigger"}],"format":"esm"},"packages/common/async/src/stream-to-array.ts":{"bytes":4948,"imports":[],"format":"esm"},"packages/common/async/src/timer.ts":{"bytes":5962,"imports":[{"path":"packages/common/async/src/events.ts","kind":"import-statement","original":"./events"}],"format":"esm"},"packages/common/async/src/testing.ts":{"bytes":4680,"imports":[{"path":"packages/common/async/src/timeout.ts","kind":"import-statement","original":"./timeout"},{"path":"packages/common/async/src/trigger.ts","kind":"import-statement","original":"./trigger"}],"format":"esm"},"packages/common/async/src/types.ts":{"bytes":485,"imports":[],"format":"esm"},"packages/common/async/src/until.ts":{"bytes":4324,"imports":[],"format":"esm"},"packages/common/async/src/track-leaks.ts":{"bytes":8435,"imports":[{"path":"@dxos/debug","kind":"import-statement","external":true},{"path":"@dxos/log","kind":"import-statement","external":true}],"format":"esm"},"packages/common/async/src/task-scheduling.ts":{"bytes":12298,"imports":[{"path":"@dxos/debug","kind":"import-statement","external":true},{"path":"packages/common/async/src/track-leaks.ts","kind":"import-statement","original":"./track-leaks"}],"format":"esm"},"packages/common/async/src/test-stream.ts":{"bytes":5011,"imports":[{"path":"node:stream","kind":"import-statement","external":true},{"path":"packages/common/async/src/events.ts","kind":"import-statement","original":"./events"},{"path":"packages/common/async/src/timeout.ts","kind":"import-statement","original":"./timeout"}],"format":"esm"},"packages/common/async/src/update-scheduler.ts":{"bytes":8352,"imports":[{"path":"packages/common/async/src/task-scheduling.ts","kind":"import-statement","original":"./task-scheduling"}],"format":"esm"},"packages/common/async/src/index.ts":{"bytes":2363,"imports":[{"path":"packages/common/async/src/callback.ts","kind":"import-statement","original":"./callback"},{"path":"packages/common/async/src/chain.ts","kind":"import-statement","original":"./chain"},{"path":"packages/common/async/src/debounce.ts","kind":"import-statement","original":"./debounce"},{"path":"packages/common/async/src/errors.ts","kind":"import-statement","original":"./errors"},{"path":"packages/common/async/src/event-emitter.ts","kind":"import-statement","original":"./event-emitter"},{"path":"packages/common/async/src/events.ts","kind":"import-statement","original":"./events"},{"path":"packages/common/async/src/latch.ts","kind":"import-statement","original":"./latch"},{"path":"packages/common/async/src/observable.ts","kind":"import-statement","original":"./observable"},{"path":"packages/common/async/src/observable-value.ts","kind":"import-statement","original":"./observable-value"},{"path":"packages/common/async/src/mutex.ts","kind":"import-statement","original":"./mutex"},{"path":"packages/common/async/src/sink.ts","kind":"import-statement","original":"./sink"},{"path":"packages/common/async/src/stream-to-array.ts","kind":"import-statement","original":"./stream-to-array"},{"path":"packages/common/async/src/timeout.ts","kind":"import-statement","original":"./timeout"},{"path":"packages/common/async/src/timer.ts","kind":"import-statement","original":"./timer"},{"path":"packages/common/async/src/testing.ts","kind":"import-statement","original":"./testing"},{"path":"packages/common/async/src/trigger.ts","kind":"import-statement","original":"./trigger"},{"path":"packages/common/async/src/types.ts","kind":"import-statement","original":"./types"},{"path":"packages/common/async/src/until.ts","kind":"import-statement","original":"./until"},{"path":"packages/common/async/src/task-scheduling.ts","kind":"import-statement","original":"./task-scheduling"},{"path":"packages/common/async/src/test-stream.ts","kind":"import-statement","original":"./test-stream"},{"path":"packages/common/async/src/track-leaks.ts","kind":"import-statement","original":"./track-leaks"},{"path":"packages/common/async/src/update-scheduler.ts","kind":"import-statement","original":"./update-scheduler"}],"format":"esm"}},"outputs":{"packages/common/async/dist/lib/node/index.cjs.map":{"imports":[],"exports":[],"inputs":{},"bytes":79242},"packages/common/async/dist/lib/node/index.cjs":{"imports":[{"path":"@dxos/context","kind":"import-statement","external":true},{"path":"@dxos/context","kind":"import-statement","external":true},{"path":"@dxos/invariant","kind":"import-statement","external":true},{"path":"zen-observable","kind":"import-statement","external":true},{"path":"zen-push","kind":"import-statement","external":true},{"path":"@dxos/util","kind":"import-statement","external":true},{"path":"@dxos/debug","kind":"import-statement","external":true},{"path":"@dxos/util","kind":"import-statement","external":true},{"path":"@dxos/debug","kind":"import-statement","external":true},{"path":"@dxos/debug","kind":"import-statement","external":true},{"path":"@dxos/log","kind":"import-statement","external":true},{"path":"node:stream","kind":"import-statement","external":true}],"exports":["CancellableObservableProvider","DeferredTask","Event","EventSubscriptions","MulticastObservable","Mutex","MutexGuard","Observable","ObservableProvider","PushStream","TestStream","TimeoutError","Timer","Trigger","UpdateScheduler","addListener","asyncChain","asyncTimeout","createPromiseFromCallback","debounce","dumpLeaks","latch","observableError","onEvent","runInContext","runInContextAsync","scheduleExponentialBackoffTaskInterval","scheduleMicroTask","scheduleTask","scheduleTaskInterval","sink","sleep","sleepWithContext","streamToArray","synchronized","toError","trackLeaks","trackResource","trigger","unrefTimeout","until","untilError","untilPromise","waitForCondition","waitForEvent"],"entryPoint":"packages/common/async/src/index.ts","inputs":{"packages/common/async/src/callback.ts":{"bytesInOutput":191},"packages/common/async/src/index.ts":{"bytesInOutput":0},"packages/common/async/src/chain.ts":{"bytesInOutput":219},"packages/common/async/src/debounce.ts":{"bytesInOutput":144},"packages/common/async/src/errors.ts":{"bytesInOutput":473},"packages/common/async/src/timeout.ts":{"bytesInOutput":1453},"packages/common/async/src/event-emitter.ts":{"bytesInOutput":694},"packages/common/async/src/events.ts":{"bytesInOutput":7419},"packages/common/async/src/latch.ts":{"bytesInOutput":968},"packages/common/async/src/observable.ts":{"bytesInOutput":3695},"packages/common/async/src/trigger.ts":{"bytesInOutput":1287},"packages/common/async/src/observable-value.ts":{"bytesInOutput":975},"packages/common/async/src/mutex.ts":{"bytesInOutput":2310},"packages/common/async/src/sink.ts":{"bytesInOutput":285},"packages/common/async/src/stream-to-array.ts":{"bytesInOutput":967},"packages/common/async/src/timer.ts":{"bytesInOutput":1054},"packages/common/async/src/testing.ts":{"bytesInOutput":587},"packages/common/async/src/until.ts":{"bytesInOutput":760},"packages/common/async/src/task-scheduling.ts":{"bytesInOutput":2385},"packages/common/async/src/track-leaks.ts":{"bytesInOutput":2149},"packages/common/async/src/test-stream.ts":{"bytesInOutput":925},"packages/common/async/src/update-scheduler.ts":{"bytesInOutput":1516}},"bytes":32230}}}
+{"inputs":{"packages/common/async/src/callback.ts":{"bytes":1550,"imports":[],"format":"esm"},"packages/common/async/src/chain.ts":{"bytes":1661,"imports":[],"format":"esm"},"packages/common/async/src/debounce.ts":{"bytes":1235,"imports":[],"format":"esm"},"packages/common/async/src/errors.ts":{"bytes":2956,"imports":[],"format":"esm"},"packages/common/async/src/timeout.ts":{"bytes":7402,"imports":[{"path":"@dxos/context","kind":"import-statement","external":true},{"path":"packages/common/async/src/callback.ts","kind":"import-statement","original":"./callback"},{"path":"packages/common/async/src/errors.ts","kind":"import-statement","original":"./errors"}],"format":"esm"},"packages/common/async/src/event-emitter.ts":{"bytes":4168,"imports":[{"path":"packages/common/async/src/timeout.ts","kind":"import-statement","original":"./timeout"}],"format":"esm"},"packages/common/async/src/events.ts":{"bytes":34729,"imports":[{"path":"@dxos/context","kind":"import-statement","external":true}],"format":"esm"},"packages/common/async/src/latch.ts":{"bytes":4311,"imports":[{"path":"@dxos/invariant","kind":"import-statement","external":true}],"format":"esm"},"packages/common/async/src/trigger.ts":{"bytes":8304,"imports":[{"path":"packages/common/async/src/errors.ts","kind":"import-statement","original":"./errors"},{"path":"packages/common/async/src/timeout.ts","kind":"import-statement","original":"./timeout"}],"format":"esm"},"packages/common/async/src/observable.ts":{"bytes":17867,"imports":[{"path":"zen-observable","kind":"import-statement","external":true},{"path":"zen-push","kind":"import-statement","external":true},{"path":"packages/common/async/src/trigger.ts","kind":"import-statement","original":"./trigger"}],"format":"esm"},"packages/common/async/src/observable-value.ts":{"bytes":6522,"imports":[{"path":"@dxos/util","kind":"import-statement","external":true}],"format":"esm"},"packages/common/async/src/mutex.ts":{"bytes":12684,"imports":[{"path":"@dxos/util","kind":"import-statement","external":true},{"path":"@dxos/debug","kind":"import-statement","external":true}],"format":"esm"},"packages/common/async/src/sink.ts":{"bytes":2003,"imports":[{"path":"packages/common/async/src/trigger.ts","kind":"import-statement","original":"./trigger"}],"format":"esm"},"packages/common/async/src/stream-to-array.ts":{"bytes":4948,"imports":[],"format":"esm"},"packages/common/async/src/timer.ts":{"bytes":5962,"imports":[{"path":"packages/common/async/src/events.ts","kind":"import-statement","original":"./events"}],"format":"esm"},"packages/common/async/src/testing.ts":{"bytes":4680,"imports":[{"path":"packages/common/async/src/timeout.ts","kind":"import-statement","original":"./timeout"},{"path":"packages/common/async/src/trigger.ts","kind":"import-statement","original":"./trigger"}],"format":"esm"},"packages/common/async/src/types.ts":{"bytes":485,"imports":[],"format":"esm"},"packages/common/async/src/until.ts":{"bytes":4324,"imports":[],"format":"esm"},"packages/common/async/src/track-leaks.ts":{"bytes":8435,"imports":[{"path":"@dxos/debug","kind":"import-statement","external":true},{"path":"@dxos/log","kind":"import-statement","external":true}],"format":"esm"},"packages/common/async/src/task-scheduling.ts":{"bytes":15196,"imports":[{"path":"@dxos/context","kind":"import-statement","external":true},{"path":"@dxos/debug","kind":"import-statement","external":true},{"path":"packages/common/async/src/track-leaks.ts","kind":"import-statement","original":"./track-leaks"},{"path":"packages/common/async/src/trigger.ts","kind":"import-statement","original":"./trigger"}],"format":"esm"},"packages/common/async/src/test-stream.ts":{"bytes":5011,"imports":[{"path":"node:stream","kind":"import-statement","external":true},{"path":"packages/common/async/src/events.ts","kind":"import-statement","original":"./events"},{"path":"packages/common/async/src/timeout.ts","kind":"import-statement","original":"./timeout"}],"format":"esm"},"packages/common/async/src/update-scheduler.ts":{"bytes":8352,"imports":[{"path":"packages/common/async/src/task-scheduling.ts","kind":"import-statement","original":"./task-scheduling"}],"format":"esm"},"packages/common/async/src/index.ts":{"bytes":2363,"imports":[{"path":"packages/common/async/src/callback.ts","kind":"import-statement","original":"./callback"},{"path":"packages/common/async/src/chain.ts","kind":"import-statement","original":"./chain"},{"path":"packages/common/async/src/debounce.ts","kind":"import-statement","original":"./debounce"},{"path":"packages/common/async/src/errors.ts","kind":"import-statement","original":"./errors"},{"path":"packages/common/async/src/event-emitter.ts","kind":"import-statement","original":"./event-emitter"},{"path":"packages/common/async/src/events.ts","kind":"import-statement","original":"./events"},{"path":"packages/common/async/src/latch.ts","kind":"import-statement","original":"./latch"},{"path":"packages/common/async/src/observable.ts","kind":"import-statement","original":"./observable"},{"path":"packages/common/async/src/observable-value.ts","kind":"import-statement","original":"./observable-value"},{"path":"packages/common/async/src/mutex.ts","kind":"import-statement","original":"./mutex"},{"path":"packages/common/async/src/sink.ts","kind":"import-statement","original":"./sink"},{"path":"packages/common/async/src/stream-to-array.ts","kind":"import-statement","original":"./stream-to-array"},{"path":"packages/common/async/src/timeout.ts","kind":"import-statement","original":"./timeout"},{"path":"packages/common/async/src/timer.ts","kind":"import-statement","original":"./timer"},{"path":"packages/common/async/src/testing.ts","kind":"import-statement","original":"./testing"},{"path":"packages/common/async/src/trigger.ts","kind":"import-statement","original":"./trigger"},{"path":"packages/common/async/src/types.ts","kind":"import-statement","original":"./types"},{"path":"packages/common/async/src/until.ts","kind":"import-statement","original":"./until"},{"path":"packages/common/async/src/task-scheduling.ts","kind":"import-statement","original":"./task-scheduling"},{"path":"packages/common/async/src/test-stream.ts","kind":"import-statement","original":"./test-stream"},{"path":"packages/common/async/src/track-leaks.ts","kind":"import-statement","original":"./track-leaks"},{"path":"packages/common/async/src/update-scheduler.ts","kind":"import-statement","original":"./update-scheduler"}],"format":"esm"}},"outputs":{"packages/common/async/dist/lib/node/index.cjs.map":{"imports":[],"exports":[],"inputs":{},"bytes":81160},"packages/common/async/dist/lib/node/index.cjs":{"imports":[{"path":"@dxos/context","kind":"import-statement","external":true},{"path":"@dxos/context","kind":"import-statement","external":true},{"path":"@dxos/invariant","kind":"import-statement","external":true},{"path":"zen-observable","kind":"import-statement","external":true},{"path":"zen-push","kind":"import-statement","external":true},{"path":"@dxos/util","kind":"import-statement","external":true},{"path":"@dxos/util","kind":"import-statement","external":true},{"path":"@dxos/debug","kind":"import-statement","external":true},{"path":"@dxos/context","kind":"import-statement","external":true},{"path":"@dxos/debug","kind":"import-statement","external":true},{"path":"@dxos/debug","kind":"import-statement","external":true},{"path":"@dxos/log","kind":"import-statement","external":true},{"path":"node:stream","kind":"import-statement","external":true}],"exports":["CancellableObservableProvider","DeferredTask","Event","EventSubscriptions","MulticastObservable","Mutex","MutexGuard","Observable","ObservableProvider","PushStream","TestStream","TimeoutError","Timer","Trigger","UpdateScheduler","addListener","asyncChain","asyncTimeout","createPromiseFromCallback","debounce","dumpLeaks","latch","observableError","onEvent","runInContext","runInContextAsync","scheduleExponentialBackoffTaskInterval","scheduleMicroTask","scheduleTask","scheduleTaskInterval","sink","sleep","sleepWithContext","streamToArray","synchronized","toError","trackLeaks","trackResource","trigger","unrefTimeout","until","untilError","untilPromise","waitForCondition","waitForEvent"],"entryPoint":"packages/common/async/src/index.ts","inputs":{"packages/common/async/src/callback.ts":{"bytesInOutput":191},"packages/common/async/src/index.ts":{"bytesInOutput":0},"packages/common/async/src/chain.ts":{"bytesInOutput":219},"packages/common/async/src/debounce.ts":{"bytesInOutput":144},"packages/common/async/src/errors.ts":{"bytesInOutput":473},"packages/common/async/src/timeout.ts":{"bytesInOutput":1453},"packages/common/async/src/event-emitter.ts":{"bytesInOutput":694},"packages/common/async/src/events.ts":{"bytesInOutput":7419},"packages/common/async/src/latch.ts":{"bytesInOutput":968},"packages/common/async/src/observable.ts":{"bytesInOutput":3695},"packages/common/async/src/trigger.ts":{"bytesInOutput":1446},"packages/common/async/src/observable-value.ts":{"bytesInOutput":975},"packages/common/async/src/mutex.ts":{"bytesInOutput":2444},"packages/common/async/src/sink.ts":{"bytesInOutput":285},"packages/common/async/src/stream-to-array.ts":{"bytesInOutput":967},"packages/common/async/src/timer.ts":{"bytesInOutput":1054},"packages/common/async/src/testing.ts":{"bytesInOutput":587},"packages/common/async/src/until.ts":{"bytesInOutput":760},"packages/common/async/src/task-scheduling.ts":{"bytesInOutput":3090},"packages/common/async/src/track-leaks.ts":{"bytesInOutput":2149},"packages/common/async/src/test-stream.ts":{"bytesInOutput":925},"packages/common/async/src/update-scheduler.ts":{"bytesInOutput":1516}},"bytes":33228}}}

package/dist/types/src/mutex.d.ts

@@ -17,8 +17,10 @@ import '@dxos/util';
  */
 export declare class Mutex {
     private _queue;
+    private _queueLength;
     private _tag;
     get tag(): string | null;
+    isLocked(): boolean;
     /**
      * Acquires the lock.
      * Caller is responsible for releasing the lock using the returned callback.

package/dist/types/src/mutex.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"mutex.d.ts","sourceRoot":"","sources":["../../../src/mutex.ts"],"names":[],"mappings":"AAOA,OAAO,YAAY,CAAC;AAEpB;;;;;;;;;;;;;;;GAeG;AACH,qBAAa,KAAK;IAChB,OAAO,CAAC,MAAM,CAAqB;IAEnC,OAAO,CAAC,IAAI,CAAuB;IAEnC,IAAI,GAAG,kBAEN;IAED;;;;;OAKG;IACG,OAAO,CAAC,GAAG,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,CAAC;IAoBhD;;;;;OAKG;IACG,mBAAmB,CAAC,CAAC,EAAE,GAAG,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC;CAShE;AAED,qBAAa,UAAU;IACT,OAAO,CAAC,QAAQ,CAAC,QAAQ;gBAAR,QAAQ,EAAE,MAAM,IAAI;IAEjD;;OAEG;IACH,OAAO,IAAI,IAAI;IAIf,CAAC,MAAM,CAAC,OAAO,CAAC,IAAI,IAAI;CAGzB;AAaD;;;;GAIG;AACH,eAAO,MAAM,YAAY,WACf,GAAG,gBACG,MAAM,gDAC0B,GAAG,KAAK,GAAG,UAuB1D,CAAC"}
+{"version":3,"file":"mutex.d.ts","sourceRoot":"","sources":["../../../src/mutex.ts"],"names":[],"mappings":"AAKA,OAAO,YAAY,CAAC;AAGpB;;;;;;;;;;;;;;;GAeG;AACH,qBAAa,KAAK;IAChB,OAAO,CAAC,MAAM,CAAqB;IACnC,OAAO,CAAC,YAAY,CAAK;IAEzB,OAAO,CAAC,IAAI,CAAuB;IAEnC,IAAI,GAAG,kBAEN;IAED,QAAQ,IAAI,OAAO;IAInB;;;;;OAKG;IACG,OAAO,CAAC,GAAG,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,CAAC;IAsBhD;;;;;OAKG;IACG,mBAAmB,CAAC,CAAC,EAAE,GAAG,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC;CAShE;AAED,qBAAa,UAAU;IACT,OAAO,CAAC,QAAQ,CAAC,QAAQ;gBAAR,QAAQ,EAAE,MAAM,IAAI;IAEjD;;OAEG;IACH,OAAO,IAAI,IAAI;IAIf,CAAC,MAAM,CAAC,OAAO,CAAC,IAAI,IAAI;CAGzB;AAaD;;;;GAIG;AACH,eAAO,MAAM,YAAY,WACf,GAAG,gBACG,MAAM,gDAC0B,GAAG,KAAK,GAAG,UAuB1D,CAAC"}

package/dist/types/src/task-scheduling.d.ts

@@ -10,9 +10,22 @@ export declare class DeferredTask {
     private readonly _ctx;
     private readonly _callback;
     private _scheduled;
-    private _promise;
+    private _currentTask;
+    private _nextTask;
     constructor(_ctx: Context, _callback: () => Promise<void>);
+    /**
+     * Schedule the task to run asynchronously.
+     */
     schedule(): void;
+    /**
+     * Schedule the task to run and wait for it to finish.
+     */
+    runBlocking(): Promise<void>;
+    /**
+     * Waits for the current task to finish if it is running.
+     * Does not schedule a new task.
+     */
+    join(): Promise<void>;
 }
 export declare const runInContext: (ctx: Context, fn: () => void) => void;
 export declare const runInContextAsync: (ctx: Context, fn: () => MaybePromise<void>) => Promise<void>;

package/dist/types/src/task-scheduling.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"task-scheduling.d.ts","sourceRoot":"","sources":["../../../src/task-scheduling.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,KAAK,OAAO,EAAE,MAAM,eAAe,CAAC;AAE7C,OAAO,EAAE,KAAK,YAAY,EAAE,MAAM,YAAY,CAAC;AAI/C,MAAM,MAAM,aAAa,GAAG,MAAM,IAAI,CAAC;AAEvC;;;;GAIG;AACH,qBAAa,YAAY;IAKrB,OAAO,CAAC,QAAQ,CAAC,IAAI;IACrB,OAAO,CAAC,QAAQ,CAAC,SAAS;IAL5B,OAAO,CAAC,UAAU,CAAS;IAC3B,OAAO,CAAC,QAAQ,CAA8B;gBAG3B,IAAI,EAAE,OAAO,EACb,SAAS,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC;IAGjD,QAAQ;CAkBT;AAED,eAAO,MAAM,YAAY,QAAS,OAAO,MAAM,MAAM,IAAI,SAMxD,CAAC;AAEF,eAAO,MAAM,iBAAiB,QAAe,OAAO,MAAM,MAAM,aAAa,IAAI,CAAC,kBAMjF,CAAC;AAEF,eAAO,MAAM,iBAAiB,QAAS,OAAO,MAAM,MAAM,aAAa,IAAI,CAAC,SAO3E,CAAC;AAEF,eAAO,MAAM,YAAY,QAAS,OAAO,MAAM,MAAM,aAAa,IAAI,CAAC,YAAY,MAAM,SAgBxF,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,oBAAoB,QAAS,OAAO,QAAQ,MAAM,QAAQ,IAAI,CAAC,YAAY,MAAM,SAqB7F,CAAC;AAEF,eAAO,MAAM,sCAAsC,QAC5C,OAAO,QACN,MAAM,QAAQ,IAAI,CAAC,mBACR,MAAM,SAwBxB,CAAC"}
+{"version":3,"file":"task-scheduling.d.ts","sourceRoot":"","sources":["../../../src/task-scheduling.ts"],"names":[],"mappings":"AAIA,OAAO,EAAwB,KAAK,OAAO,EAAE,MAAM,eAAe,CAAC;AAEnE,OAAO,EAAE,KAAK,YAAY,EAAE,MAAM,YAAY,CAAC;AAK/C,MAAM,MAAM,aAAa,GAAG,MAAM,IAAI,CAAC;AAEvC;;;;GAIG;AAEH,qBAAa,YAAY;IAMrB,OAAO,CAAC,QAAQ,CAAC,IAAI;IACrB,OAAO,CAAC,QAAQ,CAAC,SAAS;IAN5B,OAAO,CAAC,UAAU,CAAS;IAC3B,OAAO,CAAC,YAAY,CAA8B;IAClD,OAAO,CAAC,SAAS,CAAiB;gBAGf,IAAI,EAAE,OAAO,EACb,SAAS,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC;IAGjD;;OAEG;IACH,QAAQ;IAuBR;;OAEG;IACG,WAAW;IAQjB;;;OAGG;IACG,IAAI;CAGX;AAED,eAAO,MAAM,YAAY,QAAS,OAAO,MAAM,MAAM,IAAI,SAMxD,CAAC;AAEF,eAAO,MAAM,iBAAiB,QAAe,OAAO,MAAM,MAAM,aAAa,IAAI,CAAC,kBAMjF,CAAC;AAEF,eAAO,MAAM,iBAAiB,QAAS,OAAO,MAAM,MAAM,aAAa,IAAI,CAAC,SAO3E,CAAC;AAEF,eAAO,MAAM,YAAY,QAAS,OAAO,MAAM,MAAM,aAAa,IAAI,CAAC,YAAY,MAAM,SAgBxF,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,oBAAoB,QAAS,OAAO,QAAQ,MAAM,QAAQ,IAAI,CAAC,YAAY,MAAM,SAqB7F,CAAC;AAEF,eAAO,MAAM,sCAAsC,QAC5C,OAAO,QACN,MAAM,QAAQ,IAAI,CAAC,mBACR,MAAM,SAwBxB,CAAC"}

package/dist/types/src/trigger.d.ts

@@ -19,7 +19,8 @@ export type TriggerOptions = {
 export declare class Trigger<T = void> {
     private _options;
     private _promise;
-    private _wake;
+    private _resolve;
+    private _reject;
     constructor(_options?: TriggerOptions);
     /**
      * Wait until wake is called, with optional timeout.
@@ -29,6 +30,7 @@ export declare class Trigger<T = void> {
     }): Promise<T>;
     /**
      * Wake blocked callers (if any).
+     * NOOP if the trigger is already resolved.
      */
     wake(value: T): this;
     /**
@@ -37,6 +39,7 @@ export declare class Trigger<T = void> {
     reset(): this;
     /**
      * Throw error to blocked callers (if any).
+     * NOOP if the trigger is already resolved.
      */
     throw(error: Error): this;
 }

package/dist/types/src/trigger.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"trigger.d.ts","sourceRoot":"","sources":["../../../src/trigger.ts"],"names":[],"mappings":"AAOA;;;GAGG;AACH,eAAO,MAAM,OAAO,uBAAwB,MAAM,oCAAkC,IAAI,CAgBvF,CAAC;AAEF,MAAM,MAAM,cAAc,GAAG;IAC3B,SAAS,EAAE,OAAO,CAAC;CACpB,CAAC;AAEF;;;;;;;;;GASG;AACH,qBAAa,OAAO,CAAC,CAAC,GAAG,IAAI;IAIf,OAAO,CAAC,QAAQ;IAH5B,OAAO,CAAC,QAAQ,CAAc;IAC9B,OAAO,CAAC,KAAK,CAAuC;gBAEhC,QAAQ,GAAE,cAAqC;IAInE;;OAEG;IACG,IAAI,CAAC,EAAE,OAAO,EAAE,GAAE;QAAE,OAAO,CAAC,EAAE,MAAM,CAAA;KAAO,GAAG,OAAO,CAAC,CAAC,CAAC;IAQ9D;;OAEG;IACH,IAAI,CAAC,KAAK,EAAE,CAAC;IASb;;OAEG;IACH,KAAK;IAQL;;OAEG;IACH,KAAK,CAAC,KAAK,EAAE,KAAK;CAQnB"}
+{"version":3,"file":"trigger.d.ts","sourceRoot":"","sources":["../../../src/trigger.ts"],"names":[],"mappings":"AAOA;;;GAGG;AACH,eAAO,MAAM,OAAO,uBAAwB,MAAM,oCAAkC,IAAI,CAgBvF,CAAC;AAEF,MAAM,MAAM,cAAc,GAAG;IAC3B,SAAS,EAAE,OAAO,CAAC;CACpB,CAAC;AAEF;;;;;;;;;GASG;AACH,qBAAa,OAAO,CAAC,CAAC,GAAG,IAAI;IAKf,OAAO,CAAC,QAAQ;IAJ5B,OAAO,CAAC,QAAQ,CAAc;IAC9B,OAAO,CAAC,QAAQ,CAAuC;IACvD,OAAO,CAAC,OAAO,CAA0B;gBAErB,QAAQ,GAAE,cAAqC;IAInE;;OAEG;IACG,IAAI,CAAC,EAAE,OAAO,EAAE,GAAE;QAAE,OAAO,CAAC,EAAE,MAAM,CAAA;KAAO,GAAG,OAAO,CAAC,CAAC,CAAC;IAQ9D;;;OAGG;IACH,IAAI,CAAC,KAAK,EAAE,CAAC;IASb;;OAEG;IACH,KAAK;IAUL;;;OAGG;IACH,KAAK,CAAC,KAAK,EAAE,KAAK;CAQnB"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@dxos/async",
-  "version": "0.5.0",
+  "version": "0.5.1-main.0ec204c",
   "description": "Async utilities.",
   "homepage": "https://dxos.org",
   "bugs": "https://github.com/dxos/dxos/issues",
@@ -18,12 +18,12 @@
   "dependencies": {
     "zen-observable": "^0.10.0",
     "zen-push": "^0.3.1",
-    "@dxos/context": "0.5.0",
-    "@dxos/debug": "0.5.0",
-    "@dxos/log": "0.5.0",
-    "@dxos/invariant": "0.5.0",
-    "@dxos/node-std": "0.5.0",
-    "@dxos/util": "0.5.0"
+    "@dxos/invariant": "0.5.1-main.0ec204c",
+    "@dxos/context": "0.5.1-main.0ec204c",
+    "@dxos/log": "0.5.1-main.0ec204c",
+    "@dxos/debug": "0.5.1-main.0ec204c",
+    "@dxos/node-std": "0.5.1-main.0ec204c",
+    "@dxos/util": "0.5.1-main.0ec204c"
   },
   "devDependencies": {
     "@types/zen-observable": "^0.8.3"

package/src/mutex.ts

@@ -2,10 +2,9 @@
 // Copyright 2020 DXOS.org
 //
 
-import { warnAfterTimeout } from '@dxos/debug';
-
 // Import explicit resource management polyfill.
 import '@dxos/util';
+import { warnAfterTimeout } from '@dxos/debug';
 
 /**
  * A locking mechanism to ensure that a given section of the code is executed by only one single "thread" at a time.
@@ -25,6 +24,7 @@ import '@dxos/util';
  */
 export class Mutex {
   private _queue = Promise.resolve();
+  private _queueLength = 0;
 
   private _tag: string | null = null;
 
@@ -32,6 +32,10 @@ export class Mutex {
     return this._tag;
   }
 
+  isLocked(): boolean {
+    return this._queueLength > 0;
+  }
+
   /**
    * Acquires the lock.
    * Caller is responsible for releasing the lock using the returned callback.
@@ -43,8 +47,10 @@ export class Mutex {
 
     // Immediately update the promise before invoking any async actions so that next invocation waits for our task to complete.
     let guard!: MutexGuard;
+    this._queueLength++;
     this._queue = new Promise((resolve) => {
       guard = new MutexGuard(() => {
+        this._queueLength--;
         this._tag = null;
         resolve();
       });

package/src/task-scheduling.test.ts

@@ -8,7 +8,7 @@ import waitForExpect from 'wait-for-expect';
 import { Context } from '@dxos/context';
 import { describe, test } from '@dxos/test';
 
-import { scheduleTask } from './task-scheduling';
+import { DeferredTask, scheduleTask } from './task-scheduling';
 import { sleep } from './timeout';
 
 describe('task-scheduling', () => {
@@ -43,5 +43,28 @@ describe('task-scheduling', () => {
       await sleep(2);
       expect(called).to.be.false;
     });
+
+    test('run blocking', async () => {
+      const events: string[] = [];
+      const task = new DeferredTask(Context.default(), async () => {
+        await sleep(10);
+        events.push('task done');
+      });
+
+      await task.runBlocking();
+      expect(events).to.deep.eq(['task done']);
+    });
+
+    test('join', async () => {
+      const task = new DeferredTask(Context.default(), async () => {
+        await sleep(10);
+      });
+
+      await task.join(); // Should be a no-op.
+
+      await task.runBlocking();
+
+      await task.join(); // Should be a no-op.
+    });
   });
 });

package/src/task-scheduling.ts

@@ -2,11 +2,12 @@
 // Copyright 2022 DXOS.org
 //
 
-import { type Context } from '@dxos/context';
+import { ContextDisposedError, type Context } from '@dxos/context';
 import { StackTrace } from '@dxos/debug';
 import { type MaybePromise } from '@dxos/util';
 
 import { trackResource } from './track-leaks';
+import { Trigger } from './trigger';
 
 export type ClearCallback = () => void;
 
@@ -15,15 +16,20 @@ export type ClearCallback = () => void;
  * Could be triggered multiple times, but only runs once.
  * If a new task is triggered while a previous one is running, the next run would occur immediately after the current run has finished.
  */
+// TODO(dmaretskyi): Consider calling `join` on context dispose.
 export class DeferredTask {
   private _scheduled = false;
-  private _promise: Promise<void> | null = null; // Can't be rejected.
+  private _currentTask: Promise<void> | null = null; // Can't be rejected.
+  private _nextTask = new Trigger();
 
   constructor(
     private readonly _ctx: Context,
     private readonly _callback: () => Promise<void>,
   ) {}
 
+  /**
+   * Schedule the task to run asynchronously.
+   */
   schedule() {
     if (this._scheduled) {
       return; // Already scheduled.
@@ -31,17 +37,40 @@ export class DeferredTask {
 
     scheduleTask(this._ctx, async () => {
       // The previous task might still be running, so we need to wait for it to finish.
-      await this._promise; // Can't be rejected.
+      await this._currentTask; // Can't be rejected.
 
       // Reset the flag. New tasks can now be scheduled. They would wait for the callback to finish.
       this._scheduled = false;
+      const completionTrigger = this._nextTask;
+      this._nextTask = new Trigger(); // Re-create the trigger as opposed to resetting it since there might be listeners waiting for it.
 
       // Store the promise so that new tasks could wait for this one to finish.
-      this._promise = runInContextAsync(this._ctx, () => this._callback());
+      this._currentTask = runInContextAsync(this._ctx, () => this._callback()).then(() => {
+        completionTrigger.wake();
+      });
     });
 
     this._scheduled = true;
   }
+
+  /**
+   * Schedule the task to run and wait for it to finish.
+   */
+  async runBlocking() {
+    if (this._ctx.disposed) {
+      throw new ContextDisposedError();
+    }
+    this.schedule();
+    await this._nextTask.wait();
+  }
+
+  /**
+   * Waits for the current task to finish if it is running.
+   * Does not schedule a new task.
+   */
+  async join() {
+    await this._currentTask;
+  }
 }
 
 export const runInContext = (ctx: Context, fn: () => void) => {

package/src/trigger.test.ts

@@ -6,7 +6,8 @@ import { expect } from 'chai';
 
 import { describe, test } from '@dxos/test';
 
-import { trigger } from './trigger';
+import { sleep } from './timeout';
+import { Trigger, trigger } from './trigger';
 
 describe('trigger', () => {
   test('trigger', async () => {
@@ -18,4 +19,12 @@ describe('trigger', () => {
     expect(result).to.equal('test');
     clearTimeout(t);
   });
+
+  test('throw with not listeners does not cause unhandled rejection', async () => {
+    const trigger = new Trigger();
+    trigger.wake();
+    trigger.throw(new Error('Test error'));
+    trigger.reset();
+    await sleep(10);
+  });
 });

package/src/trigger.ts

@@ -43,7 +43,8 @@ export type TriggerOptions = {
  */
 export class Trigger<T = void> {
   private _promise!: Promise<T>;
-  private _wake!: (value: T | PromiseLike<T>) => void;
+  private _resolve!: (value: T | PromiseLike<T>) => void;
+  private _reject!: (error: Error) => void;
 
   constructor(private _options: TriggerOptions = { autoReset: false }) {
     this.reset();
@@ -62,9 +63,10 @@ export class Trigger<T = void> {
 
   /**
    * Wake blocked callers (if any).
+   * NOOP if the trigger is already resolved.
    */
   wake(value: T) {
-    this._wake(value);
+    this._resolve(value);
     if (this._options.autoReset) {
       return this.reset();
     }
@@ -76,18 +78,21 @@ export class Trigger<T = void> {
    * Reset promise (new waiters will wait).
    */
   reset() {
-    this._promise = new Promise<T>((resolve) => {
-      this._wake = resolve;
+    this._promise = new Promise<T>((resolve, reject) => {
+      this._resolve = resolve;
+      this._reject = reject;
     });
+    this._promise.catch(() => {}); // Prevent unhandled promise rejections.
 
     return this;
   }
 
   /**
    * Throw error to blocked callers (if any).
+   * NOOP if the trigger is already resolved.
    */
   throw(error: Error) {
-    this._wake(Promise.reject(error));
+    this._reject(error);
     if (this._options.autoReset) {
       return this.reset();
     }