Quick answer
Quick answer: back up the original, pick the right format/settings, run a small batch, spot-check the output. TS types disappear at runtime; external JSON still needs validation.
Why it matters
Get the shortest path working before optimizing.
Zod/Valibot/io-ts help.
Step by step
- Start with real/complete JSON covering optional fields and empty arrays.
- Check array elements, null/optional and nested objects.
- Set the root name and copy into the project.
- Add Zod/Valibot runtime validation for production.
- Add contract tests/versioning for API changes.
Common mistakes
- Treating a sample as a complete schema, missing optional/empty arrays.
- Trusting generated any/null unions as-is.
- Forgetting quotes for property names with spaces/Chinese.
- Skipping runtime validation after generation.
Checklist
- Sample covers optional/empty arrays/null.
- Array object fields merged.
- Property/root names valid.
- Runtime validation added.
- API contract/version considered.
Key facts
- Zod/Valibot/io-ts help.
- Validate once at the boundary.
FAQ
What is the quick answer for Runtime validation?
Quick answer: back up the original, pick the right format/settings, run a small batch, spot-check the output. TS types disappear at runtime; external JSON still needs validation.
How long does it take?
Usually 1-3 minutes; for intermittent issues, run 30 seconds and retest elsewhere.
Is data uploaded?
Runs locally and does not upload video/audio; extensions may still read the page.
Source: Zod