@kadi.build/deploy-ability 0.0.1

package/dist/targets/local/network-manager.js

@@ -0,0 +1,337 @@
+/**
+ * Docker Network Management Module
+ *
+ * Manages Docker/Podman networks for KADI deployments, ensuring
+ * required networks exist and are properly configured for inter-service
+ * communication.
+ *
+ * Key Features:
+ * - Network creation with idempotency (safe to call multiple times)
+ * - Network inspection and validation
+ * - Automatic conflict resolution
+ * - Type-safe Result returns
+ *
+ * @module targets/local/network-manager
+ */
+import debug from 'debug';
+import { success, failure, } from '../../types/index.js';
+import { DeploymentError } from '../../errors/index.js';
+import { runCommand } from '../../utils/command-runner.js';
+/**
+ * Debug logger for network operations
+ */
+const log = debug('deploy-ability:local:network');
+/**
+ * Checks if a Docker network exists
+ *
+ * Queries the container engine to verify if a network with the given
+ * name exists. Returns true if it exists, false otherwise.
+ *
+ * @param engine - Container engine to use
+ * @param networkName - Name of the network to check
+ * @param options - Network operation options
+ * @returns Result with boolean indicating existence
+ *
+ * @example
+ * ```typescript
+ * const result = await networkExists('docker', 'kadi-net');
+ *
+ * if (result.success && result.data) {
+ *   console.log('Network exists');
+ * } else if (result.success && !result.data) {
+ *   console.log('Network does not exist');
+ * } else {
+ *   console.error('Error checking network:', result.error.message);
+ * }
+ * ```
+ */
+export async function networkExists(engine, networkName, options = {}) {
+    const { timeout = 30_000, commandOptions } = options;
+    log('Checking if network %s exists', networkName);
+    const inspectCommand = `${engine} network inspect ${networkName}`;
+    const result = await runCommand(inspectCommand, {
+        ...commandOptions,
+        timeout,
+        silent: true,
+    });
+    if (result.success) {
+        log('Network %s exists', networkName);
+        return success(true);
+    }
+    // Check if this is a "not found" error vs other errors
+    const errorMessage = result.error.context.stderr || '';
+    const isNotFound = /no such network|not found|Error: network .* not found/i.test(errorMessage);
+    if (isNotFound) {
+        log('Network %s does not exist', networkName);
+        return success(false);
+    }
+    // Other error - return it
+    log('Error checking network %s: %s', networkName, result.error.message);
+    return failure(new DeploymentError(`Failed to check if network "${networkName}" exists`, 'NETWORK_CHECK_FAILED', {
+        engine,
+        networkName,
+        error: result.error.message,
+    }, true, 'Ensure the container engine is running and accessible', 'error', result.error));
+}
+/**
+ * Gets detailed information about a Docker network
+ *
+ * Retrieves and parses network information including driver, scope,
+ * and whether the network was created externally.
+ *
+ * @param engine - Container engine to use
+ * @param networkName - Name of the network to inspect
+ * @param options - Network operation options
+ * @returns Result with network information
+ *
+ * @example
+ * ```typescript
+ * const result = await getNetworkInfo('docker', 'kadi-net');
+ *
+ * if (result.success) {
+ *   console.log('Network ID:', result.data.id);
+ *   console.log('Driver:', result.data.driver);
+ *   console.log('Pre-existing:', result.data.preexisting);
+ * }
+ * ```
+ */
+export async function getNetworkInfo(engine, networkName, options = {}) {
+    const { timeout = 30_000, commandOptions } = options;
+    log('Getting info for network %s', networkName);
+    const inspectCommand = `${engine} network inspect ${networkName}`;
+    const result = await runCommand(inspectCommand, {
+        ...commandOptions,
+        timeout,
+        silent: true,
+    });
+    if (!result.success) {
+        log('Failed to get network info for %s: %s', networkName, result.error.message);
+        return failure(new DeploymentError(`Network "${networkName}" not found`, 'NETWORK_NOT_FOUND', {
+            engine,
+            networkName,
+            error: result.error.message,
+        }, true, `Create the network with: ${engine} network create ${networkName}`, 'error', result.error));
+    }
+    // Parse network info from JSON output
+    try {
+        const networks = JSON.parse(result.data.stdout);
+        if (!Array.isArray(networks) || networks.length === 0) {
+            log('Network inspect returned empty array for %s', networkName);
+            return failure(new DeploymentError(`Network "${networkName}" inspect returned no data`, 'NETWORK_INSPECT_EMPTY', {
+                engine,
+                networkName,
+            }, false, undefined, 'warning'));
+        }
+        const network = networks[0];
+        log('Network %s found: id=%s driver=%s', networkName, network.Id, network.Driver);
+        return success({
+            id: network.Id,
+            name: network.Name || networkName,
+            driver: network.Driver || 'bridge',
+            preexisting: true, // If we're inspecting it, it existed before this call
+        });
+    }
+    catch (error) {
+        log('Failed to parse network inspect JSON: %s', error.message);
+        return failure(new DeploymentError('Failed to parse network information', 'NETWORK_PARSE_ERROR', {
+            engine,
+            networkName,
+            stdout: result.data.stdout.substring(0, 200),
+            error: error.message,
+        }, false, undefined, 'error', error));
+    }
+}
+/**
+ * Creates a Docker network if it doesn't already exist
+ *
+ * This function is idempotent - safe to call multiple times. If the
+ * network already exists, it will return success with `preexisting: true`.
+ *
+ * Handles the common "already exists" error gracefully and returns
+ * structured network information.
+ *
+ * @param engine - Container engine to use
+ * @param networkName - Name of the network to create
+ * @param options - Network creation options
+ * @returns Result with network information
+ *
+ * @example Basic Usage
+ * ```typescript
+ * const result = await ensureNetwork('docker', 'kadi-net');
+ *
+ * if (result.success) {
+ *   if (result.data.preexisting) {
+ *     console.log('Network already existed');
+ *   } else {
+ *     console.log('Network created:', result.data.id);
+ *   }
+ * }
+ * ```
+ *
+ * @example With Custom Driver
+ * ```typescript
+ * const result = await ensureNetwork('docker', 'my-overlay-net', {
+ *   driver: 'overlay',
+ *   ipv6: true
+ * });
+ * ```
+ */
+export async function ensureNetwork(engine, networkName, options = {}) {
+    const { timeout = 30_000, driver = 'bridge', ipv6 = false, driverOpts, commandOptions, } = options;
+    log('Ensuring network %s exists (driver: %s)', networkName, driver);
+    // First, check if network already exists
+    const existsResult = await networkExists(engine, networkName, {
+        timeout,
+        commandOptions,
+    });
+    if (!existsResult.success) {
+        return failure(existsResult.error);
+    }
+    if (existsResult.data) {
+        log('Network %s already exists, getting info', networkName);
+        // Network exists - get its info
+        const infoResult = await getNetworkInfo(engine, networkName, {
+            timeout,
+            commandOptions,
+        });
+        if (infoResult.success) {
+            return success({
+                ...infoResult.data,
+                preexisting: true,
+            });
+        }
+        // Failed to get info but we know it exists - return minimal info
+        log('Failed to get network info, returning minimal data');
+        return success({
+            id: '',
+            name: networkName,
+            driver,
+            preexisting: true,
+        });
+    }
+    // Network doesn't exist - create it
+    log('Network %s does not exist, creating', networkName);
+    // Build create command with options
+    const createArgs = ['network', 'create'];
+    if (driver) {
+        createArgs.push('--driver', driver);
+    }
+    if (ipv6) {
+        createArgs.push('--ipv6');
+    }
+    if (driverOpts) {
+        for (const [key, value] of Object.entries(driverOpts)) {
+            createArgs.push('--opt', `${key}=${value}`);
+        }
+    }
+    createArgs.push(networkName);
+    const createCommand = `${engine} ${createArgs.join(' ')}`;
+    log('Creating network with command: %s', createCommand);
+    const createResult = await runCommand(createCommand, {
+        ...commandOptions,
+        timeout,
+        silent: true,
+    });
+    if (!createResult.success) {
+        // Check if this is an "already exists" error (race condition)
+        const errorMessage = createResult.error.context.stderr ||
+            createResult.error.message;
+        if (/already exists/i.test(errorMessage)) {
+            log('Network %s was created by another process (race condition)', networkName);
+            // Another process created it - get its info
+            const infoResult = await getNetworkInfo(engine, networkName, {
+                timeout,
+                commandOptions,
+            });
+            if (infoResult.success) {
+                return success({
+                    ...infoResult.data,
+                    preexisting: true,
+                });
+            }
+            // Couldn't get info but we know it exists
+            return success({
+                id: '',
+                name: networkName,
+                driver,
+                preexisting: true,
+            });
+        }
+        // Other error - return it
+        log('Failed to create network %s: %s', networkName, createResult.error.message);
+        return failure(new DeploymentError(`Failed to create network "${networkName}"`, 'NETWORK_CREATE_FAILED', {
+            engine,
+            networkName,
+            driver,
+            error: createResult.error.message,
+        }, true, 'Check container engine logs and ensure you have network creation permissions', 'error', createResult.error));
+    }
+    // Network created successfully
+    const networkId = createResult.data.stdout.trim();
+    log('Network %s created successfully: id=%s', networkName, networkId);
+    return success({
+        id: networkId,
+        name: networkName,
+        driver,
+        preexisting: false,
+    });
+}
+/**
+ * Removes a Docker network
+ *
+ * Deletes the specified network. Will fail if containers are still
+ * attached to the network.
+ *
+ * @param engine - Container engine to use
+ * @param networkName - Name of the network to remove
+ * @param options - Network operation options
+ * @returns Result indicating success or failure
+ *
+ * @example
+ * ```typescript
+ * const result = await removeNetwork('docker', 'kadi-net');
+ *
+ * if (result.success) {
+ *   console.log('Network removed');
+ * } else if (result.error.code === 'NETWORK_IN_USE') {
+ *   console.log('Network still has containers attached');
+ * }
+ * ```
+ */
+export async function removeNetwork(engine, networkName, options = {}) {
+    const { timeout = 30_000, commandOptions } = options;
+    log('Removing network %s', networkName);
+    const removeCommand = `${engine} network rm ${networkName}`;
+    const result = await runCommand(removeCommand, {
+        ...commandOptions,
+        timeout,
+        silent: true,
+    });
+    if (!result.success) {
+        const errorMessage = result.error.context.stderr || result.error.message;
+        // Check for common error cases
+        if (/has active endpoints|network .* has active endpoints/i.test(errorMessage)) {
+            log('Network %s has active endpoints', networkName);
+            return failure(new DeploymentError(`Network "${networkName}" has active containers attached`, 'NETWORK_IN_USE', {
+                engine,
+                networkName,
+                error: result.error.message,
+            }, true, `Stop all containers using this network first, then retry`, 'error', result.error));
+        }
+        if (/no such network|not found/i.test(errorMessage)) {
+            log('Network %s does not exist', networkName);
+            // Not found is actually success for removal
+            return success(undefined);
+        }
+        // Other error
+        log('Failed to remove network %s: %s', networkName, result.error.message);
+        return failure(new DeploymentError(`Failed to remove network "${networkName}"`, 'NETWORK_REMOVE_FAILED', {
+            engine,
+            networkName,
+            error: result.error.message,
+        }, true, 'Check container engine logs for details', 'error', result.error));
+    }
+    log('Network %s removed successfully', networkName);
+    return success(undefined);
+}
+//# sourceMappingURL=network-manager.js.map

