@unboundcx/sdk 4.13.25 → 4.13.27

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@unboundcx/sdk",
-  "version": "4.13.25",
+  "version": "4.13.27",
   "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/webchat.js

@@ -164,9 +164,129 @@ export class WebchatWidgetsService {
   }
 }
 
+export class WebchatConversationMessagesService {
+  constructor(sdk) {
+    this.sdk = sdk;
+  }
+
+  /**
+   * List messages for a webchat conversation (agent view).
+   * @param {string} widgetId
+   * @param {string} engagementSessionId
+   * @param {Object} [options]
+   * @param {string} [options.before] - cursor: return messages created before this
+   * @param {number} [options.limit]
+   * @returns {Promise<Array<Object>>}
+   */
+  async list(widgetId, engagementSessionId, options = {}) {
+    this.sdk.validateParams(
+      { widgetId, engagementSessionId },
+      {
+        widgetId: { type: 'string', required: true },
+        engagementSessionId: { type: 'string', required: true },
+      },
+    );
+
+    const { before, limit } = options;
+
+    return internalRequest(
+      this.sdk,
+      `/webchat/widgets/${widgetId}/conversations/${engagementSessionId}/messages`,
+      'GET',
+      { query: { before, limit } },
+    );
+  }
+
+  /**
+   * Send a message into a webchat conversation as an agent.
+   * @param {string} widgetId
+   * @param {string} engagementSessionId
+   * @param {Object} options
+   * @param {string} options.message
+   * @param {Object} [options.media]
+   * @returns {Promise<Object>}
+   */
+  async send(widgetId, engagementSessionId, options) {
+    this.sdk.validateParams(
+      {
+        widgetId,
+        engagementSessionId,
+        message: options?.message,
+      },
+      {
+        widgetId: { type: 'string', required: true },
+        engagementSessionId: { type: 'string', required: true },
+        message: { type: 'string', required: true },
+      },
+    );
+
+    const params = { body: { ...options } };
+
+    return internalRequest(
+      this.sdk,
+      `/webchat/widgets/${widgetId}/conversations/${engagementSessionId}/messages`,
+      'POST',
+      params,
+    );
+  }
+}
+
+export class WebchatConversationsService {
+  constructor(sdk) {
+    this.sdk = sdk;
+    this.messages = new WebchatConversationMessagesService(sdk);
+  }
+
+  /**
+   * Send a typing indicator into a webchat conversation as an agent.
+   * @param {string} widgetId
+   * @param {string} engagementSessionId
+   * @param {boolean} isTyping
+   * @returns {Promise<Object>}
+   */
+  async typing(widgetId, engagementSessionId, isTyping) {
+    this.sdk.validateParams(
+      { widgetId, engagementSessionId },
+      {
+        widgetId: { type: 'string', required: true },
+        engagementSessionId: { type: 'string', required: true },
+      },
+    );
+
+    const params = { body: { isTyping: isTyping !== false } };
+
+    return internalRequest(
+      this.sdk,
+      `/webchat/widgets/${widgetId}/conversations/${engagementSessionId}/typing`,
+      'POST',
+      params,
+    );
+  }
+
+  /**
+   * Look up a webchat conversation by engagementSessionId -- resolves the
+   * widgetId + verified-visitor badge data for the agent thread.
+   * @param {string} engagementSessionId
+   * @returns {Promise<Object>}
+   */
+  async get(engagementSessionId) {
+    this.sdk.validateParams(
+      { engagementSessionId },
+      { engagementSessionId: { type: 'string', required: true } },
+    );
+
+    return internalRequest(
+      this.sdk,
+      `/webchat/widgets/conversations/${engagementSessionId}`,
+      'GET',
+    );
+  }
+}
+
 export class WebchatService {
   constructor(sdk) {
     this.sdk = sdk;
     this.widgets = new WebchatWidgetsService(sdk);
+    this.conversations = new WebchatConversationsService(sdk);
   }
 }