onelobby 0.0.0-stage → 0.2.0

package/dist/codec.js

@@ -0,0 +1,308 @@
+/**
+ * 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 const MAX_FRAME_BYTES = 16 * 1024;
+/** Cap on one reassembled chunk set (spec/binary.md "Snapshot and chunks"). */
+export const MAX_REASSEMBLED_BYTES = 64 * 1024 * 1024;
+export const HEADER_BYTES = 3;
+export const PROTO = 1;
+export const MsgType = {
+    hi: 0x01,
+    welcome_dc: 0x02,
+    cmd: 0x10,
+    frame: 0x11,
+    hash: 0x12,
+    desync: 0x13,
+    snapshot_req: 0x14,
+    snapshot: 0x15,
+    chunk: 0x16,
+    raw: 0x20,
+    ping: 0x30,
+    pong: 0x31,
+    host_claim: 0x40,
+    voice: 0x50,
+    chat: 0x60,
+    chat_history: 0x61,
+    chat_reject: 0x62,
+};
+/** welcome_dc.mode: 1 = lockstep, 2 = raw (0 reserved) per spec/binary.md. */
+export const MODE_LOCKSTEP = 1;
+export const MODE_RAW = 2;
+export class CodecError extends Error {
+    code;
+    constructor(code, detail = "") {
+        super(detail ? `${code}: ${detail}` : code);
+        this.code = code;
+        this.name = "CodecError";
+    }
+}
+const enc = new TextEncoder();
+const dec = new TextDecoder("utf-8", { fatal: true });
+function decodeText(b) {
+    try {
+        return dec.decode(b);
+    }
+    catch {
+        throw new CodecError("bad_utf8");
+    }
+}
+class Writer {
+    buf;
+    dv;
+    pos = 0;
+    constructor(size) {
+        this.buf = new Uint8Array(size);
+        this.dv = new DataView(this.buf.buffer);
+    }
+    ensure(n) {
+        if (this.pos + n <= this.buf.length)
+            return;
+        const nb = new Uint8Array(Math.max(this.buf.length * 2, this.pos + n));
+        nb.set(this.buf);
+        this.buf = nb;
+        this.dv = new DataView(nb.buffer);
+    }
+    u8(v) { this.ensure(1); this.dv.setUint8(this.pos, v); this.pos += 1; }
+    u16(v) { this.ensure(2); this.dv.setUint16(this.pos, v, true); this.pos += 2; }
+    u32(v) { this.ensure(4); this.dv.setUint32(this.pos, v >>> 0, true); this.pos += 4; }
+    i64(v) { this.ensure(8); this.dv.setBigInt64(this.pos, BigInt(v), true); this.pos += 8; }
+    u64(v) { this.ensure(8); this.dv.setBigUint64(this.pos, BigInt.asUintN(64, v), true); this.pos += 8; }
+    bytes(b) { this.ensure(b.length); this.buf.set(b, this.pos); this.pos += b.length; }
+    done() { return this.buf.slice(0, this.pos); }
+}
+class Reader {
+    buf;
+    dv;
+    pos = 0;
+    constructor(buf) {
+        this.buf = buf;
+        this.dv = new DataView(buf.buffer, buf.byteOffset, buf.byteLength);
+    }
+    need(n) { if (this.pos + n > this.buf.length)
+        throw new CodecError("too_short", "truncated frame"); }
+    u8() { this.need(1); const v = this.dv.getUint8(this.pos); this.pos += 1; return v; }
+    u16() { this.need(2); const v = this.dv.getUint16(this.pos, true); this.pos += 2; return v; }
+    u32() { this.need(4); const v = this.dv.getUint32(this.pos, true); this.pos += 4; return v; }
+    i64() { this.need(8); const v = this.dv.getBigInt64(this.pos, true); this.pos += 8; return Number(v); }
+    u64() { this.need(8); const v = this.dv.getBigUint64(this.pos, true); this.pos += 8; return v; }
+    bytes(n) { this.need(n); const v = this.buf.slice(this.pos, this.pos + n); this.pos += n; return v; }
+    rest() { const v = this.buf.slice(this.pos); this.pos = this.buf.length; return v; }
+}
+export function encodeMessage(msg, route = 0, allowOversize = false) {
+    const w = new Writer(64);
+    w.u8(MsgType[msg.type]);
+    w.u16(route);
+    switch (msg.type) {
+        case "hi":
+            w.u8(msg.proto);
+            w.u16(msg.peerId);
+            w.i64(msg.lastTick);
+            break;
+        case "welcome_dc":
+            w.i64(msg.tick);
+            w.u8(msg.tickRate);
+            w.u8(msg.mode);
+            w.u16(msg.hostId);
+            break;
+        case "cmd":
+            w.u32(msg.seq);
+            w.u16(msg.bytes.length);
+            w.bytes(msg.bytes);
+            break;
+        case "frame":
+            w.i64(msg.tick);
+            w.u16(msg.commands.length);
+            for (const c of msg.commands) {
+                w.u16(c.peerId);
+                w.u16(c.bytes.length);
+                w.bytes(c.bytes);
+            }
+            break;
+        case "hash":
+            w.i64(msg.tick);
+            w.u64(msg.hash);
+            break;
+        case "desync":
+            w.i64(msg.tick);
+            w.u64(msg.hostHash);
+            w.u64(msg.yourHash);
+            break;
+        case "snapshot_req":
+            w.i64(msg.sinceTick);
+            break;
+        case "snapshot":
+            w.i64(msg.tick);
+            w.u32(msg.total);
+            w.u8(msg.flags);
+            break;
+        case "chunk":
+            w.u32(msg.id);
+            w.u16(msg.index);
+            w.u16(msg.count);
+            w.bytes(msg.bytes);
+            break;
+        case "raw":
+            w.bytes(msg.bytes);
+            break;
+        case "ping":
+        case "pong":
+            w.u32(msg.n);
+            w.u32(msg.t);
+            break;
+        case "host_claim":
+            w.u16(msg.epoch);
+            w.u16(msg.hostId);
+            w.i64(msg.tick);
+            break;
+        case "voice":
+            w.u16(msg.seq);
+            w.u8(msg.flags);
+            w.u8(msg.frames.length);
+            for (const f of msg.frames) {
+                w.u16(f.length);
+                w.bytes(f);
+            }
+            break;
+        case "chat": {
+            const t = enc.encode(msg.text);
+            w.u32(msg.id);
+            w.i64(msg.ts);
+            w.u16(t.length);
+            w.bytes(t);
+            break;
+        }
+        case "chat_history":
+            w.u16(msg.lines.length);
+            for (const l of msg.lines) {
+                const t = enc.encode(l.text);
+                w.u16(l.peerId);
+                w.u32(l.id);
+                w.i64(l.ts);
+                w.u16(t.length);
+                w.bytes(t);
+            }
+            break;
+        case "chat_reject":
+            w.u32(msg.id);
+            w.u8(msg.reason);
+            break;
+    }
+    const out = w.done();
+    if (!allowOversize && out.length > MAX_FRAME_BYTES)
+        throw new CodecError("too_long", `${out.length} > ${MAX_FRAME_BYTES}`);
+    return out;
+}
+const TYPE_BY_ID = new Map(Object.keys(MsgType).map((k) => [MsgType[k], k]));
+/**
+ * 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 function decodeMessage(buf, reassembled = false) {
+    const max = reassembled ? MAX_REASSEMBLED_BYTES : MAX_FRAME_BYTES;
+    if (buf.length > max)
+        throw new CodecError("too_long", `${buf.length} > ${max}`);
+    if (buf.length < HEADER_BYTES)
+        throw new CodecError("too_short", "header");
+    const r = new Reader(buf);
+    const type = TYPE_BY_ID.get(r.u8());
+    const route = r.u16();
+    if (!type)
+        return null;
+    let msg;
+    switch (type) {
+        case "hi":
+            msg = { type, proto: r.u8(), peerId: r.u16(), lastTick: r.i64() };
+            break;
+        case "welcome_dc":
+            msg = { type, tick: r.i64(), tickRate: r.u8(), mode: r.u8(), hostId: r.u16() };
+            break;
+        case "cmd": {
+            const seq = r.u32();
+            msg = { type, seq, bytes: r.bytes(r.u16()) };
+            break;
+        }
+        case "frame": {
+            const tick = r.i64();
+            const n = r.u16();
+            const commands = [];
+            for (let i = 0; i < n; i++) {
+                const peerId = r.u16();
+                commands.push({ peerId, bytes: r.bytes(r.u16()) });
+            }
+            msg = { type, tick, commands };
+            break;
+        }
+        case "hash":
+            msg = { type, tick: r.i64(), hash: r.u64() };
+            break;
+        case "desync":
+            msg = { type, tick: r.i64(), hostHash: r.u64(), yourHash: r.u64() };
+            break;
+        case "snapshot_req":
+            msg = { type, sinceTick: r.i64() };
+            break;
+        case "snapshot":
+            msg = { type, tick: r.i64(), total: r.u32(), flags: r.u8() };
+            break;
+        case "chunk":
+            msg = { type, id: r.u32(), index: r.u16(), count: r.u16(), bytes: r.rest() };
+            break;
+        case "raw":
+            msg = { type, bytes: r.rest() };
+            break;
+        case "ping":
+        case "pong":
+            msg = { type, n: r.u32(), t: r.u32() };
+            break;
+        case "host_claim":
+            msg = { type, epoch: r.u16(), hostId: r.u16(), tick: r.i64() };
+            break;
+        case "voice": {
+            const seq = r.u16();
+            const flags = r.u8();
+            const n = r.u8();
+            const frames = [];
+            for (let i = 0; i < n; i++)
+                frames.push(r.bytes(r.u16()));
+            msg = { type, seq, flags, frames };
+            break;
+        }
+        case "chat": {
+            const id = r.u32();
+            const ts = r.i64();
+            msg = { type, id, ts, text: decodeText(r.bytes(r.u16())) };
+            break;
+        }
+        case "chat_history": {
+            const n = r.u16();
+            const lines = [];
+            for (let i = 0; i < n; i++) {
+                const peerId = r.u16();
+                const id = r.u32();
+                const ts = r.i64();
+                lines.push({ peerId, id, ts, text: decodeText(r.bytes(r.u16())) });
+            }
+            msg = { type, lines };
+            break;
+        }
+        case "chat_reject":
+            msg = { type, id: r.u32(), reason: r.u8() };
+            break;
+    }
+    if (r.pos !== buf.length)
+        throw new CodecError("trailing", `${buf.length - r.pos} extra bytes`);
+    return { route, msg };
+}
+/** Rewrite the route field on a copy (the host does this when relaying). */
+export function withRoute(buf, route) {
+    const out = buf.slice();
+    out[1] = route & 0xff;
+    out[2] = (route >> 8) & 0xff;
+    return out;
+}
+export const CHAT_REJECT = { rate: 1, length: 2, mutedByHost: 3 };
+export function chatRejectName(code) {
+    return code === 1 ? "rate" : code === 2 ? "length" : code === 3 ? "muted_by_host" : "unknown";
+}
+//# sourceMappingURL=codec.js.map

