twinwire 0.0.0-stage → 1.0.0

package/dist/client/lobby.js

@@ -0,0 +1,122 @@
+import { LOBBY_KEY, isLobbyMessage, normalizeCode, } from '../core/lobby.js';
+/**
+ * Rooms on top of a GameClient: create a private room with a code, join by code, quick play into a public room,
+ * ready up, and follow who is in the room. Requests ride on reliable events, so they survive reconnects.
+ */
+export class LobbyClient {
+    client;
+    requestTimeoutMs;
+    room = null;
+    onRoom = () => { };
+    /** The room was left without asking (kicked, replaced, closed, session expired). */
+    onLeft = () => { };
+    pending = new Map();
+    nextId = 1;
+    off;
+    constructor(client, requestTimeoutMs = 20000) {
+        this.client = client;
+        this.requestTimeoutMs = requestTimeoutMs;
+        this.off = [
+            client.intercept(d => {
+                if (!isLobbyMessage(d))
+                    return false;
+                this.message(d);
+                return true;
+            }),
+            client.on('session', ({ resumed }) => { if (!resumed)
+                this.drop('new session'); }),
+            client.on('lost', ({ reason }) => this.drop(reason)),
+        ];
+    }
+    dispose() { for (const f of this.off)
+        f(); this.drop('disposed', false); }
+    get me() { return this.room?.members.find(m => m.seat === this.room.you) ?? null; }
+    get isHost() { return !!this.me?.host; }
+    /** Milliseconds until the ready countdown ends, or null when none is running. */
+    countdownMs() {
+        const end = this.room?.countdownEndsAt;
+        if (end == null || !this.client.clock.synced)
+            return null;
+        return Math.max(0, end - this.client.clock.serverTime(performance.now()));
+    }
+    create(o = {}) { return this.request({ [LOBBY_KEY]: 'create', ...o }); }
+    join(code, o = {}) {
+        const c = normalizeCode(code);
+        if (!c)
+            return Promise.reject(new Error('That is not a room code'));
+        return this.request({ [LOBBY_KEY]: 'join', code: c, ...o });
+    }
+    quickPlay(o = {}) { return this.request({ [LOBBY_KEY]: 'quick', ...o }); }
+    async leave() { await this.request({ [LOBBY_KEY]: 'leave' }); this.set(null); }
+    setReady(ready) { return this.request({ [LOBBY_KEY]: 'ready', ready }); }
+    setName(name) { return this.request({ [LOBBY_KEY]: 'name', name }); }
+    setMeta(meta) { return this.request({ [LOBBY_KEY]: 'meta', meta }); }
+    kick(seat) { return this.request({ [LOBBY_KEY]: 'kick', seat }); }
+    request(body) {
+        const id = this.nextId++;
+        return new Promise((resolve, reject) => {
+            const timer = setTimeout(() => { this.pending.delete(id); reject(new Error('The room server did not answer')); }, this.requestTimeoutMs);
+            this.pending.set(id, { resolve, reject, timer });
+            try {
+                this.client.sendEvent({ ...body, id });
+            }
+            catch (e) {
+                clearTimeout(timer);
+                this.pending.delete(id);
+                reject(e instanceof Error ? e : new Error(String(e)));
+            }
+        });
+    }
+    set(room) { this.room = room; try {
+        this.onRoom(room);
+    }
+    catch { /* app callback */ } }
+    message(d) {
+        const op = d[LOBBY_KEY];
+        if (op === 'res' && typeof d.id === 'number') {
+            const p = this.pending.get(d.id);
+            if (!p)
+                return;
+            this.pending.delete(d.id);
+            clearTimeout(p.timer);
+            if (d.ok === true) {
+                const room = (d.room ?? null);
+                if (room || this.room)
+                    this.set(room);
+                p.resolve(room);
+            }
+            else
+                p.reject(new Error(typeof d.error === 'string' ? d.error : 'Request refused'));
+            return;
+        }
+        if (op === 'room' && d.room && typeof d.room === 'object') {
+            this.set(d.room);
+            return;
+        }
+        if (op === 'left') {
+            const had = !!this.room;
+            this.set(null);
+            if (had)
+                try {
+                    this.onLeft(typeof d.reason === 'string' ? d.reason : 'left');
+                }
+                catch { /* app */ }
+        }
+    }
+    drop(reason, notify = true) {
+        for (const p of this.pending.values()) {
+            clearTimeout(p.timer);
+            p.reject(new Error(reason));
+        }
+        this.pending.clear();
+        if (this.room) {
+            this.set(null);
+            if (notify)
+                try {
+                    this.onLeft(reason);
+                }
+                catch { /* app */ }
+        }
+    }
+}
+//# sourceMappingURL=lobby.js.map

