sendcraft-cli 1.0.0

package/bin/sendcraft.js

@@ -0,0 +1,36 @@
+#!/usr/bin/env node
+
+'use strict';
+
+const { program } = require('commander');
+const chalk = require('chalk');
+const pkg = require('../package.json');
+
+// Sub-commands
+program
+  .name('sendcraft')
+  .description('Official SendCraft CLI')
+  .version(pkg.version, '-v, --version');
+
+program.addCommand(require('../lib/commands/config'));
+program.addCommand(require('../lib/commands/send'));
+program.addCommand(require('../lib/commands/emails'));
+program.addCommand(require('../lib/commands/campaigns'));
+program.addCommand(require('../lib/commands/subscribers'));
+program.addCommand(require('../lib/commands/domains'));
+program.addCommand(require('../lib/commands/keys'));
+program.addCommand(require('../lib/commands/warmup'));
+
+// Friendly error on unknown command
+program.on('command:*', (args) => {
+  console.error(chalk.red(`Unknown command: ${args[0]}`));
+  console.error('Run ' + chalk.bold('sendcraft --help') + ' to see available commands.');
+  process.exit(1);
+});
+
+program.parse(process.argv);
+
+// Show help if called with no args
+if (process.argv.length < 3) {
+  program.help();
+}

package/lib/client.js

@@ -0,0 +1,63 @@
+/**
+ * Thin HTTP client wrapping Node's built-in https/http.
+ * No extra dependencies needed.
+ */
+const https = require('https');
+const http = require('http');
+const { URL } = require('url');
+const { getApiKey, getBaseUrl } = require('./config');
+
+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>'));
+    }
+
+    const fullUrl = new URL(getBaseUrl() + path);
+    const isHttps = fullUrl.protocol === 'https:';
+    const mod = isHttps ? https : 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: {
+        'x-api-key': apiKey,
+        '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();
+  });
+}
+
+module.exports = {
+  get: (path) => request('GET', path),
+  post: (path, body) => request('POST', path, body),
+  delete: (path) => request('DELETE', path),
+};

package/lib/commands/campaigns.js

@@ -0,0 +1,58 @@
+const { Command } = require('commander');
+const ora = require('ora');
+const client = require('../client');
+const { table, json, colorStatus, info, success, error } = require('../output');
+
+const cmd = new Command('campaigns').description('Manage campaigns');
+
+cmd
+  .command('list')
+  .description('List campaigns')
+  .option('--json', 'Output raw JSON')
+  .action(async (opts) => {
+    const spinner = ora('Fetching…').start();
+    try {
+      const data = await client.get('/campaigns');
+      spinner.stop();
+      if (opts.json) return json(data);
+      const campaigns = data.campaigns || [];
+      if (!campaigns.length) return info('No campaigns found.');
+      table(
+        ['ID', 'Name', 'Subject', 'Status', 'Recipients', 'Created'],
+        campaigns.map(c => [
+          String(c._id).slice(-8),
+          (c.name || '').slice(0, 25),
+          (c.subject || '').slice(0, 30),
+          colorStatus(c.status),
+          c.recipientCount ?? '—',
+          c.createdAt ? new Date(c.createdAt).toLocaleString() : '—',
+        ])
+      );
+    } catch (err) {
+      spinner.stop();
+      error(err.message);
+      process.exit(1);
+    }
+  });
+
+cmd
+  .command('send <campaignId>')
+  .description('Send or schedule a campaign')
+  .option('--schedule <isoDate>', 'Schedule for a specific time (ISO 8601)')
+  .option('--json', 'Output raw JSON')
+  .action(async (campaignId, opts) => {
+    const spinner = ora('Sending…').start();
+    try {
+      const body = opts.schedule ? { scheduledAt: opts.schedule } : {};
+      const data = await client.post(`/campaigns/${campaignId}/send`, body);
+      spinner.stop();
+      if (opts.json) return json(data);
+      success(`Campaign ${campaignId} ${opts.schedule ? 'scheduled' : 'sent'}!`);
+    } catch (err) {
+      spinner.stop();
+      error(err.message);
+      process.exit(1);
+    }
+  });
+
+module.exports = cmd;

package/lib/commands/config.js