package/dist/codec.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"codec.js","sourceRoot":"","sources":["../src/codec.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * Binary codec for the peer data channels (DESIGN s.8). Little-endian, one message per frame,\n * 3-byte header `type:u8, route:u16`. Pure functions; no I/O.\n */\n\nexport const MAX_FRAME_BYTES = 16 * 1024;\n/** Cap on one reassembled chunk set (spec/binary.md \"Snapshot and chunks\"). */\nexport const MAX_REASSEMBLED_BYTES = 64 * 1024 * 1024;\nexport const HEADER_BYTES = 3;\nexport const PROTO = 1;\n\nexport const MsgType = {\n  hi: 0x01,\n  welcome_dc: 0x02,\n  cmd: 0x10,\n  frame: 0x11,\n  hash: 0x12,\n  desync: 0x13,\n  snapshot_req: 0x14,\n  snapshot: 0x15,\n  chunk: 0x16,\n  raw: 0x20,\n  ping: 0x30,\n  pong: 0x31,\n  host_claim: 0x40,\n  voice: 0x50,\n  chat: 0x60,\n  chat_history: 0x61,\n  chat_reject: 0x62,\n} as const;\n\n/** welcome_dc.mode: 1 = lockstep, 2 = raw (0 reserved) per spec/binary.md. */\nexport const MODE_LOCKSTEP = 1;\nexport const MODE_RAW = 2;\n\nexport type CodecErrorCode = \"too_short\" | \"trailing\" | \"too_long\" | \"bad_utf8\" | \"bad_value\";\nexport class CodecError extends Error {\n  constructor(public code: CodecErrorCode, detail = \"\") {\n    super(detail ? `${code}: ${detail}` : code);\n    this.name = \"CodecError\";\n  }\n}\n\nexport interface FrameCommand {\n  peerId: number;\n  bytes: Uint8Array;\n}\nexport interface ChatLine {\n  peerId: number;\n  id: number;\n  ts: number;\n  text: string;\n}\n\nexport type Message =\n  | { type: \"hi\"; proto: number; peerId: number; lastTick: number }\n  | { type: \"welcome_dc\"; tick: number; tickRate: number; mode: number; hostId: number }\n  | { type: \"cmd\"; seq: number; bytes: Uint8Array }\n  | { type: \"frame\"; tick: number; commands: FrameCommand[] }\n  | { type: \"hash\"; tick: number; hash: bigint }\n  | { type: \"desync\"; tick: number; hostHash: bigint; yourHash: bigint }\n  | { type: \"snapshot_req\"; sinceTick: number }\n  | { type: \"snapshot\"; tick: number; total: number; flags: number }\n  | { type: \"chunk\"; id: number; index: number; count: number; bytes: Uint8Array }\n  | { type: \"raw\"; bytes: Uint8Array }\n  | { type: \"ping\"; n: number; t: number }\n  | { type: \"pong\"; n: number; t: number }\n  | { type: \"host_claim\"; epoch: number; hostId: number; tick: number }\n  | { type: \"voice\"; seq: number; flags: number; frames: Uint8Array[] }\n  | { type: \"chat\"; id: number; ts: number; text: string }\n  | { type: \"chat_history\"; lines: ChatLine[] }\n  | { type: \"chat_reject\"; id: number; reason: number };\n\nexport interface Decoded {\n  route: number;\n  msg: Message;\n}\n\nconst enc = new TextEncoder();\nconst dec = new TextDecoder(\"utf-8\", { fatal: true });\nfunction decodeText(b: Uint8Array): string {\n  try {\n    return dec.decode(b);\n  } catch {\n    throw new CodecError(\"bad_utf8\");\n  }\n}\n\nclass Writer {\n  buf: Uint8Array;\n  dv: DataView;\n  pos = 0;\n  constructor(size: number) {\n    this.buf = new Uint8Array(size);\n    this.dv = new DataView(this.buf.buffer);\n  }\n  ensure(n: number) {\n    if (this.pos + n <= this.buf.length) return;\n    const nb = new Uint8Array(Math.max(this.buf.length * 2, this.pos + n));\n    nb.set(this.buf);\n    this.buf = nb;\n    this.dv = new DataView(nb.buffer);\n  }\n  u8(v: number) { this.ensure(1); this.dv.setUint8(this.pos, v); this.pos += 1; }\n  u16(v: number) { this.ensure(2); this.dv.setUint16(this.pos, v, true); this.pos += 2; }\n  u32(v: number) { this.ensure(4); this.dv.setUint32(this.pos, v >>> 0, true); this.pos += 4; }\n  i64(v: number) { this.ensure(8); this.dv.setBigInt64(this.pos, BigInt(v), true); this.pos += 8; }\n  u64(v: bigint) { this.ensure(8); this.dv.setBigUint64(this.pos, BigInt.asUintN(64, v), true); this.pos += 8; }\n  bytes(b: Uint8Array) { this.ensure(b.length); this.buf.set(b, this.pos); this.pos += b.length; }\n  done(): Uint8Array { return this.buf.slice(0, this.pos); }\n}\n\nclass Reader {\n  dv: DataView;\n  pos = 0;\n  constructor(public buf: Uint8Array) {\n    this.dv = new DataView(buf.buffer, buf.byteOffset, buf.byteLength);\n  }\n  need(n: number) { if (this.pos + n > this.buf.length) throw new CodecError(\"too_short\", \"truncated frame\"); }\n  u8() { this.need(1); const v = this.dv.getUint8(this.pos); this.pos += 1; return v; }\n  u16() { this.need(2); const v = this.dv.getUint16(this.pos, true); this.pos += 2; return v; }\n  u32() { this.need(4); const v = this.dv.getUint32(this.pos, true); this.pos += 4; return v; }\n  i64() { this.need(8); const v = this.dv.getBigInt64(this.pos, true); this.pos += 8; return Number(v); }\n  u64() { this.need(8); const v = this.dv.getBigUint64(this.pos, true); this.pos += 8; return v; }\n  bytes(n: number) { this.need(n); const v = this.buf.slice(this.pos, this.pos + n); this.pos += n; return v; }\n  rest() { const v = this.buf.slice(this.pos); this.pos = this.buf.length; return v; }\n}\n\nexport function encodeMessage(msg: Message, route = 0, allowOversize = false): Uint8Array {\n  const w = new Writer(64);\n  w.u8(MsgType[msg.type]);\n  w.u16(route);\n  switch (msg.type) {\n    case \"hi\": w.u8(msg.proto); w.u16(msg.peerId); w.i64(msg.lastTick); break;\n    case \"welcome_dc\": w.i64(msg.tick); w.u8(msg.tickRate); w.u8(msg.mode); w.u16(msg.hostId); break;\n    case \"cmd\": w.u32(msg.seq); w.u16(msg.bytes.length); w.bytes(msg.bytes); break;\n    case \"frame\":\n      w.i64(msg.tick); w.u16(msg.commands.length);\n      for (const c of msg.commands) { w.u16(c.peerId); w.u16(c.bytes.length); w.bytes(c.bytes); }\n      break;\n    case \"hash\": w.i64(msg.tick); w.u64(msg.hash); break;\n    case \"desync\": w.i64(msg.tick); w.u64(msg.hostHash); w.u64(msg.yourHash); break;\n    case \"snapshot_req\": w.i64(msg.sinceTick); break;\n    case \"snapshot\": w.i64(msg.tick); w.u32(msg.total); w.u8(msg.flags); break;\n    case \"chunk\": w.u32(msg.id); w.u16(msg.index); w.u16(msg.count); w.bytes(msg.bytes); break;\n    case \"raw\": w.bytes(msg.bytes); break;\n    case \"ping\": case \"pong\": w.u32(msg.n); w.u32(msg.t); break;\n    case \"host_claim\": w.u16(msg.epoch); w.u16(msg.hostId); w.i64(msg.tick); break;\n    case \"voice\":\n      w.u16(msg.seq); w.u8(msg.flags); w.u8(msg.frames.length);\n      for (const f of msg.frames) { w.u16(f.length); w.bytes(f); }\n      break;\n    case \"chat\": { const t = enc.encode(msg.text); w.u32(msg.id); w.i64(msg.ts); w.u16(t.length); w.bytes(t); break; }\n    case \"chat_history\":\n      w.u16(msg.lines.length);\n      for (const l of msg.lines) {\n        const t = enc.encode(l.text);\n        w.u16(l.peerId); w.u32(l.id); w.i64(l.ts); w.u16(t.length); w.bytes(t);\n      }\n      break;\n    case \"chat_reject\": w.u32(msg.id); w.u8(msg.reason); break;\n  }\n  const out = w.done();\n  if (!allowOversize && out.length > MAX_FRAME_BYTES) throw new CodecError(\"too_long\", `${out.length} > ${MAX_FRAME_BYTES}`);\n  return out;\n}\n\nconst TYPE_BY_ID = new Map<number, keyof typeof MsgType>(\n  (Object.keys(MsgType) as Array<keyof typeof MsgType>).map((k) => [MsgType[k], k]),\n);\n\n/**\n * Decode one frame. Returns null for unknown types (ignored for forward compatibility); throws on a truncated body.\n * A frame reassembled from chunks passes `reassembled` so the cap is MAX_REASSEMBLED_BYTES instead of one frame's.\n */\nexport function decodeMessage(buf: Uint8Array, reassembled = false): Decoded | null {\n  const max = reassembled ? MAX_REASSEMBLED_BYTES : MAX_FRAME_BYTES;\n  if (buf.length > max) throw new CodecError(\"too_long\", `${buf.length} > ${max}`);\n  if (buf.length < HEADER_BYTES) throw new CodecError(\"too_short\", \"header\");\n  const r = new Reader(buf);\n  const type = TYPE_BY_ID.get(r.u8());\n  const route = r.u16();\n  if (!type) return null;\n  let msg: Message;\n  switch (type) {\n    case \"hi\": msg = { type, proto: r.u8(), peerId: r.u16(), lastTick: r.i64() }; break;\n    case \"welcome_dc\": msg = { type, tick: r.i64(), tickRate: r.u8(), mode: r.u8(), hostId: r.u16() }; break;\n    case \"cmd\": { const seq = r.u32(); msg = { type, seq, bytes: r.bytes(r.u16()) }; break; }\n    case \"frame\": {\n      const tick = r.i64(); const n = r.u16(); const commands: FrameCommand[] = [];\n      for (let i = 0; i < n; i++) { const peerId = r.u16(); commands.push({ peerId, bytes: r.bytes(r.u16()) }); }\n      msg = { type, tick, commands }; break;\n    }\n    case \"hash\": msg = { type, tick: r.i64(), hash: r.u64() }; break;\n    case \"desync\": msg = { type, tick: r.i64(), hostHash: r.u64(), yourHash: r.u64() }; break;\n    case \"snapshot_req\": msg = { type, sinceTick: r.i64() }; break;\n    case \"snapshot\": msg = { type, tick: r.i64(), total: r.u32(), flags: r.u8() }; break;\n    case \"chunk\": msg = { type, id: r.u32(), index: r.u16(), count: r.u16(), bytes: r.rest() }; break;\n    case \"raw\": msg = { type, bytes: r.rest() }; break;\n    case \"ping\": case \"pong\": msg = { type, n: r.u32(), t: r.u32() }; break;\n    case \"host_claim\": msg = { type, epoch: r.u16(), hostId: r.u16(), tick: r.i64() }; break;\n    case \"voice\": {\n      const seq = r.u16(); const flags = r.u8(); const n = r.u8(); const frames: Uint8Array[] = [];\n      for (let i = 0; i < n; i++) frames.push(r.bytes(r.u16()));\n      msg = { type, seq, flags, frames }; break;\n    }\n    case \"chat\": { const id = r.u32(); const ts = r.i64(); msg = { type, id, ts, text: decodeText(r.bytes(r.u16())) }; break; }\n    case \"chat_history\": {\n      const n = r.u16(); const lines: ChatLine[] = [];\n      for (let i = 0; i < n; i++) {\n        const peerId = r.u16(); const id = r.u32(); const ts = r.i64();\n        lines.push({ peerId, id, ts, text: decodeText(r.bytes(r.u16())) });\n      }\n      msg = { type, lines }; break;\n    }\n    case \"chat_reject\": msg = { type, id: r.u32(), reason: r.u8() }; break;\n  }\n  if (r.pos !== buf.length) throw new CodecError(\"trailing\", `${buf.length - r.pos} extra bytes`);\n  return { route, msg };\n}\n\n/** Rewrite the route field on a copy (the host does this when relaying). */\nexport function withRoute(buf: Uint8Array, route: number): Uint8Array {\n  const out = buf.slice();\n  out[1] = route & 0xff;\n  out[2] = (route >> 8) & 0xff;\n  return out;\n}\n\nexport const CHAT_REJECT = { rate: 1, length: 2, mutedByHost: 3 } as const;\nexport type ChatRejectReason = \"rate\" | \"length\" | \"muted_by_host\" | \"unknown\";\nexport function chatRejectName(code: number): ChatRejectReason {\n  return code === 1 ? \"rate\" : code === 2 ? \"length\" : code === 3 ? \"muted_by_host\" : \"unknown\";\n}\n"]}

