@genex-ai/multiplayer 0.10.2 → 0.11.0

package/dist/index.d.ts

@@ -9,6 +9,11 @@ type ConnectOptions = {
     /** Regional relay urls (pass `getColyseusUrls()`) — the SDK pings each and connects to the
      *  lowest-latency one; 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. */
+    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). */
     room: string;
@@ -277,6 +282,9 @@ 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. */
+    url?: string;
     /** Game id (your project slug/id) — isolates this game's matchmaking. */
     room: string;
     name?: string;

package/dist/index.js

@@ -28,6 +28,7 @@ var STATE_SNAP_MSG = "__state:snap";
 var OBJECT_SNAP_MSG = "__object:snap";
 var MP_PROTOCOL = 2;
 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");

package/package.json

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