JS-493 Add 'get-telemetry' endpoint on bridge-server

packages/bridge/src/handle-request.ts

@@ -16,7 +16,7 @@
  */
 import { analyzeCSS } from '../../css/src/analysis/analyzer.js';
 import { analyzeHTML } from '../../html/src/index.js';
-import { analyzeJSTS } from '../../jsts/src/analysis/analyzer.js';
+import { analyzeJSTS, getTelemetry } from '../../jsts/src/analysis/analyzer.js';
 import { analyzeProject } from '../../jsts/src/analysis/projectAnalysis/projectAnalyzer.js';
 import { analyzeYAML } from '../../yaml/src/index.js';
 import { logHeapStatistics } from './memory.js';
@@ -107,6 +107,10 @@ export async function handleRequest(request: BridgeRequest): Promise<RequestResu
         const output = await analyzeProject(request.data);
         return { type: 'success', result: output };
       }
+      case 'on-get-telemetry': {
+        const output = getTelemetry();
+        return { type: 'success', result: output };
+      }
     }
   } catch (err) {
     return { type: 'failure', error: serializeError(err) };

packages/bridge/src/request.ts

@@ -23,17 +23,22 @@ import { TsConfigJson } from 'type-fest';
 import { RuleConfig } from '../../jsts/src/linter/config/rule-config.js';
 import { readFile } from '../../shared/src/helpers/files.js';
 import { APIError, ErrorCode } from '../../shared/src/errors/error.js';
+import { NamedDependency } from '../../jsts/src/rules/index.js';
 
 export type RequestResult =
   | {
       type: 'success';
-      result: string | AnalysisOutput;
+      result: string | AnalysisOutput | Telemetry;
     }
   | {
       type: 'failure';
       error: ReturnType<typeof serializeError>;
     };
 
+export type Telemetry = {
+  dependencies: NamedDependency[];
+};
+
 export type RequestType = BridgeRequest['type'];
 
 type MaybeIncompleteCssAnalysisInput = Omit<CssAnalysisInput, 'fileContent'> & {
@@ -61,7 +66,8 @@ export type BridgeRequest =
   | DeleteProgramRequest
   | InitLinterRequest
   | NewTsConfigRequest
-  | TsConfigFilesRequest;
+  | TsConfigFilesRequest
+  | GetTelemetryRequest;
 
 type CssRequest = {
   type: 'on-analyze-css';
@@ -115,6 +121,9 @@ type TsConfigFilesRequest = {
   type: 'on-tsconfig-files';
   data: { tsConfig: string };
 };
+type GetTelemetryRequest = {
+  type: 'on-get-telemetry';
+};
 
 /**
  * In SonarQube context, an analysis input includes both path and content of a file

packages/bridge/src/router.ts

@@ -36,6 +36,7 @@ export default function (worker?: Worker): express.Router {
   router.post('/init-linter', delegate('on-init-linter'));
   router.post('/new-tsconfig', delegate('on-new-tsconfig'));
   router.post('/tsconfig-files', delegate('on-tsconfig-files'));
+  router.get('/get-telemetry', delegate('on-get-telemetry'));
 
   /** Endpoints running on the main thread */
   router.get('/status', (_, response) => response.send('OK!'));

packages/bridge/tests/router.test.ts

@@ -326,6 +326,12 @@ describe('router', () => {
     expect(json.filename).toBeTruthy();
     expect(fs.existsSync(json.filename)).toBe(true);
   });
+
+  it('should return empty get-telemetry on fresh server', async () => {
+    const response = (await request(server, '/get-telemetry', 'GET')) as string;
+    const json = JSON.parse(response);
+    expect(json).toEqual({ dependencies: [] });
+  });
 });
 
 function requestInitLinter(server: http.Server, rules: RuleConfig[]) {

packages/jsts/src/analysis/analyzer.ts

@@ -29,7 +29,8 @@ import { getContext } from '../../../shared/src/helpers/context.js';
 import { computeMetrics, findNoSonarLines } from '../linter/visitors/metrics/index.js';
 import { getSyntaxHighlighting } from '../linter/visitors/syntax-highlighting.js';
 import { getCpdTokens } from '../linter/visitors/cpd.js';
-import { clearDependenciesCache } from '../rules/helpers/package-json.js';
+import { clearDependenciesCache, getAllDependencies } from '../rules/index.js';
+import { Telemetry } from '../../../bridge/src/request.js';
 
 /**
  * Analyzes a JavaScript / TypeScript analysis input
@@ -160,3 +161,9 @@ function computeExtendedMetrics(
     };
   }
 }
+
+export function getTelemetry(): Telemetry {
+  return {
+    dependencies: getAllDependencies(),
+  };
+}

packages/jsts/src/rules/helpers/package-json.ts

@@ -30,10 +30,37 @@ const findPackageJsons = createFindUp(PACKAGE_JSON);
 
 const DefinitelyTyped = '@types/';
 
+type MinimatchDependency = {
+  name: Minimatch;
+  version?: string;
+};
+
+export type NamedDependency = {
+  name: string;
+  version?: string;
+};
+
+type Dependency = MinimatchDependency | NamedDependency;
+
 /**
  * Cache for the available dependencies by dirname.
  */
-const cache: Map<string, Set<string | Minimatch>> = new Map();
+const cache: Map<string, Set<Dependency>> = new Map();
+
+export function getAllDependencies(): NamedDependency[] {
+  const dependencies = [...cache.values()]
+    .flatMap(dependencies => [...dependencies])
+    .filter((dependency): dependency is NamedDependency => typeof dependency.name === 'string');
+  return Object.values(
+    dependencies.reduce(
+      (result, dependency) => ({
+        ...result,
+        [dependency.name]: dependency,
+      }),
+      {},
+    ),
+  );
+}
 
 /**
  * Retrieve the dependencies of all the package.json files available for the given file.
@@ -46,9 +73,9 @@ export function getDependencies(filename: string, cwd: string) {
   const dirname = Path.dirname(toUnixPath(filename));
   const cached = cache.get(dirname);
   if (cached) {
-    return cached;
+    return new Set([...cached].map(item => item.name));
   }
-  const result = new Set<string | Minimatch>();
+  const result = new Set<Dependency>();
   cache.set(dirname, result);
 
   getManifests(dirname, cwd, fs).forEach(manifest => {
@@ -59,7 +86,7 @@ export function getDependencies(filename: string, cwd: string) {
     });
   });
 
-  return result;
+  return new Set([...result].map(item => item.name));
 }
 
 /**
@@ -71,7 +98,7 @@ export function clearDependenciesCache() {
 }
 
 export function getDependenciesFromPackageJson(content: PackageJson) {
-  const result = new Set<string | Minimatch>();
+  const result = new Set<Dependency>();
   if (content.name) {
     addDependencies(result, { [content.name]: '*' });
   }
@@ -99,30 +126,37 @@ export function getDependenciesFromPackageJson(content: PackageJson) {
 }
 
 function addDependencies(
-  result: Set<string | Minimatch>,
+  result: Set<Dependency>,
   dependencies: PackageJson.Dependency,
   isGlob = false,
 ) {
-  Object.keys(dependencies).forEach(name => addDependency(result, name, isGlob));
+  Object.keys(dependencies).forEach(name =>
+    addDependency(result, name, isGlob, dependencies[name]),
+  );
 }
 
-function addDependenciesArray(
-  result: Set<string | Minimatch>,
-  dependencies: string[],
-  isGlob = true,
-) {
+function addDependenciesArray(result: Set<Dependency>, dependencies: string[], isGlob = true) {
   dependencies.forEach(name => addDependency(result, name, isGlob));
 }
 
-function addDependency(result: Set<string | Minimatch>, dependency: string, isGlob: boolean) {
+function addDependency(
+  result: Set<Dependency>,
+  dependency: string,
+  isGlob: boolean,
+  version?: string,
+) {
   if (isGlob) {
-    result.add(new Minimatch(dependency, { nocase: true, matchBase: true }));
+    result.add({
+      name: new Minimatch(dependency, { nocase: true, matchBase: true }),
+      version,
+    });
   } else {
-    result.add(
-      dependency.startsWith(DefinitelyTyped)
+    result.add({
+      name: dependency.startsWith(DefinitelyTyped)
         ? dependency.substring(DefinitelyTyped.length)
         : dependency,
-    );
+      version,
+    });
   }
 }
 

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

@@ -19,9 +19,9 @@ import { jsTsInput, parseJavaScriptSourceFile } from '../tools/index.js';
 import { Linter, Rule } from 'eslint';
 import { describe, beforeEach, it } from 'node:test';
 import { expect } from 'expect';
-import { getManifests, toUnixPath } from '../../src/rules/helpers/index.js';
+import { getDependencies, getManifests, toUnixPath } from '../../src/rules/helpers/index.js';
 import { setContext } from '../../../shared/src/helpers/context.js';
-import { analyzeJSTS } from '../../src/analysis/analyzer.js';
+import { analyzeJSTS, getTelemetry } from '../../src/analysis/analyzer.js';
 import { APIError } from '../../../shared/src/errors/error.js';
 import { RuleConfig } from '../../src/linter/config/rule-config.js';
 import { initializeLinter } from '../../src/linter/linters.js';
@@ -899,6 +899,50 @@ describe('analyzeJSTS', () => {
     expect(vueIssues[0].message).toEqual('call');
   });
 
+  it('should populate dependencies after analysis', async () => {
+    const baseDir = path.join(currentPath, 'fixtures', 'dependencies');
+    const linter = new Linter();
+    linter.defineRule('custom-rule-file', {
+      create(context) {
+        return {
+          CallExpression(node) {
+            // Necessarily call 'getDependencies' to populate the cache of dependencies
+            const dependencies = getDependencies(toUnixPath(context.filename), baseDir);
+            if (dependencies.size) {
+              context.report({
+                node: node.callee,
+                message: 'call',
+              });
+            }
+          },
+        };
+      },
+    } as Rule.RuleModule);
+    const filePath = path.join(currentPath, 'fixtures', 'dependencies', 'index.js');
+    const sourceCode = await parseJavaScriptSourceFile(filePath);
+    linter.verify(
+      sourceCode,
+      { rules: { 'custom-rule-file': 'error' } },
+      { filename: filePath, allowInlineConfig: false },
+    );
+    const telemetry = getTelemetry();
+    const dependencies = telemetry.dependencies;
+    expect(dependencies).toStrictEqual([
+      {
+        name: 'test-module',
+        version: '*',
+      },
+      {
+        name: 'pkg1',
+        version: '1.0.0',
+      },
+      {
+        name: 'pkg2',
+        version: '2.0.0',
+      },
+    ]);
+  });
+
   it('should return the AST along with the issues', async () => {
     const rules = [{ key: 'S4524', configurations: [], fileTypeTarget: ['MAIN'] }] as RuleConfig[];
     await initializeLinter(rules);

packages/jsts/tests/analysis/fixtures/dependencies/index.js

@@ -0,0 +1 @@
+console.log("Hello World!");

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

@@ -0,0 +1,11 @@
+{
+  "name": "test-module",
+  "version": "1.0.0",
+  "author": "Your Name <email@example.com>",
+  "dependencies": {
+    "pkg1": "1.0.0"
+  },
+  "devDependencies": {
+    "pkg2": "2.0.0"
+  }
+}