package/dist/crockford.d.ts

@@ -0,0 +1,14 @@
+/** Crockford Base32 (DESIGN s.6): digits + 22 letters, no I L O U. */
+export declare const CROCKFORD_ALPHABET = "0123456789ABCDEFGHJKMNPQRSTVWXYZ";
+export declare const CODE_LENGTH = 6;
+/**
+ * Decode user input to the canonical code form (upper case, no separators, `i`/`l` -> `1`, `o` -> `0`).
+ * Returns null when the input is not a valid 6-character code.
+ */
+export declare function normalizeCode(input: string): string | null;
+/** Canonical code -> `7HQ 4K2` display form. */
+export declare function formatCode(code: string): string;
+/** Numeric value of a Crockford string (same alias rules). Throws on invalid characters. */
+export declare function decodeCrockford(input: string): bigint;
+/** Inverse of decodeCrockford, left-padded to `length` if given. */
+export declare function encodeCrockford(value: bigint, length?: number): string;

package/dist/crockford.js

@@ -0,0 +1,55 @@
+/** Crockford Base32 (DESIGN s.6): digits + 22 letters, no I L O U. */
+export const CROCKFORD_ALPHABET = "0123456789ABCDEFGHJKMNPQRSTVWXYZ";
+export const CODE_LENGTH = 6;
+/** ASCII-only uppercasing: `ß` must not fold to `SS`. */
+function asciiUpper(s) {
+    return s.replace(/[a-z]/g, (c) => c.toUpperCase());
+}
+/**
+ * Decode user input to the canonical code form (upper case, no separators, `i`/`l` -> `1`, `o` -> `0`).
+ * Returns null when the input is not a valid 6-character code.
+ */
+export function normalizeCode(input) {
+    const s = asciiUpper(input)
+        .replace(/[ \-]/g, "")
+        .replace(/[IL]/g, "1")
+        .replace(/O/g, "0");
+    if (s.length !== CODE_LENGTH)
+        return null;
+    for (const ch of s)
+        if (CROCKFORD_ALPHABET.indexOf(ch) < 0)
+            return null;
+    return s;
+}
+/** Canonical code -> `7HQ 4K2` display form. */
+export function formatCode(code) {
+    const c = normalizeCode(code) ?? code.toUpperCase();
+    return c.length === CODE_LENGTH ? `${c.slice(0, 3)} ${c.slice(3)}` : c;
+}
+/** Numeric value of a Crockford string (same alias rules). Throws on invalid characters. */
+export function decodeCrockford(input) {
+    const s = asciiUpper(input).replace(/[ \-]/g, "").replace(/[IL]/g, "1").replace(/O/g, "0");
+    let v = 0n;
+    for (const ch of s) {
+        const i = CROCKFORD_ALPHABET.indexOf(ch);
+        if (i < 0)
+            throw new Error(`invalid Crockford character '${ch}'`);
+        v = v * 32n + BigInt(i);
+    }
+    return v;
+}
+/** Inverse of decodeCrockford, left-padded to `length` if given. */
+export function encodeCrockford(value, length = 0) {
+    let s = "";
+    let v = value;
+    if (v < 0n)
+        throw new Error("negative value");
+    while (v > 0n) {
+        s = CROCKFORD_ALPHABET[Number(v % 32n)] + s;
+        v /= 32n;
+    }
+    if (s === "")
+        s = "0";
+    return s.padStart(length, "0");
+}
+//# sourceMappingURL=crockford.js.map

