@classytic/arc-next 0.2.1 → 0.3.1

package/dist/hooks.js

@@ -2,16 +2,18 @@
 
 import { getAuthContext, getAuthMode } from "./client.js";
 import { isKeysetPagination, isOffsetPagination } from "./api.js";
-import { DEFAULT_QUERY_CONFIG, createCacheUtils, createDetailQuery, createInfiniteListQuery, createListQuery, createQueryKeys, getItemId, updateListCache } from "./query.js";
-import { createOptimisticMutation, useMutationWithTransition } from "./mutation.js";
+import { DEFAULT_QUERY_CONFIG, createCacheUtils, createQueryKeys, extractItem, getItemId, updateListCache, useDetailQuery, useInfiniteListQuery, useListQuery } from "./query.js";
+import { useMutationWithTransition, useOptimisticMutation } from "./mutation.js";
 import { useMutation, useQueryClient } from "@tanstack/react-query";
-import { useCallback, useRef } from "react";
+import { useCallback, useMemo, useRef } from "react";
 
 //#region src/hooks.ts
 let useRouterHook = null;
 /**
 * Configure the router hook for useNavigation. Call once at app init.
 *
+* **SSR safety:** This sets module-level state. Call only in client-side code.
+*
 * @example
 * import { useRouter } from "next/navigation";
 * configureNavigation(useRouter);
@@ -19,16 +21,16 @@ let useRouterHook = null;
 function configureNavigation(hook) {
 	useRouterHook = hook;
 }
-function createEnabledRule(token, options) {
-	if (getAuthMode() === "cookie" || options.public) return options.enabled ?? true;
+function createEnabledRule(token, options, authMode = getAuthMode()) {
+	if (authMode === "cookie" || options.public) return options.enabled ?? true;
 	return options.enabled !== void 0 ? options.enabled && !!token : !!token;
 }
-function createCrudHooks({ api, entityKey, singular, platformScoped, defaults = {}, callbacks = {}, client }) {
-	const isPlatform = platformScoped ?? api.scope === "platform";
+function createCrudHooks({ api, entityKey, singular, defaults = {}, callbacks = {}, client }) {
 	const KEYS = createQueryKeys(entityKey);
 	const cache = createCacheUtils(KEYS);
 	const instanceToast = client?.toast;
 	const instanceNavigation = client?.navigation ?? null;
+	const resolveAuthMode = () => client?.config?.authMode ?? getAuthMode();
 	const config = {
 		...DEFAULT_QUERY_CONFIG,
 		...defaults,
@@ -56,15 +58,15 @@ function createCrudHooks({ api, entityKey, singular, platformScoped, defaults =
 			token = auth.token;
 			params = tokenOrParams ?? {};
 			options = paramsOrOptions ?? {};
-			if (!isPlatform && auth.organizationId && !params.organizationId) params = {
+			if (auth.organizationId && !params.organizationId) params = {
 				...params,
 				organizationId: auth.organizationId
 			};
 		}
 		const { organizationId, ...restParams } = params;
-		const scope = options._scope || (isPlatform ? "platform" : organizationId ? "tenant" : "super-admin");
+		const scope = options._scope || (organizationId ? "tenant" : "super-admin");
 		const { request: requestOpts, ...queryOpts } = options;
-		return createListQuery({
+		return useListQuery({
 			queryKey: KEYS.scopedList(scope, {
 				organizationId,
 				...restParams
@@ -78,7 +80,7 @@ function createCrudHooks({ api, entityKey, singular, platformScoped, defaults =
 					...requestOpts
 				}
 			}),
-			enabled: createEnabledRule(token, queryOpts),
+			enabled: createEnabledRule(token, queryOpts, resolveAuthMode()),
 			options: {
 				staleTime: queryOpts.staleTime ?? config.staleTime,
 				gcTime: queryOpts.gcTime ?? config.gcTime,
@@ -102,13 +104,13 @@ function createCrudHooks({ api, entityKey, singular, platformScoped, defaults =
 			const auth = getAuthContext();
 			token = auth.token;
 			options = tokenOrOptions ?? {};
-			if (!isPlatform && auth.organizationId && !options.organizationId) options = {
+			if (auth.organizationId && !options.organizationId) options = {
 				...options,
 				organizationId: auth.organizationId
 			};
 		}
 		const { organizationId, params: queryParams, request: requestOpts, ...restOptions } = options;
-		return createDetailQuery({
+		return useDetailQuery({
 			queryKey: queryParams ? [...KEYS.detail(id || ""), queryParams] : KEYS.detail(id || ""),
 			queryFn: ({ signal }) => api.getById({
 				id,
@@ -120,10 +122,11 @@ function createCrudHooks({ api, entityKey, singular, platformScoped, defaults =
 					...requestOpts
 				}
 			}),
-			enabled: !!id && createEnabledRule(token, restOptions),
+			enabled: !!id && createEnabledRule(token, restOptions, resolveAuthMode()),
 			options: {
 				staleTime: restOptions.staleTime ?? config.staleTime,
 				gcTime: restOptions.gcTime ?? config.gcTime,
+				refetchOnWindowFocus: restOptions.refetchOnWindowFocus ?? config.refetchOnWindowFocus,
 				structuralSharing: restOptions.structuralSharing ?? config.structuralSharing,
 				refetchInterval: restOptions.refetchInterval,
 				refetchIntervalInBackground: restOptions.refetchIntervalInBackground
@@ -135,7 +138,7 @@ function createCrudHooks({ api, entityKey, singular, platformScoped, defaults =
 		const queryClient = useQueryClient();
 		const silentRef = useRef(false);
 		const shouldToast = useCallback(() => !silentRef.current, []);
-		const createMutation = createOptimisticMutation({
+		const createMutation = useOptimisticMutation({
 			mutationFn: ({ token, organizationId, data }) => api.create({
 				token,
 				organizationId,
@@ -152,14 +155,14 @@ function createCrudHooks({ api, entityKey, singular, platformScoped, defaults =
 				};
 				return updateListCache(oldData, (arr) => [optimisticItem, ...arr || []]);
 			},
-			onSuccess: (data, variables) => {
-				callbacks.onCreate?.onSuccess?.(data, { data: variables.data }, void 0);
+			onSuccess: (raw, variables) => {
+				callbacks.onCreate?.onSuccess?.(extractItem(raw), { data: variables.data }, void 0);
 			},
 			onError: (error, variables) => {
 				callbacks.onCreate?.onError?.(error, { data: variables.data }, void 0);
 			},
-			onSettled: (data, error, variables) => {
-				callbacks.onCreate?.onSettled?.(data, error, { data: variables.data }, void 0);
+			onSettled: (raw, error, variables) => {
+				callbacks.onCreate?.onSettled?.(raw ? extractItem(raw) : void 0, error, { data: variables.data }, void 0);
 			},
 			messages: {
 				success: config.messages.createSuccess,
@@ -167,7 +170,7 @@ function createCrudHooks({ api, entityKey, singular, platformScoped, defaults =
 			},
 			toastHandler: instanceToast
 		});
-		const updateMutation = createOptimisticMutation({
+		const updateMutation = useOptimisticMutation({
 			mutationFn: ({ token, organizationId, id, data }) => api.update({
 				token,
 				organizationId,
@@ -175,7 +178,7 @@ function createCrudHooks({ api, entityKey, singular, platformScoped, defaults =
 				data
 			}),
 			queryClient,
-			queryKeys: [KEYS.lists()],
+			queryKeys: [KEYS.lists(), KEYS.details()],
 			shouldToast,
 			optimisticUpdate: (oldData, { id, data }) => {
 				const updated = updateListCache(oldData, (arr) => (arr || []).map((item) => getItemId(item) === id ? {
@@ -191,9 +194,9 @@ function createCrudHooks({ api, entityKey, singular, platformScoped, defaults =
 				} : current);
 				return updated;
 			},
-			onSuccess: (data, { id, data: updateData }) => {
+			onSuccess: (raw, { id, data: updateData }) => {
 				queryClient.invalidateQueries({ queryKey: KEYS.detail(id) });
-				callbacks.onUpdate?.onSuccess?.(data, {
+				callbacks.onUpdate?.onSuccess?.(extractItem(raw), {
 					id,
 					data: updateData
 				}, void 0);
@@ -204,8 +207,8 @@ function createCrudHooks({ api, entityKey, singular, platformScoped, defaults =
 					data
 				}, void 0);
 			},
-			onSettled: (data, error, { id, data: updateData }) => {
-				callbacks.onUpdate?.onSettled?.(data, error, {
+			onSettled: (raw, error, { id, data: updateData }) => {
+				callbacks.onUpdate?.onSettled?.(raw ? extractItem(raw) : void 0, error, {
 					id,
 					data: updateData
 				}, void 0);
@@ -216,7 +219,7 @@ function createCrudHooks({ api, entityKey, singular, platformScoped, defaults =
 			},
 			toastHandler: instanceToast
 		});
-		const deleteMutation = createOptimisticMutation({
+		const deleteMutation = useOptimisticMutation({
 			mutationFn: ({ token, organizationId, id }) => api.delete({
 				token,
 				organizationId,
@@ -226,10 +229,10 @@ function createCrudHooks({ api, entityKey, singular, platformScoped, defaults =
 			queryKeys: [KEYS.lists()],
 			shouldToast,
 			optimisticUpdate: (oldData, { id }) => {
-				queryClient.removeQueries({ queryKey: KEYS.detail(id) });
 				return updateListCache(oldData, (arr) => (arr || []).filter((item) => getItemId(item) !== id));
 			},
 			onSuccess: (data, { id }) => {
+				queryClient.removeQueries({ queryKey: KEYS.detail(id) });
 				callbacks.onDelete?.onSuccess?.(data, { id }, void 0);
 			},
 			onError: (error, { id }) => {
@@ -244,63 +247,60 @@ function createCrudHooks({ api, entityKey, singular, platformScoped, defaults =
 			},
 			toastHandler: instanceToast
 		});
-		const resolveAuth = (params) => {
+		const resolveAuth = useCallback((params) => {
 			const auth = getAuthContext();
 			return {
 				...params,
 				token: params.token ?? auth.token,
-				organizationId: isPlatform ? params.organizationId ?? null : params.organizationId ?? auth.organizationId
+				organizationId: params.organizationId ?? auth.organizationId
 			};
-		};
-		const create = async (params, options) => {
-			silentRef.current = options?.silent ?? false;
-			try {
-				const result = await createMutation.mutateAsync(resolveAuth(params));
-				options?.onSuccess?.(result);
-				options?.onSettled?.(result, null);
-				return result;
-			} catch (error) {
-				options?.onError?.(error);
-				options?.onSettled?.(void 0, error);
-				throw error;
-			} finally {
-				silentRef.current = false;
-			}
-		};
-		const update = async (params, options) => {
-			silentRef.current = options?.silent ?? false;
-			try {
-				const result = await updateMutation.mutateAsync(resolveAuth(params));
-				options?.onSuccess?.(result);
-				options?.onSettled?.(result, null);
-				return result;
-			} catch (error) {
-				options?.onError?.(error);
-				options?.onSettled?.(void 0, error);
-				throw error;
-			} finally {
-				silentRef.current = false;
-			}
-		};
-		const remove = async (params, options) => {
-			silentRef.current = options?.silent ?? false;
-			try {
-				const result = await deleteMutation.mutateAsync(resolveAuth(params));
-				options?.onSuccess?.(result);
-				options?.onSettled?.(result, null);
-				return result;
-			} catch (error) {
-				options?.onError?.(error);
-				options?.onSettled?.(void 0, error);
-				throw error;
-			} finally {
-				silentRef.current = false;
-			}
-		};
+		}, []);
 		return {
-			create,
-			update,
-			remove,
+			create: useCallback(async (params, options) => {
+				silentRef.current = options?.silent ?? false;
+				try {
+					const entity = extractItem(await createMutation.mutateAsync(resolveAuth(params)));
+					options?.onSuccess?.(entity);
+					options?.onSettled?.(entity, null);
+					return entity;
+				} catch (error) {
+					options?.onError?.(error);
+					options?.onSettled?.(void 0, error);
+					throw error;
+				} finally {
+					silentRef.current = false;
+				}
+			}, [createMutation, resolveAuth]),
+			update: useCallback(async (params, options) => {
+				silentRef.current = options?.silent ?? false;
+				try {
+					const entity = extractItem(await updateMutation.mutateAsync(resolveAuth(params)));
+					options?.onSuccess?.(entity);
+					options?.onSettled?.(entity, null);
+					return entity;
+				} catch (error) {
+					options?.onError?.(error);
+					options?.onSettled?.(void 0, error);
+					throw error;
+				} finally {
+					silentRef.current = false;
+				}
+			}, [updateMutation, resolveAuth]),
+			remove: useCallback(async (params, options) => {
+				silentRef.current = options?.silent ?? false;
+				try {
+					const result = await deleteMutation.mutateAsync(resolveAuth(params));
+					options?.onSuccess?.(result);
+					options?.onSettled?.(result, null);
+					return result;
+				} catch (error) {
+					options?.onError?.(error);
+					options?.onSettled?.(void 0, error);
+					throw error;
+				} finally {
+					silentRef.current = false;
+				}
+			}, [deleteMutation, resolveAuth]),
 			isCreating: createMutation.isPending,
 			isUpdating: updateMutation.isPending,
 			isDeleting: deleteMutation.isPending,
@@ -320,7 +320,7 @@ function createCrudHooks({ api, entityKey, singular, platformScoped, defaults =
 			token = auth.token;
 			params = tokenOrParams ?? {};
 			options = paramsOrOptions ?? {};
-			if (!isPlatform && auth.organizationId && !params.organizationId) params = {
+			if (auth.organizationId && !params.organizationId) params = {
 				...params,
 				organizationId: auth.organizationId
 			};
@@ -328,7 +328,7 @@ function createCrudHooks({ api, entityKey, singular, platformScoped, defaults =
 		const { organizationId, ...restParams } = params;
 		const scope = options._scope || (organizationId ? "tenant" : "super-admin");
 		const { request: requestOpts, ...queryOpts } = options;
-		return createInfiniteListQuery({
+		return useInfiniteListQuery({
 			queryKey: [...KEYS.scopedList(scope, {
 				organizationId,
 				...restParams
@@ -348,7 +348,7 @@ function createCrudHooks({ api, entityKey, singular, platformScoped, defaults =
 					}
 				});
 			},
-			enabled: createEnabledRule(token, queryOpts),
+			enabled: createEnabledRule(token, queryOpts, resolveAuthMode()),
 			initialPageParam: restParams.after ? restParams.after : 1,
 			getNextPageParam: (lastPage) => {
 				const page = lastPage;
@@ -361,19 +361,20 @@ function createCrudHooks({ api, entityKey, singular, platformScoped, defaults =
 				staleTime: queryOpts.staleTime ?? config.staleTime,
 				gcTime: queryOpts.gcTime ?? config.gcTime,
 				refetchOnWindowFocus: queryOpts.refetchOnWindowFocus ?? config.refetchOnWindowFocus,
-				structuralSharing: queryOpts.structuralSharing ?? config.structuralSharing
+				structuralSharing: queryOpts.structuralSharing ?? config.structuralSharing,
+				refetchInterval: queryOpts.refetchInterval,
+				refetchIntervalInBackground: queryOpts.refetchIntervalInBackground
 			}
 		});
 	}
 	function useUpload(options) {
-		if (!api.upload) throw new Error(`[arc-next] "${entityKey}" api does not define an upload method`);
-		const uploadApi = api.upload;
 		return useMutationWithTransition({
 			mutationFn: ({ data, id, path }) => {
+				if (!api.upload) return Promise.reject(/* @__PURE__ */ new Error(`[arc-next] "${entityKey}" api does not define an upload method`));
 				const auth = getAuthContext();
