@ttt-productions/query-core 0.14.21 → 0.14.23

package/dist/react/firestore/use-firestore-live-infinite.d.ts

@@ -1,50 +1,17 @@
 import { type DocumentData } from 'firebase/firestore';
-import type { FirestoreLiveInfiniteOptions, FirestoreSourceState } from '../../firestore/types.js';
+import type { FirestoreSourceState } from '../../firestore/types.js';
+import type { FirestoreLiveInfiniteOptions } from './types.js';
 export interface FirestoreLiveInfiniteResult<T> {
-    /** The current subscription identity's rows — live set plus loaded older pages, ordered per `sort`. */
     items: T[];
-    /** True until the current identity's first snapshot arrives, unless its listener has failed. */
     isInitialLoading: boolean;
-    /** Liveness of the current identity's listener; `connecting` from that identity's first render. */
     sourceState: FirestoreSourceState;
-    /** The listener's failure for the current identity; `null` while connecting, live, or offline. */
     error: Error | null;
-    /** Load the next older page; nothing older is read until this is called. Never rejects — a failed read lands in `olderError`. */
     fetchOlder: () => Promise<void>;
-    /** Whether older rows exist that are not loaded yet (a one-doc look-ahead, never a full-page guess). */
     hasOlder: boolean;
-    /** Whether an older page is being read (including a `retry` of one). */
     isFetchingOlder: boolean;
-    /** The last older-page read failed; `null` once an older read succeeds. */
     olderError: Error | null;
-    /** Re-run what failed: resubscribe a failed listener, re-read a failed older page. */
     retry: () => void;
 }
-/**
- * A live list (newest rows realtime) with older rows paged in on request, merged into
- * one ordered list.
- *
- * Until the first server-confirmed snapshot that has rows, the listener reads the newest
- * `pageSize` rows plus one look-ahead row. That snapshot fixes an anchor — the oldest row
- * of the window — and from then on the listener covers anchor → newest with no limit, so
- * it grows only with rows that arrive while the list is open, and every older page starts
- * after the anchor. Nothing can fall between the live set and the older pages, however
- * many rows arrive. Older pages carry the same one-row look-ahead, so `hasOlder` is false
- * exactly when nothing older exists. No older page is read until `fetchOlder` asks for one.
- *
- * Both reads arrive newest first and meet at the anchor, so the merged list is their
- * concatenation: a snapshot never re-sorts the rows already loaded.
- *
- * Everything read is tagged to its subscription identity (path, key, ordering,
- * constraints, page size, enabled): a new identity renders empty and connecting in its
- * first render, and a retired identity's late callback or older page never lands.
- *
- * A `permission-denied` listener error resubscribes on the `RESUBSCRIBE_DELAYS_MS` ladder
- * before surfacing; any other listener error surfaces at once. Rows already shown are
- * kept beside the error — except beside a surfaced `permission-denied`: the reader lost
- * access, so the live rows, the anchor, and the loaded older pages are all dropped, and a
- * retry reads the list afresh. `db` comes from `<FirestoreProvider>`.
- */
 export declare function useFirestoreLiveInfinite<T = DocumentData & {
     id: string;
 }>({ collectionPath, queryKey, orderByField, constraints, pageSize: requestedPageSize, enabled, select, sort, }: FirestoreLiveInfiniteOptions<T>): FirestoreLiveInfiniteResult<T>;

package/dist/react/firestore/use-firestore-live-infinite.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"use-firestore-live-infinite.d.ts","sourceRoot":"","sources":["../../../src/react/firestore/use-firestore-live-infinite.ts"],"names":[],"mappings":"AAIA,OAAO,EASL,KAAK,YAAY,EAElB,MAAM,oBAAoB,CAAC;AAG5B,OAAO,KAAK,EAAE,4BAA4B,EAAE,oBAAoB,EAAE,MAAM,0BAA0B,CAAC;AAInG,MAAM,WAAW,2BAA2B,CAAC,CAAC;IAC5C,uGAAuG;IACvG,KAAK,EAAE,CAAC,EAAE,CAAC;IACX,gGAAgG;IAChG,gBAAgB,EAAE,OAAO,CAAC;IAC1B,mGAAmG;IACnG,WAAW,EAAE,oBAAoB,CAAC;IAClC,kGAAkG;IAClG,KAAK,EAAE,KAAK,GAAG,IAAI,CAAC;IACpB,iIAAiI;IACjI,UAAU,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;IAChC,wGAAwG;IACxG,QAAQ,EAAE,OAAO,CAAC;IAClB,wEAAwE;IACxE,eAAe,EAAE,OAAO,CAAC;IACzB,2EAA2E;IAC3E,UAAU,EAAE,KAAK,GAAG,IAAI,CAAC;IACzB,sFAAsF;IACtF,KAAK,EAAE,MAAM,IAAI,CAAC;CACnB;AA2BD;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AACH,wBAAgB,wBAAwB,CAAC,CAAC,GAAG,YAAY,GAAG;IAAE,EAAE,EAAE,MAAM,CAAA;CAAE,EAAE,EAC1E,cAAc,EACd,QAAQ,EACR,YAAY,EACZ,WAAgB,EAChB,QAAQ,EAAE,iBAAsB,EAChC,OAAc,EACd,MAAM,EACN,IAAY,GACb,EAAE,4BAA4B,CAAC,CAAC,CAAC,GAAG,2BAA2B,CAAC,CAAC,CAAC,CA4PlE"}
+{"version":3,"file":"use-firestore-live-infinite.d.ts","sourceRoot":"","sources":["../../../src/react/firestore/use-firestore-live-infinite.ts"],"names":[],"mappings":"AAIA,OAAO,EASL,KAAK,YAAY,EAElB,MAAM,oBAAoB,CAAC;AAG5B,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,0BAA0B,CAAC;AACrE,OAAO,KAAK,EAAE,4BAA4B,EAAE,MAAM,YAAY,CAAC;AAI/D,MAAM,WAAW,2BAA2B,CAAC,CAAC;IAC5C,KAAK,EAAE,CAAC,EAAE,CAAC;IACX,gBAAgB,EAAE,OAAO,CAAC;IAC1B,WAAW,EAAE,oBAAoB,CAAC;IAClC,KAAK,EAAE,KAAK,GAAG,IAAI,CAAC;IACpB,UAAU,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;IAChC,QAAQ,EAAE,OAAO,CAAC;IAClB,eAAe,EAAE,OAAO,CAAC;IACzB,UAAU,EAAE,KAAK,GAAG,IAAI,CAAC;IACzB,KAAK,EAAE,MAAM,IAAI,CAAC;CACnB;AA2BD,wBAAgB,wBAAwB,CAAC,CAAC,GAAG,YAAY,GAAG;IAAE,EAAE,EAAE,MAAM,CAAA;CAAE,EAAE,EAC1E,cAAc,EACd,QAAQ,EACR,YAAY,EACZ,WAAgB,EAChB,QAAQ,EAAE,iBAAsB,EAChC,OAAc,EACd,MAAM,EACN,IAAY,GACb,EAAE,4BAA4B,CAAC,CAAC,CAAC,GAAG,2BAA2B,CAAC,CAAC,CAAC,CA8PlE"}

package/dist/react/firestore/use-firestore-live-infinite.js

@@ -16,36 +16,10 @@ function freshWindow(identity) {
         error: null,
     };
 }
