on-zero 0.6.3 → 0.6.4

package/dist/cjs/helpers/recoverZeroClient.native.js

@@ -26,6 +26,7 @@ var recoverZeroClient_exports = {};
 __export(recoverZeroClient_exports, {
   classifyZeroRecoveryLog: () => classifyZeroRecoveryLog,
   composeRecoveryLogSink: () => composeRecoveryLogSink,
+  isRecoverableZeroStalePokeMessage: () => isRecoverableZeroStalePokeMessage,
   makeZeroRecovery: () => makeZeroRecovery,
   resetRecoveryStateForTests: () => resetRecoveryStateForTests
 });
@@ -43,6 +44,7 @@ function _type_of(obj) {
   return obj && typeof Symbol !== "undefined" && obj.constructor === Symbol ? "symbol" : typeof obj;
 }
 var RECOVER_GUARD_MS = 6e4;
+var RELOAD_LATCH_TIMEOUT_MS = 15e3;
 var LOCAL_STORE_LOST = "Expected IndexedDB not found";
 var SQLITE_ERROR_NAME = "SqliteError";
 var SQLITE_STATEMENT_FINALIZED = "This statement has been finalized";
@@ -50,26 +52,83 @@ var STORE_CLOSED = "Store is closed";
 var STORE_CLOSED_REPEAT_MIN_MS = 2e3;
 var STORE_CLOSED_REPEAT_MAX_MS = 6e4;
 var reloadScheduled = false;
+var reloadInProgress = false;
+var reloadLatchTimer;
 var pendingDeletes = [];
-function recoveryGuardOpen(reasonKey) {
+var inMemoryGuard = /* @__PURE__ */new Map();
+function defaultGuardStorage() {
   try {
-    var key = `on-zero-recover-${reasonKey}`;
-    var rawLast = window.sessionStorage.getItem(key);
-    var now = Date.now();
-    var last = rawLast ? Number(rawLast) : 0;
-    if (last > 0 && now - last < RECOVER_GUARD_MS) return false;
-    window.sessionStorage.setItem(key, String(now));
-  } catch (e) {}
+    if (typeof window === "undefined" || !window.sessionStorage) return void 0;
+    return window.sessionStorage;
+  } catch (e) {
+    return void 0;
+  }
+}
+function recoveryGuardOpen(reasonKey, guardStorage) {
+  var key = `on-zero-recover-${reasonKey}`;
+  var now = Date.now();
+  var _inMemoryGuard_get;
+  var memLast = (_inMemoryGuard_get = inMemoryGuard.get(key)) !== null && _inMemoryGuard_get !== void 0 ? _inMemoryGuard_get : 0;
+  if (memLast > 0 && now - memLast < RECOVER_GUARD_MS) return false;
+  var storage = guardStorage !== null && guardStorage !== void 0 ? guardStorage : defaultGuardStorage();
+  if (storage) {
+    try {
+      var rawLast = storage.getItem(key);
+      var last = rawLast ? Number(rawLast) : 0;
+      if (last > 0 && now - last < RECOVER_GUARD_MS) return false;
+      storage.setItem(key, String(now));
+    } catch (e) {}
+  }
+  inMemoryGuard.set(key, now);
   return true;
 }
 var lastStoreClosedAtMs = 0;
