rollback-netcode 0.0.4

package/dist/types.js

@@ -0,0 +1,256 @@
+/**
+ * Core type definitions for the rollback netcode library.
+ */
+/**
+ * Minimum valid tick value (-1 represents initial state before tick 0).
+ */
+export const TICK_MIN = -1;
+/**
+ * Helper to create a Tick value.
+ * This is a simple cast - use validateTick() for validation.
+ *
+ * @param n - The tick number
+ */
+export function asTick(n) {
+    return n;
+}
+/**
+ * Validate that a number is a valid tick value.
+ *
+ * @param n - The number to validate
+ * @throws ValidationError if the value is not a valid tick (must be integer >= -1)
+ */
+export function validateTick(n) {
+    if (!Number.isInteger(n) || n < TICK_MIN) {
+        throw new ValidationError(`Tick must be an integer >= ${TICK_MIN}`, "tick", n);
+    }
+}
+/**
+ * Helper to create a PlayerId value.
+ * This is a simple cast - use validatePlayerId() for validation.
+ *
+ * @param s - The player ID string
+ */
+export function asPlayerId(s) {
+    return s;
+}
+/**
+ * Validate that a string is a valid player ID.
+ *
+ * @param s - The string to validate
+ * @throws ValidationError if the value is not a valid player ID (must be non-empty string)
+ */
+export function validatePlayerId(s) {
+    if (typeof s !== "string" || s.length === 0) {
+        throw new ValidationError("Player ID must be a non-empty string", "playerId", s);
+    }
+}
+/**
+ * Convert a PlayerId to a transport peer ID string.
+ *
+ * In the current implementation, these are the same value,
+ * but this function makes the intent explicit in code.
+ */
+export function playerIdToPeerId(playerId) {
+    return playerId;
+}
+// =============================================================================
+// Session Configuration
+// =============================================================================
+/**
+ * Network topology for the session.
+ */
+export var Topology;
+(function (Topology) {
+    /** All players connect to each other directly */
+    Topology[Topology["Mesh"] = 0] = "Mesh";
+    /** All players connect through a host */
+    Topology[Topology["Star"] = 1] = "Star";
+})(Topology || (Topology = {}));
+/**
+ * Authority model for desync resolution.
+ */
+export var DesyncAuthority;
+(function (DesyncAuthority) {
+    /** Host is authoritative; guests send hashes to host only */
+    DesyncAuthority[DesyncAuthority["Host"] = 0] = "Host";
+    /** Each peer compares independently */
+    DesyncAuthority[DesyncAuthority["Peer"] = 1] = "Peer";
+})(DesyncAuthority || (DesyncAuthority = {}));
+/**
+ * Player role in the session.
+ */
+export var PlayerRole;
+(function (PlayerRole) {
+    /** Active player who sends inputs */
+    PlayerRole[PlayerRole["Player"] = 0] = "Player";
+    /** Observer who runs simulation but doesn't send inputs */
+    PlayerRole[PlayerRole["Spectator"] = 1] = "Spectator";
+})(PlayerRole || (PlayerRole = {}));
+/**
+ * Reason for pausing the game.
+ */
+export var PauseReason;
+(function (PauseReason) {
+    PauseReason[PauseReason["PlayerRequest"] = 0] = "PlayerRequest";
+    PauseReason[PauseReason["PlayerDisconnect"] = 1] = "PlayerDisconnect";
+    PauseReason[PauseReason["ExcessiveLag"] = 2] = "ExcessiveLag";
+})(PauseReason || (PauseReason = {}));
+/**
+ * Default session configuration values.
+ */
+export const DEFAULT_SESSION_CONFIG = {
+    tickRate: 60,
+    maxPlayers: 4,
+    topology: Topology.Star,
+    snapshotHistorySize: 120,
+    maxSpeculationTicks: 60,
+    hashInterval: 60,
+    disconnectTimeout: 5000,
+    debug: false,
+    desyncAuthority: DesyncAuthority.Peer,
+    lagReportThreshold: 30,
+    inputRedundancy: 3,
+    joinRateLimitRequests: 3,
+    joinRateLimitWindowMs: 10000,
+};
+/** Maximum allowed players in a session */
+export const MAX_PLAYERS_LIMIT = 16;
+/**
+ * Validate session configuration values.
+ * @throws ValidationError if any values are invalid
+ */
+export function validateSessionConfig(config) {
+    if (config.tickRate <= 0) {
+        throw new ValidationError("tickRate must be greater than 0", "tickRate", config.tickRate);
+    }
+    if (config.maxPlayers < 1 || config.maxPlayers > MAX_PLAYERS_LIMIT) {
+        throw new ValidationError(`maxPlayers must be between 1 and ${MAX_PLAYERS_LIMIT}`, "maxPlayers", config.maxPlayers);
+    }
+    if (config.maxSpeculationTicks <= 0) {
+        throw new ValidationError("maxSpeculationTicks must be greater than 0", "maxSpeculationTicks", config.maxSpeculationTicks);
+    }
+    if (config.snapshotHistorySize < config.maxSpeculationTicks) {
+        throw new ValidationError("snapshotHistorySize must be >= maxSpeculationTicks to support rollback", "snapshotHistorySize", config.snapshotHistorySize);
+    }
+    if (config.hashInterval <= 0) {
+        throw new ValidationError("hashInterval must be greater than 0", "hashInterval", config.hashInterval);
+    }
+    if (config.disconnectTimeout <= 0) {
+        throw new ValidationError("disconnectTimeout must be greater than 0", "disconnectTimeout", config.disconnectTimeout);
+    }
+    if (config.topology !== Topology.Mesh && config.topology !== Topology.Star) {
+        throw new ValidationError("topology must be Topology.Mesh or Topology.Star", "topology", config.topology);
+    }
+    if (config.desyncAuthority !== DesyncAuthority.Host &&
+        config.desyncAuthority !== DesyncAuthority.Peer) {
+        throw new ValidationError("desyncAuthority must be DesyncAuthority.Host or DesyncAuthority.Peer", "desyncAuthority", config.desyncAuthority);
+    }
+    if (config.lagReportThreshold < 0) {
+        throw new ValidationError("lagReportThreshold must be >= 0", "lagReportThreshold", config.lagReportThreshold);
+    }
+    if (config.inputRedundancy < 1) {
+        throw new ValidationError("inputRedundancy must be >= 1", "inputRedundancy", config.inputRedundancy);
+    }
+    if (config.joinRateLimitRequests < 1) {
+        throw new ValidationError("joinRateLimitRequests must be >= 1", "joinRateLimitRequests", config.joinRateLimitRequests);
+    }
+    if (config.joinRateLimitWindowMs <= 0) {
+        throw new ValidationError("joinRateLimitWindowMs must be > 0", "joinRateLimitWindowMs", config.joinRateLimitWindowMs);
+    }
+}
+// =============================================================================
+// Session State
+// =============================================================================
+/**
+ * Possible states of a session.
+ */
+export var SessionState;
+(function (SessionState) {
+    SessionState[SessionState["Disconnected"] = 0] = "Disconnected";
+    SessionState[SessionState["Connecting"] = 1] = "Connecting";
+    SessionState[SessionState["Lobby"] = 2] = "Lobby";
+    SessionState[SessionState["Playing"] = 3] = "Playing";
+    SessionState[SessionState["Paused"] = 4] = "Paused";
+})(SessionState || (SessionState = {}));
+/**
+ * Default input predictor that repeats the last confirmed input,
+ * or returns an empty Uint8Array if no input is available.
+ */
+export const DEFAULT_INPUT_PREDICTOR = {
+    predict(_playerId, _tick, lastConfirmed) {
+        return lastConfirmed ?? new Uint8Array(0);
+    },
+};
+// =============================================================================
+// Player Information
+// =============================================================================
+/**
+ * Connection state of a player.
+ */
+export var PlayerConnectionState;
+(function (PlayerConnectionState) {
+    PlayerConnectionState[PlayerConnectionState["Connecting"] = 0] = "Connecting";
+    PlayerConnectionState[PlayerConnectionState["Connected"] = 1] = "Connected";
+    PlayerConnectionState[PlayerConnectionState["Disconnected"] = 2] = "Disconnected";
+})(PlayerConnectionState || (PlayerConnectionState = {}));
+// =============================================================================
+// Errors
+// =============================================================================
+/**
+ * Source of an error in the rollback netcode system.
+ */
+export var ErrorSource;
+(function (ErrorSource) {
+    ErrorSource[ErrorSource["Engine"] = 0] = "Engine";
+    ErrorSource[ErrorSource["Transport"] = 1] = "Transport";
+    ErrorSource[ErrorSource["Protocol"] = 2] = "Protocol";
+    ErrorSource[ErrorSource["Session"] = 3] = "Session";
+})(ErrorSource || (ErrorSource = {}));
+/**
+ * Error thrown when a rollback operation fails.
+ */
+export class RollbackError extends Error {
+    tick;
+    constructor(message, tick, originalError) {
+        super(message, { cause: originalError });
+        this.tick = tick;
+        this.name = "RollbackError";
+    }
+}
+/**
+ * Error thrown when session validation fails.
+ */
+export class ValidationError extends Error {
+    field;
+    value;
+    constructor(message, field, value) {
+        super(message);
+        this.field = field;
+        this.value = value;
+        this.name = "ValidationError";
+    }
+}
+/**
+ * Error thrown when a game callback fails.
+ * Wraps the original error with context about which operation failed and at which tick.
+ */
+export class GameError extends Error {
+    operation;
+    tick;
+    constructor(
+    /** The game operation that failed */
+    operation, 
+    /** The tick at which the error occurred */
+    tick, 
+    /** The original error from the game */
+    cause) {
+        super(`Game ${operation}() failed at tick ${tick}: ${cause.message}`, {
+            cause,
+        });
+        this.operation = operation;
+        this.tick = tick;
+        this.name = "GameError";
+    }
+}
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

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

