@genex-ai/embed-sdk 0.4.1 → 0.6.0

package/dist/{chunk-LWEYUUBS.js → chunk-5VYRFOFN.js}

@@ -5,8 +5,9 @@ var POPOVER_DISMISSED_FLAG = "genex:guest:popover-dismissed";
 var config = null;
 var state = "pending";
 var user = null;
+var localTestMode = false;
 var embedToken;
-var colyseusUrl;
+var colyseusUrls;
 var parentOrigin = null;
 var initialized = false;
 var redeeming = false;
@@ -77,6 +78,10 @@ function initEmbed(cfg) {
     dashboardOrigins: [...cfg.dashboardOrigins]
   };
   state = "pending";
+  if (wantsLocalTest(w)) {
+    enterLocalTestMode(w);
+    return;
+  }
   showOverlay("connecting");
   if (isEmbedded()) {
     startEmbeddedHandshake(w);
@@ -105,6 +110,9 @@ function getEmbedToken() {
 function getColyseusAuth() {
   return embedToken ? { embedToken } : void 0;
 }
+function getColyseusUrls() {
+  return colyseusUrls ?? [];
+}
 function waitForAuth() {
   if (state === "authenticated" && user) return Promise.resolve({ user });
   if (state === "blocked") return Promise.reject(new Error("genex embed auth: blocked"));
@@ -234,6 +242,7 @@ async function submitScore(score, opts) {
 }
 async function getLeaderboard(opts) {
   if (!config) throw new Error("genex embed: call initEmbed() first");
+  if (localTestMode) return { items: [], me: null };
   if (state === "pending") {
     try {
       await waitForPlayer();
@@ -383,7 +392,7 @@ function readFragment(w) {
   return { ticket, guest };
 }
 async function redirectToAuthorize(w, opts) {
-  if (!config) return;
+  if (!config || localTestMode) return;
   const origin = opts?.guestOk ? config.dashboardOrigins[0] ?? (await fetchDashboardOrigins())[0] : (await fetchDashboardOrigins())[0] ?? config.dashboardOrigins[0];
   if (!origin) {
     enterBlocked();
@@ -408,7 +417,7 @@ async function fetchDashboardOrigins() {
   return config.dashboardOrigins;
 }
 async function redeemTicket(ticket) {
-  if (!config || redeeming || state !== "pending" && state !== "guest") return;
+  if (!config || localTestMode || redeeming || state !== "pending" && state !== "guest") return;
   const upgradingFromGuest = state === "guest";
   redeeming = true;
   try {
@@ -425,8 +434,7 @@ async function redeemTicket(ticket) {
     const body = await res.json();
     embedToken = body.embedToken;
     user = body.user;
-    colyseusUrl = body.colyseus?.url;
-    void colyseusUrl;
+    colyseusUrls = body.colyseus?.urls;
     state = "authenticated";
     clearRetryFlag();
     removeOverlay();
@@ -448,7 +456,7 @@ async function redeemTicket(ticket) {
   }
 }
 async function requestGuestSession() {
-  if (!config || requestingGuest || redeeming) return;
+  if (!config || localTestMode || requestingGuest || redeeming) return;
   if (state !== "pending" && state !== "guest") return;
   requestingGuest = true;
   try {
@@ -465,7 +473,7 @@ async function requestGuestSession() {
     const body = await res.json();
     embedToken = body.embedToken;
     user = body.user;
-    colyseusUrl = body.colyseus?.url;
+    colyseusUrls = body.colyseus?.urls;
     enterGuest();
   } catch (error) {
     emit("error", { error });
@@ -494,6 +502,39 @@ function enterGuest() {
     emit("guest", ctx);
   }
 }
+function isLoopbackLocation(w) {
+  try {
+    const u = new URL(w.location.origin);
+    return u.protocol === "http:" && (u.hostname === "localhost" || u.hostname === "127.0.0.1" || u.hostname === "[::1]");
+  } catch {
+    return false;
+  }
+}
+function wantsLocalTest(w) {
+  if (isEmbedded()) return false;
+  if (!isLoopbackLocation(w)) return false;
+  try {
+    return new URLSearchParams(w.location.search).get("genex_local_test") === "1";
+  } catch {
+    return false;
+  }
+}
+function enterLocalTestMode(w) {
+  localTestMode = true;
+  readFragment(w);
+  const localUser = { id: "local:test", name: "Local Tester" };
+  user = localUser;
+  state = "guest";
+  removeOverlay();
+  try {
+    console.info(
+      "[genex] local test mode \u2014 local visuals and controls only. Auth, saves, leaderboards, and multiplayer are NOT validated here; no Genex credential exists."
+    );
+  } catch {
+  }
+  for (const waiter of playerWaiters.splice(0)) waiter.resolve({ user: localUser, guest: true });
+  emit("guest", { user: localUser });
+}
 async function handleRedeemFailure() {
   const w = win();
   if (w && !isEmbedded() && !readRetryFlag()) {
@@ -683,8 +724,9 @@ function __resetForTests(overrides) {
   config = null;
   state = "pending";
   user = null;
+  localTestMode = false;
   embedToken = void 0;
-  colyseusUrl = void 0;
+  colyseusUrls = void 0;
   parentOrigin = null;
   initialized = false;
   redeeming = false;
@@ -708,6 +750,7 @@ export {
   getUser,
   getEmbedToken,
   getColyseusAuth,
+  getColyseusUrls,
   waitForAuth,
   waitForPlayer,
   on,

package/dist/index.d.ts

@@ -98,6 +98,9 @@ declare function getAuthState(): AuthState;
 /**
  * The current player — non-null once 'authenticated' OR 'guest'. Guests have
  * an `id` prefixed `guest:` and a server-assigned name like "Guest-1234".
+ * Local test mode is the one guest-state exception: `id` is `local:test`
+ * (a prefix that can never collide with `guest:` or account ids) and the
+ * name is "Local Tester".
  */
 declare function getUser(): EmbedUser | null;
 /**
@@ -121,6 +124,9 @@ declare function getEmbedToken(): string | undefined;
 declare function getColyseusAuth(): {
     embedToken: string;
 } | undefined;
+/** The relay URLs for this session (server-owned; a regional list when configured). Pass to
+ *  connect()/matchmake() as `urls` so the SDK joins the lowest-latency one; single-url fallback. */
+declare function getColyseusUrls(): string[];
 /**
  * Resolves with the signed-in ACCOUNT once authenticated; rejects if the
  * session ends up blocked. THE gate for /state saves and any account-bound
@@ -217,4 +223,4 @@ declare function __resetForTests(overrides?: {
     refreshRetryMs?: number;
 }): void;
 
-export { type AuthState, type EmbedConfig, type EmbedEvent, type EmbedUser, type Leaderboard, type LeaderboardEntry, type PlayerStateResult, type SaveStateResult, type SubmitScoreResult, type WorldStateResult, __resetForTests, _stashTicketFromUrl, getAuthState, getColyseusAuth, getEmbedToken, getLeaderboard, getUser, initEmbed, isEmbedded, loadPlayerState, loadWorldState, on, savePlayerState, saveWorldState, submitScore, waitForAuth, waitForPlayer };
+export { type AuthState, type EmbedConfig, type EmbedEvent, type EmbedUser, type Leaderboard, type LeaderboardEntry, type PlayerStateResult, type SaveStateResult, type SubmitScoreResult, type WorldStateResult, __resetForTests, _stashTicketFromUrl, getAuthState, getColyseusAuth, getColyseusUrls, getEmbedToken, getLeaderboard, getUser, initEmbed, isEmbedded, loadPlayerState, loadWorldState, on, savePlayerState, saveWorldState, submitScore, waitForAuth, waitForPlayer };

package/dist/index.js

@@ -3,6 +3,7 @@ import {
   _stashTicketFromUrl,
   getAuthState,
   getColyseusAuth,
+  getColyseusUrls,
   getEmbedToken,
   getLeaderboard,
   getUser,
@@ -16,12 +17,13 @@ import {
   submitScore,
   waitForAuth,
   waitForPlayer
-} from "./chunk-LWEYUUBS.js";
+} from "./chunk-5VYRFOFN.js";
 export {
   __resetForTests,
   _stashTicketFromUrl,
   getAuthState,
   getColyseusAuth,
+  getColyseusUrls,
   getEmbedToken,
   getLeaderboard,
   getUser,

package/dist/sentry.js

@@ -2,7 +2,7 @@ import {
   _stashTicketFromUrl,
   getUser,
   on
-} from "./chunk-LWEYUUBS.js";
+} from "./chunk-5VYRFOFN.js";
 
 // src/sentry.ts
 import * as Sentry from "@sentry/browser";

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@genex-ai/embed-sdk",
-  "version": "0.4.1",
+  "version": "0.6.0",
   "description": "Player identity + durable game state for genex games — signed-in or guest play, per-player save slots, shared world state, and soft-trust leaderboards.",
   "type": "module",
   "main": "./dist/index.js",