gemi 0.129.0 → 0.131.0

package/dist/chunks/MutationError-DuKqBW8o.js

@@ -0,0 +1,199 @@
+//#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 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"
+};
+/** @internal */
+function isObject(error) {
+	return typeof error === "object" && error !== null;
+}
+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
+* 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.88 sent for most refusals, becomes
+* `{ kind, message, status }`, and so does a `{ message }` without a kind.
+*
+* @internal
+*/
+function mutationErrorFromBody(body, status) {
+	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) {
+	return isObject(error) && error.kind === "validation_error";
+}
+/** A form-level message, as `<FormError>` renders it. */
+function isFormError(error) {
+	return isObject(error) && error.kind === "form_error";
+}
+/** No signed-in user: `AuthenticationError` (401). */
+function isAuthenticationError(error) {
+	return kindOf(error) === "authentication";
+}
+/**
+* A signed-in user who may not do this: `InsufficientPermissionsError` (403),
+* `AuthorizationError` (401) or a policy denial (403), whatever message it was
+* thrown with.
+*/
+function isPermissionError(error) {
+	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 kindOf(error) === "csrf";
+}
+/** A missing record, file or route (404). */
+function isNotFoundError(error) {
+	return kindOf(error) === "not_found";
+}
+/**
+* `RateLimitMiddleware` or `RateLimiter.enforce` refused the request (429).
+* `retryAfter` (ms) says when to try again, when the server sent it.
+*/
+function isRateLimitError(error) {
+	return kindOf(error) === "rate_limit";
+}
+/**
+* The server failed (a 500, under `gemi dev` too), or answered something that
+* is not JSON.
+*/
+function isServerError(error) {
+	return kindOf(error) === "server_error" || error instanceof SyntaxError;
+}
+/** The request got no answer: offline, DNS, CORS, a dropped connection. */
+function isNetworkError(error) {
+	return error instanceof TypeError;
+}
+/**
+* Which of the guards above `error` passes, for a `switch` over all of them.
+* `"unknown"` is everything else: a 416, an error body of the app's own shape.
+*/
+function mutationErrorKind(error) {
+	if (isValidationError(error)) return "validation";
+	if (isFormError(error)) return "form";
+	if (isAuthenticationError(error)) return "authentication";
+	if (isPermissionError(error)) return "permission";
+	if (isCsrfError(error)) return "csrf";
+	if (isNotFoundError(error)) return "not_found";
+	if (isRateLimitError(error)) return "rate_limit";
+	if (isServerError(error)) return "server";
+	if (isNetworkError(error)) return "network";
+	return "unknown";
+}
+/**
+* An error answered with `status`: a route's typed error from
+* `HttpResponse.error(status, body)` / `httpError`, narrowed to the members
+* of `error`'s type with that status.
+*
+* ```ts
+* onError: (error) => {
+*   if (isHttpError(error, 410)) toast(error.message);
+* }
+* ```
+*
+* At run time it checks the status alone, so gemi's own refusals with the
+* same status (a 404 `not_found`, a 429 `rate_limit`) pass it too; pick a
+* status gemi does not use for its own errors, or check `kind` after it.
+*/
+function isHttpError(error, status) {
+	return isObject(error) && !(error instanceof Error) && error.status === status;
+}
+var FALLBACK_MESSAGE = "Something went wrong. Try again.";
+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;
+}
+/**
+* `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.
+*/
+function mutationErrorList(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];
+}
+/**
+* `error.field(name)` for any value: a validation error's messages for
+* `name` (a `QueryError`'s body is read), `[]` for anything else.
+*/
+function mutationErrorField(error, name) {
+	const value = unwrapQueryError(error);
+	if (!isValidationError(value)) return [];
+	const messages = value.messages?.[name];
+	return Array.isArray(messages) ? [...messages] : [];
+}
+//#endregion
+export { isNetworkError as a, isPermissionError as c, isValidationError as d, mutationErrorField as f, mutationErrorList as h, isHttpError as i, isRateLimitError as l, mutationErrorKind as m, isCsrfError as n, isNotFoundError as o, mutationErrorFromBody as p, isFormError as r, isObject as s, isAuthenticationError as t, isServerError as u };
+
+//# sourceMappingURL=MutationError-DuKqBW8o.js.map

