@rushstack/lockfile-explorer 2.2.16 → 2.2.18

package/CHANGELOG.json

@@ -1,6 +1,41 @@
 {
   "name": "@rushstack/lockfile-explorer",
   "entries": [
+    {
+      "version": "2.2.18",
+      "tag": "@rushstack/lockfile-explorer_v2.2.18",
+      "date": "Mon, 20 Apr 2026 23:31:13 GMT",
+      "comments": {
+        "patch": [
+          {
+            "comment": "Replace `update-notifier` with a simpler built-in solution."
+          }
+        ],
+        "dependency": [
+          {
+            "comment": "Updating dependency \"@rushstack/terminal\" to `0.24.0`"
+          },
+          {
+            "comment": "Updating dependency \"@rushstack/ts-command-line\" to `5.3.9`"
+          },
+          {
+            "comment": "Updating dependency \"@rushstack/heft\" to `1.2.17`"
+          }
+        ]
+      }
+    },
+    {
+      "version": "2.2.17",
+      "tag": "@rushstack/lockfile-explorer_v2.2.17",
+      "date": "Mon, 20 Apr 2026 15:15:24 GMT",
+      "comments": {
+        "dependency": [
+          {
+            "comment": "Updating dependency \"@rushstack/heft\" to `1.2.16`"
+          }
+        ]
+      }
+    },
     {
       "version": "2.2.16",
       "tag": "@rushstack/lockfile-explorer_v2.2.16",

package/CHANGELOG.md

@@ -1,6 +1,18 @@
 # Change Log - @rushstack/lockfile-explorer
 
-This log was last generated on Sat, 18 Apr 2026 03:47:09 GMT and should not be manually modified.
+This log was last generated on Mon, 20 Apr 2026 23:31:13 GMT and should not be manually modified.
+
+## 2.2.18
+Mon, 20 Apr 2026 23:31:13 GMT
+
+### Patches
+
+- Replace `update-notifier` with a simpler built-in solution.
+
+## 2.2.17
+Mon, 20 Apr 2026 15:15:24 GMT
+
+_Version update only_
 
 ## 2.2.16
 Sat, 18 Apr 2026 03:47:09 GMT

package/lib-commonjs/cli/explorer/ExplorerCommandLineParser.js

@@ -44,7 +44,6 @@ const path = __importStar(require("node:path"));
 const express_1 = __importDefault(require("express"));
 const js_yaml_1 = __importDefault(require("js-yaml"));
 const cors_1 = __importDefault(require("cors"));
-const update_notifier_1 = __importDefault(require("update-notifier"));
 const node_core_library_1 = require("@rushstack/node-core-library");
 const terminal_1 = require("@rushstack/terminal");
 const ts_command_line_1 = require("@rushstack/ts-command-line");
@@ -53,9 +52,17 @@ const lockfilePath = __importStar(require("../../graph/lockfilePath"));
 const init_1 = require("../../utils/init");
 const PnpmfileRunner_1 = require("../../graph/PnpmfileRunner");
 const lfxGraphLoader = __importStar(require("../../graph/lfxGraphLoader"));
+const constants_1 = require("../../utils/constants");
+const PackageUpdateChecker_1 = require("../../utils/PackageUpdateChecker");
 const EXPLORER_TOOL_FILENAME = 'lockfile-explorer';
+function printUpdateNotification(result, terminal) {
+    if (result === null || result === void 0 ? void 0 : result.isOutdated) {
+        terminal.writeLine(terminal_1.Colorize.yellow(`\nUpdate available: ${constants_1.LFX_VERSION} → ${result.latestVersion}\n` +
+            `Run: npm install -g ${constants_1.LFX_PACKAGE_NAME}\n`));
+    }
+}
 class ExplorerCommandLineParser extends ts_command_line_1.CommandLineParser {
-    constructor() {
+    constructor(terminal) {
         super({
             toolFilename: EXPLORER_TOOL_FILENAME,
             toolDescription: 'Lockfile Explorer is a desktop app for investigating and solving version conflicts in a PNPM workspace.'
@@ -71,35 +78,29 @@ class ExplorerCommandLineParser extends ts_command_line_1.CommandLineParser {
             description: 'Specifies an individual Rush subspace to check.',
             defaultValue: 'default'
         });
-        this._terminalProvider = new terminal_1.ConsoleTerminalProvider();
-        this.globalTerminal = new terminal_1.Terminal(this._terminalProvider);
+        this.globalTerminal = terminal;
     }
     get isDebug() {
         return this._debugParameter.value;
     }
     async onExecuteAsync() {
-        const lockfileExplorerProjectRoot = node_core_library_1.PackageJsonLookup.instance.tryGetPackageFolderFor(__dirname);
-        const lockfileExplorerPackageJson = node_core_library_1.JsonFile.load(`${lockfileExplorerProjectRoot}/package.json`);
-        const appVersion = lockfileExplorerPackageJson.version;
-        this.globalTerminal.writeLine(terminal_1.Colorize.bold(`\nRush Lockfile Explorer ${appVersion}`) +
+        const terminal = this.globalTerminal;
+        terminal.writeLine(terminal_1.Colorize.bold(`\nRush Lockfile Explorer ${constants_1.LFX_VERSION}`) +
             terminal_1.Colorize.cyan(' - https://lfx.rushstack.io/\n'));
-        (0, update_notifier_1.default)({
-            pkg: lockfileExplorerPackageJson,
-            // Normally update-notifier waits a day or so before it starts displaying upgrade notices.
-            // In debug mode, show the notice right away.
-            updateCheckInterval: this.isDebug ? 0 : undefined
-        }).notify({
-            // Make sure it says "-g" in the "npm install" example command line
-            isGlobal: true,
-            // Show the notice immediately, rather than waiting for process.onExit()
-            defer: false
+        // Start the update check now so it runs concurrently with server setup.
+        // The result is awaited and displayed inside app.listen once the server is ready.
+        const updateChecker = new PackageUpdateChecker_1.PackageUpdateChecker({
+            packageName: constants_1.LFX_PACKAGE_NAME,
+            currentVersion: constants_1.LFX_VERSION,
+            // In debug mode, bypass the cache so the notice appears immediately.
+            forceCheck: this.isDebug
         });
+        const updateCheckPromise = updateChecker.tryGetUpdateAsync();
         const PORT = 8091;
         // Must not have a trailing slash
         const SERVICE_URL = `http://localhost:${PORT}`;
         const appState = (0, init_1.init)({
-            lockfileExplorerProjectRoot,
-            appVersion,
+            appVersion: constants_1.LFX_VERSION,
             debugMode: this.isDebug,
             subspaceName: this._subspaceParameter.value
         });
@@ -116,8 +117,8 @@ class ExplorerCommandLineParser extends ts_command_line_1.CommandLineParser {
         let disconnected = false;
         setInterval(() => {
             if (!isClientConnected && !awaitingFirstConnect && !disconnected) {
-                console.log(terminal_1.Colorize.red('The client has disconnected!'));
-                console.log(`Please open a browser window at http://localhost:${PORT}/app`);
+                terminal.writeLine(terminal_1.Colorize.red('The client has disconnected!'));
+                terminal.writeLine(`Please open a browser window at http://localhost:${PORT}/app`);
                 disconnected = true;
             }
             else if (!awaitingFirstConnect) {
@@ -144,7 +145,7 @@ class ExplorerCommandLineParser extends ts_command_line_1.CommandLineParser {
             isClientConnected = true;
             if (disconnected) {
                 disconnected = false;
-                console.log(terminal_1.Colorize.green('The client has reconnected!'));
+                terminal.writeLine(terminal_1.Colorize.green('The client has reconnected!'));
             }
             res.status(200).send();
         });
@@ -226,7 +227,8 @@ class ExplorerCommandLineParser extends ts_command_line_1.CommandLineParser {
             res.send(parsedPackage);
         });
         app.listen(PORT, async () => {
-            console.log(`App launched on ${SERVICE_URL}`);
+            terminal.writeLine(`App launched on ${SERVICE_URL}`);
+            printUpdateNotification(await updateCheckPromise, terminal);
             if (!appState.debugMode) {
                 try {
                     // Launch the default web browser using the platform-native open command.
@@ -258,7 +260,7 @@ class ExplorerCommandLineParser extends ts_command_line_1.CommandLineParser {
                     browserProcess.unref();
                 }
                 catch (e) {
-                    this.globalTerminal.writeError('Error launching browser: ' + e.toString());
+                    terminal.writeError('Error launching browser: ' + e.toString());
                 }
             }
         });

package/lib-commonjs/cli/explorer/ExplorerCommandLineParser.js.map

@@ -1 +1 @@
-{"version":3,"file":"ExplorerCommandLineParser.js","sourceRoot":"","sources":["../../../src/cli/explorer/ExplorerCommandLineParser.ts"],"names":[],"mappings":"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","sourcesContent":["// Copyright (c) Microsoft Corporation. All rights reserved. Licensed under the MIT license.\n// See LICENSE in the project root for license information.\n\nimport process from 'node:process';\nimport * as path from 'node:path';\nimport type { ChildProcess } from 'node:child_process';\n\nimport express from 'express';\nimport yaml from 'js-yaml';\nimport cors from 'cors';\nimport updateNotifier from 'update-notifier';\n\nimport {\n  Executable,\n  FileSystem,\n  type IPackageJson,\n  JsonFile,\n  PackageJsonLookup\n} from '@rushstack/node-core-library';\nimport { ConsoleTerminalProvider, type ITerminal, Terminal, Colorize } from '@rushstack/terminal';\nimport {\n  type CommandLineFlagParameter,\n  CommandLineParser,\n  type IRequiredCommandLineStringParameter\n} from '@rushstack/ts-command-line';\n\nimport {\n  type LfxGraph,\n  lfxGraphSerializer,\n  type IAppContext,\n  type IJsonLfxGraph,\n  type IJsonLfxWorkspace\n} from '../../../build/lfx-shared';\nimport * as lockfilePath from '../../graph/lockfilePath';\nimport type { IAppState } from '../../state';\nimport { init } from '../../utils/init';\nimport { PnpmfileRunner } from '../../graph/PnpmfileRunner';\nimport * as lfxGraphLoader from '../../graph/lfxGraphLoader';\n\nconst EXPLORER_TOOL_FILENAME: 'lockfile-explorer' = 'lockfile-explorer';\n\nexport class ExplorerCommandLineParser extends CommandLineParser {\n  public readonly globalTerminal: ITerminal;\n  private readonly _terminalProvider: ConsoleTerminalProvider;\n  private readonly _debugParameter: CommandLineFlagParameter;\n\n  private readonly _subspaceParameter: IRequiredCommandLineStringParameter;\n\n  public constructor() {\n    super({\n      toolFilename: EXPLORER_TOOL_FILENAME,\n      toolDescription:\n        'Lockfile Explorer is a desktop app for investigating and solving version conflicts in a PNPM workspace.'\n    });\n\n    this._debugParameter = this.defineFlagParameter({\n      parameterLongName: '--debug',\n      parameterShortName: '-d',\n      description: 'Show the full call stack if an error occurs while executing the tool'\n    });\n\n    this._subspaceParameter = this.defineStringParameter({\n      parameterLongName: '--subspace',\n      argumentName: 'SUBSPACE_NAME',\n      description: 'Specifies an individual Rush subspace to check.',\n      defaultValue: 'default'\n    });\n\n    this._terminalProvider = new ConsoleTerminalProvider();\n    this.globalTerminal = new Terminal(this._terminalProvider);\n  }\n\n  public get isDebug(): boolean {\n    return this._debugParameter.value;\n  }\n\n  protected override async onExecuteAsync(): Promise<void> {\n    const lockfileExplorerProjectRoot: string = PackageJsonLookup.instance.tryGetPackageFolderFor(__dirname)!;\n    const lockfileExplorerPackageJson: IPackageJson = JsonFile.load(\n      `${lockfileExplorerProjectRoot}/package.json`\n    );\n    const appVersion: string = lockfileExplorerPackageJson.version;\n\n    this.globalTerminal.writeLine(\n      Colorize.bold(`\\nRush Lockfile Explorer ${appVersion}`) +\n        Colorize.cyan(' - https://lfx.rushstack.io/\\n')\n    );\n\n    updateNotifier({\n      pkg: lockfileExplorerPackageJson,\n      // Normally update-notifier waits a day or so before it starts displaying upgrade notices.\n      // In debug mode, show the notice right away.\n      updateCheckInterval: this.isDebug ? 0 : undefined\n    }).notify({\n      // Make sure it says \"-g\" in the \"npm install\" example command line\n      isGlobal: true,\n      // Show the notice immediately, rather than waiting for process.onExit()\n      defer: false\n    });\n\n    const PORT: number = 8091;\n    // Must not have a trailing slash\n    const SERVICE_URL: string = `http://localhost:${PORT}`;\n\n    const appState: IAppState = init({\n      lockfileExplorerProjectRoot,\n      appVersion,\n      debugMode: this.isDebug,\n      subspaceName: this._subspaceParameter.value\n    });\n\n    const lfxWorkspace: IJsonLfxWorkspace = appState.lfxWorkspace;\n\n    // Important: This must happen after init() reads the current working directory\n    process.chdir(appState.lockfileExplorerProjectRoot);\n\n    const distFolderPath: string = `${appState.lockfileExplorerProjectRoot}/dist`;\n    const app: express.Application = express();\n    app.use(express.json());\n    app.use(cors());\n\n    // Variable used to check if the front-end client is still connected\n    let awaitingFirstConnect: boolean = true;\n    let isClientConnected: boolean = false;\n    let disconnected: boolean = false;\n    setInterval(() => {\n      if (!isClientConnected && !awaitingFirstConnect && !disconnected) {\n        console.log(Colorize.red('The client has disconnected!'));\n        console.log(`Please open a browser window at http://localhost:${PORT}/app`);\n        disconnected = true;\n      } else if (!awaitingFirstConnect) {\n        isClientConnected = false;\n      }\n    }, 4000);\n\n    // This takes precedence over the `/app` static route, which also has an `initappcontext.js` file.\n    app.get('/initappcontext.js', (req: express.Request, res: express.Response) => {\n      const appContext: IAppContext = {\n        serviceUrl: SERVICE_URL,\n        appVersion: appState.appVersion,\n        debugMode: this.isDebug\n      };\n      const sourceCode: string = [\n        `console.log('Loaded initappcontext.js');`,\n        `appContext = ${JSON.stringify(appContext)}`\n      ].join('\\n');\n\n      res.type('application/javascript').send(sourceCode);\n    });\n\n    app.use('/', express.static(distFolderPath));\n\n    app.use('/favicon.ico', express.static(distFolderPath, { index: 'favicon.ico' }));\n\n    app.get('/api/health', (req: express.Request, res: express.Response) => {\n      awaitingFirstConnect = false;\n      isClientConnected = true;\n      if (disconnected) {\n        disconnected = false;\n        console.log(Colorize.green('The client has reconnected!'));\n      }\n      res.status(200).send();\n    });\n\n    app.get('/api/graph', async (req: express.Request, res: express.Response) => {\n      const pnpmLockfileText: string = await FileSystem.readFileAsync(appState.pnpmLockfileLocation);\n      const lockfile: unknown = yaml.load(pnpmLockfileText) as unknown;\n\n      const graph: LfxGraph = lfxGraphLoader.generateLockfileGraph(lockfile, lfxWorkspace);\n\n      const jsonGraph: IJsonLfxGraph = lfxGraphSerializer.serializeToJson(graph);\n      res.type('application/json').send(jsonGraph);\n    });\n\n    app.post(\n      '/api/package-json',\n      async (req: express.Request<{}, {}, { projectPath: string }, {}>, res: express.Response) => {\n        const { projectPath } = req.body;\n        const fileLocation: string = `${appState.projectRoot}/${projectPath}/package.json`;\n        let packageJsonText: string;\n        try {\n          packageJsonText = await FileSystem.readFileAsync(fileLocation);\n        } catch (e) {\n          if (FileSystem.isNotExistError(e)) {\n            return res.status(404).send({\n              message: `Could not load package.json file for this package. Have you installed all the dependencies for this workspace?`,\n              error: `No package.json in location: ${projectPath}`\n            });\n          } else {\n            throw e;\n          }\n        }\n\n        res.send(packageJsonText);\n      }\n    );\n\n    app.get('/api/pnpmfile', async (req: express.Request, res: express.Response) => {\n      const pnpmfilePath: string = lockfilePath.join(\n        lfxWorkspace.workspaceRootFullPath,\n        lfxWorkspace.rushConfig?.rushPnpmfilePath ?? lfxWorkspace.pnpmfilePath\n      );\n\n      let pnpmfile: string;\n      try {\n        pnpmfile = await FileSystem.readFileAsync(pnpmfilePath);\n      } catch (e) {\n        if (FileSystem.isNotExistError(e)) {\n          return res.status(404).send({\n            message: `Could not load .pnpmfile.cjs file in this repo: \"${pnpmfilePath}\"`,\n            error: `No .pnpmifile.cjs found.`\n          });\n        } else {\n          throw e;\n        }\n      }\n\n      res.send(pnpmfile);\n    });\n\n    app.post(\n      '/api/package-spec',\n      async (req: express.Request<{}, {}, { projectPath: string }, {}>, res: express.Response) => {\n        const { projectPath } = req.body;\n        const fileLocation: string = `${appState.projectRoot}/${projectPath}/package.json`;\n        let packageJson: IPackageJson;\n        try {\n          packageJson = await JsonFile.loadAsync(fileLocation);\n        } catch (e) {\n          if (FileSystem.isNotExistError(e)) {\n            return res.status(404).send({\n              message: `Could not load package.json file in location: ${projectPath}`\n            });\n          } else {\n            throw e;\n          }\n        }\n\n        let parsedPackage: IPackageJson = packageJson;\n\n        const pnpmfilePath: string = path.join(lfxWorkspace.workspaceRootFullPath, lfxWorkspace.pnpmfilePath);\n        if (await FileSystem.existsAsync(pnpmfilePath)) {\n          const pnpmFileRunner: PnpmfileRunner = new PnpmfileRunner(pnpmfilePath);\n          try {\n            parsedPackage = await pnpmFileRunner.transformPackageAsync(packageJson, fileLocation);\n          } finally {\n            await pnpmFileRunner.disposeAsync();\n          }\n        }\n\n        res.send(parsedPackage);\n      }\n    );\n\n    app.listen(PORT, async () => {\n      console.log(`App launched on ${SERVICE_URL}`);\n\n      if (!appState.debugMode) {\n        try {\n          // Launch the default web browser using the platform-native open command.\n          let browserCmd: string;\n          let browserArgs: string[];\n          switch (process.platform) {\n            case 'win32': {\n              // \"start\" is a cmd.exe built-in, not a standalone executable.\n              // The empty string is the required [title] argument; without it,\n              // cmd interprets the URL as the title and ignores it.\n              browserCmd = 'cmd';\n              browserArgs = ['/c', 'start', '', SERVICE_URL];\n              break;\n            }\n\n            case 'darwin': {\n              browserCmd = 'open';\n              browserArgs = [SERVICE_URL];\n              break;\n            }\n\n            default: {\n              // Linux and other Unix-like systems\n              browserCmd = 'xdg-open';\n              browserArgs = [SERVICE_URL];\n              break;\n            }\n          }\n\n          const browserProcess: ChildProcess = Executable.spawn(browserCmd, browserArgs, { stdio: 'ignore' });\n          // Detach from our Node.js process so the browser stays open after we exit\n          browserProcess.unref();\n        } catch (e) {\n          this.globalTerminal.writeError('Error launching browser: ' + e.toString());\n        }\n      }\n    });\n  }\n}\n"]}
+{"version":3,"file":"ExplorerCommandLineParser.js","sourceRoot":"","sources":["../../../src/cli/explorer/ExplorerCommandLineParser.ts"],"names":[],"mappings":"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","sourcesContent":["// Copyright (c) Microsoft Corporation. All rights reserved. Licensed under the MIT license.\n// See LICENSE in the project root for license information.\n\nimport process from 'node:process';\nimport * as path from 'node:path';\nimport type { ChildProcess } from 'node:child_process';\n\nimport express from 'express';\nimport yaml from 'js-yaml';\nimport cors from 'cors';\n\nimport { Executable, FileSystem, type IPackageJson, JsonFile } from '@rushstack/node-core-library';\nimport { type ITerminal, Colorize } from '@rushstack/terminal';\nimport {\n  type CommandLineFlagParameter,\n  CommandLineParser,\n  type IRequiredCommandLineStringParameter\n} from '@rushstack/ts-command-line';\n\nimport {\n  type LfxGraph,\n  lfxGraphSerializer,\n  type IAppContext,\n  type IJsonLfxGraph,\n  type IJsonLfxWorkspace\n} from '../../../build/lfx-shared';\nimport * as lockfilePath from '../../graph/lockfilePath';\nimport type { IAppState } from '../../state';\nimport { init } from '../../utils/init';\nimport { PnpmfileRunner } from '../../graph/PnpmfileRunner';\nimport * as lfxGraphLoader from '../../graph/lfxGraphLoader';\nimport { LFX_PACKAGE_NAME, LFX_VERSION } from '../../utils/constants';\nimport { type IPackageUpdateResult, PackageUpdateChecker } from '../../utils/PackageUpdateChecker';\n\nconst EXPLORER_TOOL_FILENAME: 'lockfile-explorer' = 'lockfile-explorer';\n\nfunction printUpdateNotification(\n  result: { latestVersion: string; isOutdated: boolean } | undefined,\n  terminal: ITerminal\n): void {\n  if (result?.isOutdated) {\n    terminal.writeLine(\n      Colorize.yellow(\n        `\\nUpdate available: ${LFX_VERSION} → ${result.latestVersion}\\n` +\n          `Run: npm install -g ${LFX_PACKAGE_NAME}\\n`\n      )\n    );\n  }\n}\n\nexport class ExplorerCommandLineParser extends CommandLineParser {\n  public readonly globalTerminal: ITerminal;\n\n  private readonly _debugParameter: CommandLineFlagParameter;\n  private readonly _subspaceParameter: IRequiredCommandLineStringParameter;\n\n  public constructor(terminal: ITerminal) {\n    super({\n      toolFilename: EXPLORER_TOOL_FILENAME,\n      toolDescription:\n        'Lockfile Explorer is a desktop app for investigating and solving version conflicts in a PNPM workspace.'\n    });\n\n    this._debugParameter = this.defineFlagParameter({\n      parameterLongName: '--debug',\n      parameterShortName: '-d',\n      description: 'Show the full call stack if an error occurs while executing the tool'\n    });\n\n    this._subspaceParameter = this.defineStringParameter({\n      parameterLongName: '--subspace',\n      argumentName: 'SUBSPACE_NAME',\n      description: 'Specifies an individual Rush subspace to check.',\n      defaultValue: 'default'\n    });\n\n    this.globalTerminal = terminal;\n  }\n\n  public get isDebug(): boolean {\n    return this._debugParameter.value;\n  }\n\n  protected override async onExecuteAsync(): Promise<void> {\n    const terminal: ITerminal = this.globalTerminal;\n\n    terminal.writeLine(\n      Colorize.bold(`\\nRush Lockfile Explorer ${LFX_VERSION}`) +\n        Colorize.cyan(' - https://lfx.rushstack.io/\\n')\n    );\n\n    // Start the update check now so it runs concurrently with server setup.\n    // The result is awaited and displayed inside app.listen once the server is ready.\n    const updateChecker: PackageUpdateChecker = new PackageUpdateChecker({\n      packageName: LFX_PACKAGE_NAME,\n      currentVersion: LFX_VERSION,\n      // In debug mode, bypass the cache so the notice appears immediately.\n      forceCheck: this.isDebug\n    });\n    const updateCheckPromise: Promise<IPackageUpdateResult | undefined> = updateChecker.tryGetUpdateAsync();\n\n    const PORT: number = 8091;\n    // Must not have a trailing slash\n    const SERVICE_URL: string = `http://localhost:${PORT}`;\n\n    const appState: IAppState = init({\n      appVersion: LFX_VERSION,\n      debugMode: this.isDebug,\n      subspaceName: this._subspaceParameter.value\n    });\n\n    const lfxWorkspace: IJsonLfxWorkspace = appState.lfxWorkspace;\n\n    // Important: This must happen after init() reads the current working directory\n    process.chdir(appState.lockfileExplorerProjectRoot);\n\n    const distFolderPath: string = `${appState.lockfileExplorerProjectRoot}/dist`;\n    const app: express.Application = express();\n    app.use(express.json());\n    app.use(cors());\n\n    // Variable used to check if the front-end client is still connected\n    let awaitingFirstConnect: boolean = true;\n    let isClientConnected: boolean = false;\n    let disconnected: boolean = false;\n    setInterval(() => {\n      if (!isClientConnected && !awaitingFirstConnect && !disconnected) {\n        terminal.writeLine(Colorize.red('The client has disconnected!'));\n        terminal.writeLine(`Please open a browser window at http://localhost:${PORT}/app`);\n        disconnected = true;\n      } else if (!awaitingFirstConnect) {\n        isClientConnected = false;\n      }\n    }, 4000);\n\n    // This takes precedence over the `/app` static route, which also has an `initappcontext.js` file.\n    app.get('/initappcontext.js', (req: express.Request, res: express.Response) => {\n      const appContext: IAppContext = {\n        serviceUrl: SERVICE_URL,\n        appVersion: appState.appVersion,\n        debugMode: this.isDebug\n      };\n      const sourceCode: string = [\n        `console.log('Loaded initappcontext.js');`,\n        `appContext = ${JSON.stringify(appContext)}`\n      ].join('\\n');\n\n      res.type('application/javascript').send(sourceCode);\n    });\n\n    app.use('/', express.static(distFolderPath));\n\n    app.use('/favicon.ico', express.static(distFolderPath, { index: 'favicon.ico' }));\n\n    app.get('/api/health', (req: express.Request, res: express.Response) => {\n      awaitingFirstConnect = false;\n      isClientConnected = true;\n      if (disconnected) {\n        disconnected = false;\n        terminal.writeLine(Colorize.green('The client has reconnected!'));\n      }\n      res.status(200).send();\n    });\n\n    app.get('/api/graph', async (req: express.Request, res: express.Response) => {\n      const pnpmLockfileText: string = await FileSystem.readFileAsync(appState.pnpmLockfileLocation);\n      const lockfile: unknown = yaml.load(pnpmLockfileText) as unknown;\n\n      const graph: LfxGraph = lfxGraphLoader.generateLockfileGraph(lockfile, lfxWorkspace);\n\n      const jsonGraph: IJsonLfxGraph = lfxGraphSerializer.serializeToJson(graph);\n      res.type('application/json').send(jsonGraph);\n    });\n\n    app.post(\n      '/api/package-json',\n      async (req: express.Request<{}, {}, { projectPath: string }, {}>, res: express.Response) => {\n        const { projectPath } = req.body;\n        const fileLocation: string = `${appState.projectRoot}/${projectPath}/package.json`;\n        let packageJsonText: string;\n        try {\n          packageJsonText = await FileSystem.readFileAsync(fileLocation);\n        } catch (e) {\n          if (FileSystem.isNotExistError(e)) {\n            return res.status(404).send({\n              message: `Could not load package.json file for this package. Have you installed all the dependencies for this workspace?`,\n              error: `No package.json in location: ${projectPath}`\n            });\n          } else {\n            throw e;\n          }\n        }\n\n        res.send(packageJsonText);\n      }\n    );\n\n    app.get('/api/pnpmfile', async (req: express.Request, res: express.Response) => {\n      const pnpmfilePath: string = lockfilePath.join(\n        lfxWorkspace.workspaceRootFullPath,\n        lfxWorkspace.rushConfig?.rushPnpmfilePath ?? lfxWorkspace.pnpmfilePath\n      );\n\n      let pnpmfile: string;\n      try {\n        pnpmfile = await FileSystem.readFileAsync(pnpmfilePath);\n      } catch (e) {\n        if (FileSystem.isNotExistError(e)) {\n          return res.status(404).send({\n            message: `Could not load .pnpmfile.cjs file in this repo: \"${pnpmfilePath}\"`,\n            error: `No .pnpmifile.cjs found.`\n          });\n        } else {\n          throw e;\n        }\n      }\n\n      res.send(pnpmfile);\n    });\n\n    app.post(\n      '/api/package-spec',\n      async (req: express.Request<{}, {}, { projectPath: string }, {}>, res: express.Response) => {\n        const { projectPath } = req.body;\n        const fileLocation: string = `${appState.projectRoot}/${projectPath}/package.json`;\n        let packageJson: IPackageJson;\n        try {\n          packageJson = await JsonFile.loadAsync(fileLocation);\n        } catch (e) {\n          if (FileSystem.isNotExistError(e)) {\n            return res.status(404).send({\n              message: `Could not load package.json file in location: ${projectPath}`\n            });\n          } else {\n            throw e;\n          }\n        }\n\n        let parsedPackage: IPackageJson = packageJson;\n\n        const pnpmfilePath: string = path.join(lfxWorkspace.workspaceRootFullPath, lfxWorkspace.pnpmfilePath);\n        if (await FileSystem.existsAsync(pnpmfilePath)) {\n          const pnpmFileRunner: PnpmfileRunner = new PnpmfileRunner(pnpmfilePath);\n          try {\n            parsedPackage = await pnpmFileRunner.transformPackageAsync(packageJson, fileLocation);\n          } finally {\n            await pnpmFileRunner.disposeAsync();\n          }\n        }\n\n        res.send(parsedPackage);\n      }\n    );\n\n    app.listen(PORT, async () => {\n      terminal.writeLine(`App launched on ${SERVICE_URL}`);\n\n      printUpdateNotification(await updateCheckPromise, terminal);\n\n      if (!appState.debugMode) {\n        try {\n          // Launch the default web browser using the platform-native open command.\n          let browserCmd: string;\n          let browserArgs: string[];\n          switch (process.platform) {\n            case 'win32': {\n              // \"start\" is a cmd.exe built-in, not a standalone executable.\n              // The empty string is the required [title] argument; without it,\n              // cmd interprets the URL as the title and ignores it.\n              browserCmd = 'cmd';\n              browserArgs = ['/c', 'start', '', SERVICE_URL];\n              break;\n            }\n\n            case 'darwin': {\n              browserCmd = 'open';\n              browserArgs = [SERVICE_URL];\n              break;\n            }\n\n            default: {\n              // Linux and other Unix-like systems\n              browserCmd = 'xdg-open';\n              browserArgs = [SERVICE_URL];\n              break;\n            }\n          }\n\n          const browserProcess: ChildProcess = Executable.spawn(browserCmd, browserArgs, { stdio: 'ignore' });\n          // Detach from our Node.js process so the browser stays open after we exit\n          browserProcess.unref();\n        } catch (e) {\n          terminal.writeError('Error launching browser: ' + e.toString());\n        }\n      }\n    });\n  }\n}\n"]}

package/lib-commonjs/cli/lint/LintCommandLineParser.js

@@ -5,30 +5,27 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.LintCommandLineParser = void 0;
 const terminal_1 = require("@rushstack/terminal");
 const ts_command_line_1 = require("@rushstack/ts-command-line");
-const node_core_library_1 = require("@rushstack/node-core-library");
 const InitAction_1 = require("./actions/InitAction");
 const CheckAction_1 = require("./actions/CheckAction");
+const constants_1 = require("../../utils/constants");
 const LINT_TOOL_FILENAME = 'lockfile-lint';
 class LintCommandLineParser extends ts_command_line_1.CommandLineParser {
-    constructor() {
+    constructor(terminal) {
         super({
             toolFilename: LINT_TOOL_FILENAME,
             toolDescription: 'Lockfile Lint applies configured policies to find and report dependency issues in your PNPM workspace.'
         });
-        this._terminalProvider = new terminal_1.ConsoleTerminalProvider();
-        this.globalTerminal = new terminal_1.Terminal(this._terminalProvider);
+        this.globalTerminal = terminal;
         this._populateActions();
     }
     async onExecuteAsync() {
-        const lockfileExplorerProjectRoot = node_core_library_1.PackageJsonLookup.instance.tryGetPackageFolderFor(__dirname);
-        const lockfileExplorerPackageJson = node_core_library_1.JsonFile.load(`${lockfileExplorerProjectRoot}/package.json`);
-        const appVersion = lockfileExplorerPackageJson.version;
-        this.globalTerminal.writeLine(terminal_1.Colorize.bold(`\nRush Lockfile Lint ${appVersion}`) + terminal_1.Colorize.cyan(' - https://lfx.rushstack.io/\n'));
+        this.globalTerminal.writeLine(terminal_1.Colorize.bold(`\nRush Lockfile Lint ${constants_1.LFX_VERSION}`) + terminal_1.Colorize.cyan(' - https://lfx.rushstack.io/\n'));
         await super.onExecuteAsync();
     }
     _populateActions() {
-        this.addAction(new InitAction_1.InitAction(this));
-        this.addAction(new CheckAction_1.CheckAction(this));
+        const terminal = this.globalTerminal;
+        this.addAction(new InitAction_1.InitAction(terminal));
+        this.addAction(new CheckAction_1.CheckAction(terminal));
     }
 }
 exports.LintCommandLineParser = LintCommandLineParser;

package/lib-commonjs/cli/lint/LintCommandLineParser.js.map

@@ -1 +1 @@
-{"version":3,"file":"LintCommandLineParser.js","sourceRoot":"","sources":["../../../src/cli/lint/LintCommandLineParser.ts"],"names":[],"mappings":";AAAA,4FAA4F;AAC5F,2DAA2D;;;AAE3D,kDAAkG;AAClG,gEAA+D;AAC/D,oEAA8F;AAE9F,qDAAkD;AAClD,uDAAoD;AAEpD,MAAM,kBAAkB,GAAoB,eAAe,CAAC;AAE5D,MAAa,qBAAsB,SAAQ,mCAAiB;IAI1D;QACE,KAAK,CAAC;YACJ,YAAY,EAAE,kBAAkB;YAChC,eAAe,EACb,wGAAwG;SAC3G,CAAC,CAAC;QAEH,IAAI,CAAC,iBAAiB,GAAG,IAAI,kCAAuB,EAAE,CAAC;QACvD,IAAI,CAAC,cAAc,GAAG,IAAI,mBAAQ,CAAC,IAAI,CAAC,iBAAiB,CAAC,CAAC;QAE3D,IAAI,CAAC,gBAAgB,EAAE,CAAC;IAC1B,CAAC;IAEkB,KAAK,CAAC,cAAc;QACrC,MAAM,2BAA2B,GAAW,qCAAiB,CAAC,QAAQ,CAAC,sBAAsB,CAAC,SAAS,CAAE,CAAC;QAC1G,MAAM,2BAA2B,GAAiB,4BAAQ,CAAC,IAAI,CAC7D,GAAG,2BAA2B,eAAe,CAC9C,CAAC;QACF,MAAM,UAAU,GAAW,2BAA2B,CAAC,OAAO,CAAC;QAE/D,IAAI,CAAC,cAAc,CAAC,SAAS,CAC3B,mBAAQ,CAAC,IAAI,CAAC,wBAAwB,UAAU,EAAE,CAAC,GAAG,mBAAQ,CAAC,IAAI,CAAC,gCAAgC,CAAC,CACtG,CAAC;QAEF,MAAM,KAAK,CAAC,cAAc,EAAE,CAAC;IAC/B,CAAC;IAEO,gBAAgB;QACtB,IAAI,CAAC,SAAS,CAAC,IAAI,uBAAU,CAAC,IAAI,CAAC,CAAC,CAAC;QACrC,IAAI,CAAC,SAAS,CAAC,IAAI,yBAAW,CAAC,IAAI,CAAC,CAAC,CAAC;IACxC,CAAC;CACF;AAnCD,sDAmCC","sourcesContent":["// Copyright (c) Microsoft Corporation. All rights reserved. Licensed under the MIT license.\n// See LICENSE in the project root for license information.\n\nimport { ConsoleTerminalProvider, type ITerminal, Terminal, Colorize } from '@rushstack/terminal';\nimport { CommandLineParser } from '@rushstack/ts-command-line';\nimport { type IPackageJson, JsonFile, PackageJsonLookup } from '@rushstack/node-core-library';\n\nimport { InitAction } from './actions/InitAction';\nimport { CheckAction } from './actions/CheckAction';\n\nconst LINT_TOOL_FILENAME: 'lockfile-lint' = 'lockfile-lint';\n\nexport class LintCommandLineParser extends CommandLineParser {\n  public readonly globalTerminal: ITerminal;\n  private readonly _terminalProvider: ConsoleTerminalProvider;\n\n  public constructor() {\n    super({\n      toolFilename: LINT_TOOL_FILENAME,\n      toolDescription:\n        'Lockfile Lint applies configured policies to find and report dependency issues in your PNPM workspace.'\n    });\n\n    this._terminalProvider = new ConsoleTerminalProvider();\n    this.globalTerminal = new Terminal(this._terminalProvider);\n\n    this._populateActions();\n  }\n\n  protected override async onExecuteAsync(): Promise<void> {\n    const lockfileExplorerProjectRoot: string = PackageJsonLookup.instance.tryGetPackageFolderFor(__dirname)!;\n    const lockfileExplorerPackageJson: IPackageJson = JsonFile.load(\n      `${lockfileExplorerProjectRoot}/package.json`\n    );\n    const appVersion: string = lockfileExplorerPackageJson.version;\n\n    this.globalTerminal.writeLine(\n      Colorize.bold(`\\nRush Lockfile Lint ${appVersion}`) + Colorize.cyan(' - https://lfx.rushstack.io/\\n')\n    );\n\n    await super.onExecuteAsync();\n  }\n\n  private _populateActions(): void {\n    this.addAction(new InitAction(this));\n    this.addAction(new CheckAction(this));\n  }\n}\n"]}
+{"version":3,"file":"LintCommandLineParser.js","sourceRoot":"","sources":["../../../src/cli/lint/LintCommandLineParser.ts"],"names":[],"mappings":";AAAA,4FAA4F;AAC5F,2DAA2D;;;AAE3D,kDAA+D;AAC/D,gEAA+D;AAE/D,qDAAkD;AAClD,uDAAoD;AACpD,qDAAoD;AAEpD,MAAM,kBAAkB,GAAoB,eAAe,CAAC;AAE5D,MAAa,qBAAsB,SAAQ,mCAAiB;IAG1D,YAAmB,QAAmB;QACpC,KAAK,CAAC;YACJ,YAAY,EAAE,kBAAkB;YAChC,eAAe,EACb,wGAAwG;SAC3G,CAAC,CAAC;QAEH,IAAI,CAAC,cAAc,GAAG,QAAQ,CAAC;QAE/B,IAAI,CAAC,gBAAgB,EAAE,CAAC;IAC1B,CAAC;IAEkB,KAAK,CAAC,cAAc;QACrC,IAAI,CAAC,cAAc,CAAC,SAAS,CAC3B,mBAAQ,CAAC,IAAI,CAAC,wBAAwB,uBAAW,EAAE,CAAC,GAAG,mBAAQ,CAAC,IAAI,CAAC,gCAAgC,CAAC,CACvG,CAAC;QAEF,MAAM,KAAK,CAAC,cAAc,EAAE,CAAC;IAC/B,CAAC;IAEO,gBAAgB;QACtB,MAAM,QAAQ,GAAc,IAAI,CAAC,cAAc,CAAC;QAChD,IAAI,CAAC,SAAS,CAAC,IAAI,uBAAU,CAAC,QAAQ,CAAC,CAAC,CAAC;QACzC,IAAI,CAAC,SAAS,CAAC,IAAI,yBAAW,CAAC,QAAQ,CAAC,CAAC,CAAC;IAC5C,CAAC;CACF;AA5BD,sDA4BC","sourcesContent":["// Copyright (c) Microsoft Corporation. All rights reserved. Licensed under the MIT license.\n// See LICENSE in the project root for license information.\n\nimport { type ITerminal, Colorize } from '@rushstack/terminal';\nimport { CommandLineParser } from '@rushstack/ts-command-line';\n\nimport { InitAction } from './actions/InitAction';\nimport { CheckAction } from './actions/CheckAction';\nimport { LFX_VERSION } from '../../utils/constants';\n\nconst LINT_TOOL_FILENAME: 'lockfile-lint' = 'lockfile-lint';\n\nexport class LintCommandLineParser extends CommandLineParser {\n  public readonly globalTerminal: ITerminal;\n\n  public constructor(terminal: ITerminal) {\n    super({\n      toolFilename: LINT_TOOL_FILENAME,\n      toolDescription:\n        'Lockfile Lint applies configured policies to find and report dependency issues in your PNPM workspace.'\n    });\n\n    this.globalTerminal = terminal;\n\n    this._populateActions();\n  }\n\n  protected override async onExecuteAsync(): Promise<void> {\n    this.globalTerminal.writeLine(\n      Colorize.bold(`\\nRush Lockfile Lint ${LFX_VERSION}`) + Colorize.cyan(' - https://lfx.rushstack.io/\\n')\n    );\n\n    await super.onExecuteAsync();\n  }\n\n  private _populateActions(): void {\n    const terminal: ITerminal = this.globalTerminal;\n    this.addAction(new InitAction(terminal));\n    this.addAction(new CheckAction(terminal));\n  }\n}\n"]}

package/lib-commonjs/cli/lint/actions/CheckAction.js

@@ -17,7 +17,7 @@ const lockfile_lint_schema_json_1 = __importDefault(require("../../../schemas/lo
 const common_1 = require("../../../constants/common");
 const shrinkwrap_1 = require("../../../utils/shrinkwrap");
 class CheckAction extends ts_command_line_1.CommandLineAction {
-    constructor(parser) {
+    constructor(terminal) {
         super({
             actionName: 'check',
             summary: 'Check and report dependency issues in your workspace',
@@ -25,7 +25,7 @@ class CheckAction extends ts_command_line_1.CommandLineAction {
                 common_1.LOCKFILE_LINT_JSON_FILENAME +
                 ', reporting any problems found in your PNPM workspace.'
         });
-        this._terminal = parser.globalTerminal;
+        this._terminal = terminal;
         this._checkedProjects = new Set();
         this._docMap = new Map();
     }

package/lib-commonjs/cli/lint/actions/CheckAction.js.map

@@ -1 +1 @@
-{"version":3,"file":"CheckAction.js","sourceRoot":"","sources":["../../../../src/cli/lint/actions/CheckAction.ts"],"names":[],"mappings":"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","sourcesContent":["// Copyright (c) Microsoft Corporation. All rights reserved. Licensed under the MIT license.\n// See LICENSE in the project root for license information.\n\nimport path from 'node:path';\n\nimport yaml from 'js-yaml';\nimport semver from 'semver';\nimport type * as lockfileTypes from '@pnpm/lockfile.types';\nimport type * as pnpmTypes from '@pnpm/types';\n\nimport { RushConfiguration, type RushConfigurationProject, type Subspace } from '@rushstack/rush-sdk';\nimport { CommandLineAction } from '@rushstack/ts-command-line';\nimport { Colorize, type ITerminal } from '@rushstack/terminal';\nimport { AlreadyReportedError, Async, FileSystem, JsonFile, JsonSchema } from '@rushstack/node-core-library';\n\nimport lockfileLintSchema from '../../../schemas/lockfile-lint.schema.json';\nimport { LOCKFILE_EXPLORER_FOLDERNAME, LOCKFILE_LINT_JSON_FILENAME } from '../../../constants/common';\nimport type { LintCommandLineParser } from '../LintCommandLineParser';\nimport {\n  getShrinkwrapFileMajorVersion,\n  parseDependencyPath,\n  splicePackageWithVersion\n} from '../../../utils/shrinkwrap';\n\nexport interface ILintRule {\n  rule: 'restrict-versions';\n  project: string;\n  requiredVersions: Record<string, string>;\n}\n\nexport interface ILockfileLint {\n  rules: ILintRule[];\n}\n\nexport interface ILintIssue {\n  project: string;\n  rule: string;\n  message: string;\n}\n\nexport class CheckAction extends CommandLineAction {\n  private readonly _terminal: ITerminal;\n\n  private _rushConfiguration!: RushConfiguration;\n  private _checkedProjects: Set<RushConfigurationProject>;\n  private _docMap: Map<string, lockfileTypes.LockfileObject>;\n\n  public constructor(parser: LintCommandLineParser) {\n    super({\n      actionName: 'check',\n      summary: 'Check and report dependency issues in your workspace',\n      documentation:\n        'This command applies the policies that are configured in ' +\n        LOCKFILE_LINT_JSON_FILENAME +\n        ', reporting any problems found in your PNPM workspace.'\n    });\n\n    this._terminal = parser.globalTerminal;\n    this._checkedProjects = new Set();\n    this._docMap = new Map();\n  }\n\n  private async _checkVersionCompatibilityAsync(\n    shrinkwrapFileMajorVersion: number,\n    packages: lockfileTypes.PackageSnapshots | undefined,\n    dependencyPath: pnpmTypes.DepPath,\n    requiredVersions: Record<string, string>,\n    checkedDependencyPaths: Set<string>\n  ): Promise<void> {\n    if (packages && packages[dependencyPath] && !checkedDependencyPaths.has(dependencyPath)) {\n      checkedDependencyPaths.add(dependencyPath);\n      const { name, version } = parseDependencyPath(shrinkwrapFileMajorVersion, dependencyPath);\n      if (name in requiredVersions && !semver.satisfies(version, requiredVersions[name])) {\n        throw new Error(\n          `The version of \"${name}\" should match \"${requiredVersions[name]}\";` +\n            ` actual version is \"${version}\"`\n        );\n      }\n\n      await Promise.all(\n        Object.entries(packages[dependencyPath].dependencies ?? {}).map(\n          async ([dependencyPackageName, dependencyPackageVersion]) => {\n            await this._checkVersionCompatibilityAsync(\n              shrinkwrapFileMajorVersion,\n              packages,\n              splicePackageWithVersion(\n                shrinkwrapFileMajorVersion,\n                dependencyPackageName,\n                dependencyPackageVersion\n              ) as pnpmTypes.DepPath,\n              requiredVersions,\n              checkedDependencyPaths\n            );\n          }\n        )\n      );\n    }\n  }\n\n  private async _searchAndValidateDependenciesAsync(\n    project: RushConfigurationProject,\n    requiredVersions: Record<string, string>\n  ): Promise<void> {\n    this._terminal.writeLine(`Checking project \"${project.packageName}\"`);\n\n    const projectFolder: string = project.projectFolder;\n    const subspace: Subspace = project.subspace;\n    const shrinkwrapFilename: string = subspace.getCommittedShrinkwrapFilePath();\n    let doc: lockfileTypes.LockfileObject;\n    if (this._docMap.has(shrinkwrapFilename)) {\n      doc = this._docMap.get(shrinkwrapFilename)!;\n    } else {\n      const pnpmLockfileText: string = await FileSystem.readFileAsync(shrinkwrapFilename);\n      doc = yaml.load(pnpmLockfileText) as lockfileTypes.LockfileObject;\n      this._docMap.set(shrinkwrapFilename, doc);\n    }\n    const { importers, lockfileVersion, packages } = doc;\n    const shrinkwrapFileMajorVersion: number = getShrinkwrapFileMajorVersion(lockfileVersion);\n    const checkedDependencyPaths: Set<string> = new Set<string>();\n\n    await Promise.all(\n      Object.entries(importers).map(async ([relativePath, { dependencies }]) => {\n        if (path.resolve(projectFolder, relativePath) === projectFolder) {\n          const dependenciesEntries: [string, unknown][] = Object.entries(dependencies ?? {});\n          for (const [dependencyName, dependencyValue] of dependenciesEntries) {\n            const fullDependencyPath: pnpmTypes.DepPath = splicePackageWithVersion(\n              shrinkwrapFileMajorVersion,\n              dependencyName,\n              typeof dependencyValue === 'string'\n                ? dependencyValue\n                : (\n                    dependencyValue as {\n                      version: string;\n                      specifier: string;\n                    }\n                  ).version\n            ) as pnpmTypes.DepPath;\n            if (fullDependencyPath.includes('link:')) {\n              const dependencyProject: RushConfigurationProject | undefined =\n                this._rushConfiguration.getProjectByName(dependencyName);\n              if (dependencyProject && !this._checkedProjects?.has(dependencyProject)) {\n                this._checkedProjects!.add(project);\n                await this._searchAndValidateDependenciesAsync(dependencyProject, requiredVersions);\n              }\n            } else {\n              await this._checkVersionCompatibilityAsync(\n                shrinkwrapFileMajorVersion,\n                packages,\n                fullDependencyPath,\n                requiredVersions,\n                checkedDependencyPaths\n              );\n            }\n          }\n        }\n      })\n    );\n  }\n\n  private async _performVersionRestrictionCheckAsync(\n    requiredVersions: Record<string, string>,\n    projectName: string\n  ): Promise<string | undefined> {\n    try {\n      const project: RushConfigurationProject | undefined =\n        this._rushConfiguration?.getProjectByName(projectName);\n      if (!project) {\n        throw new Error(\n          `Specified project \"${projectName}\" does not exist in ${LOCKFILE_LINT_JSON_FILENAME}`\n        );\n      }\n      this._checkedProjects.add(project);\n      await this._searchAndValidateDependenciesAsync(project, requiredVersions);\n      return undefined;\n    } catch (e) {\n      return e.message;\n    }\n  }\n\n  protected override async onExecuteAsync(): Promise<void> {\n    const rushConfiguration: RushConfiguration | undefined = RushConfiguration.tryLoadFromDefaultLocation();\n    if (!rushConfiguration) {\n      throw new Error(\n        'The \"lockfile-explorer check\" must be executed in a folder that is under a Rush workspace folder'\n      );\n    }\n    this._rushConfiguration = rushConfiguration!;\n\n    const lintingFile: string = path.resolve(\n      this._rushConfiguration.commonFolder,\n      'config',\n      LOCKFILE_EXPLORER_FOLDERNAME,\n      LOCKFILE_LINT_JSON_FILENAME\n    );\n    const { rules }: ILockfileLint = await JsonFile.loadAndValidateAsync(\n      lintingFile,\n      JsonSchema.fromLoadedObject(lockfileLintSchema)\n    );\n    const issues: ILintIssue[] = [];\n    await Async.forEachAsync(\n      rules,\n      async ({ requiredVersions, project, rule }) => {\n        switch (rule) {\n          case 'restrict-versions': {\n            const message: string | undefined = await this._performVersionRestrictionCheckAsync(\n              requiredVersions,\n              project\n            );\n            if (message) {\n              issues.push({ project, rule, message });\n            }\n            break;\n          }\n\n          default: {\n            throw new Error('Unsupported rule name: ' + rule);\n          }\n        }\n      },\n      { concurrency: 50 }\n    );\n    if (issues.length > 0) {\n      this._terminal.writeLine();\n\n      // Deterministic order\n      for (const issue of issues.sort((a, b): number => {\n        let diff: number = a.project.localeCompare(b.project);\n        if (diff !== 0) {\n          return diff;\n        }\n        diff = a.rule.localeCompare(b.rule);\n        if (diff !== 0) {\n          return diff;\n        }\n        return a.message.localeCompare(b.message);\n      })) {\n        this._terminal.writeLine(\n          Colorize.red('PROBLEM: ') + Colorize.cyan(`[${issue.rule}] `) + issue.message + '\\n'\n        );\n      }\n\n      throw new AlreadyReportedError();\n    }\n    this._terminal.writeLine(Colorize.green('SUCCESS: ') + 'All checks passed.');\n  }\n}\n"]}
+{"version":3,"file":"CheckAction.js","sourceRoot":"","sources":["../../../../src/cli/lint/actions/CheckAction.ts"],"names":[],"mappings":"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","sourcesContent":["// Copyright (c) Microsoft Corporation. All rights reserved. Licensed under the MIT license.\n// See LICENSE in the project root for license information.\n\nimport path from 'node:path';\n\nimport yaml from 'js-yaml';\nimport semver from 'semver';\nimport type * as lockfileTypes from '@pnpm/lockfile.types';\nimport type * as pnpmTypes from '@pnpm/types';\n\nimport { RushConfiguration, type RushConfigurationProject, type Subspace } from '@rushstack/rush-sdk';\nimport { CommandLineAction } from '@rushstack/ts-command-line';\nimport { Colorize, type ITerminal } from '@rushstack/terminal';\nimport { AlreadyReportedError, Async, FileSystem, JsonFile, JsonSchema } from '@rushstack/node-core-library';\n\nimport lockfileLintSchema from '../../../schemas/lockfile-lint.schema.json';\nimport { LOCKFILE_EXPLORER_FOLDERNAME, LOCKFILE_LINT_JSON_FILENAME } from '../../../constants/common';\nimport {\n  getShrinkwrapFileMajorVersion,\n  parseDependencyPath,\n  splicePackageWithVersion\n} from '../../../utils/shrinkwrap';\n\nexport interface ILintRule {\n  rule: 'restrict-versions';\n  project: string;\n  requiredVersions: Record<string, string>;\n}\n\nexport interface ILockfileLint {\n  rules: ILintRule[];\n}\n\nexport interface ILintIssue {\n  project: string;\n  rule: string;\n  message: string;\n}\n\nexport class CheckAction extends CommandLineAction {\n  private readonly _terminal: ITerminal;\n\n  private _rushConfiguration!: RushConfiguration;\n  private _checkedProjects: Set<RushConfigurationProject>;\n  private _docMap: Map<string, lockfileTypes.LockfileObject>;\n\n  public constructor(terminal: ITerminal) {\n    super({\n      actionName: 'check',\n      summary: 'Check and report dependency issues in your workspace',\n      documentation:\n        'This command applies the policies that are configured in ' +\n        LOCKFILE_LINT_JSON_FILENAME +\n        ', reporting any problems found in your PNPM workspace.'\n    });\n\n    this._terminal = terminal;\n    this._checkedProjects = new Set();\n    this._docMap = new Map();\n  }\n\n  private async _checkVersionCompatibilityAsync(\n    shrinkwrapFileMajorVersion: number,\n    packages: lockfileTypes.PackageSnapshots | undefined,\n    dependencyPath: pnpmTypes.DepPath,\n    requiredVersions: Record<string, string>,\n    checkedDependencyPaths: Set<string>\n  ): Promise<void> {\n    if (packages && packages[dependencyPath] && !checkedDependencyPaths.has(dependencyPath)) {\n      checkedDependencyPaths.add(dependencyPath);\n      const { name, version } = parseDependencyPath(shrinkwrapFileMajorVersion, dependencyPath);\n      if (name in requiredVersions && !semver.satisfies(version, requiredVersions[name])) {\n        throw new Error(\n          `The version of \"${name}\" should match \"${requiredVersions[name]}\";` +\n            ` actual version is \"${version}\"`\n        );\n      }\n\n      await Promise.all(\n        Object.entries(packages[dependencyPath].dependencies ?? {}).map(\n          async ([dependencyPackageName, dependencyPackageVersion]) => {\n            await this._checkVersionCompatibilityAsync(\n              shrinkwrapFileMajorVersion,\n              packages,\n              splicePackageWithVersion(\n                shrinkwrapFileMajorVersion,\n                dependencyPackageName,\n                dependencyPackageVersion\n              ) as pnpmTypes.DepPath,\n              requiredVersions,\n              checkedDependencyPaths\n            );\n          }\n        )\n      );\n    }\n  }\n\n  private async _searchAndValidateDependenciesAsync(\n    project: RushConfigurationProject,\n    requiredVersions: Record<string, string>\n  ): Promise<void> {\n    this._terminal.writeLine(`Checking project \"${project.packageName}\"`);\n\n    const projectFolder: string = project.projectFolder;\n    const subspace: Subspace = project.subspace;\n    const shrinkwrapFilename: string = subspace.getCommittedShrinkwrapFilePath();\n    let doc: lockfileTypes.LockfileObject;\n    if (this._docMap.has(shrinkwrapFilename)) {\n      doc = this._docMap.get(shrinkwrapFilename)!;\n    } else {\n      const pnpmLockfileText: string = await FileSystem.readFileAsync(shrinkwrapFilename);\n      doc = yaml.load(pnpmLockfileText) as lockfileTypes.LockfileObject;\n      this._docMap.set(shrinkwrapFilename, doc);\n    }\n    const { importers, lockfileVersion, packages } = doc;\n    const shrinkwrapFileMajorVersion: number = getShrinkwrapFileMajorVersion(lockfileVersion);\n    const checkedDependencyPaths: Set<string> = new Set<string>();\n\n    await Promise.all(\n      Object.entries(importers).map(async ([relativePath, { dependencies }]) => {\n        if (path.resolve(projectFolder, relativePath) === projectFolder) {\n          const dependenciesEntries: [string, unknown][] = Object.entries(dependencies ?? {});\n          for (const [dependencyName, dependencyValue] of dependenciesEntries) {\n            const fullDependencyPath: pnpmTypes.DepPath = splicePackageWithVersion(\n              shrinkwrapFileMajorVersion,\n              dependencyName,\n              typeof dependencyValue === 'string'\n                ? dependencyValue\n                : (\n                    dependencyValue as {\n                      version: string;\n                      specifier: string;\n                    }\n                  ).version\n            ) as pnpmTypes.DepPath;\n            if (fullDependencyPath.includes('link:')) {\n              const dependencyProject: RushConfigurationProject | undefined =\n                this._rushConfiguration.getProjectByName(dependencyName);\n              if (dependencyProject && !this._checkedProjects?.has(dependencyProject)) {\n                this._checkedProjects!.add(project);\n                await this._searchAndValidateDependenciesAsync(dependencyProject, requiredVersions);\n              }\n            } else {\n              await this._checkVersionCompatibilityAsync(\n                shrinkwrapFileMajorVersion,\n                packages,\n                fullDependencyPath,\n                requiredVersions,\n                checkedDependencyPaths\n              );\n            }\n          }\n        }\n      })\n    );\n  }\n\n  private async _performVersionRestrictionCheckAsync(\n    requiredVersions: Record<string, string>,\n    projectName: string\n  ): Promise<string | undefined> {\n    try {\n      const project: RushConfigurationProject | undefined =\n        this._rushConfiguration?.getProjectByName(projectName);\n      if (!project) {\n        throw new Error(\n          `Specified project \"${projectName}\" does not exist in ${LOCKFILE_LINT_JSON_FILENAME}`\n        );\n      }\n      this._checkedProjects.add(project);\n      await this._searchAndValidateDependenciesAsync(project, requiredVersions);\n      return undefined;\n    } catch (e) {\n      return e.message;\n    }\n  }\n\n  protected override async onExecuteAsync(): Promise<void> {\n    const rushConfiguration: RushConfiguration | undefined = RushConfiguration.tryLoadFromDefaultLocation();\n    if (!rushConfiguration) {\n      throw new Error(\n        'The \"lockfile-explorer check\" must be executed in a folder that is under a Rush workspace folder'\n      );\n    }\n    this._rushConfiguration = rushConfiguration!;\n\n    const lintingFile: string = path.resolve(\n      this._rushConfiguration.commonFolder,\n      'config',\n      LOCKFILE_EXPLORER_FOLDERNAME,\n      LOCKFILE_LINT_JSON_FILENAME\n    );\n    const { rules }: ILockfileLint = await JsonFile.loadAndValidateAsync(\n      lintingFile,\n      JsonSchema.fromLoadedObject(lockfileLintSchema)\n    );\n    const issues: ILintIssue[] = [];\n    await Async.forEachAsync(\n      rules,\n      async ({ requiredVersions, project, rule }) => {\n        switch (rule) {\n          case 'restrict-versions': {\n            const message: string | undefined = await this._performVersionRestrictionCheckAsync(\n              requiredVersions,\n              project\n            );\n            if (message) {\n              issues.push({ project, rule, message });\n            }\n            break;\n          }\n\n          default: {\n            throw new Error('Unsupported rule name: ' + rule);\n          }\n        }\n      },\n      { concurrency: 50 }\n    );\n    if (issues.length > 0) {\n      this._terminal.writeLine();\n\n      // Deterministic order\n      for (const issue of issues.sort((a, b): number => {\n        let diff: number = a.project.localeCompare(b.project);\n        if (diff !== 0) {\n          return diff;\n        }\n        diff = a.rule.localeCompare(b.rule);\n        if (diff !== 0) {\n          return diff;\n        }\n        return a.message.localeCompare(b.message);\n      })) {\n        this._terminal.writeLine(\n          Colorize.red('PROBLEM: ') + Colorize.cyan(`[${issue.rule}] `) + issue.message + '\\n'\n        );\n      }\n\n      throw new AlreadyReportedError();\n    }\n    this._terminal.writeLine(Colorize.green('SUCCESS: ') + 'All checks passed.');\n  }\n}\n"]}

package/lib-commonjs/cli/lint/actions/InitAction.js

@@ -13,14 +13,14 @@ const rush_sdk_1 = require("@rushstack/rush-sdk");
 const node_core_library_1 = require("@rushstack/node-core-library");
 const common_1 = require("../../../constants/common");
 class InitAction extends ts_command_line_1.CommandLineAction {
-    constructor(parser) {
+    constructor(terminal) {
         super({
             actionName: 'init',
             summary: `Create a new ${common_1.LOCKFILE_LINT_JSON_FILENAME} config file`,
             documentation: `This command initializes a new ${common_1.LOCKFILE_LINT_JSON_FILENAME} config file.` +
                 `  The created template file includes source code comments that document the settings.`
         });
-        this._terminal = parser.globalTerminal;
+        this._terminal = terminal;
     }
     async onExecuteAsync() {
         const rushConfiguration = rush_sdk_1.RushConfiguration.tryLoadFromDefaultLocation();

package/lib-commonjs/cli/lint/actions/InitAction.js.map

@@ -1 +1 @@
-{"version":3,"file":"InitAction.js","sourceRoot":"","sources":["../../../../src/cli/lint/actions/InitAction.ts"],"names":[],"mappings":";AAAA,4FAA4F;AAC5F,2DAA2D;;;;;;AAE3D,0DAA6B;AAE7B,gEAA+D;AAC/D,kDAA+D;AAC/D,kDAAwD;AACxD,oEAA0D;AAG1D,sDAAsG;AAEtG,MAAa,UAAW,SAAQ,mCAAiB;IAG/C,YAAmB,MAA6B;QAC9C,KAAK,CAAC;YACJ,UAAU,EAAE,MAAM;YAClB,OAAO,EAAE,gBAAgB,oCAA2B,cAAc;YAClE,aAAa,EACX,kCAAkC,oCAA2B,eAAe;gBAC5E,uFAAuF;SAC1F,CAAC,CAAC;QACH,IAAI,CAAC,SAAS,GAAG,MAAM,CAAC,cAAc,CAAC;IACzC,CAAC;IAEkB,KAAK,CAAC,cAAc;QACrC,MAAM,iBAAiB,GAAkC,4BAAiB,CAAC,0BAA0B,EAAE,CAAC;QACxG,IAAI,CAAC,iBAAiB,EAAE,CAAC;YACvB,MAAM,IAAI,KAAK,CACb,kGAAkG,CACnG,CAAC;QACJ,CAAC;QACD,MAAM,aAAa,GAAW,mBAAI,CAAC,OAAO,CACxC,SAAS,EACT,uDAAuD,CACxD,CAAC;QACF,MAAM,cAAc,GAAW,mBAAI,CAAC,OAAO,CACzC,iBAAiB,CAAC,YAAY,EAC9B,QAAQ,EACR,qCAA4B,EAC5B,oCAA2B,CAC5B,CAAC;QAEF,IAAI,MAAM,8BAAU,CAAC,WAAW,CAAC,cAAc,CAAC,EAAE,CAAC;YACjD,IAAI,CAAC,SAAS,CAAC,UAAU,CAAC,iCAAiC,CAAC,CAAC;YAC7D,IAAI,CAAC,SAAS,CAAC,SAAS,CAAC,MAAM,GAAG,cAAc,GAAG,IAAI,CAAC,CAAC;YACzD,MAAM,IAAI,KAAK,CAAC,6BAA6B,CAAC,CAAC;QACjD,CAAC;QAED,IAAI,CAAC,SAAS,CAAC,SAAS,CAAC,mBAAQ,CAAC,KAAK,CAAC,gBAAgB,CAAC,GAAG,cAAc,CAAC,CAAC;QAC5E,MAAM,8BAAU,CAAC,aAAa,CAAC;YAC7B,UAAU,EAAE,aAAa;YACzB,eAAe,EAAE,cAAc;SAChC,CAAC,CAAC;IACL,CAAC;CACF;AA5CD,gCA4CC","sourcesContent":["// Copyright (c) Microsoft Corporation. All rights reserved. Licensed under the MIT license.\n// See LICENSE in the project root for license information.\n\nimport path from 'node:path';\n\nimport { CommandLineAction } from '@rushstack/ts-command-line';\nimport { Colorize, type ITerminal } from '@rushstack/terminal';\nimport { RushConfiguration } from '@rushstack/rush-sdk';\nimport { FileSystem } from '@rushstack/node-core-library';\n\nimport type { LintCommandLineParser } from '../LintCommandLineParser';\nimport { LOCKFILE_EXPLORER_FOLDERNAME, LOCKFILE_LINT_JSON_FILENAME } from '../../../constants/common';\n\nexport class InitAction extends CommandLineAction {\n  private readonly _terminal: ITerminal;\n\n  public constructor(parser: LintCommandLineParser) {\n    super({\n      actionName: 'init',\n      summary: `Create a new ${LOCKFILE_LINT_JSON_FILENAME} config file`,\n      documentation:\n        `This command initializes a new ${LOCKFILE_LINT_JSON_FILENAME} config file.` +\n        `  The created template file includes source code comments that document the settings.`\n    });\n    this._terminal = parser.globalTerminal;\n  }\n\n  protected override async onExecuteAsync(): Promise<void> {\n    const rushConfiguration: RushConfiguration | undefined = RushConfiguration.tryLoadFromDefaultLocation();\n    if (!rushConfiguration) {\n      throw new Error(\n        'The \"lockfile-explorer check\" must be executed in a folder that is under a Rush workspace folder'\n      );\n    }\n    const inputFilePath: string = path.resolve(\n      __dirname,\n      '../../../assets/lint-init/lockfile-lint-template.json'\n    );\n    const outputFilePath: string = path.resolve(\n      rushConfiguration.commonFolder,\n      'config',\n      LOCKFILE_EXPLORER_FOLDERNAME,\n      LOCKFILE_LINT_JSON_FILENAME\n    );\n\n    if (await FileSystem.existsAsync(outputFilePath)) {\n      this._terminal.writeError('The output file already exists:');\n      this._terminal.writeLine('\\n  ' + outputFilePath + '\\n');\n      throw new Error('Unable to write output file');\n    }\n\n    this._terminal.writeLine(Colorize.green('Writing file: ') + outputFilePath);\n    await FileSystem.copyFileAsync({\n      sourcePath: inputFilePath,\n      destinationPath: outputFilePath\n    });\n  }\n}\n"]}
+{"version":3,"file":"InitAction.js","sourceRoot":"","sources":["../../../../src/cli/lint/actions/InitAction.ts"],"names":[],"mappings":";AAAA,4FAA4F;AAC5F,2DAA2D;;;;;;AAE3D,0DAA6B;AAE7B,gEAA+D;AAC/D,kDAA+D;AAC/D,kDAAwD;AACxD,oEAA0D;AAE1D,sDAAsG;AAEtG,MAAa,UAAW,SAAQ,mCAAiB;IAG/C,YAAmB,QAAmB;QACpC,KAAK,CAAC;YACJ,UAAU,EAAE,MAAM;YAClB,OAAO,EAAE,gBAAgB,oCAA2B,cAAc;YAClE,aAAa,EACX,kCAAkC,oCAA2B,eAAe;gBAC5E,uFAAuF;SAC1F,CAAC,CAAC;QACH,IAAI,CAAC,SAAS,GAAG,QAAQ,CAAC;IAC5B,CAAC;IAEkB,KAAK,CAAC,cAAc;QACrC,MAAM,iBAAiB,GAAkC,4BAAiB,CAAC,0BAA0B,EAAE,CAAC;QACxG,IAAI,CAAC,iBAAiB,EAAE,CAAC;YACvB,MAAM,IAAI,KAAK,CACb,kGAAkG,CACnG,CAAC;QACJ,CAAC;QACD,MAAM,aAAa,GAAW,mBAAI,CAAC,OAAO,CACxC,SAAS,EACT,uDAAuD,CACxD,CAAC;QACF,MAAM,cAAc,GAAW,mBAAI,CAAC,OAAO,CACzC,iBAAiB,CAAC,YAAY,EAC9B,QAAQ,EACR,qCAA4B,EAC5B,oCAA2B,CAC5B,CAAC;QAEF,IAAI,MAAM,8BAAU,CAAC,WAAW,CAAC,cAAc,CAAC,EAAE,CAAC;YACjD,IAAI,CAAC,SAAS,CAAC,UAAU,CAAC,iCAAiC,CAAC,CAAC;YAC7D,IAAI,CAAC,SAAS,CAAC,SAAS,CAAC,MAAM,GAAG,cAAc,GAAG,IAAI,CAAC,CAAC;YACzD,MAAM,IAAI,KAAK,CAAC,6BAA6B,CAAC,CAAC;QACjD,CAAC;QAED,IAAI,CAAC,SAAS,CAAC,SAAS,CAAC,mBAAQ,CAAC,KAAK,CAAC,gBAAgB,CAAC,GAAG,cAAc,CAAC,CAAC;QAC5E,MAAM,8BAAU,CAAC,aAAa,CAAC;YAC7B,UAAU,EAAE,aAAa;YACzB,eAAe,EAAE,cAAc;SAChC,CAAC,CAAC;IACL,CAAC;CACF;AA5CD,gCA4CC","sourcesContent":["// Copyright (c) Microsoft Corporation. All rights reserved. Licensed under the MIT license.\n// See LICENSE in the project root for license information.\n\nimport path from 'node:path';\n\nimport { CommandLineAction } from '@rushstack/ts-command-line';\nimport { Colorize, type ITerminal } from '@rushstack/terminal';\nimport { RushConfiguration } from '@rushstack/rush-sdk';\nimport { FileSystem } from '@rushstack/node-core-library';\n\nimport { LOCKFILE_EXPLORER_FOLDERNAME, LOCKFILE_LINT_JSON_FILENAME } from '../../../constants/common';\n\nexport class InitAction extends CommandLineAction {\n  private readonly _terminal: ITerminal;\n\n  public constructor(terminal: ITerminal) {\n    super({\n      actionName: 'init',\n      summary: `Create a new ${LOCKFILE_LINT_JSON_FILENAME} config file`,\n      documentation:\n        `This command initializes a new ${LOCKFILE_LINT_JSON_FILENAME} config file.` +\n        `  The created template file includes source code comments that document the settings.`\n    });\n    this._terminal = terminal;\n  }\n\n  protected override async onExecuteAsync(): Promise<void> {\n    const rushConfiguration: RushConfiguration | undefined = RushConfiguration.tryLoadFromDefaultLocation();\n    if (!rushConfiguration) {\n      throw new Error(\n        'The \"lockfile-explorer check\" must be executed in a folder that is under a Rush workspace folder'\n      );\n    }\n    const inputFilePath: string = path.resolve(\n      __dirname,\n      '../../../assets/lint-init/lockfile-lint-template.json'\n    );\n    const outputFilePath: string = path.resolve(\n      rushConfiguration.commonFolder,\n      'config',\n      LOCKFILE_EXPLORER_FOLDERNAME,\n      LOCKFILE_LINT_JSON_FILENAME\n    );\n\n    if (await FileSystem.existsAsync(outputFilePath)) {\n      this._terminal.writeError('The output file already exists:');\n      this._terminal.writeLine('\\n  ' + outputFilePath + '\\n');\n      throw new Error('Unable to write output file');\n    }\n\n    this._terminal.writeLine(Colorize.green('Writing file: ') + outputFilePath);\n    await FileSystem.copyFileAsync({\n      sourcePath: inputFilePath,\n      destinationPath: outputFilePath\n    });\n  }\n}\n"]}

package/lib-commonjs/start-explorer.js

@@ -2,7 +2,9 @@
 // Copyright (c) Microsoft Corporation. All rights reserved. Licensed under the MIT license.
 // See LICENSE in the project root for license information.
 Object.defineProperty(exports, "__esModule", { value: true });
+const index_1 = require("@rushstack/terminal/lib/index");
 const ExplorerCommandLineParser_1 = require("./cli/explorer/ExplorerCommandLineParser");
-const parser = new ExplorerCommandLineParser_1.ExplorerCommandLineParser();
+const terminal = new index_1.Terminal(new index_1.ConsoleTerminalProvider());
+const parser = new ExplorerCommandLineParser_1.ExplorerCommandLineParser(terminal);
 parser.executeAsync().catch(console.error); // CommandLineParser.executeAsync() should never reject the promise
 //# sourceMappingURL=start-explorer.js.map

package/lib-commonjs/start-explorer.js.map

@@ -1 +1 @@
-{"version":3,"file":"start-explorer.js","sourceRoot":"","sources":["../src/start-explorer.ts"],"names":[],"mappings":";AAAA,4FAA4F;AAC5F,2DAA2D;;AAE3D,wFAAqF;AAErF,MAAM,MAAM,GAA8B,IAAI,qDAAyB,EAAE,CAAC;AAE1E,MAAM,CAAC,YAAY,EAAE,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC,mEAAmE","sourcesContent":["// Copyright (c) Microsoft Corporation. All rights reserved. Licensed under the MIT license.\n// See LICENSE in the project root for license information.\n\nimport { ExplorerCommandLineParser } from './cli/explorer/ExplorerCommandLineParser';\n\nconst parser: ExplorerCommandLineParser = new ExplorerCommandLineParser();\n\nparser.executeAsync().catch(console.error); // CommandLineParser.executeAsync() should never reject the promise\n"]}
+{"version":3,"file":"start-explorer.js","sourceRoot":"","sources":["../src/start-explorer.ts"],"names":[],"mappings":";AAAA,4FAA4F;AAC5F,2DAA2D;;AAE3D,yDAAkF;AAElF,wFAAqF;AAErF,MAAM,QAAQ,GAAa,IAAI,gBAAQ,CAAC,IAAI,+BAAuB,EAAE,CAAC,CAAC;AACvE,MAAM,MAAM,GAA8B,IAAI,qDAAyB,CAAC,QAAQ,CAAC,CAAC;AAElF,MAAM,CAAC,YAAY,EAAE,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC,mEAAmE","sourcesContent":["// Copyright (c) Microsoft Corporation. All rights reserved. Licensed under the MIT license.\n// See LICENSE in the project root for license information.\n\nimport { ConsoleTerminalProvider, Terminal } from '@rushstack/terminal/lib/index';\n\nimport { ExplorerCommandLineParser } from './cli/explorer/ExplorerCommandLineParser';\n\nconst terminal: Terminal = new Terminal(new ConsoleTerminalProvider());\nconst parser: ExplorerCommandLineParser = new ExplorerCommandLineParser(terminal);\n\nparser.executeAsync().catch(console.error); // CommandLineParser.executeAsync() should never reject the promise\n"]}

package/lib-commonjs/start-lint.js

@@ -2,7 +2,9 @@
 // Copyright (c) Microsoft Corporation. All rights reserved. Licensed under the MIT license.
 // See LICENSE in the project root for license information.
 Object.defineProperty(exports, "__esModule", { value: true });
+const index_1 = require("@rushstack/terminal/lib/index");
 const LintCommandLineParser_1 = require("./cli/lint/LintCommandLineParser");
-const parser = new LintCommandLineParser_1.LintCommandLineParser();
+const terminal = new index_1.Terminal(new index_1.ConsoleTerminalProvider());
+const parser = new LintCommandLineParser_1.LintCommandLineParser(terminal);
 parser.executeAsync().catch(console.error); // CommandLineParser.executeAsync() should never reject the promise
 //# sourceMappingURL=start-lint.js.map

package/lib-commonjs/start-lint.js.map

@@ -1 +1 @@
-{"version":3,"file":"start-lint.js","sourceRoot":"","sources":["../src/start-lint.ts"],"names":[],"mappings":";AAAA,4FAA4F;AAC5F,2DAA2D;;AAE3D,4EAAyE;AAEzE,MAAM,MAAM,GAA0B,IAAI,6CAAqB,EAAE,CAAC;AAElE,MAAM,CAAC,YAAY,EAAE,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC,mEAAmE","sourcesContent":["// Copyright (c) Microsoft Corporation. All rights reserved. Licensed under the MIT license.\n// See LICENSE in the project root for license information.\n\nimport { LintCommandLineParser } from './cli/lint/LintCommandLineParser';\n\nconst parser: LintCommandLineParser = new LintCommandLineParser();\n\nparser.executeAsync().catch(console.error); // CommandLineParser.executeAsync() should never reject the promise\n"]}
+{"version":3,"file":"start-lint.js","sourceRoot":"","sources":["../src/start-lint.ts"],"names":[],"mappings":";AAAA,4FAA4F;AAC5F,2DAA2D;;AAE3D,yDAAkF;AAElF,4EAAyE;AAEzE,MAAM,QAAQ,GAAa,IAAI,gBAAQ,CAAC,IAAI,+BAAuB,EAAE,CAAC,CAAC;AACvE,MAAM,MAAM,GAA0B,IAAI,6CAAqB,CAAC,QAAQ,CAAC,CAAC;AAE1E,MAAM,CAAC,YAAY,EAAE,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC,mEAAmE","sourcesContent":["// Copyright (c) Microsoft Corporation. All rights reserved. Licensed under the MIT license.\n// See LICENSE in the project root for license information.\n\nimport { ConsoleTerminalProvider, Terminal } from '@rushstack/terminal/lib/index';\n\nimport { LintCommandLineParser } from './cli/lint/LintCommandLineParser';\n\nconst terminal: Terminal = new Terminal(new ConsoleTerminalProvider());\nconst parser: LintCommandLineParser = new LintCommandLineParser(terminal);\n\nparser.executeAsync().catch(console.error); // CommandLineParser.executeAsync() should never reject the promise\n"]}

package/lib-commonjs/utils/PackageUpdateChecker.js

@@ -0,0 +1,120 @@
+"use strict";
+// Copyright (c) Microsoft Corporation. All rights reserved. Licensed under the MIT license.
+// See LICENSE in the project root for license information.
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.PackageUpdateChecker = void 0;
+const node_os_1 = require("node:os");
+const semver_1 = __importDefault(require("semver"));
+const node_core_library_1 = require("@rushstack/node-core-library");
+const REGISTRY_BASE_URL = 'https://registry.npmjs.org';
+const FETCH_TIMEOUT_MS = 5000;
+const DEFAULT_CACHE_EXPIRY_MS = 24 * 60 * 60 * 1000; // 24 hours
+const CACHE_VERSION = 1;
+const CACHE_FOLDER = `${(0, node_os_1.homedir)()}/.rushstack/update-checks`;
+async function _tryFetchLatestVersionAsync(packageName) {
+    const url = `${REGISTRY_BASE_URL}/${encodeURIComponent(packageName)}/latest`;
+    const controller = new AbortController();
+    const timeout = setTimeout(() => controller.abort(), FETCH_TIMEOUT_MS);
+    try {
+        const response = await fetch(url, { signal: controller.signal });
+        if (!response.ok) {
+            return undefined;
+        }
+        const { version } = (await response.json());
+        return typeof version === 'string' ? version : undefined;
+    }
+    catch (_a) {
+        // Network errors, timeouts, and parse failures are all silent.
+        return undefined;
+    }
+    finally {
+        clearTimeout(timeout);
+    }
+}
+async function _readCacheAsync(filePath) {
+    try {
+        const data = await node_core_library_1.JsonFile.loadAsync(filePath);
+        const { cacheVersion, ...rest } = data;
+        if (cacheVersion === CACHE_VERSION) {
+            return rest;
+        }
+    }
+    catch (_a) {
+        // Ignore
+    }
+}
+async function _writeCacheAsync(filePath, cache) {
+    try {
+        const cacheData = {
+            cacheVersion: CACHE_VERSION,
+            checkedAt: Date.now(),
+            ...cache
+        };
+        await node_core_library_1.JsonFile.saveAsync(cacheData, filePath, {
+            ensureFolderExists: true
+        });
+    }
+    catch (_a) {
+        // Cache write failures are silent — a stale or missing cache just means
+        // we'll re-fetch on the next invocation.
+    }
+}
+/**
+ * Checks npm for a newer version of a package and caches the result locally so that
+ * the registry is not queried on every invocation.
+ *
+ * @internal
+ */
+class PackageUpdateChecker {
+    constructor(options) {
+        const { packageName, currentVersion, skip = false, forceCheck = false, cacheExpiryMs = DEFAULT_CACHE_EXPIRY_MS } = options;
+        this._packageName = packageName;
+        this._currentVersion = currentVersion;
+        this._skip = skip;
+        this._forceCheck = forceCheck;
+        this._cacheExpiryMs = cacheExpiryMs;
+    }
+    /**
+     * Performs the update check and returns the result, or `undefined` if the check
+     * was skipped or the registry could not be reached.
+     */
+    async tryGetUpdateAsync() {
+        if (this._skip) {
+            return undefined;
+        }
+        const cacheFilePath = this._getCacheFilePath();
+        let latestVersion;
+        if (!this._forceCheck) {
+            const cached = await _readCacheAsync(cacheFilePath);
+            if (cached !== undefined) {
+                const { checkedAt, latestVersion: latestVersionFromCache } = cached;
+                const ageMs = Date.now() - checkedAt;
+                if (ageMs < this._cacheExpiryMs) {
+                    latestVersion = latestVersionFromCache;
+                }
+            }
+        }
+        if (latestVersion === undefined) {
+            // Cache is missing or stale — fetch from the registry.
+            latestVersion = await _tryFetchLatestVersionAsync(this._packageName);
+            if (latestVersion === undefined) {
+                return undefined;
+            }
+            await _writeCacheAsync(cacheFilePath, { latestVersion });
+        }
+        return {
+            latestVersion,
+            isOutdated: semver_1.default.gt(latestVersion, this._currentVersion)
+        };
+    }
+    _getCacheFilePath() {
+        // Replace characters that are unsafe in file names (e.g. the "/" in scoped package names).
+        const sanitizedName = this._packageName.replace(/[^a-zA-Z0-9._-]/g, '_');
+        return `${CACHE_FOLDER}/${sanitizedName}.json`;
+    }
+}
+exports.PackageUpdateChecker = PackageUpdateChecker;
+//# sourceMappingURL=PackageUpdateChecker.js.map