package/dist/crockford.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"crockford.js","sourceRoot":"","sources":["../src/crockford.ts"],"names":[],"mappings":"AAAA,sEAAsE;AACtE,MAAM,CAAC,MAAM,kBAAkB,GAAG,kCAAkC,CAAC;AACrE,MAAM,CAAC,MAAM,WAAW,GAAG,CAAC,CAAC;AAE7B,yDAAyD;AACzD,SAAS,UAAU,CAAC,CAAS;IAC3B,OAAO,CAAC,CAAC,OAAO,CAAC,QAAQ,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,WAAW,EAAE,CAAC,CAAC;AACrD,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,aAAa,CAAC,KAAa;IACzC,MAAM,CAAC,GAAG,UAAU,CAAC,KAAK,CAAC;SACxB,OAAO,CAAC,QAAQ,EAAE,EAAE,CAAC;SACrB,OAAO,CAAC,OAAO,EAAE,GAAG,CAAC;SACrB,OAAO,CAAC,IAAI,EAAE,GAAG,CAAC,CAAC;IACtB,IAAI,CAAC,CAAC,MAAM,KAAK,WAAW;QAAE,OAAO,IAAI,CAAC;IAC1C,KAAK,MAAM,EAAE,IAAI,CAAC;QAAE,IAAI,kBAAkB,CAAC,OAAO,CAAC,EAAE,CAAC,GAAG,CAAC;YAAE,OAAO,IAAI,CAAC;IACxE,OAAO,CAAC,CAAC;AACX,CAAC;AAED,gDAAgD;AAChD,MAAM,UAAU,UAAU,CAAC,IAAY;IACrC,MAAM,CAAC,GAAG,aAAa,CAAC,IAAI,CAAC,IAAI,IAAI,CAAC,WAAW,EAAE,CAAC;IACpD,OAAO,CAAC,CAAC,MAAM,KAAK,WAAW,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC;AACzE,CAAC;AAED,4FAA4F;AAC5F,MAAM,UAAU,eAAe,CAAC,KAAa;IAC3C,MAAM,CAAC,GAAG,UAAU,CAAC,KAAK,CAAC,CAAC,OAAO,CAAC,QAAQ,EAAE,EAAE,CAAC,CAAC,OAAO,CAAC,OAAO,EAAE,GAAG,CAAC,CAAC,OAAO,CAAC,IAAI,EAAE,GAAG,CAAC,CAAC;IAC3F,IAAI,CAAC,GAAG,EAAE,CAAC;IACX,KAAK,MAAM,EAAE,IAAI,CAAC,EAAE,CAAC;QACnB,MAAM,CAAC,GAAG,kBAAkB,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC;QACzC,IAAI,CAAC,GAAG,CAAC;YAAE,MAAM,IAAI,KAAK,CAAC,gCAAgC,EAAE,GAAG,CAAC,CAAC;QAClE,CAAC,GAAG,CAAC,GAAG,GAAG,GAAG,MAAM,CAAC,CAAC,CAAC,CAAC;IAC1B,CAAC;IACD,OAAO,CAAC,CAAC;AACX,CAAC;AAED,oEAAoE;AACpE,MAAM,UAAU,eAAe,CAAC,KAAa,EAAE,MAAM,GAAG,CAAC;IACvD,IAAI,CAAC,GAAG,EAAE,CAAC;IACX,IAAI,CAAC,GAAG,KAAK,CAAC;IACd,IAAI,CAAC,GAAG,EAAE;QAAE,MAAM,IAAI,KAAK,CAAC,gBAAgB,CAAC,CAAC;IAC9C,OAAO,CAAC,GAAG,EAAE,EAAE,CAAC;QACd,CAAC,GAAG,kBAAkB,CAAC,MAAM,CAAC,CAAC,GAAG,GAAG,CAAC,CAAC,GAAG,CAAC,CAAC;QAC5C,CAAC,IAAI,GAAG,CAAC;IACX,CAAC;IACD,IAAI,CAAC,KAAK,EAAE;QAAE,CAAC,GAAG,GAAG,CAAC;IACtB,OAAO,CAAC,CAAC,QAAQ,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;AACjC,CAAC","sourcesContent":["/** Crockford Base32 (DESIGN s.6): digits + 22 letters, no I L O U. */\nexport const CROCKFORD_ALPHABET = \"0123456789ABCDEFGHJKMNPQRSTVWXYZ\";\nexport const CODE_LENGTH = 6;\n\n/** ASCII-only uppercasing: `ß` must not fold to `SS`. */\nfunction asciiUpper(s: string): string {\n  return s.replace(/[a-z]/g, (c) => c.toUpperCase());\n}\n\n/**\n * Decode user input to the canonical code form (upper case, no separators, `i`/`l` -> `1`, `o` -> `0`).\n * Returns null when the input is not a valid 6-character code.\n */\nexport function normalizeCode(input: string): string | null {\n  const s = asciiUpper(input)\n    .replace(/[ \\-]/g, \"\")\n    .replace(/[IL]/g, \"1\")\n    .replace(/O/g, \"0\");\n  if (s.length !== CODE_LENGTH) return null;\n  for (const ch of s) if (CROCKFORD_ALPHABET.indexOf(ch) < 0) return null;\n  return s;\n}\n\n/** Canonical code -> `7HQ 4K2` display form. */\nexport function formatCode(code: string): string {\n  const c = normalizeCode(code) ?? code.toUpperCase();\n  return c.length === CODE_LENGTH ? `${c.slice(0, 3)} ${c.slice(3)}` : c;\n}\n\n/** Numeric value of a Crockford string (same alias rules). Throws on invalid characters. */\nexport function decodeCrockford(input: string): bigint {\n  const s = asciiUpper(input).replace(/[ \\-]/g, \"\").replace(/[IL]/g, \"1\").replace(/O/g, \"0\");\n  let v = 0n;\n  for (const ch of s) {\n    const i = CROCKFORD_ALPHABET.indexOf(ch);\n    if (i < 0) throw new Error(`invalid Crockford character '${ch}'`);\n    v = v * 32n + BigInt(i);\n  }\n  return v;\n}\n\n/** Inverse of decodeCrockford, left-padded to `length` if given. */\nexport function encodeCrockford(value: bigint, length = 0): string {\n  let s = \"\";\n  let v = value;\n  if (v < 0n) throw new Error(\"negative value\");\n  while (v > 0n) {\n    s = CROCKFORD_ALPHABET[Number(v % 32n)] + s;\n    v /= 32n;\n  }\n  if (s === \"\") s = \"0\";\n  return s.padStart(length, \"0\");\n}\n"]}

