rollback-netcode 0.0.4

package/dist/rollback/input-buffer.js

@@ -0,0 +1,483 @@
+/**
+ * Per-player input tracking with support for dynamic join/leave.
+ *
+ * Tracks received inputs, confirmed ticks, and used (predicted) inputs
+ * to enable misprediction detection during rollback.
+ */
+import { asTick } from "../types.js";
+/**
+ * Compares two Uint8Arrays for equality.
+ */
+function inputsEqual(a, b) {
+    if (a.length !== b.length)
+        return false;
+    for (let i = 0; i < a.length; i++) {
+        if (a[i] !== b[i])
+            return false;
+    }
+    return true;
+}
+/**
+ * Buffer for tracking inputs from all players.
+ *
+ * Supports:
+ * - Dynamic player join/leave
+ * - Out-of-order input reception
+ * - Misprediction detection
+ * - Confirmed tick tracking
+ */
+export class InputBuffer {
+    players = new Map();
+    /** Index of players by their join tick for O(1) lookup */
+    joinsByTick = new Map();
+    /** Index of players by their leave tick for O(1) lookup */
+    leavesByTick = new Map();
+    /**
+     * Add a player to the buffer.
+     *
+     * @param playerId - The player's ID
+     * @param joinTick - The tick at which the player joins
+     */
+    addPlayer(playerId, joinTick) {
+        const existing = this.players.get(playerId);
+        if (existing) {
+            // If player is rejoining, update join tick and clear leave tick
+            if (existing.leaveTick !== null) {
+                // Remove from old join tick index
+                this.removeFromTickIndex(this.joinsByTick, existing.joinTick, playerId);
+                // Remove from leave tick index
+                this.removeFromTickIndex(this.leavesByTick, existing.leaveTick, playerId);
+                existing.joinTick = joinTick;
+                existing.leaveTick = null;
+                existing.confirmedTick = asTick(joinTick - 1);
+                existing.received.clear();
+                existing.usedInputs.clear();
+                // Add to new join tick index
+                this.addToTickIndex(this.joinsByTick, joinTick, playerId);
+            }
+            return;
+        }
+        this.players.set(playerId, {
+            joinTick,
+            leaveTick: null,
+            received: new Map(),
+            confirmedTick: asTick(joinTick - 1), // No inputs confirmed yet
+            usedInputs: new Map(),
+        });
+        // Add to join tick index
+        this.addToTickIndex(this.joinsByTick, joinTick, playerId);
+    }
+    /**
+     * Mark a player as having left.
+     *
+     * @param playerId - The player's ID
+     * @param leaveTick - The tick at which the player leaves
+     */
+    removePlayer(playerId, leaveTick) {
+        const player = this.players.get(playerId);
+        if (player) {
+            // Remove from old leave tick index if they had one
+            if (player.leaveTick !== null) {
+                this.removeFromTickIndex(this.leavesByTick, player.leaveTick, playerId);
+            }
+            player.leaveTick = leaveTick;
+            // Add to leave tick index
+            this.addToTickIndex(this.leavesByTick, leaveTick, playerId);
+        }
+    }
+    /**
+     * Set the confirmed tick for all active players to a specific value.
+     * Used after a state sync to indicate that all inputs up to that tick
+     * are implicitly confirmed by the synced state.
+     *
+     * @param tick - The tick to set as confirmed for all active players
+     */
+    setConfirmedTickForSync(tick) {
+        // Guard against underflow when tick is 0 or negative
+        if (tick <= 0) {
+            return;
+        }
+        const confirmedTick = asTick(tick - 1);
+        for (const player of this.players.values()) {
+            // Only update if the player was active at or before this tick
+            if (player.leaveTick === null || player.leaveTick > tick) {
+                // Set confirmed tick to tick-1 (the state represents confirmed state)
+                if (player.confirmedTick < confirmedTick) {
+                    player.confirmedTick = confirmedTick;
+                }
+            }
+        }
+    }
+    /**
+     * Check if a player is active at a given tick.
+     *
+     * @param playerId - The player's ID
+     * @param tick - The tick to check
+     * @returns true if the player is active at that tick
+     */
+    isPlayerActive(playerId, tick) {
+        const player = this.players.get(playerId);
+        if (!player)
+            return false;
+        if (tick < player.joinTick)
+            return false;
+        if (player.leaveTick !== null && tick >= player.leaveTick)
+            return false;
+        return true;
+    }
+    /**
+     * Get all players that are active at a given tick.
+     *
+     * @param tick - The tick to check
+     * @returns Array of active player IDs
+     */
+    getActivePlayers(tick) {
+        const active = [];
+        for (const [playerId] of this.players) {
+            if (this.isPlayerActive(playerId, tick)) {
+                active.push(playerId);
+            }
+        }
+        return active;
+    }
+    /**
+     * Get all player IDs (active or not).
+     *
+     * @returns Array of all player IDs
+     */
+    getAllPlayers() {
+        return Array.from(this.players.keys());
+    }
+    /**
+     * Receive an input from a player.
+     * The input is copied to prevent external mutation.
+     *
+     * @param playerId - The player's ID
+     * @param tick - The tick the input is for
+     * @param input - The input data
+     */
+    receiveInput(playerId, tick, input) {
+        const player = this.players.get(playerId);
+        if (!player)
+            return;
+        // Don't accept inputs for ticks before the player joined
+        if (tick < player.joinTick)
+            return;
+        // Don't accept inputs for ticks after the player left
+        if (player.leaveTick !== null && tick >= player.leaveTick)
+            return;
+        // Copy input to prevent external mutation
+        const inputCopy = new Uint8Array(input.length);
+        inputCopy.set(input);
+        player.received.set(tick, inputCopy);
+        // Update confirmed tick (highest consecutive tick with input)
+        this.updateConfirmedTick(player);
+    }
+    /**
+     * Update the confirmed tick for a player.
+     * Confirmed tick is the highest tick where all ticks from joinTick
+     * to that tick have received inputs.
+     */
+    updateConfirmedTick(player) {
+        let tick = player.confirmedTick + 1;
+        while (player.received.has(asTick(tick))) {
+            tick++;
+        }
+        player.confirmedTick = asTick(tick - 1);
+    }
+    /**
+     * Get the received input for a player at a specific tick.
+     *
+     * @param playerId - The player's ID
+     * @param tick - The tick to get input for
+     * @returns The input, or undefined if not received
+     */
+    getInput(playerId, tick) {
+        const player = this.players.get(playerId);
+        if (!player)
+            return undefined;
+        return player.received.get(tick);
+    }
+    /**
+     * Get the confirmed tick for a player.
+     * This is the highest consecutive tick for which we have received input.
+     *
+     * @param playerId - The player's ID
+     * @returns The confirmed tick, or undefined if player not found
+     */
+    getConfirmedTick(playerId) {
+        const player = this.players.get(playerId);
+        if (!player)
+            return undefined;
+        return player.confirmedTick;
+    }
+    /**
+     * Get the join tick for a player.
+     *
+     * @param playerId - The player's ID
+     * @returns The join tick, or undefined if player not found
+     */
+    getJoinTick(playerId) {
+        const player = this.players.get(playerId);
+        return player?.joinTick;
+    }
+    /**
+     * Get the leave tick for a player.
+     *
+     * @param playerId - The player's ID
+     * @returns The leave tick, or null/undefined if player hasn't left or not found
+     */
+    getLeaveTick(playerId) {
+        const player = this.players.get(playerId);
+        return player?.leaveTick;
+    }
+    /**
+     * Record the input that was actually used for a player at a tick.
+     * This may be the real input or a predicted input.
+     *
+     * @param playerId - The player's ID
+     * @param tick - The tick
+     * @param input - The input that was used
+     */
+    recordUsedInput(playerId, tick, input) {
+        const player = this.players.get(playerId);
+        if (!player)
+            return;
+        // Copy input
+        const inputCopy = new Uint8Array(input.length);
+        inputCopy.set(input);
+        player.usedInputs.set(tick, inputCopy);
+    }
+    /**
+     * Get the input that was used for a player at a tick.
+     *
+     * @param playerId - The player's ID
+     * @param tick - The tick
+     * @returns The used input, or undefined if not recorded
+     */
+    getUsedInput(playerId, tick) {
+        const player = this.players.get(playerId);
+        if (!player)
+            return undefined;
+        return player.usedInputs.get(tick);
+    }
+    /**
+     * Find the first tick where a misprediction occurred for a player.
+     * A misprediction is when we used a predicted input that differs
+     * from the actual received input.
+     *
+     * @param playerId - The player's ID
+     * @param fromTick - Start searching from this tick
+     * @returns The tick of the first misprediction, or undefined if none found
+     */
+    findMisprediction(playerId, fromTick) {
+        const player = this.players.get(playerId);
+        if (!player)
+            return undefined;
+        // Check each tick from fromTick up to confirmedTick
+        for (let tick = fromTick; tick <= player.confirmedTick; tick++) {
+            const received = player.received.get(asTick(tick));
+            const used = player.usedInputs.get(asTick(tick));
+            // If we have both received and used inputs, compare them
+            if (received !== undefined && used !== undefined) {
+                if (!inputsEqual(received, used)) {
+                    return asTick(tick);
+                }
+            }
+        }
+        return undefined;
+    }
+    /**
+     * Check if there are any mispredictions for a player in a tick range.
+     *
+     * @param playerId - The player's ID
+     * @param fromTick - Start of range (inclusive)
+     * @param toTick - End of range (inclusive)
+     * @returns true if any misprediction found
+     */
+    hasMisprediction(playerId, fromTick, toTick) {
+        const player = this.players.get(playerId);
+        if (!player)
+            return false;
+        for (let tick = fromTick; tick <= toTick; tick++) {
+            const received = player.received.get(asTick(tick));
+            const used = player.usedInputs.get(asTick(tick));
+            if (received !== undefined && used !== undefined) {
+                if (!inputsEqual(received, used)) {
+                    return true;
+                }
+            }
+        }
+        return false;
+    }
+    /**
+     * Get the last confirmed input for a player.
+     * Useful for input prediction.
+     *
+     * @param playerId - The player's ID
+     * @returns The last confirmed input, or undefined if none
+     */
+    getLastConfirmedInput(playerId) {
+        const player = this.players.get(playerId);
+        if (!player)
+            return undefined;
+        // Return input at confirmedTick, not just any received input
+        // confirmedTick is the highest consecutive tick with input
+        if (player.confirmedTick >= player.joinTick) {
+            return player.received.get(player.confirmedTick);
+        }
+        return undefined;
+    }
+    /**
+     * Remove all data before a given tick.
+     * Used to clean up old inputs that are no longer needed.
+     *
+     * @param tick - Remove all data for ticks < this value
+     */
+    pruneBeforeTick(tick) {
+        for (const player of this.players.values()) {
+            // Remove old received inputs
+            for (const t of player.received.keys()) {
+                if (t < tick) {
+                    player.received.delete(t);
+                }
+            }
+            // Remove old used inputs
+            for (const t of player.usedInputs.keys()) {
+                if (t < tick) {
+                    player.usedInputs.delete(t);
+                }
+            }
+        }
+    }
+    /**
+     * Clear used inputs for a player from a given tick onwards.
+     * Called during rollback to allow re-recording inputs.
+     *
+     * @param playerId - The player's ID
+     * @param fromTick - Clear from this tick onwards
+     */
+    clearUsedInputsFrom(playerId, fromTick) {
+        const player = this.players.get(playerId);
+        if (!player)
+            return;
+        for (const tick of player.usedInputs.keys()) {
+            if (tick >= fromTick) {
+                player.usedInputs.delete(tick);
+            }
+        }
+    }
+    /**
+     * Clear all used inputs from a given tick onwards for all players.
+     *
+     * @param fromTick - Clear from this tick onwards
+     */
+    clearAllUsedInputsFrom(fromTick) {
+        for (const playerId of this.players.keys()) {
+            this.clearUsedInputsFrom(playerId, fromTick);
+        }
+    }
+    /**
+     * Get the minimum confirmed tick across all active players at a given tick.
+     *
+     * @param tick - The reference tick for determining active players
+     * @returns The minimum confirmed tick, or undefined if no active players
+     */
+    getMinConfirmedTick(tick) {
+        let minTick;
+        for (const [playerId, player] of this.players) {
+            if (this.isPlayerActive(playerId, tick)) {
+                if (minTick === undefined || player.confirmedTick < minTick) {
+                    minTick = player.confirmedTick;
+                }
+            }
+        }
+        return minTick;
+    }
+    /**
+     * Check if we have all inputs for a given tick from all active players.
+     *
+     * @param tick - The tick to check
+     * @returns true if all inputs are available
+     */
+    hasAllInputsForTick(tick) {
+        for (const [playerId] of this.players) {
+            if (this.isPlayerActive(playerId, tick)) {
+                if (!this.getInput(playerId, tick)) {
+                    return false;
+                }
+            }
+        }
+        return true;
+    }
+    /**
+     * Clear all data for a player.
+     *
+     * @param playerId - The player's ID
+     */
+    clearPlayer(playerId) {
+        const player = this.players.get(playerId);
+        if (player) {
+            // Remove from tick indexes
+            this.removeFromTickIndex(this.joinsByTick, player.joinTick, playerId);
+            if (player.leaveTick !== null) {
+                this.removeFromTickIndex(this.leavesByTick, player.leaveTick, playerId);
+            }
+        }
+        this.players.delete(playerId);
+    }
+    /**
+     * Clear all players and data.
+     */
+    clear() {
+        this.players.clear();
+        this.joinsByTick.clear();
+        this.leavesByTick.clear();
+    }
+    /**
+     * Get all players that join at a specific tick.
+     * O(1) lookup using tick-indexed map.
+     *
+     * @param tick - The tick to check
+     * @returns Array of player IDs joining at this tick
+     */
+    getPlayersJoiningAtTick(tick) {
+        const players = this.joinsByTick.get(tick);
+        return players ? Array.from(players) : [];
+    }
+    /**
+     * Get all players that leave at a specific tick.
+     * O(1) lookup using tick-indexed map.
+     *
+     * @param tick - The tick to check
+     * @returns Array of player IDs leaving at this tick
+     */
+    getPlayersLeavingAtTick(tick) {
+        const players = this.leavesByTick.get(tick);
+        return players ? Array.from(players) : [];
+    }
+    /**
+     * Add a player to a tick index.
+     */
+    addToTickIndex(index, tick, playerId) {
+        let players = index.get(tick);
+        if (!players) {
+            players = new Set();
+            index.set(tick, players);
+        }
+        players.add(playerId);
+    }
+    /**
+     * Remove a player from a tick index.
+     */
+    removeFromTickIndex(index, tick, playerId) {
+        const players = index.get(tick);
+        if (players) {
+            players.delete(playerId);
+            if (players.size === 0) {
+                index.delete(tick);
+            }
+        }
+    }
+}
+//# sourceMappingURL=input-buffer.js.map

