@simplens/onboard 1.0.0

package/dist/types/errors.js

@@ -0,0 +1,129 @@
+/**
+ * Custom error types for better error handling and troubleshooting
+ */
+/**
+ * Base error class for all onboarding errors
+ */
+export class OnboardingError extends Error {
+    code;
+    troubleshooting;
+    constructor(code, message, troubleshooting) {
+        super(message);
+        this.code = code;
+        this.troubleshooting = troubleshooting;
+        this.name = 'OnboardingError';
+        Error.captureStackTrace(this, this.constructor);
+    }
+}
+/**
+ * Docker-related errors
+ */
+export class DockerError extends OnboardingError {
+    constructor(message, troubleshooting) {
+        super('DOCKER_ERROR', message, troubleshooting);
+        this.name = 'DockerError';
+    }
+}
+export class DockerNotInstalledError extends DockerError {
+    constructor() {
+        super('Docker is not installed on this system', 'Please install Docker from: https://docs.docker.com/get-docker/');
+        this.name = 'DockerNotInstalledError';
+    }
+}
+export class DockerNotRunningError extends DockerError {
+    constructor() {
+        super('Docker daemon is not running', 'Please start Docker Desktop or Docker daemon, then try again');
+        this.name = 'DockerNotRunningError';
+    }
+}
+export class DockerPermissionError extends DockerError {
+    constructor() {
+        super('Permission denied when accessing Docker', 'Try running with sudo or add your user to the docker group:\n' +
+            '  sudo usermod -aG docker $USER\n' +
+            '  Then log out and log back in');
+        this.name = 'DockerPermissionError';
+    }
+}
+export class DockerComposeError extends DockerError {
+    constructor(operation, details) {
+        super(`Failed to ${operation} with docker-compose`, details || 'Check docker-compose logs for more details:\n  docker-compose logs');
+        this.name = 'DockerComposeError';
+    }
+}
+/**
+ * File system errors
+ */
+export class FileSystemError extends OnboardingError {
+    path;
+    constructor(message, path, troubleshooting) {
+        super('FILESYSTEM_ERROR', message, troubleshooting);
+        this.path = path;
+        this.name = 'FileSystemError';
+    }
+}
+export class DirectoryNotWritableError extends FileSystemError {
+    constructor(path) {
+        super(`Directory is not writable: ${path}`, path, 'Check directory permissions or choose a different directory');
+        this.name = 'DirectoryNotWritableError';
+    }
+}
+export class FileNotFoundError extends FileSystemError {
+    constructor(path) {
+        super(`File not found: ${path}`, path, 'Ensure the file exists or check the path');
+        this.name = 'FileNotFoundError';
+    }
+}
+/**
+ * Configuration errors
+ */
+export class ConfigurationError extends OnboardingError {
+    constructor(message, troubleshooting) {
+        super('CONFIG_ERROR', message, troubleshooting);
+        this.name = 'ConfigurationError';
+    }
+}
+export class InvalidEnvironmentValueError extends ConfigurationError {
+    constructor(key, value, expectedFormat) {
+        super(`Invalid value for ${key}: ${value}`, `Expected format: ${expectedFormat}`);
+        this.name = 'InvalidEnvironmentValueError';
+    }
+}
+export class PluginConfigurationError extends ConfigurationError {
+    constructor(pluginName, details) {
+        super(`Failed to configure plugin ${pluginName}`, details);
+        this.name = 'PluginConfigurationError';
+    }
+}
+/**
+ * Service health errors
+ */
+export class ServiceHealthError extends OnboardingError {
+    constructor(serviceName, timeout) {
+        super('SERVICE_HEALTH_ERROR', `Service '${serviceName}' did not become healthy within ${timeout}ms`, `Check service logs:\n  docker-compose logs ${serviceName}\n\n` +
+            'Or check container status:\n  docker ps -a');
+        this.name = 'ServiceHealthError';
+    }
+}
+/**
+ * Type guard to check if an error is an OnboardingError
+ */
+export function isOnboardingError(error) {
+    return error instanceof OnboardingError;
+}
+/**
+ * Format error for user display
+ */
+export function formatErrorForUser(error) {
+    if (isOnboardingError(error)) {
+        let message = `❌ ${error.message}`;
+        if (error.troubleshooting) {
+            message += `\n\n💡 Troubleshooting:\n${error.troubleshooting}`;
+        }
+        return message;
+    }
+    if (error instanceof Error) {
+        return `❌ Unexpected error: ${error.message}`;
+    }
+    return `❌ An unknown error occurred`;
+}
+//# sourceMappingURL=errors.js.map

