argorant 0.5.0 → 0.5.1

package/bin/argorant.js

@@ -75,6 +75,9 @@ const VALUE_FLAGS = {
   "--company": "company_name",
   "--domain": "company_domain",
   "--website": "website",
+  // Used by `enrich` (email → full profile). Harmless on the other commands,
+  // which simply ignore an unknown query field.
+  "--email": "email",
 };
 // Boolean filter flags (presence => "true"). --verified-only is positive intent
 // only (deliverable contacts); there is deliberately NO flag to query invalid or
@@ -570,6 +573,96 @@ async function cmdReveal(args) {
   }
 }
 
+// ---- enrich: one record in, one record out. Three modes, one endpoint:
+//   --email <addr>                 → the person behind an address (billed like a reveal)
+//   --name "<n>" --domain <d>      → find that person and reveal a verified email
+//   --domain <d>                   → the company profile, free
+// Exit code is part of the contract: a miss returns 0 rows and exits 1, so a
+// script or agent can branch on it without parsing the payload.
+function normalizeDomain(raw) {
+  return String(raw || "")
+    .trim()
+    .replace(/^https?:\/\//i, "")
+    .replace(/^www\./i, "")
+    .split(/[/?#]/, 1)[0]
+    .toLowerCase();
+}
+
+async function cmdEnrich(args) {
+  const key = requireKey();
+  const usage =
+    'usage: argorant enrich --email <name@company.com>\n' +
+    '       argorant enrich --name "Jane Doe" --domain <company.com>\n' +
+    "       argorant enrich --domain <company.com>";
+  const positional = (args._[0] || "").trim();
+  let email = String(args.filters.email || "").trim().toLowerCase();
+  let domain = String(args.filters.company_domain || "").trim();
+  const name = String(args.name || "").trim();
+  // Bare argument: an address is an email, anything else is a domain.
+  if (!email && !domain && positional) {
+    if (positional.includes("@")) email = positional.toLowerCase();
+    else domain = positional;
+  }
+  domain = domain ? normalizeDomain(domain) : "";
+  if (email && !email.includes("@")) die(`--email needs a full address (got "${email}").`);
+  if (!email && !domain) die(usage);
+  if (name && !domain) die(`--name needs --domain (the company the person works at).\n${usage}`);
+  const body = {};
+  if (email) body.email = email;
+  else if (name) { body.name = name; body.domain = domain; }
+  else body.domain = domain;
+  const personMode = Boolean(body.email || body.name);
+  // Company mode is free, so it never asks. Person mode is billed exactly like
+  // a reveal, so it gets the same interactive-only confirmation as `reveal`.
+  if (personMode && !args.yes && !args.json && process.stdin.isTTY) {
+    const ans = await prompt(
+      `Enrich this contact? A match costs 1 credit; a miss and a non-deliverable address are free. [y/N] `
+    );
+    if (!/^y(es)?$/i.test(ans)) return console.log(dim("aborted."));
+  }
+  const res = await request("POST", args.base, "/api/v1/enrich", { key, body });
+  const r = need(res, "enrich");
+  if (args.json) {
+    console.log(JSON.stringify(r, null, 2));
+    if (!r.found) process.exit(EXIT.ERROR);
+    return;
+  }
+  if (!r.found) {
+    console.log(dim(`no ${r.type || (personMode ? "person" : "company")} found · 0 credits charged`));
+    process.exit(EXIT.ERROR);
+  }
+  if (r.type === "company") {
+    const co = r.company || {};
+    console.log(`${bold(co.company || domain)}  ${dim(co.company_domain || domain)}`);
+    const where = [co.city, co.state, co.country].filter(Boolean).join(", ");
+    const what = co.industry || (co.industries || [])[0];
+    if (what) console.log(`  ${what}`);
+    if (where) console.log(`  ${dim(where)}`);
+    console.log(dim("  company profile · 0 credits charged"));
+    return;
+  }
+  const p = r.person || {};
+  const who = [p.full_name || [p.first_name, p.last_name].filter(Boolean).join(" "), p.title].filter(Boolean).join(" · ");
+  console.log(`  ${bold(who || "—")}`);
+  const bits = [
+    p.email && cyan(p.email),
+    p.phone,
+    p.linkedin_url,
+    [p.current_company_name, p.current_company_domain, p.country].filter(Boolean).join(", "),
+  ].filter(Boolean);
+  if (bits.length) console.log("    " + bits.join(dim(" · ")));
+  if (r.deliverable === false) {
+    console.log("    " + dim(r.message || "This address did not pass live verification, so nothing was charged."));
+  }
+  const charged = Number(r.charged || 0);
+  console.log(
+    dim(
+      `    ${charged === 0 ? "0 credits charged" : `${charged} credit${charged === 1 ? "" : "s"} charged`}` +
+        (r.already_revealed ? " · already in your workspace" : "")
+    )
+  );
+}
+
 const EXPORT_TERMINAL_OK = ["completed", "done", "ready", "succeeded"];
 const EXPORT_TERMINAL_FAIL = ["failed", "error", "cancelled", "canceled"];
 
@@ -1351,6 +1444,9 @@ ${bold("COMMANDS")}
   ${cyan("search")} "<query>" -n 10     Preview matches, details redacted ${dim("(0 contact credits)")}
   ${cyan("sample")} <company.com>        Build 25 distinct, live-valid company leads ${dim("(free sample)")}
   ${cyan("reveal")} "<query>" -n 25     Reveal full contact details    ${dim("(uses credits; live-verified, pay only for deliverable)")}
+  ${cyan("enrich")} --email <a@b.com>   One address → the full person profile ${dim("(1 credit per match; miss = free)")}
+  ${cyan("enrich")} --name "<n>" --domain <d>   Find that person + reveal a verified email ${dim("(1 credit per match)")}
+  ${cyan("enrich")} --domain <d>        Company profile                ${dim("(0 contact credits)")}
   ${cyan("export")} "<query>" -n 1000 -o leads.csv   Verified CSV export ${dim("(uses credits)")}
   ${cyan("export status")} <job_id>     Status of an existing export  ${dim("(free; add --batch for >50k)")}
   ${cyan("export download")} <job_id> -o leads.csv   Re-download a finished export ${dim("(free)")}
@@ -1390,6 +1486,7 @@ ${bold("NON-INTERACTIVE USE")} ${dim("(agents, CI, pipes)")}
 ${bold("EXIT CODES")}
   0 ok   ·   1 error   ·   2 not authenticated   ·   3 forbidden (missing scope)
   4 rate limit / daily quota   ·   5 plan upgrade required
+  ${dim("`enrich` exits 1 when nothing matched, so scripts can branch without parsing the payload.")}
 
 ${bold("EXAMPLES")}
   ${p} count "fintech CFOs in germany"
@@ -1397,6 +1494,9 @@ ${bold("EXAMPLES")}
   ${p} search "heads of procurement" --country Germany -n 10
   ${p} sample recruitcrm.io -o sample.csv
   ${p} export --industry fintech --title CFO --country Germany -n 500 -o cfos.csv
+  ${p} enrich --email patrick@stripe.com --json
+  ${p} enrich --name "Patrick Collison" --domain stripe.com
+  ${p} enrich --domain stripe.com
   ${p} verify ceo@stripe.com
   ${p} verify --file my-list.csv -o verified.csv
 
@@ -1430,6 +1530,7 @@ async function main() {
     search: cmdSearch,
     sample: cmdSample,
     reveal: cmdReveal,
+    enrich: cmdEnrich,
     export: cmdExport,
     list: cmdList,
     verify: cmdVerify,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "argorant",
-  "version": "0.5.0",
+  "version": "0.5.1",
   "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"