Hi Hacker News!
My name is Sagar, I’m working on a startup called Speakeasy - we’re making all APIs self-service. The platform is currently in beta, but we’re independently launching this tool which you can use to generate language-idiomatic, statically-typed TS SDKs from any public OpenAPI schemas. We hope to continue iterating on this to give devs a way to easily generate high fidelity client SDKs for all the major languages.
Inspiration for this product is from past experiences struggling with OpenAPI. I was originally optimistic about using the OpenAPI tools to build out our offering, but quickly realized that the tools left a lot to be desired, and would not have provided our end users with the developer experience we wanted. While it’s not exhaustive, we’ve tried to address some of the biggest gaps in this tool:
* Low-dependency - To try and keep the SDK isomorphic (i.e. available both for Browsers and Node.JS servers), we wrap axios, but that’s it.This is intended to be idiomatic typescript; very similar to code a human would write; with the caveat that the typing is only as strict as the OpenAPI specification.
* Code just like a human would write - At this point static typing is everywhere. So wherever possible, we generate typed structures, construct path variables automatically, pass through query parameters, and expose strictly typed input / output body types.
* Future direction - There’s value in being neutral, but we felt like there is more value in being opinionated. In the future we’ll add features like built-in Pagination, Retries (Backoff/Jitter etc), Auth integrations, which should be handled in the SDK.
We’re planning to continue improving this service, so would love to hear what you think of the choices we’ve made, the issues we should address next, and what languages we should work on supporting.
I think it might be interesting to provide some examples without the need to upload a schema, since I assume most people playing with it won't have one ready right off the bat.