Generate Genql graphql client instance out of box

[jasonkuhrt]

Perceived Problem

• The current test test client is based upon graphql-request
• Users are left to building queries as raw strings
• no type safety
• no autocomplete

Ideas / Proposed Solution(s)

• https://genql.now.sh

[jasonkuhrt]

Started a spike today, got stuck on https://github.com/remorses/genql/issues/3.

[jasonkuhrt]

Ok got unstuck and proved it out in the hello world example:

Notes

• need to install genql-cli to run the generation genql --schema api.graphql --output client
• need to install genql-runtime to power the generated client
• no jsdoc on anything (https://github.com/remorses/genql/issues/4)
• generics make autocomplete a bit hard to follow, but might improve https://github.com/remorses/genql/issues/1#issuecomment-644993306
• separate clients between subscription and query/mutation. Also might change (se e same issue above)
• the generics make it non-trivial to reference the client instance class, hence we're using typeof in the screenshot above
  • the reason for the indirection is I was stress testing things, how easy it would be to wrap etc.
• client constructor has a bunch of options

[JustinVoitel]

If anyone is still interested in this, I created a plugin that generates a genql client whenever api.graphql is updated: nexus-plugin-genql. No docs yet but its pretty straithforward to get started

[jasonkuhrt]

API is coming https://github.com/remorses/genql/issues/21