Export schemas to JSON/Swagger/OpenAPI

[ezekg]

Could create a Rake task that can read in the schemas and export to an OpenAPI spec:

rake typed_params:export[<format>]

One caveat here would be that this only documents requests, not responses. But responses could always be filled in afterwards using schemas, so I think it's still worth exploring.

[ezekg]

Doesn't even necessarily have to be Swagger/OpenAPI specific. At the very least, we could export all schemas to JSON so that the schemas can be used elsewhere to generate e.g. TypeScript types or even documenation.

[dylandamsma]

This would be cool! I am using this gem in combination with Rswag, some automatic declaration would be amazing.

[ezekg]

I think exporting to a standard JSON schema format may be the most versatile option, and that can be used in a pipeline to build e.g. an OpenAPI spec.