@ttt-productions/query-core 0.14.21 → 0.14.23

package/dist/react/pending-mutations.js

@@ -1,36 +1,18 @@
-"use client";
-// Authoritative pending for interactive mutations. A mutation registers in React Query's shared
-// MutationCache under a stable `mutationKey` the app declares (one key per action), and its target
-// travels in the mutation's variables. Pending is read from that cache, never from one mounted
-// control's `isPending`, which gives three guarantees:
-//
-//   1. an in-flight request survives its originating control unmounting;
-//   2. a remounted control still renders pending for that target;
-//   3. a second submission for the same target is refused while the first is pending.
-//
-// The app owns its keys, its variable shapes and what counts as the same target; this module owns
-// only the mechanics.
-import { useCallback } from "react";
-import { useMutationState, useQueryClient, } from "@tanstack/react-query";
-/** The variables of every pending mutation under `mutationKey` (prefix-matched), live. */
+'use client';
+import { useCallback } from 'react';
+import { useMutationState, useQueryClient, } from '@tanstack/react-query';
 export function usePendingMutationVariables(mutationKey) {
     return useMutationState({
-        filters: { mutationKey, status: "pending" },
+        filters: { mutationKey, status: 'pending' },
         select: (mutation) => mutation.state.variables,
     });
 }
-/** The variables of every pending mutation under `mutationKey`, read once — for a duplicate guard. */
 export function pendingMutationVariables(queryClient, mutationKey) {
     return queryClient
         .getMutationCache()
-        .findAll({ mutationKey, status: "pending" })
+        .findAll({ mutationKey, status: 'pending' })
         .map((mutation) => mutation.state.variables);
 }
