@tdk-landscape/tdk-cli-core 1.3.14

package/dist/utils/docker.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"docker.d.ts","sourceRoot":"","sources":["../../src/utils/docker.ts"],"names":[],"mappings":"AAEA,kFAAkF;AAClF,wBAAgB,iBAAiB,IAAI,OAAO,CAQ3C"}

package/dist/utils/docker.js

@@ -0,0 +1,13 @@
+import { execSync } from "node:child_process";
+/** True if Docker, Colima, or Podman is installed and its daemon is reachable. */
+export function isDockerAvailable() {
+    for (const command of ["docker ps", "colima status", "podman ps"]) {
+        try {
+            execSync(command, { stdio: "ignore" });
+            return true;
+        }
+        catch { }
+    }
+    return false;
+}
+//# sourceMappingURL=docker.js.map

package/dist/utils/docker.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"docker.js","sourceRoot":"","sources":["../../src/utils/docker.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,oBAAoB,CAAC;AAE9C,kFAAkF;AAClF,MAAM,UAAU,iBAAiB;IAC/B,KAAK,MAAM,OAAO,IAAI,CAAC,WAAW,EAAE,eAAe,EAAE,WAAW,CAAC,EAAE,CAAC;QAClE,IAAI,CAAC;YACH,QAAQ,CAAC,OAAO,EAAE,EAAE,KAAK,EAAE,QAAQ,EAAE,CAAC,CAAC;YACvC,OAAO,IAAI,CAAC;QACd,CAAC;QAAC,MAAM,CAAC,CAAA,CAAC;IACZ,CAAC;IACD,OAAO,KAAK,CAAC;AACf,CAAC"}

package/dist/utils/env-validator.d.ts

@@ -0,0 +1,15 @@
+export interface EnvVariable {
+    name: string;
+    description: string;
+    required: boolean;
+    default?: string;
+    example?: string;
+}
+export declare function generateEnvFile(projectRoot: string): string;
+export declare function validateEnvFile(projectRoot: string): {
+    missing: string[];
+    invalid: string[];
+    warnings: string[];
+};
+export declare function ensureEnvFile(projectRoot: string): boolean;
+//# sourceMappingURL=env-validator.d.ts.map

package/dist/utils/env-validator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"env-validator.d.ts","sourceRoot":"","sources":["../../src/utils/env-validator.ts"],"names":[],"mappings":"AAGA,MAAM,WAAW,WAAW;IAC1B,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,QAAQ,EAAE,OAAO,CAAC;IAClB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AA+BD,wBAAgB,eAAe,CAAC,WAAW,EAAE,MAAM,GAAG,MAAM,CA0B3D;AAED,wBAAgB,eAAe,CAAC,WAAW,EAAE,MAAM,GAAG;IACpD,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,QAAQ,EAAE,MAAM,EAAE,CAAC;CACpB,CAwCA;AAED,wBAAgB,aAAa,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAS1D"}

package/dist/utils/env-validator.js

@@ -0,0 +1,95 @@
+import { existsSync, readFileSync, writeFileSync } from "node:fs";
+import { join } from "node:path";
+const REQUIRED_ENV_VARS = [
+    {
+        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",
+    },
+];
+export function generateEnvFile(projectRoot) {
+    const lines = [
+        "# 🔧 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}`);
+        }
+        lines.push(`${envVar.name}=${envVar.default || ""}`);
+        lines.push("");
+    }
+    return lines.join("\n");
+}
+export function validateEnvFile(projectRoot) {
+    const envPath = join(projectRoot, ".env");
+    const result = {
+        missing: [],
+        invalid: [],
+        warnings: [],
+    };
+    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) {
+    const envPath = join(projectRoot, ".env");
+    if (!existsSync(envPath)) {
+        writeFileSync(envPath, generateEnvFile(projectRoot));
+        return true;
+    }
+    return false;
+}
+//# sourceMappingURL=env-validator.js.map

package/dist/utils/env-validator.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"env-validator.js","sourceRoot":"","sources":["../../src/utils/env-validator.ts"],"names":[],"mappings":"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"}

package/dist/utils/errors.d.ts

