How to best support Hydra API clients?

[ghost]

While working on a small game built on top of Hydra (https://github.com/abailly/black-jack for the curious), I came across the obvious issue of writing a proper client to interact with Hydra API. My client software is in Haskell for no other reason than I feel comfortable programming in this language, but I am not sure it makes sense to have a dependency on hydra-node's Haskell package, as this would mean replicating the same mistake than the Cardano-node did, eg. requiring clients to depend on the whole dependency tree of the hydra-node instead of a nice, reasonably self-contained library.

We provide a language agnostic specification of the API in the form of a json-schema which is great (https://hydra.family/head-protocol/api-reference), but it's actually not straightforward to leverage that schema for generating boilerplate code needed to interact with a Hydra server. I found this article https://dev.to/sshine/a-review-of-json-schema-libraries-for-haskell-321 which seems to say there's no Haskell tool providing this. And browsing the json-schema site gave me this link (https://json-schema.org/implementations.html#code-generation) which points to a few code generators for other languages, but not that many.

[ch1bo]

Sounds like you would want something like this

[ghost]

For the Haskell use case, yes, that would help. But for anyone wanting to write a client in say TS, Rust or Go, I am not too sure the json-schema approach is the best one.

[uhbif19]

We provide a language agnostic specification of the API in the form of a json-schema which is great

I thought that spec is AsyncAPI, not just JSON Schema? I only found AsyncAPI file in Hydra repo.

While JSON parsing/construction of Input/Outputs is probably the most hard part for client implementation, individual schemes for them should be somehow extracted from AsyncAPI spec, to use generators, I guess.

Also AsyncAPI has some client generators too, while seems like not very much:
https://github.com/asyncapi/generator#list-of-official-generator-templates

which points to a few code generators for other languages, but not that many

Are there any protocols with better generators support when Json Schema has?