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

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 +21 -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 +53 -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 +816 -26
  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 +29 -2
  14. package/dist/constants.js.map +1 -1
  15. package/dist/index.js +66 -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 +287 -37
  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 +55 -35
  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 +127 -9
  101. package/dist/types/config.d.ts +7 -0
  102. package/dist/types/constants.d.ts +23 -0
  103. package/dist/types/index.d.ts +38 -17
  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 +150 -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 +125 -13
  141. package/dist/types/utils/PageCache.d.ts +20 -3
  142. package/dist/types.js +90 -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 +1047 -48
  150. package/src/config.ts +7 -0
  151. package/src/constants.ts +36 -0
  152. package/src/index.ts +49 -11
  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 +362 -40
  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 +11 -11
  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 +145 -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 +159 -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 +3595 -120
  217. package/test/unit/spec/index.ts +891 -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 +483 -54
  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
@@ -0,0 +1,179 @@
1
+ import LoggerProxy from '../../../../src/logger-proxy';
2
+ import {
3
+ callIdSuffix,
4
+ deriveWxAppAcceptReason,
5
+ logWxAppOfferDecision,
6
+ logWxAppOfferParticipantMismatch,
7
+ logWxAppSessionReadiness,
8
+ logWxAppTelephonyAction,
9
+ WXAPP_LOG_PREFIX,
10
+ } from '../../../../src/services/wxAppDiagnosticLogging';
11
+
12
+ jest.mock('../../../../src/logger-proxy', () => ({
13
+ log: jest.fn(),
14
+ warn: jest.fn(),
15
+ error: jest.fn(),
16
+ }));
17
+
18
+ describe('wxAppDiagnosticLogging', () => {
19
+ beforeEach(() => {
20
+ jest.clearAllMocks();
21
+ });
22
+
23
+ describe('callIdSuffix', () => {
24
+ it('returns last 8 characters for long call ids', () => {
25
+ expect(callIdSuffix('prefix:abcdefghijklmnop')).toBe('ijklmnop');
26
+ });
27
+
28
+ it('returns full id when length is 8 or less', () => {
29
+ expect(callIdSuffix('abc')).toBe('abc');
30
+ });
31
+ });
32
+
33
+ describe('deriveWxAppAcceptReason', () => {
34
+ it('returns wxApp_offer_ready for wxApp inbound offer', () => {
35
+ expect(
36
+ deriveWxAppAcceptReason({
37
+ isWxAppInboundOffer: true,
38
+ isWxAppOutdialOffer: false,
39
+ isWebrtc: false,
40
+ isOutdial: false,
41
+ wxAppAcceptInFlight: false,
42
+ wxAppAnswerPending: false,
43
+ enableWxBetterTogether: true,
44
+ hasDeviceCallId: true,
45
+ })
46
+ ).toBe('wxApp_offer_ready');
47
+ });
48
+
49
+ it('returns extension_non_wxApp_offer when flag on but no device call id', () => {
50
+ expect(
51
+ deriveWxAppAcceptReason({
52
+ isWxAppInboundOffer: false,
53
+ isWxAppOutdialOffer: false,
54
+ isWebrtc: false,
55
+ isOutdial: false,
56
+ wxAppAcceptInFlight: false,
57
+ wxAppAnswerPending: false,
58
+ enableWxBetterTogether: true,
59
+ hasDeviceCallId: false,
60
+ })
61
+ ).toBe('extension_non_wxApp_offer');
62
+ });
63
+
64
+ it('returns wxApp_answer_pending when answer is pending', () => {
65
+ expect(
66
+ deriveWxAppAcceptReason({
67
+ isWxAppInboundOffer: true,
68
+ isWxAppOutdialOffer: false,
69
+ isWebrtc: false,
70
+ isOutdial: false,
71
+ wxAppAcceptInFlight: false,
72
+ wxAppAnswerPending: true,
73
+ enableWxBetterTogether: true,
74
+ hasDeviceCallId: true,
75
+ })
76
+ ).toBe('wxApp_answer_pending');
77
+ });
78
+ });
79
+
80
+ describe('log helpers', () => {
81
+ it('logs session readiness at log level with grep-friendly suffix', () => {
82
+ logWxAppSessionReadiness({
83
+ enableWxBetterTogether: true,
84
+ loginOption: 'EXTENSION',
85
+ wxAppHooksApplied: true,
86
+ usersubPublished: true,
87
+ mercurySubscribed: true,
88
+ telephonyTaskType: 'Voice',
89
+ });
90
+
91
+ expect(LoggerProxy.log).toHaveBeenCalledWith(
92
+ expect.stringContaining(`${WXAPP_LOG_PREFIX} session readiness`),
93
+ expect.objectContaining({
94
+ module: 'wxAppDiagnosticLogging',
95
+ method: 'logWxAppSessionReadiness',
96
+ data: expect.objectContaining({
97
+ feature: 'wxApp',
98
+ event: 'session_readiness',
99
+ loginOption: 'EXTENSION',
100
+ usersubPublished: true,
101
+ mercurySubscribed: true,
102
+ }),
103
+ })
104
+ );
105
+ expect(LoggerProxy.log).toHaveBeenCalledWith(
106
+ expect.stringContaining('usersubPublished=true'),
107
+ expect.anything()
108
+ );
109
+ });
110
+
111
+ it('logs offer decision at log level with acceptReason suffix', () => {
112
+ logWxAppOfferDecision({
113
+ interactionId: 'task-1',
114
+ acceptVisible: true,
115
+ acceptEnabled: false,
116
+ acceptReason: 'extension_non_wxApp_offer',
117
+ hasDeviceCallId: false,
118
+ hasDeviceId: false,
119
+ usersubPublished: true,
120
+ });
121
+
122
+ expect(LoggerProxy.log).toHaveBeenCalledWith(
123
+ expect.stringContaining('acceptReason=extension_non_wxApp_offer'),
124
+ expect.objectContaining({
125
+ data: expect.objectContaining({
126
+ event: 'offer_decision',
127
+ acceptReason: 'extension_non_wxApp_offer',
128
+ interactionId: 'task-1',
129
+ usersubPublished: true,
130
+ }),
131
+ })
132
+ );
133
+ });
134
+
135
+ it('logs participant mismatch at warn level', () => {
136
+ logWxAppOfferParticipantMismatch({
137
+ interactionId: 'task-1',
138
+ usersubPublished: true,
139
+ hasDeviceCallId: false,
140
+ hasDeviceId: false,
141
+ participantDeviceType: 'wxApp',
142
+ acceptVisible: true,
143
+ acceptEnabled: false,
144
+ acceptReason: 'extension_non_wxApp_offer',
145
+ });
146
+
147
+ expect(LoggerProxy.warn).toHaveBeenCalledWith(
148
+ expect.stringContaining('participant fields mismatch'),
149
+ expect.objectContaining({
150
+ method: 'logWxAppOfferParticipantMismatch',
151
+ data: expect.objectContaining({
152
+ event: 'participant_fields_mismatch',
153
+ usersubPublished: true,
154
+ hasDeviceCallId: false,
155
+ }),
156
+ })
157
+ );
158
+ });
159
+
160
+ it('logs telephony failures at error level with trackingId', () => {
161
+ logWxAppTelephonyAction({
162
+ action: 'accept',
163
+ phase: 'failed',
164
+ interactionId: 'task-1',
165
+ trackingId: 'track-abc',
166
+ failureReason: 'REST error',
167
+ });
168
+
169
+ expect(LoggerProxy.error).toHaveBeenCalledWith(
170
+ expect.stringContaining('telephony accept failed'),
171
+ expect.objectContaining({
172
+ data: expect.objectContaining({
173
+ trackingId: 'track-abc',
174
+ }),
175
+ })
176
+ );
177
+ });
178
+ });
179
+ });
@@ -0,0 +1,288 @@
1
+ const {
2
+ areAllTasksSafe,
3
+ createRecoveryMarker,
4
+ getLegacyExternalTransitionDecision,
5
+ getRecoveryDecision,
6
+ getSelectableIdleCodes,
7
+ getWellnessTransition,
8
+ parseRecoveryMarker,
9
+ shouldResetForSessionEvent,
10
+ shouldResetSampleAfterDeregister,
11
+ } = require('../../../../../../docs/samples/contact-center/wellness-utils');
12
+ const {readFileSync} = require('fs');
13
+ const {resolve} = require('path');
14
+
15
+ describe('Contact Center wellness sample utilities', () => {
16
+ describe('safe task detection', () => {
17
+ it.each([
18
+ ['new', false, true],
19
+ ['reserved', false, true],
20
+ ['connected', false, true],
21
+ ['consulting', false, true],
22
+ ['conference', false, true],
23
+ ['wrapup', false, true],
24
+ ['campaignPreview', false, true],
25
+ ['terminated', false, false],
26
+ ['completed', false, false],
27
+ ['completed', true, true],
28
+ ])(
29
+ 'classifies task state %s with wrapUpRequired=%s',
30
+ (state, wrapUpRequired, expectedBlocking) => {
31
+ const taskList = {
32
+ task: {
33
+ data: {
34
+ wrapUpRequired,
35
+ interaction: {state},
36
+ },
37
+ },
38
+ };
39
+
40
+ expect(areAllTasksSafe(taskList)).toBe(!expectedBlocking);
41
+ }
42
+ );
43
+
44
+ it('requires every task to be terminal', () => {
45
+ expect(
46
+ areAllTasksSafe({
47
+ completed: {data: {interaction: {state: 'completed'}}},
48
+ active: {data: {interaction: {state: 'engaged'}}},
49
+ })
50
+ ).toBe(false);
51
+ });
52
+
53
+ it('treats an incomplete task shape as blocking until authoritative state arrives', () => {
54
+ expect(areAllTasksSafe({task: {}})).toBe(false);
55
+ });
56
+ });
57
+
58
+ describe('external state synchronization', () => {
59
+ it.each([
60
+ ['OnBreak', 'user-idle', 'complete'],
61
+ ['OnBreak', 'rona-code', 'ignore'],
62
+ ['WaitingForSafeState', 'rona-code', 'cancel'],
63
+ ['Ready', '0', 'ignore'],
64
+ ])(
65
+ 'returns %s / %s as %s',
66
+ (lifecycle, nextAuxCodeId, expected) => {
67
+ expect(
68
+ getLegacyExternalTransitionDecision({
69
+ lifecycle,
70
+ nextAuxCodeId,
71
+ wellnessAuxCodeId: 'wellness',
72
+ validIdleCodeIds: ['user-idle'],
73
+ })
74
+ ).toBe(expected);
75
+ }
76
+ );
77
+ });
78
+
79
+ describe('ordinary status selector', () => {
80
+ it('excludes WellbeingBreak and every other system code', () => {
81
+ expect(
82
+ getSelectableIdleCodes([
83
+ {id: '0', name: 'Available', isSystem: false},
84
+ {id: 'training', name: 'Training', isSystem: false},
85
+ {id: 'wellness', name: 'WellbeingBreak', isSystem: true},
86
+ {id: 'rona', name: 'RONA', isSystem: true},
87
+ ])
88
+ ).toEqual([
89
+ {id: '0', name: 'Available', isSystem: false},
90
+ {id: 'training', name: 'Training', isSystem: false},
91
+ ]);
92
+ });
93
+ });
94
+
95
+ describe('sample public surface guard', () => {
96
+ it('attaches the wellness constants consumed by the standalone browser sample', () => {
97
+ const webexSource = readFileSync(
98
+ resolve(__dirname, '../../../src/webex.js'),
99
+ 'utf8'
100
+ );
101
+ const appSource = readFileSync(
102
+ resolve(__dirname, '../../../../../../docs/samples/contact-center/app.js'),
103
+ 'utf8'
104
+ );
105
+
106
+ ['WELLNESS_BREAK_NOTIFICATION_ACTIONS', 'WELLNESS_BREAK_USER_ACTIONS'].forEach(
107
+ (surface) => {
108
+ expect(webexSource).toContain(`Webex.${surface} = ${surface};`);
109
+ expect(appSource).toContain(surface);
110
+ }
111
+ );
112
+ });
113
+
114
+ it('keeps the intake v0.4 US English wellness copy in the sample surfaces', () => {
115
+ const appSource = readFileSync(
116
+ resolve(__dirname, '../../../../../../docs/samples/contact-center/app.js'),
117
+ 'utf8'
118
+ );
119
+ const htmlSource = readFileSync(
120
+ resolve(__dirname, '../../../../../../docs/samples/contact-center/index.html'),
121
+ 'utf8'
122
+ );
123
+ const sampleSource = `${appSource}\n${htmlSource}`.replace(/\\'/g, "'");
124
+
125
+ [
126
+ 'Well-being break scheduled',
127
+ 'This break is pre-approved by your organization for your well-being. You deserve it.',
128
+ 'Take wellbeing break',
129
+ 'Take a break',
130
+ 'Later',
131
+ 'Great. Your well-being break will begin shortly.',
132
+ 'Great. Your well-being break starts right after this call.',
133
+ "It's great to see your dedication. But remember, taking breaks can boost your productivity and your health.",
134
+ "I'm sorry, you've reached your well-being break limit today. Continue with your tasks, but remember to take care of yourself.",
135
+ "Looks like you're busy. I didn't get a response, so I'll check back with you shortly.",
136
+ 'Relax',
137
+ 'Your 1 minute well-being break is starting in',
138
+ 'This moment is yours.',
139
+ "In a few moments, you'll return to your day.",
140
+ 'Transitioning back to work mode in',
141
+ 'Well-being break completed',
142
+ "I hope you're feeling recharged after that well-being break. See you in your next break!",
143
+ "We couldn't start your well-being break due to a system issue. Please continue with your tasks and we will see you in your next well-being break.",
144
+ 'We encountered an issue setting your status to Available.',
145
+ "We couldn't start your well-being break due to a system issue.",
146
+ ].forEach((copy) => expect(sampleSource).toContain(copy));
147
+ });
148
+
149
+ });
150
+
151
+ describe('lifecycle transitions', () => {
152
+ it('revokes manual request eligibility after a not-allowed decision', () => {
153
+ expect(
154
+ getWellnessTransition(
155
+ {lifecycle: 'RequestPending', hasOffer: false, isReady: true},
156
+ {type: 'NOT_ALLOWED'}
157
+ )
158
+ ).toEqual({
159
+ lifecycle: 'Ready',
160
+ canRequest: false,
161
+ clearOffer: true,
162
+ clearManualRequest: true,
163
+ });
164
+ });
165
+
166
+ it('keeps an offer retryable when response delivery fails', () => {
167
+ expect(
168
+ getWellnessTransition(
169
+ {lifecycle: 'OfferPending', hasOffer: true, isReady: true},
170
+ {type: 'OFFER_RESPONSE_STARTED'}
171
+ )
172
+ ).toEqual({lifecycle: 'OfferResponding', allowed: true});
173
+ expect(
174
+ getWellnessTransition(
175
+ {lifecycle: 'OfferResponding', hasOffer: true, isReady: true},
176
+ {type: 'OFFER_RESPONSE_FAILED'}
177
+ )
178
+ ).toEqual({lifecycle: 'OfferPending', rearmOffer: true});
179
+ });
180
+
181
+ it('clears an offer only after its response succeeds', () => {
182
+ expect(
183
+ getWellnessTransition(
184
+ {lifecycle: 'OfferResponding', hasOffer: true, isReady: true},
185
+ {type: 'OFFER_RESPONSE_SUCCEEDED'}
186
+ )
187
+ ).toEqual({lifecycle: 'Ready', clearOffer: true});
188
+ });
189
+
190
+ it.each([
191
+ [undefined, 'session-1', true],
192
+ ['session-1', 'session-1', true],
193
+ ['session-2', 'session-1', false],
194
+ ])(
195
+ 'scopes session cleanup for event session %s',
196
+ (eventSessionId, activeSessionId, expected) => {
197
+ expect(shouldResetForSessionEvent(eventSessionId, activeSessionId)).toBe(expected);
198
+ }
199
+ );
200
+
201
+ it.each([
202
+ [true, true, true],
203
+ [false, false, true],
204
+ [false, true, false],
205
+ ])(
206
+ 'decides deregistration cleanup for success=%s config=%s',
207
+ (succeeded, hasAgentConfig, expected) => {
208
+ expect(shouldResetSampleAfterDeregister({succeeded, hasAgentConfig})).toBe(expected);
209
+ }
210
+ );
211
+ });
212
+
213
+ describe('browser recovery marker', () => {
214
+ it('round-trips only legacy session ownership', () => {
215
+ const marker = createRecoveryMarker({
216
+ agentSessionId: 'session-1',
217
+ });
218
+
219
+ expect(parseRecoveryMarker(JSON.stringify(marker))).toEqual({
220
+ version: 1,
221
+ agentSessionId: 'session-1',
222
+ stateModel: 'legacy',
223
+ });
224
+ });
225
+
226
+ it.each([
227
+ {
228
+ name: 'discards another session',
229
+ input: {
230
+ marker: createRecoveryMarker({
231
+ agentSessionId: 'session-1',
232
+ }),
233
+ agentSessionId: 'session-2',
234
+ },
235
+ expected: 'discard',
236
+ },
237
+ {
238
+ name: 'waits for an authoritative legacy snapshot',
239
+ input: {
240
+ marker: createRecoveryMarker({
241
+ agentSessionId: 'session-1',
242
+ }),
243
+ agentSessionId: 'session-1',
244
+ legacyStateKnown: false,
245
+ },
246
+ expected: 'wait',
247
+ },
248
+ {
249
+ name: 'restores an owned legacy wellness state',
250
+ input: {
251
+ marker: createRecoveryMarker({
252
+ agentSessionId: 'session-1',
253
+ }),
254
+ agentSessionId: 'session-1',
255
+ legacyStateKnown: true,
256
+ legacyAuxCodeId: 'wellness',
257
+ wellnessAuxCodeId: 'wellness',
258
+ },
259
+ expected: 'restore',
260
+ },
261
+ {
262
+ name: 'clears a legacy marker when the session already left wellness',
263
+ input: {
264
+ marker: createRecoveryMarker({
265
+ agentSessionId: 'session-1',
266
+ }),
267
+ agentSessionId: 'session-1',
268
+ legacyStateKnown: true,
269
+ legacyAuxCodeId: '0',
270
+ wellnessAuxCodeId: 'wellness',
271
+ },
272
+ expected: 'clear',
273
+ },
274
+ ])('$name', ({input, expected}) => {
275
+ expect(getRecoveryDecision(input)).toBe(expected);
276
+ });
277
+
278
+ it('rejects malformed or unsupported recovery markers', () => {
279
+ expect(parseRecoveryMarker('{')).toBeUndefined();
280
+ expect(parseRecoveryMarker(JSON.stringify({version: 2}))).toBeUndefined();
281
+ expect(
282
+ parseRecoveryMarker(
283
+ JSON.stringify({version: 1, agentSessionId: 'session-1', stateModel: 'agent-state-control'})
284
+ )
285
+ ).toBeUndefined();
286
+ });
287
+ });
288
+ });
package/typedoc.md CHANGED
@@ -91,7 +91,7 @@ async function initializeAgent() {
91
91
 
92
92
  // 2. Login with browser-based calling
93
93
  await cc.stationLogin({
94
- teamId: profile.teams[0].teamId,
94
+ teamId: profile.teams[0].id,
95
95
  loginOption: 'BROWSER',
96
96
  });
97
97