@arcadible/sdk 1.1.0 → 1.2.0

package/dist/saves/server.js

@@ -1,8 +1,9 @@
 // Saves, the page's side: it answers a game's saves requests from its
 // backend, enforces the limits, and stamps each save with the game's
-// version. Its first message on each channel is the game's saves.
+// version. Its first message on each channel is the game's saves, and who
+// can read them back.
 // [import]
-import { ArcadibleError, Codes, utf8Size } from "../bus/protocol.js";
+import { ArcadibleError, Codes, log, utf8Size } from "../bus/protocol.js";
 import { checkName, checkWrite, } from "./rules.js";
 // [function]
 function toSave(record) {
@@ -23,6 +24,11 @@ function nameOf(params) {
     return params["name"];
 }
 // [function]
+// what a write or remove is about, so they keep their order (bus/server.ts).
+function saveKey(params) {
+    return String(params["name"]);
+}
+// [function]
 // the device is out of room: retrying won't help until the player frees
 // some. Anything else is the bus's `unavailable`.
 function storageError(err) {
@@ -33,7 +39,7 @@ function storageError(err) {
 }
 // [function]
 export function savesServer(options) {
-    const { backend, now, scope, version } = options;
+    const { backend, now, scope, version, where } = options;
     const source = sourceId();
     // a write, checked against the game's saves in the same step as it's kept.
     const write = async function (params) {
@@ -57,11 +63,18 @@ export function savesServer(options) {
         return change?.record ? toSave(change.record).info : null;
     };
     const load = async function () {
+        // when the saves were last opened is bookkeeping: a device too full to
+        // keep it still loads them.
         const [list] = await Promise.all([
             backend.list(scope),
-            backend.touch(scope, now().toISOString()),
+            backend.touch(scope, now().toISOString()).catch((err) => {
+                log("warn", "the saves' last use couldn't be kept.", err);
+            }),
         ]);
-        return { status: backend.status(), items: list.map(toSave) };
+        return {
+            where: backend.status() === "memory" ? "memory" : where,
+            items: list.map(toSave),
+        };
     };
     return (context) => {
         // another tab (later, another device) changed a save: tell the game,
@@ -89,11 +102,18 @@ export function savesServer(options) {
                 "saves.list": {
                     run: async () => (await backend.list(scope)).map((record) => record.name).sort(),
                 },
-                "saves.write": { run: write, coalesce: (p) => String(p["name"]) },
+                "saves.write": { run: write, key: saveKey, coalesce: true },
                 // the removal's revision, or null when there was nothing to remove.
                 "saves.remove": {
+                    key: saveKey,
                     run: async (params) => {
-                        const change = await backend.change(scope, nameOf(params), () => null, source);
+                        // a removal writes too (the game's change counter), so a full
+                        // device refuses it the same way.
+                        const change = await backend
+                            .change(scope, nameOf(params), () => null, source)
+                            .catch((err) => {
+                            throw storageError(err);
+                        });
                         return change?.revision ?? null;
                     },
                 },
@@ -103,15 +123,11 @@ export function savesServer(options) {
                     send("saves.load", await load());
                 }
                 catch (err) {
-                    console.error("arcadible: the game's saves couldn't load:", err);
+                    log("warn", "the game's saves couldn't load.", err);
                     const error = err instanceof ArcadibleError
                         ? err.toJSON()
                         : { code: Codes.Unavailable, message: "Saves couldn't load." };
-                    send("saves.load", {
-                        status: "ephemeral",
-                        items: [],
-                        error,
-                    });
+                    send("saves.load", { items: [], error });
                 }
             },
             close: unsubscribe,

package/dist/version.d.ts

@@ -1 +1 @@
-export declare const VERSION = "1.1.0";
+export declare const VERSION = "1.2.0";

package/dist/version.js

@@ -1,3 +1,3 @@
 // The client's version, sent in its hello and shown as `arcadible.version`,
 // for bug reports. It matches package.json (test/unit/protocol.test.ts).
-export const VERSION = "1.1.0";
+export const VERSION = "1.2.0";

package/package.json

@@ -1,6 +1,6 @@
 {
   "author": "Offst, Inc.",
-  "description": "The Arcadible SDK: how a game talks to Arcadible, over a bus between the game and the play page, starting with saves that survive updates.",
+  "description": "The Arcadible SDK: saves that carry over between a game's versions on Arcadible.",
   "devDependencies": {
     "@playwright/test": "1.63.0",
     "@types/node": "^25.0.3",
@@ -43,5 +43,5 @@
   ],
   "type": "module",
   "types": "./dist/index.d.ts",
-  "version": "1.1.0"
+  "version": "1.2.0"
 }