@rpgjs/testing 4.3.0 → 5.0.0-alpha.26

package/dist/index.d.ts

@@ -0,0 +1,249 @@
+import { Provider } from '@signe/di';
+import { RpgClientEngine, RpgClient } from '@rpgjs/client';
+import { RpgServer, RpgPlayer } from '@rpgjs/server';
+/**
+ * Provides a default map loader for testing environments
+ *
+ * This function returns a `provideLoadMap` provider that creates mock maps
+ * with default dimensions (1024x768) and a minimal component. It's automatically
+ * used by `testing()` if no custom `provideLoadMap` is provided in `clientConfig.providers`.
+ *
+ * @returns A provider function that can be used with `provideLoadMap`
+ * @example
+ * ```ts
+ * // Used automatically by testing()
+ * const fixture = await testing([myModule])
+ *
+ * // Or use directly in clientConfig
+ * const fixture = await testing([myModule], {
+ *   providers: [provideTestingLoadMap()]
+ * })
+ * ```
+ */
+export declare function provideTestingLoadMap(): {
+    provide: string;
+    useFactory: (context: import('@rpgjs/client').Context) => void;
+}[];
+/**
+ * Testing utility function to set up server and client instances for unit testing
+ *
+ * This function creates a test environment with both server and client instances,
+ * allowing you to test player interactions, server hooks, and game mechanics.
+ *
+ * @param modules - Array of modules that can be either:
+ *   - Direct module objects: { server: RpgServer, client: RpgClient }
+ *   - Providers returned by createModule(): Provider[] with meta.server/client and useValue
+ * @param clientConfig - Optional client configuration
+ * @param serverConfig - Optional server configuration
+ * @returns Testing fixture with createClient method
+ * @example
+ * ```ts
+ * // Using direct modules
+ * const fixture = await testing([{
+ *   server: serverModule,
+ *   client: clientModule
+ * }])
+ *
+ * // Using createModule
+ * const myModule = createModule('MyModule', [{
+ *   server: serverModule,
+ *   client: clientModule
+ * }])
+ * const fixture = await testing(myModule)
+ * ```
+ */
+export declare function testing(modules?: ({
+    server?: RpgServer;
+    client?: RpgClient;
+} | Provider)[], clientConfig?: any, serverConfig?: any): Promise<{
+    createClient(): Promise<{
+        socket: any;
+        client: RpgClientEngine<any>;
+        readonly playerId: string;
+        readonly player: RpgPlayer;
+        /**
+         * Wait for player to be on a specific map
+         *
+         * This utility function waits for the `onJoinMap` hook to be triggered
+         * when the player joins the expected map, or throws an error if the timeout is exceeded.
+         *
+         * ## Design
+         *
+         * Uses RxJS to listen for map change events emitted by `onJoinMap`. The function:
+         * 1. Checks if the player is already on the expected map
+         * 2. Subscribes to the `mapChangeSubject` observable
+         * 3. Filters events to match the expected map ID
+         * 4. Uses `race` operator with a timer to implement timeout handling
+         * 5. Resolves with the player when the map change event is received
+         *
+         * @param expectedMapId - The expected map ID (without 'map-' prefix, e.g. 'map1')
+         * @param timeout - Maximum time to wait in milliseconds (default: 5000)
+         * @returns Promise that resolves when player is on the expected map
+         * @throws Error if timeout is exceeded
+         * @example
+         * ```ts
+         * const client = await fixture.createClient()
+         * await client.waitForMapChange('map1')
+         * ```
+         */
+        waitForMapChange(expectedMapId: string, timeout?: number): Promise<RpgPlayer>;
+        /**
+         * Manually trigger a game tick for processing inputs and physics
+         *
+         * This method is a convenience wrapper around the exported nextTick() function.
+         *
+         * @param timestamp - Optional timestamp to use for the tick (default: Date.now())
+         * @returns Promise that resolves when the tick is complete
+         *
+         * @example
+         * ```ts
+         * const client = await fixture.createClient()
+         *
+         * // Manually advance the game by one tick
+         * await client.nextTick()
+         * ```
+         */
+        nextTick(timestamp?: number): Promise<void>;
+    }>;
+    readonly server: any;
+    /**
+     * Clear all server, client instances and reset the DOM
+     *
+     * This method should be called in afterEach to clean up test state.
+     * It destroys all created client instances, clears the server, and resets the DOM.
+     *
+     * @example
+     * ```ts
+     * const fixture = await testing([myModule])
+     *
+     * afterEach(() => {
+     *   fixture.clear()
+     * })
+     * ```
+     */
+    clear(): Promise<void>;
+    applySyncToClient(): Promise<void>;
+}>;
+/**
+ * Clear all caches and reset test state
+ *
+ * This function should be called after the end of each test to clean up
+ * all server and client instances, clear caches, and reset the DOM.
+ *
+ * ## Design
+ *
+ * Cleans up all created fixtures, client engines, server instances, and resets
+ * the DOM to a clean state. This ensures no state leaks between tests.
+ *
+ * @returns void
+ *
+ * @example
+ * ```ts
+ * import { clear } from '@rpgjs/testing'
+ *
+ * afterEach(() => {
+ *   clear()
+ * })
+ * ```
+ */
+export declare function clear(): Promise<void>;
+/**
+ * Manually trigger a game tick for processing inputs and physics
+ *
+ * This function allows you to manually advance the game by one tick.
+ * It performs the following operations:
+ * 1. On server: processes pending inputs and advances physics
+ * 2. Server sends data to client
+ * 3. Client retrieves data and performs inputs (move, etc.) and server reconciliation
+ * 4. A tick is performed on the client
+ * 5. A tick is performed on VueJS (if Vue is used)
+ *
+ * @param client - The RpgClientEngine instance
+ * @param timestamp - Optional timestamp to use for the tick (default: Date.now())
+ * @returns Promise that resolves when the tick is complete
+ *
+ * @example
+ * ```ts
+ * import { nextTick } from '@rpgjs/testing'
+ *
+ * const client = await fixture.createClient()
+ *
+ * // Manually advance the game by one tick
+ * await nextTick(client.client, Date.now())
+ * ```
+ */
+export declare function nextTick(client: RpgClientEngine, timestamp?: number): Promise<void>;
+/**
+ * Wait for synchronization to complete on the client
+ *
+ * This function waits for the client to receive and process synchronization data
+ * from the server. It monitors the `playersReceived$` and `eventsReceived$` observables
+ * in the RpgClientEngine to determine when synchronization is complete.
+ *
+ * ## Design
+ *
+ * - Uses `combineLatest` to wait for both `playersReceived$` and `eventsReceived$` to be `true`
+ * - Filters to only proceed when both are `true`
+ * - Includes a timeout to prevent waiting indefinitely
+ * - Resets the observables to `false` before waiting to ensure we catch the next sync
+ *
+ * @param client - The RpgClientEngine instance
+ * @param timeout - Maximum time to wait in milliseconds (default: 1000ms)
+ * @returns Promise that resolves when synchronization is complete
+ * @throws Error if timeout is exceeded
+ *
+ * @example
+ * ```ts
+ * import { waitForSync } from '@rpgjs/testing'
+ *
+ * const client = await fixture.createClient()
+ *
+ * // Wait for sync to complete
+ * await waitForSync(client.client)
+ *
+ * // Now you can safely test client-side state
+ * expect(client.client.sceneMap.players()).toBeDefined()
+ * ```
+ */
+export declare function waitForSync(client: RpgClientEngine, timeout?: number): Promise<void>;
+/**
+ * Wait for complete synchronization cycle (server sync + client receive)
+ *
+ * This function performs a complete synchronization cycle:
+ * 1. Triggers a game tick using `nextTick()` which calls `syncChanges()` on all players
+ * 2. Waits for the client to receive and process the synchronization data
+ *
+ * This is useful when you need to ensure that server-side changes are fully
+ * synchronized to the client before testing client-side state.
+ *
+ * ## Design
+ *
+ * - Calls `nextTick()` to trigger server-side sync
+ * - Waits for client to receive sync data using `waitForSync()`
+ * - Ensures complete synchronization cycle is finished
+ *
+ * @param player - The RpgPlayer instance (optional, will sync all players if not provided)
+ * @param client - The RpgClientEngine instance
+ * @param timeout - Maximum time to wait in milliseconds (default: 1000ms)
+ * @returns Promise that resolves when synchronization is complete
+ * @throws Error if timeout is exceeded
+ *
+ * @example
+ * ```ts
+ * import { waitForSyncComplete } from '@rpgjs/testing'
+ *
+ * const client = await fixture.createClient()
+ * const player = client.player
+ *
+ * // Make a server-side change
+ * player.addItem('potion', 5)
+ *
+ * // Wait for sync to complete
+ * await waitForSyncComplete(player, client.client)
+ *
+ * // Now you can safely test client-side state
+ * const clientPlayer = client.client.sceneMap.players()[player.id]
+ * expect(clientPlayer.items()).toBeDefined()
+ * ```
+ */
+export declare function waitForSyncComplete(player: RpgPlayer | null, client: RpgClientEngine, timeout?: number): Promise<void>;

