unstale

npm / @graphql-yoga/plugin-defer-stream

@graphql-yoga/plugin-defer-stream

What changed in @graphql-yoga/plugin-defer-stream 3 to 4, from its official release notes, upgrade guides and advisories. Sources checked 2026-11-13.

9 breaking1 behavior and defaults1 fixes and other

See which of these apply to your code, ranked, in your agent:

npx @unstale/cli init

@unstale/cli 0.3.0 on npm

@graphql-yoga/plugin-defer-stream 44 changes

Breaking changes 3

  • Plugins added with addPlugin are inserted in place, so their hooks execute immediately after the plugin that added them rather than last.

    4.0.0upgrade guide

  • The migration instructions say to install the new NPM package graphql-yoga.

    4.0.0upgrade guide

  • Node.js v16 is no longer supported.

    4.0.0upgrade guide

Behavior and default changes 1

  • Yoga maps the GraphQL HTTP Accept header to the executor's incrementalSpec. v0.2 uses its payload format and is echoed on Content-Type; v0.1 remains the default for deferSpec=20220824 or bare multipart/mixed, and unsupported specs yield 406.

    4.0.0release notes

@graphql-yoga/plugin-defer-stream 37 changes

Breaking changes 6

  • This graphiql option is removed completely because it was not used.

    3.0.0upgrade guide

  • This graphiql option is removed completely because it was not used.

    3.0.0upgrade guide

  • Subscriptions now implement GraphQL over SSE “distinct connections mode” instead of Yoga’s previous custom SSE transport.

    3.0.0upgrade guide

  • Install the new NPM package for Yoga.

    3.0.0upgrade guide

  • Subscriptions no longer support multipart/mixed as a transport method; only text/event-stream is supported.

    3.0.0upgrade guide

  • A single option now configures the parse and validation cache, replacing two separate envelop plugins.

    3.0.0upgrade guide

Fixes and other changes 1

  • The notes recommend using graphql-sse on the client side for subscriptions.

    3.0.0upgrade guide