@depup/graphql-codegen__plugin-helpers 7.2.0-depup.0 → 7.3.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.0 |
-| Processed | 2026-08-22 |
+| Original | [@graphql-codegen/plugin-helpers](https://www.npmjs.com/package/@graphql-codegen/plugin-helpers) @ 7.3.0 |
+| Processed | 2026-09-01 |
 | Smoke test | passed |
 | Deps updated | 2 |
 

package/changes.json

@@ -9,6 +9,6 @@
       "to": "^2.8.1"
     }
   },
-  "timestamp": "2026-08-22T08:07:17.292Z",
+  "timestamp": "2026-09-01T16:30:50.311Z",
   "totalUpdated": 2
 }

package/cjs/profiler.js

@@ -4,20 +4,37 @@ exports.createNoopProfiler = createNoopProfiler;
 exports.createProfiler = createProfiler;
 function createNoopProfiler() {
     return {
+        outputName: null,
         run(fn) {
             return Promise.resolve().then(() => fn());
         },
         collect() {
             return [];
         },
+        clear() { },
     };
 }
 function createProfiler() {
+    /** Build a unique, human-readable trace filename e.g. `codegen-20111005T144800000.json` */
+    function generateOutputName() {
+        const datetimeNormalized = new Date()
+            .toISOString() // 2011-10-05T14:48:00.000Z
+            .replace(/[-:.Z]/g, ''); // 20111005T144800000
+        return `codegen-${datetimeNormalized}.json`;
+    }
     const events = [];
+    let outputName = generateOutputName();
     return {
+        get outputName() {
+            return outputName;
+        },
         collect() {
             return events;
         },
+        clear() {
+            events.length = 0;
+            outputName = generateOutputName();
+        },
         run(fn, name, cat) {
             let startTime;
             return Promise.resolve()

package/esm/profiler.js

@@ -1,19 +1,36 @@
 export function createNoopProfiler() {
     return {
+        outputName: null,
         run(fn) {
             return Promise.resolve().then(() => fn());
         },
         collect() {
             return [];
         },
+        clear() { },
     };
 }
 export function createProfiler() {
+    /** Build a unique, human-readable trace filename e.g. `codegen-20111005T144800000.json` */
+    function generateOutputName() {
+        const datetimeNormalized = new Date()
+            .toISOString() // 2011-10-05T14:48:00.000Z
+            .replace(/[-:.Z]/g, ''); // 20111005T144800000
+        return `codegen-${datetimeNormalized}.json`;
+    }
     const events = [];
+    let outputName = generateOutputName();
     return {
+        get outputName() {
+            return outputName;
+        },
         collect() {
             return events;
         },
+        clear() {
+            events.length = 0;
+            outputName = generateOutputName();
+        },
         run(fn, name, cat) {
             let startTime;
             return Promise.resolve()

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@depup/graphql-codegen__plugin-helpers",
-  "version": "7.2.0-depup.0",
+  "version": "7.3.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"
@@ -66,8 +66,8 @@
     },
     "depsUpdated": 2,
     "originalPackage": "@graphql-codegen/plugin-helpers",
-    "originalVersion": "7.2.0",
-    "processedAt": "2026-08-22T08:07:20.698Z",
+    "originalVersion": "7.3.0",
+    "processedAt": "2026-09-01T16:30:52.613Z",
     "smokeTest": "passed"
   }
 }

package/typings/profiler.d.cts

@@ -21,8 +21,16 @@ export interface ProfilerEvent {
     cname?: string;
 }
 export interface Profiler {
+    /**
+     * Filename of the current trace's collected events should be written to,
+     * or `null` when profiling is disabled.
+     * A fresh name is generated whenever {@link clear} starts a new trace.
+     */
+    readonly outputName: string | null;
     run<T>(fn: () => Promise<T>, name: string, cat?: string): Promise<T>;
     collect(): ProfilerEvent[];
+    /** Discard all collected events so the next {@link collect} starts fresh */
+    clear(): void;
 }
 export declare function createNoopProfiler(): Profiler;
 export declare function createProfiler(): Profiler;

package/typings/profiler.d.ts

@@ -21,8 +21,16 @@ export interface ProfilerEvent {
     cname?: string;
 }
 export interface Profiler {
+    /**
+     * Filename of the current trace's collected events should be written to,
+     * or `null` when profiling is disabled.
+     * A fresh name is generated whenever {@link clear} starts a new trace.
+     */
+    readonly outputName: string | null;
     run<T>(fn: () => Promise<T>, name: string, cat?: string): Promise<T>;
     collect(): ProfilerEvent[];
+    /** Discard all collected events so the next {@link collect} starts fresh */
+    clear(): void;
 }
 export declare function createNoopProfiler(): Profiler;
 export declare function createProfiler(): Profiler;

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: