gemi 0.129.0 → 0.131.0

package/dist/chunks/channelKey-CIhHpX6x.js

@@ -0,0 +1,10 @@
+//#region client/realtime/channelKey.ts
+/** `pattern` and its params, canonical: two hooks on one channel share a `sub`. */
+function channelKey(pattern, params) {
+	const sorted = Object.keys(params).sort().map((key) => [key, String(params[key])]);
+	return `${pattern}\u0000${JSON.stringify(sorted)}`;
+}
+//#endregion
+export { channelKey as t };
+
+//# sourceMappingURL=channelKey-CIhHpX6x.js.map

package/dist/chunks/channelKey-CIhHpX6x.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"channelKey-CIhHpX6x.js","names":[],"sources":["../../client/realtime/channelKey.ts"],"sourcesContent":["import type { ChannelParamValues } from \"./RealtimeClient\";\n\n// A module of its own so the socket client (`./RealtimeClient`, loaded on\n// first use) and `FakeSocket` share it without reaching `./loader`, which\n// would keep it in every route's entry chunk (#915).\n\n/** `pattern` and its params, canonical: two hooks on one channel share a `sub`. */\nexport function channelKey(pattern: string, params: ChannelParamValues): string {\n  const sorted = Object.keys(params)\n    .sort()\n    .map((key) => [key, String(params[key])]);\n  return `${pattern}\\u0000${JSON.stringify(sorted)}`;\n}\n"],"mappings":";;AAOA,SAAgB,WAAW,SAAiB,QAAoC;CAC9E,MAAM,SAAS,OAAO,KAAK,MAAM,CAAC,CAC/B,KAAK,CAAC,CACN,KAAK,QAAQ,CAAC,KAAK,OAAO,OAAO,IAAI,CAAC,CAAC;CAC1C,OAAO,GAAG,QAAQ,QAAQ,KAAK,UAAU,MAAM;AACjD"}

package/dist/chunks/fetchFileRequest-BSrgYnAy.js

