@cakemail-org/cakemail-cli 1.2.0 → 1.5.0

package/dist/utils/config.js

@@ -1,14 +1,77 @@
 import { config } from 'dotenv';
-// Load .env from current working directory
+import { authenticateInteractively } from './auth.js';
+import { loadConfigFile, getProfileConfig, getCurrentProfile, migrateFromEnv } from './config-file.js';
+// Load .env from current working directory (fallback for backward compatibility)
 config({ path: process.cwd() + '/.env' });
-export function getConfig(required = true) {
-    const accessToken = process.env.CAKEMAIL_ACCESS_TOKEN;
-    const email = process.env.CAKEMAIL_EMAIL || process.env.CAKEMAIL_USERNAME;
-    const password = process.env.CAKEMAIL_PASSWORD;
-    const baseURL = process.env.CAKEMAIL_API_BASE;
-    const outputFormat = (process.env.CAKEMAIL_OUTPUT_FORMAT || 'json');
+export async function getConfig(required = true, interactive = true) {
+    // Try to load from config file first
+    let configFile = loadConfigFile();
+    // If no config file exists, try to migrate from .env
+    if (!configFile) {
+        configFile = migrateFromEnv();
+    }
+    // Load credentials from config file or .env
+    let accessToken = configFile?.auth?.token || process.env.CAKEMAIL_ACCESS_TOKEN;
+    let email = configFile?.auth?.email || process.env.CAKEMAIL_EMAIL || process.env.CAKEMAIL_USERNAME;
+    let password = process.env.CAKEMAIL_PASSWORD; // Password not stored in config (security)
+    const baseURL = configFile?.auth?.base_url || process.env.CAKEMAIL_API_BASE;
+    const currentAccountId = configFile?.defaults?.account_id || process.env.CAKEMAIL_CURRENT_ACCOUNT_ID || undefined;
+    // Load profile configuration
+    const profile = getCurrentProfile();
+    const profileConfig = getProfileConfig(profile);
+    // Output format priority: env var > profile config > default
+    const outputFormat = process.env.CAKEMAIL_OUTPUT_FORMAT || profileConfig.output.format;
+    // If credentials are missing and interactive mode is enabled, prompt the user
+    if (required && !accessToken && (!email || !password)) {
+        if (interactive) {
+            // Interactive authentication flow
+            const credentials = await authenticateInteractively();
+            email = credentials.email;
+            password = credentials.password;
+            // Reload config file (it was updated by auth flow)
+            configFile = loadConfigFile();
+            // Reload .env to get any updates from authentication (backward compatibility)
+            config({ path: process.cwd() + '/.env', override: true });
+        }
+        else {
+            throw new Error('Missing credentials. Set CAKEMAIL_ACCESS_TOKEN or (CAKEMAIL_EMAIL and CAKEMAIL_PASSWORD) in environment variables, .env file, or run authentication');
+        }
+    }
+    return {
+        accessToken,
+        email,
+        password,
+        baseURL,
+        outputFormat,
+        currentAccountId,
+        profile,
+        profileConfig,
+    };
+}
+/**
+ * Synchronous version of getConfig for backwards compatibility
+ * Use this only when you're certain credentials are already set
+ */
+export function getConfigSync(required = true) {
+    // Try to load from config file first
+    let configFile = loadConfigFile();
+    // If no config file exists, try to migrate from .env
+    if (!configFile) {
+        configFile = migrateFromEnv();
+    }
+    // Load credentials from config file or .env
+    const accessToken = configFile?.auth?.token || process.env.CAKEMAIL_ACCESS_TOKEN;
+    const email = configFile?.auth?.email || process.env.CAKEMAIL_EMAIL || process.env.CAKEMAIL_USERNAME;
+    const password = process.env.CAKEMAIL_PASSWORD; // Password not stored in config (security)
+    const baseURL = configFile?.auth?.base_url || process.env.CAKEMAIL_API_BASE;
+    const currentAccountId = configFile?.defaults?.account_id || process.env.CAKEMAIL_CURRENT_ACCOUNT_ID || undefined;
+    // Load profile configuration
+    const profile = getCurrentProfile();
+    const profileConfig = getProfileConfig(profile);
+    // Output format priority: env var > profile config > default
+    const outputFormat = process.env.CAKEMAIL_OUTPUT_FORMAT || profileConfig.output.format;
     if (required && !accessToken && (!email || !password)) {
-        throw new Error('Missing credentials. Set CAKEMAIL_ACCESS_TOKEN or (CAKEMAIL_EMAIL and CAKEMAIL_PASSWORD) in environment variables or .env file');
+        throw new Error('Missing credentials. Set CAKEMAIL_ACCESS_TOKEN or (CAKEMAIL_EMAIL and CAKEMAIL_PASSWORD) in environment variables, .env file, or run authentication');
     }
     return {
         accessToken,
@@ -16,6 +79,9 @@ export function getConfig(required = true) {
         password,
         baseURL,
         outputFormat,
+        currentAccountId,
+        profile,
+        profileConfig,
     };
 }
 //# sourceMappingURL=config.js.map

package/dist/utils/config.js.map

@@ -1 +1 @@
-{"version":3,"file":"config.js","sourceRoot":"","sources":["../../src/utils/config.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAC;AAGhC,2CAA2C;AAC3C,MAAM,CAAC,EAAE,IAAI,EAAE,OAAO,CAAC,GAAG,EAAE,GAAG,OAAO,EAAE,CAAC,CAAC;AAQ1C,MAAM,UAAU,SAAS,CAAC,WAAoB,IAAI;IAChD,MAAM,WAAW,GAAG,OAAO,CAAC,GAAG,CAAC,qBAAqB,CAAC;IACtD,MAAM,KAAK,GAAG,OAAO,CAAC,GAAG,CAAC,cAAc,IAAI,OAAO,CAAC,GAAG,CAAC,iBAAiB,CAAC;IAC1E,MAAM,QAAQ,GAAG,OAAO,CAAC,GAAG,CAAC,iBAAiB,CAAC;IAC/C,MAAM,OAAO,GAAG,OAAO,CAAC,GAAG,CAAC,iBAAiB,CAAC;IAC9C,MAAM,YAAY,GAAG,CAAC,OAAO,CAAC,GAAG,CAAC,sBAAsB,IAAI,MAAM,CAAiB,CAAC;IAEpF,IAAI,QAAQ,IAAI,CAAC,WAAW,IAAI,CAAC,CAAC,KAAK,IAAI,CAAC,QAAQ,CAAC,EAAE,CAAC;QACtD,MAAM,IAAI,KAAK,CACb,gIAAgI,CACjI,CAAC;IACJ,CAAC;IAED,OAAO;QACL,WAAW;QACX,KAAK;QACL,QAAQ;QACR,OAAO;QACP,YAAY;KACb,CAAC;AACJ,CAAC"}
+{"version":3,"file":"config.js","sourceRoot":"","sources":["../../src/utils/config.ts"],"names":[],"mappings":"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"}

package/dist/utils/confirm.d.ts

@@ -0,0 +1,38 @@
+import { ProfileConfig } from '../types/profile.js';
+/**
+ * Interactive confirmation utilities for destructive operations
+ * Profile-aware: adapts behavior based on user profile settings
+ */
+export interface ConfirmOptions {
+    message?: string;
+    resourceType?: string;
+    resourceId?: string | number;
+    details?: string[];
+    dangerLevel?: 'low' | 'medium' | 'high';
+    profileConfig?: ProfileConfig;
+}
+/**
+ * Display confirmation prompt for destructive operations
+ * Returns true if user confirms, false if they cancel
+ * Profile-aware: skips confirmation for developer profile
+ */
+export declare function confirm(options?: ConfirmOptions): Promise<boolean>;
+/**
+ * Confirm deletion of a resource
+ */
+export declare function confirmDelete(resourceType: string, resourceId: string | number, details?: string[], profileConfig?: ProfileConfig): Promise<boolean>;
+/**
+ * Confirm deletion with high danger level (permanent, no recovery)
+ */
+export declare function confirmDangerousDelete(resourceType: string, resourceId: string | number, details?: string[], profileConfig?: ProfileConfig): Promise<boolean>;
+/**
+ * Confirm a custom action
+ */
+export declare function confirmAction(message: string, details?: string[], dangerLevel?: 'low' | 'medium' | 'high', profileConfig?: ProfileConfig): Promise<boolean>;
+/**
+ * Check if force flag is present (for backwards compatibility)
+ * If force flag is present, skip confirmation
+ * If not present, show interactive confirmation
+ */
+export declare function shouldProceed(forceFlag: boolean, confirmOptions: ConfirmOptions): Promise<boolean>;
+//# sourceMappingURL=confirm.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"confirm.d.ts","sourceRoot":"","sources":["../../src/utils/confirm.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AAGpD;;;GAGG;AAEH,MAAM,WAAW,cAAc;IAC7B,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,UAAU,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;IAC7B,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;IACnB,WAAW,CAAC,EAAE,KAAK,GAAG,QAAQ,GAAG,MAAM,CAAC;IACxC,aAAa,CAAC,EAAE,aAAa,CAAC;CAC/B;AAoBD;;;;GAIG;AACH,wBAAsB,OAAO,CAAC,OAAO,GAAE,cAAmB,GAAG,OAAO,CAAC,OAAO,CAAC,CAmE5E;AAED;;GAEG;AACH,wBAAsB,aAAa,CACjC,YAAY,EAAE,MAAM,EACpB,UAAU,EAAE,MAAM,GAAG,MAAM,EAC3B,OAAO,CAAC,EAAE,MAAM,EAAE,EAClB,aAAa,CAAC,EAAE,aAAa,GAC5B,OAAO,CAAC,OAAO,CAAC,CAQlB;AAED;;GAEG;AACH,wBAAsB,sBAAsB,CAC1C,YAAY,EAAE,MAAM,EACpB,UAAU,EAAE,MAAM,GAAG,MAAM,EAC3B,OAAO,CAAC,EAAE,MAAM,EAAE,EAClB,aAAa,CAAC,EAAE,aAAa,GAC5B,OAAO,CAAC,OAAO,CAAC,CAQlB;AAED;;GAEG;AACH,wBAAsB,aAAa,CACjC,OAAO,EAAE,MAAM,EACf,OAAO,CAAC,EAAE,MAAM,EAAE,EAClB,WAAW,GAAE,KAAK,GAAG,QAAQ,GAAG,MAAiB,EACjD,aAAa,CAAC,EAAE,aAAa,GAC5B,OAAO,CAAC,OAAO,CAAC,CAOlB;AAED;;;;GAIG;AACH,wBAAsB,aAAa,CACjC,SAAS,EAAE,OAAO,EAClB,cAAc,EAAE,cAAc,GAC7B,OAAO,CAAC,OAAO,CAAC,CAQlB"}

package/dist/utils/confirm.js

@@ -0,0 +1,124 @@
+import inquirer from 'inquirer';
+import chalk from 'chalk';
+import { isScriptingMode } from './interactive.js';
+/**
+ * Determine if confirmation should be shown based on profile
+ */
+function shouldConfirm(profileConfig) {
+    // Always skip in scripting mode
+    if (isScriptingMode()) {
+        return false;
+    }
+    // No profile config - default to confirming
+    if (!profileConfig) {
+        return true;
+    }
+    // Check profile setting for destructive operations
+    return profileConfig.behavior.confirm_destructive;
+}
+/**
+ * Display confirmation prompt for destructive operations
+ * Returns true if user confirms, false if they cancel
+ * Profile-aware: skips confirmation for developer profile
+ */
+export async function confirm(options = {}) {
+    const { message, resourceType, resourceId, details = [], dangerLevel = 'medium', profileConfig } = options;
+    // Check if confirmation is needed based on profile
+    if (!shouldConfirm(profileConfig)) {
+        return true; // Auto-confirm for developer profile or scripting mode
+    }
+    // Build the confirmation message
+    let confirmMessage = message;
+    if (!confirmMessage && resourceType) {
+        if (resourceId) {
+            confirmMessage = `Delete ${resourceType} ${chalk.bold(resourceId)}?`;
+        }
+        else {
+            confirmMessage = `Delete this ${resourceType}?`;
+        }
+    }
+    if (!confirmMessage) {
+        confirmMessage = 'Are you sure?';
+    }
+    // Show danger level indicator
+    const dangerIndicators = {
+        low: chalk.yellow('⚠'),
+        medium: chalk.red('⚠'),
+        high: chalk.red.bold('⚠⚠⚠')
+    };
+    console.log('');
+    console.log(dangerIndicators[dangerLevel], chalk.bold('Confirmation Required'));
+    console.log('');
+    // Show details if provided
+    if (details.length > 0) {
+        console.log(chalk.gray('This will:'));
+        details.forEach(detail => {
+            console.log(chalk.gray(`  • ${detail}`));
+        });
+        console.log('');
+    }
+    // Show warning for high danger operations
+    if (dangerLevel === 'high') {
+        console.log(chalk.red.bold('⚠ WARNING: This action cannot be undone!'));
+        console.log('');
+    }
+    // Prompt for confirmation
+    const answer = await inquirer.prompt([
+        {
+            type: 'confirm',
+            name: 'confirmed',
+            message: confirmMessage,
+            default: false
+        }
+    ]);
+    return answer.confirmed;
+}
+/**
+ * Confirm deletion of a resource
+ */
+export async function confirmDelete(resourceType, resourceId, details, profileConfig) {
+    return confirm({
+        resourceType,
+        resourceId,
+        details,
+        dangerLevel: 'medium',
+        profileConfig
+    });
+}
+/**
+ * Confirm deletion with high danger level (permanent, no recovery)
+ */
+export async function confirmDangerousDelete(resourceType, resourceId, details, profileConfig) {
+    return confirm({
+        resourceType,
+        resourceId,
+        details,
+        dangerLevel: 'high',
+        profileConfig
+    });
+}
+/**
+ * Confirm a custom action
+ */
+export async function confirmAction(message, details, dangerLevel = 'medium', profileConfig) {
+    return confirm({
+        message,
+        details,
+        dangerLevel,
+        profileConfig
+    });
+}
+/**
+ * Check if force flag is present (for backwards compatibility)
+ * If force flag is present, skip confirmation
+ * If not present, show interactive confirmation
+ */
+export async function shouldProceed(forceFlag, confirmOptions) {
+    // If force flag is present, skip confirmation
+    if (forceFlag) {
+        return true;
+    }
+    // Otherwise show interactive confirmation
+    return confirm(confirmOptions);
+}
+//# sourceMappingURL=confirm.js.map

package/dist/utils/confirm.js.map

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

package/dist/utils/defaults.d.ts

@@ -0,0 +1,39 @@
+import { CakemailClient } from '../client.js';
+import { OutputFormatter } from './output.js';
+/**
+ * Auto-detect list ID when only one exists
+ * Returns the list ID if only one list exists, otherwise undefined
+ */
+export declare function autoDetectList(client: CakemailClient, formatter: OutputFormatter, providedListId?: string | number, options?: {
+    silent?: boolean;
+    useCache?: boolean;
+}): Promise<number | undefined>;
+/**
+ * Auto-detect sender ID when only one verified sender exists
+ */
+export declare function autoDetectSender(client: CakemailClient, formatter: OutputFormatter, providedSenderId?: string | number, options?: {
+    silent?: boolean;
+    useCache?: boolean;
+    requireConfirmed?: boolean;
+}): Promise<string | undefined>;
+/**
+ * Get last used list from cache
+ */
+export declare function getLastList(): number | undefined;
+/**
+ * Get last used sender from cache
+ */
+export declare function getLastSender(): string | undefined;
+/**
+ * Clear session cache (useful for testing)
+ */
+export declare function clearCache(): void;
+/**
+ * Suggest a default value for a missing required option
+ * Returns the detected value or undefined
+ */
+export declare function suggestDefault(client: CakemailClient, formatter: OutputFormatter, type: 'list' | 'sender', options?: {
+    silent?: boolean;
+    useCache?: boolean;
+}): Promise<string | number | undefined>;
+//# sourceMappingURL=defaults.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"defaults.d.ts","sourceRoot":"","sources":["../../src/utils/defaults.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AAC9C,OAAO,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AA+B9C;;;GAGG;AACH,wBAAsB,cAAc,CAClC,MAAM,EAAE,cAAc,EACtB,SAAS,EAAE,eAAe,EAC1B,cAAc,CAAC,EAAE,MAAM,GAAG,MAAM,EAChC,OAAO,GAAE;IAAE,MAAM,CAAC,EAAE,OAAO,CAAC;IAAC,QAAQ,CAAC,EAAE,OAAO,CAAA;CAAO,GACrD,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC,CAuE7B;AAED;;GAEG;AACH,wBAAsB,gBAAgB,CACpC,MAAM,EAAE,cAAc,EACtB,SAAS,EAAE,eAAe,EAC1B,gBAAgB,CAAC,EAAE,MAAM,GAAG,MAAM,EAClC,OAAO,GAAE;IAAE,MAAM,CAAC,EAAE,OAAO,CAAC;IAAC,QAAQ,CAAC,EAAE,OAAO,CAAC;IAAC,gBAAgB,CAAC,EAAE,OAAO,CAAA;CAAO,GACjF,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC,CAkF7B;AAED;;GAEG;AACH,wBAAgB,WAAW,IAAI,MAAM,GAAG,SAAS,CAKhD;AAED;;GAEG;AACH,wBAAgB,aAAa,IAAI,MAAM,GAAG,SAAS,CAKlD;AAED;;GAEG;AACH,wBAAgB,UAAU,IAAI,IAAI,CAIjC;AAED;;;GAGG;AACH,wBAAsB,cAAc,CAClC,MAAM,EAAE,cAAc,EACtB,SAAS,EAAE,eAAe,EAC1B,IAAI,EAAE,MAAM,GAAG,QAAQ,EACvB,OAAO,GAAE;IAAE,MAAM,CAAC,EAAE,OAAO,CAAC;IAAC,QAAQ,CAAC,EAAE,OAAO,CAAA;CAAO,GACrD,OAAO,CAAC,MAAM,GAAG,MAAM,GAAG,SAAS,CAAC,CAStC"}

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":"AAEA,OAAO,KAAK,MAAM,OAAO,CAAC;AAa1B,oDAAoD;AACpD,MAAM,YAAY,GAId,EAAE,CAAC;AAEP,MAAM,SAAS,GAAG,CAAC,GAAG,EAAE,GAAG,IAAI,CAAC,CAAC,YAAY;AAE7C;;GAEG;AACH,SAAS,YAAY,CAAC,MAAuB;IAC3C,IAAI,CAAC,MAAM;QAAE,OAAO,KAAK,CAAC;IAC1B,OAAO,IAAI,CAAC,GAAG,EAAE,GAAG,MAAM,CAAC,SAAS,GAAG,SAAS,CAAC;AACnD,CAAC;AAED;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,cAAc,CAClC,MAAsB,EACtB,SAA0B,EAC1B,cAAgC,EAChC,UAAoD,EAAE;IAEtD,qCAAqC;IACrC,IAAI,cAAc,KAAK,SAAS,EAAE,CAAC;QACjC,MAAM,MAAM,GAAG,OAAO,cAAc,KAAK,QAAQ,CAAC,CAAC,CAAC,QAAQ,CAAC,cAAc,CAAC,CAAC,CAAC,CAAC,cAAc,CAAC;QAE9F,0BAA0B;QAC1B,YAAY,CAAC,QAAQ,GAAG;YACtB,EAAE,EAAE,MAAM;YACV,SAAS,EAAE,IAAI,CAAC,GAAG,EAAE;SACtB,CAAC;QAEF,OAAO,MAAM,CAAC;IAChB,CAAC;IAED,yBAAyB;IACzB,IAAI,OAAO,CAAC,QAAQ,IAAI,YAAY,CAAC,YAAY,CAAC,QAAQ,CAAC,EAAE,CAAC;QAC5D,IAAI,CAAC,OAAO,CAAC,MAAM,EAAE,CAAC;YACpB,SAAS,CAAC,IAAI,CAAC,sBAAsB,YAAY,CAAC,QAAS,CAAC,EAAE,GAAG,YAAY,CAAC,QAAS,CAAC,IAAI,CAAC,CAAC,CAAC,KAAK,YAAY,CAAC,QAAS,CAAC,IAAI,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;QAC7I,CAAC;QACD,OAAO,YAAY,CAAC,QAAS,CAAC,EAAY,CAAC;IAC7C,CAAC;IAED,IAAI,CAAC;QACH,kBAAkB;QAClB,MAAM,QAAQ,GAAG,MAAM,MAAM,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,EAAE,QAAQ,EAAE,GAAG,EAAE,CAAC,CAAC;QAChE,MAAM,KAAK,GAAG,QAAQ,CAAC,IAAI,IAAI,EAAE,CAAC;QAElC,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YACvB,IAAI,CAAC,OAAO,CAAC,MAAM,EAAE,CAAC;gBACpB,SAAS,CAAC,KAAK,CAAC,8EAA8E,CAAC,CAAC;YAClG,CAAC;YACD,OAAO,SAAS,CAAC;QACnB,CAAC;QAED,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YACvB,MAAM,IAAI,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC;YACtB,MAAM,MAAM,GAAG,IAAI,CAAC,EAAE,CAAC;YAEvB,WAAW;YACX,YAAY,CAAC,QAAQ,GAAG;gBACtB,EAAE,EAAE,MAAM;gBACV,IAAI,EAAE,IAAI,CAAC,IAAI;gBACf,SAAS,EAAE,IAAI,CAAC,GAAG,EAAE;aACtB,CAAC;YAEF,IAAI,CAAC,OAAO,CAAC,MAAM,EAAE,CAAC;gBACpB,SAAS,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,uBAAuB,MAAM,KAAK,IAAI,CAAC,IAAI,GAAG,CAAC,CAAC,CAAC;YAC7E,CAAC;YAED,OAAO,MAAM,CAAC;QAChB,CAAC;QAED,uBAAuB;QACvB,IAAI,CAAC,OAAO,CAAC,MAAM,EAAE,CAAC;YACpB,SAAS,CAAC,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,qDAAqD,CAAC,CAAC,CAAC;YACpF,SAAS,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,kBAAkB,CAAC,CAAC,CAAC;YAC/C,KAAK,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,IAAS,EAAE,EAAE;gBACtC,SAAS,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,KAAK,IAAI,CAAC,EAAE,KAAK,IAAI,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC;YAC3D,CAAC,CAAC,CAAC;YACH,IAAI,KAAK,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;gBACrB,SAAS,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,aAAa,KAAK,CAAC,MAAM,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC;YACnE,CAAC;QACH,CAAC;QAED,OAAO,SAAS,CAAC;IACnB,CAAC;IAAC,OAAO,KAAU,EAAE,CAAC;QACpB,IAAI,CAAC,OAAO,CAAC,MAAM,EAAE,CAAC;YACpB,SAAS,CAAC,KAAK,CAAC,+BAA+B,KAAK,CAAC,OAAO,EAAE,CAAC,CAAC;QAClE,CAAC;QACD,OAAO,SAAS,CAAC;IACnB,CAAC;AACH,CAAC;AAED;;GAEG;AACH,MAAM,CAAC,KAAK,UAAU,gBAAgB,CACpC,MAAsB,EACtB,SAA0B,EAC1B,gBAAkC,EAClC,UAAgF,EAAE;IAElF,uCAAuC;IACvC,IAAI,gBAAgB,KAAK,SAAS,EAAE,CAAC;QACnC,MAAM,QAAQ,GAAG,MAAM,CAAC,gBAAgB,CAAC,CAAC;QAE1C,0BAA0B;QAC1B,YAAY,CAAC,UAAU,GAAG;YACxB,EAAE,EAAE,QAAQ;YACZ,SAAS,EAAE,IAAI,CAAC,GAAG,EAAE;SACtB,CAAC;QAEF,OAAO,QAAQ,CAAC;IAClB,CAAC;IAED,yBAAyB;IACzB,IAAI,OAAO,CAAC,QAAQ,IAAI,YAAY,CAAC,YAAY,CAAC,UAAU,CAAC,EAAE,CAAC;QAC9D,IAAI,CAAC,OAAO,CAAC,MAAM,EAAE,CAAC;YACpB,SAAS,CAAC,IAAI,CAAC,wBAAwB,YAAY,CAAC,UAAW,CAAC,EAAE,GAAG,YAAY,CAAC,UAAW,CAAC,IAAI,CAAC,CAAC,CAAC,KAAK,YAAY,CAAC,UAAW,CAAC,IAAI,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;QACrJ,CAAC;QACD,OAAO,YAAY,CAAC,UAAW,CAAC,EAAY,CAAC;IAC/C,CAAC;IAED,IAAI,CAAC;QACH,oBAAoB;QACpB,MAAM,QAAQ,GAAG,MAAM,MAAM,CAAC,GAAG,CAAC,aAAa,CAAC,WAAW,CAAC,EAAE,OAAO,EAAE,GAAG,EAAE,CAAC,CAAC;QAC9E,MAAM,UAAU,GAAG,QAAQ,CAAC,IAAI,IAAI,EAAE,CAAC;QAEvC,0CAA0C;QAC1C,MAAM,OAAO,GAAG,OAAO,CAAC,gBAAgB;YACtC,CAAC,CAAC,UAAU,CAAC,MAAM,CAAC,CAAC,CAAM,EAAE,EAAE,CAAC,CAAC,CAAC,SAAS,KAAK,IAAI,CAAC;YACrD,CAAC,CAAC,UAAU,CAAC;QAEf,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YACzB,IAAI,CAAC,OAAO,CAAC,MAAM,EAAE,CAAC;gBACpB,IAAI,OAAO,CAAC,gBAAgB,IAAI,UAAU,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;oBACtD,SAAS,CAAC,KAAK,CAAC,4DAA4D,CAAC,CAAC;gBAChF,CAAC;qBAAM,CAAC;oBACN,SAAS,CAAC,KAAK,CAAC,uGAAuG,CAAC,CAAC;gBAC3H,CAAC;YACH,CAAC;YACD,OAAO,SAAS,CAAC;QACnB,CAAC;QAED,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YACzB,MAAM,MAAM,GAAG,OAAO,CAAC,CAAC,CAAC,CAAC;YAC1B,MAAM,QAAQ,GAAG,MAAM,CAAC,EAAE,CAAC;YAE3B,WAAW;YACX,YAAY,CAAC,UAAU,GAAG;gBACxB,EAAE,EAAE,QAAQ;gBACZ,IAAI,EAAE,MAAM,CAAC,IAAI;gBACjB,SAAS,EAAE,IAAI,CAAC,GAAG,EAAE;aACtB,CAAC;YAEF,IAAI,CAAC,OAAO,CAAC,MAAM,EAAE,CAAC;gBACpB,SAAS,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,yBAAyB,QAAQ,KAAK,MAAM,CAAC,IAAI,KAAK,MAAM,CAAC,KAAK,IAAI,CAAC,CAAC,CAAC;YACrG,CAAC;YAED,OAAO,QAAQ,CAAC;QAClB,CAAC;QAED,yBAAyB;QACzB,IAAI,CAAC,OAAO,CAAC,MAAM,EAAE,CAAC;YACpB,MAAM,UAAU,GAAG,OAAO,CAAC,gBAAgB,CAAC,CAAC,CAAC,mBAAmB,CAAC,CAAC,CAAC,SAAS,CAAC;YAC9E,SAAS,CAAC,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,YAAY,UAAU,yCAAyC,CAAC,CAAC,CAAC;YAC9F,SAAS,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,oBAAoB,CAAC,CAAC,CAAC;YACjD,OAAO,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,MAAW,EAAE,EAAE;gBAC1C,MAAM,SAAS,GAAG,MAAM,CAAC,SAAS,CAAC,CAAC,CAAC,KAAK,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;gBACxE,SAAS,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,KAAK,MAAM,CAAC,EAAE,KAAK,MAAM,CAAC,IAAI,KAAK,MAAM,CAAC,KAAK,KAAK,SAAS,EAAE,CAAC,CAAC,CAAC;YAC9F,CAAC,CAAC,CAAC;YACH,IAAI,OAAO,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;gBACvB,SAAS,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,aAAa,OAAO,CAAC,MAAM,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC;YACrE,CAAC;QACH,CAAC;QAED,OAAO,SAAS,CAAC;IACnB,CAAC;IAAC,OAAO,KAAU,EAAE,CAAC;QACpB,IAAI,CAAC,OAAO,CAAC,MAAM,EAAE,CAAC;YACpB,SAAS,CAAC,KAAK,CAAC,iCAAiC,KAAK,CAAC,OAAO,EAAE,CAAC,CAAC;QACpE,CAAC;QACD,OAAO,SAAS,CAAC;IACnB,CAAC;AACH,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,WAAW;IACzB,IAAI,YAAY,CAAC,YAAY,CAAC,QAAQ,CAAC,EAAE,CAAC;QACxC,OAAO,YAAY,CAAC,QAAS,CAAC,EAAY,CAAC;IAC7C,CAAC;IACD,OAAO,SAAS,CAAC;AACnB,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,aAAa;IAC3B,IAAI,YAAY,CAAC,YAAY,CAAC,UAAU,CAAC,EAAE,CAAC;QAC1C,OAAO,YAAY,CAAC,UAAW,CAAC,EAAY,CAAC;IAC/C,CAAC;IACD,OAAO,SAAS,CAAC;AACnB,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,UAAU;IACxB,YAAY,CAAC,QAAQ,GAAG,SAAS,CAAC;IAClC,YAAY,CAAC,YAAY,GAAG,SAAS,CAAC;IACtC,YAAY,CAAC,UAAU,GAAG,SAAS,CAAC;AACtC,CAAC;AAED;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,cAAc,CAClC,MAAsB,EACtB,SAA0B,EAC1B,IAAuB,EACvB,UAAoD,EAAE;IAEtD,QAAQ,IAAI,EAAE,CAAC;QACb,KAAK,MAAM;YACT,OAAO,cAAc,CAAC,MAAM,EAAE,SAAS,EAAE,SAAS,EAAE,OAAO,CAAC,CAAC;QAC/D,KAAK,QAAQ;YACX,OAAO,gBAAgB,CAAC,MAAM,EAAE,SAAS,EAAE,SAAS,EAAE,OAAO,CAAC,CAAC;QACjE;YACE,OAAO,SAAS,CAAC;IACrB,CAAC;AACH,CAAC"}

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"}