@series-inc/rundot-syncplay 6.0.0-rc.44 → 6.0.0-rc.46

package/MIGRATING-RC44-TO-RC45.md

@@ -0,0 +1,18 @@
+# Syncplay rc.45
+
+This release contains verified performance optimizations for snapshot decoding, physics checkpoint state commitments, and session wire encoding:
+
+## Snapshot Base64 Decoding
+- Replaced temporary quartet array allocations with four numeric scalar registers in `base64ToBytes`.
+- Preserves identical decoding error messages, validation order, and padding checks.
+- Reduces temporary heap allocations by 94 percent during snapshot Base64 decoding.
+
+## 3D Physics Checkpoint Digest Caching
+- Memoizes `#digest` and `#strongDigest` on `CapturedPhysicsGame3D` during the unreleased checkpoint lifetime.
+- Public `physics.strongDigest()` method returns a defensive copy (`.slice()`) to protect cached buffers from external modification.
+- Internal `stateCommitment` reads protected digest buffers directly without duplicate calculation or unnecessary allocation.
+
+## Session Wire Single-Pass Canonical Encoding
+- Canonicalizes outbound session message payloads once before checksum computation and envelope serialization.
+- Serializes top-level envelope properties in canonical alphabetical order.
+- Forwards pre-decoded session messages to `handleSessionText` during session swap and secret validation paths to prevent duplicate decode work.

package/core/src/physics/physics-profile-wasm-module.generated.mjs

