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

package/cli/src/utils/env-validator.ts

@@ -1,139 +0,0 @@
-import { randomBytes } from "node:crypto";
-import { existsSync, readFileSync, writeFileSync } from "node:fs";
-import { join } from "node:path";
-
-export interface EnvVariable {
-  name: string;
-  description: string;
-  required: boolean;
-  default?: string;
-  example?: string;
-}
-
-const REQUIRED_ENV_VARS: EnvVariable[] = [
-  {
-    name: "VERDACCIO_URL_DOCKER",
-    description: "Docker-internal URL for npm registry",
-    required: true,
-    default: "http://verdaccio:4873",
-    example: "http://verdaccio:4873",
-  },
-  {
-    name: "VERDACCIO_URL",
-    description: "Local development URL for npm registry",
-    required: false,
-    default: "http://localhost:4873",
-  },
-  {
-    name: "TILT_ENV",
-    description: "Tilt environment name",
-    required: true,
-    default: "dev",
-    example: "dev",
-  },
-  {
-    name: "DATABASE_URL",
-    description: "PostgreSQL connection string",
-    required: false,
-    default: "postgresql://postgres:postgres@postgres:5432/app_dev",
-  },
-  {
-    name: "DB_PASSWORD",
-    description: "PostgreSQL superuser password (docker-compose POSTGRES_PASSWORD)",
-    required: true,
-    // No static default: a shared password across every generated project is a
-    // credential leak waiting to happen. generateEnvFile() fills this one in with
-    // a fresh random value per project instead.
-    example: "postgres",
-  },
-];
-
-function generateDbPassword(): string {
-  return randomBytes(16).toString("hex");
-}
-
-export function generateEnvFile(_projectRoot: string): string {
-  const lines: string[] = [
-    "# 🔧 TDK Environment Configuration",
-    "# Auto-generated by TDK CLI - edit as needed",
-    "# These variables are required for services to run",
-    "#",
-    "# After editing, run: tdk config regenerate && tdk up",
-    "",
-  ];
-
-  for (const envVar of REQUIRED_ENV_VARS) {
-    lines.push(`# ${envVar.description}`);
-
-    if (envVar.required) {
-      lines.push(`# ⚠️  REQUIRED - set this or services will fail`);
-    }
-
-    if (envVar.example) {
-      lines.push(`# Example: ${envVar.example}`);
-    }
-
-    const value = envVar.name === "DB_PASSWORD" ? generateDbPassword() : envVar.default || "";
-    lines.push(`${envVar.name}=${value}`);
-    lines.push("");
-  }
-
-  return lines.join("\n");
-}
-
-export function validateEnvFile(projectRoot: string): {
-  missing: string[];
-  invalid: string[];
-  warnings: string[];
-} {
-  const envPath = join(projectRoot, ".env");
-  const result = {
-    missing: [] as string[],
-    invalid: [] as string[],
-    warnings: [] as string[],
-  };
-
-  if (!existsSync(envPath)) {
-    return {
-      missing: REQUIRED_ENV_VARS.filter((v) => v.required).map((v) => v.name),
-      invalid: [],
-      warnings: [".env file not found - will be auto-generated"],
-    };
-  }
-
-  const envContent = readFileSync(envPath, "utf-8");
-  const envVars = new Set(
-    envContent
-      .split("\n")
-      .filter((line) => !line.startsWith("#") && line.includes("="))
-      .map((line) => line.split("=")[0])
-      .filter((name) => name.length > 0),
-  );
-
-  for (const envVar of REQUIRED_ENV_VARS) {
-    if (envVar.required && !envVars.has(envVar.name)) {
-      result.missing.push(envVar.name);
-    }
-
-    if (envVars.has(envVar.name)) {
-      const match = envContent.match(new RegExp(`^${envVar.name}=(.*)$`, "m"));
-      const value = match ? match[1] : "";
-      if (!value.trim()) {
-        result.invalid.push(`${envVar.name} is set but empty`);
-      }
-    }
-  }
-
-  return result;
-}
-
-export function ensureEnvFile(projectRoot: string): boolean {
-  const envPath = join(projectRoot, ".env");
-
-  if (!existsSync(envPath)) {
-    writeFileSync(envPath, generateEnvFile(projectRoot));
-    return true;
-  }
-
-  return false;
-}

package/cli/src/utils/errors.ts