package/dist/deflate.d.ts

@@ -0,0 +1,4 @@
+/** Optional zlib deflate for snapshots (CompressionStream where present; .NET ZLibStream is the matching side). */
+export declare function deflateAvailable(): boolean;
+export declare function deflate(bytes: Uint8Array): Promise<Uint8Array>;
+export declare function inflate(bytes: Uint8Array): Promise<Uint8Array>;

package/dist/deflate.js

@@ -0,0 +1,32 @@
+/** Optional zlib deflate for snapshots (CompressionStream where present; .NET ZLibStream is the matching side). */
+export function deflateAvailable() {
+    return typeof CompressionStream !== "undefined" && typeof DecompressionStream !== "undefined";
+}
+async function pipe(bytes, stream) {
+    const w = stream.writable.getWriter();
+    void w.write(bytes).then(() => w.close());
+    const chunks = [];
+    const r = stream.readable.getReader();
+    let total = 0;
+    for (;;) {
+        const { done, value } = await r.read();
+        if (done)
+            break;
+        chunks.push(value);
+        total += value.length;
+    }
+    const out = new Uint8Array(total);
+    let pos = 0;
+    for (const c of chunks) {
+        out.set(c, pos);
+        pos += c.length;
+    }
+    return out;
+}
+export function deflate(bytes) {
+    return pipe(bytes, new CompressionStream("deflate"));
+}
+export function inflate(bytes) {
+    return pipe(bytes, new DecompressionStream("deflate"));
+}
+//# sourceMappingURL=deflate.js.map

