@kadi.build/deploy-ability 0.0.1

package/dist/types/validators.js

@@ -0,0 +1,198 @@
+/**
+ * Type Validators and Constructors for Branded Types
+ *
+ * This module provides runtime validation and safe constructors for branded types
+ * using Zod. Instead of blind type assertions (as SomeType), these schemas validate
+ * input and provide compile-time guarantees.
+ *
+ * **Philosophy:**
+ * - Branded types provide documentation and prevent mixing incompatible values
+ * - Zod schemas enforce the brand contract at runtime
+ * - Single point of validation - once created, branded values are trusted
+ *
+ * **Why Zod:**
+ * - Composable, reusable schemas
+ * - Excellent error messages
+ * - Type inference works perfectly with branded types
+ * - Industry standard (Vercel, tRPC, Remix, etc.)
+ *
+ * @module types/validators
+ */
+import { z } from 'zod';
+// =============================================================================
+// Wallet Address Validation
+// =============================================================================
+/**
+ * Zod schema for Akash wallet addresses
+ *
+ * Akash wallet addresses are bech32-encoded and always start with "akash1".
+ *
+ * **Validation rules:**
+ * - Must start with "akash1"
+ * - Must be at least 44 characters (akash1 + 38 character bech32 address)
+ * - Must contain only lowercase alphanumeric characters (bech32 charset)
+ *
+ * **Note:** This performs basic format validation. It does NOT verify:
+ * - Whether the address exists on-chain
+ * - Whether the checksum is valid (full bech32 validation would require additional library)
+ *
+ * @example Valid addresses
+ * ```typescript
+ * WalletAddressSchema.parse('akash1...');  // 44+ chars starting with akash1
+ * ```
+ *
+ * @example Invalid addresses (will throw ZodError)
+ * ```typescript
+ * WalletAddressSchema.parse('cosmos1...');  // Wrong prefix
+ * WalletAddressSchema.parse('akash1abc');   // Too short
+ * WalletAddressSchema.parse('AKASH1...');   // Uppercase not allowed
+ * ```
+ */
+const WalletAddressSchemaInternal = z
+    .string()
+    .min(44, 'Wallet address must be at least 44 characters')
+    .startsWith('akash1', 'Wallet address must start with "akash1"')
+    .regex(/^akash1[02-9ac-hj-np-z]+$/, 'Wallet address must be lowercase bech32 format');
+export const WalletAddressSchema = WalletAddressSchemaInternal;
+/**
+ * Validates and creates a WalletAddress branded type
+ *
+ * Throws ZodError if validation fails with detailed error messages.
+ *
+ * @param address - String to validate as wallet address
+ * @returns Branded WalletAddress
+ * @throws {ZodError} If address format is invalid
+ *
+ * @example
+ * ```typescript
+ * const addr = createWalletAddress('akash1...');
+ * ```
+ */
+export function createWalletAddress(address) {
+    WalletAddressSchema.parse(address);
+    return address;
+}
+/**
+ * Type guard to check if a string is a valid wallet address
+ *
+ * @param address - String to check
+ * @returns true if address is valid
+ *
+ * @example
+ * ```typescript
+ * if (isWalletAddress(address)) {
+ *   // TypeScript knows address is WalletAddress
+ * }
+ * ```
+ */
+export function isWalletAddress(address) {
+    return WalletAddressSchema.safeParse(address).success;
+}
+/**
+ * Safely converts unknown value to WalletAddress
+ *
+ * Returns undefined instead of throwing if validation fails.
+ * Useful for optional fields or untrusted input.
+ *
+ * @param value - Value to convert
+ * @returns WalletAddress if valid, undefined otherwise
+ *
+ * @example
+ * ```typescript
+ * const addr = toWalletAddress(untrustedInput);
+ * if (addr) {
+ *   // Use validated address
+ * }
+ * ```
+ */
+export function toWalletAddress(value) {
+    const result = WalletAddressSchema.safeParse(value);
+    return result.success ? result.data : undefined;
+}
+// =============================================================================
+// Deployment Sequence Validation
+// =============================================================================
+/**
+ * Zod schema for deployment sequences (dseq)
+ *
+ * Deployment sequences are positive integers assigned by the Akash blockchain
+ * to uniquely identify deployments. They start from 1 and increment.
+ *
+ * **Validation rules:**
+ * - Must be a positive integer (>= 1)
+ * - Must be a safe integer (within JavaScript's MAX_SAFE_INTEGER)
+ *
+ * @example Valid dseq
+ * ```typescript
+ * DeploymentSequenceSchema.parse(12345);  // ✓
+ * ```
+ *
+ * @example Invalid dseq (will throw ZodError)
+ * ```typescript
+ * DeploymentSequenceSchema.parse(0);      // Must be >= 1
+ * DeploymentSequenceSchema.parse(-100);   // Must be positive
+ * DeploymentSequenceSchema.parse(1.5);    // Must be integer
+ * ```
+ */
+const DeploymentSequenceSchemaInternal = z
+    .number()
+    .int('Deployment sequence must be an integer')
+    .positive('Deployment sequence must be positive')
+    .min(1, 'Deployment sequence must be at least 1')
+    .safe('Deployment sequence exceeds safe integer range');
+export const DeploymentSequenceSchema = DeploymentSequenceSchemaInternal;
+/**
+ * Validates and creates a DeploymentSequence branded type
+ *
+ * Throws ZodError if validation fails.
+ *
+ * @param dseq - Number to validate as deployment sequence
+ * @returns Branded DeploymentSequence
+ * @throws {ZodError} If dseq is invalid
+ *
+ * @example
+ * ```typescript
+ * const dseq = createDeploymentSequence(12345);
+ * ```
+ */
+export function createDeploymentSequence(dseq) {
+    DeploymentSequenceSchema.parse(dseq);
+    return dseq;
+}
+/**
+ * Type guard to check if a number is a valid deployment sequence
+ *
+ * @param dseq - Number to check
+ * @returns true if dseq is valid
+ *
+ * @example
+ * ```typescript
+ * if (isDeploymentSequence(dseq)) {
+ *   // TypeScript knows dseq is DeploymentSequence
+ * }
+ * ```
+ */
+export function isDeploymentSequence(dseq) {
+    return DeploymentSequenceSchema.safeParse(dseq).success;
+}
+/**
+ * Safely converts unknown value to DeploymentSequence
+ *
+ * Returns undefined instead of throwing if validation fails.
+ *
+ * @param value - Value to convert
+ * @returns DeploymentSequence if valid, undefined otherwise
+ *
+ * @example
+ * ```typescript
+ * const dseq = toDeploymentSequence(untrustedInput);
+ * if (dseq) {
+ *   // Use validated dseq
+ * }
+ * ```
+ */
+export function toDeploymentSequence(value) {
+    const result = DeploymentSequenceSchema.safeParse(value);
+    return result.success ? result.data : undefined;
+}
+//# sourceMappingURL=validators.js.map

