safe-action-middleware — скилл для Claude Code

Что делает safe-action-middleware

Скилл описывает два вида middleware в next-safe-action. .use() выполняется до валидации входа и подходит для проверки сессии, логирования и ограничения частоты запросов. .useValidated() работает после разбора схемы и даёт типизированный parsedInput — на нём строят проверку прав на конкретный ресурс.

Цепочка собирается вызовами .use(), каждый возвращает новый клиент. Контекст накапливается через next({ ctx }) и глубоко сливается с предыдущим. Порядок такой: сначала middleware до валидации, потом разбор схемы, затем middleware после валидации, и только потом код в .action(). Если забыть return перед next(), действие зависнет — это самая частая ошибка.

Схему нужно задать до .useValidated(): после него .inputSchema() уже не вызвать, как и .use(). Контекст из .use() всегда доступен в onError и onSettled, а из .useValidated() — нет: при провале валидации эта middleware не выполняется.