package/dist/chunks/MutationError-DuKqBW8o.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"MutationError-DuKqBW8o.js","names":[],"sources":["../../http/refusal.ts","../../client/MutationError.ts"],"sourcesContent":["/**\n * The shape of a refusal on the wire: the `error` field of a non-2xx `/api`\n * answer, for every refusal gemi sends.\n *\n * It was a bare string for most of them (`\"Not authorized\"`, `\"Invalid CSRF\n * token\"`, a 500's message) and `{ message }` for the rest. A string carries no\n * status, so a client could only classify the framework's default messages: an\n * `AuthorizationError` thrown with a message of its own, the rule the skill\n * teaches, was `\"unknown\"`, and apps compared strings (issue #673).\n *\n * Shared by the server, which builds it, and the client, which reads it and\n * wraps an older server's bare strings into it, so this module imports nothing.\n */\n\n/**\n * Which refusal this is. `validation_error` and `form_error` predate the rest\n * and keep their spelling, and `server_error` is the kind `useUpload` already\n * reported for a failed upload, so a 500 has one name wherever it comes from.\n */\nexport type RefusalKind =\n  /** No signed-in user: `AuthenticationError` (401). */\n  | \"authentication\"\n  /** `AuthorizationError` (401): a known user refused this action. */\n  | \"authorization\"\n  /** `InsufficientPermissionsError` (403) or a policy denial (403). */\n  | \"permission\"\n  /** `InvalidCSRFTokenError` (403): the CSRF cookie is missing or stale. */\n  | \"csrf\"\n  /** A missing record, file or route (404). */\n  | \"not_found\"\n  /** A `Range` the object cannot satisfy (416). */\n  | \"range_not_satisfiable\"\n  /** `RateLimitMiddleware` or `RateLimiter.enforce` refused the request (429). */\n  | \"rate_limit\"\n  /** An unhandled exception (500). */\n  | \"server_error\"\n  /** A single form-level message, which `<FormError>` renders. */\n  | \"form_error\"\n  /** `ValidationError` (400). Carries `messages` instead of `message`. */\n  | \"validation_error\";\n\n/** A refusal's `error`, apart from `validation_error`, which has `messages`. */\nexport type Refusal<K extends RefusalKind = Exclude<RefusalKind, \"validation_error\">> = {\n  kind: K;\n  message: string;\n  status: number;\n  /**\n   * `rate_limit` only: milliseconds until a retry can succeed, when the\n   * limiter knew (the `rate-limit` middleware, `RateLimiter.enforce`).\n   */\n  retryAfter?: number;\n};\n\n/**\n * The kind a status stands for, for a refusal that does not name one: an app's\n * own `RequestBreakerError`, or an older server's `{ message }`. Any other 4xx\n * is a `form_error`, a message about this request for `<FormError>` to show.\n */\nexport function refusalKindForStatus(status: number): Exclude<RefusalKind, \"validation_error\"> {\n  if (status === 401) return \"authentication\";\n  if (status === 403) return \"permission\";\n  if (status === 404) return \"not_found\";\n  if (status === 416) return \"range_not_satisfiable\";\n  if (status === 429) return \"rate_limit\";\n  if (status >= 500) return \"server_error\";\n  return \"form_error\";\n}\n","import { refusalKindForStatus, type RefusalKind } from \"../http/refusal\";\n\n/**\n * What a failed mutation hands `onError` and puts in `error` — `useMutation`\n * and its `usePost`/`usePut`/`usePatch`/`useDelete` shorthands, `useUpload`,\n * and `<Form onError>`.\n *\n * It was typed `any` on `<Form>` and on the hooks' `error`, and as a union of\n * `kind`s the server never sent (`not_authorized`, `insufficient_permissions`)\n * on the hooks' `onError`. Apps sniffed the shape themselves, and got it wrong\n * as easily as right. This is the shape the framework actually produces,\n * member by member, read off the server's error payloads and the client's\n * fetch code (issue #626).\n *\n * Since 0.88 every refusal is an object with a `kind`, its `message` and the\n * `status` it came with (issue #673). Most refusals were a bare string before,\n * which carried no status, so a refusal thrown with a message of its own could\n * not be told apart from any other string. A server older than 0.85 still sends\n * those strings; the client wraps them into the same object, so the guards and\n * `error.message` work against either.\n */\n\n/** A server-side `ValidationError` (400): messages keyed by field. */\nexport interface MutationValidationError {\n  kind: \"validation_error\";\n  messages: Record<string, string[]>;\n  status?: number;\n}\n\n/**\n * A single form-level message, which `<FormError>` renders: a\n * `RequestBreakerError` of the app's own, or any other 4xx that answered a\n * message without a kind of its own.\n */\nexport interface MutationFormError {\n  kind: \"form_error\";\n  message: string;\n  status?: number;\n}\n\n/**\n * The server failed: an unhandled exception (500; under `gemi dev` the message\n * is the exception's), or a failed `useUpload` whose body was not JSON.\n */\nexport interface MutationServerError {\n  kind: \"server_error\";\n  message: string;\n  status?: number;\n}\n\n/** The refusals other than the three above. */\nexport type MutationRefusalKind = Exclude<\n  RefusalKind,\n  \"validation_error\" | \"form_error\" | \"server_error\"\n>;\n\n/**\n * A refusal: `authentication` (401), `authorization` (`AuthorizationError`,\n * 401), `permission` (`InsufficientPermissionsError` or a policy, 403), `csrf`\n * (403), `not_found` (404), `range_not_satisfiable` (416) or `rate_limit`\n * (429). `message` is the one it was thrown with.\n */\nexport interface MutationRefusal<K extends MutationRefusalKind = MutationRefusalKind> {\n  kind: K;\n  message: string;\n  status: number;\n  /**\n   * `rate_limit` only: milliseconds until a retry can succeed, when the\n   * server's limiter knew (the `rate-limit` middleware, `RateLimiter.enforce`).\n   */\n  retryAfter?: number;\n}\n\n/**\n * @deprecated A `{ message }` body is wrapped into a `MutationRefusal` or\n * `MutationFormError` since 0.88, and `MutationError` no longer includes this.\n */\nexport interface MutationMessageError {\n  kind?: undefined;\n  message: string;\n}\n\n/**\n * Every value `onError` receives and `error` holds for a request gemi's server\n * answered, or failed to reach:\n *\n * - `MutationValidationError`, `MutationFormError`, `MutationServerError`,\n *   `MutationRefusal` — tagged with `kind`, and (from the server) `status`.\n * - `Error` — raised in the browser: a `TypeError` when the request never got\n *   an answer (offline, DNS, CORS), a `SyntaxError` when the answer was not\n *   JSON (a proxy's HTML error page, say). A throw from an `onSuccess` of\n *   yours is reported through `onError` as well, as whatever it threw.\n *\n * Never a string since 0.88. A cancelled request is not an error: `onCanceled`\n * runs and `error` stays `null`. A route's typed errors — the bodies its\n * handler answers with `HttpResponse.error(status, body)` / `httpError` — are\n * added to this union on its hooks and `<Form>` (`MutationError | E`). Any\n * other error body of the route's own shape is outside this type: a body with an `error` field\n * (`HttpResponse.json({ error }, { status: 409 })`) hands over that field, as\n * gemi's own errors do, and any other body is handed over whole. Either is\n * given a `kind` (from the status) and the `status` when it is an object with\n * a string `message` and no `kind`, and becomes one when it is a string.\n */\nexport type MutationError =\n  | MutationValidationError\n  | MutationFormError\n  | MutationServerError\n  | MutationRefusal\n  | Error;\n\n/** What `mutationErrorKind` answers, one per guard below. */\nexport type MutationErrorKind =\n  | \"validation\"\n  | \"form\"\n  | \"authentication\"\n  | \"permission\"\n  | \"csrf\"\n  | \"not_found\"\n  | \"rate_limit\"\n  | \"server\"\n  | \"network\"\n  | \"unknown\";\n\n// What a server before 0.88 sent: the framework's own messages, as bare\n// strings, or as `{ message }`. Read so a client on 0.85 classifies an older\n// server's refusals during a rolling deploy. Remove in 0.86.\nconst LEGACY_MESSAGES: Record<string, RefusalKind> = {\n  \"Authentication error\": \"authentication\",\n  \"Not authorized\": \"authorization\",\n  \"Insufficient permissions\": \"permission\",\n  \"Invalid CSRF token\": \"csrf\",\n  \"Internal Server Error\": \"server_error\",\n  Forbidden: \"permission\",\n  \"Not found\": \"not_found\",\n  \"Rate limit exceeded\": \"rate_limit\",\n};\n\n/** @internal */\nexport function isObject(error: unknown): error is Record<string, unknown> {\n  return typeof error === \"object\" && error !== null;\n}\n\n// A bare string from a server before 0.88. Its own message names the kind when\n// it is one of the framework's; otherwise the status does, and a 401 with a\n// message of its own can only be an `AuthorizationError` — an\n// `AuthenticationError` always says \"Authentication error\".\nfunction legacyKind(message: string, status: number): RefusalKind {\n  return (\n    LEGACY_MESSAGES[message] ?? (status === 401 ? \"authorization\" : refusalKindForStatus(status))\n  );\n}\n\n/**\n * The `MutationError` a non-2xx response's parsed body stands for.\n *\n * gemi's own error bodies are `{ error }`, and the value under `error` is what\n * is handed over. An app's body without one —\n * `HttpResponse.json({ message: \"Taken\" }, { status: 409 })` — is handed over\n * whole. A body with no content (`null`) becomes a refusal naming the status.\n *\n * What is handed over carries `status`, and a `kind` when it has a `message`:\n * a bare string, which servers before 0.88 sent for most refusals, becomes\n * `{ kind, message, status }`, and so does a `{ message }` without a kind.\n *\n * @internal\n */\nexport function mutationErrorFromBody(body: unknown, status: number): MutationError {\n  const error = isObject(body) && \"error\" in body && body.error != null ? body.error : body;\n  if (error == null) {\n    return {\n      kind: refusalKindForStatus(status),\n      message: `Request failed with status ${status}`,\n      status,\n    } as MutationError;\n  }\n  if (typeof error === \"string\") {\n    return { kind: legacyKind(error, status), message: error, status } as MutationError;\n  }\n  if (!isObject(error) || error instanceof Error) {\n    return error as MutationError;\n  }\n  const withStatus = { ...error, status: typeof error.status === \"number\" ? error.status : status };\n  if (typeof error.kind !== \"string\" && typeof error.message === \"string\") {\n    return {\n      ...withStatus,\n      // The status alone places an older server's `{ message }` bodies (403\n      // \"Forbidden\", 404, 429), and it is what an app's own body means.\n      kind: refusalKindForStatus(withStatus.status),\n    } as MutationError;\n  }\n  return withStatus as MutationError;\n}\n\n// The kind a value stands for: its `kind`; else, for an object that has none,\n// its `status`; else one of the framework's old messages, as a bare string or\n// `{ message }`, for a body handed to a guard straight off an older server.\nfunction kindOf(error: unknown): string | undefined {\n  if (typeof error === \"string\") return LEGACY_MESSAGES[error];\n  if (!isObject(error) || error instanceof Error) return undefined;\n  if (typeof error.kind === \"string\") return error.kind;\n  if (typeof error.status === \"number\") return refusalKindForStatus(error.status);\n  return typeof error.message === \"string\" ? LEGACY_MESSAGES[error.message] : undefined;\n}\n\n// The guards read `kind`, falling back to `status`, and accept the bare\n// strings and `{ message }` bodies of a server before 0.88 for one minor. What\n// the hooks hand over is already wrapped, so those fallbacks only matter for a\n// body passed in by hand.\n\n/** Field messages, as `<ValidationErrors>` renders them. */\nexport function isValidationError(\n  error: unknown,\n): error is MutationValidationError {\n  return isObject(error) && error.kind === \"validation_error\";\n}\n\n/** A form-level message, as `<FormError>` renders it. */\nexport function isFormError(error: unknown): error is MutationFormError {\n  return isObject(error) && error.kind === \"form_error\";\n}\n\n/** No signed-in user: `AuthenticationError` (401). */\nexport function isAuthenticationError(\n  error: unknown,\n): error is MutationRefusal<\"authentication\"> {\n  return kindOf(error) === \"authentication\";\n}\n\n/**\n * A signed-in user who may not do this: `InsufficientPermissionsError` (403),\n * `AuthorizationError` (401) or a policy denial (403), whatever message it was\n * thrown with.\n */\nexport function isPermissionError(\n  error: unknown,\n): error is MutationRefusal<\"permission\" | \"authorization\"> {\n  const kind = kindOf(error);\n  return kind === \"permission\" || kind === \"authorization\";\n}\n\n/** The CSRF cookie is missing or stale (403). A reload fixes it. */\nexport function isCsrfError(error: unknown): error is MutationRefusal<\"csrf\"> {\n  return kindOf(error) === \"csrf\";\n}\n\n/** A missing record, file or route (404). */\nexport function isNotFoundError(\n  error: unknown,\n): error is MutationRefusal<\"not_found\"> {\n  return kindOf(error) === \"not_found\";\n}\n\n/**\n * `RateLimitMiddleware` or `RateLimiter.enforce` refused the request (429).\n * `retryAfter` (ms) says when to try again, when the server sent it.\n */\nexport function isRateLimitError(\n  error: unknown,\n): error is MutationRefusal<\"rate_limit\"> {\n  return kindOf(error) === \"rate_limit\";\n}\n\n/**\n * The server failed (a 500, under `gemi dev` too), or answered something that\n * is not JSON.\n */\nexport function isServerError(\n  error: unknown,\n): error is MutationServerError | SyntaxError {\n  return kindOf(error) === \"server_error\" || error instanceof SyntaxError;\n}\n\n/** The request got no answer: offline, DNS, CORS, a dropped connection. */\nexport function isNetworkError(error: unknown): error is TypeError {\n  return error instanceof TypeError;\n}\n\n/**\n * Which of the guards above `error` passes, for a `switch` over all of them.\n * `\"unknown\"` is everything else: a 416, an error body of the app's own shape.\n */\nexport function mutationErrorKind(error: unknown): MutationErrorKind {\n  if (isValidationError(error)) return \"validation\";\n  if (isFormError(error)) return \"form\";\n  if (isAuthenticationError(error)) return \"authentication\";\n  if (isPermissionError(error)) return \"permission\";\n  if (isCsrfError(error)) return \"csrf\";\n  if (isNotFoundError(error)) return \"not_found\";\n  if (isRateLimitError(error)) return \"rate_limit\";\n  if (isServerError(error)) return \"server\";\n  if (isNetworkError(error)) return \"network\";\n  return \"unknown\";\n}\n\n/**\n * The members of `E` answered with status `S`. When none of them names it — an\n * `unknown`, or a `MutationError` alone — `E` with that status, rather than\n * `never`.\n */\nexport type HttpErrorWithStatus<E, S extends number> = [Extract<E, { status: S }>] extends [never]\n  ? E & { status: S }\n  : Extract<E, { status: S }>;\n\n/**\n * An error answered with `status`: a route's typed error from\n * `HttpResponse.error(status, body)` / `httpError`, narrowed to the members\n * of `error`'s type with that status.\n *\n * ```ts\n * onError: (error) => {\n *   if (isHttpError(error, 410)) toast(error.message);\n * }\n * ```\n *\n * At run time it checks the status alone, so gemi's own refusals with the\n * same status (a 404 `not_found`, a 429 `rate_limit`) pass it too; pick a\n * status gemi does not use for its own errors, or check `kind` after it.\n */\nexport function isHttpError<E, S extends number>(\n  error: E,\n  status: S,\n): error is HttpErrorWithStatus<E, S> {\n  return isObject(error) && !(error instanceof Error) && error.status === status;\n}\n\n/**\n * What every error the mutation hooks hand over carries (issue #890): the\n * messages to show a person, without flattening `messages` by hand.\n */\nexport interface MutationErrorHelpers {\n  /**\n   * The failure in words, as a flat list that is never empty: a validation\n   * error's messages, every field's in the order the server sent them; the\n   * `message` of any other error the server meant for a person (a form error,\n   * a refusal, a route's typed error); else `[fallback]` — for a server error,\n   * whose message is an exception's under `gemi dev`, and for the browser's\n   * own errors (no answer, an answer that was not JSON).\n   *\n   * `fallback` defaults to `\"Something went wrong. Try again.\"`.\n   */\n  list(fallback?: string): string[];\n  /** A validation error's messages for the field `name`; `[]` otherwise. */\n  field(name: string): string[];\n}\n\n/**\n * `T` with the helpers, member by member. A member that has a `list` or\n * `field` of its own — a route's typed error body with a `field` key — keeps\n * it, and does not get that helper.\n */\nexport type WithMutationErrorHelpers<T> = T extends object\n  ? T & Omit<MutationErrorHelpers, keyof T>\n  : T;\n\nconst FALLBACK_MESSAGE = \"Something went wrong. Try again.\";\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/**\n * `error.list(fallback)` for any value: an error kept from a mutation, a\n * `useQuery` `QueryError` (its body is read), or anything else.\n *\n * Kept in step with `list` in `./mutationErrorHelpers`, which the mutation\n * hooks load on first use (#915) and so cannot share this code: an app's\n * bundler would put it back in the entry chunk. `MutationError.helpers.test`\n * runs the same cases through both.\n */\nexport function mutationErrorList(\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/**\n * `error.field(name)` for any value: a validation error's messages for\n * `name` (a `QueryError`'s body is read), `[]` for anything else.\n */\nexport function mutationErrorField(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"],"mappings":";;;;;;AA0DA,SAAgB,qBAAqB,QAA0D;CAC7F,IAAI,WAAW,KAAK,OAAO;CAC3B,IAAI,WAAW,KAAK,OAAO;CAC3B,IAAI,WAAW,KAAK,OAAO;CAC3B,IAAI,WAAW,KAAK,OAAO;CAC3B,IAAI,WAAW,KAAK,OAAO;CAC3B,IAAI,UAAU,KAAK,OAAO;CAC1B,OAAO;AACT;;;AC4DA,IAAM,kBAA+C;CACnD,wBAAwB;CACxB,kBAAkB;CAClB,4BAA4B;CAC5B,sBAAsB;CACtB,yBAAyB;CACzB,WAAW;CACX,aAAa;CACb,uBAAuB;AACzB;;AAGA,SAAgB,SAAS,OAAkD;CACzE,OAAO,OAAO,UAAU,YAAY,UAAU;AAChD;AAMA,SAAS,WAAW,SAAiB,QAA6B;CAChE,OACE,gBAAgB,aAAa,WAAW,MAAM,kBAAkB,qBAAqB,MAAM;AAE/F;;;;;;;;;;;;;;;AAgBA,SAAgB,sBAAsB,MAAe,QAA+B;CAClF,MAAM,QAAQ,SAAS,IAAI,KAAK,WAAW,QAAQ,KAAK,SAAS,OAAO,KAAK,QAAQ;CACrF,IAAI,SAAS,MACX,OAAO;EACL,MAAM,qBAAqB,MAAM;EACjC,SAAS,8BAA8B;EACvC;CACF;CAEF,IAAI,OAAO,UAAU,UACnB,OAAO;EAAE,MAAM,WAAW,OAAO,MAAM;EAAG,SAAS;EAAO;CAAO;CAEnE,IAAI,CAAC,SAAS,KAAK,KAAK,iBAAiB,OACvC,OAAO;CAET,MAAM,aAAa;EAAE,GAAG;EAAO,QAAQ,OAAO,MAAM,WAAW,WAAW,MAAM,SAAS;CAAO;CAChG,IAAI,OAAO,MAAM,SAAS,YAAY,OAAO,MAAM,YAAY,UAC7D,OAAO;EACL,GAAG;EAGH,MAAM,qBAAqB,WAAW,MAAM;CAC9C;CAEF,OAAO;AACT;AAKA,SAAS,OAAO,OAAoC;CAClD,IAAI,OAAO,UAAU,UAAU,OAAO,gBAAgB;CACtD,IAAI,CAAC,SAAS,KAAK,KAAK,iBAAiB,OAAO,OAAO,KAAA;CACvD,IAAI,OAAO,MAAM,SAAS,UAAU,OAAO,MAAM;CACjD,IAAI,OAAO,MAAM,WAAW,UAAU,OAAO,qBAAqB,MAAM,MAAM;CAC9E,OAAO,OAAO,MAAM,YAAY,WAAW,gBAAgB,MAAM,WAAW,KAAA;AAC9E;;AAQA,SAAgB,kBACd,OACkC;CAClC,OAAO,SAAS,KAAK,KAAK,MAAM,SAAS;AAC3C;;AAGA,SAAgB,YAAY,OAA4C;CACtE,OAAO,SAAS,KAAK,KAAK,MAAM,SAAS;AAC3C;;AAGA,SAAgB,sBACd,OAC4C;CAC5C,OAAO,OAAO,KAAK,MAAM;AAC3B;;;;;;AAOA,SAAgB,kBACd,OAC0D;CAC1D,MAAM,OAAO,OAAO,KAAK;CACzB,OAAO,SAAS,gBAAgB,SAAS;AAC3C;;AAGA,SAAgB,YAAY,OAAkD;CAC5E,OAAO,OAAO,KAAK,MAAM;AAC3B;;AAGA,SAAgB,gBACd,OACuC;CACvC,OAAO,OAAO,KAAK,MAAM;AAC3B;;;;;AAMA,SAAgB,iBACd,OACwC;CACxC,OAAO,OAAO,KAAK,MAAM;AAC3B;;;;;AAMA,SAAgB,cACd,OAC4C;CAC5C,OAAO,OAAO,KAAK,MAAM,kBAAkB,iBAAiB;AAC9D;;AAGA,SAAgB,eAAe,OAAoC;CACjE,OAAO,iBAAiB;AAC1B;;;;;AAMA,SAAgB,kBAAkB,OAAmC;CACnE,IAAI,kBAAkB,KAAK,GAAG,OAAO;CACrC,IAAI,YAAY,KAAK,GAAG,OAAO;CAC/B,IAAI,sBAAsB,KAAK,GAAG,OAAO;CACzC,IAAI,kBAAkB,KAAK,GAAG,OAAO;CACrC,IAAI,YAAY,KAAK,GAAG,OAAO;CAC/B,IAAI,gBAAgB,KAAK,GAAG,OAAO;CACnC,IAAI,iBAAiB,KAAK,GAAG,OAAO;CACpC,IAAI,cAAc,KAAK,GAAG,OAAO;CACjC,IAAI,eAAe,KAAK,GAAG,OAAO;CAClC,OAAO;AACT;;;;;;;;;;;;;;;;AA0BA,SAAgB,YACd,OACA,QACoC;CACpC,OAAO,SAAS,KAAK,KAAK,EAAE,iBAAiB,UAAU,MAAM,WAAW;AAC1E;AA+BA,IAAM,mBAAmB;AAIzB,SAAS,iBAAiB,OAAyB;CACjD,IAAI,iBAAiB,SAAS,MAAM,SAAS,gBAAgB,UAAU,OAAO;EAC5E,MAAM,EAAE,MAAM,WAAW;EACzB,OAAO,QAAQ,OAAO,QAAQ,sBAAsB,MAAM,MAAM;CAClE;CACA,OAAO;AACT;;;;;;;;;;AAWA,SAAgB,kBACd,OACA,WAAmB,kBACT;CACV,MAAM,QAAQ,iBAAiB,KAAK;CACpC,IAAI,kBAAkB,KAAK,GAAG;EAC5B,MAAM,WAAW,OAAO,OAAO,MAAM,YAAY,CAAC,CAAC,CAAC,CACjD,KAAK,CAAC,CACN,QAAQ,YAAY,OAAO,YAAY,YAAY,YAAY,EAAE;EACpE,OAAO,SAAS,SAAS,IAAI,WAAW,CAAC,QAAQ;CACnD;CACA,IACE,SAAS,KAAK,KACd,EAAE,iBAAiB,UACnB,MAAM,SAAS,kBACf,OAAO,MAAM,YAAY,YACzB,MAAM,YAAY,IAElB,OAAO,CAAC,MAAM,OAAO;CAEvB,OAAO,CAAC,QAAQ;AAClB;;;;;AAMA,SAAgB,mBAAmB,OAAgB,MAAwB;CACzE,MAAM,QAAQ,iBAAiB,KAAK;CACpC,IAAI,CAAC,kBAAkB,KAAK,GAAG,OAAO,CAAC;CACvC,MAAM,WAAW,MAAM,WAAW;CAClC,OAAO,MAAM,QAAQ,QAAQ,IAAI,CAAC,GAAG,QAAQ,IAAI,CAAC;AACpD"}

