@cakemail-org/cakemail-cli 1.2.0 → 1.5.0

package/dist/utils/errors.js

@@ -0,0 +1,395 @@
+import chalk from 'chalk';
+/**
+ * Common HTTP status codes and their user-friendly messages
+ */
+const HTTP_ERROR_MESSAGES = {
+    400: (ctx) => ({
+        message: 'Invalid request parameters',
+        suggestion: ctx.operation
+            ? `Check the parameters for '${ctx.operation}' operation`
+            : 'Please check your command arguments and try again',
+        help: 'Use --help to see available options'
+    }),
+    401: (ctx) => ({
+        message: 'Authentication failed',
+        suggestion: 'Your credentials are invalid or expired',
+        help: [
+            'To re-authenticate, run: cakemail account logout --force',
+            'Then run any command to authenticate again',
+            'Or check your .env file credentials'
+        ].join('\n')
+    }),
+    403: (ctx) => ({
+        message: 'Permission denied',
+        suggestion: ctx.resource
+            ? `You don't have permission to access this ${ctx.resource}`
+            : 'You don\'t have permission to perform this action',
+        help: ctx.resourceId
+            ? `Check if ${ctx.resource} ${ctx.resourceId} exists and you have access`
+            : 'Verify your account permissions'
+    }),
+    404: (ctx) => ({
+        message: ctx.resource
+            ? `${capitalize(ctx.resource)} not found`
+            : 'Resource not found',
+        suggestion: ctx.resourceId && ctx.resource
+            ? `${capitalize(ctx.resource)} with ID '${ctx.resourceId}' doesn't exist`
+            : `The requested ${ctx.resource || 'resource'} doesn't exist`,
+        help: getListCommandSuggestion(ctx.resource)
+    }),
+    409: (ctx) => ({
+        message: 'Conflict - resource already exists',
+        suggestion: ctx.resource
+            ? `This ${ctx.resource} already exists or conflicts with existing data`
+            : 'The resource already exists',
+        help: 'Try updating the existing resource instead of creating a new one'
+    }),
+    422: (ctx) => ({
+        message: 'Validation error',
+        suggestion: 'One or more fields have invalid values',
+        help: 'Check the error details above for specific field errors'
+    }),
+    429: (ctx) => ({
+        message: 'Rate limit exceeded',
+        suggestion: 'You\'re making too many requests',
+        help: 'Wait a moment before trying again, or reduce request frequency'
+    }),
+    500: (ctx) => ({
+        message: 'Server error',
+        suggestion: 'Something went wrong on the Cakemail server',
+        help: 'This is not your fault. Please try again in a few moments or contact support'
+    }),
+    502: (ctx) => ({
+        message: 'Bad gateway',
+        suggestion: 'The Cakemail API is temporarily unavailable',
+        help: 'Please try again in a few moments'
+    }),
+    503: (ctx) => ({
+        message: 'Service unavailable',
+        suggestion: 'The Cakemail API is temporarily down for maintenance',
+        help: 'Please try again later'
+    })
+};
+/**
+ * Common error patterns and their user-friendly messages
+ */
+const ERROR_PATTERNS = [
+    {
+        pattern: /network|ECONNREFUSED|ENOTFOUND|timeout/i,
+        handler: (match, ctx) => ({
+            message: 'Network connection error',
+            suggestion: 'Unable to connect to the Cakemail API',
+            help: [
+                'Check your internet connection',
+                'Verify the API endpoint is correct',
+                'Check if there\'s a firewall blocking the connection'
+            ].join('\n')
+        })
+    },
+    {
+        pattern: /email.*required|invalid.*email/i,
+        handler: (match, ctx) => ({
+            message: 'Invalid email address',
+            suggestion: 'Please provide a valid email address',
+            help: 'Example: user@example.com'
+        })
+    },
+    {
+        pattern: /list.*not.*found/i,
+        handler: (match, ctx) => ({
+            message: 'List not found',
+            suggestion: ctx.resourceId
+                ? `List ${ctx.resourceId} doesn't exist or you don't have access`
+                : 'The specified list doesn\'t exist',
+            help: 'Use: cakemail lists list    to see all available lists'
+        })
+    },
+    {
+        pattern: /campaign.*not.*found/i,
+        handler: (match, ctx) => ({
+            message: 'Campaign not found',
+            suggestion: ctx.resourceId
+                ? `Campaign ${ctx.resourceId} doesn't exist or you don't have access`
+                : 'The specified campaign doesn\'t exist',
+            help: 'Use: cakemail campaigns list    to see all campaigns'
+        })
+    },
+    {
+        pattern: /contact.*not.*found/i,
+        handler: (match, ctx) => ({
+            message: 'Contact not found',
+            suggestion: ctx.resourceId
+                ? `Contact ${ctx.resourceId} doesn't exist in this list`
+                : 'The specified contact doesn\'t exist',
+            help: 'Use: cakemail contacts list <list-id>    to see contacts'
+        })
+    },
+    {
+        pattern: /Missing.*CAKEMAIL/i,
+        handler: (match, ctx) => ({
+            message: 'Missing credentials',
+            suggestion: 'Authentication credentials are not configured',
+            help: [
+                'Set credentials in .env file or environment variables:',
+                '  CAKEMAIL_EMAIL=your@email.com',
+                '  CAKEMAIL_PASSWORD=your_password',
+                '',
+                'Or run any command to authenticate interactively'
+            ].join('\n')
+        })
+    }
+];
+/**
+ * Get list command suggestion for a resource type
+ */
+function getListCommandSuggestion(resource) {
+    if (!resource)
+        return undefined;
+    const commands = {
+        'list': 'cakemail lists list',
+        'campaign': 'cakemail campaigns list',
+        'contact': 'cakemail contacts list <list-id>',
+        'sender': 'cakemail senders list',
+        'template': 'cakemail templates list',
+        'webhook': 'cakemail webhooks list',
+        'segment': 'cakemail segments list <list-id>',
+        'attribute': 'cakemail attributes list <list-id>'
+    };
+    const command = commands[resource.toLowerCase()];
+    return command ? `To see all ${resource}s, use: ${command}` : undefined;
+}
+/**
+ * Capitalize first letter
+ */
+function capitalize(str) {
+    return str.charAt(0).toUpperCase() + str.slice(1);
+}
+/**
+ * Parse API error response
+ */
+function parseApiError(error) {
+    // Check for SDK/Axios error structure
+    if (error.response) {
+        return {
+            statusCode: error.response.status,
+            message: error.response.data?.message || error.response.data?.error || error.message,
+            details: error.response.data
+        };
+    }
+    // Check for SDK ApiError structure
+    if (error.status) {
+        return {
+            statusCode: error.status,
+            message: error.body?.message || error.message,
+            details: error.body
+        };
+    }
+    // Fallback to error message
+    return {
+        message: error.message || 'An unknown error occurred'
+    };
+}
+/**
+ * Enhance error with user-friendly message and suggestions
+ */
+export function enhanceError(error, context) {
+    const parsed = parseApiError(error);
+    // Try HTTP status code mapping first
+    if (parsed.statusCode && HTTP_ERROR_MESSAGES[parsed.statusCode]) {
+        const enhanced = HTTP_ERROR_MESSAGES[parsed.statusCode](context);
+        // Add validation details for 422 errors
+        if (parsed.statusCode === 422 && parsed.details?.errors) {
+            enhanced.suggestion = formatValidationErrors(parsed.details.errors);
+        }
+        return enhanced;
+    }
+    // Try pattern matching
+    for (const { pattern, handler } of ERROR_PATTERNS) {
+        const match = parsed.message.match(pattern);
+        if (match) {
+            return handler(match, context);
+        }
+    }
+    // Fallback to original error message
+    return {
+        message: parsed.message,
+        suggestion: 'An unexpected error occurred',
+        help: 'If this persists, please report it at: https://github.com/cakemail/cli/issues'
+    };
+}
+/**
+ * Format validation errors from API response
+ */
+function formatValidationErrors(errors) {
+    if (Array.isArray(errors)) {
+        return errors.map(err => {
+            if (typeof err === 'string')
+                return err;
+            if (err.field && err.message)
+                return `${err.field}: ${err.message}`;
+            if (err.loc && err.msg)
+                return `${err.loc.join('.')}: ${err.msg}`;
+            return JSON.stringify(err);
+        }).join('\n');
+    }
+    if (typeof errors === 'object') {
+        return Object.entries(errors)
+            .map(([field, message]) => `${field}: ${message}`)
+            .join('\n');
+    }
+    return String(errors);
+}
+/**
+ * Display enhanced error to user (profile-aware)
+ */
+export function displayError(error, context) {
+    const enhanced = enhanceError(error, context);
+    const profile = context.profileConfig;
+    const verboseErrors = profile?.display.verbose_errors ?? false;
+    const showApiDetails = profile?.display.show_api_details ?? false;
+    // For developer profile: show technical details
+    if (verboseErrors && showApiDetails) {
+        displayDeveloperError(error, enhanced, context);
+    }
+    else {
+        // For marketer/balanced profile: show friendly error
+        displayFriendlyError(enhanced, context);
+    }
+}
+/**
+ * Display friendly error message (marketer/balanced profile)
+ */
+function displayFriendlyError(enhanced, context) {
+    // Main error message
+    console.error(chalk.red('✗ Oops!'), chalk.bold(enhanced.message));
+    // Suggestion
+    if (enhanced.suggestion) {
+        console.error(chalk.yellow('\n→'), enhanced.suggestion);
+    }
+    // Help text
+    if (enhanced.help) {
+        console.error(chalk.gray('\n💡 What you can do:'));
+        enhanced.help.split('\n').forEach(line => {
+            console.error(chalk.gray('  ' + line));
+        });
+    }
+    // Docs URL
+    if (enhanced.docsUrl) {
+        console.error(chalk.cyan('\n📖 Learn more:'), enhanced.docsUrl);
+    }
+    console.error(''); // Empty line for spacing
+}
+/**
+ * Display technical error message (developer profile)
+ */
+function displayDeveloperError(error, enhanced, context) {
+    const parsed = parseApiError(error);
+    // Main error message
+    console.error(chalk.red('Error:'), enhanced.message);
+    // Status code and details
+    if (parsed.statusCode) {
+        console.error(chalk.gray(`Status: ${parsed.statusCode}`));
+    }
+    if (context.operation) {
+        console.error(chalk.gray(`Operation: ${context.operation}`));
+    }
+    if (context.resource && context.resourceId) {
+        console.error(chalk.gray(`Resource: ${context.resource} (${context.resourceId})`));
+    }
+    // API response details
+    if (parsed.details) {
+        console.error(chalk.gray('\nAPI Response:'));
+        console.error(chalk.gray(JSON.stringify(parsed.details, null, 2)));
+    }
+    // Suggestion
+    if (enhanced.suggestion) {
+        console.error(chalk.yellow('\nSuggestion:'), enhanced.suggestion);
+    }
+    // Help text
+    if (enhanced.help) {
+        console.error(chalk.gray('\nHelp:'));
+        enhanced.help.split('\n').forEach(line => {
+            console.error(chalk.gray('  ' + line));
+        });
+    }
+    console.error(''); // Empty line for spacing
+}
+/**
+ * Validation helpers
+ */
+export const validate = {
+    /**
+     * Validate email format
+     */
+    email(email) {
+        const emailRegex = /^[^\s@]+@[^\s@]+\.[^\s@]+$/;
+        if (!emailRegex.test(email)) {
+            return {
+                valid: false,
+                error: `Invalid email format: ${email}`
+            };
+        }
+        return { valid: true };
+    },
+    /**
+     * Validate ID is a positive integer
+     */
+    id(id, resourceName = 'ID') {
+        const numId = typeof id === 'string' ? parseInt(id, 10) : id;
+        if (isNaN(numId) || numId <= 0) {
+            return {
+                valid: false,
+                error: `${resourceName} must be a positive number, got: ${id}`
+            };
+        }
+        return { valid: true };
+    },
+    /**
+     * Validate date format (YYYY-MM-DD)
+     */
+    date(date) {
+        const dateRegex = /^\d{4}-\d{2}-\d{2}$/;
+        if (!dateRegex.test(date)) {
+            return {
+                valid: false,
+                error: `Invalid date format: ${date}. Expected: YYYY-MM-DD (e.g., 2025-01-15)`
+            };
+        }
+        const parsed = new Date(date);
+        if (isNaN(parsed.getTime())) {
+            return {
+                valid: false,
+                error: `Invalid date: ${date}`
+            };
+        }
+        return { valid: true };
+    },
+    /**
+     * Validate required field
+     */
+    required(value, fieldName) {
+        if (value === undefined || value === null || value === '') {
+            return {
+                valid: false,
+                error: `${fieldName} is required`
+            };
+        }
+        return { valid: true };
+    },
+    /**
+     * Validate JSON string
+     */
+    json(jsonString, fieldName = 'JSON') {
+        try {
+            const parsed = JSON.parse(jsonString);
+            return { valid: true, parsed };
+        }
+        catch (e) {
+            return {
+                valid: false,
+                error: `Invalid ${fieldName}: ${e.message}`
+            };
+        }
+    }
+};
+//# sourceMappingURL=errors.js.map

