@forinda/kickjs-cli 0.6.0 → 0.7.0

package/dist/cli.js

@@ -4,6 +4,9 @@ var __name = (target, value) => __defProp(target, "name", { value, configurable:
 
 // src/cli.ts
 import { Command } from "commander";
+import { readFileSync as readFileSync2 } from "fs";
+import { dirname as dirname3, join as join11 } from "path";
+import { fileURLToPath as fileURLToPath2 } from "url";
 
 // src/commands/init.ts
 import { resolve, basename } from "path";
@@ -11,8 +14,10 @@ import { createInterface } from "readline";
 import { existsSync, readdirSync, rmSync } from "fs";
 
 // src/generators/project.ts
-import { join } from "path";
+import { join, dirname as dirname2 } from "path";
 import { execSync } from "child_process";
+import { readFileSync } from "fs";
+import { fileURLToPath } from "url";
 
 // src/utils/fs.ts
 import { writeFile, mkdir, access, readFile } from "fs/promises";
@@ -35,6 +40,9 @@ async function fileExists(filePath) {
 __name(fileExists, "fileExists");
 
 // src/generators/project.ts
+var __dirname = dirname2(fileURLToPath(import.meta.url));
+var cliPkg = JSON.parse(readFileSync(join(__dirname, "..", "package.json"), "utf-8"));
+var KICKJS_VERSION = `^${cliPkg.version}`;
 async function initProject(options) {
   const { name, directory, packageManager = "pnpm" } = options;
   const dir = directory;
@@ -43,7 +51,7 @@ async function initProject(options) {
 `);
   await writeFileSafe(join(dir, "package.json"), JSON.stringify({
     name,
-    version: "0.1.0",
+    version: cliPkg.version,
     type: "module",
     scripts: {
       dev: "kick dev",
@@ -57,10 +65,10 @@ async function initProject(options) {
       format: "prettier --write src/"
     },
     dependencies: {
-      "@forinda/kickjs-core": "^0.1.0",
-      "@forinda/kickjs-http": "^0.1.0",
-      "@forinda/kickjs-config": "^0.1.0",
-      "@forinda/kickjs-swagger": "^0.1.0",
+      "@forinda/kickjs-core": KICKJS_VERSION,
+      "@forinda/kickjs-http": KICKJS_VERSION,
+      "@forinda/kickjs-config": KICKJS_VERSION,
+      "@forinda/kickjs-swagger": KICKJS_VERSION,
       express: "^5.1.0",
       "reflect-metadata": "^0.2.2",
       zod: "^4.3.6",
@@ -68,7 +76,7 @@ async function initProject(options) {
       "pino-pretty": "^13.1.3"
     },
     devDependencies: {
-      "@forinda/kickjs-cli": "^0.1.0",
+      "@forinda/kickjs-cli": KICKJS_VERSION,
       "@swc/core": "^1.7.28",
       "@types/express": "^5.0.6",
       "@types/node": "^24.5.2",
@@ -166,7 +174,7 @@ bootstrap({
   modules,
   adapters: [
     new SwaggerAdapter({
-      info: { title: '${name}', version: '0.1.0' },
+      info: { title: '${name}', version: '${cliPkg.version}' },
     }),
   ],
 })
@@ -1650,6 +1658,161 @@ function registerSingleCommand(program, def) {
 }
 __name(registerSingleCommand, "registerSingleCommand");
 
+// src/commands/inspect.ts
+var esc = /* @__PURE__ */ __name((code) => `\x1B[${code}m`, "esc");
+var reset = esc("0");
+var bold = /* @__PURE__ */ __name((s) => `${esc("1")}${s}${reset}`, "bold");
+var dim = /* @__PURE__ */ __name((s) => `${esc("2")}${s}${reset}`, "dim");
+var green = /* @__PURE__ */ __name((s) => `${esc("32")}${s}${reset}`, "green");
+var red = /* @__PURE__ */ __name((s) => `${esc("31")}${s}${reset}`, "red");
+var yellow = /* @__PURE__ */ __name((s) => `${esc("33")}${s}${reset}`, "yellow");
+var cyan = /* @__PURE__ */ __name((s) => `${esc("36")}${s}${reset}`, "cyan");
+var magenta = /* @__PURE__ */ __name((s) => `${esc("35")}${s}${reset}`, "magenta");
+var blue = /* @__PURE__ */ __name((s) => `${esc("34")}${s}${reset}`, "blue");
+var METHOD_COLORS = {
+  GET: green,
+  POST: cyan,
+  PUT: yellow,
+  PATCH: magenta,
+  DELETE: red
+};
+function colorMethod(method) {
+  const fn = METHOD_COLORS[method] ?? dim;
+  return fn(method.padEnd(7));
+}
+__name(colorMethod, "colorMethod");
+function formatUptime(seconds) {
+  const d = Math.floor(seconds / 86400);
+  const h = Math.floor(seconds % 86400 / 3600);
+  const m = Math.floor(seconds % 3600 / 60);
+  const s = seconds % 60;
+  const parts = [];
+  if (d) parts.push(`${d}d`);
+  if (h) parts.push(`${h}h`);
+  if (m) parts.push(`${m}m`);
+  parts.push(`${s}s`);
+  return parts.join(" ");
+}
+__name(formatUptime, "formatUptime");
+async function fetchJson(url) {
+  const res = await fetch(url, {
+    signal: AbortSignal.timeout(5e3)
+  });
+  if (!res.ok) throw new Error(`${res.status} ${res.statusText}`);
+  return res.json();
+}
+__name(fetchJson, "fetchJson");
+async function fetchEndpoint(base, path) {
+  try {
+    return await fetchJson(`${base}${path}`);
+  } catch {
+    return null;
+  }
+}
+__name(fetchEndpoint, "fetchEndpoint");
+async function fetchAll(base) {
+  const [health, metrics, routes, container, ws] = await Promise.all([
+    fetchEndpoint(base, "/health"),
+    fetchEndpoint(base, "/metrics"),
+    fetchEndpoint(base, "/routes"),
+    fetchEndpoint(base, "/container"),
+    fetchEndpoint(base, "/ws")
+  ]);
+  return {
+    health,
+    metrics,
+    routes,
+    container,
+    ws
+  };
+}
+__name(fetchAll, "fetchAll");
+function printSummary(base, data) {
+  const { health, metrics, routes, container, ws } = data;
+  const line = dim("\u2500".repeat(60));
+  console.log();
+  console.log(bold(`  KickJS Inspector`) + dim(`  \u2192  ${base}`));
+  console.log(line);
+  if (health) {
+    const statusText = health.status === "healthy" ? green("\u25CF healthy") : red("\u25CF " + health.status);
+    console.log(`  ${bold("Health:")}    ${statusText}`);
+  } else {
+    console.log(`  ${bold("Health:")}    ${red("\u25CF unreachable")}`);
+  }
+  if (metrics) {
+    const rate = ((metrics.errorRate ?? 0) * 100).toFixed(1);
+    const rateColor = metrics.errorRate > 0.1 ? red : metrics.errorRate > 0 ? yellow : green;
+    console.log(`  ${bold("Uptime:")}    ${formatUptime(metrics.uptimeSeconds)}`);
+    console.log(`  ${bold("Requests:")}  ${metrics.requests}`);
+    console.log(`  ${bold("Errors:")}    ${metrics.serverErrors} server, ${metrics.clientErrors ?? 0} client  ${dim("(")}${rateColor(rate + "%")}${dim(")")}`);
+  }
+  if (container) {
+    console.log(`  ${bold("DI:")}        ${container.count} bindings`);
+  }
+  if (ws && ws.enabled) {
+    console.log(`  ${bold("WS:")}        ${ws.connections ?? 0} connections, ${ws.namespaces ?? 0} namespaces`);
+  }
+  if (routes?.routes?.length) {
+    console.log();
+    console.log(bold("  Routes"));
+    console.log(line);
+    console.log(`  ${dim("METHOD")}  ${dim("PATH".padEnd(36))} ${dim("CONTROLLER")}`);
+    for (const r of routes.routes) {
+      const path = r.path.length > 36 ? r.path.slice(0, 33) + "..." : r.path.padEnd(36);
+      console.log(`  ${colorMethod(r.method)} ${path} ${blue(r.controller)}.${dim(r.handler)}`);
+    }
+  }
+  console.log(line);
+  console.log();
+}
+__name(printSummary, "printSummary");
+function registerInspectCommand(program) {
+  program.command("inspect [url]").description("Connect to a running KickJS app and display debug info").option("-p, --port <port>", "Override port").option("-w, --watch", "Poll every 5 seconds").option("-j, --json", "Output raw JSON").action(async (url, opts) => {
+    let base = url ?? "http://localhost:3000";
+    if (opts.port) {
+      try {
+        const parsed = new URL(base);
+        parsed.port = opts.port;
+        base = parsed.origin;
+      } catch {
+        base = `http://localhost:${opts.port}`;
+      }
+    }
+    const debugBase = `${base.replace(/\/$/, "")}/_debug`;
+    const run = /* @__PURE__ */ __name(async () => {
+      try {
+        const data = await fetchAll(debugBase);
+        if (opts.json) {
+          console.log(JSON.stringify(data, null, 2));
+        } else {
+          printSummary(base, data);
+        }
+      } catch (err) {
+        if (opts.json) {
+          console.log(JSON.stringify({
+            error: String(err)
+          }));
+        } else {
+          console.error(red(`  \u2716 Could not connect to ${base}`));
+          console.error(dim(`    ${err instanceof Error ? err.message : String(err)}`));
+        }
+        if (!opts.watch) process.exitCode = 1;
+      }
+    }, "run");
+    if (opts.watch) {
+      const poll = /* @__PURE__ */ __name(async () => {
+        process.stdout.write("\x1B[2J\x1B[H");
+        await run();
+      }, "poll");
+      await poll();
+      setInterval(poll, 5e3);
+    } else {
+      await run();
+    }
+  });
+}
+__name(registerInspectCommand, "registerInspectCommand");
+
 // src/config.ts
 import { readFile as readFile3, access as access2 } from "fs/promises";
 import { join as join10 } from "path";
@@ -1687,14 +1850,17 @@ async function loadKickConfig(cwd) {
 __name(loadKickConfig, "loadKickConfig");
 
 // src/cli.ts
+var __dirname2 = dirname3(fileURLToPath2(import.meta.url));
+var pkg = JSON.parse(readFileSync2(join11(__dirname2, "..", "package.json"), "utf-8"));
 async function main() {
   const program = new Command();
-  program.name("kick").description("KickJS \u2014 A production-grade, decorator-driven Node.js framework").version("0.1.0");
+  program.name("kick").description("KickJS \u2014 A production-grade, decorator-driven Node.js framework").version(pkg.version);
   const config = await loadKickConfig(process.cwd());
   registerInitCommand(program);
   registerGenerateCommand(program);
   registerRunCommands(program);
   registerInfoCommand(program);
+  registerInspectCommand(program);
   registerCustomCommands(program, config);
   program.showHelpAfterError();
   await program.parseAsync(process.argv);