Provides `graphql-typed-document-node`, a TypeScript-focused development tool that generates fully typed `DocumentNode` objects (including operation result and variables types) for GraphQL queries, mutations, subscriptions, and fragments. Useful with GraphQL Code Generator and supporting GraphQL client libraries to enable type inference, auto-complete, and type checking in development.
Project status
- The project describes an “improved version of
DocumentNodefor seamless TypeScript integration for GraphQL”, and the most recent detailed update notes in the provided feed are from 2023 (Feb and Mar). GitHub also reports an upstream push today (2026-10-02), but there are no 2024 to 2026 update entries shown here, so ongoing maintenance cadence is unclear. - Update cadence appears sparse in the recent record, with substantial gaps between notable updates (for example, early updates in 2020, then updates again in 2021 and 2023). Relative to today (2026-10-02), this looks more like intermittent maintenance or a quiet period than active regular updates.
AI summary generated
Recent updates
release-1679293672201
This release updates @graphql-typed-document-node/core with a small type export improvement. It adds the DocumentTypeDecoration interface (with the __apiType key) so developers can extend the typing behavior beyond the default DocumentNode usage.
Featuresrelease-1677149075833
This release updates @graphql-typed-document-node/core@3.1.2 with a TS-only cleanup and peer dependency adjustment. The documented code change is switching to type-only imports for DocumentNode, and the release notes also mention adding graphql@v17 to peerDependencies.
core@v3.1.1
core@v3.1.1 is presented as adding support for GraphQL v16. While the release notes mention only GraphQL v16 support, the diff also includes a type-level change to the internal TypedDocumentNode interface and additional patch-package definitions for Apollo React components.
Featurespatch-cli@v3.0.5
patch-cli@v3.0.5 adds a new patch intended to support @apollo/client@3.2.0-beta.6. The only code change is the introduction of a patch file that modifies Apollo's shipped React TypeScript declaration files.
Featurespatch-cli@v3.0.4
patch-cli@v3.0.4 updates the bundled patch files shipped with @graphql-typed-document-node/patch-cli. The release notes state fixes for apollo-cache patches and @apollo/react-components patches.
core@v3.1.0
core@v3.1.0 adds helper types (ResultOf, VariablesOf) for extracting operation result and variables types from a TypedDocumentNode. It also updates the TypedDocumentNode type to include internal “marker” properties so structural typing preserves generics.
Featurespatch-cli@v3.0.2
The release notes for patch-cli@v3.0.2 only mention that the apollo-cache patch file was updated. The actual diff shows additional structural and type-level changes across the monorepo, including introduction of a dedicated @graphql-typed-document-node/patch-cli package and changes to exported typings.
Featuresv3.0.0
v3.0.0 splits responsibilities between the core and CLI packages. The @graphql-typed-document-node/core package now only exposes TypedDocumentNode and is designed to have zero dependencies, while @graphql-typed-document-node/patch-cli holds the patch CLI and patch files for other libraries.
Breakingv2.1.0
v2.1.0 adds patch-package support for @vue/apollo-composable v4.0.0-alpha.10, updating the library's type definitions so TypedDocumentNode can be used with useQuery and useMutation. The release also updates repository docs and adds a targeted TypeScript test for the patched typings.
Featuresv2.0.0
v2.0.0 transitions the project from TypeScript module augmentation to a patch-package based approach for integrating TypedDocumentNode into various Apollo and GraphQL ecosystems. It also adds typings support for multiple clients/frameworks such as react-apollo (deprecated), apollo-angular, urql, and includes support for GraphQL 14.
Features