npm / @graphql-codegen/plugin-helpers
@graphql-codegen/plugin-helpers
What changed in @graphql-codegen/plugin-helpers 7, from its official release notes, upgrade guides and advisories. Sources checked 2026-10-21.
3 breaking1 new APIs and options8 fixes and other
See which of these apply to your code, ranked, in your agent:
npx @unstale/cli init@graphql-codegen/plugin-helpers 712 changes
Breaking changes 3
Federation directives missing their fields argument now throw a descriptive error.
Operations whose root type is missing from the schema now throw a descriptive error.
Types the return value instead of returning any: DocumentNode results use OldVisitDocumentResult, and other roots return unknown unless TResult is provided.
New APIs and options 1
The loader type now accepts a CustomSchemaLoaderFn as well as a path string, allowing imported loader functions without a type cast.
Fixes and other changes 8
@graphql-codegen/cli unwraps AggregateError so schema and document syntax errors continue to print the native GraphQLError with its file location.
Reference selection sets are typed recursively to match nested selections produced by @key, @requires, and @provides.
Accepts null and undefined and returns an empty array.
Accepts null and undefined and returns an empty array.
The visitor parameter is typed as OldVisitor, with enter and leave callbacks receiving typed AST nodes and graphql traversal context.
The cat property is optional, matching the Trace Event format and Profiler.run.
The append field now accepts null items, which core already skipped.
The prepend field now accepts null items, which core already skipped.