@@ -1,168 +0,0 @@
-import chalk from "chalk";
-import { QUICKSTART_DOCS_URL } from "./constants.js";
-import { getContainerRuntimeStatus } from "./docker.js";
-import { findProjectRoot } from "./paths.js";
-import { isTiltAvailable } from "./tilt.js";
-
-export function getErrorMessage(err: unknown): string {
-  return err instanceof Error ? err.message : String(err);
-}
-
-export function logVerbose(message: string, err?: unknown): void {
-  if (process.env.TDK_VERBOSE) {
-    const errMsg = err !== undefined ? `: ${getErrorMessage(err)}` : "";
-    console.warn(chalk.gray(`${message}${errMsg}`));
-  }
-}
-
-class TdkError extends Error {
-  public suggestions: string[];
-  public exitCode: number;
-
-  constructor(message: string, suggestions: string[] = [], exitCode: number = 1) {
-    super(message);
-    this.name = "TdkError";
-    this.suggestions = suggestions;
-    this.exitCode = exitCode;
-  }
-
-  display(): void {
-    showError(this.message, undefined, this.suggestions);
-  }
-
-  /** Display this error and exit the process with its exit code. */
-  exit(): never {
-    this.display();
-    process.exit(this.exitCode);
-  }
-}
-
-export const errorFactories = {
-  tiltNotInstalled: () =>
-    new TdkError("Tilt CLI is not installed", [
-      "Install Tilt: `brew install tilt` (macOS)",
-      "Or download from: https://docs.tilt.dev/install.html",
-      "Verify with: `tilt version`",
-      `Setup guide: ${QUICKSTART_DOCS_URL}`,
-    ]),
-  dockerNotAvailable: () =>
-    new TdkError("Docker (or a compatible container runtime) is not running", [
-      "Start Docker Desktop, then verify with: `docker ps`",
-      "Or start Colima: `colima start`",
-      "Or start the Docker service on Linux: `sudo systemctl start docker`",
-      `Setup guide: ${QUICKSTART_DOCS_URL}`,
-    ]),
-  dockerNotResponding: () =>
-    new TdkError("Docker is running but not responding (`docker ps` hung for 10s)", [
-      "Quit and reopen Docker Desktop, or run `colima restart`",
-      "Then verify with: `docker ps`",
-    ]),
-  stackNotFound: (name: string) =>
-    new TdkError(`Stack "${name}" not found`, [
-      "Run `tdk stacks` to see available stacks",
-      "Run `tdk stack` to assign resources to a stack",
-    ]),
-  resourceNotFound: (name: string) =>
-    new TdkError(`Resource "${name}" not found`, [
-      "Run `tdk resources` to list all resources",
-      "Check the resource name spelling",
-    ]),
-  directoryExists: (path: string) =>
-    new TdkError(`Directory already exists: ${path}`, [
-      "Use `--path` to specify a different location",
-      "Remove the existing directory if no longer needed",
-    ]),
-  invalidPath: (path: string) =>
-    new TdkError(`Invalid path: ${path}`, [
-      "Path must be within the project directory",
-      'Path cannot contain special characters like <>:"|?*',
-    ]),
-  notInProject: () =>
-    new TdkError("Could not find project root (no Tiltfile found)", [
-      "Run this from within a project that has a Tiltfile",
-      "Run `tdk project` to initialize a new project",
-    ]),
-};
-
-export function requireProjectRoot(): string {
-  const projectRoot = findProjectRoot();
-  if (!projectRoot) {
-    console.error(chalk.red("Error: Could not find project root (no Tiltfile found)."));
-    console.error(chalk.gray("Run this from within a project that has a Tiltfile."));
-    process.exit(1);
-  }
-  return projectRoot;
-}
-
-function handleCommandError(err: unknown): never {
-  console.error(chalk.red(`Error: ${getErrorMessage(err)}`));
-  process.exit(1);
-}
-
-export async function runCommand<T>(
-  action: () => Promise<T>,
-  options?: { verbose?: boolean },
-): Promise<T | never> {
-  try {
-    return await action();
-  } catch (err: unknown) {
-    if (options?.verbose && err instanceof Error && err.stack) {
-      console.error(chalk.gray(err.stack));
-    }
-    return handleCommandError(err);
-  }
-}
-
-export async function withTiltCheck<T>(
-  action: () => Promise<T>,
-  options?: { verbose?: boolean },
-): Promise<T | never> {
-  const problems: TdkError[] = [];
-  const runtime = getContainerRuntimeStatus();
-  if (runtime === "unresponsive") {
-    problems.push(errorFactories.dockerNotResponding());
-  } else if (runtime === "missing") {
-    problems.push(errorFactories.dockerNotAvailable());
-  }
-  if (!(await isTiltAvailable())) {
-    problems.push(errorFactories.tiltNotInstalled());
-  }
-
-  if (problems.length > 0) {
-    console.error(chalk.red(`\nTDK can't start - missing prerequisites:\n`));
-    problems.forEach((problem, i) => {
-      if (i > 0) console.error("");
-      problem.display();
-    });
-    console.error(chalk.gray(`\nRun \`tdk doctor\` for a full environment check.`));
-    process.exit(1);
-  }
-
-  return runCommand(action, options);
-}
-
-export function showErrorAndExit(message: string, exitCode: number = 1): never {
-  console.error(chalk.red(`Error: ${message}`));
-  process.exit(exitCode);
-}
-
-/** Display a formatted error message. Does NOT exit. */
-function showError(message: string, context?: string, suggestions?: string[]): void {
-  console.error(chalk.red(`❌ ${message}`));
-
-  if (context) {
-    console.error(chalk.gray(`   ${context}`));
-  }
-
-  if (suggestions && suggestions.length > 0) {
-    console.error(chalk.yellow("\n💡 Suggestions:"));
-    suggestions.forEach((s) => {
-      console.error(chalk.cyan(`   → ${s}`));
-    });
-  }
-}
-
-export function handleTiltFailure(command: "up" | "down", exitCode: number): never {
-  console.error(chalk.red(`\ntilt ${command} failed with exit code ${exitCode}`));
-  process.exit(exitCode);
-}

