kavoru 0.4.0 → 0.5.0

package/README.md

@@ -7,18 +7,23 @@ 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 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:
+**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@0.3.0 my-api
+bunx kavoru@latest my-api
+```
+
+```bash
+rm -rf "${TMPDIR:-/tmp}"/bunx-*-kavoru*
+bunx kavoru@latest my-api
 ```
 
 ### Options
@@ -57,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
@@ -86,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.4.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/features.ts

@@ -517,15 +517,25 @@ async function patchDockerfile(projectDir: string, selection: FeatureSelection)
   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
     ? `
@@ -590,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
@@ -599,10 +609,7 @@ ${appDependsOn}    healthcheck:
 ${kafkaService}${jaegerService}
 networks:
   app_network:
-    name: app_network
     driver: bridge
-
-version: "3.8"
 `;
 }