twinwire 0.0.0-stage → 1.0.0

package/dist/core/protocol.d.ts

@@ -0,0 +1,52 @@
+/** Versioned binary frames. All integer fields are little-endian. */
+export declare const VERSION = 3;
+export declare const HEADER_BYTES = 22;
+/** A payload this size or smaller fits one datagram on any path we target (no SCTP/IP fragmentation). */
+export declare const MTU_STATE_BYTES: number;
+/** Hard protocol ceiling for one frame. Endpoints choose a lower `maxStateBytes`. */
+export declare const MAX_FRAME_BYTES: number;
+export declare const MAX_STATE_BYTES: number;
+export declare const DEFAULT_STATE_BYTES: number;
+/** Upper bound of one JSON control/event message on the WebSocket. */
+export declare const MAX_CONTROL_BYTES: number;
+/** Kept for API compatibility: the largest datagram that avoids fragmentation. */
+export declare const MAX_DATAGRAM_BYTES = 1100;
+/**
+ * state: latest-wins application bytes. stateAcked: the same, and the receiver reports the newest seq it saw (kind sack).
+ * probe/reply: datagram liveness. events: reliable events mirrored on the datagram path (seq field = receiver ack).
+ */
+export declare const FrameKind: {
+    readonly state: 1;
+    readonly probe: 2;
+    readonly reply: 3;
+    readonly events: 4;
+    readonly sack: 5;
+    readonly stateAcked: 6;
+};
+export type FrameKind = typeof FrameKind[keyof typeof FrameKind];
+export type Json = null | boolean | number | string | Json[] | {
+    [key: string]: Json;
+};
+export interface Frame {
+    kind: FrameKind;
+    epoch: number;
+    stream: number;
+    seq: number;
+    time: number;
+    payload: Uint8Array;
+}
+export declare const isUint: (v: unknown, max?: number) => v is number;
+export declare function encodeFrame(f: Frame): Uint8Array;
+export declare function decodeFrame(b: Uint8Array, maxBytes?: number): Frame | null;
+/** RFC-1982-style comparison. Live windows must be smaller than half the sequence space. */
+export declare function newer(a: number, b: number): boolean;
+export declare function record(value: unknown): value is Record<string, unknown>;
+export declare const utf8: (s: string) => Uint8Array<ArrayBufferLike>;
+export declare const fromUtf8: (b: Uint8Array) => string;
+/** UTF-8 byte length without allocating. */
+export declare function utf8Length(s: string): number;
+export declare function readControl(raw: string, maxBytes?: number): Record<string, unknown> | null;
+/** Standard JSON semantics, as games expect from JSON.stringify: undefined, functions and symbols inside objects are
+ * left out (null in arrays) and NaN/Infinity become null. A top-level value that isn't JSON, a BigInt or an oversized
+ * result throws. */
+export declare function stringify(value: unknown, maxBytes?: number): string;

package/dist/core/protocol.js

