@genex-ai/multiplayer 0.17.8 → 0.17.9

package/dist/bridge-authority.js

@@ -9,10 +9,10 @@ import {
 } from "./chunk-4R7C2TLH.js";
 import {
   connectAuthority
-} from "./chunk-QZOCUQJT.js";
-import "./chunk-FPWP22Y7.js";
+} from "./chunk-MQYARUGU.js";
+import "./chunk-TEHGMFAG.js";
 import "./chunk-YWQ3ALYY.js";
-import "./chunk-NFMGIKFZ.js";
+import "./chunk-ZDGSUR6E.js";
 import "./chunk-OD6NRSX2.js";
 import {
   firstpersonWorld
@@ -22,7 +22,7 @@ import {
   CloseCode,
   ServerMessage,
   isReservedEventType
-} from "./chunk-CSQEEANB.js";
+} from "./chunk-WEMRRIHH.js";
 
 // src/bridge-authority.ts
 import { getAuthorityRegions, getAuthorityUrls, getColyseusAuth } from "@genex-ai/embed-sdk";

package/dist/bridge.js

@@ -15,14 +15,14 @@ import {
   joinPrivate,
   matchmake,
   roomOf
-} from "./chunk-QY3QQNDJ.js";
-import "./chunk-FPWP22Y7.js";
+} from "./chunk-DJ2XYETS.js";
+import "./chunk-TEHGMFAG.js";
 import {
   Limits,
   RESERVED_SHARED_PREFIX,
   ServerMessage,
   isReservedEventType
-} from "./chunk-CSQEEANB.js";
+} from "./chunk-WEMRRIHH.js";
 
 // src/bridge.ts
 var version = 2;

package/dist/{chunk-QY3QQNDJ.js → chunk-DJ2XYETS.js}

@@ -8,7 +8,7 @@ import {
   waitForFirstState,
   warnProtocolRefusal,
   withoutReconnection
-} from "./chunk-FPWP22Y7.js";
+} from "./chunk-TEHGMFAG.js";
 import {
   ClientMessage,
   ClientReconnection,
@@ -23,7 +23,7 @@ import {
   SEND_TIME_KEY,
   ServerMessage,
   isReservedEventType
-} from "./chunk-CSQEEANB.js";
+} from "./chunk-WEMRRIHH.js";
 
 // src/index.ts
 import { getStateCallbacks } from "@colyseus/sdk";

package/dist/{chunk-QZOCUQJT.js → chunk-MQYARUGU.js}

@@ -5,7 +5,7 @@ import {
   joinOptions,
   useSdkReconnection,
   waitForFirstState
-} from "./chunk-FPWP22Y7.js";
+} from "./chunk-TEHGMFAG.js";
 import {
   udpFastOpener
 } from "./chunk-YWQ3ALYY.js";
@@ -60,7 +60,7 @@ import {
   serverTick,
   tickInstant,
   validRoomCode
-} from "./chunk-NFMGIKFZ.js";
+} from "./chunk-ZDGSUR6E.js";
 import {
   RemotePredict
 } from "./chunk-OD6NRSX2.js";
@@ -83,11 +83,12 @@ import {
   AuthorityTiming,
   ClientReconnection,
   CloseCode,
+  FREE_QUOTA_REFUSAL,
   JoinError,
   RoomType,
   ServerMessage,
   authorityCloseCodeOf
-} from "./chunk-CSQEEANB.js";
+} from "./chunk-WEMRRIHH.js";
 
 // src/authority/regions.ts
 var AUTHORITY_REFUSALS_PER_REGION = 2;
@@ -4654,6 +4655,32 @@ var ENTITY_MOTION_FIELDS = Object.keys(blankEntityMotion());
 var SEAT_MOTION_FIELDS = Object.keys(blankSeatEcho()).filter((f) => f !== "inAck");
 var motionFieldsOf = (kind) => kind === MotionRecordKind.Entity ? ENTITY_MOTION_FIELDS : SEAT_MOTION_FIELDS;
 var ROOT_TICK_FIELDS = ["tick", "keyframe"];
