quake2ts 0.0.566 → 0.0.568

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

@@ -230,6 +230,11 @@ declare function createMockNetworkAddress(ip?: string, port?: number): NetworkAd
  * @param overrides Optional overrides for the transport properties.
  */
 declare function createMockTransport(address?: string, port?: number, overrides?: Partial<MockTransport>): MockTransport;
+/**
+ * Creates a mock NetDriver instance.
+ * @param overrides Optional overrides for the NetDriver methods.
+ */
+declare function createMockNetDriver(overrides?: Partial<NetDriver>): NetDriver;
 
 /**
  * Creates a mock server state object.
@@ -339,6 +344,47 @@ declare function createMockHandshake(stage?: HandshakeStage): Handshake;
  */
 declare function simulateHandshake(client: Client, server: any): Promise<boolean>;
 
+/**
+ * Interface for a mocked server console that can execute commands.
+ * Reference: quake2/server/sv_main.c (SV_ExecuteUserCommand)
+ */
+interface MockServerConsole {
+    exec(cmd: string): string;
+    print(text: string): void;
+    broadcast(text: string): void;
+    commandBuffer: string[];
+    outputBuffer: string[];
+}
+/**
+ * Creates a mock server console.
+ * @param overrides Optional overrides for the mock console.
+ */
+declare function createMockServerConsole(overrides?: Partial<MockServerConsole>): MockServerConsole;
+/**
+ * Interface for a mocked RCON client.
+ * Reference: quake2/server/sv_user.c (SV_ExecuteUserCommand for RCON handling)
+ */
+interface MockRConClient {
+    connect(address: string, port: number, password?: string): Promise<boolean>;
+    sendCommand(cmd: string): Promise<string>;
+    disconnect(): void;
+    connected: boolean;
+    lastCommand: string;
+    lastResponse: string;
+}
+/**
+ * Creates a mock RCON client.
+ * @param password Optional password for the client to use.
+ */
+declare function createMockRConClient(password?: string): MockRConClient;
+/**
+ * Simulates a command execution on the server.
+ * @param server The mock server instance (assumed to have some command handling capability).
+ * @param command The command string to execute.
+ * @returns The output of the command.
+ */
+declare function simulateServerCommand(server: any, command: string): string;
+
 type MockServerContext = Server & {
     clients: (Client | null)[];
     entities?: Entity[];
@@ -663,4 +709,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 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, createMockGPUAdapter, createMockGPUCanvasContext, createMockGPUDevice, 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, setupWebGPUMocks, simulateFrames, simulateFramesWithMock, simulateHandshake, simulateNetworkCondition, simulatePlayerInput, simulatePlayerJoin, simulatePlayerLeave, simulateServerTick, simulateSnapshotDelivery, teardownBrowserEnvironment, teardownMockAudioContext, throttleBandwidth, verifySnapshotConsistency, 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 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, createControlledTimer, createCustomNetworkCondition, createDeltaSnapshot, createEntity, createEntityStateFactory, createGameStateSnapshotFactory, createMockAudioContext, createMockCanvas, createMockCanvasContext2D, createMockConnection, createMockEngine, createMockGPUAdapter, createMockGPUCanvasContext, createMockGPUDevice, createMockGame, createMockGameState, createMockHandshake, createMockImage, createMockImageData, createMockIndexedDB, createMockLocalStorage, createMockNetDriver, createMockNetworkAddress, createMockPerformance, createMockRAF, createMockRConClient, createMockServer, createMockServerClient, createMockServerConsole, 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, setupWebGPUMocks, simulateFrames, simulateFramesWithMock, simulateHandshake, simulateNetworkCondition, simulatePlayerInput, simulatePlayerJoin, simulatePlayerLeave, simulateServerCommand, simulateServerTick, simulateSnapshotDelivery, teardownBrowserEnvironment, teardownMockAudioContext, throttleBandwidth, verifySnapshotConsistency, waitForGameReady };

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

@@ -230,6 +230,11 @@ declare function createMockNetworkAddress(ip?: string, port?: number): NetworkAd
  * @param overrides Optional overrides for the transport properties.
  */
 declare function createMockTransport(address?: string, port?: number, overrides?: Partial<MockTransport>): MockTransport;
+/**
+ * Creates a mock NetDriver instance.
+ * @param overrides Optional overrides for the NetDriver methods.
+ */
+declare function createMockNetDriver(overrides?: Partial<NetDriver>): NetDriver;
 
 /**
  * Creates a mock server state object.
@@ -339,6 +344,47 @@ declare function createMockHandshake(stage?: HandshakeStage): Handshake;
  */
 declare function simulateHandshake(client: Client, server: any): Promise<boolean>;
 
