[DCA11Y-1145] Node version manager support

frontend-maven-plugin/src/it/node-version-manager-install-with-fnm/.bash_profile

@@ -0,0 +1,3 @@
+FNM_DIR=$HOME/.fnm
+PATH=$FNM_DIR:$PATH
+eval "$(fnm env --use-on-cd --shell bash)"

frontend-maven-plugin/src/it/node-version-manager-install-with-fnm/.gitignore

@@ -0,0 +1 @@
+node_modules

frontend-maven-plugin/src/it/node-version-manager-install-with-fnm/.nvmrc

@@ -0,0 +1 @@
+v20.15.1

frontend-maven-plugin/src/it/node-version-manager-install-with-fnm/install-fnm.sh

@@ -0,0 +1,9 @@
+#!/bin/bash
+
+# invoker env variables are not loaded yet
+export HOME="$(dirname "$0")"
+
+export FNM_DIR="$HOME/.fnm";
+mkdir "$FNM_DIR"
+
+curl -fsSL https://fnm.vercel.app/install | bash -s -- --install-dir "$FNM_DIR" --skip-shell --force-install

frontend-maven-plugin/src/it/node-version-manager-install-with-fnm/invoker.properties

@@ -0,0 +1,4 @@
+invoker.environmentVariables.HOME=${basedir}/target/its/node-version-manager-install-with-fnm
+invoker.environmentVariables.FNM_DIR=${basedir}/target/its/node-version-manager-install-with-fnm/.fnm
+invoker.environmentVariables.XDG_DATA_HOME=${basedir}/target/its/node-version-manager-install-with-fnm
+invoker.environmentVariables.SHELL=bash

frontend-maven-plugin/src/it/node-version-manager-install-with-fnm/package.json

@@ -0,0 +1,10 @@
+{
+  "name": "example",
+  "version": "0.0.1",
+  "dependencies": {
+    "classnames": "^2.3.2"
+  },
+  "scripts": {
+    "prebuild": "npm install"
+  }
+}

frontend-maven-plugin/src/it/node-version-manager-install-with-fnm/pom.xml

@@ -0,0 +1,46 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<project xmlns="http://maven.apache.org/POM/4.0.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/xsd/maven-4.0.0.xsd">
+    <modelVersion>4.0.0</modelVersion>
+
+    <groupId>com.github.eirslett</groupId>
+    <artifactId>example</artifactId>
+    <version>0</version>
+    <packaging>pom</packaging>
+
+    <build>
+        <plugins>
+            <plugin>
+                <groupId>com.github.eirslett</groupId>
+                <artifactId>frontend-maven-plugin</artifactId>
+                <!-- NB! Set <version> to the latest released version of frontend-maven-plugin, like in README.md -->
+                <version>@project.version@</version>
+
+                <configuration>
+                    <nodeVersion>20.15.1</nodeVersion>
+                    <workingDirectory>${basedir}</workingDirectory>
+                    <useNodeVersionManager>true</useNodeVersionManager>
+                </configuration>
+
+                <executions>
+                    <execution>
+                        <id>install node</id>
+                        <goals>
+                            <goal>install-node-and-npm</goal>
+                        </goals>
+                    </execution>
+                    <execution>
+                        <id>npm ci</id>
+                        <goals>
+                            <goal>npm</goal>
+                        </goals>
+                        <!-- Optional configuration which provides for running any npm command -->
+                        <configuration>
+                            <arguments>ci</arguments>
+                        </configuration>
+                    </execution>
+
+                </executions>
+            </plugin>
+        </plugins>
+    </build>
+</project>

frontend-maven-plugin/src/it/node-version-manager-install-with-fnm/prebuild.groovy

@@ -0,0 +1,3 @@
+def p = "sh $basedir/install-fnm.sh".execute()
+p.waitFor()
+println p.text

frontend-maven-plugin/src/it/node-version-manager-install-with-fnm/verify.groovy