package/dist/deflate.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"deflate.js","sourceRoot":"","sources":["../src/deflate.ts"],"names":[],"mappings":"AAAA,mHAAmH;AAEnH,MAAM,UAAU,gBAAgB;IAC9B,OAAO,OAAO,iBAAiB,KAAK,WAAW,IAAI,OAAO,mBAAmB,KAAK,WAAW,CAAC;AAChG,CAAC;AAED,KAAK,UAAU,IAAI,CAAC,KAAiB,EAAE,MAAsF;IAC3H,MAAM,CAAC,GAAG,MAAM,CAAC,QAAQ,CAAC,SAAS,EAAE,CAAC;IACtC,KAAK,CAAC,CAAC,KAAK,CAAC,KAA2C,CAAC,CAAC,IAAI,CAAC,GAAG,EAAE,CAAC,CAAC,CAAC,KAAK,EAAE,CAAC,CAAC;IAChF,MAAM,MAAM,GAAiB,EAAE,CAAC;IAChC,MAAM,CAAC,GAAG,MAAM,CAAC,QAAQ,CAAC,SAAS,EAAE,CAAC;IACtC,IAAI,KAAK,GAAG,CAAC,CAAC;IACd,SAAS,CAAC;QACR,MAAM,EAAE,IAAI,EAAE,KAAK,EAAE,GAAG,MAAM,CAAC,CAAC,IAAI,EAAE,CAAC;QACvC,IAAI,IAAI;YAAE,MAAM;QAChB,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QACnB,KAAK,IAAI,KAAK,CAAC,MAAM,CAAC;IACxB,CAAC;IACD,MAAM,GAAG,GAAG,IAAI,UAAU,CAAC,KAAK,CAAC,CAAC;IAClC,IAAI,GAAG,GAAG,CAAC,CAAC;IACZ,KAAK,MAAM,CAAC,IAAI,MAAM,EAAE,CAAC;QACvB,GAAG,CAAC,GAAG,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC;QAChB,GAAG,IAAI,CAAC,CAAC,MAAM,CAAC;IAClB,CAAC;IACD,OAAO,GAAG,CAAC;AACb,CAAC;AAED,MAAM,UAAU,OAAO,CAAC,KAAiB;IACvC,OAAO,IAAI,CAAC,KAAK,EAAE,IAAI,iBAAiB,CAAC,SAAS,CAAU,CAAC,CAAC;AAChE,CAAC;AACD,MAAM,UAAU,OAAO,CAAC,KAAiB;IACvC,OAAO,IAAI,CAAC,KAAK,EAAE,IAAI,mBAAmB,CAAC,SAAS,CAAU,CAAC,CAAC;AAClE,CAAC","sourcesContent":["/** Optional zlib deflate for snapshots (CompressionStream where present; .NET ZLibStream is the matching side). */\n\nexport function deflateAvailable(): boolean {\n  return typeof CompressionStream !== \"undefined\" && typeof DecompressionStream !== \"undefined\";\n}\n\nasync function pipe(bytes: Uint8Array, stream: { readable: ReadableStream<Uint8Array>; writable: WritableStream<Uint8Array> }) {\n  const w = stream.writable.getWriter();\n  void w.write(bytes as unknown as Uint8Array<ArrayBuffer>).then(() => w.close());\n  const chunks: Uint8Array[] = [];\n  const r = stream.readable.getReader();\n  let total = 0;\n  for (;;) {\n    const { done, value } = await r.read();\n    if (done) break;\n    chunks.push(value);\n    total += value.length;\n  }\n  const out = new Uint8Array(total);\n  let pos = 0;\n  for (const c of chunks) {\n    out.set(c, pos);\n    pos += c.length;\n  }\n  return out;\n}\n\nexport function deflate(bytes: Uint8Array): Promise<Uint8Array> {\n  return pipe(bytes, new CompressionStream(\"deflate\") as never);\n}\nexport function inflate(bytes: Uint8Array): Promise<Uint8Array> {\n  return pipe(bytes, new DecompressionStream(\"deflate\") as never);\n}\n"]}

