metadevpro / openapi3-ts

TS Model & utils for creating and exposing OpenAPI 3.x contracts.
MIT License
485 stars 64 forks source link

Uniftying with `@types/json-schema`? #61

Open eropple opened 4 years ago

eropple commented 4 years ago

Hey there - thanks for this library! It's super helpful.

One thing is a little bit troublesome, though. As of OpenAPI 3.1, OAS uses a complete superset of JSON Schema. To this end, juggling between the slightly different openapi3-ts and @types/json-schema types is a bit of a bear.

My use case, personally, is that I'm using the same schemas when I pass them to Fastify's ajv validator as I do to openapi3-ts. Maybe there's a way we (I'm happy to help if I can) can synchronize these together?

pjmolina commented 4 years ago

Hi @eropple Indeed. OpenApi 3.1 is converging with JSON Schema. Reimplementing JSON schema is out of scope of this library. So yes, thinking about it and totally open to listen for proposal, ideas, PR to make it easy. Feel free to propose your.