@@ -0,0 +1,8 @@
+import org.codehaus.plexus.util.FileUtils
+
+// assert
+assert !new File(basedir, 'node').exists() : "Node was installed in the custom install directory"
+assert new File(basedir, 'node_modules').exists() : "Node modules were not installed in the base directory"
+
+String buildLog = FileUtils.fileRead(new File(basedir, 'build.log'))
+assert buildLog.contains('BUILD SUCCESS') : 'build was not successful'

frontend-maven-plugin/src/it/node-version-manager-install-with-nvm/.bash_profile

@@ -0,0 +1,7 @@
+export NVM_DIR="$HOME/.nvm"
+[ -s "$NVM_DIR/nvm.sh" ] && \. "$NVM_DIR/nvm.sh" # This loads nvm into the shell
+
+# disable global fnm if installed
+fnm() {
+    exit 1;
+}

frontend-maven-plugin/src/it/node-version-manager-install-with-nvm/.gitignore

@@ -0,0 +1 @@
+node_modules

frontend-maven-plugin/src/it/node-version-manager-install-with-nvm/.nvmrc

@@ -0,0 +1 @@
+v20.15.1

frontend-maven-plugin/src/it/node-version-manager-install-with-nvm/install-nvm.sh

@@ -0,0 +1,17 @@
+#!/bin/bash
+
+# invoker env variables are not loaded yet
+export HOME="$(dirname "$0")"
+
+export NVM_DIR="$HOME/.nvm";
+mkdir "$NVM_DIR"
+echo "NVM_DIR set";
+
+(
+  git clone https://github.com/nvm-sh/nvm.git "$NVM_DIR" &&
+  cd "$NVM_DIR" &&
+  git checkout `git describe --abbrev=0 --tags --match "v[0-9]*" $(git rev-list --tags --max-count=1)`
+);
+echo "NVM checked out";
+
+

frontend-maven-plugin/src/it/node-version-manager-install-with-nvm/invoker.properties

@@ -0,0 +1,3 @@
+invoker.environmentVariables.HOME=${basedir}/target/its/node-version-manager-install-with-nvm
+invoker.environmentVariables.NVM_DIR=${basedir}/target/its/node-version-manager-install-with-nvm/.nvm
+invoker.environmentVariables.SHELL=bash

frontend-maven-plugin/src/it/node-version-manager-install-with-nvm/package.json

@@ -0,0 +1,10 @@
+{
+  "name": "example",
+  "version": "0.0.1",
+  "dependencies": {
+    "classnames": "^2.3.2"
+  },
+  "scripts": {
+    "prebuild": "npm install"
+  }
+}

frontend-maven-plugin/src/it/node-version-manager-install-with-nvm/pom.xml

@@ -0,0 +1,46 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<project xmlns="http://maven.apache.org/POM/4.0.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/xsd/maven-4.0.0.xsd">
+    <modelVersion>4.0.0</modelVersion>
+
+    <groupId>com.github.eirslett</groupId>
+    <artifactId>example</artifactId>
+    <version>0</version>
+    <packaging>pom</packaging>
+
+    <build>
+        <plugins>
+            <plugin>
+                <groupId>com.github.eirslett</groupId>
+                <artifactId>frontend-maven-plugin</artifactId>
+                <!-- NB! Set <version> to the latest released version of frontend-maven-plugin, like in README.md -->
+                <version>@project.version@</version>
+
+                <configuration>
+                    <nodeVersion>20.15.1</nodeVersion>
+                    <workingDirectory>${basedir}</workingDirectory>
+                    <useNodeVersionManager>true</useNodeVersionManager>
+                </configuration>
+
+                <executions>
+                    <execution>
+                        <id>install node</id>
+                        <goals>
+                            <goal>install-node-and-npm</goal>
+                        </goals>
+                    </execution>
+                    <execution>
+                        <id>npm ci</id>
+                        <goals>
+                            <goal>npm</goal>
+                        </goals>
+                        <!-- Optional configuration which provides for running any npm command -->
+                        <configuration>
+                            <arguments>ci</arguments>
+                        </configuration>
+                    </execution>
+
+                </executions>
+            </plugin>
+        </plugins>
+    </build>
+</project>

