@dxos/async 0.7.5-main.9d26e3a → 0.7.5-main.b19bfc8

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

@@ -1,4 +1,5 @@
 import { Context } from '@dxos/context';
+import type { MaybePromise } from '@dxos/util';
 export type UnsubscribeCallback = () => void;
 export type Effect = () => UnsubscribeCallback | undefined;
 interface EventEmitterLike {
@@ -17,6 +18,7 @@ export type ListenerOptions = {
     weak?: boolean;
     once?: boolean;
 };
+type EventCallback<T> = (data: T) => MaybePromise<void>;
 /**
  * An EventEmitter variant that does not do event multiplexing and represents a single event.
  *
@@ -63,6 +65,15 @@ export declare class Event<T = void> implements ReadOnlyEvent<T> {
      * @param data param that will be passed to all listeners.
      */
     emit(data: T): void;
+    /**
+     * Emit an event and wait for async listeners to complete.
+     * In most cases should only be called by the class or entity containing the event.
+     * All listeners are called in order of subscription with persistent ones first.
+     * Listeners are called sequentially.
+     *
+     * @param data param that will be passed to all listeners.
+     */
+    emitAsync(data: T): Promise<void>;
     /**
      * Register an event listener.
      * If provided callback was already registered as once-listener, it is made permanent.
@@ -71,8 +82,8 @@ export declare class Event<T = void> implements ReadOnlyEvent<T> {
      * @param options.weak If true, the callback will be weakly referenced and will be garbage collected if no other references to it exist.
      * @returns function that unsubscribes this event listener
      */
-    on(callback: (data: T) => void): UnsubscribeCallback;
-    on(ctx: Context, callback: (data: T) => void, options?: ListenerOptions): UnsubscribeCallback;
+    on(callback: EventCallback<T>): UnsubscribeCallback;
+    on(ctx: Context, callback: EventCallback<T>, options?: ListenerOptions): UnsubscribeCallback;
     /**
      * Unsubscribe this callback from new events. Includes persistent and once-listeners.
      * NOTE: It is recommended to use `Event.on`'s return value instead.

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

@@ -1 +1 @@
-{"version":3,"file":"events.d.ts","sourceRoot":"","sources":["../../../src/events.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"events.d.ts","sourceRoot":"","sources":["../../../src/events.ts"],"names":[],"mappings":"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"}

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

@@ -5,19 +5,20 @@ export * from './errors';
 export * from './event-emitter';
 export * from './events';
 export * from './latch';
+export * from './mutex';
 export * from './observable';
 export * from './observable-value';
-export * from './mutex';
+export * from './persistent-lifecycle';
 export * from './sink';
 export * from './stream-to-array';
+export * from './task-scheduling';
+export * from './test-stream';
+export * from './testing';
 export * from './timeout';
 export * from './timer';
-export * from './testing';
+export * from './track-leaks';
 export * from './trigger';
 export * from './types';
 export * from './until';
-export * from './task-scheduling';
-export * from './test-stream';
-export * from './track-leaks';
 export * from './update-scheduler';
 //# sourceMappingURL=index.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/index.ts"],"names":[],"mappings":"AAIA,cAAc,YAAY,CAAC;AAC3B,cAAc,SAAS,CAAC;AACxB,cAAc,YAAY,CAAC;AAC3B,cAAc,UAAU,CAAC;AACzB,cAAc,iBAAiB,CAAC;AAChC,cAAc,UAAU,CAAC;AACzB,cAAc,SAAS,CAAC;AACxB,cAAc,cAAc,CAAC;AAC7B,cAAc,oBAAoB,CAAC;AACnC,cAAc,SAAS,CAAC;AACxB,cAAc,QAAQ,CAAC;AACvB,cAAc,mBAAmB,CAAC;AAClC,cAAc,WAAW,CAAC;AAC1B,cAAc,SAAS,CAAC;AACxB,cAAc,WAAW,CAAC;AAC1B,cAAc,WAAW,CAAC;AAC1B,cAAc,SAAS,CAAC;AACxB,cAAc,SAAS,CAAC;AACxB,cAAc,mBAAmB,CAAC;AAClC,cAAc,eAAe,CAAC;AAC9B,cAAc,eAAe,CAAC;AAC9B,cAAc,oBAAoB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/index.ts"],"names":[],"mappings":"AAIA,cAAc,YAAY,CAAC;AAC3B,cAAc,SAAS,CAAC;AACxB,cAAc,YAAY,CAAC;AAC3B,cAAc,UAAU,CAAC;AACzB,cAAc,iBAAiB,CAAC;AAChC,cAAc,UAAU,CAAC;AACzB,cAAc,SAAS,CAAC;AACxB,cAAc,SAAS,CAAC;AACxB,cAAc,cAAc,CAAC;AAC7B,cAAc,oBAAoB,CAAC;AACnC,cAAc,wBAAwB,CAAC;AACvC,cAAc,QAAQ,CAAC;AACvB,cAAc,mBAAmB,CAAC;AAClC,cAAc,mBAAmB,CAAC;AAClC,cAAc,eAAe,CAAC;AAC9B,cAAc,WAAW,CAAC;AAC1B,cAAc,WAAW,CAAC;AAC1B,cAAc,SAAS,CAAC;AACxB,cAAc,eAAe,CAAC;AAC9B,cAAc,WAAW,CAAC;AAC1B,cAAc,SAAS,CAAC;AACxB,cAAc,SAAS,CAAC;AACxB,cAAc,oBAAoB,CAAC"}

package/dist/types/src/persistent-lifecycle.d.ts

@@ -0,0 +1,45 @@
+import { Resource } from '@dxos/context';
+export type PersistentLifecycleParams<T> = {
+    /**
+     * Create connection.
+     * If promise resolves successfully, connection is considered established.
+     */
+    start: () => Promise<T | undefined>;
+    /**
+     * Reset connection to initial state.
+     */
+    stop: (state: T) => Promise<void>;
+    /**
+     * Called after successful start.
+     */
+    onRestart?: () => Promise<void>;
+    /**
+     * Maximum delay between restartion attempts.
+     * Default: 5000ms
+     */
+    maxRestartDelay?: number;
+};
+/**
+ * Handles restarts (e.g. persists connection).
+ * Restarts are scheduled with exponential backoff.
+ */
+export declare class PersistentLifecycle<T> extends Resource {
+    private readonly _start;
+    private readonly _stop;
+    private readonly _onRestart?;
+    private readonly _maxRestartDelay;
+    private _currentState;
+    private _restartTask?;
+    private _restartAfter;
+    constructor({ start, stop, onRestart, maxRestartDelay }: PersistentLifecycleParams<T>);
+    get state(): T | undefined;
+    protected _open(): Promise<void>;
+    protected _close(): Promise<void>;
+    private _restart;
+    private _stopCurrentState;
+    /**
+     * Scheduling restart should be done from outside.
+     */
+    scheduleRestart(): void;
+}
+//# sourceMappingURL=persistent-lifecycle.d.ts.map

