conduyt 1.62.0 → 1.63.0

package/README.md

@@ -32,7 +32,10 @@ The saved config lives at `~/.conduyt/config.json` and is written owner-only (`c
 ```bash
 conduyt whoami                          # show the authenticated user
 conduyt contacts list --limit 25        # list contacts (supports --cursor, --query)
-conduyt contacts get <id>               # fetch one contact
+conduyt contacts get <id>               # fetch one contact (carries `revision`)
+conduyt contacts update <id> --first Ann --expected-revision <n>   # PATCH; a contact changed since revision n is refused: 409 contact_changed, exit 1, code and current revision printed
+conduyt contacts collaborators add <contactId> <userId> [--expected-revision <n>]      # POST /contacts/{id}/collaborators; prints { added, revision }
+conduyt contacts collaborators remove <contactId> <userId> [--expected-revision <n>]   # DELETE with a body; prints { removed, revision }; 404 when not a collaborator
 conduyt deals list --pipeline <id>      # list deals
 conduyt deals list --health-summary --pipeline <id>   # Pipeline health strip for the filtered set (totalOpenDeals, atRiskValue, checks[]); add --health-check stale --health-limit 20 for one check's deals, --health-cursor <nextCursor> to page, --health-rows-only for just the page
 conduyt deals health --pipeline <id> --check needs_action   # GET /deals/inspection: the six checks over open deals; --check adds its deals, --cursor/--offset pages

package/dist/client.js

@@ -57,7 +57,14 @@ export class ConduytClient {
             // STAGE_REQUIREMENTS 422 carries lostReasonOptions) keep the context —
             // same principle as `structured` above, bounded against huge bodies.
             if (json && typeof json === "object" && json.error) {
-                const extras = Object.fromEntries(Object.entries(json).filter(([k]) => k !== "error"));
+                // Scalars first (code, revision), nested objects last: a 409 contact_changed also carries the whole current
+                // `contact`, and the bound below may cut that, never the code or the current revision.
+                const isScalar = (v) => v === null || typeof v !== "object";
+                const entries = Object.entries(json).filter(([k]) => k !== "error");
+                const extras = Object.fromEntries([
+                    ...entries.filter(([, v]) => isScalar(v)),
+                    ...entries.filter(([, v]) => !isScalar(v)),
+                ]);
                 if (Object.keys(extras).length > 0) {
                     msg = `${msg} ${JSON.stringify(extras).slice(0, 1000)}`;
                 }
@@ -78,8 +85,9 @@ export class ConduytClient {
     put(path, body, opts) {
         return this.request("PUT", path, body, opts);
     }
-    del(path) {
-        return this.request("DELETE", path);
+    /** `body` is for the few DELETE routes that take one (contact collaborators with an --expected-revision pin). */
+    del(path, body) {
+        return this.request("DELETE", path, body);
     }
     /** A POST whose body comes back as text (a CSV or XLSX export), not JSON. */
     async postText(path, body) {

package/dist/index.js

@@ -9,6 +9,8 @@ import { splitList, stageRulePatch, validateCardFields, validateRuleChange } fro
 import { ARCHIVE_PIPELINE_TIMEOUT_MS, MAILCHIMP_ADMIN_TIMEOUT_MS, STATUS_METADATA_IMPORT_TIMEOUT_MS, PIPELINE_COLORS, boolFlag, intFlag, isoDate, lifecycleStage as lifecycleStageArg, MAX_PIPELINE_ROT_DAYS, MIN_PIPELINE_ROT_DAYS, pipelineColor, settingsRevision, slug as slugArg, uuid as uuidOf, uuidList, validateImportItems, validateStatusMetadataBody } from "./pipeline-settings.js";
 import { saveConfig, resolveConfig, configPath } from "./config.js";
 import { print, fail, unwrap } from "./output.js";
+/** the contact save revision bound (catalog: integer 0..2147483647) */
+const CONTACT_REVISION_MAX = 2147483647;
 // 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
@@ -77,7 +79,7 @@ contacts
     .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 })}`)));
 contacts
     .command("get <id>")
-    .description("Get a single contact by id")
+    .description("Get a single contact by id (includes `revision`: pass it as --expected-revision on `contacts update` / `contacts collaborators`)")
     .action(run(async (client, id) => client.get(`/api/v1/contacts/${encodeURIComponent(id)}`)));
 contacts
     .command("create")
@@ -135,10 +137,13 @@ contacts
     .option("--company <company>", "company name (auto-creates/links a company; pass '' to clear)")
     .option("--source <source>", "correct the lead's first-touch source (normally set once at creation — update only to fix bad attribution; pass 'null' to clear)")
     .option("--master-status <status>", "lead lifecycle status: open|won|lost|abandoned|disqualified or an account custom (terminal statuses silence all outbound automation)")
+    .option("--expected-revision <n>", "the contact's `revision` as you read it (contacts get / list; 0-2147483647): a contact changed since is refused with 409 contact_changed, nothing is written, exit 1 with the code and the current revision printed")
     .option("--json <json>", "full JSON body, merged over the flags above (for any field)")
     .action(run(async (client, id, opts) => {
     assertUuid(id, "contact id");
     const body = {};
+    if (opts.expectedRevision !== undefined)
+        body.expectedRevision = intFlag(opts.expectedRevision, "--expected-revision", 0, CONTACT_REVISION_MAX);
     if (opts.first !== undefined)
         body.firstName = opts.first;
     if (opts.last !== undefined)
@@ -175,6 +180,25 @@ contacts
     assertContactSource(body.source, { allowNull: true });
     return client.patch(`/api/v1/contacts/${encodeURIComponent(id)}`, body);
 }));
+const collaborators = contacts.command("collaborators").description("Team members collaborating on a contact");
+for (const [verb, method] of [["add", "post"], ["remove", "del"]]) {
+    collaborators
+        .command(`${verb} <contactId> <userId>`)
+        .description(verb === "add"
+        ? "Add a team member as a collaborator (POST /contacts/{id}/collaborators; needs edit authority). Prints { added, revision } with the contact's NEW revision. A stale --expected-revision is 409 contact_changed (exit 1, code and current revision printed); 409 without a code: already a collaborator"
+        : "Remove a collaborator (DELETE /contacts/{id}/collaborators with a body; needs edit authority). Prints { removed, revision } with the contact's NEW revision. A stale --expected-revision is 409 contact_changed (exit 1, code and current revision printed); 404 when the user is not a collaborator")
+        .option("--expected-revision <n>", "the contact's `revision` as you read it (0-2147483647); omit for no pin")
+        .action(run(async (client, contactId, userId, opts) => {
+        assertUuid(contactId, "contact id");
+        if (userId.trim() === "")
+            throw new Error("userId must not be blank.");
+        const body = { userId };
+        if (opts.expectedRevision !== undefined)
+            body.expectedRevision = intFlag(opts.expectedRevision, "--expected-revision", 0, CONTACT_REVISION_MAX);
+        const path = `/api/v1/contacts/${encodeURIComponent(contactId)}/collaborators`;
+        return method === "post" ? client.post(path, body) : client.del(path, body);
+    }));
+}
 contacts
     .command("delete <id>")
     .description("Delete a contact by id (soft-delete; retained for audit, the contact's deals are unaffected)")

package/package.json

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