package/dist/types/errors.js.map

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

package/dist/types/index.d.ts

@@ -0,0 +1,3 @@
+export * from './errors.js';
+export * from './domain.js';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/types/index.ts"],"names":[],"mappings":"AAAA,cAAc,aAAa,CAAC;AAC5B,cAAc,aAAa,CAAC"}

package/dist/types/index.js

@@ -0,0 +1,3 @@
+export * from './errors.js';
+export * from './domain.js';
+//# sourceMappingURL=index.js.map

package/dist/types/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/types/index.ts"],"names":[],"mappings":"AAAA,cAAc,aAAa,CAAC;AAC5B,cAAc,aAAa,CAAC"}

package/dist/utils/index.d.ts

@@ -0,0 +1,2 @@
+export * from './logger.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,cAAc,aAAa,CAAC"}

package/dist/utils/index.js

@@ -0,0 +1,2 @@
+export * from './logger.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,cAAc,aAAa,CAAC"}

package/dist/utils/logger.d.ts

@@ -0,0 +1,54 @@
+/**
+ * Logging level
+ */
+export type LogLevel = 'debug' | 'info' | 'warn' | 'error';
+/**
+ * Logger configuration
+ */
+interface LoggerConfig {
+    verbose: boolean;
+    debug: boolean;
+    logFile?: string;
+}
+/**
+ * Initialize logger with configuration
+ */
+export declare function initLogger(config: Partial<LoggerConfig>): void;
+/**
+ * Get current logger configuration
+ */
+export declare function getLoggerConfig(): Readonly<LoggerConfig>;
+/**
+ * Log debug message (only shown with --debug flag)
+ */
+export declare function logDebug(message: string): void;
+/**
+ * Log verbose message (shown with --verbose or --debug)
+ */
+export declare function logVerbose(message: string): void;
+/**
+ * Log info message (always displayed)
+ */
+export declare function logInfo(message: string): void;
+/**
+ * Log success message (always displayed)
+ */
+export declare function logSuccess(message: string): void;
+/**
+ * Log warning message (always displayed)
+ */
+export declare function logWarning(message: string): void;
+/**
+ * Log error message (always displayed)
+ */
+export declare function logError(message: string): void;
+/**
+ * Log command execution (debug level)
+ */
+export declare function logCommand(command: string, args: string[]): void;
+/**
+ * Log file operation (debug level)
+ */
+export declare function logFileOperation(operation: string, filePath: string): void;
+export {};
+//# 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":"AAKA;;GAEG;AACH,MAAM,MAAM,QAAQ,GAAG,OAAO,GAAG,MAAM,GAAG,MAAM,GAAG,OAAO,CAAC;AAE3D;;GAEG;AACH,UAAU,YAAY;IAClB,OAAO,EAAE,OAAO,CAAC;IACjB,KAAK,EAAE,OAAO,CAAC;IACf,OAAO,CAAC,EAAE,MAAM,CAAC;CACpB;AAOD;;GAEG;AACH,wBAAgB,UAAU,CAAC,MAAM,EAAE,OAAO,CAAC,YAAY,CAAC,GAAG,IAAI,CAE9D;AAED;;GAEG;AACH,wBAAgB,eAAe,IAAI,QAAQ,CAAC,YAAY,CAAC,CAExD;AAiBD;;GAEG;AACH,wBAAgB,QAAQ,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,CAK9C;AAED;;GAEG;AACH,wBAAgB,UAAU,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,CAKhD;AAED;;GAEG;AACH,wBAAgB,OAAO,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,CAG7C;AAED;;GAEG;AACH,wBAAgB,UAAU,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,CAGhD;AAED;;GAEG;AACH,wBAAgB,UAAU,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,CAGhD;AAED;;GAEG;AACH,wBAAgB,QAAQ,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,CAG9C;AAED;;GAEG;AACH,wBAAgB,UAAU,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,GAAG,IAAI,CAEhE;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,SAAS,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,IAAI,CAE1E"}

