@trackunit/eslint-plugin-trackunit 0.6.55 → 0.6.57

package/CHANGELOG.md

@@ -1,3 +1,24 @@
+## 0.6.57 (2026-07-03)
+
+### 🧱 Updated Dependencies
+
+- Updated shared-utils to 1.15.57
+
+## 0.6.56 (2026-07-03)
+
+### 🚀 Features
+
+- **eslint:** add no-deprecated-graphql-fields rule ([#24113](https://github.com/Trackunit/manager/pull/24113))
+
+### 🧱 Updated Dependencies
+
+- Updated shared-utils to 1.15.56
+
+### ❤️ Thank You
+
+- Cursor @cursoragent
+- Michael Buss Rønne @man-trackunit
+
 ## 0.6.55 (2026-07-02)
 
 ### 🚀 Features

package/README.md

@@ -78,9 +78,10 @@ All custom rules are enabled automatically through the presets under the `@track
 ### NX / Monorepo
 
 
-| Rule                                                         | Severity | Auto-fix | Description                                                                                            |
-| ------------------------------------------------------------ | -------- | -------- | ------------------------------------------------------------------------------------------------------ |
-| `@trackunit/no-internal-graphql-when-tagged-with-gql-public` | error    | —        | Prevents internal GraphQL usage in projects tagged with `gql-public`. Applied to `project.json` files. |
+| Rule                                                         | Severity | Auto-fix | Description                                                                                                               |
+| ------------------------------------------------------------ | -------- | -------- | ------------------------------------------------------------------------------------------------------------------------- |
+| `@trackunit/no-internal-graphql-when-tagged-with-gql-public` | error    | —        | Prevents internal GraphQL usage in projects tagged with `gql:public`. Applied to `project.json` files.                   |
+| `@trackunit/no-deprecated-graphql-fields`                    | error    | —        | Prevents usage of `@deprecated` GraphQL fields in projects tagged with `dependencies:no-deprecated`. Applied to `project.json` files. |
 
 
 ### Storybook

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@trackunit/eslint-plugin-trackunit",
-  "version": "0.6.55",
+  "version": "0.6.57",
   "license": "SEE LICENSE IN LICENSE.txt",
   "repository": "https://github.com/Trackunit/manager",
   "engines": {
@@ -26,7 +26,8 @@
   },
   "peerDependencies": {
     "@typescript-eslint/parser": "^8.58.1",
-    "eslint": "^9.33.0"
+    "eslint": "^9.33.0",
+    "graphql": "^16.0.0"
   },
   "migrations": "./migrations.json",
   "types": "./src/index.d.ts",

package/src/index.d.ts

@@ -6,4 +6,4 @@ export { findMonorepoRoot } from "./lib/config/utils";
 export type { MatchCriteria, ProjectMetadata } from "./lib/utils/nx-utils";
 export { strictJsdocRules } from "./lib/config/fragments/jsdoc-rules";
 export { restrictedImportRules } from "./lib/config/fragments/restricted-imports";
-export { globals, jsdoc, nx, reactHooks, tsParser } from "./lib/config/plugins";
+export { globals, jsdoc, localRulesPlugin, nx, reactHooks, tsParser } from "./lib/config/plugins";

package/src/index.js

@@ -1,6 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.tsParser = exports.reactHooks = exports.nx = exports.jsdoc = exports.globals = exports.restrictedImportRules = exports.strictJsdocRules = exports.findMonorepoRoot = exports.createSkipWhen = exports.configs = void 0;
+exports.tsParser = exports.reactHooks = exports.nx = exports.localRulesPlugin = exports.jsdoc = exports.globals = exports.restrictedImportRules = exports.strictJsdocRules = exports.findMonorepoRoot = exports.createSkipWhen = exports.configs = void 0;
 const rules_map_1 = require("./lib/rules-map");
 exports.default = rules_map_1.rulesMap;
 var config_1 = require("./lib/config");
@@ -16,6 +16,7 @@ Object.defineProperty(exports, "restrictedImportRules", { enumerable: true, get:
 var plugins_1 = require("./lib/config/plugins");
 Object.defineProperty(exports, "globals", { enumerable: true, get: function () { return plugins_1.globals; } });
 Object.defineProperty(exports, "jsdoc", { enumerable: true, get: function () { return plugins_1.jsdoc; } });
+Object.defineProperty(exports, "localRulesPlugin", { enumerable: true, get: function () { return plugins_1.localRulesPlugin; } });
 Object.defineProperty(exports, "nx", { enumerable: true, get: function () { return plugins_1.nx; } });
 Object.defineProperty(exports, "reactHooks", { enumerable: true, get: function () { return plugins_1.reactHooks; } });
 Object.defineProperty(exports, "tsParser", { enumerable: true, get: function () { return plugins_1.tsParser; } });

package/src/lib/config/index.d.ts

@@ -26,6 +26,9 @@ export declare const configs: {
                     "no-typescript-assertion": import("@typescript-eslint/utils/ts-eslint").RuleModule<"angleBracketAssertion" | "asAssertion" | "nonNullAssertion", [], unknown, import("@typescript-eslint/utils/ts-eslint").RuleListener> & {
                         name: string;
                     };
+                    "no-deprecated-graphql-fields": import("@typescript-eslint/utils/ts-eslint").RuleModule<"deprecatedFieldUsed", [], unknown, import("@typescript-eslint/utils/ts-eslint").RuleListener> & {
+                        name: string;
+                    };
                     "no-internal-graphql-when-tagged-with-gql-public": import("@typescript-eslint/utils/ts-eslint").RuleModule<"internalGraphqlFileFound", [], unknown, import("@typescript-eslint/utils/ts-eslint").RuleListener> & {
                         name: string;
                     };
@@ -136,6 +139,7 @@ export declare const configs: {
         rules: {
             [x: string]: import("eslint").Linter.RuleEntry<any[]>;
             "@trackunit/no-internal-graphql-when-tagged-with-gql-public"?: undefined;
+            "@trackunit/no-deprecated-graphql-fields"?: undefined;
             "@typescript-eslint/no-require-imports"?: undefined;
             "@nx/enforce-module-boundaries"?: undefined;
         };
@@ -178,6 +182,7 @@ export declare const configs: {
             "no-unused-expressions": string;
             "no-shadow": string;
             "@trackunit/no-internal-graphql-when-tagged-with-gql-public"?: undefined;
+            "@trackunit/no-deprecated-graphql-fields"?: undefined;
             "@typescript-eslint/no-require-imports"?: undefined;
             "@nx/enforce-module-boundaries"?: undefined;
         };
@@ -215,6 +220,9 @@ export declare const configs: {
                     "no-typescript-assertion": import("@typescript-eslint/utils/ts-eslint").RuleModule<"angleBracketAssertion" | "asAssertion" | "nonNullAssertion", [], unknown, import("@typescript-eslint/utils/ts-eslint").RuleListener> & {
                         name: string;
                     };
+                    "no-deprecated-graphql-fields": import("@typescript-eslint/utils/ts-eslint").RuleModule<"deprecatedFieldUsed", [], unknown, import("@typescript-eslint/utils/ts-eslint").RuleListener> & {
+                        name: string;
+                    };
                     "no-internal-graphql-when-tagged-with-gql-public": import("@typescript-eslint/utils/ts-eslint").RuleModule<"internalGraphqlFileFound", [], unknown, import("@typescript-eslint/utils/ts-eslint").RuleListener> & {
                         name: string;
                     };
@@ -288,6 +296,7 @@ export declare const configs: {
         };
         rules: {
             "@trackunit/no-internal-graphql-when-tagged-with-gql-public": string;
+            "@trackunit/no-deprecated-graphql-fields": string;
             "@typescript-eslint/no-require-imports"?: undefined;
             "@nx/enforce-module-boundaries"?: undefined;
         };
@@ -296,6 +305,7 @@ export declare const configs: {
         rules: {
             "@typescript-eslint/no-require-imports": string;
             "@trackunit/no-internal-graphql-when-tagged-with-gql-public"?: undefined;
+            "@trackunit/no-deprecated-graphql-fields"?: undefined;
             "@nx/enforce-module-boundaries"?: undefined;
         };
         plugins?: undefined;
@@ -305,6 +315,7 @@ export declare const configs: {
         rules: {
             "@nx/enforce-module-boundaries": string;
             "@trackunit/no-internal-graphql-when-tagged-with-gql-public"?: undefined;
+            "@trackunit/no-deprecated-graphql-fields"?: undefined;
             "@typescript-eslint/no-require-imports"?: undefined;
         };
         plugins?: undefined;
@@ -336,6 +347,9 @@ export declare const configs: {
                     "no-typescript-assertion": import("@typescript-eslint/utils/ts-eslint").RuleModule<"angleBracketAssertion" | "asAssertion" | "nonNullAssertion", [], unknown, import("@typescript-eslint/utils/ts-eslint").RuleListener> & {
                         name: string;
                     };
+                    "no-deprecated-graphql-fields": import("@typescript-eslint/utils/ts-eslint").RuleModule<"deprecatedFieldUsed", [], unknown, import("@typescript-eslint/utils/ts-eslint").RuleListener> & {
+                        name: string;
+                    };
                     "no-internal-graphql-when-tagged-with-gql-public": import("@typescript-eslint/utils/ts-eslint").RuleModule<"internalGraphqlFileFound", [], unknown, import("@typescript-eslint/utils/ts-eslint").RuleListener> & {
                         name: string;
                     };

package/src/lib/config/plugins.d.ts

@@ -44,6 +44,9 @@ export declare const localRulesPlugin: {
         "no-typescript-assertion": import("@typescript-eslint/utils/ts-eslint").RuleModule<"angleBracketAssertion" | "asAssertion" | "nonNullAssertion", [], unknown, import("@typescript-eslint/utils/ts-eslint").RuleListener> & {
             name: string;
         };
+        "no-deprecated-graphql-fields": import("@typescript-eslint/utils/ts-eslint").RuleModule<"deprecatedFieldUsed", [], unknown, import("@typescript-eslint/utils/ts-eslint").RuleListener> & {
+            name: string;
+        };
         "no-internal-graphql-when-tagged-with-gql-public": import("@typescript-eslint/utils/ts-eslint").RuleModule<"internalGraphqlFileFound", [], unknown, import("@typescript-eslint/utils/ts-eslint").RuleListener> & {
             name: string;
         };

package/src/lib/config/presets/base.d.ts

@@ -26,6 +26,9 @@ export declare const base: (import("eslint").Linter.FlatConfig<import("eslint").
                 "no-typescript-assertion": import("@typescript-eslint/utils/ts-eslint").RuleModule<"angleBracketAssertion" | "asAssertion" | "nonNullAssertion", [], unknown, import("@typescript-eslint/utils/ts-eslint").RuleListener> & {
                     name: string;
                 };
+                "no-deprecated-graphql-fields": import("@typescript-eslint/utils/ts-eslint").RuleModule<"deprecatedFieldUsed", [], unknown, import("@typescript-eslint/utils/ts-eslint").RuleListener> & {
+                    name: string;
+                };
                 "no-internal-graphql-when-tagged-with-gql-public": import("@typescript-eslint/utils/ts-eslint").RuleModule<"internalGraphqlFileFound", [], unknown, import("@typescript-eslint/utils/ts-eslint").RuleListener> & {
                     name: string;
                 };
@@ -136,6 +139,7 @@ export declare const base: (import("eslint").Linter.FlatConfig<import("eslint").
     rules: {
         [x: string]: import("eslint").Linter.RuleEntry<any[]>;
         "@trackunit/no-internal-graphql-when-tagged-with-gql-public"?: undefined;
+        "@trackunit/no-deprecated-graphql-fields"?: undefined;
         "@typescript-eslint/no-require-imports"?: undefined;
         "@nx/enforce-module-boundaries"?: undefined;
     };
@@ -178,6 +182,7 @@ export declare const base: (import("eslint").Linter.FlatConfig<import("eslint").
         "no-unused-expressions": string;
         "no-shadow": string;
         "@trackunit/no-internal-graphql-when-tagged-with-gql-public"?: undefined;
+        "@trackunit/no-deprecated-graphql-fields"?: undefined;
         "@typescript-eslint/no-require-imports"?: undefined;
         "@nx/enforce-module-boundaries"?: undefined;
     };
@@ -215,6 +220,9 @@ export declare const base: (import("eslint").Linter.FlatConfig<import("eslint").
                 "no-typescript-assertion": import("@typescript-eslint/utils/ts-eslint").RuleModule<"angleBracketAssertion" | "asAssertion" | "nonNullAssertion", [], unknown, import("@typescript-eslint/utils/ts-eslint").RuleListener> & {
                     name: string;
                 };
+                "no-deprecated-graphql-fields": import("@typescript-eslint/utils/ts-eslint").RuleModule<"deprecatedFieldUsed", [], unknown, import("@typescript-eslint/utils/ts-eslint").RuleListener> & {
+                    name: string;
+                };
                 "no-internal-graphql-when-tagged-with-gql-public": import("@typescript-eslint/utils/ts-eslint").RuleModule<"internalGraphqlFileFound", [], unknown, import("@typescript-eslint/utils/ts-eslint").RuleListener> & {
                     name: string;
                 };
@@ -288,6 +296,7 @@ export declare const base: (import("eslint").Linter.FlatConfig<import("eslint").
     };
     rules: {
         "@trackunit/no-internal-graphql-when-tagged-with-gql-public": string;
+        "@trackunit/no-deprecated-graphql-fields": string;
         "@typescript-eslint/no-require-imports"?: undefined;
         "@nx/enforce-module-boundaries"?: undefined;
     };
@@ -296,6 +305,7 @@ export declare const base: (import("eslint").Linter.FlatConfig<import("eslint").
     rules: {
         "@typescript-eslint/no-require-imports": string;
         "@trackunit/no-internal-graphql-when-tagged-with-gql-public"?: undefined;
+        "@trackunit/no-deprecated-graphql-fields"?: undefined;
         "@nx/enforce-module-boundaries"?: undefined;
     };
     plugins?: undefined;
@@ -305,6 +315,7 @@ export declare const base: (import("eslint").Linter.FlatConfig<import("eslint").
     rules: {
         "@nx/enforce-module-boundaries": string;
         "@trackunit/no-internal-graphql-when-tagged-with-gql-public"?: undefined;
+        "@trackunit/no-deprecated-graphql-fields"?: undefined;
         "@typescript-eslint/no-require-imports"?: undefined;
     };
     plugins?: undefined;

package/src/lib/config/presets/base.js

@@ -121,6 +121,7 @@ exports.base = [
         },
         rules: {
             "@trackunit/no-internal-graphql-when-tagged-with-gql-public": "error",
+            "@trackunit/no-deprecated-graphql-fields": "warn",
         },
     },
     jest_overrides_1.baseJestOverrides,

package/src/lib/config/presets/react.d.ts

@@ -25,6 +25,9 @@ export declare const reactPreset: (import("eslint").Linter.Config<import("eslint
                 "no-typescript-assertion": import("@typescript-eslint/utils/ts-eslint").RuleModule<"angleBracketAssertion" | "asAssertion" | "nonNullAssertion", [], unknown, import("@typescript-eslint/utils/ts-eslint").RuleListener> & {
                     name: string;
                 };
+                "no-deprecated-graphql-fields": import("@typescript-eslint/utils/ts-eslint").RuleModule<"deprecatedFieldUsed", [], unknown, import("@typescript-eslint/utils/ts-eslint").RuleListener> & {
+                    name: string;
+                };
                 "no-internal-graphql-when-tagged-with-gql-public": import("@typescript-eslint/utils/ts-eslint").RuleModule<"internalGraphqlFileFound", [], unknown, import("@typescript-eslint/utils/ts-eslint").RuleListener> & {
                     name: string;
                 };

package/src/lib/rules/no-deprecated-graphql-fields/no-deprecated-graphql-fields.d.ts

@@ -0,0 +1,4 @@
+import { ESLintUtils } from "@typescript-eslint/utils";
+export declare const noDeprecatedGraphqlFields: ESLintUtils.RuleModule<"deprecatedFieldUsed", [], unknown, ESLintUtils.RuleListener> & {
+    name: string;
+};

package/src/lib/rules/no-deprecated-graphql-fields/no-deprecated-graphql-fields.js

@@ -0,0 +1,104 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.noDeprecatedGraphqlFields = void 0;
+const tslib_1 = require("tslib");
+const utils_1 = require("@typescript-eslint/utils");
+const fs = tslib_1.__importStar(require("fs"));
+const graphql_1 = require("graphql");
+const path = tslib_1.__importStar(require("path"));
+const file_utils_1 = require("../../utils/file-utils");
+const schema_cache_1 = require("./schema-cache");
+const createRule = utils_1.ESLintUtils.RuleCreator(name => `https://github.com/trackunit/manager/blob/main/libs/eslint/plugin-trackunit/src/lib/rules/${name}/${name}.ts`);
+const EXCLUDED_DIRS = new Set(["node_modules", "generated", "dist"]);
+const collectGraphqlFiles = (dir, files = []) => {
+    let entries;
+    try {
+        entries = fs.readdirSync(dir, { withFileTypes: true });
+    }
+    catch {
+        return files;
+    }
+    for (const entry of entries) {
+        const fullPath = path.join(dir, entry.name);
+        let stat;
+        try {
+            stat = fs.statSync(fullPath);
+        }
+        catch {
+            continue;
+        }
+        if (stat.isDirectory()) {
+            if (!EXCLUDED_DIRS.has(entry.name)) {
+                collectGraphqlFiles(fullPath, files);
+            }
+        }
+        else if (entry.name.endsWith(".graphql")) {
+            files.push(fullPath);
+        }
+    }
+    return files;
+};
+exports.noDeprecatedGraphqlFields = createRule({
+    name: "no-deprecated-graphql-fields",
+    meta: {
+        type: "problem",
+        docs: {
+            description: "Disallow usage of @deprecated GraphQL fields in .graphql operation files",
+        },
+        messages: {
+            deprecatedFieldUsed: "Deprecated GraphQL field used in {{file}}: {{message}}",
+        },
+        schema: [],
+    },
+    defaultOptions: [],
+    create(context) {
+        return {
+            Program: _node => {
+                const sourceFilePath = context.filename;
+                if (!sourceFilePath.endsWith("/project.json")) {
+                    return;
+                }
+                const nxJsonPath = (0, file_utils_1.findNearestFile)(sourceFilePath, "nx.json");
+                if (!nxJsonPath) {
+                    return;
+                }
+                const monorepoRoot = path.dirname(nxJsonPath);
+                const schemaPath = path.join(monorepoRoot, "libs", "api", "internal-gql-schema", "generated", "internal-schema.gql");
+                const schema = (0, schema_cache_1.getSchema)(schemaPath);
+                if (!schema) {
+                    return;
+                }
+                const projectDir = path.dirname(sourceFilePath);
+                const graphqlFiles = collectGraphqlFiles(projectDir);
+                for (const gqlFile of graphqlFiles) {
+                    let content;
+                    try {
+                        content = fs.readFileSync(gqlFile, "utf8");
+                    }
+                    catch {
+                        continue;
+                    }
+                    let document;
+                    try {
+                        document = (0, graphql_1.parse)(content);
+                    }
+                    catch {
+                        continue;
+                    }
+                    const errors = (0, graphql_1.validate)(schema, document, [graphql_1.NoDeprecatedCustomRule]);
+                    for (const error of errors) {
+                        context.report({
+                            messageId: "deprecatedFieldUsed",
+                            data: {
+                                file: path.relative(monorepoRoot, gqlFile),
+                                message: error.message,
+                            },
+                            loc: { line: 1, column: 0 },
+                        });
+                    }
+                }
+            },
+        };
+    },
+});
+//# sourceMappingURL=no-deprecated-graphql-fields.js.map

package/src/lib/rules/no-deprecated-graphql-fields/schema-cache.d.ts

@@ -0,0 +1,3 @@
+import { type GraphQLSchema } from "graphql";
+export declare const getSchema: (schemaPath: string) => GraphQLSchema | null;
+export declare const clearSchemaCache: () => void;

package/src/lib/rules/no-deprecated-graphql-fields/schema-cache.js

@@ -0,0 +1,31 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.clearSchemaCache = exports.getSchema = void 0;
+const tslib_1 = require("tslib");
+const fs = tslib_1.__importStar(require("fs"));
+const graphql_1 = require("graphql");
+/**
+ * Caches parsed schemas by path to avoid re-parsing on every project.json lint.
+ * Isolated in its own module so tests can reset it independently of the rule's production exports.
+ */
+const schemaCache = new Map();
+const getSchema = (schemaPath) => {
+    if (schemaCache.has(schemaPath)) {
+        return schemaCache.get(schemaPath) ?? null;
+    }
+    try {
+        const content = fs.readFileSync(schemaPath, "utf8");
+        const schema = (0, graphql_1.buildSchema)(content);
+        schemaCache.set(schemaPath, schema);
+        return schema;
+    }
+    catch {
+        return null;
+    }
+};
+exports.getSchema = getSchema;
+const clearSchemaCache = () => {
+    schemaCache.clear();
+};
+exports.clearSchemaCache = clearSchemaCache;
+//# sourceMappingURL=schema-cache.js.map

package/src/lib/rules-map.d.ts

@@ -22,6 +22,9 @@ export declare const rulesMap: {
     "no-typescript-assertion": ESLintUtils.RuleModule<"angleBracketAssertion" | "asAssertion" | "nonNullAssertion", [], unknown, ESLintUtils.RuleListener> & {
         name: string;
     };
+    "no-deprecated-graphql-fields": ESLintUtils.RuleModule<"deprecatedFieldUsed", [], unknown, ESLintUtils.RuleListener> & {
+        name: string;
+    };
     "no-internal-graphql-when-tagged-with-gql-public": ESLintUtils.RuleModule<"internalGraphqlFileFound", [], unknown, ESLintUtils.RuleListener> & {
         name: string;
     };

package/src/lib/rules-map.js

@@ -4,6 +4,7 @@ exports.rulesMap = void 0;
 const component_name_matches_filename_1 = require("./rules/component-name-matches-filename/component-name-matches-filename");
 const cva_merge_base_classes_as_array_1 = require("./rules/cva-merge-base-classes-as-array/cva-merge-base-classes-as-array");
 const design_guideline_button_icon_size_match_1 = require("./rules/design-guideline-button-icon-size-match/design-guideline-button-icon-size-match");
+const no_deprecated_graphql_fields_1 = require("./rules/no-deprecated-graphql-fields/no-deprecated-graphql-fields");
 const no_internal_barrel_files_1 = require("./rules/no-internal-barrel-files/no-internal-barrel-files");
 const no_internal_graphql_when_tagged_with_gql_public_1 = require("./rules/no-internal-graphql-when-tagged-with-gql-public/no-internal-graphql-when-tagged-with-gql-public");
 const no_jest_mock_trackunit_react_core_hooks_1 = require("./rules/no-jest-mock-trackunit-react-core-hooks/no-jest-mock-trackunit-react-core-hooks");
@@ -25,6 +26,7 @@ exports.rulesMap = {
     "cva-merge-base-classes-as-array": cva_merge_base_classes_as_array_1.cvaMergeBaseClassesAsArray,
     "no-internal-barrel-files": no_internal_barrel_files_1.noInternalBarrelFiles,
     "no-typescript-assertion": no_typescript_assertion_1.noTypescriptAssertion,
+    "no-deprecated-graphql-fields": no_deprecated_graphql_fields_1.noDeprecatedGraphqlFields,
     "no-internal-graphql-when-tagged-with-gql-public": no_internal_graphql_when_tagged_with_gql_public_1.noInternalGraphqlWhenTaggedWithGqlPublic,
     "design-guideline-button-icon-size-match": design_guideline_button_icon_size_match_1.designGuidelineButtonIconSizeMatch,
     "no-template-strings-in-classname-prop": no_template_strings_in_classname_prop_1.noTemplateStringsInClassName,