Load package.json on init-linter

package.json

@@ -102,6 +102,7 @@
  "scslre": "0.2.0",
  "stylelint": "15.10.0",
  "tmp": "0.2.1",
+ "type-fest": "4.6.0",
  "typescript": "5.1.6",
  "vue-eslint-parser": "9.3.0",
  "yaml": "2.3.1"

packages/bridge/src/worker.js

@@ -29,6 +29,7 @@ const {
  deleteProgram,
  initializeLinter,
  writeTSConfigFile,
+ initPackageJsons,
 } = require('@sonar/jsts');
 const { readFile, setContext } = require('@sonar/shared/helpers');
 const { analyzeCSS } = require('@sonar/css');
@@ -136,8 +137,9 @@ if (parentPort) {
  }
 
  case 'on-init-linter': {
- const { rules, environments, globals, linterId } = data;
+ const { rules, environments, globals, linterId, baseDir } = data;
  initializeLinter(rules, environments, globals, linterId);
+ await initPackageJsons(baseDir);
  parentThread.postMessage({ type: 'success', result: 'OK!' });
  break;
  }

packages/jsts/src/builders/build.ts

@@ -22,6 +22,7 @@ import { JsTsAnalysisInput } from '../analysis';
 import { buildParserOptions, parseForESLint, parsers } from '../parsers';
 import { getProgramById } from '../program';
 import { Linter } from 'eslint';
