@dxos/edge-client 0.6.6-main.e1a6e1f

package/LICENSE

@@ -0,0 +1,8 @@
+MIT License 
+Copyright (c) 2022 DXOS
+
+Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.

package/dist/lib/browser/index.mjs

@@ -0,0 +1,308 @@
+// 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
+import WebSocket from "isomorphic-ws";
+import { Trigger } from "@dxos/async";
+import { invariant as invariant2 } from "@dxos/invariant";
+import { log } from "@dxos/log";
+import { buf as buf2 } from "@dxos/protocols/buf";
+import { MessageSchema as MessageSchema2 } from "@dxos/protocols/buf/dxos/edge/messenger_pb";
+
+// packages/core/mesh/edge-client/src/defs.ts
+import { SwarmRequestSchema, SwarmResponseSchema, TextMessageSchema } from "@dxos/protocols/buf/dxos/edge/messenger_pb";
+
+// packages/core/mesh/edge-client/src/protocol.ts
+import { invariant } from "@dxos/invariant";
+import { buf, bufWkt } from "@dxos/protocols/buf";
+import { MessageSchema } from "@dxos/protocols/buf/dxos/edge/messenger_pb";
+import { bufferToArray } from "@dxos/util";
+var __dxlog_file = "/home/runner/work/dxos/dxos/packages/core/mesh/edge-client/src/protocol.ts";
+var getTypename = (typeName) => `type.googleapis.com/${typeName}`;
+var Protocol = class {
+  constructor(types) {
+    this._typeRegistry = buf.createRegistry(...types);
+  }
+  get typeRegistry() {
+    return this._typeRegistry;
+  }
+  toJson(message) {
+    try {
+      return buf.toJson(MessageSchema, message, {
+        registry: this.typeRegistry
+      });
+    } catch (err) {
+      return {
+        type: this.getPayloadType(message)
+      };
+    }
+  }
+  /**
+  * Return the payload with the given type.
+  */
+  getPayload(message, type) {
+    invariant(message.payload, void 0, {
+      F: __dxlog_file,
+      L: 40,
+      S: this,
+      A: [
+        "message.payload",
+        ""
+      ]
+    });
+    const payloadTypename = this.getPayloadType(message);
+    if (type && type.typeName !== payloadTypename) {
+      throw new Error(`Unexpected payload type: ${payloadTypename}; expected ${type.typeName}`);
+    }
+    invariant(bufWkt.anyIs(message.payload, type), `Unexpected payload type: ${payloadTypename}}`, {
+      F: __dxlog_file,
+      L: 46,
+      S: this,
+      A: [
+        "bufWkt.anyIs(message.payload, type)",
+        "`Unexpected payload type: ${payloadTypename}}`"
+      ]
+    });
+    const payload = bufWkt.anyUnpack(message.payload, this.typeRegistry);
+    invariant(payload, `Empty payload: ${payloadTypename}}`, {
+      F: __dxlog_file,
+      L: 48,
+      S: this,
+      A: [
+        "payload",
+        "`Empty payload: ${payloadTypename}}`"
+      ]
+    });
+    return payload;
+  }
+  /**
+  * Get the payload type.
+  */
+  getPayloadType(message) {
+    if (!message.payload) {
+      return void 0;
+    }
+    const [, type] = message.payload.typeUrl.split("/");
+    return type;
+  }
+  /**
+  * Create a packed message.
+  */
+  createMessage(type, { source, target, payload, serviceId }) {
+    return buf.create(MessageSchema, {
+      timestamp: (/* @__PURE__ */ new Date()).toISOString(),
+      source,
+      target,
+      serviceId,
+      payload: payload ? bufWkt.anyPack(type, buf.create(type, payload)) : void 0
+    });
+  }
+};
+var toUint8Array = async (data) => {
+  if (data instanceof Buffer) {
+    return bufferToArray(data);
+  }
+  if (data instanceof Blob) {
+    return new Uint8Array(await data.arrayBuffer());
+  }
+  throw new Error(`Unexpected datatype: ${data}`);
+};
+
+// packages/core/mesh/edge-client/src/defs.ts
+var protocol = new Protocol([
+  SwarmRequestSchema,
+  SwarmResponseSchema,
+  TextMessageSchema
+]);
+
+// 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 {
+  constructor(_identityKey, _deviceKey, _config) {
+    this._identityKey = _identityKey;
+    this._deviceKey = _deviceKey;
+    this._config = _config;
+    this._listeners = /* @__PURE__ */ new Set();
+    this._protocol = this._config.protocol ?? protocol;
+  }
+  // TODO(burdon): Attach logging.
+  get info() {
+    return {
+      open: this.isOpen,
+      identity: this._identityKey,
+      device: this._deviceKey
+    };
+  }
+  get identityKey() {
+    return this._identityKey;
+  }
+  get deviceKey() {
+    return this._deviceKey;
+  }
+  get isOpen() {
+    return !!this._ws;
+  }
+  addListener(listener) {
+    this._listeners.add(listener);
+    return () => this._listeners.delete(listener);
+  }
+  /**
+  * Open connection to messaging service.
+  */
+  async open() {
+    invariant2(!this._ws, void 0, {
+      F: __dxlog_file2,
+      L: 88,
+      S: this,
+      A: [
+        "!this._ws",
+        ""
+      ]
+    });
+    log.info("opening...", {
+      info: this.info
+    }, {
+      F: __dxlog_file2,
+      L: 89,
+      S: this,
+      C: (f, a) => f(...a)
+    });
+    const ready = new Trigger();
+    const url = new URL(`/ws/${this._identityKey.toHex()}/${this._deviceKey.toHex()}`, this._config.socketEndpoint);
+    this._ws = new WebSocket(url);
+    Object.assign(this._ws, {
+      onopen: () => {
+        log.info("opened", this.info, {
+          F: __dxlog_file2,
+          L: 97,
+          S: this,
+          C: (f, a) => f(...a)
+        });
+        ready.wake(true);
+      },
+      onclose: () => {
+        log.info("closed", this.info, {
+          F: __dxlog_file2,
+          L: 102,
+          S: this,
+          C: (f, a) => f(...a)
+        });
+        ready.wake(false);
+      },
+      onerror: (event) => {
+        log.catch(event.error, this.info, {
+          F: __dxlog_file2,
+          L: 107,
+          S: this,
+          C: (f, a) => f(...a)
+        });
+        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: 117,
+          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: 123,
+                S: this,
+                C: (f, a) => f(...a)
+              });
+            }
+          }
+        }
+      }
+    });
+    const result = await ready.wait({
+      timeout: this._config.timeout ?? DEFAULT_TIMEOUT
+    });
+    log.info("opened", {
+      info: this.info
+    }, {
+      F: __dxlog_file2,
+      L: 131,
+      S: this,
+      C: (f, a) => f(...a)
+    });
+    return result;
+  }
+  /**
+  * Close connection and free resources.
+  */
+  async close() {
+    if (this._ws) {
+      log.info("closing...", {
+        deviceKey: this._deviceKey
+      }, {
+        F: __dxlog_file2,
+        L: 140,
+        S: this,
+        C: (f, a) => f(...a)
+      });
+      this._ws.close();
+      this._ws = void 0;
+      log.info("closed", {
+        deviceKey: this._deviceKey
+      }, {
+        F: __dxlog_file2,
+        L: 143,
+        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) {
+    invariant2(this._ws, void 0, {
+      F: __dxlog_file2,
+      L: 153,
+      S: this,
+      A: [
+        "this._ws",
+        ""
+      ]
+    });
+    log("sending...", {
+      deviceKey: this._deviceKey,
+      payload: protocol.getPayloadType(message)
+    }, {
+      F: __dxlog_file2,
+      L: 154,
+      S: this,
+      C: (f, a) => f(...a)
+    });
+    this._ws.send(buf2.toBinary(MessageSchema2, message));
+  }
+};
+export {
+  EdgeClient,
+  Protocol,
+  getTypename,
+  protocol,
+  toUint8Array
+};
+//# sourceMappingURL=index.mjs.map

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

@@ -0,0 +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 { 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\n/**\n *\n */\nexport interface EdgeConnection {\n  get info(): any;\n  get identityKey(): PublicKey;\n  get deviceKey(): PublicKey;\n  get isOpen(): boolean;\n  addListener(listener: MessageListener): () => void;\n  open(): Promise<boolean>;\n  close(): Promise<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.\nexport class EdgeClient implements EdgeConnection {\n  private readonly _listeners: Set<MessageListener> = new Set();\n  private readonly _protocol: Protocol;\n  private _ws?: WebSocket;\n\n  constructor(\n    private readonly _identityKey: PublicKey,\n    private readonly _deviceKey: PublicKey,\n    private readonly _config: MessengerConfig,\n  ) {\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._ws;\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  public async open(): Promise<boolean> {\n    invariant(!this._ws);\n    log.info('opening...', { info: this.info });\n    const ready = new Trigger<boolean>();\n\n    // TODO: handle reconnects\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.info('opened', this.info);\n        ready.wake(true);\n      },\n\n      onclose: () => {\n        log.info('closed', this.info);\n        ready.wake(false);\n      },\n\n      onerror: (event) => {\n        log.catch(event.error, this.info);\n        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    const result = await ready.wait({ timeout: this._config.timeout ?? DEFAULT_TIMEOUT });\n    log.info('opened', { info: this.info });\n    return result;\n  }\n\n  /**\n   * Close connection and free resources.\n   */\n  public async close() {\n    if (this._ws) {\n      log.info('closing...', { deviceKey: this._deviceKey });\n      this._ws.close();\n      this._ws = undefined;\n      log.info('closed', { deviceKey: this._deviceKey });\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  // TODO(burdon): Implement ACK?\n  public async send(message: Message): Promise<void> {\n    invariant(this._ws);\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 { 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]);\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", "invariant", "log", "buf", "MessageSchema", "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", "DEFAULT_TIMEOUT", "EdgeClient", "constructor", "_identityKey", "_deviceKey", "_config", "_listeners", "Set", "_protocol", "protocol", "info", "open", "isOpen", "identity", "device", "identityKey", "deviceKey", "_ws", "addListener", "listener", "add", "delete", "invariant", "log", "ready", "Trigger", "url", "URL", "toHex", "socketEndpoint", "WebSocket", "Object", "assign", "onopen", "wake", "onclose", "onerror", "event", "catch", "error", "throw", "onmessage", "data", "toUint8Array", "message", "buf", "fromBinary", "MessageSchema", "payload", "getPayloadType", "err", "result", "wait", "timeout", "close", "undefined", "send", "toBinary"]
+}

package/dist/lib/browser/meta.json

@@ -0,0 +1 @@
+{"inputs":{"packages/core/mesh/edge-client/src/protocol.ts":{"bytes":10314,"imports":[{"path":"@dxos/invariant","kind":"import-statement","external":true},{"path":"@dxos/protocols/buf","kind":"import-statement","external":true},{"path":"@dxos/protocols/buf/dxos/edge/messenger_pb","kind":"import-statement","external":true},{"path":"@dxos/util","kind":"import-statement","external":true}],"format":"esm"},"packages/core/mesh/edge-client/src/defs.ts":{"bytes":1359,"imports":[{"path":"@dxos/protocols/buf/dxos/edge/messenger_pb","kind":"import-statement","external":true},{"path":"packages/core/mesh/edge-client/src/protocol.ts","kind":"import-statement","original":"./protocol"}],"format":"esm"},"packages/core/mesh/edge-client/src/client.ts":{"bytes":16849,"imports":[{"path":"isomorphic-ws","kind":"import-statement","external":true},{"path":"@dxos/async","kind":"import-statement","external":true},{"path":"@dxos/invariant","kind":"import-statement","external":true},{"path":"@dxos/log","kind":"import-statement","external":true},{"path":"@dxos/protocols/buf","kind":"import-statement","external":true},{"path":"@dxos/protocols/buf/dxos/edge/messenger_pb","kind":"import-statement","external":true},{"path":"packages/core/mesh/edge-client/src/defs.ts","kind":"import-statement","original":"./defs"},{"path":"packages/core/mesh/edge-client/src/protocol.ts","kind":"import-statement","original":"./protocol"}],"format":"esm"},"packages/core/mesh/edge-client/src/index.ts":{"bytes":836,"imports":[{"path":"@dxos/protocols/buf/dxos/edge/messenger_pb","kind":"import-statement","external":true},{"path":"packages/core/mesh/edge-client/src/client.ts","kind":"import-statement","original":"./client"},{"path":"packages/core/mesh/edge-client/src/defs.ts","kind":"import-statement","original":"./defs"},{"path":"packages/core/mesh/edge-client/src/protocol.ts","kind":"import-statement","original":"./protocol"}],"format":"esm"}},"outputs":{"packages/core/mesh/edge-client/dist/lib/browser/index.mjs.map":{"imports":[],"exports":[],"inputs":{},"bytes":13078},"packages/core/mesh/edge-client/dist/lib/browser/index.mjs":{"imports":[{"path":"@dxos/protocols/buf/dxos/edge/messenger_pb","kind":"import-statement","external":true},{"path":"isomorphic-ws","kind":"import-statement","external":true},{"path":"@dxos/async","kind":"import-statement","external":true},{"path":"@dxos/invariant","kind":"import-statement","external":true},{"path":"@dxos/log","kind":"import-statement","external":true},{"path":"@dxos/protocols/buf","kind":"import-statement","external":true},{"path":"@dxos/protocols/buf/dxos/edge/messenger_pb","kind":"import-statement","external":true},{"path":"@dxos/protocols/buf/dxos/edge/messenger_pb","kind":"import-statement","external":true},{"path":"@dxos/invariant","kind":"import-statement","external":true},{"path":"@dxos/protocols/buf","kind":"import-statement","external":true},{"path":"@dxos/protocols/buf/dxos/edge/messenger_pb","kind":"import-statement","external":true},{"path":"@dxos/util","kind":"import-statement","external":true}],"exports":["EdgeClient","Protocol","getTypename","protocol","toUint8Array"],"entryPoint":"packages/core/mesh/edge-client/src/index.ts","inputs":{"packages/core/mesh/edge-client/src/index.ts":{"bytesInOutput":60},"packages/core/mesh/edge-client/src/client.ts":{"bytesInOutput":4723},"packages/core/mesh/edge-client/src/defs.ts":{"bytesInOutput":220},"packages/core/mesh/edge-client/src/protocol.ts":{"bytesInOutput":2600}},"bytes":8008}}}

package/dist/lib/node/index.cjs

@@ -0,0 +1,337 @@
+"use strict";
+var __create = Object.create;
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __getProtoOf = Object.getPrototypeOf;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __reExport = (target, mod, secondTarget) => (__copyProps(target, mod, "default"), secondTarget && __copyProps(secondTarget, mod, "default"));
+var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__getProtoOf(mod)) : {}, __copyProps(
+  // If the importer is in node compatibility mode or this is not an ESM
+  // file that has been converted to a CommonJS file using a Babel-
+  // compatible transform (i.e. "__esModule" has not been set), then set
+  // "default" to the CommonJS "module.exports" for node compatibility.
+  isNodeMode || !mod || !mod.__esModule ? __defProp(target, "default", { value: mod, enumerable: true }) : target,
+  mod
+));
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+var node_exports = {};
+__export(node_exports, {
+  EdgeClient: () => EdgeClient,
+  Protocol: () => Protocol,
+  getTypename: () => getTypename,
+  protocol: () => protocol,
+  toUint8Array: () => toUint8Array
+});
+module.exports = __toCommonJS(node_exports);
+__reExport(node_exports, require("@dxos/protocols/buf/dxos/edge/messenger_pb"), module.exports);
+var import_isomorphic_ws = __toESM(require("isomorphic-ws"));
+var import_async = require("@dxos/async");
+var import_invariant = require("@dxos/invariant");
+var import_log = require("@dxos/log");
+var import_buf = require("@dxos/protocols/buf");
+var import_messenger_pb = require("@dxos/protocols/buf/dxos/edge/messenger_pb");
+var import_messenger_pb2 = require("@dxos/protocols/buf/dxos/edge/messenger_pb");
+var import_invariant2 = require("@dxos/invariant");
+var import_buf2 = require("@dxos/protocols/buf");
+var import_messenger_pb3 = require("@dxos/protocols/buf/dxos/edge/messenger_pb");
+var import_util = require("@dxos/util");
+var __dxlog_file = "/home/runner/work/dxos/dxos/packages/core/mesh/edge-client/src/protocol.ts";
+var getTypename = (typeName) => `type.googleapis.com/${typeName}`;
+var Protocol = class {
+  constructor(types) {
+    this._typeRegistry = import_buf2.buf.createRegistry(...types);
+  }
+  get typeRegistry() {
+    return this._typeRegistry;
+  }
+  toJson(message) {
+    try {
+      return import_buf2.buf.toJson(import_messenger_pb3.MessageSchema, message, {
+        registry: this.typeRegistry
+      });
+    } catch (err) {
+      return {
+        type: this.getPayloadType(message)
+      };
+    }
+  }
+  /**
+  * Return the payload with the given type.
+  */
+  getPayload(message, type) {
+    (0, import_invariant2.invariant)(message.payload, void 0, {
+      F: __dxlog_file,
+      L: 40,
+      S: this,
+      A: [
+        "message.payload",
+        ""
+      ]
+    });
+    const payloadTypename = this.getPayloadType(message);
+    if (type && type.typeName !== payloadTypename) {
+      throw new Error(`Unexpected payload type: ${payloadTypename}; expected ${type.typeName}`);
+    }
+    (0, import_invariant2.invariant)(import_buf2.bufWkt.anyIs(message.payload, type), `Unexpected payload type: ${payloadTypename}}`, {
+      F: __dxlog_file,
+      L: 46,
+      S: this,
+      A: [
+        "bufWkt.anyIs(message.payload, type)",
+        "`Unexpected payload type: ${payloadTypename}}`"
+      ]
+    });
+    const payload = import_buf2.bufWkt.anyUnpack(message.payload, this.typeRegistry);
+    (0, import_invariant2.invariant)(payload, `Empty payload: ${payloadTypename}}`, {
+      F: __dxlog_file,
+      L: 48,
+      S: this,
+      A: [
+        "payload",
+        "`Empty payload: ${payloadTypename}}`"
+      ]
+    });
+    return payload;
+  }
+  /**
+  * Get the payload type.
+  */
+  getPayloadType(message) {
+    if (!message.payload) {
+      return void 0;
+    }
+    const [, type] = message.payload.typeUrl.split("/");
+    return type;
+  }
+  /**
+  * Create a packed message.
+  */
+  createMessage(type, { source, target, payload, serviceId }) {
+    return import_buf2.buf.create(import_messenger_pb3.MessageSchema, {
+      timestamp: (/* @__PURE__ */ new Date()).toISOString(),
+      source,
+      target,
+      serviceId,
+      payload: payload ? import_buf2.bufWkt.anyPack(type, import_buf2.buf.create(type, payload)) : void 0
+    });
+  }
+};
+var toUint8Array = async (data) => {
+  if (data instanceof Buffer) {
+    return (0, import_util.bufferToArray)(data);
+  }
+  if (data instanceof Blob) {
+    return new Uint8Array(await data.arrayBuffer());
+  }
+  throw new Error(`Unexpected datatype: ${data}`);
+};
+var protocol = new Protocol([
+  import_messenger_pb2.SwarmRequestSchema,
+  import_messenger_pb2.SwarmResponseSchema,
+  import_messenger_pb2.TextMessageSchema
+]);
+var __dxlog_file2 = "/home/runner/work/dxos/dxos/packages/core/mesh/edge-client/src/client.ts";
+var DEFAULT_TIMEOUT = 5e3;
+var EdgeClient = class {
+  constructor(_identityKey, _deviceKey, _config) {
+    this._identityKey = _identityKey;
+    this._deviceKey = _deviceKey;
+    this._config = _config;
+    this._listeners = /* @__PURE__ */ new Set();
+    this._protocol = this._config.protocol ?? protocol;
+  }
+  // TODO(burdon): Attach logging.
+  get info() {
+    return {
+      open: this.isOpen,
+      identity: this._identityKey,
+      device: this._deviceKey
+    };
+  }
+  get identityKey() {
+    return this._identityKey;
+  }
+  get deviceKey() {
+    return this._deviceKey;
+  }
+  get isOpen() {
+    return !!this._ws;
+  }
+  addListener(listener) {
+    this._listeners.add(listener);
+    return () => this._listeners.delete(listener);
+  }
+  /**
+  * Open connection to messaging service.
+  */
+  async open() {
+    (0, import_invariant.invariant)(!this._ws, void 0, {
+      F: __dxlog_file2,
+      L: 88,
+      S: this,
+      A: [
+        "!this._ws",
+        ""
+      ]
+    });
+    import_log.log.info("opening...", {
+      info: this.info
+    }, {
+      F: __dxlog_file2,
+      L: 89,
+      S: this,
+      C: (f, a) => f(...a)
+    });
+    const ready = new import_async.Trigger();
+    const url = new URL(`/ws/${this._identityKey.toHex()}/${this._deviceKey.toHex()}`, this._config.socketEndpoint);
+    this._ws = new import_isomorphic_ws.default(url);
+    Object.assign(this._ws, {
+      onopen: () => {
+        import_log.log.info("opened", this.info, {
+          F: __dxlog_file2,
+          L: 97,
+          S: this,
+          C: (f, a) => f(...a)
+        });
+        ready.wake(true);
+      },
+      onclose: () => {
+        import_log.log.info("closed", this.info, {
+          F: __dxlog_file2,
+          L: 102,
+          S: this,
+          C: (f, a) => f(...a)
+        });
+        ready.wake(false);
+      },
+      onerror: (event) => {
+        import_log.log.catch(event.error, this.info, {
+          F: __dxlog_file2,
+          L: 107,
+          S: this,
+          C: (f, a) => f(...a)
+        });
+        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 = import_buf.buf.fromBinary(import_messenger_pb.MessageSchema, data);
+        (0, import_log.log)("received", {
+          deviceKey: this._deviceKey,
+          payload: protocol.getPayloadType(message)
+        }, {
+          F: __dxlog_file2,
+          L: 117,
+          S: this,
+          C: (f, a) => f(...a)
+        });
+        if (message) {
+          for (const listener of this._listeners) {
+            try {
+              await listener(message);
+            } catch (err) {
+              import_log.log.error("processing", {
+                err,
+                payload: protocol.getPayloadType(message)
+              }, {
+                F: __dxlog_file2,
+                L: 123,
+                S: this,
+                C: (f, a) => f(...a)
+              });
+            }
+          }
+        }
+      }
+    });
+    const result = await ready.wait({
+      timeout: this._config.timeout ?? DEFAULT_TIMEOUT
+    });
+    import_log.log.info("opened", {
+      info: this.info
+    }, {
+      F: __dxlog_file2,
+      L: 131,
+      S: this,
+      C: (f, a) => f(...a)
+    });
+    return result;
+  }
+  /**
+  * Close connection and free resources.
+  */
+  async close() {
+    if (this._ws) {
+      import_log.log.info("closing...", {
+        deviceKey: this._deviceKey
+      }, {
+        F: __dxlog_file2,
+        L: 140,
+        S: this,
+        C: (f, a) => f(...a)
+      });
+      this._ws.close();
+      this._ws = void 0;
+      import_log.log.info("closed", {
+        deviceKey: this._deviceKey
+      }, {
+        F: __dxlog_file2,
+        L: 143,
+        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) {
+    (0, import_invariant.invariant)(this._ws, void 0, {
+      F: __dxlog_file2,
+      L: 153,
+      S: this,
+      A: [
+        "this._ws",
+        ""
+      ]
+    });
+    (0, import_log.log)("sending...", {
+      deviceKey: this._deviceKey,
+      payload: protocol.getPayloadType(message)
+    }, {
+      F: __dxlog_file2,
+      L: 154,
+      S: this,
+      C: (f, a) => f(...a)
+    });
+    this._ws.send(import_buf.buf.toBinary(import_messenger_pb.MessageSchema, message));
+  }
+};
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  EdgeClient,
+  Protocol,
+  getTypename,
+  protocol,
+  toUint8Array,
+  ...require("@dxos/protocols/buf/dxos/edge/messenger_pb")
+});
+//# sourceMappingURL=index.cjs.map

package/dist/lib/node/index.cjs.map

@@ -0,0 +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 { 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\n/**\n *\n */\nexport interface EdgeConnection {\n  get info(): any;\n  get identityKey(): PublicKey;\n  get deviceKey(): PublicKey;\n  get isOpen(): boolean;\n  addListener(listener: MessageListener): () => void;\n  open(): Promise<boolean>;\n  close(): Promise<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.\nexport class EdgeClient implements EdgeConnection {\n  private readonly _listeners: Set<MessageListener> = new Set();\n  private readonly _protocol: Protocol;\n  private _ws?: WebSocket;\n\n  constructor(\n    private readonly _identityKey: PublicKey,\n    private readonly _deviceKey: PublicKey,\n    private readonly _config: MessengerConfig,\n  ) {\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._ws;\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  public async open(): Promise<boolean> {\n    invariant(!this._ws);\n    log.info('opening...', { info: this.info });\n    const ready = new Trigger<boolean>();\n\n    // TODO: handle reconnects\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.info('opened', this.info);\n        ready.wake(true);\n      },\n\n      onclose: () => {\n        log.info('closed', this.info);\n        ready.wake(false);\n      },\n\n      onerror: (event) => {\n        log.catch(event.error, this.info);\n        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    const result = await ready.wait({ timeout: this._config.timeout ?? DEFAULT_TIMEOUT });\n    log.info('opened', { info: this.info });\n    return result;\n  }\n\n  /**\n   * Close connection and free resources.\n   */\n  public async close() {\n    if (this._ws) {\n      log.info('closing...', { deviceKey: this._deviceKey });\n      this._ws.close();\n      this._ws = undefined;\n      log.info('closed', { deviceKey: this._deviceKey });\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  // TODO(burdon): Implement ACK?\n  public async send(message: Message): Promise<void> {\n    invariant(this._ws);\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 { 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]);\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": ["import_messenger_pb", "import_invariant", "import_buf", "getTypename", "typeName", "Protocol", "constructor", "types", "_typeRegistry", "buf", "createRegistry", "typeRegistry", "toJson", "message", "MessageSchema", "registry", "err", "type", "getPayloadType", "getPayload", "invariant", "payload", "payloadTypename", "Error", "bufWkt", "anyIs", "anyUnpack", "undefined", "typeUrl", "split", "createMessage", "source", "target", "serviceId", "create", "timestamp", "Date", "toISOString", "anyPack", "toUint8Array", "data", "Buffer", "bufferToArray", "Blob", "Uint8Array", "arrayBuffer", "protocol", "SwarmRequestSchema", "SwarmResponseSchema", "TextMessageSchema", "DEFAULT_TIMEOUT", "EdgeClient", "_identityKey", "_deviceKey", "_config", "_listeners", "Set", "_protocol", "info", "open", "isOpen", "identity", "device", "identityKey", "deviceKey", "_ws", "addListener", "listener", "add", "delete", "log", "ready", "Trigger", "url", "URL", "toHex", "socketEndpoint", "WebSocket", "Object", "assign", "onopen", "wake", "onclose", "onerror", "event", "catch", "error", "throw", "onmessage", "fromBinary", "result", "wait", "timeout", "close", "send", "toBinary"]
+}

package/dist/lib/node/meta.json

@@ -0,0 +1 @@
+{"inputs":{"packages/core/mesh/edge-client/src/protocol.ts":{"bytes":10314,"imports":[{"path":"@dxos/invariant","kind":"import-statement","external":true},{"path":"@dxos/protocols/buf","kind":"import-statement","external":true},{"path":"@dxos/protocols/buf/dxos/edge/messenger_pb","kind":"import-statement","external":true},{"path":"@dxos/util","kind":"import-statement","external":true}],"format":"esm"},"packages/core/mesh/edge-client/src/defs.ts":{"bytes":1359,"imports":[{"path":"@dxos/protocols/buf/dxos/edge/messenger_pb","kind":"import-statement","external":true},{"path":"packages/core/mesh/edge-client/src/protocol.ts","kind":"import-statement","original":"./protocol"}],"format":"esm"},"packages/core/mesh/edge-client/src/client.ts":{"bytes":16849,"imports":[{"path":"isomorphic-ws","kind":"import-statement","external":true},{"path":"@dxos/async","kind":"import-statement","external":true},{"path":"@dxos/invariant","kind":"import-statement","external":true},{"path":"@dxos/log","kind":"import-statement","external":true},{"path":"@dxos/protocols/buf","kind":"import-statement","external":true},{"path":"@dxos/protocols/buf/dxos/edge/messenger_pb","kind":"import-statement","external":true},{"path":"packages/core/mesh/edge-client/src/defs.ts","kind":"import-statement","original":"./defs"},{"path":"packages/core/mesh/edge-client/src/protocol.ts","kind":"import-statement","original":"./protocol"}],"format":"esm"},"packages/core/mesh/edge-client/src/index.ts":{"bytes":836,"imports":[{"path":"@dxos/protocols/buf/dxos/edge/messenger_pb","kind":"import-statement","external":true},{"path":"packages/core/mesh/edge-client/src/client.ts","kind":"import-statement","original":"./client"},{"path":"packages/core/mesh/edge-client/src/defs.ts","kind":"import-statement","original":"./defs"},{"path":"packages/core/mesh/edge-client/src/protocol.ts","kind":"import-statement","original":"./protocol"}],"format":"esm"}},"outputs":{"packages/core/mesh/edge-client/dist/lib/node/index.cjs.map":{"imports":[],"exports":[],"inputs":{},"bytes":13078},"packages/core/mesh/edge-client/dist/lib/node/index.cjs":{"imports":[{"path":"@dxos/protocols/buf/dxos/edge/messenger_pb","kind":"import-statement","external":true},{"path":"isomorphic-ws","kind":"import-statement","external":true},{"path":"@dxos/async","kind":"import-statement","external":true},{"path":"@dxos/invariant","kind":"import-statement","external":true},{"path":"@dxos/log","kind":"import-statement","external":true},{"path":"@dxos/protocols/buf","kind":"import-statement","external":true},{"path":"@dxos/protocols/buf/dxos/edge/messenger_pb","kind":"import-statement","external":true},{"path":"@dxos/protocols/buf/dxos/edge/messenger_pb","kind":"import-statement","external":true},{"path":"@dxos/invariant","kind":"import-statement","external":true},{"path":"@dxos/protocols/buf","kind":"import-statement","external":true},{"path":"@dxos/protocols/buf/dxos/edge/messenger_pb","kind":"import-statement","external":true},{"path":"@dxos/util","kind":"import-statement","external":true}],"exports":["EdgeClient","Protocol","getTypename","protocol","toUint8Array"],"entryPoint":"packages/core/mesh/edge-client/src/index.ts","inputs":{"packages/core/mesh/edge-client/src/index.ts":{"bytesInOutput":60},"packages/core/mesh/edge-client/src/client.ts":{"bytesInOutput":4723},"packages/core/mesh/edge-client/src/defs.ts":{"bytesInOutput":220},"packages/core/mesh/edge-client/src/protocol.ts":{"bytesInOutput":2600}},"bytes":8008}}}

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

@@ -0,0 +1,57 @@
+import { type PublicKey } from '@dxos/keys';
+import { type Message } from '@dxos/protocols/buf/dxos/edge/messenger_pb';
+import { type Protocol } from './protocol';
+export type MessageListener = (message: Message) => void | Promise<void>;
+/**
+ *
+ */
+export interface EdgeConnection {
+    get info(): any;
+    get identityKey(): PublicKey;
+    get deviceKey(): PublicKey;
+    get isOpen(): boolean;
+    addListener(listener: MessageListener): () => void;
+    open(): Promise<boolean>;
+    close(): Promise<void>;
+    send(message: Message): Promise<void>;
+}
+export type MessengerConfig = {
+    socketEndpoint: string;
+    timeout?: number;
+    protocol?: Protocol;
+};
+/**
+ * Messenger client.
+ */
+export declare class EdgeClient implements EdgeConnection {
+    private readonly _identityKey;
+    private readonly _deviceKey;
+    private readonly _config;
+    private readonly _listeners;
+    private readonly _protocol;
+    private _ws?;
+    constructor(_identityKey: PublicKey, _deviceKey: PublicKey, _config: MessengerConfig);
+    get info(): {
+        open: boolean;
+        identity: PublicKey;
+        device: PublicKey;
+    };
+    get identityKey(): PublicKey;
+    get deviceKey(): PublicKey;
+    get isOpen(): boolean;
+    addListener(listener: MessageListener): () => void;
+    /**
+     * Open connection to messaging service.
+     */
+    open(): Promise<boolean>;
+    /**
+     * Close connection and free resources.
+     */
+    close(): Promise<void>;
+    /**
+     * Send message.
+     * NOTE: The message is guaranteed to be delivered but the service must respond with a message to confirm processing.
+     */
+    send(message: Message): Promise<void>;
+}
+//# sourceMappingURL=client.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../../../src/client.ts"],"names":[],"mappings":"AAQA,OAAO,EAAE,KAAK,SAAS,EAAE,MAAM,YAAY,CAAC;AAG5C,OAAO,EAAE,KAAK,OAAO,EAAiB,MAAM,4CAA4C,CAAC;AAGzF,OAAO,EAAE,KAAK,QAAQ,EAAgB,MAAM,YAAY,CAAC;AAIzD,MAAM,MAAM,eAAe,GAAG,CAAC,OAAO,EAAE,OAAO,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;AAEzE;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B,IAAI,IAAI,IAAI,GAAG,CAAC;IAChB,IAAI,WAAW,IAAI,SAAS,CAAC;IAC7B,IAAI,SAAS,IAAI,SAAS,CAAC;IAC3B,IAAI,MAAM,IAAI,OAAO,CAAC;IACtB,WAAW,CAAC,QAAQ,EAAE,eAAe,GAAG,MAAM,IAAI,CAAC;IACnD,IAAI,IAAI,OAAO,CAAC,OAAO,CAAC,CAAC;IACzB,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IACvB,IAAI,CAAC,OAAO,EAAE,OAAO,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CACvC;AAED,MAAM,MAAM,eAAe,GAAG;IAC5B,cAAc,EAAE,MAAM,CAAC;IACvB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,QAAQ,CAAC,EAAE,QAAQ,CAAC;CACrB,CAAC;AAEF;;GAEG;AAEH,qBAAa,UAAW,YAAW,cAAc;IAM7C,OAAO,CAAC,QAAQ,CAAC,YAAY;IAC7B,OAAO,CAAC,QAAQ,CAAC,UAAU;IAC3B,OAAO,CAAC,QAAQ,CAAC,OAAO;IAP1B,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAmC;IAC9D,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAW;IACrC,OAAO,CAAC,GAAG,CAAC,CAAY;gBAGL,YAAY,EAAE,SAAS,EACvB,UAAU,EAAE,SAAS,EACrB,OAAO,EAAE,eAAe;IAM3C,IAAW,IAAI;;;;MAMd;IAED,IAAI,WAAW,cAEd;IAED,IAAI,SAAS,cAEZ;IAED,IAAW,MAAM,YAEhB;IAEM,WAAW,CAAC,QAAQ,EAAE,eAAe,GAAG,MAAM,IAAI;IAKzD;;OAEG;IACU,IAAI,IAAI,OAAO,CAAC,OAAO,CAAC;IAgDrC;;OAEG;IACU,KAAK;IASlB;;;OAGG;IAEU,IAAI,CAAC,OAAO,EAAE,OAAO,GAAG,OAAO,CAAC,IAAI,CAAC;CAKnD"}

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

@@ -0,0 +1,3 @@
+import { Protocol } from './protocol';
+export declare const protocol: Protocol;
+//# sourceMappingURL=defs.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"defs.d.ts","sourceRoot":"","sources":["../../../src/defs.ts"],"names":[],"mappings":"AAMA,OAAO,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AAEtC,eAAO,MAAM,QAAQ,UAA6E,CAAC"}

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

@@ -0,0 +1,5 @@
+export * from '@dxos/protocols/buf/dxos/edge/messenger_pb';
+export * from './client';
+export * from './defs';
+export * from './protocol';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/index.ts"],"names":[],"mappings":"AAIA,cAAc,4CAA4C,CAAC;AAE3D,cAAc,UAAU,CAAC;AACzB,cAAc,QAAQ,CAAC;AACvB,cAAc,YAAY,CAAC"}

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

@@ -0,0 +1,35 @@
+import { buf } from '@dxos/protocols/buf';
+import { type Message, type Peer as PeerProto } from '@dxos/protocols/buf/dxos/edge/messenger_pb';
+export type PeerData = Partial<PeerProto>;
+export declare const getTypename: (typeName: string) => string;
+/**
+ * NOTE: The type registry should be extended with all message types.
+ */
+export declare class Protocol {
+    private readonly _typeRegistry;
+    constructor(types: buf.DescMessage[]);
+    get typeRegistry(): buf.Registry;
+    toJson(message: Message): any;
+    /**
+     * Return the payload with the given type.
+     */
+    getPayload<Desc extends buf.DescMessage>(message: Message, type: Desc): buf.MessageShape<Desc>;
+    /**
+     * Get the payload type.
+     */
+    getPayloadType(message: Message): string | undefined;
+    /**
+     * Create a packed message.
+     */
+    createMessage<Desc extends buf.DescMessage>(type: Desc, { source, target, payload, serviceId, }: {
+        source?: PeerData;
+        target?: PeerData[];
+        payload?: buf.MessageInitShape<Desc>;
+        serviceId?: string;
+    }): Message;
+}
+/**
+ * Convert websocket data to Uint8Array.
+ */
+export declare const toUint8Array: (data: any) => Promise<Uint8Array>;
+//# sourceMappingURL=protocol.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"protocol.d.ts","sourceRoot":"","sources":["../../../src/protocol.ts"],"names":[],"mappings":"AAKA,OAAO,EAAE,GAAG,EAAU,MAAM,qBAAqB,CAAC;AAClD,OAAO,EAAE,KAAK,OAAO,EAAiB,KAAK,IAAI,IAAI,SAAS,EAAE,MAAM,4CAA4C,CAAC;AAGjH,MAAM,MAAM,QAAQ,GAAG,OAAO,CAAC,SAAS,CAAC,CAAC;AAE1C,eAAO,MAAM,WAAW,aAAc,MAAM,WAAsC,CAAC;AAEnF;;GAEG;AACH,qBAAa,QAAQ;IACnB,OAAO,CAAC,QAAQ,CAAC,aAAa,CAAe;gBAEjC,KAAK,EAAE,GAAG,CAAC,WAAW,EAAE;IAIpC,IAAI,YAAY,IAAI,GAAG,CAAC,QAAQ,CAE/B;IAED,MAAM,CAAC,OAAO,EAAE,OAAO,GAAG,GAAG;IAQ7B;;OAEG;IACH,UAAU,CAAC,IAAI,SAAS,GAAG,CAAC,WAAW,EAAE,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,IAAI,GAAG,GAAG,CAAC,YAAY,CAAC,IAAI,CAAC;IAa9F;;OAEG;IACH,cAAc,CAAC,OAAO,EAAE,OAAO,GAAG,MAAM,GAAG,SAAS;IASpD;;OAEG;IACH,aAAa,CAAC,IAAI,SAAS,GAAG,CAAC,WAAW,EACxC,IAAI,EAAE,IAAI,EACV,EACE,MAAM,EACN,MAAM,EACN,OAAO,EACP,SAAS,GACV,EAAE;QACD,MAAM,CAAC,EAAE,QAAQ,CAAC;QAClB,MAAM,CAAC,EAAE,QAAQ,EAAE,CAAC;QACpB,OAAO,CAAC,EAAE,GAAG,CAAC,gBAAgB,CAAC,IAAI,CAAC,CAAC;QACrC,SAAS,CAAC,EAAE,MAAM,CAAC;KACpB;CAUJ;AAED;;GAEG;AACH,eAAO,MAAM,YAAY,SAAgB,GAAG,KAAG,QAAQ,UAAU,CAYhE,CAAC"}

package/dist/types/src/protocol.test.d.ts

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

package/dist/types/src/protocol.test.d.ts.map

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

package/package.json

@@ -0,0 +1,41 @@
+{
+  "name": "@dxos/edge-client",
+  "version": "0.6.6-main.e1a6e1f",
+  "description": "EDGE Client",
+  "homepage": "https://dxos.org",
+  "bugs": "https://github.com/dxos/dxos/issues",
+  "license": "MIT",
+  "author": "DXOS.org",
+  "exports": {
+    ".": {
+      "browser": "./dist/lib/browser/index.mjs",
+      "node": {
+        "default": "./dist/lib/node/index.cjs"
+      },
+      "types": "./dist/types/src/index.d.ts"
+    }
+  },
+  "types": "dist/types/src/index.d.ts",
+  "typesVersions": {
+    "*": {}
+  },
+  "files": [
+    "dist",
+    "src",
+    "README.md"
+  ],
+  "dependencies": {
+    "isomorphic-ws": "^5.0.0",
+    "ws": "^8.14.2",
+    "@dxos/log": "0.6.6-main.e1a6e1f",
+    "@dxos/async": "0.6.6-main.e1a6e1f",
+    "@dxos/node-std": "0.6.6-main.e1a6e1f",
+    "@dxos/protocols": "0.6.6-main.e1a6e1f",
+    "@dxos/invariant": "0.6.6-main.e1a6e1f",
+    "@dxos/util": "0.6.6-main.e1a6e1f"
+  },
+  "devDependencies": {},
+  "publishConfig": {
+    "access": "public"
+  }
+}

package/src/client.ts

@@ -0,0 +1,157 @@
+//
+// Copyright 2024 DXOS.org
+//
+
+import WebSocket from 'isomorphic-ws';
+
+import { Trigger } from '@dxos/async';
+import { invariant } from '@dxos/invariant';
+import { type PublicKey } from '@dxos/keys';
+import { log } from '@dxos/log';
+import { buf } from '@dxos/protocols/buf';
+import { type Message, MessageSchema } from '@dxos/protocols/buf/dxos/edge/messenger_pb';
+
+import { protocol } from './defs';
+import { type Protocol, toUint8Array } from './protocol';
+
+const DEFAULT_TIMEOUT = 5_000;
+
+export type MessageListener = (message: Message) => void | Promise<void>;
+
+/**
+ *
+ */
+export interface EdgeConnection {
+  get info(): any;
+  get identityKey(): PublicKey;
+  get deviceKey(): PublicKey;
+  get isOpen(): boolean;
+  addListener(listener: MessageListener): () => void;
+  open(): Promise<boolean>;
+  close(): Promise<void>;
+  send(message: Message): Promise<void>;
+}
+
+export type MessengerConfig = {
+  socketEndpoint: string;
+  timeout?: number;
+  protocol?: Protocol;
+};
+
+/**
+ * Messenger client.
+ */
+// TODO(dmaretskyi): Rename EdgeClient.
+export class EdgeClient implements EdgeConnection {
+  private readonly _listeners: Set<MessageListener> = new Set();
+  private readonly _protocol: Protocol;
+  private _ws?: WebSocket;
+
+  constructor(
+    private readonly _identityKey: PublicKey,
+    private readonly _deviceKey: PublicKey,
+    private readonly _config: MessengerConfig,
+  ) {
+    this._protocol = this._config.protocol ?? protocol;
+  }
+
+  // TODO(burdon): Attach logging.
+  public get info() {
+    return {
+      open: this.isOpen,
+      identity: this._identityKey,
+      device: this._deviceKey,
+    };
+  }
+
+  get identityKey() {
+    return this._identityKey;
+  }
+
+  get deviceKey() {
+    return this._deviceKey;
+  }
+
+  public get isOpen() {
+    return !!this._ws;
+  }
+
+  public addListener(listener: MessageListener): () => void {
+    this._listeners.add(listener);
+    return () => this._listeners.delete(listener);
+  }
+
+  /**
+   * Open connection to messaging service.
+   */
+  public async open(): Promise<boolean> {
+    invariant(!this._ws);
+    log.info('opening...', { info: this.info });
+    const ready = new Trigger<boolean>();
+
+    // TODO: handle reconnects
+    const url = new URL(`/ws/${this._identityKey.toHex()}/${this._deviceKey.toHex()}`, this._config.socketEndpoint);
+    this._ws = new WebSocket(url);
+    Object.assign<WebSocket, Partial<WebSocket>>(this._ws, {
+      onopen: () => {
+        log.info('opened', this.info);
+        ready.wake(true);
+      },
+
+      onclose: () => {
+        log.info('closed', this.info);
+        ready.wake(false);
+      },
+
+      onerror: (event) => {
+        log.catch(event.error, this.info);
+        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 = buf.fromBinary(MessageSchema, data);
+        log('received', { deviceKey: this._deviceKey, payload: protocol.getPayloadType(message) });
+        if (message) {
+          for (const listener of this._listeners) {
+            try {
+              await listener(message);
+            } catch (err) {
+              log.error('processing', { err, payload: protocol.getPayloadType(message) });
+            }
+          }
+        }
+      },
+    });
+
+    const result = await ready.wait({ timeout: this._config.timeout ?? DEFAULT_TIMEOUT });
+    log.info('opened', { info: this.info });
+    return result;
+  }
+
+  /**
+   * Close connection and free resources.
+   */
+  public async close() {
+    if (this._ws) {
+      log.info('closing...', { deviceKey: this._deviceKey });
+      this._ws.close();
+      this._ws = undefined;
+      log.info('closed', { deviceKey: this._deviceKey });
+    }
+  }
+
+  /**
+   * 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?
+  public async send(message: Message): Promise<void> {
+    invariant(this._ws);
+    log('sending...', { deviceKey: this._deviceKey, payload: protocol.getPayloadType(message) });
+    this._ws.send(buf.toBinary(MessageSchema, message));
+  }
+}

package/src/defs.ts

@@ -0,0 +1,9 @@
+//
+// Copyright 2024 DXOS.org
+//
+
+import { SwarmRequestSchema, SwarmResponseSchema, TextMessageSchema } from '@dxos/protocols/buf/dxos/edge/messenger_pb';
+
+import { Protocol } from './protocol';
+
+export const protocol = new Protocol([SwarmRequestSchema, SwarmResponseSchema, TextMessageSchema]);

package/src/index.ts

@@ -0,0 +1,9 @@
+//
+// Copyright 2024 DXOS.org
+//
+
+export * from '@dxos/protocols/buf/dxos/edge/messenger_pb';
+
+export * from './client';
+export * from './defs';
+export * from './protocol';

package/src/protocol.test.ts

@@ -0,0 +1,36 @@
+//
+// Copyright 2024 DXOS.org
+//
+
+import { expect } from 'chai';
+import { describe, test } from 'vitest';
+
+import { buf } from '@dxos/protocols/buf';
+import {
+  MessageSchema,
+  SwarmRequest_Action as SwarmRequestAction,
+  SwarmRequestSchema,
+  SwarmResponseSchema,
+} from '@dxos/protocols/buf/dxos/edge/messenger_pb';
+
+import { Protocol } from './protocol';
+
+describe('protocol', () => {
+  test('protocol', () => {
+    const protocol = new Protocol([SwarmRequestSchema, SwarmResponseSchema]);
+    const message1 = protocol.createMessage(SwarmRequestSchema, { payload: { action: SwarmRequestAction.JOIN } });
+    const data = buf.toBinary(MessageSchema, message1);
+    const message2 = buf.fromBinary(MessageSchema, data);
+    const request = protocol.getPayload(message2, SwarmRequestSchema);
+    expect(request.action).to.eq(SwarmRequestAction.JOIN);
+  });
+
+  test('json', () => {
+    const protocol = new Protocol([SwarmRequestSchema, SwarmResponseSchema]);
+    const message1 = protocol.createMessage(SwarmRequestSchema, { payload: { action: SwarmRequestAction.JOIN } });
+    const json = buf.toJson(MessageSchema, message1, { registry: protocol.typeRegistry });
+    const message2 = buf.fromJson(MessageSchema, json, { registry: protocol.typeRegistry });
+    const request = protocol.getPayload(message2, SwarmRequestSchema);
+    expect(request.action).to.eq(SwarmRequestAction.JOIN);
+  });
+});

package/src/protocol.ts

@@ -0,0 +1,106 @@
+//
+// Copyright 2024 DXOS.org
+//
+
+import { invariant } from '@dxos/invariant';
+import { buf, bufWkt } from '@dxos/protocols/buf';
+import { type Message, MessageSchema, type Peer as PeerProto } from '@dxos/protocols/buf/dxos/edge/messenger_pb';
+import { bufferToArray } from '@dxos/util';
+
+export type PeerData = Partial<PeerProto>;
+
+export const getTypename = (typeName: string) => `type.googleapis.com/${typeName}`;
+
+/**
+ * NOTE: The type registry should be extended with all message types.
+ */
+export class Protocol {
+  private readonly _typeRegistry: buf.Registry;
+
+  constructor(types: buf.DescMessage[]) {
+    this._typeRegistry = buf.createRegistry(...types);
+  }
+
+  get typeRegistry(): buf.Registry {
+    return this._typeRegistry;
+  }
+
+  toJson(message: Message): any {
+    try {
+      return buf.toJson(MessageSchema, message, { registry: this.typeRegistry });
+    } catch (err) {
+      return { type: this.getPayloadType(message) };
+    }
+  }
+
+  /**
+   * Return the payload with the given type.
+   */
+  getPayload<Desc extends buf.DescMessage>(message: Message, type: Desc): buf.MessageShape<Desc> {
+    invariant(message.payload);
+    const payloadTypename = this.getPayloadType(message);
+    if (type && type.typeName !== payloadTypename) {
+      throw new Error(`Unexpected payload type: ${payloadTypename}; expected ${type.typeName}`);
+    }
+
+    invariant(bufWkt.anyIs(message.payload, type), `Unexpected payload type: ${payloadTypename}}`);
+    const payload = bufWkt.anyUnpack(message.payload, this.typeRegistry) as buf.MessageShape<Desc>;
+    invariant(payload, `Empty payload: ${payloadTypename}}`);
+    return payload;
+  }
+
+  /**
+   * Get the payload type.
+   */
+  getPayloadType(message: Message): string | undefined {
+    if (!message.payload) {
+      return undefined;
+    }
+
+    const [, type] = message.payload.typeUrl.split('/');
+    return type;
+  }
+
+  /**
+   * Create a packed message.
+   */
+  createMessage<Desc extends buf.DescMessage>(
+    type: Desc,
+    {
+      source,
+      target,
+      payload,
+      serviceId,
+    }: {
+      source?: PeerData;
+      target?: PeerData[];
+      payload?: buf.MessageInitShape<Desc>;
+      serviceId?: string;
+    },
+  ) {
+    return buf.create(MessageSchema, {
+      timestamp: new Date().toISOString(),
+      source,
+      target,
+      serviceId,
+      payload: payload ? bufWkt.anyPack(type, buf.create(type, payload)) : undefined,
+    });
+  }
+}
+
+/**
+ * Convert websocket data to Uint8Array.
+ */
+export const toUint8Array = async (data: any): Promise<Uint8Array> => {
+  // Node.
+  if (data instanceof Buffer) {
+    return bufferToArray(data);
+  }
+
+  // Browser.
+  if (data instanceof Blob) {
+    return new Uint8Array(await (data as Blob).arrayBuffer());
+  }
+
+  throw new Error(`Unexpected datatype: ${data}`);
+};