package/dist/utils/errors.js.map

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

package/dist/utils/interactive.d.ts

@@ -0,0 +1,97 @@
+/**
+ * Interactive Prompt System
+ *
+ * Profile-aware prompts that adapt to user preferences:
+ * - Developer profile: Skip prompts, require explicit arguments
+ * - Marketer profile: Interactive prompts for missing arguments
+ * - Balanced profile: Auto-detect TTY and prompt when interactive
+ */
+import { ProfileConfig } from '../types/profile.js';
+/**
+ * Check if we're in an interactive terminal
+ */
+export declare function isInteractive(): boolean;
+/**
+ * Check if we're in scripting/batch mode
+ * Indicators: CI environment, non-TTY, or explicit flags
+ */
+export declare function isScriptingMode(): boolean;
+/**
+ * Determine if prompts should be shown based on profile and environment
+ */
+export declare function shouldPrompt(profileConfig?: ProfileConfig): boolean;
+/**
+ * Prompt for a text input
+ */
+export declare function promptText(message: string, options?: {
+    default?: string;
+    required?: boolean;
+    validate?: (input: string) => boolean | string;
+    profileConfig?: ProfileConfig;
+}): Promise<string | undefined>;
+/**
+ * Prompt for a number input
+ */
+export declare function promptNumber(message: string, options?: {
+    default?: number;
+    required?: boolean;
+    min?: number;
+    max?: number;
+    profileConfig?: ProfileConfig;
+}): Promise<number | undefined>;
+/**
+ * Prompt for a selection from a list
+ */
+export declare function promptSelect<T = string>(message: string, choices: Array<{
+    name: string;
+    value: T;
+    description?: string;
+}>, options?: {
+    default?: T;
+    required?: boolean;
+    profileConfig?: ProfileConfig;
+}): Promise<T | undefined>;
+/**
+ * Prompt for multiple selections from a list
+ */
+export declare function promptMultiSelect<T = string>(message: string, choices: Array<{
+    name: string;
+    value: T;
+    description?: string;
+    checked?: boolean;
+}>, options?: {
+    required?: boolean;
+    profileConfig?: ProfileConfig;
+}): Promise<T[] | undefined>;
+/**
+ * Prompt for yes/no confirmation
+ */
+export declare function promptConfirm(message: string, options?: {
+    default?: boolean;
+    profileConfig?: ProfileConfig;
+}): Promise<boolean>;
+/**
+ * Prompt for password/secret input (hidden)
+ */
+export declare function promptPassword(message: string, options?: {
+    required?: boolean;
+    validate?: (input: string) => boolean | string;
+    profileConfig?: ProfileConfig;
+}): Promise<string | undefined>;
+/**
+ * Show a loading spinner (profile-aware)
+ */
+export interface Spinner {
+    start(text?: string): void;
+    stop(text?: string): void;
+    succeed(text?: string): void;
+    fail(text?: string): void;
+    text: string;
+}
+/**
+ * Create a profile-aware spinner
+ * Returns a real spinner for profiles with show_progress enabled,
+ * otherwise returns a no-op spinner
+ */
+export declare function createSpinner(initialText: string, profileConfig?: ProfileConfig): Spinner;
+//# sourceMappingURL=interactive.d.ts.map

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

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