npm / @graphql-yoga/plugin-persisted-operations
@graphql-yoga/plugin-persisted-operations
What changed in @graphql-yoga/plugin-persisted-operations 3 to 4, from its official release notes, upgrade guides and advisories. Sources checked 2026-11-13.
11 breaking1 new APIs and options
See which of these apply to your code, ranked, in your agent:
npx @unstale/cli init@graphql-yoga/plugin-persisted-operations 47 changes
Breaking changes 6
Plugins added with addPlugin are inserted in place, so their hooks execute immediately after the plugin that added them.
The minimum supported GraphQL version is now 16; GraphQL 14 and 15 are no longer supported.
Yoga now limits request bodies to 25,000,000 bytes by default. Set maxRequestBodySize: false in createYoga to disable the limit.
The minimum supported Node version is now 22; Node 18 and 20 are no longer supported.
Node.js v16 is no longer supported.
Request body parsing is asynchronous, so yoga.fetch() can return a Promise where it previously returned a synchronous Response, even when resolvers and plugins are synchronous.
New APIs and options 1
The migration instructions install the graphql-yoga NPM package.
@graphql-yoga/plugin-persisted-operations 35 changes
Breaking changes 5
This unused GraphiQL option was removed and can no longer be configured.
This unused GraphiQL option was removed and can no longer be configured.
Subscriptions now use GraphQL over SSE “distinct connections mode” instead of Yoga’s previous custom SSE transport; the notes recommend graphql-sse for clients.
Subscriptions no longer support multipart/mixed as a transport method; they use text/event-stream instead.
Parsing and validation caching are configured through this single option, replacing the separate parserCache and validationCache options.