omnish 2.1.3 → 2.1.5

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "omnish",
-  "version": "2.1.3",
+  "version": "2.1.5",
   "description": "omnish — allowlisted inbox → your real shell (WhatsApp, Telegram, Discord, Slack, and 20+ channels). No AI.",
   "license": "MIT",
   "type": "module",
@@ -26,6 +26,8 @@
   "files": [
     "dist",
     "scripts/check-native-modules.mjs",
+    "scripts/check-node-version.cjs",
+    "scripts/node-version.cjs",
     "scripts/fix-node-pty-perms.mjs",
     "README.md",
     "CHANGELOG.md",
@@ -78,6 +80,7 @@
   },
   "scripts": {
     "reinstall": "rm -rf node_modules && pnpm install",
+    "preinstall": "node scripts/check-node-version.cjs",
     "postinstall": "node scripts/check-native-modules.mjs && node scripts/fix-node-pty-perms.mjs",
     "build": "node scripts/build-bundle.mjs",
     "build:doc-index": "node scripts/build-doc-index.mjs",

package/scripts/check-native-modules.mjs

@@ -4,10 +4,12 @@
 import { createRequire } from "node:module";
 
 const require = createRequire(import.meta.url);
+const { formatNativeModuleNodeHint } = require("./node-version.cjs");
 
 const modules = ["better-sqlite3", "node-pty", "@parcel/watcher"];
 
 let failed = false;
+let printedNodeHint = false;
 for (const name of modules) {
   try {
     require(name);
@@ -17,9 +19,15 @@ for (const name of modules) {
       `omnish: native module "${name}" failed to load for Node ${process.version} (ABI ${process.versions.modules}).`,
     );
     console.error(`  ${err instanceof Error ? err.message : String(err)}`);
-    console.error(
-      "  Fix: use the Node version in .nvmrc (nvm use) and run: pnpm rebuild better-sqlite3 node-pty @parcel/watcher",
-    );
+    if (!printedNodeHint) {
+      printedNodeHint = true;
+      console.error(
+        "  Fix: use Node 22.13+ (see package.json engines), then reinstall or rebuild:",
+      );
+      console.error("    npm install -g omnish");
+      console.error("    npm rebuild -g omnish");
+      console.error(formatNativeModuleNodeHint());
+    }
   }
 }
 

package/scripts/check-node-version.cjs

@@ -0,0 +1,22 @@
+#!/usr/bin/env node
+/**
+ * preinstall guard — block unsupported Node with actionable upgrade steps.
+ * CommonJS so this runs on Node 10+ (including ancient distro Node 12).
+ * Skip with OMNISH_SKIP_NODE_CHECK=1 (not recommended).
+ */
+"use strict";
+
+var nodeVersion = require("./node-version.cjs");
+
+if (process.env.OMNISH_SKIP_NODE_CHECK === "1") {
+  console.warn("omnish: skipping Node version check (OMNISH_SKIP_NODE_CHECK=1)");
+  process.exit(0);
+}
+
+var result = nodeVersion.checkNodeVersion();
+if (result.ok) {
+  process.exit(0);
+}
+
+console.error(nodeVersion.formatNodeUpgradeHelp(result));
+process.exit(1);

package/scripts/node-version.cjs

@@ -0,0 +1,243 @@
+/**
+ * Node.js version policy for omnish installs (CommonJS, parseable on Node 10+).
+ * Used by preinstall on hosts that may still run distro Node 12/14/16/18.
+ */
+"use strict";
+
+var fs = require("fs");
+var os = require("os");
+var path = require("path");
+
+var DEFAULT_ENGINES_NODE = ">=22.13";
+var RECOMMENDED_NODE = "22";
+
+function readEnginesNode() {
+  try {
+    var pkg = JSON.parse(
+      fs.readFileSync(path.join(__dirname, "..", "package.json"), "utf8"),
+    );
+    if (pkg.engines && typeof pkg.engines.node === "string") {
+      return pkg.engines.node;
+    }
+    return DEFAULT_ENGINES_NODE;
+  } catch (err) {
+    return DEFAULT_ENGINES_NODE;
+  }
+}
+
+function parseSemver(version) {
+  var raw = String(version).trim().replace(/^v/, "");
+  var m = /^(\d+)\.(\d+)\.(\d+)/.exec(raw);
+  if (!m) {
+    return null;
+  }
+  return { major: Number(m[1]), minor: Number(m[2]), patch: Number(m[3]) };
+}
+
+function parseEnginesConstraint(constraint) {
+  var m = /^(>=|>|<=|<|=)?\s*v?(\d+)(?:\.(\d+))?(?:\.(\d+))?/.exec(
+    String(constraint).trim(),
+  );
+  if (!m) {
+    return null;
+  }
+  return {
+    op: m[1] || ">=",
+    major: Number(m[2]),
+    minor: m[3] !== undefined ? Number(m[3]) : 0,
+    patch: m[4] !== undefined ? Number(m[4]) : 0,
+  };
+}
+
+function satisfiesEngines(current, required) {
+  function cmp(a, b) {
+    if (a.major !== b.major) {
+      return a.major - b.major;
+    }
+    if (a.minor !== b.minor) {
+      return a.minor - b.minor;
+    }
+    return a.patch - b.patch;
+  }
+  var delta = cmp(current, required);
+  switch (required.op) {
+    case ">=":
+      return delta >= 0;
+    case ">":
+      return delta > 0;
+    case "<=":
+      return delta <= 0;
+    case "<":
+      return delta < 0;
+    case "=":
+      return delta === 0;
+    default:
+      return delta >= 0;
+  }
+}
+
+function checkNodeVersion(nodeVersion, enginesNode) {
+  if (nodeVersion === undefined) {
+    nodeVersion = process.version;
+  }
+  if (enginesNode === undefined) {
+    enginesNode = readEnginesNode();
+  }
+  var current = parseSemver(nodeVersion);
+  var required = parseEnginesConstraint(enginesNode);
+  if (!current || !required) {
+    return {
+      ok: false,
+      current: nodeVersion,
+      required: enginesNode,
+      recommended: RECOMMENDED_NODE,
+      reason: "could not parse Node or engines constraint",
+    };
+  }
+  var ok = satisfiesEngines(current, required);
+  return {
+    ok: ok,
+    current: "v" + current.major + "." + current.minor + "." + current.patch,
+    required: enginesNode,
+    recommended: RECOMMENDED_NODE,
+    reason: ok
+      ? null
+      : "need Node " +
+        enginesNode +
+        ", found v" +
+        current.major +
+        "." +
+        current.minor +
+        "." +
+        current.patch,
+  };
+}
+
+function shellComment(platform) {
+  if (platform === "win32") {
+    return "REM";
+  }
+  return "#";
+}
+
+function formatNodeUpgradeHelp(result, platform) {
+  if (platform === undefined) {
+    platform = os.platform();
+  }
+  var lines = [];
+  var c = shellComment(platform);
+  lines.push("");
+  lines.push("omnish needs a newer Node.js to install and run.");
+  lines.push("  Required : Node " + result.required + " (see package.json engines)");
+  lines.push("  You have : " + result.current);
+  lines.push("  Recommend: Node " + result.recommended + " (matches .nvmrc in the repo)");
+  lines.push("");
+  lines.push("Why: omnish ships native addons (better-sqlite3, node-pty) and depends on");
+  lines.push("packages that require Node 22+. Older Node cannot install or run omnish.");
+  lines.push("");
+  lines.push("Pick one upgrade path, then re-run:");
+  lines.push("  npm install -g omnish");
+  lines.push("");
+
+  if (platform === "win32") {
+    lines.push("Windows — nvm-windows (recommended if you use nvm):");
+    lines.push("  nvm install 22");
+    lines.push("  nvm use 22");
+    lines.push("  node -v");
+    lines.push("  npm install -g omnish");
+    lines.push("");
+    lines.push("Windows — official installer / winget:");
+    lines.push("  winget install OpenJS.NodeJS.LTS");
+    lines.push("  node -v");
+    lines.push("  npm install -g omnish");
+    lines.push("");
+    lines.push("If npm still uses an old Node, open a new terminal after upgrading.");
+    return lines.join("\n");
+  }
+
+  if (platform === "darwin") {
+    lines.push("macOS — nvm (install + set default + install omnish):");
+    lines.push(c + " install nvm: https://github.com/nvm-sh/nvm#installing-and-updating");
+    lines.push(
+      "  curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.40.3/install.sh | bash",
+    );
+    lines.push(c + " restart your shell, then:");
+    lines.push("  nvm install 22");
+    lines.push("  nvm alias default 22");
+    lines.push("  node -v");
+    lines.push("  npm install -g omnish");
+    lines.push("");
+    lines.push("macOS — Homebrew:");
+    lines.push("  brew install node@22");
+    lines.push("  brew link --overwrite --force node@22");
+    lines.push("  node -v");
+    lines.push("  npm install -g omnish");
+    lines.push("");
+    lines.push("macOS — fnm:");
+    lines.push("  fnm install 22");
+    lines.push("  fnm default 22");
+    lines.push("  npm install -g omnish");
+    return lines.join("\n");
+  }
+
+  lines.push("Linux VPS / server — Debian or Ubuntu (replaces old apt node, e.g. v12):");
+  lines.push("  curl -fsSL https://deb.nodesource.com/setup_22.x | bash -");
+  lines.push("  apt-get install -y nodejs");
+  lines.push("  node -v");
+  lines.push("  npm install -g omnish");
+  lines.push("");
+  lines.push("Linux — nvm (install + set default + install omnish):");
+  lines.push(c + " install nvm: https://github.com/nvm-sh/nvm#installing-and-updating");
+  lines.push(
+    "  curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.40.3/install.sh | bash",
+  );
+  lines.push(c + " restart your shell, then:");
+  lines.push("  nvm install 22");
+  lines.push("  nvm alias default 22");
+  lines.push("  node -v");
+  lines.push("  npm install -g omnish");
+  lines.push("");
+  lines.push("Linux — fnm:");
+  lines.push("  fnm install 22");
+  lines.push("  fnm default 22");
+  lines.push("  npm install -g omnish");
+  lines.push("");
+  lines.push("Linux — official builds:");
+  lines.push("  https://nodejs.org/en/download  (pick 22.x)");
+  lines.push("");
+  lines.push("One-liner bootstrap (tries nvm/fnm, then installs omnish):");
+  lines.push(
+    "  curl -fsSL https://raw.githubusercontent.com/labKnowledge/omnish/main/contrib/install-omnish.sh | bash",
+  );
+  return lines.join("\n");
+}
+
+function formatNativeModuleNodeHint(overrides) {
+  overrides = overrides || {};
+  var current =
+    overrides.current !== undefined ? overrides.current : process.version;
+  var result = checkNodeVersion(current, overrides.required);
+  var lines = [
+    "",
+    "This often means Node was upgraded/downgraded after omnish was installed, or npm used",
+    "a different Node than your shell default.",
+    "",
+    "Node now: " + result.current + " (required: " + result.required + ")",
+    "",
+    "Fix:",
+    "  1. Switch to Node 22+ and set it as default (see commands below)",
+    "  2. Reinstall: npm install -g omnish",
+    "  3. Or rebuild natives: npm rebuild -g omnish",
+    formatNodeUpgradeHelp(result),
+  ];
+  return lines.join("\n");
+}
+
+module.exports = {
+  parseSemver: parseSemver,
+  parseEnginesConstraint: parseEnginesConstraint,
+  satisfiesEngines: satisfiesEngines,
+  checkNodeVersion: checkNodeVersion,
+  formatNodeUpgradeHelp: formatNodeUpgradeHelp,
+  formatNativeModuleNodeHint: formatNativeModuleNodeHint,
+};