NODE_MANAGER=volta|nvm

Author: back-2-95

make/javascript.mk

@@ -5,11 +5,21 @@ JS_PACKAGE_MANAGER_CWD_FLAG_YARN ?= --cwd
 INSTALLED_NODE_VERSION := $(shell command -v node > /dev/null && node --version | cut -c2-3 || echo no)
 NVM_SH := $(HOME)/.nvm/nvm.sh
 NVM := $(shell test -f "$(NVM_SH)" && echo yes || echo no)
+VOLTA_BIN := $(shell command -v volta || echo no)
 NODE_BIN := $(shell command -v node || echo no)
 NPM_BIN := $(shell command -v npm || echo no)
 YARN_BIN := $(shell command -v yarn || echo no)
 NODE_VERSION ?= 16
 
+# Auto-detect node manager: prefer Volta over NVM. Override with NODE_MANAGER=volta|nvm
+ifneq ($(VOLTA_BIN),no)
+  NODE_MANAGER ?= volta
+else ifeq ($(NVM),yes)
+  NODE_MANAGER ?= nvm
+else
+  NODE_MANAGER ?= none
+endif
+
 PHONY += js-install
 js-install: ## Install JS packages
 ifeq ($(JS_PACKAGE_MANAGER),yarn)
@@ -23,22 +33,30 @@ js-outdated: ## Show outdated JS packages
 	$(call step,Show outdated JS packages with $(JS_PACKAGE_MANAGER)...)
 	$(call node_run,outdated)
 
-ifeq ($(NVM),no)
+ifeq ($(NODE_MANAGER),volta)
 define node_run
-	$(call error,$(NVM_REQUIRED))
+	$(call step,Run '$(JS_PACKAGE_MANAGER) $(1)' with Node $(NODE_VERSION)...\n)
+	@volta run --node $(NODE_VERSION) $(JS_PACKAGE_MANAGER) $(if $(filter $(JS_PACKAGE_MANAGER),yarn),$(JS_PACKAGE_MANAGER_CWD_FLAG_YARN),$(JS_PACKAGE_MANAGER_CWD_FLAG_NPM)) $(PACKAGE_JSON_PATH) $(1)
 endef
-else
+else ifeq ($(NODE_MANAGER),nvm)
 define node_run
 	$(call step,Run '$(JS_PACKAGE_MANAGER) $(1)' with Node $(NODE_VERSION)...\n)
 	@. $(NVM_SH) && (nvm which $(NODE_VERSION) > /dev/null 2>&1 || nvm install $(NODE_VERSION)) && \
 		nvm exec $(NODE_VERSION) $(JS_PACKAGE_MANAGER) $(if $(filter $(JS_PACKAGE_MANAGER),yarn),$(JS_PACKAGE_MANAGER_CWD_FLAG_YARN),$(JS_PACKAGE_MANAGER_CWD_FLAG_NPM)) $(PACKAGE_JSON_PATH) $(1)
 endef
+else
+define node_run
+	$(call error,$(NODE_MANAGER_REQUIRED))
+endef
 endif
 
-define NVM_REQUIRED
+define NODE_MANAGER_REQUIRED
+
 
+🚫 A node manager is required to run $(JS_PACKAGE_MANAGER) commands and control Node versions!
 
-🚫 NVM is required to run $(JS_PACKAGE_MANAGER) commands and control Node versions!
+   Install Volta (recommended): https://volta.sh
+   Install NVM:                 https://github.com/nvm-sh/nvm
 
 
 endef

tests/outputs/js-install-npm-volta.txt

@@ -0,0 +1,4 @@
+js-install JS_PACKAGE_MANAGER=npm PACKAGE_JSON_PATH=custom PACKAGE_JSON_EXISTS=yes NODE_VERSION=20 NODE_MANAGER=volta
+---
+printf "\n⭐ \033[0;33mRun 'npm install --no-audit --no-fund --engine-strict true' with Node 20...\n\033[0m\n"
+volta run --node 20 npm --prefix custom install --no-audit --no-fund --engine-strict true

tests/outputs/js-install-npm.txt

@@ -1,4 +1,4 @@
-js-install JS_PACKAGE_MANAGER=npm PACKAGE_JSON_PATH=custom PACKAGE_JSON_EXISTS=yes NODE_VERSION=20 NVM=yes
+js-install JS_PACKAGE_MANAGER=npm PACKAGE_JSON_PATH=custom PACKAGE_JSON_EXISTS=yes NODE_VERSION=20 NODE_MANAGER=nvm
 ---
 printf "\n⭐ \033[0;33mRun 'npm install --no-audit --no-fund --engine-strict true' with Node 20...\n\033[0m\n"
 . __HOME__/.nvm/nvm.sh && (nvm which 20 > /dev/null 2>&1 || nvm install 20) && nvm exec 20 npm --prefix custom install --no-audit --no-fund --engine-strict true

tests/outputs/js-install-yarn-volta.txt

@@ -0,0 +1,4 @@
+js-install PACKAGE_JSON_PATH=custom PACKAGE_JSON_EXISTS=yes NODE_VERSION=20 NODE_MANAGER=volta
+---
+printf "\n⭐ \033[0;33mRun 'yarn install --frozen-lockfile' with Node 20...\n\033[0m\n"
+volta run --node 20 yarn --cwd custom install --frozen-lockfile

tests/outputs/js-install-yarn.txt

@@ -1,4 +1,4 @@
-js-install PACKAGE_JSON_PATH=custom PACKAGE_JSON_EXISTS=yes NODE_VERSION=20 NVM=yes
+js-install PACKAGE_JSON_PATH=custom PACKAGE_JSON_EXISTS=yes NODE_VERSION=20 NODE_MANAGER=nvm
 ---
 printf "\n⭐ \033[0;33mRun 'yarn install --frozen-lockfile' with Node 20...\n\033[0m\n"
 . __HOME__/.nvm/nvm.sh && (nvm which 20 > /dev/null 2>&1 || nvm install 20) && nvm exec 20 yarn --cwd custom install --frozen-lockfile

tests/outputs/js-node-version-same.txt

@@ -1,4 +1,4 @@
-js-install INSTALLED_NODE_VERSION=18 NODE_VERSION=18 PACKAGE_JSON_EXISTS=yes NVM=yes
+js-install INSTALLED_NODE_VERSION=18 NODE_VERSION=18 PACKAGE_JSON_EXISTS=yes NODE_MANAGER=nvm
 ---
 printf "\n⭐ \033[0;33mRun 'yarn install --frozen-lockfile' with Node 18...\n\033[0m\n"
 . __HOME__/.nvm/nvm.sh && (nvm which 18 > /dev/null 2>&1 || nvm install 18) && nvm exec 18 yarn --cwd . install --frozen-lockfile