newo 1.9.2 → 2.0.0

package/dist/cli/customer-selection.js

@@ -0,0 +1,110 @@
+/**
+ * Customer selection and management utilities for CLI commands
+ */
+import { parseCustomerConfigAsync, listCustomers, getCustomer, getDefaultCustomer, tryGetDefaultCustomer, getAllCustomers, validateCustomerConfig } from '../customerAsync.js';
+import { logCliError } from './errors.js';
+/**
+ * Parse and validate customer configuration
+ */
+export async function parseAndValidateCustomerConfig(env, verbose) {
+    try {
+        const customerConfig = await parseCustomerConfigAsync(env, verbose);
+        validateCustomerConfig(customerConfig);
+        return customerConfig;
+    }
+    catch (error) {
+        logCliError('error', 'Failed to parse customer configuration');
+        if (error instanceof Error) {
+            logCliError('error', error.message);
+        }
+        process.exit(1);
+    }
+}
+/**
+ * Handle customer selection for commands that support single customer operations
+ */
+export function selectSingleCustomer(customerConfig, customerArg) {
+    let selectedCustomer = null;
+    let allCustomers = [];
+    if (customerArg) {
+        const customer = getCustomer(customerConfig, customerArg);
+        if (!customer) {
+            console.error(`Unknown customer: ${customerArg}`);
+            console.error(`Available customers: ${listCustomers(customerConfig).join(', ')}`);
+            process.exit(1);
+        }
+        selectedCustomer = customer;
+    }
+    else {
+        // Try to get default, fall back to all customers
+        selectedCustomer = tryGetDefaultCustomer(customerConfig);
+        if (!selectedCustomer) {
+            allCustomers = getAllCustomers(customerConfig);
+        }
+    }
+    return {
+        selectedCustomer,
+        allCustomers,
+        isMultiCustomer: allCustomers.length > 0
+    };
+}
+/**
+ * Handle customer selection for commands that require exactly one customer
+ */
+export function requireSingleCustomer(customerConfig, customerArg) {
+    if (customerArg) {
+        const customer = getCustomer(customerConfig, customerArg);
+        if (!customer) {
+            console.error(`Unknown customer: ${customerArg}`);
+            console.error(`Available customers: ${listCustomers(customerConfig).join(', ')}`);
+            process.exit(1);
+        }
+        return customer;
+    }
+    else {
+        try {
+            return getDefaultCustomer(customerConfig);
+        }
+        catch (error) {
+            const message = error instanceof Error ? error.message : String(error);
+            console.error(message);
+            process.exit(1);
+        }
+    }
+}
+/**
+ * Interactive customer selection for commands like push
+ */
+export async function interactiveCustomerSelection(allCustomers) {
+    console.log(`\n📤 Multiple customers available for push:`);
+    allCustomers.forEach((customer, index) => {
+        console.log(`  ${index + 1}. ${customer.idn}`);
+    });
+    console.log(`  ${allCustomers.length + 1}. All customers`);
+    const readline = await import('readline');
+    const rl = readline.createInterface({
+        input: process.stdin,
+        output: process.stdout
+    });
+    const choice = await new Promise((resolve) => {
+        rl.question(`\nSelect customer to push (1-${allCustomers.length + 1}): `, resolve);
+    });
+    rl.close();
+    const choiceNum = parseInt(choice.trim());
+    if (choiceNum === allCustomers.length + 1) {
+        // User selected "All customers"
+        console.log(`🔄 Pushing to all ${allCustomers.length} customers...`);
+        return allCustomers;
+    }
+    else if (choiceNum >= 1 && choiceNum <= allCustomers.length) {
+        // User selected specific customer
+        const selectedCustomer = allCustomers[choiceNum - 1];
+        if (selectedCustomer) {
+            console.log(`🔄 Pushing to customer: ${selectedCustomer.idn}`);
+            return [selectedCustomer];
+        }
+    }
+    console.error('Invalid choice. Exiting.');
+    process.exit(1);
+}
+//# sourceMappingURL=customer-selection.js.map

package/dist/cli/errors.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Enhanced error logging for CLI
+ */
+export declare function logCliError(level: 'error' | 'warn' | 'info', message: string, meta?: Record<string, unknown>): void;
+/**
+ * Enhanced error handling with user-friendly messages
+ */
+export declare function handleCliError(error: unknown, operation?: string): never;
+//# sourceMappingURL=errors.d.ts.map

