@ttt-productions/query-core 0.14.22 → 0.14.24

package/dist/react/session-mutation.js

@@ -0,0 +1,150 @@
+'use client';
+import { jsx as _jsx } from "react/jsx-runtime";
+import { createContext, useCallback, useContext, useInsertionEffect, useState, } from 'react';
+import { useMutation, useQueryClient, } from '@tanstack/react-query';
+export class MutationSessionEndedError extends Error {
+    name = 'AbortError';
+    constructor(options) {
+        super('The session that started this mutation has ended.', options);
+    }
+}
+const MutationSessionContext = createContext(null);
+export function MutationSessionProvider({ currentUid, children }) {
+    const [store] = useState(() => ({
+        current: { uid: currentUid, generation: 0 },
+    }));
+    // Insertion effects run before any layout effect of the commit, so a child's layout effect
+    // never starts a mutation under the uid this commit ends.
+    useInsertionEffect(() => {
+        if (store.current.uid !== currentUid) {
+            store.current = { uid: currentUid, generation: store.current.generation + 1 };
+        }
+    }, [store, currentUid]);
+    return (_jsx(MutationSessionContext.Provider, { value: store, children: children }));
+}
+const ALWAYS_CURRENT = {
+    uid: null,
+    isCurrent: () => true,
+    assertCurrent: () => { },
+};
+function captureSession(store) {
+    if (!store)
+        return ALWAYS_CURRENT;
+    const { uid, generation } = store.current;
+    const isCurrent = () => store.current.generation === generation;
+    return {
+        uid,
+        isCurrent,
+        assertCurrent: () => {
+            if (!isCurrent())
+                throw new MutationSessionEndedError();
+        },
+    };
+}
+export function useMutationSessionCapture() {
+    const store = useContext(MutationSessionContext);
+    return useCallback(() => captureSession(store), [store]);
+}
+const runSessions = new WeakMap();
+function runHasEnded(store, context) {
+    if (!store)
+        return false;
+    return !(runSessions.get(context)?.isCurrent() ?? false);
+}
+function retriesAfter(retry, failureCount, error) {
+    if (error instanceof MutationSessionEndedError)
+        return false;
+    if (typeof retry === 'function')
+        return retry(failureCount, error);
+    if (typeof retry === 'number')
+        return failureCount < retry;
+    return retry === true;
+}
+function throwsToBoundary(throwOnError, error) {
+    if (error instanceof MutationSessionEndedError)
+        return false;
+    if (typeof throwOnError === 'function')
+        return throwOnError(error);
+    return throwOnError === true;
+}
+function fenceCallOptions(session, options) {
+    if (!options)
+        return undefined;
+    const { onSuccess, onError, onSettled } = options;
+    return {
+        onSuccess: onSuccess
+            ? (...args) => {
+                if (session.isCurrent())
+                    onSuccess(...args);
+            }
+            : undefined,
+        onError: onError
+            ? (error, ...rest) => {
+                if (!(error instanceof MutationSessionEndedError) && session.isCurrent()) {
+                    onError(error, ...rest);
+                }
+            }
+            : undefined,
+        onSettled: onSettled
+            ? (data, error, ...rest) => {
+                if (!(error instanceof MutationSessionEndedError) && session.isCurrent()) {
+                    onSettled(data, error, ...rest);
+                }
+            }
+            : undefined,
+    };
+}
+export function useSessionMutation(options) {
+    const store = useContext(MutationSessionContext);
+    const queryClient = useQueryClient();
+    const { mutationFn, onMutate, onSuccess, onError, onSettled, retry, throwOnError, ...rest } = options;
+    const defaults = queryClient.defaultMutationOptions({ mutationKey: options.mutationKey });
+    const baseRetry = (retry ?? defaults.retry);
+    const baseThrowOnError = (throwOnError ?? defaults.throwOnError);
+    const mutation = useMutation({
+        ...rest,
+        retry: (failureCount, error) => retriesAfter(baseRetry, failureCount, error),
+        throwOnError: (error) => throwsToBoundary(baseThrowOnError, error),
+        onMutate: (variables, context) => {
+            if (store)
+                runSessions.set(context, captureSession(store));
+            return onMutate?.(variables, context);
+        },
+        mutationFn: async (variables, context) => {
+            const session = store ? runSessions.get(context) : ALWAYS_CURRENT;
+            if (!session || !session.isCurrent())
+                throw new MutationSessionEndedError();
+            let data;
+            try {
+                data = await mutationFn(variables, { ...context, session });
+            }
+            catch (error) {
+                if (!session.isCurrent())
+                    throw new MutationSessionEndedError({ cause: error });
+                throw error;
+            }
+            session.assertCurrent();
+            return data;
+        },
+        onSuccess: (data, variables, onMutateResult, context) => {
+            if (runHasEnded(store, context))
+                return;
+            return onSuccess?.(data, variables, onMutateResult, context);
+        },
+        onError: (error, variables, onMutateResult, context) => {
+            if (error instanceof MutationSessionEndedError || runHasEnded(store, context))
+                return;
+            return onError?.(error, variables, onMutateResult, context);
+        },
+        onSettled: (data, error, variables, onMutateResult, context) => {
+            if (error instanceof MutationSessionEndedError || runHasEnded(store, context))
+                return;
+            return onSettled?.(data, error, variables, onMutateResult, context);
+        },
+    });
+    const { mutate: rawMutate, mutateAsync: rawMutateAsync } = mutation;
+    const mutate = useCallback((variables, callOptions) => rawMutate(variables, fenceCallOptions(captureSession(store), callOptions)), [rawMutate, store]);
+    const mutateAsync = useCallback((variables, callOptions) => rawMutateAsync(variables, fenceCallOptions(captureSession(store), callOptions)), [rawMutateAsync, store]);
+    return { ...mutation, mutate, mutateAsync };
+}
+//# sourceMappingURL=session-mutation.js.map

