gemi 0.84.1 → 0.86.0

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";
@@ -593,26 +652,49 @@ function useMutation(method, url, ...args) {
 	const [state, setState] = useState({
 		data: null,
 		error: null,
-		loading: false
+		loading: false,
+		pending: 0
 	});
 	const abortController = useRef(new AbortController());
 	const latestRequest = useRef(0);
+	const inFlight = useRef(/* @__PURE__ */ new Set());
 	const formData = useRef(new FormData());
 	const [inputs = {}, config] = args ?? [];
 	const options = {
 		...defaultOptions,
 		...config
 	};
-	async function trigger(input) {
+	const parallel = options.concurrency === "parallel";
+	async function trigger(input, call = {}) {
 		const controller = new AbortController();
 		abortController.current = controller;
+		if (parallel) inFlight.current.add(controller);
 		const requestId = ++latestRequest.current;
-		const isLatest = () => latestRequest.current === requestId;
+		const isSuperseded = () => !parallel && latestRequest.current !== requestId;
 		setState((prev) => ({
 			data: prev.data,
-			error: null,
-			loading: true
+			error: parallel ? prev.error : null,
+			loading: true,
+			pending: prev.pending + 1
 		}));
+		let left = false;
+		const settle = (update, superseded = false) => {
+			inFlight.current.delete(controller);
+			const leaving = !left;
+			left = true;
+			setState((prev) => {
+				const pending = leaving ? prev.pending - 1 : prev.pending;
+				return {
+					...update(prev),
+					pending,
+					loading: parallel ? pending > 0 : superseded ? prev.loading : false
+				};
+			});
+		};
+		const sentFormData = typeof input === "undefined" ? formData.current : null;
+		const resetFormData = () => {
+			if (!parallel || formData.current === sentFormData) formData.current = new FormData();
+		};
 		const params = "params" in inputs ? {
 			..._params,
 			...inputs.params
@@ -633,42 +715,45 @@ function useMutation(method, url, ...args) {
 				signal: controller.signal
 			});
 			const data = await response.json();
-			if (!isLatest()) return;
-			formData.current = new FormData();
+			if (isSuperseded()) {
+				settle((prev) => prev, true);
+				return;
+			}
+			resetFormData();
 			if (!response.ok) {
 				const error = mutationErrorFromBody(data, response.status);
-				setState((prev) => ({
+				settle((prev) => ({
 					data: prev.data,
-					error,
-					loading: false
+					error
 				}));
 				options.onError(error);
+				call.onError?.(error);
 				return;
 			}
 			clearPrefetchCache?.();
 			options.onSuccess(data);
-			setState({
+			call.onSuccess?.(data);
+			settle(() => ({
 				data,
-				error: null,
-				loading: false
-			});
+				error: null
+			}));
 			return data;
 		} catch (error) {
-			if (!isLatest()) return;
-			formData.current = new FormData();
+			if (isSuperseded()) {
+				settle((prev) => prev, true);
+				return;
+			}
+			resetFormData();
 			if (error?.name === "AbortError") {
-				setState((prev) => ({
-					...prev,
-					loading: false
-				}));
+				settle((prev) => prev);
 				return;
 			}
 			options.onError(error);
-			setState({
-				data: null,
-				error,
-				loading: false
-			});
+			call.onError?.(error);
+			settle((prev) => ({
+				data: parallel ? prev.data : null,
+				error
+			}));
 		}
 	}
 	trigger.formData = (formData) => {
@@ -678,13 +763,17 @@ function useMutation(method, url, ...args) {
 		data: state.data,
 		error: state.error,
 		loading: state.loading,
+		pending: state.pending,
 		formData: formData.current,
 		cancel: () => {
-			abortController.current.abort();
-			setState((prev) => ({
-				...prev,
-				loading: false
-			}));
+			if (parallel) for (const controller of inFlight.current) controller.abort();
+			else {
+				abortController.current.abort();
+				setState((prev) => ({
+					...prev,
+					loading: false
+				}));
+			}
 			formData.current = new FormData();
 			options.onCanceled?.();
 		},
@@ -773,7 +862,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 +1225,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 +1332,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,