@adverant-nexus/cli 2.0.1 → 3.0.0

package/dist/core/docker/docker-executor.d.ts

@@ -0,0 +1,234 @@
+/**
+ * Docker Command Executor
+ *
+ * Provides async wrappers for docker CLI commands, replacing blocking execSync calls.
+ * This prevents UI freezing and allows for proper progress indication.
+ *
+ * Key Improvements:
+ * - Non-blocking async execution
+ * - Proper error handling with detailed error types
+ * - Support for command timeouts
+ * - Ability to cancel long-running operations
+ * - Better integration with ora spinners
+ */
+/**
+ * Error types for docker command failures
+ */
+export declare enum DockerErrorType {
+    NOT_FOUND = "NOT_FOUND",// Container/image not found
+    NOT_RUNNING = "NOT_RUNNING",// Docker daemon not running
+    PERMISSION_DENIED = "PERMISSION_DENIED",// Permission issues
+    TIMEOUT = "TIMEOUT",// Command timed out
+    NETWORK_ERROR = "NETWORK_ERROR",// Network-related issues
+    INVALID_COMMAND = "INVALID_COMMAND",// Malformed docker command
+    UNKNOWN = "UNKNOWN"
+}
+/**
+ * Custom error class for docker command failures
+ */
+export declare class DockerExecutionError extends Error {
+    readonly type: DockerErrorType;
+    readonly command: string;
+    readonly stderr?: string | undefined;
+    readonly exitCode?: number | undefined;
+    constructor(message: string, type: DockerErrorType, command: string, stderr?: string | undefined, exitCode?: number | undefined);
+}
+/**
+ * Options for docker command execution
+ */
+export interface DockerExecOptions {
+    /** Timeout in milliseconds (default: 30000) */
+    timeout?: number;
+    /** Working directory for command execution */
+    cwd?: string;
+    /** Environment variables to pass to the command */
+    env?: NodeJS.ProcessEnv;
+    /** Whether to ignore errors and return empty result */
+    ignoreErrors?: boolean;
+}
+/**
+ * Result of a docker command execution
+ */
+export interface DockerExecResult {
+    /** Standard output from the command */
+    stdout: string;
+    /** Standard error from the command */
+    stderr: string;
+    /** Exit code (0 for success) */
+    exitCode: number;
+    /** Whether the command succeeded */
+    success: boolean;
+}
+/**
+ * Executes a docker command asynchronously
+ *
+ * @param command - The docker command to execute (without 'docker' prefix)
+ * @param options - Execution options
+ * @returns Promise resolving to command result
+ * @throws DockerExecutionError if command fails
+ *
+ * @example
+ * ```typescript
+ * const result = await executeDockerCommand('ps -a --format json');
+ * console.log(result.stdout);
+ * ```
+ */
+export declare function executeDockerCommand(command: string, options?: DockerExecOptions): Promise<DockerExecResult>;
+/**
+ * Executes a docker inspect command and returns parsed JSON
+ *
+ * @param target - Container or image name/ID to inspect
+ * @param format - Optional format string for docker inspect
+ * @returns Promise resolving to parsed JSON data
+ * @throws DockerExecutionError if command fails
+ *
+ * @example
+ * ```typescript
+ * const container = await dockerInspect('my-container');
+ * console.log(container.State.Running);
+ * ```
+ */
+export declare function dockerInspect<T = any>(target: string, format?: string): Promise<T>;
+/**
+ * Checks if a container is running
+ *
+ * @param containerName - Name or ID of the container
+ * @returns Promise resolving to true if running, false otherwise
+ *
+ * @example
+ * ```typescript
+ * if (await isContainerRunning('my-app')) {
+ *   console.log('Container is running');
+ * }
+ * ```
+ */
+export declare function isContainerRunning(containerName: string): Promise<boolean>;
+/**
+ * Gets the status of a container
+ *
+ * @param containerName - Name or ID of the container
+ * @returns Promise resolving to container status object
+ *
+ * @example
+ * ```typescript
+ * const status = await getContainerStatus('my-app');
+ * console.log(status.State, status.Health);
+ * ```
+ */
+export declare function getContainerStatus(containerName: string): Promise<{
+    State: string;
+    Running: boolean;
+    Paused: boolean;
+    Restarting: boolean;
+    Dead: boolean;
+    Status: string;
+    Health?: {
+        Status: string;
+        FailingStreak: number;
+    };
+}>;
+/**
+ * Lists docker containers
+ *
+ * @param options - Options for listing containers
+ * @returns Promise resolving to array of container information
+ *
+ * @example
+ * ```typescript
+ * const containers = await listContainers({ all: true });
+ * containers.forEach(c => console.log(c.name, c.status));
+ * ```
+ */
+export declare function listContainers(options?: {
+    all?: boolean;
+    format?: string;
+}): Promise<any[]>;
+/**
+ * Starts a docker container
+ *
+ * @param containerName - Name or ID of the container
+ * @param options - Execution options
+ * @returns Promise resolving to command result
+ *
+ * @example
+ * ```typescript
+ * await startContainer('my-app');
+ * ```
+ */
+export declare function startContainer(containerName: string, options?: DockerExecOptions): Promise<DockerExecResult>;
+/**
+ * Stops a docker container
+ *
+ * @param containerName - Name or ID of the container
+ * @param timeout - Timeout in seconds before killing (default: 10)
+ * @param options - Execution options
+ * @returns Promise resolving to command result
+ *
+ * @example
+ * ```typescript
+ * await stopContainer('my-app', 5);
+ * ```
+ */
+export declare function stopContainer(containerName: string, timeout?: number, options?: DockerExecOptions): Promise<DockerExecResult>;
+/**
+ * Restarts a docker container
+ *
+ * @param containerName - Name or ID of the container
+ * @param timeout - Timeout in seconds before killing (default: 10)
+ * @param options - Execution options
+ * @returns Promise resolving to command result
+ *
+ * @example
+ * ```typescript
+ * await restartContainer('my-app');
+ * ```
+ */
+export declare function restartContainer(containerName: string, timeout?: number, options?: DockerExecOptions): Promise<DockerExecResult>;
+/**
+ * Gets logs from a docker container
+ *
+ * @param containerName - Name or ID of the container
+ * @param options - Log options
+ * @returns Promise resolving to log output
+ *
+ * @example
+ * ```typescript
+ * const logs = await getContainerLogs('my-app', { tail: 100 });
+ * console.log(logs);
+ * ```
+ */
+export declare function getContainerLogs(containerName: string, options?: {
+    tail?: number;
+    since?: string;
+    timestamps?: boolean;
+    follow?: boolean;
+}): Promise<string>;
+/**
+ * Executes a command inside a running container
+ *
+ * @param containerName - Name or ID of the container
+ * @param command - Command to execute inside the container
+ * @param options - Execution options
+ * @returns Promise resolving to command result
+ *
+ * @example
+ * ```typescript
+ * const result = await execInContainer('my-app', 'ls -la');
+ * console.log(result.stdout);
+ * ```
+ */
+export declare function execInContainer(containerName: string, command: string, options?: DockerExecOptions): Promise<DockerExecResult>;
+/**
+ * Gets port mappings for a container
+ *
+ * @param containerName - Name or ID of the container
+ * @returns Promise resolving to port mapping object
+ *
+ * @example
+ * ```typescript
+ * const ports = await getContainerPorts('my-app');
+ * console.log(ports); // { "80/tcp": [{ HostIp: "0.0.0.0", HostPort: "8080" }] }
+ * ```
+ */
+export declare function getContainerPorts(containerName: string): Promise<Record<string, any>>;
+//# sourceMappingURL=docker-executor.d.ts.map

