onelobby 0.2.0 → 0.2.1

package/dist/onelobby.d.ts

@@ -5,7 +5,7 @@ import { type LobbySummary } from "./signaling.js";
 import { type LinkFactory, type SocketFactory } from "./transport.js";
 import type { VoiceCodec, FrameSource, AudioSink } from "./voice-types.js";
 export declare const LIB_NAME = "onelobby";
-export declare const LIB_VERSION = "0.2.0";
+export declare const LIB_VERSION = "0.2.1";
 /** Where `rememberSeat` keeps the resume token: the subset of the Web Storage API it uses. */
 export interface SeatStorage {
     getItem(key: string): string | null;

package/dist/onelobby.global.js

@@ -1,4 +1,4 @@
-/*! onelobby 0.2.0 | MIT license */
+/*! onelobby 0.2.1 | MIT license */
 "use strict";
 var OneLobby = (() => {
   var __defProp = Object.defineProperty;
@@ -1626,11 +1626,12 @@ var OneLobby = (() => {
 
   // src/socket.ts
   function closeCodeFor(reason) {
-    if (reason === "left") return 1e3;
+    if (reason === "left" || reason === "disconnected") return 1e3;
     if (reason === "host_left" || reason === "closed") return 1001;
     if (reason === "kicked") return 4e3;
     return 1006;
   }
+  var nextTask = globalThis.setImmediate ?? ((f) => void setTimeout(f, 0));
   var enc2 = new TextEncoder();
   var dec2 = new TextDecoder();
   var PeerSocket = class {
@@ -1646,7 +1647,9 @@ var OneLobby = (() => {
     onLocalClose;
     readyState = 0;
     bufferedAmount = 0;
-    onopen = null;
+    openHandler = null;
+    /** OPEN, but `onopen` has not run yet for any handler. */
+    openPending = false;
     onmessage = null;
     onclose = null;
     onerror = null;
@@ -1662,12 +1665,28 @@ var OneLobby = (() => {
       this.closed(code, reason);
       this.onLocalClose();
     }
-    /** @internal OPEN now; `onopen` now, or one microtask later so a handler assigned right after creation still runs. */
+    get onopen() {
+      return this.openHandler;
+    }
+    set onopen(h) {
+      this.openHandler = h;
+      if (h && this.openPending) nextTask(() => this.fireOpen());
+    }
+    /**
+     * @internal OPEN now; `onopen` now, or on a later task (like a real WebSocket) so a handler assigned
+     * after any number of awaits in the same task still runs.
+     */
     open(later = false) {
       if (this.readyState !== 0) return;
       this.readyState = 1;
-      if (!later) this.onopen?.({ type: "open" });
-      else queueMicrotask(() => this.readyState === 1 && this.onopen?.({ type: "open" }));
+      this.openPending = true;
+      if (!later) this.fireOpen();
+      else nextTask(() => this.fireOpen());
+    }
+    fireOpen() {
+      if (this.readyState !== 1 || !this.openPending || !this.openHandler) return;
+      this.openPending = false;
+      this.openHandler({ type: "open" });
     }
     /** @internal */
     deliver(bytes) {
@@ -1689,7 +1708,7 @@ var OneLobby = (() => {
       lobby.on("message", (from, bytes) => {
         if (from === lobby.hostPeerId) s.deliver(bytes);
       }),
-      lobby.on("sessionEnded", (reason) => s.closed(closeCodeFor(reason), reason)),
+      lobby.on("sessionEnded", (reason, close) => s.closed(close?.code ?? closeCodeFor(reason), close?.reason ?? reason)),
       // The socket's far end is the host it opened to; after a migration that server is gone (direct lobbies end instead).
       lobby.on("hostChanged", () => s.closed(1001, "host_changed"))
     ];
@@ -1722,7 +1741,10 @@ var OneLobby = (() => {
     const offs = [
       lobby.on("peerReady", (p) => void ensure(p.peerId)),
       lobby.on("message", (from, bytes) => ensure(from)?.deliver(bytes)),
-      lobby.on("peerLeft", (p, reason) => conns.get(p.peerId)?.closed(reason === "left" ? 1001 : closeCodeFor(reason), reason)),
+      lobby.on(
+        "peerLeft",
+        (p, reason, close) => conns.get(p.peerId)?.closed(close?.code ?? (reason === "left" ? 1001 : closeCodeFor(reason)), close?.reason ?? reason)
+      ),
       lobby.on("sessionEnded", (reason) => {
         for (const c of [...conns.values()]) c.closed(reason === "left" ? 1001 : closeCodeFor(reason), reason);
         offs.forEach((f) => f());
@@ -1736,6 +1758,7 @@ var OneLobby = (() => {
 
   // src/lobby.ts
   var MIN_PEER_TIMEOUT_MS = 6e3;
+  var KICK_LINGER_MS = 3e3;
   function seatName(p) {
     const n = typeof p.name === "string" ? p.name.trim() : "";
     if (n && n !== "Player") return p;
@@ -1797,12 +1820,14 @@ var OneLobby = (() => {
     relayRetry = false;
     /** clock.now() of the last frame from each peer (peerTimeoutMs). */
     lastHeard = /* @__PURE__ */ new Map();
+    /** Host: links of kicked / disconnected peers, kept open briefly (removePeer `linger`). */
+    lingering = /* @__PURE__ */ new Set();
     /** Host: per-peer fixed window for rateLimit. */
     rate = /* @__PURE__ */ new Map();
     /**
      * Resolves when this peer can exchange data: immediately for the host, once the link to the host is open for a
      * joiner. Rejects with OneLobbyError("ice_failed") when the joiner cannot reach the host in `readyTimeoutMs`
-     * (or with "closed"/"kicked" when the lobby ends first).
+     * (or with "closed"/"kicked" when the lobby ends first; "closed" also when the host disconnected it).
      */
     ready = new Promise((res, rej) => {
       this.markReady = () => {
@@ -1930,10 +1955,32 @@ var OneLobby = (() => {
       this.signaling.send({ t: "meta", meta });
       this.emit("metaChanged", this.meta);
     }
-    async kick(peerId) {
+    /**
+     * Host: removes a player. By default it is a ban: the hub refuses that player's address for the rest of this lobby
+     * (a new tab or a reload included). `{ ban: false }` is `disconnect()`. `code` / `reason` reach the player's
+     * `asWebSocket()` onclose (and `sessionEnded`'s second argument); without them its socket closes with 4000 "kicked".
+     */
+    async kick(peerId, opts = {}) {
       if (!this.isHost) throw new Error("only the host can kick");
-      this.signaling.send({ t: "kick", peerId });
-      this.removePeer(peerId, "kicked");
+      const { ban = true, code, reason } = opts;
+      if (code !== void 0 && !(code === 1e3 || Number.isInteger(code) && code >= 3e3 && code <= 4999))
+        throw new RangeError("close code must be 1000 or 3000-4999");
+      if (reason !== void 0 && reason.length > 120) throw new RangeError("close reason must be at most 120 characters");
+      const msg = { t: "kick", peerId };
+      if (!ban) msg.ban = false;
+      if (code !== void 0) msg.closeCode = code;
+      if (reason !== void 0) msg.closeReason = reason;
+      this.signaling.send(msg);
+      const close = code !== void 0 || reason !== void 0 ? { code, reason } : void 0;
+      this.removePeer(peerId, ban ? "kicked" : "disconnected", close, true);
+    }
+    /**
+     * Host: ends one player's connection without a ban, like a server closing one WebSocket. The player's
+     * `asWebSocket()` gets onclose with `code` (default 1000) and `reason` (default "disconnected"), its lobby ends with
+     * `sessionEnded("disconnected")`, and it may join again (a new tab, a reload). Same as `kick(peerId, { ban: false, code, reason })`.
+     */
+    disconnect(peerId, code, reason) {
+      return this.kick(peerId, { ban: false, code, reason });
     }
     async approve(peerId, ok) {
       if (!this.isHost) throw new Error("only the host can approve joins");
@@ -2334,8 +2381,13 @@ var OneLobby = (() => {
           void this.onSignal(Number(m.from), m);
           break;
         case "error":
-          if (m.code === "kicked") this.teardown("kicked");
-          else this.reportError(new OneLobbyError(String(m.code), String(m.msg ?? ""), m.data));
+          if (m.code === "kicked") {
+            const d = m.data ?? {};
+            const close = {};
+            if (typeof d.closeCode === "number") close.code = d.closeCode;
+            if (typeof d.closeReason === "string") close.reason = d.closeReason;
+            this.teardown(d.ban === false ? "disconnected" : "kicked", close.code !== void 0 || close.reason !== void 0 ? close : void 0);
+          } else this.reportError(new OneLobbyError(String(m.code), String(m.msg ?? ""), m.data));
           break;
       }
     }
@@ -2350,7 +2402,12 @@ var OneLobby = (() => {
       if (s.ice) payload.ice = s.ice;
       await link.handleSignal(payload);
     }
-    removePeer(peerId, reason) {
+    /**
+     * `linger` (host kick / disconnect): stop using the peer's link at once but leave it open until that peer closes it
+     * or KICK_LINGER_MS pass. The hub tells the peer over its WebSocket; closing the data link first would make it look
+     * like the host vanished (a migration and a 1001 instead of the host's close code).
+     */
+    removePeer(peerId, reason, close, linger = false) {
       const peer = this.roster.get(peerId);
       if (peerId === this.localPeerId) {
         this.teardown(reason === "kicked" ? "kicked" : reason);
@@ -2359,11 +2416,23 @@ var OneLobby = (() => {
       if (peer) this.roster.delete(peerId);
       const link = this.links.get(peerId);
       if (link && peerId !== this.hostPeerId) {
-        link.onClose = null;
         link.onMessage = null;
-        link.close();
         this.links.delete(peerId);
         this.hiSentTo.delete(link);
+        if (linger) {
+          this.lingering.add(link);
+          const done = () => {
+            if (!this.lingering.delete(link)) return;
+            cancel();
+            link.onClose = null;
+            link.close();
+          };
+          const cancel = this.cfg.clock.setTimeout(done, KICK_LINGER_MS);
+          link.onClose = done;
+        } else {
+          link.onClose = null;
+          link.close();
+        }
       }
       this.connected.delete(peerId);
       this.outbox.delete(peerId);
@@ -2372,14 +2441,15 @@ var OneLobby = (() => {
       this.lockstep.onPeerLeft(peerId);
       this.chat.onPeerLeft(peerId);
       this.voice.onPeerLeft(peerId);
-      if (peer) this.emit("peerLeft", peer, reason);
+      if (peer) this.emit("peerLeft", peer, reason, close);
       if (peerId === this.hostPeerId && !this.isHost) {
         this.handleHostLost(reason);
       }
     }
+    /** Lockstep drops (stalled, desynced): removed without a ban, so the player can come back (a rejoin resyncs). */
     dropPeer(peerId, reason) {
-      this.signaling.send({ t: "kick", peerId });
-      this.removePeer(peerId, reason);
+      this.signaling.send({ t: "kick", peerId, ban: false, closeReason: reason });
+      this.removePeer(peerId, reason, void 0, true);
     }
     setPhase(p) {
       if (p !== "lobby" && p !== "in_game") return;
@@ -2430,7 +2500,7 @@ var OneLobby = (() => {
       if (this.ended || this.isHost) return;
       this.sendTo(this.hostPeerId, { type: "ping", n: ++this.pingN, t: this.cfg.clock.now() >>> 0 }, 0, "fast");
     }
-    teardown(reason) {
+    teardown(reason, close) {
       if (this.ended) return;
       this.ended = true;
       this.cancelReadyTimer?.();
@@ -2442,16 +2512,17 @@ var OneLobby = (() => {
       this.cancelPing?.();
       this.lockstep.stop();
       this.voice.close();
-      for (const l of this.links.values()) {
+      for (const l of [...this.links.values(), ...this.lingering]) {
         l.onClose = null;
         l.onMessage = null;
         l.close();
       }
       this.links.clear();
+      this.lingering.clear();
       this.signaling.onClose = null;
       this.signaling.onMessage = null;
       this.signaling.close();
-      this.emit("sessionEnded", reason);
+      this.emit("sessionEnded", reason, close);
     }
     /** Total in-flight links (diagnostics and tests). */
     get linkCount() {
@@ -2761,6 +2832,29 @@ registerProcessor('onelobby-capture', OneLobbyCapture);
     }
     return crc;
   }
+  function parseIPv4(ip) {
+    const parts = ip.split(".");
+    if (parts.length !== 4) return null;
+    let n = 0;
+    for (const p of parts) {
+      if (!/^\d{1,3}$/.test(p) || Number(p) > 255) return null;
+      n = n * 256 + Number(p);
+    }
+    return n;
+  }
+  function encodeJoinCode(ipv4, port) {
+    const ip = parseIPv4(ipv4);
+    if (ip === null) throw new Error(`not an IPv4 address: ${ipv4}`);
+    if (!Number.isInteger(port) || port < 1 || port > 65535) throw new Error(`bad port ${port}`);
+    const data = BigInt(ip) << 16n | BigInt(port);
+    let v = data << 5n | BigInt(crc5(data, 50));
+    let s = "";
+    for (let i = 0; i < JOIN_CODE_LENGTH; i++) {
+      s = CROCKFORD_ALPHABET[Number(v & 31n)] + s;
+      v >>= 5n;
+    }
+    return `${s.slice(0, 4)}-${s.slice(4, 8)}-${s.slice(8)}`;
+  }
   function normalizeJoinCode(input) {
     const s = input.replace(/[ \-]/g, "").replace(/[a-z]/g, (c) => c.toUpperCase()).replace(/[IL]/g, "1").replace(/O/g, "0");
     if (s.length !== JOIN_CODE_LENGTH) return null;
@@ -2836,7 +2930,7 @@ registerProcessor('onelobby-capture', OneLobbyCapture);
 
   // src/onelobby.ts
   var LIB_NAME = "onelobby";
-  var LIB_VERSION = "0.2.0";
+  var LIB_VERSION = "0.2.1";
   var DEFAULT_READY_TIMEOUT_MS = 15e3;
   function hasMic() {
     return typeof navigator !== "undefined" && !!navigator.mediaDevices?.getUserMedia && typeof AudioWorkletNode !== "undefined";
@@ -3080,7 +3174,9 @@ registerProcessor('onelobby-capture', OneLobbyCapture);
       const { sig, welcome } = await this.connect(addr.url, this.socketFactory, opts.connectTimeoutMs ?? 5e3);
       try {
         const state = await sig.request({ t: "join", ...opts.password ? { password: opts.password } : {} }, "lobby");
-        return this.makeLobby(sig, welcome, state, { links });
+        const lobby = this.makeLobby(sig, welcome, state, { links });
+        lobby.joinCode = joinedWith(addr);
+        return lobby;
       } catch (e) {
         sig.close();
         throw e;
@@ -3139,6 +3235,14 @@ registerProcessor('onelobby-capture', OneLobbyCapture);
       }
     }
   };
+  function joinedWith(addr) {
+    if (addr.isIPv6) return addr.display;
+    try {
+      return encodeJoinCode(addr.host, addr.port);
+    } catch {
+      return addr.display;
+    }
+  }
 
   // src/friendly.ts
   var TEXT = {