Function removeDefaultsFromRequired

apps/api/scripts/generate-openapi.ts:15–91

* Post-process OpenAPI schema to remove fields with default values from required arrays. * This fixes the issue where z.toJSONSchema() marks optional-with-default fields as required.

(schema: unknown)

 * Post-process OpenAPI schema to remove fields with default values from required arrays.
 * This fixes the issue where z.toJSONSchema() marks optional-with-default fields as required.
 */
function removeDefaultsFromRequired(schema: unknown): unknown {
  if (!schema || typeof schema !== 'object') return schema

  const obj = schema as Record<string, unknown>

  // If this is a schema object with properties and required
  if ('properties' in obj && 'required' in obj && Array.isArray(obj.required)) {
    const properties = obj.properties as Record<string, unknown> | undefined
    const required = obj.required as string[]

    if (properties) {
      // Remove any property from required if it has a default value
      const newRequired = required.filter(key => {
        const prop = properties[key]
        if (prop && typeof prop === 'object' && 'default' in prop) return false

        return true
      })

      // Recursively process properties
      const newProperties: Record<string, unknown> = {}
      for (const [key, value] of Object.entries(properties))
        newProperties[key] = removeDefaultsFromRequired(value)

      return {
        ...obj,
        properties: newProperties,
        required: newRequired.length > 0 ? newRequired : undefined,
      }
    }
  }

  const processComponents = (components: Record<string, unknown>): Record<string, unknown> => {
    const newComponents: Record<string, unknown> = {}
    for (const [compKey, compValue] of Object.entries(components))
      if (compKey === 'schemas' && typeof compValue === 'object' && compValue !== null) {
        const schemas = compValue as Record<string, unknown>
        const newSchemas: Record<string, unknown> = {}
        for (const [schemaKey, schemaValue] of Object.entries(schemas))
          newSchemas[schemaKey] = removeDefaultsFromRequired(schemaValue)
        newComponents[compKey] = newSchemas
      } else {
        newComponents[compKey] = removeDefaultsFromRequired(compValue)
      }
    return newComponents
  }

  // Recursively process nested objects
  const result: Record<string, unknown> = {}
  for (const [key, value] of Object.entries(obj))
    if (key === 'paths' && typeof value === 'object' && value !== null) {
      // Process paths object
      const paths = value as Record<string, unknown>
      const newPaths: Record<string, unknown> = {}
      for (const [pathKey, pathValue] of Object.entries(paths))
        newPaths[pathKey] = removeDefaultsFromRequired(pathValue)