kavoru 0.2.0 → 0.4.0

package/README.md

@@ -14,6 +14,13 @@ bun run dev
 
 Equivalent to `bunx --bun kavoru` (Bun runs the `kavoru` binary from the npm package).
 
+**Stale UI after upgrade?** Bun caches `bunx` installs under `%TEMP%\bunx-*-kavoru@latest` and does not auto-refresh when a new version is published. Clear it or pin a version:
+
+```powershell
+Remove-Item -Recurse -Force "$env:TEMP\bunx-*-kavoru*"
+bunx kavoru@0.3.0 my-api
+```
+
 ### Options
 
 | Flag                | Description                                              |
@@ -44,7 +51,7 @@ During setup you can pick which integrations to scaffold. Core is always include
 | `cron`      | Cron jobs              |
 | `docker`    | Dockerfile + Compose     |
 
-Interactive mode (TTY) shows a toggle menu after the project name. Non-interactive runs use the full stack unless you pass flags.
+Interactive mode (TTY) shows a checkbox menu (↑↓ move, Space toggle, Enter confirm). Non-interactive runs use the full stack unless you pass flags.
 
 ### Examples
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "kavoru",
-  "version": "0.2.0",
+  "version": "0.4.0",
   "description": "Scaffold a new Kavoru (Elysia + Bun) backend from the official template",
   "type": "module",
   "bin": {

package/src/constants.ts

@@ -1,4 +1,6 @@
-export const PACKAGE_VERSION = "0.1.0";
+import pkg from "../package.json";
+
+export const PACKAGE_VERSION = pkg.version;
 
 export const TEMPLATE_REPO = "mertthesamael/Kavoru";
 export const TEMPLATE_BRANCH = "master";

package/src/features.ts

@@ -504,9 +504,14 @@ async function patchDockerfile(projectDir: string, selection: FeatureSelection)
   let content = current;
   if (!selection.prisma) {
     content = content.replace(/^\s*COPY prisma\.config\.ts \.\/.*\n/m, "");
-    content = content.replace(/^\s*ENV DATABASE_URL=\$\{DATABASE_URL\}\n/m, "");
-    content = content.replace(/^\s*RUN bunx prisma db pull\n/m, "");
-    content = content.replace(/^\s*RUN bunx prisma generate\n/m, "");
+    content = content.replace(
+      /^\s*# generate only needs the schema on disk, not a live database\n/m,
+      "",
+    );
+    content = content.replace(
+      /^\s*RUN if \[ -f src\/infra\/prisma\/schemas\/schema\.prisma \]; then bunx prisma generate; fi\n/m,
+      "",
+    );
   }
 
   await writeText(projectDir, relativePath, content);
@@ -525,19 +530,24 @@ function generateDockerCompose(selection: FeatureSelection): string {
   const kafkaService = selection.kafka
     ? `
   kafka:
-    image: bitnami/kafka:3.9
+    image: confluentinc/cp-kafka:7.6.1
+    hostname: kafka
     ports:
       - "9094:9094"
     environment:
-      KAFKA_CFG_NODE_ID: "0"
-      KAFKA_CFG_PROCESS_ROLES: controller,broker
-      KAFKA_CFG_LISTENERS: PLAINTEXT://:9092,CONTROLLER://:9093,EXTERNAL://:9094
-      KAFKA_CFG_ADVERTISED_LISTENERS: PLAINTEXT://kafka:9092,EXTERNAL://localhost:9094
-      KAFKA_CFG_LISTENER_SECURITY_PROTOCOL_MAP: CONTROLLER:PLAINTEXT,PLAINTEXT:PLAINTEXT,EXTERNAL:PLAINTEXT
-      KAFKA_CFG_CONTROLLER_QUORUM_VOTERS: 0@kafka:9093
-      KAFKA_CFG_CONTROLLER_LISTENER_NAMES: CONTROLLER
-      KAFKA_CFG_INTER_BROKER_LISTENER_NAME: PLAINTEXT
-      ALLOW_PLAINTEXT_LISTENER: "yes"
+      CLUSTER_ID: MkU3OEVBNTcwNTJENDM2Qk
+      KAFKA_NODE_ID: "0"
+      KAFKA_PROCESS_ROLES: broker,controller
+      KAFKA_LISTENERS: PLAINTEXT://:9092,CONTROLLER://:9093,EXTERNAL://:9094
+      KAFKA_ADVERTISED_LISTENERS: PLAINTEXT://kafka:9092,EXTERNAL://localhost:9094
+      KAFKA_LISTENER_SECURITY_PROTOCOL_MAP: CONTROLLER:PLAINTEXT,PLAINTEXT:PLAINTEXT,EXTERNAL:PLAINTEXT
+      KAFKA_CONTROLLER_QUORUM_VOTERS: 0@kafka:9093
+      KAFKA_CONTROLLER_LISTENER_NAMES: CONTROLLER
+      KAFKA_INTER_BROKER_LISTENER_NAME: PLAINTEXT
+      KAFKA_OFFSETS_TOPIC_REPLICATION_FACTOR: 1
+      KAFKA_TRANSACTION_STATE_LOG_MIN_ISR: 1
+      KAFKA_TRANSACTION_STATE_LOG_REPLICATION_FACTOR: 1
+      KAFKA_LOG_DIRS: /tmp/kraft-combined-logs
     networks:
       - app_network
     restart: unless-stopped
@@ -547,7 +557,7 @@ function generateDockerCompose(selection: FeatureSelection): string {
   const jaegerService = selection.otel
     ? `
   jaeger:
-    image: jaegertracing/all-in-one:1.62
+    image: jaegertracing/all-in-one:1.62.0
     ports:
       - "16686:16686"
       - "4318:4318"

package/src/prompts.ts

@@ -1,5 +1,4 @@
-import * as readline from "node:readline/promises";
-import { stdin as input, stdout as output } from "node:process";
+import { stdin, stdout } from "node:process";
 import {
   ALL_FEATURES,
   FEATURES,
@@ -9,70 +8,178 @@ import {
   formatFeatureSelection,
 } from "./features";
 
+const ESC = "\x1b";
+const dim = `${ESC}[2m`;
+const reset = `${ESC}[0m`;
+const cyan = `${ESC}[36m`;
+
 function cloneSelection(selection: FeatureSelection): FeatureSelection {
   return { ...selection };
 }
 
-function printFeatureMenu(selection: FeatureSelection) {
-  console.log();
-  console.log("Select optional features for your project:");
-  console.log(
-    "  Type a number to toggle · a = all · m = minimal · Enter = continue",
-  );
-  console.log();
+type KeyAction =
+  | "up"
+  | "down"
+  | "toggle"
+  | "confirm"
+  | "all"
+  | "minimal"
+  | "interrupt";
+
+const KEY_UP = ESC + "[A";
+const KEY_DOWN = ESC + "[B";
+const KEY_UP_ALT = ESC + "OA";
+const KEY_DOWN_ALT = ESC + "OB";
+
+function parseKeyInput(data: string): KeyAction | null {
+  if (data === "\u0003") return "interrupt";
+  if (data === "\r" || data === "\n") return "confirm";
+  if (data === " ") return "toggle";
+  if (data === "a" || data === "A") return "all";
+  if (data === "m" || data === "M") return "minimal";
+  if (data === KEY_UP || data === KEY_UP_ALT) return "up";
+  if (data === KEY_DOWN || data === KEY_DOWN_ALT) return "down";
+  return null;
+}
+
+function createKeyReader(onKey: (action: KeyAction) => void) {
+  let pending = "";
+
+  const onData = (chunk: string) => {
+    pending += chunk;
+
+    while (pending.length > 0) {
+      if (pending === ESC) return;
+
+      if (pending.startsWith(ESC)) {
+        if (pending.length < 3) return;
+
+        const action = parseKeyInput(pending.slice(0, 3));
+        if (action) {
+          pending = pending.slice(3);
+          onKey(action);
+          continue;
+        }
+
+        if (pending.startsWith(ESC + "O") && pending.length < 3) return;
+
+        pending = pending.slice(1);
+        continue;
+      }
+
+      const action = parseKeyInput(pending[0] ?? "");
+      pending = pending.slice(1);
+      if (action) onKey(action);
+    }
+  };
+
+  return onData;
+}
+
+function renderCheckboxMenu(
+  selection: FeatureSelection,
+  activeIndex: number,
+  lineCount: number,
+): number {
+  const lines: string[] = [
+    `${cyan}◆${reset} Select optional features ${dim}(↑↓ move · Space toggle · Enter confirm)${reset}`,
+    `${dim}  a = all · m = minimal${reset}`,
+    "",
+  ];
 
   FEATURES.forEach((feature, index) => {
-    const checked = selection[feature.id] ? "x" : " ";
-    console.log(
-      `  [${checked}] ${index + 1}. ${feature.label.padEnd(22)} ${feature.description}`,
+    const isActive = index === activeIndex;
+    const pointer = isActive ? `${cyan}❯${reset}` : " ";
+    const mark = selection[feature.id] ? "x" : " ";
+    const label = isActive ? `${cyan}${feature.label}${reset}` : feature.label;
+    lines.push(
+      ` ${pointer} [${mark}] ${label.padEnd(22)} ${dim}${feature.description}${reset}`,
     );
   });
 
-  console.log();
-  console.log(`  Selected: ${formatFeatureSelection(selection)}`);
-  console.log();
+  lines.push("", ` ${dim}Selected: ${formatFeatureSelection(selection)}${reset}`);
+
+  if (lineCount > 0) {
+    stdout.write(`${ESC}[${lineCount}A`);
+  }
+
+  for (const line of lines) {
+    stdout.write(`${ESC}[2K${ESC}[0G${line}\n`);
+  }
+
+  return lines.length;
+}
+
+function restoreTerminal(onData: (chunk: string) => void) {
+  stdin.off("data", onData);
+  if (stdin.isTTY) {
+    stdin.setRawMode(false);
+  }
+  stdin.pause();
+  stdout.write(`${ESC}[?25h`);
 }
 
 export async function promptFeatureSelection(
   initial: FeatureSelection = ALL_FEATURES,
 ): Promise<FeatureSelection> {
-  if (!process.stdin.isTTY || !process.stdout.isTTY) {
+  if (!stdin.isTTY || !stdout.isTTY) {
     return cloneSelection(initial);
   }
 
   const selection = cloneSelection(initial);
-  const rl = readline.createInterface({ input, output });
+  let activeIndex = 0;
+  let lineCount = 0;
 
-  try {
-    while (true) {
-      printFeatureMenu(selection);
-      const answer = (await rl.question("Toggle feature: ")).trim().toLowerCase();
+  stdout.write(`${ESC}[?25l`);
 
-      if (!answer) {
-        return selection;
-      }
-
-      if (answer === "a" || answer === "all") {
-        Object.assign(selection, ALL_FEATURES);
-        continue;
-      }
+  if (stdin.isTTY) {
+    stdin.setRawMode(true);
+  }
+  stdin.resume();
+  stdin.setEncoding("utf8");
 
-      if (answer === "m" || answer === "minimal") {
-        Object.assign(selection, MINIMAL_FEATURES);
-        continue;
+  return new Promise((resolve, reject) => {
+    const onKey = (action: KeyAction) => {
+      switch (action) {
+        case "up":
+          activeIndex =
+            (activeIndex - 1 + FEATURES.length) % FEATURES.length;
+          lineCount = renderCheckboxMenu(selection, activeIndex, lineCount);
+          break;
+        case "down":
+          activeIndex = (activeIndex + 1) % FEATURES.length;
+          lineCount = renderCheckboxMenu(selection, activeIndex, lineCount);
+          break;
+        case "toggle": {
+          const feature = FEATURES[activeIndex];
+          if (!feature) break;
+          selection[feature.id as FeatureId] = !selection[feature.id as FeatureId];
+          lineCount = renderCheckboxMenu(selection, activeIndex, lineCount);
+          break;
+        }
+        case "all":
+          Object.assign(selection, ALL_FEATURES);
+          lineCount = renderCheckboxMenu(selection, activeIndex, lineCount);
+          break;
+        case "minimal":
+          Object.assign(selection, MINIMAL_FEATURES);
+          lineCount = renderCheckboxMenu(selection, activeIndex, lineCount);
+          break;
+        case "confirm":
+          restoreTerminal(onData);
+          stdout.write("\n");
+          resolve(selection);
+          break;
+        case "interrupt":
+          restoreTerminal(onData);
+          stdout.write("\n");
+          reject(new Error("Feature selection cancelled."));
+          break;
       }
+    };
 
-      const index = Number.parseInt(answer, 10);
-      if (Number.isNaN(index) || index < 1 || index > FEATURES.length) {
-        console.log("Enter a number between 1 and 9, a, m, or press Enter.");
-        continue;
-      }
-
-      const feature = FEATURES[index - 1];
-      if (!feature) continue;
-      selection[feature.id as FeatureId] = !selection[feature.id as FeatureId];
-    }
-  } finally {
-    rl.close();
-  }
+    const onData = createKeyReader(onKey);
+    stdin.on("data", onData);
+    lineCount = renderCheckboxMenu(selection, activeIndex, 0);
+  });
 }