@tdk-landscape/tdk-cli-core 1.3.14 → 1.3.22

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

@@ -0,0 +1,258 @@
+# =============================================================================
+# 🧪 TILT SDK - ENV GENERATORS
+# =============================================================================
+# Path: .tilt/provisioner/orchestrator/generators/env.star
+# Purpose: Environment file generation helpers
+# =============================================================================
+
+# === INLINED CONSTANTS for pure extension loading ===
+BASE_PORT_FRONTEND = 3000
+BASE_PORT_BACKEND = 4000
+OUTPUT = struct(AUTOGENERATED_FOLDER = ".autogenerated")
+# === END INLINED CONSTANTS ===
+
+
+load("../../../../platform/docker/auth/auth.star", "AuthConfig")
+load("../../../../platform/docker/networking/traefik_helpers.star", "get_api_path")
+load("../../../../platform/docker/constants.star", "PlatformDockerConstants")
+
+
+
+def _normalize_dependency_path(dependency):
+    dep = str(dependency).strip()
+    if not dep:
+        return ''
+
+    if dep.endswith('-management-backend'):
+        return dep.replace('-management-backend', '')
+
+    if dep.endswith('-backend'):
+        return dep[:-8]
+
+    if dep.endswith('-frontend'):
+        return dep[:-9]
+
+    return dep
+
+
+def _dependency_env_key(dependency):
+    dep = str(dependency).upper()
+    key = ''
+    for i in range(len(dep)):
+        char = dep[i]
+        if (char >= 'A' and char <= 'Z') or (char >= '0' and char <= '9'):
+            key += char
+        else:
+            key += '_'
+    while '__' in key:
+        key = key.replace('__', '_')
+    return key.strip('_')
+
+
+def _build_dependency_env_lines(manifest):
+    dependencies = manifest.get('dependencies', manifest.get('dependsOn', []))
+    if not dependencies:
+        return ''
+
+    # Deduplicate while preserving first-seen order.
+    seen = {}
+    ordered = []
+    for dep in dependencies:
+        dep_path = _normalize_dependency_path(dep)
+        if dep_path and not seen.get(dep_path, False):
+            seen[dep_path] = True
+            ordered.append(dep_path)
+
+    if not ordered:
+        return ''
+
+    lines = '\n# Dependency API URLs (using standardized /api/v1 paths)\n'
+    for dep_path in ordered:
+        dep_key = _dependency_env_key(dep_path)
+        # Use standardized API path from traefik helpers
+        dep_api_path = get_api_path(dep_path)
+        lines += 'VITE_{dep_key}_API_URL=http://{local_domain}{dep_api_path}\n'.format(
+            dep_key=dep_key,
+            dep_api_path=dep_api_path,
+            local_domain=PlatformDockerConstants.LOCAL_DOMAIN,
+        )
+    return lines
+
+
+def _generate_params_env(manifest, backend_manifest=None, write_fn=None):
+    """Generate params (non-secret) environment variables from manifest.
+
+    This generates config like BASE_URL, PORT, etc. - NEVER secrets.
+    Secrets are handled separately by _generate_secrets_env().
+
+    Args:
+        manifest: Service manifest dict with configuration
+        backend_manifest: Optional backend manifest for frontend services
+        write_fn: Optional write function for file output (callable)
+
+    Returns:
+        str: Generated environment file content
+    """
+    resource_path = manifest.get('_resource_path', '')
+    app_type = manifest.get('appType', 'backend')
+    stack = manifest.get('stack', 'app')
+    port = manifest.get('port', BASE_PORT_FRONTEND)
+    # Use standardized API path from traefik helpers
+    api_path = get_api_path(stack)
+    api_url = 'http://' + PlatformDockerConstants.LOCAL_DOMAIN + api_path
+    target_filename = '/' + OUTPUT.AUTOGENERATED_FOLDER + '/.env.backend.autogenerated'
+    
+    # Auth configuration - support both identity service and local JWT modes
+    # Use centralized auth utilities for consistency
+    # Extract auth config from manifest to pass as a separate dict
+    # Auto-detect identity-service mode if 'identity' is in dependsOn
+    internal_deps = manifest.get('dependsOn', []) if manifest else []
+    has_identity_dep = 'identity' in internal_deps
+    
+    # If manifest has authMode, use it; otherwise auto-detect based on identity dependency
+    manifest_auth_mode = manifest.get('authMode') if manifest else None
+    if manifest_auth_mode:
+        auth_mode = manifest_auth_mode
+    elif has_identity_dep:
+        auth_mode = 'identity-service'
+    else:
+        auth_mode = None
+    
+    auth_config = {
+        'authMode': auth_mode,
+        'jwtSecret': manifest.get('jwtSecret') if manifest else None,
+        'identityServiceUrl': manifest.get('identityServiceUrl') if manifest else None,
+    }
+    
+    # If we auto-detected identity-service mode but no URL is set, use default
+    if auth_mode == 'identity-service' and not auth_config['identityServiceUrl']:
+        auth_config['identityServiceUrl'] = AuthConfig.get_identity_resource_url(None)
+    
+    if app_type == 'frontend':
+        backend_port = backend_manifest.get('port', BASE_PORT_BACKEND) if backend_manifest else BASE_PORT_BACKEND
+        backend_name = manifest.get('backendName', stack + '-backend')
+        target_filename = '/' + OUTPUT.AUTOGENERATED_FOLDER + '/.env.frontend.autogenerated'
+        
+        # Get basePath from manifest or default to /{stack}
+        base_path = manifest.get('basePath', '/' + stack)
+        public_url = 'http://' + PlatformDockerConstants.LOCAL_DOMAIN + base_path
+        
+        content = """# Generated by Tilt SDK - DO NOT EDIT
+# Frontend Environment Variables
+VITE_API_PORT={backend_port}
+VITE_API_URL={api_url}
+VITE_BACKEND_NAME={backend_name}
+PUBLIC_URL={public_url}
+""".format(
+    backend_port=backend_port,
+    api_url=api_url,
+    backend_name=backend_name,
+    public_url=public_url,
+)
+        content += _build_dependency_env_lines(manifest)
+    else:
+        db_name = manifest.get('databaseName', PlatformDockerConstants.get_db_name(stack))
+        
+        content = """# Generated by Tilt SDK - DO NOT EDIT
+# Backend Environment Variables
+PORT={port}
+DATABASE_NAME={db_name}
+API_URL={api_url}
+""".format(port=port, db_name=db_name, api_url=api_url)
+        
+        if manifest.get('usePrisma', True):
+            content += """
+# Prisma
+DATABASE_URL=""" + PlatformDockerConstants.get_database_url_for_env(db_name) + """
+"""
+        
+        # Add authentication configuration using centralized auth utilities
+        content += AuthConfig.generate_env_file_auth_section(auth_config)
+    
+    # Add params (non-secret config variables)
+    # NOTE: Secrets are NEVER added here - they come from Infisical only
+    params = manifest.get('params', manifest.get('envVars', {}))  # Fallback to envVars during migration
+    if params:
+        content += '\n# Params (non-secret config)\n'
+        # Sort keys for deterministic output to avoid unnecessary file rewrites.
+        for key in sorted(params.keys()):
+            value = params.get(key)
+            content += key + '=' + str(value) + '\n'
+    
+    if write_fn and resource_path:
+        write_fn(resource_path + target_filename, content)
+    
+    return content
+
+
+def _generate_secrets_env(manifest, write_fn=None):
+    """Generate secrets environment variables from Infisical.
+
+    This function returns a dict of secrets that will be resolved
+    from Infisical at runtime. The actual values are NOT embedded here.
+
+    CRITICAL: This function NEVER reads secrets from files - only from Infisical.
+
+    Args:
+        manifest: Service manifest dict with secrets configuration
+        write_fn: Optional write function for file output (callable)
+
+    Returns:
+        dict: Map of secret names to Infisical placeholder values
+    """
+    resource_path = manifest.get('_resource_path', '')
+    secrets_config = manifest.get('secrets', {})
+    
+    if not secrets_config:
+        return {}
+    
+    required = secrets_config.get('required', [])
+    optional = secrets_config.get('optional', [])
+    
+    # Build a placeholder map - actual values come from Infisical at runtime
+    secrets_env = {}
+    
+    for secret_name in required:
+        # Placeholder - value resolved by Infisical
+        secrets_env[secret_name] = "${INFISICAL_SECRET:" + secret_name + "}"
+    
+    for secret_name in optional:
+        # Placeholder - value resolved by Infisical
+        secrets_env[secret_name] = "${INFISICAL_SECRET:" + secret_name + "}"
+    
+    return secrets_env
+
+
+def _get_all_env(manifest, backend_manifest=None, write_fn=None):
+    """Generate complete environment (params + secrets placeholder).
+
+    Returns a dict with both params and secrets keys.
+    Actual secret values resolved by Infisical at container runtime.
+
+    Args:
+        manifest: Service manifest dict with configuration
+        backend_manifest: Optional backend manifest for frontend services
+        write_fn: Optional write function for file output (callable)
+
+    Returns:
+        dict: Contains 'params' (str) and 'secrets' (dict) keys
+    """
+    # Phase 1: Generate params (non-secret config)
+    params_content = _generate_params_env(manifest, backend_manifest, write_fn)
+    
+    # Phase 2: Get secrets configuration (resolved by Infisical)
+    secrets_env = _generate_secrets_env(manifest, write_fn)
+    
+    return {
+        'params': params_content,
+        'secrets': secrets_env,
+    }
+
+
+EnvGenerators = struct(
+    generate_params_env = _generate_params_env,
+    generate_secrets_env = _generate_secrets_env,
+    get_all_env = _get_all_env,
+    # Legacy alias for backward compatibility during migration
+    generate_env_file = _generate_params_env,
+)

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