package/dist/types/validators.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"validators.js","sourceRoot":"","sources":["../../src/types/validators.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;GAmBG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAGxB,gFAAgF;AAChF,4BAA4B;AAC5B,gFAAgF;AAEhF;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AACH,MAAM,2BAA2B,GAAG,CAAC;KAClC,MAAM,EAAE;KACR,GAAG,CAAC,EAAE,EAAE,+CAA+C,CAAC;KACxD,UAAU,CAAC,QAAQ,EAAE,yCAAyC,CAAC;KAC/D,KAAK,CACJ,2BAA2B,EAC3B,gDAAgD,CACjD,CAAC;AAEJ,MAAM,CAAC,MAAM,mBAAmB,GAAG,2BAA2B,CAAC;AAE/D;;;;;;;;;;;;;GAaG;AACH,MAAM,UAAU,mBAAmB,CAAC,OAAe;IACjD,mBAAmB,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;IACnC,OAAO,OAAwB,CAAC;AAClC,CAAC;AAED;;;;;;;;;;;;GAYG;AACH,MAAM,UAAU,eAAe,CAAC,OAAe;IAC7C,OAAO,mBAAmB,CAAC,SAAS,CAAC,OAAO,CAAC,CAAC,OAAO,CAAC;AACxD,CAAC;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,MAAM,UAAU,eAAe,CAAC,KAAc;IAC5C,MAAM,MAAM,GAAG,mBAAmB,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC;IACpD,OAAO,MAAM,CAAC,OAAO,CAAC,CAAC,CAAE,MAAM,CAAC,IAAsB,CAAC,CAAC,CAAC,SAAS,CAAC;AACrE,CAAC;AAED,gFAAgF;AAChF,iCAAiC;AACjC,gFAAgF;AAEhF;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,MAAM,gCAAgC,GAAG,CAAC;KACvC,MAAM,EAAE;KACR,GAAG,CAAC,wCAAwC,CAAC;KAC7C,QAAQ,CAAC,sCAAsC,CAAC;KAChD,GAAG,CAAC,CAAC,EAAE,wCAAwC,CAAC;KAChD,IAAI,CAAC,gDAAgD,CAAC,CAAC;AAE1D,MAAM,CAAC,MAAM,wBAAwB,GAAG,gCAAgC,CAAC;AAEzE;;;;;;;;;;;;;GAaG;AACH,MAAM,UAAU,wBAAwB,CAAC,IAAY;IACnD,wBAAwB,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;IACrC,OAAO,IAA0B,CAAC;AACpC,CAAC;AAED;;;;;;;;;;;;GAYG;AACH,MAAM,UAAU,oBAAoB,CAAC,IAAY;IAC/C,OAAO,wBAAwB,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC,OAAO,CAAC;AAC1D,CAAC;AAED;;;;;;;;;;;;;;;GAeG;AACH,MAAM,UAAU,oBAAoB,CAAC,KAAc;IACjD,MAAM,MAAM,GAAG,wBAAwB,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC;IACzD,OAAO,MAAM,CAAC,OAAO,CAAC,CAAC,CAAE,MAAM,CAAC,IAA2B,CAAC,CAAC,CAAC,SAAS,CAAC;AAC1E,CAAC"}

