@unboundcx/sdk 4.5.0 → 4.6.0

package/services/permissions.js

@@ -374,4 +374,115 @@ export class PermissionsService {
     const result = await this.sdk._fetch('/permissions/scope-catalog', 'GET');
     return result;
   }
+
+  /**
+   * Catalog of group-settable configuration keys, plus the never-settable list.
+   * @returns {Promise<Object>} { groupSettable: [{key,label,type,pillar,...}], neverSettable: [] }
+   */
+  async getSettingsCatalog() {
+    return this.sdk._fetch('/permissions/settings/catalog', 'GET');
+  }
+
+  /**
+   * Configuration values set at group level.
+   * @param {string|number} groupId - Group ID (required)
+   * @returns {Promise<Object>} { results: [{settingKey, value, updatedAt}] }
+   */
+  async listGroupSettings(groupId) {
+    groupId = String(groupId);
+    this.sdk.validateParams({ groupId }, { groupId: { type: 'string', required: true } });
+    return this.sdk._fetch(`/permissions/groups/${groupId}/settings`, 'GET');
+  }
+
+  /** Set one configuration value on a group. */
+  async setGroupSetting(groupId, settingKey, value) {
+    groupId = String(groupId);
+    settingKey = String(settingKey);
+    this.sdk.validateParams(
+      { groupId, settingKey },
+      {
+        groupId: { type: 'string', required: true },
+        settingKey: { type: 'string', required: true },
+      },
+    );
+    return this.sdk._fetch(
+      `/permissions/groups/${groupId}/settings/${settingKey}`,
+      'PUT',
+      { value },
+    );
+  }
+
+  /** Unset one configuration value on a group (members revert to the next tier). */
+  async deleteGroupSetting(groupId, settingKey) {
+    groupId = String(groupId);
+    settingKey = String(settingKey);
+    this.sdk.validateParams(
+      { groupId, settingKey },
+      {
+        groupId: { type: 'string', required: true },
+        settingKey: { type: 'string', required: true },
+      },
+    );
+    return this.sdk._fetch(
+      `/permissions/groups/${groupId}/settings/${settingKey}`,
+      'DELETE',
+    );
+  }
+
+  /**
+   * Rank groups for same-key conflict resolution; first entry wins.
+   * @param {Array<string|number>} order - Group IDs, highest priority first
+   */
+  async setGroupPriority(order) {
+    this.sdk.validateParams({ order }, { order: { type: 'array', required: true } });
+    return this.sdk._fetch('/permissions/groups/priority', 'PUT', {
+      order: order.map(String),
+    });
+  }
+
+  /**
+   * Resolved configuration for a user: value, where it came from, and any
+   * losing group values for the same key.
+   * @returns {Promise<Object>} { [key]: { value, source: {tier, groupId, groupName}, conflicts: [] } }
+   */
+  async getUserSettings(userId) {
+    userId = String(userId);
+    this.sdk.validateParams({ userId }, { userId: { type: 'string', required: true } });
+    return this.sdk._fetch(`/permissions/users/${userId}/settings`, 'GET');
+  }
+
+  /** Override one configuration value for a single user. */
+  async setUserSetting(userId, settingKey, value) {
+    userId = String(userId);
+    settingKey = String(settingKey);
+    this.sdk.validateParams(
+      { userId, settingKey },
+      {
+        userId: { type: 'string', required: true },
+        settingKey: { type: 'string', required: true },
+      },
+    );
+    return this.sdk._fetch(
+      `/permissions/users/${userId}/settings/${settingKey}`,
+      'PUT',
+      { value },
+    );
+  }
+
+  /** Clear a user's override, reverting to the inherited value. */
+  async deleteUserSetting(userId, settingKey) {
+    userId = String(userId);
+    settingKey = String(settingKey);
+    this.sdk.validateParams(
+      { userId, settingKey },
+      {
+        userId: { type: 'string', required: true },
+        settingKey: { type: 'string', required: true },
+      },
+    );
+    return this.sdk._fetch(
+      `/permissions/users/${userId}/settings/${settingKey}`,
+      'DELETE',
+    );
+  }
 }

package/services/storage.js

@@ -463,7 +463,7 @@ Response:
    * @param {string} [config.convertTo] - Convert uploaded file to this format before storing. Supported: 'pdf', 'tiff'. Input must be PDF, DOC, or DOCX.
    * @param {Object} [config.convertOptions] - Options for file conversion (used with convertTo)
    * @param {('fine'|'normal')} [config.convertOptions.resolution='fine'] - Fax resolution: 'fine' (204x196) or 'normal' (204x98)
-   * @param {('letter'|'a4')} [config.convertOptions.paperSize='letter'] - Paper size for conversion
+   * @param {('letter'|'legal'|'a4')} [config.convertOptions.paperSize='letter'] - Paper size for conversion
    * @param {('g4'|'g3')} [config.convertOptions.compression='g4'] - TIFF compression: 'g4' (default) or 'g3' for older fax machines
    * @param {Function} [config.onProgress] - Progress callback for browser uploads
    * @param {Object} [config._options] - Internal options
@@ -1005,7 +1005,7 @@ Response:
    * @param {string} config.convertTo - Target format: 'pdf' or 'tiff' (required)
    * @param {Object} [config.convertOptions] - Options controlling the conversion output
    * @param {('fine'|'normal')} [config.convertOptions.resolution='fine'] - Fax resolution: 'fine' (204x196 DPI) or 'normal' (204x98 DPI)
-   * @param {('letter'|'a4')} [config.convertOptions.paperSize='letter'] - Paper size for conversion
+   * @param {('letter'|'legal'|'a4')} [config.convertOptions.paperSize='letter'] - Paper size for conversion
    * @param {('g4'|'g3')} [config.convertOptions.compression='g4'] - TIFF compression: 'g4' (modern, default) or 'g3' (legacy fax machines)
    * @param {string} [config.classification] - Storage classification for the new file. Defaults to source file's classification.
    * @param {string} [config.folder] - Folder path for the new file. Defaults to source file's folder.

package/test-complete-coverage.js

@@ -41,6 +41,7 @@ async function testPublicSDKCompleteness() {
     'phoneNumbers',
     'recordTypes',
     'generateId',
+    'documents',
   ];
 
   console.log(`📊 Checking ${publicServices.length} public services...`);