package/dist/deprecated.d.ts

@@ -0,0 +1,18 @@
+/**
+ * Names from before the Keepalive -> OneLobby rename. They are the same classes and types, so old code keeps
+ * working unchanged; they will be removed in the next minor release.
+ */
+import { OneLobby, type OneLobbyEvents, type OneLobbyOptions } from "./onelobby.js";
+import { OneLobbyError } from "./signaling.js";
+/** @deprecated renamed to `OneLobby`; this alias goes away in the next minor release. */
+export declare const Keepalive: typeof OneLobby;
+/** @deprecated renamed to `OneLobby`. */
+export type Keepalive = OneLobby;
+/** @deprecated renamed to `OneLobbyError`; this alias goes away in the next minor release. */
+export declare const KeepaliveError: typeof OneLobbyError;
+/** @deprecated renamed to `OneLobbyError`. */
+export type KeepaliveError = OneLobbyError;
+/** @deprecated renamed to `OneLobbyOptions`. */
+export type KeepaliveOptions = OneLobbyOptions;
+/** @deprecated renamed to `OneLobbyEvents`. */
+export type KeepaliveEvents = OneLobbyEvents;

package/dist/deprecated.js

@@ -0,0 +1,11 @@
+/**
+ * Names from before the Keepalive -> OneLobby rename. They are the same classes and types, so old code keeps
+ * working unchanged; they will be removed in the next minor release.
+ */
+import { OneLobby } from "./onelobby.js";
+import { OneLobbyError } from "./signaling.js";
+/** @deprecated renamed to `OneLobby`; this alias goes away in the next minor release. */
+export const Keepalive = OneLobby;
+/** @deprecated renamed to `OneLobbyError`; this alias goes away in the next minor release. */
+export const KeepaliveError = OneLobbyError;
+//# sourceMappingURL=deprecated.js.map