package/dist/utils/command-runner.d.ts

@@ -0,0 +1,128 @@
+/**
+ * Command execution utilities
+ *
+ * Provides type-safe command execution with Result types,
+ * timeout support, and proper error handling.
+ *
+ * @module utils/command-runner
+ */
+import { type Result } from '../types/index.js';
+import { DeploymentError } from '../errors/index.js';
+/**
+ * Options for command execution
+ */
+export interface CommandOptions {
+    /**
+     * Working directory for command execution
+     */
+    readonly cwd?: string;
+    /**
+     * Environment variables to set
+     */
+    readonly env?: Record<string, string>;
+    /**
+     * Timeout in milliseconds
+     * @default 120000 (2 minutes)
+     */
+    readonly timeout?: number;
+    /**
+     * Silent mode - capture output instead of streaming
+     * @default false
+     */
+    readonly silent?: boolean;
+    /**
+     * Abort signal for cancellation
+     */
+    readonly signal?: AbortSignal;
+}
+/**
+ * Command execution result data
+ */
+export interface CommandResult {
+    /**
+     * Standard output from the command
+     */
+    readonly stdout: string;
+    /**
+     * Standard error output from the command
+     */
+    readonly stderr: string;
+    /**
+     * Exit code
+     */
+    readonly exitCode: number;
+    /**
+     * Execution time in milliseconds
+     */
+    readonly duration: number;
+}
+/**
+ * Execute a shell command with proper error handling
+ *
+ * Returns a Result type instead of throwing, making error handling explicit
+ * and type-safe.
+ *
+ * @param command - Command to execute
+ * @param options - Execution options
+ * @returns Result with command output or error
+ *
+ * @example
+ * ```typescript
+ * const result = await runCommand('docker version', { silent: true });
+ *
+ * if (result.success) {
+ *   console.log('Docker version:', result.data.stdout);
+ * } else {
+ *   console.error('Command failed:', result.error.message);
+ * }
+ * ```
+ *
+ * @example With timeout and abort
+ * ```typescript
+ * const controller = new AbortController();
+ * setTimeout(() => controller.abort(), 5000);
+ *
+ * const result = await runCommand('long-running-command', {
+ *   timeout: 10000,
+ *   signal: controller.signal
+ * });
+ * ```
+ */
+export declare function runCommand(command: string, options?: CommandOptions): Promise<Result<CommandResult, DeploymentError>>;
+/**
+ * Execute a command and return only stdout
+ *
+ * Convenience wrapper that throws on error and returns just the stdout string
+ *
+ * @param command - Command to execute
+ * @param options - Execution options
+ * @returns Standard output from the command
+ * @throws {DeploymentError} If command fails
+ *
+ * @example
+ * ```typescript
+ * try {
+ *   const version = await runCommandSimple('docker --version', { silent: true });
+ *   console.log(version);
+ * } catch (error) {
+ *   console.error('Failed:', error.message);
+ * }
+ * ```
+ */
+export declare function runCommandSimple(command: string, options?: CommandOptions): Promise<string>;
+/**
+ * Check if a command exists in the system PATH
+ *
+ * @param command - Command name to check
+ * @returns True if command exists
+ *
+ * @example
+ * ```typescript
+ * const hasDocker = await commandExists('docker');
+ * if (!hasDocker) {
+ *   console.error('Docker is not installed');
+ * }
+ * ```
+ */
+export declare function commandExists(command: string): Promise<boolean>;
+//# sourceMappingURL=command-runner.d.ts.map

