deepseek-tui 0.8.15 → 0.8.17

package/README.md

@@ -70,6 +70,9 @@ build-from-source guide.
 - Default binary version comes from `deepseekBinaryVersion` in `package.json`.
 - Set `DEEPSEEK_TUI_VERSION` or `DEEPSEEK_VERSION` to override the release version.
 - Set `DEEPSEEK_TUI_GITHUB_REPO` or `DEEPSEEK_GITHUB_REPO` to override the source repo (defaults to `Hmbown/DeepSeek-TUI`).
+- Set `DEEPSEEK_TUI_RELEASE_BASE_URL` to use an internal or mirrored
+  release-asset directory when GitHub Releases is unavailable. The directory
+  must contain `deepseek-artifacts-sha256.txt` and the platform binaries.
 - Set `DEEPSEEK_TUI_FORCE_DOWNLOAD=1` to force download even when the cached binary is already present.
 - Set `DEEPSEEK_TUI_DISABLE_INSTALL=1` to skip install-time download.
 - Set `DEEPSEEK_TUI_OPTIONAL_INSTALL=1` to make the `postinstall` step warn and exit `0` on download/extract errors instead of failing `npm install` (useful in CI matrices).
@@ -80,5 +83,3 @@ build-from-source guide.
   exist for the target GitHub release before publishing.
 - Install-time downloads are verified against the release checksum manifest before
   the wrapper marks them executable.
-- Set `DEEPSEEK_TUI_RELEASE_BASE_URL` to point the installer at a local or
-  staged release-asset directory for smoke tests.

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "deepseek-tui",
-  "version": "0.8.15",
-  "deepseekBinaryVersion": "0.8.15",
+  "version": "0.8.17",
+  "deepseekBinaryVersion": "0.8.17",
   "description": "Install and run deepseek and deepseek-tui binaries from GitHub release artifacts.",
   "author": "Hmbown",
   "license": "MIT",
@@ -30,7 +30,8 @@
     "release:check": "node scripts/verify-release-assets.js",
     "postinstall": "node scripts/install.js",
     "prepublishOnly": "node scripts/verify-release-assets.js",
