omnish 2.1.7 → 2.1.9

package/CHANGELOG.md

@@ -7,6 +7,25 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ## [Unreleased]
 
+## [2.1.9] - 2026-07-11
+
+### Added
+
+- **Platform install script:** `https://platform.omnish.dev/action/install-omnish.sh` served from tunnel-relay; `platform.omnish.dev` in Caddy site block with `tunnel.omnish.dev`.
+
+### Changed
+
+- **Install UX:** README, preinstall, and docs lead with platform installer one-liner; unpkg fallback retained. Installer shows banner, steps, and quick-start path to first `!` command.
+- **`scripts/install-script-url.cjs`:** canonical public installer URL.
+
+## [2.1.8] - 2026-07-11
+
+### Changed
+
+- **Self-service install on old Node:** bootstrap script ships in the npm tarball; preinstall errors lead with `curl -fsSL https://unpkg.com/omnish@<version>/contrib/install-omnish.sh | bash` (no private GitHub raw URL). EBADENGINE flood is called out as ignorable noise.
+- **`contrib/install-omnish.sh`:** Debian/Ubuntu VPS uses NodeSource first (replaces apt Node 12), installs `build-essential` for native modules, prints next steps after install.
+- **Docs/README:** install section split into “already on Node 22” vs “old Node — run bootstrap”.
+
 ## [2.1.7] - 2026-07-11
 
 ### Added
@@ -93,6 +112,8 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 - Documentation and formatting updates across chat components and feature docs.
 
+[2.1.9]: https://github.com/labKnowledge/omnish/compare/v2.1.8...v2.1.9
+[2.1.8]: https://github.com/labKnowledge/omnish/compare/v2.1.7...v2.1.8
 [2.1.7]: https://github.com/labKnowledge/omnish/compare/v2.1.6...v2.1.7
 [2.1.6]: https://github.com/labKnowledge/omnish/compare/v2.1.5...v2.1.6
 [2.1.5]: https://github.com/labKnowledge/omnish/compare/v2.1.4...v2.1.5

package/README.md

@@ -109,12 +109,16 @@ Names are alphanumeric plus `_`/`-`, max 32 characters; several names are reserv
 
 ## Install from npm
 
