@amazon-devices/eslint-plugin-kepler 0.1.4 → 0.1.8

package/dist/index.js

@@ -1 +1,107 @@
-(()=>{"use strict";var e={24:(e,t,r)=>{Object.defineProperty(t,"__esModule",{value:!0}),t.getAppManifest=function(){if(p)return p;try{const e=n.readFileSync(a.join(l.PROJECT_DIR_PATH,u),"utf8");p=i.parse(e)}catch(e){return}return p},t.getKeplerESLintPackageJson=function(){return s};var n=c(r(896)),a=c(r(928)),i=c(r(94)),s=c(r(330)),l=r(624);function o(e){if("function"!=typeof WeakMap)return null;var t=new WeakMap,r=new WeakMap;return(o=function(e){return e?r:t})(e)}function c(e,t){if(!t&&e&&e.__esModule)return e;if(null===e||"object"!=typeof e&&"function"!=typeof e)return{default:e};var r=o(t);if(r&&r.has(e))return r.get(e);var n={__proto__:null},a=Object.defineProperty&&Object.getOwnPropertyDescriptor;for(var i in e)if("default"!==i&&{}.hasOwnProperty.call(e,i)){var s=a?Object.getOwnPropertyDescriptor(e,i):null;s&&(s.get||s.set)?Object.defineProperty(n,i,s):n[i]=e[i]}return n.default=e,r&&r.set(e,n),n}let p;const u="manifest.toml"},94:e=>{e.exports=require("toml")},272:(e,t,r)=>{Object.defineProperty(t,"__esModule",{value:!0}),t.DetectSplashScreen=void 0;var n=r(816),a=r(886);const i="usePreventHideSplashScreen",s="useHideSplashScreenCallback";t.DetectSplashScreen={meta:{type:"suggestion",docs:{description:"usePreventHideSplashScreen() should be used to natively render splash screen, for better App launch performance",recommended:!0,category:"Performance"},fixable:"code",schema:[]},create(e){const t=new Set,r=new Set;return{VariableDeclarator(e){(0,a.isFunctionAssignedToVariable)(e,i)||(0,a.isModuleFunctionAssignedToVariable)(e,i)?t.add(e.id.name):((0,a.isFunctionAssignedToVariable)(e,s)||(0,a.isModuleFunctionAssignedToVariable)(e,s))&&r.add(e.id.name)},CallExpression(e){if((0,a.isDirectCall)(e,i)||(0,a.isAliasCall)(e,i,t)||(0,a.isNamespacedCall)(e,i)){const e=n.KeplerESLintPluginStateManager.getInstance().getKeplerESLintState();e.splashScreen.usePreventHideSplashScreenFound=!0,n.KeplerESLintPluginStateManager.getInstance().setKeplerESLintState(e)}else if((0,a.isDirectCall)(e,s)||(0,a.isAliasCall)(e,s,r)||(0,a.isNamespacedCall)(e,s)){const e=n.KeplerESLintPluginStateManager.getInstance().getKeplerESLintState();e.splashScreen.useHideSplashScreenCallbackFound=!0,n.KeplerESLintPluginStateManager.getInstance().setKeplerESLintState(e)}}}}}},330:e=>{e.exports=JSON.parse('{"name":"@amazon-devices/eslint-plugin-kepler","version":"0.1.4","description":"An ESLint Plugin to suggest Kepler App Development best practices","main":"dist/index.js","files":["dist","THIRD_PARTY_NOTICES.txt"],"scripts":{"test":"jest --colors","lint":"eslint src __tests__ --ext .js,.ts,.tsx","lint:fix":"eslint src __tests__ --ext .js,.ts,.tsx --fix","prepare":"npm run build","typeCheck":"tsc --noEmit","bundle":"webpack","build":"npm-run-all lint typeCheck test bundle","format":"prettier --config .prettierrc \'src/**/*.ts\' \'__tests__/**/*.ts\' --write","checkLicenses":"license-checker --production --exclude MIT,Apache-2.0,BSD-2-Clause,BSD-3-Clause,ISC,0BSD,Python-2.0","genAttribution":"generate-attribution -o ./.attr && mv .attr/attribution.txt ./dist/LICENSE-THIRD-PARTY && rm -rf .attr"},"devDependencies":{"@amazon-devices/kepler-telemetry-service-config":"*","@amazon-devices/kepler-telemetry-service-typescript-client":"*","@babel/cli":"^7.26.4","@babel/core":"^7.26.9","@babel/preset-env":"^7.26.9","@babel/preset-typescript":"^7.26.0","@eslint/js":"^8.12.0","@trivago/prettier-plugin-sort-imports":"^5.2.1","@types/eslint":"^8.4.1","@types/jest":"^29.5.14","@types/node":"^22.10.2","@typescript-eslint/eslint-plugin":"^8.18.0","@typescript-eslint/parser":"^8.18.0","@typescript-eslint/types":"^8.18.0","@typescript-eslint/utils":"^8.18.0","babel-loader":"^9.2.1","babel-plugin-transform-remove-console":"^6.9.4","eslint":"^8.12.0","globals":"^15.13.0","husky":"^9.1.7","jest":"^29.7.0","license-checker":"^25.0.1","npm-run-all":"^4.1.5","oss-attribution-generator":"^1.7.1","prettier-plugin-organize-imports":"^4.1.0","ts-jest":"^29.2.5","ts-node":"^10.9.2","typescript":"^5.7.2","typescript-eslint":"^8.18.0","webpack":"^5.98.0","webpack-cli":"^6.0.1"},"dependencies":{"chalk":"^4.1.2","toml":"^3.0.0","uuid":"^11.0.0"},"peerDependencies":{"eslint":">=8.12.0"},"husky":{"hooks":{"pre-commit":"npm run format"}}}')},407:(e,t,r)=>{Object.defineProperty(t,"__esModule",{value:!0}),t.CheckSubscription=void 0;const n=`See ${r(624).KEPLER_BEST_PRACTICE_URL}#listeners-event-subscriptions-and-timers for more.`;t.CheckSubscription={meta:{type:"suggestion",docs:{description:"Checks if subscriptions are set to be cleaned up",recommended:!0,category:"Performance"},fixable:"code",schema:[],messages:{failedToKeepSubscription:`Subscription must be kept in variable so that it can be cleaned up on the component is detached.  ${n}`,missingCleanUp:`Subscription \`{{varName}}\` is not cleaned up.  ${n}`}},create(e){const t=new Set,r=new Set,n=new Set;return{"VariableDeclarator[init.callee.name = /^useAdd(KeplerAppState|UserInput)ListenerCallback$/]":e=>{if("Identifier"===e.id.type){const r=e.id.name;t.add(r)}},"CallExpression[callee.name='useEffect'] :function CallExpression":a=>{if("Identifier"===a.callee.type&&t.has(a.callee.name)){const t=e.sourceCode??e.getSourceCode(),i=t.getAncestors?.(a)??e.getAncestors();if(i.length>=1){const e=i[i.length-1];if("VariableDeclarator"===e.type&&"Identifier"==e.id.type)return void r.add(e.id.name);if("AssignmentExpression"===e.type&&"Identifier"==e.left.type)return void r.add(e.left.name);if("CallExpression"===e.type&&e.arguments[0]===a&&"MemberExpression"===e.callee.type){const t=e.callee;if("Identifier"===t.property.type&&["add","push"].includes(t.property.name)&&"Identifier"===t.object.type)return void n.add(t.object.name)}}e.report({node:a,messageId:"failedToKeepSubscription"})}},"CallExpression[callee.name='useEffect'] :function ReturnStatement CallExpression[callee.property.name='remove']":e=>{if("MemberExpression"===e.callee.type){const t=e.callee;"Identifier"===t.object.type&&r.has(t.object.name)&&r.delete(t.object.name)}},"CallExpression[callee.name='useEffect'] :function ReturnStatement CallExpression[callee.property.name='forEach']":e=>{if("MemberExpression"===e.callee.type){const t=e.callee;"Identifier"===t.object.type&&n.has(t.object.name)&&n.delete(t.object.name)}},"CallExpression[callee.name='useEffect']:exit":t=>{for(const n of r)e.report({node:t,messageId:"missingCleanUp",data:{varName:n}});for(const r of n)e.report({node:t,messageId:"missingCleanUp",data:{varName:r}});r.clear(),n.clear()}}}}},624:(e,t,r)=>{Object.defineProperty(t,"__esModule",{value:!0}),t.UNKNOWN=t.PROJECT_DIR_PATH=t.KeplerESLintRuleIds=t.KEPLER_ESLINT_RULE_PREFIX=t.KEPLER_ESLINT_OUTPUT_DIR_PATH=t.KEPLER_DOC_BASE_URL=t.KEPLER_BEST_PRACTICE_URL=t.ICON_WARN=t.ICON_ERROR=t.ESLintRuleSeverity=void 0;var n=function(e,t){if(e&&e.__esModule)return e;if(null===e||"object"!=typeof e&&"function"!=typeof e)return{default:e};var r=a(t);if(r&&r.has(e))return r.get(e);var n={__proto__:null},i=Object.defineProperty&&Object.getOwnPropertyDescriptor;for(var s in e)if("default"!==s&&{}.hasOwnProperty.call(e,s)){var l=i?Object.getOwnPropertyDescriptor(e,s):null;l&&(l.get||l.set)?Object.defineProperty(n,s,l):n[s]=e[s]}return n.default=e,r&&r.set(e,n),n}(r(928));function a(e){if("function"!=typeof WeakMap)return null;var t=new WeakMap,r=new WeakMap;return(a=function(e){return e?r:t})(e)}t.KeplerESLintRuleIds=function(e){return e.FlatList="@amazon-devices/kepler/flat-list",e.Animated="@amazon-devices/kepler/animated",e.NoComplexScrollView="@amazon-devices/kepler/no-complex-scroll-view",e.DetectReportFullyDrawn="@amazon-devices/kepler/detect-report-fully-drawn",e.DetectSplashScreen="@amazon-devices/kepler/detect-splash-screen",e}({}),t.ESLintRuleSeverity=function(e){return e[e.OFF=0]="OFF",e[e.WARNING=1]="WARNING",e[e.ERROR=2]="ERROR",e}({});const i=t.PROJECT_DIR_PATH=process.cwd(),s=(t.KEPLER_ESLINT_OUTPUT_DIR_PATH=n.join(i,"generated","eslint-plugin-kepler"),t.ICON_WARN="⚠️",t.ICON_ERROR="❌",t.KEPLER_ESLINT_RULE_PREFIX="@amazon-devices/kepler",t.UNKNOWN="UNKNOWN",t.KEPLER_DOC_BASE_URL="https://developer.amazon.com/docs");t.KEPLER_BEST_PRACTICE_URL=`${s}/kepler/best_practices.html`},723:(e,t,r)=>{var n=r(737),a=r(407),i=r(272),s=r(970),l=r(819),o=r(816),c=r(24);o.KeplerESLintPluginStateManager.getInstance().initialize(),e.exports={meta:{name:(0,c.getKeplerESLintPackageJson)().name,version:(0,c.getKeplerESLintPackageJson)().version,filePatterns:["**/*.jsx","**/*.tsx"]},configs:{performance:{plugins:["@amazon-devices/eslint-plugin-kepler"],rules:{"@amazon-devices/kepler/flat-list":"warn","@amazon-devices/kepler/check-subscription":"warn","@amazon-devices/kepler/animated":"error","@amazon-devices/kepler/detect-report-fully-drawn":"warn","@amazon-devices/kepler/detect-splash-screen":"warn"}}},rules:{"flat-list":l.FlatList,"check-subscription":a.CheckSubscription,animated:n.Animated,"detect-report-fully-drawn":s.DetectUseReportFullyDrawn,"detect-splash-screen":i.DetectSplashScreen}}},737:(e,t,r)=>{Object.defineProperty(t,"__esModule",{value:!0}),t.Animated=void 0;var n=r(624);const a="useNativeDriver";t.Animated={meta:{type:"suggestion",docs:{description:"Recommends performance optimization configs for 'Animated' component",recommended:!0,category:"Performance"},fixable:"code",schema:[]},create:e=>({CallExpression(t){if("MemberExpression"!==t.callee.type||"Animated"!==t.callee.object.name||"timing"!==t.callee.property.name&&"spring"!==t.callee.property.name&&"decay"!==t.callee.property.name)return;const r=`${t.callee.object.name}.${t.callee.property.name}()`;if(t.arguments.length<2)return;const i=t.arguments[1];if("ObjectExpression"!==i.type)return;const s=i.properties.find((e=>"Property"===e.type&&"Identifier"===e.key.type&&e.key.name===a));s?s&&"Literal"===s.value.type&&!0===s.value.value||e.report({node:t,message:`'${a}' property is set to 'false'.  Set ${a} to 'true' to run animations on UI thread for better performance.  See ${n.KEPLER_BEST_PRACTICE_URL}#animations for more.`}):e.report({node:t,message:`${r} missing props: '${a}'.  Set ${a} to 'true' to run animations on UI thread for better performance.  See ${n.KEPLER_BEST_PRACTICE_URL}#animations for more.`})}})}},816:(e,t,r)=>{Object.defineProperty(t,"__esModule",{value:!0}),t.KeplerESLintPluginStateManager=void 0;var n=l(r(896)),a=l(r(928)),i=r(624);function s(e){if("function"!=typeof WeakMap)return null;var t=new WeakMap,r=new WeakMap;return(s=function(e){return e?r:t})(e)}function l(e,t){if(!t&&e&&e.__esModule)return e;if(null===e||"object"!=typeof e&&"function"!=typeof e)return{default:e};var r=s(t);if(r&&r.has(e))return r.get(e);var n={__proto__:null},a=Object.defineProperty&&Object.getOwnPropertyDescriptor;for(var i in e)if("default"!==i&&{}.hasOwnProperty.call(e,i)){var l=a?Object.getOwnPropertyDescriptor(e,i):null;l&&(l.get||l.set)?Object.defineProperty(n,i,l):n[i]=e[i]}return n.default=e,r&&r.set(e,n),n}const o=a.join(i.KEPLER_ESLINT_OUTPUT_DIR_PATH,"keplerESLintState.json");class c{constructor(){this.keplerESLintState={fullyDrawn:{useReportFullyDrawnFound:!1},splashScreen:{usePreventHideSplashScreenFound:!1,useHideSplashScreenCallbackFound:!1}}}static getInstance(){return c.instance||(c.instance=new c),c.instance}initialize(){n.existsSync(i.KEPLER_ESLINT_OUTPUT_DIR_PATH)||n.mkdirSync(i.KEPLER_ESLINT_OUTPUT_DIR_PATH,{recursive:!0}),this.persistKeplerAnalyzerState()}setKeplerESLintState(e){this.keplerESLintState=e,this.persistKeplerAnalyzerState()}getKeplerESLintState(){return this.keplerESLintState}persistKeplerAnalyzerState(){n.writeFileSync(o,JSON.stringify(this.keplerESLintState),"utf8")}static readKeplerESLintState(){let e;try{e=JSON.parse(n.readFileSync(o,"utf8"))}catch(e){console.error(e)}return e}static cleanUpKeplerESLintState(){try{n.rmSync(i.KEPLER_ESLINT_OUTPUT_DIR_PATH)}catch(e){console.error(`Error deleting ${i.KEPLER_ESLINT_OUTPUT_DIR_PATH}`),console.error(e)}}}t.KeplerESLintPluginStateManager=c},819:(e,t,r)=>{Object.defineProperty(t,"__esModule",{value:!0}),t.FlatList=void 0;var n=r(624);const a=["initialNumToRender","windowSize","removeClippedSubviews","maxToRenderPerBatch","updateCellsBatchingPeriod"];t.FlatList={meta:{type:"suggestion",docs:{description:"FlatList causes performance overhead and should be used carefully",recommended:!0,category:"Performance"},fixable:"code",schema:[]},create:e=>({JSXOpeningElement(t){if("FlatList"===t.name.name){const r=t.attributes.map((e=>e.name.name)),i=a.filter((e=>!r.includes(e)));i.length>0&&e.report({node:t,message:`FlatList missing props: '${i}'.  FlatList performance is not fully unlocked without these props.  See ${n.KEPLER_BEST_PRACTICE_URL}#flatlist for more.`})}}})}},886:(e,t)=>{Object.defineProperty(t,"__esModule",{value:!0}),t.isAliasCall=function(e,t,n){return e.callee.type===r&&n.has(e.callee.name)},t.isDirectCall=function(e,t){return e.callee.type===r&&e.callee.name===t},t.isFunctionAssignedToVariable=function(e,t){return e.init?.type===r&&e.init.name===t&&e.id.type===r},t.isModuleFunctionAssignedToVariable=function(e,t){return e.init?.type===n&&e.init.property.type===r&&e.init.property.name===t&&e.id.type===r},t.isNamespacedCall=function(e,t){return e.callee.type===n&&e.callee.property.type===r&&e.callee.property.name===t};const r="Identifier",n="MemberExpression"},896:e=>{e.exports=require("fs")},928:e=>{e.exports=require("path")},970:(e,t,r)=>{Object.defineProperty(t,"__esModule",{value:!0}),t.DetectUseReportFullyDrawn=void 0;var n=r(816),a=r(886);const i="useReportFullyDrawn";t.DetectUseReportFullyDrawn={meta:{type:"suggestion",docs:{description:"useReportFullyDrawn() callback should be used to measure Time to Fully Drawn",recommended:!0,category:"Performance"},fixable:"code",schema:[]},create(e){const t=new Set;return{VariableDeclarator(e){(0,a.isFunctionAssignedToVariable)(e,i)&&t.add(e.id.name),(0,a.isModuleFunctionAssignedToVariable)(e,i)&&t.add(e.id.name)},CallExpression(e){if((0,a.isDirectCall)(e,i)||(0,a.isAliasCall)(e,i,t)||(0,a.isNamespacedCall)(e,i)){const e=n.KeplerESLintPluginStateManager.getInstance().getKeplerESLintState();e.fullyDrawn.useReportFullyDrawnFound=!0,n.KeplerESLintPluginStateManager.getInstance().setKeplerESLintState(e)}}}}}}},t={},r=function r(n){var a=t[n];if(void 0!==a)return a.exports;var i=t[n]={exports:{}};return e[n](i,i.exports,r),i.exports}(723);module.exports=r})();
+"use strict";
+
+var _Animated = require("./rules/performance/Animated");
+var _CheckSubscription = require("./rules/performance/CheckSubscription");
+var _DetectSplashScreen = require("./rules/performance/DetectSplashScreen");
+var _DetectUseReportFullyDrawn = require("./rules/performance/DetectUseReportFullyDrawn");
+var _FlatList = require("./rules/performance/FlatList");
+var _SDLPackageVersionCheck = require("./rules/systemDistributedLibs/SDLPackageVersionCheck");
+var _SDLPackageVersionCheckImports = require("./rules/systemDistributedLibs/SDLPackageVersionCheckImports");
+var _ApiPrivilegesCheck = require("./rules/apiPrivileges/ApiPrivilegesCheck");
+var _ApiPrivilegeStateCheck = require("./rules/apiPrivileges/ApiPrivilegeStateCheck");
+var _BackwardCompatibility = require("./rules/backwardCompatibility/BackwardCompatibility");
+var _BackwardCompatibilityCopyOnPack = require("./rules/backwardCompatibility/BackwardCompatibilityCopyOnPack");
+var _BackwardCompatibilitySysconfCheck = require("./rules/backwardCompatibility/BackwardCompatibilitySysconfCheck");
+var _KeplerESLintPluginStateManager = require("./state/KeplerESLintPluginStateManager");
+var _PackageUtils = require("./utils/PackageUtils");
+// Copyright 2025 Amazon.com, Inc. or its affiliates. All rights reserved.
+// AMAZON PROPRIETARY/CONFIDENTIAL
+// You may not use this file except in compliance with the terms and conditions
+// set forth in the accompanying LICENSE.TXT file.
+// THESE MATERIALS ARE PROVIDED ON AN "AS IS" BASIS. AMAZON SPECIFICALLY
+// DISCLAIMS, WITH RESPECT TO THESE MATERIALS, ALL WARRANTIES, EXPRESS,
+// IMPLIED, OR STATUTORY, INCLUDING THE IMPLIED WARRANTIES OF MERCHANTABILITY,
+// FITNESS FOR A PARTICULAR PURPOSE, AND NON-INFRINGEMENT.
+
+const stateManager = _KeplerESLintPluginStateManager.KeplerESLintPluginStateManager.getInstance();
+stateManager.initialize();
+module.exports = {
+  meta: {
+    name: (0, _PackageUtils.getKeplerESLintPackageJson)().name,
+    version: (0, _PackageUtils.getKeplerESLintPackageJson)().version,
+    filePatterns: ['**/*.jsx', '**/*.tsx', '**/package.json']
+  },
+  configs: {
+    kepler: {
+      plugins: ['@amazon-devices/eslint-plugin-kepler'],
+      rules: {
+        '@amazon-devices/kepler/flat-list': 'warn',
+        '@amazon-devices/kepler/check-subscription': 'warn',
+        '@amazon-devices/kepler/animated': 'error',
+        '@amazon-devices/kepler/detect-report-fully-drawn': 'warn',
+        '@amazon-devices/kepler/detect-splash-screen': 'warn',
+        '@amazon-devices/kepler/sdl-package-version-check': ['error', {
+          'semverGuidance': 'auto'
+        }],
+        '@amazon-devices/kepler/sdl-package-version-check-imports': ['warn', {
+          'semverGuidance': 'auto'
+        }],
+        '@amazon-devices/kepler/api-privileges-check': 'error',
+        '@amazon-devices/kepler/api-privilege-state-check': 'error',
+        '@amazon-devices/kepler/backward-compatibility': 'error',
+        '@amazon-devices/kepler/backward-compatibility-copy-on-pack': 'error',
+        '@amazon-devices/kepler/backward-compatibility-sysconf-check': 'error'
+      }
+    },
+    performance: {
+      plugins: ['@amazon-devices/eslint-plugin-kepler'],
+      rules: {
+        '@amazon-devices/kepler/flat-list': 'warn',
+        '@amazon-devices/kepler/check-subscription': 'warn',
+        '@amazon-devices/kepler/animated': 'error',
+        '@amazon-devices/kepler/detect-report-fully-drawn': 'warn',
+        '@amazon-devices/kepler/detect-splash-screen': 'warn'
+      }
+    },
+    'system-distributed-libs': {
+      plugins: ['@amazon-devices/eslint-plugin-kepler'],
+      rules: {
+        '@amazon-devices/kepler/sdl-package-version-check': ['error', {
+          'semverGuidance': 'auto'
+        }],
+        '@amazon-devices/kepler/sdl-package-version-check-imports': ['warn', {
+          'semverGuidance': 'auto'
+        }]
+      }
+    },
+    'api-privileges': {
+      plugins: ['@amazon-devices/eslint-plugin-kepler'],
+      rules: {
+        '@amazon-devices/kepler/api-privileges-check': 'error',
+        '@amazon-devices/kepler/api-privilege-state-check': 'error'
+      }
+    },
+    'backward-compatibility': {
+      plugins: ['@amazon-devices/eslint-plugin-kepler'],
+      rules: {
+        '@amazon-devices/kepler/backward-compatibility': 'error',
+        '@amazon-devices/kepler/backward-compatibility-copy-on-pack': 'error',
+        '@amazon-devices/kepler/backward-compatibility-sysconf-check': 'error'
+      }
+    }
+  },
+  rules: {
+    'flat-list': _FlatList.FlatList,
+    'check-subscription': _CheckSubscription.CheckSubscription,
+    'animated': _Animated.Animated,
+    'detect-report-fully-drawn': _DetectUseReportFullyDrawn.DetectUseReportFullyDrawn,
+    'detect-splash-screen': _DetectSplashScreen.DetectSplashScreen,
+    'sdl-package-version-check': _SDLPackageVersionCheck.SDLPackageVersionCheck,
+    'sdl-package-version-check-imports': _SDLPackageVersionCheckImports.SDLPackageVersionCheckImports,
+    'api-privileges-check': _ApiPrivilegesCheck.ApiPrivilegesCheck,
+    'api-privilege-state-check': _ApiPrivilegeStateCheck.ApiPrivilegeStateCheck,
+    'backward-compatibility': _BackwardCompatibility.BackwardCompatibility,
+    'backward-compatibility-copy-on-pack': _BackwardCompatibilityCopyOnPack.BackwardCompatibilityCopyOnPack,
+    'backward-compatibility-sysconf-check': _BackwardCompatibilitySysconfCheck.BackwardCompatibilitySysconfCheck
+  }
+};

