argorant 0.9.0 → 0.10.0

package/README.md

@@ -153,18 +153,29 @@ argorant inboxes connect-google --admin admin@yourdomain.com --emails a@x.com,b@
 ```
 
 New mailboxes on their own new domains, ordered from the terminal. The quote shows every domain with its
-first-year and renewal price, the mailboxes and the total; the order returns a checkout link that you pay
-yourself. Nothing is bought before that payment, and setup starts once it is confirmed. Warm-up is included
-in every plan; switch it on per mailbox with `argorant inboxes set <mailbox> --warmup`.
+first-year and renewal price, the mailboxes, the total and how it is paid. When your workspace saved its card
+for API and agent purchases (you ticked that box when you paid an earlier order, and the setting in
+Settings > Billing is on), the order is charged to that card right away, within any limit you set there, and a
+receipt is emailed to the workspace. Otherwise the order returns a payment link that you pay yourself.
+Nothing is bought before the payment, and setup starts once it went through. Warm-up is included in every
+plan; switch it on per mailbox with `argorant inboxes set <mailbox> --warmup`.
+
+Domains can end in .com, .net, .org, .co, .sbs, .biz or .info (`argorant inboxes endings` prints the live list).
 
 ```
-argorant inboxes suggest acme.com                                  # free domain names with prices
+argorant inboxes suggest acme.com [--ending com]                   # free domain names with prices
 argorant inboxes quote --mailboxes 100 --company acme.com          # or --domains getacme.com,tryacme.co
