onelobby 0.0.0-stage → 0.2.0

package/dist/voice.js

@@ -0,0 +1,223 @@
+import { Emitter } from "./emitter.js";
+import { FLAG_END_OF_BURST, FRAME_MS, JitterBuffer, VoiceGate, VoicePacketizer, VoiceRelayPolicy, rms, } from "./voice-core.js";
+const SPEAKING_TIMEOUT_MS = 300;
+/** Voice chat (DESIGN s.9a): Opus frames on the `voice` channel, star-routed through the host, never in a frame. */
+export class Voice extends Emitter {
+    hub;
+    deps;
+    mode = "pushToTalk";
+    /** Master mute for capture (self). */
+    muted = false;
+    /** 0..1 RMS of the last captured frame. */
+    inputLevel = 0;
+    bitrate = 24000;
+    _enabled = false;
+    gate = new VoiceGate();
+    packetizer = new VoicePacketizer();
+    relay = new VoiceRelayPolicy();
+    speakers = new Map();
+    peerMuted = new Set();
+    gains = new Map();
+    encoder = null;
+    source = null;
+    sink = null;
+    cancelPlayout = null;
+    endTimer = null;
+    sending = false;
+    constructor(hub, deps) {
+        super();
+        this.hub = hub;
+        this.deps = deps;
+    }
+    get enabled() {
+        return this._enabled;
+    }
+    set enabled(v) {
+        if (v === this._enabled)
+            return;
+        this._enabled = v;
+        if (v)
+            void this.start();
+        else
+            this.stop();
+    }
+    pushToTalk(down) {
+        this.gate.ptt = down;
+    }
+    isMutedPeer(peerId) {
+        return this.peerMuted.has(peerId);
+    }
+    setMuted(peerId, muted) {
+        if (muted)
+            this.peerMuted.add(peerId);
+        else
+            this.peerMuted.delete(peerId);
+    }
+    setVolume(peerId, gain) {
+        this.gains.set(peerId, Math.min(2, Math.max(0, gain)));
+    }
+    volumeOf(peerId) {
+        return this.gains.get(peerId) ?? 1;
+    }
+    // ---- capture -------------------------------------------------------------------------------------------------
+    async start() {
+        try {
+            if (!this.deps.codec)
+                throw new Error("no Opus codec available: supply one through the voice.codec option (WASM fallback)");
+            if (!this.deps.createSink)
+                throw new Error("no audio output available");
+            this.sink = this.deps.createSink();
+            this.cancelPlayout = this.hub.clock.setInterval(() => this.playoutTick(), FRAME_MS);
+            if (this.deps.createSource) {
+                this.encoder = this.deps.codec.createEncoder({ bitrate: this.bitrate }, (opus) => this.onEncoded(opus));
+                this.source = this.deps.createSource();
+                await this.source.start((pcm) => this.onCapturedFrame(pcm, this.hub.clock.now()));
+            }
+        }
+        catch (e) {
+            this._enabled = false;
+            this.stop();
+            this.emit("error", { message: e instanceof Error ? e.message : String(e), cause: e });
+        }
+    }
+    stop() {
+        if (this.sending)
+            this.closeBurst();
+        this.source?.stop();
+        this.source = null;
+        this.encoder?.close();
+        this.encoder = null;
+        this.cancelPlayout?.();
+        this.cancelPlayout = null;
+        this.sink?.close();
+        this.sink = null;
+        for (const [id, s] of this.speakers) {
+            s.decoder?.close();
+            if (s.talking)
+                this.emit("speaking", id, false);
+        }
+        this.speakers.clear();
+    }
+    /** Feed one 20 ms mono 48 kHz frame (called by the mic source; exposed so tests and custom sources can drive it). */
+    onCapturedFrame(pcm, nowMs) {
+        const level = rms(pcm);
+        this.inputLevel = level;
+        if (!this._enabled || this.muted) {
+            if (this.sending)
+                this.closeBurst();
+            return;
+        }
+        const g = this.gate.update(level, nowMs);
+        if (g.send) {
+            this.sending = true;
+            this.endTimer?.();
+            this.endTimer = null;
+            this.encoder?.encode(pcm);
+        }
+        else if (g.edge === "close" && this.sending) {
+            this.closeBurst();
+        }
+    }
+    closeBurst() {
+        this.sending = false;
+        // Encoders can emit asynchronously (WebCodecs); give them one packet's worth of time before the end flag.
+        this.endTimer?.();
+        this.endTimer = this.hub.clock.setTimeout(() => {
+            this.endTimer = null;
+            this.sendPacket(this.packetizer.endBurst());
+        }, FRAME_MS * 2);
+    }
+    /** Send already-encoded Opus frames as one packet (no codec involved); used by tools and conformance. */
+    sendEncoded(frames, endOfBurst = false) {
+        this.sendPacket(this.packetizer.packet(frames, endOfBurst ? FLAG_END_OF_BURST : 0));
+    }
+    /** Encoded frame from the encoder (also the test entry point for packetization). */
+    onEncoded(opus) {
+        const p = this.packetizer.push(opus);
+        if (p)
+            this.sendPacket(p);
+    }
+    sendPacket(p) {
+        const msg = { type: "voice", seq: p.seq, flags: p.flags, frames: p.frames };
+        if (this.hub.isHost) {
+            for (const peer of this.hub.connectedPeers())
+                this.hub.sendTo(peer, msg, this.hub.localPeerId, "voice");
+        }
+        else {
+            this.hub.sendToHost(msg, 0, "voice");
+        }
+    }
+    // ---- receive -------------------------------------------------------------------------------------------------
+    handle(from, route, msg) {
+        if (msg.type !== "voice")
+            return;
+        const size = msg.frames.reduce((a, f) => a + f.length + 2, 0) + 7; // whole wire frame: header 3 + seq/flags/n 4
+        const now = this.hub.clock.now();
+        let speaker = route;
+        if (this.hub.isHost) {
+            speaker = from;
+            if (!this.relay.accept(from, size, msg.flags, now))
+                return;
+            for (const peer of this.hub.connectedPeers()) {
+                if (peer !== from)
+                    this.hub.sendTo(peer, msg, from, "voice");
+            }
+        }
+        this.emit("packet", speaker, msg.seq, msg.flags, msg.frames);
+        if (!this._enabled || speaker === this.hub.localPeerId || this.peerMuted.has(speaker))
+            return;
+        this.receivePacket(speaker, { seq: msg.seq, flags: msg.flags, frames: msg.frames }, now);
+    }
+    /** Local playback path for one speaker's packet (after host forwarding). */
+    receivePacket(speaker, p, now) {
+        let s = this.speakers.get(speaker);
+        if (!s) {
+            s = { jitter: new JitterBuffer(), decoder: null, talking: false, lastHeard: now };
+            this.speakers.set(speaker, s);
+        }
+        s.lastHeard = now;
+        s.jitter.push(p);
+        if (!s.talking && p.frames.length > 0) {
+            s.talking = true;
+            this.emit("speaking", speaker, true);
+        }
+    }
+    playoutTick() {
+        const now = this.hub.clock.now();
+        for (const [id, s] of this.speakers) {
+            const r = s.jitter.pull();
+            if (r.kind === "frame" || r.kind === "plc") {
+                if (!s.decoder && this.deps.codec) {
+                    s.decoder = this.deps.codec.createDecoder((pcm) => this.sink?.play(id, pcm, this.volumeOf(id)));
+                }
+                s.decoder?.decode(r.kind === "frame" ? r.opus : null);
+            }
+            else if (r.kind === "idle" && s.talking) {
+                s.talking = false;
+                this.emit("speaking", id, false);
+            }
+            else if (s.talking && now - s.lastHeard > SPEAKING_TIMEOUT_MS + 5 * FRAME_MS && !s.jitter.active) {
+                s.talking = false;
+                this.emit("speaking", id, false);
+            }
+        }
+    }
+    onPeerLeft(peerId) {
+        this.relay.forget(peerId);
+        const s = this.speakers.get(peerId);
+        if (s) {
+            s.decoder?.close();
+            if (s.talking)
+                this.emit("speaking", peerId, false);
+            this.speakers.delete(peerId);
+        }
+    }
+    close() {
+        this._enabled = false;
+        this.stop();
+        this.endTimer?.();
+    }
+    /** For tests: expose the end-of-burst flag constant. */
+    static END = FLAG_END_OF_BURST;
+}
+//# sourceMappingURL=voice.js.map

