kavoru 0.3.0 → 0.5.0

package/README.md

@@ -7,12 +7,24 @@ Scaffold a new [Kavoru](https://github.com/mertthesamael/Kavoru) backend — Ely
 After publishing to npm:
 
 ```bash
-bunx kavoru my-api
+bunx kavoru@latest my-api
 cd my-api
 bun run dev
 ```
 
-Equivalent to `bunx --bun kavoru` (Bun runs the `kavoru` binary from the npm package).
+Always use `@latest` so you get the newest published CLI. Equivalent to `bunx --bun kavoru@latest`.
+
+**Stale CLI after a new publish?** Bun caches `bunx` installs under `%TEMP%\bunx-*-kavoru@latest` and does not auto-refresh. Clear the cache, then run `@latest` again:
+
+```powershell
+Remove-Item -Recurse -Force "$env:TEMP\bunx-*-kavoru*"
+bunx kavoru@latest my-api
+```
+
+```bash
+rm -rf "${TMPDIR:-/tmp}"/bunx-*-kavoru*
+bunx kavoru@latest my-api
+```
 
 ### Options
 
@@ -50,22 +62,22 @@ Interactive mode (TTY) shows a checkbox menu (↑↓ move, Space toggle, Enter c
 
 ```bash
 # Interactive (prompts for project name + feature toggles)
-bunx kavoru
+bunx kavoru@latest
 
 # Current directory
-bunx kavoru .
+bunx kavoru@latest .
 
 # Minimal API skeleton
-bunx kavoru my-api --minimal
+bunx kavoru@latest my-api --minimal
 
 # Pick specific features
-bunx kavoru my-api --features auth,prisma,otel,sentry
+bunx kavoru@latest my-api --features auth,prisma,otel,sentry
 
 # Full stack minus Kafka and Docker
-bunx kavoru my-api --no-features kafka,docker
+bunx kavoru@latest my-api --no-features kafka,docker
 
 # Custom template fork (local dev)
-bunx kavoru demo --repo your-user/Kavoru --no-install
+bunx kavoru@latest demo --repo your-user/Kavoru --no-install
 ```
 
 ## Development
@@ -79,7 +91,7 @@ bun test
 bun run src/index.ts my-test-app
 # or
 bun link
-bunx kavoru my-test-app
+bunx kavoru@latest my-test-app
 ```
 
 ## License

package/package.json

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

package/src/args.ts

@@ -36,10 +36,10 @@ Features:
   auth, prisma, otel, sentry, kafka, websocket, resend, cron, docker
 
 Examples:
-  bunx kavoru my-api
-  bunx kavoru my-api --minimal
-  bunx kavoru my-api --features auth,prisma,otel
-  bunx kavoru my-api --no-features kafka,docker,resend
+  bunx kavoru@latest my-api
+  bunx kavoru@latest my-api --minimal
+  bunx kavoru@latest my-api --features auth,prisma,otel
+  bunx kavoru@latest my-api --no-features kafka,docker,resend
 `;
 
 export function parseArgs(argv: string[]): CliOptions {

package/src/cli.ts

@@ -97,7 +97,7 @@ export async function runCli(options: CliOptions): Promise<void> {
   if (!targetArg) {
     const interactive = process.stdin.isTTY && process.stdout.isTTY;
     if (!interactive) {
-      throw new Error("Missing project directory. Usage: bunx kavoru <directory>");
+      throw new Error("Missing project directory. Usage: bunx kavoru@latest <directory>");
     }
     targetArg = await promptProjectName();
   }

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,40 +504,60 @@ 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);
 }
 
+function buildAppEnvironment(selection: FeatureSelection): string {
+  const lines = ["      NODE_ENV: production"];
+  if (selection.kafka) {
+    lines.push("      KAFKA_BROKERS: kafka:9092");
+  }
+  if (selection.otel) {
+    lines.push("      OTEL_EXPORTER_OTLP_ENDPOINT: http://jaeger:4318/v1/traces");
+  }
+  return `    environment:\n${lines.join("\n")}\n`;
+}
+
 function generateDockerCompose(selection: FeatureSelection): string {
   const appDependsOn = selection.kafka
     ? `    depends_on:
       kafka:
         condition: service_started
-    environment:
-      KAFKA_BROKERS: kafka:9092
 `
     : "";
+  const appEnvironment = buildAppEnvironment(selection);
 
   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 +567,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"
@@ -580,7 +600,7 @@ function generateDockerCompose(selection: FeatureSelection): string {
     restart: unless-stopped
     env_file:
       - .env
-${appDependsOn}    healthcheck:
+${appDependsOn}${appEnvironment}    healthcheck:
       test: ["CMD", "curl", "-f", "http://localhost:\${PORT}/healthz"]
       interval: 600s
       timeout: 300s
@@ -589,10 +609,7 @@ ${appDependsOn}    healthcheck:
 ${kafkaService}${jaegerService}
 networks:
   app_network:
-    name: app_network
     driver: bridge
-
-version: "3.8"
 `;
 }