-/**
- * The targets of every pending mutation under `mutationKey`, live — for a list whose rows each
- * ask "is mine pending?" through one hook call. `targetOf` names a variables' target, or returns
- * nothing for variables without one.
- */
 export function usePendingMutationTargets(mutationKey, targetOf) {
     const targets = new Set();
     for (const variables of usePendingMutationVariables(mutationKey)) {
@@ -42,31 +24,18 @@ export function usePendingMutationTargets(mutationKey, targetOf) {
     }
     return targets;
 }
-/**
- * True when a mutation under `mutationKey` is pending — any one, or with `matches`, one whose
- * variables are for the same target.
- */
 export function hasPendingMutation(queryClient, mutationKey, matches) {
     const pending = pendingMutationVariables(queryClient, mutationKey);
     if (!matches)
         return pending.length > 0;
     return pending.some((variables) => variables !== undefined && matches(variables));
 }
-/**
- * The rejection a guarded `mutateAsync` throws for a duplicate submission: an `AbortError`, the
- * shape a caller already treats as "nothing happened" rather than a failure to report.
- */
 export function duplicateSubmissionError(what) {
     const duplicate = new Error(`${what} is already in flight.`);
-    duplicate.name = "AbortError";
+    duplicate.name = 'AbortError';
     return duplicate;
 }
-/**
- * Wrap a keyed mutation's `mutate` / `mutateAsync` in the cache-consulting duplicate guard:
- * `mutate` drops a duplicate silently, and `mutateAsync` rejects it with
- * {@link duplicateSubmissionError}. `isDuplicate` must have a stable identity (declare it at module
- * level) so the guarded callbacks keep theirs.
- */
+/** `isDuplicate` must have a stable identity (declare it at module level) so the guarded callbacks keep theirs. */
 export function useDuplicateGuardedMutation(mutation, isDuplicate, what) {
     const queryClient = useQueryClient();
     const { mutate: rawMutate, mutateAsync: rawMutateAsync } = mutation;

package/dist/react/pending-mutations.js.map

@@ -1 +1 @@
-{"version":3,"file":"pending-mutations.js","sourceRoot":"","sources":["../../src/react/pending-mutations.ts"],"names":[],"mappings":"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","sourcesContent":["\"use client\";\n\n// Authoritative pending for interactive mutations. A mutation registers in React Query's shared\n// MutationCache under a stable `mutationKey` the app declares (one key per action), and its target\n// travels in the mutation's variables. Pending is read from that cache, never from one mounted\n// control's `isPending`, which gives three guarantees:\n//\n//   1. an in-flight request survives its originating control unmounting;\n//   2. a remounted control still renders pending for that target;\n//   3. a second submission for the same target is refused while the first is pending.\n//\n// The app owns its keys, its variable shapes and what counts as the same target; this module owns\n// only the mechanics.\n\nimport { useCallback } from \"react\";\nimport {\n  useMutationState,\n  useQueryClient,\n  type MutateOptions,\n  type MutationKey,\n  type QueryClient,\n  type UseMutationResult,\n} from \"@tanstack/react-query\";\n\n/** The variables of every pending mutation under `mutationKey` (prefix-matched), live. */\nexport function usePendingMutationVariables<V>(mutationKey: MutationKey): ReadonlyArray<V | undefined> {\n  return useMutationState({\n    filters: { mutationKey, status: \"pending\" },\n    select: (mutation) => mutation.state.variables as V | undefined,\n  });\n}\n\n/** The variables of every pending mutation under `mutationKey`, read once — for a duplicate guard. */\nexport function pendingMutationVariables<V>(\n  queryClient: QueryClient,\n  mutationKey: MutationKey,\n): Array<V | undefined> {\n  return queryClient\n    .getMutationCache()\n    .findAll({ mutationKey, status: \"pending\" })\n    .map((mutation) => mutation.state.variables as V | undefined);\n}\n\n/**\n * The targets of every pending mutation under `mutationKey`, live — for a list whose rows each\n * ask \"is mine pending?\" through one hook call. `targetOf` names a variables' target, or returns\n * nothing for variables without one.\n */\nexport function usePendingMutationTargets<V>(\n  mutationKey: MutationKey,\n  targetOf: (variables: V) => string | null | undefined,\n): ReadonlySet<string> {\n  const targets = new Set<string>();\n  for (const variables of usePendingMutationVariables<V>(mutationKey)) {\n    if (variables === undefined) continue;\n    const target = targetOf(variables);\n    if (target) targets.add(target);\n  }\n  return targets;\n}\n\n/**\n * True when a mutation under `mutationKey` is pending — any one, or with `matches`, one whose\n * variables are for the same target.\n */\nexport function hasPendingMutation<V>(\n  queryClient: QueryClient,\n  mutationKey: MutationKey,\n  matches?: (variables: V) => boolean,\n): boolean {\n  const pending = pendingMutationVariables<V>(queryClient, mutationKey);\n  if (!matches) return pending.length > 0;\n  return pending.some((variables) => variables !== undefined && matches(variables));\n}\n\n/**\n * The rejection a guarded `mutateAsync` throws for a duplicate submission: an `AbortError`, the\n * shape a caller already treats as \"nothing happened\" rather than a failure to report.\n */\nexport function duplicateSubmissionError(what: string): Error {\n  const duplicate = new Error(`${what} is already in flight.`);\n  duplicate.name = \"AbortError\";\n  return duplicate;\n}\n\n/**\n * Wrap a keyed mutation's `mutate` / `mutateAsync` in the cache-consulting duplicate guard:\n * `mutate` drops a duplicate silently, and `mutateAsync` rejects it with\n * {@link duplicateSubmissionError}. `isDuplicate` must have a stable identity (declare it at module\n * level) so the guarded callbacks keep theirs.\n */\nexport function useDuplicateGuardedMutation<TData, TError, TVariables, TContext>(\n  mutation: UseMutationResult<TData, TError, TVariables, TContext>,\n  isDuplicate: (queryClient: QueryClient, variables: TVariables) => boolean,\n  what: string,\n): UseMutationResult<TData, TError, TVariables, TContext> {\n  const queryClient = useQueryClient();\n  const { mutate: rawMutate, mutateAsync: rawMutateAsync } = mutation;\n  const mutate = useCallback(\n    (variables: TVariables, options?: MutateOptions<TData, TError, TVariables, TContext>) => {\n      if (isDuplicate(queryClient, variables)) return;\n      rawMutate(variables, options);\n    },\n    [queryClient, rawMutate, isDuplicate],\n  );\n  const mutateAsync = useCallback(\n    async (variables: TVariables, options?: MutateOptions<TData, TError, TVariables, TContext>) => {\n      if (isDuplicate(queryClient, variables)) throw duplicateSubmissionError(what);\n      return rawMutateAsync(variables, options);\n    },\n    [queryClient, rawMutateAsync, isDuplicate, what],\n  );\n  return { ...mutation, mutate, mutateAsync } as UseMutationResult<TData, TError, TVariables, TContext>;\n}\n"]}
+{"version":3,"file":"pending-mutations.js","sourceRoot":"","sources":["../../src/react/pending-mutations.ts"],"names":[],"mappings":"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","sourcesContent":["'use client';\n\nimport { useCallback } from 'react';\nimport {\n  useMutationState,\n  useQueryClient,\n  type MutateOptions,\n  type MutationKey,\n  type QueryClient,\n  type UseMutationResult,\n} from '@tanstack/react-query';\n\nexport function usePendingMutationVariables<V>(\n  mutationKey: MutationKey,\n): ReadonlyArray<V | undefined> {\n  return useMutationState({\n    filters: { mutationKey, status: 'pending' },\n    select: (mutation) => mutation.state.variables as V | undefined,\n  });\n}\n\nexport function pendingMutationVariables<V>(\n  queryClient: QueryClient,\n  mutationKey: MutationKey,\n): Array<V | undefined> {\n  return queryClient\n    .getMutationCache()\n    .findAll({ mutationKey, status: 'pending' })\n    .map((mutation) => mutation.state.variables as V | undefined);\n}\n\nexport function usePendingMutationTargets<V>(\n  mutationKey: MutationKey,\n  targetOf: (variables: V) => string | null | undefined,\n): ReadonlySet<string> {\n  const targets = new Set<string>();\n  for (const variables of usePendingMutationVariables<V>(mutationKey)) {\n    if (variables === undefined) continue;\n    const target = targetOf(variables);\n    if (target) targets.add(target);\n  }\n  return targets;\n}\n\nexport function hasPendingMutation<V>(\n  queryClient: QueryClient,\n  mutationKey: MutationKey,\n  matches?: (variables: V) => boolean,\n): boolean {\n  const pending = pendingMutationVariables<V>(queryClient, mutationKey);\n  if (!matches) return pending.length > 0;\n  return pending.some((variables) => variables !== undefined && matches(variables));\n}\n\nexport function duplicateSubmissionError(what: string): Error {\n  const duplicate = new Error(`${what} is already in flight.`);\n  duplicate.name = 'AbortError';\n  return duplicate;\n}\n\n/** `isDuplicate` must have a stable identity (declare it at module level) so the guarded callbacks keep theirs. */\nexport function useDuplicateGuardedMutation<TData, TError, TVariables, TContext>(\n  mutation: UseMutationResult<TData, TError, TVariables, TContext>,\n  isDuplicate: (queryClient: QueryClient, variables: TVariables) => boolean,\n  what: string,\n): UseMutationResult<TData, TError, TVariables, TContext> {\n  const queryClient = useQueryClient();\n  const { mutate: rawMutate, mutateAsync: rawMutateAsync } = mutation;\n  const mutate = useCallback(\n    (variables: TVariables, options?: MutateOptions<TData, TError, TVariables, TContext>) => {\n      if (isDuplicate(queryClient, variables)) return;\n      rawMutate(variables, options);\n    },\n    [queryClient, rawMutate, isDuplicate],\n  );\n  const mutateAsync = useCallback(\n    async (variables: TVariables, options?: MutateOptions<TData, TError, TVariables, TContext>) => {\n      if (isDuplicate(queryClient, variables)) throw duplicateSubmissionError(what);\n      return rawMutateAsync(variables, options);\n    },\n    [queryClient, rawMutateAsync, isDuplicate, what],\n  );\n  return { ...mutation, mutate, mutateAsync } as UseMutationResult<\n    TData,\n    TError,\n    TVariables,\n    TContext\n  >;\n}\n"]}

package/dist/react/provider.d.ts

@@ -1,12 +1,7 @@
 import React from 'react';
-import { type CreateQueryClientOptions } from '../query-client.js';
+import { type CreateQueryClientOptions } from './query-client.js';
 export type QueryProviderProps = React.PropsWithChildren<{
-    /** Optional overrides applied when the client is first created. */
     clientOptions?: CreateQueryClientOptions;
 }>;
-/**
- * Client component wrapper for Next.js / React apps.
- * Creates a single QueryClient per browser session.
- */
 export declare function QueryProvider({ children, clientOptions }: QueryProviderProps): React.JSX.Element;
 //# sourceMappingURL=provider.d.ts.map

package/dist/react/provider.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"provider.d.ts","sourceRoot":"","sources":["../../src/react/provider.tsx"],"names":[],"mappings":"AAEA,OAAO,KAAK,MAAM,OAAO,CAAC;AAE1B,OAAO,EAAqB,KAAK,wBAAwB,EAAE,MAAM,oBAAoB,CAAC;AAEtF,MAAM,MAAM,kBAAkB,GAAG,KAAK,CAAC,iBAAiB,CAAC;IACvD,mEAAmE;IACnE,aAAa,CAAC,EAAE,wBAAwB,CAAC;CAC1C,CAAC,CAAC;AAEH;;;GAGG;AACH,wBAAgB,aAAa,CAAC,EAAE,QAAQ,EAAE,aAAa,EAAE,EAAE,kBAAkB,qBAG5E"}
+{"version":3,"file":"provider.d.ts","sourceRoot":"","sources":["../../src/react/provider.tsx"],"names":[],"mappings":"AAEA,OAAO,KAAK,MAAM,OAAO,CAAC;AAE1B,OAAO,EAAqB,KAAK,wBAAwB,EAAE,MAAM,mBAAmB,CAAC;AAErF,MAAM,MAAM,kBAAkB,GAAG,KAAK,CAAC,iBAAiB,CAAC;IACvD,aAAa,CAAC,EAAE,wBAAwB,CAAC;CAC1C,CAAC,CAAC;AAEH,wBAAgB,aAAa,CAAC,EAAE,QAAQ,EAAE,aAAa,EAAE,EAAE,kBAAkB,qBAG5E"}

package/dist/react/provider.js

@@ -2,11 +2,7 @@
 import { jsx as _jsx } from "react/jsx-runtime";
 import React from 'react';
 import { QueryClientProvider } from '@tanstack/react-query';
-import { createQueryClient } from '../query-client.js';
-/**
- * Client component wrapper for Next.js / React apps.
- * Creates a single QueryClient per browser session.
- */
+import { createQueryClient } from './query-client.js';
 export function QueryProvider({ children, clientOptions }) {
     const [client] = React.useState(() => createQueryClient(clientOptions));
     return _jsx(QueryClientProvider, { client: client, children: children });

package/dist/react/provider.js.map

@@ -1 +1 @@
-{"version":3,"file":"provider.js","sourceRoot":"","sources":["../../src/react/provider.tsx"],"names":[],"mappings":"AAAA,YAAY,CAAC;;AAEb,OAAO,KAAK,MAAM,OAAO,CAAC;AAC1B,OAAO,EAAE,mBAAmB,EAAE,MAAM,uBAAuB,CAAC;AAC5D,OAAO,EAAE,iBAAiB,EAAiC,MAAM,oBAAoB,CAAC;AAOtF;;;GAGG;AACH,MAAM,UAAU,aAAa,CAAC,EAAE,QAAQ,EAAE,aAAa,EAAsB;IAC3E,MAAM,CAAC,MAAM,CAAC,GAAG,KAAK,CAAC,QAAQ,CAAC,GAAG,EAAE,CAAC,iBAAiB,CAAC,aAAa,CAAC,CAAC,CAAC;IACxE,OAAO,KAAC,mBAAmB,IAAC,MAAM,EAAE,MAAM,YAAG,QAAQ,GAAuB,CAAC;AAC/E,CAAC","sourcesContent":["'use client';\n\nimport React from 'react';\nimport { QueryClientProvider } from '@tanstack/react-query';\nimport { createQueryClient, type CreateQueryClientOptions } from '../query-client.js';\n\nexport type QueryProviderProps = React.PropsWithChildren<{\n  /** Optional overrides applied when the client is first created. */\n  clientOptions?: CreateQueryClientOptions;\n}>;\n\n/**\n * Client component wrapper for Next.js / React apps.\n * Creates a single QueryClient per browser session.\n */\nexport function QueryProvider({ children, clientOptions }: QueryProviderProps) {\n  const [client] = React.useState(() => createQueryClient(clientOptions));\n  return <QueryClientProvider client={client}>{children}</QueryClientProvider>;\n}\n"]}
+{"version":3,"file":"provider.js","sourceRoot":"","sources":["../../src/react/provider.tsx"],"names":[],"mappings":"AAAA,YAAY,CAAC;;AAEb,OAAO,KAAK,MAAM,OAAO,CAAC;AAC1B,OAAO,EAAE,mBAAmB,EAAE,MAAM,uBAAuB,CAAC;AAC5D,OAAO,EAAE,iBAAiB,EAAiC,MAAM,mBAAmB,CAAC;AAMrF,MAAM,UAAU,aAAa,CAAC,EAAE,QAAQ,EAAE,aAAa,EAAsB;IAC3E,MAAM,CAAC,MAAM,CAAC,GAAG,KAAK,CAAC,QAAQ,CAAC,GAAG,EAAE,CAAC,iBAAiB,CAAC,aAAa,CAAC,CAAC,CAAC;IACxE,OAAO,KAAC,mBAAmB,IAAC,MAAM,EAAE,MAAM,YAAG,QAAQ,GAAuB,CAAC;AAC/E,CAAC","sourcesContent":["'use client';\n\nimport React from 'react';\nimport { QueryClientProvider } from '@tanstack/react-query';\nimport { createQueryClient, type CreateQueryClientOptions } from './query-client.js';\n\nexport type QueryProviderProps = React.PropsWithChildren<{\n  clientOptions?: CreateQueryClientOptions;\n}>;\n\nexport function QueryProvider({ children, clientOptions }: QueryProviderProps) {\n  const [client] = React.useState(() => createQueryClient(clientOptions));\n  return <QueryClientProvider client={client}>{children}</QueryClientProvider>;\n}\n"]}

package/dist/{query-client.d.ts → react/query-client.d.ts}

@@ -1,8 +1,4 @@
 import { QueryClient, type QueryClientConfig } from '@tanstack/react-query';
 export type CreateQueryClientOptions = QueryClientConfig;
-/**
- * Factory so every app uses the same baseline behavior.
- * Pass overrides to adjust defaults without forking.
- */
 export declare function createQueryClient(overrides?: CreateQueryClientOptions): QueryClient;
 //# sourceMappingURL=query-client.d.ts.map

package/dist/react/query-client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"query-client.d.ts","sourceRoot":"","sources":["../../src/react/query-client.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,KAAK,iBAAiB,EAAE,MAAM,uBAAuB,CAAC;AAG5E,MAAM,MAAM,wBAAwB,GAAG,iBAAiB,CAAC;AAEzD,wBAAgB,iBAAiB,CAAC,SAAS,GAAE,wBAA6B,eAiBzE"}

package/dist/{query-client.js → react/query-client.js}

@@ -1,9 +1,5 @@
 import { QueryClient } from '@tanstack/react-query';
 import { defaultQueryClientConfig } from './defaults.js';
-/**
- * Factory so every app uses the same baseline behavior.
- * Pass overrides to adjust defaults without forking.
- */
 export function createQueryClient(overrides = {}) {
     return new QueryClient({
         ...defaultQueryClientConfig,

package/dist/react/query-client.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"query-client.js","sourceRoot":"","sources":["../../src/react/query-client.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAA0B,MAAM,uBAAuB,CAAC;AAC5E,OAAO,EAAE,wBAAwB,EAAE,MAAM,eAAe,CAAC;AAIzD,MAAM,UAAU,iBAAiB,CAAC,YAAsC,EAAE;IACxE,OAAO,IAAI,WAAW,CAAC;QACrB,GAAG,wBAAwB;QAC3B,GAAG,SAAS;QACZ,cAAc,EAAE;YACd,GAAG,wBAAwB,CAAC,cAAc;YAC1C,GAAG,SAAS,CAAC,cAAc;YAC3B,OAAO,EAAE;gBACP,GAAG,wBAAwB,CAAC,cAAc,EAAE,OAAO;gBACnD,GAAG,SAAS,CAAC,cAAc,EAAE,OAAO;aACrC;YACD,SAAS,EAAE;gBACT,GAAG,wBAAwB,CAAC,cAAc,EAAE,SAAS;gBACrD,GAAG,SAAS,CAAC,cAAc,EAAE,SAAS;aACvC;SACF;KACF,CAAC,CAAC;AACL,CAAC","sourcesContent":["import { QueryClient, type QueryClientConfig } from '@tanstack/react-query';\nimport { defaultQueryClientConfig } from './defaults.js';\n\nexport type CreateQueryClientOptions = QueryClientConfig;\n\nexport function createQueryClient(overrides: CreateQueryClientOptions = {}) {\n  return new QueryClient({\n    ...defaultQueryClientConfig,\n    ...overrides,\n    defaultOptions: {\n      ...defaultQueryClientConfig.defaultOptions,\n      ...overrides.defaultOptions,\n      queries: {\n        ...defaultQueryClientConfig.defaultOptions?.queries,\n        ...overrides.defaultOptions?.queries,\n      },\n      mutations: {\n        ...defaultQueryClientConfig.defaultOptions?.mutations,\n        ...overrides.defaultOptions?.mutations,\n      },\n    },\n  });\n}\n"]}

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

@@ -0,0 +1,16 @@
+import type { DocumentData } from 'firebase/firestore';
+import type { SearchEqualityFilter } from '../../search/types.js';
+export interface FirestoreSearchOptions<T extends DocumentData = DocumentData> {
+    collectionPath: string;
+    searchField: string;
+    queryText: string;
+    limit?: number;
+    enabled?: boolean;
+    select?: (data: DocumentData & {
+        id: string;
+    }) => T;
+    debounceMs?: number;
+    staleTime?: number;
+    equalityFilters?: SearchEqualityFilter[];
+}
+//# sourceMappingURL=types.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/react/search/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AACvD,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,uBAAuB,CAAC;AAElE,MAAM,WAAW,sBAAsB,CAAC,CAAC,SAAS,YAAY,GAAG,YAAY;IAC3E,cAAc,EAAE,MAAM,CAAC;IACvB,WAAW,EAAE,MAAM,CAAC;IACpB,SAAS,EAAE,MAAM,CAAC;IAClB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,MAAM,CAAC,EAAE,CAAC,IAAI,EAAE,YAAY,GAAG;QAAE,EAAE,EAAE,MAAM,CAAA;KAAE,KAAK,CAAC,CAAC;IACpD,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,eAAe,CAAC,EAAE,oBAAoB,EAAE,CAAC;CAC1C"}

package/dist/react/search/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/dist/react/search/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../src/react/search/types.ts"],"names":[],"mappings":"","sourcesContent":["import type { DocumentData } from 'firebase/firestore';\nimport type { SearchEqualityFilter } from '../../search/types.js';\n\nexport interface FirestoreSearchOptions<T extends DocumentData = DocumentData> {\n  collectionPath: string;\n  searchField: string;\n  queryText: string;\n  limit?: number;\n  enabled?: boolean;\n  select?: (data: DocumentData & { id: string }) => T;\n  debounceMs?: number;\n  staleTime?: number;\n  equalityFilters?: SearchEqualityFilter[];\n}\n"]}

package/dist/react/search/use-firestore-search.d.ts

@@ -1,35 +1,6 @@
 import { type UseQueryResult } from '@tanstack/react-query';
 import { type DocumentData } from 'firebase/firestore';
-import type { FirestoreSearchOptions } from '../../search/types.js';
+import type { FirestoreSearchOptions } from './types.js';
 import type { WithId } from '../../firestore/types.js';
-/**
- * Generic Firestore search hook with debouncing and case-insensitive prefix matching.
- * Automatically normalizes search text to lowercase and uses Firestore range queries.
- *
- * Features:
- * - Debounced input (default 300ms)
- * - Case-insensitive search
- * - Searches only a text `isSearchableText` accepts (`FIRESTORE_SEARCH_MIN_LENGTH`, trimmed)
- * - No answer while the debounce lags the typed text: `data` is undefined and `isLoading` is true
- *   (idle instead when the typed text is too short or the search is disabled)
- * - Prefix matching with '\uf8ff' suffix
- * - Configurable result limit
- *
- * @example
- * ```typescript
- * const { data, isLoading } = useFirestoreSearch<UserProfile>({
- *   collectionPath: 'userProfiles',
- *   searchField: 'username',
- *   queryText: searchValue,
- * });
- *
- * const { data } = useFirestoreSearch<Team>({
- *   collectionPath: 'teams',
- *   searchField: 'name_lowercase',
- *   queryText: searchValue,
- *   limit: 10,
- * });
- * ```
- */
 export declare function useFirestoreSearch<T extends DocumentData = DocumentData>({ collectionPath, searchField, queryText, limit, enabled, select, debounceMs, staleTime, equalityFilters, }: FirestoreSearchOptions<T>): UseQueryResult<WithId<T>[], Error>;
 //# sourceMappingURL=use-firestore-search.d.ts.map

package/dist/react/search/use-firestore-search.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"use-firestore-search.d.ts","sourceRoot":"","sources":["../../../src/react/search/use-firestore-search.ts"],"names":[],"mappings":"AAGA,OAAO,EAAY,KAAK,cAAc,EAAE,MAAM,uBAAuB,CAAC;AACtE,OAAO,EAOL,KAAK,YAAY,EAElB,MAAM,oBAAoB,CAAC;AAG5B,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,uBAAuB,CAAC;AACpE,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,0BAA0B,CAAC;AAOvD;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4BG;AACH,wBAAgB,kBAAkB,CAAC,CAAC,SAAS,YAAY,GAAG,YAAY,EAAE,EACxE,cAAc,EACd,WAAW,EACX,SAAS,EACT,KAAqB,EACrB,OAAc,EACd,MAAM,EACN,UAAgC,EAChC,SAA8B,EAC9B,eAAoB,GACrB,EAAE,sBAAsB,CAAC,CAAC,CAAC,GAAG,cAAc,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,KAAK,CAAC,CAwDhE"}
+{"version":3,"file":"use-firestore-search.d.ts","sourceRoot":"","sources":["../../../src/react/search/use-firestore-search.ts"],"names":[],"mappings":"AAGA,OAAO,EAAY,KAAK,cAAc,EAAE,MAAM,uBAAuB,CAAC;AACtE,OAAO,EAOL,KAAK,YAAY,EAElB,MAAM,oBAAoB,CAAC;AAG5B,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,YAAY,CAAC;AACzD,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,0BAA0B,CAAC;AAOvD,wBAAgB,kBAAkB,CAAC,CAAC,SAAS,YAAY,GAAG,YAAY,EAAE,EACxE,cAAc,EACd,WAAW,EACX,SAAS,EACT,KAAqB,EACrB,OAAc,EACd,MAAM,EACN,UAAgC,EAChC,SAA8B,EAC9B,eAAoB,GACrB,EAAE,sBAAsB,CAAC,CAAC,CAAC,GAAG,cAAc,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,KAAK,CAAC,CAyDhE"}

package/dist/react/search/use-firestore-search.js

@@ -7,40 +7,10 @@ import { keys } from '../../keys.js';
 import { isSearchableText, normalizeSearchText } from '../../search/rule.js';
 const DEFAULT_LIMIT = 5;
 const DEFAULT_DEBOUNCE_MS = 300;
-const DEFAULT_STALE_TIME = 60 * 1000; // 1 minute
-/**
- * Generic Firestore search hook with debouncing and case-insensitive prefix matching.
- * Automatically normalizes search text to lowercase and uses Firestore range queries.
- *
- * Features:
- * - Debounced input (default 300ms)
- * - Case-insensitive search
- * - Searches only a text `isSearchableText` accepts (`FIRESTORE_SEARCH_MIN_LENGTH`, trimmed)
- * - No answer while the debounce lags the typed text: `data` is undefined and `isLoading` is true
- *   (idle instead when the typed text is too short or the search is disabled)
- * - Prefix matching with '\uf8ff' suffix
- * - Configurable result limit
- *
- * @example
- * ```typescript
- * const { data, isLoading } = useFirestoreSearch<UserProfile>({
- *   collectionPath: 'userProfiles',
- *   searchField: 'username',
- *   queryText: searchValue,
- * });
- *
- * const { data } = useFirestoreSearch<Team>({
- *   collectionPath: 'teams',
- *   searchField: 'name_lowercase',
- *   queryText: searchValue,
- *   limit: 10,
- * });
- * ```
- */
+const DEFAULT_STALE_TIME = 60 * 1000;
 export function useFirestoreSearch({ collectionPath, searchField, queryText, limit = DEFAULT_LIMIT, enabled = true, select, debounceMs = DEFAULT_DEBOUNCE_MS, staleTime = DEFAULT_STALE_TIME, equalityFilters = [], }) {
     const db = useFirestoreDb();
     const [debouncedQuery, setDebouncedQuery] = useState(queryText);
-    // Debounce the search query
     useEffect(() => {
         const timer = setTimeout(() => {
             setDebouncedQuery(queryText);
@@ -56,8 +26,7 @@ export function useFirestoreSearch({ collectionPath, searchField, queryText, lim
                 return [];
             }
             const collectionRef = collection(db, collectionPath);
-            // Build range query for prefix matching
-            // Using '\uf8ff' as upper bound creates a range that matches all strings starting with the query
+            // '\uf8ff' is the highest code point Firestore orders, so the range covers every string with the prefix.
             const constraints = [
                 ...equalityFilters.map((f) => where(f.field, '==', f.value)),
                 where(searchField, '>=', normalizedQuery),
@@ -77,20 +46,13 @@ export function useFirestoreSearch({ collectionPath, searchField, queryText, lim
         enabled: shouldSearch,
         staleTime,
     });
-    // Until the debounce catches up, the query's key holds an earlier text, so its result (or its
-    // absence) is not an answer for the text typed now (FRONTEND-206): report no answer instead —
-    // still searching when the typed text will be searched, idle when it will not.
     const typedQuery = normalizeSearchText(queryText);
     if (typedQuery === normalizedQuery)
         return searchQuery;
     const willSearch = enabled && isSearchableText(queryText);
     return withoutAnswer(searchQuery, willSearch);
 }
-/**
- * The query result with every answer field replaced. The other fields stay getters onto the
- * original result: TanStack tracks which fields a component reads to decide when it re-renders,
- * and reading them all here (a spread) would opt every consumer out of that.
- */
+/** Other fields stay getters onto the original result: TanStack re-renders on the fields a component reads, and a spread reads them all. */
 function withoutAnswer(result, searching) {
     const answerFields = {
         data: undefined,

package/dist/react/search/use-firestore-search.js.map

@@ -1 +1 @@
-{"version":3,"file":"use-firestore-search.js","sourceRoot":"","sources":["../../../src/react/search/use-firestore-search.ts"],"names":[],"mappings":"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","sourcesContent":["'use client';\n\nimport { useState, useEffect } from 'react';\nimport { useQuery, type UseQueryResult } from '@tanstack/react-query';\nimport {\n  collection,\n  getDocs,\n  query,\n  where,\n  orderBy,\n  limit as firestoreLimit,\n  type DocumentData,\n  type QueryConstraint,\n} from 'firebase/firestore';\nimport { useFirestoreDb } from '../firestore/context.js';\nimport { keys } from '../../keys.js';\nimport type { FirestoreSearchOptions } from '../../search/types.js';\nimport type { WithId } from '../../firestore/types.js';\nimport { isSearchableText, normalizeSearchText } from '../../search/rule.js';\n\nconst DEFAULT_LIMIT = 5;\nconst DEFAULT_DEBOUNCE_MS = 300;\nconst DEFAULT_STALE_TIME = 60 * 1000; // 1 minute\n\n/**\n * Generic Firestore search hook with debouncing and case-insensitive prefix matching.\n * Automatically normalizes search text to lowercase and uses Firestore range queries.\n *\n * Features:\n * - Debounced input (default 300ms)\n * - Case-insensitive search\n * - Searches only a text `isSearchableText` accepts (`FIRESTORE_SEARCH_MIN_LENGTH`, trimmed)\n * - No answer while the debounce lags the typed text: `data` is undefined and `isLoading` is true\n *   (idle instead when the typed text is too short or the search is disabled)\n * - Prefix matching with '\\uf8ff' suffix\n * - Configurable result limit\n *\n * @example\n * ```typescript\n * const { data, isLoading } = useFirestoreSearch<UserProfile>({\n *   collectionPath: 'userProfiles',\n *   searchField: 'username',\n *   queryText: searchValue,\n * });\n *\n * const { data } = useFirestoreSearch<Team>({\n *   collectionPath: 'teams',\n *   searchField: 'name_lowercase',\n *   queryText: searchValue,\n *   limit: 10,\n * });\n * ```\n */\nexport function useFirestoreSearch<T extends DocumentData = DocumentData>({\n  collectionPath,\n  searchField,\n  queryText,\n  limit = DEFAULT_LIMIT,\n  enabled = true,\n  select,\n  debounceMs = DEFAULT_DEBOUNCE_MS,\n  staleTime = DEFAULT_STALE_TIME,\n  equalityFilters = [],\n}: FirestoreSearchOptions<T>): UseQueryResult<WithId<T>[], Error> {\n  const db = useFirestoreDb();\n  const [debouncedQuery, setDebouncedQuery] = useState(queryText);\n\n  // Debounce the search query\n  useEffect(() => {\n    const timer = setTimeout(() => {\n      setDebouncedQuery(queryText);\n    }, debounceMs);\n\n    return () => clearTimeout(timer);\n  }, [queryText, debounceMs]);\n\n  const normalizedQuery = normalizeSearchText(debouncedQuery);\n  const shouldSearch = enabled && isSearchableText(debouncedQuery);\n\n  const searchQuery = useQuery({\n    queryKey: keys.custom('search', collectionPath, searchField, normalizedQuery, JSON.stringify(equalityFilters)),\n    queryFn: async (): Promise<WithId<T>[]> => {\n      if (!shouldSearch) {\n        return [];\n      }\n\n      const collectionRef = collection(db, collectionPath);\n\n      // Build range query for prefix matching\n      // Using '\\uf8ff' as upper bound creates a range that matches all strings starting with the query\n      const constraints: QueryConstraint[] = [\n        ...equalityFilters.map((f) => where(f.field, '==', f.value)),\n        where(searchField, '>=', normalizedQuery),\n        where(searchField, '<=', normalizedQuery + '\\uf8ff'),\n        orderBy(searchField, 'asc'),\n        firestoreLimit(limit),\n      ];\n\n      const q = query(collectionRef, ...constraints);\n      const snapshot = await getDocs(q);\n\n      return snapshot.docs.map((docSnap) => {\n        const rawData = docSnap.data();\n        const dataWithId = { id: docSnap.id, ...rawData };\n        const data = select ? select(dataWithId) : dataWithId;\n        return data as WithId<T>;\n      });\n    },\n    enabled: shouldSearch,\n    staleTime,\n  });\n\n  // Until the debounce catches up, the query's key holds an earlier text, so its result (or its\n  // absence) is not an answer for the text typed now (FRONTEND-206): report no answer instead —\n  // still searching when the typed text will be searched, idle when it will not.\n  const typedQuery = normalizeSearchText(queryText);\n  if (typedQuery === normalizedQuery) return searchQuery;\n  const willSearch = enabled && isSearchableText(queryText);\n  return withoutAnswer(searchQuery, willSearch);\n}\n\n/**\n * The query result with every answer field replaced. The other fields stay getters onto the\n * original result: TanStack tracks which fields a component reads to decide when it re-renders,\n * and reading them all here (a spread) would opt every consumer out of that.\n */\nfunction withoutAnswer<R extends UseQueryResult<unknown, Error>>(result: R, searching: boolean): R {\n  const answerFields: Record<string, unknown> = {\n    data: undefined,\n    error: null,\n    isError: false,\n    isLoadingError: false,\n    isRefetchError: false,\n    isSuccess: false,\n    isPending: true,\n    isPlaceholderData: false,\n    isFetched: false,\n    isFetchedAfterMount: false,\n    isRefetching: false,\n    isLoading: searching,\n    isFetching: searching,\n    status: 'pending',\n    fetchStatus: searching ? 'fetching' : 'idle',\n    dataUpdatedAt: 0,\n    errorUpdatedAt: 0,\n  };\n  const view = {} as R;\n  for (const key of Object.keys(result)) {\n    Object.defineProperty(view, key, {\n      enumerable: true,\n      configurable: true,\n      get: key in answerFields ? () => answerFields[key] : () => result[key as keyof R],\n    });\n  }\n  return view;\n}\n\n"]}
+{"version":3,"file":"use-firestore-search.js","sourceRoot":"","sources":["../../../src/react/search/use-firestore-search.ts"],"names":[],"mappings":"AAAA,YAAY,CAAC;AAEb,OAAO,EAAE,QAAQ,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC;AAC5C,OAAO,EAAE,QAAQ,EAAuB,MAAM,uBAAuB,CAAC;AACtE,OAAO,EACL,UAAU,EACV,OAAO,EACP,KAAK,EACL,KAAK,EACL,OAAO,EACP,KAAK,IAAI,cAAc,GAGxB,MAAM,oBAAoB,CAAC;AAC5B,OAAO,EAAE,cAAc,EAAE,MAAM,yBAAyB,CAAC;AACzD,OAAO,EAAE,IAAI,EAAE,MAAM,eAAe,CAAC;AAGrC,OAAO,EAAE,gBAAgB,EAAE,mBAAmB,EAAE,MAAM,sBAAsB,CAAC;AAE7E,MAAM,aAAa,GAAG,CAAC,CAAC;AACxB,MAAM,mBAAmB,GAAG,GAAG,CAAC;AAChC,MAAM,kBAAkB,GAAG,EAAE,GAAG,IAAI,CAAC;AAErC,MAAM,UAAU,kBAAkB,CAAwC,EACxE,cAAc,EACd,WAAW,EACX,SAAS,EACT,KAAK,GAAG,aAAa,EACrB,OAAO,GAAG,IAAI,EACd,MAAM,EACN,UAAU,GAAG,mBAAmB,EAChC,SAAS,GAAG,kBAAkB,EAC9B,eAAe,GAAG,EAAE,GACM;IAC1B,MAAM,EAAE,GAAG,cAAc,EAAE,CAAC;IAC5B,MAAM,CAAC,cAAc,EAAE,iBAAiB,CAAC,GAAG,QAAQ,CAAC,SAAS,CAAC,CAAC;IAEhE,SAAS,CAAC,GAAG,EAAE;QACb,MAAM,KAAK,GAAG,UAAU,CAAC,GAAG,EAAE;YAC5B,iBAAiB,CAAC,SAAS,CAAC,CAAC;QAC/B,CAAC,EAAE,UAAU,CAAC,CAAC;QAEf,OAAO,GAAG,EAAE,CAAC,YAAY,CAAC,KAAK,CAAC,CAAC;IACnC,CAAC,EAAE,CAAC,SAAS,EAAE,UAAU,CAAC,CAAC,CAAC;IAE5B,MAAM,eAAe,GAAG,mBAAmB,CAAC,cAAc,CAAC,CAAC;IAC5D,MAAM,YAAY,GAAG,OAAO,IAAI,gBAAgB,CAAC,cAAc,CAAC,CAAC;IAEjE,MAAM,WAAW,GAAG,QAAQ,CAAC;QAC3B,QAAQ,EAAE,IAAI,CAAC,MAAM,CACnB,QAAQ,EACR,cAAc,EACd,WAAW,EACX,eAAe,EACf,IAAI,CAAC,SAAS,CAAC,eAAe,CAAC,CAChC;QACD,OAAO,EAAE,KAAK,IAA0B,EAAE;YACxC,IAAI,CAAC,YAAY,EAAE,CAAC;gBAClB,OAAO,EAAE,CAAC;YACZ,CAAC;YAED,MAAM,aAAa,GAAG,UAAU,CAAC,EAAE,EAAE,cAAc,CAAC,CAAC;YAErD,yGAAyG;YACzG,MAAM,WAAW,GAAsB;gBACrC,GAAG,eAAe,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,KAAK,CAAC,CAAC,CAAC,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC;gBAC5D,KAAK,CAAC,WAAW,EAAE,IAAI,EAAE,eAAe,CAAC;gBACzC,KAAK,CAAC,WAAW,EAAE,IAAI,EAAE,eAAe,GAAG,QAAQ,CAAC;gBACpD,OAAO,CAAC,WAAW,EAAE,KAAK,CAAC;gBAC3B,cAAc,CAAC,KAAK,CAAC;aACtB,CAAC;YAEF,MAAM,CAAC,GAAG,KAAK,CAAC,aAAa,EAAE,GAAG,WAAW,CAAC,CAAC;YAC/C,MAAM,QAAQ,GAAG,MAAM,OAAO,CAAC,CAAC,CAAC,CAAC;YAElC,OAAO,QAAQ,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,OAAO,EAAE,EAAE;gBACnC,MAAM,OAAO,GAAG,OAAO,CAAC,IAAI,EAAE,CAAC;gBAC/B,MAAM,UAAU,GAAG,EAAE,EAAE,EAAE,OAAO,CAAC,EAAE,EAAE,GAAG,OAAO,EAAE,CAAC;gBAClD,MAAM,IAAI,GAAG,MAAM,CAAC,CAAC,CAAC,MAAM,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,UAAU,CAAC;gBACtD,OAAO,IAAiB,CAAC;YAC3B,CAAC,CAAC,CAAC;QACL,CAAC;QACD,OAAO,EAAE,YAAY;QACrB,SAAS;KACV,CAAC,CAAC;IAEH,MAAM,UAAU,GAAG,mBAAmB,CAAC,SAAS,CAAC,CAAC;IAClD,IAAI,UAAU,KAAK,eAAe;QAAE,OAAO,WAAW,CAAC;IACvD,MAAM,UAAU,GAAG,OAAO,IAAI,gBAAgB,CAAC,SAAS,CAAC,CAAC;IAC1D,OAAO,aAAa,CAAC,WAAW,EAAE,UAAU,CAAC,CAAC;AAChD,CAAC;AAED,4IAA4I;AAC5I,SAAS,aAAa,CAA2C,MAAS,EAAE,SAAkB;IAC5F,MAAM,YAAY,GAA4B;QAC5C,IAAI,EAAE,SAAS;QACf,KAAK,EAAE,IAAI;QACX,OAAO,EAAE,KAAK;QACd,cAAc,EAAE,KAAK;QACrB,cAAc,EAAE,KAAK;QACrB,SAAS,EAAE,KAAK;QAChB,SAAS,EAAE,IAAI;QACf,iBAAiB,EAAE,KAAK;QACxB,SAAS,EAAE,KAAK;QAChB,mBAAmB,EAAE,KAAK;QAC1B,YAAY,EAAE,KAAK;QACnB,SAAS,EAAE,SAAS;QACpB,UAAU,EAAE,SAAS;QACrB,MAAM,EAAE,SAAS;QACjB,WAAW,EAAE,SAAS,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC,MAAM;QAC5C,aAAa,EAAE,CAAC;QAChB,cAAc,EAAE,CAAC;KAClB,CAAC;IACF,MAAM,IAAI,GAAG,EAAO,CAAC;IACrB,KAAK,MAAM,GAAG,IAAI,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,EAAE,CAAC;QACtC,MAAM,CAAC,cAAc,CAAC,IAAI,EAAE,GAAG,EAAE;YAC/B,UAAU,EAAE,IAAI;YAChB,YAAY,EAAE,IAAI;YAClB,GAAG,EAAE,GAAG,IAAI,YAAY,CAAC,CAAC,CAAC,GAAG,EAAE,CAAC,YAAY,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,EAAE,CAAC,MAAM,CAAC,GAAc,CAAC;SAClF,CAAC,CAAC;IACL,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC","sourcesContent":["'use client';\n\nimport { useState, useEffect } from 'react';\nimport { useQuery, type UseQueryResult } from '@tanstack/react-query';\nimport {\n  collection,\n  getDocs,\n  query,\n  where,\n  orderBy,\n  limit as firestoreLimit,\n  type DocumentData,\n  type QueryConstraint,\n} from 'firebase/firestore';\nimport { useFirestoreDb } from '../firestore/context.js';\nimport { keys } from '../../keys.js';\nimport type { FirestoreSearchOptions } from './types.js';\nimport type { WithId } from '../../firestore/types.js';\nimport { isSearchableText, normalizeSearchText } from '../../search/rule.js';\n\nconst DEFAULT_LIMIT = 5;\nconst DEFAULT_DEBOUNCE_MS = 300;\nconst DEFAULT_STALE_TIME = 60 * 1000;\n\nexport function useFirestoreSearch<T extends DocumentData = DocumentData>({\n  collectionPath,\n  searchField,\n  queryText,\n  limit = DEFAULT_LIMIT,\n  enabled = true,\n  select,\n  debounceMs = DEFAULT_DEBOUNCE_MS,\n  staleTime = DEFAULT_STALE_TIME,\n  equalityFilters = [],\n}: FirestoreSearchOptions<T>): UseQueryResult<WithId<T>[], Error> {\n  const db = useFirestoreDb();\n  const [debouncedQuery, setDebouncedQuery] = useState(queryText);\n\n  useEffect(() => {\n    const timer = setTimeout(() => {\n      setDebouncedQuery(queryText);\n    }, debounceMs);\n\n    return () => clearTimeout(timer);\n  }, [queryText, debounceMs]);\n\n  const normalizedQuery = normalizeSearchText(debouncedQuery);\n  const shouldSearch = enabled && isSearchableText(debouncedQuery);\n\n  const searchQuery = useQuery({\n    queryKey: keys.custom(\n      'search',\n      collectionPath,\n      searchField,\n      normalizedQuery,\n      JSON.stringify(equalityFilters),\n    ),\n    queryFn: async (): Promise<WithId<T>[]> => {\n      if (!shouldSearch) {\n        return [];\n      }\n\n      const collectionRef = collection(db, collectionPath);\n\n      // '\\uf8ff' is the highest code point Firestore orders, so the range covers every string with the prefix.\n      const constraints: QueryConstraint[] = [\n        ...equalityFilters.map((f) => where(f.field, '==', f.value)),\n        where(searchField, '>=', normalizedQuery),\n        where(searchField, '<=', normalizedQuery + '\\uf8ff'),\n        orderBy(searchField, 'asc'),\n        firestoreLimit(limit),\n      ];\n\n      const q = query(collectionRef, ...constraints);\n      const snapshot = await getDocs(q);\n\n      return snapshot.docs.map((docSnap) => {\n        const rawData = docSnap.data();\n        const dataWithId = { id: docSnap.id, ...rawData };\n        const data = select ? select(dataWithId) : dataWithId;\n        return data as WithId<T>;\n      });\n    },\n    enabled: shouldSearch,\n    staleTime,\n  });\n\n  const typedQuery = normalizeSearchText(queryText);\n  if (typedQuery === normalizedQuery) return searchQuery;\n  const willSearch = enabled && isSearchableText(queryText);\n  return withoutAnswer(searchQuery, willSearch);\n}\n\n/** Other fields stay getters onto the original result: TanStack re-renders on the fields a component reads, and a spread reads them all. */\nfunction withoutAnswer<R extends UseQueryResult<unknown, Error>>(result: R, searching: boolean): R {\n  const answerFields: Record<string, unknown> = {\n    data: undefined,\n    error: null,\n    isError: false,\n    isLoadingError: false,\n    isRefetchError: false,\n    isSuccess: false,\n    isPending: true,\n    isPlaceholderData: false,\n    isFetched: false,\n    isFetchedAfterMount: false,\n    isRefetching: false,\n    isLoading: searching,\n    isFetching: searching,\n    status: 'pending',\n    fetchStatus: searching ? 'fetching' : 'idle',\n    dataUpdatedAt: 0,\n    errorUpdatedAt: 0,\n  };\n  const view = {} as R;\n  for (const key of Object.keys(result)) {\n    Object.defineProperty(view, key, {\n      enumerable: true,\n      configurable: true,\n      get: key in answerFields ? () => answerFields[key] : () => result[key as keyof R],\n    });\n  }\n  return view;\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;AAsBD;;;;;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";
+'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) 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>(source: ReadRetrySource<TError>, held: HeldFailure<TError> | undefined): 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,50 +1,12 @@
-import type { DocumentData } from 'firebase/firestore';
-/**
- * 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[];
-}
-/**
- * Options for useFirestoreSearch hook
- */
-export interface FirestoreSearchOptions<T extends DocumentData = DocumentData> {
-    /** Firestore collection path to search */
-    collectionPath: string;
-    /** Field name to search on (must be indexed and lowercase) */
-    searchField: string;
-    /** Search query text */
-    queryText: string;
-    /** Maximum number of results (default: 5) */
-    limit?: number;
-    /** Enable/disable the search (default: true) */
-    enabled?: boolean;
-    /** Transform function to convert raw Firestore data to typed result */
-    select?: (data: DocumentData & {
-        id: string;
-    }) => T;
-    /** Debounce delay in milliseconds (default: 300) */
-    debounceMs?: number;
-    /** React Query stale time (default: 60000ms) */
-    staleTime?: number;
-    /** Optional equality filters applied before the prefix range. */
     equalityFilters?: SearchEqualityFilter[];
 }
 //# sourceMappingURL=types.d.ts.map