@tdk-landscape/tdk-cli-core 1.3.37 → 1.3.39

package/engine/topologies/platform/docker/networking/sablier_container_cycle.star

@@ -1,27 +1,29 @@
-def _sablier_middleware_suffix(manifest):
-    """Return (middleware_suffix, group, enabled) for a manifest's Sablier block.
+# =============================================================================
+# On-demand scaling: Sablier + Traefik (free-tier stub)
+# =============================================================================
+# Path: engine/topologies/platform/docker/networking/sablier_container_cycle.star
+# =============================================================================
+# The real generator (Sablier + Traefik label wiring that stops idle
+# containers and wakes them on the next request) is part of a paid TDK
+# license. When a valid license grants the "sablier" resource,
+# cli/src/generator/template-engine.ts (vendorTdkExtension) overwrites this
+# file with the licensed version fetched via extension-fetch.ts before Tilt
+# loads it. Same function signatures either way, so nothing else in the
+# generator pipeline changes -- every call site just gets "disabled" back
+# for a manifest's `sablier` block until then.
+# =============================================================================
 
-    When a workload opts in via a `sablier` block, it is fronted by the file-provider
-    middleware `sablier-<group>@file` (defined in the platform proxy dynamic config).
-    The leading comma lets callers append the suffix to an existing middlewares list.
-    """
-    sablier_cfg = manifest.get('sablier', {}) if manifest else {}
-    if not sablier_cfg.get('enable', False):
-        return "", "", False
-    group = sablier_cfg.get('group', manifest.get('stack', '') if manifest else '')
-    if not group:
-        return ",sablier-base@file", "", True
-    return ",sablier-" + group + "@file", group, True
 
+def _sablier_config(_manifest):
+    """Free-tier stub - see module header. Always disabled."""
+    return False, "", ""
 
-def _sablier_container_labels(group, indent):
-    """Container labels that let Sablier discover, wake, and stop this workload.
 
-    `traefik.docker.allownonrunning=true` keeps the router registered while the
-    container is stopped, so the next request can trigger the wake.
-    """
-    lines = [indent + '- "sablier.enable=true"']
-    if group:
-        lines.append(indent + '- "sablier.group=' + group + '"')
-    lines.append(indent + '- "traefik.docker.allownonrunning=true"')
-    return "\n" + "\n".join(lines)
+def _sablier_middleware_suffix(_manifest, _res_name):
+    """Free-tier stub - see module header. Always disabled."""
+    return "", False
+
+
+def _sablier_container_labels(_manifest, _res_name, _indent):
+    """Free-tier stub - see module header. No labels to add."""
+    return ""

package/engine/topologies/platform/docker/networking/traefik.star

@@ -31,21 +31,10 @@ load("./traefik_helpers.star",
     "get_api_path",
     "project_backend_rule",
 )
-# load("./sablier_container_cycle.star",
-#     "_sablier_middleware_suffix",
-#     "_sablier_container_labels",
-# )
-
-def _sablier_middleware_suffix(_):
-    # Stub: no Sablier middleware needed
-    return "", "", False
-
-def _sablier_container_labels(_, __):
-    # Stub: no extra labels needed
-    return ""
-
-
-# Sablier functions imported from sablier_container_cycle.star
+load("./sablier_container_cycle.star",
+    "_sablier_middleware_suffix",
+    "_sablier_container_labels",
+)
 
 
 def get_frontend_traefik_labels(res_name, domain, base_path, port, traefik_host=None, manifest=None):
