@unboundcx/sdk 4.13.39 → 4.13.41

package/package.json

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

@@ -497,6 +497,49 @@ export class ChatService {
     );
   }
 
+  /**
+   * Send a message on a kind:'text' channel (sms-routing-plan.md §3.3.1).
+   * Plain body only — no ProseMirror `message`, no threads/cards. The API
+   * intercepts this route for text channels and sends the plain-text body
+   * as a real SMS/MMS via the same pipeline as sdk.messaging.sms.send
+   * (unless `internal` is set, which stays a regular chat message).
+   * @param {string} channelId
+   * @param {Object} params
+   * @param {string} [params.text] - Plain message text
+   * @param {string[]} [params.storageIds] - Image attachment storage ids
+   * @param {boolean} [params.internal] - Internal note; never sent as SMS
+   * @param {boolean} [params.force] - Force-send past a busy-conversation
+   *   (409 TEXT_CONVERSATION_BUSY) collision
+   * @returns {Promise<Object>} Created message
+   */
+  async sendTextMessage(channelId, { text, storageIds, internal, force } = {}) {
+    this.sdk.validateParams(
+      { channelId, text, storageIds, internal, force },
+      {
+        channelId: { type: "string", required: true },
+        text: { type: "string", required: false },
+        storageIds: { type: "array", required: false },
+        internal: { type: "boolean", required: false },
+        force: { type: "boolean", required: false },
+      },
+    );
+
+    const body = {};
+    if (text !== undefined) body.text = text;
+    if (storageIds !== undefined) body.storageIds = storageIds;
+    if (internal !== undefined) body.internal = internal;
+    if (force !== undefined) body.force = force;
+
+    return internalRequest(
+      this.sdk,
+      `/chat/channels/${channelId}/messages`,
+      "POST",
+      {
+        body,
+      },
+    );
+  }
+
   /**
    * Edit a message body (ProseMirror JSON).
    * @param {string} id
@@ -844,7 +887,11 @@ export class ChatService {
    *   reason"; channel must be a non-archived public/private channel.
    * @returns {Promise<Object>} `{allowReports, reportReasons, reportNotifications}`
    */
-  async adminPutSettings({ allowReports, reportReasons, reportNotifications } = {}) {
+  async adminPutSettings({
+    allowReports,
+    reportReasons,
+    reportNotifications,
+  } = {}) {
     this.sdk.validateParams(
       { allowReports, reportReasons, reportNotifications },
       {
@@ -1145,7 +1192,10 @@ export class ChatService {
    * @param {'open'|'in_review'} [params.status]
    * @returns {Promise<Object>}
    */
-  async adminUpdateCase(id, { title, category, description, ownerId, status } = {}) {
+  async adminUpdateCase(
+    id,
+    { title, category, description, ownerId, status } = {},
+  ) {
     this.sdk.validateParams(
       { id, title, category, description, ownerId, status },
       {

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
@@ -21,6 +22,8 @@ export class SmsService {
    *   to attach this message to, so it surfaces on that record's feed
    * @param {string} [params.engagementSessionId] - Engagement to attach this message to
    * @param {string} [params.taskId] - Task the message was sent under (multi-channel-per-task attribution)
+   * @param {boolean} [params.force] - Force-send past a busy-conversation
+   *   (409 TEXT_CONVERSATION_BUSY) collision
    * @returns {Promise<Object>} Message details
    */
   async send({
@@ -34,6 +37,7 @@ export class SmsService {
     relatedId,
     engagementSessionId,
     taskId,
+    force,
   }) {
     const messageData = {};
     if (from) messageData.from = from;
@@ -45,11 +49,26 @@ export class SmsService {
     if (relatedId) messageData.relatedId = relatedId;
     if (engagementSessionId) messageData.engagementSessionId = engagementSessionId;
     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 },
@@ -59,6 +78,7 @@ export class SmsService {
         relatedId: { type: 'string', required: false },
         engagementSessionId: { type: 'string', required: false },
         taskId: { type: 'string', required: false },
+        force: { type: 'boolean', required: false },
       },
     );
 

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 {