@tdk-landscape/tdk-cli-core 1.3.76 → 1.3.77

package/examples/tdk-example/TILT_SERVICE_DEFAULTS.star

@@ -0,0 +1,42 @@
+# =============================================================================
+# TILT_SERVICE_DEFAULTS.star - Platform Runtime Configuration
+# =============================================================================
+
+BASE_PORT_FRONTEND = 3000
+BASE_PORT_BACKEND = 4000
+
+HEALTH_CHECK_PATH = "/health"
+HEALTH_CHECK_PATH_LIVE = "/health/live"
+HEALTH_CHECK_PATH_READY = "/health/ready"
+HEALTH_CHECK_INTERVAL = 10
+HEALTH_CHECK_TIMEOUT = 5
+HEALTH_CHECK_RETRIES = 3
+
+MEMORY_LIMITS = {
+    "frontend": 512,
+    "backend": 1024,
+    "worker": 768,
+    "infra": 256,
+}
+
+DOCKER_BASE_IMAGES = {
+    "bun": "oven/bun:1.2",
+    "node": "node:20-alpine",
+    "nginx": "nginx:alpine",
+}
+
+NETWORK_PREFIX = "tdk"
+
+exports = {
+    "BASE_PORT_FRONTEND": BASE_PORT_FRONTEND,
+    "BASE_PORT_BACKEND": BASE_PORT_BACKEND,
+    "HEALTH_CHECK_PATH": HEALTH_CHECK_PATH,
+    "HEALTH_CHECK_PATH_LIVE": HEALTH_CHECK_PATH_LIVE,
+    "HEALTH_CHECK_PATH_READY": HEALTH_CHECK_PATH_READY,
+    "HEALTH_CHECK_INTERVAL": HEALTH_CHECK_INTERVAL,
+    "HEALTH_CHECK_TIMEOUT": HEALTH_CHECK_TIMEOUT,
+    "HEALTH_CHECK_RETRIES": HEALTH_CHECK_RETRIES,
+    "MEMORY_LIMITS": MEMORY_LIMITS,
+    "DOCKER_BASE_IMAGES": DOCKER_BASE_IMAGES,
+    "NETWORK_PREFIX": NETWORK_PREFIX,
+}

package/examples/tdk-example/TILT_TECH_STACK.star

@@ -0,0 +1,67 @@
+# =============================================================================
+# TILT_TECH_STACK.star - Technology Stack Configuration
+# =============================================================================
+
+RUNTIME = "bun"
+RUNTIME_VERSION = "1.2"
+
+BUNDLER = "vite"
+BUNDLER_VERSION = "5"
+
+ORM = "prisma"
+ORM_VERSION = "7"
+
+MESSAGING = "nats"
+MESSAGING_VERSION = "2"
+NATS_SERVER = "nats://nats:4222"
+
+TESTING = "vitest"
+TESTING_VERSION = "1"
+
+LINTING = "biome"
+LINTING_VERSION = "1.5"
+
+WEB_FRAMEWORK = "hono"
+WEB_FRAMEWORK_VERSION = "4"
+
+CONTAINER_PLATFORM = "docker"
+COMPOSE_VERSION = "3.8"
+
+def assert_tech_stack(loaded_stack):
+    required = {
+        "bundler": BUNDLER,
+        "runtime": RUNTIME,
+    }
+
+    for key, expected in required.items():
+        actual = loaded_stack.get(key)
+        if actual != expected:
+            fail("Tech stack mismatch: {} should be '{}' but got '{}'".format(
+                key, expected, actual
+            ))
+
+    print("✅ Tech stack validated: {} / {} / {}".format(
+        BUNDLER, RUNTIME, TESTING
+    ))
+
+exports = {
+    "RUNTIME": RUNTIME,
+    "RUNTIME_VERSION": RUNTIME_VERSION,
+    "BUNDLER": BUNDLER,
+    "BUNDLER_VERSION": BUNDLER_VERSION,
+    "ORM": ORM,
+    "ORM_VERSION": ORM_VERSION,
+    "MESSAGING": MESSAGING,
+    "MESSAGING_VERSION": MESSAGING_VERSION,
+    "NATS_SERVER": NATS_SERVER,
+    "TESTING": TESTING,
+    "TESTING_VERSION": TESTING_VERSION,
+    "LINTING": LINTING,
+    "LINTING_VERSION": LINTING_VERSION,
+    "WEB_FRAMEWORK": WEB_FRAMEWORK,
+    "WEB_FRAMEWORK_VERSION": WEB_FRAMEWORK_VERSION,
+    "CONTAINER_PLATFORM": CONTAINER_PLATFORM,
+    "COMPOSE_VERSION": COMPOSE_VERSION,
+    "assert_tech_stack": assert_tech_stack,
+    "TECH_STACK": exports,
+}

