@genex-ai/multiplayer 0.17.6 → 0.17.9

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

@@ -36,8 +36,26 @@ var AuthorityJoinOption = {
   /** The capabilities this client implements: at most {@link AuthorityCaps.MAX_CAPS} strings of at
    *  most {@link AuthorityCaps.MAX_CAP_CHARS} characters; absent = []. Any other value is refused
    *  with 400 by every authority room. */
-  CAPS: "caps"
+  CAPS: "caps",
+  /** The client's SDK and version, `<sdk>/<version>` (§17.1): counted so a protocol bump can see whom it would
+   *  strand. Telemetry only: anything malformed is counted as unknown, never refused. */
+  SDK: "sdk",
+  /** The pool this join asks for (§17.2 *Choosing a room*): rooms are found by it beside the game and
+   *  the region. Absent or empty = the game's one pool, as a client that names no room has always had.
+   *  Malformed (authority/room-key.ts `matchKeyOf`) is refused with 400. */
+  MATCH_KEY: "matchKey",
+  /** `true` on a `create` makes a private room: no matchmaking reaches it, only its code. Any other
+   *  type is refused with 400. */
+  PRIVATE: "private",
+  /** The room this seat lost (§17.13 *Drain and rejoin*): a room code. Rooms are found by it too, so a
+   *  lost room's seats meet in one successor, which alone reads the room's hand-off. Absent or empty =
+   *  no successor. Malformed is refused with 400. */
+  SUCCESSOR_OF: "successorOf",
+  /** `true` keeps a successor closed to the game's pool: the lost room was private. Any other type is
+   *  refused with 400. */
+  SUCCESSOR_CLOSED: "successorClosed"
 };
+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
@@ -68,6 +86,10 @@ var AuthorityCaps = {
    *  beside `tick@1`. An SDK sends it only once it passes `fast-transport.json` and its transport
    *  tests; a room that does not offer the channel ignores it. */
   FAST: "fast@1",
+  /** The seat can come back to the fast channel after a fallback (§17.12 *Return to the channel*): it asks
+   *  for a fresh binding, proves the path and swaps. Sent beside `fast@1`; a host that does not know it
+   *  ignores it, and a client asks only a host whose binding says `rev` 2. */
+  FAST_RETURN: "fast-return@1",
   MAX_CAPS: 16,
   MAX_CAP_CHARS: 32
 };