@@ -0,0 +1,57 @@
+import { it as QueryError, q as applyParams, tt as parseRetryAfter } from "./ThemeProvider-gWqXjGh-.js";
+//#region client/fetchFileRequest.ts
+/**
+* `fetchBlob` / `fetchText` once loaded: the `GET`, a `QueryError` for a
+* non-2xx, and the body read `as` a blob or text.
+*/
+async function fetchFile(path, options, as) {
+	const response = await request(path, options);
+	return {
+		...as === "blob" ? { blob: await response.blob() } : { text: await response.text() },
+		filename: filenameOf(response),
+		response
+	};
+}
+async function request(path, options = {}) {
+	const { params = {}, search, signal, init } = options;
+	const url = applyParams(path, params);
+	const query = searchString(search);
+	const response = await fetch(`/api${url}${query ? `?${query}` : ""}`, {
+		...init,
+		method: "GET",
+		signal
+	});
+	if (!response.ok) {
+		const body = await response.json().catch(() => null);
+		throw new QueryError(url, query, response.status, body, parseRetryAfter(response.headers.get("retry-after")));
+	}
+	return response;
+}
+function searchString(search) {
+	if (!search) return "";
+	if (search instanceof URLSearchParams) return search.toString();
+	const params = new URLSearchParams();
+	for (const [key, value] of Object.entries(search)) if (value !== null && value !== void 0) params.append(key, String(value));
+	return params.toString();
+}
+/**
+* The file name in a `Content-Disposition` header: the RFC 5987
+* `filename*=UTF-8''...` form when present and decodable, else `filename`.
+*
+* @internal Exported for tests.
+*/
+function filenameOf(response) {
+	const header = response.headers.get("content-disposition");
+	if (!header) return null;
+	const extended = /filename\*\s*=\s*([^']*)'[^']*'([^;]+)/i.exec(header);
+	if (extended) try {
+		return decodeURIComponent(extended[2].trim());
+	} catch {}
+	const plain = /filename\s*=\s*(?:"((?:[^"\\]|\\.)*)"|([^;]+))/i.exec(header);
+	if (!plain) return null;
+	return (plain[1] !== void 0 ? plain[1].replace(/\\(.)/g, "$1") : plain[2].trim()) || null;
+}
+//#endregion
+export { fetchFile, filenameOf };
+
+//# sourceMappingURL=fetchFileRequest-BSrgYnAy.js.map

package/dist/chunks/fetchFileRequest-BSrgYnAy.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"fetchFileRequest-BSrgYnAy.js","names":[],"sources":["../../client/fetchFileRequest.ts"],"sourcesContent":["import { applyParams } from \"../utils/applyParams\";\nimport type { FetchedBlob, FetchedText, FetchFileOptions } from \"./fetchFile\";\nimport { QueryError } from \"./QueryError\";\nimport { parseRetryAfter } from \"./retryPolicy\";\n\n// What `fetchBlob` and `fetchText` in `./fetchFile` load on their first call\n// (#915).\n\ntype RequestOptions = Omit<FetchFileOptions<string>, \"params\"> & {\n  params?: Record<string, string | number | undefined>;\n};\n\n/**\n * `fetchBlob` / `fetchText` once loaded: the `GET`, a `QueryError` for a\n * non-2xx, and the body read `as` a blob or text.\n */\nexport async function fetchFile(\n  path: string,\n  // The caller's `FetchFileOptions<P>`, checked against its path there.\n  options: object | undefined,\n  as: \"blob\" | \"text\",\n): Promise<FetchedBlob | FetchedText> {\n  const response = await request(path, options as RequestOptions);\n  const body = as === \"blob\" ? { blob: await response.blob() } : { text: await response.text() };\n  return { ...body, filename: filenameOf(response), response } as FetchedBlob | FetchedText;\n}\n\nasync function request(path: string, options: RequestOptions = {}) {\n  const { params = {}, search, signal, init } = options;\n  const url = applyParams(path, params);\n  const query = searchString(search);\n  const response = await fetch(`/api${url}${query ? `?${query}` : \"\"}`, {\n    ...init,\n    method: \"GET\",\n    signal,\n  });\n  if (!response.ok) {\n    // An error body that is not JSON (a proxy's HTML 502) is still that status.\n    const body = await response.json().catch(() => null);\n    throw new QueryError(\n      url,\n      query,\n      response.status,\n      body,\n      parseRetryAfter(response.headers.get(\"retry-after\")),\n    );\n  }\n  return response;\n}\n\nfunction searchString(search: FetchFileOptions<string>[\"search\"]) {\n  if (!search) return \"\";\n  if (search instanceof URLSearchParams) return search.toString();\n  const params = new URLSearchParams();\n  for (const [key, value] of Object.entries(search)) {\n    if (value !== null && value !== undefined) params.append(key, String(value));\n  }\n  return params.toString();\n}\n\n/**\n * The file name in a `Content-Disposition` header: the RFC 5987\n * `filename*=UTF-8''...` form when present and decodable, else `filename`.\n *\n * @internal Exported for tests.\n */\nexport function filenameOf(response: Response): string | null {\n  const header = response.headers.get(\"content-disposition\");\n  if (!header) return null;\n  const extended = /filename\\*\\s*=\\s*([^']*)'[^']*'([^;]+)/i.exec(header);\n  if (extended) {\n    try {\n      return decodeURIComponent(extended[2].trim());\n    } catch {\n      // A malformed escape: fall back to the plain form.\n    }\n  }\n  const plain = /filename\\s*=\\s*(?:\"((?:[^\"\\\\]|\\\\.)*)\"|([^;]+))/i.exec(header);\n  if (!plain) return null;\n  const name = plain[1] !== undefined ? plain[1].replace(/\\\\(.)/g, \"$1\") : plain[2].trim();\n  return name || null;\n}\n"],"mappings":";;;;;;AAgBA,eAAsB,UACpB,MAEA,SACA,IACoC;CACpC,MAAM,WAAW,MAAM,QAAQ,MAAM,OAAyB;CAE9D,OAAO;EAAE,GADI,OAAO,SAAS,EAAE,MAAM,MAAM,SAAS,KAAK,EAAE,IAAI,EAAE,MAAM,MAAM,SAAS,KAAK,EAAE;EAC3E,UAAU,WAAW,QAAQ;EAAG;CAAS;AAC7D;AAEA,eAAe,QAAQ,MAAc,UAA0B,CAAC,GAAG;CACjE,MAAM,EAAE,SAAS,CAAC,GAAG,QAAQ,QAAQ,SAAS;CAC9C,MAAM,MAAM,YAAY,MAAM,MAAM;CACpC,MAAM,QAAQ,aAAa,MAAM;CACjC,MAAM,WAAW,MAAM,MAAM,OAAO,MAAM,QAAQ,IAAI,UAAU,MAAM;EACpE,GAAG;EACH,QAAQ;EACR;CACF,CAAC;CACD,IAAI,CAAC,SAAS,IAAI;EAEhB,MAAM,OAAO,MAAM,SAAS,KAAK,CAAC,CAAC,YAAY,IAAI;EACnD,MAAM,IAAI,WACR,KACA,OACA,SAAS,QACT,MACA,gBAAgB,SAAS,QAAQ,IAAI,aAAa,CAAC,CACrD;CACF;CACA,OAAO;AACT;AAEA,SAAS,aAAa,QAA4C;CAChE,IAAI,CAAC,QAAQ,OAAO;CACpB,IAAI,kBAAkB,iBAAiB,OAAO,OAAO,SAAS;CAC9D,MAAM,SAAS,IAAI,gBAAgB;CACnC,KAAK,MAAM,CAAC,KAAK,UAAU,OAAO,QAAQ,MAAM,GAC9C,IAAI,UAAU,QAAQ,UAAU,KAAA,GAAW,OAAO,OAAO,KAAK,OAAO,KAAK,CAAC;CAE7E,OAAO,OAAO,SAAS;AACzB;;;;;;;AAQA,SAAgB,WAAW,UAAmC;CAC5D,MAAM,SAAS,SAAS,QAAQ,IAAI,qBAAqB;CACzD,IAAI,CAAC,QAAQ,OAAO;CACpB,MAAM,WAAW,0CAA0C,KAAK,MAAM;CACtE,IAAI,UACF,IAAI;EACF,OAAO,mBAAmB,SAAS,EAAE,CAAC,KAAK,CAAC;CAC9C,QAAQ,CAER;CAEF,MAAM,QAAQ,kDAAkD,KAAK,MAAM;CAC3E,IAAI,CAAC,OAAO,OAAO;CAEnB,QADa,MAAM,OAAO,KAAA,IAAY,MAAM,EAAE,CAAC,QAAQ,UAAU,IAAI,IAAI,MAAM,EAAE,CAAC,KAAK,MACxE;AACjB"}

