@unboundcx/sdk 4.13.80 → 4.13.82

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@unboundcx/sdk",
-  "version": "4.13.80",
+  "version": "4.13.82",
   "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/permissions.js

@@ -5,7 +5,12 @@ export class PermissionsService {
   }
 
   /**
-   * List permission groups
+   * List permission groups. Server-filtered to what the caller can see
+   * (group access model): account admin / admin:group:manage /
+   * admin:group:view see every group; a group manager or member sees only
+   * their own group(s). Each row carries `members: [{id, role}]`,
+   * `canManage` (name/description/members), and `canManagePermissionSets`
+   * (account admin / admin:group:manage only).
    * @returns {Promise<Object>} Object with results: Array of permission groups
    * @example
    * const { results } = await sdk.permissions.listGroups();
@@ -112,11 +117,13 @@ export class PermissionsService {
    * Add a user to a permission group
    * @param {string} groupId - Group ID
    * @param {string} userId - User ID to add
+   * @param {string} [role] - 'member' (default) or 'manager'
    * @returns {Promise<Object>} Membership confirmation
    * @example
    * await sdk.permissions.addGroupMember('group-123', 'user-456');
+   * await sdk.permissions.addGroupMember('group-123', 'user-456', 'manager');
    */
-  async addGroupMember(groupId, userId) {
+  async addGroupMember(groupId, userId, role) {
     groupId = String(groupId);
     userId = String(userId);
     this.sdk.validateParams(
@@ -127,11 +134,14 @@ export class PermissionsService {
       },
     );
 
+    const body = { userId };
+    if (role !== undefined) body.role = role;
+
     const params = {
-      body: { userId },
+      body,
     };
 
-    const result = await internalRequest(this.sdk, 
+    const result = await internalRequest(this.sdk,
       `/permissions/groups/${groupId}/members`,
       'POST',
       params,
@@ -139,6 +149,41 @@ export class PermissionsService {
     return result;
   }
 
+  /**
+   * Change a group member's role (Member / Manager) — group-manager-safe:
+   * account admin, admin:group:manage, or a manager of this group can call
+   * it; plain members cannot.
+   * @param {string} groupId - Group ID
+   * @param {string} userId - User ID
+   * @param {string} role - 'member' or 'manager'
+   * @returns {Promise<Object>} { groupId, userId, role }
+   * @example
+   * await sdk.permissions.updateGroupMemberRole('group-123', 'user-456', 'manager');
+   */
+  async updateGroupMemberRole(groupId, userId, role) {
+    groupId = String(groupId);
+    userId = String(userId);
+    this.sdk.validateParams(
+      { groupId, userId, role },
+      {
+        groupId: { type: 'string', required: true },
+        userId: { type: 'string', required: true },
+        role: { type: 'string', required: true },
+      },
+    );
+
+    const params = {
+      body: { role },
+    };
+
+    const result = await internalRequest(this.sdk,
+      `/permissions/groups/${groupId}/members/${userId}`,
+      'PUT',
+      params,
+    );
+    return result;
+  }
+
   /**
    * Remove a user from a permission group
    * @param {string} groupId - Group ID

package/services/reportingAgents.js

@@ -88,9 +88,10 @@ export class ReportingAgentsService {
   }
 
   /**
-   * Per-agent per-local-day timesheet rows (net paid hours).
+   * Per-agent per-local-day timesheet rows (net paid hours), plus one
+   * additive-sum row per agent (`agents`) for grouped totals.
    * @param {Object} params - { from, to, userIds, teamIds }
-   * @returns {Promise<Object>} { columns, rows }
+   * @returns {Promise<Object>} { columns, rows, agents }
    * @example
    * await sdk.reporting.agents.timesheet({ from, to, userIds: ['u1'] });
    */
@@ -107,13 +108,26 @@ export class ReportingAgentsService {
   }
 
   /**
-   * CSV export of any of the four views above.
-   * @param {Object} params - { view: 'summary'|'states'|'interactions'|'timesheet', from, to, userId, userIds, queueIds, teamIds, groupBy }
+   * CSV export of any of the four views above. For view: 'timesheet', pass
+   * `totals: true` to get one additive-sum row per agent instead of the
+   * flat per-agent-per-day rows.
+   * @param {Object} params - { view: 'summary'|'states'|'interactions'|'timesheet', from, to, userId, userIds, queueIds, teamIds, groupBy, totals }
    * @returns {Promise<Object>} raw CSV response (transport-dependent)
    * @example
    * await sdk.reporting.agents.export({ view: 'timesheet', from, to });
+   * await sdk.reporting.agents.export({ view: 'timesheet', from, to, totals: true });
    */
-  async export({ view, from, to, userId, userIds, queueIds, teamIds, groupBy } = {}) {
+  async export({
+    view,
+    from,
+    to,
+    userId,
+    userIds,
+    queueIds,
+    teamIds,
+    groupBy,
+    totals,
+  } = {}) {
     this.sdk.validateParams(
       { from, to },
       { from: { type: 'string', required: true }, to: { type: 'string', required: true } },
@@ -127,6 +141,7 @@ export class ReportingAgentsService {
       queueIds,
       teamIds,
       groupBy,
+      totals: totals ? '1' : undefined,
       format: 'csv',
     });
     return internalRequest(this.sdk, `/reporting/agents/export${qs}`, 'GET', { httpOnly: true });