-    "prepack": "node scripts/install.js"
+    "prepack": "node scripts/install.js",
+    "test": "node --test test/*.test.js"
   },
   "engines": {
     "node": ">=18"
@@ -42,6 +43,7 @@
   "files": [
     "bin/*.js",
     "scripts/*.js",
+    "test/*.js",
     "README.md",
     "package.json"
   ]

package/scripts/install.js

@@ -1,3 +1,18 @@
+function assertSupportedNode() {
+  const version = process.versions && process.versions.node ? process.versions.node : "unknown";
+  const major = Number.parseInt(String(version).split(".")[0], 10);
+  if (Number.isNaN(major) || major < 18) {
+    process.stderr.write(
+      "deepseek-tui: Node.js 18 or newer is required for npm installation. " +
+      `Current Node.js version is ${version}. ` +
+      "Please upgrade Node.js and rerun `npm install -g deepseek-tui`.\n",
+    );
+    process.exit(1);
+  }
+}
+
+assertSupportedNode();
+
 const fs = require("fs");
 const https = require("https");
 const http = require("http");
@@ -105,6 +120,48 @@ function logInfo(message) {
   process.stderr.write(`deepseek-tui: ${message}\n`);
 }
 
+function installFailureHint(error) {
+  const message = error && error.message ? String(error.message) : "";
+  const code = error && error.code ? String(error.code) : "";
+  const releaseBase =
+    process.env.DEEPSEEK_TUI_RELEASE_BASE_URL ||
+    process.env.DEEPSEEK_RELEASE_BASE_URL;
+  const networkMarkers = [
+    "github.com",
+    "ENOTFOUND",
+    "EAI_AGAIN",
+    "ETIMEDOUT",
+    "ECONNRESET",
+    "ENETUNREACH",
+    "EHOSTUNREACH",
+    "EDOWNLOADTIMEOUT",
+  ];
+  const looksLikeNetworkDownloadFailure = networkMarkers.some(
+    (marker) => message.includes(marker) || code === marker,
+  );
+  if (!looksLikeNetworkDownloadFailure) {
+    return "";
+  }
+
+  if (releaseBase) {
+    return [
+      "deepseek-tui install hint:",
+      `  DEEPSEEK_TUI_RELEASE_BASE_URL is set to ${releaseBase}`,
+      "  Verify that this directory contains deepseek-artifacts-sha256.txt",
+      "  plus the deepseek/deepseek-tui binary assets for your platform.",
+    ].join("\n");
+  }
+
+  return [
+    "deepseek-tui install hint:",
+    "  The npm package downloads prebuilt binaries from GitHub Releases.",
+    "  If GitHub is unavailable on this network, mirror the release assets and set:",
+    "    DEEPSEEK_TUI_RELEASE_BASE_URL=https://<mirror>/<release-asset-directory>/",
+    "  The directory must contain deepseek-artifacts-sha256.txt and the platform binaries.",
+    "  See docs/INSTALL.md#npm-download-is-slow-or-times-out-from-mainland-china.",
+  ].join("\n");
+}
+
 function envInt(name, fallback) {
   const raw = process.env[name];
   if (!raw) {
@@ -355,8 +412,14 @@ function connectThroughProxy(proxy, targetHost, targetPort, timeoutMs) {
 // ────────────────────────────────────────────────────────────────────────────
 
 function httpRequest(rawUrl, opts = {}) {
-  const totalTimeoutMs = opts.totalTimeoutMs ?? downloadTimeoutMs();
-  const stallMs = opts.stallMs ?? downloadStallMs();
+  const totalTimeoutMs =
+    opts.totalTimeoutMs === undefined || opts.totalTimeoutMs === null
+      ? downloadTimeoutMs()
+      : opts.totalTimeoutMs;
+  const stallMs =
+    opts.stallMs === undefined || opts.stallMs === null
+      ? downloadStallMs()
+      : opts.stallMs;
 
   return new Promise((resolve, reject) => {
     let url;
@@ -924,12 +987,17 @@ async function getBinaryPath(name) {
 
 module.exports = {
   getBinaryPath,
+  installFailureHint,
   run,
 };
 
 if (require.main === module) {
   run().catch((error) => {
     console.error("deepseek-tui install failed:", error.message);
+    const hint = installFailureHint(error);
+    if (hint) {
+      console.error(hint);
+    }
     if (process.env.DEEPSEEK_TUI_OPTIONAL_INSTALL === "1") {
       console.error(
         "DEEPSEEK_TUI_OPTIONAL_INSTALL=1 set; continuing without a usable binary.",

package/scripts/run.js

@@ -3,9 +3,8 @@ const { getBinaryPath } = require("./install");
 
 const pkg = require("../package.json");
 
-function isVersionFlag() {
-  const args = process.argv.slice(2);
-  return args.includes("--version") || args.includes("-v") || args.includes("-V");
+function isVersionFlag(args = process.argv.slice(2)) {
+  return args.includes("--version") || args.includes("-V");
 }
 
 function handleVersionFallback(binaryName) {
@@ -46,6 +45,7 @@ module.exports = {
   run,
   runDeepseek,
   runDeepseekTui,
+  _internal: { isVersionFlag },
 };
 
 if (require.main === module) {

package/test/install.test.js

@@ -0,0 +1,71 @@
+const assert = require("node:assert/strict");
+const fs = require("node:fs");
+const path = require("node:path");
+const test = require("node:test");
+
+const installScript = fs.readFileSync(
+  path.join(__dirname, "..", "scripts", "install.js"),
+  "utf8",
+);
+const { installFailureHint } = require("../scripts/install");
+
+test("install script checks Node support before loading helpers", () => {
+  const guardIndex = installScript.indexOf("assertSupportedNode();");
+  const firstRequireIndex = installScript.indexOf("require(");
+
+  assert.notEqual(guardIndex, -1);
+  assert.notEqual(firstRequireIndex, -1);
+  assert.ok(guardIndex < firstRequireIndex);
+});
+
+test("install script remains parseable before the Node support guard runs", () => {
+  assert.equal(installScript.includes("??"), false);
+  assert.equal(installScript.includes("?."), false);
+});
+
+test("install failure hint explains release base override for blocked GitHub downloads", () => {
+  const previous = process.env.DEEPSEEK_TUI_RELEASE_BASE_URL;
+  delete process.env.DEEPSEEK_TUI_RELEASE_BASE_URL;
+  try {
+    const error = Object.assign(
+      new Error(
+        "fetch https://github.com/Hmbown/DeepSeek-TUI/releases/download/v0.8.17/deepseek-artifacts-sha256.txt failed after 5 attempts:\ngetaddrinfo ENOTFOUND github.com",
+      ),
+      { code: "ENOTFOUND" },
+    );
+
+    const hint = installFailureHint(error);
+
+    assert.match(hint, /DEEPSEEK_TUI_RELEASE_BASE_URL/);
+    assert.match(hint, /deepseek-artifacts-sha256\.txt/);
+    assert.match(hint, /platform binaries/);
+  } finally {
+    if (previous === undefined) {
+      delete process.env.DEEPSEEK_TUI_RELEASE_BASE_URL;
+    } else {
+      process.env.DEEPSEEK_TUI_RELEASE_BASE_URL = previous;
+    }
+  }
+});
+
+test("install failure hint checks configured release base when override is already set", () => {
+  const previous = process.env.DEEPSEEK_TUI_RELEASE_BASE_URL;
+  process.env.DEEPSEEK_TUI_RELEASE_BASE_URL = "https://mirror.example/deepseek/";
+  try {
+    const error = Object.assign(new Error("download stalled"), {
+      code: "EDOWNLOADTIMEOUT",
+    });
+
+    const hint = installFailureHint(error);
+
+    assert.match(hint, /is set to https:\/\/mirror\.example\/deepseek\//);
+    assert.match(hint, /deepseek-artifacts-sha256\.txt/);
+    assert.doesNotMatch(hint, /If GitHub is unavailable/);
+  } finally {
+    if (previous === undefined) {
+      delete process.env.DEEPSEEK_TUI_RELEASE_BASE_URL;
+    } else {
+      process.env.DEEPSEEK_TUI_RELEASE_BASE_URL = previous;
+    }
+  }
+});

package/test/run.test.js

@@ -0,0 +1,11 @@
+const assert = require("node:assert/strict");
+const test = require("node:test");
+
+const { _internal } = require("../scripts/run");
+
+test("version fallback handles only version flags", () => {
+  assert.equal(_internal.isVersionFlag(["--version"]), true);
+  assert.equal(_internal.isVersionFlag(["-V"]), true);
+  assert.equal(_internal.isVersionFlag(["-v"]), false);
+  assert.equal(_internal.isVersionFlag(["--verbose"]), false);
+});