@irtio/runtime 3.1.0 → 4.0.0

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

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

package/dist/{chunk-NPRIYYNM.js → chunk-S4D472RL.js}

@@ -578,12 +578,12 @@ import {
   SERVER_OWNER as SERVER_OWNER2,
   decodeFields,
   encodeFields,
-  validateValue
+  validateValue as validateValue2
 } from "@irtio/schema";
 import { DenyError } from "@irtio/server";
 
 // src/core/ownership.ts
-import { SERVER_OWNER, defaultRecord } from "@irtio/schema";
+import { SERVER_OWNER, cloneValue, defaultRecord, validateValue } from "@irtio/schema";
 var HOLD_ACTIONS = /* @__PURE__ */ new Set([
   "release",
   "nearest",
@@ -735,7 +735,7 @@ function nearestConnected(core, collection, id) {
   }
   return best;
 }
-function addPerPlayerRecords(core, clientId) {
+function addPerPlayerRecords(core, clientId, seeds) {
   for (const c of core.ext.collections) {
     if (c.kind !== "entity" || !c.perPlayer) continue;
     const coll = plainEntity(core.plain, c.name);
@@ -746,7 +746,23 @@ function addPerPlayerRecords(core, clientId) {
       continue;
     }
     try {
-      trackedEntity(core, c.name).add(clientId, defaultRecord(c), { owner: clientId });
+      const record = defaultRecord(c);
+      const seed = seeds?.get(c.name);
+      if (seed && c.persist) {
+        for (const field of c.persist) {
+          const value = seed[field];
+          if (value === void 0) continue;
+          const desc = c.fields[c.fieldIndex.get(field) ?? -1];
+          if (!desc) continue;
+          const err = validateValue(desc.type, value, `${c.name}.${field}`);
+          if (err) {
+            core.log("warn", `persisted ${c.name}.${field} for ${clientId} dropped: ${err}`);
+            continue;
+          }
+          record[field] = cloneValue(value);
+        }
+      }
+      trackedEntity(core, c.name).add(clientId, record, { owner: clientId });
     } catch (err) {
       core.log("error", `perPlayer add on ${c.name} failed for ${clientId}:`, err);
     }
@@ -942,7 +958,7 @@ function handleCall(core, clientId, payload) {
     return true;
   }
   for (const f of desc.params) {
-    const problem = validateValue(f.type, params[f.name], f.name);
+    const problem = validateValue2(f.type, params[f.name], f.name);
     if (problem) {
       traceEarly?.(errorText("E_RPC_BAD_PARAMS", problem));
       sendReply(core, clientId, call.reqId, null, errorText("E_RPC_BAD_PARAMS", problem));
@@ -1353,7 +1369,7 @@ function rejectAllHostCalls(core, reason) {
 // src/core/writes.ts
 import {
   SERVER_OWNER as SERVER_OWNER3,
-  cloneValue,
+  cloneValue as cloneValue2,
   decodeDelta,
   defaultValue,
   encodeDelta as encodeDelta2,
@@ -1407,7 +1423,7 @@ function applyMaskedPatch(fields, target, patch, mask) {
         continue;
       }
     }
-    target[f.name] = cloneValue(value);
+    target[f.name] = cloneValue2(value);
   }
 }
 function assignChanged(desc, target, key, prev, next) {
@@ -1532,17 +1548,17 @@ function applyOp(core, clientId, c, op) {
   const fields = fieldList(c);
   const growth = updateGrowth(c, leafPaths(fields, op.mask));
   if (growth > 0 && !admitGrowth(core, clientId, growth)) return;
-  const prev = cloneValue(current);
-  const next = cloneValue(current);
+  const prev = cloneValue2(current);
+  const next = cloneValue2(current);
   applyMaskedPatch(fields, next, op.patch, op.mask);
-  const requested = cloneValue(next);
+  const requested = cloneValue2(next);
   if (c.physics || c.serverFields) {
     const refused2 = [];
     for (const leaf of leafPaths(fields, op.mask)) {
       const field = leaf.names[0];
       const why = ownerMayNotWrite(c, field);
       if (why === void 0) continue;
-      next[field] = cloneValue(prev[field]);
+      next[field] = cloneValue2(prev[field]);
       refused2.push(why);
     }
     if (refused2.length > 0) {
@@ -1580,7 +1596,7 @@ function applyOp(core, clientId, c, op) {
       map = /* @__PURE__ */ new Map();
       entry.accepted.set(key, map);
     }
-    for (const leaf of written) map.set(leafKey(leaf), cloneValue(valueAt(result, leaf.names)));
+    for (const leaf of written) map.set(leafKey(leaf), cloneValue2(valueAt(result, leaf.names)));
   }
   const corrected = written.filter(
     (leaf) => !deepEqual(valueAt(result, leaf.names), valueAt(requested, leaf.names))
@@ -3652,7 +3668,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();
@@ -3772,7 +3790,7 @@ import {
   withBuiltins as withBuiltins2
 } from "@irtio/protocol";
 import {
-  cloneValue as cloneValue2,
+  cloneValue as cloneValue3,
   createDirtySet as createDirtySet3,
   createState,
   decodeSnapshot as decodeSnapshot3,
@@ -6139,7 +6157,7 @@ function ownJoinCapture(plain, name, added, clientId) {
   for (const id of added) {
     const owner = coll.ownerOf(id);
     if (name === PRESENCE_COLLECTION ? id !== clientId : owner !== clientId) continue;
-    (mine ??= /* @__PURE__ */ new Map()).set(id, { value: cloneValue2(coll.get(id)), owner });
+    (mine ??= /* @__PURE__ */ new Map()).set(id, { value: cloneValue3(coll.get(id)), owner });
   }
   return mine;
 }
@@ -6903,7 +6921,7 @@ var RoomCore = class _RoomCore {
     this.clients.set(clientId, entry);
     this.invalidateClients();
     reclaimHolds(this.internals, clientId, entry.playerId);
-    addPerPlayerRecords(this.internals, clientId);
+    addPerPlayerRecords(this.internals, clientId, options.persisted);
     const onJoin = this.definition.config.onJoin;
     if (onJoin) {
       const ctx = this.ctxFor(clientId, reconnecting);
@@ -6926,7 +6944,7 @@ var RoomCore = class _RoomCore {
         const captured = mine ?? /* @__PURE__ */ new Map();
         for (const id of cd.added) {
           if (!visible.has(id) || captured.has(id)) continue;
-          captured.set(id, { value: cloneValue2(coll.get(id)), owner: coll.ownerOf(id) });
+          captured.set(id, { value: cloneValue3(coll.get(id)), owner: coll.ownerOf(id) });
         }
         if (captured.size > 0) pending.set(name2, captured);
       } else if (mine) pending.set(name2, mine);
@@ -6967,6 +6985,30 @@ var RoomCore = class _RoomCore {
     this.invalidateClients();
     this.eventFlush();
   }
+  // ---- M8 proposal 13: identity-keyed player persistence ----
+  /**
+   * The current values of every `persist` field this client's `perPlayer` records hold, or
+   * `undefined` when the schema declares none and when the client has no records.
+   *
+   * Read by the relay host just before `leave`, which is the last moment the records exist: the
+   * declared leave rules remove a `perPlayer` record.
+   */
+  persistedFieldsOf(clientId) {
+    let out;
+    for (const c of this.ext.collections) {
+      if (c.kind !== "entity" || !c.perPlayer || !c.persist || c.persist.length === 0) continue;
+      const record = plainEntity(this.plain, c.name).get(clientId);
+      if (!record) continue;
+      const picked = {};
+      for (const field of c.persist) {
+        const value = record[field];
+        if (value !== void 0) picked[field] = cloneValue3(value);
+      }
+      if (Object.keys(picked).length > 0) (out ??= /* @__PURE__ */ new Map()).set(c.name, picked);
+    }
+    return out;
+  }
+  // ---- end M8 proposal 13 ----
   markDisconnected(clientId) {
     const entry = this.clients.get(clientId);
     if (!entry) {

package/dist/{contract-BoCNAPZT.d.ts → contract-CpBkqkn7.d.ts}

@@ -552,6 +552,12 @@ interface JoinOptions {
      * therefore the only thing `room.ban` can key a cooldown on honestly.
      */
     readonly subject?: string;
+    /**
+     * Seed values for this client's fresh `perPlayer` records, from the relay host's persistence
+     * blob: collection name → partial field values. Applied only where a new record is created; a
+     * reclaimed or reconnected record keeps what it has.
+     */
+    readonly persisted?: ReadonlyMap<string, Readonly<Record<string, unknown>>>;
 }
 interface JoinResult {
     readonly tick: number;
@@ -657,6 +663,13 @@ interface RoomCoreApi<S extends AnySchema = AnySchema> {
     leave(clientId: string, reason: LeaveReason): void;
     /** Grace window opened by the host: presence `connected = false`; frames are no longer sent. */
     markDisconnected(clientId: string): void;
+    /**
+     * M8 proposal 13: the current values of every `persist` field this client's `perPlayer` records
+     * hold, or `undefined` when the schema declares none and when the client has no records.
+     *
+     * Read by the relay host just before `leave`, to write the player's persistence blob.
+     */
+    persistedFieldsOf(clientId: string): ReadonlyMap<string, Record<string, unknown>> | undefined;
     /** One inbound protocol frame (`WRITE` | `CALL` | `REPLY` | `MSG`). Anything else → host.kick(E_BAD_FRAME). */
     receive(clientId: string, frame: Uint8Array): void;
     /** Full state + tick + rng for hibernation. Runs `onSleep`. Clears timers. */

package/dist/index.d.ts

@@ -1,5 +1,5 @@
-export { A as AdmissionError, D as DEFAULT_RECORDS_PER_COLLECTION, a as DEFAULT_TIMELINE_MAX_RECORDS, b as DEFAULT_TIMELINE_MAX_TICKS, E as EVENT_RING_SIZE, H as HOST_CALL_TIMEOUT_MS, c as HostCall, d as HostCallResult, J as JoinOptions, e as JoinResult, L as LogLevel, P as PHYSICS_STEP_EMA_ALPHA, R as RELAY_RECORDS_PER_COLLECTION, f as RELAY_STATE_BYTES, g as RELAY_WRITES_PER_SECOND, h as RELAY_WRITE_CAPS, i as RPC_TRACE_SIZE, j as RPC_TRACE_SUMMARY_MAX, k as RoomCoreApi, l as RoomCoreOptions, m as RoomEvent, n as RoomEventKind, o as RoomFullError, p as RoomHost, q as RoomInspection, r as RoomStats, s as RpcOutcome, t as RpcTraceDump, u as RpcTraceEntry, v as RpcTraceRing, S as StampLag, T as TimelineDump, w as TimelineFrame, x as TimelineRecorder, y as TimelineRecorderOptions, W as WriteCaps, z as inspectState, B as summarizeRpcResult } from './contract-BoCNAPZT.js';
-export { C as CRASH_AFTER_THROWS, M as MAX_CATCHUP, a as MatterBodyRecord, b as MatterSection, c as Mulberry32, P as PhysicsEngineTag, d as PhysicsSection, R as RoomCore, e as decodeMatterBodies, f as decodeMatterSectionEnvelope, g as decodePhysicsSection, h as decodeRapier2dSectionEnvelope, i as encodeMatterBodies, j as encodeMatterSectionEnvelope, k as encodePhysicsSection, l as encodeRapier2dSectionEnvelope, m as initMatter, n as initPhysics, o as initRapier2d, p as loadedMatter, q as loadedPhysics, r as loadedRapier2d, s as physicsSectionEngine, t as resetMatterForTests, u as resetPhysicsForTests, v as resetRapier2dForTests } from './room-CGbiPxi3.js';
+export { A as AdmissionError, D as DEFAULT_RECORDS_PER_COLLECTION, a as DEFAULT_TIMELINE_MAX_RECORDS, b as DEFAULT_TIMELINE_MAX_TICKS, E as EVENT_RING_SIZE, H as HOST_CALL_TIMEOUT_MS, c as HostCall, d as HostCallResult, J as JoinOptions, e as JoinResult, L as LogLevel, P as PHYSICS_STEP_EMA_ALPHA, R as RELAY_RECORDS_PER_COLLECTION, f as RELAY_STATE_BYTES, g as RELAY_WRITES_PER_SECOND, h as RELAY_WRITE_CAPS, i as RPC_TRACE_SIZE, j as RPC_TRACE_SUMMARY_MAX, k as RoomCoreApi, l as RoomCoreOptions, m as RoomEvent, n as RoomEventKind, o as RoomFullError, p as RoomHost, q as RoomInspection, r as RoomStats, s as RpcOutcome, t as RpcTraceDump, u as RpcTraceEntry, v as RpcTraceRing, S as StampLag, T as TimelineDump, w as TimelineFrame, x as TimelineRecorder, y as TimelineRecorderOptions, W as WriteCaps, z as inspectState, B as summarizeRpcResult } from './contract-CpBkqkn7.js';
+export { C as CRASH_AFTER_THROWS, M as MAX_CATCHUP, a as MatterBodyRecord, b as MatterSection, c as Mulberry32, P as PhysicsEngineTag, d as PhysicsSection, R as RoomCore, e as decodeMatterBodies, f as decodeMatterSectionEnvelope, g as decodePhysicsSection, h as decodeRapier2dSectionEnvelope, i as encodeMatterBodies, j as encodeMatterSectionEnvelope, k as encodePhysicsSection, l as encodeRapier2dSectionEnvelope, m as initMatter, n as initPhysics, o as initRapier2d, p as loadedMatter, q as loadedPhysics, r as loadedRapier2d, s as physicsSectionEngine, t as resetMatterForTests, u as resetPhysicsForTests, v as resetRapier2dForTests } from './room-B9h9dc4e.js';
 import { CollectionDesc, AnySchema, PlainState, DirtySet } from '@irtio/schema';
 import '@irtio/protocol';
 import '@irtio/server';

package/dist/index.js

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

package/dist/{room-CGbiPxi3.d.ts → room-B9h9dc4e.d.ts}

@@ -1,7 +1,7 @@
 import { PlatformNotice, AttributeOptions, ProfileSnapshot } from '@irtio/protocol';
 import { DirtySet, AnySchema, PlainState, Tracked, State } from '@irtio/schema';
 import { RoomDefinition, RoomMode, Room, RewindView, Ctx, MatterModule, MatterEngine, MatterBody, RapierModule, RapierWorld, RapierRigidBody, Rapier2dModule, Rapier2dWorld, Rapier2dRigidBody, ResolvedRoomConfig, LeaveReason } from '@irtio/server';
-import { p as RoomHost, r as RoomStats, u as RpcTraceEntry, L as LogLevel, k as RoomCoreApi, l as RoomCoreOptions, n as RoomEventKind, y as TimelineRecorderOptions, T as TimelineDump, t as RpcTraceDump, q as RoomInspection, J as JoinOptions, e as JoinResult, d as HostCallResult } from './contract-BoCNAPZT.js';
+import { p as RoomHost, r as RoomStats, u as RpcTraceEntry, L as LogLevel, k as RoomCoreApi, l as RoomCoreOptions, n as RoomEventKind, y as TimelineRecorderOptions, T as TimelineDump, t as RpcTraceDump, q as RoomInspection, J as JoinOptions, e as JoinResult, d as HostCallResult } from './contract-CpBkqkn7.js';
 
 declare class Mulberry32 {
     /** Current internal state (u32). Survives hibernation. */
@@ -1152,6 +1152,14 @@ declare class RoomCore<S extends AnySchema = AnySchema> implements RoomCoreApi<S
     /** Event mode only: presence/lifecycle changes are their own event. No-op in tick mode. */
     private eventFlush;
     leave(clientId: string, reason: LeaveReason): void;
+    /**
+     * The current values of every `persist` field this client's `perPlayer` records hold, or
+     * `undefined` when the schema declares none and when the client has no records.
+     *
+     * Read by the relay host just before `leave`, which is the last moment the records exist: the
+     * declared leave rules remove a `perPlayer` record.
+     */
+    persistedFieldsOf(clientId: string): ReadonlyMap<string, Record<string, unknown>> | undefined;
     markDisconnected(clientId: string): void;
     ctxFor(clientId: string, reconnecting?: boolean): Ctx;
     /**

package/dist/test/index.d.ts

@@ -1,8 +1,8 @@
-import { R as RoomCore } from '../room-CGbiPxi3.js';
-export { m as initMatter, n as initPhysics, o as initRapier2d } from '../room-CGbiPxi3.js';
+import { R as RoomCore } from '../room-B9h9dc4e.js';
+export { m as initMatter, n as initPhysics, o as initRapier2d } from '../room-B9h9dc4e.js';
 import { ErrorCodeName, FrameType } from '@irtio/protocol';
 import { NpcConfig, LeaveReason, Room, RoomDefinition } from '@irtio/server';
-import { p as RoomHost, L as LogLevel, k as RoomCoreApi, c as HostCall, d as HostCallResult, W as WriteCaps, r as RoomStats } from '../contract-BoCNAPZT.js';
+import { p as RoomHost, L as LogLevel, k as RoomCoreApi, c as HostCall, d as HostCallResult, W as WriteCaps, r as RoomStats } from '../contract-CpBkqkn7.js';
 import { AnySchema, PlainState, EntityCollection, State } from '@irtio/schema';
 
 /**
@@ -20,6 +20,14 @@ declare class FakeClock {
     clearTimeout(handle: unknown): void;
     /** Number of timers still armed (a room that is ticking always has at least one). */
     get pending(): number;
+    /**
+     * The `at` of the earliest armed timer, or `undefined` when nothing is armed. Read-only: it
+     * changes nothing. It exists for callers that need to advance to the next timer rather than
+     * over it — `testRoom`'s `t.run(ms)` uses it to hop timer by timer, so a script parked on an
+     * `await` (whose continuation only runs once `advance` has returned and microtasks drain) can
+     * arm its next timer and keep going inside a single long run.
+     */
+    nextDueAt(): number | undefined;
     /**
      * Advances to `time + ms`, firing every timer that comes due in order (earliest `at` first,
      * ties broken by creation order). A timer that arms another timer inside the window fires too.
@@ -361,6 +369,11 @@ interface JoinSpec {
      * `onAdmit` that requires identity needs to be tested against.
      */
     readonly subject?: string;
+    /**
+     * The persistence blob this join arrives with: collection name → persisted field values. What
+     * the relay host reads from the store for an identified player, without a store or a socket.
+     */
+    readonly persisted?: ReadonlyMap<string, Readonly<Record<string, unknown>>>;
 }
 interface UntilOptions {
     /** Default 1000. */

package/dist/test/index.js

@@ -5,7 +5,7 @@ import {
   initPhysics,
   initRapier2d,
   visibleNames
-} from "../chunk-NPRIYYNM.js";
+} from "../chunk-S4D472RL.js";
 
 // src/test/clock.ts
 var FakeClock = class {
@@ -28,6 +28,22 @@ var FakeClock = class {
   get pending() {
     return this.timers.size;
   }
+  /**
+   * The `at` of the earliest armed timer, or `undefined` when nothing is armed. Read-only: it
+   * changes nothing. It exists for callers that need to advance to the next timer rather than
+   * over it — `testRoom`'s `t.run(ms)` uses it to hop timer by timer, so a script parked on an
+   * `await` (whose continuation only runs once `advance` has returned and microtasks drain) can
+   * arm its next timer and keep going inside a single long run.
+   */
+  nextDueAt() {
+    let earliest;
+    for (const t of this.timers.values()) {
+      if (!earliest || t.at < earliest.at || t.at === earliest.at && t.id < earliest.id) {
+        earliest = t;
+      }
+    }
+    return earliest?.at;
+  }
   /**
    * Advances to `time + ms`, firing every timer that comes due in order (earliest `at` first,
    * ties broken by creation order). A timer that arms another timer inside the window fires too.
@@ -966,8 +982,11 @@ var Harness = class {
       ...spec.playerId !== void 0 ? { playerId: spec.playerId } : {},
       // ---- end M6 lane K ----
       // ---- M8 lane 5: moderation ----
-      ...spec.subject !== void 0 ? { subject: spec.subject } : {}
+      ...spec.subject !== void 0 ? { subject: spec.subject } : {},
       // ---- end M8 lane 5 ----
+      // ---- M8 proposal 13 ----
+      ...spec.persisted !== void 0 ? { persisted: spec.persisted } : {}
+      // ---- end M8 proposal 13 ----
     };
     const client = new FakeClientImpl(this.bridge, id, options);
     this.byId.set(id, client);

package/dist/worker/index.d.ts

@@ -1,4 +1,4 @@
-import { L as LogLevel, t as RpcTraceDump, T as TimelineDump, r as RoomStats, c as HostCall, d as HostCallResult, k as RoomCoreApi, p as RoomHost } from '../contract-BoCNAPZT.js';
+import { L as LogLevel, t as RpcTraceDump, T as TimelineDump, r as RoomStats, c as HostCall, d as HostCallResult, k as RoomCoreApi, p as RoomHost } from '../contract-CpBkqkn7.js';
 import { ErrorCodeName, ProfileSnapshot, PlatformNotice } from '@irtio/protocol';
 import { NpcConfig, LeaveReason } from '@irtio/server';
 import '@irtio/schema';

package/dist/worker/index.js

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@irtio/runtime",
-  "version": "3.1.0",
+  "version": "4.0.0",
   "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.1.0",
-    "@irtio/schema": "3.1.0",
-    "@irtio/server": "3.1.0"
+    "@irtio/protocol": "^4.0.0",
+    "@irtio/schema": "^4.0.0",
+    "@irtio/server": "^4.0.0"
   },
   "devDependencies": {
     "@types/matter-js": "0.20.2"