@nifrajs/web 2.14.1 → 3.2.0

package/src/internal/query-runtime.ts

@@ -0,0 +1,31 @@
+import type { QueryClient, QueryState } from "../query.ts"
+import { createQueryClient } from "../query.ts"
+
+/** Stable idle state shared by every framework query binding. */
+export const IDLE_QUERY_STATE: QueryState<never> = Object.freeze({
+  status: "pending",
+  data: undefined,
+  error: undefined,
+  isFetching: false,
+  updatedAt: Number.NEGATIVE_INFINITY,
+})
+
+let singleton: QueryClient | undefined
+
+/** Return the client-side query singleton, or undefined during SSR. */
+export function getQueryClientSingleton(): QueryClient | undefined {
+  // `typeof globalThis.window`, not `"window" in globalThis`: an SSR shim that assigns
+  // `globalThis.window = undefined` still satisfies the `in` check (the key exists), which would
+  // build a process-global cache on the server and leak state across requests. A real DOM window is
+  // a defined object; a shimmed-undefined one reads as `"undefined"` here and stays server-side.
+  if (typeof (globalThis as { window?: unknown }).window === "undefined") return undefined
+  if (singleton === undefined) singleton = createQueryClient({ now: () => Date.now() })
+  return singleton
+}
+
+/** Create the refetch fallback used when a binding has no client-side query cache. */
+export function createNoClientRefetch<T>(tag: string, operation: string): () => Promise<T> {
+  return async () => {
+    throw new Error(`${tag} ${operation} called with no query client (server?)`)
+  }
+}