package/examples/tdk-example/Tiltfile

@@ -0,0 +1,25 @@
+# TDK Example Tiltfile
+# Minimal Tiltfile demonstrating TDK PSR model
+
+# Must be set before the extension loads: discovery/constants.star reads it to
+# find this project's spec.master (services/identity, services/appointment)
+# instead of falling back to the beauty-crm monorepo's default scan roots.
+os.environ['TDK_PROJECT_ROOT'] = config.main_dir
+
+# Load TDK extension
+v1alpha1.extension_repo(name='tdk-cli', url='https://github.com/tdk-landscape/tdk-cli')
+v1alpha1.extension(name='tdk-cli', repo_name='tdk-cli', repo_path='')
+
+# Load TDK utilities
+load('ext://tdk-cli', 'Utils', 'Manifest', 'Config')
+
+print("🚀 TDK Example Project")
+print("   Project → Stack → Resource")
+print("")
+
+# Default to all services if no args
+config.define_string_list("to-run", args=True)
+cfg = config.parse()
+
+# Let TDK handle service discovery and registration
+# Services are discovered from service.json files automatically

package/examples/tdk-example/services/platform/messaging/docker-compose.yml

@@ -0,0 +1,26 @@
+services:
+  nats:
+    image: nats:2.10-alpine
+    container_name: tdk_example_nats
+    command: ["--jetstream", "--store_dir=/data/jetstream", "--http_port", "8222"]
+    restart: unless-stopped
+    networks:
+      tdk_example_backend:
+        aliases:
+          - tdk_example_nats
+    volumes:
+      - tdk_example_nats_data:/data
+    healthcheck:
+      test: ["CMD", "wget", "-qO-", "http://127.0.0.1:8222/healthz"]
+      interval: 5s
+      timeout: 3s
+      start_period: 5s
+      retries: 20
+
+networks:
+  tdk_example_backend:
+    external: true
+    name: tdk_example_backend
+
+volumes:
+  tdk_example_nats_data:

package/examples/tdk-example/services/shop/orders-api/package.json

@@ -0,0 +1,20 @@
+{
+  "name": "orders-api",
+  "private": true,
+  "type": "module",
+  "scripts": {
+    "build": "bun build src/index.ts --outdir dist --target bun --packages external",
+    "start": "bun run dist/index.js",
+    "dev": "bun --watch src/index.ts"
+  },
+  "dependencies": {
+    "@hono/node-server": "^1.19.0",
+    "hono": "^4.9.0",
+    "nats": "^2.29.3",
+    "pg": "^8.16.3"
+  },
+  "devDependencies": {
+    "@types/node": "^20.0.0",
+    "@types/pg": "^8.15.5"
+  }
+}

package/examples/tdk-example/services/shop/orders-api/service.json

@@ -0,0 +1,14 @@
+{
+  "$schema": "https://tdk-landscape.github.io/schema.service.json",
+  "schemaVersion": 1,
+  "appName": "orders-api",
+  "appType": "backend",
+  "stack": "shop",
+  "port": 4000,
+  "featuresEnabled": ["nats"],
+  "params": {
+    "NATS_URL": "nats://tdk_example_nats:4222"
+  },
+  "healthCheckPath": "/health",
+  "dependsOn": []
+}

package/examples/tdk-example/services/shop/orders-api/src/index.ts