package/dist/chunks/{RealtimeClient-CqGve6h8.js → RealtimeClient-DsWbFRC7.js}

@@ -1,4 +1,5 @@
-import { z as channelKey } from "./ThemeProvider-DaX0eyqs.js";
+import { H as realtime } from "./ThemeProvider-gWqXjGh-.js";
+import { t as channelKey } from "./channelKey-CIhHpX6x.js";
 //#region services/broadcast/protocol.ts
 /**
 * The `gemi.v1` WebSocket protocol, shared by the server transport
@@ -539,7 +540,14 @@ function reportListenerError(error) {
 		throw error;
 	});
 }
+/**
+* The tab's client, created on first use with the options `configureRealtime`
+* set. `loadRealtimeClient` in `./loader` calls it once this module is loaded.
+*/
+function tabClient() {
+	return realtime.client ??= new RealtimeClient(realtime.options);
+}
 //#endregion
-export { IDLE_CLOSE_MS, MAX_LIMIT_RETRIES, RELEASE_LINGER_MS, RESYNC_COALESCE_MS, RealtimeClient, backoffDelay };
+export { IDLE_CLOSE_MS, MAX_LIMIT_RETRIES, RELEASE_LINGER_MS, RESYNC_COALESCE_MS, RealtimeClient, backoffDelay, tabClient };
 
