selfstore 1.7.2 → 1.7.5

package/README.md

@@ -362,6 +362,24 @@ always branch on `err.code`, never parse error messages; treat
 design); an empty password means "not encrypted"; collection names starting
 with `__` are reserved.
 
+## Stability
+
+The number on the package is not what you are trusting - the file is.
+
+**A backup written by any version of selfstore stays readable by every later
+version.** The test suite enforces it, and it holds across majors, not just
+minors. The format is [specified](./SPEC.md) and readable without this library
+at all, including from Python, so leaving is documented rather than promised.
+
+For the package itself: semver, with a major reserved for a change that stops
+an app compiling or alters what it already does - a new default counts. Releases
+are deliberate and batched, not one per merge. The rules, and what the version
+history reads like, are in [RELEASING.md](./RELEASING.md).
+
+Published versions are never unpublished. A superseded one stays installable;
+the tool for a release that should not be used is `npm deprecate`, and the tool
+for a broken one is the next release.
+
 ## Install
 
 ```sh

package/dist/advanced.js

@@ -1,4 +1,4 @@
-export { RESERVED_STORE_MODES, createLocalStore, deriveStatus, gisDriveAuth, indexedDbCache, isLockableCache, isReservedStoreMode, memoryCache } from './chunk-MZMMOEFW.js';
+export { RESERVED_STORE_MODES, createLocalStore, deriveStatus, gisDriveAuth, indexedDbCache, isLockableCache, isReservedStoreMode, memoryCache } from './chunk-ZV2S3I76.js';
 export { datedName, pickFromDisk, saveToDisk } from './chunk-53WWPEML.js';
 import './chunk-SKWHKM25.js';
 import { FILE_ID_KEY, renameBackup, deleteBackup, createBackup, listBackups, findOrCreateOwnFile, adopt, preview, fromSession, connect, openExisting, isOpenSupported, isSupported, fromSession2, connect2, fromSession4, connect4, peer, fromSession3, connect3 } from './chunk-PK5BFQLI.js';

package/dist/{chunk-MZMMOEFW.js → chunk-ZV2S3I76.js}

@@ -177,11 +177,31 @@ function createLocalStore(opts) {
   const replicaList = [];
   let chain = Promise.resolve();
   function serialize(fn) {
-    const exec = locks ? () => locks.request(lockName, fn) : fn;
+    const exec = locks ? () => underLock(fn) : fn;
     const run = chain.then(exec, exec);
     chain = run.catch(() => void 0);
     return run;
   }
+  async function underLock(fn) {
+    const giveUp = new AbortController();
+    const timer2 = setTimeout(() => giveUp.abort(), LOCK_WAIT_MS);
+    let ran = false;
+    try {
+      return await locks.request(lockName, { signal: giveUp.signal }, () => {
+        ran = true;
+        clearTimeout(timer2);
+        return fn();
+      });
+    } catch (e) {
+      clearTimeout(timer2);
+      if (ran || !giveUp.signal.aborted) throw e;
+      lastError = transient("Another tab is holding the store; continuing without it.");
+      logger.warn(`[selfstore] cross-tab lock "${lockName}" unavailable, proceeding without it`);
+      notify();
+      return fn();
+    }
+  }
+  const LOCK_WAIT_MS = 1e4;
   const IDLE_LOCK_MS = 30 * 60 * 1e3;
   const durableKind = () => !isReservedStoreMode(targetKind);
   const subs = /* @__PURE__ */ new Set();
@@ -2030,5 +2050,5 @@ function gisDriveAuth(opts) {
 }
 
 export { RESERVED_STORE_MODES, createLocalStore, deriveStatus, gisDriveAuth, indexedDbCache, isLockableCache, isReservedStoreMode, memoryCache };
-//# sourceMappingURL=chunk-MZMMOEFW.js.map
-//# sourceMappingURL=chunk-MZMMOEFW.js.map
+//# sourceMappingURL=chunk-ZV2S3I76.js.map
+//# sourceMappingURL=chunk-ZV2S3I76.js.map