@webex/contact-center 3.12.0-webex-services-ready.4 → 3.13.0

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 (250) hide show
  1. package/.sdd/manifest.json +24 -13
  2. package/ai-docs/ARCHITECTURE.md +1 -1
  3. package/ai-docs/CONTRACTS.md +19 -3
  4. package/ai-docs/SECURITY.md +1 -1
  5. package/ai-docs/SERVICE_STATE.md +4 -0
  6. package/ai-docs/contact-center-spec.md +50 -6
  7. package/ai-docs/features/consult-transfer-list-policy/spec/feature-spec.md +362 -0
  8. package/ai-docs/features/contact-owner-change-refactor.md +78 -0
  9. package/dist/cc.js +757 -22
  10. package/dist/cc.js.map +1 -1
  11. package/dist/config.js +7 -0
  12. package/dist/config.js.map +1 -1
  13. package/dist/constants.js +23 -2
  14. package/dist/constants.js.map +1 -1
  15. package/dist/index.js +34 -12
  16. package/dist/index.js.map +1 -1
  17. package/dist/metrics/MetricsManager.js +16 -0
  18. package/dist/metrics/MetricsManager.js.map +1 -1
  19. package/dist/metrics/behavioral-events.js +110 -0
  20. package/dist/metrics/behavioral-events.js.map +1 -1
  21. package/dist/metrics/constants.js +33 -0
  22. package/dist/metrics/constants.js.map +1 -1
  23. package/dist/services/AddressBook.js +18 -15
  24. package/dist/services/AddressBook.js.map +1 -1
  25. package/dist/services/AnswerCallOnWebexService.js +202 -0
  26. package/dist/services/AnswerCallOnWebexService.js.map +1 -0
  27. package/dist/services/ApiAiAssistant.js +221 -11
  28. package/dist/services/ApiAiAssistant.js.map +1 -1
  29. package/dist/services/EntryPoint.js +46 -68
  30. package/dist/services/EntryPoint.js.map +1 -1
  31. package/dist/services/Queue.js +27 -22
  32. package/dist/services/Queue.js.map +1 -1
  33. package/dist/services/WebCallingService.js +10 -2
  34. package/dist/services/WebCallingService.js.map +1 -1
  35. package/dist/services/WebexCrossClientService.js +225 -0
  36. package/dist/services/WebexCrossClientService.js.map +1 -0
  37. package/dist/services/WxAppTelephonyMercurySync.js +111 -0
  38. package/dist/services/WxAppTelephonyMercurySync.js.map +1 -0
  39. package/dist/services/config/Util.js +46 -46
  40. package/dist/services/config/Util.js.map +1 -1
  41. package/dist/services/config/constants.js +34 -77
  42. package/dist/services/config/constants.js.map +1 -1
  43. package/dist/services/config/index.js +100 -226
  44. package/dist/services/config/index.js.map +1 -1
  45. package/dist/services/config/types.js +51 -18
  46. package/dist/services/config/types.js.map +1 -1
  47. package/dist/services/constants.js +11 -1
  48. package/dist/services/constants.js.map +1 -1
  49. package/dist/services/core/Err.js.map +1 -1
  50. package/dist/services/core/Utils.js +25 -1
  51. package/dist/services/core/Utils.js.map +1 -1
  52. package/dist/services/core/WebexRequest.js +6 -2
  53. package/dist/services/core/WebexRequest.js.map +1 -1
  54. package/dist/services/core/aqm-reqs.js +17 -11
  55. package/dist/services/core/aqm-reqs.js.map +1 -1
  56. package/dist/services/core/constants.js +9 -1
  57. package/dist/services/core/constants.js.map +1 -1
  58. package/dist/services/core/types.js.map +1 -1
  59. package/dist/services/core/websocket/WebSocketManager.js +17 -1
  60. package/dist/services/core/websocket/WebSocketManager.js.map +1 -1
  61. package/dist/services/task/Task.js +275 -8
  62. package/dist/services/task/Task.js.map +1 -1
  63. package/dist/services/task/TaskFactory.js +11 -6
  64. package/dist/services/task/TaskFactory.js.map +1 -1
  65. package/dist/services/task/TaskManager.js +590 -42
  66. package/dist/services/task/TaskManager.js.map +1 -1
  67. package/dist/services/task/TaskUtils.js +11 -1
  68. package/dist/services/task/TaskUtils.js.map +1 -1
  69. package/dist/services/task/WebexCallingUtils.js +70 -0
  70. package/dist/services/task/WebexCallingUtils.js.map +1 -0
  71. package/dist/services/task/constants.js +14 -2
  72. package/dist/services/task/constants.js.map +1 -1
  73. package/dist/services/task/contact.js +29 -0
  74. package/dist/services/task/contact.js.map +1 -1
  75. package/dist/services/task/digital/Digital.js +4 -3
  76. package/dist/services/task/digital/Digital.js.map +1 -1
  77. package/dist/services/task/state-machine/TaskStateMachine.js +162 -53
  78. package/dist/services/task/state-machine/TaskStateMachine.js.map +1 -1
  79. package/dist/services/task/state-machine/actions.js +6 -1
  80. package/dist/services/task/state-machine/actions.js.map +1 -1
  81. package/dist/services/task/state-machine/guards.js +7 -10
  82. package/dist/services/task/state-machine/guards.js.map +1 -1
  83. package/dist/services/task/state-machine/types.js.map +1 -1
  84. package/dist/services/task/state-machine/uiControlsComputer.js +118 -18
  85. package/dist/services/task/state-machine/uiControlsComputer.js.map +1 -1
  86. package/dist/services/task/types.js +47 -1
  87. package/dist/services/task/types.js.map +1 -1
  88. package/dist/services/task/voice/Voice.js +477 -17
  89. package/dist/services/task/voice/Voice.js.map +1 -1
  90. package/dist/services/task/voice/WebRTC.js +6 -3
  91. package/dist/services/task/voice/WebRTC.js.map +1 -1
  92. package/dist/services/task/voice/wxAppOfferObservability.js +145 -0
  93. package/dist/services/task/voice/wxAppOfferObservability.js.map +1 -0
  94. package/dist/services/task/voice/wxAppVoiceMethods.js +395 -0
  95. package/dist/services/task/voice/wxAppVoiceMethods.js.map +1 -0
  96. package/dist/services/wxAppDiagnosticLogging.js +159 -0
  97. package/dist/services/wxAppDiagnosticLogging.js.map +1 -0
  98. package/dist/services/wxAppTelephonyUtils.js +19 -0
  99. package/dist/services/wxAppTelephonyUtils.js.map +1 -0
  100. package/dist/types/cc.d.ts +102 -8
  101. package/dist/types/config.d.ts +7 -0
  102. package/dist/types/constants.d.ts +21 -0
  103. package/dist/types/index.d.ts +34 -15
  104. package/dist/types/metrics/MetricsManager.d.ts +6 -0
  105. package/dist/types/metrics/constants.d.ts +31 -0
  106. package/dist/types/services/AddressBook.d.ts +2 -1
  107. package/dist/types/services/AnswerCallOnWebexService.d.ts +38 -0
  108. package/dist/types/services/ApiAiAssistant.d.ts +48 -4
  109. package/dist/types/services/EntryPoint.d.ts +7 -5
  110. package/dist/types/services/Queue.d.ts +5 -3
  111. package/dist/types/services/WebexCrossClientService.d.ts +32 -0
  112. package/dist/types/services/WxAppTelephonyMercurySync.d.ts +28 -0
  113. package/dist/types/services/config/Util.d.ts +4 -8
  114. package/dist/types/services/config/constants.d.ts +28 -76
  115. package/dist/types/services/config/index.d.ts +16 -64
  116. package/dist/types/services/config/types.d.ts +146 -173
  117. package/dist/types/services/constants.d.ts +9 -0
  118. package/dist/types/services/core/Err.d.ts +2 -0
  119. package/dist/types/services/core/Utils.d.ts +10 -0
  120. package/dist/types/services/core/WebexRequest.d.ts +1 -0
  121. package/dist/types/services/core/constants.d.ts +7 -0
  122. package/dist/types/services/core/types.d.ts +2 -0
  123. package/dist/types/services/task/Task.d.ts +34 -5
  124. package/dist/types/services/task/TaskFactory.d.ts +4 -2
  125. package/dist/types/services/task/TaskUtils.d.ts +6 -0
  126. package/dist/types/services/task/WebexCallingUtils.d.ts +11 -0
  127. package/dist/types/services/task/constants.d.ts +12 -0
  128. package/dist/types/services/task/contact.d.ts +4 -0
  129. package/dist/types/services/task/digital/Digital.d.ts +4 -3
  130. package/dist/types/services/task/state-machine/TaskStateMachine.d.ts +304 -56
  131. package/dist/types/services/task/state-machine/guards.d.ts +6 -5
  132. package/dist/types/services/task/state-machine/types.d.ts +9 -1
  133. package/dist/types/services/task/types.d.ts +192 -5
  134. package/dist/types/services/task/voice/Voice.d.ts +68 -11
  135. package/dist/types/services/task/voice/WebRTC.d.ts +5 -4
  136. package/dist/types/services/task/voice/wxAppOfferObservability.d.ts +39 -0
  137. package/dist/types/services/task/voice/wxAppVoiceMethods.d.ts +68 -0
  138. package/dist/types/services/wxAppDiagnosticLogging.d.ts +63 -0
  139. package/dist/types/services/wxAppTelephonyUtils.d.ts +5 -0
  140. package/dist/types/types.d.ts +80 -13
  141. package/dist/types/utils/PageCache.d.ts +20 -3
  142. package/dist/types.js +54 -8
  143. package/dist/types.js.map +1 -1
  144. package/dist/utils/PageCache.js +19 -5
  145. package/dist/utils/PageCache.js.map +1 -1
  146. package/dist/webex.js +9 -1
  147. package/dist/webex.js.map +1 -1
  148. package/package.json +10 -9
  149. package/src/cc.ts +969 -38
  150. package/src/config.ts +7 -0
  151. package/src/constants.ts +24 -0
  152. package/src/index.ts +39 -10
  153. package/src/metrics/MetricsManager.ts +16 -0
  154. package/src/metrics/ai-docs/metrics-spec.md +138 -21
  155. package/src/metrics/behavioral-events.ts +112 -0
  156. package/src/metrics/constants.ts +36 -0
  157. package/src/services/AddressBook.ts +17 -6
  158. package/src/services/AnswerCallOnWebexService.ts +239 -0
  159. package/src/services/ApiAiAssistant.ts +297 -13
  160. package/src/services/EntryPoint.ts +59 -60
  161. package/src/services/Queue.ts +29 -12
  162. package/src/services/WebCallingService.ts +16 -2
  163. package/src/services/WebexCrossClientService.ts +298 -0
  164. package/src/services/WxAppTelephonyMercurySync.ts +142 -0
  165. package/src/services/agent/ai-docs/AGENTS.md +1 -1
  166. package/src/services/agent/ai-docs/agent-spec.md +1 -0
  167. package/src/services/ai-docs/AGENTS.md +10 -10
  168. package/src/services/ai-docs/services-spec.md +25 -5
  169. package/src/services/config/Util.ts +52 -82
  170. package/src/services/config/ai-docs/AGENTS.md +35 -40
  171. package/src/services/config/ai-docs/ARCHITECTURE.md +90 -103
  172. package/src/services/config/ai-docs/config-spec.md +132 -132
  173. package/src/services/config/constants.ts +39 -85
  174. package/src/services/config/index.ts +116 -277
  175. package/src/services/config/types.ts +140 -195
  176. package/src/services/constants.ts +10 -0
  177. package/src/services/core/Err.ts +1 -0
  178. package/src/services/core/Utils.ts +28 -0
  179. package/src/services/core/WebexRequest.ts +3 -1
  180. package/src/services/core/ai-docs/core-spec.md +25 -11
  181. package/src/services/core/aqm-reqs.ts +18 -12
  182. package/src/services/core/constants.ts +8 -0
  183. package/src/services/core/types.ts +33 -1
  184. package/src/services/core/websocket/WebSocketManager.ts +26 -2
  185. package/src/services/task/Task.ts +386 -12
  186. package/src/services/task/TaskFactory.ts +33 -6
  187. package/src/services/task/TaskManager.ts +857 -41
  188. package/src/services/task/TaskUtils.ts +13 -0
  189. package/src/services/task/WebexCallingUtils.ts +136 -0
  190. package/src/services/task/ai-docs/ARCHITECTURE.md +1 -0
  191. package/src/services/task/ai-docs/task-spec.md +190 -8
  192. package/src/services/task/constants.ts +13 -0
  193. package/src/services/task/contact.ts +30 -0
  194. package/src/services/task/digital/Digital.ts +11 -4
  195. package/src/services/task/state-machine/TaskStateMachine.ts +235 -81
  196. package/src/services/task/state-machine/actions.ts +5 -2
  197. package/src/services/task/state-machine/ai-docs/AGENTS.md +6 -4
  198. package/src/services/task/state-machine/ai-docs/ARCHITECTURE.md +35 -16
  199. package/src/services/task/state-machine/ai-docs/task-state-machine-spec.md +103 -33
  200. package/src/services/task/state-machine/guards.ts +7 -10
  201. package/src/services/task/state-machine/types.ts +16 -1
  202. package/src/services/task/state-machine/uiControlsComputer.ts +206 -32
  203. package/src/services/task/types.ts +269 -4
  204. package/src/services/task/voice/Voice.ts +625 -17
  205. package/src/services/task/voice/WebRTC.ts +11 -4
  206. package/src/services/task/voice/wxAppOfferObservability.ts +204 -0
  207. package/src/services/task/voice/wxAppVoiceMethods.ts +575 -0
  208. package/src/services/wxAppDiagnosticLogging.ts +286 -0
  209. package/src/services/wxAppTelephonyUtils.ts +14 -0
  210. package/src/types.ts +108 -13
  211. package/src/utils/AGENTS.md +21 -10
  212. package/src/utils/PageCache.ts +38 -5
  213. package/src/utils/ai-docs/utils-spec.md +21 -11
  214. package/src/webex.js +8 -0
  215. package/test/unit/fixtures/aiSummaryTestUtils.ts +40 -0
  216. package/test/unit/spec/cc.ts +3408 -152
  217. package/test/unit/spec/index.ts +885 -0
  218. package/test/unit/spec/metrics/MetricsManager.ts +25 -0
  219. package/test/unit/spec/metrics/behavioral-events.ts +60 -0
  220. package/test/unit/spec/services/AddressBook.ts +37 -6
  221. package/test/unit/spec/services/AnswerCallOnWebexService.ts +264 -0
  222. package/test/unit/spec/services/ApiAiAssistant.ts +269 -8
  223. package/test/unit/spec/services/EntryPoint.ts +87 -40
  224. package/test/unit/spec/services/Queue.ts +123 -12
  225. package/test/unit/spec/services/WebCallingService.ts +38 -0
  226. package/test/unit/spec/services/WebexCrossClientService.ts +509 -0
  227. package/test/unit/spec/services/WxAppTelephonyMercurySync.ts +136 -0
  228. package/test/unit/spec/services/config/Util.ts +501 -0
  229. package/test/unit/spec/services/config/index.ts +313 -543
  230. package/test/unit/spec/services/core/Utils.ts +22 -0
  231. package/test/unit/spec/services/core/WebexRequest.ts +8 -7
  232. package/test/unit/spec/services/core/aqm-reqs.ts +142 -1
  233. package/test/unit/spec/services/core/websocket/WebSocketManager.ts +64 -14
  234. package/test/unit/spec/services/task/Task.ts +2257 -11
  235. package/test/unit/spec/services/task/TaskFactory.ts +56 -2
  236. package/test/unit/spec/services/task/TaskManager.ts +5559 -1493
  237. package/test/unit/spec/services/task/TaskUtils.ts +72 -0
  238. package/test/unit/spec/services/task/WebexCallingUtils.ts +153 -0
  239. package/test/unit/spec/services/task/contact.ts +33 -0
  240. package/test/unit/spec/services/task/state-machine/TaskStateMachine.ts +1501 -92
  241. package/test/unit/spec/services/task/state-machine/guards.ts +210 -8
  242. package/test/unit/spec/services/task/state-machine/uiControlsComputer.ts +445 -7
  243. package/test/unit/spec/services/task/voice/Voice.ts +1710 -4
  244. package/test/unit/spec/services/task/voice/wxAppOfferObservability.ts +361 -0
  245. package/test/unit/spec/services/task/voice/wxAppVoiceMethods.ts +719 -0
  246. package/test/unit/spec/services/wxAppDiagnosticLogging.ts +179 -0
  247. package/test/unit/spec/wellnessSampleUtils.ts +288 -0
  248. package/typedoc.md +1 -1
  249. package/umd/contact-center.min.js +2 -2
  250. package/umd/contact-center.min.js.map +1 -1
