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

package/engine/topologies/tilt/common/utils.star

@@ -260,6 +260,37 @@ def encode_json(obj, _depth=0):
 # 📁 FILE I/O UTILITIES
 # =============================================================================
 
+def _is_allowed_generated_path(file_path, project_root):
+    path = file_path.replace('\\', '/').strip()
+    root = project_root.replace('\\', '/').rstrip('/')
+    if root and path.startswith(root + '/'):
+        path = path[len(root) + 1:]
+    if path.startswith('./'):
+        path = path[2:]
+    parts = path.split('/')
+    if '..' in parts or path.startswith('/'):
+        return False
+    if '.autogenerated' in parts:
+        return True
+    if path.startswith('.tdk/.tdk-out/'):
+        return True
+    if path.startswith('product_autogenerated_resource_manifests/') or path.startswith('product_autogenerated_services_list/'):
+        return True
+    if path == 'Tiltfile' or path == '.tiltignore':
+        return True
+    if len(parts) == 1 and path.startswith('TILT_') and path.endswith('.star'):
+        return True
+    return False
+
+def _write_generated_file(file_path, content):
+    expected = str(content).rstrip()
+    dir_path = file_path.rsplit('/', 1)[0]
+    if not dir_path:
+        dir_path = '/'
+    safe_content = (expected + '\n').replace("'", "'\\''")
+    cmd = "mkdir -p '" + dir_path + "' && printf '%s' '" + safe_content + "' > '" + file_path + "'"
+    local(cmd, quiet=True, echo_off=True)
+
 def write_file_if_changed(file_path, content):
     """
     Writes content to file only if it differs from existing content.
@@ -272,28 +303,40 @@ def write_file_if_changed(file_path, content):
         content = ""
 
     # For relative paths, prepend project root to ensure files go to correct location
+    project_root = os.environ.get('TDK_PROJECT_ROOT', '.')
     if not file_path.startswith('/'):
-        project_root = os.environ.get('TDK_PROJECT_ROOT', '.')
         # Remove leading ./ if present in file_path
         clean_file_path = file_path[2:] if file_path.startswith('./') else file_path
         file_path = project_root + '/' + clean_file_path
 
+    if not _is_allowed_generated_path(file_path, project_root):
+        fail("TDK refused to write outside its generated-file allowlist: " + file_path)
+
     expected = str(content).rstrip()
     existing_blob = read_file(file_path, default='')
     existing = str(existing_blob).rstrip()
 
     if existing == expected:
         print("DEBUG WRITE: Skipping {} (no changes)".format(file_path))
-        return
-
-    dir_path = file_path.rsplit('/', 1)[0]
-    if not dir_path:
-        dir_path = '/'
-    safe_content = (expected + '\n').replace("'", "'\\''")
-    cmd = "mkdir -p '" + dir_path + "' && printf '%s' '" + safe_content + "' > '" + file_path + "'"
-    print("DEBUG WRITE: Writing {} bytes to {}".format(len(expected), file_path))
-    local(cmd, quiet=True, echo_off=True)
-    print("DEBUG WRITE: Completed {}".format(file_path))
+    else:
+        print("DEBUG WRITE: Writing {} bytes to {}".format(len(expected), file_path))
+        _write_generated_file(file_path, expected)
+        print("DEBUG WRITE: Completed {}".format(file_path))
+
+    # Keep a generated-content snapshot beside the service outputs. `tdk config verify`
+    # compares these snapshots with the files and the source manifest, detecting both
+    # hand edits and stale generated output without needing to run Tilt from CI.
+    normalized = file_path.replace('\\', '/')
+    generated_marker = '/.autogenerated/'
+    marker_index = normalized.rfind(generated_marker)
+    if marker_index >= 0 and '/.tdk-contract/' not in normalized:
+        service_root = normalized[:marker_index]
+        generated_rel = normalized[marker_index + len(generated_marker):]
+        contract_root = service_root + '/.autogenerated/.tdk-contract'
+        _write_generated_file(contract_root + '/' + generated_rel, expected)
+        manifest_content = read_file(service_root + '/service.json', default='')
+        if manifest_content:
+            _write_generated_file(contract_root + '/service.json.source', str(manifest_content))
 
 
 # =============================================================================

package/engine/topologies/tilt/manifest/AGENTS.md

@@ -46,7 +46,7 @@ load("./constants.star", "MANIFEST_FILENAME")
 ```json
 {
   "appName": "resource-name-backend",
-  "appType": "backend",  // frontend, backend, library, migrator, sdk, worker
+  "appType": "backend",  // frontend, backend, library, migrator, sdk, worker, bring-your-own
   "stack": "order",
   "port": 4000,
   "features": ["nats", "prisma", "vite-node"],

package/engine/topologies/tilt/manifest/constants.star

@@ -61,6 +61,7 @@ VALID_RESOURCE_TYPES = [
     "sdk",
     "worker",
     "infra",
+    "bring-your-own",
 ]
 
 VALID_FEATURES = [
@@ -86,6 +87,7 @@ VALID_FEATURES = [
 PORT_RANGES = {
     "frontend": {"min": 3000, "max": 5999},
     "backend": {"min": 4000, "max": 5999},
+    "bring-your-own": {"min": 4000, "max": 5999},
     "worker": {"min": 6000, "max": 6999},
     "migrator": {"min": 7000, "max": 7999},
     "sdk": {"min": 3000, "max": 9999},
@@ -186,6 +188,7 @@ DEFAULT_SYNCS = {
     'migrator': ['prisma'],
     'library': ['src', 'package.json'],
     'sdk': ['src', 'package.json'],
+    'bring-your-own': [],
 }
 
 RUNTIME_CONFIGS = {

package/engine/topologies/tilt/manifest/schema.star

@@ -64,11 +64,9 @@ MANIFEST_SCHEMA = {
         'default': 'backend',
     },
     'stack': {
-        'type': 'enum',
+        'type': 'string',
         'required': True,
-        'constraints': {
-            'values': VALID_STACKS,
-        },
+        'constraints': {'min_length': 1},
         'description': 'Technology stack this resource belongs to',
         'example': 'user',
     },

package/engine/topologies/tilt/manifest/validator.star

@@ -9,7 +9,7 @@
 # === INLINED CONSTANTS for pure extension loading ===
 VALID_STACKS = ()  # Stacks are project-specific, discovered dynamically
 VALID_FEATURES = "api-client", "env-config", "api-index", "prisma", "ddd", "nats", "redis", "infisical", "vitest", "traefik", "websocket", "graphql", "grpc", "vite-node", "maintenance", "sablier"
-PORT_RANGES = {"frontend": {"min": 3000, "max": 5999}, "backend": {"min": 4000, "max": 5999}, "worker": {"min": 6000, "max": 6999}, "migrator": {"min": 7000, "max": 7999}, "sdk": {"min": 3000, "max": 9999}, "library": {"min": 3000, "max": 9999}}
+PORT_RANGES = {"frontend": {"min": 3000, "max": 5999}, "backend": {"min": 4000, "max": 5999}, "bring-your-own": {"min": 4000, "max": 5999}, "worker": {"min": 6000, "max": 6999}, "migrator": {"min": 7000, "max": 7999}, "sdk": {"min": 3000, "max": 9999}, "library": {"min": 3000, "max": 9999}}
 DEFAULTS = {}
 
 # === END INLINED CONSTANTS ===

package/engine/topologies/tilt/resources/infra-loader.star

@@ -7,7 +7,7 @@
 #
 # This module centralizes infrastructure loading:
 # - Database (PostgreSQL, Redis)
-# - Messaging (NATS, Kafka)
+# - Messaging (Redis, NATS, Kafka)
 # - Secrets (Infisical)
 # - Registry (Verdaccio)
 # - Proxy (Traefik)
@@ -33,6 +33,13 @@ def _file_exists(path):
     return result == 'yes'
 
 
+def _compose_has_service(compose_path, service_name):
+    """Check whether a Compose file declares a named service."""
+    document = read_yaml(compose_path, default={})
+    services = document.get('services', {}) if type(document) == 'dict' else {}
+    return service_name in services
+
+
 def _docker_compose(compose_paths, env_file):
     """docker_compose() wrapper: Tilt's builtin rejects env_file=None outright
     (it type-checks the kwarg as path|string, not Optional), so the keyword must be
