@blumintinc/eslint-plugin-blumint 1.20.20 → 1.20.21

package/lib/index.js

@@ -223,7 +223,7 @@ function noFrontendImportsFromFunctionsPatterns(pattern) {
 module.exports = {
     meta: {
         name: '@blumintinc/eslint-plugin-blumint',
-        version: '1.20.20',
+        version: '1.20.21',
     },
     parseOptions: {
         ecmaVersion: 2020,

package/lib/rules/enforce-querykey-ts.js

@@ -184,6 +184,19 @@ exports.enforceQueryKeyTs = (0, createRule_1.createRule)({
             }
             return 'bound';
         }
+        /**
+         * A parameter binding holds a different value on every call, so no single
+         * `QUERY_KEY_*` constant can stand in for it: a hook that iterates a
+         * constant array of keys hands each one to a callback parameter by design
+         * (#1393). Reporting such an identifier demands a substitution that does not
+         * exist, and the enclosing function is where the caller — not this file —
+         * decides which key is passed.
+         */
+        function isParameterBinding(identifier) {
+            const variable = utils_1.ASTUtils.findVariable(scopeOf(identifier), identifier);
+            const definition = variable?.defs[0];
+            return definition?.type === utils_1.TSESLint.Scope.DefinitionType.Parameter;
+        }
         function queryKeysDeclarationsOf() {
             return importDeclarationsOf().filter((declaration) => isQueryKeysSource(String(declaration.source.value)));
         }
@@ -494,7 +507,8 @@ exports.enforceQueryKeyTs = (0, createRule_1.createRule)({
                                                 : undefined,
                                         });
                                     }
-                                    else if (keyValue.type === utils_1.AST_NODE_TYPES.Identifier) {
+                                    else if (keyValue.type === utils_1.AST_NODE_TYPES.Identifier &&
+                                        !isParameterBinding(keyValue)) {
                                         // Report variables that aren't from the correct source
                                         pendingReports.push({
                                             node: keyValue,

package/lib/rules/prefer-global-router-state-key.js

@@ -121,6 +121,28 @@ exports.preferGlobalRouterStateKey = (0, createRule_1.createRule)({
         function isValidQueryKeyConstant(name) {
             return name.startsWith('QUERY_KEY_');
         }
+        /**
+         * `SourceCode#getScope` supersedes the deprecated `context.getScope`; the
+         * fallback keeps the rule working on ESLint versions that predate it.
+         */
+        function scopeOf(node) {
+            const scoped = sourceCode;
+            return typeof scoped.getScope === 'function'
+                ? scoped.getScope(node)
+                : context.getScope();
+        }
+        /**
+         * A parameter binding holds a different value on every call, so no single
+         * `QUERY_KEY_*` constant can stand in for it: a hook that iterates a
+         * constant array of keys hands each one to a callback parameter by design
+         * (#1394). Reporting such an identifier demands a substitution that does not
+         * exist, and the caller — not this file — decides which key is passed.
+         */
+        function isParameterBinding(identifier) {
+            const variable = utils_1.ASTUtils.findVariable(scopeOf(identifier), identifier);
+            const definition = variable?.defs[0];
+            return definition?.type === utils_1.TSESLint.Scope.DefinitionType.Parameter;
+        }
         /**
          * Check if a node represents a valid query key usage
          */
@@ -408,7 +430,8 @@ exports.preferGlobalRouterStateKey = (0, createRule_1.createRule)({
                                             },
                                         });
                                     }
-                                    else if (keyValue.type === utils_1.AST_NODE_TYPES.Identifier) {
+                                    else if (keyValue.type === utils_1.AST_NODE_TYPES.Identifier &&
+                                        !isParameterBinding(keyValue)) {
                                         context.report({
                                             node: keyValue,
                                             messageId: 'invalidQueryKeySource',

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@blumintinc/eslint-plugin-blumint",
-  "version": "1.20.20",
+  "version": "1.20.21",
   "description": "Custom eslint rules for use within BluMint",
   "author": {
     "name": "Brodie McGuire",

package/release-manifest.json

@@ -1,4 +1,26 @@
 [
+  {
+    "version": "1.20.21",
+    "date": "2026-07-29T23:50:58.620Z",
+    "rules": [
+      {
+        "name": "enforce-querykey-ts",
+        "changeType": "fix",
+        "issues": [
+          1393
+        ],
+        "summary": "exempt parameter bindings from the constant requirement (closes #1393)"
+      },
+      {
+        "name": "prefer-global-router-state-key",
+        "changeType": "fix",
+        "issues": [
+          1394
+        ],
+        "summary": "exempt parameter bindings from the constant requirement (closes #1394)"
+      }
+    ]
+  },
   {
     "version": "1.20.20",
     "date": "2026-07-29T19:25:11.467Z",