package/dist/cli/errors.js

@@ -0,0 +1,111 @@
+/**
+ * Enhanced error handling utilities for NEWO CLI
+ */
+import { EnvValidationError } from '../env.js';
+/**
+ * Enhanced error logging for CLI
+ */
+export function logCliError(level, message, meta) {
+    const timestamp = new Date().toISOString();
+    const logEntry = {
+        timestamp,
+        level,
+        module: 'cli',
+        message,
+        ...meta
+    };
+    // Only log JSON format in verbose mode, otherwise use clean user messages
+    const verbose = process.argv.includes('--verbose') || process.argv.includes('-v');
+    if (verbose) {
+        if (level === 'error') {
+            console.error(JSON.stringify(logEntry));
+        }
+        else if (level === 'warn') {
+            console.warn(JSON.stringify(logEntry));
+        }
+        else {
+            console.log(JSON.stringify(logEntry));
+        }
+    }
+    else {
+        // Clean user-facing messages
+        if (level === 'error') {
+            console.error(`❌ ${message}`);
+        }
+        else if (level === 'warn') {
+            console.warn(`⚠️  ${message}`);
+        }
+        else {
+            console.log(`ℹ️  ${message}`);
+        }
+    }
+}
+/**
+ * Enhanced error handling with user-friendly messages
+ */
+export function handleCliError(error, operation = 'operation') {
+    const verbose = process.argv.includes('--verbose') || process.argv.includes('-v');
+    if (error instanceof Error) {
+        // Authentication errors
+        if (error.message.includes('API key') || error.message.includes('Authentication failed')) {
+            logCliError('error', 'Authentication failed. Please check your API key configuration.');
+            if (!verbose) {
+                console.error('\n💡 Troubleshooting tips:');
+                console.error('  • Verify your API key is correct in .env file');
+                console.error('  • For multi-customer setup, check NEWO_CUSTOMER_<IDN>_API_KEY');
+                console.error('  • Run with --verbose for detailed error information');
+            }
+        }
+        // Network errors
+        else if (error.message.includes('Network timeout') || error.message.includes('ENOTFOUND') || error.message.includes('ECONNREFUSED')) {
+            logCliError('error', 'Network connection failed. Please check your internet connection.');
+            if (!verbose) {
+                console.error('\n💡 Troubleshooting tips:');
+                console.error('  • Check your internet connection');
+                console.error('  • Verify NEWO_BASE_URL is correct');
+                console.error('  • Try again in a few moments');
+            }
+        }
+        // Environment configuration errors
+        else if (error instanceof EnvValidationError || error.message.includes('not set')) {
+            logCliError('error', 'Configuration error. Please check your environment setup.');
+            if (!verbose) {
+                console.error('\n💡 Setup help:');
+                console.error('  • Copy .env.example to .env and configure your settings');
+                console.error('  • Run "newo --help" to see configuration examples');
+                console.error('  • Check the README for detailed setup instructions');
+            }
+        }
+        // File system errors
+        else if (error.message.includes('ENOENT') || error.message.includes('EACCES')) {
+            logCliError('error', 'File system error. Please check file permissions and paths.');
+        }
+        // Rate limiting
+        else if (error.message.includes('Rate limit exceeded')) {
+            logCliError('error', 'Rate limit exceeded. Please wait before trying again.');
+        }
+        // General API errors
+        else if (error.message.includes('response') || error.message.includes('status')) {
+            logCliError('error', `API error during ${operation}. Please try again or contact support.`);
+        }
+        // Unknown errors
+        else {
+            logCliError('error', `Unexpected error during ${operation}: ${error.message}`);
+            if (!verbose) {
+                console.error('\n💡 For more details, run the command with --verbose flag');
+            }
+        }
+        if (verbose) {
+            logCliError('error', 'Full error details', {
+                operation,
+                errorType: error.constructor.name,
+                stack: error.stack?.split('\n').slice(0, 5).join('\n') // First 5 lines of stack
+            });
+        }
+    }
+    else {
+        logCliError('error', `Unknown error during ${operation}: ${String(error)}`);
+    }
+    process.exit(1);
+}
+//# sourceMappingURL=errors.js.map