@webex/contact-center 3.12.0-llmrefactor.2 → 3.12.0-llmrefactor.3

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (187) hide show
  1. package/.sdd/manifest.json +5 -4
  2. package/ai-docs/ARCHITECTURE.md +1 -1
  3. package/ai-docs/CONTRACTS.md +5 -1
  4. package/ai-docs/SECURITY.md +1 -1
  5. package/ai-docs/contact-center-spec.md +22 -4
  6. package/ai-docs/features/consult-transfer-list-policy/spec/feature-spec.md +362 -0
  7. package/dist/cc.js +440 -10
  8. package/dist/cc.js.map +1 -1
  9. package/dist/config.js +7 -0
  10. package/dist/config.js.map +1 -1
  11. package/dist/constants.js +10 -2
  12. package/dist/constants.js.map +1 -1
  13. package/dist/index.js.map +1 -1
  14. package/dist/metrics/behavioral-events.js +13 -0
  15. package/dist/metrics/behavioral-events.js.map +1 -1
  16. package/dist/metrics/constants.js +2 -0
  17. package/dist/metrics/constants.js.map +1 -1
  18. package/dist/services/AddressBook.js +18 -15
  19. package/dist/services/AddressBook.js.map +1 -1
  20. package/dist/services/AnswerCallOnWebexService.js +174 -0
  21. package/dist/services/AnswerCallOnWebexService.js.map +1 -0
  22. package/dist/services/EntryPoint.js +46 -68
  23. package/dist/services/EntryPoint.js.map +1 -1
  24. package/dist/services/Queue.js +27 -22
  25. package/dist/services/Queue.js.map +1 -1
  26. package/dist/services/WebexCrossClientService.js +171 -0
  27. package/dist/services/WebexCrossClientService.js.map +1 -0
  28. package/dist/services/WxAppTelephonyMercurySync.js +93 -0
  29. package/dist/services/WxAppTelephonyMercurySync.js.map +1 -0
  30. package/dist/services/config/Util.js +3 -0
  31. package/dist/services/config/Util.js.map +1 -1
  32. package/dist/services/config/constants.js +10 -6
  33. package/dist/services/config/constants.js.map +1 -1
  34. package/dist/services/config/types.js +4 -0
  35. package/dist/services/config/types.js.map +1 -1
  36. package/dist/services/core/Err.js.map +1 -1
  37. package/dist/services/core/WebexRequest.js +6 -2
  38. package/dist/services/core/WebexRequest.js.map +1 -1
  39. package/dist/services/core/aqm-reqs.js +28 -14
  40. package/dist/services/core/aqm-reqs.js.map +1 -1
  41. package/dist/services/core/types.js.map +1 -1
  42. package/dist/services/task/Task.js +73 -7
  43. package/dist/services/task/Task.js.map +1 -1
  44. package/dist/services/task/TaskFactory.js +8 -4
  45. package/dist/services/task/TaskFactory.js.map +1 -1
  46. package/dist/services/task/TaskManager.js +176 -20
  47. package/dist/services/task/TaskManager.js.map +1 -1
  48. package/dist/services/task/WebexCallingUtils.js +70 -0
  49. package/dist/services/task/WebexCallingUtils.js.map +1 -0
  50. package/dist/services/task/constants.js +4 -1
  51. package/dist/services/task/constants.js.map +1 -1
  52. package/dist/services/task/contact.js +29 -0
  53. package/dist/services/task/contact.js.map +1 -1
  54. package/dist/services/task/digital/Digital.js +3 -2
  55. package/dist/services/task/digital/Digital.js.map +1 -1
  56. package/dist/services/task/state-machine/TaskStateMachine.js +135 -37
  57. package/dist/services/task/state-machine/TaskStateMachine.js.map +1 -1
  58. package/dist/services/task/state-machine/actions.js +6 -1
  59. package/dist/services/task/state-machine/actions.js.map +1 -1
  60. package/dist/services/task/state-machine/guards.js +38 -11
  61. package/dist/services/task/state-machine/guards.js.map +1 -1
  62. package/dist/services/task/state-machine/types.js.map +1 -1
  63. package/dist/services/task/state-machine/uiControlsComputer.js +118 -18
  64. package/dist/services/task/state-machine/uiControlsComputer.js.map +1 -1
  65. package/dist/services/task/types.js +16 -1
  66. package/dist/services/task/types.js.map +1 -1
  67. package/dist/services/task/voice/Voice.js +350 -14
  68. package/dist/services/task/voice/Voice.js.map +1 -1
  69. package/dist/services/task/voice/WebRTC.js +4 -1
  70. package/dist/services/task/voice/WebRTC.js.map +1 -1
  71. package/dist/services/task/voice/wxAppVoiceMethods.js +201 -0
  72. package/dist/services/task/voice/wxAppVoiceMethods.js.map +1 -0
  73. package/dist/services/wxAppTelephonyUtils.js +19 -0
  74. package/dist/services/wxAppTelephonyUtils.js.map +1 -0
  75. package/dist/types/cc.d.ts +77 -4
  76. package/dist/types/config.d.ts +7 -0
  77. package/dist/types/constants.d.ts +8 -0
  78. package/dist/types/index.d.ts +3 -1
  79. package/dist/types/metrics/constants.d.ts +2 -0
  80. package/dist/types/services/AddressBook.d.ts +2 -1
  81. package/dist/types/services/AnswerCallOnWebexService.d.ts +37 -0
  82. package/dist/types/services/EntryPoint.d.ts +7 -5
  83. package/dist/types/services/Queue.d.ts +5 -3
  84. package/dist/types/services/WebexCrossClientService.d.ts +28 -0
  85. package/dist/types/services/WxAppTelephonyMercurySync.d.ts +28 -0
  86. package/dist/types/services/config/constants.d.ts +8 -5
  87. package/dist/types/services/config/types.d.ts +17 -4
  88. package/dist/types/services/core/Err.d.ts +2 -0
  89. package/dist/types/services/core/WebexRequest.d.ts +1 -0
  90. package/dist/types/services/core/types.d.ts +2 -0
  91. package/dist/types/services/task/Task.d.ts +20 -2
  92. package/dist/types/services/task/TaskFactory.d.ts +2 -1
  93. package/dist/types/services/task/WebexCallingUtils.d.ts +11 -0
  94. package/dist/types/services/task/constants.d.ts +3 -0
  95. package/dist/types/services/task/contact.d.ts +4 -0
  96. package/dist/types/services/task/digital/Digital.d.ts +2 -2
  97. package/dist/types/services/task/state-machine/TaskStateMachine.d.ts +260 -56
  98. package/dist/types/services/task/state-machine/guards.d.ts +6 -5
  99. package/dist/types/services/task/state-machine/types.d.ts +9 -1
  100. package/dist/types/services/task/types.d.ts +81 -4
  101. package/dist/types/services/task/voice/Voice.d.ts +48 -9
  102. package/dist/types/services/task/voice/WebRTC.d.ts +2 -2
  103. package/dist/types/services/task/voice/wxAppVoiceMethods.d.ts +52 -0
  104. package/dist/types/services/wxAppTelephonyUtils.d.ts +5 -0
  105. package/dist/types/types.d.ts +14 -8
  106. package/dist/types/utils/PageCache.d.ts +20 -3
  107. package/dist/types.js +7 -2
  108. package/dist/types.js.map +1 -1
  109. package/dist/utils/PageCache.js +19 -5
  110. package/dist/utils/PageCache.js.map +1 -1
  111. package/dist/webex.js +1 -1
  112. package/package.json +1 -1
  113. package/src/cc.ts +506 -9
  114. package/src/config.ts +7 -0
  115. package/src/constants.ts +8 -0
  116. package/src/index.ts +2 -0
  117. package/src/metrics/ai-docs/metrics-spec.md +9 -3
  118. package/src/metrics/behavioral-events.ts +14 -0
  119. package/src/metrics/constants.ts +2 -0
  120. package/src/services/AddressBook.ts +17 -6
  121. package/src/services/AnswerCallOnWebexService.ts +206 -0
  122. package/src/services/EntryPoint.ts +59 -60
  123. package/src/services/Queue.ts +29 -12
  124. package/src/services/WebexCrossClientService.ts +212 -0
  125. package/src/services/WxAppTelephonyMercurySync.ts +115 -0
  126. package/src/services/ai-docs/AGENTS.md +10 -10
  127. package/src/services/ai-docs/services-spec.md +6 -1
  128. package/src/services/config/Util.ts +3 -0
  129. package/src/services/config/ai-docs/AGENTS.md +1 -1
  130. package/src/services/config/ai-docs/ARCHITECTURE.md +2 -2
  131. package/src/services/config/ai-docs/config-spec.md +6 -0
  132. package/src/services/config/constants.ts +10 -6
  133. package/src/services/config/types.ts +16 -4
  134. package/src/services/core/Err.ts +1 -0
  135. package/src/services/core/WebexRequest.ts +3 -1
  136. package/src/services/core/ai-docs/core-spec.md +5 -1
  137. package/src/services/core/aqm-reqs.ts +30 -15
  138. package/src/services/core/types.ts +2 -0
  139. package/src/services/task/Task.ts +79 -8
  140. package/src/services/task/TaskFactory.ts +8 -3
  141. package/src/services/task/TaskManager.ts +254 -15
  142. package/src/services/task/WebexCallingUtils.ts +136 -0
  143. package/src/services/task/ai-docs/ARCHITECTURE.md +1 -0
  144. package/src/services/task/ai-docs/task-spec.md +117 -2
  145. package/src/services/task/constants.ts +3 -0
  146. package/src/services/task/contact.ts +30 -0
  147. package/src/services/task/digital/Digital.ts +4 -2
  148. package/src/services/task/state-machine/TaskStateMachine.ts +210 -63
  149. package/src/services/task/state-machine/actions.ts +5 -2
  150. package/src/services/task/state-machine/ai-docs/AGENTS.md +8 -4
  151. package/src/services/task/state-machine/ai-docs/ARCHITECTURE.md +17 -8
  152. package/src/services/task/state-machine/ai-docs/task-state-machine-spec.md +46 -22
  153. package/src/services/task/state-machine/guards.ts +64 -11
  154. package/src/services/task/state-machine/types.ts +16 -1
  155. package/src/services/task/state-machine/uiControlsComputer.ts +206 -32
  156. package/src/services/task/types.ts +114 -4
  157. package/src/services/task/voice/Voice.ts +462 -12
  158. package/src/services/task/voice/WebRTC.ts +5 -1
  159. package/src/services/task/voice/wxAppVoiceMethods.ts +307 -0
  160. package/src/services/wxAppTelephonyUtils.ts +14 -0
  161. package/src/types.ts +33 -9
  162. package/src/utils/AGENTS.md +21 -10
  163. package/src/utils/PageCache.ts +38 -5
  164. package/src/utils/ai-docs/utils-spec.md +21 -11
  165. package/test/unit/spec/cc.ts +1274 -0
  166. package/test/unit/spec/metrics/behavioral-events.ts +18 -0
  167. package/test/unit/spec/services/AddressBook.ts +37 -6
  168. package/test/unit/spec/services/AnswerCallOnWebexService.ts +223 -0
  169. package/test/unit/spec/services/EntryPoint.ts +87 -40
  170. package/test/unit/spec/services/Queue.ts +123 -12
  171. package/test/unit/spec/services/WebexCrossClientService.ts +261 -0
  172. package/test/unit/spec/services/WxAppTelephonyMercurySync.ts +113 -0
  173. package/test/unit/spec/services/config/Util.ts +85 -0
  174. package/test/unit/spec/services/core/WebexRequest.ts +3 -1
  175. package/test/unit/spec/services/core/aqm-reqs.ts +113 -1
  176. package/test/unit/spec/services/task/Task.ts +200 -0
  177. package/test/unit/spec/services/task/TaskFactory.ts +39 -2
  178. package/test/unit/spec/services/task/TaskManager.ts +653 -1
  179. package/test/unit/spec/services/task/WebexCallingUtils.ts +153 -0
  180. package/test/unit/spec/services/task/contact.ts +33 -0
  181. package/test/unit/spec/services/task/state-machine/TaskStateMachine.ts +854 -72
  182. package/test/unit/spec/services/task/state-machine/guards.ts +210 -8
  183. package/test/unit/spec/services/task/state-machine/uiControlsComputer.ts +445 -7
  184. package/test/unit/spec/services/task/voice/Voice.ts +874 -0
  185. package/test/unit/spec/services/task/voice/wxAppVoiceMethods.ts +459 -0
  186. package/umd/contact-center.min.js +2 -2
  187. package/umd/contact-center.min.js.map +1 -1
