conduyt 1.43.0 → 1.44.0

package/dist/index.js

@@ -1305,6 +1305,142 @@ automations
     return client.get(path);
 }));
 // ---- companies ----
+// ─── Run Batch (#80) ───────────────────────────────────────────────────────
+const batch = program.command("batch").description("Run Batch: one logged task on many contacts (enroll, delete, add-tag, remove-tag, assign, distribute, set-source, set-status), with progress and cancel; admins and owners only");
+batch
+    .command("create")
+    .description("Queue a Run Batch. Pick the contacts with --ids, or freeze EVERY contact a list filter matches with the same flags as `contacts list` plus --expected (the total the list showed; the server refuses with 409 when the set moved). One task per run: enroll (--workflow), delete, add-tag/remove-tag (--tag-id), assign (--user), distribute (--users, round robin), set-source (--source), set-status (--status). No undo; `batch cancel` stops a run.")
+    .requiredOption("--name <name>", "a name for the run")
+    .requiredOption("--task <task>", "enroll | delete | add-tag | remove-tag | assign | distribute | set-source | set-status")
+    .option("--workflow <automationId>", "enroll: the published workflow id")
+    .option("--tag-id <tagId>", "add-tag / remove-tag: the tag id")
+    .option("--user <userId>", "assign: one rep")
+    .option("--users <userIds>", "distribute: comma-separated rep ids (2–50), rotated in order")
+    .option("--source <source>", "set-source: the new lead source (overwrites)")
+    .option("--status <status>", "set-status: one of the account's lead statuses")
+    .option("--comment <text>", "why this run (stored with it)")
+    .option("--ids <contactIds>", "comma-separated contact ids (instead of a filter)")
+    .option("--search <text>", "filter: free-text search")
+    .option("--tag <name>", "filter: one tag")
+    .option("--tags <names>", "filter: comma-separated tags")
+    .option("--filter-source <source>", "filter: lead source")
+    .option("--assigned-to <userId>", "filter: assignee user id")
+    .option("--smart-view <id>", "filter: Smart View id")
+    .option("--smart-list <id>", "filter: Smart List id")
+    .option("--import-id <id>", "filter: import job id")
+    .option("--master-status <statuses>", "filter: comma-separated lead statuses to include")
+    .option("--filter <json>", "filter: a JSON object of list query parameters (merged over the filter flags)")
+    .option("--expected <n>", "filter: the total the list showed for this filter (required with a filter)")
+    .action(run(async (client, opts) => {
+    const TASKS = { enroll: "enroll", delete: "delete", "add-tag": "add_tag", "remove-tag": "remove_tag", assign: "assign", distribute: "assign", "set-source": "set_source", "set-status": "set_status" };
+    const task = String(opts.task ?? "");
+    const operation = TASKS[task];
+    if (!operation)
+        throw new Error("--task must be one of: enroll, delete, add-tag, remove-tag, assign, distribute, set-source, set-status");
+    const params = {};
+    if (task === "add-tag" || task === "remove-tag") {
+        if (!opts.tagId)
+            throw new Error(`--tag-id is required for ${task}`);
+        params.tagId = opts.tagId;
+    }
+    else if (task === "assign") {
+        if (!opts.user)
+            throw new Error("--user is required for assign (use distribute with --users for a pool)");
+        params.userId = opts.user;
+    }
+    else if (task === "distribute") {
+        const users = csvArg(opts.users ?? "", "--users");
+        if (users.length < 2)
+            throw new Error("--users needs at least 2 rep ids for distribute");
+        params.userIds = users;
+    }
+    else if (task === "set-source") {
+        if (!opts.source?.trim())
+            throw new Error("--source is required for set-source");
+        params.source = opts.source.trim();
+    }
+    else if (task === "set-status") {
+        if (!opts.status?.trim())
+            throw new Error("--status is required for set-status");
+        params.status = opts.status.trim();
+    }
+    else if (task === "enroll" && !opts.workflow) {
+        throw new Error("--workflow is required for enroll");
+    }
+    const body = { name: opts.name, operation, ...(task === "enroll" ? { automationId: opts.workflow } : {}), ...(Object.keys(params).length ? { params } : {}), ...(opts.comment ? { comment: opts.comment } : {}) };
+    if (opts.ids) {
+        body.contactIds = csvArg(opts.ids, "--ids");
+    }
+    else {
+        const filter = {};
+        if (typeof opts.search === "string")
+            filter.search = opts.search;
+        if (typeof opts.tag === "string")
+            filter.tag = opts.tag;
+        if (typeof opts.tags === "string")
+            filter.tags = opts.tags;
+        if (typeof opts.filterSource === "string")
+            filter.source = opts.filterSource;
+        if (typeof opts.assignedTo === "string")
+            filter.assigned_to = opts.assignedTo;
+        if (typeof opts.smartView === "string")
+            filter.smart_view = opts.smartView;
+        if (typeof opts.smartList === "string")
+            filter.smartListId = opts.smartList;
+        if (typeof opts.importId === "string")
+            filter.import_id = opts.importId;
+        if (typeof opts.masterStatus === "string")
+            filter.master_status = opts.masterStatus.split(",").map((s) => s.trim()).filter(Boolean);
+        if (typeof opts.filter === "string") {
+            const parsed = jsonArg(opts.filter, "--filter");
+            for (const [k, v] of Object.entries(parsed)) {
+                if (typeof v === "string" || (Array.isArray(v) && v.every((x) => typeof x === "string")))
+                    filter[k] = v;
+                else
+                    throw new Error(`--filter.${k} must be a string or an array of strings.`);
+            }
+        }
+        const hasValue = Object.values(filter).some((v) => (Array.isArray(v) ? v.some((x) => x.trim()) : v.trim()));
+        if (!hasValue)
+            throw new Error("Give --ids, or at least one filter value; a run over every contact is not a bulk action.");
+        const expected = Number(opts.expected);
+        if (!Number.isInteger(expected) || expected < 1)
+            throw new Error("--expected must be the positive whole number the list showed for this filter.");
+        body.filter = filter;
+        body.expectedTotal = expected;
+    }
+    return client.post("/api/v1/batch-operations", body);
+}));
+batch
+    .command("list")
+    .description("List Run Batch runs (newest first) with their task, status and progress")
+    .option("--status <status>", "queued | running | completed | cancelled | failed")
+    .option("--page <n>", "page number", "1")
+    .option("--limit <n>", "rows per page (max 50)", "20")
+    .action(run(async (client, opts) => {
+    const qp = new URLSearchParams({ page: opts.page, limit: opts.limit });
+    if (opts.status)
+        qp.set("status", opts.status);
+    return client.get(`/api/v1/batch-operations?${qp.toString()}`);
+}));
+batch
+    .command("get <id>")
+    .description("One run with its per-contact items (success / error / skipped, with the reason)")
+    .option("--item-status <status>", "all | pending | success | error | skipped", "all")
+    .option("--page <n>", "item page", "1")
+    .option("--limit <n>", "items per page (max 50)", "20")
+    .action(run(async (client, id, opts) => {
+    assertUuid(id);
+    const qp = new URLSearchParams({ itemStatus: opts.itemStatus, page: opts.page, limit: opts.limit });
+    return client.get(`/api/v1/batch-operations/${id}?${qp.toString()}`);
+}));
+batch
+    .command("cancel <id>")
+    .description("Stop a queued or running run; contacts already processed stay as they are (no undo)")
+    .action(run(async (client, id) => {
+    assertUuid(id);
+    return client.post(`/api/v1/batch-operations/${id}/cancel`, {});
+}));
 const companies = program.command("companies").description("Manage companies");
 companies
     .command("list")

package/package.json

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