+/**
+ * Interface for a mocked server console that can execute commands.
+ * Reference: quake2/server/sv_main.c (SV_ExecuteUserCommand)
+ */
+interface MockServerConsole {
+    exec(cmd: string): string;
+    print(text: string): void;
+    broadcast(text: string): void;
+    commandBuffer: string[];
+    outputBuffer: string[];
+}
+/**
+ * Creates a mock server console.
+ * @param overrides Optional overrides for the mock console.
+ */
+declare function createMockServerConsole(overrides?: Partial<MockServerConsole>): MockServerConsole;
+/**
+ * Interface for a mocked RCON client.
+ * Reference: quake2/server/sv_user.c (SV_ExecuteUserCommand for RCON handling)
+ */
+interface MockRConClient {
+    connect(address: string, port: number, password?: string): Promise<boolean>;
+    sendCommand(cmd: string): Promise<string>;
+    disconnect(): void;
+    connected: boolean;
+    lastCommand: string;
+    lastResponse: string;
+}
+/**
+ * Creates a mock RCON client.
+ * @param password Optional password for the client to use.
+ */
+declare function createMockRConClient(password?: string): MockRConClient;
+/**
+ * Simulates a command execution on the server.
+ * @param server The mock server instance (assumed to have some command handling capability).
+ * @param command The command string to execute.
+ * @returns The output of the command.
+ */
+declare function simulateServerCommand(server: any, command: string): string;
+
 type MockServerContext = Server & {
     clients: (Client | null)[];
     entities?: Entity[];
@@ -663,4 +709,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 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, createMockGPUAdapter, createMockGPUCanvasContext, createMockGPUDevice, 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, setupWebGPUMocks, simulateFrames, simulateFramesWithMock, simulateHandshake, simulateNetworkCondition, simulatePlayerInput, simulatePlayerJoin, simulatePlayerLeave, simulateServerTick, simulateSnapshotDelivery, teardownBrowserEnvironment, teardownMockAudioContext, throttleBandwidth, verifySnapshotConsistency, 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 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, createControlledTimer, createCustomNetworkCondition, createDeltaSnapshot, createEntity, createEntityStateFactory, createGameStateSnapshotFactory, createMockAudioContext, createMockCanvas, createMockCanvasContext2D, createMockConnection, createMockEngine, createMockGPUAdapter, createMockGPUCanvasContext, createMockGPUDevice, createMockGame, createMockGameState, createMockHandshake, createMockImage, createMockImageData, createMockIndexedDB, createMockLocalStorage, createMockNetDriver, createMockNetworkAddress, createMockPerformance, createMockRAF, createMockRConClient, createMockServer, createMockServerClient, createMockServerConsole, 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, setupWebGPUMocks, simulateFrames, simulateFramesWithMock, simulateHandshake, simulateNetworkCondition, simulatePlayerInput, simulatePlayerJoin, simulatePlayerLeave, simulateServerCommand, simulateServerTick, simulateSnapshotDelivery, teardownBrowserEnvironment, teardownMockAudioContext, throttleBandwidth, verifySnapshotConsistency, waitForGameReady };

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

@@ -490,6 +490,18 @@ function createMockTransport(address = "127.0.0.1", port = 27910, overrides) {
   Object.assign(transport, overrides);
   return transport;
 }
+function createMockNetDriver(overrides) {
+  return {
+    connect: vi3.fn().mockResolvedValue(void 0),
+    disconnect: vi3.fn(),
+    send: vi3.fn(),
+    onMessage: vi3.fn(),
+    onClose: vi3.fn(),
+    onError: vi3.fn(),
+    isConnected: vi3.fn().mockReturnValue(true),
+    ...overrides
+  };
+}
 
 // src/server/mocks/state.ts
 import { ServerState, ClientState } from "@quake2ts/server";
