@gusnips/react 0.9.21 → 0.9.23

package/README.md

@@ -396,7 +396,8 @@ adopter writing `fix={hint}` at every error surface.
 `recover` is derived from `shouldRetry` — the same rule react-query retries on — so the button a
 reader sees and the retry that actually happens cannot disagree. Give it the same
 `durableLimitCodes` list you give `queryDefaults`, and a spent quota offers no button instead of
-one that cannot work.
+one that cannot work. The words follow it too: "try again in a moment" appears only on a 5xx that
+react-query would retry by itself, so never beside a durable refusal or a long countdown.
 
 `formatWait` says how a stated wait becomes words:
 

package/dist/api-error.d.ts

@@ -1,4 +1,4 @@
-import type { ApiError as ApiErrorBody } from "@gusnips/http";
+import type { ApiErrorBody } from "@gusnips/http";
 /**
  * A refusal, with the whole envelope intact.
  *

package/dist/api-error.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"api-error.d.ts","sourceRoot":"","sources":["../src/api-error.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,IAAI,YAAY,EAAE,MAAM,eAAe,CAAC;AAE9D;;;;;;;;;;GAUG;AACH,qBAAa,QAAS,SAAQ,KAAK;IACjC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,SAAS,CAAC;IAClC,QAAQ,CAAC,UAAU,EAAE,MAAM,GAAG,SAAS,CAAC;IACxC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAAC,GAAG,SAAS,CAAC;IAC7D,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;IAC1B,QAAQ,CAAC,SAAS,EAAE,MAAM,GAAG,SAAS,CAAC;IACvC;;;;;;;;;OASG;IACH,QAAQ,CAAC,cAAc,EAAE,MAAM,GAAG,SAAS,CAAC;IAE5C;;;;;;;;OAQG;IACH,QAAQ,CAAC,QAAQ,EAAE,OAAO,CAAC;gBAGzB,MAAM,EAAE,MAAM,EACd,IAAI,EAAE,YAAY,CAAC,OAAO,CAAC,GAAG,IAAI,EAClC,IAAI,GAAE;QACJ,SAAS,CAAC,EAAE,MAAM,CAAC;QACnB,QAAQ,CAAC,EAAE,OAAO,CAAC;QACnB,OAAO,CAAC,EAAE,MAAM,CAAC;QACjB,cAAc,CAAC,EAAE,MAAM,CAAC;KACpB;CAaT;AAED;;;;;;;GAOG;AACH,wBAAgB,YAAY,CAAC,KAAK,EAAE,OAAO,GAAG,OAAO,CAEpD"}
+{"version":3,"file":"api-error.d.ts","sourceRoot":"","sources":["../src/api-error.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,eAAe,CAAC;AAElD;;;;;;;;;;GAUG;AACH,qBAAa,QAAS,SAAQ,KAAK;IACjC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,SAAS,CAAC;IAClC,QAAQ,CAAC,UAAU,EAAE,MAAM,GAAG,SAAS,CAAC;IACxC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAAC,GAAG,SAAS,CAAC;IAC7D,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;IAC1B,QAAQ,CAAC,SAAS,EAAE,MAAM,GAAG,SAAS,CAAC;IACvC;;;;;;;;;OASG;IACH,QAAQ,CAAC,cAAc,EAAE,MAAM,GAAG,SAAS,CAAC;IAE5C;;;;;;;;OAQG;IACH,QAAQ,CAAC,QAAQ,EAAE,OAAO,CAAC;gBAGzB,MAAM,EAAE,MAAM,EACd,IAAI,EAAE,YAAY,CAAC,OAAO,CAAC,GAAG,IAAI,EAClC,IAAI,GAAE;QACJ,SAAS,CAAC,EAAE,MAAM,CAAC;QACnB,QAAQ,CAAC,EAAE,OAAO,CAAC;QACnB,OAAO,CAAC,EAAE,MAAM,CAAC;QACjB,cAAc,CAAC,EAAE,MAAM,CAAC;KACpB;CAaT;AAED;;;;;;;GAOG;AACH,wBAAgB,YAAY,CAAC,KAAK,EAAE,OAAO,GAAG,OAAO,CAEpD"}

package/dist/describe-error.js

@@ -74,15 +74,28 @@ export function createErrorDescriber(options) {
         if (error.status === 401)
             return "signin";
         // It named its own expiry, so there is a real number to count down beside a disabled button.
+        // Before the durable list on purpose: a server that says when a refusal clears is believed
+        // (invariant 8). "wait" is a countdown the reader watches, not a request anyone sends, so a
+        // durable quota that resets in an hour is honest as one. Whether the query layer should wait
+        // that hour by itself is a different question, and `shouldRetry` answers it: no.
         if (waitSecs !== null)
             return "wait";
         return shouldRetry(error, durableLimitCodes, maxRetryWaitSecs) ? "retry" : "none";
     }
     /**
      * Anything `codes` does not name. The server's own sentence is still the most specific thing
-     * we have, and support can act on it. A 5xx additionally gets "try again shortly", because that
-     * one genuinely does clear on its own — a 4xx does not, and saying so would be a lie that costs
-     * the reader another attempt.
+     * we have, and support can act on it. A 5xx additionally gets "try again shortly" — but only
+     * when `recover` says trying can work. A 503 whose code is on `durableLimitCodes` clears with a
+     * deploy, never a wait, and "try again in a moment" above no button is two answers to one
+     * question: the drift `recover` exists to prevent, arriving through the words instead. One
+     * adopter's checkout said "…write to us. Try again in a moment." with `recover: "none"`.
+     *
+     * A stated wait gets the line only while it is a moment: short enough that `shouldRetry` waits
+     * it out itself (`maxRetryWaitSecs`). Past that, "in a moment" over an hour's countdown is wrong
+     * the other way round, so the countdown carries it alone and an arm with `ctx.wait` can say when.
+     *
+     * A 4xx gets nothing here even where the rule retries it (408, 425, a 429). A 429 usually states
+     * its wait, and those words belong to an arm for the same reason.
      *
      * No `code` means no envelope, and then `message` is not the server's: it is the client's own
      * `Request failed (502)`, written for a log. A gateway answering with HTML while the API
@@ -93,9 +106,13 @@ export function createErrorDescriber(options) {
      * `fallback`.
      */
     const unmapped = fallback ??
