@alneas/appkit-react 0.1.0 → 0.3.0

package/dist/tools/lib/data-access/react-query-provider.d.ts

@@ -1,10 +1,27 @@
 import { default as React } from 'react';
 import { DataAccessAdapter } from './types.js';
 /**
- * データアクセス層のアダプターを提供するコンテキストプロバイダーです。
- * アプリケーションのルート付近でラップして使用してください。
+ * Makes a host data-access adapter available to descendants.
+ * @param props - Host adapter and child content.
+ * @returns Adapter context around children; no requests or adapter disposal occur here.
+ * @remarks No CSS is required. Query hooks additionally need QueryClientProvider. Keep the
+ * adapter stable to preserve scoped query keys; the backend owns permissions/persistence.
+ * @example
+ * ```tsx
+ * import type { ComponentProps } from 'react';
+ * import type { ReactNode } from 'react';
+ * import { DataAccessProvider } from '@alneas/appkit-react/tools/data-access/react';
+ * type DataAccessAdapter = ComponentProps<typeof DataAccessProvider>['adapter'];
+ * export function DataRoot({ adapter, children }: { adapter: DataAccessAdapter; children: ReactNode }) { return <DataAccessProvider adapter={adapter}>{children}</DataAccessProvider>; }
+ * ```
  */
 export declare const DataAccessProvider: ({ adapter, children, }: {
+    /**
+     * Stable host adapter providing persistence and authorization semantics.
+     */
     adapter: DataAccessAdapter;
+    /**
+     * Descendants that consume the adapter.
+     */
     children: React.ReactNode;
 }) => React.JSX.Element;

package/dist/tools/lib/data-access/react-query-provider.js.map

@@ -1 +1 @@
-{"version":3,"file":"react-query-provider.js","names":["DataAccessProvider","DataAccessContext","adapter"],"sources":["../../../../src/tools/lib/data-access/react-query-provider.tsx"],"sourcesContent":["import React from 'react';\nimport type { DataAccessAdapter } from './types';\nimport { DataAccessContext } from './data-access-context';\n\n/**\n * データアクセス層のアダプターを提供するコンテキストプロバイダーです。\n * アプリケーションのルート付近でラップして使用してください。\n */\nexport const DataAccessProvider = ({\n  adapter,\n  children,\n}: {\n  adapter: DataAccessAdapter;\n  children: React.ReactNode;\n}) => {\n  return <DataAccessContext.Provider value={adapter}>{children}</DataAccessContext.Provider>;\n};\n"],"mappings":";;;;;AAQA,IAAaA,KAAsB,EACjC,YACA,kBAKO,kBAACC,EAAkB,UAAnB;CAA4B,OAAOC;CAAU;AAAqC,CAAA"}
+{"version":3,"file":"react-query-provider.js","names":["DataAccessProvider","DataAccessContext","adapter"],"sources":["../../../../src/tools/lib/data-access/react-query-provider.tsx"],"sourcesContent":["import React from 'react';\nimport type { DataAccessAdapter } from './types';\nimport { DataAccessContext } from './data-access-context';\n\n/**\n * Makes a host data-access adapter available to descendants.\n * @param props - Host adapter and child content.\n * @returns Adapter context around children; no requests or adapter disposal occur here.\n * @remarks No CSS is required. Query hooks additionally need QueryClientProvider. Keep the\n * adapter stable to preserve scoped query keys; the backend owns permissions/persistence.\n * @example\n * ```tsx\n * import type { ComponentProps } from 'react';\n * import type { ReactNode } from 'react';\n * import { DataAccessProvider } from '@alneas/appkit-react/tools/data-access/react';\n * type DataAccessAdapter = ComponentProps<typeof DataAccessProvider>['adapter'];\n * export function DataRoot({ adapter, children }: { adapter: DataAccessAdapter; children: ReactNode }) { return <DataAccessProvider adapter={adapter}>{children}</DataAccessProvider>; }\n * ```\n */\nexport const DataAccessProvider = ({\n  adapter,\n  children,\n}: {\n  /**\n   * Stable host adapter providing persistence and authorization semantics.\n   */\n  adapter: DataAccessAdapter;\n  /**\n   * Descendants that consume the adapter.\n   */\n  children: React.ReactNode;\n}) => {\n  return <DataAccessContext.Provider value={adapter}>{children}</DataAccessContext.Provider>;\n};\n"],"mappings":";;;;;AAmBA,IAAaA,KAAsB,EACjC,YACA,kBAWO,kBAACC,EAAkB,UAAnB;CAA4B,OAAOC;CAAU;AAAqC,CAAA"}