package/dist/chunks/{live-DIUDdLrA.js → live-CUdMhXHL.js}

@@ -1,4 +1,4 @@
-import "./ThemeProvider-DaX0eyqs.js";
+import { G as loadedModule, H as realtime } from "./ThemeProvider-gWqXjGh-.js";
 //#region \0rolldown/runtime.js
 var __defProp = Object.defineProperty;
 var __exportAll = (all, no_symbols) => {
@@ -13,6 +13,7 @@ var __exportAll = (all, no_symbols) => {
 //#endregion
 //#region client/realtime/live.ts
 var live_exports = /* @__PURE__ */ __exportAll({
+	followLive: () => followLive,
 	resolveLiveChannel: () => resolveLiveChannel,
 	subscribeLive: () => subscribeLive
 });
@@ -63,7 +64,25 @@ function subscribeLive(socket, live, resource, setOpen) {
 		release();
 	};
 }
+/**
+* What `followLive` in `./loader` hands over to once this module is loaded:
+* subscribes on the provided socket, or the tab's client, loading that first
+* when it is not there yet. Returns the function that stops it.
+*/
+function followLive(provided, live, resource, setOpen) {
+	let stop;
+	const start = (socket) => {
+		if (stop === void 0) stop = subscribeLive(socket, live, resource, setOpen);
+	};
+	const socket = provided ?? realtime.client;
+	if (socket) start(socket);
+	else import("./RealtimeClient-DsWbFRC7.js").then((module) => start(loadedModule(module).tabClient())).catch(() => {});
+	return () => {
+		stop?.();
+		stop = null;
+	};
+}
 //#endregion
-export { live_exports as t };
+export { live_exports as n, followLive as t };
 
-//# sourceMappingURL=live-DIUDdLrA.js.map
+//# sourceMappingURL=live-CUdMhXHL.js.map

package/dist/chunks/live-CUdMhXHL.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"live-CUdMhXHL.js","names":[],"sources":["../../client/realtime/live.ts"],"sourcesContent":["import type { QueryResource } from \"../QueryResource\";\nimport type { ChannelPattern } from \"../useChannel\";\nimport { EVENT_COALESCE_MS } from \"./useChannelSubscription\";\nimport type { ChannelParamValues, RealtimeSocket } from \"./RealtimeClient\";\nimport { loadedModule } from \"../lazyModule\";\nimport { realtime } from \"./loader\";\n\n/**\n * `useQuery`'s `live` option: the channel whose events and resyncs refetch\n * the query. A pattern without params (`\"user\"`), `[pattern, params]`, or\n * `{ channel, params }`.\n */\nexport type LiveChannel =\n  | ChannelPattern\n  | readonly [ChannelPattern, ChannelParamValues]\n  | { channel: ChannelPattern; params?: ChannelParamValues };\n\nexport function resolveLiveChannel(\n  live: LiveChannel | null | undefined | false,\n): { pattern: string; params: ChannelParamValues } | null {\n  if (!live) return null;\n  if (typeof live === \"string\") return { pattern: live, params: {} };\n  if (Array.isArray(live)) return { pattern: live[0], params: live[1] ?? {} };\n  const object = live as { channel: string; params?: ChannelParamValues };\n  return { pattern: object.channel, params: object.params ?? {} };\n}\n\n/**\n * `useQuery`'s `live` subscription, loaded on first use by `followLive` in\n * `./loader` (#891). The channel's events refetch every cached variant of the\n * query (the rendered ones now), a burst of them once per\n * `EVENT_COALESCE_MS`; a resync refetches at once. `setOpen` follows whether\n * the channel is open, which pauses the query's polling.\n */\nexport function subscribeLive(\n  socket: RealtimeSocket,\n  live: LiveChannel,\n  resource: () => QueryResource,\n  setOpen: (open: boolean) => void,\n): () => void {\n  const channel = resolveLiveChannel(live);\n  if (!channel) return () => {};\n  const refresh = () => {\n    const target = resource();\n    for (const key of target.variantKeys()) target.invalidate(key);\n  };\n  let timer: ReturnType<typeof setTimeout> | null = null;\n  const release = socket.subscribe(channel.pattern, channel.params, {\n    onEvent: () => {\n      if (timer) return;\n      timer = setTimeout(() => {\n        timer = null;\n        refresh();\n      }, EVENT_COALESCE_MS);\n    },\n    onResync: refresh,\n    onStatus: (status) => setOpen(status === \"open\"),\n  });\n  return () => {\n    if (timer) clearTimeout(timer);\n    release();\n  };\n}\n\n/**\n * What `followLive` in `./loader` hands over to once this module is loaded:\n * subscribes on the provided socket, or the tab's client, loading that first\n * when it is not there yet. Returns the function that stops it.\n */\nexport function followLive(\n  provided: RealtimeSocket | null,\n  live: LiveChannel,\n  resource: () => QueryResource,\n  setOpen: (open: boolean) => void,\n): () => void {\n  // `undefined` until it subscribes, `null` once stopped.\n  let stop: (() => void) | null | undefined;\n  const start = (socket: RealtimeSocket) => {\n    if (stop === undefined) stop = subscribeLive(socket, live, resource, setOpen);\n  };\n  const socket = provided ?? realtime.client;\n  if (socket) start(socket);\n  // Its own `import()` of the client rather than `loadRealtimeClient`, which\n  // would keep that in the entry chunk of every app with a `useQuery`. A\n  // failed load leaves the channel closed, so the query keeps polling.\n  else\n    import(\"./RealtimeClient.js\")\n      .then((module) => start(loadedModule(module).tabClient()))\n      .catch(() => {});\n  return () => {\n    stop?.();\n    stop = null;\n  };\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;AAiBA,SAAgB,mBACd,MACwD;CACxD,IAAI,CAAC,MAAM,OAAO;CAClB,IAAI,OAAO,SAAS,UAAU,OAAO;EAAE,SAAS;EAAM,QAAQ,CAAC;CAAE;CACjE,IAAI,MAAM,QAAQ,IAAI,GAAG,OAAO;EAAE,SAAS,KAAK;EAAI,QAAQ,KAAK,MAAM,CAAC;CAAE;CAC1E,MAAM,SAAS;CACf,OAAO;EAAE,SAAS,OAAO;EAAS,QAAQ,OAAO,UAAU,CAAC;CAAE;AAChE;;;;;;;;AASA,SAAgB,cACd,QACA,MACA,UACA,SACY;CACZ,MAAM,UAAU,mBAAmB,IAAI;CACvC,IAAI,CAAC,SAAS,aAAa,CAAC;CAC5B,MAAM,gBAAgB;EACpB,MAAM,SAAS,SAAS;EACxB,KAAK,MAAM,OAAO,OAAO,YAAY,GAAG,OAAO,WAAW,GAAG;CAC/D;CACA,IAAI,QAA8C;CAClD,MAAM,UAAU,OAAO,UAAU,QAAQ,SAAS,QAAQ,QAAQ;EAChE,eAAe;GACb,IAAI,OAAO;GACX,QAAQ,iBAAiB;IACvB,QAAQ;IACR,QAAQ;GACV,GAAA,GAAoB;EACtB;EACA,UAAU;EACV,WAAW,WAAW,QAAQ,WAAW,MAAM;CACjD,CAAC;CACD,aAAa;EACX,IAAI,OAAO,aAAa,KAAK;EAC7B,QAAQ;CACV;AACF;;;;;;AAOA,SAAgB,WACd,UACA,MACA,UACA,SACY;CAEZ,IAAI;CACJ,MAAM,SAAS,WAA2B;EACxC,IAAI,SAAS,KAAA,GAAW,OAAO,cAAc,QAAQ,MAAM,UAAU,OAAO;CAC9E;CACA,MAAM,SAAS,YAAY,SAAS;CACpC,IAAI,QAAQ,MAAM,MAAM;MAKtB,OAAO,+BAAsB,CAC1B,MAAM,WAAW,MAAM,aAAa,MAAM,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC,CACzD,YAAY,CAAC,CAAC;CACnB,aAAa;EACX,OAAO;EACP,OAAO;CACT;AACF"}

package/dist/chunks/mutationExtras-CtY-X9m7.js

@@ -0,0 +1,115 @@
+import { K as toVariantKey, q as applyParams } from "./ThemeProvider-gWqXjGh-.js";
+import { p as mutationErrorFromBody, s as isObject } from "./MutationError-DuKqBW8o.js";
+//#region client/mutationErrorHelpers.ts
+var FALLBACK_MESSAGE = "Something went wrong. Try again.";
+function isValidationError(error) {
+	return isObject(error) && error.kind === "validation_error";
+}
+function unwrapQueryError(error) {
+	if (error instanceof Error && error.name === "QueryError" && "body" in error) {
+		const { body, status } = error;
+		return body == null ? error : mutationErrorFromBody(body, status);
+	}
+	return error;
+}
+function list(error, fallback = FALLBACK_MESSAGE) {
+	const value = unwrapQueryError(error);
+	if (isValidationError(value)) {
+		const messages = Object.values(value.messages ?? {}).flat().filter((message) => typeof message === "string" && message !== "");
+		return messages.length > 0 ? messages : [fallback];
+	}
+	if (isObject(value) && !(value instanceof Error) && value.kind !== "server_error" && typeof value.message === "string" && value.message !== "") return [value.message];
+	return [fallback];
+}
+function field(error, name) {
+	const value = unwrapQueryError(error);
+	if (!isValidationError(value)) return [];
+	const messages = value.messages?.[name];
+	return Array.isArray(messages) ? [...messages] : [];
+}
+/**
+* Puts `list` and `field` on an error the hooks hand over, as non-enumerable
+* properties, so `toEqual`, a spread and `JSON.stringify` see the same object
+* as before. A key the error already has is left alone; a primitive or a
+* frozen value is returned as it is.
+*
+* @internal
+*/
+function withMutationErrorHelpers(error) {
+	if (!isObject(error) || !Object.isExtensible(error)) return error;
+	const helpers = {
+		list: (fallback) => list(error, fallback),
+		field: (name) => field(error, name)
+	};
+	for (const key of ["list", "field"]) {
+		if (key in error) continue;
+		Object.defineProperty(error, key, {
+			value: helpers[key],
+			configurable: true,
+			writable: true,
+			enumerable: false
+		});
+	}
+	return error;
+}
+//#endregion
+//#region client/queryUpdates.ts
+/**
+* Write data the server just produced (a mutation's answer) into a variant,
+* with no refetch: unlike `mutate`, the value is not a guess to reconcile.
+* The variant counts as freshly fetched, so its `staleTime` starts again, and
+* a GET already on the wire for it is dropped when it lands, since it may
+* carry the data from before the write. A reader suspended on the variant
+* wakes up with it (#897). Here rather than on `QueryResource`, which every
+* entry chunk carries (#915).
+*/
+function setVariant(resource, variantKey, data) {
+	resource.dropHttpCache(variantKey);
+	resource.markApplied(variantKey);
+	const store = resource.store.getValue();
+	resource.fill(store, variantKey, data, Date.now());
+	resource.store.next(store);
+}
+/**
+* Write into every variant `target` names. `next` is the value to write, or
+* a function of the cached value; a function skips a variant with nothing
+* cached. A value seeds a single variant that is not cached yet; a predicate
+* only ever reaches variants that are.
+*/
+function writeQueryData(getResource, routeParams, target, next) {
+	const { path, params = {}, search = {} } = target;
+	const resource = getResource(applyParams(String(path), {
+		...routeParams,
+		...params
+	}));
+	const write = (variantKey) => {
+		if ("value" in next) {
+			setVariant(resource, variantKey, next.value);
+			return;
+		}
+		const state = resource.peek(variantKey);
+		if (!state?.hasData) return;
+		setVariant(resource, variantKey, next.update(state.data));
+	};
+	if (typeof search === "function") {
+		for (const variantKey of resource.variantKeys()) {
+			if (!resource.peek(variantKey)?.hasData) continue;
+			if (search(new URLSearchParams(variantKey))) write(variantKey);
+		}
+		return;
+	}
+	write(toVariantKey(search));
+}
+/**
+* Write a mutation's `updates` with its answer.
+*/
+function applyQueryUpdates(getResource, routeParams, updates, answer) {
+	for (const update of updates ?? []) {
+		const { data } = update;
+		writeQueryData(getResource, routeParams, update, data ? { update: (current) => data(answer, current) } : { value: answer });
+	}
+}
+//#endregion
+export { applyQueryUpdates, withMutationErrorHelpers, writeQueryData };
+
+//# sourceMappingURL=mutationExtras-CtY-X9m7.js.map

package/dist/chunks/mutationExtras-CtY-X9m7.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"mutationExtras-CtY-X9m7.js","names":[],"sources":["../../client/mutationErrorHelpers.ts","../../client/queryUpdates.ts"],"sourcesContent":["import {\n  isObject,\n  mutationErrorFromBody,\n  type MutationErrorHelpers,\n  type MutationValidationError,\n  type WithMutationErrorHelpers,\n} from \"./MutationError\";\n\n// `error.list()` and `error.field(name)` on what the mutation hooks hand over.\n// Loaded with the hooks' other extras when one mounts (see\n// `./mutationModules`), so no route's entry chunk carries it (#915).\n//\n// `list` and `field` repeat `mutationErrorList` and `mutationErrorField` from\n// `./MutationError` on purpose. Those are public and synchronous, so they sit\n// in whatever chunk calls them; importing them here would put them, and so\n// this code, back in every entry chunk. `MutationError.helpers.test` runs the\n// same cases through both.\n\nconst FALLBACK_MESSAGE = \"Something went wrong. Try again.\";\n\n// `isValidationError`, which an import would keep in the entry chunk.\nfunction isValidationError(error: unknown): error is MutationValidationError {\n  return isObject(error) && error.kind === \"validation_error\";\n}\n\n// A `QueryError`'s refusal, read as the mutation hooks read a body. Read by\n// shape, not `instanceof`, so a copy of the class from another bundle works.\nfunction unwrapQueryError(error: unknown): unknown {\n  if (error instanceof Error && error.name === \"QueryError\" && \"body\" in error) {\n    const { body, status } = error as Error & { body: unknown; status: number };\n    return body == null ? error : mutationErrorFromBody(body, status);\n  }\n  return error;\n}\n\n// `error.list(fallback)`: see `mutationErrorList`.\nfunction list(\n  error: unknown,\n  fallback: string = FALLBACK_MESSAGE,\n): string[] {\n  const value = unwrapQueryError(error);\n  if (isValidationError(value)) {\n    const messages = Object.values(value.messages ?? {})\n      .flat()\n      .filter((message) => typeof message === \"string\" && message !== \"\");\n    return messages.length > 0 ? messages : [fallback];\n  }\n  if (\n    isObject(value) &&\n    !(value instanceof Error) &&\n    value.kind !== \"server_error\" &&\n    typeof value.message === \"string\" &&\n    value.message !== \"\"\n  ) {\n    return [value.message];\n  }\n  return [fallback];\n}\n\n// `error.field(name)`: see `mutationErrorField`.\nfunction field(error: unknown, name: string): string[] {\n  const value = unwrapQueryError(error);\n  if (!isValidationError(value)) return [];\n  const messages = value.messages?.[name];\n  return Array.isArray(messages) ? [...messages] : [];\n}\n\n/**\n * Puts `list` and `field` on an error the hooks hand over, as non-enumerable\n * properties, so `toEqual`, a spread and `JSON.stringify` see the same object\n * as before. A key the error already has is left alone; a primitive or a\n * frozen value is returned as it is.\n *\n * @internal\n */\nexport function withMutationErrorHelpers<T>(error: T): WithMutationErrorHelpers<T> {\n  if (!isObject(error) || !Object.isExtensible(error)) {\n    return error as WithMutationErrorHelpers<T>;\n  }\n  const helpers: MutationErrorHelpers = {\n    list: (fallback) => list(error, fallback),\n    field: (name) => field(error, name),\n  };\n  for (const key of [\"list\", \"field\"] as const) {\n    if (key in error) continue;\n    Object.defineProperty(error, key, {\n      value: helpers[key],\n      configurable: true,\n      writable: true,\n      enumerable: false,\n    });\n  }\n  return error as WithMutationErrorHelpers<T>;\n}\n","import type { QueryResource } from \"./QueryResource\";\nimport type { QueryTarget, QueryUpdate } from \"./useSetQueryData\";\nimport { applyParams } from \"../utils/applyParams\";\nimport { toVariantKey } from \"../utils/variantKey\";\n\n// The cache writes behind a mutation's `updates` and `useSetQueryData()`\n// (#897). Loaded with the hooks' other extras when one mounts (see\n// `./mutationModules`), so no route's entry chunk carries it (#915).\n\ntype Resolve = (key: string) => QueryResource;\n\n/**\n * Write data the server just produced (a mutation's answer) into a variant,\n * with no refetch: unlike `mutate`, the value is not a guess to reconcile.\n * The variant counts as freshly fetched, so its `staleTime` starts again, and\n * a GET already on the wire for it is dropped when it lands, since it may\n * carry the data from before the write. A reader suspended on the variant\n * wakes up with it (#897). Here rather than on `QueryResource`, which every\n * entry chunk carries (#915).\n */\nfunction setVariant(resource: QueryResource, variantKey: string, data: unknown) {\n  resource.dropHttpCache(variantKey);\n  resource.markApplied(variantKey);\n  const store = resource.store.getValue();\n  resource.fill(store, variantKey, data, Date.now());\n  resource.store.next(store);\n}\n\n/** The value to write, or a function of the cached one. */\nexport type WriteQueryNext = { value: unknown } | { update: (current: any) => unknown };\n\n/**\n * Write into every variant `target` names. `next` is the value to write, or\n * a function of the cached value; a function skips a variant with nothing\n * cached. A value seeds a single variant that is not cached yet; a predicate\n * only ever reaches variants that are.\n */\nexport function writeQueryData(\n  getResource: Resolve,\n  routeParams: Record<string, any>,\n  target: QueryTarget<any>,\n  next: WriteQueryNext,\n) {\n  const { path, params = {}, search = {} } = target;\n  const resource = getResource(applyParams(String(path), { ...routeParams, ...params }));\n  const write = (variantKey: string) => {\n    if (\"value\" in next) {\n      setVariant(resource, variantKey, next.value);\n      return;\n    }\n    const state = resource.peek(variantKey);\n    if (!state?.hasData) return;\n    setVariant(resource, variantKey, next.update(state.data));\n  };\n\n  if (typeof search === \"function\") {\n    for (const variantKey of resource.variantKeys()) {\n      if (!resource.peek(variantKey)?.hasData) continue;\n      if (search(new URLSearchParams(variantKey))) write(variantKey);\n    }\n    return;\n  }\n  write(toVariantKey(search));\n}\n\n/**\n * Write a mutation's `updates` with its answer.\n */\nexport function applyQueryUpdates(\n  getResource: Resolve,\n  routeParams: Record<string, any>,\n  updates: ReadonlyArray<QueryUpdate<any>> | undefined,\n  answer: unknown,\n) {\n  for (const update of updates ?? []) {\n    const { data } = update as { data?: (answer: any, current: any) => any };\n    writeQueryData(\n      getResource,\n      routeParams,\n      update,\n      data ? { update: (current) => data(answer, current) } : { value: answer },\n    );\n  }\n}\n"],"mappings":"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"}