-**Requires Node.js 22.13+** (`node -v`). If install fails on version, see [Quick start — Installation](docs/guides/quick-start.md#installation) or run:
+**Recommended — one command (works on old Node, VPS, macOS, Linux):**
 
 ```bash
-curl -fsSL https://raw.githubusercontent.com/labKnowledge/omnish/main/contrib/install-omnish.sh | bash
+curl -fsSL https://platform.omnish.dev/action/install-omnish.sh | bash
 ```
 
+The installer upgrades Node when needed, installs build tools on Debian/Ubuntu, runs `npm install -g omnish`, and prints your next steps (`link` → `allow` → `start` → first `!` command).
+
+### Already on Node 22.13+
+
 ```bash
 npm install -g omnish
 omnish link
@@ -122,6 +126,8 @@ omnish allow +YOUR_E164
 omnish run
 ```
 
+`npm install -g omnish` on Node below 22.13 will fail by design — use the installer above instead (do not fight `EBADENGINE` warnings on distro Node 12).
+
 **Single phone:** omnish runs on a PC or server; you link it like WhatsApp Web (one QR scan on your phone). See [Quick start — One phone with WhatsApp](docs/guides/quick-start.md#one-phone-with-whatsapp).
 
 **npm 11+ install warnings:** You may see advisory `allow-scripts` notices for native dependencies (`node-pty`, `better-sqlite3`, etc.). Install still succeeds; omnish pre-declares these in `allowScripts`. The `prebuild-install` deprecation warning comes from upstream native modules and is harmless.

package/contrib/install-omnish.sh

@@ -0,0 +1,224 @@
+#!/usr/bin/env bash
+# omnish bootstrap installer — upgrades Node 22.13+ when needed, then npm install -g omnish.
+# Canonical URL: https://platform.omnish.dev/action/install-omnish.sh
+set -euo pipefail
+
+OMNISH_NPM_SPEC="${OMNISH_NPM_SPEC:-omnish}"
+NODE_MAJOR="${OMNISH_NODE_MAJOR:-22}"
+NVM_INSTALL_URL="${NVM_INSTALL_URL:-https://raw.githubusercontent.com/nvm-sh/nvm/v0.40.3/install.sh}"
+
+banner() {
+  cat <<'EOF'
+
+  omnish — allowlisted inbox → your real shell
+  ────────────────────────────────────────────
+  WhatsApp / Telegram / 20+ channels. No AI layer.
+  Commands run on YOUR machine. You control the allowlist.
+
+EOF
+}
+
+step() {
+  echo ""
+  echo "▸ $1"
+}
+
+need() {
+  command -v "$1" >/dev/null 2>&1 || {
+    echo "error: required command not found: $1" >&2
+    exit 1
+  }
+}
+
+is_debian_ubuntu() {
+  [[ -f /etc/debian_version ]] && command -v apt-get >/dev/null 2>&1
+}
+
+node_version_ok() {
+  node -e "
+const [maj, min] = process.versions.node.split('.').map(Number);
+const ok = maj > 22 || (maj === 22 && min >= 13);
+process.exit(ok ? 0 : 1);
+" 2>/dev/null
+}
+
+current_node() {
+  if command -v node >/dev/null 2>&1; then
+    node -v
+  else
+    echo "(not installed)"
+  fi
+}
+
+install_omnish() {
+  need npm
+  step "Installing omnish CLI (npm install -g ${OMNISH_NPM_SPEC}) …"
+  npm install -g "${OMNISH_NPM_SPEC}"
+  echo ""
+  if command -v omnish >/dev/null 2>&1; then
+    echo "✓ omnish $(omnish --version 2>/dev/null || echo 'installed')"
+  else
+    echo "✓ omnish installed (reopen shell if omnish not found)"
+  fi
+  echo ""
+  cat <<'EOF'
+  You're ready. Run these next (≈2 minutes to first command):
+
+    omnish link            Link WhatsApp (QR) or Telegram (--tg <token>)
+    omnish allow +E164     Allow your phone number (shell access = password)
+    omnish start           Run the gateway in the background
+
+  Then message yourself:  !pwd   or   !ls
+
+  Docs: https://omnish.dev · Help: omnish --help
+EOF
+}
+
+ensure_build_deps() {
+  if ! is_debian_ubuntu; then
+    return 0
+  fi
+  step "Installing build tools (better-sqlite3, node-pty native modules) …"
+  export DEBIAN_FRONTEND=noninteractive
+  apt-get update -qq
+  apt-get install -y build-essential python3 curl ca-certificates
+}
+
+load_nvm() {
+  if [[ -s "${NVM_DIR:-$HOME/.nvm}/nvm.sh" ]]; then
+    # shellcheck source=/dev/null
+    . "${NVM_DIR:-$HOME/.nvm}/nvm.sh"
+    return 0
+  fi
+  return 1
+}
+
+try_nvm() {
+  if load_nvm; then
+    step "Upgrading Node via nvm (${NODE_MAJOR}, set as default) …"
+    nvm install "${NODE_MAJOR}"
+    nvm alias default "${NODE_MAJOR}"
+    nvm use default
+    return 0
+  fi
+  return 1
+}
+
+try_fnm() {
+  if command -v fnm >/dev/null 2>&1; then
+    step "Upgrading Node via fnm (${NODE_MAJOR}) …"
+    fnm install "${NODE_MAJOR}"
+    fnm default "${NODE_MAJOR}"
+    eval "$(fnm env)"
+    return 0
+  fi
+  return 1
+}
+
+try_nodesource() {
+  if ! is_debian_ubuntu; then
+    return 1
+  fi
+  need curl
+  step "Upgrading Node via NodeSource ${NODE_MAJOR}.x (replaces old apt node) …"
+  curl -fsSL "https://deb.nodesource.com/setup_${NODE_MAJOR}.x" | bash -
+  apt-get install -y nodejs
+  hash -r 2>/dev/null || true
+  return 0
+}
+
+install_nvm() {
+  need curl
+  step "Installing nvm, then Node ${NODE_MAJOR} …"
+  curl -fsSL "${NVM_INSTALL_URL}" | bash
+  load_nvm || {
+    echo "error: nvm install finished but nvm.sh is missing. Open a new shell and re-run:" >&2
+    echo "  curl -fsSL https://platform.omnish.dev/action/install-omnish.sh | bash" >&2
+    exit 1
+  }
+  nvm install "${NODE_MAJOR}"
+  nvm alias default "${NODE_MAJOR}"
+  nvm use default
+}
+
+print_manual_help() {
+  cat <<EOF
+
+omnish needs Node.js 22.13 or newer.
+You have: $(current_node)
+
+Automatic upgrade failed. Pick one path:
+
+  Debian/Ubuntu VPS (replaces old apt node, e.g. v12):
+    curl -fsSL https://deb.nodesource.com/setup_${NODE_MAJOR}.x | bash -
+    apt-get install -y nodejs build-essential python3
+    node -v
+    npm install -g ${OMNISH_NPM_SPEC}
+
+  nvm:
+    curl -o- ${NVM_INSTALL_URL} | bash
+    # restart shell
+    nvm install ${NODE_MAJOR}
+    nvm alias default ${NODE_MAJOR}
+    npm install -g ${OMNISH_NPM_SPEC}
+
+  Official installers:
+    https://nodejs.org/en/download
+
+  Re-run the guided installer anytime:
+    curl -fsSL https://platform.omnish.dev/action/install-omnish.sh | bash
+
+EOF
+}
+
+main() {
+  banner
+  step "Checking Node.js (need 22.13+, you have $(current_node))"
+
+  if command -v omnish >/dev/null 2>&1 && command -v node >/dev/null 2>&1 && node_version_ok; then
+    echo "omnish is already installed."
+    omnish --version 2>/dev/null || true
+    echo "To upgrade: npm install -g omnish@latest"
+    exit 0
+  fi
+
+  if command -v node >/dev/null 2>&1 && node_version_ok; then
+    install_omnish
+    exit 0
+  fi
+
+  # Debian/Ubuntu VPS (common: distro Node 12 from apt) — NodeSource first.
+  if is_debian_ubuntu; then
+    ensure_build_deps
+    if try_nodesource && node_version_ok; then
+      install_omnish
+      exit 0
+    fi
+  fi
+
+  if try_nvm || try_fnm; then
+    if node_version_ok; then
+      install_omnish
+      exit 0
+    fi
+  fi
+
+  if try_nodesource && node_version_ok; then
+    install_omnish
+    exit 0
+  fi
+
+  if [[ "$(uname -s)" != "MINGW"* && "$(uname -s)" != "MSYS"* && "$(uname -s)" != "CYGWIN"* ]]; then
+    if install_nvm; then
+      if node_version_ok; then
+        install_omnish
+        exit 0
+      fi
+    fi
+  fi
+
+  print_manual_help
+  exit 1
+}
+
+main "$@"