@cakemail-org/cakemail-cli 1.3.0 → 1.5.0

package/dist/utils/defaults.js

@@ -0,0 +1,195 @@
+import chalk from 'chalk';
+// In-memory cache for session (cleared on CLI exit)
+const sessionCache = {};
+const CACHE_TTL = 5 * 60 * 1000; // 5 minutes
+/**
+ * Check if cached resource is still valid
+ */
+function isCacheValid(cached) {
+    if (!cached)
+        return false;
+    return Date.now() - cached.timestamp < CACHE_TTL;
+}
+/**
+ * Auto-detect list ID when only one exists
+ * Returns the list ID if only one list exists, otherwise undefined
+ */
+export async function autoDetectList(client, formatter, providedListId, options = {}) {
+    // If user provided a list ID, use it
+    if (providedListId !== undefined) {
+        const listId = typeof providedListId === 'string' ? parseInt(providedListId) : providedListId;
+        // Cache it for future use
+        sessionCache.lastList = {
+            id: listId,
+            timestamp: Date.now()
+        };
+        return listId;
+    }
+    // Check cache if enabled
+    if (options.useCache && isCacheValid(sessionCache.lastList)) {
+        if (!options.silent) {
+            formatter.info(`Using cached list: ${sessionCache.lastList.id}${sessionCache.lastList.name ? ` (${sessionCache.lastList.name})` : ''}`);
+        }
+        return sessionCache.lastList.id;
+    }
+    try {
+        // Fetch all lists
+        const response = await client.sdk.lists.list({ per_page: 100 });
+        const lists = response.data || [];
+        if (lists.length === 0) {
+            if (!options.silent) {
+                formatter.error('No lists found. Create a list first with: cakemail lists create -n "My List"');
+            }
+            return undefined;
+        }
+        if (lists.length === 1) {
+            const list = lists[0];
+            const listId = list.id;
+            // Cache it
+            sessionCache.lastList = {
+                id: listId,
+                name: list.name,
+                timestamp: Date.now()
+            };
+            if (!options.silent) {
+                formatter.info(chalk.gray(`Auto-detected list: ${listId} (${list.name})`));
+            }
+            return listId;
+        }
+        // Multiple lists exist
+        if (!options.silent) {
+            formatter.info(chalk.yellow('Multiple lists found. Please specify --list-id <id>'));
+            formatter.info(chalk.gray('Available lists:'));
+            lists.slice(0, 5).forEach((list) => {
+                formatter.info(chalk.gray(`  ${list.id}: ${list.name}`));
+            });
+            if (lists.length > 5) {
+                formatter.info(chalk.gray(`  ... and ${lists.length - 5} more`));
+            }
+        }
+        return undefined;
+    }
+    catch (error) {
+        if (!options.silent) {
+            formatter.error(`Failed to auto-detect list: ${error.message}`);
+        }
+        return undefined;
+    }
+}
+/**
+ * Auto-detect sender ID when only one verified sender exists
+ */
+export async function autoDetectSender(client, formatter, providedSenderId, options = {}) {
+    // If user provided a sender ID, use it
+    if (providedSenderId !== undefined) {
+        const senderId = String(providedSenderId);
+        // Cache it for future use
+        sessionCache.lastSender = {
+            id: senderId,
+            timestamp: Date.now()
+        };
+        return senderId;
+    }
+    // Check cache if enabled
+    if (options.useCache && isCacheValid(sessionCache.lastSender)) {
+        if (!options.silent) {
+            formatter.info(`Using cached sender: ${sessionCache.lastSender.id}${sessionCache.lastSender.name ? ` (${sessionCache.lastSender.name})` : ''}`);
+        }
+        return sessionCache.lastSender.id;
+    }
+    try {
+        // Fetch all senders
+        const response = await client.sdk.senderService.listSenders({ perPage: 100 });
+        const allSenders = response.data || [];
+        // Filter to confirmed senders if required
+        const senders = options.requireConfirmed
+            ? allSenders.filter((s) => s.confirmed === true)
+            : allSenders;
+        if (senders.length === 0) {
+            if (!options.silent) {
+                if (options.requireConfirmed && allSenders.length > 0) {
+                    formatter.error('No confirmed senders found. Please confirm a sender first.');
+                }
+                else {
+                    formatter.error('No senders found. Create a sender first with: cakemail senders create -n "Name" -e "email@domain.com"');
+                }
+            }
+            return undefined;
+        }
+        if (senders.length === 1) {
+            const sender = senders[0];
+            const senderId = sender.id;
+            // Cache it
+            sessionCache.lastSender = {
+                id: senderId,
+                name: sender.name,
+                timestamp: Date.now()
+            };
+            if (!options.silent) {
+                formatter.info(chalk.gray(`Auto-detected sender: ${senderId} (${sender.name} <${sender.email}>)`));
+            }
+            return senderId;
+        }
+        // Multiple senders exist
+        if (!options.silent) {
+            const senderType = options.requireConfirmed ? 'confirmed senders' : 'senders';
+            formatter.info(chalk.yellow(`Multiple ${senderType} found. Please specify --sender-id <id>`));
+            formatter.info(chalk.gray('Available senders:'));
+            senders.slice(0, 5).forEach((sender) => {
+                const confirmed = sender.confirmed ? chalk.green('✓') : chalk.gray('✗');
+                formatter.info(chalk.gray(`  ${sender.id}: ${sender.name} <${sender.email}> ${confirmed}`));
+            });
+            if (senders.length > 5) {
+                formatter.info(chalk.gray(`  ... and ${senders.length - 5} more`));
+            }
+        }
+        return undefined;
+    }
+    catch (error) {
+        if (!options.silent) {
+            formatter.error(`Failed to auto-detect sender: ${error.message}`);
+        }
+        return undefined;
+    }
+}
+/**
+ * Get last used list from cache
+ */
+export function getLastList() {
+    if (isCacheValid(sessionCache.lastList)) {
+        return sessionCache.lastList.id;
+    }
+    return undefined;
+}
+/**
+ * Get last used sender from cache
+ */
+export function getLastSender() {
+    if (isCacheValid(sessionCache.lastSender)) {
+        return sessionCache.lastSender.id;
+    }
+    return undefined;
+}
+/**
+ * Clear session cache (useful for testing)
+ */
+export function clearCache() {
+    sessionCache.lastList = undefined;
+    sessionCache.lastCampaign = undefined;
+    sessionCache.lastSender = undefined;
+}
+/**
+ * Suggest a default value for a missing required option
+ * Returns the detected value or undefined
+ */
+export async function suggestDefault(client, formatter, type, options = {}) {
+    switch (type) {
+        case 'list':
+            return autoDetectList(client, formatter, undefined, options);
+        case 'sender':
+            return autoDetectSender(client, formatter, undefined, options);
+        default:
+            return undefined;
+    }
+}
+//# sourceMappingURL=defaults.js.map