package/dist/voice.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"voice.js","sourceRoot":"","sources":["../src/voice.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AAGvC,OAAO,EACL,iBAAiB,EACjB,QAAQ,EACR,YAAY,EACZ,SAAS,EACT,eAAe,EACf,gBAAgB,EAChB,GAAG,GAGJ,MAAM,iBAAiB,CAAC;AAwBzB,MAAM,mBAAmB,GAAG,GAAG,CAAC;AAEhC,oHAAoH;AACpH,MAAM,OAAO,KAAM,SAAQ,OAAoB;IAsBzB;IAAkB;IArBtC,IAAI,GAAc,YAAY,CAAC;IAC/B,sCAAsC;IACtC,KAAK,GAAG,KAAK,CAAC;IACd,2CAA2C;IAC3C,UAAU,GAAG,CAAC,CAAC;IACf,OAAO,GAAG,KAAK,CAAC;IAER,QAAQ,GAAG,KAAK,CAAC;IACjB,IAAI,GAAG,IAAI,SAAS,EAAE,CAAC;IACvB,UAAU,GAAG,IAAI,eAAe,EAAE,CAAC;IACnC,KAAK,GAAG,IAAI,gBAAgB,EAAE,CAAC;IAC/B,QAAQ,GAAG,IAAI,GAAG,EAAmB,CAAC;IACtC,SAAS,GAAG,IAAI,GAAG,EAAU,CAAC;IAC9B,KAAK,GAAG,IAAI,GAAG,EAAkB,CAAC;IAClC,OAAO,GAA8B,IAAI,CAAC;IAC1C,MAAM,GAAuB,IAAI,CAAC;IAClC,IAAI,GAAqB,IAAI,CAAC;IAC9B,aAAa,GAAwB,IAAI,CAAC;IAC1C,QAAQ,GAAwB,IAAI,CAAC;IACrC,OAAO,GAAG,KAAK,CAAC;IAExB,YAAoB,GAAQ,EAAU,IAAe;QACnD,KAAK,EAAE,CAAC;QADU,QAAG,GAAH,GAAG,CAAK;QAAU,SAAI,GAAJ,IAAI,CAAW;IAErD,CAAC;IAED,IAAI,OAAO;QACT,OAAO,IAAI,CAAC,QAAQ,CAAC;IACvB,CAAC;IACD,IAAI,OAAO,CAAC,CAAU;QACpB,IAAI,CAAC,KAAK,IAAI,CAAC,QAAQ;YAAE,OAAO;QAChC,IAAI,CAAC,QAAQ,GAAG,CAAC,CAAC;QAClB,IAAI,CAAC;YAAE,KAAK,IAAI,CAAC,KAAK,EAAE,CAAC;;YACpB,IAAI,CAAC,IAAI,EAAE,CAAC;IACnB,CAAC;IAED,UAAU,CAAC,IAAa;QACtB,IAAI,CAAC,IAAI,CAAC,GAAG,GAAG,IAAI,CAAC;IACvB,CAAC;IAED,WAAW,CAAC,MAAc;QACxB,OAAO,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;IACpC,CAAC;IACD,QAAQ,CAAC,MAAc,EAAE,KAAc;QACrC,IAAI,KAAK;YAAE,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;;YACjC,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;IACrC,CAAC;IACD,SAAS,CAAC,MAAc,EAAE,IAAY;QACpC,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,MAAM,EAAE,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,CAAC,CAAC,CAAC;IACzD,CAAC;IACD,QAAQ,CAAC,MAAc;QACrB,OAAO,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;IACrC,CAAC;IAED,iHAAiH;IAEzG,KAAK,CAAC,KAAK;QACjB,IAAI,CAAC;YACH,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,KAAK;gBAAE,MAAM,IAAI,KAAK,CAAC,oFAAoF,CAAC,CAAC;YAC5H,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,UAAU;gBAAE,MAAM,IAAI,KAAK,CAAC,2BAA2B,CAAC,CAAC;YACxE,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC,IAAI,CAAC,UAAU,EAAE,CAAC;YACnC,IAAI,CAAC,aAAa,GAAG,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC,WAAW,CAAC,GAAG,EAAE,CAAC,IAAI,CAAC,WAAW,EAAE,EAAE,QAAQ,CAAC,CAAC;YACpF,IAAI,IAAI,CAAC,IAAI,CAAC,YAAY,EAAE,CAAC;gBAC3B,IAAI,CAAC,OAAO,GAAG,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,aAAa,CAAC,EAAE,OAAO,EAAE,IAAI,CAAC,OAAO,EAAE,EAAE,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC,CAAC;gBACxG,IAAI,CAAC,MAAM,GAAG,IAAI,CAAC,IAAI,CAAC,YAAY,EAAE,CAAC;gBACvC,MAAM,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,IAAI,CAAC,eAAe,CAAC,GAAG,EAAE,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,CAAC,CAAC;YACpF,CAAC;QACH,CAAC;QAAC,OAAO,CAAC,EAAE,CAAC;YACX,IAAI,CAAC,QAAQ,GAAG,KAAK,CAAC;YACtB,IAAI,CAAC,IAAI,EAAE,CAAC;YACZ,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,EAAE,OAAO,EAAE,CAAC,YAAY,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,EAAE,CAAC,CAAC;QACxF,CAAC;IACH,CAAC;IAEO,IAAI;QACV,IAAI,IAAI,CAAC,OAAO;YAAE,IAAI,CAAC,UAAU,EAAE,CAAC;QACpC,IAAI,CAAC,MAAM,EAAE,IAAI,EAAE,CAAC;QACpB,IAAI,CAAC,MAAM,GAAG,IAAI,CAAC;QACnB,IAAI,CAAC,OAAO,EAAE,KAAK,EAAE,CAAC;QACtB,IAAI,CAAC,OAAO,GAAG,IAAI,CAAC;QACpB,IAAI,CAAC,aAAa,EAAE,EAAE,CAAC;QACvB,IAAI,CAAC,aAAa,GAAG,IAAI,CAAC;QAC1B,IAAI,CAAC,IAAI,EAAE,KAAK,EAAE,CAAC;QACnB,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;QACjB,KAAK,MAAM,CAAC,EAAE,EAAE,CAAC,CAAC,IAAI,IAAI,CAAC,QAAQ,EAAE,CAAC;YACpC,CAAC,CAAC,OAAO,EAAE,KAAK,EAAE,CAAC;YACnB,IAAI,CAAC,CAAC,OAAO;gBAAE,IAAI,CAAC,IAAI,CAAC,UAAU,EAAE,EAAE,EAAE,KAAK,CAAC,CAAC;QAClD,CAAC;QACD,IAAI,CAAC,QAAQ,CAAC,KAAK,EAAE,CAAC;IACxB,CAAC;IAED,qHAAqH;IACrH,eAAe,CAAC,GAAiB,EAAE,KAAa;QAC9C,MAAM,KAAK,GAAG,GAAG,CAAC,GAAG,CAAC,CAAC;QACvB,IAAI,CAAC,UAAU,GAAG,KAAK,CAAC;QACxB,IAAI,CAAC,IAAI,CAAC,QAAQ,IAAI,IAAI,CAAC,KAAK,EAAE,CAAC;YACjC,IAAI,IAAI,CAAC,OAAO;gBAAE,IAAI,CAAC,UAAU,EAAE,CAAC;YACpC,OAAO;QACT,CAAC;QACD,MAAM,CAAC,GAAG,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,KAAK,EAAE,KAAK,CAAC,CAAC;QACzC,IAAI,CAAC,CAAC,IAAI,EAAE,CAAC;YACX,IAAI,CAAC,OAAO,GAAG,IAAI,CAAC;YACpB,IAAI,CAAC,QAAQ,EAAE,EAAE,CAAC;YAClB,IAAI,CAAC,QAAQ,GAAG,IAAI,CAAC;YACrB,IAAI,CAAC,OAAO,EAAE,MAAM,CAAC,GAAG,CAAC,CAAC;QAC5B,CAAC;aAAM,IAAI,CAAC,CAAC,IAAI,KAAK,OAAO,IAAI,IAAI,CAAC,OAAO,EAAE,CAAC;YAC9C,IAAI,CAAC,UAAU,EAAE,CAAC;QACpB,CAAC;IACH,CAAC;IAEO,UAAU;QAChB,IAAI,CAAC,OAAO,GAAG,KAAK,CAAC;QACrB,0GAA0G;QAC1G,IAAI,CAAC,QAAQ,EAAE,EAAE,CAAC;QAClB,IAAI,CAAC,QAAQ,GAAG,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC,UAAU,CAAC,GAAG,EAAE;YAC7C,IAAI,CAAC,QAAQ,GAAG,IAAI,CAAC;YACrB,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,UAAU,CAAC,QAAQ,EAAE,CAAC,CAAC;QAC9C,CAAC,EAAE,QAAQ,GAAG,CAAC,CAAC,CAAC;IACnB,CAAC;IAED,yGAAyG;IACzG,WAAW,CAAC,MAAoB,EAAE,UAAU,GAAG,KAAK;QAClD,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,UAAU,CAAC,MAAM,CAAC,MAAM,EAAE,UAAU,CAAC,CAAC,CAAC,iBAAiB,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;IACtF,CAAC;IAED,oFAAoF;IACpF,SAAS,CAAC,IAAgB;QACxB,MAAM,CAAC,GAAG,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QACrC,IAAI,CAAC;YAAE,IAAI,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC;IAC5B,CAAC;IAEO,UAAU,CAAC,CAAc;QAC/B,MAAM,GAAG,GAAY,EAAE,IAAI,EAAE,OAAO,EAAE,GAAG,EAAE,CAAC,CAAC,GAAG,EAAE,KAAK,EAAE,CAAC,CAAC,KAAK,EAAE,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC;QACrF,IAAI,IAAI,CAAC,GAAG,CAAC,MAAM,EAAE,CAAC;YACpB,KAAK,MAAM,IAAI,IAAI,IAAI,CAAC,GAAG,CAAC,cAAc,EAAE;gBAAE,IAAI,CAAC,GAAG,CAAC,MAAM,CAAC,IAAI,EAAE,GAAG,EAAE,IAAI,CAAC,GAAG,CAAC,WAAW,EAAE,OAAO,CAAC,CAAC;QAC1G,CAAC;aAAM,CAAC;YACN,IAAI,CAAC,GAAG,CAAC,UAAU,CAAC,GAAG,EAAE,CAAC,EAAE,OAAO,CAAC,CAAC;QACvC,CAAC;IACH,CAAC;IAED,iHAAiH;IAEjH,MAAM,CAAC,IAAY,EAAE,KAAa,EAAE,GAAY;QAC9C,IAAI,GAAG,CAAC,IAAI,KAAK,OAAO;YAAE,OAAO;QACjC,MAAM,IAAI,GAAG,GAAG,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,6CAA6C;QAChH,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC;QACjC,IAAI,OAAO,GAAG,KAAK,CAAC;QACpB,IAAI,IAAI,CAAC,GAAG,CAAC,MAAM,EAAE,CAAC;YACpB,OAAO,GAAG,IAAI,CAAC;YACf,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,IAAI,EAAE,IAAI,EAAE,GAAG,CAAC,KAAK,EAAE,GAAG,CAAC;gBAAE,OAAO;YAC3D,KAAK,MAAM,IAAI,IAAI,IAAI,CAAC,GAAG,CAAC,cAAc,EAAE,EAAE,CAAC;gBAC7C,IAAI,IAAI,KAAK,IAAI;oBAAE,IAAI,CAAC,GAAG,CAAC,MAAM,CAAC,IAAI,EAAE,GAAG,EAAE,IAAI,EAAE,OAAO,CAAC,CAAC;YAC/D,CAAC;QACH,CAAC;QACD,IAAI,CAAC,IAAI,CAAC,QAAQ,EAAE,OAAO,EAAE,GAAG,CAAC,GAAG,EAAE,GAAG,CAAC,KAAK,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC;QAC7D,IAAI,CAAC,IAAI,CAAC,QAAQ,IAAI,OAAO,KAAK,IAAI,CAAC,GAAG,CAAC,WAAW,IAAI,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,OAAO,CAAC;YAAE,OAAO;QAC9F,IAAI,CAAC,aAAa,CAAC,OAAO,EAAE,EAAE,GAAG,EAAE,GAAG,CAAC,GAAG,EAAE,KAAK,EAAE,GAAG,CAAC,KAAK,EAAE,MAAM,EAAE,GAAG,CAAC,MAAM,EAAE,EAAE,GAAG,CAAC,CAAC;IAC3F,CAAC;IAED,4EAA4E;IAC5E,aAAa,CAAC,OAAe,EAAE,CAAc,EAAE,GAAW;QACxD,IAAI,CAAC,GAAG,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;QACnC,IAAI,CAAC,CAAC,EAAE,CAAC;YACP,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,YAAY,EAAE,EAAE,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,KAAK,EAAE,SAAS,EAAE,GAAG,EAAE,CAAC;YAClF,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC;QAChC,CAAC;QACD,CAAC,CAAC,SAAS,GAAG,GAAG,CAAC;QAClB,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QACjB,IAAI,CAAC,CAAC,CAAC,OAAO,IAAI,CAAC,CAAC,MAAM,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YACtC,CAAC,CAAC,OAAO,GAAG,IAAI,CAAC;YACjB,IAAI,CAAC,IAAI,CAAC,UAAU,EAAE,OAAO,EAAE,IAAI,CAAC,CAAC;QACvC,CAAC;IACH,CAAC;IAEO,WAAW;QACjB,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC;QACjC,KAAK,MAAM,CAAC,EAAE,EAAE,CAAC,CAAC,IAAI,IAAI,CAAC,QAAQ,EAAE,CAAC;YACpC,MAAM,CAAC,GAAG,CAAC,CAAC,MAAM,CAAC,IAAI,EAAE,CAAC;YAC1B,IAAI,CAAC,CAAC,IAAI,KAAK,OAAO,IAAI,CAAC,CAAC,IAAI,KAAK,KAAK,EAAE,CAAC;gBAC3C,IAAI,CAAC,CAAC,CAAC,OAAO,IAAI,IAAI,CAAC,IAAI,CAAC,KAAK,EAAE,CAAC;oBAClC,CAAC,CAAC,OAAO,GAAG,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,aAAa,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,IAAI,CAAC,IAAI,EAAE,IAAI,CAAC,EAAE,EAAE,GAAG,EAAE,IAAI,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC;gBAClG,CAAC;gBACD,CAAC,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC,CAAC,IAAI,KAAK,OAAO,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC;YACxD,CAAC;iBAAM,IAAI,CAAC,CAAC,IAAI,KAAK,MAAM,IAAI,CAAC,CAAC,OAAO,EAAE,CAAC;gBAC1C,CAAC,CAAC,OAAO,GAAG,KAAK,CAAC;gBAClB,IAAI,CAAC,IAAI,CAAC,UAAU,EAAE,EAAE,EAAE,KAAK,CAAC,CAAC;YACnC,CAAC;iBAAM,IAAI,CAAC,CAAC,OAAO,IAAI,GAAG,GAAG,CAAC,CAAC,SAAS,GAAG,mBAAmB,GAAG,CAAC,GAAG,QAAQ,IAAI,CAAC,CAAC,CAAC,MAAM,CAAC,MAAM,EAAE,CAAC;gBACnG,CAAC,CAAC,OAAO,GAAG,KAAK,CAAC;gBAClB,IAAI,CAAC,IAAI,CAAC,UAAU,EAAE,EAAE,EAAE,KAAK,CAAC,CAAC;YACnC,CAAC;QACH,CAAC;IACH,CAAC;IAED,UAAU,CAAC,MAAc;QACvB,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;QAC1B,MAAM,CAAC,GAAG,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;QACpC,IAAI,CAAC,EAAE,CAAC;YACN,CAAC,CAAC,OAAO,EAAE,KAAK,EAAE,CAAC;YACnB,IAAI,CAAC,CAAC,OAAO;gBAAE,IAAI,CAAC,IAAI,CAAC,UAAU,EAAE,MAAM,EAAE,KAAK,CAAC,CAAC;YACpD,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;QAC/B,CAAC;IACH,CAAC;IAED,KAAK;QACH,IAAI,CAAC,QAAQ,GAAG,KAAK,CAAC;QACtB,IAAI,CAAC,IAAI,EAAE,CAAC;QACZ,IAAI,CAAC,QAAQ,EAAE,EAAE,CAAC;IACpB,CAAC;IAED,wDAAwD;IACxD,MAAM,CAAU,GAAG,GAAG,iBAAiB,CAAC","sourcesContent":["import type { VoiceError } from \"./voice-types.js\";\nimport { Emitter } from \"./emitter.js\";\nimport type { Hub } from \"./hub.js\";\nimport type { Message } from \"./codec.js\";\nimport {\n  FLAG_END_OF_BURST,\n  FRAME_MS,\n  JitterBuffer,\n  VoiceGate,\n  VoicePacketizer,\n  VoiceRelayPolicy,\n  rms,\n  type VoiceMode,\n  type VoicePacket,\n} from \"./voice-core.js\";\nimport type { AudioSink, FrameSource, VoiceCodec, VoiceDecoderHandle, VoiceEncoderHandle } from \"./voice-types.js\";\n\nexport type VoiceEvents = {\n  speaking: [peerId: number, talking: boolean];\n  error: [VoiceError];\n  /** Every voice packet that reached this peer (after the host's validity checks), before mute/enable filtering. */\n  packet: [speaker: number, seq: number, flags: number, frames: Uint8Array[]];\n};\n\ninterface Speaker {\n  jitter: JitterBuffer;\n  decoder: VoiceDecoderHandle | null;\n  talking: boolean;\n  lastHeard: number;\n}\n\nexport interface VoiceDeps {\n  codec: VoiceCodec | null;\n  /** Creates the mic capture; resolved on `enabled = true`. */\n  createSource: (() => FrameSource) | null;\n  createSink: (() => AudioSink) | null;\n}\n\nconst SPEAKING_TIMEOUT_MS = 300;\n\n/** Voice chat (DESIGN s.9a): Opus frames on the `voice` channel, star-routed through the host, never in a frame. */\nexport class Voice extends Emitter<VoiceEvents> {\n  mode: VoiceMode = \"pushToTalk\";\n  /** Master mute for capture (self). */\n  muted = false;\n  /** 0..1 RMS of the last captured frame. */\n  inputLevel = 0;\n  bitrate = 24000;\n\n  private _enabled = false;\n  private gate = new VoiceGate();\n  private packetizer = new VoicePacketizer();\n  private relay = new VoiceRelayPolicy();\n  private speakers = new Map<number, Speaker>();\n  private peerMuted = new Set<number>();\n  private gains = new Map<number, number>();\n  private encoder: VoiceEncoderHandle | null = null;\n  private source: FrameSource | null = null;\n  private sink: AudioSink | null = null;\n  private cancelPlayout: (() => void) | null = null;\n  private endTimer: (() => void) | null = null;\n  private sending = false;\n\n  constructor(private hub: Hub, private deps: VoiceDeps) {\n    super();\n  }\n\n  get enabled(): boolean {\n    return this._enabled;\n  }\n  set enabled(v: boolean) {\n    if (v === this._enabled) return;\n    this._enabled = v;\n    if (v) void this.start();\n    else this.stop();\n  }\n\n  pushToTalk(down: boolean): void {\n    this.gate.ptt = down;\n  }\n\n  isMutedPeer(peerId: number): boolean {\n    return this.peerMuted.has(peerId);\n  }\n  setMuted(peerId: number, muted: boolean): void {\n    if (muted) this.peerMuted.add(peerId);\n    else this.peerMuted.delete(peerId);\n  }\n  setVolume(peerId: number, gain: number): void {\n    this.gains.set(peerId, Math.min(2, Math.max(0, gain)));\n  }\n  volumeOf(peerId: number): number {\n    return this.gains.get(peerId) ?? 1;\n  }\n\n  // ---- capture -------------------------------------------------------------------------------------------------\n\n  private async start(): Promise<void> {\n    try {\n      if (!this.deps.codec) throw new Error(\"no Opus codec available: supply one through the voice.codec option (WASM fallback)\");\n      if (!this.deps.createSink) throw new Error(\"no audio output available\");\n      this.sink = this.deps.createSink();\n      this.cancelPlayout = this.hub.clock.setInterval(() => this.playoutTick(), FRAME_MS);\n      if (this.deps.createSource) {\n        this.encoder = this.deps.codec.createEncoder({ bitrate: this.bitrate }, (opus) => this.onEncoded(opus));\n        this.source = this.deps.createSource();\n        await this.source.start((pcm) => this.onCapturedFrame(pcm, this.hub.clock.now()));\n      }\n    } catch (e) {\n      this._enabled = false;\n      this.stop();\n      this.emit(\"error\", { message: e instanceof Error ? e.message : String(e), cause: e });\n    }\n  }\n\n  private stop(): void {\n    if (this.sending) this.closeBurst();\n    this.source?.stop();\n    this.source = null;\n    this.encoder?.close();\n    this.encoder = null;\n    this.cancelPlayout?.();\n    this.cancelPlayout = null;\n    this.sink?.close();\n    this.sink = null;\n    for (const [id, s] of this.speakers) {\n      s.decoder?.close();\n      if (s.talking) this.emit(\"speaking\", id, false);\n    }\n    this.speakers.clear();\n  }\n\n  /** Feed one 20 ms mono 48 kHz frame (called by the mic source; exposed so tests and custom sources can drive it). */\n  onCapturedFrame(pcm: Float32Array, nowMs: number): void {\n    const level = rms(pcm);\n    this.inputLevel = level;\n    if (!this._enabled || this.muted) {\n      if (this.sending) this.closeBurst();\n      return;\n    }\n    const g = this.gate.update(level, nowMs);\n    if (g.send) {\n      this.sending = true;\n      this.endTimer?.();\n      this.endTimer = null;\n      this.encoder?.encode(pcm);\n    } else if (g.edge === \"close\" && this.sending) {\n      this.closeBurst();\n    }\n  }\n\n  private closeBurst(): void {\n    this.sending = false;\n    // Encoders can emit asynchronously (WebCodecs); give them one packet's worth of time before the end flag.\n    this.endTimer?.();\n    this.endTimer = this.hub.clock.setTimeout(() => {\n      this.endTimer = null;\n      this.sendPacket(this.packetizer.endBurst());\n    }, FRAME_MS * 2);\n  }\n\n  /** Send already-encoded Opus frames as one packet (no codec involved); used by tools and conformance. */\n  sendEncoded(frames: Uint8Array[], endOfBurst = false): void {\n    this.sendPacket(this.packetizer.packet(frames, endOfBurst ? FLAG_END_OF_BURST : 0));\n  }\n\n  /** Encoded frame from the encoder (also the test entry point for packetization). */\n  onEncoded(opus: Uint8Array): void {\n    const p = this.packetizer.push(opus);\n    if (p) this.sendPacket(p);\n  }\n\n  private sendPacket(p: VoicePacket): void {\n    const msg: Message = { type: \"voice\", seq: p.seq, flags: p.flags, frames: p.frames };\n    if (this.hub.isHost) {\n      for (const peer of this.hub.connectedPeers()) this.hub.sendTo(peer, msg, this.hub.localPeerId, \"voice\");\n    } else {\n      this.hub.sendToHost(msg, 0, \"voice\");\n    }\n  }\n\n  // ---- receive -------------------------------------------------------------------------------------------------\n\n  handle(from: number, route: number, msg: Message): void {\n    if (msg.type !== \"voice\") return;\n    const size = msg.frames.reduce((a, f) => a + f.length + 2, 0) + 7; // whole wire frame: header 3 + seq/flags/n 4\n    const now = this.hub.clock.now();\n    let speaker = route;\n    if (this.hub.isHost) {\n      speaker = from;\n      if (!this.relay.accept(from, size, msg.flags, now)) return;\n      for (const peer of this.hub.connectedPeers()) {\n        if (peer !== from) this.hub.sendTo(peer, msg, from, \"voice\");\n      }\n    }\n    this.emit(\"packet\", speaker, msg.seq, msg.flags, msg.frames);\n    if (!this._enabled || speaker === this.hub.localPeerId || this.peerMuted.has(speaker)) return;\n    this.receivePacket(speaker, { seq: msg.seq, flags: msg.flags, frames: msg.frames }, now);\n  }\n\n  /** Local playback path for one speaker's packet (after host forwarding). */\n  receivePacket(speaker: number, p: VoicePacket, now: number): void {\n    let s = this.speakers.get(speaker);\n    if (!s) {\n      s = { jitter: new JitterBuffer(), decoder: null, talking: false, lastHeard: now };\n      this.speakers.set(speaker, s);\n    }\n    s.lastHeard = now;\n    s.jitter.push(p);\n    if (!s.talking && p.frames.length > 0) {\n      s.talking = true;\n      this.emit(\"speaking\", speaker, true);\n    }\n  }\n\n  private playoutTick(): void {\n    const now = this.hub.clock.now();\n    for (const [id, s] of this.speakers) {\n      const r = s.jitter.pull();\n      if (r.kind === \"frame\" || r.kind === \"plc\") {\n        if (!s.decoder && this.deps.codec) {\n          s.decoder = this.deps.codec.createDecoder((pcm) => this.sink?.play(id, pcm, this.volumeOf(id)));\n        }\n        s.decoder?.decode(r.kind === \"frame\" ? r.opus : null);\n      } else if (r.kind === \"idle\" && s.talking) {\n        s.talking = false;\n        this.emit(\"speaking\", id, false);\n      } else if (s.talking && now - s.lastHeard > SPEAKING_TIMEOUT_MS + 5 * FRAME_MS && !s.jitter.active) {\n        s.talking = false;\n        this.emit(\"speaking\", id, false);\n      }\n    }\n  }\n\n  onPeerLeft(peerId: number): void {\n    this.relay.forget(peerId);\n    const s = this.speakers.get(peerId);\n    if (s) {\n      s.decoder?.close();\n      if (s.talking) this.emit(\"speaking\", peerId, false);\n      this.speakers.delete(peerId);\n    }\n  }\n\n  close(): void {\n    this._enabled = false;\n    this.stop();\n    this.endTimer?.();\n  }\n\n  /** For tests: expose the end-of-burst flag constant. */\n  static readonly END = FLAG_END_OF_BURST;\n}\n"]}