-//# sourceMappingURL=RealtimeClient-CqGve6h8.js.map
+//# sourceMappingURL=RealtimeClient-DsWbFRC7.js.map

package/dist/chunks/RealtimeClient-DsWbFRC7.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"RealtimeClient-DsWbFRC7.js","names":[],"sources":["../../services/broadcast/protocol.ts","../../client/realtime/RealtimeClient.ts"],"sourcesContent":["/**\n * The `gemi.v1` WebSocket protocol, shared by the server transport\n * (`SocketHub`) and the browser client (`gemi/client`'s connection manager).\n * Types and constants only: this module is imported by the browser bundle, so\n * it must never import a server module.\n *\n * Every frame is a JSON text frame. Binary frames are refused.\n *\n * From the client:\n *\n * - `{op:\"sub\", id, ch, p?}`: subscribe `id` (chosen by the client, unique per\n *   socket) to the channel pattern `ch` with params `p`. The server builds\n *   the topic and authorizes it.\n * - `{op:\"unsub\", id}`\n * - `{op:\"ping\"}`: answered with `pong`. The client sends one every\n *   `heartbeatMs` and reconnects when it hears nothing for twice that.\n *\n * From the server:\n *\n * - `{op:\"hello\", socketId, tag, heartbeatMs}`: the first frame. `socketId`\n *   goes in the `X-Gemi-Socket` header of the client's own requests (for\n *   `Broadcast.toOthers`); it is never shown to anyone else. `tag` is what\n *   an event frame's `x` carries when it skips this socket.\n * - `{op:\"subscribed\", id, t}`: `id` joined topic `t`. Sent only once this\n *   process receives the topic's events, so the resync the client runs on it\n *   cannot miss one.\n * - `{op:\"denied\", id, code}`: `id` was refused, or later revoked.\n * - `{op:\"ev\", t, ev, d?, x?}`: an event on topic `t`. Dropped by the socket\n *   whose `tag` is `x`.\n * - `{op:\"gap\"}`: events may have been lost for this socket; resync all.\n * - `{op:\"pong\"}`\n * - `{op:\"bye\", code, retryAfter}`: the server is going away (a restart).\n *   Reconnect after `retryAfter` ms.\n */\n\n/** The WebSocket subprotocol. */\nexport const BROADCAST_PROTOCOL = \"gemi.v1\";\n\n/** The default endpoint, `defineBroadcastConfig({ path })`. */\nexport const DEFAULT_SOCKET_PATH = \"/__gemi/socket\";\n\nexport { SOCKET_ID_HEADER } from \"./socketHeader\";\n\n/** What a subscription id may look like. */\nexport const SUBSCRIPTION_ID = /^[A-Za-z0-9_-]{1,32}$/;\n\n/**\n * Close codes the server uses. 1012 and 1013 are the standard \"restart\" and\n * \"try again later\"; the 4xxx ones are gemi's own.\n */\nexport const CloseCode = {\n  /** The client went away (tab closed, socket released). */\n  Normal: 1000,\n  /** A frame that was not JSON text, or not a known op. */\n  UnsupportedData: 1003,\n  /** Too many frames, or a frame over the size limit. */\n  PolicyViolation: 1008,\n  /** The server is restarting; `bye` said when to come back. */\n  Restart: 1012,\n  /** The socket fell too far behind; reconnect and resync. */\n  TryAgainLater: 1013,\n  /** The socket's user was signed out or its access revoked. */\n  Revoked: 4001,\n} as const;\n\n/** Why a subscription was refused. */\nexport type DeniedCode =\n  /** No channel with that pattern. Permanent. */\n  | \"unknown_channel\"\n  /** Missing, extra or malformed params. Permanent. */\n  | \"invalid_params\"\n  /** The channel's authorization said no. */\n  | \"denied\"\n  /** Authorization failed (a session store outage, a bug). Retryable. */\n  | \"error\"\n  /** The socket has `maxChannelsPerSocket` subscriptions already. */\n  | \"limit\"\n  /** Too many `sub`/`unsub` frames; retry later. */\n  | \"rate_limited\"\n  /** The subscription was revoked by `Broadcast.revoke`. */\n  | \"revoked\"\n  /** The frame was malformed, or the id is already in use. */\n  | \"invalid\";\n\nexport type ClientFrame =\n  | { op: \"sub\"; id: string; ch: string; p?: Record<string, string | number> }\n  | { op: \"unsub\"; id: string }\n  | { op: \"ping\" };\n\nexport type ServerFrame =\n  | { op: \"hello\"; socketId: string; tag: string; heartbeatMs: number }\n  | { op: \"subscribed\"; id: string; t: string }\n  | { op: \"denied\"; id: string; code: DeniedCode }\n  | { op: \"ev\"; t: string; ev: string; d?: unknown; x?: string }\n  | { op: \"gap\" }\n  | { op: \"pong\" }\n  | { op: \"bye\"; code: number; retryAfter: number };\n\n/**\n * Whether a refusal is final for this socket's session: resubscribing will\n * get the same answer, so the client does not retry it on its own.\n */\nexport function isPermanentDenial(code: DeniedCode): boolean {\n  return code === \"unknown_channel\" || code === \"invalid_params\" || code === \"invalid\";\n}\n","import {\n  BROADCAST_PROTOCOL,\n  CloseCode,\n  DEFAULT_SOCKET_PATH,\n  isPermanentDenial,\n  type ClientFrame,\n  type DeniedCode,\n  type ServerFrame,\n} from \"../../services/broadcast/protocol\";\nimport { channelKey } from \"./channelKey\";\nimport { realtime } from \"./loader\";\n\n/**\n * Where a channel subscription stands, as the hooks report it.\n *\n * - `idle`: the hook is disabled (`enabled: false`).\n * - `connecting`: the socket is opening, or the `sub` awaits its answer.\n * - `open`: subscribed; events arrive.\n * - `denied`: the server refused (or revoked) it; `code` says why.\n * - `closed`: no socket, on the server, before the first effect, or while\n *   waiting to reconnect.\n */\nexport type ChannelStatus = \"idle\" | \"connecting\" | \"open\" | \"denied\" | \"closed\";\n\nexport type ChannelParamValues = Record<string, string | number>;\n\n/** What a hook hands the socket for one channel. */\nexport interface ChannelListener {\n  onEvent?(event: string, data: unknown): void;\n  /** Events may have been missed: refetch what the channel describes. */\n  onResync?(): void;\n  onStatus?(status: ChannelStatus, code: DeniedCode | null): void;\n}\n\n/**\n * What the hooks subscribe through: the tab's `RealtimeClient`, or a\n * `FakeSocket` in tests. Returns the release function.\n */\nexport interface RealtimeSocket {\n  subscribe(pattern: string, params: ChannelParamValues, listener: ChannelListener): () => void;\n}\n\nexport interface RealtimeOptions {\n  /** The socket endpoint, `defineBroadcastConfig({ path })`. Default `/__gemi/socket`. */\n  path?: string;\n  /**\n   * How long a hidden tab keeps its socket, in ms, before disconnecting. On\n   * becoming visible again it reconnects and resyncs. Default 60 000.\n   */\n  hiddenDisconnectMs?: number;\n}\n\ninterface ClientInternals {\n  /** Test seam: the WebSocket class. */\n  WebSocket?: typeof WebSocket;\n  /** Test seam: the full URL, instead of the page's origin + `path`. */\n  url?: string;\n  random?: () => number;\n}\n\n/** The minimum gap between two resyncs of one subscription. */\nexport const RESYNC_COALESCE_MS = 2_000;\n/** How long the socket stays open after its last subscription goes. */\nexport const IDLE_CLOSE_MS = 5_000;\n/**\n * How long a subscription outlives its last listener. A hook that remounts\n * within it (StrictMode's double mount, a route change back, a list that\n * re-renders its rows) picks the same subscription up again: no `unsub`, no\n * new `sub`, nothing counted against the server's rate limit.\n */\nexport const RELEASE_LINGER_MS = 1_500;\n/** The least wait before resending a `sub` denied with `rate_limited`. */\nconst RATE_LIMITED_RETRY_MS = 5_000;\n/**\n * How often a `sub` denied with `limit` is resent on one socket. The socket\n * holds as many channels as the server allows, so only a released one makes\n * room: worth a few tries with backoff, not a retry for as long as the socket\n * lives. Past it the subscription waits for the next connection.\n */\nexport const MAX_LIMIT_RETRIES = 5;\nconst MIN_BACKOFF_MS = 1_000;\nconst MAX_BACKOFF_MS = 30_000;\nconst DEFAULT_HEARTBEAT_MS = 25_000;\nconst DEFAULT_HIDDEN_DISCONNECT_MS = 60_000;\n\ninterface Entry {\n  key: string;\n  id: string;\n  pattern: string;\n  params: ChannelParamValues;\n  listeners: Set<ChannelListener>;\n  status: ChannelStatus;\n  code: DeniedCode | null;\n  /** Refused for good: not resent on a reconnect. */\n  permanent: boolean;\n  topic: string | null;\n  lastResyncAt: number;\n  resyncTimer: ReturnType<typeof setTimeout> | null;\n  /** Set while the entry outlives its last listener; see `RELEASE_LINGER_MS`. */\n  lingerTimer: ReturnType<typeof setTimeout> | null;\n  /** A transient denial's resend, on the same socket. */\n  retryTimer: ReturnType<typeof setTimeout> | null;\n  retries: number;\n}\n\n/**\n * The tab's one WebSocket to the app (`gemi.v1`), multiplexing every channel\n * the mounted hooks subscribe to.\n *\n * Opened by the first subscription and closed a few seconds after the last\n * one goes. Reconnects with full-jitter backoff (1 to 30 s), or after the\n * server's `bye.retryAfter`, at once on `online`; resubscribes everything\n * then. A tab hidden for `hiddenDisconnectMs` disconnects, and reconnects\n * when shown. Every `subscribed` ack and every `gap` resyncs the\n * subscription (coalesced to one per 2 s), because events are volatile: a\n * client that may have missed one refetches over HTTP.\n *\n * Loaded on first use (#891): import this module as a type only, and reach\n * the tab's instance through `./loader`, or it lands in every route's entry\n * chunk.\n */\nexport class RealtimeClient implements RealtimeSocket {\n  private options: Required<RealtimeOptions>;\n  private readonly internals: ClientInternals;\n  private ws: WebSocket | null = null;\n  private entries = new Map<string, Entry>();\n  private byId = new Map<string, Entry>();\n  private topics = new Map<string, Set<string>>();\n  private nextId = 1;\n  private attempt = 0;\n  private tag: string | null = null;\n  private socketIdValue: string | null = null;\n  private heartbeatMs = DEFAULT_HEARTBEAT_MS;\n  private reconnectTimer: ReturnType<typeof setTimeout> | null = null;\n  private idleTimer: ReturnType<typeof setTimeout> | null = null;\n  private hiddenTimer: ReturnType<typeof setTimeout> | null = null;\n  private pingTimer: ReturnType<typeof setInterval> | null = null;\n  private livenessTimer: ReturnType<typeof setTimeout> | null = null;\n  private retryAfter: number | null = null;\n  private revoked = false;\n  private pausedWhileHidden = false;\n  private listening = false;\n\n  constructor(options: RealtimeOptions = {}, internals: ClientInternals = {}) {\n    this.options = withDefaults(options);\n    this.internals = internals;\n  }\n\n  configure(options: RealtimeOptions) {\n    this.options = withDefaults({ ...this.options, ...options });\n  }\n\n  /** The id to send as `X-Gemi-Socket`, while the socket is open. */\n  get socketId(): string | null {\n    return this.socketIdValue;\n  }\n\n  subscribe(pattern: string, params: ChannelParamValues, listener: ChannelListener): () => void {\n    const key = channelKey(pattern, params);\n    let entry = this.entries.get(key);\n    if (!entry) {\n      entry = {\n        key,\n        id: String(this.nextId++),\n        pattern,\n        params: { ...params },\n        listeners: new Set(),\n        status: \"closed\",\n        code: null,\n        permanent: false,\n        topic: null,\n        lastResyncAt: 0,\n        resyncTimer: null,\n        lingerTimer: null,\n        retryTimer: null,\n        retries: 0,\n      };\n      this.entries.set(key, entry);\n      this.byId.set(entry.id, entry);\n      if (this.isOpen()) {\n        this.sendSub(entry);\n      }\n    }\n    if (entry.lingerTimer) {\n      clearTimeout(entry.lingerTimer);\n      entry.lingerTimer = null;\n    }\n    entry.listeners.add(listener);\n    listener.onStatus?.(entry.status, entry.code);\n    this.cancelIdleClose();\n    this.listen();\n    if (!this.ws && !this.reconnectTimer && !this.pausedWhileHidden) {\n      this.connect();\n    }\n\n    let released = false;\n    return () => {\n      if (released) return;\n      released = true;\n      this.release(entry!, listener);\n    };\n  }\n\n  private release(entry: Entry, listener: ChannelListener) {\n    entry.listeners.delete(listener);\n    if (entry.listeners.size > 0 || entry.lingerTimer) return;\n    entry.lingerTimer = setTimeout(() => {\n      entry.lingerTimer = null;\n      if (entry.listeners.size === 0) this.drop(entry);\n    }, RELEASE_LINGER_MS);\n  }\n\n  private drop(entry: Entry) {\n    if (entry.resyncTimer) clearTimeout(entry.resyncTimer);\n    this.clearRetry(entry);\n    this.entries.delete(entry.key);\n    this.byId.delete(entry.id);\n    this.dropTopic(entry);\n    if (this.isOpen() && (entry.status === \"open\" || entry.status === \"connecting\")) {\n      this.send({ op: \"unsub\", id: entry.id });\n    }\n    if (this.entries.size === 0) this.scheduleIdleClose();\n  }\n\n  private isOpen() {\n    return this.ws !== null && this.ws.readyState === 1;\n  }\n\n  private connect() {\n    if (typeof window === \"undefined\") return;\n    if (this.entries.size === 0) return;\n    const Impl = this.internals.WebSocket ?? globalThis.WebSocket;\n    if (!Impl) return;\n    this.clearReconnect();\n    let ws: WebSocket;\n    try {\n    ws = new Impl(this.url(), [BROADCAST_PROTOCOL]);\n    } catch {\n      this.scheduleReconnect();\n      return;\n    }\n    this.ws = ws;\n    for (const entry of this.entries.values()) {\n      if (!entry.permanent) this.setStatus(entry, \"connecting\", null);\n    }\n    ws.onopen = () => {\n      if (this.ws !== ws) return;\n      this.touch();\n      for (const entry of this.entries.values()) {\n        if (entry.permanent) continue;\n        // A new socket starts every transient denial's count over.\n        entry.retries = 0;\n        this.sendSub(entry);\n      }\n    };\n    ws.onmessage = (event: MessageEvent) => {\n      if (this.ws !== ws) return;\n      this.touch();\n      let frame: ServerFrame;\n      try {\n        frame = JSON.parse(String(event.data));\n      } catch {\n        return;\n      }\n      this.handle(frame);\n    };\n    ws.onclose = (event: CloseEvent) => {\n      if (this.ws !== ws) return;\n      this.onClosed(event.code);\n    };\n    ws.onerror = () => {\n      // A `close` follows.\n    };\n  }\n\n  private url(): string {\n    if (this.internals.url) return this.internals.url;\n    const { protocol, host } = window.location;\n    return `${protocol === \"https:\" ? \"wss:\" : \"ws:\"}//${host}${this.options.path}`;\n  }\n\n  private sendSub(entry: Entry) {\n    this.setStatus(entry, \"connecting\", null);\n    const frame: ClientFrame = { op: \"sub\", id: entry.id, ch: entry.pattern };\n    if (Object.keys(entry.params).length > 0) frame.p = entry.params;\n    this.send(frame);\n  }\n\n  private send(frame: ClientFrame) {\n    if (!this.isOpen()) return;\n    try {\n      this.ws!.send(JSON.stringify(frame));\n    } catch {\n      // The close handler takes over.\n    }\n  }\n\n  private handle(frame: ServerFrame) {\n    switch (frame.op) {\n      case \"hello\":\n        this.socketIdValue = frame.socketId;\n        this.tag = frame.tag;\n        this.attempt = 0;\n        this.revoked = false;\n        if (frame.heartbeatMs > 0) {\n          this.heartbeatMs = frame.heartbeatMs;\n        }\n        this.startHeartbeat();\n        return;\n      case \"subscribed\": {\n        const entry = this.byId.get(frame.id);\n        if (!entry) return;\n        this.dropTopic(entry);\n        entry.topic = frame.t;\n        let ids = this.topics.get(frame.t);\n        if (!ids) this.topics.set(frame.t, (ids = new Set()));\n        ids.add(entry.id);\n        this.clearRetry(entry);\n        entry.retries = 0;\n        this.setStatus(entry, \"open\", null);\n        // The window between the view rendering and this ack, or the time\n        // the socket was down, may have carried events this tab missed.\n        this.resync(entry);\n        return;\n      }\n      case \"denied\": {\n        const entry = this.byId.get(frame.id);\n        if (!entry) return;\n        this.dropTopic(entry);\n        entry.permanent = isPermanentDenial(frame.code);\n        this.setStatus(entry, \"denied\", frame.code);\n        this.scheduleRetry(entry, frame.code);\n        return;\n      }\n      case \"ev\": {\n        if (frame.x !== undefined && frame.x === this.tag) return;\n        const ids = this.topics.get(frame.t);\n        if (!ids) return;\n        for (const id of Array.from(ids)) {\n          const entry = this.byId.get(id);\n          if (!entry) continue;\n          for (const listener of Array.from(entry.listeners)) {\n            try {\n              listener.onEvent?.(frame.ev, frame.d);\n            } catch (error) {\n              reportListenerError(error);\n            }\n          }\n        }\n        return;\n      }\n      case \"gap\":\n        for (const entry of this.entries.values()) {\n          if (entry.status === \"open\") this.resync(entry);\n        }\n        return;\n      case \"bye\":\n        this.retryAfter = Math.max(0, Number(frame.retryAfter) || 0);\n        return;\n      case \"pong\":\n        return;\n    }\n  }\n\n  private onClosed(code: number) {\n    this.ws = null;\n    this.socketIdValue = null;\n    this.tag = null;\n    this.stopHeartbeat();\n    this.topics.clear();\n    for (const entry of this.entries.values()) {\n      entry.topic = null;\n      // The reconnect resends it.\n      this.clearRetry(entry);\n      if (!entry.permanent) this.setStatus(entry, \"closed\", null);\n    }\n    if (code === CloseCode.Revoked) this.revoked = true;\n    if (this.entries.size > 0 && !this.pausedWhileHidden) this.scheduleReconnect();\n  }\n\n  private scheduleReconnect() {\n    this.clearReconnect();\n    let delay: number;\n    if (this.retryAfter !== null) {\n      delay = this.retryAfter;\n      this.retryAfter = null;\n    } else if (this.revoked) {\n      // Signed out or access revoked: come back promptly, as whoever we are now.\n      this.revoked = false;\n      delay = Math.floor(this.random() * 500);\n    } else {\n      delay = backoffDelay(this.attempt, this.random());\n    }\n    this.attempt++;\n    this.reconnectTimer = setTimeout(() => {\n      this.reconnectTimer = null;\n      this.connect();\n    }, delay);\n  }\n\n  private clearReconnect() {\n    if (this.reconnectTimer) clearTimeout(this.reconnectTimer);\n    this.reconnectTimer = null;\n  }\n\n  private random() {\n    return (this.internals.random ?? Math.random)();\n  }\n\n  private startHeartbeat() {\n    this.stopHeartbeat();\n    this.pingTimer = setInterval(() => this.send({ op: \"ping\" }), this.heartbeatMs);\n    this.touch();\n  }\n\n  private stopHeartbeat() {\n    if (this.pingTimer) clearInterval(this.pingTimer);\n    if (this.livenessTimer) clearTimeout(this.livenessTimer);\n    this.pingTimer = null;\n    this.livenessTimer = null;\n  }\n\n  /** Anything from the server proves the socket alive. */\n  private touch() {\n    if (this.livenessTimer) clearTimeout(this.livenessTimer);\n    const ws = this.ws;\n    this.livenessTimer = setTimeout(() => {\n      if (this.ws !== ws || !ws) return;\n      // Silent for two heartbeats: a dead connection a proxy never closed.\n      try {\n        ws.close();\n      } catch {}\n      this.onClosed(1006);\n    }, this.heartbeatMs * 2);\n  }\n\n  private setStatus(entry: Entry, status: ChannelStatus, code: DeniedCode | null) {\n    if (entry.status === status && entry.code === code) return;\n    entry.status = status;\n    entry.code = code;\n    for (const listener of Array.from(entry.listeners)) {\n      try {\n        listener.onStatus?.(status, code);\n      } catch (error) {\n        reportListenerError(error);\n      }\n    }\n  }\n\n  /** At most one resync per subscription per 2 s; a later one is deferred, not dropped. */\n  private resync(entry: Entry) {\n    if (entry.resyncTimer) return;\n    const now = Date.now();\n    const wait = entry.lastResyncAt + RESYNC_COALESCE_MS - now;\n    const fire = () => {\n      entry.resyncTimer = null;\n      entry.lastResyncAt = Date.now();\n      for (const listener of Array.from(entry.listeners)) {\n        try {\n          listener.onResync?.();\n        } catch (error) {\n          reportListenerError(error);\n        }\n      }\n    };\n    if (entry.lastResyncAt === 0 || wait <= 0) fire();\n    else entry.resyncTimer = setTimeout(fire, wait);\n  }\n\n  /**\n   * A transient denial (`rate_limited`, `error`, `limit`) is retried on the\n   * same socket, with backoff: a healthy socket may never reconnect. `denied`\n   * and `revoked` are the channel's answer for this session, so they wait for\n   * the next connection (a sign-in reconnects), and a permanent one is never\n   * resent. `limit` gives up after `MAX_LIMIT_RETRIES` on one socket.\n   */\n  private scheduleRetry(entry: Entry, code: DeniedCode) {\n    if (code !== \"rate_limited\" && code !== \"error\" && code !== \"limit\") return;\n    if (code === \"limit\" && entry.retries >= MAX_LIMIT_RETRIES) return;\n    this.clearRetry(entry);\n    const floor = code === \"rate_limited\" ? RATE_LIMITED_RETRY_MS : MIN_BACKOFF_MS;\n    const delay = Math.max(floor, backoffDelay(entry.retries, this.random()));\n    entry.retries++;\n    entry.retryTimer = setTimeout(() => {\n      entry.retryTimer = null;\n      if (this.entries.get(entry.key) !== entry || entry.status !== \"denied\") return;\n      if (this.isOpen()) this.sendSub(entry);\n    }, delay);\n  }\n\n  private clearRetry(entry: Entry) {\n    if (entry.retryTimer) clearTimeout(entry.retryTimer);\n    entry.retryTimer = null;\n  }\n\n  private dropTopic(entry: Entry) {\n    if (!entry.topic) return;\n    const ids = this.topics.get(entry.topic);\n    ids?.delete(entry.id);\n    if (ids && ids.size === 0) this.topics.delete(entry.topic);\n    entry.topic = null;\n  }\n\n  private scheduleIdleClose() {\n    this.cancelIdleClose();\n    this.idleTimer = setTimeout(() => {\n      this.idleTimer = null;\n      if (this.entries.size > 0) return;\n      this.clearReconnect();\n      this.close();\n    }, IDLE_CLOSE_MS);\n  }\n\n  private cancelIdleClose() {\n    if (this.idleTimer) clearTimeout(this.idleTimer);\n    this.idleTimer = null;\n  }\n\n  /** Closes the socket without reconnecting. */\n  private close() {\n    const ws = this.ws;\n    if (!ws) return;\n    this.ws = null;\n    try {\n      ws.close(CloseCode.Normal);\n    } catch {}\n    this.onClosed(CloseCode.Normal);\n  }\n\n  private listen() {\n    if (this.listening || typeof window === \"undefined\") return;\n    this.listening = true;\n    window.addEventListener(\"online\", this.onOnline);\n    if (typeof document !== \"undefined\") {\n      document.addEventListener(\"visibilitychange\", this.onVisibility);\n    }\n  }\n\n  private onOnline = () => {\n    if (this.entries.size === 0 || this.ws || this.pausedWhileHidden) return;\n    this.attempt = 0;\n    this.connect();\n  };\n\n  private onVisibility = () => {\n    if (document.visibilityState === \"hidden\") {\n      if (this.hiddenTimer) return;\n      this.hiddenTimer = setTimeout(() => {\n        this.hiddenTimer = null;\n        if (document.visibilityState !== \"hidden\") return;\n        this.pausedWhileHidden = true;\n        this.clearReconnect();\n        this.close();\n      }, this.options.hiddenDisconnectMs);\n      return;\n    }\n    if (this.hiddenTimer) clearTimeout(this.hiddenTimer);\n    this.hiddenTimer = null;\n    if (this.pausedWhileHidden) {\n      this.pausedWhileHidden = false;\n      this.attempt = 0;\n      // The `subscribed` acks resync every subscription.\n      this.connect();\n    }\n  };\n\n  /**\n   * Drops the socket and opens a new one at once, when anything is\n   * subscribed. A socket keeps the session it was opened with (the upgrade's\n   * cookies), so signing in or out in this tab reconnects it: every channel\n   * is then authorized as the new session, and the acks resync.\n   */\n  reconnect() {\n    this.close();\n    this.clearReconnect();\n    this.attempt = 0;\n    if (this.entries.size > 0 && !this.pausedWhileHidden) this.connect();\n  }\n\n  /** For tests: drops the socket, timers and listeners. */\n  dispose() {\n    this.clearReconnect();\n    this.cancelIdleClose();\n    if (this.hiddenTimer) clearTimeout(this.hiddenTimer);\n    for (const entry of this.entries.values()) {\n      if (entry.resyncTimer) clearTimeout(entry.resyncTimer);\n      if (entry.lingerTimer) clearTimeout(entry.lingerTimer);\n      this.clearRetry(entry);\n    }\n    this.entries.clear();\n    this.byId.clear();\n    this.close();\n    if (this.listening && typeof window !== \"undefined\") {\n      window.removeEventListener(\"online\", this.onOnline);\n      document?.removeEventListener(\"visibilitychange\", this.onVisibility);\n      this.listening = false;\n    }\n  }\n}\n\n/** Full jitter, 1 to 30 s: `max(1 s, random × min(30 s, 1 s × 2^attempt))`. */\nexport function backoffDelay(attempt: number, random: number): number {\n  const cap = Math.min(MAX_BACKOFF_MS, MIN_BACKOFF_MS * 2 ** Math.min(attempt, 10));\n  return Math.max(MIN_BACKOFF_MS, Math.floor(random * cap));\n}\n\nfunction withDefaults(options: RealtimeOptions): Required<RealtimeOptions> {\n  return {\n    path: options.path ?? DEFAULT_SOCKET_PATH,\n    hiddenDisconnectMs: options.hiddenDisconnectMs ?? DEFAULT_HIDDEN_DISCONNECT_MS,\n  };\n}\n\nfunction reportListenerError(error: unknown) {\n  setTimeout(() => {\n    throw error;\n  });\n}\n\n/**\n * The tab's client, created on first use with the options `configureRealtime`\n * set. `loadRealtimeClient` in `./loader` calls it once this module is loaded.\n */\nexport function tabClient(): RealtimeClient {\n  return (realtime.client ??= new RealtimeClient(realtime.options));\n}\n"],"mappings":"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"}