@@ -0,0 +1,174 @@
1
+ "use strict";
2
+
3
+ Object.defineProperty(exports, "__esModule", {
4
+ value: true
5
+ });
6
+ exports.default = void 0;
7
+ var _loggerProxy = _interopRequireDefault(require("../logger-proxy"));
8
+ var _constants = require("../constants");
9
+ var _types = require("../types");
10
+ var _Utils = require("./core/Utils");
11
+ var _wxAppTelephonyUtils = require("./wxAppTelephonyUtils");
12
+ function _interopRequireDefault(e) { return e && e.__esModule ? e : { default: e }; }
13
+ const ANSWER_CALL_ON_WEBEX_FILE = 'AnswerCallOnWebexService';
14
+ const markWxAppTelephonyError = (error, source) => {
15
+ const marked = error;
16
+ marked.isWxAppTelephonyError = true;
17
+ const sourceObj = source;
18
+ const trackingId = sourceObj?.details?.trackingId;
19
+ if (trackingId) {
20
+ marked.trackingId = trackingId;
21
+ }
22
+ const status = sourceObj?.statusCode ?? sourceObj?.details?.status ?? sourceObj?.status;
23
+ if (status !== undefined) {
24
+ marked.status = status;
25
+ }
26
+ return marked;
27
+ };
28
+ /**
29
+ * REST telephony client for wxApp thick-client answer (WXCC-6026).
30
+ * Separate from WebCallingService (WebRTC/Mobius).
31
+ */
32
+ class AnswerCallOnWebexService {
33
+ constructor(webex) {
34
+ this.webex = webex;
35
+ }
36
+ getTelephonyBaseUrl() {
37
+ const services = this.webex.internal.services;
38
+ const hydraUrl = services._serviceUrls?.hydra || services.get('hydra');
39
+ if (!hydraUrl) {
40
+ throw new Error('Telephony base URL is unavailable');
41
+ }
42
+ return `${hydraUrl.replace(/\/$/, '')}/telephony/calls`;
43
+ }
44
+ async telephonyRequest(resource, method, body, logMethod) {
45
+ try {
46
+ const uri = `${this.getTelephonyBaseUrl()}${resource}`;
47
+ _loggerProxy.default.info(`AnswerCallOnWebexService.${logMethod} request`, {
48
+ module: ANSWER_CALL_ON_WEBEX_FILE,
49
+ method: logMethod,
50
+ data: {
51
+ uri,
52
+ bodyKeys: Object.keys(body)
53
+ }
54
+ });
55
+ return await this.webex.request({
56
+ uri,
57
+ method,
58
+ body,
59
+ addAuthHeader: true
60
+ });
61
+ } catch (error) {
62
+ _loggerProxy.default.error(`AnswerCallOnWebexService.${logMethod} failed: ${error}`, {
63
+ module: ANSWER_CALL_ON_WEBEX_FILE,
64
+ method: logMethod
65
+ });
66
+ const {
67
+ error: detailedError
68
+ } = (0, _Utils.getErrorDetails)(error, logMethod, _constants.CC_FILE);
69
+ throw markWxAppTelephonyError(detailedError, error);
70
+ }
71
+ }
72
+ answerCall(params) {
73
+ const {
74
+ callId,
75
+ endpointId,
76
+ lineOwnerId
77
+ } = params;
78
+ return this.telephonyRequest('/answer', _types.HTTP_METHODS.POST, {
79
+ callId,
80
+ endpointId,
81
+ ...(lineOwnerId ? {
82
+ lineOwnerId
83
+ } : {})
84
+ }, _constants.METHODS.ACCEPT);
85
+ }
86
+ rejectCall(params) {
87
+ const {
88
+ callId,
89
+ lineOwnerId
90
+ } = params;
91
+ return this.telephonyRequest('/reject', _types.HTTP_METHODS.POST, {
92
+ callId,
93
+ ...(lineOwnerId ? {
94
+ lineOwnerId
95
+ } : {})
96
+ }, _constants.METHODS.REJECT);
97
+ }
98
+ muteCall(params) {
99
+ const {
100
+ callId,
101
+ lineOwnerId
102
+ } = params;
103
+ return this.telephonyRequest('/mute', _types.HTTP_METHODS.POST, {
104
+ callId,
105
+ ...(lineOwnerId ? {
106
+ lineOwnerId
107
+ } : {})
108
+ }, _constants.METHODS.TOGGLE_MUTE);
109
+ }
110
+ unmuteCall(params) {
111
+ const {
112
+ callId,
113
+ lineOwnerId
114
+ } = params;
115
+ return this.telephonyRequest('/unmute', _types.HTTP_METHODS.POST, {
116
+ callId,
117
+ ...(lineOwnerId ? {
118
+ lineOwnerId
119
+ } : {})
120
+ }, _constants.METHODS.TOGGLE_MUTE);
121
+ }
122
+ transmitDtmf(params) {
123
+ const {
124
+ callId,
125
+ dtmf,
126
+ lineOwnerId
127
+ } = params;
128
+ return this.telephonyRequest('/transmitDtmf', _types.HTTP_METHODS.POST, {
129
+ callId,
130
+ dtmf,
131
+ ...(lineOwnerId ? {
132
+ lineOwnerId
133
+ } : {})
134
+ }, _constants.METHODS.TRANSMIT_DTMF);
135
+ }
136
+ async getCallDetails(params) {
137
+ const {
138
+ callId,
139
+ lineOwnerId
140
+ } = params;
141
+ const lineOwnerIdQuery = lineOwnerId ? `?lineOwnerId=${encodeURIComponent(lineOwnerId)}` : '';
142
+ const uri = `${this.getTelephonyBaseUrl()}/${callId}${lineOwnerIdQuery}`;
143
+ try {
144
+ _loggerProxy.default.info('AnswerCallOnWebexService.getCallDetails request', {
145
+ module: ANSWER_CALL_ON_WEBEX_FILE,
146
+ method: _constants.METHODS.GET_CALL_DETAILS_ON_WEBEX,
147
+ data: {
148
+ callId
149
+ }
150
+ });
151
+ const response = await this.webex.request({
152
+ uri,
153
+ method: _types.HTTP_METHODS.GET,
154
+ addAuthHeader: true
155
+ });
156
+ return response.body ?? {};
157
+ } catch (error) {
158
+ if ((0, _wxAppTelephonyUtils.isWxAppCallNotFoundError)(error)) {
159
+ const err = error instanceof Error ? error : new Error(String(error?.message ?? error));
160
+ throw markWxAppTelephonyError(err, error);
161
+ }
162
+ _loggerProxy.default.error(`AnswerCallOnWebexService.getCallDetails failed: ${error}`, {
163
+ module: ANSWER_CALL_ON_WEBEX_FILE,
164
+ method: _constants.METHODS.GET_CALL_DETAILS_ON_WEBEX
165
+ });
166
+ const {
167
+ error: detailedError
168
+ } = (0, _Utils.getErrorDetails)(error, _constants.METHODS.GET_CALL_DETAILS_ON_WEBEX, _constants.CC_FILE);
169
+ throw markWxAppTelephonyError(detailedError, error);
170
+ }
171
+ }
172
+ }
173
+ exports.default = AnswerCallOnWebexService;
174
+ //# sourceMappingURL=AnswerCallOnWebexService.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"names":["_loggerProxy","_interopRequireDefault","require","_constants","_types","_Utils","_wxAppTelephonyUtils","e","__esModule","default","ANSWER_CALL_ON_WEBEX_FILE","markWxAppTelephonyError","error","source","marked","isWxAppTelephonyError","sourceObj","trackingId","details","status","statusCode","undefined","AnswerCallOnWebexService","constructor","webex","getTelephonyBaseUrl","services","internal","hydraUrl","_serviceUrls","hydra","get","Error","replace","telephonyRequest","resource","method","body","logMethod","uri","LoggerProxy","info","module","data","bodyKeys","Object","keys","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","response","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 markWxAppTelephonyError = (error: Error, source: unknown): WxAppTelephonyError => {\n const marked = error as WxAppTelephonyError;\n marked.isWxAppTelephonyError = true;\n const sourceObj = source as {\n details?: {trackingId?: string; status?: number | string};\n statusCode?: number;\n status?: number | string;\n };\n const trackingId = sourceObj?.details?.trackingId;\n if (trackingId) {\n marked.trackingId = trackingId;\n }\n const status = sourceObj?.statusCode ?? sourceObj?.details?.status ?? sourceObj?.status;\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 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 return (await this.webex.request({\n uri,\n method,\n body,\n addAuthHeader: true,\n })) as IHttpResponse;\n } catch (error) {\n LoggerProxy.error(`AnswerCallOnWebexService.${logMethod} failed: ${error}`, {\n module: ANSWER_CALL_ON_WEBEX_FILE,\n method: logMethod,\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 LoggerProxy.error(`AnswerCallOnWebexService.getCallDetails failed: ${error}`, {\n module: ANSWER_CALL_ON_WEBEX_FILE,\n method: METHODS.GET_CALL_DETAILS_ON_WEBEX,\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":[]}
@@ -7,13 +7,27 @@ exports.default = exports.EntryPoint = void 0;
7
7
  var _types = require("../types");