@@ -0,0 +1,70 @@
+const { Command } = require('commander');
+const prompts = require('prompts');
+const chalk = require('chalk');
+const { load, save, getApiKey, getBaseUrl, CONFIG_FILE } = require('../config');
+const { success, info, error } = require('../output');
+
+const cmd = new Command('config')
+  .description('Configure your SendCraft credentials');
+
+cmd
+  .command('set-key <apiKey>')
+  .description('Save your API key')
+  .action((apiKey) => {
+    const cfg = load();
+    cfg.api_key = apiKey;
+    save(cfg);
+    success(`API key saved to ${CONFIG_FILE}`);
+  });
+
+cmd
+  .command('set-url <url>')
+  .description('Override the API base URL (default: https://api.sendcraft.online/api)')
+  .action((url) => {
+    const cfg = load();
+    cfg.base_url = url;
+    save(cfg);
+    success(`Base URL saved: ${url}`);
+  });
+
+cmd
+  .command('show')
+  .description('Show current configuration')
+  .action(() => {
+    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.');
+      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);
+  });
+
+cmd
+  .command('init')
+  .description('Interactive setup')
+  .action(async () => {
+    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_',
+      },
+      {
+        type: 'text',
+        name: 'base_url',
+        message: 'API base URL',
+        initial: 'https://api.sendcraft.online/api',
+      },
+    ]);
+    if (!answers.api_key) return error('Cancelled.');
+    save(answers);
+    success('Config saved!');
+  });
+
+module.exports = cmd;

package/lib/commands/domains.js

@@ -0,0 +1,121 @@
+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 cmd = new Command('domains').description('Manage sender domains');
+
+cmd
+  .command('list')
+  .description('List all domains')
+  .option('--json', 'Output raw JSON')
+  .action(async (opts) => {
+    const spinner = ora('Fetching…').start();
+    try {
+      const data = await client.get('/domains');
+      spinner.stop();
+      if (opts.json) return json(data);
+      const domains = data.domains || [];
+      if (!domains.length) return info('No domains added yet.');
+      table(
+        ['Domain', 'Status', 'SPF', 'DKIM', 'DMARC', 'Added'],
+        domains.map(d => [
+          d.domain,
+          colorStatus(d.status),
+          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() : '—',
+        ])
+      );
+    } catch (err) {
+      spinner.stop();
+      error(err.message);
+      process.exit(1);
+    }
+  });
+
+cmd
+  .command('add <domain>')
+  .description('Add a new sender domain')
+  .option('--json', 'Output raw JSON')
+  .action(async (domain, opts) => {
+    const spinner = ora('Adding domain…').start();
+    try {
+      const data = await client.post('/domains', { domain });
+      spinner.stop();
+      if (opts.json) return json(data);
+      success(`Domain ${domain} added.`);
+      info('Add these DNS records to your domain:');
+      (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}`);
+      });
+    } catch (err) {
+      spinner.stop();
+      error(err.message);
+      process.exit(1);
+    }
+  });
+
+cmd
+  .command('verify <domainId>')
+  .description('Trigger a DNS verification check')
+  .option('--json', 'Output raw JSON')
+  .action(async (id, opts) => {
+    const spinner = ora('Checking DNS…').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.');
+      } 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.');
+      }
+    } catch (err) {
+      spinner.stop();
+      error(err.message);
+      process.exit(1);
+    }
+  });
+
+cmd
+  .command('records <domainId>')
+  .description('Show DNS records to configure for a domain')
+  .option('--json', 'Output raw JSON')
+  .action(async (id, opts) => {
+    const spinner = ora('Loading…').start();
+    try {
+      const data = await client.get(`/domains/${id}`);
+      spinner.stop();
+      if (opts.json) return json(data.dnsRecords);
+      (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}`);
+      });
+    } catch (err) {
+      spinner.stop();
+      error(err.message);
+      process.exit(1);
+    }
+  });
+
+module.exports = cmd;

package/lib/commands/emails.js