package/dist/webrtc.d.ts

@@ -0,0 +1,29 @@
+import { type ChannelName, type LinkFactory, type LinkOptions, type PeerLink, type SignalPayload } from "./transport.js";
+/** Browser (or any WebRTC-capable runtime) PeerLink over RTCPeerConnection with three negotiated channels. */
+export declare class WebRtcLink implements PeerLink {
+    readonly remoteId: number;
+    isOpen: boolean;
+    onSignal: PeerLink["onSignal"];
+    onOpen: PeerLink["onOpen"];
+    onClose: PeerLink["onClose"];
+    onMessage: PeerLink["onMessage"];
+    onPath: PeerLink["onPath"];
+    private pc;
+    private channels;
+    private pendingIce;
+    private closed;
+    private opened;
+    private extra;
+    /** `rtc`: the RTCPeerConnection class to use (default the global one; in Node, node-datachannel's polyfill). */
+    constructor(opts: LinkOptions, rtc?: typeof RTCPeerConnection);
+    startOffer(): void;
+    handleSignal(s: SignalPayload): Promise<void>;
+    /** Selected candidate pair has a relay candidate -> "relayed", else "direct". Retries while stats settle. */
+    private reportPath;
+    send(channel: ChannelName, bytes: Uint8Array): void;
+    close(): void;
+    private fail;
+}
+export declare const webRtcLinkFactory: LinkFactory;
+/** A link factory over a given RTCPeerConnection class, e.g. `import { RTCPeerConnection } from "node-datachannel/polyfill"`. */
+export declare function webRtcLinkFactoryFor(rtc: typeof RTCPeerConnection): LinkFactory;

