@genex-ai/multiplayer 0.17.0 → 0.17.6

package/dist/{chunk-CTDU4IJ5.js → chunk-7QVOIHJF.js}

@@ -1,10 +1,20 @@
+import {
+  explainJoinRefusal,
+  isProtocolRefusal,
+  joinOptions,
+  relayClient,
+  seedsInterpolation,
+  useSdkReconnection,
+  waitForFirstState,
+  warnProtocolRefusal,
+  withoutReconnection
+} from "./chunk-UX3F6YTV.js";
 import {
   ClientMessage,
   ClientReconnection,
   ClockSync,
   CloseCode,
   Interpolation,
-  JoinError,
   Limits,
   POSE_KEYS,
   PROTOCOL_VERSION,
@@ -13,10 +23,10 @@ import {
   SEND_TIME_KEY,
   ServerMessage,
   isReservedEventType
-} from "./chunk-C52XFIB6.js";
+} from "./chunk-ZSWF4VCN.js";
 
 // src/index.ts
-import { Client, getStateCallbacks } from "@colyseus/sdk";
+import { getStateCallbacks } from "@colyseus/sdk";
 
 // src/ice-request.ts
 function createIceRequester(send, timeoutMs) {
@@ -241,40 +251,6 @@ function msUntil(epochMs, clock) {
   return epochMs - clock.wallNow;
 }
 
-// src/room-lifecycle.ts
-function useSdkReconnection(room) {
-  const r = room.reconnection;
-  r.enabled = ClientReconnection.enabled;
-  r.minUptime = ClientReconnection.minUptime;
-  r.delay = ClientReconnection.delay;
-  r.minDelay = ClientReconnection.minDelay;
-  r.maxDelay = ClientReconnection.maxDelay;
-  r.maxRetries = ClientReconnection.maxRetries;
-  r.maxEnqueuedMessages = ClientReconnection.maxEnqueuedMessages;
-  r.enqueuedMessages.length = 0;
-  return room;
-}
-function withoutReconnection(room) {
-  room.reconnection.enabled = false;
-  return room;
-}
-function waitForFirstState(room, timeoutMs) {
-  return new Promise((resolve) => {
-    const onState = () => {
-      clearTimeout(timer);
-      resolve(true);
-    };
-    const timer = setTimeout(() => {
-      room.onStateChange.remove(onState);
-      resolve(false);
-    }, timeoutMs);
-    room.onStateChange.once(onState);
-  });
-}
-function seedsInterpolation(id, selfId, sendTime) {
-  return id !== selfId && sendTime != null;
-}
-
 // src/voice.ts
 var NOT_DELEGATED = "The microphone was refused by the page that frames this game, not by the player: the frame was not given it, so the browser never asked. On its Genex page a build is given the microphone only when it declares it. An up-to-date genex CLI declares it at `genex preview` and `genex publish` when the game's own source calls voice.join(); to declare it by hand, add \"microphone\" to genex.capabilities in the game's package.json. Then preview or publish again.";
 var VoiceNotDelegatedError = class extends Error {
@@ -680,14 +656,6 @@ var ICE_REQUEST_TIMEOUT_MS = 3e3;
 var CONTROL_TIMEOUT_MS = 5e3;
 var CONTROL_TIMEOUT_MAX_MS = 6e4;
 var POSE_DATA_KEEPALIVE_MS = 2e3;
-async function relayClient(opts) {
-  if (opts.url) return new Client(opts.url);
-  if (opts.urls.length > 1) return Client.selectByLatency(opts.urls);
-  const url = opts.urls[0];
-  if (!url) throw new Error("genex multiplayer: `urls` must contain at least one relay URL");
-  return new Client(url);
-}
-var resolveAuth = (auth) => typeof auth === "function" ? auth() : auth;
 function predictSmoothing(opt) {
   if (opt === "predict") return { mode: "lerp" };
   if (opt && typeof opt === "object" && opt.engine === "predict") {
@@ -832,22 +800,6 @@ async function connect(opts) {
   );
   return attachSession(room, { pose: opts.pose, smoothing: opts.smoothing, predict });
 }
-function joinOptions(gameId, name, auth) {
-  return {
-    gameId,
-    name,
-    embedToken: resolveAuth(auth)?.embedToken,
-    protocol: PROTOCOL_VERSION
-  };
-}
-var isProtocolRefusal = (err) => !!err && typeof err === "object" && err.code === JoinError.PROTOCOL_UNSUPPORTED;
-var warnProtocolRefusal = () => console.error(
-  `[multiplayer] the relay refused protocol ${PROTOCOL_VERSION} (code 426) \u2014 this game was built with a @genex-ai/multiplayer that this relay no longer serves. Update the package and republish.`
-);
-var explainJoinRefusal = (err) => {
-  if (isProtocolRefusal(err)) warnProtocolRefusal();
-  throw err;
-};
 var isSendableEventType = (type) => typeof type === "string" && type.length > 0 && type.length <= Limits.MAX_EVENT_TYPE_CHARS && !isReservedEventType(type);
 var LOCAL_EVENTS = /* @__PURE__ */ new Set([
   "join",

package/dist/chunk-K3SF5VDS.js

@@ -0,0 +1,27 @@
+// src/authority/module.ts
+var MODULE_CONTRACT = 1;
+var LeaveReason = {
+  /** The client left on purpose. */
+  LEFT: "left",
+  /** The connection dropped and the reconnection grace ran out. */
+  DROPPED: "dropped",
+  /** A newer session of the same player took the seat. */
+  SUPERSEDED: "superseded",
+  /** The player's session was revoked. */
+  REVOKED: "revoked",
+  /** The room is closing (drain, halt or fault). */
+  CLOSING: "closing"
+};
+var RemotePredict = {
+  EXTRAPOLATE: "extrapolate",
+  HOLD: "hold",
+  INPUT_DECAY: "inputDecay"
+};
+var defineRoom = (module) => module;
+
+export {
+  MODULE_CONTRACT,
+  LeaveReason,
+  RemotePredict,
+  defineRoom
+};

package/dist/chunk-UX3F6YTV.js

@@ -0,0 +1,143 @@
+import {
+  ClientReconnection,
+  JoinError,
+  PROTOCOL_VERSION
+} from "./chunk-ZSWF4VCN.js";
+
+// src/join.ts
+import { Client as Client2 } from "@colyseus/sdk";
+
+// src/relay-select.ts
+import { Client } from "@colyseus/sdk";
+var RELAY_SELECT_DEFAULTS = {
+  SAMPLES: 3,
+  // Well past Colyseus's 1.5 s, which a loading web export's main thread was measured exceeding.
+  TIMEOUT_MS: 4e3,
+  // A far relay's sample lands within a few hundred ms of a near one's; a dead relay must not hold
+  // a working join for the full timeout.
+  GRACE_MS: 1e3
+};
+async function selectRelayUrl(urls, options = {}) {
+  const first = urls[0];
+  if (first === void 0) throw new Error("genex multiplayer: `urls` must contain at least one relay URL");
+  if (urls.length === 1) return first;
+  const probe = options.probe ?? defaultProbe;
+  const samples = Math.max(1, options.samples ?? RELAY_SELECT_DEFAULTS.SAMPLES);
+  const timeoutMs = options.timeoutMs ?? RELAY_SELECT_DEFAULTS.TIMEOUT_MS;
+  const graceMs = options.graceMs ?? RELAY_SELECT_DEFAULTS.GRACE_MS;
+  const best = urls.map(() => void 0);
+  await new Promise((resolve) => {
+    let pending = urls.length * samples;
+    let grace;
+    const ceiling = setTimeout(done, timeoutMs);
+    function done() {
+      clearTimeout(ceiling);
+      clearTimeout(grace);
+      resolve();
+    }
+    const settle = () => {
+      if (--pending === 0) done();
+    };
+    urls.forEach((url, i) => {
+      for (let n = 0; n < samples; n++) {
+        let sample;
+        try {
+          sample = probe(url, timeoutMs);
+        } catch (err) {
+          sample = Promise.reject(err);
+        }
+        sample.then(
+          (ms) => {
+            if (Number.isFinite(ms) && ms >= 0) {
+              best[i] = Math.min(best[i] ?? Infinity, ms);
+              grace ??= setTimeout(done, graceMs);
+            }
+            settle();
+          },
+          settle
+        );
+      }
+    });
+  });
+  let pick = -1;
+  best.forEach((ms, i) => {
+    if (ms !== void 0 && (pick < 0 || ms < best[pick])) pick = i;
+  });
+  if (pick < 0) {
+    console.warn(`genex multiplayer: no relay answered the latency probe \u2014 connecting to ${first}`);
+    return first;
+  }
+  return urls[pick];
+}
+var defaultProbe = (url, timeoutMs) => new Client(url).getLatency({ pingCount: 1, timeout: timeoutMs });
+
+// src/join.ts
+var resolveAuth = (auth) => typeof auth === "function" ? auth() : auth;
+async function relayClient(opts) {
+  if (opts.url) return new Client2(opts.url);
+  return new Client2(await selectRelayUrl(opts.urls));
+}
+function joinOptions(gameId, name, auth) {
+  return {
+    gameId,
+    name,
+    embedToken: resolveAuth(auth)?.embedToken,
+    protocol: PROTOCOL_VERSION
+  };
+}
+var isProtocolRefusal = (err) => !!err && typeof err === "object" && err.code === JoinError.PROTOCOL_UNSUPPORTED;
+var warnProtocolRefusal = () => console.error(
+  `[multiplayer] the relay refused protocol ${PROTOCOL_VERSION} (code 426) \u2014 this game was built with a @genex-ai/multiplayer that this relay no longer serves. Update the package and republish.`
+);
+var explainJoinRefusal = (err) => {
+  if (isProtocolRefusal(err)) warnProtocolRefusal();
+  throw err;
+};
+
+// src/room-lifecycle.ts
+function useSdkReconnection(room) {
+  const r = room.reconnection;
+  r.enabled = ClientReconnection.enabled;
+  r.minUptime = ClientReconnection.minUptime;
+  r.delay = ClientReconnection.delay;
+  r.minDelay = ClientReconnection.minDelay;
+  r.maxDelay = ClientReconnection.maxDelay;
+  r.maxRetries = ClientReconnection.maxRetries;
+  r.maxEnqueuedMessages = ClientReconnection.maxEnqueuedMessages;
+  r.enqueuedMessages.length = 0;
+  return room;
+}
+function withoutReconnection(room) {
+  room.reconnection.enabled = false;
+  return room;
+}
+function waitForFirstState(room, timeoutMs) {
+  return new Promise((resolve) => {
+    const onState = () => {
+      clearTimeout(timer);
+      resolve(true);
+    };
+    const timer = setTimeout(() => {
+      room.onStateChange.remove(onState);
+      resolve(false);
+    }, timeoutMs);
+    room.onStateChange.once(onState);
+  });
+}
+function seedsInterpolation(id, selfId, sendTime) {
+  return id !== selfId && sendTime != null;
+}
+
+export {
+  RELAY_SELECT_DEFAULTS,
+  defaultProbe,
+  relayClient,
+  joinOptions,
+  isProtocolRefusal,
+  warnProtocolRefusal,
+  explainJoinRefusal,
+  useSdkReconnection,
+  withoutReconnection,
+  waitForFirstState,
+  seedsInterpolation
+};