@@ -524,15 +536,7 @@ function createMockServerStatic(maxClients = 16, overrides) {
   };
 }
 function createMockServerClient(clientNum, overrides) {
-  const mockNet = {
-    connect: vi4.fn(),
-    disconnect: vi4.fn(),
-    send: vi4.fn(),
-    onMessage: vi4.fn(),
-    onClose: vi4.fn(),
-    onError: vi4.fn(),
-    isConnected: vi4.fn().mockReturnValue(true)
-  };
+  const mockNet = createMockNetDriver();
   return {
     index: clientNum,
     state: ClientState.Connected,
@@ -659,6 +663,52 @@ async function simulateHandshake(client, server) {
   return true;
 }
 
+// src/server/mocks/commands.ts
+import { vi as vi5 } from "vitest";
+function createMockServerConsole(overrides) {
+  const outputBuffer = [];
+  const commandBuffer = [];
+  return {
+    exec: vi5.fn((cmd) => {
+      commandBuffer.push(cmd);
+      return `Executed: ${cmd}`;
+    }),
+    print: vi5.fn((text) => {
+      outputBuffer.push(text);
+    }),
+    broadcast: vi5.fn((text) => {
+      outputBuffer.push(`Broadcast: ${text}`);
+    }),
+    commandBuffer,
+    outputBuffer,
+    ...overrides
+  };
+}
+function createMockRConClient(password = "") {
+  return {
+    connected: false,
+    lastCommand: "",
+    lastResponse: "",
+    connect: vi5.fn(async (address, port, pwd) => {
+      return pwd === password;
+    }),
+    sendCommand: vi5.fn(async (cmd) => {
+      return `RCON Response for: ${cmd}`;
+    }),
+    disconnect: vi5.fn()
+  };
+}
+function simulateServerCommand(server, command) {
+  if (server.executeBuffer) {
+    server.executeBuffer(command);
+    return "Executed";
+  }
+  if (server.exec) {
+    return server.exec(command);
+  }
+  return "Unknown command handler";
+}
+
 // src/server/helpers/multiplayer.ts
 import { ClientState as ClientState3 } from "@quake2ts/server";
 function createMultiplayerTestScenario(numPlayers = 2) {
@@ -1288,10 +1338,10 @@ function createMockImage(width, height, src) {
 }
 
 // src/engine/mocks/webgpu.ts
-import { vi as vi5 } from "vitest";
+import { vi as vi6 } from "vitest";
 function createMockGPUAdapter() {
   return {
-    requestDevice: vi5.fn().mockResolvedValue(createMockGPUDevice()),
+    requestDevice: vi6.fn().mockResolvedValue(createMockGPUDevice()),
     features: /* @__PURE__ */ new Set(),
     limits: {}
   };
@@ -1301,40 +1351,40 @@ function createMockGPUDevice() {
     features: /* @__PURE__ */ new Set(),
     limits: {},
     queue: {
-      submit: vi5.fn(),
-      writeBuffer: vi5.fn(),
-      writeTexture: vi5.fn(),
-      copyExternalImageToTexture: vi5.fn()
-    },
-    createCommandEncoder: vi5.fn().mockReturnValue({
-      beginRenderPass: vi5.fn().mockReturnValue({
-        setPipeline: vi5.fn(),
-        draw: vi5.fn(),
-        end: vi5.fn()
+      submit: vi6.fn(),
+      writeBuffer: vi6.fn(),
+      writeTexture: vi6.fn(),
+      copyExternalImageToTexture: vi6.fn()
+    },
+    createCommandEncoder: vi6.fn().mockReturnValue({
+      beginRenderPass: vi6.fn().mockReturnValue({
+        setPipeline: vi6.fn(),
+        draw: vi6.fn(),
+        end: vi6.fn()
       }),
-      finish: vi5.fn()
+      finish: vi6.fn()
     }),
-    createRenderPipeline: vi5.fn(),
-    createShaderModule: vi5.fn(),
-    createBindGroup: vi5.fn(),
-    createBindGroupLayout: vi5.fn(),
-    createBuffer: vi5.fn(),
-    createTexture: vi5.fn(),
-    createSampler: vi5.fn()
+    createRenderPipeline: vi6.fn(),
+    createShaderModule: vi6.fn(),
+    createBindGroup: vi6.fn(),
+    createBindGroupLayout: vi6.fn(),
+    createBuffer: vi6.fn(),
+    createTexture: vi6.fn(),
+    createSampler: vi6.fn()
   };
 }
 function createMockGPUCanvasContext() {
   return {
-    configure: vi5.fn(),
-    unconfigure: vi5.fn(),
-    getCurrentTexture: vi5.fn()
+    configure: vi6.fn(),
+    unconfigure: vi6.fn(),
+    getCurrentTexture: vi6.fn()
   };
 }
 function setupWebGPUMocks() {
   const mockAdapter = createMockGPUAdapter();
   const mockGpu = {
-    requestAdapter: vi5.fn().mockResolvedValue(mockAdapter),
-    getPreferredCanvasFormat: vi5.fn().mockReturnValue("bgra8unorm")
+    requestAdapter: vi6.fn().mockResolvedValue(mockAdapter),
+    getPreferredCanvasFormat: vi6.fn().mockReturnValue("bgra8unorm")
   };
   Object.defineProperty(global.navigator, "gpu", {
     value: mockGpu,
@@ -1971,11 +2021,14 @@ export {
   createMockImageData,
   createMockIndexedDB,
   createMockLocalStorage,
+  createMockNetDriver,
   createMockNetworkAddress,
   createMockPerformance,
   createMockRAF,
+  createMockRConClient,
   createMockServer,
   createMockServerClient,
+  createMockServerConsole,
   createMockServerState,
   createMockServerStatic,
   createMockSessionStorage,
@@ -2013,6 +2066,7 @@ export {
   simulatePlayerInput,
   simulatePlayerJoin,
   simulatePlayerLeave,
+  simulateServerCommand,
   simulateServerTick,
   simulateSnapshotDelivery,
   stairTrace,