sendcraft-cli 1.0.0 → 1.1.0

package/lib/commands/mcp.js

@@ -0,0 +1,77 @@
+const { Command } = require('commander');
+const chalk = require('chalk');
+const _grad2 = require('gradient-string'); const gradient = _grad2.default || _grad2;
+const _boxen = require('boxen'); const boxen = _boxen.default || _boxen;
+const { success, info } = require('../output');
+
+const cmd = new Command('mcp').description('MCP (Model Context Protocol) server setup for AI agents');
+
+cmd
+  .command('info')
+  .description('Show how to configure the SendCraft MCP server in Claude / Cursor / etc.')
+  .action(() => {
+    console.log('\n' + gradient(['#6366f1', '#8b5cf6', '#ec4899'])('  ✦ SendCraft MCP Server') + '\n');
+
+    const apiKey = process.env.SENDCRAFT_API_KEY || '<your-api-key>';
+
+    const claudeConfig = JSON.stringify({
+      mcpServers: {
+        sendcraft: {
+          command: 'npx',
+          args: ['sendcraft-mcp'],
+          env: {
+            SENDCRAFT_API_KEY: apiKey,
+          },
+        },
+      },
+    }, null, 2);
+
+    console.log(chalk.bold('  1. Install the MCP server:'));
+    console.log(`     ${chalk.cyan('npm install -g sendcraft-mcp')}\n`);
+
+    console.log(chalk.bold('  2. Add to Claude Desktop config') + chalk.dim(' (~/Library/Application Support/Claude/claude_desktop_config.json):'));
+    console.log(boxen(claudeConfig, {
+      padding: 1,
+      margin: { left: 4 },
+      borderStyle: 'round',
+      borderColor: 'cyan',
+    }));
+
+    console.log(chalk.bold('  3. Available MCP tools:'));
+    const tools = [
+      ['sendcraft_send_email',      'Send a transactional email'],
+      ['sendcraft_batch_send',      'Send up to 100 emails at once'],
+      ['sendcraft_list_emails',     'List sent emails'],
+      ['sendcraft_get_stats',       'Get email statistics'],
+      ['sendcraft_list_campaigns',  'List campaigns'],
+      ['sendcraft_list_subscribers','List subscribers'],
+      ['sendcraft_add_subscriber',  'Add a new subscriber'],
+      ['sendcraft_list_domains',    'List verified sender domains'],
+      ['sendcraft_list_api_keys',   'List API keys'],
+    ];
+    tools.forEach(([name, desc]) => {
+      console.log(`     ${chalk.green('•')} ${chalk.cyan(name)} ${chalk.dim('— ' + desc)}`);
+    });
+    console.log();
+    info(`Docs: ${chalk.underline('https://sendcraft.online/docs/mcp')}`);
+  });
+
+cmd
+  .command('install')
+  .description('Install the sendcraft-mcp package globally')
+  .action(() => {
+    const { execSync } = require('child_process');
+    const ora = require('ora');
+    const sp = ora({ text: 'Installing sendcraft-mcp…', spinner: 'dots', color: 'cyan' }).start();
+    try {
+      execSync('npm install -g sendcraft-mcp', { stdio: 'pipe' });
+      sp.succeed(chalk.dim('Installed'));
+      success('sendcraft-mcp installed! Run ' + chalk.cyan('sendcraft mcp info') + ' for config instructions.');
+    } catch (e) {
+      sp.fail(chalk.red('Install failed'));
+      console.error(e.stderr?.toString() || e.message);
+      process.exit(1);
+    }
+  });
+
+module.exports = cmd;

package/lib/commands/send.js

@@ -1,7 +1,7 @@
 const { Command } = require('commander');
-const ora = require('ora');
+const chalk = require('chalk');
 const client = require('../client');
-const { success, error, json } = require('../output');
+const { success, error, spinner } = require('../output');
 
 const cmd = new Command('send')
   .description('Send a single transactional email')
@@ -17,7 +17,8 @@ const cmd = new Command('send')
       error('Provide at least --html or --text');
       process.exit(1);
     }
-    const spinner = ora('Sending…').start();
+
+    const sp = spinner(`Sending to ${chalk.cyan(opts.to)}…`).start();
     try {
       const result = await client.post('/emails/send', {
         toEmail: opts.to,
@@ -27,11 +28,11 @@ const cmd = new Command('send')
         fromEmail: opts.from,
         replyTo: opts.replyTo,
       });
-      spinner.stop();
-      if (opts.json) return json(result);
-      success(`Email sent! ID: ${result.emailId || result._id || '—'}`);
+      sp.succeed(chalk.dim('Request complete'));
+      if (opts.json) return require('../output').json(result);
+      success(`Email sent!  ${chalk.dim('ID: ' + (result.emailId || result._id || '—'))}`);
     } catch (err) {
-      spinner.stop();
+      sp.fail(chalk.red('Send failed'));
       error(err.message);
       process.exit(1);
     }