package/dist/deprecated.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"deprecated.js","sourceRoot":"","sources":["../src/deprecated.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,OAAO,EAAE,QAAQ,EAA6C,MAAM,eAAe,CAAC;AACpF,OAAO,EAAE,aAAa,EAAE,MAAM,gBAAgB,CAAC;AAE/C,yFAAyF;AACzF,MAAM,CAAC,MAAM,SAAS,GAAG,QAAQ,CAAC;AAGlC,8FAA8F;AAC9F,MAAM,CAAC,MAAM,cAAc,GAAG,aAAa,CAAC","sourcesContent":["/**\n * Names from before the Keepalive -> OneLobby rename. They are the same classes and types, so old code keeps\n * working unchanged; they will be removed in the next minor release.\n */\nimport { OneLobby, type OneLobbyEvents, type OneLobbyOptions } from \"./onelobby.js\";\nimport { OneLobbyError } from \"./signaling.js\";\n\n/** @deprecated renamed to `OneLobby`; this alias goes away in the next minor release. */\nexport const Keepalive = OneLobby;\n/** @deprecated renamed to `OneLobby`. */\nexport type Keepalive = OneLobby;\n/** @deprecated renamed to `OneLobbyError`; this alias goes away in the next minor release. */\nexport const KeepaliveError = OneLobbyError;\n/** @deprecated renamed to `OneLobbyError`. */\nexport type KeepaliveError = OneLobbyError;\n/** @deprecated renamed to `OneLobbyOptions`. */\nexport type KeepaliveOptions = OneLobbyOptions;\n/** @deprecated renamed to `OneLobbyEvents`. */\nexport type KeepaliveEvents = OneLobbyEvents;\n"]}

package/dist/direct/hub-host.d.ts

@@ -0,0 +1,82 @@
+import type { SocketLike } from "../transport.js";
+import { SignalingHub, type HubDeps, type HubOptions } from "./hub.js";
+import { PortMapper, type PortMapperOptions, type PortMapResult } from "./portmap.js";
+export declare class PortInUseError extends Error {
+    readonly code = "port_in_use";
+    constructor(port: number, detail: string);
+}
+/**
+ * Runs a {@link SignalingHub} inside a Node process and listens for joiners' signaling WebSockets on TCP `port`: the
+ * Node twin of C#'s `DirectHubHost` (docs/direct-ip.md s.2, s.5 step 3). A plain `net` server with a minimal HTTP/1.1
+ * upgrade and RFC 6455 framing (text, close, ping/pong, fragments; client frames must be masked), so the package keeps
+ * zero runtime dependencies. Any path upgrades; `GET /healthz` answers `ok`. The host's own client talks to the hub in
+ * memory through {@link connectLocal}. `hub.tick()` runs once a second on an unref'd timer.
+ */
+/** One plain-HTTP answer from the host's port, e.g. a browser join page. */
+export interface HttpReply {
+    /** Default 200. */
+    status?: number;
+    /** Content-Type, e.g. "text/html; charset=utf-8". */
+    type: string;
+    body: string | Uint8Array;
+}
+/** Serves plain `GET` requests on the direct port (path without the query); null answers 404. */
+export type HttpHandler = (path: string) => HttpReply | null;
+export declare class DirectHubHost {
+    readonly hub: SignalingHub;
+    /**
+     * Plain `GET`s that are not WebSocket upgrades go here, so the host can serve its own join page: a browser opening
+     * `http://<host address>:<port>/` gets a page that joins with `kit.joinDirect(location.host)`. Null (default): 426.
+     */
+    http: HttpHandler | null;
+    /** The bound TCP port (the requested one, or the one the OS picked for 0). */
+    readonly port: number;
+    portMapper: PortMapper | null;
+    private readonly server;
+    private readonly sockets;
+    private readonly ticker;
+    private readonly maxMessageBytes;
+    private closed;
+    private constructor();
+    /**
+     * Binds TCP `port` on every interface (IPv6 dual-stack where available). Hub options default to
+     * {@link directHubOptions} (one lobby, no codes, no ICE servers). Rejects with {@link PortInUseError}.
+     */
+    static listen(port: number, options?: Partial<HubOptions>, deps?: HubDeps & {
+        host?: string;
+    }): Promise<DirectHubHost>;
+    /** Joiner sockets currently open. */
+    get connectionCount(): number;
+    /**
+     * The host's own signaling socket: a WebSocket look-alike wired straight into the hub (no network). Pass it to the
+     * kit as `advanced.socketFactory: () => host.connectLocal()`.
+     */
+    connectLocal(): SocketLike;
+    /** Asks the home router to forward TCP and UDP `port` here (UPnP, then NAT-PMP; docs/direct-ip.md s.2a). */
+    openPort(options?: PortMapperOptions): Promise<PortMapResult>;
+    /** Stops listening, closes every joiner socket and removes the router mapping. */
+    close(): Promise<void>;
+    private accept;
+    /** RFC 6455 s.4.2: answers 101 with Sec-WebSocket-Accept, or 200 for /healthz, or 400/426. */
+    private handshake;
+    private run;
+}
+/**
+ * The direct-IP host's own signaling socket (C#'s `HubSignalingSocket`): sends go straight into the hub; the hub's
+ * replies are delivered on a microtask, so callbacks never run inside the hub.
+ */
+export declare class LocalHubSocket implements SocketLike {
+    private readonly hub;
+    /** Address the hub sees for the host itself (rate limits and kicks are per address). */
+    static readonly ADDRESS = "local";
+    readyState: number;
+    onopen: SocketLike["onopen"];
+    onmessage: SocketLike["onmessage"];
+    onclose: SocketLike["onclose"];
+    onerror: SocketLike["onerror"];
+    private session;
+    constructor(hub: SignalingHub);
+    send(data: string): void;
+    close(): void;
+    private finish;
+}