@@ -0,0 +1,103 @@
+const { Command } = require('commander');
+const ora = require('ora');
+const client = require('../client');
+const { table, json, colorStatus, info } = require('../output');
+
+const cmd = new Command('emails').description('Manage emails');
+
+cmd
+  .command('list')
+  .description('List sent emails')
+  .option('-p, --page <n>', 'Page number', '1')
+  .option('-l, --limit <n>', 'Items per page', '20')
+  .option('--status <s>', 'Filter by status (sent, delivered, failed, scheduled)')
+  .option('--json', 'Output raw JSON')
+  .action(async (opts) => {
+    const spinner = ora('Fetching…').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();
+      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,
+          (e.subject || '').slice(0, 40),
+          colorStatus(e.status),
+          e.createdAt ? new Date(e.createdAt).toLocaleString() : '—',
+        ])
+      );
+      info(`Page ${opts.page} · ${emails.length} of ${data.total || '?'}`);
+    } catch (err) {
+      spinner.stop();
+      require('../output').error(err.message);
+      process.exit(1);
+    }
+  });
+
+cmd
+  .command('stats')
+  .description('Show email stats summary')
+  .option('--json', 'Output raw JSON')
+  .action(async (opts) => {
+    const spinner = ora('Loading…').start();
+    try {
+      const data = await client.get('/emails/stats/summary');
+      spinner.stop();
+      if (opts.json) return json(data);
+      const s = data.stats || data;
+      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)}%` : '—'],
+        ]
+      );
+    } catch (err) {
+      spinner.stop();
+      require('../output').error(err.message);
+      process.exit(1);
+    }
+  });
+
+cmd
+  .command('get <emailId>')
+  .description('Get details for a single email')
+  .option('--json', 'Output raw JSON')
+  .action(async (emailId, opts) => {
+    const spinner = ora('Fetching…').start();
+    try {
+      const data = await client.get(`/emails/${emailId}`);
+      spinner.stop();
+      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 || '—'],
+          ['Sent At', e.createdAt ? new Date(e.createdAt).toLocaleString() : '—'],
+        ]
+      );
+    } catch (err) {
+      spinner.stop();
+      require('../output').error(err.message);
+      process.exit(1);
+    }
+  });
+
+module.exports = cmd;

package/lib/commands/keys.js

@@ -0,0 +1,89 @@
+const { Command } = require('commander');
+const ora = require('ora');
+const chalk = require('chalk');
+const client = require('../client');
+const { table, json, info, success, error } = require('../output');
+
+const cmd = new Command('keys').description('Manage API keys');
+
+cmd
+  .command('list')
+  .description('List all API keys')
+  .option('--json', 'Output raw JSON')
+  .action(async (opts) => {
+    const spinner = ora('Fetching…').start();
+    try {
+      const data = await client.get('/user/keys');
+      spinner.stop();
+      if (opts.json) return json(data);
+      const keys = data.keys || [];
+      if (!keys.length) return info('No API keys found.');
+      table(
+        ['ID', 'Name', 'Key (masked)', 'Permissions', 'Last Used', 'Created'],
+        keys.map(k => [
+          String(k._id).slice(-8),
+          k.name,
+          k.maskedKey || '***',
+          k.permissions || 'full_access',
+          k.lastUsedAt ? new Date(k.lastUsedAt).toLocaleDateString() : 'Never',
+          k.createdAt ? new Date(k.createdAt).toLocaleDateString() : '—',
+        ])
+      );
+    } catch (err) {
+      spinner.stop();
+      error(err.message);
+      process.exit(1);
+    }
+  });
+
+cmd
+  .command('create <name>')
+  .description('Create a new API key')
+  .option('--permissions <type>', 'full_access or sending_access', 'full_access')
+  .option('--domains <domains>', 'Comma-separated allowed sender domains')
+  .option('--json', 'Output raw JSON')
+  .action(async (name, opts) => {
+    const spinner = ora('Creating…').start();
+    try {
+      const body = {
+        name,
+        permissions: opts.permissions,
+        allowedDomains: opts.domains ? opts.domains.split(',').map(d => d.trim()) : undefined,
+      };
+      const data = await client.post('/user/keys', body);
+      spinner.stop();
+      if (opts.json) return json(data);
+      const key = data.key;
+      success('API key created!');
+      console.log(chalk.bold('\nKey (save this — shown only once):'));
+      console.log(chalk.green(key.key || '—'));
+      console.log(`\nPermissions: ${key.permissions}`);
+      if (key.allowedDomains?.length) {
+        console.log(`Allowed domains: ${key.allowedDomains.join(', ')}`);
+      }
+    } catch (err) {
+      spinner.stop();
+      error(err.message);
+      process.exit(1);
+    }
+  });
+
+cmd
+  .command('revoke <keyId>')
+  .description('Revoke an API key permanently')
+  .option('--json', 'Output raw JSON')
+  .action(async (keyId, opts) => {
+    const spinner = ora('Revoking…').start();
+    try {
+      const data = await client.delete(`/user/keys/${keyId}`);
+      spinner.stop();
+      if (opts.json) return json(data);
+      success(`Key ${keyId} revoked.`);
+    } catch (err) {
+      spinner.stop();
+      error(err.message);
+      process.exit(1);
+    }
+  });
+
+module.exports = cmd;

package/lib/commands/send.js

@@ -0,0 +1,40 @@
+const { Command } = require('commander');
+const ora = require('ora');
+const client = require('../client');
+const { success, error, json } = require('../output');
+
+const cmd = new Command('send')
+  .description('Send a single transactional email')
+  .requiredOption('-t, --to <email>', 'Recipient email address')
+  .requiredOption('-s, --subject <text>', 'Email subject')
+  .option('-H, --html <html>', 'HTML body')
+  .option('-T, --text <text>', 'Plain text body')
+  .option('-f, --from <email>', 'From address (uses account default if omitted)')
+  .option('-r, --reply-to <email>', 'Reply-To address')
+  .option('--json', 'Output raw JSON')
+  .action(async (opts) => {
+    if (!opts.html && !opts.text) {
+      error('Provide at least --html or --text');
+      process.exit(1);
+    }
+    const spinner = ora('Sending…').start();
+    try {
+      const result = await client.post('/emails/send', {
+        toEmail: opts.to,
+        subject: opts.subject,
+        htmlContent: opts.html,
+        plainTextContent: opts.text,
+        fromEmail: opts.from,
+        replyTo: opts.replyTo,
+      });
+      spinner.stop();
+      if (opts.json) return json(result);
+      success(`Email sent! ID: ${result.emailId || result._id || '—'}`);
+    } catch (err) {
+      spinner.stop();
+      error(err.message);
+      process.exit(1);
+    }
+  });
+
+module.exports = cmd;

package/lib/commands/subscribers.js

@@ -0,0 +1,90 @@
+const { Command } = require('commander');
+const ora = require('ora');
+const client = require('../client');
+const { table, json, colorStatus, info, success, error } = require('../output');
+
+const cmd = new Command('subscribers').description('Manage subscribers');
+
+cmd
+  .command('list')
+  .description('List subscribers')
+  .option('-p, --page <n>', 'Page', '1')
+  .option('-l, --limit <n>', 'Limit', '20')
+  .option('--status <s>', 'Filter: active, pending, unsubscribed')
+  .option('--json', 'Output raw JSON')
+  .action(async (opts) => {
+    const spinner = ora('Fetching…').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();
+      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(' ') || '—',
+          colorStatus(s.status),
+          (s.tags || []).join(', ') || '—',
+          s.createdAt ? new Date(s.createdAt).toLocaleDateString() : '—',
+        ])
+      );
+      info(`Page ${opts.page} · ${subs.length} of ${data.total || '?'}`);
+    } catch (err) {
+      spinner.stop();
+      error(err.message);
+      process.exit(1);
+    }
+  });
+
+cmd
+  .command('add <email>')
+  .description('Add a subscriber')
+  .option('--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();
+    try {
+      const data = await client.post('/subscribers/add', {
+        email,
+        listId: opts.list,
+        firstName: opts.firstName,
+        lastName: opts.lastName,
+        tags: opts.tags ? opts.tags.split(',').map(t => t.trim()) : undefined,
+      });
+      spinner.stop();
+      if (opts.json) return json(data);
+      success(`Subscriber ${email} added.`);
+    } catch (err) {
+      spinner.stop();
+      error(err.message);
+      process.exit(1);
+    }
+  });
+
+cmd
+  .command('remove <subscriberId>')
+  .description('Remove a subscriber by ID')
+  .option('--json', 'Output raw JSON')
+  .action(async (id, opts) => {
+    const spinner = ora('Removing…').start();
+    try {
+      const data = await client.delete(`/subscribers/${id}`);
+      spinner.stop();
+      if (opts.json) return json(data);
+      success(`Subscriber ${id} removed.`);
+    } catch (err) {
+      spinner.stop();
+      error(err.message);
+      process.exit(1);
+    }
+  });
+
+module.exports = cmd;

package/lib/commands/warmup.js

@@ -0,0 +1,52 @@
+const { Command } = require('commander');
+const ora = require('ora');
+const chalk = require('chalk');
+const client = require('../client');
+const { table, json, error } = 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();
+    try {
+      const data = await client.get('/smtp/warmup');
+      spinner.stop();
+      if (opts.json) return json(data);
+
+      const bar = buildBar(data.todayCount, data.dailyLimit);
+
+      if (data.isWarmedUp) {
+        console.log(chalk.green.bold('✓ IP is fully warmed up — no daily limits'));
+      } else {
+        console.log(chalk.yellow.bold(`Warmup Day ${data.warmupDay}`));
+        console.log(`Progress: ${bar} ${data.todayCount}/${data.dailyLimit}`);
+      }
+
+      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}%` : '—'],
+        ]
+      );
+    } catch (err) {
+      spinner.stop();
+      error(err.message);
+      process.exit(1);
+    }
+  });
+
+function buildBar(count, limit) {
+  if (!limit) return '';
+  const width = 20;
+  const filled = Math.round((count / limit) * width);
+  return '[' + chalk.green('█'.repeat(filled)) + '░'.repeat(width - filled) + ']';
+}
+
+module.exports = cmd;

