@unboundcx/sdk 4.13.44 → 4.13.48

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@unboundcx/sdk",
-  "version": "4.13.44",
+  "version": "4.13.48",
   "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/portals.js

@@ -617,6 +617,18 @@ export class PortalsService {
    *   portal with no login surface, e.g. `marketing`, is never included);
    *   `matches` is whether this person currently passes that portal's
    *   people-access filter.
+   *   sessions: Array<{
+   *     id: string,
+   *     portalId: string,
+   *     portalName: string,
+   *     ip: string,
+   *     browser: string,
+   *     os: string,
+   *     device: string,
+   *     createdAt: string|null,
+   *     lastSeenAt: string|null,
+   *     expiresAt: string|null
+   *   }>
    */
   async getPeopleAccess(peopleId) {
     this.sdk.validateParams(
@@ -737,9 +749,55 @@ export class PortalsService {
     );
   }
 
+  /**
+   * Revokes one portal login session for the person (logs that browser out).
+   *
+   * @param {string} peopleId
+   * @param {string} sessionId
+   * @returns {Promise<{ ok: true }>}
+   */
+  async revokePeoplePortalSession(peopleId, sessionId) {
+    this.sdk.validateParams(
+      { peopleId, sessionId },
+      {
+        peopleId: { type: "string", required: true },
+        sessionId: { type: "string", required: true },
+      },
+    );
+
+    return internalRequest(
+      this.sdk,
+      `/portals/people/${encodeURIComponent(peopleId)}/sessions/${encodeURIComponent(sessionId)}`,
+      "DELETE",
+    );
+  }
+
+  /**
+   * Revokes every active portal login session for the person (logs them
+   * out of all browsers). Does not delete their credential — they can
+   * sign in again.
+   *
+   * @param {string} peopleId
+   * @returns {Promise<{ ok: true }>}
+   */
+  async revokeAllPeoplePortalSessions(peopleId) {
+    this.sdk.validateParams(
+      { peopleId },
+      {
+        peopleId: { type: "string", required: true },
+      },
+    );
+
+    return internalRequest(
+      this.sdk,
+      `/portals/people/${encodeURIComponent(peopleId)}/sessions`,
+      "DELETE",
+    );
+  }
+
   /**
    * Revokes a person's portal access (soft-deletes their credential across
-   * every portal on the account). Idempotent — revoking someone with no
+   * every portal on this account). Idempotent — revoking someone with no
    * credential is a no-op, not an error.
    *
    * @param {string} peopleId

package/services/taskRouter/CCService.js

@@ -300,4 +300,29 @@ export class CCService {
     );
     return result;
   }
+
+  /**
+   * Recover a worker stuck out of routing (ghost Redis capacity, leftover
+   * lock, expired wrap-up). Self or manager. Does not force offline.
+   *
+   * @param {Object} options
+   * @param {string} options.workerId
+   * @returns {Promise<Object>}
+   */
+  async unlockWorker(options = {}) {
+    const { workerId } = options;
+
+    this.sdk.validateParams(
+      { workerId },
+      { workerId: { type: 'string', required: true } },
+    );
+
+    const result = await internalRequest(
+      this.sdk,
+      `/taskRouter/cc/workers/${workerId}/unlock`,
+      'POST',
+      {},
+    );
+    return result;
+  }
 }

package/services/taskRouter/TaskService.js

@@ -880,6 +880,65 @@ export class TaskService {
     );
   }
 
+  /**
+   * Mark a task's inbound messages as read for one channel (or all).
+   * Channel ids: sms | webchat | email | whatsApp | rcs | all.
+   * Clearing SMS also clears whatsApp/rcs until those get their own
+   * timeline threads (`channel` may also be the group name `sms`).
+   *
+   * @param {Object} options
+   * @param {string} options.taskId
+   * @param {string} [options.channel='all']
+   * @returns {Promise<{taskId:string, unreadByChannel:object, unreadTotal:number}>}
+   */
+  async markChannelRead(options = {}) {
+    const { taskId, channel } = options;
+
+    this.sdk.validateParams(
+      { taskId, channel },
+      {
+        taskId: { type: 'string', required: true },
+        channel: { type: 'string', required: false },
+      },
+    );
+
+    const params = { body: { taskId } };
+    if (channel !== undefined) params.body.channel = channel;
+
+    return await internalRequest(
+      this.sdk,
+      '/taskRouter/tasks/unread/read',
+      'PUT',
+      params,
+    );
+  }
+
+  /**
+   * Read a task's live channel mix -- whether it has an open text
+   * conversation, a live webchat session, or an active call, and whether
+   * it's currently eligible to be parked (`canPark`). Used to show/hide
+   * Park and webchat "End chat" without polling (task-park-webchat-endchat
+   * decisions, 2026-09-04).
+   *
+   * @param {Object} options
+   * @param {string} options.taskId
+   * @returns {Promise<{channelState:{hasOpenText:boolean, webchatLive:boolean, callLive:boolean, canPark:boolean}}>}
+   */
+  async channelState(options = {}) {
+    const { taskId } = options;
+
+    this.sdk.validateParams(
+      { taskId },
+      { taskId: { type: 'string', required: true } },
+    );
+
+    return await internalRequest(
+      this.sdk,
+      `/taskRouter/tasks/${taskId}/channelState`,
+      'GET',
+    );
+  }
+
   /**
    * Transfer a task to a different queue and/or worker. Passing queueId
    * moves the task back to 'pending' status for re-distribution.

package/services/webchat.js

@@ -243,6 +243,32 @@ export class WebchatConversationsService {
       'GET',
     );
   }
+
+  /**
+   * Agent-initiated "End chat" -- ends the webchat session only (same
+   * completeConversation() path as visitor end / idle timeout, reason
+   * 'agentEnded'). Only offered client-side when another channel (open
+   * text conversation or a live call) is still open on the task; the task
+   * itself keeps running (task-park-webchat-endchat-plan.md R2).
+   * @param {string} widgetId
+   * @param {string} engagementSessionId
+   * @returns {Promise<Object>}
+   */
+  async end(widgetId, engagementSessionId) {
+    this.sdk.validateParams(
+      { widgetId, engagementSessionId },
+      {
+        widgetId: { type: 'string', required: true },
+        engagementSessionId: { type: 'string', required: true },
+      },
+    );
+
+    return internalRequest(
+      this.sdk,
+      `/webchat/widgets/${widgetId}/conversations/${engagementSessionId}/end`,
+      'POST',
+    );
+  }
 }
 
 export class WebchatService {