package/dist/react/session-mutation.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"session-mutation.js","sourceRoot":"","sources":["../../src/react/session-mutation.tsx"],"names":[],"mappings":"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","sourcesContent":["'use client';\n\nimport {\n  createContext,\n  useCallback,\n  useContext,\n  useInsertionEffect,\n  useState,\n  type ReactNode,\n} from 'react';\nimport {\n  useMutation,\n  useQueryClient,\n  type DefaultError,\n  type MutateOptions,\n  type MutationFunctionContext,\n  type UseMutationOptions,\n  type UseMutationResult,\n} from '@tanstack/react-query';\n\nexport interface MutationSession {\n  uid: string | null;\n  isCurrent(): boolean;\n  assertCurrent(): void;\n}\n\nexport type SessionMutationFunctionContext = MutationFunctionContext & {\n  session: MutationSession;\n};\n\nexport type SessionMutationOptions<\n  TData = unknown,\n  TError = DefaultError,\n  TVariables = void,\n  TOnMutateResult = unknown,\n> = Omit<UseMutationOptions<TData, TError, TVariables, TOnMutateResult>, 'mutationFn'> & {\n  mutationFn: (variables: TVariables, context: SessionMutationFunctionContext) => Promise<TData>;\n};\n\nexport class MutationSessionEndedError extends Error {\n  override name = 'AbortError';\n\n  constructor(options?: { cause?: unknown }) {\n    super('The session that started this mutation has ended.', options);\n  }\n}\n\ninterface SessionStore {\n  current: { uid: string | null; generation: number };\n}\n\nconst MutationSessionContext = createContext<SessionStore | null>(null);\n\nexport interface MutationSessionProviderProps {\n  currentUid: string | null;\n  children?: ReactNode;\n}\n\nexport function MutationSessionProvider({ currentUid, children }: MutationSessionProviderProps) {\n  const [store] = useState<SessionStore>(() => ({\n    current: { uid: currentUid, generation: 0 },\n  }));\n  // Insertion effects run before any layout effect of the commit, so a child's layout effect\n  // never starts a mutation under the uid this commit ends.\n  useInsertionEffect(() => {\n    if (store.current.uid !== currentUid) {\n      store.current = { uid: currentUid, generation: store.current.generation + 1 };\n    }\n  }, [store, currentUid]);\n  return (\n    <MutationSessionContext.Provider value={store}>{children}</MutationSessionContext.Provider>\n  );\n}\n\nconst ALWAYS_CURRENT: MutationSession = {\n  uid: null,\n  isCurrent: () => true,\n  assertCurrent: () => {},\n};\n\nfunction captureSession(store: SessionStore | null): MutationSession {\n  if (!store) return ALWAYS_CURRENT;\n  const { uid, generation } = store.current;\n  const isCurrent = () => store.current.generation === generation;\n  return {\n    uid,\n    isCurrent,\n    assertCurrent: () => {\n      if (!isCurrent()) throw new MutationSessionEndedError();\n    },\n  };\n}\n\nexport function useMutationSessionCapture(): () => MutationSession {\n  const store = useContext(MutationSessionContext);\n  return useCallback(() => captureSession(store), [store]);\n}\n\nconst runSessions = new WeakMap<MutationFunctionContext, MutationSession>();\n\nfunction runHasEnded(store: SessionStore | null, context: MutationFunctionContext): boolean {\n  if (!store) return false;\n  return !(runSessions.get(context)?.isCurrent() ?? false);\n}\n\ntype Retry<TError> = UseMutationOptions<unknown, TError, unknown, unknown>['retry'];\ntype ThrowOnError<TError> = UseMutationOptions<unknown, TError, unknown, unknown>['throwOnError'];\n\nfunction retriesAfter<TError>(retry: Retry<TError>, failureCount: number, error: TError): boolean {\n  if (error instanceof MutationSessionEndedError) return false;\n  if (typeof retry === 'function') return retry(failureCount, error);\n  if (typeof retry === 'number') return failureCount < retry;\n  return retry === true;\n}\n\nfunction throwsToBoundary<TError>(throwOnError: ThrowOnError<TError>, error: TError): boolean {\n  if (error instanceof MutationSessionEndedError) return false;\n  if (typeof throwOnError === 'function') return throwOnError(error);\n  return throwOnError === true;\n}\n\nfunction fenceCallOptions<TData, TError, TVariables, TOnMutateResult>(\n  session: MutationSession,\n  options: MutateOptions<TData, TError, TVariables, TOnMutateResult> | undefined,\n): MutateOptions<TData, TError, TVariables, TOnMutateResult> | undefined {\n  if (!options) return undefined;\n  const { onSuccess, onError, onSettled } = options;\n  return {\n    onSuccess: onSuccess\n      ? (...args) => {\n          if (session.isCurrent()) onSuccess(...args);\n        }\n      : undefined,\n    onError: onError\n      ? (error, ...rest) => {\n          if (!(error instanceof MutationSessionEndedError) && session.isCurrent()) {\n            onError(error, ...rest);\n          }\n        }\n      : undefined,\n    onSettled: onSettled\n      ? (data, error, ...rest) => {\n          if (!(error instanceof MutationSessionEndedError) && session.isCurrent()) {\n            onSettled(data, error, ...rest);\n          }\n        }\n      : undefined,\n  };\n}\n\nexport function useSessionMutation<\n  TData = unknown,\n  TError = DefaultError,\n  TVariables = void,\n  TOnMutateResult = unknown,\n>(\n  options: SessionMutationOptions<TData, TError, TVariables, TOnMutateResult>,\n): UseMutationResult<TData, TError, TVariables, TOnMutateResult> {\n  const store = useContext(MutationSessionContext);\n  const queryClient = useQueryClient();\n  const { mutationFn, onMutate, onSuccess, onError, onSettled, retry, throwOnError, ...rest } =\n    options;\n  const defaults = queryClient.defaultMutationOptions<\n    UseMutationOptions<unknown, TError, unknown, unknown>\n  >({ mutationKey: options.mutationKey });\n  const baseRetry = (retry ?? defaults.retry) as Retry<TError>;\n  const baseThrowOnError = (throwOnError ?? defaults.throwOnError) as ThrowOnError<TError>;\n\n  const mutation = useMutation<TData, TError, TVariables, TOnMutateResult>({\n    ...rest,\n    retry: (failureCount, error) => retriesAfter(baseRetry, failureCount, error),\n    throwOnError: (error) => throwsToBoundary(baseThrowOnError, error),\n    onMutate: (variables, context) => {\n      if (store) runSessions.set(context, captureSession(store));\n      return onMutate?.(variables, context) as TOnMutateResult | Promise<TOnMutateResult>;\n    },\n    mutationFn: async (variables, context) => {\n      const session = store ? runSessions.get(context) : ALWAYS_CURRENT;\n      if (!session || !session.isCurrent()) throw new MutationSessionEndedError();\n      let data: TData;\n      try {\n        data = await mutationFn(variables, { ...context, session });\n      } catch (error) {\n        if (!session.isCurrent()) throw new MutationSessionEndedError({ cause: error });\n        throw error;\n      }\n      session.assertCurrent();\n      return data;\n    },\n    onSuccess: (data, variables, onMutateResult, context) => {\n      if (runHasEnded(store, context)) return;\n      return onSuccess?.(data, variables, onMutateResult, context);\n    },\n    onError: (error, variables, onMutateResult, context) => {\n      if (error instanceof MutationSessionEndedError || runHasEnded(store, context)) return;\n      return onError?.(error, variables, onMutateResult, context);\n    },\n    onSettled: (data, error, variables, onMutateResult, context) => {\n      if (error instanceof MutationSessionEndedError || runHasEnded(store, context)) return;\n      return onSettled?.(data, error, variables, onMutateResult, context);\n    },\n  });\n\n  const { mutate: rawMutate, mutateAsync: rawMutateAsync } = mutation;\n  const mutate = useCallback(\n    (\n      variables: TVariables,\n      callOptions?: MutateOptions<TData, TError, TVariables, TOnMutateResult>,\n    ) => rawMutate(variables, fenceCallOptions(captureSession(store), callOptions)),\n    [rawMutate, store],\n  );\n  const mutateAsync = useCallback(\n    (\n      variables: TVariables,\n      callOptions?: MutateOptions<TData, TError, TVariables, TOnMutateResult>,\n    ) => rawMutateAsync(variables, fenceCallOptions(captureSession(store), callOptions)),\n    [rawMutateAsync, store],\n  );\n  return { ...mutation, mutate, mutateAsync } as UseMutationResult<\n    TData,\n    TError,\n    TVariables,\n    TOnMutateResult\n  >;\n}\n"]}