@@ -0,0 +1,100 @@
+/** Versioned binary frames. All integer fields are little-endian. */
+export const VERSION = 3;
+export const HEADER_BYTES = 22;
+/** A payload this size or smaller fits one datagram on any path we target (no SCTP/IP fragmentation). */
+export const MTU_STATE_BYTES = 1100 - HEADER_BYTES;
+/** Hard protocol ceiling for one frame. Endpoints choose a lower `maxStateBytes`. */
+export const MAX_FRAME_BYTES = 256 * 1024;
+export const MAX_STATE_BYTES = MAX_FRAME_BYTES - HEADER_BYTES;
+export const DEFAULT_STATE_BYTES = 64 * 1024;
+/** Upper bound of one JSON control/event message on the WebSocket. */
+export const MAX_CONTROL_BYTES = 128 * 1024;
+/** Kept for API compatibility: the largest datagram that avoids fragmentation. */
+export const MAX_DATAGRAM_BYTES = 1100;
+const MAGIC = 0x5754; // "TW"
+/**
+ * state: latest-wins application bytes. stateAcked: the same, and the receiver reports the newest seq it saw (kind sack).
+ * probe/reply: datagram liveness. events: reliable events mirrored on the datagram path (seq field = receiver ack).
+ */
+export const FrameKind = { state: 1, probe: 2, reply: 3, events: 4, sack: 5, stateAcked: 6 };
+const KINDS = new Set(Object.values(FrameKind));
+export const isUint = (v, max = 0xffffffff) => typeof v === 'number' && Number.isInteger(v) && v >= 0 && v <= max;
+const empty = (k) => k === FrameKind.probe || k === FrameKind.reply;
+const streamed = (k) => k === FrameKind.state || k === FrameKind.stateAcked;
+export function encodeFrame(f) {
+    if (!KINDS.has(f.kind) || !isUint(f.epoch) || !f.epoch || !isUint(f.stream, 65535) ||
+        !isUint(f.seq) || !Number.isFinite(f.time) || f.payload.length > MAX_STATE_BYTES ||
+        (empty(f.kind) && f.payload.length !== 0) || (!streamed(f.kind) && f.stream !== 0))
+        throw new RangeError('Invalid frame');
+    const b = new Uint8Array(HEADER_BYTES + f.payload.length), v = new DataView(b.buffer);
+    v.setUint16(0, MAGIC, true);
+    v.setUint8(2, VERSION);
+    v.setUint8(3, f.kind);
+    v.setUint32(4, f.epoch, true);
+    v.setUint16(8, f.stream, true);
+    v.setUint32(10, f.seq, true);
+    v.setFloat64(14, f.time, true);
+    b.set(f.payload, HEADER_BYTES);
+    return b;
+}
+export function decodeFrame(b, maxBytes = MAX_FRAME_BYTES) {
+    if (b.byteLength < HEADER_BYTES || b.byteLength > Math.min(maxBytes, MAX_FRAME_BYTES))
+        return null;
+    const v = new DataView(b.buffer, b.byteOffset, b.byteLength);
+    if (v.getUint16(0, true) !== MAGIC || v.getUint8(2) !== VERSION)
+        return null;
+    const kind = v.getUint8(3), epoch = v.getUint32(4, true), time = v.getFloat64(14, true), stream = v.getUint16(8, true);
+    if (!KINDS.has(kind) || !epoch || !Number.isFinite(time) ||
+        (empty(kind) && b.byteLength !== HEADER_BYTES) || (!streamed(kind) && stream !== 0))
+        return null;
+    return { kind: kind, epoch, stream, seq: v.getUint32(10, true), time, payload: b.slice(HEADER_BYTES) };
+}
+/** RFC-1982-style comparison. Live windows must be smaller than half the sequence space. */
+export function newer(a, b) { return a !== b && ((a - b) >>> 0) < 0x80000000; }
+export function record(value) {
+    return value !== null && typeof value === 'object' && !Array.isArray(value);
+}
+const encoder = new TextEncoder(), decoder = new TextDecoder();
+export const utf8 = (s) => encoder.encode(s);
+export const fromUtf8 = (b) => decoder.decode(b);
+/** UTF-8 byte length without allocating. */
+export function utf8Length(s) {
+    let n = 0;
+    for (let i = 0; i < s.length; i++) {
+        const c = s.charCodeAt(i);
+        if (c < 0x80)
+            n += 1;
+        else if (c < 0x800)
+            n += 2;
+        else if (c >= 0xd800 && c <= 0xdbff && i + 1 < s.length) {
+            n += 4;
+            i++;
+        }
+        else
+            n += 3;
+    }
+    return n;
+}
+export function readControl(raw, maxBytes = MAX_CONTROL_BYTES) {
+    if (raw.length > maxBytes || utf8Length(raw) > maxBytes)
+        return null;
+    try {
+        const m = JSON.parse(raw);
+        return record(m) && typeof m.t === 'string' ? m : null;
+    }
+    catch {
+        return null;
+    }
+}
+/** Standard JSON semantics, as games expect from JSON.stringify: undefined, functions and symbols inside objects are
+ * left out (null in arrays) and NaN/Infinity become null. A top-level value that isn't JSON, a BigInt or an oversized
+ * result throws. */
+export function stringify(value, maxBytes = MAX_CONTROL_BYTES) {
+    const s = JSON.stringify(value);
+    if (s === undefined)
+        throw new TypeError('Value is not JSON');
+    if (utf8Length(s) > maxBytes)
+        throw new RangeError('Control frame too large');
+    return s;
+}
+//# sourceMappingURL=protocol.js.map

package/dist/core/protocol.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"protocol.js","sourceRoot":"","sources":["../../src/core/protocol.ts"],"names":[],"mappings":"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"}

package/dist/core/reliable.d.ts

