@classytic/arc-next 0.1.0

package/dist/hooks.js

@@ -0,0 +1,357 @@
+"use client";
+
+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";
+
+//#region src/hooks.ts
+let useRouterHook = null;
+/**
+* Configure the router hook for useNavigation. Call once at app init.
+*
+* @example
+* import { useRouter } from "next/navigation";
+* configureNavigation(useRouter);
+*/
+function configureNavigation(hook) {
+	useRouterHook = hook;
+}
+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 }) {
+	const KEYS = createQueryKeys(entityKey);
+	const cache = createCacheUtils(KEYS);
+	const instanceToast = client?.toast;
+	const instanceNavigation = client?.navigation ?? null;
+	const config = {
+		...DEFAULT_QUERY_CONFIG,
+		...defaults,
+		structuralSharing: defaults.structuralSharing,
+		messages: {
+			createSuccess: `${singular} created successfully`,
+			createError: `Failed to create ${singular.toLowerCase()}`,
+			updateSuccess: `${singular} updated successfully`,
+			updateError: `Failed to update ${singular.toLowerCase()}`,
+			deleteSuccess: `${singular} deleted successfully`,
+			deleteError: `Failed to delete ${singular.toLowerCase()}`,
+			...defaults.messages
+		}
+	};
+	function useList(tokenOrParams, paramsOrOptions, maybeOptions) {
+		let token;
+		let params;
+		let options;
+		if (tokenOrParams === null || typeof tokenOrParams === "string") {
+			token = tokenOrParams;
+			params = paramsOrOptions ?? {};
+			options = maybeOptions ?? {};
+		} else {
+			const auth = getAuthContext();
+			token = auth.token;
+			params = tokenOrParams ?? {};
+			options = paramsOrOptions ?? {};
+			if (auth.organizationId && !params.organizationId) params = {
+				...params,
+				organizationId: auth.organizationId
+			};
+		}
+		const { organizationId, ...restParams } = params;
+		const scope = options._scope || (organizationId ? "tenant" : "super-admin");
+		const { request: requestOpts, ...queryOpts } = options;
+		return createListQuery({
+			queryKey: KEYS.scopedList(scope, {
+				organizationId,
+				...restParams
+			}),
+			queryFn: ({ signal }) => api.getAll({
+				token,
+				organizationId,
+				params: restParams,
+				options: {
+					signal,
+					...requestOpts
+				}
+			}),
+			enabled: createEnabledRule(token, queryOpts),
+			options: {
+				staleTime: queryOpts.staleTime ?? config.staleTime,
+				gcTime: queryOpts.gcTime ?? config.gcTime,
+				refetchOnWindowFocus: queryOpts.refetchOnWindowFocus ?? config.refetchOnWindowFocus,
+				structuralSharing: queryOpts.structuralSharing ?? config.structuralSharing,
+				refetchInterval: queryOpts.refetchInterval,
+				refetchIntervalInBackground: queryOpts.refetchIntervalInBackground
+			},
+			prefillDetailCache: queryOpts.prefillDetailCache ?? true,
+			detailKeyBuilder: (id) => KEYS.detail(id)
+		});
+	}
+	function useDetail(id, tokenOrOptions, maybeOptions) {
+		let token;
+		let options;
+		if (tokenOrOptions === null || typeof tokenOrOptions === "string") {
+			token = tokenOrOptions;
+			options = maybeOptions ?? {};
+		} else {
+			const auth = getAuthContext();
+			token = auth.token;
+			options = tokenOrOptions ?? {};
+			if (auth.organizationId && !options.organizationId) options = {
+				...options,
+				organizationId: auth.organizationId
+			};
+		}
+		const { organizationId, request: requestOpts, ...restOptions } = options;
+		return createDetailQuery({
+			queryKey: KEYS.detail(id || ""),
+			queryFn: ({ signal }) => api.getById({
+				id,
+				token,
+				organizationId,
+				options: {
+					signal,
+					...requestOpts
+				}
+			}),
+			enabled: !!id && createEnabledRule(token, restOptions),
+			options: {
+				staleTime: restOptions.staleTime ?? config.staleTime,
+				gcTime: restOptions.gcTime ?? config.gcTime,
+				structuralSharing: restOptions.structuralSharing ?? config.structuralSharing,
+				refetchInterval: restOptions.refetchInterval,
+				refetchIntervalInBackground: restOptions.refetchIntervalInBackground
+			}
+		});
+	}
+	function useActions() {
+		const queryClient = useQueryClient();
+		const createMutation = createOptimisticMutation({
+			mutationFn: ({ token, organizationId, data }) => api.create({
+				token,
+				organizationId,
+				data
+			}),
+			queryClient,
+			queryKeys: [KEYS.lists()],
+			optimisticUpdate: (oldData, { data }) => {
+				const optimisticItem = {
+					...data,
+					_optimistic: true,
+					[getItemId(data) ? "id" : "_id"]: getItemId(data) ?? `temp-${Date.now()}`
+				};
+				return updateListCache(oldData, (arr) => [optimisticItem, ...arr || []]);
+			},
+			onSuccess: (data, variables) => {
+				callbacks.onCreate?.onSuccess?.(data, { data: variables.data }, void 0);
+			},
+			onError: (error, variables) => {
+				callbacks.onCreate?.onError?.(error, { data: variables.data }, void 0);
+			},
+			messages: {
+				success: config.messages.createSuccess,
+				error: config.messages.createError
+			},
+			toastHandler: instanceToast
+		});
+		const updateMutation = createOptimisticMutation({
+			mutationFn: ({ token, organizationId, id, data }) => api.update({
+				token,
+				organizationId,
+				id,
+				data
+			}),
+			queryClient,
+			queryKeys: [KEYS.lists()],
+			optimisticUpdate: (oldData, { id, data }) => {
+				const updated = updateListCache(oldData, (arr) => (arr || []).map((item) => getItemId(item) === id ? {
+					...item,
+					...data
+				} : item));
+				queryClient.setQueryData(KEYS.detail(id), (current) => current ? {
+					...current,
+					data: {
+						...current.data || {},
+						...data
+					}
+				} : current);
+				return updated;
+			},
+			onSuccess: (data, { id }) => {
+				queryClient.invalidateQueries({ queryKey: KEYS.detail(id) });
+				callbacks.onUpdate?.onSuccess?.(data, {
+					id,
+					data: {}
+				}, void 0);
+			},
+			onError: (error, { id, data }) => {
+				callbacks.onUpdate?.onError?.(error, {
+					id,
+					data
+				}, void 0);
+			},
+			messages: {
+				success: config.messages.updateSuccess,
+				error: config.messages.updateError
+			},
+			toastHandler: instanceToast
+		});
+		const deleteMutation = createOptimisticMutation({
+			mutationFn: ({ token, organizationId, id }) => api.delete({
+				token,
+				organizationId,
+				id
+			}),
+			queryClient,
+			queryKeys: [KEYS.lists()],
+			optimisticUpdate: (oldData, { id }) => {
+				queryClient.removeQueries({ queryKey: KEYS.detail(id) });
+				return updateListCache(oldData, (arr) => (arr || []).filter((item) => getItemId(item) !== id));
+			},
+			onSuccess: (data, { id }) => {
+				callbacks.onDelete?.onSuccess?.(data, { id }, void 0);
+			},
+			onError: (error, { id }) => {
+				callbacks.onDelete?.onError?.(error, { id }, void 0);
+			},
+			messages: {
+				success: config.messages.deleteSuccess,
+				error: config.messages.deleteError
+			},
+			toastHandler: instanceToast
+		});
+		const resolveAuth = (params) => {
+			const auth = getAuthContext();
+			return {
+				...params,
+				token: params.token ?? auth.token,
+				organizationId: params.organizationId ?? auth.organizationId
+			};
+		};
+		const create = async (params, options) => {
+			try {
+				const result = await createMutation.mutateAsync(resolveAuth(params));
+				options?.onSuccess?.(result);
+				return result;
+			} catch (error) {
+				options?.onError?.(error);
+				throw error;
+			}
+		};
+		const update = async (params, options) => {
+			try {
+				const result = await updateMutation.mutateAsync(resolveAuth(params));
+				options?.onSuccess?.(result);
+				return result;
+			} catch (error) {
+				options?.onError?.(error);
+				throw error;
+			}
+		};
+		const remove = async (params, options) => {
+			try {
+				const result = await deleteMutation.mutateAsync(resolveAuth(params));
+				options?.onSuccess?.(result);
+				return result;
+			} catch (error) {
+				options?.onError?.(error);
+				throw error;
+			}
+		};
+		return {
+			create,
+			update,
+			remove,
+			isCreating: createMutation.isPending,
+			isUpdating: updateMutation.isPending,
+			isDeleting: deleteMutation.isPending,
+			isMutating: createMutation.isPending || updateMutation.isPending || deleteMutation.isPending
+		};
+	}
+	function useInfiniteList(tokenOrParams, paramsOrOptions, maybeOptions) {
+		let token;
+		let params;
+		let options;
+		if (tokenOrParams === null || typeof tokenOrParams === "string") {
+			token = tokenOrParams;
+			params = paramsOrOptions ?? {};
+			options = maybeOptions ?? {};
+		} else {
+			const auth = getAuthContext();
+			token = auth.token;
+			params = tokenOrParams ?? {};
+			options = paramsOrOptions ?? {};
+			if (auth.organizationId && !params.organizationId) params = {
+				...params,
+				organizationId: auth.organizationId
+			};
+		}
+		const { organizationId, ...restParams } = params;
+		const scope = options._scope || (organizationId ? "tenant" : "super-admin");
+		const { request: requestOpts, ...queryOpts } = options;
+		return createInfiniteListQuery({
+			queryKey: [...KEYS.scopedList(scope, {
+				organizationId,
+				...restParams
+			}), "infinite"],
+			queryFn: ({ signal, pageParam }) => {
+				const paginationParams = typeof pageParam === "string" ? { after: pageParam } : { page: pageParam };
+				return api.getAll({
+					token,
+					organizationId,
+					params: {
+						...restParams,
+						...paginationParams
+					},
+					options: {
+						signal,
+						...requestOpts
+					}
+				});
+			},
+			enabled: createEnabledRule(token, queryOpts),
+			initialPageParam: restParams.after ? restParams.after : 1,
+			getNextPageParam: (lastPage) => {
+				const page = lastPage;
+				if (isKeysetPagination(page)) return page.hasMore ? page.next : void 0;
+				if (isOffsetPagination(page)) return page.hasNext ? page.page + 1 : void 0;
+				const p = page;
+				if (typeof p.hasNext === "boolean" && typeof p.page === "number") return p.hasNext ? p.page + 1 : void 0;
+			},
+			options: {
+				staleTime: queryOpts.staleTime ?? config.staleTime,
+				gcTime: queryOpts.gcTime ?? config.gcTime,
+				refetchOnWindowFocus: queryOpts.refetchOnWindowFocus ?? config.refetchOnWindowFocus,
+				structuralSharing: queryOpts.structuralSharing ?? config.structuralSharing
+			}
+		});
+	}
+	function useNavigation() {
+		const queryClient = useQueryClient();
+		const router = (instanceNavigation ?? useRouterHook)?.();
+		return useCallback((href, item, options = {}) => {
+			const id = getItemId(item);
+			if (id) queryClient.setQueryData(KEYS.detail(id), { data: item });
+			if (!router) return;
+			const { scroll = true, replace = false } = options;
+			if (replace) router.replace(href, { scroll });
+			else router.push(href, { scroll });
+		}, [queryClient, router]);
+	}
+	return {
+		KEYS,
+		cache,
+		useList,
+		useDetail,
+		useInfiniteList,
+		useActions,
+		useNavigation
+	};
+}
+
+//#endregion
+export { configureNavigation, createCrudHooks };
+//# sourceMappingURL=hooks.js.map

