@classytic/arc-next 0.2.1 → 0.4.0

package/dist/hooks.js

@@ -2,9 +2,9 @@
 
 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 { useMutation, useQueryClient } from "@tanstack/react-query";
+import { DEFAULT_QUERY_CONFIG, createCacheUtils, createQueryKeys, extractItem, getItemId, updateListCache, useDetailQuery, useInfiniteListQuery, useListQuery } from "./query.js";
+import { useMutationWithTransition, useOptimisticMutation } from "./mutation.js";
+import { useQueryClient } from "@tanstack/react-query";
 import { useCallback, useRef } from "react";
 
 //#region src/hooks.ts
@@ -12,6 +12,8 @@ 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,27 @@ 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, plural, idField, defaults = {}, callbacks = {}, client }) {
+	const pluralName = plural ?? `${singular}s`;
+	/** Extract ID from an item using configured idField, falling back to _id → id */
+	function resolveItemId(item) {
+		if (!item || typeof item !== "object") return null;
+		const obj = item;
+		if (idField) {
+			const val = obj[idField];
+			if (val != null) return String(val);
+		}
+		return getItemId(item);
+	}
 	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 +69,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 +91,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,
@@ -89,6 +102,7 @@ function createCrudHooks({ api, entityKey, singular, platformScoped, defaults =
 			},
 			prefillDetailCache: queryOpts.prefillDetailCache ?? true,
 			detailKeyBuilder: (id) => KEYS.detail(id),
+			itemIdResolver: resolveItemId,
 			select: queryOpts.select
 		});
 	}
@@ -102,13 +116,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 +134,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 +150,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,
@@ -148,18 +163,18 @@ function createCrudHooks({ api, entityKey, singular, platformScoped, defaults =
 				const optimisticItem = {
 					...data,
 					_optimistic: true,
-					[getItemId(data) ? "id" : "_id"]: getItemId(data) ?? `temp-${Date.now()}`
+					[idField ?? (resolveItemId(data) ? "id" : "_id")]: resolveItemId(data) ?? `temp-${Date.now()}`
 				};
 				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 +182,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,10 +190,10 @@ 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 ? {
+				const updated = updateListCache(oldData, (arr) => (arr || []).map((item) => resolveItemId(item) === id ? {
 					...item,
 					...data
 				} : item));
@@ -191,9 +206,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 +219,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 +231,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 +241,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));
+				return updateListCache(oldData, (arr) => (arr || []).filter((item) => resolveItemId(item) !== id));
 			},
 			onSuccess: (data, { id }) => {
+				queryClient.removeQueries({ queryKey: KEYS.detail(id) });
 				callbacks.onDelete?.onSuccess?.(data, { id }, void 0);
 			},
 			onError: (error, { id }) => {
@@ -244,67 +259,97 @@ function createCrudHooks({ api, entityKey, singular, platformScoped, defaults =
 			},
 			toastHandler: instanceToast
 		});
