@irtio/runtime 3.0.0 → 3.1.1

package/dist/{chunk-NPRIYYNM.js → chunk-2L3RGWXM.js}

@@ -3652,7 +3652,9 @@ function parseHibernationBlob(bytes) {
   const r = new ByteReader3(bytes);
   const version = r.u8();
   if (!READABLE_SNAPSHOT_VERSIONS.includes(version)) {
-    throw new Error(`RoomCore.restore: unsupported snapshot format version ${version}`);
+    throw new Error(
+      `RoomCore.restore: unsupported snapshot format version ${version} \u2014 this blob was written by a different irtio release`
+    );
   }
   const seed = r.u32();
   const rngState = r.u32();

package/dist/{chunk-3BCTP4YS.js → chunk-XPRLQCNF.js}

@@ -3,7 +3,7 @@ import {
   parseHibernationBlob,
   sameSchemaHash,
   writeHibernationBlob
-} from "./chunk-NPRIYYNM.js";
+} from "./chunk-2L3RGWXM.js";
 
 // src/migrate.ts
 import { PRESENCE_COLLECTION, withBuiltins } from "@irtio/protocol";

package/dist/index.js

@@ -2,7 +2,7 @@ import {
   fromMigrationState,
   migrateSnapshot,
   toMigrationState
-} from "./chunk-3BCTP4YS.js";
+} from "./chunk-XPRLQCNF.js";
 import {
   AdmissionError,
   CRASH_AFTER_THROWS,
@@ -58,7 +58,7 @@ import {
   visibleNames,
   visibleTo,
   writeHibernationBlob
-} from "./chunk-NPRIYYNM.js";
+} from "./chunk-2L3RGWXM.js";
 export {
   AdmissionError,
   CRASH_AFTER_THROWS,

package/dist/test/index.d.ts

@@ -148,16 +148,22 @@ declare class HarnessHost implements RoomHost {
     }[]>;
     private nextRecordingId;
     /**
-     * D44: the in-process harness has no supervisor, no sockets and therefore no loopback session
-     * to open. Recording the request rather than faking a session is the honest option: a test that
-     * wants to see an NPC *play* needs a real tenant (`packages/supervisor/test/npc.test.ts`), and
-     * one that wants to see a room ask for one reads these.
+     * D44: every NPC the room asked for, in order, and every despawn.
+     *
+     * On its own this host has no supervisor, no sockets and therefore no loopback session to open,
+     * so recording the request is all it can honestly do. A caller that *can* run an NPC — `testRoom`
+     * in `@irtio/testing`, which owns real in-process clients on this same clock — installs
+     * {@link onSpawnNpc} / {@link onDespawnNpc} and drives one. The arrays stay populated either way:
+     * a test that only wants to see that the room asked reads them, with or without a driver.
      */
     readonly spawnedNpcs: {
         clientId: string;
         config: NpcConfig;
     }[];
     readonly despawnedNpcs: string[];
+    /** Installed by a host embedder that can actually run an NPC session. */
+    onSpawnNpc: ((clientId: string, config: NpcConfig) => void) | undefined;
+    onDespawnNpc: ((clientId: string) => void) | undefined;
     spawnNpc(clientId: string, config: NpcConfig): void;
     despawnNpc(clientId: string): void;
     /** Every `room.bus.send` the room asked for, in order. */

package/dist/test/index.js

@@ -5,7 +5,7 @@ import {
   initPhysics,
   initRapier2d,
   visibleNames
-} from "../chunk-NPRIYYNM.js";
+} from "../chunk-2L3RGWXM.js";
 
 // src/test/clock.ts
 var FakeClock = class {
@@ -237,18 +237,26 @@ var HarnessHost = class {
   // Week 12: durable alarms (D26)
   // -------------------------------------------------------------------------
   /**
-   * D44: the in-process harness has no supervisor, no sockets and therefore no loopback session
-   * to open. Recording the request rather than faking a session is the honest option: a test that
-   * wants to see an NPC *play* needs a real tenant (`packages/supervisor/test/npc.test.ts`), and
-   * one that wants to see a room ask for one reads these.
+   * D44: every NPC the room asked for, in order, and every despawn.
+   *
+   * On its own this host has no supervisor, no sockets and therefore no loopback session to open,
+   * so recording the request is all it can honestly do. A caller that *can* run an NPC — `testRoom`
+   * in `@irtio/testing`, which owns real in-process clients on this same clock — installs
+   * {@link onSpawnNpc} / {@link onDespawnNpc} and drives one. The arrays stay populated either way:
+   * a test that only wants to see that the room asked reads them, with or without a driver.
    */
   spawnedNpcs = [];
   despawnedNpcs = [];
+  /** Installed by a host embedder that can actually run an NPC session. */
+  onSpawnNpc;
+  onDespawnNpc;
   spawnNpc(clientId, config) {
     this.spawnedNpcs.push({ clientId, config });
+    this.onSpawnNpc?.(clientId, config);
   }
   despawnNpc(clientId) {
     this.despawnedNpcs.push(clientId);
+    this.onDespawnNpc?.(clientId);
   }
   // -------------------------------------------------------------------------
   // D59: the bus

package/dist/worker/index.js

@@ -1,6 +1,6 @@
 import {
   migrateSnapshot
-} from "../chunk-3BCTP4YS.js";
+} from "../chunk-XPRLQCNF.js";
 import {
   AdmissionError,
   RoomCore,
@@ -10,7 +10,7 @@ import {
   initRapier2d,
   onFirstRapierStep,
   rapierHasStepped
-} from "../chunk-NPRIYYNM.js";
+} from "../chunk-2L3RGWXM.js";
 
 // src/worker/index.ts
 import { getHeapStatistics } from "v8";

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@irtio/runtime",
-  "version": "3.0.0",
+  "version": "3.1.1",
   "description": "irtio room runtime: RoomCore, worker_threads host, in-process test harness",
   "license": "MIT",
   "repository": {
@@ -36,9 +36,9 @@
     "@dimforge/rapier2d-compat": "0.20.0",
     "@dimforge/rapier3d-compat": "0.20.0",
     "matter-js": "0.20.0",
-    "@irtio/protocol": "3.0.0",
-    "@irtio/schema": "3.0.0",
-    "@irtio/server": "3.0.0"
+    "@irtio/protocol": "3.1.1",
+    "@irtio/schema": "3.1.1",
+    "@irtio/server": "3.1.1"
   },
   "devDependencies": {
     "@types/matter-js": "0.20.2"