@zeegme/cli 0.3.0 → 0.4.0

package/README.md

@@ -61,6 +61,7 @@ Plain `http` is accepted for `localhost` only. Each origin keeps its own login.
 | `zeeg crm list <people\|companies\|slug> [--search <text>]` | CRM records |
 | `zeeg crm get <object> <id>` | One CRM record |
 | `zeeg crm upsert <object> --match <attribute> --data <json>` | Create a record, or update the one that matches |
+| `zeeg crm update <object> --data <json>` | Update many records by `id`, up to 50 per request |
 | `zeeg forms list` / `submissions [--form]` | Routing forms and their submissions |
 | `zeeg calls start <agentUuid> --phone [--name --email --data --at]` | Have an AI phone agent call someone |
 | `zeeg agents list`, `zeeg agents calls <agentUuid>`, `zeeg agents call <callId>` | AI phone agents, their calls, and one call with its transcript |
@@ -74,6 +75,7 @@ zeeg availability 5c7e… --from 2026-10-05 --to 2026-10-09 --tz Europe/Berlin
 zeeg bookings create 5c7e… --date 2026-10-06 --time 14:30 --tz Europe/Berlin \
   --name "Sophie Laurent" --email sophie@northwind.io
 zeeg crm upsert people --match emails --data '{"firstName":"Sophie","emails":["sophie@northwind.io"]}'
