@tdk-landscape/tdk-cli-core 1.3.15 → 1.3.26

package/engine/topologies/tilt/generators/vite/backend.star

@@ -0,0 +1,78 @@
+# =============================================================================
+# ⚡ TILT SDK - VITE BACKEND GENERATOR
+
+# === INLINED CONSTANTS for pure extension loading ===
+BASE_PORT_BACKEND = 4000
+OUTPUT = struct(AUTOGENERATED_FOLDER = ".autogenerated")
+# === END INLINED CONSTANTS ===
+
+
+load('../../../../topologies/tilt/manifest/constants.star', 'GENERATED_CONFIG_FILENAMES')
+# =============================================================================
+# Path: .tilt/providers/vite/backend.star
+# Purpose: Vite config generator for Backend services
+# =============================================================================
+
+
+load('./templates.star', 'TEMPLATE_VITE_BACKEND_WITH_NODE', 'TEMPLATE_VITE_BACKEND_VITEST_ONLY')
+load('./helpers.star', 
+    'build_header', 
+    'generate_backend_path_aliases', 
+    'generate_externals_config', 
+    'generate_vitest_inline_deps'
+)
+
+# Constants for output paths
+VITE_BACKEND_CONFIG_PATH = '/' + OUTPUT.AUTOGENERATED_FOLDER + '/' + GENERATED_CONFIG_FILENAMES['vite_backend']
+
+def generate_backend(manifest, write_fn=None):
+    """
+    Generate vite.config.ts for BACKEND services.
+    
+    Why backends use Vite:
+    1. Vitest: Fastest test runner for TypeScript
+    2. vite-plugin-node: Instant HMR for Node.js (no restart) - OPTIONAL
+    3. Fast TypeScript transpilation via SWC/esbuild
+    4. Unified config with frontend teams
+    """
+    app_type = manifest.get('appType', 'backend')
+    if app_type not in ['backend', 'migrator']:
+        fail("Vite.backend() requires a backend manifest, got: " + app_type)
+    
+    resource_path = manifest.get('_resource_path', '')
+    app_name = manifest.get('appName', 'unknown')
+    port = manifest.get('port', BASE_PORT_BACKEND)
+    
+    # 🔥 SMART DETECTION: Check if service uses vite-plugin-node for HMR
+    use_vite_node = manifest.get('useViteNode', False)
+    features = manifest.get('features', [])
+    if 'vite-node' in features or 'vite-plugin-node' in features or 'hmr' in features:
+        use_vite_node = True
+    
+    entry_point = manifest.get('entryPoint', './src/index.ts')
+    path_aliases = generate_backend_path_aliases(resource_path, manifest)
+    vitest_inline_deps = generate_vitest_inline_deps(manifest)
+    
+    if use_vite_node:
+        header = build_header('Vite.backend()', app_name, 'Backend (SSR + HMR + Vitest)')
+        externals_config = generate_externals_config(manifest)
+        config = TEMPLATE_VITE_BACKEND_WITH_NODE.format(
+            header=header,
+            entry_point=entry_point,
+            port=port,
+            path_aliases=path_aliases,
+            externals_config=externals_config,
+            vitest_inline_deps=vitest_inline_deps,
+        )
+    else:
+        header = build_header('Vite.backend()', app_name, 'Backend (Vitest)')
+        config = TEMPLATE_VITE_BACKEND_VITEST_ONLY.format(
+            header=header,
+            path_aliases=path_aliases,
+            vitest_inline_deps=vitest_inline_deps,
+        )
+    
+    if write_fn:
+        write_fn(resource_path + VITE_BACKEND_CONFIG_PATH, config)
+    
+    return config

package/engine/topologies/tilt/generators/vite/frontend.star