package/dist/utils/command-runner.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"command-runner.d.ts","sourceRoot":"","sources":["../../src/utils/command-runner.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAIH,OAAO,EAAE,KAAK,MAAM,EAAoB,MAAM,mBAAmB,CAAC;AAClE,OAAO,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC;AAOrD;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B;;OAEG;IACH,QAAQ,CAAC,GAAG,CAAC,EAAE,MAAM,CAAC;IAEtB;;OAEG;IACH,QAAQ,CAAC,GAAG,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAEtC;;;OAGG;IACH,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC;IAE1B;;;OAGG;IACH,QAAQ,CAAC,MAAM,CAAC,EAAE,OAAO,CAAC;IAE1B;;OAEG;IACH,QAAQ,CAAC,MAAM,CAAC,EAAE,WAAW,CAAC;CAC/B;AAED;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B;;OAEG;IACH,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IAExB;;OAEG;IACH,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IAExB;;OAEG;IACH,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAE1B;;OAEG;IACH,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;CAC3B;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA+BG;AACH,wBAAsB,UAAU,CAC9B,OAAO,EAAE,MAAM,EACf,OAAO,GAAE,cAAmB,GAC3B,OAAO,CAAC,MAAM,CAAC,aAAa,EAAE,eAAe,CAAC,CAAC,CA4LjD;AAED;;;;;;;;;;;;;;;;;;;GAmBG;AACH,wBAAsB,gBAAgB,CACpC,OAAO,EAAE,MAAM,EACf,OAAO,GAAE,cAAmB,GAC3B,OAAO,CAAC,MAAM,CAAC,CAQjB;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAsB,aAAa,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAcrE"}

package/dist/utils/command-runner.js

