conduyt 1.26.0 → 1.28.0

package/dist/index.js

@@ -2222,6 +2222,67 @@ ringGroups
 // bottom. Dialing settings + reorder are admin-only in the API.
 // ---------------------------------------------------------------------------
 // ── Custom reports: the Lead Activity grid (reporting P1, 2026-09-10) ──────────────────────────────────────────────
+const dashboards = program.command("dashboards").description("Dashboards: boards of tiles (a saved report as a KPI, chart, table or pivot) with one set of filters for the whole board");
+dashboards
+    .command("list")
+    .description("List the dashboards this key can open")
+    .action(run(async (client) => client.get("/api/v1/dashboards")));
+dashboards
+    .command("create")
+    .description("Create a dashboard from JSON ({ name, description?, filters?: { dateRange, start, end, assignedTo[], sources[] }, isShared? })")
+    .requiredOption("--json <definition>", "the definition as JSON (or @file)")
+    .action(run(async (client, opts) => {
+    const raw = opts.json.startsWith("@") ? (await import("node:fs")).readFileSync(opts.json.slice(1), "utf8") : opts.json;
+    const body = JSON.parse(raw);
+    if (typeof body.name !== "string")
+        throw new Error("The definition needs a name.");
+    return client.post("/api/v1/dashboards", body);
+}));
+dashboards
+    .command("get <id>")
+    .description("One dashboard with its tiles")
+    .action(run(async (client, id) => { assertUuid(id, "dashboard id"); return client.get(`/api/v1/dashboards/${id}`); }));
+dashboards
+    .command("update <id>")
+    .description("Patch a dashboard from JSON (name, description, filters, isShared, tileOrder: [tileId...])")
+    .requiredOption("--json <patch>", "the patch as JSON (or @file)")
+    .action(run(async (client, id, opts) => {
+    assertUuid(id, "dashboard id");
+    const raw = opts.json.startsWith("@") ? (await import("node:fs")).readFileSync(opts.json.slice(1), "utf8") : opts.json;
+    return client.patch(`/api/v1/dashboards/${id}`, JSON.parse(raw));
+}));
+dashboards
+    .command("delete <id>")
+    .description("Delete a dashboard (its tiles go with it; the reports stay)")
+    .action(run(async (client, id) => { assertUuid(id, "dashboard id"); return client.del(`/api/v1/dashboards/${id}`); }));
+dashboards
+    .command("add-tile <id>")
+    .description("Pin a saved report to a dashboard")
+    .requiredOption("--report <reportId>", "saved report id")
+    .requiredOption("--kind <kind>", "kpi | chart | table | pivot")
+    .option("--style <style>", "kpi: ledger | trend | goal; chart: ranked | target | focus")
+    .option("--size <size>", "s | m | l", "m")
+    .option("--title <title>", "tile title (defaults to the report name)")
+    .option("--target <n>", "goal KPI target")
+    .action(run(async (client, id, opts) => {
+    assertUuid(id, "dashboard id");
+    assertUuid(opts.report, "report id");
+    return client.post(`/api/v1/dashboards/${id}/tiles`, { savedReportId: opts.report, kind: opts.kind, style: opts.style, size: opts.size, title: opts.title, target: opts.target !== undefined ? Number(opts.target) : undefined });
+}));
+dashboards
+    .command("update-tile <id> <tileId>")
+    .description("Change a tile from JSON (style, size, title, target; null clears)")
+    .requiredOption("--json <patch>", "the patch as JSON")
+    .action(run(async (client, id, tileId, opts) => { assertUuid(id, "dashboard id"); assertUuid(tileId, "tile id"); return client.patch(`/api/v1/dashboards/${id}/tiles/${tileId}`, JSON.parse(opts.json)); }));
+dashboards
+    .command("remove-tile <id> <tileId>")
+    .description("Remove a tile from a dashboard")
+    .action(run(async (client, id, tileId) => { assertUuid(id, "dashboard id"); assertUuid(tileId, "tile id"); return client.del(`/api/v1/dashboards/${id}/tiles/${tileId}`); }));
+dashboards
+    .command("run <id>")
+    .description("Run every tile with the board filters (or --filters JSON for this run only)")
+    .option("--filters <json>", "board filters for this run")
+    .action(run(async (client, id, opts) => { assertUuid(id, "dashboard id"); return client.post(`/api/v1/dashboards/${id}/run`, opts.filters ? { filters: JSON.parse(opts.filters) } : {}); }));
 const reports = program.command("reports").description("Custom reports: the Lead Activity grid (rollups, custom fields, Smart View populations, CSV/XLSX export)");
 reports
     .command("fields <entity>")
@@ -2238,7 +2299,7 @@ reports
     .action(run(async (client) => client.get("/api/v1/reports/custom")));
 reports
     .command("create")
-    .description("Create a saved report from a JSON definition (name, entity, columns, filters, sortBy, groupBy, groupBy2, aggregate, measureField, population: { smartViewId })")
+    .description("Create a saved report from a JSON definition (name, entity, columns, filters, sortBy, groupBy, groupBy2, aggregate, measureField, population: { smartViewId }); pivot: { rows, columns, measures } for a pivot grid on contacts/deals")
     .requiredOption("--json <definition>", "the definition as JSON (or @file)")
     .action(run(async (client, opts) => {
     const raw = opts.json.startsWith("@") ? (await import("node:fs")).readFileSync(opts.json.slice(1), "utf8") : opts.json;
@@ -2248,6 +2309,19 @@ reports
     }
     return client.post("/api/v1/reports/custom", body);
 }));
+reports
+    .command("update <id>")
+    .description("Update a saved report from a JSON patch (any create field; pivot: { rows: [field, field?], columns: field|null, measures: [{ aggregate, field }] } builds a pivot grid on contacts/deals reports, pivot: null removes it)")
+    .requiredOption("--json <patch>", "the patch as JSON (or @file)")
+    .action(run(async (client, id, opts) => {
+    assertUuid(id, "report id");
+    const raw = opts.json.startsWith("@") ? (await import("node:fs")).readFileSync(opts.json.slice(1), "utf8") : opts.json;
+    const body = JSON.parse(raw);
+    if (!body || typeof body !== "object" || Array.isArray(body) || Object.keys(body).length === 0) {
+        throw new Error("The patch needs at least one field to change.");
+    }
+    return client.patch(`/api/v1/reports/custom/${id}`, body);
+}));
 reports
     .command("run <id>")
     .description("Run a saved report: a page of rows, the total, the metric, the chart data and (with groupBy2) the grouped rows")

package/package.json

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