package/dist/utils/rate-limiter.d.ts

@@ -0,0 +1,59 @@
+/**
+ * Generic rate limiter for request throttling.
+ *
+ * Uses a sliding window algorithm to track requests per key.
+ */
+/**
+ * Configuration for the rate limiter.
+ */
+export interface RateLimiterConfig {
+    /** Maximum number of requests allowed within the window */
+    maxRequests: number;
+    /** Time window in milliseconds */
+    windowMs: number;
+    /** Optional custom time source for testing (defaults to Date.now) */
+    getNow?: () => number;
+}
+/**
+ * A generic rate limiter that tracks requests per key.
+ *
+ * Uses a sliding window approach: requests older than windowMs are discarded.
+ */
+export declare class RateLimiter {
+    private readonly maxRequests;
+    private readonly windowMs;
+    private readonly requests;
+    private readonly getNow;
+    constructor(config: RateLimiterConfig);
+    /**
+     * Check if a key is currently rate limited.
+     *
+     * @param key - The key to check (e.g., peer ID)
+     * @returns true if the key has exceeded the rate limit
+     */
+    isLimited(key: string): boolean;
+    /**
+     * Record a request for a key.
+     *
+     * @param key - The key to record (e.g., peer ID)
+     */
+    record(key: string): void;
+    /**
+     * Check if limited and record in one operation.
+     * Returns true if the request should be rejected.
+     *
+     * @param key - The key to check and record
+     * @returns true if the key is rate limited (request should be rejected)
+     */
+    checkAndRecord(key: string): boolean;
+    /**
+     * Clean up stale entries to prevent memory growth.
+     * Call this periodically (e.g., every minute).
+     */
+    cleanup(): void;
+    /**
+     * Clear all rate limit entries.
+     */
+    clear(): void;
+}
+//# sourceMappingURL=rate-limiter.d.ts.map