@@ -0,0 +1,81 @@
+import { serve } from "@hono/node-server";
+import { connect, type NatsConnection } from "nats";
+import { Hono } from "hono";
+import { Pool } from "pg";
+
+const port = Number(process.env.PORT ?? 4000);
+const databaseUrl = process.env.DATABASE_URL;
+const natsUrl = process.env.NATS_URL ?? "nats://tdk_example_nats:4222";
+if (!databaseUrl) throw new Error("DATABASE_URL is required");
+
+const pgUrl = new URL(databaseUrl);
+pgUrl.searchParams.delete("schema");
+const db = new Pool({ connectionString: pgUrl.toString() });
+let nats: NatsConnection;
+let workerReady = false;
+
+async function connectDependencies(): Promise<void> {
+  while (true) {
+    try {
+      await db.query(`
+        CREATE TABLE IF NOT EXISTS demo_orders (
+          id bigserial PRIMARY KEY,
+          item text NOT NULL,
+          created_at timestamptz NOT NULL DEFAULT now(),
+          worker_seen_at timestamptz
+        )
+      `);
+      nats = await connect({ servers: natsUrl });
+      return;
+    } catch (error) {
+      console.error("waiting for PostgreSQL and NATS", error);
+      await new Promise((resolve) => setTimeout(resolve, 1500));
+    }
+  }
+}
+
+const app = new Hono();
+app.use("*", async (c, next) => {
+  c.header("Access-Control-Allow-Origin", "*");
+  c.header("Access-Control-Allow-Headers", "content-type");
+  c.header("Access-Control-Allow-Methods", "GET,POST,OPTIONS");
+  await next();
+});
+app.options("*", (c) => c.body(null, 204));
+app.get("/health", (c) => c.json({ ok: true }));
+app.get("/worker-ready", (c) => c.json({ ready: workerReady }, workerReady ? 200 : 503));
+app.get("/", async (c) => {
+  const result = await db.query("SELECT id, item, created_at AS \"createdAt\", worker_seen_at AS \"workerSeenAt\" FROM demo_orders ORDER BY id DESC LIMIT 20");
+  return c.json({ orders: result.rows });
+});
+app.post("/", async (c) => {
+  if (!workerReady) return c.json({ error: "orders worker is not ready" }, 503);
+  const body = await c.req.json<{ item?: unknown }>();
+  if (typeof body.item !== "string" || body.item.trim().length === 0) {
+    return c.json({ error: "item is required" }, 400);
+  }
+  const result = await db.query(
+    "INSERT INTO demo_orders (item) VALUES ($1) RETURNING id, item, created_at AS \"createdAt\", worker_seen_at AS \"workerSeenAt\"",
+    [body.item.trim()],
+  );
+  const order = result.rows[0];
+  nats.publish("demo.orders.created", new TextEncoder().encode(String(order.id)));
+  return c.json({ order }, 201);
+});
+app.get("/:id", async (c) => {
+  const result = await db.query(
+    "SELECT id, item, created_at AS \"createdAt\", worker_seen_at AS \"workerSeenAt\" FROM demo_orders WHERE id = $1",
+    [c.req.param("id")],
+  );
+  if (!result.rows[0]) return c.json({ error: "order not found" }, 404);
+  return c.json({ order: result.rows[0] });
+});
+
+await connectDependencies();
+const readySubscription = nats.subscribe("demo.orders.worker-ready");
+await nats.flush();
+void (async () => {
+  for await (const _message of readySubscription) workerReady = true;
+})();
+serve({ fetch: app.fetch, port });
+console.log(`orders-api listening on ${port}`);

package/examples/tdk-example/services/shop/orders-app/index.html

@@ -0,0 +1,12 @@
+<!doctype html>
+<html lang="en">
+  <head>
+    <meta charset="UTF-8" />
+    <meta name="viewport" content="width=device-width, initial-scale=1.0" />
+    <title>TDK Orders</title>
+  </head>
+  <body>
+    <div id="root"></div>
+    <script type="module" src="/src/main.tsx"></script>
+  </body>
+</html>

package/examples/tdk-example/services/shop/orders-app/package.json