package/dist/chunks/{ThemeProvider-DaX0eyqs.js → ThemeProvider-gWqXjGh-.js}

@@ -178,18 +178,7 @@ var QueryResource = class {
 			const current = store.get(variantKey);
 			if (current?.loading) continue;
 			if (current?.hasData && current.data === data) continue;
-			store.set(variantKey, {
-				loading: false,
-				data,
-				hasData: true,
-				error: null,
-				version: now
-			});
-			this.staleVariants.delete(variantKey);
-			this.lastFetchRecord.set(variantKey, now);
-			this.failures.delete(variantKey);
-			this.cancelRetry(variantKey);
-			this.settle(variantKey);
+			this.fill(store, variantKey, data, now);
 			changed = true;
 		}
 		if (changed) this.store.next(store);
@@ -463,30 +452,18 @@ var QueryResource = class {
 		}));
 		this.resolveVariant(variantKey, false, false);
 	}
-	/**
-	* 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, data) {
-		this.dropHttpCache(variantKey);
-		const now = Date.now();
-		this.markApplied(variantKey);
-		this.staleVariants.delete(variantKey);
-		this.lastFetchRecord.set(variantKey, now);
-		this.failures.delete(variantKey);
-		this.cancelRetry(variantKey);
-		const store = this.store.getValue();
-		this.store.next(store.set(variantKey, {
+	fill(store, variantKey, data, now) {
+		store.set(variantKey, {
 			loading: false,
 			data,
 			hasData: true,
 			error: null,
 			version: now
-		}));
+		});
+		this.staleVariants.delete(variantKey);
+		this.lastFetchRecord.set(variantKey, now);
+		this.failures.delete(variantKey);
+		this.cancelRetry(variantKey);
 		this.settle(variantKey);
 	}
 	refetch(variantKey) {
@@ -752,44 +729,65 @@ function toVariantKey(search) {
 	return searchParams.toString();
 }
 //#endregion
-//#region client/realtime/loader.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)}`;
+//#region client/lazyModule.ts
+/**
+* What a lazy `import()` resolved to, or a thrown error when it is missing.
+* Vite's preload helper resolves the `import()` to `undefined` instead of
+* rejecting when a `vite:preloadError` listener handled the failure (`init`'s
+* chunk-load recovery does, as it starts a reload): treated as a failed load.
+*/
+function loadedModule(module) {
+	if (!module) throw new Error("[gemi] A lazily loaded chunk is unavailable.");
+	return module;
 }
