eslint-plugin-sonarjs 1.0.4 → 2.0.0

package/lib/helpers/lva.js

@@ -0,0 +1,94 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.LiveVariables = exports.lva = void 0;
+function lva(liveVariablesMap) {
+    const worklist = Array.from(liveVariablesMap.values(), lva => lva.segment);
+    while (worklist.length > 0) {
+        const current = worklist.pop();
+        const liveVariables = liveVariablesMap.get(current.id);
+        const liveInHasChanged = liveVariables.propagate(liveVariablesMap);
+        if (liveInHasChanged) {
+            current.prevSegments.forEach(prev => worklist.push(prev));
+        }
+    }
+}
+exports.lva = lva;
+class LiveVariables {
+    constructor(segment) {
+        /**
+         * variables that are being read in the block
+         */
+        this.gen = new Set();
+        /**
+         * variables that are being written in the block
+         */
+        this.kill = new Set();
+        /**
+         * variables needed by this or a successor block and are not killed in this block
+         */
+        this.in = new Set();
+        /**
+         * variables needed by successors
+         */
+        this.out = [];
+        /**
+         * collects references in order they are evaluated, set in JS maintains insertion order
+         */
+        this.references = new Set();
+        this.segment = segment;
+    }
+    add(ref) {
+        const variable = ref.resolved;
+        if (variable) {
+            if (ref.isRead()) {
+                this.gen.add(variable);
+            }
+            if (ref.isWrite()) {
+                this.kill.add(variable);
+            }
+            this.references.add(ref);
+        }
+    }
+    propagate(liveVariablesMap) {
+        const out = [];
+        this.segment.nextSegments.forEach(next => {
+            out.push(...liveVariablesMap.get(next.id).in);
+        });
+        const diff = difference(out, this.kill);
+        this.out = out;
+        if (shouldUpdate(this.in, this.gen, diff)) {
+            this.in = new Set([...this.gen, ...diff]);
+            return true;
+        }
+        else {
+            return false;
+        }
+    }
+}
+exports.LiveVariables = LiveVariables;
+function difference(a, b) {
+    if (b.size === 0) {
+        return a;
+    }
+    const diff = [];
+    for (const e of a) {
+        if (!b.has(e)) {
+            diff.push(e);
+        }
+    }
+    return diff;
+}
+function shouldUpdate(inSet, gen, diff) {
+    for (const e of gen) {
+        if (!inSet.has(e)) {
+            return true;
+        }
+    }
+    for (const e of diff) {
+        if (!inSet.has(e)) {
+            return true;
+        }
+    }
+    return false;
+}
+//# sourceMappingURL=lva.js.map

package/lib/helpers/lva.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"lva.js","sourceRoot":"","sources":["../../helpers/lva.ts"],"names":[],"mappings":"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"}

package/lib/helpers/mocha.d.ts

@@ -0,0 +1,23 @@
+import * as estree from 'estree';
+export declare namespace Mocha {
+    interface TestCase {
+        node: estree.Node;
+        callback: estree.Function;
+    }
+    function isTestConstruct(node: estree.Node, constructs?: string[]): boolean;
+    function extractTestCase(node: estree.Node): TestCase | null;
+    /**
+     * returns true if the node is a test case
+     *
+     * @param node
+     * @returns
+     */
+    function isTestCase(node: estree.Node): boolean;
+    /**
+     * returns true if the node is a describe block
+     *
+     * @param node
+     * @returns
+     */
+    function isDescribeCase(node: estree.Node): boolean;
+}

package/lib/helpers/mocha.js