package/dist/utils/logger.js

@@ -0,0 +1,92 @@
+import chalk from 'chalk';
+import { appendFile as fsAppendFile } from 'fs/promises';
+let loggerConfig = {
+    verbose: false,
+    debug: false,
+};
+/**
+ * Initialize logger with configuration
+ */
+export function initLogger(config) {
+    loggerConfig = { ...loggerConfig, ...config };
+}
+/**
+ * Get current logger configuration
+ */
+export function getLoggerConfig() {
+    return { ...loggerConfig };
+}
+/**
+ * Write log message to file if configured
+ */
+async function writeToLogFile(level, message) {
+    if (!loggerConfig.logFile)
+        return;
+    try {
+        const timestamp = new Date().toISOString();
+        const logEntry = `[${timestamp}] [${level.toUpperCase()}] ${message}\n`;
+        await fsAppendFile(loggerConfig.logFile, logEntry, 'utf-8');
+    }
+    catch (error) {
+        // Silently fail on log file errors
+    }
+}
+/**
+ * Log debug message (only shown with --debug flag)
+ */
+export function logDebug(message) {
+    if (loggerConfig.debug) {
+        console.log(chalk.gray(`🔧 ${message}`));
+    }
+    writeToLogFile('debug', message);
+}
+/**
+ * Log verbose message (shown with --verbose or --debug)
+ */
+export function logVerbose(message) {
+    if (loggerConfig.verbose || loggerConfig.debug) {
+        console.log(chalk.cyan(`ℹ️  ${message}`));
+    }
+    writeToLogFile('info', message);
+}
+/**
+ * Log info message (always displayed)
+ */
+export function logInfo(message) {
+    console.log(chalk.blue(`ℹ️  ${message}`));
+    writeToLogFile('info', message);
+}
+/**
+ * Log success message (always displayed)
+ */
+export function logSuccess(message) {
+    console.log(chalk.green(`✅ ${message}`));
+    writeToLogFile('info', message);
+}
+/**
+ * Log warning message (always displayed)
+ */
+export function logWarning(message) {
+    console.log(chalk.yellow(`⚠️  ${message}`));
+    writeToLogFile('warn', message);
+}
+/**
+ * Log error message (always displayed)
+ */
+export function logError(message) {
+    console.log(chalk.red(`❌ ${message}`));
+    writeToLogFile('error', message);
+}
+/**
+ * Log command execution (debug level)
+ */
+export function logCommand(command, args) {
+    logDebug(`Executing: ${command} ${args.join(' ')}`);
+}
+/**
+ * Log file operation (debug level)
+ */
+export function logFileOperation(operation, filePath) {
+    logDebug(`${operation}: ${filePath}`);
+}
+//# sourceMappingURL=logger.js.map

package/dist/utils/logger.js.map

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

package/dist/utils.d.ts

@@ -0,0 +1,32 @@
+export { logSuccess, logError, logWarning, logInfo, logDebug, logVerbose, logCommand, logFileOperation, initLogger, getLoggerConfig, } from './utils/logger.js';
+/**
+ * Display SimpleNS banner in blue using figlet
+ */
+export declare function displayBanner(): void;
+/**
+ * Execute a shell command with error handling
+ */
+export declare function executeCommand(command: string, args: string[], options?: {
+    cwd?: string;
+    silent?: boolean;
+}): Promise<{
+    stdout: string;
+    stderr: string;
+}>;
+/**
+ * Check if file exists
+ */
+export declare function fileExists(filePath: string): Promise<boolean>;
+/**
+ * Write file content
+ */
+export declare function writeFile(filePath: string, content: string): Promise<void>;
+/**
+ * Read file content
+ */
+export declare function readFile(filePath: string): Promise<string>;
+/**
+ * Append content to file
+ */
+export declare function appendFile(filePath: string, content: string): Promise<void>;
+//# sourceMappingURL=utils.d.ts.map