@@ -14,9 +14,14 @@ import {
14
14
  isSecondaryEpDnAgent,
15
15
  getConsultMediaResourceId,
16
16
  getIsConsultInProgressForConferenceControls,
17
+ getIsConsultedAgentForControls,
18
+ getServerHoldStateForControls,
19
+ isCampaignPreviewTask,
20
+ isCampaignPreviewReservation,
17
21
  } from '../../../../../src/services/task/TaskUtils';
18
22
  import {ITask, Interaction, TaskData} from '../../../../../src/services/task/types';
19
23
  import {LoginOption} from '../../../../../src/types';
24
+ import {CC_EVENTS} from '../../../../../src/services/config/types';
20
25
 
21
26
  describe('TaskUtils', () => {
22
27
  let mockTask: ITask;
@@ -47,6 +52,73 @@ describe('TaskUtils', () => {
47
52
  } as any;
48
53
  });
49
54
 
55
+ describe('state-control helper branches', () => {
56
+ it('should derive consulted-agent and hold states from task context', () => {
57
+ expect(
58
+ getIsConsultedAgentForControls({isConsulted: true} as TaskData, {} as any, false)
59
+ ).toBe(true);
60
+ expect(
61
+ getIsConsultedAgentForControls(
62
+ {} as TaskData,
63
+ {consultInitiator: false} as any,
64
+ true
65
+ )
66
+ ).toBe(true);
67
+ expect(
68
+ getIsConsultedAgentForControls(
69
+ {} as TaskData,
70
+ {consultInitiator: true} as any,
71
+ true
72
+ )
73
+ ).toBe(false);
74
+
75
+ const taskData = {
76
+ interaction: {
77
+ media: {
78
+ main: {isHold: true},
79
+ fallback: {isHold: false},
80
+ },
81
+ },
82
+ mediaResourceId: 'fallback',
83
+ } as TaskData;
84
+
85
+ expect(getServerHoldStateForControls({taskData} as any, 'main')).toBe(true);
86
+ expect(getServerHoldStateForControls({taskData} as any)).toBe(false);
87
+ expect(getServerHoldStateForControls({} as any)).toBeUndefined();
88
+ });
89
+
90
+ it('should detect campaign preview tasks and reservations', () => {
91
+ expect(
92
+ isCampaignPreviewTask({
93
+ interaction: {
94
+ outboundType: 'STANDARD_PREVIEW_CAMPAIGN',
95
+ callProcessingDetails: {},
96
+ },
97
+ } as TaskData)
98
+ ).toBe(true);
99
+ expect(
100
+ isCampaignPreviewTask({
101
+ interaction: {
102
+ outboundType: 'OUTDIAL',
103
+ callProcessingDetails: {campaignType: 'preview_standard'},
104
+ },
105
+ } as unknown as TaskData)
106
+ ).toBe(true);
107
+ expect(isCampaignPreviewTask({interaction: {callProcessingDetails: {}}} as TaskData)).toBe(
108
+ false
109
+ );
110
+
111
+ expect(
112
+ isCampaignPreviewReservation({
113
+ data: {type: CC_EVENTS.AGENT_OFFER_CAMPAIGN_RESERVATION},
114
+ } as ITask)
115
+ ).toBe(true);
116
+ expect(isCampaignPreviewReservation({data: {type: CC_EVENTS.AGENT_CONTACT}} as ITask)).toBe(
117
+ false
118
+ );
119
+ });
120
+ });
121
+
50
122
  describe('isPrimary', () => {
51
123
  it('should return true when agent is the owner', () => {
52
124
  expect(isPrimary(mockTask, mockAgentId)).toBe(true);
@@ -0,0 +1,153 @@
1
+ import {expect} from '@jest/globals';
2
+ import {
3
+ getWebexCallingDeviceDetailsForAgent,
4
+ isWebexCallingCallForAgent,
5
+ isWxAppEngagedForControls,
6
+ decodedLineOwnerId,
7
+ } from '../../../../../src/services/task/WebexCallingUtils';
8
+ import {TaskState} from '../../../../../src/services/task/state-machine/constants';
9
+
10
+ const WX_APP_PARTICIPANT = {
11
+ id: 'agent-1',
12
+ deviceType: 'wxApp',
13
+ deviceId: 'device-id-1',
14
+ deviceCallId: 'call-id-1',
15
+ };
16
+
17
+ const participantsById = {
18
+ 'agent-1': WX_APP_PARTICIPANT,
19
+ 'customer-1': {id: 'customer-1', pType: 'Customer'},
20
+ };
21
+
22
+ describe('getWebexCallingDeviceDetailsForAgent', () => {
23
+ it('returns device details when agent participant has wxApp deviceType', () => {
24
+ const result = getWebexCallingDeviceDetailsForAgent('agent-1', participantsById);
25
+
26
+ expect(result).toEqual({
27
+ deviceType: 'wxApp',
28
+ deviceId: 'device-id-1',
29
+ deviceCallId: 'call-id-1',
30
+ });
31
+ });
32
+
33
+ it('returns undefined when agentId is undefined', () => {
34
+ expect(getWebexCallingDeviceDetailsForAgent(undefined, participantsById)).toBeUndefined();
35
+ });
36
+
37
+ it('returns undefined when agentId is empty string', () => {
38
+ expect(getWebexCallingDeviceDetailsForAgent('', participantsById)).toBeUndefined();
39
+ });
40
+
41
+ it('returns undefined when participants is null', () => {
42
+ expect(getWebexCallingDeviceDetailsForAgent('agent-1', null)).toBeUndefined();
43
+ });
44
+
45
+ it('returns undefined when participants is an array (not object-by-id)', () => {
46
+ expect(getWebexCallingDeviceDetailsForAgent('agent-1', [WX_APP_PARTICIPANT])).toBeUndefined();
47
+ });
48
+
49
+ it('returns undefined when agent participant lacks deviceCallId', () => {
50
+ const participants = {
51
+ 'agent-1': {id: 'agent-1', deviceType: 'wxApp', deviceId: 'device-id-1'},
52
+ };
53
+
54
+ expect(getWebexCallingDeviceDetailsForAgent('agent-1', participants)).toBeUndefined();
55
+ });
56
+
57
+ it('returns undefined when agent participant lacks deviceId', () => {
58
+ const participants = {
59
+ 'agent-1': {id: 'agent-1', deviceType: 'wxApp', deviceCallId: 'call-id-1'},
60
+ };
61
+
62
+ expect(getWebexCallingDeviceDetailsForAgent('agent-1', participants)).toBeUndefined();
63
+ });
64
+
65
+ it('finds participant by id field when keyed differently', () => {
66
+ const participants = {
67
+ 'some-other-key': WX_APP_PARTICIPANT,
68
+ };
69
+ const result = getWebexCallingDeviceDetailsForAgent('agent-1', participants);
70
+
71
+ expect(result?.deviceCallId).toBe('call-id-1');
72
+ });
73
+
74
+ it('defaults deviceType to empty string when missing', () => {
75
+ const participants = {
76
+ 'agent-1': {id: 'agent-1', deviceId: 'device-id-1', deviceCallId: 'call-id-1'},
77
+ };
78
+ const result = getWebexCallingDeviceDetailsForAgent('agent-1', participants);
79
+
80
+ expect(result?.deviceType).toBe('');
81
+ });
82
+ });
83
+
84
+ describe('isWebexCallingCallForAgent', () => {
85
+ it('returns true when device details are found', () => {
86
+ expect(isWebexCallingCallForAgent('agent-1', participantsById)).toBe(true);
87
+ });
88
+
89
+ it('returns false when no device details are found', () => {
90
+ expect(isWebexCallingCallForAgent('unknown-agent', participantsById)).toBe(false);
91
+ });
92
+
93
+ it('returns false when agentId is undefined', () => {
94
+ expect(isWebexCallingCallForAgent(undefined, participantsById)).toBe(false);
95
+ });
96
+ });
97
+
98
+ describe('isWxAppEngagedForControls', () => {
99
+ it('returns true when flag is on, wxApp participant exists, and state is CONNECTED', () => {
100
+ expect(
101
+ isWxAppEngagedForControls(true, 'agent-1', participantsById, TaskState.CONNECTED)
102
+ ).toBe(true);
103
+ });
104
+
105
+ it('returns false in OFFERED state', () => {
106
+ expect(isWxAppEngagedForControls(true, 'agent-1', participantsById, TaskState.OFFERED)).toBe(
107
+ false
108
+ );
109
+ });
110
+
111
+ it('returns false when enableWxBetterTogether is false', () => {
112
+ expect(
113
+ isWxAppEngagedForControls(false, 'agent-1', participantsById, TaskState.CONNECTED)
114
+ ).toBe(false);
115
+ });
116
+
117
+ it('returns false in TERMINATED state', () => {
118
+ expect(
119
+ isWxAppEngagedForControls(true, 'agent-1', participantsById, TaskState.TERMINATED)
120
+ ).toBe(false);
121
+ });
122
+
123
+ it('returns false in COMPLETED state', () => {
124
+ expect(
125
+ isWxAppEngagedForControls(true, 'agent-1', participantsById, TaskState.COMPLETED)
126
+ ).toBe(false);
127
+ });
128
+
129
+ it('returns false in WRAPPING_UP state', () => {
130
+ expect(
131
+ isWxAppEngagedForControls(true, 'agent-1', participantsById, TaskState.WRAPPING_UP)
132
+ ).toBe(false);
133
+ });
134
+ });
135
+
136
+ describe('decodedLineOwnerId', () => {
137
+ it('returns undefined when lineOwnerId is not provided', () => {
138
+ expect(decodedLineOwnerId(undefined)).toBeUndefined();
139
+ expect(decodedLineOwnerId('')).toBeUndefined();
140
+ });
141
+
142
+ it('decodes base64 encoded ID and returns last path segment', () => {
143
+ const orgId = 'ciscospark://us/ORGANIZATION/org-abc';
144
+ const encoded = btoa(orgId);
145
+ const result = decodedLineOwnerId(encoded);
146
+
147
+ expect(result).toBe('org-abc');
148
+ });
149
+
150
+ it('returns undefined when base64 decoding fails', () => {
151
+ expect(decodedLineOwnerId('not-valid-base64!!')).toBeUndefined();
152
+ });
153
+ });
@@ -215,6 +215,39 @@ describe("Routing contacts", () => {
215
215
  expect(req).toBeDefined();
216
216
  });
217
217
 
218
+ it('dropConferenceParticipant', () => {
219
+ fakeAqm.pendingRequests = {};
220
+ const req = contact.dropConferenceParticipant({
221
+ interactionId: 'test-interaction-drop-123',
222
+ participantId: '+1/participant 42',
223
+ }) as any;
224
+
225
+ expect(req).toEqual({
226
+ url: '/v1/tasks/test-interaction-drop-123/conference/participants/%2B1%2Fparticipant%2042/drop',
227
+ data: {},
228
+ host: 'wcc-api-gateway',
229
+ err: expect.any(Function),
230
+ redactSensitiveLogs: true,
231
+ notifSuccess: {
232
+ bind: {
233
+ type: 'RoutingMessage',
234
+ data: {
235
+ type: 'ParticipantLeftConference',
236
+ interactionId: 'test-interaction-drop-123',
237
+ },
238
+ },
239
+ msg: {},
240
+ },
241
+ notifFail: {
242
+ bind: {
243
+ type: 'RoutingMessage',
244
+ data: {type: 'ParticipantDropConferenceFailed'},
245
+ },
246
+ errId: 'Service.aqm.task.dropConferenceParticipant',
247
+ },
248
+ });
249
+ });
250
+
218
251
  it("exitConference", () => {
219
252
  fakeAqm.pendingRequests = {};
220
253
  const req = contact.exitConference({