on-zero 0.8.3 → 0.8.4

package/README.md

@@ -846,8 +846,9 @@ drops the affected instance's local store and reloads the page ONCE. this covers
   `…LastMutationID`, `ClientNotFound`, `connection userID mismatch`. these
   surface only through the error log, so the log sink recovers on them too.
 
-two consecutive server acknowledgement timeouts also recover by default. one
-timeout remains a normal slow-server failure. configure the threshold with
+two consecutive server acknowledgement timeouts reconstruct the client in place
+without deleting local state or reloading the page. one timeout remains a normal
+slow-server failure. configure the threshold with
 `serverAckTimeoutRecoveryThreshold` on `createZeroClient`.
 
 ### the hooks (all optional props on `ProvideZero`)
@@ -900,6 +901,18 @@ timeout remains a normal slow-server failure. configure the threshold with
 `connection-needs-auth`, so consumers can switch on stable keys instead of
 matching message strings.
 
+recoverable connection interruptions emit `{ type: 'reconnect', status:
+'trying' | 'waiting', reasonKey, reason }`, followed by `{ type: 'reconnect',
+status: 'connected' }` after sync reconnects. `ServerOverloaded` stays in
+Zero's built-in retry/backoff loop, transport errors such as `Failed to fetch`
+resume the paused connection, and acknowledgement timeouts reconstruct the
+client with its existing local state. none of these paths delete local state or
+reload the page.
+
+`createZeroClient` and a combined client also expose `reloadPage()`. it performs
+a plain page reload and returns `false` where no page location exists. this is
+the opt-in action for a host's reconnect toast; it never clears local state.
+
 ### guard + latch semantics
 
 - a **per-reason guard** (60s window) means the SAME reason re-failing right

package/dist/cjs/combineZeroClients.cjs

@@ -77,8 +77,27 @@ function combineZeroClients(...clientsAndOptions) {
     return ownerOfQueryFn(args[0]).getQuery(...args);
   }
   const zeroEvents = (0, import_emitter.createEmitter)(`zero:combined(${clients.map(client => client.instanceName).join("+")})`, null);
