quake2ts 0.0.572 → 0.0.574

package/packages/test-utils/dist/index.d.cts

@@ -3,7 +3,7 @@ import { Mock } from 'vitest';
 import { Vec3, CollisionPlane, CollisionBrush, CollisionNode, CollisionLeaf, CollisionModel, PlayerState, EntityState, createRandomGenerator, NetDriver, UserCommand } from '@quake2ts/shared';
 export { intersects, ladderTrace, stairTrace } from '@quake2ts/shared';
 import { GameStateSnapshot, Entity, ScriptHookRegistry, SpawnContext, EntitySystem, SpawnRegistry, MonsterMove, DamageMod, PlayerInventory, BaseItem, WeaponId, WeaponItem, HealthItem, ArmorItem, AmmoItemId, PowerupItem, GameExports } from '@quake2ts/game';
-import { NetworkTransport, Server, ServerStatic, Client, ClientState } from '@quake2ts/server';
+import { NetworkTransport, Server, ServerStatic, Client, ClientState, ClientFrame } from '@quake2ts/server';
 import { ImageData } from '@napi-rs/canvas';
 import { LaunchOptions, BrowserContextOptions, Browser, BrowserContext, Page } from 'playwright';
 import { Server as Server$1 } from 'http';
@@ -485,6 +485,44 @@ declare function createMockRConClient(password?: string): MockRConClient;
  */
 declare function simulateServerCommand(server: any, command: string): string;
 
