feat(ng-dev): add command to generate Bazel Node.js toolchain definitions

This commit introduces a new `ng-dev` command:
`misc generate-nodejs-toolchain <version>`

This command automates the creation of `nodejs_register_toolchains`
Bazel rules by fetching official Node.js release checksums for a given version and outputting the Starlark definition. This simplifies managing Node.js versions in Bazel.

Example usage:
```
$ pnpm ng-dev misc generate-nodejs-toolchain 24.0.0

This will output:
nodejs_register_toolchains(
    name = "node24",
    node_repositories = {
        "24.0.0-darwin_arm64": ("node-v24.0.0-darwin-arm64.tar.gz", "node-v24.0.0-darwin-arm64", "194e2f3dd3ec8c2adcaa713ed40f44c5ca38467880e160974ceac1659be60121"),
        "24.0.0-darwin_amd64": ("node-v24.0.0-darwin-x64.tar.gz", "node-v24.0.0-darwin-x64", "f716b3ce14a7e37a6cbf97c9de10d444d7da07ef833cd8da81dd944d111e6a4a"),
        # ... other platforms
    },
    node_version = "24.0.0",
)
```

Author: alan-agius4

ng-dev/misc/cli.ts

@@ -10,6 +10,7 @@ import {Argv} from 'yargs';
 import {BuildAndLinkCommandModule} from './build-and-link/cli.js';
 import {UpdateYarnCommandModule} from './update-yarn/cli.js';
 import {GeneratedFilesModule} from './generated-files/cli.js';
+import {GeneratedNodeJsToolchainModule} from './generate-nodejs-toolchain/cli.js';
 
 /** Build the parser for the misc commands. */
 export function buildMiscParser(localYargs: Argv) {
@@ -18,5 +19,6 @@ export function buildMiscParser(localYargs: Argv) {
     .strict()
     .command(BuildAndLinkCommandModule)
     .command(UpdateYarnCommandModule)
-    .command(GeneratedFilesModule);
+    .command(GeneratedFilesModule)
+    .command(GeneratedNodeJsToolchainModule);
 }

ng-dev/misc/generate-nodejs-toolchain/cli.ts

@@ -0,0 +1,132 @@
+import https from 'node:https';
+import {Log} from '../../utils/logging.js';
+import {Arguments, Argv, CommandModule} from 'yargs';
+
+interface RepositoryInfo {
+  filename: string;
+  sha: string;
+  type: string;
+}
+
+interface NodeVersionData {
+  version: string;
+  repositories: RepositoryInfo[];
+}
+
+/** Command line options. */
+export interface GenerateNodeJsToolchainOptions {
+  nodeJsVersion: string;
+}
+
+function builder(argv: Argv): Argv<GenerateNodeJsToolchainOptions> {
+  return argv
+    .positional('nodeJsVersion', {
+      type: 'string',
+      demandOption: true,
+    })
+    .check(({nodeJsVersion}) => {
+      if (!/^\d+\.\d+\.\d+$/.test(nodeJsVersion)) {
+        throw new Error(
+          `Invalid version format "${nodeJsVersion}". Expected X.Y.Z (Example: 22.11.0)`,
+        );
+      }
+
+      return true;
+    });
+}
+
+/** CLI command module. */
+export const GeneratedNodeJsToolchainModule: CommandModule<{}, GenerateNodeJsToolchainOptions> = {
+  builder,
+  handler,
+  command: 'generate-nodejs-toolchain <nodeJsVersion>',
+  describe: 'Generates a Bazel toolchain definition for a specific Node.js version.',
+};
+
+const REPOSITORY_TYPES: Record<string, string> = {
+  'darwin-arm64.tar.gz': 'darwin_arm64',
+  'darwin-x64.tar.gz': 'darwin_amd64',
+  'linux-x64.tar.xz': 'linux_amd64',
+  'linux-arm64.tar.xz': 'linux_arm64',
+  'linux-s390x.tar.xz': 'linux_s390x',
+  'win-x64.zip': 'windows_amd64',
+  'linux-ppc64le.tar.xz': 'linux_ppc64le',
+};
+
+function getText(url: string): Promise<string> {
+  return new Promise<string>((resolve, reject) => {
+    const request = https.get(url, (res) => {
+      if (res.statusCode !== 200) {
+        return reject(
+          new Error(`Failed to get ${url}. Status Code: ${res.statusCode ?? 'unknown'}`),
+        );
+      }
+
+      const body: string[] = [];
+      res.on('data', (chunk) => body.push(chunk));
+      res.on('end', () => resolve(body.join('')));
+    });
+
+    request.on('error', (err) => reject(err));
+  });
+}
+
+async function getNodeJsRepositories(version: string): Promise<NodeVersionData> {
+  const text = await getText(`https://nodejs.org/dist/v${version}/SHASUMS256.txt`);
+
+  const repositories: RepositoryInfo[] = text
+    .split('\n')
+    .filter(Boolean) // Remove empty lines
+    .map((line: string): RepositoryInfo | undefined => {
+      const [sha, filename] = line.trim().split(/\s+/);
+      if (!filename) {
+        return undefined;
+      }
+
+      // Extract the part of the filename that matches REPOSITORY_TYPES keys
+      // Example: "node-v22.2.0-darwin-arm64.tar.gz" -> "darwin-arm64.tar.gz"
+      const fileTypeSuffix = filename.replace(/^node-v[\d.]+-/, '');
+      const type = REPOSITORY_TYPES[fileTypeSuffix];
+
+      return type ? {filename, sha, type} : undefined;
+    })
+    .filter((repo): repo is RepositoryInfo => repo !== undefined);
+
+  return {
+    version,
+    repositories,
+  };
+}
+
+async function handler({nodeJsVersion}: Arguments<GenerateNodeJsToolchainOptions>): Promise<void> {
+  try {
+    const {version, repositories} = await getNodeJsRepositories(nodeJsVersion);
+    if (!repositories?.length) {
+      Log.error(
+        `  ✘   Could not find any downloadable files for Node.js version ${version}. ` +
+          `Please check if the version exists and has published binaries at https://nodejs.org/dist/v${version}/`,
+      );
+      process.exit(1);
+    }
+
+    const [majorVersion] = version.split('.');
+    console.log(`nodejs_register_toolchains(`);
+    console.log(`    name = "node${majorVersion}",`);
+    console.log(`    node_repositories = {`);
+
+    for (const {filename, sha, type} of repositories) {
+      // Remove file extension (.zip, .tar.xr .tar.gz etc...)
+      const strippedFilename = filename.replace(/(\.tar)?\.[^.]+$/, '');
+      console.log(
+        `        "${version}-${type}": ("${filename}", "${strippedFilename}", "${sha}"),`,
+      );
+    }
+
+    console.log(`    },`);
+    console.log(`    node_version = "${version}",`);
+    console.log(`)\n`);
+  } catch (error) {
+    Log.error(`  ✘  Aborted due to an error:\n${error}`);
+    process.exit(1);
+  }
+}