frontend-maven-plugin/src/it/node-version-manager-install-with-nvm/prebuild.groovy

@@ -0,0 +1,3 @@
+def p = "sh $basedir/install-nvm.sh".execute()
+p.waitFor()
+println p.text

frontend-maven-plugin/src/it/node-version-manager-install-with-nvm/verify.groovy

@@ -0,0 +1,8 @@
+import org.codehaus.plexus.util.FileUtils
+
+// assert
+assert !new File(basedir, 'node').exists() : "Node was installed in the custom install directory"
+assert new File(basedir, 'node_modules').exists() : "Node modules were not installed in the base directory"
+
+String buildLog = FileUtils.fileRead(new File(basedir, 'build.log'))
+assert buildLog.contains('BUILD SUCCESS') : 'build was not successful'

frontend-maven-plugin/src/main/java/com/github/eirslett/maven/plugins/frontend/mojo/AbstractFrontendMojo.java

@@ -59,6 +59,9 @@ public abstract class AbstractFrontendMojo extends AbstractMojo {
     @Parameter(defaultValue = "${repositorySystemSession}", readonly = true)
     private RepositorySystemSession repositorySystemSession;
 
+    @Parameter(property = "useNodeVersionManager", readonly = true, defaultValue = "false")
+    private boolean useNodeVersionManager;
+
     /**
      * Determines if this execution should be skipped.
      */
@@ -92,7 +95,7 @@ public void execute() throws MojoFailureException {
             }
             try {
                 execute(new FrontendPluginFactory(workingDirectory, installDirectory,
-                        new RepositoryCacheResolver(repositorySystemSession)));
+                        new RepositoryCacheResolver(repositorySystemSession), useNodeVersionManager));
             } catch (TaskRunnerException e) {
                 if (testFailureIgnore && isTestingPhase()) {
                     getLog().error("There are test failures.\nFailed to run task: " + e.getMessage(), e);

frontend-maven-plugin/src/main/java/com/github/eirslett/maven/plugins/frontend/mojo/InstallNodeAndNpmMojo.java

@@ -38,8 +38,9 @@ public final class InstallNodeAndNpmMojo extends AbstractFrontendMojo {
 
     /**
      * The version of Node.js to install. IMPORTANT! Most Node.js version names start with 'v', for example 'v0.10.18'
+     * If set to `version_manager`, node version manager will be used to run installation commands
      */
-    @Parameter(property="nodeVersion", required = true)
+    @Parameter(property="nodeVersion", required = false)
     private String nodeVersion;
 
     /**

frontend-maven-plugin/src/main/java/com/github/eirslett/maven/plugins/frontend/mojo/NpmMojo.java

@@ -59,6 +59,7 @@ public synchronized void execute(FrontendPluginFactory factory) throws TaskRunne
         File packageJson = new File(workingDirectory, "package.json");
         if (buildContext == null || buildContext.hasDelta(packageJson) || !buildContext.isIncremental()) {
             ProxyConfig proxyConfig = getProxyConfig();
+            factory.loadVersionManager();
             factory.getNpmRunner(proxyConfig, getRegistryUrl()).execute(arguments, environmentVariables);
         } else {
             getLog().info("Skipping npm install as package.json unchanged");

frontend-plugin-core/src/main/java/com/github/eirslett/maven/plugins/frontend/lib/FrontendPluginFactory.java

@@ -1,5 +1,10 @@
 package com.github.eirslett.maven.plugins.frontend.lib;
 
+import com.github.eirslett.maven.plugins.frontend.lib.version.manager.VersionManagerCache;
+import com.github.eirslett.maven.plugins.frontend.lib.version.manager.VersionManagerRunner;
+import com.github.eirslett.maven.plugins.frontend.lib.version.manager.VersionManagerType;
+import com.github.eirslett.maven.plugins.frontend.lib.version.manager.VersionManagerLocator;
+
 import java.io.File;
 
 public final class FrontendPluginFactory {
@@ -10,26 +15,49 @@ public final class FrontendPluginFactory {
     private final File workingDirectory;
     private final File installDirectory;
     private final CacheResolver cacheResolver;
+    private final boolean useNodeVersionManager;
 
     public FrontendPluginFactory(File workingDirectory, File installDirectory){
         this(workingDirectory, installDirectory, getDefaultCacheResolver(installDirectory));
     }
 
     public FrontendPluginFactory(File workingDirectory, File installDirectory, CacheResolver cacheResolver){
+        this(workingDirectory, installDirectory, cacheResolver, false);
+    }
+
+    public FrontendPluginFactory(File workingDirectory, File installDirectory, CacheResolver cacheResolver, boolean useNodeVersionManager){
         this.workingDirectory = workingDirectory;
         this.installDirectory = installDirectory;
         this.cacheResolver = cacheResolver;
+        this.useNodeVersionManager = useNodeVersionManager;
+
+        initializeGlobalCache();
+    }
+
+    private void initializeGlobalCache() {
+        InstallConfig installConfig = new DefaultInstallConfig(installDirectory, workingDirectory, cacheResolver, defaultPlatform, useNodeVersionManager);
+        GlobalCache.setInstallConfig(installConfig);
+
+        if (installConfig.isUseNodeVersionManager()) {
+            VersionManagerLocator versionManagerLocator = new VersionManagerLocator(installConfig);
+            VersionManagerType versionManagerType = versionManagerLocator.findAvailable();
+            GlobalCache.setVersionManagerCache(
+                new VersionManagerCache(versionManagerType)
+            );
+        } else {
+            GlobalCache.setVersionManagerCache(new VersionManagerCache());
+        }
     }
 
     public BunInstaller getBunInstaller(ProxyConfig proxy) {
         return new BunInstaller(getInstallConfig(), new DefaultArchiveExtractor(), new DefaultFileDownloader(proxy));
     }
     public NodeInstaller getNodeInstaller(ProxyConfig proxy) {
-        return new NodeInstaller(getInstallConfig(), new DefaultArchiveExtractor(), new DefaultFileDownloader(proxy));
+        return new NodeInstaller(getInstallConfig(), getVersionManagerCache(), new DefaultArchiveExtractor(), new DefaultFileDownloader(proxy));
     }
 
     public NPMInstaller getNPMInstaller(ProxyConfig proxy) {
-        return new NPMInstaller(getInstallConfig(), new DefaultArchiveExtractor(), new DefaultFileDownloader(proxy));
+        return new NPMInstaller(getInstallConfig(), getVersionManagerCache(), new DefaultArchiveExtractor(), new DefaultFileDownloader(proxy));
     }
 
     public PnpmInstaller getPnpmInstaller(ProxyConfig proxy) {
@@ -88,15 +116,29 @@ public WebpackRunner getWebpackRunner(){
         return new DefaultWebpackRunner(getExecutorConfig());
     }
 
+    public VersionManagerRunner getVersionManagerRunner() {
+        return new VersionManagerRunner(getInstallConfig(), getVersionManagerCache());
+    }
+
     private NodeExecutorConfig getExecutorConfig() {
-        return new InstallNodeExecutorConfig(getInstallConfig());
+        return new InstallNodeExecutorConfig(getInstallConfig(), getVersionManagerCache());
     }
 
     private InstallConfig getInstallConfig() {
-        return new DefaultInstallConfig(installDirectory, workingDirectory, cacheResolver, defaultPlatform);
+        return GlobalCache.getInstallConfig();
+    }
+
+    private VersionManagerCache getVersionManagerCache() {
+        return GlobalCache.getVersionManagerCache();
     }
 
     private static final CacheResolver getDefaultCacheResolver(File root) {
         return new DirectoryCacheResolver(new File(root, DEFAULT_CACHE_PATH));
     }
+
+    public void loadVersionManager() {
+        if (getInstallConfig().isUseNodeVersionManager()) {
+            getVersionManagerRunner().populateCache();
+        }
+    }
 }