@sesender/cli 1.0.0 → 1.0.3

package/bin/ses-cli.mjs

@@ -3,11 +3,18 @@
 import { configSet, configShow, configClear } from "../src/commands/config.mjs";
 import { smsSend, smsBulk, smsHistory } from "../src/commands/sms.mjs";
 import { emailSend, emailBulk, emailHistory } from "../src/commands/email.mjs";
-import { contactsList, contactsImport, contactsGroups } from "../src/commands/contacts.mjs";
-import { campaignsList, analyticsOverview } from "../src/commands/campaigns.mjs";
-import { validatePhone, validateEmail } from "../src/commands/validate.mjs";
+import { contactsList, contactsImport, contactsGroups, contactsExport, contactsDelete } from "../src/commands/contacts.mjs";
+import { campaignsList, campaignsStats, campaignsPause, campaignsResume, campaignsCancel, analyticsOverview } from "../src/commands/campaigns.mjs";
+import { validatePhone, validateEmail, validateBulk } from "../src/commands/validate.mjs";
+import { providersList } from "../src/commands/providers.mjs";
+import { webhooksList, webhooksCreate, webhooksDelete, webhooksTest } from "../src/commands/webhooks.mjs";
+import { seedCheck, seedBalance } from "../src/commands/seedcheck.mjs";
+import { templatesList, templatesGet } from "../src/commands/templates.mjs";
+import { accountInfo, accountRateLimit } from "../src/commands/account.mjs";
+import { trackingDomainsList, trackingStats } from "../src/commands/tracking.mjs";
+import { scheduleList, scheduleCancel } from "../src/commands/schedule.mjs";
 