package/dist/client/MutationError.d.ts

@@ -93,6 +93,8 @@ export interface MutationMessageError {
 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";
+/** @internal */
+export declare function isObject(error: unknown): error is Record<string, unknown>;
 /**
  * The `MutationError` a non-2xx response's parsed body stands for.
  *
@@ -197,6 +199,11 @@ export type WithMutationErrorHelpers<T> = T extends object ? T & Omit<MutationEr
 /**
  * `error.list(fallback)` for any value: an error kept from a mutation, a
  * `useQuery` `QueryError` (its body is read), or anything else.
+ *
+ * Kept in step with `list` in `./mutationErrorHelpers`, which the mutation
+ * hooks load on first use (#915) and so cannot share this code: an app's
+ * bundler would put it back in the entry chunk. `MutationError.helpers.test`
+ * runs the same cases through both.
  */
 export declare function mutationErrorList(error: unknown, fallback?: string): string[];
 /**
@@ -204,13 +211,4 @@ export declare function mutationErrorList(error: unknown, fallback?: string): st
  * `name` (a `QueryError`'s body is read), `[]` for anything else.
  */
 export declare function mutationErrorField(error: unknown, name: string): string[];
-/**
- * Puts `list` and `field` on an error the hooks hand over, as non-enumerable
- * properties, so `toEqual`, a spread and `JSON.stringify` see the same object
- * as before. A key the error already has is left alone; a primitive or a
- * frozen value is returned as it is.
- *
- * @internal
- */
-export declare function withMutationErrorHelpers<T>(error: T): WithMutationErrorHelpers<T>;
 //# 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":"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"}
+{"version":3,"file":"MutationError.d.ts","sourceRoot":"","sources":["../../client/MutationError.ts"],"names":[],"mappings":"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"}

package/dist/client/QueryResource.d.ts

@@ -172,20 +172,12 @@ export declare class QueryResource {
      * and revalidates — bypassing the HTTP cache — the next time it is read.
      */
     invalidate(variantKey: string, fn?: (data: any) => any): void;
-    private dropHttpCache;
+    dropHttpCache(variantKey: string): void;
     mutate(variantKey: string, fn?: (data: any) => any): void;
-    /**
-     * Write data the server just produced (a mutation's answer) into a
-     * variant, with no refetch: unlike `mutate`, the value is not a guess to
-     * reconcile. The variant counts as freshly fetched, so its `staleTime`
-     * starts again, and a GET already on the wire for it is dropped when it
-     * lands, since it may carry the data from before the write. A reader
-     * suspended on the variant wakes up with it (#897).
-     */
-    set(variantKey: string, data: any): void;
+    fill(store: Map<string, State>, variantKey: string, data: any, now: number): void;
     refetch(variantKey: string): void;
     /** Supersede every request for this variant that is already on the wire. */
-    private markApplied;
+    markApplied(variantKey: string): void;
     private resolveVariant;
 }
 export {};

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

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

package/dist/client/fetchFile.d.ts

@@ -51,16 +51,13 @@ export interface FetchedText extends Fetched {
  * `retryAfter`), the error `useQuery` throws, so `mutationErrorList(error)`
  * reads its message. A network failure rejects with the browser's `TypeError`,
  * an abort with its `AbortError`.
+ *
+ * The request code loads on the first call (#915), so a route that never
+ * downloads a file carries none of it; a failed load rejects as a network
+ * failure does.
  */
 export declare function fetchBlob<P extends FilePath>(path: P, ...args: FetchFileArgs<P>): Promise<FetchedBlob>;
 /** `fetchBlob`, with the body read as text. */
 export declare function fetchText<P extends FilePath>(path: P, ...args: FetchFileArgs<P>): Promise<FetchedText>;
-/**
- * The file name in a `Content-Disposition` header: the RFC 5987
- * `filename*=UTF-8''...` form when present and decodable, else `filename`.
- *
- * @internal Exported for tests.
- */
-export declare function filenameOf(response: Response): string | null;
 export {};
 //# sourceMappingURL=fetchFile.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"fetchFile.d.ts","sourceRoot":"","sources":["../../client/fetchFile.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,OAAO,CAAC;AACrC,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,SAAS,CAAC;AAEzC;;;;GAIG;AACH,MAAM,MAAM,QAAQ,GAAG,UAAU,CAAC,OAAO,CAAC,CAAC;AAE3C,0DAA0D;AAC1D,MAAM,MAAM,UAAU,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,SAAS,CAAC,KAAK,CAAC,GAAG,MAAM,GAAG,MAAM,CAAC,GAAG,MAAM,CAAC;AAElF,MAAM,MAAM,gBAAgB,CAAC,CAAC,SAAS,MAAM,IAAI;IAC/C,4DAA4D;IAC5D,MAAM,CAAC,EAAE,OAAO,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,CAAC;IAC/B,oEAAoE;IACpE,MAAM,CAAC,EACH,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,OAAO,GAAG,IAAI,GAAG,SAAS,CAAC,GAC5D,eAAe,CAAC;IACpB,kFAAkF;IAClF,MAAM,CAAC,EAAE,WAAW,CAAC;IACrB,qFAAqF;IACrF,IAAI,CAAC,EAAE,IAAI,CAAC,WAAW,EAAE,QAAQ,GAAG,MAAM,GAAG,QAAQ,CAAC,CAAC;CACxD,CAAC;AAGF,gBAAgB;AAChB,MAAM,MAAM,aAAa,CAAC,CAAC,SAAS,MAAM,IACxC,EAAE,SAAS,SAAS,CAAC,CAAC,CAAC,GACnB,CAAC,OAAO,CAAC,EAAE,gBAAgB,CAAC,CAAC,CAAC,CAAC,GAC/B,CAAC,OAAO,EAAE,gBAAgB,CAAC,CAAC,CAAC,GAAG;IAAE,MAAM,EAAE,SAAS,CAAC,CAAC,CAAC,CAAA;CAAE,CAAC,CAAC;AAEhE,UAAU,OAAO;IACf;;;OAGG;IACH,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;IACxB,wEAAwE;IACxE,QAAQ,EAAE,QAAQ,CAAC;CACpB;AAED,MAAM,WAAW,WAAY,SAAQ,OAAO;IAC1C,IAAI,EAAE,IAAI,CAAC;CACZ;AAED,MAAM,WAAW,WAAY,SAAQ,OAAO;IAC1C,IAAI,EAAE,MAAM,CAAC;CACd;AAED;;;;;;;;;;;;;;GAcG;AACH,wBAAsB,SAAS,CAAC,CAAC,SAAS,QAAQ,EAChD,IAAI,EAAE,CAAC,EACP,GAAG,IAAI,EAAE,aAAa,CAAC,CAAC,CAAC,GACxB,OAAO,CAAC,WAAW,CAAC,CAGtB;AAED,+CAA+C;AAC/C,wBAAsB,SAAS,CAAC,CAAC,SAAS,QAAQ,EAChD,IAAI,EAAE,CAAC,EACP,GAAG,IAAI,EAAE,aAAa,CAAC,CAAC,CAAC,GACxB,OAAO,CAAC,WAAW,CAAC,CAGtB;AAuCD;;;;;GAKG;AACH,wBAAgB,UAAU,CAAC,QAAQ,EAAE,QAAQ,GAAG,MAAM,GAAG,IAAI,CAe5D"}
+{"version":3,"file":"fetchFile.d.ts","sourceRoot":"","sources":["../../client/fetchFile.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,OAAO,CAAC;AACrC,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,SAAS,CAAC;AAEzC;;;;GAIG;AACH,MAAM,MAAM,QAAQ,GAAG,UAAU,CAAC,OAAO,CAAC,CAAC;AAE3C,0DAA0D;AAC1D,MAAM,MAAM,UAAU,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,SAAS,CAAC,KAAK,CAAC,GAAG,MAAM,GAAG,MAAM,CAAC,GAAG,MAAM,CAAC;AAElF,MAAM,MAAM,gBAAgB,CAAC,CAAC,SAAS,MAAM,IAAI;IAC/C,4DAA4D;IAC5D,MAAM,CAAC,EAAE,OAAO,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,CAAC;IAC/B,oEAAoE;IACpE,MAAM,CAAC,EACH,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,OAAO,GAAG,IAAI,GAAG,SAAS,CAAC,GAC5D,eAAe,CAAC;IACpB,kFAAkF;IAClF,MAAM,CAAC,EAAE,WAAW,CAAC;IACrB,qFAAqF;IACrF,IAAI,CAAC,EAAE,IAAI,CAAC,WAAW,EAAE,QAAQ,GAAG,MAAM,GAAG,QAAQ,CAAC,CAAC;CACxD,CAAC;AAGF,gBAAgB;AAChB,MAAM,MAAM,aAAa,CAAC,CAAC,SAAS,MAAM,IACxC,EAAE,SAAS,SAAS,CAAC,CAAC,CAAC,GACnB,CAAC,OAAO,CAAC,EAAE,gBAAgB,CAAC,CAAC,CAAC,CAAC,GAC/B,CAAC,OAAO,EAAE,gBAAgB,CAAC,CAAC,CAAC,GAAG;IAAE,MAAM,EAAE,SAAS,CAAC,CAAC,CAAC,CAAA;CAAE,CAAC,CAAC;AAEhE,UAAU,OAAO;IACf;;;OAGG;IACH,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;IACxB,wEAAwE;IACxE,QAAQ,EAAE,QAAQ,CAAC;CACpB;AAED,MAAM,WAAW,WAAY,SAAQ,OAAO;IAC1C,IAAI,EAAE,IAAI,CAAC;CACZ;AAED,MAAM,WAAW,WAAY,SAAQ,OAAO;IAC1C,IAAI,EAAE,MAAM,CAAC;CACd;AASD;;;;;;;;;;;;;;;;;;GAkBG;AACH,wBAAsB,SAAS,CAAC,CAAC,SAAS,QAAQ,EAChD,IAAI,EAAE,CAAC,EACP,GAAG,IAAI,EAAE,aAAa,CAAC,CAAC,CAAC,GACxB,OAAO,CAAC,WAAW,CAAC,CAEtB;AAED,+CAA+C;AAC/C,wBAAsB,SAAS,CAAC,CAAC,SAAS,QAAQ,EAChD,IAAI,EAAE,CAAC,EACP,GAAG,IAAI,EAAE,aAAa,CAAC,CAAC,CAAC,GACxB,OAAO,CAAC,WAAW,CAAC,CAEtB"}

package/dist/client/fetchFileRequest.d.ts

@@ -0,0 +1,14 @@
+import type { FetchedBlob, FetchedText } from "./fetchFile";
+/**
+ * `fetchBlob` / `fetchText` once loaded: the `GET`, a `QueryError` for a
+ * non-2xx, and the body read `as` a blob or text.
+ */
+export declare function fetchFile(path: string, options: object | undefined, as: "blob" | "text"): Promise<FetchedBlob | FetchedText>;
+/**
+ * The file name in a `Content-Disposition` header: the RFC 5987
+ * `filename*=UTF-8''...` form when present and decodable, else `filename`.
+ *
+ * @internal Exported for tests.
+ */
+export declare function filenameOf(response: Response): string | null;
+//# sourceMappingURL=fetchFileRequest.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"fetchFileRequest.d.ts","sourceRoot":"","sources":["../../client/fetchFileRequest.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,WAAW,EAAE,WAAW,EAAoB,MAAM,aAAa,CAAC;AAW9E;;;GAGG;AACH,wBAAsB,SAAS,CAC7B,IAAI,EAAE,MAAM,EAEZ,OAAO,EAAE,MAAM,GAAG,SAAS,EAC3B,EAAE,EAAE,MAAM,GAAG,MAAM,GAClB,OAAO,CAAC,WAAW,GAAG,WAAW,CAAC,CAIpC;AAmCD;;;;;GAKG;AACH,wBAAgB,UAAU,CAAC,QAAQ,EAAE,QAAQ,GAAG,MAAM,GAAG,IAAI,CAe5D"}