@bigbinary/eslint-plugin-neeto 1.7.5 → 1.7.6

package/dist/index.js

@@ -330,7 +330,7 @@
   }
 
   var name = "@bigbinary/eslint-plugin-neeto";
-  var version = "1.7.4";
+  var version = "1.7.5";
   var main = "dist/index.js";
   var license = "UNLICENSED";
   var scripts = {
@@ -726,8 +726,23 @@
   var helpUrlConstantNamingConvention = function helpUrlConstantNamingConvention(filename) {
     return "All exported constants in ".concat(filename, " must follow the HELP_..._URL naming convention.");
   };
+  var baseUrlShouldBeInStandardFormat = function baseUrlShouldBeInStandardFormat(filename) {
+    return "All exported base URLS in ".concat(filename, " must be in the standard format help.neeto<product>.com.");
+  };
   var helpUrlInvalidType = function helpUrlInvalidType(filename) {
-    return "Help URL constant must be a template literal string or assigned from another help URL constant. Objects and other types are not allowed in ".concat(filename, ".");
+    return "Help URL constant must be a template literal string, assigned from another help URL constant or a help base URL. Objects and other types are not allowed in ".concat(filename, ".");
+  };
+  var helpUrlOtherNeetoProductConstantNamingConvention = function helpUrlOtherNeetoProductConstantNamingConvention(_ref2) {
+    var filename = _ref2.filename,
+      constantName = _ref2.constantName,
+      suggestedConstantName = _ref2.suggestedConstantName;
+    return "All constants that export help URLs for other neeto products in ".concat(filename, " must follow the HELP_NEETO..._BASE_URL naming convention. Replace '").concat(constantName, "' with '").concat(suggestedConstantName, "'.");
+  };
+  var helpUrlOtherNeetoProductConstantShouldMatchHelpUrl = function helpUrlOtherNeetoProductConstantShouldMatchHelpUrl(_ref3) {
+    var filename = _ref3.filename,
+      constantName = _ref3.constantName,
+      suggestedConstantName = _ref3.suggestedConstantName;
+    return "All constants that export help URLs for other neeto products in ".concat(filename, " must match the help URL. Replace '").concat(constantName, "' with '").concat(suggestedConstantName, "'.");
   };
   var danglingHelpUrlConstant = function danglingHelpUrlConstant(constName, filename) {
     return "Help URL constant '".concat(constName, "' should be defined in '").concat(filename, "'.");
@@ -10592,26 +10607,37 @@
       return HELP_URL_CONSTANT_PATTERN.test(_name2);
     }
   };
+  var VALID_HELP_URL_BASE_PATTERN = {
+    type: TYPES.LITERAL,
+    value: function value(_value) {
+      return typeof _value === "string" && HELP_URL_BASE_REGEX.test(_value);
+    }
+  };
   var HELP_URLS_FILENAME = "helpUrls.js";
   var HELP_URL_CONSTANT_PATTERN = /^HELP_.*_URL$/;
   var HELP_DOCS_BASE_URL_CONSTANT_NAME = "HELP_DOCS_BASE_URL";
   var ARTICLE_LINK_REGEX = /\/articles\//;
   // Regex matches help.neeto<subdomain>.com
-  var HELP_URL_BASE_REGEX = /help\.neeto[a-z]+\.com/;
+  var HELP_URL_BASE_REGEX = /help\.(neeto[a-z]+)\.com/;
   // Regex for the old/incorrect format: neeto<product>help.neetokb.com
   var OLD_HELP_URL_BASE_REGEX = /neeto[a-z]+help\.neetokb\.com/;
