@dxos/edge-client 0.6.9 → 0.6.10-main.3cfcc89

package/dist/lib/browser/index.mjs

@@ -1,12 +1,12 @@
 // packages/core/mesh/edge-client/src/index.ts
 export * from "@dxos/protocols/buf/dxos/edge/messenger_pb";
 
-// packages/core/mesh/edge-client/src/client.ts
+// packages/core/mesh/edge-client/src/edge-client.ts
 import WebSocket from "isomorphic-ws";
-import { Trigger } from "@dxos/async";
-import { LifecycleState, Resource } from "@dxos/context";
+import { Trigger, Event, scheduleTaskInterval, scheduleTask, TriggerState } from "@dxos/async";
+import { Context, LifecycleState as LifecycleState2, Resource as Resource2 } from "@dxos/context";
 import { invariant as invariant2 } from "@dxos/invariant";
-import { log } from "@dxos/log";
+import { log as log2 } from "@dxos/log";
 import { buf as buf2 } from "@dxos/protocols/buf";
 import { MessageSchema as MessageSchema2 } from "@dxos/protocols/buf/dxos/edge/messenger_pb";
 
@@ -118,19 +118,131 @@ var protocol = new Protocol([
   AnySchema
 ]);
 
-// packages/core/mesh/edge-client/src/client.ts
-var __dxlog_file2 = "/home/runner/work/dxos/dxos/packages/core/mesh/edge-client/src/client.ts";
-var DEFAULT_TIMEOUT = 5e3;
-var EdgeClient = class extends Resource {
-  constructor(_identityKey, _deviceKey, _config) {
+// packages/core/mesh/edge-client/src/errors.ts
+var WebsocketClosedError = class extends Error {
+  constructor() {
+    super("WebSocket connection closed");
+  }
+};
+
+// packages/core/mesh/edge-client/src/persistent-lifecycle.ts
+import { DeferredTask, sleep, synchronized } from "@dxos/async";
+import { cancelWithContext, LifecycleState, Resource } from "@dxos/context";
+import { warnAfterTimeout } from "@dxos/debug";
+import { log } from "@dxos/log";
+function _ts_decorate(decorators, target, key, desc) {
+  var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
+  if (typeof Reflect === "object" && typeof Reflect.decorate === "function")
+    r = Reflect.decorate(decorators, target, key, desc);
+  else
+    for (var i = decorators.length - 1; i >= 0; i--)
+      if (d = decorators[i])
+        r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
+  return c > 3 && r && Object.defineProperty(target, key, r), r;
+}
+var __dxlog_file2 = "/home/runner/work/dxos/dxos/packages/core/mesh/edge-client/src/persistent-lifecycle.ts";
+var INIT_RESTART_DELAY = 100;
+var DEFAULT_MAX_RESTART_DELAY = 5e3;
+var PersistentLifecycle = class extends Resource {
+  constructor({ start, stop, onRestart, maxRestartDelay = DEFAULT_MAX_RESTART_DELAY }) {
+    super();
+    this._restartTask = void 0;
+    this._restartAfter = 0;
+    this._start = start;
+    this._stop = stop;
+    this._onRestart = onRestart;
+    this._maxRestartDelay = maxRestartDelay;
+  }
+  async _open() {
+    this._restartTask = new DeferredTask(this._ctx, async () => {
+      try {
+        await this._restart();
+      } catch (err) {
+        log.warn("Restart failed", {
+          err
+        }, {
+          F: __dxlog_file2,
+          L: 64,
+          S: this,
+          C: (f, a) => f(...a)
+        });
+        this._restartTask?.schedule();
+      }
+    });
+    await this._start().catch((err) => {
+      log.warn("Start failed", {
+        err
+      }, {
+        F: __dxlog_file2,
+        L: 69,
+        S: this,
+        C: (f, a) => f(...a)
+      });
+      this._restartTask?.schedule();
+    });
+  }
+  async _close() {
+    await this._restartTask?.join();
+    await this._stop();
+    this._restartTask = void 0;
+  }
+  async _restart() {
+    log(`restarting in ${this._restartAfter}ms`, {
+      state: this._lifecycleState
+    }, {
+      F: __dxlog_file2,
+      L: 81,
+      S: this,
+      C: (f, a) => f(...a)
+    });
+    await this._stop();
+    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);
+    await warnAfterTimeout(5e3, "Connection establishment takes too long", () => this._start());
+    this._restartAfter = 0;
+    await this._onRestart?.();
+  }
+  /**
+  * Scheduling restart should be done from outside.
+  */
+  scheduleRestart() {
+    if (this._lifecycleState !== LifecycleState.OPEN) {
+      return;
+    }
+    this._restartTask.schedule();
+  }
+};
+_ts_decorate([
+  synchronized
+], PersistentLifecycle.prototype, "_open", null);
+_ts_decorate([
+  synchronized
+], PersistentLifecycle.prototype, "scheduleRestart", null);
+
+// packages/core/mesh/edge-client/src/edge-client.ts
+var __dxlog_file3 = "/home/runner/work/dxos/dxos/packages/core/mesh/edge-client/src/edge-client.ts";
+var DEFAULT_TIMEOUT = 1e4;
+var SIGNAL_KEEPALIVE_INTERVAL = 5e3;
+var EdgeClient = class extends Resource2 {
+  constructor(_identityKey, _peerKey, _config) {
     super();
     this._identityKey = _identityKey;
-    this._deviceKey = _deviceKey;
+    this._peerKey = _peerKey;
     this._config = _config;
+    this.reconnect = new Event();
+    this._persistentLifecycle = new PersistentLifecycle({
+      start: async () => this._openWebSocket(),
+      stop: async () => this._closeWebSocket(),
+      onRestart: async () => this.reconnect.emit()
+    });
     this._listeners = /* @__PURE__ */ new Set();
-    this._reconnect = void 0;
     this._ready = new Trigger();
     this._ws = void 0;
+    this._keepaliveCtx = void 0;
+    this._heartBeatContext = void 0;
     this._protocol = this._config.protocol ?? protocol;
   }
   // TODO(burdon): Attach logging.
@@ -138,29 +250,22 @@ var EdgeClient = class extends Resource {
     return {
       open: this.isOpen,
       identity: this._identityKey,
-      device: this._deviceKey
+      device: this._peerKey
     };
   }
   get identityKey() {
     return this._identityKey;
   }
-  get deviceKey() {
-    return this._deviceKey;
+  get peerKey() {
+    return this._peerKey;
   }
   get isOpen() {
-    return this._lifecycleState === LifecycleState.OPEN;
+    return this._lifecycleState === LifecycleState2.OPEN;
   }
-  setIdentity({ deviceKey, identityKey }) {
-    this._deviceKey = deviceKey;
+  setIdentity({ peerKey, identityKey }) {
+    this._peerKey = peerKey;
     this._identityKey = identityKey;
-    this._reconnect = this._closeWebSocket().then(async () => {
-      await this._openWebSocket();
-    }).catch((err) => log.catch(err, void 0, {
-      F: __dxlog_file2,
-      L: 87,
-      S: this,
-      C: (f, a) => f(...a)
-    }));
+    this._persistentLifecycle.scheduleRestart();
   }
   addListener(listener) {
     this._listeners.add(listener);
@@ -170,171 +275,204 @@ var EdgeClient = class extends Resource {
   * Open connection to messaging service.
   */
   async _open() {
-    await this._reconnect;
-    if (this._ws) {
-      return;
-    }
-    invariant2(this._deviceKey && this._identityKey, void 0, {
-      F: __dxlog_file2,
-      L: 103,
-      S: this,
-      A: [
-        "this._deviceKey && this._identityKey",
-        ""
-      ]
-    });
-    log.info("opening...", {
+    log2("opening...", {
       info: this.info
     }, {
-      F: __dxlog_file2,
-      L: 104,
+      F: __dxlog_file3,
+      L: 105,
       S: this,
       C: (f, a) => f(...a)
     });
-    await this._openWebSocket();
-    log.info("opened", {
-      info: this.info
-    }, {
-      F: __dxlog_file2,
-      L: 108,
-      S: this,
-      C: (f, a) => f(...a)
+    this._persistentLifecycle.open().catch((err) => {
+      log2.warn("Error while opening connection", {
+        err
+      }, {
+        F: __dxlog_file3,
+        L: 107,
+        S: this,
+        C: (f, a) => f(...a)
+      });
     });
   }
   /**
   * Close connection and free resources.
   */
   async _close() {
-    log("closing...", {
-      deviceKey: this._deviceKey
+    log2("closing...", {
+      peerKey: this._peerKey
     }, {
-      F: __dxlog_file2,
+      F: __dxlog_file3,
       L: 115,
       S: this,
       C: (f, a) => f(...a)
     });
-    await this._reconnect;
-    await this._closeWebSocket();
-    log("closed", {
-      deviceKey: this._deviceKey
-    }, {
-      F: __dxlog_file2,
-      L: 118,
-      S: this,
-      C: (f, a) => f(...a)
-    });
+    await this._persistentLifecycle.close();
   }
   async _openWebSocket() {
-    const url = new URL(`/ws/${this._identityKey.toHex()}/${this._deviceKey.toHex()}`, this._config.socketEndpoint);
+    const url = new URL(`/ws/${this._identityKey}/${this._peerKey}`, this._config.socketEndpoint);
     this._ws = new WebSocket(url);
-    Object.assign(this._ws, {
-      onopen: () => {
-        log("opened", this.info, {
-          F: __dxlog_file2,
-          L: 126,
-          S: this,
-          C: (f, a) => f(...a)
-        });
-        this._ready.wake();
-      },
-      onclose: () => {
-        log("closed", this.info, {
-          F: __dxlog_file2,
-          L: 131,
-          S: this,
-          C: (f, a) => f(...a)
-        });
-      },
-      onerror: (event) => {
-        log.catch(event.error, this.info, {
-          F: __dxlog_file2,
-          L: 135,
-          S: this,
-          C: (f, a) => f(...a)
-        });
-        this._ready.throw(event.error);
-      },
-      /**
-      * https://developer.mozilla.org/en-US/docs/Web/API/MessageEvent/data
-      */
-      onmessage: async (event) => {
-        const data = await toUint8Array(event.data);
-        const message = buf2.fromBinary(MessageSchema2, data);
-        log("received", {
-          deviceKey: this._deviceKey,
-          payload: protocol.getPayloadType(message)
-        }, {
-          F: __dxlog_file2,
-          L: 145,
-          S: this,
-          C: (f, a) => f(...a)
-        });
-        if (message) {
-          for (const listener of this._listeners) {
-            try {
-              await listener(message);
-            } catch (err) {
-              log.error("processing", {
-                err,
-                payload: protocol.getPayloadType(message)
-              }, {
-                F: __dxlog_file2,
-                L: 151,
-                S: this,
-                C: (f, a) => f(...a)
-              });
-            }
+    this._ws.onopen = () => {
+      log2("opened", this.info, {
+        F: __dxlog_file3,
+        L: 124,
+        S: this,
+        C: (f, a) => f(...a)
+      });
+      this._ready.wake();
+    };
+    this._ws.onclose = () => {
+      log2("closed", this.info, {
+        F: __dxlog_file3,
+        L: 128,
+        S: this,
+        C: (f, a) => f(...a)
+      });
+      this._persistentLifecycle.scheduleRestart();
+    };
+    this._ws.onerror = (event) => {
+      log2.warn("EdgeClient socket error", {
+        error: event.error,
+        info: event.message
+      }, {
+        F: __dxlog_file3,
+        L: 132,
+        S: this,
+        C: (f, a) => f(...a)
+      });
+      this._persistentLifecycle.scheduleRestart();
+    };
+    this._ws.onmessage = async (event) => {
+      if (event.data === "__pong__") {
+        this._onHeartbeat();
+        return;
+      }
+      const data = await toUint8Array(event.data);
+      const message = buf2.fromBinary(MessageSchema2, data);
+      log2("received", {
+        peerKey: this._peerKey,
+        payload: protocol.getPayloadType(message)
+      }, {
+        F: __dxlog_file3,
+        L: 145,
+        S: this,
+        C: (f, a) => f(...a)
+      });
+      if (message) {
+        for (const listener of this._listeners) {
+          try {
+            await listener(message);
+          } catch (err) {
+            log2.error("processing", {
+              err,
+              payload: protocol.getPayloadType(message)
+            }, {
+              F: __dxlog_file3,
+              L: 151,
+              S: this,
+              C: (f, a) => f(...a)
+            });
           }
         }
       }
-    });
+    };
     await this._ready.wait({
       timeout: this._config.timeout ?? DEFAULT_TIMEOUT
     });
+    this._keepaliveCtx = new Context(void 0, {
+      F: __dxlog_file3,
+      L: 158
+    });
+    scheduleTaskInterval(this._keepaliveCtx, async () => {
+      this._ws?.send("__ping__");
+    }, SIGNAL_KEEPALIVE_INTERVAL);
+    this._ws.send("__ping__");
+    this._onHeartbeat();
   }
   async _closeWebSocket() {
-    this._ready.reset();
-    this._ws.close();
-    this._ws = void 0;
+    if (!this._ws) {
+      return;
+    }
+    try {
+      this._ready.throw(new WebsocketClosedError());
+      this._ready.reset();
+      void this._keepaliveCtx?.dispose();
+      this._keepaliveCtx = void 0;
+      void this._heartBeatContext?.dispose();
+      this._heartBeatContext = void 0;
+      this._ws.onopen = () => {
+      };
+      this._ws.onclose = () => {
+      };
+      this._ws.onerror = () => {
+      };
+      this._ws.close();
+      this._ws = void 0;
+    } catch (err) {
+      if (err instanceof Error && err.message.includes("WebSocket is closed before the connection is established.")) {
+        return;
+      }
+      log2.warn("Error closing websocket", {
+        err
+      }, {
+        F: __dxlog_file3,
+        L: 194,
+        S: this,
+        C: (f, a) => f(...a)
+      });
+    }
   }
   /**
   * Send message.
   * NOTE: The message is guaranteed to be delivered but the service must respond with a message to confirm processing.
   */
-  // TODO(burdon): Implement ACK?
   async send(message) {
-    await this._ready.wait({
-      timeout: this._config.timeout ?? DEFAULT_TIMEOUT
-    });
+    if (this._ready.state !== TriggerState.RESOLVED) {
+      await this._ready.wait({
+        timeout: this._config.timeout ?? DEFAULT_TIMEOUT
+      });
+    }
     invariant2(this._ws, void 0, {
-      F: __dxlog_file2,
-      L: 174,
+      F: __dxlog_file3,
+      L: 206,
       S: this,
       A: [
         "this._ws",
         ""
       ]
     });
-    invariant2(!message.source || message.source.peerKey === this._deviceKey.toHex(), void 0, {
-      F: __dxlog_file2,
-      L: 175,
+    invariant2(!message.source || message.source.peerKey === this._peerKey, void 0, {
+      F: __dxlog_file3,
+      L: 207,
       S: this,
       A: [
-        "!message.source || message.source.peerKey === this._deviceKey.toHex()",
+        "!message.source || message.source.peerKey === this._peerKey",
         ""
       ]
     });
-    log("sending...", {
-      deviceKey: this._deviceKey,
+    log2("sending...", {
+      peerKey: this._peerKey,
       payload: protocol.getPayloadType(message)
     }, {
-      F: __dxlog_file2,
-      L: 176,
+      F: __dxlog_file3,
+      L: 208,
       S: this,
       C: (f, a) => f(...a)
     });
     this._ws.send(buf2.toBinary(MessageSchema2, message));
   }
+  _onHeartbeat() {
+    if (this._lifecycleState !== LifecycleState2.OPEN) {
+      return;
+    }
+    void this._heartBeatContext?.dispose();
+    this._heartBeatContext = new Context(void 0, {
+      F: __dxlog_file3,
+      L: 217
+    });
+    scheduleTask(this._heartBeatContext, () => {
+      this._persistentLifecycle.scheduleRestart();
+    }, 2 * SIGNAL_KEEPALIVE_INTERVAL);
+  }
 };
 export {
   EdgeClient,

package/dist/lib/browser/index.mjs.map

@@ -1,7 +1,7 @@
 {
   "version": 3,
-  "sources": ["../../../src/index.ts", "../../../src/client.ts", "../../../src/defs.ts", "../../../src/protocol.ts"],
-  "sourcesContent": ["//\n// Copyright 2024 DXOS.org\n//\n\nexport * from '@dxos/protocols/buf/dxos/edge/messenger_pb';\n\nexport * from './client';\nexport * from './defs';\nexport * from './protocol';\n", "//\n// Copyright 2024 DXOS.org\n//\n\nimport WebSocket from 'isomorphic-ws';\n\nimport { Trigger } from '@dxos/async';\nimport { LifecycleState, Resource, type Lifecycle } from '@dxos/context';\nimport { invariant } from '@dxos/invariant';\nimport { type PublicKey } from '@dxos/keys';\nimport { log } from '@dxos/log';\nimport { buf } from '@dxos/protocols/buf';\nimport { type Message, MessageSchema } from '@dxos/protocols/buf/dxos/edge/messenger_pb';\n\nimport { protocol } from './defs';\nimport { type Protocol, toUint8Array } from './protocol';\n\nconst DEFAULT_TIMEOUT = 5_000;\n\nexport type MessageListener = (message: Message) => void | Promise<void>;\n\nexport interface EdgeConnection extends Required<Lifecycle> {\n  get info(): any;\n  get identityKey(): PublicKey;\n  get deviceKey(): PublicKey;\n  get isOpen(): boolean;\n  setIdentity(params: { deviceKey: PublicKey; identityKey: PublicKey }): void;\n  addListener(listener: MessageListener): () => void;\n  send(message: Message): Promise<void>;\n}\n\nexport type MessengerConfig = {\n  socketEndpoint: string;\n  timeout?: number;\n  protocol?: Protocol;\n};\n\n/**\n * Messenger client.\n */\n// TODO(dmaretskyi): Rename EdgeClient.\n// TODO(mykola): Handle reconnections.\nexport class EdgeClient extends Resource implements EdgeConnection {\n  private readonly _listeners = new Set<MessageListener>();\n  private _reconnect?: Promise<void> = undefined;\n  private readonly _protocol: Protocol;\n  private _ready = new Trigger();\n  private _ws?: WebSocket = undefined;\n\n  constructor(\n    private _identityKey: PublicKey,\n    private _deviceKey: PublicKey,\n    private readonly _config: MessengerConfig,\n  ) {\n    super();\n    this._protocol = this._config.protocol ?? protocol;\n  }\n\n  // TODO(burdon): Attach logging.\n  public get info() {\n    return {\n      open: this.isOpen,\n      identity: this._identityKey,\n      device: this._deviceKey,\n    };\n  }\n\n  get identityKey() {\n    return this._identityKey;\n  }\n\n  get deviceKey() {\n    return this._deviceKey;\n  }\n\n  public get isOpen() {\n    return this._lifecycleState === LifecycleState.OPEN;\n  }\n\n  setIdentity({ deviceKey, identityKey }: { deviceKey: PublicKey; identityKey: PublicKey }) {\n    this._deviceKey = deviceKey;\n    this._identityKey = identityKey;\n    this._reconnect = this._closeWebSocket()\n      .then(async () => {\n        await this._openWebSocket();\n      })\n      .catch((err) => log.catch(err));\n  }\n\n  public addListener(listener: MessageListener): () => void {\n    this._listeners.add(listener);\n    return () => this._listeners.delete(listener);\n  }\n\n  /**\n   * Open connection to messaging service.\n   */\n  protected override async _open() {\n    await this._reconnect;\n    if (this._ws) {\n      return;\n    }\n    invariant(this._deviceKey && this._identityKey);\n    log.info('opening...', { info: this.info });\n\n    // TODO: handle reconnects\n    await this._openWebSocket();\n    log.info('opened', { info: this.info });\n  }\n\n  /**\n   * Close connection and free resources.\n   */\n  protected override async _close() {\n    log('closing...', { deviceKey: this._deviceKey });\n    await this._reconnect;\n    await this._closeWebSocket();\n    log('closed', { deviceKey: this._deviceKey });\n  }\n\n  private async _openWebSocket() {\n    const url = new URL(`/ws/${this._identityKey.toHex()}/${this._deviceKey.toHex()}`, this._config.socketEndpoint);\n    this._ws = new WebSocket(url);\n    Object.assign<WebSocket, Partial<WebSocket>>(this._ws, {\n      onopen: () => {\n        log('opened', this.info);\n        this._ready.wake();\n      },\n\n      onclose: () => {\n        log('closed', this.info);\n      },\n\n      onerror: (event) => {\n        log.catch(event.error, this.info);\n        this._ready.throw(event.error);\n      },\n\n      /**\n       * https://developer.mozilla.org/en-US/docs/Web/API/MessageEvent/data\n       */\n      onmessage: async (event) => {\n        const data = await toUint8Array(event.data);\n        const message = buf.fromBinary(MessageSchema, data);\n        log('received', { deviceKey: this._deviceKey, payload: protocol.getPayloadType(message) });\n        if (message) {\n          for (const listener of this._listeners) {\n            try {\n              await listener(message);\n            } catch (err) {\n              log.error('processing', { err, payload: protocol.getPayloadType(message) });\n            }\n          }\n        }\n      },\n    });\n\n    await this._ready.wait({ timeout: this._config.timeout ?? DEFAULT_TIMEOUT });\n  }\n\n  private async _closeWebSocket() {\n    this._ready.reset();\n    this._ws!.close();\n    this._ws = undefined;\n  }\n\n  /**\n   * Send message.\n   * NOTE: The message is guaranteed to be delivered but the service must respond with a message to confirm processing.\n   */\n  // TODO(burdon): Implement ACK?\n  public async send(message: Message): Promise<void> {\n    await this._ready.wait({ timeout: this._config.timeout ?? DEFAULT_TIMEOUT });\n    invariant(this._ws);\n    invariant(!message.source || message.source.peerKey === this._deviceKey.toHex());\n    log('sending...', { deviceKey: this._deviceKey, payload: protocol.getPayloadType(message) });\n    this._ws.send(buf.toBinary(MessageSchema, message));\n  }\n}\n", "//\n// Copyright 2024 DXOS.org\n//\n\nimport { AnySchema } from '@bufbuild/protobuf/wkt';\n\nimport { SwarmRequestSchema, SwarmResponseSchema, TextMessageSchema } from '@dxos/protocols/buf/dxos/edge/messenger_pb';\n\nimport { Protocol } from './protocol';\n\nexport const protocol = new Protocol([SwarmRequestSchema, SwarmResponseSchema, TextMessageSchema, AnySchema]);\n", "//\n// Copyright 2024 DXOS.org\n//\n\nimport { invariant } from '@dxos/invariant';\nimport { buf, bufWkt } from '@dxos/protocols/buf';\nimport { type Message, MessageSchema, type Peer as PeerProto } from '@dxos/protocols/buf/dxos/edge/messenger_pb';\nimport { bufferToArray } from '@dxos/util';\n\nexport type PeerData = Partial<PeerProto>;\n\nexport const getTypename = (typeName: string) => `type.googleapis.com/${typeName}`;\n\n/**\n * NOTE: The type registry should be extended with all message types.\n */\nexport class Protocol {\n  private readonly _typeRegistry: buf.Registry;\n\n  constructor(types: buf.DescMessage[]) {\n    this._typeRegistry = buf.createRegistry(...types);\n  }\n\n  get typeRegistry(): buf.Registry {\n    return this._typeRegistry;\n  }\n\n  toJson(message: Message): any {\n    try {\n      return buf.toJson(MessageSchema, message, { registry: this.typeRegistry });\n    } catch (err) {\n      return { type: this.getPayloadType(message) };\n    }\n  }\n\n  /**\n   * Return the payload with the given type.\n   */\n  getPayload<Desc extends buf.DescMessage>(message: Message, type: Desc): buf.MessageShape<Desc> {\n    invariant(message.payload);\n    const payloadTypename = this.getPayloadType(message);\n    if (type && type.typeName !== payloadTypename) {\n      throw new Error(`Unexpected payload type: ${payloadTypename}; expected ${type.typeName}`);\n    }\n\n    invariant(bufWkt.anyIs(message.payload, type), `Unexpected payload type: ${payloadTypename}}`);\n    const payload = bufWkt.anyUnpack(message.payload, this.typeRegistry) as buf.MessageShape<Desc>;\n    invariant(payload, `Empty payload: ${payloadTypename}}`);\n    return payload;\n  }\n\n  /**\n   * Get the payload type.\n   */\n  getPayloadType(message: Message): string | undefined {\n    if (!message.payload) {\n      return undefined;\n    }\n\n    const [, type] = message.payload.typeUrl.split('/');\n    return type;\n  }\n\n  /**\n   * Create a packed message.\n   */\n  createMessage<Desc extends buf.DescMessage>(\n    type: Desc,\n    {\n      source,\n      target,\n      payload,\n      serviceId,\n    }: {\n      source?: PeerData;\n      target?: PeerData[];\n      payload?: buf.MessageInitShape<Desc>;\n      serviceId?: string;\n    },\n  ) {\n    return buf.create(MessageSchema, {\n      timestamp: new Date().toISOString(),\n      source,\n      target,\n      serviceId,\n      payload: payload ? bufWkt.anyPack(type, buf.create(type, payload)) : undefined,\n    });\n  }\n}\n\n/**\n * Convert websocket data to Uint8Array.\n */\nexport const toUint8Array = async (data: any): Promise<Uint8Array> => {\n  // Node.\n  if (data instanceof Buffer) {\n    return bufferToArray(data);\n  }\n\n  // Browser.\n  if (data instanceof Blob) {\n    return new Uint8Array(await (data as Blob).arrayBuffer());\n  }\n\n  throw new Error(`Unexpected datatype: ${data}`);\n};\n"],
-  "mappings": "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",
-  "names": ["WebSocket", "Trigger", "LifecycleState", "Resource", "invariant", "log", "buf", "MessageSchema", "AnySchema", "SwarmRequestSchema", "SwarmResponseSchema", "TextMessageSchema", "invariant", "buf", "bufWkt", "MessageSchema", "bufferToArray", "getTypename", "typeName", "Protocol", "constructor", "types", "_typeRegistry", "createRegistry", "typeRegistry", "toJson", "message", "registry", "err", "type", "getPayloadType", "getPayload", "payload", "payloadTypename", "Error", "anyIs", "anyUnpack", "undefined", "typeUrl", "split", "createMessage", "source", "target", "serviceId", "create", "timestamp", "Date", "toISOString", "anyPack", "toUint8Array", "data", "Buffer", "Blob", "Uint8Array", "arrayBuffer", "protocol", "Protocol", "SwarmRequestSchema", "SwarmResponseSchema", "TextMessageSchema", "AnySchema", "DEFAULT_TIMEOUT", "EdgeClient", "Resource", "constructor", "_identityKey", "_deviceKey", "_config", "_listeners", "Set", "_reconnect", "undefined", "_ready", "Trigger", "_ws", "_protocol", "protocol", "info", "open", "isOpen", "identity", "device", "identityKey", "deviceKey", "_lifecycleState", "LifecycleState", "OPEN", "setIdentity", "_closeWebSocket", "then", "_openWebSocket", "catch", "err", "log", "addListener", "listener", "add", "delete", "_open", "invariant", "_close", "url", "URL", "toHex", "socketEndpoint", "WebSocket", "Object", "assign", "onopen", "wake", "onclose", "onerror", "event", "error", "throw", "onmessage", "data", "toUint8Array", "message", "buf", "fromBinary", "MessageSchema", "payload", "getPayloadType", "wait", "timeout", "reset", "close", "send", "source", "peerKey", "toBinary"]
+  "sources": ["../../../src/index.ts", "../../../src/edge-client.ts", "../../../src/defs.ts", "../../../src/protocol.ts", "../../../src/errors.ts", "../../../src/persistent-lifecycle.ts"],
+  "sourcesContent": ["//\n// Copyright 2024 DXOS.org\n//\n\nexport * from '@dxos/protocols/buf/dxos/edge/messenger_pb';\n\nexport * from './edge-client';\nexport * from './defs';\nexport * from './protocol';\n", "//\n// Copyright 2024 DXOS.org\n//\n\nimport WebSocket from 'isomorphic-ws';\n\nimport { Trigger, Event, scheduleTaskInterval, scheduleTask, TriggerState } from '@dxos/async';\nimport { Context, LifecycleState, Resource, type Lifecycle } from '@dxos/context';\nimport { invariant } from '@dxos/invariant';\nimport { log } from '@dxos/log';\nimport { buf } from '@dxos/protocols/buf';\nimport { type Message, MessageSchema } from '@dxos/protocols/buf/dxos/edge/messenger_pb';\n\nimport { protocol } from './defs';\nimport { WebsocketClosedError } from './errors';\nimport { PersistentLifecycle } from './persistent-lifecycle';\nimport { type Protocol, toUint8Array } from './protocol';\n\nconst DEFAULT_TIMEOUT = 10_000;\nconst SIGNAL_KEEPALIVE_INTERVAL = 5_000;\n\nexport type MessageListener = (message: Message) => void | Promise<void>;\n\nexport interface EdgeConnection extends Required<Lifecycle> {\n  reconnect: Event;\n\n  get info(): any;\n  get identityKey(): string;\n  get peerKey(): string;\n  get isOpen(): boolean;\n  setIdentity(params: { peerKey: string; identityKey: string }): void;\n  addListener(listener: MessageListener): () => void;\n  send(message: Message): Promise<void>;\n}\n\nexport type MessengerConfig = {\n  socketEndpoint: string;\n  timeout?: number;\n  protocol?: Protocol;\n};\n\n/**\n * Messenger client.\n */\nexport class EdgeClient extends Resource implements EdgeConnection {\n  public reconnect = new Event();\n  private readonly _persistentLifecycle = new PersistentLifecycle({\n    start: async () => this._openWebSocket(),\n    stop: async () => this._closeWebSocket(),\n    onRestart: async () => this.reconnect.emit(),\n  });\n\n  private readonly _listeners = new Set<MessageListener>();\n  private readonly _protocol: Protocol;\n  private _ready = new Trigger();\n  private _ws?: WebSocket = undefined;\n  private _keepaliveCtx?: Context = undefined;\n  private _heartBeatContext?: Context = undefined;\n\n  constructor(\n    private _identityKey: string,\n    private _peerKey: string,\n    private readonly _config: MessengerConfig,\n  ) {\n    super();\n    this._protocol = this._config.protocol ?? protocol;\n  }\n\n  // TODO(burdon): Attach logging.\n  public get info() {\n    return {\n      open: this.isOpen,\n      identity: this._identityKey,\n      device: this._peerKey,\n    };\n  }\n\n  get identityKey() {\n    return this._identityKey;\n  }\n\n  get peerKey() {\n    return this._peerKey;\n  }\n\n  public get isOpen() {\n    return this._lifecycleState === LifecycleState.OPEN;\n  }\n\n  setIdentity({ peerKey, identityKey }: { peerKey: string; identityKey: string }) {\n    this._peerKey = peerKey;\n    this._identityKey = identityKey;\n    this._persistentLifecycle.scheduleRestart();\n  }\n\n  public addListener(listener: MessageListener): () => void {\n    this._listeners.add(listener);\n    return () => this._listeners.delete(listener);\n  }\n\n  /**\n   * Open connection to messaging service.\n   */\n  protected override async _open() {\n    log('opening...', { info: this.info });\n    this._persistentLifecycle.open().catch((err) => {\n      log.warn('Error while opening connection', { err });\n    });\n  }\n\n  /**\n   * Close connection and free resources.\n   */\n  protected override async _close() {\n    log('closing...', { peerKey: this._peerKey });\n    await this._persistentLifecycle.close();\n  }\n\n  private async _openWebSocket() {\n    const url = new URL(`/ws/${this._identityKey}/${this._peerKey}`, this._config.socketEndpoint);\n    this._ws = new WebSocket(url);\n\n    this._ws.onopen = () => {\n      log('opened', this.info);\n      this._ready.wake();\n    };\n    this._ws.onclose = () => {\n      log('closed', this.info);\n      this._persistentLifecycle.scheduleRestart();\n    };\n    this._ws.onerror = (event) => {\n      log.warn('EdgeClient socket error', { error: event.error, info: event.message });\n      this._persistentLifecycle.scheduleRestart();\n    };\n    /**\n     * https://developer.mozilla.org/en-US/docs/Web/API/MessageEvent/data\n     */\n    this._ws.onmessage = async (event) => {\n      if (event.data === '__pong__') {\n        this._onHeartbeat();\n        return;\n      }\n      const data = await toUint8Array(event.data);\n      const message = buf.fromBinary(MessageSchema, data);\n      log('received', { peerKey: this._peerKey, payload: protocol.getPayloadType(message) });\n      if (message) {\n        for (const listener of this._listeners) {\n          try {\n            await listener(message);\n          } catch (err) {\n            log.error('processing', { err, payload: protocol.getPayloadType(message) });\n          }\n        }\n      }\n    };\n\n    await this._ready.wait({ timeout: this._config.timeout ?? DEFAULT_TIMEOUT });\n    this._keepaliveCtx = new Context();\n    scheduleTaskInterval(\n      this._keepaliveCtx,\n      async () => {\n        // TODO(mykola): use RFC6455 ping/pong once implemented in the browser?\n        // Cloudflare's worker responds to this `without interrupting hibernation`. https://developers.cloudflare.com/durable-objects/api/websockets/#setwebsocketautoresponse\n        this._ws?.send('__ping__');\n      },\n      SIGNAL_KEEPALIVE_INTERVAL,\n    );\n    this._ws.send('__ping__');\n    this._onHeartbeat();\n  }\n\n  private async _closeWebSocket() {\n    if (!this._ws) {\n      return;\n    }\n    try {\n      this._ready.throw(new WebsocketClosedError());\n      this._ready.reset();\n      void this._keepaliveCtx?.dispose();\n      this._keepaliveCtx = undefined;\n      void this._heartBeatContext?.dispose();\n      this._heartBeatContext = undefined;\n\n      // NOTE: Remove event handlers to avoid scheduling restart.\n      this._ws.onopen = () => {};\n      this._ws.onclose = () => {};\n      this._ws.onerror = () => {};\n      this._ws.close();\n      this._ws = undefined;\n    } catch (err) {\n      if (err instanceof Error && err.message.includes('WebSocket is closed before the connection is established.')) {\n        return;\n      }\n      log.warn('Error closing websocket', { err });\n    }\n  }\n\n  /**\n   * Send message.\n   * NOTE: The message is guaranteed to be delivered but the service must respond with a message to confirm processing.\n   */\n  public async send(message: Message): Promise<void> {\n    if (this._ready.state !== TriggerState.RESOLVED) {\n      await this._ready.wait({ timeout: this._config.timeout ?? DEFAULT_TIMEOUT });\n    }\n    invariant(this._ws);\n    invariant(!message.source || message.source.peerKey === this._peerKey);\n    log('sending...', { peerKey: this._peerKey, payload: protocol.getPayloadType(message) });\n    this._ws.send(buf.toBinary(MessageSchema, message));\n  }\n\n  private _onHeartbeat() {\n    if (this._lifecycleState !== LifecycleState.OPEN) {\n      return;\n    }\n    void this._heartBeatContext?.dispose();\n    this._heartBeatContext = new Context();\n    scheduleTask(\n      this._heartBeatContext,\n      () => {\n        this._persistentLifecycle.scheduleRestart();\n      },\n      2 * SIGNAL_KEEPALIVE_INTERVAL,\n    );\n  }\n}\n", "//\n// Copyright 2024 DXOS.org\n//\n\nimport { AnySchema } from '@bufbuild/protobuf/wkt';\n\nimport { SwarmRequestSchema, SwarmResponseSchema, TextMessageSchema } from '@dxos/protocols/buf/dxos/edge/messenger_pb';\n\nimport { Protocol } from './protocol';\n\nexport const protocol = new Protocol([SwarmRequestSchema, SwarmResponseSchema, TextMessageSchema, AnySchema]);\n", "//\n// Copyright 2024 DXOS.org\n//\n\nimport { invariant } from '@dxos/invariant';\nimport { buf, bufWkt } from '@dxos/protocols/buf';\nimport { type Message, MessageSchema, type Peer as PeerProto } from '@dxos/protocols/buf/dxos/edge/messenger_pb';\nimport { bufferToArray } from '@dxos/util';\n\nexport type PeerData = Partial<PeerProto>;\n\nexport const getTypename = (typeName: string) => `type.googleapis.com/${typeName}`;\n\n/**\n * NOTE: The type registry should be extended with all message types.\n */\nexport class Protocol {\n  private readonly _typeRegistry: buf.Registry;\n\n  constructor(types: buf.DescMessage[]) {\n    this._typeRegistry = buf.createRegistry(...types);\n  }\n\n  get typeRegistry(): buf.Registry {\n    return this._typeRegistry;\n  }\n\n  toJson(message: Message): any {\n    try {\n      return buf.toJson(MessageSchema, message, { registry: this.typeRegistry });\n    } catch (err) {\n      return { type: this.getPayloadType(message) };\n    }\n  }\n\n  /**\n   * Return the payload with the given type.\n   */\n  getPayload<Desc extends buf.DescMessage>(message: Message, type: Desc): buf.MessageShape<Desc> {\n    invariant(message.payload);\n    const payloadTypename = this.getPayloadType(message);\n    if (type && type.typeName !== payloadTypename) {\n      throw new Error(`Unexpected payload type: ${payloadTypename}; expected ${type.typeName}`);\n    }\n\n    invariant(bufWkt.anyIs(message.payload, type), `Unexpected payload type: ${payloadTypename}}`);\n    const payload = bufWkt.anyUnpack(message.payload, this.typeRegistry) as buf.MessageShape<Desc>;\n    invariant(payload, `Empty payload: ${payloadTypename}}`);\n    return payload;\n  }\n\n  /**\n   * Get the payload type.\n   */\n  getPayloadType(message: Message): string | undefined {\n    if (!message.payload) {\n      return undefined;\n    }\n\n    const [, type] = message.payload.typeUrl.split('/');\n    return type;\n  }\n\n  /**\n   * Create a packed message.\n   */\n  createMessage<Desc extends buf.DescMessage>(\n    type: Desc,\n    {\n      source,\n      target,\n      payload,\n      serviceId,\n    }: {\n      source?: PeerData;\n      target?: PeerData[];\n      payload?: buf.MessageInitShape<Desc>;\n      serviceId?: string;\n    },\n  ) {\n    return buf.create(MessageSchema, {\n      timestamp: new Date().toISOString(),\n      source,\n      target,\n      serviceId,\n      payload: payload ? bufWkt.anyPack(type, buf.create(type, payload)) : undefined,\n    });\n  }\n}\n\n/**\n * Convert websocket data to Uint8Array.\n */\nexport const toUint8Array = async (data: any): Promise<Uint8Array> => {\n  // Node.\n  if (data instanceof Buffer) {\n    return bufferToArray(data);\n  }\n\n  // Browser.\n  if (data instanceof Blob) {\n    return new Uint8Array(await (data as Blob).arrayBuffer());\n  }\n\n  throw new Error(`Unexpected datatype: ${data}`);\n};\n", "//\n// Copyright 2024 DXOS.org\n//\n\nexport class WebsocketClosedError extends Error {\n  constructor() {\n    super('WebSocket connection closed');\n  }\n}\n", "//\n// Copyright 2024 DXOS.org\n//\n\nimport { DeferredTask, sleep, synchronized } from '@dxos/async';\nimport { cancelWithContext, LifecycleState, Resource } from '@dxos/context';\nimport { warnAfterTimeout } from '@dxos/debug';\nimport { log } from '@dxos/log';\n\nconst INIT_RESTART_DELAY = 100;\nconst DEFAULT_MAX_RESTART_DELAY = 5000;\n\nexport type PersistentLifecycleParams = {\n  /**\n   * Create connection.\n   * If promise resolves successfully, connection is considered established.\n   */\n  start: () => Promise<void>;\n\n  /**\n   * Reset connection to initial state.\n   */\n  stop: () => Promise<void>;\n\n  /**\n   * Called after successful start.\n   */\n  onRestart?: () => Promise<void>;\n\n  /**\n   * Maximum delay between restartion attempts.\n   * Default: 5000ms\n   */\n  maxRestartDelay?: number;\n};\n\n/**\n * Handles restarts (e.g. persists connection).\n * Restarts are scheduled with exponential backoff.\n */\nexport class PersistentLifecycle extends Resource {\n  private readonly _start: () => Promise<void>;\n  private readonly _stop: () => Promise<void>;\n  private readonly _onRestart?: () => Promise<void>;\n  private readonly _maxRestartDelay: number;\n\n  private _restartTask?: DeferredTask = undefined;\n  private _restartAfter = 0;\n\n  constructor({ start, stop, onRestart, maxRestartDelay = DEFAULT_MAX_RESTART_DELAY }: PersistentLifecycleParams) {\n    super();\n    this._start = start;\n    this._stop = stop;\n    this._onRestart = onRestart;\n    this._maxRestartDelay = maxRestartDelay;\n  }\n\n  @synchronized\n  protected override async _open() {\n    this._restartTask = new DeferredTask(this._ctx, async () => {\n      try {\n        await this._restart();\n      } catch (err) {\n        log.warn('Restart failed', { err });\n        this._restartTask?.schedule();\n      }\n    });\n    await this._start().catch((err) => {\n      log.warn('Start failed', { err });\n      this._restartTask?.schedule();\n    });\n  }\n\n  protected override async _close() {\n    await this._restartTask?.join();\n    await this._stop();\n    this._restartTask = undefined;\n  }\n\n  private async _restart() {\n    log(`restarting in ${this._restartAfter}ms`, { state: this._lifecycleState });\n    await this._stop();\n    if (this._lifecycleState !== LifecycleState.OPEN) {\n      return;\n    }\n    await cancelWithContext(this._ctx!, sleep(this._restartAfter));\n    this._restartAfter = Math.min(Math.max(this._restartAfter * 2, INIT_RESTART_DELAY), this._maxRestartDelay);\n\n    // May fail if the connection is not established.\n    await warnAfterTimeout(5_000, 'Connection establishment takes too long', () => this._start());\n\n    this._restartAfter = 0;\n    await this._onRestart?.();\n  }\n\n  /**\n   * Scheduling restart should be done from outside.\n   */\n  @synchronized\n  scheduleRestart() {\n    if (this._lifecycleState !== LifecycleState.OPEN) {\n      return;\n    }\n    this._restartTask!.schedule();\n  }\n}\n"],
+  "mappings": "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",
+  "names": ["WebSocket", "Trigger", "Event", "scheduleTaskInterval", "scheduleTask", "TriggerState", "Context", "LifecycleState", "Resource", "invariant", "log", "buf", "MessageSchema", "AnySchema", "SwarmRequestSchema", "SwarmResponseSchema", "TextMessageSchema", "invariant", "buf", "bufWkt", "MessageSchema", "bufferToArray", "getTypename", "typeName", "Protocol", "constructor", "types", "_typeRegistry", "createRegistry", "typeRegistry", "toJson", "message", "registry", "err", "type", "getPayloadType", "getPayload", "payload", "payloadTypename", "Error", "anyIs", "anyUnpack", "undefined", "typeUrl", "split", "createMessage", "source", "target", "serviceId", "create", "timestamp", "Date", "toISOString", "anyPack", "toUint8Array", "data", "Buffer", "Blob", "Uint8Array", "arrayBuffer", "protocol", "Protocol", "SwarmRequestSchema", "SwarmResponseSchema", "TextMessageSchema", "AnySchema", "WebsocketClosedError", "Error", "constructor", "DeferredTask", "sleep", "synchronized", "cancelWithContext", "LifecycleState", "Resource", "warnAfterTimeout", "log", "INIT_RESTART_DELAY", "DEFAULT_MAX_RESTART_DELAY", "PersistentLifecycle", "constructor", "start", "stop", "onRestart", "maxRestartDelay", "_restartTask", "undefined", "_restartAfter", "_start", "_stop", "_onRestart", "_maxRestartDelay", "_open", "_ctx", "_restart", "err", "warn", "schedule", "catch", "_close", "join", "state", "_lifecycleState", "OPEN", "Math", "min", "max", "scheduleRestart", "DEFAULT_TIMEOUT", "SIGNAL_KEEPALIVE_INTERVAL", "EdgeClient", "Resource", "constructor", "_identityKey", "_peerKey", "_config", "reconnect", "Event", "_persistentLifecycle", "PersistentLifecycle", "start", "_openWebSocket", "stop", "_closeWebSocket", "onRestart", "emit", "_listeners", "Set", "_ready", "Trigger", "_ws", "undefined", "_keepaliveCtx", "_heartBeatContext", "_protocol", "protocol", "info", "open", "isOpen", "identity", "device", "identityKey", "peerKey", "_lifecycleState", "LifecycleState", "OPEN", "setIdentity", "scheduleRestart", "addListener", "listener", "add", "delete", "_open", "log", "catch", "err", "warn", "_close", "close", "url", "URL", "socketEndpoint", "WebSocket", "onopen", "wake", "onclose", "onerror", "event", "error", "message", "onmessage", "data", "_onHeartbeat", "toUint8Array", "buf", "fromBinary", "MessageSchema", "payload", "getPayloadType", "wait", "timeout", "Context", "scheduleTaskInterval", "send", "throw", "WebsocketClosedError", "reset", "dispose", "Error", "includes", "state", "TriggerState", "RESOLVED", "invariant", "source", "toBinary", "scheduleTask"]
 }