package/dist/client/lobby.js.map

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

package/dist/client/rtc.d.ts

@@ -0,0 +1,17 @@
+import { type RtcCallbacks, type RtcPeer, type RtcSignal } from '../core/rtc.js';
+/** Browser adapter. Candidates are buffered until the remote description has finished applying. */
+export declare class BrowserRtcPeer implements RtcPeer {
+    private cb;
+    private pc;
+    private dc;
+    private alive;
+    private offered;
+    private remoteReady;
+    private localCandidates;
+    private remoteCandidates;
+    private chain;
+    constructor(cb: RtcCallbacks, config?: RTCConfiguration);
+    offer(): Promise<void>;
+    signal(message: RtcSignal): Promise<void>;
+    close(): void;
+}

package/dist/client/rtc.js

@@ -0,0 +1,102 @@
+import { validSignal } from '../core/rtc.js';
+/** Browser adapter. Candidates are buffered until the remote description has finished applying. */
+export class BrowserRtcPeer {
+    cb;
+    pc;
+    dc;
+    alive = true;
+    offered = false;
+    remoteReady = false;
+    localCandidates = [];
+    remoteCandidates = [];
+    chain = Promise.resolve();
+    constructor(cb, config = { iceServers: [] }) {
+        this.cb = cb;
+        this.pc = new RTCPeerConnection(config);
+        this.dc = this.pc.createDataChannel('twinwire', { negotiated: true, id: 0, ordered: false, maxRetransmits: 0 });
+        const pc = this.pc, dc = this.dc;
+        dc.binaryType = 'arraybuffer';
+        dc.onopen = () => {
+            if (this.alive)
+                cb.open({
+                    get open() { return dc.readyState === 'open'; }, get bufferedAmount() { return dc.bufferedAmount; },
+                    send(bytes) { if (dc.readyState !== 'open')
+                        return false; dc.send(bytes.slice().buffer); return true; },
+                    close: () => this.close(),
+                });
+        };
+        dc.onmessage = e => { if (this.alive && e.data instanceof ArrayBuffer)
+            cb.data(new Uint8Array(e.data)); };
+        dc.onclose = () => { if (this.alive) {
+            this.close();
+            cb.closed();
+        } };
+        dc.onerror = () => { if (this.alive)
+            cb.error(new Error('RTC data channel error')); };
+        pc.onconnectionstatechange = () => { if (this.alive && pc.connectionState === 'failed') {
+            this.close();
+            cb.closed();
+        } };
+        pc.onicecandidate = e => {
+            if (!this.alive || !e.candidate?.candidate)
+                return;
+            const m = { kind: 'candidate', candidate: e.candidate.candidate, mid: e.candidate.sdpMid ?? '0' };
+            if (this.offered)
+                cb.signal(m);
+            else if (this.localCandidates.length < 64)
+                this.localCandidates.push(m);
+        };
+    }
+    async offer() {
+        await this.pc.setLocalDescription(await this.pc.createOffer());
+        if (!this.alive)
+            return;
+        this.cb.signal({ kind: 'offer', sdp: this.pc.localDescription.sdp });
+        this.offered = true;
+        for (const c of this.localCandidates)
+            this.cb.signal(c);
+        this.localCandidates = [];
+    }
+    signal(message) {
+        this.chain = this.chain.then(async () => {
+            if (!this.alive || !validSignal(message))
+                return;
+            if (message.kind === 'answer') {
+                await this.pc.setRemoteDescription({ type: 'answer', sdp: message.sdp });
+                if (!this.alive)
+                    return;
+                this.remoteReady = true;
+                for (const c of this.remoteCandidates)
+                    await this.pc.addIceCandidate(c);
+                this.remoteCandidates = [];
+            }
+            else if (message.kind === 'candidate') {
+                const c = { candidate: message.candidate, sdpMid: message.mid };
+                if (this.remoteReady)
+                    await this.pc.addIceCandidate(c);
+                else {
+                    if (this.remoteCandidates.length >= 64)
+                        throw new Error('Too many ICE candidates');
+                    this.remoteCandidates.push(c);
+                }
+            }
+        }).catch(e => { if (this.alive)
+            this.cb.error(e instanceof Error ? e : new Error(String(e))); });
+        return this.chain;
+    }
+    close() {
+        if (!this.alive)
+            return;
+        this.alive = false;
+        this.localCandidates = [];
+        this.remoteCandidates = [];
+        this.dc.onopen = this.dc.onmessage = this.dc.onclose = this.dc.onerror = null;
+        this.pc.onicecandidate = this.pc.onconnectionstatechange = null;
+        try {
+            this.dc.close();
+            this.pc.close();
+        }
+        catch { /* no-op after disposal */ }
+    }
+}
+//# sourceMappingURL=rtc.js.map

