Spaces:
Runtime error
Runtime error
| # ============================================================================ | |
| # scripts/lib/node-bootstrap.sh | |
| # ---------------------------------------------------------------------------- | |
| # Sourceable helper: ensure Node.js >= MIN_VERSION is available for the TUI | |
| # (React + Ink), browser tools, and the WhatsApp bridge. | |
| # | |
| # Strategy (first hit wins — respects the user's existing tooling): | |
| # 1. modern `node` already on PATH | |
| # 2. ~/.hermes/node/ from a prior Hermes-managed install | |
| # 3. fnm, proto, nvm (in that order) if the user already uses a version manager | |
| # 4. Termux `pkg`, macOS Homebrew | |
| # 5. pinned nodejs.org tarball into ~/.hermes/node/ (always works, zero shell rc edits) | |
| # | |
| # Usage: | |
| # source scripts/lib/node-bootstrap.sh | |
| # ensure_node # returns 0 on success, non-zero on failure | |
| # if [ "$HERMES_NODE_AVAILABLE" = true ]; then ...; fi | |
| # | |
| # Env inputs (set before sourcing to override defaults): | |
| # HERMES_NODE_MIN_VERSION (default: 20) — accepted on PATH | |
| # HERMES_NODE_TARGET_MAJOR (default: 22) — installed when we install | |
| # HERMES_HOME (default: $HOME/.hermes) | |
| # ============================================================================ | |
| HERMES_NODE_MIN_VERSION="${HERMES_NODE_MIN_VERSION:-20}" | |
| HERMES_NODE_TARGET_MAJOR="${HERMES_NODE_TARGET_MAJOR:-22}" | |
| HERMES_HOME="${HERMES_HOME:-$HOME/.hermes}" | |
| HERMES_NODE_AVAILABLE=false | |
| # --------------------------------------------------------------------------- | |
| # Logging — prefer the host script's log_* helpers when present | |
| # --------------------------------------------------------------------------- | |
| _nb_log() { declare -F log_info >/dev/null 2>&1 && log_info "$*" || printf '→ %s\n' "$*" >&2; } | |
| _nb_ok() { declare -F log_success >/dev/null 2>&1 && log_success "$*" || printf '✓ %s\n' "$*" >&2; } | |
| _nb_warn() { declare -F log_warn >/dev/null 2>&1 && log_warn "$*" || printf '⚠ %s\n' "$*" >&2; } | |
| # --------------------------------------------------------------------------- | |
| # Platform + version helpers | |
| # --------------------------------------------------------------------------- | |
| _nb_is_termux() { | |
| [ -n "${TERMUX_VERSION:-}" ] || [[ "${PREFIX:-}" == *"com.termux/files/usr"* ]] | |
| } | |
| _nb_node_major() { | |
| local v | |
| v=$(node --version 2>/dev/null | sed 's/^v//' | cut -d. -f1) | |
| [[ "$v" =~ ^[0-9]+$ ]] && echo "$v" || echo 0 | |
| } | |
| _nb_have_modern_node() { | |
| command -v node >/dev/null 2>&1 || return 1 | |
| [ "$(_nb_node_major)" -ge "$HERMES_NODE_MIN_VERSION" ] | |
| } | |
| # --------------------------------------------------------------------------- | |
| # Version-manager paths — respect what the user already uses | |
| # --------------------------------------------------------------------------- | |
| _nb_try_fnm() { | |
| command -v fnm >/dev/null 2>&1 || return 1 | |
| _nb_log "fnm detected — installing Node $HERMES_NODE_TARGET_MAJOR..." | |
| eval "$(fnm env 2>/dev/null)" || true | |
| fnm install "$HERMES_NODE_TARGET_MAJOR" >/dev/null 2>&1 || return 1 | |
| fnm use "$HERMES_NODE_TARGET_MAJOR" >/dev/null 2>&1 || return 1 | |
| _nb_have_modern_node || return 1 | |
| _nb_ok "Node $(node --version) activated via fnm" | |
| return 0 | |
| } | |
| _nb_try_proto() { | |
| command -v proto >/dev/null 2>&1 || return 1 | |
| _nb_log "proto detected — installing Node $HERMES_NODE_TARGET_MAJOR..." | |
| proto install node "$HERMES_NODE_TARGET_MAJOR" >/dev/null 2>&1 || return 1 | |
| _nb_have_modern_node || return 1 | |
| _nb_ok "Node $(node --version) activated via proto" | |
| return 0 | |
| } | |
| _nb_try_nvm() { | |
| local nvm_sh="${NVM_DIR:-$HOME/.nvm}/nvm.sh" | |
| [ -s "$nvm_sh" ] || return 1 | |
| # shellcheck source=/dev/null | |
| \. "$nvm_sh" >/dev/null 2>&1 || return 1 | |
| _nb_log "nvm detected — installing Node $HERMES_NODE_TARGET_MAJOR..." | |
| nvm install "$HERMES_NODE_TARGET_MAJOR" >/dev/null 2>&1 || return 1 | |
| nvm use "$HERMES_NODE_TARGET_MAJOR" >/dev/null 2>&1 || return 1 | |
| _nb_have_modern_node || return 1 | |
| _nb_ok "Node $(node --version) activated via nvm" | |
| return 0 | |
| } | |
| # --------------------------------------------------------------------------- | |
| # Platform package managers | |
| # --------------------------------------------------------------------------- | |
| _nb_try_termux_pkg() { | |
| _nb_is_termux || return 1 | |
| _nb_log "Installing Node.js via pkg..." | |
| pkg install -y nodejs >/dev/null 2>&1 || return 1 | |
| _nb_have_modern_node || return 1 | |
| _nb_ok "Node $(node --version) installed via pkg" | |
| return 0 | |
| } | |
| _nb_try_brew() { | |
| [ "$(uname -s)" = "Darwin" ] || return 1 | |
| command -v brew >/dev/null 2>&1 || return 1 | |
| _nb_log "Installing Node via Homebrew..." | |
| brew install "node@${HERMES_NODE_TARGET_MAJOR}" >/dev/null 2>&1 \ | |
| || brew install node >/dev/null 2>&1 \ | |
| || return 1 | |
| brew link --overwrite --force "node@${HERMES_NODE_TARGET_MAJOR}" >/dev/null 2>&1 || true | |
| _nb_have_modern_node || return 1 | |
| _nb_ok "Node $(node --version) installed via Homebrew" | |
| return 0 | |
| } | |
| # --------------------------------------------------------------------------- | |
| # Bundled binary fallback — always works, no shell rc edits | |
| # --------------------------------------------------------------------------- | |
| _nb_install_bundled_node() { | |
| local arch node_arch os_name node_os | |
| arch=$(uname -m) | |
| case "$arch" in | |
| x86_64) node_arch="x64" ;; | |
| aarch64|arm64) node_arch="arm64" ;; | |
| armv7l) node_arch="armv7l" ;; | |
| *) | |
| _nb_warn "Unsupported arch ($arch) — install Node.js manually: https://nodejs.org/" | |
| return 1 | |
| ;; | |
| esac | |
| os_name=$(uname -s) | |
| case "$os_name" in | |
| Linux*) node_os="linux" ;; | |
| Darwin*) node_os="darwin" ;; | |
| *) | |
| _nb_warn "Unsupported OS ($os_name) — install Node.js manually: https://nodejs.org/" | |
| return 1 | |
| ;; | |
| esac | |
| local index_url="https://nodejs.org/dist/latest-v${HERMES_NODE_TARGET_MAJOR}.x/" | |
| local tarball | |
| tarball=$(curl -fsSL "$index_url" \ | |
| | grep -oE "node-v${HERMES_NODE_TARGET_MAJOR}\.[0-9]+\.[0-9]+-${node_os}-${node_arch}\.tar\.xz" \ | |
| | head -1) | |
| if [ -z "$tarball" ]; then | |
| tarball=$(curl -fsSL "$index_url" \ | |
| | grep -oE "node-v${HERMES_NODE_TARGET_MAJOR}\.[0-9]+\.[0-9]+-${node_os}-${node_arch}\.tar\.gz" \ | |
| | head -1) | |
| fi | |
| if [ -z "$tarball" ]; then | |
| _nb_warn "Could not resolve Node $HERMES_NODE_TARGET_MAJOR binary for $node_os-$node_arch" | |
| return 1 | |
| fi | |
| local tmp | |
| tmp=$(mktemp -d) | |
| _nb_log "Downloading $tarball..." | |
| curl -fsSL "${index_url}${tarball}" -o "$tmp/$tarball" || { | |
| _nb_warn "Download failed"; rm -rf "$tmp"; return 1 | |
| } | |
| _nb_log "Extracting to $HERMES_HOME/node/..." | |
| if [[ "$tarball" == *.tar.xz ]]; then | |
| tar xf "$tmp/$tarball" -C "$tmp" || { rm -rf "$tmp"; return 1; } | |
| else | |
| tar xzf "$tmp/$tarball" -C "$tmp" || { rm -rf "$tmp"; return 1; } | |
| fi | |
| local extracted | |
| extracted=$(find "$tmp" -maxdepth 1 -type d -name 'node-v*' 2>/dev/null | head -1) | |
| if [ ! -d "$extracted" ]; then | |
| _nb_warn "Extraction produced no node-v* directory" | |
| rm -rf "$tmp" | |
| return 1 | |
| fi | |
| mkdir -p "$HERMES_HOME" | |
| rm -rf "$HERMES_HOME/node" | |
| mv "$extracted" "$HERMES_HOME/node" | |
| rm -rf "$tmp" | |
| mkdir -p "$HOME/.local/bin" | |
| ln -sf "$HERMES_HOME/node/bin/node" "$HOME/.local/bin/node" | |
| ln -sf "$HERMES_HOME/node/bin/npm" "$HOME/.local/bin/npm" | |
| ln -sf "$HERMES_HOME/node/bin/npx" "$HOME/.local/bin/npx" | |
| export PATH="$HERMES_HOME/node/bin:$PATH" | |
| _nb_have_modern_node || return 1 | |
| _nb_ok "Node $(node --version) installed to $HERMES_HOME/node/" | |
| return 0 | |
| } | |
| # --------------------------------------------------------------------------- | |
| # Public entry point | |
| # --------------------------------------------------------------------------- | |
| ensure_node() { | |
| HERMES_NODE_AVAILABLE=false | |
| if _nb_have_modern_node; then | |
| _nb_ok "Node $(node --version) found" | |
| HERMES_NODE_AVAILABLE=true | |
| return 0 | |
| fi | |
| if [ -x "$HERMES_HOME/node/bin/node" ]; then | |
| export PATH="$HERMES_HOME/node/bin:$PATH" | |
| if _nb_have_modern_node; then | |
| _nb_ok "Node $(node --version) found (Hermes-managed)" | |
| HERMES_NODE_AVAILABLE=true | |
| return 0 | |
| fi | |
| fi | |
| # Version managers first — respect the user's existing setup. | |
| _nb_try_fnm && { HERMES_NODE_AVAILABLE=true; return 0; } | |
| _nb_try_proto && { HERMES_NODE_AVAILABLE=true; return 0; } | |
| _nb_try_nvm && { HERMES_NODE_AVAILABLE=true; return 0; } | |
| # Platform package managers. | |
| _nb_try_termux_pkg && { HERMES_NODE_AVAILABLE=true; return 0; } | |
| _nb_try_brew && { HERMES_NODE_AVAILABLE=true; return 0; } | |
| # Last resort: pinned nodejs.org tarball. | |
| _nb_install_bundled_node && { HERMES_NODE_AVAILABLE=true; return 0; } | |
| _nb_warn "Node.js install failed — TUI and browser tools will be unavailable." | |
| _nb_warn "Install manually: https://nodejs.org/en/download/ (or: \`brew install node\`, \`fnm install $HERMES_NODE_TARGET_MAJOR\`, etc.)" | |
| return 1 | |
| } | |