onelobby 0.1.0 → 0.2.1

package/dist/onelobby.js

@@ -6,10 +6,10 @@ import { OneLobbyError, PROTO_ID, SignalingClient, } from "./signaling.js";
 import { defaultSocketFactory, } from "./transport.js";
 import { WebAudioSink, WorkletMic, webCodecsOpus, webCodecsOpusAvailable } from "./voice-browser.js";
 import { webRtcLinkFactory } from "./webrtc.js";
-import { decodeJoinCode, looksLikeJoinCode } from "./joincode.js";
+import { decodeJoinCode, encodeJoinCode, looksLikeJoinCode } from "./joincode.js";
 import { DEFAULT_DIRECT_PORT, parseDirectAddress } from "./direct-address.js";
 export const LIB_NAME = "onelobby";
-export const LIB_VERSION = "0.1.0";
+export const LIB_VERSION = "0.2.1";
 export const DEFAULT_READY_TIMEOUT_MS = 15_000;
 function hasMic() {
     return typeof navigator !== "undefined" && !!navigator.mediaDevices?.getUserMedia && typeof AudioWorkletNode !== "undefined";
@@ -58,6 +58,7 @@ export class OneLobby extends Emitter {
             displayName: (o.displayName ?? "").trim(),
             relayOnly: o.relayOnly ?? false,
             readyTimeoutMs: o.readyTimeoutMs ?? DEFAULT_READY_TIMEOUT_MS,
+            peerTimeoutMs: o.peerTimeoutMs ?? 0,
         };
         const a = o.advanced ?? {};
         const pick = (k) => (a[k] !== undefined ? a[k] : o[k]);
@@ -184,7 +185,7 @@ export class OneLobby extends Emitter {
             throw e;
         }
     }