@@ -0,0 +1,98 @@
+# =============================================================================
+# ⚡ TILT SDK - VITE FRONTEND GENERATOR
+
+# === INLINED CONSTANTS for pure extension loading ===
+BASE_PORT_FRONTEND = 3000
+BASE_PORT_BACKEND = 4000
+OUTPUT = struct(AUTOGENERATED_FOLDER = ".autogenerated")
+# === END INLINED CONSTANTS ===
+
+
+load('../../../../topologies/tilt/manifest/constants.star', 'GENERATED_CONFIG_FILENAMES')
+# =============================================================================
+# Path: .tilt/providers/vite/frontend.star
+# Purpose: Vite config generator for Frontend services
+# =============================================================================
+
+
+load('./templates.star', 'TEMPLATE_VITE_FRONTEND', 'TEMPLATE_VITE_FRONTEND_BUILD')
+load('./helpers.star', 
+    'build_header', 
+    'generate_frontend_internal_aliases', 
+    'generate_frontend_optimize_deps', 
+    'generate_proxy_block'
+)
+
+# Constants for output paths
+VITE_FRONTEND_CONFIG_PATH = '/' + OUTPUT.AUTOGENERATED_FOLDER + '/' + GENERATED_CONFIG_FILENAMES['vite_frontend']
+VITE_FRONTEND_BUILD_CONFIG_PATH = '/' + OUTPUT.AUTOGENERATED_FOLDER + '/' + GENERATED_CONFIG_FILENAMES['vite_build']
+
+def _normalize_vite_base_path(base_path):
+    """Vite subpath deploys are more reliable with a trailing slash."""
+    if not base_path:
+        return '/'
+    if not base_path.startswith('/'):
+        base_path = '/' + base_path
+    if base_path != '/' and not base_path.endswith('/'):
+        base_path = base_path + '/'
+    return base_path
+
+def generate_frontend(manifest, backend_manifest=None, write_fn=None):
+    """
+    Generate vite.config.ts for FRONTEND services.
+    
+    Features:
+    - Auto-proxy to backend based on backend manifest port
+    - HMR configuration with correct ports
+    - Base path configuration
+    - TypeScript path aliases
+    - 🔥 Auto-generated internal dependency aliases from package.json
+    - 🔥 optimizeDeps.include for faster dev startup
+    """
+    if manifest.get('appType') != 'frontend':
+        fail("Vite.frontend() requires a frontend manifest, got: " + manifest.get('appType', 'unknown'))
+    
+    resource_path = manifest.get('_resource_path', '')
+    stack = manifest.get('stack', 'app')
+    port = manifest.get('port', BASE_PORT_FRONTEND)
+    hmr_port = port + 1000  # HMR port is always port + 1000
+    base_path = manifest.get('basePath', '/' + stack + 's')
+    vite_base_path = _normalize_vite_base_path(base_path)
+    app_name = manifest.get('appName', 'unknown')
+
+    backend_port = BASE_PORT_BACKEND
+    if backend_manifest:
+        backend_port = backend_manifest.get('port', BASE_PORT_BACKEND)
+
+    # Use traefik pathPrefix for API base path (modern pattern)
+    traefik_config = manifest.get('traefik', {})
+    api_base_path = traefik_config.get('pathPrefix', '/api')
+
+    proxy_config = generate_proxy_block(api_base_path, backend_port, [], stack)
+    header = build_header('Vite.frontend()', app_name)
+    # Config is written under .autogenerated/, so aliases need one extra ".." level.
+    internal_aliases = generate_frontend_internal_aliases(resource_path, manifest, 1)
+    optimize_deps_include = generate_frontend_optimize_deps(manifest)
+    
+    config = TEMPLATE_VITE_FRONTEND.format(
+        header=header,
+        base_path=vite_base_path,
+        port=port,
+        hmr_port=hmr_port,
+        proxy_config=proxy_config,
+        internal_aliases=internal_aliases,
+        optimize_deps_include=optimize_deps_include,
+    )
+
+    build_cfg_header = build_header('Vite.frontend()', app_name, 'Build-only Vite config')
+    build_config = TEMPLATE_VITE_FRONTEND_BUILD.format(
+        header=build_cfg_header,
+        base_path=vite_base_path,
+        optimize_deps_include=optimize_deps_include,
+    )
+    
+    if write_fn:
+        write_fn(resource_path + VITE_FRONTEND_CONFIG_PATH, config)
+        write_fn(resource_path + VITE_FRONTEND_BUILD_CONFIG_PATH, build_config)
+    
+    return config

