@depup/graphql-codegen__plugin-helpers 7.2.1-depup.0 → 7.4.0-depup.0

package/README.md

@@ -13,8 +13,8 @@ npm install @depup/graphql-codegen__plugin-helpers
 
 | Field | Value |
 |-------|-------|
-| Original | [@graphql-codegen/plugin-helpers](https://www.npmjs.com/package/@graphql-codegen/plugin-helpers) @ 7.2.1 |
-| Processed | 2026-08-23 |
+| Original | [@graphql-codegen/plugin-helpers](https://www.npmjs.com/package/@graphql-codegen/plugin-helpers) @ 7.4.0 |
+| Processed | 2026-09-28 |
 | Smoke test | passed |
 | Deps updated | 2 |
 
@@ -22,7 +22,7 @@ npm install @depup/graphql-codegen__plugin-helpers
 
 | Dependency | From | To |
 |------------|------|-----|
-| @graphql-tools/utils | ^11.2.0 | ^12.0.0 |
+| @graphql-tools/utils | ^11.2.0 | ^12.0.1 |
 | tslib | ^2.8.0 | ^2.8.1 |
 
 ---

package/changes.json

@@ -2,13 +2,13 @@
   "bumped": {
     "@graphql-tools/utils": {
       "from": "^11.2.0",
-      "to": "^12.0.0"
+      "to": "^12.0.1"
     },
     "tslib": {
       "from": "^2.8.0",
       "to": "^2.8.1"
     }
   },
-  "timestamp": "2026-08-23T16:05:28.243Z",
+  "timestamp": "2026-09-28T16:10:23.358Z",
   "totalUpdated": 2
 }

package/package.json

@@ -1,12 +1,12 @@
 {
   "name": "@depup/graphql-codegen__plugin-helpers",
-  "version": "7.2.1-depup.0",
+  "version": "7.4.0-depup.0",
   "description": "GraphQL Code Generator common utils and types (with updated dependencies)",
   "peerDependencies": {
     "graphql": "^0.8.0 || ^0.9.0 || ^0.10.0 || ^0.11.0 || ^0.12.0 || ^0.13.0 || ^14.0.0 || ^15.0.0 || ^16.0.0 || ^17.0.0"
   },
   "dependencies": {
-    "@graphql-tools/utils": "^12.0.0",
+    "@graphql-tools/utils": "^12.0.1",
     "change-case-all": "^2.1.0",
     "common-tags": "1.8.2",
     "import-from": "4.0.0",
@@ -57,7 +57,7 @@
     "changes": {
       "@graphql-tools/utils": {
         "from": "^11.2.0",
-        "to": "^12.0.0"
+        "to": "^12.0.1"
       },
       "tslib": {
         "from": "^2.8.0",
@@ -66,8 +66,8 @@
     },
     "depsUpdated": 2,
     "originalPackage": "@graphql-codegen/plugin-helpers",
-    "originalVersion": "7.2.1",
-    "processedAt": "2026-08-23T16:05:30.382Z",
+    "originalVersion": "7.4.0",
+    "processedAt": "2026-09-28T16:10:27.084Z",
     "smokeTest": "passed"
   }
 }

package/typings/oldVisit.d.cts

@@ -1,2 +1,19 @@
-import { ASTNode } from 'graphql';
-export declare function oldVisit(root: ASTNode, { enter: enterVisitors, leave: leaveVisitors, ...newVisitor }: any): any;
+import { ASTNode, DocumentNode } from 'graphql';
+/**
+ * The result of `oldVisit` on a `DocumentNode` with `leave` visitors.
+ *
+ * Each definition is replaced by whatever its leave visitor returned (usually a string). Definitions
+ * without a leave visitor stay as AST nodes, so check each one before using it.
+ */
+export type OldVisitDocumentResult = Omit<DocumentNode, 'definitions'> & {
+    definitions: unknown[];
+};
+/**
+ * Visits `root` with `enter` and `leave` visitor maps keyed by AST node kind.
+ *
+ * Leave visitors replace nodes with whatever they return, so the result's shape depends on the
+ * visitor. For a `DocumentNode`, it defaults to `OldVisitDocumentResult`. When a `Document` leave
+ * visitor returns a value of its own, pass its type as `TResult`.
+ */
+export declare function oldVisit<TResult = OldVisitDocumentResult>(root: DocumentNode, visitor: any): TResult;
+export declare function oldVisit<TResult = unknown>(root: ASTNode, visitor: any): TResult;

package/typings/oldVisit.d.ts

@@ -1,2 +1,19 @@
-import { ASTNode } from 'graphql';
-export declare function oldVisit(root: ASTNode, { enter: enterVisitors, leave: leaveVisitors, ...newVisitor }: any): any;
+import { ASTNode, DocumentNode } from 'graphql';
+/**
+ * The result of `oldVisit` on a `DocumentNode` with `leave` visitors.
+ *
+ * Each definition is replaced by whatever its leave visitor returned (usually a string). Definitions
+ * without a leave visitor stay as AST nodes, so check each one before using it.
+ */
+export type OldVisitDocumentResult = Omit<DocumentNode, 'definitions'> & {
+    definitions: unknown[];
+};
+/**
+ * Visits `root` with `enter` and `leave` visitor maps keyed by AST node kind.
+ *
+ * Leave visitors replace nodes with whatever they return, so the result's shape depends on the
+ * visitor. For a `DocumentNode`, it defaults to `OldVisitDocumentResult`. When a `Document` leave
+ * visitor returns a value of its own, pass its type as `TResult`.
+ */
+export declare function oldVisit<TResult = OldVisitDocumentResult>(root: DocumentNode, visitor: any): TResult;
+export declare function oldVisit<TResult = unknown>(root: ASTNode, visitor: any): TResult;

package/typings/types.d.cts

@@ -3,6 +3,21 @@ import type { ApolloEngineOptions } from '@graphql-tools/apollo-engine-loader';
 import { Source } from '@graphql-tools/utils';
 import type { Profiler } from './profiler.cjs';
 export declare namespace Types {
+    /**
+     * @description Controls how the CLI decides whether the generated content already
+     * matches the output file so the write can be skipped:
+     *
+     * - `'cache-first'` (default): compare against the in-memory hash of what codegen
+     *   last wrote, falling back to reading the file from disk when there is no cached
+     *   entry. Assumes the output is a pure function of the codegen inputs.
+     * - `'disk'`: always compare against the file on disk. Use this when the output
+     *   depends on the file's existing content (e.g. a preset that reads the file and
+     *   rewrites part of it), so a file that was changed on disk is not wrongly skipped
+     *   in watch mode.
+     *
+     * @default 'cache-first'
+     */
+    type ContentComparison = 'cache-first' | 'disk';
     interface GenerateOptions {
         filename: string;
         plugins: Types.ConfiguredPlugin[];
@@ -24,6 +39,11 @@ export declare namespace Types {
         documentTransforms?: ConfiguredDocumentTransform[];
         emitLegacyCommonJSImports?: boolean;
         importExtension?: '' | `.${string}`;
+        /**
+         * @description How the CLI compares generated content against the output file
+         * to decide whether the write can be skipped. See {@link Types.ContentComparison}.
+         */
+        contentComparison?: Types.ContentComparison;
     }
     type FileOutput = {
         filename: string;
@@ -32,6 +52,17 @@ export declare namespace Types {
             beforeOneFileWrite?: LifecycleHooksDefinition['beforeOneFileWrite'];
             afterOneFileWrite?: LifecycleHooksDefinition['afterOneFileWrite'];
         };
+        /**
+         * @description How the CLI compares generated content against the output file
+         * to decide whether the write can be skipped. See {@link Types.ContentComparison}.
+         */
+        contentComparison?: Types.ContentComparison;
+        /**
+         * @description Carries the `overwrite` setting from the `generates` entry that
+         * produced this file, so the CLI can honor it per file (e.g. a preset keyed by a
+         * directory, which can't be looked up by a generated file's path).
+         */
+        overwrite?: boolean | Partial<NormalizedOverwriteOption>;
     };
     interface DocumentFile extends Source {
         hash?: string | null;
@@ -258,6 +289,14 @@ export declare namespace Types {
          * For more details: https://graphql-code-generator.com/docs/config-reference/codegen-config
          */
         overwrite?: boolean | Partial<NormalizedOverwriteOption>;
+        /**
+         * @description How the CLI compares generated content against the output file
+         * to decide whether the write can be skipped. See {@link Types.ContentComparison}.
+         *
+         * A preset can also set this per output from `buildGeneratesSection`; the value
+         * returned there takes precedence over this one.
+         */
+        contentComparison?: Types.ContentComparison;
         /**
          * @description A pointer(s) to your GraphQL documents: query, mutation, subscription and fragment. These documents will be loaded into for all your output files.
          * You can use one of the following:

package/typings/types.d.ts

@@ -3,6 +3,21 @@ import type { ApolloEngineOptions } from '@graphql-tools/apollo-engine-loader';
 import { Source } from '@graphql-tools/utils';
 import type { Profiler } from './profiler.js';
 export declare namespace Types {
+    /**
+     * @description Controls how the CLI decides whether the generated content already
+     * matches the output file so the write can be skipped:
+     *
+     * - `'cache-first'` (default): compare against the in-memory hash of what codegen
+     *   last wrote, falling back to reading the file from disk when there is no cached
+     *   entry. Assumes the output is a pure function of the codegen inputs.
+     * - `'disk'`: always compare against the file on disk. Use this when the output
+     *   depends on the file's existing content (e.g. a preset that reads the file and
+     *   rewrites part of it), so a file that was changed on disk is not wrongly skipped
+     *   in watch mode.
+     *
+     * @default 'cache-first'
+     */
+    type ContentComparison = 'cache-first' | 'disk';
     interface GenerateOptions {
         filename: string;
         plugins: Types.ConfiguredPlugin[];
@@ -24,6 +39,11 @@ export declare namespace Types {
         documentTransforms?: ConfiguredDocumentTransform[];
         emitLegacyCommonJSImports?: boolean;
         importExtension?: '' | `.${string}`;
+        /**
+         * @description How the CLI compares generated content against the output file
+         * to decide whether the write can be skipped. See {@link Types.ContentComparison}.
+         */
+        contentComparison?: Types.ContentComparison;
     }
     type FileOutput = {
         filename: string;
@@ -32,6 +52,17 @@ export declare namespace Types {
             beforeOneFileWrite?: LifecycleHooksDefinition['beforeOneFileWrite'];
             afterOneFileWrite?: LifecycleHooksDefinition['afterOneFileWrite'];
         };
+        /**
+         * @description How the CLI compares generated content against the output file
+         * to decide whether the write can be skipped. See {@link Types.ContentComparison}.
+         */
+        contentComparison?: Types.ContentComparison;
+        /**
+         * @description Carries the `overwrite` setting from the `generates` entry that
+         * produced this file, so the CLI can honor it per file (e.g. a preset keyed by a
+         * directory, which can't be looked up by a generated file's path).
+         */
+        overwrite?: boolean | Partial<NormalizedOverwriteOption>;
     };
     interface DocumentFile extends Source {
         hash?: string | null;
@@ -258,6 +289,14 @@ export declare namespace Types {
          * For more details: https://graphql-code-generator.com/docs/config-reference/codegen-config
          */
         overwrite?: boolean | Partial<NormalizedOverwriteOption>;
+        /**
+         * @description How the CLI compares generated content against the output file
+         * to decide whether the write can be skipped. See {@link Types.ContentComparison}.
+         *
+         * A preset can also set this per output from `buildGeneratesSection`; the value
+         * returned there takes precedence over this one.
+         */
+        contentComparison?: Types.ContentComparison;
         /**
          * @description A pointer(s) to your GraphQL documents: query, mutation, subscription and fragment. These documents will be loaded into for all your output files.
          * You can use one of the following: