createCursorPager

function createCursorPager<T>(__namedParameters): CursorPager<T>;

Defined in: packages/query-db-collection/src/cursor-pagination.ts:50

Fulfill offset/limit windows using opaque backend cursors. Query owns the pages, freshness, invalidation and garbage collection. Use one dedicated key per filtered, totally ordered source. Loading more reuses fresh pages; refreshing stale data rebuilds the loaded sequence from its first page.

The key must not also be used for ordinary QueryCollection row arrays. Use sibling row/page prefixes under one resource prefix, not pages beneath the row prefix (manual writes update that whole prefix). For a forced refresh, cancel the resource prefix before invalidating it. A positive staleTime avoids refreshing on every read.

Reads on one pager serialize; separate pagers share Query's cache and fetches. Aborting a reader discards its answer, not shared cached pages. Cancel the query through QueryClient to cancel its transport. Neither cancellation nor a TTL can repair a backend's inconsistent cursor sequence.