@lanonasis/cli 1.5.2 → 2.0.0

package/dist/core/error-handler.js

@@ -0,0 +1,380 @@
+/**
+ * Enhanced Error Handling and Recovery System
+ * Provides intelligent error messages and recovery suggestions
+ */
+import chalk from 'chalk';
+import boxen from 'boxen';
+export class ErrorHandler {
+    stateManager;
+    errorHistory = [];
+    constructor(stateManager) {
+        this.stateManager = stateManager;
+    }
+    /**
+     * Main error handling method
+     */
+    handle(error) {
+        const cliError = this.normalizeError(error);
+        this.errorHistory.push(cliError);
+        // Log to debug if verbose mode
+        if (process.env.CLI_VERBOSE === 'true') {
+            this.logDebugInfo(cliError);
+        }
+        // Display user-friendly error
+        this.displayError(cliError);
+        // Offer recovery options
+        if (cliError.recoveryActions && cliError.recoveryActions.length > 0) {
+            this.offerRecovery(cliError.recoveryActions);
+        }
+    }
+    /**
+     * Normalize various error types into CLIError
+     */
+    normalizeError(error) {
+        if (error instanceof Error) {
+            const cliError = error;
+            // Enhance known errors with better context
+            if (error.message.includes('ECONNREFUSED')) {
+                return this.createConnectionError(error);
+            }
+            else if (error.message.includes('UNAUTHORIZED') || error.message.includes('401')) {
+                return this.createAuthError(error);
+            }
+            else if (error.message.includes('ENOTFOUND')) {
+                return this.createNetworkError(error);
+            }
+            else if (error.message.includes('TIMEOUT')) {
+                return this.createTimeoutError(error);
+            }
+            else if (error.message.includes('RATE_LIMIT')) {
+                return this.createRateLimitError(error);
+            }
+            return cliError;
+        }
+        // Handle non-Error objects
+        return {
+            name: 'UnknownError',
+            message: String(error),
+            severity: 'error'
+        };
+    }
+    /**
+     * Create specific error types with recovery suggestions
+     */
+    createConnectionError(originalError) {
+        return {
+            ...originalError,
+            name: 'ConnectionError',
+            message: 'Cannot connect to Onasis service',
+            severity: 'error',
+            code: 'ECONNREFUSED',
+            suggestion: 'The service might be down or your network connection might be unavailable.',
+            recoveryActions: [
+                {
+                    label: 'Check internet connection',
+                    command: 'ping api.lanonasis.com',
+                    description: 'Test network connectivity'
+                },
+                {
+                    label: 'Verify service URL',
+                    command: 'onasis config get api-url',
+                    description: 'Check configured service endpoint'
+                },
+                {
+                    label: 'Try alternative URL',
+                    command: 'onasis config set api-url <new-url>',
+                    description: 'Update service endpoint'
+                },
+                {
+                    label: 'Use local mode',
+                    command: 'onasis --offline',
+                    description: 'Work offline with cached data'
+                }
+            ]
+        };
+    }
+    createAuthError(originalError) {
+        return {
+            ...originalError,
+            name: 'AuthenticationError',
+            message: 'Authentication failed',
+            severity: 'error',
+            code: 'UNAUTHORIZED',
+            suggestion: 'Your session may have expired or your credentials might be invalid.',
+            recoveryActions: [
+                {
+                    label: 'Re-authenticate',
+                    command: 'onasis auth login',
+                    description: 'Sign in again with your credentials'
+                },
+                {
+                    label: 'Check API keys',
+                    command: 'onasis api-keys verify',
+                    description: 'Verify your API keys are valid'
+                },
+                {
+                    label: 'Reset credentials',
+                    command: 'onasis auth reset',
+                    description: 'Clear and reset authentication'
+                }
+            ]
+        };
+    }
+    createNetworkError(originalError) {
+        return {
+            ...originalError,
+            name: 'NetworkError',
+            message: 'Network request failed',
+            severity: 'error',
+            code: 'ENOTFOUND',
+            suggestion: 'Unable to resolve the service domain. Check your network settings.',
+            recoveryActions: [
+                {
+                    label: 'Check DNS',
+                    command: 'nslookup api.lanonasis.com',
+                    description: 'Verify DNS resolution'
+                },
+                {
+                    label: 'Try with IP',
+                    command: 'onasis config set api-url https://<ip-address>',
+                    description: 'Use direct IP instead of domain'
+                },
+                {
+                    label: 'Check proxy settings',
+                    command: 'onasis config show proxy',
+                    description: 'Review proxy configuration'
+                }
+            ]
+        };
+    }
+    createTimeoutError(originalError) {
+        return {
+            ...originalError,
+            name: 'TimeoutError',
+            message: 'Request timed out',
+            severity: 'warning',
+            code: 'TIMEOUT',
+            suggestion: 'The operation took too long. The service might be slow or overloaded.',
+            recoveryActions: [
+                {
+                    label: 'Retry operation',
+                    command: 'onasis retry',
+                    description: 'Retry the last operation'
+                },
+                {
+                    label: 'Increase timeout',
+                    command: 'onasis config set timeout 30000',
+                    description: 'Set longer timeout (30 seconds)'
+                },
+                {
+                    label: 'Check service status',
+                    command: 'onasis status',
+                    description: 'Check if service is operational'
+                }
+            ]
+        };
+    }
+    createRateLimitError(originalError) {
+        return {
+            ...originalError,
+            name: 'RateLimitError',
+            message: 'Rate limit exceeded',
+            severity: 'warning',
+            code: 'RATE_LIMIT',
+            suggestion: 'You have made too many requests. Please wait before trying again.',
+            recoveryActions: [
+                {
+                    label: 'Check limits',
+                    command: 'onasis api-keys limits',
+                    description: 'View your current rate limits'
+                },
+                {
+                    label: 'Upgrade plan',
+                    command: 'onasis account upgrade',
+                    description: 'Upgrade for higher limits'
+                }
+            ]
+        };
+    }
+    /**
+     * Display error in user-friendly format
+     */
+    displayError(error) {
+        const icon = this.getErrorIcon(error.severity || 'error');
+        const color = this.getErrorColor(error.severity || 'error');
+        const errorBox = boxen(`${icon} ${chalk.bold(error.name || 'Error')}\n\n` +
+            `${error.message}\n` +
+            (error.suggestion ? `\n${chalk.yellow('💡 ' + error.suggestion)}` : ''), {
+            padding: 1,
+            borderStyle: 'round',
+            borderColor: color,
+            title: error.code ? `Error Code: ${error.code}` : undefined,
+            titleAlignment: 'right'
+        });
+        console.error(errorBox);
+    }
+    /**
+     * Offer recovery actions to the user
+     */
+    offerRecovery(actions) {
+        console.log(chalk.bold('\n🔧 Possible Solutions:\n'));
+        actions.forEach((action, index) => {
+            console.log(`  ${chalk.cyan(`${index + 1}.`)} ${chalk.bold(action.label)}\n` +
+                `     ${chalk.gray('Command:')} ${chalk.green(action.command)}\n` +
+                (action.description ? `     ${chalk.dim(action.description)}\n` : ''));
+        });
+        console.log(chalk.dim('\nRun any of the above commands to resolve the issue.'));
+    }
+    /**
+     * Log debug information for verbose mode
+     */
+    logDebugInfo(error) {
+        console.error(chalk.dim('\n--- Debug Information ---'));
+        console.error(chalk.dim('Timestamp:'), new Date().toISOString());
+        console.error(chalk.dim('Error Type:'), error.name);
+        console.error(chalk.dim('Error Code:'), error.code || 'N/A');
+        if (error.stack) {
+            console.error(chalk.dim('Stack Trace:'));
+            console.error(chalk.dim(error.stack));
+        }
+        if (error.context) {
+            console.error(chalk.dim('Context:'));
+            console.error(chalk.dim(JSON.stringify(error.context, null, 2)));
+        }
+        console.error(chalk.dim('--- End Debug Information ---\n'));
+    }
+    /**
+     * Get error icon based on severity
+     */
+    getErrorIcon(severity) {
+        switch (severity) {
+            case 'error': return chalk.red('✖');
+            case 'warning': return chalk.yellow('⚠');
+            case 'info': return chalk.blue('ℹ');
+            default: return chalk.red('✖');
+        }
+    }
+    /**
+     * Get error color based on severity
+     */
+    getErrorColor(severity) {
+        switch (severity) {
+            case 'error': return 'red';
+            case 'warning': return 'yellow';
+            case 'info': return 'blue';
+            default: return 'red';
+        }
+    }
+    /**
+     * Get error history for debugging
+     */
+    getErrorHistory() {
+        return this.errorHistory;
+    }
+    /**
+     * Clear error history
+     */
+    clearHistory() {
+        this.errorHistory = [];
+    }
+    /**
+     * Retry last failed operation
+     */
+    async retryLastOperation() {
+        const lastError = this.errorHistory[this.errorHistory.length - 1];
+        if (lastError && lastError.context?.operation) {
+            console.log(chalk.cyan('🔄 Retrying last operation...'));
+            // Implementation would retry the stored operation
+        }
+        else {
+            console.log(chalk.yellow('No operation to retry'));
+        }
+    }
+}
+/**
+ * Global error boundary for the CLI
+ */
+export class ErrorBoundary {
+    errorHandler;
+    constructor(errorHandler) {
+        this.errorHandler = errorHandler;
+        this.setupGlobalHandlers();
+    }
+    /**
+     * Setup global error handlers
+     */
+    setupGlobalHandlers() {
+        // Handle uncaught exceptions
+        process.on('uncaughtException', (error) => {
+            this.errorHandler.handle({
+                ...error,
+                name: 'UncaughtException',
+                severity: 'error',
+                suggestion: 'An unexpected error occurred. This might be a bug in the application.'
+            });
+            // Give time for error to be displayed before exiting
+            setTimeout(() => process.exit(1), 100);
+        });
+        // Handle unhandled promise rejections
+        process.on('unhandledRejection', (reason, promise) => {
+            this.errorHandler.handle({
+                name: 'UnhandledRejection',
+                message: String(reason),
+                severity: 'error',
+                suggestion: 'A promise was rejected without being handled. Check your async operations.',
+                context: { promise: String(promise) }
+            });
+            setTimeout(() => process.exit(1), 100);
+        });
+        // Handle SIGINT (Ctrl+C)
+        process.on('SIGINT', () => {
+            console.log(chalk.yellow('\n\n👋 Gracefully shutting down...'));
+            this.cleanup();
+            process.exit(0);
+        });
+        // Handle SIGTERM
+        process.on('SIGTERM', () => {
+            console.log(chalk.yellow('\n\n🛑 Received termination signal...'));
+            this.cleanup();
+            process.exit(0);
+        });
+    }
+    /**
+     * Cleanup before exit
+     */
+    cleanup() {
+        // Save any pending state
+        // Close any open connections
+        // Flush any buffers
+        console.log(chalk.dim('Cleanup complete'));
+    }
+    /**
+     * Wrap async functions with error handling
+     */
+    wrapAsync(fn) {
+        return (async (...args) => {
+            try {
+                return await fn(...args);
+            }
+            catch (error) {
+                this.errorHandler.handle(error);
+                throw error;
+            }
+        });
+    }
+}
+/**
+ * Validation error for input validation
+ */
+export class ValidationError extends Error {
+    severity = 'warning';
+    suggestion;
+    constructor(message, field, suggestion) {
+        super(message);
+        this.name = 'ValidationError';
+        if (field) {
+            this.message = `Invalid ${field}: ${message}`;
+        }
+        this.suggestion = suggestion;
+    }
+}