8
8
  var _loggerProxy = _interopRequireDefault(require("../logger-proxy"));
9
9
  var _WebexRequest = _interopRequireDefault(require("./core/WebexRequest"));
10
- var _PageCache = _interopRequireWildcard(require("../utils/PageCache"));
10
+ var _PageCache = require("../utils/PageCache");
11
11
  var _MetricsManager = _interopRequireDefault(require("../metrics/MetricsManager"));
12
12
  var _constants = require("./constants");
13
13
  var _constants2 = require("./config/constants");
14
14
  var _constants3 = require("../metrics/constants");
15
- function _interopRequireWildcard(e, t) { if ("function" == typeof WeakMap) var r = new WeakMap(), n = new WeakMap(); return (_interopRequireWildcard = function (e, t) { if (!t && e && e.__esModule) return e; var o, i, f = { __proto__: null, default: e }; if (null === e || "object" != typeof e && "function" != typeof e) return f; if (o = t ? n : r) { if (o.has(e)) return o.get(e); o.set(e, f); } for (const t in e) "default" !== t && {}.hasOwnProperty.call(e, t) && ((i = (o = Object.defineProperty) && Object.getOwnPropertyDescriptor(e, t)) && (i.get || i.set) ? o(f, t, i) : f[t] = e[t]); return f; })(e, t); }
16
15
  function _interopRequireDefault(e) { return e && e.__esModule ? e : { default: e }; }
