conduyt 1.73.0 → 1.74.0

package/dist/index.js

@@ -80,11 +80,23 @@ contacts
     .command("list")
     .description("List contacts")
     .option("--limit <n>", "max results")
-    .option("--cursor <cursor>", "pagination cursor")
-    .option("--query <q>", "search query")
+    .option("--page <n>", "page number (default 1; the contacts list pages with page and per_page)")
+    .option("--cursor <cursor>", "not supported on contacts list (the API pages with --page); passing it exits 1 and sends no request")
+    .option("--query <q>", "search text (name, email, phone; sent to the API as `search`)")
+    .option("--email <address>", "exact email lookup, repeatable (--email a@x.com --email b@y.com): matches the primary email or any secondary email slot, trimmed and lower-cased; each address is at most 254 characters; an empty or invalid address, or more than 20 distinct addresses, is a 400; on a workspace whose identifier index is still being built, a lookup whose stored spellings exceed its stored-spelling bind budget is a 422 (a count of spellings, not contacts; other filters do not help)", (v, prev = []) => [...prev, v])
     .option("--master-status <list>", "only these lead statuses, comma-separated (open, won, lost, abandoned, disqualified, or an account custom status)")
     .option("--exclude-master-status <list>", "hide these lead statuses, comma-separated — e.g. won,lost,abandoned,disqualified is the Active view")
-    .action(run(async (client, opts) => client.get(`/api/v1/contacts${buildQuery({ limit: opts.limit, cursor: opts.cursor, query: opts.query, master_status: opts.masterStatus, exclude_master_status: opts.excludeMasterStatus })}`)));
+    .action(run(async (client, opts) => {
+    // the route never reads `cursor` (it pages with page / per_page): refuse before any request instead of silently returning page 1
+    if (opts.cursor !== undefined)
+        throw new Error("contacts list does not support --cursor (the API pages with page and per_page); use --page <n>");
+    // the API reads `search` (there is no `query` param), and every repeated `email` occurrence
+    const qs = new URLSearchParams(buildQuery({ limit: opts.limit, page: opts.page, search: opts.query, master_status: opts.masterStatus, exclude_master_status: opts.excludeMasterStatus }).slice(1));
+    for (const address of opts.email ?? [])
+        qs.append("email", address);
+    const q = qs.toString();
+    return client.get(`/api/v1/contacts${q ? `?${q}` : ""}`);
+}));
 contacts
     .command("get <id>")
     .description("Get a single contact by id (includes `revision`: pass it as --expected-revision on `contacts update` / `contacts collaborators`; `hasOutboundSms` is true when the workspace has ever PROVABLY texted the contact: a proven send only, not a draft, a queued row or a pre-send failure; use it to pick `messages check --context`: false = first, true = conversation; `hasOutboundEmail` is the same for email: true when at least one outbound email to the contact was proven sent, so a genuine \"Re:\" reply is a conversation and not flagged)")

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "conduyt",
-  "version": "1.73.0",
+  "version": "1.74.0",
   "description": "Command-line interface for Conduyt CRM — manage contacts, deals, pipelines, and run insight queries from your terminal.",
   "type": "module",
   "main": "dist/index.js",