package/dist/core/power-mode.d.ts

@@ -0,0 +1,118 @@
+/**
+ * Power User Mode
+ * Streamlined interface for expert users with advanced features
+ */
+import { StateManager } from './architecture.js';
+export declare class PowerUserMode {
+    private stateManager;
+    private commandHistory;
+    private historyIndex;
+    private rl?;
+    private smartSuggestions;
+    private aliases;
+    constructor(stateManager: StateManager);
+    /**
+     * Enter power user mode
+     */
+    enter(): Promise<void>;
+    /**
+     * Exit power user mode
+     */
+    exit(): void;
+    /**
+     * Show power mode banner
+     */
+    private showBanner;
+    /**
+     * Get command prompt
+     */
+    private getPrompt;
+    /**
+     * Setup key bindings for enhanced navigation
+     */
+    private setupKeyBindings;
+    /**
+     * Start the REPL loop
+     */
+    private startREPL;
+    /**
+     * Process power mode commands
+     */
+    private processCommand;
+    /**
+     * Quick create command
+     */
+    private quickCreate;
+    /**
+     * Quick search command
+     */
+    private quickSearch;
+    /**
+     * Quick list command
+     */
+    private quickList;
+    /**
+     * Quick delete command
+     */
+    private quickDelete;
+    /**
+     * Quick update command
+     */
+    private quickUpdate;
+    /**
+     * Handle topic commands
+     */
+    private handleTopic;
+    /**
+     * Handle API commands
+     */
+    private handleApi;
+    /**
+     * Handle pipe operations
+     */
+    private handlePipe;
+    /**
+     * Handle format changes
+     */
+    private handleFormat;
+    /**
+     * Execute system command
+     */
+    private executeSystemCommand;
+    /**
+     * Show help
+     */
+    private showHelp;
+    /**
+     * Show command history
+     */
+    private showHistory;
+    /**
+     * Handle alias management
+     */
+    private handleAlias;
+    /**
+     * Expand aliases in command
+     */
+    private expandAliases;
+    /**
+     * Tab completion function
+     */
+    private completer;
+    /**
+     * Parse command arguments
+     */
+    private parseArgs;
+    /**
+     * Generate a simple ID
+     */
+    private generateId;
+    /**
+     * Load aliases from storage
+     */
+    private loadAliases;
+    /**
+     * Save aliases to storage
+     */
+    private saveAliases;
+}