package/dist/webrtc.js

@@ -0,0 +1,169 @@
+import { CHANNEL_IDS, } from "./transport.js";
+const CHANNEL_INIT = {
+    reliable: { negotiated: true, id: CHANNEL_IDS.reliable, ordered: true },
+    fast: { negotiated: true, id: CHANNEL_IDS.fast, ordered: false, maxRetransmits: 0 },
+    voice: { negotiated: true, id: CHANNEL_IDS.voice, ordered: false, maxRetransmits: 0 },
+};
+/** Browser (or any WebRTC-capable runtime) PeerLink over RTCPeerConnection with three negotiated channels. */
+export class WebRtcLink {
+    remoteId;
+    isOpen = false;
+    onSignal = null;
+    onOpen = null;
+    onClose = null;
+    onMessage = null;
+    onPath = null;
+    pc;
+    channels = {};
+    pendingIce = [];
+    closed = false;
+    opened = 0;
+    extra;
+    /** `rtc`: the RTCPeerConnection class to use (default the global one; in Node, node-datachannel's polyfill). */
+    constructor(opts, rtc = globalThis.RTCPeerConnection) {
+        this.remoteId = opts.remoteId;
+        this.extra = opts.extraRemoteCandidates ?? [];
+        const config = {
+            iceServers: opts.iceServers,
+            iceTransportPolicy: opts.relayOnly ? "relay" : "all",
+        };
+        if (opts.portRange) {
+            // libdatachannel names (node-datachannel passes its config through); one pinned port = every peer on it
+            config.portRangeBegin = opts.portRange.begin;
+            config.portRangeEnd = opts.portRange.end;
+            if (opts.portRange.begin === opts.portRange.end)
+                config.enableIceUdpMux = true;
+        }
+        this.pc = new rtc(config);
+        this.pc.onicecandidate = (e) => {
+            if (e.candidate)
+                this.onSignal?.({ ice: e.candidate.toJSON() });
+        };
+        this.pc.onconnectionstatechange = () => {
+            const s = this.pc.connectionState;
+            if (s === "failed" || s === "closed" || s === "disconnected") {
+                // "disconnected" can recover; give ICE a moment before declaring the link dead.
+                if (s === "disconnected")
+                    setTimeout(() => this.pc.connectionState === "disconnected" && this.fail("disconnected"), 4000);
+                else
+                    this.fail(s);
+            }
+        };
+        for (const name of ["reliable", "fast", "voice"]) {
+            const ch = this.pc.createDataChannel(name, CHANNEL_INIT[name]);
+            ch.binaryType = "arraybuffer";
+            ch.onopen = () => {
+                if (++this.opened === 3 && !this.closed) {
+                    this.isOpen = true;
+                    this.onOpen?.();
+                    void this.reportPath();
+                }
+            };
+            ch.onclose = () => this.fail(`channel ${name} closed`);
+            ch.onmessage = (e) => {
+                const d = e.data;
+                const data = d instanceof ArrayBuffer ? new Uint8Array(d) : ArrayBuffer.isView(d) ? new Uint8Array(d.buffer, d.byteOffset, d.byteLength) : new Uint8Array(d);
+                this.onMessage?.(name, data);
+            };
+            this.channels[name] = ch;
+        }
+    }
+    startOffer() {
+        void (async () => {
+            try {
+                const offer = await this.pc.createOffer();
+                await this.pc.setLocalDescription(offer);
+                this.onSignal?.({ sdp: { type: "offer", sdp: offer.sdp ?? "" } });
+            }
+            catch (e) {
+                this.fail(`offer failed: ${String(e)}`);
+            }
+        })();
+    }
+    async handleSignal(s) {
+        try {
+            if (s.sdp) {
+                await this.pc.setRemoteDescription({ type: s.sdp.type, sdp: s.sdp.sdp });
+                for (const c of this.pendingIce.splice(0))
+                    await this.pc.addIceCandidate(c);
+                if (this.extra.length) {
+                    // docs/direct-ip.md s.2: the address the joiner typed is the host's reachable candidate
+                    const mid = /^a=mid:(\S+)/m.exec(s.sdp.sdp)?.[1] ?? "0";
+                    for (const candidate of this.extra.splice(0))
+                        await this.pc.addIceCandidate({ candidate, sdpMid: mid, sdpMLineIndex: 0 });
+                }
+                if (s.sdp.type === "offer") {
+                    const answer = await this.pc.createAnswer();
+                    await this.pc.setLocalDescription(answer);
+                    this.onSignal?.({ sdp: { type: "answer", sdp: answer.sdp ?? "" } });
+                }
+            }
+            if (s.ice) {
+                if (this.pc.remoteDescription)
+                    await this.pc.addIceCandidate(s.ice);
+                else
+                    this.pendingIce.push(s.ice);
+            }
+        }
+        catch (e) {
+            this.fail(`signal failed: ${String(e)}`);
+        }
+    }
+    /** Selected candidate pair has a relay candidate -> "relayed", else "direct". Retries while stats settle. */
+    async reportPath(attempt = 0) {
+        if (this.closed || attempt > 10)
+            return;
+        try {
+            const stats = await this.pc.getStats();
+            const byId = new Map();
+            stats.forEach((v) => byId.set(v.id, v));
+            let pair;
+            stats.forEach((v) => {
+                if (v.type === "transport" && v.selectedCandidatePairId)
+                    pair = byId.get(v.selectedCandidatePairId);
+            });
+            if (!pair)
+                stats.forEach((v) => { if (v.type === "candidate-pair" && (v.selected || (v.nominated && v.state === "succeeded")))
+                    pair = v; });
+            const l = pair && byId.get(pair.localCandidateId);
+            const r = pair && byId.get(pair.remoteCandidateId);
+            if (l && r) {
+                this.onPath?.(l.candidateType === "relay" || r.candidateType === "relay" ? "relayed" : "direct");
+                return;
+            }
+        }
+        catch {
+            /* stats unavailable: retry */
+        }
+        setTimeout(() => void this.reportPath(attempt + 1), 300);
+    }
+    send(channel, bytes) {
+        const ch = this.channels[channel];
+        if (ch && ch.readyState === "open")
+            ch.send(bytes);
+    }
+    close() {
+        this.fail("closed locally");
+    }
+    fail(reason) {
+        if (this.closed)
+            return;
+        this.closed = true;
+        const wasOpen = this.isOpen;
+        this.isOpen = false;
+        try {
+            this.pc.close();
+        }
+        catch {
+            /* ignore */
+        }
+        void wasOpen;
+        this.onClose?.(reason);
+    }
+}
+export const webRtcLinkFactory = { create: (opts) => new WebRtcLink(opts) };
+/** A link factory over a given RTCPeerConnection class, e.g. `import { RTCPeerConnection } from "node-datachannel/polyfill"`. */
+export function webRtcLinkFactoryFor(rtc) {
+    return { create: (opts) => new WebRtcLink(opts, rtc) };
+}
+//# sourceMappingURL=webrtc.js.map

