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

package/engine/topologies/tilt/generators/typescript/backend_library_tsconfig.star

@@ -0,0 +1,71 @@
+# === INLINED CONSTANTS for pure extension loading ===
+OUTPUT = struct(AUTOGENERATED_FOLDER = ".autogenerated")
+# === END INLINED CONSTANTS ===
+
+
+load("../../../../topologies/tilt/common/utils.star", "Utils")
+load("../../../../topologies/tilt/manifest/constants.star", "GENERATED_CONFIG_FILENAMES")
+
+
+# =============================================================================
+# Backend Library TSConfig Generator (no JSX)
+# =============================================================================
+
+def generate_backend_library_tsconfig(resource_path, write_fn, internal_deps=None, is_docker=True):
+    """
+    Generate tsconfig for backend shared libraries (no JSX).
+
+    Args:
+        resource_path: Path to the resource directory
+        write_fn: Write function for file output
+        internal_deps: Optional internal dependencies map
+        is_docker: Whether generating for Docker context
+
+    Returns:
+        dict: Generated tsconfig content
+    """
+    base_url = "." if is_docker else ".."
+    out_dir = "./dist" if is_docker else "../dist"
+    include_src = "src" if is_docker else "../src"
+    exclude_prefix = "" if is_docker else "../"
+    paths = {
+        "@/*": ["./src/*"],
+        "@application/*": ["./src/application/*"],
+        "@domain/*": ["./src/domain/*"],
+        "@infrastructure/*": ["./src/infrastructure/*"],
+        "@presentation/*": ["./src/presentation/*"],
+    }
+    # NOTE: Do not add internal workspace path mappings for libraries.
+    # These mappings pull external sources into the program and break
+    # library builds that compile with `--rootDir src`.
+    content = {
+        "compilerOptions": {
+            "target": "ES2022",
+            "module": "ES2022",
+            "moduleResolution": "node",
+            "baseUrl": base_url,
+            "declaration": True,
+            "declarationMap": True,
+            "outDir": out_dir,
+            "paths": paths,
+            "skipLibCheck": True,
+            "strict": True,
+            "emitDecoratorMetadata": True,
+            "experimentalDecorators": True,
+            "esModuleInterop": True,
+            "forceConsistentCasingInFileNames": True
+        },
+        "exclude": [
+            exclude_prefix + "node_modules",
+            exclude_prefix + "dist",
+            exclude_prefix + "__tests__/**/*",
+            exclude_prefix + "**/*.test.ts",
+            exclude_prefix + "**/*.test.tsx",
+            exclude_prefix + "**/tests/**",
+        ],
+        "include": [include_src + "/**/*"]
+    }
+    if is_docker:
+        write_fn(resource_path + '/' + OUTPUT.AUTOGENERATED_FOLDER + '/' + GENERATED_CONFIG_FILENAMES['tsconfig_docker'], Utils.encode_json(content))
+    else:
+        write_fn(resource_path + '/' + OUTPUT.AUTOGENERATED_FOLDER + '/' + GENERATED_CONFIG_FILENAMES['tsconfig_local'], Utils.encode_json(content))

package/engine/topologies/tilt/generators/typescript/backend_tsconfig.star

