@emeryld/rrroutes-client 2.3.10 → 2.3.12

package/dist/routesV3.client.types.d.ts

@@ -91,10 +91,6 @@ export type RouteClientOptions<Names extends string = string> = {
     fetcher?: Fetcher;
     /** Shared React Query client used for caching/invalidation. */
     queryClient: QueryClient;
-    /** Query string key used for pagination cursors (default: "cursor"). */
-    cursorParam?: string;
-    /** Function that extracts the next cursor from an infinite query page. */
-    getNextCursor?: (page: unknown) => Cursor;
     /** Optional debug logger for verbose insights (supports minimal/complete modes). */
     debug?: RouteClientDebugOptions<Names>;
     /**
@@ -112,7 +108,7 @@ type UseEndpointResult<L extends AnyLeafLowProfile, Result> = Result & {
 /** Variadic args consumed by the direct fetch helper: optional args + body. */
 export type MutationFetchArgs<L extends AnyLeafLowProfile> = Prettify<[
     ...ArgsTuple<L>,
-    InferBody<L>
+    InferBody<L, undefined>
 ]>;
 /** Signature for the fetch helper returned by mutation builds. */
 export type MutationFetcher<L extends AnyLeafLowProfile> = (...args: MutationFetchArgs<L>) => Promise<InferOutput<L>>;
@@ -149,10 +145,8 @@ type QueryFromArgs<L extends AnyLeafLowProfile, T extends ArgsTuple<L>> = ArgsFr
 } ? Q : undefined;
 /** Typed query key array derived from the leaf plus the specific args passed in. */
 type SplitUrl<L extends string> = L extends `/${infer A}` ? SplitUrl<A> : L extends `${infer A}/${infer B}` ? [A, ...SplitUrl<B>] : [L];
-type MapParams<P extends any[], Params> = P extends [infer A, ...infer Rest] ? A extends `:${infer Key}` ? [
-    Params extends Record<Key, infer V> ? (string extends V ? A : V) : A,
-    ...MapParams<Rest, Params>
-] : [A, ...MapParams<Rest, Params>] : [];
+type ParamValue<Params, Key extends string, Default = undefined> = Params extends Record<Key, infer V> ? V : Default;
+type MapParams<P extends any[], Params> = P extends [infer A, ...infer Rest] ? A extends `:${infer Key}` ? [[ParamValue<Params, Key>], ...MapParams<Rest, Params>] : [A, ...MapParams<Rest, Params>] : [];
 export type QueryKeysFor<L extends AnyLeafLowProfile, T extends ArgsTuple<L>> = Prettify<readonly [
     L['method'],
     ...MapParams<SplitUrl<L['path']>, ParamsFromArgs<L, T>>,
@@ -164,7 +158,21 @@ export type QueryBuildOptionsFor<L extends AnyLeafLowProfile> = Omit<UseQueryOpt
     onReceive?: OnReceive<L>;
 };
 /** Build options for feed-style GET leaves (`cfg.feed === true`). */
-export type InfiniteBuildOptionsFor<L extends AnyLeafLowProfile> = Omit<UseInfiniteQueryOptions<InferOutput<L>, unknown, InfiniteData<InferOutput<L>>, QueryKey, Cursor>, 'queryKey' | 'queryFn' | 'initialPageParam' | 'getNextPageParam'> & {
+export type InfiniteBuildOptionsFor<L extends AnyLeafLowProfile> = Omit<UseInfiniteQueryOptions<InferOutput<L>, unknown, InfiniteData<InferOutput<L>>, QueryKey, Cursor>, 'queryKey' | 'queryFn' | 'getNextPageParam' | 'initialPageParam'> & {
+    /**
+     * Query string parameter that carries pagination cursors. Defaults to "pagination_cursor".
+     */
+    cursorParam?: string;
+    /**
+     * Override the initial cursor passed to React Query's `useInfiniteQuery`.
+     * Defaults to `undefined`.
+     */
+    initialPageParam?: Cursor;
+    /**
+     * Override how the next cursor is derived from the last page.
+     * Defaults to a helper that looks for `page.nextCursor` or `page.meta.nextCursor`.
+     */
+    getNextPageParam?: (lastPage: InferOutput<L>) => Cursor;
     /** Hook invoked after a successful fetch + validation. */
     onReceive?: OnReceive<L>;
 };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@emeryld/rrroutes-client",
-  "version": "2.3.10",
+  "version": "2.3.12",
   "private": false,
   "type": "module",
   "main": "dist/index.cjs",
@@ -19,7 +19,7 @@
     "dist"
   ],
   "dependencies": {
-    "@emeryld/rrroutes-contract": "^2.4.14",
+    "@emeryld/rrroutes-contract": "^2.4.18",
     "zod": "^4.1.13"
   },
   "peerDependencies": {