@genex-ai/embed-sdk 0.4.0 → 0.5.0

package/dist/{chunk-6E5DPEVG.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);
@@ -138,6 +143,7 @@ async function ensurePlayer() {
   if (state === "pending") await waitForPlayer();
   if (state === "blocked") throw new Error("genex embed auth: blocked");
 }
+var lastWorldVersion;
 function stateFetch(path, init = {}) {
   const headers = { Authorization: `Bearer ${embedToken}` };
   if (init.body !== void 0) headers["Content-Type"] = "application/json";
@@ -192,18 +198,22 @@ async function loadWorldState() {
   const res = await stateFetch("/state");
   if (!res.ok) throw new Error(`genex load world state failed (${res.status})`);
   const body = await res.json();
+  lastWorldVersion = body.version;
   return { data: body.data, version: body.version };
 }
 async function saveWorldState(data, opts) {
   await ensurePlayer();
   if (state === "guest") return { saved: false, guest: true };
-  return decodeSave(
+  const guard = opts && "ifVersion" in opts ? opts.ifVersion : lastWorldVersion;
+  const result = await decodeSave(
     await stateFetch("/state", {
       method: "PUT",
       body: JSON.stringify(data),
-      ifVersion: opts?.ifVersion
+      ifVersion: guard == null ? void 0 : guard
     })
   );
+  if (result.version !== void 0) lastWorldVersion = result.version;
+  return result;
 }
 async function submitScore(score, opts) {
   const board = opts?.board ?? "main";
@@ -229,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();
@@ -378,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();
@@ -403,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 {
@@ -443,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 {
@@ -489,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()) {
@@ -678,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;
 /**
@@ -171,13 +174,16 @@ declare function loadWorldState(): Promise<WorldStateResult>;
 /**
  * Save the game's SHARED world slot (any JSON ≤ 1MB, any signed-in player may
  * write — let ONE authority do it, e.g. the multiplayer host, and debounce).
- * Strongly prefer { ifVersion } here: the slot is shared, so unconditional
- * writes silently lose races. Guests: { saved: false, guest: true } — world
- * saves are NEVER queued (flushing a stale world later would clobber the live
- * one; the eventual account host keeps saving instead).
+ * If-Match is sent BY DEFAULT (from the last version this SDK loaded/saved), so a
+ * shared write can't silently clobber a newer one — a lost race resolves
+ * { conflict: true, version }: reload, merge, retry. Pass { ifVersion: n } to
+ * guard against a specific version, or { ifVersion: null } to force an
+ * unconditional overwrite (the old last-write-wins behaviour). Guests:
+ * { saved: false, guest: true } — world saves are NEVER queued (flushing a stale
+ * world later would clobber the live one; the eventual account host keeps saving).
  */
 declare function saveWorldState(data: unknown, opts?: {
-    ifVersion?: number;
+    ifVersion?: number | null;
 }): Promise<SaveStateResult>;
 /**
  * Submit a score (soft-trust leaderboards: identity is verified server-side,

package/dist/index.js

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

package/dist/sentry.js

@@ -2,7 +2,7 @@ import {
   _stashTicketFromUrl,
   getUser,
   on
-} from "./chunk-6E5DPEVG.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.0",
+  "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",