@@ -0,0 +1,59 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.Mocha = void 0;
+const _1 = require(".");
+var Mocha;
+(function (Mocha) {
+    const TEST_CONSTRUCTS = [
+        'describe',
+        'context',
+        'it',
+        'specify',
+        'before',
+        'after',
+        'beforeEach',
+        'afterEach',
+    ];
+    function isTestConstruct(node, constructs = TEST_CONSTRUCTS) {
+        return constructs.some(construct => {
+            return (node.type === 'CallExpression' &&
+                ((0, _1.isIdentifier)(node.callee, construct) ||
+                    (node.callee.type === 'MemberExpression' &&
+                        (0, _1.isIdentifier)(node.callee.object, construct) &&
+                        (0, _1.isIdentifier)(node.callee.property, 'only', 'skip'))));
+        });
+    }
+    Mocha.isTestConstruct = isTestConstruct;
+    function extractTestCase(node) {
+        if (isTestCase(node)) {
+            const callExpr = node;
+            const [, callback] = callExpr.arguments;
+            if (callback && _1.FUNCTION_NODES.includes(callback.type)) {
+                return { node: callExpr.callee, callback: callback };
+            }
+        }
+        return null;
+    }
+    Mocha.extractTestCase = extractTestCase;
+    /**
+     * returns true if the node is a test case
+     *
+     * @param node
+     * @returns
+     */
+    function isTestCase(node) {
+        return isTestConstruct(node, ['it', 'specify']);
+    }
+    Mocha.isTestCase = isTestCase;
+    /**
+     * returns true if the node is a describe block
+     *
+     * @param node
+     * @returns
+     */
+    function isDescribeCase(node) {
+        return isTestConstruct(node, ['describe']);
+    }
+    Mocha.isDescribeCase = isDescribeCase;
+})(Mocha || (exports.Mocha = Mocha = {}));
+//# sourceMappingURL=mocha.js.map

package/lib/helpers/mocha.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"mocha.js","sourceRoot":"","sources":["../../helpers/mocha.ts"],"names":[],"mappings":";;;AAoBA,wBAAiD;AAEjD,IAAiB,KAAK,CA8DrB;AA9DD,WAAiB,KAAK;IACpB,MAAM,eAAe,GAAG;QACtB,UAAU;QACV,SAAS;QACT,IAAI;QACJ,SAAS;QACT,QAAQ;QACR,OAAO;QACP,YAAY;QACZ,WAAW;KACZ,CAAC;IAOF,SAAgB,eAAe,CAC7B,IAAiB,EACjB,aAAuB,eAAe;QAEtC,OAAO,UAAU,CAAC,IAAI,CAAC,SAAS,CAAC,EAAE;YACjC,OAAO,CACL,IAAI,CAAC,IAAI,KAAK,gBAAgB;gBAC9B,CAAC,IAAA,eAAY,EAAC,IAAI,CAAC,MAAM,EAAE,SAAS,CAAC;oBACnC,CAAC,IAAI,CAAC,MAAM,CAAC,IAAI,KAAK,kBAAkB;wBACtC,IAAA,eAAY,EAAC,IAAI,CAAC,MAAM,CAAC,MAAM,EAAE,SAAS,CAAC;wBAC3C,IAAA,eAAY,EAAC,IAAI,CAAC,MAAM,CAAC,QAAQ,EAAE,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC,CACzD,CAAC;QACJ,CAAC,CAAC,CAAC;IACL,CAAC;IAbe,qBAAe,kBAa9B,CAAA;IAED,SAAgB,eAAe,CAAC,IAAiB;QAC/C,IAAI,UAAU,CAAC,IAAI,CAAC,EAAE,CAAC;YACrB,MAAM,QAAQ,GAAG,IAA6B,CAAC;YAC/C,MAAM,CAAC,EAAE,QAAQ,CAAC,GAAG,QAAQ,CAAC,SAAS,CAAC;YACxC,IAAI,QAAQ,IAAI,iBAAc,CAAC,QAAQ,CAAC,QAAQ,CAAC,IAAI,CAAC,EAAE,CAAC;gBACvD,OAAO,EAAE,IAAI,EAAE,QAAQ,CAAC,MAAM,EAAE,QAAQ,EAAE,QAA2B,EAAE,CAAC;YAC1E,CAAC;QACH,CAAC;QACD,OAAO,IAAI,CAAC;IACd,CAAC;IATe,qBAAe,kBAS9B,CAAA;IAED;;;;;OAKG;IACH,SAAgB,UAAU,CAAC,IAAiB;QAC1C,OAAO,eAAe,CAAC,IAAI,EAAE,CAAC,IAAI,EAAE,SAAS,CAAC,CAAC,CAAC;IAClD,CAAC;IAFe,gBAAU,aAEzB,CAAA;IAED;;;;;OAKG;IACH,SAAgB,cAAc,CAAC,IAAiB;QAC9C,OAAO,eAAe,CAAC,IAAI,EAAE,CAAC,UAAU,CAAC,CAAC,CAAC;IAC7C,CAAC;IAFe,oBAAc,iBAE7B,CAAA;AACH,CAAC,EA9DgB,KAAK,qBAAL,KAAK,QA8DrB"}

