zod-4

Zod 4 schema validation patterns. Trigger: When creating or updating Zod v4 schemas for validation/parsing (forms, request payloads, adapters), including v3 -u003e v4 migration patterns.

1. Zainstaluj skill zod-4 w swoim projekcie Prowler, upewniając się, że masz dostęp do narzędzi Read, Edit, Write, Glob, Grep, Bash, WebFetch, WebSearch i Task. Skill będzie się automatycznie aktywować podczas tworzenia lub aktualizacji schematów Zod.

2. Gdy zaczniesz pisać nowy schemat Zod, skill podpowie Ci składnię Zod 4. Jeśli migrujesz z Zod 3, zwróć uwagę na kluczowe zmiany: zamiast z.string().email() użyj z.email(), zamiast z.string().nonempty() użyj z.string().min(1), a parametry błędów przenieś z required_error do opcji error w obiekcie.

3. Dla schematów obiektów definiuj pola za pomocą z.object({ pole: z.typ() }). Wykorzystaj z.uuid() dla identyfikatorów, z.email() dla adresów e-mail i z.enum() dla pól z ograniczoną liczbą wartości. Dodaj .optional() do pól opcjonalnych.

4. Podczas walidacji danych użyj metody parse() do walidacji z wyrzucaniem błędu lub safeParse() do bezpiecznej walidacji zwracającej obiekt z polem success i danymi lub błędami. Sprawdź result.success przed dostępem do result.data.

5. Dla tablic i rekordów stosuj z.array() z typem elementu oraz ograniczeniami jak .min(1), a dla rekordów użyj z.record(z.string(), z.unknown()) do mapowania kluczy na wartości dowolnego typu.

6. Skill będzie sugerować konkretne wzorce na podstawie kontekstu — na przykład gdy napiszesz schemat dla formularza, zaproponuje walidatory z komunikatami błędów, a gdy będziesz pracować z payloadami API, podpowie struktury dla złożonych obiektów i tablic.