@robohall/react-query-factory 1.0.4 → 1.1.0

package/README.md

@@ -38,7 +38,6 @@ const describeInstances = queryFactory({
   queryKey: ['ec2:DescribeInstances'],
   queryFn: (params: DescribeInstancesCommandInput, ctx) =>
     ec2.send(new DescribeInstancesCommand(params), { abortSignal: ctx.signal }),
-  staleTime: 30_000,
 });
 
 function InstanceList() {
@@ -46,7 +45,6 @@ function InstanceList() {
     describeInstances({ Filters: [{ Name: 'instance-state-name', Values: ['running'] }] })
   );
   // query key:  ['ec2:DescribeInstances', { Filters: [...] }]
-  // staleTime:  30 000 ms, no repetition required
 }
 ```
 
@@ -58,7 +56,7 @@ function InstanceList() {
 
 `DescribeInstances` is paginated. If you have more than 1000 instances, one call won't get them all. The standard approach — chaining `fetchNextPage` calls, accumulating results, checking `NextToken` — is correct but tedious to repeat everywhere.
 
-Add `getNextPageParam`, `initialPageParam`, and `reduce` to your factory config, and the generated `queryFn` will walk every page automatically, reducing them into a single flat array:
+Add `getNextPageParam` and `shouldFetchNextPage` to activate crawling — those two are the only required pieces. `initialPageParam` types `ctx.pageParam` in your `queryFn` (without it, `ctx.pageParam` is `never`). `reduce` folds crawled pages into a single value; without it the result is the last fetched page. **`shouldFetchNextPage`** is called after each page — return `true` to keep fetching, `false` to stop. Use `() => true` to walk every page:
 
 ```typescript
 import type { Instance, DescribeInstancesCommandInput } from '@aws-sdk/client-ec2';
