@webex/plugin-meetings 2.59.3-next.1 → 2.59.4-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 (420) hide show
  1. package/.eslintrc.js +6 -6
  2. package/LICENSE +1 -1
  3. package/README.md +1204 -1204
  4. package/UPGRADING.md +287 -287
  5. package/babel.config.js +3 -3
  6. package/browsers.js +108 -108
  7. package/dist/common/browser-detection.js +2 -2
  8. package/dist/common/browser-detection.js.map +1 -1
  9. package/dist/common/collection.js +45 -45
  10. package/dist/common/collection.js.map +1 -1
  11. package/dist/common/config.js.map +1 -1
  12. package/dist/common/errors/captcha-error.js +7 -7
  13. package/dist/common/errors/captcha-error.js.map +1 -1
  14. package/dist/common/errors/intent-to-join.js +7 -7
  15. package/dist/common/errors/intent-to-join.js.map +1 -1
  16. package/dist/common/errors/join-meeting.js +8 -8
  17. package/dist/common/errors/join-meeting.js.map +1 -1
  18. package/dist/common/errors/media.js +7 -7
  19. package/dist/common/errors/media.js.map +1 -1
  20. package/dist/common/errors/parameter.js +7 -7
  21. package/dist/common/errors/parameter.js.map +1 -1
  22. package/dist/common/errors/password-error.js +7 -7
  23. package/dist/common/errors/password-error.js.map +1 -1
  24. package/dist/common/errors/permission.js +6 -6
  25. package/dist/common/errors/permission.js.map +1 -1
  26. package/dist/common/errors/reconnection-in-progress.js +6 -6
  27. package/dist/common/errors/reconnection-in-progress.js.map +1 -1
  28. package/dist/common/errors/reconnection.js +7 -7
  29. package/dist/common/errors/reconnection.js.map +1 -1
  30. package/dist/common/errors/stats.js +7 -7
  31. package/dist/common/errors/stats.js.map +1 -1
  32. package/dist/common/errors/webex-errors.js +42 -42
  33. package/dist/common/errors/webex-errors.js.map +1 -1
  34. package/dist/common/errors/webex-meetings-error.js +12 -12
  35. package/dist/common/errors/webex-meetings-error.js.map +1 -1
  36. package/dist/common/events/events-scope.js +10 -10
  37. package/dist/common/events/events-scope.js.map +1 -1
  38. package/dist/common/events/events.js +4 -4
  39. package/dist/common/events/events.js.map +1 -1
  40. package/dist/common/events/trigger-proxy.js.map +1 -1
  41. package/dist/common/events/util.js.map +1 -1
  42. package/dist/common/logs/logger-config.js.map +1 -1
  43. package/dist/common/logs/logger-proxy.js.map +1 -1
  44. package/dist/common/logs/request.js +18 -18
  45. package/dist/common/logs/request.js.map +1 -1
  46. package/dist/common/queue.js +18 -18
  47. package/dist/common/queue.js.map +1 -1
  48. package/dist/config.js.map +1 -1
  49. package/dist/constants.js +9 -9
  50. package/dist/constants.js.map +1 -1
  51. package/dist/controls-options-manager/constants.js.map +1 -1
  52. package/dist/controls-options-manager/enums.js.map +1 -1
  53. package/dist/controls-options-manager/index.js +83 -83
  54. package/dist/controls-options-manager/index.js.map +1 -1
  55. package/dist/controls-options-manager/util.js.map +1 -1
  56. package/dist/index.js.map +1 -1
  57. package/dist/locus-info/controlsUtils.js +27 -27
  58. package/dist/locus-info/controlsUtils.js.map +1 -1
  59. package/dist/locus-info/embeddedAppsUtils.js +14 -14
  60. package/dist/locus-info/embeddedAppsUtils.js.map +1 -1
  61. package/dist/locus-info/fullState.js.map +1 -1
  62. package/dist/locus-info/hostUtils.js +19 -19
  63. package/dist/locus-info/hostUtils.js.map +1 -1
  64. package/dist/locus-info/index.js +198 -198
  65. package/dist/locus-info/index.js.map +1 -1
  66. package/dist/locus-info/infoUtils.js.map +1 -1
  67. package/dist/locus-info/mediaSharesUtils.js +50 -50
  68. package/dist/locus-info/mediaSharesUtils.js.map +1 -1
  69. package/dist/locus-info/parser.js +138 -138
  70. package/dist/locus-info/parser.js.map +1 -1
  71. package/dist/locus-info/selfUtils.js +52 -52
  72. package/dist/locus-info/selfUtils.js.map +1 -1
  73. package/dist/media/index.js +145 -145
  74. package/dist/media/index.js.map +1 -1
  75. package/dist/media/properties.js +49 -49
  76. package/dist/media/properties.js.map +1 -1
  77. package/dist/media/util.js.map +1 -1
  78. package/dist/mediaQualityMetrics/config.js.map +1 -1
  79. package/dist/meeting/effectsState.js +24 -24
  80. package/dist/meeting/effectsState.js.map +1 -1
  81. package/dist/meeting/in-meeting-actions.js +11 -11
  82. package/dist/meeting/in-meeting-actions.js.map +1 -1
  83. package/dist/meeting/index.js +1505 -1508
  84. package/dist/meeting/index.js.map +1 -1
  85. package/dist/meeting/muteState.js +85 -85
  86. package/dist/meeting/muteState.js.map +1 -1
  87. package/dist/meeting/request.js +143 -143
  88. package/dist/meeting/request.js.map +1 -1
  89. package/dist/meeting/state.js +30 -30
  90. package/dist/meeting/state.js.map +1 -1
  91. package/dist/meeting/util.js +4 -4
  92. package/dist/meeting/util.js.map +1 -1
  93. package/dist/meeting-info/collection.js +13 -13
  94. package/dist/meeting-info/collection.js.map +1 -1
  95. package/dist/meeting-info/index.js +50 -50
  96. package/dist/meeting-info/index.js.map +1 -1
  97. package/dist/meeting-info/meeting-info-v2.js +52 -52
  98. package/dist/meeting-info/meeting-info-v2.js.map +1 -1
  99. package/dist/meeting-info/request.js +14 -14
  100. package/dist/meeting-info/request.js.map +1 -1
  101. package/dist/meeting-info/util.js +9 -9
  102. package/dist/meeting-info/util.js.map +1 -1
  103. package/dist/meeting-info/utilv2.js +20 -20
  104. package/dist/meeting-info/utilv2.js.map +1 -1
  105. package/dist/meetings/collection.js +16 -16
  106. package/dist/meetings/collection.js.map +1 -1
  107. package/dist/meetings/index.js +259 -259
  108. package/dist/meetings/index.js.map +1 -1
  109. package/dist/meetings/request.js +15 -15
  110. package/dist/meetings/request.js.map +1 -1
  111. package/dist/meetings/util.js +29 -29
  112. package/dist/meetings/util.js.map +1 -1
  113. package/dist/member/index.js +214 -214
  114. package/dist/member/index.js.map +1 -1
  115. package/dist/member/member.types.js.map +1 -1
  116. package/dist/member/util.js +60 -60
  117. package/dist/member/util.js.map +1 -1
  118. package/dist/members/collection.js +11 -11
  119. package/dist/members/collection.js.map +1 -1
  120. package/dist/members/index.js +277 -277
  121. package/dist/members/index.js.map +1 -1
  122. package/dist/members/request.js +27 -27
  123. package/dist/members/request.js.map +1 -1
  124. package/dist/members/util.js +21 -21
  125. package/dist/members/util.js.map +1 -1
  126. package/dist/metrics/config.js.map +1 -1
  127. package/dist/metrics/constants.js.map +1 -1
  128. package/dist/metrics/index.js +92 -92
  129. package/dist/metrics/index.js.map +1 -1
  130. package/dist/networkQualityMonitor/index.js +65 -65
  131. package/dist/networkQualityMonitor/index.js.map +1 -1
  132. package/dist/peer-connection-manager/index.js +87 -87
  133. package/dist/peer-connection-manager/index.js.map +1 -1
  134. package/dist/peer-connection-manager/util.js +9 -9
  135. package/dist/peer-connection-manager/util.js.map +1 -1
  136. package/dist/personal-meeting-room/index.js +67 -67
  137. package/dist/personal-meeting-room/index.js.map +1 -1
  138. package/dist/personal-meeting-room/request.js +7 -7
  139. package/dist/personal-meeting-room/request.js.map +1 -1
  140. package/dist/personal-meeting-room/util.js.map +1 -1
  141. package/dist/reachability/index.js +119 -112
  142. package/dist/reachability/index.js.map +1 -1
  143. package/dist/reachability/request.js +15 -15
  144. package/dist/reachability/request.js.map +1 -1
  145. package/dist/reactions/reactions.js.map +1 -1
  146. package/dist/reactions/reactions.type.js.map +1 -1
  147. package/dist/reconnection-manager/index.js +112 -112
  148. package/dist/reconnection-manager/index.js.map +1 -1
  149. package/dist/recording-controller/enums.js.map +1 -1
  150. package/dist/recording-controller/index.js +127 -127
  151. package/dist/recording-controller/index.js.map +1 -1
  152. package/dist/recording-controller/util.js.map +1 -1
  153. package/dist/roap/collection.js.map +1 -1
  154. package/dist/roap/handler.js +27 -27
  155. package/dist/roap/handler.js.map +1 -1
  156. package/dist/roap/index.js +111 -111
  157. package/dist/roap/index.js.map +1 -1
  158. package/dist/roap/request.js +17 -17
  159. package/dist/roap/request.js.map +1 -1
  160. package/dist/roap/state.js +14 -14
  161. package/dist/roap/state.js.map +1 -1
  162. package/dist/roap/turnDiscovery.js +46 -46
  163. package/dist/roap/turnDiscovery.js.map +1 -1
  164. package/dist/roap/util.js.map +1 -1
  165. package/dist/statsAnalyzer/global.js.map +1 -1
  166. package/dist/statsAnalyzer/index.js +130 -130
  167. package/dist/statsAnalyzer/index.js.map +1 -1
  168. package/dist/statsAnalyzer/mqaUtil.js +15 -15
  169. package/dist/statsAnalyzer/mqaUtil.js.map +1 -1
  170. package/dist/transcription/index.js +42 -42
  171. package/dist/transcription/index.js.map +1 -1
  172. package/internal-README.md +172 -172
  173. package/jest.config.js +3 -3
  174. package/package.json +15 -15
  175. package/process +1 -1
  176. package/src/common/browser-detection.ts +39 -39
  177. package/src/common/collection.ts +94 -94
  178. package/src/common/config.ts +9 -9
  179. package/src/common/errors/captcha-error.ts +25 -25
  180. package/src/common/errors/intent-to-join.ts +27 -27
  181. package/src/common/errors/join-meeting.ts +32 -32
  182. package/src/common/errors/media.ts +25 -25
  183. package/src/common/errors/parameter.ts +33 -33
  184. package/src/common/errors/password-error.ts +25 -25
  185. package/src/common/errors/permission.ts +24 -24
  186. package/src/common/errors/reconnection-in-progress.ts +8 -8
  187. package/src/common/errors/reconnection.ts +25 -25
  188. package/src/common/errors/stats.ts +25 -25
  189. package/src/common/errors/webex-errors.ts +140 -140
  190. package/src/common/errors/webex-meetings-error.ts +35 -35
  191. package/src/common/events/events-scope.ts +30 -30
  192. package/src/common/events/events.ts +25 -25
  193. package/src/common/events/trigger-proxy.ts +25 -25
  194. package/src/common/events/util.ts +39 -39
  195. package/src/common/logs/logger-config.ts +8 -8
  196. package/src/common/logs/logger-proxy.ts +44 -44
  197. package/src/common/logs/request.ts +65 -65
  198. package/src/common/queue.ts +50 -50
  199. package/src/config.ts +96 -96
  200. package/src/constants.ts +1121 -1121
  201. package/src/controls-options-manager/constants.ts +5 -5
  202. package/src/controls-options-manager/enums.ts +6 -6
  203. package/src/controls-options-manager/index.ts +183 -183
  204. package/src/controls-options-manager/util.ts +20 -20
  205. package/src/index.js +15 -15
  206. package/src/locus-info/controlsUtils.ts +112 -112
  207. package/src/locus-info/embeddedAppsUtils.ts +57 -57
  208. package/src/locus-info/fullState.ts +69 -69
  209. package/src/locus-info/hostUtils.ts +60 -60
  210. package/src/locus-info/index.ts +1303 -1303
  211. package/src/locus-info/infoUtils.ts +101 -101
  212. package/src/locus-info/mediaSharesUtils.ts +173 -173
  213. package/src/locus-info/parser.ts +680 -680
  214. package/src/locus-info/selfUtils.ts +428 -428
  215. package/src/media/index.ts +675 -675
  216. package/src/media/properties.ts +313 -313
  217. package/src/media/util.ts +37 -37
  218. package/src/mediaQualityMetrics/config.ts +382 -382
  219. package/src/meeting/effectsState.ts +209 -209
  220. package/src/meeting/in-meeting-actions.ts +153 -153
  221. package/src/meeting/index.ts +6537 -6537
  222. package/src/meeting/muteState.ts +365 -365
  223. package/src/meeting/request.ts +810 -810
  224. package/src/meeting/state.ts +194 -194
  225. package/src/meeting/util.ts +530 -530
  226. package/src/meeting-info/collection.ts +41 -41
  227. package/src/meeting-info/index.ts +137 -137
  228. package/src/meeting-info/meeting-info-v2.ts +273 -273
  229. package/src/meeting-info/request.ts +46 -46
  230. package/src/meeting-info/util.ts +314 -314
  231. package/src/meeting-info/utilv2.ts +324 -324
  232. package/src/meetings/collection.ts +43 -43
  233. package/src/meetings/index.ts +1128 -1128
  234. package/src/meetings/request.ts +81 -81
  235. package/src/meetings/util.ts +181 -181
  236. package/src/member/index.ts +446 -446
  237. package/src/member/member.types.ts +13 -13
  238. package/src/member/util.ts +286 -286
  239. package/src/members/collection.ts +40 -40
  240. package/src/members/index.ts +900 -900
  241. package/src/members/request.ts +175 -175
  242. package/src/members/util.ts +260 -260
  243. package/src/metrics/config.ts +485 -485
  244. package/src/metrics/constants.ts +61 -61
  245. package/src/metrics/index.ts +543 -543
  246. package/src/networkQualityMonitor/index.ts +211 -211
  247. package/src/peer-connection-manager/index.ts +847 -847
  248. package/src/peer-connection-manager/util.ts +119 -119
  249. package/src/personal-meeting-room/index.ts +157 -157
  250. package/src/personal-meeting-room/request.ts +48 -48
  251. package/src/personal-meeting-room/util.ts +49 -49
  252. package/src/reachability/index.ts +478 -478
  253. package/src/reachability/request.ts +81 -81
  254. package/src/reactions/reactions.ts +104 -104
  255. package/src/reactions/reactions.type.ts +36 -36
  256. package/src/reconnection-manager/index.ts +622 -622
  257. package/src/recording-controller/enums.ts +8 -8
  258. package/src/recording-controller/index.ts +315 -315
  259. package/src/recording-controller/util.ts +58 -58
  260. package/src/roap/collection.ts +62 -62
  261. package/src/roap/handler.ts +294 -294
  262. package/src/roap/index.ts +413 -413
  263. package/src/roap/request.ts +229 -229
  264. package/src/roap/state.ts +156 -156
  265. package/src/roap/turnDiscovery.ts +283 -283
  266. package/src/roap/util.ts +100 -100
  267. package/src/statsAnalyzer/global.ts +128 -128
  268. package/src/statsAnalyzer/index.ts +1266 -1266
  269. package/src/statsAnalyzer/mqaUtil.ts +290 -290
  270. package/src/transcription/index.ts +154 -154
  271. package/test/integration/spec/journey.js +941 -941
  272. package/test/integration/spec/space-meeting.js +457 -457
  273. package/test/integration/spec/transcription.js +55 -55
  274. package/test/unit/spec/common/browser-detection.js +119 -119
  275. package/test/unit/spec/common/queue.js +69 -69
  276. package/test/unit/spec/controls-options-manager/index.js +123 -123
  277. package/test/unit/spec/controls-options-manager/util.js +65 -65
  278. package/test/unit/spec/fixture/locus.js +406 -406
  279. package/test/unit/spec/locus-info/controlsUtils.js +82 -82
  280. package/test/unit/spec/locus-info/embeddedAppsUtils.js +104 -104
  281. package/test/unit/spec/locus-info/index.js +1272 -1272
  282. package/test/unit/spec/locus-info/infoUtils.js +138 -138
  283. package/test/unit/spec/locus-info/lib/BasicSeqCmp.json +975 -975
  284. package/test/unit/spec/locus-info/lib/SeqCmp.json +522 -522
  285. package/test/unit/spec/locus-info/lib/selfConstant.js +286 -286
  286. package/test/unit/spec/locus-info/parser.js +298 -298
  287. package/test/unit/spec/locus-info/selfUtils.js +185 -185
  288. package/test/unit/spec/media/properties.ts +305 -305
  289. package/test/unit/spec/meeting/effectsState.js +281 -281
  290. package/test/unit/spec/meeting/in-meeting-actions.ts +90 -90
  291. package/test/unit/spec/meeting/index.js +5227 -5227
  292. package/test/unit/spec/meeting/muteState.js +430 -430
  293. package/test/unit/spec/meeting/request.js +317 -317
  294. package/test/unit/spec/meeting/utils.js +319 -319
  295. package/test/unit/spec/meeting-info/meetinginfov2.js +376 -376
  296. package/test/unit/spec/meeting-info/request.js +64 -64
  297. package/test/unit/spec/meeting-info/util.js +37 -37
  298. package/test/unit/spec/meeting-info/utilv2.js +330 -330
  299. package/test/unit/spec/meetings/collection.js +52 -52
  300. package/test/unit/spec/meetings/index.js +1375 -1375
  301. package/test/unit/spec/meetings/utils.js +66 -66
  302. package/test/unit/spec/member/index.js +47 -47
  303. package/test/unit/spec/member/util.js +80 -80
  304. package/test/unit/spec/members/index.js +364 -364
  305. package/test/unit/spec/members/request.js +200 -200
  306. package/test/unit/spec/members/utils.js +42 -42
  307. package/test/unit/spec/metrics/index.js +111 -111
  308. package/test/unit/spec/networkQualityMonitor/index.js +99 -99
  309. package/test/unit/spec/peerconnection-manager/index.js +218 -218
  310. package/test/unit/spec/peerconnection-manager/utils.js +49 -49
  311. package/test/unit/spec/peerconnection-manager/utils.test-fixtures.ts +388 -388
  312. package/test/unit/spec/personal-meeting-room/personal-meeting-room.js +29 -29
  313. package/test/unit/spec/reachability/index.ts +50 -50
  314. package/test/unit/spec/reconnection-manager/index.js +206 -206
  315. package/test/unit/spec/recording-controller/index.js +230 -230
  316. package/test/unit/spec/recording-controller/util.js +101 -101
  317. package/test/unit/spec/roap/index.ts +128 -128
  318. package/test/unit/spec/roap/turnDiscovery.ts +372 -372
  319. package/test/unit/spec/roap/util.js +30 -30
  320. package/test/unit/spec/stats-analyzer/index.js +287 -287
  321. package/test/utils/cmr.js +104 -104
  322. package/test/utils/testUtils.js +287 -287
  323. package/test/utils/webex-config.js +77 -77
  324. package/test/utils/webex-test-users.js +82 -82
  325. package/tsconfig.json +5 -5
  326. package/dist/common/browser-detection.d.ts +0 -9
  327. package/dist/common/collection.d.ts +0 -48
  328. package/dist/common/config.d.ts +0 -2
  329. package/dist/common/errors/captcha-error.d.ts +0 -15
  330. package/dist/common/errors/intent-to-join.d.ts +0 -16
  331. package/dist/common/errors/join-meeting.d.ts +0 -17
  332. package/dist/common/errors/media.d.ts +0 -15
  333. package/dist/common/errors/parameter.d.ts +0 -15
  334. package/dist/common/errors/password-error.d.ts +0 -15
  335. package/dist/common/errors/permission.d.ts +0 -14
  336. package/dist/common/errors/reconnection-in-progress.d.ts +0 -9
  337. package/dist/common/errors/reconnection.d.ts +0 -15
  338. package/dist/common/errors/stats.d.ts +0 -15
  339. package/dist/common/errors/webex-errors.d.ts +0 -81
  340. package/dist/common/errors/webex-meetings-error.d.ts +0 -20
  341. package/dist/common/events/events-scope.d.ts +0 -17
  342. package/dist/common/events/events.d.ts +0 -12
  343. package/dist/common/events/trigger-proxy.d.ts +0 -2
  344. package/dist/common/events/util.d.ts +0 -2
  345. package/dist/common/logs/logger-config.d.ts +0 -2
  346. package/dist/common/logs/logger-proxy.d.ts +0 -2
  347. package/dist/common/logs/request.d.ts +0 -34
  348. package/dist/common/queue.d.ts +0 -32
  349. package/dist/config.d.ts +0 -73
  350. package/dist/constants.d.ts +0 -924
  351. package/dist/controls-options-manager/constants.d.ts +0 -4
  352. package/dist/controls-options-manager/enums.d.ts +0 -5
  353. package/dist/controls-options-manager/index.d.ts +0 -120
  354. package/dist/controls-options-manager/util.d.ts +0 -7
  355. package/dist/index.d.ts +0 -4
  356. package/dist/locus-info/controlsUtils.d.ts +0 -2
  357. package/dist/locus-info/embeddedAppsUtils.d.ts +0 -2
  358. package/dist/locus-info/fullState.d.ts +0 -2
  359. package/dist/locus-info/hostUtils.d.ts +0 -2
  360. package/dist/locus-info/index.d.ts +0 -269
  361. package/dist/locus-info/infoUtils.d.ts +0 -2
  362. package/dist/locus-info/mediaSharesUtils.d.ts +0 -2
  363. package/dist/locus-info/parser.d.ts +0 -212
  364. package/dist/locus-info/selfUtils.d.ts +0 -2
  365. package/dist/media/index.d.ts +0 -32
  366. package/dist/media/properties.d.ts +0 -108
  367. package/dist/media/util.d.ts +0 -2
  368. package/dist/mediaQualityMetrics/config.d.ts +0 -233
  369. package/dist/meeting/effectsState.d.ts +0 -42
  370. package/dist/meeting/in-meeting-actions.d.ts +0 -79
  371. package/dist/meeting/index.d.ts +0 -1621
  372. package/dist/meeting/muteState.d.ts +0 -116
  373. package/dist/meeting/request.d.ts +0 -255
  374. package/dist/meeting/state.d.ts +0 -9
  375. package/dist/meeting/util.d.ts +0 -2
  376. package/dist/meeting-info/collection.d.ts +0 -20
  377. package/dist/meeting-info/index.d.ts +0 -57
  378. package/dist/meeting-info/meeting-info-v2.d.ts +0 -93
  379. package/dist/meeting-info/request.d.ts +0 -22
  380. package/dist/meeting-info/util.d.ts +0 -2
  381. package/dist/meeting-info/utilv2.d.ts +0 -2
  382. package/dist/meetings/collection.d.ts +0 -23
  383. package/dist/meetings/index.d.ts +0 -296
  384. package/dist/meetings/request.d.ts +0 -27
  385. package/dist/meetings/util.d.ts +0 -18
  386. package/dist/member/index.d.ts +0 -147
  387. package/dist/member/member.types.d.ts +0 -11
  388. package/dist/member/util.d.ts +0 -2
  389. package/dist/members/collection.d.ts +0 -24
  390. package/dist/members/index.d.ts +0 -298
  391. package/dist/members/request.d.ts +0 -50
  392. package/dist/members/util.d.ts +0 -2
  393. package/dist/metrics/config.d.ts +0 -169
  394. package/dist/metrics/constants.d.ts +0 -57
  395. package/dist/metrics/index.d.ts +0 -152
  396. package/dist/networkQualityMonitor/index.d.ts +0 -70
  397. package/dist/peer-connection-manager/index.d.ts +0 -6
  398. package/dist/peer-connection-manager/util.d.ts +0 -6
  399. package/dist/personal-meeting-room/index.d.ts +0 -47
  400. package/dist/personal-meeting-room/request.d.ts +0 -14
  401. package/dist/personal-meeting-room/util.d.ts +0 -2
  402. package/dist/reachability/index.d.ts +0 -139
  403. package/dist/reachability/request.d.ts +0 -35
  404. package/dist/reactions/reactions.d.ts +0 -4
  405. package/dist/reactions/reactions.type.d.ts +0 -32
  406. package/dist/reconnection-manager/index.d.ts +0 -112
  407. package/dist/recording-controller/enums.d.ts +0 -7
  408. package/dist/recording-controller/index.d.ts +0 -193
  409. package/dist/recording-controller/util.d.ts +0 -13
  410. package/dist/roap/collection.d.ts +0 -10
  411. package/dist/roap/handler.d.ts +0 -47
  412. package/dist/roap/index.d.ts +0 -116
  413. package/dist/roap/request.d.ts +0 -35
  414. package/dist/roap/state.d.ts +0 -9
  415. package/dist/roap/turnDiscovery.d.ts +0 -67
  416. package/dist/roap/util.d.ts +0 -2
  417. package/dist/statsAnalyzer/global.d.ts +0 -126
  418. package/dist/statsAnalyzer/index.d.ts +0 -190
  419. package/dist/statsAnalyzer/mqaUtil.d.ts +0 -22
  420. package/dist/transcription/index.d.ts +0 -64