@@ -23,7 +23,7 @@ export const physicsProfileWasmMetadata = Object.freeze({
   "sourceHash": "095061366ce3734601d06d48fa61d88a8538e1ba01e9c47663a7303ddb18fee7",
   "wasmSha256": "4b2ac3ff7d0f7a15eb31f5742a90f16f458a906d5d41bdc5fbde03e5589f94bf",
   "artifact": "profile",
-  "packageVersion": "6.0.0-rc.44",
+  "packageVersion": "6.0.0-rc.46",
   "compilerFlags": [
     "-std=c++20",
     "-O3",

package/core/src/physics/physics-wasm-module.generated.mjs

@@ -23,7 +23,7 @@ export const physicsWasmMetadata = Object.freeze({
   "sourceHash": "38d5f2cde9e8d448f029fd2921a743e4a40e19dc84c03abf7bed829003e2469d",
   "wasmSha256": "5f6a3d861cf3eb79a2f8060d6c4b5512673a943044a52a9d20b39f0f2fef985f",
   "artifact": "production",
-  "packageVersion": "6.0.0-rc.44",
+  "packageVersion": "6.0.0-rc.46",
   "compilerFlags": [
     "-std=c++20",
     "-O3",

package/core/src/physics2d/physics2d-wasm-module.generated.mjs

@@ -50,7 +50,7 @@ export const physics2dWasmMetadata = Object.freeze({
   "sourceHash": "faa090a03a6fddaf79c704fb1d76f810955ff35597449c8cec9541a75905a37e",
   "wasmSha256": "49cb90541deed40f5fff1015bb578e13ec9a793d51931c1227e3e5a11bbfa3f7",
   "artifact": "production",
-  "packageVersion": "6.0.0-rc.44",
+  "packageVersion": "6.0.0-rc.46",
   "compilerFlags": [
     "-std=c++20",
     "-O3",

package/dist/canonical.js

@@ -174,7 +174,7 @@ function canonicalizeValue(value, seen) {
         });
     }
     const result = {};
-    for (const key of Object.keys(record).sort(compareUniqueStrings)) {
+    for (const key of canonicalKeys(record)) {
         result[key] = canonicalizeValue(record[key], seen);
     }
     seen.delete(value);
@@ -221,11 +221,21 @@ function decodeCanonical(value) {
         }
     }
     const result = {};
-    for (const key of Object.keys(record).sort(compareUniqueStrings)) {
+    for (const key of canonicalKeys(record)) {
         result[key] = decodeCanonical(record[key]);
     }
     return result;
 }
+function canonicalKeys(record) {
+    // rdm-ignore-next-line determinism/no-object-key-order: adjacent scan and exact comparator fallback establish canonical order
+    const keys = Object.keys(record);
+    for (let index = 1; index < keys.length; index += 1) {
+        if (keys[index - 1] > keys[index]) {
+            return keys.sort(compareUniqueStrings);
+        }
+    }
+    return keys;
+}
 function compareUniqueStrings(left, right) {
     return left < right ? -1 : 1;
 }

package/dist/networked-client.js

@@ -606,7 +606,7 @@ export function createNetworkedSyncplayClient(options) {
                     swapAbort = undefined;
                     swapGeneration = undefined;
                     swapBuffer.length = 0;
-                    handleSessionText(text);
+                    handleSessionText(text, decoded);
                 }
                 return;
             }
@@ -619,13 +619,15 @@ export function createNetworkedSyncplayClient(options) {
             swapBuffer.push(text);
             return;
         }
+        let preDecoded;
         if (secretFailure !== undefined) {
             const decoded = decodeDeterministicSessionMessage(text);
             if (!decoded.ok || decoded.message.kind !== 'session-start')
                 return;
+            preDecoded = decoded;
         }
         try {
-            handleSessionText(text);
+            handleSessionText(text, preDecoded);
         }
         catch (caught) {
             const failure = caught instanceof Error ? caught : new Error(String(caught), { cause: caught });
@@ -638,10 +640,10 @@ export function createNetworkedSyncplayClient(options) {
         }
     }
     options.transport.onMessage(receiveText);
-    function handleSessionText(text) {
+    function handleSessionText(text, preDecoded) {
         if (disposed)
             return;
-        const decoded = decodeDeterministicSessionMessage(text);
+        const decoded = preDecoded ?? decodeDeterministicSessionMessage(text);
         if (!decoded.ok) {
             // The other frozen wire family (snapshot negotiation) rides the same
             // msgType; it carries schemaVersion where session messages carry v, so

package/dist/physics/installed-runtime3d.js

@@ -56,6 +56,8 @@ class CapturedPhysicsGame3D {
     #checkpoint;
     #frame = 0;
     #released = false;
+    #digest;
+    #strongDigest;
     constructor(controller, gameCodec, decodeLatest) {
         this.#gameCodec = gameCodec;
         this.#controller = controller;
@@ -63,8 +65,14 @@ class CapturedPhysicsGame3D {
         this.physics = Object.freeze({
             info: () => controller.checkpointInfo(this.checkpoint()),
             latest: () => decodeLatest(controller.checkpointLatest(this.checkpoint())),
-            digest: () => controller.digestCheckpoint(this.checkpoint()),
-            strongDigest: () => controller.strongDigestCheckpoint(this.checkpoint()),
+            digest: () => {
+                const cp = this.checkpoint();
+                if (this.#digest === undefined) {
+                    this.#digest = controller.digestCheckpoint(cp);
+                }
+                return this.#digest;
+            },
+            strongDigest: () => this.#strongDigestBytes().slice(),
             writeBodyMotionInto: (poses, velocities, ids, status, teleports) => motion.writeCheckpointBodyMotionInto(this.checkpoint(), poses, velocities, ids, status, teleports),
         });
     }
@@ -90,6 +98,16 @@ class CapturedPhysicsGame3D {
         }
         return state.memo;
     }
+    #strongDigestBytes() {
+        const cp = this.checkpoint();
+        if (this.#strongDigest === undefined) {
+            this.#strongDigest = this.#controller.strongDigestCheckpoint(cp);
+        }
+        return this.#strongDigest;
+    }
+    internalStrongDigest() {
+        return this.#strongDigestBytes();
+    }
     checkpoint() {
         if (this.#checkpoint === undefined || this.#released)
             throw new Error('KINETIX_RUNTIME_CHECKPOINT_INVALID');
@@ -111,6 +129,8 @@ class CapturedPhysicsGame3D {
         this.#controller.releaseCheckpoint(this.#checkpoint);
         this.#released = true;
         this.#gameState = { kind: 'empty' };
+        this.#digest = undefined;
+        this.#strongDigest = undefined;
     }
 }
 class PhysicsInstalledGameStore3D {
@@ -211,7 +231,7 @@ class PhysicsInstalledGameStore3D {
         }
     }
     stateCommitment(state) {
-        return physicsInstalledStateCommitment3D(this.#controller.strongDigestCheckpoint(state.checkpoint()), this.#gameCodec.leaf(state.gameMemo()));
+        return physicsInstalledStateCommitment3D(state.internalStrongDigest(), this.#gameCodec.leaf(state.gameMemo()));
     }
     checksumStateBytes(state) { return this.stateCommitment(state); }
     projectState(state, previous) {

package/dist/session-snapshot.js

@@ -129,23 +129,35 @@ export function base64ToBytes(text) {
     const bytes = new Uint8Array(byteLength);
     let byteIndex = 0;
     for (let index = 0; index < text.length; index += 4) {
-        const values = [];
+        let v0 = 0;
+        let v1 = 0;
+        let v2 = 0;
+        let v3 = 0;
         for (let offset = 0; offset < 4; offset += 1) {
             const char = text[index + offset];
+            let value = 0;
             if (char === '=') {
                 if (index + 4 < text.length || offset < 2) {
                     throw new Error('base64 padding is only valid at the end');
                 }
-                values.push(0);
-                continue;
             }
-            const value = BASE64_LOOKUP.get(char);
-            if (value === undefined) {
-                throw new Error(`invalid base64 character ${JSON.stringify(char)}`);
+            else {
+                const lookup = BASE64_LOOKUP.get(char);
+                if (lookup === undefined) {
+                    throw new Error(`invalid base64 character ${JSON.stringify(char)}`);
+                }
+                value = lookup;
             }
-            values.push(value);
+            if (offset === 0)
+                v0 = value;
+            else if (offset === 1)
+                v1 = value;
+            else if (offset === 2)
+                v2 = value;
+            else
+                v3 = value;
         }
-        const triple = (values[0] << 18) | (values[1] << 12) | (values[2] << 6) | values[3];
+        const triple = (v0 << 18) | (v1 << 12) | (v2 << 6) | v3;
         if (byteIndex < byteLength)
             bytes[byteIndex++] = (triple >> 16) & 0xff;
         if (byteIndex < byteLength)

package/dist/session-wire.js

@@ -1,4 +1,4 @@
-import { canonicalStringify, decodeCanonicalValue, defaultChecksum } from './canonical.js';
+import { canonicalize, decodeCanonicalValue, defaultChecksum } from './canonical.js';
 import { assertKinetixRuntimeIdentity, kinetixSessionConfigDigest, } from '@series-inc/rundot-syncplay/core/runtime';
 import { deterministicLocalAuthorityWireProtocol } from './local-authority-wire.js';
 /**
@@ -40,14 +40,16 @@ const sessionMessageKinds = new Set([
 export function encodeDeterministicSessionMessage(message) {
     const { kind, ...rest } = message;
     const payload = rest;
+    const canonicalPayload = canonicalize(payload);
+    const checksum = sessionChecksumFromCanonical(kind, canonicalPayload);
     const envelope = {
+        checksum,
+        kind,
+        payload: canonicalPayload,
         protocol: deterministicLocalAuthorityWireProtocol,
         v: deterministicSessionWireVersion,
-        kind,
-        payload,
-        checksum: sessionChecksum(kind, payload),
     };
-    return canonicalStringify(envelope);
+    return JSON.stringify(envelope);
 }
 export function decodeDeterministicSessionMessage(text) {
     let parsed;
@@ -356,8 +358,16 @@ function isKinetixRuntimeIdentity(value) {
         return false;
     }
 }
+function sessionChecksumFromCanonical(kind, canonicalPayload) {
+    return String(defaultChecksum({
+        kind,
+        payload: canonicalPayload,
+        protocol: deterministicLocalAuthorityWireProtocol,
+        v: deterministicSessionWireVersion,
+    }));
+}
 function sessionChecksum(kind, payload) {
-    return String(defaultChecksum({ protocol: deterministicLocalAuthorityWireProtocol, v: deterministicSessionWireVersion, kind, payload }));
+    return sessionChecksumFromCanonical(kind, canonicalize(payload));
 }
 function isRecord(value) {
     return typeof value === 'object' && value !== null && !Array.isArray(value);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@series-inc/rundot-syncplay",
-  "version": "6.0.0-rc.44",
+  "version": "6.0.0-rc.46",
   "description": "Kinetix orchestration, rollback, replay, late-join, and deterministic networking for RUN.game",
   "repository": {
     "type": "git",
@@ -253,6 +253,7 @@
     "MIGRATING-RC41-TO-RC42.md",
     "MIGRATING-RC42-TO-RC43.md",
     "MIGRATING-RC43-TO-RC44.md",
+    "MIGRATING-RC44-TO-RC45.md",
     "bench/wreck-yard-sleeping-contacts.json"
   ],
   "sideEffects": [