@classytic/arc-next 0.1.3 → 0.2.1

package/dist/hooks.js

@@ -3,9 +3,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 } from "./mutation.js";
-import { useQueryClient } from "@tanstack/react-query";
-import { useCallback } from "react";
+import { createOptimisticMutation, useMutationWithTransition } from "./mutation.js";
+import { useMutation, useQueryClient } from "@tanstack/react-query";
+import { useCallback, useRef } from "react";
 
 //#region src/hooks.ts
 let useRouterHook = null;
@@ -23,7 +23,8 @@ function createEnabledRule(token, options) {
 	if (getAuthMode() === "cookie" || options.public) return options.enabled ?? true;
 	return options.enabled !== void 0 ? options.enabled && !!token : !!token;
 }
-function createCrudHooks({ api, entityKey, singular, defaults = {}, callbacks = {}, client }) {
+function createCrudHooks({ api, entityKey, singular, platformScoped, defaults = {}, callbacks = {}, client }) {
+	const isPlatform = platformScoped ?? api.scope === "platform";
 	const KEYS = createQueryKeys(entityKey);
 	const cache = createCacheUtils(KEYS);
 	const instanceToast = client?.toast;
@@ -55,24 +56,27 @@ function createCrudHooks({ api, entityKey, singular, defaults = {}, callbacks =
 			token = auth.token;
 			params = tokenOrParams ?? {};
 			options = paramsOrOptions ?? {};
-			if (auth.organizationId && !params.organizationId) params = {
+			if (!isPlatform && auth.organizationId && !params.organizationId) params = {
 				...params,
 				organizationId: auth.organizationId
 			};
 		}
 		const { organizationId, ...restParams } = params;
-		const scope = options._scope || (organizationId ? "tenant" : "super-admin");
+		const scope = options._scope || (isPlatform ? "platform" : organizationId ? "tenant" : "super-admin");
 		const { request: requestOpts, ...queryOpts } = options;
 		return createListQuery({
 			queryKey: KEYS.scopedList(scope, {
 				organizationId,
 				...restParams
 			}),
-			queryFn: () => api.getAll({
+			queryFn: ({ signal }) => api.getAll({
 				token,
 				organizationId,
 				params: restParams,
-				options: { ...requestOpts }
+				options: {
+					signal,
+					...requestOpts
+				}
 			}),
 			enabled: createEnabledRule(token, queryOpts),
 			options: {
@@ -84,7 +88,8 @@ function createCrudHooks({ api, entityKey, singular, defaults = {}, callbacks =
 				refetchIntervalInBackground: queryOpts.refetchIntervalInBackground
 			},
 			prefillDetailCache: queryOpts.prefillDetailCache ?? true,
-			detailKeyBuilder: (id) => KEYS.detail(id)
+			detailKeyBuilder: (id) => KEYS.detail(id),
+			select: queryOpts.select
 		});
 	}
 	function useDetail(id, tokenOrOptions, maybeOptions) {
@@ -97,7 +102,7 @@ function createCrudHooks({ api, entityKey, singular, defaults = {}, callbacks =
 			const auth = getAuthContext();
 			token = auth.token;
 			options = tokenOrOptions ?? {};
-			if (auth.organizationId && !options.organizationId) options = {
+			if (!isPlatform && auth.organizationId && !options.organizationId) options = {
 				...options,
 				organizationId: auth.organizationId
 			};
@@ -105,12 +110,15 @@ function createCrudHooks({ api, entityKey, singular, defaults = {}, callbacks =
 		const { organizationId, params: queryParams, request: requestOpts, ...restOptions } = options;
 		return createDetailQuery({
 			queryKey: queryParams ? [...KEYS.detail(id || ""), queryParams] : KEYS.detail(id || ""),
-			queryFn: () => api.getById({
+			queryFn: ({ signal }) => api.getById({
 				id,
 				token,
 				organizationId,
 				params: queryParams,
-				options: { ...requestOpts }
+				options: {
+					signal,
+					...requestOpts
+				}
 			}),
 			enabled: !!id && createEnabledRule(token, restOptions),
 			options: {
@@ -119,11 +127,14 @@ function createCrudHooks({ api, entityKey, singular, defaults = {}, callbacks =
 				structuralSharing: restOptions.structuralSharing ?? config.structuralSharing,
 				refetchInterval: restOptions.refetchInterval,
 				refetchIntervalInBackground: restOptions.refetchIntervalInBackground
-			}
+			},
+			select: restOptions.select
 		});
 	}
 	function useActions() {
 		const queryClient = useQueryClient();
+		const silentRef = useRef(false);
+		const shouldToast = useCallback(() => !silentRef.current, []);
 		const createMutation = createOptimisticMutation({
 			mutationFn: ({ token, organizationId, data }) => api.create({
 				token,
@@ -132,6 +143,7 @@ function createCrudHooks({ api, entityKey, singular, defaults = {}, callbacks =
 			}),
 			queryClient,
 			queryKeys: [KEYS.lists()],
+			shouldToast,
 			optimisticUpdate: (oldData, { data }) => {
 				const optimisticItem = {
 					...data,
@@ -146,6 +158,9 @@ function createCrudHooks({ api, entityKey, singular, defaults = {}, callbacks =
 			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);
+			},
 			messages: {
 				success: config.messages.createSuccess,
 				error: config.messages.createError
@@ -161,6 +176,7 @@ function createCrudHooks({ api, entityKey, singular, defaults = {}, callbacks =
 			}),
 			queryClient,
 			queryKeys: [KEYS.lists()],
+			shouldToast,
 			optimisticUpdate: (oldData, { id, data }) => {
 				const updated = updateListCache(oldData, (arr) => (arr || []).map((item) => getItemId(item) === id ? {
 					...item,
@@ -175,11 +191,11 @@ function createCrudHooks({ api, entityKey, singular, defaults = {}, callbacks =
 				} : current);
 				return updated;
 			},
-			onSuccess: (data, { id }) => {
+			onSuccess: (data, { id, data: updateData }) => {
 				queryClient.invalidateQueries({ queryKey: KEYS.detail(id) });
 				callbacks.onUpdate?.onSuccess?.(data, {
 					id,
-					data: {}
+					data: updateData
 				}, void 0);
 			},
 			onError: (error, { id, data }) => {
@@ -188,6 +204,12 @@ function createCrudHooks({ api, entityKey, singular, defaults = {}, callbacks =
 					data
 				}, void 0);
 			},
+			onSettled: (data, error, { id, data: updateData }) => {
+				callbacks.onUpdate?.onSettled?.(data, error, {
+					id,
+					data: updateData
+				}, void 0);
+			},
 			messages: {
 				success: config.messages.updateSuccess,
 				error: config.messages.updateError
@@ -202,6 +224,7 @@ function createCrudHooks({ api, entityKey, singular, defaults = {}, callbacks =
 			}),
 			queryClient,
 			queryKeys: [KEYS.lists()],
+			shouldToast,
 			optimisticUpdate: (oldData, { id }) => {
 				queryClient.removeQueries({ queryKey: KEYS.detail(id) });
 				return updateListCache(oldData, (arr) => (arr || []).filter((item) => getItemId(item) !== id));
@@ -212,6 +235,9 @@ function createCrudHooks({ api, entityKey, singular, defaults = {}, callbacks =
 			onError: (error, { id }) => {
 				callbacks.onDelete?.onError?.(error, { id }, void 0);
 			},
+			onSettled: (data, error, { id }) => {
+				callbacks.onDelete?.onSettled?.(data, error, { id }, void 0);
+			},
 			messages: {
 				success: config.messages.deleteSuccess,
 				error: config.messages.deleteError
@@ -223,37 +249,52 @@ function createCrudHooks({ api, entityKey, singular, defaults = {}, callbacks =
 			return {
 				...params,
 				token: params.token ?? auth.token,
-				organizationId: params.organizationId ?? auth.organizationId
+				organizationId: isPlatform ? params.organizationId ?? null : 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 {
@@ -279,7 +320,7 @@ function createCrudHooks({ api, entityKey, singular, defaults = {}, callbacks =
 			token = auth.token;
 			params = tokenOrParams ?? {};
 			options = paramsOrOptions ?? {};
-			if (auth.organizationId && !params.organizationId) params = {
+			if (!isPlatform && auth.organizationId && !params.organizationId) params = {
 				...params,
 				organizationId: auth.organizationId
 			};
@@ -292,7 +333,7 @@ function createCrudHooks({ api, entityKey, singular, defaults = {}, callbacks =
 				organizationId,
 				...restParams
 			}), "infinite"],
-			queryFn: ({ pageParam }) => {
+			queryFn: ({ pageParam, signal }) => {
 				const paginationParams = typeof pageParam === "string" ? { after: pageParam } : { page: pageParam };
 				return api.getAll({
 					token,
@@ -301,7 +342,10 @@ function createCrudHooks({ api, entityKey, singular, defaults = {}, callbacks =
 						...restParams,
 						...paginationParams
 					},
-					options: { ...requestOpts }
+					options: {
+						signal,
+						...requestOpts
+					}
 				});
 			},
 			enabled: createEnabledRule(token, queryOpts),
@@ -321,6 +365,81 @@ function createCrudHooks({ api, entityKey, singular, defaults = {}, callbacks =
 			}
 		});
 	}
+	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 }) => {
+				const auth = getAuthContext();
+				return uploadApi({
+					token: auth.token,
+					organizationId: isPlatform ? null : auth.organizationId,
+					data,
+					id,
+					path
+				});
+			},
+			invalidateQueries: options?.invalidateQueries ?? [KEYS.lists()],
+			onSuccess: (data) => options?.onSuccess?.(data),
+			onError: (error) => options?.onError?.(error),
+			onSettled: (data, error) => options?.onSettled?.(data, error),
+			messages: options?.messages ?? {
+				success: `${singular} uploaded successfully`,
+				error: `Failed to upload ${singular.toLowerCase()}`
+			},
+			toastHandler: instanceToast
+		});
+	}
+	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 searchParams = {
+			q: query,
+			...restParams
+		};
+		const { request: requestOpts, ...queryOpts } = options ?? {};
+		const searchKeyParams = organizationId ? {
+			organizationId,
+			...searchParams
+		} : searchParams;
+		return createListQuery({
+			queryKey: [
+				...KEYS.lists(),
+				"search",
+				searchKeyParams
+			],
+			queryFn: ({ signal }) => searchApi({
+				token,
+				organizationId,
+				params: searchParams,
+				options: {
+					signal,
+					...requestOpts
+				}
+			}),
+			enabled: query.length > 0 && createEnabledRule(token, queryOpts),
+			options: {
+				staleTime: queryOpts.staleTime ?? config.staleTime,
+				gcTime: queryOpts.gcTime ?? config.gcTime
+			},
+			select: queryOpts.select
+		});
+	}
+	function useCustomMutation(mutationConfig) {
+		return useMutationWithTransition({
+			mutationFn: mutationConfig.mutationFn,
+			invalidateQueries: mutationConfig.invalidateQueries ?? [KEYS.lists()],
+			onSuccess: mutationConfig.onSuccess,
+			onError: mutationConfig.onError,
+			onSettled: mutationConfig.onSettled,
+			messages: mutationConfig.messages,
+			toastHandler: instanceToast
+		});
+	}
 	function useNavigation() {
 		const queryClient = useQueryClient();
 		const router = (instanceNavigation ?? useRouterHook)?.();
@@ -340,6 +459,9 @@ function createCrudHooks({ api, entityKey, singular, defaults = {}, callbacks =
 		useDetail,
 		useInfiniteList,
 		useActions,
+		useUpload,
+		useSearch,
+		useCustomMutation,
 		useNavigation
 	};
 }

package/dist/hooks.js.map

@@ -1 +1 @@
-{"version":3,"file":"hooks.js","names":[],"sources":["../src/hooks.ts"],"sourcesContent":["\"use client\";\n\nimport { useQueryClient } from \"@tanstack/react-query\";\nimport { useCallback } from \"react\";\nimport { createOptimisticMutation } from \"./mutation.js\";\nimport {\n  createListQuery,\n  createDetailQuery,\n  createInfiniteListQuery,\n  updateListCache,\n  getItemId,\n  createQueryKeys,\n  createCacheUtils,\n  DEFAULT_QUERY_CONFIG,\n} from \"./query.js\";\nimport type {\n  QueryKeys,\n  CacheUtils,\n  ListQueryOptions,\n  DetailQueryOptions,\n  ListQueryResult,\n  DetailQueryResult,\n  InfiniteListQueryOptions,\n  InfiniteListQueryResult,\n} from \"./query.js\";\nimport {\n  isOffsetPagination,\n  isKeysetPagination,\n} from \"./api.js\";\nimport type { PaginatedResponse } from \"./api.js\";\nimport type { MutationCallbacks } from \"./mutation.js\";\nimport { getAuthMode, getAuthContext } from \"./client.js\";\nimport type { ArcClient, ToastHandler, UseRouterHook } from \"./client.js\";\n\n// Re-export UseRouterHook for backward compatibility\nexport type { UseRouterHook } from \"./client.js\";\n\n// ============================================================================\n// Types\n// ============================================================================\n\nexport interface CrudApi<T, TCreate = Partial<T>, TUpdate = Partial<T>> {\n  getAll: (options: {\n    token?: string | null;\n    organizationId?: string | null;\n    params?: Record<string, unknown>;\n    options?: { signal?: AbortSignal; [key: string]: unknown };\n  }) => Promise<unknown>;\n\n  getById: (options: {\n    id: string;\n    token?: string | null;\n    organizationId?: string | null;\n    params?: { select?: string; populate?: string | string[] };\n    options?: { signal?: AbortSignal; [key: string]: unknown };\n  }) => Promise<unknown>;\n\n  create: (options: {\n    token?: string | null;\n    organizationId?: string | null;\n    data: TCreate;\n  }) => Promise<unknown>;\n\n  update: (options: {\n    token?: string | null;\n    organizationId?: string | null;\n    id: string;\n    data: TUpdate;\n  }) => Promise<unknown>;\n\n  delete: (options: {\n    token?: string | null;\n    organizationId?: string | null;\n    id: string;\n  }) => Promise<unknown>;\n}\n\nexport interface CrudHooksConfig<T, TCreate = Partial<T>, TUpdate = Partial<T>> {\n  api: CrudApi<T, TCreate, TUpdate>;\n  entityKey: string;\n  singular: string;\n  plural?: string;\n  defaults?: {\n    staleTime?: number;\n    gcTime?: number;\n    refetchOnWindowFocus?: boolean;\n    structuralSharing?: boolean;\n    messages?: {\n      createSuccess?: string;\n      createError?: string;\n      updateSuccess?: string;\n      updateError?: string;\n      deleteSuccess?: string;\n      deleteError?: string;\n    };\n  };\n  callbacks?: {\n    onCreate?: MutationCallbacks<T, { data: TCreate }>;\n    onUpdate?: MutationCallbacks<T, { id: string; data: TUpdate }>;\n    onDelete?: MutationCallbacks<unknown, { id: string }>;\n  };\n  client?: ArcClient;\n}\n\nexport interface MutationParams<TData> {\n  token?: string | null;\n  organizationId?: string | null;\n  data: TData;\n}\n\nexport interface UpdateParams<TData> extends MutationParams<TData> {\n  id: string;\n}\n\nexport interface DeleteParams {\n  token?: string | null;\n  organizationId?: string | null;\n  id: string;\n}\n\nexport interface CallOptions<TData = unknown> {\n  onSuccess?: (data: TData) => void;\n  onError?: (error: Error) => void;\n  silent?: boolean;\n}\n\nexport interface CrudActions<T, TCreate, TUpdate> {\n  create: (params: MutationParams<TCreate>, options?: CallOptions<T>) => Promise<T>;\n  update: (params: UpdateParams<TUpdate>, options?: CallOptions<T>) => Promise<T>;\n  remove: (params: DeleteParams, options?: CallOptions) => Promise<unknown>;\n  isCreating: boolean;\n  isUpdating: boolean;\n  isDeleting: boolean;\n  isMutating: boolean;\n}\n\nexport interface NavigationOptions {\n  scroll?: boolean;\n  replace?: boolean;\n}\n\nexport type NavigateFn<T> = (href: string, item: T, options?: NavigationOptions) => void;\n\nexport interface CrudHooksReturn<T, TCreate, TUpdate> {\n  KEYS: QueryKeys;\n  cache: CacheUtils<T>;\n  useList: {\n    /** New signature — auto-injects token/orgId from configureAuth() context */\n    (params?: Record<string, unknown>, options?: ListQueryOptions): ListQueryResult<T>;\n    /** Legacy signature — explicit token */\n    (token: string | null, params?: Record<string, unknown>, options?: ListQueryOptions): ListQueryResult<T>;\n  };\n  useDetail: {\n    /** New signature — auto-injects token from configureAuth() context */\n    (id: string | null, options?: DetailQueryOptions): DetailQueryResult<T>;\n    /** Legacy signature — explicit token */\n    (id: string | null, token: string | null, options?: DetailQueryOptions): DetailQueryResult<T>;\n  };\n  useInfiniteList: {\n    /** New signature — auto-injects token/orgId from configureAuth() context */\n    (params?: Record<string, unknown>, options?: InfiniteListQueryOptions): InfiniteListQueryResult<T>;\n    /** Legacy signature — explicit token */\n    (token: string | null, params?: Record<string, unknown>, options?: InfiniteListQueryOptions): InfiniteListQueryResult<T>;\n  };\n  useActions: () => CrudActions<T, TCreate, TUpdate>;\n  useNavigation: () => NavigateFn<T>;\n}\n\n// ============================================================================\n// Navigation Configuration (Global)\n// ============================================================================\n\nlet useRouterHook: UseRouterHook | null = null;\n\n/**\n * Configure the router hook for useNavigation. Call once at app init.\n *\n * @example\n * import { useRouter } from \"next/navigation\";\n * configureNavigation(useRouter);\n */\nexport function configureNavigation(hook: UseRouterHook): void {\n  useRouterHook = hook;\n}\n\n// ============================================================================\n// Enabled Rule\n// ============================================================================\n\nfunction createEnabledRule(token: string | null, options: { public?: boolean; enabled?: boolean }): boolean {\n  // Cookie-based auth: no token needed, queries always enabled (cookies sent via credentials: 'include')\n  if (getAuthMode() === 'cookie' || options.public) {\n    return options.enabled ?? true;\n  }\n  // Bearer token auth: require token to enable queries\n  return options.enabled !== undefined ? options.enabled && !!token : !!token;\n}\n\n// ============================================================================\n// Create CRUD Hooks Factory\n// ============================================================================\n\nexport function createCrudHooks<T, TCreate = Partial<T>, TUpdate = Partial<T>>({\n  api,\n  entityKey,\n  singular,\n  defaults = {},\n  callbacks = {},\n  client,\n}: CrudHooksConfig<T, TCreate, TUpdate>): CrudHooksReturn<T, TCreate, TUpdate> {\n  const KEYS = createQueryKeys(entityKey);\n  const cache = createCacheUtils<T>(KEYS);\n\n  // Resolve toast handler: client instance → global\n  const instanceToast: ToastHandler | undefined = client?.toast;\n  // Resolve navigation hook: client instance → global\n  const instanceNavigation: UseRouterHook | null = client?.navigation ?? null;\n\n  const config = {\n    ...DEFAULT_QUERY_CONFIG,\n    ...defaults,\n    structuralSharing: defaults.structuralSharing,\n    messages: {\n      createSuccess: `${singular} created successfully`,\n      createError: `Failed to create ${singular.toLowerCase()}`,\n      updateSuccess: `${singular} updated successfully`,\n      updateError: `Failed to update ${singular.toLowerCase()}`,\n      deleteSuccess: `${singular} deleted successfully`,\n      deleteError: `Failed to delete ${singular.toLowerCase()}`,\n      ...defaults.messages,\n    },\n  };\n\n  // ========== useList ==========\n\n  function useList(\n    tokenOrParams?: string | null | Record<string, unknown>,\n    paramsOrOptions?: Record<string, unknown> | ListQueryOptions,\n    maybeOptions?: ListQueryOptions,\n  ): ListQueryResult<T> {\n    let token: string | null;\n    let params: Record<string, unknown>;\n    let options: ListQueryOptions;\n\n    // Detect which overload: first arg is string|null = legacy, object/undefined = new\n    if (tokenOrParams === null || typeof tokenOrParams === 'string') {\n      token = tokenOrParams;\n      params = (paramsOrOptions as Record<string, unknown>) ?? {};\n      options = maybeOptions ?? {};\n    } else {\n      const auth = getAuthContext();\n      token = auth.token;\n      params = (tokenOrParams as Record<string, unknown>) ?? {};\n      options = (paramsOrOptions as ListQueryOptions) ?? {};\n      if (auth.organizationId && !params.organizationId) {\n        params = { ...params, organizationId: auth.organizationId };\n      }\n    }\n\n    const { organizationId, ...restParams } = params;\n    const scope = options._scope || (organizationId ? \"tenant\" : \"super-admin\");\n    const { request: requestOpts, ...queryOpts } = options;\n\n    return createListQuery<T>({\n      queryKey: KEYS.scopedList(scope, { organizationId, ...restParams }),\n      queryFn: () => api.getAll({ token, organizationId: organizationId as string | null, params: restParams, options: { ...requestOpts } }),\n      enabled: createEnabledRule(token, queryOpts),\n      options: {\n        staleTime: queryOpts.staleTime ?? config.staleTime,\n        gcTime: queryOpts.gcTime ?? config.gcTime,\n        refetchOnWindowFocus: queryOpts.refetchOnWindowFocus ?? config.refetchOnWindowFocus,\n        structuralSharing: queryOpts.structuralSharing ?? config.structuralSharing,\n        refetchInterval: queryOpts.refetchInterval,\n        refetchIntervalInBackground: queryOpts.refetchIntervalInBackground,\n      },\n      prefillDetailCache: queryOpts.prefillDetailCache ?? true,\n      detailKeyBuilder: (id) => KEYS.detail(id),\n    });\n  }\n\n  // ========== useDetail ==========\n\n  function useDetail(\n    id: string | null,\n    tokenOrOptions?: string | null | DetailQueryOptions,\n    maybeOptions?: DetailQueryOptions,\n  ): DetailQueryResult<T> {\n    let token: string | null;\n    let options: DetailQueryOptions;\n\n    // Detect which overload: second arg is string|null = legacy, object/undefined = new\n    if (tokenOrOptions === null || typeof tokenOrOptions === 'string') {\n      token = tokenOrOptions;\n      options = maybeOptions ?? {};\n    } else {\n      const auth = getAuthContext();\n      token = auth.token;\n      options = (tokenOrOptions as DetailQueryOptions) ?? {};\n      if (auth.organizationId && !options.organizationId) {\n        options = { ...options, organizationId: auth.organizationId };\n      }\n    }\n\n    const { organizationId, params: queryParams, request: requestOpts, ...restOptions } = options;\n\n    return createDetailQuery<T>({\n      queryKey: queryParams ? [...KEYS.detail(id || \"\"), queryParams] : KEYS.detail(id || \"\"),\n      queryFn: () => api.getById({ id: id!, token, organizationId, params: queryParams, options: { ...requestOpts } }),\n      enabled: !!id && createEnabledRule(token, restOptions),\n      options: {\n        staleTime: restOptions.staleTime ?? config.staleTime,\n        gcTime: restOptions.gcTime ?? config.gcTime,\n        structuralSharing: restOptions.structuralSharing ?? config.structuralSharing,\n        refetchInterval: restOptions.refetchInterval,\n        refetchIntervalInBackground: restOptions.refetchIntervalInBackground,\n      },\n    });\n  }\n\n  // ========== useActions ==========\n\n  function useActions(): CrudActions<T, TCreate, TUpdate> {\n    const queryClient = useQueryClient();\n\n    const createMutation = createOptimisticMutation({\n      mutationFn: ({ token, organizationId, data }: MutationParams<TCreate>) =>\n        api.create({ token, organizationId, data }),\n      queryClient,\n      queryKeys: [KEYS.lists()],\n      optimisticUpdate: (oldData, { data }) => {\n        const optimisticItem = {\n          ...(data as object),\n          _optimistic: true,\n          [getItemId(data) ? \"id\" : \"_id\"]: getItemId(data) ?? `temp-${Date.now()}`,\n        };\n        return updateListCache(oldData, (arr: unknown[]) => [optimisticItem, ...(arr || [])]);\n      },\n      onSuccess: (data, variables) => {\n        callbacks.onCreate?.onSuccess?.(data as T, { data: variables.data }, undefined);\n      },\n      onError: (error, variables) => {\n        callbacks.onCreate?.onError?.(error, { data: variables.data }, undefined);\n      },\n      messages: { success: config.messages.createSuccess, error: config.messages.createError },\n      toastHandler: instanceToast,\n    });\n\n    const updateMutation = createOptimisticMutation({\n      mutationFn: ({ token, organizationId, id, data }: UpdateParams<TUpdate>) =>\n        api.update({ token, organizationId, id, data }),\n      queryClient,\n      queryKeys: [KEYS.lists()],\n      optimisticUpdate: (oldData, { id, data }) => {\n        const updated = updateListCache(oldData, (arr: unknown[]) =>\n          (arr || []).map((item) => (getItemId(item) === id ? { ...(item as object), ...(data as object) } : item))\n        );\n        queryClient.setQueryData(KEYS.detail(id), (current: unknown) =>\n          current ? { ...(current as object), data: { ...((current as { data?: object }).data || {}), ...(data as object) } } : current\n        );\n        return updated;\n      },\n      onSuccess: (data, { id }) => {\n        queryClient.invalidateQueries({ queryKey: KEYS.detail(id) });\n        callbacks.onUpdate?.onSuccess?.(data as T, { id, data: {} as TUpdate }, undefined);\n      },\n      onError: (error, { id, data }) => {\n        callbacks.onUpdate?.onError?.(error, { id, data }, undefined);\n      },\n      messages: { success: config.messages.updateSuccess, error: config.messages.updateError },\n      toastHandler: instanceToast,\n    });\n\n    const deleteMutation = createOptimisticMutation({\n      mutationFn: ({ token, organizationId, id }: DeleteParams) => api.delete({ token, organizationId, id }),\n      queryClient,\n      queryKeys: [KEYS.lists()],\n      optimisticUpdate: (oldData, { id }) => {\n        queryClient.removeQueries({ queryKey: KEYS.detail(id) });\n        return updateListCache(oldData, (arr: unknown[]) => (arr || []).filter((item) => getItemId(item) !== id));\n      },\n      onSuccess: (data, { id }) => {\n        callbacks.onDelete?.onSuccess?.(data, { id }, undefined);\n      },\n      onError: (error, { id }) => {\n        callbacks.onDelete?.onError?.(error, { id }, undefined);\n      },\n      messages: { success: config.messages.deleteSuccess, error: config.messages.deleteError },\n      toastHandler: instanceToast,\n    });\n\n    const resolveAuth = <P extends { token?: string | null; organizationId?: string | null }>(params: P): P => {\n      const auth = getAuthContext();\n      return {\n        ...params,\n        token: params.token ?? auth.token,\n        organizationId: params.organizationId ?? auth.organizationId,\n      };\n    };\n\n    const create = async (params: MutationParams<TCreate>, options?: CallOptions<T>): Promise<T> => {\n      try {\n        const result = await createMutation.mutateAsync(resolveAuth(params));\n        options?.onSuccess?.(result as T);\n        return result as T;\n      } catch (error) {\n        options?.onError?.(error as Error);\n        throw error;\n      }\n    };\n\n    const update = async (params: UpdateParams<TUpdate>, options?: CallOptions<T>): Promise<T> => {\n      try {\n        const result = await updateMutation.mutateAsync(resolveAuth(params));\n        options?.onSuccess?.(result as T);\n        return result as T;\n      } catch (error) {\n        options?.onError?.(error as Error);\n        throw error;\n      }\n    };\n\n    const remove = async (params: DeleteParams, options?: CallOptions): Promise<unknown> => {\n      try {\n        const result = await deleteMutation.mutateAsync(resolveAuth(params));\n        options?.onSuccess?.(result);\n        return result;\n      } catch (error) {\n        options?.onError?.(error as Error);\n        throw error;\n      }\n    };\n\n    return {\n      create,\n      update,\n      remove,\n      isCreating: createMutation.isPending,\n      isUpdating: updateMutation.isPending,\n      isDeleting: deleteMutation.isPending,\n      isMutating: createMutation.isPending || updateMutation.isPending || deleteMutation.isPending,\n    };\n  }\n\n  // ========== useInfiniteList ==========\n\n  function useInfiniteList(\n    tokenOrParams?: string | null | Record<string, unknown>,\n    paramsOrOptions?: Record<string, unknown> | InfiniteListQueryOptions,\n    maybeOptions?: InfiniteListQueryOptions,\n  ): InfiniteListQueryResult<T> {\n    let token: string | null;\n    let params: Record<string, unknown>;\n    let options: InfiniteListQueryOptions;\n\n    if (tokenOrParams === null || typeof tokenOrParams === 'string') {\n      token = tokenOrParams;\n      params = (paramsOrOptions as Record<string, unknown>) ?? {};\n      options = maybeOptions ?? {};\n    } else {\n      const auth = getAuthContext();\n      token = auth.token;\n      params = (tokenOrParams as Record<string, unknown>) ?? {};\n      options = (paramsOrOptions as InfiniteListQueryOptions) ?? {};\n      if (auth.organizationId && !params.organizationId) {\n        params = { ...params, organizationId: auth.organizationId };\n      }\n    }\n\n    const { organizationId, ...restParams } = params;\n    const scope = options._scope || (organizationId ? \"tenant\" : \"super-admin\");\n    const { request: requestOpts, ...queryOpts } = options;\n\n    return createInfiniteListQuery<T>({\n      queryKey: [...KEYS.scopedList(scope, { organizationId, ...restParams }), 'infinite'],\n      queryFn: ({ pageParam }) => {\n        const paginationParams = typeof pageParam === 'string'\n          ? { after: pageParam }\n          : { page: pageParam };\n\n        return api.getAll({\n          token,\n          organizationId: organizationId as string | null,\n          params: { ...restParams, ...paginationParams },\n          options: { ...requestOpts },\n        });\n      },\n      enabled: createEnabledRule(token, queryOpts),\n      initialPageParam: restParams.after ? restParams.after : 1,\n      getNextPageParam: (lastPage) => {\n        const page = lastPage as PaginatedResponse<T>;\n        if (isKeysetPagination(page)) {\n          return page.hasMore ? page.next : undefined;\n        }\n        if (isOffsetPagination(page)) {\n          return page.hasNext ? page.page + 1 : undefined;\n        }\n        // Fallback: check common pagination fields\n        const p = page as unknown as Record<string, unknown>;\n        if (typeof p.hasNext === 'boolean' && typeof p.page === 'number') {\n          return p.hasNext ? (p.page as number) + 1 : undefined;\n        }\n        return undefined;\n      },\n      options: {\n        staleTime: queryOpts.staleTime ?? config.staleTime,\n        gcTime: queryOpts.gcTime ?? config.gcTime,\n        refetchOnWindowFocus: queryOpts.refetchOnWindowFocus ?? config.refetchOnWindowFocus,\n        structuralSharing: queryOpts.structuralSharing ?? config.structuralSharing,\n      },\n    });\n  }\n\n  // ========== useNavigation ==========\n\n  function useNavigation(): NavigateFn<T> {\n    const queryClient = useQueryClient();\n    const activeRouterHook = instanceNavigation ?? useRouterHook;\n    const router = activeRouterHook?.();\n\n    return useCallback(\n      (href: string, item: T, options: NavigationOptions = {}) => {\n        const id = getItemId(item);\n        if (id) {\n          queryClient.setQueryData(KEYS.detail(id), { data: item });\n        }\n\n        if (!router) return;\n\n        const { scroll = true, replace = false } = options;\n        if (replace) {\n          router.replace(href, { scroll });\n        } else {\n          router.push(href, { scroll });\n        }\n      },\n      [queryClient, router]\n    );\n  }\n\n  return {\n    KEYS,\n    cache,\n    useList,\n    useDetail,\n    useInfiniteList,\n    useActions,\n    useNavigation,\n  };\n}\n"],"mappings":"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"}
+{"version":3,"file":"hooks.js","names":[],"sources":["../src/hooks.ts"],"sourcesContent":["\"use client\";\n\nimport { useQueryClient, useMutation, type QueryKey } from \"@tanstack/react-query\";\nimport { useCallback, useRef } from \"react\";\nimport { createOptimisticMutation, useMutationWithTransition } from \"./mutation.js\";\nimport type { MutationMessages } from \"./mutation.js\";\nimport {\n  createListQuery,\n  createDetailQuery,\n  createInfiniteListQuery,\n  updateListCache,\n  getItemId,\n  createQueryKeys,\n  createCacheUtils,\n  DEFAULT_QUERY_CONFIG,\n} from \"./query.js\";\nimport type {\n  QueryKeys,\n  CacheUtils,\n  ListQueryOptions,\n  DetailQueryOptions,\n  ListQueryResult,\n  DetailQueryResult,\n  InfiniteListQueryOptions,\n  InfiniteListQueryResult,\n} from \"./query.js\";\nimport {\n  isOffsetPagination,\n  isKeysetPagination,\n} from \"./api.js\";\nimport type { PaginatedResponse } from \"./api.js\";\nimport type { MutationCallbacks, TransitionMutationReturn } from \"./mutation.js\";\nimport { getAuthMode, getAuthContext } from \"./client.js\";\nimport type { ArcClient, ToastHandler, UseRouterHook } from \"./client.js\";\n\n// Re-export UseRouterHook for backward compatibility\nexport type { UseRouterHook } from \"./client.js\";\n\n// ============================================================================\n// Types\n// ============================================================================\n\nexport interface CrudApi<T, TCreate = Partial<T>, TUpdate = Partial<T>> {\n  /** Scope from BaseApi — used to auto-detect platformScoped */\n  scope?: 'tenant' | 'platform';\n\n  getAll: (options: {\n    token?: string | null;\n    organizationId?: string | null;\n    params?: Record<string, unknown>;\n    options?: { signal?: AbortSignal; [key: string]: unknown };\n  }) => Promise<unknown>;\n\n  getById: (options: {\n    id: string;\n    token?: string | null;\n    organizationId?: string | null;\n    params?: { select?: string; populate?: string | string[] };\n    options?: { signal?: AbortSignal; [key: string]: unknown };\n  }) => Promise<unknown>;\n\n  create: (options: {\n    token?: string | null;\n    organizationId?: string | null;\n    data: TCreate;\n  }) => Promise<unknown>;\n\n  update: (options: {\n    token?: string | null;\n    organizationId?: string | null;\n    id: string;\n    data: TUpdate;\n  }) => Promise<unknown>;\n\n  delete: (options: {\n    token?: string | null;\n    organizationId?: string | null;\n    id: string;\n  }) => Promise<unknown>;\n\n  upload?: (options: {\n    token?: string | null;\n    organizationId?: string | null;\n    data: FormData;\n    id?: string;\n    path?: string;\n  }) => Promise<unknown>;\n\n  search?: (options: {\n    token?: string | null;\n    organizationId?: string | null;\n    params?: Record<string, unknown>;\n    options?: { signal?: AbortSignal; [key: string]: unknown };\n  }) => Promise<unknown>;\n}\n\nexport interface CrudHooksConfig<T, TCreate = Partial<T>, TUpdate = Partial<T>> {\n  api: CrudApi<T, TCreate, TUpdate>;\n  entityKey: string;\n  singular: string;\n  plural?: string;\n  /**\n   * Platform-scoped hooks skip automatic organizationId injection.\n   *\n   * Use this for admin/superadmin hooks that query across all orgs\n   * (e.g., APIs configured with `x-arc-scope: platform`).\n   *\n   * When true, the hooks will NOT auto-inject the user's active\n   * organizationId into requests — the API's own headers control scoping.\n   *\n   * @default false\n   */\n  platformScoped?: boolean;\n  defaults?: {\n    staleTime?: number;\n    gcTime?: number;\n    refetchOnWindowFocus?: boolean;\n    structuralSharing?: boolean;\n    messages?: {\n      createSuccess?: string;\n      createError?: string;\n      updateSuccess?: string;\n      updateError?: string;\n      deleteSuccess?: string;\n      deleteError?: string;\n    };\n  };\n  callbacks?: {\n    onCreate?: MutationCallbacks<T, { data: TCreate }>;\n    onUpdate?: MutationCallbacks<T, { id: string; data: TUpdate }>;\n    onDelete?: MutationCallbacks<unknown, { id: string }>;\n  };\n  client?: ArcClient;\n}\n\nexport interface MutationParams<TData> {\n  token?: string | null;\n  organizationId?: string | null;\n  data: TData;\n}\n\nexport interface UpdateParams<TData> extends MutationParams<TData> {\n  id: string;\n}\n\nexport interface DeleteParams {\n  token?: string | null;\n  organizationId?: string | null;\n  id: string;\n}\n\nexport interface CallOptions<TData = unknown> {\n  onSuccess?: (data: TData) => void;\n  onError?: (error: Error) => void;\n  onSettled?: (data: TData | undefined, error: Error | null) => void;\n  silent?: boolean;\n}\n\nexport interface CrudActions<T, TCreate, TUpdate> {\n  create: (params: MutationParams<TCreate>, options?: CallOptions<T>) => Promise<T>;\n  update: (params: UpdateParams<TUpdate>, options?: CallOptions<T>) => Promise<T>;\n  remove: (params: DeleteParams, options?: CallOptions) => Promise<unknown>;\n  isCreating: boolean;\n  isUpdating: boolean;\n  isDeleting: boolean;\n  isMutating: boolean;\n}\n\nexport interface NavigationOptions {\n  scroll?: boolean;\n  replace?: boolean;\n}\n\nexport type NavigateFn<T> = (href: string, item: T, options?: NavigationOptions) => void;\n\nexport interface CrudHooksReturn<T, TCreate, TUpdate> {\n  KEYS: QueryKeys;\n  cache: CacheUtils<T>;\n  useList: {\n    /** New signature — auto-injects token/orgId from configureAuth() context */\n    (params?: Record<string, unknown>, options?: ListQueryOptions<T>): ListQueryResult<T>;\n    /** Legacy signature — explicit token */\n    (token: string | null, params?: Record<string, unknown>, options?: ListQueryOptions<T>): ListQueryResult<T>;\n  };\n  useDetail: {\n    /** New signature — auto-injects token from configureAuth() context */\n    (id: string | null, options?: DetailQueryOptions<T>): DetailQueryResult<T>;\n    /** Legacy signature — explicit token */\n    (id: string | null, token: string | null, options?: DetailQueryOptions<T>): DetailQueryResult<T>;\n  };\n  useInfiniteList: {\n    /** New signature — auto-injects token/orgId from configureAuth() context */\n    (params?: Record<string, unknown>, options?: InfiniteListQueryOptions): InfiniteListQueryResult<T>;\n    /** Legacy signature — explicit token */\n    (token: string | null, params?: Record<string, unknown>, options?: InfiniteListQueryOptions): InfiniteListQueryResult<T>;\n  };\n  useActions: () => CrudActions<T, TCreate, TUpdate>;\n  useUpload: (options?: {\n    invalidateQueries?: QueryKey[];\n    messages?: MutationMessages;\n    onSuccess?: (data: unknown) => void;\n    onError?: (error: Error) => void;\n    onSettled?: (data: unknown | undefined, error: Error | null) => void;\n  }) => TransitionMutationReturn<unknown, { data: FormData; id?: string; path?: string }>;\n  useSearch: (query: string, params?: Record<string, unknown>, options?: ListQueryOptions<T>) => ListQueryResult<T>;\n  useCustomMutation: <TData = unknown, TVariables = unknown>(config: {\n    mutationFn: (variables: TVariables) => Promise<TData>;\n    invalidateQueries?: QueryKey[];\n    messages?: MutationMessages;\n    onSuccess?: (data: TData, variables: TVariables) => void;\n    onError?: (error: Error, variables: TVariables) => void;\n    onSettled?: (data: TData | undefined, error: Error | null, variables: TVariables) => void;\n  }) => TransitionMutationReturn<TData, TVariables>;\n  useNavigation: () => NavigateFn<T>;\n}\n\n// ============================================================================\n// Navigation Configuration (Global)\n// ============================================================================\n\nlet useRouterHook: UseRouterHook | null = null;\n\n/**\n * Configure the router hook for useNavigation. Call once at app init.\n *\n * @example\n * import { useRouter } from \"next/navigation\";\n * configureNavigation(useRouter);\n */\nexport function configureNavigation(hook: UseRouterHook): void {\n  useRouterHook = hook;\n}\n\n// ============================================================================\n// Enabled Rule\n// ============================================================================\n\nfunction createEnabledRule(token: string | null, options: { public?: boolean; enabled?: boolean }): boolean {\n  // Cookie-based auth: no token needed, queries always enabled (cookies sent via credentials: 'include')\n  if (getAuthMode() === 'cookie' || options.public) {\n    return options.enabled ?? true;\n  }\n  // Bearer token auth: require token to enable queries\n  return options.enabled !== undefined ? options.enabled && !!token : !!token;\n}\n\n// ============================================================================\n// Create CRUD Hooks Factory\n// ============================================================================\n\nexport function createCrudHooks<T, TCreate = Partial<T>, TUpdate = Partial<T>>({\n  api,\n  entityKey,\n  singular,\n  platformScoped,\n  defaults = {},\n  callbacks = {},\n  client,\n}: CrudHooksConfig<T, TCreate, TUpdate>): CrudHooksReturn<T, TCreate, TUpdate> {\n  // Auto-detect from api.scope when platformScoped is not explicitly set\n  const isPlatform = platformScoped ?? (api.scope === 'platform');\n  const KEYS = createQueryKeys(entityKey);\n  const cache = createCacheUtils<T>(KEYS);\n\n  // Resolve toast handler: client instance → global\n  const instanceToast: ToastHandler | undefined = client?.toast;\n  // Resolve navigation hook: client instance → global\n  const instanceNavigation: UseRouterHook | null = client?.navigation ?? null;\n\n  const config = {\n    ...DEFAULT_QUERY_CONFIG,\n    ...defaults,\n    structuralSharing: defaults.structuralSharing,\n    messages: {\n      createSuccess: `${singular} created successfully`,\n      createError: `Failed to create ${singular.toLowerCase()}`,\n      updateSuccess: `${singular} updated successfully`,\n      updateError: `Failed to update ${singular.toLowerCase()}`,\n      deleteSuccess: `${singular} deleted successfully`,\n      deleteError: `Failed to delete ${singular.toLowerCase()}`,\n      ...defaults.messages,\n    },\n  };\n\n  // ========== useList ==========\n\n  function useList(\n    tokenOrParams?: string | null | Record<string, unknown>,\n    paramsOrOptions?: Record<string, unknown> | ListQueryOptions,\n    maybeOptions?: ListQueryOptions,\n  ): ListQueryResult<T> {\n    let token: string | null;\n    let params: Record<string, unknown>;\n    let options: ListQueryOptions;\n\n    // Detect which overload: first arg is string|null = legacy, object/undefined = new\n    if (tokenOrParams === null || typeof tokenOrParams === 'string') {\n      token = tokenOrParams;\n      params = (paramsOrOptions as Record<string, unknown>) ?? {};\n      options = maybeOptions ?? {};\n    } else {\n      const auth = getAuthContext();\n      token = auth.token;\n      params = (tokenOrParams as Record<string, unknown>) ?? {};\n      options = (paramsOrOptions as ListQueryOptions) ?? {};\n      if (!isPlatform && auth.organizationId && !params.organizationId) {\n        params = { ...params, organizationId: auth.organizationId };\n      }\n    }\n\n    const { organizationId, ...restParams } = params;\n    const scope = options._scope || (isPlatform ? \"platform\" : organizationId ? \"tenant\" : \"super-admin\");\n    const { request: requestOpts, ...queryOpts } = options;\n\n    return createListQuery<T>({\n      queryKey: KEYS.scopedList(scope, { organizationId, ...restParams }),\n      queryFn: ({ signal }) => api.getAll({ token, organizationId: organizationId as string | null, params: restParams, options: { signal, ...requestOpts } }),\n      enabled: createEnabledRule(token, queryOpts),\n      options: {\n        staleTime: queryOpts.staleTime ?? config.staleTime,\n        gcTime: queryOpts.gcTime ?? config.gcTime,\n        refetchOnWindowFocus: queryOpts.refetchOnWindowFocus ?? config.refetchOnWindowFocus,\n        structuralSharing: queryOpts.structuralSharing ?? config.structuralSharing,\n        refetchInterval: queryOpts.refetchInterval,\n        refetchIntervalInBackground: queryOpts.refetchIntervalInBackground,\n      },\n      prefillDetailCache: queryOpts.prefillDetailCache ?? true,\n      detailKeyBuilder: (id) => KEYS.detail(id),\n      select: queryOpts.select,\n    });\n  }\n\n  // ========== useDetail ==========\n\n  function useDetail(\n    id: string | null,\n    tokenOrOptions?: string | null | DetailQueryOptions,\n    maybeOptions?: DetailQueryOptions,\n  ): DetailQueryResult<T> {\n    let token: string | null;\n    let options: DetailQueryOptions;\n\n    // Detect which overload: second arg is string|null = legacy, object/undefined = new\n    if (tokenOrOptions === null || typeof tokenOrOptions === 'string') {\n      token = tokenOrOptions;\n      options = maybeOptions ?? {};\n    } else {\n      const auth = getAuthContext();\n      token = auth.token;\n      options = (tokenOrOptions as DetailQueryOptions) ?? {};\n      if (!isPlatform && auth.organizationId && !options.organizationId) {\n        options = { ...options, organizationId: auth.organizationId };\n      }\n    }\n\n    const { organizationId, params: queryParams, request: requestOpts, ...restOptions } = options;\n\n    return createDetailQuery<T>({\n      queryKey: queryParams ? [...KEYS.detail(id || \"\"), queryParams] : KEYS.detail(id || \"\"),\n      queryFn: ({ signal }) => api.getById({ id: id!, token, organizationId, params: queryParams, options: { signal, ...requestOpts } }),\n      enabled: !!id && createEnabledRule(token, restOptions),\n      options: {\n        staleTime: restOptions.staleTime ?? config.staleTime,\n        gcTime: restOptions.gcTime ?? config.gcTime,\n        structuralSharing: restOptions.structuralSharing ?? config.structuralSharing,\n        refetchInterval: restOptions.refetchInterval,\n        refetchIntervalInBackground: restOptions.refetchIntervalInBackground,\n      },\n      select: restOptions.select,\n    });\n  }\n\n  // ========== useActions ==========\n\n  function useActions(): CrudActions<T, TCreate, TUpdate> {\n    const queryClient = useQueryClient();\n    const silentRef = useRef(false);\n    const shouldToast = useCallback(() => !silentRef.current, []);\n\n    const createMutation = createOptimisticMutation({\n      mutationFn: ({ token, organizationId, data }: MutationParams<TCreate>) =>\n        api.create({ token, organizationId, data }),\n      queryClient,\n      queryKeys: [KEYS.lists()],\n      shouldToast,\n      optimisticUpdate: (oldData, { data }) => {\n        const optimisticItem = {\n          ...(data as object),\n          _optimistic: true,\n          [getItemId(data) ? \"id\" : \"_id\"]: getItemId(data) ?? `temp-${Date.now()}`,\n        };\n        return updateListCache(oldData, (arr: unknown[]) => [optimisticItem, ...(arr || [])]);\n      },\n      onSuccess: (data, variables) => {\n        callbacks.onCreate?.onSuccess?.(data as T, { data: variables.data }, undefined);\n      },\n      onError: (error, variables) => {\n        callbacks.onCreate?.onError?.(error, { data: variables.data }, undefined);\n      },\n      onSettled: (data, error, variables) => {\n        callbacks.onCreate?.onSettled?.(data as T | undefined, error, { data: variables.data }, undefined);\n      },\n      messages: { success: config.messages.createSuccess, error: config.messages.createError },\n      toastHandler: instanceToast,\n    });\n\n    const updateMutation = createOptimisticMutation({\n      mutationFn: ({ token, organizationId, id, data }: UpdateParams<TUpdate>) =>\n        api.update({ token, organizationId, id, data }),\n      queryClient,\n      queryKeys: [KEYS.lists()],\n      shouldToast,\n      optimisticUpdate: (oldData, { id, data }) => {\n        const updated = updateListCache(oldData, (arr: unknown[]) =>\n          (arr || []).map((item) => (getItemId(item) === id ? { ...(item as object), ...(data as object) } : item))\n        );\n        queryClient.setQueryData(KEYS.detail(id), (current: unknown) =>\n          current ? { ...(current as object), data: { ...((current as { data?: object }).data || {}), ...(data as object) } } : current\n        );\n        return updated;\n      },\n      onSuccess: (data, { id, data: updateData }) => {\n        queryClient.invalidateQueries({ queryKey: KEYS.detail(id) });\n        callbacks.onUpdate?.onSuccess?.(data as T, { id, data: updateData }, undefined);\n      },\n      onError: (error, { id, data }) => {\n        callbacks.onUpdate?.onError?.(error, { id, data }, undefined);\n      },\n      onSettled: (data, error, { id, data: updateData }) => {\n        callbacks.onUpdate?.onSettled?.(data as T | undefined, error, { id, data: updateData }, undefined);\n      },\n      messages: { success: config.messages.updateSuccess, error: config.messages.updateError },\n      toastHandler: instanceToast,\n    });\n\n    const deleteMutation = createOptimisticMutation({\n      mutationFn: ({ token, organizationId, id }: DeleteParams) => api.delete({ token, organizationId, id }),\n      queryClient,\n      queryKeys: [KEYS.lists()],\n      shouldToast,\n      optimisticUpdate: (oldData, { id }) => {\n        queryClient.removeQueries({ queryKey: KEYS.detail(id) });\n        return updateListCache(oldData, (arr: unknown[]) => (arr || []).filter((item) => getItemId(item) !== id));\n      },\n      onSuccess: (data, { id }) => {\n        callbacks.onDelete?.onSuccess?.(data, { id }, undefined);\n      },\n      onError: (error, { id }) => {\n        callbacks.onDelete?.onError?.(error, { id }, undefined);\n      },\n      onSettled: (data, error, { id }) => {\n        callbacks.onDelete?.onSettled?.(data, error, { id }, undefined);\n      },\n      messages: { success: config.messages.deleteSuccess, error: config.messages.deleteError },\n      toastHandler: instanceToast,\n    });\n\n    const resolveAuth = <P extends { token?: string | null; organizationId?: string | null }>(params: P): P => {\n      const auth = getAuthContext();\n      return {\n        ...params,\n        token: params.token ?? auth.token,\n        organizationId: isPlatform ? (params.organizationId ?? null) : (params.organizationId ?? auth.organizationId),\n      };\n    };\n\n    const create = async (params: MutationParams<TCreate>, options?: CallOptions<T>): Promise<T> => {\n      silentRef.current = options?.silent ?? false;\n      try {\n        const result = await createMutation.mutateAsync(resolveAuth(params));\n        options?.onSuccess?.(result as T);\n        options?.onSettled?.(result as T, null);\n        return result as T;\n      } catch (error) {\n        options?.onError?.(error as Error);\n        options?.onSettled?.(undefined, error as Error);\n        throw error;\n      } finally {\n        silentRef.current = false;\n      }\n    };\n\n    const update = async (params: UpdateParams<TUpdate>, options?: CallOptions<T>): Promise<T> => {\n      silentRef.current = options?.silent ?? false;\n      try {\n        const result = await updateMutation.mutateAsync(resolveAuth(params));\n        options?.onSuccess?.(result as T);\n        options?.onSettled?.(result as T, null);\n        return result as T;\n      } catch (error) {\n        options?.onError?.(error as Error);\n        options?.onSettled?.(undefined, error as Error);\n        throw error;\n      } finally {\n        silentRef.current = false;\n      }\n    };\n\n    const remove = async (params: DeleteParams, options?: CallOptions): Promise<unknown> => {\n      silentRef.current = options?.silent ?? false;\n      try {\n        const result = await deleteMutation.mutateAsync(resolveAuth(params));\n        options?.onSuccess?.(result);\n        options?.onSettled?.(result, null);\n        return result;\n      } catch (error) {\n        options?.onError?.(error as Error);\n        options?.onSettled?.(undefined, error as Error);\n        throw error;\n      } finally {\n        silentRef.current = false;\n      }\n    };\n\n    return {\n      create,\n      update,\n      remove,\n      isCreating: createMutation.isPending,\n      isUpdating: updateMutation.isPending,\n      isDeleting: deleteMutation.isPending,\n      isMutating: createMutation.isPending || updateMutation.isPending || deleteMutation.isPending,\n    };\n  }\n\n  // ========== useInfiniteList ==========\n\n  function useInfiniteList(\n    tokenOrParams?: string | null | Record<string, unknown>,\n    paramsOrOptions?: Record<string, unknown> | InfiniteListQueryOptions,\n    maybeOptions?: InfiniteListQueryOptions,\n  ): InfiniteListQueryResult<T> {\n    let token: string | null;\n    let params: Record<string, unknown>;\n    let options: InfiniteListQueryOptions;\n\n    if (tokenOrParams === null || typeof tokenOrParams === 'string') {\n      token = tokenOrParams;\n      params = (paramsOrOptions as Record<string, unknown>) ?? {};\n      options = maybeOptions ?? {};\n    } else {\n      const auth = getAuthContext();\n      token = auth.token;\n      params = (tokenOrParams as Record<string, unknown>) ?? {};\n      options = (paramsOrOptions as InfiniteListQueryOptions) ?? {};\n      if (!isPlatform && auth.organizationId && !params.organizationId) {\n        params = { ...params, organizationId: auth.organizationId };\n      }\n    }\n\n    const { organizationId, ...restParams } = params;\n    const scope = options._scope || (organizationId ? \"tenant\" : \"super-admin\");\n    const { request: requestOpts, ...queryOpts } = options;\n\n    return createInfiniteListQuery<T>({\n      queryKey: [...KEYS.scopedList(scope, { organizationId, ...restParams }), 'infinite'],\n      queryFn: ({ pageParam, signal }) => {\n        const paginationParams = typeof pageParam === 'string'\n          ? { after: pageParam }\n          : { page: pageParam };\n\n        return api.getAll({\n          token,\n          organizationId: organizationId as string | null,\n          params: { ...restParams, ...paginationParams },\n          options: { signal, ...requestOpts },\n        });\n      },\n      enabled: createEnabledRule(token, queryOpts),\n      initialPageParam: restParams.after ? restParams.after : 1,\n      getNextPageParam: (lastPage) => {\n        const page = lastPage as PaginatedResponse<T>;\n        if (isKeysetPagination(page)) {\n          return page.hasMore ? page.next : undefined;\n        }\n        if (isOffsetPagination(page)) {\n          return page.hasNext ? page.page + 1 : undefined;\n        }\n        // Fallback: check common pagination fields\n        const p = page as unknown as Record<string, unknown>;\n        if (typeof p.hasNext === 'boolean' && typeof p.page === 'number') {\n          return p.hasNext ? (p.page as number) + 1 : undefined;\n        }\n        return undefined;\n      },\n      options: {\n        staleTime: queryOpts.staleTime ?? config.staleTime,\n        gcTime: queryOpts.gcTime ?? config.gcTime,\n        refetchOnWindowFocus: queryOpts.refetchOnWindowFocus ?? config.refetchOnWindowFocus,\n        structuralSharing: queryOpts.structuralSharing ?? config.structuralSharing,\n      },\n    });\n  }\n\n  // ========== useUpload ==========\n\n  function useUpload(options?: {\n    invalidateQueries?: QueryKey[];\n    messages?: MutationMessages;\n    onSuccess?: (data: unknown) => void;\n    onError?: (error: Error) => void;\n    onSettled?: (data: unknown | undefined, error: Error | null) => void;\n  }) {\n    if (!api.upload) {\n      throw new Error(`[arc-next] \"${entityKey}\" api does not define an upload method`);\n    }\n\n    const uploadApi = api.upload;\n\n    return useMutationWithTransition<unknown, { data: FormData; id?: string; path?: string }>({\n      mutationFn: ({ data, id, path }) => {\n        const auth = getAuthContext();\n        return uploadApi({ token: auth.token, organizationId: isPlatform ? null : auth.organizationId, data, id, path });\n      },\n      invalidateQueries: options?.invalidateQueries ?? [KEYS.lists()],\n      onSuccess: (data) => options?.onSuccess?.(data),\n      onError: (error) => options?.onError?.(error),\n      onSettled: (data, error) => options?.onSettled?.(data, error),\n      messages: options?.messages ?? {\n        success: `${singular} uploaded successfully`,\n        error: `Failed to upload ${singular.toLowerCase()}`,\n      },\n      toastHandler: instanceToast,\n    });\n  }\n\n  // ========== useSearch ==========\n\n  function useSearch(\n    query: string,\n    params?: Record<string, unknown>,\n    options?: ListQueryOptions<T>,\n  ): ListQueryResult<T> {\n    if (!api.search) {\n      throw new Error(`[arc-next] \"${entityKey}\" api does not define a search method`);\n    }\n\n    const searchApi = api.search;\n    const auth = getAuthContext();\n    const token = auth.token;\n    const organizationId = platformScoped ? null : (params?.organizationId as string | null ?? auth.organizationId);\n    const { organizationId: _, ...restParams } = params ?? {};\n    const searchParams = { q: query, ...restParams };\n    const { request: requestOpts, ...queryOpts } = options ?? {};\n\n    // Include organizationId in query key when present to isolate per-tenant search cache\n    const searchKeyParams = organizationId\n      ? { organizationId, ...searchParams }\n      : searchParams;\n\n    return createListQuery<T>({\n      queryKey: [...KEYS.lists(), 'search', searchKeyParams],\n      queryFn: ({ signal }) => searchApi({\n        token,\n        organizationId,\n        params: searchParams,\n        options: { signal, ...requestOpts },\n      }),\n      enabled: query.length > 0 && createEnabledRule(token, queryOpts),\n      options: {\n        staleTime: queryOpts.staleTime ?? config.staleTime,\n        gcTime: queryOpts.gcTime ?? config.gcTime,\n      },\n      select: queryOpts.select,\n    });\n  }\n\n  // ========== useCustomMutation ==========\n\n  function useCustomMutation<TData = unknown, TVariables = unknown>(mutationConfig: {\n    mutationFn: (variables: TVariables) => Promise<TData>;\n    invalidateQueries?: QueryKey[];\n    messages?: MutationMessages;\n    onSuccess?: (data: TData, variables: TVariables) => void;\n    onError?: (error: Error, variables: TVariables) => void;\n    onSettled?: (data: TData | undefined, error: Error | null, variables: TVariables) => void;\n  }) {\n    return useMutationWithTransition<TData, TVariables>({\n      mutationFn: mutationConfig.mutationFn,\n      invalidateQueries: mutationConfig.invalidateQueries ?? [KEYS.lists()],\n      onSuccess: mutationConfig.onSuccess,\n      onError: mutationConfig.onError,\n      onSettled: mutationConfig.onSettled,\n      messages: mutationConfig.messages,\n      toastHandler: instanceToast,\n    });\n  }\n\n  // ========== useNavigation ==========\n\n  function useNavigation(): NavigateFn<T> {\n    const queryClient = useQueryClient();\n    const activeRouterHook = instanceNavigation ?? useRouterHook;\n    const router = activeRouterHook?.();\n\n    return useCallback(\n      (href: string, item: T, options: NavigationOptions = {}) => {\n        const id = getItemId(item);\n        if (id) {\n          queryClient.setQueryData(KEYS.detail(id), { data: item });\n        }\n\n        if (!router) return;\n\n        const { scroll = true, replace = false } = options;\n        if (replace) {\n          router.replace(href, { scroll });\n        } else {\n          router.push(href, { scroll });\n        }\n      },\n      [queryClient, router]\n    );\n  }\n\n  return {\n    KEYS,\n    cache,\n    useList,\n    useDetail,\n    useInfiniteList,\n    useActions,\n    useUpload,\n    useSearch,\n    useCustomMutation,\n    useNavigation,\n  };\n}\n"],"mappings":"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"}

package/dist/mutation.d.ts

@@ -1,6 +1,6 @@
 import { ToastHandler } from "./client.js";
 import * as _tanstack_react_query0 from "@tanstack/react-query";
-import { QueryClient, QueryKey } from "@tanstack/react-query";
+import { QueryClient, QueryKey, UseMutateAsyncFunction, UseMutateFunction } from "@tanstack/react-query";
 
 //#region src/mutation.d.ts
 interface MutationMessages {
@@ -13,6 +13,16 @@ interface MutationCallbacks<TData, TVariables, TContext = unknown> {
   onError?: (error: Error, variables: TVariables, context: TContext) => void | Promise<void>;
   onSettled?: (data: TData | undefined, error: Error | null, variables: TVariables, context: TContext) => void | Promise<void>;
 }
+interface TransitionMutationReturn<TData, TVariables> {
+  mutate: UseMutateFunction<TData, Error, TVariables>;
+  mutateAsync: UseMutateAsyncFunction<TData, Error, TVariables>;
+  isPending: boolean;
+  isSuccess: boolean;
+  isError: boolean;
+  error: Error | null;
+  data: TData | undefined;
+  reset: () => void;
+}
 /**
  * Configure toast handler. Call once at app init.
  *
@@ -30,11 +40,13 @@ interface TransitionMutationConfig<TData, TVariables> {
   messages?: MutationMessages;
   useTransition?: boolean;
   showToast?: boolean;
+  /** Per-call toast guard — return false to suppress toast for this invocation */
+  shouldToast?: () => boolean;
   toastHandler?: ToastHandler;
 }
 declare function useMutationWithTransition<TData, TVariables>(config: TransitionMutationConfig<TData, TVariables>): {
-  mutate: _tanstack_react_query0.UseMutateFunction<TData, Error, TVariables, unknown>;
-  mutateAsync: _tanstack_react_query0.UseMutateAsyncFunction<TData, Error, TVariables, unknown>;
+  mutate: UseMutateFunction<TData, Error, TVariables, unknown>;
+  mutateAsync: UseMutateAsyncFunction<TData, Error, TVariables, unknown>;
   isPending: boolean;
   isSuccess: boolean;
   isError: boolean;
@@ -54,13 +66,13 @@ interface OptimisticMutationConfig<TData, TVariables> {
   toastHandler?: ToastHandler;
 }
 declare function useMutationWithOptimistic<TData, TVariables>(config: OptimisticMutationConfig<TData, TVariables>): {
-  mutate: _tanstack_react_query0.UseMutateFunction<TData, Error, TVariables, {
+  mutate: UseMutateFunction<TData, Error, TVariables, {
     previous: {
       key: readonly unknown[];
       data: unknown;
     }[];
   }>;
-  mutateAsync: _tanstack_react_query0.UseMutateAsyncFunction<TData, Error, TVariables, {
+  mutateAsync: UseMutateAsyncFunction<TData, Error, TVariables, {
     previous: {
       key: readonly unknown[];
       data: unknown;
@@ -80,19 +92,13 @@ interface CreateOptimisticMutationConfig<TData, TVariables> {
   optimisticUpdate?: (oldData: unknown, variables: TVariables) => unknown;
   onSuccess?: (data: TData, variables: TVariables) => void;
   onError?: (error: Error, variables: TVariables) => void;
+  onSettled?: (data: TData | undefined, error: Error | null, variables: TVariables) => void;
   messages?: MutationMessages;
+  /** Per-call toast guard — return false to suppress toast for this invocation */
+  shouldToast?: () => boolean;
   toastHandler?: ToastHandler;
 }
-declare function createOptimisticMutation<TData, TVariables>({
-  mutationFn,
-  queryClient,
-  queryKeys,
-  optimisticUpdate,
-  onSuccess,
-  onError,
-  messages,
-  toastHandler: instanceToast
-}: CreateOptimisticMutationConfig<TData, TVariables>): _tanstack_react_query0.UseMutationResult<TData, Error, TVariables, {
+declare function createOptimisticMutation<TData, TVariables>(config: CreateOptimisticMutationConfig<TData, TVariables>): _tanstack_react_query0.UseMutationResult<TData, Error, TVariables, {
   previous: {
     key: readonly unknown[];
     data: [readonly unknown[], unknown][];
@@ -114,5 +120,5 @@ declare const QUERY_CONFIGS: {
   };
 };
 //#endregion
-export { CreateOptimisticMutationConfig, MutationCallbacks, MutationMessages, OptimisticMutationConfig, QUERY_CONFIGS, type ToastHandler, TransitionMutationConfig, configureToast, createOptimisticMutation, useMutationWithOptimistic, useMutationWithTransition };
+export { CreateOptimisticMutationConfig, MutationCallbacks, MutationMessages, OptimisticMutationConfig, QUERY_CONFIGS, type ToastHandler, TransitionMutationConfig, TransitionMutationReturn, configureToast, createOptimisticMutation, useMutationWithOptimistic, useMutationWithTransition };
 //# sourceMappingURL=mutation.d.ts.map

package/dist/mutation.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"mutation.d.ts","names":[],"sources":["../src/mutation.ts"],"mappings":";;;;;UAciB,gBAAA;EACf,OAAA,cAAqB,IAAA,WAAe,SAAA;EACpC,KAAA,cAAmB,KAAA,EAAO,KAAA,EAAO,SAAA;AAAA;AAAA,UAGlB,iBAAA;EACf,QAAA,IAAY,SAAA,EAAW,UAAA,KAAe,QAAA,GAAW,OAAA,CAAQ,QAAA;EACzD,SAAA,IAAa,IAAA,EAAM,KAAA,EAAO,SAAA,EAAW,UAAA,EAAY,OAAA,EAAS,QAAA,YAAoB,OAAA;EAC9E,OAAA,IAAW,KAAA,EAAO,KAAA,EAAO,SAAA,EAAW,UAAA,EAAY,OAAA,EAAS,QAAA,YAAoB,OAAA;EAC7E,SAAA,IAAa,IAAA,EAAM,KAAA,cAAmB,KAAA,EAAO,KAAA,SAAc,SAAA,EAAW,UAAA,EAAY,OAAA,EAAS,QAAA,YAAoB,OAAA;AAAA;;;;;;AAJjH;;iBAuBgB,cAAA,CAAe,OAAA,EAAS,YAAA;AAAA,UAyCvB,wBAAA;EACf,UAAA,GAAa,SAAA,EAAW,UAAA,KAAe,OAAA,CAAQ,KAAA;EAC/C,iBAAA,GAAoB,QAAA;EACpB,SAAA,IAAa,IAAA,EAAM,KAAA,EAAO,SAAA,EAAW,UAAA;EACrC,OAAA,IAAW,KAAA,EAAO,KAAA,EAAO,SAAA,EAAW,UAAA;EACpC,SAAA,IAAa,IAAA,EAAM,KAAA,cAAmB,KAAA,EAAO,KAAA,SAAc,SAAA,EAAW,UAAA;EACtE,QAAA,GAAW,gBAAA;EACX,aAAA;EACA,SAAA;EACA,YAAA,GAAe,YAAA;AAAA;AAAA,iBAGD,yBAAA,mBAAA,CAA6C,MAAA,EAAQ,wBAAA,CAAyB,KAAA,EAAO,UAAA;;;;;;SAkDxE,KAAA;;;;UAUZ,wBAAA;EACf,UAAA,GAAa,SAAA,EAAW,UAAA,KAAe,OAAA,CAAQ,KAAA;EAC/C,SAAA,GAAY,QAAA;EACZ,gBAAA,IAAoB,OAAA,WAAkB,SAAA,EAAW,UAAA;EACjD,SAAA,IAAa,IAAA,EAAM,KAAA,EAAO,SAAA,EAAW,UAAA;EACrC,OAAA,IAAW,KAAA,EAAO,KAAA,EAAO,SAAA,EAAW,UAAA;EACpC,SAAA,IAAa,IAAA,EAAM,KAAA,cAAmB,KAAA,EAAO,KAAA,SAAc,SAAA,EAAW,UAAA;EACtE,QAAA,GAAW,gBAAA;EACX,SAAA;EACA,YAAA,GAAe,YAAA;AAAA;AAAA,iBAGD,yBAAA,mBAAA,CAA6C,MAAA,EAAQ,wBAAA,CAAyB,KAAA,EAAO,UAAA;;;;;;;;;;;;;;;;SA4DxE,KAAA;;;;UAUZ,8BAAA;EACf,UAAA,GAAa,SAAA,EAAW,UAAA,KAAe,OAAA,CAAQ,KAAA;EAC/C,WAAA,EAAa,WAAA;EACb,SAAA,EAAW,QAAA;EACX,gBAAA,IAAoB,OAAA,WAAkB,SAAA,EAAW,UAAA;EACjD,SAAA,IAAa,IAAA,EAAM,KAAA,EAAO,SAAA,EAAW,UAAA;EACrC,OAAA,IAAW,KAAA,EAAO,KAAA,EAAO,SAAA,EAAW,UAAA;EACpC,QAAA,GAAW,gBAAA;EACX,YAAA,GAAe,YAAA;AAAA;AAAA,iBAGD,wBAAA,mBAAA,CAAA;EACd,UAAA;EACA,WAAA;EACA,SAAA;EACA,gBAAA;EACA,SAAA;EACA,OAAA;EACA,QAAA;EACA,YAAA,EAAc;AAAA,GACb,8BAAA,CAA+B,KAAA,EAAO,UAAA,IAAW,sBAAA,CAAA,iBAAA,CAAA,KAAA,EAAA,KAAA,EAAA,UAAA;;;;;;cA6CvC,aAAA;EAAA"}
+{"version":3,"file":"mutation.d.ts","names":[],"sources":["../src/mutation.ts"],"mappings":"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"}

package/dist/mutation.js

@@ -49,11 +49,11 @@ function useMutationWithTransition(config) {
 			};
 			if (withTransition && invalidateQueries.length > 0) startTransition(invalidate);
 			else invalidate();
-			if (toast) showToast("success", messages, data, variables, void 0, instanceToast);
+			if (toast && (config.shouldToast?.() ?? true)) showToast("success", messages, data, variables, void 0, instanceToast);
 			onSuccess?.(data, variables);
 		},
 		onError: (error, variables) => {
-			if (toast) showToast("error", messages, null, variables, error, instanceToast);
+			if (toast && (config.shouldToast?.() ?? true)) showToast("error", messages, null, variables, error, instanceToast);
 			onError?.(error, variables);
 		},
 		onSettled: (data, error, variables) => {
@@ -112,7 +112,8 @@ function useMutationWithOptimistic(config) {
 		reset: mutation.reset
 	};
 }
-function createOptimisticMutation({ mutationFn, queryClient, queryKeys, optimisticUpdate, onSuccess, onError, messages, toastHandler: instanceToast }) {
+function createOptimisticMutation(config) {
+	const { mutationFn, queryClient, queryKeys, optimisticUpdate, onSuccess, onError, onSettled, messages, toastHandler: instanceToast } = config;
 	return useMutation({
 		mutationFn,
 		onMutate: async (variables) => {
@@ -132,7 +133,7 @@ function createOptimisticMutation({ mutationFn, queryClient, queryKeys, optimist
 			return { previous };
 		},
 		onSuccess: (data, variables) => {
-			if (messages?.success) showToast("success", messages, data, variables, void 0, instanceToast);
+			if ((config.shouldToast?.() ?? true) && messages?.success) showToast("success", messages, data, variables, void 0, instanceToast);
 			queryKeys.forEach((key) => queryClient.invalidateQueries({ queryKey: key }));
 			onSuccess?.(data, variables);
 		},
@@ -140,8 +141,11 @@ function createOptimisticMutation({ mutationFn, queryClient, queryKeys, optimist
 			context?.previous?.forEach(({ data }) => {
 				data.forEach(([qKey, qData]) => queryClient.setQueryData(qKey, qData));
 			});
-			showToast("error", messages, null, variables, error, instanceToast);
+			if (config.shouldToast?.() ?? true) showToast("error", messages, null, variables, error, instanceToast);
 			onError?.(error, variables);
+		},
+		onSettled: (data, error, variables) => {
+			onSettled?.(data, error, variables);
 		}
 	});
 }