rtc.io-server 1.1.0 → 1.2.1

package/README.md

@@ -21,12 +21,9 @@ server.on("connection", (socket) => {
     socket.to(roomId).emit("#rtcio:init-offer", { source: socket.id });
   });
 
-  socket.on("disconnecting", () => {
-    socket.rooms.forEach((roomId) => {
-      if (roomId === socket.id) return;
-      socket.to(roomId).emit("user-disconnected", { id: socket.id });
-    });
-  });
+  // No `disconnecting` handler needed for peer cleanup — the rtc.io-server
+  // core emits `#rtcio:peer-left` automatically. Add one only if you have
+  // app-level cleanup (presence rosters, room password registries, etc.).
 });
 
 server.listen(3001);
@@ -34,7 +31,12 @@ server.listen(3001);
 
 ## What this server does
 
-The rtc.io client multiplexes all WebRTC signaling (offers, answers, ICE candidates, stream metadata) into a single `#rtcio:message` event. This server registers a default handler for that event and relays it to the addressed peer (`socket.to(target).emit(...)`). Everything else — room management, app-level events, presence — is **your** code.
+The rtc.io client multiplexes all WebRTC signaling (offers, answers, ICE candidates, stream metadata) into a single `#rtcio:message` event. This server registers default handlers that:
+
+1. Relay `#rtcio:message` envelopes to the addressed peer (`socket.to(target).emit(...)`).
+2. Emit a `#rtcio:peer-left` notification to a leaving socket's rooms on `disconnecting`, so existing peers can short-circuit ICE consent-freshness (~30 s) when a tab closes. The client treats this as a hint that's cross-checked against the local WebRTC state; it never tears down a healthy P2P call on the basis of a signaling-only event. See the [signaling protocol](https://docs.rtcio.dev/docs/server/protocol#rtciopeer-left) for the full contract.
+
+Everything else — room management, app-level events, presence — is **your** code.
 
 ### What you implement
 

package/dist/lib/defaulthandlers.js

@@ -4,9 +4,29 @@ exports.addDefaultListeners = addDefaultListeners;
 const events_1 = require("./events");
 // The rtc.io client multiplexes all signaling (offer/answer/candidate/stream-meta)
 // over a single MESSAGE channel — these are the only events the server needs to relay.
+//
+// `source` is stamped server-side from the authenticated socket id, never trusted
+// from the client: otherwise a room member could spoof another peer's id and inject
+// offers/answers/candidates that appear to come from someone else. `target` stays
+// client-controlled (it's the routing key) but must be a string.
 function rtcMessageHandler(socket, data) {
-    socket.to(data.target).emit(events_1.RtcioEvents.MESSAGE, data);
+    if (!data || typeof data.target !== "string")
+        return;
+    socket.to(data.target).emit(events_1.RtcioEvents.MESSAGE, Object.assign(Object.assign({}, data), { source: socket.id }));
+}
+// Fast-path "this socket is leaving" notification. Without it, peers have to
+// wait on ICE consent freshness (~30 s, RFC 7675) to declare a vanished peer
+// dead. With it, peers can confirm against their own WebRTC layer and tear
+// down the matching RTCPeerConnection in a couple of seconds.
+function rtcDisconnectingHandler(socket) {
+    const ownId = socket.id;
+    socket.rooms.forEach((roomId) => {
+        if (roomId === ownId)
+            return;
+        socket.to(roomId).emit(events_1.RtcioEvents.PEER_LEFT, { id: ownId });
+    });
 }
 function addDefaultListeners(socket) {
     socket.on(events_1.RtcioEvents.MESSAGE, (data) => rtcMessageHandler(socket, data));
+    socket.on("disconnecting", () => rtcDisconnectingHandler(socket));
 }

package/dist/lib/events.d.ts

@@ -1,8 +1,5 @@
 export declare const RtcioEvents: {
-    readonly OFFER: "#rtcio:offer";
-    readonly ANSWER: "#rtcio:answer";
-    readonly CANDIDATE: "#rtcio:candidate";
     readonly MESSAGE: "#rtcio:message";
-    readonly STREAM_META: "#rtcio:stream-meta";
     readonly INIT_OFFER: "#rtcio:init-offer";
+    readonly PEER_LEFT: "#rtcio:peer-left";
 };

package/dist/lib/events.js

@@ -2,10 +2,10 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.RtcioEvents = void 0;
 exports.RtcioEvents = {
-    OFFER: "#rtcio:offer",
-    ANSWER: "#rtcio:answer",
-    CANDIDATE: "#rtcio:candidate",
     MESSAGE: "#rtcio:message",
-    STREAM_META: "#rtcio:stream-meta",
     INIT_OFFER: "#rtcio:init-offer",
+    // Server → client. Fan out to a leaving socket's rooms so existing peers
+    // can tear down their RTCPeerConnection immediately instead of waiting
+    // on ICE consent-freshness (~30 s) to declare the peer dead.
+    PEER_LEFT: "#rtcio:peer-left",
 };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "rtc.io-server",
-  "version": "1.1.0",
+  "version": "1.2.1",
   "description": "Signaling server for the rtc.io WebRTC client. Built on socket.io.",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",
@@ -17,22 +17,23 @@
     "server"
   ],
   "license": "MIT",
-  "author": "",
+  "author": "solidet-com",
   "repository": {
     "type": "git",
-    "url": "https://github.com/<your-org>/rtc.io.git",
+    "url": "git+https://github.com/solidet-com/rtc.io.git",
     "directory": "rtc.io-server"
   },
   "bugs": {
-    "url": "https://github.com/<your-org>/rtc.io/issues"
+    "url": "https://github.com/solidet-com/rtc.io/issues"
   },
-  "homepage": "https://github.com/<your-org>/rtc.io#readme",
+  "homepage": "https://docs.rtcio.dev",
   "engines": {
     "node": ">=18"
   },
   "scripts": {
     "clean": "rm -rf dist",
     "build": "npm run clean && tsc",
+    "typecheck": "tsc --noEmit",
     "dev": "nodemon --watch '**/*.ts' --exec 'ts-node' ./index.ts",
     "prepack": "npm run build"
   },