package/engine/topologies/tilt/generators/vite/generators.star

@@ -0,0 +1,43 @@
+# =============================================================================
+# ⚡ TILT SDK - VITE PROVIDER GENERATORS
+# =============================================================================
+# Path: .tilt/providers/vite/generators.star
+# Purpose: Vite config generators dispatcher
+# =============================================================================
+
+load('./frontend.star', _generate_frontend = 'generate_frontend')
+load('./backend.star', _generate_backend = 'generate_backend')
+load('./library.star', _generate_library = 'generate_library')
+load('./sdk.star', _generate_sdk = 'generate_sdk')
+
+generate_frontend = _generate_frontend
+generate_backend = _generate_backend
+generate_library = _generate_library
+generate_sdk = _generate_sdk
+
+def generate_for_manifest(manifest, backend_manifest=None, write_fn=None):
+    """
+    Universal dispatcher that generates the appropriate vite.config.ts
+    based on manifest appType.
+    
+    This is the main entry point that Tilt should call for ALL services.
+    """
+    app_type = manifest.get('appType', 'backend')
+    needs_vite = manifest.get('needsVite', True)
+    
+    if not needs_vite:
+        return None
+    
+    if app_type == 'frontend':
+        return generate_frontend(manifest, backend_manifest, write_fn)
+    elif app_type == 'backend':
+        return generate_backend(manifest, write_fn)
+    elif app_type == 'library':
+        return generate_library(manifest, write_fn)
+    elif app_type == 'sdk':
+        return generate_sdk(manifest, write_fn)
+    elif app_type == 'migrator':
+        return generate_backend(manifest, write_fn)
+    else:
+        print("   ⚠️  Unknown appType '" + app_type + "' for Vite config generation")
+        return None

package/engine/topologies/tilt/generators/vite/helpers.star

