It is a sign of a healthy ecosystem that we had 3 OpenAPI related posts this week (this one, [ANN] v0.17 release of Jane Street packages ocaml_openapi_generator generator and my Scaling factors when compiling mutually recursive definitions which is based on Nomadic Lab’s Json Schema). Side note: At some point it would be good to commonalize the OpenAPI parsing in one place.
I do think it is a solvable problem. For example, I’ve started to place Stripe’s extensions to OpenAPI in a module in my own code:
That module is passed as an optional ~vendor:(module StripeExt) first-class module argument to the OpenAPI generator.