@@ -0,0 +1,20 @@
+{
+  "name": "orders-app",
+  "private": true,
+  "type": "module",
+  "scripts": {
+    "build": "vite build",
+    "dev": "vite --host 0.0.0.0"
+  },
+  "dependencies": {
+    "@vitejs/plugin-react": "^5.0.4",
+    "vite": "^7.1.7",
+    "react": "^19.1.1",
+    "react-dom": "^19.1.1"
+  },
+  "devDependencies": {
+    "@types/react": "^19.1.16",
+    "@types/react-dom": "^19.1.9",
+    "typescript": "^5.9.2"
+  }
+}

package/examples/tdk-example/services/shop/orders-app/service.json

@@ -0,0 +1,9 @@
+{
+  "$schema": "https://tdk-landscape.github.io/schema.service.json",
+  "schemaVersion": 1,
+  "appName": "orders-app",
+  "appType": "frontend",
+  "stack": "shop",
+  "port": 3000,
+  "dependsOn": ["orders-api"]
+}

package/examples/tdk-example/services/shop/orders-app/src/main.tsx

@@ -0,0 +1,9 @@
+import React from "react";
+import { createRoot } from "react-dom/client";
+import { App } from "./orders.js";
+
+createRoot(document.getElementById("root")!).render(
+  <React.StrictMode>
+    <App />
+  </React.StrictMode>,
+);

package/examples/tdk-example/services/shop/orders-app/src/orders.tsx

@@ -0,0 +1,67 @@
+import { useEffect, useState } from "react";
+import "./style.css";
+
+type Order = { id: number; item: string; workerSeenAt: string | null };
+const api = `${window.location.protocol}//api.${window.location.hostname.replace(/^app\./, "")}/api/orders`;
+
+export function App() {
+  const [item, setItem] = useState("coffee");
+  const [orders, setOrders] = useState<Order[]>([]);
+  const [message, setMessage] = useState("Loading orders…");
+
+  async function refresh() {
+    try {
+      const response = await fetch(api);
+      const data = (await response.json()) as { orders: Order[] };
+      setOrders(data.orders);
+      setMessage("API and database are connected");
+    } catch {
+      setMessage("Waiting for the orders API");
+    }
+  }
+
+  useEffect(() => {
+    void refresh();
+    const timer = window.setInterval(() => void refresh(), 1500);
+    return () => window.clearInterval(timer);
+  }, []);
+
+  async function createOrder(event: React.FormEvent) {
+    event.preventDefault();
+    const response = await fetch(api, {
+      method: "POST",
+      headers: { "content-type": "application/json" },
+      body: JSON.stringify({ item }),
+    });
+    if (!response.ok) {
+      setMessage(`Could not create order (${response.status})`);
+      return;
+    }
+    setMessage("Order saved; waiting for NATS worker observation…");
+    await refresh();
+  }
+
+  return (
+    <main>
+      <p className="eyebrow">TDK · Hono · PostgreSQL · NATS · Vite · Traefik</p>
+      <h1>Order desk</h1>
+      <p className="status">{message}</p>
+      <form onSubmit={createOrder}>
+        <label htmlFor="item">What should the worker process?</label>
+        <div className="row">
+          <input id="item" value={item} onChange={(event) => setItem(event.target.value)} />
+          <button type="submit">Create order</button>
+        </div>
+      </form>
+      <h2>Persisted orders</h2>
+      <ul>
+        {orders.map((order) => (
+          <li key={order.id}>
+            <span>#{order.id} · {order.item}</span>
+            <strong>{order.workerSeenAt ? "Worker observed" : "Queued"}</strong>
+          </li>
+        ))}
+      </ul>
+    </main>
+  );
+}

package/examples/tdk-example/services/shop/orders-app/src/style.css

