fix(ibm-major-version-in-path): skip path checks if there are no paths (#727)

* fix(ibm-major-version-in-path): skip path checks if there are no paths

This rule checks both the `servers` entries and the path strings in an API
definition. If an API definition contains no path strings in the `paths`
object, this rule would return a false positive. This adds logic to skip
the path string checks if there are none to check.

Signed-off-by: Dustin Popp <[email protected]>

Author: dpopp07

packages/ruleset/src/functions/index.js

@@ -1,5 +1,5 @@
 /**
- * Copyright 2017 - 2024 IBM Corporation.
+ * Copyright 2017 - 2025 IBM Corporation.
  * SPDX-License-Identifier: Apache2.0
  */
 
@@ -13,7 +13,6 @@ module.exports = {
   arrayResponses: require('./array-responses'),
   avoidMultipleTypes: require('./avoid-multiple-types'),
   binarySchemas: require('./binary-schemas'),
-  checkMajorVersion: require('./check-major-version'),
   circularRefs: require('./circular-refs'),
   collectionArrayProperty: require('./collection-array-property'),
   consecutivePathSegments: require('./consecutive-path-segments'),
@@ -26,6 +25,7 @@ module.exports = {
   etagHeaderExists: require('./etag-header-exists'),
   inlineSchemas: require('./inline-schemas'),
   integerAttributes: require('./integer-attributes'),
+  majorVersionInPath: require('./major-version-in-path'),
   mergePatchProperties: require('./merge-patch-properties'),
   noAmbiguousPaths: require('./no-ambiguous-paths'),
   noNullableProperties: require('./no-nullable-properties'),

…set/src/functions/check-major-version.js …t/src/functions/major-version-in-path.jspackages/ruleset/src/functions/check-major-version.js renamed to packages/ruleset/src/functions/major-version-in-path.js packages/ruleset/src/functions/check-major-version.js renamed to packages/ruleset/src/functions/major-version-in-path.js

@@ -1,5 +1,5 @@
 /**
- * Copyright 2017 - 2023 IBM Corporation.
+ * Copyright 2017 - 2025 IBM Corporation.
  * SPDX-License-Identifier: Apache2.0
  */
 
@@ -99,6 +99,13 @@ function checkMajorVersion(apiDef) {
   const paths = apiDef['paths'];
   if (paths && typeof paths === 'object') {
     const urls = Object.keys(paths);
+
+    if (!urls.length) {
+      logger.debug(`${ruleId}: no path strings to check - "paths" is empty`);
+
+      return [];
+    }
+
     const versions = urls.map(url => getVersion(url));
 
     if (versions.length > 1 && !versions.every(v => v === versions[0])) {

packages/ruleset/src/rules/major-version-in-path.js

@@ -1,10 +1,10 @@
 /**
- * Copyright 2017 - 2023 IBM Corporation.
+ * Copyright 2017 - 2025 IBM Corporation.
  * SPDX-License-Identifier: Apache2.0
  */
 
 const { oas3 } = require('@stoplight/spectral-formats');
-const { checkMajorVersion } = require('../functions');
+const { majorVersionInPath } = require('../functions');
 
 module.exports = {
   description:
@@ -14,6 +14,6 @@ module.exports = {
   given: '$',
   severity: 'warn',
   then: {
-    function: checkMajorVersion,
+    function: majorVersionInPath,
   },
 };

packages/ruleset/test/rules/major-version-in-path.test.js

@@ -1,5 +1,5 @@
 /**
- * Copyright 2017 - 2024 IBM Corporation.
+ * Copyright 2017 - 2025 IBM Corporation.
  * SPDX-License-Identifier: Apache2.0
  */
 
@@ -66,6 +66,15 @@ describe(`Spectral rule: ${ruleId}`, () => {
     expect(results).toHaveLength(0);
   });
 
+  it('should not error when there are no paths', async () => {
+    const testDocument = makeCopy(rootDocument);
+    testDocument.paths = {};
+
+    const results = await testRule(ruleId, rule, testDocument);
+
+    expect(results).toHaveLength(0);
+  });
+
   it('should error when servers have urls with different versions', async () => {
     const testDocument = makeCopy(rootDocument);
     testDocument.servers = [