@genex-ai/multiplayer 0.9.0 → 0.10.0

package/README.md

@@ -13,13 +13,13 @@ import { connect } from '@genex-ai/multiplayer';
 ## Connect
 
 ```ts
-import { waitForPlayer, getColyseusAuth } from '@genex-ai/embed-sdk';
+import { waitForPlayer, getColyseusAuth, getColyseusUrls } from '@genex-ai/embed-sdk';
 
 type State = { x: number; y: number; z: number };   // YOUR per-player state — any JSON shape
 
 await waitForPlayer();                        // identity gate — resolves for guests AND accounts
 const room = await connect<State>({
-  url:  'wss://demo-colyseus.glotech.world',  // the genex multiplayer server
+  urls: getColyseusUrls(),          // regional relays for this session — SDK joins the fastest
   room: '<game-id>',                          // everyone with the same id shares a room (use the project slug)
   name: 'ada',                                // optional display name
   auth: getColyseusAuth()!,                   // REQUIRED — the relay rejects tokenless joins
@@ -246,12 +246,12 @@ bounded extrapolation.
 
 ```ts
 import { connect } from '@genex-ai/multiplayer';
-import { waitForPlayer, getColyseusAuth } from '@genex-ai/embed-sdk';
+import { waitForPlayer, getColyseusAuth, getColyseusUrls } from '@genex-ai/embed-sdk';
 type S = { x: number; z: number };
 
 await waitForPlayer();   // identity gate (guest OR signed-in) — see Connect above
 const room = await connect<S>({
-  url: 'wss://demo-colyseus.glotech.world',
+  urls: getColyseusUrls(),
   room: GAME_ID,
   auth: getColyseusAuth()!,   // REQUIRED — tokenless joins are rejected
 });
@@ -289,7 +289,7 @@ import { matchmake } from "@genex-ai/multiplayer";
 
 // Pass `auth` as a FUNCTION — a handle re-joins many times (re-search/requeue) and tokens rotate
 // (~10 min); a function is read fresh each join, a static object goes stale mid-session.
-const mm = await matchmake<State>({ url, room: slug, auth: () => getColyseusAuth() });
+const mm = await matchmake<State>({ urls, room: slug, auth: () => getColyseusAuth() });
 
 // `session` is null WHILE SEARCHING — render your own "finding a match…" HUD until it goes live.
 // each frame:
@@ -344,11 +344,11 @@ For `preset: 'private'` games, skip the queue: a host mints an invite **code**,
 import { createPrivate, joinPrivate } from "@genex-ai/multiplayer";
 
 // host
-const lobby = await createPrivate<State>({ url, room: slug, auth: () => getColyseusAuth() });
+const lobby = await createPrivate<State>({ urls, room: slug, auth: () => getColyseusAuth() });
 share(lobby.code);                 // e.g. show it in the UI
 
 // friend (elsewhere)
-const joined = await joinPrivate<State>(code, { url, room: slug, auth: () => getColyseusAuth() });
+const joined = await joinPrivate<State>(code, { urls, room: slug, auth: () => getColyseusAuth() });
 
 // then identical to matchmake(): .session, .matchmaking, eliminated()/score()/finish(), cancel()
 ```

package/dist/index.d.ts

@@ -2,8 +2,9 @@ export { PlayerState, RoomState } from './schema.js';
 import '@colyseus/schema';
 
 type ConnectOptions = {
-    /** Colyseus server url, e.g. "ws://localhost:2567". */
-    url: string;
+    /** Regional relay urls (pass `getColyseusUrls()`) — the SDK pings each and connects to the
+     *  lowest-latency one; a single entry just connects. */
+    urls: 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;
@@ -264,8 +265,8 @@ type Matchmaking<TState extends Record<string, unknown>> = {
     cancel(): void;
 };
 type MatchmakeOptions = {
-    /** Colyseus server url. */
-    url: string;
+    /** Regional relay urls (pass `getColyseusUrls()`) — pings each, connects to the lowest-latency one. */
+    urls: string[];
     /** Game id (your project slug/id) — isolates this game's matchmaking. */
     room: string;
     name?: string;

package/dist/index.js

@@ -1,5 +1,5 @@
 // src/index.ts
-import { Client, getStateCallbacks } from "colyseus.js";
+import { Client, getStateCallbacks } from "@colyseus/sdk";
 var RELAY_ROOM_TYPE = "play";
 var QUEUE_ROOM_TYPE = "queue";
 var MATCH_ROOM_TYPE = "match";
@@ -27,6 +27,12 @@ var OBJECT_CONTROL_VERSION = 2;
 var STATE_SNAP_MSG = "__state:snap";
 var OBJECT_SNAP_MSG = "__object:snap";
 var MP_PROTOCOL = 2;
+async function relayClient(opts) {
+  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);
+}
 function parseData(s) {
   if (!s) return { state: {} };
   try {
@@ -151,7 +157,7 @@ function quantile(xs, q) {
   return s[i];
 }
 async function connect(opts) {
-  const client = new Client(opts.url);
+  const client = await relayClient(opts);
   const room = await client.joinOrCreate(RELAY_ROOM_TYPE, {
     gameId: opts.room,
     name: opts.name,
@@ -947,7 +953,7 @@ function buildView(matchRoom, queueInfo) {
   };
 }
 async function matchmake(opts) {
-  const client = new Client(opts.url);
+  const client = await relayClient(opts);
   const emitters = /* @__PURE__ */ new Map();
   const emit = (event, ...args) => emitters.get(event)?.forEach((cb) => cb(...args));
   const on = ((event, cb) => {
@@ -1128,14 +1134,14 @@ function wirePrivate(client, room) {
   };
 }
 async function createPrivate(opts) {
-  const client = new Client(opts.url);
+  const client = await relayClient(opts);
   const room = await client.create(MATCH_ROOM_TYPE, matchJoinOptions(opts));
   const handle = wirePrivate(client, room);
   Object.defineProperty(handle, "code", { value: room.roomId, enumerable: true });
   return handle;
 }
 async function joinPrivate(code, opts) {
-  const client = new Client(opts.url);
+  const client = await relayClient(opts);
   const room = await client.joinById(code, matchJoinOptions(opts));
   return wirePrivate(client, room);
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@genex-ai/multiplayer",
-  "version": "0.9.0",
+  "version": "0.10.0",
   "description": "The multiplayer client wrapper + shared room schema for genex.",
   "type": "module",
   "main": "./dist/index.js",
@@ -30,8 +30,8 @@
     "access": "public"
   },
   "dependencies": {
-    "@colyseus/schema": "^3.0.76",
-    "colyseus.js": "^0.16.22"
+    "@colyseus/schema": "^4.0.27",
+    "@colyseus/sdk": "^0.17.43"
   },
   "peerDependencies": {
     "three": ">=0.160.0"