package/cli/src/utils/file-helpers.ts

@@ -1,62 +0,0 @@
-import { existsSync, mkdirSync, writeFileSync } from "node:fs";
-import { resolve } from "node:path";
-import chalk from "chalk";
-import type { FileGenerationTask } from "../types/index.js";
-
-export function writeFilesWithProgress(
-  basePath: string,
-  tasks: FileGenerationTask[],
-  onProgress?: (task: FileGenerationTask, index: number, total: number) => void,
-): void {
-  for (let i = 0; i < tasks.length; i++) {
-    const task = tasks[i];
-
-    console.log(chalk.blue(`${task.emoji} ${task.description}...`));
-
-    if (task.type === "json") {
-      writeJsonFileInDir(basePath, task.filename, task.content);
-    } else {
-      writeTextFileInDir(basePath, task.filename, String(task.content));
-    }
-
-    if (onProgress) {
-      onProgress(task, i, tasks.length);
-    }
-  }
-}
-
-/**
- * Write JSON data to a file.
- * @param filePath - Path to the file
- * @param data - JSON-serializable data
- * @param space - Number of spaces for indentation (default: 2)
- */
-export function writeJsonFile(filePath: string, data: unknown, space: number = 2): void {
-  const content = `${JSON.stringify(data, null, space)}\n`;
-  writeFileSync(filePath, content, "utf-8");
-}
-
-export function writeJsonFileInDir(
-  dir: string,
-  filename: string,
-  data: unknown,
-  space: number = 2,
-): void {
-  const filePath = resolve(dir, filename);
-  writeJsonFile(filePath, data, space);
-}
-
-export function writeTextFile(filePath: string, content: string): void {
-  writeFileSync(filePath, content, "utf-8");
-}
-
-export function writeTextFileInDir(dir: string, filename: string, content: string): void {
-  const filePath = resolve(dir, filename);
-  writeTextFile(filePath, content);
-}
-
-export function ensureDirectory(dirPath: string): void {
-  if (!existsSync(dirPath)) {
-    mkdirSync(dirPath, { recursive: true });
-  }
-}

package/cli/src/utils/formatting.ts