-/**
- * A live list (newest rows realtime) with older rows paged in on request, merged into
- * one ordered list.
- *
- * Until the first server-confirmed snapshot that has rows, the listener reads the newest
- * `pageSize` rows plus one look-ahead row. That snapshot fixes an anchor — the oldest row
- * of the window — and from then on the listener covers anchor → newest with no limit, so
- * it grows only with rows that arrive while the list is open, and every older page starts
- * after the anchor. Nothing can fall between the live set and the older pages, however
- * many rows arrive. Older pages carry the same one-row look-ahead, so `hasOlder` is false
- * exactly when nothing older exists. No older page is read until `fetchOlder` asks for one.
- *
- * Both reads arrive newest first and meet at the anchor, so the merged list is their
- * concatenation: a snapshot never re-sorts the rows already loaded.
- *
- * Everything read is tagged to its subscription identity (path, key, ordering,
- * constraints, page size, enabled): a new identity renders empty and connecting in its
- * first render, and a retired identity's late callback or older page never lands.
- *
- * A `permission-denied` listener error resubscribes on the `RESUBSCRIBE_DELAYS_MS` ladder
- * before surfacing; any other listener error surfaces at once. Rows already shown are
- * kept beside the error — except beside a surfaced `permission-denied`: the reader lost
- * access, so the live rows, the anchor, and the loaded older pages are all dropped, and a
- * retry reads the list afresh. `db` comes from `<FirestoreProvider>`.
- */
 export function useFirestoreLiveInfinite({ collectionPath, queryKey, orderByField, constraints = [], pageSize: requestedPageSize = 20, enabled = true, select, sort = 'asc', }) {
     const db = useFirestoreDb();
     const queryClient = useQueryClient();
     const pageSize = Math.min(requestedPageSize, MAX_PAGE_SIZE);
-    // Latest-callback ref: an inline select must not re-subscribe the listener on every render.
     const selectRef = React.useRef(select);
     selectRef.current = select;
     const toEntry = React.useCallback((snap) => {
@@ -53,7 +27,6 @@ export function useFirestoreLiveInfinite({ collectionPath, queryKey, orderByFiel
         const item = selectRef.current ? selectRef.current(dataWithId) : dataWithId;
         return { docId: snap.id, item };
     }, []);
-    // Constraint objects are fresh every render; their serialized form is the identity.
     const queryKeyMemo = JSON.stringify(queryKey);
     const constraintsMemo = JSON.stringify(constraints);
     const identity = JSON.stringify([
@@ -71,11 +44,9 @@ export function useFirestoreLiveInfinite({ collectionPath, queryKey, orderByFiel
     const current = windowState.identity === identity ? windowState : freshWindow(identity);
     React.useEffect(() => {
         if (!enabled) {
-            // Retire the enabled identity's rows, so re-enabling starts afresh rather than resuming.
             setWindowState(freshWindow(identity));
             return;
         }
-        // A retry of the same identity resumes from its anchor and keeps its rows.
         const prior = windowRef.current;
         const resumed = prior.identity === identity;
         setWindowState((prev) => prev.identity === identity
@@ -178,13 +149,10 @@ export function useFirestoreLiveInfinite({ collectionPath, queryKey, orderByFiel
                 clearTimeout(retryTimer);
             unsubscribe?.();
         };
-        // `identity` carries collectionPath, queryKey, orderByField, constraints, pageSize, and
-        // enabled; constraints are read from the render that produced it.
-        // eslint-disable-next-line react-hooks/exhaustive-deps
+        // eslint-disable-next-line react-hooks/exhaustive-deps -- identity carries every read input; constraints are read from the render that produced it
     }, [db, identity, retryNonce, toEntry, queryClient]);
     const anchor = enabled ? current.anchor : null;
     const olderEnabled = anchor !== null && current.olderExists;
-    // Never fetched on its own: `fetchOlder` reads the first page (`refetch`) and each one after it.
     const older = useInfiniteQuery({
         queryKey: [...queryKey, 'older', identity, anchor?.id ?? null],
         enabled: false,
@@ -232,13 +200,19 @@ export function useFirestoreLiveInfinite({ collectionPath, queryKey, orderByFiel
             else
                 void refetchOlder();
         }
-    }, [listenerFailed, identity, olderError, olderFetching, olderPages, fetchNextPage, refetchOlder]);
+    }, [
+        listenerFailed,
+        identity,
+        olderError,
+        olderFetching,
+        olderPages,
+        fetchNextPage,
+        refetchOlder,
+    ]);
     const olderEntries = React.useMemo(() => (olderPages ?? []).flatMap((p) => p.entries), [olderPages]);
     const items = React.useMemo(() => {
         if (!enabled)
             return [];
-        // A row edited so its ordering value moved into the live range is in both reads; its live
-        // copy is the fresh one.
         const liveIds = new Set(current.entries.map((entry) => entry.docId));
         const newestFirst = [
             ...current.entries.map((entry) => entry.item),

package/dist/react/firestore/use-firestore-live-infinite.js.map

@@ -1 +1 @@
-{"version":3,"file":"use-firestore-live-infinite.js","sourceRoot":"","sources":["../../../src/react/firestore/use-firestore-live-infinite.ts"],"names":[],"mappings":"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","sourcesContent":["'use client';\n\nimport * as React from 'react';\nimport { useInfiniteQuery, useQueryClient } from '@tanstack/react-query';\nimport {\n  collection,\n  query,\n  orderBy,\n  limit,\n  startAfter,\n  endAt,\n  getDocs,\n  onSnapshot,\n  type DocumentData,\n  type QueryDocumentSnapshot,\n} from 'firebase/firestore';\nimport { useFirestoreDb } from './context.js';\nimport { RESUBSCRIBE_DELAYS_MS, isPermissionDeniedError } from './resubscribe.js';\nimport type { FirestoreLiveInfiniteOptions, FirestoreSourceState } from '../../firestore/types.js';\n\nconst MAX_PAGE_SIZE = 100;\n\nexport interface FirestoreLiveInfiniteResult<T> {\n  /** The current subscription identity's rows — live set plus loaded older pages, ordered per `sort`. */\n  items: T[];\n  /** True until the current identity's first snapshot arrives, unless its listener has failed. */\n  isInitialLoading: boolean;\n  /** Liveness of the current identity's listener; `connecting` from that identity's first render. */\n  sourceState: FirestoreSourceState;\n  /** The listener's failure for the current identity; `null` while connecting, live, or offline. */\n  error: Error | null;\n  /** Load the next older page; nothing older is read until this is called. Never rejects — a failed read lands in `olderError`. */\n  fetchOlder: () => Promise<void>;\n  /** Whether older rows exist that are not loaded yet (a one-doc look-ahead, never a full-page guess). */\n  hasOlder: boolean;\n  /** Whether an older page is being read (including a `retry` of one). */\n  isFetchingOlder: boolean;\n  /** The last older-page read failed; `null` once an older read succeeds. */\n  olderError: Error | null;\n  /** Re-run what failed: resubscribe a failed listener, re-read a failed older page. */\n  retry: () => void;\n}\n\ntype Entry<T> = { docId: string; item: T };\ntype Snap = QueryDocumentSnapshot<DocumentData>;\n\ninterface WindowState<T> {\n  identity: string;\n  ready: boolean;\n  entries: Entry<T>[];\n  anchor: Snap | null;\n  olderExists: boolean;\n  sourceState: FirestoreSourceState;\n  error: Error | null;\n}\n\nfunction freshWindow<T>(identity: string): WindowState<T> {\n  return {\n    identity,\n    ready: false,\n    entries: [],\n    anchor: null,\n    olderExists: false,\n    sourceState: 'connecting',\n    error: null,\n  };\n}\n\n/**\n * A live list (newest rows realtime) with older rows paged in on request, merged into\n * one ordered list.\n *\n * Until the first server-confirmed snapshot that has rows, the listener reads the newest\n * `pageSize` rows plus one look-ahead row. That snapshot fixes an anchor — the oldest row\n * of the window — and from then on the listener covers anchor → newest with no limit, so\n * it grows only with rows that arrive while the list is open, and every older page starts\n * after the anchor. Nothing can fall between the live set and the older pages, however\n * many rows arrive. Older pages carry the same one-row look-ahead, so `hasOlder` is false\n * exactly when nothing older exists. No older page is read until `fetchOlder` asks for one.\n *\n * Both reads arrive newest first and meet at the anchor, so the merged list is their\n * concatenation: a snapshot never re-sorts the rows already loaded.\n *\n * Everything read is tagged to its subscription identity (path, key, ordering,\n * constraints, page size, enabled): a new identity renders empty and connecting in its\n * first render, and a retired identity's late callback or older page never lands.\n *\n * A `permission-denied` listener error resubscribes on the `RESUBSCRIBE_DELAYS_MS` ladder\n * before surfacing; any other listener error surfaces at once. Rows already shown are\n * kept beside the error — except beside a surfaced `permission-denied`: the reader lost\n * access, so the live rows, the anchor, and the loaded older pages are all dropped, and a\n * retry reads the list afresh. `db` comes from `<FirestoreProvider>`.\n */\nexport function useFirestoreLiveInfinite<T = DocumentData & { id: string }>({\n  collectionPath,\n  queryKey,\n  orderByField,\n  constraints = [],\n  pageSize: requestedPageSize = 20,\n  enabled = true,\n  select,\n  sort = 'asc',\n}: FirestoreLiveInfiniteOptions<T>): FirestoreLiveInfiniteResult<T> {\n  const db = useFirestoreDb();\n  const queryClient = useQueryClient();\n  const pageSize = Math.min(requestedPageSize, MAX_PAGE_SIZE);\n\n  // Latest-callback ref: an inline select must not re-subscribe the listener on every render.\n  const selectRef = React.useRef(select);\n  selectRef.current = select;\n\n  const toEntry = React.useCallback((snap: Snap): Entry<T> => {\n    const dataWithId: DocumentData & { id: string } = { id: snap.id, ...snap.data() };\n    const item = selectRef.current ? selectRef.current(dataWithId) : (dataWithId as unknown as T);\n    return { docId: snap.id, item };\n  }, []);\n\n  // Constraint objects are fresh every render; their serialized form is the identity.\n  const queryKeyMemo = JSON.stringify(queryKey);\n  const constraintsMemo = JSON.stringify(constraints);\n  const identity = JSON.stringify([\n    collectionPath,\n    queryKeyMemo,\n    orderByField,\n    constraintsMemo,\n    pageSize,\n    enabled,\n  ]);\n\n  const [windowState, setWindowState] = React.useState<WindowState<T>>(() => freshWindow(identity));\n  const windowRef = React.useRef(windowState);\n  windowRef.current = windowState;\n  const [retryNonce, setRetryNonce] = React.useState(0);\n\n  const current: WindowState<T> =\n    windowState.identity === identity ? windowState : freshWindow<T>(identity);\n\n  React.useEffect(() => {\n    if (!enabled) {\n      // Retire the enabled identity's rows, so re-enabling starts afresh rather than resuming.\n      setWindowState(freshWindow<T>(identity));\n      return;\n    }\n\n    // A retry of the same identity resumes from its anchor and keeps its rows.\n    const prior = windowRef.current;\n    const resumed = prior.identity === identity;\n    setWindowState((prev) =>\n      prev.identity === identity\n        ? { ...prev, error: null, sourceState: 'connecting' }\n        : freshWindow<T>(identity),\n    );\n\n    let disposed = false;\n    let unsubscribe: (() => void) | null = null;\n    let retryTimer: ReturnType<typeof setTimeout> | null = null;\n    let attempt = 0;\n    let currentAnchor: Snap | null = resumed ? prior.anchor : null;\n\n    const update = (fn: (prev: WindowState<T>) => WindowState<T>) => {\n      if (disposed) return;\n      setWindowState((prev) => (prev.identity === identity ? fn(prev) : prev));\n    };\n\n    const listen = (anchor: Snap | null) => {\n      if (disposed) return;\n      currentAnchor = anchor;\n      const colRef = collection(db, collectionPath);\n      const q = anchor\n        ? query(colRef, ...constraints, orderBy(orderByField, 'desc'), endAt(anchor))\n        : query(colRef, ...constraints, orderBy(orderByField, 'desc'), limit(pageSize + 1));\n      let serverConfirmed = false;\n\n      unsubscribe = onSnapshot(\n        q,\n        { includeMetadataChanges: true },\n        (snap) => {\n          if (disposed) return;\n          attempt = 0;\n          const docs = snap.docs as Snap[];\n          const fromCache = snap.metadata?.fromCache ?? false;\n          const nextSource = (prev: FirestoreSourceState): FirestoreSourceState => {\n            if (!fromCache) return 'live';\n            if (!serverConfirmed) return prev === 'error' ? 'connecting' : prev;\n            return 'offline';\n          };\n          if (!fromCache) serverConfirmed = true;\n\n          if (anchor) {\n            update((prev) => ({\n              ...prev,\n              ready: true,\n              entries: docs.map(toEntry),\n              sourceState: nextSource(prev.sourceState),\n              error: null,\n            }));\n            return;\n          }\n\n          const windowDocs = docs.slice(0, pageSize);\n          if (fromCache || windowDocs.length === 0) {\n            update((prev) => ({\n              ...prev,\n              ready: true,\n              entries: windowDocs.map(toEntry),\n              sourceState: nextSource(prev.sourceState),\n              error: null,\n            }));\n            return;\n          }\n\n          const newAnchor = windowDocs[windowDocs.length - 1];\n          update((prev) => ({\n            ...prev,\n            ready: true,\n            entries: windowDocs.map(toEntry),\n            anchor: newAnchor,\n            olderExists: docs.length > pageSize,\n            sourceState: 'live',\n            error: null,\n          }));\n          unsubscribe?.();\n          unsubscribe = null;\n          listen(newAnchor);\n        },\n        (error) => {\n          if (disposed) return;\n          unsubscribe?.();\n          unsubscribe = null;\n          if (isPermissionDeniedError(error) && attempt < RESUBSCRIBE_DELAYS_MS.length) {\n            const delay = RESUBSCRIBE_DELAYS_MS[attempt];\n            attempt += 1;\n            update((prev) => ({ ...prev, sourceState: 'connecting' }));\n            retryTimer = setTimeout(() => listen(currentAnchor), delay);\n            return;\n          }\n          console.error('[useFirestoreLiveInfinite] Subscription error:', error);\n          if (isPermissionDeniedError(error)) {\n            currentAnchor = null;\n            queryClient.removeQueries({ queryKey: [...queryKey, 'older', identity] });\n            update(() => ({ ...freshWindow<T>(identity), sourceState: 'error', error }));\n            return;\n          }\n          update((prev) => ({ ...prev, sourceState: 'error', error }));\n        },\n      );\n    };\n\n    listen(currentAnchor);\n\n    return () => {\n      disposed = true;\n      if (retryTimer) clearTimeout(retryTimer);\n      unsubscribe?.();\n    };\n    // `identity` carries collectionPath, queryKey, orderByField, constraints, pageSize, and\n    // enabled; constraints are read from the render that produced it.\n    // eslint-disable-next-line react-hooks/exhaustive-deps\n  }, [db, identity, retryNonce, toEntry, queryClient]);\n\n  const anchor = enabled ? current.anchor : null;\n  const olderEnabled = anchor !== null && current.olderExists;\n\n  // Never fetched on its own: `fetchOlder` reads the first page (`refetch`) and each one after it.\n  const older = useInfiniteQuery({\n    queryKey: [...queryKey, 'older', identity, anchor?.id ?? null],\n    enabled: false,\n    initialPageParam: undefined as Snap | undefined,\n    queryFn: async ({ pageParam }) => {\n      const cursor = pageParam ?? anchor;\n      if (!cursor) {\n        return { entries: [] as Entry<T>[], nextCursor: undefined as Snap | undefined };\n      }\n      const colRef = collection(db, collectionPath);\n      const q = query(\n        colRef,\n        ...constraints,\n        orderBy(orderByField, 'desc'),\n        startAfter(cursor),\n        limit(pageSize + 1),\n      );\n      const snap = await getDocs(q);\n      const docs = snap.docs as Snap[];\n      const page = docs.slice(0, pageSize);\n      return {\n        entries: page.map(toEntry),\n        nextCursor: docs.length > pageSize ? page[page.length - 1] : undefined,\n      };\n    },\n    getNextPageParam: (last) => last.nextCursor,\n  });\n\n  const {\n    data: olderData,\n    isFetching: olderFetching,\n    isError: olderIsError,\n    error: olderErr,\n    hasNextPage: olderHasNext,\n    fetchNextPage,\n    refetch: refetchOlder,\n  } = older;\n\n  const olderPages = olderEnabled ? olderData?.pages : undefined;\n  const hasOlder = olderEnabled && (olderPages ? Boolean(olderHasNext) : true);\n  const olderError = olderEnabled && olderIsError ? olderErr : null;\n\n  const fetchOlder = React.useCallback(async () => {\n    if (!olderEnabled || olderFetching) return;\n    if (!olderPages) {\n      await refetchOlder();\n      return;\n    }\n    if (olderHasNext) await fetchNextPage();\n  }, [olderEnabled, olderFetching, olderPages, olderHasNext, refetchOlder, fetchNextPage]);\n\n  const listenerFailed = enabled && current.error !== null;\n  const retry = React.useCallback(() => {\n    if (listenerFailed) {\n      setWindowState((prev) =>\n        prev.identity === identity ? { ...prev, error: null, sourceState: 'connecting' } : prev,\n      );\n      setRetryNonce((n) => n + 1);\n    }\n    if (olderError && !olderFetching) {\n      if (olderPages) void fetchNextPage();\n      else void refetchOlder();\n    }\n  }, [listenerFailed, identity, olderError, olderFetching, olderPages, fetchNextPage, refetchOlder]);\n\n  const olderEntries = React.useMemo(() => (olderPages ?? []).flatMap((p) => p.entries), [olderPages]);\n\n  const items = React.useMemo(() => {\n    if (!enabled) return [];\n    // A row edited so its ordering value moved into the live range is in both reads; its live\n    // copy is the fresh one.\n    const liveIds = new Set(current.entries.map((entry) => entry.docId));\n    const newestFirst = [\n      ...current.entries.map((entry) => entry.item),\n      ...olderEntries.filter((entry) => !liveIds.has(entry.docId)).map((entry) => entry.item),\n    ];\n    return sort === 'desc' ? newestFirst : newestFirst.reverse();\n  }, [enabled, olderEntries, current.entries, sort]);\n\n  return {\n    items,\n    isInitialLoading: enabled ? !current.ready && current.error === null : false,\n    sourceState: current.sourceState,\n    error: enabled ? current.error : null,\n    fetchOlder,\n    hasOlder,\n    isFetchingOlder: olderEnabled && olderFetching,\n    olderError,\n    retry,\n  };\n}\n"]}
+{"version":3,"file":"use-firestore-live-infinite.js","sourceRoot":"","sources":["../../../src/react/firestore/use-firestore-live-infinite.ts"],"names":[],"mappings":"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","sourcesContent":["'use client';\n\nimport * as React from 'react';\nimport { useInfiniteQuery, useQueryClient } from '@tanstack/react-query';\nimport {\n  collection,\n  query,\n  orderBy,\n  limit,\n  startAfter,\n  endAt,\n  getDocs,\n  onSnapshot,\n  type DocumentData,\n  type QueryDocumentSnapshot,\n} from 'firebase/firestore';\nimport { useFirestoreDb } from './context.js';\nimport { RESUBSCRIBE_DELAYS_MS, isPermissionDeniedError } from './resubscribe.js';\nimport type { FirestoreSourceState } from '../../firestore/types.js';\nimport type { FirestoreLiveInfiniteOptions } from './types.js';\n\nconst MAX_PAGE_SIZE = 100;\n\nexport interface FirestoreLiveInfiniteResult<T> {\n  items: T[];\n  isInitialLoading: boolean;\n  sourceState: FirestoreSourceState;\n  error: Error | null;\n  fetchOlder: () => Promise<void>;\n  hasOlder: boolean;\n  isFetchingOlder: boolean;\n  olderError: Error | null;\n  retry: () => void;\n}\n\ntype Entry<T> = { docId: string; item: T };\ntype Snap = QueryDocumentSnapshot<DocumentData>;\n\ninterface WindowState<T> {\n  identity: string;\n  ready: boolean;\n  entries: Entry<T>[];\n  anchor: Snap | null;\n  olderExists: boolean;\n  sourceState: FirestoreSourceState;\n  error: Error | null;\n}\n\nfunction freshWindow<T>(identity: string): WindowState<T> {\n  return {\n    identity,\n    ready: false,\n    entries: [],\n    anchor: null,\n    olderExists: false,\n    sourceState: 'connecting',\n    error: null,\n  };\n}\n\nexport function useFirestoreLiveInfinite<T = DocumentData & { id: string }>({\n  collectionPath,\n  queryKey,\n  orderByField,\n  constraints = [],\n  pageSize: requestedPageSize = 20,\n  enabled = true,\n  select,\n  sort = 'asc',\n}: FirestoreLiveInfiniteOptions<T>): FirestoreLiveInfiniteResult<T> {\n  const db = useFirestoreDb();\n  const queryClient = useQueryClient();\n  const pageSize = Math.min(requestedPageSize, MAX_PAGE_SIZE);\n\n  const selectRef = React.useRef(select);\n  selectRef.current = select;\n\n  const toEntry = React.useCallback((snap: Snap): Entry<T> => {\n    const dataWithId: DocumentData & { id: string } = { id: snap.id, ...snap.data() };\n    const item = selectRef.current ? selectRef.current(dataWithId) : (dataWithId as unknown as T);\n    return { docId: snap.id, item };\n  }, []);\n\n  const queryKeyMemo = JSON.stringify(queryKey);\n  const constraintsMemo = JSON.stringify(constraints);\n  const identity = JSON.stringify([\n    collectionPath,\n    queryKeyMemo,\n    orderByField,\n    constraintsMemo,\n    pageSize,\n    enabled,\n  ]);\n\n  const [windowState, setWindowState] = React.useState<WindowState<T>>(() => freshWindow(identity));\n  const windowRef = React.useRef(windowState);\n  windowRef.current = windowState;\n  const [retryNonce, setRetryNonce] = React.useState(0);\n\n  const current: WindowState<T> =\n    windowState.identity === identity ? windowState : freshWindow<T>(identity);\n\n  React.useEffect(() => {\n    if (!enabled) {\n      setWindowState(freshWindow<T>(identity));\n      return;\n    }\n\n    const prior = windowRef.current;\n    const resumed = prior.identity === identity;\n    setWindowState((prev) =>\n      prev.identity === identity\n        ? { ...prev, error: null, sourceState: 'connecting' }\n        : freshWindow<T>(identity),\n    );\n\n    let disposed = false;\n    let unsubscribe: (() => void) | null = null;\n    let retryTimer: ReturnType<typeof setTimeout> | null = null;\n    let attempt = 0;\n    let currentAnchor: Snap | null = resumed ? prior.anchor : null;\n\n    const update = (fn: (prev: WindowState<T>) => WindowState<T>) => {\n      if (disposed) return;\n      setWindowState((prev) => (prev.identity === identity ? fn(prev) : prev));\n    };\n\n    const listen = (anchor: Snap | null) => {\n      if (disposed) return;\n      currentAnchor = anchor;\n      const colRef = collection(db, collectionPath);\n      const q = anchor\n        ? query(colRef, ...constraints, orderBy(orderByField, 'desc'), endAt(anchor))\n        : query(colRef, ...constraints, orderBy(orderByField, 'desc'), limit(pageSize + 1));\n      let serverConfirmed = false;\n\n      unsubscribe = onSnapshot(\n        q,\n        { includeMetadataChanges: true },\n        (snap) => {\n          if (disposed) return;\n          attempt = 0;\n          const docs = snap.docs as Snap[];\n          const fromCache = snap.metadata?.fromCache ?? false;\n          const nextSource = (prev: FirestoreSourceState): FirestoreSourceState => {\n            if (!fromCache) return 'live';\n            if (!serverConfirmed) return prev === 'error' ? 'connecting' : prev;\n            return 'offline';\n          };\n          if (!fromCache) serverConfirmed = true;\n\n          if (anchor) {\n            update((prev) => ({\n              ...prev,\n              ready: true,\n              entries: docs.map(toEntry),\n              sourceState: nextSource(prev.sourceState),\n              error: null,\n            }));\n            return;\n          }\n\n          const windowDocs = docs.slice(0, pageSize);\n          if (fromCache || windowDocs.length === 0) {\n            update((prev) => ({\n              ...prev,\n              ready: true,\n              entries: windowDocs.map(toEntry),\n              sourceState: nextSource(prev.sourceState),\n              error: null,\n            }));\n            return;\n          }\n\n          const newAnchor = windowDocs[windowDocs.length - 1];\n          update((prev) => ({\n            ...prev,\n            ready: true,\n            entries: windowDocs.map(toEntry),\n            anchor: newAnchor,\n            olderExists: docs.length > pageSize,\n            sourceState: 'live',\n            error: null,\n          }));\n          unsubscribe?.();\n          unsubscribe = null;\n          listen(newAnchor);\n        },\n        (error) => {\n          if (disposed) return;\n          unsubscribe?.();\n          unsubscribe = null;\n          if (isPermissionDeniedError(error) && attempt < RESUBSCRIBE_DELAYS_MS.length) {\n            const delay = RESUBSCRIBE_DELAYS_MS[attempt];\n            attempt += 1;\n            update((prev) => ({ ...prev, sourceState: 'connecting' }));\n            retryTimer = setTimeout(() => listen(currentAnchor), delay);\n            return;\n          }\n          console.error('[useFirestoreLiveInfinite] Subscription error:', error);\n          if (isPermissionDeniedError(error)) {\n            currentAnchor = null;\n            queryClient.removeQueries({ queryKey: [...queryKey, 'older', identity] });\n            update(() => ({ ...freshWindow<T>(identity), sourceState: 'error', error }));\n            return;\n          }\n          update((prev) => ({ ...prev, sourceState: 'error', error }));\n        },\n      );\n    };\n\n    listen(currentAnchor);\n\n    return () => {\n      disposed = true;\n      if (retryTimer) clearTimeout(retryTimer);\n      unsubscribe?.();\n    };\n    // eslint-disable-next-line react-hooks/exhaustive-deps -- identity carries every read input; constraints are read from the render that produced it\n  }, [db, identity, retryNonce, toEntry, queryClient]);\n\n  const anchor = enabled ? current.anchor : null;\n  const olderEnabled = anchor !== null && current.olderExists;\n\n  const older = useInfiniteQuery({\n    queryKey: [...queryKey, 'older', identity, anchor?.id ?? null],\n    enabled: false,\n    initialPageParam: undefined as Snap | undefined,\n    queryFn: async ({ pageParam }) => {\n      const cursor = pageParam ?? anchor;\n      if (!cursor) {\n        return { entries: [] as Entry<T>[], nextCursor: undefined as Snap | undefined };\n      }\n      const colRef = collection(db, collectionPath);\n      const q = query(\n        colRef,\n        ...constraints,\n        orderBy(orderByField, 'desc'),\n        startAfter(cursor),\n        limit(pageSize + 1),\n      );\n      const snap = await getDocs(q);\n      const docs = snap.docs as Snap[];\n      const page = docs.slice(0, pageSize);\n      return {\n        entries: page.map(toEntry),\n        nextCursor: docs.length > pageSize ? page[page.length - 1] : undefined,\n      };\n    },\n    getNextPageParam: (last) => last.nextCursor,\n  });\n\n  const {\n    data: olderData,\n    isFetching: olderFetching,\n    isError: olderIsError,\n    error: olderErr,\n    hasNextPage: olderHasNext,\n    fetchNextPage,\n    refetch: refetchOlder,\n  } = older;\n\n  const olderPages = olderEnabled ? olderData?.pages : undefined;\n  const hasOlder = olderEnabled && (olderPages ? Boolean(olderHasNext) : true);\n  const olderError = olderEnabled && olderIsError ? olderErr : null;\n\n  const fetchOlder = React.useCallback(async () => {\n    if (!olderEnabled || olderFetching) return;\n    if (!olderPages) {\n      await refetchOlder();\n      return;\n    }\n    if (olderHasNext) await fetchNextPage();\n  }, [olderEnabled, olderFetching, olderPages, olderHasNext, refetchOlder, fetchNextPage]);\n\n  const listenerFailed = enabled && current.error !== null;\n  const retry = React.useCallback(() => {\n    if (listenerFailed) {\n      setWindowState((prev) =>\n        prev.identity === identity ? { ...prev, error: null, sourceState: 'connecting' } : prev,\n      );\n      setRetryNonce((n) => n + 1);\n    }\n    if (olderError && !olderFetching) {\n      if (olderPages) void fetchNextPage();\n      else void refetchOlder();\n    }\n  }, [\n    listenerFailed,\n    identity,\n    olderError,\n    olderFetching,\n    olderPages,\n    fetchNextPage,\n    refetchOlder,\n  ]);\n\n  const olderEntries = React.useMemo(\n    () => (olderPages ?? []).flatMap((p) => p.entries),\n    [olderPages],\n  );\n\n  const items = React.useMemo(() => {\n    if (!enabled) return [];\n    const liveIds = new Set(current.entries.map((entry) => entry.docId));\n    const newestFirst = [\n      ...current.entries.map((entry) => entry.item),\n      ...olderEntries.filter((entry) => !liveIds.has(entry.docId)).map((entry) => entry.item),\n    ];\n    return sort === 'desc' ? newestFirst : newestFirst.reverse();\n  }, [enabled, olderEntries, current.entries, sort]);\n\n  return {\n    items,\n    isInitialLoading: enabled ? !current.ready && current.error === null : false,\n    sourceState: current.sourceState,\n    error: enabled ? current.error : null,\n    fetchOlder,\n    hasOlder,\n    isFetchingOlder: olderEnabled && olderFetching,\n    olderError,\n    retry,\n  };\n}\n"]}

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

@@ -1,6 +1,7 @@
 import { type QueryKey, type UseMutationResult } from '@tanstack/react-query';
 import { type DocumentData } from 'firebase/firestore';
-import type { FirestoreMutationOptions, FirestoreBatchOptions, MutationOperation } from '../../firestore/types.js';
+import type { FirestoreMutationOptions, FirestoreBatchOptions } from '../../firestore/types.js';
+import type { MutationOperation } from './types.js';
 interface SetResult<T> {
     id: string;
     data: T;

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

@@ -1 +1 @@
-{"version":3,"file":"use-firestore-mutations.d.ts","sourceRoot":"","sources":["../../../src/react/firestore/use-firestore-mutations.ts"],"names":[],"mappings":"AAEA,OAAO,EAA+B,KAAK,QAAQ,EAAE,KAAK,iBAAiB,EAAE,MAAM,uBAAuB,CAAC;AAC3G,OAAO,EAML,KAAK,YAAY,EAClB,MAAM,oBAAoB,CAAC;AAE5B,OAAO,KAAK,EAAE,wBAAwB,EAAE,qBAAqB,EAAE,iBAAiB,EAAE,MAAM,0BAA0B,CAAC;AAInH,UAAU,SAAS,CAAC,CAAC;IACnB,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,CAAC,CAAC;CACT;AAED,wBAAgB,eAAe,CAAC,CAAC,SAAS,YAAY,EAAE,EACtD,cAAmB,GACpB,GAAE,IAAI,CAAC,wBAAwB,CAAC,CAAC,CAAC,EAAE,gBAAgB,CAAM,GAAG,iBAAiB,CAC7E,SAAS,CAAC,CAAC,CAAC,EACZ,KAAK,EACL;IAAE,OAAO,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,CAAC,CAAC;IAAC,KAAK,CAAC,EAAE,OAAO,CAAA;CAAE,CAC9C,CAwBA;AAED,wBAAgB,kBAAkB,CAAC,CAAC,SAAS,YAAY,EAAE,EACzD,cAAmB,EACnB,UAAU,GACX,GAAE,wBAAwB,CAAC,CAAC,CAAM,GAAG,iBAAiB,CACrD,OAAO,CAAC,CAAC,CAAC,EACV,KAAK,EACL;IAAE,OAAO,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,OAAO,CAAC,CAAC,CAAC,CAAA;CAAE,EACrC;IAAE,YAAY,EAAE,CAAC,GAAG,SAAS,CAAA;CAAE,GAAG,SAAS,CAC5C,CA0CA;AAED,wBAAgB,kBAAkB,CAAC,CAAC,GAAG,OAAO,EAAE,EAC9C,cAAmB,EACnB,UAAU,GACX,GAAE;IACD,cAAc,CAAC,EAAE,SAAS,QAAQ,EAAE,CAAC;IACrC,UAAU,CAAC,EAAE;QACX,QAAQ,EAAE,QAAQ,CAAC;QACnB,OAAO,EAAE,CAAC,OAAO,EAAE,CAAC,GAAG,SAAS,EAAE,OAAO,EAAE,MAAM,KAAK,CAAC,CAAC;KACzD,CAAC;CACE,GAAG,iBAAiB,CACxB,MAAM,EACN,KAAK,EACL;IAAE,OAAO,EAAE,MAAM,CAAA;CAAE,EACnB;IAAE,YAAY,EAAE,CAAC,GAAG,SAAS,CAAA;CAAE,GAAG,SAAS,CAC5C,CAoCA;AAED,UAAU,WAAW;IACnB,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,wBAAgB,iBAAiB,CAAC,EAChC,cAAmB,EACnB,SAA8B,GAC/B,GAAE,qBAA0B,GAAG,iBAAiB,CAC/C,WAAW,EACX,KAAK,EACL;IAAE,UAAU,EAAE,iBAAiB,EAAE,CAAA;CAAE,CACpC,CAuDA"}
+{"version":3,"file":"use-firestore-mutations.d.ts","sourceRoot":"","sources":["../../../src/react/firestore/use-firestore-mutations.ts"],"names":[],"mappings":"AAEA,OAAO,EAGL,KAAK,QAAQ,EACb,KAAK,iBAAiB,EACvB,MAAM,uBAAuB,CAAC;AAC/B,OAAO,EAML,KAAK,YAAY,EAClB,MAAM,oBAAoB,CAAC;AAE5B,OAAO,KAAK,EAAE,wBAAwB,EAAE,qBAAqB,EAAE,MAAM,0BAA0B,CAAC;AAChG,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,YAAY,CAAC;AAIpD,UAAU,SAAS,CAAC,CAAC;IACnB,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,CAAC,CAAC;CACT;AAED,wBAAgB,eAAe,CAAC,CAAC,SAAS,YAAY,EAAE,EACtD,cAAmB,GACpB,GAAE,IAAI,CAAC,wBAAwB,CAAC,CAAC,CAAC,EAAE,gBAAgB,CAAM,GAAG,iBAAiB,CAC7E,SAAS,CAAC,CAAC,CAAC,EACZ,KAAK,EACL;IAAE,OAAO,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,CAAC,CAAC;IAAC,KAAK,CAAC,EAAE,OAAO,CAAA;CAAE,CAC9C,CAwBA;AAED,wBAAgB,kBAAkB,CAAC,CAAC,SAAS,YAAY,EAAE,EACzD,cAAmB,EACnB,UAAU,GACX,GAAE,wBAAwB,CAAC,CAAC,CAAM,GAAG,iBAAiB,CACrD,OAAO,CAAC,CAAC,CAAC,EACV,KAAK,EACL;IAAE,OAAO,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,OAAO,CAAC,CAAC,CAAC,CAAA;CAAE,EACrC;IAAE,YAAY,EAAE,CAAC,GAAG,SAAS,CAAA;CAAE,GAAG,SAAS,CAC5C,CAoCA;AAED,wBAAgB,kBAAkB,CAAC,CAAC,GAAG,OAAO,EAAE,EAC9C,cAAmB,EACnB,UAAU,GACX,GAAE;IACD,cAAc,CAAC,EAAE,SAAS,QAAQ,EAAE,CAAC;IACrC,UAAU,CAAC,EAAE;QACX,QAAQ,EAAE,QAAQ,CAAC;QACnB,OAAO,EAAE,CAAC,OAAO,EAAE,CAAC,GAAG,SAAS,EAAE,OAAO,EAAE,MAAM,KAAK,CAAC,CAAC;KACzD,CAAC;CACE,GAAG,iBAAiB,CACxB,MAAM,EACN,KAAK,EACL;IAAE,OAAO,EAAE,MAAM,CAAA;CAAE,EACnB;IAAE,YAAY,EAAE,CAAC,GAAG,SAAS,CAAA;CAAE,GAAG,SAAS,CAC5C,CAkCA;AAED,UAAU,WAAW;IACnB,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,wBAAgB,iBAAiB,CAAC,EAChC,cAAmB,EACnB,SAA8B,GAC/B,GAAE,qBAA0B,GAAG,iBAAiB,CAC/C,WAAW,EACX,KAAK,EACL;IAAE,UAAU,EAAE,iBAAiB,EAAE,CAAA;CAAE,CACpC,CAmDA"}

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

@@ -1,5 +1,5 @@
 'use client';
-import { useMutation, useQueryClient } from '@tanstack/react-query';
+import { useMutation, useQueryClient, } from '@tanstack/react-query';
 import { doc, setDoc, updateDoc, deleteDoc, writeBatch, } from 'firebase/firestore';
 import { useFirestoreDb } from './context.js';
 const DEFAULT_BATCH_SIZE = 450;
@@ -23,7 +23,7 @@ export function useFirestoreUpdate({ invalidateKeys = [], optimistic, } = {}) {
     const db = useFirestoreDb();
     const queryClient = useQueryClient();
     return useMutation({
-        mutationFn: async ({ docPath, data, }) => {
+        mutationFn: async ({ docPath, data }) => {
             const docRef = doc(db, docPath);
             await updateDoc(docRef, data);
             return data;
@@ -87,7 +87,7 @@ export function useFirestoreBatch({ invalidateKeys = [], batchSize = DEFAULT_BAT
     const db = useFirestoreDb();
     const queryClient = useQueryClient();
     return useMutation({
-        mutationFn: async ({ operations, }) => {
+        mutationFn: async ({ operations }) => {
             const chunks = [];
             for (let i = 0; i < operations.length; i += batchSize) {
                 chunks.push(operations.slice(i, i + batchSize));

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

@@ -1 +1 @@
-{"version":3,"file":"use-firestore-mutations.js","sourceRoot":"","sources":["../../../src/react/firestore/use-firestore-mutations.ts"],"names":[],"mappings":"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","sourcesContent":["'use client';\n\nimport { useMutation, useQueryClient, type QueryKey, type UseMutationResult } from '@tanstack/react-query';\nimport {\n  doc,\n  setDoc,\n  updateDoc,\n  deleteDoc,\n  writeBatch,\n  type DocumentData,\n} from 'firebase/firestore';\nimport { useFirestoreDb } from './context.js';\nimport type { FirestoreMutationOptions, FirestoreBatchOptions, MutationOperation } from '../../firestore/types.js';\n\nconst DEFAULT_BATCH_SIZE = 450;\n\ninterface SetResult<T> {\n  id: string;\n  data: T;\n}\n\nexport function useFirestoreSet<T extends DocumentData>({\n  invalidateKeys = [],\n}: Pick<FirestoreMutationOptions<T>, 'invalidateKeys'> = {}): UseMutationResult<\n  SetResult<T>,\n  Error,\n  { docPath: string; data: T; merge?: boolean }\n> {\n  const db = useFirestoreDb();\n  const queryClient = useQueryClient();\n\n  return useMutation({\n    mutationFn: async ({\n      docPath,\n      data,\n      merge = false,\n    }: {\n      docPath: string;\n      data: T;\n      merge?: boolean;\n    }) => {\n      const docRef = doc(db, docPath);\n      await setDoc(docRef, data, { merge });\n      return { id: docRef.id, data };\n    },\n    onSuccess: () => {\n      invalidateKeys.forEach((key) => {\n        queryClient.invalidateQueries({ queryKey: key });\n      });\n    },\n  });\n}\n\nexport function useFirestoreUpdate<T extends DocumentData>({\n  invalidateKeys = [],\n  optimistic,\n}: FirestoreMutationOptions<T> = {}): UseMutationResult<\n  Partial<T>,\n  Error,\n  { docPath: string; data: Partial<T> },\n  { previousData: T | undefined } | undefined\n> {\n  const db = useFirestoreDb();\n  const queryClient = useQueryClient();\n\n  return useMutation({\n    mutationFn: async ({\n      docPath,\n      data,\n    }: {\n      docPath: string;\n      data: Partial<T>;\n    }) => {\n      const docRef = doc(db, docPath);\n      await updateDoc(docRef, data as DocumentData);\n      return data;\n    },\n    onMutate: async ({ data }) => {\n      if (!optimistic) return undefined;\n\n      await queryClient.cancelQueries({ queryKey: optimistic.queryKey });\n      const previousData = queryClient.getQueryData<T>(optimistic.queryKey);\n\n      queryClient.setQueryData<T>(optimistic.queryKey, (old) =>\n        optimistic.updater(old, data as Partial<T>)\n      );\n\n      return { previousData };\n    },\n    onError: (_error, _variables, context) => {\n      if (optimistic && context?.previousData !== undefined) {\n        queryClient.setQueryData(optimistic.queryKey, context.previousData);\n      }\n    },\n    onSettled: () => {\n      invalidateKeys.forEach((key) => {\n        queryClient.invalidateQueries({ queryKey: key });\n      });\n      if (optimistic) {\n        queryClient.invalidateQueries({ queryKey: optimistic.queryKey });\n      }\n    },\n  });\n}\n\nexport function useFirestoreDelete<T = unknown>({\n  invalidateKeys = [],\n  optimistic,\n}: {\n  invalidateKeys?: readonly QueryKey[];\n  optimistic?: {\n    queryKey: QueryKey;\n    updater: (oldData: T | undefined, docPath: string) => T;\n  };\n} = {}): UseMutationResult<\n  string,\n  Error,\n  { docPath: string },\n  { previousData: T | undefined } | undefined\n> {\n  const db = useFirestoreDb();\n  const queryClient = useQueryClient();\n\n  return useMutation({\n    mutationFn: async ({ docPath }: { docPath: string }) => {\n      const docRef = doc(db, docPath);\n      await deleteDoc(docRef);\n      return docPath;\n    },\n    onMutate: async ({ docPath }) => {\n      if (!optimistic) return undefined;\n\n      await queryClient.cancelQueries({ queryKey: optimistic.queryKey });\n      const previousData = queryClient.getQueryData<T>(optimistic.queryKey);\n\n      queryClient.setQueryData<T>(optimistic.queryKey, (old) =>\n        optimistic.updater(old, docPath)\n      );\n\n      return { previousData };\n    },\n    onError: (_error, _variables, context) => {\n      if (optimistic && context?.previousData !== undefined) {\n        queryClient.setQueryData(optimistic.queryKey, context.previousData);\n      }\n    },\n    onSettled: () => {\n      invalidateKeys.forEach((key) => {\n        queryClient.invalidateQueries({ queryKey: key });\n      });\n      if (optimistic) {\n        queryClient.invalidateQueries({ queryKey: optimistic.queryKey });\n      }\n    },\n  });\n}\n\ninterface BatchResult {\n  committed: number;\n  batches: number;\n}\n\nexport function useFirestoreBatch({\n  invalidateKeys = [],\n  batchSize = DEFAULT_BATCH_SIZE,\n}: FirestoreBatchOptions = {}): UseMutationResult<\n  BatchResult,\n  Error,\n  { operations: MutationOperation[] }\n> {\n  const db = useFirestoreDb();\n  const queryClient = useQueryClient();\n\n  return useMutation({\n    mutationFn: async ({\n      operations,\n    }: {\n      operations: MutationOperation[];\n    }) => {\n      const chunks: MutationOperation[][] = [];\n      for (let i = 0; i < operations.length; i += batchSize) {\n        chunks.push(operations.slice(i, i + batchSize));\n      }\n\n      let totalCommitted = 0;\n\n      for (const chunk of chunks) {\n        const batch = writeBatch(db);\n\n        for (const op of chunk) {\n          const docRef = doc(db, op.docPath);\n\n          switch (op.type) {\n            case 'set':\n              if (op.merge) {\n                batch.set(docRef, op.data, { merge: true });\n              } else {\n                batch.set(docRef, op.data);\n              }\n              break;\n            case 'update':\n              batch.update(docRef, op.data);\n              break;\n            case 'delete':\n              batch.delete(docRef);\n              break;\n          }\n        }\n\n        await batch.commit();\n        totalCommitted += chunk.length;\n      }\n\n      return {\n        committed: totalCommitted,\n        batches: chunks.length,\n      };\n    },\n    onSuccess: () => {\n      invalidateKeys.forEach((key) => {\n        queryClient.invalidateQueries({ queryKey: key });\n      });\n    },\n  });\n}\n"]}
+{"version":3,"file":"use-firestore-mutations.js","sourceRoot":"","sources":["../../../src/react/firestore/use-firestore-mutations.ts"],"names":[],"mappings":"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","sourcesContent":["'use client';\n\nimport {\n  useMutation,\n  useQueryClient,\n  type QueryKey,\n  type UseMutationResult,\n} from '@tanstack/react-query';\nimport {\n  doc,\n  setDoc,\n  updateDoc,\n  deleteDoc,\n  writeBatch,\n  type DocumentData,\n} from 'firebase/firestore';\nimport { useFirestoreDb } from './context.js';\nimport type { FirestoreMutationOptions, FirestoreBatchOptions } from '../../firestore/types.js';\nimport type { MutationOperation } from './types.js';\n\nconst DEFAULT_BATCH_SIZE = 450;\n\ninterface SetResult<T> {\n  id: string;\n  data: T;\n}\n\nexport function useFirestoreSet<T extends DocumentData>({\n  invalidateKeys = [],\n}: Pick<FirestoreMutationOptions<T>, 'invalidateKeys'> = {}): UseMutationResult<\n  SetResult<T>,\n  Error,\n  { docPath: string; data: T; merge?: boolean }\n> {\n  const db = useFirestoreDb();\n  const queryClient = useQueryClient();\n\n  return useMutation({\n    mutationFn: async ({\n      docPath,\n      data,\n      merge = false,\n    }: {\n      docPath: string;\n      data: T;\n      merge?: boolean;\n    }) => {\n      const docRef = doc(db, docPath);\n      await setDoc(docRef, data, { merge });\n      return { id: docRef.id, data };\n    },\n    onSuccess: () => {\n      invalidateKeys.forEach((key) => {\n        queryClient.invalidateQueries({ queryKey: key });\n      });\n    },\n  });\n}\n\nexport function useFirestoreUpdate<T extends DocumentData>({\n  invalidateKeys = [],\n  optimistic,\n}: FirestoreMutationOptions<T> = {}): UseMutationResult<\n  Partial<T>,\n  Error,\n  { docPath: string; data: Partial<T> },\n  { previousData: T | undefined } | undefined\n> {\n  const db = useFirestoreDb();\n  const queryClient = useQueryClient();\n\n  return useMutation({\n    mutationFn: async ({ docPath, data }: { docPath: string; data: Partial<T> }) => {\n      const docRef = doc(db, docPath);\n      await updateDoc(docRef, data as DocumentData);\n      return data;\n    },\n    onMutate: async ({ data }) => {\n      if (!optimistic) return undefined;\n\n      await queryClient.cancelQueries({ queryKey: optimistic.queryKey });\n      const previousData = queryClient.getQueryData<T>(optimistic.queryKey);\n\n      queryClient.setQueryData<T>(optimistic.queryKey, (old) =>\n        optimistic.updater(old, data as Partial<T>),\n      );\n\n      return { previousData };\n    },\n    onError: (_error, _variables, context) => {\n      if (optimistic && context?.previousData !== undefined) {\n        queryClient.setQueryData(optimistic.queryKey, context.previousData);\n      }\n    },\n    onSettled: () => {\n      invalidateKeys.forEach((key) => {\n        queryClient.invalidateQueries({ queryKey: key });\n      });\n      if (optimistic) {\n        queryClient.invalidateQueries({ queryKey: optimistic.queryKey });\n      }\n    },\n  });\n}\n\nexport function useFirestoreDelete<T = unknown>({\n  invalidateKeys = [],\n  optimistic,\n}: {\n  invalidateKeys?: readonly QueryKey[];\n  optimistic?: {\n    queryKey: QueryKey;\n    updater: (oldData: T | undefined, docPath: string) => T;\n  };\n} = {}): UseMutationResult<\n  string,\n  Error,\n  { docPath: string },\n  { previousData: T | undefined } | undefined\n> {\n  const db = useFirestoreDb();\n  const queryClient = useQueryClient();\n\n  return useMutation({\n    mutationFn: async ({ docPath }: { docPath: string }) => {\n      const docRef = doc(db, docPath);\n      await deleteDoc(docRef);\n      return docPath;\n    },\n    onMutate: async ({ docPath }) => {\n      if (!optimistic) return undefined;\n\n      await queryClient.cancelQueries({ queryKey: optimistic.queryKey });\n      const previousData = queryClient.getQueryData<T>(optimistic.queryKey);\n\n      queryClient.setQueryData<T>(optimistic.queryKey, (old) => optimistic.updater(old, docPath));\n\n      return { previousData };\n    },\n    onError: (_error, _variables, context) => {\n      if (optimistic && context?.previousData !== undefined) {\n        queryClient.setQueryData(optimistic.queryKey, context.previousData);\n      }\n    },\n    onSettled: () => {\n      invalidateKeys.forEach((key) => {\n        queryClient.invalidateQueries({ queryKey: key });\n      });\n      if (optimistic) {\n        queryClient.invalidateQueries({ queryKey: optimistic.queryKey });\n      }\n    },\n  });\n}\n\ninterface BatchResult {\n  committed: number;\n  batches: number;\n}\n\nexport function useFirestoreBatch({\n  invalidateKeys = [],\n  batchSize = DEFAULT_BATCH_SIZE,\n}: FirestoreBatchOptions = {}): UseMutationResult<\n  BatchResult,\n  Error,\n  { operations: MutationOperation[] }\n> {\n  const db = useFirestoreDb();\n  const queryClient = useQueryClient();\n\n  return useMutation({\n    mutationFn: async ({ operations }: { operations: MutationOperation[] }) => {\n      const chunks: MutationOperation[][] = [];\n      for (let i = 0; i < operations.length; i += batchSize) {\n        chunks.push(operations.slice(i, i + batchSize));\n      }\n\n      let totalCommitted = 0;\n\n      for (const chunk of chunks) {\n        const batch = writeBatch(db);\n\n        for (const op of chunk) {\n          const docRef = doc(db, op.docPath);\n\n          switch (op.type) {\n            case 'set':\n              if (op.merge) {\n                batch.set(docRef, op.data, { merge: true });\n              } else {\n                batch.set(docRef, op.data);\n              }\n              break;\n            case 'update':\n              batch.update(docRef, op.data);\n              break;\n            case 'delete':\n              batch.delete(docRef);\n              break;\n          }\n        }\n\n        await batch.commit();\n        totalCommitted += chunk.length;\n      }\n\n      return {\n        committed: totalCommitted,\n        batches: chunks.length,\n      };\n    },\n    onSuccess: () => {\n      invalidateKeys.forEach((key) => {\n        queryClient.invalidateQueries({ queryKey: key });\n      });\n    },\n  });\n}\n"]}

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

@@ -1,10 +1,7 @@
 import { type UseQueryResult } from '@tanstack/react-query';
 import { type DocumentData } from 'firebase/firestore';
-import type { FirestorePaginatedOptions, PaginatedPage, WithId } from '../../firestore/types.js';
-/**
- * Return type for useFirestorePaginated hook. `data` is the displayed page's rows; the
- * page's cache entry (rows, cursor, has-more) lives at `paginatedPageKey(queryKey, page)`.
- */
+import type { WithId } from '../../firestore/types.js';
+import type { FirestorePaginatedOptions, PaginatedPage } from './types.js';
 export type UseFirestorePaginatedResult<T> = Omit<UseQueryResult<PaginatedPage<WithId<T>>, Error>, 'data'> & {
     data: WithId<T>[] | undefined;
     page: number;
@@ -15,31 +12,5 @@ export type UseFirestorePaginatedResult<T> = Omit<UseQueryResult<PaginatedPage<W
     nextPage: () => void;
     prevPage: () => void;
 };
-/**
- * Page-based pagination for Firestore collections (Previous / Next, one page at a time).
- *
- * Each page is ONE cache entry at `[...queryKey, 'page', n]` holding its rows, its last
- * row as the next page's cursor, and whether a further page exists — read with a one-row
- * look-ahead, so `hasNextPage` is false exactly when nothing follows the displayed page.
- * Page n reads page n-1's cursor from the cache (loading the chain first if it is
- * missing) and records it as `after`. A displayed page whose `after` no longer matches
- * page n-1's cached cursor (page n-1 was re-read and its last row moved) is re-read before
- * it is shown, so every instance, remount, and refetch of a key agrees on where a page
- * starts. The page number belongs to the query identity (path, key, constraints, page
- * size): a new identity renders `initialPage` in its first render.
- *
- * `queryKey` must encode everything that changes the read — path, filters, ordering, and
- * page size — because the cache entries are shared by key.
- *
- * @example
- * ```tsx
- * const { data, page, nextPage, prevPage, hasNextPage, hasPrevPage } = useFirestorePaginated<Task>({
- *   collectionPath: 'tasks',
- *   queryKey: ['tasks', 'active', { pageSize: 10 }],
- *   constraints: [where('status', '==', 'active'), orderBy('createdAt', 'desc')],
- *   pageSize: 10,
- * });
- * ```
- */
 export declare function useFirestorePaginated<T extends DocumentData = DocumentData>({ collectionPath, queryKey, constraints, pageSize, initialPage, enabled, staleTime, gcTime, refetchInterval, select, }: FirestorePaginatedOptions<T>): UseFirestorePaginatedResult<T>;
 //# sourceMappingURL=use-firestore-paginated.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"use-firestore-paginated.d.ts","sourceRoot":"","sources":["../../../src/react/firestore/use-firestore-paginated.ts"],"names":[],"mappings":"AAGA,OAAO,EAA4B,KAAK,cAAc,EAAE,MAAM,uBAAuB,CAAC;AACtF,OAAO,EAML,KAAK,YAAY,EAElB,MAAM,oBAAoB,CAAC;AAG5B,OAAO,KAAK,EAAE,yBAAyB,EAAE,aAAa,EAAE,MAAM,EAAE,MAAM,0BAA0B,CAAC;AAIjG;;;GAGG;AACH,MAAM,MAAM,2BAA2B,CAAC,CAAC,IAAI,IAAI,CAAC,cAAc,CAAC,aAAa,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,EAAE,KAAK,CAAC,EAAE,MAAM,CAAC,GAAG;IAC3G,IAAI,EAAE,MAAM,CAAC,CAAC,CAAC,EAAE,GAAG,SAAS,CAAC;IAC9B,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,MAAM,CAAC;IACjB,WAAW,EAAE,OAAO,CAAC;IACrB,WAAW,EAAE,OAAO,CAAC;IACrB,OAAO,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;IAChC,QAAQ,EAAE,MAAM,IAAI,CAAC;IACrB,QAAQ,EAAE,MAAM,IAAI,CAAC;CACtB,CAAC;AAEF;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AACH,wBAAgB,qBAAqB,CAAC,CAAC,SAAS,YAAY,GAAG,YAAY,EAAE,EAC3E,cAAc,EACd,QAAQ,EACR,WAAgB,EAChB,QAA4B,EAC5B,WAAe,EACf,OAAc,EACd,SAAS,EACT,MAAM,EACN,eAAe,EACf,MAAM,GACP,EAAE,yBAAyB,CAAC,CAAC,CAAC,GAAG,2BAA2B,CAAC,CAAC,CAAC,CAmH/D"}
+{"version":3,"file":"use-firestore-paginated.d.ts","sourceRoot":"","sources":["../../../src/react/firestore/use-firestore-paginated.ts"],"names":[],"mappings":"AAGA,OAAO,EAA4B,KAAK,cAAc,EAAE,MAAM,uBAAuB,CAAC;AACtF,OAAO,EAML,KAAK,YAAY,EAElB,MAAM,oBAAoB,CAAC;AAG5B,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,0BAA0B,CAAC;AACvD,OAAO,KAAK,EAAE,yBAAyB,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAI3E,MAAM,MAAM,2BAA2B,CAAC,CAAC,IAAI,IAAI,CAC/C,cAAc,CAAC,aAAa,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,EAAE,KAAK,CAAC,EAC/C,MAAM,CACP,GAAG;IACF,IAAI,EAAE,MAAM,CAAC,CAAC,CAAC,EAAE,GAAG,SAAS,CAAC;IAC9B,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,MAAM,CAAC;IACjB,WAAW,EAAE,OAAO,CAAC;IACrB,WAAW,EAAE,OAAO,CAAC;IACrB,OAAO,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;IAChC,QAAQ,EAAE,MAAM,IAAI,CAAC;IACrB,QAAQ,EAAE,MAAM,IAAI,CAAC;CACtB,CAAC;AAEF,wBAAgB,qBAAqB,CAAC,CAAC,SAAS,YAAY,GAAG,YAAY,EAAE,EAC3E,cAAc,EACd,QAAQ,EACR,WAAgB,EAChB,QAA4B,EAC5B,WAAe,EACf,OAAc,EACd,SAAS,EACT,MAAM,EACN,eAAe,EACf,MAAM,GACP,EAAE,yBAAyB,CAAC,CAAC,CAAC,GAAG,2BAA2B,CAAC,CAAC,CAAC,CAiH/D"}

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

@@ -3,34 +3,8 @@ import { useState, useCallback, useEffect, useRef } from 'react';
 import { useQuery, useQueryClient } from '@tanstack/react-query';
 import { collection, query, getDocs, limit, startAfter, } from 'firebase/firestore';
 import { useFirestoreDb } from './context.js';
-import { paginatedPageKey } from '../../cache-helpers.js';
+import { paginatedPageKey } from '../cache-helpers.js';
 const DEFAULT_PAGE_SIZE = 10;
-/**
- * Page-based pagination for Firestore collections (Previous / Next, one page at a time).
- *
- * Each page is ONE cache entry at `[...queryKey, 'page', n]` holding its rows, its last
- * row as the next page's cursor, and whether a further page exists — read with a one-row
- * look-ahead, so `hasNextPage` is false exactly when nothing follows the displayed page.
- * Page n reads page n-1's cursor from the cache (loading the chain first if it is
- * missing) and records it as `after`. A displayed page whose `after` no longer matches
- * page n-1's cached cursor (page n-1 was re-read and its last row moved) is re-read before
- * it is shown, so every instance, remount, and refetch of a key agrees on where a page
- * starts. The page number belongs to the query identity (path, key, constraints, page
- * size): a new identity renders `initialPage` in its first render.
- *
- * `queryKey` must encode everything that changes the read — path, filters, ordering, and
- * page size — because the cache entries are shared by key.
- *
- * @example
- * ```tsx
- * const { data, page, nextPage, prevPage, hasNextPage, hasPrevPage } = useFirestorePaginated<Task>({
- *   collectionPath: 'tasks',
- *   queryKey: ['tasks', 'active', { pageSize: 10 }],
- *   constraints: [where('status', '==', 'active'), orderBy('createdAt', 'desc')],
- *   pageSize: 10,
- * });
- * ```
- */
 export function useFirestorePaginated({ collectionPath, queryKey, constraints = [], pageSize = DEFAULT_PAGE_SIZE, initialPage = 1, enabled = true, staleTime, gcTime, refetchInterval, select, }) {
     const db = useFirestoreDb();
     const queryClient = useQueryClient();
@@ -68,8 +42,7 @@ export function useFirestorePaginated({ collectionPath, queryKey, constraints =
             after: cursor?.id ?? null,
         };
     }, 
-    // queryKey and constraints are captured through their serialized identity.
-    // eslint-disable-next-line react-hooks/exhaustive-deps
+    // eslint-disable-next-line react-hooks/exhaustive-deps -- queryKey and constraints are captured through their serialized identity
     [db, queryClient, identity, selectRef]);
     const queryResult = useQuery({
         queryKey: paginatedPageKey(queryKey, page),
@@ -79,9 +52,6 @@ export function useFirestorePaginated({ collectionPath, queryKey, constraints =
         gcTime,
         refetchInterval,
     });
-    // The page before the displayed one, observed from the cache only (never fetched here).
-    // When it is re-read and its last row moves, the displayed entry no longer starts where the
-    // chain says it must: it is re-read before it is shown as current.
     const previousPage = useQuery({
         queryKey: paginatedPageKey(queryKey, Math.max(1, page - 1)),
         queryFn: () => fetchPage(Math.max(1, page - 1)),
@@ -90,7 +60,8 @@ export function useFirestorePaginated({ collectionPath, queryKey, constraints =
     const cachedEntry = queryResult.data;
     const outOfChain = page > 1 &&
         cachedEntry !== undefined &&
-        (previousPage.data === undefined || cachedEntry.after !== (previousPage.data.cursor?.id ?? null));
+        (previousPage.data === undefined ||
+            cachedEntry.after !== (previousPage.data.cursor?.id ?? null));
     const { refetch, isFetching } = queryResult;
     useEffect(() => {
         if (enabled && outOfChain && !isFetching)
@@ -111,14 +82,15 @@ export function useFirestorePaginated({ collectionPath, queryKey, constraints =
             return;
         setPageState({ identity, page: next });
     }, 
-    // queryKey is captured through its serialized identity.
-    // eslint-disable-next-line react-hooks/exhaustive-deps
+    // eslint-disable-next-line react-hooks/exhaustive-deps -- queryKey is captured through its serialized identity
     [page, hasNextPage, identity, queryClient]);
     const nextPage = useCallback(() => setPage(page + 1), [page, setPage]);
     const prevPage = useCallback(() => setPage(page - 1), [page, setPage]);
     return {
         ...queryResult,
-        ...(outOfChain ? { isLoading: true, isPending: true, isSuccess: false, status: 'pending' } : {}),
+        ...(outOfChain
+            ? { isLoading: true, isPending: true, isSuccess: false, status: 'pending' }
+            : {}),
         data: entry?.items,
         page,
         pageSize,

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

@@ -1 +1 @@
-{"version":3,"file":"use-firestore-paginated.js","sourceRoot":"","sources":["../../../src/react/firestore/use-firestore-paginated.ts"],"names":[],"mappings":"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","sourcesContent":["'use client';\n\nimport { useState, useCallback, useEffect, useRef } from 'react';\nimport { useQuery, useQueryClient, type UseQueryResult } from '@tanstack/react-query';\nimport {\n  collection,\n  query,\n  getDocs,\n  limit,\n  startAfter,\n  type DocumentData,\n  type DocumentSnapshot,\n} from 'firebase/firestore';\nimport { useFirestoreDb } from './context.js';\nimport { paginatedPageKey } from '../../cache-helpers.js';\nimport type { FirestorePaginatedOptions, PaginatedPage, WithId } from '../../firestore/types.js';\n\nconst DEFAULT_PAGE_SIZE = 10;\n\n/**\n * Return type for useFirestorePaginated hook. `data` is the displayed page's rows; the\n * page's cache entry (rows, cursor, has-more) lives at `paginatedPageKey(queryKey, page)`.\n */\nexport type UseFirestorePaginatedResult<T> = Omit<UseQueryResult<PaginatedPage<WithId<T>>, Error>, 'data'> & {\n  data: WithId<T>[] | undefined;\n  page: number;\n  pageSize: number;\n  hasNextPage: boolean;\n  hasPrevPage: boolean;\n  setPage: (page: number) => void;\n  nextPage: () => void;\n  prevPage: () => void;\n};\n\n/**\n * Page-based pagination for Firestore collections (Previous / Next, one page at a time).\n *\n * Each page is ONE cache entry at `[...queryKey, 'page', n]` holding its rows, its last\n * row as the next page's cursor, and whether a further page exists — read with a one-row\n * look-ahead, so `hasNextPage` is false exactly when nothing follows the displayed page.\n * Page n reads page n-1's cursor from the cache (loading the chain first if it is\n * missing) and records it as `after`. A displayed page whose `after` no longer matches\n * page n-1's cached cursor (page n-1 was re-read and its last row moved) is re-read before\n * it is shown, so every instance, remount, and refetch of a key agrees on where a page\n * starts. The page number belongs to the query identity (path, key, constraints, page\n * size): a new identity renders `initialPage` in its first render.\n *\n * `queryKey` must encode everything that changes the read — path, filters, ordering, and\n * page size — because the cache entries are shared by key.\n *\n * @example\n * ```tsx\n * const { data, page, nextPage, prevPage, hasNextPage, hasPrevPage } = useFirestorePaginated<Task>({\n *   collectionPath: 'tasks',\n *   queryKey: ['tasks', 'active', { pageSize: 10 }],\n *   constraints: [where('status', '==', 'active'), orderBy('createdAt', 'desc')],\n *   pageSize: 10,\n * });\n * ```\n */\nexport function useFirestorePaginated<T extends DocumentData = DocumentData>({\n  collectionPath,\n  queryKey,\n  constraints = [],\n  pageSize = DEFAULT_PAGE_SIZE,\n  initialPage = 1,\n  enabled = true,\n  staleTime,\n  gcTime,\n  refetchInterval,\n  select,\n}: FirestorePaginatedOptions<T>): UseFirestorePaginatedResult<T> {\n  const db = useFirestoreDb();\n  const queryClient = useQueryClient();\n\n  const queryKeyMemo = JSON.stringify(queryKey);\n  const constraintsMemo = JSON.stringify(constraints);\n  const identity = JSON.stringify([collectionPath, queryKeyMemo, constraintsMemo, pageSize]);\n  const firstPage = Math.max(1, Math.floor(initialPage));\n\n  const [pageState, setPageState] = useState(() => ({ identity, page: firstPage }));\n  const page = pageState.identity === identity ? pageState.page : firstPage;\n\n  const selectRef = useRef(select);\n  selectRef.current = select;\n\n  const fetchPage = useCallback(\n    async (n: number): Promise<PaginatedPage<WithId<T>>> => {\n      let cursor: DocumentSnapshot | null = null;\n      if (n > 1) {\n        const previous = await queryClient.ensureQueryData<PaginatedPage<WithId<T>>>({\n          queryKey: paginatedPageKey(queryKey, n - 1),\n          queryFn: () => fetchPage(n - 1),\n        });\n        if (!previous.hasMore || !previous.cursor) {\n          return { items: [], cursor: null, hasMore: false, after: previous.cursor?.id ?? null };\n        }\n        cursor = previous.cursor;\n      }\n      const q = query(\n        collection(db, collectionPath),\n        ...constraints,\n        ...(cursor ? [startAfter(cursor)] : []),\n        limit(pageSize + 1),\n      );\n      const snapshot = await getDocs(q);\n      const pageDocs = snapshot.docs.slice(0, pageSize);\n      return {\n        items: pageDocs.map((docSnap) => {\n          const dataWithId = { id: docSnap.id, ...docSnap.data() };\n          const mapped = selectRef.current ? selectRef.current(dataWithId) : dataWithId;\n          return mapped as WithId<T>;\n        }),\n        cursor: pageDocs[pageDocs.length - 1] ?? null,\n        hasMore: snapshot.docs.length > pageSize,\n        after: cursor?.id ?? null,\n      };\n    },\n    // queryKey and constraints are captured through their serialized identity.\n    // eslint-disable-next-line react-hooks/exhaustive-deps\n    [db, queryClient, identity, selectRef],\n  );\n\n  const queryResult = useQuery({\n    queryKey: paginatedPageKey(queryKey, page),\n    queryFn: () => fetchPage(page),\n    enabled,\n    staleTime,\n    gcTime,\n    refetchInterval,\n  });\n\n  // The page before the displayed one, observed from the cache only (never fetched here).\n  // When it is re-read and its last row moves, the displayed entry no longer starts where the\n  // chain says it must: it is re-read before it is shown as current.\n  const previousPage = useQuery({\n    queryKey: paginatedPageKey(queryKey, Math.max(1, page - 1)),\n    queryFn: () => fetchPage(Math.max(1, page - 1)),\n    enabled: false,\n  });\n  const cachedEntry = queryResult.data;\n  const outOfChain =\n    page > 1 &&\n    cachedEntry !== undefined &&\n    (previousPage.data === undefined || cachedEntry.after !== (previousPage.data.cursor?.id ?? null));\n  const { refetch, isFetching } = queryResult;\n  useEffect(() => {\n    if (enabled && outOfChain && !isFetching) void refetch();\n  }, [enabled, outOfChain, isFetching, refetch]);\n\n  const entry = outOfChain ? undefined : cachedEntry;\n  const hasNextPage = Boolean(entry?.hasMore && entry.cursor);\n\n  const setPage = useCallback(\n    (target: number) => {\n      const next = Math.floor(target);\n      if (next < 1 || next === page) return;\n      if (next > page + 1) {\n        const before = queryClient.getQueryData<PaginatedPage<unknown>>(\n          paginatedPageKey(queryKey, next - 1),\n        );\n        if (!before?.hasMore) return;\n      }\n      if (next === page + 1 && !hasNextPage) return;\n      setPageState({ identity, page: next });\n    },\n    // queryKey is captured through its serialized identity.\n    // eslint-disable-next-line react-hooks/exhaustive-deps\n    [page, hasNextPage, identity, queryClient],\n  );\n\n  const nextPage = useCallback(() => setPage(page + 1), [page, setPage]);\n  const prevPage = useCallback(() => setPage(page - 1), [page, setPage]);\n\n  return {\n    ...queryResult,\n    ...(outOfChain ? { isLoading: true, isPending: true, isSuccess: false, status: 'pending' as const } : {}),\n    data: entry?.items,\n    page,\n    pageSize,\n    hasNextPage,\n    hasPrevPage: page > 1,\n    setPage,\n    nextPage,\n    prevPage,\n  } as UseFirestorePaginatedResult<T>;\n}\n"]}
+{"version":3,"file":"use-firestore-paginated.js","sourceRoot":"","sources":["../../../src/react/firestore/use-firestore-paginated.ts"],"names":[],"mappings":"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","sourcesContent":["'use client';\n\nimport { useState, useCallback, useEffect, useRef } from 'react';\nimport { useQuery, useQueryClient, type UseQueryResult } from '@tanstack/react-query';\nimport {\n  collection,\n  query,\n  getDocs,\n  limit,\n  startAfter,\n  type DocumentData,\n  type DocumentSnapshot,\n} from 'firebase/firestore';\nimport { useFirestoreDb } from './context.js';\nimport { paginatedPageKey } from '../cache-helpers.js';\nimport type { WithId } from '../../firestore/types.js';\nimport type { FirestorePaginatedOptions, PaginatedPage } from './types.js';\n\nconst DEFAULT_PAGE_SIZE = 10;\n\nexport type UseFirestorePaginatedResult<T> = Omit<\n  UseQueryResult<PaginatedPage<WithId<T>>, Error>,\n  'data'\n> & {\n  data: WithId<T>[] | undefined;\n  page: number;\n  pageSize: number;\n  hasNextPage: boolean;\n  hasPrevPage: boolean;\n  setPage: (page: number) => void;\n  nextPage: () => void;\n  prevPage: () => void;\n};\n\nexport function useFirestorePaginated<T extends DocumentData = DocumentData>({\n  collectionPath,\n  queryKey,\n  constraints = [],\n  pageSize = DEFAULT_PAGE_SIZE,\n  initialPage = 1,\n  enabled = true,\n  staleTime,\n  gcTime,\n  refetchInterval,\n  select,\n}: FirestorePaginatedOptions<T>): UseFirestorePaginatedResult<T> {\n  const db = useFirestoreDb();\n  const queryClient = useQueryClient();\n\n  const queryKeyMemo = JSON.stringify(queryKey);\n  const constraintsMemo = JSON.stringify(constraints);\n  const identity = JSON.stringify([collectionPath, queryKeyMemo, constraintsMemo, pageSize]);\n  const firstPage = Math.max(1, Math.floor(initialPage));\n\n  const [pageState, setPageState] = useState(() => ({ identity, page: firstPage }));\n  const page = pageState.identity === identity ? pageState.page : firstPage;\n\n  const selectRef = useRef(select);\n  selectRef.current = select;\n\n  const fetchPage = useCallback(\n    async (n: number): Promise<PaginatedPage<WithId<T>>> => {\n      let cursor: DocumentSnapshot | null = null;\n      if (n > 1) {\n        const previous = await queryClient.ensureQueryData<PaginatedPage<WithId<T>>>({\n          queryKey: paginatedPageKey(queryKey, n - 1),\n          queryFn: () => fetchPage(n - 1),\n        });\n        if (!previous.hasMore || !previous.cursor) {\n          return { items: [], cursor: null, hasMore: false, after: previous.cursor?.id ?? null };\n        }\n        cursor = previous.cursor;\n      }\n      const q = query(\n        collection(db, collectionPath),\n        ...constraints,\n        ...(cursor ? [startAfter(cursor)] : []),\n        limit(pageSize + 1),\n      );\n      const snapshot = await getDocs(q);\n      const pageDocs = snapshot.docs.slice(0, pageSize);\n      return {\n        items: pageDocs.map((docSnap) => {\n          const dataWithId = { id: docSnap.id, ...docSnap.data() };\n          const mapped = selectRef.current ? selectRef.current(dataWithId) : dataWithId;\n          return mapped as WithId<T>;\n        }),\n        cursor: pageDocs[pageDocs.length - 1] ?? null,\n        hasMore: snapshot.docs.length > pageSize,\n        after: cursor?.id ?? null,\n      };\n    },\n    // eslint-disable-next-line react-hooks/exhaustive-deps -- queryKey and constraints are captured through their serialized identity\n    [db, queryClient, identity, selectRef],\n  );\n\n  const queryResult = useQuery({\n    queryKey: paginatedPageKey(queryKey, page),\n    queryFn: () => fetchPage(page),\n    enabled,\n    staleTime,\n    gcTime,\n    refetchInterval,\n  });\n\n  const previousPage = useQuery({\n    queryKey: paginatedPageKey(queryKey, Math.max(1, page - 1)),\n    queryFn: () => fetchPage(Math.max(1, page - 1)),\n    enabled: false,\n  });\n  const cachedEntry = queryResult.data;\n  const outOfChain =\n    page > 1 &&\n    cachedEntry !== undefined &&\n    (previousPage.data === undefined ||\n      cachedEntry.after !== (previousPage.data.cursor?.id ?? null));\n  const { refetch, isFetching } = queryResult;\n  useEffect(() => {\n    if (enabled && outOfChain && !isFetching) void refetch();\n  }, [enabled, outOfChain, isFetching, refetch]);\n\n  const entry = outOfChain ? undefined : cachedEntry;\n  const hasNextPage = Boolean(entry?.hasMore && entry.cursor);\n\n  const setPage = useCallback(\n    (target: number) => {\n      const next = Math.floor(target);\n      if (next < 1 || next === page) return;\n      if (next > page + 1) {\n        const before = queryClient.getQueryData<PaginatedPage<unknown>>(\n          paginatedPageKey(queryKey, next - 1),\n        );\n        if (!before?.hasMore) return;\n      }\n      if (next === page + 1 && !hasNextPage) return;\n      setPageState({ identity, page: next });\n    },\n    // eslint-disable-next-line react-hooks/exhaustive-deps -- queryKey is captured through its serialized identity\n    [page, hasNextPage, identity, queryClient],\n  );\n\n  const nextPage = useCallback(() => setPage(page + 1), [page, setPage]);\n  const prevPage = useCallback(() => setPage(page - 1), [page, setPage]);\n\n  return {\n    ...queryResult,\n    ...(outOfChain\n      ? { isLoading: true, isPending: true, isSuccess: false, status: 'pending' as const }\n      : {}),\n    data: entry?.items,\n    page,\n    pageSize,\n    hasNextPage,\n    hasPrevPage: page > 1,\n    setPage,\n    nextPage,\n    prevPage,\n  } as UseFirestorePaginatedResult<T>;\n}\n"]}