+  // Regex matches HELP_NEETO..._BASE_URL
+  var HELP_URL_OTHER_NEETO_PRODUCT_CONSTANT_REGEX = /^HELP_NEETO.*_BASE_URL$/;
+  var HELP_URL_OTHER_NEETO_PRODUCT_CONSTANT_NAME_TEMPLATE = function HELP_URL_OTHER_NEETO_PRODUCT_CONSTANT_NAME_TEMPLATE(neetoProductName) {
+    return "HELP_".concat(neetoProductName, "_BASE_URL");
+  };
   var BASE_URL_DECLARATOR_PATTERN = {
     id: {
       name: HELP_DOCS_BASE_URL_CONSTANT_NAME
     },
     init: {
       type: TYPES.LITERAL,
-      value: function value(_value) {
-        return typeof _value === "string";
+      value: function value(_value2) {
+        return typeof _value2 === "string";
       }
     }
   };
-  var VALID_HELP_URL_INIT_PATTERN = matchesAny([VALID_TEMPLATE_LITERAL_INIT_PATTERN, VALID_IDENTIFIER_INIT_PATTERN]);
+  var VALID_HELP_URL_INIT_PATTERN = matchesAny([VALID_TEMPLATE_LITERAL_INIT_PATTERN, VALID_IDENTIFIER_INIT_PATTERN, VALID_HELP_URL_BASE_PATTERN]);
   var DANGLING_HELP_URL_DECLARATOR_PATTERN = {
     type: TYPES.VARIABLE_DECLARATOR,
     id: {
@@ -10625,6 +10651,19 @@
     }
   };
 
+  var getNeetoProductNameFromHelpUrl = function getNeetoProductNameFromHelpUrl(helpUrl) {
+    var match = helpUrl.match(HELP_URL_BASE_REGEX);
+    return match ? match[1].toUpperCase() : null;
+  };
+  var getSuggestedHelpUrlOtherNeetoProductConstantName = function getSuggestedHelpUrlOtherNeetoProductConstantName(helpUrl) {
+    var neetoProductName = getNeetoProductNameFromHelpUrl(helpUrl);
+    return HELP_URL_OTHER_NEETO_PRODUCT_CONSTANT_NAME_TEMPLATE(neetoProductName);
+  };
+  var checkIfConstantNameMatchesHelpUrl = function checkIfConstantNameMatchesHelpUrl(constantName, helpUrl) {
+    var neetoProductName = getNeetoProductNameFromHelpUrl(helpUrl);
+    return constantName === HELP_URL_OTHER_NEETO_PRODUCT_CONSTANT_NAME_TEMPLATE(neetoProductName);
+  };
+
   function _createForOfIteratorHelper$1(o, allowArrayLike) { var it = typeof Symbol !== "undefined" && o[Symbol.iterator] || o["@@iterator"]; if (!it) { if (Array.isArray(o) || (it = _unsupportedIterableToArray$1(o)) || allowArrayLike) { if (it) o = it; var i = 0; var F = function F() {}; return { s: F, n: function n() { if (i >= o.length) return { done: true }; return { done: false, value: o[i++] }; }, e: function e(_e) { throw _e; }, f: F }; } throw new TypeError("Invalid attempt to iterate non-iterable instance.\nIn order to be iterable, non-array objects must have a [Symbol.iterator]() method."); } var normalCompletion = true, didErr = false, err; return { s: function s() { it = it.call(o); }, n: function n() { var step = it.next(); normalCompletion = step.done; return step; }, e: function e(_e2) { didErr = true; err = _e2; }, f: function f() { try { if (!normalCompletion && it["return"] != null) it["return"](); } finally { if (didErr) throw err; } } }; }
   function _unsupportedIterableToArray$1(o, minLen) { if (!o) return; if (typeof o === "string") return _arrayLikeToArray$1(o, minLen); var n = Object.prototype.toString.call(o).slice(8, -1); if (n === "Object" && o.constructor) n = o.constructor.name; if (n === "Map" || n === "Set") return Array.from(o); if (n === "Arguments" || /^(?:Ui|I)nt(?:8|16|32)(?:Clamped)?Array$/.test(n)) return _arrayLikeToArray$1(o, minLen); }
   function _arrayLikeToArray$1(arr, len) { if (len == null || len > arr.length) len = arr.length; for (var i = 0, arr2 = new Array(len); i < len; i++) arr2[i] = arr[i]; return arr2; }
@@ -10661,9 +10700,68 @@
       });
       return false;
     }