package/dist/rollback/input-buffer.js.map

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

package/dist/rollback/snapshot-buffer.d.ts

@@ -0,0 +1,119 @@
+/**
+ * Ring buffer for storing game state snapshots.
+ *
+ * Used for rollback: when a misprediction is detected, the game state
+ * is restored from a snapshot and resimulated forward.
+ */
+import type { Snapshot, Tick } from "../types.js";
+/**
+ * A ring buffer that stores game state snapshots for rollback.
+ *
+ * Snapshots are stored at specific ticks and can be retrieved by tick.
+ * When the buffer is full, the oldest snapshot is evicted.
+ * Uses a tick-to-index map for O(1) lookup performance.
+ *
+ * INVARIANT: Snapshots must be saved in ascending tick order. This is required
+ * for O(log n) binary search in getAtOrBefore(). The invariant is maintained by:
+ * - Normal simulation: ticks advance sequentially (0, 1, 2, ...)
+ * - Resimulation: existing ticks are updated in-place, preserving order
+ *
+ * Saving a non-existing tick out of order will corrupt the sort order and
+ * cause getAtOrBefore() to return incorrect results.
+ */
+export declare class SnapshotBuffer {
+    readonly capacity: number;
+    private readonly buffer;
+    private readonly tickToIndex;
+    private head;
+    private count;
+    private _oldestTick;
+    private _newestTick;
+    /**
+     * Create a new snapshot buffer.
+     *
+     * @param capacity - Maximum number of snapshots to store
+     */
+    constructor(capacity: number);
+    /**
+     * Number of snapshots currently stored.
+     */
+    get size(): number;
+    /**
+     * The oldest tick in the buffer, or undefined if empty.
+     */
+    get oldestTick(): Tick | undefined;
+    /**
+     * The newest tick in the buffer, or undefined if empty.
+     */
+    get newestTick(): Tick | undefined;
+    /**
+     * Save a snapshot at a specific tick.
+     *
+     * If the tick already exists, updates in-place to maintain sort order.
+     * If the buffer is full, the oldest snapshot is evicted.
+     * The state is copied to prevent external mutation.
+     *
+     * PRECONDITION: New ticks (not already in buffer) must be >= all existing ticks.
+     * Saving an out-of-order new tick corrupts sort order. See class invariant.
+     *
+     * @param tick - The tick this snapshot was taken at
+     * @param state - The serialized game state
+     * @param hash - The hash of the game state
+     */
+    save(tick: Tick, state: Uint8Array, hash: number): void;
+    /**
+     * Get a snapshot at a specific tick.
+     * Uses O(1) map lookup for performance.
+     *
+     * @param tick - The tick to retrieve
+     * @returns The snapshot at that tick, or undefined if not found
+     */
+    get(tick: Tick): Snapshot | undefined;
+    /**
+     * Get the oldest snapshot in the buffer.
+     *
+     * @returns The oldest snapshot, or undefined if empty
+     */
+    getOldest(): Snapshot | undefined;
+    /**
+     * Get the newest snapshot in the buffer.
+     *
+     * @returns The newest snapshot, or undefined if empty
+     */
+    getNewest(): Snapshot | undefined;
+    /**
+     * Clear all snapshots from the buffer.
+     */
+    clear(): void;
+    /**
+     * Get the snapshot at or before a given tick.
+     * Useful for finding the closest snapshot for rollback.
+     *
+     * O(log n) binary search. Snapshots are stored in ascending tick order.
+     *
+     * @param tick - The target tick
+     * @returns The snapshot at or before that tick, or undefined if none exists
+     */
+    getAtOrBefore(tick: Tick): Snapshot | undefined;
+    /**
+     * Remove all snapshots before a given tick.
+     * Used to clean up old snapshots that are no longer needed.
+     *
+     * @param tick - Remove all snapshots with tick < this value
+     */
+    pruneBeforeTick(tick: Tick): void;
+    /**
+     * Check if a snapshot exists at a given tick.
+     *
+     * @param tick - The tick to check
+     * @returns true if a snapshot exists at that tick
+     */
+    has(tick: Tick): boolean;
+    /**
+     * Get all ticks that have snapshots, in order from oldest to newest.
+     *
+     * @returns Array of ticks with snapshots
+     */
+    getTicks(): Tick[];
+}
+//# sourceMappingURL=snapshot-buffer.d.ts.map

