@genex-ai/multiplayer 0.17.0 → 0.17.1

package/dist/bridge.js

@@ -4,7 +4,7 @@ import {
   joinPrivate,
   matchmake,
   roomOf
-} from "./chunk-CTDU4IJ5.js";
+} from "./chunk-3ZUPU3GT.js";
 import {
   Limits,
   RESERVED_SHARED_PREFIX,

package/dist/{chunk-CTDU4IJ5.js → chunk-3ZUPU3GT.js}

@@ -16,7 +16,71 @@ import {
 } from "./chunk-C52XFIB6.js";
 
 // src/index.ts
-import { Client, getStateCallbacks } from "@colyseus/sdk";
+import { Client as Client2, getStateCallbacks } 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/ice-request.ts
 function createIceRequester(send, timeoutMs) {
@@ -681,11 +745,8 @@ 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);
+  if (opts.url) return new Client2(opts.url);
+  return new Client2(await selectRelayUrl(opts.urls));
 }
 var resolveAuth = (auth) => typeof auth === "function" ? auth() : auth;
 function predictSmoothing(opt) {

package/dist/index.d.ts

@@ -44,13 +44,14 @@ type ColyseusAuth = {
 };
 type AuthSource = ColyseusAuth | (() => ColyseusAuth | undefined);
 type ConnectOptions = {
-    /** Regional relay urls (pass `getColyseusUrls()`) — the SDK pings each and connects to the
-     *  lowest-latency one; a single entry just connects. */
+    /** Regional relay urls (pass `getColyseusUrls()`) — the SDK probes each and connects to the
+     *  lowest-latency one (a probe that times out falls back, it never fails the join); a single entry
+     *  just connects. */
     urls: string[];
-    /** Cross-region invite override: connect to THIS exact relay url, skipping latency selection. Two
-     *  players are only in the same room if they share one region's relay, so an invitee must follow the
-     *  inviter's region (carried in the invite) instead of picking its own nearest. Omit for normal
-     *  nearest-region play. */
+    /** Override: connect to THIS exact relay url, skipping latency selection. Relays that share
+     *  presence (global matchmaking) seat players together whichever relay each enters through, so
+     *  this is only needed against relays that do not — there two players meet only on one relay, and
+     *  an invitee follows the inviter's region. Omit for normal nearest-region play. */
     url?: string;
     /** Game id — everyone who passes the same id shares a room; different ids are
      * fully isolated. Use your project slug (or any stable per-game string). */
@@ -518,8 +519,8 @@ type Matchmaking<TState extends Record<string, unknown>> = {
 type MatchmakeOptions = {
     /** Regional relay urls (pass `getColyseusUrls()`) — pings each, connects to the lowest-latency one. */
     urls: string[];
-    /** Cross-region override: matchmake on THIS exact relay url, skipping latency selection — an invitee
-     *  follows the inviter's region so both land on the same relay. Omit for normal nearest-region play. */
+    /** Override: matchmake on THIS exact relay url, skipping latency selection — only needed against
+     *  relays that do not share presence (see ConnectOptions.url). Omit for normal nearest-region play. */
     url?: string;
     /** Game id (your project slug/id) — isolates this game's matchmaking. */
     room: string;

package/dist/index.js

@@ -3,7 +3,7 @@ import {
   createPrivate,
   joinPrivate,
   matchmake
-} from "./chunk-CTDU4IJ5.js";
+} from "./chunk-3ZUPU3GT.js";
 import "./chunk-C52XFIB6.js";
 export {
   connect,

package/package.json

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