package/dist/metrics/Metrics.js

@@ -0,0 +1,69 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.emitMetric = emitMetric;
+var fs = _interopRequireWildcard(require("fs"));
+var path = _interopRequireWildcard(require("path"));
+var _uuid = require("uuid");
+var _keplerTelemetryServiceTypescriptClient = require("@amazon-devices/kepler-telemetry-service-typescript-client");
+var _Constants = require("../utils/Constants");
+var _TelemetryService = require("./TelemetryService");
+function _interopRequireWildcard(e, t) { if ("function" == typeof WeakMap) var r = new WeakMap(), n = new WeakMap(); return (_interopRequireWildcard = function (e, t) { if (!t && e && e.__esModule) return e; var o, i, f = { __proto__: null, default: e }; if (null === e || "object" != typeof e && "function" != typeof e) return f; if (o = t ? n : r) { if (o.has(e)) return o.get(e); o.set(e, f); } for (const t in e) "default" !== t && {}.hasOwnProperty.call(e, t) && ((i = (o = Object.defineProperty) && Object.getOwnPropertyDescriptor(e, t)) && (i.get || i.set) ? o(f, t, i) : f[t] = e[t]); return f; })(e, t); }
+// Copyright 2025 Amazon.com, Inc. or its affiliates. All rights reserved.
+// AMAZON PROPRIETARY/CONFIDENTIAL
+// You may not use this file except in compliance with the terms and conditions
+// set forth in the accompanying LICENSE.TXT file.
+// THESE MATERIALS ARE PROVIDED ON AN "AS IS" BASIS. AMAZON SPECIFICALLY
+// DISCLAIMS, WITH RESPECT TO THESE MATERIALS, ALL WARRANTIES, EXPRESS,
+// IMPLIED, OR STATUTORY, INCLUDING THE IMPLIED WARRANTIES OF MERCHANTABILITY,
+// FITNESS FOR A PARTICULAR PURPOSE, AND NON-INFRINGEMENT.
+
+let lintSessionId = undefined;
+
+/**
+ * Emits the provided metric object.
+ * @param metric KeplerESLintSummaryMetric object
+ */
+async function emitMetric(metric) {
+  const disableTelemetry = process.env.KEPLER_ESLINT_TELEMETRY_DISABLE;
+  if (disableTelemetry && disableTelemetry.toUpperCase() === 'TRUE') {
+    return;
+  }
+  try {
+    const metricsToFile = process.env.KEPLER_ESLINT_TELEMETRY_TO_FILE;
+    if (metricsToFile && metricsToFile.toUpperCase() === 'TRUE') {
+      const filePath = path.join(_Constants.KEPLER_ESLINT_OUTPUT_DIR_PATH, 'keplerESLintMetrics.json');
+      fs.writeFileSync(filePath, JSON.stringify(metric), 'utf8');
+    } else {
+      const telemetryClient = (0, _TelemetryService.getTelemetryClient)();
+      const records = toTelemetryRecords(metric, await telemetryClient?.getMachineId());
+      for (const record of records) {
+        await telemetryClient?.publishMetric(record);
+      }
+    }
+  } catch (err) {}
+}
+function toTelemetryRecords(metric, machineId) {
+  const lintSessionId = getLintSessionId();
+  const records = [];
+  metric.ruleMetrics.forEach(ruleMetric => {
+    const lintResultMetric = new _keplerTelemetryServiceTypescriptClient.TelemetryRecordBuilder().withOperationName('lint_result').withMetricType(_keplerTelemetryServiceTypescriptClient.MetricType.Value).withMetricValue(1).withMetricAdditionalProperty('lint_session_id', lintSessionId).withMetricAdditionalProperty('app_id', metric.project?.name ?? _Constants.UNKNOWN).withMetricAdditionalProperty('severity', ruleMetric.severity).withMetricAdditionalProperty('rule_id', ruleMetric.ruleId).withMetricAdditionalProperty('message_id', ruleMetric.messageId ?? _Constants.UNKNOWN).withMetricAdditionalProperty('message', ruleMetric.message ?? _Constants.UNKNOWN).withMetricAdditionalProperty('suppressions', ruleMetric.suppressions ? JSON.stringify(ruleMetric.suppressions) : "").withMetricAdditionalProperty('machine_id', machineId).buildBehavioralAndOperational();
+    if (lintResultMetric instanceof _keplerTelemetryServiceTypescriptClient.TelemetryRecord) {
+      records.push(lintResultMetric);
+    } else {}
+  });
+  const reportMetric = new _keplerTelemetryServiceTypescriptClient.TelemetryRecordBuilder().withOperationName('lint_html_report').withMetricType(_keplerTelemetryServiceTypescriptClient.MetricType.Error).withMetricValue(metric.reportMetric.exportSuccess ? 0 : 1).withMetricAdditionalProperty('session_id', lintSessionId).withMetricAdditionalProperty('app_id', metric.project?.name ?? _Constants.UNKNOWN).withMetricAdditionalProperty('message', metric.reportMetric.exportError ?? _Constants.UNKNOWN).withMetricAdditionalProperty('machine_id', machineId).buildBehavioralAndOperational();
+  if (reportMetric instanceof _keplerTelemetryServiceTypescriptClient.TelemetryRecord) {
+    records.push(reportMetric);
+  } else {}
+  return records;
+}
+function getLintSessionId() {
+  if (lintSessionId === undefined) {
+    // generate random UUID
+    lintSessionId = (0, _uuid.v4)();
+  }
+  return lintSessionId;
+}

