@graphql-tools/documents

2.0.0

Major Changes

• #8515  1d70c62 Thanks @ardatan ! - Drop GraphQL v14/v15 support and require Node.js >= 22.18.

  • graphql peer range is now ^16.0.0 || ^17.0.0.
  • engines.node is now >=22.18.0 (Node fs.glob + Babel 8).
  • Dev tooling and @graphql-tools/graphql-tag-pluck move to Babel 8 (@babel/core / parser / traverse / types).
  • The standalone cross-inspect package is discontinued. Use inspect from @graphql-tools/utils instead (Node util.inspect via process.getBuiltinModule, with a small JSON.stringify / String fallback).

  Removed @graphql-tools/utils exports

  Removed	Use instead
  getArgumentValues	import { getArgumentValues } from 'graphql'
  coerceInputs / graphqlJSCompat	graphql@16+ APIs (getArgumentValues, etc.)
  createDeferred / createDeferredPromise	const { promise, resolve, reject } = Promise.withResolvers()
  createGraphQLError	new GraphQLError(message, options) from graphql
  mapMaybePromise	handleMaybePromise from @whatwg-node/promise-helpers
  isPromise / fakePromise / mapAsyncIterator / MaybePromise	@whatwg-node/promise-helpers
  registerAbortSignalListener / getAbortPromise	AbortSignal APIs (throwIfAborted, addEventListener('abort', …, { once: true }), AbortSignal.any, …)
  withCancel / getAsyncIterableWithCancel / getAsyncIteratorWithCancel	Handle cancellation on the async iterator’s return() (or your transport abort path)
  debugTimerStart / debugTimerEnd	Your own timing / console.time if needed
  PromiseWithResolvers (type)	Built-in PromiseWithResolvers<T> / return type of Promise.withResolvers()

  inspect and the WeakMap memoize1…memoize2of5 helpers remain on @graphql-tools/utils (inspect is no longer re-exported from cross-inspect).

  File matching (globby → fs.glob)

  Loaders and @graphql-tools/load-files now use Node’s fs.glob through:

  import { matchFiles, matchFilesSync } from '@graphql-tools/load-files';

  Directory symlinks are followed for recursive (**) patterns:

  • On Node.js ≥26.1 (and ≥24.16 where backported), fs.glob followSymlinks is used.
  • On older engines, symlink directories are discovered only under each pattern’s literal prefix (not the whole cwd) and patterns are re-rooted.
  • Non-recursive / literal patterns skip the symlink walk entirely.

  @graphql-tools/executor hot-path caches (collectSubfields, argument coercion, @stream detection) use memoize2 / memoize3 from utils. collectSubFields in utils stays unmemoized so the executor can own a single memoize3 layer.

  Errors and other cleanup

  • Prefer new GraphQLError(message, options) from graphql. Experimental schema coordinate support remains on locatedError / relocatedError / getSchemaCoordinate.
  • Removed GraphQL versions older than 16 compatibility branches (error construction, validation rule name suffixes, URL.canParse fallback).
  • Promise helpers should be imported from @whatwg-node/promise-helpers (handleMaybePromise, isPromise, fakePromise, mapAsyncIterator, MaybePromise) rather than re-exported from utils.

Patch Changes

• #8515  1d70c62 Thanks @ardatan ! - dependencies updates:
  • Updated dependency graphql@^16.0.0 || ^17.0.0 ↗︎ (from ^14.0.0 || ^15.0.0 || ^16.0.0 || ^17.0.0, in peerDependencies)

1.0.2

Patch Changes

• #8364  7315425 Thanks @copilot-swe-agent ! - Drop lodash.sortby from @graphql-tools/documents by replacing internal sorting usage with native Array.prototype.sort.

1.0.1

Patch Changes

• #6196  26d29d0 Thanks @martyganz ! - Do not sort mutations when using printExecutableGraphQLDocument

1.0.0

Major Changes

• #5274  944a68e8 Thanks @ardatan ! - Drop Node 14 support. Require Node.js >= 16

0.1.0

Minor Changes

• #4949  4de343a0 Thanks @n1ru4l ! - initial release