16
+ const DEFAULT_ENTRY_POINT_ATTRIBUTES = 'id,dialledNumber,entryPointId,entryPointName';
17
+ const DEFAULT_ENTRY_POINT_SORT_FIELD = 'entryPointName';
18
+ const mergeEntryPointAttributes = attributes => {
19
+ const mergedAttributes = new Set(DEFAULT_ENTRY_POINT_ATTRIBUTES.split(','));
20
+ attributes?.split(',').map(attribute => attribute.trim()).filter(Boolean).forEach(attribute => mergedAttributes.add(attribute));
21
+ return Array.from(mergedAttributes).join(',');
22
+ };
23
+ const mapDialNumberEntryPoint = item => ({
24
+ id: item.entryPointId,
25
+ name: item.entryPointName,
26
+ ...(item.dialledNumber ? {
27
+ number: item.dialledNumber
28
+ } : {})
29
+ });
30
+
17
31
  /**
18
32
  * EntryPoint class for managing Webex Contact Center entry points.
19
33
  * Provides functionality to fetch, search, and paginate through entry points.
@@ -41,15 +55,13 @@ function _interopRequireDefault(e) { return e && e.__esModule ? e : { default: e
41
55
  * });
42
56
  *
43
57
  * // Search for specific entry points
44
- * const searchResults = await entryPointAPI.searchEntryPoints({
58
+ * const searchResults = await entryPointAPI.getEntryPoints({
45
59
  * search: 'support',
46
60
  * filter: 'type=="voice"'
47
61
  * });
48
62
  * ```
49
63
  */