package/dist/metrics/TelemetryService.js

@@ -0,0 +1,48 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.getTelemetryClient = getTelemetryClient;
+exports.resetTelemetryClientForTests = resetTelemetryClientForTests;
+var _keplerTelemetryServiceTypescriptClient = require("@amazon-devices/kepler-telemetry-service-typescript-client");
+var _PackageUtils = require("../utils/PackageUtils");
+/* eslint-disable @typescript-eslint/no-unused-vars */
+// Copyright 2025 Amazon.com, Inc. or its affiliates. All rights reserved.
+// AMAZON PROPRIETARY/CONFIDENTIAL
+// You may not use this file except in compliance with the terms and conditions
+// set forth in the accompanying LICENSE.TXT file.
+// THESE MATERIALS ARE PROVIDED ON AN "AS IS" BASIS. AMAZON SPECIFICALLY
+// DISCLAIMS, WITH RESPECT TO THESE MATERIALS, ALL WARRANTIES, EXPRESS,
+// IMPLIED, OR STATUTORY, INCLUDING THE IMPLIED WARRANTIES OF MERCHANTABILITY,
+// FITNESS FOR A PARTICULAR PURPOSE, AND NON-INFRINGEMENT.
+
+const KIA_COMPONENT_NAME = "kepler_eslint_plugin";
+let client = undefined;
+class SilentLogger {
+  debug(message) {}
+  info(message) {}
+  warn(message) {}
+  error(message) {}
+}
+
+/**
+ * Returns the TelemetryClient singleton instance.
+ * @returns TelemetryClient instance, or undefined if the client could not be created.
+ */
+function getTelemetryClient() {
+  if (!client) {
+    client = new _keplerTelemetryServiceTypescriptClient.TelemetryClientBuilder().withLogger(new SilentLogger()).withComponentName(KIA_COMPONENT_NAME).withComponentVersion((0, _PackageUtils.getKeplerESLintPackageJson)().version).build();
+  }
+  if (client instanceof _keplerTelemetryServiceTypescriptClient.TelemetryClientError) {
+    return undefined;
+  }
+  return client;
+}
+
+/**
+ * Resets the TelemetryClient singleton instance for tests.
+ */
+function resetTelemetryClientForTests() {
+  client = undefined;
+}

