@genex-ai/multiplayer 0.4.0 → 0.4.1

package/README.md

@@ -181,13 +181,18 @@ onKey('right', () => { me.x += 1; });
 
 ## Persistent worlds (optional)
 
-The relay is in-memory — room state is gone when everyone leaves or the server restarts. To persist world state across restarts, save/load a JSON blob via the API (keyed by the project slug):
+The relay is in-memory — room state is gone when everyone leaves or the server restarts. To persist world state across restarts, use `@genex-ai/embed-sdk`'s state helpers (they own auth tokens, guest handling, and write-conflict decoding):
 
 ```ts
+import { loadWorldState, saveWorldState } from '@genex-ai/embed-sdk';
+
 // load on boot
-const { data } = await fetch(`${API}/api/projects/${slug}/state`).then(r => r.json());
+const { data, version } = await loadWorldState();
 initWorld(data ?? defaultWorld());
 
-// save whenever (from ONE authority — e.g. a host client — to avoid races)
-fetch(`${API}/api/projects/${slug}/state`, { method: 'PUT', body: JSON.stringify(world) });
+// save (from ONE authority — the elected host — debounced, with ifVersion so
+// races surface as { conflict: true } instead of silently clobbering)
+if (room.isHost) await saveWorldState(world, { ifVersion: version });
 ```
+
+The relay prefers signed-in players when electing the host (guests cannot write saves), so host-driven persistence works whenever any account is in the room. Per-player progression belongs in `savePlayerState()` (each player's own slot), never in the shared world blob.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@genex-ai/multiplayer",
-  "version": "0.4.0",
+  "version": "0.4.1",
   "description": "The multiplayer client wrapper + shared room schema for genex.",
   "type": "module",
   "main": "./dist/index.js",
@@ -20,6 +20,12 @@
   "files": [
     "dist"
   ],
+  "scripts": {
+    "build": "tsup",
+    "typecheck": "tsc --noEmit",
+    "check": "pnpm build && publint && attw --pack . --profile esm-only",
+    "prepack": "pnpm build && publint"
+  },
   "publishConfig": {
     "access": "public"
   },
@@ -45,10 +51,5 @@
     "url": "git+https://github.com/me-ai-org/genex-demo.git",
     "directory": "packages/multiplayer"
   },
-  "license": "MIT",
-  "scripts": {
-    "build": "tsup",
-    "typecheck": "tsc --noEmit",
-    "check": "pnpm build && publint && attw --pack . --profile esm-only"
-  }
-}
+  "license": "MIT"
+}