package/dist/client/rtc.js.map

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

package/dist/core/budget.d.ts

@@ -0,0 +1,27 @@
+export declare class TokenBucket {
+    readonly rate: number;
+    readonly capacity: number;
+    private tokens;
+    private at;
+    constructor(rate: number, capacity: number, now: number);
+    available(now: number): number;
+    /** A message larger than the burst may go once the bucket is full; the debt then delays what follows. */
+    take(bytes: number, now: number): boolean;
+}
+export interface EgressEstimate {
+    payloadGB: number;
+    plannedGB: number;
+    bill: number;
+    withinBudget: boolean;
+}
+/** Planning estimate, not a bill or a hard cap. Provider prices/allowances are supplied by the caller. */
+export declare function estimateEgress(o: {
+    bytesPerSecondPerPlayer: number;
+    averagePlayers: number;
+    activeHours: number;
+    baseMonthlyUSD: number;
+    includedGB: number;
+    overageUSDPerGB: number;
+    budgetUSD?: number;
+    overheadFraction?: number;
+}): EgressEstimate;

package/dist/core/budget.js

@@ -0,0 +1,39 @@
+export class TokenBucket {
+    rate;
+    capacity;
+    tokens;
+    at;
+    constructor(rate, capacity, now) {
+        this.rate = rate;
+        this.capacity = capacity;
+        if (!(rate > 0) || !Number.isFinite(rate) || !(capacity > 0) || !Number.isFinite(capacity))
+            throw new RangeError('Invalid budget');
+        this.tokens = capacity;
+        this.at = now;
+    }
+    available(now) {
+        this.tokens = Math.min(this.capacity, this.tokens + Math.max(0, now - this.at) * this.rate / 1000);
+        this.at = Math.max(this.at, now);
+        return this.tokens;
+    }
+    /** A message larger than the burst may go once the bucket is full; the debt then delays what follows. */
+    take(bytes, now) {
+        if (!Number.isFinite(bytes) || bytes < 0)
+            throw new RangeError('Invalid byte count');
+        if (this.available(now) < Math.min(bytes, this.capacity))
+            return false;
+        this.tokens -= bytes;
+        return true;
+    }
+}
+/** Planning estimate, not a bill or a hard cap. Provider prices/allowances are supplied by the caller. */
+export function estimateEgress(o) {
+    for (const v of Object.values(o))
+        if (!Number.isFinite(v) || v < 0)
+            throw new RangeError('Invalid cost input');
+    const payloadGB = o.bytesPerSecondPerPlayer * o.averagePlayers * o.activeHours * 3600 / 1e9;
+    const plannedGB = payloadGB * (1 + (o.overheadFraction ?? 0.2));
+    const bill = o.baseMonthlyUSD + Math.max(0, plannedGB - o.includedGB) * o.overageUSDPerGB;
+    return { payloadGB, plannedGB, bill, withinBudget: bill <= (o.budgetUSD ?? 5) };
+}
+//# sourceMappingURL=budget.js.map