-    makeLobby(sig, welcome, state, direct) {
+    makeLobby(sig, welcome, state, direct, rateLimit) {
         const lobby = new Lobby({
             signaling: sig,
             state,
@@ -198,6 +199,8 @@ export class OneLobby extends Emitter {
             displayName: this.options.displayName,
             voice: { codec: this.voiceCodec, createSource: this.createMic, createSink: this.createSink },
             readyTimeoutMs: this.options.readyTimeoutMs,
+            peerTimeoutMs: this.options.peerTimeoutMs,
+            rateLimit,
         });
         lobby.errorSink = (e) => this.emit("error", e);
         if (this.storage && !direct) {
@@ -225,7 +228,7 @@ export class OneLobby extends Emitter {
                 meta: h.meta ?? {},
                 ...(this.options.relayOnly ? { relayOnly: true } : {}),
             }, "lobby");
-            return this.makeLobby(sig, welcome, state);
+            return this.makeLobby(sig, welcome, state, undefined, h.rateLimit);
         }
         catch (e) {
             sig.close();
@@ -280,7 +283,10 @@ export class OneLobby extends Emitter {
         const { sig, welcome } = await this.connect(addr.url, this.socketFactory, opts.connectTimeoutMs ?? 5000);
         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 });
+            // a joiner's joinCode is what it joined with (normalized), so a HUD can show it on both sides
+            lobby.joinCode = joinedWith(addr);
+            return lobby;
         }
         catch (e) {
             sig.close();
@@ -293,7 +299,7 @@ export class OneLobby extends Emitter {
         try {
             const state = await sig.request({ t: "create", name: h.name, maxPlayers: h.maxPlayers, visibility: "unlisted", mode: this.options.mode, tickRate: this.options.tickRate,
                 lateJoin: h.lateJoin ?? true, meta: h.meta ?? {} }, "lobby");
-            return this.makeLobby(sig, welcome, state, { links: hooks.wrapLinks(this.linkFactory) });
+            return this.makeLobby(sig, welcome, state, { links: hooks.wrapLinks(this.linkFactory) }, h.rateLimit);
         }
         catch (e) {
             sig.close();
@@ -331,4 +337,15 @@ export class OneLobby extends Emitter {
         }
     }
 }
+/** The join code for an IPv4 address (a host name or IPv6 has none: its `host:port` instead). */
+function joinedWith(addr) {
+    if (addr.isIPv6)
+        return addr.display;
+    try {
+        return encodeJoinCode(addr.host, addr.port);
+    }
+    catch {
+        return addr.display;
+    }
+}
 //# sourceMappingURL=onelobby.js.map

package/dist/onelobby.js.map

@@ -1 +1 @@
-{"version":3,"file":"onelobby.js","sourceRoot":"","sources":["../src/onelobby.ts"],"names":[],"mappings":"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","sourcesContent":["import { systemClock, type Clock } from \"./clock.js\";\nimport { Emitter } from \"./emitter.js\";\nimport { normalizeCode } from \"./crockford.js\";\nimport { Lobby } from \"./lobby.js\";\nimport {\n  OneLobbyError,\n  PROTO_ID,\n  SignalingClient,\n  type LobbyState,\n  type LobbySummary,\n  type WelcomeMsg,\n} from \"./signaling.js\";\nimport {\n  defaultSocketFactory,\n  type LinkFactory,\n  type SocketFactory,\n} from \"./transport.js\";\nimport type { VoiceCodec, FrameSource, AudioSink } from \"./voice-types.js\";\nimport { WebAudioSink, WorkletMic, webCodecsOpus, webCodecsOpusAvailable } from \"./voice-browser.js\";\nimport { webRtcLinkFactory } from \"./webrtc.js\";\nimport { decodeJoinCode, looksLikeJoinCode } from \"./joincode.js\";\nimport { DEFAULT_DIRECT_PORT, parseDirectAddress } from \"./direct-address.js\";\n\nexport const LIB_NAME = \"onelobby\";\nexport const LIB_VERSION = \"0.1.0\";\n\n/** Where `rememberSeat` keeps the resume token: the subset of the Web Storage API it uses. */\nexport interface SeatStorage {\n  getItem(key: string): string | null;\n  setItem(key: string, value: string): void;\n  removeItem(key: string): void;\n}\n\n/** Seams for tests, adapters and non-browser runtimes. Every default is the browser implementation. */\nexport interface AdvancedOptions {\n  socketFactory?: SocketFactory;\n  linkFactory?: LinkFactory;\n  clock?: Clock;\n  /** Wall clock in unix ms, stamps chat lines. */\n  wallClock?: () => number;\n  /** Opus codec; defaults to WebCodecs when available. Provide a WASM-backed one elsewhere. */\n  voiceCodec?: VoiceCodec | null;\n  createMic?: (() => FrameSource) | null;\n  createSink?: (() => AudioSink) | null;\n  /** Storage for `rememberSeat`; defaults to `sessionStorage` when the page has one. null disables it. */\n  storage?: SeatStorage | null;\n}\n\nexport interface OneLobbyOptions {\n  gameId: string;\n  netVersion: string;\n  /** `ws://` / `wss://` URL of a onelobby-server. */\n  lobbyServer: string;\n  mode?: \"lockstep\" | \"raw\";\n  tickRate?: number;\n  /** Default: tickRate (once a second). */\n  hashEveryTicks?: number;\n  /** The player's name. Empty (the default): other players see \"Player N\", N being the seat number. */\n  displayName?: string;\n  relayOnly?: boolean;\n  /**\n   * Joiners give up on reaching the host after this many ms: `lobby.ready` rejects with code `ice_failed`, the kit\n   * emits `error`, and the lobby is left. Half the time goes to a relay-only retry when the server offers TURN.\n   * Default 15000; 0 waits forever.\n   */\n  readyTimeoutMs?: number;\n  /**\n   * Keep this tab's seat across a page reload (sessionStorage): `join(code)` and `resume()` take the seat back\n   * instead of joining as a new player. Cleared when the session ends. Default true where sessionStorage exists.\n   */\n  rememberSeat?: boolean;\n  /** Test and runtime seams (see AdvancedOptions). */\n  advanced?: AdvancedOptions;\n\n  /** @deprecated use `advanced.socketFactory` */\n  socketFactory?: SocketFactory;\n  /** @deprecated use `advanced.linkFactory` */\n  linkFactory?: LinkFactory;\n  /** @deprecated use `advanced.clock` */\n  clock?: Clock;\n  /** @deprecated use `advanced.wallClock` */\n  wallClock?: () => number;\n  /** @deprecated use `advanced.voiceCodec` */\n  voiceCodec?: VoiceCodec | null;\n  /** @deprecated use `advanced.createMic` */\n  createMic?: (() => FrameSource) | null;\n  /** @deprecated use `advanced.createSink` */\n  createSink?: (() => AudioSink) | null;\n}\n\nexport interface HostOptions {\n  name: string;\n  maxPlayers: number;\n  /**\n   * \"unlisted\" (default): anyone with the code or link can join, but the lobby is not in `list()`.\n   * \"public\": also listed. \"private\": the host approves each join.\n   */\n  visibility?: \"public\" | \"unlisted\" | \"private\";\n  lateJoin?: boolean;\n  meta?: Record<string, string>;\n}\n\nexport interface ListOptions {\n  meta?: Record<string, string>;\n  limit?: number;\n  cursor?: string;\n}\n\nexport interface JoinDirectOptions {\n  /** The host's password, if it set one; a wrong one fails with `bad_password`. */\n  password?: string;\n  /** Port for an address typed without one (default 47810, docs/direct-ip.md s.2). */\n  defaultPort?: number;\n  /** No answer on the host's TCP port within this long fails with `direct_unreachable` (default 5000). */\n  connectTimeoutMs?: number;\n}\n\n/** @internal How onelobby/direct makes a host lobby: its own socket and link factory, and direct mode. */\nexport interface DirectLobbyHooks {\n  socketFactory: SocketFactory;\n  /** Wraps the kit's own link factory (port pin, no ICE servers). */\n  wrapLinks: (inner: LinkFactory) => LinkFactory;\n}\n\nexport type OneLobbyEvents = { error: [Error] };\n\nexport const DEFAULT_READY_TIMEOUT_MS = 15_000;\n\nfunction hasMic(): boolean {\n  return typeof navigator !== \"undefined\" && !!navigator.mediaDevices?.getUserMedia && typeof AudioWorkletNode !== \"undefined\";\n}\n\nfunction browserStorage(): SeatStorage | null {\n  try {\n    const s = (globalThis as { sessionStorage?: SeatStorage }).sessionStorage;\n    return s ?? null;\n  } catch {\n    return null; // storage access can throw (sandboxed iframe, blocked cookies)\n  }\n}\n\ninterface Seat {\n  code: string;\n  token: string;\n  server: string;\n}\n\n/**\n * Lobbies alive in this page, by resume token. A remembered seat that is still in use here (two kits in one tab,\n * e.g. a local two-player demo) must not be taken over; after a reload this set starts empty.\n */\nconst liveSeats = new Set<Lobby>();\nfunction seatInUse(token: string): boolean {\n  for (const l of liveSeats) if (l.resumeToken === token) return true;\n  return false;\n}\n\n/** Entry point (DESIGN s.11.2). */\nexport class OneLobby extends Emitter<OneLobbyEvents> {\n  readonly options: Required<Pick<OneLobbyOptions, \"gameId\" | \"netVersion\" | \"lobbyServer\" | \"mode\" | \"tickRate\" | \"hashEveryTicks\" | \"displayName\" | \"relayOnly\" | \"readyTimeoutMs\">>;\n  private socketFactory: SocketFactory;\n  private linkFactory: LinkFactory;\n  private clock: Clock;\n  private wall: () => number;\n  private voiceCodec: VoiceCodec | null;\n  private createMic: (() => FrameSource) | null;\n  private createSink: (() => AudioSink) | null;\n  private storage: SeatStorage | null;\n\n  constructor(o: OneLobbyOptions) {\n    super();\n    const tickRate = o.tickRate ?? 20;\n    this.options = {\n      gameId: o.gameId,\n      netVersion: o.netVersion,\n      lobbyServer: o.lobbyServer,\n      mode: o.mode ?? \"lockstep\",\n      tickRate,\n      hashEveryTicks: o.hashEveryTicks ?? tickRate,\n      displayName: (o.displayName ?? \"\").trim(),\n      relayOnly: o.relayOnly ?? false,\n      readyTimeoutMs: o.readyTimeoutMs ?? DEFAULT_READY_TIMEOUT_MS,\n    };\n    const a = o.advanced ?? {};\n    const pick = <K extends keyof AdvancedOptions & keyof OneLobbyOptions>(k: K) => (a[k] !== undefined ? a[k] : o[k]);\n    this.socketFactory = pick(\"socketFactory\") ?? defaultSocketFactory;\n    this.linkFactory = pick(\"linkFactory\") ?? webRtcLinkFactory;\n    this.clock = pick(\"clock\") ?? systemClock;\n    this.wall = pick(\"wallClock\") ?? (() => Date.now());\n    const codec = pick(\"voiceCodec\");\n    this.voiceCodec = codec !== undefined ? codec : webCodecsOpusAvailable() ? webCodecsOpus : null;\n    const mic = pick(\"createMic\");\n    this.createMic = mic !== undefined ? mic : hasMic() ? () => new WorkletMic() : null;\n    const sink = pick(\"createSink\");\n    this.createSink = sink !== undefined ? sink : typeof AudioContext !== \"undefined\" ? () => new WebAudioSink() : null;\n    this.storage = o.rememberSeat === false ? null : a.storage !== undefined ? a.storage : browserStorage();\n  }\n\n  // ---- remembered seat -------------------------------------------------------------------------------------------\n\n  private get seatKey(): string {\n    return `onelobby.seat.${this.options.gameId}`;\n  }\n\n  private loadSeat(): Seat | null {\n    if (!this.storage) return null;\n    try {\n      const raw = this.storage.getItem(this.seatKey);\n      if (!raw) return null;\n      const s = JSON.parse(raw) as Partial<Seat>;\n      if (typeof s.code !== \"string\" || typeof s.token !== \"string\" || s.server !== this.options.lobbyServer) return null;\n      return s as Seat;\n    } catch {\n      return null;\n    }\n  }\n\n  private saveSeat(code: string, token: string): void {\n    if (!this.storage || !token) return;\n    try {\n      this.storage.setItem(this.seatKey, JSON.stringify({ code, token, server: this.options.lobbyServer } satisfies Seat));\n    } catch {\n      /* quota or blocked storage: the seat just is not remembered */\n    }\n  }\n\n  private clearSeat(code?: string): void {\n    if (!this.storage) return;\n    try {\n      if (code !== undefined) {\n        const s = this.loadSeat();\n        if (s && s.code !== code) return;\n      }\n      this.storage.removeItem(this.seatKey);\n    } catch {\n      /* ignore */\n    }\n  }\n\n  /** The lobby code of the seat this tab can take back (rememberSeat), or null. */\n  get rememberedCode(): string | null {\n    return this.loadSeat()?.code ?? null;\n  }\n\n  /**\n   * Take back the seat remembered from before a page reload (host or joiner). Resolves null when there is none\n   * or the server no longer holds it (the seat is forgotten then).\n   */\n  async resume(): Promise<Lobby | null> {\n    const seat = this.loadSeat();\n    if (!seat || seatInUse(seat.token)) return null;\n    try {\n      return await this.rejoin(seat.token);\n    } catch (e) {\n      if (e instanceof OneLobbyError && e.code === \"invalid_token\") {\n        this.clearSeat();\n        return null;\n      }\n      throw e;\n    }\n  }\n\n  // ---- connecting ------------------------------------------------------------------------------------------------\n\n  private helloMsg(resumeToken?: string): Record<string, unknown> {\n    return {\n      t: \"hello\",\n      proto: PROTO_ID,\n      gameId: this.options.gameId,\n      netVersion: this.options.netVersion,\n      client: { lib: LIB_NAME, ver: LIB_VERSION, platform: typeof navigator !== \"undefined\" ? \"browser\" : \"node\" },\n      name: this.options.displayName.slice(0, 24),\n      ...(resumeToken ? { resumeToken } : {}),\n    };\n  }\n\n  private async connect(url = this.options.lobbyServer, factory = this.socketFactory, timeoutMs = 0): Promise<{ sig: SignalingClient; welcome: WelcomeMsg }> {\n    const sig = new SignalingClient(url, factory, this.clock);\n    if (timeoutMs > 0) {\n      let cancel = () => {};\n      const timeout = new Promise<never>((_, reject) => {\n        cancel = this.clock.setTimeout(() => reject(new OneLobbyError(\"direct_unreachable\", `no answer from ${url} within ${timeoutMs} ms`)), timeoutMs);\n      });\n      try {\n        await Promise.race([sig.connect(), timeout]);\n      } catch (e) {\n        sig.close();\n        if (e instanceof OneLobbyError && e.code === \"connect_failed\") throw new OneLobbyError(\"direct_unreachable\", `no answer from ${url}`);\n        throw e;\n      } finally {\n        cancel();\n      }\n    } else await sig.connect();\n    try {\n      const welcome = await sig.request<WelcomeMsg & { t: string }>(this.helloMsg(), \"welcome\");\n      return { sig, welcome };\n    } catch (e) {\n      sig.close();\n      throw e;\n    }\n  }\n\n  private makeLobby(sig: SignalingClient, welcome: WelcomeMsg, state: LobbyState, direct?: { links: LinkFactory }): Lobby {\n    const lobby = new Lobby({\n      signaling: sig,\n      state,\n      ice: welcome.ice ?? [],\n      links: direct?.links ?? this.linkFactory,\n      direct: !!direct,\n      clock: this.clock,\n      wall: this.wall,\n      hashEveryTicks: this.options.hashEveryTicks,\n      relayOnly: state.relayOnly ?? this.options.relayOnly,\n      displayName: this.options.displayName,\n      voice: { codec: this.voiceCodec, createSource: this.createMic, createSink: this.createSink },\n      readyTimeoutMs: this.options.readyTimeoutMs,\n    });\n    lobby.errorSink = (e) => this.emit(\"error\", e);\n    if (this.storage && !direct) {\n      liveSeats.add(lobby);\n      this.saveSeat(lobby.code, lobby.resumeToken);\n      lobby.seatSink = (token) => this.saveSeat(lobby.code, token);\n      lobby.on(\"sessionEnded\", () => {\n        liveSeats.delete(lobby);\n        this.clearSeat(lobby.code);\n      });\n    }\n    return lobby;\n  }\n\n  async host(h: HostOptions): Promise<Lobby> {\n    const { sig, welcome } = await this.connect();\n    try {\n      const state = await sig.request<LobbyState>(\n        {\n          t: \"create\",\n          name: h.name,\n          maxPlayers: h.maxPlayers,\n          visibility: h.visibility ?? \"unlisted\",\n          mode: this.options.mode,\n          tickRate: this.options.tickRate,\n          lateJoin: h.lateJoin ?? true,\n          meta: h.meta ?? {},\n          ...(this.options.relayOnly ? { relayOnly: true } : {}),\n        },\n        \"lobby\",\n      );\n      return this.makeLobby(sig, welcome, state);\n    } catch (e) {\n      sig.close();\n      throw e;\n    }\n  }\n\n  async join(code: string): Promise<Lobby> {\n    const norm = normalizeCode(code);\n    if (!norm) throw new OneLobbyError(\"bad_code\", `\"${code}\" is not a valid join code`);\n    const seat = this.loadSeat();\n    if (seat && seat.code === norm && !seatInUse(seat.token)) {\n      // Same tab, same lobby (a page reload): take the old seat back instead of joining as a new player.\n      try {\n        return await this.rejoin(seat.token);\n      } catch (e) {\n        this.clearSeat();\n        if (!(e instanceof OneLobbyError && e.code === \"invalid_token\")) throw e;\n      }\n    }\n    const { sig, welcome } = await this.connect();\n    try {\n      const state = await sig.request<LobbyState>({ t: \"join\", code: norm }, \"lobby\");\n      return this.makeLobby(sig, welcome, state);\n    } catch (e) {\n      sig.close();\n      throw e;\n    }\n  }\n\n  /**\n   * Join a direct-IP host (docs/direct-ip.md): a join code from the host's screen (`6B01-RGFE-P2B`, any case, spaces\n   * or hyphens) or, advanced, an address (`ip`, `ip:port`, `[v6]:port`). No lobby server is involved: the code is\n   * the host's address. A mistyped code fails at once with `bad_code`; nobody listening is `direct_unreachable`.\n   * The address is also given to ICE as the host's UDP candidate. When the host leaves, `sessionEnded(\"host_left\")`.\n   */\n  async joinDirect(codeOrAddress: string, opts: JoinDirectOptions = {}): Promise<Lobby> {\n    let input = codeOrAddress.trim();\n    if (looksLikeJoinCode(input)) {\n      const d = decodeJoinCode(input);\n      if (\"error\" in d)\n        throw new OneLobbyError(d.error, d.error === \"unknown_version\" ? `\"${input}\" is a join code from a newer version of the game` : `\"${input}\" is not a valid join code: check for a typo`);\n      input = `${d.ip}:${d.port}`;\n    }\n    const addr = parseDirectAddress(input, opts.defaultPort ?? DEFAULT_DIRECT_PORT);\n    if (!addr) throw new OneLobbyError(\"bad_address\", `\"${codeOrAddress}\" is not a join code or an address (try 6B01-RGFE-P2B or 192.168.1.20:47810)`);\n    const inner = this.linkFactory;\n    const links: LinkFactory = { create: (o) => inner.create({ ...o, iceServers: [], extraRemoteCandidates: [addr.candidate] }) };\n    const { sig, welcome } = await this.connect(addr.url, this.socketFactory, opts.connectTimeoutMs ?? 5000);\n    try {\n      const state = await sig.request<LobbyState>({ t: \"join\", ...(opts.password ? { password: opts.password } : {}) }, \"lobby\");\n      return this.makeLobby(sig, welcome, state, { links });\n    } catch (e) {\n      sig.close();\n      throw e;\n    }\n  }\n\n  /** @internal onelobby/direct's host: create the one lobby on the embedded hub, in direct mode. */\n  async hostDirectWith(h: HostOptions, hooks: DirectLobbyHooks): Promise<Lobby> {\n    const { sig, welcome } = await this.connect(\"onelobby-direct://host/\", hooks.socketFactory);\n    try {\n      const state = await sig.request<LobbyState>(\n        { t: \"create\", name: h.name, maxPlayers: h.maxPlayers, visibility: \"unlisted\", mode: this.options.mode, tickRate: this.options.tickRate,\n          lateJoin: h.lateJoin ?? true, meta: h.meta ?? {} },\n        \"lobby\",\n      );\n      return this.makeLobby(sig, welcome, state, { links: hooks.wrapLinks(this.linkFactory) });\n    } catch (e) {\n      sig.close();\n      throw e;\n    }\n  }\n\n  async rejoin(resumeToken: string): Promise<Lobby> {\n    const sig = new SignalingClient(this.options.lobbyServer, this.socketFactory, this.clock);\n    await sig.connect();\n    try {\n      // The server answers hello(resumeToken) with welcome then the full lobby state; listen for both up front.\n      const lobbyP = sig.expect<LobbyState>(\"lobby\");\n      const welcomeP = sig.request<WelcomeMsg & { t: string }>(this.helloMsg(resumeToken), \"welcome\");\n      lobbyP.catch(() => {}); // settled below or by close()\n      const welcome = await welcomeP;\n      // spec: an unknown or expired token is ignored -> plain welcome (no peerId), and no lobby follows\n      if (welcome.peerId === undefined) throw new OneLobbyError(\"invalid_token\", \"resume token unknown or expired\");\n      const state = await lobbyP;\n      return this.makeLobby(sig, welcome, state);\n    } catch (e) {\n      sig.close();\n      throw e;\n    }\n  }\n\n  async list(opts: ListOptions = {}): Promise<LobbySummary[]> {\n    const { sig } = await this.connect();\n    try {\n      const res = await sig.request<{ t: string; items: LobbySummary[] }>(\n        { t: \"list\", visibility: \"public\", meta: opts.meta ?? {}, limit: Math.min(100, opts.limit ?? 50), ...(opts.cursor ? { cursor: opts.cursor } : {}) },\n        \"lobbies\",\n      );\n      return res.items ?? [];\n    } finally {\n      sig.close();\n    }\n  }\n}\n"]}
+{"version":3,"file":"onelobby.js","sourceRoot":"","sources":["../src/onelobby.ts"],"names":[],"mappings":"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","sourcesContent":["import { systemClock, type Clock } from \"./clock.js\";\nimport { Emitter } from \"./emitter.js\";\nimport { normalizeCode } from \"./crockford.js\";\nimport { Lobby, type RateLimit } from \"./lobby.js\";\nimport {\n  OneLobbyError,\n  PROTO_ID,\n  SignalingClient,\n  type LobbyState,\n  type LobbySummary,\n  type WelcomeMsg,\n} from \"./signaling.js\";\nimport {\n  defaultSocketFactory,\n  type LinkFactory,\n  type SocketFactory,\n} from \"./transport.js\";\nimport type { VoiceCodec, FrameSource, AudioSink } from \"./voice-types.js\";\nimport { WebAudioSink, WorkletMic, webCodecsOpus, webCodecsOpusAvailable } from \"./voice-browser.js\";\nimport { webRtcLinkFactory } from \"./webrtc.js\";\nimport { decodeJoinCode, encodeJoinCode, looksLikeJoinCode } from \"./joincode.js\";\nimport { DEFAULT_DIRECT_PORT, parseDirectAddress } from \"./direct-address.js\";\n\nexport const LIB_NAME = \"onelobby\";\nexport const LIB_VERSION = \"0.2.1\";\n\n/** Where `rememberSeat` keeps the resume token: the subset of the Web Storage API it uses. */\nexport interface SeatStorage {\n  getItem(key: string): string | null;\n  setItem(key: string, value: string): void;\n  removeItem(key: string): void;\n}\n\n/** Seams for tests, adapters and non-browser runtimes. Every default is the browser implementation. */\nexport interface AdvancedOptions {\n  socketFactory?: SocketFactory;\n  linkFactory?: LinkFactory;\n  clock?: Clock;\n  /** Wall clock in unix ms, stamps chat lines. */\n  wallClock?: () => number;\n  /** Opus codec; defaults to WebCodecs when available. Provide a WASM-backed one elsewhere. */\n  voiceCodec?: VoiceCodec | null;\n  createMic?: (() => FrameSource) | null;\n  createSink?: (() => AudioSink) | null;\n  /** Storage for `rememberSeat`; defaults to `sessionStorage` when the page has one. null disables it. */\n  storage?: SeatStorage | null;\n}\n\nexport interface OneLobbyOptions {\n  gameId: string;\n  netVersion: string;\n  /** `ws://` / `wss://` URL of a onelobby-server. */\n  lobbyServer: string;\n  mode?: \"lockstep\" | \"raw\";\n  tickRate?: number;\n  /** Default: tickRate (once a second). */\n  hashEveryTicks?: number;\n  /** The player's name. Empty (the default): other players see \"Player N\", N being the seat number. */\n  displayName?: string;\n  relayOnly?: boolean;\n  /**\n   * Joiners give up on reaching the host after this many ms: `lobby.ready` rejects with code `ice_failed`, the kit\n   * emits `error`, and the lobby is left. Half the time goes to a relay-only retry when the server offers TURN.\n   * Default 15000; 0 waits forever.\n   */\n  readyTimeoutMs?: number;\n  /**\n   * Treat a peer as gone after this many ms of silence. Joiners ping the host every 2 s and the host answers, so the\n   * host drops a silent joiner (`peerLeft`, \"timeout\") and a joiner handles a silent host as lost (a direct lobby\n   * ends with \"host_left\"). Default 0 (off): a silently dead peer then surfaces when its link or signaling socket\n   * times out, within about 30 s. Values under 6000 are raised to 6000.\n   */\n  peerTimeoutMs?: number;\n  /**\n   * Keep this tab's seat across a page reload (sessionStorage): `join(code)` and `resume()` take the seat back\n   * instead of joining as a new player. Cleared when the session ends. Default true where sessionStorage exists.\n   */\n  rememberSeat?: boolean;\n  /** Test and runtime seams (see AdvancedOptions). */\n  advanced?: AdvancedOptions;\n\n  /** @deprecated use `advanced.socketFactory` */\n  socketFactory?: SocketFactory;\n  /** @deprecated use `advanced.linkFactory` */\n  linkFactory?: LinkFactory;\n  /** @deprecated use `advanced.clock` */\n  clock?: Clock;\n  /** @deprecated use `advanced.wallClock` */\n  wallClock?: () => number;\n  /** @deprecated use `advanced.voiceCodec` */\n  voiceCodec?: VoiceCodec | null;\n  /** @deprecated use `advanced.createMic` */\n  createMic?: (() => FrameSource) | null;\n  /** @deprecated use `advanced.createSink` */\n  createSink?: (() => AudioSink) | null;\n}\n\nexport interface HostOptions {\n  name: string;\n  maxPlayers: number;\n  /**\n   * \"unlisted\" (default): anyone with the code or link can join, but the lobby is not in `list()`.\n   * \"public\": also listed. \"private\": the host approves each join.\n   */\n  visibility?: \"public\" | \"unlisted\" | \"private\";\n  lateJoin?: boolean;\n  meta?: Record<string, string>;\n  /** Per-joiner cap on incoming raw messages, e.g. `{ messages: 60, perMs: 1000 }`; the excess is dropped before `message` fires or is relayed. */\n  rateLimit?: RateLimit;\n}\n\nexport interface ListOptions {\n  meta?: Record<string, string>;\n  limit?: number;\n  cursor?: string;\n}\n\nexport interface JoinDirectOptions {\n  /** The host's password, if it set one; a wrong one fails with `bad_password`. */\n  password?: string;\n  /** Port for an address typed without one (default 47810, docs/direct-ip.md s.2). */\n  defaultPort?: number;\n  /** No answer on the host's TCP port within this long fails with `direct_unreachable` (default 5000). */\n  connectTimeoutMs?: number;\n}\n\n/** @internal How onelobby/direct makes a host lobby: its own socket and link factory, and direct mode. */\nexport interface DirectLobbyHooks {\n  socketFactory: SocketFactory;\n  /** Wraps the kit's own link factory (port pin, no ICE servers). */\n  wrapLinks: (inner: LinkFactory) => LinkFactory;\n}\n\nexport type OneLobbyEvents = { error: [Error] };\n\nexport const DEFAULT_READY_TIMEOUT_MS = 15_000;\n\nfunction hasMic(): boolean {\n  return typeof navigator !== \"undefined\" && !!navigator.mediaDevices?.getUserMedia && typeof AudioWorkletNode !== \"undefined\";\n}\n\nfunction browserStorage(): SeatStorage | null {\n  try {\n    const s = (globalThis as { sessionStorage?: SeatStorage }).sessionStorage;\n    return s ?? null;\n  } catch {\n    return null; // storage access can throw (sandboxed iframe, blocked cookies)\n  }\n}\n\ninterface Seat {\n  code: string;\n  token: string;\n  server: string;\n}\n\n/**\n * Lobbies alive in this page, by resume token. A remembered seat that is still in use here (two kits in one tab,\n * e.g. a local two-player demo) must not be taken over; after a reload this set starts empty.\n */\nconst liveSeats = new Set<Lobby>();\nfunction seatInUse(token: string): boolean {\n  for (const l of liveSeats) if (l.resumeToken === token) return true;\n  return false;\n}\n\n/** Entry point (DESIGN s.11.2). */\nexport class OneLobby extends Emitter<OneLobbyEvents> {\n  readonly options: Required<Pick<OneLobbyOptions, \"gameId\" | \"netVersion\" | \"lobbyServer\" | \"mode\" | \"tickRate\" | \"hashEveryTicks\" | \"displayName\" | \"relayOnly\" | \"readyTimeoutMs\" | \"peerTimeoutMs\">>;\n  private socketFactory: SocketFactory;\n  private linkFactory: LinkFactory;\n  private clock: Clock;\n  private wall: () => number;\n  private voiceCodec: VoiceCodec | null;\n  private createMic: (() => FrameSource) | null;\n  private createSink: (() => AudioSink) | null;\n  private storage: SeatStorage | null;\n\n  constructor(o: OneLobbyOptions) {\n    super();\n    const tickRate = o.tickRate ?? 20;\n    this.options = {\n      gameId: o.gameId,\n      netVersion: o.netVersion,\n      lobbyServer: o.lobbyServer,\n      mode: o.mode ?? \"lockstep\",\n      tickRate,\n      hashEveryTicks: o.hashEveryTicks ?? tickRate,\n      displayName: (o.displayName ?? \"\").trim(),\n      relayOnly: o.relayOnly ?? false,\n      readyTimeoutMs: o.readyTimeoutMs ?? DEFAULT_READY_TIMEOUT_MS,\n      peerTimeoutMs: o.peerTimeoutMs ?? 0,\n    };\n    const a = o.advanced ?? {};\n    const pick = <K extends keyof AdvancedOptions & keyof OneLobbyOptions>(k: K) => (a[k] !== undefined ? a[k] : o[k]);\n    this.socketFactory = pick(\"socketFactory\") ?? defaultSocketFactory;\n    this.linkFactory = pick(\"linkFactory\") ?? webRtcLinkFactory;\n    this.clock = pick(\"clock\") ?? systemClock;\n    this.wall = pick(\"wallClock\") ?? (() => Date.now());\n    const codec = pick(\"voiceCodec\");\n    this.voiceCodec = codec !== undefined ? codec : webCodecsOpusAvailable() ? webCodecsOpus : null;\n    const mic = pick(\"createMic\");\n    this.createMic = mic !== undefined ? mic : hasMic() ? () => new WorkletMic() : null;\n    const sink = pick(\"createSink\");\n    this.createSink = sink !== undefined ? sink : typeof AudioContext !== \"undefined\" ? () => new WebAudioSink() : null;\n    this.storage = o.rememberSeat === false ? null : a.storage !== undefined ? a.storage : browserStorage();\n  }\n\n  // ---- remembered seat -------------------------------------------------------------------------------------------\n\n  private get seatKey(): string {\n    return `onelobby.seat.${this.options.gameId}`;\n  }\n\n  private loadSeat(): Seat | null {\n    if (!this.storage) return null;\n    try {\n      const raw = this.storage.getItem(this.seatKey);\n      if (!raw) return null;\n      const s = JSON.parse(raw) as Partial<Seat>;\n      if (typeof s.code !== \"string\" || typeof s.token !== \"string\" || s.server !== this.options.lobbyServer) return null;\n      return s as Seat;\n    } catch {\n      return null;\n    }\n  }\n\n  private saveSeat(code: string, token: string): void {\n    if (!this.storage || !token) return;\n    try {\n      this.storage.setItem(this.seatKey, JSON.stringify({ code, token, server: this.options.lobbyServer } satisfies Seat));\n    } catch {\n      /* quota or blocked storage: the seat just is not remembered */\n    }\n  }\n\n  private clearSeat(code?: string): void {\n    if (!this.storage) return;\n    try {\n      if (code !== undefined) {\n        const s = this.loadSeat();\n        if (s && s.code !== code) return;\n      }\n      this.storage.removeItem(this.seatKey);\n    } catch {\n      /* ignore */\n    }\n  }\n\n  /** The lobby code of the seat this tab can take back (rememberSeat), or null. */\n  get rememberedCode(): string | null {\n    return this.loadSeat()?.code ?? null;\n  }\n\n  /**\n   * Take back the seat remembered from before a page reload (host or joiner). Resolves null when there is none\n   * or the server no longer holds it (the seat is forgotten then).\n   */\n  async resume(): Promise<Lobby | null> {\n    const seat = this.loadSeat();\n    if (!seat || seatInUse(seat.token)) return null;\n    try {\n      return await this.rejoin(seat.token);\n    } catch (e) {\n      if (e instanceof OneLobbyError && e.code === \"invalid_token\") {\n        this.clearSeat();\n        return null;\n      }\n      throw e;\n    }\n  }\n\n  // ---- connecting ------------------------------------------------------------------------------------------------\n\n  private helloMsg(resumeToken?: string): Record<string, unknown> {\n    return {\n      t: \"hello\",\n      proto: PROTO_ID,\n      gameId: this.options.gameId,\n      netVersion: this.options.netVersion,\n      client: { lib: LIB_NAME, ver: LIB_VERSION, platform: typeof navigator !== \"undefined\" ? \"browser\" : \"node\" },\n      name: this.options.displayName.slice(0, 24),\n      ...(resumeToken ? { resumeToken } : {}),\n    };\n  }\n\n  private async connect(url = this.options.lobbyServer, factory = this.socketFactory, timeoutMs = 0): Promise<{ sig: SignalingClient; welcome: WelcomeMsg }> {\n    const sig = new SignalingClient(url, factory, this.clock);\n    if (timeoutMs > 0) {\n      let cancel = () => {};\n      const timeout = new Promise<never>((_, reject) => {\n        cancel = this.clock.setTimeout(() => reject(new OneLobbyError(\"direct_unreachable\", `no answer from ${url} within ${timeoutMs} ms`)), timeoutMs);\n      });\n      try {\n        await Promise.race([sig.connect(), timeout]);\n      } catch (e) {\n        sig.close();\n        if (e instanceof OneLobbyError && e.code === \"connect_failed\") throw new OneLobbyError(\"direct_unreachable\", `no answer from ${url}`);\n        throw e;\n      } finally {\n        cancel();\n      }\n    } else await sig.connect();\n    try {\n      const welcome = await sig.request<WelcomeMsg & { t: string }>(this.helloMsg(), \"welcome\");\n      return { sig, welcome };\n    } catch (e) {\n      sig.close();\n      throw e;\n    }\n  }\n\n  private makeLobby(sig: SignalingClient, welcome: WelcomeMsg, state: LobbyState, direct?: { links: LinkFactory }, rateLimit?: RateLimit): Lobby {\n    const lobby = new Lobby({\n      signaling: sig,\n      state,\n      ice: welcome.ice ?? [],\n      links: direct?.links ?? this.linkFactory,\n      direct: !!direct,\n      clock: this.clock,\n      wall: this.wall,\n      hashEveryTicks: this.options.hashEveryTicks,\n      relayOnly: state.relayOnly ?? this.options.relayOnly,\n      displayName: this.options.displayName,\n      voice: { codec: this.voiceCodec, createSource: this.createMic, createSink: this.createSink },\n      readyTimeoutMs: this.options.readyTimeoutMs,\n      peerTimeoutMs: this.options.peerTimeoutMs,\n      rateLimit,\n    });\n    lobby.errorSink = (e) => this.emit(\"error\", e);\n    if (this.storage && !direct) {\n      liveSeats.add(lobby);\n      this.saveSeat(lobby.code, lobby.resumeToken);\n      lobby.seatSink = (token) => this.saveSeat(lobby.code, token);\n      lobby.on(\"sessionEnded\", () => {\n        liveSeats.delete(lobby);\n        this.clearSeat(lobby.code);\n      });\n    }\n    return lobby;\n  }\n\n  async host(h: HostOptions): Promise<Lobby> {\n    const { sig, welcome } = await this.connect();\n    try {\n      const state = await sig.request<LobbyState>(\n        {\n          t: \"create\",\n          name: h.name,\n          maxPlayers: h.maxPlayers,\n          visibility: h.visibility ?? \"unlisted\",\n          mode: this.options.mode,\n          tickRate: this.options.tickRate,\n          lateJoin: h.lateJoin ?? true,\n          meta: h.meta ?? {},\n          ...(this.options.relayOnly ? { relayOnly: true } : {}),\n        },\n        \"lobby\",\n      );\n      return this.makeLobby(sig, welcome, state, undefined, h.rateLimit);\n    } catch (e) {\n      sig.close();\n      throw e;\n    }\n  }\n\n  async join(code: string): Promise<Lobby> {\n    const norm = normalizeCode(code);\n    if (!norm) throw new OneLobbyError(\"bad_code\", `\"${code}\" is not a valid join code`);\n    const seat = this.loadSeat();\n    if (seat && seat.code === norm && !seatInUse(seat.token)) {\n      // Same tab, same lobby (a page reload): take the old seat back instead of joining as a new player.\n      try {\n        return await this.rejoin(seat.token);\n      } catch (e) {\n        this.clearSeat();\n        if (!(e instanceof OneLobbyError && e.code === \"invalid_token\")) throw e;\n      }\n    }\n    const { sig, welcome } = await this.connect();\n    try {\n      const state = await sig.request<LobbyState>({ t: \"join\", code: norm }, \"lobby\");\n      return this.makeLobby(sig, welcome, state);\n    } catch (e) {\n      sig.close();\n      throw e;\n    }\n  }\n\n  /**\n   * Join a direct-IP host (docs/direct-ip.md): a join code from the host's screen (`6B01-RGFE-P2B`, any case, spaces\n   * or hyphens) or, advanced, an address (`ip`, `ip:port`, `[v6]:port`). No lobby server is involved: the code is\n   * the host's address. A mistyped code fails at once with `bad_code`; nobody listening is `direct_unreachable`.\n   * The address is also given to ICE as the host's UDP candidate. When the host leaves, `sessionEnded(\"host_left\")`.\n   */\n  async joinDirect(codeOrAddress: string, opts: JoinDirectOptions = {}): Promise<Lobby> {\n    let input = codeOrAddress.trim();\n    if (looksLikeJoinCode(input)) {\n      const d = decodeJoinCode(input);\n      if (\"error\" in d)\n        throw new OneLobbyError(d.error, d.error === \"unknown_version\" ? `\"${input}\" is a join code from a newer version of the game` : `\"${input}\" is not a valid join code: check for a typo`);\n      input = `${d.ip}:${d.port}`;\n    }\n    const addr = parseDirectAddress(input, opts.defaultPort ?? DEFAULT_DIRECT_PORT);\n    if (!addr) throw new OneLobbyError(\"bad_address\", `\"${codeOrAddress}\" is not a join code or an address (try 6B01-RGFE-P2B or 192.168.1.20:47810)`);\n    const inner = this.linkFactory;\n    const links: LinkFactory = { create: (o) => inner.create({ ...o, iceServers: [], extraRemoteCandidates: [addr.candidate] }) };\n    const { sig, welcome } = await this.connect(addr.url, this.socketFactory, opts.connectTimeoutMs ?? 5000);\n    try {\n      const state = await sig.request<LobbyState>({ t: \"join\", ...(opts.password ? { password: opts.password } : {}) }, \"lobby\");\n      const lobby = this.makeLobby(sig, welcome, state, { links });\n      // a joiner's joinCode is what it joined with (normalized), so a HUD can show it on both sides\n      lobby.joinCode = joinedWith(addr);\n      return lobby;\n    } catch (e) {\n      sig.close();\n      throw e;\n    }\n  }\n\n  /** @internal onelobby/direct's host: create the one lobby on the embedded hub, in direct mode. */\n  async hostDirectWith(h: HostOptions, hooks: DirectLobbyHooks): Promise<Lobby> {\n    const { sig, welcome } = await this.connect(\"onelobby-direct://host/\", hooks.socketFactory);\n    try {\n      const state = await sig.request<LobbyState>(\n        { t: \"create\", name: h.name, maxPlayers: h.maxPlayers, visibility: \"unlisted\", mode: this.options.mode, tickRate: this.options.tickRate,\n          lateJoin: h.lateJoin ?? true, meta: h.meta ?? {} },\n        \"lobby\",\n      );\n      return this.makeLobby(sig, welcome, state, { links: hooks.wrapLinks(this.linkFactory) }, h.rateLimit);\n    } catch (e) {\n      sig.close();\n      throw e;\n    }\n  }\n\n  async rejoin(resumeToken: string): Promise<Lobby> {\n    const sig = new SignalingClient(this.options.lobbyServer, this.socketFactory, this.clock);\n    await sig.connect();\n    try {\n      // The server answers hello(resumeToken) with welcome then the full lobby state; listen for both up front.\n      const lobbyP = sig.expect<LobbyState>(\"lobby\");\n      const welcomeP = sig.request<WelcomeMsg & { t: string }>(this.helloMsg(resumeToken), \"welcome\");\n      lobbyP.catch(() => {}); // settled below or by close()\n      const welcome = await welcomeP;\n      // spec: an unknown or expired token is ignored -> plain welcome (no peerId), and no lobby follows\n      if (welcome.peerId === undefined) throw new OneLobbyError(\"invalid_token\", \"resume token unknown or expired\");\n      const state = await lobbyP;\n      return this.makeLobby(sig, welcome, state);\n    } catch (e) {\n      sig.close();\n      throw e;\n    }\n  }\n\n  async list(opts: ListOptions = {}): Promise<LobbySummary[]> {\n    const { sig } = await this.connect();\n    try {\n      const res = await sig.request<{ t: string; items: LobbySummary[] }>(\n        { t: \"list\", visibility: \"public\", meta: opts.meta ?? {}, limit: Math.min(100, opts.limit ?? 50), ...(opts.cursor ? { cursor: opts.cursor } : {}) },\n        \"lobbies\",\n      );\n      return res.items ?? [];\n    } finally {\n      sig.close();\n    }\n  }\n}\n\n/** The join code for an IPv4 address (a host name or IPv6 has none: its `host:port` instead). */\nfunction joinedWith(addr: { host: string; port: number; isIPv6: boolean; display: string }): string {\n  if (addr.isIPv6) return addr.display;\n  try {\n    return encodeJoinCode(addr.host, addr.port);\n  } catch {\n    return addr.display;\n  }\n}\n"]}

package/dist/socket.d.ts

@@ -0,0 +1,69 @@
+import type { Lobby } from "./lobby.js";
+/**
+ * A WebSocket-shaped view of one peer link, so code written against `WebSocket` runs on a lobby unchanged:
+ * `lobby.asWebSocket()` on a joiner (the link to the host), `lobby.onConnection(conn => ...)` on the host (one per
+ * joiner). Not a real WebSocket: no URL, no subprotocols, no `addEventListener`; `bufferedAmount` is always 0.
+ */
+export interface LobbySocket {
+    /** The peer at the other end (the host for a joiner's socket, the joiner for a host's connection). */
+    readonly peerId: number;
+    /** 0 CONNECTING (joiner, before `lobby.ready`), 1 OPEN, 3 CLOSED (there is no CLOSING). */
+    readonly readyState: 0 | 1 | 3;
+    readonly bufferedAmount: 0;
+    /** A string is sent as UTF-8; bytes as they are. Ignored unless OPEN. */
+    send(data: string | Uint8Array): void;
+    /**
+     * Closes this socket locally and fires `onclose` with `code` (default 1000). On a joiner it also leaves the lobby.
+     * On the host it only stops this connection's events: to end the player's connection too (its socket gets your code
+     * and reason), call `lobby.disconnect(conn.peerId, code, reason)`; `lobby.kick()` also bans it from the lobby.
+     */
+    close(code?: number, reason?: string): void;
+    /**
+     * Fires once, on a later task than the one that created the socket (like a real WebSocket). Assigned after it already
+     * fired (the socket came out of an `await` chain)? It runs for the new handler once; `readyState === 1` also tells.
+     */
+    onopen: ((ev: {
+        type: "open";
+    }) => void) | null;
+    /** `data` is a string (UTF-8 decoded), or the bytes with `{ binary: true }`. */
+    onmessage: ((ev: {
+        type: "message";
+        data: string | Uint8Array;
+    }) => void) | null;
+    /** `reason` is the lobby's reason ("host_left", "timeout", "kicked", "disconnected", ...) unless `close()` or the host gave one. */
+    onclose: ((ev: {
+        type: "close";
+        code: number;
+        reason: string;
+        wasClean: boolean;
+    }) => void) | null;
+    /** Never called (errors surface as `onclose` with code 1006); present so WebSocket code that assigns it works. */
+    onerror: ((ev: {
+        type: "error";
+    }) => void) | null;
+}
+export interface LobbySocketOptions {
+    /** Deliver `onmessage` data as bytes (Uint8Array) instead of UTF-8 text. Default false. */
+    binary?: boolean;
+    /** Channel for `send` (default "reliable"). "fast" is unordered and may drop, like UDP. */
+    channel?: "reliable" | "fast";
+}
+/**
+ * Close codes: 1000 a normal leave, `close()` or the host's `disconnect()`, 1001 the other end went away (`host_left`,
+ * the host closing, a player who left), 4000 kicked, 1006 anything abnormal (`timeout`, `ice_failed`, `server_lost`,
+ * ...). A code and reason the host passed to `kick()` / `disconnect()` win over these.
+ */
+export declare function closeCodeFor(reason: string): number;
+/**
+ * Joiner: the link to the host as a socket. OPEN once `lobby.ready` resolves (at once if it already has), with
+ * `onopen` on a later task;
+ * closed when the session ends, or with 1001 "host_changed" when a server-backed lobby migrates to a new host.
+ */
+export declare function joinerSocket(lobby: Lobby, o?: LobbySocketOptions): LobbySocket;
+/**
+ * Host: calls `handler(conn)` once per joiner, as soon as its link is ready (and right away for joiners already
+ * connected). A message from a joiner the handler has not seen yet creates its connection first, so nothing is lost.
+ * `conn.onclose` fires when that peer leaves (code from closeCodeFor) or the host's session ends. Returns a function
+ * that stops new connections (existing ones keep working).
+ */
+export declare function hostConnections(lobby: Lobby, handler: (conn: LobbySocket) => void, o?: LobbySocketOptions): () => void;

package/dist/socket.js

@@ -0,0 +1,166 @@
+/**
+ * Close codes: 1000 a normal leave, `close()` or the host's `disconnect()`, 1001 the other end went away (`host_left`,
+ * the host closing, a player who left), 4000 kicked, 1006 anything abnormal (`timeout`, `ice_failed`, `server_lost`,
+ * ...). A code and reason the host passed to `kick()` / `disconnect()` win over these.
+ */
+export function closeCodeFor(reason) {
+    if (reason === "left" || reason === "disconnected")
+        return 1000;
+    if (reason === "host_left" || reason === "closed")
+        return 1001;
+    if (reason === "kicked")
+        return 4000;
+    return 1006;
+}
+/** A later task, like a real WebSocket's events: setImmediate in Node, setTimeout(0) in browsers. */
+const nextTask = globalThis.setImmediate ?? ((f) => void setTimeout(f, 0));
+const enc = new TextEncoder();
+const dec = new TextDecoder();
+class PeerSocket {
+    peerId;
+    out;
+    binary;
+    onLocalClose;
+    readyState = 0;
+    bufferedAmount = 0;
+    openHandler = null;
+    /** OPEN, but `onopen` has not run yet for any handler. */
+    openPending = false;
+    onmessage = null;
+    onclose = null;
+    onerror = null;
+    /** Unsubscribes from the lobby; set by the factory. */
+    detach = () => { };
+    constructor(peerId, out, binary, onLocalClose) {
+        this.peerId = peerId;
+        this.out = out;
+        this.binary = binary;
+        this.onLocalClose = onLocalClose;
+    }
+    send(data) {
+        if (this.readyState !== 1)
+            return;
+        this.out(typeof data === "string" ? enc.encode(data) : data);
+    }
+    close(code = 1000, reason = "left") {
+        if (this.readyState === 3)
+            return;
+        this.closed(code, reason);
+        this.onLocalClose();
+    }
+    get onopen() {
+        return this.openHandler;
+    }
+    set onopen(h) {
+        this.openHandler = h;
+        // assigned after the open event went by with no handler: deliver it once, still on a later task
+        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;
+        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) {
+        if (this.readyState === 1)
+            this.onmessage?.({ type: "message", data: this.binary ? bytes : dec.decode(bytes) });
+    }
+    /** @internal */
+    closed(code, reason) {
+        if (this.readyState === 3)
+            return;
+        this.readyState = 3;
+        this.detach();
+        this.onclose?.({ type: "close", code, reason, wasClean: code === 1000 || code === 1001 });
+    }
+}
+/**
+ * Joiner: the link to the host as a socket. OPEN once `lobby.ready` resolves (at once if it already has), with
+ * `onopen` on a later task;
+ * closed when the session ends, or with 1001 "host_changed" when a server-backed lobby migrates to a new host.
+ */
+export function joinerSocket(lobby, o = {}) {
+    if (lobby.isHost)
+        throw new Error("asWebSocket() is for joiners; the host uses lobby.onConnection()");
+    const channel = o.channel ?? "reliable";
+    const s = new PeerSocket(lobby.hostPeerId, (b) => lobby.send(lobby.hostPeerId, b, { channel }), !!o.binary, () => void lobby.leave());
+    const offs = [
+        lobby.on("message", (from, bytes) => {
+            if (from === lobby.hostPeerId)
+                s.deliver(bytes);
+        }),
+        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")),
+    ];
+    s.detach = () => offs.forEach((f) => f());
+    // Already connected (made after `await lobby.ready`): OPEN at once, so a send() right away goes out.
+    if (lobby.connectedPeers.includes(lobby.hostPeerId))
+        s.open(true);
+    else
+        lobby.ready.then(() => s.open(true), () => { });
+    return s;
+}
+/**
+ * Host: calls `handler(conn)` once per joiner, as soon as its link is ready (and right away for joiners already
+ * connected). A message from a joiner the handler has not seen yet creates its connection first, so nothing is lost.
+ * `conn.onclose` fires when that peer leaves (code from closeCodeFor) or the host's session ends. Returns a function
+ * that stops new connections (existing ones keep working).
+ */
+export function hostConnections(lobby, handler, o = {}) {
+    if (!lobby.isHost)
+        throw new Error("onConnection() is for the host; a joiner uses lobby.asWebSocket()");
+    const channel = o.channel ?? "reliable";
+    const conns = new Map();
+    let stopped = false;
+    const ensure = (peerId) => {
+        if (peerId === lobby.localPeerId)
+            return undefined;
+        let c = conns.get(peerId);
+        if (c || stopped)
+            return c;
+        c = new PeerSocket(peerId, (b) => lobby.send(peerId, b, { channel }), !!o.binary, () => { });
+        const conn = c;
+        conn.detach = () => {
+            if (conns.get(peerId) === conn)
+                conns.delete(peerId);
+        };
+        conns.set(peerId, conn);
+        conn.open();
+        handler(conn);
+        return conn;
+    };
+    const offs = [
+        lobby.on("peerReady", (p) => void ensure(p.peerId)),
+        lobby.on("message", (from, bytes) => ensure(from)?.deliver(bytes)),
+        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());
+        }),
+    ];
+    for (const id of lobby.connectedPeers)
+        ensure(id);
+    return () => {
+        stopped = true;
+    };
+}
+//# sourceMappingURL=socket.js.map

