Can we bundle OpenAPI schema with bundle function?

[valerii15298]

As I understand bundling is only supported for json schemas.

Is it possible to use it to bundle OpenAPI schema itself?

Since OpenAPI spec is not json schema itself but contains a lot of json schemas inside and sometimes there could be references to external schemas, can we support bundling of OpenAPI spec?
Or is it out of the scope?

[jdesrosiers]

The bundling process supported by this package could be used to bundle externally referenced schemas, but only for 3.1 and forward. This process uses the $id keyword which wasn't supported until 3.1. The only piece that's missing is a function to parse the OpenAPI document and collect the identifiers for all the externally referenced schemas in the document. It shouldn't be hard, it's just not high on my priority list.

To be clear, this bundling process could only be adapted to bundle external schema references into /components/schemas. It couldn't bundle two OpenAPI documents into one. That would be a whole other problem and I would consider that out of scope. Some people use an OpenAPI document only /components/schemas and reference those schemas from another OpenAPI document. Even bundling that would be problematic because of potential conflicts caused by the discriminator keyword. It would only work if the external reference was to a JSON Schema document. Also, I don't know what level of support OpenAPI tooling typically has for the $id keyword.