...
;\n});\n```\n\n### Data Management\n\n#### `ClientDataManager`\n\nMain class for data management.\n\n```ts\nconst dataManager = new ClientDataManager({\n defaultOptions: {\n queries: {\n staleTime: 300000, // 5 minutes\n retry: 3,\n refetchOnWindowFocus: false,\n },\n },\n});\n```\n\n**Methods:**\n\n##### `invalidateTag(tag, options?)`\n\nInvalidate all queries with a specific tag.\n\n```ts\nawait dataManager.invalidateTag('users');\nawait dataManager.invalidateTag('posts', {\n repeat: {count: 3, interval: 1000}, // Retry invalidation\n});\n```\n\n##### `invalidateTags(tags, options?)`\n\nInvalidate queries that have all specified tags.\n\n```ts\nawait dataManager.invalidateTags(['user', 'profile']);\n```\n\n##### `invalidateSource(dataSource, options?)`\n\nInvalidate all queries for a data source.\n\n```ts\nawait dataManager.invalidateSource(userDataSource);\n```\n\n##### `invalidateParams(dataSource, params, options?)`\n\nInvalidate a specific query with exact parameters.\n\n```ts\nawait dataManager.invalidateParams(userDataSource, {userId: 123});\n```\n\n##### `resetSource(dataSource)`\n\nReset (clear) all cached data for a data source.\n\n```ts\nawait dataManager.resetSource(userDataSource);\n```\n\n##### `resetParams(dataSource, params)`\n\nReset cached data for specific parameters.\n\n```ts\nawait dataManager.resetParams(userDataSource, {userId: 123});\n```\n\n##### `invalidateSourceTags(dataSource, params, options?)`\n\nInvalidate queries based on tags generated by a data source.\n\n```ts\nawait dataManager.invalidateSourceTags(userDataSource, {userId: 123});\n```\n\n### Utilities\n\n#### `skipContext(fetchFunction)`\n\nUtility to adapt existing fetch functions to data source interface.\n\n```ts\n// Existing function\nasync function fetchUser(params: {userId: number}) {\n // ...\n}\n\n// Adapted for data source\nconst dataSource = makePlainQueryDataSource({\n name: 'user',\n fetch: skipContext(fetchUser), // Skips context and fetchContext params\n});\n```\n\n#### `withCatch(fetchFunction, errorHandler)`\n\nAdds standardized error handling to fetch functions.\n\n```ts\nconst safeFetch = withCatch(fetchUser, (error) => ({error: true, message: error.message}));\n```\n\n#### `withCancellation(fetchFunction)`\n\nAdds cancellation support to fetch functions.\n\n```ts\nconst cancellableFetch = withCancellation(fetchFunction);\n// Automatically handles AbortSignal from React Query\n```\n\n#### `getProgressiveRefetch(options)`\n\nCreates a progressive refetch interval function.\n\n```ts\nconst progressiveRefetch = getProgressiveRefetch({\n minInterval: 1000, // Start with 1 second\n maxInterval: 30000, // Max 30 seconds\n multiplier: 2, // Double each time\n});\n\nconst dataSource = makePlainQueryDataSource({\n name: 'data',\n fetch: skipContext(fetchData),\n options: {\n refetchInterval: progressiveRefetch,\n },\n});\n```\n\n#### `normalizeStatus(status, fetchStatus)`\n\nConverts React Query statuses to DataLoader status.\n\n```ts\nconst status = normalizeStatus('pending', 'fetching'); // 'loading'\n```\n\n#### Status and Error Utilities\n\n```ts\n// Get combined status from multiple states\nconst status = getStatus([user, posts, comments]);\n\n// Get first error from multiple states\nconst error = getError([user, posts, comments]);\n\n// Merge multiple statuses\nconst combinedStatus = mergeStatuses(['loading', 'success', 'error']); // 'error'\n\n// Check if query key has a tag\nconst hasUserTag = hasTag(queryKey, 'users');\n```\n\n#### Key Composition Utilities\n\n```ts\n// Compose cache key for a data source\nconst key = composeKey(userDataSource, {userId: 123});\n\n// Compose full key including tags\nconst fullKey = composeFullKey(userDataSource, {userId: 123});\n```\n\n#### Constants\n\n```ts\nimport {idle} from '@gravity-ui/data-source';\n\n// Special symbol for skipping query execution\nconst params = shouldFetch ? {userId: 123} : idle;\n\n// Type-safe alternative to enabled: false\n// Instead of:\nconst {data} = useQueryData(userDataSource, {userId: userId || ''}, {enabled: Boolean(userId)});\n\n// Use:\nconst {data} = useQueryData(userDataSource, userId ? {userId} : idle);\n// TypeScript correctly infers types for both branches\n```\n\n#### Query Options Composition\n\n```ts\n// Compose React Query options for plain queries\nconst plainOptions = composePlainQueryOptions(context, dataSource, params, options);\n\n// Compose React Query options for infinite queries\nconst infiniteOptions = composeInfiniteQueryOptions(context, dataSource, params, options);\n```\n\n**Note:** These functions are primarily for internal use when creating custom data source implementations.\n\n## Advanced Patterns\n\n### Conditional Queries with Idle\n\nUse `idle` to create conditional queries:\n\n```ts\nimport {idle} from '@gravity-ui/data-source';\n\nconst ConditionalDataComponent: React.FC<{\n userId?: number;\n shouldLoadPosts: boolean;\n}> = ({userId, shouldLoadPosts}) => {\n // Load user only if userId is defined\n const user = useQueryData(\n userDataSource,\n userId ? {userId} : idle\n );\n\n // Load posts only if user is loaded and flag is enabled\n const posts = useQueryData(\n userPostsDataSource,\n user.data && shouldLoadPosts ? {userId: user.data.id} : idle\n );\n\n const combined = useQueryResponses([user, posts]);\n\n return (\n \n \n {user.data && }\n {posts.data && }\n
\n \n );\n};\n```\n\n### Data Transformation\n\nTransform request parameters and response data:\n\n```ts\nconst apiDataSource = makePlainQueryDataSource({\n name: 'api-data',\n transformParams: (params: {id: number}) => ({\n userId: params.id,\n apiVersion: 'v2',\n format: 'json',\n }),\n transformResponse: (response: ApiResponse) => ({\n user: response.data.user,\n metadata: response.meta,\n }),\n fetch: skipContext(apiFetch),\n});\n```\n\n### Tag-Based Cache Invalidation\n\nUse tags for sophisticated cache management:\n\n```ts\nconst userDataSource = makePlainQueryDataSource({\n name: 'user',\n tags: (params) => [`user:${params.userId}`, 'users', 'profiles'],\n fetch: skipContext(fetchUser),\n});\n\nconst userPostsDataSource = makePlainQueryDataSource({\n name: 'user-posts',\n tags: (params) => [`user:${params.userId}`, 'posts'],\n fetch: skipContext(fetchUserPosts),\n});\n\n// Invalidate all data for specific user\nawait dataManager.invalidateTag('user:123');\n\n// Invalidate all user-related data\nawait dataManager.invalidateTag('users');\n```\n\n### Error Handling with Types\n\nCreate type-safe error handling:\n\n```ts\ninterface ApiError {\n code: number;\n message: string;\n details?: Record