package/dist/hooks.js.map

@@ -0,0 +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    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: ({ 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    });\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, request: requestOpts, ...restOptions } = options;\n\n    return createDetailQuery<T>({\n      queryKey: KEYS.detail(id || \"\"),\n      queryFn: ({ signal }) => api.getById({ id: id!, token, organizationId, 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    });\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: ({ signal, 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: { 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  // ========== 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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"}

package/dist/mutation.d.ts

@@ -0,0 +1,118 @@
+import { ToastHandler } from "./client.js";
+import * as _tanstack_react_query0 from "@tanstack/react-query";
+import { QueryClient, QueryKey } from "@tanstack/react-query";
+
+//#region src/mutation.d.ts
+interface MutationMessages {
+  success?: string | ((data: unknown, variables: unknown) => string);
+  error?: string | ((error: Error, variables: unknown) => string);
+}
+interface MutationCallbacks<TData, TVariables, TContext = unknown> {
+  onMutate?: (variables: TVariables) => TContext | Promise<TContext>;
+  onSuccess?: (data: TData, variables: TVariables, context: TContext) => void | Promise<void>;
+  onError?: (error: Error, variables: TVariables, context: TContext) => void | Promise<void>;
+  onSettled?: (data: TData | undefined, error: Error | null, variables: TVariables, context: TContext) => void | Promise<void>;
+}
+/**
+ * Configure toast handler. Call once at app init.
+ *
+ * @example
+ * import { toast } from "sonner";
+ * configureToast({ success: toast.success, error: toast.error });
+ */
+declare function configureToast(handler: ToastHandler): void;
+interface TransitionMutationConfig<TData, TVariables> {
+  mutationFn: (variables: TVariables) => Promise<TData>;
+  invalidateQueries?: QueryKey[];
+  onSuccess?: (data: TData, variables: TVariables) => void;
+  onError?: (error: Error, variables: TVariables) => void;
+  onSettled?: (data: TData | undefined, error: Error | null, variables: TVariables) => void;
+  messages?: MutationMessages;
+  useTransition?: boolean;
+  showToast?: 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>;
+  isPending: boolean;
+  isSuccess: boolean;
+  isError: boolean;
+  error: Error | null;
+  data: TData | undefined;
+  reset: () => void;
+};
+interface OptimisticMutationConfig<TData, TVariables> {
+  mutationFn: (variables: TVariables) => Promise<TData>;
+  queryKeys?: QueryKey[];
+  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;
+  showToast?: boolean;
+  toastHandler?: ToastHandler;
+}
+declare function useMutationWithOptimistic<TData, TVariables>(config: OptimisticMutationConfig<TData, TVariables>): {
+  mutate: _tanstack_react_query0.UseMutateFunction<TData, Error, TVariables, {
+    previous: {
+      key: readonly unknown[];
+      data: unknown;
+    }[];
+  }>;
+  mutateAsync: _tanstack_react_query0.UseMutateAsyncFunction<TData, Error, TVariables, {
+    previous: {
+      key: readonly unknown[];
+      data: unknown;
+    }[];
+  }>;
+  isPending: boolean;
+  isSuccess: boolean;
+  isError: boolean;
+  error: Error | null;
+  data: TData | undefined;
+  reset: () => void;
+};
+interface CreateOptimisticMutationConfig<TData, TVariables> {
+  mutationFn: (variables: TVariables) => Promise<TData>;
+  queryClient: QueryClient;
+  queryKeys: QueryKey[];
+  optimisticUpdate?: (oldData: unknown, variables: TVariables) => unknown;
+  onSuccess?: (data: TData, variables: TVariables) => void;
+  onError?: (error: Error, variables: TVariables) => void;
+  messages?: MutationMessages;
+  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, {
+  previous: {
+    key: readonly unknown[];
+    data: [readonly unknown[], unknown][];
+  }[];
+}>;
+declare const QUERY_CONFIGS: {
+  readonly realtime: {
+    readonly staleTime: 20000;
+    readonly refetchInterval: 30000;
+  };
+  readonly frequent: {
+    readonly staleTime: 60000;
+  };
+  readonly stable: {
+    readonly staleTime: 300000;
+  };
+  readonly static: {
+    readonly staleTime: 600000;
+  };
+};
+//#endregion
+export { CreateOptimisticMutationConfig, MutationCallbacks, MutationMessages, OptimisticMutationConfig, QUERY_CONFIGS, type ToastHandler, TransitionMutationConfig, configureToast, createOptimisticMutation, useMutationWithOptimistic, useMutationWithTransition };
+//# sourceMappingURL=mutation.d.ts.map

package/dist/mutation.d.ts.map

@@ -0,0 +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"}