@khanglvm/llm-router 1.3.1 → 2.0.0-beta.0

package/src/node/web-command.js

@@ -0,0 +1,106 @@
+import { spawn } from "node:child_process";
+import { getDefaultConfigPath } from "./config-store.js";
+import { FIXED_LOCAL_ROUTER_HOST, FIXED_LOCAL_ROUTER_PORT } from "./local-server-settings.js";
+import { startWebConsoleServer } from "./web-console-server.js";
+
+function toBoolean(value, fallback) {
+  if (value === undefined || value === null || value === "") return fallback;
+  if (typeof value === "boolean") return value;
+  const normalized = String(value).trim().toLowerCase();
+  if (["1", "true", "yes", "y", "on"].includes(normalized)) return true;
+  if (["0", "false", "no", "n", "off"].includes(normalized)) return false;
+  return fallback;
+}
+
+function toPort(value, fallback) {
+  if (value === undefined || value === null || value === "") return fallback;
+  const parsed = Number.parseInt(String(value), 10);
+  if (!Number.isInteger(parsed) || parsed < 0 || parsed > 65535) return fallback;
+  return parsed;
+}
+
+export function resolveWebListenPort({ explicitPort, env = process.env, defaultPort = 8788 } = {}) {
+  return toPort(explicitPort, toPort(env.LLM_ROUTER_WEB_PORT, toPort(env.PORT, defaultPort)));
+}
+
+export function openBrowser(url) {
+  const platform = process.platform;
+  if (platform === "darwin") {
+    const child = spawn("open", [url], { detached: true, stdio: "ignore" });
+    child.unref();
+    return;
+  }
+
+  if (platform === "win32") {
+    const child = spawn("cmd", ["/c", "start", "", url], { detached: true, stdio: "ignore" });
+    child.unref();
+    return;
+  }
+
+  const child = spawn("xdg-open", [url], { detached: true, stdio: "ignore" });
+  child.unref();
+}
+
+export async function runWebCommand(options = {}) {
+  const host = String(options.host || "127.0.0.1").trim() || "127.0.0.1";
+  const port = resolveWebListenPort({ explicitPort: options.port, env: options.env });
+  const configPath = String(options.configPath || options.config || getDefaultConfigPath()).trim() || getDefaultConfigPath();
+  const shouldOpen = toBoolean(options.open ?? options.openBrowser, true);
+  const line = typeof options.onLine === "function" ? options.onLine : console.log;
+  const error = typeof options.onError === "function" ? options.onError : console.error;
+
+  let server;
+  try {
+    server = await startWebConsoleServer({
+      host,
+      port,
+      configPath,
+      routerHost: FIXED_LOCAL_ROUTER_HOST,
+      routerPort: FIXED_LOCAL_ROUTER_PORT,
+      routerWatchConfig: toBoolean(options.routerWatchConfig ?? options["router-watch-config"], true),
+      routerWatchBinary: toBoolean(options.routerWatchBinary ?? options["router-watch-binary"], true),
+      routerRequireAuth: toBoolean(options.routerRequireAuth ?? options["router-require-auth"], false),
+      allowRemoteClients: toBoolean(options.allowRemoteClients ?? options["allow-remote-clients"], false),
+      cliPathForRouter: String(options.cliPathForRouter || process.env.LLM_ROUTER_CLI_PATH || process.argv[1] || "").trim()
+    });
+  } catch (startError) {
+    return {
+      ok: false,
+      exitCode: 1,
+      errorMessage: `Failed to start llm-router web console: ${startError instanceof Error ? startError.message : String(startError)}`
+    };
+  }
+
+  line(`LLM Router web console started on ${server.url}`);
+  line(`Config file: ${configPath}`);
+  line("Use the in-app Exit Web button or Ctrl+C to stop the web console.");
+  line("Closing the web console leaves the router service running.");
+
+  if (shouldOpen) {
+    try {
+      openBrowser(server.url);
+      line("Opening your default browser...");
+    } catch (openError) {
+      error(`Could not open browser automatically: ${openError instanceof Error ? openError.message : String(openError)}`);
+      line(`Open this URL manually: ${server.url}`);
+    }
+  }
+
+  const handleSignal = (signal) => {
+    line(`Received ${signal}. Closing web console (router stays running)...`);
+    void server.close(signal.toLowerCase());
+  };
+  process.once("SIGINT", handleSignal);
+  process.once("SIGTERM", handleSignal);
+
+  await server.done;
+
+  process.removeListener("SIGINT", handleSignal);
+  process.removeListener("SIGTERM", handleSignal);
+
+  return {
+    ok: true,
+    exitCode: 0,
+    data: "Web console stopped. Router service keeps running."
+  };
+}

package/src/node/web-console-assets.js

@@ -0,0 +1,26 @@
+import { WEB_CONSOLE_CSS } from "./web-console-styles.generated.js";
+
+export { WEB_CONSOLE_CSS };
+
+export function renderWebConsoleHtml({
+  title = "LLM Router Web",
+  headHtml = "",
+  bodyHtml = ""
+} = {}) {
+  return String.raw`<!doctype html>
+<html lang="en">
+  <head>
+    <meta charset="utf-8">
+    <meta name="viewport" content="width=device-width, initial-scale=1">
+    <meta name="color-scheme" content="light">
+    <title>${title}</title>
+    ${headHtml}
+    <link rel="stylesheet" href="/styles.css">
+    <script src="/app.js" defer></script>
+  </head>
+  <body>
+    <div id="app"></div>
+    ${bodyHtml}
+  </body>
+</html>`;
+}