-argorant inboxes order <quote-id> --senders "Elena Vaughn"         # asks first; prints the checkout link
-argorant inboxes status [<order-id>]                               # steps, domains, renewal prices, bundles
-argorant inboxes cancel-bundle <order-id> <bundle-id> [--keep-domains]   |   cancel-domain <order-id> <domain>
+argorant inboxes order <quote-id> --senders "Elena Vaughn"         # asks first; saved card or a payment link
+argorant inboxes order <quote-id> --senders "Elena Vaughn" --pay-with link   # always a payment link
+argorant inboxes status [<order-id>]                               # steps, domains, renewal, bundles
+argorant inboxes renewal <order-id> <domain> --off                 # Stop renewal (nothing is charged now)
+argorant inboxes renewal <order-id> <domain> --on                  # Turn renewal back on (billed shortly before it renews)
+argorant inboxes cancel-bundle <order-id> <bundle-id> --reason too_expensive [--note "..."] [--keep-domains]
 ```
 
+Cancel reasons: `too_expensive`, `not_sending_enough`, `deliverability`, `switching_provider`,
+`campaign_finished`, `other`. `cancel-domain` still works as the old name of `renewal --off`.
+
 `<campaign>` accepts an id or an unambiguous case-insensitive name prefix. Every address is verified before
 it is enrolled; only valid ones send unless `--include-catch-all`. Variables: `{{first_name}}`, `{{last_name}}`,
 `{{company}}`, `{{title}}`; spintax `{a|b}` varies phrasing. `--query "..."` filter enrollment stays available

package/bin/argorant.js

@@ -1654,11 +1654,14 @@ ${bold("USAGE")}
   ${bold("argorant inboxes")} set <mailbox> [--daily-limit 40] [--warmup|--no-warmup] [--active|--inactive] [--timezone <tz>]
   ${bold("argorant inboxes")} disconnect <mailbox>
   ${bold("argorant inboxes")} connect-google --admin <admin@yourdomain.com> [--emails a,b | --all]
-  ${bold("argorant inboxes")} suggest <website|brand> [-n 20]   ${dim("free domain names with prices")}
+  ${bold("argorant inboxes")} endings   ${dim("the domain endings on offer (com, net, org, co, sbs, biz, info)")}
+  ${bold("argorant inboxes")} suggest <website|brand> [--ending com] [-n 20]   ${dim("free domain names with prices")}
   ${bold("argorant inboxes")} quote --mailboxes 100 [--company acme.com] [--domains a.com,b.com] [--currency usd|eur] [--billing month|quarter]
-  ${bold("argorant inboxes")} order <quote-id> --senders "Elena Vaughn[,Mark Hill]" [--website acme.com] [-y]   ${dim("returns a checkout link; nothing is bought before you pay it")}
+  ${bold("argorant inboxes")} order <quote-id> --senders "Elena Vaughn[,Mark Hill]" [--website acme.com] [--pay-with link] [-y]   ${dim("the saved card when your workspace allows it, else a payment link")}
   ${bold("argorant inboxes")} status [<order-id>]
-  ${bold("argorant inboxes")} cancel-bundle <order-id> <bundle-id> [--keep-domains] [-y]  |  cancel-domain <order-id> <domain> [-y]
+  ${bold("argorant inboxes")} renewal <order-id> <domain> --off|--on [-y]   ${dim("Stop renewal / Turn renewal back on; nothing is charged now")}
+  ${bold("argorant inboxes")} cancel-bundle <order-id> <bundle-id> --reason <reason> [--note "..."] [--keep-domains] [-y]
+  ${dim("  reasons: too_expensive, not_sending_enough, deliverability, switching_provider, campaign_finished, other")}
   ${bold("argorant blocklist")} list | add <email|domain> | remove <id>
 
   ${bold("argorant inbox")} list [--folder replies|interested|not_interested|out_of_office|bounces|unsubscribes|all] [--campaign <c>] [--q text]
@@ -1780,11 +1783,18 @@ async function cmdInboxes(argv) {
     for (const c of r.connected || []) console.log(dim(`  ${c.email} · ${c.health || "ok"}`));
     return;
   }
+  if (sub === "endings") {
+    const args = readFlags(argv.slice(1));
+    const r = need(await request("GET", args.base, "/api/v1/inboxes/endings", { key }), "inboxes endings");
+    if (args.json) return console.log(JSON.stringify(r, null, 2));
+    return console.log((r.endings || []).map((e) => "." + e).join("  "));
+  }
   if (sub === "suggest") {
-    const args = readFlags(argv.slice(1), { "-n": "limit", "--limit": "limit" });
+    const args = readFlags(argv.slice(1), { "-n": "limit", "--limit": "limit", "--ending": "ending", "--tld": "ending" });
     const company = args._.join(" ").trim();
-    if (!company) die("usage: argorant inboxes suggest <website|brand> [-n 20]");
+    if (!company) die("usage: argorant inboxes suggest <website|brand> [--ending com] [-n 20]");
     const query = { company, limit: args.limit ? parseLimit(args.limit, "--limit") : 20 };
+    if (args.ending) query.ending = String(args.ending).replace(/^\./, "").toLowerCase();
     const r = need(await request("GET", args.base, "/api/v1/inboxes/domains/suggest", { key, query }), "inboxes suggest");
     if (args.json) return console.log(JSON.stringify(r, null, 2));
     for (const d of r.results || []) {
@@ -1816,32 +1826,47 @@ async function cmdInboxes(argv) {
     console.log(bold(`Due today: ${money(q.due_today_cents, cur)}`) + `  then ${money(q.recurring_cents, cur)} per ${q.mailboxes.billing}; domains renew at ${money(q.renewal_per_year_cents, cur)} a year in total`);
     console.log(dim(q.currency_rule));
     for (const line of q.included || []) console.log(dim(`  · ${line}`));
+    const card = q.payment && q.payment.saved_card;
+    if (card && card.usable) console.log(bold(`Paid with: the saved ${card.card}, charged right away when you order (within 15 minutes of this quote)`));
+    else if (card) console.log(dim(`Paid with: a payment link${card.reason ? ` (saved card: ${card.reason})` : ""}`));
     console.log(`\nQuote ${bold(q.quote_id)} ${dim(`(valid until ${String(q.expires_at).slice(0, 16).replace("T", " ")} UTC)`)}`);
     if (q.can_order) console.log(dim(`Order it:  argorant inboxes order ${q.quote_id} --senders "First Last"`));
     else console.log(yellow(q.next_step));
     return;
   }
   if (sub === "order") {
-    const args = readFlags(argv.slice(1), { "--senders": "senders", "--sender": "senders", "--website": "website" });
+    const args = readFlags(argv.slice(1), { "--senders": "senders", "--sender": "senders", "--website": "website", "--pay-with": "payWith" });
     const quoteId = args._[0];
-    if (!quoteId || !args.senders) die("usage: argorant inboxes order <quote-id> --senders \"Elena Vaughn[,Mark Hill]\" [--website acme.com] [-y]");
+    if (!quoteId || !args.senders) die("usage: argorant inboxes order <quote-id> --senders \"Elena Vaughn[,Mark Hill]\" [--website acme.com] [--pay-with link] [-y]");
+    const payWith = String(args.payWith || "auto").toLowerCase();
+    if (!["auto", "link"].includes(payWith)) die("--pay-with is link (always a payment link); leave it out for the saved card when allowed");
     const senders = String(args.senders).split(",").map((x) => x.trim()).filter(Boolean).map((full) => {
       const parts = full.split(/\s+/);
       if (parts.length < 2) die(`sender "${full}" needs a first and a last name`);
       return { first_name: parts[0], last_name: parts.slice(1).join(" ") };
     });
     if (!args.yes) {
+      const how = payWith === "link" ? "You get a payment link; nothing is bought before you pay it."
+        : "If your workspace saved its card for API and agent purchases (the quote says so), that card is charged now; otherwise you get a payment link.";
       const rl = readline.createInterface({ input: process.stdin, output: process.stdout });
-      const ok = await new Promise((r) => rl.question(`Order the inboxes in quote ${quoteId}? You get a checkout link to pay; nothing is bought before that. [y/N] `, (a) => { rl.close(); r(/^y/i.test(a)); }));
+      const ok = await new Promise((r) => rl.question(`Order the inboxes in quote ${quoteId}? ${how} [y/N] `, (a) => { rl.close(); r(/^y/i.test(a)); }));
       if (!ok) return console.log(dim("aborted"));
     }
     const body = { quote_id: quoteId, senders, website: args.website || "", confirmed: true };
-    // Same command, same key: running it again returns the same order and link instead of a second order.
+    if (payWith !== "auto") body.pay_with = payWith;
+    // Same command, same key: running it again returns the same order (and never charges twice).
     const idem = "cli-" + crypto.createHash("sha256").update(JSON.stringify(body)).digest("hex").slice(0, 40);
     const r = need(await request("POST", args.base, "/api/v1/inboxes/orders", { key, body, headers: { "Idempotency-Key": idem } }), "inboxes order");
     if (args.json) return console.log(JSON.stringify(r, null, 2));
+    if (r.status === "paid") {
+      console.log(green("✓") + ` Order ${bold(r.order_id)} paid with the saved ${r.card || "card"}${r.replayed ? dim(" (already placed)") : ""}`);
+      console.log(dim(r.message || ""));
+      console.log(dim(`Track it:  argorant inboxes status ${r.order_id}`));
+      return;
+    }
     if (!r.checkout_url) return console.log(`Order ${r.order_id}: ${r.status}. ${dim(r.message || "")}`);
     console.log(green("✓") + ` Order ${bold(r.order_id)}${r.existing || r.replayed ? dim(" (already placed)") : ""}`);
+    if (r.saved_card && r.saved_card.reason) console.log(yellow(`Not charged to the saved card: ${r.saved_card.reason}`));
     console.log(`Pay here: ${cyan(r.checkout_url)}`);
     console.log(dim("Nothing is bought until you pay it; setup starts after the payment is confirmed."));
     console.log(dim(`Track it:  argorant inboxes status ${r.order_id}`));
@@ -1857,7 +1882,7 @@ async function cmdInboxes(argv) {
     if (!rows.length) return console.log(dim("No inbox orders yet. Start with: argorant inboxes quote --mailboxes 100 --company <your website>"));
     for (const o of rows) {
       const mb = o.mailboxes || {};
-      console.log(`${bold(o.order_id)}  ${o.status}${o.step ? dim(` · ${o.step}`) : ""}  ${dim(`${mb.created || 0}/${mb.total || 0} mailboxes`)}${o.aging_ends_at ? dim(` · aging ends ${o.aging_ends_at}`) : ""}`);
+      console.log(`${bold(o.order_id)}  ${o.status}${o.step ? dim(` · ${o.step}`) : ""}  ${dim(`${mb.created || 0}/${mb.total || 0} mailboxes`)}${o.aging_ends_at ? dim(` · aging ends ${o.aging_ends_at}`) : ""}${o.ordered_via ? dim(` · ordered via API/agent${o.paid_with === "saved_card" ? ", saved card" : ""}`) : ""}`);
       for (const d of o.domains || []) {
         console.log(dim(`  ${d.name}${d.expires_at ? ` · expires ${String(d.expires_at).slice(0, 10)}` : ""} · renews at ${money(d.renewal_per_year_cents, o.currency)}/year${d.auto_renew === false ? " · renewal off" : ""}`));
       }
@@ -1867,26 +1892,47 @@ async function cmdInboxes(argv) {
     }
     return;
   }
-  if (sub === "cancel-bundle" || sub === "cancel-domain") {
-    const args = readFlags(argv.slice(1), {}, { "--keep-domains": "keepDomains" });
+  if (sub === "renewal" || sub === "cancel-domain") {
+    // cancel-domain is the old name of `renewal --off` (kept working, deprecated).
+    const args = readFlags(argv.slice(1), {}, { "--on": "on", "--off": "off" });
+    const [orderId, domain] = args._;
+    const on = sub === "renewal" ? (args.on ? true : args.off ? false : null) : false;
+    if (!orderId || !domain || on === null || (args.on && args.off)) die("usage: argorant inboxes renewal <order-id> <domain> --off|--on [-y]");
+    if (sub === "cancel-domain") console.error(dim("cancel-domain is deprecated: use `argorant inboxes renewal <order-id> <domain> --off`."));
+    const question = on
+      ? `Turn renewal back on for ${domain}? Nothing is charged now; it renews at its expiry date, billed shortly before. [y/N] `
+      : `Stop renewal for ${domain}? Nothing is charged now; it keeps working until its expiry date and is not renewed. [y/N] `;
+    if (!args.yes) {
+      const rl = readline.createInterface({ input: process.stdin, output: process.stdout });
+      const ok = await new Promise((r) => rl.question(question, (a) => { rl.close(); r(/^y/i.test(a)); }));
+      if (!ok) return console.log(dim("aborted"));
+    }
+    const r = need(await request("POST", args.base, `/api/v1/inboxes/orders/${encodeURIComponent(orderId)}/domains/${encodeURIComponent(domain)}/renewal`,
+      { key, body: { on } }), "inboxes renewal");
+    if (args.json) return console.log(JSON.stringify(r, null, 2));
+    return console.log(green("✓") + ` ${r.message || (on ? `${domain} renews again` : `${domain} will not renew`)}`);
+  }
+  if (sub === "cancel-bundle") {
+    const REASONS = ["too_expensive", "not_sending_enough", "deliverability", "switching_provider", "campaign_finished", "other"];
+    const args = readFlags(argv.slice(1), { "--reason": "reason", "--note": "note" }, { "--keep-domains": "keepDomains" });
     const [orderId, target] = args._;
-    if (!orderId || !target) die(sub === "cancel-bundle" ? "usage: argorant inboxes cancel-bundle <order-id> <bundle-id> [--keep-domains] [-y]" : "usage: argorant inboxes cancel-domain <order-id> <domain> [-y]");
-    const question = sub === "cancel-bundle"
-      ? `Cancel bundle ${target}? Billing for its mailboxes stops now (no refund); they work until the paid period ends, then they are deleted${args.keepDomains ? "" : " and its domains stop renewing"}. [y/N] `
-      : `Stop renewing ${target}? It works until its expiry date and is not renewed. [y/N] `;
+    if (!orderId || !target || !args.reason) die("usage: argorant inboxes cancel-bundle <order-id> <bundle-id> --reason <reason> [--note \"...\"] [--keep-domains] [-y]\n  reasons: " + REASONS.join(", "));
+    const reason = String(args.reason).toLowerCase();
+    if (!REASONS.includes(reason)) die(`--reason is one of: ${REASONS.join(", ")}`);
+    const question = `Cancel bundle ${target}? Billing for its mailboxes stops now (no refund); they work until the paid period ends, then they are deleted${args.keepDomains ? "" : " and its domains stop renewing"}. [y/N] `;
     if (!args.yes) {
       const rl = readline.createInterface({ input: process.stdin, output: process.stdout });
       const ok = await new Promise((r) => rl.question(question, (a) => { rl.close(); r(/^y/i.test(a)); }));
       if (!ok) return console.log(dim("aborted"));
     }
-    const base = `/api/v1/inboxes/orders/${encodeURIComponent(orderId)}`;
-    const r = sub === "cancel-bundle"
-      ? need(await request("POST", args.base, `${base}/bundles/${encodeURIComponent(target)}/cancel`, { key, body: { keep_domains: !!args.keepDomains } }), "inboxes cancel-bundle")
-      : need(await request("POST", args.base, `${base}/domains/${encodeURIComponent(target)}/cancel`, { key, body: {} }), "inboxes cancel-domain");
+    const body = { keep_domains: !!args.keepDomains, reason };
+    if (args.note) body.note = String(args.note);
+    const r = need(await request("POST", args.base, `/api/v1/inboxes/orders/${encodeURIComponent(orderId)}/bundles/${encodeURIComponent(target)}/cancel`,
+      { key, body }), "inboxes cancel-bundle");
     if (args.json) return console.log(JSON.stringify(r, null, 2));
-    return console.log(green("✓") + (sub === "cancel-bundle" ? ` Bundle ${target} cancelled${r.existing ? dim(" (already)") : ""}` : ` ${target} will not renew`));
+    return console.log(green("✓") + ` Bundle ${target} cancelled${r.existing ? dim(" (already)") : ""}`);
   }
-  die(`unknown inboxes subcommand: ${sub} (list, set, disconnect, connect-google, suggest, quote, order, status, cancel-bundle, cancel-domain)`);
+  die(`unknown inboxes subcommand: ${sub} (list, set, disconnect, connect-google, endings, suggest, quote, order, status, renewal, cancel-bundle)`);
 }
 
 function money(cents, currency) {
@@ -1924,7 +1970,7 @@ ${bold("COMMANDS")}
   ${cyan("verify")} --file emails.csv -o out.csv      Bulk-verify your own list ${dim("(recent re-checks free)")}
   ${cyan("campaigns")} ...                Email outreach: create, write, enroll, launch ${dim("(argorant campaigns help)")}
   ${cyan("inboxes")} list | connect-google  Connected mailboxes; connect a Google Workspace
-  ${cyan("inboxes")} quote | order | status  New mailboxes on new domains ${dim("(you pay each order at checkout)")}
+  ${cyan("inboxes")} quote | order | status | renewal  New mailboxes on new domains ${dim("(saved card or payment link)")}
   ${cyan("inbox")} list | read | reply | forward | classify   Replies across campaigns; answer in-thread or forward
   ${cyan("blocklist")} list | add | remove       Addresses and domains never contacted
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "argorant",
-  "version": "0.9.0",
+  "version": "0.10.0",
   "description": "Search, count, reveal, export, and verify B2B contacts from the Argorant database — from your terminal, scripts, or coding agent.",
   "bin": {
     "argorant": "bin/argorant.js"