@@ -0,0 +1,210 @@
+/**
+ * Command execution utilities
+ *
+ * Provides type-safe command execution with Result types,
+ * timeout support, and proper error handling.
+ *
+ * @module utils/command-runner
+ */
+import { spawn } from 'node:child_process';
+import debug from 'debug';
+import { success, failure } from '../types/index.js';
+import { DeploymentError } from '../errors/index.js';
+/**
+ * Debug logger for command execution
+ */
+const log = debug('deploy-ability:command');
+/**
+ * Execute a shell command with proper error handling
+ *
+ * Returns a Result type instead of throwing, making error handling explicit
+ * and type-safe.
+ *
+ * @param command - Command to execute
+ * @param options - Execution options
+ * @returns Result with command output or error
+ *
+ * @example
+ * ```typescript
+ * const result = await runCommand('docker version', { silent: true });
+ *
+ * if (result.success) {
+ *   console.log('Docker version:', result.data.stdout);
+ * } else {
+ *   console.error('Command failed:', result.error.message);
+ * }
+ * ```
+ *
+ * @example With timeout and abort
+ * ```typescript
+ * const controller = new AbortController();
+ * setTimeout(() => controller.abort(), 5000);
+ *
+ * const result = await runCommand('long-running-command', {
+ *   timeout: 10000,
+ *   signal: controller.signal
+ * });
+ * ```
+ */
+export async function runCommand(command, options = {}) {
+    const { cwd, env, timeout = 120_000, silent = false, signal, } = options;
+    log('Executing command: %s', command);
+    if (cwd)
+        log('Working directory: %s', cwd);
+    if (timeout)
+        log('Timeout: %dms', timeout);
+    const startTime = Date.now();
+    return new Promise((resolve) => {
+        // Check if already aborted
+        if (signal?.aborted) {
+            resolve(failure(new DeploymentError('Command execution was cancelled', 'COMMAND_CANCELLED', { command }, false, undefined, 'warning')));
+            return;
+        }
+        const child = spawn(command, {
+            cwd,
+            env: env ? { ...process.env, ...env } : undefined,
+            shell: true,
+            stdio: silent ? ['ignore', 'pipe', 'pipe'] : 'inherit',
+        });
+        let stdout = '';
+        let stderr = '';
+        let timeoutId;
+        let killed = false;
+        // Capture output if in silent mode
+        if (silent) {
+            child.stdout?.on('data', (chunk) => {
+                stdout += chunk.toString();
+            });
+            child.stderr?.on('data', (chunk) => {
+                stderr += chunk.toString();
+            });
+        }
+        // Setup timeout
+        if (timeout > 0) {
+            timeoutId = setTimeout(() => {
+                if (!killed) {
+                    log('Command timed out after %dms: %s', timeout, command);
+                    killed = true;
+                    child.kill('SIGTERM');
+                    // Force kill after 5 seconds if still running
+                    setTimeout(() => {
+                        if (!child.killed) {
+                            child.kill('SIGKILL');
+                        }
+                    }, 5000);
+                }
+            }, timeout);
+        }
+        // Setup abort signal handler
+        const abortHandler = () => {
+            if (!killed && !child.killed) {
+                log('Command aborted: %s', command);
+                killed = true;
+                child.kill('SIGTERM');
+                setTimeout(() => {
+                    if (!child.killed) {
+                        child.kill('SIGKILL');
+                    }
+                }, 5000);
+            }
+        };
+        signal?.addEventListener('abort', abortHandler);
+        // Handle process errors
+        child.on('error', (error) => {
+            if (timeoutId)
+                clearTimeout(timeoutId);
+            signal?.removeEventListener('abort', abortHandler);
+            log('Command error: %s', error.message);
+            resolve(failure(new DeploymentError(`Failed to execute command: ${error.message}`, 'COMMAND_EXECUTION_ERROR', { command, error: error.message }, true, 'Check that the command exists and is executable', 'error', error)));
+        });
+        // Handle process exit
+        child.on('close', (exitCode) => {
+            if (timeoutId)
+                clearTimeout(timeoutId);
+            signal?.removeEventListener('abort', abortHandler);
+            const duration = Date.now() - startTime;
+            log('Command completed in %dms with exit code %d', duration, exitCode);
+            // Handle timeout
+            if (killed && signal?.aborted) {
+                resolve(failure(new DeploymentError('Command execution was cancelled', 'COMMAND_CANCELLED', { command, duration }, false, undefined, 'warning')));
+                return;
+            }
+            if (killed) {
+                resolve(failure(new DeploymentError(`Command timed out after ${timeout}ms`, 'COMMAND_TIMEOUT', { command, timeout, duration }, true, 'Try increasing the timeout or check if the command is hanging', 'error')));
+                return;
+            }
+            // Success case
+            if (exitCode === 0) {
+                resolve(success({
+                    stdout,
+                    stderr,
+                    exitCode: 0,
+                    duration,
+                }));
+                return;
+            }
+            // Non-zero exit code
+            resolve(failure(new DeploymentError(`Command failed with exit code ${exitCode}`, 'COMMAND_FAILED', {
+                command,
+                exitCode,
+                stdout: silent ? stdout : undefined,
+                stderr: silent ? stderr : undefined,
+                duration,
+            }, true, 'Check command output for error details', 'error')));
+        });
+    });
+}
+/**
+ * Execute a command and return only stdout
+ *
+ * Convenience wrapper that throws on error and returns just the stdout string
+ *
+ * @param command - Command to execute
+ * @param options - Execution options
+ * @returns Standard output from the command
+ * @throws {DeploymentError} If command fails
+ *
+ * @example
+ * ```typescript
+ * try {
+ *   const version = await runCommandSimple('docker --version', { silent: true });
+ *   console.log(version);
+ * } catch (error) {
+ *   console.error('Failed:', error.message);
+ * }
+ * ```
+ */
+export async function runCommandSimple(command, options = {}) {
+    const result = await runCommand(command, { ...options, silent: true });
+    if (result.success) {
+        return result.data.stdout.trim();
+    }
+    throw result.error;
+}
+/**
+ * Check if a command exists in the system PATH
+ *
+ * @param command - Command name to check
+ * @returns True if command exists
+ *
+ * @example
+ * ```typescript
+ * const hasDocker = await commandExists('docker');
+ * if (!hasDocker) {
+ *   console.error('Docker is not installed');
+ * }
+ * ```
+ */
+export async function commandExists(command) {
+    // Validate command is not empty
+    if (!command || command.trim().length === 0) {
+        log('Command is empty, returning false');
+        return false;
+    }
+    const checkCommand = process.platform === 'win32'
+        ? `where ${command}`
+        : `command -v ${command}`;
+    const result = await runCommand(checkCommand, { silent: true });
+    return result.success;
+}
+//# sourceMappingURL=command-runner.js.map