package/dist/react/use-read-retry-state.d.ts

@@ -1,40 +1,20 @@
 import { type QueryKey } from '@tanstack/react-query';
-/** The parts of a read's result the retry state is decided from. */
 export interface ReadRetrySource<TError = Error> {
     error: TError | null | undefined;
     isFetching: boolean;
     isLoading: boolean;
-    /** A fetch waiting for the network counts as still running. */
     isPaused?: boolean;
 }
-/** A read's failure as its surface shows it, held on screen while a retry of it runs. */
 export interface ReadRetryState<TError = Error> {
-    /** The read's failure: its current one, or the last one while a retry of it is running. */
     error: TError | null;
-    /** A retry of the failed read is running. */
     isRetrying: boolean;
-    /** The read has not answered yet and is not a retry of a failure. */
     isLoading: boolean;
 }
-/** One read a keyed retry state follows: its result and its identity. */
 export interface ReadRetryEntry<TError = Error> {
     source: ReadRetrySource<TError>;
     queryKey: QueryKey;
 }
-/**
- * The failure and retry state of each of several reads, in entry order — the keyed form of
- * `useReadRetryState` for a set whose size changes between renders (a `useQueries` list, a batch
- * of per-id reads). Each read's failure is held under its own `queryKey`, so one read's retry
- * never shows another's failure, and a read that leaves the set drops what it held.
- */
 export declare function useReadRetryStates<TError = Error>(entries: readonly ReadRetryEntry<TError>[]): ReadRetryState<TError>[];