@@ -0,0 +1,28 @@
+export declare function getErrorMessage(err: unknown): string;
+export declare function logVerbose(message: string, err?: unknown): void;
+declare class TdkError extends Error {
+    suggestions: string[];
+    exitCode: number;
+    constructor(message: string, suggestions?: string[], exitCode?: number);
+    display(): void;
+}
+export declare const errorFactories: {
+    tiltNotInstalled: () => TdkError;
+    dockerNotAvailable: () => TdkError;
+    stackNotFound: (name: string) => TdkError;
+    resourceNotFound: (name: string) => TdkError;
+    directoryExists: (path: string) => TdkError;
+    invalidPath: (path: string) => TdkError;
+    notInProject: () => TdkError;
+};
+export declare function requireProjectRoot(): string;
+export declare function runCommand<T>(action: () => Promise<T>, options?: {
+    verbose?: boolean;
+}): Promise<T | never>;
+export declare function withTiltCheck<T>(action: () => Promise<T>, options?: {
+    verbose?: boolean;
+}): Promise<T | never>;
+export declare function showErrorAndExit(message: string, exitCode?: number): never;
+export declare function handleTiltFailure(command: "up" | "down", exitCode: number): never;
+export {};
+//# sourceMappingURL=errors.d.ts.map

package/dist/utils/errors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../../src/utils/errors.ts"],"names":[],"mappings":"AAOA,wBAAgB,eAAe,CAAC,GAAG,EAAE,OAAO,GAAG,MAAM,CAEpD;AAED,wBAAgB,UAAU,CAAC,OAAO,EAAE,MAAM,EAAE,GAAG,CAAC,EAAE,OAAO,GAAG,IAAI,CAK/D;AAED,cAAM,QAAS,SAAQ,KAAK;IACnB,WAAW,EAAE,MAAM,EAAE,CAAC;IACtB,QAAQ,EAAE,MAAM,CAAC;IAExB,YAAY,OAAO,EAAE,MAAM,EAAE,WAAW,GAAE,MAAM,EAAO,EAAE,QAAQ,GAAE,MAAU,EAK5E;IAED,OAAO,IAAI,IAAI,CAEd;CACF;AAED,eAAO,MAAM,cAAc;IACzB,gBAAgB;IAOhB,kBAAkB;IAOlB,aAAa,SAAS,MAAM;IAK5B,gBAAgB,SAAS,MAAM;IAK/B,eAAe,SAAS,MAAM;IAK9B,WAAW,SAAS,MAAM;IAK1B,YAAY;CAKb,CAAC;AAEF,wBAAgB,kBAAkB,IAAI,MAAM,CAQ3C;AAOD,wBAAsB,UAAU,CAAC,CAAC,EAChC,MAAM,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,EACxB,OAAO,CAAC,EAAE;IAAE,OAAO,CAAC,EAAE,OAAO,CAAA;CAAE,GAC9B,OAAO,CAAC,CAAC,GAAG,KAAK,CAAC,CASpB;AAED,wBAAsB,aAAa,CAAC,CAAC,EACnC,MAAM,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,EACxB,OAAO,CAAC,EAAE;IAAE,OAAO,CAAC,EAAE,OAAO,CAAA;CAAE,GAC9B,OAAO,CAAC,CAAC,GAAG,KAAK,CAAC,CAoBpB;AAED,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,MAAM,EAAE,QAAQ,GAAE,MAAU,GAAG,KAAK,CAG7E;AAkBD,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,IAAI,GAAG,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,KAAK,CAGjF"}

package/dist/utils/errors.js