+var SETTLE_ACK_TRAIL = 64;
+function settleAckTrail() {
+  let trail = [];
+  let floor = 0;
+  return {
+    snapshot(tick, ack) {
+      const last = trail.at(-1)?.ack ?? floor;
+      if (ack <= last) return;
+      trail.push({ tick, ack });
+      if (trail.length > SETTLE_ACK_TRAIL) trail = trail.slice(-SETTLE_ACK_TRAIL);
+    },
+    through(tick) {
+      let kept = 0;
+      while (kept < trail.length && trail[kept].tick <= tick) {
+        floor = Math.max(floor, trail[kept].ack);
+        kept += 1;
+      }
+      if (kept > 0) trail = trail.slice(kept);
+      return floor;
+    },
+    reset(at2) {
+      trail = [];
+      floor = at2;
+    }
+  };
+}
 function defaultFastLog(line) {
   const stderr = globalThis.process?.stderr;
   if (stderr?.write !== void 0) stderr.write(`${line}
@@ -4692,6 +4719,7 @@ function fastSeat(o) {
   let link = null;
   let fallback = null;
   let fastAck = 0;
+  const settle2 = settleAckTrail();
   let early = [];
   let pendingBind = null;
   let offerAwaitedFrom = null;
@@ -4764,6 +4792,7 @@ function fastSeat(o) {
     const base = seqBase();
     const wsBefore = fallback.wsBefore + (handle.sentCount - fallback.at);
     fastAck = ack();
+    settle2.reset(fastAck);
     link = { client: p.client, seqBase: base, wsBefore, stampAtBind: baselines?._lastStamp ?? 0 };
     fallback = null;
     retryAt = null;
@@ -4831,6 +4860,7 @@ function fastSeat(o) {
       if (at2 !== void 0) rtt = o.now() - at2;
       fastAck = acked;
     }
+    settle2.snapshot(s.tick, fastAck);
     room.clock.sample(s.sent, rtt);
     guard?.write(s);
   };
@@ -4852,6 +4882,7 @@ function fastSeat(o) {
     askRoundTrip(client);
     link = { client, seqBase: seqBase(), wsBefore: handle.sentCount, stampAtBind: baselines?._lastStamp ?? 0 };
     fastAck = 0;
+    settle2.reset(0);
     status.live = true;
     liveSince = o.now();
     for (const s of early) client.queue({ ...s, seq: link.seqBase + s.seq });
@@ -4890,6 +4921,10 @@ function fastSeat(o) {
   return {
     status,
     ack,
+    settleAck() {
+      if (link === null) return ack();
+      return Math.min(ack(), settle2.through(guard?.webSocketTick() ?? Number(room.state.tick ?? 0)));
+    },
     sent(seq, tick, input) {
       if (o.open === void 0 || fallback !== null) return;
       const render = renderStamp();
@@ -5065,6 +5100,9 @@ function motionGuard(room, live) {
     }
   });
   return {
+    webSocketTick() {
+      return Number(held.get(state)?.get("tick")?.ws ?? room.state.tick ?? 0);
+    },
     write(s) {
       learn();
       const changes = [];
@@ -5233,12 +5271,16 @@ var SessionEvent = {
 var SESSION_EVENTS = new Set(Object.values(SessionEvent));
 var MESSAGE = {
   protocol: `[multiplayer] the authority server refused protocol ${AUTHORITY_PROTOCOL_VERSION} (code 426) \u2014 this game was built with a @genex-ai/multiplayer that the server no longer serves. Update the package and republish.`,
-  notEntitled: "[multiplayer] server-authoritative rooms are not available for this game (code 402): its owner is not entitled to them. This is final; the session does not retry."
+  notEntitled: "[multiplayer] server-authoritative rooms are not available for this game (code 402): its owner is not entitled to them. This is final; the session does not retry.",
+  freeQuota: "[multiplayer] no new server-authoritative room for this game (code 429): its owner is on Genex's free tier and has used the free included room time for this period. Rooms already running are not affected; new rooms open again next period, or with Genex Pro."
 };
 var errorCode = (err) => err && typeof err === "object" ? err.code : void 0;
+var errorMessage = (err) => err && typeof err === "object" ? err.message : void 0;
+var isFreeQuotaRefusal = (err) => errorCode(err) === JoinError.ROOM_QUOTA && errorMessage(err) === FREE_QUOTA_REFUSAL;
 function explainAuthorityRefusal(err) {
   if (isProtocolRefusal(err)) console.error(MESSAGE.protocol);
   else if (errorCode(err) === JoinError.NOT_ENTITLED) console.error(MESSAGE.notEntitled);
+  else if (isFreeQuotaRefusal(err)) console.error(MESSAGE.freeQuota);
   throw err;
 }
 var predictsPhysics = (opts) => opts.physicsCore !== void 0 && opts.predictPhysics !== false;
@@ -5965,7 +6007,7 @@ function attachAuthoritySession(room, opts, url) {
   const unsettled = /* @__PURE__ */ new Map();
   const settleShots = () => {
     if (unsettled.size === 0) return;
-    const acked = fast.ack();
+    const acked = fast.settleAck();
     for (const [shot, drop] of unsettled) {
       if (shot.epoch !== handle.epoch || shot.seq > acked || entityMap().has(shot.id)) continue;
       unsettled.delete(shot);

package/dist/{chunk-FPWP22Y7.js → chunk-TEHGMFAG.js}

@@ -2,7 +2,7 @@ import {
   ClientReconnection,
   JoinError,
   PROTOCOL_VERSION
-} from "./chunk-CSQEEANB.js";
+} from "./chunk-WEMRRIHH.js";
 
 // src/join.ts
 import { Client as Client2 } from "@colyseus/sdk";

package/dist/{chunk-CSQEEANB.js → chunk-WEMRRIHH.js}

@@ -55,7 +55,7 @@ var AuthorityJoinOption = {
    *  refused with 400. */
   SUCCESSOR_CLOSED: "successorClosed"
 };
-var AUTHORITY_SDK_LABEL = "ts/0.17.8";
+var AUTHORITY_SDK_LABEL = "ts/0.17.9";
 var AuthorityCaps = {
   /** Decodes and draws §17.10's physics bodies. A physics room refuses a join without it (426). An
    *  SDK sends it only once its drawing passes `physics-draw.json` and, for an engine SDK, its own
@@ -149,6 +149,7 @@ var JoinError = {
   /** No authority server can take the room right now, or admission could not be checked. Retry later. */
   AUTHORITY_CAPACITY: 503
 };
+var FREE_QUOTA_REFUSAL = "free_quota_exhausted";
 var STAGING_ROOM_PREFIX = "preview--";
 var roomKeyFor = (slug, channel) => channel === "staging" ? `${STAGING_ROOM_PREFIX}${slug}` : slug;
 var slugOfRoomKey = (key) => key.startsWith(STAGING_ROOM_PREFIX) ? key.slice(STAGING_ROOM_PREFIX.length) : key;
@@ -494,6 +495,7 @@ export {
   SERVER_OWNED_JOIN_OPTIONS,
   AUTHORITY_SERVER_OWNED_JOIN_OPTIONS,
   JoinError,
+  FREE_QUOTA_REFUSAL,
   STAGING_ROOM_PREFIX,
   roomKeyFor,
   slugOfRoomKey,

package/dist/{chunk-NFMGIKFZ.js → chunk-ZDGSUR6E.js}

@@ -19,7 +19,7 @@ import {
   JoinError,
   Limits,
   isReservedEventType
-} from "./chunk-CSQEEANB.js";
+} from "./chunk-WEMRRIHH.js";
 
 // src/authority/room-key.ts
 var AuthorityRoomLimits = {

package/dist/index.js

@@ -3,9 +3,9 @@ import {
   createPrivate,
   joinPrivate,
   matchmake
-} from "./chunk-QY3QQNDJ.js";
-import "./chunk-FPWP22Y7.js";
-import "./chunk-CSQEEANB.js";
+} from "./chunk-DJ2XYETS.js";
+import "./chunk-TEHGMFAG.js";
+import "./chunk-WEMRRIHH.js";
 export {
   connect,
   createPrivate,

package/dist/protocol.d.ts

@@ -76,7 +76,7 @@ interface AuthorityDrainNotice {
     drainMs: number;
 }
 /** The SDK label this TypeScript client sends. tests hold it to package.json. */
-declare const AUTHORITY_SDK_LABEL = "ts/0.17.8";
+declare const AUTHORITY_SDK_LABEL = "ts/0.17.9";
 /** Client capabilities (§17.10 *Joining*). */
 declare const AuthorityCaps: {
     /** Decodes and draws §17.10's physics bodies. A physics room refuses a join without it (426). An
@@ -177,6 +177,9 @@ declare const JoinError: {
     /** No authority server can take the room right now, or admission could not be checked. Retry later. */
     readonly AUTHORITY_CAPACITY: 503;
 };
+/** The ROOM_QUOTA refusal's reason when the game's owner is on the free tier and has used its
+ *  included room time for this period (the API's `AdmitRefusal.FreeQuotaExhausted`). */
+declare const FREE_QUOTA_REFUSAL = "free_quota_exhausted";
 /** A preview (staging) build's rooms: the relay keys them `preview--<slug>`, apart from the live
  *  game's rooms, so testers on a preview link play together and never meet real players. The
  *  client always sends the plain slug as `gameId`; the relay picks the room from the token's
@@ -636,4 +639,4 @@ declare const ClockSync: {
     readonly WARMUP_ACKS: 30;
 };
 
-export { AUTHORITY_ENCODER_BUFFER_BYTES, AUTHORITY_MAX_FRAME_BYTES, AUTHORITY_MAX_MESSAGES_PER_SECOND, AUTHORITY_MIN_PROTOCOL_VERSION, AUTHORITY_PHYSICS_TICK_WEIGHT, AUTHORITY_PHYSICS_UNITS, AUTHORITY_PROTOCOL_VERSION, AUTHORITY_ROOM_ENDED_TEXT, AUTHORITY_SDK_LABEL, AUTHORITY_SERVER_OWNED_JOIN_OPTIONS, AUTHORITY_WINDOW, AuthorityCaps, AuthorityCloseCode, type AuthorityDrainNotice, AuthorityJoinOption, AuthorityTiming, type ChatMessage, ClientMessage, type ClientMessageType, ClientReconnection, ClockSync, CloseCode, GLOBAL_RATE, type IceConfig, type IceServer, type InputEnvelope, Interpolation, JoinError, JoinOption, Limits, MAX_MESSAGES_PER_SECOND, MESSAGE_LANE, MIN_PROTOCOL_VERSION, type MatchEnded, type ObjectControlOperation, type ObjectControlReason, type ObjectControlRequest, type ObjectControlResult, type ObjectPublish, POSE_KEYS, PROTOCOL_VERSION, type PoseKey, type PosePublish, type ProtocolWindow, RATE_LANES, RELAY_WINDOW, RESERVED_EVENT_PREFIXES, RESERVED_EVENT_TYPES, RESERVED_SHARED_PREFIX, type RateLane, RelayTiming, RoomType, SEND_TIME_KEY, SERVER_OWNED_JOIN_OPTIONS, STAGING_ROOM_PREFIX, SeatCloseReason, ServerMessage, type ServerMessageType, type SharedWrite, type VoiceSignal, type VoiceSignalEnvelope, authorityCloseCodeOf, authorityPhysicsBudgetSixtieths, authorityRoomUnits, authorityTickBudgetMs, capsOf, inProtocolWindow, isReservedEventType, roomKeyFor, slugOfRoomKey };
+export { AUTHORITY_ENCODER_BUFFER_BYTES, AUTHORITY_MAX_FRAME_BYTES, AUTHORITY_MAX_MESSAGES_PER_SECOND, AUTHORITY_MIN_PROTOCOL_VERSION, AUTHORITY_PHYSICS_TICK_WEIGHT, AUTHORITY_PHYSICS_UNITS, AUTHORITY_PROTOCOL_VERSION, AUTHORITY_ROOM_ENDED_TEXT, AUTHORITY_SDK_LABEL, AUTHORITY_SERVER_OWNED_JOIN_OPTIONS, AUTHORITY_WINDOW, AuthorityCaps, AuthorityCloseCode, type AuthorityDrainNotice, AuthorityJoinOption, AuthorityTiming, type ChatMessage, ClientMessage, type ClientMessageType, ClientReconnection, ClockSync, CloseCode, FREE_QUOTA_REFUSAL, GLOBAL_RATE, type IceConfig, type IceServer, type InputEnvelope, Interpolation, JoinError, JoinOption, Limits, MAX_MESSAGES_PER_SECOND, MESSAGE_LANE, MIN_PROTOCOL_VERSION, type MatchEnded, type ObjectControlOperation, type ObjectControlReason, type ObjectControlRequest, type ObjectControlResult, type ObjectPublish, POSE_KEYS, PROTOCOL_VERSION, type PoseKey, type PosePublish, type ProtocolWindow, RATE_LANES, RELAY_WINDOW, RESERVED_EVENT_PREFIXES, RESERVED_EVENT_TYPES, RESERVED_SHARED_PREFIX, type RateLane, RelayTiming, RoomType, SEND_TIME_KEY, SERVER_OWNED_JOIN_OPTIONS, STAGING_ROOM_PREFIX, SeatCloseReason, ServerMessage, type ServerMessageType, type SharedWrite, type VoiceSignal, type VoiceSignalEnvelope, authorityCloseCodeOf, authorityPhysicsBudgetSixtieths, authorityRoomUnits, authorityTickBudgetMs, capsOf, inProtocolWindow, isReservedEventType, roomKeyFor, slugOfRoomKey };

package/dist/protocol.js

@@ -18,6 +18,7 @@ import {
   ClientReconnection,
   ClockSync,
   CloseCode,
+  FREE_QUOTA_REFUSAL,
   GLOBAL_RATE,
   Interpolation,
   JoinError,
@@ -49,7 +50,7 @@ import {
   isReservedEventType,
   roomKeyFor,
   slugOfRoomKey
-} from "./chunk-CSQEEANB.js";
+} from "./chunk-WEMRRIHH.js";
 export {
   AUTHORITY_ENCODER_BUFFER_BYTES,
   AUTHORITY_MAX_FRAME_BYTES,
@@ -70,6 +71,7 @@ export {
   ClientReconnection,
   ClockSync,
   CloseCode,
+  FREE_QUOTA_REFUSAL,
   GLOBAL_RATE,
   Interpolation,
   JoinError,

package/package.json

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