-        (({ error, says }) => ({
+        (({ error, says, recover }) => ({
             cause: says ?? ((error.code === undefined ? "" : error.message) || copyOf("unexpected")),
-            fix: error.status >= 500 ? copyOf("retrySoon") : undefined,
+            fix: error.status >= 500 &&
+                (recover === "retry" ||
+                    (recover === "wait" && shouldRetry(error, durableLimitCodes, maxRetryWaitSecs)))
+                ? copyOf("retrySoon")
+                : undefined,
         }));
     return function describeError(error) {
         if (!(error instanceof ApiError)) {

package/dist/describe-error.js.map

@@ -1 +1 @@
-{"version":3,"file":"describe-error.js","sourceRoot":"","sources":["../src/describe-error.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"describe-error.js","sourceRoot":"","sources":["../src/describe-error.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AACrD,OAAO,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAC1C,OAAO,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AA2GzC,MAAM,aAAa,GAAG,iCAAiC,CAAC;AA2BxD;;;;;;;;;;;;GAYG;AACH,MAAM,UAAU,YAAY,CAC1B,CAAoC,EACpC,IAAY,EACZ,MAAc;IAEd,+FAA+F;IAC/F,+BAA+B;IAC/B,IAAI,IAAI,GAAG,EAAE;QAAE,OAAO,CAAC,CAAC,GAAG,MAAM,aAAa,EAAE,EAAE,KAAK,EAAE,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,EAAE,CAAC,CAAC;IACzF,IAAI,IAAI,GAAG,EAAE,GAAG,EAAE;QAAE,OAAO,CAAC,CAAC,GAAG,MAAM,aAAa,EAAE,EAAE,KAAK,EAAE,IAAI,CAAC,IAAI,CAAC,IAAI,GAAG,EAAE,CAAC,EAAE,CAAC,CAAC;IACtF,OAAO,CAAC,CAAC,GAAG,MAAM,WAAW,EAAE,EAAE,KAAK,EAAE,IAAI,CAAC,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC,EAAE,CAAC,CAAC;AACpE,CAAC;AAkJD,SAAS,eAAe,CAItB,EACA,CAAC,EACD,UAAU,EACV,gBAAgB,EAChB,gBAAgB,EAChB,cAAc,GAAG,CAAC,MAAM,EAAE,EAAE,CAAC,MAAM,GACqB;IACxD,6FAA6F;IAC7F,kFAAkF;IAClF,MAAM,KAAK,GAAG,IAAI,GAAG,EAAU,CAAC;IAChC,KAAK,MAAM,IAAI,IAAI,MAAM,CAAC,IAAI,CAAC,gBAAgB,CAAC,EAAE,CAAC;QACjD,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;QAChB,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC,OAAO,CAAC,aAAa,EAAE,EAAE,CAAC,CAAC,CAAC;IAC7C,CAAC;IAED,6FAA6F;IAC7F,2EAA2E;IAC3E,MAAM,GAAG,GAAG,CAAC,IAAY,EAA+C,EAAE,CAAC,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;IAE3F,OAAO;QACL,MAAM,EAAE,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC,CAAC,GAAG,UAAU,GAAG,IAAI,EAAE,CAAC;QAC3C,cAAc,CAAC,KAAK;YAClB,MAAM,MAAM,GAAG,CAAC,KAAyB,EAAiB,EAAE;gBAC1D,IAAI,KAAK,KAAK,SAAS,IAAI,CAAC,KAAK,CAAC,UAAU,CAAC,gBAAgB,CAAC;oBAAE,OAAO,IAAI,CAAC;gBAC5E,MAAM,IAAI,GAAG,KAAK,CAAC,KAAK,CAAC,gBAAgB,CAAC,MAAM,CAAC,CAAC;gBAClD,OAAO,GAAG,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,gBAAgB,GAAG,IAAI,EAAE,EAAE,cAAc,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;YAC1F,CAAC,CAAC;YACF,wFAAwF;YACxF,4FAA4F;YAC5F,kDAAkD;YAClD,OAAO,CACL,MAAM,CAAC,KAAK,CAAC,UAAU,CAAC;gBACxB,CAAC,KAAK,CAAC,IAAI,KAAK,SAAS,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,gBAAgB,GAAG,KAAK,CAAC,IAAI,EAAE,CAAC,CAAC,CAC/E,CAAC;QACJ,CAAC;KACF,CAAC;AACJ,CAAC;AAcD,MAAM,UAAU,oBAAoB,CAKlC,OAA8F;IAE9F,MAAM,EAAE,UAAU,EAAE,KAAK,GAAG,EAAE,EAAE,QAAQ,EAAE,iBAAiB,GAAG,EAAE,EAAE,gBAAgB,EAAE,GAAG,OAAO,CAAC;IAC/F,MAAM,EAAE,MAAM,EAAE,cAAc,EAAE,GAC9B,MAAM,IAAI,OAAO;QACf,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,IAAI,EAAE,EAAE,CAAC,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,cAAc,EAAE,GAAG,EAAE,CAAC,IAAI,EAAE;QACtE,CAAC,CAAC,eAAe,CAAC,OAAO,CAAC,CAAC;IAE/B;;;;;OAKG;IACH,SAAS,WAAW,CAAC,KAAe,EAAE,QAAuB;QAC3D,6FAA6F;QAC7F,0FAA0F;QAC1F,kFAAkF;QAClF,IAAI,KAAK,CAAC,QAAQ;YAAE,OAAO,MAAM,CAAC;QAClC,6FAA6F;QAC7F,0FAA0F;QAC1F,IAAI,KAAK,CAAC,MAAM,KAAK,GAAG;YAAE,OAAO,QAAQ,CAAC;QAC1C,6FAA6F;QAC7F,2FAA2F;QAC3F,4FAA4F;QAC5F,6FAA6F;QAC7F,iFAAiF;QACjF,IAAI,QAAQ,KAAK,IAAI;YAAE,OAAO,MAAM,CAAC;QACrC,OAAO,WAAW,CAAC,KAAK,EAAE,iBAAiB,EAAE,gBAAgB,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC;IACpF,CAAC;IAED;;;;;;;;;;;;;;;;;;;;;;OAsBG;IACH,MAAM,QAAQ,GACZ,QAAQ;QACR,CAAC,CAAC,EAAE,KAAK,EAAE,IAAI,EAAE,OAAO,EAAE,EAAE,EAAE,CAAC,CAAC;YAC9B,KAAK,EAAE,IAAI,IAAI,CAAC,CAAC,KAAK,CAAC,IAAI,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,IAAI,MAAM,CAAC,YAAY,CAAC,CAAC;YACxF,GAAG,EACD,KAAK,CAAC,MAAM,IAAI,GAAG;gBACnB,CAAC,OAAO,KAAK,OAAO;oBAClB,CAAC,OAAO,KAAK,MAAM,IAAI,WAAW,CAAC,KAAK,EAAE,iBAAiB,EAAE,gBAAgB,CAAC,CAAC,CAAC;gBAChF,CAAC,CAAC,MAAM,CAAC,WAAW,CAAC;gBACrB,CAAC,CAAC,SAAS;SAChB,CAAC,CAAC,CAAC;IAEN,OAAO,SAAS,aAAa,CAAC,KAAc;QAC1C,IAAI,CAAC,CAAC,KAAK,YAAY,QAAQ,CAAC,EAAE,CAAC;YACjC,0FAA0F;YAC1F,4FAA4F;YAC5F,qEAAqE;YACrE,OAAO;gBACL,KAAK,EAAE,MAAM,CAAC,SAAS,CAAC;gBACxB,uFAAuF;gBACvF,kFAAkF;gBAClF,GAAG,EAAE,MAAM,CAAC,aAAa,CAAC;gBAC1B,OAAO,EAAE,OAAO;aACjB,CAAC;QACJ,CAAC;QAED,MAAM,QAAQ,GAAG,cAAc,CAAC,KAAK,CAAC,CAAC;QACvC,MAAM,GAAG,GAAiB;YACxB,KAAK;YACL,IAAI,EAAE,cAAc,CAAC,KAAK,CAAC;YAC3B,IAAI,EAAE,QAAQ,KAAK,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,UAAU,CAAC,QAAQ,CAAC;YACrD,QAAQ;YACR,OAAO,EAAE,WAAW,CAAC,KAAK,EAAE,QAAQ,CAAC;SACtC,CAAC;QAEF,MAAM,GAAG,GAAG,CAAC,KAAK,CAAC,IAAI,KAAK,SAAS,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,KAAK,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,IAAI,QAAQ,CAAC;QACnF,MAAM,IAAI,GAAc,GAAG,CAAC,GAAG,CAAC,CAAC;QAEjC,2FAA2F;QAC3F,sFAAsF;QACtF,0DAA0D;QAC1D,MAAM,SAAS,GAAG,IAAI,CAAC,SAAS,IAAI,KAAK,CAAC,SAAS,CAAC;QACpD,OAAO;YACL,GAAG,IAAI;YACP,OAAO,EAAE,IAAI,CAAC,OAAO,IAAI,GAAG,CAAC,OAAO;YACpC,GAAG,CAAC,SAAS,KAAK,SAAS,IAAI,EAAE,SAAS,EAAE,CAAC;SAC9C,CAAC;IACJ,CAAC,CAAC;AACJ,CAAC"}

package/dist/query.js

@@ -1,4 +1,4 @@
-import { retryDelayMs as delayFor, shouldRetry as retryRule } from "@gusnips/http/retry";
+import { retryDelayMs as delayFor, isRetryable as retryRule } from "@gusnips/http/retry";
 import { ApiError } from "./api-error.js";
 /**
  * Should this failure be retried?

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@gusnips/react",
-  "version": "0.9.21",
+  "version": "0.9.23",
   "description": "The headless runtime under a Vite + React SPA: typed fetch client with single-flight refresh, auth store, query defaults, route guards, error boundary, stale-tab recovery, i18n bootstrap.",
   "type": "module",
   "license": "MIT",
@@ -69,7 +69,7 @@
   ],
   "scripts": {
     "build": "rm -rf dist && tsc",
-    "typecheck": "tsc --noEmit && tsc -p typecheck",
+    "typecheck": "tsc --noEmit && tsc -p tsconfig.test.json",
     "test": "vitest run --passWithNoTests",
     "test:watch": "vitest",
     "lint": "eslint src",
@@ -80,7 +80,7 @@
     "release:major": "bun pm version major && bun publish --access public"
   },
   "dependencies": {
-    "@gusnips/http": "0.1.6",
+    "@gusnips/http": "0.2.0",
     "clsx": "^2.1.1",
     "tailwind-merge": "^3.6.0"
   },
@@ -125,6 +125,7 @@
     "@base-ui/react": "^1.8.0",
     "@supabase/supabase-js": "^2.112.4",
     "@tanstack/react-query": "^5.102.8",
+    "@types/node": "^24.12.0",
     "@types/react": "^19.2.14",
     "@types/react-dom": "^19.2.3",
     "happy-dom": "^20.14.5",

package/src/api-error.ts

@@ -1,4 +1,4 @@
-import type { ApiError as ApiErrorBody } from "@gusnips/http";
+import type { ApiErrorBody } from "@gusnips/http";
 
 /**
  * A refusal, with the whole envelope intact.

package/src/describe-error.test.ts

@@ -152,8 +152,8 @@ describe("createErrorDescriber", () => {
   });
 
   it("offers a retry on a 5xx and withholds it on a 4xx", () => {
-    // A 5xx genuinely clears on its own. A 4xx does not, and saying so would cost the reader
-    // another attempt for nothing.
+    // A plain 5xx clears on its own. A 403 does not, and saying so would cost the reader another
+    // attempt for nothing.
     expect(describeError(new ApiError(503, null)).fix).toBe("errors.retrySoon");
     expect(describeError(new ApiError(403, null)).fix).toBeUndefined();
   });
@@ -178,7 +178,7 @@ describe("the recovery kind", () => {
     copyPrefix: "errors.",
     messageKeyPrefix: "serverErrors.",
     knownMessageKeys: { quotaDay: "" },
-    durableLimitCodes: ["QUOTA_EXCEEDED"],
+    durableLimitCodes: ["QUOTA_EXCEEDED", "NOT_CONFIGURED"],
     formatWait: (secs) => humanizeWait(t, secs, "errors."),
   });
 
@@ -223,6 +223,37 @@ describe("the recovery kind", () => {
     expect(describeError(error).recover).toBe("retry");
   });
 
+  it("never says to try again beside a 5xx the rule will not retry", () => {
+    // A 503 only a deploy clears. "Try again in a moment" over no button is the same two answers
+    // to one question, reached through the words instead of the control.
+    const durable = describeError(new ApiError(503, { code: "NOT_CONFIGURED", message: "off" }));
+    expect(durable.recover).toBe("none");
+    expect(durable.fix).toBeUndefined();
+    // The server can say it too, with an explicit `null` wait, and no list involved.
+    const never = describeError(
+      new ApiError(503, { code: "X", message: "", details: { retryAfterSecs: null } }),
+    );
+    expect(never.recover).toBe("none");
+    expect(never.fix).toBeUndefined();
+
+    expect(describeError(new ApiError(503, null))).toMatchObject({
+      recover: "retry",
+      fix: "errors.retrySoon",
+    });
+  });
+
+  it("says 'in a moment' over a countdown only when the wait is one", () => {
+    // An hour is not a moment. The countdown says when, and the words stay out of its way.
+    const long = describeError(new ApiError(503, null, { retryAfterSecs: 3600 }));
+    expect(long.recover).toBe("wait");
+    expect(long.fix).toBeUndefined();
+    // Short enough that react-query waits it out itself, so "in a moment" is true.
+    expect(describeError(new ApiError(503, null, { retryAfterSecs: 5 }))).toMatchObject({
+      recover: "wait",
+      fix: "errors.retrySoon",
+    });
+  });
+
   it("carries the request id the error contract reserves a slot for", () => {
     const error = new ApiError(500, null, { requestId: "req_123" });
     expect(describeError(error).reference).toBe("req_123");
@@ -341,7 +372,8 @@ describe("fallback", () => {
       { retryAfterSecs: 120 },
     );
     expect(describeError(error).fix).toBe('errors.retryIn(errors.waitMinutes({"count":2}))');
-    expect(createErrorDescriber(options)(error).fix).toBe("errors.retrySoon");
+    // Two minutes is past what the query layer waits out, so the built-in says nothing at all.
+    expect(createErrorDescriber(options)(error).fix).toBeUndefined();
   });
 
   it("leaves the derived recovery kind alone unless the arm narrows it", () => {

package/src/describe-error.ts

@@ -385,15 +385,28 @@ export function createErrorDescriber<
     // the session is fine and it is a different account that would help, so it falls through.
     if (error.status === 401) return "signin";
     // It named its own expiry, so there is a real number to count down beside a disabled button.
+    // Before the durable list on purpose: a server that says when a refusal clears is believed
+    // (invariant 8). "wait" is a countdown the reader watches, not a request anyone sends, so a
+    // durable quota that resets in an hour is honest as one. Whether the query layer should wait
+    // that hour by itself is a different question, and `shouldRetry` answers it: no.
     if (waitSecs !== null) return "wait";
     return shouldRetry(error, durableLimitCodes, maxRetryWaitSecs) ? "retry" : "none";
   }
 
   /**
    * Anything `codes` does not name. The server's own sentence is still the most specific thing
-   * we have, and support can act on it. A 5xx additionally gets "try again shortly", because that
-   * one genuinely does clear on its own — a 4xx does not, and saying so would be a lie that costs
-   * the reader another attempt.
+   * we have, and support can act on it. A 5xx additionally gets "try again shortly" — but only
+   * when `recover` says trying can work. A 503 whose code is on `durableLimitCodes` clears with a
+   * deploy, never a wait, and "try again in a moment" above no button is two answers to one
+   * question: the drift `recover` exists to prevent, arriving through the words instead. One
+   * adopter's checkout said "…write to us. Try again in a moment." with `recover: "none"`.
+   *
+   * A stated wait gets the line only while it is a moment: short enough that `shouldRetry` waits
+   * it out itself (`maxRetryWaitSecs`). Past that, "in a moment" over an hour's countdown is wrong
+   * the other way round, so the countdown carries it alone and an arm with `ctx.wait` can say when.
+   *
+   * A 4xx gets nothing here even where the rule retries it (408, 425, a 429). A 429 usually states
+   * its wait, and those words belong to an arm for the same reason.
    *
    * No `code` means no envelope, and then `message` is not the server's: it is the client's own
    * `Request failed (502)`, written for a log. A gateway answering with HTML while the API
@@ -405,9 +418,14 @@ export function createErrorDescriber<
    */
   const unmapped: ErrorArm =
     fallback ??
-    (({ error, says }) => ({
+    (({ error, says, recover }) => ({
       cause: says ?? ((error.code === undefined ? "" : error.message) || copyOf("unexpected")),
-      fix: error.status >= 500 ? copyOf("retrySoon") : undefined,
+      fix:
+        error.status >= 500 &&
+        (recover === "retry" ||
+          (recover === "wait" && shouldRetry(error, durableLimitCodes, maxRetryWaitSecs)))
+          ? copyOf("retrySoon")
+          : undefined,
     }));
 
   return function describeError(error: unknown): DescribedError {

package/src/error-boundary.test.ts

@@ -0,0 +1,48 @@
+import { describe, expect, it } from "vitest";
+import { ErrorBoundary } from "./error-boundary.tsx";
+
+/**
+ * The two statics are pure, which is why the reset rule lives in them: it can be checked with no
+ * DOM, no renderer and no thrown error.
+ *
+ * What is worth pinning is that a caught error belongs to the screen it happened on. Wrong one way,
+ * navigating away carries the wreckage to every page after it. Wrong the other way, the fallback
+ * clears itself at once and re-renders the component that just threw, which throws again: a
+ * flicker instead of a state. Lifted from an adopter's copy of this class, deleted when it moved
+ * onto the kit's.
+ */
+const props = (resetKey: string | undefined) => ({
+  resetKey,
+  fallback: () => null,
+  children: null,
+});
+
+describe("ErrorBoundary", () => {
+  it("records the error that was thrown", () => {
+    const error = new TypeError("outcome is not a key of TONE");
+    expect(ErrorBoundary.getDerivedStateFromError(error)).toEqual({ error });
+  });
+
+  it("keeps the error while the route stays put", () => {
+    const state = { error: new Error("boom"), key: "/jobs/abc" };
+    expect(ErrorBoundary.getDerivedStateFromProps(props("/jobs/abc"), state)).toBeNull();
+  });
+
+  it("clears the error when the route changes", () => {
+    const state = { error: new Error("boom"), key: "/jobs/abc" };
+    expect(ErrorBoundary.getDerivedStateFromProps(props("/keys"), state)).toEqual({
+      error: null,
+      key: "/keys",
+    });
+  });
+
+  it("tracks the route while nothing has thrown, so the first error is scoped to it", () => {
+    // Without this the key would still hold the route the boundary mounted on, and the first
+    // error on any later route would clear itself on the next re-render.
+    const state = { error: null, key: "/" };
+    expect(ErrorBoundary.getDerivedStateFromProps(props("/usage"), state)).toEqual({
+      error: null,
+      key: "/usage",
+    });
+  });
+});

package/src/query.ts

@@ -1,4 +1,4 @@
-import { retryDelayMs as delayFor, shouldRetry as retryRule } from "@gusnips/http/retry";
+import { retryDelayMs as delayFor, isRetryable as retryRule } from "@gusnips/http/retry";
 import type { DefaultOptions } from "@tanstack/react-query";
 import { ApiError } from "./api-error.ts";
 

package/src/supabase-session.test.ts

@@ -85,7 +85,7 @@ function reachable(paths: string[] = []): typeof fetch {
   };
 }
 
-function authClient(stored: SupabaseSessionStorage, fetch: typeof fetch) {
+function authClient(stored: SupabaseSessionStorage, fetch: typeof globalThis.fetch) {
   return createClient(PROJECT_URL, "anon-key", {
     // Off so that starting the client does not refresh an expired session by itself: the refresh
     // under test is the one `signOut()` makes.