@webex/contact-center 3.12.0-next.13 → 3.12.0-next.130

package/dist/services/AddressBook.js.map

@@ -1 +1 @@
-{"version":3,"names":["_types","require","_loggerProxy","_interopRequireDefault","_WebexRequest","_PageCache","_interopRequireWildcard","_MetricsManager","_constants","_constants2","_constants3","e","t","WeakMap","r","n","__esModule","o","i","f","__proto__","default","has","get","set","hasOwnProperty","call","Object","defineProperty","getOwnPropertyDescriptor","AddressBook","constructor","webex","getAddressBookId","webexRequest","WebexRequest","getInstance","pageCache","PageCache","metricsManager","MetricsManager","getEntries","params","startTime","Date","now","addressBookId","page","PAGINATION_DEFAULTS","PAGE","pageSize","PAGE_SIZE","search","filter","attributes","bookId","orgId","credentials","getOrgId","isSearchRequest","LoggerProxy","info","module","method","data","canUseCache","cacheKey","buildCacheKey","cachedPage","getCachedPage","duration","cacheHit","recordCount","length","meta","totalPages","totalMeta","totalRecords","timeEvent","METRIC_EVENT_NAMES","ADDRESSBOOK_FETCH_SUCCESS","errorData","error","trackEvent","ADDRESSBOOK_FETCH_FAILED","Error","queryParams","URLSearchParams","toString","append","resource","endPointMap","addressBookEntries","service","WCC_API_GATEWAY","response","request","HTTP_METHODS","GET","body","statusCode","isFirstPage","cachePage","message","String","exports","_default"],"sources":["AddressBook.ts"],"sourcesContent":["import {HTTP_METHODS, WebexSDK} from '../types';\nimport type {\n  AddressBookEntry,\n  AddressBookEntriesResponse,\n  AddressBookEntrySearchParams,\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';\n\n/**\n * AddressBook API class for managing Webex Contact Center address book entries.\n * Provides functionality to fetch address book entries using the entry API.\n *\n * @class AddressBook\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 AddressBook API instance from ContactCenter\n * const addressBookAPI = cc.addressBook;\n *\n * // Get entries from agent's default address book\n * const entries = await addressBookAPI.getEntries();\n *\n * // Get entries from a specific address book with pagination\n * const entries = await addressBookAPI.getEntries({\n *   addressBookId: 'addressBookId123',\n *   page: 0,\n *   pageSize: 50\n * });\n *\n * // Search for specific entries\n * const searchResults = await addressBook.getEntries({\n *   search: 'john',\n *   filter: 'name==\"John Doe\"'\n * });\n * ```\n */\nexport class AddressBook {\n  private webexRequest: WebexRequest;\n  private webex: WebexSDK;\n  private getAddressBookId: () => string;\n  private metricsManager: MetricsManager;\n\n  // Page cache using the common utility\n  private pageCache: PageCache<AddressBookEntry>;\n\n  /**\n   * Creates an instance of AddressBook\n   * @param {WebexSDK} webex - The Webex SDK instance\n   * @param {() => string} getAddressBookId - Function to get the addressBookId from agent profile\n   * @public\n   */\n  constructor(webex: WebexSDK, getAddressBookId: () => string) {\n    this.webex = webex;\n    this.webexRequest = WebexRequest.getInstance({webex});\n    this.getAddressBookId = getAddressBookId;\n    this.pageCache = new PageCache<AddressBookEntry>('AddressBook');\n    this.metricsManager = MetricsManager.getInstance({webex});\n  }\n\n  /**\n   * Fetches address book entries for a specific address book using the entry API\n   * @param {AddressBookEntrySearchParams} [params] - Search and pagination parameters including addressBookId\n   * @returns {Promise<AddressBookEntriesResponse>} Promise resolving to address book entries\n   * @throws {Error} If the API call fails\n   * @public\n   * @example\n   * ```typescript\n   * // Get entries from agent's default address book\n   * const response = await addressBookAPI.getEntries();\n   *\n   * // Get entries from a specific address book with pagination\n   * const response = await addressBookAPI.getEntries({\n   *   addressBookId: 'addressBookId123',\n   *   page: 0,\n   *   pageSize: 25\n   * });\n   * ```\n   */\n  public async getEntries(\n    params: AddressBookEntrySearchParams = {}\n  ): Promise<AddressBookEntriesResponse> {\n    const startTime = Date.now();\n    const {\n      addressBookId,\n      page = PAGINATION_DEFAULTS.PAGE,\n      pageSize = PAGINATION_DEFAULTS.PAGE_SIZE,\n      search,\n      filter,\n      attributes,\n    } = params;\n\n    // Use provided addressBookId or fall back to agent's address book\n    const bookId = addressBookId || this.getAddressBookId();\n    const orgId = this.webex.credentials.getOrgId();\n    const isSearchRequest = !!(search || filter || attributes);\n\n    LoggerProxy.info('Fetching address book entries', {\n      module: 'AddressBook',\n      method: 'getEntries',\n      data: {\n        orgId,\n        bookId,\n        page,\n        pageSize,\n        isSearchRequest,\n      },\n    });\n\n    // Check if we can use cache for simple pagination (no search/filter/attributes)\n    if (this.pageCache.canUseCache({search, filter, attributes})) {\n      const cacheKey = this.pageCache.buildCacheKey(bookId, page, pageSize);\n      const cachedPage = this.pageCache.getCachedPage(cacheKey);\n\n      if (cachedPage) {\n        const duration = Date.now() - startTime;\n\n        LoggerProxy.info(`Returning page ${page} from cache`, {\n          module: 'AddressBook',\n          method: 'getEntries',\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          },\n        };\n      }\n    }\n\n    // Start timing for the operation\n    this.metricsManager.timeEvent(METRIC_EVENT_NAMES.ADDRESSBOOK_FETCH_SUCCESS);\n\n    // Validate address book id early to avoid bad requests\n    if (!bookId) {\n      const errorData = {\n        orgId,\n        bookId,\n        isSearchRequest,\n        page,\n        pageSize,\n        error: 'Missing addressBookId for agent. Ensure agent profile contains addressBookId.',\n      };\n      LoggerProxy.error('AddressBook called without a valid addressBookId', {\n        module: 'AddressBook',\n        method: 'getEntries',\n        data: errorData,\n      });\n\n      this.metricsManager.trackEvent(METRIC_EVENT_NAMES.ADDRESSBOOK_FETCH_FAILED, errorData, [\n        'behavioral',\n        'operational',\n      ]);\n\n      throw new Error('AddressBook: addressBookId is not available for the current agent.');\n    }\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\n      const resource = endPointMap.addressBookEntries(orgId, bookId, queryParams.toString());\n\n      LoggerProxy.info('Making API request to fetch address book entries', {\n        module: 'AddressBook',\n        method: 'getEntries',\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.info(`Successfully retrieved ${recordCount} address book entries`, {\n        module: 'AddressBook',\n        method: 'getEntries',\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.ADDRESSBOOK_FETCH_SUCCESS,\n          {\n            orgId,\n            bookId,\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)\n      if (this.pageCache.canUseCache({search, filter, attributes}) && response.body?.data) {\n        const cacheKey = this.pageCache.buildCacheKey(bookId, page, pageSize);\n        this.pageCache.cachePage(cacheKey, response.body.data, response.body.meta);\n\n        LoggerProxy.info('Cached address book entries for future requests', {\n          module: 'AddressBook',\n          method: 'getEntries',\n          data: {\n            cacheKey,\n            recordCount,\n          },\n        });\n      }\n\n      return response.body;\n    } catch (error) {\n      const errorData = {\n        orgId,\n        bookId,\n        error: error instanceof Error ? error.message : String(error),\n        isSearchRequest,\n        page,\n        pageSize,\n      };\n\n      LoggerProxy.error('Failed to fetch address book entries', {\n        module: 'AddressBook',\n        method: 'getEntries',\n        data: errorData,\n        error,\n      });\n\n      // Track all failures for troubleshooting\n      this.metricsManager.trackEvent(METRIC_EVENT_NAMES.ADDRESSBOOK_FETCH_FAILED, errorData, [\n        'behavioral',\n        'operational',\n      ]);\n\n      throw error;\n    }\n  }\n}\n\nexport default AddressBook;\n"],"mappings":";;;;;;AAAA,IAAAA,MAAA,GAAAC,OAAA;AAMA,IAAAC,YAAA,GAAAC,sBAAA,CAAAF,OAAA;AACA,IAAAG,aAAA,GAAAD,sBAAA,CAAAF,OAAA;AACA,IAAAI,UAAA,GAAAC,uBAAA,CAAAL,OAAA;AACA,IAAAM,eAAA,GAAAJ,sBAAA,CAAAF,OAAA;AACA,IAAAO,UAAA,GAAAP,OAAA;AACA,IAAAQ,WAAA,GAAAR,OAAA;AACA,IAAAS,WAAA,GAAAT,OAAA;AAAwD,SAAAK,wBAAAK,CAAA,EAAAC,CAAA,6BAAAC,OAAA,MAAAC,CAAA,OAAAD,OAAA,IAAAE,CAAA,OAAAF,OAAA,YAAAP,uBAAA,YAAAA,CAAAK,CAAA,EAAAC,CAAA,SAAAA,CAAA,IAAAD,CAAA,IAAAA,CAAA,CAAAK,UAAA,SAAAL,CAAA,MAAAM,CAAA,EAAAC,CAAA,EAAAC,CAAA,KAAAC,SAAA,QAAAC,OAAA,EAAAV,CAAA,iBAAAA,CAAA,uBAAAA,CAAA,yBAAAA,CAAA,SAAAQ,CAAA,MAAAF,CAAA,GAAAL,CAAA,GAAAG,CAAA,GAAAD,CAAA,QAAAG,CAAA,CAAAK,GAAA,CAAAX,CAAA,UAAAM,CAAA,CAAAM,GAAA,CAAAZ,CAAA,GAAAM,CAAA,CAAAO,GAAA,CAAAb,CAAA,EAAAQ,CAAA,gBAAAP,CAAA,IAAAD,CAAA,gBAAAC,CAAA,OAAAa,cAAA,CAAAC,IAAA,CAAAf,CAAA,EAAAC,CAAA,OAAAM,CAAA,IAAAD,CAAA,GAAAU,MAAA,CAAAC,cAAA,KAAAD,MAAA,CAAAE,wBAAA,CAAAlB,CAAA,EAAAC,CAAA,OAAAM,CAAA,CAAAK,GAAA,IAAAL,CAAA,CAAAM,GAAA,IAAAP,CAAA,CAAAE,CAAA,EAAAP,CAAA,EAAAM,CAAA,IAAAC,CAAA,CAAAP,CAAA,IAAAD,CAAA,CAAAC,CAAA,WAAAO,CAAA,KAAAR,CAAA,EAAAC,CAAA;AAAA,SAAAT,uBAAAQ,CAAA,WAAAA,CAAA,IAAAA,CAAA,CAAAK,UAAA,GAAAL,CAAA,KAAAU,OAAA,EAAAV,CAAA;AAExD;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACO,MAAMmB,WAAW,CAAC;EAMvB;;EAGA;AACF;AACA;AACA;AACA;AACA;EACEC,WAAWA,CAACC,KAAe,EAAEC,gBAA8B,EAAE;IAC3D,IAAI,CAACD,KAAK,GAAGA,KAAK;IAClB,IAAI,CAACE,YAAY,GAAGC,qBAAY,CAACC,WAAW,CAAC;MAACJ;IAAK,CAAC,CAAC;IACrD,IAAI,CAACC,gBAAgB,GAAGA,gBAAgB;IACxC,IAAI,CAACI,SAAS,GAAG,IAAIC,kBAAS,CAAmB,aAAa,CAAC;IAC/D,IAAI,CAACC,cAAc,GAAGC,uBAAc,CAACJ,WAAW,CAAC;MAACJ;IAAK,CAAC,CAAC;EAC3D;;EAEA;AACF;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;EACE,MAAaS,UAAUA,CACrBC,MAAoC,GAAG,CAAC,CAAC,EACJ;IACrC,MAAMC,SAAS,GAAGC,IAAI,CAACC,GAAG,CAAC,CAAC;IAC5B,MAAM;MACJC,aAAa;MACbC,IAAI,GAAGC,8BAAmB,CAACC,IAAI;MAC/BC,QAAQ,GAAGF,8BAAmB,CAACG,SAAS;MACxCC,MAAM;MACNC,MAAM;MACNC;IACF,CAAC,GAAGZ,MAAM;;IAEV;IACA,MAAMa,MAAM,GAAGT,aAAa,IAAI,IAAI,CAACb,gBAAgB,CAAC,CAAC;IACvD,MAAMuB,KAAK,GAAG,IAAI,CAACxB,KAAK,CAACyB,WAAW,CAACC,QAAQ,CAAC,CAAC;IAC/C,MAAMC,eAAe,GAAG,CAAC,EAAEP,MAAM,IAAIC,MAAM,IAAIC,UAAU,CAAC;IAE1DM,oBAAW,CAACC,IAAI,CAAC,+BAA+B,EAAE;MAChDC,MAAM,EAAE,aAAa;MACrBC,MAAM,EAAE,YAAY;MACpBC,IAAI,EAAE;QACJR,KAAK;QACLD,MAAM;QACNR,IAAI;QACJG,QAAQ;QACRS;MACF;IACF,CAAC,CAAC;;IAEF;IACA,IAAI,IAAI,CAACtB,SAAS,CAAC4B,WAAW,CAAC;MAACb,MAAM;MAAEC,MAAM;MAAEC;IAAU,CAAC,CAAC,EAAE;MAC5D,MAAMY,QAAQ,GAAG,IAAI,CAAC7B,SAAS,CAAC8B,aAAa,CAACZ,MAAM,EAAER,IAAI,EAAEG,QAAQ,CAAC;MACrE,MAAMkB,UAAU,GAAG,IAAI,CAAC/B,SAAS,CAACgC,aAAa,CAACH,QAAQ,CAAC;MAEzD,IAAIE,UAAU,EAAE;QACd,MAAME,QAAQ,GAAG1B,IAAI,CAACC,GAAG,CAAC,CAAC,GAAGF,SAAS;QAEvCiB,oBAAW,CAACC,IAAI,CAAC,kBAAkBd,IAAI,aAAa,EAAE;UACpDe,MAAM,EAAE,aAAa;UACrBC,MAAM,EAAE,YAAY;UACpBC,IAAI,EAAE;YACJO,QAAQ,EAAE,IAAI;YACdD,QAAQ;YACRE,WAAW,EAAEJ,UAAU,CAACJ,IAAI,CAACS,MAAM;YACnC1B,IAAI;YACJG;UACF;QACF,CAAC,CAAC;QAEF,OAAO;UACLc,IAAI,EAAEI,UAAU,CAACJ,IAAI;UACrBU,IAAI,EAAE;YACJ3B,IAAI;YACJG,QAAQ;YACRyB,UAAU,EAAEP,UAAU,CAACQ,SAAS,EAAED,UAAU;YAC5CE,YAAY,EAAET,UAAU,CAACQ,SAAS,EAAEC;UACtC;QACF,CAAC;MACH;IACF;;IAEA;IACA,IAAI,CAACtC,cAAc,CAACuC,SAAS,CAACC,8BAAkB,CAACC,yBAAyB,CAAC;;IAE3E;IACA,IAAI,CAACzB,MAAM,EAAE;MACX,MAAM0B,SAAS,GAAG;QAChBzB,KAAK;QACLD,MAAM;QACNI,eAAe;QACfZ,IAAI;QACJG,QAAQ;QACRgC,KAAK,EAAE;MACT,CAAC;MACDtB,oBAAW,CAACsB,KAAK,CAAC,kDAAkD,EAAE;QACpEpB,MAAM,EAAE,aAAa;QACrBC,MAAM,EAAE,YAAY;QACpBC,IAAI,EAAEiB;MACR,CAAC,CAAC;MAEF,IAAI,CAAC1C,cAAc,CAAC4C,UAAU,CAACJ,8BAAkB,CAACK,wBAAwB,EAAEH,SAAS,EAAE,CACrF,YAAY,EACZ,aAAa,CACd,CAAC;MAEF,MAAM,IAAII,KAAK,CAAC,oEAAoE,CAAC;IACvF;IAEA,IAAI;MACF;MACA,MAAMC,WAAW,GAAG,IAAIC,eAAe,CAAC;QACtCxC,IAAI,EAAEA,IAAI,CAACyC,QAAQ,CAAC,CAAC;QACrBtC,QAAQ,EAAEA,QAAQ,CAACsC,QAAQ,CAAC;MAC9B,CAAC,CAAC;MAEF,IAAInC,MAAM,EAAEiC,WAAW,CAACG,MAAM,CAAC,QAAQ,EAAEpC,MAAM,CAAC;MAChD,IAAIC,UAAU,EAAEgC,WAAW,CAACG,MAAM,CAAC,YAAY,EAAEnC,UAAU,CAAC;MAC5D,IAAIF,MAAM,EAAEkC,WAAW,CAACG,MAAM,CAAC,QAAQ,EAAErC,MAAM,CAAC;MAEhD,MAAMsC,QAAQ,GAAGC,uBAAW,CAACC,kBAAkB,CAACpC,KAAK,EAAED,MAAM,EAAE+B,WAAW,CAACE,QAAQ,CAAC,CAAC,CAAC;MAEtF5B,oBAAW,CAACC,IAAI,CAAC,kDAAkD,EAAE;QACnEC,MAAM,EAAE,aAAa;QACrBC,MAAM,EAAE,YAAY;QACpBC,IAAI,EAAE;UACJ0B,QAAQ;UACRG,OAAO,EAAEC;QACX;MACF,CAAC,CAAC;MAEF,MAAMC,QAAQ,GAAG,MAAM,IAAI,CAAC7D,YAAY,CAAC8D,OAAO,CAAC;QAC/CH,OAAO,EAAEC,0BAAe;QACxBJ,QAAQ;QACR3B,MAAM,EAAEkC,mBAAY,CAACC;MACvB,CAAC,CAAC;MAEF,MAAM5B,QAAQ,GAAG1B,IAAI,CAACC,GAAG,CAAC,CAAC,GAAGF,SAAS;MAEvC,MAAM6B,WAAW,GAAGuB,QAAQ,CAACI,IAAI,EAAEnC,IAAI,EAAES,MAAM,IAAI,CAAC;MACpD,MAAMI,YAAY,GAAGkB,QAAQ,CAACI,IAAI,EAAEzB,IAAI,EAAEG,YAAY;MAEtDjB,oBAAW,CAACC,IAAI,CAAC,0BAA0BW,WAAW,uBAAuB,EAAE;QAC7EV,MAAM,EAAE,aAAa;QACrBC,MAAM,EAAE,YAAY;QACpBC,IAAI,EAAE;UACJoC,UAAU,EAAEL,QAAQ,CAACK,UAAU;UAC/B9B,QAAQ;UACRE,WAAW;UACXK,YAAY;UACZlB,eAAe;UACfZ,IAAI;UACJG;QACF;MACF,CAAC,CAAC;;MAEF;MACA,IAAIS,eAAe,IAAIZ,IAAI,KAAK,CAAC,EAAE;QACjC,IAAI,CAACR,cAAc,CAAC4C,UAAU,CAC5BJ,8BAAkB,CAACC,yBAAyB,EAC5C;UACExB,KAAK;UACLD,MAAM;UACN6C,UAAU,EAAEL,QAAQ,CAACK,UAAU;UAC/B5B,WAAW;UACXK,YAAY;UACZlB,eAAe;UACf0C,WAAW,EAAEtD,IAAI,KAAK;QACxB,CAAC,EACD,CAAC,YAAY,EAAE,aAAa,CAC9B,CAAC;MACH;;MAEA;MACA,IAAI,IAAI,CAACV,SAAS,CAAC4B,WAAW,CAAC;QAACb,MAAM;QAAEC,MAAM;QAAEC;MAAU,CAAC,CAAC,IAAIyC,QAAQ,CAACI,IAAI,EAAEnC,IAAI,EAAE;QACnF,MAAME,QAAQ,GAAG,IAAI,CAAC7B,SAAS,CAAC8B,aAAa,CAACZ,MAAM,EAAER,IAAI,EAAEG,QAAQ,CAAC;QACrE,IAAI,CAACb,SAAS,CAACiE,SAAS,CAACpC,QAAQ,EAAE6B,QAAQ,CAACI,IAAI,CAACnC,IAAI,EAAE+B,QAAQ,CAACI,IAAI,CAACzB,IAAI,CAAC;QAE1Ed,oBAAW,CAACC,IAAI,CAAC,iDAAiD,EAAE;UAClEC,MAAM,EAAE,aAAa;UACrBC,MAAM,EAAE,YAAY;UACpBC,IAAI,EAAE;YACJE,QAAQ;YACRM;UACF;QACF,CAAC,CAAC;MACJ;MAEA,OAAOuB,QAAQ,CAACI,IAAI;IACtB,CAAC,CAAC,OAAOjB,KAAK,EAAE;MACd,MAAMD,SAAS,GAAG;QAChBzB,KAAK;QACLD,MAAM;QACN2B,KAAK,EAAEA,KAAK,YAAYG,KAAK,GAAGH,KAAK,CAACqB,OAAO,GAAGC,MAAM,CAACtB,KAAK,CAAC;QAC7DvB,eAAe;QACfZ,IAAI;QACJG;MACF,CAAC;MAEDU,oBAAW,CAACsB,KAAK,CAAC,sCAAsC,EAAE;QACxDpB,MAAM,EAAE,aAAa;QACrBC,MAAM,EAAE,YAAY;QACpBC,IAAI,EAAEiB,SAAS;QACfC;MACF,CAAC,CAAC;;MAEF;MACA,IAAI,CAAC3C,cAAc,CAAC4C,UAAU,CAACJ,8BAAkB,CAACK,wBAAwB,EAAEH,SAAS,EAAE,CACrF,YAAY,EACZ,aAAa,CACd,CAAC;MAEF,MAAMC,KAAK;IACb;EACF;AACF;AAACuB,OAAA,CAAA3E,WAAA,GAAAA,WAAA;AAAA,IAAA4E,QAAA,GAAAD,OAAA,CAAApF,OAAA,GAEcS,WAAW","ignoreList":[]}
+{"version":3,"names":["_types","require","_loggerProxy","_interopRequireDefault","_WebexRequest","_PageCache","_interopRequireWildcard","_MetricsManager","_constants","_constants2","_constants3","e","t","WeakMap","r","n","__esModule","o","i","f","__proto__","default","has","get","set","hasOwnProperty","call","Object","defineProperty","getOwnPropertyDescriptor","AddressBook","constructor","webex","getAddressBookId","webexRequest","WebexRequest","getInstance","pageCache","PageCache","metricsManager","MetricsManager","getEntries","params","startTime","Date","now","addressBookId","page","PAGINATION_DEFAULTS","PAGE","pageSize","PAGE_SIZE","search","filter","attributes","sortBy","sortOrder","bookId","orgId","credentials","getOrgId","hasCustomSort","isSearchRequest","canUseCache","undefined","LoggerProxy","info","module","method","data","cacheKey","buildCacheKey","cachedPage","getCachedPage","duration","cacheHit","recordCount","length","meta","totalPages","totalMeta","totalRecords","timeEvent","METRIC_EVENT_NAMES","ADDRESSBOOK_FETCH_SUCCESS","errorData","error","trackEvent","ADDRESSBOOK_FETCH_FAILED","Error","queryParams","URLSearchParams","toString","append","toUpperCase","resource","endPointMap","addressBookEntries","service","WCC_API_GATEWAY","response","request","HTTP_METHODS","GET","body","statusCode","isFirstPage","cachePage","message","String","exports","_default"],"sources":["AddressBook.ts"],"sourcesContent":["import {HTTP_METHODS, WebexSDK} from '../types';\nimport type {\n  AddressBookEntry,\n  AddressBookEntriesResponse,\n  AddressBookEntrySearchParams,\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';\n\n/**\n * AddressBook API class for managing Webex Contact Center address book entries.\n * Provides functionality to fetch address book entries using the entry API.\n *\n * @class AddressBook\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 AddressBook API instance from ContactCenter\n * const addressBookAPI = cc.addressBook;\n *\n * // Get entries from agent's default address book\n * const entries = await addressBookAPI.getEntries();\n *\n * // Get entries from a specific address book with pagination\n * const entries = await addressBookAPI.getEntries({\n *   addressBookId: 'addressBookId123',\n *   page: 0,\n *   pageSize: 50\n * });\n *\n * // Search for specific entries\n * const searchResults = await addressBook.getEntries({\n *   search: 'john',\n *   filter: 'name==\"John Doe\"'\n * });\n * ```\n */\nexport class AddressBook {\n  private webexRequest: WebexRequest;\n  private webex: WebexSDK;\n  private getAddressBookId: () => string;\n  private metricsManager: MetricsManager;\n\n  // Page cache using the common utility\n  private pageCache: PageCache<AddressBookEntry>;\n\n  /**\n   * Creates an instance of AddressBook\n   * @param {WebexSDK} webex - The Webex SDK instance\n   * @param {() => string} getAddressBookId - Function to get the addressBookId from agent profile\n   * @public\n   */\n  constructor(webex: WebexSDK, getAddressBookId: () => string) {\n    this.webex = webex;\n    this.webexRequest = WebexRequest.getInstance({webex});\n    this.getAddressBookId = getAddressBookId;\n    this.pageCache = new PageCache<AddressBookEntry>('AddressBook');\n    this.metricsManager = MetricsManager.getInstance({webex});\n  }\n\n  /**\n   * Fetches address book entries for a specific address book using the entry API\n   * @param {AddressBookEntrySearchParams} [params] - Search, pagination, and optional sort parameters\n   * including addressBookId. Sorting defaults to name ascending.\n   * @returns {Promise<AddressBookEntriesResponse>} Promise resolving to address book entries\n   * @throws {Error} If the API call fails\n   * @public\n   * @example\n   * ```typescript\n   * // Get entries from agent's default address book\n   * const response = await addressBookAPI.getEntries();\n   *\n   * // Get entries from a specific address book with pagination\n   * const response = await addressBookAPI.getEntries({\n   *   addressBookId: 'addressBookId123',\n   *   page: 0,\n   *   pageSize: 25\n   * });\n   * ```\n   */\n  public async getEntries(\n    params: AddressBookEntrySearchParams = {}\n  ): Promise<AddressBookEntriesResponse> {\n    const startTime = Date.now();\n    const {\n      addressBookId,\n      page = PAGINATION_DEFAULTS.PAGE,\n      pageSize = PAGINATION_DEFAULTS.PAGE_SIZE,\n      search,\n      filter,\n      attributes,\n      sortBy = 'name',\n      sortOrder = 'asc',\n    } = params;\n\n    // Use provided addressBookId or fall back to agent's address book\n    const bookId = addressBookId || this.getAddressBookId();\n    const orgId = this.webex.credentials.getOrgId();\n    const hasCustomSort = sortBy !== 'name' || sortOrder !== 'asc';\n    const isSearchRequest = !!(search || filter || attributes || hasCustomSort);\n    const canUseCache = this.pageCache.canUseCache({\n      search,\n      filter,\n      attributes,\n      sortBy: hasCustomSort ? sortBy : undefined,\n    });\n\n    LoggerProxy.info('Fetching address book entries', {\n      module: 'AddressBook',\n      method: 'getEntries',\n      data: {\n        orgId,\n        bookId,\n        page,\n        pageSize,\n        isSearchRequest,\n      },\n    });\n\n    // Default name-ascending pagination is cache-compatible; result-changing overrides are not.\n    if (canUseCache) {\n      const cacheKey = this.pageCache.buildCacheKey(bookId, page, pageSize);\n      const cachedPage = this.pageCache.getCachedPage(cacheKey);\n\n      if (cachedPage) {\n        const duration = Date.now() - startTime;\n\n        LoggerProxy.info(`Returning page ${page} from cache`, {\n          module: 'AddressBook',\n          method: 'getEntries',\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          },\n        };\n      }\n    }\n\n    // Start timing for the operation\n    this.metricsManager.timeEvent(METRIC_EVENT_NAMES.ADDRESSBOOK_FETCH_SUCCESS);\n\n    // Validate address book id early to avoid bad requests\n    if (!bookId) {\n      const errorData = {\n        orgId,\n        bookId,\n        isSearchRequest,\n        page,\n        pageSize,\n        error: 'Missing addressBookId for agent. Ensure agent profile contains addressBookId.',\n      };\n      LoggerProxy.error('AddressBook called without a valid addressBookId', {\n        module: 'AddressBook',\n        method: 'getEntries',\n        data: errorData,\n      });\n\n      this.metricsManager.trackEvent(METRIC_EVENT_NAMES.ADDRESSBOOK_FETCH_FAILED, errorData, [\n        'behavioral',\n        'operational',\n      ]);\n\n      throw new Error('AddressBook: addressBookId is not available for the current agent.');\n    }\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('sort', `${sortBy},${sortOrder.toUpperCase()}`);\n\n      const resource = endPointMap.addressBookEntries(orgId, bookId, queryParams.toString());\n\n      LoggerProxy.info('Making API request to fetch address book entries', {\n        module: 'AddressBook',\n        method: 'getEntries',\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.info(`Successfully retrieved ${recordCount} address book entries`, {\n        module: 'AddressBook',\n        method: 'getEntries',\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.ADDRESSBOOK_FETCH_SUCCESS,\n          {\n            orgId,\n            bookId,\n            statusCode: response.statusCode,\n            recordCount,\n            totalRecords,\n            isSearchRequest,\n            isFirstPage: page === 0,\n          },\n          ['behavioral', 'operational']\n        );\n      }\n\n      // Cache only the invariant default-order pagination shape.\n      if (canUseCache && response.body?.data) {\n        const cacheKey = this.pageCache.buildCacheKey(bookId, page, pageSize);\n        this.pageCache.cachePage(cacheKey, response.body.data, response.body.meta);\n\n        LoggerProxy.info('Cached address book entries for future requests', {\n          module: 'AddressBook',\n          method: 'getEntries',\n          data: {\n            cacheKey,\n            recordCount,\n          },\n        });\n      }\n\n      return response.body;\n    } catch (error) {\n      const errorData = {\n        orgId,\n        bookId,\n        error: error instanceof Error ? error.message : String(error),\n        isSearchRequest,\n        page,\n        pageSize,\n      };\n\n      LoggerProxy.error('Failed to fetch address book entries', {\n        module: 'AddressBook',\n        method: 'getEntries',\n        data: errorData,\n        error,\n      });\n\n      // Track all failures for troubleshooting\n      this.metricsManager.trackEvent(METRIC_EVENT_NAMES.ADDRESSBOOK_FETCH_FAILED, errorData, [\n        'behavioral',\n        'operational',\n      ]);\n\n      throw error;\n    }\n  }\n}\n\nexport default AddressBook;\n"],"mappings":"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","ignoreList":[]}

