onelobby 0.0.0-stage → 0.2.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Parker Tonra
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -1,3 +1,78 @@
-# Temporary Holding Version
+# onelobby
 
-This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.
+Multiplayer for browser games. Players host a lobby, share a six-letter code, and join each other over peer-to-peer
+WebRTC. Includes lockstep sync, raw messages, text chat and voice chat. No runtime dependencies.
+
+You need a OneLobby lobby server (the WebSocket URL, like `wss://lobby.example.com/ws`). See the
+[docs](https://github.com/ParkerTonra/onelobby#readme) to run one.
+
+## Use it from a `<script>` tag (no build tools)
+
+```html
+<script src="https://cdn.jsdelivr.net/npm/onelobby@0.2.0/dist/onelobby.global.min.js"></script>
+<script>
+  const kit = new OneLobby.OneLobby({
+    gameId: "com.you.yourgame",            // any unique name for your game
+    netVersion: "1",
+    lobbyServer: "wss://lobby.example.com/ws",
+    mode: "raw",
+  });
+  // Host:  const lobby = await kit.host({ name: "My game", maxPlayers: 4 }); show OneLobby.formatCode(lobby.code)
+  // Join:  const lobby = await kit.join("C5A FX8");
+</script>
+```
+
+The file also works saved next to your page (`<script src="onelobby.global.min.js">`), including pages opened from disk.
+
+## No code at all
+
+After the `<script>` tag above, this gives a complete lobby box (the sentence inside only shows if the script did not
+load):
+
+```html
+<one-lobby server="https://your-name.onrender.com" game="my-game" max-players="4">
+  If you can read this, the OneLobby script didn't load.
+</one-lobby>
+```
+
+See the [no-code guide](https://github.com/ParkerTonra/onelobby/blob/main/docs/no-code.md).
+
+## Install with npm
+
+```
+npm install onelobby
+```
+
+```ts
+import { OneLobby, formatCode } from "onelobby";
+
+const kit = new OneLobby({ gameId: "com.you.yourgame", netVersion: "1", lobbyServer: "wss://lobby.example.com/ws" });
+const lobby = await kit.host({ name: "My game", maxPlayers: 4 });
+console.log("Tell your friend this code:", formatCode(lobby.code));
+```
+
+Without a bundler: `import { OneLobby } from "https://cdn.jsdelivr.net/npm/onelobby@0.2.0/dist/onelobby.bundle.mjs"`.
+
+## Made for players
+
+- Lobbies are **unlisted** by default: friends join with the code or a link (`OneLobby.shareUrl(lobby.code)` makes
+  `https://your.game/?join=C5A-FX8`; `OneLobby.codeFromUrl()` reads it back). Pass `visibility: "public"` to list it.
+- Players without a name show as **"Player 2"**, "Player 3", ...
+- A joiner that can't connect gets an error after 15 s (`readyTimeoutMs`) instead of waiting forever: code
+  `ice_failed`, and `sessionEnded` with that reason. One relay retry happens first when the server offers TURN.
+- A page **reload keeps the seat** (`rememberSeat`, on by default): `kit.join(sameCode)` or `kit.resume()` takes it back;
+  `kit.rememberedCode` says which lobby.
+- `OneLobby.describeError(err)` turns any error into `{ message, hint }` you can show as-is.
+- Test seams go under `advanced: { socketFactory, linkFactory, clock, storage, ... }`.
+
+## Files
+
+| Import | What |
+|---|---|
+| `onelobby` | the public API: `OneLobby`, `Lobby`, `Lockstep`, `Chat`, `Voice`, `OneLobbyError`, `normalizeCode`, `formatCode`, `describeError`, `shareUrl`, `codeFromUrl` |
+| `onelobby/ui` | the `<one-lobby>` drop-in element (host, join, invite link, players, start); also in the `<script>` build |
+| `onelobby/testing` | in-memory server, peer network and clock for your own tests |
+| `onelobby/internals` | low-level pieces (codec, chunking, migration, jitter buffer, ...); no stability promise |
+| `dist/onelobby.global.min.js` | the `<script>` build; sets `window.OneLobby` |
+
+Guides, recipes and the API reference: [OneLobby docs](https://github.com/ParkerTonra/onelobby#readme). MIT license.

package/dist/chat.d.ts

@@ -0,0 +1,60 @@
+import { type ChatRejectReason, type Message } from "./codec.js";
+import { Emitter } from "./emitter.js";
+import type { Hub } from "./hub.js";
+export declare const CHAT_MAX_BYTES = 256;
+export declare const CHAT_BURST = 3;
+export declare const CHAT_WINDOW_MS = 5000;
+export declare const CHAT_PER_WINDOW = 5;
+export declare const CHAT_HISTORY_LINES = 100;
+export declare function sanitizeChat(text: string): string;
+export declare function utf8Length(text: string): number;
+/**
+ * Token bucket per peer: `CHAT_PER_WINDOW` messages per `CHAT_WINDOW_MS`, burst `CHAT_BURST`
+ * (capacity 3, refilled one token per second).
+ */
+export declare class ChatLimiter {
+    private buckets;
+    private refillMs;
+    tryTake(peerId: number, now: number): boolean;
+    forget(peerId: number): void;
+}
+export interface ChatMessage {
+    peerId: number;
+    id: number;
+    ts: number;
+    text: string;
+}
+export type ChatEvents = {
+    message: [ChatMessage];
+    rejected: [id: number, reason: ChatRejectReason];
+    /** The host's `chat_history` arrived (joiners, right after the handshake). */
+    history: [readonly ChatMessage[]];
+};
+/** Text chat (DESIGN s.9b): sender -> host (validates, stamps) -> everyone, over the reliable channel. */
+export declare class Chat extends Emitter<ChatEvents> {
+    private hub;
+    private wall;
+    private isLocallyMuted;
+    /** Game-provided profanity hook; applied to every line a player is shown. */
+    filter: (text: string) => string;
+    private lines;
+    private limiter;
+    private hostMuted;
+    private localId;
+    private stampId;
+    constructor(hub: Hub, wall: () => number, isLocallyMuted: (peerId: number) => boolean);
+    get history(): readonly ChatMessage[];
+    /** Returns the local message id (what `rejected` will refer to). */
+    send(text: string): number;
+    /** Host only: drop a peer's chat for everyone (`chat_reject` reason 3). */
+    hostMute(peerId: number, muted: boolean): void;
+    isHostMuted(peerId: number): boolean;
+    onPeerLeft(peerId: number): void;
+    /** Host: send recent lines to a freshly connected peer. */
+    sendHistory(peerId: number): void;
+    handle(from: number, route: number, msg: Message): void;
+    private hostProcess;
+    private deliver;
+    private push;
+    private safeFilter;
+}

package/dist/chat.js

@@ -0,0 +1,163 @@
+import { CHAT_REJECT, chatRejectName } from "./codec.js";
+import { Emitter } from "./emitter.js";
+export const CHAT_MAX_BYTES = 256;
+export const CHAT_BURST = 3;
+export const CHAT_WINDOW_MS = 5000;
+export const CHAT_PER_WINDOW = 5;
+export const CHAT_HISTORY_LINES = 100;
+/** Control characters (C0, DEL, C1) and bidi overrides/isolates/marks are removed at the host. */
+// eslint-disable-next-line no-control-regex
+const STRIP = /[\u0000-\u001f\u007f-\u009f\u202a-\u202e\u2066-\u2069]/g;
+export function sanitizeChat(text) {
+    return text.replace(STRIP, "");
+}
+export function utf8Length(text) {
+    return new TextEncoder().encode(text).length;
+}
+/**
+ * Token bucket per peer: `CHAT_PER_WINDOW` messages per `CHAT_WINDOW_MS`, burst `CHAT_BURST`
+ * (capacity 3, refilled one token per second).
+ */
+export class ChatLimiter {
+    buckets = new Map();
+    refillMs = CHAT_WINDOW_MS / CHAT_PER_WINDOW;
+    tryTake(peerId, now) {
+        let b = this.buckets.get(peerId);
+        if (!b)
+            this.buckets.set(peerId, (b = { tokens: CHAT_BURST, at: now }));
+        b.tokens = Math.min(CHAT_BURST, b.tokens + (now - b.at) / this.refillMs);
+        b.at = now;
+        if (b.tokens < 1)
+            return false;
+        b.tokens -= 1;
+        return true;
+    }
+    forget(peerId) {
+        this.buckets.delete(peerId);
+    }
+}
+/** Text chat (DESIGN s.9b): sender -> host (validates, stamps) -> everyone, over the reliable channel. */
+export class Chat extends Emitter {
+    hub;
+    wall;
+    isLocallyMuted;
+    /** Game-provided profanity hook; applied to every line a player is shown. */
+    filter = (t) => t;
+    lines = [];
+    limiter = new ChatLimiter();
+    hostMuted = new Set();
+    localId = 0;
+    stampId = 0;
+    constructor(hub, wall, isLocallyMuted) {
+        super();
+        this.hub = hub;
+        this.wall = wall;
+        this.isLocallyMuted = isLocallyMuted;
+    }
+    get history() {
+        return this.lines;
+    }
+    /** Returns the local message id (what `rejected` will refer to). */
+    send(text) {
+        const id = ++this.localId >>> 0;
+        if (utf8Length(text) > CHAT_MAX_BYTES * 4) {
+            // Do not even ship absurd payloads; the host would reject on length anyway.
+            queueMicrotask(() => this.emit("rejected", id, "length"));
+            return id;
+        }
+        if (this.hub.isHost)
+            this.hostProcess(this.hub.localPeerId, id, text);
+        else
+            this.hub.sendToHost({ type: "chat", id, ts: 0, text });
+        return id;
+    }
+    /** Host only: drop a peer's chat for everyone (`chat_reject` reason 3). */
+    hostMute(peerId, muted) {
+        if (!this.hub.isHost)
+            throw new Error("only the host can mute chat");
+        if (muted)
+            this.hostMuted.add(peerId);
+        else
+            this.hostMuted.delete(peerId);
+    }
+    isHostMuted(peerId) {
+        return this.hostMuted.has(peerId);
+    }
+    onPeerLeft(peerId) {
+        this.limiter.forget(peerId);
+        this.hostMuted.delete(peerId);
+    }
+    /** Host: send recent lines to a freshly connected peer. */
+    sendHistory(peerId) {
+        const lines = this.lines.slice(-CHAT_HISTORY_LINES).map((l) => ({ ...l }));
+        this.hub.sendTo(peerId, { type: "chat_history", lines }, 0);
+    }
+    handle(from, route, msg) {
+        switch (msg.type) {
+            case "chat":
+                if (this.hub.isHost)
+                    this.hostProcess(from, msg.id, msg.text);
+                else
+                    this.deliver({ peerId: route, id: msg.id, ts: msg.ts, text: msg.text });
+                break;
+            case "chat_history":
+                if (!this.hub.isHost) {
+                    this.lines = [];
+                    for (const l of msg.lines.slice(-CHAT_HISTORY_LINES))
+                        this.push({ ...l, text: this.safeFilter(l.text) });
+                    this.emit("history", this.lines);
+                }
+                break;
+            case "chat_reject":
+                this.emit("rejected", msg.id, chatRejectName(msg.reason));
+                break;
+        }
+    }
+    // ---- host path ----------------------------------------------------------------------------------------------
+    hostProcess(from, id, rawText) {
+        const reject = (code) => {
+            if (from === this.hub.localPeerId)
+                this.emit("rejected", id, chatRejectName(code));
+            else
+                this.hub.sendTo(from, { type: "chat_reject", id, reason: code }, 0);
+        };
+        if (this.hostMuted.has(from))
+            return reject(CHAT_REJECT.mutedByHost);
+        // spec order: muted, length (before stripping), rate (a reject spends no token), strip, drop if empty
+        if (utf8Length(rawText) > CHAT_MAX_BYTES)
+            return reject(CHAT_REJECT.length);
+        if (!this.limiter.tryTake(from, this.hub.clock.now()))
+            return reject(CHAT_REJECT.rate);
+        const text = sanitizeChat(rawText);
+        if (text.length === 0)
+            return;
+        const line = { peerId: from, id: ++this.stampId >>> 0, ts: this.wall(), text };
+        const out = { type: "chat", id: line.id, ts: line.ts, text: line.text };
+        for (const p of this.hub.connectedPeers())
+            this.hub.sendTo(p, out, from);
+        this.deliver(line);
+    }
+    deliver(line) {
+        const shown = { ...line, text: this.safeFilter(line.text) };
+        this.push(shown);
+        if (this.isLocallyMuted(line.peerId))
+            return; // local mute drops the peer's chat, history included
+        this.emit("message", shown);
+    }
+    push(line) {
+        if (this.isLocallyMuted(line.peerId))
+            return;
+        this.lines.push(line);
+        if (this.lines.length > CHAT_HISTORY_LINES)
+            this.lines.splice(0, this.lines.length - CHAT_HISTORY_LINES);
+    }
+    safeFilter(text) {
+        try {
+            return this.filter(text);
+        }
+        catch {
+            return text;
+        }
+    }
+}
+//# sourceMappingURL=chat.js.map

package/dist/chat.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"chat.js","sourceRoot":"","sources":["../src/chat.ts"],"names":[],"mappings":"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","sourcesContent":["import { CHAT_REJECT, chatRejectName, type ChatLine, type ChatRejectReason, type Message } from \"./codec.js\";\nimport { Emitter } from \"./emitter.js\";\nimport type { Hub } from \"./hub.js\";\n\nexport const CHAT_MAX_BYTES = 256;\nexport const CHAT_BURST = 3;\nexport const CHAT_WINDOW_MS = 5000;\nexport const CHAT_PER_WINDOW = 5;\nexport const CHAT_HISTORY_LINES = 100;\n\n/** Control characters (C0, DEL, C1) and bidi overrides/isolates/marks are removed at the host. */\n// eslint-disable-next-line no-control-regex\nconst STRIP = /[\\u0000-\\u001f\\u007f-\\u009f\\u202a-\\u202e\\u2066-\\u2069]/g;\n\nexport function sanitizeChat(text: string): string {\n  return text.replace(STRIP, \"\");\n}\n\nexport function utf8Length(text: string): number {\n  return new TextEncoder().encode(text).length;\n}\n\n/**\n * Token bucket per peer: `CHAT_PER_WINDOW` messages per `CHAT_WINDOW_MS`, burst `CHAT_BURST`\n * (capacity 3, refilled one token per second).\n */\nexport class ChatLimiter {\n  private buckets = new Map<number, { tokens: number; at: number }>();\n  private refillMs = CHAT_WINDOW_MS / CHAT_PER_WINDOW;\n\n  tryTake(peerId: number, now: number): boolean {\n    let b = this.buckets.get(peerId);\n    if (!b) this.buckets.set(peerId, (b = { tokens: CHAT_BURST, at: now }));\n    b.tokens = Math.min(CHAT_BURST, b.tokens + (now - b.at) / this.refillMs);\n    b.at = now;\n    if (b.tokens < 1) return false;\n    b.tokens -= 1;\n    return true;\n  }\n\n  forget(peerId: number): void {\n    this.buckets.delete(peerId);\n  }\n}\n\nexport interface ChatMessage {\n  peerId: number;\n  id: number;\n  ts: number;\n  text: string;\n}\n\nexport type ChatEvents = {\n  message: [ChatMessage];\n  rejected: [id: number, reason: ChatRejectReason];\n  /** The host's `chat_history` arrived (joiners, right after the handshake). */\n  history: [readonly ChatMessage[]];\n};\n\n/** Text chat (DESIGN s.9b): sender -> host (validates, stamps) -> everyone, over the reliable channel. */\nexport class Chat extends Emitter<ChatEvents> {\n  /** Game-provided profanity hook; applied to every line a player is shown. */\n  filter: (text: string) => string = (t) => t;\n\n  private lines: ChatMessage[] = [];\n  private limiter = new ChatLimiter();\n  private hostMuted = new Set<number>();\n  private localId = 0;\n  private stampId = 0;\n\n  constructor(\n    private hub: Hub,\n    private wall: () => number,\n    private isLocallyMuted: (peerId: number) => boolean,\n  ) {\n    super();\n  }\n\n  get history(): readonly ChatMessage[] {\n    return this.lines;\n  }\n\n  /** Returns the local message id (what `rejected` will refer to). */\n  send(text: string): number {\n    const id = ++this.localId >>> 0;\n    if (utf8Length(text) > CHAT_MAX_BYTES * 4) {\n      // Do not even ship absurd payloads; the host would reject on length anyway.\n      queueMicrotask(() => this.emit(\"rejected\", id, \"length\"));\n      return id;\n    }\n    if (this.hub.isHost) this.hostProcess(this.hub.localPeerId, id, text);\n    else this.hub.sendToHost({ type: \"chat\", id, ts: 0, text });\n    return id;\n  }\n\n  /** Host only: drop a peer's chat for everyone (`chat_reject` reason 3). */\n  hostMute(peerId: number, muted: boolean): void {\n    if (!this.hub.isHost) throw new Error(\"only the host can mute chat\");\n    if (muted) this.hostMuted.add(peerId);\n    else this.hostMuted.delete(peerId);\n  }\n\n  isHostMuted(peerId: number): boolean {\n    return this.hostMuted.has(peerId);\n  }\n\n  onPeerLeft(peerId: number): void {\n    this.limiter.forget(peerId);\n    this.hostMuted.delete(peerId);\n  }\n\n  /** Host: send recent lines to a freshly connected peer. */\n  sendHistory(peerId: number): void {\n    const lines: ChatLine[] = this.lines.slice(-CHAT_HISTORY_LINES).map((l) => ({ ...l }));\n    this.hub.sendTo(peerId, { type: \"chat_history\", lines }, 0);\n  }\n\n  handle(from: number, route: number, msg: Message): void {\n    switch (msg.type) {\n      case \"chat\":\n        if (this.hub.isHost) this.hostProcess(from, msg.id, msg.text);\n        else this.deliver({ peerId: route, id: msg.id, ts: msg.ts, text: msg.text });\n        break;\n      case \"chat_history\":\n        if (!this.hub.isHost) {\n          this.lines = [];\n          for (const l of msg.lines.slice(-CHAT_HISTORY_LINES)) this.push({ ...l, text: this.safeFilter(l.text) });\n          this.emit(\"history\", this.lines);\n        }\n        break;\n      case \"chat_reject\":\n        this.emit(\"rejected\", msg.id, chatRejectName(msg.reason));\n        break;\n    }\n  }\n\n  // ---- host path ----------------------------------------------------------------------------------------------\n\n  private hostProcess(from: number, id: number, rawText: string): void {\n    const reject = (code: number) => {\n      if (from === this.hub.localPeerId) this.emit(\"rejected\", id, chatRejectName(code));\n      else this.hub.sendTo(from, { type: \"chat_reject\", id, reason: code }, 0);\n    };\n    if (this.hostMuted.has(from)) return reject(CHAT_REJECT.mutedByHost);\n    // spec order: muted, length (before stripping), rate (a reject spends no token), strip, drop if empty\n    if (utf8Length(rawText) > CHAT_MAX_BYTES) return reject(CHAT_REJECT.length);\n    if (!this.limiter.tryTake(from, this.hub.clock.now())) return reject(CHAT_REJECT.rate);\n    const text = sanitizeChat(rawText);\n    if (text.length === 0) return;\n    const line: ChatMessage = { peerId: from, id: ++this.stampId >>> 0, ts: this.wall(), text };\n    const out: Message = { type: \"chat\", id: line.id, ts: line.ts, text: line.text };\n    for (const p of this.hub.connectedPeers()) this.hub.sendTo(p, out, from);\n    this.deliver(line);\n  }\n\n  private deliver(line: ChatMessage): void {\n    const shown: ChatMessage = { ...line, text: this.safeFilter(line.text) };\n    this.push(shown);\n    if (this.isLocallyMuted(line.peerId)) return; // local mute drops the peer's chat, history included\n    this.emit(\"message\", shown);\n  }\n\n  private push(line: ChatMessage): void {\n    if (this.isLocallyMuted(line.peerId)) return;\n    this.lines.push(line);\n    if (this.lines.length > CHAT_HISTORY_LINES) this.lines.splice(0, this.lines.length - CHAT_HISTORY_LINES);\n  }\n\n  private safeFilter(text: string): string {\n    try {\n      return this.filter(text);\n    } catch {\n      return text;\n    }\n  }\n}\n"]}

package/dist/chunking.d.ts

@@ -0,0 +1,17 @@
+import { type Message } from "./codec.js";
+/** Chunk body capacity: 16 KiB frame - 3 header - 8 chunk header, rounded down for headroom. */
+export declare const CHUNK_PAYLOAD = 16000;
+export declare function splitChunks(id: number, bytes: Uint8Array, size?: number): Message[];
+/** Reassembles chunked payloads by id. Duplicates are ignored; out-of-order chunks are fine. */
+export declare class Reassembler {
+    private parts;
+    /** Returns the full payload when the last chunk arrives, otherwise null. */
+    push(chunk: {
+        id: number;
+        index: number;
+        count: number;
+        bytes: Uint8Array;
+    }): Uint8Array | null;
+    get pending(): number;
+    clear(): void;
+}

package/dist/chunking.js

@@ -0,0 +1,59 @@
+import { CodecError, MAX_REASSEMBLED_BYTES } from "./codec.js";
+/** Chunk body capacity: 16 KiB frame - 3 header - 8 chunk header, rounded down for headroom. */
+export const CHUNK_PAYLOAD = 16000;
+export function splitChunks(id, bytes, size = CHUNK_PAYLOAD) {
+    const count = Math.max(1, Math.ceil(bytes.length / size));
+    if (count > 0xffff)
+        throw new RangeError("payload needs more than 65535 chunks");
+    const out = [];
+    for (let i = 0; i < count; i++) {
+        out.push({
+            type: "chunk",
+            id,
+            index: i,
+            count,
+            bytes: bytes.subarray(i * size, Math.min(bytes.length, (i + 1) * size)),
+        });
+    }
+    return out;
+}
+/** Reassembles chunked payloads by id. Duplicates are ignored; out-of-order chunks are fine. */
+export class Reassembler {
+    parts = new Map();
+    /** Returns the full payload when the last chunk arrives, otherwise null. */
+    push(chunk) {
+        if (chunk.count === 0 || chunk.index >= chunk.count)
+            return null;
+        let e = this.parts.get(chunk.id);
+        if (!e || e.count !== chunk.count) {
+            e = { count: chunk.count, got: 0, parts: new Array(chunk.count), bytes: 0 };
+            this.parts.set(chunk.id, e);
+        }
+        if (e.parts[chunk.index])
+            return null;
+        e.parts[chunk.index] = chunk.bytes;
+        e.got++;
+        e.bytes += chunk.bytes.length;
+        if (e.bytes > MAX_REASSEMBLED_BYTES) {
+            this.parts.delete(chunk.id);
+            throw new CodecError("too_long", `chunk set over ${MAX_REASSEMBLED_BYTES} bytes`);
+        }
+        if (e.got < e.count)
+            return null;
+        this.parts.delete(chunk.id);
+        const out = new Uint8Array(e.bytes);
+        let pos = 0;
+        for (const p of e.parts) {
+            out.set(p, pos);
+            pos += p.length;
+        }
+        return out;
+    }
+    get pending() {
+        return this.parts.size;
+    }
+    clear() {
+        this.parts.clear();
+    }
+}
+//# sourceMappingURL=chunking.js.map

package/dist/chunking.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"chunking.js","sourceRoot":"","sources":["../src/chunking.ts"],"names":[],"mappings":"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","sourcesContent":["import { CodecError, MAX_REASSEMBLED_BYTES, type Message } from \"./codec.js\";\n\n/** Chunk body capacity: 16 KiB frame - 3 header - 8 chunk header, rounded down for headroom. */\nexport const CHUNK_PAYLOAD = 16000;\n\nexport function splitChunks(id: number, bytes: Uint8Array, size = CHUNK_PAYLOAD): Message[] {\n  const count = Math.max(1, Math.ceil(bytes.length / size));\n  if (count > 0xffff) throw new RangeError(\"payload needs more than 65535 chunks\");\n  const out: Message[] = [];\n  for (let i = 0; i < count; i++) {\n    out.push({\n      type: \"chunk\",\n      id,\n      index: i,\n      count,\n      bytes: bytes.subarray(i * size, Math.min(bytes.length, (i + 1) * size)),\n    });\n  }\n  return out;\n}\n\ninterface Partial {\n  count: number;\n  got: number;\n  parts: (Uint8Array | undefined)[];\n  bytes: number;\n}\n\n/** Reassembles chunked payloads by id. Duplicates are ignored; out-of-order chunks are fine. */\nexport class Reassembler {\n  private parts = new Map<number, Partial>();\n\n  /** Returns the full payload when the last chunk arrives, otherwise null. */\n  push(chunk: { id: number; index: number; count: number; bytes: Uint8Array }): Uint8Array | null {\n    if (chunk.count === 0 || chunk.index >= chunk.count) return null;\n    let e = this.parts.get(chunk.id);\n    if (!e || e.count !== chunk.count) {\n      e = { count: chunk.count, got: 0, parts: new Array(chunk.count), bytes: 0 };\n      this.parts.set(chunk.id, e);\n    }\n    if (e.parts[chunk.index]) return null;\n    e.parts[chunk.index] = chunk.bytes;\n    e.got++;\n    e.bytes += chunk.bytes.length;\n    if (e.bytes > MAX_REASSEMBLED_BYTES) {\n      this.parts.delete(chunk.id);\n      throw new CodecError(\"too_long\", `chunk set over ${MAX_REASSEMBLED_BYTES} bytes`);\n    }\n    if (e.got < e.count) return null;\n    this.parts.delete(chunk.id);\n    const out = new Uint8Array(e.bytes);\n    let pos = 0;\n    for (const p of e.parts) {\n      out.set(p!, pos);\n      pos += p!.length;\n    }\n    return out;\n  }\n\n  get pending(): number {\n    return this.parts.size;\n  }\n  clear(): void {\n    this.parts.clear();\n  }\n}\n"]}

package/dist/clock.d.ts

@@ -0,0 +1,8 @@
+/** Time source. Lockstep timing never uses requestAnimationFrame (DESIGN s.4). */
+export interface Clock {
+    now(): number;
+    /** Repeating timer; returns a cancel function. */
+    setInterval(fn: () => void, ms: number): () => void;
+    setTimeout(fn: () => void, ms: number): () => void;
+}
+export declare const systemClock: Clock;

package/dist/clock.js

@@ -0,0 +1,39 @@
+/**
+ * Interval driven from a dedicated Worker when available (hidden tabs clamp main-thread timers to 1 Hz),
+ * main-thread setInterval otherwise.
+ */
+function workerInterval(fn, ms) {
+    if (typeof Worker === "undefined" || typeof Blob === "undefined" || typeof URL === "undefined" || !URL.createObjectURL) {
+        return null;
+    }
+    try {
+        const src = `let h=0;onmessage=e=>{if(e.data&&e.data.start){h=setInterval(()=>postMessage(0),e.data.ms)}else{clearInterval(h);close()}}`;
+        const url = URL.createObjectURL(new Blob([src], { type: "text/javascript" }));
+        const w = new Worker(url);
+        URL.revokeObjectURL(url);
+        w.onmessage = () => fn();
+        w.postMessage({ start: true, ms });
+        return () => {
+            w.postMessage({ stop: true });
+            w.terminate();
+        };
+    }
+    catch {
+        return null;
+    }
+}
+export const systemClock = {
+    now: () => (typeof performance !== "undefined" ? performance.now() : Date.now()),
+    setInterval(fn, ms) {
+        const w = workerInterval(fn, ms);
+        if (w)
+            return w;
+        const h = setInterval(fn, ms);
+        return () => clearInterval(h);
+    },
+    setTimeout(fn, ms) {
+        const h = setTimeout(fn, ms);
+        return () => clearTimeout(h);
+    },
+};
+//# sourceMappingURL=clock.js.map

package/dist/clock.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"clock.js","sourceRoot":"","sources":["../src/clock.ts"],"names":[],"mappings":"AAQA;;;GAGG;AACH,SAAS,cAAc,CAAC,EAAc,EAAE,EAAU;IAChD,IAAI,OAAO,MAAM,KAAK,WAAW,IAAI,OAAO,IAAI,KAAK,WAAW,IAAI,OAAO,GAAG,KAAK,WAAW,IAAI,CAAC,GAAG,CAAC,eAAe,EAAE,CAAC;QACvH,OAAO,IAAI,CAAC;IACd,CAAC;IACD,IAAI,CAAC;QACH,MAAM,GAAG,GAAG,4HAA4H,CAAC;QACzI,MAAM,GAAG,GAAG,GAAG,CAAC,eAAe,CAAC,IAAI,IAAI,CAAC,CAAC,GAAG,CAAC,EAAE,EAAE,IAAI,EAAE,iBAAiB,EAAE,CAAC,CAAC,CAAC;QAC9E,MAAM,CAAC,GAAG,IAAI,MAAM,CAAC,GAAG,CAAC,CAAC;QAC1B,GAAG,CAAC,eAAe,CAAC,GAAG,CAAC,CAAC;QACzB,CAAC,CAAC,SAAS,GAAG,GAAG,EAAE,CAAC,EAAE,EAAE,CAAC;QACzB,CAAC,CAAC,WAAW,CAAC,EAAE,KAAK,EAAE,IAAI,EAAE,EAAE,EAAE,CAAC,CAAC;QACnC,OAAO,GAAG,EAAE;YACV,CAAC,CAAC,WAAW,CAAC,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC;YAC9B,CAAC,CAAC,SAAS,EAAE,CAAC;QAChB,CAAC,CAAC;IACJ,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,IAAI,CAAC;IACd,CAAC;AACH,CAAC;AAED,MAAM,CAAC,MAAM,WAAW,GAAU;IAChC,GAAG,EAAE,GAAG,EAAE,CAAC,CAAC,OAAO,WAAW,KAAK,WAAW,CAAC,CAAC,CAAC,WAAW,CAAC,GAAG,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,EAAE,CAAC;IAChF,WAAW,CAAC,EAAE,EAAE,EAAE;QAChB,MAAM,CAAC,GAAG,cAAc,CAAC,EAAE,EAAE,EAAE,CAAC,CAAC;QACjC,IAAI,CAAC;YAAE,OAAO,CAAC,CAAC;QAChB,MAAM,CAAC,GAAG,WAAW,CAAC,EAAE,EAAE,EAAE,CAAC,CAAC;QAC9B,OAAO,GAAG,EAAE,CAAC,aAAa,CAAC,CAAC,CAAC,CAAC;IAChC,CAAC;IACD,UAAU,CAAC,EAAE,EAAE,EAAE;QACf,MAAM,CAAC,GAAG,UAAU,CAAC,EAAE,EAAE,EAAE,CAAC,CAAC;QAC7B,OAAO,GAAG,EAAE,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC;IAC/B,CAAC;CACF,CAAC","sourcesContent":["/** Time source. Lockstep timing never uses requestAnimationFrame (DESIGN s.4). */\nexport interface Clock {\n  now(): number;\n  /** Repeating timer; returns a cancel function. */\n  setInterval(fn: () => void, ms: number): () => void;\n  setTimeout(fn: () => void, ms: number): () => void;\n}\n\n/**\n * Interval driven from a dedicated Worker when available (hidden tabs clamp main-thread timers to 1 Hz),\n * main-thread setInterval otherwise.\n */\nfunction workerInterval(fn: () => void, ms: number): (() => void) | null {\n  if (typeof Worker === \"undefined\" || typeof Blob === \"undefined\" || typeof URL === \"undefined\" || !URL.createObjectURL) {\n    return null;\n  }\n  try {\n    const src = `let h=0;onmessage=e=>{if(e.data&&e.data.start){h=setInterval(()=>postMessage(0),e.data.ms)}else{clearInterval(h);close()}}`;\n    const url = URL.createObjectURL(new Blob([src], { type: \"text/javascript\" }));\n    const w = new Worker(url);\n    URL.revokeObjectURL(url);\n    w.onmessage = () => fn();\n    w.postMessage({ start: true, ms });\n    return () => {\n      w.postMessage({ stop: true });\n      w.terminate();\n    };\n  } catch {\n    return null;\n  }\n}\n\nexport const systemClock: Clock = {\n  now: () => (typeof performance !== \"undefined\" ? performance.now() : Date.now()),\n  setInterval(fn, ms) {\n    const w = workerInterval(fn, ms);\n    if (w) return w;\n    const h = setInterval(fn, ms);\n    return () => clearInterval(h);\n  },\n  setTimeout(fn, ms) {\n    const h = setTimeout(fn, ms);\n    return () => clearTimeout(h);\n  },\n};\n"]}