@@ -0,0 +1,127 @@
+import chalk from "chalk";
+import { isDockerAvailable } from "./docker.js";
+import { findProjectRoot } from "./paths.js";
+import { isTiltAvailable } from "./tilt.js";
+const QUICKSTART_DOCS_URL = "https://tdk-landscape.github.io/tdk-website/docs/quickstart/";
+export function getErrorMessage(err) {
+    return err instanceof Error ? err.message : String(err);
+}
+export function logVerbose(message, err) {
+    if (process.env.TDK_VERBOSE) {
+        const errMsg = err !== undefined ? `: ${getErrorMessage(err)}` : "";
+        console.warn(chalk.gray(`${message}${errMsg}`));
+    }
+}
+class TdkError extends Error {
+    suggestions;
+    exitCode;
+    constructor(message, suggestions = [], exitCode = 1) {
+        super(message);
+        this.name = "TdkError";
+        this.suggestions = suggestions;
+        this.exitCode = exitCode;
+    }
+    display() {
+        showError(this.message, undefined, this.suggestions);
+    }
+}
+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}`,
+    ]),
+    stackNotFound: (name) => new TdkError(`Stack "${name}" not found`, [
+        "Run `tdk stacks` to see available stacks",
+        "Run `tdk stack` to assign resources to a stack",
+    ]),
+    resourceNotFound: (name) => new TdkError(`Resource "${name}" not found`, [
+        "Run `tdk resources` to list all resources",
+        "Check the resource name spelling",
+    ]),
+    directoryExists: (path) => new TdkError(`Directory already exists: ${path}`, [
+        "Use `--path` to specify a different location",
+        "Remove the existing directory if no longer needed",
+    ]),
+    invalidPath: (path) => 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() {
+    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) {
+    console.error(chalk.red(`Error: ${getErrorMessage(err)}`));
+    process.exit(1);
+}
+export async function runCommand(action, options) {
+    try {
+        return await action();
+    }
+    catch (err) {
+        if (options?.verbose && err instanceof Error && err.stack) {
+            console.error(chalk.gray(err.stack));
+        }
+        return handleCommandError(err);
+    }
+}
+export async function withTiltCheck(action, options) {
+    const problems = [];
+    if (!isDockerAvailable()) {
+        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, exitCode = 1) {
+    console.error(chalk.red(`Error: ${message}`));
+    process.exit(exitCode);
+}
+/** Display a formatted error message. Does NOT exit. */
+function showError(message, context, suggestions) {
+    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, exitCode) {
+    console.error(chalk.red(`\ntilt ${command} failed with exit code ${exitCode}`));
+    process.exit(exitCode);
+}
+//# sourceMappingURL=errors.js.map

package/dist/utils/errors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.js","sourceRoot":"","sources":["../../src/utils/errors.ts"],"names":[],"mappings":"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"}

package/dist/utils/file-helpers.d.ts

@@ -0,0 +1,14 @@
+import type { FileGenerationTask } from "../types/index.js";
+export declare function writeFilesWithProgress(basePath: string, tasks: FileGenerationTask[], onProgress?: (task: FileGenerationTask, index: number, total: number) => void): void;
+/**
+ * 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 declare function writeJsonFile(filePath: string, data: unknown, space?: number): void;
+export declare function writeJsonFileInDir(dir: string, filename: string, data: unknown, space?: number): void;
+export declare function writeTextFile(filePath: string, content: string): void;
+export declare function writeTextFileInDir(dir: string, filename: string, content: string): void;
+export declare function ensureDirectory(dirPath: string): void;
+//# sourceMappingURL=file-helpers.d.ts.map

package/dist/utils/file-helpers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"file-helpers.d.ts","sourceRoot":"","sources":["../../src/utils/file-helpers.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,mBAAmB,CAAC;AAE5D,wBAAgB,sBAAsB,CACpC,QAAQ,EAAE,MAAM,EAChB,KAAK,EAAE,kBAAkB,EAAE,EAC3B,UAAU,CAAC,EAAE,CAAC,IAAI,EAAE,kBAAkB,EAAE,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,KAAK,IAAI,GAC5E,IAAI,CAgBN;AAED;;;;;GAKG;AACH,wBAAgB,aAAa,CAAC,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO,EAAE,KAAK,GAAE,MAAU,GAAG,IAAI,CAGtF;AAED,wBAAgB,kBAAkB,CAChC,GAAG,EAAE,MAAM,EACX,QAAQ,EAAE,MAAM,EAChB,IAAI,EAAE,OAAO,EACb,KAAK,GAAE,MAAU,GAChB,IAAI,CAGN;AAED,wBAAgB,aAAa,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,IAAI,CAErE;AAED,wBAAgB,kBAAkB,CAAC,GAAG,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,IAAI,CAGvF;AAED,wBAAgB,eAAe,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,CAIrD"}

package/dist/utils/file-helpers.js

@@ -0,0 +1,45 @@
+import { existsSync, mkdirSync, writeFileSync } from "node:fs";
+import { resolve } from "node:path";
+import chalk from "chalk";
+export function writeFilesWithProgress(basePath, tasks, onProgress) {
+    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, data, space = 2) {
+    const content = `${JSON.stringify(data, null, space)}\n`;
+    writeFileSync(filePath, content, "utf-8");
+}
+export function writeJsonFileInDir(dir, filename, data, space = 2) {
+    const filePath = resolve(dir, filename);
+    writeJsonFile(filePath, data, space);
+}
+export function writeTextFile(filePath, content) {
+    writeFileSync(filePath, content, "utf-8");
+}
+export function writeTextFileInDir(dir, filename, content) {
+    const filePath = resolve(dir, filename);
+    writeTextFile(filePath, content);
+}
+export function ensureDirectory(dirPath) {
+    if (!existsSync(dirPath)) {
+        mkdirSync(dirPath, { recursive: true });
+    }
+}
+//# sourceMappingURL=file-helpers.js.map

package/dist/utils/file-helpers.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"file-helpers.js","sourceRoot":"","sources":["../../src/utils/file-helpers.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,SAAS,EAAE,aAAa,EAAE,MAAM,SAAS,CAAC;AAC/D,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACpC,OAAO,KAAK,MAAM,OAAO,CAAC;AAG1B,MAAM,UAAU,sBAAsB,CACpC,QAAgB,EAChB,KAA2B,EAC3B,UAA6E;IAE7E,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,KAAK,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;QACtC,MAAM,IAAI,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC;QAEtB,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC,KAAK,IAAI,IAAI,CAAC,WAAW,KAAK,CAAC,CAAC,CAAC;QAEhE,IAAI,IAAI,CAAC,IAAI,KAAK,MAAM,EAAE,CAAC;YACzB,kBAAkB,CAAC,QAAQ,EAAE,IAAI,CAAC,QAAQ,EAAE,IAAI,CAAC,OAAO,CAAC,CAAC;QAC5D,CAAC;aAAM,CAAC;YACN,kBAAkB,CAAC,QAAQ,EAAE,IAAI,CAAC,QAAQ,EAAE,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,CAAC;QACpE,CAAC;QAED,IAAI,UAAU,EAAE,CAAC;YACf,UAAU,CAAC,IAAI,EAAE,CAAC,EAAE,KAAK,CAAC,MAAM,CAAC,CAAC;QACpC,CAAC;IACH,CAAC;AACH,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,aAAa,CAAC,QAAgB,EAAE,IAAa,EAAE,KAAK,GAAW,CAAC;IAC9E,MAAM,OAAO,GAAG,GAAG,IAAI,CAAC,SAAS,CAAC,IAAI,EAAE,IAAI,EAAE,KAAK,CAAC,IAAI,CAAC;IACzD,aAAa,CAAC,QAAQ,EAAE,OAAO,EAAE,OAAO,CAAC,CAAC;AAC5C,CAAC;AAED,MAAM,UAAU,kBAAkB,CAChC,GAAW,EACX,QAAgB,EAChB,IAAa,EACb,KAAK,GAAW,CAAC;IAEjB,MAAM,QAAQ,GAAG,OAAO,CAAC,GAAG,EAAE,QAAQ,CAAC,CAAC;IACxC,aAAa,CAAC,QAAQ,EAAE,IAAI,EAAE,KAAK,CAAC,CAAC;AACvC,CAAC;AAED,MAAM,UAAU,aAAa,CAAC,QAAgB,EAAE,OAAe;IAC7D,aAAa,CAAC,QAAQ,EAAE,OAAO,EAAE,OAAO,CAAC,CAAC;AAC5C,CAAC;AAED,MAAM,UAAU,kBAAkB,CAAC,GAAW,EAAE,QAAgB,EAAE,OAAe;IAC/E,MAAM,QAAQ,GAAG,OAAO,CAAC,GAAG,EAAE,QAAQ,CAAC,CAAC;IACxC,aAAa,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC;AACnC,CAAC;AAED,MAAM,UAAU,eAAe,CAAC,OAAe;IAC7C,IAAI,CAAC,UAAU,CAAC,OAAO,CAAC,EAAE,CAAC;QACzB,SAAS,CAAC,OAAO,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IAC1C,CAAC;AACH,CAAC"}

package/dist/utils/formatting.d.ts

@@ -0,0 +1,30 @@
+import type { StatusValue } from "../types/index.js";
+export declare function formatCount(count: number, singular: string, plural?: string): string;
+export declare function formatDate(timestamp: string): string;
+export declare function formatShortDate(timestamp: string): string;
+export declare function getStatusColor(status: StatusValue): string;
+export declare function getStatusIcon(status: StatusValue): string;
+export declare function colorizeByStatus(text: string, status: StatusValue): string;
+export declare function showEmptyState(itemType: "resources" | "stacks" | "services" | "stack-services", filterContext?: string): void;
+export declare function showCancelled(message?: string): void;
+export declare function showCommandHeader(title: string): void;
+export declare function showAllSatisfyCondition(items: string, condition: string): void;
+/** Default width for ASCII boxes */
+export declare const DEFAULT_BOX_WIDTH = 62;
+export declare function formatBoxLine(char?: string, width?: number): string;
+export declare function formatCentered(text: string, width?: number): string;
+export declare function formatPadded(text: string, width: number): string;
+export declare function truncate(str: string, maxLength: number): string;
+export declare function showSuccess(message: string): void;
+export declare function showStep(message: string): void;
+export declare function showDetail(message: string, indent?: number): void;
+export declare function formatBytes(bytes: number): string;
+/**
+ * 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 declare function printBoxedHeader(title: string, subtitle?: string, width?: number): void;
+//# sourceMappingURL=formatting.d.ts.map

package/dist/utils/formatting.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"formatting.d.ts","sourceRoot":"","sources":["../../src/utils/formatting.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAkB,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAMrE,wBAAgB,WAAW,CAAC,KAAK,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,GAAG,MAAM,CAEpF;AASD,wBAAgB,UAAU,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM,CAGpD;AAED,wBAAgB,eAAe,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM,CAGzD;AA8CD,wBAAgB,cAAc,CAAC,MAAM,EAAE,WAAW,GAAG,MAAM,CAE1D;AAED,wBAAgB,aAAa,CAAC,MAAM,EAAE,WAAW,GAAG,MAAM,CAEzD;AAED,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,WAAW,GAAG,MAAM,CAE1E;AA0BD,wBAAgB,cAAc,CAC5B,QAAQ,EAAE,WAAW,GAAG,QAAQ,GAAG,UAAU,GAAG,gBAAgB,EAChE,aAAa,CAAC,EAAE,MAAM,GACrB,IAAI,CAgBN;AAED,wBAAgB,aAAa,CAAC,OAAO,CAAC,EAAE,MAAM,GAAG,IAAI,CAEpD;AAED,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,CAErD;AAED,wBAAgB,uBAAuB,CAAC,KAAK,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,IAAI,CAE9E;AAED,oCAAoC;AACpC,eAAO,MAAM,iBAAiB,KAAK,CAAC;AAEpC,wBAAgB,aAAa,CAAC,IAAI,GAAE,MAAY,EAAE,KAAK,GAAE,MAA0B,GAAG,MAAM,CAE3F;AAED,wBAAgB,cAAc,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,GAAE,MAA8B,GAAG,MAAM,CAK1F;AAED,wBAAgB,YAAY,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM,CAKhE;AAED,wBAAgB,QAAQ,CAAC,GAAG,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,MAAM,CAG/D;AAED,wBAAgB,WAAW,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,CAEjD;AAED,wBAAgB,QAAQ,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,CAE9C;AAED,wBAAgB,UAAU,CAAC,OAAO,EAAE,MAAM,EAAE,MAAM,SAAI,GAAG,IAAI,CAE5D;AAED,wBAAgB,WAAW,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAIjD;AAED;;;;;;GAMG;AACH,wBAAgB,gBAAgB,CAC9B,KAAK,EAAE,MAAM,EACb,QAAQ,CAAC,EAAE,MAAM,EACjB,KAAK,GAAE,MAA0B,GAChC,IAAI,CAkBN"}

package/dist/utils/formatting.js

@@ -0,0 +1,164 @@
+import chalk from "chalk";
+function pluralize(count, singular, plural) {
+    return count === 1 ? singular : plural || `${singular}s`;
+}
+export function formatCount(count, singular, plural) {
+    return `${count} ${pluralize(count, singular, plural)}`;
+}
+const DATE_FORMAT_OPTIONS = {
+    month: "short",
+    day: "numeric",
+    hour: "2-digit",
+    minute: "2-digit",
+};
+export function formatDate(timestamp) {
+    const date = new Date(timestamp);
+    return date.toLocaleString("en-US", DATE_FORMAT_OPTIONS);
+}
+export function formatShortDate(timestamp) {
+    const date = new Date(timestamp);
+    return date.toLocaleDateString("en-US", { month: "short", day: "numeric" });
+}
+const STATUS_CATEGORY_CONFIG = {
+    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) {
+    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) {
+    return STATUS_CATEGORY_CONFIG[getStatusCategory(status)].color;
+}
+export function getStatusIcon(status) {
+    return STATUS_CATEGORY_CONFIG[getStatusCategory(status)].icon;
+}
+export function colorizeByStatus(text, status) {
+    return STATUS_CATEGORY_CONFIG[getStatusCategory(status)].chalkFn(text);
+}
+const EMPTY_STATE_CONFIG = {
+    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, filterContext) {
+    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) {
+    console.log(chalk.yellow(message || "Cancelled."));
+}
+export function showCommandHeader(title) {
+    console.log(chalk.blue(`TDK ${title}\n`));
+}
+export function showAllSatisfyCondition(items, condition) {
+    console.log(chalk.green(`All ${items} are ${condition}!`));
+}
+/** Default width for ASCII boxes */
+export const DEFAULT_BOX_WIDTH = 62;
+export function formatBoxLine(char = "─", width = DEFAULT_BOX_WIDTH) {
+    return char.repeat(width);
+}
+export function formatCentered(text, width = DEFAULT_BOX_WIDTH - 2) {
+    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, width) {
+    if (text.length > width) {
+        return `${text.slice(0, width - 1)}…`;
+    }
+    return text.padEnd(width);
+}
+export function truncate(str, maxLength) {
+    if (str.length <= maxLength)
+        return str;
+    return `${str.slice(0, maxLength - 3)}...`;
+}
+export function showSuccess(message) {
+    console.log(chalk.green(`✓ ${message}`));
+}
+export function showStep(message) {
+    console.log(chalk.blue(message));
+}
+export function showDetail(message, indent = 2) {
+    console.log(chalk.gray(`${" ".repeat(indent)}${message}`));
+}
+export function formatBytes(bytes) {
+    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, subtitle, width = DEFAULT_BOX_WIDTH) {
+    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}╯`));
+}
+//# sourceMappingURL=formatting.js.map

