@atlaskit/eslint-plugin-platform 0.1.0 → 0.1.2

package/CHANGELOG.md

@@ -1,5 +1,17 @@
 # @atlaskit/eslint-plugin-platform
 
+## 0.1.2
+
+### Patch Changes
+
+- [`166815fbd8f`](https://bitbucket.org/atlassian/atlassian-frontend/commits/166815fbd8f) - Add recommended set of flags for use in products
+
+## 0.1.1
+
+### Patch Changes
+
+- [`7edd9e8b4b1`](https://bitbucket.org/atlassian/atlassian-frontend/commits/7edd9e8b4b1) - Add suggestion to change feature flag to the closest matching feature flag using fuzzy search
+
 ## 0.1.0
 
 ### Minor Changes

package/dist/cjs/index.js

@@ -19,6 +19,14 @@ var rules = {
 };
 exports.rules = rules;
 var configs = {
+  productRecommended: {
+    plugins: ['@atlaskit/platform'],
+    rules: {
+      '@atlaskit/platform/ensure-test-runner-arguments': 'error',
+      '@atlaskit/platform/ensure-test-runner-nested-count': 'warn',
+      '@atlaskit/platform/no-invalid-feature-flag-usage': 'error'
+    }
+  },
   recommended: {
     plugins: ['@atlaskit/platform'],
     rules: {

package/dist/cjs/rules/ensure-feature-flag-registration/index.js

@@ -5,21 +5,29 @@ Object.defineProperty(exports, "__esModule", {
   value: true
 });
 exports.default = void 0;
+var _defineProperty2 = _interopRequireDefault(require("@babel/runtime/helpers/defineProperty"));
 var _toConsumableArray2 = _interopRequireDefault(require("@babel/runtime/helpers/toConsumableArray"));
 var _readPkgUp = _interopRequireDefault(require("read-pkg-up"));
 var _path = _interopRequireDefault(require("path"));
+var _fuse = _interopRequireDefault(require("fuse.js"));
+function ownKeys(object, enumerableOnly) { var keys = Object.keys(object); if (Object.getOwnPropertySymbols) { var symbols = Object.getOwnPropertySymbols(object); enumerableOnly && (symbols = symbols.filter(function (sym) { return Object.getOwnPropertyDescriptor(object, sym).enumerable; })), keys.push.apply(keys, symbols); } return keys; }
+function _objectSpread(target) { for (var i = 1; i < arguments.length; i++) { var source = null != arguments[i] ? arguments[i] : {}; i % 2 ? ownKeys(Object(source), !0).forEach(function (key) { (0, _defineProperty2.default)(target, key, source[key]); }) : Object.getOwnPropertyDescriptors ? Object.defineProperties(target, Object.getOwnPropertyDescriptors(source)) : ownKeys(Object(source)).forEach(function (key) { Object.defineProperty(target, key, Object.getOwnPropertyDescriptor(source, key)); }); } return target; }
+// defines a "getter" to "type" map, if more types are required for feature flags (like string) add it here!
+var getterIdentifierToFlagTypeMap = {
+  getBooleanFF: 'boolean'
+};
 // make sure we cache reading the package.json so we don't end up reading it for every instance of this rule.
 var pkgJsonCache = new Map();
 
 // get the ancestor package.json for a given file
-var getPackageJsonForFileName = function getPackageJsonForFileName(filename) {
+var getMetadataForFilename = function getMetadataForFilename(filename) {
   var splitFilename = filename.split(_path.default.sep);
   for (var i = 0; i < splitFilename.length; i++) {
     // attempt to search using the filename in the cache to see if we've read the package.json for a sibling file before
     var searchPath = _path.default.join.apply(_path.default, (0, _toConsumableArray2.default)(splitFilename.splice(0, i)));
-    var cachedPkgJson = pkgJsonCache.get(searchPath);
-    if (cachedPkgJson) {
-      return cachedPkgJson;
+    var cachedMetaData = pkgJsonCache.get(searchPath);
+    if (cachedMetaData) {
+      return cachedMetaData;
     }
   }
   var _ref = _readPkgUp.default.sync({
@@ -28,29 +36,38 @@ var getPackageJsonForFileName = function getPackageJsonForFileName(filename) {
     }),
     packageJson = _ref.packageJson,
     pkgJsonPath = _ref.path;
-  pkgJsonCache.set(pkgJsonPath, packageJson);
-  return packageJson;
+  var pkgJson = packageJson;
+  var fuse = packageJson['platform-feature-flags'] == null ? null : new _fuse.default(Object.keys(pkgJson['platform-feature-flags']));
+  var metaData = {
+    pkgJson: pkgJson,
+    fuse: fuse
+  };
+  pkgJsonCache.set(pkgJsonPath, metaData);
+  return metaData;
 };
 var rule = {
   meta: {
-    hasSuggestions: false,
     docs: {
       recommended: false
     },
     type: 'problem',
     messages: {
       registrationSectionMissing: 'Please add a "platform-feature-flags" section to your package.json! See http://go/pff-eslint for more details',
-      featureFlagMissing: "Please add a \"{{ featureFlag }}\" section to the \"platform-feature-flags\" section in your package.json. See http://go/pff-eslint for more details"
-    }
+      featureFlagMissing: "Please add a \"{{ featureFlag }}\" section to the \"platform-feature-flags\" section in your package.json. See http://go/pff-eslint for more details",
+      changeFeatureFlag: "Change flag key to \"{{ closestFlag }}\" already defined in package.json"
+    },
+    hasSuggestions: true
   },
   create: function create(context) {
-    return {
-      'CallExpression[callee.name=/getBooleanFF/]': function CallExpressionCalleeNameGetBooleanFF(node) {
+    return Object.fromEntries(Object.keys(getterIdentifierToFlagTypeMap).map(function (getterIdentifier) {
+      return ["CallExpression[callee.name=/".concat(getterIdentifier, "/]"), function (node) {
         // to make typescript happy
         if (node.type === 'CallExpression') {
           var args = node.arguments;
           var filename = context.getFilename();
-          var packageJson = getPackageJsonForFileName(filename);
+          var _getMetadataForFilena = getMetadataForFilename(filename),
+            packageJson = _getMetadataForFilena.pkgJson,
+            fuse = _getMetadataForFilena.fuse;
           var platformFeatureFlags = packageJson['platform-feature-flags'];
           if (!platformFeatureFlags) {
             return context.report({
@@ -62,19 +79,38 @@ var rule = {
             var featureFlag = args[0].value;
             var featureFlagRegistration = platformFeatureFlags[featureFlag];
             if (!featureFlagRegistration) {
-              return context.report({
-                node: node,
+              // find the closest match in existing section for suggestion text
+              var closestMatchFix = null;
+              if (fuse) {
+                var closestFlagMatches = fuse.search(featureFlag);
+                if (closestFlagMatches.length > 0) {
+                  var closestFlag = closestFlagMatches[0].item;
+                  closestMatchFix = {
+                    messageId: 'changeFeatureFlag',
+                    data: {
+                      closestFlag: closestFlag
+                    },
+                    fix: function fix(fixer) {
+                      return fixer.replaceText(node.arguments[0], "'".concat(closestFlag, "'"));
+                    }
+                  };
+                }
+              }
+              return context.report(_objectSpread({
+                node: args[0],
                 messageId: 'featureFlagMissing',
                 data: {
                   featureFlag: featureFlag
                 }
-              });
+              }, closestMatchFix != null ? {
+                suggest: [closestMatchFix]
+              } : {}));
             }
           }
         }
         return {};
-      }
-    };
+      }];
+    }));
   }
 };
 var _default = rule;

package/dist/cjs/version.json

@@ -1,5 +1,5 @@
 {
 	"name": "@atlaskit/eslint-plugin-platform",
-	"version": "0.1.0",
+	"version": "0.1.2",
 	"sideEffects": false
 }

package/dist/es2019/index.js

@@ -11,6 +11,14 @@ export const rules = {
   'no-pre-post-install-scripts': noPreAndPostInstallScripts
 };
 export const configs = {
+  productRecommended: {
+    plugins: ['@atlaskit/platform'],
+    rules: {
+      '@atlaskit/platform/ensure-test-runner-arguments': 'error',
+      '@atlaskit/platform/ensure-test-runner-nested-count': 'warn',
+      '@atlaskit/platform/no-invalid-feature-flag-usage': 'error'
+    }
+  },
   recommended: {
     plugins: ['@atlaskit/platform'],
     rules: {

package/dist/es2019/rules/ensure-feature-flag-registration/index.js

@@ -1,17 +1,23 @@
 import readPkgUp from 'read-pkg-up';
 import path from 'path';
+import Fuse from 'fuse.js';
+
+// defines a "getter" to "type" map, if more types are required for feature flags (like string) add it here!
+const getterIdentifierToFlagTypeMap = {
+  getBooleanFF: 'boolean'
+};
 // make sure we cache reading the package.json so we don't end up reading it for every instance of this rule.
 const pkgJsonCache = new Map();
 
 // get the ancestor package.json for a given file
-const getPackageJsonForFileName = filename => {
+const getMetadataForFilename = filename => {
   const splitFilename = filename.split(path.sep);
   for (let i = 0; i < splitFilename.length; i++) {
     // attempt to search using the filename in the cache to see if we've read the package.json for a sibling file before
     const searchPath = path.join(...splitFilename.splice(0, i));
-    const cachedPkgJson = pkgJsonCache.get(searchPath);
-    if (cachedPkgJson) {
-      return cachedPkgJson;
+    const cachedMetaData = pkgJsonCache.get(searchPath);
+    if (cachedMetaData) {
+      return cachedMetaData;
     }
   }
   const {
@@ -21,53 +27,82 @@ const getPackageJsonForFileName = filename => {
     cwd: filename,
     normalize: false
   });
-  pkgJsonCache.set(pkgJsonPath, packageJson);
-  return packageJson;
+  const pkgJson = packageJson;
+  const fuse = packageJson['platform-feature-flags'] == null ? null : new Fuse(Object.keys(pkgJson['platform-feature-flags']));
+  const metaData = {
+    pkgJson,
+    fuse
+  };
+  pkgJsonCache.set(pkgJsonPath, metaData);
+  return metaData;
 };
 const rule = {
   meta: {
-    hasSuggestions: false,
     docs: {
       recommended: false
     },
     type: 'problem',
     messages: {
       registrationSectionMissing: 'Please add a "platform-feature-flags" section to your package.json! See http://go/pff-eslint for more details',
-      featureFlagMissing: `Please add a "{{ featureFlag }}" section to the "platform-feature-flags" section in your package.json. See http://go/pff-eslint for more details`
-    }
+      featureFlagMissing: `Please add a "{{ featureFlag }}" section to the "platform-feature-flags" section in your package.json. See http://go/pff-eslint for more details`,
+      changeFeatureFlag: `Change flag key to "{{ closestFlag }}" already defined in package.json`
+    },
+    hasSuggestions: true
   },
   create(context) {
-    return {
-      'CallExpression[callee.name=/getBooleanFF/]': node => {
-        // to make typescript happy
-        if (node.type === 'CallExpression') {
-          const args = node.arguments;
-          const filename = context.getFilename();
-          const packageJson = getPackageJsonForFileName(filename);
-          const platformFeatureFlags = packageJson['platform-feature-flags'];
-          if (!platformFeatureFlags) {
+    return Object.fromEntries(Object.keys(getterIdentifierToFlagTypeMap).map(getterIdentifier => [`CallExpression[callee.name=/${getterIdentifier}/]`, node => {
+      // to make typescript happy
+      if (node.type === 'CallExpression') {
+        const args = node.arguments;
+        const filename = context.getFilename();
+        const {
+          pkgJson: packageJson,
+          fuse
+        } = getMetadataForFilename(filename);
+        const platformFeatureFlags = packageJson['platform-feature-flags'];
+        if (!platformFeatureFlags) {
+          return context.report({
+            node: node,
+            messageId: 'registrationSectionMissing'
+          });
+        }
+        if (args.length === 1 && args[0].type === 'Literal' && args[0].raw) {
+          const featureFlag = args[0].value;
+          const featureFlagRegistration = platformFeatureFlags[featureFlag];
+          if (!featureFlagRegistration) {
+            // find the closest match in existing section for suggestion text
+            let closestMatchFix = null;
+            if (fuse) {
+              const closestFlagMatches = fuse.search(featureFlag);
+              if (closestFlagMatches.length > 0) {
+                const closestFlag = closestFlagMatches[0].item;
+                closestMatchFix = {
+                  messageId: 'changeFeatureFlag',
+                  data: {
+                    closestFlag
+                  },
+                  fix: fixer => {
+                    return fixer.replaceText(node.arguments[0], `'${closestFlag}'`);
+                  }
+                };
+              }
+            }
             return context.report({
-              node,
-              messageId: 'registrationSectionMissing'
+              node: args[0],
+              messageId: 'featureFlagMissing',
+              data: {
+                featureFlag
+              },
+              // only suggest if we have a close flag to match
+              ...(closestMatchFix != null ? {
+                suggest: [closestMatchFix]
+              } : {})
             });
           }
-          if (args.length === 1 && args[0].type === 'Literal' && args[0].raw) {
-            const featureFlag = args[0].value;
-            const featureFlagRegistration = platformFeatureFlags[featureFlag];
-            if (!featureFlagRegistration) {
-              return context.report({
-                node,
-                messageId: 'featureFlagMissing',
-                data: {
-                  featureFlag
-                }
-              });
-            }
-          }
         }
-        return {};
       }
-    };
+      return {};
+    }]));
   }
 };
 export default rule;

package/dist/es2019/version.json

@@ -1,5 +1,5 @@
 {
 	"name": "@atlaskit/eslint-plugin-platform",
-	"version": "0.1.0",
+	"version": "0.1.2",
 	"sideEffects": false
 }

package/dist/esm/index.js

@@ -11,6 +11,14 @@ export var rules = {
   'no-pre-post-install-scripts': noPreAndPostInstallScripts
 };
 export var configs = {
+  productRecommended: {
+    plugins: ['@atlaskit/platform'],
+    rules: {
+      '@atlaskit/platform/ensure-test-runner-arguments': 'error',
+      '@atlaskit/platform/ensure-test-runner-nested-count': 'warn',
+      '@atlaskit/platform/no-invalid-feature-flag-usage': 'error'
+    }
+  },
   recommended: {
     plugins: ['@atlaskit/platform'],
     rules: {

package/dist/esm/rules/ensure-feature-flag-registration/index.js

@@ -1,18 +1,27 @@
+import _defineProperty from "@babel/runtime/helpers/defineProperty";
 import _toConsumableArray from "@babel/runtime/helpers/toConsumableArray";
+function ownKeys(object, enumerableOnly) { var keys = Object.keys(object); if (Object.getOwnPropertySymbols) { var symbols = Object.getOwnPropertySymbols(object); enumerableOnly && (symbols = symbols.filter(function (sym) { return Object.getOwnPropertyDescriptor(object, sym).enumerable; })), keys.push.apply(keys, symbols); } return keys; }
+function _objectSpread(target) { for (var i = 1; i < arguments.length; i++) { var source = null != arguments[i] ? arguments[i] : {}; i % 2 ? ownKeys(Object(source), !0).forEach(function (key) { _defineProperty(target, key, source[key]); }) : Object.getOwnPropertyDescriptors ? Object.defineProperties(target, Object.getOwnPropertyDescriptors(source)) : ownKeys(Object(source)).forEach(function (key) { Object.defineProperty(target, key, Object.getOwnPropertyDescriptor(source, key)); }); } return target; }
 import readPkgUp from 'read-pkg-up';
 import path from 'path';
+import Fuse from 'fuse.js';
+
+// defines a "getter" to "type" map, if more types are required for feature flags (like string) add it here!
+var getterIdentifierToFlagTypeMap = {
+  getBooleanFF: 'boolean'
+};
 // make sure we cache reading the package.json so we don't end up reading it for every instance of this rule.
 var pkgJsonCache = new Map();
 
 // get the ancestor package.json for a given file
-var getPackageJsonForFileName = function getPackageJsonForFileName(filename) {
+var getMetadataForFilename = function getMetadataForFilename(filename) {
   var splitFilename = filename.split(path.sep);
   for (var i = 0; i < splitFilename.length; i++) {
     // attempt to search using the filename in the cache to see if we've read the package.json for a sibling file before
     var searchPath = path.join.apply(path, _toConsumableArray(splitFilename.splice(0, i)));
-    var cachedPkgJson = pkgJsonCache.get(searchPath);
-    if (cachedPkgJson) {
-      return cachedPkgJson;
+    var cachedMetaData = pkgJsonCache.get(searchPath);
+    if (cachedMetaData) {
+      return cachedMetaData;
     }
   }
   var _ref = readPkgUp.sync({
@@ -21,29 +30,38 @@ var getPackageJsonForFileName = function getPackageJsonForFileName(filename) {
     }),
     packageJson = _ref.packageJson,
     pkgJsonPath = _ref.path;
-  pkgJsonCache.set(pkgJsonPath, packageJson);
-  return packageJson;
+  var pkgJson = packageJson;
+  var fuse = packageJson['platform-feature-flags'] == null ? null : new Fuse(Object.keys(pkgJson['platform-feature-flags']));
+  var metaData = {
+    pkgJson: pkgJson,
+    fuse: fuse
+  };
+  pkgJsonCache.set(pkgJsonPath, metaData);
+  return metaData;
 };
 var rule = {
   meta: {
-    hasSuggestions: false,
     docs: {
       recommended: false
     },
     type: 'problem',
     messages: {
       registrationSectionMissing: 'Please add a "platform-feature-flags" section to your package.json! See http://go/pff-eslint for more details',
-      featureFlagMissing: "Please add a \"{{ featureFlag }}\" section to the \"platform-feature-flags\" section in your package.json. See http://go/pff-eslint for more details"
-    }
+      featureFlagMissing: "Please add a \"{{ featureFlag }}\" section to the \"platform-feature-flags\" section in your package.json. See http://go/pff-eslint for more details",
+      changeFeatureFlag: "Change flag key to \"{{ closestFlag }}\" already defined in package.json"
+    },
+    hasSuggestions: true
   },
   create: function create(context) {
-    return {
-      'CallExpression[callee.name=/getBooleanFF/]': function CallExpressionCalleeNameGetBooleanFF(node) {
+    return Object.fromEntries(Object.keys(getterIdentifierToFlagTypeMap).map(function (getterIdentifier) {
+      return ["CallExpression[callee.name=/".concat(getterIdentifier, "/]"), function (node) {
         // to make typescript happy
         if (node.type === 'CallExpression') {
           var args = node.arguments;
           var filename = context.getFilename();
-          var packageJson = getPackageJsonForFileName(filename);
+          var _getMetadataForFilena = getMetadataForFilename(filename),
+            packageJson = _getMetadataForFilena.pkgJson,
+            fuse = _getMetadataForFilena.fuse;
           var platformFeatureFlags = packageJson['platform-feature-flags'];
           if (!platformFeatureFlags) {
             return context.report({
@@ -55,19 +73,38 @@ var rule = {
             var featureFlag = args[0].value;
             var featureFlagRegistration = platformFeatureFlags[featureFlag];
             if (!featureFlagRegistration) {
-              return context.report({
-                node: node,
+              // find the closest match in existing section for suggestion text
+              var closestMatchFix = null;
+              if (fuse) {
+                var closestFlagMatches = fuse.search(featureFlag);
+                if (closestFlagMatches.length > 0) {
+                  var closestFlag = closestFlagMatches[0].item;
+                  closestMatchFix = {
+                    messageId: 'changeFeatureFlag',
+                    data: {
+                      closestFlag: closestFlag
+                    },
+                    fix: function fix(fixer) {
+                      return fixer.replaceText(node.arguments[0], "'".concat(closestFlag, "'"));
+                    }
+                  };
+                }
+              }
+              return context.report(_objectSpread({
+                node: args[0],
                 messageId: 'featureFlagMissing',
                 data: {
                   featureFlag: featureFlag
                 }
-              });
+              }, closestMatchFix != null ? {
+                suggest: [closestMatchFix]
+              } : {}));
             }
           }
         }
         return {};
-      }
-    };
+      }];
+    }));
   }
 };
 export default rule;

package/dist/esm/version.json

@@ -1,5 +1,5 @@
 {
 	"name": "@atlaskit/eslint-plugin-platform",
-	"version": "0.1.0",
+	"version": "0.1.2",
 	"sideEffects": false
 }

package/dist/types/index.d.ts

@@ -7,6 +7,14 @@ export declare const rules: {
     'no-pre-post-install-scripts': import("eslint").Rule.RuleModule;
 };
 export declare const configs: {
+    productRecommended: {
+        plugins: string[];
+        rules: {
+            '@atlaskit/platform/ensure-test-runner-arguments': string;
+            '@atlaskit/platform/ensure-test-runner-nested-count': string;
+            '@atlaskit/platform/no-invalid-feature-flag-usage': string;
+        };
+    };
     recommended: {
         plugins: string[];
         rules: {

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@atlaskit/eslint-plugin-platform",
   "description": "The essential plugin for use with Atlassian frontend platform tools",
-  "version": "0.1.0",
+  "version": "0.1.2",
   "author": "Atlassian Pty Ltd",
   "atlassian": {
     "team": "UIP - Platform Integration Trust (PITa)",
@@ -23,6 +23,7 @@
   },
   "dependencies": {
     "@babel/runtime": "^7.0.0",
+    "fuse.js": "^6.6.2",
     "read-pkg-up": "^7.0.1"
   },
   "devDependencies": {

package/report.api.md

@@ -20,6 +20,14 @@ import { Rule } from 'eslint';
 
 // @public (undocumented)
 export const configs: {
+  productRecommended: {
+    plugins: string[];
+    rules: {
+      '@atlaskit/platform/ensure-test-runner-arguments': string;
+      '@atlaskit/platform/ensure-test-runner-nested-count': string;
+      '@atlaskit/platform/no-invalid-feature-flag-usage': string;
+    };
+  };
   recommended: {
     plugins: string[];
     rules: {

package/src/__tests__/utils/_tester.tsx

@@ -16,6 +16,7 @@ import { RuleTester } from 'eslint';
     method();
   });
 };
+
 export const tester = new RuleTester({
   parser: require.resolve('babel-eslint'),
   parserOptions: {

package/src/index.tsx

@@ -14,6 +14,14 @@ export const rules = {
 };
 
 export const configs = {
+  productRecommended: {
+    plugins: ['@atlaskit/platform'],
+    rules: {
+      '@atlaskit/platform/ensure-test-runner-arguments': 'error',
+      '@atlaskit/platform/ensure-test-runner-nested-count': 'warn',
+      '@atlaskit/platform/no-invalid-feature-flag-usage': 'error',
+    },
+  },
   recommended: {
     plugins: ['@atlaskit/platform'],
     rules: {

package/src/rules/ensure-feature-flag-registration/__tests__/unit/rule.test.tsx

@@ -31,6 +31,7 @@ describe('with existing platform-feature-flags section', () => {
     };
   });
 
+  // this isolates the invalid case so we can test the suggestion properly
   tester.run('ensure-feature-flag-registration', rule, {
     valid: [
       {
@@ -40,7 +41,20 @@ describe('with existing platform-feature-flags section', () => {
     invalid: [
       {
         code: `getBooleanFF('invalid-flag')`,
-        errors: [{ messageId: 'featureFlagMissing' }],
+        errors: [
+          {
+            messageId: 'featureFlagMissing',
+            suggestions: [
+              {
+                messageId: 'changeFeatureFlag',
+                data: {
+                  closestFlag: 'test-flag',
+                },
+                output: `getBooleanFF('test-flag')`,
+              },
+            ],
+          },
+        ],
       },
     ],
   });

package/src/rules/ensure-feature-flag-registration/index.tsx

@@ -1,26 +1,42 @@
 import type { Rule } from 'eslint';
 import readPkgUp from 'read-pkg-up';
 import path from 'path';
+import Fuse from 'fuse.js';
+
+// defines a "getter" to "type" map, if more types are required for feature flags (like string) add it here!
+const getterIdentifierToFlagTypeMap = {
+  getBooleanFF: 'boolean' as const,
+} as const;
 
 type PlatformFeatureFlagRegistrationSection = {
   [key: string]: {
-    type: 'boolean';
+    // get the values of the object above
+    type: typeof getterIdentifierToFlagTypeMap[keyof typeof getterIdentifierToFlagTypeMap];
   };
 };
 
+type EnhancedPackageJson = readPkgUp.PackageJson & {
+  'platform-feature-flags'?: PlatformFeatureFlagRegistrationSection;
+};
+
+type PkgJsonMetaData = {
+  pkgJson: EnhancedPackageJson;
+  fuse: Fuse<string> | null;
+};
+
 // make sure we cache reading the package.json so we don't end up reading it for every instance of this rule.
-const pkgJsonCache = new Map<string, readPkgUp.PackageJson>();
+const pkgJsonCache = new Map<string, PkgJsonMetaData>();
 
 // get the ancestor package.json for a given file
-const getPackageJsonForFileName = (filename: string): readPkgUp.PackageJson => {
+const getMetadataForFilename = (filename: string): PkgJsonMetaData => {
   const splitFilename = filename.split(path.sep);
   for (let i = 0; i < splitFilename.length; i++) {
     // attempt to search using the filename in the cache to see if we've read the package.json for a sibling file before
     const searchPath = path.join(...splitFilename.splice(0, i));
-    const cachedPkgJson = pkgJsonCache.get(searchPath);
+    const cachedMetaData = pkgJsonCache.get(searchPath);
 
-    if (cachedPkgJson) {
-      return cachedPkgJson;
+    if (cachedMetaData) {
+      return cachedMetaData;
     }
   }
 
@@ -29,13 +45,21 @@ const getPackageJsonForFileName = (filename: string): readPkgUp.PackageJson => {
     normalize: false,
   })!;
 
-  pkgJsonCache.set(pkgJsonPath, packageJson);
-  return packageJson;
+  const pkgJson = packageJson as EnhancedPackageJson;
+
+  const fuse =
+    packageJson['platform-feature-flags'] == null
+      ? null
+      : new Fuse(Object.keys(pkgJson['platform-feature-flags']!));
+
+  const metaData = { pkgJson, fuse };
+
+  pkgJsonCache.set(pkgJsonPath, metaData);
+  return metaData;
 };
 
 const rule: Rule.RuleModule = {
   meta: {
-    hasSuggestions: false,
     docs: {
       recommended: false,
     },
@@ -44,47 +68,88 @@ const rule: Rule.RuleModule = {
       registrationSectionMissing:
         'Please add a "platform-feature-flags" section to your package.json! See http://go/pff-eslint for more details',
       featureFlagMissing: `Please add a "{{ featureFlag }}" section to the "platform-feature-flags" section in your package.json. See http://go/pff-eslint for more details`,
+      changeFeatureFlag: `Change flag key to "{{ closestFlag }}" already defined in package.json`,
     },
+
+    hasSuggestions: true,
   },
   create(context) {
-    return {
-      'CallExpression[callee.name=/getBooleanFF/]': (node: Rule.Node) => {
-        // to make typescript happy
-        if (node.type === 'CallExpression') {
-          const args = node.arguments;
-
-          const filename = context.getFilename();
-          const packageJson = getPackageJsonForFileName(filename);
-          const platformFeatureFlags = packageJson[
-            'platform-feature-flags'
-          ] as PlatformFeatureFlagRegistrationSection;
-
-          if (!platformFeatureFlags) {
-            return context.report({
-              node,
-              messageId: 'registrationSectionMissing',
-            });
-          }
+    return Object.fromEntries(
+      (
+        Object.keys(
+          getterIdentifierToFlagTypeMap,
+        ) as (keyof typeof getterIdentifierToFlagTypeMap)[]
+      ).map((getterIdentifier) => [
+        `CallExpression[callee.name=/${getterIdentifier}/]`,
+        (node: Rule.Node) => {
+          // to make typescript happy
+          if (node.type === 'CallExpression') {
+            const args = node.arguments;
 
-          if (args.length === 1 && args[0].type === 'Literal' && args[0].raw) {
-            const featureFlag = args[0].value as string;
-            const featureFlagRegistration = platformFeatureFlags[featureFlag];
+            const filename = context.getFilename();
+            const { pkgJson: packageJson, fuse } =
+              getMetadataForFilename(filename);
+            const platformFeatureFlags = packageJson['platform-feature-flags'];
 
-            if (!featureFlagRegistration) {
+            if (!platformFeatureFlags) {
               return context.report({
-                node,
-                messageId: 'featureFlagMissing',
-                data: {
-                  featureFlag,
-                },
+                node: node,
+                messageId: 'registrationSectionMissing',
               });
             }
+
+            if (
+              args.length === 1 &&
+              args[0].type === 'Literal' &&
+              args[0].raw
+            ) {
+              const featureFlag = args[0].value as string;
+              const featureFlagRegistration = platformFeatureFlags[featureFlag];
+
+              if (!featureFlagRegistration) {
+                // find the closest match in existing section for suggestion text
+                let closestMatchFix: Rule.SuggestionReportDescriptor | null =
+                  null;
+
+                if (fuse) {
+                  const closestFlagMatches = fuse.search(featureFlag);
+                  if (closestFlagMatches.length > 0) {
+                    const closestFlag = closestFlagMatches[0].item;
+
+                    closestMatchFix = {
+                      messageId: 'changeFeatureFlag',
+                      data: {
+                        closestFlag,
+                      },
+                      fix: (fixer) => {
+                        return fixer.replaceText(
+                          node.arguments[0],
+                          `'${closestFlag}'`,
+                        );
+                      },
+                    };
+                  }
+                }
+
+                return context.report({
+                  node: args[0],
+                  messageId: 'featureFlagMissing',
+                  data: {
+                    featureFlag,
+                  },
+                  // only suggest if we have a close flag to match
+                  ...(closestMatchFix != null
+                    ? { suggest: [closestMatchFix] }
+                    : {}),
+                });
+              }
+            }
           }
-        }
 
-        return {};
-      },
-    };
+          return {};
+        },
+      ]),
+    );
   },
 };
 

package/tmp/api-report-tmp.d.ts

@@ -9,6 +9,14 @@ import { Rule } from 'eslint';
 
 // @public (undocumented)
 export const configs: {
+    productRecommended: {
+        plugins: string[];
+        rules: {
+            '@atlaskit/platform/ensure-test-runner-arguments': string;
+            '@atlaskit/platform/ensure-test-runner-nested-count': string;
+            '@atlaskit/platform/no-invalid-feature-flag-usage': string;
+        };
+    };
     recommended: {
         plugins: string[];
         rules: {