package/dist/utils/rate-limiter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"rate-limiter.d.ts","sourceRoot":"","sources":["../../src/utils/rate-limiter.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH;;GAEG;AACH,MAAM,WAAW,iBAAiB;IACjC,2DAA2D;IAC3D,WAAW,EAAE,MAAM,CAAC;IACpB,kCAAkC;IAClC,QAAQ,EAAE,MAAM,CAAC;IACjB,qEAAqE;IACrE,MAAM,CAAC,EAAE,MAAM,MAAM,CAAC;CACtB;AAED;;;;GAIG;AACH,qBAAa,WAAW;IACvB,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAS;IACrC,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAS;IAClC,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAoC;IAC7D,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAe;gBAE1B,MAAM,EAAE,iBAAiB;IAYrC;;;;;OAKG;IACH,SAAS,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO;IAW/B;;;;OAIG;IACH,MAAM,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI;IAMzB;;;;;;OAMG;IACH,cAAc,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO;IAepC;;;OAGG;IACH,OAAO,IAAI,IAAI;IAcf;;OAEG;IACH,KAAK,IAAI,IAAI;CAGb"}

package/dist/utils/rate-limiter.js

@@ -0,0 +1,93 @@
+/**
+ * Generic rate limiter for request throttling.
+ *
+ * Uses a sliding window algorithm to track requests per key.
+ */
+/**
+ * A generic rate limiter that tracks requests per key.
+ *
+ * Uses a sliding window approach: requests older than windowMs are discarded.
+ */
+export class RateLimiter {
+    maxRequests;
+    windowMs;
+    requests = new Map();
+    getNow;
+    constructor(config) {
+        if (config.maxRequests <= 0) {
+            throw new Error("maxRequests must be greater than 0");
+        }
+        if (config.windowMs <= 0) {
+            throw new Error("windowMs must be greater than 0");
+        }
+        this.maxRequests = config.maxRequests;
+        this.windowMs = config.windowMs;
+        this.getNow = config.getNow ?? (() => Date.now());
+    }
+    /**
+     * Check if a key is currently rate limited.
+     *
+     * @param key - The key to check (e.g., peer ID)
+     * @returns true if the key has exceeded the rate limit
+     */
+    isLimited(key) {
+        const now = this.getNow();
+        const timestamps = this.requests.get(key) ?? [];
+        // Filter to only recent timestamps within the window
+        const recentTimestamps = timestamps.filter((t) => now - t < this.windowMs);
+        this.requests.set(key, recentTimestamps);
+        return recentTimestamps.length >= this.maxRequests;
+    }
+    /**
+     * Record a request for a key.
+     *
+     * @param key - The key to record (e.g., peer ID)
+     */
+    record(key) {
+        const timestamps = this.requests.get(key) ?? [];
+        timestamps.push(this.getNow());
+        this.requests.set(key, timestamps);
+    }
+    /**
+     * Check if limited and record in one operation.
+     * Returns true if the request should be rejected.
+     *
+     * @param key - The key to check and record
+     * @returns true if the key is rate limited (request should be rejected)
+     */
+    checkAndRecord(key) {
+        const now = this.getNow();
+        const timestamps = this.requests.get(key) ?? [];
+        const recentTimestamps = timestamps.filter((t) => now - t < this.windowMs);
+        if (recentTimestamps.length >= this.maxRequests) {
+            this.requests.set(key, recentTimestamps);
+            return true;
+        }
+        recentTimestamps.push(now);
+        this.requests.set(key, recentTimestamps);
+        return false;
+    }
+    /**
+     * Clean up stale entries to prevent memory growth.
+     * Call this periodically (e.g., every minute).
+     */
+    cleanup() {
+        const now = this.getNow();
+        for (const [key, timestamps] of this.requests) {
+            const recentTimestamps = timestamps.filter((t) => now - t < this.windowMs);
+            if (recentTimestamps.length === 0) {
+                this.requests.delete(key);
+            }
+            else {
+                this.requests.set(key, recentTimestamps);
+            }
+        }
+    }
+    /**
+     * Clear all rate limit entries.
+     */
+    clear() {
+        this.requests.clear();
+    }
+}
+//# sourceMappingURL=rate-limiter.js.map

