OpenAPI fix for a nullable ref using allOf

[Bram-dc]

Context: OpenAPI null or reference issue

I am trying to get correct typings when using a reference and nullable together.

Currently I am using this piece of code to apply a fix to the generated json/openapi schema:

export const fixNullableRefs = (obj: unknown): unknown => {

    if (obj && typeof obj === 'object') {

        if ('$ref' in obj && typeof obj.$ref === 'string') {
            if (Object.keys(obj).length === 1)
                return obj

            return {
                ...obj,
                $ref: undefined,
                allOf: [
                    { $ref: obj.$ref },
                ],
            }
        }

        if (Array.isArray(obj))
            return obj.map(fixNullableRefs)

        return Object.fromEntries(Object.entries(obj).map(([key, value]) => [key, fixNullableRefs(value)]))

    }

    return obj

}

Would I be doing something wrong or is this an issue in the current script?

[Bram-dc]

It transforms this:

    "picture": {
        "$ref": "#/components/schemas/Picture",
        "nullable": true
    },

into this:

    "picture": {
        "nullable": true,
        "allOf": [
            {
                "$ref": "#/components/schemas/Picture"
            }
        ]
    },

[StefanTerdell]

Fixed in 3.22.4