package/dist/rules/apiPrivileges/ApiPrivilegeStateCheck.js

@@ -0,0 +1,102 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.ApiPrivilegeStateCheck = void 0;
+var fs = _interopRequireWildcard(require("fs"));
+var path = _interopRequireWildcard(require("path"));
+var _apiPermissionsNeeded = require("./apiPermissionsNeeded");
+function _interopRequireWildcard(e, t) { if ("function" == typeof WeakMap) var r = new WeakMap(), n = new WeakMap(); return (_interopRequireWildcard = function (e, t) { if (!t && e && e.__esModule) return e; var o, i, f = { __proto__: null, default: e }; if (null === e || "object" != typeof e && "function" != typeof e) return f; if (o = t ? n : r) { if (o.has(e)) return o.get(e); o.set(e, f); } for (const t in e) "default" !== t && {}.hasOwnProperty.call(e, t) && ((i = (o = Object.defineProperty) && Object.getOwnPropertyDescriptor(e, t)) && (i.get || i.set) ? o(f, t, i) : f[t] = e[t]); return f; })(e, t); }
+// Copyright 2025 Amazon.com, Inc. or its affiliates. All rights reserved.
+// AMAZON PROPRIETARY/CONFIDENTIAL
+// You may not use this file except in compliance with the terms and conditions
+// set forth in the accompanying LICENSE.TXT file.
+// THESE MATERIALS ARE PROVIDED ON AN "AS IS" BASIS. AMAZON SPECIFICALLY
+// DISCLAIMS, WITH RESPECT TO THESE MATERIALS, ALL WARRANTIES, EXPRESS,
+// IMPLIED, OR STATUTORY, INCLUDING THE IMPLIED WARRANTIES OF MERCHANTABILITY,
+// FITNESS FOR A PARTICULAR PURPOSE, AND NON-INFRINGEMENT.
+
+/**
+ * ESLint rule to check for SecurityManager usage when APIs require user prompts
+ */
+const ApiPrivilegeStateCheck = exports.ApiPrivilegeStateCheck = {
+  meta: {
+    type: 'problem',
+    docs: {
+      description: 'Checks that APIs requiring user prompts have SecurityManager implementation',
+      recommended: true,
+      category: 'API Privileges'
+    },
+    fixable: undefined,
+    schema: []
+  },
+  create(context) {
+    const packageRequirements = new Map();
+    _apiPermissionsNeeded.API_PRIV_NEEDED.forEach(req => {
+      if (req.requiresUserPrompt) {
+        packageRequirements.set(req.packageName, req);
+      }
+    });
+
+    /**
+     * Checks if SecurityManager package is in package.json dependencies
+     */
+    const hasSecurityManagerDependency = () => {
+      try {
+        const packageJsonPath = path.join(process.cwd(), 'package.json');
+        if (!fs.existsSync(packageJsonPath)) {
+          return false;
+        }
+        const packageJson = JSON.parse(fs.readFileSync(packageJsonPath, 'utf8'));
+        const allDeps = {
+          ...packageJson.dependencies,
+          ...packageJson.devDependencies
+        };
+        return !!(allDeps['@amazon-devices/security-manager-lib'] || allDeps['@amazon-devices/security-manager-lib']);
+      } catch (error) {
+        return false;
+      }
+    };
+    let hasGetPrivilegeState = false;
+    let hasRequestPrivilege = false;
+    const importNodes = [];
+    return {
+      MemberExpression(node) {
+        if (node.object && node.object.name === 'SecurityManager') {
+          if (node.property && node.property.name === 'getPrivilegeState') {
+            hasGetPrivilegeState = true;
+          }
+          if (node.property && node.property.name === 'requestPrivilege') {
+            hasRequestPrivilege = true;
+          }
+        }
+      },
+      ImportDeclaration(node) {
+        const importSource = node.source.value;
+        const requirement = packageRequirements.get(importSource);
+        if (requirement) {
+          importNodes.push({
+            node,
+            importSource
+          });
+        }
+      },
+      'Program:exit'() {
+        const hasDependency = hasSecurityManagerDependency();
+        const hasCalls = hasGetPrivilegeState && hasRequestPrivilege;
+        importNodes.forEach(({
+          node,
+          importSource
+        }) => {
+          if (!hasDependency || !hasCalls) {
+            context.report({
+              node,
+              message: `The API ${importSource} requires you prompt the user for privilige acceptance. See the Vega documentation for this API as well as for SecurityManager.`
+            });
+          }
+        });
+      }
+    };
+  }
+};