package/lib/config.js

@@ -0,0 +1,33 @@
+/**
+ * Reads/writes ~/.sendcraft/config.json
+ * Stores: api_key, base_url
+ */
+const fs = require('fs');
+const path = require('path');
+const os = require('os');
+
+const CONFIG_DIR = path.join(os.homedir(), '.sendcraft');
+const CONFIG_FILE = path.join(CONFIG_DIR, 'config.json');
+
+function load() {
+  try {
+    return JSON.parse(fs.readFileSync(CONFIG_FILE, 'utf8'));
+  } catch {
+    return {};
+  }
+}
+
+function save(data) {
+  if (!fs.existsSync(CONFIG_DIR)) fs.mkdirSync(CONFIG_DIR, { recursive: true });
+  fs.writeFileSync(CONFIG_FILE, JSON.stringify(data, null, 2), 'utf8');
+}
+
+function getApiKey() {
+  return process.env.SENDCRAFT_API_KEY || load().api_key || null;
+}
+
+function getBaseUrl() {
+  return process.env.SENDCRAFT_BASE_URL || load().base_url || 'https://api.sendcraft.online/api';
+}
+
+module.exports = { load, save, getApiKey, getBaseUrl, CONFIG_FILE };

package/lib/output.js

@@ -0,0 +1,61 @@
+/**
+ * Formatting helpers — tables, status badges, JSON flag support.
+ */
+const chalk = require('chalk');
+const Table = require('cli-table3');
+
+const STATUS_COLORS = {
+  delivered: 'green',
+  sent: 'green',
+  active: 'green',
+  verified: 'green',
+  warmed_up: 'green',
+  opened: 'cyan',
+  clicked: 'cyan',
+  pending: 'yellow',
+  scheduled: 'yellow',
+  draft: 'yellow',
+  failed: 'red',
+  bounced: 'red',
+  complained: 'red',
+  cancelled: 'gray',
+  paused: 'gray',
+};
+
+function colorStatus(status) {
+  const color = STATUS_COLORS[status] || 'white';
+  return chalk[color](status);
+}
+
+function table(headers, rows) {
+  const t = new Table({ head: headers.map(h => chalk.bold(h)), style: { compact: true } });
+  rows.forEach(row => t.push(row));
+  console.log(t.toString());
+}
+
+function json(data) {
+  console.log(JSON.stringify(data, null, 2));
+}
+
+function success(msg) {
+  console.log(chalk.green('✓') + ' ' + msg);
+}
+
+function error(msg) {
+  console.error(chalk.red('✗') + ' ' + msg);
+}
+
+function info(msg) {
+  console.log(chalk.blue('ℹ') + ' ' + msg);
+}
+
+function warn(msg) {
+  console.log(chalk.yellow('⚠') + ' ' + msg);
+}
+
+function printOrJson(data, asJson, printFn) {
+  if (asJson) return json(data);
+  printFn(data);
+}
+
+module.exports = { table, json, success, error, info, warn, printOrJson, colorStatus };

package/package.json

@@ -0,0 +1,26 @@
+{
+  "name": "sendcraft-cli",
+  "version": "1.0.0",
+  "description": "Official SendCraft CLI — send emails, manage campaigns, and more from your terminal",
+  "bin": {
+    "sendcraft": "./bin/sendcraft.js"
+  },
+  "main": "./bin/sendcraft.js",
+  "scripts": {
+    "test": "echo \"No tests yet\""
+  },
+  "keywords": ["sendcraft", "email", "cli", "transactional"],
+  "author": "SendCraft Team <sendcraft.team@gmail.com>",
+  "license": "MIT",
+  "dependencies": {
+    "chalk": "^4.1.2",
+    "cli-table3": "^0.6.5",
+    "commander": "^11.1.0",
+    "ora": "^5.4.1",
+    "prompts": "^2.4.2"
+  },
+  "engines": {
+    "node": ">=14.0.0"
+  },
+  "homepage": "https://sendcraft.online"
+}