package/dist/webrtc.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"webrtc.js","sourceRoot":"","sources":["../src/webrtc.ts"],"names":[],"mappings":"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","sourcesContent":["import {\n  CHANNEL_IDS,\n  type ChannelName,\n  type LinkFactory,\n  type LinkOptions,\n  type PeerLink,\n  type SignalPayload,\n} from \"./transport.js\";\n\nconst CHANNEL_INIT: Record<ChannelName, RTCDataChannelInit> = {\n  reliable: { negotiated: true, id: CHANNEL_IDS.reliable, ordered: true },\n  fast: { negotiated: true, id: CHANNEL_IDS.fast, ordered: false, maxRetransmits: 0 },\n  voice: { negotiated: true, id: CHANNEL_IDS.voice, ordered: false, maxRetransmits: 0 },\n};\n\n/** Browser (or any WebRTC-capable runtime) PeerLink over RTCPeerConnection with three negotiated channels. */\nexport class WebRtcLink implements PeerLink {\n  readonly remoteId: number;\n  isOpen = false;\n  onSignal: PeerLink[\"onSignal\"] = null;\n  onOpen: PeerLink[\"onOpen\"] = null;\n  onClose: PeerLink[\"onClose\"] = null;\n  onMessage: PeerLink[\"onMessage\"] = null;\n  onPath: PeerLink[\"onPath\"] = null;\n\n  private pc: RTCPeerConnection;\n  private channels = {} as Record<ChannelName, RTCDataChannel>;\n  private pendingIce: RTCIceCandidateInit[] = [];\n  private closed = false;\n  private opened = 0;\n  private extra: string[];\n\n  /** `rtc`: the RTCPeerConnection class to use (default the global one; in Node, node-datachannel's polyfill). */\n  constructor(opts: LinkOptions, rtc: typeof RTCPeerConnection = globalThis.RTCPeerConnection) {\n    this.remoteId = opts.remoteId;\n    this.extra = opts.extraRemoteCandidates ?? [];\n    const config: RTCConfiguration & Record<string, unknown> = {\n      iceServers: opts.iceServers as RTCIceServer[],\n      iceTransportPolicy: opts.relayOnly ? \"relay\" : \"all\",\n    };\n    if (opts.portRange) {\n      // libdatachannel names (node-datachannel passes its config through); one pinned port = every peer on it\n      config.portRangeBegin = opts.portRange.begin;\n      config.portRangeEnd = opts.portRange.end;\n      if (opts.portRange.begin === opts.portRange.end) config.enableIceUdpMux = true;\n    }\n    this.pc = new rtc(config);\n    this.pc.onicecandidate = (e) => {\n      if (e.candidate) this.onSignal?.({ ice: e.candidate.toJSON() as { candidate: string } });\n    };\n    this.pc.onconnectionstatechange = () => {\n      const s = this.pc.connectionState;\n      if (s === \"failed\" || s === \"closed\" || s === \"disconnected\") {\n        // \"disconnected\" can recover; give ICE a moment before declaring the link dead.\n        if (s === \"disconnected\") setTimeout(() => this.pc.connectionState === \"disconnected\" && this.fail(\"disconnected\"), 4000);\n        else this.fail(s);\n      }\n    };\n    for (const name of [\"reliable\", \"fast\", \"voice\"] as ChannelName[]) {\n      const ch = this.pc.createDataChannel(name, CHANNEL_INIT[name]);\n      ch.binaryType = \"arraybuffer\";\n      ch.onopen = () => {\n        if (++this.opened === 3 && !this.closed) {\n          this.isOpen = true;\n          this.onOpen?.();\n          void this.reportPath();\n        }\n      };\n      ch.onclose = () => this.fail(`channel ${name} closed`);\n      ch.onmessage = (e) => {\n        const d = e.data as unknown;\n        const data = d instanceof ArrayBuffer ? new Uint8Array(d) : ArrayBuffer.isView(d) ? new Uint8Array(d.buffer, d.byteOffset, d.byteLength) : new Uint8Array(d as never);\n        this.onMessage?.(name, data);\n      };\n      this.channels[name] = ch;\n    }\n  }\n\n  startOffer(): void {\n    void (async () => {\n      try {\n        const offer = await this.pc.createOffer();\n        await this.pc.setLocalDescription(offer);\n        this.onSignal?.({ sdp: { type: \"offer\", sdp: offer.sdp ?? \"\" } });\n      } catch (e) {\n        this.fail(`offer failed: ${String(e)}`);\n      }\n    })();\n  }\n\n  async handleSignal(s: SignalPayload): Promise<void> {\n    try {\n      if (s.sdp) {\n        await this.pc.setRemoteDescription({ type: s.sdp.type, sdp: s.sdp.sdp });\n        for (const c of this.pendingIce.splice(0)) await this.pc.addIceCandidate(c);\n        if (this.extra.length) {\n          // docs/direct-ip.md s.2: the address the joiner typed is the host's reachable candidate\n          const mid = /^a=mid:(\\S+)/m.exec(s.sdp.sdp)?.[1] ?? \"0\";\n          for (const candidate of this.extra.splice(0)) await this.pc.addIceCandidate({ candidate, sdpMid: mid, sdpMLineIndex: 0 });\n        }\n        if (s.sdp.type === \"offer\") {\n          const answer = await this.pc.createAnswer();\n          await this.pc.setLocalDescription(answer);\n          this.onSignal?.({ sdp: { type: \"answer\", sdp: answer.sdp ?? \"\" } });\n        }\n      }\n      if (s.ice) {\n        if (this.pc.remoteDescription) await this.pc.addIceCandidate(s.ice as RTCIceCandidateInit);\n        else this.pendingIce.push(s.ice as RTCIceCandidateInit);\n      }\n    } catch (e) {\n      this.fail(`signal failed: ${String(e)}`);\n    }\n  }\n\n  /** Selected candidate pair has a relay candidate -> \"relayed\", else \"direct\". Retries while stats settle. */\n  private async reportPath(attempt = 0): Promise<void> {\n    if (this.closed || attempt > 10) return;\n    try {\n      const stats = await this.pc.getStats();\n      const byId = new Map<string, any>();\n      stats.forEach((v) => byId.set(v.id, v));\n      let pair: any;\n      stats.forEach((v) => {\n        if (v.type === \"transport\" && v.selectedCandidatePairId) pair = byId.get(v.selectedCandidatePairId);\n      });\n      if (!pair) stats.forEach((v) => { if (v.type === \"candidate-pair\" && (v.selected || (v.nominated && v.state === \"succeeded\"))) pair = v; });\n      const l = pair && byId.get(pair.localCandidateId);\n      const r = pair && byId.get(pair.remoteCandidateId);\n      if (l && r) {\n        this.onPath?.(l.candidateType === \"relay\" || r.candidateType === \"relay\" ? \"relayed\" : \"direct\");\n        return;\n      }\n    } catch {\n      /* stats unavailable: retry */\n    }\n    setTimeout(() => void this.reportPath(attempt + 1), 300);\n  }\n\n  send(channel: ChannelName, bytes: Uint8Array): void {\n    const ch = this.channels[channel];\n    if (ch && ch.readyState === \"open\") ch.send(bytes as unknown as ArrayBuffer);\n  }\n\n  close(): void {\n    this.fail(\"closed locally\");\n  }\n\n  private fail(reason: string): void {\n    if (this.closed) return;\n    this.closed = true;\n    const wasOpen = this.isOpen;\n    this.isOpen = false;\n    try {\n      this.pc.close();\n    } catch {\n      /* ignore */\n    }\n    void wasOpen;\n    this.onClose?.(reason);\n  }\n}\n\nexport const webRtcLinkFactory: LinkFactory = { create: (opts) => new WebRtcLink(opts) };\n\n/** A link factory over a given RTCPeerConnection class, e.g. `import { RTCPeerConnection } from \"node-datachannel/polyfill\"`. */\nexport function webRtcLinkFactoryFor(rtc: typeof RTCPeerConnection): LinkFactory {\n  return { create: (opts) => new WebRtcLink(opts, rtc) };\n}\n"]}

