kavoru 0.9.7 → 0.9.9

package/README.md

@@ -38,7 +38,7 @@ bunx kavoru@latest my-api
 | `--no-install`      | Skip `bun install`                                       |
 | `--repo owner/name` | Override template repo (default: `mertthesamael/Kavoru`) |
 | `--branch name`     | Template branch (default: `master`)                      |
-| `--minimal`         | Core only — health, OpenAPI, response envelope           |
+| `--minimal`         | Optional integrations off (Docker Compose + Project CLI always included) |
 | `--features list`   | Comma-separated features to include                      |
 | `--no-features list`| Comma-separated features to exclude (default: all on)    |
 

package/package.json

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

package/src/args.ts

@@ -32,7 +32,7 @@ Options:
   --no-install       Skip "bun install" after scaffolding
   --repo <owner/name>  GitHub template repo (default: mertthesamael/Kavoru)
   --branch <name>    Template branch (default: master)
-  --minimal          Core only (health, OpenAPI, response envelope)
+  --minimal          Core optional integrations only (Docker + Project CLI always included)
   --features <list>  Comma-separated features to include (default: all)
   --no-features <list>  Comma-separated features to exclude
 

package/src/features.ts

@@ -17,6 +17,19 @@ export type FeatureId =
 /** Always scaffolded — not a CLI toggle. */
 export const ALWAYS_INCLUDED = ["docker", "cli"] as const;
 
+export const MANDATORY_FEATURE_DEFS = [
+  {
+    id: "docker",
+    label: "Docker Compose",
+    description: "docker-compose.yaml + app image",
+  },
+  {
+    id: "cli",
+    label: "Project CLI",
+    description: "kavoru module command, bin, shims",
+  },
+] as const;
+
 const FEATURE_ALIASES: Record<string, FeatureId> = {
   prisma: "postgres",
 };
@@ -288,9 +301,12 @@ export function parseFeatureExcludeList(
 }
 
 export function formatFeatureSelection(selection: FeatureSelection): string {
+  const mandatory = ALWAYS_INCLUDED.join(", ");
   const enabled = enabledFeatures(selection);
-  if (enabled.length === 0) return "core only";
-  return enabled.join(", ");
+  if (enabled.length === 0) {
+    return `${mandatory} · optional: none`;
+  }
+  return `${mandatory} · optional: ${enabled.join(", ")}`;
 }
 
 async function removePaths(projectDir: string, relativePaths: string[]) {
@@ -479,41 +495,73 @@ async function patchEntryIndex(
   await writeText(projectDir, "src/index.ts", buildEntryIndex(selection));
 }
 
-async function patchServerIndex(
-  projectDir: string,
-  selection: FeatureSelection,
-) {
-  const relativePath = "src/server/index.ts";
-  const current = await readText(projectDir, relativePath);
-  if (!current) return;
+export function buildServerIndex(selection: FeatureSelection): string {
+  const imports = [
+    'import { Elysia } from "elysia";',
+    'import { config } from "../config/index";',
+    'import { logger } from "../common/logger";',
+    'import { registerModules } from "../modules";',
+    selection.cron ? 'import { schedules } from "../schedules";' : null,
+  ]
+    .filter(Boolean)
+    .join("\n");
 
-  let content = current;
+  const elysiaCtor = selection.websocket
+    ? `new Elysia({
+      websocket: {
+        idleTimeout: 120,
+      },
+    })`
+    : "new Elysia()";
+
+  const uses = [
+    "      .use(registerModules)",
+    selection.cron ? "      .use(schedules)" : null,
+  ]
+    .filter(Boolean)
+    .join("\n");
 
-  if (selection.cron) {
-    content = content.replace(
-      /\/\/import \{ schedules \} from "\.\.\/schedules";.*\n/,
-      'import { schedules } from "../schedules";\n',
-    );
-    content = content.replace(
-      /\/\/\.use\(schedules\);.*\n/,
-      "    .use(schedules);\n",
-    );
-  } else {
-    content = content.replace(
-      /^import \{ schedules \} from "\.\.\/schedules";\n/m,
-      "",
-    );
-    content = content.replace(/^\s*\.use\(schedules\);\n/m, "");
+  return `${imports}
+
+export class HttpServer {
+  private app: any;
+  private server?: ReturnType<Elysia["listen"]>;
+
+  constructor() {
+    this.app = ${elysiaCtor}
+${uses};
   }
 
-  if (!selection.websocket) {
-    content = content.replace(
-      /new Elysia\(\{\s*websocket:\s*\{\s*idleTimeout:\s*120,\s*\},\s*\}\)/,
-      "new Elysia()",
-    );
+  async start() {
+    if (this.server) return;
+
+    await this.app.modules;
+
+    this.server = this.app.listen(config.env.server.port, () => {
+      logger.info(
+        \`API ready on port \${config.env.server.port}. Version: \${config.version}\`,
+      );
+    });
   }
 
-  await writeText(projectDir, relativePath, content);
+  async stop() {
+    if (!this.server) return;
+    this.server.stop();
+    this.server = undefined;
+  }
+}
+`;
+}
+
+async function patchServerIndex(
+  projectDir: string,
+  selection: FeatureSelection,
+) {
+  await writeText(
+    projectDir,
+    "src/server/index.ts",
+    buildServerIndex(selection),
+  );
 }
 
 async function patchPackageJson(

package/src/prompts.ts

@@ -2,6 +2,7 @@ import { stdin, stdout } from "node:process";
 import {
   ALL_FEATURES,
   FEATURES,
+  MANDATORY_FEATURE_DEFS,
   MINIMAL_FEATURES,
   normalizeFeatureSelection,
   type FeatureId,
@@ -84,10 +85,19 @@ function renderCheckboxMenu(
 ): number {
   const lines: string[] = [
     `${cyan}◆${reset} Select optional features ${dim}(↑↓ move · Space toggle · Enter confirm)${reset}`,
-    `${dim}  a = all · m = minimal${reset}`,
+    `${dim}  a = all · m = minimal optional only${reset}`,
     "",
+    `${dim}Always included:${reset}`,
   ];
 
+  for (const feature of MANDATORY_FEATURE_DEFS) {
+    lines.push(
+      `   [x] ${feature.label.padEnd(22)} ${dim}${feature.description}${reset}`,
+    );
+  }
+
+  lines.push("", `${dim}Optional:${reset}`);
+
   FEATURES.forEach((feature, index) => {
     const isActive = index === activeIndex;
     const pointer = isActive ? `${cyan}❯${reset}` : " ";