-		const resolveAuth = (params) => {
+		const restoreMutation = useMutationWithTransition({
+			mutationFn: ({ token, organizationId, id }) => {
+				if (!api.restore) return Promise.reject(/* @__PURE__ */ new Error(`[arc-next] "${entityKey}" api does not define a restore method`));
+				return api.restore({
+					token,
+					organizationId,
+					id
+				});
+			},
+			invalidateQueries: [KEYS.lists(), KEYS.custom("deleted")],
+			shouldToast,
+			messages: {
+				success: `${singular} restored successfully`,
+				error: `Failed to restore ${singular.toLowerCase()}`
+			},
+			toastHandler: instanceToast
+		});
+		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]),
+			restore: useCallback(async (params, options) => {
+				silentRef.current = options?.silent ?? false;
+				try {
+					const entity = extractItem(await restoreMutation.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;
+				}
+			}, [restoreMutation, resolveAuth]),
 			isCreating: createMutation.isPending,
 			isUpdating: updateMutation.isPending,
 			isDeleting: deleteMutation.isPending,
-			isMutating: createMutation.isPending || updateMutation.isPending || deleteMutation.isPending
+			isRestoring: restoreMutation.isPending,
+			isMutating: createMutation.isPending || updateMutation.isPending || deleteMutation.isPending || restoreMutation.isPending
 		};
 	}
 	function useInfiniteList(tokenOrParams, paramsOrOptions, maybeOptions) {
@@ -320,7 +365,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 +373,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 +393,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;
@@ -357,23 +402,31 @@ function createCrudHooks({ api, entityKey, singular, platformScoped, defaults =
 				const p = page;
 				if (typeof p.hasNext === "boolean" && typeof p.page === "number") return p.hasNext ? p.page + 1 : void 0;
 			},
+			getPreviousPageParam: queryOpts.maxPages != null ? (firstPage) => {
+				const page = firstPage;
+				if (isOffsetPagination(page)) return page.hasPrev ? page.page - 1 : void 0;
+				const p = page;
+				if (typeof p.hasPrev === "boolean" && typeof p.page === "number") return p.hasPrev ? p.page - 1 : void 0;
+			} : void 0,
+			maxPages: queryOpts.maxPages,
 			options: {
 				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
@@ -391,12 +444,10 @@ function createCrudHooks({ api, entityKey, singular, platformScoped, defaults =
 		});
 	}
 	function useSearch(query, params, options) {
-		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,22 +457,25 @@ function createCrudHooks({ api, entityKey, singular, platformScoped, defaults =
 			organizationId,
 			...searchParams
 		} : searchParams;
-		return createListQuery({
+		return useListQuery({
 			queryKey: [
 				...KEYS.lists(),
 				"search",
 				searchKeyParams
 			],
-			queryFn: ({ signal }) => searchApi({
-				token,
-				organizationId,
-				params: searchParams,
-				options: {
-					signal,
-					...requestOpts
-				}
-			}),
-			enabled: query.length > 0 && createEnabledRule(token, queryOpts),
+			queryFn: ({ signal }) => {
+				if (!api.search) return Promise.reject(/* @__PURE__ */ new Error(`[arc-next] "${entityKey}" api does not define a search method`));
+				return api.search({
+					token,
+					organizationId,
+					params: searchParams,
+					options: {
+						signal,
+						...requestOpts
+					}
+				});
+			},
+			enabled: !!api.search && query.length > 0 && createEnabledRule(token, queryOpts, resolveAuthMode()),
 			options: {
 				staleTime: queryOpts.staleTime ?? config.staleTime,
 				gcTime: queryOpts.gcTime ?? config.gcTime
@@ -440,11 +494,252 @@ function createCrudHooks({ api, entityKey, singular, platformScoped, defaults =
 			toastHandler: instanceToast
 		});
 	}
+	function useDeleted(params, options) {
+		const auth = getAuthContext();
+		const token = auth.token;
+		const mergedParams = params ?? {};
+		const organizationId = mergedParams.organizationId ?? auth.organizationId;
+		const { organizationId: _, ...restParams } = mergedParams;
+		const { request: requestOpts, ...queryOpts } = options ?? {};
+		return useListQuery({
+			queryKey: KEYS.custom("deleted", {
+				organizationId,
+				...restParams
+			}),
+			queryFn: ({ signal }) => {
+				if (!api.getDeleted) return Promise.reject(/* @__PURE__ */ new Error(`[arc-next] "${entityKey}" api does not define a getDeleted method`));
+				return api.getDeleted({
+					token,
+					organizationId,
+					params: restParams,
+					options: {
+						signal,
+						...requestOpts
+					}
+				});
+			},
+			enabled: !!api.getDeleted && createEnabledRule(token, queryOpts, resolveAuthMode()),
+			options: {
+				staleTime: queryOpts.staleTime ?? config.staleTime,
+				gcTime: queryOpts.gcTime ?? config.gcTime
+			},
+			select: queryOpts.select
+		});
+	}
+	function useDetailBySlug(slug, options) {
+		const auth = getAuthContext();
+		const token = auth.token;
+		const resolvedOptions = options ?? {};
+		const organizationId = resolvedOptions.organizationId ?? auth.organizationId;
+		const { params: queryParams, request: requestOpts, ...restOptions } = resolvedOptions;
+		return useDetailQuery({
+			queryKey: queryParams ? KEYS.custom("slug", slug, queryParams) : KEYS.custom("slug", slug),
+			queryFn: ({ signal }) => {
+				if (!api.getBySlug) return Promise.reject(/* @__PURE__ */ new Error(`[arc-next] "${entityKey}" api does not define a getBySlug method`));
+				return api.getBySlug({
+					slug,
+					token,
+					organizationId,
+					params: queryParams,
+					options: {
+						signal,
+						...requestOpts
+					}
+				});
+			},
+			enabled: !!api.getBySlug && !!slug && 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
+			},
+			select: restOptions.select
+		});
+	}
+	function useTree(params, options) {
+		const auth = getAuthContext();
+		const token = auth.token;
+		const mergedParams = params ?? {};
+		const organizationId = mergedParams.organizationId ?? auth.organizationId;
+		const { organizationId: _, ...restParams } = mergedParams;
+		const { request: requestOpts, ...queryOpts } = options ?? {};
+		return useListQuery({
+			queryKey: KEYS.custom("tree", {
+				organizationId,
+				...restParams
+			}),
+			queryFn: ({ signal }) => {
+				if (!api.getTree) return Promise.reject(/* @__PURE__ */ new Error(`[arc-next] "${entityKey}" api does not define a getTree method`));
+				return api.getTree({
+					token,
+					organizationId,
+					params: restParams,
+					options: {
+						signal,
+						...requestOpts
+					}
+				});
+			},
+			enabled: !!api.getTree && createEnabledRule(token, queryOpts, resolveAuthMode()),
+			options: {
+				staleTime: queryOpts.staleTime ?? config.staleTime,
+				gcTime: queryOpts.gcTime ?? config.gcTime
+			},
+			select: queryOpts.select
+		});
+	}
+	function useChildren(parentId, params, options) {
+		const auth = getAuthContext();
+		const token = auth.token;
+		const mergedParams = params ?? {};
+		const organizationId = mergedParams.organizationId ?? auth.organizationId;
+		const { organizationId: _, ...restParams } = mergedParams;
+		const { request: requestOpts, ...queryOpts } = options ?? {};
+		return useListQuery({
+			queryKey: KEYS.custom("children", parentId, {
+				organizationId,
+				...restParams
+			}),
+			queryFn: ({ signal }) => {
+				if (!api.getChildren) return Promise.reject(/* @__PURE__ */ new Error(`[arc-next] "${entityKey}" api does not define a getChildren method`));
+				return api.getChildren({
+					token,
+					organizationId,
+					parentId,
+					params: restParams,
+					options: {
+						signal,
+						...requestOpts
+					}
+				});
+			},
+			enabled: !!api.getChildren && !!parentId && createEnabledRule(token, queryOpts, resolveAuthMode()),
+			options: {
+				staleTime: queryOpts.staleTime ?? config.staleTime,
+				gcTime: queryOpts.gcTime ?? config.gcTime
+			},
+			prefillDetailCache: queryOpts.prefillDetailCache ?? true,
+			detailKeyBuilder: (id) => KEYS.detail(id),
+			itemIdResolver: resolveItemId,
+			select: queryOpts.select
+		});
+	}
+	function useFindBy(field, value, options) {
+		const auth = getAuthContext();
+		const token = auth.token;
+		const organizationId = auth.organizationId;
+		const { operator, request: requestOpts, ...queryOpts } = options ?? {};
+		return useListQuery({
+			queryKey: KEYS.custom("findBy", field, value, operator),
+			queryFn: ({ signal }) => {
+				if (!api.findBy) return Promise.reject(/* @__PURE__ */ new Error(`[arc-next] "${entityKey}" api does not define a findBy method`));
+				return api.findBy({
+					token,
+					organizationId,
+					field,
+					value,
+					operator,
+					options: {
+						signal,
+						...requestOpts
+					}
+				});
+			},
+			enabled: !!api.findBy && value !== void 0 && value !== null && createEnabledRule(token, queryOpts, resolveAuthMode()),
+			options: {
+				staleTime: queryOpts.staleTime ?? config.staleTime,
+				gcTime: queryOpts.gcTime ?? config.gcTime
+			},
+			prefillDetailCache: queryOpts.prefillDetailCache ?? true,
+			detailKeyBuilder: (id) => KEYS.detail(id),
+			itemIdResolver: resolveItemId,
+			select: queryOpts.select
+		});
+	}
+	function useBulkActions() {
+		const bulkCreateMutation = useMutationWithTransition({
+			mutationFn: (vars) => {
+				if (!api.bulkCreate) return Promise.reject(/* @__PURE__ */ new Error(`[arc-next] "${entityKey}" api does not define a bulkCreate method`));
+				const auth = getAuthContext();
+				return api.bulkCreate({
+					token: vars.token ?? auth.token,
+					organizationId: vars.organizationId ?? auth.organizationId,
+					data: vars.data
+				});
+			},
+			invalidateQueries: [KEYS.lists()],
+			messages: {
+				success: `${pluralName} created successfully`,
+				error: `Failed to create ${pluralName.toLowerCase()}`
+			},
+			toastHandler: instanceToast
+		});
+		const bulkUpdateMutation = useMutationWithTransition({
+			mutationFn: (vars) => {
+				if (!api.bulkUpdate) return Promise.reject(/* @__PURE__ */ new Error(`[arc-next] "${entityKey}" api does not define a bulkUpdate method`));
+				const auth = getAuthContext();
+				return api.bulkUpdate({
+					token: vars.token ?? auth.token,
+					organizationId: vars.organizationId ?? auth.organizationId,
+					filter: vars.filter,
+					data: vars.data
+				});
+			},
+			invalidateQueries: [KEYS.lists(), KEYS.details()],
+			messages: {
+				success: `${pluralName} updated successfully`,
+				error: `Failed to update ${pluralName.toLowerCase()}`
+			},
+			toastHandler: instanceToast
+		});
+		const bulkDeleteMutation = useMutationWithTransition({
+			mutationFn: (vars) => {
+				if (!api.bulkDelete) return Promise.reject(/* @__PURE__ */ new Error(`[arc-next] "${entityKey}" api does not define a bulkDelete method`));
+				const auth = getAuthContext();
+				return api.bulkDelete({
+					token: vars.token ?? auth.token,
+					organizationId: vars.organizationId ?? auth.organizationId,
+					filter: vars.filter
+				});
+			},
+			invalidateQueries: [KEYS.lists()],
+			messages: {
+				success: `${pluralName} deleted successfully`,
+				error: `Failed to delete ${pluralName.toLowerCase()}`
+			},
+			toastHandler: instanceToast
+		});
+		return {
+			bulkCreate: async (params, options) => {
+				const items = (await bulkCreateMutation.mutateAsync(params))?.data ?? [];
+				options?.onSuccess?.(items);
+				return items;
+			},
+			bulkUpdate: async (params, options) => {
+				const result = await bulkUpdateMutation.mutateAsync(params);
+				options?.onSuccess?.(result);
+				return result;
+			},
+			bulkRemove: async (params, options) => {
+				const result = await bulkDeleteMutation.mutateAsync(params);
+				options?.onSuccess?.(result);
+				return result;
+			},
+			isBulkCreating: bulkCreateMutation.isPending,
+			isBulkUpdating: bulkUpdateMutation.isPending,
+			isBulkDeleting: bulkDeleteMutation.isPending
+		};
+	}
+	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);
+			const id = resolveItemId(item);
 			if (id) queryClient.setQueryData(KEYS.detail(id), { data: item });
 			if (!router) return;
 			const { scroll = true, replace = false } = options;
@@ -459,6 +754,12 @@ function createCrudHooks({ api, entityKey, singular, platformScoped, defaults =
 		useDetail,
 		useInfiniteList,
 		useActions,
+		useBulkActions,
+		useDeleted,
+		useDetailBySlug,
+		useTree,
+		useChildren,
+		useFindBy,
 		useUpload,
 		useSearch,
 		useCustomMutation,
@@ -467,5 +768,4 @@ function createCrudHooks({ api, entityKey, singular, platformScoped, defaults =
 }
 
 //#endregion
-export { configureNavigation, createCrudHooks };
-//# sourceMappingURL=hooks.js.map
+export { configureNavigation, createCrudHooks };