@@ -0,0 +1,244 @@
+# =============================================================================
+# ⚡ TILT SDK - VITE PROVIDER HELPERS
+# =============================================================================
+# Path: .tilt/providers/vite/helpers.star
+# Purpose: Shared helper functions for Vite generators
+# =============================================================================
+
+load('../../../../topologies/tilt/common/utils.star', 'Utils')
+
+# Load npm scope from project.json (or use project name as default)
+# Use TDK_PROJECT_ROOT env var set by Tilt, fallback to current directory
+def _load_npm_scope():
+    project_root = os.environ.get('TDK_PROJECT_ROOT', '')
+    project_json_path = '.tdk/project.json'
+    if project_root:
+        project_json_path = project_root + '/' + project_json_path
+    
+    if os.path.exists(project_json_path):
+        _project_json = read_json(project_json_path)
+        return _project_json.get('project', {}).get('name', 'tdk-project')
+    return 'tdk-project'
+
+_NPM_SCOPE = _load_npm_scope()
+# =============================================================================
+# API PATH CONSTANTS - Import for full descriptive API naming
+# =============================================================================
+load('../../../../topologies/platform/docker/networking/api_path_constants.star',
+     'get_api_path_for_stack',
+     'build_traefik_url')
+
+
+def build_header(generator_fn, app_name, extra_header=''):
+    """Build the standard file header using shared utility."""
+    return Utils.get_template_header(
+        'vite',
+        'Vite.' + generator_fn,
+        app_name,
+        extra_header
+    )
+
+
+def generate_frontend_internal_aliases(resource_path, manifest, config_depth_offset=0):
+    """
+    Generate internal package aliases for frontend Vite config.
+    
+    Convention over Configuration:
+        @{npm_scope}/platform-x → {rel_to_root}shared-platform-engineering/platform-x/src
+        @{npm_scope}/product-x  → {rel_to_root}shared-product-engineering/product-x/src
+    """
+    internal_deps = manifest.get('_internalDeps', [])
+
+    if not internal_deps:
+        return '      // No internal dependencies detected'
+
+    # Calculate depth for relative paths (Starlark-compatible)
+    resource_parts = []
+    for p in resource_path.split('/'):
+        if p:
+            resource_parts.append(p)
+    depth = len(resource_parts) + config_depth_offset
+    rel_to_root = '../' * depth
+
+    lines = ['      // 🔥 Auto-generated internal package aliases (from package.json)']
+
+    for dep in sorted(internal_deps):
+        if dep.startswith('@' + _NPM_SCOPE + '/'):
+            lib_name = dep.replace('@' + _NPM_SCOPE + '/', '')
+            
+            # Determine library root by naming convention
+            if lib_name.startswith('platform-'):
+                lib_path = rel_to_root + 'shared-platform-engineering/' + lib_name + '/dist'
+            elif lib_name.startswith('product-'):
+                lib_path = rel_to_root + 'shared-product-engineering/' + lib_name + '/dist'
+            elif lib_name in ['domain', 'application', 'infrastructure', 'presentation']:
+                lib_path = rel_to_root + 'shared-ddd-layers/' + lib_name + '/src'
+            else:
+                lib_path = rel_to_root + 'shared-platform-engineering/' + lib_name + '/src'
+            
+            lines.append("      '" + dep + "': resolve(__dirname, '" + lib_path + "'),")
+    
+    return '\n'.join(lines)
+
+
+def generate_frontend_optimize_deps(manifest):
+    """Generate optimizeDeps.include array for faster Vite dev startup."""
+    internal_deps = manifest.get('_internalDeps', [])
+    
+    if not internal_deps:
+        return ''
+    
+    # Filter optimize deps (Starlark-compatible)
+    optimize_deps = []
+    for dep in internal_deps:
+        if dep.startswith('@' + _NPM_SCOPE + '/'):
+            optimize_deps.append(dep)
+    
+    if not optimize_deps:
+        return ''
+    
+    # Build quoted deps list (Starlark-compatible)
+    quoted_deps = []
+    for dep in sorted(optimize_deps):
+        quoted_deps.append("'" + dep + "'")
+    
+    return '\n      ' + ',\n      '.join(quoted_deps) + ',\n    '
+
+
+def generate_proxy_block(api_base_path, backend_port, additional_routes, stack='app'):
+    """Generate Vite proxy config using full descriptive API paths.
+    
+    Uses API naming convention with full service names from manifest:
+    - Pattern: /api/v1/{app-name}
+    - Generated from manifest "stack" and "appName" fields
+    
+    Args:
+        api_base_path: The base API path (from manifest)
+        backend_port: Backend resource port (kept for compatibility)
+        additional_routes: Additional proxy routes
+        stack: Resource stack name (from manifest.json)
+    
+    Returns:
+        Vite proxy configuration string
+    """
+    # Get full descriptive API path for this stack using constants
+    # This replaces the old pattern: 'http://localhost:' + str(backend_port)
+    api_path = get_api_path_for_stack(stack)
+    
+    # Build Traefik gateway URL using the full API path
+    # Format: http://{project}.localhost/api/v1/{full-service-name}
+    local_target = build_traefik_url(api_path)
+    
+    routes = [
+        (api_base_path, local_target),
+        ('/health', local_target),
+        ('/trpc', local_target),
+    ]
+    
+    for route in additional_routes:
+        if type(route) == 'dict':
+            routes.append((route.get('path', '/'), route.get('target', local_target)))
+        else:
+            routes.append((route, local_target))
+    
+    lines = ['    proxy: {']
+    for path, target in routes:
+        lines.append("      '" + path + "': {")
+        lines.append("        target: '" + target + "',")
+        lines.append("        changeOrigin: true,")
+        lines.append("        secure: false,")
+        lines.append("      },")
+    lines.append('    },')
+    
+    return '\n'.join(lines)
+
+
+def generate_backend_path_aliases(resource_path, manifest):
+    """Generate TypeScript path aliases for DDD architecture."""
+    lines = []
+    
+    ddd_aliases = [
+        ('@application', './src/application'),
+        ('@domain', './src/domain'),
+        ('@infrastructure', './src/infrastructure'),
+        ('@presentation', './src/presentation'),
+        ('@test', './src/tests'),
+    ]
+    
+    for alias, rel_path in ddd_aliases:
+        lines.append("      '" + alias + "': path.resolve(__dirname, '" + rel_path + "'),")
+    
+    resource_parts = []
+    for p in resource_path.split('/'):
+        if p:
+            resource_parts.append(p)
+    depth = len(resource_parts)
+    rel_to_root = '../' * depth
+    
+    internal_deps = manifest.get('_internalDeps', [])
+    for dep in sorted(internal_deps):
+        if dep.startswith('@' + _NPM_SCOPE + '/'):
+            lib_name = dep.replace('@' + _NPM_SCOPE + '/', '')
+            
+            if lib_name.startswith('platform-'):
+                lib_path = rel_to_root + 'shared-platform-engineering/' + lib_name + '/dist'
+            elif lib_name.startswith('product-'):
+                lib_path = rel_to_root + 'shared-product-engineering/' + lib_name + '/dist'
+            elif lib_name in ['domain', 'application', 'infrastructure', 'presentation']:
+                lib_path = rel_to_root + 'shared-ddd-layers/' + lib_name + '/src'
+            else:
+                lib_path = rel_to_root + 'shared-platform-engineering/' + lib_name + '/src'
+            
+            lines.append("      '" + dep + "': path.resolve(__dirname, '" + lib_path + "'),")
+    
+    return '\n'.join(lines)
+
+
+def generate_externals_config(manifest):
+    """Generate Rollup externals for Node.js backend build."""
+    externals = [
+        '/^node:.*/',
+        '@prisma/client',
+        'prisma',
+        'hono',
+        'nats',
+    ]
+    
+    if manifest.get('usePrisma'):
+        externals.extend(['.prisma/client', '@prisma/adapter-pg'])
+    
+    if manifest.get('useNats'):
+        externals.append('nats')
+    
+    # Build externals config (Starlark-compatible)
+    externals_quoted = []
+    for e in externals:
+        if not e.startswith('/'):
+            externals_quoted.append("'" + e + "'")
+        else:
+            externals_quoted.append(e)
+    
+    return '[' + ', '.join(externals_quoted) + ']'
+
+
+def generate_vitest_inline_deps(manifest):
+    """Generate Vitest inline deps for internal packages."""
+    internal_deps = manifest.get('_internalDeps', [])
+    
+    # Filter inline deps (Starlark-compatible)
+    inline_deps = []
+    for dep in internal_deps:
+        if dep.startswith('@' + _NPM_SCOPE + '/'):
+            inline_deps.append(dep)
+    
+    if not inline_deps:
+        return ''
+    
+    # Build quoted deps list (Starlark-compatible)
+    quoted_deps = []
+    for dep in inline_deps:
+        quoted_deps.append("'" + dep + "'")
+    
+    return '\n        ' + ',\n        '.join(quoted_deps) + ',\n      '
+
+CONSTANTS = {}