package/lib/helpers/module.d.ts

@@ -0,0 +1,52 @@
+import { Rule, Scope } from 'eslint';
+import * as estree from 'estree';
+import Variable = Scope.Variable;
+export declare function getImportDeclarations(context: Rule.RuleContext): estree.ImportDeclaration[];
+export declare function getRequireCalls(context: Rule.RuleContext): estree.CallExpression[];
+/**
+ * Returns the fully qualified name of ESLint node
+ *
+ * This function filters out the `node:` prefix
+ *
+ * A fully qualified name here denotes a value that is accessed through an imported
+ * symbol, e.g., `foo.bar.baz` where `foo` was imported either from a require call
+ * or an import statement:
+ *
+ * ```
+ * const foo = require('lib');
+ * foo.bar.baz.qux; // matches the fully qualified name 'lib.bar.baz.qux' (not 'foo.bar.baz.qux')
+ * const foo2 = require('lib').bar;
+ * foo2.baz.qux; // matches the fully qualified name 'lib.bar.baz.qux'
+ * ```
+ *
+ * Returns null when an FQN could not be found.
+ *
+ * @param context the rule context
+ * @param node the node
+ * @param fqn the already traversed FQN (for recursive calls)
+ * @param scope scope to look for the variable definition, used in recursion not to
+ *              loop over same variable always in the lower scope
+ */
+export declare function getFullyQualifiedName(context: Rule.RuleContext, node: estree.Node, fqn?: string[], scope?: Scope.Scope): string | null;
+/**
+ * Just like getFullyQualifiedName(), but does not filter out the `node:` prefix.
+ *
+ * To be used for rules that need to work with the `node:` prefix.
+ */
+export declare function getFullyQualifiedNameRaw(context: Rule.RuleContext, node: estree.Node, fqn: string[], scope?: Scope.Scope, visitedVars?: Variable[]): string | null;
+/**
+ * Helper function for getFullyQualifiedName to handle Member expressions
+ * filling in the FQN array with the accessed properties.
+ * @param node the Node to traverse
+ * @param fqn the array with the qualifiers
+ */
+export declare function reduceToIdentifier(node: estree.Node, fqn?: string[]): estree.Node;
+/**
+ * Reduce a given node through its ancestors until a given node type is found
+ * filling in the FQN array with the accessed properties.
+ * @param type the type of node you are looking for to be returned. Returned node still needs to be
+ *             checked as its type it's not guaranteed to match the passed type.
+ * @param node the Node to traverse
+ * @param fqn the array with the qualifiers
+ */
+export declare function reduceTo<T extends estree.Node['type']>(type: T, node: estree.Node, fqn?: string[]): estree.Node;

package/lib/helpers/module.js

