conduyt 1.43.0 → 1.45.0

package/dist/index.js

@@ -960,6 +960,109 @@ fromk
         throw new Error("Pass --secret or set FROMK_WEBHOOK_SECRET (or --clear).");
     return client.put("/api/v1/settings/fromk/webhook", { secret });
 }));
+// ---- Zoom (Conduyt #72, 2026-09-15): one Zoom meeting per booking ----
+const zoom = program.command("zoom").description("Zoom: the account's Server-to-Server OAuth app; booking pages set to Zoom create one meeting per booking, delete it on cancel, move it on reschedule (settings scope)");
+zoom
+    .command("status")
+    .description("Connection status (GET /settings/zoom): connected | not_configured, the account id and client id masked; the client secret is never returned")
+    .action(run(async (client) => client.get("/api/v1/settings/zoom")));
+zoom
+    .command("connect")
+    .description("Connect or replace the Server-to-Server app (scopes meeting:write/read/update/delete:meeting:admin + user:read:user:admin) — verified with Zoom before it is stored; answers the app's own user = the default meeting host")
+    .option("--account-id <id>", "Zoom account id; omit to read ZOOM_ACCOUNT_ID from the environment")
+    .option("--client-id <id>", "Zoom client id; omit to read ZOOM_CLIENT_ID")
+    .option("--client-secret <secret>", "Zoom client secret; omit to read ZOOM_CLIENT_SECRET and keep it out of shell history")
+    .option("--force", "replace the app although upcoming bookings still hold meetings the current app created (409 zoom_meetings_active otherwise; those meetings stay on the old Zoom account)")
+    .action(run(async (client, opts) => {
+    const accountId = (opts.accountId ?? process.env.ZOOM_ACCOUNT_ID ?? "").trim();
+    const clientId = (opts.clientId ?? process.env.ZOOM_CLIENT_ID ?? "").trim();
+    const clientSecret = (opts.clientSecret ?? process.env.ZOOM_CLIENT_SECRET ?? "").trim();
+    if (!accountId || !clientId || !clientSecret)
+        throw new Error("Pass --account-id, --client-id and --client-secret (or set ZOOM_ACCOUNT_ID / ZOOM_CLIENT_ID / ZOOM_CLIENT_SECRET).");
+    return client.put("/api/v1/settings/zoom", { accountId, clientId, clientSecret, ...(opts.force ? { force: true } : {}) });
+}));
+zoom
+    .command("disconnect")
+    .description("Forget the app; booking pages set to Zoom fall back to their written location. Refused (409 zoom_meetings_active) while upcoming bookings hold meetings this app created unless --force")
+    .option("--force", "disconnect anyway; those meetings stay on the Zoom account and cancellations record zoom_orphaned")
+    .action(run(async (client, opts) => client.del(`/api/v1/settings/zoom${opts.force ? "?force=1" : ""}`)));
+zoom
+    .command("test")
+    .description("Prove the stored app works (a token is issued, the app's user answers); --host also proves that user belongs to the Zoom account (the value a booking page's --video-host must be). Read-only on Zoom")
+    .option("--host <email>", "a Zoom user of the connected account to verify as a meeting host")
+    .action(run(async (client, opts) => client.post("/api/v1/settings/zoom/test", opts.host ? { hostEmail: opts.host } : {})));
+// ---- Booking pages (Conduyt #72, 2026-09-15): the public scheduling pages and their video option ----
+const bookingPages = program.command("booking-pages").description("Booking pages: the public scheduling pages (slug, host, duration, availability, embed origins) and their video option (calendar scope)");
+bookingPages
+    .command("list")
+    .description("List the account's booking pages (GET /booking-pages)")
+    .option("--active", "only active pages")
+    .action(run(async (client, opts) => client.get(`/api/v1/booking-pages${opts.active ? "?is_active=true" : ""}`)));
+bookingPages
+    .command("get <id>")
+    .description("One booking page with every setting (GET /booking-pages/:id)")
+    .action(run(async (client, id) => client.get(`/api/v1/booking-pages/${id}`)));
+const bookingPageBody = (opts) => {
+    const body = {};
+    const set = (key, value) => { if (value !== undefined)
+        body[key] = value; };
+    set("title", opts.title);
+    set("slug", opts.slug);
+    set("description", opts.description);
+    set("userId", opts.host);
+    set("location", opts.location);
+    if (opts.videoProvider !== undefined)
+        set("videoProvider", opts.videoProvider === "none" ? null : opts.videoProvider);
+    if (opts.videoHost !== undefined)
+        set("videoHostEmail", opts.videoHost === "none" ? null : opts.videoHost);
+    if (opts.duration !== undefined)
+        set("durationMinutes", Number(opts.duration));
+    if (opts.minimumNotice !== undefined)
+        set("minimumNotice", Number(opts.minimumNotice));
+    if (opts.maxAdvanceDays !== undefined)
+        set("maxAdvanceDays", Number(opts.maxAdvanceDays));
+    set("leadSource", opts.leadSource);
+    set("brandName", opts.brandName);
+    if (typeof opts.embedOrigins === "string")
+        set("embedAllowedOrigins", opts.embedOrigins.split(",").map((o) => o.trim()).filter(Boolean));
+    if (typeof opts.availability === "string")
+        set("availabilityRules", JSON.parse(opts.availability));
+    if (opts.active !== undefined)
+        set("isActive", opts.active);
+    return body;
+};
+const bookingPageOptions = (cmd) => cmd
+    .option("--title <title>", "page title")
+    .option("--slug <slug>", "public slug (conduyt.app/book/<slug>)")
+    .option("--description <text>", "description shown on the page")
+    .option("--host <userId>", "host user UUID (the page owner)")
+    .option("--duration <minutes>", "slot length in minutes")
+    .option("--minimum-notice <minutes>", "earliest booking, minutes from now")
+    .option("--max-advance-days <days>", "how far ahead visitors may book")
+    .option("--location <text>", "written location (Zoom link, phone, address); with --video-provider zoom it is the fallback when Zoom is down")
+    .option("--video-provider <zoom|none>", "zoom = a new Zoom meeting for every booking (needs `conduyt zoom connect`); none = the written location only")
+    .option("--video-host <email|none>", "the Zoom user the meeting is created under (a user of the connected Zoom account); none = the app's own user")
+    .option("--lead-source <source>", "lead source stamped on contacts the page creates")
+    .option("--brand-name <name>", "white-label name shown on the page and in Zoom meeting names")
+    .option("--embed-origins <origins>", "comma-separated origins allowed to embed/call the page (empty = any)")
+    .option("--availability <json>", "AvailabilityWindow[] JSON override, e.g. '[{\"dayOfWeek\":1,\"startTime\":\"09:00\",\"endTime\":\"11:00\"}]'")
+    .option("--active", "page accepts bookings")
+    .option("--no-active", "page stops accepting bookings");
+bookingPageOptions(bookingPages.command("create").description("Create a booking page (POST /booking-pages): --title, --slug, --host and --duration at least"))
+    .action(run(async (client, opts) => {
+    const body = bookingPageBody(opts);
+    for (const k of ["title", "slug", "userId", "durationMinutes"])
+        if (body[k] === undefined)
+            throw new Error(`--${k === "userId" ? "host" : k === "durationMinutes" ? "duration" : k} is required`);
+    return client.post("/api/v1/booking-pages", body);
+}));
+bookingPageOptions(bookingPages.command("update <id>").description("Update a booking page (PATCH /booking-pages/:id): only the options given change"))
+    .action(run(async (client, id, opts) => {
+    const body = bookingPageBody(opts);
+    if (Object.keys(body).length === 0)
+        throw new Error("Nothing to update: pass at least one option.");
+    return client.patch(`/api/v1/booking-pages/${id}`, body);
+}));
 // ---- WhatsApp via Twilio (2026-09-11) ----
 const whatsapp = program.command("whatsapp").description("WhatsApp via your own Twilio account: a Meta-approved sender, approved templates for outreach, free-form replies within a contact's 24-hour window");
 whatsapp
@@ -1305,6 +1408,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.43.0",
+  "version": "1.45.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",