-/**
- * The failure and retry state of one read. TanStack Query clears the `error` of a query that never
- * succeeded and puts it back to `pending` the moment a refetch of it starts, so a retry state built
- * from `isFetching && error` is never true for a failed first read, and its failure panel turns into
- * a loading state under the retry the person pressed. This holds the read's last failure until the
- * retry settles — an answer clears it, a new failure replaces it — and reports the retry as running
- * meanwhile. The failure belongs to `queryKey`: a read under another key never shows it.
- */
+/** TanStack clears a never-succeeded query's `error` as its refetch starts, so the failure is held until the retry settles. */
 export declare function useReadRetryState<TError = Error>(source: ReadRetrySource<TError>, queryKey: QueryKey): ReadRetryState<TError>;
 //# sourceMappingURL=use-read-retry-state.d.ts.map

package/dist/react/use-read-retry-state.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"use-read-retry-state.d.ts","sourceRoot":"","sources":["../../src/react/use-read-retry-state.ts"],"names":[],"mappings":"AAGA,OAAO,EAAW,KAAK,QAAQ,EAAE,MAAM,uBAAuB,CAAC;AAE/D,oEAAoE;AACpE,MAAM,WAAW,eAAe,CAAC,MAAM,GAAG,KAAK;IAC7C,KAAK,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,CAAC;IACjC,UAAU,EAAE,OAAO,CAAC;IACpB,SAAS,EAAE,OAAO,CAAC;IACnB,+DAA+D;IAC/D,QAAQ,CAAC,EAAE,OAAO,CAAC;CACpB;AAED,yFAAyF;AACzF,MAAM,WAAW,cAAc,CAAC,MAAM,GAAG,KAAK;IAC5C,2FAA2F;IAC3F,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IACrB,6CAA6C;IAC7C,UAAU,EAAE,OAAO,CAAC;IACpB,qEAAqE;IACrE,SAAS,EAAE,OAAO,CAAC;CACpB;AAmBD,yEAAyE;AACzE,MAAM,WAAW,cAAc,CAAC,MAAM,GAAG,KAAK;IAC5C,MAAM,EAAE,eAAe,CAAC,MAAM,CAAC,CAAC;IAChC,QAAQ,EAAE,QAAQ,CAAC;CACpB;AA0BD;;;;;GAKG;AACH,wBAAgB,kBAAkB,CAAC,MAAM,GAAG,KAAK,EAC/C,OAAO,EAAE,SAAS,cAAc,CAAC,MAAM,CAAC,EAAE,GACzC,cAAc,CAAC,MAAM,CAAC,EAAE,CAa1B;AAUD;;;;;;;GAOG;AACH,wBAAgB,iBAAiB,CAAC,MAAM,GAAG,KAAK,EAC9C,MAAM,EAAE,eAAe,CAAC,MAAM,CAAC,EAC/B,QAAQ,EAAE,QAAQ,GACjB,cAAc,CAAC,MAAM,CAAC,CAExB"}
+{"version":3,"file":"use-read-retry-state.d.ts","sourceRoot":"","sources":["../../src/react/use-read-retry-state.ts"],"names":[],"mappings":"AAGA,OAAO,EAAW,KAAK,QAAQ,EAAE,MAAM,uBAAuB,CAAC;AAE/D,MAAM,WAAW,eAAe,CAAC,MAAM,GAAG,KAAK;IAC7C,KAAK,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,CAAC;IACjC,UAAU,EAAE,OAAO,CAAC;IACpB,SAAS,EAAE,OAAO,CAAC;IACnB,QAAQ,CAAC,EAAE,OAAO,CAAC;CACpB;AAED,MAAM,WAAW,cAAc,CAAC,MAAM,GAAG,KAAK;IAC5C,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IACrB,UAAU,EAAE,OAAO,CAAC;IACpB,SAAS,EAAE,OAAO,CAAC;CACpB;AAeD,MAAM,WAAW,cAAc,CAAC,MAAM,GAAG,KAAK;IAC5C,MAAM,EAAE,eAAe,CAAC,MAAM,CAAC,CAAC;IAChC,QAAQ,EAAE,QAAQ,CAAC;CACpB;AAyBD,wBAAgB,kBAAkB,CAAC,MAAM,GAAG,KAAK,EAC/C,OAAO,EAAE,SAAS,cAAc,CAAC,MAAM,CAAC,EAAE,GACzC,cAAc,CAAC,MAAM,CAAC,EAAE,CAY1B;AAUD,+HAA+H;AAC/H,wBAAgB,iBAAiB,CAAC,MAAM,GAAG,KAAK,EAC9C,MAAM,EAAE,eAAe,CAAC,MAAM,CAAC,EAC/B,QAAQ,EAAE,QAAQ,GACjB,cAAc,CAAC,MAAM,CAAC,CAExB"}

