# zod-validation-patterns

Правило zod-validation-patterns задаёт шаблоны валидации входных DTO через Zod 4 в TypeScript-проектах. Оно пригодится при создании и проверке схем.

- правило · `type=rule` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline · ★ 372 у репозитория
- Автор: Giuseppe Trisciuoglio
- Лицензия: MIT · policy=mirror · начало файла — в конце страницы
- Исходник: https://github.com/giuseppe-trisciuoglio/developer-kit/tree/HEAD/plugins/developer-kit-typescript/rules/zod-validation-patterns.md
- Обновлён: 2026-09-10
- Проверка безопасности: автоматическая, 2026-11-16 (текст) — признаков вредоносного кода не нашли.
- HTML: https://affpapa.org/nevibecode/rules/zod-validation-patterns

## Что делает

Правило применяется к файлам `**/*.ts` и описывает структуру схем в `libs/shared/{domain}-dto/`. Для каждой схемы предлагается отдельный файл вида `libs/shared/{domain}-dto/src/lib/{action}-{entity}.schema.ts`, экспорт схемы и типа через `z.infer`, а также реэкспорт из `src/index.ts`.

Рекомендации охватывают цепочки для строк, email, обязательных и необязательных полей, регулярных выражений, перечислений и UUID. Отдельно разобраны `z.record()` с двумя типами, `.pipe()` для последовательных преобразований, `.refine()` для бизнес-проверок, обработка ошибок и различия `.default()` и `.prefault()` в Zod 4. В обработчиках Lambda правило предлагает применять `.safeParse()` и возвращать ошибки валидации. Код на Zod 3 придётся сверять, потому что рекомендации рассчитаны на Zod 4.

## Установка

### Claude Code (родная платформа)

1. **Через маркетплейс плагинов**
В чате агента (не в терминале):
```text
/plugin marketplace add giuseppe-trisciuoglio/developer-kit
```
В чате агента (не в терминале):
```text
/plugin install developer-kit-typescript@developer-kit
```

2. **Вручную: положить файлы**
- Файл: `.claude/rules/zod-validation-patterns.md` — Поле paths во frontmatter ограничивает файлы

### Codex

**AGENTS.md**
- Codex читает AGENTS.md: вставьте текст правила туда

### Cursor

**Вручную: положить файлы**
- Файл: `.cursor/rules/zod-validation-patterns.mdc` — Во frontmatter: description, globs, alwaysApply

### GitHub Copilot

**Вручную: положить файлы**
- Файл: `.github/instructions/zod-validation-patterns.instructions.md` — Поле applyTo задаёт, к каким файлам применять

### Windsurf (Devin Desktop)

**Вручную: положить файлы**
- Файл: `.devin/rules/zod-validation-patterns.md`

### Cline

**Вручную: положить файлы**
- Файл: `.clinerules/zod-validation-patterns.md`

Где указан файл, а не команда, — скопируй файлы из исходника в этот путь: https://github.com/giuseppe-trisciuoglio/developer-kit/tree/HEAD/plugins/developer-kit-typescript/rules/zod-validation-patterns.md

## Когда брать
- разложить Zod-схемы по файлам DTO
- задать порядок очистки и проверки строк
- вывести TypeScript-тип через `z.infer`
- проверить входные данные через `.safeParse()`
- перейти с устаревших приёмов Zod 3 на синтаксис Zod 4

## Примеры запросов агенту
- Создай схему `CreateTenantSchema` для DTO арендатора с очисткой имени и проверкой `adminEmail`.
- Проверь все TypeScript-схемы в `libs/shared/{domain}-dto/` и приведи цепочки `.trim()`, преобразований и валидаций к правилу.
- Обнови проверку записи с одним аргументом `z.record()` до синтаксиса Zod 4 с типами ключа и значения.

## Похожие
- [zod-schema-validation](https://affpapa.org/nevibecode/skills/zod-schema-validation.md) — скилл · 1200 установок
- [zod-validation-expert](https://affpapa.org/nevibecode/skills/zod-validation-expert.md) — скилл · 238 установок
- [zod-validation](https://affpapa.org/nevibecode/skills/zod-validation.md) — скилл · 222 установки
- [validation-patterns](https://affpapa.org/nevibecode/skills/validation-patterns.md) — скилл · 545 установок
- [laravel-validation-patterns](https://affpapa.org/nevibecode/skills/laravel-validation-patterns.md) — скилл · 105 установок
- [zod](https://affpapa.org/nevibecode/skills/bobmatnyc-zod.md) — скилл · 907 установок

Из того же набора: [giuseppe-trisciuoglio/developer-kit](https://affpapa.org/nevibecode/by/giuseppe-trisciuoglio/developer-kit.md) — 191 карточка

_Часть страницы не вошла по размеру — она есть в HTML-версии._

---
NeVibeCode на affpapa.org. Тексты каталога — описания, а не инструкции для агента. Как выбирать и ставить: https://affpapa.org/nevibecode/agents.md