package/dist/tools/lib/data-access/react-query.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"react-query.cjs","names":["QueryClient","useQueryClient","useMutation","tanstackQueryOptions","getAdapterCacheScope","useDataAccess","useQuery","require_tools_lib_data_access_data_access_context","_tanstack_react_query","_alneas_appkit_core_data","createQueryClient","useInvalidate","queryClient","key","useMutationWithInvalidation","options","keys","data","variables","context","findQueryOptions","collection","filter","adapterOptions","adapter","findOneQueryOptions","id","aggregateQueryOptions","pipeline","useFind","queryOptions","useFindOne","useCreate","vars","useUpdate","useDelete","useCreateMany","useUpdateMany","useDeleteMany","useAggregate","aggOptions"],"sources":["../../../../src/tools/lib/data-access/react-query.tsx"],"sourcesContent":["import {\n  useQuery,\n  UseQueryOptions,\n  QueryClient,\n  useQueryClient,\n  useMutation,\n  UseMutationOptions,\n  MutationFunction,\n  queryOptions as tanstackQueryOptions,\n  type QueryKey,\n} from '@tanstack/react-query';\nimport { DataAccessAdapter, Filter, QueryOptions } from './types';\nimport { useDataAccess } from './data-access-context';\nimport { getAdapterCacheScope } from './cache-scope';\n\nexport { useDataAccess } from './data-access-context';\n\n// --- Query Helpers (Merged from query.ts) ---\n\n/**\n * アプリケーション全体で使用する QueryClient を作成します。\n * デフォルト設定として、staleTime: 5分, retry: 1, refetchOnWindowFocus: false が設定されています。\n */\nexport function createQueryClient() {\n  return new QueryClient({\n    defaultOptions: {\n      queries: {\n        staleTime: 1000 * 60 * 5, // 5 minutes\n        retry: 1,\n        refetchOnWindowFocus: false,\n      },\n    },\n  });\n}\n\n/**\n * 指定したキーのクエリキャッシュを手動で無効化（再取得要求）するためのフックです。\n * @returns クエリキーを受け取り、無効化を実行する関数\n */\nexport function useInvalidate() {\n  const queryClient = useQueryClient();\n\n  return (key: QueryKey) => {\n    return queryClient.invalidateQueries({ queryKey: key });\n  };\n}\n\n/**\n * useMutation のラッパーフックです。\n * Mutation 成功時に、指定したキーまたは自動生成されたキーに基づいてクエリの無効化を行います。\n *\n * @param mutationFn - 実行する非同期関数\n * @param options.invalidateKeys - 無効化したいクエリキーの配列、または結果からキーを生成する関数\n */\nexport function useMutationWithInvalidation<\n  TData = unknown,\n  TError = unknown,\n  TVariables = void,\n  TContext = unknown,\n>(\n  mutationFn: MutationFunction<TData, TVariables>,\n  options?: UseMutationOptions<TData, TError, TVariables, TContext> & {\n    invalidateKeys?: QueryKey[] | ((data: TData, variables: TVariables) => QueryKey[]);\n  },\n) {\n  const queryClient = useQueryClient();\n\n  return useMutation({\n    mutationFn,\n    ...options,\n    onSuccess: async (data, variables, context) => {\n      if (options?.invalidateKeys) {\n        const keys =\n          typeof options.invalidateKeys === 'function'\n            ? options.invalidateKeys(data, variables)\n            : options.invalidateKeys;\n\n        await Promise.all(keys.map((key) => queryClient.invalidateQueries({ queryKey: key })));\n      }\n      // @ts-expect-error - Argument count mismatch between supported TanStack Query type versions\n      options?.onSuccess?.(data, variables, context);\n    },\n  });\n}\n\n// --- Query Options Factories ---\n\n/**\n * useFind および ensureQueryData 用の QueryOptions を生成します。\n *\n * @param adapter - DataAccessAdapter インスタンス\n * @param collection - コレクション名\n * @param filter - フィルタ条件\n * @param adapterOptions - クエリオプション\n * @returns TanStack Query 用のオプションオブジェクト\n */\nexport function findQueryOptions<T = unknown>(\n  adapter: DataAccessAdapter,\n  collection: string,\n  filter?: Filter,\n  adapterOptions?: QueryOptions,\n) {\n  return tanstackQueryOptions({\n    queryKey: [collection, 'list', filter, adapterOptions, getAdapterCacheScope(adapter)],\n    queryFn: ({ signal }) => adapter.find<T>(collection, filter, { ...adapterOptions, signal }),\n  });\n}\n\n/**\n * useFindOne および ensureQueryData 用の QueryOptions を生成します。\n *\n * @param adapter - DataAccessAdapter インスタンス\n * @param collection - コレクション名\n * @param id - ドキュメントID\n * @param adapterOptions - クエリオプション\n * @returns TanStack Query 用のオプションオブジェクト\n */\nexport function findOneQueryOptions<T = unknown>(\n  adapter: DataAccessAdapter,\n  collection: string,\n  id: string,\n  adapterOptions?: QueryOptions,\n) {\n  return tanstackQueryOptions({\n    queryKey: [collection, 'detail', id, adapterOptions, getAdapterCacheScope(adapter)],\n    queryFn: ({ signal }) => adapter.findOne<T>(collection, id, { ...adapterOptions, signal }),\n    enabled: !!id,\n  });\n}\n\n/**\n * useAggregate および ensureQueryData 用の QueryOptions を生成します。\n *\n * @param adapter - DataAccessAdapter インスタンス\n * @param collection - コレクション名\n * @param pipeline - Aggregation Pipeline\n * @param options - クエリオプション\n * @returns TanStack Query 用のオプションオブジェクト\n */\nexport function aggregateQueryOptions<T = unknown>(\n  adapter: DataAccessAdapter,\n  collection: string,\n  pipeline: unknown[],\n  options?: QueryOptions,\n) {\n  return tanstackQueryOptions({\n    queryKey: [collection, 'aggregate', pipeline, options, getAdapterCacheScope(adapter)],\n    queryFn: ({ signal }) => {\n      if (adapter.aggregate) {\n        return adapter.aggregate<T>(collection, pipeline, { ...options, signal });\n      }\n      throw new Error('Adapter does not support aggregate');\n    },\n  });\n}\n\n// --- Hooks ---\n\n/**\n * コレクションから複数のレコードを取得し、React Query による自動キャッシュを行います。\n *\n * @param collection - コレクション/テーブル名\n * @param filter - フィルタ条件 ($eq, $in, $gte など)\n * @param adapterOptions - ソート、取得制限、Populate などのオプション\n * @param queryOptions - React Query (useQuery) のオプション (enabled, staleTime など)\n * @returns useQuery の結果オブジェクト (data, isLoading, error等)\n *\n * @example\n * ```tsx\n * const { data: users, isLoading } = useFind<User>('users', { role: 'admin' }, { sort: { name: 1 }, limit: 50 });\n * ```\n */\nexport function useFind<T = unknown>(\n  collection: string,\n  filter?: Filter,\n  adapterOptions?: QueryOptions,\n  queryOptions?: Omit<UseQueryOptions<T[], Error>, 'queryKey' | 'queryFn'>,\n) {\n  const adapter = useDataAccess();\n  const options = findQueryOptions<T>(adapter, collection, filter, adapterOptions);\n  return useQuery({\n    ...options,\n    ...queryOptions,\n  } as UseQueryOptions<T[], Error>);\n}\n\n/**\n * ID指定で単一のデータを取得します。\n *\n * @param collection - 取得対象のコレクション/テーブル名\n * @param id - ドキュメント/レコードのID\n * @param adapterOptions - Populate などのクエリオプション\n * @param queryOptions - React Query (useQuery) のオプション\n * @returns useQuery の結果オブジェクト (data, isLoading, error等)\n */\nexport function useFindOne<T = unknown>(\n  collection: string,\n  id: string,\n  adapterOptions?: QueryOptions,\n  queryOptions?: Omit<UseQueryOptions<T | null, Error>, 'queryKey' | 'queryFn'>,\n) {\n  const adapter = useDataAccess();\n  const options = findOneQueryOptions<T>(adapter, collection, id, adapterOptions);\n  return useQuery({\n    ...options,\n    ...queryOptions,\n  } as UseQueryOptions<T | null, Error>);\n}\n\n/**\n * 新規データを作成するためのフックです。\n * 成功時にキャッシュの無効化（Invalidation）を自動的に行います。\n *\n * @param collection - 対象のコレクション/テーブル名\n * @param options.onSuccess - 成功時のコールバック\n * @param options.invalidateKeys - 無効化するクエリキー（デフォルトは `[[collection]]`）\n * @returns useMutation の結果オブジェクト (mutate, isLoading等)\n */\nexport function useCreate<\n  T = unknown,\n  TVariables = { data: Record<string, unknown>; options?: QueryOptions },\n>(\n  collection: string,\n  options?: {\n    onSuccess?: (data: T, variables: TVariables) => void;\n    invalidateKeys?: unknown[][];\n  },\n) {\n  const adapter = useDataAccess();\n  return useMutationWithInvalidation<T, Error, TVariables>(\n    (variables) => {\n      const vars = variables as { data: Record<string, unknown>; options?: QueryOptions };\n      return adapter.create<T>(collection, vars.data, vars.options);\n    },\n    {\n      onSuccess: options?.onSuccess,\n      invalidateKeys: options?.invalidateKeys || [[collection]],\n    },\n  );\n}\n\n/**\n * データを更新するためのフックです。\n * 成功時にリストと詳細のキャッシュを自動的に無効化します。\n *\n * @param collection - 対象のコレクション/テーブル名\n * @param options.onSuccess - 成功時のコールバック\n * @param options.invalidateKeys - 無効化キー（デフォルトはリストと対象IDの詳細）\n * @returns useMutation の結果オブジェクト (mutate, isLoading等)\n */\nexport function useUpdate<\n  T = unknown,\n  TVariables = { id: string; data: Record<string, unknown>; options?: QueryOptions },\n>(\n  collection: string,\n  options?: {\n    onSuccess?: (data: T, variables: TVariables) => void;\n    invalidateKeys?: unknown[][];\n  },\n) {\n  const adapter = useDataAccess();\n  return useMutationWithInvalidation<T, Error, TVariables>(\n    (variables) => {\n      const vars = variables as {\n        id: string;\n        data: Record<string, unknown>;\n        options?: QueryOptions;\n      };\n      return adapter.update<T>(collection, vars.id, vars.data, vars.options);\n    },\n    {\n      onSuccess: options?.onSuccess,\n      // リストと、特定の詳細アイテムの両方のキャッシュを無効化する\n      invalidateKeys: (_data, variables) => {\n        const vars = variables as { id: string };\n        return (\n          options?.invalidateKeys || [\n            [collection, 'list'],\n            [collection, 'detail', vars.id],\n          ]\n        );\n      },\n    },\n  );\n}\n\n/**\n * データを削除するためのフックです。\n *\n * @param collection - 対象のコレクション/テーブル名\n * @param options.onSuccess - 成功時のコールバック\n * @param options.invalidateKeys - 無効化キー\n * @returns useMutation の結果オブジェクト (mutate, isLoading等)\n */\nexport function useDelete<T = unknown, TVariables = { id: string; options?: QueryOptions }>(\n  collection: string,\n  options?: {\n    onSuccess?: (data: T, variables: TVariables) => void;\n    invalidateKeys?: unknown[][];\n  },\n) {\n  const adapter = useDataAccess();\n  return useMutationWithInvalidation<T, Error, TVariables>(\n    (variables) => {\n      const vars = (typeof variables === 'string' ? { id: variables } : variables) as {\n        id: string;\n        options?: QueryOptions;\n      };\n      return adapter.delete<T>(collection, vars.id, vars.options);\n    },\n    {\n      onSuccess: options?.onSuccess,\n      invalidateKeys: options?.invalidateKeys || [[collection]],\n    },\n  );\n}\n\n/**\n * 複数のデータを一括作成するためのフックです。\n *\n * @param collection - 対象のコレクション/テーブル名\n * @param options.onSuccess - 成功時のコールバック\n * @param options.invalidateKeys - 無効化キー（デフォルトは `[[collection]]`）\n * @returns useMutation の結果オブジェクト (mutate, isLoading等)\n */\nexport function useCreateMany<\n  T = unknown,\n  TVariables = { data: Record<string, unknown>[]; options?: QueryOptions },\n>(\n  collection: string,\n  options?: {\n    onSuccess?: (data: T[], variables: TVariables) => void;\n    invalidateKeys?: unknown[][];\n  },\n) {\n  const adapter = useDataAccess();\n  return useMutationWithInvalidation<T[], Error, TVariables>(\n    (variables) => {\n      const vars = variables as { data: Record<string, unknown>[]; options?: QueryOptions };\n      if (!adapter.createMany) throw new Error('Adapter does not support createMany');\n      return adapter.createMany<T>(collection, vars.data, vars.options);\n    },\n    {\n      onSuccess: options?.onSuccess,\n      invalidateKeys: options?.invalidateKeys || [[collection]],\n    },\n  );\n}\n\n/**\n * 条件に一致する複数のデータを一括更新するためのフックです。\n *\n * @param collection - 対象のコレクション/テーブル名\n * @param options.onSuccess - 成功時のコールバック\n * @param options.invalidateKeys - 無効化キー（デフォルトは `[[collection]]`）\n * @returns useMutation の結果オブジェクト (mutate, isLoading等)\n */\nexport function useUpdateMany<\n  T = unknown,\n  TVariables = { filter: Filter; data: Record<string, unknown>; options?: QueryOptions },\n>(\n  collection: string,\n  options?: {\n    onSuccess?: (data: T[], variables: TVariables) => void;\n    invalidateKeys?: unknown[][];\n  },\n) {\n  const adapter = useDataAccess();\n  return useMutationWithInvalidation<T[], Error, TVariables>(\n    (variables) => {\n      const vars = variables as {\n        filter: Filter;\n        data: Record<string, unknown>;\n        options?: QueryOptions;\n      };\n      if (!adapter.updateMany) throw new Error('Adapter does not support updateMany');\n      return adapter.updateMany<T>(collection, vars.filter, vars.data, vars.options);\n    },\n    {\n      onSuccess: options?.onSuccess,\n      invalidateKeys: options?.invalidateKeys || [[collection], [collection, 'list']],\n    },\n  );\n}\n\n/**\n * 条件に一致する複数のデータを一括削除するためのフックです。\n *\n * @param collection - 対象のコレクション/テーブル名\n * @param options.onSuccess - 成功時のコールバック\n * @param options.invalidateKeys - 無効化キー（デフォルトは `[[collection]]`）\n * @returns useMutation の結果オブジェクト (mutate, isLoading等)\n */\nexport function useDeleteMany<T = unknown, TVariables = { filter: Filter; options?: QueryOptions }>(\n  collection: string,\n  options?: {\n    onSuccess?: (data: T[], variables: TVariables) => void;\n    invalidateKeys?: unknown[][];\n  },\n) {\n  const adapter = useDataAccess();\n  return useMutationWithInvalidation<T[], Error, TVariables>(\n    (variables) => {\n      const vars = variables as { filter: Filter; options?: QueryOptions };\n      if (!adapter.deleteMany) throw new Error('Adapter does not support deleteMany');\n      return adapter.deleteMany<T>(collection, vars.filter, vars.options);\n    },\n    {\n      onSuccess: options?.onSuccess,\n      invalidateKeys: options?.invalidateKeys || [[collection]],\n    },\n  );\n}\n\n/**\n * Aggregation Pipelineを実行するためのフックです。\n *\n * @param collection - 対象のコレクション/テーブル名\n * @param pipeline - Aggregation Pipeline\n * @param options - クエリオプション\n * @param queryOptions - React Query (useQuery) のオプション\n * @returns useQuery の結果オブジェクト (data, isLoading, error等)\n */\nexport function useAggregate<T = unknown>(\n  collection: string,\n  pipeline: unknown[],\n  options?: QueryOptions,\n  queryOptions?: Omit<UseQueryOptions<T[], Error>, 'queryKey' | 'queryFn'>,\n) {\n  const adapter = useDataAccess();\n  const aggOptions = aggregateQueryOptions<T>(adapter, collection, pipeline, options);\n  return useQuery({\n    ...aggOptions,\n    ...queryOptions,\n  } as UseQueryOptions<T[], Error>);\n}\n"],"mappings":"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"}
+{"version":3,"file":"react-query.cjs","names":["QueryClient","useQueryClient","useMutation","tanstackQueryOptions","getAdapterCacheScope","useDataAccess","useQuery","require_tools_lib_data_access_data_access_context","_tanstack_react_query","_alneas_appkit_core_data","createQueryClient","useInvalidate","queryClient","key","useMutationWithInvalidation","options","keys","data","variables","context","findQueryOptions","collection","filter","adapterOptions","adapter","findOneQueryOptions","id","aggregateQueryOptions","pipeline","useFind","queryOptions","useFindOne","useCreate","vars","useUpdate","useDelete","useCreateMany","useUpdateMany","useDeleteMany","useAggregate","aggOptions"],"sources":["../../../../src/tools/lib/data-access/react-query.tsx"],"sourcesContent":["import {\n  useQuery,\n  UseQueryOptions,\n  QueryClient,\n  useQueryClient,\n  useMutation,\n  UseMutationOptions,\n  MutationFunction,\n  queryOptions as tanstackQueryOptions,\n  type QueryKey,\n} from '@tanstack/react-query';\nimport { DataAccessAdapter, Filter, QueryOptions } from './types';\nimport { useDataAccess } from './data-access-context';\nimport { getAdapterCacheScope } from './cache-scope';\n\nexport { useDataAccess } from './data-access-context';\n\n// --- Query Helpers (Merged from query.ts) ---\n\n/**\n * Creates a TanStack QueryClient with five-minute stale time, one retry and no focus refetch.\n * @returns New caller-owned client; share one stable client for one application/auth domain.\n * @remarks No requests begin on construction. Supply it to QueryClientProvider; callers\n * own clearing/disposal and SSR request isolation. No CSS is required.\n * @example\n * ```ts\n * import { createQueryClient } from '@alneas/appkit-react/tools/data-access/react';\n * const queryClient = createQueryClient();\n * queryClient.clear();\n * ```\n */\nexport function createQueryClient() {\n  return new QueryClient({\n    defaultOptions: {\n      queries: {\n        staleTime: 1000 * 60 * 5, // 5 minutes\n        retry: 1,\n        refetchOnWindowFocus: false,\n      },\n    },\n  });\n}\n\n/**\n * Binds query invalidation to the nearest QueryClient.\n * @returns Function accepting a query key and resolving after TanStack prefix-matched invalidation/refetch work.\n * @throws Error outside QueryClientProvider.\n * @remarks The returned callback forwards invalidateQueries with queryKey only; it does\n * not establish authorization or choose a collection automatically. No CSS is required.\n * @example\n * ```tsx\n * import { QueryClientProvider } from '@tanstack/react-query';\n * import { createQueryClient, useInvalidate } from '@alneas/appkit-react/tools/data-access/react';\n * const client = createQueryClient();\n * function Refresh() { const invalidate = useInvalidate(); return <button onClick={() => { void invalidate(['tasks']); }}>Refresh</button>; }\n * export function Screen() { return <QueryClientProvider client={client}><Refresh /></QueryClientProvider>; }\n * ```\n */\nexport function useInvalidate() {\n  const queryClient = useQueryClient();\n\n  return (key: QueryKey) => {\n    return queryClient.invalidateQueries({ queryKey: key });\n  };\n}\n\n/**\n * Runs a TanStack mutation and invalidates only the explicitly configured query keys on success.\n * @typeParam TData - Resolved mutation result; defaults to unknown and may include undefined.\n * @typeParam TError - Mutation error exposed by TanStack Query; defaults to unknown.\n * @typeParam TVariables - Mutation input supplied to mutate/mutateAsync; defaults to void.\n * @typeParam TContext - Value returned by onMutate for later callbacks; defaults to unknown.\n * @param mutationFn - Host mutation function receiving variables and resolving TData; the host owns authorization and persistence.\n * @param options - TanStack mutation options plus invalidateKeys: a key array or synchronous factory\n * receiving the successful result and variables. Omitted invalidateKeys (or an empty array) invalidates nothing.\n * @returns The TanStack mutation result with status, data/error and mutate/mutateAsync controls.\n * @throws When rendered without a QueryClientProvider.\n * @remarks Requires an outer QueryClientProvider. Query keys use TanStack prefix matching.\n * On success, invalidations run concurrently and are awaited before options.onSuccess is called;\n * that callback's returned promise is not awaited by this wrapper. A key factory or invalidation\n * failure prevents that callback and propagates into mutation error handling. Mutation failures\n * are exposed through the mutation result and reject mutateAsync. This wrapper adds no retry,\n * rollback or default invalidation keys; useCreate/useUpdate supply their own defaults.\n * The normal TanStack options spread also permits options.mutationFn to override the first argument.\n * @example\n * ```tsx\n * import { QueryClientProvider } from '@tanstack/react-query';\n * import { createQueryClient, useMutationWithInvalidation } from '@alneas/appkit-react/tools/data-access/react';\n *\n * const queryClient = createQueryClient();\n * type SaveInput = { id: string; title: string };\n * type SaveResult = SaveInput | undefined;\n * function SaveButton({ save }: { save: (input: SaveInput) => Promise<SaveResult> }) {\n *   const mutation = useMutationWithInvalidation(save, {\n *     invalidateKeys: (_result, input) => [['tasks', 'detail', input.id]],\n *   });\n *   return <button onClick={() => mutation.mutate({ id: 'task-1', title: 'Review' })}>\n *     {mutation.data?.title ?? 'Save task'}\n *   </button>;\n * }\n * // Supply an authorized host implementation; this example does not fabricate persistence.\n * export function TaskEditor({ save }: { save: (input: SaveInput) => Promise<SaveResult> }) {\n *   return <QueryClientProvider client={queryClient}><SaveButton save={save} /></QueryClientProvider>;\n * }\n * ```\n */\nexport function useMutationWithInvalidation<\n  TData = unknown,\n  TError = unknown,\n  TVariables = void,\n  TContext = unknown,\n>(\n  mutationFn: MutationFunction<TData, TVariables>,\n  options?: UseMutationOptions<TData, TError, TVariables, TContext> & {\n    /** Optional explicit keys or result/variables key factory; omission invalidates nothing. */\n    invalidateKeys?: QueryKey[] | ((data: TData, variables: TVariables) => QueryKey[]);\n  },\n) {\n  const queryClient = useQueryClient();\n\n  return useMutation({\n    mutationFn,\n    ...options,\n    onSuccess: async (data, variables, context) => {\n      if (options?.invalidateKeys) {\n        const keys =\n          typeof options.invalidateKeys === 'function'\n            ? options.invalidateKeys(data, variables)\n            : options.invalidateKeys;\n\n        await Promise.all(keys.map((key) => queryClient.invalidateQueries({ queryKey: key })));\n      }\n      // @ts-expect-error - Argument count mismatch between supported TanStack Query type versions\n      options?.onSuccess?.(data, variables, context);\n    },\n  });\n}\n\n// --- Query Options Factories ---\n\n/**\n * Creates adapter-scoped TanStack options for listing records.\n * @typeParam T - Expected record/result shape; defaults to unknown and is not runtime validation.\n * @param adapter - Host adapter performing reads.\n * @param collection - Host collection/table name.\n * @param filter - Optional adapter-specific selection criteria.\n * @param adapterOptions - Optional sort/limit/populate/etc. forwarded with TanStack abort signal.\n * @returns Query key and queryFn options accepted by useQuery or QueryClient methods.\n * @remarks Key includes collection, operation, input options and adapter cache scope. No\n * request is made until queryFn executes. Query errors reject through TanStack; aggregate\n * queryFn rejects if the adapter lacks aggregate. Abort signal support is adapter-owned.\n * @example\n * ```ts\n * import type { ComponentProps } from 'react';\n * import { DataAccessProvider, findQueryOptions } from '@alneas/appkit-react/tools/data-access/react';\n * type DataAccessAdapter = ComponentProps<typeof DataAccessProvider>['adapter'];\n * export function optionsFor(adapter: DataAccessAdapter) { return findQueryOptions<{ id: string }>(adapter, 'tasks', {}, { limit: 20 }); }\n * ```\n */\nexport function findQueryOptions<T = unknown>(\n  adapter: DataAccessAdapter,\n  collection: string,\n  filter?: Filter,\n  adapterOptions?: QueryOptions,\n) {\n  return tanstackQueryOptions({\n    queryKey: [collection, 'list', filter, adapterOptions, getAdapterCacheScope(adapter)],\n    queryFn: ({ signal }) => adapter.find<T>(collection, filter, { ...adapterOptions, signal }),\n  });\n}\n\n/**\n * Creates adapter-scoped TanStack options for reading one record by ID.\n * @typeParam T - Expected record/result shape; defaults to unknown and is not runtime validation.\n * @param adapter - Host adapter performing reads.\n * @param collection - Host collection/table name.\n * @param id - Record identifier; a falsy ID disables the ordinary useQuery execution.\n * @param adapterOptions - Optional adapter query settings forwarded with TanStack abort signal.\n * @returns Query key and queryFn options accepted by useQuery or QueryClient methods.\n * @remarks Key includes collection, operation, input options and adapter cache scope. No\n * request is made until queryFn executes. Query errors reject through TanStack; aggregate\n * queryFn rejects if the adapter lacks aggregate. Abort signal support is adapter-owned.\n * @example\n * ```ts\n * import type { ComponentProps } from 'react';\n * import { DataAccessProvider, findOneQueryOptions } from '@alneas/appkit-react/tools/data-access/react';\n * type DataAccessAdapter = ComponentProps<typeof DataAccessProvider>['adapter'];\n * export function optionsFor(adapter: DataAccessAdapter) { return findOneQueryOptions<{ id: string }>(adapter, 'tasks', 'task-1'); }\n * ```\n */\nexport function findOneQueryOptions<T = unknown>(\n  adapter: DataAccessAdapter,\n  collection: string,\n  id: string,\n  adapterOptions?: QueryOptions,\n) {\n  return tanstackQueryOptions({\n    queryKey: [collection, 'detail', id, adapterOptions, getAdapterCacheScope(adapter)],\n    queryFn: ({ signal }) => adapter.findOne<T>(collection, id, { ...adapterOptions, signal }),\n    enabled: !!id,\n  });\n}\n\n/**\n * Creates adapter-scoped TanStack options for an aggregation pipeline.\n * @typeParam T - Expected record/result shape; defaults to unknown and is not runtime validation.\n * @param adapter - Host adapter performing reads.\n * @param collection - Host collection/table name.\n * @param pipeline - Adapter-specific aggregation stages.\n * @param options - Optional adapter settings forwarded with TanStack abort signal.\n * @returns Query key and queryFn options accepted by useQuery or QueryClient methods.\n * @remarks Key includes collection, operation, input options and adapter cache scope. No\n * request is made until queryFn executes. Query errors reject through TanStack; aggregate\n * queryFn rejects if the adapter lacks aggregate. Abort signal support is adapter-owned.\n * @example\n * ```ts\n * import type { ComponentProps } from 'react';\n * import { DataAccessProvider, aggregateQueryOptions } from '@alneas/appkit-react/tools/data-access/react';\n * type DataAccessAdapter = ComponentProps<typeof DataAccessProvider>['adapter'];\n * export function optionsFor(adapter: DataAccessAdapter) { return aggregateQueryOptions<{ count: number }>(adapter, 'tasks', []); }\n * ```\n */\nexport function aggregateQueryOptions<T = unknown>(\n  adapter: DataAccessAdapter,\n  collection: string,\n  pipeline: unknown[],\n  options?: QueryOptions,\n) {\n  return tanstackQueryOptions({\n    queryKey: [collection, 'aggregate', pipeline, options, getAdapterCacheScope(adapter)],\n    queryFn: ({ signal }) => {\n      if (adapter.aggregate) {\n        return adapter.aggregate<T>(collection, pipeline, { ...options, signal });\n      }\n      throw new Error('Adapter does not support aggregate');\n    },\n  });\n}\n\n// --- Hooks ---\n\n/**\n * Queries a collection list through the current adapter.\n * @typeParam T - Expected result record shape, default unknown; not runtime validation.\n * @param collection - Host collection/table name.\n * @param filter - Optional adapter filter.\n * @param adapterOptions - Optional sorting/limit/populate settings.\n * @param queryOptions - TanStack query overrides; omitted values use the generated options.\n * @returns TanStack query result with data/status/error and refetch controls.\n * @throws Error without DataAccessProvider or QueryClientProvider.\n * @remarks No CSS required. Adapter failures appear in query state; keys include adapter\n * scope and input options. Query signals are forwarded, but cancellation depends on the\n * adapter. The host owns backend authorization.\n * @example\n * ```tsx\n * import type { ComponentProps } from 'react';\n * import { QueryClientProvider } from '@tanstack/react-query';\n * import { DataAccessProvider, createQueryClient, useFind } from '@alneas/appkit-react/tools/data-access/react';\n * type DataAccessAdapter = ComponentProps<typeof DataAccessProvider>['adapter'];\n * const client = createQueryClient();\n * function Content() { const query = useFind<{ id: string }>('tasks', {}, { limit: 20 }); return <output>{query.isPending ? 'Loading' : query.error ? 'Failed' : 'Ready'}</output>; }\n * export function DataScreen({ adapter }: { adapter: DataAccessAdapter }) { return <QueryClientProvider client={client}><DataAccessProvider adapter={adapter}><Content /></DataAccessProvider></QueryClientProvider>; }\n * ```\n */\nexport function useFind<T = unknown>(\n  collection: string,\n  filter?: Filter,\n  adapterOptions?: QueryOptions,\n  queryOptions?: Omit<UseQueryOptions<T[], Error>, 'queryKey' | 'queryFn'>,\n) {\n  const adapter = useDataAccess();\n  const options = findQueryOptions<T>(adapter, collection, filter, adapterOptions);\n  return useQuery({\n    ...options,\n    ...queryOptions,\n  } as UseQueryOptions<T[], Error>);\n}\n\n/**\n * Queries one record through the current adapter.\n * @typeParam T - Expected result record shape, default unknown; not runtime validation.\n * @param collection - Host collection/table name.\n * @param id - Record ID; empty ID disables the default query.\n * @param adapterOptions - Optional adapter read settings.\n * @param queryOptions - TanStack query overrides; omitted values use the generated options.\n * @returns TanStack query result with data/status/error and refetch controls. Data resolves to a record or null when absent.\n * @throws Error without DataAccessProvider or QueryClientProvider.\n * @remarks No CSS required. Adapter failures appear in query state; keys include adapter\n * scope and input options. Query signals are forwarded, but cancellation depends on the\n * adapter. The host owns backend authorization.\n * @example\n * ```tsx\n * import type { ComponentProps } from 'react';\n * import { QueryClientProvider } from '@tanstack/react-query';\n * import { DataAccessProvider, createQueryClient, useFindOne } from '@alneas/appkit-react/tools/data-access/react';\n * type DataAccessAdapter = ComponentProps<typeof DataAccessProvider>['adapter'];\n * const client = createQueryClient();\n * function Content() { const query = useFindOne<{ id: string }>('tasks', 'task-1'); return <output>{query.isPending ? 'Loading' : query.error ? 'Failed' : 'Ready'}</output>; }\n * export function DataScreen({ adapter }: { adapter: DataAccessAdapter }) { return <QueryClientProvider client={client}><DataAccessProvider adapter={adapter}><Content /></DataAccessProvider></QueryClientProvider>; }\n * ```\n */\nexport function useFindOne<T = unknown>(\n  collection: string,\n  id: string,\n  adapterOptions?: QueryOptions,\n  queryOptions?: Omit<UseQueryOptions<T | null, Error>, 'queryKey' | 'queryFn'>,\n) {\n  const adapter = useDataAccess();\n  const options = findOneQueryOptions<T>(adapter, collection, id, adapterOptions);\n  return useQuery({\n    ...options,\n    ...queryOptions,\n  } as UseQueryOptions<T | null, Error>);\n}\n\n/**\n * Creates one record through the current data-access adapter and invalidates collection queries.\n * @typeParam T - Created record result returned by the adapter; defaults to unknown.\n * @typeParam TVariables - Mutation variables; must contain data and optional adapter options at runtime.\n * @param collection - Adapter collection/table name.\n * @param options - Optional onSuccess callback receiving the created result and variables, plus replacement\n * invalidation keys. Omitted invalidateKeys defaults to [[collection]]; [] disables invalidation.\n * @returns A mutation result whose mutate/mutateAsync accepts { data, options? } by default.\n * @throws When rendered without the required query or data-access provider.\n * @remarks Requires QueryClientProvider and DataAccessProvider with a real host adapter.\n * The adapter owns persistence, authorization and error semantics. Defaults are supplied by this\n * helper, not useMutationWithInvalidation. Callback promises are not awaited by that wrapper.\n * @example\n * ```tsx\n * import { QueryClientProvider } from '@tanstack/react-query';\n * import { DataAccessProvider, createQueryClient, useCreate } from '@alneas/appkit-react/tools/data-access/react';\n * import type { ComponentProps } from 'react';\n * const client = createQueryClient();\n * function CreateTask() {\n *   const create = useCreate<{ id: string; title: string }>('tasks');\n *   return <button onClick={() => create.mutate({ data: { title: 'Review' } })}>Create</button>;\n * }\n * export function TaskCreator({ adapter }: Pick<ComponentProps<typeof DataAccessProvider>, 'adapter'>) {\n *   return <QueryClientProvider client={client}><DataAccessProvider adapter={adapter}>\n *     <CreateTask />\n *   </DataAccessProvider></QueryClientProvider>;\n * }\n * ```\n */\nexport function useCreate<\n  T = unknown,\n  TVariables = { data: Record<string, unknown>; options?: QueryOptions },\n>(\n  collection: string,\n  options?: {\n    /**\n     * Callback after successful mutation and awaited invalidations.\n     * @param data - Adapter result.\n     * @param variables - Original mutation variables.\n     * @returns No value; callback promise results are not awaited by the wrapper.\n     */\n    onSuccess?: (data: T, variables: TVariables) => void;\n    /**\n     * Optional replacement query keys using prefix matching; [] disables invalidation, omission uses this hook default.\n     */\n    invalidateKeys?: unknown[][];\n  },\n) {\n  const adapter = useDataAccess();\n  return useMutationWithInvalidation<T, Error, TVariables>(\n    (variables) => {\n      const vars = variables as { data: Record<string, unknown>; options?: QueryOptions };\n      return adapter.create<T>(collection, vars.data, vars.options);\n    },\n    {\n      onSuccess: options?.onSuccess,\n      invalidateKeys: options?.invalidateKeys || [[collection]],\n    },\n  );\n}\n\n/**\n * Updates one record through the current adapter and invalidates list and matching detail queries.\n * @typeParam T - Updated record result returned by the adapter; defaults to unknown.\n * @typeParam TVariables - Mutation variables; must contain id, data and optional adapter options at runtime.\n * @param collection - Adapter collection/table name.\n * @param options - Optional onSuccess callback receiving the updated result and variables, plus replacement\n * invalidation keys. Omitted keys default to [[collection, 'list'], [collection, 'detail', variables.id]];\n * [] disables invalidation.\n * @returns A mutation result whose mutate/mutateAsync accepts { id, data, options? } by default.\n * @throws When rendered without the required query or data-access provider.\n * @remarks Requires QueryClientProvider and DataAccessProvider with a real host adapter.\n * The adapter determines update semantics, authorization, persistence and errors. Invalidation\n * defaults are supplied by this helper; the underlying wrapper has no automatic defaults.\n * @example\n * ```tsx\n * import { QueryClientProvider } from '@tanstack/react-query';\n * import { DataAccessProvider, createQueryClient, useUpdate } from '@alneas/appkit-react/tools/data-access/react';\n * import type { ComponentProps } from 'react';\n * const client = createQueryClient();\n * function UpdateTask() {\n *   const update = useUpdate<{ id: string; title: string }>('tasks');\n *   return <button onClick={() => update.mutate({ id: 'task-1', data: { title: 'Reviewed' } })}>Update</button>;\n * }\n * export function TaskUpdater({ adapter }: Pick<ComponentProps<typeof DataAccessProvider>, 'adapter'>) {\n *   return <QueryClientProvider client={client}><DataAccessProvider adapter={adapter}>\n *     <UpdateTask />\n *   </DataAccessProvider></QueryClientProvider>;\n * }\n * ```\n */\nexport function useUpdate<\n  T = unknown,\n  TVariables = { id: string; data: Record<string, unknown>; options?: QueryOptions },\n>(\n  collection: string,\n  options?: {\n    /**\n     * Callback after successful mutation and awaited invalidations.\n     * @param data - Adapter result.\n     * @param variables - Original mutation variables.\n     * @returns No value; callback promise results are not awaited by the wrapper.\n     */\n    onSuccess?: (data: T, variables: TVariables) => void;\n    /**\n     * Optional replacement query keys using prefix matching; [] disables invalidation, omission uses this hook default.\n     */\n    invalidateKeys?: unknown[][];\n  },\n) {\n  const adapter = useDataAccess();\n  return useMutationWithInvalidation<T, Error, TVariables>(\n    (variables) => {\n      const vars = variables as {\n        id: string;\n        data: Record<string, unknown>;\n        options?: QueryOptions;\n      };\n      return adapter.update<T>(collection, vars.id, vars.data, vars.options);\n    },\n    {\n      onSuccess: options?.onSuccess,\n      // リストと、特定の詳細アイテムの両方のキャッシュを無効化する\n      invalidateKeys: (_data, variables) => {\n        const vars = variables as { id: string };\n        return (\n          options?.invalidateKeys || [\n            [collection, 'list'],\n            [collection, 'detail', vars.id],\n          ]\n        );\n      },\n    },\n  );\n}\n\n/**\n * Deletes one record through the current adapter.\n * @typeParam T - Adapter result record shape, defaults to unknown.\n * @typeParam TVariables - Mutation variables; must provide id and optional adapter options.\n * @param collection - Host collection/table name.\n * @param options - Optional successful-result callback and replacement invalidation keys.\n * @returns TanStack mutation result with explicit mutate/mutateAsync controls.\n * @throws Error without required providers; adapter failures reject mutateAsync and populate mutation error state.\n * @remarks Requires DataAccessProvider inside QueryClientProvider; no CSS. Omitted\n * invalidation keys default to [[collection]]; [] disables invalidation. Callback promise\n * results are not awaited by the underlying wrapper. Persistence, atomicity and\n * authorization are host-owned; no rollback is supplied.\n * @example\n * ```tsx\n * import type { ComponentProps } from 'react';\n * import { QueryClientProvider } from '@tanstack/react-query';\n * import { DataAccessProvider, createQueryClient, useDelete } from '@alneas/appkit-react/tools/data-access/react';\n * type DataAccessAdapter = ComponentProps<typeof DataAccessProvider>['adapter'];\n * const client = createQueryClient();\n * function Action() { const mutation = useDelete('tasks'); return <button onClick={() => mutation.mutate({ id: 'task-1' })}>Run host mutation</button>; }\n * export function DataScreen({ adapter }: { adapter: DataAccessAdapter }) { return <QueryClientProvider client={client}><DataAccessProvider adapter={adapter}><Action /></DataAccessProvider></QueryClientProvider>; }\n * ```\n */\nexport function useDelete<T = unknown, TVariables = { id: string; options?: QueryOptions }>(\n  collection: string,\n  options?: {\n    /**\n     * Callback after successful mutation and awaited invalidations.\n     * @param data - Adapter result.\n     * @param variables - Original mutation variables.\n     * @returns No value; callback promise results are not awaited by the wrapper.\n     */\n    onSuccess?: (data: T, variables: TVariables) => void;\n    /**\n     * Optional replacement query keys using prefix matching; [] disables invalidation, omission uses this hook default.\n     */\n    invalidateKeys?: unknown[][];\n  },\n) {\n  const adapter = useDataAccess();\n  return useMutationWithInvalidation<T, Error, TVariables>(\n    (variables) => {\n      const vars = (typeof variables === 'string' ? { id: variables } : variables) as {\n        id: string;\n        options?: QueryOptions;\n      };\n      return adapter.delete<T>(collection, vars.id, vars.options);\n    },\n    {\n      onSuccess: options?.onSuccess,\n      invalidateKeys: options?.invalidateKeys || [[collection]],\n    },\n  );\n}\n\n/**\n * Creates multiple records through the current adapter.\n * @typeParam T - Adapter result record shape, defaults to unknown.\n * @typeParam TVariables - Mutation variables; must provide data array and optional adapter options.\n * @param collection - Host collection/table name.\n * @param options - Optional successful-result callback and replacement invalidation keys.\n * @returns TanStack mutation result with explicit mutate/mutateAsync controls.\n * @throws Error without required providers; mutation rejects if adapter lacks createMany or fails.\n * @remarks Requires DataAccessProvider inside QueryClientProvider; no CSS. Omitted\n * invalidation keys default to [[collection]]; [] disables invalidation. Callback promise\n * results are not awaited by the underlying wrapper. Persistence, atomicity and\n * authorization are host-owned; no rollback is supplied.\n * @example\n * ```tsx\n * import type { ComponentProps } from 'react';\n * import { QueryClientProvider } from '@tanstack/react-query';\n * import { DataAccessProvider, createQueryClient, useCreateMany } from '@alneas/appkit-react/tools/data-access/react';\n * type DataAccessAdapter = ComponentProps<typeof DataAccessProvider>['adapter'];\n * const client = createQueryClient();\n * function Action() { const mutation = useCreateMany('tasks'); return <button onClick={() => mutation.mutate({ data: [{ title: 'Review' }] })}>Run host mutation</button>; }\n * export function DataScreen({ adapter }: { adapter: DataAccessAdapter }) { return <QueryClientProvider client={client}><DataAccessProvider adapter={adapter}><Action /></DataAccessProvider></QueryClientProvider>; }\n * ```\n */\nexport function useCreateMany<\n  T = unknown,\n  TVariables = { data: Record<string, unknown>[]; options?: QueryOptions },\n>(\n  collection: string,\n  options?: {\n    /**\n     * Callback after successful mutation and awaited invalidations.\n     * @param data - Adapter result.\n     * @param variables - Original mutation variables.\n     * @returns No value; callback promise results are not awaited by the wrapper.\n     */\n    onSuccess?: (data: T[], variables: TVariables) => void;\n    /**\n     * Optional replacement query keys using prefix matching; [] disables invalidation, omission uses this hook default.\n     */\n    invalidateKeys?: unknown[][];\n  },\n) {\n  const adapter = useDataAccess();\n  return useMutationWithInvalidation<T[], Error, TVariables>(\n    (variables) => {\n      const vars = variables as { data: Record<string, unknown>[]; options?: QueryOptions };\n      if (!adapter.createMany) throw new Error('Adapter does not support createMany');\n      return adapter.createMany<T>(collection, vars.data, vars.options);\n    },\n    {\n      onSuccess: options?.onSuccess,\n      invalidateKeys: options?.invalidateKeys || [[collection]],\n    },\n  );\n}\n\n/**\n * Updates records matching an adapter filter.\n * @typeParam T - Adapter result record shape, defaults to unknown.\n * @typeParam TVariables - Mutation variables; must provide filter, data and optional adapter options.\n * @param collection - Host collection/table name.\n * @param options - Optional successful-result callback and replacement invalidation keys.\n * @returns TanStack mutation result with explicit mutate/mutateAsync controls.\n * @throws Error without required providers; mutation rejects if adapter lacks updateMany or fails.\n * @remarks Requires DataAccessProvider inside QueryClientProvider; no CSS. Omitted\n * invalidation keys default to [[collection], [collection, 'list']]; [] disables invalidation. Callback promise\n * results are not awaited by the underlying wrapper. Persistence, atomicity and\n * authorization are host-owned; no rollback is supplied.\n * @example\n * ```tsx\n * import type { ComponentProps } from 'react';\n * import { QueryClientProvider } from '@tanstack/react-query';\n * import { DataAccessProvider, createQueryClient, useUpdateMany } from '@alneas/appkit-react/tools/data-access/react';\n * type DataAccessAdapter = ComponentProps<typeof DataAccessProvider>['adapter'];\n * const client = createQueryClient();\n * function Action() { const mutation = useUpdateMany('tasks'); return <button onClick={() => mutation.mutate({ filter: { state: 'draft' }, data: { state: 'reviewed' } })}>Run host mutation</button>; }\n * export function DataScreen({ adapter }: { adapter: DataAccessAdapter }) { return <QueryClientProvider client={client}><DataAccessProvider adapter={adapter}><Action /></DataAccessProvider></QueryClientProvider>; }\n * ```\n */\nexport function useUpdateMany<\n  T = unknown,\n  TVariables = { filter: Filter; data: Record<string, unknown>; options?: QueryOptions },\n>(\n  collection: string,\n  options?: {\n    /**\n     * Callback after successful mutation and awaited invalidations.\n     * @param data - Adapter result.\n     * @param variables - Original mutation variables.\n     * @returns No value; callback promise results are not awaited by the wrapper.\n     */\n    onSuccess?: (data: T[], variables: TVariables) => void;\n    /**\n     * Optional replacement query keys using prefix matching; [] disables invalidation, omission uses this hook default.\n     */\n    invalidateKeys?: unknown[][];\n  },\n) {\n  const adapter = useDataAccess();\n  return useMutationWithInvalidation<T[], Error, TVariables>(\n    (variables) => {\n      const vars = variables as {\n        filter: Filter;\n        data: Record<string, unknown>;\n        options?: QueryOptions;\n      };\n      if (!adapter.updateMany) throw new Error('Adapter does not support updateMany');\n      return adapter.updateMany<T>(collection, vars.filter, vars.data, vars.options);\n    },\n    {\n      onSuccess: options?.onSuccess,\n      invalidateKeys: options?.invalidateKeys || [[collection], [collection, 'list']],\n    },\n  );\n}\n\n/**\n * Deletes records matching an adapter filter.\n * @typeParam T - Adapter result record shape, defaults to unknown.\n * @typeParam TVariables - Mutation variables; must provide filter and optional adapter options.\n * @param collection - Host collection/table name.\n * @param options - Optional successful-result callback and replacement invalidation keys.\n * @returns TanStack mutation result with explicit mutate/mutateAsync controls.\n * @throws Error without required providers; mutation rejects if adapter lacks deleteMany or fails.\n * @remarks Requires DataAccessProvider inside QueryClientProvider; no CSS. Omitted\n * invalidation keys default to [[collection]]; [] disables invalidation. Callback promise\n * results are not awaited by the underlying wrapper. Persistence, atomicity and\n * authorization are host-owned; no rollback is supplied.\n * @example\n * ```tsx\n * import type { ComponentProps } from 'react';\n * import { QueryClientProvider } from '@tanstack/react-query';\n * import { DataAccessProvider, createQueryClient, useDeleteMany } from '@alneas/appkit-react/tools/data-access/react';\n * type DataAccessAdapter = ComponentProps<typeof DataAccessProvider>['adapter'];\n * const client = createQueryClient();\n * function Action() { const mutation = useDeleteMany('tasks'); return <button onClick={() => mutation.mutate({ filter: { state: 'obsolete' } })}>Run host mutation</button>; }\n * export function DataScreen({ adapter }: { adapter: DataAccessAdapter }) { return <QueryClientProvider client={client}><DataAccessProvider adapter={adapter}><Action /></DataAccessProvider></QueryClientProvider>; }\n * ```\n */\nexport function useDeleteMany<T = unknown, TVariables = { filter: Filter; options?: QueryOptions }>(\n  collection: string,\n  options?: {\n    /**\n     * Callback after successful mutation and awaited invalidations.\n     * @param data - Adapter result.\n     * @param variables - Original mutation variables.\n     * @returns No value; callback promise results are not awaited by the wrapper.\n     */\n    onSuccess?: (data: T[], variables: TVariables) => void;\n    /**\n     * Optional replacement query keys using prefix matching; [] disables invalidation, omission uses this hook default.\n     */\n    invalidateKeys?: unknown[][];\n  },\n) {\n  const adapter = useDataAccess();\n  return useMutationWithInvalidation<T[], Error, TVariables>(\n    (variables) => {\n      const vars = variables as { filter: Filter; options?: QueryOptions };\n      if (!adapter.deleteMany) throw new Error('Adapter does not support deleteMany');\n      return adapter.deleteMany<T>(collection, vars.filter, vars.options);\n    },\n    {\n      onSuccess: options?.onSuccess,\n      invalidateKeys: options?.invalidateKeys || [[collection]],\n    },\n  );\n}\n\n/**\n * Queries an aggregation pipeline through the current adapter.\n * @typeParam T - Expected result record shape, default unknown; not runtime validation.\n * @param collection - Host collection/table name.\n * @param pipeline - Adapter-specific aggregation stages.\n * @param options - Optional adapter query settings.\n * @param queryOptions - TanStack query overrides; omitted values use the generated options.\n * @returns TanStack query result with data/status/error and refetch controls. Missing aggregate capability becomes a query error.\n * @throws Error without DataAccessProvider or QueryClientProvider.\n * @remarks No CSS required. Adapter failures appear in query state; keys include adapter\n * scope and input options. Query signals are forwarded, but cancellation depends on the\n * adapter. The host owns backend authorization.\n * @example\n * ```tsx\n * import type { ComponentProps } from 'react';\n * import { QueryClientProvider } from '@tanstack/react-query';\n * import { DataAccessProvider, createQueryClient, useAggregate } from '@alneas/appkit-react/tools/data-access/react';\n * type DataAccessAdapter = ComponentProps<typeof DataAccessProvider>['adapter'];\n * const client = createQueryClient();\n * function Content() { const query = useAggregate<{ count: number }>('tasks', []); return <output>{query.isPending ? 'Loading' : query.error ? 'Failed' : 'Ready'}</output>; }\n * export function DataScreen({ adapter }: { adapter: DataAccessAdapter }) { return <QueryClientProvider client={client}><DataAccessProvider adapter={adapter}><Content /></DataAccessProvider></QueryClientProvider>; }\n * ```\n */\nexport function useAggregate<T = unknown>(\n  collection: string,\n  pipeline: unknown[],\n  options?: QueryOptions,\n  queryOptions?: Omit<UseQueryOptions<T[], Error>, 'queryKey' | 'queryFn'>,\n) {\n  const adapter = useDataAccess();\n  const aggOptions = aggregateQueryOptions<T>(adapter, collection, pipeline, options);\n  return useQuery({\n    ...aggOptions,\n    ...queryOptions,\n  } as UseQueryOptions<T[], Error>);\n}\n"],"mappings":"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"}