@@ -1,215 +0,0 @@
-import chalk from "chalk";
-import type { StatusCategory, StatusValue } from "../types/index.js";
-
-function pluralize(count: number, singular: string, plural?: string): string {
-  return count === 1 ? singular : plural || `${singular}s`;
-}
-
-export function formatCount(count: number, singular: string, plural?: string): string {
-  return `${count} ${pluralize(count, singular, plural)}`;
-}
-
-const DATE_FORMAT_OPTIONS: Intl.DateTimeFormatOptions = {
-  month: "short",
-  day: "numeric",
-  hour: "2-digit",
-  minute: "2-digit",
-};
-
-export function formatDate(timestamp: string): string {
-  const date = new Date(timestamp);
-  return date.toLocaleString("en-US", DATE_FORMAT_OPTIONS);
-}
-
-export function formatShortDate(timestamp: string): string {
-  const date = new Date(timestamp);
-  return date.toLocaleDateString("en-US", { month: "short", day: "numeric" });
-}
-
-const STATUS_CATEGORY_CONFIG: Record<
-  StatusCategory,
-  { color: string; icon: string; chalkFn: (text: string) => string }
-> = {
-  success: { color: "green", icon: "✓", chalkFn: chalk.green },
-  error: { color: "red", icon: "✗", chalkFn: chalk.red },
-  warning: { color: "yellow", icon: "○", chalkFn: chalk.yellow },
-  unknown: { color: "gray", icon: "?", chalkFn: chalk.gray },
-};
-
-function getStatusCategory(status: StatusValue): StatusCategory {
-  if (!status) return "unknown";
-  const lowerStatus = status.toLowerCase();
-
-  if (
-    lowerStatus === "ready" ||
-    lowerStatus === "healthy" ||
-    lowerStatus === "active" ||
-    lowerStatus === "running"
-  ) {
-    return "success";
-  }
-
-  if (
-    lowerStatus === "error" ||
-    lowerStatus === "failed" ||
-    lowerStatus === "critical" ||
-    lowerStatus === "stopped"
-  ) {
-    return "error";
-  }
-
-  if (
-    lowerStatus === "pending" ||
-    lowerStatus === "starting" ||
-    lowerStatus === "building" ||
-    lowerStatus === "degraded"
-  ) {
-    return "warning";
-  }
-
-  return "unknown";
-}
-
-export function getStatusColor(status: StatusValue): string {
-  return STATUS_CATEGORY_CONFIG[getStatusCategory(status)].color;
-}
-
-export function getStatusIcon(status: StatusValue): string {
-  return STATUS_CATEGORY_CONFIG[getStatusCategory(status)].icon;
-}
-
-export function colorizeByStatus(text: string, status: StatusValue): string {
-  return STATUS_CATEGORY_CONFIG[getStatusCategory(status)].chalkFn(text);
-}
-
-const EMPTY_STATE_CONFIG: Record<string, { singular: string; command: string; context?: string }> =
-  {
-    resources: {
-      singular: "resource",
-      command: "tdk resource <name>",
-      context: "\nTo create a resource:",
-    },
-    stacks: {
-      singular: "stack",
-      command: "tdk stack <stack-name>",
-      context: "\nTo create a stack, use:",
-    },
-    services: {
-      singular: "service",
-      command: "tdk resource <name>",
-      context: "\nTo create a service:",
-    },
-    "stack-services": {
-      singular: "service",
-      command: "tdk resource <name> --stack <stack-name>",
-      context: "\nTo add services to this stack:",
-    },
-  };
-
-export function showEmptyState(
-  itemType: "resources" | "stacks" | "services" | "stack-services",
-  filterContext?: string,
-): void {
-  const config = EMPTY_STATE_CONFIG[itemType];
-
-  if (filterContext) {
-    console.log(chalk.yellow(`No ${config.singular}s found${filterContext}.`));
-  } else {
-    console.log(chalk.yellow(`No ${config.singular}s found.`));
-  }
-
-  console.log(chalk.gray(config.context));
-  console.log(chalk.gray(`  ${config.command}`));
-
-  if (itemType === "stacks") {
-    console.log(chalk.gray("\nOr create a new resource with a stack:"));
-    console.log(chalk.gray("  tdk resource <name> --stack <stack-name>"));
-  }
-}
-
-export function showCancelled(message?: string): void {
-  console.log(chalk.yellow(message || "Cancelled."));
-}
-
-export function showCommandHeader(title: string): void {
-  console.log(chalk.blue(`TDK ${title}\n`));
-}
-
-export function showAllSatisfyCondition(items: string, condition: string): void {
-  console.log(chalk.green(`All ${items} are ${condition}!`));
-}
-
-/** Default width for ASCII boxes */
-export const DEFAULT_BOX_WIDTH = 62;
-
-export function formatBoxLine(char: string = "─", width: number = DEFAULT_BOX_WIDTH): string {
-  return char.repeat(width);
-}
-
-export function formatCentered(text: string, width: number = DEFAULT_BOX_WIDTH - 2): string {
-  const padding = Math.max(0, width - text.length);
-  const left = Math.floor(padding / 2);
-  const right = padding - left;
-  return " ".repeat(left) + text + " ".repeat(right);
-}
-
-export function formatPadded(text: string, width: number): string {
-  if (text.length > width) {
-    return `${text.slice(0, width - 1)}…`;
-  }
-  return text.padEnd(width);
-}
-
-export function truncate(str: string, maxLength: number): string {
-  if (str.length <= maxLength) return str;
-  return `${str.slice(0, maxLength - 3)}...`;
-}
-
-export function showSuccess(message: string): void {
-  console.log(chalk.green(`✓ ${message}`));
-}
-
-export function showStep(message: string): void {
-  console.log(chalk.blue(message));
-}
-
-export function showDetail(message: string, indent = 2): void {
-  console.log(chalk.gray(`${" ".repeat(indent)}${message}`));
-}
-
-export function formatBytes(bytes: number): string {
-  if (bytes < 1024) return `${bytes} B`;
-  if (bytes < 1024 * 1024) return `${(bytes / 1024).toFixed(1)} KB`;
-  return `${(bytes / (1024 * 1024)).toFixed(1)} MB`;
-}
-
-/**
- * Print a boxed header with title and optional subtitle.
- * Consolidates common box formatting patterns from networks.ts and other commands.
- * @param title - The main title to display
- * @param subtitle - Optional subtitle (e.g., domain info)
- * @param width - Box width (defaults to DEFAULT_BOX_WIDTH)
- */
-export function printBoxedHeader(
-  title: string,
-  subtitle?: string,
-  width: number = DEFAULT_BOX_WIDTH,
-): void {
-  const innerWidth = width - 2;
-  const line = "─".repeat(innerWidth);
-
-  console.log();
-  console.log(chalk.cyan(`╭${line}╮`));
-  console.log(
-    chalk.cyan("│") + chalk.bold.white(formatCentered(title, innerWidth)) + chalk.cyan("│"),
-  );
-
-  if (subtitle) {
-    console.log(chalk.cyan(`├${line}┤`));
-    console.log(
-      chalk.cyan("│") + chalk.gray(formatCentered(subtitle, innerWidth)) + chalk.cyan("│"),
-    );
-  }
-
-  console.log(chalk.cyan(`╰${line}╯`));
-}