package/dist/codec.d.ts

@@ -0,0 +1,141 @@
+/**
+ * Binary codec for the peer data channels (DESIGN s.8). Little-endian, one message per frame,
+ * 3-byte header `type:u8, route:u16`. Pure functions; no I/O.
+ */
+export declare const MAX_FRAME_BYTES: number;
+/** Cap on one reassembled chunk set (spec/binary.md "Snapshot and chunks"). */
+export declare const MAX_REASSEMBLED_BYTES: number;
+export declare const HEADER_BYTES = 3;
+export declare const PROTO = 1;
+export declare const MsgType: {
+    readonly hi: 1;
+    readonly welcome_dc: 2;
+    readonly cmd: 16;
+    readonly frame: 17;
+    readonly hash: 18;
+    readonly desync: 19;
+    readonly snapshot_req: 20;
+    readonly snapshot: 21;
+    readonly chunk: 22;
+    readonly raw: 32;
+    readonly ping: 48;
+    readonly pong: 49;
+    readonly host_claim: 64;
+    readonly voice: 80;
+    readonly chat: 96;
+    readonly chat_history: 97;
+    readonly chat_reject: 98;
+};
+/** welcome_dc.mode: 1 = lockstep, 2 = raw (0 reserved) per spec/binary.md. */
+export declare const MODE_LOCKSTEP = 1;
+export declare const MODE_RAW = 2;
+export type CodecErrorCode = "too_short" | "trailing" | "too_long" | "bad_utf8" | "bad_value";
+export declare class CodecError extends Error {
+    code: CodecErrorCode;
+    constructor(code: CodecErrorCode, detail?: string);
+}
+export interface FrameCommand {
+    peerId: number;
+    bytes: Uint8Array;
+}
+export interface ChatLine {
+    peerId: number;
+    id: number;
+    ts: number;
+    text: string;
+}
+export type Message = {
+    type: "hi";
+    proto: number;
+    peerId: number;
+    lastTick: number;
+} | {
+    type: "welcome_dc";
+    tick: number;
+    tickRate: number;
+    mode: number;
+    hostId: number;
+} | {
+    type: "cmd";
+    seq: number;
+    bytes: Uint8Array;
+} | {
+    type: "frame";
+    tick: number;
+    commands: FrameCommand[];
+} | {
+    type: "hash";
+    tick: number;
+    hash: bigint;
+} | {
+    type: "desync";
+    tick: number;
+    hostHash: bigint;
+    yourHash: bigint;
+} | {
+    type: "snapshot_req";
+    sinceTick: number;
+} | {
+    type: "snapshot";
+    tick: number;
+    total: number;
+    flags: number;
+} | {
+    type: "chunk";
+    id: number;
+    index: number;
+    count: number;
+    bytes: Uint8Array;
+} | {
+    type: "raw";
+    bytes: Uint8Array;
+} | {
+    type: "ping";
+    n: number;
+    t: number;
+} | {
+    type: "pong";
+    n: number;
+    t: number;
+} | {
+    type: "host_claim";
+    epoch: number;
+    hostId: number;
+    tick: number;
+} | {
+    type: "voice";
+    seq: number;
+    flags: number;
+    frames: Uint8Array[];
+} | {
+    type: "chat";
+    id: number;
+    ts: number;
+    text: string;
+} | {
+    type: "chat_history";
+    lines: ChatLine[];
+} | {
+    type: "chat_reject";
+    id: number;
+    reason: number;
+};
+export interface Decoded {
+    route: number;
+    msg: Message;
+}
+export declare function encodeMessage(msg: Message, route?: number, allowOversize?: boolean): Uint8Array;
+/**
+ * Decode one frame. Returns null for unknown types (ignored for forward compatibility); throws on a truncated body.
+ * A frame reassembled from chunks passes `reassembled` so the cap is MAX_REASSEMBLED_BYTES instead of one frame's.
+ */
+export declare function decodeMessage(buf: Uint8Array, reassembled?: boolean): Decoded | null;
+/** Rewrite the route field on a copy (the host does this when relaying). */
+export declare function withRoute(buf: Uint8Array, route: number): Uint8Array;
+export declare const CHAT_REJECT: {
+    readonly rate: 1;
+    readonly length: 2;
+    readonly mutedByHost: 3;
+};
+export type ChatRejectReason = "rate" | "length" | "muted_by_host" | "unknown";
+export declare function chatRejectName(code: number): ChatRejectReason;