Comparison with typed-openapi

[trevorpfiz]

Hi!

I have previously used and loved typed-openapi, https://github.com/astahmer/typed-openapi, to generate a zod client from openapi. How does openapi-ts compare?

Thanks!

[mrlubos]

Hey @trevorpfiz, thanks for the question. It appears that package is focused on either types only or types + validator runtimes. I see there's also a related openapi-zod-client package which is types + validator runtimes + HTTP client.

Types only is similar to openapi-typescript, you get the interface and bring your own fetcher. Types + validator starts being more similar to Hey API. We don't currently support validators such as Zod, though that is on the roadmap. We're currently focused on the "back-end" part of API integration, meaning making the actual requests rather than validating data before it's sent (or validating what was received).

For this reason, we offer multiple HTTP clients and we have an upcoming overhaul of clients which is going to take them to the next level (more than 30% of open issues are related to client functionality). Hey API also gives you a service/API layer for making your calls. This is also going to be redesigned to be tree shakeable, so you get a nicer developer experience without your bundle sizes suffering.

Overall, Hey API aims to be The Layer™ between your client and server. It does only a few things today, and we are trying to do those things really well. Once that is accomplished, we will move onto adding integrations such as Zod, if that's desired. Does that help clarify?

[trevorpfiz]

Yep! Thank you for such a clear response!