package/dist/react/use-read-retry-state.js

@@ -1,11 +1,7 @@
 'use client';
 import { useState } from 'react';
 import { hashKey } from '@tanstack/react-query';
-/**
- * One failure is its name, message, and `code`, not its object: a composite source that builds its
- * error in render hands back a new object for the same failure every render, and holding each one
- * as new would set state on every render without end.
- */
+/** A composite source builds a new error object every render, so a failure is compared by name, message, and `code`. */
 function sameFailure(a, b) {
     if (a === b)
         return true;
@@ -15,7 +11,6 @@ function sameFailure(a, b) {
     const y = b;
     return x.name === y.name && x.message === y.message && x.code === y.code;
 }
-/** The failure a read holds next, given what it held: its live failure, or the held one while it runs. */
 function nextHeldFailure(held, source) {
     const live = source.error ?? null;
     if (live !== null)
@@ -31,12 +26,6 @@ function toRetryState(source, held) {
         isLoading: error === null && source.isLoading,
     };
 }
-/**
- * The failure and retry state of each of several reads, in entry order — the keyed form of
- * `useReadRetryState` for a set whose size changes between renders (a `useQueries` list, a batch
- * of per-id reads). Each read's failure is held under its own `queryKey`, so one read's retry
- * never shows another's failure, and a read that leaves the set drops what it held.
- */
 export function useReadRetryStates(entries) {
     const [held, setHeld] = useState({});
     const next = {};
@@ -47,7 +36,6 @@ export function useReadRetryStates(entries) {
             next[identity] = failure;
         return toRetryState(source, failure);
     });
-    // Render-phase adjustment: the held failures follow the reads without an effect's extra render.
     if (!sameHeld(held, next))
         setHeld(next);
     return states;
@@ -56,14 +44,7 @@ function sameHeld(a, b) {
     const keys = Object.keys(a);
     return keys.length === Object.keys(b).length && keys.every((key) => a[key] === b[key]);
 }
-/**
- * The failure and retry state of one read. TanStack Query clears the `error` of a query that never
- * succeeded and puts it back to `pending` the moment a refetch of it starts, so a retry state built
- * from `isFetching && error` is never true for a failed first read, and its failure panel turns into
- * a loading state under the retry the person pressed. This holds the read's last failure until the
- * retry settles — an answer clears it, a new failure replaces it — and reports the retry as running
- * meanwhile. The failure belongs to `queryKey`: a read under another key never shows it.
- */
+/** TanStack clears a never-succeeded query's `error` as its refetch starts, so the failure is held until the retry settles. */
 export function useReadRetryState(source, queryKey) {
     return useReadRetryStates([{ source, queryKey }])[0];
 }

package/dist/react/use-read-retry-state.js.map

@@ -1 +1 @@
-{"version":3,"file":"use-read-retry-state.js","sourceRoot":"","sources":["../../src/react/use-read-retry-state.ts"],"names":[],"mappings":"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","sourcesContent":["'use client';\n\nimport { useState } from 'react';\nimport { hashKey, type QueryKey } from '@tanstack/react-query';\n\n/** The parts of a read's result the retry state is decided from. */\nexport interface ReadRetrySource<TError = Error> {\n  error: TError | null | undefined;\n  isFetching: boolean;\n  isLoading: boolean;\n  /** A fetch waiting for the network counts as still running. */\n  isPaused?: boolean;\n}\n\n/** A read's failure as its surface shows it, held on screen while a retry of it runs. */\nexport interface ReadRetryState<TError = Error> {\n  /** The read's failure: its current one, or the last one while a retry of it is running. */\n  error: TError | null;\n  /** A retry of the failed read is running. */\n  isRetrying: boolean;\n  /** The read has not answered yet and is not a retry of a failure. */\n  isLoading: boolean;\n}\n\ninterface HeldFailure<TError> {\n  error: TError;\n}\n\n/**\n * One failure is its name, message, and `code`, not its object: a composite source that builds its\n * error in render hands back a new object for the same failure every render, and holding each one\n * as new would set state on every render without end.\n */\nfunction sameFailure(a: unknown, b: unknown): boolean {\n  if (a === b) return true;\n  if (typeof a !== 'object' || a === null || typeof b !== 'object' || b === null) return false;\n  const x = a as { name?: unknown; message?: unknown; code?: unknown };\n  const y = b as { name?: unknown; message?: unknown; code?: unknown };\n  return x.name === y.name && x.message === y.message && x.code === y.code;\n}\n\n/** One read a keyed retry state follows: its result and its identity. */\nexport interface ReadRetryEntry<TError = Error> {\n  source: ReadRetrySource<TError>;\n  queryKey: QueryKey;\n}\n\n/** The failure a read holds next, given what it held: its live failure, or the held one while it runs. */\nfunction nextHeldFailure<TError>(\n  held: HeldFailure<TError> | undefined,\n  source: ReadRetrySource<TError>,\n): HeldFailure<TError> | undefined {\n  const live = source.error ?? null;\n  if (live !== null)\n    return held !== undefined && sameFailure(held.error, live) ? held : { error: live };\n  const running = source.isFetching || source.isPaused === true;\n  return running ? held : undefined;\n}\n\nfunction toRetryState<TError>(\n  source: ReadRetrySource<TError>,\n  held: HeldFailure<TError> | undefined,\n): ReadRetryState<TError> {\n  const error = source.error ?? held?.error ?? null;\n  return {\n    error,\n    isRetrying: error !== null && (source.isFetching || source.isPaused === true),\n    isLoading: error === null && source.isLoading,\n  };\n}\n\n/**\n * The failure and retry state of each of several reads, in entry order — the keyed form of\n * `useReadRetryState` for a set whose size changes between renders (a `useQueries` list, a batch\n * of per-id reads). Each read's failure is held under its own `queryKey`, so one read's retry\n * never shows another's failure, and a read that leaves the set drops what it held.\n */\nexport function useReadRetryStates<TError = Error>(\n  entries: readonly ReadRetryEntry<TError>[],\n): ReadRetryState<TError>[] {\n  const [held, setHeld] = useState<Readonly<Record<string, HeldFailure<TError>>>>({});\n\n  const next: Record<string, HeldFailure<TError>> = {};\n  const states = entries.map(({ source, queryKey }) => {\n    const identity = hashKey(queryKey);\n    const failure = nextHeldFailure(held[identity], source);\n    if (failure !== undefined) next[identity] = failure;\n    return toRetryState(source, failure);\n  });\n  // Render-phase adjustment: the held failures follow the reads without an effect's extra render.\n  if (!sameHeld(held, next)) setHeld(next);\n  return states;\n}\n\nfunction sameHeld<TError>(\n  a: Readonly<Record<string, HeldFailure<TError>>>,\n  b: Readonly<Record<string, HeldFailure<TError>>>,\n): boolean {\n  const keys = Object.keys(a);\n  return keys.length === Object.keys(b).length && keys.every((key) => a[key] === b[key]);\n}\n\n/**\n * The failure and retry state of one read. TanStack Query clears the `error` of a query that never\n * succeeded and puts it back to `pending` the moment a refetch of it starts, so a retry state built\n * from `isFetching && error` is never true for a failed first read, and its failure panel turns into\n * a loading state under the retry the person pressed. This holds the read's last failure until the\n * retry settles — an answer clears it, a new failure replaces it — and reports the retry as running\n * meanwhile. The failure belongs to `queryKey`: a read under another key never shows it.\n */\nexport function useReadRetryState<TError = Error>(\n  source: ReadRetrySource<TError>,\n  queryKey: QueryKey,\n): ReadRetryState<TError> {\n  return useReadRetryStates([{ source, queryKey }])[0]!;\n}\n"]}
+{"version":3,"file":"use-read-retry-state.js","sourceRoot":"","sources":["../../src/react/use-read-retry-state.ts"],"names":[],"mappings":"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","sourcesContent":["'use client';\n\nimport { useState } from 'react';\nimport { hashKey, type QueryKey } from '@tanstack/react-query';\n\nexport interface ReadRetrySource<TError = Error> {\n  error: TError | null | undefined;\n  isFetching: boolean;\n  isLoading: boolean;\n  isPaused?: boolean;\n}\n\nexport interface ReadRetryState<TError = Error> {\n  error: TError | null;\n  isRetrying: boolean;\n  isLoading: boolean;\n}\n\ninterface HeldFailure<TError> {\n  error: TError;\n}\n\n/** A composite source builds a new error object every render, so a failure is compared by name, message, and `code`. */\nfunction sameFailure(a: unknown, b: unknown): boolean {\n  if (a === b) return true;\n  if (typeof a !== 'object' || a === null || typeof b !== 'object' || b === null) return false;\n  const x = a as { name?: unknown; message?: unknown; code?: unknown };\n  const y = b as { name?: unknown; message?: unknown; code?: unknown };\n  return x.name === y.name && x.message === y.message && x.code === y.code;\n}\n\nexport interface ReadRetryEntry<TError = Error> {\n  source: ReadRetrySource<TError>;\n  queryKey: QueryKey;\n}\n\nfunction nextHeldFailure<TError>(\n  held: HeldFailure<TError> | undefined,\n  source: ReadRetrySource<TError>,\n): HeldFailure<TError> | undefined {\n  const live = source.error ?? null;\n  if (live !== null)\n    return held !== undefined && sameFailure(held.error, live) ? held : { error: live };\n  const running = source.isFetching || source.isPaused === true;\n  return running ? held : undefined;\n}\n\nfunction toRetryState<TError>(\n  source: ReadRetrySource<TError>,\n  held: HeldFailure<TError> | undefined,\n): ReadRetryState<TError> {\n  const error = source.error ?? held?.error ?? null;\n  return {\n    error,\n    isRetrying: error !== null && (source.isFetching || source.isPaused === true),\n    isLoading: error === null && source.isLoading,\n  };\n}\n\nexport function useReadRetryStates<TError = Error>(\n  entries: readonly ReadRetryEntry<TError>[],\n): ReadRetryState<TError>[] {\n  const [held, setHeld] = useState<Readonly<Record<string, HeldFailure<TError>>>>({});\n\n  const next: Record<string, HeldFailure<TError>> = {};\n  const states = entries.map(({ source, queryKey }) => {\n    const identity = hashKey(queryKey);\n    const failure = nextHeldFailure(held[identity], source);\n    if (failure !== undefined) next[identity] = failure;\n    return toRetryState(source, failure);\n  });\n  if (!sameHeld(held, next)) setHeld(next);\n  return states;\n}\n\nfunction sameHeld<TError>(\n  a: Readonly<Record<string, HeldFailure<TError>>>,\n  b: Readonly<Record<string, HeldFailure<TError>>>,\n): boolean {\n  const keys = Object.keys(a);\n  return keys.length === Object.keys(b).length && keys.every((key) => a[key] === b[key]);\n}\n\n/** TanStack clears a never-succeeded query's `error` as its refetch starts, so the failure is held until the retry settles. */\nexport function useReadRetryState<TError = Error>(\n  source: ReadRetrySource<TError>,\n  queryKey: QueryKey,\n): ReadRetryState<TError> {\n  return useReadRetryStates([{ source, queryKey }])[0]!;\n}\n"]}

package/dist/search/rule.d.ts

@@ -1,10 +1,4 @@
-/** The fewest characters, counted on the normalized text, that `useFirestoreSearch` searches. */
 export declare const FIRESTORE_SEARCH_MIN_LENGTH = 3;
-/**
- * The text `useFirestoreSearch` reads for a typed text: lowercased, surrounding whitespace dropped.
- * Two typed texts with the same normalized text are the same search.
- */
 export declare function normalizeSearchText(text: string): string;
-/** Whether `useFirestoreSearch` searches this typed text (its normalized length reaches the minimum). */
 export declare function isSearchableText(text: string): boolean;
 //# sourceMappingURL=rule.d.ts.map

package/dist/search/rule.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"rule.d.ts","sourceRoot":"","sources":["../../src/search/rule.ts"],"names":[],"mappings":"AAAA,iGAAiG;AACjG,eAAO,MAAM,2BAA2B,IAAI,CAAC;AAE7C;;;GAGG;AACH,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAExD;AAED,yGAAyG;AACzG,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAEtD"}
+{"version":3,"file":"rule.d.ts","sourceRoot":"","sources":["../../src/search/rule.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,2BAA2B,IAAI,CAAC;AAE7C,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAExD;AAED,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAEtD"}

package/dist/search/rule.js

@@ -1,13 +1,7 @@
-/** The fewest characters, counted on the normalized text, that `useFirestoreSearch` searches. */
 export const FIRESTORE_SEARCH_MIN_LENGTH = 3;
-/**
- * The text `useFirestoreSearch` reads for a typed text: lowercased, surrounding whitespace dropped.
- * Two typed texts with the same normalized text are the same search.
- */
 export function normalizeSearchText(text) {
     return text.toLowerCase().trim();
 }
-/** Whether `useFirestoreSearch` searches this typed text (its normalized length reaches the minimum). */
 export function isSearchableText(text) {
     return normalizeSearchText(text).length >= FIRESTORE_SEARCH_MIN_LENGTH;
 }

package/dist/search/rule.js.map

@@ -1 +1 @@
-{"version":3,"file":"rule.js","sourceRoot":"","sources":["../../src/search/rule.ts"],"names":[],"mappings":"AAAA,iGAAiG;AACjG,MAAM,CAAC,MAAM,2BAA2B,GAAG,CAAC,CAAC;AAE7C;;;GAGG;AACH,MAAM,UAAU,mBAAmB,CAAC,IAAY;IAC9C,OAAO,IAAI,CAAC,WAAW,EAAE,CAAC,IAAI,EAAE,CAAC;AACnC,CAAC;AAED,yGAAyG;AACzG,MAAM,UAAU,gBAAgB,CAAC,IAAY;IAC3C,OAAO,mBAAmB,CAAC,IAAI,CAAC,CAAC,MAAM,IAAI,2BAA2B,CAAC;AACzE,CAAC","sourcesContent":["/** The fewest characters, counted on the normalized text, that `useFirestoreSearch` searches. */\nexport const FIRESTORE_SEARCH_MIN_LENGTH = 3;\n\n/**\n * The text `useFirestoreSearch` reads for a typed text: lowercased, surrounding whitespace dropped.\n * Two typed texts with the same normalized text are the same search.\n */\nexport function normalizeSearchText(text: string): string {\n  return text.toLowerCase().trim();\n}\n\n/** Whether `useFirestoreSearch` searches this typed text (its normalized length reaches the minimum). */\nexport function isSearchableText(text: string): boolean {\n  return normalizeSearchText(text).length >= FIRESTORE_SEARCH_MIN_LENGTH;\n}\n"]}
+{"version":3,"file":"rule.js","sourceRoot":"","sources":["../../src/search/rule.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,2BAA2B,GAAG,CAAC,CAAC;AAE7C,MAAM,UAAU,mBAAmB,CAAC,IAAY;IAC9C,OAAO,IAAI,CAAC,WAAW,EAAE,CAAC,IAAI,EAAE,CAAC;AACnC,CAAC;AAED,MAAM,UAAU,gBAAgB,CAAC,IAAY;IAC3C,OAAO,mBAAmB,CAAC,IAAI,CAAC,CAAC,MAAM,IAAI,2BAA2B,CAAC;AACzE,CAAC","sourcesContent":["export const FIRESTORE_SEARCH_MIN_LENGTH = 3;\n\nexport function normalizeSearchText(text: string): string {\n  return text.toLowerCase().trim();\n}\n\nexport function isSearchableText(text: string): boolean {\n  return normalizeSearchText(text).length >= FIRESTORE_SEARCH_MIN_LENGTH;\n}\n"]}

package/dist/search/types.d.ts

@@ -1,24 +1,12 @@
-/**
- * Equality filter applied before the prefix range in a Firestore search.
- * Each becomes a `where(field, '==', value)` constraint, ordered ahead of the
- * search field. The composite index must list these equality fields (ASC)
- * before the search field (ASC).
- */
+/** The composite index must list these equality fields (ASC) before the search field (ASC). */
 export interface SearchEqualityFilter {
     field: string;
     value: unknown;
 }
-/**
- * Configuration for a Firestore search query
- */
 export interface FirestoreSearchConfig {
-    /** Firestore collection path to search */
     collectionPath: string;
-    /** Field name to search on (must be indexed and lowercase) */
     searchField: string;
-    /** Maximum number of results to return */
     limit: number;
-    /** Optional equality filters applied before the prefix range. */
     equalityFilters?: SearchEqualityFilter[];
 }
 //# sourceMappingURL=types.d.ts.map

package/dist/search/types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/search/types.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,MAAM,WAAW,oBAAoB;IACnC,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,OAAO,CAAC;CAChB;AAED;;GAEG;AACH,MAAM,WAAW,qBAAqB;IACpC,0CAA0C;IAC1C,cAAc,EAAE,MAAM,CAAC;IACvB,8DAA8D;IAC9D,WAAW,EAAE,MAAM,CAAC;IACpB,0CAA0C;IAC1C,KAAK,EAAE,MAAM,CAAC;IACd,iEAAiE;IACjE,eAAe,CAAC,EAAE,oBAAoB,EAAE,CAAC;CAC1C"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/search/types.ts"],"names":[],"mappings":"AAAA,+FAA+F;AAC/F,MAAM,WAAW,oBAAoB;IACnC,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,OAAO,CAAC;CAChB;AAED,MAAM,WAAW,qBAAqB;IACpC,cAAc,EAAE,MAAM,CAAC;IACvB,WAAW,EAAE,MAAM,CAAC;IACpB,KAAK,EAAE,MAAM,CAAC;IACd,eAAe,CAAC,EAAE,oBAAoB,EAAE,CAAC;CAC1C"}