package/dist/rules/apiPrivileges/ApiPrivilegesCheck.js

@@ -0,0 +1,67 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.ApiPrivilegesCheck = void 0;
+var _apiPermissionsNeeded = require("./apiPermissionsNeeded");
+var _manifestHelper = require("./manifestHelper");
+// Copyright 2025 Amazon.com, Inc. or its affiliates. All rights reserved.
+// AMAZON PROPRIETARY/CONFIDENTIAL
+// You may not use this file except in compliance with the terms and conditions
+// set forth in the accompanying LICENSE.TXT file.
+// THESE MATERIALS ARE PROVIDED ON AN "AS IS" BASIS. AMAZON SPECIFICALLY
+// DISCLAIMS, WITH RESPECT TO THESE MATERIALS, ALL WARRANTIES, EXPRESS,
+// IMPLIED, OR STATUTORY, INCLUDING THE IMPLIED WARRANTIES OF MERCHANTABILITY,
+// FITNESS FOR A PARTICULAR PURPOSE, AND NON-INFRINGEMENT.
+
+/**
+ * ESLint rule to check for API imports that require permissions in manifest.toml
+ */
+const ApiPrivilegesCheck = exports.ApiPrivilegesCheck = {
+  meta: {
+    type: 'problem',
+    docs: {
+      description: 'Checks that APIs requiring permissions have proper manifest.toml entries',
+      recommended: true,
+      category: 'API Privileges'
+    },
+    fixable: undefined,
+    schema: []
+  },
+  create(context) {
+    const packageRequirements = new Map();
+    _apiPermissionsNeeded.API_PRIV_NEEDED.forEach(req => {
+      packageRequirements.set(req.packageName, req);
+    });
+    return {
+      ImportDeclaration(node) {
+        const importSource = node.source.value;
+        const requirement = packageRequirements.get(importSource);
+        if (requirement) {
+          // Check needs privileges first (higher priority)
+          if (requirement.needsPrivilege.length > 0) {
+            const hasAnyNeedsPrivilege = requirement.needsPrivilege.some(privilege => (0, _manifestHelper.checkManifestForPrivilege)(privilege, 'needs'));
+            if (!hasAnyNeedsPrivilege) {
+              // Report error with the first privilege as example
+              context.report({
+                node,
+                message: `Using the APIs in ${importSource} requires the [[needs.privilege]] id="${requirement.needsPrivilege[0]}" entry in the Vega manifest.toml. Please see the Vega documentation for more information.`
+              });
+            }
+          } else if (requirement.wantsPrivilege.length > 0) {
+            // Only check wants privileges if no needs privileges are defined
+            const hasAnyWantsPrivilege = requirement.wantsPrivilege.some(privilege => (0, _manifestHelper.checkManifestForPrivilege)(privilege, 'wants'));
+            if (!hasAnyWantsPrivilege) {
+              // Report error with the first privilege as example
+              context.report({
+                node,
+                message: `Using the APIs in ${importSource} requires the [[wants.privilege]] id="${requirement.wantsPrivilege[0]}" entry in the Vega manifest.toml. Please see the Vega documentation for more information.`
+              });
+            }
+          }
+        }
+      }
+    };
+  }
+};