@@ -66,7 +55,7 @@ def get_frontend_traefik_labels(res_name, domain, base_path, port, traefik_host=
         maintenance_middleware = ",maintenance@file"
 
     # On-demand scaling: attach the Sablier middleware when opted in via the manifest
-    sablier_middleware, sablier_group, sablier_enabled = _sablier_middleware_suffix(manifest)
+    sablier_middleware, sablier_enabled = _sablier_middleware_suffix(manifest, res_name)
 
     labels = """        - "{traefik_enable_label}"
         - 'traefik.http.routers.{res_name}.rule={frontend_route_rule}'
@@ -90,7 +79,7 @@ def get_frontend_traefik_labels(res_name, domain, base_path, port, traefik_host=
     )
 
     if sablier_enabled:
-        labels += _sablier_container_labels(sablier_group, "        ")
+        labels += _sablier_container_labels(manifest, res_name, "        ")
 
     return labels
 
@@ -118,7 +107,7 @@ def get_backend_traefik_labels(
         maintenance_middleware = ",maintenance@file"
 
     # On-demand scaling: attach the Sablier middleware when opted in via the manifest
-    sablier_middleware, sablier_group, sablier_enabled = _sablier_middleware_suffix(manifest)
+    sablier_middleware, sablier_enabled = _sablier_middleware_suffix(manifest, resource_entry_name)
 
     # Build middleware config only if traefik_path is not empty
     if traefik_path:
@@ -161,7 +150,7 @@ def get_backend_traefik_labels(
 
     # Emit Sablier discovery labels so the Sablier container can wake/stop this workload
     if sablier_enabled:
-        labels += _sablier_container_labels(sablier_group, "      ")
+        labels += _sablier_container_labels(manifest, resource_entry_name, "      ")
 
     # Generate project localhost routing to match `tdk up` URLs:
     # http://api.{project}.localhost/api/{resource-name}
@@ -204,7 +193,7 @@ def get_backend_traefik_labels(
       - "traefik.http.routers.{resource_entry_name}-management.rule=Host(`{api_host}`) && PathPrefix(`{management_path}`)"
       - "traefik.http.routers.{resource_entry_name}-management.entrypoints={project_entrypoints}"
       - "traefik.http.routers.{resource_entry_name}-management.service={traefik_resource_name}"
-      - "traefik.http.routers.{resource_entry_name}-management.middlewares={middleware_name}-management"
+      - "traefik.http.routers.{resource_entry_name}-management.middlewares={middleware_name}-management{sablier_middleware}"
       - "traefik.http.middlewares.{middleware_name}-management.stripprefix.prefixes={management_path}"
       - "traefik.http.routers.{resource_entry_name}-management.priority={mgmt_priority}"
 """.format(
@@ -214,6 +203,7 @@ def get_backend_traefik_labels(
                 management_path=management_path,
                 project_entrypoints=project_entrypoints,
                 middleware_name=middleware_name,
+                sablier_middleware=sablier_middleware,
                 mgmt_priority=TRAEFIK_FRONTEND_PRIORITY_BASE + len(management_path),
             )
 

package/engine/topologies/platform/registries/verdaccio_loader.star

@@ -0,0 +1,18 @@
+# =============================================================================
+# 📦 VERDACCIO (NPM Registry) - loader (free-tier stub)
+# =============================================================================
+# Path: engine/topologies/platform/registries/verdaccio_loader.star
+# =============================================================================
+# The real loader (stands up the Verdaccio private npm registry container and
+# wires it into the project's Docker network) is part of a paid TDK license.
+# When a valid license grants the "verdaccio" resource,
+# cli/src/generator/template-engine.ts (vendorTdkExtension) overwrites this
+# file with the licensed version fetched via extension-fetch.ts before Tilt
+# loads it. Same function signature either way, so nothing else in the
+# loader pipeline changes.
+# =============================================================================
+
+
+def load_verdaccio(_should_enable, _root_prefix="", _env_file=None):
+    """Free-tier stub - see module header. Always skipped."""
+    print("ℹ️  Verdaccio skipped — requires a TDK Premium license (run `tdk upgrade`)")

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

@@ -69,6 +69,7 @@ VALID_FEATURES = [
     "env-config",
     "api-index",
     "prisma",
+    "ddd",
     # Infrastructure features
     "nats",
     "redis",

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

@@ -8,7 +8,7 @@
 
 # === INLINED CONSTANTS for pure extension loading ===
 VALID_STACKS = ()  # Stacks are project-specific, discovered dynamically
-VALID_FEATURES = "api-client", "env-config", "api-index", "prisma", "nats", "redis", "infisical", "vitest", "traefik", "websocket", "graphql", "grpc", "vite-node", "maintenance"
+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}}
 RUNTIME = "bun"
 TRAEFIK_CONFIG = {"entrypoint": "web", "network": "traefik-public", "default_host": "localhost", "default_port": 8080, "tls_enabled": False, "entrypoints": ["web"], "middlewares": [], "tls": {"enabled": False}, "healthcheck_path": "/health", "healthcheck_interval": "10s", "healthcheck_timeout": "5s", "frontend_priority_base": 100}
@@ -252,6 +252,34 @@ MANIFEST_SCHEMA = {
         },
         'description': 'Traefik reverse proxy configuration',
     },
+
+    # Sablier Configuration (on-demand start/stop for idle resources)
+    'sablier': {
+        'type': 'dict',
+        'required': False,
+        'schema': {
+            'enable': {
+                'type': 'boolean',
+                'required': False,
+                'default': False,
+                'description': 'Scale this resource to zero when idle; Sablier wakes it on the next request',
+            },
+            'group': {
+                'type': 'string',
+                'required': False,
+                'description': 'Resources sharing a group wake and sleep together (defaults to `stack`)',
+                'example': 'restaurant',
+            },
+            'sessionDuration': {
+                'type': 'string',
+                'required': False,
+                'default': '10m',
+                'description': 'How long the resource stays up after its last request, as a Go duration (e.g. "10m", "1h")',
+                'example': '10m',
+            },
+        },
+        'description': 'On-demand scaling via Sablier: stop idle containers, wake them on the next request. Not recommended for stateful resources (databases) with in-flight writes. (Premium - requires TDK_LICENSE_KEY; see hasSablierLicense() in extension-fetch.ts)',
+    },
 }
 
 # Cross-field validation constraints

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