@@ -1,1303 +1,1303 @@
1
- import {isEqual} from 'lodash';
2
-
3
- import LoggerProxy from '../common/logs/logger-proxy';
4
- import EventsScope from '../common/events/events-scope';
5
- import {
6
- EVENTS,
7
- LOCUSEVENT,
8
- _USER_,
9
- _CALL_,
10
- _SIP_BRIDGE_,
11
- MEETING_STATE,
12
- _MEETING_,
13
- LOCUSINFO,
14
- LOCUS,
15
- _LEFT_,
16
- MEETING_REMOVED_REASON,
17
- CALL_REMOVED_REASON,
18
- RECORDING_STATE,
19
- } from '../constants';
20
- import Metrics from '../metrics';
21
- import {eventType} from '../metrics/config';
22
- import InfoUtils from './infoUtils';
23
- import FullState from './fullState';
24
- import SelfUtils from './selfUtils';
25
- import HostUtils from './hostUtils';
26
- import ControlsUtils from './controlsUtils';
27
- import EmbeddedAppsUtils from './embeddedAppsUtils';
28
- import MediaSharesUtils from './mediaSharesUtils';
29
- import LocusDeltaParser from './parser';
30
-
31
- /**
32
- * @description LocusInfo extends ChildEmitter to convert locusInfo info a private emitter to parent object
33
- * @export
34
- * @private
35
- * @class LocusInfo
36
- */
37
- export default class LocusInfo extends EventsScope {
38
- compareAndUpdateFlags: any;
39
- emitChange: any;
40
- locusParser: any;
41
- meetingId: any;
42
- parsedLocus: any;
43
- updateMeeting: any;
44
- webex: any;
45
- aclUrl: any;
46
- baseSequence: any;
47
- created: any;
48
- deltaParticipants: any;
49
- identities: any;
50
- membership: any;
51
- participants: any;
52
- participantsUrl: any;
53
- replaces: any;
54
- scheduledMeeting: any;
55
- sequence: any;
56
- controls: any;
57
- conversationUrl: any;
58
- embeddedApps: any;
59
- fullState: any;
60
- host: any;
61
- info: any;
62
- mediaShares: any;
63
- replace: any;
64
- url: any;
65
- services: any;
66
-
67
- constructor(updateMeeting, webex, meetingId) {
68
- super();
69
- this.parsedLocus = {
70
- states: [],
71
- };
72
- this.webex = webex;
73
- this.emitChange = false;
74
- this.compareAndUpdateFlags = {};
75
- this.meetingId = meetingId;
76
- this.updateMeeting = updateMeeting;
77
- this.locusParser = new LocusDeltaParser();
78
- }
79
-
80
- /**
81
- * Apply locus delta data to meeting
82
- * @param {string} action Locus delta action
83
- * @param {Locus} locus
84
- * @param {Meeting} meeting
85
- * @returns {undefined}
86
- */
87
- applyLocusDeltaData(action: string, locus: any, meeting: any) {
88
- const {DESYNC, USE_CURRENT, USE_INCOMING} = LocusDeltaParser.loci;
89
-
90
- switch (action) {
91
- case USE_INCOMING:
92
- meeting.locusInfo.onDeltaLocus(locus);
93
- break;
94
- case USE_CURRENT:
95
- meeting.locusDesync = false;
96
- meeting.needToGetFullLocus = false;
97
- break;
98
- case DESYNC:
99
- meeting.meetingRequest
100
- .getFullLocus({
101
- desync: true,
102
- locusUrl: meeting.locusUrl,
103
- })
104
- .then((res) => {
105
- meeting.locusInfo.onFullLocus(res.body);
106
- // Notify parser to resume processing delta events
107
- // now that we have full locus from DESYNC.
108
- this.locusParser.resume();
109
- });
110
- break;
111
- default:
112
- LoggerProxy.logger.info(
113
- `Locus-info:index#applyLocusDeltaData --> Unknown locus delta action: ${action}`
114
- );
115
- }
116
- }
117
-
118
- /**
119
- * Adds locus delta to parser's queue
120
- * and registers a function handler
121
- * to recieve parsed actions from queue.
122
- * @param {Locus} locus
123
- * @param {Meeting} meeting
124
- * @returns {undefined}
125
- */
126
- handleLocusDelta(locus: any, meeting: any) {
127
- // register a function to process delta actions
128
- if (!this.locusParser.onDeltaAction) {
129
- // delta action, along with associated loci
130
- // is passed into the function.
131
- this.locusParser.onDeltaAction = (action, parsedLoci) => {
132
- this.applyLocusDeltaData(action, parsedLoci, meeting);
133
- };
134
- }
135
- // queue delta event with parser
136
- this.locusParser.onDeltaEvent(locus);
137
- }
138
-
139
- /**
140
- * @param {Locus} locus
141
- * @returns {undefined}
142
- * @memberof LocusInfo
143
- */
144
- init(locus: any = {}) {
145
- this.created = locus.created || null;
146
- this.scheduledMeeting = locus.meeting || null;
147
- this.participantsUrl = locus.participantsUrl || null;
148
- this.replaces = locus.replaces || null;
149
- this.aclUrl = locus.aclUrl || null;
150
- this.baseSequence = locus.baseSequence || null;
151
- this.sequence = locus.sequence || null;
152
- this.membership = locus.membership || null;
153
- this.identities = locus.identities || null;
154
- this.participants = locus.participants || null;
155
-
156
- /**
157
- * Stores the delta values for a changed participant.
158
- *
159
- * @typedef {Object} DeltaParticipant
160
- * @property {Record<string, boolean>} delta - Contains changed streams.
161
- * @property {Object} person - Contains person data.
162
- */
163
-
164
- /**
165
- * Stored participant changes between the last event and the current event.
166
- * All previously stored events are overwritten between events.
167
- *
168
- * @instance
169
- * @type {Array<DeltaParticipant>}
170
- * @private
171
- * @member LocusInfo
172
- */
173
- this.deltaParticipants = [];
174
-
175
- // above section only updates the locusInfo object
176
- // The below section makes sure it updates the locusInfo as well as updates the meeting object
177
- this.updateParticipants(locus.participants);
178
- // For 1:1 space meeting the conversation Url does not exist in locus.conversation
179
- this.updateConversationUrl(locus.conversationUrl, locus.info);
180
- this.updateControls(locus.controls);
181
- this.updateLocusUrl(locus.url);
182
- this.updateFullState(locus.fullState);
183
- this.updateMeetingInfo(locus.info);
184
- this.updateEmbeddedApps(locus.embeddedApps);
185
- // self and participants generate sipUrl for 1:1 meeting
186
- this.updateSelf(locus.self, locus.participants);
187
- this.updateHostInfo(locus.host);
188
- this.updateMediaShares(locus.mediaShares);
189
- this.updateServices(locus.links?.services);
190
- }
191
-
192
- /**
193
- * @param {Object} locus
194
- * @returns {undefined}
195
- * @memberof LocusInfo
196
- */
197
- initialSetup(locus: object) {
198
- this.onFullLocus(locus);
199
-
200
- // Change it to true after it receives it first locus object
201
- this.emitChange = true;
202
- }
203
-
204
- /**
205
- * @param {Meeting} meeting
206
- * @param {Object} data
207
- * @returns {undefined}
208
- * @memberof LocusInfo
209
- */
210
- parse(meeting: any, data: any) {
211
- // eslint-disable-next-line @typescript-eslint/no-shadow
212
- const {eventType} = data;
213
-
214
- LoggerProxy.logger.info(`Locus-info:index#parse --> received locus data: ${eventType}`);
215
-
216
- switch (eventType) {
217
- case LOCUSEVENT.PARTICIPANT_JOIN:
218
- case LOCUSEVENT.PARTICIPANT_LEFT:
219
- case LOCUSEVENT.CONTROLS_UPDATED:
220
- case LOCUSEVENT.PARTICIPANT_AUDIO_MUTED:
221
- case LOCUSEVENT.PARTICIPANT_AUDIO_UNMUTED:
222
- case LOCUSEVENT.PARTICIPANT_VIDEO_MUTED:
223
- case LOCUSEVENT.PARTICIPANT_VIDEO_UNMUTED:
224
- case LOCUSEVENT.SELF_CHANGED:
225
- case LOCUSEVENT.PARTICIPANT_UPDATED:
226
- case LOCUSEVENT.PARTICIPANT_CONTROLS_UPDATED:
227
- case LOCUSEVENT.PARTICIPANT_ROLES_UPDATED:
228
- case LOCUSEVENT.PARTICIPANT_DECLINED:
229
- case LOCUSEVENT.FLOOR_GRANTED:
230
- case LOCUSEVENT.FLOOR_RELEASED:
231
- this.onFullLocus(data.locus, eventType);
232
- break;
233
- case LOCUSEVENT.DIFFERENCE:
234
- this.handleLocusDelta(data.locus, meeting);
235
- break;
236
-
237
- default:
238
- // Why will there be a event with no eventType ????
239
- // we may not need this, we can get full locus
240
- this.handleLocusDelta(data.locus, meeting);
241
- }
242
- }
243
-
244
- /**
245
- * @param {String} scope
246
- * @param {String} eventName
247
- * @param {Array} args
248
- * @returns {undefined}
249
- * @memberof LocusInfo
250
- */
251
- emitScoped(scope?: any, eventName?: string, args?: any) {
252
- return this.emit(scope, eventName, args);
253
- }
254
-
255
- /**
256
- * updates the locus with full locus object
257
- * @param {object} locus locus object
258
- * @param {string} eventType particulat locus event
259
- * @returns {object} null
260
- * @memberof LocusInfo
261
- */
262
- // eslint-disable-next-line @typescript-eslint/no-shadow
263
- onFullLocus(locus: any, eventType?: string) {
264
- if (!locus) {
265
- LoggerProxy.logger.error(
266
- 'Locus-info:index#onFullLocus --> object passed as argument was invalid, continuing.'
267
- );
268
- }
269
- this.updateParticipantDeltas(locus.participants);
270
- this.scheduledMeeting = locus.meeting || null;
271
- this.participants = locus.participants;
272
- this.updateLocusInfo(locus);
273
- this.updateParticipants(locus.participants);
274
- this.isMeetingActive();
275
- this.handleOneOnOneEvent(eventType);
276
- this.updateEmbeddedApps(locus.embeddedApps);
277
- // set current (working copy) for parser
278
- this.locusParser.workingCopy = locus;
279
- }
280
-
281
- // used for ringing stops on one on one
282
- /**
283
- * @param {String} eventType
284
- * @returns {undefined}
285
- * @memberof LocusInfo
286
- */
287
- // eslint-disable-next-line @typescript-eslint/no-shadow
288
- handleOneOnOneEvent(eventType: string) {
289
- if (
290
- this.parsedLocus.fullState.type === _CALL_ ||
291
- this.parsedLocus.fullState.type === _SIP_BRIDGE_
292
- ) {
293
- // for 1:1 bob calls alice and alice declines, notify the meeting state
294
- if (eventType === LOCUSEVENT.PARTICIPANT_DECLINED) {
295
- // trigger the event for stop ringing
296
- this.emitScoped(
297
- {
298
- file: 'locus-info',
299
- function: 'handleOneonOneEvent',
300
- },
301
- EVENTS.REMOTE_RESPONSE,
302
- {
303
- remoteDeclined: true,
304
- remoteAnswered: false,
305
- }
306
- );
307
- }
308
- // for 1:1 bob calls alice and alice answers, notify the meeting state
309
- if (eventType === LOCUSEVENT.PARTICIPANT_JOIN) {
310
- // trigger the event for stop ringing
311
- this.emitScoped(
312
- {
313
- file: 'locus-info',
314
- function: 'handleOneonOneEvent',
315
- },
316
- EVENTS.REMOTE_RESPONSE,
317
- {
318
- remoteDeclined: false,
319
- remoteAnswered: true,
320
- }
321
- );
322
- }
323
- }
324
- }
325
-
326
- /**
327
- * @param {Object} locus
328
- * @returns {undefined}
329
- * @memberof LocusInfo
330
- */
331
- onDeltaLocus(locus: any) {
332
- this.updateLocusInfo(locus);
333
- this.updateParticipants(locus.participants);
334
- this.isMeetingActive();
335
- }
336
-
337
- /**
338
- * @param {Object} locus
339
- * @returns {undefined}
340
- * @memberof LocusInfo
341
- */
342
- updateLocusInfo(locus: any) {
343
- this.updateControls(locus.controls);
344
- this.updateConversationUrl(locus.conversationUrl, locus.info);
345
- this.updateCreated(locus.created);
346
- this.updateFullState(locus.fullState);
347
- this.updateHostInfo(locus.host);
348
- this.updateMeetingInfo(locus.info, locus.self);
349
- this.updateMediaShares(locus.mediaShares);
350
- this.updateParticipantsUrl(locus.participantsUrl);
351
- this.updateReplace(locus.replace);
352
- this.updateSelf(locus.self, locus.participants);
353
- this.updateLocusUrl(locus.url);
354
- this.updateAclUrl(locus.aclUrl);
355
- this.updateBasequence(locus.baseSequence);
356
- this.updateSequence(locus.sequence);
357
- this.updateMemberShip(locus.membership);
358
- this.updateIdentifiers(locus.identities);
359
- this.updateEmbeddedApps(locus.embeddedApps);
360
- this.updateServices(locus.links?.services);
361
- this.compareAndUpdate();
362
- // update which required to compare different objects from locus
363
- }
364
-
365
- /**
366
- * @param {Array} participants
367
- * @param {Object} self
368
- * @returns {Array}
369
- * @memberof LocusInfo
370
- */
371
- getLocusPartner(participants: Array<any>, self: any) {
372
- if (!participants || participants.length === 0) {
373
- return null;
374
- }
375
-
376
- return (
377
- participants.find(
378
- (participant) =>
379
- self &&
380
- participant.identity !== self.identity &&
381
- (participants.length <= 2 || (participant.type === _USER_ && !participant.removed))
382
- // @ts-ignore
383
- ) || this.partner
384
- );
385
- }
386
-
387
- // TODO: all the leave states need to be checked
388
- /**
389
- * @returns {undefined}
390
- * @memberof LocusInfo
391
- */
392
- isMeetingActive() {
393
- if (
394
- this.parsedLocus.fullState.type === _CALL_ ||
395
- this.parsedLocus.fullState.type === _SIP_BRIDGE_
396
- ) {
397
- // @ts-ignore
398
- const partner = this.getLocusPartner(this.participants, this.self);
399
-
400
- this.updateMeeting({partner});
401
-
402
- // Check if guest user needs to be checked here
403
-
404
- // 1) when bob declines call from bob, (bob='DECLINED')
405
- // 2) When alice rejects call to bob , (bob='NOTIFIED')
406
-
407
- // When we dont add MEDIA for condition 2. The state of bob='IDLE'
408
-
409
- if (this.fullState && this.fullState.state === LOCUS.STATE.INACTIVE) {
410
- // TODO: update the meeting state
411
- LoggerProxy.logger.warn(
412
- 'Locus-info:index#isMeetingActive --> Call Ended, locus state is inactive.'
413
- );
414
- Metrics.postEvent({
415
- event: eventType.REMOTE_ENDED,
416
- meetingId: this.meetingId,
417
- });
418
- this.emitScoped(
419
- {
420
- file: 'locus-info',
421
- function: 'isMeetingActive',
422
- },
423
- EVENTS.DESTROY_MEETING,
424
- {
425
- reason: CALL_REMOVED_REASON.CALL_INACTIVE,
426
- shouldLeave: false,
427
- }
428
- );
429
- } else if (
430
- partner.state === MEETING_STATE.STATES.LEFT &&
431
- this.parsedLocus.self &&
432
- (this.parsedLocus.self.state === MEETING_STATE.STATES.DECLINED ||
433
- this.parsedLocus.self.state === MEETING_STATE.STATES.NOTIFIED ||
434
- this.parsedLocus.self.state === MEETING_STATE.STATES.JOINED)
435
- ) {
436
- Metrics.postEvent({
437
- event: eventType.REMOTE_ENDED,
438
- meetingId: this.meetingId,
439
- });
440
- this.emitScoped(
441
- {
442
- file: 'locus-info',
443
- function: 'isMeetingActive',
444
- },
445
- EVENTS.DESTROY_MEETING,
446
- {
447
- reason: CALL_REMOVED_REASON.PARTNER_LEFT,
448
- shouldLeave:
449
- this.parsedLocus.self.joinedWith && this.parsedLocus.self.joinedWith.state !== _LEFT_,
450
- }
451
- );
452
- } else if (
453
- this.parsedLocus.self &&
454
- this.parsedLocus.self.state === MEETING_STATE.STATES.LEFT &&
455
- (partner.state === MEETING_STATE.STATES.LEFT ||
456
- partner.state === MEETING_STATE.STATES.DECLINED ||
457
- partner.state === MEETING_STATE.STATES.NOTIFIED ||
458
- partner.state === MEETING_STATE.STATES.IDLE) // Happens when user just joins and adds no Media
459
- ) {
460
- Metrics.postEvent({
461
- event: eventType.REMOTE_ENDED,
462
- meetingId: this.meetingId,
463
- });
464
- this.emitScoped(
465
- {
466
- file: 'locus-info',
467
- function: 'isMeetingActive',
468
- },
469
- EVENTS.DESTROY_MEETING,
470
- {
471
- reason: CALL_REMOVED_REASON.SELF_LEFT,
472
- shouldLeave: false,
473
- }
474
- );
475
- }
476
- } else if (this.parsedLocus.fullState.type === _MEETING_) {
477
- if (
478
- this.fullState &&
479
- (this.fullState.state === LOCUS.STATE.INACTIVE ||
480
- // @ts-ignore
481
- this.fullState.state === LOCUS.STATE.TERMINATING)
482
- ) {
483
- LoggerProxy.logger.warn(
484
- 'Locus-info:index#isMeetingActive --> Meeting is ending due to inactive or terminating'
485
- );
486
- Metrics.postEvent({
487
- event: eventType.REMOTE_ENDED,
488
- meetingId: this.meetingId,
489
- });
490
- this.emitScoped(
491
- {
492
- file: 'locus-info',
493
- function: 'isMeetingActive',
494
- },
495
- EVENTS.DESTROY_MEETING,
496
- {
497
- reason: MEETING_REMOVED_REASON.MEETING_INACTIVE_TERMINATING,
498
- shouldLeave: false,
499
- }
500
- );
501
- } else if (this.fullState && this.fullState.removed) {
502
- // user has been dropped from a meeting
503
- Metrics.postEvent({
504
- event: eventType.REMOTE_ENDED,
505
- meetingId: this.meetingId,
506
- });
507
- this.emitScoped(
508
- {
509
- file: 'locus-info',
510
- function: 'isMeetingActive',
511
- },
512
- EVENTS.DESTROY_MEETING,
513
- {
514
- reason: MEETING_REMOVED_REASON.FULLSTATE_REMOVED,
515
- shouldLeave: false,
516
- }
517
- );
518
- }
519
- // If you are guest and you are removed from the meeting
520
- // You wont get any further events
521
- else if (this.parsedLocus.self && this.parsedLocus.self.removed) {
522
- // Check if we need to send an event
523
- this.emitScoped(
524
- {
525
- file: 'locus-info',
526
- function: 'isMeetingActive',
527
- },
528
- EVENTS.DESTROY_MEETING,
529
- {
530
- reason: MEETING_REMOVED_REASON.SELF_REMOVED,
531
- shouldLeave: false,
532
- }
533
- );
534
- }
535
- } else {
536
- LoggerProxy.logger.warn('Locus-info:index#isMeetingActive --> Meeting Type is unknown.');
537
- }
538
- }
539
-
540
- /**
541
- * checks if the host permissions have changed while in the meeting
542
- * This would be the case if your role as host or moderator has been updated
543
- * @returns {undefined}
544
- * @memberof LocusInfo
545
- */
546
- compareAndUpdate() {
547
- // TODO: check with locus team on host and moderator doc
548
- // use host as a validator if needed
549
- if (
550
- this.compareAndUpdateFlags.compareSelfAndHost ||
551
- this.compareAndUpdateFlags.compareHostAndSelf
552
- ) {
553
- this.compareSelfAndHost();
554
- }
555
- }
556
-
557
- /**
558
- * compared the self object to check if the user has host permissions
559
- * @returns {undefined}
560
- * @memberof LocusInfo
561
- */
562
- compareSelfAndHost() {
563
- // In some cases the host info is not present but the moderator values changes from null to false so it triggers an update
564
- if (
565
- this.parsedLocus.self.selfIdentity === this.parsedLocus.host?.hostId &&
566
- this.parsedLocus.self.moderator
567
- ) {
568
- this.emitScoped(
569
- {
570
- file: 'locus-info',
571
- function: 'compareSelfAndHost',
572
- },
573
- EVENTS.LOCUS_INFO_CAN_ASSIGN_HOST,
574
- {
575
- canAssignHost: true,
576
- }
577
- );
578
- } else {
579
- this.emitScoped(
580
- {
581
- file: 'locus-info',
582
- function: 'compareSelfAndHost',
583
- },
584
- EVENTS.LOCUS_INFO_CAN_ASSIGN_HOST,
585
- {
586
- canAssignHost: false,
587
- }
588
- );
589
- }
590
- }
591
-
592
- /**
593
- * Update the deltaParticipants property of this object based on a list of
594
- * provided participants.
595
- *
596
- * @param {Array} [participants] - The participants to update against.
597
- * @returns {void}
598
- */
599
- updateParticipantDeltas(participants: Array<any> = []) {
600
- // Used to find a participant within a participants collection.
601
- const findParticipant = (participant, collection) =>
602
- collection.find((item) => item.person.id === participant.person.id);
603
-
604
- // Generates an object that indicates which state properties have changed.
605
- const generateDelta = (prevState: any = {}, newState: any = {}) => {
606
- // Setup deltas.
607
- const deltas = {
608
- audioStatus: prevState.audioStatus !== newState.audioStatus,
609
- videoSlidesStatus: prevState.videoSlidesStatus !== newState.videoSlidesStatus,
610
- videoStatus: prevState.videoStatus !== newState.videoStatus,
611
- };
612
-
613
- // Clean the object
614
- Object.keys(deltas).forEach((key) => {
615
- if (deltas[key] !== true) {
616
- delete deltas[key];
617
- }
618
- });
619
-
620
- return deltas;
621
- };
622
-
623
- this.deltaParticipants = participants.reduce((collection, participant) => {
624
- const existingParticipant = findParticipant(participant, this.participants || []) || {};
625
-
626
- const delta = generateDelta(existingParticipant.status, participant.status);
627
-
628
- const changed = Object.keys(delta).length > 0;
629
-
630
- if (changed) {
631
- collection.push({
632
- person: participant.person,
633
- delta,
634
- });
635
- }
636
-
637
- return collection;
638
- }, []);
639
- }
640
-
641
- /**
642
- *
643
- * @param {Object} participants new participants object
644
- * @param {boolen} deltaParticpantFlag delta event
645
- * @returns {Array} updatedParticipants
646
- * @memberof LocusInfo
647
- */
648
- updateParticipants(participants: object) {
649
- this.emitScoped(
650
- {
651
- file: 'locus-info',
652
- function: 'updateParticipants',
653
- },
654
- EVENTS.LOCUS_INFO_UPDATE_PARTICIPANTS,
655
- {
656
- participants,
657
- recordingId: this.parsedLocus.controls && this.parsedLocus.controls.record?.modifiedBy,
658
- selfIdentity: this.parsedLocus.self && this.parsedLocus.self.selfIdentity,
659
- selfId: this.parsedLocus.self && this.parsedLocus.self.selfId,
660
- hostId: this.parsedLocus.host && this.parsedLocus.host.hostId,
661
- }
662
- );
663
- }
664
-
665
- /**
666
- * @param {Object} controls
667
- * @returns {undefined}
668
- * @memberof LocusInfo
669
- */
670
- updateControls(controls: object) {
671
- if (controls && !isEqual(this.controls, controls)) {
672
- this.parsedLocus.controls = ControlsUtils.parse(controls);
673
- const {
674
- updates: {
675
- hasRecordingChanged,
676
- hasRecordingPausedChanged,
677
- hasMeetingContainerChanged,
678
- hasTranscribeChanged,
679
- hasEntryExitToneChanged,
680
- },
681
- current,
682
- } = ControlsUtils.getControls(this.controls, controls);
683
-
684
- if (hasRecordingChanged || hasRecordingPausedChanged) {
685
- let state = null;
686
-
687
- if (hasRecordingPausedChanged) {
688
- if (current.record.paused) {
689
- state = RECORDING_STATE.PAUSED;
690
- } else {
691
- // state will be `IDLE` if the recording is not active, even when there is a `pause` status change.
692
- state = current.record.recording ? RECORDING_STATE.RESUMED : RECORDING_STATE.IDLE;
693
- }
694
- } else if (hasRecordingChanged) {
695
- state = current.record.recording ? RECORDING_STATE.RECORDING : RECORDING_STATE.IDLE;
696
- }
697
-
698
- this.emitScoped(
699
- {
700
- file: 'locus-info',
701
- function: 'updateControls',
702
- },
703
- LOCUSINFO.EVENTS.CONTROLS_RECORDING_UPDATED,
704
- {
705
- state,
706
- modifiedBy: current.record.modifiedBy,
707
- lastModified: current.record.lastModified,
708
- }
709
- );
710
- }
711
-
712
- if (hasMeetingContainerChanged) {
713
- const {meetingContainerUrl} = current.meetingContainer;
714
-
715
- this.emitScoped(
716
- {
717
- file: 'locus-info',
718
- function: 'updateControls',
719
- },
720
- LOCUSINFO.EVENTS.CONTROLS_MEETING_CONTAINER_UPDATED,
721
- {
722
- meetingContainerUrl,
723
- }
724
- );
725
- }
726
-
727
- if (hasTranscribeChanged) {
728
- const {transcribing, caption} = current.transcribe;
729
-
730
- this.emitScoped(
731
- {
732
- file: 'locus-info',
733
- function: 'updateControls',
734
- },
735
- LOCUSINFO.EVENTS.CONTROLS_MEETING_TRANSCRIBE_UPDATED,
736
- {
737
- transcribing,
738
- caption,
739
- }
740
- );
741
- }
742
-
743
- if (hasEntryExitToneChanged) {
744
- const {entryExitTone} = current;
745
-
746
- this.emitScoped(
747
- {
748
- file: 'locus-info',
749
- function: 'updateControls',
750
- },
751
- LOCUSINFO.EVENTS.CONTROLS_ENTRY_EXIT_TONE_UPDATED,
752
- {
753
- entryExitTone,
754
- }
755
- );
756
-
757
- this.updateMeeting({entryExitTone});
758
- }
759
-
760
- this.controls = controls;
761
- }
762
- }
763
-
764
- /**
765
- * @param {String} conversationUrl
766
- * @param {Object} info
767
- * @returns {undefined}
768
- * @memberof LocusInfo
769
- */
770
- updateConversationUrl(conversationUrl: string, info: any) {
771
- if (conversationUrl && !isEqual(this.conversationUrl, conversationUrl)) {
772
- this.conversationUrl = conversationUrl;
773
- this.updateMeeting({conversationUrl});
774
- } else if (
775
- info &&
776
- info.conversationUrl &&
777
- !isEqual(this.conversationUrl, info.conversationUrl)
778
- ) {
779
- this.conversationUrl = info.conversationUrl;
780
- this.updateMeeting({conversationUrl: info.conversationUrl});
781
- }
782
- }
783
-
784
- /**
785
- * @param {Object} created
786
- * @returns {undefined}
787
- * @memberof LocusInfo
788
- */
789
- updateCreated(created: object) {
790
- if (created && !isEqual(this.created, created)) {
791
- this.created = created;
792
- }
793
- }
794
-
795
- /**
796
- * @param {Object} services
797
- * @returns {undefined}
798
- * @memberof LocusInfo
799
- */
800
- updateServices(services: Record<'breakout' | 'record', {url: string}>) {
801
- if (services && !isEqual(this.services, services)) {
802
- this.services = services;
803
- this.emitScoped(
804
- {
805
- file: 'locus-info',
806
- function: 'updateServices',
807
- },
808
- LOCUSINFO.EVENTS.LINKS_SERVICES,
809
- {
810
- services,
811
- }
812
- );
813
- }
814
- }
815
-
816
- /**
817
- * @param {Object} fullState
818
- * @returns {undefined}
819
- * @memberof LocusInfo
820
- */
821
- updateFullState(fullState: object) {
822
- if (fullState && !isEqual(this.fullState, fullState)) {
823
- const result = FullState.getFullState(this.fullState, fullState);
824
-
825
- this.updateMeeting(result.current);
826
-
827
- if (result.updates.meetingStateChangedTo) {
828
- this.emitScoped(
829
- {
830
- file: 'locus-info',
831
- function: 'updateFullState',
832
- },
833
- LOCUSINFO.EVENTS.FULL_STATE_MEETING_STATE_CHANGE,
834
- {
835
- previousState: result.previous && result.previous.meetingState,
836
- currentState: result.current.meetingState,
837
- }
838
- );
839
- }
840
-
841
- if (result.updates.meetingTypeChangedTo) {
842
- this.emitScoped(
843
- {
844
- file: 'locus-info',
845
- function: 'updateFullState',
846
- },
847
- LOCUSINFO.EVENTS.FULL_STATE_TYPE_UPDATE,
848
- {
849
- type: result.current.type,
850
- }
851
- );
852
- }
853
- this.parsedLocus.fullState = result.current;
854
- this.fullState = fullState;
855
- }
856
- }
857
-
858
- /**
859
- * handles when the locus.host is updated
860
- * @param {Object} host the locus.host property
861
- * @returns {undefined}
862
- * @memberof LocusInfo
863
- * emits internal event locus_info_update_host
864
- */
865
- updateHostInfo(host: object) {
866
- if (host && !isEqual(this.host, host)) {
867
- const parsedHosts = HostUtils.getHosts(this.host, host);
868
-
869
- this.updateMeeting(parsedHosts.current);
870
- this.parsedLocus.host = parsedHosts.current;
871
- if (parsedHosts.updates.isNewHost) {
872
- this.compareAndUpdateFlags.compareSelfAndHost = true;
873
- this.emitScoped(
874
- {
875
- file: 'locus-info',
876
- function: 'updateHostInfo',
877
- },
878
- EVENTS.LOCUS_INFO_UPDATE_HOST,
879
- {
880
- newHost: parsedHosts.current,
881
- oldHost: parsedHosts.previous,
882
- }
883
- );
884
- }
885
- this.host = host;
886
- } else {
887
- this.compareAndUpdateFlags.compareSelfAndHost = false;
888
- }
889
- }
890
-
891
- /**
892
- * @param {Object} info
893
- * @param {Object} self
894
- * @returns {undefined}
895
- * @memberof LocusInfo
896
- */
897
- updateMeetingInfo(info: object, self?: object) {
898
- if (info && !isEqual(this.info, info)) {
899
- const roles = self ? SelfUtils.getRoles(self) : this.parsedLocus.self?.roles || [];
900
- const isJoined = SelfUtils.isJoined(self || this.parsedLocus.self);
901
- const parsedInfo = InfoUtils.getInfos(this.parsedLocus.info, info, roles, isJoined);
902
-
903
- this.emitScoped(
904
- {
905
- file: 'locus-info',
906
- function: 'updateMeetingInfo',
907
- },
908
- LOCUSINFO.EVENTS.MEETING_INFO_UPDATED,
909
- {info: parsedInfo.current, self}
910
- );
911
-
912
- if (parsedInfo.updates.isLocked) {
913
- this.emitScoped(
914
- {
915
- file: 'locus-info',
916
- function: 'updateMeetingInfo',
917
- },
918
- LOCUSINFO.EVENTS.MEETING_LOCKED,
919
- info
920
- );
921
- }
922
- if (parsedInfo.updates.isUnlocked) {
923
- this.emitScoped(
924
- {
925
- file: 'locus-info',
926
- function: 'updateMeetingInfo',
927
- },
928
- LOCUSINFO.EVENTS.MEETING_UNLOCKED,
929
- info
930
- );
931
- }
932
-
933
- this.info = info;
934
- this.parsedLocus.info = parsedInfo.current;
935
- // Parses the info and adds necessary values
936
- this.updateMeeting(parsedInfo.current);
937
- }
938
- }
939
-
940
- /**
941
- * @param {Object} embeddedApps
942
- * @returns {undefined}
943
- * @memberof LocusInfo
944
- */
945
- updateEmbeddedApps(embeddedApps: object) {
946
- // don't do anything if the arrays of apps haven't changed significantly
947
- if (EmbeddedAppsUtils.areSimilar(this.embeddedApps, embeddedApps)) {
948
- return;
949
- }
950
-
951
- const parsedEmbeddedApps = EmbeddedAppsUtils.parse(embeddedApps);
952
-
953
- this.updateMeeting({embeddedApps: parsedEmbeddedApps});
954
-
955
- this.emitScoped(
956
- {
957
- file: 'locus-info',
958
- function: 'updateEmbeddedApps',
959
- },
960
- LOCUSINFO.EVENTS.EMBEDDED_APPS_UPDATED,
961
- parsedEmbeddedApps
962
- );
963
- this.embeddedApps = embeddedApps;
964
- }
965
-
966
- /**
967
- * handles when the locus.mediaShares is updated
968
- * @param {Object} mediaShares the locus.mediaShares property
969
- * @returns {undefined}
970
- * @memberof LocusInfo
971
- * emits internal event locus_info_update_media_shares
972
- */
973
- updateMediaShares(mediaShares: object) {
974
- if (mediaShares && !isEqual(this.mediaShares, mediaShares)) {
975
- const parsedMediaShares = MediaSharesUtils.getMediaShares(this.mediaShares, mediaShares);
976
-
977
- this.updateMeeting(parsedMediaShares.current);
978
- this.emitScoped(
979
- {
980
- file: 'locus-info',
981
- function: 'updateMediaShares',
982
- },
983
- EVENTS.LOCUS_INFO_UPDATE_MEDIA_SHARES,
984
- {
985
- current: parsedMediaShares.current,
986
- previous: parsedMediaShares.previous,
987
- }
988
- );
989
- this.parsedLocus.mediaShares = parsedMediaShares.current;
990
- this.mediaShares = mediaShares;
991
- }
992
- }
993
-
994
- /**
995
- * @param {String} participantsUrl
996
- * @returns {undefined}
997
- * @memberof LocusInfo
998
- */
999
- updateParticipantsUrl(participantsUrl: string) {
1000
- if (participantsUrl && !isEqual(this.participantsUrl, participantsUrl)) {
1001
- this.participantsUrl = participantsUrl;
1002
- }
1003
- }
1004
-
1005
- /**
1006
- * @param {Object} replace
1007
- * @returns {undefined}
1008
- * @memberof LocusInfo
1009
- */
1010
- updateReplace(replace: object) {
1011
- if (replace && !isEqual(this.replace, replace)) {
1012
- this.replace = replace;
1013
- }
1014
- }
1015
-
1016
- /**
1017
- * handles when the locus.self is updated
1018
- * @param {Object} self the locus.mediaShares property
1019
- * @param {Array} participants the locus.participants property
1020
- * @returns {undefined}
1021
- * @memberof LocusInfo
1022
- * emits internal events self_admitted_guest, self_unadmitted_guest, locus_info_update_self
1023
- */
1024
- updateSelf(self: any, participants: Array<any>) {
1025
- // @ts-ignore - check where this.self come from
1026
- if (self && !isEqual(this.self, self)) {
1027
- // @ts-ignore
1028
- const parsedSelves = SelfUtils.getSelves(this.self, self, this.webex.internal.device.url);
1029
-
1030
- this.updateMeeting(parsedSelves.current);
1031
- this.parsedLocus.self = parsedSelves.current;
1032
-
1033
- const element = this.parsedLocus.states[this.parsedLocus.states.length - 1];
1034
-
1035
- if (element !== parsedSelves.current.state) {
1036
- this.parsedLocus.states.push(parsedSelves.current.state);
1037
- }
1038
-
1039
- // TODO: check if we need to save the sipUri here as well
1040
- // this.emit(LOCUSINFO.EVENTS.MEETING_UPDATE, SelfUtils.getSipUrl(this.getLocusPartner(participants, self), this.parsedLocus.fullState.type, this.parsedLocus.info.sipUri));
1041
- const result = SelfUtils.getSipUrl(
1042
- this.getLocusPartner(participants, self),
1043
- this.parsedLocus.fullState.type,
1044
- this.parsedLocus.info.sipUri
1045
- );
1046
-
1047
- if (result.sipUri) {
1048
- this.updateMeeting(result);
1049
- }
1050
-
1051
- if (parsedSelves.updates.moderatorChanged) {
1052
- this.compareAndUpdateFlags.compareHostAndSelf = true;
1053
- } else {
1054
- this.compareAndUpdateFlags.compareHostAndSelf = false;
1055
- }
1056
-
1057
- if (parsedSelves.updates.layoutChanged) {
1058
- this.emitScoped(
1059
- {
1060
- file: 'locus-info',
1061
- function: 'updateSelf',
1062
- },
1063
- LOCUSINFO.EVENTS.CONTROLS_MEETING_LAYOUT_UPDATED,
1064
- {layout: parsedSelves.current.layout}
1065
- );
1066
- }
1067
-
1068
- if (parsedSelves.updates.isMediaInactiveOrReleased) {
1069
- this.emitScoped(
1070
- {
1071
- file: 'locus-info',
1072
- function: 'updateSelf',
1073
- },
1074
- LOCUSINFO.EVENTS.DISCONNECT_DUE_TO_INACTIVITY,
1075
- {reason: self.reason}
1076
- );
1077
- }
1078
-
1079
- if (parsedSelves.updates.moderatorChanged) {
1080
- this.emitScoped(
1081
- {
1082
- file: 'locus-info',
1083
- function: 'updateSelf',
1084
- },
1085
- LOCUSINFO.EVENTS.SELF_MODERATOR_CHANGED,
1086
- self
1087
- );
1088
- }
1089
- if (parsedSelves.updates.localAudioUnmuteRequiredByServer) {
1090
- this.emitScoped(
1091
- {
1092
- file: 'locus-info',
1093
- function: 'updateSelf',
1094
- },
1095
- LOCUSINFO.EVENTS.LOCAL_UNMUTE_REQUIRED,
1096
- {
1097
- muted: parsedSelves.current.remoteMuted,
1098
- unmuteAllowed: parsedSelves.current.unmuteAllowed,
1099
- }
1100
- );
1101
- }
1102
- if (parsedSelves.updates.isMutedByOthersChanged) {
1103
- this.emitScoped(
1104
- {
1105
- file: 'locus-info',
1106
- function: 'updateSelf',
1107
- },
1108
- LOCUSINFO.EVENTS.SELF_REMOTE_MUTE_STATUS_UPDATED,
1109
- {
1110
- muted: parsedSelves.current.remoteMuted,
1111
- unmuteAllowed: parsedSelves.current.unmuteAllowed,
1112
- }
1113
- );
1114
- }
1115
- if (parsedSelves.updates.localAudioUnmuteRequestedByServer) {
1116
- this.emitScoped(
1117
- {
1118
- file: 'locus-info',
1119
- function: 'updateSelf',
1120
- },
1121
- LOCUSINFO.EVENTS.LOCAL_UNMUTE_REQUESTED,
1122
- {}
1123
- );
1124
- }
1125
- if (parsedSelves.updates.isUserUnadmitted) {
1126
- this.emitScoped(
1127
- {
1128
- file: 'locus-info',
1129
- function: 'updateSelf',
1130
- },
1131
- LOCUSINFO.EVENTS.SELF_UNADMITTED_GUEST,
1132
- self
1133
- );
1134
- }
1135
- if (parsedSelves.updates.isUserAdmitted) {
1136
- this.emitScoped(
1137
- {
1138
- file: 'locus-info',
1139
- function: 'updateSelf',
1140
- },
1141
- LOCUSINFO.EVENTS.SELF_ADMITTED_GUEST,
1142
- self
1143
- );
1144
- }
1145
-
1146
- if (parsedSelves.updates.isMediaInactive) {
1147
- this.emitScoped(
1148
- {
1149
- file: 'locus-info',
1150
- function: 'updateSelf',
1151
- },
1152
- // @ts-ignore
1153
- LOCUSINFO.EVENTS.MEDIA_INACTIVITY,
1154
- SelfUtils.getMediaStatus(self.mediaSessions)
1155
- );
1156
- }
1157
-
1158
- if (
1159
- parsedSelves.updates.audioStateChange ||
1160
- parsedSelves.updates.videoStateChange ||
1161
- parsedSelves.updates.shareStateChange
1162
- ) {
1163
- this.emitScoped(
1164
- {
1165
- file: 'locus-info',
1166
- function: 'updateSelf',
1167
- },
1168
- LOCUSINFO.EVENTS.MEDIA_STATUS_CHANGE,
1169
- {
1170
- audioStatus: parsedSelves.current.currentMediaStatus?.audio,
1171
- videoStatus: parsedSelves.current.currentMediaStatus?.video,
1172
- shareStatus: parsedSelves.current.currentMediaStatus?.share,
1173
- }
1174
- );
1175
- }
1176
-
1177
- if (parsedSelves.updates.isUserObserving) {
1178
- this.emitScoped(
1179
- {
1180
- file: 'locus-info',
1181
- function: 'updateSelf',
1182
- },
1183
- LOCUSINFO.EVENTS.SELF_OBSERVING
1184
- );
1185
- }
1186
-
1187
- if (parsedSelves.updates.canNotViewTheParticipantListChanged) {
1188
- this.emitScoped(
1189
- {
1190
- file: 'locus-info',
1191
- function: 'updateSelf',
1192
- },
1193
- LOCUSINFO.EVENTS.SELF_CANNOT_VIEW_PARTICIPANT_LIST_CHANGE,
1194
- {canNotViewTheParticipantList: parsedSelves.current.canNotViewTheParticipantList}
1195
- );
1196
- }
1197
-
1198
- if (parsedSelves.updates.isSharingBlockedChanged) {
1199
- this.emitScoped(
1200
- {
1201
- file: 'locus-info',
1202
- function: 'updateSelf',
1203
- },
1204
- LOCUSINFO.EVENTS.SELF_IS_SHARING_BLOCKED_CHANGE,
1205
- {isSharingBlocked: parsedSelves.current.isSharingBlocked}
1206
- );
1207
- }
1208
-
1209
- this.emitScoped(
1210
- {
1211
- file: 'locus-info',
1212
- function: 'updateSelf',
1213
- },
1214
- EVENTS.LOCUS_INFO_UPDATE_SELF,
1215
- {
1216
- oldSelf: parsedSelves.previous,
1217
- newSelf: parsedSelves.current,
1218
- }
1219
- );
1220
- this.parsedLocus.self = parsedSelves.current;
1221
- // @ts-ignore
1222
- this.self = self;
1223
- } else {
1224
- this.compareAndUpdateFlags.compareHostAndSelf = false;
1225
- }
1226
- }
1227
-
1228
- /**
1229
- * handles when the locus.url is updated
1230
- * @param {String} url
1231
- * @returns {undefined}
1232
- * emits internal event locus_info_update_url
1233
- */
1234
- updateLocusUrl(url: string) {
1235
- if (url && this.url !== url) {
1236
- this.url = url;
1237
- this.updateMeeting({locusUrl: url});
1238
- this.emitScoped(
1239
- {
1240
- file: 'locus-info',
1241
- function: 'updateLocusUrl',
1242
- },
1243
- EVENTS.LOCUS_INFO_UPDATE_URL,
1244
- url
1245
- );
1246
- }
1247
- }
1248
-
1249
- /**
1250
- * @param {String} aclUrl
1251
- * @returns {undefined}
1252
- * @memberof LocusInfo
1253
- */
1254
- updateAclUrl(aclUrl: string) {
1255
- if (aclUrl && !isEqual(this.aclUrl, aclUrl)) {
1256
- this.aclUrl = aclUrl;
1257
- }
1258
- }
1259
-
1260
- /**
1261
- * @param {Number} baseSequence
1262
- * @returns {undefined}
1263
- * @memberof LocusInfo
1264
- */
1265
- updateBasequence(baseSequence: number) {
1266
- if (baseSequence && !isEqual(this.baseSequence, baseSequence)) {
1267
- this.baseSequence = baseSequence;
1268
- }
1269
- }
1270
-
1271
- /**
1272
- * @param {Number} sequence
1273
- * @returns {undefined}
1274
- * @memberof LocusInfo
1275
- */
1276
- updateSequence(sequence: number) {
1277
- if (sequence && !isEqual(this.sequence, sequence)) {
1278
- this.sequence = sequence;
1279
- }
1280
- }
1281
-
1282
- /**
1283
- * @param {Object} membership
1284
- * @returns {undefined}
1285
- * @memberof LocusInfo
1286
- */
1287
- updateMemberShip(membership: object) {
1288
- if (membership && !isEqual(this.membership, membership)) {
1289
- this.membership = membership;
1290
- }
1291
- }
1292
-
1293
- /**
1294
- * @param {Array} identities
1295
- * @returns {undefined}
1296
- * @memberof LocusInfo
1297
- */
1298
- updateIdentifiers(identities: Array<any>) {
1299
- if (identities && !isEqual(this.identities, identities)) {
1300
- this.identities = identities;
1301
- }
1302
- }
1303
- }
1
+ import {isEqual} from 'lodash';
2
+
3
+ import LoggerProxy from '../common/logs/logger-proxy';
4
+ import EventsScope from '../common/events/events-scope';
5
+ import {
6
+ EVENTS,
7
+ LOCUSEVENT,
8
+ _USER_,
9
+ _CALL_,
10
+ _SIP_BRIDGE_,
11
+ MEETING_STATE,
12
+ _MEETING_,
13
+ LOCUSINFO,
14
+ LOCUS,
15
+ _LEFT_,
16
+ MEETING_REMOVED_REASON,
17
+ CALL_REMOVED_REASON,
18
+ RECORDING_STATE,
19
+ } from '../constants';
20
+ import Metrics from '../metrics';
21
+ import {eventType} from '../metrics/config';
22
+ import InfoUtils from './infoUtils';
23
+ import FullState from './fullState';
24
+ import SelfUtils from './selfUtils';
25
+ import HostUtils from './hostUtils';
26
+ import ControlsUtils from './controlsUtils';
27
+ import EmbeddedAppsUtils from './embeddedAppsUtils';
28
+ import MediaSharesUtils from './mediaSharesUtils';
29
+ import LocusDeltaParser from './parser';
30
+
31
+ /**
32
+ * @description LocusInfo extends ChildEmitter to convert locusInfo info a private emitter to parent object
33
+ * @export
34
+ * @private
35
+ * @class LocusInfo
36
+ */
37
+ export default class LocusInfo extends EventsScope {
38
+ compareAndUpdateFlags: any;
39
+ emitChange: any;
40
+ locusParser: any;
41
+ meetingId: any;
42
+ parsedLocus: any;
43
+ updateMeeting: any;
44
+ webex: any;
45
+ aclUrl: any;
46
+ baseSequence: any;
47
+ created: any;
48
+ deltaParticipants: any;
49
+ identities: any;
50
+ membership: any;
51
+ participants: any;
52
+ participantsUrl: any;
53
+ replaces: any;
54
+ scheduledMeeting: any;
55
+ sequence: any;
56
+ controls: any;
57
+ conversationUrl: any;
58
+ embeddedApps: any;
59
+ fullState: any;
60
+ host: any;
61
+ info: any;
62
+ mediaShares: any;
63
+ replace: any;
64
+ url: any;
65
+ services: any;
66
+
67
+ constructor(updateMeeting, webex, meetingId) {
68
+ super();
69
+ this.parsedLocus = {
70
+ states: [],
71
+ };
72
+ this.webex = webex;
73
+ this.emitChange = false;
74
+ this.compareAndUpdateFlags = {};
75
+ this.meetingId = meetingId;
76
+ this.updateMeeting = updateMeeting;
77
+ this.locusParser = new LocusDeltaParser();
78
+ }
79
+
80
+ /**
81
+ * Apply locus delta data to meeting
82
+ * @param {string} action Locus delta action
83
+ * @param {Locus} locus
84
+ * @param {Meeting} meeting
85
+ * @returns {undefined}
86
+ */
87
+ applyLocusDeltaData(action: string, locus: any, meeting: any) {
88
+ const {DESYNC, USE_CURRENT, USE_INCOMING} = LocusDeltaParser.loci;
89
+
90
+ switch (action) {
91
+ case USE_INCOMING:
92
+ meeting.locusInfo.onDeltaLocus(locus);
93
+ break;
94
+ case USE_CURRENT:
95
+ meeting.locusDesync = false;
96
+ meeting.needToGetFullLocus = false;
97
+ break;
98
+ case DESYNC:
99
+ meeting.meetingRequest
100
+ .getFullLocus({
101
+ desync: true,
102
+ locusUrl: meeting.locusUrl,
103
+ })
104
+ .then((res) => {
105
+ meeting.locusInfo.onFullLocus(res.body);
106
+ // Notify parser to resume processing delta events
107
+ // now that we have full locus from DESYNC.
108
+ this.locusParser.resume();
109
+ });
110
+ break;
111
+ default:
112
+ LoggerProxy.logger.info(
113
+ `Locus-info:index#applyLocusDeltaData --> Unknown locus delta action: ${action}`
114
+ );
115
+ }
116
+ }
117
+
118
+ /**
119
+ * Adds locus delta to parser's queue
120
+ * and registers a function handler
121
+ * to recieve parsed actions from queue.
122
+ * @param {Locus} locus
123
+ * @param {Meeting} meeting
124
+ * @returns {undefined}
125
+ */
126
+ handleLocusDelta(locus: any, meeting: any) {
127
+ // register a function to process delta actions
128
+ if (!this.locusParser.onDeltaAction) {
129
+ // delta action, along with associated loci
130
+ // is passed into the function.
131
+ this.locusParser.onDeltaAction = (action, parsedLoci) => {
132
+ this.applyLocusDeltaData(action, parsedLoci, meeting);
133
+ };
134
+ }
135
+ // queue delta event with parser
136
+ this.locusParser.onDeltaEvent(locus);
137
+ }
138
+
139
+ /**
140
+ * @param {Locus} locus
141
+ * @returns {undefined}
142
+ * @memberof LocusInfo
143
+ */
144
+ init(locus: any = {}) {
145
+ this.created = locus.created || null;
146
+ this.scheduledMeeting = locus.meeting || null;
147
+ this.participantsUrl = locus.participantsUrl || null;
148
+ this.replaces = locus.replaces || null;
149
+ this.aclUrl = locus.aclUrl || null;
150
+ this.baseSequence = locus.baseSequence || null;
151
+ this.sequence = locus.sequence || null;
152
+ this.membership = locus.membership || null;
153
+ this.identities = locus.identities || null;
154
+ this.participants = locus.participants || null;
155
+
156
+ /**
157
+ * Stores the delta values for a changed participant.
158
+ *
159
+ * @typedef {Object} DeltaParticipant
160
+ * @property {Record<string, boolean>} delta - Contains changed streams.
161
+ * @property {Object} person - Contains person data.
162
+ */
163
+
164
+ /**
165
+ * Stored participant changes between the last event and the current event.
166
+ * All previously stored events are overwritten between events.
167
+ *
168
+ * @instance
169
+ * @type {Array<DeltaParticipant>}
170
+ * @private
171
+ * @member LocusInfo
172
+ */
173
+ this.deltaParticipants = [];
174
+
175
+ // above section only updates the locusInfo object
176
+ // The below section makes sure it updates the locusInfo as well as updates the meeting object
177
+ this.updateParticipants(locus.participants);
178
+ // For 1:1 space meeting the conversation Url does not exist in locus.conversation
179
+ this.updateConversationUrl(locus.conversationUrl, locus.info);
180
+ this.updateControls(locus.controls);
181
+ this.updateLocusUrl(locus.url);
182
+ this.updateFullState(locus.fullState);
183
+ this.updateMeetingInfo(locus.info);
184
+ this.updateEmbeddedApps(locus.embeddedApps);
185
+ // self and participants generate sipUrl for 1:1 meeting
186
+ this.updateSelf(locus.self, locus.participants);
187
+ this.updateHostInfo(locus.host);
188
+ this.updateMediaShares(locus.mediaShares);
189
+ this.updateServices(locus.links?.services);
190
+ }
191
+
192
+ /**
193
+ * @param {Object} locus
194
+ * @returns {undefined}
195
+ * @memberof LocusInfo
196
+ */
197
+ initialSetup(locus: object) {
198
+ this.onFullLocus(locus);
199
+
200
+ // Change it to true after it receives it first locus object
201
+ this.emitChange = true;
202
+ }
203
+
204
+ /**
205
+ * @param {Meeting} meeting
206
+ * @param {Object} data
207
+ * @returns {undefined}
208
+ * @memberof LocusInfo
209
+ */
210
+ parse(meeting: any, data: any) {
211
+ // eslint-disable-next-line @typescript-eslint/no-shadow
212
+ const {eventType} = data;
213
+
214
+ LoggerProxy.logger.info(`Locus-info:index#parse --> received locus data: ${eventType}`);
215
+
216
+ switch (eventType) {
217
+ case LOCUSEVENT.PARTICIPANT_JOIN:
218
+ case LOCUSEVENT.PARTICIPANT_LEFT:
219
+ case LOCUSEVENT.CONTROLS_UPDATED:
220
+ case LOCUSEVENT.PARTICIPANT_AUDIO_MUTED:
221
+ case LOCUSEVENT.PARTICIPANT_AUDIO_UNMUTED:
222
+ case LOCUSEVENT.PARTICIPANT_VIDEO_MUTED:
223
+ case LOCUSEVENT.PARTICIPANT_VIDEO_UNMUTED:
224
+ case LOCUSEVENT.SELF_CHANGED:
225
+ case LOCUSEVENT.PARTICIPANT_UPDATED:
226
+ case LOCUSEVENT.PARTICIPANT_CONTROLS_UPDATED:
227
+ case LOCUSEVENT.PARTICIPANT_ROLES_UPDATED:
228
+ case LOCUSEVENT.PARTICIPANT_DECLINED:
229
+ case LOCUSEVENT.FLOOR_GRANTED:
230
+ case LOCUSEVENT.FLOOR_RELEASED:
231
+ this.onFullLocus(data.locus, eventType);
232
+ break;
233
+ case LOCUSEVENT.DIFFERENCE:
234
+ this.handleLocusDelta(data.locus, meeting);
235
+ break;
236
+
237
+ default:
238
+ // Why will there be a event with no eventType ????
239
+ // we may not need this, we can get full locus
240
+ this.handleLocusDelta(data.locus, meeting);
241
+ }
242
+ }
243
+
244
+ /**
245
+ * @param {String} scope
246
+ * @param {String} eventName
247
+ * @param {Array} args
248
+ * @returns {undefined}
249
+ * @memberof LocusInfo
250
+ */
251
+ emitScoped(scope?: any, eventName?: string, args?: any) {
252
+ return this.emit(scope, eventName, args);
253
+ }
254
+
255
+ /**
256
+ * updates the locus with full locus object
257
+ * @param {object} locus locus object
258
+ * @param {string} eventType particulat locus event
259
+ * @returns {object} null
260
+ * @memberof LocusInfo
261
+ */
262
+ // eslint-disable-next-line @typescript-eslint/no-shadow
263
+ onFullLocus(locus: any, eventType?: string) {
264
+ if (!locus) {
265
+ LoggerProxy.logger.error(
266
+ 'Locus-info:index#onFullLocus --> object passed as argument was invalid, continuing.'
267
+ );
268
+ }
269
+ this.updateParticipantDeltas(locus.participants);
270
+ this.scheduledMeeting = locus.meeting || null;
271
+ this.participants = locus.participants;
272
+ this.updateLocusInfo(locus);
273
+ this.updateParticipants(locus.participants);
274
+ this.isMeetingActive();
275
+ this.handleOneOnOneEvent(eventType);
276
+ this.updateEmbeddedApps(locus.embeddedApps);
277
+ // set current (working copy) for parser
278
+ this.locusParser.workingCopy = locus;
279
+ }
280
+
281
+ // used for ringing stops on one on one
282
+ /**
283
+ * @param {String} eventType
284
+ * @returns {undefined}
285
+ * @memberof LocusInfo
286
+ */
287
+ // eslint-disable-next-line @typescript-eslint/no-shadow
288
+ handleOneOnOneEvent(eventType: string) {
289
+ if (
290
+ this.parsedLocus.fullState.type === _CALL_ ||
291
+ this.parsedLocus.fullState.type === _SIP_BRIDGE_
292
+ ) {
293
+ // for 1:1 bob calls alice and alice declines, notify the meeting state
294
+ if (eventType === LOCUSEVENT.PARTICIPANT_DECLINED) {
295
+ // trigger the event for stop ringing
296
+ this.emitScoped(
297
+ {
298
+ file: 'locus-info',
299
+ function: 'handleOneonOneEvent',
300
+ },
301
+ EVENTS.REMOTE_RESPONSE,
302
+ {
303
+ remoteDeclined: true,
304
+ remoteAnswered: false,
305
+ }
306
+ );
307
+ }
308
+ // for 1:1 bob calls alice and alice answers, notify the meeting state
309
+ if (eventType === LOCUSEVENT.PARTICIPANT_JOIN) {
310
+ // trigger the event for stop ringing
311
+ this.emitScoped(
312
+ {
313
+ file: 'locus-info',
314
+ function: 'handleOneonOneEvent',
315
+ },
316
+ EVENTS.REMOTE_RESPONSE,
317
+ {
318
+ remoteDeclined: false,
319
+ remoteAnswered: true,
320
+ }
321
+ );
322
+ }
323
+ }
324
+ }
325
+
326
+ /**
327
+ * @param {Object} locus
328
+ * @returns {undefined}
329
+ * @memberof LocusInfo
330
+ */
331
+ onDeltaLocus(locus: any) {
332
+ this.updateLocusInfo(locus);
333
+ this.updateParticipants(locus.participants);
334
+ this.isMeetingActive();
335
+ }
336
+
337
+ /**
338
+ * @param {Object} locus
339
+ * @returns {undefined}
340
+ * @memberof LocusInfo
341
+ */
342
+ updateLocusInfo(locus: any) {
343
+ this.updateControls(locus.controls);
344
+ this.updateConversationUrl(locus.conversationUrl, locus.info);
345
+ this.updateCreated(locus.created);
346
+ this.updateFullState(locus.fullState);
347
+ this.updateHostInfo(locus.host);
348
+ this.updateMeetingInfo(locus.info, locus.self);
349
+ this.updateMediaShares(locus.mediaShares);
350
+ this.updateParticipantsUrl(locus.participantsUrl);
351
+ this.updateReplace(locus.replace);
352
+ this.updateSelf(locus.self, locus.participants);
353
+ this.updateLocusUrl(locus.url);
354
+ this.updateAclUrl(locus.aclUrl);
355
+ this.updateBasequence(locus.baseSequence);
356
+ this.updateSequence(locus.sequence);
357
+ this.updateMemberShip(locus.membership);
358
+ this.updateIdentifiers(locus.identities);
359
+ this.updateEmbeddedApps(locus.embeddedApps);
360
+ this.updateServices(locus.links?.services);
361
+ this.compareAndUpdate();
362
+ // update which required to compare different objects from locus
363
+ }
364
+
365
+ /**
366
+ * @param {Array} participants
367
+ * @param {Object} self
368
+ * @returns {Array}
369
+ * @memberof LocusInfo
370
+ */
371
+ getLocusPartner(participants: Array<any>, self: any) {
372
+ if (!participants || participants.length === 0) {
373
+ return null;
374
+ }
375
+
376
+ return (
377
+ participants.find(
378
+ (participant) =>
379
+ self &&
380
+ participant.identity !== self.identity &&
381
+ (participants.length <= 2 || (participant.type === _USER_ && !participant.removed))
382
+ // @ts-ignore
383
+ ) || this.partner
384
+ );
385
+ }
386
+
387
+ // TODO: all the leave states need to be checked
388
+ /**
389
+ * @returns {undefined}
390
+ * @memberof LocusInfo
391
+ */
392
+ isMeetingActive() {
393
+ if (
394
+ this.parsedLocus.fullState.type === _CALL_ ||
395
+ this.parsedLocus.fullState.type === _SIP_BRIDGE_
396
+ ) {
397
+ // @ts-ignore
398
+ const partner = this.getLocusPartner(this.participants, this.self);
399
+
400
+ this.updateMeeting({partner});
401
+
402
+ // Check if guest user needs to be checked here
403
+
404
+ // 1) when bob declines call from bob, (bob='DECLINED')
405
+ // 2) When alice rejects call to bob , (bob='NOTIFIED')
406
+
407
+ // When we dont add MEDIA for condition 2. The state of bob='IDLE'
408
+
409
+ if (this.fullState && this.fullState.state === LOCUS.STATE.INACTIVE) {
410
+ // TODO: update the meeting state
411
+ LoggerProxy.logger.warn(
412
+ 'Locus-info:index#isMeetingActive --> Call Ended, locus state is inactive.'
413
+ );
414
+ Metrics.postEvent({
415
+ event: eventType.REMOTE_ENDED,
416
+ meetingId: this.meetingId,
417
+ });
418
+ this.emitScoped(
419
+ {
420
+ file: 'locus-info',
421
+ function: 'isMeetingActive',
422
+ },
423
+ EVENTS.DESTROY_MEETING,
424
+ {
425
+ reason: CALL_REMOVED_REASON.CALL_INACTIVE,
426
+ shouldLeave: false,
427
+ }
428
+ );
429
+ } else if (
430
+ partner.state === MEETING_STATE.STATES.LEFT &&
431
+ this.parsedLocus.self &&
432
+ (this.parsedLocus.self.state === MEETING_STATE.STATES.DECLINED ||
433
+ this.parsedLocus.self.state === MEETING_STATE.STATES.NOTIFIED ||
434
+ this.parsedLocus.self.state === MEETING_STATE.STATES.JOINED)
435
+ ) {
436
+ Metrics.postEvent({
437
+ event: eventType.REMOTE_ENDED,
438
+ meetingId: this.meetingId,
439
+ });
440
+ this.emitScoped(
441
+ {
442
+ file: 'locus-info',
443
+ function: 'isMeetingActive',
444
+ },
445
+ EVENTS.DESTROY_MEETING,
446
+ {
447
+ reason: CALL_REMOVED_REASON.PARTNER_LEFT,
448
+ shouldLeave:
449
+ this.parsedLocus.self.joinedWith && this.parsedLocus.self.joinedWith.state !== _LEFT_,
450
+ }
451
+ );
452
+ } else if (
453
+ this.parsedLocus.self &&
454
+ this.parsedLocus.self.state === MEETING_STATE.STATES.LEFT &&
455
+ (partner.state === MEETING_STATE.STATES.LEFT ||
456
+ partner.state === MEETING_STATE.STATES.DECLINED ||
457
+ partner.state === MEETING_STATE.STATES.NOTIFIED ||
458
+ partner.state === MEETING_STATE.STATES.IDLE) // Happens when user just joins and adds no Media
459
+ ) {
460
+ Metrics.postEvent({
461
+ event: eventType.REMOTE_ENDED,
462
+ meetingId: this.meetingId,
463
+ });
464
+ this.emitScoped(
465
+ {
466
+ file: 'locus-info',
467
+ function: 'isMeetingActive',
468
+ },
469
+ EVENTS.DESTROY_MEETING,
470
+ {
471
+ reason: CALL_REMOVED_REASON.SELF_LEFT,
472
+ shouldLeave: false,
473
+ }
474
+ );
475
+ }
476
+ } else if (this.parsedLocus.fullState.type === _MEETING_) {
477
+ if (
478
+ this.fullState &&
479
+ (this.fullState.state === LOCUS.STATE.INACTIVE ||
480
+ // @ts-ignore
481
+ this.fullState.state === LOCUS.STATE.TERMINATING)
482
+ ) {
483
+ LoggerProxy.logger.warn(
484
+ 'Locus-info:index#isMeetingActive --> Meeting is ending due to inactive or terminating'
485
+ );
486
+ Metrics.postEvent({
487
+ event: eventType.REMOTE_ENDED,
488
+ meetingId: this.meetingId,
489
+ });
490
+ this.emitScoped(
491
+ {
492
+ file: 'locus-info',
493
+ function: 'isMeetingActive',
494
+ },
495
+ EVENTS.DESTROY_MEETING,
496
+ {
497
+ reason: MEETING_REMOVED_REASON.MEETING_INACTIVE_TERMINATING,
498
+ shouldLeave: false,
499
+ }
500
+ );
501
+ } else if (this.fullState && this.fullState.removed) {
502
+ // user has been dropped from a meeting
503
+ Metrics.postEvent({
504
+ event: eventType.REMOTE_ENDED,
505
+ meetingId: this.meetingId,
506
+ });
507
+ this.emitScoped(
508
+ {
509
+ file: 'locus-info',
510
+ function: 'isMeetingActive',
511
+ },
512
+ EVENTS.DESTROY_MEETING,
513
+ {
514
+ reason: MEETING_REMOVED_REASON.FULLSTATE_REMOVED,
515
+ shouldLeave: false,
516
+ }
517
+ );
518
+ }
519
+ // If you are guest and you are removed from the meeting
520
+ // You wont get any further events
521
+ else if (this.parsedLocus.self && this.parsedLocus.self.removed) {
522
+ // Check if we need to send an event
523
+ this.emitScoped(
524
+ {
525
+ file: 'locus-info',
526
+ function: 'isMeetingActive',
527
+ },
528
+ EVENTS.DESTROY_MEETING,
529
+ {
530
+ reason: MEETING_REMOVED_REASON.SELF_REMOVED,
531
+ shouldLeave: false,
532
+ }
533
+ );
534
+ }
535
+ } else {
536
+ LoggerProxy.logger.warn('Locus-info:index#isMeetingActive --> Meeting Type is unknown.');
537
+ }
538
+ }
539
+
540
+ /**
541
+ * checks if the host permissions have changed while in the meeting
542
+ * This would be the case if your role as host or moderator has been updated
543
+ * @returns {undefined}
544
+ * @memberof LocusInfo
545
+ */
546
+ compareAndUpdate() {
547
+ // TODO: check with locus team on host and moderator doc
548
+ // use host as a validator if needed
549
+ if (
550
+ this.compareAndUpdateFlags.compareSelfAndHost ||
551
+ this.compareAndUpdateFlags.compareHostAndSelf
552
+ ) {
553
+ this.compareSelfAndHost();
554
+ }
555
+ }
556
+
557
+ /**
558
+ * compared the self object to check if the user has host permissions
559
+ * @returns {undefined}
560
+ * @memberof LocusInfo
561
+ */
562
+ compareSelfAndHost() {
563
+ // In some cases the host info is not present but the moderator values changes from null to false so it triggers an update
564
+ if (
565
+ this.parsedLocus.self.selfIdentity === this.parsedLocus.host?.hostId &&
566
+ this.parsedLocus.self.moderator
567
+ ) {
568
+ this.emitScoped(
569
+ {
570
+ file: 'locus-info',
571
+ function: 'compareSelfAndHost',
572
+ },
573
+ EVENTS.LOCUS_INFO_CAN_ASSIGN_HOST,
574
+ {
575
+ canAssignHost: true,
576
+ }
577
+ );
578
+ } else {
579
+ this.emitScoped(
580
+ {
581
+ file: 'locus-info',
582
+ function: 'compareSelfAndHost',
583
+ },
584
+ EVENTS.LOCUS_INFO_CAN_ASSIGN_HOST,
585
+ {
586
+ canAssignHost: false,
587
+ }
588
+ );
589
+ }
590
+ }
591
+
592
+ /**
593
+ * Update the deltaParticipants property of this object based on a list of
594
+ * provided participants.
595
+ *
596
+ * @param {Array} [participants] - The participants to update against.
597
+ * @returns {void}
598
+ */
599
+ updateParticipantDeltas(participants: Array<any> = []) {
600
+ // Used to find a participant within a participants collection.
601
+ const findParticipant = (participant, collection) =>
602
+ collection.find((item) => item.person.id === participant.person.id);
603
+
604
+ // Generates an object that indicates which state properties have changed.
605
+ const generateDelta = (prevState: any = {}, newState: any = {}) => {
606
+ // Setup deltas.
607
+ const deltas = {
608
+ audioStatus: prevState.audioStatus !== newState.audioStatus,
609
+ videoSlidesStatus: prevState.videoSlidesStatus !== newState.videoSlidesStatus,
610
+ videoStatus: prevState.videoStatus !== newState.videoStatus,
611
+ };
612
+
613
+ // Clean the object
614
+ Object.keys(deltas).forEach((key) => {
615
+ if (deltas[key] !== true) {
616
+ delete deltas[key];
617
+ }
618
+ });
619
+
620
+ return deltas;
621
+ };
622
+
623
+ this.deltaParticipants = participants.reduce((collection, participant) => {
624
+ const existingParticipant = findParticipant(participant, this.participants || []) || {};
625
+
626
+ const delta = generateDelta(existingParticipant.status, participant.status);
627
+
628
+ const changed = Object.keys(delta).length > 0;
629
+
630
+ if (changed) {
631
+ collection.push({
632
+ person: participant.person,
633
+ delta,
634
+ });
635
+ }
636
+
637
+ return collection;
638
+ }, []);
639
+ }
640
+
641
+ /**
642
+ *
643
+ * @param {Object} participants new participants object
644
+ * @param {boolen} deltaParticpantFlag delta event
645
+ * @returns {Array} updatedParticipants
646
+ * @memberof LocusInfo
647
+ */
648
+ updateParticipants(participants: object) {
649
+ this.emitScoped(
650
+ {
651
+ file: 'locus-info',
652
+ function: 'updateParticipants',
653
+ },
654
+ EVENTS.LOCUS_INFO_UPDATE_PARTICIPANTS,
655
+ {
656
+ participants,
657
+ recordingId: this.parsedLocus.controls && this.parsedLocus.controls.record?.modifiedBy,
658
+ selfIdentity: this.parsedLocus.self && this.parsedLocus.self.selfIdentity,
659
+ selfId: this.parsedLocus.self && this.parsedLocus.self.selfId,
660
+ hostId: this.parsedLocus.host && this.parsedLocus.host.hostId,
661
+ }
662
+ );
663
+ }
664
+
665
+ /**
666
+ * @param {Object} controls
667
+ * @returns {undefined}
668
+ * @memberof LocusInfo
669
+ */
670
+ updateControls(controls: object) {
671
+ if (controls && !isEqual(this.controls, controls)) {
672
+ this.parsedLocus.controls = ControlsUtils.parse(controls);
673
+ const {
674
+ updates: {
675
+ hasRecordingChanged,
676
+ hasRecordingPausedChanged,
677
+ hasMeetingContainerChanged,
678
+ hasTranscribeChanged,
679
+ hasEntryExitToneChanged,
680
+ },
681
+ current,
682
+ } = ControlsUtils.getControls(this.controls, controls);
683
+
684
+ if (hasRecordingChanged || hasRecordingPausedChanged) {
685
+ let state = null;
686
+
687
+ if (hasRecordingPausedChanged) {
688
+ if (current.record.paused) {
689
+ state = RECORDING_STATE.PAUSED;
690
+ } else {
691
+ // state will be `IDLE` if the recording is not active, even when there is a `pause` status change.
692
+ state = current.record.recording ? RECORDING_STATE.RESUMED : RECORDING_STATE.IDLE;
693
+ }
694
+ } else if (hasRecordingChanged) {
695
+ state = current.record.recording ? RECORDING_STATE.RECORDING : RECORDING_STATE.IDLE;
696
+ }
697
+
698
+ this.emitScoped(
699
+ {
700
+ file: 'locus-info',
701
+ function: 'updateControls',
702
+ },
703
+ LOCUSINFO.EVENTS.CONTROLS_RECORDING_UPDATED,
704
+ {
705
+ state,
706
+ modifiedBy: current.record.modifiedBy,
707
+ lastModified: current.record.lastModified,
708
+ }
709
+ );
710
+ }
711
+
712
+ if (hasMeetingContainerChanged) {
713
+ const {meetingContainerUrl} = current.meetingContainer;
714
+
715
+ this.emitScoped(
716
+ {
717
+ file: 'locus-info',
718
+ function: 'updateControls',
719
+ },
720
+ LOCUSINFO.EVENTS.CONTROLS_MEETING_CONTAINER_UPDATED,
721
+ {
722
+ meetingContainerUrl,
723
+ }
724
+ );
725
+ }
726
+
727
+ if (hasTranscribeChanged) {
728
+ const {transcribing, caption} = current.transcribe;
729
+
730
+ this.emitScoped(
731
+ {
732
+ file: 'locus-info',
733
+ function: 'updateControls',
734
+ },
735
+ LOCUSINFO.EVENTS.CONTROLS_MEETING_TRANSCRIBE_UPDATED,
736
+ {
737
+ transcribing,
738
+ caption,
739
+ }
740
+ );
741
+ }
742
+
743
+ if (hasEntryExitToneChanged) {
744
+ const {entryExitTone} = current;
745
+
746
+ this.emitScoped(
747
+ {
748
+ file: 'locus-info',
749
+ function: 'updateControls',
750
+ },
751
+ LOCUSINFO.EVENTS.CONTROLS_ENTRY_EXIT_TONE_UPDATED,
752
+ {
753
+ entryExitTone,
754
+ }
755
+ );
756
+
757
+ this.updateMeeting({entryExitTone});
758
+ }
759
+
760
+ this.controls = controls;
761
+ }
762
+ }
763
+
764
+ /**
765
+ * @param {String} conversationUrl
766
+ * @param {Object} info
767
+ * @returns {undefined}
768
+ * @memberof LocusInfo
769
+ */
770
+ updateConversationUrl(conversationUrl: string, info: any) {
771
+ if (conversationUrl && !isEqual(this.conversationUrl, conversationUrl)) {
772
+ this.conversationUrl = conversationUrl;
773
+ this.updateMeeting({conversationUrl});
774
+ } else if (
775
+ info &&
776
+ info.conversationUrl &&
777
+ !isEqual(this.conversationUrl, info.conversationUrl)
778
+ ) {
779
+ this.conversationUrl = info.conversationUrl;
780
+ this.updateMeeting({conversationUrl: info.conversationUrl});
781
+ }
782
+ }
783
+
784
+ /**
785
+ * @param {Object} created
786
+ * @returns {undefined}
787
+ * @memberof LocusInfo
788
+ */
789
+ updateCreated(created: object) {
790
+ if (created && !isEqual(this.created, created)) {
791
+ this.created = created;
792
+ }
793
+ }
794
+
795
+ /**
796
+ * @param {Object} services
797
+ * @returns {undefined}
798
+ * @memberof LocusInfo
799
+ */
800
+ updateServices(services: Record<'breakout' | 'record', {url: string}>) {
801
+ if (services && !isEqual(this.services, services)) {
802
+ this.services = services;
803
+ this.emitScoped(
804
+ {
805
+ file: 'locus-info',
806
+ function: 'updateServices',
807
+ },
808
+ LOCUSINFO.EVENTS.LINKS_SERVICES,
809
+ {
810
+ services,
811
+ }
812
+ );
813
+ }
814
+ }
815
+
816
+ /**
817
+ * @param {Object} fullState
818
+ * @returns {undefined}
819
+ * @memberof LocusInfo
820
+ */
821
+ updateFullState(fullState: object) {
822
+ if (fullState && !isEqual(this.fullState, fullState)) {
823
+ const result = FullState.getFullState(this.fullState, fullState);
824
+
825
+ this.updateMeeting(result.current);
826
+
827
+ if (result.updates.meetingStateChangedTo) {
828
+ this.emitScoped(
829
+ {
830
+ file: 'locus-info',
831
+ function: 'updateFullState',
832
+ },
833
+ LOCUSINFO.EVENTS.FULL_STATE_MEETING_STATE_CHANGE,
834
+ {
835
+ previousState: result.previous && result.previous.meetingState,
836
+ currentState: result.current.meetingState,
837
+ }
838
+ );
839
+ }
840
+
841
+ if (result.updates.meetingTypeChangedTo) {
842
+ this.emitScoped(
843
+ {
844
+ file: 'locus-info',
845
+ function: 'updateFullState',
846
+ },
847
+ LOCUSINFO.EVENTS.FULL_STATE_TYPE_UPDATE,
848
+ {
849
+ type: result.current.type,
850
+ }
851
+ );
852
+ }
853
+ this.parsedLocus.fullState = result.current;
854
+ this.fullState = fullState;
855
+ }
856
+ }
857
+
858
+ /**
859
+ * handles when the locus.host is updated
860
+ * @param {Object} host the locus.host property
861
+ * @returns {undefined}
862
+ * @memberof LocusInfo
863
+ * emits internal event locus_info_update_host
864
+ */
865
+ updateHostInfo(host: object) {
866
+ if (host && !isEqual(this.host, host)) {
867
+ const parsedHosts = HostUtils.getHosts(this.host, host);
868
+
869
+ this.updateMeeting(parsedHosts.current);
870
+ this.parsedLocus.host = parsedHosts.current;
871
+ if (parsedHosts.updates.isNewHost) {
872
+ this.compareAndUpdateFlags.compareSelfAndHost = true;
873
+ this.emitScoped(
874
+ {
875
+ file: 'locus-info',
876
+ function: 'updateHostInfo',
877
+ },
878
+ EVENTS.LOCUS_INFO_UPDATE_HOST,
879
+ {
880
+ newHost: parsedHosts.current,
881
+ oldHost: parsedHosts.previous,
882
+ }
883
+ );
884
+ }
885
+ this.host = host;
886
+ } else {
887
+ this.compareAndUpdateFlags.compareSelfAndHost = false;
888
+ }
889
+ }
890
+
891
+ /**
892
+ * @param {Object} info
893
+ * @param {Object} self
894
+ * @returns {undefined}
895
+ * @memberof LocusInfo
896
+ */
897
+ updateMeetingInfo(info: object, self?: object) {
898
+ if (info && !isEqual(this.info, info)) {
899
+ const roles = self ? SelfUtils.getRoles(self) : this.parsedLocus.self?.roles || [];
900
+ const isJoined = SelfUtils.isJoined(self || this.parsedLocus.self);
901
+ const parsedInfo = InfoUtils.getInfos(this.parsedLocus.info, info, roles, isJoined);
902
+
903
+ this.emitScoped(
904
+ {
905
+ file: 'locus-info',
906
+ function: 'updateMeetingInfo',
907
+ },
908
+ LOCUSINFO.EVENTS.MEETING_INFO_UPDATED,
909
+ {info: parsedInfo.current, self}
910
+ );
911
+
912
+ if (parsedInfo.updates.isLocked) {
913
+ this.emitScoped(
914
+ {
915
+ file: 'locus-info',
916
+ function: 'updateMeetingInfo',
917
+ },
918
+ LOCUSINFO.EVENTS.MEETING_LOCKED,
919
+ info
920
+ );
921
+ }
922
+ if (parsedInfo.updates.isUnlocked) {
923
+ this.emitScoped(
924
+ {
925
+ file: 'locus-info',
926
+ function: 'updateMeetingInfo',
927
+ },
928
+ LOCUSINFO.EVENTS.MEETING_UNLOCKED,
929
+ info
930
+ );
931
+ }
932
+
933
+ this.info = info;
934
+ this.parsedLocus.info = parsedInfo.current;
935
+ // Parses the info and adds necessary values
936
+ this.updateMeeting(parsedInfo.current);
937
+ }
938
+ }
939
+
940
+ /**
941
+ * @param {Object} embeddedApps
942
+ * @returns {undefined}
943
+ * @memberof LocusInfo
944
+ */
945
+ updateEmbeddedApps(embeddedApps: object) {
946
+ // don't do anything if the arrays of apps haven't changed significantly
947
+ if (EmbeddedAppsUtils.areSimilar(this.embeddedApps, embeddedApps)) {
948
+ return;
949
+ }
950
+
951
+ const parsedEmbeddedApps = EmbeddedAppsUtils.parse(embeddedApps);
952
+
953
+ this.updateMeeting({embeddedApps: parsedEmbeddedApps});
954
+
955
+ this.emitScoped(
956
+ {
957
+ file: 'locus-info',
958
+ function: 'updateEmbeddedApps',
959
+ },
960
+ LOCUSINFO.EVENTS.EMBEDDED_APPS_UPDATED,
961
+ parsedEmbeddedApps
962
+ );
963
+ this.embeddedApps = embeddedApps;
964
+ }
965
+
966
+ /**
967
+ * handles when the locus.mediaShares is updated
968
+ * @param {Object} mediaShares the locus.mediaShares property
969
+ * @returns {undefined}
970
+ * @memberof LocusInfo
971
+ * emits internal event locus_info_update_media_shares
972
+ */
973
+ updateMediaShares(mediaShares: object) {
974
+ if (mediaShares && !isEqual(this.mediaShares, mediaShares)) {
975
+ const parsedMediaShares = MediaSharesUtils.getMediaShares(this.mediaShares, mediaShares);
976
+
977
+ this.updateMeeting(parsedMediaShares.current);
978
+ this.emitScoped(
979
+ {
980
+ file: 'locus-info',
981
+ function: 'updateMediaShares',
982
+ },
983
+ EVENTS.LOCUS_INFO_UPDATE_MEDIA_SHARES,
984
+ {
985
+ current: parsedMediaShares.current,
986
+ previous: parsedMediaShares.previous,
987
+ }
988
+ );
989
+ this.parsedLocus.mediaShares = parsedMediaShares.current;
990
+ this.mediaShares = mediaShares;
991
+ }
992
+ }
993
+
994
+ /**
995
+ * @param {String} participantsUrl
996
+ * @returns {undefined}
997
+ * @memberof LocusInfo
998
+ */
999
+ updateParticipantsUrl(participantsUrl: string) {
1000
+ if (participantsUrl && !isEqual(this.participantsUrl, participantsUrl)) {
1001
+ this.participantsUrl = participantsUrl;
1002
+ }
1003
+ }
1004
+
1005
+ /**
1006
+ * @param {Object} replace
1007
+ * @returns {undefined}
1008
+ * @memberof LocusInfo
1009
+ */
1010
+ updateReplace(replace: object) {
1011
+ if (replace && !isEqual(this.replace, replace)) {
1012
+ this.replace = replace;
1013
+ }
1014
+ }
1015
+
1016
+ /**
1017
+ * handles when the locus.self is updated
1018
+ * @param {Object} self the locus.mediaShares property
1019
+ * @param {Array} participants the locus.participants property
1020
+ * @returns {undefined}
1021
+ * @memberof LocusInfo
1022
+ * emits internal events self_admitted_guest, self_unadmitted_guest, locus_info_update_self
1023
+ */
1024
+ updateSelf(self: any, participants: Array<any>) {
1025
+ // @ts-ignore - check where this.self come from
1026
+ if (self && !isEqual(this.self, self)) {
1027
+ // @ts-ignore
1028
+ const parsedSelves = SelfUtils.getSelves(this.self, self, this.webex.internal.device.url);
1029
+
1030
+ this.updateMeeting(parsedSelves.current);
1031
+ this.parsedLocus.self = parsedSelves.current;
1032
+
1033
+ const element = this.parsedLocus.states[this.parsedLocus.states.length - 1];
1034
+
1035
+ if (element !== parsedSelves.current.state) {
1036
+ this.parsedLocus.states.push(parsedSelves.current.state);
1037
+ }
1038
+
1039
+ // TODO: check if we need to save the sipUri here as well
1040
+ // this.emit(LOCUSINFO.EVENTS.MEETING_UPDATE, SelfUtils.getSipUrl(this.getLocusPartner(participants, self), this.parsedLocus.fullState.type, this.parsedLocus.info.sipUri));
1041
+ const result = SelfUtils.getSipUrl(
1042
+ this.getLocusPartner(participants, self),
1043
+ this.parsedLocus.fullState.type,
1044
+ this.parsedLocus.info.sipUri
1045
+ );
1046
+
1047
+ if (result.sipUri) {
1048
+ this.updateMeeting(result);
1049
+ }
1050
+
1051
+ if (parsedSelves.updates.moderatorChanged) {
1052
+ this.compareAndUpdateFlags.compareHostAndSelf = true;
1053
+ } else {
1054
+ this.compareAndUpdateFlags.compareHostAndSelf = false;
1055
+ }
1056
+
1057
+ if (parsedSelves.updates.layoutChanged) {
1058
+ this.emitScoped(
1059
+ {
1060
+ file: 'locus-info',
1061
+ function: 'updateSelf',
1062
+ },
1063
+ LOCUSINFO.EVENTS.CONTROLS_MEETING_LAYOUT_UPDATED,
1064
+ {layout: parsedSelves.current.layout}
1065
+ );
1066
+ }
1067
+
1068
+ if (parsedSelves.updates.isMediaInactiveOrReleased) {
1069
+ this.emitScoped(
1070
+ {
1071
+ file: 'locus-info',
1072
+ function: 'updateSelf',
1073
+ },
1074
+ LOCUSINFO.EVENTS.DISCONNECT_DUE_TO_INACTIVITY,
1075
+ {reason: self.reason}
1076
+ );
1077
+ }
1078
+
1079
+ if (parsedSelves.updates.moderatorChanged) {
1080
+ this.emitScoped(
1081
+ {
1082
+ file: 'locus-info',
1083
+ function: 'updateSelf',
1084
+ },
1085
+ LOCUSINFO.EVENTS.SELF_MODERATOR_CHANGED,
1086
+ self
1087
+ );
1088
+ }
1089
+ if (parsedSelves.updates.localAudioUnmuteRequiredByServer) {
1090
+ this.emitScoped(
1091
+ {
1092
+ file: 'locus-info',
1093
+ function: 'updateSelf',
1094
+ },
1095
+ LOCUSINFO.EVENTS.LOCAL_UNMUTE_REQUIRED,
1096
+ {
1097
+ muted: parsedSelves.current.remoteMuted,
1098
+ unmuteAllowed: parsedSelves.current.unmuteAllowed,
1099
+ }
1100
+ );
1101
+ }
1102
+ if (parsedSelves.updates.isMutedByOthersChanged) {
1103
+ this.emitScoped(
1104
+ {
1105
+ file: 'locus-info',
1106
+ function: 'updateSelf',
1107
+ },
1108
+ LOCUSINFO.EVENTS.SELF_REMOTE_MUTE_STATUS_UPDATED,
1109
+ {
1110
+ muted: parsedSelves.current.remoteMuted,
1111
+ unmuteAllowed: parsedSelves.current.unmuteAllowed,
1112
+ }
1113
+ );
1114
+ }
1115
+ if (parsedSelves.updates.localAudioUnmuteRequestedByServer) {
1116
+ this.emitScoped(
1117
+ {
1118
+ file: 'locus-info',
1119
+ function: 'updateSelf',
1120
+ },
1121
+ LOCUSINFO.EVENTS.LOCAL_UNMUTE_REQUESTED,
1122
+ {}
1123
+ );
1124
+ }
1125
+ if (parsedSelves.updates.isUserUnadmitted) {
1126
+ this.emitScoped(
1127
+ {
1128
+ file: 'locus-info',
1129
+ function: 'updateSelf',
1130
+ },
1131
+ LOCUSINFO.EVENTS.SELF_UNADMITTED_GUEST,
1132
+ self
1133
+ );
1134
+ }
1135
+ if (parsedSelves.updates.isUserAdmitted) {
1136
+ this.emitScoped(
1137
+ {
1138
+ file: 'locus-info',
1139
+ function: 'updateSelf',
1140
+ },
1141
+ LOCUSINFO.EVENTS.SELF_ADMITTED_GUEST,
1142
+ self
1143
+ );
1144
+ }
1145
+
1146
+ if (parsedSelves.updates.isMediaInactive) {
1147
+ this.emitScoped(
1148
+ {
1149
+ file: 'locus-info',
1150
+ function: 'updateSelf',
1151
+ },
1152
+ // @ts-ignore
1153
+ LOCUSINFO.EVENTS.MEDIA_INACTIVITY,
1154
+ SelfUtils.getMediaStatus(self.mediaSessions)
1155
+ );
1156
+ }
1157
+
1158
+ if (
1159
+ parsedSelves.updates.audioStateChange ||
1160
+ parsedSelves.updates.videoStateChange ||
1161
+ parsedSelves.updates.shareStateChange
1162
+ ) {
1163
+ this.emitScoped(
1164
+ {
1165
+ file: 'locus-info',
1166
+ function: 'updateSelf',
1167
+ },
1168
+ LOCUSINFO.EVENTS.MEDIA_STATUS_CHANGE,
1169
+ {
1170
+ audioStatus: parsedSelves.current.currentMediaStatus?.audio,
1171
+ videoStatus: parsedSelves.current.currentMediaStatus?.video,
1172
+ shareStatus: parsedSelves.current.currentMediaStatus?.share,
1173
+ }
1174
+ );
1175
+ }
1176
+
1177
+ if (parsedSelves.updates.isUserObserving) {
1178
+ this.emitScoped(
1179
+ {
1180
+ file: 'locus-info',
1181
+ function: 'updateSelf',
1182
+ },
1183
+ LOCUSINFO.EVENTS.SELF_OBSERVING
1184
+ );
1185
+ }
1186
+
1187
+ if (parsedSelves.updates.canNotViewTheParticipantListChanged) {
1188
+ this.emitScoped(
1189
+ {
1190
+ file: 'locus-info',
1191
+ function: 'updateSelf',
1192
+ },
1193
+ LOCUSINFO.EVENTS.SELF_CANNOT_VIEW_PARTICIPANT_LIST_CHANGE,
1194
+ {canNotViewTheParticipantList: parsedSelves.current.canNotViewTheParticipantList}
1195
+ );
1196
+ }
1197
+
1198
+ if (parsedSelves.updates.isSharingBlockedChanged) {
1199
+ this.emitScoped(
1200
+ {
1201
+ file: 'locus-info',
1202
+ function: 'updateSelf',
1203
+ },
1204
+ LOCUSINFO.EVENTS.SELF_IS_SHARING_BLOCKED_CHANGE,
1205
+ {isSharingBlocked: parsedSelves.current.isSharingBlocked}
1206
+ );
1207
+ }
1208
+
1209
+ this.emitScoped(
1210
+ {
1211
+ file: 'locus-info',
1212
+ function: 'updateSelf',
1213
+ },
1214
+ EVENTS.LOCUS_INFO_UPDATE_SELF,
1215
+ {
1216
+ oldSelf: parsedSelves.previous,
1217
+ newSelf: parsedSelves.current,
1218
+ }
1219
+ );
1220
+ this.parsedLocus.self = parsedSelves.current;
1221
+ // @ts-ignore
1222
+ this.self = self;
1223
+ } else {
1224
+ this.compareAndUpdateFlags.compareHostAndSelf = false;
1225
+ }
1226
+ }
1227
+
1228
+ /**
1229
+ * handles when the locus.url is updated
1230
+ * @param {String} url
1231
+ * @returns {undefined}
1232
+ * emits internal event locus_info_update_url
1233
+ */
1234
+ updateLocusUrl(url: string) {
1235
+ if (url && this.url !== url) {
1236
+ this.url = url;
1237
+ this.updateMeeting({locusUrl: url});
1238
+ this.emitScoped(
1239
+ {
1240
+ file: 'locus-info',
1241
+ function: 'updateLocusUrl',
1242
+ },
1243
+ EVENTS.LOCUS_INFO_UPDATE_URL,
1244
+ url
1245
+ );
1246
+ }
1247
+ }
1248
+
1249
+ /**
1250
+ * @param {String} aclUrl
1251
+ * @returns {undefined}
1252
+ * @memberof LocusInfo
1253
+ */
1254
+ updateAclUrl(aclUrl: string) {
1255
+ if (aclUrl && !isEqual(this.aclUrl, aclUrl)) {
1256
+ this.aclUrl = aclUrl;
1257
+ }
1258
+ }
1259
+
1260
+ /**
1261
+ * @param {Number} baseSequence
1262
+ * @returns {undefined}
1263
+ * @memberof LocusInfo
1264
+ */
1265
+ updateBasequence(baseSequence: number) {
1266
+ if (baseSequence && !isEqual(this.baseSequence, baseSequence)) {
1267
+ this.baseSequence = baseSequence;
1268
+ }
1269
+ }
1270
+
1271
+ /**
1272
+ * @param {Number} sequence
1273
+ * @returns {undefined}
1274
+ * @memberof LocusInfo
1275
+ */
1276
+ updateSequence(sequence: number) {
1277
+ if (sequence && !isEqual(this.sequence, sequence)) {
1278
+ this.sequence = sequence;
1279
+ }
1280
+ }
1281
+
1282
+ /**
1283
+ * @param {Object} membership
1284
+ * @returns {undefined}
1285
+ * @memberof LocusInfo
1286
+ */
1287
+ updateMemberShip(membership: object) {
1288
+ if (membership && !isEqual(this.membership, membership)) {
1289
+ this.membership = membership;
1290
+ }
1291
+ }
1292
+
1293
+ /**
1294
+ * @param {Array} identities
1295
+ * @returns {undefined}
1296
+ * @memberof LocusInfo
1297
+ */
1298
+ updateIdentifiers(identities: Array<any>) {
1299
+ if (identities && !isEqual(this.identities, identities)) {
1300
+ this.identities = identities;
1301
+ }
1302
+ }
1303
+ }