@genex-ai/multiplayer 0.17.9 → 0.17.10

package/dist/bridge-authority.js

@@ -9,10 +9,10 @@ import {
 } from "./chunk-4R7C2TLH.js";
 import {
   connectAuthority
-} from "./chunk-MQYARUGU.js";
-import "./chunk-TEHGMFAG.js";
+} from "./chunk-SQC6WTMF.js";
+import "./chunk-42R7NREA.js";
 import "./chunk-YWQ3ALYY.js";
-import "./chunk-ZDGSUR6E.js";
+import "./chunk-HHETHPGL.js";
 import "./chunk-OD6NRSX2.js";
 import {
   firstpersonWorld
@@ -22,7 +22,7 @@ import {
   CloseCode,
   ServerMessage,
   isReservedEventType
-} from "./chunk-WEMRRIHH.js";
+} from "./chunk-7J3YWPCA.js";
 
 // src/bridge-authority.ts
 import { getAuthorityRegions, getAuthorityUrls, getColyseusAuth } from "@genex-ai/embed-sdk";

package/dist/bridge.js

@@ -15,14 +15,14 @@ import {
   joinPrivate,
   matchmake,
   roomOf
-} from "./chunk-DJ2XYETS.js";
-import "./chunk-TEHGMFAG.js";
+} from "./chunk-NSQQCLMA.js";
+import "./chunk-42R7NREA.js";
 import {
   Limits,
   RESERVED_SHARED_PREFIX,
   ServerMessage,
   isReservedEventType
-} from "./chunk-WEMRRIHH.js";
+} from "./chunk-7J3YWPCA.js";
 
 // src/bridge.ts
 var version = 2;

package/dist/{chunk-TEHGMFAG.js → chunk-42R7NREA.js}

@@ -2,7 +2,7 @@ import {
   ClientReconnection,
   JoinError,
   PROTOCOL_VERSION
-} from "./chunk-WEMRRIHH.js";
+} from "./chunk-7J3YWPCA.js";
 
 // src/join.ts
 import { Client as Client2 } from "@colyseus/sdk";

package/dist/{chunk-WEMRRIHH.js → chunk-7J3YWPCA.js}

@@ -55,7 +55,7 @@ var AuthorityJoinOption = {
    *  refused with 400. */
   SUCCESSOR_CLOSED: "successorClosed"
 };
-var AUTHORITY_SDK_LABEL = "ts/0.17.9";
+var AUTHORITY_SDK_LABEL = "ts/0.17.10";
 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

package/dist/{chunk-ZDGSUR6E.js → chunk-HHETHPGL.js}

@@ -19,7 +19,7 @@ import {
   JoinError,
   Limits,
   isReservedEventType
-} from "./chunk-WEMRRIHH.js";
+} from "./chunk-7J3YWPCA.js";
 
 // src/authority/room-key.ts
 var AuthorityRoomLimits = {
@@ -55,7 +55,7 @@ function matchKeyOf(value2) {
   if (value2 === void 0 || value2 === "") return "";
   return validMatchKey(value2) ? value2 : null;
 }
-var AuthorityJoinMethod = { JoinOrCreate: "joinOrCreate", Create: "create", JoinById: "joinById" };
+var AuthorityJoinMethod = { JoinOrCreate: "joinOrCreate", Create: "create", JoinById: "joinById", Join: "join" };
 var AuthorityTargetRefusal = { BadMatchKey: "bad_match_key", BadCode: "bad_code", Conflict: "conflict" };
 function planAuthorityJoin(target) {
   const key = target.matchKey ?? "";

package/dist/{chunk-DJ2XYETS.js → chunk-NSQQCLMA.js}

@@ -8,7 +8,7 @@ import {
   waitForFirstState,
   warnProtocolRefusal,
   withoutReconnection
-} from "./chunk-TEHGMFAG.js";
+} from "./chunk-42R7NREA.js";
 import {
   ClientMessage,
   ClientReconnection,
@@ -23,7 +23,7 @@ import {
   SEND_TIME_KEY,
   ServerMessage,
   isReservedEventType
-} from "./chunk-WEMRRIHH.js";
+} from "./chunk-7J3YWPCA.js";
 
 // src/index.ts
 import { getStateCallbacks } from "@colyseus/sdk";

package/dist/{chunk-MQYARUGU.js → chunk-SQC6WTMF.js}

@@ -5,7 +5,7 @@ import {
   joinOptions,
   useSdkReconnection,
   waitForFirstState
-} from "./chunk-TEHGMFAG.js";
+} from "./chunk-42R7NREA.js";
 import {
   udpFastOpener
 } from "./chunk-YWQ3ALYY.js";
@@ -60,7 +60,7 @@ import {
   serverTick,
   tickInstant,
   validRoomCode
-} from "./chunk-ZDGSUR6E.js";
+} from "./chunk-HHETHPGL.js";
 import {
   RemotePredict
 } from "./chunk-OD6NRSX2.js";