@@ -8,7 +8,7 @@
 
 # === INLINED CONSTANTS for pure extension loading ===
 VALID_STACKS = ()  # Stacks are project-specific, discovered dynamically
-VALID_FEATURES = "api-client", "env-config", "api-index", "prisma", "nats", "redis", "infisical", "vitest", "traefik", "websocket", "graphql", "grpc", "vite-node", "maintenance", "sablier"
+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}}
 DEFAULTS = {}
 

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

@@ -20,6 +20,7 @@
 
 load("../../platform/docker/constants.star", "PlatformDockerConstants")
 load("../../platform/docker/compose/traefik_standalone.star", "generate_standalone_traefik_compose")
+load("../../platform/registries/verdaccio_loader.star", "load_verdaccio")
 
 # =============================================================================
 # 🗃️ DATABASE MANAGEMENT
@@ -129,38 +130,11 @@ def _load_database_management(should_enable, root_prefix="", env_file=None, writ
 # =============================================================================
 # 📦 VERDACCIO (NPM Registry)
 # =============================================================================
+# Loader lives in ../../platform/registries/verdaccio_loader.star (a free-tier
+# stub in this public repo; the paid CLI overlay swaps it for the real loader
+# — see that module's header comment).
 
-def _load_verdaccio(should_enable, root_prefix="", env_file=None):
-    """Load Verdaccio private npm registry (premium feature — requires TDK_LICENSE_KEY)."""
-    # Verdaccio is a premium feature. Skip entirely when no license key is set.
-    if not os.environ.get("TDK_LICENSE_KEY", ""):
-        print("ℹ️  Verdaccio skipped — TDK_LICENSE_KEY not set (premium feature)")
-        return
-    if not should_enable(PlatformDockerConstants.VERDACCIO_RESOURCE_NAME):
-        print("DEBUG INFRA: Verdaccio not enabled")
-        return
-    
-    # Use absolute path for docker-compose to ensure correct working directory
-    if root_prefix:
-        compose_file = root_prefix + 'docker-compose.verdaccio.yml'
-    else:
-        # Use project root from environment or relative path
-        project_root = os.environ.get('TDK_PROJECT_ROOT', '.')
-        compose_file = project_root + '/docker-compose.verdaccio.yml'
-    if not _file_exists(compose_file):
-        print("DEBUG INFRA: Skipping Verdaccio (compose file not found)")
-        return
-    print("DEBUG INFRA: Loading Verdaccio from {} with env_file={}".format(compose_file, env_file))
-    _docker_compose(compose_file, env_file)
-    print("DEBUG INFRA: Calling dc_resource for verdaccio")
-    dc_resource(PlatformDockerConstants.VERDACCIO_RESOURCE_NAME, labels=['infra.tools', 'registry'], resource_deps=['init-networks'], auto_init=True)
-    print("DEBUG INFRA: dc_resource for verdaccio completed")
-    local_resource(PlatformDockerConstants.VERDACCIO_CONNECT_NETWORK_RESOURCE,
-        cmd='docker network connect ' + PlatformDockerConstants.NETWORK_BACKEND + ' ' + PlatformDockerConstants.VERDACCIO_CONTAINER_NAME + ' 2>/dev/null || true',
-        labels=['infra.tools', 'registry'], 
-        resource_deps=[PlatformDockerConstants.VERDACCIO_RESOURCE_NAME, 'init-networks'], 
-        auto_init=True
-    )
+_load_verdaccio = load_verdaccio
 
 
 # =============================================================================

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@tdk-landscape/tdk-cli-core",
-  "version": "1.3.37",
+  "version": "1.3.39",
   "description": "TDK CLI - Tilt Development Kit command line interface",
   "keywords": [
     "tdk",
@@ -43,7 +43,7 @@
     "build:watch": "tsc --watch",
     "lint": "biome check .",
     "lint:fix": "biome check . --write",
-    "typecheck": "tsc --noEmit",
+    "typecheck": "tsc --project tsconfig.typecheck.json",
     "clean": "rm -rf dist",
     "dev": "bun run build:watch",
     "test": "vitest run",
@@ -51,7 +51,6 @@
     "prepack": "../scripts/stage-npm-engine.sh && npm run build"
   },
   "dependencies": {
-    "@types/react": "^19.2.14",
     "chalk": "^5.3.0",
     "commander": "^12.0.0",
     "handlebars": "^4.7.8",
@@ -62,6 +61,7 @@
   },
   "devDependencies": {
     "@biomejs/biome": "^2.5.13",
+    "@types/react": "^19.2.14",
     "@types/inquirer": "^9.0.0",
     "@types/node": "^20.0.0",
     "knip": "^6.35.1",