lianrouter 2.1.1 → 2.2.1

package/dist/cli.js

@@ -17,7 +17,7 @@ var package_default;
 var init_package = __esm(() => {
   package_default = {
     name: "lianrouter",
-    version: "2.1.1",
+    version: "2.2.1",
     description: "LianRouter launcher: install, run and control the gateway from one command",
     type: "module",
     bin: {
@@ -482,7 +482,7 @@ class GitHubReleaseSource {
       };
     });
     return {
-      version: newest.tag_name,
+      version: normalizeVersion(newest.tag_name),
       notesUrl: newest.html_url,
       ...newest.published_at.length > 0 ? { publishedAt: newest.published_at } : {},
       assets
@@ -507,7 +507,7 @@ var init_github_source = __esm(() => {
 });
 
 // cli/update/install.ts
-import { cp, mkdir as mkdir2, rename, rm as rm3, stat } from "fs/promises";
+import { cp, mkdir as mkdir2, readdir as readdir2, rename, rm as rm3, stat } from "fs/promises";
 import { dirname, join as join2, relative, resolve as resolve2, sep as sep2 } from "path";
 async function pathExists(target) {
   try {
@@ -534,6 +534,26 @@ async function assertNotDevCheckout(installRoot) {
     throw new Error(`refusing to self-update ${root}: it is a source checkout (.git and src/main.ts present). ` + "Build locally with `bun run build` instead of installing a release over the working tree.");
   }
 }
+async function sweepBackups(root, remove = rm3) {
+  const backupDir = join2(resolve2(root), BACKUP_DIR_NAME);
+  let entries;
+  try {
+    entries = await readdir2(backupDir);
+  } catch {
+    return;
+  }
+  let failed = false;
+  for (const entry of entries) {
+    await remove(join2(backupDir, entry), { recursive: true, force: true }).catch(() => {
+      failed = true;
+    });
+  }
+  if (!failed) {
+    await remove(backupDir, { recursive: true, force: true }).catch(() => {
+      return;
+    });
+  }
+}
 async function installAtomically(options) {
   const root = resolve2(options.installRoot);
   const staged = resolve2(options.stagedDir);
@@ -590,7 +610,7 @@ async function installAtomically(options) {
     throw error;
   }
   onProgress?.({ percent: 100, message: "install complete" });
-  await rm3(backupRoot, { recursive: true, force: true });
+  await sweepBackups(root, options.remove ?? rm3);
 }
 var BACKUP_DIR_NAME = ".backup";
 var init_install = () => {};
@@ -618,15 +638,19 @@ async function readInstalledVersion(installRoot) {
   if (typeof version !== "string" || version.trim().length === 0) {
     return;
   }
+  const normalized = normalizeVersion(version);
+  if (normalized.length === 0) {
+    return;
+  }
   return {
-    version: version.trim(),
+    version: normalized,
     installedAt: typeof installedAt === "string" ? installedAt : "",
     assetName: typeof assetName === "string" ? assetName : ""
   };
 }
 async function writeInstalledVersion(installRoot, record) {
   const payload = {
-    version: record.version,
+    version: normalizeVersion(record.version),
     installedAt: record.installedAt,
     assetName: record.assetName
   };
@@ -646,7 +670,7 @@ var init_version_file = __esm(() => {
 });
 
 // cli/update/engine.ts
-import { mkdtemp, readdir as readdir2, rm as rm4 } from "fs/promises";
+import { mkdtemp, readdir as readdir3, rm as rm4 } from "fs/promises";
 import { tmpdir } from "os";
 import { join as join4 } from "path";
 function withinSlice(start, end, percent) {
@@ -700,7 +724,7 @@ async function resolveInstallCandidate(opts) {
   };
 }
 async function payloadEntries(stagedDir) {
-  const entries = await readdir2(stagedDir, { withFileTypes: true });
+  const entries = await readdir3(stagedDir, { withFileTypes: true });
   return entries.map((entry) => entry.name);
 }
 async function runUpdate(opts) {
@@ -868,6 +892,9 @@ function resolveBinaryPath(installRoot = resolveInstallRoot(), platform = proces
 function resolveLogFile(installRoot = resolveInstallRoot()) {
   return join5(installRoot, LOGS_DIR, LOG_FILE_NAME);
 }
+function resolveConfigFile(installRoot = resolveInstallRoot()) {
+  return join5(installRoot, CONFIG_FILE_NAME);
+}
 function resolvePidFile(installRoot = resolveInstallRoot()) {
   return join5(resolveStateDir(installRoot), PID_FILE_NAME);
 }
@@ -930,7 +957,7 @@ function consoleUrl(port, host = "localhost") {
 function healthUrl(port) {
   return `http://127.0.0.1:${port}/health`;
 }
-var HOME_ENV = "LIANROUTER_HOME", APP_DIR_NAME = "LianRouter", LOGS_DIR = "logs", CACHE_DIR = "cache", RUN_DIR = "run", UPDATE_CACHE_DIR = "updates", LOG_FILE_NAME = "lianrouter.log", PID_FILE_NAME = "lianrouter.pid", CONTROL_FILE_NAME = "control.json", TRAY_PID_FILE_NAME = "tray.pid", DEFAULT_PORT = 12800;
+var HOME_ENV = "LIANROUTER_HOME", APP_DIR_NAME = "LianRouter", LOGS_DIR = "logs", CACHE_DIR = "cache", RUN_DIR = "run", UPDATE_CACHE_DIR = "updates", CONFIG_FILE_NAME = ".env", LOG_FILE_NAME = "lianrouter.log", PID_FILE_NAME = "lianrouter.pid", CONTROL_FILE_NAME = "control.json", TRAY_PID_FILE_NAME = "tray.pid", DEFAULT_PORT = 12800;
 var init_paths = () => {};
 
 // cli/tui/terminal.ts
@@ -1557,7 +1584,7 @@ var init_app = __esm(async () => {
 
 // cli/src/launcher.ts
 init_version();
-import { existsSync as existsSync3 } from "fs";
+import { existsSync as existsSync4 } from "fs";
 import { join as join8 } from "path";
 
 // cli/src/bootstrap.ts
@@ -1569,7 +1596,7 @@ init_install();
 init_version_file();
 init_paths();
 import { statSync } from "fs";
-import { mkdir as mkdir3, mkdtemp as mkdtemp2, readdir as readdir3, rm as rm5 } from "fs/promises";
+import { mkdir as mkdir3, mkdtemp as mkdtemp2, readdir as readdir4, rm as rm5 } from "fs/promises";
 import { tmpdir as tmpdir2 } from "os";
 import { join as join6 } from "path";
 var SLICE2 = {
@@ -1598,7 +1625,7 @@ function withinSlice2(start, end, percent) {
   return start + (end - start) * clamped / 100;
 }
 async function payloadEntries2(stagedDir) {
-  const entries = await readdir3(stagedDir, { withFileTypes: true });
+  const entries = await readdir4(stagedDir, { withFileTypes: true });
   return entries.map((entry) => entry.name);
 }
 async function ensureGatewayInstalled(options) {
@@ -1987,7 +2014,7 @@ function buildMenuItems(input) {
   if (input.update !== undefined) {
     items.push({
       action: "update",
-      label: `Update to v${input.update.latest} (current: v${input.version})`
+      label: `Update to v${input.update.latest} (current: v${input.update.current})`
     });
   }
   items.push({ action: "web", label: "Web UI (Open in Browser)" }, { action: "tui", label: "Terminal UI (Interactive CLI)" }, { action: "tray", label: "Hide to Tray (Background)" }, { action: "exit", label: "Exit" });
@@ -2604,6 +2631,134 @@ class GatewaySupervisor {
   }
 }
 
+// cli/src/install-config.ts
+init_paths();
+import { randomBytes } from "crypto";
+import { existsSync as existsSync2, mkdirSync as mkdirSync2, readFileSync as readFileSync2, writeFileSync } from "fs";
+var ALWAYS_REQUIRED = ["DATABASE_URL", "LIANROUTER_ENCRYPTION_KEY"];
+function parseEnvFile(text) {
+  const values = {};
+  for (const rawLine of text.split(/\r?\n/)) {
+    const line = rawLine.trim();
+    if (line === "" || line.startsWith("#")) {
+      continue;
+    }
+    const separator = line.indexOf("=");
+    if (separator <= 0) {
+      continue;
+    }
+    const key = line.slice(0, separator).trim();
+    if (!/^[A-Za-z_][A-Za-z0-9_]*$/.test(key)) {
+      continue;
+    }
+    let value = line.slice(separator + 1).trim();
+    const quote = value[0];
+    if (quote === '"' || quote === "'") {
+      if (value.length >= 2 && value.endsWith(quote)) {
+        value = value.slice(1, -1);
+      }
+    }
+    values[key] = value;
+  }
+  return values;
+}
+function resolveGatewayConfig(installRoot, shellEnv = process.env) {
+  const path = resolveConfigFile(installRoot);
+  const present = existsSync2(path);
+  const fileValues = present ? parseEnvFile(readFileSync2(path, "utf8")) : {};
+  const env = {};
+  for (const [key, value] of Object.entries(fileValues)) {
+    if (shellEnv[key] !== undefined && shellEnv[key].trim() !== "") {
+      continue;
+    }
+    if (value.trim() === "") {
+      continue;
+    }
+    env[key] = value;
+  }
+  const effective = (name) => {
+    const fromShell = shellEnv[name];
+    if (fromShell !== undefined && fromShell.trim() !== "") {
+      return fromShell.trim();
+    }
+    const fromFile = fileValues[name];
+    return fromFile !== undefined && fromFile.trim() !== "" ? fromFile.trim() : undefined;
+  };
+  const required = [...ALWAYS_REQUIRED];
+  if ((effective("REDIS_MODE") ?? "normal") === "normal") {
+    required.push("REDIS_URL");
+  }
+  const missing = required.filter((name) => effective(name) === undefined);
+  return { path, present, env, missing };
+}
+function describeMissingConfig(config) {
+  const location = config.present ? `  config file: ${config.path}` : `  config file: ${config.path} (not found)`;
+  const examples = {
+    DATABASE_URL: "postgres://user:password@localhost:5432/lianrouter",
+    LIANROUTER_ENCRYPTION_KEY: "<base64 or 64-character hex that decodes to exactly 32 bytes>",
+    REDIS_URL: "redis://localhost:6379"
+  };
+  const lines = [
+    "the gateway is not configured, so it cannot start",
+    location,
+    `  missing:     ${config.missing.join(", ")}`,
+    "",
+    "add these lines to that file:",
+    ...config.missing.map((name) => `  ${name}=${examples[name] ?? "<value>"}`),
+    "",
+    "or set them in your shell before starting; a shell value wins over the file.",
+    `run \`lianrouter init\` to write a starter file at ${config.path}`
+  ];
+  if (config.missing.includes("REDIS_URL")) {
+    lines.push("to run a single gateway process without Redis, set REDIS_MODE=single_instance_local instead of REDIS_URL");
+  }
+  return lines.join(`
+`);
+}
+function assertGatewayConfigured(config) {
+  if (config.missing.length > 0) {
+    throw new Error(describeMissingConfig(config));
+  }
+}
+function starterConfigText(encryptionKey) {
+  return `# LianRouter gateway configuration.
+# The launcher reads this file and passes its values to the gateway process.
+# A variable already set in your shell wins over the value written here.
+# Generated by \`lianrouter init\`.
+
+# PostgreSQL connection string. Required.
+# Replace the placeholder below and remove the leading "# ". The gateway never
+# infers a Docker or Laragon connection.
+# DATABASE_URL=postgres://user:password@localhost:5432/lianrouter
+
+# 256-bit key for encrypting provider credentials and hashing API keys.
+# Required. Base64 (44 characters) or hex (64 characters); it must decode to
+# exactly 32 bytes. Keep it secret and keep it stable: a new key cannot decrypt
+# credentials encrypted with the old one.
+LIANROUTER_ENCRYPTION_KEY=${encryptionKey}
+
+# Redis coordination. REDIS_URL is required in the default mode; set
+# REDIS_MODE=single_instance_local to run a single gateway process without
+# Redis at all.
+REDIS_MODE=normal
+# REDIS_URL=redis://localhost:6379
+`;
+}
+function writeStarterConfig(installRoot) {
+  const path = resolveConfigFile(installRoot);
+  mkdirSync2(installRoot, { recursive: true });
+  const encryptionKey = randomBytes(32).toString("base64");
+  try {
+    writeFileSync(path, starterConfigText(encryptionKey), { encoding: "utf8", flag: "wx" });
+  } catch (error) {
+    if (error.code === "EEXIST") {
+      throw new Error(`refusing to overwrite the existing config file at ${path}`);
+    }
+    throw error;
+  }
+  return path;
+}
+
 // cli/src/update-flow.ts
 init_version_file();
 async function resolveGatewayVersion(installRoot, launcherVersion) {
@@ -2667,11 +2822,11 @@ async function runUpdateSequence(deps) {
 
 // cli/src/tray-launcher.ts
 init_paths();
-import { existsSync as existsSync2 } from "fs";
+import { existsSync as existsSync3 } from "fs";
 import { readFile as readFile2, rm as rm8, writeFile as writeFile3 } from "fs/promises";
 import { join as join7 } from "path";
 function resolveTrayEntry(options) {
-  return trayEntryCandidates(options).find((candidate) => existsSync2(candidate));
+  return trayEntryCandidates(options).find((candidate) => existsSync3(candidate));
 }
 function trayEntryCandidates(options) {
   const bundleDir = options.bundleDir ?? import.meta.dir;
@@ -2805,6 +2960,7 @@ Commands:
   update           Check for and install an update
   tray             Run the gateway in the background with a tray icon
   tui              Open the terminal UI
+  init             Write a starter config file into the install root
 
 Options:
   --port <n>       Gateway port (default ${DEFAULT_PORT}, or $PORT)
@@ -2818,7 +2974,15 @@ Options:
 Environment:
   LIANROUTER_HOME  Override the install/state root
   PORT             Default gateway port`;
-var KNOWN_COMMANDS = ["start", "stop", "status", "update", "tray", "tui"];
+var KNOWN_COMMANDS = [
+  "start",
+  "stop",
+  "status",
+  "update",
+  "tray",
+  "tui",
+  "init"
+];
 function parseArgs(argv) {
   let port;
   let host = "localhost";
@@ -2906,7 +3070,7 @@ function readPortEnv() {
 }
 function resolveRuntime() {
   const repoRoot = resolveDevRepoRoot();
-  if (repoRoot !== undefined && existsSync3(join8(repoRoot, "src", "app.ts"))) {
+  if (repoRoot !== undefined && existsSync4(join8(repoRoot, "src", "app.ts"))) {
     return {
       installRoot: resolveInstallRoot(),
       cwd: repoRoot,
@@ -2918,7 +3082,7 @@ function resolveRuntime() {
   return { installRoot, cwd: installRoot, command: undefined, devRepoRoot: undefined };
 }
 async function ensureInstalledGateway(installRoot) {
-  const present = existsSync3(resolveBinaryPath(installRoot));
+  const present = existsSync4(resolveBinaryPath(installRoot));
   if (present) {
     await ensureGatewayInstalled({ installRoot, currentVersion: CLI_VERSION });
     return;
@@ -2952,6 +3116,17 @@ async function run(argv) {
     return 0;
   }
   const runtime = resolveRuntime();
+  if (options.command === "init") {
+    const path = writeStarterConfig(runtime.installRoot);
+    console.log(`Wrote ${path}`);
+    console.log("Set DATABASE_URL in that file (uncomment the line), then run lianrouter.");
+    return 0;
+  }
+  const startsGateway = options.command === undefined || options.command === "start" || options.command === "tray" || options.command === "tui";
+  const gatewayConfig = runtime.command === undefined && startsGateway ? resolveGatewayConfig(runtime.installRoot) : undefined;
+  if (gatewayConfig !== undefined) {
+    assertGatewayConfigured(gatewayConfig);
+  }
   if (runtime.command === undefined && options.command !== "status" && options.command !== "stop") {
     await ensureInstalledGateway(runtime.installRoot);
   }
@@ -2960,7 +3135,10 @@ async function run(argv) {
     installRoot: runtime.installRoot,
     logFile: resolveLogFile(runtime.installRoot),
     cwd: runtime.cwd,
-    env: { LIANROUTER_LAUNCHER_HOME: runtime.installRoot },
+    env: {
+      LIANROUTER_LAUNCHER_HOME: runtime.installRoot,
+      ...gatewayConfig?.env ?? {}
+    },
     ...runtime.command === undefined ? {} : { command: runtime.command }
   });
   switch (options.command) {
@@ -3117,7 +3295,7 @@ async function runInteractive(supervisor, options, runtime) {
   const action = await promptMenu({
     version: CLI_VERSION,
     port: supervisor.status.port,
-    update: update !== null && update.available ? { latest: update.latest } : undefined
+    update: update !== null && update.available ? { latest: update.latest, current: update.current } : undefined
   });
   return await dispatch(action, supervisor, session, options, runtime);
 }

package/package.json

@@ -1,43 +1,43 @@
-{
-  "name": "lianrouter",
-  "version": "2.1.1",
-  "description": "LianRouter launcher: install, run and control the gateway from one command",
-  "type": "module",
-  "bin": {
-    "lianrouter": "./dist/cli.js"
-  },
-  "engines": {
-    "bun": ">=1.4.2"
-  },
-  "files": [
-    "dist",
-    "README.md"
-  ],
-  "scripts": {
-    "build": "bun run ../scripts/build-cli.ts",
-    "typecheck": "tsc --noEmit -p .",
-    "postinstall": "echo lianrouter: the gateway binary installs on first run, not during this install",
-    "prepublishOnly": "bun run build"
-  },
-  "repository": {
-    "type": "git",
-    "url": "git+https://github.com/ReXooGen/Lian-Router.git",
-    "directory": "cli"
-  },
-  "bugs": {
-    "url": "https://github.com/ReXooGen/Lian-Router/issues"
-  },
-  "homepage": "https://github.com/ReXooGen/Lian-Router#readme",
-  "publishConfig": {
-    "access": "public"
-  },
-  "keywords": [
-    "lianrouter",
-    "ai-gateway",
-    "openai-compatible",
-    "llm-router",
-    "self-hosted",
-    "cli",
-    "launcher"
-  ]
-}
+{
+  "name": "lianrouter",
+  "version": "2.2.1",
+  "description": "LianRouter launcher: install, run and control the gateway from one command",
+  "type": "module",
+  "bin": {
+    "lianrouter": "./dist/cli.js"
+  },
+  "engines": {
+    "bun": ">=1.4.2"
+  },
+  "files": [
+    "dist",
+    "README.md"
+  ],
+  "scripts": {
+    "build": "bun run ../scripts/build-cli.ts",
+    "typecheck": "tsc --noEmit -p .",
+    "postinstall": "echo lianrouter: the gateway binary installs on first run, not during this install",
+    "prepublishOnly": "bun run build"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/ReXooGen/Lian-Router.git",
+    "directory": "cli"
+  },
+  "bugs": {
+    "url": "https://github.com/ReXooGen/Lian-Router/issues"
+  },
+  "homepage": "https://github.com/ReXooGen/Lian-Router#readme",
+  "publishConfig": {
+    "access": "public"
+  },
+  "keywords": [
+    "lianrouter",
+    "ai-gateway",
+    "openai-compatible",
+    "llm-router",
+    "self-hosted",
+    "cli",
+    "launcher"
+  ]
+}