package/engine/topologies/tilt/generators/vite/library.star

@@ -0,0 +1,65 @@
+# =============================================================================
+# ⚡ TILT SDK - VITE LIBRARY GENERATOR
+
+# === INLINED CONSTANTS for pure extension loading ===
+OUTPUT = struct(AUTOGENERATED_FOLDER = ".autogenerated")
+# === END INLINED CONSTANTS ===
+
+
+load('../../../../topologies/tilt/manifest/constants.star', 'GENERATED_CONFIG_FILENAMES')
+# =============================================================================
+# Path: .tilt/providers/vite/library.star
+# Purpose: Vite config generator for Library packages
+# =============================================================================
+
+load('./templates.star', 'TEMPLATE_VITE_LIBRARY')
+load('./helpers.star', 'build_header')
+
+# Constants for output paths
+VITE_LIBRARY_CONFIG_PATH = '/' + OUTPUT.AUTOGENERATED_FOLDER + '/' + GENERATED_CONFIG_FILENAMES['vite_library']
+
+def generate_library(manifest, write_fn=None):
+    """
+    Generate vite.config.ts for LIBRARY packages.
+    
+    Library-specific features:
+    1. vite-plugin-dts: Auto-generate .d.ts type definitions (only if in deps)
+    2. External all dependencies (peer deps pattern)
+    3. Both ESM and CJS output formats
+    4. Vitest for testing
+    """
+    resource_path = manifest.get('_resource_path', '')
+    app_name = manifest.get('appName', 'unknown')
+    
+    has_react = manifest.get('hasReact', False)
+    has_dts = manifest.get('hasDts', False)
+    
+    plugin_imports = ''
+    plugins = []
+    
+    if has_dts:
+        plugin_imports = "import dts from 'vite-plugin-dts';"
+        plugins.append('dts({ insertTypesEntry: true, tsconfigPath: resolve(__dirname, \'./tsconfig.autogenerated.json\') })')
+    
+    if has_react:
+        if plugin_imports:
+            plugin_imports += "\nimport react from '@vitejs/plugin-react';"
+        else:
+            plugin_imports = "import react from '@vitejs/plugin-react';"
+        plugins.insert(0, 'react()')
+    
+    plugins_str = ', '.join(plugins)
+    header = build_header('Vite.library()', app_name, 'Library (Build + DTS + Vitest)')
+    lib_name = app_name.replace('-', '_')
+    
+    config = TEMPLATE_VITE_LIBRARY.format(
+        header=header,
+        plugin_imports=plugin_imports,
+        plugins_str=plugins_str,
+        lib_name=lib_name,
+    )
+    
+    if write_fn:
+        write_fn(resource_path + VITE_LIBRARY_CONFIG_PATH, config)
+    
+    return config

