conduyt 1.42.0 → 1.44.0

package/dist/index.js

@@ -180,6 +180,123 @@ contacts
     return client.del(`/api/v1/contacts/${encodeURIComponent(id)}`);
 }));
 // ---- deals ----
+contacts
+    .command("delete-matching")
+    .description("Soft-delete EVERY contact a list filter matches, across pages (#73): the contacts page's \"Select all N matching\" action. Give the same filter you would give `contacts list` (or --filter with a JSON object of list query parameters) plus --expected, the total that filter showed; the server re-counts and refuses (409) when the set moved, so you never delete rows you did not look at. Contacts with an upcoming appointment are kept and reported. The command repeats the call until the server reports done. Requires contacts:delete.")
+    .option("--search <text>", "free-text search")
+    .option("--tag <name>", "one tag")
+    .option("--tags <names>", "comma-separated tags")
+    .option("--source <source>", "lead source")
+    .option("--assigned-to <userId>", "assignee user id")
+    .option("--smart-view <id>", "Smart View id")
+    .option("--smart-list <id>", "Smart List id")
+    .option("--import-id <id>", "import job id")
+    .option("--master-status <statuses>", "comma-separated lead statuses to include")
+    .option("--filter <json>", "a JSON object of list query parameters (merged over the flags above)")
+    .requiredOption("--expected <n>", "the total the list showed for this filter")
+    .option("--yes", "skip the typed confirmation (scripts)")
+    .action(run(async (client, opts) => {
+    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.source === "string")
+        filter.source = opts.source;
+    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") {
+        let parsed;
+        try {
+            parsed = JSON.parse(opts.filter);
+        }
+        catch {
+            throw new Error("--filter must be a JSON object of list query parameters.");
+        }
+        if (!parsed || typeof parsed !== "object" || Array.isArray(parsed))
+            throw new Error("--filter must be a JSON object of list query parameters.");
+        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("Narrow the delete with at least one filter value; deleting 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.");
+    if (!opts.yes) {
+        const { createInterface } = await import("node:readline/promises");
+        const rl = createInterface({ input: process.stdin, output: process.stderr });
+        const answer = (await rl.question(`Delete all ${expected} contacts matching this filter? Type the number ${expected} to confirm: `)).trim();
+        rl.close();
+        if (answer !== String(expected))
+            throw new Error("Cancelled: the typed number did not match.");
+    }
+    // The first call freezes the set on the server (409 when the count moved or when shared rows are not
+    // yours to delete); every later pass sends back the ids the server returned, never the filter again.
+    let body = { filter, expectedTotal: expected };
+    let deleted = 0;
+    let skipped = 0;
+    let kept = 0;
+    let last = {};
+    // A continuation that fails for a retryable reason (429 honouring retryAfter, a 5xx, a network error) is
+    // retried with the SAME ids so committed progress is never stranded.
+    const postWithRetry = async (payload) => {
+        for (let attempt = 0;; attempt++) {
+            try {
+                return (await client.post("/api/v1/bulk/contacts/delete-matching", payload));
+            }
+            catch (err) {
+                const msg = err instanceof Error ? err.message : String(err);
+                const status = Number(/^Conduyt API (\d{3})/.exec(msg)?.[1] ?? 0);
+                const retryable = "ids" in payload && (status === 429 || status >= 500 || status === 0);
+                if (!retryable || attempt >= 5)
+                    throw err;
+                const retryAfter = Number(/"retryAfter":(\d+)/.exec(msg)?.[1] ?? 0);
+                await new Promise((r) => setTimeout(r, status === 429 ? Math.max(5, Math.min(60, retryAfter)) * 1000 : 2000 * (attempt + 1)));
+            }
+        }
+    };
+    for (let pass = 0; pass < 200; pass++) {
+        const res = await postWithRetry(body);
+        const d = (res?.data ?? res);
+        last = d;
+        deleted += Number(d.deleted ?? 0);
+        skipped += Number(d.skipped ?? 0);
+        kept += Number(d.keptWithAppointments ?? 0);
+        const remainingIds = Array.isArray(d.remainingIds) ? d.remainingIds : [];
+        if (d.done || remainingIds.length === 0)
+            break;
+        if (!d.busy && Number(d.deleted ?? 0) === 0)
+            break;
+        if (d.busy)
+            await new Promise((r) => setTimeout(r, 1500));
+        body = { ids: remainingIds, continuation: d.continuation ?? null };
+    }
+    const remaining = Number(last.remaining ?? 0);
+    return {
+        deleted,
+        skipped,
+        keptWithAppointments: kept,
+        done: last.done === true,
+        remaining,
+        ...(remaining > 0 ? { note: "the run stopped before finishing; run the same command again (with the new --expected) to delete the rest" } : {}),
+    };
+}));
 const deals = program.command("deals").description("Manage deals");
 deals
     .command("list")
@@ -1188,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.42.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",