package/dist/utils/rate-limiter.js.map

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

package/package.json

@@ -0,0 +1,61 @@
+{
+  "name": "rollback-netcode",
+  "version": "0.0.4",
+  "description": "P2P rollback netcode library for browser-based multiplayer games",
+  "type": "module",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js",
+      "require": null
+    }
+  },
+  "files": [
+    "dist"
+  ],
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/someusername6/rollback-netcode.git"
+  },
+  "homepage": "https://someusername6.github.io/rollback-netcode",
+  "scripts": {
+    "clean": "rm -rf dist",
+    "build": "tsc",
+    "build:demo": "node esbuild.demo.mjs",
+    "serve:demo": "npm run build:demo && npx http-server examples/local-transport -p 3000 -c-1",
+    "test": "node --import tsx --test tests/*.test.ts tests/**/*.test.ts",
+    "lint": "biome check src/",
+    "format": "biome format --write src/",
+    "benchmark": "node --import tsx src/benchmark.ts",
+    "prepublishOnly": "npm run clean && npm run build && npm run lint && npm test"
+  },
+  "keywords": [
+    "netcode",
+    "rollback",
+    "multiplayer",
+    "webrtc",
+    "p2p",
+    "game",
+    "networking",
+    "ggpo"
+  ],
+  "author": "someusername6",
+  "license": "MIT",
+  "devDependencies": {
+    "@biomejs/biome": "^1.9.0",
+    "@types/node": "^25.0.10",
+    "@types/pako": "^2.0.4",
+    "esbuild": "^0.27.2",
+    "tsx": "^4.21.0",
+    "typescript": "^5.6.0"
+  },
+  "engines": {
+    "node": ">=22.0.0"
+  },
+  "dependencies": {
+    "pako": "^2.1.0"
+  },
+  "packageManager": "npm@11.4.1+sha512.fcee43884166b6f9c5d04535fb95650e9708b6948a1f797eddf40e9778646778a518dfa32651b1c62ff36f4ac42becf177ca46ca27d53f24b539190c8d91802b"
+}