kavoru 0.7.1 → 0.8.8

package/package.json

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

package/src/features.ts

@@ -108,7 +108,7 @@ const FEATURE_PATHS: Record<FeatureId, string[]> = {
   ],
   resend: ["src/infra/resend"],
   cron: ["src/schedules"],
-  docker: ["Dockerfile", "docker-compose.yaml", "docker/otel.Dockerfile"],
+  docker: ["docker-compose.yaml", "docker"],
 };
 
 const FEATURE_DEPENDENCIES: Partial<
@@ -510,7 +510,7 @@ async function patchEnvExample(
 async function patchDockerfile(projectDir: string, selection: FeatureSelection) {
   if (!selection.docker) return;
 
-  const relativePath = "Dockerfile";
+  const relativePath = "docker/app/Dockerfile";
   const current = await readText(projectDir, relativePath);
   if (!current) return;
 
@@ -530,19 +530,43 @@ async function patchDockerfile(projectDir: string, selection: FeatureSelection)
   await writeText(projectDir, relativePath, content);
 }
 
-function buildAppEnvironment(selection: FeatureSelection): string {
-  const lines = ["      NODE_ENV: production"];
+const DOCKER_KAFKA_ENV = `# KRaft broker config (Confluent cp-kafka 7.6.1)
+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
+`;
+
+const DOCKER_OTEL_ENV =
+  "# otel-dev runs with CLI flags in Dockerfile; add overrides here if needed.\n";
+
+const DOCKER_SPOTLIGHT_ENV =
+  "# Official Spotlight image; add overrides here if needed.\n";
+
+function buildDockerAppEnv(selection: FeatureSelection): string {
+  const lines = [
+    "# Docker-only overrides (loaded after root .env)",
+    "NODE_ENV=production",
+  ];
   if (selection.kafka) {
-    lines.push("      KAFKA_BROKERS: kafka:9092");
+    lines.push("KAFKA_BROKERS=kafka:9092");
   }
   if (selection.otel) {
-    lines.push("      OTEL_EXPORTER_OTLP_ENDPOINT: http://otel:4318/v1/traces");
-    lines.push("      OTEL_SERVICE_NAME: ${OTEL_SERVICE_NAME:-kavoru}");
+    lines.push("OTEL_EXPORTER_OTLP_ENDPOINT=http://otel:4318/v1/traces");
   }
   if (selection.sentry) {
-    lines.push("      SENTRY_SPOTLIGHT: http://spotlight:8969/stream");
+    lines.push("SENTRY_SPOTLIGHT=http://spotlight:8969/stream");
   }
-  return `    environment:\n${lines.join("\n")}\n`;
+  return `${lines.join("\n")}\n`;
 }
 
 function generateDockerCompose(selection: FeatureSelection): string {
@@ -552,29 +576,17 @@ function generateDockerCompose(selection: FeatureSelection): string {
         condition: service_started
 `
     : "";
-  const appEnvironment = buildAppEnvironment(selection);
 
   const kafkaService = selection.kafka
     ? `
   kafka:
-    image: confluentinc/cp-kafka:7.6.1
+    build:
+      context: docker/kafka
     hostname: kafka
     ports:
       - "9094:9094"
-    environment:
-      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
+    env_file:
+      - docker/kafka/.env
     networks:
       - app_network
     restart: unless-stopped
@@ -585,10 +597,11 @@ function generateDockerCompose(selection: FeatureSelection): string {
     ? `
   otel:
     build:
-      context: .
-      dockerfile: docker/otel.Dockerfile
+      context: docker/otel
     ports:
       - "4318:4318"
+    env_file:
+      - docker/otel/.env
     networks:
       - app_network
     restart: unless-stopped
@@ -598,9 +611,12 @@ function generateDockerCompose(selection: FeatureSelection): string {
   const spotlightService = selection.sentry
     ? `
   spotlight:
-    image: ghcr.io/getsentry/spotlight:latest
+    build:
+      context: docker/spotlight
     ports:
       - "8969:8969"
+    env_file:
+      - docker/spotlight/.env
     networks:
       - app_network
     restart: unless-stopped
@@ -611,6 +627,7 @@ function generateDockerCompose(selection: FeatureSelection): string {
   app:
     build:
       context: .
+      dockerfile: docker/app/Dockerfile
       target: build
       args:
         PORT: \${PORT:-3131}
@@ -628,7 +645,8 @@ function generateDockerCompose(selection: FeatureSelection): string {
     restart: unless-stopped
     env_file:
       - .env
-${appDependsOn}${appEnvironment}    healthcheck:
+      - docker/app/.env
+${appDependsOn}    healthcheck:
       test: ["CMD", "curl", "-f", "http://localhost:\${PORT}/healthz"]
       interval: 600s
       timeout: 300s
@@ -646,6 +664,31 @@ async function patchDockerCompose(
   selection: FeatureSelection,
 ) {
   if (!selection.docker) return;
+
+  if (!selection.kafka) {
+    await removePaths(projectDir, ["docker/kafka"]);
+  }
+  if (!selection.otel) {
+    await removePaths(projectDir, ["docker/otel"]);
+  }
+  if (!selection.sentry) {
+    await removePaths(projectDir, ["docker/spotlight"]);
+  }
+
+  await writeText(
+    projectDir,
+    "docker/app/.env",
+    buildDockerAppEnv(selection),
+  );
+  if (selection.kafka) {
+    await writeText(projectDir, "docker/kafka/.env", DOCKER_KAFKA_ENV);
+  }
+  if (selection.otel) {
+    await writeText(projectDir, "docker/otel/.env", DOCKER_OTEL_ENV);
+  }
+  if (selection.sentry) {
+    await writeText(projectDir, "docker/spotlight/.env", DOCKER_SPOTLIGHT_ENV);
+  }
   await writeText(projectDir, "docker-compose.yaml", generateDockerCompose(selection));
 }