@@ -88,10 +88,17 @@ import {
   RoomType,
   ServerMessage,
   authorityCloseCodeOf
-} from "./chunk-WEMRRIHH.js";
+} from "./chunk-7J3YWPCA.js";
 
 // src/authority/regions.ts
 var AUTHORITY_REFUSALS_PER_REGION = 2;
+var AUTHORITY_MAX_PING_MS = 350;
+var RegionRule = {
+  /** A room with players in any region in reach, nearest first; else a new room in the nearest region. */
+  Players: "players",
+  /** The nearest region alone, whoever is elsewhere. */
+  Nearest: "nearest"
+};
 var isUrl = (u) => typeof u === "string" && u.length > 0;
 function normalizeAuthorityRegions(regions, urls) {
   const out = [];
@@ -113,6 +120,9 @@ function regionProbePlan(urls, samples) {
 }
 var answered = (ms) => typeof ms === "number" && Number.isFinite(ms) && ms >= 0;
 function rankAuthorityRegions(regions, best) {
+  return rankWithLatency(regions, best).map((x) => x.pick);
+}
+function rankWithLatency(regions, best) {
   const heard = [];
   const silent = [];
   regions.forEach((r, index) => {
@@ -127,7 +137,17 @@ function rankAuthorityRegions(regions, best) {
     (ms === null ? silent : heard).push({ index, ms, pick: { region: r.region, url } });
   });
   heard.sort((a, b) => a.ms - b.ms || a.index - b.index);
-  return [...heard, ...silent].map((x) => x.pick);
+  return [...heard, ...silent];
+}
+function planAuthoritySearch(regions, best, options = {}) {
+  const ranked = rankWithLatency(regions, best);
+  const create = ranked.map((x) => x.pick);
+  const pinned = typeof options.region === "string" ? ranked.find((x) => x.pick.region === options.region) : void 0;
+  if (pinned !== void 0) return { search: [], create: [pinned.pick] };
+  if (options.rule === RegionRule.Nearest) return { search: [], create };
+  const limit = answered(options.maxPingMs) ? options.maxPingMs : AUTHORITY_MAX_PING_MS;
+  const reach = ranked.filter((x) => x.ms !== null && x.ms <= limit).map((x) => x.pick);
+  return { search: reach.length >= 2 ? reach : [], create };
 }
 function capacityWalk(regionCount, delays) {
   const attempts = [{ region: 0, waitMs: 0 }];
@@ -151,6 +171,16 @@ function refusalKind(code) {
   if (typeof code !== "number" || code <= 0 || DEAD_PATH_REFUSALS.has(code)) return RefusalKind.NextRegion;
   return CAPACITY_REFUSALS.has(code) ? RefusalKind.Capacity : RefusalKind.Final;
 }
+var SearchRefusal = {
+  /** No room here (Colyseus's 521, no room matches the criteria), a dead path, a full or draining
+   *  region: the next region is asked. */
+  Next: "next",
+  /** The server's answer about this player or game, which every region would repeat. */
+  Final: "final"
+};
+function searchRefusalKind(code) {
+  return refusalKind(code) === RefusalKind.Final ? SearchRefusal.Final : SearchRefusal.Next;
+}
 function nextAttempt(state, regionCount, delays) {
   const refused = state.refused + 1;
   if (refused >= AUTHORITY_REFUSALS_PER_REGION && state.region + 1 < regionCount) {
@@ -164,10 +194,13 @@ function nextAttempt(state, regionCount, delays) {
 async function selectAuthorityRegions(regions, options = {}) {
   if (regions.length === 0) return [];
   if (regions.length === 1) return rankAuthorityRegions(regions, []);
+  return rankAuthorityRegions(regions, await probeBest(regions, options));
+}
+async function probeBest(regions, options) {
   const samples = Math.max(1, options.samples ?? RELAY_SELECT_DEFAULTS.SAMPLES);
   const plans = regions.map((r) => regionProbePlan(r.urls, samples));
   const results = await probeLatencies(plans, options);
-  const best = regions.map(
+  return regions.map(
     (r, i) => r.urls.map((url) => {
       let min;
       plans[i]?.forEach((planned, n) => {
@@ -177,7 +210,10 @@ async function selectAuthorityRegions(regions, options = {}) {
       return min;
     })
   );
-  return rankAuthorityRegions(regions, best);
+}
+async function selectAuthoritySearch(regions, search = {}, options = {}) {
+  if (regions.length <= 1) return planAuthoritySearch(regions, [], search);
+  return planAuthoritySearch(regions, await probeBest(regions, options), search);
 }
 async function probeLatencies(plans, options = {}) {
   const probe = options.probe ?? defaultProbe;
@@ -5288,17 +5324,38 @@ function resimBudgetMs() {
   const agent = typeof navigator === "undefined" ? "" : String(navigator.userAgent ?? "");
   return /Mobi|Android|iPhone|iPad/i.test(agent) ? PHYS_RESIM_BUDGET_MS.mobile : PHYS_RESIM_BUDGET_MS.desktop;
 }
-async function joinTargets(opts) {
-  if (opts.url) return [opts.url];
+async function joinTargets(opts, method) {
+  if (opts.url) return { search: [], create: [opts.url] };
   const regions = normalizeAuthorityRegions(opts.regions, opts.urls);
   if (regions.length === 0) throw new Error("genex multiplayer: `urls` must contain at least one authority server URL");
-  const ranked = await selectAuthorityRegions(regions, opts.probe === void 0 ? {} : { probe: opts.probe });
-  return ranked.map((pick) => pick.url);
+  const pool = method === AuthorityJoinMethod.JoinOrCreate;
+  const plan = await selectAuthoritySearch(
+    regions,
+    {
+      rule: pool ? opts.regionRule : RegionRule.Nearest,
+      maxPingMs: opts.maxPingMs,
+      ...method === AuthorityJoinMethod.JoinById ? {} : { region: opts.region }
+    },
+    opts.probe === void 0 ? {} : { probe: opts.probe }
+  );
+  return { search: plan.search.map((pick) => pick.url), create: plan.create.map((pick) => pick.url) };
+}
+async function joinWherePlayersAre(opts, plan, search, targets) {
+  for (const url of search) {
+    try {
+      return { room: await joinOnce(new Client(url), opts, { ...plan, method: AuthorityJoinMethod.Join }), url, targets };
+    } catch (err) {
+      if (searchRefusalKind(errorCode(err)) === SearchRefusal.Final) explainAuthorityRefusal(err);
+    }
+  }
+  return null;
 }
 async function joinAuthority(opts, target) {
   const plan = planAuthorityJoin(target);
   if ("refused" in plan) throw new TypeError(`genex multiplayer: this room cannot be asked for (${plan.refused})`);
-  const targets = await joinTargets(opts);
+  const { search, create: targets } = await joinTargets(opts, plan.method);
+  const found = await joinWherePlayersAre(opts, plan, search, targets);
+  if (found !== null) return found;
   const delays = opts.capacityRetryMs ?? CAPACITY_RETRY_MS;
   let state = { region: 0, refused: 0, step: 0 };
   for (; ; ) {
@@ -5341,6 +5398,7 @@ function joinOnce(client, opts, plan) {
   };
   if (plan.method === AuthorityJoinMethod.JoinById) return client.joinById(plan.roomId, options);
   if (plan.method === AuthorityJoinMethod.Create) return client.create(RoomType.AUTHORITY, options);
+  if (plan.method === AuthorityJoinMethod.Join) return client.join(RoomType.AUTHORITY, options);
   return client.joinOrCreate(RoomType.AUTHORITY, options);
 }
 function roomPreset(presetText) {
@@ -6729,13 +6787,19 @@ function attachAuthoritySession(room, opts, url) {
 
 export {
   AUTHORITY_REFUSALS_PER_REGION,
+  AUTHORITY_MAX_PING_MS,
+  RegionRule,
   normalizeAuthorityRegions,
   regionProbePlan,
   rankAuthorityRegions,
+  planAuthoritySearch,
   capacityWalk,
   RefusalKind,
   refusalKind,
+  SearchRefusal,
+  searchRefusalKind,
   selectAuthorityRegions,
+  selectAuthoritySearch,
   REJOIN,
   SUCCESSOR_OPEN_MS,
   RejoinWay,

package/dist/index.js

@@ -3,9 +3,9 @@ import {
   createPrivate,
   joinPrivate,
   matchmake
-} from "./chunk-DJ2XYETS.js";
-import "./chunk-TEHGMFAG.js";
-import "./chunk-WEMRRIHH.js";
+} from "./chunk-NSQQCLMA.js";
+import "./chunk-42R7NREA.js";
+import "./chunk-7J3YWPCA.js";
 export {
   connect,
   createPrivate,

package/dist/protocol.d.ts

@@ -76,7 +76,7 @@ interface AuthorityDrainNotice {
     drainMs: number;
 }
 /** The SDK label this TypeScript client sends. tests hold it to package.json. */
-declare const AUTHORITY_SDK_LABEL = "ts/0.17.9";
+declare const AUTHORITY_SDK_LABEL = "ts/0.17.10";
 /** Client capabilities (§17.10 *Joining*). */
 declare const AuthorityCaps: {
     /** Decodes and draws §17.10's physics bodies. A physics room refuses a join without it (426). An

package/dist/protocol.js

@@ -50,7 +50,7 @@ import {
   isReservedEventType,
   roomKeyFor,
   slugOfRoomKey
-} from "./chunk-WEMRRIHH.js";
+} from "./chunk-7J3YWPCA.js";
 export {
   AUTHORITY_ENCODER_BUFFER_BYTES,
   AUTHORITY_MAX_FRAME_BYTES,

package/package.json

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