package/dist/utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"utils.d.ts","sourceRoot":"","sources":["../src/utils.ts"],"names":[],"mappings":"AAOA,OAAO,EACH,UAAU,EACV,QAAQ,EACR,UAAU,EACV,OAAO,EACP,QAAQ,EACR,UAAU,EACV,UAAU,EACV,gBAAgB,EAChB,UAAU,EACV,eAAe,GAClB,MAAM,mBAAmB,CAAC;AAE3B;;GAEG;AACH,wBAAgB,aAAa,IAAI,IAAI,CAcpC;AAED;;GAEG;AACH,wBAAsB,cAAc,CAChC,OAAO,EAAE,MAAM,EACf,IAAI,EAAE,MAAM,EAAE,EACd,OAAO,CAAC,EAAE;IAAE,GAAG,CAAC,EAAE,MAAM,CAAC;IAAC,MAAM,CAAC,EAAE,OAAO,CAAA;CAAE,GAC7C,OAAO,CAAC;IAAE,MAAM,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,CAAC,CAe7C;AAED;;GAEG;AACH,wBAAsB,UAAU,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAOnE;AAED;;GAEG;AACH,wBAAsB,SAAS,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAQhF;AAED;;GAEG;AACH,wBAAsB,QAAQ,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAEhE;AAED;;GAEG;AACH,wBAAsB,UAAU,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAMjF"}

package/dist/utils.js