package/dist/rules/apiPrivileges/apiPermissionsNeeded.js

@@ -0,0 +1,58 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.API_PRIV_NEEDED = void 0;
+// Copyright 2025 Amazon.com, Inc. or its affiliates. All rights reserved.
+// AMAZON PROPRIETARY/CONFIDENTIAL
+// You may not use this file except in compliance with the terms and conditions
+// set forth in the accompanying LICENSE.TXT file.
+// THESE MATERIALS ARE PROVIDED ON AN "AS IS" BASIS. AMAZON SPECIFICALLY
+// DISCLAIMS, WITH RESPECT TO THESE MATERIALS, ALL WARRANTIES, EXPRESS,
+// IMPLIED, OR STATUTORY, INCLUDING THE IMPLIED WARRANTIES OF MERCHANTABILITY,
+// FITNESS FOR A PARTICULAR PURPOSE, AND NON-INFRINGEMENT.
+
+// Add APIs here that require privileges.
+
+const API_PRIV_NEEDED = exports.API_PRIV_NEEDED = [{
+  packageName: '@amazon-devices/kepler-amazon-device-messaging',
+  needsPrivilege: ['com.amazon.device-messaging.privilege.access'],
+  wantsPrivilege: [],
+  requiresUserPrompt: false
+}, {
+  packageName: '@amazon-devices/kepler-amazon-device-messaging',
+  needsPrivilege: ['com.amazon.device-messaging.privilege.access'],
+  wantsPrivilege: [],
+  requiresUserPrompt: false
+}, {
+  packageName: '@amazon-devices/keplerscript-audio-lib',
+  needsPrivilege: ['com.amazon.audio.privilege.settings.control', 'com.amazon.audio.privilege.microphone.access'],
+  wantsPrivilege: [],
+  requiresUserPrompt: false
+}, {
+  packageName: '@amazon-devices/keplerscript-audio-lib',
+  needsPrivilege: ['com.amazon.audio.privilege.settings.control'],
+  wantsPrivilege: [],
+  requiresUserPrompt: false
+}, {
+  packageName: '@amazon-devices/kepler-identifiers',
+  needsPrivilege: ['com.amazon.devconf.privilege.identifiers.device-friendly-name'],
+  wantsPrivilege: [],
+  requiresUserPrompt: true
+}, {
+  packageName: '@amazon-devices/kepler-identifiers',
+  needsPrivilege: ['com.amazon.devconf.privilege.identifiers.device-friendly-name'],
+  wantsPrivilege: [],
+  requiresUserPrompt: true
+}, {
+  packageName: '@amazon-devices/keplerscript-netmgr-lib',
+  needsPrivilege: [],
+  wantsPrivilege: ['com.amazon.network.privilege.net-info'],
+  requiresUserPrompt: false
+}, {
+  packageName: '@amazon-devices/keplerscript-netmgr-lib',
+  needsPrivilege: [],
+  wantsPrivilege: ['com.amazon.network.privilege.net-info'],
+  requiresUserPrompt: false
+}];