package/dist/services/AnswerCallOnWebexService.js

@@ -0,0 +1,202 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.default = void 0;
+var _loggerProxy = _interopRequireDefault(require("../logger-proxy"));
+var _constants = require("../constants");
+var _types = require("../types");
+var _Utils = require("./core/Utils");
+var _wxAppTelephonyUtils = require("./wxAppTelephonyUtils");
+function _interopRequireDefault(e) { return e && e.__esModule ? e : { default: e }; }
+const ANSWER_CALL_ON_WEBEX_FILE = 'AnswerCallOnWebexService';
+const extractWxAppTrackingId = source => {
+  const sourceObj = source;
+  return sourceObj?.details?.trackingId || sourceObj?.trackingId;
+};
+const extractWxAppHttpStatus = source => {
+  const obj = source;
+  return obj?.statusCode ?? obj?.status ?? obj?.details?.status;
+};
+const markWxAppTelephonyError = (error, source) => {
+  const marked = error;
+  marked.isWxAppTelephonyError = true;
+  const trackingId = extractWxAppTrackingId(source);
+  if (trackingId) {
+    marked.trackingId = trackingId;
+  }
+  const status = extractWxAppHttpStatus(source);
+  if (status !== undefined) {
+    marked.status = status;
+  }
+  return marked;
+};
+/**
+ * REST telephony client for wxApp thick-client answer (WXCC-6026).
+ * Separate from WebCallingService (WebRTC/Mobius).
+ */
+class AnswerCallOnWebexService {
+  constructor(webex) {
+    this.webex = webex;
+  }
+  getTelephonyBaseUrl() {
+    const services = this.webex.internal.services;
+    const hydraUrl = services._serviceUrls?.hydra || services.get('hydra');
+    if (!hydraUrl) {
+      throw new Error('Telephony base URL is unavailable');
+    }
+    return `${hydraUrl.replace(/\/$/, '')}/telephony/calls`;
+  }
+  extractTrackingId(source) {
+    return extractWxAppTrackingId(source);
+  }
+  async telephonyRequest(resource, method, body, logMethod) {
+    try {
+      const uri = `${this.getTelephonyBaseUrl()}${resource}`;
+      _loggerProxy.default.info(`AnswerCallOnWebexService.${logMethod} request`, {
+        module: ANSWER_CALL_ON_WEBEX_FILE,
+        method: logMethod,
+        data: {
+          uri,
+          bodyKeys: Object.keys(body)
+        }
+      });
+      const response = await this.webex.request({
+        uri,
+        method,
+        body,
+        addAuthHeader: true
+      });
+      _loggerProxy.default.info(`AnswerCallOnWebexService.${logMethod} success`, {
+        module: ANSWER_CALL_ON_WEBEX_FILE,
+        method: logMethod,
+        data: {
+          statusCode: response.statusCode
+        }
+      });
+      return response;
+    } catch (error) {
+      const trackingId = this.extractTrackingId(error);
+      _loggerProxy.default.error(`AnswerCallOnWebexService.${logMethod} failed: ${error}`, {
+        module: ANSWER_CALL_ON_WEBEX_FILE,
+        method: logMethod,
+        data: {
+          trackingId,
+          status: extractWxAppHttpStatus(error)
+        }
+      });
+      const {
+        error: detailedError
+      } = (0, _Utils.getErrorDetails)(error, logMethod, _constants.CC_FILE);
+      throw markWxAppTelephonyError(detailedError, error);
+    }
+  }
+  answerCall(params) {
+    const {
+      callId,
+      endpointId,
+      lineOwnerId
+    } = params;
+    return this.telephonyRequest('/answer', _types.HTTP_METHODS.POST, {
+      callId,
+      endpointId,
+      ...(lineOwnerId ? {
+        lineOwnerId
+      } : {})
+    }, _constants.METHODS.ACCEPT);
+  }
+  rejectCall(params) {
+    const {
+      callId,
+      lineOwnerId
+    } = params;
+    return this.telephonyRequest('/reject', _types.HTTP_METHODS.POST, {
+      callId,
+      ...(lineOwnerId ? {
+        lineOwnerId
+      } : {})
+    }, _constants.METHODS.REJECT);
+  }
+  muteCall(params) {
+    const {
+      callId,
+      lineOwnerId
+    } = params;
+    return this.telephonyRequest('/mute', _types.HTTP_METHODS.POST, {
+      callId,
+      ...(lineOwnerId ? {
+        lineOwnerId
+      } : {})
+    }, _constants.METHODS.TOGGLE_MUTE);
+  }
+  unmuteCall(params) {
+    const {
+      callId,
+      lineOwnerId
+    } = params;
+    return this.telephonyRequest('/unmute', _types.HTTP_METHODS.POST, {
+      callId,
+      ...(lineOwnerId ? {
+        lineOwnerId
+      } : {})
+    }, _constants.METHODS.TOGGLE_MUTE);
+  }
+  transmitDtmf(params) {
+    const {
+      callId,
+      dtmf,
+      lineOwnerId
+    } = params;
+    return this.telephonyRequest('/transmitDtmf', _types.HTTP_METHODS.POST, {
+      callId,
+      dtmf,
+      ...(lineOwnerId ? {
+        lineOwnerId
+      } : {})
+    }, _constants.METHODS.TRANSMIT_DTMF);
+  }
+  async getCallDetails(params) {
+    const {
+      callId,
+      lineOwnerId
+    } = params;
+    const lineOwnerIdQuery = lineOwnerId ? `?lineOwnerId=${encodeURIComponent(lineOwnerId)}` : '';
+    const uri = `${this.getTelephonyBaseUrl()}/${callId}${lineOwnerIdQuery}`;
+    try {
+      _loggerProxy.default.info('AnswerCallOnWebexService.getCallDetails request', {
+        module: ANSWER_CALL_ON_WEBEX_FILE,
+        method: _constants.METHODS.GET_CALL_DETAILS_ON_WEBEX,
+        data: {
+          callId
+        }
+      });
+      const response = await this.webex.request({
+        uri,
+        method: _types.HTTP_METHODS.GET,
+        addAuthHeader: true
+      });
+      return response.body ?? {};
+    } catch (error) {
+      if ((0, _wxAppTelephonyUtils.isWxAppCallNotFoundError)(error)) {
+        const err = error instanceof Error ? error : new Error(String(error?.message ?? error));
+        throw markWxAppTelephonyError(err, error);
+      }
+      const trackingId = this.extractTrackingId(error);
+      _loggerProxy.default.error(`AnswerCallOnWebexService.getCallDetails failed: ${error}`, {
+        module: ANSWER_CALL_ON_WEBEX_FILE,
+        method: _constants.METHODS.GET_CALL_DETAILS_ON_WEBEX,
+        data: {
+          trackingId,
+          status: extractWxAppHttpStatus(error)
+        }
+      });
+      const {
+        error: detailedError
+      } = (0, _Utils.getErrorDetails)(error, _constants.METHODS.GET_CALL_DETAILS_ON_WEBEX, _constants.CC_FILE);
+      throw markWxAppTelephonyError(detailedError, error);
+    }
+  }
+}
+exports.default = AnswerCallOnWebexService;
+//# sourceMappingURL=AnswerCallOnWebexService.js.map