@@ -0,0 +1,268 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.reduceTo = exports.reduceToIdentifier = exports.getFullyQualifiedNameRaw = exports.getFullyQualifiedName = exports.getRequireCalls = exports.getImportDeclarations = void 0;
+const ast_1 = require("./ast");
+function getImportDeclarations(context) {
+    const program = context.sourceCode.ast;
+    if (program.sourceType === 'module') {
+        return program.body.filter(node => node.type === 'ImportDeclaration');
+    }
+    return [];
+}
+exports.getImportDeclarations = getImportDeclarations;
+function getRequireCalls(context) {
+    const required = [];
+    const { scopeManager } = context.sourceCode;
+    scopeManager.scopes.forEach(scope => scope.variables.forEach(variable => variable.defs.forEach(def => {
+        if (def.type === 'Variable' && def.node.init) {
+            if (isRequire(def.node.init)) {
+                required.push(def.node.init);
+            }
+            else if (def.node.init.type === 'MemberExpression' && isRequire(def.node.init.object)) {
+                required.push(def.node.init.object);
+            }
+        }
+    })));
+    return required;
+}
+exports.getRequireCalls = getRequireCalls;
+function isRequire(node) {
+    return (node.type === 'CallExpression' &&
+        node.callee.type === 'Identifier' &&
+        node.callee.name === 'require' &&
+        node.arguments.length === 1);
+}
+/**
+ * Returns 'module' if `node` is a `require('module')` CallExpression
+ *
+ * For usage inside rules, prefer getFullyQualifiedName()
+ *
+ * @param node
+ * @returns the module name or undefined
+ */
+function getModuleNameFromRequire(node) {
+    if (isRequire(node)) {
+        const moduleName = node.arguments[0];
+        if (moduleName.type === 'Literal') {
+            return moduleName;
+        }
+    }
+    return undefined;
+}
+/**
+ * Returns the fully qualified name of ESLint node
+ *
+ * This function filters out the `node:` prefix
+ *
+ * A fully qualified name here denotes a value that is accessed through an imported
+ * symbol, e.g., `foo.bar.baz` where `foo` was imported either from a require call
+ * or an import statement:
+ *
+ * ```
+ * const foo = require('lib');
+ * foo.bar.baz.qux; // matches the fully qualified name 'lib.bar.baz.qux' (not 'foo.bar.baz.qux')
+ * const foo2 = require('lib').bar;
+ * foo2.baz.qux; // matches the fully qualified name 'lib.bar.baz.qux'
+ * ```
+ *
+ * Returns null when an FQN could not be found.
+ *
+ * @param context the rule context
+ * @param node the node
+ * @param fqn the already traversed FQN (for recursive calls)
+ * @param scope scope to look for the variable definition, used in recursion not to
+ *              loop over same variable always in the lower scope
+ */
+function getFullyQualifiedName(context, node, fqn = [], scope) {
+    return removeNodePrefixIfExists(getFullyQualifiedNameRaw(context, node, fqn, scope));
+}
+exports.getFullyQualifiedName = getFullyQualifiedName;
+/**
+ * Just like getFullyQualifiedName(), but does not filter out the `node:` prefix.
+ *
+ * To be used for rules that need to work with the `node:` prefix.
+ */
+function getFullyQualifiedNameRaw(context, node, fqn, scope, visitedVars = []) {
+    const nodeToCheck = reduceToIdentifier(node, fqn);
+    if (!(0, ast_1.isIdentifier)(nodeToCheck)) {
+        // require chaining, e.g. `require('lib')()` or `require('lib').prop()`
+        if (node.type === 'CallExpression') {
+            const qualifiers = [];
+            const maybeRequire = reduceTo('CallExpression', node.callee, qualifiers);
+            const module = getModuleNameFromRequire(maybeRequire);
+            if (typeof module?.value === 'string') {
+                qualifiers.unshift(module.value);
+                return qualifiers.join('.');
+            }
+        }
+        return null;
+    }
+    const variable = (0, ast_1.getVariableFromScope)(scope ?? context.sourceCode.getScope(node), nodeToCheck.name);
+    if (!variable || variable.defs.length > 1) {
+        return null;
+    }
+    // built-in variable
+    // ESLint marks built-in global variables with an undocumented hidden `writeable` property that should equal `false`.
+    // @see https://github.com/eslint/eslint/blob/6380c87c563be5dc78ce0ddd5c7409aaf71692bb/lib/linter/linter.js#L207
+    // @see https://github.com/eslint/eslint/blob/6380c87c563be5dc78ce0ddd5c7409aaf71692bb/lib/rules/no-global-assign.js#L81
+    if (variable.writeable === false || visitedVars.includes(variable)) {
+        fqn.unshift(nodeToCheck.name);
+        return fqn.join('.');
+    }
+    const definition = variable.defs.find(({ type }) => ['ImportBinding', 'Variable'].includes(type));
+    if (!definition) {
+        return null;
+    }
+    // imports
+    const fqnFromImport = checkFqnFromImport(variable, definition, context, fqn, visitedVars);
+    if (fqnFromImport !== null) {
+        return fqnFromImport;
+    }
+    // requires
+    const fqnFromRequire = checkFqnFromRequire(variable, definition, context, fqn, visitedVars);
+    if (fqnFromRequire !== null) {
+        return fqnFromRequire;
+    }
+    return null;
+}
+exports.getFullyQualifiedNameRaw = getFullyQualifiedNameRaw;
+function checkFqnFromImport(variable, definition, context, fqn, visitedVars) {
+    if (definition.type === 'ImportBinding') {
+        const specifier = definition.node;
+        const importDeclaration = definition.parent;
+        // import {default as cdk} from 'aws-cdk-lib';
+        // vs.
+        // import { aws_s3 as s3 } from 'aws-cdk-lib';
+        if (specifier.type === 'ImportSpecifier' && specifier.imported?.name !== 'default') {
+            fqn.unshift(specifier.imported?.name);
+        }
+        if (typeof importDeclaration.source?.value === 'string') {
+            const importedQualifiers = importDeclaration.source.value.split('/');
+            fqn.unshift(...importedQualifiers);
+            return fqn.join('.');
+        }
+        // import s3 = require('aws-cdk-lib/aws-s3');
+        if (importDeclaration.type === 'TSImportEqualsDeclaration') {
+            const importedModule = importDeclaration
+                .moduleReference;
+            if (importedModule.type === 'TSExternalModuleReference' &&
+                importedModule.expression.type === 'Literal' &&
+                typeof importedModule.expression.value === 'string') {
+                const importedQualifiers = importedModule.expression.value.split('/');
+                fqn.unshift(...importedQualifiers);
+                return fqn.join('.');
+            }
+            //import s3 = cdk.aws_s3;
+            if (importedModule.type === 'TSQualifiedName') {
+                visitedVars.push(variable);
+                return getFullyQualifiedNameRaw(context, importedModule, fqn, variable.scope, visitedVars);
+            }
+        }
+    }
+    return null;
+}
+function checkFqnFromRequire(variable, definition, context, fqn, visitedVars) {
+    const value = (0, ast_1.getUniqueWriteReference)(variable);
+    // requires
+    if (definition.type === 'Variable' && value) {
+        // case for `const {Bucket} = require('aws-cdk-lib/aws-s3');`
+        // case for `const {Bucket: foo} = require('aws-cdk-lib/aws-s3');`
+        if (definition.node.id.type === 'ObjectPattern') {
+            for (const property of definition.node.id.properties) {
+                if (property.value === definition.name) {
+                    fqn.unshift(property.key.name);
+                }
+            }
+        }
+        const nodeToCheck = reduceTo('CallExpression', value, fqn);
+        const module = getModuleNameFromRequire(nodeToCheck)?.value;
+        if (typeof module === 'string') {
+            const importedQualifiers = module.split('/');
+            fqn.unshift(...importedQualifiers);
+            return fqn.join('.');
+        }
+        else {
+            visitedVars.push(variable);
+            return getFullyQualifiedNameRaw(context, nodeToCheck, fqn, variable.scope, visitedVars);
+        }
+    }
+    return null;
+}
+/**
+ * Removes `node:` prefix if such exists
+ *
+ * Node.js builtin modules can be referenced with a `node:` prefix (eg.: node:fs/promises)
+ *
+ * https://nodejs.org/api/esm.html#node-imports
+ *
+ * @param fqn Fully Qualified Name (ex.: `node:https.request`)
+ * @returns `fqn` sanitized from `node:` prefix (ex.: `https.request`)
+ */
+function removeNodePrefixIfExists(fqn) {
+    if (fqn === null) {
+        return null;
+    }
+    const NODE_NAMESPACE = 'node:';
+    if (fqn.startsWith(NODE_NAMESPACE)) {
+        return fqn.substring(NODE_NAMESPACE.length);
+    }
+    return fqn;
+}
+/**
+ * Helper function for getFullyQualifiedName to handle Member expressions
+ * filling in the FQN array with the accessed properties.
+ * @param node the Node to traverse
+ * @param fqn the array with the qualifiers
+ */
+function reduceToIdentifier(node, fqn = []) {
+    return reduceTo('Identifier', node, fqn);
+}
+exports.reduceToIdentifier = reduceToIdentifier;
+/**
+ * Reduce a given node through its ancestors until a given node type is found
+ * filling in the FQN array with the accessed properties.
+ * @param type the type of node you are looking for to be returned. Returned node still needs to be
+ *             checked as its type it's not guaranteed to match the passed type.
+ * @param node the Node to traverse
+ * @param fqn the array with the qualifiers
+ */
+function reduceTo(type, node, fqn = []) {
+    let nodeToCheck = node;
+    while (nodeToCheck.type !== type) {
+        if (nodeToCheck.type === 'MemberExpression') {
+            const { property } = nodeToCheck;
+            if (property.type === 'Literal' && typeof property.value === 'string') {
+                fqn.unshift(property.value);
+            }
+            else if (property.type === 'Identifier') {
+                fqn.unshift(property.name);
+            }
+            nodeToCheck = nodeToCheck.object;
+        }
+        else if (nodeToCheck.type === 'CallExpression' && !getModuleNameFromRequire(nodeToCheck)) {
+            nodeToCheck = nodeToCheck.callee;
+        }
+        else if (nodeToCheck.type === 'NewExpression') {
+            nodeToCheck = nodeToCheck.callee;
+        }
+        else if (nodeToCheck.type === 'ChainExpression') {
+            nodeToCheck = nodeToCheck.expression;
+        }
+        else if (nodeToCheck.type === 'TSNonNullExpression') {
+            // we should migrate to use only TSESTree types everywhere to avoid casting
+            nodeToCheck = nodeToCheck
+                .expression;
+        }
+        else if (nodeToCheck.type === 'TSQualifiedName') {
+            const qualified = nodeToCheck;
+            fqn.unshift(qualified.right.name);
+            nodeToCheck = qualified.left;
+        }
+        else {
+            break;
+        }
+    }
+    return nodeToCheck;
+}
+exports.reduceTo = reduceTo;
+//# sourceMappingURL=module.js.map

package/lib/helpers/module.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"module.js","sourceRoot":"","sources":["../../helpers/module.ts"],"names":[],"mappings":"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"}

package/lib/helpers/package-json.d.ts

@@ -0,0 +1,23 @@
+import { PackageJson } from 'type-fest';
+import { File } from './find-files';
+export declare const PACKAGE_JSON = "package.json";
+export declare const parsePackageJson: (_filename: string, contents: string | null) => PackageJson;
+export declare function loadPackageJsons(baseDir: string, exclusions: string[]): void;
+export declare function getAllPackageJsons(): Record<string, File<PackageJson>[]>;
+export declare function getPackageJsonsCount(): number;
+export declare function clearPackageJsons(): void;
+export declare function setPackageJsons(db: Record<string, File<PackageJson>[]>): void;
+/**
+ * Retrieve the dependencies of all the package.json files available for the given file.
+ *
+ * @param fileName context.filename
+ * @returns
+ */
+export declare function getDependencies(fileName: string): Set<string>;
+/**
+ * Given a filename, return all package.json files in the ancestor paths
+ * ordered from nearest to furthest
+ *
+ * @param file source file for which we need a package.json
+ */
+export declare function getNearestPackageJsons(file: string): File<PackageJson>[];