freehop 0.1.0-alpha.2 → 0.1.0-alpha.3

package/README.md

@@ -13,7 +13,7 @@
 ![License: Apache-2.0](https://img.shields.io/badge/code-Apache--2.0-303055)
 ![Docs: CC BY 4.0](https://img.shields.io/badge/docs-CC%20BY%204.0-303055)
 ![Home-built network test matrix: 40/40](https://img.shields.io/badge/home%E2%80%91built%20network%20tests-40%2F40-096e72)
-![Unit tests: 167/167](https://img.shields.io/badge/unit%20tests-167%2F167-096e72)
+![Unit tests: 173/173](https://img.shields.io/badge/unit%20tests-173%2F173-096e72)
 ![Status: alpha](https://img.shields.io/badge/status-alpha-ef3b2c)
 
 </div>
@@ -88,8 +88,8 @@ arrive.
 
 **40/40 home-lab network test runs passed** on 2 October 2026 after security hardening,
 including gateways that relay only inside their session. That matrix has not been rerun for
-alpha.2. These are repeatable simulated-network results, not field reliability evidence. Other checks:
-- **167/167 unit tests**, including the RFC 5769 STUN vectors and the security regressions.
+this revision. These are repeatable simulated-network results, not field reliability evidence. Other checks:
+- **173/173 unit tests**, including the RFC 5769 STUN vectors and the security regressions.
 - **coturn's own test client** against Freehop's TURN server: 800/800 messages over UDP and 800/800 over TCP, 0 lost.
 - **Browser suites:** multi-gate with every gate shut down mid-call, kick/rekey, a public WebTorrent tracker as the only gate, and the SDK example app.
 
@@ -111,7 +111,7 @@ Freehop is an independent project; any app can use the same public SDK.
 ## Quickstart
 
 ```bash
-npm install freehop@alpha                 # current alpha: 0.1.0-alpha.2
+npm install freehop@alpha                 # install the current alpha release
 ```
 
 **Backend:** decide who is in a room.

package/SDK.md

@@ -55,6 +55,7 @@ session.on('path', ({ peer, kind, via }) => …);          // direct | gateway |
 session.on('peer-left', ({ id, reason }) => …);
 await session.setMicrophone(false); await session.setCamera(true);
 const levels = await session.levels();                   // speaking indicators
+await session.setPeerMuted(peerId, true);          // silence one member locally
 await session.update(newTicket, { dropped: [kickedPeerId] });   // after a kick
 await session.switchDevice('audio', deviceId);      // another microphone or camera, no renegotiation
 await session.send({ type: 'chat', text: 'hi' });   // app data to everyone (or { to: peerId })

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "freehop",
-  "version": "0.1.0-alpha.2",
+  "version": "0.1.0-alpha.3",
   "description": "Open-source peer-to-peer voice, video and data SDK for browser and desktop apps, with signalling gates and session-member media gateways.",
   "license": "Apache-2.0",
   "type": "module",
@@ -27,6 +27,10 @@
   "scripts": {
     "test": "node --test test/*.test.mjs",
     "test:browsers": "node test/browser/smoke.mjs chromium,firefox,webkit --tls && node test/browser/multigate.mjs && node test/browser/rekey.mjs && node test/browser/example-app.mjs",
+    "unitgate": "node tools/unitgate.mjs",
+    "exportsgate": "node tools/exportsgate.mjs",
+    "docsyncgate": "node tools/docsyncgate.mjs",
+    "ship": "node tools/ship.mjs",
     "gate": "node bin/freehop-gate.mjs",
     "example": "node examples/minimal/server.mjs"
   },

package/src/client/room.mjs

@@ -121,6 +121,8 @@ export class Room extends Emitter {
       offerTimeouts: 0, mediaStalls: 0, appSent: 0, appReceived: 0, appDropped: 0 };
     this.appBudget = new Map();   // sender -> { tokens, at }
     this.videoQuality = new Map(); // peer -> per-link send/receive controller state
+    this.mutedPeers = new Set();  // peers muted locally (setPeerMuted)
+    this.remoteAudio = new Map(); // peer -> Set of live remote audio tracks, for flipping enabled
     // Preferred capture devices (options.devices, switchDevice); every later capture uses them.
     if (!deviceId(options.devices?.audio) || !deviceId(options.devices?.video)) throw new TypeError('Invalid capture device id');
     this.devices = { audio: options.devices?.audio ?? null, video: options.devices?.video ?? null };
@@ -346,8 +348,10 @@ export class Room extends Emitter {
     this.known.delete(peer); this.hintedAt.delete(peer); this.caps.delete(peer); this.presence.delete(peer); this.early.delete(peer); this.outbox.delete(peer);
     this.sendProgress.delete(peer); this.meshBudget.delete(peer); this.appBudget.delete(peer); this.videoQuality.delete(peer);
     this.lastContact.delete(peer); this.gatewayCreds.delete(`${this.tag8}:${peer}`);
-    // The replay window survives a soft departure: a returning peer keeps its counter.
-    if (reason !== 'gone') this.sequences.delete(peer);
+    this.remoteAudio.delete(peer);
+    // A softly departed ('gone') peer may return with the same id: its replay window and local
+    // mute survive. Terminal departures ('bye', 'dropped', 'rekey') clear both.
+    if (reason !== 'gone') { this.sequences.delete(peer); this.mutedPeers.delete(peer); }
     this.departed.set(peer, { at: Date.now(), reason });
     if (this.departed.size > 256) this.departed.delete(this.departed.keys().next().value);
     for (const [key, b] of [...this.bridgePending]) if (b.a === peer || b.b === peer) {
@@ -900,6 +904,18 @@ export class Room extends Emitter {
   setMicrophone(enabled) { return this.#enableTrack('audio', enabled, MIC); }
   setCamera(enabled) { return this.#enableTrack('video', enabled, CAM); }
 
+  /**
+   * Silences one member locally: enabled = false on their current and future remote audio
+   * tracks. Media still arrives and nothing is signalled, so the peer cannot tell. Muting
+   * an unknown peer is allowed and applies when their audio arrives. Video is untouched.
+   */
+  setPeerMuted(peer, muted) {
+    if (typeof peer !== 'string' || !PEER_ID.test(peer)) throw new TypeError('Invalid peer id');
+    if (typeof muted !== 'boolean') throw new TypeError('muted must be a boolean');
+    if (muted) this.mutedPeers.add(peer); else this.mutedPeers.delete(peer);
+    for (const track of this.remoteAudio.get(peer) ?? []) track.enabled = !muted;
+  }
+
   constraintsFor(kind, base) { const id = this.devices[kind]; return id ? { ...base, deviceId: { exact: id } } : base; }
 
   /**
@@ -1193,6 +1209,13 @@ export class Room extends Emitter {
   }
 
   onRemoteTrack(link, origin, track, stream) {
+    if (track.kind === 'audio') {
+      let set = this.remoteAudio.get(origin);
+      if (!set) this.remoteAudio.set(origin, set = new Set());
+      set.add(track);
+      track.addEventListener('ended', () => set.delete(track));
+      if (this.mutedPeers.has(origin)) track.enabled = false;
+    }
     this.emit('track', { peer: origin, via: origin === link.id ? null : link.id, track, stream });
     if (origin !== link.id) return;
     // A forwarder keeps forwarding tracks the origin adds later (e.g. camera switched on).