package/dist/services/AnswerCallOnWebexService.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["_loggerProxy","_interopRequireDefault","require","_constants","_types","_Utils","_wxAppTelephonyUtils","e","__esModule","default","ANSWER_CALL_ON_WEBEX_FILE","extractWxAppTrackingId","source","sourceObj","details","trackingId","extractWxAppHttpStatus","obj","statusCode","status","markWxAppTelephonyError","error","marked","isWxAppTelephonyError","undefined","AnswerCallOnWebexService","constructor","webex","getTelephonyBaseUrl","services","internal","hydraUrl","_serviceUrls","hydra","get","Error","replace","extractTrackingId","telephonyRequest","resource","method","body","logMethod","uri","LoggerProxy","info","module","data","bodyKeys","Object","keys","response","request","addAuthHeader","detailedError","getErrorDetails","CC_FILE","answerCall","params","callId","endpointId","lineOwnerId","HTTP_METHODS","POST","METHODS","ACCEPT","rejectCall","REJECT","muteCall","TOGGLE_MUTE","unmuteCall","transmitDtmf","dtmf","TRANSMIT_DTMF","getCallDetails","lineOwnerIdQuery","encodeURIComponent","GET_CALL_DETAILS_ON_WEBEX","GET","isWxAppCallNotFoundError","err","String","message","exports"],"sources":["AnswerCallOnWebexService.ts"],"sourcesContent":["import LoggerProxy from '../logger-proxy';\nimport {CC_FILE, METHODS} from '../constants';\nimport {HTTP_METHODS, IHttpResponse, WebexSDK} from '../types';\nimport {getErrorDetails} from './core/Utils';\nimport {isWxAppCallNotFoundError} from './wxAppTelephonyUtils';\n\nconst ANSWER_CALL_ON_WEBEX_FILE = 'AnswerCallOnWebexService';\n\nexport type WxAppTelephonyError = Error & {\n  isWxAppTelephonyError: true;\n  trackingId?: string;\n  status?: number | string;\n};\n\nconst extractWxAppTrackingId = (source: unknown): string | undefined => {\n  const sourceObj = source as {details?: {trackingId?: string}; trackingId?: string};\n\n  return sourceObj?.details?.trackingId || sourceObj?.trackingId;\n};\n\nconst extractWxAppHttpStatus = (source: unknown): number | string | undefined => {\n  const obj = source as {\n    statusCode?: number;\n    status?: number | string;\n    details?: {status?: number | string};\n  };\n\n  return obj?.statusCode ?? obj?.status ?? obj?.details?.status;\n};\n\nconst markWxAppTelephonyError = (error: Error, source: unknown): WxAppTelephonyError => {\n  const marked = error as WxAppTelephonyError;\n  marked.isWxAppTelephonyError = true;\n  const trackingId = extractWxAppTrackingId(source);\n  if (trackingId) {\n    marked.trackingId = trackingId;\n  }\n  const status = extractWxAppHttpStatus(source);\n  if (status !== undefined) {\n    marked.status = status;\n  }\n\n  return marked;\n};\n\nexport type AnswerCallParams = {\n  callId: string;\n  endpointId: string;\n  lineOwnerId?: string;\n};\n\nexport type CallIdParams = {\n  callId: string;\n  lineOwnerId?: string;\n};\n\nexport type TransmitDtmfParams = CallIdParams & {\n  dtmf: string;\n};\n\nexport type CallDetailsResponse = {\n  muted?: boolean;\n};\n\n/**\n * REST telephony client for wxApp thick-client answer (WXCC-6026).\n * Separate from WebCallingService (WebRTC/Mobius).\n */\nexport default class AnswerCallOnWebexService {\n  private webex: WebexSDK;\n\n  constructor(webex: WebexSDK) {\n    this.webex = webex;\n  }\n\n  private getTelephonyBaseUrl(): string {\n    const services = this.webex.internal.services;\n    const hydraUrl = services._serviceUrls?.hydra || services.get('hydra');\n\n    if (!hydraUrl) {\n      throw new Error('Telephony base URL is unavailable');\n    }\n\n    return `${hydraUrl.replace(/\\/$/, '')}/telephony/calls`;\n  }\n\n  private extractTrackingId(source: unknown): string | undefined {\n    return extractWxAppTrackingId(source);\n  }\n\n  private async telephonyRequest(\n    resource: string,\n    method: HTTP_METHODS,\n    body: Record<string, unknown>,\n    logMethod: string\n  ): Promise<IHttpResponse> {\n    try {\n      const uri = `${this.getTelephonyBaseUrl()}${resource}`;\n\n      LoggerProxy.info(`AnswerCallOnWebexService.${logMethod} request`, {\n        module: ANSWER_CALL_ON_WEBEX_FILE,\n        method: logMethod,\n        data: {uri, bodyKeys: Object.keys(body)},\n      });\n\n      const response = (await this.webex.request({\n        uri,\n        method,\n        body,\n        addAuthHeader: true,\n      })) as IHttpResponse;\n\n      LoggerProxy.info(`AnswerCallOnWebexService.${logMethod} success`, {\n        module: ANSWER_CALL_ON_WEBEX_FILE,\n        method: logMethod,\n        data: {statusCode: response.statusCode},\n      });\n\n      return response;\n    } catch (error) {\n      const trackingId = this.extractTrackingId(error);\n      LoggerProxy.error(`AnswerCallOnWebexService.${logMethod} failed: ${error}`, {\n        module: ANSWER_CALL_ON_WEBEX_FILE,\n        method: logMethod,\n        data: {\n          trackingId,\n          status: extractWxAppHttpStatus(error),\n        },\n      });\n      const {error: detailedError} = getErrorDetails(error, logMethod, CC_FILE);\n      throw markWxAppTelephonyError(detailedError, error);\n    }\n  }\n\n  public answerCall(params: AnswerCallParams): Promise<IHttpResponse> {\n    const {callId, endpointId, lineOwnerId} = params;\n\n    return this.telephonyRequest(\n      '/answer',\n      HTTP_METHODS.POST,\n      {\n        callId,\n        endpointId,\n        ...(lineOwnerId ? {lineOwnerId} : {}),\n      },\n      METHODS.ACCEPT\n    );\n  }\n\n  public rejectCall(params: CallIdParams): Promise<IHttpResponse> {\n    const {callId, lineOwnerId} = params;\n\n    return this.telephonyRequest(\n      '/reject',\n      HTTP_METHODS.POST,\n      {callId, ...(lineOwnerId ? {lineOwnerId} : {})},\n      METHODS.REJECT\n    );\n  }\n\n  public muteCall(params: CallIdParams): Promise<IHttpResponse> {\n    const {callId, lineOwnerId} = params;\n\n    return this.telephonyRequest(\n      '/mute',\n      HTTP_METHODS.POST,\n      {callId, ...(lineOwnerId ? {lineOwnerId} : {})},\n      METHODS.TOGGLE_MUTE\n    );\n  }\n\n  public unmuteCall(params: CallIdParams): Promise<IHttpResponse> {\n    const {callId, lineOwnerId} = params;\n\n    return this.telephonyRequest(\n      '/unmute',\n      HTTP_METHODS.POST,\n      {callId, ...(lineOwnerId ? {lineOwnerId} : {})},\n      METHODS.TOGGLE_MUTE\n    );\n  }\n\n  public transmitDtmf(params: TransmitDtmfParams): Promise<IHttpResponse> {\n    const {callId, dtmf, lineOwnerId} = params;\n\n    return this.telephonyRequest(\n      '/transmitDtmf',\n      HTTP_METHODS.POST,\n      {callId, dtmf, ...(lineOwnerId ? {lineOwnerId} : {})},\n      METHODS.TRANSMIT_DTMF\n    );\n  }\n\n  public async getCallDetails(params: CallIdParams): Promise<CallDetailsResponse> {\n    const {callId, lineOwnerId} = params;\n    const lineOwnerIdQuery = lineOwnerId ? `?lineOwnerId=${encodeURIComponent(lineOwnerId)}` : '';\n    const uri = `${this.getTelephonyBaseUrl()}/${callId}${lineOwnerIdQuery}`;\n\n    try {\n      LoggerProxy.info('AnswerCallOnWebexService.getCallDetails request', {\n        module: ANSWER_CALL_ON_WEBEX_FILE,\n        method: METHODS.GET_CALL_DETAILS_ON_WEBEX,\n        data: {callId},\n      });\n\n      const response = (await this.webex.request({\n        uri,\n        method: HTTP_METHODS.GET,\n        addAuthHeader: true,\n      })) as IHttpResponse;\n\n      return (response.body ?? {}) as CallDetailsResponse;\n    } catch (error) {\n      if (isWxAppCallNotFoundError(error)) {\n        const err =\n          error instanceof Error\n            ? error\n            : new Error(String((error as {message?: string})?.message ?? error));\n        throw markWxAppTelephonyError(err, error);\n      }\n\n      const trackingId = this.extractTrackingId(error);\n      LoggerProxy.error(`AnswerCallOnWebexService.getCallDetails failed: ${error}`, {\n        module: ANSWER_CALL_ON_WEBEX_FILE,\n        method: METHODS.GET_CALL_DETAILS_ON_WEBEX,\n        data: {\n          trackingId,\n          status: extractWxAppHttpStatus(error),\n        },\n      });\n      const {error: detailedError} = getErrorDetails(\n        error,\n        METHODS.GET_CALL_DETAILS_ON_WEBEX,\n        CC_FILE\n      );\n      throw markWxAppTelephonyError(detailedError, error);\n    }\n  }\n}\n"],"mappings":"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","ignoreList":[]}