@@ -0,0 +1,79 @@
+import chalk from 'chalk';
+import { execa } from 'execa';
+import fs from 'fs/promises';
+import path from 'path';
+import figlet from 'figlet';
+// Re-export logger functions for backward compatibility
+export { logSuccess, logError, logWarning, logInfo, logDebug, logVerbose, logCommand, logFileOperation, initLogger, getLoggerConfig, } from './utils/logger.js';
+/**
+ * Display SimpleNS banner in blue using figlet
+ */
+export function displayBanner() {
+    const simpleNS = figlet.textSync('SimpleNS', {
+        font: 'Standard',
+        horizontalLayout: 'default',
+    });
+    const onboard = figlet.textSync('Onboard', {
+        font: 'Standard',
+        horizontalLayout: 'default',
+    });
+    console.log(chalk.blue(simpleNS));
+    console.log(chalk.blue(onboard));
+    console.log('');
+}
+/**
+ * Execute a shell command with error handling
+ */
+export async function executeCommand(command, args, options) {
+    // Import dynamically to avoid circular dependency
+    const { logCommand } = await import('./utils/logger.js');
+    logCommand(command, args);
+    try {
+        const result = await execa(command, args, {
+            cwd: options?.cwd || process.cwd(),
+            stdio: options?.silent ? 'pipe' : 'inherit',
+        });
+        return { stdout: result.stdout, stderr: result.stderr };
+    }
+    catch (error) {
+        throw new Error(`Command failed: ${command} ${args.join(' ')}\n${error.message}`);
+    }
+}
+/**
+ * Check if file exists
+ */
+export async function fileExists(filePath) {
+    try {
+        await fs.access(filePath);
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+/**
+ * Write file content
+ */
+export async function writeFile(filePath, content) {
+    const { logFileOperation } = await import('./utils/logger.js');
+    logFileOperation('Writing file', filePath);
+    const dir = path.dirname(filePath);
+    await fs.mkdir(dir, { recursive: true });
+    await fs.writeFile(filePath, content, 'utf-8');
+}
+/**
+ * Read file content
+ */
+export async function readFile(filePath) {
+    return await fs.readFile(filePath, 'utf-8');
+}
+/**
+ * Append content to file
+ */
+export async function appendFile(filePath, content) {
+    // Ensure parent directory exists, similar to writeFile
+    const dir = path.dirname(filePath);
+    await fs.mkdir(dir, { recursive: true });
+    await fs.appendFile(filePath, content, 'utf-8');
+}
+//# sourceMappingURL=utils.js.map

package/dist/utils.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"utils.js","sourceRoot":"","sources":["../src/utils.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,OAAO,CAAC;AAC1B,OAAO,EAAE,KAAK,EAAE,MAAM,OAAO,CAAC;AAC9B,OAAO,EAAE,MAAM,aAAa,CAAC;AAC7B,OAAO,IAAI,MAAM,MAAM,CAAC;AACxB,OAAO,MAAM,MAAM,QAAQ,CAAC;AAE5B,wDAAwD;AACxD,OAAO,EACH,UAAU,EACV,QAAQ,EACR,UAAU,EACV,OAAO,EACP,QAAQ,EACR,UAAU,EACV,UAAU,EACV,gBAAgB,EAChB,UAAU,EACV,eAAe,GAClB,MAAM,mBAAmB,CAAC;AAE3B;;GAEG;AACH,MAAM,UAAU,aAAa;IACzB,MAAM,QAAQ,GAAG,MAAM,CAAC,QAAQ,CAAC,UAAU,EAAE;QACzC,IAAI,EAAE,UAAU;QAChB,gBAAgB,EAAE,SAAS;KAC9B,CAAC,CAAC;IAEH,MAAM,OAAO,GAAG,MAAM,CAAC,QAAQ,CAAC,SAAS,EAAE;QACvC,IAAI,EAAE,UAAU;QAChB,gBAAgB,EAAE,SAAS;KAC9B,CAAC,CAAC;IAEH,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC,CAAC;IAClC,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,CAAC;IACjC,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;AACpB,CAAC;AAED;;GAEG;AACH,MAAM,CAAC,KAAK,UAAU,cAAc,CAChC,OAAe,EACf,IAAc,EACd,OAA4C;IAE5C,kDAAkD;IAClD,MAAM,EAAE,UAAU,EAAE,GAAG,MAAM,MAAM,CAAC,mBAAmB,CAAC,CAAC;IAEzD,UAAU,CAAC,OAAO,EAAE,IAAI,CAAC,CAAC;IAE1B,IAAI,CAAC;QACD,MAAM,MAAM,GAAG,MAAM,KAAK,CAAC,OAAO,EAAE,IAAI,EAAE;YACtC,GAAG,EAAE,OAAO,EAAE,GAAG,IAAI,OAAO,CAAC,GAAG,EAAE;YAClC,KAAK,EAAE,OAAO,EAAE,MAAM,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,SAAS;SAC9C,CAAC,CAAC;QACH,OAAO,EAAE,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,CAAC;IAC5D,CAAC;IAAC,OAAO,KAAU,EAAE,CAAC;QAClB,MAAM,IAAI,KAAK,CAAC,mBAAmB,OAAO,IAAI,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,KAAK,KAAK,CAAC,OAAO,EAAE,CAAC,CAAC;IACtF,CAAC;AACL,CAAC;AAED;;GAEG;AACH,MAAM,CAAC,KAAK,UAAU,UAAU,CAAC,QAAgB;IAC7C,IAAI,CAAC;QACD,MAAM,EAAE,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC;QAC1B,OAAO,IAAI,CAAC;IAChB,CAAC;IAAC,MAAM,CAAC;QACL,OAAO,KAAK,CAAC;IACjB,CAAC;AACL,CAAC;AAED;;GAEG;AACH,MAAM,CAAC,KAAK,UAAU,SAAS,CAAC,QAAgB,EAAE,OAAe;IAC7D,MAAM,EAAE,gBAAgB,EAAE,GAAG,MAAM,MAAM,CAAC,mBAAmB,CAAC,CAAC;IAE/D,gBAAgB,CAAC,cAAc,EAAE,QAAQ,CAAC,CAAC;IAE3C,MAAM,GAAG,GAAG,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC;IACnC,MAAM,EAAE,CAAC,KAAK,CAAC,GAAG,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IACzC,MAAM,EAAE,CAAC,SAAS,CAAC,QAAQ,EAAE,OAAO,EAAE,OAAO,CAAC,CAAC;AACnD,CAAC;AAED;;GAEG;AACH,MAAM,CAAC,KAAK,UAAU,QAAQ,CAAC,QAAgB;IAC3C,OAAO,MAAM,EAAE,CAAC,QAAQ,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC;AAChD,CAAC;AAED;;GAEG;AACH,MAAM,CAAC,KAAK,UAAU,UAAU,CAAC,QAAgB,EAAE,OAAe;IAC9D,uDAAuD;IACvD,MAAM,GAAG,GAAG,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC;IACnC,MAAM,EAAE,CAAC,KAAK,CAAC,GAAG,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IAEzC,MAAM,EAAE,CAAC,UAAU,CAAC,QAAQ,EAAE,OAAO,EAAE,OAAO,CAAC,CAAC;AACpD,CAAC"}

package/dist/validators.d.ts

@@ -0,0 +1,93 @@
+export type OSType = 'windows' | 'linux' | 'darwin';
+/**
+ * Checks if Docker is installed on the system by running `docker --version`.
+ *
+ * @throws {DockerNotInstalledError} When Docker is not found in PATH or not installed
+ *
+ * @example
+ * ```ts
+ * try {
+ *   await checkDockerInstalled();
+ *   console.log('Docker is available');
+ * } catch (error) {
+ *   // Handle DockerNotInstalledError
+ * }
+ * ```
+ */
+export declare function checkDockerInstalled(): Promise<void>;
+/**
+ * Checks if the Docker daemon is running by executing `docker ps`.
+ * Provides specific error types based on the failure reason.
+ *
+ * @throws {DockerPermissionError} When user lacks permissions to access Docker socket
+ * @throws {DockerNotRunningError} When Docker daemon is not running or unreachable
+ *
+ * @example
+ * ```ts
+ * try {
+ *   await checkDockerRunning();
+ * } catch (error) {
+ *   if (error instanceof DockerPermissionError) {
+ *     // Guide user to add sudo or docker group
+ *   }
+ * }
+ * ```
+ */
+export declare function checkDockerRunning(): Promise<void>;
+/**
+ * Detects the operating system platform.
+ *
+ * @returns OS type: 'windows', 'darwin' (macOS), or 'linux'
+ * @note Defaults to 'linux' for unknown platforms
+ *
+ * @example
+ * ```ts
+ * const os = detectOS();
+ * if (os === 'linux') {
+ *   // Linux-specific configuration
+ * }
+ * ```
+ */
+export declare function detectOS(): OSType;
+/**
+ * Validates all system prerequisites before starting the onboarding process.
+ * Checks Docker installation, daemon status, and detects the operating system.
+ *
+ * @throws {DockerNotInstalledError} If Docker is not installed
+ * @throws {DockerNotRunningError} If Docker daemon is not running
+ * @throws {DockerPermissionError} If user lacks Docker permissions
+ *
+ * @example
+ * ```ts
+ * try {
+ *   await validatePrerequisites();
+ *   // Proceed with setup
+ * } catch (error) {
+ *   // Handle prerequisite errors
+ * }
+ * ```
+ */
+export declare function validatePrerequisites(): Promise<void>;
+/**
+ * Validates environment variable values based on the variable name/type.
+ * Performs format-specific validation for URLs, ports, and security credentials.
+ *
+ * @param key - Environment variable name (e.g., 'MONGO_URI', 'PORT', 'API_KEY')
+ * @param value - Value to validate
+ * @returns `true` if valid, `false` otherwise
+ *
+ * @remarks
+ * Validation rules:
+ * - URLs: Must contain protocol (mongodb://, redis://)
+ * - Ports: Must be 1-65535
+ * - Secrets/Keys/Passwords: Must be at least 8 characters
+ *
+ * @example
+ * ```ts
+ * validateEnvValue('MONGO_URI', 'mongodb://localhost:27017'); // true
+ * validateEnvValue('PORT', '3000'); // true
+ * validateEnvValue('API_KEY', 'short'); // false (too short)
+ * ```
+ */
+export declare function validateEnvValue(key: string, value: string): boolean;
+//# sourceMappingURL=validators.d.ts.map

package/dist/validators.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"validators.d.ts","sourceRoot":"","sources":["../src/validators.ts"],"names":[],"mappings":"AASA,MAAM,MAAM,MAAM,GAAG,SAAS,GAAG,OAAO,GAAG,QAAQ,CAAC;AAEpD;;;;;;;;;;;;;;GAcG;AACH,wBAAsB,oBAAoB,IAAI,OAAO,CAAC,IAAI,CAAC,CAM1D;AAED;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAsB,kBAAkB,IAAI,OAAO,CAAC,IAAI,CAAC,CAiBxD;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAgB,QAAQ,IAAI,MAAM,CAMjC;AAED;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAsB,qBAAqB,IAAI,OAAO,CAAC,IAAI,CAAC,CA4B3D;AAED;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,wBAAgB,gBAAgB,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CA6BpE"}