@graph8/sdk 0.15.0 → 0.17.0

package/dist/react.d.mts

@@ -1642,11 +1642,14 @@ interface DealUpdateParams {
      */
     close_date?: string | null;
     /**
-     * Reassign the deal owner (user id or email). Pass null to clear, except on
-     * a deal sitting in a closed stage (HTTP 400, marker
-     * `owner_required_for_closed_stage`).
+     * Reassign the deal owner. Pass a member id, email, or provider uid — it is
+     * resolved to a real team member (HTTP 422 if it matches none). Omit to
+     * leave the owner unchanged. Ownership is reassign-only and CANNOT be
+     * cleared: passing `null` is rejected with HTTP 422 (#18469). A deal's owner
+     * is a required invariant. (The closed-stage gate still applies when moving
+     * into Closed Won/Lost — see `stage_id`.)
      */
-    owner_id?: string | null;
+    owner_id?: string;
     /**
      * mashup_contact_ids to link. Must belong to the deal's company (if the deal
      * has none yet, the added contacts' company is adopted); a cross-company add
@@ -1655,7 +1658,26 @@ interface DealUpdateParams {
     add_contact_ids?: number[];
     /** mashup_contact_ids to unlink. Idempotent. */
     remove_contact_ids?: number[];
+    /**
+     * Buying-committee role per contact on this deal, keyed by
+     * mashup_contact_id. JSON object keys are strings, so the key type is
+     * `string` even though the id is numeric: `{ "5500429": "champion" }`.
+     * `null` clears a contact's role.
+     *
+     * Applies to contacts already linked to the deal, and to contacts linked by
+     * `add_contact_ids` in the same call (roles are applied after the link). An
+     * id that is neither already linked nor being added is rejected with HTTP
+     * 422 naming the id, and the whole update is rolled back. A role outside the
+     * vocabulary is HTTP 422.
+     */
+    contact_roles?: Record<string, DealContactRole | null>;
 }
+/**
+ * Role a contact plays in a deal's buying committee
+ * (`cb_deal_contacts.role`). The same person can hold different roles on
+ * different deals, so this lives on the deal-contact link, not the contact.
+ */
+type DealContactRole = "champion" | "decision_maker" | "influencer" | "blocker" | "coach" | "end_user";
 interface DealListParams {
     page?: number;
     limit?: number;

package/dist/react.d.ts

@@ -1642,11 +1642,14 @@ interface DealUpdateParams {
      */
     close_date?: string | null;
     /**
-     * Reassign the deal owner (user id or email). Pass null to clear, except on
-     * a deal sitting in a closed stage (HTTP 400, marker
-     * `owner_required_for_closed_stage`).
+     * Reassign the deal owner. Pass a member id, email, or provider uid — it is
+     * resolved to a real team member (HTTP 422 if it matches none). Omit to
+     * leave the owner unchanged. Ownership is reassign-only and CANNOT be
+     * cleared: passing `null` is rejected with HTTP 422 (#18469). A deal's owner
+     * is a required invariant. (The closed-stage gate still applies when moving
+     * into Closed Won/Lost — see `stage_id`.)
      */
-    owner_id?: string | null;
+    owner_id?: string;
     /**
      * mashup_contact_ids to link. Must belong to the deal's company (if the deal
      * has none yet, the added contacts' company is adopted); a cross-company add
@@ -1655,7 +1658,26 @@ interface DealUpdateParams {
     add_contact_ids?: number[];
     /** mashup_contact_ids to unlink. Idempotent. */
     remove_contact_ids?: number[];
+    /**
+     * Buying-committee role per contact on this deal, keyed by
+     * mashup_contact_id. JSON object keys are strings, so the key type is
+     * `string` even though the id is numeric: `{ "5500429": "champion" }`.
+     * `null` clears a contact's role.
+     *
+     * Applies to contacts already linked to the deal, and to contacts linked by
+     * `add_contact_ids` in the same call (roles are applied after the link). An
+     * id that is neither already linked nor being added is rejected with HTTP
+     * 422 naming the id, and the whole update is rolled back. A role outside the
+     * vocabulary is HTTP 422.
+     */
+    contact_roles?: Record<string, DealContactRole | null>;
 }
+/**
+ * Role a contact plays in a deal's buying committee
+ * (`cb_deal_contacts.role`). The same person can hold different roles on
+ * different deals, so this lives on the deal-contact link, not the contact.
+ */
+type DealContactRole = "champion" | "decision_maker" | "influencer" | "blocker" | "coach" | "end_user";
 interface DealListParams {
     page?: number;
     limit?: number;