+interface MasterServer {
+    registerServer(info: ServerInfo): Promise<boolean>;
+    heartbeat(serverAddress: string): Promise<boolean>;
+    getServerList(filter?: ServerListFilter): Promise<ServerInfo[]>;
+}
+interface ServerInfo {
+    address: string;
+    name: string;
+    map: string;
+    players: number;
+    maxPlayers: number;
+    gametype: string;
+    version: string;
+    password?: boolean;
+}
+interface ServerListFilter {
+    gametype?: string;
+    map?: string;
+    notEmpty?: boolean;
+    notFull?: boolean;
+}
+/**
+ * Creates a mock master server for testing server registration and browsing
+ * @param overrides - Optional overrides for the master server behavior
+ */
+declare function createMockMasterServer(overrides?: Partial<MasterServer>): MasterServer;
+/**
+ * Creates a mock server info object
+ * @param overrides - Optional overrides
+ */
+declare function createMockServerInfo(overrides?: Partial<ServerInfo>): ServerInfo;
+/**
+ * Simulates the process of a game server registering with the master server
+ * @param server - The mock game server instance (typed as any to accept mock)
+ * @param master - The mock master server
+ */
+declare function simulateServerRegistration(server: any, master: MasterServer): Promise<boolean>;
+
 type MockServerContext = Server & {
     clients: (Client | null)[];
     entities?: Entity[];
@@ -562,6 +600,50 @@ declare function verifySnapshotConsistency(snapshots: Snapshot[]): ConsistencyRe
  */
 declare function simulateSnapshotDelivery(snapshot: Snapshot, reliability?: number): Promise<Snapshot | null>;
 
+interface RateLimiter {
+    bytesPerSecond: number;
+    allow(bytes: number): boolean;
+    update(deltaSeconds: number): void;
+    reset(): void;
+    getUsage(): number;
+}
+interface Message {
+    data: Uint8Array;
+    size: number;
+    timestamp: number;
+}
+interface BandwidthScenario {
+    bandwidth: number;
+    clients: Client[];
+    duration: number;
+    totalBytesSent: number;
+    totalBytesReceived: number;
+    droppedPackets: number;
+}
+/**
+ * Creates a mock rate limiter for bandwidth testing
+ * @param bytesPerSecond - Maximum bytes per second allowed
+ */
+declare function createMockRateLimiter(bytesPerSecond: number): RateLimiter;
+/**
+ * Simulates bandwidth limiting on a stream of messages
+ * @param messages - Array of messages to process
+ * @param bandwidth - Bandwidth limit in bytes per second
+ * @returns Filtered array of messages that passed the bandwidth check
+ */
+declare function simulateBandwidthLimit(messages: Message[], bandwidth: number): Message[];
+/**
+ * Calculates the size of a client snapshot in bytes
+ * @param snapshot - The client frame snapshot
+ */
+declare function measureSnapshotSize(snapshot: ClientFrame): number;
+/**
+ * Creates a scenario for testing bandwidth limits with multiple clients
+ * @param bandwidth - Bandwidth limit per client or total
+ * @param numClients - Number of clients to simulate
+ */
+declare function createBandwidthTestScenario(bandwidth: number, numClients: number): BandwidthScenario;
+
 interface BrowserSetupOptions {
     url?: string;
     pretendToBeVisual?: boolean;
@@ -809,4 +891,4 @@ interface VisualScenario {
  */
 declare function createVisualTestScenario(page: Page, sceneName: string): VisualScenario;
 
-export { type AudioEvent, type BinaryStreamMock, type BinaryWriterMock, type BrowserSetupOptions, type Connection, type ConsistencyReport, type ControlledTimer, type DeltaSnapshot, type DrawCall, type GameState, type GameStateCapture, type Handshake, HandshakeStage, InputInjector, type MockAI, type MockDamageInfo, type MockEngine, type MockGame, type MockMonsterAI, MockPointerLock, type MockRAF, type MockRConClient, type MockServer, type MockServerConsole, type MockServerContext, MockTransport, type MockUDPSocket, type MultiplayerScenario, type NetworkAddress, type NetworkCondition, type NetworkConfig, type NetworkSimulator, type NodeSetupOptions, type PlaywrightOptions, type PlaywrightTestClient, type Snapshot, type StorageScenario, type TestContext, type UserInfo, type VisualDiff, type VisualScenario, captureAudioEvents, captureCanvasDrawCalls, captureGameScreenshot, captureGameState, compareScreenshots, createBinaryStreamMock, createBinaryWriterMock, createCombatTestContext, createControlledTimer, createCustomNetworkCondition, createDeltaSnapshot, createEntity, createEntityFactory, createEntityStateFactory, createGameStateSnapshotFactory, createItemEntityFactory, createMockAI, createMockAmmoItem, createMockArmorItem, createMockAudioContext, createMockCanvas, createMockCanvasContext2D, createMockConnection, createMockDamageInfo, createMockEngine, createMockGPUAdapter, createMockGPUCanvasContext, createMockGPUDevice, createMockGame, createMockGameExports, createMockGameState, createMockHandshake, createMockHealthItem, createMockImage, createMockImageData, createMockIndexedDB, createMockInventory, createMockItem, createMockLocalStorage, createMockMonsterAI, createMockMonsterMove, createMockNetDriver, createMockNetworkAddress, createMockPerformance, createMockPowerupItem, createMockRAF, createMockRConClient, createMockServer, createMockServerClient, createMockServerConsole, createMockServerState, createMockServerStatic, createMockSessionStorage, createMockTransport, createMockUDPSocket, createMockUserInfo, createMockWeapon, createMockWeaponItem, createMockWebGL2Context, createMonsterEntityFactory, createMultiplayerTestScenario, createNetChanMock, createPhysicsTestContext, createPlayerEntityFactory, createPlayerStateFactory, createPlaywrightTestClient, createProjectileEntityFactory, createServerSnapshot, createSpawnTestContext, createStorageTestScenario, createTestContext, createTriggerEntityFactory, createVisualTestScenario, makeAxisBrush, makeBrushFromMinsMaxs, makeBspModel, makeLeaf, makeLeafModel, makeNode, makePlane, mockMonsterAttacks, serializeUserInfo, setupBrowserEnvironment, setupMockAudioContext, setupNodeEnvironment, setupWebGPUMocks, simulateFrames, simulateFramesWithMock, simulateHandshake, simulateNetworkCondition, simulatePlayerInput, simulatePlayerJoin, simulatePlayerLeave, simulateServerCommand, simulateServerTick, simulateSnapshotDelivery, teardownBrowserEnvironment, teardownMockAudioContext, throttleBandwidth, verifySnapshotConsistency, waitForGameReady };
+export { type AudioEvent, type BandwidthScenario, type BinaryStreamMock, type BinaryWriterMock, type BrowserSetupOptions, type Connection, type ConsistencyReport, type ControlledTimer, type DeltaSnapshot, type DrawCall, type GameState, type GameStateCapture, type Handshake, HandshakeStage, InputInjector, type MasterServer, type Message, type MockAI, type MockDamageInfo, type MockEngine, type MockGame, type MockMonsterAI, MockPointerLock, type MockRAF, type MockRConClient, type MockServer, type MockServerConsole, type MockServerContext, MockTransport, type MockUDPSocket, type MultiplayerScenario, type NetworkAddress, type NetworkCondition, type NetworkConfig, type NetworkSimulator, type NodeSetupOptions, type PlaywrightOptions, type PlaywrightTestClient, type RateLimiter, type ServerInfo, type ServerListFilter, type Snapshot, type StorageScenario, type TestContext, type UserInfo, type VisualDiff, type VisualScenario, captureAudioEvents, captureCanvasDrawCalls, captureGameScreenshot, captureGameState, compareScreenshots, createBandwidthTestScenario, createBinaryStreamMock, createBinaryWriterMock, createCombatTestContext, createControlledTimer, createCustomNetworkCondition, createDeltaSnapshot, createEntity, createEntityFactory, createEntityStateFactory, createGameStateSnapshotFactory, createItemEntityFactory, createMockAI, createMockAmmoItem, createMockArmorItem, createMockAudioContext, createMockCanvas, createMockCanvasContext2D, createMockConnection, createMockDamageInfo, createMockEngine, createMockGPUAdapter, createMockGPUCanvasContext, createMockGPUDevice, createMockGame, createMockGameExports, createMockGameState, createMockHandshake, createMockHealthItem, createMockImage, createMockImageData, createMockIndexedDB, createMockInventory, createMockItem, createMockLocalStorage, createMockMasterServer, createMockMonsterAI, createMockMonsterMove, createMockNetDriver, createMockNetworkAddress, createMockPerformance, createMockPowerupItem, createMockRAF, createMockRConClient, createMockRateLimiter, createMockServer, createMockServerClient, createMockServerConsole, createMockServerInfo, createMockServerState, createMockServerStatic, createMockSessionStorage, createMockTransport, createMockUDPSocket, createMockUserInfo, createMockWeapon, createMockWeaponItem, createMockWebGL2Context, createMonsterEntityFactory, createMultiplayerTestScenario, createNetChanMock, createPhysicsTestContext, createPlayerEntityFactory, createPlayerStateFactory, createPlaywrightTestClient, createProjectileEntityFactory, createServerSnapshot, createSpawnTestContext, createStorageTestScenario, createTestContext, createTriggerEntityFactory, createVisualTestScenario, makeAxisBrush, makeBrushFromMinsMaxs, makeBspModel, makeLeaf, makeLeafModel, makeNode, makePlane, measureSnapshotSize, mockMonsterAttacks, serializeUserInfo, setupBrowserEnvironment, setupMockAudioContext, setupNodeEnvironment, setupWebGPUMocks, simulateBandwidthLimit, simulateFrames, simulateFramesWithMock, simulateHandshake, simulateNetworkCondition, simulatePlayerInput, simulatePlayerJoin, simulatePlayerLeave, simulateServerCommand, simulateServerRegistration, simulateServerTick, simulateSnapshotDelivery, teardownBrowserEnvironment, teardownMockAudioContext, throttleBandwidth, verifySnapshotConsistency, waitForGameReady };

package/packages/test-utils/dist/index.d.ts

@@ -3,7 +3,7 @@ import { Mock } from 'vitest';
 import { Vec3, CollisionPlane, CollisionBrush, CollisionNode, CollisionLeaf, CollisionModel, PlayerState, EntityState, createRandomGenerator, NetDriver, UserCommand } from '@quake2ts/shared';
 export { intersects, ladderTrace, stairTrace } from '@quake2ts/shared';
 import { GameStateSnapshot, Entity, ScriptHookRegistry, SpawnContext, EntitySystem, SpawnRegistry, MonsterMove, DamageMod, PlayerInventory, BaseItem, WeaponId, WeaponItem, HealthItem, ArmorItem, AmmoItemId, PowerupItem, GameExports } from '@quake2ts/game';
-import { NetworkTransport, Server, ServerStatic, Client, ClientState } from '@quake2ts/server';
+import { NetworkTransport, Server, ServerStatic, Client, ClientState, ClientFrame } from '@quake2ts/server';
 import { ImageData } from '@napi-rs/canvas';
 import { LaunchOptions, BrowserContextOptions, Browser, BrowserContext, Page } from 'playwright';
 import { Server as Server$1 } from 'http';
@@ -485,6 +485,44 @@ declare function createMockRConClient(password?: string): MockRConClient;
  */
 declare function simulateServerCommand(server: any, command: string): string;
 
+interface MasterServer {
+    registerServer(info: ServerInfo): Promise<boolean>;
+    heartbeat(serverAddress: string): Promise<boolean>;
+    getServerList(filter?: ServerListFilter): Promise<ServerInfo[]>;
+}
+interface ServerInfo {
+    address: string;
+    name: string;
+    map: string;
+    players: number;
+    maxPlayers: number;
+    gametype: string;
+    version: string;
+    password?: boolean;
+}
+interface ServerListFilter {
+    gametype?: string;
+    map?: string;
+    notEmpty?: boolean;
+    notFull?: boolean;
+}
+/**
+ * Creates a mock master server for testing server registration and browsing
+ * @param overrides - Optional overrides for the master server behavior
+ */
+declare function createMockMasterServer(overrides?: Partial<MasterServer>): MasterServer;
+/**
+ * Creates a mock server info object
+ * @param overrides - Optional overrides
+ */
+declare function createMockServerInfo(overrides?: Partial<ServerInfo>): ServerInfo;
+/**
+ * Simulates the process of a game server registering with the master server
+ * @param server - The mock game server instance (typed as any to accept mock)
+ * @param master - The mock master server
+ */
+declare function simulateServerRegistration(server: any, master: MasterServer): Promise<boolean>;
+
 type MockServerContext = Server & {
     clients: (Client | null)[];
     entities?: Entity[];
@@ -562,6 +600,50 @@ declare function verifySnapshotConsistency(snapshots: Snapshot[]): ConsistencyRe
  */
 declare function simulateSnapshotDelivery(snapshot: Snapshot, reliability?: number): Promise<Snapshot | null>;
 
+interface RateLimiter {
+    bytesPerSecond: number;
+    allow(bytes: number): boolean;
+    update(deltaSeconds: number): void;
+    reset(): void;
+    getUsage(): number;
+}
+interface Message {
+    data: Uint8Array;
+    size: number;
+    timestamp: number;
+}
+interface BandwidthScenario {
+    bandwidth: number;
+    clients: Client[];
+    duration: number;
+    totalBytesSent: number;
+    totalBytesReceived: number;
+    droppedPackets: number;
+}
+/**
+ * Creates a mock rate limiter for bandwidth testing
+ * @param bytesPerSecond - Maximum bytes per second allowed
+ */
+declare function createMockRateLimiter(bytesPerSecond: number): RateLimiter;
+/**
+ * Simulates bandwidth limiting on a stream of messages
+ * @param messages - Array of messages to process
+ * @param bandwidth - Bandwidth limit in bytes per second
+ * @returns Filtered array of messages that passed the bandwidth check
+ */
+declare function simulateBandwidthLimit(messages: Message[], bandwidth: number): Message[];
+/**
+ * Calculates the size of a client snapshot in bytes
+ * @param snapshot - The client frame snapshot
+ */
+declare function measureSnapshotSize(snapshot: ClientFrame): number;
+/**
+ * Creates a scenario for testing bandwidth limits with multiple clients
+ * @param bandwidth - Bandwidth limit per client or total
+ * @param numClients - Number of clients to simulate
+ */
+declare function createBandwidthTestScenario(bandwidth: number, numClients: number): BandwidthScenario;
+
 interface BrowserSetupOptions {
     url?: string;
     pretendToBeVisual?: boolean;
@@ -809,4 +891,4 @@ interface VisualScenario {
  */
 declare function createVisualTestScenario(page: Page, sceneName: string): VisualScenario;
 
-export { type AudioEvent, type BinaryStreamMock, type BinaryWriterMock, type BrowserSetupOptions, type Connection, type ConsistencyReport, type ControlledTimer, type DeltaSnapshot, type DrawCall, type GameState, type GameStateCapture, type Handshake, HandshakeStage, InputInjector, type MockAI, type MockDamageInfo, type MockEngine, type MockGame, type MockMonsterAI, MockPointerLock, type MockRAF, type MockRConClient, type MockServer, type MockServerConsole, type MockServerContext, MockTransport, type MockUDPSocket, type MultiplayerScenario, type NetworkAddress, type NetworkCondition, type NetworkConfig, type NetworkSimulator, type NodeSetupOptions, type PlaywrightOptions, type PlaywrightTestClient, type Snapshot, type StorageScenario, type TestContext, type UserInfo, type VisualDiff, type VisualScenario, captureAudioEvents, captureCanvasDrawCalls, captureGameScreenshot, captureGameState, compareScreenshots, createBinaryStreamMock, createBinaryWriterMock, createCombatTestContext, createControlledTimer, createCustomNetworkCondition, createDeltaSnapshot, createEntity, createEntityFactory, createEntityStateFactory, createGameStateSnapshotFactory, createItemEntityFactory, createMockAI, createMockAmmoItem, createMockArmorItem, createMockAudioContext, createMockCanvas, createMockCanvasContext2D, createMockConnection, createMockDamageInfo, createMockEngine, createMockGPUAdapter, createMockGPUCanvasContext, createMockGPUDevice, createMockGame, createMockGameExports, createMockGameState, createMockHandshake, createMockHealthItem, createMockImage, createMockImageData, createMockIndexedDB, createMockInventory, createMockItem, createMockLocalStorage, createMockMonsterAI, createMockMonsterMove, createMockNetDriver, createMockNetworkAddress, createMockPerformance, createMockPowerupItem, createMockRAF, createMockRConClient, createMockServer, createMockServerClient, createMockServerConsole, createMockServerState, createMockServerStatic, createMockSessionStorage, createMockTransport, createMockUDPSocket, createMockUserInfo, createMockWeapon, createMockWeaponItem, createMockWebGL2Context, createMonsterEntityFactory, createMultiplayerTestScenario, createNetChanMock, createPhysicsTestContext, createPlayerEntityFactory, createPlayerStateFactory, createPlaywrightTestClient, createProjectileEntityFactory, createServerSnapshot, createSpawnTestContext, createStorageTestScenario, createTestContext, createTriggerEntityFactory, createVisualTestScenario, makeAxisBrush, makeBrushFromMinsMaxs, makeBspModel, makeLeaf, makeLeafModel, makeNode, makePlane, mockMonsterAttacks, serializeUserInfo, setupBrowserEnvironment, setupMockAudioContext, setupNodeEnvironment, setupWebGPUMocks, simulateFrames, simulateFramesWithMock, simulateHandshake, simulateNetworkCondition, simulatePlayerInput, simulatePlayerJoin, simulatePlayerLeave, simulateServerCommand, simulateServerTick, simulateSnapshotDelivery, teardownBrowserEnvironment, teardownMockAudioContext, throttleBandwidth, verifySnapshotConsistency, waitForGameReady };
+export { type AudioEvent, type BandwidthScenario, type BinaryStreamMock, type BinaryWriterMock, type BrowserSetupOptions, type Connection, type ConsistencyReport, type ControlledTimer, type DeltaSnapshot, type DrawCall, type GameState, type GameStateCapture, type Handshake, HandshakeStage, InputInjector, type MasterServer, type Message, type MockAI, type MockDamageInfo, type MockEngine, type MockGame, type MockMonsterAI, MockPointerLock, type MockRAF, type MockRConClient, type MockServer, type MockServerConsole, type MockServerContext, MockTransport, type MockUDPSocket, type MultiplayerScenario, type NetworkAddress, type NetworkCondition, type NetworkConfig, type NetworkSimulator, type NodeSetupOptions, type PlaywrightOptions, type PlaywrightTestClient, type RateLimiter, type ServerInfo, type ServerListFilter, type Snapshot, type StorageScenario, type TestContext, type UserInfo, type VisualDiff, type VisualScenario, captureAudioEvents, captureCanvasDrawCalls, captureGameScreenshot, captureGameState, compareScreenshots, createBandwidthTestScenario, createBinaryStreamMock, createBinaryWriterMock, createCombatTestContext, createControlledTimer, createCustomNetworkCondition, createDeltaSnapshot, createEntity, createEntityFactory, createEntityStateFactory, createGameStateSnapshotFactory, createItemEntityFactory, createMockAI, createMockAmmoItem, createMockArmorItem, createMockAudioContext, createMockCanvas, createMockCanvasContext2D, createMockConnection, createMockDamageInfo, createMockEngine, createMockGPUAdapter, createMockGPUCanvasContext, createMockGPUDevice, createMockGame, createMockGameExports, createMockGameState, createMockHandshake, createMockHealthItem, createMockImage, createMockImageData, createMockIndexedDB, createMockInventory, createMockItem, createMockLocalStorage, createMockMasterServer, createMockMonsterAI, createMockMonsterMove, createMockNetDriver, createMockNetworkAddress, createMockPerformance, createMockPowerupItem, createMockRAF, createMockRConClient, createMockRateLimiter, createMockServer, createMockServerClient, createMockServerConsole, createMockServerInfo, createMockServerState, createMockServerStatic, createMockSessionStorage, createMockTransport, createMockUDPSocket, createMockUserInfo, createMockWeapon, createMockWeaponItem, createMockWebGL2Context, createMonsterEntityFactory, createMultiplayerTestScenario, createNetChanMock, createPhysicsTestContext, createPlayerEntityFactory, createPlayerStateFactory, createPlaywrightTestClient, createProjectileEntityFactory, createServerSnapshot, createSpawnTestContext, createStorageTestScenario, createTestContext, createTriggerEntityFactory, createVisualTestScenario, makeAxisBrush, makeBrushFromMinsMaxs, makeBspModel, makeLeaf, makeLeafModel, makeNode, makePlane, measureSnapshotSize, mockMonsterAttacks, serializeUserInfo, setupBrowserEnvironment, setupMockAudioContext, setupNodeEnvironment, setupWebGPUMocks, simulateBandwidthLimit, simulateFrames, simulateFramesWithMock, simulateHandshake, simulateNetworkCondition, simulatePlayerInput, simulatePlayerJoin, simulatePlayerLeave, simulateServerCommand, simulateServerRegistration, simulateServerTick, simulateSnapshotDelivery, teardownBrowserEnvironment, teardownMockAudioContext, throttleBandwidth, verifySnapshotConsistency, waitForGameReady };

package/packages/test-utils/dist/index.js

@@ -1069,6 +1069,60 @@ function simulateServerCommand(server, command) {
   return "Unknown command handler";
 }
 
+// src/server/mocks/master.ts
+function createMockMasterServer(overrides = {}) {
+  const servers = /* @__PURE__ */ new Map();
+  return {
+    registerServer: async (info) => {
+      servers.set(info.address, info);
+      return true;
+    },
+    heartbeat: async (serverAddress) => {
+      return servers.has(serverAddress);
+    },
+    getServerList: async (filter) => {
+      let list = Array.from(servers.values());
+      if (filter) {
+        if (filter.gametype) {
+          list = list.filter((s) => s.gametype === filter.gametype);
+        }
+        if (filter.map) {
+          list = list.filter((s) => s.map === filter.map);
+        }
+        if (filter.notEmpty) {
+          list = list.filter((s) => s.players > 0);
+        }
+        if (filter.notFull) {
+          list = list.filter((s) => s.players < s.maxPlayers);
+        }
+      }
+      return list;
+    },
+    ...overrides
+  };
+}
+function createMockServerInfo(overrides = {}) {
+  return {
+    address: "127.0.0.1:27910",
+    name: "Quake 2 Test Server",
+    map: "q2dm1",
+    players: 0,
+    maxPlayers: 16,
+    gametype: "deathmatch",
+    version: "1.0",
+    ...overrides
+  };
+}
+async function simulateServerRegistration(server, master) {
+  const info = createMockServerInfo({
+    name: server.name || "Test Server",
+    map: server.mapName || "q2dm1",
+    players: server.clients ? server.clients.filter((c) => c && c.state >= 2).length : 0,
+    maxPlayers: server.maxClients || 16
+  });
+  return master.registerServer(info);
+}
+
 // src/server/helpers/multiplayer.ts
 import { ClientState as ClientState3 } from "@quake2ts/server";
 function createMultiplayerTestScenario(numPlayers = 2) {
@@ -1221,6 +1275,71 @@ async function simulateSnapshotDelivery(snapshot, reliability = 1) {
   return snapshot;
 }
 
+// src/server/helpers/bandwidth.ts
+function createMockRateLimiter(bytesPerSecond) {
+  let bucket = bytesPerSecond;
+  const maxBucket = bytesPerSecond;
+  let usage = 0;
+  return {
+    bytesPerSecond,
+    allow(bytes) {
+      if (bucket >= bytes) {
+        bucket -= bytes;
+        usage += bytes;
+        return true;
+      }
+      return false;
+    },
+    update(deltaSeconds) {
+      bucket += bytesPerSecond * deltaSeconds;
+      if (bucket > maxBucket) {
+        bucket = maxBucket;
+      }
+    },
+    reset() {
+      bucket = maxBucket;
+      usage = 0;
+    },
+    getUsage() {
+      return usage;
+    }
+  };
+}
+function simulateBandwidthLimit(messages, bandwidth) {
+  const limiter = createMockRateLimiter(bandwidth);
+  const result = [];
+  let lastTime = messages.length > 0 ? messages[0].timestamp : 0;
+  for (const msg of messages) {
+    const delta = (msg.timestamp - lastTime) / 1e3;
+    if (delta > 0) {
+      limiter.update(delta);
+    }
+    lastTime = msg.timestamp;
+    if (limiter.allow(msg.size)) {
+      result.push(msg);
+    }
+  }
+  return result;
+}
+function measureSnapshotSize(snapshot) {
+  let size = 0;
+  size += snapshot.areaBytes;
+  size += 200;
+  size += snapshot.entities.length * 20;
+  return size;
+}
+function createBandwidthTestScenario(bandwidth, numClients) {
+  const clients = [];
+  return {
+    bandwidth,
+    clients,
+    duration: 0,
+    totalBytesSent: 0,
+    totalBytesReceived: 0,
+    droppedPackets: 0
+  };
+}
+
 // src/setup/browser.ts
 import { JSDOM } from "jsdom";
 import { Canvas, Image, ImageData } from "@napi-rs/canvas";
@@ -2358,6 +2477,7 @@ export {
   captureGameScreenshot,
   captureGameState,
   compareScreenshots,
+  createBandwidthTestScenario,
   createBinaryStreamMock,
   createBinaryWriterMock,
   createCombatTestContext,
@@ -2392,6 +2512,7 @@ export {
   createMockInventory,
   createMockItem,
   createMockLocalStorage,
+  createMockMasterServer,
   createMockMonsterAI,
   createMockMonsterMove,
   createMockNetDriver,
@@ -2400,9 +2521,11 @@ export {
   createMockPowerupItem,
   createMockRAF,
   createMockRConClient,
+  createMockRateLimiter,
   createMockServer,
   createMockServerClient,
   createMockServerConsole,
+  createMockServerInfo,
   createMockServerState,
   createMockServerStatic,
   createMockSessionStorage,
@@ -2435,12 +2558,14 @@ export {
   makeLeafModel,
   makeNode,
   makePlane,
+  measureSnapshotSize,
   mockMonsterAttacks,
   serializeUserInfo,
   setupBrowserEnvironment,
   setupMockAudioContext,
   setupNodeEnvironment,
   setupWebGPUMocks,
+  simulateBandwidthLimit,
   simulateFrames,
   simulateFramesWithMock,
   simulateHandshake,
@@ -2449,6 +2574,7 @@ export {
   simulatePlayerJoin,
   simulatePlayerLeave,
   simulateServerCommand,
+  simulateServerRegistration,
   simulateServerTick,
   simulateSnapshotDelivery,
   stairTrace,