gemi 0.84.1 → 0.85.0

package/dist/client/MutationError.d.ts

@@ -1,3 +1,4 @@
+import { type RefusalKind } from "../http/refusal";
 /**
  * What a failed mutation hands `onError` and puts in `error` — `useMutation`
  * and its `usePost`/`usePut`/`usePatch`/`useDelete` shorthands, `useUpload`,
@@ -10,33 +11,54 @@
  * member by member, read off the server's error payloads and the client's
  * fetch code (issue #626).
  *
- * The value is exactly what the response's `error` field held, unchanged — a
- * bare string for most refusals — so it is not tagged with the status it came
- * with. Use the guards below rather than comparing strings, and
- * `mutationErrorKind` to branch on all of them at once.
+ * Since 0.85 every refusal is an object with a `kind`, its `message` and the
+ * `status` it came with (issue #673). Most refusals were a bare string before,
+ * which carried no status, so a refusal thrown with a message of its own could
+ * not be told apart from any other string. A server older than 0.85 still sends
+ * those strings; the client wraps them into the same object, so the guards and
+ * `error.message` work against either.
  */
 /** A server-side `ValidationError` (400): messages keyed by field. */
 export interface MutationValidationError {
     kind: "validation_error";
     messages: Record<string, string[]>;
+    status?: number;
 }
 /**
- * A single form-level message, which `<FormError>` renders. gemi never sends
- * one itself; a `RequestBreakerError` of the app's own can.
+ * A single form-level message, which `<FormError>` renders: a
+ * `RequestBreakerError` of the app's own, or any other 4xx that answered a
+ * message without a kind of its own.
  */
 export interface MutationFormError {
     kind: "form_error";
     message: string;
+    status?: number;
 }
-/** `useUpload` only: an upload that failed with a body that was not JSON. */
+/**
+ * The server failed: an unhandled exception (500; under `gemi dev` the message
+ * is the exception's), or a failed `useUpload` whose body was not JSON.
+ */
 export interface MutationServerError {
     kind: "server_error";
     message: string;
+    status?: number;
 }