package/dist/services/ApiAiAssistant.js

@@ -4,6 +4,7 @@ Object.defineProperty(exports, "__esModule", {
   value: true
 });
 exports.default = exports.ApiAIAssistant = void 0;
+var _uuid = require("uuid");
 var _loggerProxy = _interopRequireDefault(require("../logger-proxy"));
 var _MetricsManager = _interopRequireDefault(require("../metrics/MetricsManager"));
 var _constants = require("../metrics/constants");
@@ -17,8 +18,21 @@ function _interopRequireDefault(e) { return e && e.__esModule ? e : { default: e
  * @public
  */
 class ApiAIAssistant {
-  constructor(webex) {
+  createWellnessError(reason) {
+    const error = new Error(reason);
+    error.details = {
+      type: 'SDK_VALIDATION_ERROR',
+      orgId: this.webex.credentials.getOrgId(),
+      trackingId: '',
+      data: {
+        reason
+      }
+    };
+    return error;
+  }
+  constructor(webex, wellnessContextProvider) {
     this.webex = webex;
+    this.wellnessContextProvider = wellnessContextProvider;
     this.metricsManager = _MetricsManager.default.getInstance({
       webex
     });
@@ -26,6 +40,108 @@ class ApiAIAssistant {
   setAIFeatureFlags(aiFeature) {
     this.aiFeature = aiFeature;
   }
+  async sendWellnessBreakAction(action, method) {
+    this.metricsManager.timeEvent([_constants.METRIC_EVENT_NAMES.AI_ASSISTANT_WELLNESS_ACTION_ACCEPTED, _constants.METRIC_EVENT_NAMES.AI_ASSISTANT_WELLNESS_ACTION_FAILED]);
+    try {
+      const context = this.wellnessContextProvider?.();
+      const agentId = context?.agentId?.trim();
+      const agentSessionId = context?.agentSessionId?.trim();
+      const orgId = this.webex.credentials.getOrgId()?.trim();
+      if (context?.isWellnessBreakEnabled !== true) {
+        throw this.createWellnessError('WELLNESS_BREAK_NOT_ENABLED');
+      }
+      if (!orgId) {
+        throw this.createWellnessError('WELLNESS_BREAK_ORG_ID_REQUIRED');
+      }
+      if (!agentId) {
+        throw this.createWellnessError('WELLNESS_BREAK_AGENT_ID_REQUIRED');
+      }
+      if (!agentSessionId) {
+        throw this.createWellnessError('WELLNESS_BREAK_AGENT_SESSION_REQUIRED');
+      }
+      const baseUrl = this.getBaseUrl();
+      const response = await this.webex.request({
+        uri: `${baseUrl}${_constants3.AI_ASSISTANT_API_URLS.EVENT}`,
+        method: _types.HTTP_METHODS.POST,
+        addAuthHeader: true,
+        body: {
+          agentId,
+          orgId,
+          eventType: _types.AIAssistantEventType.CUSTOM_EVENT,
+          eventName: _types.AIAssistantEventName.WELLNESS_BREAK_ACTION,
+          eventDetails: {
+            data: {
+              action,
+              agentSessionId,
+              actionTimeStamp: Date.now()
+            }
+          }
+        }
+      });
+      if (response.statusCode !== 202) {
+        throw this.createWellnessError(`WELLNESS_BREAK_ACTION_UNEXPECTED_STATUS_${response.statusCode}`);
+      }
+      this.metricsManager.trackEvent(_constants.METRIC_EVENT_NAMES.AI_ASSISTANT_WELLNESS_ACTION_ACCEPTED, {
+        action
+      }, ['operational']);
+      _loggerProxy.default.log('Wellness action accepted by AI Assistant', {
+        module: _constants2.CC_FILE,
+        method,
+        data: {
+          action
+        }
+      });
+    } catch (error) {
+      this.metricsManager.trackEvent(_constants.METRIC_EVENT_NAMES.AI_ASSISTANT_WELLNESS_ACTION_FAILED, {
+        action,
+        error: error instanceof Error ? error.message : String(error)
+      }, ['operational']);
+      const {
+        error: detailedError
+      } = (0, _Utils.getErrorDetails)(error, method, _constants2.CC_FILE);
+      throw detailedError;
+    }
+  }
+
+  /**
+   * Requests an Agent Wellness Break.
+   * The promise resolves when the HTTP request is accepted with status 202; the later
+   * approval or denial is delivered independently through a wellness notification.
+   * @returns A promise that resolves with no value after HTTP acceptance
+   * @throws Structured Contact Center error when disabled, stale, invalid, or delivery fails
+   * @example
+   * await webex.cc.apiAIAssistant.requestWellnessBreak();
+   * @public
+   */
+  async requestWellnessBreak() {
+    return this.sendWellnessBreakAction(_types.WELLNESS_BREAK_USER_ACTIONS.REQUESTED, _constants2.METHODS.REQUEST_WELLNESS_BREAK);
+  }
+
+  /**
+   * Responds to a backend-provided Agent Wellness Break offer.
+   * The promise resolves when the HTTP request is accepted with status 202 and does not
+   * wait for a WebSocket completion event.
+   * @param params - ACCEPTED, REJECTED, or NO_RESPONSE
+   * @returns A promise that resolves with no value after HTTP acceptance
+   * @throws Structured Contact Center error when disabled, stale, invalid, or delivery fails
+   * @example
+   * await webex.cc.apiAIAssistant.respondToWellnessBreak({
+   *   action: WELLNESS_BREAK_USER_ACTIONS.ACCEPTED,
+   * });
+   * @public
+   */
+  async respondToWellnessBreak(params) {
+    const {
+      action
+    } = params;
+    if (![_types.WELLNESS_BREAK_USER_ACTIONS.ACCEPTED, _types.WELLNESS_BREAK_USER_ACTIONS.REJECTED, _types.WELLNESS_BREAK_USER_ACTIONS.NO_RESPONSE].includes(action)) {
+      const {
+        error
+      } = (0, _Utils.getErrorDetails)(this.createWellnessError('WELLNESS_BREAK_ACTION_INVALID'), _constants2.METHODS.RESPOND_TO_WELLNESS_BREAK, _constants2.CC_FILE);
+      throw error;
+    }
+    return this.sendWellnessBreakAction(action, _constants2.METHODS.RESPOND_TO_WELLNESS_BREAK);
+  }
   getBaseUrl() {
     const wccApiGatewayUrl = this.webex.internal.services.get(_constants3.WCC_API_GATEWAY) || '';
     if (!wccApiGatewayUrl) {
@@ -56,9 +172,11 @@ class ApiAIAssistant {
    * @param interactionId - interaction/conversation identifier
    * @param eventType - the type of event (e.g. 'CUSTOM_EVENT')
    * @param eventName - the name of the event (e.g. 'GET_TRANSCRIPTS')
-   * @param action - action within eventDetails (e.g. 'START' or 'STOP')
+   * @param eventMetaData - event-specific fields to include in eventDetails.data
+   * @param languageCode - language code within eventDetails.data
+   * @param trackingId - tracking identifier within eventDetails.data
    */
-  async sendEvent(agentId, interactionId, eventType, eventName, action) {
+  async sendEvent(agentId, interactionId, eventType, eventName, eventMetaData, languageCode, trackingId) {
     _loggerProxy.default.info('Sending event', {
       module: _constants2.CC_FILE,
       method: _constants2.METHODS.SEND_EVENT,
@@ -66,7 +184,7 @@ class ApiAIAssistant {
       data: {
         eventType,
         eventName,
-        action
+        eventMetaData
       }
     });
     this.metricsManager.timeEvent([_constants.METRIC_EVENT_NAMES.AI_ASSISTANT_SEND_EVENT_SUCCESS, _constants.METRIC_EVENT_NAMES.AI_ASSISTANT_SEND_EVENT_FAILED]);
@@ -84,9 +202,11 @@ class ApiAIAssistant {
           eventName,
           eventDetails: {
             data: {
+              ...eventMetaData,
               interactionId,
-              action,
-              actionTimeStamp: String(Date.now())
+              actionTimeStamp: String(Date.now()),
+              languageCode,
+              trackingId
             }
           }
         }
@@ -96,8 +216,7 @@ class ApiAIAssistant {
         orgId,
         interactionId,
         eventType,
-        eventName,
-        action
+        eventName
       }, ['operational']);
       return response?.body || {};
     } catch (error) {
@@ -105,7 +224,6 @@ class ApiAIAssistant {
         interactionId,
         eventType,
         eventName,
-        action,
         error: error instanceof Error ? error.message : String(error)
       }, ['operational']);
       const {
@@ -115,6 +233,148 @@ class ApiAIAssistant {
     }
   }
 
+  /**
+   * Requests real-time assistance for an interaction.
+   *
+   * @param params - Real-time assistance request parameters
+   * @returns HTTP response body from the AI Assistant event API
+   * @public
+   */
+  async getRealTimeAssistance(params) {
+    const {
+      agentId,
+      interactionId,
+      context
+    } = params;
+    const trimmedContext = context?.trim();
+    const languageCode = params.languageCode ?? 'en';
+    const trackingId = `WX_CC_SDK_${(0, _uuid.v4)()}`;
+    const eventName = trimmedContext ? _types.AIAssistantEventName.ADD_SUGGESTIONS_EXTRA_CONTEXT : _types.AIAssistantEventName.GET_SUGGESTIONS;
+    const loggerContext = {
+      module: _constants2.CC_FILE,
+      method: _constants2.METHODS.GET_REAL_TIME_ASSISTANCE,
+      interactionId,
+      trackingId,
+      data: {
+        eventName
+      }
+    };
+    _loggerProxy.default.info('Requesting real-time assistance', loggerContext);
+    this.metricsManager.timeEvent([_constants.METRIC_EVENT_NAMES.AI_ASSISTANT_GET_REAL_TIME_ASSISTANCE_SUCCESS, _constants.METRIC_EVENT_NAMES.AI_ASSISTANT_GET_REAL_TIME_ASSISTANCE_FAILED]);
+    try {
+      if (!this.aiFeature?.suggestedResponses?.enable) {
+        const {
+          error: detailedError
+        } = (0, _Utils.getErrorDetails)(new Error('SUGGESTED_RESPONSES_NOT_ENABLED'), _constants2.METHODS.GET_REAL_TIME_ASSISTANCE, _constants2.CC_FILE);
+        throw detailedError;
+      }
+      const orgId = this.webex.credentials.getOrgId();
+      const response = await this.sendEvent(agentId, interactionId, _types.AIAssistantEventType.CUSTOM_EVENT, eventName, trimmedContext !== undefined ? {
+        context: trimmedContext
+      } : undefined, languageCode, trackingId);
+      this.metricsManager.trackEvent(_constants.METRIC_EVENT_NAMES.AI_ASSISTANT_GET_REAL_TIME_ASSISTANCE_SUCCESS, {
+        agentId,
+        orgId,
+        interactionId,
+        eventName,
+        trackingId,
+        context
+      }, ['operational']);
+      _loggerProxy.default.log('Real-time assistance request succeeded', loggerContext);
+      return response;
+    } catch (error) {
+      _loggerProxy.default.error('Real-time assistance request failed', {
+        ...loggerContext,
+        error
+      });
+      this.metricsManager.trackEvent(_constants.METRIC_EVENT_NAMES.AI_ASSISTANT_GET_REAL_TIME_ASSISTANCE_FAILED, {
+        agentId,
+        interactionId,
+        trackingId,
+        eventName,
+        error: error instanceof Error ? error.message : String(error)
+      }, ['operational']);
+      const {
+        error: detailedError
+      } = (0, _Utils.getErrorDetails)(error, _constants2.METHODS.GET_REAL_TIME_ASSISTANCE, _constants2.CC_FILE);
+      throw detailedError;
+    }
+  }
+
+  /**
+   * Sends user action feedback for a real-time assistance adaptive card.
+   *
+   * @param params - Real-time assistance user action parameters
+   * @returns HTTP response body from the AI Assistant event API
+   * @public
+   */
+  async sendRealTimeAssistanceUserAction(params) {
+    const {
+      agentId,
+      interactionId,
+      adaptiveCardId,
+      actionId
+    } = params;
+    const actionType = 'Action.Submit';
+    const languageCode = params.languageCode ?? 'en';
+    const trackingId = `WX_CC_SDK_${(0, _uuid.v4)()}`;
+    const loggerContext = {
+      module: _constants2.CC_FILE,
+      method: _constants2.METHODS.SEND_REAL_TIME_ASSISTANCE_USER_ACTION,
+      interactionId,
+      trackingId,
+      data: {
+        actionId,
+        adaptiveCardId
+      }
+    };
+    _loggerProxy.default.info('Sending real-time assistance user action', loggerContext);
+    this.metricsManager.timeEvent([_constants.METRIC_EVENT_NAMES.AI_ASSISTANT_SEND_REAL_TIME_ASSISTANCE_USER_ACTION_SUCCESS, _constants.METRIC_EVENT_NAMES.AI_ASSISTANT_SEND_REAL_TIME_ASSISTANCE_USER_ACTION_FAILED]);
+    try {
+      if (!this.aiFeature?.suggestedResponses?.enable) {
+        const {
+          error: detailedError
+        } = (0, _Utils.getErrorDetails)(new Error('SUGGESTED_RESPONSES_NOT_ENABLED'), _constants2.METHODS.SEND_REAL_TIME_ASSISTANCE_USER_ACTION, _constants2.CC_FILE);
+        throw detailedError;
+      }
+      const orgId = this.webex.credentials.getOrgId();
+      const response = await this.sendEvent(agentId, interactionId, _types.AIAssistantEventType.CUSTOM_EVENT, _types.AIAssistantEventName.SUGGESTED_RESPONSES_USER_ACTION, {
+        adaptiveCardId,
+        userAction: {
+          actionType,
+          actionId
+        }
+      }, languageCode, trackingId);
+      this.metricsManager.trackEvent(_constants.METRIC_EVENT_NAMES.AI_ASSISTANT_SEND_REAL_TIME_ASSISTANCE_USER_ACTION_SUCCESS, {
+        agentId,
+        orgId,
+        interactionId,
+        adaptiveCardId,
+        actionId,
+        trackingId
+      }, ['operational']);
+      _loggerProxy.default.log('Real-time assistance user action sent', loggerContext);
+      return response;
+    } catch (error) {
+      _loggerProxy.default.error('Real-time assistance user action failed', {
+        ...loggerContext,
+        error
+      });
+      this.metricsManager.trackEvent(_constants.METRIC_EVENT_NAMES.AI_ASSISTANT_SEND_REAL_TIME_ASSISTANCE_USER_ACTION_FAILED, {
+        agentId,
+        interactionId,
+        adaptiveCardId,
+        actionId,
+        trackingId,
+        error: error instanceof Error ? error.message : String(error)
+      }, ['operational']);
+      const {
+        error: detailedError
+      } = (0, _Utils.getErrorDetails)(error, _constants2.METHODS.SEND_REAL_TIME_ASSISTANCE_USER_ACTION, _constants2.CC_FILE);
+      throw detailedError;
+    }
+  }
+
   /**
    * Fetches historic transcripts for an interaction.
    * This API is allowed only when real-time transcription feature is enabled.