@genex-ai/embed-sdk 0.4.1 → 0.5.0

package/dist/{chunk-LWEYUUBS.js → chunk-GDJLPL6W.js}

@@ -5,6 +5,7 @@ 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 parentOrigin = null;
@@ -77,6 +78,10 @@ function initEmbed(cfg) {
     dashboardOrigins: [...cfg.dashboardOrigins]
   };
   state = "pending";
+  if (wantsLocalTest(w)) {
+    enterLocalTestMode(w);
+    return;
+  }
   showOverlay("connecting");
   if (isEmbedded()) {
     startEmbeddedHandshake(w);
@@ -234,6 +239,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 +389,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 +414,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 {
@@ -448,7 +454,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 {
@@ -494,6 +500,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,6 +722,7 @@ function __resetForTests(overrides) {
   config = null;
   state = "pending";
   user = null;
+  localTestMode = false;
   embedToken = void 0;
   colyseusUrl = void 0;
   parentOrigin = null;

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;
 /**

package/dist/index.js

@@ -16,7 +16,7 @@ import {
   submitScore,
   waitForAuth,
   waitForPlayer
-} from "./chunk-LWEYUUBS.js";
+} from "./chunk-GDJLPL6W.js";
 export {
   __resetForTests,
   _stashTicketFromUrl,

package/dist/sentry.js

@@ -2,7 +2,7 @@ import {
   _stashTicketFromUrl,
   getUser,
   on
-} from "./chunk-LWEYUUBS.js";
+} from "./chunk-GDJLPL6W.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.5.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",