@@ -0,0 +1,52 @@
+import { type Json } from './protocol.js';
+export interface PendingEvent {
+    seq: number;
+    data: Json;
+    bytes: number;
+    text: string;
+    datagramAt: number;
+    datagramTries: number;
+}
+export interface ReliableCheckpoint {
+    next: number;
+    received: number;
+    acknowledged: number;
+    pending: {
+        seq: number;
+        data: Json;
+    }[];
+}
+export interface ReliableOptions {
+    maxEvents?: number;
+    maxBytes?: number;
+    maxEventBytes?: number;
+    maxEarly?: number;
+}
+/** Ordered event delivery with replay/deduplication within a retained logical session.
+ * Copies may arrive on two paths (WebSocket and datagrams), so early events wait in a bounded buffer.
+ * An ACK means the synchronous receiver accepted the event, NOT that a database transaction committed. */
+export declare class ReliableEvents {
+    private next;
+    received: number;
+    acknowledged: number;
+    private highestSent;
+    private bytes;
+    private pending;
+    private early;
+    readonly maxEvents: number;
+    readonly maxBytes: number;
+    readonly maxEventBytes: number;
+    readonly maxEarly: number;
+    constructor(o?: ReliableOptions | number, maxBytes?: number);
+    push(data: Json): number;
+    get size(): number;
+    get queuedBytes(): number;
+    get sentThrough(): number;
+    entries(): IterableIterator<PendingEvent>;
+    sent(seq: number): void;
+    ack(seq: number): boolean;
+    /** Returns how many events were delivered. Early events wait (bounded); duplicates are dropped. */
+    receive(seq: number, data: Json, deliver: (data: Json, seq: number) => void): number;
+    checkpoint(): ReliableCheckpoint;
+    restore(s: ReliableCheckpoint): void;
+}

package/dist/core/reliable.js

