#3213 feat: Normalize OpenAPI schema features Issue created by edgarrmondragon ### Feature scope Taps (catalog, state, tests, etc.) ### Description Follows • #2746 ##

null

OpenAPI 3.0 does not have an explicit

null

type as in JSON Schema, but you can use

nullable: true

to specify that the value may be

null

. Note that

null

is different from an empty string "".

Docs: https://swagger.io/docs/specification/v3_0/data-models/data-types/#null ## Maybe mixed types?

type

takes a single value.

type

as a list is not valid in OpenAPI (even though it is valid in JSON Schema):

# Incorrect

type:

- string

- integer

Mixed types can be described using `oneOf` and `anyOf`, which specify a list of alternate types:

# Correct

oneOf:

- type: string

- type: integer

meltano/sdk