package/dist/core/budget.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"budget.js","sourceRoot":"","sources":["../../src/core/budget.ts"],"names":[],"mappings":"AAAA,MAAM,OAAO,WAAW;IAGD;IAAuB;IAFpC,MAAM,CAAS;IACf,EAAE,CAAS;IACnB,YAAqB,IAAY,EAAW,QAAgB,EAAE,GAAW;QAApD,SAAI,GAAJ,IAAI,CAAQ;QAAW,aAAQ,GAAR,QAAQ,CAAQ;QAC1D,IAAI,CAAC,CAAC,IAAI,GAAG,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,QAAQ,GAAG,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,QAAQ,CAAC;YAAE,MAAM,IAAI,UAAU,CAAC,gBAAgB,CAAC,CAAC;QACnI,IAAI,CAAC,MAAM,GAAG,QAAQ,CAAC;QAAC,IAAI,CAAC,EAAE,GAAG,GAAG,CAAC;IACxC,CAAC;IACD,SAAS,CAAC,GAAW;QACnB,IAAI,CAAC,MAAM,GAAG,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,QAAQ,EAAE,IAAI,CAAC,MAAM,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,GAAG,GAAG,IAAI,CAAC,EAAE,CAAC,GAAG,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC,CAAC;QACnG,IAAI,CAAC,EAAE,GAAG,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,EAAE,GAAG,CAAC,CAAC;QAAC,OAAO,IAAI,CAAC,MAAM,CAAC;IACvD,CAAC;IACD,yGAAyG;IACzG,IAAI,CAAC,KAAa,EAAE,GAAW;QAC7B,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAC,IAAI,KAAK,GAAG,CAAC;YAAE,MAAM,IAAI,UAAU,CAAC,oBAAoB,CAAC,CAAC;QACrF,IAAI,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,GAAG,IAAI,CAAC,GAAG,CAAC,KAAK,EAAE,IAAI,CAAC,QAAQ,CAAC;YAAE,OAAO,KAAK,CAAC;QACvE,IAAI,CAAC,MAAM,IAAI,KAAK,CAAC;QAAC,OAAO,IAAI,CAAC;IACpC,CAAC;CACF;AAED,0GAA0G;AAC1G,MAAM,UAAU,cAAc,CAAC,CAG9B;IACC,KAAK,MAAM,CAAC,IAAI,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC;QAAE,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC;YAAE,MAAM,IAAI,UAAU,CAAC,oBAAoB,CAAC,CAAC;IAC/G,MAAM,SAAS,GAAG,CAAC,CAAC,uBAAuB,GAAG,CAAC,CAAC,cAAc,GAAG,CAAC,CAAC,WAAW,GAAG,IAAI,GAAG,GAAG,CAAC;IAC5F,MAAM,SAAS,GAAG,SAAS,GAAG,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,gBAAgB,IAAI,GAAG,CAAC,CAAC,CAAC;IAChE,MAAM,IAAI,GAAG,CAAC,CAAC,cAAc,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,SAAS,GAAG,CAAC,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC,eAAe,CAAC;IAC1F,OAAO,EAAE,SAAS,EAAE,SAAS,EAAE,IAAI,EAAE,YAAY,EAAE,IAAI,IAAI,CAAC,CAAC,CAAC,SAAS,IAAI,CAAC,CAAC,EAAE,CAAC;AAClF,CAAC"}

package/dist/core/endpoint.d.ts

