import {JSONSchemaTypeName, LinkedJSONSchema, NormalizedJSONSchema, Parent} from './types/JSONSchema' import {escapeBlockComment, justName, toSafeString, traverse} from './utils' import {Options} from './' type Rule = (schema: LinkedJSONSchema, fileName: string, options: Options) => void const rules = new Map() function hasType(schema: LinkedJSONSchema, type: JSONSchemaTypeName) { return schema.type === type || (Array.isArray(schema.type) && schema.type.includes(type)) } function isObjectType(schema: LinkedJSONSchema) { return schema.properties !== undefined || hasType(schema, 'object') || hasType(schema, 'any') } function isArrayType(schema: LinkedJSONSchema) { return schema.items !== undefined || hasType(schema, 'array') || hasType(schema, 'any') } rules.set('Remove `type=["null"]` if `enum=[null]`', schema => { if ( Array.isArray(schema.enum) && schema.enum.some(e => e === null) && Array.isArray(schema.type) && schema.type.includes('null') ) { schema.type = schema.type.filter(type => type !== 'null') } }) rules.set('Destructure unary types', schema => { if (schema.type && Array.isArray(schema.type) && schema.type.length === 1) { schema.type = schema.type[0] } }) rules.set('Add empty `required` property if none is defined', schema => { if (isObjectType(schema) && !('required' in schema)) { schema.required = [] } }) rules.set('Transform `required`=false to `required`=[]', schema => { if (schema.required === false) { schema.required = [] } }) // TODO: default to empty schema (as per spec) instead rules.set('Default additionalProperties to true', schema => { if (isObjectType(schema) && !('additionalProperties' in schema) && schema.patternProperties === undefined) { schema.additionalProperties = true } }) rules.set('Default top level `id`', (schema, fileName) => { const isRoot = schema[Parent] === null if (isRoot && !schema.id) { schema.id = toSafeString(justName(fileName)) } }) rules.set('Escape closing JSDoc Comment', schema => { escapeBlockComment(schema) }) rules.set('Optionally remove maxItems and minItems', (schema, _fileName, options) => { if (options.ignoreMinAndMaxItems) { if ('maxItems' in schema) { delete schema.maxItems } if ('minItems' in schema) { delete schema.minItems } } }) rules.set('Normalize schema.minItems', (schema, _fileName, options) => { if (options.ignoreMinAndMaxItems) { return } // make sure we only add the props onto array types if (isArrayType(schema)) { const {minItems} = schema schema.minItems = typeof minItems === 'number' ? minItems : 0 } // cannot normalize maxItems because maxItems = 0 has an actual meaning }) rules.set('Normalize schema.items', (schema, _fileName, options) => { if (options.ignoreMinAndMaxItems) { return } const {maxItems, minItems} = schema const hasMaxItems = typeof maxItems === 'number' && maxItems >= 0 const hasMinItems = typeof minItems === 'number' && minItems > 0 if (schema.items && !Array.isArray(schema.items) && (hasMaxItems || hasMinItems)) { const items = schema.items // create a tuple of length N const newItems = Array(maxItems || minItems || 0).fill(items) if (!hasMaxItems) { // if there is no maximum, then add a spread item to collect the rest schema.additionalItems = items } schema.items = newItems } if (Array.isArray(schema.items) && hasMaxItems && maxItems! < schema.items.length) { // it's perfectly valid to provide 5 item defs but require maxItems 1 // obviously we shouldn't emit a type for items that aren't expected schema.items = schema.items.slice(0, maxItems) } return schema }) rules.set('Remove extends, if it is empty', schema => { if (!schema.hasOwnProperty('extends')) { return } if (schema.extends == null || (Array.isArray(schema.extends) && schema.extends.length === 0)) { delete schema.extends } }) rules.set('Make extends always an array, if it is defined', schema => { if (schema.extends == null) { return } if (!Array.isArray(schema.extends)) { schema.extends = [schema.extends] } }) rules.set('Transform $defs to definitions', schema => { if (schema.$defs) { schema.definitions = schema.$defs delete schema.$defs } }) rules.set('Transform const to singleton enum', schema => { if (schema.const) { schema.enum = [schema.const] delete schema.const } }) export function normalize(rootSchema: LinkedJSONSchema, filename: string, options: Options): NormalizedJSONSchema { rules.forEach(rule => traverse(rootSchema, schema => rule(schema, filename, options))) return rootSchema as NormalizedJSONSchema }