@genex-ai/multiplayer 0.8.3 → 0.8.5

package/README.md

@@ -111,7 +111,7 @@ room.on('join',   (id, state) => {});  // a player appeared (also fires for YOU
 room.on('change', (id, state) => {});  // a player updated their me-state
 room.on('leave',  (id)        => {});  // a player left
 room.on('shared', (key, value) => {}); // a shared key changed
-room.on('object', (id)        => {});  // an object's owner changed (handoff)
+room.on('object', (id)        => {});  // an object's owner changed — the render glides across it (soft handoff)
 room.on('host',   (id)        => {});  // the room host changed
 room.on('hit',    (payload)   => {});  // a custom event someone sent (see `send`)
 
@@ -141,9 +141,12 @@ drops keep the full reconnection grace.
 
 ## `inputs` + `onHostTick` — host-authoritative physics (contested objects)
 
-Claim-on-touch is right for one-touch objects (kick a ball). For **sustained contact**
-(two players pushing one crate) let ONE simulation own the contest: everyone sends inputs —
-the relay routes them to the **current host only** — and the host applies them on a fixed
+Claim-on-touch fits any **ownable** body (a ball, a box, a prop) — even when players take turns
+bumping it, because the ownership **handoff glides** (a soft handoff, since 0.8.4) instead of
+teleporting; give the object a Rapier proxy that's `dynamic` while you own it and a `kinematicPosition`
+follower of `state` when you don't. Reserve host-authoritative for a genuine **simultaneous** contest
+(two players pushing one crate *against each other*, sumo): let ONE neutral simulation own it — everyone
+sends inputs, the relay routes them to the **current host only**, and the host applies them on a fixed
 tick and publishes results via `objects` (auto-smoothed for everyone):
 
 ```ts

package/dist/index.js

@@ -233,7 +233,7 @@ function attachSession(client, initialRoom) {
     const autoDelay = autoDelayById.get(streamKey) ?? 100;
     const renderTime = localNow - (clockOffsets.get(streamKey) ?? 0) - autoDelay;
     const sampled = buf && sampleBuffer(buf, renderTime);
-    if (!sampled) return void 0;
+    if (!sampled) return smoothed.get(streamKey);
     const prev = smoothed.get(streamKey);
     let out;
     if (prev) {
@@ -256,6 +256,14 @@ function attachSession(client, initialRoom) {
     intervalsById.delete(streamKey);
     autoDelayById.delete(streamKey);
   };
+  const clearStreamClock = (streamKey) => {
+    buffers.delete(streamKey);
+    lastStamp.delete(streamKey);
+    clockOffsets.delete(streamKey);
+    offsetWin.delete(streamKey);
+    intervalsById.delete(streamKey);
+    autoDelayById.delete(streamKey);
+  };
   const emitters = /* @__PURE__ */ new Map();
   const bridged = /* @__PURE__ */ new Set();
   const reserved = /* @__PURE__ */ new Set([
@@ -298,7 +306,7 @@ function attachSession(client, initialRoom) {
         else objOwners.delete(id);
         if (owner !== room.sessionId) {
           localObjState.delete(id);
-          clearStream(key);
+          clearStreamClock(key);
         }
       }
       if (blob.d && typeof blob.d === "object" && Object.keys(blob.d).length > 0) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@genex-ai/multiplayer",
-  "version": "0.8.3",
+  "version": "0.8.5",
   "description": "The multiplayer client wrapper + shared room schema for genex.",
   "type": "module",
   "main": "./dist/index.js",