-var configured = {};
-var instance = null;
-var loading = null;
+/**
+* The module, loading it if it is not there yet. Callers while it loads share
+* one load, so their callbacks run in call order. A failed load is not kept:
+* the next call runs `import()` again.
+*/
+function loadLazy(lazy) {
+	if (lazy.current) return Promise.resolve(lazy.current);
+	return lazy.loading ??= lazy.load().then((module) => {
+		lazy.loading = null;
+		return lazy.current = loadedModule(module);
+	}, (error) => {
+		lazy.loading = null;
+		throw error;
+	});
+}
+//#endregion
+//#region client/realtime/loader.ts
+/**
+* The tab's client, once loaded and created (`tabClient` in
+* `./RealtimeClient` creates it), and the options it is created with.
+*/
+var realtime = {
+	client: null,
+	options: {}
+};
 /**
 * Sets the socket options (`init({ realtime })` calls it). Takes effect on
 * the next connection.
 */
 function configureRealtime(options = {}) {
-	configured = {
-		...configured,
-		...options
-	};
-	instance?.configure(configured);
+	Object.assign(realtime.options, options);
+	realtime.client?.configure(realtime.options);
 }
 /** The tab's client if it is already loaded, else `null`. Never loads it. */
 function loadedRealtimeClient() {
-	return instance;
+	return realtime.client;
 }