package/dist/core/docker/docker-executor.d.ts.map

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

package/dist/core/docker/docker-executor.js

@@ -0,0 +1,375 @@
+/**
+ * Docker Command Executor
+ *
+ * Provides async wrappers for docker CLI commands, replacing blocking execSync calls.
+ * This prevents UI freezing and allows for proper progress indication.
+ *
+ * Key Improvements:
+ * - Non-blocking async execution
+ * - Proper error handling with detailed error types
+ * - Support for command timeouts
+ * - Ability to cancel long-running operations
+ * - Better integration with ora spinners
+ */
+import { exec } from 'child_process';
+import { promisify } from 'util';
+const execAsync = promisify(exec);
+/**
+ * Default timeout for docker commands (30 seconds)
+ */
+const DEFAULT_TIMEOUT = 30000;
+/**
+ * Error types for docker command failures
+ */
+export var DockerErrorType;
+(function (DockerErrorType) {
+    DockerErrorType["NOT_FOUND"] = "NOT_FOUND";
+    DockerErrorType["NOT_RUNNING"] = "NOT_RUNNING";
+    DockerErrorType["PERMISSION_DENIED"] = "PERMISSION_DENIED";
+    DockerErrorType["TIMEOUT"] = "TIMEOUT";
+    DockerErrorType["NETWORK_ERROR"] = "NETWORK_ERROR";
+    DockerErrorType["INVALID_COMMAND"] = "INVALID_COMMAND";
+    DockerErrorType["UNKNOWN"] = "UNKNOWN";
+})(DockerErrorType || (DockerErrorType = {}));
+/**
+ * Custom error class for docker command failures
+ */
+export class DockerExecutionError extends Error {
+    type;
+    command;
+    stderr;
+    exitCode;
+    constructor(message, type, command, stderr, exitCode) {
+        super(message);
+        this.type = type;
+        this.command = command;
+        this.stderr = stderr;
+        this.exitCode = exitCode;
+        this.name = 'DockerExecutionError';
+        Error.captureStackTrace(this, DockerExecutionError);
+    }
+}
+/**
+ * Classifies docker error based on error message and exit code
+ */
+function classifyDockerError(stderr, exitCode) {
+    const stderrLower = stderr.toLowerCase();
+    // Check for specific error patterns
+    if (stderrLower.includes('no such container') || stderrLower.includes('no such image')) {
+        return DockerErrorType.NOT_FOUND;
+    }
+    if (stderrLower.includes('cannot connect to the docker daemon') ||
+        stderrLower.includes('is the docker daemon running')) {
+        return DockerErrorType.NOT_RUNNING;
+    }
+    if (stderrLower.includes('permission denied') ||
+        stderrLower.includes('access denied') ||
+        exitCode === 126) {
+        return DockerErrorType.PERMISSION_DENIED;
+    }
+    if (stderrLower.includes('timeout') ||
+        stderrLower.includes('timed out')) {
+        return DockerErrorType.TIMEOUT;
+    }
+    if (stderrLower.includes('network') ||
+        stderrLower.includes('connection refused')) {
+        return DockerErrorType.NETWORK_ERROR;
+    }
+    if (stderrLower.includes('invalid') ||
+        stderrLower.includes('unknown flag') ||
+        exitCode === 125) {
+        return DockerErrorType.INVALID_COMMAND;
+    }
+    return DockerErrorType.UNKNOWN;
+}
+/**
+ * Executes a docker command asynchronously
+ *
+ * @param command - The docker command to execute (without 'docker' prefix)
+ * @param options - Execution options
+ * @returns Promise resolving to command result
+ * @throws DockerExecutionError if command fails
+ *
+ * @example
+ * ```typescript
+ * const result = await executeDockerCommand('ps -a --format json');
+ * console.log(result.stdout);
+ * ```
+ */
+export async function executeDockerCommand(command, options = {}) {
+    const { timeout = DEFAULT_TIMEOUT, cwd, env, ignoreErrors = false, } = options;
+    const fullCommand = `docker ${command}`;
+    try {
+        const { stdout, stderr } = await execAsync(fullCommand, {
+            timeout,
+            cwd,
+            env: { ...process.env, ...env },
+            encoding: 'utf-8',
+            maxBuffer: 10 * 1024 * 1024, // 10MB buffer
+        });
+        return {
+            stdout: stdout.trim(),
+            stderr: stderr.trim(),
+            exitCode: 0,
+            success: true,
+        };
+    }
+    catch (error) {
+        const stderr = error.stderr || error.message || '';
+        const exitCode = error.code || null;
+        if (ignoreErrors) {
+            return {
+                stdout: '',
+                stderr,
+                exitCode: exitCode || 1,
+                success: false,
+            };
+        }
+        // Classify the error
+        const errorType = classifyDockerError(stderr, exitCode);
+        // Create descriptive error message
+        let errorMessage = `Docker command failed: ${fullCommand}`;
+        switch (errorType) {
+            case DockerErrorType.NOT_FOUND:
+                errorMessage = `Container or image not found: ${command}`;
+                break;
+            case DockerErrorType.NOT_RUNNING:
+                errorMessage = 'Docker daemon is not running. Please start Docker and try again.';
+                break;
+            case DockerErrorType.PERMISSION_DENIED:
+                errorMessage = 'Permission denied. Try running with sudo or check Docker permissions.';
+                break;
+            case DockerErrorType.TIMEOUT:
+                errorMessage = `Docker command timed out after ${timeout}ms: ${command}`;
+                break;
+            case DockerErrorType.NETWORK_ERROR:
+                errorMessage = `Network error while executing docker command: ${command}`;
+                break;
+            case DockerErrorType.INVALID_COMMAND:
+                errorMessage = `Invalid docker command: ${command}`;
+                break;
+        }
+        throw new DockerExecutionError(errorMessage, errorType, fullCommand, stderr, exitCode);
+    }
+}
+/**
+ * Executes a docker inspect command and returns parsed JSON
+ *
+ * @param target - Container or image name/ID to inspect
+ * @param format - Optional format string for docker inspect
+ * @returns Promise resolving to parsed JSON data
+ * @throws DockerExecutionError if command fails
+ *
+ * @example
+ * ```typescript
+ * const container = await dockerInspect('my-container');
+ * console.log(container.State.Running);
+ * ```
+ */
+export async function dockerInspect(target, format) {
+    const formatArg = format ? `--format '${format}'` : '--format json';
+    const result = await executeDockerCommand(`inspect ${target} ${formatArg}`);
+    try {
+        // docker inspect returns an array, get first element
+        const parsed = JSON.parse(result.stdout);
+        return Array.isArray(parsed) ? parsed[0] : parsed;
+    }
+    catch (error) {
+        throw new DockerExecutionError(`Failed to parse docker inspect output for ${target}`, DockerErrorType.INVALID_COMMAND, `docker inspect ${target}`, 'Invalid JSON output');
+    }
+}
+/**
+ * Checks if a container is running
+ *
+ * @param containerName - Name or ID of the container
+ * @returns Promise resolving to true if running, false otherwise
+ *
+ * @example
+ * ```typescript
+ * if (await isContainerRunning('my-app')) {
+ *   console.log('Container is running');
+ * }
+ * ```
+ */
+export async function isContainerRunning(containerName) {
+    try {
+        const container = await dockerInspect(containerName);
+        return container?.State?.Running === true;
+    }
+    catch (error) {
+        if (error instanceof DockerExecutionError && error.type === DockerErrorType.NOT_FOUND) {
+            return false;
+        }
+        throw error;
+    }
+}
+/**
+ * Gets the status of a container
+ *
+ * @param containerName - Name or ID of the container
+ * @returns Promise resolving to container status object
+ *
+ * @example
+ * ```typescript
+ * const status = await getContainerStatus('my-app');
+ * console.log(status.State, status.Health);
+ * ```
+ */
+export async function getContainerStatus(containerName) {
+    const container = await dockerInspect(containerName);
+    const result = {
+        State: container.State?.Status || 'unknown',
+        Running: container.State?.Running || false,
+        Paused: container.State?.Paused || false,
+        Restarting: container.State?.Restarting || false,
+        Dead: container.State?.Dead || false,
+        Status: container.State?.Status || 'unknown',
+    };
+    if (container.State?.Health) {
+        result.Health = {
+            Status: container.State.Health.Status,
+            FailingStreak: container.State.Health.FailingStreak || 0,
+        };
+    }
+    return result;
+}
+/**
+ * Lists docker containers
+ *
+ * @param options - Options for listing containers
+ * @returns Promise resolving to array of container information
+ *
+ * @example
+ * ```typescript
+ * const containers = await listContainers({ all: true });
+ * containers.forEach(c => console.log(c.name, c.status));
+ * ```
+ */
+export async function listContainers(options = {}) {
+    const { all = false, format = 'json' } = options;
+    const allFlag = all ? '-a' : '';
+    const result = await executeDockerCommand(`ps ${allFlag} --format ${format}`);
+    if (!result.stdout) {
+        return [];
+    }
+    try {
+        // Parse JSON lines format
+        return result.stdout
+            .split('\n')
+            .filter(line => line.trim())
+            .map(line => JSON.parse(line));
+    }
+    catch (error) {
+        // If not JSON, return raw lines
+        return result.stdout.split('\n').filter(line => line.trim());
+    }
+}
+/**
+ * Starts a docker container
+ *
+ * @param containerName - Name or ID of the container
+ * @param options - Execution options
+ * @returns Promise resolving to command result
+ *
+ * @example
+ * ```typescript
+ * await startContainer('my-app');
+ * ```
+ */
+export async function startContainer(containerName, options) {
+    return executeDockerCommand(`start ${containerName}`, options);
+}
+/**
+ * Stops a docker container
+ *
+ * @param containerName - Name or ID of the container
+ * @param timeout - Timeout in seconds before killing (default: 10)
+ * @param options - Execution options
+ * @returns Promise resolving to command result
+ *
+ * @example
+ * ```typescript
+ * await stopContainer('my-app', 5);
+ * ```
+ */
+export async function stopContainer(containerName, timeout = 10, options) {
+    return executeDockerCommand(`stop -t ${timeout} ${containerName}`, options);
+}
+/**
+ * Restarts a docker container
+ *
+ * @param containerName - Name or ID of the container
+ * @param timeout - Timeout in seconds before killing (default: 10)
+ * @param options - Execution options
+ * @returns Promise resolving to command result
+ *
+ * @example
+ * ```typescript
+ * await restartContainer('my-app');
+ * ```
+ */
+export async function restartContainer(containerName, timeout = 10, options) {
+    return executeDockerCommand(`restart -t ${timeout} ${containerName}`, options);
+}
+/**
+ * Gets logs from a docker container
+ *
+ * @param containerName - Name or ID of the container
+ * @param options - Log options
+ * @returns Promise resolving to log output
+ *
+ * @example
+ * ```typescript
+ * const logs = await getContainerLogs('my-app', { tail: 100 });
+ * console.log(logs);
+ * ```
+ */
+export async function getContainerLogs(containerName, options = {}) {
+    const { tail, since, timestamps } = options;
+    let command = `logs ${containerName}`;
+    if (tail) {
+        command += ` --tail ${tail}`;
+    }
+    if (since) {
+        command += ` --since ${since}`;
+    }
+    if (timestamps) {
+        command += ' --timestamps';
+    }
+    const result = await executeDockerCommand(command);
+    return result.stdout;
+}
+/**
+ * Executes a command inside a running container
+ *
+ * @param containerName - Name or ID of the container
+ * @param command - Command to execute inside the container
+ * @param options - Execution options
+ * @returns Promise resolving to command result
+ *
+ * @example
+ * ```typescript
+ * const result = await execInContainer('my-app', 'ls -la');
+ * console.log(result.stdout);
+ * ```
+ */
+export async function execInContainer(containerName, command, options) {
+    return executeDockerCommand(`exec ${containerName} ${command}`, options);
+}
+/**
+ * Gets port mappings for a container
+ *
+ * @param containerName - Name or ID of the container
+ * @returns Promise resolving to port mapping object
+ *
+ * @example
+ * ```typescript
+ * const ports = await getContainerPorts('my-app');
+ * console.log(ports); // { "80/tcp": [{ HostIp: "0.0.0.0", HostPort: "8080" }] }
+ * ```
+ */
+export async function getContainerPorts(containerName) {
+    const container = await dockerInspect(containerName);
+    return container?.NetworkSettings?.Ports || {};
+}
+//# sourceMappingURL=docker-executor.js.map

package/dist/core/docker/docker-executor.js.map

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

package/dist/core/logging/index.d.ts

@@ -0,0 +1,7 @@
+/**
+ * Logging Module Exports
+ *
+ * Centralized logging system for Nexus CLI
+ */
+export { Logger, LogLevel, getLogger, setLogger, configureFromFlags, log, type LogEntry, type LoggerConfig, } from './logger.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/core/logging/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/core/logging/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EACL,MAAM,EACN,QAAQ,EACR,SAAS,EACT,SAAS,EACT,kBAAkB,EAClB,GAAG,EACH,KAAK,QAAQ,EACb,KAAK,YAAY,GAClB,MAAM,aAAa,CAAC"}

package/dist/core/logging/index.js

@@ -0,0 +1,7 @@
+/**
+ * Logging Module Exports
+ *
+ * Centralized logging system for Nexus CLI
+ */
+export { Logger, LogLevel, getLogger, setLogger, configureFromFlags, log, } from './logger.js';
+//# sourceMappingURL=index.js.map

package/dist/core/logging/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/core/logging/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EACL,MAAM,EACN,QAAQ,EACR,SAAS,EACT,SAAS,EACT,kBAAkB,EAClB,GAAG,GAGJ,MAAM,aAAa,CAAC"}