@aethervtt/shard-protocol 0.0.1

package/dist/transport.d.ts

@@ -0,0 +1,15 @@
+import type { ProtocolServer } from './server.js';
+export declare const DEFAULT_HUB_PORT = 7811;
+export interface HubConnectionOptions {
+    /** Shown to the hub (and MCP clients) to identify this app, e.g. "playground" or "studio". */
+    name: string;
+    /** Keep retrying with backoff when the hub isn't there. Default true. */
+    reconnect?: boolean;
+    /** Called on connect/disconnect, for UI. */
+    onStatus?: (connected: boolean) => void;
+}
+/**
+ * Connects an app to a protocol hub (the CLI or MCP server) over WebSocket. The app dials out, so a
+ * browser tab can be driven as easily as a headless run. Returns a function that disconnects.
+ */
+export declare function connectToHub(url: string, server: ProtocolServer, options: HubConnectionOptions): () => void;

package/dist/transport.js

@@ -0,0 +1,53 @@
+const DEFAULT_HUB_PORT = 7811;
+function connectToHub(url, server, options) {
+  let socket;
+  let closed = false;
+  let delay = 500;
+  let timer;
+  const offNotify = server.onNotification((n) => {
+    if (socket?.readyState === WebSocket.OPEN) socket.send(JSON.stringify(n));
+  });
+  const open = () => {
+    socket = new WebSocket(url);
+    socket.onopen = () => {
+      delay = 500;
+      socket.send(
+        JSON.stringify({
+          jsonrpc: "2.0",
+          method: "hello",
+          params: { name: options.name, protocol: 1 }
+        })
+      );
+      options.onStatus?.(true);
+    };
+    socket.onmessage = async (event) => {
+      let request;
+      try {
+        request = JSON.parse(String(event.data));
+      } catch {
+        return;
+      }
+      const response = await server.handle(request);
+      if (response && socket?.readyState === WebSocket.OPEN) socket.send(JSON.stringify(response));
+    };
+    socket.onclose = () => {
+      options.onStatus?.(false);
+      if (closed || options.reconnect === false) return;
+      timer = setTimeout(open, delay);
+      delay = Math.min(delay * 2, 1e4);
+    };
+    socket.onerror = () => {
+    };
+  };
+  open();
+  return () => {
+    closed = true;
+    if (timer) clearTimeout(timer);
+    offNotify();
+    socket?.close();
+  };
+}
+export {
+  DEFAULT_HUB_PORT,
+  connectToHub
+};

package/package.json

@@ -0,0 +1,42 @@
+{
+  "name": "@aethervtt/shard-protocol",
+  "version": "0.0.1",
+  "license": "MIT",
+  "type": "module",
+  "sideEffects": false,
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "default": "./dist/index.js"
+    }
+  },
+  "files": [
+    "dist",
+    "LICENSE",
+    "README.md"
+  ],
+  "dependencies": {
+    "@aethervtt/shard-assets": "0.0.1",
+    "@aethervtt/shard-core": "0.0.1",
+    "@aethervtt/shard-input": "0.0.1",
+    "@aethervtt/shard-platform": "0.0.1",
+    "@aethervtt/shard-render": "0.0.1",
+    "@aethervtt/shard-runtime": "0.0.1",
+    "@aethervtt/shard-scene": "0.0.1",
+    "@aethervtt/shard-text": "0.0.1",
+    "@aethervtt/shard-texture": "0.0.1",
+    "@aethervtt/shard-transform": "0.0.1"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/aethervtt/shard.git",
+    "directory": "packages/protocol"
+  },
+  "publishConfig": {
+    "access": "public",
+    "provenance": true
+  },
+  "shard": {
+    "buildSha": "d6c5c6aef4675575c878b02cf2c8f738b4190229"
+  }
+}