A JSON sample shows observed values, not every value an API may return. TypeDraft deliberately emits unknown[] for an empty array and keeps null visible instead of guessing a domain type.
Absence is not visible
A property missing from the only object cannot appear in the draft. Use multiple representative array objects or the authoritative schema.
Static types do not validate data
TypeScript declarations disappear at runtime. Keep boundary validation wherever untrusted responses enter the application, and update the draft from the authoritative contract rather than treating one fixture as proof.
Review against the real contract
Compile the generated file, then compare every property with the authoritative API documentation, OpenAPI document or JSON Schema. Add fields absent from the sample, correct nullable and optional rules, and use runtime validation at untrusted boundaries. Keep a representative fixture beside the reviewed type so later payload changes are visible.