package/lib/commands/subscribers.js

@@ -1,7 +1,7 @@
 const { Command } = require('commander');
-const ora = require('ora');
+const chalk = require('chalk');
 const client = require('../client');
-const { table, json, colorStatus, info, success, error } = require('../output');
+const { table, json, colorStatus, info, success, error, spinner } = require('../output');
 
 const cmd = new Command('subscribers').description('Manage subscribers');
 
@@ -13,28 +13,28 @@ cmd
   .option('--status <s>', 'Filter: active, pending, unsubscribed')
   .option('--json', 'Output raw JSON')
   .action(async (opts) => {
-    const spinner = ora('Fetching…').start();
+    const sp = spinner('Fetching subscribers…').start();
     try {
       const params = new URLSearchParams({ page: opts.page, limit: opts.limit });
       if (opts.status) params.set('status', opts.status);
       const data = await client.get(`/subscribers?${params}`);
-      spinner.stop();
+      sp.succeed(chalk.dim('Loaded'));
       if (opts.json) return json(data);
       const subs = data.subscribers || [];
       if (!subs.length) return info('No subscribers found.');
       table(
         ['Email', 'Name', 'Status', 'Tags', 'Joined'],
         subs.map(s => [
-          s.email,
-          [s.firstName, s.lastName].filter(Boolean).join(' ') || '—',
+          chalk.cyan(s.email),
+          [s.firstName, s.lastName].filter(Boolean).join(' ') || chalk.dim('—'),
           colorStatus(s.status),
-          (s.tags || []).join(', ') || '—',
-          s.createdAt ? new Date(s.createdAt).toLocaleDateString() : '—',
+          (s.tags || []).length ? s.tags.map(t => chalk.magenta(t)).join(', ') : chalk.dim('—'),
+          s.createdAt ? chalk.dim(new Date(s.createdAt).toLocaleDateString()) : '—',
         ])
       );
-      info(`Page ${opts.page} · ${subs.length} of ${data.total || '?'}`);
+      info(`Page ${opts.page} · ${subs.length} of ${chalk.bold(data.total ?? '?')}`);
     } catch (err) {
-      spinner.stop();
+      sp.fail(chalk.red('Failed'));
       error(err.message);
       process.exit(1);
     }
@@ -42,15 +42,14 @@ cmd
 
 cmd
   .command('add <email>')
-  .description('Add a subscriber')
-  .option('--list <listId>', 'Email list ID')
+  .description('Add a subscriber to a list')
+  .requiredOption('--list <listId>', 'Email list ID')
   .option('--first-name <name>', 'First name')
   .option('--last-name <name>', 'Last name')
   .option('--tags <tags>', 'Comma-separated tags')
   .option('--json', 'Output raw JSON')
   .action(async (email, opts) => {
-    if (!opts.list) { error('--list <listId> is required'); process.exit(1); }
-    const spinner = ora('Adding…').start();
+    const sp = spinner(`Adding ${chalk.cyan(email)}…`).start();
     try {
       const data = await client.post('/subscribers/add', {
         email,
@@ -59,11 +58,11 @@ cmd
         lastName: opts.lastName,
         tags: opts.tags ? opts.tags.split(',').map(t => t.trim()) : undefined,
       });
-      spinner.stop();
+      sp.succeed(chalk.dim('Done'));
       if (opts.json) return json(data);
-      success(`Subscriber ${email} added.`);
+      success(`${chalk.cyan(email)} added to list.`);
     } catch (err) {
-      spinner.stop();
+      sp.fail(chalk.red('Failed'));
       error(err.message);
       process.exit(1);
     }
@@ -74,14 +73,14 @@ cmd
   .description('Remove a subscriber by ID')
   .option('--json', 'Output raw JSON')
   .action(async (id, opts) => {
-    const spinner = ora('Removing…').start();
+    const sp = spinner(`Removing ${chalk.dim(id.slice(-8))}…`).start();
     try {
       const data = await client.delete(`/subscribers/${id}`);
-      spinner.stop();
+      sp.succeed(chalk.dim('Done'));
       if (opts.json) return json(data);
-      success(`Subscriber ${id} removed.`);
+      success(`Subscriber removed.`);
     } catch (err) {
-      spinner.stop();
+      sp.fail(chalk.red('Failed'));
       error(err.message);
       process.exit(1);
     }

package/lib/commands/warmup.js

@@ -1,52 +1,73 @@
 const { Command } = require('commander');
-const ora = require('ora');
 const chalk = require('chalk');
+const _grad = require('gradient-string'); const gradient = _grad.default || _grad;
 const client = require('../client');
-const { table, json, error } = require('../output');
+const { table, json, error, spinner } = require('../output');
 
 const cmd = new Command('warmup').description('View SMTP IP warmup status');
 
 cmd
   .option('--json', 'Output raw JSON')
   .action(async (opts) => {
-    const spinner = ora('Loading warmup status…').start();
+    const sp = spinner('Checking warmup status…').start();
     try {
       const data = await client.get('/smtp/warmup');
-      spinner.stop();
+      sp.succeed(chalk.dim('Done'));
+
       if (opts.json) return json(data);
 
-      const bar = buildBar(data.todayCount, data.dailyLimit);
+      console.log();
 
       if (data.isWarmedUp) {
-        console.log(chalk.green.bold('✓ IP is fully warmed up — no daily limits'));
+        const g = gradient(['#10b981', '#3b82f6']);
+        console.log(g.multiline(
+          '  ██╗    ██╗ █████╗ ██████╗ ███╗   ███╗███████╗██████╗ \n' +
+          '  ██║    ██║██╔══██╗██╔══██╗████╗ ████║██╔════╝██╔══██╗\n' +
+          '  ██║ █╗ ██║███████║██████╔╝██╔████╔██║█████╗  ██║  ██║\n' +
+          '  ██║███╗██║██╔══██║██╔══██╗██║╚██╔╝██║██╔══╝  ██║  ██║\n' +
+          '  ╚███╔███╔╝██║  ██║██║  ██║██║ ╚═╝ ██║███████╗██████╔╝\n' +
+          '   ╚══╝╚══╝ ╚═╝  ╚═╝╚═╝  ╚═╝╚═╝     ╚═╝╚══════╝╚═════╝ '
+        ));
+        console.log('  ' + chalk.green.bold('✓ IP fully warmed up — no daily limits!\n'));
       } else {
-        console.log(chalk.yellow.bold(`Warmup Day ${data.warmupDay}`));
-        console.log(`Progress: ${bar} ${data.todayCount}/${data.dailyLimit}`);
+        const pct = data.percentComplete || 0;
+        const bar = buildAnimatedBar(data.todayCount, data.dailyLimit, 30);
+        console.log(`  ${chalk.bold.magenta('Warmup Day ' + data.warmupDay)}`);
+        console.log(`  ${bar}  ${chalk.cyan(data.todayCount)}${chalk.dim('/' + data.dailyLimit)} sent today`);
+        console.log(`  ${chalk.dim(pct + '% of warmup complete')}\n`);
       }
 
       table(
         ['Field', 'Value'],
         [
-          ['Warmup Day', data.warmupDay],
-          ['Daily Limit', data.isWarmedUp ? 'Unlimited' : data.dailyLimit],
-          ['Sent Today', data.todayCount],
-          ['Remaining Today', data.isWarmedUp ? '∞' : data.remainingToday],
-          ['Warmed Up', data.isWarmedUp ? chalk.green('Yes') : chalk.yellow('No')],
-          ['% Complete', data.percentComplete != null ? `${data.percentComplete}%` : '—'],
+          ['Warmup Day',      chalk.bold(data.warmupDay)],
+          ['Daily Limit',     data.isWarmedUp ? chalk.green('∞ Unlimited') : chalk.yellow(String(data.dailyLimit))],
+          ['Sent Today',      chalk.cyan(String(data.todayCount))],
+          ['Remaining Today', data.isWarmedUp ? '∞' : chalk.green(String(data.remainingToday))],
+          ['Fully Warmed Up', data.isWarmedUp ? chalk.green('Yes ✓') : chalk.yellow('No')],
+          ['Progress',        (data.percentComplete ?? 0) + '%'],
         ]
       );
     } catch (err) {
-      spinner.stop();
+      sp.fail(chalk.red('Failed to fetch warmup status'));
       error(err.message);
       process.exit(1);
     }
   });
 
-function buildBar(count, limit) {
+function buildAnimatedBar(count, limit, width) {
   if (!limit) return '';
-  const width = 20;
-  const filled = Math.round((count / limit) * width);
-  return '[' + chalk.green('█'.repeat(filled)) + '░'.repeat(width - filled) + ']';
+  const ratio = Math.min(count / limit, 1);
+  const filled = Math.round(ratio * width);
+  const empty  = width - filled;
+
+  // Gradient bar: green→yellow→red based on fill level
+  let barColor;
+  if (ratio < 0.5)       barColor = chalk.green;
+  else if (ratio < 0.85) barColor = chalk.yellow;
+  else                   barColor = chalk.red;
+
+  return chalk.dim('[') + barColor('█'.repeat(filled)) + chalk.dim('░'.repeat(empty)) + chalk.dim(']');
 }
 
 module.exports = cmd;