quake2ts 0.0.563 → 0.0.564

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

@@ -1,9 +1,9 @@
 import * as vitest from 'vitest';
 import { Mock } from 'vitest';
-import { Vec3, CollisionPlane, CollisionBrush, CollisionNode, CollisionLeaf, CollisionModel, PlayerState, EntityState, createRandomGenerator, NetDriver } from '@quake2ts/shared';
+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 } from '@quake2ts/game';
-import { NetworkTransport, Server, ServerStatic, Client } from '@quake2ts/server';
+import { NetworkTransport, Server, ServerStatic, Client, ClientState } from '@quake2ts/server';
 import { ImageData } from '@napi-rs/canvas';
 import { LaunchOptions, BrowserContextOptions, Browser, BrowserContext, Page } from 'playwright';
 import { Server as Server$1 } from 'http';
@@ -267,6 +267,155 @@ interface MockServer {
  */
 declare function createMockServer(overrides?: Partial<MockServer>): MockServer;
 
+/**
+ * Interface representing connection state for testing.
+ */
+interface Connection {
+    state: ClientState;
+    address: string;
+    challenge: number;
+    userInfo: UserInfo;
+}
+/**
+ * Stages of the client connection handshake.
+ */
+declare enum HandshakeStage {
+    None = 0,
+    Challenge = 1,
+    Connect = 2,
+    Info = 3,
+    Active = 4
+}
+/**
+ * Interface representing a handshake state.
+ */
+interface Handshake {
+    stage: HandshakeStage;
+    clientNum: number;
+    challenge: number;
+    qport: number;
+}
+/**
+ * Interface for UserInfo structure.
+ */
+interface UserInfo {
+    name: string;
+    skin: string;
+    model: string;
+    fov: number;
+    hand: number;
+    rate: number;
+    msg: number;
+    spectator?: number;
+    [key: string]: string | number | undefined;
+}
+/**
+ * Helper to serialize UserInfo to Quake 2 info string format.
+ * Format: \key\value\key2\value2
+ */
+declare function serializeUserInfo(info: UserInfo): string;
+/**
+ * Creates a mock UserInfo object.
+ * @param overrides Optional overrides for the user info.
+ */
+declare function createMockUserInfo(overrides?: Partial<UserInfo>): UserInfo;
+/**
+ * Creates a mock connection object (Client) with specific state.
+ * @param state The client state (default: Connected).
+ * @param overrides Optional overrides for the client.
+ */
+declare function createMockConnection(state?: ClientState, overrides?: Partial<Client>): Client;
+/**
+ * Creates a mock handshake object.
+ * @param stage The stage of the handshake (default: None).
+ */
+declare function createMockHandshake(stage?: HandshakeStage): Handshake;
+/**
+ * Simulates a handshake between a mock client and server.
+ * Note: This is a high-level simulation helper.
+ * @param client The mock client connection.
+ * @param server The mock server instance.
+ * @returns Promise that resolves to true if handshake succeeded.
+ */
+declare function simulateHandshake(client: Client, server: any): Promise<boolean>;
+
+type MockServerContext = Server & {
+    clients: (Client | null)[];
+    entities?: Entity[];
+};
+interface MultiplayerScenario {
+    server: MockServerContext;
+    clients: Client[];
+    entities: Entity[];
+}
+/**
+ * Creates a multiplayer test scenario with a mock server and a number of clients.
+ * @param numPlayers Number of players to simulate.
+ */
+declare function createMultiplayerTestScenario(numPlayers?: number): MultiplayerScenario;
+/**
+ * Simulates a player joining the server.
+ * @param server The mock server instance.
+ * @param userInfo Optional user info overrides.
+ */
+declare function simulatePlayerJoin(server: MockServerContext, userInfo?: Partial<UserInfo>): Promise<Client>;
+/**
+ * Simulates a player leaving the server.
+ * @param server The mock server instance.
+ * @param clientNum The client number to disconnect.
+ */
+declare function simulatePlayerLeave(server: MockServerContext, clientNum: number): void;
+/**
+ * Simulates a single server frame update.
+ * @param server The mock server instance.
+ * @param deltaTime Time step in seconds (default: 0.1).
+ */
+declare function simulateServerTick(server: MockServerContext, deltaTime?: number): void;
+/**
+ * Simulates player input for a specific client.
+ * @param client The server client.
+ * @param input The input command.
+ */
+declare function simulatePlayerInput(client: Client, input: Partial<UserCommand>): void;
+
+interface Snapshot {
+    serverTime: number;
+    playerState: any;
+    entities: EntityState[];
+}
+interface DeltaSnapshot {
+    snapshot: Snapshot;
+    deltaEntities: EntityState[];
+    removedEntities: number[];
+}
+interface ConsistencyReport {
+    valid: boolean;
+    errors: string[];
+}
+/**
+ * Creates a client-specific snapshot from the server state.
+ * @param serverState The current server state.
+ * @param clientNum The client number to generate snapshot for.
+ */
+declare function createServerSnapshot(serverState: Server, clientNum: number): Snapshot;
+/**
+ * Calculates the delta between two snapshots.
+ * @param oldSnapshot The baseline snapshot.
+ * @param newSnapshot The current snapshot.
+ */
+declare function createDeltaSnapshot(oldSnapshot: Snapshot, newSnapshot: Snapshot): DeltaSnapshot;
+/**
+ * Verifies the consistency of a sequence of snapshots.
+ * @param snapshots Array of snapshots ordered by time.
+ */
+declare function verifySnapshotConsistency(snapshots: Snapshot[]): ConsistencyReport;
+/**
+ * Simulates network delivery of a snapshot with potential packet loss.
+ * @param snapshot The snapshot to deliver.
+ * @param reliability Probability of successful delivery (0.0 to 1.0).
+ */
+declare function simulateSnapshotDelivery(snapshot: Snapshot, reliability?: number): Promise<Snapshot | null>;
+
 interface BrowserSetupOptions {
     url?: string;
     pretendToBeVisual?: boolean;
@@ -509,4 +658,4 @@ interface VisualScenario {
  */
 declare function createVisualTestScenario(page: Page, sceneName: string): VisualScenario;
 
-export { type AudioEvent, type BinaryStreamMock, type BinaryWriterMock, type BrowserSetupOptions, type ControlledTimer, type DrawCall, type GameState, type GameStateCapture, InputInjector, type MockEngine, type MockGame, MockPointerLock, type MockRAF, type MockServer, MockTransport, type MockUDPSocket, type NetworkAddress, type NetworkCondition, type NetworkConfig, type NetworkSimulator, type NodeSetupOptions, type PlaywrightOptions, type PlaywrightTestClient, type StorageScenario, type TestContext, type VisualDiff, type VisualScenario, captureAudioEvents, captureCanvasDrawCalls, captureGameScreenshot, captureGameState, compareScreenshots, createBinaryStreamMock, createBinaryWriterMock, createControlledTimer, createCustomNetworkCondition, createEntity, createEntityStateFactory, createGameStateSnapshotFactory, createMockAudioContext, createMockCanvas, createMockCanvasContext2D, createMockEngine, createMockGame, createMockGameState, createMockImage, createMockImageData, createMockIndexedDB, createMockLocalStorage, createMockNetworkAddress, createMockPerformance, createMockRAF, createMockServer, createMockServerClient, createMockServerState, createMockServerStatic, createMockSessionStorage, createMockTransport, createMockUDPSocket, createMockWebGL2Context, createNetChanMock, createPlayerStateFactory, createPlaywrightTestClient, createSpawnContext, createStorageTestScenario, createTestContext, createVisualTestScenario, makeAxisBrush, makeBrushFromMinsMaxs, makeBspModel, makeLeaf, makeLeafModel, makeNode, makePlane, setupBrowserEnvironment, setupMockAudioContext, setupNodeEnvironment, simulateFrames, simulateFramesWithMock, simulateNetworkCondition, teardownBrowserEnvironment, teardownMockAudioContext, throttleBandwidth, waitForGameReady };
+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 MockEngine, type MockGame, MockPointerLock, type MockRAF, type MockServer, 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, createControlledTimer, createCustomNetworkCondition, createDeltaSnapshot, createEntity, createEntityStateFactory, createGameStateSnapshotFactory, createMockAudioContext, createMockCanvas, createMockCanvasContext2D, createMockConnection, createMockEngine, createMockGame, createMockGameState, createMockHandshake, createMockImage, createMockImageData, createMockIndexedDB, createMockLocalStorage, createMockNetworkAddress, createMockPerformance, createMockRAF, createMockServer, createMockServerClient, createMockServerState, createMockServerStatic, createMockSessionStorage, createMockTransport, createMockUDPSocket, createMockUserInfo, createMockWebGL2Context, createMultiplayerTestScenario, createNetChanMock, createPlayerStateFactory, createPlaywrightTestClient, createServerSnapshot, createSpawnContext, createStorageTestScenario, createTestContext, createVisualTestScenario, makeAxisBrush, makeBrushFromMinsMaxs, makeBspModel, makeLeaf, makeLeafModel, makeNode, makePlane, serializeUserInfo, setupBrowserEnvironment, setupMockAudioContext, setupNodeEnvironment, simulateFrames, simulateFramesWithMock, simulateHandshake, simulateNetworkCondition, simulatePlayerInput, simulatePlayerJoin, simulatePlayerLeave, simulateServerTick, simulateSnapshotDelivery, teardownBrowserEnvironment, teardownMockAudioContext, throttleBandwidth, verifySnapshotConsistency, waitForGameReady };

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

@@ -1,9 +1,9 @@
 import * as vitest from 'vitest';
 import { Mock } from 'vitest';
-import { Vec3, CollisionPlane, CollisionBrush, CollisionNode, CollisionLeaf, CollisionModel, PlayerState, EntityState, createRandomGenerator, NetDriver } from '@quake2ts/shared';
+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 } from '@quake2ts/game';
-import { NetworkTransport, Server, ServerStatic, Client } from '@quake2ts/server';
+import { NetworkTransport, Server, ServerStatic, Client, ClientState } from '@quake2ts/server';
 import { ImageData } from '@napi-rs/canvas';
 import { LaunchOptions, BrowserContextOptions, Browser, BrowserContext, Page } from 'playwright';
 import { Server as Server$1 } from 'http';
@@ -267,6 +267,155 @@ interface MockServer {
  */
 declare function createMockServer(overrides?: Partial<MockServer>): MockServer;
 
+/**
+ * Interface representing connection state for testing.
+ */
+interface Connection {
+    state: ClientState;
+    address: string;
+    challenge: number;
+    userInfo: UserInfo;
+}
+/**
+ * Stages of the client connection handshake.
+ */
+declare enum HandshakeStage {
+    None = 0,
+    Challenge = 1,
+    Connect = 2,
+    Info = 3,
+    Active = 4
+}
+/**
+ * Interface representing a handshake state.
+ */
+interface Handshake {
+    stage: HandshakeStage;
+    clientNum: number;
+    challenge: number;
+    qport: number;
+}
+/**
+ * Interface for UserInfo structure.
+ */
+interface UserInfo {
+    name: string;
+    skin: string;
+    model: string;
+    fov: number;
+    hand: number;
+    rate: number;
+    msg: number;
+    spectator?: number;
+    [key: string]: string | number | undefined;
+}
+/**
+ * Helper to serialize UserInfo to Quake 2 info string format.
+ * Format: \key\value\key2\value2
+ */
+declare function serializeUserInfo(info: UserInfo): string;
+/**
+ * Creates a mock UserInfo object.
+ * @param overrides Optional overrides for the user info.
+ */
+declare function createMockUserInfo(overrides?: Partial<UserInfo>): UserInfo;
+/**
+ * Creates a mock connection object (Client) with specific state.
+ * @param state The client state (default: Connected).
+ * @param overrides Optional overrides for the client.
+ */
+declare function createMockConnection(state?: ClientState, overrides?: Partial<Client>): Client;
+/**
+ * Creates a mock handshake object.
+ * @param stage The stage of the handshake (default: None).
+ */
+declare function createMockHandshake(stage?: HandshakeStage): Handshake;
+/**
+ * Simulates a handshake between a mock client and server.
+ * Note: This is a high-level simulation helper.
+ * @param client The mock client connection.
+ * @param server The mock server instance.
+ * @returns Promise that resolves to true if handshake succeeded.
+ */
+declare function simulateHandshake(client: Client, server: any): Promise<boolean>;
+
+type MockServerContext = Server & {
+    clients: (Client | null)[];
+    entities?: Entity[];
+};
+interface MultiplayerScenario {
+    server: MockServerContext;
+    clients: Client[];
+    entities: Entity[];
+}
+/**
+ * Creates a multiplayer test scenario with a mock server and a number of clients.
+ * @param numPlayers Number of players to simulate.
+ */
+declare function createMultiplayerTestScenario(numPlayers?: number): MultiplayerScenario;
+/**
+ * Simulates a player joining the server.
+ * @param server The mock server instance.
+ * @param userInfo Optional user info overrides.
+ */
+declare function simulatePlayerJoin(server: MockServerContext, userInfo?: Partial<UserInfo>): Promise<Client>;
+/**
+ * Simulates a player leaving the server.
+ * @param server The mock server instance.
+ * @param clientNum The client number to disconnect.
+ */
+declare function simulatePlayerLeave(server: MockServerContext, clientNum: number): void;
+/**
+ * Simulates a single server frame update.
+ * @param server The mock server instance.
+ * @param deltaTime Time step in seconds (default: 0.1).
+ */
+declare function simulateServerTick(server: MockServerContext, deltaTime?: number): void;
+/**
+ * Simulates player input for a specific client.
+ * @param client The server client.
+ * @param input The input command.
+ */
+declare function simulatePlayerInput(client: Client, input: Partial<UserCommand>): void;
+
+interface Snapshot {
+    serverTime: number;
+    playerState: any;
+    entities: EntityState[];
+}
+interface DeltaSnapshot {
+    snapshot: Snapshot;
+    deltaEntities: EntityState[];
+    removedEntities: number[];
+}
+interface ConsistencyReport {
+    valid: boolean;
+    errors: string[];
+}
+/**
+ * Creates a client-specific snapshot from the server state.
+ * @param serverState The current server state.
+ * @param clientNum The client number to generate snapshot for.
+ */
+declare function createServerSnapshot(serverState: Server, clientNum: number): Snapshot;
+/**
+ * Calculates the delta between two snapshots.
+ * @param oldSnapshot The baseline snapshot.
+ * @param newSnapshot The current snapshot.
+ */
+declare function createDeltaSnapshot(oldSnapshot: Snapshot, newSnapshot: Snapshot): DeltaSnapshot;
+/**
+ * Verifies the consistency of a sequence of snapshots.
+ * @param snapshots Array of snapshots ordered by time.
+ */
+declare function verifySnapshotConsistency(snapshots: Snapshot[]): ConsistencyReport;
+/**
+ * Simulates network delivery of a snapshot with potential packet loss.
+ * @param snapshot The snapshot to deliver.
+ * @param reliability Probability of successful delivery (0.0 to 1.0).
+ */
+declare function simulateSnapshotDelivery(snapshot: Snapshot, reliability?: number): Promise<Snapshot | null>;
+
 interface BrowserSetupOptions {
     url?: string;
     pretendToBeVisual?: boolean;
@@ -509,4 +658,4 @@ interface VisualScenario {
  */
 declare function createVisualTestScenario(page: Page, sceneName: string): VisualScenario;
 
-export { type AudioEvent, type BinaryStreamMock, type BinaryWriterMock, type BrowserSetupOptions, type ControlledTimer, type DrawCall, type GameState, type GameStateCapture, InputInjector, type MockEngine, type MockGame, MockPointerLock, type MockRAF, type MockServer, MockTransport, type MockUDPSocket, type NetworkAddress, type NetworkCondition, type NetworkConfig, type NetworkSimulator, type NodeSetupOptions, type PlaywrightOptions, type PlaywrightTestClient, type StorageScenario, type TestContext, type VisualDiff, type VisualScenario, captureAudioEvents, captureCanvasDrawCalls, captureGameScreenshot, captureGameState, compareScreenshots, createBinaryStreamMock, createBinaryWriterMock, createControlledTimer, createCustomNetworkCondition, createEntity, createEntityStateFactory, createGameStateSnapshotFactory, createMockAudioContext, createMockCanvas, createMockCanvasContext2D, createMockEngine, createMockGame, createMockGameState, createMockImage, createMockImageData, createMockIndexedDB, createMockLocalStorage, createMockNetworkAddress, createMockPerformance, createMockRAF, createMockServer, createMockServerClient, createMockServerState, createMockServerStatic, createMockSessionStorage, createMockTransport, createMockUDPSocket, createMockWebGL2Context, createNetChanMock, createPlayerStateFactory, createPlaywrightTestClient, createSpawnContext, createStorageTestScenario, createTestContext, createVisualTestScenario, makeAxisBrush, makeBrushFromMinsMaxs, makeBspModel, makeLeaf, makeLeafModel, makeNode, makePlane, setupBrowserEnvironment, setupMockAudioContext, setupNodeEnvironment, simulateFrames, simulateFramesWithMock, simulateNetworkCondition, teardownBrowserEnvironment, teardownMockAudioContext, throttleBandwidth, waitForGameReady };
+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 MockEngine, type MockGame, MockPointerLock, type MockRAF, type MockServer, 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, createControlledTimer, createCustomNetworkCondition, createDeltaSnapshot, createEntity, createEntityStateFactory, createGameStateSnapshotFactory, createMockAudioContext, createMockCanvas, createMockCanvasContext2D, createMockConnection, createMockEngine, createMockGame, createMockGameState, createMockHandshake, createMockImage, createMockImageData, createMockIndexedDB, createMockLocalStorage, createMockNetworkAddress, createMockPerformance, createMockRAF, createMockServer, createMockServerClient, createMockServerState, createMockServerStatic, createMockSessionStorage, createMockTransport, createMockUDPSocket, createMockUserInfo, createMockWebGL2Context, createMultiplayerTestScenario, createNetChanMock, createPlayerStateFactory, createPlaywrightTestClient, createServerSnapshot, createSpawnContext, createStorageTestScenario, createTestContext, createVisualTestScenario, makeAxisBrush, makeBrushFromMinsMaxs, makeBspModel, makeLeaf, makeLeafModel, makeNode, makePlane, serializeUserInfo, setupBrowserEnvironment, setupMockAudioContext, setupNodeEnvironment, simulateFrames, simulateFramesWithMock, simulateHandshake, simulateNetworkCondition, simulatePlayerInput, simulatePlayerJoin, simulatePlayerLeave, simulateServerTick, simulateSnapshotDelivery, teardownBrowserEnvironment, teardownMockAudioContext, throttleBandwidth, verifySnapshotConsistency, waitForGameReady };

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

@@ -603,6 +603,214 @@ function createMockServer(overrides) {
   };
 }
 
+// src/server/mocks/connection.ts
+import { ClientState as ClientState2 } from "@quake2ts/server";
+var HandshakeStage = /* @__PURE__ */ ((HandshakeStage2) => {
+  HandshakeStage2[HandshakeStage2["None"] = 0] = "None";
+  HandshakeStage2[HandshakeStage2["Challenge"] = 1] = "Challenge";
+  HandshakeStage2[HandshakeStage2["Connect"] = 2] = "Connect";
+  HandshakeStage2[HandshakeStage2["Info"] = 3] = "Info";
+  HandshakeStage2[HandshakeStage2["Active"] = 4] = "Active";
+  return HandshakeStage2;
+})(HandshakeStage || {});
+function serializeUserInfo(info) {
+  return Object.entries(info).reduce((acc, [key, value]) => {
+    if (value !== void 0) {
+      return `${acc}\\${key}\\${value}`;
+    }
+    return acc;
+  }, "");
+}
+function createMockUserInfo(overrides) {
+  return {
+    name: "Player",
+    skin: "male/grunt",
+    model: "male/grunt",
+    fov: 90,
+    hand: 0,
+    rate: 25e3,
+    msg: 1,
+    ...overrides
+  };
+}
+function createMockConnection(state = ClientState2.Connected, overrides) {
+  return createMockServerClient(0, {
+    state,
+    userInfo: serializeUserInfo(createMockUserInfo()),
+    challenge: Math.floor(Math.random() * 1e5),
+    ...overrides
+  });
+}
+function createMockHandshake(stage = 0 /* None */) {
+  return {
+    stage,
+    clientNum: -1,
+    challenge: 0,
+    qport: Math.floor(Math.random() * 65536)
+  };
+}
+async function simulateHandshake(client, server) {
+  const challenge = Math.floor(Math.random() * 1e5);
+  client.challenge = challenge;
+  if (server && server.clients) {
+  }
+  client.state = ClientState2.Connected;
+  client.state = ClientState2.Active;
+  return true;
+}
+
+// src/server/helpers/multiplayer.ts
+import { ClientState as ClientState3 } from "@quake2ts/server";
+function createMultiplayerTestScenario(numPlayers = 2) {
+  const baseServer = createMockServerState();
+  const clients = [];
+  const entities = [];
+  const server = {
+    ...baseServer,
+    clients: new Array(numPlayers).fill(null),
+    entities: []
+  };
+  for (let i = 0; i < numPlayers; i++) {
+    const client = createMockServerClient(i, {
+      state: ClientState3.Active,
+      userInfo: serializeUserInfo(createMockUserInfo({ name: `Player${i}` }))
+    });
+    const entity = {
+      classname: "player",
+      s: { origin: { x: 0, y: 0, z: 0 }, number: i + 1 },
+      client
+    };
+    client.edict = entity;
+    server.clients[i] = client;
+    clients.push(client);
+    entities.push(entity);
+  }
+  server.entities = entities;
+  return {
+    server,
+    clients,
+    entities
+  };
+}
+async function simulatePlayerJoin(server, userInfo) {
+  const index = server.clients.findIndex((c) => !c || c.state === ClientState3.Free);
+  if (index === -1) {
+    throw new Error("Server full");
+  }
+  const client = createMockServerClient(index, {
+    state: ClientState3.Connected,
+    userInfo: serializeUserInfo(createMockUserInfo(userInfo))
+  });
+  server.clients[index] = client;
+  client.state = ClientState3.Active;
+  const entity = {
+    classname: "player",
+    s: { origin: { x: 0, y: 0, z: 0 }, number: index + 1 },
+    client
+  };
+  client.edict = entity;
+  if (server.entities && Array.isArray(server.entities)) {
+    server.entities[index + 1] = entity;
+  }
+  return client;
+}
+function simulatePlayerLeave(server, clientNum) {
+  const client = server.clients[clientNum];
+  if (client) {
+    client.state = ClientState3.Free;
+    client.edict = null;
+  }
+}
+function simulateServerTick(server, deltaTime = 0.1) {
+  server.time += deltaTime;
+  server.frame++;
+  server.clients.forEach((client) => {
+    if (client && client.state === ClientState3.Active) {
+    }
+  });
+}
+function simulatePlayerInput(client, input) {
+  const cmd = {
+    msec: 100,
+    buttons: 0,
+    angles: { x: 0, y: 0, z: 0 },
+    forwardmove: 0,
+    sidemove: 0,
+    upmove: 0,
+    sequence: client.lastCmd.sequence + 1,
+    lightlevel: 0,
+    impulse: 0,
+    ...input
+  };
+  client.lastCmd = cmd;
+  client.commandQueue.push(cmd);
+  client.commandCount++;
+}
+
+// src/server/helpers/snapshot.ts
+function createServerSnapshot(serverState, clientNum) {
+  const visibleEntities = [];
+  if (serverState.baselines) {
+    serverState.baselines.forEach((ent, index) => {
+      if (ent && index !== clientNum + 1) {
+        visibleEntities.push({ ...ent });
+      }
+    });
+  }
+  return {
+    serverTime: serverState.time,
+    playerState: {
+      origin: { x: 0, y: 0, z: 0 },
+      viewangles: { x: 0, y: 0, z: 0 },
+      pm_type: 0
+    },
+    entities: visibleEntities
+  };
+}
+function createDeltaSnapshot(oldSnapshot, newSnapshot) {
+  const deltaEntities = [];
+  const removedEntities = [];
+  const oldMap = new Map(oldSnapshot.entities.map((e) => [e.number, e]));
+  const newMap = new Map(newSnapshot.entities.map((e) => [e.number, e]));
+  newSnapshot.entities.forEach((newEnt) => {
+    const oldEnt = oldMap.get(newEnt.number);
+    if (!oldEnt) {
+      deltaEntities.push(newEnt);
+    } else if (JSON.stringify(newEnt) !== JSON.stringify(oldEnt)) {
+      deltaEntities.push(newEnt);
+    }
+  });
+  oldSnapshot.entities.forEach((oldEnt) => {
+    if (!newMap.has(oldEnt.number)) {
+      removedEntities.push(oldEnt.number);
+    }
+  });
+  return {
+    snapshot: newSnapshot,
+    deltaEntities,
+    removedEntities
+  };
+}
+function verifySnapshotConsistency(snapshots) {
+  const report = { valid: true, errors: [] };
+  if (snapshots.length < 2) return report;
+  for (let i = 1; i < snapshots.length; i++) {
+    const prev = snapshots[i - 1];
+    const curr = snapshots[i];
+    if (curr.serverTime <= prev.serverTime) {
+      report.valid = false;
+      report.errors.push(`Snapshot ${i} has time ${curr.serverTime} <= prev ${prev.serverTime}`);
+    }
+  }
+  return report;
+}
+async function simulateSnapshotDelivery(snapshot, reliability = 1) {
+  if (Math.random() > reliability) {
+    return null;
+  }
+  return snapshot;
+}
+
 // src/setup/browser.ts
 import { JSDOM } from "jsdom";
 import { Canvas, Image, ImageData } from "@napi-rs/canvas";
@@ -1668,6 +1876,7 @@ function createVisualTestScenario(page, sceneName) {
   };
 }
 export {
+  HandshakeStage,
   InputInjector,
   MockPointerLock,
   MockTransport,
@@ -1680,15 +1889,18 @@ export {
   createBinaryWriterMock,
   createControlledTimer,
   createCustomNetworkCondition,
+  createDeltaSnapshot,
   createEntity,
   createEntityStateFactory,
   createGameStateSnapshotFactory,
   createMockAudioContext,
   createMockCanvas,
   createMockCanvasContext2D,
+  createMockConnection,
   createMockEngine,
   createMockGame,
   createMockGameState,
+  createMockHandshake,
   createMockImage,
   createMockImageData,
   createMockIndexedDB,
@@ -1703,10 +1915,13 @@ export {
   createMockSessionStorage,
   createMockTransport,
   createMockUDPSocket,
+  createMockUserInfo,
   createMockWebGL2Context,
+  createMultiplayerTestScenario,
   createNetChanMock,
   createPlayerStateFactory,
   createPlaywrightTestClient,
+  createServerSnapshot,
   createSpawnContext,
   createStorageTestScenario,
   createTestContext,
@@ -1720,16 +1935,24 @@ export {
   makeLeafModel,
   makeNode,
   makePlane,
+  serializeUserInfo,
   setupBrowserEnvironment,
   setupMockAudioContext,
   setupNodeEnvironment,
   simulateFrames,
   simulateFramesWithMock,
+  simulateHandshake,
   simulateNetworkCondition,
+  simulatePlayerInput,
+  simulatePlayerJoin,
+  simulatePlayerLeave,
+  simulateServerTick,
+  simulateSnapshotDelivery,
   stairTrace,
   teardownBrowserEnvironment,
   teardownMockAudioContext,
   throttleBandwidth,
+  verifySnapshotConsistency,
   waitForGameReady
 };
 //# sourceMappingURL=index.js.map