package/package.json

@@ -1,6 +1,95 @@
 {
   "name": "onelobby",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
-}
+  "version": "0.2.0",
+  "description": "Multiplayer for browser games: host/join lobbies by short code, peer-to-peer WebRTC, lockstep sync, text and voice chat. Zero runtime dependencies; works from a plain <script> tag.",
+  "keywords": [
+    "multiplayer",
+    "lobby",
+    "webrtc",
+    "p2p",
+    "peer-to-peer",
+    "netcode",
+    "lockstep",
+    "game",
+    "gamedev",
+    "browser-game",
+    "voice-chat",
+    "onelobby"
+  ],
+  "license": "MIT",
+  "author": "Parker Tonra",
+  "homepage": "https://github.com/ParkerTonra/onelobby#readme",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/ParkerTonra/onelobby.git",
+    "directory": "clients/js/packages/client"
+  },
+  "bugs": {
+    "url": "https://github.com/ParkerTonra/onelobby/issues"
+  },
+  "type": "module",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "unpkg": "./dist/onelobby.global.min.js",
+  "jsdelivr": "./dist/onelobby.global.min.js",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js",
+      "default": "./dist/index.js"
+    },
+    "./internals": {
+      "types": "./dist/internals.d.ts",
+      "import": "./dist/internals.js",
+      "default": "./dist/internals.js"
+    },
+    "./testing": {
+      "types": "./dist/testing.d.ts",
+      "import": "./dist/testing.js",
+      "default": "./dist/testing.js"
+    },
+    "./direct": {
+      "types": "./dist/direct/index.d.ts",
+      "import": "./dist/direct/index.js",
+      "default": "./dist/direct/index.js"
+    },
+    "./ui": {
+      "types": "./dist/ui/index.d.ts",
+      "import": "./dist/ui/index.js",
+      "default": "./dist/ui/index.js"
+    },
+    "./global": "./dist/onelobby.global.js",
+    "./bundle": {
+      "types": "./dist/global.d.ts",
+      "default": "./dist/onelobby.bundle.mjs"
+    },
+    "./package.json": "./package.json"
+  },
+  "files": [
+    "dist",
+    "README.md",
+    "LICENSE"
+  ],
+  "sideEffects": [
+    "./dist/onelobby.global.js",
+    "./dist/onelobby.global.min.js",
+    "./dist/ui/index.js",
+    "./dist/ui/element.js"
+  ],
+  "engines": {
+    "node": ">=18"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "scripts": {
+    "build": "node -e \"require('fs').rmSync('dist',{recursive:true,force:true})\" && tsc -p tsconfig.build.json && node scripts/bundle.mjs",
+    "typecheck": "tsc -p tsconfig.json --noEmit",
+    "test": "vitest run",
+    "prepublishOnly": "npm run typecheck && npm run build && npm test && node scripts/prepublish-check.mjs"
+  },
+  "devDependencies": {
+    "esbuild": "^0.28.2",
+    "node-datachannel": "^0.33.4"
+  }
+}