package/dist/rules/apiPrivileges/manifestHelper.js

@@ -0,0 +1,44 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.checkManifestForPrivilege = void 0;
+var fs = _interopRequireWildcard(require("fs"));
+var path = _interopRequireWildcard(require("path"));
+var toml = _interopRequireWildcard(require("toml"));
+function _interopRequireWildcard(e, t) { if ("function" == typeof WeakMap) var r = new WeakMap(), n = new WeakMap(); return (_interopRequireWildcard = function (e, t) { if (!t && e && e.__esModule) return e; var o, i, f = { __proto__: null, default: e }; if (null === e || "object" != typeof e && "function" != typeof e) return f; if (o = t ? n : r) { if (o.has(e)) return o.get(e); o.set(e, f); } for (const t in e) "default" !== t && {}.hasOwnProperty.call(e, t) && ((i = (o = Object.defineProperty) && Object.getOwnPropertyDescriptor(e, t)) && (i.get || i.set) ? o(f, t, i) : f[t] = e[t]); return f; })(e, t); }
+// Copyright 2025 Amazon.com, Inc. or its affiliates. All rights reserved.
+// AMAZON PROPRIETARY/CONFIDENTIAL
+// You may not use this file except in compliance with the terms and conditions
+// set forth in the accompanying LICENSE.TXT file.
+// THESE MATERIALS ARE PROVIDED ON AN "AS IS" BASIS. AMAZON SPECIFICALLY
+// DISCLAIMS, WITH RESPECT TO THESE MATERIALS, ALL WARRANTIES, EXPRESS,
+// IMPLIED, OR STATUTORY, INCLUDING THE IMPLIED WARRANTIES OF MERCHANTABILITY,
+// FITNESS FOR A PARTICULAR PURPOSE, AND NON-INFRINGEMENT.
+
+/**
+ * Checks if the manifest.toml contains the required privilege in the specified section
+ */
+const checkManifestForPrivilege = (privilege, section) => {
+  try {
+    const manifestPath = path.join(process.cwd(), 'manifest.toml');
+    if (!fs.existsSync(manifestPath)) {
+      return false;
+    }
+    const manifestContent = fs.readFileSync(manifestPath, 'utf8');
+    const manifest = toml.parse(manifestContent);
+    if (!manifest[section] || !Array.isArray(manifest[section].privilege)) {
+      return false;
+    }
+    return manifest[section].privilege.some(entry => {
+      if (typeof entry === 'object' && entry.id === privilege) {
+        return true;
+      }
+      return false;
+    });
+  } catch (e) {
+    return false;
+  }
+};
+exports.checkManifestForPrivilege = checkManifestForPrivilege;