package/dist/utils/formatting.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"formatting.js","sourceRoot":"","sources":["../../src/utils/formatting.ts"],"names":[],"mappings":"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"}

package/dist/utils/paths.d.ts

@@ -0,0 +1,3 @@
+export declare function findProjectRoot(startDir?: string): string | null;
+export declare function getPackageVersion(): string;
+//# sourceMappingURL=paths.d.ts.map

package/dist/utils/paths.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"paths.d.ts","sourceRoot":"","sources":["../../src/utils/paths.ts"],"names":[],"mappings":"AAMA,wBAAgB,eAAe,CAAC,QAAQ,GAAE,MAAc,GAAG,MAAM,GAAG,IAAI,CAiBvE;AA2BD,wBAAgB,iBAAiB,IAAI,MAAM,CAE1C"}

package/dist/utils/paths.js

@@ -0,0 +1,41 @@
+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" };
+export function findProjectRoot(startDir = cwd()) {
+    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 = null;
+function getPackageInfo() {
+    if (packageCache) {
+        return packageCache;
+    }
+    // Imported JSON is bundled by Bun compile, unlike a runtime fs lookup from $bunfs.
+    const parsed = packageJson;
+    if (!parsed || typeof parsed !== "object" || Array.isArray(parsed)) {
+        throw new Error("Invalid package.json: expected object");
+    }
+    const packageInfo = parsed;
+    packageCache = {
+        name: String(packageInfo.name ?? "@tdk/cli"),
+        version: String(packageInfo.version ?? "0.0.0"),
+        fullPackage: packageInfo,
+    };
+    return packageCache;
+}
+export function getPackageVersion() {
+    return getPackageInfo().version;
+}
+//# sourceMappingURL=paths.js.map