@genex-ai/embed-sdk 0.4.0 → 0.4.1

package/dist/{chunk-6E5DPEVG.js → chunk-LWEYUUBS.js}

@@ -138,6 +138,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 +193,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";

package/dist/index.d.ts

@@ -171,13 +171,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-LWEYUUBS.js";
 export {
   __resetForTests,
   _stashTicketFromUrl,

package/dist/sentry.js

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