@unboundcx/sdk 4.13.54 → 4.13.56

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@unboundcx/sdk",
-  "version": "4.13.54",
+  "version": "4.13.56",
   "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/taskRouter/OfferService.js

@@ -0,0 +1,71 @@
+import { internalRequest } from '../../base.js';
+
+/**
+ * Offer Service - accept/decline a direct offer (transfer/invite/help) routed to a user
+ */
+export class OfferService {
+  constructor(sdk) {
+    this.sdk = sdk;
+  }
+
+  /**
+   * Accept a pending direct offer.
+   * Creates/reuses the caller's worker session as needed and assigns the task to them.
+   *
+   * @param {Object} options - Options
+   * @param {string} options.offerId - Offer ID
+   * @returns {Promise<Object>} { taskId, workerId, isVoice }
+   *
+   * @example
+   * const result = await sdk.taskRouter.offer.accept({ offerId: 'offer_123' });
+   */
+  async accept({ offerId }) {
+    this.sdk.validateParams(
+      { offerId },
+      {
+        offerId: { type: 'string', required: true },
+      },
+    );
+
+    const params = {
+      body: { offerId },
+    };
+
+    const result = await internalRequest(this.sdk,
+      '/taskRouter/offers/accept',
+      'PUT',
+      params,
+    );
+    return result;
+  }
+
+  /**
+   * Decline a pending direct offer.
+   *
+   * @param {Object} options - Options
+   * @param {string} options.offerId - Offer ID
+   * @returns {Promise<Object>} { offerId }
+   *
+   * @example
+   * const result = await sdk.taskRouter.offer.decline({ offerId: 'offer_123' });
+   */
+  async decline({ offerId }) {
+    this.sdk.validateParams(
+      { offerId },
+      {
+        offerId: { type: 'string', required: true },
+      },
+    );
+
+    const params = {
+      body: { offerId },
+    };
+
+    const result = await internalRequest(this.sdk,
+      '/taskRouter/offers/decline',
+      'PUT',
+      params,
+    );
+    return result;
+  }
+}

package/services/taskRouter/TaskRouterService.js

@@ -2,6 +2,7 @@ import { WorkerService } from './WorkerService.js';
 import { TaskService } from './TaskService.js';
 import { MetricsService } from './MetricsService.js';
 import { CCService } from './CCService.js';
+import { OfferService } from './OfferService.js';
 
 export class TaskRouterService {
   constructor(sdk) {
@@ -10,5 +11,6 @@ export class TaskRouterService {
     this.task = new TaskService(sdk);
     this.metrics = new MetricsService(sdk);
     this.cc = new CCService(sdk);
+    this.offer = new OfferService(sdk);
   }
 }

package/services/taskRouter/TaskService.js

@@ -1066,38 +1066,32 @@ export class TaskService {
   }
 
   /**
-   * Transfer a task to a different queue and/or worker. Creates a new task
-   * in the target queue and re-points live channels to it; the old task is
-   * completed (blind) or left connected pending completeTransfer/cancelTransfer
-   * (attended).
+   * Transfer a task to a different queue and/or worker. Every transfer
+   * creates a new task in the target queue and re-points live channels to
+   * it; the old task is completed with the target queue's transfer
+   * disposition.
    *
    * @param {Object} options - Parameters
    * @param {string} options.taskId - The task ID to transfer (required)
-   * @param {string} [options.queueId] - Destination queue ID
-   * @param {string} [options.workerId] - Destination worker ID
-   * @param {string} [options.mode='blind'] - 'blind' or 'attended'. Attended is only
-   *   meaningful when a live voice leg exists; otherwise treated as blind.
+   * @param {Object} options.target - Transfer target (required)
+   * @param {string} [options.target.queueId] - Destination queue ID
+   * @param {string} [options.target.workerId] - Destination worker ID
    * @param {string} [options.note] - Optional note for the receiving agent
-   * @returns {Promise<Object>} { taskId, newTaskId, mode }
+   * @returns {Promise<Object>} { taskId, newTaskId }
    */
   async transfer(options = {}) {
-    const { taskId, queueId, workerId, mode, note } = options;
+    const { taskId, target, note } = options;
 
     this.sdk.validateParams(
-      { taskId, queueId, workerId, mode, note },
+      { taskId, target, note },
       {
         taskId: { type: 'string', required: true },
-        queueId: { type: 'string', required: false },
-        workerId: { type: 'string', required: false },
-        mode: { type: 'string', required: false },
+        target: { type: 'object', required: true },
         note: { type: 'string', required: false },
       },
     );
 
-    const params = { body: { taskId } };
-    if (queueId !== undefined) params.body.queueId = queueId;
-    if (workerId !== undefined) params.body.workerId = workerId;
-    if (mode !== undefined) params.body.mode = mode;
+    const params = { body: { taskId, target } };
     if (note !== undefined) params.body.note = note;
 
     return await internalRequest(
@@ -1108,59 +1102,6 @@ export class TaskService {
     );
   }
 
-  /**
-   * Complete an attended transfer: unhold the caller, hang up the old
-   * agent's leg, and complete the old task.
-   *
-   * @param {Object} options - Parameters
-   * @param {string} options.taskId - The old task ID (required)
-   * @returns {Promise<Object>} { taskId }
-   */
-  async transferComplete(options = {}) {
-    const { taskId } = options;
-
-    this.sdk.validateParams(
-      { taskId },
-      { taskId: { type: 'string', required: true } },
-    );
-
-    const params = { body: { taskId } };
-
-    return await internalRequest(
-      this.sdk,
-      '/taskRouter/tasks/transfer/complete',
-      'PUT',
-      params,
-    );
-  }
-
-  /**
-   * Cancel an attended transfer: complete/hang up the new task, re-point
-   * channels back to the old task, unhold the caller, and clear the old
-   * task's transfer state.
-   *
-   * @param {Object} options - Parameters
-   * @param {string} options.taskId - The old task ID (required)
-   * @returns {Promise<Object>} { taskId }
-   */
-  async transferCancel(options = {}) {
-    const { taskId } = options;
-
-    this.sdk.validateParams(
-      { taskId },
-      { taskId: { type: 'string', required: true } },
-    );
-
-    const params = { body: { taskId } };
-
-    return await internalRequest(
-      this.sdk,
-      '/taskRouter/tasks/transfer/cancel',
-      'PUT',
-      params,
-    );
-  }
-
   /**
    * Get the voice transcript for a task, keyed by the media-manager
    * bridgeId (not sipCallId) so it works across requeue/transfer.