@@ -0,0 +1,15 @@
+:root { font-family: Inter, ui-sans-serif, system-ui, sans-serif; color: #13231e; background: #edf2ee; }
+* { box-sizing: border-box; }
+body { margin: 0; min-width: 320px; }
+main { width: min(720px, calc(100% - 32px)); margin: 12vh auto; padding: 40px; background: white; border: 1px solid #d8e1dc; border-radius: 18px; box-shadow: 0 20px 60px #163c2512; }
+.eyebrow { color: #537363; font-size: 12px; font-weight: 700; letter-spacing: .09em; text-transform: uppercase; }
+h1 { margin: 12px 0; font-size: clamp(38px, 8vw, 64px); letter-spacing: -.06em; }
+.status { color: #587064; }
+label { display: block; margin: 28px 0 8px; font-weight: 650; }
+.row { display: flex; gap: 10px; }
+input { min-width: 0; flex: 1; padding: 12px 14px; border: 1px solid #cad7cf; border-radius: 8px; font: inherit; }
+button { padding: 12px 18px; border: 0; border-radius: 8px; color: white; background: #176447; font: inherit; font-weight: 700; cursor: pointer; }
+h2 { margin-top: 34px; font-size: 18px; }
+ul { display: grid; gap: 8px; padding: 0; list-style: none; }
+li { display: flex; justify-content: space-between; gap: 12px; padding: 12px; background: #f4f7f4; border-radius: 8px; }
+li strong { color: #176447; }

package/examples/tdk-example/services/shop/orders-worker/package.json

@@ -0,0 +1,18 @@
+{
+  "name": "orders-worker",
+  "private": true,
+  "type": "module",
+  "scripts": {
+    "build": "bun build src/index.ts --outdir dist --target bun --packages external",
+    "start": "bun run dist/index.js",
+    "dev": "bun --watch src/index.ts"
+  },
+  "dependencies": {
+    "nats": "^2.29.3",
+    "pg": "^8.16.3"
+  },
+  "devDependencies": {
+    "@types/node": "^20.0.0",
+    "@types/pg": "^8.15.5"
+  }
+}

package/examples/tdk-example/services/shop/orders-worker/service.json

@@ -0,0 +1,13 @@
+{
+  "$schema": "https://tdk-landscape.github.io/schema.service.json",
+  "schemaVersion": 1,
+  "appName": "orders-worker",
+  "appType": "worker",
+  "stack": "shop",
+  "port": 4001,
+  "featuresEnabled": ["nats"],
+  "params": {
+    "NATS_URL": "nats://tdk_example_nats:4222"
+  },
+  "dependsOn": ["orders-api"]
+}

package/examples/tdk-example/services/shop/orders-worker/src/index.ts

@@ -0,0 +1,33 @@
+import { connect, type NatsConnection } from "nats";
+import { Pool } from "pg";
+
+const databaseUrl = process.env.DATABASE_URL;
+const natsUrl = process.env.NATS_URL ?? "nats://tdk_example_nats:4222";
+if (!databaseUrl) throw new Error("DATABASE_URL is required");
+
+const pgUrl = new URL(databaseUrl);
+pgUrl.searchParams.delete("schema");
+const db = new Pool({ connectionString: pgUrl.toString() });
+let nc: NatsConnection | undefined;
+while (!nc) {
+  try {
+    nc = await connect({ servers: natsUrl });
+  } catch (error) {
+    console.error("waiting for NATS", error);
+    await new Promise((resolve) => setTimeout(resolve, 1500));
+  }
+}
+const subscription = nc.subscribe("demo.orders.created", { queue: "orders-workers" });
+await nc.flush();
+nc.publish("demo.orders.worker-ready", new Uint8Array());
+console.log("orders-worker subscribed to demo.orders.created");
+
+for await (const message of subscription) {
+  const id = new TextDecoder().decode(message.data);
+  const result = await db.query(
+    "UPDATE demo_orders SET worker_seen_at = now() WHERE id = $1 RETURNING id, item",
+    [id],
+  );
+  if (result.rows[0]) console.log(`worker observed order ${id}: ${result.rows[0].item}`);
+  else console.error(`worker received unknown order ${id}`);
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@tdk-landscape/tdk-cli-core",
-  "version": "1.3.76",
+  "version": "1.3.77",
   "description": "Run your whole microservice landscape locally without Kubernetes. Scaffold services and run them with hot reload, built on Tilt.",
   "homepage": "https://tdk-landscape.github.io/tdk-website",
   "repository": {
@@ -26,6 +26,7 @@
     "specs",
     "ext",
     "shared-platform-engineering/docker-templates",
+    "examples/tdk-example",
     "cli/bin",
     "cli/dist/**/*.js",
     "cli/templates",