@genex-ai/embed-sdk 0.22.3 → 0.23.0

package/dist/{chunk-IFI2NYBC.js → chunk-CBR3BK66.js}

@@ -298,7 +298,7 @@ var RETRY_FLAG = "genex:embed:retry";
 var POPOVER_DISMISSED_FLAG = "genex:guest:popover-dismissed";
 var LOCAL_AUTH_FLAG = "genex:embed:local-auth";
 var PLAYER_ID_KEY = "genex:player";
-var SDK_VERSION = "0.22.3";
+var SDK_VERSION = "0.23.0";
 var config2 = null;
 var state = "pending";
 var user = null;
@@ -548,12 +548,18 @@ function stateFetch(path, init = {}) {
     keepalive: init.body !== void 0 && init.body.length <= KEEPALIVE_MAX_BYTES ? true : void 0
   });
 }
+async function refusedAsStaging(res) {
+  if (res.status !== 403) return false;
+  const body = await res.json().catch(() => null);
+  return body?.error === "staging_no_save";
+}
 async function decodeSave(res) {
   if (res.status === 409) {
     const body2 = await res.json().catch(() => ({}));
     return { saved: false, conflict: true, version: body2.version };
   }
   if (!res.ok) {
+    if (await refusedAsStaging(res)) return { saved: false, staging: true };
     emit("error", { error: new Error(`genex state save failed (${res.status})`) });
     return { saved: false };
   }
@@ -566,7 +572,10 @@ async function loadPlayerState() {
     return { data: hasPendingPlayerSave ? pendingPlayerSave : null, version: 0, guest: true };
   }
   const res = await stateFetch("/state/me");
-  if (!res.ok) throw new Error(`genex load player state failed (${res.status})`);
+  if (!res.ok) {
+    if (await refusedAsStaging(res)) return { data: null, version: 0, staging: true };
+    throw new Error(`genex load player state failed (${res.status})`);
+  }
   const body = await res.json();
   return { data: body.data, version: body.version };
 }
@@ -589,7 +598,10 @@ async function loadWorldState() {
   await ensurePlayer();
   if (state === "guest") return { data: null, version: 0, guest: true };
   const res = await stateFetch("/state");
-  if (!res.ok) throw new Error(`genex load world state failed (${res.status})`);
+  if (!res.ok) {
+    if (await refusedAsStaging(res)) return { data: null, version: 0, staging: true };
+    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 };

package/dist/index.d.ts

@@ -222,11 +222,20 @@ interface PlayerStateResult {
     version: number;
     /** True when the current identity is a guest (server storage untouched). */
     guest?: boolean;
+    /**
+     * True when the build is running on the PREVIEW channel — the owner's draft
+     * workspace, any `preview--<slug>` URL. Server saves are off there by design,
+     * so nothing was read: keep progress in localStorage and say "preview build",
+     * never "offline".
+     */
+    staging?: boolean;
 }
 interface WorldStateResult {
     data: unknown;
     version: number;
     guest?: boolean;
+    /** True on the preview channel — see PlayerStateResult.staging. */
+    staging?: boolean;
 }
 interface SaveStateResult {
     /** True when the write landed on the server. */
@@ -239,6 +248,13 @@ interface SaveStateResult {
     guest?: boolean;
     /** True when the value was queued to auto-flush if this guest signs in mid-game. */
     queued?: boolean;
+    /**
+     * True when the build is running on the PREVIEW channel (the owner's draft
+     * workspace, `preview--<slug>`): the server refused the write by policy, not
+     * by failure — nothing is queued, no `error` event fires. Keep the value in
+     * localStorage and tell the player it is a preview build.
+     */
+    staging?: boolean;
 }
 interface SubmitScoreResult {
     submitted: boolean;
@@ -355,14 +371,19 @@ declare function on(event: EmbedEvent, cb: (ctx?: EventContext) => void): () =>
  * Load THIS player's own save slot (per-player, per-game — another player can
  * never read or clobber it). Resolves { data: null, version: 0 } when they
  * never saved. Guests get their queued pending save (if any) so a round-trip
- * works mid-session; the server is untouched. Await-safe from boot: resolves
- * after identity exists, rejects only when the session is blocked.
+ * works mid-session; the server is untouched. On the preview channel (the
+ * owner's draft workspace) resolves { data: null, version: 0, staging: true }
+ * — server saves are off there by design, and that is not an error. Await-safe
+ * from boot: resolves after identity exists, rejects only when the session is
+ * blocked.
  */
 declare function loadPlayerState(): Promise<PlayerStateResult>;
 /**
  * Save THIS player's own slot (any JSON ≤ 256KB; last-write-wins on their own
  * row). Guests: the value is QUEUED in memory and auto-flushed if they sign in
  * mid-game ({ saved: false, guest: true, queued: true }) — no extra game code.
+ * On the preview channel: { saved: false, staging: true }, nothing queued
+ * (nothing would ever flush it) and no `error` event — keep it in localStorage.
  * Pass { ifVersion } (from the last load/save) to detect same-account
  * two-device races: a losing write resolves { conflict: true, version } —
  * reload, merge, retry. Small saves survive tab close (fetch keepalive).
@@ -374,7 +395,8 @@ declare function savePlayerState(data: unknown, opts?: {
  * Load the game's SHARED world slot (one blob per game — every player reads
  * the same world). Guests resolve { data: null, guest: true } — the server
  * refuses guest reads; in multiplayer, guests receive the live world through
- * the room instead.
+ * the room instead. The preview channel resolves { data: null, version: 0,
+ * staging: true } for the same reason the player slot does.
  */
 declare function loadWorldState(): Promise<WorldStateResult>;
 /**

package/dist/index.js

@@ -28,7 +28,7 @@ import {
   waitForAuth,
   waitForGeneration,
   waitForPlayer
-} from "./chunk-IFI2NYBC.js";
+} from "./chunk-CBR3BK66.js";
 import "./chunk-Q476GJHI.js";
 export {
   __resetForTests,

package/dist/sentry.js

@@ -2,7 +2,7 @@ import {
   _stashTicketFromUrl,
   getUser,
   on
-} from "./chunk-IFI2NYBC.js";
+} from "./chunk-CBR3BK66.js";
 import "./chunk-Q476GJHI.js";
 
 // src/sentry.ts

package/package.json

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