package/dist/rules/backwardCompatibility/BackwardCompatibility.js

@@ -0,0 +1,119 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.BackwardCompatibility = void 0;
+var fs = _interopRequireWildcard(require("fs"));
+var path = _interopRequireWildcard(require("path"));
+var _RuleUtils = require("../../utils/RuleUtils");
+function _interopRequireWildcard(e, t) { if ("function" == typeof WeakMap) var r = new WeakMap(), n = new WeakMap(); return (_interopRequireWildcard = function (e, t) { if (!t && e && e.__esModule) return e; var o, i, f = { __proto__: null, default: e }; if (null === e || "object" != typeof e && "function" != typeof e) return f; if (o = t ? n : r) { if (o.has(e)) return o.get(e); o.set(e, f); } for (const t in e) "default" !== t && {}.hasOwnProperty.call(e, t) && ((i = (o = Object.defineProperty) && Object.getOwnPropertyDescriptor(e, t)) && (i.get || i.set) ? o(f, t, i) : f[t] = e[t]); return f; })(e, t); }
+// Copyright 2025 Amazon.com, Inc. or its affiliates. All rights reserved.
+// AMAZON PROPRIETARY/CONFIDENTIAL
+// You may not use this file except in compliance with the terms and conditions
+// set forth in the accompanying LICENSE.TXT file.
+// THESE MATERIALS ARE PROVIDED ON AN "AS IS" BASIS. AMAZON SPECIFICALLY
+// DISCLAIMS, WITH RESPECT TO THESE MATERIALS, ALL WARRANTIES, EXPRESS,
+// IMPLIED, OR STATUTORY, INCLUDING THE IMPLIED WARRANTIES OF MERCHANTABILITY,
+// FITNESS FOR A PARTICULAR PURPOSE, AND NON-INFRINGEMENT.
+
+/**
+ * Gets the location of the version field in package.json for error reporting
+ */
+// eslint-disable-next-line @typescript-eslint/no-explicit-any
+const getVersionFieldLocation = sourceCode => {
+  const text = sourceCode.getText();
+  const versionMatch = text.match(/"version"\s*:\s*"[^"]*"/);
+  if (versionMatch) {
+    const start = text.indexOf(versionMatch[0]);
+    const startPos = sourceCode.getLocFromIndex(start);
+    const endPos = sourceCode.getLocFromIndex(start + versionMatch[0].length);
+    return {
+      start: startPos,
+      end: endPos
+    };
+  }
+  return {
+    start: {
+      line: 1,
+      column: 0
+    },
+    end: {
+      line: 1,
+      column: 0
+    }
+  };
+};
+
+/**
+ * Checks for backward compatibility issues in Vega system distributed library projects
+ */
+const BackwardCompatibility = exports.BackwardCompatibility = {
+  meta: {
+    type: 'problem',
+    docs: {
+      description: 'Checks for backward compatibility issues in Kepler projects',
+      recommended: true,
+      category: 'Backward Compatibility'
+    },
+    schema: []
+  },
+  create(context) {
+    return {
+      Program() {
+        // do nothing if not in a Brazil repo and/or this isn't a library
+        if (!(0, _RuleUtils.isBrazilRepo)() || !(0, _RuleUtils.isSDLProject)()) {
+          return;
+        }
+
+        // Use modern context.filename with fallback to deprecated context.getFilename()
+        const filename = context.filename || context.getFilename();
+        if (!filename.endsWith('package.json')) {
+          return;
+        }
+
+        // Use modern context.sourceCode with fallback to deprecated context.getSourceCode()
+        const sourceCode = context.sourceCode || context.getSourceCode();
+        const text = sourceCode.getText();
+        try {
+          const packageJson = JSON.parse(text);
+          const projectRoot = process.cwd();
+          const compatibilityFilePath = path.join(projectRoot, 'kepler-compatibility.json');
+          if (!fs.existsSync(compatibilityFilePath)) {
+            context.report({
+              node: sourceCode.ast,
+              message: 'You project is missing a kepler-compatibility.json file. This file is required for Vega library development. Please add it.',
+              loc: getVersionFieldLocation(sourceCode)
+            });
+            return;
+          }
+          try {
+            const compatibilityContent = fs.readFileSync(compatibilityFilePath, 'utf8');
+            const compatibilityData = JSON.parse(compatibilityContent);
+            const supportedVersions = Object.keys(compatibilityData.versions || {});
+            const currentVersion = packageJson.version;
+            if (currentVersion && !supportedVersions.includes(currentVersion)) {
+              context.report({
+                node: sourceCode.ast,
+                message: `This version of the library (${currentVersion}) is not found in the kepler-compatibility.json. Please add an entry for this version.`,
+                loc: getVersionFieldLocation(sourceCode)
+              });
+            }
+          } catch {
+            // If kepler-compatibility.json exists but is malformed, treat as version not found
+            const currentVersion = packageJson.version;
+            if (currentVersion) {
+              context.report({
+                node: sourceCode.ast,
+                message: `This version of the library (${currentVersion}) is not found in the kepler-compatibility.json (JSON is malformed).`,
+                loc: getVersionFieldLocation(sourceCode)
+              });
+            }
+          }
+        } catch {
+          // Ignore JSON parsing errors for package.json. Linting will be unreliable anyway.
+        }
+      }
+    };
+  }
+};