@@ -101,7 +123,8 @@ var AUTHORITY_SERVER_OWNED_JOIN_OPTIONS = [
   "seed",
   "units",
   "leaseId",
-  "region"
+  "region",
+  "createdBy"
 ];
 var JoinError = {
   /** A server-owned option was sent. */
@@ -110,6 +133,9 @@ var JoinError = {
   AUTH_REQUIRED: 401,
   /** Token for another game ('wrong game'), or the room's guest cap is full. */
   FORBIDDEN: 403,
+  /** A join by code entered through another region than the room's (§17.2 *Choosing a room*): the
+   *  client tries its next region. */
+  WRONG_REGION: 421,
   /** `protocol` missing or outside the room type's window ({@link RELAY_WINDOW},
    *  {@link AUTHORITY_WINDOW}). Update the client. */
   PROTOCOL_UNSUPPORTED: 426,
@@ -123,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;
@@ -190,6 +217,14 @@ var RATE_LANES = {
 };
 var GLOBAL_RATE = { rate: 180, burst: 360 };
 var MAX_MESSAGES_PER_SECOND = 1200;
+var AUTHORITY_MAX_MESSAGES_PER_SECOND = 2400;
+var AUTHORITY_MAX_FRAME_BYTES = 4 * 1024;
+var SeatCloseReason = {
+  /** Its socket passed {@link AUTHORITY_MAX_MESSAGES_PER_SECOND} (4002). */
+  MessageFlood: "message_flood",
+  /** Its input had not changed for the room's idle limit (4408). */
+  SeatIdle: "seat_idle"
+};
 var MESSAGE_LANE = {
   [ClientMessage.STATE]: "state",
   [ClientMessage.STATE_SNAP]: "state",
@@ -235,12 +270,47 @@ var CloseCode = {
   REVOKED: 4401,
   /** A newer session of the same player took the seat (second tab, or the page reloaded). */
   SUPERSEDED: 4409,
+  /** Authority rooms: the seat's input had not changed for the room's idle limit (§17.6 *Room lifetime*). */
+  IDLE: 4408,
   // ---- authority rooms only (§17.6), terminal ----
   /** The operator or the platform halted the room (kill switch, takedown, disabled game). */
   MODULE_HALTED: 4500,
   /** The game's room module broke its limits or threw; the room is gone. */
   MODULE_FAULT: 4501
 };
+var AuthorityCloseCode = {
+  /** A call ran past its hard timeout (an infinite loop, a long microtask). */
+  ModuleTimeout: "module_timeout",
+  /** The module hit its memory limit, or the heap poll caught it near the limit. */
+  ModuleMemory: "module_memory",
+  /** The module threw (or failed to load) too many times. */
+  ModuleError: "module_error",
+  /** The module's output broke the wire limits too many times. */
+  ModuleOutputInvalid: "module_output_invalid",
+  /** The module stayed under the hard timeout but over the mean CPU budget for a whole window. */
+  ModuleBudget: "module_budget",
+  /** The operator or the platform stopped the room (kill switch, takedown, disabled game). */
+  Halted: "halted",
+  /** isolated-vm's wall-clock backstop stopped a call while the guest's own CPU stayed under its limit: the
+   *  host stalled (contention, a GC pause, descheduled). The guest was cut off mid-call, so it is
+   *  never called again; the room ends, but the module is not at fault. */
+  HostStall: "host_stall",
+  /** The room's physics passed the physics meter for the third strike (§17.10). */
+  PhysicsBudget: "physics_budget",
+  /** The room reached its age limit (§17.6 *Room lifetime*), announced like a drain. Not a fault. */
+  RoomAge: "room_age",
+  /** The room sent more than its ceiling for a whole window (§17.6 *The downlink budget*): its module writes
+   *  too much state or too many events for its seats. Lower what it writes; no strike comes first. */
+  ModuleBandwidth: "module_bandwidth",
+  /** The physics core answered `internal` (C§11.3): every physics room on that instance ends. Never
+   *  the module's fault. */
+  PhysicsInternal: "physics_internal"
+};
+function authorityCloseCodeOf(reason) {
+  const known = Object.values(AuthorityCloseCode);
+  return known.includes(reason) ? reason : null;
+}
+var AUTHORITY_ROOM_ENDED_TEXT = "This match ended because of a problem with the game. Please try again.";
 var Limits = {
   ROOM_MAX_CLIENTS: 64,
   MAX_NAME_CHARS: 64,
@@ -413,6 +483,7 @@ export {
   RoomType,
   JoinOption,
   AuthorityJoinOption,
+  AUTHORITY_SDK_LABEL,
   AuthorityCaps,
   capsOf,
   AUTHORITY_PHYSICS_UNITS,
@@ -424,6 +495,7 @@ export {
   SERVER_OWNED_JOIN_OPTIONS,
   AUTHORITY_SERVER_OWNED_JOIN_OPTIONS,
   JoinError,
+  FREE_QUOTA_REFUSAL,
   STAGING_ROOM_PREFIX,
   roomKeyFor,
   slugOfRoomKey,
@@ -437,8 +509,14 @@ export {
   RATE_LANES,
   GLOBAL_RATE,
   MAX_MESSAGES_PER_SECOND,
+  AUTHORITY_MAX_MESSAGES_PER_SECOND,
+  AUTHORITY_MAX_FRAME_BYTES,
+  SeatCloseReason,
   MESSAGE_LANE,
   CloseCode,
+  AuthorityCloseCode,
+  authorityCloseCodeOf,
+  AUTHORITY_ROOM_ENDED_TEXT,
   Limits,
   RelayTiming,
   AuthorityTiming,

package/dist/chunk-YWQ3ALYY.js

@@ -0,0 +1,69 @@
+// src/authority/fast-udp-socket.ts
+var IPV6_FAMILY = 6;
+var lookupTurns = /* @__PURE__ */ new Map();
+var UDP_SCHEME = "udp:";
+var PORT_MAX = 65535;
+var CONNECT_QUEUE_MAX = 32;
+var BARE_PATHS = ["", "/"];
+var onlyHostAndPort = (u) => u.username === "" && u.password === "" && BARE_PATHS.includes(u.pathname) && u.search === "" && u.hash === "";
+function udpEndpoint(url) {
+  let parsed;
+  try {
+    parsed = new URL(url);
+  } catch {
+    return null;
+  }
+  const port = Number(parsed.port);
+  const portOk = Number.isInteger(port) && port >= 1 && port <= PORT_MAX;
+  if (parsed.protocol !== UDP_SCHEME || !portOk || parsed.hostname === "" || !onlyHostAndPort(parsed)) return null;
+  return { host: parsed.hostname.replace(/^\[(.*)\]$/, "$1"), port };
+}
+var udpFastOpener = ({ createSocket, lookup, isIP }) => (url, receive) => {
+  const to = udpEndpoint(url);
+  if (to === null) return null;
+  let socket = null;
+  let connected = false;
+  let closed = false;
+  let waiting = [];
+  const attach = (address, family) => {
+    if (closed) return;
+    const s = createSocket(family === IPV6_FAMILY ? "udp6" : "udp4");
+    socket = s;
+    s.on("message", (msg) => receive(new Uint8Array(msg.buffer, msg.byteOffset, msg.byteLength)));
+    s.on("error", () => {
+    });
+    s.connect(to.port, address, () => {
+      connected = true;
+      if (!closed) for (const bytes of waiting) s.send(bytes);
+      waiting = [];
+    });
+  };
+  const literal = isIP(to.host);
+  if (literal !== 0) attach(to.host, literal);
+  else {
+    lookup(to.host, { all: true, verbatim: true }, (err, found) => {
+      if (err !== null || found.length === 0) return;
+      const turn = (lookupTurns.get(to.host) ?? 0) % found.length;
+      lookupTurns.set(to.host, turn + 1);
+      attach(found[turn].address, found[turn].family);
+    });
+  }
+  const fast = {
+    send(bytes) {
+      if (closed) return;
+      if (connected) socket?.send(bytes);
+      else waiting = [...waiting, bytes].slice(-CONNECT_QUEUE_MAX);
+    },
+    close() {
+      if (closed) return;
+      closed = true;
+      socket?.close();
+    }
+  };
+  return fast;
+};
+
+export {
+  udpEndpoint,
+  udpFastOpener
+};