package/engine/topologies/tilt/generators/vite/sdk.star

@@ -0,0 +1,73 @@
+# =============================================================================
+# ⚡ TILT SDK - VITE SDK GENERATOR
+
+# === INLINED CONSTANTS for pure extension loading ===
+OUTPUT = struct(AUTOGENERATED_FOLDER = ".autogenerated")
+# === END INLINED CONSTANTS ===
+
+
+load('../../../../topologies/tilt/manifest/constants.star', 'GENERATED_CONFIG_FILENAMES')
+# =============================================================================
+# Path: .tilt/providers/vite/sdk.star
+# Purpose: Vite config generator for SDK packages (Module Federation)
+# =============================================================================
+
+load('./templates.star', 'TEMPLATE_VITE_SDK')
+load('./helpers.star', 'build_header')
+
+# Constants for output paths
+VITE_SDK_CONFIG_PATH = '/' + OUTPUT.AUTOGENERATED_FOLDER + '/' + GENERATED_CONFIG_FILENAMES['vite_sdk']
+
+def generate_sdk(manifest, write_fn=None):
+    """
+    Generate vite.config.ts for SDK packages with Module Federation.
+    
+    SDK features:
+    1. @module-federation/vite for runtime module sharing
+    2. Exposes configured modules
+    3. Shared React/React-DOM as singletons
+    4. Remote entry generation
+    """
+    resource_path = manifest.get('_resource_path', '')
+    app_name = manifest.get('appName', 'unknown')
+    port = manifest.get('port', 3001)
+    
+    federation_name = app_name.replace('-', '_')
+    
+    exposes = manifest.get('federationExposes', {
+        './App': './src/App.tsx',
+        './client': './src/clients/main-client.ts',
+    })
+    
+    exposes_lines = []
+    for key, value in exposes.items():
+        exposes_lines.append("        '" + key + "': '" + value + "',")
+    exposes_str = '\n'.join(exposes_lines)
+    
+    shared_deps = manifest.get('federationShared', [
+        'react',
+        'react-dom',
+        'react-router-dom',
+        '@tanstack/react-query',
+        'zod',
+    ])
+    
+    shared_lines = []
+    for dep in shared_deps:
+        shared_lines.append("        '" + dep + "': { singleton: true },")
+    shared_str = '\n'.join(shared_lines)
+    
+    header = build_header('Vite.sdk()', app_name, 'SDK (Module Federation)')
+    
+    config = TEMPLATE_VITE_SDK.format(
+        header=header,
+        federation_name=federation_name,
+        port=port,
+        exposes_str=exposes_str,
+        shared_str=shared_str,
+    )
+    
+    if write_fn:
+        write_fn(resource_path + VITE_SDK_CONFIG_PATH, config)
+    
+    return config