@unboundcx/sdk 4.13.9 → 4.13.11

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@unboundcx/sdk",
-  "version": "4.13.9",
+  "version": "4.13.11",
   "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/schemas/layouts/section.js

@@ -101,6 +101,18 @@ const TimelineSection = BaseSection.extend({
   showFilters: z.boolean().default(true),
 });
 
+// Email section (people/company/opportunities detail pages) — renders a
+// record-scoped, filtered view over app1-api's GET /object/:id/emails
+// (thread-grouped mailbox data), not a table/kanban query.
+const EmailSection = BaseSection.extend({
+  type: z.literal('email'),
+  limit: z.number().int().positive().default(25),
+  showSearch: z.boolean().default(true),
+  showMailboxFilter: z.boolean().default(true),
+  showCompose: z.boolean().default(true),
+  hideWhenEmpty: z.boolean().default(true),
+});
+
 const TableKanbanSection = BaseSection.extend({
   type: z.literal('table-kanban'),
   defaultView: z.enum(['table', 'kanban']).default('table'),
@@ -118,5 +130,5 @@ const TableKanbanSection = BaseSection.extend({
 // function.
 export const SectionSpec = z.discriminatedUnion('type', [
   ContentSection, TableSection, KanbanSection, TableKanbanSection, WidgetSection,
-  TimelineSection,
+  TimelineSection, EmailSection,
 ]);

package/services/messaging/EmailService.js

@@ -56,7 +56,9 @@ export class EmailService {
    * @param {Array} [params.storageId] - Array of storage IDs for attachments
    * @param {string} [params.replyTo] - Reply-to email address
    * @param {string} [params.replyToEmailId] - ID of email this is replying to
-   * @param {string} [params.relatedId] - Related record ID
+   * @param {string} [params.relatedId] - Related record ID (e.g. opportunity)
+   * @param {string} [params.peopleId] - Person record ID to link the email to
+   * @param {string} [params.companyId] - Company record ID to link the email to
    * @param {string} [params.emailType='marketing'] - Email type: 'marketing' or 'transactional'
    * @param {boolean} [params.tracking=true] - Enable email tracking (opens, clicks)
    * @param {string} [params.mailboxId] - Specific mailbox to send from
@@ -77,6 +79,8 @@ export class EmailService {
     replyTo,
     replyToEmailId,
     relatedId,
+    peopleId,
+    companyId,
     emailType,
     tracking,
     mailboxId,
@@ -107,6 +111,8 @@ export class EmailService {
         replyTo,
         replyToEmailId,
         relatedId,
+        peopleId,
+        companyId,
         emailType,
         tracking,
         mailboxId,
@@ -122,6 +128,8 @@ export class EmailService {
         replyTo: { type: 'string', required: false },
         replyToEmailId: { type: 'string', required: false },
         relatedId: { type: 'string', required: false },
+        peopleId: { type: 'string', required: false },
+        companyId: { type: 'string', required: false },
         emailType: { type: 'string', required: false },
         tracking: { type: 'boolean', required: false },
         mailboxId: { type: 'string', required: false },
@@ -145,6 +153,8 @@ export class EmailService {
     if (replyTo) emailData.replyTo = replyTo;
     if (replyToEmailId) emailData.replyToEmailId = replyToEmailId;
     if (relatedId) emailData.relatedId = relatedId;
+    if (peopleId) emailData.peopleId = peopleId;
+    if (companyId) emailData.companyId = companyId;
     if (emailType) emailData.emailType = emailType;
     if (tracking !== undefined) emailData.tracking = tracking;
     if (mailboxId) emailData.mailboxId = mailboxId;
@@ -250,7 +260,9 @@ export class EmailService {
    * @param {Array} [params.storageId] - Array of storage IDs for attachments
    * @param {string} [params.replyTo] - Reply-to email address
    * @param {string} [params.replyToEmailId] - ID of email this is replying to
-   * @param {string} [params.relatedId] - Related record ID
+   * @param {string} [params.relatedId] - Related record ID (e.g. opportunity)
+   * @param {string} [params.peopleId] - Person record ID to link the draft to
+   * @param {string} [params.companyId] - Company record ID to link the draft to
    * @param {string} [params.emailType='marketing'] - Email type: 'marketing' or 'transactional'
    * @param {boolean} [params.tracking=true] - Enable email tracking (opens, clicks)
    * @param {string} [params.mailboxId] - Specific mailbox for the draft
@@ -272,6 +284,8 @@ export class EmailService {
     replyTo,
     replyToEmailId,
     relatedId,
+    peopleId,
+    companyId,
     emailType,
     tracking,
     mailboxId,
@@ -293,6 +307,8 @@ export class EmailService {
         replyTo,
         replyToEmailId,
         relatedId,
+        peopleId,
+        companyId,
         emailType,
         tracking,
         mailboxId,
@@ -310,6 +326,8 @@ export class EmailService {
         replyTo: { type: 'string', required: false },
         replyToEmailId: { type: 'string', required: false },
         relatedId: { type: 'string', required: false },
+        peopleId: { type: 'string', required: false },
+        companyId: { type: 'string', required: false },
         emailType: { type: 'string', required: false },
         tracking: { type: 'boolean', required: false },
         mailboxId: { type: 'string', required: false },
@@ -333,6 +351,8 @@ export class EmailService {
     if (replyTo) draftData.replyTo = replyTo;
     if (replyToEmailId) draftData.replyToEmailId = replyToEmailId;
     if (relatedId) draftData.relatedId = relatedId;
+    if (peopleId) draftData.peopleId = peopleId;
+    if (companyId) draftData.companyId = companyId;
     if (emailType) draftData.emailType = emailType;
     if (tracking !== undefined) draftData.tracking = tracking;
     if (mailboxId) draftData.mailboxId = mailboxId;
@@ -367,6 +387,9 @@ export class EmailService {
    * @param {Object} [params.variables] - Template variables for substitution
    * @param {Array} [params.storageId] - Array of storage IDs for attachments
    * @param {string} [params.replyTo] - Reply-to email address
+   * @param {string} [params.relatedId] - Related record ID (e.g. opportunity)
+   * @param {string} [params.peopleId] - Person record ID to link the draft to
+   * @param {string} [params.companyId] - Company record ID to link the draft to
    * @param {string} [params.emailType] - Email type: 'marketing' or 'transactional'
    * @param {boolean} [params.tracking] - Enable email tracking (opens, clicks)
    * @param {string} [params.mailboxId] - Specific mailbox for the draft
@@ -387,6 +410,9 @@ export class EmailService {
       variables,
       storageId,
       replyTo,
+      relatedId,
+      peopleId,
+      companyId,
       emailType,
       tracking,
       mailboxId,
@@ -407,6 +433,9 @@ export class EmailService {
         variables,
         storageId,
         replyTo,
+        relatedId,
+        peopleId,
+        companyId,
         emailType,
         tracking,
         mailboxId,
@@ -422,6 +451,9 @@ export class EmailService {
         variables: { type: 'object', required: false },
         storageId: { type: 'array', required: false },
         replyTo: { type: 'string', required: false },
+        relatedId: { type: 'string', required: false },
+        peopleId: { type: 'string', required: false },
+        companyId: { type: 'string', required: false },
         emailType: { type: 'string', required: false },
         tracking: { type: 'boolean', required: false },
         mailboxId: { type: 'string', required: false },
@@ -442,6 +474,9 @@ export class EmailService {
     if (variables !== undefined) updateData.variables = variables;
     if (storageId !== undefined) updateData.storageId = storageId;
     if (replyTo !== undefined) updateData.replyTo = replyTo;
+    if (relatedId !== undefined) updateData.relatedId = relatedId;
+    if (peopleId !== undefined) updateData.peopleId = peopleId;
+    if (companyId !== undefined) updateData.companyId = companyId;
     if (emailType !== undefined) updateData.emailType = emailType;
     if (tracking !== undefined) updateData.tracking = tracking;
     if (mailboxId !== undefined) updateData.mailboxId = mailboxId;

package/services/objects.js

@@ -1165,6 +1165,35 @@ export class ObjectsService {
     );
   }
 
+  /**
+   * Thread-grouped, record-scoped emails for a single record (person,
+   * company, or opportunity) — filtered mailbox view used by the `email`
+   * layout section (see schemas/layouts/section.js).
+   * @param {string} recordId
+   * @param {object} [options]
+   * @param {number} [options.limit]
+   * @param {number} [options.offset]
+   * @param {string} [options.search]
+   * @param {string} [options.mailboxId]
+   * @param {boolean} [options.unreadOnly]
+   * @returns {Promise<{threads: object[], total: number, unreadCount: number, mailboxes: object[]}>}
+   */
+  async getRecordEmails(recordId, { limit, offset, search, mailboxId, unreadOnly } = {}) {
+    this.sdk.validateParams(
+      { recordId },
+      { recordId: { type: 'string', required: true } },
+    );
+    const query = {};
+    if (limit) query.limit = limit;
+    if (offset) query.offset = offset;
+    if (search) query.search = search;
+    if (mailboxId) query.mailboxId = mailboxId;
+    if (unreadOnly) query.unreadOnly = unreadOnly;
+    return internalRequest(this.sdk, `/object/${recordId}/emails`, 'GET', {
+      query,
+    });
+  }
+
   /**
    * Marketing programs dashboard (programs + totals).
    * @returns {Promise<object>}

package/services/taskRouter/TaskService.js

@@ -844,4 +844,25 @@ export class TaskService {
     const result = await internalRequest(this.sdk, '/taskRouter/tasks/', 'PUT', params);
     return result;
   }
+
+  /**
+   * Get the voice transcript for a task, keyed by the media-manager
+   * bridgeId (not sipCallId) so it works across requeue/transfer.
+   *
+   * @param {string} taskId - The task ID to fetch a transcript for
+   * @returns {Promise<Object>} { bridgeId, messages } — bridgeId is null
+   *   and messages is [] for chat/email tasks or tasks with no bridge yet.
+   */
+  async getTranscript(taskId) {
+    this.sdk.validateParams(
+      { taskId },
+      { taskId: { type: 'string', required: true } },
+    );
+    return await internalRequest(
+      this.sdk,
+      `/taskRouter/tasks/${taskId}/transcript`,
+      'GET',
+      {},
+    );
+  }
 }