@@ -0,0 +1,124 @@
+# === INLINED CONSTANTS for pure extension loading ===
+OUTPUT = struct(AUTOGENERATED_FOLDER = ".autogenerated")
+# === END INLINED CONSTANTS ===
+
+
+load("../../../../topologies/tilt/common/utils.star", "Utils")
+load("../../../../topologies/tilt/manifest/constants.star", "GENERATED_CONFIG_FILENAMES")
+
+
+# =============================================================================
+# Backend TSConfig Generator
+# =============================================================================
+
+def generate_backend_tsconfig(resource_path, prisma_path, write_fn, internal_deps=None, is_docker=True):
+    """
+    Generate tsconfig for backend services.
+
+    Args:
+        resource_path: Path to the service directory
+        prisma_path: Path to Prisma client
+        write_fn: Write function for file output
+        internal_deps: Optional internal dependencies map
+        is_docker: Whether generating for Docker context
+    """
+    # When tsconfig is in .autogenerated/ folder, paths are relative to parent
+    paths = {
+        "@/*": ["../src/*"],
+        "@application/*": ["../src/application/*"],
+        "@domain/*": ["../src/domain/*"],
+        "@infrastructure/*": ["../src/infrastructure/*"],
+        "@presentation/*": ["../src/presentation/*"],
+        "@prisma/client": [prisma_path]
+    }
+    root_dir = "../src"
+    if internal_deps and not is_docker:
+        sorted_deps = sorted(internal_deps.items())
+        depth = len([segment for segment in resource_path.split('/') if segment])
+        rel_to_root = "../" * depth
+        for pkg_name, src_path in sorted_deps:
+            paths[pkg_name] = [rel_to_root + src_path + "/src"]
+            paths[pkg_name + "/*"] = [rel_to_root + src_path + "/src/*"]
+    compiler_options = {
+        "target": "ES2022",
+        "module": "ES2022",
+        "moduleResolution": "bundler",
+        "paths": paths,
+        "skipLibCheck": True,
+        "strict": True,
+        "experimentalDecorators": True,
+        "emitDecoratorMetadata": True,
+        "esModuleInterop": True,
+        "forceConsistentCasingInFileNames": True,
+        "resolveJsonModule": True,
+        "allowSyntheticDefaultImports": True,
+        "outDir": "../dist",
+        "rootDir": root_dir,
+        "types": ["node"],
+    }
+    content = {
+        "compilerOptions": compiler_options,
+        "exclude": [
+            "node_modules",
+            "dist",
+            "../__tests__/**/*",
+            "../**/*.test.ts",
+            "../**/tests/**/*",
+            "../src/legacy/**/*",
+            "../**/*.steps.ts",
+            "../**/*.spec.ts"
+        ],
+        "include": ["../src/**/*"]
+    }
+    if is_docker:
+        # Docker tsconfig is copied to service root, so paths are relative to root
+        docker_paths = {
+            "@/*": ["./src/*"],
+            "@application/*": ["./src/application/*"],
+            "@domain/*": ["./src/domain/*"],
+            "@infrastructure/*": ["./src/infrastructure/*"],
+            "@presentation/*": ["./src/presentation/*"],
+            "@prisma/client": [prisma_path]
+        }
+        docker_root_dir = "./src"
+        if internal_deps:
+            sorted_deps = sorted(internal_deps.items())
+            depth = len([segment for segment in resource_path.split('/') if segment])
+            rel_to_root = "../" * depth
+            for pkg_name, src_path in sorted_deps:
+                docker_paths[pkg_name] = [rel_to_root + src_path + "/src"]
+                docker_paths[pkg_name + "/*"] = [rel_to_root + src_path + "/src/*"]
+        docker_compiler_options = {
+            "target": "ES2022",
+            "module": "ES2022",
+            "moduleResolution": "bundler",
+            "paths": docker_paths,
+            "skipLibCheck": True,
+            "strict": True,
+            "experimentalDecorators": True,
+            "emitDecoratorMetadata": True,
+            "esModuleInterop": True,
+            "forceConsistentCasingInFileNames": True,
+            "resolveJsonModule": True,
+            "allowSyntheticDefaultImports": True,
+            "outDir": "./dist",
+            "rootDir": docker_root_dir,
+            "types": ["node"],
+        }
+        docker_content = {
+            "compilerOptions": docker_compiler_options,
+            "exclude": [
+                "node_modules",
+                "dist",
+                "./__tests__/**/*",
+                "./**/*.test.ts",
+                "./**/tests/**/*",
+                "./src/legacy/**/*",
+                "./**/*.steps.ts",
+                "./**/*.spec.ts"
+            ],
+            "include": ["./src/**/*"]
+        }
+        write_fn(resource_path + '/' + OUTPUT.AUTOGENERATED_FOLDER + '/' + GENERATED_CONFIG_FILENAMES['tsconfig_docker'], Utils.encode_json(docker_content))
+    else:
+        write_fn(resource_path + '/' + OUTPUT.AUTOGENERATED_FOLDER + '/' + GENERATED_CONFIG_FILENAMES['tsconfig_local'], Utils.encode_json(content))

package/engine/topologies/tilt/generators/typescript/common.star

@@ -0,0 +1,7 @@
+# =============================================================================
+# Common helpers/constants for TSConfig providers
+# =============================================================================
+
+load("../../../../topologies/tilt/common/utils.star", "Utils")
+
+# Add any shared helpers/constants here as needed.