+zeeg crm update people --data '[{"id":"9b1c…","jobTitle":"CTO"},{"id":"a77e…","contactOwnerMemberId":42}]'
 ```
 
 ## JSON output

package/dist/commands/crm.js

@@ -1,6 +1,6 @@
 import { unwrap } from '../api/client.js';
-import { UsageError } from '../errors.js';
-import { asJson, jsonArgument, positiveInt } from './util.js';
+import { ApiError, UsageError } from '../errors.js';
+import { asJson, jsonArgument, positiveInt, readJsonText } from './util.js';
 /** `people` and `companies` have their own endpoints; anything else is a custom object slug. */
 async function list(api, object, query) {
     if (object === 'people') {
@@ -38,6 +38,94 @@ async function upsert(api, object, matchingAttribute, body) {
         body: body,
     })));
 }
+/** The most records one bulk request takes; longer inputs are sent as several requests. */
+const BULK_UPDATE_LIMIT = 50;
+/** `[{ id, ...fields }]` or `{ records: [{ id, ...fields }] }`, as inline JSON or `@file.json`. */
+async function parseUpdateRecords(raw) {
+    const text = await readJsonText(raw);
+    let value;
+    try {
+        value = JSON.parse(text);
+    }
+    catch {
+        throw new UsageError('--data must be JSON, inline or as @file.json.');
+    }
+    const records = Array.isArray(value) ? value : asJson(value).records;
+    if (!Array.isArray(records) || records.length === 0) {
+        throw new UsageError('--data must be a non-empty array of { "id": …, …fields } objects, or { "records": [...] }.');
+    }
+    records.forEach((record, index) => {
+        if (record === null || typeof record !== 'object' || Array.isArray(record) || typeof record.id !== 'string' || record.id === '') {
+            throw new UsageError(`Record ${index + 1} must be an object with the "id" of the record to update.`);
+        }
+    });
+    const seen = new Set();
+    // The API compares ids ignoring case and refuses the whole request on a repeat.
+    for (const { id } of records) {
+        if (seen.has(id.toLowerCase())) {
+            throw new UsageError(`The id ${id} appears more than once.`);
+        }
+        seen.add(id.toLowerCase());
+    }
+    return records;
+}
+function chunk(items, size) {
+    const chunks = [];
+    for (let start = 0; start < items.length; start += size) {
+        chunks.push(items.slice(start, start + size));
+    }
+    return chunks;
+}
+function sender(api, object) {
+    return async (batch) => {
+        const body = { records: batch };
+        return object === 'people'
+            ? unwrap(api.PATCH('/crm/people', { body }))
+            : object === 'companies'
+                ? unwrap(api.PATCH('/crm/companies', { body }))
+                : unwrap(api.PATCH('/crm/{objectSlug}', { params: { path: { objectSlug: object } }, body }));
+    };
+}
+/** The field messages of a validation failure, else the error's message. */
+function errorText(error) {
+    const fields = Object.values(asJson(error.errors)).flat();
+    return fields.length > 0 ? fields.join(' ') : error.message;
+}
+/**
+ * Sends the records in requests of at most 50 and prints one row per record, in input order.
+ * When a request fails, the rows of the earlier requests are still printed and the records
+ * that were never sent are listed as `not sent`, so the caller knows what was saved. Throws
+ * when a request failed or any record was not updated.
+ */
+export async function updateRecords(send, records, print) {
+    const rows = [];
+    let sent = 0;
+    let failure;
+    for (const batch of chunk(records, BULK_UPDATE_LIMIT)) {
+        try {
+            const results = (asJson(await send(batch)).results ?? []);
+            rows.push(...results.map((row) => ({ ...row, result: row.updated === true ? 'updated' : 'failed' })));
+            sent += batch.length;
+        }
+        catch (error) {
+            failure = error;
+            break;
+        }
+    }
+    rows.push(...records.slice(sent).map((record) => ({ id: record.id, result: 'not sent' })));
+    print.list(rows, [
+        { header: 'id', value: (row) => row.id },
+        { header: 'result', value: (row) => row.result },
+        { header: 'error', value: (row) => errorText(asJson(row.error)) },
+    ]);
+    if (failure !== undefined) {
+        throw failure;
+    }
+    const failed = rows.filter((row) => row.result !== 'updated').length;
+    if (failed > 0) {
+        throw new ApiError(`${failed} of ${rows.length} records were not updated.`);
+    }
+}
 /** The record inside a get/upsert answer, whatever key the endpoint wraps it in. */
 function recordOf(data) {
     const inner = asJson(data.data ?? data);
@@ -93,4 +181,13 @@ export function registerCrm(program, context) {
         const record = recordOf(data);
         ctx.print.record(record, `Saved ${object} record ${record.id ?? ''}.`.replace(' .', '.'));
     });
+    crm
+        .command('update <object>')
+        .description(`Update many CRM records in one go, up to 50 per request (${objectHelp})`)
+        .requiredOption('--data <json>', 'a JSON array of { "id": …, …fields } objects, inline or as @file.json')
+        .action(async (object, options) => {
+        const records = await parseUpdateRecords(options.data);
+        const ctx = context();
+        await updateRecords(sender(await ctx.api(), object), records, ctx.print);
+    });
 }

package/dist/commands/util.js

@@ -31,11 +31,15 @@ export function clockTime(name) {
 export function collect(value, previous = []) {
     return [...previous, value];
 }
-/** `--data '{"a":1}'` or `--data @record.json`. */
-export async function jsonArgument(raw) {
-    const text = raw.startsWith('@') ? await readFile(raw.slice(1), 'utf8').catch(() => {
+/** The text of an inline argument, or of the file when it is written `@file.json`. */
+export async function readJsonText(raw) {
+    return raw.startsWith('@') ? readFile(raw.slice(1), 'utf8').catch(() => {
         throw new UsageError(`Could not read ${raw.slice(1)}.`);
     }) : raw;
+}
+/** `--data '{"a":1}'` or `--data @record.json`. */
+export async function jsonArgument(raw) {
+    const text = await readJsonText(raw);
     try {
         const value = JSON.parse(text);
         if (value === null || typeof value !== 'object' || Array.isArray(value)) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@zeegme/cli",
-  "version": "0.3.0",
+  "version": "0.4.0",
   "description": "The Zeeg command line: bookings, availability, notes, CRM, routing forms and AI phone calls from your terminal.",
   "license": "MIT",
   "type": "module",