@@ -0,0 +1,169 @@
+# =============================================================================
+# 🎨 TILT SDK - FRONTEND API CLIENT GENERATORS
+# =============================================================================
+# Purpose: Generate api-client.ts, env.ts, and index.ts for frontend services
+#          These files import from @{npm_scope}/platform-api-client package
+# =============================================================================
+
+# Load npm scope from project.json
+# 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()
+
+load("../../../../platform/docker/networking/traefik_helpers.star", "get_api_path")
+load("../../../../platform/docker/constants.star", "PlatformDockerConstants")
+load("./dependencies/resolver.star", "resolve_backend_api_path")
+
+def generate_frontend_api_client(manifest, write_fn=None):
+    """Generate .autogenerated/api-client.ts for a frontend resource.
+
+    Args:
+        manifest: Resource manifest with stack field
+        write_fn: Optional function to write file (for Tilt)
+
+    Returns:
+        str: Generated file content
+    """
+    stack = manifest.get("stack", "app")
+
+    # Auto-resolve apiPath from backend manifest if backendName is specified
+    backend_api_path = resolve_backend_api_path(manifest)
+    if backend_api_path:
+        api_path = backend_api_path
+    else:
+        api_path = get_api_path(stack, manifest)
+
+    content = '''// 🛑 GENERATED BY TILT SDK - DO NOT EDIT
+// Source: engine/topologies/tilt/resources/orchestrator/generators/frontend.star
+// Purpose: Pre-configured API client for {stack} resource
+
+import {{ createApiClient }} from '@" + _NPM_SCOPE + "'/platform-api-client';
+
+/**
+ * Pre-configured API client for {stack} resource
+ *
+ * Usage:
+ * ```typescript
+ * import {{ apiClient }} from '../.autogenerated/api-client';
+ * const data = await apiClient.get('/');
+ * ```
+ */
+export const apiClient = createApiClient({{
+  baseURL: import.meta.env.VITE_API_URL || 'http://{local_domain}{api_path}',
+  withAuth: true,
+}});
+
+export default apiClient;
+'''.format(
+        stack=stack,
+        api_path=api_path,
+        local_domain=PlatformDockerConstants.API_LOCAL_DOMAIN,
+    )
+    
+    if write_fn:
+        resource_path = manifest.get('_resource_path', '')
+        write_fn(resource_path + '/.autogenerated/api-client.ts', content)
+
+    return content
+
+
+def generate_frontend_env_ts(manifest, write_fn=None):
+    """Generate .autogenerated/env.ts for a frontend resource.
+
+    Args:
+        manifest: Resource manifest with stack field
+        write_fn: Optional function to write file (for Tilt)
+
+    Returns:
+        str: Generated file content
+    """
+    stack = manifest.get("stack", "app")
+
+    # Auto-resolve apiPath from backend manifest if backendName is specified
+    backend_api_path = resolve_backend_api_path(manifest)
+    if backend_api_path:
+        api_path = backend_api_path
+    else:
+        api_path = get_api_path(stack, manifest)
+
+    content = '''// 🛑 GENERATED BY TILT SDK - DO NOT EDIT
+// Source: .tilt/topologies/tilt/resources/orchestrator/generators/frontend.star
+// Purpose: Environment constants for {stack} resource
+
+/**
+ * Base API URL for {stack} resource
+ * Uses VITE_API_URL env var with fallback to local dev URL
+ */
+export const API_URL = import.meta.env.VITE_API_URL || 'http://{local_domain}{api_path}';
+'''.format(
+        stack=stack,
+        api_path=api_path,
+        local_domain=PlatformDockerConstants.API_LOCAL_DOMAIN,
+    )
+    
+    if write_fn:
+        resource_path = manifest.get('_resource_path', '')
+        write_fn(resource_path + '/.autogenerated/env.ts', content)
+
+    return content
+
+
+def generate_frontend_api_index(manifest, write_fn=None):
+    """Generate .autogenerated/api-index.ts for clean imports.
+
+    Args:
+        manifest: Service manifest
+        write_fn: Optional function to write file (for Tilt)
+
+    Returns:
+        str: Generated file content
+    """
+    content = '''// 🛑 GENERATED BY TILT SDK - DO NOT EDIT
+// Source: .tilt/topologies/tilt/resources/orchestrator/generators/frontend.star
+// Purpose: Clean barrel exports for API client
+
+export { apiClient } from './api-client';
+export { API_URL } from './env';
+'''
+    
+    if write_fn:
+        resource_path = manifest.get('_resource_path', '')
+        write_fn(resource_path + '/.autogenerated/api-index.ts', content)
+
+    return content
+
+
+def generate_all_frontend_api_files(manifest, write_fn=None):
+    """Generate all frontend API files for a service.
+
+    Args:
+        manifest: Service manifest
+        write_fn: Function to write files
+
+    Returns:
+        dict: Generated content for each file
+    """
+    return {
+        'api-client.ts': generate_frontend_api_client(manifest, write_fn),
+        'env.ts': generate_frontend_env_ts(manifest, write_fn),
+        'api-index.ts': generate_frontend_api_index(manifest, write_fn),
+    }
+
+
+# Export struct for easy importing
+FrontendGenerators = struct(
+    generate_api_client = generate_frontend_api_client,
+    generate_env_ts = generate_frontend_env_ts,
+    generate_api_index = generate_frontend_api_index,
+    generate_all = generate_all_frontend_api_files,
+)