sendcraft-cli 1.0.0 → 1.2.0

package/lib/client.js

@@ -7,11 +7,94 @@ const http = require('http');
 const { URL } = require('url');
 const { getApiKey, getBaseUrl } = require('./config');
 
+/** Make a request with an explicit bearer token instead of stored API key */
+function requestWithToken(method, path, body, token) {
+  return new Promise((resolve, reject) => {
+    const fullUrl = new URL(getBaseUrl() + path);
+    const isHttps = fullUrl.protocol === 'https:';
+    const mod = isHttps ? require('https') : require('http');
+    const payload = body ? JSON.stringify(body) : null;
+    const options = {
+      hostname: fullUrl.hostname,
+      port: fullUrl.port || (isHttps ? 443 : 80),
+      path: fullUrl.pathname + fullUrl.search,
+      method,
+      headers: {
+        'Authorization': `Bearer ${token}`,
+        'Content-Type': 'application/json',
+        ...(payload ? { 'Content-Length': Buffer.byteLength(payload) } : {}),
+      },
+    };
+    const req = mod.request(options, (res) => {
+      let data = '';
+      res.on('data', (chunk) => (data += chunk));
+      res.on('end', () => {
+        try {
+          const json = JSON.parse(data);
+          if (res.statusCode >= 400) {
+            const err = new Error(json.error || json.message || `HTTP ${res.statusCode}`);
+            err.status = res.statusCode;
+            err.body = json;
+            return reject(err);
+          }
+          resolve(json);
+        } catch {
+          reject(new Error(`Invalid JSON response (status ${res.statusCode})`));
+        }
+      });
+    });
+    req.on('error', reject);
+    if (payload) req.write(payload);
+    req.end();
+  });
+}
+
+/** Make a request with no auth header (for public endpoints like /auth/login) */
+function requestNoAuth(method, path, body = null) {
+  return new Promise((resolve, reject) => {
+    const fullUrl = new URL(getBaseUrl() + path);
+    const isHttps = fullUrl.protocol === 'https:';
+    const mod = isHttps ? require('https') : require('http');
+    const payload = body ? JSON.stringify(body) : null;
+    const options = {
+      hostname: fullUrl.hostname,
+      port: fullUrl.port || (isHttps ? 443 : 80),
+      path: fullUrl.pathname + fullUrl.search,
+      method,
+      headers: {
+        'Content-Type': 'application/json',
+        ...(payload ? { 'Content-Length': Buffer.byteLength(payload) } : {}),
+      },
+    };
+    const req = mod.request(options, (res) => {
+      let data = '';
+      res.on('data', (chunk) => (data += chunk));
+      res.on('end', () => {
+        try {
+          const json = JSON.parse(data);
+          if (res.statusCode >= 400) {
+            const err = new Error(json.error || json.message || `HTTP ${res.statusCode}`);
+            err.status = res.statusCode;
+            err.body = json;
+            return reject(err);
+          }
+          resolve(json);
+        } catch {
+          reject(new Error(`Invalid JSON response (status ${res.statusCode})`));
+        }
+      });
+    });
+    req.on('error', reject);
+    if (payload) req.write(payload);
+    req.end();
+  });
+}
+
 function request(method, path, body = null) {
   return new Promise((resolve, reject) => {
     const apiKey = getApiKey();
     if (!apiKey) {
-      return reject(new Error('No API key configured. Run: sendcraft config set-key <key>'));
+      return reject(new Error('No API key configured. Run: sendcraft login'));
     }
 
     const fullUrl = new URL(getBaseUrl() + path);
@@ -60,4 +143,7 @@ module.exports = {
   get: (path) => request('GET', path),
   post: (path, body) => request('POST', path, body),
   delete: (path) => request('DELETE', path),
+  postNoAuth: (path, body) => requestNoAuth('POST', path, body),
+  postWithToken: (path, body, token) => requestWithToken('POST', path, body, token),
+  getWithToken: (path, token) => requestWithToken('GET', path, null, token),
 };

package/lib/commands/campaigns.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('campaigns').description('Manage campaigns');
 
@@ -10,26 +10,26 @@ cmd
   .description('List campaigns')
   .option('--json', 'Output raw JSON')
   .action(async (opts) => {
-    const spinner = ora('Fetching…').start();
+    const sp = spinner('Fetching campaigns…').start();
     try {
       const data = await client.get('/campaigns');
-      spinner.stop();
+      sp.succeed(chalk.dim('Loaded'));
       if (opts.json) return json(data);
       const campaigns = data.campaigns || [];
-      if (!campaigns.length) return info('No campaigns found.');
+      if (!campaigns.length) return info('No campaigns yet. Create one in the dashboard.');
       table(
         ['ID', 'Name', 'Subject', 'Status', 'Recipients', 'Created'],
         campaigns.map(c => [
-          String(c._id).slice(-8),
-          (c.name || '').slice(0, 25),
+          chalk.dim(String(c._id).slice(-8)),
+          chalk.bold((c.name || '').slice(0, 25)),
           (c.subject || '').slice(0, 30),
           colorStatus(c.status),
-          c.recipientCount ?? '—',
-          c.createdAt ? new Date(c.createdAt).toLocaleString() : '—',
+          c.recipientCount != null ? chalk.cyan(String(c.recipientCount)) : '—',
+          c.createdAt ? chalk.dim(new Date(c.createdAt).toLocaleString()) : '—',
         ])
       );
     } catch (err) {
-      spinner.stop();
+      sp.fail(chalk.red('Failed'));
       error(err.message);
       process.exit(1);
     }
@@ -38,18 +38,19 @@ cmd
 cmd
   .command('send <campaignId>')
   .description('Send or schedule a campaign')
-  .option('--schedule <isoDate>', 'Schedule for a specific time (ISO 8601)')
+  .option('--schedule <isoDate>', 'Schedule for a specific ISO 8601 datetime')
   .option('--json', 'Output raw JSON')
   .action(async (campaignId, opts) => {
-    const spinner = ora('Sending…').start();
+    const label = opts.schedule ? `Scheduling campaign…` : `Sending campaign…`;
+    const sp = spinner(label).start();
     try {
       const body = opts.schedule ? { scheduledAt: opts.schedule } : {};
       const data = await client.post(`/campaigns/${campaignId}/send`, body);
-      spinner.stop();
+      sp.succeed(chalk.dim('Done'));
       if (opts.json) return json(data);
-      success(`Campaign ${campaignId} ${opts.schedule ? 'scheduled' : 'sent'}!`);
+      success(`Campaign ${opts.schedule ? 'scheduled for ' + chalk.cyan(opts.schedule) : 'sent!'}`);
     } catch (err) {
-      spinner.stop();
+      sp.fail(chalk.red('Failed'));
       error(err.message);
       process.exit(1);
     }

package/lib/commands/config.js

@@ -1,8 +1,10 @@
 const { Command } = require('commander');
 const prompts = require('prompts');
 const chalk = require('chalk');
+const ora = require('ora');
 const { load, save, getApiKey, getBaseUrl, CONFIG_FILE } = require('../config');
-const { success, info, error } = require('../output');
+const { success, error, info } = require('../output');
+const { sendcraftGradient } = require('../banner');
 
 const cmd = new Command('config')
   .description('Configure your SendCraft credentials');
@@ -11,20 +13,22 @@ cmd
   .command('set-key <apiKey>')
   .description('Save your API key')
   .action((apiKey) => {
+    const sp = ora({ text: 'Saving…', spinner: 'dots', color: 'cyan' }).start();
     const cfg = load();
     cfg.api_key = apiKey;
     save(cfg);
-    success(`API key saved to ${CONFIG_FILE}`);
+    sp.succeed(chalk.dim('Saved'));
+    success(`API key stored at ${chalk.dim(CONFIG_FILE)}`);
   });
 
 cmd
   .command('set-url <url>')
-  .description('Override the API base URL (default: https://api.sendcraft.online/api)')
+  .description('Override the API base URL')
   .action((url) => {
     const cfg = load();
     cfg.base_url = url;
     save(cfg);
-    success(`Base URL saved: ${url}`);
+    success(`Base URL updated: ${chalk.cyan(url)}`);
   });
 
 cmd
@@ -34,26 +38,28 @@ cmd
     const key = getApiKey();
     const url = getBaseUrl();
     if (!key) {
-      error('No API key set. Run: sendcraft config set-key <key>');
-      info('Or set SENDCRAFT_API_KEY env variable.');
+      error('No API key set. Run: ' + chalk.cyan('sendcraft config set-key <key>'));
+      info('Or set the ' + chalk.bold('SENDCRAFT_API_KEY') + ' environment variable.');
       return;
     }
     const masked = key.length > 12 ? key.slice(0, 8) + '…' + key.slice(-4) : '***';
-    console.log(chalk.bold('API Key:  ') + masked);
-    console.log(chalk.bold('Base URL: ') + url);
-    console.log(chalk.bold('Config:   ') + CONFIG_FILE);
+    console.log('\n' + chalk.bold('  API Key:  ') + chalk.green(masked));
+    console.log(chalk.bold('  Base URL: ') + chalk.cyan(url));
+    console.log(chalk.bold('  Config:   ') + chalk.dim(CONFIG_FILE) + '\n');
   });
 
 cmd
   .command('init')
-  .description('Interactive setup')
+  .description('Interactive first-time setup')
   .action(async () => {
+    console.log('\n' + sendcraftGradient('  ✦ SendCraft Setup\n'));
+
     const answers = await prompts([
       {
         type: 'password',
         name: 'api_key',
-        message: 'Paste your SendCraft API key:',
-        validate: v => v.startsWith('sc_') ? true : 'Key should start with sc_',
+        message: 'Paste your API key',
+        validate: v => (v && v.length > 10) ? true : 'Enter a valid API key',
       },
       {
         type: 'text',
@@ -61,10 +67,12 @@ cmd
         message: 'API base URL',
         initial: 'https://api.sendcraft.online/api',
       },
-    ]);
-    if (!answers.api_key) return error('Cancelled.');
+    ], { onCancel: () => { error('Cancelled.'); process.exit(0); } });
+
+    const sp = ora({ text: 'Saving config…', spinner: 'dots2', color: 'cyan' }).start();
     save(answers);
-    success('Config saved!');
+    sp.succeed(chalk.dim('Config saved'));
+    success(`Ready! Run ${chalk.cyan('sendcraft send --help')} to get started.`);
   });
 
 module.exports = cmd;

package/lib/commands/domains.js

@@ -1,8 +1,8 @@
 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, colorStatus, info, success, error } = require('../output');
+const { table, json, colorStatus, info, success, error, spinner } = require('../output');
 
 const cmd = new Command('domains').description('Manage sender domains');
 
@@ -11,26 +11,26 @@ cmd
   .description('List all domains')
   .option('--json', 'Output raw JSON')
   .action(async (opts) => {
-    const spinner = ora('Fetching…').start();
+    const sp = spinner('Fetching domains…').start();
     try {
       const data = await client.get('/domains');
-      spinner.stop();
+      sp.succeed(chalk.dim('Loaded'));
       if (opts.json) return json(data);
       const domains = data.domains || [];
-      if (!domains.length) return info('No domains added yet.');
+      if (!domains.length) return info('No domains added yet. Run: ' + chalk.cyan('sendcraft domains add <domain>'));
       table(
         ['Domain', 'Status', 'SPF', 'DKIM', 'DMARC', 'Added'],
         domains.map(d => [
-          d.domain,
+          chalk.bold(d.domain),
           colorStatus(d.status),
-          d.spfVerified ? chalk.green('✓') : chalk.red('✗'),
+          d.spfVerified  ? chalk.green('✓') : chalk.red('✗'),
           d.dkimVerified ? chalk.green('✓') : chalk.red('✗'),
-          d.dmarcVerified ? chalk.green('✓') : chalk.red('✗'),
-          d.createdAt ? new Date(d.createdAt).toLocaleDateString() : '—',
+          d.dmarcVerified? chalk.green('✓') : chalk.red('✗'),
+          d.createdAt ? chalk.dim(new Date(d.createdAt).toLocaleDateString()) : '—',
         ])
       );
     } catch (err) {
-      spinner.stop();
+      sp.fail(chalk.red('Failed'));
       error(err.message);
       process.exit(1);
     }
@@ -41,22 +41,24 @@ cmd
   .description('Add a new sender domain')
   .option('--json', 'Output raw JSON')
   .action(async (domain, opts) => {
-    const spinner = ora('Adding domain…').start();
+    const sp = spinner(`Adding ${chalk.cyan(domain)}…`).start();
     try {
       const data = await client.post('/domains', { domain });
-      spinner.stop();
+      sp.succeed(chalk.dim('Domain added'));
       if (opts.json) return json(data);
-      success(`Domain ${domain} added.`);
-      info('Add these DNS records to your domain:');
+      success(`${chalk.bold(domain)} added.`);
+      console.log('\n' + gradient(['#6366f1', '#ec4899'])('  ─── DNS Records to Configure ───') + '\n');
       (data.dnsRecords || []).forEach(r => {
-        const optional = r.optional ? chalk.gray(' (optional)') : '';
-        console.log(`\n  ${chalk.bold(r.purpose)}${optional}`);
-        console.log(`  Type:  ${r.type}`);
-        console.log(`  Name:  ${r.name}`);
-        console.log(`  Value: ${r.value}`);
+        const verified = r.verified ? chalk.green(' ✓') : '';
+        const optional = r.optional ? chalk.dim(' (optional)') : '';
+        console.log(`  ${chalk.bold.cyan(r.purpose)}${optional}${verified}`);
+        console.log(`    ${chalk.dim('Type:')}  ${r.type}`);
+        console.log(`    ${chalk.dim('Name:')}  ${r.name}`);
+        console.log(`    ${chalk.dim('Value:')} ${chalk.white(r.value)}\n`);
       });
+      info(`Run ${chalk.cyan(`sendcraft domains verify <id>`)} after DNS propagates.`);
     } catch (err) {
-      spinner.stop();
+      sp.fail(chalk.red('Failed'));
       error(err.message);
       process.exit(1);
     }
@@ -67,27 +69,28 @@ cmd
   .description('Trigger a DNS verification check')
   .option('--json', 'Output raw JSON')
   .action(async (id, opts) => {
-    const spinner = ora('Checking DNS…').start();
+    const sp = spinner('Checking DNS records…').start();
     try {
       const data = await client.post(`/domains/${id}/verify`);
-      spinner.stop();
-      if (opts.json) return json(data);
       if (data.verified) {
-        success('All records verified! Domain is ready.');
+        sp.succeed(gradient(['#10b981', '#3b82f6'])('All records verified!'));
       } else {
-        const r = data.results || {};
-        table(
-          ['Record', 'Status'],
-          [
-            ['SPF', r.spf ? chalk.green('✓ Verified') : chalk.red('✗ Not found')],
-            ['DKIM', r.dkim ? chalk.green('✓ Verified') : chalk.red('✗ Not found')],
-            ['DMARC', r.dmarc ? chalk.green('✓ Verified') : chalk.red('✗ Not found')],
-          ]
-        );
-        info(data.message || 'Some records still pending.');
+        sp.warn(chalk.yellow('Some records still pending'));
       }
+      if (opts.json) return json(data);
+      const r = data.results || {};
+      table(
+        ['Record', 'Status'],
+        [
+          ['SPF',   r.spf   ? chalk.green('✓ Verified') : chalk.red('✗ Not found')],
+          ['DKIM',  r.dkim  ? chalk.green('✓ Verified') : chalk.red('✗ Not found')],
+          ['DMARC', r.dmarc ? chalk.green('✓ Verified') : chalk.red('✗ Not found')],
+        ]
+      );
+      if (data.verified) success('Domain is ready to send email!');
+      else info(data.message || 'DNS changes can take up to 48 hours to propagate.');
     } catch (err) {
-      spinner.stop();
+      sp.fail(chalk.red('Failed'));
       error(err.message);
       process.exit(1);
     }
@@ -95,24 +98,25 @@ cmd
 
 cmd
   .command('records <domainId>')
-  .description('Show DNS records to configure for a domain')
+  .description('Show DNS records to configure')
   .option('--json', 'Output raw JSON')
   .action(async (id, opts) => {
-    const spinner = ora('Loading…').start();
+    const sp = spinner('Loading DNS records…').start();
     try {
       const data = await client.get(`/domains/${id}`);
-      spinner.stop();
+      sp.succeed(chalk.dim('Loaded'));
       if (opts.json) return json(data.dnsRecords);
+      console.log('\n' + gradient(['#6366f1', '#ec4899'])('  ─── DNS Records ───') + '\n');
       (data.dnsRecords || []).forEach(r => {
-        const status = r.verified ? chalk.green('✓ verified') : chalk.yellow('⏳ pending');
-        const optional = r.optional ? chalk.gray(' (optional)') : '';
-        console.log(`\n  ${chalk.bold(r.purpose)} — ${status}${optional}`);
-        console.log(`  Type:  ${r.type}`);
-        console.log(`  Name:  ${r.name}`);
-        console.log(`  Value: ${r.value}`);
+        const status   = r.verified ? chalk.green('✓ verified') : chalk.yellow('⏳ pending');
+        const optional = r.optional ? chalk.dim(' (optional)') : '';
+        console.log(`  ${chalk.bold.cyan(r.purpose)}${optional}  ${status}`);
+        console.log(`    ${chalk.dim('Type:')}  ${r.type}`);
+        console.log(`    ${chalk.dim('Name:')}  ${r.name}`);
+        console.log(`    ${chalk.dim('Value:')} ${chalk.white(r.value)}\n`);
       });
     } catch (err) {
-      spinner.stop();
+      sp.fail(chalk.red('Failed'));
       error(err.message);
       process.exit(1);
     }

package/lib/commands/emails.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 } = require('../output');
+const { table, json, colorStatus, info, error, spinner } = require('../output');
 
 const cmd = new Command('emails').description('Manage emails');
 
@@ -13,29 +13,29 @@ cmd
   .option('--status <s>', 'Filter by status (sent, delivered, failed, scheduled)')
   .option('--json', 'Output raw JSON')
   .action(async (opts) => {
-    const spinner = ora('Fetching…').start();
+    const sp = spinner('Fetching emails…').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(`/emails?${params}`);
-      spinner.stop();
+      sp.succeed(chalk.dim('Loaded'));
       if (opts.json) return json(data);
       const emails = data.emails || [];
       if (!emails.length) return info('No emails found.');
       table(
         ['ID', 'To', 'Subject', 'Status', 'Sent At'],
         emails.map(e => [
-          String(e._id).slice(-8),
-          e.toEmail,
+          chalk.dim(String(e._id).slice(-8)),
+          chalk.cyan(e.toEmail),
           (e.subject || '').slice(0, 40),
           colorStatus(e.status),
-          e.createdAt ? new Date(e.createdAt).toLocaleString() : '—',
+          e.createdAt ? chalk.dim(new Date(e.createdAt).toLocaleString()) : '—',
         ])
       );
-      info(`Page ${opts.page} · ${emails.length} of ${data.total || '?'}`);
+      info(`Page ${opts.page} · ${emails.length} of ${chalk.bold(data.total ?? '?')}`);
     } catch (err) {
-      spinner.stop();
-      require('../output').error(err.message);
+      sp.fail(chalk.red('Failed'));
+      error(err.message);
       process.exit(1);
     }
   });
@@ -45,28 +45,32 @@ cmd
   .description('Show email stats summary')
   .option('--json', 'Output raw JSON')
   .action(async (opts) => {
-    const spinner = ora('Loading…').start();
+    const sp = spinner('Loading stats…').start();
     try {
       const data = await client.get('/emails/stats/summary');
-      spinner.stop();
+      sp.succeed(chalk.dim('Loaded'));
       if (opts.json) return json(data);
       const s = data.stats || data;
+
+      const openRate  = s.openRate  != null ? chalk.green(`${(s.openRate  * 100).toFixed(1)}%`) : '—';
+      const clickRate = s.clickRate != null ? chalk.cyan( `${(s.clickRate * 100).toFixed(1)}%`) : '—';
+
       table(
         ['Metric', 'Value'],
         [
-          ['Total Sent', s.totalSent ?? '—'],
-          ['Delivered', s.delivered ?? '—'],
-          ['Opened', s.opened ?? '—'],
-          ['Clicked', s.clicked ?? '—'],
-          ['Bounced', s.bounced ?? '—'],
-          ['Failed', s.failed ?? '—'],
-          ['Open Rate', s.openRate != null ? `${(s.openRate * 100).toFixed(1)}%` : '—'],
-          ['Click Rate', s.clickRate != null ? `${(s.clickRate * 100).toFixed(1)}%` : '—'],
+          ['Total Sent',  chalk.bold(String(s.totalSent  ?? '—'))],
+          ['Delivered',   chalk.green(String(s.delivered  ?? '—'))],
+          ['Opened',      chalk.cyan(String(s.opened      ?? '—'))],
+          ['Clicked',     chalk.cyan(String(s.clicked     ?? '—'))],
+          ['Bounced',     chalk.red(String(s.bounced      ?? '—'))],
+          ['Failed',      chalk.red(String(s.failed       ?? '—'))],
+          ['Open Rate',   openRate],
+          ['Click Rate',  clickRate],
         ]
       );
     } catch (err) {
-      spinner.stop();
-      require('../output').error(err.message);
+      sp.fail(chalk.red('Failed'));
+      error(err.message);
       process.exit(1);
     }
   });
@@ -76,26 +80,26 @@ cmd
   .description('Get details for a single email')
   .option('--json', 'Output raw JSON')
   .action(async (emailId, opts) => {
-    const spinner = ora('Fetching…').start();
+    const sp = spinner(`Fetching email ${chalk.dim(emailId.slice(-8))}…`).start();
     try {
       const data = await client.get(`/emails/${emailId}`);
-      spinner.stop();
+      sp.succeed(chalk.dim('Loaded'));
       if (opts.json) return json(data);
       const e = data.email || data;
       table(
         ['Field', 'Value'],
         [
-          ['ID', e._id],
-          ['To', e.toEmail],
-          ['Subject', e.subject],
-          ['Status', colorStatus(e.status)],
-          ['From', e.fromEmail || '—'],
+          ['ID',      chalk.dim(e._id)],
+          ['To',      chalk.cyan(e.toEmail)],
+          ['Subject', chalk.bold(e.subject)],
+          ['Status',  colorStatus(e.status)],
+          ['From',    e.fromEmail || '—'],
           ['Sent At', e.createdAt ? new Date(e.createdAt).toLocaleString() : '—'],
         ]
       );
     } catch (err) {
-      spinner.stop();
-      require('../output').error(err.message);
+      sp.fail(chalk.red('Failed'));
+      error(err.message);
       process.exit(1);
     }
   });