package/dist/types/src/persistent-lifecycle.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"persistent-lifecycle.d.ts","sourceRoot":"","sources":["../../../src/persistent-lifecycle.ts"],"names":[],"mappings":"AAIA,OAAO,EAAkB,QAAQ,EAAqB,MAAM,eAAe,CAAC;AAW5E,MAAM,MAAM,yBAAyB,CAAC,CAAC,IAAI;IACzC;;;OAGG;IACH,KAAK,EAAE,MAAM,OAAO,CAAC,CAAC,GAAG,SAAS,CAAC,CAAC;IAEpC;;OAEG;IACH,IAAI,EAAE,CAAC,KAAK,EAAE,CAAC,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IAElC;;OAEG;IACH,SAAS,CAAC,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;IAEhC;;;OAGG;IACH,eAAe,CAAC,EAAE,MAAM,CAAC;CAC1B,CAAC;AAEF;;;GAGG;AACH,qBAAa,mBAAmB,CAAC,CAAC,CAAE,SAAQ,QAAQ;IAClD,OAAO,CAAC,QAAQ,CAAC,MAAM,CAA+B;IACtD,OAAO,CAAC,QAAQ,CAAC,KAAK,CAA8B;IACpD,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAC,CAAsB;IAClD,OAAO,CAAC,QAAQ,CAAC,gBAAgB,CAAS;IAE1C,OAAO,CAAC,aAAa,CAA4B;IACjD,OAAO,CAAC,YAAY,CAAC,CAA2B;IAChD,OAAO,CAAC,aAAa,CAAK;gBAEd,EAAE,KAAK,EAAE,IAAI,EAAE,SAAS,EAAE,eAA2C,EAAE,EAAE,yBAAyB,CAAC,CAAC,CAAC;IAQjH,IAAI,KAAK,kBAER;cAGwB,KAAK;cAgBL,MAAM;YAMjB,QAAQ;YAkBR,iBAAiB;IAW/B;;OAEG;IAEH,eAAe;CAMhB"}