+import { getNearestPackageJson } from '../dependencies';
 
 /**
  * Builds an ESLint SourceCode for JavaScript / TypeScript
@@ -35,6 +36,7 @@ import { Linter } from 'eslint';
  */
 export function buildSourceCode(input: JsTsAnalysisInput, language: JsTsLanguage) {
  const vueFile = isVueFile(input.filePath);
+ const packageJson = getNearestPackageJson(input.filePath);
 
  if (shouldUseTypescriptParser(language)) {
  const options: Linter.ParserOptions = {
@@ -51,6 +53,7 @@ export function buildSourceCode(input: JsTsAnalysisInput, language: JsTsLanguage
  input.fileContent,
  vueFile ? parsers.vuejs.parse : parsers.typescript.parse,
  buildParserOptions(options, false),
+ packageJson?.contents,
  );
  } catch (error) {
  debug(`Failed to parse ${input.filePath} with TypeScript parser: ${error.message}`);
@@ -66,6 +69,7 @@ export function buildSourceCode(input: JsTsAnalysisInput, language: JsTsLanguage
  input.fileContent,
  vueFile ? parsers.vuejs.parse : parsers.javascript.parse,
  buildParserOptions({ parser: vueFile ? parsers.javascript.parser : undefined }, true),
+ packageJson?.contents,
  );
  } catch (error) {
  debug(`Failed to parse ${input.filePath} with Javascript parser: ${error.message}`);
@@ -80,6 +84,7 @@ export function buildSourceCode(input: JsTsAnalysisInput, language: JsTsLanguage
  input.fileContent,
  parsers.javascript.parse,
  buildParserOptions({ sourceType: 'script' }, true),
+ packageJson?.contents,
  );
  } catch (error) {
  debug(

packages/jsts/src/dependencies/index.ts

@@ -0,0 +1,20 @@
+/*
+ * SonarQube JavaScript Plugin
+ * Copyright (C) 2011-2023 SonarSource SA
+ * mailto:info AT sonarsource DOT com
+ *
+ * This program is free software; you can redistribute it and/or
+ * modify it under the terms of the GNU Lesser General Public
+ * License as published by the Free Software Foundation; either
+ * version 3 of the License, or (at your option) any later version.
+ *
+ * This program is distributed in the hope that it will be useful,
+ * but WITHOUT ANY WARRANTY; without even the implied warranty of
+ * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
+ * Lesser General Public License for more details.
+ *
+ * You should have received a copy of the GNU Lesser General Public License
+ * along with this program; if not, write to the Free Software Foundation,
+ * Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA.
+ */
+export * from './package-json';

packages/jsts/src/dependencies/package-json/index.ts

@@ -0,0 +1,39 @@
+/*
+ * SonarQube JavaScript Plugin
+ * Copyright (C) 2011-2023 SonarSource SA
+ * mailto:info AT sonarsource DOT com
+ *
+ * This program is free software; you can redistribute it and/or
+ * modify it under the terms of the GNU Lesser General Public
+ * License as published by the Free Software Foundation; either
+ * version 3 of the License, or (at your option) any later version.
+ *
+ * This program is distributed in the hope that it will be useful,
+ * but WITHOUT ANY WARRANTY; without even the implied warranty of
+ * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
+ * Lesser General Public License for more details.
+ *
+ * You should have received a copy of the GNU Lesser General Public License
+ * along with this program; if not, write to the Free Software Foundation,
+ * Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA.
+ */
+
+import { PackageJsons, PackageJson } from './project-package-json';
+
+const PackageJsonsByBaseDir = new PackageJsons();
+
+async function initPackageJsons(baseDir?: string) {
+ if (baseDir) {
+ await PackageJsonsByBaseDir.packageJsonLookup(baseDir);
+ }
+}
+
+function getNearestPackageJson(file: string): PackageJson | undefined {
+ return PackageJsonsByBaseDir.getPackageJsonForFile(file);
+}
+
+function getAllPackageJsons() {
+ return PackageJsonsByBaseDir.db;
+}
+
+export { initPackageJsons, getNearestPackageJson, getAllPackageJsons };

packages/jsts/src/dependencies/package-json/project-package-json.ts

@@ -0,0 +1,80 @@
+/*
+ * SonarQube JavaScript Plugin
+ * Copyright (C) 2011-2023 SonarSource SA
+ * mailto:info AT sonarsource DOT com
+ *
+ * This program is free software; you can redistribute it and/or
+ * modify it under the terms of the GNU Lesser General Public
+ * License as published by the Free Software Foundation; either
+ * version 3 of the License, or (at your option) any later version.
+ *
+ * This program is distributed in the hope that it will be useful,
+ * but WITHOUT ANY WARRANTY; without even the implied warranty of
+ * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
+ * Lesser General Public License for more details.
+ *
+ * You should have received a copy of the GNU Lesser General Public License
+ * along with this program; if not, write to the Free Software Foundation,
+ * Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA.
+ */
+import fs from 'node:fs/promises';
+import path from 'path';
+import { toUnixPath, debug } from '@sonar/shared/helpers';
+import { PackageJson as PJ } from 'type-fest';
+
+const PACKAGE_JSON = 'package.json';
+const IGNORED_DIRS = ['node_modules', '.scannerwork'];
+
+export interface PackageJson {
+ filename: string;
+ contents: PJ;
+}
+
+export class PackageJsons {
+ public db: Map<string, PackageJson>;
+ constructor() {
+ this.db = new Map();
+ }
+
+ /**
+ * Look for package.json files in a given path and its child paths.
+ * node_modules is ignored
+ *
+ * @param dir parent folder where the search starts
+ */
+ async packageJsonLookup(dir: string) {
+ dir = path.posix.normalize(toUnixPath(dir));
+ try {
+ const files = await fs.readdir(dir, { withFileTypes: true });
+ for (const file of files) {
+ const filename = path.posix.join(dir, file.name);
+ if (file.isDirectory() && !IGNORED_DIRS.includes(file.name)) {
+ await this.packageJsonLookup(filename);
+ } else if (file.name.toLowerCase() === PACKAGE_JSON && !file.isDirectory()) {
+ debug(`package.json found: ${filename}`);
+ const contents = JSON.parse(await fs.readFile(filename, 'utf-8'));
+ this.db.set(dir, { filename, contents });
+ }
+ }
+ } catch (e) {
+ debug(`ERROR: Failed package.json file search: ${e}`);
+ }
+ }
+
+ /**
+ * Given a filename, find the nearest package.json
+ *
+ * @param file source file for which we need a package.json
+ */
+ getPackageJsonForFile(file: string) {
+ let currentDir = path.posix.dirname(toUnixPath(file));
+ do {
+ const packageJson = this.db.get(currentDir);
+ if (packageJson) {
+ return packageJson;
+ }
+ currentDir = path.posix.dirname(currentDir);
+ } while (currentDir !== path.posix.dirname(currentDir));
+ return undefined;
+ }
+}

packages/jsts/src/index.ts

@@ -19,6 +19,7 @@
  */
 export * from './analysis';
 export * from './builders';
+export * from './dependencies';
 export * from './linter';
 export * from './parsers';
 export * from './program';

packages/jsts/src/parsers/parse.ts

@@ -20,21 +20,30 @@
 import { APIError } from '@sonar/shared/errors';
 import { SourceCode } from 'eslint';
 import { ParseFunction } from './eslint';
+import { PackageJson } from 'type-fest';
 
 /**
  * Parses a JavaScript / TypeScript analysis input with an ESLint-based parser
  * @param code the JavaScript / TypeScript code to parse
  * @param parse the ESLint parsing function to use for parsing
  * @param options the ESLint parser options
+ * @param packageJson package.json contents containing dependencies
  * @returns the parsed source code
  */
-export function parseForESLint(code: string, parse: ParseFunction, options: {}): SourceCode {
+export function parseForESLint(
+ code: string,
+ parse: ParseFunction,
+ options: {},
+ packageJson?: PackageJson,
+): SourceCode {
  try {
  const result = parse(code, options);
+ const parserServices = result.services || {};
+ parserServices.packageJson = packageJson;
  return new SourceCode({
  ...result,
  text: code,
- parserServices: result.services,
+ parserServices,
  });
  } catch ({ lineNumber, message }) {
  if (message.startsWith('Debug Failure')) {

packages/jsts/tests/analysis/analyzer.test.ts

@@ -25,12 +25,14 @@ import {
  analyzeJSTS,
  JsTsAnalysisOutput,
  createAndSaveProgram,
+ initPackageJsons,
 } from '../../src';
 import { APIError } from '@sonar/shared/errors';
-import { jsTsInput } from '../tools';
-
+import { jsTsInput, parseJavaScriptSourceFile } from '../tools';
+import { Linter, Rule } from 'eslint';
 describe('analyzeJSTS', () => {
  beforeEach(() => {
+ jest.resetModules();
  setContext({
  workDir: '/tmp/dir',
  shouldUseTypeScriptParserForJS: false,
@@ -893,4 +895,38 @@ describe('analyzeJSTS', () => {
  APIError.parsingError('Unexpected token (3:0)', { line: 3 }),
  );
  });
+
+ it('package.json should be available in rule context', async () => {
+ console.log = jest.fn();
+ let ruleExecuted = false;
+
+ const baseDir = path.join(__dirname, 'fixtures', 'package-json');
+ const packageJson = path.join(__dirname, 'fixtures', 'package-json', 'package.json');
+ await initPackageJsons(baseDir);
+ const log = `DEBUG package.json found: ${toUnixPath(packageJson)}`;
+ expect(console.log).toHaveBeenCalledWith(log);
+
+ const linter = new Linter();
+ linter.defineRule('custom-rule-file', {
+ create(context) {
+ return {
+ CallExpression() {
+ console.log('detected call expression');
+ ruleExecuted = true;
+ expect(context.parserServices.packageJson).toBeDefined();
+ expect(context.parserServices.packageJson.name).toEqual('test-module');
+ },
+ };
+ },
+ } as Rule.RuleModule);
+
+ const filePath = path.join(__dirname, 'fixtures', 'package-json', 'custom.js');
+ const sourceCode = await parseJavaScriptSourceFile(filePath);
+ expect(sourceCode.parserServices.packageJson).toBeDefined();
+ expect(sourceCode.parserServices.packageJson.name).toEqual('test-module');
+
+ const options = { filename: filePath, allowInlineConfig: false };
+ linter.verify(sourceCode, { rules: { 'custom-rule-file': 2 } }, options);
+ expect(ruleExecuted).toBeTruthy();
+ });
 });

packages/jsts/tests/analysis/fixtures/package-json/custom.js

@@ -0,0 +1 @@
+foo()

packages/jsts/tests/analysis/fixtures/package-json/package.json

@@ -0,0 +1,5 @@
+{
+ "name": "test-module",
+ "version": "1.0.0",
+ "author": "Your Name <[email protected]>"
+}

packages/jsts/tests/analysis/fixtures/package-json/rule-package-json/package.json

@@ -0,0 +1,5 @@
+{
+ "name": "rule-package-json",
+ "version": "1.0.0",
+ "main": "rules.js"
+}