V2 Roadmap

[saihaj]

We are excited to announce the development of the next major version for graphql-yoga. The goal is to provide a fully-featured, simple to set up, performant and extendable server. Some key features:

• GraphQL-over-HTTP spec compliant
• Extend the GraphQL request flow using envelop
• File uploads (via GraphQL multipart request specification)
• GraphQL Subscriptions (using SSE)
• Logging using Pino
• Improved TypeScript Support
• Try out experimental GraphQL features such as @defer and @stream

We triaged all the current open issues into different categories and tried to address all of them. Let us know if we missed something or if there is something else you would like to see and we can make it happen!

Configurability/Extensibility

• throw from resolver should not be logged #199
• Accessing cookies in subscription resolver functions #424
• Errors thrown from context creator functions are not handled properly #579
• How do I add headers to a server response?  #619
• How to disable introspection #628
• graphql-cost-analysis does not work  #634

Real-time capabilities

• subscriptions.onConnect only works when passed to GraphQlServer.start #594
• Subscription gives me an error message: "Cannot use GraphQLSchema \"[object Object]\" from another module or realm.\n\nEnsure that there is only one instance of \"graphql\" in the node_modules\ndirectory..." #647

Uploads

• Upgrade to graphql-upload #571
• TypeError: createReadStream is not a function #613
• File upload is not working #615

Testing

• Provide graphQlServer.stop() functionality #586
• mocking sample code not working #597
• Testing best practice #616
• How to inject headers while calling graphql query #663

Improved TypeScript support

• Erroneous types in the package. #585
• missing type dependency broke the tsc compiler #611
• Correct way to write middleware in Typescript #617

ESM Support

• Webpack won't build - Module not found #656
• Rollup is not including GraphQLServer #659

Serverless Support

• Serverless yoga help #652

Misc

• How to use the graphql artifact generated by nexus? #618
• Is it possible to convert an express project to graphql-yoga? #624
• Creating a route for receiving non graphql requests #595
• dataSources option for rest apis #626
• Refresh typeDefs and resolvers programmatically #658
• Port keeps running when passed on start method. It can’t get killed either. #627

Future releases

• Allow using with Deno and Cloudflare workers with no additional configs
• Improved development workflow with GraphQL CLI
• Starter projects supporting different styles to create schemas
• Support different storage providers for uploads
• Enhanced Plugin System that extends the base envelop plugin system and allows fully async parse/validate hooks + also hooking into beforeParseRequest/postParseRequest and preSendResponse/postSendResponse

[shamxeed]

This is really good news!!!😍😍😍
Just for my curiosity when are we going to expect the new version?

[saihaj]

@shamxeed Can't promise an exact date yet I have updated the list above with all things that we have landed so far to master and some are WIP and then need to write docs and example for things we have implemented.

[ivandotv]

Hi I'm looking around for the graphQL server, and looking at all the graphQl tools that The Guild offers, I see that there is also a GraphQL Helix server.
Can you please explain the differences between the two?
I see that graphql-yoga has a dependency on a forked version of the helix server.

[saihaj]

Hey @ivandotv 👋🏼 great question we will also add this to our website explaining in more detail.

Difference between GraphQL Helix and GraphQL Yoga?

Helix is an extensible, framework and runtime agnostic GraphQL Server. Helix is an abstraction that all GraphQL HTTP server need. It lets you implement the features you want and the full control of the transport layer.

GraphQL Yoga is a fully-featured server focusing on easy setup and performance. It is built-on top of GraphQL Helix and Envelop. It comes with defaults that we use and believe are needed in a production ready GraphQL server. Yoga provides a cross-platform server that you can just deploy anywhere Deno, CloudFlare workers, Next.js or just a standalone http server. If you are migrating from some HTTP framework you can easily integrate. We try to keep it very simple to deploy @graphql-yoga/core is the package you can use to deploy anywhere and no additional config is needed. graphql-yoga is Node specific package which is just built on top of @graphql-yoga/core which is runtime agnostic and ready to use server.

How did we do this? see next answer

Why does graphql-yoga use forked version helix?

We are currently working on v2 for helix. We are working on creating agnostic HTTP handler using fetch API's Request and Response objects. Except Node.js all the new major runtimes support this out of the box. We are still actively working on the API and getting upstream means we go through the proper review cycle and testing. To get little more control how frequent we can release and so we can just upgrade and test out in yoga we think it is better to use the forked version for now while we work on finalizing all the details upstream in helix for the next release.

[ricardo-valero]

Been using GraphQL EZ for a while.
What's the difference?

[saihaj]

Hey @RicardoValero95 👋🏼

Been using GraphQL EZ for a while.
What's the difference?

GraphQL EZ is a plug-in based server. It is also built on top of envelop. It’s lifecycle methods allow you to hook into different phases of the HTTP request. It also supports multiple deploy targets but it has a separate package for each handler.

Yoga is same in the sense that it is also built on top of envelop. Yoga comes with some built in defaults which we think are necessary for a production server whereas EZ doesn’t have any opinions. EZ’s lifecycle method allow for a very powerful plug-in system which is something we are also working on designing for yoga. Yoga supports multiple deploy targets but doesn’t require any extra configuration. Yoga’s handler are built on top of W3C fetch API which allow us to support any environment, in node we just need to add polyfills (but soon we won’t even need that).

[Urigo]

V 2.0 has been released!!!

Help us spread the word!
Announcement and blog post