+/** The refusals other than the three above. */
+export type MutationRefusalKind = Exclude<RefusalKind, "validation_error" | "form_error" | "server_error">;
 /**
- * A `{ message }` body: a missing record, file or route (404, `"Not found"`),
- * a policy denial (403, `"Forbidden"`), a rate limit (429,
- * `"Rate limit exceeded"`) or an unsatisfiable range (416).
+ * A refusal: `authentication` (401), `authorization` (`AuthorizationError`,
+ * 401), `permission` (`InsufficientPermissionsError` or a policy, 403), `csrf`
+ * (403), `not_found` (404), `range_not_satisfiable` (416) or `rate_limit`
+ * (429). `message` is the one it was thrown with.
+ */
+export interface MutationRefusal<K extends MutationRefusalKind = MutationRefusalKind> {
+    kind: K;
+    message: string;
+    status: number;
+}
+/**
+ * @deprecated A `{ message }` body is wrapped into a `MutationRefusal` or
+ * `MutationFormError` since 0.85, and `MutationError` no longer includes this.
  */
 export interface MutationMessageError {
     kind?: undefined;
@@ -46,44 +68,35 @@ export interface MutationMessageError {
  * Every value `onError` receives and `error` holds for a request gemi's server
  * answered, or failed to reach:
  *
- * - `MutationValidationError`, `MutationFormError`, `MutationServerError` —
- *   tagged with `kind`.
- * - `MutationMessageError` — `{ message }`, see above.
- * - `string` — a refusal or failure answered with a bare string:
- *   `"Authentication error"` (401), `"Not authorized"` (401), `"Insufficient
- *   permissions"` (403), `"Invalid CSRF token"` (403), `"Internal Server
- *   Error"` (500; the exception's message under `gemi dev`). A refusal thrown
- *   with a message of its own arrives as that message.
+ * - `MutationValidationError`, `MutationFormError`, `MutationServerError`,
+ *   `MutationRefusal` — tagged with `kind`, and (from the server) `status`.
  * - `Error` — raised in the browser: a `TypeError` when the request never got
  *   an answer (offline, DNS, CORS), a `SyntaxError` when the answer was not
  *   JSON (a proxy's HTML error page, say). A throw from an `onSuccess` of
  *   yours is reported through `onError` as well, as whatever it threw.
  *
- * A cancelled request is not an error: `onCanceled` runs and `error` stays
- * `null`. A route that answers an error body of its own shape is outside this
- * type: a body with an `error` field (`HttpResponse.json({ error }, { status:
- * 409 })`) hands over that field, as gemi's own errors do, and any other body
- * is handed over whole.
+ * Never a string since 0.85. A cancelled request is not an error: `onCanceled`
+ * runs and `error` stays `null`. A route that answers an error body of its own
+ * shape is outside this type: a body with an `error` field
+ * (`HttpResponse.json({ error }, { status: 409 })`) hands over that field, as
+ * gemi's own errors do, and any other body is handed over whole. Either is
+ * given a `kind` (from the status) and the `status` when it is an object with
+ * a string `message` and no `kind`, and becomes one when it is a string.
  */
-export type MutationError = MutationValidationError | MutationFormError | MutationServerError | MutationMessageError | string | Error;
+export type MutationError = MutationValidationError | MutationFormError | MutationServerError | MutationRefusal | Error;
 /** What `mutationErrorKind` answers, one per guard below. */
 export type MutationErrorKind = "validation" | "form" | "authentication" | "permission" | "csrf" | "not_found" | "rate_limit" | "server" | "network" | "unknown";
-declare const AUTHENTICATION = "Authentication error";
-declare const CSRF = "Invalid CSRF token";
-declare const SERVER = "Internal Server Error";
-type PermissionRefusal = "Insufficient permissions" | "Not authorized";
-type MessageOf<M extends string> = MutationMessageError & {
-    message: M;
-};
 /**
  * The `MutationError` a non-2xx response's parsed body stands for.
  *
  * gemi's own error bodies are `{ error }`, and the value under `error` is what
- * the guards above read, so that is what is handed over. An app's body without
- * one — `HttpResponse.json({ message: "Taken" }, { status: 409 })` — is handed
- * over whole: read as `body.error` it was `undefined`, and a failed request
- * left `error` looking like no error at all. A body with no content to hand
- * over (`null`) becomes a `{ message }` naming the status.
+ * is handed over. An app's body without one —
+ * `HttpResponse.json({ message: "Taken" }, { status: 409 })` — is handed over
+ * whole. A body with no content (`null`) becomes a refusal naming the status.
+ *
+ * What is handed over carries `status`, and a `kind` when it has a `message`:
+ * a bare string, which servers before 0.85 sent for most refusals, becomes
+ * `{ kind, message, status }`, and so does a `{ message }` without a kind.
  *
  * @internal
  */
@@ -93,32 +106,29 @@ export declare function isValidationError(error: unknown): error is MutationVali
 /** A form-level message, as `<FormError>` renders it. */
 export declare function isFormError(error: unknown): error is MutationFormError;
 /** No signed-in user: `AuthenticationError` (401). */
-export declare function isAuthenticationError(error: unknown): error is typeof AUTHENTICATION;
+export declare function isAuthenticationError(error: unknown): error is MutationRefusal<"authentication">;
 /**
  * A signed-in user who may not do this: `InsufficientPermissionsError` (403),
- * `AuthorizationError` (401) or a policy denial (403, `{ message:
- * "Forbidden" }`). Recognised by the framework's default messages.
+ * `AuthorizationError` (401) or a policy denial (403), whatever message it was
+ * thrown with.
  */
-export declare function isPermissionError(error: unknown): error is PermissionRefusal | MessageOf<"Forbidden">;
+export declare function isPermissionError(error: unknown): error is MutationRefusal<"permission" | "authorization">;
 /** The CSRF cookie is missing or stale (403). A reload fixes it. */
-export declare function isCsrfError(error: unknown): error is typeof CSRF;
+export declare function isCsrfError(error: unknown): error is MutationRefusal<"csrf">;
 /** A missing record, file or route (404). */
-export declare function isNotFoundError(error: unknown): error is MessageOf<"Not found">;
+export declare function isNotFoundError(error: unknown): error is MutationRefusal<"not_found">;
 /** `RateLimitMiddleware` refused the request (429). */
-export declare function isRateLimitError(error: unknown): error is MessageOf<"Rate limit exceeded">;
+export declare function isRateLimitError(error: unknown): error is MutationRefusal<"rate_limit">;
 /**
- * The server failed (a production 500), or answered something that is not
- * JSON. Under `gemi dev` a 500 carries the exception's message instead, which
- * is `"unknown"`.
+ * The server failed (a 500, under `gemi dev` too), or answered something that
+ * is not JSON.
  */
-export declare function isServerError(error: unknown): error is typeof SERVER | MutationServerError | SyntaxError;
+export declare function isServerError(error: unknown): error is MutationServerError | SyntaxError;
 /** The request got no answer: offline, DNS, CORS, a dropped connection. */
 export declare function isNetworkError(error: unknown): error is TypeError;
 /**
  * Which of the guards above `error` passes, for a `switch` over all of them.
- * `"unknown"` is everything else: a refusal thrown with a message of its own,
- * a 500 under `gemi dev`, an error body of the app's own shape.
+ * `"unknown"` is everything else: a 416, an error body of the app's own shape.
  */
 export declare function mutationErrorKind(error: unknown): MutationErrorKind;
-export {};
 //# sourceMappingURL=MutationError.d.ts.map

package/dist/client/MutationError.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"MutationError.d.ts","sourceRoot":"","sources":["../../client/MutationError.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAEH,sEAAsE;AACtE,MAAM,WAAW,uBAAuB;IACtC,IAAI,EAAE,kBAAkB,CAAC;IACzB,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,EAAE,CAAC,CAAC;CACpC;AAED;;;GAGG;AACH,MAAM,WAAW,iBAAiB;IAChC,IAAI,EAAE,YAAY,CAAC;IACnB,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,6EAA6E;AAC7E,MAAM,WAAW,mBAAmB;IAClC,IAAI,EAAE,cAAc,CAAC;IACrB,OAAO,EAAE,MAAM,CAAC;CACjB;AAED;;;;GAIG;AACH,MAAM,WAAW,oBAAoB;IACnC,IAAI,CAAC,EAAE,SAAS,CAAC;IACjB,OAAO,EAAE,MAAM,CAAC;CACjB;AAED;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,MAAM,MAAM,aAAa,GACrB,uBAAuB,GACvB,iBAAiB,GACjB,mBAAmB,GACnB,oBAAoB,GACpB,MAAM,GACN,KAAK,CAAC;AAEV,6DAA6D;AAC7D,MAAM,MAAM,iBAAiB,GACzB,YAAY,GACZ,MAAM,GACN,gBAAgB,GAChB,YAAY,GACZ,MAAM,GACN,WAAW,GACX,YAAY,GACZ,QAAQ,GACR,SAAS,GACT,SAAS,CAAC;AAUd,QAAA,MAAM,cAAc,yBAAyB,CAAC;AAK9C,QAAA,MAAM,IAAI,uBAAuB,CAAC;AAClC,QAAA,MAAM,MAAM,0BAA0B,CAAC;AAEvC,KAAK,iBAAiB,GAAG,0BAA0B,GAAG,gBAAgB,CAAC;AACvE,KAAK,SAAS,CAAC,CAAC,SAAS,MAAM,IAAI,oBAAoB,GAAG;IAAE,OAAO,EAAE,CAAC,CAAA;CAAE,CAAC;AAczE;;;;;;;;;;;GAWG;AACH,wBAAgB,qBAAqB,CAAC,IAAI,EAAE,OAAO,EAAE,MAAM,EAAE,MAAM,GAAG,aAAa,CAQlF;AAED,4DAA4D;AAC5D,wBAAgB,iBAAiB,CAC/B,KAAK,EAAE,OAAO,GACb,KAAK,IAAI,uBAAuB,CAElC;AAED,yDAAyD;AACzD,wBAAgB,WAAW,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,iBAAiB,CAEtE;AAED,sDAAsD;AACtD,wBAAgB,qBAAqB,CACnC,KAAK,EAAE,OAAO,GACb,KAAK,IAAI,OAAO,cAAc,CAEhC;AAED;;;;GAIG;AACH,wBAAgB,iBAAiB,CAC/B,KAAK,EAAE,OAAO,GACb,KAAK,IAAI,iBAAiB,GAAG,SAAS,CAAC,WAAW,CAAC,CAKrD;AAED,oEAAoE;AACpE,wBAAgB,WAAW,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,OAAO,IAAI,CAEhE;AAED,6CAA6C;AAC7C,wBAAgB,eAAe,CAC7B,KAAK,EAAE,OAAO,GACb,KAAK,IAAI,SAAS,CAAC,WAAW,CAAC,CAEjC;AAED,uDAAuD;AACvD,wBAAgB,gBAAgB,CAC9B,KAAK,EAAE,OAAO,GACb,KAAK,IAAI,SAAS,CAAC,qBAAqB,CAAC,CAE3C;AAED;;;;GAIG;AACH,wBAAgB,aAAa,CAC3B,KAAK,EAAE,OAAO,GACb,KAAK,IAAI,OAAO,MAAM,GAAG,mBAAmB,GAAG,WAAW,CAM5D;AAED,2EAA2E;AAC3E,wBAAgB,cAAc,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,SAAS,CAEjE;AAED;;;;GAIG;AACH,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,OAAO,GAAG,iBAAiB,CAWnE"}
+{"version":3,"file":"MutationError.d.ts","sourceRoot":"","sources":["../../client/MutationError.ts"],"names":[],"mappings":"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"}

package/dist/client/ProgressManager.d.ts

@@ -7,7 +7,7 @@ export declare class ProgressManager {
     isTicking: boolean;
     constructor(subject: Subject<boolean>);
     getNextIncrement(): number;
-    getNextInterval(): 1000 | 200 | 100 | 400 | 2000;
+    getNextInterval(): 400 | 1000 | 200 | 100 | 2000;
     nextTick(): Promise<void>;
     start(): void;
     end(): void;

package/dist/client/QueryResource.d.ts

@@ -65,6 +65,13 @@ export declare class QueryResource {
     private seq;
     private issued;
     private applied;
+    /**
+     * The abort controller of every request on the wire, per variant (#659).
+     * When the last mounted reader of a variant lets go of it, its requests are
+     * aborted: nobody is left to render the answer, and the server sees the
+     * disconnect through `req.signal`.
+     */
+    private controllers;
     constructor(key: string, initialState: Record<string, any>);
     /**
      * Adopt server-prefetched data into the cache.
@@ -128,6 +135,19 @@ export declare class QueryResource {
      * put on screen.
      */
     retain(variantKey: string): () => void;
+    /**
+     * Abort the variant's requests on the wire once nobody renders it (#659) —
+     * e.g. a `search` that changed again before its answer landed. Deferred a
+     * task so a reader that lets go and takes hold again in the same commit
+     * (StrictMode's double effects, a resubscribe) never cancels anything.
+     *
+     * A request with no mounted reader at all — a hover `prefetch`, a render
+     * that suspended for the first time — is never aborted here: only losing
+     * the *last* reader does that.
+     */
+    private scheduleAbort;
+    /** Abort every request on the wire for this variant. */
+    private abort;
     /** How many fetches of this variant have failed in a row (0 after a success). */
     failureCount(variantKey: string): number;
     /**

package/dist/client/QueryResource.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"QueryResource.d.ts","sourceRoot":"","sources":["../../client/QueryResource.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,kBAAkB,CAAC;AAI3C,KAAK,KAAK,GAAG;IACX,OAAO,EAAE,OAAO,CAAC;IACjB,IAAI,EAAE,GAAG,CAAC;IACV;;;;;;OAMG;IACH,OAAO,EAAE,OAAO,CAAC;IACjB,KAAK,EAAE,GAAG,CAAC;IACX,OAAO,EAAE,MAAM,CAAC;CACjB,CAAC;AAIF,eAAO,MAAM,kBAAkB,OAAO,CAAC;AAGvC,qBAAa,aAAa;IACxB,KAAK,EAAE,OAAO,CAAC,GAAG,CAAC,MAAM,EAAE,KAAK,CAAC,CAAC,CAAC;IACnC,aAAa,cAAqB;IAClC,eAAe,sBAA6B;IAC5C,GAAG,EAAE,MAAM,CAAC;IACZ;;;;;OAKG;IACH,OAAO,CAAC,QAAQ,CAAqB;IACrC;;;;;OAKG;IACH,OAAO,CAAC,OAAO,CAA+B;IAC9C;;;;;;OAMG;IACH,OAAO,CAAC,QAAQ,CAA6B;IAC7C;;;;;OAKG;IACH,OAAO,CAAC,QAAQ,CAA6B;IAC7C;;;OAGG;IACH,OAAO,CAAC,WAAW,CAAoD;IACvE;;;;;;;;OAQG;IACH,OAAO,CAAC,GAAG,CAAK;IAChB,OAAO,CAAC,MAAM,CAA6B;IAC3C,OAAO,CAAC,OAAO,CAA6B;gBAEhC,GAAG,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC;IAM1D;;;;;;;OAOG;IACH,OAAO,CAAC,YAAY,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GAAG,IAAI,GAAG,SAAS;IAwC5D,OAAO,CAAC,UAAU;IAalB,OAAO,CAAC,MAAM;IAQd,OAAO,CAAC,OAAO;IAQf;;;;;;;;;;OAUG;IACH,IAAI,CAAC,UAAU,EAAE,MAAM;IAIvB;;;;;;;;OAQG;IACH,IAAI,CACF,UAAU,EAAE,MAAM,EAClB,SAAS,GAAE,MAA2B,GACrC;QAAE,KAAK,CAAC,EAAE,KAAK,CAAC;QAAC,OAAO,CAAC,EAAE,OAAO,CAAC,IAAI,CAAC,CAAA;KAAE;IA+B7C,UAAU,CAAC,UAAU,EAAE,MAAM,EAAE,SAAS,GAAE,MAA2B;IA2BrE;;;;;;;;;;OAUG;IACH,UAAU,CAAC,UAAU,EAAE,MAAM,EAAE,SAAS,GAAE,MAA2B;IAcrE;;;;OAIG;IACH,UAAU,CAAC,UAAU,CAAC,EAAE,MAAM;IAe9B;;;;OAIG;IACH,MAAM,CAAC,UAAU,EAAE,MAAM,GAAG,MAAM,IAAI;IAiBtC,iFAAiF;IACjF,YAAY,CAAC,UAAU,EAAE,MAAM,GAAG,MAAM;IAIxC;;;;;OAKG;IACH,aAAa,CAAC,UAAU,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM;IAqB/C,WAAW,CAAC,UAAU,EAAE,MAAM;IAQ9B;;;OAGG;IACH,QAAQ,CAAC,UAAU,EAAE,MAAM;IAQ3B,2EAA2E;IAC3E,WAAW,IAAI,MAAM,EAAE;IAIvB;;;;;OAKG;IACH,UAAU,CAAC,UAAU,EAAE,MAAM,EAAE,EAAE,CAAC,EAAE,CAAC,IAAI,EAAE,GAAG,KAAK,GAAG;IAgBtD,OAAO,CAAC,aAAa;IAiBrB,MAAM,CAAC,UAAU,EAAE,MAAM,EAAE,EAAE,GAAE,CAAC,IAAI,EAAE,GAAG,KAAK,GAAoB;IA8BlE,OAAO,CAAC,UAAU,EAAE,MAAM;IAI1B,4EAA4E;IAC5E,OAAO,CAAC,WAAW;YAIL,cAAc;CAwI7B"}
+{"version":3,"file":"QueryResource.d.ts","sourceRoot":"","sources":["../../client/QueryResource.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,kBAAkB,CAAC;AAI3C,KAAK,KAAK,GAAG;IACX,OAAO,EAAE,OAAO,CAAC;IACjB,IAAI,EAAE,GAAG,CAAC;IACV;;;;;;OAMG;IACH,OAAO,EAAE,OAAO,CAAC;IACjB,KAAK,EAAE,GAAG,CAAC;IACX,OAAO,EAAE,MAAM,CAAC;CACjB,CAAC;AAIF,eAAO,MAAM,kBAAkB,OAAO,CAAC;AAGvC,qBAAa,aAAa;IACxB,KAAK,EAAE,OAAO,CAAC,GAAG,CAAC,MAAM,EAAE,KAAK,CAAC,CAAC,CAAC;IACnC,aAAa,cAAqB;IAClC,eAAe,sBAA6B;IAC5C,GAAG,EAAE,MAAM,CAAC;IACZ;;;;;OAKG;IACH,OAAO,CAAC,QAAQ,CAAqB;IACrC;;;;;OAKG;IACH,OAAO,CAAC,OAAO,CAA+B;IAC9C;;;;;;OAMG;IACH,OAAO,CAAC,QAAQ,CAA6B;IAC7C;;;;;OAKG;IACH,OAAO,CAAC,QAAQ,CAA6B;IAC7C;;;OAGG;IACH,OAAO,CAAC,WAAW,CAAoD;IACvE;;;;;;;;OAQG;IACH,OAAO,CAAC,GAAG,CAAK;IAChB,OAAO,CAAC,MAAM,CAA6B;IAC3C,OAAO,CAAC,OAAO,CAA6B;IAC5C;;;;;OAKG;IACH,OAAO,CAAC,WAAW,CAA2C;gBAElD,GAAG,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC;IAM1D;;;;;;;OAOG;IACH,OAAO,CAAC,YAAY,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GAAG,IAAI,GAAG,SAAS;IAwC5D,OAAO,CAAC,UAAU;IAalB,OAAO,CAAC,MAAM;IAQd,OAAO,CAAC,OAAO;IAQf;;;;;;;;;;OAUG;IACH,IAAI,CAAC,UAAU,EAAE,MAAM;IAIvB;;;;;;;;OAQG;IACH,IAAI,CACF,UAAU,EAAE,MAAM,EAClB,SAAS,GAAE,MAA2B,GACrC;QAAE,KAAK,CAAC,EAAE,KAAK,CAAC;QAAC,OAAO,CAAC,EAAE,OAAO,CAAC,IAAI,CAAC,CAAA;KAAE;IA+B7C,UAAU,CAAC,UAAU,EAAE,MAAM,EAAE,SAAS,GAAE,MAA2B;IA2BrE;;;;;;;;;;OAUG;IACH,UAAU,CAAC,UAAU,EAAE,MAAM,EAAE,SAAS,GAAE,MAA2B;IAcrE;;;;OAIG;IACH,UAAU,CAAC,UAAU,CAAC,EAAE,MAAM;IAe9B;;;;OAIG;IACH,MAAM,CAAC,UAAU,EAAE,MAAM,GAAG,MAAM,IAAI;IAkBtC;;;;;;;;;OASG;IACH,OAAO,CAAC,aAAa;IAQrB,wDAAwD;IACxD,OAAO,CAAC,KAAK;IASb,iFAAiF;IACjF,YAAY,CAAC,UAAU,EAAE,MAAM,GAAG,MAAM;IAIxC;;;;;OAKG;IACH,aAAa,CAAC,UAAU,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM;IAqB/C,WAAW,CAAC,UAAU,EAAE,MAAM;IAQ9B;;;OAGG;IACH,QAAQ,CAAC,UAAU,EAAE,MAAM;IAQ3B,2EAA2E;IAC3E,WAAW,IAAI,MAAM,EAAE;IAIvB;;;;;OAKG;IACH,UAAU,CAAC,UAAU,EAAE,MAAM,EAAE,EAAE,CAAC,EAAE,CAAC,IAAI,EAAE,GAAG,KAAK,GAAG;IAgBtD,OAAO,CAAC,aAAa;IAiBrB,MAAM,CAAC,UAAU,EAAE,MAAM,EAAE,EAAE,GAAE,CAAC,IAAI,EAAE,GAAG,KAAK,GAAoB;IA8BlE,OAAO,CAAC,UAAU,EAAE,MAAM;IAI1B,4EAA4E;IAC5E,OAAO,CAAC,WAAW;YAIL,cAAc;CAsK7B"}

package/dist/client/index.d.ts

@@ -9,7 +9,8 @@ export type { QueryFailure, RetryOption, RetryDelayOption, } from "./retryPolicy
 export { useMutation, useDelete, usePatch, usePost, usePut, useUpload } from "./useMutation";
 export { useMutate } from "./useMutate";
 export { isValidationError, isFormError, isAuthenticationError, isPermissionError, isCsrfError, isNotFoundError, isRateLimitError, isServerError, isNetworkError, mutationErrorKind, } from "./MutationError";
-export type { MutationError, MutationErrorKind, MutationValidationError, MutationFormError, MutationServerError, MutationMessageError, } from "./MutationError";
+export type { MutationError, MutationErrorKind, MutationValidationError, MutationFormError, MutationServerError, MutationRefusal, MutationRefusalKind, MutationMessageError, } from "./MutationError";
+export type { RefusalKind } from "../http/refusal";
 export { Form, FormError, useMutationStatus, useFormStatus, useFormData, FormFieldContainer, ValidationErrors, } from "./Mutation";
 export { QueryManagerProvider } from "./QueryManagerContext";
 export type { QueryConfig, UserQueryConfig } from "./QueryManagerContext";

package/dist/client/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../client/index.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../client/index.ts"],"names":[],"mappings":"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"}

package/dist/client/index.js

@@ -1,4 +1,4 @@
-import { A as Action, B as isRetryableQueryError, C as I18nProvider, D as domainUrl, E as useLocation, F as QueryManagerContext, H as shouldRetryQuery, I as QueryManagerProvider, L as USER_QUERY_CONFIG_KEYS, M as toVariantKey, N as applyParams$1, O as isAbsoluteUrl, P as QueryConfigContext, R as pickDefined, S as I18nContext, T as ServerDataProvider, U as QueryError, V as retryDelayFor, W as Subject, _ as readRoutePayload, a as useRouteTransition, b as useSearchParams, c as ComponentsContext, d as loadViewModule, f as subscribeViewModules, g as setActiveLocale, h as registerDictionary, i as RouteTransitionProvider, l as ComponentsProvider, m as loadDictionaryForRender, n as useTheme, o as ClientRouterContext, p as loadDictionary, r as m, s as ClientRouterProvider, t as ThemeProvider, u as initialViewModulesReady, v as routeDataUrl, w as ServerDataContext, x as useNavigate, y as useRoute, z as DEFAULT_STALE_TIME } from "../chunks/ThemeProvider-Dn3UREDn.js";
+import { A as Action, B as isRetryableQueryError, C as I18nProvider, D as domainUrl, E as useLocation, F as QueryManagerContext, H as shouldRetryQuery, I as QueryManagerProvider, L as USER_QUERY_CONFIG_KEYS, M as toVariantKey, N as applyParams$1, O as isAbsoluteUrl, P as QueryConfigContext, R as pickDefined, S as I18nContext, T as ServerDataProvider, U as QueryError, V as retryDelayFor, W as Subject, _ as readRoutePayload, a as useRouteTransition, b as useSearchParams, c as ComponentsContext, d as loadViewModule, f as subscribeViewModules, g as setActiveLocale, h as registerDictionary, i as RouteTransitionProvider, l as ComponentsProvider, m as loadDictionaryForRender, n as useTheme, o as ClientRouterContext, p as loadDictionary, r as m, s as ClientRouterProvider, t as ThemeProvider, u as initialViewModulesReady, v as routeDataUrl, w as ServerDataContext, x as useNavigate, y as useRoute, z as DEFAULT_STALE_TIME } from "../chunks/ThemeProvider-D1kDfCwY.js";
 import { n as RouteStateContext, r as RouteStateProvider, t as useParams } from "../chunks/useParams-BN3XXfmG.js";
 import { Fragment, StrictMode, Suspense, createContext, createElement, isValidElement, memo, use, useCallback, useContext, useDeferredValue, useEffect, useMemo, useRef, useState, useSyncExternalStore, useTransition } from "react";
 import { Fragment as Fragment$1, jsx, jsxs } from "react/jsx-runtime";
@@ -151,6 +151,17 @@ function useFrameworkQuery(url, ...args) {
 		const searchHint = variantKey ? `, { search: ${JSON.stringify(Object.fromEntries(new URLSearchParams(variantKey)))} }` : "";
 		console.warn(`[gemi] useQuery("${url}") rendered on the server without data. The server never fetches, so this page ships without it and the client suspends after hydration. Add \`Query.prefetch("${url}"${searchHint})\` to the route's view handler.`);
 	}
+	useEffect(() => {
+		if (!isDeferred) return;
+		const targetSeed = configRef.current.fallbackData != null ? { [currentVariantKey]: configRef.current.fallbackData } : prefetchedData?.[currentPath];
+		return getResource(currentPath, targetSeed ?? void 0).retain(currentVariantKey);
+	}, [
+		isDeferred,
+		getResource,
+		currentPath,
+		currentVariantKey,
+		prefetchedData
+	]);
 	useEffect(() => {
 		if (fetchedRef.current) resource.getVariant(variantKey, configRef.current.staleTime);
 	}, [variantKey, resource]);
@@ -485,33 +496,82 @@ function useInfiniteQuery(url, options, config) {
 	};
 }
 //#endregion
+//#region http/refusal.ts
+/**
+* The kind a status stands for, for a refusal that does not name one: an app's
+* own `RequestBreakerError`, or an older server's `{ message }`. Any other 4xx
+* is a `form_error`, a message about this request for `<FormError>` to show.
+*/
+function refusalKindForStatus(status) {
+	if (status === 401) return "authentication";
+	if (status === 403) return "permission";
+	if (status === 404) return "not_found";
+	if (status === 416) return "range_not_satisfiable";
+	if (status === 429) return "rate_limit";
+	if (status >= 500) return "server_error";
+	return "form_error";
+}
+//#endregion
 //#region client/MutationError.ts
-var AUTHENTICATION = "Authentication error";
-var PERMISSION = ["Insufficient permissions", "Not authorized"];
-var CSRF = "Invalid CSRF token";
-var SERVER = "Internal Server Error";
+var LEGACY_MESSAGES = {
+	"Authentication error": "authentication",
+	"Not authorized": "authorization",
+	"Insufficient permissions": "permission",
+	"Invalid CSRF token": "csrf",
+	"Internal Server Error": "server_error",
+	Forbidden: "permission",
+	"Not found": "not_found",
+	"Rate limit exceeded": "rate_limit"
+};
 function isObject(error) {
 	return typeof error === "object" && error !== null;
 }
-function bodyMessage(error) {
-	return isObject(error) && !(error instanceof Error) && !("kind" in error) ? error.message : void 0;
+function legacyKind(message, status) {
+	return LEGACY_MESSAGES[message] ?? (status === 401 ? "authorization" : refusalKindForStatus(status));
 }
 /**
 * The `MutationError` a non-2xx response's parsed body stands for.
 *
 * gemi's own error bodies are `{ error }`, and the value under `error` is what
-* the guards above read, so that is what is handed over. An app's body without
-* one — `HttpResponse.json({ message: "Taken" }, { status: 409 })` — is handed
-* over whole: read as `body.error` it was `undefined`, and a failed request
-* left `error` looking like no error at all. A body with no content to hand
-* over (`null`) becomes a `{ message }` naming the status.
+* is handed over. An app's body without one —
+* `HttpResponse.json({ message: "Taken" }, { status: 409 })` — is handed over
+* whole. A body with no content (`null`) becomes a refusal naming the status.
+*
+* What is handed over carries `status`, and a `kind` when it has a `message`:
+* a bare string, which servers before 0.85 sent for most refusals, becomes
+* `{ kind, message, status }`, and so does a `{ message }` without a kind.
 *
 * @internal
 */
 function mutationErrorFromBody(body, status) {
-	if (isObject(body) && "error" in body && body.error != null) return body.error;
-	if (body == null) return { message: `Request failed with status ${status}` };
-	return body;
+	const error = isObject(body) && "error" in body && body.error != null ? body.error : body;
+	if (error == null) return {
+		kind: refusalKindForStatus(status),
+		message: `Request failed with status ${status}`,
+		status
+	};
+	if (typeof error === "string") return {
+		kind: legacyKind(error, status),
+		message: error,
+		status
+	};
+	if (!isObject(error) || error instanceof Error) return error;
+	const withStatus = {
+		...error,
+		status: typeof error.status === "number" ? error.status : status
+	};
+	if (typeof error.kind !== "string" && typeof error.message === "string") return {
+		...withStatus,
+		kind: refusalKindForStatus(withStatus.status)
+	};
+	return withStatus;
+}
+function kindOf(error) {
+	if (typeof error === "string") return LEGACY_MESSAGES[error];
+	if (!isObject(error) || error instanceof Error) return void 0;
+	if (typeof error.kind === "string") return error.kind;
+	if (typeof error.status === "number") return refusalKindForStatus(error.status);
+	return typeof error.message === "string" ? LEGACY_MESSAGES[error.message] : void 0;
 }
 /** Field messages, as `<ValidationErrors>` renders them. */
 function isValidationError(error) {
@@ -523,35 +583,35 @@ function isFormError(error) {
 }
 /** No signed-in user: `AuthenticationError` (401). */
 function isAuthenticationError(error) {
-	return error === AUTHENTICATION;
+	return kindOf(error) === "authentication";
 }
 /**
 * A signed-in user who may not do this: `InsufficientPermissionsError` (403),
-* `AuthorizationError` (401) or a policy denial (403, `{ message:
-* "Forbidden" }`). Recognised by the framework's default messages.
+* `AuthorizationError` (401) or a policy denial (403), whatever message it was
+* thrown with.
 */
 function isPermissionError(error) {
-	return typeof error === "string" && PERMISSION.includes(error) || bodyMessage(error) === "Forbidden";
+	const kind = kindOf(error);
+	return kind === "permission" || kind === "authorization";
 }
 /** The CSRF cookie is missing or stale (403). A reload fixes it. */
 function isCsrfError(error) {
-	return error === CSRF;
+	return kindOf(error) === "csrf";
 }
 /** A missing record, file or route (404). */
 function isNotFoundError(error) {
-	return bodyMessage(error) === "Not found";
+	return kindOf(error) === "not_found";
 }
 /** `RateLimitMiddleware` refused the request (429). */
 function isRateLimitError(error) {
-	return bodyMessage(error) === "Rate limit exceeded";
+	return kindOf(error) === "rate_limit";
 }
 /**
-* The server failed (a production 500), or answered something that is not
-* JSON. Under `gemi dev` a 500 carries the exception's message instead, which
-* is `"unknown"`.
+* The server failed (a 500, under `gemi dev` too), or answered something that
+* is not JSON.
 */
 function isServerError(error) {
-	return error === SERVER || isObject(error) && error.kind === "server_error" || error instanceof SyntaxError;
+	return kindOf(error) === "server_error" || error instanceof SyntaxError;
 }
 /** The request got no answer: offline, DNS, CORS, a dropped connection. */
 function isNetworkError(error) {
@@ -559,8 +619,7 @@ function isNetworkError(error) {
 }
 /**
 * Which of the guards above `error` passes, for a `switch` over all of them.
-* `"unknown"` is everything else: a refusal thrown with a message of its own,
-* a 500 under `gemi dev`, an error body of the app's own shape.
+* `"unknown"` is everything else: a 416, an error body of the app's own shape.
 */
 function mutationErrorKind(error) {
 	if (isValidationError(error)) return "validation";
@@ -773,7 +832,8 @@ function useUpload(url, ...args) {
 			if (outcome.status < 200 || outcome.status > 299) {
 				let error = {
 					kind: "server_error",
-					message: outcome.statusText
+					message: outcome.statusText,
+					status: outcome.status
 				};
 				try {
 					error = mutationErrorFromBody(JSON.parse(outcome.body), outcome.status);
@@ -1135,6 +1195,21 @@ var Link = memo((props) => {
 	}
 	return /* @__PURE__ */ jsx(RouteLink, { ...props });
 });
+/**
+* Clicks the router must not take over, so the browser does what it would for a
+* plain anchor: a new tab or window for `target="_blank"` and for cmd/ctrl/
+* shift/alt-clicks, the context action for a middle click, a file for
+* `download`, and nothing at all when a handler has already cancelled the click.
+*/
+function leaveClickToBrowser(event) {
+	if (event.defaultPrevented) return true;
+	if (event.button !== 0) return true;
+	if (event.metaKey || event.ctrlKey || event.shiftKey || event.altKey) return true;
+	const anchor = event.currentTarget;
+	const target = anchor.getAttribute("target");
+	if (target && target !== "_self") return true;
+	return anchor.hasAttribute("download");
+}
 var RouteLink = memo((props) => {
 	const _params = useParams();
 	const { isTransitioning, targetPath } = useRouteTransition();
@@ -1227,15 +1302,14 @@ var RouteLink = memo((props) => {
 		"data-pending": isTransitioning && resolvedPath === targetPath,
 		href: targetHref === "" ? "/" : targetHref,
 		onClick: (e) => {
-			if (typeof window !== "undefined") {
-				if (currentHref === targetHref) {
-					e.preventDefault();
-					return;
-				}
+			onClick?.(e);
+			if (leaveClickToBrowser(e)) return;
+			if (currentHref === targetHref) {
+				e.preventDefault();
+				return;
 			}
 			let currentPath = window.location.pathname.replace(localeSegment, "");
 			currentPath = currentPath === "" ? "/" : currentPath;
-			onClick?.(e);
 			if (hash === "") e.preventDefault();
 			push(href, {
 				hash,