Gerador de JSON Schema

JSON Schema é um vocabulário declarativo para anotar e validar documentos JSON, definido em múltiplos rascunhos IETF (Draft 4 / 6 / 7 / 2019-09 / 2020-12). O mais recente é o Draft 2020-12, que define sete tipos primitivos (string, number, integer, boolean, array, object, null), um vocabulário de formato aberto (email, uri, date-time, uuid, ipv4, hostname, ...) e dezenas de palavras-chave de restrição: pattern (regex), minimum/maximum/exclusiveMinimum/exclusiveMaximum (intervalo numérico), minLength/maxLength (comprimento da string), minItems/maxItems/uniqueItems (restrições de array), required (array de campos obrigatórios no nível do objeto), additionalProperties (se campos extras são permitidos), enum e const (valores permitidos) e $ref (reuso de subesquema). A página gera saída Draft 2020-12 por padrão, com o Draft-07 mais antigo (ainda o mais comum em schemas de produção) selecionável no menu suspenso.

A inferência do gerador é uma única passagem sobre o JSON fornecido pelo usuário, construindo um objeto schema recursivamente. O mapeamento central da inferência é: integer (Number.isInteger e sem parte fracionária) -> {type: 'integer'}, float -> {type: 'number'}, string -> {type: 'string'}, boolean -> {type: 'boolean'}, array -> {type: 'array', items: <recursão no primeiro elemento>} ou {type: 'array', prefixItems: [...]} para tuplas no Draft 2020-12, object -> {type: 'object', properties: <recursão em cada chave>}, null -> {type: 'null'}. Para arrays com tipos de elementos mistos, o gerador emite um subschema oneOf cobrindo cada tipo observado.

Para múltiplos objetos de amostra, o gerador os compara para montar a lista de required: uma chave é obrigatória se aparece em todas as amostras, opcional se alguma amostra a omite. Padrões e restrições são inferidos quando as amostras se agrupam: se todos os números em um campo caem em [1, 100], o gerador emite {type: 'integer', minimum: 1, maximum: 100}; se um campo string é sempre um UUID, o gerador o marca com format: 'uuid' e emite um regex pattern: '^[0-9a-f]{8}-...'. A heurística de enum dispara quando um campo string assume ≤10 valores distintos nas amostras (ex.: role: 'admin' | 'editor' | 'viewer' todos observados), caso em que o gerador emite um array enum.

Objetos profundamente aninhados e estruturas recursivas são extraídos para uma seção $defs (Draft 2020-12; o $definitions mais antigo é a palavra-chave do Draft-07) e referenciados via $ref. Estruturas recursivas — ex.: um nó de árvore com um campo 'children' do tipo nó de árvore — recebem um stub $ref apontando para a entrada $defs do pai, que o resolvedor resolve no momento da validação. O gerador escolhe automaticamente a troca certa entre ref e inline: schemas rasos ficam inline, profundos são divididos em definições para manter a saída legível. Schemas gerados são determinísticos para uma entrada dada: as mesmas amostras JSON sempre produzem o mesmo schema, e o gerador é implementado em JavaScript puro sem chamadas remotas.

• Regras de inferência de tipo: números inteiros -> integer, ponto flutuante -> number, strings -> string, booleanos -> boolean, arrays -> array + items, objects -> object + properties. JSON null -> type: null (Draft 6+) ou string type: 'null'.
• Detecção de campos obrigatórios: comparando todos os objetos de amostra, campos presentes em todos os objetos são tratados como obrigatórios e adicionados ao array required; campos ausentes são opcionais. Entrada com uma única amostra deixa required: [] pois a heurística precisa de pelo menos duas amostras.
• Heurística de inferência de enum: quando um campo assume um conjunto pequeno e finito de valores string distintos nas amostras (cardinalidade <= 10), ele é automaticamente reconhecido como uma restrição enum. Cardinalidades maiores permanecem como tipo string simples.
• Formato auto-detectado: com base em assinaturas de string, campos são marcados com dicas de formato como email, uri, date-time, uuid para documentação e validação. A palavra-chave format é informativa no Draft 2020-12 — resolvedores podem escolher aplicar ou ignorar.
• Extração de $ref aninhado: objetos profundamente aninhados são extraídos para $defs internos (palavra-chave do Draft 2020-12; o $definitions mais antigo é do Draft 7) e referenciados via $ref, evitando que o Schema fique muito verboso. Estruturas recursivas recebem um stub $ref apontando para a entrada $defs do pai.
• Expansão de restrições: além dos tipos básicos, você também pode adicionar minimum/maximum (intervalo numérico), minLength/maxLength (comprimento da string), pattern (regex) e restrições semelhantes. O gerador emite essas restrições quando as amostras de entrada se agrupam em valores específicos.
• Seleção de Draft: 2020-12 (o mais recente) é o padrão e usa $defs; 2019-09 também usa $defs; Draft-07 usa $definitions e é o que a maioria das ferramentas existentes ainda emite. O Draft 6 introduziu semântica estrita de required, onde campos obrigatórios são listados no array required do pai em vez de como propriedade irmã.
• Palavras-chave de composição (Draft 2019-09+): allOf (deve corresponder a todos os subschemas), anyOf (pelo menos um), oneOf (exatamente um), not (não deve corresponder). O gerador escolhe oneOf quando os valores de amostra se encaixam em dois subschemas disjuntos (ex.: integer vs string).