@arcadible/sdk 1.2.0 → 1.2.1

package/dist/saves/backend/indexeddb.d.ts

@@ -3,6 +3,7 @@ export type IndexedDBOptions = {
     factory?: IDBFactory | null;
     player?: string;
     persist?: boolean;
+    reopenWait?: number;
 };
 export declare function indexedDBBackend(options?: IndexedDBOptions): Backend & {
     close(): void;

package/dist/saves/backend/indexeddb.js

@@ -13,6 +13,9 @@ const CHANNEL = "arcadible-saves";
 // every save is a guest's for One; a signed-in player's sit beside them
 // later, under their own id, with no migration.
 const GUEST = "guest";
+// after a failed reopen, how long calls fail at once before it's tried again,
+// so a game saving every frame doesn't try, and fail, every frame.
+const REOPEN_WAIT = 1000;
 // [function]
 function settle(request) {
     return new Promise((resolve, reject) => {
@@ -66,7 +69,7 @@ function isClosed(err) {
 // refuses to open (a browser blocking site data, some `file://` pages),
 // they're kept in memory, and `status()` says so. Once it has opened, it
 // never switches: a lost connection fails calls with `unavailable` until it
-// opens again, rather than show an empty copy.
+// opens again, trying at most once a second, rather than show an empty copy.
 export function indexedDBBackend(options = {}) {
     const factory = options.factory === undefined
         ? (globalThis.indexedDB ?? null)
@@ -79,6 +82,9 @@ export function indexedDBBackend(options = {}) {
     let opened = false;
     let current = null;
     let opening = null;
+    // whether reopening has failed since it last worked, and when to try again.
+    let down = false;
+    let retryAt = 0;
     let asked = false;
     const keyOf = (scope) => `${player}\u0000${scope.game}\u0000${scope.channel}`;
     const rangeOf = (scope) => IDBKeyRange.only([player, scope.game, scope.channel]);
@@ -86,6 +92,7 @@ export function indexedDBBackend(options = {}) {
         if (current === db)
             current = null;
     };
+    const unreachable = () => new ArcadibleError(Codes.Unavailable, "Saves can't be reached right now. Try again.");
     const connect = async function () {
         try {
             if (!factory)
@@ -103,13 +110,19 @@ export function indexedDBBackend(options = {}) {
                 globalThis.navigator?.storage?.persist?.().catch(() => false);
             }
             opened = true;
+            down = false;
             current = db;
             return db;
         }
         catch (err) {
             if (opened) {
-                log("warn", "the saves' storage couldn't be opened again.", err);
-                throw new ArcadibleError(Codes.Unavailable, "Saves can't be reached right now. Try again.");
+                // once until it works again: the calls failing meanwhile say so.
+                if (!down) {
+                    log("warn", "the saves' storage couldn't be opened again.", err);
+                }
+                down = true;
+                retryAt = Date.now() + (options.reopenWait ?? REOPEN_WAIT);
+                throw unreachable();
             }
             log("warn", "this browser won't keep saves here, so they're kept in memory until the page closes.", err);
             status = "memory";
@@ -125,6 +138,9 @@ export function indexedDBBackend(options = {}) {
             return Promise.resolve(null);
         if (current)
             return Promise.resolve(current);
+        if (down && !opening && Date.now() < retryAt) {
+            return Promise.reject(unreachable());
+        }
         opening ??= connect();
         return opening;
     };

package/dist/version.d.ts

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

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.2.0";
+export const VERSION = "1.2.1";

package/package.json

@@ -43,5 +43,5 @@
   ],
   "type": "module",
   "types": "./dist/index.d.ts",
-  "version": "1.2.0"
+  "version": "1.2.1"
 }