conduyt 1.42.0 → 1.43.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")

package/package.json

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