y-openrtc 2.9.3 → 2.9.5

package/README.md

@@ -71,6 +71,10 @@ files or long-lived secrets.
 - OpenRTC remains the source of truth for room membership and peer transport.
 - Runtime connection events and room-membership changes drive peer attachment;
   the provider does not poll or own base-connection retries.
+- A supplied room owns discovery and dialing. Its ID determines membership;
+  the provider's document label can be different. Provider frames use the
+  room's scoped public connections, with a JSON envelope preserving Yjs bytes.
+  Diagnostic transport connections are never used for document delivery.
 - Same-tab sync still prefers `BroadcastChannel` when available.
 - `password` encrypts provider payloads end-to-end on top of OpenRTC.
 
@@ -91,3 +95,6 @@ pnpm --dir openrtc/packages/y-openrtc test:live
 ```
 
 The live test only uses the public OpenRTC API key. Server secrets are not needed for this package-local live test and should stay server-side.
+It checks document and awareness convergence between isolated browser contexts,
+so BroadcastChannel cannot hide a broken network path. The separate static Hub
+configuration check runs only when `OPENRTC_HUB_API_KEY` is supplied.

package/dist/provider.js

@@ -273,7 +273,7 @@ export class YProvider {
         }
         this.runtime = runtime;
         this.localNodeId = await runtime.getNodeId();
-        const preferredRoomId = normalizeOpenrtcRoomId(this.options.roomIdOverride ?? await roomIdFromName(this.roomName));
+        const preferredRoomId = normalizeOpenrtcRoomId(this.options.roomIdOverride ?? this.options.room?.id ?? await roomIdFromName(this.roomName));
         const roomCandidates = this.resolveRoomCandidates(preferredRoomId);
         this.attachLocalObservers();
         this.stopRuntimeConnections = runtime.onConnection((connection) => {
@@ -467,7 +467,7 @@ export class YProvider {
         const localNodeId = this.localNodeId;
         const candidates = Array.from(this.roomMembers.values())
             .filter((member) => member.nodeId !== this.localNodeId)
-            .filter((member) => !!member.ticket)
+            .filter((member) => Boolean(this.options.room) || !!member.ticket)
             .filter((member) => !this.filterBcConns || !this.hasBcNodeId(member.nodeId))
             .sort((left, right) => stableScore(`${this.providerId}:${right.nodeId}`) -
             stableScore(`${this.providerId}:${left.nodeId}`));
@@ -488,7 +488,9 @@ export class YProvider {
                 }
             }
         }
-        const connectableMembers = candidates.filter((member) => desiredNodeIds.has(member.nodeId) &&
+        // An activated room already owns discovery and dialing. The provider
+        // only attaches its document protocol to the room owner's connections.
+        const connectableMembers = this.options.room ? [] : candidates.filter((member) => desiredNodeIds.has(member.nodeId) &&
             shouldInitiate(localNodeId, member.nodeId) &&
             !this.openrtcConnections.has(member.nodeId) &&
             !this.pendingNodeIds.has(member.nodeId));

package/dist/roomRuntime.js

@@ -8,7 +8,32 @@ function assertRoom(room, requested) {
 }
 /** One-handle adapter; cast is isolated here so provider code cannot see legacy construction. */
 export function runtimeFromRoom(room) {
-    const connections = () => room.diagnostics.connections();
+    // Observe capability-scoped logical connections. Diagnostic connections
+    // are raw transport views and must never carry a product protocol.
+    const observed = new Map();
+    function adaptConnection(connection) {
+        let closed = false;
+        return {
+            id: connection.id,
+            remoteNodeId: connection.peerId,
+            get isClosed() { return closed; },
+            // Public capability messages are JSON values. Preserve Yjs bytes
+            // in an explicit protocol envelope rather than serializing a typed
+            // array into numeric object keys that the receiver cannot decode.
+            send: (payload) => connection.send({ yOpenrtc: 1, bytes: Array.from(payload) }),
+            onMessage: (callback) => connection.onMessage((message) => {
+                const frame = message;
+                if (frame?.yOpenrtc !== 1 || !Array.isArray(frame.bytes)
+                    || !frame.bytes.every(byte => Number.isInteger(byte) && byte >= 0 && byte <= 255))
+                    return;
+                callback(Uint8Array.from(frame.bytes));
+            }),
+            onDisconnect: connection.onClose,
+            disconnect: async () => undefined, // The borrowed room owns lifecycle.
+            markClosed: () => { closed = true; },
+        };
+    }
+    const connections = () => [...observed.values()];
     const adapter = {
         initialize: async () => undefined,
         start: async () => undefined,
@@ -42,18 +67,26 @@ export function runtimeFromRoom(room) {
             }))));
         },
         onConnection: (callback) => {
-            const seen = new Set();
-            const publish = () => {
-                for (const connection of connections()) {
-                    const id = connection.id ?? connection.remoteNodeId;
-                    if (!id || seen.has(id))
-                        continue;
-                    seen.add(id);
-                    callback(connection);
-                }
+            const closeObservers = new Set();
+            const stop = room.onConnection((connection) => {
+                const view = adaptConnection(connection);
+                observed.set(connection.id, view);
+                const stopClose = connection.onClose(() => {
+                    view.markClosed();
+                    if (observed.get(connection.id) === view)
+                        observed.delete(connection.id);
+                    closeObservers.delete(stopClose);
+                    stopClose();
+                });
+                closeObservers.add(stopClose);
+                callback(view);
+            });
+            return () => {
+                stop();
+                closeObservers.forEach(unsubscribe => unsubscribe());
+                closeObservers.clear();
+                observed.clear();
             };
-            publish();
-            return room.peers.watch(publish);
         },
         onStateChange: room.diagnostics.onStateChange,
         getConnections: connections,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "y-openrtc",
-  "version": "2.9.3",
+  "version": "2.9.5",
   "private": false,
   "type": "module",
   "sideEffects": false,
@@ -43,7 +43,7 @@
   },
   "dependencies": {
     "lib0": "^0.2.114",
-    "openrtc": "^2.9.3",
+    "openrtc": "^2.9.5",
     "y-protocols": "^1.0.6"
   },
   "peerDependencies": {
@@ -52,6 +52,7 @@
   "devDependencies": {
     "@types/node": "^24.10.1",
     "happy-dom": "^20.5.0",
+    "playwright": "^1.59.1",
     "typescript": "^5.8.3",
     "vitest": "^4.0.18",
     "yjs": "^13.6.27"