package/dist/utils/command-runner.js.map

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

package/dist/utils/index.d.ts

@@ -0,0 +1,10 @@
+/**
+ * Utilities barrel export
+ *
+ * @module utils
+ */
+export { ConsoleLogger, SilentLogger, createLogger, defaultLogger, } from './logger.js';
+export { loadAgentConfig, loadDeploymentProfile, loadFirstProfile, loadProfile, getAvailableProfiles, } from './profile-loader.js';
+export { runCommand, runCommandSimple, commandExists, type CommandOptions, type CommandResult, } from './command-runner.js';
+export { setupRegistryIfNeeded, hasLocalImages, TemporaryContainerRegistryManager, transformProfileWithRegistry, isLocalImagePattern, type RegistryContext, type RegistryOptions, type ContainerMapping, type RegistryCredentials, type RegistryInfo, type RegistryUrls, type ContainerInfo, } from './registry/index.js';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/utils/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EACL,aAAa,EACb,YAAY,EACZ,YAAY,EACZ,aAAa,GACd,MAAM,aAAa,CAAC;AAErB,OAAO,EACL,eAAe,EACf,qBAAqB,EACrB,gBAAgB,EAChB,WAAW,EACX,oBAAoB,GACrB,MAAM,qBAAqB,CAAC;AAE7B,OAAO,EACL,UAAU,EACV,gBAAgB,EAChB,aAAa,EACb,KAAK,cAAc,EACnB,KAAK,aAAa,GACnB,MAAM,qBAAqB,CAAC;AAE7B,OAAO,EACL,qBAAqB,EACrB,cAAc,EACd,iCAAiC,EACjC,4BAA4B,EAC5B,mBAAmB,EACnB,KAAK,eAAe,EACpB,KAAK,eAAe,EACpB,KAAK,gBAAgB,EACrB,KAAK,mBAAmB,EACxB,KAAK,YAAY,EACjB,KAAK,YAAY,EACjB,KAAK,aAAa,GACnB,MAAM,qBAAqB,CAAC"}

package/dist/utils/index.js

@@ -0,0 +1,10 @@
+/**
+ * Utilities barrel export
+ *
+ * @module utils
+ */
+export { ConsoleLogger, SilentLogger, createLogger, defaultLogger, } from './logger.js';
+export { loadAgentConfig, loadDeploymentProfile, loadFirstProfile, loadProfile, getAvailableProfiles, } from './profile-loader.js';
+export { runCommand, runCommandSimple, commandExists, } from './command-runner.js';
+export { setupRegistryIfNeeded, hasLocalImages, TemporaryContainerRegistryManager, transformProfileWithRegistry, isLocalImagePattern, } from './registry/index.js';
+//# sourceMappingURL=index.js.map

package/dist/utils/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/utils/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EACL,aAAa,EACb,YAAY,EACZ,YAAY,EACZ,aAAa,GACd,MAAM,aAAa,CAAC;AAErB,OAAO,EACL,eAAe,EACf,qBAAqB,EACrB,gBAAgB,EAChB,WAAW,EACX,oBAAoB,GACrB,MAAM,qBAAqB,CAAC;AAE7B,OAAO,EACL,UAAU,EACV,gBAAgB,EAChB,aAAa,GAGd,MAAM,qBAAqB,CAAC;AAE7B,OAAO,EACL,qBAAqB,EACrB,cAAc,EACd,iCAAiC,EACjC,4BAA4B,EAC5B,mBAAmB,GAQpB,MAAM,qBAAqB,CAAC"}

package/dist/utils/logger.d.ts