package/engine/topologies/tilt/generators/typescript/frontend_library_tsconfig.star

@@ -0,0 +1,76 @@
+# === INLINED CONSTANTS for pure extension loading ===
+OUTPUT = struct(AUTOGENERATED_FOLDER = ".autogenerated")
+# === END INLINED CONSTANTS ===
+
+
+load("../../../../topologies/tilt/common/utils.star", "Utils")
+load("../../../../topologies/tilt/manifest/constants.star", "GENERATED_CONFIG_FILENAMES")
+
+
+# =============================================================================
+# Frontend Library TSConfig Generator (with JSX)
+# =============================================================================
+
+def generate_frontend_library_tsconfig(resource_path, write_fn, internal_deps=None, is_docker=True):
+    """
+    Generate tsconfig for frontend shared libraries (with JSX support).
+
+    Args:
+        resource_path: Path to the resource directory
+        write_fn: Write function for file output
+        internal_deps: Optional internal dependencies map
+        is_docker: Whether generating for Docker context
+
+    Returns:
+        dict: Generated tsconfig content
+    """
+    base_url = "." if is_docker else ".."
+    out_dir = "./dist" if is_docker else "../dist"
+    include_src = "src" if is_docker else "../src"
+    exclude_prefix = "" if is_docker else "../"
+    paths = {
+        "@/*": ["./src/*"],
+        "@application/*": ["./src/application/*"],
+        "@domain/*": ["./src/domain/*"],
+        "@infrastructure/*": ["./src/infrastructure/*"],
+        "@presentation/*": ["./src/presentation/*"],
+    }
+    # NOTE: Do not add internal workspace path mappings for libraries.
+    # These mappings pull external sources into the program and break
+    # library builds that compile with `--rootDir src`.
+    content = {
+        "compilerOptions": {
+            "target": "ES2022",
+            "module": "ESNext",
+            "moduleResolution": "bundler",
+            "lib": ["DOM", "DOM.Iterable", "ESNext"],
+            "baseUrl": base_url,
+            "outDir": out_dir,
+            "rootDir": "src" if is_docker else "../src",
+            "paths": paths,
+            "skipLibCheck": True,
+            "strict": True,
+            "emitDecoratorMetadata": True,
+            "experimentalDecorators": True,
+            "esModuleInterop": True,
+            "forceConsistentCasingInFileNames": True,
+            "jsx": "react-jsx",
+            "allowSyntheticDefaultImports": True,
+            "resolveJsonModule": True
+        },
+        "exclude": [
+            exclude_prefix + "node_modules",
+            exclude_prefix + "dist",
+            exclude_prefix + "__tests__/**/*",
+            exclude_prefix + "**/*.test.ts",
+            exclude_prefix + "**/*.test.tsx",
+            exclude_prefix + "**/tests/**",
+            exclude_prefix + "**/*.stories.ts",
+            exclude_prefix + "**/*.stories.tsx",
+        ],
+        "include": [include_src + "/**/*", include_src + "/**/*.tsx"]
+    }
+    if is_docker:
+        write_fn(resource_path + '/' + OUTPUT.AUTOGENERATED_FOLDER + '/' + GENERATED_CONFIG_FILENAMES['tsconfig_docker'], Utils.encode_json(content))
+    else:
+        write_fn(resource_path + '/' + OUTPUT.AUTOGENERATED_FOLDER + '/' + GENERATED_CONFIG_FILENAMES['tsconfig_local'], Utils.encode_json(content))

package/engine/topologies/tilt/generators/typescript/frontend_tsconfig.star

