fix(openapi-typescript): handle nullable schemas

[gduliscouet-ubitransport]

Changes

Allow all types except UNKNOWN to be nullable.
Fixes #1821 and #1940 .

How to Review

I re-applied #1959 (it didn't move for a while)

I added tests for the new syntax for OAS 3.1 (not the one with oneOf, but with a type array, as documented here).

Checklist

• Unit tests updated
• docs/ updated (if necessary)
• pnpm run update:examples run (only applicable for openapi-typescript)
• add a minor changeset patch

[changeset-bot]

🦋 Changeset detected

Latest commit: 234bceb

The changes in this PR will be included in the next version bump.

This PR includes changesets to release 2 packages

Name	Type
openapi-typescript	Minor
swr-openapi	Major

Not sure what this means? Click here to learn what changesets are.

Click here if you're a maintainer who wants to add another changeset to this PR

[gduliscouet-ubitransport]

Hello @drwpow ,
Could I get your input for this schema ?
I added it to the tests, but it doesn't pass yet.
From what I see in the code, it seems to me that if we have a $ref in an object schema, all other keys are ignored. Is it me that misunderstood how $ref work ? Or is it a bug we should fix ?

Once we resolve that I'll finalize the PR

[drwpow]

it seems to me that if we have a $ref in an object schema, all other keys are ignored. Is it me that misunderstood how $ref work ? Or is it a bug we should fix ?

That’s my understanding. If you look at the OpenAPI 3.1 specification, you’ll often see typings like this: SchemaObject | ReferenceObject. The fact that a reference object IS NOT a SchemaObject, or any other type for that matter, means they aren’t to be mixed-and-matched. If you want to combine multiple objects, you MUST use allOf/oneOf/anyOf to compose an object (but within those arrays, you are allowed to have some object be ReferenceObject and some SchemaObjects, but there’s no such thing as combining the two together.

[netlify]

👷 Deploy request for openapi-ts pending review.

Visit the deploys page to approve it

Name	Link
🔨 Latest commit	234bceb

[drwpow]

Great tests, and great fix! Replied to the comment about $ref handling, but let’s merge & release the rest of it as-is