package/dist/rollback/snapshot-buffer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"snapshot-buffer.d.ts","sourceRoot":"","sources":["../../src/rollback/snapshot-buffer.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,QAAQ,EAAE,IAAI,EAAE,MAAM,aAAa,CAAC;AAGlD;;;;;;;;;;;;;;GAcG;AACH,qBAAa,cAAc;aAaE,QAAQ,EAAE,MAAM;IAZ5C,OAAO,CAAC,QAAQ,CAAC,MAAM,CAA2B;IAClD,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAgC;IAC5D,OAAO,CAAC,IAAI,CAAK;IACjB,OAAO,CAAC,KAAK,CAAK;IAClB,OAAO,CAAC,WAAW,CAAmB;IACtC,OAAO,CAAC,WAAW,CAAmB;IAEtC;;;;OAIG;gBACyB,QAAQ,EAAE,MAAM;IAO5C;;OAEG;IACH,IAAI,IAAI,IAAI,MAAM,CAEjB;IAED;;OAEG;IACH,IAAI,UAAU,IAAI,IAAI,GAAG,SAAS,CAEjC;IAED;;OAEG;IACH,IAAI,UAAU,IAAI,IAAI,GAAG,SAAS,CAEjC;IAED;;;;;;;;;;;;;OAaG;IACH,IAAI,CAAC,IAAI,EAAE,IAAI,EAAE,KAAK,EAAE,UAAU,EAAE,IAAI,EAAE,MAAM,GAAG,IAAI;IAsDvD;;;;;;OAMG;IACH,GAAG,CAAC,IAAI,EAAE,IAAI,GAAG,QAAQ,GAAG,SAAS;IAQrC;;;;OAIG;IACH,SAAS,IAAI,QAAQ,GAAG,SAAS;IAOjC;;;;OAIG;IACH,SAAS,IAAI,QAAQ,GAAG,SAAS;IAQjC;;OAEG;IACH,KAAK,IAAI,IAAI;IASb;;;;;;;;OAQG;IACH,aAAa,CAAC,IAAI,EAAE,IAAI,GAAG,QAAQ,GAAG,SAAS;IA6B/C;;;;;OAKG;IACH,eAAe,CAAC,IAAI,EAAE,IAAI,GAAG,IAAI;IAqBjC;;;;;OAKG;IACH,GAAG,CAAC,IAAI,EAAE,IAAI,GAAG,OAAO;IAIxB;;;;OAIG;IACH,QAAQ,IAAI,IAAI,EAAE;CAWlB"}