@@ -0,0 +1,68 @@
+/**
+ * Logger utilities
+ *
+ * Provides default logger implementation and logger factory functions
+ *
+ * @module utils/logger
+ */
+import type { DeploymentLogger } from '../types/index.js';
+/**
+ * Default console-based logger implementation
+ *
+ * Uses console methods for output with timestamps and level prefixes
+ */
+export declare class ConsoleLogger implements DeploymentLogger {
+    private readonly verbose;
+    constructor(verbose?: boolean);
+    /**
+     * Log informational message
+     */
+    log(message: string, ...args: unknown[]): void;
+    /**
+     * Log error message
+     */
+    error(message: string, ...args: unknown[]): void;
+    /**
+     * Log warning message
+     */
+    warn(message: string, ...args: unknown[]): void;
+    /**
+     * Log debug message (only if verbose mode enabled)
+     */
+    debug(message: string, ...args: unknown[]): void;
+    /**
+     * Get current timestamp for log messages
+     */
+    private getTimestamp;
+}
+/**
+ * Silent logger that discards all output
+ *
+ * Useful for testing or when logging is not desired
+ */
+export declare class SilentLogger implements DeploymentLogger {
+    log(_message: string, ..._args: unknown[]): void;
+    error(_message: string, ..._args: unknown[]): void;
+    warn(_message: string, ..._args: unknown[]): void;
+    debug(_message: string, ..._args: unknown[]): void;
+}
+/**
+ * Create a logger instance
+ *
+ * @param options - Logger configuration options
+ * @returns Logger instance
+ *
+ * @example
+ * const logger = createLogger({ verbose: true });
+ * logger.log('Deployment started');
+ */
+export declare function createLogger(options: {
+    verbose?: boolean;
+    silent?: boolean;
+    custom?: DeploymentLogger;
+}): DeploymentLogger;
+/**
+ * Default logger instance (console-based, non-verbose)
+ */
+export declare const defaultLogger: DeploymentLogger;
+//# sourceMappingURL=logger.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"logger.d.ts","sourceRoot":"","sources":["../../src/utils/logger.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,mBAAmB,CAAC;AAE1D;;;;GAIG;AACH,qBAAa,aAAc,YAAW,gBAAgB;IACpD,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAU;gBAEtB,OAAO,GAAE,OAAe;IAIpC;;OAEG;IACH,GAAG,CAAC,OAAO,EAAE,MAAM,EAAE,GAAG,IAAI,EAAE,OAAO,EAAE,GAAG,IAAI;IAI9C;;OAEG;IACH,KAAK,CAAC,OAAO,EAAE,MAAM,EAAE,GAAG,IAAI,EAAE,OAAO,EAAE,GAAG,IAAI;IAIhD;;OAEG;IACH,IAAI,CAAC,OAAO,EAAE,MAAM,EAAE,GAAG,IAAI,EAAE,OAAO,EAAE,GAAG,IAAI;IAI/C;;OAEG;IACH,KAAK,CAAC,OAAO,EAAE,MAAM,EAAE,GAAG,IAAI,EAAE,OAAO,EAAE,GAAG,IAAI;IAMhD;;OAEG;IACH,OAAO,CAAC,YAAY;CAGrB;AAED;;;;GAIG;AACH,qBAAa,YAAa,YAAW,gBAAgB;IACnD,GAAG,CAAC,QAAQ,EAAE,MAAM,EAAE,GAAG,KAAK,EAAE,OAAO,EAAE,GAAG,IAAI;IAIhD,KAAK,CAAC,QAAQ,EAAE,MAAM,EAAE,GAAG,KAAK,EAAE,OAAO,EAAE,GAAG,IAAI;IAIlD,IAAI,CAAC,QAAQ,EAAE,MAAM,EAAE,GAAG,KAAK,EAAE,OAAO,EAAE,GAAG,IAAI;IAIjD,KAAK,CAAC,QAAQ,EAAE,MAAM,EAAE,GAAG,KAAK,EAAE,OAAO,EAAE,GAAG,IAAI;CAGnD;AAED;;;;;;;;;GASG;AACH,wBAAgB,YAAY,CAAC,OAAO,EAAE;IACpC,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,MAAM,CAAC,EAAE,gBAAgB,CAAC;CAC3B,GAAG,gBAAgB,CAUnB;AAED;;GAEG;AACH,eAAO,MAAM,aAAa,EAAE,gBAA2C,CAAC"}