package/cli/src/utils/paths.ts

@@ -1,53 +0,0 @@
-import { existsSync } from "node:fs";
-import { dirname, join, resolve } from "node:path";
-import { cwd } from "node:process";
-import packageJson from "../../package.json" with { type: "json" };
-import type { JsonObject, PackageInfo } from "../types/index.js";
-
-export function findProjectRoot(startDir: string = cwd()): string | null {
-  let currentDir = resolve(startDir);
-  const root = resolve("/");
-
-  while (currentDir !== root) {
-    if (existsSync(join(currentDir, ".tdk", "project.json"))) {
-      return currentDir;
-    }
-
-    const parentDir = dirname(currentDir);
-    if (parentDir === currentDir) {
-      break;
-    }
-    currentDir = parentDir;
-  }
-
-  return null;
-}
-
-let packageCache: PackageInfo | null = null;
-
-function getPackageInfo(): PackageInfo {
-  if (packageCache) {
-    return packageCache;
-  }
-
-  // Imported JSON is bundled by Bun compile, unlike a runtime fs lookup from $bunfs.
-  const parsed: unknown = packageJson;
-
-  if (!parsed || typeof parsed !== "object" || Array.isArray(parsed)) {
-    throw new Error("Invalid package.json: expected object");
-  }
-
-  const packageInfo = parsed as JsonObject;
-
-  packageCache = {
-    name: String(packageInfo.name ?? "@tdk-landscape/tdk-cli-core"),
-    version: String(packageInfo.version ?? "0.0.0"),
-    fullPackage: packageInfo,
-  };
-
-  return packageCache;
-}
-
-export function getPackageVersion(): string {
-  return getPackageInfo().version;
-}