@@ -116,8 +123,12 @@ def _load_database_management(should_enable, root_prefix="", env_file=None, writ
     if _file_exists(messaging_compose):
         print("DEBUG INFRA: Loading messaging compose from {}".format(messaging_compose))
         _docker_compose(messaging_compose, env_file)
-        dc_resource('redis', labels=['infra.messaging'], auto_init=False)
-        dc_resource('nats', labels=['infra.messaging'], auto_init=True)
+        # Register only services present in the project compose file. Minimal
+        # NATS-only examples should not need to add an unrelated Redis broker.
+        if _compose_has_service(messaging_compose, 'redis'):
+            dc_resource('redis', labels=['infra.messaging'], auto_init=False)
+        if _compose_has_service(messaging_compose, 'nats'):
+            dc_resource('nats', labels=['infra.messaging'], auto_init=True)
     else:
         print("DEBUG INFRA: Skipping messaging (compose file not found)")
     

package/engine/topologies/tilt/resources/orchestrator/apply_compose_resource_registration.star

@@ -137,10 +137,13 @@ def resource_defers_start(manifest):
     static route wakes it on first request (see openspec/changes/
     prioritized-cold-start)."""
     _, sablier_licensed_and_enabled = sablier_middleware_suffix(manifest, '')
+    sablier = manifest.get('sablier', {}) if manifest else {}
+    defers_start = bool(sablier.get('enable', False) and sablier.get('deferStart', False))
+    if defers_start and not sablier_licensed_and_enabled:
+        print("⚠️  '{}' requests sablier.deferStart but the licensed Sablier overlay is disabled; starting normally".format(manifest.get('name', 'resource')))
     if not sablier_licensed_and_enabled:
         return False
-    sablier = manifest.get('sablier', {}) if manifest else {}
-    return bool(sablier.get('deferStart', False))
+    return defers_start
 
 
 def resolve_manifest_dependency_names(manifest, all_services_map):
@@ -365,7 +368,7 @@ def _register_single_resource(config, resource_path, compose_project_name, auto_
     print("DEBUG REGISTER: Registering '{}' app_type='{}' auto_init={}".format(res_name, app_type, effective_auto_init))
 
     # Skip docker_build for libraries and SDKs - they don't have Dockerfiles
-    if app_type not in ['library', 'sdk'] and config.get('syncs'):
+    if app_type not in ['library', 'sdk', 'bring-your-own'] and config.get('syncs'):
         print("DEBUG REGISTER: '{}' has syncs, calling docker_build".format(res_name))
         live_update_rules = _build_live_update_rules(
             config['res_path'],
@@ -429,13 +432,14 @@ def _process_frontend_resource(res, manifest, full_res_path, resource_path, reso
 
 def _process_backend_resource(res, manifest, full_res_path, resource_path, resource_name, should_enable):
     """Process a backend resource and return compose entry."""
-    Docker.backend(
-        res_path=full_res_path,
-        resource_name=res['name'],
-        port=None,  # Use default BASE_PORT_BACKEND
-        build_cmd=res.get('start_command', 'bun run build'),
-        use_golden=should_enable('golden-image'),
-    )
+    if manifest.get('appType') != 'bring-your-own':
+        Docker.backend(
+            res_path=full_res_path,
+            resource_name=res['name'],
+            port=None,  # Use default BASE_PORT_BACKEND
+            build_cmd=res.get('start_command', 'bun run build'),
+            use_golden=should_enable('golden-image'),
+        )
     return Docker.backend_compose(resource_path=resource_path, resource_name=resource_name, res=res, manifest=manifest)
 
 
@@ -462,7 +466,7 @@ def _build_resource_config(res, manifest, resource_config, full_res_path, infra_
         'replicas': replicas,
         'syncs': res.get('syncs', []),
         'app_type': manifest.get('appType', 'backend'),
-        'dockerfile': res.get('dockerfile', OUTPUT.AUTOGENERATED_FOLDER + '/Dockerfile.app.autogenerated'),
+        'dockerfile': res.get('dockerfile', manifest.get('dockerfile', OUTPUT.AUTOGENERATED_FOLDER + '/Dockerfile.app.autogenerated')),
         'res_path': full_res_path,
         'env': env_vars,
         'project_root': project_root,

package/engine/topologies/tilt/resources/orchestrator/generators/manifest_resource.star

@@ -126,6 +126,8 @@ def _build_generated_file_list(resource_config, resource_path, manifest):
     """
     files = []
     app_type = manifest.get('appType', 'backend')
+    if app_type == 'bring-your-own':
+        return []
     is_frontend = resource_config.get('frontend', False) or app_type == 'frontend'
 
     # Vite
@@ -267,6 +269,16 @@ def _generate_all_configs_for_resource(
     write_file = ctx['write_file']
     should_enable = ctx['should_enable']
     global_config = ctx['global_config']
+
+    # Env generation needs the actual service directory on the manifest. Set it
+    # before the BYO fast path too; otherwise Compose references an env file that
+    # was never written for bring-your-own resources.
+    manifest['_resource_path'] = resource_path
+
+    if manifest.get('appType') == 'bring-your-own':
+        _generate_env_file(manifest, backend_manifest, write_file)
+        _generate_yaml_manifest(resource_path, manifest, write_file)
+        return
     
     # WORKAROUND: Prevent infinite recursion by checking recursion depth
     # Use a unique key per resource to track depth, avoiding interference between different resources
@@ -279,9 +291,6 @@ def _generate_all_configs_for_resource(
     ctx = dict(ctx)
     ctx[recursion_key] = recursion_depth + 1
     
-    # Add resource_path to manifest so generators can access it
-    manifest['_resource_path'] = resource_path
-    
     # ==========================================================================
     # NEW: PRE-FLIGHT VALIDATIONS (v2.0)
     # Run validations BEFORE generating configs to catch issues early
@@ -444,8 +453,8 @@ def _generate_all_configs_for_resource(
 
 
 def _generate_yaml_manifest(resource_path, manifest, write_file):
-    """Generate YAML version of manifest for verification (idempotent)."""
-    yaml_path = resource_path + "/" + MANIFEST_FILENAME_YAML
+    """Generate an allowlisted YAML shadow beside other TDK-owned outputs."""
+    yaml_path = resource_path + "/.autogenerated/" + MANIFEST_FILENAME_YAML
     
     # Check if YAML already exists and is up-to-date by comparing with JSON
     json_path = resource_path + "/" + MANIFEST_FILENAME
@@ -525,7 +534,7 @@ def create_manifest_config_resource(
     local_resource(
         name=config_gen_resource_name,
         cmd=log_cmd,
-        deps=[manifest_path, package_json_path],
+        deps=[manifest_path] if manifest.get('appType') == 'bring-your-own' else [manifest_path, package_json_path],
         labels=['config-gen', resource_name],
         allow_parallel=True,
         auto_init=auto_init_config_gen

package/examples/tdk-example/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 TDK Landscape
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/examples/tdk-example/README.md

@@ -0,0 +1,23 @@
+# TDK product example
+
+A small working landscape with a Hono API, PostgreSQL, a NATS worker, a Vite UI, and Traefik routes.
+
+This is a local demo, not a Helm chart.
+
+```sh
+tdk doctor
+tdk project --yes
+tdk up
+```
+
+Open `http://app.tdk-example.localhost/orders-app/` and create an order, or use the routed API:
+
+```sh
+curl -fsS -X POST http://api.tdk-example.localhost/api/orders \
+  -H 'content-type: application/json' -d '{"item":"coffee"}'
+```
+
+The API stores each order in PostgreSQL and publishes its id to NATS. The worker consumes the
+event, reads the stored row, and marks it observed. Poll `GET /api/orders/<id>` through the API
+route until `workerSeenAt` is set. `tdk config verify` checks generated output. Stop the landscape
+with `tdk down`.

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>