@unboundcx/sdk 4.13.32 → 4.13.35

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@unboundcx/sdk",
-  "version": "4.13.32",
+  "version": "4.13.35",
   "description": "Official JavaScript SDK for the Unbound API - A comprehensive toolkit for integrating with Unbound's communication, AI, and data management services",
   "main": "index.js",
   "type": "module",

package/schemas/layouts/section.js

@@ -90,8 +90,8 @@ const KanbanSection = BaseSection.extend({
 // timeline, not a table/kanban query. `sources` filters which item kinds
 // the feed requests; default is every kind the API can produce.
 export const TIMELINE_SOURCES = [
-  'web', 'ads', 'form', 'email', 'sms', 'call', 'ticket', 'note', 'score',
-  'program', 'file',
+  'web', 'ads', 'form', 'webchat', 'email', 'sms', 'call', 'ticket', 'note',
+  'score', 'program', 'file',
 ];
 
 const TimelineSection = BaseSection.extend({

package/services/ai/playbooks.js

@@ -114,7 +114,13 @@ export class PlaybooksService {
    *   isPublished: true
    * });
    */
-  async updatePlaybook({ playbookId, name, isPublished, recordTypeId }) {
+  async updatePlaybook({
+    playbookId,
+    name,
+    isPublished,
+    recordTypeId,
+    passScore,
+  }) {
     this.sdk.validateParams(
       { playbookId },
       {
@@ -122,11 +128,12 @@ export class PlaybooksService {
         name: { type: 'string', required: false },
         isPublished: { type: 'boolean', required: false },
         recordTypeId: { type: 'string', required: false },
+        passScore: { type: 'number', required: false },
       },
     );
 
     const params = {
-      body: { name, isPublished, recordTypeId },
+      body: { name, isPublished, recordTypeId, passScore },
     };
 
     const result = await internalRequest(this.sdk, 
@@ -202,6 +209,8 @@ export class PlaybooksService {
     requiredForPass,
     role,
     signal,
+    window,
+    windowTurns,
     recordTypeId,
   }) {
     this.sdk.validateParams(
@@ -229,6 +238,8 @@ export class PlaybooksService {
         requiredForPass: { type: 'boolean', required: false },
         role: { type: 'string', required: false },
         signal: { type: 'string', required: false },
+        window: { type: 'string', required: false },
+        windowTurns: { type: 'number', required: false },
         recordTypeId: { type: 'string', required: false },
       },
     );
@@ -244,6 +255,8 @@ export class PlaybooksService {
         requiredForPass,
         role,
         signal,
+        window,
+        windowTurns,
         recordTypeId,
       },
     };
@@ -345,6 +358,8 @@ export class PlaybooksService {
     requiredForPass,
     role,
     signal,
+    window,
+    windowTurns,
     recordTypeId,
   }) {
     this.sdk.validateParams(
@@ -372,6 +387,8 @@ export class PlaybooksService {
         requiredForPass: { type: 'boolean', required: false },
         role: { type: 'string', required: false },
         signal: { type: 'string', required: false },
+        window: { type: 'string', required: false },
+        windowTurns: { type: 'number', required: false },
         recordTypeId: { type: 'string', required: false },
       },
     );
@@ -387,6 +404,8 @@ export class PlaybooksService {
         requiredForPass,
         role,
         signal,
+        window,
+        windowTurns,
         recordTypeId,
       },
     };
@@ -491,6 +510,8 @@ export class PlaybooksService {
     description,
     keywords,
     recommendedPhase,
+    window,
+    windowTurns,
     role,
     signal,
     recordTypeId,
@@ -502,6 +523,8 @@ export class PlaybooksService {
         description: { type: 'string', required: false },
         keywords: { type: 'array', required: false },
         recommendedPhase: { type: 'string', required: false },
+        window: { type: 'string', required: false },
+        windowTurns: { type: 'number', required: false },
         role: { type: 'string', required: false },
         signal: { type: 'string', required: false },
         recordTypeId: { type: 'string', required: false },
@@ -509,7 +532,17 @@ export class PlaybooksService {
     );
 
     const params = {
-      body: { name, description, keywords, recommendedPhase, role, signal, recordTypeId },
+      body: {
+        name,
+        description,
+        keywords,
+        recommendedPhase,
+        window,
+        windowTurns,
+        role,
+        signal,
+        recordTypeId,
+      },
     };
 
     const result = await internalRequest(this.sdk, 
@@ -604,22 +637,28 @@ export class PlaybooksService {
    */
   async updatePlaybookGoalType({
     goalTypeId,
+    playbookGoalTypeId,
     name,
     description,
     keywords,
     recommendedPhase,
+    window,
+    windowTurns,
     role,
     signal,
     recordTypeId,
   }) {
+    const id = goalTypeId || playbookGoalTypeId;
     this.sdk.validateParams(
-      { goalTypeId },
+      { goalTypeId: id },
       {
         goalTypeId: { type: 'string', required: true },
         name: { type: 'string', required: false },
         description: { type: 'string', required: false },
         keywords: { type: 'array', required: false },
         recommendedPhase: { type: 'string', required: false },
+        window: { type: 'string', required: false },
+        windowTurns: { type: 'number', required: false },
         role: { type: 'string', required: false },
         signal: { type: 'string', required: false },
         recordTypeId: { type: 'string', required: false },
@@ -627,11 +666,21 @@ export class PlaybooksService {
     );
 
     const params = {
-      body: { name, description, keywords, recommendedPhase, role, signal, recordTypeId },
+      body: {
+        name,
+        description,
+        keywords,
+        recommendedPhase,
+        window,
+        windowTurns,
+        role,
+        signal,
+        recordTypeId,
+      },
     };
 
     const result = await internalRequest(this.sdk, 
-      `/ai/playbooks/goalTypes/${goalTypeId}`,
+      `/ai/playbooks/goalTypes/${id}`,
       'PUT',
       params,
     );

package/services/dealRegistrations.js

@@ -44,4 +44,27 @@ export class DealRegistrationsService {
       body: { reason },
     });
   }
+
+  /**
+   * Immediate staff-side conflict check against a prospect company, used by
+   * the create-mode form's Company lookup field to warn before submit —
+   * runs the same conflict engine the create handler stamps onto the
+   * record at save time, without creating anything. Session-less staff
+   * endpoint (checkApiAuth), not part of the portal registration flow.
+   * @param {string} companyId - company record id (the prospect, not the
+   *   partner)
+   * @returns {Promise<Object>} { conflict: boolean, reasons: string[] }
+   */
+  async conflictCheck(companyId) {
+    this.sdk.validateParams(
+      { companyId },
+      { companyId: { type: 'string', required: true } },
+    );
+    return internalRequest(
+      this.sdk,
+      '/deal-registrations/conflict-check',
+      'GET',
+      { query: { companyId } },
+    );
+  }
 }

package/services/messaging/TenDlcCampaignManagementService.js

@@ -447,6 +447,36 @@ export class TenDlcCampaignManagementService {
     return result;
   }
 
+  /**
+   * Bulk-add/move phone numbers onto a campaign
+   * @param {string} campaignId - Campaign ID
+   * @param {Object} options
+   * @param {string[]} options.phoneNumbers - Phone numbers in E.164 format (1-200)
+   * @param {boolean} [options.force] - Move numbers off another campaign instead
+   *   of returning a 409 conflict
+   * @returns {Promise<Object>} `{ id, results: [{ phoneNumber, status, ... }] }`
+   */
+  async addPhoneNumbers(campaignId, { phoneNumbers, force } = {}) {
+    this.sdk.validateParams(
+      { campaignId, phoneNumbers },
+      {
+        campaignId: { type: 'string', required: true },
+        phoneNumbers: { type: 'array', required: true },
+      },
+    );
+
+    const options = {
+      body: { phoneNumbers, force },
+    };
+
+    const result = await internalRequest(this.sdk,
+      `/messaging/campaigns/10dlc/campaign/${campaignId}/phoneNumbers`,
+      'POST',
+      options,
+    );
+    return result;
+  }
+
   /**
    * Remove phone number from campaign
    */

package/services/messaging/TenDlcCampaignsService.js

@@ -22,7 +22,7 @@ export class TenDlcCampaignsService {
       },
     );
 
-    const result = await internalRequest(this.sdk, 
+    const result = await internalRequest(this.sdk,
       `/messaging/campaigns/10dlc/phoneNumber/${encodeURIComponent(
         phoneNumber,
       )}/campaignStatus`,
@@ -30,4 +30,41 @@ export class TenDlcCampaignsService {
     );
     return result;
   }
+
+  /**
+   * List every account phone number with its 10DLC campaign link (if any)
+   * @returns {Promise<Array>} `[{ id, phoneNumber, name, city, state, country,
+   *   campaignId, campaignName, campaignLinkingStatus, linkedAt }]`
+   */
+  async listPhoneNumberAssignments() {
+    const result = await internalRequest(this.sdk,
+      `/messaging/campaigns/10dlc/phoneNumbers/assignments`,
+      'GET',
+    );
+    return result;
+  }
+
+  /**
+   * Get the current 10DLC campaign link for one phone number
+   * @param {string} phoneNumber - Phone number to check
+   * @returns {Promise<Object>} `{ phoneNumber, campaignId, campaignName,
+   *   campaignStatus, campaignLinkingStatus, linkedAt }` (campaignId is null
+   *   when the number is unassigned)
+   */
+  async getPhoneNumberCampaign(phoneNumber) {
+    this.sdk.validateParams(
+      { phoneNumber },
+      {
+        phoneNumber: { type: 'string', required: true },
+      },
+    );
+
+    const result = await internalRequest(this.sdk,
+      `/messaging/campaigns/10dlc/phoneNumber/${encodeURIComponent(
+        phoneNumber,
+      )}/campaign`,
+      'GET',
+    );
+    return result;
+  }
 }

package/services/video.js

@@ -413,6 +413,31 @@ export class VideoService {
     return result;
   }
 
+  /**
+   * Send the brand-level Meet invite email to one or more addresses.
+   *
+   * @param {string} roomId
+   * @param {Object} input
+   * @param {string[]} input.to
+   * @param {string} [input.peopleId]
+   * @param {string} [input.engagementSessionId]
+   */
+  async inviteByEmail(roomId, { to, peopleId, engagementSessionId } = {}) {
+    this.sdk.validateParams(
+      { roomId, to },
+      {
+        roomId: { type: 'string', required: true },
+        to: { type: 'array', required: true },
+      },
+    );
+    const body = { to };
+    if (peopleId) body.peopleId = peopleId;
+    if (engagementSessionId) body.engagementSessionId = engagementSessionId;
+    return internalRequest(this.sdk, `/video/${roomId}/invite`, 'POST', {
+      body,
+    });
+  }
+
   async placeCall(roomId, phoneNumber, callerIdNumber) {
     this.sdk.validateParams(
       { roomId, phoneNumber, callerIdNumber },

package/services/webchat.js

@@ -133,8 +133,9 @@ export class WebchatConversationMessagesService {
    * @param {string} widgetId
    * @param {string} engagementSessionId
    * @param {Object} options
-   * @param {string} options.message
+   * @param {string} [options.message]
    * @param {Object} [options.media]
+   * @param {Object|Array} [options.card] - v1 chat card `{schemaVersion, blocks}` or a blocks array
    * @returns {Promise<Object>}
    */
   async send(widgetId, engagementSessionId, options) {
@@ -143,11 +144,15 @@ export class WebchatConversationMessagesService {
         widgetId,
         engagementSessionId,
         message: options?.message,
+        media: options?.media,
+        card: options?.card,
       },
       {
         widgetId: { type: 'string', required: true },
         engagementSessionId: { type: 'string', required: true },
-        message: { type: 'string', required: true },
+        message: { type: 'string', required: false },
+        media: { type: 'object', required: false },
+        card: { type: 'object', required: false },
       },
     );
 
@@ -160,6 +165,32 @@ export class WebchatConversationMessagesService {
       params,
     );
   }
+
+  /**
+   * Hide a link preview on a webchat message (same as chat.hideUnfurl).
+   * @param {string} widgetId
+   * @param {string} engagementSessionId
+   * @param {string} messageId
+   * @param {Object} options
+   * @param {string} options.url
+   */
+  async hideUnfurl(widgetId, engagementSessionId, messageId, { url } = {}) {
+    this.sdk.validateParams(
+      { widgetId, engagementSessionId, messageId, url },
+      {
+        widgetId: { type: 'string', required: true },
+        engagementSessionId: { type: 'string', required: true },
+        messageId: { type: 'string', required: true },
+        url: { type: 'string', required: true },
+      },
+    );
+    return internalRequest(
+      this.sdk,
+      `/webchat/widgets/${widgetId}/conversations/${engagementSessionId}/messages/${messageId}/unfurls/hide`,
+      'POST',
+      { body: { url } },
+    );
+  }
 }
 
 export class WebchatConversationsService {