omnish 2.1.8 → 2.1.9

package/CHANGELOG.md

@@ -7,6 +7,17 @@ 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
@@ -101,6 +112,7 @@ 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

package/README.md

@@ -109,7 +109,13 @@ Names are alphanumeric plus `_`/`-`, max 32 characters; several names are reserv
 
 ## Install from npm
 
-**Requires Node.js 22.13+** (`node -v`).
+**Recommended — one command (works on old Node, VPS, macOS, Linux):**
+
+```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+
 
@@ -120,15 +126,7 @@ omnish allow +YOUR_E164
 omnish run
 ```
 
-### Old Node (VPS with apt Node 12, etc.)
-
-`npm install -g omnish` will fail on Node below 22.13 — that is expected. **Run the bootstrap installer instead** (upgrades Node, installs build tools on Debian/Ubuntu, then `npm install -g omnish`):
-
-```bash
-curl -fsSL https://unpkg.com/omnish/contrib/install-omnish.sh | bash
-```
-
-The script is published in the npm package (no GitHub clone required). If `npm install -g omnish` failed, the error message prints the same one-liner with your package version.
+`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).
 

package/contrib/install-omnish.sh

@@ -1,12 +1,28 @@
 #!/usr/bin/env bash
-# Bootstrap omnish install: ensure Node 22.13+, then npm install -g omnish.
-# Served from npm (unpkg) — see scripts/node-version.cjs readBootstrapInstallScriptUrl().
+# 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
@@ -36,22 +52,33 @@ current_node() {
 
 install_omnish() {
   need npm
-  echo ""
-  echo "Installing ${OMNISH_NPM_SPEC} with Node $(node -v) …"
+  step "Installing omnish CLI (npm install -g ${OMNISH_NPM_SPEC}) …"
   npm install -g "${OMNISH_NPM_SPEC}"
   echo ""
-  echo "Done. Next steps:"
-  echo "  omnish --version"
-  echo "  omnish link          # WhatsApp QR or --tg for Telegram"
-  echo "  omnish allow +E164   # your phone number"
-  echo "  omnish start"
+  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
-  echo "Installing build tools for native modules (better-sqlite3, node-pty) …"
+  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
@@ -68,7 +95,7 @@ load_nvm() {
 
 try_nvm() {
   if load_nvm; then
-    echo "Using nvm to install Node ${NODE_MAJOR} and set default …"
+    step "Upgrading Node via nvm (${NODE_MAJOR}, set as default) …"
     nvm install "${NODE_MAJOR}"
     nvm alias default "${NODE_MAJOR}"
     nvm use default
@@ -79,7 +106,7 @@ try_nvm() {
 
 try_fnm() {
   if command -v fnm >/dev/null 2>&1; then
-    echo "Using fnm to install Node ${NODE_MAJOR} and set default …"
+    step "Upgrading Node via fnm (${NODE_MAJOR}) …"
     fnm install "${NODE_MAJOR}"
     fnm default "${NODE_MAJOR}"
     eval "$(fnm env)"
@@ -93,7 +120,7 @@ try_nodesource() {
     return 1
   fi
   need curl
-  echo "Using NodeSource to install Node ${NODE_MAJOR}.x (replaces old apt node) …"
+  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
@@ -102,10 +129,11 @@ try_nodesource() {
 
 install_nvm() {
   need curl
-  echo "nvm not found — installing nvm …"
+  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 this script." >&2
+    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}"
@@ -137,11 +165,22 @@ Automatic upgrade failed. Pick one path:
   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() {
-  echo "omnish installer — Node $(current_node) (need 22.13+)"
+  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