@rljson/server 0.0.11 → 0.0.12

package/dist/server.d.ts

@@ -93,6 +93,19 @@ export declare class Server extends BaseNode {
      * @returns The server instance.
      */
     addSocket(socket: SocketLike): Promise<this>;
+    /**
+     * Adds a socket to the multicast ring WITHOUT creating IoPeer/BsPeer.
+     * Use this when the hub needs to participate in the multicast (send and
+     * receive refs) but the server should NOT try to read data from this socket
+     * via IoPeer/BsPeer RPC — because no IoPeerBridge/BsPeerBridge is set up
+     * on the other end.
+     * Typical use case: hub creates a loopback socket pair so its own
+     * Connector can send/receive refs, but the server's IoMulti already has
+     * the hub's data in its local cache (IoMem/BsMem at priority 1).
+     * @param socket - Socket to register for broadcast only.
+     * @returns The server instance.
+     */
+    addBroadcastSocket(socket: SocketLike): Promise<this>;
     /**
      * Removes all listeners from all connected clients.
      */

package/dist/server.js

@@ -799,6 +799,50 @@ class Server extends BaseNode {
     return this;
   }
   // ...........................................................................
+  /**
+   * Adds a socket to the multicast ring WITHOUT creating IoPeer/BsPeer.
+   * Use this when the hub needs to participate in the multicast (send and
+   * receive refs) but the server should NOT try to read data from this socket
+   * via IoPeer/BsPeer RPC — because no IoPeerBridge/BsPeerBridge is set up
+   * on the other end.
+   * Typical use case: hub creates a loopback socket pair so its own
+   * Connector can send/receive refs, but the server's IoMulti already has
+   * the hub's data in its local cache (IoMem/BsMem at priority 1).
+   * @param socket - Socket to register for broadcast only.
+   * @returns The server instance.
+   */
+  async addBroadcastSocket(socket) {
+    const sockets = normalizeSocketBundle(socket);
+    const clientId = `broadcast_${this._clients.size}_${Math.random().toString(36).slice(2)}`;
+    this._logger.info("Server", "Adding broadcast-only socket", { clientId });
+    const ioUp = sockets.ioUp;
+    const ioDown = sockets.ioDown;
+    const bsUp = sockets.bsUp;
+    const bsDown = sockets.bsDown;
+    ioUp.__clientId = clientId;
+    ioDown.__clientId = clientId;
+    bsUp.__clientId = clientId;
+    bsDown.__clientId = clientId;
+    this._clients.set(clientId, {
+      ioUp,
+      ioDown,
+      bsUp,
+      bsDown,
+      io: null,
+      bs: null
+    });
+    this._removeAllListeners();
+    this._multicastRefs();
+    this._registerDisconnectHandler(clientId, ioUp);
+    this._sendBootstrap(ioDown);
+    this._startBootstrapHeartbeat();
+    this._logger.info("Server", "Broadcast-only socket added", {
+      clientId,
+      totalClients: this._clients.size
+    });
+    return this;
+  }
+  // ...........................................................................
   /**
    * Removes all listeners from all connected clients.
    */

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@rljson/server",
-  "version": "0.0.11",
+  "version": "0.0.12",
   "description": "Rljson server description",
   "homepage": "https://github.com/rljson/server",
   "bugs": "https://github.com/rljson/server/issues",