@unboundcx/sdk 4.13.41 → 4.13.43

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@unboundcx/sdk",
-  "version": "4.13.41",
+  "version": "4.13.43",
   "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/services/dealRegistrations.js

@@ -18,11 +18,21 @@ export class DealRegistrationsService {
    * company/people/opportunity records (reusing matched records where
    * possible) and stamps the registration approved.
    * @param {string} id - dealRegistrations record id
+   * @param {Object} [options]
+   * @param {string} [options.notes] - shared with the partner (approval email + portal)
+   * @param {boolean} [options.force] - override a detected conflict; required
+   *   when conflictStatus === 'conflict', otherwise the API answers 200
+   *   with converted:false and leaves the registration pending.
    * @returns {Promise<Object>} { registration, converted }
    */
-  async approve(id) {
+  async approve(id, { notes, force } = {}) {
     this.sdk.validateParams({ id }, { id: { type: 'string', required: true } });
-    return internalRequest(this.sdk, `/deal-registrations/${id}/approve`, 'POST');
+    const body = {};
+    if (notes !== undefined) body.notes = notes;
+    if (force !== undefined) body.force = force;
+    return internalRequest(this.sdk, `/deal-registrations/${id}/approve`, 'POST', {
+      body,
+    });
   }
 
   /**

package/services/taskRouter/MetricsService.js

@@ -9,7 +9,16 @@ export class MetricsService {
    * Retrieves real-time metrics for task router queues, tasks, and workers.
    * This provides insights into queue performance, wait times, task counts, and worker activity.
    *
-   * @param {Object} params - Metric parameters
+   * Accepts either `(params)` or `(accountId, params)` -- every client
+   * caller uses the former (e.g. `getCurrent({ queueId })`), and
+   * `accountId` is optional (the API route scopes by the authenticated
+   * account already). Sent as a query string, not a body: this hits
+   * `/taskRouter/metrics/current` over GET, and base.js's `_httpRequest`
+   * deletes `body` on any GET request, so a body-only payload here was
+   * silently discarded before ever reaching the server.
+   *
+   * @param {Object|string} [paramsOrAccountId] - Either the params object (preferred) or an accountId string
+   * @param {Object} [maybeParams] - Metric parameters, when the first argument is an accountId
    * @param {string} [params.period] - Time period for metrics calculation. Options: '5min', '15min', '30min', '1hour', '24hour'
    * @param {string} [params.queueId] - Specific queue ID to filter metrics. If not provided, returns metrics for all queues
    * @param {string} [params.metricType] - Type of metrics to retrieve: 'queue', 'task', 'worker', or 'all' (default: 'all')
@@ -71,7 +80,11 @@ export class MetricsService {
    * console.log(taskMetrics.metrics.task.created); // 150
    * console.log(taskMetrics.metrics.task.completed); // 142
    */
-  async getCurrent(accountId, params = {}) {
+  async getCurrent(paramsOrAccountId, maybeParams) {
+    const isParamsFirst =
+      paramsOrAccountId !== null && typeof paramsOrAccountId === 'object';
+    const accountId = isParamsFirst ? undefined : paramsOrAccountId;
+    const params = (isParamsFirst ? paramsOrAccountId : maybeParams) || {};
     const { period, queueId, metricType, limit = 100 } = params;
 
     this.sdk.validateParams(
@@ -84,28 +97,28 @@ export class MetricsService {
       },
     );
 
-    const requestParams = {
-      body: {
-        limit,
-      },
-    };
+    const query = { limit };
+
+    if (accountId !== undefined) {
+      query.accountId = accountId;
+    }
 
     if (period !== undefined) {
-      requestParams.body.period = period;
+      query.period = period;
     }
 
     if (queueId !== undefined) {
-      requestParams.body.queueId = queueId;
+      query.queueId = queueId;
     }
 
     if (metricType !== undefined) {
-      requestParams.body.metricType = metricType;
+      query.metricType = metricType;
     }
 
-    const result = await internalRequest(this.sdk, 
+    const result = await internalRequest(this.sdk,
       '/taskRouter/metrics/current',
       'GET',
-      requestParams,
+      { query },
     );
     return result;
   }

package/services/taskRouter/TaskService.js

@@ -23,6 +23,7 @@ export class TaskService {
    * @param {boolean} [options.createEngagement=false] - Whether to automatically create an engagement session for this task
    * @param {string} [options.relatedObject] - Related object type for metadata tracking (automatically set if createEngagement is true)
    * @param {string} [options.relatedId] - Related object ID for metadata tracking (automatically set if createEngagement is true)
+   * @param {Object} [options.metadata] - Arbitrary metadata to attach to the task at creation (e.g. `{ textConversationId }`). Passed through as-is; whether it is persisted depends on the receiving endpoint honoring `metadata` in the request body.
    * @returns {Promise<Object>} Object containing the created task information
    * @returns {string} result.id - The unique identifier for the created task
    *
@@ -83,6 +84,7 @@ export class TaskService {
       cdrId,
       sipCallId,
       aiChatSessionId,
+      metadata,
     } = options;
 
     this.sdk.validateParams(
@@ -102,6 +104,7 @@ export class TaskService {
         relatedId,
         sipCallId,
         aiChatSessionId,
+        metadata,
       },
       {
         type: { type: 'string', required: true },
@@ -119,6 +122,7 @@ export class TaskService {
         relatedId: { type: 'string', required: false },
         sipCallId: { type: 'string', required: false },
         aiChatSessionId: { type: 'string', required: false },
+        metadata: { type: 'object', required: false },
       },
     );
 
@@ -181,6 +185,10 @@ export class TaskService {
       params.body.aiChatSessionId = aiChatSessionId;
     }
 
+    if (metadata !== undefined) {
+      params.body.metadata = metadata;
+    }
+
     const result = await internalRequest(this.sdk, '/taskRouter/tasks', 'POST', params);
     return result;
   }

package/services/text.js

@@ -147,6 +147,42 @@ export class TextConversationsService {
       body: { to, userId, groupId, visibility, workflowId, workflowVersionId },
     });
   }
+
+  /**
+   * "SMS from an active call": check whether the current user may open the
+   * UC Chat text channel for a call's (our number, other party) pair.
+   * Never throws for an unavailable result -- check `available`/`reason`.
+   * @param {string} cdrId - cdr_acct id for the call (required)
+   * @returns {Promise<Object>} { available, reason, phoneNumberId, ourNumber, counterparty, conversationId, channelId, isMember }
+   */
+  async callThread(cdrId) {
+    this.sdk.validateParams(
+      { cdrId },
+      { cdrId: { type: 'string', required: true } },
+    );
+
+    return internalRequest(this.sdk, '/text/call-thread', 'GET', {
+      query: { cdrId },
+    });
+  }
+
+  /**
+   * Open (or join) the UC Chat text channel for a call's (our number,
+   * other party) pair, minting the conversation/channel if none is open
+   * yet. 403s if callThread(cdrId) would report `available: false`.
+   * @param {string} cdrId - cdr_acct id for the call (required)
+   * @returns {Promise<Object>} { channel, conversationId }
+   */
+  async openCallThread(cdrId) {
+    this.sdk.validateParams(
+      { cdrId },
+      { cdrId: { type: 'string', required: true } },
+    );
+
+    return internalRequest(this.sdk, '/text/call-thread', 'POST', {
+      body: { cdrId },
+    });
+  }
 }
 
 export class TextService {