@@ -0,0 +1,116 @@
+import { stringify, utf8Length } from './protocol.js';
+/** Ordered event delivery with replay/deduplication within a retained logical session.
+ * Copies may arrive on two paths (WebSocket and datagrams), so early events wait in a bounded buffer.
+ * An ACK means the synchronous receiver accepted the event, NOT that a database transaction committed. */
+export class ReliableEvents {
+    next = 1;
+    received = 0;
+    acknowledged = 0;
+    highestSent = 0;
+    bytes = 0;
+    pending = new Map();
+    early = new Map();
+    maxEvents;
+    maxBytes;
+    maxEventBytes;
+    maxEarly;
+    constructor(o = {}, maxBytes) {
+        const opts = typeof o === 'number' ? { maxEvents: o, maxBytes } : o;
+        this.maxEvents = opts.maxEvents ?? 512;
+        this.maxBytes = opts.maxBytes ?? 1024 * 1024;
+        this.maxEventBytes = opts.maxEventBytes ?? 64 * 1024;
+        this.maxEarly = opts.maxEarly ?? 256;
+        if (![this.maxEvents, this.maxBytes, this.maxEventBytes, this.maxEarly].every(v => Number.isInteger(v) && v > 0))
+            throw new RangeError('Invalid event limits');
+    }
+    push(data) {
+        const text = stringify(data, this.maxEventBytes), bytes = utf8Length(text) + 64;
+        if (bytes > this.maxEventBytes + 64)
+            throw new RangeError('Event payload too large');
+        if (this.pending.size >= this.maxEvents || this.bytes + bytes > this.maxBytes)
+            throw new Error('Reliable outbox full');
+        if (!Number.isSafeInteger(this.next + 1))
+            throw new Error('Reliable sequence exhausted');
+        const seq = this.next++;
+        this.pending.set(seq, { seq, data: JSON.parse(text), bytes, text, datagramAt: -Infinity, datagramTries: 0 });
+        this.bytes += bytes;
+        return seq;
+    }
+    get size() { return this.pending.size; }
+    get queuedBytes() { return this.bytes; }
+    get sentThrough() { return this.highestSent; }
+    entries() { return this.pending.values(); }
+    sent(seq) { this.highestSent = Math.max(this.highestSent, seq); }
+    ack(seq) {
+        if (!Number.isSafeInteger(seq) || seq < 0 || seq > this.highestSent)
+            throw new Error('Invalid event acknowledgement');
+        if (seq <= this.acknowledged)
+            return false;
+        this.acknowledged = seq;
+        for (const [id, e] of this.pending) {
+            if (id > seq)
+                break;
+            this.pending.delete(id);
+            this.bytes -= e.bytes;
+        }
+        return true;
+    }
+    /** Returns how many events were delivered. Early events wait (bounded); duplicates are dropped. */
+    receive(seq, data, deliver) {
+        if (!Number.isSafeInteger(seq) || seq < 1)
+            throw new Error('Invalid event sequence');
+        if (seq <= this.received)
+            return 0;
+        if (seq !== this.received + 1) {
+            if (seq - this.received > this.maxEarly)
+                throw new Error('Event sequence gap');
+            if (!this.early.has(seq))
+                this.early.set(seq, data);
+            return 0;
+        }
+        deliver(data, seq);
+        this.received = seq;
+        let n = 1;
+        for (let s = seq + 1; this.early.has(s); s++) {
+            deliver(this.early.get(s), s);
+            this.early.delete(s);
+            this.received = s;
+            n++;
+        }
+        for (const s of this.early.keys())
+            if (s <= this.received)
+                this.early.delete(s);
+        return n;
+    }
+    checkpoint() {
+        return { next: this.next, received: this.received, acknowledged: this.acknowledged,
+            pending: Array.from(this.pending.values(), e => ({ seq: e.seq, data: structuredClone(e.data) })) };
+    }
+    restore(s) {
+        if (this.next !== 1 || this.received || this.pending.size)
+            throw new Error('Restore requires a fresh channel');
+        if (![s.next, s.received, s.acknowledged].every(v => Number.isSafeInteger(v) && v >= 0) ||
+            s.next < 1 || s.acknowledged >= s.next || !Array.isArray(s.pending) || s.pending.length > this.maxEvents)
+            throw new Error('Invalid checkpoint');
+        if (s.pending.length !== s.next - s.acknowledged - 1)
+            throw new Error('Incomplete checkpoint');
+        const saved = [];
+        let total = 0, expected = s.acknowledged + 1;
+        for (const e of s.pending) {
+            if (e.seq !== expected++)
+                throw new Error('Invalid checkpoint sequence');
+            const text = stringify(e.data, this.maxEventBytes), bytes = utf8Length(text) + 64;
+            saved.push({ seq: e.seq, data: JSON.parse(text), bytes, text, datagramAt: -Infinity, datagramTries: 0 });
+            total += bytes;
+        }
+        if (total > this.maxBytes)
+            throw new Error('Checkpoint exceeds outbox limit');
+        this.next = s.next;
+        this.received = s.received;
+        this.acknowledged = s.acknowledged;
+        this.highestSent = s.next - 1;
+        this.pending = new Map(saved.map(e => [e.seq, e]));
+        this.bytes = total;
+    }
+}
+//# sourceMappingURL=reliable.js.map

package/dist/core/reliable.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"reliable.js","sourceRoot":"","sources":["../../src/core/reliable.ts"],"names":[],"mappings":"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"}

package/dist/core/rtc.d.ts

@@ -0,0 +1,28 @@
+import type { DatagramLink } from './endpoint.js';
+export type RtcSignal = {
+    kind: 'offer' | 'answer';
+    sdp: string;
+} | {
+    kind: 'candidate';
+    candidate: string;
+    mid: string;
+};
+export interface RtcCallbacks {
+    signal: (message: RtcSignal) => void;
+    open: (link: DatagramLink) => void;
+    data: (bytes: Uint8Array) => void;
+    closed: () => void;
+    error: (error: Error) => void;
+}
+export interface RtcPeer {
+    signal(message: RtcSignal): void | Promise<void>;
+    close(): void;
+}
+/** The browser's RTCIceServer shape: STUN, or TURN with credentials. */
+export interface IceServer {
+    urls: string | string[];
+    username?: string;
+    credential?: string;
+}
+export declare function validSignal(m: unknown): m is RtcSignal;
+export declare function validIceServers(v: unknown): v is IceServer[];

package/dist/core/rtc.js

