Function resolveOpenAPIJsonSchemaRef

packages/openapi/src/openapi-utils.ts:171–179

(doc: OpenAPI.Document, schema: JSONSchema)

const OPENAPI_JSON_SCHEMA_REF_PREFIX = /* @__PURE__ */ '#/components/schemas/'

export function resolveOpenAPIJsonSchemaRef(doc: OpenAPI.Document, schema: JSONSchema): JSONSchema {
  if (typeof schema !== 'object' || !schema.$ref?.startsWith(OPENAPI_JSON_SCHEMA_REF_PREFIX)) {
    return schema
  }

  const name = schema.$ref.slice(OPENAPI_JSON_SCHEMA_REF_PREFIX.length)
  const resolved = doc.components?.schemas?.[name]
  return resolved as JSONSchema ?? schema
}

/**
 * Simplifies composed object JSON Schemas (using anyOf, oneOf, allOf) by flattening nested compositions