@@ -0,0 +1,110 @@
+# === INLINED CONSTANTS for pure extension loading ===
+OUTPUT = struct(AUTOGENERATED_FOLDER = ".autogenerated")
+# === END INLINED CONSTANTS ===
+
+
+load("../../../../topologies/tilt/common/utils.star", "Utils")
+load("../../../../topologies/tilt/manifest/constants.star", "GENERATED_CONFIG_FILENAMES")
+
+
+# Check if verbose mode is enabled
+_is_verbose = os.environ.get('TILT_LOG_LEVEL') == 'verbose'
+
+# Module loaded - only show in verbose mode
+if _is_verbose:
+    print("🔥 frontend_tsconfig.star MODULE LOADED")
+
+# =============================================================================
+# Frontend TSConfig Generator
+# =============================================================================
+
+def generate_frontend_tsconfig(resource_path, write_fn, internal_deps=None, is_docker=True):
+    """
+    Generate tsconfig for frontend services.
+
+    Args:
+        resource_path: Path to the service directory
+        write_fn: Write function for file output
+        internal_deps: Optional internal dependencies map
+        is_docker: Whether generating for Docker context
+    """
+    # Check verbose mode
+    is_verbose = os.environ.get('TILT_LOG_LEVEL') == 'verbose'
+    
+    # DEBUG: Only print when function is called in verbose mode
+    if is_verbose:
+        print("🎯 TSConfig.frontend called: service={}, is_docker={}, has_internal_deps={}".format(
+            resource_path,
+            is_docker,
+            internal_deps != None
+        ))
+    # When tsconfig is in .autogenerated/ folder, paths are relative to parent
+    paths = {
+        "@/*": ["../src/*"],
+        "@/autogenerated/*": ["./.autogenerated/*"]
+    }
+    include_paths = ["../src/**/*"]
+    
+    # =============================================================================
+    # CRITICAL FIX: Only add path aliases for internal deps in LOCAL builds
+    # =============================================================================
+    # In Docker builds, these path aliases cause "Module not found" errors
+    # because the source files aren't copied to the Docker context.
+    # 
+    # Docker builds should resolve from node_modules instead.
+    # =============================================================================
+    
+    if internal_deps and not is_docker:
+        # LOCAL BUILD: Can use path aliases to source for faster development
+        sorted_deps = sorted(internal_deps.items())
+        for pkg_name, src_path in sorted_deps:
+            depth = len([segment for segment in resource_path.split('/') if segment])
+            rel_to_root = "../" * depth
+            paths[pkg_name] = [rel_to_root + src_path + "/src"]
+            paths[pkg_name + "/*"] = [rel_to_root + src_path + "/src/*"]
+    
+    # If is_docker=True and internal_deps exist, warn about it
+    if internal_deps and is_docker:
+        if is_verbose:
+            print("📝 Note: Excluding {} path aliases from Docker tsconfig for {}".format(
+                len(internal_deps),
+                resource_path
+            ))
+            print("   Docker build will resolve @{npm_scope}/* from node_modules")
+    content = {
+        "compilerOptions": {
+            "target": "ES2022",
+            "module": "ES2022",
+            "moduleResolution": "node",
+            "lib": ["dom", "dom.iterable", "esnext"],
+            "jsx": "react-jsx",
+            "paths": paths,
+            "skipLibCheck": True,
+            "strict": True,
+            "types": ["node"],
+        },
+        "exclude": [
+            "node_modules",
+            "dist",
+            "../__tests__/**/*",
+            "../**/*.test.ts",
+            "../**/tests/**/*",
+            "../**/*.steps.ts",
+            "../**/*.spec.ts"
+        ],
+        "include": include_paths
+    }
+    if is_docker:
+        output_path = resource_path + '/' + OUTPUT.AUTOGENERATED_FOLDER + '/' + GENERATED_CONFIG_FILENAMES['tsconfig_docker']
+        if is_verbose:
+            print("📝 DEBUG: Writing Docker tsconfig to: {}".format(output_path))
+        write_fn(output_path, Utils.encode_json(content))
+        if is_verbose:
+            print("📝 DEBUG: Docker tsconfig write complete")
+    else:
+        output_path = resource_path + '/' + OUTPUT.AUTOGENERATED_FOLDER + '/' + GENERATED_CONFIG_FILENAMES['tsconfig_local']
+        if is_verbose:
+            print("📝 DEBUG: Writing Local tsconfig to: {}".format(output_path))
+        write_fn(output_path, Utils.encode_json(content))
+
+DEBUG = {}

package/engine/topologies/tilt/generators/typescript/include.star

