NewYour coding agent can read the release notes before it upgrades.Set up the MCP server →
npm
npm, #1448 most downloaded on npm
Common package containing utils and types for GraphQL tools
Latest stable
13.2.2
Last release 12 days ago
10 Nov 2026
Ships fairly regularly
a new release about every 9 days
Nearly every release is documented
notes for 60 of the last 60 stable releases
Nothing withdrawn
no release was ever pulled
7 years old
2013 releases · first in 2020
Drag across the ruler to compare, or tap a release to open it.
graphql 17 leaves default undefined for those, so printSchemaWithDirectives dropped the default.
#8641 77d599f Thanks @m-sanders! - Print argument and input field defaults configured with the deprecated defaultValue on graphql 17.
graphql 17 leaves default undefined for those, so printSchemaWithDirectives dropped the default.
Nothing published for this version
Your coding agent can read these notes before it upgrades. Set up the MCP server →
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
@graphql-tools/utils@13.2.1
@graphql-tools/utils@13.2.1
#8626 cc144f6 Thanks @dependabot! - dependencies updates:
@whatwg-node/promise-helpers@^2.0.1 ↗︎ (from ^2.0.0, in dependencies)#8628 03f8963 Thanks @ardatan! - Cache collectFields / collectSubfields across executions when the document has no variable-conditional @skip, @include, or @defer, so variableValues are omitted from the cache key for those documents.
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
@graphql-tools/utils@13.2.0
@graphql-tools/utils@13.2.0
#8606 6da2904 Thanks @ardatan! - loadDocuments / loadTypedefs now accept errorHandling so a single invalid file does not have to hide the rest of the load.
A glob that mixes a valid operation with broken SDL used to throw the first Syntax Error and drop every other file:
# valid.query.graphql
query ValidQuery {
a
}
# broken-a.query.graphql
query {
a
await loadDocuments('**/*.query.graphql', {
loaders: [new GraphQLFileLoader()],
});
// throws Syntax Error
errorHandling chooses what happens next. The default is unchanged (throw the first error).
aggregate waits until every source is attempted, then throws AggregateError with each parse/load failure:
await loadDocuments('**/*.query.graphql', {
loaders: [new GraphQLFileLoader()],
errorHandling: 'aggregate',
});
return does not throw. Failed sources stay in the result as { location, error } without a document, next to the sources that parsed:
const sources = await loadDocuments('**/*.query.graphql', {
loaders: [new GraphQLFileLoader(), new CodeFileLoader()],
errorHandling: 'return',
});
sources[0].document; // ValidQuery
sources[1].document; // undefined
sources[1].error; // GraphQLError: Syntax Error
Source now has an optional error field. @graphql-tools/graphql-file-loader and @graphql-tools/code-file-loader honor the same option. CodeFileLoader's existing noSilentErrors default is unchanged unless errorHandling is set.
Custom loader failures and incomplete inline documents (query Foo {) follow the same option. errorHandling: 'throw' raises the first failure, not AggregateError.
#8588 7770067 Thanks @ardatan! - rewireTypes (used by mapSchema and addTypes) now recreates only the types that actually reference a replaced type.
mapSchema already changes just the mapped types. rewireTypes then walked every type and built a new GraphQLObjectType / enum / scalar so field pointers stayed consistent. That is correct, and it is overkill when a pipeline maps one type on a large schema: unrelated types, unused enums, and unused scalars were cloned on every pass.
The crawl now finds types whose field, argument, interface, or union members point at a different object than the type map (including wrapper types created during mapping), then rebuilds only that set. Specified directives stay as-is. Types that do not reach a replacement keep the same JavaScript object.
createStub returns the graphql-js specified scalars for String / ID / Int / Float / Boolean instead of building an object or input with that name. Stitch typeFromAST uses createStub for every field type.
const schema = buildSchema(/* GraphQL */ `
scalar Unused
enum Color { RED }
type Query { foo: Foo }
type Foo { id: ID }
`)
const mapped = mapSchema(schema, {
[MapperKind.OBJECT_TYPE]: type =>
type.name === 'Foo'
? new GraphQLObjectType({ ...type.toConfig(), description: 'mapped' })
: undefined,
})
mapped.getType('Unused') === schema.getType('Unused')
mapped.getType('Color') === schema.getType('Color')
#8608 f956bfe Thanks @ardatan! - transformInputValue now keeps falsy list items when GraphQL coerces a singleton into a list.
A [String] / [Int] / [Boolean] field can receive "", 0, or false instead of a one-element array. The previous asArray helper treated those as empty and produced [], so rename and other input transforms dropped a valid value. null is still returned as-is. A real list is still walked item by item.
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
One column per quarter.