@unboundcx/sdk 4.13.40 → 4.13.42

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@unboundcx/sdk",
-  "version": "4.13.40",
+  "version": "4.13.42",
   "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/messaging/SmsService.js

@@ -10,7 +10,8 @@ export class SmsService {
   /**
    * Send an SMS/MMS message
    * @param {Object} params - Message parameters
-   * @param {string} params.to - Recipient phone number (required)
+   * @param {string|string[]} params.to - Recipient phone number, or an
+   *   array of up to 8 for a group MMS send (required)
    * @param {string} [params.from] - Sender phone number
    * @param {string} [params.message] - Message text
    * @param {string} [params.templateId] - Template ID to use
@@ -50,10 +51,24 @@ export class SmsService {
     if (taskId) messageData.taskId = taskId;
     if (force !== undefined) messageData.force = force;
 
+    // `to` is string | string[] (group MMS, up to 8 recipients) --
+    // validated by hand since sdk.validateParams has no multi-type support
+    // (see TaskService.js's ['string','array'] usage, which hits the same
+    // gap) rather than compounding that on a new call site.
+    if (to === undefined || to === null) {
+      throw new Error('Missing required parameter to');
+    }
+    if (Array.isArray(to)) {
+      if (!to.length || !to.every((n) => typeof n === 'string')) {
+        throw new Error('Invalid type for parameter to: expected string or string[]');
+      }
+    } else if (typeof to !== 'string') {
+      throw new Error('Invalid type for parameter to: expected string or string[]');
+    }
+
     this.sdk.validateParams(
-      { to, ...messageData },
+      { ...messageData },
       {
-        to: { type: 'string', required: true },
         from: { type: 'string', required: false },
         message: { type: 'string', required: false },
         templateId: { type: 'string', required: false },

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

@@ -97,6 +97,56 @@ export class TextConversationsService {
       body: { queueId, workflowId, workflowVersionId },
     });
   }
+
+  /**
+   * Move a TASK-owned conversation to a user (or UC Chat group) or to a
+   * workflow (sms-routing-plan.md K4, plan §3.4 "task -> user"/"task ->
+   * workflow"). Caller must be the task's current worker or a manager --
+   * enforced server-side. Moving to a user creates/reuses the UC Chat
+   * channel for that (identity, counterparty) pair starting from now --
+   * prior message history is NOT backfilled into the channel.
+   * @param {string} id - textConversations id (required)
+   * @param {Object} options - Parameters
+   * @param {'user'|'workflow'} options.to - Move target (required)
+   * @param {string} [options.userId] - Target user (required if to:'user' and no groupId)
+   * @param {string} [options.groupId] - Target UC Chat group (required if to:'user' and no userId)
+   * @param {'private'|'public'} [options.visibility] - New channel visibility (to:'user' only)
+   * @param {string} [options.workflowId] - Move to a workflow's current version
+   * @param {string} [options.workflowVersionId] - Move to a pinned workflow version
+   * @returns {Promise<Object>} The updated conversation row
+   */
+  async move(id, options = {}) {
+    const { to, userId, groupId, visibility, workflowId, workflowVersionId } =
+      options;
+
+    this.sdk.validateParams(
+      { id, to, userId, groupId, visibility, workflowId, workflowVersionId },
+      {
+        id: { type: 'string', required: true },
+        to: { type: 'string', required: true },
+        userId: { type: 'string', required: false },
+        groupId: { type: 'string', required: false },
+        visibility: { type: 'string', required: false },
+        workflowId: { type: 'string', required: false },
+        workflowVersionId: { type: 'string', required: false },
+      },
+    );
+    if (to !== 'user' && to !== 'workflow') {
+      throw new Error("move requires to: 'user' or 'workflow'");
+    }
+    if (to === 'user' && !userId && !groupId) {
+      throw new Error("move to:'user' requires userId or groupId");
+    }
+    if (to === 'workflow' && !workflowId && !workflowVersionId) {
+      throw new Error(
+        "move to:'workflow' requires workflowId or workflowVersionId",
+      );
+    }
+
+    return internalRequest(this.sdk, `/text/conversations/${id}/move`, 'POST', {
+      body: { to, userId, groupId, visibility, workflowId, workflowVersionId },
+    });
+  }
 }
 
 export class TextService {