@sesender/cli 1.0.4 → 1.0.6

package/bin/ses-cli.mjs

@@ -10,11 +10,12 @@ 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 { accountInfo, accountRateLimit, accountBalance } from "../src/commands/account.mjs";
 import { trackingDomainsList, trackingStats } from "../src/commands/tracking.mjs";
 import { scheduleList, scheduleCancel } from "../src/commands/schedule.mjs";
+import { settingsDailyLimit } from "../src/commands/settings.mjs";
 
-const VERSION = "1.0.1";
+const VERSION = "1.0.6";
 
 function parseArgs(argv) {
   const args = { _positional: [] };
@@ -98,6 +99,7 @@ VALIDATION
   validate phone   Validate a phone number
   validate email   Validate an email address
   validate bulk    Bulk validate from file
+  validate balance Check validation credit balance
 
 SEED CHECK
   seed-check       Check emails against seed database
@@ -109,7 +111,9 @@ ANALYTICS
 ACCOUNT
   account info     View account information
   account rate     View API rate limit status
-
+  account balance  View all credit balances
+SETTINGS
+  settings daily-limit  Get or set max messages per recipient per day
 GLOBAL OPTIONS
   --json           Output in JSON format (machine-readable)
   --help           Show this help message
@@ -291,8 +295,9 @@ async function main() {
           case "phone": await validatePhone(args, jsonMode); break;
           case "email": await validateEmail(args, jsonMode); break;
           case "bulk": await validateBulk(args, jsonMode); break;
+          case "balance": await accountBalance(args, jsonMode); break;
           default:
-            console.error("Usage: ses-cli validate <phone|email|bulk>");
+            console.error("Usage: ses-cli validate <phone|email|bulk|balance>");
             process.exit(1);
         }
         break;
@@ -305,16 +310,26 @@ async function main() {
         await seedBalance(args, jsonMode);
         break;
 
-      case "account":
+            case "account":
         switch (subcommand) {
           case "info": await accountInfo(args, jsonMode); break;
           case "rate": await accountRateLimit(args, jsonMode); break;
+          case "balance": await accountBalance(args, jsonMode); break;
           default:
-            console.error("Usage: ses-cli account <info|rate>");
+            console.error("Usage: ses-cli account <info|rate|balance>");
+            process.exit(1);
+        }
+        break;
+      case "settings":
+        switch (subcommand) {
+          case "daily-limit": await settingsDailyLimit(args, jsonMode); break;
+          default:
+            console.error("Usage: ses-cli settings <daily-limit>");
+            console.error("\n  daily-limit    Get or set max messages per recipient per day");
+            console.error("                 --set <N>  Set limit (use 0 to remove)");
             process.exit(1);
         }
         break;
-
       default:
         console.error(`Unknown command: ${command}`);
         console.error("Run 'ses-cli --help' for usage information.");

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@sesender/cli",
-  "version": "1.0.4",
+  "version": "1.0.6",
   "description": "SESender CLI - Send SMS/emails, manage contacts, and view analytics from your terminal",
   "type": "module",
   "bin": {
@@ -11,15 +11,7 @@
     "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": {

package/src/commands/account.mjs

@@ -13,6 +13,28 @@ export async function accountInfo(args, jsonMode) {
     console.log(`  Name:       ${data.name || "N/A"}`);
     console.log(`  Email:      ${data.email || "N/A"}`);
     console.log(`  User ID:    ${data.id || "N/A"}`);
+
+    if (data.balances) {
+      console.log(`\n  Balances`);
+      console.log(`  ─────────────────────────`);
+      if (data.balances.validation) {
+        const v = data.balances.validation;
+        console.log(`  Validation: ${v.balanceFormatted} (${v.rateFormatted})`);
+        if (v.balance > 0 && v.rate > 0) {
+          const remaining = Math.floor(v.balance / v.rate);
+          console.log(`              ~${remaining} checks remaining`);
+        }
+      }
+      if (data.balances.seedCheck) {
+        const s = data.balances.seedCheck;
+        console.log(`  Seed Check: ${s.balanceFormatted} (${s.rateFormatted})`);
+        if (s.balance > 0 && s.rate > 0) {
+          const remaining = Math.floor(s.balance / s.rate);
+          console.log(`              ~${remaining} checks remaining`);
+        }
+      }
+    }
+
     if (data.apiKey) {
       console.log(`\n  API Key Details`);
       console.log(`  ─────────────────────────`);
@@ -46,3 +68,33 @@ export async function accountRateLimit(args, jsonMode) {
     console.log("");
   }
 }
+
+export async function accountBalance(args, jsonMode) {
+  const result = await apiRequest("GET", "/validate/balance");
+  const seedResult = await apiRequest("GET", "/seed-check/balance");
+
+  if (jsonMode) {
+    outputResult({
+      validation: result.data || result,
+      seedCheck: seedResult.data || seedResult,
+    }, true);
+  } else {
+    const vData = result.data || result;
+    const sData = seedResult.data || seedResult;
+    console.log(`\n  Account Balances`);
+    console.log(`  ═══════════════════════════`);
+    console.log(`\n  Phone & Email Validation`);
+    console.log(`  ─────────────────────────`);
+    console.log(`  Balance:    ${vData.balanceFormatted || `€${((vData.balance || 0) / 100).toFixed(2)}`}`);
+    console.log(`  Rate:       ${vData.rateFormatted || `${vData.rate || 0.7} cents/check`}`);
+    console.log(`  Remaining:  ~${vData.checksRemaining || 0} checks`);
+    console.log(`\n  Seed Check`);
+    console.log(`  ─────────────────────────`);
+    console.log(`  Balance:    €${(sData.balance || 0).toFixed(2)}`);
+    console.log(`  Rate:       €${(sData.rate || 0.01).toFixed(4)}/email`);
+    if (sData.balance > 0 && sData.rate > 0) {
+      console.log(`  Remaining:  ~${Math.floor(sData.balance / sData.rate)} checks`);
+    }
+    console.log("");
+  }
+}

package/src/commands/settings.mjs

@@ -0,0 +1,54 @@
+import { apiRequest } from "../api.mjs";
+import { success, info, warn } from "../output.mjs";
+
+export async function settingsDailyLimit(args, jsonMode) {
+  const newLimit = args["--limit"] || args["--set"];
+
+  if (newLimit !== undefined) {
+    // Set the daily limit
+    const limitValue = newLimit === "0" || newLimit === "none" || newLimit === "null" 
+      ? null 
+      : parseInt(newLimit);
+
+    if (limitValue !== null && (isNaN(limitValue) || limitValue < 1)) {
+      if (jsonMode) {
+        console.log(JSON.stringify({ error: "Invalid limit value. Must be a positive integer or 0/none for no limit." }));
+      } else {
+        console.error("Error: Limit must be a positive integer, or use 0/none to remove the limit.");
+      }
+      process.exit(1);
+    }
+
+    const result = await apiRequest("PUT", "/settings/daily-limit", { limit: limitValue });
+
+    if (jsonMode) {
+      console.log(JSON.stringify(result, null, 2));
+    } else {
+      if (limitValue) {
+        success(`Daily limit set to ${limitValue} messages per recipient per day`);
+      } else {
+        success("Daily limit removed (no limit)");
+      }
+    }
+  } else {
+    // Get the current daily limit
+    const result = await apiRequest("GET", "/settings/daily-limit");
+
+    if (jsonMode) {
+      console.log(JSON.stringify(result, null, 2));
+    } else {
+      const limit = result.data?.maxMessagesPerRecipientPerDay;
+      console.log("\n  Daily Recipient Limit");
+      console.log("  " + "─".repeat(40));
+      if (limit) {
+        console.log(`  Max messages per recipient/day: ${limit}`);
+        info("  Each email/phone can receive at most " + limit + " message(s) per day across all campaigns.");
+      } else {
+        console.log("  Max messages per recipient/day: No limit");
+        info("  Recipients can receive unlimited messages per day.");
+      }
+      console.log("\n  To set a limit:  ses-cli settings daily-limit --set 3");
+      console.log("  To remove limit: ses-cli settings daily-limit --set 0\n");
+    }
+  }
+}