@buoy-gg/sync-broker 6.0.1 → 7.0.0

package/README.md

@@ -51,5 +51,7 @@ Topology and message flow:
 - Dashboards `devtool-watch` tools; the broker **consolidates** watch counts so a device receives a single `watching` true/false per `(device, tool)` regardless of how many dashboards are watching.
 - Dashboards invoke `devtool-action`; devices reply `devtool-action-result`.
 - Devices push `devtool-sync` snapshots; the broker forwards them to dashboards.
+- The broker emits `broker-log` entries to dashboards (handshakes, disconnect reasons, duplicate-name renames, protocol-version mismatches), buffering the last 200 so a dashboard that connects late still sees earlier failures.
+- Dashboards emit `forget-device` to remove an **offline** device from history; offline devices also age out automatically after 24h (`User.lastSeenAt`).
 
 > **Security:** dev-only. No authentication, CORS is open (`*`), intended for loopback / trusted LAN.

package/dist/index.d.mts

@@ -158,6 +158,8 @@ interface User {
     connectionNonce?: string;
     /** The socket.io reason for this client's most recent disconnect. */
     lastDisconnectReason?: string;
+    /** Epoch ms of the last connect/reconnect/disconnect; drives age-out. */
+    lastSeenAt?: number;
     /** Whether the device announced an active Buoy Pro license. */
     isPro?: boolean;
     /** The device's Buoy Pro license key, if any. Local dev connection only. */

package/dist/index.d.ts

@@ -158,6 +158,8 @@ interface User {
     connectionNonce?: string;
     /** The socket.io reason for this client's most recent disconnect. */
     lastDisconnectReason?: string;
+    /** Epoch ms of the last connect/reconnect/disconnect; drives age-out. */
+    lastSeenAt?: number;
     /** Whether the device announced an active Buoy Pro license. */
     isPro?: boolean;
     /** The device's Buoy Pro license key, if any. Local dev connection only. */

package/dist/index.js

@@ -38,6 +38,9 @@ __export(index_exports, {
 });
 module.exports = __toCommonJS(index_exports);
 
+// src/protocol.ts
+var SYNC_PROTOCOL_VERSION = 1;
+
 // src/socketHandle.ts
 var users = [];
 var allDevices = [];
@@ -49,8 +52,36 @@ var dashboardWatches = /* @__PURE__ */ new Map();
 var watchCounts = /* @__PURE__ */ new Map();
 var toWatchKey = (targetDeviceId, toolId) => JSON.stringify([targetDeviceId, toolId]);
 var fromWatchKey = (key) => JSON.parse(key);
+var brokerLogBuffer = [];
+var BROKER_LOG_BUFFER_MAX = 200;
+var MAX_OFFLINE_AGE_MS = 24 * 60 * 60 * 1e3;
 function socketHandle({ io }) {
   const LOG_PREFIX = "[SERVER]";
+  function brokerLog(level, message, data) {
+    console.log(`${LOG_PREFIX} ${message}`);
+    const entry = { ts: Date.now(), level, message, data };
+    brokerLogBuffer.push(entry);
+    if (brokerLogBuffer.length > BROKER_LOG_BUFFER_MAX) {
+      brokerLogBuffer.shift();
+    }
+    forwardToDashboards("broker-log", entry);
+  }
+  function emitAllDevices() {
+    const now = Date.now();
+    for (let i = allDevices.length - 1; i >= 0; i--) {
+      const device = allDevices[i];
+      if (!device.isConnected && device.lastSeenAt && now - device.lastSeenAt > MAX_OFFLINE_AGE_MS) {
+        allDevices.splice(i, 1);
+        if (device.deviceId) {
+          deviceCapabilities.delete(device.deviceId);
+        }
+      }
+    }
+    io.emit(
+      "all-devices-update",
+      allDevices.filter((device) => device.deviceName !== "Dashboard")
+    );
+  }
   function handleClose(id, reason) {
     const user = users.find((user2) => user2.id === id);
     const deviceId = deviceIdMap.get(id);
@@ -66,6 +97,7 @@ function socketHandle({ io }) {
         if (deviceIndex !== -1) {
           allDevices[deviceIndex].isConnected = false;
           allDevices[deviceIndex].lastDisconnectReason = reason;
+          allDevices[deviceIndex].lastSeenAt = Date.now();
           activeConnectionsMap.delete(deviceId);
         }
       }
@@ -78,13 +110,12 @@ function socketHandle({ io }) {
     const wasDashboard = dashboardClients.includes(id);
     dashboardClients = dashboardClients.filter((clientId) => clientId !== id);
     releaseDashboardWatches(id);
-    console.log(
-      `${LOG_PREFIX} Client disconnected - ID: ${id}, Name: ${user?.deviceName || "Unknown"}, Was Dashboard: ${wasDashboard}, Reason: ${reason ?? "unknown"}`
-    );
-    io.emit(
-      "all-devices-update",
-      allDevices.filter((device) => device.deviceName !== "Dashboard")
+    brokerLog(
+      wasDashboard ? "debug" : "warn",
+      `Disconnected: ${user?.deviceName || id} (${reason ?? "unknown"})`,
+      { socketId: id, reason, wasDashboard }
     );
+    emitAllDevices();
     console.log(
       `${LOG_PREFIX} Updated users list: ${users.map((u) => u.deviceName).join(", ")}`
     );
@@ -109,8 +140,10 @@ function socketHandle({ io }) {
         (device) => device.deviceId === deviceId
       );
       if (existingUserIndex !== -1) {
-        console.log(
-          `${LOG_PREFIX} Reconnecting existing device - ID: ${id}, Name: ${deviceName}, DeviceId: ${deviceId}, Platform: ${platform || "Unknown"}, ExtraDeviceInfo: ${extraDeviceInfo}`
+        brokerLog(
+          "success",
+          `Reconnected: ${deviceName} (${platform || "unknown platform"})`,
+          { socketId: id, deviceId }
         );
         users[existingUserIndex].id = id;
         if (platform) {
@@ -128,6 +161,7 @@ function socketHandle({ io }) {
           allDevices[existingDeviceIndex].id = id;
           allDevices[existingDeviceIndex].isConnected = true;
           allDevices[existingDeviceIndex].connectionNonce = connectionNonce;
+          allDevices[existingDeviceIndex].lastSeenAt = Date.now();
           if (platform) {
             allDevices[existingDeviceIndex].platform = platform;
           }
@@ -145,13 +179,11 @@ function socketHandle({ io }) {
             platform,
             isConnected: true,
             extraDeviceInfo,
-            envVariables
+            envVariables,
+            lastSeenAt: Date.now()
           });
         }
-        io.emit(
-          "all-devices-update",
-          allDevices.filter((device) => device.deviceName !== "Dashboard")
-        );
+        emitAllDevices();
         console.log(
           `${LOG_PREFIX} Updated users list: ${users.map((u) => u.deviceName).join(", ")}`
         );
@@ -172,7 +204,13 @@ function socketHandle({ io }) {
       }
     });
     if (highestNumber > 0 && !isDashboard) {
-      deviceName = `${deviceName} #${highestNumber + 1}`;
+      const renamed = `${deviceName} #${highestNumber + 1}`;
+      brokerLog(
+        "warn",
+        `Duplicate device name "${deviceName}" \u2014 renamed to "${renamed}"`,
+        { socketId: id, deviceId }
+      );
+      deviceName = renamed;
     }
     if (id) {
       const newUser = {
@@ -183,7 +221,8 @@ function socketHandle({ io }) {
         isConnected: true,
         extraDeviceInfo,
         envVariables,
-        connectionNonce
+        connectionNonce,
+        lastSeenAt: Date.now()
       };
       users.push(newUser);
       if (deviceName !== "Dashboard" && deviceId) {
@@ -196,17 +235,16 @@ function socketHandle({ io }) {
           allDevices.push({ ...newUser });
         }
       }
-      console.log(
-        `${LOG_PREFIX} New user connected - ID: ${id}, Name: ${deviceName}${deviceId ? `, DeviceId: ${deviceId}` : ""}${platform ? `, Platform: ${platform}` : ""}`
+      brokerLog(
+        isDashboard ? "debug" : "info",
+        `Connected: ${deviceName}${platform ? ` (${platform})` : ""}`,
+        { socketId: id, deviceId }
       );
       if (isDashboard && id) {
         dashboardClients.push(id);
         console.log(`${LOG_PREFIX} Registered dashboard client with ID: ${id}`);
       }
-      io.emit(
-        "all-devices-update",
-        allDevices.filter((device) => device.deviceName !== "Dashboard")
-      );
+      emitAllDevices();
       console.log(
         `${LOG_PREFIX} Updated device list: ${users.map((u) => u.deviceName).join(", ")}`
       );
@@ -336,6 +374,9 @@ function socketHandle({ io }) {
       for (const capabilities of deviceCapabilities.values()) {
         socket.emit("devtool-capabilities", capabilities);
       }
+      for (const entry of brokerLogBuffer) {
+        socket.emit("broker-log", entry);
+      }
     }
     socket.on(
       "device-license",
@@ -355,13 +396,12 @@ function socketHandle({ io }) {
             device.licenseKey = nextIsPro ? nextKey : void 0;
           }
         }
-        console.log(
-          `${LOG_PREFIX} device-license from ${user?.deviceName || socket.id}: isPro=${nextIsPro}${nextKey ? ", key set" : ""}`
-        );
-        io.emit(
-          "all-devices-update",
-          allDevices.filter((device) => device.deviceName !== "Dashboard")
+        brokerLog(
+          "debug",
+          `device-license from ${user?.deviceName || socket.id}: isPro=${nextIsPro}${nextKey ? ", key set" : ""}`,
+          { socketId: socket.id }
         );
+        emitAllDevices();
       }
     );
     socket.on(
@@ -375,6 +415,13 @@ function socketHandle({ io }) {
       console.log(
         `${LOG_PREFIX} Capabilities from ${message.persistentDeviceId}: ${message.tools.map((tool) => `${tool.toolId}@v${tool.version}`).join(", ")}`
       );
+      if (message.protocolVersion !== SYNC_PROTOCOL_VERSION) {
+        brokerLog(
+          "warn",
+          `Protocol version mismatch from ${message.persistentDeviceId}: device speaks v${message.protocolVersion}, broker speaks v${SYNC_PROTOCOL_VERSION} \u2014 update @buoy-gg packages or Buoy Desktop`,
+          { deviceId: message.persistentDeviceId }
+        );
+      }
       deviceCapabilities.set(message.persistentDeviceId, message);
       forwardToDashboards("devtool-capabilities", message);
       for (const key of watchCounts.keys()) {
@@ -410,6 +457,31 @@ function socketHandle({ io }) {
         `devtool state request ${message.toolId}`
       );
     });
+    socket.on("forget-device", (payload) => {
+      const targetDeviceId = payload?.deviceId;
+      if (!dashboardClients.includes(socket.id)) return;
+      if (!targetDeviceId || activeConnectionsMap.has(targetDeviceId)) return;
+      const target = allDevices.find((d) => d.deviceId === targetDeviceId);
+      users = users.filter((u) => u.deviceId !== targetDeviceId);
+      const historyIndex = allDevices.findIndex(
+        (d) => d.deviceId === targetDeviceId
+      );
+      if (historyIndex !== -1) {
+        allDevices.splice(historyIndex, 1);
+      }
+      deviceCapabilities.delete(targetDeviceId);
+      for (const [socketId, mappedDeviceId] of deviceIdMap) {
+        if (mappedDeviceId === targetDeviceId) {
+          deviceIdMap.delete(socketId);
+        }
+      }
+      brokerLog(
+        "info",
+        `Forgot device: ${target?.deviceName ?? targetDeviceId}`,
+        { deviceId: targetDeviceId }
+      );
+      emitAllDevices();
+    });
     socket.on("devtool-action", (message) => {
       console.log(
         `${LOG_PREFIX} Devtool action from dashboard: ${message.toolId}.${message.action} -> ${message.targetDeviceId}`
@@ -469,9 +541,6 @@ function createBroker(options = {}) {
   });
   return { io, httpServer, port, close };
 }
-
-// src/protocol.ts
-var SYNC_PROTOCOL_VERSION = 1;
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
   DEFAULT_BROKER_PORT,

package/dist/index.mjs

@@ -1,3 +1,6 @@
+// src/protocol.ts
+var SYNC_PROTOCOL_VERSION = 1;
+
 // src/socketHandle.ts
 var users = [];
 var allDevices = [];
@@ -9,8 +12,36 @@ var dashboardWatches = /* @__PURE__ */ new Map();
 var watchCounts = /* @__PURE__ */ new Map();
 var toWatchKey = (targetDeviceId, toolId) => JSON.stringify([targetDeviceId, toolId]);
 var fromWatchKey = (key) => JSON.parse(key);
+var brokerLogBuffer = [];
+var BROKER_LOG_BUFFER_MAX = 200;
+var MAX_OFFLINE_AGE_MS = 24 * 60 * 60 * 1e3;
 function socketHandle({ io }) {
   const LOG_PREFIX = "[SERVER]";
+  function brokerLog(level, message, data) {
+    console.log(`${LOG_PREFIX} ${message}`);
+    const entry = { ts: Date.now(), level, message, data };
+    brokerLogBuffer.push(entry);
+    if (brokerLogBuffer.length > BROKER_LOG_BUFFER_MAX) {
+      brokerLogBuffer.shift();
+    }
+    forwardToDashboards("broker-log", entry);
+  }
+  function emitAllDevices() {
+    const now = Date.now();
+    for (let i = allDevices.length - 1; i >= 0; i--) {
+      const device = allDevices[i];
+      if (!device.isConnected && device.lastSeenAt && now - device.lastSeenAt > MAX_OFFLINE_AGE_MS) {
+        allDevices.splice(i, 1);
+        if (device.deviceId) {
+          deviceCapabilities.delete(device.deviceId);
+        }
+      }
+    }
+    io.emit(
+      "all-devices-update",
+      allDevices.filter((device) => device.deviceName !== "Dashboard")
+    );
+  }
   function handleClose(id, reason) {
     const user = users.find((user2) => user2.id === id);
     const deviceId = deviceIdMap.get(id);
@@ -26,6 +57,7 @@ function socketHandle({ io }) {
         if (deviceIndex !== -1) {
           allDevices[deviceIndex].isConnected = false;
           allDevices[deviceIndex].lastDisconnectReason = reason;
+          allDevices[deviceIndex].lastSeenAt = Date.now();
           activeConnectionsMap.delete(deviceId);
         }
       }
@@ -38,13 +70,12 @@ function socketHandle({ io }) {
     const wasDashboard = dashboardClients.includes(id);
     dashboardClients = dashboardClients.filter((clientId) => clientId !== id);
     releaseDashboardWatches(id);
-    console.log(
-      `${LOG_PREFIX} Client disconnected - ID: ${id}, Name: ${user?.deviceName || "Unknown"}, Was Dashboard: ${wasDashboard}, Reason: ${reason ?? "unknown"}`
-    );
-    io.emit(
-      "all-devices-update",
-      allDevices.filter((device) => device.deviceName !== "Dashboard")
+    brokerLog(
+      wasDashboard ? "debug" : "warn",
+      `Disconnected: ${user?.deviceName || id} (${reason ?? "unknown"})`,
+      { socketId: id, reason, wasDashboard }
     );
+    emitAllDevices();
     console.log(
       `${LOG_PREFIX} Updated users list: ${users.map((u) => u.deviceName).join(", ")}`
     );
@@ -69,8 +100,10 @@ function socketHandle({ io }) {
         (device) => device.deviceId === deviceId
       );
       if (existingUserIndex !== -1) {
-        console.log(
-          `${LOG_PREFIX} Reconnecting existing device - ID: ${id}, Name: ${deviceName}, DeviceId: ${deviceId}, Platform: ${platform || "Unknown"}, ExtraDeviceInfo: ${extraDeviceInfo}`
+        brokerLog(
+          "success",
+          `Reconnected: ${deviceName} (${platform || "unknown platform"})`,
+          { socketId: id, deviceId }
         );
         users[existingUserIndex].id = id;
         if (platform) {
@@ -88,6 +121,7 @@ function socketHandle({ io }) {
           allDevices[existingDeviceIndex].id = id;
           allDevices[existingDeviceIndex].isConnected = true;
           allDevices[existingDeviceIndex].connectionNonce = connectionNonce;
+          allDevices[existingDeviceIndex].lastSeenAt = Date.now();
           if (platform) {
             allDevices[existingDeviceIndex].platform = platform;
           }
@@ -105,13 +139,11 @@ function socketHandle({ io }) {
             platform,
             isConnected: true,
             extraDeviceInfo,
-            envVariables
+            envVariables,
+            lastSeenAt: Date.now()
           });
         }
-        io.emit(
-          "all-devices-update",
-          allDevices.filter((device) => device.deviceName !== "Dashboard")
-        );
+        emitAllDevices();
         console.log(
           `${LOG_PREFIX} Updated users list: ${users.map((u) => u.deviceName).join(", ")}`
         );
@@ -132,7 +164,13 @@ function socketHandle({ io }) {
       }
     });
     if (highestNumber > 0 && !isDashboard) {
-      deviceName = `${deviceName} #${highestNumber + 1}`;
+      const renamed = `${deviceName} #${highestNumber + 1}`;
+      brokerLog(
+        "warn",
+        `Duplicate device name "${deviceName}" \u2014 renamed to "${renamed}"`,
+        { socketId: id, deviceId }
+      );
+      deviceName = renamed;
     }
     if (id) {
       const newUser = {
@@ -143,7 +181,8 @@ function socketHandle({ io }) {
         isConnected: true,
         extraDeviceInfo,
         envVariables,
-        connectionNonce
+        connectionNonce,
+        lastSeenAt: Date.now()
       };
       users.push(newUser);
       if (deviceName !== "Dashboard" && deviceId) {
@@ -156,17 +195,16 @@ function socketHandle({ io }) {
           allDevices.push({ ...newUser });
         }
       }
-      console.log(
-        `${LOG_PREFIX} New user connected - ID: ${id}, Name: ${deviceName}${deviceId ? `, DeviceId: ${deviceId}` : ""}${platform ? `, Platform: ${platform}` : ""}`
+      brokerLog(
+        isDashboard ? "debug" : "info",
+        `Connected: ${deviceName}${platform ? ` (${platform})` : ""}`,
+        { socketId: id, deviceId }
       );
       if (isDashboard && id) {
         dashboardClients.push(id);
         console.log(`${LOG_PREFIX} Registered dashboard client with ID: ${id}`);
       }
-      io.emit(
-        "all-devices-update",
-        allDevices.filter((device) => device.deviceName !== "Dashboard")
-      );
+      emitAllDevices();
       console.log(
         `${LOG_PREFIX} Updated device list: ${users.map((u) => u.deviceName).join(", ")}`
       );
@@ -296,6 +334,9 @@ function socketHandle({ io }) {
       for (const capabilities of deviceCapabilities.values()) {
         socket.emit("devtool-capabilities", capabilities);
       }
+      for (const entry of brokerLogBuffer) {
+        socket.emit("broker-log", entry);
+      }
     }
     socket.on(
       "device-license",
@@ -315,13 +356,12 @@ function socketHandle({ io }) {
             device.licenseKey = nextIsPro ? nextKey : void 0;
           }
         }
-        console.log(
-          `${LOG_PREFIX} device-license from ${user?.deviceName || socket.id}: isPro=${nextIsPro}${nextKey ? ", key set" : ""}`
-        );
-        io.emit(
-          "all-devices-update",
-          allDevices.filter((device) => device.deviceName !== "Dashboard")
+        brokerLog(
+          "debug",
+          `device-license from ${user?.deviceName || socket.id}: isPro=${nextIsPro}${nextKey ? ", key set" : ""}`,
+          { socketId: socket.id }
         );
+        emitAllDevices();
       }
     );
     socket.on(
@@ -335,6 +375,13 @@ function socketHandle({ io }) {
       console.log(
         `${LOG_PREFIX} Capabilities from ${message.persistentDeviceId}: ${message.tools.map((tool) => `${tool.toolId}@v${tool.version}`).join(", ")}`
       );
+      if (message.protocolVersion !== SYNC_PROTOCOL_VERSION) {
+        brokerLog(
+          "warn",
+          `Protocol version mismatch from ${message.persistentDeviceId}: device speaks v${message.protocolVersion}, broker speaks v${SYNC_PROTOCOL_VERSION} \u2014 update @buoy-gg packages or Buoy Desktop`,
+          { deviceId: message.persistentDeviceId }
+        );
+      }
       deviceCapabilities.set(message.persistentDeviceId, message);
       forwardToDashboards("devtool-capabilities", message);
       for (const key of watchCounts.keys()) {
@@ -370,6 +417,31 @@ function socketHandle({ io }) {
         `devtool state request ${message.toolId}`
       );
     });
+    socket.on("forget-device", (payload) => {
+      const targetDeviceId = payload?.deviceId;
+      if (!dashboardClients.includes(socket.id)) return;
+      if (!targetDeviceId || activeConnectionsMap.has(targetDeviceId)) return;
+      const target = allDevices.find((d) => d.deviceId === targetDeviceId);
+      users = users.filter((u) => u.deviceId !== targetDeviceId);
+      const historyIndex = allDevices.findIndex(
+        (d) => d.deviceId === targetDeviceId
+      );
+      if (historyIndex !== -1) {
+        allDevices.splice(historyIndex, 1);
+      }
+      deviceCapabilities.delete(targetDeviceId);
+      for (const [socketId, mappedDeviceId] of deviceIdMap) {
+        if (mappedDeviceId === targetDeviceId) {
+          deviceIdMap.delete(socketId);
+        }
+      }
+      brokerLog(
+        "info",
+        `Forgot device: ${target?.deviceName ?? targetDeviceId}`,
+        { deviceId: targetDeviceId }
+      );
+      emitAllDevices();
+    });
     socket.on("devtool-action", (message) => {
       console.log(
         `${LOG_PREFIX} Devtool action from dashboard: ${message.toolId}.${message.action} -> ${message.targetDeviceId}`
@@ -429,9 +501,6 @@ function createBroker(options = {}) {
   });
   return { io, httpServer, port, close };
 }
-
-// src/protocol.ts
-var SYNC_PROTOCOL_VERSION = 1;
 export {
   DEFAULT_BROKER_PORT,
   SOCKET_CONFIG,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@buoy-gg/sync-broker",
-  "version": "6.0.1",
+  "version": "7.0.0",
   "description": "Headless Socket.IO broker for the Buoy devtool sync protocol (v1) — routes messages between devices and dashboard/MCP clients",
   "main": "dist/index.js",
   "module": "dist/index.mjs",
@@ -36,13 +36,13 @@
   },
   "repository": {
     "type": "git",
-    "url": "https://github.com/LovesWorking/react-native-buoy.git",
-    "directory": "packages/sync-broker"
+    "url": "https://github.com/Buoy-gg/buoy.git"
   },
   "publishConfig": {
     "access": "public",
     "tag": "latest"
   },
+  "homepage": "https://buoy.gg",
   "scripts": {
     "build": "tsup",
     "typecheck": "tsc --noEmit",