package/dist/index.js

@@ -0,0 +1,344 @@
+import { mergeConfig } from './node_modules/.pnpm/@signe_di@2.6.0/node_modules/@signe/di/dist/index.js';
+import { provideLoadMap, LoadMapToken, startGame, provideRpg, provideClientGlobalConfig, provideClientModules, inject, WebSocketToken, RpgClientEngine, clearInject } from '@rpgjs/client';
+import { createServer, provideServerModules, clearInject as clearInject$1 } from '@rpgjs/server';
+import { h, Container } from 'canvasengine';
+import { Subject, filter, take, map, timer, switchMap, throwError, firstValueFrom, race, combineLatest } from 'rxjs';
+
+function provideTestingLoadMap() {
+  return provideLoadMap((id) => {
+    return {
+      id,
+      data: {
+        width: 1024,
+        height: 768,
+        hitboxes: [],
+        params: {}
+      },
+      component: h(Container),
+      width: 1024,
+      height: 768
+    };
+  });
+}
+function normalizeModules(modules) {
+  if (!modules || modules.length === 0) {
+    return { serverModules: [], clientModules: [] };
+  }
+  const isProviderArray = modules.some(
+    (item) => item && typeof item === "object" && "meta" in item && "useValue" in item
+  );
+  const serverModules = [];
+  const clientModules = [];
+  if (!isProviderArray) {
+    modules.forEach((module) => {
+      if (module && typeof module === "object") {
+        if (module.server) {
+          serverModules.push(module.server);
+        }
+        if (module.client) {
+          clientModules.push(module.client);
+        }
+      }
+    });
+    return { serverModules, clientModules };
+  }
+  const seenUseValues = /* @__PURE__ */ new Set();
+  modules.forEach((provider) => {
+    if (!provider || typeof provider !== "object" || !("meta" in provider) || !("useValue" in provider)) {
+      return;
+    }
+    const { useValue } = provider;
+    if (seenUseValues.has(useValue)) {
+      return;
+    }
+    if (useValue && typeof useValue === "object" && ("server" in useValue || "client" in useValue)) {
+      seenUseValues.add(useValue);
+      if (useValue.server) {
+        serverModules.push(useValue.server);
+      }
+      if (useValue.client) {
+        clientModules.push(useValue.client);
+      }
+    }
+  });
+  return { serverModules, clientModules };
+}
+const globalFixtures = [];
+async function testing(modules = [], clientConfig = {}, serverConfig = {}) {
+  const { serverModules, clientModules } = normalizeModules(modules);
+  const mapChangeSubject = new Subject();
+  const serverClass = createServer({
+    ...serverConfig,
+    providers: [
+      provideServerModules([
+        ...serverModules,
+        {
+          player: {
+            onJoinMap(player, map2) {
+              const mapId = map2?.id;
+              if (mapId) {
+                mapChangeSubject.next({ mapId, player });
+              }
+            }
+          }
+        }
+      ]),
+      ...serverConfig.providers || []
+    ]
+  });
+  const hasLoadMap = clientConfig.providers?.some((provider) => {
+    if (Array.isArray(provider)) {
+      return provider.some((p) => p?.provide === LoadMapToken);
+    }
+    return provider?.provide === LoadMapToken;
+  }) || false;
+  await startGame(
+    mergeConfig(
+      {
+        ...clientConfig,
+        providers: [
+          provideClientGlobalConfig({}),
+          ...hasLoadMap ? [] : [provideTestingLoadMap()],
+          // Add only if not already provided
+          provideClientModules(clientModules),
+          ...clientConfig.providers || []
+        ]
+      },
+      {
+        providers: [provideRpg(serverClass, { env: { TEST: "true" } })]
+      }
+    )
+  );
+  const websocket = inject(WebSocketToken);
+  const clientEngine = inject(RpgClientEngine);
+  return {
+    async createClient() {
+      return {
+        socket: websocket.getSocket(),
+        client: clientEngine,
+        get playerId() {
+          return Object.keys(websocket.getServer().subRoom.players())[0];
+        },
+        get player() {
+          return websocket.getServer().subRoom.players()[this.playerId];
+        },
+        /**
+         * Wait for player to be on a specific map
+         *
+         * This utility function waits for the `onJoinMap` hook to be triggered
+         * when the player joins the expected map, or throws an error if the timeout is exceeded.
+         *
+         * ## Design
+         *
+         * Uses RxJS to listen for map change events emitted by `onJoinMap`. The function:
+         * 1. Checks if the player is already on the expected map
+         * 2. Subscribes to the `mapChangeSubject` observable
+         * 3. Filters events to match the expected map ID
+         * 4. Uses `race` operator with a timer to implement timeout handling
+         * 5. Resolves with the player when the map change event is received
+         *
+         * @param expectedMapId - The expected map ID (without 'map-' prefix, e.g. 'map1')
+         * @param timeout - Maximum time to wait in milliseconds (default: 5000)
+         * @returns Promise that resolves when player is on the expected map
+         * @throws Error if timeout is exceeded
+         * @example
+         * ```ts
+         * const client = await fixture.createClient()
+         * await client.waitForMapChange('map1')
+         * ```
+         */
+        async waitForMapChange(expectedMapId, timeout = 5e3) {
+          const currentMap = this.player.getCurrentMap();
+          if (currentMap?.id === expectedMapId) {
+            return this.player;
+          }
+          const mapChange$ = mapChangeSubject.pipe(
+            filter((event) => event.mapId === expectedMapId),
+            take(1),
+            map((event) => event.player)
+          );
+          const timeout$ = timer(timeout).pipe(
+            take(1),
+            switchMap(() => {
+              const currentMap2 = this.player.getCurrentMap();
+              return throwError(() => new Error(
+                `Timeout: Player did not reach map ${expectedMapId} within ${timeout}ms. Current map: ${currentMap2?.id || "null"}`
+              ));
+            })
+          );
+          try {
+            const result = await firstValueFrom(race([mapChange$, timeout$]));
+            return result;
+          } catch (error) {
+            if (error instanceof Error) {
+              throw error;
+            }
+            const currentMap2 = this.player.getCurrentMap();
+            throw new Error(
+              `Timeout: Player did not reach map ${expectedMapId} within ${timeout}ms. Current map: ${currentMap2?.id || "null"}`
+            );
+          }
+        },
+        /**
+         * Manually trigger a game tick for processing inputs and physics
+         *
+         * This method is a convenience wrapper around the exported nextTick() function.
+         *
+         * @param timestamp - Optional timestamp to use for the tick (default: Date.now())
+         * @returns Promise that resolves when the tick is complete
+         *
+         * @example
+         * ```ts
+         * const client = await fixture.createClient()
+         *
+         * // Manually advance the game by one tick
+         * await client.nextTick()
+         * ```
+         */
+        async nextTick(timestamp) {
+          return nextTick(this.client);
+        }
+      };
+    },
+    get server() {
+      return websocket.getServer();
+    },
+    /**
+     * Clear all server, client instances and reset the DOM
+     *
+     * This method should be called in afterEach to clean up test state.
+     * It destroys all created client instances, clears the server, and resets the DOM.
+     *
+     * @example
+     * ```ts
+     * const fixture = await testing([myModule])
+     *
+     * afterEach(() => {
+     *   fixture.clear()
+     * })
+     * ```
+     */
+    clear() {
+      return clear();
+    },
+    async applySyncToClient() {
+      this.server.subRoom.applySyncToClient();
+      await waitForSync(clientEngine);
+    }
+  };
+}
+async function clear() {
+  await new Promise((resolve) => setTimeout(resolve, 0));
+  for (const client of globalFixtures) {
+    try {
+      if (client.clientEngine && typeof client.clientEngine.clear === "function") {
+        client.clientEngine.clear();
+      }
+      const serverMap = client.server?.subRoom;
+      if (serverMap && typeof serverMap.clear === "function") {
+        serverMap.clear();
+      }
+    } catch (error) {
+      console.warn("Error during cleanup:", error);
+    }
+  }
+  globalFixtures.length = 0;
+  try {
+    clearInject();
+  } catch (error) {
+    console.warn("Error clearing client inject:", error);
+  }
+  try {
+    clearInject$1();
+  } catch (error) {
+    console.warn("Error clearing server inject:", error);
+  }
+  if (typeof window !== "undefined" && window.document) {
+    window.document.body.innerHTML = `<div id="rpg"></div>`;
+  }
+}
+async function nextTick(client, timestamp) {
+  if (!client) {
+    throw new Error("nextTick: client parameter is required");
+  }
+  const delta = 16;
+  const websocket = client.webSocket;
+  if (!websocket) {
+    throw new Error("nextTick: websocket not found in client");
+  }
+  const server = websocket.getServer();
+  if (!server) {
+    throw new Error("nextTick: server not found");
+  }
+  const serverMap = server.subRoom;
+  if (!serverMap) {
+    return;
+  }
+  for (const player of serverMap.getPlayers()) {
+    if (player.pendingInputs && player.pendingInputs.length > 0) {
+      await serverMap.processInput(player.id);
+    }
+  }
+  if (typeof serverMap.runFixedTicks === "function") {
+    serverMap.runFixedTicks(delta);
+  }
+  for (const player of serverMap.getPlayers()) {
+    if (player && typeof player.syncChanges === "function") {
+      player.syncChanges();
+    }
+  }
+  await new Promise((resolve) => setTimeout(resolve, 0));
+  const sceneMap = client.sceneMap;
+  if (sceneMap && typeof sceneMap.stepPredictionTick === "function") {
+    sceneMap.stepPredictionTick();
+  }
+}
+async function waitForSync(client, timeout = 1e3) {
+  if (!client) {
+    throw new Error("waitForSync: client parameter is required");
+  }
+  const playersReceived$ = client.playersReceived$;
+  const eventsReceived$ = client.eventsReceived$;
+  if (!playersReceived$ || !eventsReceived$) {
+    throw new Error(
+      "waitForSync: playersReceived$ or eventsReceived$ not found in client"
+    );
+  }
+  const playersAlreadyTrue = playersReceived$.getValue ? playersReceived$.getValue() === true : false;
+  const eventsAlreadyTrue = eventsReceived$.getValue ? eventsReceived$.getValue() === true : false;
+  if (playersAlreadyTrue && eventsAlreadyTrue) {
+    return;
+  }
+  playersReceived$.next(false);
+  eventsReceived$.next(false);
+  const syncComplete$ = combineLatest([
+    playersReceived$.pipe(filter((received) => received === true)),
+    eventsReceived$.pipe(filter((received) => received === true))
+  ]).pipe(take(1));
+  const timeoutPromise = new Promise((_, reject) => {
+    setTimeout(() => {
+      reject(
+        new Error(
+          `waitForSync: Timeout after ${timeout}ms. Synchronization did not complete.`
+        )
+      );
+    }, timeout);
+  });
+  await Promise.race([firstValueFrom(syncComplete$), timeoutPromise]);
+}
+async function waitForSyncComplete(player, client, timeout = 1e3) {
+  if (!client) {
+    throw new Error("waitForSyncComplete: client parameter is required");
+  }
+  const playersReceived$ = client.playersReceived$;
+  const eventsReceived$ = client.eventsReceived$;
+  if (playersReceived$ && eventsReceived$) {
+    playersReceived$.next(false);
+    eventsReceived$.next(false);
+  }
+  await nextTick(client);
+  await waitForSync(client, timeout);
+}
+
+export { clear, nextTick, provideTestingLoadMap, testing, waitForSync, waitForSyncComplete };
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sources":["../src/index.ts"],"sourcesContent":["import { mergeConfig, Provider } from \"@signe/di\";\nimport {\n  provideRpg,\n  startGame,\n  provideClientModules,\n  provideLoadMap,\n  provideClientGlobalConfig,\n  inject,\n  WebSocketToken,\n  AbstractWebsocket,\n  RpgClientEngine,\n  RpgClient,\n  LoadMapToken,\n} from \"@rpgjs/client\";\nimport {\n  createServer,\n  provideServerModules,\n  RpgServer,\n  RpgPlayer,\n} from \"@rpgjs/server\";\nimport { h, Container } from \"canvasengine\";\nimport { clearInject as clearClientInject } from \"@rpgjs/client\";\nimport { clearInject as clearServerInject } from \"@rpgjs/server\";\nimport { combineLatest, filter, take, firstValueFrom, Subject, map, throwError, race, timer, switchMap } from \"rxjs\";\n\n/**\n * Provides a default map loader for testing environments\n *\n * This function returns a `provideLoadMap` provider that creates mock maps\n * with default dimensions (1024x768) and a minimal component. It's automatically\n * used by `testing()` if no custom `provideLoadMap` is provided in `clientConfig.providers`.\n *\n * @returns A provider function that can be used with `provideLoadMap`\n * @example\n * ```ts\n * // Used automatically by testing()\n * const fixture = await testing([myModule])\n *\n * // Or use directly in clientConfig\n * const fixture = await testing([myModule], {\n *   providers: [provideTestingLoadMap()]\n * })\n * ```\n */\nexport function provideTestingLoadMap() {\n  return provideLoadMap((id: string) => {\n    return {\n      id,\n      data: {\n        width: 1024,\n        height: 768,\n        hitboxes: [],\n        params: {},\n      },\n      component: h(Container),\n      width: 1024,\n      height: 768,\n    };\n  });\n}\n\n/**\n * Normalizes modules input to extract server/client modules from createModule providers or direct module objects\n *\n * @param modules - Array of modules that can be either:\n *   - Direct module objects: { server: RpgServer, client: RpgClient }\n *   - Providers returned by createModule(): Provider[] with meta.server/client and useValue\n * @returns Object with separate arrays for server and client modules\n * @example\n * ```ts\n * // Direct modules\n * normalizeModules([{ server: serverModule, client: clientModule }])\n *\n * // createModule providers\n * const providers = createModule('MyModule', [{ server: serverModule, client: clientModule }])\n * normalizeModules(providers)\n * ```\n */\nfunction normalizeModules(modules: any[]): {\n  serverModules: RpgServer[];\n  clientModules: RpgClient[];\n} {\n  if (!modules || modules.length === 0) {\n    return { serverModules: [], clientModules: [] };\n  }\n\n  // Check if first item is a provider (has meta and useValue properties)\n  const isProviderArray = modules.some(\n    (item: any) =>\n      item && typeof item === \"object\" && \"meta\" in item && \"useValue\" in item\n  );\n\n  const serverModules: RpgServer[] = [];\n  const clientModules: RpgClient[] = [];\n\n  if (!isProviderArray) {\n    // Direct module objects, extract server and client separately\n    modules.forEach((module: any) => {\n      if (module && typeof module === \"object\") {\n        if (module.server) {\n          serverModules.push(module.server);\n        }\n        if (module.client) {\n          clientModules.push(module.client);\n        }\n      }\n    });\n    return { serverModules, clientModules };\n  }\n\n  // Extract modules from createModule providers\n  // createModule returns providers where useValue contains the original { server, client } object\n  // We need to group providers by their useValue to reconstruct the original modules\n  const seenUseValues = new Set<any>();\n\n  modules.forEach((provider: any) => {\n    if (\n      !provider ||\n      typeof provider !== \"object\" ||\n      !(\"meta\" in provider) ||\n      !(\"useValue\" in provider)\n    ) {\n      return;\n    }\n\n    const { useValue } = provider;\n\n    // Skip if we've already processed this useValue (same module, different provider for server/client)\n    if (seenUseValues.has(useValue)) {\n      return;\n    }\n\n    // Check if useValue has server or client properties (it's a module object)\n    if (\n      useValue &&\n      typeof useValue === \"object\" &&\n      (\"server\" in useValue || \"client\" in useValue)\n    ) {\n      seenUseValues.add(useValue);\n      if (useValue.server) {\n        serverModules.push(useValue.server);\n      }\n      if (useValue.client) {\n        clientModules.push(useValue.client);\n      }\n    }\n  });\n\n  return { serverModules, clientModules };\n}\n\n// Global storage for all created fixtures and clients (for clear() function)\nconst globalFixtures: Array<{\n  context: any;\n  clientEngine: RpgClientEngine;\n  websocket: AbstractWebsocket;\n  server?: any;\n}> = [];\n\n\n/**\n * Testing utility function to set up server and client instances for unit testing\n *\n * This function creates a test environment with both server and client instances,\n * allowing you to test player interactions, server hooks, and game mechanics.\n *\n * @param modules - Array of modules that can be either:\n *   - Direct module objects: { server: RpgServer, client: RpgClient }\n *   - Providers returned by createModule(): Provider[] with meta.server/client and useValue\n * @param clientConfig - Optional client configuration\n * @param serverConfig - Optional server configuration\n * @returns Testing fixture with createClient method\n * @example\n * ```ts\n * // Using direct modules\n * const fixture = await testing([{\n *   server: serverModule,\n *   client: clientModule\n * }])\n *\n * // Using createModule\n * const myModule = createModule('MyModule', [{\n *   server: serverModule,\n *   client: clientModule\n * }])\n * const fixture = await testing(myModule)\n * ```\n */\nexport async function testing(\n  modules: ({ server?: RpgServer; client?: RpgClient } | Provider)[] = [],\n  clientConfig: any = {},\n  serverConfig: any = {}\n) {\n  // Normalize modules to extract server/client from providers if needed\n  const { serverModules, clientModules } = normalizeModules(modules as any[]);\n\n  // Subject to emit map change events when onJoinMap is triggered\n  const mapChangeSubject = new Subject<{ mapId: string; player: RpgPlayer }>();\n\n  const serverClass = createServer({\n    ...serverConfig,\n    providers: [\n      provideServerModules([\n        ...serverModules,\n        {\n          player: {\n            onJoinMap(player: RpgPlayer, map: any) {\n              // Emit map change event to RxJS Subject\n              const mapId = map?.id;\n              if (mapId) {\n                mapChangeSubject.next({ mapId, player });\n              }\n            }\n          }\n        },\n      ]),\n      ...(serverConfig.providers || []),\n    ],\n  });\n\n  // Check if LoadMapToken is already provided in clientConfig.providers\n  // (provideLoadMap returns an array with LoadMapToken)\n  const hasLoadMap =\n    clientConfig.providers?.some((provider: any) => {\n      if (Array.isArray(provider)) {\n        return provider.some((p: any) => p?.provide === LoadMapToken);\n      }\n      return provider?.provide === LoadMapToken;\n    }) || false;\n\n  await startGame(\n    mergeConfig(\n      {\n        ...clientConfig,\n        providers: [\n          provideClientGlobalConfig({}),\n          ...(hasLoadMap ? [] : [provideTestingLoadMap()]), // Add only if not already provided\n          provideClientModules(clientModules),\n          ...(clientConfig.providers || []),\n        ],\n      },\n      {\n        providers: [provideRpg(serverClass, { env: { TEST: \"true\" } })],\n      }\n    )\n  );\n  const websocket = inject<AbstractWebsocket>(WebSocketToken) as any;\n  const clientEngine = inject<RpgClientEngine>(RpgClientEngine);\n\n  return {\n    async createClient() {\n      return {\n        socket: websocket.getSocket(),\n        client: clientEngine,\n        get playerId() {\n          return Object.keys(websocket.getServer().subRoom.players())[0];\n        },\n        get player(): RpgPlayer {\n          return websocket.getServer().subRoom.players()[this.playerId] as RpgPlayer;\n        },\n        /**\n         * Wait for player to be on a specific map\n         *\n         * This utility function waits for the `onJoinMap` hook to be triggered\n         * when the player joins the expected map, or throws an error if the timeout is exceeded.\n         *\n         * ## Design\n         *\n         * Uses RxJS to listen for map change events emitted by `onJoinMap`. The function:\n         * 1. Checks if the player is already on the expected map\n         * 2. Subscribes to the `mapChangeSubject` observable\n         * 3. Filters events to match the expected map ID\n         * 4. Uses `race` operator with a timer to implement timeout handling\n         * 5. Resolves with the player when the map change event is received\n         *\n         * @param expectedMapId - The expected map ID (without 'map-' prefix, e.g. 'map1')\n         * @param timeout - Maximum time to wait in milliseconds (default: 5000)\n         * @returns Promise that resolves when player is on the expected map\n         * @throws Error if timeout is exceeded\n         * @example\n         * ```ts\n         * const client = await fixture.createClient()\n         * await client.waitForMapChange('map1')\n         * ```\n         */\n        async waitForMapChange(\n          expectedMapId: string,\n          timeout = 5000\n        ): Promise<RpgPlayer> {\n          // Check if already on the expected map\n          const currentMap = this.player.getCurrentMap();\n          if (currentMap?.id === expectedMapId) {\n            return this.player;\n          }\n\n          // Create observable that filters map changes for the expected map ID\n          const mapChange$ = mapChangeSubject.pipe(\n            filter((event) => event.mapId === expectedMapId),\n            take(1),\n            map((event) => event.player)\n          );\n\n          // Create timeout observable that throws an error\n          const timeout$ = timer(timeout).pipe(\n            take(1),\n            switchMap(() => {\n              const currentMap = this.player.getCurrentMap();\n              return throwError(() => new Error(\n                `Timeout: Player did not reach map ${expectedMapId} within ${timeout}ms. ` +\n                  `Current map: ${currentMap?.id || \"null\"}`\n              ));\n            })\n          );\n\n          // Race between map change and timeout\n          try {\n            const result = await firstValueFrom(race([mapChange$, timeout$]));\n            return result as RpgPlayer;\n          } catch (error) {\n            if (error instanceof Error) {\n              throw error;\n            }\n            const currentMap = this.player.getCurrentMap();\n            throw new Error(\n              `Timeout: Player did not reach map ${expectedMapId} within ${timeout}ms. ` +\n                `Current map: ${currentMap?.id || \"null\"}`\n            );\n          }\n        },\n        /**\n         * Manually trigger a game tick for processing inputs and physics\n         *\n         * This method is a convenience wrapper around the exported nextTick() function.\n         *\n         * @param timestamp - Optional timestamp to use for the tick (default: Date.now())\n         * @returns Promise that resolves when the tick is complete\n         *\n         * @example\n         * ```ts\n         * const client = await fixture.createClient()\n         *\n         * // Manually advance the game by one tick\n         * await client.nextTick()\n         * ```\n         */\n        async nextTick(timestamp?: number): Promise<void> {\n          return nextTick(this.client, timestamp);\n        },\n      };\n    },\n    get server() {\n        return websocket.getServer();\n    },\n    /**\n     * Clear all server, client instances and reset the DOM\n     *\n     * This method should be called in afterEach to clean up test state.\n     * It destroys all created client instances, clears the server, and resets the DOM.\n     *\n     * @example\n     * ```ts\n     * const fixture = await testing([myModule])\n     *\n     * afterEach(() => {\n     *   fixture.clear()\n     * })\n     * ```\n     */\n    clear() {\n      return clear();\n    },\n    async applySyncToClient() {\n      this.server.subRoom.applySyncToClient();\n      await waitForSync(clientEngine);\n    },\n  };\n}\n\n/**\n * Clear all caches and reset test state\n *\n * This function should be called after the end of each test to clean up\n * all server and client instances, clear caches, and reset the DOM.\n *\n * ## Design\n *\n * Cleans up all created fixtures, client engines, server instances, and resets\n * the DOM to a clean state. This ensures no state leaks between tests.\n *\n * @returns void\n *\n * @example\n * ```ts\n * import { clear } from '@rpgjs/testing'\n *\n * afterEach(() => {\n *   clear()\n * })\n * ```\n */\nexport async function clear(): Promise<void> {\n\n  // Wait for the next tick to ensure all promises are resolved\n  await new Promise((resolve) => setTimeout(resolve, 0));\n\n  // Clean up all created client and server instances from all fixtures\n  for (const client of globalFixtures) {\n    try {\n      // Clear client engine\n      if (\n        client.clientEngine &&\n        typeof (client.clientEngine as any).clear === \"function\"\n      ) {\n        (client.clientEngine as any).clear();\n      }\n\n      // Clear server map (subRoom)\n      const serverMap = client.server?.subRoom as any;\n      if (serverMap && typeof serverMap.clear === \"function\") {\n        serverMap.clear();\n      }\n    } catch (error) {\n      // Silently ignore cleanup errors\n      console.warn(\"Error during cleanup:\", error);\n    }\n  }\n\n  // Clear the global fixtures array\n  globalFixtures.length = 0;\n\n  // Clear client context injection\n  try {\n    clearClientInject();\n  } catch (error) {\n    console.warn(\"Error clearing client inject:\", error);\n  }\n\n  // Clear server context injection\n  try {\n    clearServerInject();\n  } catch (error) {\n    console.warn(\"Error clearing server inject:\", error);\n  }\n\n  // Reset DOM\n  if (typeof window !== \"undefined\" && window.document) {\n    window.document.body.innerHTML = `<div id=\"rpg\"></div>`;\n  }\n}\n\n/**\n * Manually trigger a game tick for processing inputs and physics\n *\n * This function allows you to manually advance the game by one tick.\n * It performs the following operations:\n * 1. On server: processes pending inputs and advances physics\n * 2. Server sends data to client\n * 3. Client retrieves data and performs inputs (move, etc.) and server reconciliation\n * 4. A tick is performed on the client\n * 5. A tick is performed on VueJS (if Vue is used)\n *\n * @param client - The RpgClientEngine instance\n * @param timestamp - Optional timestamp to use for the tick (default: Date.now())\n * @returns Promise that resolves when the tick is complete\n *\n * @example\n * ```ts\n * import { nextTick } from '@rpgjs/testing'\n *\n * const client = await fixture.createClient()\n *\n * // Manually advance the game by one tick\n * await nextTick(client.client, Date.now())\n * ```\n */\nexport async function nextTick(\n  client: RpgClientEngine,\n  timestamp?: number\n): Promise<void> {\n  if (!client) {\n    throw new Error(\"nextTick: client parameter is required\");\n  }\n\n  const tickTimestamp = timestamp ?? Date.now();\n  const delta = 16; // 16ms for 60fps\n\n  // Get server instance from client context\n  const websocket = (client as any).webSocket;\n  if (!websocket) {\n    throw new Error(\"nextTick: websocket not found in client\");\n  }\n\n  const server = websocket.getServer();\n  if (!server) {\n    throw new Error(\"nextTick: server not found\");\n  }\n\n  // Get server map (subRoom)\n  const serverMap = server.subRoom as any;\n  if (!serverMap) {\n    return;\n  }\n\n  // 1. On server: Process inputs for all players\n  for (const player of serverMap.getPlayers()) {\n    if (player.pendingInputs && player.pendingInputs.length > 0) {\n      await serverMap.processInput(player.id);\n    }\n  }\n\n  // 2. Run physics tick on server map\n  if (typeof serverMap.runFixedTicks === \"function\") {\n    serverMap.runFixedTicks(delta);\n  }\n\n  // 3. Server sends data to client - trigger sync for all players\n  // The sync is triggered by calling syncChanges() on each player\n  for (const player of serverMap.getPlayers()) {\n    if (player && typeof (player as any).syncChanges === \"function\") {\n      (player as any).syncChanges();\n    }\n  }\n\n  // 4. Client retrieves data and performs reconciliation\n  // The sync data will be received by the client through the websocket\n  // We need to wait a bit for the sync data to be processed\n  await new Promise((resolve) => setTimeout(resolve, 0));\n\n  // 5. Run physics tick on client map (performs client-side prediction)\n  const sceneMap = (client as any).sceneMap;\n  if (sceneMap && typeof sceneMap.stepPredictionTick === \"function\") {\n    sceneMap.stepPredictionTick();\n  }\n\n  // 6. Trigger VueJS tick if Vue is used (handled by CanvasEngine internally)\n  // CanvasEngine handles this automatically through its tick system\n}\n\n/**\n * Wait for synchronization to complete on the client\n *\n * This function waits for the client to receive and process synchronization data\n * from the server. It monitors the `playersReceived$` and `eventsReceived$` observables\n * in the RpgClientEngine to determine when synchronization is complete.\n *\n * ## Design\n *\n * - Uses `combineLatest` to wait for both `playersReceived$` and `eventsReceived$` to be `true`\n * - Filters to only proceed when both are `true`\n * - Includes a timeout to prevent waiting indefinitely\n * - Resets the observables to `false` before waiting to ensure we catch the next sync\n *\n * @param client - The RpgClientEngine instance\n * @param timeout - Maximum time to wait in milliseconds (default: 1000ms)\n * @returns Promise that resolves when synchronization is complete\n * @throws Error if timeout is exceeded\n *\n * @example\n * ```ts\n * import { waitForSync } from '@rpgjs/testing'\n *\n * const client = await fixture.createClient()\n *\n * // Wait for sync to complete\n * await waitForSync(client.client)\n *\n * // Now you can safely test client-side state\n * expect(client.client.sceneMap.players()).toBeDefined()\n * ```\n */\nexport async function waitForSync(\n  client: RpgClientEngine,\n  timeout: number = 1000\n): Promise<void> {\n  if (!client) {\n    throw new Error(\"waitForSync: client parameter is required\");\n  }\n\n  // Access private observables via type assertion\n  const playersReceived$ = (client as any).playersReceived$ as any;\n  const eventsReceived$ = (client as any).eventsReceived$ as any;\n\n  if (!playersReceived$ || !eventsReceived$) {\n    throw new Error(\n      \"waitForSync: playersReceived$ or eventsReceived$ not found in client\"\n    );\n  }\n\n  // Check if observables are already true - if so, sync has already arrived, don't reset\n  const playersAlreadyTrue = playersReceived$.getValue\n    ? playersReceived$.getValue() === true\n    : false;\n  const eventsAlreadyTrue = eventsReceived$.getValue\n    ? eventsReceived$.getValue() === true\n    : false;\n\n  // If both observables are already true, sync has already completed - return immediately\n  if (playersAlreadyTrue && eventsAlreadyTrue) {\n    return;\n  }\n\n  // Reset observables to false to ensure we catch the next sync\n  // Note: This is only needed when waitForSync is called standalone.\n  // When called from waitForSyncComplete, observables are already reset before nextTick\n  playersReceived$.next(false);\n  eventsReceived$.next(false);\n\n  // Wait for both observables to be true\n  const syncComplete$ = combineLatest([\n    playersReceived$.pipe(filter((received) => received === true)),\n    eventsReceived$.pipe(filter((received) => received === true)),\n  ]).pipe(take(1));\n\n  // Create a timeout promise\n  const timeoutPromise = new Promise<never>((_, reject) => {\n    setTimeout(() => {\n      reject(\n        new Error(\n          `waitForSync: Timeout after ${timeout}ms. Synchronization did not complete.`\n        )\n      );\n    }, timeout);\n  });\n\n  // Race between sync completion and timeout\n  await Promise.race([firstValueFrom(syncComplete$), timeoutPromise]);\n}\n\n/**\n * Wait for complete synchronization cycle (server sync + client receive)\n *\n * This function performs a complete synchronization cycle:\n * 1. Triggers a game tick using `nextTick()` which calls `syncChanges()` on all players\n * 2. Waits for the client to receive and process the synchronization data\n *\n * This is useful when you need to ensure that server-side changes are fully\n * synchronized to the client before testing client-side state.\n *\n * ## Design\n *\n * - Calls `nextTick()` to trigger server-side sync\n * - Waits for client to receive sync data using `waitForSync()`\n * - Ensures complete synchronization cycle is finished\n *\n * @param player - The RpgPlayer instance (optional, will sync all players if not provided)\n * @param client - The RpgClientEngine instance\n * @param timeout - Maximum time to wait in milliseconds (default: 1000ms)\n * @returns Promise that resolves when synchronization is complete\n * @throws Error if timeout is exceeded\n *\n * @example\n * ```ts\n * import { waitForSyncComplete } from '@rpgjs/testing'\n *\n * const client = await fixture.createClient()\n * const player = client.player\n *\n * // Make a server-side change\n * player.addItem('potion', 5)\n *\n * // Wait for sync to complete\n * await waitForSyncComplete(player, client.client)\n *\n * // Now you can safely test client-side state\n * const clientPlayer = client.client.sceneMap.players()[player.id]\n * expect(clientPlayer.items()).toBeDefined()\n * ```\n */\nexport async function waitForSyncComplete(\n  player: RpgPlayer | null,\n  client: RpgClientEngine,\n  timeout: number = 1000\n): Promise<void> {\n  if (!client) {\n    throw new Error(\"waitForSyncComplete: client parameter is required\");\n  }\n\n  // Reset observables BEFORE calling nextTick to ensure we catch the sync that will be sent\n  // This prevents race condition where sync arrives before we start waiting\n  const playersReceived$ = (client as any).playersReceived$ as any;\n  const eventsReceived$ = (client as any).eventsReceived$ as any;\n  if (playersReceived$ && eventsReceived$) {\n    playersReceived$.next(false);\n    eventsReceived$.next(false);\n  }\n\n  // Trigger sync by calling nextTick (which calls syncChanges on all players)\n  await nextTick(client);\n\n  // Wait for client to receive and process the sync\n  await waitForSync(client, timeout);\n}\n"],"names":["map","currentMap","clearClientInject","clearServerInject"],"mappings":"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"}