package/dist/targets/local/network-manager.js.map

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

package/dist/targets/local/types.d.ts

@@ -0,0 +1,327 @@
+/**
+ * Local deployment target type definitions
+ *
+ * Types specific to local Docker/Podman deployment
+ *
+ * @module targets/local/types
+ */
+import type { ImageReference } from '../../types/index.js';
+/**
+ * Port mapping in Docker Compose format
+ *
+ * Format: "external:internal" (e.g., "8080:8080")
+ */
+export type PortMapping = `${number}:${number}`;
+/**
+ * Container restart policy
+ */
+export type RestartPolicy = 'no' | 'always' | 'on-failure' | 'unless-stopped';
+/**
+ * Volume mount specification
+ */
+export interface VolumeMount {
+    /**
+     * Source path or volume name
+     */
+    readonly source: string;
+    /**
+     * Target path inside container
+     */
+    readonly target: string;
+    /**
+     * Mount type
+     */
+    readonly type?: 'bind' | 'volume' | 'tmpfs';
+    /**
+     * Read-only mount
+     */
+    readonly readOnly?: boolean;
+}
+/**
+ * Network mode for container
+ */
+export type NetworkMode = 'bridge' | 'host' | 'none' | string;
+/**
+ * Healthcheck configuration
+ */
+export interface Healthcheck {
+    /**
+     * Test command
+     */
+    readonly test: readonly string[];
+    /**
+     * Interval between checks
+     */
+    readonly interval?: string;
+    /**
+     * Timeout for each check
+     */
+    readonly timeout?: string;
+    /**
+     * Number of retries before unhealthy
+     */
+    readonly retries?: number;
+    /**
+     * Start period before first check
+     */
+    readonly startPeriod?: string;
+}
+/**
+ * Service dependency
+ */
+export interface ServiceDependency {
+    /**
+     * Service name
+     */
+    readonly service: string;
+    /**
+     * Condition to wait for
+     */
+    readonly condition: 'service_started' | 'service_healthy' | 'service_completed_successfully';
+}
+/**
+ * Docker Compose service definition
+ *
+ * Strongly typed version with no `any` types
+ */
+export interface ComposeService {
+    /**
+     * Container image
+     */
+    readonly image: ImageReference;
+    /**
+     * Container name
+     */
+    readonly container_name?: string;
+    /**
+     * Build configuration (if building from Dockerfile)
+     */
+    readonly build?: {
+        readonly context: string;
+        readonly dockerfile?: string;
+        readonly args?: Record<string, string>;
+    };
+    /**
+     * Command override
+     */
+    readonly command?: readonly string[];
+    /**
+     * Entrypoint override
+     */
+    readonly entrypoint?: readonly string[];
+    /**
+     * Environment variables
+     */
+    readonly environment?: Record<string, string>;
+    /**
+     * Port mappings
+     */
+    readonly ports?: readonly string[];
+    /**
+     * Volume mounts
+     */
+    readonly volumes?: readonly string[];
+    /**
+     * Networks this service connects to
+     */
+    readonly networks?: readonly string[];
+    /**
+     * Service dependencies
+     */
+    readonly depends_on?: readonly string[] | Record<string, ServiceDependency>;
+    /**
+     * Restart policy
+     */
+    readonly restart?: RestartPolicy;
+    /**
+     * Healthcheck configuration
+     */
+    readonly healthcheck?: Healthcheck;
+    /**
+     * Working directory
+     */
+    readonly working_dir?: string;
+    /**
+     * User to run as
+     */
+    readonly user?: string;
+    /**
+     * Enable TTY
+     */
+    readonly tty?: boolean;
+    /**
+     * Keep stdin open
+     */
+    readonly stdin_open?: boolean;
+    /**
+     * Privileged mode
+     */
+    readonly privileged?: boolean;
+    /**
+     * Extra hosts
+     */
+    readonly extra_hosts?: readonly string[];
+    /**
+     * DNS servers
+     */
+    readonly dns?: readonly string[];
+    /**
+     * Resource limits (Compose v3)
+     */
+    readonly deploy?: {
+        readonly resources?: {
+            readonly limits?: {
+                readonly cpus?: string;
+                readonly memory?: string;
+            };
+            readonly reservations?: {
+                readonly cpus?: string;
+                readonly memory?: string;
+            };
+        };
+    };
+}
+/**
+ * Docker network configuration
+ */
+export interface ComposeNetwork {
+    /**
+     * Network driver
+     */
+    readonly driver?: 'bridge' | 'host' | 'overlay' | 'macvlan' | 'none' | string;
+    /**
+     * External network (already exists)
+     */
+    readonly external?: boolean;
+    /**
+     * Network name (for external networks)
+     */
+    readonly name?: string;
+    /**
+     * Driver options
+     */
+    readonly driver_opts?: Record<string, string>;
+    /**
+     * Enable IPv6
+     */
+    readonly enable_ipv6?: boolean;
+    /**
+     * IPAM configuration
+     */
+    readonly ipam?: {
+        readonly driver?: string;
+        readonly config?: ReadonlyArray<{
+            readonly subnet?: string;
+            readonly ip_range?: string;
+            readonly gateway?: string;
+        }>;
+    };
+}
+/**
+ * Docker Compose file structure
+ *
+ * Complete type-safe representation of docker-compose.yml
+ */
+export interface ComposeFile {
+    /**
+     * Compose file version
+     */
+    readonly version: string;
+    /**
+     * Services to deploy
+     */
+    readonly services: Readonly<Record<string, ComposeService>>;
+    /**
+     * Networks configuration
+     */
+    readonly networks?: Readonly<Record<string, ComposeNetwork>>;
+    /**
+     * Volumes configuration
+     */
+    readonly volumes?: Readonly<Record<string, {
+        readonly driver?: string;
+        readonly driver_opts?: Record<string, string>;
+        readonly external?: boolean;
+        readonly name?: string;
+    }>>;
+}
+/**
+ * Container status from Docker/Podman
+ */
+export type ContainerStatus = 'created' | 'running' | 'paused' | 'restarting' | 'removing' | 'exited' | 'dead';
+/**
+ * Container information
+ */
+export interface ContainerInfo {
+    /**
+     * Container ID
+     */
+    readonly id: string;
+    /**
+     * Container name
+     */
+    readonly name: string;
+    /**
+     * Container status
+     */
+    readonly status: ContainerStatus;
+    /**
+     * Image used
+     */
+    readonly image: ImageReference;
+    /**
+     * Ports exposed
+     */
+    readonly ports: ReadonlyArray<{
+        readonly internal: number;
+        readonly external?: number;
+        readonly protocol: 'tcp' | 'udp';
+    }>;
+    /**
+     * When container was created
+     */
+    readonly createdAt: Date;
+    /**
+     * When container started (if running)
+     */
+    readonly startedAt?: Date;
+}
+/**
+ * Network information
+ */
+export interface NetworkInfo {
+    /**
+     * Network ID
+     */
+    readonly id: string;
+    /**
+     * Network name
+     */
+    readonly name: string;
+    /**
+     * Network driver
+     */
+    readonly driver: string;
+    /**
+     * Whether network already existed
+     */
+    readonly preexisting: boolean;
+}
+/**
+ * Validation error for service configuration
+ */
+export interface ServiceValidationError {
+    /**
+     * Service name
+     */
+    readonly service: string;
+    /**
+     * Field that failed validation
+     */
+    readonly field: string;
+    /**
+     * Error message
+     */
+    readonly message: string;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/targets/local/types.d.ts.map

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

package/dist/targets/local/types.js

@@ -0,0 +1,9 @@
+/**
+ * Local deployment target type definitions
+ *
+ * Types specific to local Docker/Podman deployment
+ *
+ * @module targets/local/types
+ */
+export {};
+//# sourceMappingURL=types.js.map