@@ -0,0 +1,144 @@
+import { ReliableEvents, type ReliableOptions } from './reliable.js';
+import { type Json } from './protocol.js';
+export interface ReliableLink {
+    readonly open: boolean;
+    readonly bufferedAmount: number;
+    send(data: string | Uint8Array): boolean;
+    close(): void;
+}
+export interface DatagramLink {
+    readonly open: boolean;
+    readonly bufferedAmount: number;
+    send(data: Uint8Array): boolean;
+    close(): void;
+}
+export interface StateMessage {
+    stream: number;
+    seq: number;
+    time: number;
+    data: Uint8Array;
+    via: 'ws' | 'rtc';
+}
+/** Simulated network trouble on this endpoint's outgoing traffic (tests and tuning). lagMs is one way. */
+export interface Impairment {
+    lagMs?: number;
+    jitterMs?: number;
+    loss?: number;
+    duplicate?: number;
+}
+export interface StateOptions {
+    ttlMs?: number;
+    priority?: number;
+    ack?: boolean;
+}
+export interface EndpointOptions {
+    now?: () => number;
+    bytesPerSecond?: number;
+    burstBytes?: number;
+    maxBufferedBytes?: number;
+    maxStreams?: number;
+    probeIntervalMs?: number;
+    probeTimeoutMs?: number;
+    /** Largest state payload accepted (default 64 KiB, at most 256 KiB). */
+    maxStateBytes?: number;
+    /** States larger than this use the WebSocket even when datagrams are up (default 8 KiB). */
+    datagramStateBytes?: number;
+    /** Mirror reliable events on the datagram path so they arrive at UDP latency (default true). */
+    datagramEvents?: boolean;
+    /** How often state acknowledgements go back to the sender (default 50 ms). */
+    stateAckIntervalMs?: number;
+    events?: ReliableOptions;
+    impair?: Impairment;
+}
+export declare class Endpoint {
+    readonly events: ReliableEvents;
+    readonly stats: {
+        bytesSent: number;
+        bytesReceived: number;
+        statesSent: number;
+        statesReceived: number;
+        stale: number;
+        expired: number;
+        coalesced: number;
+        congested: number;
+        invalid: number;
+        fastTransitions: number;
+        datagramRttMs: number;
+        eventsViaDatagram: number;
+        datagramEventFrames: number;
+        stateAcksSent: number;
+        stateAcksReceived: number;
+        impairedDrops: number;
+    };
+    onState: (state: StateMessage) => void;
+    onEvent: (data: Json, seq: number) => void;
+    onFastDown: () => void;
+    onFastChange: (fast: boolean) => void;
+    onEventAck: (seq: number) => void;
+    /** The peer has seen state `seq` on `stream` (only for states sent with `ack: true`). */
+    onStateAck: (stream: number, seq: number) => void;
+    private reliable?;
+    private datagram?;
+    private epoch;
+    private sequence;
+    private received;
+    private queued;
+    private acksOut;
+    private acksIn;
+    private lastAckSentAt;
+    private lastEventSent;
+    private datagramAcked;
+    private ackDue;
+    private lastProbe;
+    private proofAt;
+    private attachedAt;
+    private probes;
+    private probeSeq;
+    private fast;
+    readonly now: () => number;
+    private budget;
+    private highWater;
+    private maxStreams;
+    private probeInterval;
+    private probeTimeout;
+    readonly maxStateBytes: number;
+    private datagramStateBytes;
+    private datagramEvents;
+    private stateAckInterval;
+    private impairment?;
+    constructor(o?: EndpointOptions);
+    get active(): boolean;
+    get fastActive(): boolean;
+    get pendingStates(): number;
+    get connectionEpoch(): number;
+    get maxFrameBytes(): number;
+    /** Newest seq the peer reported for an acknowledged stream in this connection epoch. */
+    stateAck(stream: number): number | undefined;
+    setImpairment(i: Impairment | null): void;
+    get impaired(): Impairment | undefined;
+    attach(epoch: number, reliable: ReliableLink): void;
+    detach(): void;
+    attachDatagram(link: DatagramLink): void;
+    dropDatagram(notify?: boolean): void;
+    private setFast;
+    sendControl(m: unknown): boolean;
+    sendEvent(data: Json): number;
+    /** Retains only the newest unsent payload per stream. Returns the state's seq (0 when offline).
+     * An accepted enqueue is not a delivery guarantee; use `ack: true` and onStateAck to learn what arrived. */
+    sendState(stream: number, data: Uint8Array, time: number, o?: StateOptions): number;
+    receiveControl(m: Record<string, unknown>): boolean;
+    receiveBinary(bytes: Uint8Array, via: 'ws' | 'rtc'): void;
+    private receiveDatagramEvents;
+    private receiveStateAcks;
+    private sendFast;
+    /** Binary on the datagram path when it is proven, else the WebSocket. */
+    private sendBinary;
+    pump(): void;
+    flush(maxPackets?: number): void;
+    /** Copies of WebSocket-sent, unacknowledged events, retried on the datagram path for UDP-like latency. */
+    private flushDatagramEvents;
+    private flushStateAcks;
+    /** Delays a stream-like link without ever reordering it: one queue, one timer. */
+    private impairReliable;
+    private impairDatagram;
+}