-				return uploadApi({
+				return api.upload({
 					token: auth.token,
-					organizationId: isPlatform ? null : auth.organizationId,
+					organizationId: auth.organizationId,
 					data,
 					id,
 					path
@@ -394,9 +395,9 @@ function createCrudHooks({ api, entityKey, singular, platformScoped, defaults =
 		if (!api.search) throw new Error(`[arc-next] "${entityKey}" api does not define a search method`);
 		const searchApi = api.search;
 		const auth = getAuthContext();
-		const token = auth.token;
-		const organizationId = platformScoped ? null : params?.organizationId ?? auth.organizationId;
-		const { organizationId: _, ...restParams } = params ?? {};
+		const token = params?.token ?? auth.token;
+		const organizationId = params?.organizationId ?? auth.organizationId;
+		const { organizationId: _, token: _t, ...restParams } = params ?? {};
 		const searchParams = {
 			q: query,
 			...restParams
@@ -406,7 +407,7 @@ function createCrudHooks({ api, entityKey, singular, platformScoped, defaults =
 			organizationId,
 			...searchParams
 		} : searchParams;
-		return createListQuery({
+		return useListQuery({
 			queryKey: [
 				...KEYS.lists(),
 				"search",
@@ -421,7 +422,7 @@ function createCrudHooks({ api, entityKey, singular, platformScoped, defaults =
 					...requestOpts
 				}
 			}),
-			enabled: query.length > 0 && createEnabledRule(token, queryOpts),
+			enabled: query.length > 0 && createEnabledRule(token, queryOpts, resolveAuthMode()),
 			options: {
 				staleTime: queryOpts.staleTime ?? config.staleTime,
 				gcTime: queryOpts.gcTime ?? config.gcTime
@@ -440,9 +441,13 @@ function createCrudHooks({ api, entityKey, singular, platformScoped, defaults =
 			toastHandler: instanceToast
 		});
 	}
+	const resolvedRouterHook = instanceNavigation ?? useRouterHook ?? (() => ({
+		push: () => {},
+		replace: () => {}
+	}));
 	function useNavigation() {
 		const queryClient = useQueryClient();
-		const router = (instanceNavigation ?? useRouterHook)?.();
+		const router = resolvedRouterHook();
 		return useCallback((href, item, options = {}) => {
 			const id = getItemId(item);
 			if (id) queryClient.setQueryData(KEYS.detail(id), { data: item });
@@ -467,5 +472,4 @@ function createCrudHooks({ api, entityKey, singular, platformScoped, defaults =
 }
 
 //#endregion
-export { configureNavigation, createCrudHooks };
-//# sourceMappingURL=hooks.js.map
+export { configureNavigation, createCrudHooks };

package/dist/mutation.d.ts

@@ -26,6 +26,8 @@ interface TransitionMutationReturn<TData, TVariables> {
 /**
  * Configure toast handler. Call once at app init.
  *
+ * **SSR safety:** This sets module-level state. Call only in client-side code.
+ *
  * @example
  * import { toast } from "sonner";
  * configureToast({ success: toast.success, error: toast.error });
@@ -98,7 +100,7 @@ interface CreateOptimisticMutationConfig<TData, TVariables> {
   shouldToast?: () => boolean;
   toastHandler?: ToastHandler;
 }
-declare function createOptimisticMutation<TData, TVariables>(config: CreateOptimisticMutationConfig<TData, TVariables>): _tanstack_react_query0.UseMutationResult<TData, Error, TVariables, {
+declare function useOptimisticMutation<TData, TVariables>(config: CreateOptimisticMutationConfig<TData, TVariables>): _tanstack_react_query0.UseMutationResult<TData, Error, TVariables, {
   previous: {
     key: readonly unknown[];
     data: [readonly unknown[], unknown][];
@@ -119,6 +121,7 @@ declare const QUERY_CONFIGS: {
     readonly staleTime: 600000;
   };
 };
+/** @deprecated Use `useOptimisticMutation` */
+declare const createOptimisticMutation: typeof useOptimisticMutation;
 //#endregion
-export { CreateOptimisticMutationConfig, MutationCallbacks, MutationMessages, OptimisticMutationConfig, QUERY_CONFIGS, type ToastHandler, TransitionMutationConfig, TransitionMutationReturn, configureToast, createOptimisticMutation, useMutationWithOptimistic, useMutationWithTransition };
-//# sourceMappingURL=mutation.d.ts.map
+export { CreateOptimisticMutationConfig, MutationCallbacks, MutationMessages, OptimisticMutationConfig, QUERY_CONFIGS, TransitionMutationConfig, TransitionMutationReturn, configureToast, createOptimisticMutation, useMutationWithOptimistic, useMutationWithTransition, useOptimisticMutation };

package/dist/mutation.js

@@ -12,6 +12,8 @@ let toastHandler = {
 /**
 * Configure toast handler. Call once at app init.
 *
+* **SSR safety:** This sets module-level state. Call only in client-side code.
+*
 * @example
 * import { toast } from "sonner";
 * configureToast({ success: toast.success, error: toast.error });
@@ -112,7 +114,7 @@ function useMutationWithOptimistic(config) {
 		reset: mutation.reset
 	};
 }
-function createOptimisticMutation(config) {
+function useOptimisticMutation(config) {
 	const { mutationFn, queryClient, queryKeys, optimisticUpdate, onSuccess, onError, onSettled, messages, toastHandler: instanceToast } = config;
 	return useMutation({
 		mutationFn,
@@ -158,7 +160,8 @@ const QUERY_CONFIGS = {
 	stable: { staleTime: 3e5 },
 	static: { staleTime: 6e5 }
 };
+/** @deprecated Use `useOptimisticMutation` */
+const createOptimisticMutation = useOptimisticMutation;
 
 //#endregion
-export { QUERY_CONFIGS, configureToast, createOptimisticMutation, useMutationWithOptimistic, useMutationWithTransition };
-//# sourceMappingURL=mutation.js.map
+export { QUERY_CONFIGS, configureToast, createOptimisticMutation, useMutationWithOptimistic, useMutationWithTransition, useOptimisticMutation };

package/dist/prefetch.d.ts

@@ -4,6 +4,13 @@ import { QueryClient, dehydrate } from "@tanstack/react-query";
 interface PrefetchOptions {
   staleTime?: number;
 }
+interface PrefetchDetailOptions extends PrefetchOptions {
+  /** Query params (select, populate) — key must match useDetail's params to share cache */
+  params?: {
+    select?: string;
+    populate?: string | string[];
+  };
+}
 interface CrudPrefetcher {
   /**
    * Prefetch a list query on the server. Uses the same query keys as useList.
@@ -20,7 +27,7 @@ interface CrudPrefetcher {
    * const queryClient = getQueryClient();
    * await productsPrefetcher.prefetchDetail(queryClient, productId);
    */
-  prefetchDetail: (queryClient: QueryClient, id: string, options?: PrefetchOptions) => Promise<void>;
+  prefetchDetail: (queryClient: QueryClient, id: string, options?: PrefetchDetailOptions) => Promise<void>;
 }
 /**
  * Create server-safe prefetch helpers for CRUD queries.
@@ -60,5 +67,4 @@ declare function createCrudPrefetcher(api: {
   }) => Promise<unknown>;
 }, entityKey: string): CrudPrefetcher;
 //#endregion
-export { CrudPrefetcher, PrefetchOptions, createCrudPrefetcher, dehydrate };
-//# sourceMappingURL=prefetch.d.ts.map
+export { CrudPrefetcher, PrefetchDetailOptions, PrefetchOptions, createCrudPrefetcher, dehydrate };

package/dist/prefetch.js

@@ -61,16 +61,20 @@ function createCrudPrefetcher(api, entityKey) {
 			});
 		},
 		async prefetchDetail(queryClient, id, options = {}) {
-			const queryKey = detailKey(entityKey, id);
+			const { params, staleTime } = options;
+			const baseKey = detailKey(entityKey, id);
+			const queryKey = params ? [...baseKey, params] : baseKey;
 			await queryClient.prefetchQuery({
 				queryKey,
-				queryFn: () => api.getById({ id }),
-				staleTime: options.staleTime
+				queryFn: () => api.getById({
+					id,
+					...params ? { params } : {}
+				}),
+				staleTime
 			});
 		}
 	};
 }
 
 //#endregion
-export { createCrudPrefetcher, dehydrate };
-//# sourceMappingURL=prefetch.js.map
+export { createCrudPrefetcher, dehydrate };

package/dist/query-client.d.ts

@@ -21,5 +21,4 @@ interface QueryClientOverrides {
  */
 declare function getQueryClient(overrides?: QueryClientOverrides): QueryClient;
 //#endregion
-export { QueryClientOverrides, getQueryClient };
-//# sourceMappingURL=query-client.d.ts.map
+export { QueryClientOverrides, getQueryClient };

package/dist/query-client.js

@@ -38,9 +38,9 @@ let browserQueryClient;
 function getQueryClient(overrides) {
 	if (isServer) return makeQueryClient(overrides);
 	if (!browserQueryClient) browserQueryClient = makeQueryClient(overrides);
+	else if (overrides) console.warn("[arc-next] getQueryClient(): Browser singleton already exists — overrides are ignored. Pass overrides only on the first call.");
 	return browserQueryClient;
 }
 
 //#endregion
-export { getQueryClient };
-//# sourceMappingURL=query-client.js.map
+export { getQueryClient };

package/dist/query.d.ts

@@ -2,12 +2,16 @@ import { InfiniteData, QueryClient, QueryKey } from "@tanstack/react-query";
 
 //#region src/query.d.ts
 interface PaginationData {
+  /** Pagination method detected from response (offset | keyset | aggregate) */
+  method: 'offset' | 'keyset' | 'aggregate' | null;
   total: number;
   pages: number;
   page: number;
   limit: number;
   hasNext: boolean;
   hasPrev: boolean;
+  /** Keyset cursor for next page (keyset pagination only) */
+  next?: string | null;
 }
 /** Request-level options passed through to the fetch call */
 interface RequestPassthrough {
@@ -39,6 +43,7 @@ interface DetailQueryOptions<TData = unknown> {
   enabled?: boolean;
   staleTime?: number;
   gcTime?: number;
+  refetchOnWindowFocus?: boolean;
   structuralSharing?: boolean;
   refetchInterval?: number | false;
   refetchIntervalInBackground?: boolean;
@@ -99,6 +104,7 @@ declare const DEFAULT_QUERY_CONFIG: {
   readonly retry: 0;
 };
 declare function getItemId(item: unknown): string | null;
+declare function extractItem<T>(data: unknown): T | null;
 declare function updateListCache<T>(listData: unknown, updater: (items: T[]) => T[]): unknown;
 declare function createQueryKeys(entityKey: string): QueryKeys;
 declare function createCacheUtils<T>(KEYS: QueryKeys): CacheUtils<T>;
@@ -113,7 +119,7 @@ interface CreateListQueryConfig {
   detailKeyBuilder?: (id: string) => QueryKey;
   select?: (data: unknown) => unknown;
 }
-declare function createListQuery<T>({
+declare function useListQuery<T>({
   queryKey,
   queryFn,
   enabled,
@@ -131,7 +137,7 @@ interface CreateDetailQueryConfig {
   options?: Record<string, unknown>;
   select?: (data: unknown) => unknown;
 }
-declare function createDetailQuery<T>({
+declare function useDetailQuery<T>({
   queryKey,
   queryFn,
   enabled,
@@ -145,6 +151,8 @@ interface InfiniteListQueryOptions {
   gcTime?: number;
   refetchOnWindowFocus?: boolean;
   structuralSharing?: boolean;
+  refetchInterval?: number | false;
+  refetchIntervalInBackground?: boolean;
   _scope?: string;
   request?: RequestPassthrough;
 }
@@ -176,7 +184,7 @@ interface CreateInfiniteListQueryConfig {
   getNextPageParam: (lastPage: unknown) => unknown;
   getPreviousPageParam?: (firstPage: unknown) => unknown;
 }
-declare function createInfiniteListQuery<T>({
+declare function useInfiniteListQuery<T>({
   queryKey,
   queryFn,
   enabled,
@@ -185,6 +193,11 @@ declare function createInfiniteListQuery<T>({
   getNextPageParam,
   getPreviousPageParam
 }: CreateInfiniteListQueryConfig): InfiniteListQueryResult<T>;
+/** @deprecated Use `useListQuery` */
+declare const createListQuery: typeof useListQuery;
+/** @deprecated Use `useDetailQuery` */
+declare const createDetailQuery: typeof useDetailQuery;
+/** @deprecated Use `useInfiniteListQuery` */
+declare const createInfiniteListQuery: typeof useInfiniteListQuery;
 //#endregion
-export { CacheUtils, CreateDetailQueryConfig, CreateInfiniteListQueryConfig, CreateListQueryConfig, DEFAULT_QUERY_CONFIG, DetailQueryOptions, DetailQueryResult, InfiniteListQueryOptions, InfiniteListQueryResult, ListQueryOptions, ListQueryResult, PaginationData, QueryKeys, RequestPassthrough, createCacheUtils, createDetailQuery, createInfiniteListQuery, createListQuery, createQueryKeys, getItemId, updateListCache };
-//# sourceMappingURL=query.d.ts.map
+export { CacheUtils, CreateDetailQueryConfig, CreateInfiniteListQueryConfig, CreateListQueryConfig, DEFAULT_QUERY_CONFIG, DetailQueryOptions, DetailQueryResult, InfiniteListQueryOptions, InfiniteListQueryResult, ListQueryOptions, ListQueryResult, PaginationData, QueryKeys, RequestPassthrough, createCacheUtils, createDetailQuery, createInfiniteListQuery, createListQuery, createQueryKeys, extractItem, getItemId, updateListCache, useDetailQuery, useInfiniteListQuery, useListQuery };