package/dist/types/src/persistent-lifecycle.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=persistent-lifecycle.test.d.ts.map

package/dist/types/src/persistent-lifecycle.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"persistent-lifecycle.test.d.ts","sourceRoot":"","sources":["../../../src/persistent-lifecycle.test.ts"],"names":[],"mappings":""}

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

@@ -13,6 +13,7 @@ export declare class DeferredTask {
     private _currentTask;
     private _nextTask;
     constructor(_ctx: Context, _callback: () => Promise<void>);
+    get scheduled(): boolean;
     /**
      * Schedule the task to run asynchronously.
      */

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,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;AAGH,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;IASjB;;;OAGG;IACG,IAAI;CAGX;AAED,eAAO,MAAM,YAAY,QAAS,OAAO,MAAM,MAAM,IAAI,SAMxD,CAAC;AAEF,eAAO,MAAM,iBAAiB,QAAe,OAAO,MAAM,MAAM,YAAY,CAAC,IAAI,CAAC,kBAMjF,CAAC;AAEF,eAAO,MAAM,iBAAiB,QAAS,OAAO,MAAM,MAAM,YAAY,CAAC,IAAI,CAAC,SAO3E,CAAC;AAEF,eAAO,MAAM,YAAY,QAAS,OAAO,MAAM,MAAM,YAAY,CAAC,IAAI,CAAC,YAAY,MAAM,SAgBxF,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,oBAAoB,QAAS,OAAO,QAAQ,MAAM,OAAO,CAAC,IAAI,CAAC,YAAY,MAAM,SAqB7F,CAAC;AAEF,eAAO,MAAM,sCAAsC,QAC5C,OAAO,QACN,MAAM,OAAO,CAAC,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;AAGH,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,IAAI,SAAS,YAEZ;IAED;;OAEG;IACH,QAAQ;IAuBR;;OAEG;IACG,WAAW;IASjB;;;OAGG;IACG,IAAI;CAGX;AAED,eAAO,MAAM,YAAY,QAAS,OAAO,MAAM,MAAM,IAAI,SAMxD,CAAC;AAEF,eAAO,MAAM,iBAAiB,QAAe,OAAO,MAAM,MAAM,YAAY,CAAC,IAAI,CAAC,kBAMjF,CAAC;AAEF,eAAO,MAAM,iBAAiB,QAAS,OAAO,MAAM,MAAM,YAAY,CAAC,IAAI,CAAC,SAO3E,CAAC;AAEF,eAAO,MAAM,YAAY,QAAS,OAAO,MAAM,MAAM,YAAY,CAAC,IAAI,CAAC,YAAY,MAAM,SAgBxF,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,oBAAoB,QAAS,OAAO,QAAQ,MAAM,OAAO,CAAC,IAAI,CAAC,YAAY,MAAM,SAqB7F,CAAC;AAEF,eAAO,MAAM,sCAAsC,QAC5C,OAAO,QACN,MAAM,OAAO,CAAC,IAAI,CAAC,mBACR,MAAM,SAwBxB,CAAC"}

package/dist/types/tsconfig.tsbuildinfo

@@ -1 +1 @@
-{"version":"5.7.2"}
+{"version":"5.7.3"}

package/package.json

@@ -1,12 +1,13 @@
 {
   "name": "@dxos/async",
-  "version": "0.7.5-main.9d26e3a",
+  "version": "0.7.5-main.b19bfc8",
   "description": "Async utilities.",
   "homepage": "https://dxos.org",
   "bugs": "https://github.com/dxos/dxos/issues",
   "license": "MIT",
   "author": "DXOS.org",
   "sideEffects": true,
+  "type": "module",
   "exports": {
     ".": {
       "browser": "./dist/lib/browser/index.mjs",
@@ -28,12 +29,12 @@
   "dependencies": {
     "zen-observable": "^0.10.0",
     "zen-push": "^0.3.1",
-    "@dxos/context": "0.7.5-main.9d26e3a",
-    "@dxos/debug": "0.7.5-main.9d26e3a",
-    "@dxos/invariant": "0.7.5-main.9d26e3a",
-    "@dxos/log": "0.7.5-main.9d26e3a",
-    "@dxos/node-std": "0.7.5-main.9d26e3a",
-    "@dxos/util": "0.7.5-main.9d26e3a"
+    "@dxos/context": "0.7.5-main.b19bfc8",
+    "@dxos/invariant": "0.7.5-main.b19bfc8",
+    "@dxos/node-std": "0.7.5-main.b19bfc8",
+    "@dxos/debug": "0.7.5-main.b19bfc8",
+    "@dxos/util": "0.7.5-main.b19bfc8",
+    "@dxos/log": "0.7.5-main.b19bfc8"
   },
   "devDependencies": {
     "@types/zen-observable": "^0.8.3"

package/src/events.test.ts

@@ -89,6 +89,21 @@ describe('Event', () => {
     expect(error.message).to.equal('test');
   });
 
+  test('emitAsync', async () => {
+    const event = new Event<number>();
+    let called = 0;
+    event.on(async (num) => {
+      await sleep(10);
+      called++;
+    });
+
+    await event.emitAsync(1);
+    expect(called).to.equal(1);
+
+    // TODO(dmaretskyi): Disabled for now.
+    // expect(() => event.emit(1)).to.throw(TypeError);
+  });
+
   // test.skip('weak', async () => {
   //   setFlagsFromString('--expose_gc');
   //   const gc = runInNewContext('gc'); // nocommit

package/src/events.ts

@@ -3,6 +3,7 @@
 //
 
 import { Context } from '@dxos/context';
+import type { MaybePromise } from '@dxos/util';
 
 export type UnsubscribeCallback = () => void;
 
@@ -42,6 +43,11 @@ export type ListenerOptions = {
   once?: boolean;
 };
 
+type EventCallback<T> = (data: T) => MaybePromise<void>;
+
+// TODO(dmaretskyi): Remove this once the code is cleaned up.
+const DO_NOT_ERROR_ON_ASYNC_CALLBACK = true;
+
 /**
  * An EventEmitter variant that does not do event multiplexing and represents a single event.
  *
@@ -102,7 +108,25 @@ export class Event<T = void> implements ReadOnlyEvent<T> {
    */
   emit(data: T) {
     for (const listener of this._listeners) {
-      void listener.trigger(data);
+      listener.trigger(data);
+
+      if (listener.once) {
+        this._listeners.delete(listener);
+      }
+    }
+  }
+
+  /**
+   * Emit an event and wait for async listeners to complete.
+   * In most cases should only be called by the class or entity containing the event.
+   * All listeners are called in order of subscription with persistent ones first.
+   * Listeners are called sequentially.
+   *
+   * @param data param that will be passed to all listeners.
+   */
+  async emitAsync(data: T) {
+    for (const listener of this._listeners) {
+      await listener.triggerAsync(data);
 
       if (listener.once) {
         this._listeners.delete(listener);
@@ -118,9 +142,9 @@ export class Event<T = void> implements ReadOnlyEvent<T> {
    * @param options.weak If true, the callback will be weakly referenced and will be garbage collected if no other references to it exist.
    * @returns function that unsubscribes this event listener
    */
-  on(callback: (data: T) => void): UnsubscribeCallback;
-  on(ctx: Context, callback: (data: T) => void, options?: ListenerOptions): UnsubscribeCallback;
-  on(_ctx: any, _callback?: (data: T) => void, options?: ListenerOptions): UnsubscribeCallback {
+  on(callback: EventCallback<T>): UnsubscribeCallback;
+  on(ctx: Context, callback: EventCallback<T>, options?: ListenerOptions): UnsubscribeCallback;
+  on(_ctx: any, _callback?: EventCallback<T>, options?: ListenerOptions): UnsubscribeCallback {
     const [ctx, callback] = _ctx instanceof Context ? [_ctx, _callback] : [new Context(), _ctx];
     const weak = !!options?.weak;
     const once = !!options?.once;
@@ -408,13 +432,13 @@ export interface ReadOnlyEvent<T = void> {
 }
 
 class EventListener<T> {
-  public readonly callback: ((data: T) => void) | WeakRef<(data: T) => void>;
+  public readonly callback: EventCallback<T> | WeakRef<EventCallback<T>>;
 
   private readonly _clearDispose?: () => void = undefined;
 
   constructor(
     event: Event<T>,
-    listener: (data: T) => void,
+    listener: EventCallback<T>,
     public readonly ctx: Context,
     public readonly once: boolean,
     public readonly weak: boolean,
@@ -438,11 +462,27 @@ class EventListener<T> {
     }
   }
 
-  derefCallback(): ((data: T) => void) | undefined {
-    return this.weak ? (this.callback as WeakRef<(data: T) => void>).deref() : (this.callback as (data: T) => void);
+  derefCallback(): EventCallback<T> | undefined {
+    return this.weak ? (this.callback as WeakRef<EventCallback<T>>).deref() : (this.callback as EventCallback<T>);
+  }
+
+  trigger(data: T) {
+    let result!: MaybePromise<void>;
+    try {
+      const callback = this.derefCallback();
+      result = callback?.(data);
+    } catch (err: any) {
+      this.ctx.raise(err);
+    }
+
+    if (!DO_NOT_ERROR_ON_ASYNC_CALLBACK) {
+      if (result instanceof Promise) {
+        throw new TypeError('Event has async callbacks, use emitAsync instead');
+      }
+    }
   }
 
-  async trigger(data: T) {
+  async triggerAsync(data: T) {
     try {
       const callback = this.derefCallback();
       await callback?.(data);

package/src/index.ts

@@ -9,18 +9,19 @@ export * from './errors';
 export * from './event-emitter';
 export * from './events';
 export * from './latch';
+export * from './mutex';
 export * from './observable';
 export * from './observable-value';
-export * from './mutex';
+export * from './persistent-lifecycle';
 export * from './sink';
 export * from './stream-to-array';
+export * from './task-scheduling';
+export * from './test-stream';
+export * from './testing';
 export * from './timeout';
 export * from './timer';
-export * from './testing';
+export * from './track-leaks';
 export * from './trigger';
 export * from './types';
 export * from './until';
-export * from './task-scheduling';
-export * from './test-stream';
-export * from './track-leaks';
 export * from './update-scheduler';

package/src/persistent-lifecycle.test.ts

@@ -0,0 +1,77 @@
+//
+// Copyright 2024 DXOS.org
+//
+
+import { describe, expect, test, onTestFinished } from 'vitest';
+
+import { log } from '@dxos/log';
+
+import { PersistentLifecycle } from './persistent-lifecycle';
+import { sleep } from './timeout';
+import { Trigger } from './trigger';
+
+describe('ConnectionState', () => {
+  test('first reconnect fires immediately', async () => {
+    const triggerCall = new Trigger<number>();
+    const persistentLifecycle = new PersistentLifecycle({
+      start: async () => {
+        triggerCall.wake(Date.now());
+      },
+      stop: async () => {},
+    });
+    await persistentLifecycle.open();
+    onTestFinished(async () => {
+      await persistentLifecycle.close();
+    });
+
+    const triggerTimestamp = Date.now();
+    persistentLifecycle.scheduleRestart();
+    const timeToTrigger = (await triggerCall.wait({ timeout: 1000 })) - triggerTimestamp;
+    expect(timeToTrigger).to.be.lessThan(50);
+  });
+
+  test('second reconnect fires after 100ms', async () => {
+    let called = 0;
+    const triggerCall = new Trigger<number>();
+
+    const persistentLifecycle = new PersistentLifecycle({
+      start: async () => {
+        called += 1;
+        log.info('called', { called });
+        if (called < 3) {
+          throw new Error('TEST ERROR');
+        }
+        triggerCall.wake(Date.now());
+      },
+      stop: async () => {},
+    });
+
+    await persistentLifecycle.open();
+    onTestFinished(async () => {
+      await persistentLifecycle.close();
+    });
+
+    const triggerTimestamp = Date.now();
+    await sleep(10);
+    const timeToTrigger = (await triggerCall.wait({ timeout: 1000 })) - triggerTimestamp;
+    expect(timeToTrigger).to.be.greaterThanOrEqual(100);
+  });
+
+  test('finish `restart` before close', async () => {
+    let restarted = false;
+    const persistentLifecycle = new PersistentLifecycle({
+      start: async () => await sleep(100),
+      stop: async () => {},
+      onRestart: async () => {
+        restarted = true;
+      },
+    });
+
+    await persistentLifecycle.open();
+
+    persistentLifecycle.scheduleRestart();
+    await sleep(10);
+    await persistentLifecycle.close();
+    expect(restarted).to.be.true;
+  });
+});

package/src/persistent-lifecycle.ts

@@ -0,0 +1,128 @@
+//
+// Copyright 2024 DXOS.org
+//
+
+import { LifecycleState, Resource, cancelWithContext } from '@dxos/context';
+import { warnAfterTimeout } from '@dxos/debug';
+import { log } from '@dxos/log';
+
+import { synchronized } from './mutex';
+import { DeferredTask } from './task-scheduling';
+import { sleep } from './timeout';
+
+const INIT_RESTART_DELAY = 100;
+const DEFAULT_MAX_RESTART_DELAY = 5000;
+
+export type PersistentLifecycleParams<T> = {
+  /**
+   * Create connection.
+   * If promise resolves successfully, connection is considered established.
+   */
+  start: () => Promise<T | undefined>;
+
+  /**
+   * Reset connection to initial state.
+   */
+  stop: (state: T) => Promise<void>;
+
+  /**
+   * Called after successful start.
+   */
+  onRestart?: () => Promise<void>;
+
+  /**
+   * Maximum delay between restartion attempts.
+   * Default: 5000ms
+   */
+  maxRestartDelay?: number;
+};
+
+/**
+ * Handles restarts (e.g. persists connection).
+ * Restarts are scheduled with exponential backoff.
+ */
+export class PersistentLifecycle<T> extends Resource {
+  private readonly _start: () => Promise<T | undefined>;
+  private readonly _stop: (state: T) => Promise<void>;
+  private readonly _onRestart?: () => Promise<void>;
+  private readonly _maxRestartDelay: number;
+
+  private _currentState: T | undefined = undefined;
+  private _restartTask?: DeferredTask = undefined;
+  private _restartAfter = 0;
+
+  constructor({ start, stop, onRestart, maxRestartDelay = DEFAULT_MAX_RESTART_DELAY }: PersistentLifecycleParams<T>) {
+    super();
+    this._start = start;
+    this._stop = stop;
+    this._onRestart = onRestart;
+    this._maxRestartDelay = maxRestartDelay;
+  }
+
+  get state() {
+    return this._currentState;
+  }
+
+  @synchronized
+  protected override async _open() {
+    this._restartTask = new DeferredTask(this._ctx, async () => {
+      try {
+        await this._restart();
+      } catch (err) {
+        log.warn('Restart failed', { err });
+        this._restartTask?.schedule();
+      }
+    });
+    this._currentState = await this._start().catch((err) => {
+      log.warn('Start failed', { err });
+      this._restartTask?.schedule();
+      return undefined;
+    });
+  }
+
+  protected override async _close() {
+    await this._restartTask?.join();
+    await this._stopCurrentState();
+    this._restartTask = undefined;
+  }
+
+  private async _restart() {
+    log(`restarting in ${this._restartAfter}ms`, { state: this._lifecycleState });
+    await this._stopCurrentState();
+    if (this._lifecycleState !== LifecycleState.OPEN) {
+      return;
+    }
+    await cancelWithContext(this._ctx!, sleep(this._restartAfter));
+    this._restartAfter = Math.min(Math.max(this._restartAfter * 2, INIT_RESTART_DELAY), this._maxRestartDelay);
+
+    // May fail if the connection is not established.
+    await warnAfterTimeout(5_000, 'Connection establishment takes too long', async () => {
+      this._currentState = await this._start();
+    });
+
+    this._restartAfter = 0;
+    await this._onRestart?.();
+  }
+
+  private async _stopCurrentState() {
+    if (this._currentState) {
+      try {
+        await this._stop(this._currentState);
+      } catch (err) {
+        log.catch(err);
+      }
+      this._currentState = undefined;
+    }
+  }
+
+  /**
+   * Scheduling restart should be done from outside.
+   */
+  @synchronized
+  scheduleRestart() {
+    if (this._lifecycleState !== LifecycleState.OPEN) {
+      return;
+    }
+    this._restartTask!.schedule();
+  }
+}

package/src/task-scheduling.ts

@@ -28,6 +28,10 @@ export class DeferredTask {
     private readonly _callback: () => Promise<void>,
   ) {}
 
+  get scheduled() {
+    return this._scheduled;
+  }
+
   /**
    * Schedule the task to run asynchronously.
    */