+  const reconnecting = /* @__PURE__ */new Map();
   for (const client of clients) {
-    client.zeroEvents.listen(event => zeroEvents.emit(event));
+    client.zeroEvents.listen(event => {
+      if (event?.type !== "reconnect") {
+        zeroEvents.emit(event);
+        return;
+      }
+      if (event.status === "connected") {
+        reconnecting.delete(client.instanceName);
+        if (reconnecting.size === 0) {
+          zeroEvents.emit(event);
+          return;
+        }
+        const pending2 = [...reconnecting.values()];
+        zeroEvents.emit(pending2.find(candidate => candidate.status === "waiting") ?? pending2[0]);
+        return;
+      }
+      reconnecting.set(client.instanceName, event);
+      const pending = [...reconnecting.values()];
+      zeroEvents.emit(pending.find(candidate => candidate.status === "waiting") ?? event);
+    });
   }
   const ControlQueries = ({
     children,
@@ -95,6 +114,7 @@ function combineZeroClients(...clientsAndOptions) {
     getQuery,
     run: import_run.run,
     zeroEvents,
+    reloadPage: primary.reloadPage,
     ControlQueries
   };
   return combined;

package/dist/cjs/combineZeroClients.native.js

@@ -42,8 +42,8 @@ function combineZeroClients() {
   var options = hasOptions ? last : {};
   var primary = clients[0];
   var innerName = (_options_inner = options.inner) !== null && _options_inner !== void 0 ? _options_inner : clients[clients.length - 1].instanceName;
-  var clientsByName = new Map(clients.map(function (client2) {
-    return [client2.instanceName, client2];
+  var clientsByName = new Map(clients.map(function (client) {
+    return [client.instanceName, client];
   }));
   if (!clientsByName.has(innerName)) {
     throw new Error(`[on-zero] combineZeroClients inner instance '${innerName}' is not one of the passed clients`);
@@ -96,19 +96,43 @@ function combineZeroClients() {
     }
     return ownerOfQueryFn(args[0]).getQuery(...args);
   }
-  var zeroEvents = (0, import_emitter.createEmitter)(`zero:combined(${clients.map(function (client2) {
-    return client2.instanceName;
+  var zeroEvents = (0, import_emitter.createEmitter)(`zero:combined(${clients.map(function (client) {
+    return client.instanceName;
   }).join("+")})`, null);
+  var reconnecting = /* @__PURE__ */new Map();
   var _iteratorNormalCompletion = true,
     _didIteratorError = false,
     _iteratorError = void 0;
   try {
-    for (var _iterator = clients[Symbol.iterator](), _step; !(_iteratorNormalCompletion = (_step = _iterator.next()).done); _iteratorNormalCompletion = true) {
+    var _loop = function () {
       var client = _step.value;
       client.zeroEvents.listen(function (event) {
-        return zeroEvents.emit(event);
+        var _pending_find;
+        if ((event === null || event === void 0 ? void 0 : event.type) !== "reconnect") {
+          zeroEvents.emit(event);
+          return;
+        }
+        if (event.status === "connected") {
+          var _pending_find1;
+          reconnecting.delete(client.instanceName);
+          if (reconnecting.size === 0) {
+            zeroEvents.emit(event);
+            return;
+          }
+          var pending = [...reconnecting.values()];
+          zeroEvents.emit((_pending_find1 = pending.find(function (candidate) {
+            return candidate.status === "waiting";
+          })) !== null && _pending_find1 !== void 0 ? _pending_find1 : pending[0]);
+          return;
+        }
+        reconnecting.set(client.instanceName, event);
+        var pending1 = [...reconnecting.values()];
+        zeroEvents.emit((_pending_find = pending1.find(function (candidate) {
+          return candidate.status === "waiting";
+        })) !== null && _pending_find !== void 0 ? _pending_find : event);
       });
-    }
+    };
+    for (var _iterator = clients[Symbol.iterator](), _step; !(_iteratorNormalCompletion = (_step = _iterator.next()).done); _iteratorNormalCompletion = true) _loop();
   } catch (err) {
     _didIteratorError = true;
     _iteratorError = err;
@@ -128,8 +152,8 @@ function combineZeroClients() {
       children,
       ...props
     } = param;
-    return clients.reduceRight(function (inner, client2) {
-      return /* @__PURE__ */(0, import_jsx_runtime.jsx)(client2.ControlQueries, {
+    return clients.reduceRight(function (inner, client) {
+      return /* @__PURE__ */(0, import_jsx_runtime.jsx)(client.ControlQueries, {
         ...props,
         children: inner
       });
@@ -143,6 +167,7 @@ function combineZeroClients() {
     getQuery,
     run: import_run.run,
     zeroEvents,
+    reloadPage: primary.reloadPage,
     ControlQueries
   };
   return combined;

package/dist/cjs/combineZeroClients.native.js.map

@@ -1 +1 @@
-{"version":3,"names":["__toCommonJS","mod","__copyProps","__defProp","value","combineZeroClients_exports","__export","combineZeroClients","module","exports","import_jsx_runtime","require","import_emitter","import_instanceRegistry","import_run","_len","arguments","length","clientsAndOptions","Array","_key","_options_inner","last","hasOptions","instanceName","clients","slice","options","primary","innerName","inner","clientsByName","Map","map","client2","has","Error","ownerOfNamespace","ownerOfNamespace2","namespace","owner","getInstanceForNamespace","get","name","ownerOfQueryFn","ownerOfQueryFn2","fn","getInstanceForQueryFn","useQuery","_len2","args","_key2","useQueryDirect","usePermission","String","usePermissionDirect","mutate","Proxy","_","key","zero","preload","getQuery","zeroEvents","createEmitter","join"],"sources":["../../src/combineZeroClients.tsx"],"sourcesContent":[null],"mappings":"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","ignoreList":[]}
+{"version":3,"names":["__toCommonJS","mod","__copyProps","__defProp","value","combineZeroClients_exports","__export","combineZeroClients","module","exports","import_jsx_runtime","require","import_emitter","import_instanceRegistry","import_run","_len","arguments","length","clientsAndOptions","Array","_key","_options_inner","last","hasOptions","instanceName","clients","slice","options","primary","innerName","inner","clientsByName","Map","map","client","has","Error","ownerOfNamespace","ownerOfNamespace2","namespace","owner","getInstanceForNamespace","get","name","ownerOfQueryFn","ownerOfQueryFn2","fn","getInstanceForQueryFn","useQuery","_len2","args","_key2","useQueryDirect","usePermission","String","usePermissionDirect","mutate","Proxy","_","key","zero","preload","getQuery","zeroEvents","createEmitter","join","reconnecting","_iteratorNormalCompletion","_didIteratorError","_iteratorError","_loop","_step","listen","event","_pending_find","type","emit","status","_pending_find1","delete","size","pending","values","find","candidate"],"sources":["../../src/combineZeroClients.tsx"],"sourcesContent":[null],"mappings":";;;;;;;;;;;;;;;;;;;;;AAAA,IAAAA,YAAA,GAAAC,GAAA,IAAAC,WAAA,CAAAC,SAAA;EAAAC,KAAA;AAAA,IAAAH,GAAA;AAAA,IAAAI,0BAAA;AAAAC,QAAA,CAAAD,0BAAA;EAAAE,kBAAA,EAAAA,CAAA,KAAAA;AAAA;AAAAC,MAAA,CAAAC,OAAA,GAAAT,YAA8B,CAAAK,0BAAA;AAC9B,IAAAK,kBAAA,GAAAC,OAA+D;AAC/D,IAAAC,cAAoB,GAAAD,OAAA;AAsMZ,IAAAE,uBAAA,GAAAF,OAAA;AAxHD,IAAAG,UAAS,GAAAH,OAAA,kBAGX;AAEH,SAAMJ,kBAAOA,CAAA;EACb,SAAMQ,IAAA,GAAAC,SAAa,CAAQC,MAAoC,EAAAC,iBAAiB,OAAAC,KAAA,CAAAJ,IAAA,GAAAK,IAAA,MAAAA,IAAA,GAAAL,IAAA,EAAAK,IAAA;IAEhFF,iBAAiB,CAAAE,IAAA,IAAAJ,SACb,CAAAI,IAAA;EAEJ;EAIA,IAAAC,cAAgB;EAChB,IAAAC,IAAM,GAAAJ,iBAAoB,CAAAA,iBAAiB,CAAAD,MAAQ;EACnD,IAAAM,UAAM,UAAgBD,IAAI,CAAAE,YAAY,KAAK,QAAW;EAEtD,IAAIC,OAAC,GAAAF,UAAkB,GAAAL,iBAAY,CAAAQ,KAAA,UAAAR,iBAAA;EACjC,IAAAS,OAAM,GAAIJ,UAAA,GAAAD,IAAA;EAAA,IACRM,OAAA,GAAAH,OAAA;EAAyD,IAC3DI,SAAA,IAAAR,cAAA,GAAAM,OAAA,CAAAG,KAAA,cAAAT,cAAA,cAAAA,cAAA,GAAAI,OAAA,CAAAA,OAAA,CAAAR,MAAA,MAAAO,YAAA;EACF,IAAAO,aAAA,OAAAC,GAAA,CAAAP,OAAA,CAAAQ,GAAA,WAAAC,MAAA;IAEA,OAAM,CACJA,MAAM,CAAAV,YAAQ,EACdU,MAAQ,CACV;EAEA;EACE,KAAAH,aAAM,CAAAI,GAAQ,CAAAN,SAAA;IACd,UAAQO,KAAA,CAAS,gDAAkCP,SAAA;EACrD;EAOA,IAAAQ,gBAAS,GAAY,SAAaC,kBAAAC,SAAA;IAChC,IAAAC,KAAM,KAAQ,EAAA3B,uBAAsB,CAAA4B,uBAAA,EAAAF,SAAA;IACpC,OAAOC,KAAA,IAAMT,aAAA,CAAiBW,GAAA,CAAAF,KAAA,CAAAG,IAC1B,KAAMf,OAAA;EAEZ;EAEA,IAAAgB,cAAS,YAAiBC,eAAaA,CAAAC,EAAA;IAIrC,IAAAN,KAAM,KAAQ,EAAA3B,uBAAwB,CAAAkC,qBAAQ,EAAAD,EAAA;IAC9C,OAAON,KAAA,IAAMT,aAAA,CAAiBW,GAAA,CAAAF,KAAA,CAAAG,IAC1B,KAAMf,OAAA;EAEZ;EAEA,SAAMoB,QAASA,CAAA,EAAI;IACjB,KAAI,IAAGC,KAAK,GAAAjC,SAAA,CAAAC,MAAA,EAAAiC,IAAA,OAAA/B,KAAA,CAAA8B,KAAA,GAAAE,KAAA,MAAAA,KAAA,GAAAF,KAAA,EAAAE,KAAA;MACVD,IAAI,CAAAC,KAAA,CAAO,GAAAnC,SAAQ,CAAAmC,KAAU;IAC7B;IACF,IAAAX,KAAA,GAAAI,cAAA,CAAAM,IAAA;IACD,OAAAV,KAAA,CAAAhB,YAAA,KAAAK,SAAA,GAAAW,KAAA,CAAAQ,QAAA,IAAAE,IAAA,IAAAV,KAAA,CAAAY,cAAA,IAAAF,IAAA;EAED;EAAoC,SAC3BG,aAAKA,CAAA;IACV,SAAIJ,KAAQ,GAAAjC,SAAU,CAAAC,MAAA,EAAAiC,IAAA,OAAA/B,KAAA,CAAA8B,KAAA,GAAAE,KAAA,MAAAA,KAAA,GAAAF,KAAA,EAAAE,KAAA;MACpBD,IAAA,CAAAC,KAAO,IAAAnC,SAAA,CAAAmC,KAAA;IAAA;IAGT,IAAAX,KAAO,GAAAH,gBAAgB,CAAAiB,MAAA,CAAAJ,IAAA;IACzB,OAAAV,KAAA,CAAAhB,YAAA,KAAAK,SAAA,GAAAW,KAAA,CAAAa,aAAA,IAAAH,IAAA,IAAAV,KAAA,CAAAe,mBAAA,IAAAL,IAAA;EACF;EAEA,IAAAM,MAAS,OAAAC,KAAW,KAAa;IAC/Bf,IAAAgB,CAAA,EAAOC,GAAA;MACT,WAAAA,GAAA;MAEA,OAAStB,gBAAyB,CAAAsB,GAAA,EAAAC,IAAA,CAAAJ,MAAA,CAAAG,GAAA;IAChC;EACF;EAGA,IAAAC,IAAM,OAAAH,KAAA,GAAa;IACjBf,IAAAgB,CAAA,EAAAC,GAAA;MACA,IAAAA,GAAA;QACF,OAAAH,MAAA;MACA;MAIA,OAAW5B,OAAA,CAAAgC,IAAU,CAAAD,GAAA;IACnB;EACE;EACE,SAAAE,QAAA,EAAW;IACX,SAAAZ,KAAA,GAAAjC,SAAA,CAAAC,MAAA,EAAAiC,IAAA,OAAA/B,KAAA,CAAA8B,KAAA,GAAAE,KAAA,MAAAA,KAAA,GAAAF,KAAA,EAAAE,KAAA;MACFD,IAAA,CAAAC,KAAA,IAAAnC,SAAA,CAAAmC,KAAA;IACA;IACE,OAAAP,cAAa,CAAAM,IAAO,KAAOW,OAAA,IAAAX,IAAY;EACvC;EACE,SAAAY,SAAA,EAAW;IACX,SAAAb,KAAA,GAAAjC,SAAA,CAAAC,MAAA,EAAAiC,IAAA,OAAA/B,KAAA,CAAA8B,KAAA,GAAAE,KAAA,MAAAA,KAAA,GAAAF,KAAA,EAAAE,KAAA;MAAAD,IACF,CAAAC,KAAA,IAAAnC,SAAA,CAAAmC,KAAA;IACA;IACA,OAAAP,cAAW,CAAAM,IAAA,KAAAY,QAAA,IAAAZ,IAAA;EAAA;EAC+D,IAAAa,UAC1E,OAAAnD,cAAA,CAAAoD,aAAA,mBAAAvC,OAAA,CAAAQ,GAAA,WAAAC,MAAA;IACA,OAAAA,MAAA,CAAAV,YAAA;EAAA,GAAAyC,IACF;EACA,IAAAC,YAAA,GAAa,eAAW,IAAAlC,GAAc;EACtC,IAAAmC,yBAAoB;IAAaC,iBAAQ;IAAAC,cAAA;EACzC;IAAW,IACTC,KAAA,GAAQ,SAAAA,CAAA,EAAM;MAChB,IAAApC,MAAA,GAAAqC,KAAA,CAAAnE,KAAA;MACD8B,MAAA,CAAA6B,UAAA,CAAAS,MAAA,WAAAC,KAAA;QACH,IAAAC,aAAA;QAEM,KAAAD,KAAA,SAAkB,IAAEA,KAAA,KAAa,MAAM,QAC3C,IAAAA,KAAQ,CAAAE,IAAA;UACLZ,UAAkB,CAAAa,IACjB,CAAAH,KAAA;UAEF;QACF;QAEI,IAAAA,KAAA,CAAAI,MAAW;UACf,IAAAC,cAAA;UACAZ,YAAA,CAAAa,MAAA,CAAA7C,MAAA,CAAAV,YAAA;UACA,IAAA0C,YAAA,CAAAc,IAAA;YACAjB,UAAA,CAAAa,IAAA,CAAAH,KAAA;YACA;UACA;UACA,IAAAQ,OAAA,IACA,GAAAf,YAAoB,CAAAgB,MAAA,GACpB;UACFnB,UAAA,CAAAa,IAAA,EAAAE,cAAA,GAAAG,OAAA,CAAAE,IAAA,WAAAC,SAAA;YAIO,OAAAA,SAAA,CAAAP,MAAA;UACT,gBAAAC,cAAA,cAAAA,cAAA,GAAAG,OAAA","ignoreList":[]}

package/dist/cjs/createZeroClient.cjs

@@ -204,11 +204,12 @@ function createZeroClientInternal({
   });
   const emitterScope = instanceName === "default" ? "" : `:${instanceName}`;
   const zeroEvents = (0, import_emitter.createEmitter)(`zero${emitterScope}`, null);
-  let recoverFromAckTimeout = () => {};
   const ackTimeoutRecoveryThreshold = Number.isFinite(serverAckTimeoutRecoveryThreshold) && serverAckTimeoutRecoveryThreshold >= 2 ? Math.floor(serverAckTimeoutRecoveryThreshold) : 2;
   const mutationLifecycle = (0, import_mutationLifecycle.createMutationLifecycle)({
     ackTimeoutRecoveryThreshold,
-    recoverFromAckTimeout: input => recoverFromAckTimeout(input)
+    recoverFromAckTimeout: input => {
+      void reconnectInPlace("server-ack-timeout", `${input.label} server acknowledgement timed out ${input.consecutiveTimeouts} consecutive times (${input.timeoutMs}ms each)`);
+    }
   });
   const zeroInstanceVersion = createDirectUseQuery ? (0, import_emitter.createEmitter)(`zero-instance-version${emitterScope}`, 0) : null;
   const AuthDataContext = (0, import_react2.createContext)({});
@@ -321,6 +322,30 @@ function createZeroClientInternal({
     bump();
     return true;
   }
+  function emitReconnectStatus(event) {
+    const current = zeroEvents.value;
+    if (current?.type === "reconnect" && current.status === event.status && ("reasonKey" in current ? current.reasonKey : void 0) === ("reasonKey" in event ? event.reasonKey : void 0) && ("reason" in current ? current.reason : void 0) === ("reason" in event ? event.reason : void 0)) {
+      return;
+    }
+    zeroEvents.emit(event);
+  }
+  async function reconnectInPlace(reasonKey, reason) {
+    emitReconnectStatus({
+      type: "reconnect",
+      status: "trying",
+      reasonKey,
+      reason
+    });
+    return remint({
+      dropLocalState: false
+    });
+  }
+  function reloadPage() {
+    const location = globalThis.location;
+    if (!location?.reload) return false;
+    location.reload();
+    return true;
+  }
   const DISABLED_ZERO_STUB_CONNECTION_STATE = {
     current: {
       name: "closed"
@@ -454,7 +479,6 @@ function createZeroClientInternal({
           onRecovery: () => mutationLifecycle.fence()
         };
         const recovery = (0, import_recoverZeroClient.makeZeroRecovery)(recoveryDeps);
-        recoverFromAckTimeout = recovery.onServerAckTimeout;
         const createdInstance = new import_zero.Zero({
           kvStore: "mem",
           ...options,
@@ -536,7 +560,13 @@ function createZeroClientInternal({
     const zeroInstance = (0, import_react.useZero)();
     const state = (0, import_react.useConnectionState)();
     const prevState = (0, import_react2.useRef)(state.name);
-    const staleReconnectRef = (0, import_react2.useRef)(null);
+    const hasConnectedRef = (0, import_react2.useRef)(false);
+    const currentReconnect = zeroEvents2.value?.type === "reconnect" && zeroEvents2.value.status !== "connected" ? zeroEvents2.value : null;
+    const reconnectRef = (0, import_react2.useRef)(currentReconnect ? {
+      reasonKey: currentReconnect.reasonKey,
+      reason: currentReconnect.reason
+    } : null);
+    const recoverableErrorRef = (0, import_react2.useRef)(null);
     const needsAuthRef = (0, import_react2.useRef)(false);
     (0, import_react2.useEffect)(() => {
       const name = state.name;
@@ -547,14 +577,56 @@ function createZeroClientInternal({
         if (reason) document.body.dataset.zeroReason = reason.slice(0, 200);else delete document.body.dataset.zeroReason;
         if (name === "connected") document.body.dataset.zeroConnected = "true";else delete document.body.dataset.zeroConnected;
       }
-      if (name === "error" && (0, import_recoverZeroClient.isRecoverableZeroStalePokeMessage)(reason)) {
-        if (staleReconnectRef.current !== reason) {
-          staleReconnectRef.current = reason;
+      if (name === "connected") {
+        hasConnectedRef.current = true;
+        recoverableErrorRef.current = null;
+        if (reconnectRef.current) {
+          reconnectRef.current = null;
+          emitReconnectStatus({
+            type: "reconnect",
+            status: "connected"
+          });
+        }
+      }
+      const reconnectReasonKey = reason.includes("ServerOverloaded") ? "server-overloaded" : reason.includes("Failed to fetch") || reason.includes("fetch failed") || reason.includes("NetworkError when attempting to fetch resource") || reason.includes("Network request failed") || reason.includes("Load failed") ? "transport" : void 0;
+      if (name === "error" && ((0, import_recoverZeroClient.isRecoverableZeroStalePokeMessage)(reason) || reconnectReasonKey)) {
+        if (recoverableErrorRef.current !== reason) {
+          recoverableErrorRef.current = reason;
+          reconnectRef.current = {
+            reasonKey: reconnectReasonKey ?? "transport",
+            reason
+          };
+          emitReconnectStatus({
+            type: "reconnect",
+            status: "trying",
+            ...reconnectRef.current
+          });
           void Promise.resolve(zeroInstance.connection?.connect?.()).catch(() => {});
         }
         return;
       }
-      if (name !== "error") staleReconnectRef.current = null;
+      if (name !== "error") recoverableErrorRef.current = null;
+      if (name === "connecting" && (reconnectRef.current || hasConnectedRef.current || Boolean(reason))) {
+        reconnectRef.current = {
+          reasonKey: reconnectReasonKey ?? reconnectRef.current?.reasonKey ?? "transport",
+          reason: reason || reconnectRef.current?.reason || "connection interrupted"
+        };
+        emitReconnectStatus({
+          type: "reconnect",
+          status: reason ? "waiting" : "trying",
+          ...reconnectRef.current
+        });
+      } else if (name === "disconnected" && (reconnectRef.current || hasConnectedRef.current)) {
+        reconnectRef.current = {
+          reasonKey: reconnectRef.current?.reasonKey ?? "transport",
+          reason: reason || reconnectRef.current?.reason || "connection interrupted"
+        };
+        emitReconnectStatus({
+          type: "reconnect",
+          status: "waiting",
+          ...reconnectRef.current
+        });
+      }
       if (name === "needs-auth") {
         if (refreshAuth && !needsAuthRef.current) {
           needsAuthRef.current = true;
@@ -612,6 +684,7 @@ function createZeroClientInternal({
   return {
     instanceName,
     zeroEvents,
+    reloadPage,
     ProvideZero,
     ControlQueries,
     useQuery,

package/dist/cjs/createZeroClient.connection.test.cjs

@@ -178,6 +178,73 @@ async function mount(extraProps = {}, userID = "conn") {
   (0, import_vitest.expect)(events.some(event => event.type === "error")).toBe(false);
   off();
 });
+(0, import_vitest.test)("transport error reconnects in place and publishes trying status", async () => {
+  const events = [];
+  const off = client.zeroEvents.listen(event => {
+    if (event) events.push(event);
+  });
+  const instance = await mount({}, "conn-transport");
+  await (0, import_react.act)(async () => {
+    instance.connection.state.set({
+      name: "error",
+      reason: "Unexpected internal error: Failed to fetch"
+    });
+    await Promise.resolve();
+  });
+  (0, import_vitest.expect)(instance.connection.connect).toHaveBeenCalledTimes(1);
+  (0, import_vitest.expect)(events).toContainEqual({
+    type: "reconnect",
+    status: "trying",
+    reasonKey: "transport",
+    reason: "Unexpected internal error: Failed to fetch"
+  });
+  (0, import_vitest.expect)(events.some(event => event.type === "error")).toBe(false);
+  await (0, import_react.act)(async () => {
+    instance.connection.state.set({
+      name: "connected"
+    });
+    await Promise.resolve();
+  });
+  (0, import_vitest.expect)(events).toContainEqual({
+    type: "reconnect",
+    status: "connected"
+  });
+  off();
+});
+(0, import_vitest.test)("server overload publishes waiting status while Zero owns retry backoff", async () => {
+  const events = [];
+  const off = client.zeroEvents.listen(event => {
+    if (event) events.push(event);
+  });
+  const instance = await mount({}, "conn-overload");
+  await (0, import_react.act)(async () => {
+    instance.connection.state.set({
+      name: "connecting",
+      reason: "ServerOverloaded: retry later"
+    });
+    await Promise.resolve();
+  });
+  (0, import_vitest.expect)(instance.connection.connect).not.toHaveBeenCalled();
+  (0, import_vitest.expect)(events).toContainEqual({
+    type: "reconnect",
+    status: "waiting",
+    reasonKey: "server-overloaded",
+    reason: "ServerOverloaded: retry later"
+  });
+  await (0, import_react.act)(async () => {
+    instance.connection.state.set({
+      name: "connecting"
+    });
+    await Promise.resolve();
+  });
+  (0, import_vitest.expect)(events).toContainEqual({
+    type: "reconnect",
+    status: "trying",
+    reasonKey: "server-overloaded",
+    reason: "ServerOverloaded: retry later"
+  });
+  off();
+});
 (0, import_vitest.test)("connectionDataset mirrors connection state onto the body dataset", async () => {
   const instance = await mount({
     connectionDataset: true

package/dist/cjs/createZeroClient.connection.test.native.js

@@ -252,6 +252,75 @@ async function mount() {
   })).toBe(false);
   off();
 });
+(0, import_vitest.test)("transport error reconnects in place and publishes trying status", async function () {
+  var events = [];
+  var off = client.zeroEvents.listen(function (event) {
+    if (event) events.push(event);
+  });
+  var instance = await mount({}, "conn-transport");
+  await (0, import_react.act)(async function () {
+    instance.connection.state.set({
+      name: "error",
+      reason: "Unexpected internal error: Failed to fetch"
+    });
+    await Promise.resolve();
+  });
+  (0, import_vitest.expect)(instance.connection.connect).toHaveBeenCalledTimes(1);
+  (0, import_vitest.expect)(events).toContainEqual({
+    type: "reconnect",
+    status: "trying",
+    reasonKey: "transport",
+    reason: "Unexpected internal error: Failed to fetch"
+  });
+  (0, import_vitest.expect)(events.some(function (event) {
+    return event.type === "error";
+  })).toBe(false);
+  await (0, import_react.act)(async function () {
+    instance.connection.state.set({
+      name: "connected"
+    });
+    await Promise.resolve();
+  });
+  (0, import_vitest.expect)(events).toContainEqual({
+    type: "reconnect",
+    status: "connected"
+  });
+  off();
+});
+(0, import_vitest.test)("server overload publishes waiting status while Zero owns retry backoff", async function () {
+  var events = [];
+  var off = client.zeroEvents.listen(function (event) {
+    if (event) events.push(event);
+  });
+  var instance = await mount({}, "conn-overload");
+  await (0, import_react.act)(async function () {
+    instance.connection.state.set({
+      name: "connecting",
+      reason: "ServerOverloaded: retry later"
+    });
+    await Promise.resolve();
+  });
+  (0, import_vitest.expect)(instance.connection.connect).not.toHaveBeenCalled();
+  (0, import_vitest.expect)(events).toContainEqual({
+    type: "reconnect",
+    status: "waiting",
+    reasonKey: "server-overloaded",
+    reason: "ServerOverloaded: retry later"
+  });
+  await (0, import_react.act)(async function () {
+    instance.connection.state.set({
+      name: "connecting"
+    });
+    await Promise.resolve();
+  });
+  (0, import_vitest.expect)(events).toContainEqual({
+    type: "reconnect",
+    status: "trying",
+    reasonKey: "server-overloaded",
+    reason: "ServerOverloaded: retry later"
+  });
+  off();
+});
 (0, import_vitest.test)("connectionDataset mirrors connection state onto the body dataset", async function () {
   var instance = await mount({
     connectionDataset: true

package/dist/cjs/createZeroClient.connection.test.native.js.map

@@ -1 +1 @@
-{"version":3,"names":["import_jsx_runtime","require","import_zero","import_react","import_client","import_vitest","import_createZeroClient","_class_call_check","instance","Constructor","TypeError","_defineProperties","target","props","i","length","descriptor","enumerable","configurable","writable","Object","defineProperty","key","_create_class","protoProps","staticProps","prototype","_define_property","obj","value","fakeZero","vi","hoisted","FakeConnectionState","FakeConnectionState2","initial","_this","Set","cb","listeners","add","delete","current","set","next","_iteratorNormalCompletion","_didIteratorError","_iteratorError","_iterator","Symbol","iterator","_step","done","err","return","FakeZero","FakeZero2","state","name","connect","fn","errors","cleanup","complete","Promise","resolve","instances","push","mock","importOriginal","actual","Zero","globalThis","IS_REACT_ACT_ENVIRONMENT","noteTable","table","columns","id","string","body","primaryKey","schema","createSchema","tables","client","createZeroClient","models","groupedQueries","instanceName","container","root","beforeEach","document","createElement","dataset","zeroState","zeroConnected","zeroReason","afterEach","act","unmount","mount","extraProps","arguments","userID","createRoot","render","jsx","ProvideZero","cacheURL","children","at","test","readinessClient","ready","waitForZero","expect","toBe","install","transport","toHaveBeenCalledOnce","toHaveBeenCalledWith","refreshAuth"],"sources":["../../src/createZeroClient.connection.test.tsx"],"sourcesContent":[null],"mappings":"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","ignoreList":[]}
+{"version":3,"names":["import_jsx_runtime","require","import_zero","import_react","import_client","import_vitest","import_createZeroClient","_class_call_check","instance","Constructor","TypeError","_defineProperties","target","props","i","length","descriptor","enumerable","configurable","writable","Object","defineProperty","key","_create_class","protoProps","staticProps","prototype","_define_property","obj","value","fakeZero","vi","hoisted","FakeConnectionState","FakeConnectionState2","initial","_this","Set","cb","listeners","add","delete","current","set","next","_iteratorNormalCompletion","_didIteratorError","_iteratorError","_iterator","Symbol","iterator","_step","done","err","return","FakeZero","FakeZero2","state","name","connect","fn","errors","cleanup","complete","Promise","resolve","instances","push","mock","importOriginal","actual","Zero","globalThis","IS_REACT_ACT_ENVIRONMENT","noteTable","table","columns","id","string","body","primaryKey","schema","createSchema","tables","client","createZeroClient","models","groupedQueries","instanceName","container","root","beforeEach","document","createElement","dataset","zeroState","zeroConnected","zeroReason","afterEach","act","unmount","mount","extraProps","arguments","userID","createRoot","render","jsx","ProvideZero","cacheURL","children","at","test","readinessClient","ready","waitForZero","expect","toBe","install","transport","toHaveBeenCalledOnce","toHaveBeenCalledWith","refreshAuth","events","off","zeroEvents","listen","event","connection","reason","toHaveBeenCalledTimes","auth","toContainEqual","type","reasonKey","message","some"],"sources":["../../src/createZeroClient.connection.test.tsx"],"sourcesContent":[null],"mappings":"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","ignoreList":[]}

package/dist/cjs/createZeroClient.native.js

@@ -335,12 +335,11 @@ function createZeroClientInternal(param) {
   });
   var emitterScope = instanceName === "default" ? "" : `:${instanceName}`;
   var zeroEvents = (0, import_emitter.createEmitter)(`zero${emitterScope}`, null);
-  var recoverFromAckTimeout = function recoverFromAckTimeout2() {};
   var ackTimeoutRecoveryThreshold = Number.isFinite(serverAckTimeoutRecoveryThreshold) && serverAckTimeoutRecoveryThreshold >= 2 ? Math.floor(serverAckTimeoutRecoveryThreshold) : 2;
   var mutationLifecycle = (0, import_mutationLifecycle.createMutationLifecycle)({
     ackTimeoutRecoveryThreshold,
-    recoverFromAckTimeout: function recoverFromAckTimeout1(input) {
-      return recoverFromAckTimeout(input);
+    recoverFromAckTimeout: function recoverFromAckTimeout(input) {
+      void reconnectInPlace("server-ack-timeout", `${input.label} server acknowledgement timed out ${input.consecutiveTimeouts} consecutive times (${input.timeoutMs}ms each)`);
     }
   });
   var zeroInstanceVersion = createDirectUseQuery ? (0, import_emitter.createEmitter)(`zero-instance-version${emitterScope}`, 0) : null;
@@ -461,6 +460,30 @@ function createZeroClientInternal(param) {
     bump();
     return true;
   }
+  function emitReconnectStatus(event) {
+    var current = zeroEvents.value;
+    if ((current === null || current === void 0 ? void 0 : current.type) === "reconnect" && current.status === event.status && ("reasonKey" in current ? current.reasonKey : void 0) === ("reasonKey" in event ? event.reasonKey : void 0) && ("reason" in current ? current.reason : void 0) === ("reason" in event ? event.reason : void 0)) {
+      return;
+    }
+    zeroEvents.emit(event);
+  }
+  async function reconnectInPlace(reasonKey, reason) {
+    emitReconnectStatus({
+      type: "reconnect",
+      status: "trying",
+      reasonKey,
+      reason
+    });
+    return remint({
+      dropLocalState: false
+    });
+  }
+  function reloadPage() {
+    var location = globalThis.location;
+    if (!(location === null || location === void 0 ? void 0 : location.reload)) return false;
+    location.reload();
+    return true;
+  }
   var DISABLED_ZERO_STUB_CONNECTION_STATE = {
     current: {
       name: "closed"
@@ -633,7 +656,6 @@ function createZeroClientInternal(param) {
           }
         };
         var recovery = (0, import_recoverZeroClient.makeZeroRecovery)(recoveryDeps);
-        recoverFromAckTimeout = recovery.onServerAckTimeout;
         var createdInstance = new import_zero.Zero({
           kvStore: "mem",
           ...options,
@@ -741,10 +763,17 @@ function createZeroClientInternal(param) {
       exposeDataset,
       datasetCacheUrl
     } = param2;
+    var _zeroEvents_value;
     var zeroInstance = (0, import_react.useZero)();
     var state = (0, import_react.useConnectionState)();
     var prevState = (0, import_react2.useRef)(state.name);
-    var staleReconnectRef = (0, import_react2.useRef)(null);
+    var hasConnectedRef = (0, import_react2.useRef)(false);
+    var currentReconnect = ((_zeroEvents_value = zeroEvents2.value) === null || _zeroEvents_value === void 0 ? void 0 : _zeroEvents_value.type) === "reconnect" && zeroEvents2.value.status !== "connected" ? zeroEvents2.value : null;
+    var reconnectRef = (0, import_react2.useRef)(currentReconnect ? {
+      reasonKey: currentReconnect.reasonKey,
+      reason: currentReconnect.reason
+    } : null);
+    var recoverableErrorRef = (0, import_react2.useRef)(null);
     var needsAuthRef = (0, import_react2.useRef)(false);
     (0, import_react2.useEffect)(function () {
       var name = state.name;
@@ -755,15 +784,61 @@ function createZeroClientInternal(param) {
         if (reason) document.body.dataset.zeroReason = reason.slice(0, 200);else delete document.body.dataset.zeroReason;
         if (name === "connected") document.body.dataset.zeroConnected = "true";else delete document.body.dataset.zeroConnected;
       }
-      if (name === "error" && (0, import_recoverZeroClient.isRecoverableZeroStalePokeMessage)(reason)) {
-        if (staleReconnectRef.current !== reason) {
+      if (name === "connected") {
+        hasConnectedRef.current = true;
+        recoverableErrorRef.current = null;
+        if (reconnectRef.current) {
+          reconnectRef.current = null;
+          emitReconnectStatus({
+            type: "reconnect",
+            status: "connected"
+          });
+        }
+      }
+      var reconnectReasonKey = reason.includes("ServerOverloaded") ? "server-overloaded" : reason.includes("Failed to fetch") || reason.includes("fetch failed") || reason.includes("NetworkError when attempting to fetch resource") || reason.includes("Network request failed") || reason.includes("Load failed") ? "transport" : void 0;
+      if (name === "error" && ((0, import_recoverZeroClient.isRecoverableZeroStalePokeMessage)(reason) || reconnectReasonKey)) {
+        if (recoverableErrorRef.current !== reason) {
           var _zeroInstance_connection_connect, _zeroInstance_connection;
-          staleReconnectRef.current = reason;
+          recoverableErrorRef.current = reason;
+          reconnectRef.current = {
+            reasonKey: reconnectReasonKey !== null && reconnectReasonKey !== void 0 ? reconnectReasonKey : "transport",
+            reason
+          };
+          emitReconnectStatus({
+            type: "reconnect",
+            status: "trying",
+            ...reconnectRef.current
+          });
           void Promise.resolve((_zeroInstance_connection = zeroInstance.connection) === null || _zeroInstance_connection === void 0 ? void 0 : (_zeroInstance_connection_connect = _zeroInstance_connection.connect) === null || _zeroInstance_connection_connect === void 0 ? void 0 : _zeroInstance_connection_connect.call(_zeroInstance_connection)).catch(function () {});
         }
         return;
       }
-      if (name !== "error") staleReconnectRef.current = null;
+      if (name !== "error") recoverableErrorRef.current = null;
+      if (name === "connecting" && (reconnectRef.current || hasConnectedRef.current || Boolean(reason))) {
+        var _ref;
+        var _reconnectRef_current, _reconnectRef_current1;
+        reconnectRef.current = {
+          reasonKey: (_ref = reconnectReasonKey !== null && reconnectReasonKey !== void 0 ? reconnectReasonKey : (_reconnectRef_current = reconnectRef.current) === null || _reconnectRef_current === void 0 ? void 0 : _reconnectRef_current.reasonKey) !== null && _ref !== void 0 ? _ref : "transport",
+          reason: reason || ((_reconnectRef_current1 = reconnectRef.current) === null || _reconnectRef_current1 === void 0 ? void 0 : _reconnectRef_current1.reason) || "connection interrupted"
+        };
+        emitReconnectStatus({
+          type: "reconnect",
+          status: reason ? "waiting" : "trying",
+          ...reconnectRef.current
+        });
+      } else if (name === "disconnected" && (reconnectRef.current || hasConnectedRef.current)) {
+        var _ref1;
+        var _reconnectRef_current2, _reconnectRef_current3;
+        reconnectRef.current = {
+          reasonKey: (_ref1 = (_reconnectRef_current2 = reconnectRef.current) === null || _reconnectRef_current2 === void 0 ? void 0 : _reconnectRef_current2.reasonKey) !== null && _ref1 !== void 0 ? _ref1 : "transport",
+          reason: reason || ((_reconnectRef_current3 = reconnectRef.current) === null || _reconnectRef_current3 === void 0 ? void 0 : _reconnectRef_current3.reason) || "connection interrupted"
+        };
+        emitReconnectStatus({
+          type: "reconnect",
+          status: "waiting",
+          ...reconnectRef.current
+        });
+      }
       if (name === "needs-auth") {
         if (refreshAuth && !needsAuthRef.current) {
           needsAuthRef.current = true;
@@ -823,6 +898,7 @@ function createZeroClientInternal(param) {
   return {
     instanceName,
     zeroEvents,
+    reloadPage,
     ProvideZero,
     ControlQueries,
     useQuery,