@sarj/eslint-plugin 15.28.0 → 15.28.1

package/dist/index.cjs

@@ -20078,7 +20078,7 @@ var REQUIRE_FETCH_TIMEOUT_DOCUMENTATION = {
   rationale: "An unbounded request can occupy work indefinitely when an upstream stalls.",
   remediation: "Pass an abort signal, such as `AbortSignal.timeout(ms)`, in the fetch init.",
   category: "correctness",
-  limitations: ["Signal presence establishes an explicit cancellation path, not a guaranteed timeout. Forwarded Request objects can carry an existing signal."],
+  limitations: ["Signal presence establishes an explicit cancellation path, not a guaranteed timeout. Literal null, global undefined, and void 0 do not provide a signal. Unknown spreads and dynamic values are not inferred. Forwarded Request objects can carry an existing signal."],
   examples: [
     { id: "bounded-fetch", title: "Bound the request", outcome: "no-match", files: [{ path: "src/client.ts", source: "await fetch(url, { signal: AbortSignal.timeout(5000) });" }], focusPath: "src/client.ts", expectedCount: 0, public: true },
     { id: "unbounded-fetch", title: "Do not leave fetch unbounded", outcome: "match", files: [{ path: "src/client.ts", source: "await fetch('https://api.example.com/items');" }], focusPath: "src/client.ts", expectedCount: 1, public: true }
@@ -20098,22 +20098,23 @@ function matchesAnyPattern3(filename, patterns) {
   }
   return false;
 }
-function initProvablyLacksSignal(init) {
-  if (init.type !== import_utils110.AST_NODE_TYPES.ObjectExpression) {
-    return false;
-  }
+function initProvablyLacksSignal(init, resolvesToGlobal) {
+  if (init.type !== import_utils110.AST_NODE_TYPES.ObjectExpression) return false;
+  let lacksSignal = true;
   for (const prop of init.properties) {
     if (prop.type === import_utils110.AST_NODE_TYPES.SpreadElement) {
-      return false;
-    }
-    if (prop.key.type === import_utils110.AST_NODE_TYPES.Identifier && prop.key.name === "signal" || prop.key.type === import_utils110.AST_NODE_TYPES.Literal && prop.key.value === "signal") {
-      return false;
+      lacksSignal = false;
+      continue;
     }
-    if (prop.computed) {
-      return false;
+    const isSignal = !prop.computed && prop.key.type === import_utils110.AST_NODE_TYPES.Identifier && prop.key.name === "signal" || prop.key.type === import_utils110.AST_NODE_TYPES.Literal && prop.key.value === "signal";
+    if (isSignal) {
+      const value = prop.value;
+      lacksSignal = prop.kind === "init" && !prop.method && (value.type === import_utils110.AST_NODE_TYPES.Literal && value.value === null || value.type === import_utils110.AST_NODE_TYPES.Identifier && value.name === "undefined" && resolvesToGlobal(value) || value.type === import_utils110.AST_NODE_TYPES.UnaryExpression && value.operator === "void" && value.argument.type === import_utils110.AST_NODE_TYPES.Literal && value.argument.value === 0);
+    } else if (prop.computed && prop.key.type !== import_utils110.AST_NODE_TYPES.Literal) {
+      lacksSignal = false;
     }
   }
-  return true;
+  return lacksSignal;
 }
 function isInlineUrl(node, resolvesToGlobal) {
   return node.type === import_utils110.AST_NODE_TYPES.Literal && typeof node.value === "string" || node.type === import_utils110.AST_NODE_TYPES.TemplateLiteral || node.type === import_utils110.AST_NODE_TYPES.NewExpression && node.callee.type === import_utils110.AST_NODE_TYPES.Identifier && node.callee.name === "URL" && resolvesToGlobal(node.callee);
@@ -20170,7 +20171,7 @@ var require_fetch_timeout_default = createRule({
       );
       if (variable?.defs.length !== 1) return false;
       const definition = variable.defs[0];
-      if (definition?.type !== "Variable" || definition.parent.kind !== "const" || definition.node.init?.type !== import_utils110.AST_NODE_TYPES.ObjectExpression || !initProvablyLacksSignal(definition.node.init)) {
+      if (definition?.type !== "Variable" || definition.parent.kind !== "const" || definition.node.init?.type !== import_utils110.AST_NODE_TYPES.ObjectExpression || !initProvablyLacksSignal(definition.node.init, resolvesToGlobal)) {
         return false;
       }
       for (const reference of variable.references) {
@@ -20202,7 +20203,7 @@ var require_fetch_timeout_default = createRule({
         if (first !== void 0 && (node.arguments.length === 1 && !isInlineUrl(first, resolvesToGlobal) || isForwardedRequest(first))) {
           return;
         }
-        if (init === void 0 || initProvablyLacksSignal(init) || init.type === import_utils110.AST_NODE_TYPES.Identifier && localConstInitProvablyLacksSignal(init)) {
+        if (init === void 0 || initProvablyLacksSignal(init, resolvesToGlobal) || init.type === import_utils110.AST_NODE_TYPES.Identifier && localConstInitProvablyLacksSignal(init)) {
           context.report({ node, messageId: "missingSignal" });
         }
       }
@@ -23354,7 +23355,7 @@ var RULES = {
 };
 var meta = {
   name: "@sarj/eslint-plugin",
-  version: "15.28.0"
+  version: "15.28.1"
 };
 var APPLICATION_ONLY_RULES = [];
 var LIBRARY_IMPORT_POLICY = ["error", {

package/dist/index.d.cts

@@ -916,7 +916,7 @@ type FlatPreset = {
 declare const PLUGIN: {
     readonly meta: {
         readonly name: "@sarj/eslint-plugin";
-        readonly version: "15.28.0";
+        readonly version: "15.28.1";
     };
     readonly rules: {
         readonly "no-conditional-empty-object-spread": DocumentedRule<[], "avoid">;

package/dist/index.d.ts

@@ -916,7 +916,7 @@ type FlatPreset = {
 declare const PLUGIN: {
     readonly meta: {
         readonly name: "@sarj/eslint-plugin";
-        readonly version: "15.28.0";
+        readonly version: "15.28.1";
     };
     readonly rules: {
         readonly "no-conditional-empty-object-spread": DocumentedRule<[], "avoid">;

package/dist/index.js

@@ -20093,7 +20093,7 @@ var REQUIRE_FETCH_TIMEOUT_DOCUMENTATION = {
   rationale: "An unbounded request can occupy work indefinitely when an upstream stalls.",
   remediation: "Pass an abort signal, such as `AbortSignal.timeout(ms)`, in the fetch init.",
   category: "correctness",
-  limitations: ["Signal presence establishes an explicit cancellation path, not a guaranteed timeout. Forwarded Request objects can carry an existing signal."],
+  limitations: ["Signal presence establishes an explicit cancellation path, not a guaranteed timeout. Literal null, global undefined, and void 0 do not provide a signal. Unknown spreads and dynamic values are not inferred. Forwarded Request objects can carry an existing signal."],
   examples: [
     { id: "bounded-fetch", title: "Bound the request", outcome: "no-match", files: [{ path: "src/client.ts", source: "await fetch(url, { signal: AbortSignal.timeout(5000) });" }], focusPath: "src/client.ts", expectedCount: 0, public: true },
     { id: "unbounded-fetch", title: "Do not leave fetch unbounded", outcome: "match", files: [{ path: "src/client.ts", source: "await fetch('https://api.example.com/items');" }], focusPath: "src/client.ts", expectedCount: 1, public: true }
@@ -20113,22 +20113,23 @@ function matchesAnyPattern3(filename, patterns) {
   }
   return false;
 }
-function initProvablyLacksSignal(init) {
-  if (init.type !== AST_NODE_TYPES93.ObjectExpression) {
-    return false;
-  }
+function initProvablyLacksSignal(init, resolvesToGlobal) {
+  if (init.type !== AST_NODE_TYPES93.ObjectExpression) return false;
+  let lacksSignal = true;
   for (const prop of init.properties) {
     if (prop.type === AST_NODE_TYPES93.SpreadElement) {
-      return false;
-    }
-    if (prop.key.type === AST_NODE_TYPES93.Identifier && prop.key.name === "signal" || prop.key.type === AST_NODE_TYPES93.Literal && prop.key.value === "signal") {
-      return false;
+      lacksSignal = false;
+      continue;
     }
-    if (prop.computed) {
-      return false;
+    const isSignal = !prop.computed && prop.key.type === AST_NODE_TYPES93.Identifier && prop.key.name === "signal" || prop.key.type === AST_NODE_TYPES93.Literal && prop.key.value === "signal";
+    if (isSignal) {
+      const value = prop.value;
+      lacksSignal = prop.kind === "init" && !prop.method && (value.type === AST_NODE_TYPES93.Literal && value.value === null || value.type === AST_NODE_TYPES93.Identifier && value.name === "undefined" && resolvesToGlobal(value) || value.type === AST_NODE_TYPES93.UnaryExpression && value.operator === "void" && value.argument.type === AST_NODE_TYPES93.Literal && value.argument.value === 0);
+    } else if (prop.computed && prop.key.type !== AST_NODE_TYPES93.Literal) {
+      lacksSignal = false;
     }
   }
-  return true;
+  return lacksSignal;
 }
 function isInlineUrl(node, resolvesToGlobal) {
   return node.type === AST_NODE_TYPES93.Literal && typeof node.value === "string" || node.type === AST_NODE_TYPES93.TemplateLiteral || node.type === AST_NODE_TYPES93.NewExpression && node.callee.type === AST_NODE_TYPES93.Identifier && node.callee.name === "URL" && resolvesToGlobal(node.callee);
@@ -20185,7 +20186,7 @@ var require_fetch_timeout_default = createRule({
       );
       if (variable?.defs.length !== 1) return false;
       const definition = variable.defs[0];
-      if (definition?.type !== "Variable" || definition.parent.kind !== "const" || definition.node.init?.type !== AST_NODE_TYPES93.ObjectExpression || !initProvablyLacksSignal(definition.node.init)) {
+      if (definition?.type !== "Variable" || definition.parent.kind !== "const" || definition.node.init?.type !== AST_NODE_TYPES93.ObjectExpression || !initProvablyLacksSignal(definition.node.init, resolvesToGlobal)) {
         return false;
       }
       for (const reference of variable.references) {
@@ -20217,7 +20218,7 @@ var require_fetch_timeout_default = createRule({
         if (first !== void 0 && (node.arguments.length === 1 && !isInlineUrl(first, resolvesToGlobal) || isForwardedRequest(first))) {
           return;
         }
-        if (init === void 0 || initProvablyLacksSignal(init) || init.type === AST_NODE_TYPES93.Identifier && localConstInitProvablyLacksSignal(init)) {
+        if (init === void 0 || initProvablyLacksSignal(init, resolvesToGlobal) || init.type === AST_NODE_TYPES93.Identifier && localConstInitProvablyLacksSignal(init)) {
           context.report({ node, messageId: "missingSignal" });
         }
       }
@@ -23375,7 +23376,7 @@ var RULES = {
 };
 var meta = {
   name: "@sarj/eslint-plugin",
-  version: "15.28.0"
+  version: "15.28.1"
 };
 var APPLICATION_ONLY_RULES = [];
 var LIBRARY_IMPORT_POLICY = ["error", {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@sarj/eslint-plugin",
-  "version": "15.28.0",
+  "version": "15.28.1",
   "packageManager": "npm@12.1.0",
   "description": "Custom ESLint rules for hypermodern TypeScript / React / Next.js projects",
   "type": "module",