package/dist/utils/defaults.js.map

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

package/dist/utils/errors.d.ts

@@ -0,0 +1,67 @@
+import { ProfileConfig } from '../types/profile.js';
+/**
+ * Enhanced error handling with user-friendly messages and suggestions
+ */
+export interface ErrorContext {
+    command: string;
+    resource?: string;
+    resourceId?: string | number;
+    operation?: string;
+    profileConfig?: ProfileConfig;
+}
+export interface EnhancedError {
+    message: string;
+    suggestion?: string;
+    help?: string;
+    docsUrl?: string;
+}
+/**
+ * Enhance error with user-friendly message and suggestions
+ */
+export declare function enhanceError(error: any, context: ErrorContext): EnhancedError;
+/**
+ * Display enhanced error to user (profile-aware)
+ */
+export declare function displayError(error: any, context: ErrorContext): void;
+/**
+ * Validation helpers
+ */
+export declare const validate: {
+    /**
+     * Validate email format
+     */
+    email(email: string): {
+        valid: boolean;
+        error?: string;
+    };
+    /**
+     * Validate ID is a positive integer
+     */
+    id(id: string | number, resourceName?: string): {
+        valid: boolean;
+        error?: string;
+    };
+    /**
+     * Validate date format (YYYY-MM-DD)
+     */
+    date(date: string): {
+        valid: boolean;
+        error?: string;
+    };
+    /**
+     * Validate required field
+     */
+    required(value: any, fieldName: string): {
+        valid: boolean;
+        error?: string;
+    };
+    /**
+     * Validate JSON string
+     */
+    json(jsonString: string, fieldName?: string): {
+        valid: boolean;
+        error?: string;
+        parsed?: any;
+    };
+};
+//# sourceMappingURL=errors.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../../src/utils/errors.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AAEpD;;GAEG;AAEH,MAAM,WAAW,YAAY;IAC3B,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,UAAU,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;IAC7B,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,aAAa,CAAC,EAAE,aAAa,CAAC;CAC/B;AAED,MAAM,WAAW,aAAa;IAC5B,OAAO,EAAE,MAAM,CAAC;IAChB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAoND;;GAEG;AACH,wBAAgB,YAAY,CAAC,KAAK,EAAE,GAAG,EAAE,OAAO,EAAE,YAAY,GAAG,aAAa,CA6B7E;AAwBD;;GAEG;AACH,wBAAgB,YAAY,CAAC,KAAK,EAAE,GAAG,EAAE,OAAO,EAAE,YAAY,GAAG,IAAI,CAapE;AA0ED;;GAEG;AACH,eAAO,MAAM,QAAQ;IACnB;;OAEG;iBACU,MAAM,GAAG;QAAE,KAAK,EAAE,OAAO,CAAC;QAAC,KAAK,CAAC,EAAE,MAAM,CAAA;KAAE;IAWxD;;OAEG;WACI,MAAM,GAAG,MAAM,iBAAgB,MAAM,GAAU;QAAE,KAAK,EAAE,OAAO,CAAC;QAAC,KAAK,CAAC,EAAE,MAAM,CAAA;KAAE;IAWxF;;OAEG;eACQ,MAAM,GAAG;QAAE,KAAK,EAAE,OAAO,CAAC;QAAC,KAAK,CAAC,EAAE,MAAM,CAAA;KAAE;IAoBtD;;OAEG;oBACa,GAAG,aAAa,MAAM,GAAG;QAAE,KAAK,EAAE,OAAO,CAAC;QAAC,KAAK,CAAC,EAAE,MAAM,CAAA;KAAE;IAU3E;;OAEG;qBACc,MAAM,cAAa,MAAM,GAAY;QAAE,KAAK,EAAE,OAAO,CAAC;QAAC,KAAK,CAAC,EAAE,MAAM,CAAC;QAAC,MAAM,CAAC,EAAE,GAAG,CAAA;KAAE;CAWvG,CAAC"}

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