+var loading = null;
+/** The lazily loaded client. Replaceable in tests, to simulate a failed load. */
+var lazyModules = { client: () => import("./RealtimeClient-DsWbFRC7.js") };
 /**
-* What a lazy `import()` resolved to, or a thrown error when it is missing.
-* Vite's preload helper resolves the `import()` to `undefined` instead of
-* rejecting when a `vite:preloadError` listener handled the failure (`init`'s
-* chunk-load recovery does, as it starts a reload): treated as a failed load.
+* `./live`, loaded by the first live query. `<Page>` in `gemi/testing` sets
+* `current` up front, so a live query on a provided socket subscribes during
+* its effect, as it did before the module was split out.
 */
-function loadedModule(module) {
-	if (!module) throw new Error("[gemi] A lazily loaded chunk is unavailable.");
-	return module;
-}
-/** The lazily loaded modules. Replaceable in tests, to simulate a failed load. */
-var lazyModules = {
-	client: () => import("./RealtimeClient-CqGve6h8.js"),
-	live: () => import("./live-DIUDdLrA.js").then((n) => n.t)
+var liveModule = {
+	current: null,
+	load: () => import("./live-CUdMhXHL.js").then((n) => n.n)
 };
 /**
 * The tab's client, loading its module and creating it on first use. `null`
@@ -800,41 +798,29 @@ var lazyModules = {
 */
 function loadRealtimeClient() {
 	if (typeof window === "undefined") return null;
-	if (instance) return Promise.resolve(instance);
-	loading ??= lazyModules.client().then((module) => instance ??= new (loadedModule(module)).RealtimeClient(configured)).catch((error) => {
+	if (realtime.client) return Promise.resolve(realtime.client);
+	loading ??= lazyModules.client().then((module) => loadedModule(module).tabClient()).catch((error) => {
 		loading = null;
 		throw error;
 	});
 	return loading;
 }
-var liveModule = null;
-/**
-* Makes `./live` available without loading it: `<Page>` in `gemi/testing`
-* passes it, so a live query on a provided socket subscribes during its
-* effect, as it did before the module was split out.
-*/
-function provideLiveModule(module) {
-	liveModule = module;
-}
 /**
 * Follows `useQuery`'s `live` channel until the returned function is called.
-* `./live` and the socket client are loaded on first use, so `useQuery`
-* carries only this; once both are loaded later queries subscribe at once.
-* `setOpen` reports `false` until the channel is open.
+* `./live` loads on first use and does the rest, loading the socket client
+* in turn, so `useQuery` carries only this. `setOpen` reports `false` until
+* the channel is open.
 */
 function followLive(provided, live, resource, setOpen) {
-	let cancelled = false;
-	let stop = null;
-	const start = (module, socket) => {
-		liveModule = module;
-		if (!cancelled && socket) stop = module.subscribeLive(socket, live, resource, setOpen);
+	let stop;
+	const start = (module) => {
+		if (stop === void 0) stop = module.followLive(provided, live, resource, setOpen);
 	};
-	const socket = provided ?? instance;
-	if (liveModule && socket) start(liveModule, socket);
-	else Promise.all([liveModule ?? lazyModules.live(), socket ?? loadRealtimeClient()]).then(([module, socket]) => start(loadedModule(module), socket)).catch(() => {});
+	if (liveModule.current) start(liveModule.current);
+	else loadLazy(liveModule).then(start).catch(() => {});
 	return () => {
-		cancelled = true;
 		stop?.();
+		stop = null;
 		setOpen(false);
 	};
 }
@@ -844,14 +830,7 @@ function followLive(provided, live, resource, setOpen) {
 * Never loads or creates the client.
 */
 function reconnectRealtime() {
-	instance?.reconnect();
-}
-/**
-* The open socket's id, for the `X-Gemi-Socket` header, or `null`. Never
-* loads or creates the client.
-*/
-function currentSocketId() {
-	return instance?.socketId ?? null;
+	realtime.client?.reconnect();
 }
 //#endregion
 //#region client/realtime/RealtimeContext.ts
@@ -3473,7 +3452,7 @@ function useChannelSubscription(pattern, params, handlers, enabled) {
 		};
 	}, [
 		provided,
-		pattern === null ? null : channelKey(pattern, params),
+		pattern === null ? null : JSON.stringify([pattern, params]),
 		active
 	]);
 	if (typeof window === "undefined") return active ? CLOSED : IDLE;
@@ -3629,6 +3608,6 @@ function useTheme() {
 	return context;
 }
 //#endregion
-export { DEFAULT_STALE_TIME as $, ServerDataContext as A, configureRealtime as B, readRoutePayload as C, useNavigate as D, useSearchParams as E, ProgressManager as F, reconnectRealtime as G, followLive as H, Action as I, QueryConfigContext as J, toVariantKey as K, createMemoryHistory as L, useLocation as M, domainUrl as N, I18nContext as O, isAbsoluteUrl as P, pickDefined as Q, RealtimeContext as R, setActiveLocale as S, useRoute as T, loadedModule as U, currentSocketId as V, provideLiveModule as W, QueryManagerProvider as X, QueryManagerContext as Y, USER_QUERY_CONFIG_KEYS as Z, isChunkLoadError as _, useRouteTransition as a, Subject as at, loadDictionaryForRender as b, ClientRouterContext as c, ComponentsProvider as d, isRetryableQueryError as et, initialViewModulesReady as f, configureChunkLoadRecovery as g, CHUNK_RELOAD_MARKER as h, RouteTransitionProvider as i, QueryError as it, ServerDataProvider as j, I18nProvider as k, ClientRouterProvider as l, subscribeViewModules as m, useTheme as n, retryDelayFor as nt, useChannelSubscription as o, loadViewModule as p, applyParams as q, m as r, shouldRetryQuery as rt, useCoalesced as s, ThemeProvider as t, parseRetryAfter as tt, ComponentsContext as u, recoverFromChunkLoadError as v, routeDataUrl as w, registerDictionary as x, loadDictionary as y, channelKey as z };
+export { DEFAULT_STALE_TIME as $, ServerDataContext as A, followLive as B, readRoutePayload as C, useNavigate as D, useSearchParams as E, ProgressManager as F, loadedModule as G, realtime as H, Action as I, QueryConfigContext as J, toVariantKey as K, createMemoryHistory as L, useLocation as M, domainUrl as N, I18nContext as O, isAbsoluteUrl as P, pickDefined as Q, RealtimeContext as R, setActiveLocale as S, useRoute as T, reconnectRealtime as U, liveModule as V, loadLazy as W, QueryManagerProvider as X, QueryManagerContext as Y, USER_QUERY_CONFIG_KEYS as Z, isChunkLoadError as _, useRouteTransition as a, Subject as at, loadDictionaryForRender as b, ClientRouterContext as c, ComponentsProvider as d, isRetryableQueryError as et, initialViewModulesReady as f, configureChunkLoadRecovery as g, CHUNK_RELOAD_MARKER as h, RouteTransitionProvider as i, QueryError as it, ServerDataProvider as j, I18nProvider as k, ClientRouterProvider as l, subscribeViewModules as m, useTheme as n, retryDelayFor as nt, useChannelSubscription as o, loadViewModule as p, applyParams as q, m as r, shouldRetryQuery as rt, useCoalesced as s, ThemeProvider as t, parseRetryAfter as tt, ComponentsContext as u, recoverFromChunkLoadError as v, routeDataUrl as w, registerDictionary as x, loadDictionary as y, configureRealtime as z };
 
-//# sourceMappingURL=ThemeProvider-DaX0eyqs.js.map
+//# sourceMappingURL=ThemeProvider-gWqXjGh-.js.map