-const VERSION = "1.0.0";
+const VERSION = "1.0.1";
 
 function parseArgs(argv) {
   const args = { _positional: [] };
@@ -33,55 +40,114 @@ function parseArgs(argv) {
 function showHelp() {
   console.log(`
 SESender CLI v${VERSION}
-━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
 
 USAGE
   ses-cli <command> <subcommand> [options]
 
-COMMANDS
-  config set     Configure API key and base URL
-  config show    Show current configuration
-  config clear   Remove saved configuration
+CONFIGURATION
+  config set       Configure API key and base URL
+  config show      Show current configuration
+  config clear     Remove saved configuration
+
+MESSAGING
+  sms send         Send a single SMS
+  sms bulk         Send bulk SMS from CSV file
+  sms history      View SMS message history
 
-  sms send       Send a single SMS
-  sms bulk       Send bulk SMS from CSV file
-  sms history    View SMS message history
+  email send       Send a single email
+  email bulk       Send bulk emails from CSV file
+  email history    View email message history
 
-  email send     Send a single email
-  email bulk     Send bulk emails from CSV file
-  email history  View email message history
+CAMPAIGNS
+  campaigns list   List campaigns with stats
+  campaigns stats  View detailed campaign statistics
+  campaigns pause  Pause a running campaign
+  campaigns resume Resume a paused campaign
+  campaigns cancel Cancel a campaign permanently
 
-  contacts list    List contacts
+CONTACTS
+  contacts list    List contacts (with search/filter)
   contacts import  Import contacts from CSV
   contacts groups  List contact groups
+  contacts export  Export contacts to CSV
+  contacts delete  Delete a contact
 
-  campaigns list   List campaigns with stats
-  analytics        View analytics overview
+PROVIDERS
+  providers list   List available SMS/email providers
+
+TEMPLATES
+  templates list   List saved templates
+  templates get    View a specific template
+
+WEBHOOKS
+  webhooks list    List configured webhooks
+  webhooks create  Create a new webhook
+  webhooks delete  Delete a webhook
+  webhooks test    Send a test event to a webhook
 
+TRACKING
+  tracking list    List tracking domains
+  tracking stats   View tracking/click statistics
+
+SCHEDULING
+  schedule list    List scheduled messages
+  schedule cancel  Cancel a scheduled message
+
+VALIDATION
   validate phone   Validate a phone number
   validate email   Validate an email address
+  validate bulk    Bulk validate from file
+
+SEED CHECK
+  seed-check       Check emails against seed database
+  seed-balance     Check seed check credit balance
+
+ANALYTICS
+  analytics        View analytics overview
+
+ACCOUNT
+  account info     View account information
+  account rate     View API rate limit status
 
 GLOBAL OPTIONS
-  --json         Output in JSON format (machine-readable)
-  --help         Show this help message
-  --version      Show version number
+  --json           Output in JSON format (machine-readable)
+  --help           Show this help message
+  --version        Show version number
+
+FLAGS (for sms/email send)
+  --provider       Choose specific provider (e.g., ses, mailgun, twilio)
+  --route          Routing mode (e.g., priority, round-robin)
+  --schedule       Schedule send time (ISO 8601 format)
+  --timezone       Timezone for scheduling (e.g., America/New_York)
+  --track-clicks   Enable click tracking
+  --track-opens    Enable open tracking
 
 EXAMPLES
   ses-cli config set --api-key sk_live_abc123 --base-url https://sesender.com
-  ses-cli sms send --to +1234567890 --body "Hello from CLI!"
-  ses-cli email send --to user@example.com --subject "Test" --body "Hello"
-  ses-cli sms bulk --file numbers.csv --body "Promo: 20% off!"
+  ses-cli sms send --to +1234567890 --body "Hello!" --provider twilio
+  ses-cli email send --to user@example.com --subject "Test" --html "<h1>Hi</h1>"
+  ses-cli sms bulk --file numbers.csv --body "Promo: 20% off!" --provider ses
+  ses-cli campaigns list --status sending --type email
+  ses-cli campaigns stats --id c-abc123
+  ses-cli campaigns pause --id c-abc123
   ses-cli contacts import --file contacts.csv --group "Newsletter"
+  ses-cli contacts list --search "gmail" --limit 50
+  ses-cli webhooks create --url https://myapp.com/hook --events "email.delivered,sms.sent"
   ses-cli validate phone +1234567890
-  ses-cli analytics --json
+  ses-cli validate bulk --file emails.csv --type email
+  ses-cli seed-check --emails "user@test.com" --words "trap,seed"
+  ses-cli analytics --period 30d --json
+  ses-cli schedule list --status pending
 
 ENVIRONMENT VARIABLES
-  SES_API_KEY     API key (overrides config file)
-  SES_BASE_URL    Base URL (overrides config file)
+  SES_API_KEY      API key (overrides config file)
+  SES_BASE_URL     Base URL (overrides config file)
 
 CONFIGURATION
   Config file: ~/.sesenderrc
   Create API keys at: Settings > API Keys in your SESender dashboard
+  Docs: https://sesender.com/api-docs
 `);
 }
 
@@ -144,8 +210,10 @@ async function main() {
           case "list": await contactsList(args, jsonMode); break;
           case "import": await contactsImport(args, jsonMode); break;
           case "groups": await contactsGroups(args, jsonMode); break;
+          case "export": await contactsExport(args, jsonMode); break;
+          case "delete": await contactsDelete(args, jsonMode); break;
           default:
-            console.error("Usage: ses-cli contacts <list|import|groups>");
+            console.error("Usage: ses-cli contacts <list|import|groups|export|delete>");
             process.exit(1);
         }
         break;
@@ -153,8 +221,12 @@ async function main() {
       case "campaigns":
         switch (subcommand) {
           case "list": await campaignsList(args, jsonMode); break;
+          case "stats": await campaignsStats(args, jsonMode); break;
+          case "pause": await campaignsPause(args, jsonMode); break;
+          case "resume": await campaignsResume(args, jsonMode); break;
+          case "cancel": await campaignsCancel(args, jsonMode); break;
           default:
-            console.error("Usage: ses-cli campaigns <list>");
+            console.error("Usage: ses-cli campaigns <list|stats|pause|resume|cancel>");
             process.exit(1);
         }
         break;
@@ -163,12 +235,82 @@ async function main() {
         await analyticsOverview(args, jsonMode);
         break;
 
+      case "providers":
+        switch (subcommand) {
+          case "list": await providersList(args, jsonMode); break;
+          default:
+            console.error("Usage: ses-cli providers <list>");
+            process.exit(1);
+        }
+        break;
+
+      case "templates":
+        switch (subcommand) {
+          case "list": await templatesList(args, jsonMode); break;
+          case "get": await templatesGet(args, jsonMode); break;
+          default:
+            console.error("Usage: ses-cli templates <list|get>");
+            process.exit(1);
+        }
+        break;
+
+      case "webhooks":
+        switch (subcommand) {
+          case "list": await webhooksList(args, jsonMode); break;
+          case "create": await webhooksCreate(args, jsonMode); break;
+          case "delete": await webhooksDelete(args, jsonMode); break;
+          case "test": await webhooksTest(args, jsonMode); break;
+          default:
+            console.error("Usage: ses-cli webhooks <list|create|delete|test>");
+            process.exit(1);
+        }
+        break;
+
+      case "tracking":
+        switch (subcommand) {
+          case "list": await trackingDomainsList(args, jsonMode); break;
+          case "stats": await trackingStats(args, jsonMode); break;
+          default:
+            console.error("Usage: ses-cli tracking <list|stats>");
+            process.exit(1);
+        }
+        break;
+
+      case "schedule":
+        switch (subcommand) {
+          case "list": await scheduleList(args, jsonMode); break;
+          case "cancel": await scheduleCancel(args, jsonMode); break;
+          default:
+            console.error("Usage: ses-cli schedule <list|cancel>");
+            process.exit(1);
+        }
+        break;
+
       case "validate":
         switch (subcommand) {
           case "phone": await validatePhone(args, jsonMode); break;
           case "email": await validateEmail(args, jsonMode); break;
+          case "bulk": await validateBulk(args, jsonMode); break;
+          default:
+            console.error("Usage: ses-cli validate <phone|email|bulk>");
+            process.exit(1);
+        }
+        break;
+
+      case "seed-check":
+        await seedCheck(args, jsonMode);
+        break;
+
+      case "seed-balance":
+        await seedBalance(args, jsonMode);
+        break;
+
+      case "account":
+        switch (subcommand) {
+          case "info": await accountInfo(args, jsonMode); break;
+          case "rate": await accountRateLimit(args, jsonMode); break;
           default:
-            console.error("Usage: ses-cli validate <phone|email>");
+            console.error("Usage: ses-cli account <info|rate>");
             process.exit(1);
         }
         break;
@@ -180,7 +322,11 @@ async function main() {
     }
   } catch (error) {
     if (error.message !== "process.exit") {
-      console.error(`Unexpected error: ${error.message}`);
+      if (jsonMode) {
+        console.log(JSON.stringify({ error: error.message }, null, 2));
+      } else {
+        console.error(`Error: ${error.message}`);
+      }
       process.exit(1);
     }
   }

package/package.json

@@ -1,25 +1,35 @@
 {
   "name": "@sesender/cli",
-  "version": "1.0.0",
+  "version": "1.0.3",
   "description": "SESender CLI - Send SMS/emails, manage contacts, and view analytics from your terminal",
   "type": "module",
   "bin": {
-    "ses-cli": "./bin/ses-cli.mjs"
+    "ses-cli": "bin/ses-cli.mjs"
   },
   "files": [
     "bin/",
     "src/",
     "README.md"
   ],
-  "keywords": ["sesender", "sms", "email", "marketing", "cli", "bulk-sms", "bulk-email"],
+  "keywords": [
+    "sesender",
+    "sms",
+    "email",
+    "marketing",
+    "cli",
+    "bulk-sms",
+    "bulk-email"
+  ],
   "author": "SESender Team",
   "license": "MIT",
   "repository": {
     "type": "git",
-    "url": "https://github.com/sesender/cli"
+    "url": "https://github.com/ilan7251/ses-messaging-platform.git",
+    "directory": "cli"
   },
   "engines": {
     "node": ">=18.0.0"
   },
+  "homepage": "https://sesender.com/api-docs",
   "dependencies": {}
 }

package/src/commands/account.mjs

@@ -0,0 +1,48 @@
+import { apiRequest } from "../api.mjs";
+import { outputResult, success } from "../output.mjs";
+
+export async function accountInfo(args, jsonMode) {
+  const result = await apiRequest("GET", "/account");
+
+  if (jsonMode) {
+    outputResult(result, true);
+  } else {
+    const data = result.data || result;
+    console.log(`\n  Account Information`);
+    console.log(`  ─────────────────────────`);
+    console.log(`  Name:       ${data.name || "N/A"}`);
+    console.log(`  Email:      ${data.email || "N/A"}`);
+    console.log(`  User ID:    ${data.id || "N/A"}`);
+    if (data.apiKey) {
+      console.log(`\n  API Key Details`);
+      console.log(`  ─────────────────────────`);
+      console.log(`  Plan:       ${data.apiKey.plan || "N/A"}`);
+      console.log(`  Rate Limit: ${data.apiKey.rateLimit || "N/A"} req/hour`);
+      console.log(`  Used:       ${data.apiKey.requestsThisHour || 0} this hour`);
+      console.log(`  Permissions: ${(data.apiKey.permissions || []).join(", ")}`);
+    }
+    console.log("");
+  }
+}
+
+export async function accountRateLimit(args, jsonMode) {
+  const result = await apiRequest("GET", "/rate-limit");
+
+  if (jsonMode) {
+    outputResult(result, true);
+  } else {
+    const data = result.data || result;
+    const pct = data.limit > 0 ? Math.round((data.used / data.limit) * 100) : 0;
+    const bar = "█".repeat(Math.round(pct / 5)) + "░".repeat(20 - Math.round(pct / 5));
+
+    console.log(`\n  Rate Limit Status`);
+    console.log(`  ─────────────────────────`);
+    console.log(`  Plan:      ${data.plan || "N/A"}`);
+    console.log(`  Limit:     ${data.limit} requests/hour`);
+    console.log(`  Used:      ${data.used}`);
+    console.log(`  Remaining: ${data.remaining}`);
+    console.log(`  Usage:     [${bar}] ${pct}%`);
+    if (data.resetAt) console.log(`  Resets at: ${new Date(data.resetAt).toLocaleString()}`);
+    console.log("");
+  }
+}

package/src/commands/campaigns.mjs

@@ -1,69 +1,185 @@
 import { apiRequest } from "../api.mjs";
-import { formatTable, outputResult, success } from "../output.mjs";
+import { formatTable, outputResult, success, info } from "../output.mjs";
 
 export async function campaignsList(args, jsonMode) {
   const limit = args["--limit"] || "20";
-  const result = await apiRequest("GET", "/analytics/campaigns", null, { limit });
+  const page = args["--page"] || "1";
+  const status = args["--status"];
+  const type = args["--type"];
+
+  const params = { limit, page };
+  if (status) params.status = status;
+  if (type) params.type = type;
+
+  const result = await apiRequest("GET", "/analytics/campaigns", null, params);
 
   if (jsonMode) {
     outputResult(result, true);
   } else {
-    const campaigns = result.campaigns || result.data || [];
+    const campaigns = result.data?.campaigns || result.campaigns || result.data || [];
     if (campaigns.length === 0) {
       console.log("No campaigns found.");
       return;
     }
     formatTable(
-      ["ID", "Name", "Type", "Status", "Sent", "Opens", "Clicks"],
+      ["ID", "Name", "Type", "Status", "Sent", "Opens", "Clicks", "Date"],
       campaigns.map((c) => [
         c.id || c.campaignId,
-        (c.name || c.campaignName || "").slice(0, 25),
+        (c.name || c.campaignName || c.subject || "").slice(0, 20),
         c.type || "email",
         c.status || "-",
         c.sent || c.totalSent || 0,
         c.opens || c.totalOpens || 0,
         c.clicks || c.totalClicks || 0,
+        c.createdAt ? new Date(c.createdAt).toLocaleDateString() : "-",
       ])
     );
-    console.log(`\nShowing ${campaigns.length} campaigns`);
+    console.log(`\nShowing ${campaigns.length} campaigns (page ${page})`);
+  }
+}
+
+export async function campaignsStats(args, jsonMode) {
+  const id = args["--id"];
+
+  if (!id) {
+    console.error(`
+Usage: ses-cli campaigns stats --id CAMPAIGN_ID
+
+Shows detailed statistics for a specific campaign including:
+  - Delivery rates, open rates, click rates
+  - Bounce and complaint rates
+  - Per-link click breakdown
+
+Examples:
+  ses-cli campaigns stats --id c-abc123
+  ses-cli campaigns stats --id mv-campaign-456 --json
+`);
+    process.exit(1);
+  }
+
+  const result = await apiRequest("GET", `/analytics/campaigns/${id}`);
+
+  if (jsonMode) {
+    outputResult(result, true);
+  } else {
+    const data = result.data || result;
+    console.log(`\n  Campaign Statistics: ${data.name || id}`);
+    console.log(`  ─────────────────────────────────`);
+    console.log(`  Status:     ${data.status || "N/A"}`);
+    console.log(`  Total Sent: ${data.totalSent || data.sent || 0}`);
+    console.log(`  Delivered:  ${data.delivered || 0} (${data.deliveryRate || "N/A"}%)`);
+    console.log(`  Opens:      ${data.opens || data.totalOpens || 0} (${data.openRate || "N/A"}%)`);
+    console.log(`  Clicks:     ${data.clicks || data.totalClicks || 0} (${data.clickRate || "N/A"}%)`);
+    console.log(`  Bounces:    ${data.bounces || 0} (${data.bounceRate || "N/A"}%)`);
+    console.log(`  Complaints: ${data.complaints || 0}`);
+    console.log(`  Unsubs:     ${data.unsubscribes || 0}`);
+    console.log("");
+  }
+}
+
+export async function campaignsPause(args, jsonMode) {
+  const id = args["--id"];
+
+  if (!id) {
+    console.error(`
+Usage: ses-cli campaigns pause --id CAMPAIGN_ID
+
+Pauses a running campaign. Messages already in queue will still be sent.
+Resume with: ses-cli campaigns resume --id CAMPAIGN_ID
+`);
+    process.exit(1);
+  }
+
+  const result = await apiRequest("POST", `/campaigns/${id}/pause`);
+
+  if (jsonMode) {
+    outputResult(result, true);
+  } else {
+    success(`Campaign ${id} paused`);
+  }
+}
+
+export async function campaignsResume(args, jsonMode) {
+  const id = args["--id"];
+
+  if (!id) {
+    console.error("Usage: ses-cli campaigns resume --id CAMPAIGN_ID");
+    process.exit(1);
+  }
+
+  const result = await apiRequest("POST", `/campaigns/${id}/resume`);
+
+  if (jsonMode) {
+    outputResult(result, true);
+  } else {
+    success(`Campaign ${id} resumed`);
+  }
+}
+
+export async function campaignsCancel(args, jsonMode) {
+  const id = args["--id"];
+
+  if (!id) {
+    console.error(`
+Usage: ses-cli campaigns cancel --id CAMPAIGN_ID
+
+Permanently cancels a campaign. This cannot be undone.
+Unsent messages will not be delivered.
+`);
+    process.exit(1);
+  }
+
+  const result = await apiRequest("POST", `/campaigns/${id}/cancel`);
+
+  if (jsonMode) {
+    outputResult(result, true);
+  } else {
+    success(`Campaign ${id} cancelled`);
   }
 }
 
 export async function analyticsOverview(args, jsonMode) {
-  const result = await apiRequest("GET", "/analytics/overview");
+  const period = args["--period"] || "7d";
+
+  const result = await apiRequest("GET", "/analytics/overview", null, { period });
 
   if (jsonMode) {
     outputResult(result, true);
   } else {
-    console.log("═══════════════════════════════════════");
-    console.log("         SESender Analytics Overview");
-    console.log("═══════════════════════════════════════");
+    const data = result.data || result;
+    console.log("");
+    console.log(`  ═══════════════════════════════════════`);
+    console.log(`       SESender Analytics Overview (${period})`);
+    console.log(`  ═══════════════════════════════════════`);
     console.log("");
 
-    if (result.sms) {
+    if (data.sms || data.smsSent !== undefined) {
       console.log("  SMS:");
-      console.log(`    Total Sent:     ${result.sms.totalSent || 0}`);
-      console.log(`    Delivered:      ${result.sms.delivered || 0}`);
-      console.log(`    Failed:         ${result.sms.failed || 0}`);
+      console.log(`    Total Sent:     ${data.sms?.totalSent || data.smsSent || 0}`);
+      console.log(`    Delivered:      ${data.sms?.delivered || 0}`);
+      console.log(`    Failed:         ${data.sms?.failed || 0}`);
       console.log("");
     }
 
-    if (result.email) {
+    if (data.email || data.emailsSent !== undefined) {
       console.log("  Email:");
-      console.log(`    Total Sent:     ${result.email.totalSent || 0}`);
-      console.log(`    Opens:          ${result.email.totalOpens || 0}`);
-      console.log(`    Clicks:         ${result.email.totalClicks || 0}`);
-      console.log(`    Bounces:        ${result.email.bounces || 0}`);
+      console.log(`    Total Sent:     ${data.email?.totalSent || data.emailsSent || 0}`);
+      console.log(`    Opens:          ${data.email?.totalOpens || data.opens || 0}`);
+      console.log(`    Clicks:         ${data.email?.totalClicks || data.clicks || 0}`);
+      console.log(`    Bounces:        ${data.email?.bounces || data.bounces || 0}`);
+      console.log(`    Open Rate:      ${data.email?.openRate || data.openRate || "N/A"}%`);
+      console.log(`    Click Rate:     ${data.email?.clickRate || data.clickRate || "N/A"}%`);
       console.log("");
     }
 
-    if (result.contacts) {
+    if (data.contacts) {
       console.log("  Contacts:");
-      console.log(`    Total:          ${result.contacts.total || 0}`);
-      console.log(`    Groups:         ${result.contacts.groups || 0}`);
+      console.log(`    Total:          ${data.contacts.total || 0}`);
+      console.log(`    Groups:         ${data.contacts.groups || 0}`);
       console.log("");
     }
 
-    console.log("═══════════════════════════════════════");
+    console.log(`  ═══════════════════════════════════════`);
+    console.log("");
   }
 }