+    if (!neetoCist.matches(VALID_HELP_URL_BASE_PATTERN, declarator.init)) {
+      context.report({
+        node: declarator,
+        message: baseUrlShouldBeInStandardFormat(HELP_URLS_FILENAME)
+      });
+      return false;
+    }
     return true;
   };
 
+  /**
+   * Validates a base help URL constant declaration for other neeto products inside helpUrls.js.
+   * e.g., `export const HELP_NEETOCHAT_BASE_URL = "https://help.neetochat.com";`
+   */
+  var validateOtherNeetoProductConstant = function validateOtherNeetoProductConstant(context, declarator) {
+    var constantName = declarator.id.name;
+    var init = declarator.init;
+
+    // Check 1: Checks that the constant name follows the naming convention (HELP_NEETO..._BASE_URL)
+    if (!HELP_URL_OTHER_NEETO_PRODUCT_CONSTANT_REGEX.test(constantName)) {
+      var suggestedConstantName = getSuggestedHelpUrlOtherNeetoProductConstantName(init.value);
+      context.report({
+        node: declarator,
+        message: helpUrlOtherNeetoProductConstantNamingConvention({
+          filename: HELP_URLS_FILENAME,
+          constantName: constantName,
+          suggestedConstantName: suggestedConstantName
+        }),
+        fix: function fix(fixer) {
+          return fixer.replaceText(declarator.id, suggestedConstantName);
+        }
+      });
+      return;
+    }
+
+    //Check 2: If the constant name matches the help URL, check that the help URL is in the correct format.
+    if (OLD_HELP_URL_BASE_REGEX.test(init.value)) {
+      context.report({
+        node: declarator,
+        message: HELP_URL_INCORRECT_FORMAT
+      });
+      return;
+    }
+
+    // Check 3: Checks that the constant name matches the help URL
+    if (!checkIfConstantNameMatchesHelpUrl(constantName, init.value)) {
+      var _suggestedConstantName = getSuggestedHelpUrlOtherNeetoProductConstantName(init.value);
+      context.report({
+        node: declarator,
+        message: helpUrlOtherNeetoProductConstantShouldMatchHelpUrl({
+          filename: HELP_URLS_FILENAME,
+          constantName: constantName,
+          suggestedConstantName: _suggestedConstantName
+        }),
+        fix: function fix(fixer) {
+          return fixer.replaceText(declarator.id, _suggestedConstantName);
+        }
+      });
+      return;
+    }
+  };
+
   /**
    * Validates a single help URL constant declaration inside helpUrls.js.
    * e.g., `export const HELP_API_KEYS_URL = \`\${HELP_DOCS_BASE_URL}/p/a-d7e4285a\`;`
@@ -10681,7 +10779,7 @@
     }
     var init = declarator.init;
 
-    // Check 2: Must be a valid template literal or identifier assignment.
+    // Check 2: Must be a valid template literal, identifier assignment or help URL base.
     if (!neetoCist.matches(VALID_HELP_URL_INIT_PATTERN, init)) {
       context.report({
         node: declarator,
@@ -10698,8 +10796,14 @@
           node: declarator,
           message: HELP_URL_SHOULD_USE_PERMALINK
         });
+        return;
       }
     }
+
+    //Check 4: If it's a help URL base for other neeto products, validate the constant name.
+    if (init.type === TYPES.LITERAL) {
+      validateOtherNeetoProductConstant(context, declarator);
+    }
   };
 
   /**
@@ -10807,7 +10911,7 @@
         url: "https://github.com/bigbinary/eslint-plugin-neeto/blob/main/docs/src/rules/standardize-help-urls.md",
         description: "Ensure help URLs are standardized and defined in helpUrls.js"
       },
-      fixable: null
+      fixable: "code"
     },
     create: function create(context) {
       var filename = context.getFilename();

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@bigbinary/eslint-plugin-neeto",
-  "version": "1.7.5",
+  "version": "1.7.6",
   "main": "dist/index.js",
   "license": "UNLICENSED",
   "scripts": {