Safe Action и TanStack Query
Use when integrating next-safe-action with TanStack Query (React Query) -- mutationOptions(), useMutation, ActionMutationError error handling, type guards, optimistic updates via query cache, query invalidation after mutations
AInext-safe-action
official
Разработка
Что делает навык
Навык обеспечивает интеграцию next-safe-action с TanStack Query (React Query) для безопасного выполнения мутаций. Он позволяет использовать mutationOptions, обрабатывать ошибки ActionMutationError через type guards и управлять состоянием кэша запросов.
Когда применять
- Интеграция next-safe-action с TanStack Query для выполнения мутаций
- Обработка ошибок ActionMutationError с использованием type guards (isActionMutationError, hasServerError, hasValidationErrors)
- Оптимистичные обновления через query cache и инвалидация запросов после мутаций
- Использование хука useMutation в связке с next-safe-action
Как работает
- Установить пакеты @next-safe-action/adapter-tanstack-query и @tanstack/react-query
- Импортировать функции mutationOptions, ActionMutationError, isActionMutationError, hasServerError, hasValidationErrors из @next-safe-action/adapter-tanstack-query
- Использовать mutationOptions для настройки мутаций в TanStack Query
- Применять type guards (isActionMutationError, hasServerError, hasValidationErrors) для обработки ошибок
- Управлять кэшем запросов для оптимистичных обновлений и инвалидации данных после мутаций
Примеры запросов агенту
Интегрируй next-safe-action с TanStack Query, используя mutationOptions и обработку ошибок через isActionMutationError
Настрой useMutation для next-safe-action с оптимистичными обновлениями через query cache
Обработай ошибки ActionMutationError в мутации, используя hasServerError и hasValidationErrors
Что понадобится
- npm install @next-safe-action/adapter-tanstack-query @tanstack/react-query
Описание составлено по SKILL.md навыка, сверено 05.10.2026.
Как подключить
1Скачать навык
# возьмите папку навыка «safe-action-tanstack-query» из репозитория:
# https://github.com/next-safe-action/skills
2Положить папку с
SKILL.md к навыкам ассистента# положите папку навыка туда, где ассистент ищет skills:
cp -r safe-action-tanstack-query/ ~/.claude/skills/safe-action-tanstack-query/
Навык — папка с файлом SKILL.md (описание + инструкции) и опциональными скриптами. Ассистент (Claude, Claude Code и совместимые) подхватывает его по описанию и следует шагам.