@@ -0,0 +1,23 @@
+# =============================================================================
+# Entry point for modular TSConfig provider
+# =============================================================================
+
+load("./backend_tsconfig.star", "generate_backend_tsconfig")
+load("./frontend_tsconfig.star", "generate_frontend_tsconfig")
+load("./prisma_config.star", "generate_prisma_config")
+load("./frontend_library_tsconfig.star", "generate_frontend_library_tsconfig")
+load("./backend_library_tsconfig.star", "generate_backend_library_tsconfig")
+load("./playwright_config.star", "generate_playwright_config")
+
+# =============================================================================
+# TSConfig Struct - Public API
+# =============================================================================
+
+TSConfig = struct(
+    backend = generate_backend_tsconfig,
+    frontend = generate_frontend_tsconfig,
+    library_backend = generate_backend_library_tsconfig,
+    library_frontend = generate_frontend_library_tsconfig,
+    prisma = generate_prisma_config,
+    playwright = generate_playwright_config,
+)

package/engine/topologies/tilt/generators/typescript/playwright_config.star

@@ -0,0 +1,40 @@
+# =============================================================================
+# 🎭 TILT SDK - PLAYWRIGHT CONFIG GENERATOR (free-tier stub)
+# =============================================================================
+# Path: .tilt/providers/typescript/playwright_config.star
+# =============================================================================
+# The real generator is part of a paid TDK license. When a valid license
+# grants the "playwright" 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 generator pipeline changes.
+# =============================================================================
+
+load('../../../../topologies/tilt/common/utils.star', 'Utils')
+load('../../../../topologies/tilt/manifest/constants.star', 'GENERATED_CONFIG_FILENAMES')
+
+OUTPUT = struct(AUTOGENERATED_FOLDER = ".autogenerated")
+
+_STUB_NOTICE = """// Playwright e2e config generation is a paid TDK feature.
+// Run `tdk upgrade` to enable generated Playwright configs for this service.
+"""
+
+
+def generate_playwright_config(resource_path, resource_type='backend', write_fn=None):
+    """
+    Free-tier stub - see module header. Signature matches the licensed
+    implementation so callers never need to know which one is active.
+    """
+    resource_name = resource_path.split('/')[-1]
+    header = Utils.get_template_header(
+        GENERATED_CONFIG_FILENAMES['playwright'],
+        'TypeScript.generate_playwright_config() [unlicensed stub]',
+        resource_name,
+        resource_type.upper()
+    )
+    content = header + _STUB_NOTICE
+
+    if write_fn:
+        write_fn(resource_path + '/' + OUTPUT.AUTOGENERATED_FOLDER + '/' + GENERATED_CONFIG_FILENAMES['playwright'], content)
+
+    return content

package/engine/topologies/tilt/generators/typescript/prisma_config.star

@@ -0,0 +1,49 @@
+# === INLINED CONSTANTS for pure extension loading ===
+OUTPUT = struct(AUTOGENERATED_FOLDER = ".autogenerated")
+# === END INLINED CONSTANTS ===
+
+
+load("../../../../topologies/tilt/common/utils.star", "Utils")
+load("../../../../topologies/tilt/manifest/constants.star", "GENERATED_CONFIG_FILENAMES")
+
+
+# =============================================================================
+# Prisma Config Generator
+# =============================================================================
+
+def generate_prisma_config(resource_path, resource_name, db_name, write_fn):
+    """
+    Generate prisma.config.autogenerated.ts for Prisma v7 CLI configuration.
+
+    Args:
+        resource_path: Path to the resource directory
+        resource_name: Name of the resource
+        db_name: Name of the database
+        write_fn: Write function for file output
+
+    Returns:
+        str: Generated Prisma config content
+    """
+    resource_display_name = resource_name
+
+    header = Utils.get_template_header(
+        GENERATED_CONFIG_FILENAMES['prisma'],
+        'TypeScript.prisma()',
+        resource_display_name,
+        'Prisma Configuration'
+    )
+    content = """/**
+ * AUTOGENERATED Prisma CLI Configuration - %s Service
+ *
+ * This config is used by Prisma CLI commands (generate, migrate, db push).
+ */
+export default {
+  schema: 'prisma/schema.prisma',
+  datasource: {
+    url: process.env.DATABASE_URL,
+  },
+};
+""" % (resource_name)
+    
+    if write_fn:
+        write_fn(resource_path + '/' + OUTPUT.AUTOGENERATED_FOLDER + '/' + GENERATED_CONFIG_FILENAMES['prisma'], content)