package/dist/search/types.js.map

@@ -1 +1 @@
-{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/search/types.ts"],"names":[],"mappings":"","sourcesContent":["/**\n * Equality filter applied before the prefix range in a Firestore search.\n * Each becomes a `where(field, '==', value)` constraint, ordered ahead of the\n * search field. The composite index must list these equality fields (ASC)\n * before the search field (ASC).\n */\nexport interface SearchEqualityFilter {\n  field: string;\n  value: unknown;\n}\n\n/**\n * Configuration for a Firestore search query\n */\nexport interface FirestoreSearchConfig {\n  /** Firestore collection path to search */\n  collectionPath: string;\n  /** Field name to search on (must be indexed and lowercase) */\n  searchField: string;\n  /** Maximum number of results to return */\n  limit: number;\n  /** Optional equality filters applied before the prefix range. */\n  equalityFilters?: SearchEqualityFilter[];\n}\n"]}
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/search/types.ts"],"names":[],"mappings":"","sourcesContent":["/** The composite index must list these equality fields (ASC) before the search field (ASC). */\nexport interface SearchEqualityFilter {\n  field: string;\n  value: unknown;\n}\n\nexport interface FirestoreSearchConfig {\n  collectionPath: string;\n  searchField: string;\n  limit: number;\n  equalityFilters?: SearchEqualityFilter[];\n}\n"]}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ttt-productions/query-core",
-  "version": "0.14.22",
+  "version": "0.14.24",
   "description": "Shared TanStack Query (React Query) client defaults, query key helpers, and Firestore integration hooks for TTT Productions apps",
   "repository": {
     "type": "git",
@@ -40,7 +40,7 @@
     "prepublishOnly": "npm run clean && npm run build"
   },
   "peerDependencies": {
-    "@tanstack/react-query": ">=5.0.0",
+    "@tanstack/react-query": ">=5.90.0",
     "firebase": ">=12.0.0",
     "react": ">=19.0.0",
     "react-dom": ">=19.0.0"
@@ -60,10 +60,10 @@
     }
   },
   "dependencies": {
-    "@ttt-productions/firebase-helpers": "^0.12.13"
+    "@ttt-productions/firebase-helpers": "^0.12.16"
   },
   "devDependencies": {
-    "@tanstack/react-query": "^5.0.0",
+    "@tanstack/react-query": "^5.90.0",
     "@types/react": "^19.0.0",
     "@types/react-dom": "^19.0.0",
     "firebase": "^12.14.0",