additional tools during nodejs processes invocation

docs/notes/2.25.x.md

@@ -128,6 +128,15 @@ python_requirement(name="black", resolve="your-resolve-name", requirements=["bla
 
 The previously deprecated `[shell-setup].tailor` option has now been removed. See [`[shell-setup].tailor_sources`](https://www.pantsbuild.org/2.25/reference/subsystems/shell-setup#tailor_sources) and [`[shell-setup].tailor_shunit2_tests`](https://www.pantsbuild.org/2.25/reference/subsystems/shell#tailor_shunit2_tests) to update.
 
+#### Javascript
+
+The NodeJS subsystem now supports configuring additional tools that should be available in the NodeJS process environment:
+
+- [`[nodejs].tools`](https://www.pantsbuild.org/2.25/reference/subsystems/nodejs#tools): List any additional executable tools required for node processes to work.
+- [`[nodejs].macos_tools`](https://www.pantsbuild.org/2.25/reference/subsystems/nodejs#macos_tools): List any additional executable tools required specifically for macOS.
+
+The paths to these tools will be included in the PATH used in the execution sandbox, so that they may be used by NodeJS processes during execution.
+
 ### Plugin API changes
 
 The version of Python used by Pants itself is now [3.11](https://docs.python.org/3/whatsnew/3.11.html) (up from 3.9).

src/python/pants/backend/javascript/subsystems/nodejs.py

@@ -159,6 +159,38 @@ def default_package_manager(self) -> str | None:
             return f"{self.package_manager}@{self.package_managers[self.package_manager]}"
         return self.package_manager
 
+    _tools = StrListOption(
+        default=[],
+        help=softwrap(
+            """
+            List any additional executable tools required for node processes to work. The paths to
+            these tools will be included in the PATH used in the execution sandbox, so that
+            they may be used by nodejs processes execution.
+            """
+        ),
+        advanced=True,
+    )
+
+    _macos_tools = StrListOption(
+        default=[],
+        help=softwrap(
+            """
+            List any additional executable tools required for node processes to work on macOS.
+            The paths to these tools will be included in the PATH used in the execution sandbox,
+            so that they may be used by nodejs processes execution.
+            """
+        ),
+        advanced=True,
+    )
+
+    @property
+    def tools(self) -> tuple[str, ...]:
+        return tuple(sorted(set(self._tools)))
+
+    @property
+    def macos_tools(self) -> tuple[str, ...]:
+        return tuple(sorted(set(self._macos_tools)))
+
     class EnvironmentAware(ExecutableSearchPathsOptionMixin, Subsystem.EnvironmentAware):
         search_path = StrListOption(
             default=["<PATH>"],
@@ -350,22 +382,33 @@ async def add_corepack_shims_to_digest(
 
 @rule(level=LogLevel.DEBUG)
 async def node_process_environment(
-    binaries: NodeJSBinaries, nodejs: NodeJS.EnvironmentAware
+    binaries: NodeJSBinaries,
+    nodejs: NodeJS,
+    nodejs_environment: NodeJS.EnvironmentAware,
+    platform: Platform,
 ) -> NodeJSProcessEnvironment:
     default_required_tools = ["sh", "bash"]
     tools_used_by_setup_scripts = ["mkdir", "rm", "touch", "which"]
     pnpm_shim_tools = ["sed", "dirname"]
+
+    additional_tools = nodejs.tools
+    if platform.is_macos:
+        additional_tools.extend(nodejs.macos_tools)
+
     binary_shims = await Get(
         BinaryShims,
         BinaryShimsRequest.for_binaries(
             *default_required_tools,
             *tools_used_by_setup_scripts,
             *pnpm_shim_tools,
+            *additional_tools,
             rationale="execute a nodejs process",
-            search_path=nodejs.executable_search_path,
+            search_path=nodejs_environment.executable_search_path,
         ),
     )
-    corepack_env_vars = await Get(EnvironmentVars, EnvironmentVarsRequest(nodejs.corepack_env_vars))
+    corepack_env_vars = await Get(
+        EnvironmentVars, EnvironmentVarsRequest(nodejs_environment.corepack_env_vars)
+    )
     binary_digest_with_shims = await add_corepack_shims_to_digest(
         binaries, binary_shims, corepack_env_vars
     )