@genex-ai/multiplayer 0.8.6 → 0.8.8

package/README.md

@@ -250,7 +250,8 @@ else renderSearchingHud(mm.matchmaking);
 mm.on("matched", () => {/* session is live */});
 mm.on("matchStart", ({ roundId }) => {/* round began */});
 mm.on("matchEnded", ({ winnerId, scores, draw }) => {/* result screen */});
-mm.on("spectate", () => {/* seated as a spectator (overflow) — read-only */});
+mm.on("spectate", () => {/* DEPRECATED — never fires: there are no server-side spectators anymore.
+                            An overflow searcher now waits in the queue instead of watching. */});
 mm.on("error", (e) => {/* queue join failed even after the SDK's automatic retries — persistent
                           (broken auth / server unreachable); fix the cause, then mm.retry() */});
 
@@ -267,7 +268,7 @@ A failed queue join is **retried automatically** with backoff (~10s total), so t
 (a token mid-rotation, identity still settling on page load) never surface. Only a persistent
 failure emits `error`; the handle then idles until you call `mm.retry()`.
 
-**`mm.matchmaking`** (read every frame for your HUD): `status` (`searching` | `waiting` | `countdown` | `playing` | `ended` | `spectating`), `queue` (`{ position, size }`), `players`, `opponents`, `teams`, `myTeam`, `scores`, `winCondition`, `config` (numeric knobs), `roundId`, `winnerId`, `message`. `championId`/`challengerId` are 1v1 aliases.
+**`mm.matchmaking`** (read every frame for your HUD): `status` (`searching` | `waiting` | `countdown` | `playing` | `ended`; the legacy `spectating` is never emitted — server-side spectators were removed), `queue` (`{ position, size }`), `players`, `opponents`, `teams`, `myTeam`, `scores`, `winCondition`, `config` (numeric knobs), `roundId`, `winnerId`, `message`. `championId`/`challengerId` are 1v1 aliases.
 
 Configure once in the game's `package.json` (reported at `genex preview` AND `genex publish`;
 removing it clears the stored config on the next preview/publish — never sent from the client):
@@ -275,14 +276,16 @@ removing it clears the stored config on the next preview/publish — never sent
 ```jsonc
 "genex": {
   "matchmaking": {
-    "preset": "arena",                 // duel | arena | teams | private
+    "preset": "arena",                 // open | duel | arena | teams | private
     "winCondition": "firstToScore",    // lastStanding | firstToScore | highScoreInTime | firstToFinish
     "config": { "scoreTarget": 20, "maxPlayers": 8 }   // numeric knobs, optional
   }
 }
 ```
 
-Presets: **duel** (1v1 winner-stays), **arena** (N-player FFA, join-anytime), **teams** (balanced N-v-N), **private** (invite-code lobby). Win conditions: **lastStanding**, **firstToScore**, **highScoreInTime**, **firstToFinish**; a round that hits the time cap undecided is a draw.
+Presets: **open** (a room of N players, your rules — see below), **duel** (1v1 winner-stays), **arena** (N-player FFA, join-anytime), **teams** (balanced N-v-N), **private** (invite-code lobby). Win conditions (for the batteries-included presets): **lastStanding**, **firstToScore**, **highScoreInTime**, **firstToFinish**; a round that hits the time cap undecided is a draw.
+
+**`open` — bring your own rules.** The minimal preset: the server owns only seating, capacity, and refill; you build teams, rounds, scoring, and win logic yourself on `session.shared` + host election. It runs no match loop, so `status` only goes `waiting`→`playing` (never `ended`), `scores`/`winnerId` stay empty, and **nobody is ever evicted** (no `matchEnded`, no requeue). Config knobs: `minPlayers` (quorum to flip to `playing`; default 1), `maxPlayers` (seat cap, clamped 2–64), `fill` (`1` = keep the room full — grow to max and refill a seat a leaver frees, the default; `0` = lock the room for good once it is simultaneously full (max players at once) — a match with no substitutes; a freed seat stays closed). Pick `open` when you want your own rules; pick duel/arena/teams for a ready-made match loop.
 
 ### Private lobbies — `createPrivate` / `joinPrivate`
 

package/dist/index.js

@@ -189,6 +189,7 @@ function attachSession(client, initialRoom) {
   const objOwners = /* @__PURE__ */ new Map();
   const objRaw = /* @__PURE__ */ new Map();
   const localObjState = /* @__PURE__ */ new Map();
+  const pendingBridge = /* @__PURE__ */ new Map();
   let hostId;
   const testSkew = typeof globalThis !== "undefined" && globalThis.__GENEX_MP_TEST_SKEW__ || 0;
   const now = testSkew ? () => nowMs() + testSkew : nowMs;
@@ -223,6 +224,12 @@ function attachSession(client, initialRoom) {
     }
     let buf = buffers.get(id);
     if (!buf) buffers.set(id, buf = []);
+    const bridge = pendingBridge.get(id);
+    if (bridge && buf.length === 0 && sendTime != null) {
+      const delay = autoDelayById.get(id) ?? INTERP_MIN_MS;
+      buf.push({ t: t - Math.max(1, delay), state: bridge });
+    }
+    pendingBridge.delete(id);
     buf.push({ t, state });
     const cutoff = t - 1500;
     while (buf.length > 2 && buf[0].t < cutoff) buf.shift();
@@ -255,6 +262,7 @@ function attachSession(client, initialRoom) {
     smoothedAt.delete(streamKey);
     intervalsById.delete(streamKey);
     autoDelayById.delete(streamKey);
+    pendingBridge.delete(streamKey);
   };
   const clearStreamClock = (streamKey) => {
     buffers.delete(streamKey);
@@ -311,7 +319,13 @@ function attachSession(client, initialRoom) {
       }
       if (blob.d && typeof blob.d === "object" && Object.keys(blob.d).length > 0) {
         objRaw.set(id, blob.d);
-        if (owner !== room.sessionId) pushSnap(key, blob.d, blob.t);
+        if (owner !== room.sessionId) {
+          if (ownerChanged) {
+            pendingBridge.set(key, smoothed.get(key) ?? blob.d);
+          } else {
+            pushSnap(key, blob.d, blob.t);
+          }
+        }
       }
       if (ownerChanged) emit("object", id);
       return;

package/package.json

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