@@ -72,11 +70,11 @@ const describeInstances = queryFactory({
     ),
   getNextPageParam: response => response.NextToken,
   initialPageParam: undefined as string | undefined,
+  shouldFetchNextPage: () => true,
   reduce: (acc, page): Instance[] => [
     ...(acc ?? []),
     ...(page.Reservations?.flatMap(r => r.Instances ?? []) ?? []),
   ],
-  staleTime: 30_000,
 });
 
 function InstanceList() {
@@ -85,18 +83,21 @@ function InstanceList() {
 }
 ```
 
-**`shouldFetchNextPage`** lets a call site stop the crawl early based on what has been accumulated so far. The arguments are the current reduced value and a `crawlOptions` object passed at call time. When `reduce` is present, `combined` is typed as `TSelected` (never undefined) because `reduce` always runs before this callback:
+`shouldFetchNextPage` also accepts a `crawlOptions` object passed at call time, letting each call site control the crawl independently:
 
 ```typescript
 const describeInstances = queryFactory({
   // ...
   reduce: (acc, page): Instance[] => [...(acc ?? []), ...page.Reservations.flatMap(r => r.Instances)],
   shouldFetchNextPage: (instances, opts: { minResults?: number }) =>
-    opts.minResults != null && instances.length < opts.minResults,  // instances: Instance[], not Instance[] | undefined
+    opts.minResults == null || instances.length < opts.minResults,
 });
 
+// fetch all pages
+const { data: all } = useQuery(describeInstances({ MaxResults: 1000 }));
+
 // stop after accumulating at least 50 instances
-const { data } = useQuery(
+const { data: partial } = useQuery(
   describeInstances({ MaxResults: 1000 }, { minResults: 50 })
 );
 ```
@@ -131,7 +132,7 @@ const findInstance = queryFactory(describeInstances, {
   // queryFn, getNextPageParam, initialPageParam, and reduce are all inherited
   shouldFetchNextPage: (instances, opts: { instanceId?: string }) =>
     opts.instanceId != null &&
-    !instances?.some(i => i.InstanceId === opts.instanceId),
+    !instances.some(i => i.InstanceId === opts.instanceId),
 });
 
 // query key: ['ec2:DescribeInstances', 'find', { MaxResults: 100 }, { instanceId: 'i-0abc123' }]
@@ -198,11 +199,11 @@ All fields except `reduce` and `shouldFetchNextPage` are the standard TanStack Q
 | `queryKey` | `QueryKey` | Namespace segments. Params are appended at call time. |
 | `queryFn` | `(params: TParams, ctx: QueryFunctionContext) => TData \| Promise<TData>` | Same as TanStack, with an extra leading `params` argument. |
 | `select` | `(data: TData) => TSelected` | Exact TanStack API. Composed automatically on child factories. |
-| `getNextPageParam` | `GetNextPageParamFunction<TPageParam, TData>` | Exact TanStack API. Providing this together with `initialPageParam` and `reduce` activates crawling. |
-| `initialPageParam` | `TPageParam` | Exact TanStack API. Required alongside `getNextPageParam` to enable crawling. |
+| `getNextPageParam` | `GetNextPageParamFunction<TPageParam, TData>` | Exact TanStack API. Required (with `shouldFetchNextPage`) to activate crawling. Required (with `initialPageParam`) for `.infinite()`. |
+| `initialPageParam` | `TPageParam` | Exact TanStack API. Drives `TPageParam` inference — without it `ctx.pageParam` is typed `never`. Required for `.infinite()` to work at runtime. |
 | `getPreviousPageParam` | `GetPreviousPageParamFunction<TPageParam, TData>` | Exact TanStack API. Passed through on `.infinite()`. |
-| `reduce` | `(acc: TSelected \| undefined, page: TData) => TSelected` | Library addition. Folds crawled pages into a single value; required for crawling and `.infinite()` crawling. |
-| `shouldFetchNextPage` | `(combined: TSelected, crawlOptions: TCrawlOptions) => boolean` when `reduce` is present; `(combined: TSelected \| undefined, ...) => boolean` otherwise | Library addition. Return `false` to stop the crawl early based on accumulated results. |
+| `shouldFetchNextPage` | `(combined: TSelected \| undefined, crawlOptions: TCrawlOptions) => boolean` | Library addition. **Required (with `getNextPageParam`) to activate crawling.** Called after each page — return `true` to keep fetching, `false` to stop. |
+| `reduce` | `(acc: TSelected \| undefined, page: TData) => TSelected` | Library addition. Optional. Folds crawled pages into a single `TSelected` value; when omitted the result is the last fetched page (`TSelected = TData`). |
 | + all `StandardQueryOptions` fields | | All options accepted by TanStack's `useQuery` / `useInfiniteQuery` except `queryKey`, `queryFn`, and `select` (which the factory owns). Includes `staleTime`, `gcTime`, `retry`, `retryOnMount`, `enabled`, `refetchOnWindowFocus`, `refetchOnReconnect`, `refetchOnMount`, `refetchInterval`, `refetchIntervalInBackground`, `networkMode`, `notifyOnChangeProps`, `throwOnError`, `structuralSharing`, `initialData`, `initialDataUpdatedAt`, `placeholderData`, `queryKeyHashFn`, `persister`, `meta`, `maxPages`, `experimental_prefetchInRender`. Function-form callbacks (e.g. `enabled: (query) => boolean`) are supported wherever TanStack accepts them. |
 
 ### `QueryFactory<TParams, TData, TError, TSelected, TPageParam, TCrawlOptions>`

package/dist/index.d.mts

@@ -27,29 +27,25 @@ type QueryFactoryConfig<TParams = void, TData = unknown, TError = Error, TSelect
     /** Namespace segments. Params are appended as the final element at call time,
      *  giving a full key of [...namespace, 'infinite'?, params, crawlOptions?]. */
     queryKey: QueryKey;
-    queryFn?: (params: TParams, context: QueryFunctionContext<QueryKey, [unknown] extends [TPageParam] ? never : TPageParam>) => TData | Promise<TData>;
+    queryFn?: (params: TParams, context: QueryFunctionContext<QueryKey, [
+        unknown
+    ] extends [TPageParam] ? never : TPageParam>) => TData | Promise<TData>;
     select?: (data: TData) => TSelected;
-} & ({
     /** TanStack v5 generic order: GetNextPageParamFunction<TPageParam, TData> */
-    getNextPageParam: GetNextPageParamFunction<TPageParam, TData>;
-    /** Required alongside getNextPageParam — drives TPageParam inference so
-     *  ctx.pageParam in queryFn is typed as TPageParam, not unknown. */
-    initialPageParam: TPageParam;
+    getNextPageParam?: GetNextPageParamFunction<TPageParam, TData>;
+    /** Drives TPageParam inference so ctx.pageParam in queryFn is typed as TPageParam.
+     *  When omitted TPageParam stays unknown and ctx.pageParam is typed as never.
+     *  Required for .infinite() to work correctly at runtime. */
+    initialPageParam?: TPageParam;
     getPreviousPageParam?: GetPreviousPageParamFunction<TPageParam, TData>;
     /** Reduces crawled pages incrementally into the final query result.
      *  Called once per page; accumulator is undefined on the first call.
-     *  When set, enables crawling on both the regular and .infinite variants. */
+     *  When omitted, the crawl result is the last fetched page (TSelected = TData). */
     reduce?: (accumulator: TSelected | undefined, page: TData) => TSelected;
     /** Called after each page to decide whether to keep crawling.
-     *  `combined` may be undefined when reduce is absent. */
+     *  Required (along with getNextPageParam) to activate crawling. */
     shouldFetchNextPage?: (combined: TSelected | undefined, crawlOptions: TCrawlOptions) => boolean;
-} | {
-    getNextPageParam?: never;
-    initialPageParam?: never;
-    getPreviousPageParam?: never;
-    shouldFetchNextPage?: never;
-    reduce?: never;
-});
+};
 /**
  * What `factory(params)` returns — pass directly to `useQuery()`.
  *
@@ -95,7 +91,7 @@ type ResolvedInfiniteOptions<TData = unknown, TError = Error, TPageParam = unkno
  * namespace key, which is useful for broad cache invalidation:
  * `queryClient.invalidateQueries(factory())`
  */
-interface QueryFactory<TParams = void, TData = unknown, TError = Error, TSelected = TData, TPageParam = unknown, TCrawlOptions extends Record<string, unknown> = Record<string, unknown>> {
+interface QueryFactory<TParams = void, TData = unknown, TError = Error, TSelected = TData, TPageParam = unknown, TCrawlOptions extends Record<string, unknown> = Record<string, unknown>, THasReduce extends boolean = boolean> {
     (params?: TParams, crawlOptions?: TCrawlOptions): ResolvedQueryOptions<TData, TError, TSelected>;
     infinite(params?: TParams, crawlOptions?: TCrawlOptions): ResolvedInfiniteOptions<TData, TError, TPageParam>;
 }
@@ -106,14 +102,16 @@ interface QueryFactory<TParams = void, TData = unknown, TError = Error, TSelecte
  */
 declare function queryFactory<TParams = void, TData = unknown, TError = Error, TSelected = TData, TPageParam = unknown, TCrawlOptions extends Record<string, unknown> = Record<string, unknown>>(config: StandardQueryOptions<TError, TData> & {
     queryKey: QueryKey;
-    queryFn?: (params: TParams, context: QueryFunctionContext<QueryKey, [unknown] extends [TPageParam] ? never : TPageParam>) => TData | Promise<TData>;
+    queryFn?: (params: TParams, context: QueryFunctionContext<QueryKey, [
+        unknown
+    ] extends [TPageParam] ? never : TPageParam>) => TData | Promise<TData>;
     select?: (data: TData) => TSelected;
-    getNextPageParam: GetNextPageParamFunction<TPageParam, TData>;
-    initialPageParam: TPageParam;
+    getNextPageParam?: GetNextPageParamFunction<TPageParam, TData>;
+    initialPageParam?: TPageParam;
     getPreviousPageParam?: GetPreviousPageParamFunction<TPageParam, TData>;
     reduce: (accumulator: TSelected | undefined, page: TData) => TSelected;
     shouldFetchNextPage?: (combined: TSelected, crawlOptions: TCrawlOptions) => boolean;
-}): QueryFactory<TParams, TData, TError, TSelected, TPageParam, TCrawlOptions>;
+}): QueryFactory<TParams, TData, TError, TSelected, TPageParam, TCrawlOptions, true>;
 /**
  * Creates a standalone query factory from a config object.
  *
@@ -124,7 +122,7 @@ declare function queryFactory<TParams = void, TData = unknown, TError = Error, T
  * });
  * // useQuery(usersFactory({ page: 1 }))
  */
-declare function queryFactory<TParams = void, TData = unknown, TError = Error, TSelected = TData, TPageParam = unknown, TCrawlOptions extends Record<string, unknown> = Record<string, unknown>>(config: QueryFactoryConfig<TParams, TData, TError, TSelected, TPageParam, TCrawlOptions>): QueryFactory<TParams, TData, TError, TSelected, TPageParam, TCrawlOptions>;
+declare function queryFactory<TParams = void, TData = unknown, TError = Error, TSelected = TData, TPageParam = unknown, TCrawlOptions extends Record<string, unknown> = Record<string, unknown>>(config: QueryFactoryConfig<TParams, TData, TError, TSelected, TPageParam, TCrawlOptions>): QueryFactory<TParams, TData, TError, TSelected, TPageParam, TCrawlOptions, false>;
 /**
  * Creates a child factory that inherits the query key and standard options from
  * `parent` and introduces a new `queryFn`. The child's query key is appended to
@@ -132,22 +130,10 @@ declare function queryFactory<TParams = void, TData = unknown, TError = Error, T
  *
  * Use this overload when the child fetches different data than the parent.
  */
-declare function queryFactory<TChildParams extends TParentParams, TData = unknown, TError = Error, TChildSelected = TData, TParentParams = TChildParams, TPageParam = unknown, TCrawlOptions extends Record<string, unknown> = Record<string, unknown>>(parent: QueryFactory<TParentParams, any, any, any, any, any>, config: Omit<QueryFactoryConfig<TChildParams, TData, TError, TChildSelected, TPageParam, TCrawlOptions>, 'queryKey' | 'getNextPageParam' | 'getPreviousPageParam' | 'initialPageParam' | 'shouldFetchNextPage' | 'reduce'> & {
+declare function queryFactory<TChildParams extends TParentParams, TData = unknown, TError = Error, TChildSelected = TData, TParentParams = TChildParams, TPageParam = unknown, TCrawlOptions extends Record<string, unknown> = Record<string, unknown>>(parent: QueryFactory<TParentParams, any, any, any, any, any, any>, config: Omit<QueryFactoryConfig<TChildParams, TData, TError, TChildSelected, TPageParam, TCrawlOptions>, 'queryKey' | 'queryFn'> & {
     queryKey?: QueryKey;
     queryFn: NonNullable<QueryFactoryConfig<TChildParams, TData, TError, TChildSelected, TPageParam>['queryFn']>;
-} & ({
-    getNextPageParam: GetNextPageParamFunction<TPageParam, TData>;
-    initialPageParam: TPageParam;
-    getPreviousPageParam?: GetPreviousPageParamFunction<TPageParam, TData>;
-    shouldFetchNextPage?: (combined: TChildSelected | undefined, crawlOptions: TCrawlOptions) => boolean;
-    reduce?: (accumulator: TChildSelected | undefined, page: TData) => TChildSelected;
-} | {
-    getNextPageParam?: never;
-    initialPageParam?: never;
-    getPreviousPageParam?: never;
-    shouldFetchNextPage?: never;
-    reduce?: never;
-})): QueryFactory<TChildParams, TData, TError, TChildSelected, TPageParam, TCrawlOptions>;
+}): QueryFactory<TChildParams, TData, TError, TChildSelected, TPageParam, TCrawlOptions, boolean>;
 /**
  * Creates a child factory that reuses the parent's `queryFn` and pagination
  * config. Useful for adding a `select` transform, narrowing params, or
@@ -155,7 +141,7 @@ declare function queryFactory<TChildParams extends TParentParams, TData = unknow
  * without changing what data is fetched. Parent and child `select` functions
  * are automatically composed: `child.select(parent.select(data))`.
  */
-declare function queryFactory<TChildParams extends TParentParams, TData = unknown, TError = Error, TParentSelected = TData, TChildSelected = TParentSelected, TParentParams = TChildParams, TPageParam = unknown, TParentCrawlOptions extends Record<string, unknown> = Record<string, unknown>, TChildCrawlOptions extends Record<string, unknown> = TParentCrawlOptions>(parent: QueryFactory<TParentParams, TData, any, TParentSelected, TPageParam, TParentCrawlOptions>, config: StandardQueryOptions<TError, TData> & {
+declare function queryFactory<TChildParams extends TParentParams, TData = unknown, TError = Error, TParentSelected = TData, TChildSelected = TParentSelected, TParentParams = TChildParams, TPageParam = unknown, TParentCrawlOptions extends Record<string, unknown> = Record<string, unknown>, TChildCrawlOptions extends Record<string, unknown> = TParentCrawlOptions, TParentHasReduce extends boolean = boolean>(parent: QueryFactory<TParentParams, TData, any, TParentSelected, TPageParam, TParentCrawlOptions, TParentHasReduce>, config: StandardQueryOptions<TError, TData> & {
     queryKey?: QueryKey;
     queryFn?: never;
     select?: (data: TParentSelected) => TChildSelected;
@@ -163,7 +149,7 @@ declare function queryFactory<TChildParams extends TParentParams, TData = unknow
     initialPageParam?: TPageParam;
     getPreviousPageParam?: GetPreviousPageParamFunction<TPageParam, TData>;
     reduce?: (accumulator: TChildSelected | undefined, page: TData) => TChildSelected;
-    shouldFetchNextPage?: (combined: TChildSelected | undefined, crawlOptions: TChildCrawlOptions) => boolean;
-}): QueryFactory<TChildParams, TData, TError, TChildSelected, TPageParam, TChildCrawlOptions>;
+    shouldFetchNextPage?: (combined: TParentHasReduce extends true ? TChildSelected : TChildSelected | undefined, crawlOptions: TChildCrawlOptions) => boolean;
+}): QueryFactory<TChildParams, TData, TError, TChildSelected, TPageParam, TChildCrawlOptions, TParentHasReduce>;
 
 export { type QueryFactory, type QueryFactoryConfig, type ResolvedInfiniteOptions, type ResolvedQueryOptions, type StandardQueryOptions, queryFactory };

package/dist/index.d.ts

@@ -27,29 +27,25 @@ type QueryFactoryConfig<TParams = void, TData = unknown, TError = Error, TSelect
     /** Namespace segments. Params are appended as the final element at call time,
      *  giving a full key of [...namespace, 'infinite'?, params, crawlOptions?]. */
     queryKey: QueryKey;
-    queryFn?: (params: TParams, context: QueryFunctionContext<QueryKey, [unknown] extends [TPageParam] ? never : TPageParam>) => TData | Promise<TData>;
+    queryFn?: (params: TParams, context: QueryFunctionContext<QueryKey, [
+        unknown
+    ] extends [TPageParam] ? never : TPageParam>) => TData | Promise<TData>;
     select?: (data: TData) => TSelected;
-} & ({
     /** TanStack v5 generic order: GetNextPageParamFunction<TPageParam, TData> */
-    getNextPageParam: GetNextPageParamFunction<TPageParam, TData>;
-    /** Required alongside getNextPageParam — drives TPageParam inference so
-     *  ctx.pageParam in queryFn is typed as TPageParam, not unknown. */
-    initialPageParam: TPageParam;
+    getNextPageParam?: GetNextPageParamFunction<TPageParam, TData>;
+    /** Drives TPageParam inference so ctx.pageParam in queryFn is typed as TPageParam.
+     *  When omitted TPageParam stays unknown and ctx.pageParam is typed as never.
+     *  Required for .infinite() to work correctly at runtime. */
+    initialPageParam?: TPageParam;
     getPreviousPageParam?: GetPreviousPageParamFunction<TPageParam, TData>;
     /** Reduces crawled pages incrementally into the final query result.
      *  Called once per page; accumulator is undefined on the first call.
-     *  When set, enables crawling on both the regular and .infinite variants. */
+     *  When omitted, the crawl result is the last fetched page (TSelected = TData). */
     reduce?: (accumulator: TSelected | undefined, page: TData) => TSelected;
     /** Called after each page to decide whether to keep crawling.
-     *  `combined` may be undefined when reduce is absent. */
+     *  Required (along with getNextPageParam) to activate crawling. */
     shouldFetchNextPage?: (combined: TSelected | undefined, crawlOptions: TCrawlOptions) => boolean;
-} | {
-    getNextPageParam?: never;
-    initialPageParam?: never;
-    getPreviousPageParam?: never;
-    shouldFetchNextPage?: never;
-    reduce?: never;
-});
+};
 /**
  * What `factory(params)` returns — pass directly to `useQuery()`.
  *
@@ -95,7 +91,7 @@ type ResolvedInfiniteOptions<TData = unknown, TError = Error, TPageParam = unkno
  * namespace key, which is useful for broad cache invalidation:
  * `queryClient.invalidateQueries(factory())`
  */
-interface QueryFactory<TParams = void, TData = unknown, TError = Error, TSelected = TData, TPageParam = unknown, TCrawlOptions extends Record<string, unknown> = Record<string, unknown>> {
+interface QueryFactory<TParams = void, TData = unknown, TError = Error, TSelected = TData, TPageParam = unknown, TCrawlOptions extends Record<string, unknown> = Record<string, unknown>, THasReduce extends boolean = boolean> {
     (params?: TParams, crawlOptions?: TCrawlOptions): ResolvedQueryOptions<TData, TError, TSelected>;
     infinite(params?: TParams, crawlOptions?: TCrawlOptions): ResolvedInfiniteOptions<TData, TError, TPageParam>;
 }
@@ -106,14 +102,16 @@ interface QueryFactory<TParams = void, TData = unknown, TError = Error, TSelecte
  */
 declare function queryFactory<TParams = void, TData = unknown, TError = Error, TSelected = TData, TPageParam = unknown, TCrawlOptions extends Record<string, unknown> = Record<string, unknown>>(config: StandardQueryOptions<TError, TData> & {
     queryKey: QueryKey;
-    queryFn?: (params: TParams, context: QueryFunctionContext<QueryKey, [unknown] extends [TPageParam] ? never : TPageParam>) => TData | Promise<TData>;
+    queryFn?: (params: TParams, context: QueryFunctionContext<QueryKey, [
+        unknown
+    ] extends [TPageParam] ? never : TPageParam>) => TData | Promise<TData>;
     select?: (data: TData) => TSelected;
-    getNextPageParam: GetNextPageParamFunction<TPageParam, TData>;
-    initialPageParam: TPageParam;
+    getNextPageParam?: GetNextPageParamFunction<TPageParam, TData>;
+    initialPageParam?: TPageParam;
     getPreviousPageParam?: GetPreviousPageParamFunction<TPageParam, TData>;
     reduce: (accumulator: TSelected | undefined, page: TData) => TSelected;
     shouldFetchNextPage?: (combined: TSelected, crawlOptions: TCrawlOptions) => boolean;
-}): QueryFactory<TParams, TData, TError, TSelected, TPageParam, TCrawlOptions>;
+}): QueryFactory<TParams, TData, TError, TSelected, TPageParam, TCrawlOptions, true>;
 /**
  * Creates a standalone query factory from a config object.
  *
@@ -124,7 +122,7 @@ declare function queryFactory<TParams = void, TData = unknown, TError = Error, T
  * });
  * // useQuery(usersFactory({ page: 1 }))
  */
-declare function queryFactory<TParams = void, TData = unknown, TError = Error, TSelected = TData, TPageParam = unknown, TCrawlOptions extends Record<string, unknown> = Record<string, unknown>>(config: QueryFactoryConfig<TParams, TData, TError, TSelected, TPageParam, TCrawlOptions>): QueryFactory<TParams, TData, TError, TSelected, TPageParam, TCrawlOptions>;
+declare function queryFactory<TParams = void, TData = unknown, TError = Error, TSelected = TData, TPageParam = unknown, TCrawlOptions extends Record<string, unknown> = Record<string, unknown>>(config: QueryFactoryConfig<TParams, TData, TError, TSelected, TPageParam, TCrawlOptions>): QueryFactory<TParams, TData, TError, TSelected, TPageParam, TCrawlOptions, false>;
 /**
  * Creates a child factory that inherits the query key and standard options from
  * `parent` and introduces a new `queryFn`. The child's query key is appended to
@@ -132,22 +130,10 @@ declare function queryFactory<TParams = void, TData = unknown, TError = Error, T
  *
  * Use this overload when the child fetches different data than the parent.
  */
-declare function queryFactory<TChildParams extends TParentParams, TData = unknown, TError = Error, TChildSelected = TData, TParentParams = TChildParams, TPageParam = unknown, TCrawlOptions extends Record<string, unknown> = Record<string, unknown>>(parent: QueryFactory<TParentParams, any, any, any, any, any>, config: Omit<QueryFactoryConfig<TChildParams, TData, TError, TChildSelected, TPageParam, TCrawlOptions>, 'queryKey' | 'getNextPageParam' | 'getPreviousPageParam' | 'initialPageParam' | 'shouldFetchNextPage' | 'reduce'> & {
+declare function queryFactory<TChildParams extends TParentParams, TData = unknown, TError = Error, TChildSelected = TData, TParentParams = TChildParams, TPageParam = unknown, TCrawlOptions extends Record<string, unknown> = Record<string, unknown>>(parent: QueryFactory<TParentParams, any, any, any, any, any, any>, config: Omit<QueryFactoryConfig<TChildParams, TData, TError, TChildSelected, TPageParam, TCrawlOptions>, 'queryKey' | 'queryFn'> & {
     queryKey?: QueryKey;
     queryFn: NonNullable<QueryFactoryConfig<TChildParams, TData, TError, TChildSelected, TPageParam>['queryFn']>;
-} & ({
-    getNextPageParam: GetNextPageParamFunction<TPageParam, TData>;
-    initialPageParam: TPageParam;
-    getPreviousPageParam?: GetPreviousPageParamFunction<TPageParam, TData>;
-    shouldFetchNextPage?: (combined: TChildSelected | undefined, crawlOptions: TCrawlOptions) => boolean;
-    reduce?: (accumulator: TChildSelected | undefined, page: TData) => TChildSelected;
-} | {
-    getNextPageParam?: never;
-    initialPageParam?: never;
-    getPreviousPageParam?: never;
-    shouldFetchNextPage?: never;
-    reduce?: never;
-})): QueryFactory<TChildParams, TData, TError, TChildSelected, TPageParam, TCrawlOptions>;
+}): QueryFactory<TChildParams, TData, TError, TChildSelected, TPageParam, TCrawlOptions, boolean>;
 /**
  * Creates a child factory that reuses the parent's `queryFn` and pagination
  * config. Useful for adding a `select` transform, narrowing params, or
@@ -155,7 +141,7 @@ declare function queryFactory<TChildParams extends TParentParams, TData = unknow
  * without changing what data is fetched. Parent and child `select` functions
  * are automatically composed: `child.select(parent.select(data))`.
  */
-declare function queryFactory<TChildParams extends TParentParams, TData = unknown, TError = Error, TParentSelected = TData, TChildSelected = TParentSelected, TParentParams = TChildParams, TPageParam = unknown, TParentCrawlOptions extends Record<string, unknown> = Record<string, unknown>, TChildCrawlOptions extends Record<string, unknown> = TParentCrawlOptions>(parent: QueryFactory<TParentParams, TData, any, TParentSelected, TPageParam, TParentCrawlOptions>, config: StandardQueryOptions<TError, TData> & {
+declare function queryFactory<TChildParams extends TParentParams, TData = unknown, TError = Error, TParentSelected = TData, TChildSelected = TParentSelected, TParentParams = TChildParams, TPageParam = unknown, TParentCrawlOptions extends Record<string, unknown> = Record<string, unknown>, TChildCrawlOptions extends Record<string, unknown> = TParentCrawlOptions, TParentHasReduce extends boolean = boolean>(parent: QueryFactory<TParentParams, TData, any, TParentSelected, TPageParam, TParentCrawlOptions, TParentHasReduce>, config: StandardQueryOptions<TError, TData> & {
     queryKey?: QueryKey;
     queryFn?: never;
     select?: (data: TParentSelected) => TChildSelected;
@@ -163,7 +149,7 @@ declare function queryFactory<TChildParams extends TParentParams, TData = unknow
     initialPageParam?: TPageParam;
     getPreviousPageParam?: GetPreviousPageParamFunction<TPageParam, TData>;
     reduce?: (accumulator: TChildSelected | undefined, page: TData) => TChildSelected;
-    shouldFetchNextPage?: (combined: TChildSelected | undefined, crawlOptions: TChildCrawlOptions) => boolean;
-}): QueryFactory<TChildParams, TData, TError, TChildSelected, TPageParam, TChildCrawlOptions>;
+    shouldFetchNextPage?: (combined: TParentHasReduce extends true ? TChildSelected : TChildSelected | undefined, crawlOptions: TChildCrawlOptions) => boolean;
+}): QueryFactory<TChildParams, TData, TError, TChildSelected, TPageParam, TChildCrawlOptions, TParentHasReduce>;
 
 export { type QueryFactory, type QueryFactoryConfig, type ResolvedInfiniteOptions, type ResolvedQueryOptions, type StandardQueryOptions, queryFactory };

package/dist/index.js

@@ -26,35 +26,44 @@ module.exports = __toCommonJS(index_exports);
 
 // src/queryFactory.ts
 var FACTORY_CONFIG = /* @__PURE__ */ Symbol("factoryConfig");
+var getEnvelopeNextPageParam = (envelope) => envelope.nextPageParam;
+var noNextPage = () => void 0;
 function resolveKey(namespace, params, crawlOptions) {
   const base = Array.isArray(namespace) ? namespace : [namespace];
   const withParams = params === void 0 ? base : [...base, params];
   if (!crawlOptions) return withParams;
-  const defined = Object.fromEntries(Object.entries(crawlOptions).filter(([, v]) => v !== void 0));
-  return Object.keys(defined).length > 0 ? [...withParams, defined] : withParams;
+  let defined;
+  for (const key in crawlOptions) {
+    if (crawlOptions[key] !== void 0) {
+      (defined != null ? defined : defined = {})[key] = crawlOptions[key];
+    }
+  }
+  return defined ? [...withParams, defined] : withParams;
 }
-function wrapGetNextPageParam(getNextPageParam, shouldFetchNextPage, crawlOptions, reduce) {
+function wrapGetNextPageParam(getNextPageParam, shouldFetchNextPage, crawlOptions) {
   return (lastPage, allPages, lastPageParam, allPageParams) => {
-    const combined = reduce ? allPages.reduce((acc, page) => reduce(acc, page), void 0) : lastPage;
-    if (!shouldFetchNextPage(combined, crawlOptions)) return void 0;
+    if (!shouldFetchNextPage(lastPage, crawlOptions))
+      return void 0;
     return getNextPageParam(lastPage, allPages, lastPageParam, allPageParams);
   };
 }
-function buildCrawlingQueryFn(queryFn, getNextPageParam, initialPageParam, shouldFetchNextPage, reduce, crawlOptions) {
-  return async (context) => {
+function buildCrawlingQueryFn(queryFn, getNextPageParam, initialPageParam, shouldFetchNextPage, reduce) {
+  return async (params, crawlOptions, context) => {
     var _a, _b;
     const pages = [];
     const pageParams = [];
     let currentParam = initialPageParam;
     let acc = void 0;
+    const ctx = { ...context, pageParam: currentParam };
     while (true) {
       if ((_a = context.signal) == null ? void 0 : _a.aborted) break;
-      const page = await queryFn({ ...context, pageParam: currentParam });
+      ctx.pageParam = currentParam;
+      const page = await queryFn(params, ctx);
       pages.push(page);
       pageParams.push(currentParam);
       if (reduce) acc = reduce(acc, page);
       if ((_b = context.signal) == null ? void 0 : _b.aborted) break;
-      if (shouldFetchNextPage && !shouldFetchNextPage(acc, crawlOptions)) break;
+      if (!shouldFetchNextPage(acc, crawlOptions)) break;
       const nextParam = getNextPageParam(page, pages, currentParam, pageParams);
       if (nextParam == null) break;
       currentParam = nextParam;
@@ -66,17 +75,19 @@ function buildCrawlingQueryFn(queryFn, getNextPageParam, initialPageParam, shoul
     return pages;
   };
 }
-function buildInfiniteCrawlingQueryFn(queryFn, getNextPageParam, shouldFetchNextPage, reduce, crawlOptions) {
-  return async (context) => {
+function buildInfiniteCrawlingQueryFn(queryFn, getNextPageParam, shouldFetchNextPage, reduce) {
+  return async (params, crawlOptions, context) => {
     var _a, _b;
     const pages = [];
     const pageParams = [];
     let currentParam = context.pageParam;
     let acc = void 0;
     let nextBatchParam = null;
+    const ctx = { ...context, pageParam: currentParam };
     while (true) {
       if ((_a = context.signal) == null ? void 0 : _a.aborted) break;
-      const page = await queryFn({ ...context, pageParam: currentParam });
+      ctx.pageParam = currentParam;
+      const page = await queryFn(params, ctx);
       pages.push(page);
       pageParams.push(currentParam);
       acc = reduce(acc, page);
@@ -84,7 +95,7 @@ function buildInfiniteCrawlingQueryFn(queryFn, getNextPageParam, shouldFetchNext
       const nextParam = getNextPageParam(page, pages, currentParam, pageParams);
       nextBatchParam = nextParam != null ? nextParam : null;
       if (nextParam == null) break;
-      if (shouldFetchNextPage && !shouldFetchNextPage(acc, crawlOptions)) break;
+      if (!shouldFetchNextPage(acc, crawlOptions)) break;
       currentParam = nextParam;
     }
     if (acc === void 0) throw new DOMException("Aborted", "AbortError");
@@ -103,12 +114,33 @@ function buildFactory(cfg) {
     reduce,
     standardOptions
   } = cfg;
-  const hasCrawling = rawQueryFn !== void 0 && getNextPageParam !== void 0;
+  const hasCrawling = rawQueryFn !== void 0 && getNextPageParam !== void 0 && shouldFetchNextPage !== void 0;
   const hasInfiniteCrawling = hasCrawling && reduce !== void 0;
+  const crawlingFn = hasCrawling ? buildCrawlingQueryFn(
+    rawQueryFn,
+    getNextPageParam,
+    initialPageParam,
+    shouldFetchNextPage,
+    reduce
+  ) : void 0;
+  const infiniteCrawlingFn = hasInfiniteCrawling ? buildInfiniteCrawlingQueryFn(
+    rawQueryFn,
+    getNextPageParam,
+    shouldFetchNextPage,
+    reduce
+  ) : void 0;
+  const infiniteNamespace = [...resolveKey(namespace, void 0), "infinite"];
+  const envelopeSelect = infiniteCrawlingFn ? (data) => ({
+    ...data,
+    pages: data.pages.map((e) => select ? select(e.data) : e.data)
+  }) : void 0;
+  const infiniteSelect = !infiniteCrawlingFn && select ? (data) => ({
+    ...data,
+    pages: data.pages.map(select)
+  }) : void 0;
   const factory = function(params, crawlOptions = {}) {
     const queryKey = resolveKey(namespace, params, crawlOptions);
-    const boundQueryFn = rawQueryFn ? (ctx) => rawQueryFn(params, ctx) : void 0;
-    const resolvedQueryFn = hasCrawling ? buildCrawlingQueryFn(boundQueryFn, getNextPageParam, initialPageParam, shouldFetchNextPage, reduce, crawlOptions) : boundQueryFn;
+    const resolvedQueryFn = crawlingFn ? (ctx) => crawlingFn(params, crawlOptions, ctx) : rawQueryFn ? (ctx) => rawQueryFn(params, ctx) : void 0;
     return {
       ...standardOptions,
       queryKey,
@@ -118,37 +150,25 @@ function buildFactory(cfg) {
     };
   };
   factory.infinite = function(params, crawlOptions = {}) {
-    const queryKey = resolveKey([...resolveKey(namespace, void 0), "infinite"], params, crawlOptions);
-    const boundQueryFn = rawQueryFn ? (ctx) => rawQueryFn(params, ctx) : void 0;
-    if (hasInfiniteCrawling) {
-      const crawlingQueryFn = buildInfiniteCrawlingQueryFn(
-        boundQueryFn,
-        getNextPageParam,
-        shouldFetchNextPage,
-        reduce,
-        crawlOptions
-      );
-      const envelopeGetNextPageParam = (envelope) => envelope.nextPageParam;
-      const envelopeSelect = (data) => ({
-        ...data,
-        pages: data.pages.map((e) => select ? select(e.data) : e.data)
-      });
+    const queryKey = resolveKey(infiniteNamespace, params, crawlOptions);
+    if (infiniteCrawlingFn) {
       return {
         ...standardOptions,
         queryKey,
-        queryFn: crawlingQueryFn,
-        getNextPageParam: envelopeGetNextPageParam,
+        queryFn: (ctx) => infiniteCrawlingFn(params, crawlOptions, ctx),
+        getNextPageParam: getEnvelopeNextPageParam,
         initialPageParam,
         select: envelopeSelect,
         ...getPreviousPageParam !== void 0 && { getPreviousPageParam },
         [FACTORY_CONFIG]: cfg
       };
     }
-    const infiniteGetNextPageParam = getNextPageParam && shouldFetchNextPage ? wrapGetNextPageParam(getNextPageParam, shouldFetchNextPage, crawlOptions, reduce) : getNextPageParam != null ? getNextPageParam : (() => void 0);
-    const infiniteSelect = select ? (data) => ({
-      ...data,
-      pages: data.pages.map(select)
-    }) : void 0;
+    const boundQueryFn = rawQueryFn ? (ctx) => rawQueryFn(params, ctx) : void 0;
+    const infiniteGetNextPageParam = getNextPageParam && shouldFetchNextPage ? wrapGetNextPageParam(
+      getNextPageParam,
+      shouldFetchNextPage,
+      crawlOptions
+    ) : getNextPageParam != null ? getNextPageParam : noNextPage;
     return {
       ...standardOptions,
       queryKey,
@@ -168,11 +188,16 @@ function queryFactory(configOrParent, childConfig) {
     const result = configOrParent();
     const parentCfg = result == null ? void 0 : result[FACTORY_CONFIG];
     if (!parentCfg) {
-      throw new Error("queryFactory: first argument must be a factory created by queryFactory()");
+      throw new Error(
+        "queryFactory: first argument must be a factory created by queryFactory()"
+      );
     }
     const hasNewQueryFn = childConfig.queryFn !== void 0;
     const childNamespace = childConfig.queryKey ? Array.isArray(childConfig.queryKey) ? childConfig.queryKey : [childConfig.queryKey] : [];
-    const composedNamespace = [...parentCfg.queryKey, ...childNamespace];
+    const composedNamespace = [
+      ...parentCfg.queryKey,
+      ...childNamespace
+    ];
     let resolvedSelect;
     if (hasNewQueryFn) {
       resolvedSelect = childConfig.select;
@@ -212,7 +237,10 @@ function queryFactory(configOrParent, childConfig) {
       queryFn: hasNewQueryFn ? childConfig.queryFn : parentCfg.queryFn,
       select: resolvedSelect,
       ...crawling,
-      standardOptions: { ...parentCfg.standardOptions, ...childStandardOptions }
+      standardOptions: {
+        ...parentCfg.standardOptions,
+        ...childStandardOptions
+      }
     });
   }
   const {

package/dist/index.mjs

@@ -1,34 +1,43 @@
 // src/queryFactory.ts
 var FACTORY_CONFIG = /* @__PURE__ */ Symbol("factoryConfig");
+var getEnvelopeNextPageParam = (envelope) => envelope.nextPageParam;
+var noNextPage = () => void 0;
 function resolveKey(namespace, params, crawlOptions) {
   const base = Array.isArray(namespace) ? namespace : [namespace];
   const withParams = params === void 0 ? base : [...base, params];
   if (!crawlOptions) return withParams;
-  const defined = Object.fromEntries(Object.entries(crawlOptions).filter(([, v]) => v !== void 0));
-  return Object.keys(defined).length > 0 ? [...withParams, defined] : withParams;
+  let defined;
+  for (const key in crawlOptions) {
+    if (crawlOptions[key] !== void 0) {
+      (defined != null ? defined : defined = {})[key] = crawlOptions[key];
+    }
+  }
+  return defined ? [...withParams, defined] : withParams;
 }
-function wrapGetNextPageParam(getNextPageParam, shouldFetchNextPage, crawlOptions, reduce) {
+function wrapGetNextPageParam(getNextPageParam, shouldFetchNextPage, crawlOptions) {
   return (lastPage, allPages, lastPageParam, allPageParams) => {
-    const combined = reduce ? allPages.reduce((acc, page) => reduce(acc, page), void 0) : lastPage;
-    if (!shouldFetchNextPage(combined, crawlOptions)) return void 0;
+    if (!shouldFetchNextPage(lastPage, crawlOptions))
+      return void 0;
     return getNextPageParam(lastPage, allPages, lastPageParam, allPageParams);
   };
 }
-function buildCrawlingQueryFn(queryFn, getNextPageParam, initialPageParam, shouldFetchNextPage, reduce, crawlOptions) {
-  return async (context) => {
+function buildCrawlingQueryFn(queryFn, getNextPageParam, initialPageParam, shouldFetchNextPage, reduce) {
+  return async (params, crawlOptions, context) => {
     var _a, _b;
     const pages = [];
     const pageParams = [];
     let currentParam = initialPageParam;
     let acc = void 0;
+    const ctx = { ...context, pageParam: currentParam };
     while (true) {
       if ((_a = context.signal) == null ? void 0 : _a.aborted) break;
-      const page = await queryFn({ ...context, pageParam: currentParam });
+      ctx.pageParam = currentParam;
+      const page = await queryFn(params, ctx);
       pages.push(page);
       pageParams.push(currentParam);
       if (reduce) acc = reduce(acc, page);
       if ((_b = context.signal) == null ? void 0 : _b.aborted) break;
-      if (shouldFetchNextPage && !shouldFetchNextPage(acc, crawlOptions)) break;
+      if (!shouldFetchNextPage(acc, crawlOptions)) break;
       const nextParam = getNextPageParam(page, pages, currentParam, pageParams);
       if (nextParam == null) break;
       currentParam = nextParam;
@@ -40,17 +49,19 @@ function buildCrawlingQueryFn(queryFn, getNextPageParam, initialPageParam, shoul
     return pages;
   };
 }
-function buildInfiniteCrawlingQueryFn(queryFn, getNextPageParam, shouldFetchNextPage, reduce, crawlOptions) {
-  return async (context) => {
+function buildInfiniteCrawlingQueryFn(queryFn, getNextPageParam, shouldFetchNextPage, reduce) {
+  return async (params, crawlOptions, context) => {
     var _a, _b;
     const pages = [];
     const pageParams = [];
     let currentParam = context.pageParam;
     let acc = void 0;
     let nextBatchParam = null;
+    const ctx = { ...context, pageParam: currentParam };
     while (true) {
       if ((_a = context.signal) == null ? void 0 : _a.aborted) break;
-      const page = await queryFn({ ...context, pageParam: currentParam });
+      ctx.pageParam = currentParam;
+      const page = await queryFn(params, ctx);
       pages.push(page);
       pageParams.push(currentParam);
       acc = reduce(acc, page);
@@ -58,7 +69,7 @@ function buildInfiniteCrawlingQueryFn(queryFn, getNextPageParam, shouldFetchNext
       const nextParam = getNextPageParam(page, pages, currentParam, pageParams);
       nextBatchParam = nextParam != null ? nextParam : null;
       if (nextParam == null) break;
-      if (shouldFetchNextPage && !shouldFetchNextPage(acc, crawlOptions)) break;
+      if (!shouldFetchNextPage(acc, crawlOptions)) break;
       currentParam = nextParam;
     }
     if (acc === void 0) throw new DOMException("Aborted", "AbortError");
@@ -77,12 +88,33 @@ function buildFactory(cfg) {
     reduce,
     standardOptions
   } = cfg;
-  const hasCrawling = rawQueryFn !== void 0 && getNextPageParam !== void 0;
+  const hasCrawling = rawQueryFn !== void 0 && getNextPageParam !== void 0 && shouldFetchNextPage !== void 0;
   const hasInfiniteCrawling = hasCrawling && reduce !== void 0;
+  const crawlingFn = hasCrawling ? buildCrawlingQueryFn(
+    rawQueryFn,
+    getNextPageParam,
+    initialPageParam,
+    shouldFetchNextPage,
+    reduce
+  ) : void 0;
+  const infiniteCrawlingFn = hasInfiniteCrawling ? buildInfiniteCrawlingQueryFn(
+    rawQueryFn,
+    getNextPageParam,
+    shouldFetchNextPage,
+    reduce
+  ) : void 0;
+  const infiniteNamespace = [...resolveKey(namespace, void 0), "infinite"];
+  const envelopeSelect = infiniteCrawlingFn ? (data) => ({
+    ...data,
+    pages: data.pages.map((e) => select ? select(e.data) : e.data)
+  }) : void 0;
+  const infiniteSelect = !infiniteCrawlingFn && select ? (data) => ({
+    ...data,
+    pages: data.pages.map(select)
+  }) : void 0;
   const factory = function(params, crawlOptions = {}) {
     const queryKey = resolveKey(namespace, params, crawlOptions);
-    const boundQueryFn = rawQueryFn ? (ctx) => rawQueryFn(params, ctx) : void 0;
-    const resolvedQueryFn = hasCrawling ? buildCrawlingQueryFn(boundQueryFn, getNextPageParam, initialPageParam, shouldFetchNextPage, reduce, crawlOptions) : boundQueryFn;
+    const resolvedQueryFn = crawlingFn ? (ctx) => crawlingFn(params, crawlOptions, ctx) : rawQueryFn ? (ctx) => rawQueryFn(params, ctx) : void 0;
     return {
       ...standardOptions,
       queryKey,
@@ -92,37 +124,25 @@ function buildFactory(cfg) {
     };
   };
   factory.infinite = function(params, crawlOptions = {}) {
-    const queryKey = resolveKey([...resolveKey(namespace, void 0), "infinite"], params, crawlOptions);
-    const boundQueryFn = rawQueryFn ? (ctx) => rawQueryFn(params, ctx) : void 0;
-    if (hasInfiniteCrawling) {
-      const crawlingQueryFn = buildInfiniteCrawlingQueryFn(
-        boundQueryFn,
-        getNextPageParam,
-        shouldFetchNextPage,
-        reduce,
-        crawlOptions
-      );
-      const envelopeGetNextPageParam = (envelope) => envelope.nextPageParam;
-      const envelopeSelect = (data) => ({
-        ...data,
-        pages: data.pages.map((e) => select ? select(e.data) : e.data)
-      });
+    const queryKey = resolveKey(infiniteNamespace, params, crawlOptions);
+    if (infiniteCrawlingFn) {
       return {
         ...standardOptions,
         queryKey,
-        queryFn: crawlingQueryFn,
-        getNextPageParam: envelopeGetNextPageParam,
+        queryFn: (ctx) => infiniteCrawlingFn(params, crawlOptions, ctx),
+        getNextPageParam: getEnvelopeNextPageParam,
         initialPageParam,
         select: envelopeSelect,
         ...getPreviousPageParam !== void 0 && { getPreviousPageParam },
         [FACTORY_CONFIG]: cfg
       };
     }
-    const infiniteGetNextPageParam = getNextPageParam && shouldFetchNextPage ? wrapGetNextPageParam(getNextPageParam, shouldFetchNextPage, crawlOptions, reduce) : getNextPageParam != null ? getNextPageParam : (() => void 0);
-    const infiniteSelect = select ? (data) => ({
-      ...data,
-      pages: data.pages.map(select)
-    }) : void 0;
+    const boundQueryFn = rawQueryFn ? (ctx) => rawQueryFn(params, ctx) : void 0;
+    const infiniteGetNextPageParam = getNextPageParam && shouldFetchNextPage ? wrapGetNextPageParam(
+      getNextPageParam,
+      shouldFetchNextPage,
+      crawlOptions
+    ) : getNextPageParam != null ? getNextPageParam : noNextPage;
     return {
       ...standardOptions,
       queryKey,
@@ -142,11 +162,16 @@ function queryFactory(configOrParent, childConfig) {
     const result = configOrParent();
     const parentCfg = result == null ? void 0 : result[FACTORY_CONFIG];
     if (!parentCfg) {
-      throw new Error("queryFactory: first argument must be a factory created by queryFactory()");
+      throw new Error(
+        "queryFactory: first argument must be a factory created by queryFactory()"
+      );
     }
     const hasNewQueryFn = childConfig.queryFn !== void 0;
     const childNamespace = childConfig.queryKey ? Array.isArray(childConfig.queryKey) ? childConfig.queryKey : [childConfig.queryKey] : [];
-    const composedNamespace = [...parentCfg.queryKey, ...childNamespace];
+    const composedNamespace = [
+      ...parentCfg.queryKey,
+      ...childNamespace
+    ];
     let resolvedSelect;
     if (hasNewQueryFn) {
       resolvedSelect = childConfig.select;
@@ -186,7 +211,10 @@ function queryFactory(configOrParent, childConfig) {
       queryFn: hasNewQueryFn ? childConfig.queryFn : parentCfg.queryFn,
       select: resolvedSelect,
       ...crawling,
-      standardOptions: { ...parentCfg.standardOptions, ...childStandardOptions }
+      standardOptions: {
+        ...parentCfg.standardOptions,
+        ...childStandardOptions
+      }
     });
   }
   const {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@robohall/react-query-factory",
-  "version": "1.0.4",
+  "version": "1.1.0",
   "description": "A factory abstraction for TanStack Query (React Query) with composable keys, crawling support, and automatic infinite query generation",
   "author": "Robert Hall",
   "license": "MIT",