@@ -0,0 +1,21 @@
+export function validSignal(m) {
+    if (!m || typeof m !== 'object')
+        return false;
+    const v = m;
+    if (v.kind === 'offer' || v.kind === 'answer')
+        return typeof v.sdp === 'string' && v.sdp.length > 0 && v.sdp.length <= 12000;
+    return v.kind === 'candidate' && typeof v.candidate === 'string' && v.candidate.length <= 1500 &&
+        typeof v.mid === 'string' && v.mid.length <= 128;
+}
+const ICE_URL = /^(stuns?|turns?):[^\s]{1,250}$/;
+export function validIceServers(v) {
+    return Array.isArray(v) && v.length <= 8 && v.every(s => {
+        if (!s || typeof s !== 'object')
+            return false;
+        const o = s, urls = Array.isArray(o.urls) ? o.urls : [o.urls];
+        return urls.length >= 1 && urls.length <= 8 && urls.every(u => typeof u === 'string' && ICE_URL.test(u)) &&
+            (o.username === undefined || typeof o.username === 'string' && o.username.length <= 256) &&
+            (o.credential === undefined || typeof o.credential === 'string' && o.credential.length <= 256);
+    });
+}
+//# sourceMappingURL=rtc.js.map

package/dist/core/rtc.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"rtc.js","sourceRoot":"","sources":["../../src/core/rtc.ts"],"names":[],"mappings":"AAYA,MAAM,UAAU,WAAW,CAAC,CAAU;IACpC,IAAI,CAAC,CAAC,IAAI,OAAO,CAAC,KAAK,QAAQ;QAAE,OAAO,KAAK,CAAC;IAC9C,MAAM,CAAC,GAAG,CAA4B,CAAC;IACvC,IAAI,CAAC,CAAC,IAAI,KAAK,OAAO,IAAI,CAAC,CAAC,IAAI,KAAK,QAAQ;QAAE,OAAO,OAAO,CAAC,CAAC,GAAG,KAAK,QAAQ,IAAI,CAAC,CAAC,GAAG,CAAC,MAAM,GAAG,CAAC,IAAI,CAAC,CAAC,GAAG,CAAC,MAAM,IAAI,KAAK,CAAC;IAC7H,OAAO,CAAC,CAAC,IAAI,KAAK,WAAW,IAAI,OAAO,CAAC,CAAC,SAAS,KAAK,QAAQ,IAAI,CAAC,CAAC,SAAS,CAAC,MAAM,IAAI,IAAI;QAC5F,OAAO,CAAC,CAAC,GAAG,KAAK,QAAQ,IAAI,CAAC,CAAC,GAAG,CAAC,MAAM,IAAI,GAAG,CAAC;AACrD,CAAC;AACD,MAAM,OAAO,GAAG,gCAAgC,CAAC;AACjD,MAAM,UAAU,eAAe,CAAC,CAAU;IACxC,OAAO,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,MAAM,IAAI,CAAC,IAAI,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE;QACtD,IAAI,CAAC,CAAC,IAAI,OAAO,CAAC,KAAK,QAAQ;YAAE,OAAO,KAAK,CAAC;QAC9C,MAAM,CAAC,GAAG,CAA4B,EAAE,IAAI,GAAG,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC;QACzF,OAAO,IAAI,CAAC,MAAM,IAAI,CAAC,IAAI,IAAI,CAAC,MAAM,IAAI,CAAC,IAAI,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,CAAC,OAAO,CAAC,KAAK,QAAQ,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;YACtG,CAAC,CAAC,CAAC,QAAQ,KAAK,SAAS,IAAI,OAAO,CAAC,CAAC,QAAQ,KAAK,QAAQ,IAAI,CAAC,CAAC,QAAQ,CAAC,MAAM,IAAI,GAAG,CAAC;YACxF,CAAC,CAAC,CAAC,UAAU,KAAK,SAAS,IAAI,OAAO,CAAC,CAAC,UAAU,KAAK,QAAQ,IAAI,CAAC,CAAC,UAAU,CAAC,MAAM,IAAI,GAAG,CAAC,CAAC;IACnG,CAAC,CAAC,CAAC;AACL,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,6 @@
+export * from './core/endpoint.js';
+export * from './core/protocol.js';
+export * from './core/budget.js';
+export * from './core/reliable.js';
+export * from './core/rtc.js';
+export * from './core/lobby.js';

package/dist/index.js

@@ -0,0 +1,7 @@
+export * from './core/endpoint.js';
+export * from './core/protocol.js';
+export * from './core/budget.js';
+export * from './core/reliable.js';
+export * from './core/rtc.js';
+export * from './core/lobby.js';
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,oBAAoB,CAAC;AACnC,cAAc,oBAAoB,CAAC;AACnC,cAAc,kBAAkB,CAAC;AACjC,cAAc,oBAAoB,CAAC;AACnC,cAAc,eAAe,CAAC;AAC9B,cAAc,iBAAiB,CAAC"}

