@tdk-landscape/tdk-cli-core 1.3.52 → 1.3.54

package/cli/src/utils/validation.ts

@@ -1,67 +0,0 @@
-import type { ValidationResult } from "../types/index.js";
-import { OPTIONAL_INFRA_SERVICES } from "./constants.js";
-
-export const KEBAB_CASE_REGEX = /^[a-z0-9-]+$/;
-
-function isKebabCase(value: string): boolean {
-  return KEBAB_CASE_REGEX.test(value);
-}
-
-export function validateResourceName(name: string): ValidationResult {
-  if (!name.trim()) {
-    return { valid: false, error: "Resource name is required" };
-  }
-  if (!isKebabCase(name)) {
-    return {
-      valid: false,
-      error: "Use lowercase letters, numbers, and hyphens only",
-    };
-  }
-  return { valid: true };
-}
-
-export function createKebabCaseValidator(context: "resource" | "stack") {
-  return (input: string): true | string => {
-    if (!input.trim()) {
-      return context === "resource" ? "Resource name is required" : "Stack name is required";
-    }
-    if (!isKebabCase(input)) {
-      return context === "resource"
-        ? "Use lowercase letters, numbers, and hyphens only"
-        : "Use kebab-case (lowercase, numbers, hyphens only)";
-    }
-    return true;
-  };
-}
-
-export function validateOptionalInfraService(service: string): ValidationResult {
-  if (includes(OPTIONAL_INFRA_SERVICES, service)) {
-    return { valid: true };
-  }
-  return {
-    valid: false,
-    error: `Invalid service. Must be one of: ${OPTIONAL_INFRA_SERVICES.join(", ")}`,
-  };
-}
-
-export function isValidPort(port: number): boolean {
-  return Number.isInteger(port) && port > 0 && port <= 65535;
-}
-
-/**
- * Check a filesystem path segment for characters that are unsafe to use in a
- * path (null bytes, or characters that are invalid on common filesystems).
- * Does not check for path traversal (`..`) - callers that resolve the path
- * against a base directory should check that separately.
- */
-export function isPathSafe(path: string): boolean {
-  return !path.includes("\0") && !/[<>:"|?*]/.test(path);
-}
-
-export function sanitizeForShell(value: string, replacement: string = "_"): string {
-  return value.replace(/[^a-zA-Z0-9-]/g, replacement).substring(0, 100);
-}
-
-export function includes<T extends readonly string[]>(array: T, value: string): value is T[number] {
-  return (array as readonly string[]).includes(value);
-}

package/cli/tsconfig.json

@@ -1,25 +0,0 @@
-{
-  "compilerOptions": {
-    "target": "ES2022",
-    "module": "ESNext",
-    "moduleResolution": "bundler",
-    "lib": ["ES2022", "DOM"],
-    "types": ["node", "react"],
-    "outDir": "./dist",
-    "rootDir": "./src",
-    "strict": true,
-    "esModuleInterop": true,
-    "skipLibCheck": true,
-    "forceConsistentCasingInFileNames": true,
-    "declaration": true,
-    "declarationMap": true,
-    "sourceMap": true,
-    "resolveJsonModule": true,
-    "allowSyntheticDefaultImports": true,
-    "isolatedModules": true,
-    "noEmitOnError": true,
-    "jsx": "react-jsx"
-  },
-  "include": ["src/**/*"],
-  "exclude": ["node_modules", "dist", "**/*.test.ts"]
-}

package/cli/tsconfig.typecheck.json

@@ -1,8 +0,0 @@
-{
-  "extends": "./tsconfig.json",
-  "compilerOptions": {
-    "noEmit": true
-  },
-  "include": ["src/**/*"],
-  "exclude": ["node_modules", "dist"]
-}

package/docs/FEATURES.md

@@ -1,279 +0,0 @@
-# TDK Features Reference
-
-This document describes all available features in TDK and how to control them.
-
-## Overview
-
-TDK has two levels of feature control:
-
-1. **Project-Level Features** - Infrastructure services available to all resources (proxy, database, etc.)
-2. **Resource-Level Features** - Code generators for individual services (api-client, prisma, etc.)
-
----
-
-## Project-Level Features
-
-Project-level features are configured in `.tdk/project.json` and control infrastructure services.
-
-### CORE Features (Pre-Enabled)
-
-These are always enabled in the `pre_alpha` stack:
-
-#### `proxy` (Traefik)
-- **Purpose**: Reverse proxy and API gateway for routing all services
-- **Default**: ✅ Enabled
-- **Service Name**: `proxy`
-- **Port**: 80 (HTTP), 443 (HTTPS)
-- **Configuration**: Routes all HTTP traffic based on path/domain rules
-
-#### `database-management` (PostgreSQL)
-- **Purpose**: Primary relational database for data persistence
-- **Default**: ✅ Enabled
-- **Service Name**: `database-management`
-- **Port**: 5432
-- **Database**: `app_dev` (default)
-- **Configuration**: Backend services use `DATABASE_URL` env var
-
-### PREMIUM Features (Requires License Key)
-
-Enable these with a premium license key set via `export TDK_LICENSE_KEY=<key>`:
-
-#### `verdaccio` (Verdaccio)
-- **Purpose**: Local npm registry for package management and publishing
-- **Default**: ❌ Disabled (Premium feature)
-- **Service Name**: `verdaccio`
-- **Port**: 4873
-- **License**: Premium (requires `TDK_LICENSE_KEY` environment variable)
-- **Configuration**: Services use this for `npm install` and `bun install` when enabled
-
-### OPTIONAL Features (Disabled by Default)
-
-Enable these in `.tdk/project.json` under `optional_infra`:
-
-```json
-{
-  "optional_infra": {
-    "monitoring": true,
-    "elk": true,
-    "debezium": true,
-    "golden_image": true
-  }
-}
-```
-
-#### `monitoring` (SigNoz/SkyWalking)
-- **Purpose**: Observability platform for metrics, traces, and logs
-- **Default**: ❌ Disabled
-- **Resource Usage**: High (requires database-management)
-
-#### `elk` (Elasticsearch, Logstash, Kibana)
-- **Purpose**: Log aggregation and analysis stack
-- **Default**: ❌ Disabled
-- **Resource Usage**: High
-
-#### `debezium` (Change Data Capture)
-- **Purpose**: Stream database changes in real-time
-- **Default**: ❌ Disabled
-- **Requires**: PostgreSQL (database-management)
-
-#### `golden-image` (Pre-built Docker Layer)
-- **Purpose**: Faster Docker builds by caching dependencies
-- **Default**: ✅ Enabled
-- **Benefit**: Reduces build time from minutes to seconds
-
-### Enable/Disable
-
-To enable optional or premium features, edit `.tdk/project.json`:
-
-```bash
-# Edit .tdk/project.json
-{
-  "optional_infra": {
-    "monitoring": true,    # Optional feature (Free)
-    "verdaccio": true      # Premium feature (requires TDK_LICENSE_KEY)
-  }
-}
-
-# Regenerate
-tdk config regenerate
-```
-
-**For Premium Features:** Set your license key before running `tdk up`:
-
-```bash
-export TDK_LICENSE_KEY=<your-premium-key>
-tdk up
-```
-
----
-
-## Resource-Level Features
-
-Resource-level features are configured in each `service.json` file via the `features: []` array.
-
-### Frontend Services
-
-Default features for frontend services (appType: "frontend"):
-
-```json
-{
-  "appName": "my-app",
-  "appType": "frontend",
-  "features": ["api-client", "env-config", "api-index"]
-}
-```
-
-#### `api-client`
-- **Generates**: `.autogenerated/api-client.ts`
-- **Purpose**: Pre-configured API client wrapper for backend communication
-- **Imports**: `import { apiClient } from './.autogenerated/api-client'`
-- **Customize**: Edit `service.json` → `apiClient` config section
-
-#### `env-config`
-- **Generates**: `.autogenerated/env.ts`
-- **Purpose**: Environment constants and configuration
-- **Imports**: `import { API_URL } from './.autogenerated/env'`
-- **Default**: Uses `VITE_API_URL` env var with fallback to local dev URL
-
-#### `api-index`
-- **Generates**: `.autogenerated/api-index.ts`
-- **Purpose**: Barrel export for cleaner imports
-- **Imports**: `import { apiClient, API_URL } from './.autogenerated'`
-
-### Backend Services
-
-Default features for backend services (appType: "backend", "worker", "migrator"):
-
-```json
-{
-  "appName": "my-api",
-  "appType": "backend",
-  "features": ["prisma"]
-}
-```
-
-#### `prisma`
-- **Generates**: `.autogenerated/prisma.config.autogenerated.ts`
-- **Purpose**: Prisma CLI configuration for database access
-- **Usage**: `npx prisma generate`, `npx prisma migrate`, `npx prisma db push`
-- **Database**: Uses `DATABASE_URL` env var from project-level database
-
-#### `ddd` (Premium)
-- **Generates**: Domain-driven design folders and backend path aliases
-- **Purpose**: Scaffolds `domain`, `application`, `infrastructure`, and `presentation` layers
-- **License**: Premium (requires `TDK_LICENSE_KEY` with the `ddd` resource grant)
-- **Usage**: `tdk resource add <name> --type backend --ddd`
-
-### Enable/Disable Features
-
-**To enable a feature**, add it to `features: []`:
-
-```json
-{
-  "features": ["api-client", "env-config", "api-index", "prisma"]
-}
-```
-
-**To disable a feature**, remove it from `features: []`:
-
-```json
-{
-  "features": ["api-client"]  // Only api-client runs
-}
-```
-
-After editing `service.json`, regenerate:
-
-```bash
-tdk config regenerate
-```
-
----
-
-## Always-Enabled Generators
-
-These generators always run and don't have a feature flag:
-
-- **vite** - Frontend/backend build configuration
-- **tsconfig** - TypeScript configuration (local and Docker)
-- **dockerfile** - Container configuration
-- **npmrc/bunfig** - Package manager configuration
-- **nginx** - Static file serving (frontend)
-- **env** - Backend environment setup
-- **agents-md** - AI safety guard rail
-
----
-
-## Quick Reference
-
-### Frontend (appType: "frontend")
-
-| Feature | Default | Customizable |
-|---------|---------|--------------|
-| api-client | ✅ | Yes |
-| env-config | ✅ | Yes |
-| api-index | ✅ | Yes |
-| vite | ✅ (always) | No |
-| tsconfig | ✅ (always) | No |
-| dockerfile | ✅ (always) | No |
-| nginx | ✅ (always) | No |
-
-### Backend (appType: "backend")
-
-| Feature | Default | Customizable |
-|---------|---------|--------------|
-| prisma | ✅ | Yes |
-| ddd | ❌ | Yes (Premium) |
-| vite | ✅ (always) | No |
-| tsconfig | ✅ (always) | No |
-| dockerfile | ✅ (always) | No |
-| npmrc | ✅ (always) | No |
-| env | ✅ (always) | No |
-
-### Project Infrastructure
-
-| Feature | Default | Customizable | License |
-|---------|---------|--------------|---------|
-| proxy | ✅ | No | Free |
-| database | ✅ | No | Free |
-| verdaccio | ❌ | Yes | Premium |
-| monitoring | ❌ | Yes | Free |
-| elk | ❌ | Yes | Free |
-| debezium | ❌ | Yes | Free |
-| golden-image | ✅ | Yes | Free |
-
----
-
-## Examples
-
-### Disable API Client Generation
-
-```json
-{
-  "appName": "dashboard-app",
-  "appType": "frontend",
-  "features": ["env-config", "api-index"]  // Remove api-client
-}
-```
-
-### Backend Without Prisma
-
-```json
-{
-  "appName": "worker",
-  "appType": "backend",
-  "features": []  // No prisma
-}
-```
-
-### Enable Monitoring
-
-```json
-{
-  "optional_infra": {
-    "monitoring": true
-  }
-}
-```
-
-Then run `tdk config regenerate && tdk up`.