50
64
  class EntryPoint {
51
- // Page cache using the common utility
52
-
53
65
  /**
54
66
  * Creates an instance of EntryPoint
55
67
  * @param {WebexSDK} webex - The Webex SDK instance
@@ -60,21 +72,23 @@ class EntryPoint {
60
72
  this.webexRequest = _WebexRequest.default.getInstance({
61
73
  webex
62
74
  });
63
- this.pageCache = new _PageCache.default('EntryPoint');
64
75
  this.metricsManager = _MetricsManager.default.getInstance({
65
76
  webex
66
77
  });
67
78
  }
68
79
 
69
80
  /**
70
- * Fetches entry points for the organization with pagination support
71
- * @param {EntryPointSearchParams} [params] - Search and pagination parameters
81
+ * Fetches entry-point dial-number mappings for the organization with pagination support. By
82
+ * default, returns the agent's desktop-profile-filtered mappings in backend entry-point-name order.
83
+ * Search, filter, attribute, and sort parameters can customize the request while desktop-profile
84
+ * scoping and required mapping fields remain SDK-owned.
85
+ * @param {EntryPointSearchParams} [params] - Search, pagination, and compatible override parameters.
72
86
  * @returns {Promise<EntryPointListResponse>} Promise resolving to paginated entry points
73
87
  * @throws {Error} If the API call fails
74
88
  * @public
75
89
  * @example
76
90
  * ```typescript
77
- * // Get first page of entry points
91
+ * // Get the first page using the default entry-point policy
78
92
  * const response = await entryPointAPI.getEntryPoints();
79
93
  *
80
94
  * // Get specific page with custom page size
@@ -92,57 +106,32 @@ class EntryPoint {
92
106
  search,
93
107
  filter,
94
108
  attributes,
95
- sortBy,
109
+ sortBy = 'name',
96
110
  sortOrder = 'asc'
97
111
  } = params;
98
112
  const orgId = this.webex.credentials.getOrgId();
99
- const isSearchRequest = !!(search || filter || attributes || sortBy);
113
+ const hasCustomSort = sortBy !== 'name' || sortOrder !== 'asc';
114
+ const isSearchRequest = !!(search || filter || attributes || hasCustomSort);
115
+ const effectiveSortBy = sortBy === 'name' ? DEFAULT_ENTRY_POINT_SORT_FIELD : sortBy;
100
116
  _loggerProxy.default.info(`Fetching entry points - orgId: ${orgId}, page: ${page}, pageSize: ${pageSize}, isSearchRequest: ${isSearchRequest}`, {
101
117
  module: 'EntryPoint',
102
118
  method: 'getEntryPoints'
103
119
  });
104
-
105
- // Check if we can use cache for simple pagination (no search/filter/attributes/sort)
106
- if (this.pageCache.canUseCache({
107
- search,
108
- filter,
109
- attributes,
110
- sortBy
111
- })) {
112
- const cacheKey = this.pageCache.buildCacheKey(orgId, page, pageSize);
113
- const cachedPage = this.pageCache.getCachedPage(cacheKey);
114
- if (cachedPage) {
115
- const duration = Date.now() - startTime;
116
- _loggerProxy.default.log(`Returning page ${page} from cache - cacheHit: true, duration: ${duration}ms, recordCount: ${cachedPage.data.length}, pageSize: ${pageSize}`, {
117
- module: 'EntryPoint',
118
- method: 'getEntryPoints'
119
- });
120
- return {
121
- data: cachedPage.data,
122
- meta: {
123
- page,
124
- pageSize,
125
- totalPages: cachedPage.totalMeta?.totalPages,
126
- totalRecords: cachedPage.totalMeta?.totalRecords
127
- }
128
- };
129
- }
130
- }
131
-
132
- // Start timing only for actual API calls (not cache hits)
133
120
  this.metricsManager.timeEvent(_constants3.METRIC_EVENT_NAMES.ENTRYPOINT_FETCH_SUCCESS);
134
121
  try {
135
- // Build query parameters
136
122
  const queryParams = new URLSearchParams({
137
123
  page: page.toString(),
138
124
  pageSize: pageSize.toString(),
139
- sortOrder
125
+ attributes: mergeEntryPointAttributes(attributes)
140
126
  });
141
127
  if (search) queryParams.append('search', search);
142
128
  if (filter) queryParams.append('filter', filter);
143
- if (attributes) queryParams.append('attributes', attributes);
144
- if (sortBy) queryParams.append('sortBy', sortBy);
145
- const resource = _constants2.endPointMap.entryPointList(orgId, queryParams.toString());
129
+ if (effectiveSortBy) {
130
+ queryParams.append('sort', `${effectiveSortBy},${sortOrder.toUpperCase()}`);
131
+ }
132
+ queryParams.append('desktopProfileFilter', 'true');
133
+ queryParams.append('includeEntryPointName', 'true');
134
+ const resource = _constants2.endPointMap.entryPointDialNumberList(orgId, queryParams.toString());
146
135
  _loggerProxy.default.log(`Making API request to fetch entry points - resource: ${resource}, service: ${_constants.WCC_API_GATEWAY}`, {
147
136
  module: 'EntryPoint',
148
137
  method: 'getEntryPoints'
@@ -150,11 +139,19 @@ class EntryPoint {
150
139
  const response = await this.webexRequest.request({
151
140
  service: _constants.WCC_API_GATEWAY,
152
141
  resource,
153
- method: _types.HTTP_METHODS.GET
142
+ method: _types.HTTP_METHODS.GET,
143
+ headers: {
144
+ 'X-ORGANIZATION-ID': orgId,
145
+ 'x-ignore-internal-data': 'false'
146
+ }
154
147
  });
148
+ const responseBody = {
149
+ ...response.body,
150
+ data: (response.body?.data ?? []).map(mapDialNumberEntryPoint)
151
+ };
155
152
  const duration = Date.now() - startTime;
156
- const recordCount = response.body?.data?.length || 0;
157
- const totalRecords = response.body?.meta?.totalRecords;
153
+ const recordCount = responseBody.data.length;
154
+ const totalRecords = responseBody.meta?.totalRecords;
158
155
  _loggerProxy.default.log(`Successfully retrieved ${recordCount} entry points`, {
159
156
  module: 'EntryPoint',
160
157
  method: 'getEntryPoints',
@@ -180,26 +177,7 @@ class EntryPoint {
180
177
  isFirstPage: page === 0
181
178
  }, ['behavioral']);
182
179
  }
183
-
184
- // Cache the page data for simple pagination (no search/filter/attributes/sort)
185
- if (this.pageCache.canUseCache({
186
- search,
187
- filter,
188
- attributes,
189
- sortBy
190
- }) && response.body?.data) {
191
- const cacheKey = this.pageCache.buildCacheKey(orgId, page, pageSize);
192
- this.pageCache.cachePage(cacheKey, response.body.data, response.body.meta);
193
- _loggerProxy.default.log('Cached entry points data for future requests', {
194
- module: 'EntryPoint',
195
- method: 'getEntryPoints',
196
- data: {
197
- cacheKey,
198
- recordCount
199
- }
200
- });
201
- }
202
- return response.body;
180
+ return responseBody;
203
181
  } catch (error) {
204
182
  const errorData = {
205
183
  orgId,
@@ -1 +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","EntryPoint","constructor","webex","webexRequest","WebexRequest","getInstance","pageCache","PageCache","metricsManager","MetricsManager","getEntryPoints","params","startTime","Date","now","page","PAGINATION_DEFAULTS","PAGE","pageSize","PAGE_SIZE","search","filter","attributes","sortBy","sortOrder","orgId","credentials","getOrgId","isSearchRequest","LoggerProxy","info","module","method","canUseCache","cacheKey","buildCacheKey","cachedPage","getCachedPage","duration","log","data","length","meta","totalPages","totalMeta","totalRecords","timeEvent","METRIC_EVENT_NAMES","ENTRYPOINT_FETCH_SUCCESS","queryParams","URLSearchParams","toString","append","resource","endPointMap","entryPointList","WCC_API_GATEWAY","response","request","service","HTTP_METHODS","GET","recordCount","body","statusCode","trackEvent","isFirstPage","cachePage","error","errorData","Error","message","String","ENTRYPOINT_FETCH_FAILED","exports","_default"],"sources":["EntryPoint.ts"],"sourcesContent":["import {HTTP_METHODS, WebexSDK} from '../types';\nimport type {EntryPointRecord, EntryPointListResponse, EntryPointSearchParams} 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 * EntryPoint class for managing Webex Contact Center entry points.\n * Provides functionality to fetch, search, and paginate through entry points.\n *\n * @class EntryPoint\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 EntryPoint API instance from ContactCenter\n * const entryPointAPI = cc.entryPoint;\n *\n * // Get all entry points with pagination\n * const response = await entryPointAPI.getEntryPoints({\n * page: 0,\n * pageSize: 50\n * });\n *\n * // Search for specific entry points\n * const searchResults = await entryPointAPI.searchEntryPoints({\n * search: 'support',\n * filter: 'type==\"voice\"'\n * });\n * ```\n */\nexport class EntryPoint {\n private webexRequest: WebexRequest;\n private webex: WebexSDK;\n private metricsManager: MetricsManager;\n\n // Page cache using the common utility\n private pageCache: PageCache<EntryPointRecord>;\n\n /**\n * Creates an instance of EntryPoint\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<EntryPointRecord>('EntryPoint');\n this.metricsManager = MetricsManager.getInstance({webex});\n }\n\n /**\n * Fetches entry points for the organization with pagination support\n * @param {EntryPointSearchParams} [params] - Search and pagination parameters\n * @returns {Promise<EntryPointListResponse>} Promise resolving to paginated entry points\n * @throws {Error} If the API call fails\n * @public\n * @example\n * ```typescript\n * // Get first page of entry points\n * const response = await entryPointAPI.getEntryPoints();\n *\n * // Get specific page with custom page size\n * const response = await entryPointAPI.getEntryPoints({\n * page: 2,\n * pageSize: 25\n * });\n * ```\n */\n public async getEntryPoints(\n params: EntryPointSearchParams = {}\n ): Promise<EntryPointListResponse> {\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 = 'asc',\n } = params;\n\n const orgId = this.webex.credentials.getOrgId();\n const isSearchRequest = !!(search || filter || attributes || sortBy);\n\n LoggerProxy.info(\n `Fetching entry points - orgId: ${orgId}, page: ${page}, pageSize: ${pageSize}, isSearchRequest: ${isSearchRequest}`,\n {\n module: 'EntryPoint',\n method: 'getEntryPoints',\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(\n `Returning page ${page} from cache - cacheHit: true, duration: ${duration}ms, recordCount: ${cachedPage.data.length}, pageSize: ${pageSize}`,\n {\n module: 'EntryPoint',\n method: 'getEntryPoints',\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 only for actual API calls (not cache hits)\n this.metricsManager.timeEvent(METRIC_EVENT_NAMES.ENTRYPOINT_FETCH_SUCCESS);\n\n try {\n // Build query parameters\n const queryParams = new URLSearchParams({\n page: page.toString(),\n pageSize: pageSize.toString(),\n sortOrder,\n });\n\n if (search) queryParams.append('search', search);\n if (filter) queryParams.append('filter', filter);\n if (attributes) queryParams.append('attributes', attributes);\n if (sortBy) queryParams.append('sortBy', sortBy);\n\n const resource = endPointMap.entryPointList(orgId, queryParams.toString());\n\n LoggerProxy.log(\n `Making API request to fetch entry points - resource: ${resource}, service: ${WCC_API_GATEWAY}`,\n {\n module: 'EntryPoint',\n method: 'getEntryPoints',\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} entry points`, {\n module: 'EntryPoint',\n method: 'getEntryPoints',\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.ENTRYPOINT_FETCH_SUCCESS,\n {\n orgId,\n statusCode: response.statusCode,\n recordCount,\n totalRecords,\n isSearchRequest,\n isFirstPage: page === 0,\n },\n ['behavioral']\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 entry points data for future requests', {\n module: 'EntryPoint',\n method: 'getEntryPoints',\n data: {cacheKey, recordCount},\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 entry points`, {\n module: 'EntryPoint',\n method: 'getEntryPoints',\n data: errorData,\n error,\n });\n\n // Track all failures for troubleshooting\n this.metricsManager.trackEvent(METRIC_EVENT_NAMES.ENTRYPOINT_FETCH_FAILED, errorData, [\n 'behavioral',\n ]);\n\n throw error;\n }\n }\n}\n\nexport default EntryPoint;\n"],"mappings":"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","ignoreList":[]}
1
+ {"version":3,"names":["_types","require","_loggerProxy","_interopRequireDefault","_WebexRequest","_PageCache","_MetricsManager","_constants","_constants2","_constants3","e","__esModule","default","DEFAULT_ENTRY_POINT_ATTRIBUTES","DEFAULT_ENTRY_POINT_SORT_FIELD","mergeEntryPointAttributes","attributes","mergedAttributes","Set","split","map","attribute","trim","filter","Boolean","forEach","add","Array","from","join","mapDialNumberEntryPoint","item","id","entryPointId","name","entryPointName","dialledNumber","number","EntryPoint","constructor","webex","webexRequest","WebexRequest","getInstance","metricsManager","MetricsManager","getEntryPoints","params","startTime","Date","now","page","PAGINATION_DEFAULTS","PAGE","pageSize","PAGE_SIZE","search","sortBy","sortOrder","orgId","credentials","getOrgId","hasCustomSort","isSearchRequest","effectiveSortBy","LoggerProxy","info","module","method","timeEvent","METRIC_EVENT_NAMES","ENTRYPOINT_FETCH_SUCCESS","queryParams","URLSearchParams","toString","append","toUpperCase","resource","endPointMap","entryPointDialNumberList","log","WCC_API_GATEWAY","response","request","service","HTTP_METHODS","GET","headers","responseBody","body","data","duration","recordCount","length","totalRecords","meta","statusCode","trackEvent","isFirstPage","error","errorData","Error","message","String","ENTRYPOINT_FETCH_FAILED","exports","_default"],"sources":["EntryPoint.ts"],"sourcesContent":["import {HTTP_METHODS, WebexSDK} from '../types';\nimport type {EntryPointRecord, EntryPointListResponse, EntryPointSearchParams} from '../types';\nimport LoggerProxy from '../logger-proxy';\nimport WebexRequest from './core/WebexRequest';\nimport {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\nconst DEFAULT_ENTRY_POINT_ATTRIBUTES = 'id,dialledNumber,entryPointId,entryPointName';\nconst DEFAULT_ENTRY_POINT_SORT_FIELD = 'entryPointName';\n\ntype DialNumberEntryPointRecord = {\n id: string;\n dialledNumber?: string;\n entryPointId: string;\n entryPointName: string;\n};\n\nconst mergeEntryPointAttributes = (attributes?: string): string => {\n const mergedAttributes = new Set(DEFAULT_ENTRY_POINT_ATTRIBUTES.split(','));\n\n attributes\n ?.split(',')\n .map((attribute) => attribute.trim())\n .filter(Boolean)\n .forEach((attribute) => mergedAttributes.add(attribute));\n\n return Array.from(mergedAttributes).join(',');\n};\n\nconst mapDialNumberEntryPoint = (item: DialNumberEntryPointRecord): EntryPointRecord => ({\n id: item.entryPointId,\n name: item.entryPointName,\n ...(item.dialledNumber ? {number: item.dialledNumber} : {}),\n});\n\n/**\n * EntryPoint class for managing Webex Contact Center entry points.\n * Provides functionality to fetch, search, and paginate through entry points.\n *\n * @class EntryPoint\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 EntryPoint API instance from ContactCenter\n * const entryPointAPI = cc.entryPoint;\n *\n * // Get all entry points with pagination\n * const response = await entryPointAPI.getEntryPoints({\n * page: 0,\n * pageSize: 50\n * });\n *\n * // Search for specific entry points\n * const searchResults = await entryPointAPI.getEntryPoints({\n * search: 'support',\n * filter: 'type==\"voice\"'\n * });\n * ```\n */\nexport class EntryPoint {\n private webexRequest: WebexRequest;\n private webex: WebexSDK;\n private metricsManager: MetricsManager;\n\n /**\n * Creates an instance of EntryPoint\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.metricsManager = MetricsManager.getInstance({webex});\n }\n\n /**\n * Fetches entry-point dial-number mappings for the organization with pagination support. By\n * default, returns the agent's desktop-profile-filtered mappings in backend entry-point-name order.\n * Search, filter, attribute, and sort parameters can customize the request while desktop-profile\n * scoping and required mapping fields remain SDK-owned.\n * @param {EntryPointSearchParams} [params] - Search, pagination, and compatible override parameters.\n * @returns {Promise<EntryPointListResponse>} Promise resolving to paginated entry points\n * @throws {Error} If the API call fails\n * @public\n * @example\n * ```typescript\n * // Get the first page using the default entry-point policy\n * const response = await entryPointAPI.getEntryPoints();\n *\n * // Get specific page with custom page size\n * const response = await entryPointAPI.getEntryPoints({\n * page: 2,\n * pageSize: 25\n * });\n * ```\n */\n public async getEntryPoints(\n params: EntryPointSearchParams = {}\n ): Promise<EntryPointListResponse> {\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 = 'name',\n sortOrder = 'asc',\n } = params;\n\n const orgId = this.webex.credentials.getOrgId();\n const hasCustomSort = sortBy !== 'name' || sortOrder !== 'asc';\n const isSearchRequest = !!(search || filter || attributes || hasCustomSort);\n const effectiveSortBy = sortBy === 'name' ? DEFAULT_ENTRY_POINT_SORT_FIELD : sortBy;\n\n LoggerProxy.info(\n `Fetching entry points - orgId: ${orgId}, page: ${page}, pageSize: ${pageSize}, isSearchRequest: ${isSearchRequest}`,\n {\n module: 'EntryPoint',\n method: 'getEntryPoints',\n }\n );\n\n this.metricsManager.timeEvent(METRIC_EVENT_NAMES.ENTRYPOINT_FETCH_SUCCESS);\n\n try {\n const queryParams = new URLSearchParams({\n page: page.toString(),\n pageSize: pageSize.toString(),\n attributes: mergeEntryPointAttributes(attributes),\n });\n\n if (search) queryParams.append('search', search);\n if (filter) queryParams.append('filter', filter);\n if (effectiveSortBy) {\n queryParams.append('sort', `${effectiveSortBy},${sortOrder.toUpperCase()}`);\n }\n queryParams.append('desktopProfileFilter', 'true');\n queryParams.append('includeEntryPointName', 'true');\n\n const resource = endPointMap.entryPointDialNumberList(orgId, queryParams.toString());\n\n LoggerProxy.log(\n `Making API request to fetch entry points - resource: ${resource}, service: ${WCC_API_GATEWAY}`,\n {\n module: 'EntryPoint',\n method: 'getEntryPoints',\n }\n );\n\n const response = await this.webexRequest.request({\n service: WCC_API_GATEWAY,\n resource,\n method: HTTP_METHODS.GET,\n headers: {\n 'X-ORGANIZATION-ID': orgId,\n 'x-ignore-internal-data': 'false',\n },\n });\n\n const responseBody: EntryPointListResponse = {\n ...response.body,\n data: (response.body?.data ?? []).map(mapDialNumberEntryPoint),\n };\n\n const duration = Date.now() - startTime;\n\n const recordCount = responseBody.data.length;\n const totalRecords = responseBody.meta?.totalRecords;\n\n LoggerProxy.log(`Successfully retrieved ${recordCount} entry points`, {\n module: 'EntryPoint',\n method: 'getEntryPoints',\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.ENTRYPOINT_FETCH_SUCCESS,\n {\n orgId,\n statusCode: response.statusCode,\n recordCount,\n totalRecords,\n isSearchRequest,\n isFirstPage: page === 0,\n },\n ['behavioral']\n );\n }\n\n return responseBody;\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 entry points`, {\n module: 'EntryPoint',\n method: 'getEntryPoints',\n data: errorData,\n error,\n });\n\n // Track all failures for troubleshooting\n this.metricsManager.trackEvent(METRIC_EVENT_NAMES.ENTRYPOINT_FETCH_FAILED, errorData, [\n 'behavioral',\n ]);\n\n throw error;\n }\n }\n}\n\nexport default EntryPoint;\n"],"mappings":"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","ignoreList":[]}
@@ -71,14 +71,16 @@ class Queue {
71
71
  }
72
72
 
73
73
  /**
74
- * Fetches contact service queues for the organization
75
- * @param {ContactServiceQueueSearchParams} [params] - Search and pagination parameters
74
+ * Fetches contact service queues for the organization. By default, returns active inbound
75
+ * telephony queues in backend name-ascending order using the agent's desktop profile views.
76
+ * Existing filter, sort, and desktop-profile parameters override those defaults.
77
+ * @param {ContactServiceQueueSearchParams} [params] - Search, pagination, and override parameters
76
78
  * @returns {Promise<ContactServiceQueuesResponse>} Promise resolving to contact service queues
77
79
  * @throws {Error} If the API call fails
78
80
  * @public
79
81
  * @example
80
82
  * ```typescript
81
- * // Get all queues with default pagination
83
+ * // Get queues using the default list policy and pagination
82
84
  * const response = await queueAPI.getQueues();
83
85
  *
84
86
  * // Get queues with specific pagination
@@ -100,16 +102,28 @@ class Queue {
100
102
  page = _PageCache.PAGINATION_DEFAULTS.PAGE,
101
103
  pageSize = _PageCache.PAGINATION_DEFAULTS.PAGE_SIZE,
102
104
  search,
103
- filter,
105
+ filter = 'queueType==INBOUND;channelType==TELEPHONY;active==true',
104
106
  attributes,
105
- sortBy,
106
- sortOrder,
107
- desktopProfileFilter,
107
+ sortBy = 'name',
108
+ sortOrder = 'asc',
109
+ desktopProfileFilter = true,
108
110
  provisioningView,
109
111
  singleObjectResponse
110
112
  } = params;
113
+ const agentView = desktopProfileFilter;
114
+ const firstLevelView = desktopProfileFilter;
111
115
  const orgId = this.webex.credentials.getOrgId();
112
- const isSearchRequest = !!(search || filter || attributes || sortBy);
116
+ const effectiveSortBy = sortBy ?? (sortOrder ? 'name' : undefined);
117
+ const isSearchRequest = !!(search || filter || attributes || effectiveSortBy);
118
+ const canUseCache = this.pageCache.canUseCache({
119
+ search,
120
+ filter,
121
+ attributes,
122
+ sortBy: effectiveSortBy,
123
+ desktopProfileFilter,
124
+ provisioningView,
125
+ singleObjectResponse
126
+ });
113
127
  _loggerProxy.default.info('Fetching contact service queues', {
114
128
  module: 'Queue',
115
129
  method: _constants4.METHODS.GET_QUEUES,
@@ -122,12 +136,7 @@ class Queue {
122
136
  });
123
137
 
124
138
  // Check if we can use cache for simple pagination (no search/filter/attributes/sort)
125
- if (this.pageCache.canUseCache({
126
- search,
127
- filter,
128
- attributes,
129
- sortBy
130
- })) {
139
+ if (canUseCache) {
131
140
  const cacheKey = this.pageCache.buildCacheKey(orgId, page, pageSize);
132
141
  const cachedPage = this.pageCache.getCachedPage(cacheKey);
133
142
  if (cachedPage) {
@@ -167,11 +176,12 @@ class Queue {
167
176
  if (filter) queryParams.append('filter', filter);
168
177
  if (attributes) queryParams.append('attributes', attributes);
169
178
  if (search) queryParams.append('search', search);
170
- if (sortBy) queryParams.append('sortBy', sortBy);
171
- if (sortOrder) queryParams.append('sortOrder', sortOrder);
179
+ if (effectiveSortBy) queryParams.append('sort', `${effectiveSortBy},${(sortOrder ?? 'asc').toUpperCase()}`);
172
180
  if (desktopProfileFilter !== undefined) queryParams.append('desktopProfileFilter', desktopProfileFilter.toString());
173
181
  if (provisioningView !== undefined) queryParams.append('provisioningView', provisioningView.toString());
174
182
  if (singleObjectResponse !== undefined) queryParams.append('singleObjectResponse', singleObjectResponse.toString());
183
+ if (agentView !== undefined) queryParams.append('agentView', agentView.toString());
184
+ if (firstLevelView !== undefined) queryParams.append('firstLevelView', firstLevelView.toString());
175
185
  const resource = _constants2.endPointMap.queueList(orgId, queryParams.toString());
176
186
  _loggerProxy.default.log('Making API request to fetch contact service queues', {
177
187
  module: 'Queue',
@@ -216,12 +226,7 @@ class Queue {
216
226
  }
217
227
 
218
228
  // Cache the page data for simple pagination (no search/filter/attributes/sort)
219
- if (this.pageCache.canUseCache({
220
- search,
221
- filter,
222
- attributes,
223
- sortBy
224
- }) && response.body?.data) {
229
+ if (canUseCache && response.body?.data) {
225
230
  const cacheKey = this.pageCache.buildCacheKey(orgId, page, pageSize);
226
231
  this.pageCache.cachePage(cacheKey, response.body.data, response.body.meta);
227
232
  _loggerProxy.default.log('Cached contact service queues for future requests', {