package/dist/netcode/clock.d.ts

@@ -0,0 +1,15 @@
+/** Offset estimator using low-RTT exchanges. RTT/2 is NOT a measured one-way latency. */
+export declare class NetworkClock {
+    private samples;
+    private offset;
+    private target;
+    private initialized;
+    private last;
+    get synced(): boolean;
+    rttMs: number;
+    uncertaintyMs: number;
+    reset(): void;
+    observe(sent: number, received: number, remoteTime: number): boolean;
+    advance(dtMs: number): void;
+    serverTime(localTime: number): number;
+}

package/dist/netcode/clock.js

@@ -0,0 +1,37 @@
+/** Offset estimator using low-RTT exchanges. RTT/2 is NOT a measured one-way latency. */
+export class NetworkClock {
+    samples = [];
+    offset = 0;
+    target = 0;
+    initialized = false;
+    last = -Infinity;
+    get synced() { return this.initialized; }
+    rttMs = 0;
+    uncertaintyMs = Infinity;
+    reset() { this.samples = []; this.offset = this.target = 0; this.initialized = false; this.last = -Infinity; this.uncertaintyMs = Infinity; }
+    observe(sent, received, remoteTime) {
+        const rtt = received - sent;
+        if (![sent, received, remoteTime].every(Number.isFinite) || rtt < 0 || rtt > 15000)
+            return false;
+        this.samples.push({ rtt, offset: remoteTime - (sent + received) / 2 });
+        if (this.samples.length > 16)
+            this.samples.shift();
+        const best = [...this.samples].sort((a, b) => a.rtt - b.rtt).slice(0, 3);
+        this.target = best.reduce((sum, s) => sum + s.offset, 0) / best.length;
+        this.rttMs = best[0].rtt;
+        this.uncertaintyMs = Math.max(...best.map(s => Math.abs(s.offset - this.target) + s.rtt / 2));
+        if (!this.initialized) {
+            this.offset = this.target;
+            this.initialized = true;
+        }
+        return true;
+    }
+    advance(dtMs) {
+        if (!Number.isFinite(dtMs) || dtMs < 0)
+            throw new RangeError('Invalid time step');
+        const max = dtMs * 0.05;
+        this.offset += Math.max(-max, Math.min(max, this.target - this.offset));
+    }
+    serverTime(localTime) { this.last = Math.max(this.last, localTime + this.offset); return this.last; }
+}
+//# sourceMappingURL=clock.js.map

package/dist/netcode/clock.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"clock.js","sourceRoot":"","sources":["../../src/netcode/clock.ts"],"names":[],"mappings":"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"}

package/dist/netcode/codec.d.ts

@@ -0,0 +1,10 @@
+export type Scalar = 'u8' | 'i8' | 'u16' | 'i16' | 'u32' | 'f32' | 'f64';
+export interface Field {
+    type: Scalar;
+    scale?: number;
+}
+export declare function defineSchema<F extends Record<string, Field>>(schema: F): {
+    byteLength: number;
+    encode(value: { [K in keyof F]: number; }): Uint8Array;
+    decode(b: Uint8Array): { [K in keyof F]: number; } | null;
+};

package/dist/netcode/codec.js

