onelobby 0.0.0-stage → 0.2.0

package/dist/joincode.js

@@ -0,0 +1,84 @@
+import { CROCKFORD_ALPHABET } from "./crockford.js";
+/**
+ * `dc1` join codes (docs/direct-ip.md s.2a, spec/reference/joincode.mjs): a direct-IP host's IPv4 address and port in
+ * 11 Crockford characters, shown `6B01-RGFE-P2B`. The code is the address in disguise, so decoding asks nobody.
+ * Bits, most significant first: version:2 (0 = IPv4) | ipv4:32 | port:16 | crc:5 (CRC-5, polynomial 0x05, over the 50
+ * bits before it). One mistyped character always fails the check.
+ */
+export const JOIN_CODE_LENGTH = 11;
+function crc5(value, bits) {
+    let crc = 0;
+    for (let i = bits - 1; i >= 0; i--) {
+        const bit = Number((value >> BigInt(i)) & 1n);
+        const top = (crc >> 4) & 1;
+        crc = (crc << 1) & 0x1f;
+        if (top ^ bit)
+            crc ^= 0x05;
+    }
+    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;
+}
+/** Display form (`6B01-RGFE-P2B`) for an IPv4 address and port 1-65535. Throws on anything else. */
+export 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); // version 0
+    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)}`;
+}
+/** Upper case, spaces and hyphens dropped, i/l -> 1, o -> 0; null unless 11 alphabet characters. */
+export 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;
+    for (const c of s)
+        if (CROCKFORD_ALPHABET.indexOf(c) < 0)
+            return null;
+    return s;
+}
+export function decodeJoinCode(input) {
+    const s = normalizeJoinCode(input);
+    if (!s)
+        return { error: "bad_code" };
+    let v = 0n;
+    for (const c of s)
+        v = (v << 5n) | BigInt(CROCKFORD_ALPHABET.indexOf(c));
+    const data = v >> 5n;
+    if (crc5(data, 50) !== Number(v & 31n))
+        return { error: "bad_code" };
+    if (data >> 48n !== 0n)
+        return { error: "unknown_version" };
+    const port = Number(data & 0xffffn);
+    if (port === 0)
+        return { error: "bad_code" };
+    const a = Number((data >> 16n) & 0xffffffffn);
+    return { ip: [a >>> 24, (a >>> 16) & 255, (a >>> 8) & 255, a & 255].join("."), port };
+}
+/** Shaped like a join code (no dots or colons, 11 alphabet characters): a failed decode is `bad_code`, not a host name. */
+export function looksLikeJoinCode(input) {
+    return !/[.:]/.test(input) && normalizeJoinCode(input) !== null;
+}
+//# sourceMappingURL=joincode.js.map

package/dist/joincode.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"joincode.js","sourceRoot":"","sources":["../src/joincode.ts"],"names":[],"mappings":"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","sourcesContent":["import { CROCKFORD_ALPHABET } from \"./crockford.js\";\n\n/**\n * `dc1` join codes (docs/direct-ip.md s.2a, spec/reference/joincode.mjs): a direct-IP host's IPv4 address and port in\n * 11 Crockford characters, shown `6B01-RGFE-P2B`. The code is the address in disguise, so decoding asks nobody.\n * Bits, most significant first: version:2 (0 = IPv4) | ipv4:32 | port:16 | crc:5 (CRC-5, polynomial 0x05, over the 50\n * bits before it). One mistyped character always fails the check.\n */\nexport const JOIN_CODE_LENGTH = 11;\n\nexport type JoinCodeError = \"bad_code\" | \"unknown_version\";\nexport type DecodedJoinCode = { ip: string; port: number } | { error: JoinCodeError };\n\nfunction crc5(value: bigint, bits: number): number {\n  let crc = 0;\n  for (let i = bits - 1; i >= 0; i--) {\n    const bit = Number((value >> BigInt(i)) & 1n);\n    const top = (crc >> 4) & 1;\n    crc = (crc << 1) & 0x1f;\n    if (top ^ bit) crc ^= 0x05;\n  }\n  return crc;\n}\n\nfunction parseIPv4(ip: string): number | null {\n  const parts = ip.split(\".\");\n  if (parts.length !== 4) return null;\n  let n = 0;\n  for (const p of parts) {\n    if (!/^\\d{1,3}$/.test(p) || Number(p) > 255) return null;\n    n = n * 256 + Number(p);\n  }\n  return n;\n}\n\n/** Display form (`6B01-RGFE-P2B`) for an IPv4 address and port 1-65535. Throws on anything else. */\nexport function encodeJoinCode(ipv4: string, port: number): string {\n  const ip = parseIPv4(ipv4);\n  if (ip === null) throw new Error(`not an IPv4 address: ${ipv4}`);\n  if (!Number.isInteger(port) || port < 1 || port > 65535) throw new Error(`bad port ${port}`);\n  const data = (BigInt(ip) << 16n) | BigInt(port); // version 0\n  let v = (data << 5n) | BigInt(crc5(data, 50));\n  let s = \"\";\n  for (let i = 0; i < JOIN_CODE_LENGTH; i++) {\n    s = CROCKFORD_ALPHABET[Number(v & 31n)] + s;\n    v >>= 5n;\n  }\n  return `${s.slice(0, 4)}-${s.slice(4, 8)}-${s.slice(8)}`;\n}\n\n/** Upper case, spaces and hyphens dropped, i/l -> 1, o -> 0; null unless 11 alphabet characters. */\nexport function normalizeJoinCode(input: string): string | null {\n  const s = input\n    .replace(/[ \\-]/g, \"\")\n    .replace(/[a-z]/g, (c) => c.toUpperCase())\n    .replace(/[IL]/g, \"1\")\n    .replace(/O/g, \"0\");\n  if (s.length !== JOIN_CODE_LENGTH) return null;\n  for (const c of s) if (CROCKFORD_ALPHABET.indexOf(c) < 0) return null;\n  return s;\n}\n\nexport function decodeJoinCode(input: string): DecodedJoinCode {\n  const s = normalizeJoinCode(input);\n  if (!s) return { error: \"bad_code\" };\n  let v = 0n;\n  for (const c of s) v = (v << 5n) | BigInt(CROCKFORD_ALPHABET.indexOf(c));\n  const data = v >> 5n;\n  if (crc5(data, 50) !== Number(v & 31n)) return { error: \"bad_code\" };\n  if (data >> 48n !== 0n) return { error: \"unknown_version\" };\n  const port = Number(data & 0xffffn);\n  if (port === 0) return { error: \"bad_code\" };\n  const a = Number((data >> 16n) & 0xffffffffn);\n  return { ip: [a >>> 24, (a >>> 16) & 255, (a >>> 8) & 255, a & 255].join(\".\"), port };\n}\n\n/** Shaped like a join code (no dots or colons, 11 alphabet characters): a failed decode is `bad_code`, not a host name. */\nexport function looksLikeJoinCode(input: string): boolean {\n  return !/[.:]/.test(input) && normalizeJoinCode(input) !== null;\n}\n"]}

package/dist/lobby.d.ts

@@ -0,0 +1,203 @@
+import { Chat } from "./chat.js";
+import type { Clock } from "./clock.js";
+import { PROTO } from "./codec.js";
+import { Emitter } from "./emitter.js";
+import { Lockstep } from "./lockstep.js";
+import { type LobbyState, type PeerInfo, type SignalingClient } from "./signaling.js";
+import type { ChannelName, IceServer, LinkFactory, PeerLink } from "./transport.js";
+import { Voice, type VoiceDeps } from "./voice.js";
+import { type LobbySocket, type LobbySocketOptions } from "./socket.js";
+export type Phase = "lobby" | "in_game";
+export type Peer = PeerInfo;
+export type LobbyEvents = {
+    peerJoined: [Peer];
+    /** The peer's data channels are open and the handshake is done: reliable sends reach it now (earlier ones were queued and flushed). */
+    peerReady: [Peer];
+    /** Joiner: the link to the host is open (the host itself is ready from the start). Also available as `lobby.ready`. */
+    ready: [];
+    peerLeft: [Peer, reason: string];
+    joinRequested: [Peer];
+    hostChanged: [hostId: number];
+    phase: [Phase];
+    message: [from: number, bytes: Uint8Array, channel: ChannelName];
+    sessionEnded: [reason: string];
+    /** The signaling server went away. The game continues on the data channels (s.9). */
+    serverLost: [];
+    metaChanged: [Record<string, string>];
+};
+export interface LobbyConfig {
+    signaling: SignalingClient;
+    state: LobbyState;
+    ice: IceServer[];
+    links: LinkFactory;
+    clock: Clock;
+    wall: () => number;
+    hashEveryTicks: number;
+    relayOnly: boolean;
+    voice: VoiceDeps;
+    displayName: string;
+    /**
+     * Joiner: give up on reaching the host after this many ms (0 or absent: wait forever). When the ICE list has a
+     * TURN server and the lobby is not relay-only already, the second half of the budget is a relay-only retry.
+     * On failure `ready` rejects with OneLobbyError("ice_failed"), the error is reported and the lobby is left.
+     */
+    readyTimeoutMs?: number;
+    /**
+     * Direct IP (docs/direct-ip.md): the hub lives in the host, so there is no migration. A joiner that loses the host
+     * (link, peer_left, a host_changed from the hub as it shuts down, or the signaling socket) ends with "host_left".
+     */
+    direct?: boolean;
+    /**
+     * Treat a peer as gone after this many ms without hearing anything from it (0 or absent: off, and a silent peer
+     * surfaces only when its link or signaling socket times out, about 30 s). Joiners ping the host every 2 s and the
+     * host answers, so the host drops a silent joiner (`peerLeft`, "timeout") and a joiner handles a silent host as
+     * lost (a direct lobby ends with "host_left"). Values under 6000 are raised to 6000.
+     */
+    peerTimeoutMs?: number;
+    /** Host: per-peer cap on incoming raw messages; the excess is dropped before `message` fires or is relayed. */
+    rateLimit?: RateLimit;
+}
+/** At most `messages` raw messages per peer in any `perMs` window (a fixed window, reset every `perMs`). */
+export interface RateLimit {
+    messages: number;
+    perMs: number;
+}
+/** The smallest `peerTimeoutMs` honoured: three missed pings. */
+export declare const MIN_PEER_TIMEOUT_MS = 6000;
+/** The name shown for a peer that chose none: "Player N", N = its seat (peer id, join order). */
+export declare function seatName(p: PeerInfo): PeerInfo;
+/** One joined lobby: roster, star of peer links, and the lockstep/chat/voice engines riding on them. */
+export declare class Lobby extends Emitter<LobbyEvents> {
+    readonly code: string;
+    readonly mode: "lockstep" | "raw";
+    readonly tickRate: number;
+    readonly lockstep: Lockstep;
+    readonly chat: Chat;
+    readonly voice: Voice;
+    localPeerId: number;
+    hostPeerId: number;
+    phase: Phase;
+    meta: Record<string, string>;
+    resumeToken: string;
+    /** Last measured round trip to the host in ms (joiners), or 0. */
+    rtt: number;
+    /**
+     * Direct-IP host only (onelobby/direct): the code friends paste to join, e.g. "6B01-RGFE-P2B" (docs/direct-ip.md
+     * s.2a). Show it with joinCodeKind. Empty when the machine has no IPv4 address, and on joiners.
+     */
+    joinCode: string;
+    /** "internet": the router forwarded the port and the code carries its public address; "same_network": the LAN address. */
+    joinCodeKind: "internet" | "same_network" | "none";
+    /** Direct-IP host only: this machine's addresses with the port, for an "Advanced" fold-out. */
+    directAddresses: string[];
+    /** Direct-IP host only: how the router port-open went ("UPnP", "no UPnP gateway answered; ...", "off"). */
+    portMapping: string;
+    private signaling;
+    private cfg;
+    private roster;
+    private links;
+    private connected;
+    private hiSentTo;
+    private epoch;
+    private ended;
+    private serverUp;
+    private cancelWatchdog;
+    private cancelPing;
+    private pingN;
+    private chunkId;
+    private reassemblers;
+    private hub;
+    private outbox;
+    private markReady;
+    private failReady;
+    private isReady;
+    private cancelReadyTimer;
+    private relayRetry;
+    /** clock.now() of the last frame from each peer (peerTimeoutMs). */
+    private lastHeard;
+    /** Host: per-peer fixed window for rateLimit. */
+    private rate;
+    /**
+     * 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).
+     */
+    readonly ready: Promise<void>;
+    constructor(cfg: LobbyConfig);
+    get isHost(): boolean;
+    get peers(): Peer[];
+    peer(peerId: number): Peer | undefined;
+    /** Peers whose link is open and handshake done (host: the ready joiners; joiner: the host once ready). */
+    get connectedPeers(): number[];
+    /**
+     * Joiner: the link to the host as a WebSocket-shaped object (text by default), so WebSocket client code runs
+     * unchanged. It opens when `ready` resolves and closes when the session ends (`host_left` gives code 1001).
+     */
+    asWebSocket(opts?: LobbySocketOptions): LobbySocket;
+    /** Host: `handler(conn)` once per joiner (a WebSocket-shaped connection), the server-side mirror of asWebSocket(). */
+    onConnection(handler: (conn: LobbySocket) => void, opts?: LobbySocketOptions): () => void;
+    set snapshotChunkSize(n: number);
+    /** Current migration epoch (0 until the first host change). */
+    get hostEpoch(): number;
+    /** @internal Host role: create the link to `peerId` and start negotiating (adapters and tests). */
+    _offer(peerId: number): PeerLink;
+    /** @internal Joiner role: create the answering link to `peerId` (adapters and tests). */
+    _answer(peerId: number): PeerLink;
+    /** @internal Called by OneLobby right after construction: the host waits for joiners, a joiner waits for the host's offer. */
+    _begin(): void;
+    start(): Promise<void>;
+    setMeta(meta: Record<string, string>): Promise<void>;
+    kick(peerId: number): Promise<void>;
+    approve(peerId: number, ok: boolean): Promise<void>;
+    leave(): Promise<void>;
+    /** raw mode (and any extra game data): to one peer. */
+    send(peerId: number, bytes: Uint8Array, opts?: {
+        channel?: "reliable" | "fast";
+    }): void;
+    /** To everyone else in the lobby. */
+    broadcast(bytes: Uint8Array, opts?: {
+        channel?: "reliable" | "fast";
+    }): void;
+    private channelFor;
+    private sendTo;
+    private connectedPeerIds;
+    private reportError;
+    /** @internal set by OneLobby so lobby errors reach `kit.on("error")`. */
+    errorSink: ((e: Error) => void) | null;
+    /** @internal set by OneLobby: the server issued a new resume token (rememberSeat). */
+    seatSink: ((token: string) => void) | null;
+    private armReadyTimer;
+    /** The direct attempt stalled: dial the host ourselves through the TURN relay (a host answers any offer). */
+    private retryRelayed;
+    private giveUpConnecting;
+    private makeLink;
+    /** Host side: offer to a joiner. */
+    private offerTo;
+    private onLinkOpen;
+    private sendHi;
+    private onLinkClosed;
+    private onData;
+    private onHi;
+    private flush;
+    private onRaw;
+    private allowRaw;
+    private setHost;
+    /** The host is gone (link closed, no frames for 3 s, or the server said so): run the s.9 rule. */
+    private handleHostLost;
+    private becomeHost;
+    private onHostClaim;
+    private onSignaling;
+    private onSignal;
+    private removePeer;
+    private dropPeer;
+    private setPhase;
+    private onServerClosed;
+    private watchdog;
+    /** peerTimeoutMs: the host drops joiners it has not heard from; a joiner handles a silent host as lost. */
+    private dropSilent;
+    private pingHost;
+    private teardown;
+    /** Total in-flight links (diagnostics and tests). */
+    get linkCount(): number;
+}
+export { PROTO };