conduyt 1.58.0 → 1.59.0

package/README.md

@@ -34,6 +34,7 @@ conduyt whoami                          # show the authenticated user
 conduyt contacts list --limit 25        # list contacts (supports --cursor, --query)
 conduyt contacts get <id>               # fetch one contact
 conduyt deals list --pipeline <id>      # list deals
+conduyt deals bulk-update --file updates.json   # update up to 100 deals at once ([{id, stageId, value, ...}]); per-item results, exit 1 if any failed
 conduyt pipelines                       # list pipelines and stages
 conduyt search "acme corp"              # search across the CRM
 conduyt insights summary                # run an AI insight query

package/dist/index.js

@@ -6,7 +6,7 @@ import { dirname, join } from "node:path";
 import { Command } from "commander";
 import { ConduytClient, buildQuery } from "./client.js";
 import { saveConfig, resolveConfig, configPath } from "./config.js";
-import { print, fail } from "./output.js";
+import { print, fail, unwrap } from "./output.js";
 // Exit cleanly when a downstream pipe closes early (e.g. `conduyt deals list |
 // head`). Without this, the stdout write after the reader is gone throws an
 // unhandled EPIPE and prints a Node stack trace — broken-pipe is normal Unix
@@ -561,6 +561,73 @@ deals
     assertUuid(id, "deal id");
     return client.del(`/api/v1/deals/${encodeURIComponent(id)}`);
 }));
+deals
+    .command("bulk-update")
+    .description("Update up to 100 deals in one request (POST /bulk/deals/update). Pass a JSON array of { id, ...editable fields (title, stageId, value, currency, status, priority, assignedTo, expectedCloseDate, lostReason, customFields) } via --updates or --file. Each item is applied on its own; prints the summary and one result per item, and exits 1 when any item failed (the full result is still printed). Rate limited to 5 requests a minute")
+    .option("--updates <json>", "the updates as a JSON array (or @file)")
+    .option("--file <path>", "read the updates JSON array from a file")
+    .action(async (opts) => {
+    try {
+        if (opts.updates !== undefined && opts.file !== undefined)
+            throw new Error("Pass either --updates or --file, not both.");
+        let raw;
+        if (opts.file !== undefined) {
+            if (opts.file.trim() === "")
+                throw new Error("--file must be a path (got an empty string).");
+            try {
+                raw = readFileSync(opts.file, "utf8");
+            }
+            catch {
+                throw new Error(`--file could not be read: ${opts.file}`);
+            }
+        }
+        else if (opts.updates !== undefined) {
+            raw = opts.updates.startsWith("@") ? readFileSync(opts.updates.slice(1), "utf8") : opts.updates;
+        }
+        else {
+            throw new Error("The updates are required. Pass --updates '<json array>' or --file <path>.");
+        }
+        let updates;
+        try {
+            updates = JSON.parse(raw);
+        }
+        catch {
+            throw new Error("The updates must be valid JSON (an array of { id, ...fields }).");
+        }
+        if (!Array.isArray(updates))
+            throw new Error("The updates must be a JSON array of { id, ...fields } objects.");
+        const client = new ConduytClient();
+        const res = await client.post("/api/v1/bulk/deals/update", { updates });
+        print(res);
+        const data = unwrap(res);
+        const results = data && typeof data === "object" && Array.isArray(data.results) ? data.results : null;
+        const sm = data && typeof data === "object" && data.summary && typeof data.summary === "object" && !Array.isArray(data.summary) ? data.summary : null;
+        const n = updates.length;
+        const shapeOk = !!sm && !!results &&
+            typeof sm.total === "number" && typeof sm.succeeded === "number" && typeof sm.failed === "number" &&
+            sm.total === n && results.length === n &&
+            results.every((r) => r && typeof r === "object" && typeof r.success === "boolean" && typeof r.id === "string") &&
+            // The ids that came back must be exactly the ids submitted (order-independent, duplicates count);
+            // an item sent without a string id is answered as "unknown".
+            JSON.stringify(updates.map((u) => (u && typeof u.id === "string" ? u.id : "unknown")).sort()) ===
+                JSON.stringify(results.map((r) => r.id).sort());
+        if (!shapeOk) {
+            process.stderr.write(`Error: Unexpected response shape from the API: expected data.summary {total, succeeded, failed} and ${n} data.results with id and success.\n`);
+            process.exitCode = 1;
+            return;
+        }
+        const failedItems = results.filter((r) => r.success === false);
+        if (failedItems.length > 0 || Number(sm.failed) > 0) {
+            for (const r of failedItems)
+                process.stderr.write(`Failed ${r.id}: ${r.error ?? "unknown error"}\n`);
+            process.stderr.write(`Error: ${failedItems.length || sm.failed} of ${sm.total} updates failed.\n`);
+            process.exitCode = 1;
+        }
+    }
+    catch (err) {
+        fail(err);
+    }
+});
 // ---- pipelines ----
 // Default action preserves the original published `conduyt pipelines` (list)
 // invocation now that pipelines is a group — without it, commander prints help
@@ -953,7 +1020,7 @@ messages
 })}`)));
 messages
     .command("send")
-    .description("Log/create a message (POST /messages). NOTE: outbound SMS is rejected here — use `messages send-sms` for real SMS delivery. An inbound SMS STOP or START with --from records that number's opt-out or opt-in (STOP also stops the contact's sequences and drips); the answer then carries smsConsent {keyword, fromNumber, applied, reason: number_not_on_contact | number_not_canonicalizable}")
+    .description("Log/create a message (POST /messages). NOTE: outbound SMS is rejected here — use `messages send-sms` for real SMS delivery. An inbound SMS STOP or START with --from records that number's opt-out or opt-in: STOP blocks only the --from number; only when --from is the contact's PRIMARY number does STOP also end the contact's drips and the SMS sequences configured to stop on opt-out (autoUnenrollOnUnsubscribe) — a secondary number's STOP blocks that number alone, nothing else. The answer then carries smsConsent {keyword, fromNumber, applied, reason: number_not_on_contact | number_not_canonicalizable}")
     .option("--contact <id>", "contact UUID (required)")
     .option("--channel <channel>", "sms | email (required)")
     .option("--direction <direction>", "inbound | outbound (required)")

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "conduyt",
-  "version": "1.58.0",
+  "version": "1.59.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",