package/dist/socket.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"socket.js","sourceRoot":"","sources":["../src/socket.ts"],"names":[],"mappings":"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","sourcesContent":["import type { CloseInfo, Lobby, Peer } from \"./lobby.js\";\n\n/**\n * A WebSocket-shaped view of one peer link, so code written against `WebSocket` runs on a lobby unchanged:\n * `lobby.asWebSocket()` on a joiner (the link to the host), `lobby.onConnection(conn => ...)` on the host (one per\n * joiner). Not a real WebSocket: no URL, no subprotocols, no `addEventListener`; `bufferedAmount` is always 0.\n */\nexport interface LobbySocket {\n  /** The peer at the other end (the host for a joiner's socket, the joiner for a host's connection). */\n  readonly peerId: number;\n  /** 0 CONNECTING (joiner, before `lobby.ready`), 1 OPEN, 3 CLOSED (there is no CLOSING). */\n  readonly readyState: 0 | 1 | 3;\n  readonly bufferedAmount: 0;\n  /** A string is sent as UTF-8; bytes as they are. Ignored unless OPEN. */\n  send(data: string | Uint8Array): void;\n  /**\n   * Closes this socket locally and fires `onclose` with `code` (default 1000). On a joiner it also leaves the lobby.\n   * On the host it only stops this connection's events: to end the player's connection too (its socket gets your code\n   * and reason), call `lobby.disconnect(conn.peerId, code, reason)`; `lobby.kick()` also bans it from the lobby.\n   */\n  close(code?: number, reason?: string): void;\n  /**\n   * Fires once, on a later task than the one that created the socket (like a real WebSocket). Assigned after it already\n   * fired (the socket came out of an `await` chain)? It runs for the new handler once; `readyState === 1` also tells.\n   */\n  onopen: ((ev: { type: \"open\" }) => void) | null;\n  /** `data` is a string (UTF-8 decoded), or the bytes with `{ binary: true }`. */\n  onmessage: ((ev: { type: \"message\"; data: string | Uint8Array }) => void) | null;\n  /** `reason` is the lobby's reason (\"host_left\", \"timeout\", \"kicked\", \"disconnected\", ...) unless `close()` or the host gave one. */\n  onclose: ((ev: { type: \"close\"; code: number; reason: string; wasClean: boolean }) => void) | null;\n  /** Never called (errors surface as `onclose` with code 1006); present so WebSocket code that assigns it works. */\n  onerror: ((ev: { type: \"error\" }) => void) | null;\n}\n\nexport interface LobbySocketOptions {\n  /** Deliver `onmessage` data as bytes (Uint8Array) instead of UTF-8 text. Default false. */\n  binary?: boolean;\n  /** Channel for `send` (default \"reliable\"). \"fast\" is unordered and may drop, like UDP. */\n  channel?: \"reliable\" | \"fast\";\n}\n\n/**\n * Close codes: 1000 a normal leave, `close()` or the host's `disconnect()`, 1001 the other end went away (`host_left`,\n * the host closing, a player who left), 4000 kicked, 1006 anything abnormal (`timeout`, `ice_failed`, `server_lost`,\n * ...). A code and reason the host passed to `kick()` / `disconnect()` win over these.\n */\nexport function closeCodeFor(reason: string): number {\n  if (reason === \"left\" || reason === \"disconnected\") return 1000;\n  if (reason === \"host_left\" || reason === \"closed\") return 1001;\n  if (reason === \"kicked\") return 4000;\n  return 1006;\n}\n\n/** A later task, like a real WebSocket's events: setImmediate in Node, setTimeout(0) in browsers. */\nconst nextTask: (f: () => void) => void =\n  (globalThis as { setImmediate?: (f: () => void) => void }).setImmediate ?? ((f) => void setTimeout(f, 0));\n\nconst enc = new TextEncoder();\nconst dec = new TextDecoder();\n\nclass PeerSocket implements LobbySocket {\n  readyState: 0 | 1 | 3 = 0;\n  readonly bufferedAmount = 0 as const;\n  private openHandler: LobbySocket[\"onopen\"] = null;\n  /** OPEN, but `onopen` has not run yet for any handler. */\n  private openPending = false;\n  onmessage: LobbySocket[\"onmessage\"] = null;\n  onclose: LobbySocket[\"onclose\"] = null;\n  onerror: LobbySocket[\"onerror\"] = null;\n  /** Unsubscribes from the lobby; set by the factory. */\n  detach: () => void = () => {};\n\n  constructor(\n    readonly peerId: number,\n    private readonly out: (bytes: Uint8Array) => void,\n    private readonly binary: boolean,\n    private readonly onLocalClose: () => void,\n  ) {}\n\n  send(data: string | Uint8Array): void {\n    if (this.readyState !== 1) return;\n    this.out(typeof data === \"string\" ? enc.encode(data) : data);\n  }\n\n  close(code = 1000, reason = \"left\"): void {\n    if (this.readyState === 3) return;\n    this.closed(code, reason);\n    this.onLocalClose();\n  }\n\n  get onopen(): LobbySocket[\"onopen\"] {\n    return this.openHandler;\n  }\n\n  set onopen(h: LobbySocket[\"onopen\"]) {\n    this.openHandler = h;\n    // assigned after the open event went by with no handler: deliver it once, still on a later task\n    if (h && this.openPending) nextTask(() => this.fireOpen());\n  }\n\n  /**\n   * @internal OPEN now; `onopen` now, or on a later task (like a real WebSocket) so a handler assigned\n   * after any number of awaits in the same task still runs.\n   */\n  open(later = false): void {\n    if (this.readyState !== 0) return;\n    this.readyState = 1;\n    this.openPending = true;\n    if (!later) this.fireOpen();\n    else nextTask(() => this.fireOpen());\n  }\n\n  private fireOpen(): void {\n    if (this.readyState !== 1 || !this.openPending || !this.openHandler) return;\n    this.openPending = false;\n    this.openHandler({ type: \"open\" });\n  }\n\n  /** @internal */\n  deliver(bytes: Uint8Array): void {\n    if (this.readyState === 1) this.onmessage?.({ type: \"message\", data: this.binary ? bytes : dec.decode(bytes) });\n  }\n\n  /** @internal */\n  closed(code: number, reason: string): void {\n    if (this.readyState === 3) return;\n    this.readyState = 3;\n    this.detach();\n    this.onclose?.({ type: \"close\", code, reason, wasClean: code === 1000 || code === 1001 });\n  }\n}\n\n/**\n * Joiner: the link to the host as a socket. OPEN once `lobby.ready` resolves (at once if it already has), with\n * `onopen` on a later task;\n * closed when the session ends, or with 1001 \"host_changed\" when a server-backed lobby migrates to a new host.\n */\nexport function joinerSocket(lobby: Lobby, o: LobbySocketOptions = {}): LobbySocket {\n  if (lobby.isHost) throw new Error(\"asWebSocket() is for joiners; the host uses lobby.onConnection()\");\n  const channel = o.channel ?? \"reliable\";\n  const s = new PeerSocket(lobby.hostPeerId, (b) => lobby.send(lobby.hostPeerId, b, { channel }), !!o.binary, () => void lobby.leave());\n  const offs = [\n    lobby.on(\"message\", (from, bytes) => {\n      if (from === lobby.hostPeerId) s.deliver(bytes);\n    }),\n    lobby.on(\"sessionEnded\", (reason, close?: CloseInfo) => s.closed(close?.code ?? closeCodeFor(reason), close?.reason ?? reason)),\n    // The socket's far end is the host it opened to; after a migration that server is gone (direct lobbies end instead).\n    lobby.on(\"hostChanged\", () => s.closed(1001, \"host_changed\")),\n  ];\n  s.detach = () => offs.forEach((f) => f());\n  // Already connected (made after `await lobby.ready`): OPEN at once, so a send() right away goes out.\n  if (lobby.connectedPeers.includes(lobby.hostPeerId)) s.open(true);\n  else lobby.ready.then(() => s.open(true), () => {});\n  return s;\n}\n\n/**\n * Host: calls `handler(conn)` once per joiner, as soon as its link is ready (and right away for joiners already\n * connected). A message from a joiner the handler has not seen yet creates its connection first, so nothing is lost.\n * `conn.onclose` fires when that peer leaves (code from closeCodeFor) or the host's session ends. Returns a function\n * that stops new connections (existing ones keep working).\n */\nexport function hostConnections(lobby: Lobby, handler: (conn: LobbySocket) => void, o: LobbySocketOptions = {}): () => void {\n  if (!lobby.isHost) throw new Error(\"onConnection() is for the host; a joiner uses lobby.asWebSocket()\");\n  const channel = o.channel ?? \"reliable\";\n  const conns = new Map<number, PeerSocket>();\n  let stopped = false;\n  const ensure = (peerId: number): PeerSocket | undefined => {\n    if (peerId === lobby.localPeerId) return undefined;\n    let c = conns.get(peerId);\n    if (c || stopped) return c;\n    c = new PeerSocket(peerId, (b) => lobby.send(peerId, b, { channel }), !!o.binary, () => {});\n    const conn = c;\n    conn.detach = () => {\n      if (conns.get(peerId) === conn) conns.delete(peerId);\n    };\n    conns.set(peerId, conn);\n    conn.open();\n    handler(conn);\n    return conn;\n  };\n  const offs = [\n    lobby.on(\"peerReady\", (p: Peer) => void ensure(p.peerId)),\n    lobby.on(\"message\", (from, bytes) => ensure(from)?.deliver(bytes)),\n    lobby.on(\"peerLeft\", (p: Peer, reason, close?: CloseInfo) =>\n      conns.get(p.peerId)?.closed(close?.code ?? (reason === \"left\" ? 1001 : closeCodeFor(reason)), close?.reason ?? reason),\n    ),\n    lobby.on(\"sessionEnded\", (reason) => {\n      for (const c of [...conns.values()]) c.closed(reason === \"left\" ? 1001 : closeCodeFor(reason), reason);\n      offs.forEach((f) => f());\n    }),\n  ];\n  for (const id of lobby.connectedPeers) ensure(id);\n  return () => {\n    stopped = true;\n  };\n}\n"]}

package/dist/testing.js

@@ -409,10 +409,20 @@ export class MemorySocket {
                 const victim = l.peers.get(Number(m.peerId));
                 if (!victim || victim === this.peer)
                     return this.err("bad_request");
-                l.kicked.add(victim.peerId);
+                // ban:false disconnects without the ban; closeCode / closeReason go to the removed peer (spec/signaling.md)
+                const ban = m.ban !== false;
+                const data = {};
+                if (!ban)
+                    data.ban = false;
+                if (typeof m.closeCode === "number")
+                    data.closeCode = m.closeCode;
+                if (typeof m.closeReason === "string")
+                    data.closeReason = m.closeReason;
+                if (ban)
+                    l.kicked.add(victim.peerId);
                 l.peers.delete(victim.peerId);
-                victim.sock?.push({ t: "error", code: "kicked", msg: "kicked" });
-                this.broadcast(l, { t: "peer_left", peerId: victim.peerId, reason: "kicked" });
+                victim.sock?.push({ t: "error", code: "kicked", msg: "kicked", ...(Object.keys(data).length ? { data } : {}) });
+                this.broadcast(l, { t: "peer_left", peerId: victim.peerId, reason: ban ? "kicked" : "disconnected" });
                 return;
             }
             case "host_changed": {