@@ -0,0 +1,95 @@
+const sizes = { u8: 1, i8: 1, u16: 2, i16: 2, u32: 4, f32: 4, f64: 8 };
+const bounds = {
+    u8: [0, 255], i8: [-128, 127], u16: [0, 65535], i16: [-32768, 32767], u32: [0, 4294967295],
+    f32: [-3.4028234663852886e38, 3.4028234663852886e38], f64: [-Number.MAX_VALUE, Number.MAX_VALUE],
+};
+export function defineSchema(schema) {
+    const fields = Object.entries(schema).map(([key, f]) => ({ key, type: f.type, scale: f.scale ?? 1 }));
+    for (const f of fields)
+        if (!Object.hasOwn(sizes, f.type) || !(f.scale > 0) || !Number.isFinite(f.scale) || ['__proto__', 'prototype', 'constructor'].includes(f.key))
+            throw new RangeError('Invalid field');
+    const byteLength = fields.reduce((n, f) => n + sizes[f.type], 0);
+    if (!byteLength || byteLength > 1078)
+        throw new RangeError('Schema must fit one state payload');
+    return {
+        byteLength,
+        encode(value) {
+            const b = new Uint8Array(byteLength), v = new DataView(b.buffer);
+            let at = 0;
+            for (const f of fields) {
+                const source = value[f.key];
+                if (!Number.isFinite(source))
+                    throw new RangeError(`Invalid ${f.key}`);
+                let n = source * f.scale;
+                if (!f.type.startsWith('f'))
+                    n = Math.round(n);
+                const [min, max] = bounds[f.type];
+                if (!Number.isFinite(n) || n < min || n > max)
+                    throw new RangeError(`Out of range: ${f.key}`);
+                switch (f.type) {
+                    case 'u8':
+                        v.setUint8(at, n);
+                        break;
+                    case 'i8':
+                        v.setInt8(at, n);
+                        break;
+                    case 'u16':
+                        v.setUint16(at, n, true);
+                        break;
+                    case 'i16':
+                        v.setInt16(at, n, true);
+                        break;
+                    case 'u32':
+                        v.setUint32(at, n, true);
+                        break;
+                    case 'f32':
+                        v.setFloat32(at, n, true);
+                        break;
+                    case 'f64':
+                        v.setFloat64(at, n, true);
+                        break;
+                }
+                at += sizes[f.type];
+            }
+            return b;
+        },
+        decode(b) {
+            if (b.length !== byteLength)
+                return null;
+            const v = new DataView(b.buffer, b.byteOffset, b.byteLength), out = Object.create(null);
+            let at = 0;
+            for (const f of fields) {
+                let n;
+                switch (f.type) {
+                    case 'u8':
+                        n = v.getUint8(at);
+                        break;
+                    case 'i8':
+                        n = v.getInt8(at);
+                        break;
+                    case 'u16':
+                        n = v.getUint16(at, true);
+                        break;
+                    case 'i16':
+                        n = v.getInt16(at, true);
+                        break;
+                    case 'u32':
+                        n = v.getUint32(at, true);
+                        break;
+                    case 'f32':
+                        n = v.getFloat32(at, true);
+                        break;
+                    case 'f64':
+                        n = v.getFloat64(at, true);
+                        break;
+                }
+                if (!Number.isFinite(n) || !Number.isFinite(n / f.scale))
+                    return null;
+                out[f.key] = n / f.scale;
+                at += sizes[f.type];
+            }
+            return out;
+        },
+    };
+}
+//# sourceMappingURL=codec.js.map

package/dist/netcode/codec.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"codec.js","sourceRoot":"","sources":["../../src/netcode/codec.ts"],"names":[],"mappings":"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"}

package/dist/netcode/index.d.ts

@@ -0,0 +1,9 @@
+export * from './clock.js';
+export * from './timing.js';
+export * from './interpolation.js';
+export * from './prediction.js';
+export * from './spatial.js';
+export * from './codec.js';
+export * from './replication.js';
+export * from './inputs.js';
+export * from './snapshots.js';

package/dist/netcode/index.js

@@ -0,0 +1,10 @@
+export * from './clock.js';
+export * from './timing.js';
+export * from './interpolation.js';
+export * from './prediction.js';
+export * from './spatial.js';
+export * from './codec.js';
+export * from './replication.js';
+export * from './inputs.js';
+export * from './snapshots.js';
+//# sourceMappingURL=index.js.map

package/dist/netcode/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/netcode/index.ts"],"names":[],"mappings":"AAAA,cAAc,YAAY,CAAC;AAC3B,cAAc,aAAa,CAAC;AAC5B,cAAc,oBAAoB,CAAC;AACnC,cAAc,iBAAiB,CAAC;AAChC,cAAc,cAAc,CAAC;AAC7B,cAAc,YAAY,CAAC;AAC3B,cAAc,kBAAkB,CAAC;AACjC,cAAc,aAAa,CAAC;AAC5B,cAAc,gBAAgB,CAAC"}

package/dist/netcode/inputs.d.ts

@@ -0,0 +1,7 @@
+export interface BinaryInput {
+    seq: number;
+    data: Uint8Array;
+}
+/** Bundle recent inputs as redundancy without enabling retransmission of stale movement. */
+export declare function encodeInputs(inputs: readonly BinaryInput[]): Uint8Array;
+export declare function decodeInputs(b: Uint8Array): BinaryInput[] | null;