+function armReloadLatchTimeout() {
+  if (typeof setTimeout !== "function") return;
+  if (reloadLatchTimer) clearTimeout(reloadLatchTimer);
+  reloadLatchTimer = setTimeout(function () {
+    reloadLatchTimer = void 0;
+    reloadScheduled = false;
+  }, RELOAD_LATCH_TIMEOUT_MS);
+  if (reloadLatchTimer && (typeof reloadLatchTimer === "undefined" ? "undefined" : _type_of(reloadLatchTimer)) === "object" && "unref" in reloadLatchTimer) {
+    reloadLatchTimer.unref();
+  }
+}
+function disarmReloadLatchTimeout() {
+  if (reloadLatchTimer) {
+    clearTimeout(reloadLatchTimer);
+    reloadLatchTimer = void 0;
+  }
+}
+function performReload(deps) {
+  if (reloadInProgress) return Promise.resolve();
+  reloadInProgress = true;
+  disarmReloadLatchTimeout();
+  var _deps_reload;
+  var doReload = (_deps_reload = deps.reload) !== null && _deps_reload !== void 0 ? _deps_reload : function () {
+    var _globalThis_location_reload, _globalThis_location;
+    return (_globalThis_location = globalThis.location) === null || _globalThis_location === void 0 ? void 0 : (_globalThis_location_reload = _globalThis_location.reload) === null || _globalThis_location_reload === void 0 ? void 0 : _globalThis_location_reload.call(_globalThis_location);
+  };
+  return Promise.resolve().then(function () {
+    return Promise.allSettled(pendingDeletes.splice(0).map(function (run) {
+      return run();
+    }));
+  }).then(function () {
+    var _deps_beforeReload;
+    return (_deps_beforeReload = deps.beforeReload) === null || _deps_beforeReload === void 0 ? void 0 : _deps_beforeReload.call(deps);
+  }).catch(function () {}).then(function () {
+    doReload();
+  });
+}
 function recover(deps, reasonKey, message, dropLocalState) {
   if (typeof window === "undefined") return;
   if (dropLocalState) {
-    pendingDeletes.push(Promise.resolve().then(deps.deleteLocalState).catch(function () {}));
+    pendingDeletes.push(function () {
+      return Promise.resolve().then(deps.deleteLocalState);
+    });
   }
   if (reloadScheduled) return;
-  if (!recoveryGuardOpen(reasonKey)) {
+  if (!recoveryGuardOpen(reasonKey, deps.guardStorage)) {
     console.error(`[on-zero] ${message} \u2014 already recovered once, not reloading`);
     deps.zeroEvents.emit({
       type: "fatal",
@@ -78,22 +137,25 @@ function recover(deps, reasonKey, message, dropLocalState) {
     return;
   }
   reloadScheduled = true;
+  armReloadLatchTimeout();
   console.warn(`[on-zero] ${message} \u2014 recovering`);
   deps.zeroEvents.emit({
     type: "recovering",
     reason: message
   });
-  var _deps_reload;
-  var doReload = (_deps_reload = deps.reload) !== null && _deps_reload !== void 0 ? _deps_reload : function () {
-    var _globalThis_location_reload, _globalThis_location;
-    return (_globalThis_location = globalThis.location) === null || _globalThis_location === void 0 ? void 0 : (_globalThis_location_reload = _globalThis_location.reload) === null || _globalThis_location_reload === void 0 ? void 0 : _globalThis_location_reload.call(_globalThis_location);
+  var runReload = function () {
+    return performReload(deps);
   };
-  Promise.resolve().then(function () {
-    return Promise.allSettled(pendingDeletes);
-  }).then(function () {
-    var _deps_beforeReload;
-    return (_deps_beforeReload = deps.beforeReload) === null || _deps_beforeReload === void 0 ? void 0 : _deps_beforeReload.call(deps);
-  }).catch(function () {}).finally(doReload);
+  if (deps.scheduleReload) {
+    deps.scheduleReload({
+      reason: message,
+      reasonKey,
+      dropLocalState,
+      performReload: runReload
+    });
+  } else {
+    void runReload();
+  }
 }
 function makeZeroRecovery(deps) {
   return {
@@ -132,6 +194,58 @@ function isBenignStoreClosedLog(text) {
   if (/Mutator\s+".*"\s+app error on client/i.test(text)) return true;
   return false;
 }
+function classifyMutationDesync(text) {
+  if (text.includes("sent mutation ID") && text.includes("but expected")) {
+    return {
+      reason: "mutation-desync",
+      reasonKey: "mutation-desync",
+      message: "mutation id desync"
+    };
+  }
+  if (text.includes("oooMutation") || text.includes("Server reported an out-of-order mutation")) {
+    return {
+      reason: "mutation-desync",
+      reasonKey: "mutation-desync",
+      message: "out-of-order mutation"
+    };
+  }
+  if (text.includes("already processed")) {
+    return {
+      reason: "mutation-desync",
+      reasonKey: "mutation-desync",
+      message: "mutation already processed"
+    };
+  }
+  if (text.includes("InvalidConnectionRequestLastMutationID")) {
+    return {
+      reason: "mutation-desync",
+      reasonKey: "mutation-desync",
+      message: "invalid connection last mutation id"
+    };
+  }
+  if (text.includes("InvalidConnectionRequestBaseCookie")) {
+    return {
+      reason: "connection-cookie-invalid",
+      reasonKey: "connection-cookie-invalid",
+      message: "invalid connection base cookie"
+    };
+  }
+  if (text.includes("ClientNotFound") || text.includes("Client not found")) {
+    return {
+      reason: "client-not-found",
+      reasonKey: "client-not-found",
+      message: "client not found"
+    };
+  }
+  if (text.includes("connection userID mismatch")) {
+    return {
+      reason: "connection-userid-mismatch",
+      reasonKey: "connection-userid-mismatch",
+      message: "connection user id mismatch"
+    };
+  }
+  return void 0;
+}
 function classifyZeroRecoveryLog(level, args) {
   var nowMs = arguments.length > 2 && arguments[2] !== void 0 ? arguments[2] : Date.now();
   if (level !== "error") return void 0;
@@ -152,6 +266,13 @@ function classifyZeroRecoveryLog(level, args) {
       dropLocalState: true
     };
   }
+  var desync = classifyMutationDesync(text);
+  if (desync) {
+    return {
+      ...desync,
+      dropLocalState: true
+    };
+  }
   if (text.includes(STORE_CLOSED) && !isBenignStoreClosedLog(text)) {
     var prevMs = lastStoreClosedAtMs;
     lastStoreClosedAtMs = nowMs;
@@ -175,9 +296,12 @@ function composeRecoveryLogSink(deps, consumerLogSink) {
       }
       if (consumerLogSink) consumerLogSink.log(level, context, ...args);else logToConsole(level, context, ...args);
       var recovery = classifyZeroRecoveryLog(level, args);
-      if (recovery) {
-        recover(deps, recovery.reasonKey, recovery.message, recovery.dropLocalState);
+      if (!recovery) return;
+      if (deps.benignLogFilter) {
+        var text = args.map(logArgText).join(" ");
+        if (deps.benignLogFilter(text)) return;
       }
+      recover(deps, recovery.reasonKey, recovery.message, recovery.dropLocalState);
     },
     // call through the consumer sink so a class-based sink keeps its `this`,
     // rather than handing Zero a detached method reference.
@@ -186,9 +310,18 @@ function composeRecoveryLogSink(deps, consumerLogSink) {
     } : void 0
   };
 }
+function isRecoverableZeroStalePokeMessage(message) {
+  return message.includes("Server returned unexpected base cookie during sync") || message.includes("Received cookie") && message.includes("is < than last snapshot cookie") && message.includes("ignoring client view");
+}
 function resetRecoveryStateForTests() {
   reloadScheduled = false;
+  reloadInProgress = false;
+  if (reloadLatchTimer) {
+    clearTimeout(reloadLatchTimer);
+    reloadLatchTimer = void 0;
+  }
   pendingDeletes.length = 0;
   lastStoreClosedAtMs = 0;
+  inMemoryGuard.clear();
 }
 //# sourceMappingURL=recoverZeroClient.native.js.map

package/dist/cjs/helpers/recoverZeroClient.native.js.map

@@ -1 +1 @@
-{"version":3,"names":["__toCommonJS","mod","__copyProps","__defProp","value","recoverZeroClient_exports","__export","classifyZeroRecoveryLog","composeRecoveryLogSink","makeZeroRecovery","resetRecoveryStateForTests","module","exports","_instanceof","left","right","Symbol","hasInstance","_type_of","obj","constructor","RECOVER_GUARD_MS","LOCAL_STORE_LOST","SQLITE_ERROR_NAME","SQLITE_STATEMENT_FINALIZED","STORE_CLOSED","STORE_CLOSED_REPEAT_MIN_MS","STORE_CLOSED_REPEAT_MAX_MS","reloadScheduled","pendingDeletes","recoveryGuardOpen","reasonKey","key","rawLast","window","sessionStorage","getItem","now","Date","last","Number","setItem","String","e","lastStoreClosedAtMs","recover","deps","message","dropLocalState","push","Promise","resolve","then","deleteLocalState","catch","console","error","zeroEvents","emit","type","reason","warn","_deps_reload","doReload","reload","_globalThis_location_reload","_globalThis_location","globalThis","location","call","allSettled","_deps_beforeReload","beforeReload","finally","onUpdateNeeded","onClientStateNotFound","logToConsole","level","context","_len","arguments","length","args","Array","_key","prefix","Object","entries","map","param","join","method","logArgText","arg","Error","name","stack","isBenignStoreClosedLog","text","test","nowMs","includes","prevMs"],"sources":["../../../src/helpers/recoverZeroClient.ts"],"sourcesContent":[null],"mappings":"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","ignoreList":[]}
+{"version":3,"names":["__toCommonJS","mod","__copyProps","__defProp","value","recoverZeroClient_exports","__export","classifyZeroRecoveryLog","composeRecoveryLogSink","isRecoverableZeroStalePokeMessage","makeZeroRecovery","resetRecoveryStateForTests","module","exports","_instanceof","left","right","Symbol","hasInstance","_type_of","obj","constructor","RECOVER_GUARD_MS","RELOAD_LATCH_TIMEOUT_MS","LOCAL_STORE_LOST","SQLITE_ERROR_NAME","SQLITE_STATEMENT_FINALIZED","STORE_CLOSED","STORE_CLOSED_REPEAT_MIN_MS","STORE_CLOSED_REPEAT_MAX_MS","reloadScheduled","reloadInProgress","reloadLatchTimer","pendingDeletes","inMemoryGuard","Map","defaultGuardStorage","window","sessionStorage","e","recoveryGuardOpen","reasonKey","guardStorage","key","now","Date","_inMemoryGuard_get","memLast","get","storage","rawLast","getItem","last","Number","setItem","String","set","lastStoreClosedAtMs","armReloadLatchTimeout","setTimeout","clearTimeout","unref","disarmReloadLatchTimeout","performReload","deps","Promise","resolve","_deps_reload","doReload","reload","_globalThis_location_reload","_globalThis_location","globalThis","location","call","then","allSettled","splice","map","run","_deps_beforeReload","beforeReload","catch","recover","message","dropLocalState","push","deleteLocalState","console","error","zeroEvents","emit","type","reason","warn","runReload","scheduleReload","onUpdateNeeded","onClientStateNotFound","logToConsole","level","context","_len","arguments","length","args","Array","_key","prefix","Object","entries","param","join","method","logArgText","arg","Error","name","stack","isBenignStoreClosedLog","text","test","classifyMutationDesync","includes","nowMs","desync","prevMs"],"sources":["../../../src/helpers/recoverZeroClient.ts"],"sourcesContent":[null],"mappings":"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","ignoreList":[]}

package/dist/cjs/helpers/recoverZeroClient.test.cjs

@@ -289,4 +289,185 @@ async function flush() {
       reason: "client state not found"
     });
   });
+  (0, import_vitest.test)("scheduleReload defers the reload AND the store delete until performReload runs", async () => {
+    const {
+      deps,
+      deleteLocalState,
+      reload
+    } = setup();
+    let captured;
+    deps.scheduleReload = ctx => {
+      captured = ctx;
+    };
+    (0, import_recoverZeroClient.makeZeroRecovery)(deps).onClientStateNotFound();
+    await flush();
+    (0, import_vitest.expect)(reload).not.toHaveBeenCalled();
+    (0, import_vitest.expect)(deleteLocalState).not.toHaveBeenCalled();
+    (0, import_vitest.expect)(captured).toMatchObject({
+      reasonKey: "client-state-not-found",
+      dropLocalState: true
+    });
+    await captured.performReload();
+    await flush();
+    (0, import_vitest.expect)(deleteLocalState).toHaveBeenCalledTimes(1);
+    (0, import_vitest.expect)(reload).toHaveBeenCalledTimes(1);
+  });
+  (0, import_vitest.test)("scheduleReload that reloads directly skips the delete and beforeReload", async () => {
+    const {
+      deps,
+      deleteLocalState,
+      reload
+    } = setup();
+    const nativeReload = import_vitest.vi.fn();
+    const beforeReload = import_vitest.vi.fn(async () => {});
+    deps.beforeReload = beforeReload;
+    deps.scheduleReload = () => {
+      nativeReload();
+    };
+    (0, import_recoverZeroClient.makeZeroRecovery)(deps).onClientStateNotFound();
+    await flush();
+    (0, import_vitest.expect)(nativeReload).toHaveBeenCalledTimes(1);
+    (0, import_vitest.expect)(deleteLocalState).not.toHaveBeenCalled();
+    (0, import_vitest.expect)(beforeReload).not.toHaveBeenCalled();
+    (0, import_vitest.expect)(reload).not.toHaveBeenCalled();
+  });
+  (0, import_vitest.test)("scheduleReload performReload is idempotent (one reload even if called twice)", async () => {
+    const {
+      deps,
+      deleteLocalState,
+      reload
+    } = setup();
+    let captured;
+    deps.scheduleReload = ctx => {
+      captured = ctx;
+    };
+    (0, import_recoverZeroClient.makeZeroRecovery)(deps).onClientStateNotFound();
+    await flush();
+    await captured.performReload();
+    await captured.performReload();
+    await flush();
+    (0, import_vitest.expect)(deleteLocalState).toHaveBeenCalledTimes(1);
+    (0, import_vitest.expect)(reload).toHaveBeenCalledTimes(1);
+  });
+  (0, import_vitest.test)("scheduleReload deferred PAST the latch timeout still deletes and reloads exactly once", async () => {
+    import_vitest.vi.useFakeTimers();
+    try {
+      const {
+        deps,
+        deleteLocalState,
+        reload
+      } = setup();
+      let captured;
+      deps.scheduleReload = ctx => {
+        captured = ctx;
+      };
+      (0, import_recoverZeroClient.makeZeroRecovery)(deps).onClientStateNotFound();
+      (0, import_vitest.expect)(captured).toBeDefined();
+      await import_vitest.vi.advanceTimersByTimeAsync(2e4);
+      (0, import_vitest.expect)(deleteLocalState).not.toHaveBeenCalled();
+      (0, import_vitest.expect)(reload).not.toHaveBeenCalled();
+      await captured.performReload();
+      (0, import_vitest.expect)(deleteLocalState).toHaveBeenCalledTimes(1);
+      (0, import_vitest.expect)(reload).toHaveBeenCalledTimes(1);
+    } finally {
+      import_vitest.vi.useRealTimers();
+    }
+  });
+  (0, import_vitest.test)("a slow beforeReload holds the latch through the timeout window (no double reload)", async () => {
+    import_vitest.vi.useFakeTimers();
+    try {
+      const {
+        deps,
+        reload
+      } = setup();
+      let releaseBeforeReload = () => {};
+      deps.beforeReload = () => new Promise(resolve => {
+        releaseBeforeReload = resolve;
+      });
+      const recovery = (0, import_recoverZeroClient.makeZeroRecovery)(deps);
+      recovery.onClientStateNotFound();
+      await import_vitest.vi.advanceTimersByTimeAsync(2e4);
+      recovery.onClientStateNotFound();
+      await import_vitest.vi.advanceTimersByTimeAsync(0);
+      (0, import_vitest.expect)(reload).not.toHaveBeenCalled();
+      releaseBeforeReload();
+      await import_vitest.vi.advanceTimersByTimeAsync(0);
+      (0, import_vitest.expect)(reload).toHaveBeenCalledTimes(1);
+    } finally {
+      import_vitest.vi.useRealTimers();
+    }
+  });
+  (0, import_vitest.test)("injectable guardStorage gives cross-reload loop protection (Hermes has no sessionStorage)", async () => {
+    const store = /* @__PURE__ */new Map();
+    const {
+      deps,
+      reload,
+      events
+    } = setup();
+    deps.guardStorage = {
+      getItem: key => store.get(key) ?? null,
+      setItem: (key, value) => {
+        store.set(key, value);
+      }
+    };
+    const recovery = (0, import_recoverZeroClient.makeZeroRecovery)(deps);
+    recovery.onClientStateNotFound();
+    await flush();
+    (0, import_vitest.expect)(reload).toHaveBeenCalledTimes(1);
+    (0, import_recoverZeroClient.resetRecoveryStateForTests)();
+    recovery.onClientStateNotFound();
+    await flush();
+    (0, import_vitest.expect)(reload).toHaveBeenCalledTimes(1);
+    (0, import_vitest.expect)(events.some(event => event.type === "fatal")).toBe(true);
+  });
+  (0, import_vitest.test)("a guardStorage that throws never crashes recovery (in-memory is the floor)", async () => {
+    const {
+      deps,
+      reload
+    } = setup();
+    deps.guardStorage = {
+      getItem: () => {
+        throw new Error("no storage on this platform");
+      },
+      setItem: () => {
+        throw new Error("no storage on this platform");
+      }
+    };
+    (0, import_recoverZeroClient.makeZeroRecovery)(deps).onClientStateNotFound();
+    await flush();
+    (0, import_vitest.expect)(reload).toHaveBeenCalledTimes(1);
+  });
+  (0, import_vitest.test)("classifier recognizes the mutation / connection desync class", () => {
+    const cases = [[["sent mutation ID 5 but expected 4"], "mutation-desync"], [["oooMutation detected"], "mutation-desync"], [["Server reported an out-of-order mutation"], "mutation-desync"], [["Ignoring mutation 3, already processed. Expected: 4"], "mutation-desync"], [["InvalidConnectionRequestLastMutationID"], "mutation-desync"], [["InvalidConnectionRequestBaseCookie"], "connection-cookie-invalid"], [["ClientNotFound: client gone"], "client-not-found"], [["connection userID mismatch"], "connection-userid-mismatch"]];
+    for (const [args, reason] of cases) {
+      (0, import_vitest.expect)((0, import_recoverZeroClient.classifyZeroRecoveryLog)("error", args)).toMatchObject({
+        reason,
+        dropLocalState: true
+      });
+    }
+    (0, import_vitest.expect)((0, import_recoverZeroClient.classifyZeroRecoveryLog)("error", ["consecutive server-ack timeouts"])).toBeUndefined();
+    (0, import_vitest.expect)((0, import_recoverZeroClient.classifyZeroRecoveryLog)("error", ["Connection attempt timed out after 10 seconds"])).toBeUndefined();
+    (0, import_vitest.expect)((0, import_recoverZeroClient.classifyZeroRecoveryLog)("warn", ["ClientNotFound"])).toBeUndefined();
+  });
+  (0, import_vitest.test)("benignLogFilter suppresses recovery for a matching classified log", async () => {
+    const {
+      deps,
+      deleteLocalState,
+      reload
+    } = setup();
+    deps.benignLogFilter = message => message.includes("ClientNotFound");
+    const sink = (0, import_recoverZeroClient.composeRecoveryLogSink)(deps);
+    sink.log("error", void 0, "ClientNotFound: gone");
+    await flush();
+    (0, import_vitest.expect)(deleteLocalState).not.toHaveBeenCalled();
+    (0, import_vitest.expect)(reload).not.toHaveBeenCalled();
+    sink.log("error", void 0, "sent mutation ID 5 but expected 4");
+    await flush();
+    (0, import_vitest.expect)(reload).toHaveBeenCalledTimes(1);
+  });
+  (0, import_vitest.test)("isRecoverableZeroStalePokeMessage matches only the stale-cookie signatures", () => {
+    (0, import_vitest.expect)((0, import_recoverZeroClient.isRecoverableZeroStalePokeMessage)("Server returned unexpected base cookie during sync")).toBe(true);
+    (0, import_vitest.expect)((0, import_recoverZeroClient.isRecoverableZeroStalePokeMessage)("Received cookie 5 is < than last snapshot cookie 9, ignoring client view")).toBe(true);
+    (0, import_vitest.expect)((0, import_recoverZeroClient.isRecoverableZeroStalePokeMessage)("client state not found")).toBe(false);
+  });
 });