@webex/contact-center 3.11.0 → 3.12.0-auth-prejoin-fetch.1

package/dist/services/Queue.js

@@ -71,14 +71,16 @@ class Queue {
   }
 
   /**
-   * Fetches contact service queues for the organization
-   * @param {ContactServiceQueueSearchParams} [params] - Search and pagination parameters
+   * Fetches contact service queues for the organization. By default, returns active inbound
+   * telephony queues in backend name-ascending order using the agent's desktop profile views.
+   * Existing filter, sort, and desktop-profile parameters override those defaults.
+   * @param {ContactServiceQueueSearchParams} [params] - Search, pagination, and override parameters
    * @returns {Promise<ContactServiceQueuesResponse>} Promise resolving to contact service queues
    * @throws {Error} If the API call fails
    * @public
    * @example
    * ```typescript
-   * // Get all queues with default pagination
+   * // Get queues using the default list policy and pagination
    * const response = await queueAPI.getQueues();
    *
    * // Get queues with specific pagination
@@ -100,16 +102,28 @@ class Queue {
       page = _PageCache.PAGINATION_DEFAULTS.PAGE,
       pageSize = _PageCache.PAGINATION_DEFAULTS.PAGE_SIZE,
       search,
-      filter,
+      filter = 'queueType==INBOUND;channelType==TELEPHONY;active==true',
       attributes,
-      sortBy,
-      sortOrder,
-      desktopProfileFilter,
+      sortBy = 'name',
+      sortOrder = 'asc',
+      desktopProfileFilter = true,
       provisioningView,
       singleObjectResponse
     } = params;
+    const agentView = desktopProfileFilter;
+    const firstLevelView = desktopProfileFilter;
     const orgId = this.webex.credentials.getOrgId();
-    const isSearchRequest = !!(search || filter || attributes || sortBy);
+    const effectiveSortBy = sortBy ?? (sortOrder ? 'name' : undefined);
+    const isSearchRequest = !!(search || filter || attributes || effectiveSortBy);
+    const canUseCache = this.pageCache.canUseCache({
+      search,
+      filter,
+      attributes,
+      sortBy: effectiveSortBy,
+      desktopProfileFilter,
+      provisioningView,
+      singleObjectResponse
+    });
     _loggerProxy.default.info('Fetching contact service queues', {
       module: 'Queue',
       method: _constants4.METHODS.GET_QUEUES,
@@ -122,12 +136,7 @@ class Queue {
     });
 
     // Check if we can use cache for simple pagination (no search/filter/attributes/sort)
-    if (this.pageCache.canUseCache({
-      search,
-      filter,
-      attributes,
-      sortBy
-    })) {
+    if (canUseCache) {
       const cacheKey = this.pageCache.buildCacheKey(orgId, page, pageSize);
       const cachedPage = this.pageCache.getCachedPage(cacheKey);
       if (cachedPage) {
@@ -167,11 +176,12 @@ class Queue {
       if (filter) queryParams.append('filter', filter);
       if (attributes) queryParams.append('attributes', attributes);
       if (search) queryParams.append('search', search);
-      if (sortBy) queryParams.append('sortBy', sortBy);
-      if (sortOrder) queryParams.append('sortOrder', sortOrder);
+      if (effectiveSortBy) queryParams.append('sort', `${effectiveSortBy},${(sortOrder ?? 'asc').toUpperCase()}`);
       if (desktopProfileFilter !== undefined) queryParams.append('desktopProfileFilter', desktopProfileFilter.toString());
       if (provisioningView !== undefined) queryParams.append('provisioningView', provisioningView.toString());
       if (singleObjectResponse !== undefined) queryParams.append('singleObjectResponse', singleObjectResponse.toString());
+      if (agentView !== undefined) queryParams.append('agentView', agentView.toString());
+      if (firstLevelView !== undefined) queryParams.append('firstLevelView', firstLevelView.toString());
       const resource = _constants2.endPointMap.queueList(orgId, queryParams.toString());
       _loggerProxy.default.log('Making API request to fetch contact service queues', {
         module: 'Queue',
@@ -216,12 +226,7 @@ class Queue {
       }
 
       // Cache the page data for simple pagination (no search/filter/attributes/sort)
-      if (this.pageCache.canUseCache({
-        search,
-        filter,
-        attributes,
-        sortBy
-      }) && response.body?.data) {
+      if (canUseCache && response.body?.data) {
         const cacheKey = this.pageCache.buildCacheKey(orgId, page, pageSize);
         this.pageCache.cachePage(cacheKey, response.body.data, response.body.meta);
         _loggerProxy.default.log('Cached contact service queues for future requests', {

package/dist/services/Queue.js.map

@@ -1 +1 @@
-{"version":3,"names":["_types","require","_loggerProxy","_interopRequireDefault","_WebexRequest","_PageCache","_interopRequireWildcard","_MetricsManager","_constants","_constants2","_constants3","_constants4","e","t","WeakMap","r","n","__esModule","o","i","f","__proto__","default","has","get","set","hasOwnProperty","call","Object","defineProperty","getOwnPropertyDescriptor","Queue","constructor","webex","webexRequest","WebexRequest","getInstance","pageCache","PageCache","metricsManager","MetricsManager","getQueues","params","startTime","Date","now","page","PAGINATION_DEFAULTS","PAGE","pageSize","PAGE_SIZE","search","filter","attributes","sortBy","sortOrder","desktopProfileFilter","provisioningView","singleObjectResponse","orgId","credentials","getOrgId","isSearchRequest","LoggerProxy","info","module","method","METHODS","GET_QUEUES","data","canUseCache","cacheKey","buildCacheKey","cachedPage","getCachedPage","duration","log","cacheHit","recordCount","length","meta","totalPages","totalMeta","totalRecords","orgid","timeEvent","METRIC_EVENT_NAMES","QUEUE_FETCH_SUCCESS","queryParams","URLSearchParams","toString","append","undefined","resource","endPointMap","queueList","service","WCC_API_GATEWAY","response","request","HTTP_METHODS","GET","body","statusCode","trackEvent","isFirstPage","cachePage","error","errorData","Error","message","String","QUEUE_FETCH_FAILED","exports","_default"],"sources":["Queue.ts"],"sourcesContent":["import {HTTP_METHODS, WebexSDK} from '../types';\nimport type {\n  ContactServiceQueue,\n  ContactServiceQueuesResponse,\n  ContactServiceQueueSearchParams,\n} from '../types';\nimport LoggerProxy from '../logger-proxy';\nimport WebexRequest from './core/WebexRequest';\nimport PageCache, {PAGINATION_DEFAULTS} from '../utils/PageCache';\nimport MetricsManager from '../metrics/MetricsManager';\nimport {WCC_API_GATEWAY} from './constants';\nimport {endPointMap} from './config/constants';\nimport {METRIC_EVENT_NAMES} from '../metrics/constants';\nimport {METHODS} from '../constants';\n\n/**\n * Queue API class for managing Webex Contact Center contact service queues.\n * Provides functionality to fetch contact service queues using the queue API.\n *\n * @class Queue\n * @public\n * @example\n * ```typescript\n * import Webex from 'webex';\n *\n * const webex = new Webex({ credentials: 'YOUR_ACCESS_TOKEN' });\n * const cc = webex.cc;\n *\n * // Register and login first\n * await cc.register();\n * await cc.stationLogin({ teamId: 'team123', loginOption: 'BROWSER' });\n *\n * // Get Queue API instance from ContactCenter\n * const queueAPI = cc.queue;\n *\n * // Get all queues\n * const queues = await queueAPI.getQueues();\n *\n * // Get queues with pagination\n * const queues = await queueAPI.getQueues({\n *   page: 0,\n *   pageSize: 50\n * });\n *\n * // Search for specific queues\n * const searchResults = await queueAPI.getQueues({\n *   search: 'support',\n *   filter: 'name==\"Support Queue\"'\n * });\n * ```\n */\nexport class Queue {\n  private webexRequest: WebexRequest;\n  private webex: WebexSDK;\n  private metricsManager: MetricsManager;\n\n  // Page cache using the common utility\n  private pageCache: PageCache<ContactServiceQueue>;\n\n  /**\n   * Creates an instance of Queue\n   * @param {WebexSDK} webex - The Webex SDK instance\n   * @public\n   */\n  constructor(webex: WebexSDK) {\n    this.webex = webex;\n    this.webexRequest = WebexRequest.getInstance({webex});\n    this.pageCache = new PageCache<ContactServiceQueue>('Queue');\n    this.metricsManager = MetricsManager.getInstance({webex});\n  }\n\n  /**\n   * Fetches contact service queues for the organization\n   * @param {ContactServiceQueueSearchParams} [params] - Search and pagination parameters\n   * @returns {Promise<ContactServiceQueuesResponse>} Promise resolving to contact service queues\n   * @throws {Error} If the API call fails\n   * @public\n   * @example\n   * ```typescript\n   * // Get all queues with default pagination\n   * const response = await queueAPI.getQueues();\n   *\n   * // Get queues with specific pagination\n   * const response = await queueAPI.getQueues({\n   *   page: 0,\n   *   pageSize: 25\n   * });\n   *\n   * // Search for queues\n   * const response = await queueAPI.getQueues({\n   *   search: 'support',\n   *   filter: 'queueType==\"INBOUND\"'\n   * });\n   * ```\n   */\n  public async getQueues(\n    params: ContactServiceQueueSearchParams = {}\n  ): Promise<ContactServiceQueuesResponse> {\n    const startTime = Date.now();\n    const {\n      page = PAGINATION_DEFAULTS.PAGE,\n      pageSize = PAGINATION_DEFAULTS.PAGE_SIZE,\n      search,\n      filter,\n      attributes,\n      sortBy,\n      sortOrder,\n      desktopProfileFilter,\n      provisioningView,\n      singleObjectResponse,\n    } = params;\n\n    const orgId = this.webex.credentials.getOrgId();\n    const isSearchRequest = !!(search || filter || attributes || sortBy);\n\n    LoggerProxy.info('Fetching contact service queues', {\n      module: 'Queue',\n      method: METHODS.GET_QUEUES,\n      data: {\n        orgId,\n        page,\n        pageSize,\n        isSearchRequest,\n      },\n    });\n\n    // Check if we can use cache for simple pagination (no search/filter/attributes/sort)\n    if (this.pageCache.canUseCache({search, filter, attributes, sortBy})) {\n      const cacheKey = this.pageCache.buildCacheKey(orgId, page, pageSize);\n      const cachedPage = this.pageCache.getCachedPage(cacheKey);\n\n      if (cachedPage) {\n        const duration = Date.now() - startTime;\n\n        LoggerProxy.log(`Returning page ${page} from cache`, {\n          module: 'Queue',\n          method: 'getQueues',\n          data: {\n            cacheHit: true,\n            duration,\n            recordCount: cachedPage.data.length,\n            page,\n            pageSize,\n          },\n        });\n\n        return {\n          data: cachedPage.data,\n          meta: {\n            page,\n            pageSize,\n            totalPages: cachedPage.totalMeta?.totalPages,\n            totalRecords: cachedPage.totalMeta?.totalRecords,\n            orgid: orgId,\n          },\n        };\n      }\n    }\n\n    // Start timing only for actual API calls (not cache hits)\n    this.metricsManager.timeEvent(METRIC_EVENT_NAMES.QUEUE_FETCH_SUCCESS);\n\n    try {\n      // Build query parameters according to spec\n      const queryParams = new URLSearchParams({\n        page: page.toString(),\n        pageSize: pageSize.toString(),\n      });\n\n      if (filter) queryParams.append('filter', filter);\n      if (attributes) queryParams.append('attributes', attributes);\n      if (search) queryParams.append('search', search);\n      if (sortBy) queryParams.append('sortBy', sortBy);\n      if (sortOrder) queryParams.append('sortOrder', sortOrder);\n      if (desktopProfileFilter !== undefined)\n        queryParams.append('desktopProfileFilter', desktopProfileFilter.toString());\n      if (provisioningView !== undefined)\n        queryParams.append('provisioningView', provisioningView.toString());\n      if (singleObjectResponse !== undefined)\n        queryParams.append('singleObjectResponse', singleObjectResponse.toString());\n\n      const resource = endPointMap.queueList(orgId, queryParams.toString());\n\n      LoggerProxy.log('Making API request to fetch contact service queues', {\n        module: 'Queue',\n        method: METHODS.GET_QUEUES,\n        data: {\n          resource,\n          service: WCC_API_GATEWAY,\n        },\n      });\n\n      const response = await this.webexRequest.request({\n        service: WCC_API_GATEWAY,\n        resource,\n        method: HTTP_METHODS.GET,\n      });\n\n      const duration = Date.now() - startTime;\n\n      const recordCount = response.body?.data?.length || 0;\n      const totalRecords = response.body?.meta?.totalRecords;\n\n      LoggerProxy.log(`Successfully retrieved ${recordCount} contact service queues`, {\n        module: 'Queue',\n        method: METHODS.GET_QUEUES,\n        data: {\n          statusCode: response.statusCode,\n          duration,\n          recordCount,\n          totalRecords,\n          isSearchRequest,\n          page,\n          pageSize,\n        },\n      });\n\n      // Only track metrics for search requests or first page loads to reduce metric volume\n      if (isSearchRequest || page === 0) {\n        this.metricsManager.trackEvent(\n          METRIC_EVENT_NAMES.QUEUE_FETCH_SUCCESS,\n          {\n            orgId,\n            statusCode: response.statusCode,\n            recordCount,\n            totalRecords,\n            isSearchRequest,\n            isFirstPage: page === 0,\n          },\n          ['behavioral', 'operational']\n        );\n      }\n\n      // Cache the page data for simple pagination (no search/filter/attributes/sort)\n      if (this.pageCache.canUseCache({search, filter, attributes, sortBy}) && response.body?.data) {\n        const cacheKey = this.pageCache.buildCacheKey(orgId, page, pageSize);\n        this.pageCache.cachePage(cacheKey, response.body.data, response.body.meta);\n\n        LoggerProxy.log('Cached contact service queues for future requests', {\n          module: 'Queue',\n          method: METHODS.GET_QUEUES,\n          data: {\n            cacheKey,\n            recordCount,\n          },\n        });\n      }\n\n      return response.body;\n    } catch (error) {\n      const errorData = {\n        orgId,\n        error: error instanceof Error ? error.message : String(error),\n        isSearchRequest,\n        page,\n        pageSize,\n      };\n\n      LoggerProxy.error('Failed to fetch contact service queues', {\n        module: 'Queue',\n        method: METHODS.GET_QUEUES,\n        data: errorData,\n        error,\n      });\n\n      // Track all failures for troubleshooting\n      this.metricsManager.trackEvent(METRIC_EVENT_NAMES.QUEUE_FETCH_FAILED, errorData, [\n        'behavioral',\n        'operational',\n      ]);\n\n      throw error;\n    }\n  }\n}\n\nexport default Queue;\n"],"mappings":"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","ignoreList":[]}
+{"version":3,"names":["_types","require","_loggerProxy","_interopRequireDefault","_WebexRequest","_PageCache","_interopRequireWildcard","_MetricsManager","_constants","_constants2","_constants3","_constants4","e","t","WeakMap","r","n","__esModule","o","i","f","__proto__","default","has","get","set","hasOwnProperty","call","Object","defineProperty","getOwnPropertyDescriptor","Queue","constructor","webex","webexRequest","WebexRequest","getInstance","pageCache","PageCache","metricsManager","MetricsManager","getQueues","params","startTime","Date","now","page","PAGINATION_DEFAULTS","PAGE","pageSize","PAGE_SIZE","search","filter","attributes","sortBy","sortOrder","desktopProfileFilter","provisioningView","singleObjectResponse","agentView","firstLevelView","orgId","credentials","getOrgId","effectiveSortBy","undefined","isSearchRequest","canUseCache","LoggerProxy","info","module","method","METHODS","GET_QUEUES","data","cacheKey","buildCacheKey","cachedPage","getCachedPage","duration","log","cacheHit","recordCount","length","meta","totalPages","totalMeta","totalRecords","orgid","timeEvent","METRIC_EVENT_NAMES","QUEUE_FETCH_SUCCESS","queryParams","URLSearchParams","toString","append","toUpperCase","resource","endPointMap","queueList","service","WCC_API_GATEWAY","response","request","HTTP_METHODS","GET","body","statusCode","trackEvent","isFirstPage","cachePage","error","errorData","Error","message","String","QUEUE_FETCH_FAILED","exports","_default"],"sources":["Queue.ts"],"sourcesContent":["import {HTTP_METHODS, WebexSDK} from '../types';\nimport type {\n  ContactServiceQueue,\n  ContactServiceQueuesResponse,\n  ContactServiceQueueSearchParams,\n} from '../types';\nimport LoggerProxy from '../logger-proxy';\nimport WebexRequest from './core/WebexRequest';\nimport PageCache, {PAGINATION_DEFAULTS} from '../utils/PageCache';\nimport MetricsManager from '../metrics/MetricsManager';\nimport {WCC_API_GATEWAY} from './constants';\nimport {endPointMap} from './config/constants';\nimport {METRIC_EVENT_NAMES} from '../metrics/constants';\nimport {METHODS} from '../constants';\n\n/**\n * Queue API class for managing Webex Contact Center contact service queues.\n * Provides functionality to fetch contact service queues using the queue API.\n *\n * @class Queue\n * @public\n * @example\n * ```typescript\n * import Webex from 'webex';\n *\n * const webex = new Webex({ credentials: 'YOUR_ACCESS_TOKEN' });\n * const cc = webex.cc;\n *\n * // Register and login first\n * await cc.register();\n * await cc.stationLogin({ teamId: 'team123', loginOption: 'BROWSER' });\n *\n * // Get Queue API instance from ContactCenter\n * const queueAPI = cc.queue;\n *\n * // Get all queues\n * const queues = await queueAPI.getQueues();\n *\n * // Get queues with pagination\n * const queues = await queueAPI.getQueues({\n *   page: 0,\n *   pageSize: 50\n * });\n *\n * // Search for specific queues\n * const searchResults = await queueAPI.getQueues({\n *   search: 'support',\n *   filter: 'name==\"Support Queue\"'\n * });\n * ```\n */\nexport class Queue {\n  private webexRequest: WebexRequest;\n  private webex: WebexSDK;\n  private metricsManager: MetricsManager;\n\n  // Page cache using the common utility\n  private pageCache: PageCache<ContactServiceQueue>;\n\n  /**\n   * Creates an instance of Queue\n   * @param {WebexSDK} webex - The Webex SDK instance\n   * @public\n   */\n  constructor(webex: WebexSDK) {\n    this.webex = webex;\n    this.webexRequest = WebexRequest.getInstance({webex});\n    this.pageCache = new PageCache<ContactServiceQueue>('Queue');\n    this.metricsManager = MetricsManager.getInstance({webex});\n  }\n\n  /**\n   * Fetches contact service queues for the organization. By default, returns active inbound\n   * telephony queues in backend name-ascending order using the agent's desktop profile views.\n   * Existing filter, sort, and desktop-profile parameters override those defaults.\n   * @param {ContactServiceQueueSearchParams} [params] - Search, pagination, and override parameters\n   * @returns {Promise<ContactServiceQueuesResponse>} Promise resolving to contact service queues\n   * @throws {Error} If the API call fails\n   * @public\n   * @example\n   * ```typescript\n   * // Get queues using the default list policy and pagination\n   * const response = await queueAPI.getQueues();\n   *\n   * // Get queues with specific pagination\n   * const response = await queueAPI.getQueues({\n   *   page: 0,\n   *   pageSize: 25\n   * });\n   *\n   * // Search for queues\n   * const response = await queueAPI.getQueues({\n   *   search: 'support',\n   *   filter: 'queueType==\"INBOUND\"'\n   * });\n   * ```\n   */\n  public async getQueues(\n    params: ContactServiceQueueSearchParams = {}\n  ): Promise<ContactServiceQueuesResponse> {\n    const startTime = Date.now();\n    const {\n      page = PAGINATION_DEFAULTS.PAGE,\n      pageSize = PAGINATION_DEFAULTS.PAGE_SIZE,\n      search,\n      filter = 'queueType==INBOUND;channelType==TELEPHONY;active==true',\n      attributes,\n      sortBy = 'name',\n      sortOrder = 'asc',\n      desktopProfileFilter = true,\n      provisioningView,\n      singleObjectResponse,\n    } = params;\n    const agentView = desktopProfileFilter;\n    const firstLevelView = desktopProfileFilter;\n\n    const orgId = this.webex.credentials.getOrgId();\n    const effectiveSortBy = sortBy ?? (sortOrder ? 'name' : undefined);\n    const isSearchRequest = !!(search || filter || attributes || effectiveSortBy);\n    const canUseCache = this.pageCache.canUseCache({\n      search,\n      filter,\n      attributes,\n      sortBy: effectiveSortBy,\n      desktopProfileFilter,\n      provisioningView,\n      singleObjectResponse,\n    });\n\n    LoggerProxy.info('Fetching contact service queues', {\n      module: 'Queue',\n      method: METHODS.GET_QUEUES,\n      data: {\n        orgId,\n        page,\n        pageSize,\n        isSearchRequest,\n      },\n    });\n\n    // Check if we can use cache for simple pagination (no search/filter/attributes/sort)\n    if (canUseCache) {\n      const cacheKey = this.pageCache.buildCacheKey(orgId, page, pageSize);\n      const cachedPage = this.pageCache.getCachedPage(cacheKey);\n\n      if (cachedPage) {\n        const duration = Date.now() - startTime;\n\n        LoggerProxy.log(`Returning page ${page} from cache`, {\n          module: 'Queue',\n          method: 'getQueues',\n          data: {\n            cacheHit: true,\n            duration,\n            recordCount: cachedPage.data.length,\n            page,\n            pageSize,\n          },\n        });\n\n        return {\n          data: cachedPage.data,\n          meta: {\n            page,\n            pageSize,\n            totalPages: cachedPage.totalMeta?.totalPages,\n            totalRecords: cachedPage.totalMeta?.totalRecords,\n            orgid: orgId,\n          },\n        };\n      }\n    }\n\n    // Start timing only for actual API calls (not cache hits)\n    this.metricsManager.timeEvent(METRIC_EVENT_NAMES.QUEUE_FETCH_SUCCESS);\n\n    try {\n      // Build query parameters according to spec\n      const queryParams = new URLSearchParams({\n        page: page.toString(),\n        pageSize: pageSize.toString(),\n      });\n\n      if (filter) queryParams.append('filter', filter);\n      if (attributes) queryParams.append('attributes', attributes);\n      if (search) queryParams.append('search', search);\n      if (effectiveSortBy)\n        queryParams.append('sort', `${effectiveSortBy},${(sortOrder ?? 'asc').toUpperCase()}`);\n      if (desktopProfileFilter !== undefined)\n        queryParams.append('desktopProfileFilter', desktopProfileFilter.toString());\n      if (provisioningView !== undefined)\n        queryParams.append('provisioningView', provisioningView.toString());\n      if (singleObjectResponse !== undefined)\n        queryParams.append('singleObjectResponse', singleObjectResponse.toString());\n      if (agentView !== undefined) queryParams.append('agentView', agentView.toString());\n      if (firstLevelView !== undefined)\n        queryParams.append('firstLevelView', firstLevelView.toString());\n\n      const resource = endPointMap.queueList(orgId, queryParams.toString());\n\n      LoggerProxy.log('Making API request to fetch contact service queues', {\n        module: 'Queue',\n        method: METHODS.GET_QUEUES,\n        data: {\n          resource,\n          service: WCC_API_GATEWAY,\n        },\n      });\n\n      const response = await this.webexRequest.request({\n        service: WCC_API_GATEWAY,\n        resource,\n        method: HTTP_METHODS.GET,\n      });\n\n      const duration = Date.now() - startTime;\n\n      const recordCount = response.body?.data?.length || 0;\n      const totalRecords = response.body?.meta?.totalRecords;\n\n      LoggerProxy.log(`Successfully retrieved ${recordCount} contact service queues`, {\n        module: 'Queue',\n        method: METHODS.GET_QUEUES,\n        data: {\n          statusCode: response.statusCode,\n          duration,\n          recordCount,\n          totalRecords,\n          isSearchRequest,\n          page,\n          pageSize,\n        },\n      });\n\n      // Only track metrics for search requests or first page loads to reduce metric volume\n      if (isSearchRequest || page === 0) {\n        this.metricsManager.trackEvent(\n          METRIC_EVENT_NAMES.QUEUE_FETCH_SUCCESS,\n          {\n            orgId,\n            statusCode: response.statusCode,\n            recordCount,\n            totalRecords,\n            isSearchRequest,\n            isFirstPage: page === 0,\n          },\n          ['behavioral', 'operational']\n        );\n      }\n\n      // Cache the page data for simple pagination (no search/filter/attributes/sort)\n      if (canUseCache && response.body?.data) {\n        const cacheKey = this.pageCache.buildCacheKey(orgId, page, pageSize);\n        this.pageCache.cachePage(cacheKey, response.body.data, response.body.meta);\n\n        LoggerProxy.log('Cached contact service queues for future requests', {\n          module: 'Queue',\n          method: METHODS.GET_QUEUES,\n          data: {\n            cacheKey,\n            recordCount,\n          },\n        });\n      }\n\n      return response.body;\n    } catch (error) {\n      const errorData = {\n        orgId,\n        error: error instanceof Error ? error.message : String(error),\n        isSearchRequest,\n        page,\n        pageSize,\n      };\n\n      LoggerProxy.error('Failed to fetch contact service queues', {\n        module: 'Queue',\n        method: METHODS.GET_QUEUES,\n        data: errorData,\n        error,\n      });\n\n      // Track all failures for troubleshooting\n      this.metricsManager.trackEvent(METRIC_EVENT_NAMES.QUEUE_FETCH_FAILED, errorData, [\n        'behavioral',\n        'operational',\n      ]);\n\n      throw error;\n    }\n  }\n}\n\nexport default Queue;\n"],"mappings":"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","ignoreList":[]}

package/dist/services/UserPreference.js

@@ -0,0 +1,427 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.default = exports.UserPreference = void 0;
+var _types = require("../types");
+var _loggerProxy = _interopRequireDefault(require("../logger-proxy"));
+var _WebexRequest = _interopRequireDefault(require("./core/WebexRequest"));
+var _MetricsManager = _interopRequireDefault(require("../metrics/MetricsManager"));
+var _constants = require("./constants");
+var _constants2 = require("./config/constants");
+var _constants3 = require("../metrics/constants");
+function _interopRequireDefault(e) { return e && e.__esModule ? e : { default: e }; }
+/**
+ * UserPreference API class for managing Webex Contact Center user preferences.
+ * Provides functionality to get, create, update, and delete user preferences.
+ *
+ * @class UserPreference
+ * @public
+ * @example
+ * ```typescript
+ * import Webex from 'webex';
+ *
+ * const webex = new Webex({ credentials: 'YOUR_ACCESS_TOKEN' });
+ * const cc = webex.cc;
+ *
+ * // Register and login first
+ * await cc.register();
+ * await cc.stationLogin({ teamId: 'team123', loginOption: 'BROWSER' });
+ *
+ * // Get UserPreference API instance from ContactCenter
+ * const userPreferenceAPI = cc.userPreference;
+ *
+ * // Get user preferences for the current user
+ * const preferences = await userPreferenceAPI.getUserPreference();
+ *
+ * // Create new user preferences
+ * const newPreferences = await userPreferenceAPI.createUserPreference({
+ *   userId: 'user123',
+ *   preferences: { e911Reminder: true }
+ * });
+ *
+ * // Update user preferences
+ * const updatedPreferences = await userPreferenceAPI.updateUserPreference('user123', {
+ *   preferences: { e911Reminder: false }
+ * });
+ *
+ * // Delete user preferences
+ * await userPreferenceAPI.deleteUserPreference('user123');
+ * ```
+ */
+class UserPreference {
+  /**
+   * Creates an instance of UserPreference
+   * @param {WebexSDK} webex - The Webex SDK instance
+   * @param {() => string} getUserId - Function to get the current user's CI user ID
+   * @public
+   */
+  constructor(webex, getUserId) {
+    this.webex = webex;
+    this.webexRequest = _WebexRequest.default.getInstance({
+      webex
+    });
+    this.getUserId = getUserId;
+    this.metricsManager = _MetricsManager.default.getInstance({
+      webex
+    });
+  }
+
+  /**
+   * Fetches user preferences for a specific user
+   * @param {GetUserPreferenceParams} [params] - Optional parameters for fetching preferences
+   * @param {string} [params.userId] - User ID to fetch preferences for. Defaults to current user's CI user ID.
+   * @param {number} [params.page=0] - Page number (0-indexed). Default: 0
+   * @param {number} [params.pageSize=100] - Number of items per page. Default: 100
+   * @returns {Promise<UserPreferenceResponse>} Promise resolving to user preferences
+   * @throws {Error} If the API call fails
+   * @public
+   * @example
+   * ```typescript
+   * // Get preferences for current user
+   * const preferences = await userPreferenceAPI.getUserPreference();
+   *
+   * // Get preferences for a specific user
+   * const preferences = await userPreferenceAPI.getUserPreference({ userId: 'user123' });
+   *
+   * // Get preferences with pagination
+   * const preferences = await userPreferenceAPI.getUserPreference({ page: 0, pageSize: 50 });
+   * ```
+   */
+  async getUserPreference(params) {
+    const {
+      userId,
+      page,
+      pageSize
+    } = params || {};
+    const targetUserId = userId || this.getUserId();
+    const orgId = this.webex.credentials.getOrgId();
+    _loggerProxy.default.info('Fetching user preferences', {
+      module: 'UserPreference',
+      method: 'getUserPreference',
+      data: {
+        orgId,
+        userId: targetUserId,
+        page,
+        pageSize
+      }
+    });
+    if (!targetUserId) {
+      _loggerProxy.default.error('getUserPreference called without a valid userId', {
+        module: 'UserPreference',
+        method: 'getUserPreference',
+        data: {
+          orgId,
+          userId: targetUserId,
+          error: 'Missing userId. Ensure user is logged in or provide a userId.'
+        }
+      });
+      throw new Error('UserPreference: userId is not available.');
+    }
+    try {
+      let resource = _constants2.endPointMap.userPreference(orgId, targetUserId);
+
+      // Build query parameters if provided
+      const queryParams = [];
+      if (page !== undefined) queryParams.push(`page=${page}`);
+      if (pageSize !== undefined) queryParams.push(`pageSize=${pageSize}`);
+      if (queryParams.length > 0) {
+        resource = `${resource}?${queryParams.join('&')}`;
+      }
+      _loggerProxy.default.info('Making API request to fetch user preferences', {
+        module: 'UserPreference',
+        method: 'getUserPreference',
+        data: {
+          resource,
+          service: _constants.WCC_API_GATEWAY
+        }
+      });
+      this.metricsManager.timeEvent(_constants3.METRIC_EVENT_NAMES.USER_PREFERENCE_GET_SUCCESS);
+      this.metricsManager.timeEvent(_constants3.METRIC_EVENT_NAMES.USER_PREFERENCE_GET_FAILED);
+      const response = await this.webexRequest.request({
+        service: _constants.WCC_API_GATEWAY,
+        resource,
+        method: _types.HTTP_METHODS.GET
+      });
+      _loggerProxy.default.info('Successfully retrieved user preferences', {
+        module: 'UserPreference',
+        method: 'getUserPreference',
+        data: {
+          statusCode: response.statusCode,
+          userId: targetUserId
+        }
+      });
+      this.metricsManager.trackEvent(_constants3.METRIC_EVENT_NAMES.USER_PREFERENCE_GET_SUCCESS, {
+        orgId,
+        userId: targetUserId,
+        statusCode: response.statusCode
+      }, ['behavioral', 'operational']);
+      return response.body;
+    } catch (error) {
+      const errorData = {
+        orgId,
+        userId: targetUserId,
+        error: error instanceof Error ? error.message : String(error)
+      };
+      _loggerProxy.default.error('Failed to fetch user preferences', {
+        module: 'UserPreference',
+        method: 'getUserPreference',
+        data: errorData,
+        error
+      });
+      this.metricsManager.trackEvent(_constants3.METRIC_EVENT_NAMES.USER_PREFERENCE_GET_FAILED, errorData, ['behavioral', 'operational']);
+      throw error;
+    }
+  }
+
+  /**
+   * Creates new user preferences
+   * @param {CreateUserPreferenceRequest} data - The user preference data to create
+   * @returns {Promise<UserPreference>} Promise resolving to created user preferences
+   * @throws {Error} If the API call fails
+   * @public
+   * @example
+   * ```typescript
+   * const newPreferences = await userPreferenceAPI.createUserPreference({
+   *   userId: 'user123',
+   *   preferences: { e911Reminder: true, notificationSettings: { email: true } }
+   * });
+   * ```
+   */
+  async createUserPreference(data) {
+    const orgId = this.webex.credentials.getOrgId();
+    _loggerProxy.default.info('Creating user preferences', {
+      module: 'UserPreference',
+      method: 'createUserPreference',
+      data: {
+        orgId,
+        userId: data.userId
+      }
+    });
+    if (!data.userId) {
+      _loggerProxy.default.error('createUserPreference called without a valid userId', {
+        module: 'UserPreference',
+        method: 'createUserPreference',
+        data: {
+          orgId,
+          error: 'Missing userId in request data.'
+        }
+      });
+      throw new Error('UserPreference: userId is required to create user preferences.');
+    }
+    try {
+      const resource = _constants2.endPointMap.userPreferenceCreate(orgId);
+      _loggerProxy.default.info('Making API request to create user preferences', {
+        module: 'UserPreference',
+        method: 'createUserPreference',
+        data: {
+          resource,
+          service: _constants.WCC_API_GATEWAY
+        }
+      });
+      this.metricsManager.timeEvent(_constants3.METRIC_EVENT_NAMES.USER_PREFERENCE_CREATE_SUCCESS);
+      this.metricsManager.timeEvent(_constants3.METRIC_EVENT_NAMES.USER_PREFERENCE_CREATE_FAILED);
+      const response = await this.webexRequest.request({
+        service: _constants.WCC_API_GATEWAY,
+        resource,
+        method: _types.HTTP_METHODS.POST,
+        body: data
+      });
+      _loggerProxy.default.info('Successfully created user preferences', {
+        module: 'UserPreference',
+        method: 'createUserPreference',
+        data: {
+          statusCode: response.statusCode,
+          userId: data.userId
+        }
+      });
+      this.metricsManager.trackEvent(_constants3.METRIC_EVENT_NAMES.USER_PREFERENCE_CREATE_SUCCESS, {
+        orgId,
+        userId: data.userId,
+        statusCode: response.statusCode
+      }, ['behavioral', 'operational']);
+      return response.body;
+    } catch (error) {
+      const errorData = {
+        orgId,
+        userId: data.userId,
+        error: error instanceof Error ? error.message : String(error)
+      };
+      _loggerProxy.default.error('Failed to create user preferences', {
+        module: 'UserPreference',
+        method: 'createUserPreference',
+        data: errorData,
+        error
+      });
+      this.metricsManager.trackEvent(_constants3.METRIC_EVENT_NAMES.USER_PREFERENCE_CREATE_FAILED, errorData, ['behavioral', 'operational']);
+      throw error;
+    }
+  }
+
+  /**
+   * Updates existing user preferences
+   * @param {string} userId - User ID to update preferences for
+   * @param {UpdateUserPreferenceRequest} data - The user preference data to update
+   * @returns {Promise<UserPreference>} Promise resolving to updated user preferences
+   * @throws {Error} If the API call fails
+   * @public
+   * @example
+   * ```typescript
+   * const updatedPreferences = await userPreferenceAPI.updateUserPreference('user123', {
+   *   preferences: { e911Reminder: false }
+   * });
+   * ```
+   */
+  async updateUserPreference(userId, data) {
+    const orgId = this.webex.credentials.getOrgId();
+    _loggerProxy.default.info('Updating user preferences', {
+      module: 'UserPreference',
+      method: 'updateUserPreference',
+      data: {
+        orgId,
+        userId
+      }
+    });
+    if (!userId) {
+      _loggerProxy.default.error('updateUserPreference called without a valid userId', {
+        module: 'UserPreference',
+        method: 'updateUserPreference',
+        data: {
+          orgId,
+          error: 'Missing userId parameter.'
+        }
+      });
+      throw new Error('UserPreference: userId is required to update user preferences.');
+    }
+    try {
+      const resource = _constants2.endPointMap.userPreference(orgId, userId);
+      _loggerProxy.default.info('Making API request to update user preferences', {
+        module: 'UserPreference',
+        method: 'updateUserPreference',
+        data: {
+          resource,
+          service: _constants.WCC_API_GATEWAY
+        }
+      });
+      this.metricsManager.timeEvent(_constants3.METRIC_EVENT_NAMES.USER_PREFERENCE_UPDATE_SUCCESS);
+      this.metricsManager.timeEvent(_constants3.METRIC_EVENT_NAMES.USER_PREFERENCE_UPDATE_FAILED);
+      const response = await this.webexRequest.request({
+        service: _constants.WCC_API_GATEWAY,
+        resource,
+        method: _types.HTTP_METHODS.PUT,
+        body: data
+      });
+      _loggerProxy.default.info('Successfully updated user preferences', {
+        module: 'UserPreference',
+        method: 'updateUserPreference',
+        data: {
+          statusCode: response.statusCode,
+          userId
+        }
+      });
+      this.metricsManager.trackEvent(_constants3.METRIC_EVENT_NAMES.USER_PREFERENCE_UPDATE_SUCCESS, {
+        orgId,
+        userId,
+        statusCode: response.statusCode
+      }, ['behavioral', 'operational']);
+      return response.body;
+    } catch (error) {
+      const errorData = {
+        orgId,
+        userId,
+        error: error instanceof Error ? error.message : String(error)
+      };
+      _loggerProxy.default.error('Failed to update user preferences', {
+        module: 'UserPreference',
+        method: 'updateUserPreference',
+        data: errorData,
+        error
+      });
+      this.metricsManager.trackEvent(_constants3.METRIC_EVENT_NAMES.USER_PREFERENCE_UPDATE_FAILED, errorData, ['behavioral', 'operational']);
+      throw error;
+    }
+  }
+
+  /**
+   * Deletes user preferences for a specific user
+   * @param {string} userId - User ID to delete preferences for
+   * @returns {Promise<void>} Promise resolving when deletion is complete
+   * @throws {Error} If the API call fails
+   * @public
+   * @example
+   * ```typescript
+   * await userPreferenceAPI.deleteUserPreference('user123');
+   * ```
+   */
+  async deleteUserPreference(userId) {
+    const orgId = this.webex.credentials.getOrgId();
+    _loggerProxy.default.info('Deleting user preferences', {
+      module: 'UserPreference',
+      method: 'deleteUserPreference',
+      data: {
+        orgId,
+        userId
+      }
+    });
+    if (!userId) {
+      _loggerProxy.default.error('deleteUserPreference called without a valid userId', {
+        module: 'UserPreference',
+        method: 'deleteUserPreference',
+        data: {
+          orgId,
+          error: 'Missing userId parameter.'
+        }
+      });
+      throw new Error('UserPreference: userId is required to delete user preferences.');
+    }
+    try {
+      const resource = _constants2.endPointMap.userPreference(orgId, userId);
+      _loggerProxy.default.info('Making API request to delete user preferences', {
+        module: 'UserPreference',
+        method: 'deleteUserPreference',
+        data: {
+          resource,
+          service: _constants.WCC_API_GATEWAY
+        }
+      });
+      this.metricsManager.timeEvent(_constants3.METRIC_EVENT_NAMES.USER_PREFERENCE_DELETE_SUCCESS);
+      this.metricsManager.timeEvent(_constants3.METRIC_EVENT_NAMES.USER_PREFERENCE_DELETE_FAILED);
+      const response = await this.webexRequest.request({
+        service: _constants.WCC_API_GATEWAY,
+        resource,
+        method: _types.HTTP_METHODS.DELETE
+      });
+      _loggerProxy.default.info('Successfully deleted user preferences', {
+        module: 'UserPreference',
+        method: 'deleteUserPreference',
+        data: {
+          statusCode: response.statusCode,
+          userId
+        }
+      });
+      this.metricsManager.trackEvent(_constants3.METRIC_EVENT_NAMES.USER_PREFERENCE_DELETE_SUCCESS, {
+        orgId,
+        userId,
+        statusCode: response.statusCode
+      }, ['behavioral', 'operational']);
+    } catch (error) {
+      const errorData = {
+        orgId,
+        userId,
+        error: error instanceof Error ? error.message : String(error)
+      };
+      _loggerProxy.default.error('Failed to delete user preferences', {
+        module: 'UserPreference',
+        method: 'deleteUserPreference',
+        data: errorData,
+        error
+      });
+      this.metricsManager.trackEvent(_constants3.METRIC_EVENT_NAMES.USER_PREFERENCE_DELETE_FAILED, errorData, ['behavioral', 'operational']);
+      throw error;
+    }
+  }
+}
+exports.UserPreference = UserPreference;
+var _default = exports.default = UserPreference;
+//# sourceMappingURL=UserPreference.js.map