@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,430 +1,430 @@
1
- import sinon from 'sinon';
2
- import {assert} from '@webex/test-helper-chai';
3
- import MeetingUtil from '@webex/plugin-meetings/src/meeting/util';
4
- import createMuteState from '@webex/plugin-meetings/src/meeting/muteState';
5
- import Media from '@webex/plugin-meetings/src/media/index';
6
- import PermissionError from '@webex/plugin-meetings/src/common/errors/permission';
7
- import {AUDIO, VIDEO} from '@webex/plugin-meetings/src/constants';
8
-
9
- import testUtils from '../../../utils/testUtils';
10
-
11
- describe('plugin-meetings', () => {
12
- let meeting;
13
- let audio;
14
- let video;
15
-
16
- const fakeLocus = {info: 'this is a fake locus'};
17
-
18
- beforeEach(() => {
19
- meeting = {
20
- mediaProperties: {
21
- audioTrack: 'fake audio track',
22
- videoTrack: 'fake video track',
23
- },
24
- remoteMuted: false,
25
- unmuteAllowed: true,
26
- locusInfo: {
27
- onFullLocus: sinon.stub(),
28
- },
29
- members: {
30
- selfId: 'fake self id',
31
- muteMember: sinon.stub().resolves(),
32
- },
33
- };
34
- audio = createMuteState(AUDIO, meeting, {sendAudio: true});
35
- video = createMuteState(VIDEO, meeting, {sendVideo: true});
36
-
37
- MeetingUtil.remoteUpdateAudioVideo = sinon.stub().resolves(fakeLocus);
38
- Media.setLocalTrack = sinon.stub();
39
- });
40
-
41
- describe('mute state library', () => {
42
- it('does not create an audio instance if we are not sending audio', async () => {
43
- assert.isNull(createMuteState(AUDIO, meeting, {sendAudio: false}));
44
- assert.isNull(createMuteState(AUDIO, meeting, {}));
45
- });
46
-
47
- it('does not create a video instance if we are not sending video', async () => {
48
- assert.isNull(createMuteState(VIDEO, meeting, {sendVideo: false}));
49
- assert.isNull(createMuteState(VIDEO, meeting, {}));
50
- });
51
-
52
- it('takes into account current remote mute status when instantiated', async () => {
53
- // simulate being already remote muted
54
- meeting.remoteMuted = true;
55
- // create a new MuteState intance
56
- audio = createMuteState(AUDIO, meeting, {sendAudio: true});
57
-
58
- assert.isTrue(audio.isMuted());
59
- assert.isFalse(audio.isSelf());
60
-
61
- // now check the opposite case
62
- meeting.remoteMuted = false;
63
-
64
- // create a new MuteState intance
65
- audio = createMuteState(AUDIO, meeting, {sendAudio: true});
66
-
67
- assert.isFalse(audio.isMuted());
68
- assert.isFalse(audio.isSelf());
69
- });
70
-
71
- it('initialises correctly for video', async () => {
72
- // setup fields related to audio remote state
73
- meeting.remoteMuted = true;
74
- meeting.unmuteAllowed = false;
75
- // create a new video MuteState intance
76
- video = createMuteState(VIDEO, meeting, {sendVideo: true});
77
-
78
- assert.isFalse(video.isMuted());
79
- assert.isFalse(video.state.server.remoteMute);
80
- assert.isTrue(video.state.server.unmuteAllowed);
81
- });
82
-
83
- it('takes remote mute into account when reporting current state', async () => {
84
- assert.isFalse(audio.isMuted());
85
-
86
- // simulate remote mute
87
- audio.handleServerRemoteMuteUpdate(true, true);
88
-
89
- assert.isTrue(audio.isMuted());
90
- assert.isFalse(audio.isSelf());
91
- });
92
-
93
- it('does local unmute if localAudioUnmuteRequired is received', async () => {
94
- // first we need to mute
95
- await audio.handleClientRequest(meeting, true);
96
-
97
- assert.isTrue(audio.isMuted());
98
- assert.isTrue(audio.isSelf());
99
-
100
- MeetingUtil.remoteUpdateAudioVideo.resetHistory();
101
-
102
- // now simulate server requiring us to locally unmute
103
- audio.handleServerLocalUnmuteRequired(meeting);
104
- await testUtils.flushPromises();
105
-
106
- // check that local track was enabled
107
- assert.calledWith(Media.setLocalTrack, true, meeting.mediaProperties.audioTrack);
108
-
109
- // and local unmute was sent to server
110
- assert.calledOnce(MeetingUtil.remoteUpdateAudioVideo);
111
- assert.calledWith(MeetingUtil.remoteUpdateAudioVideo, false, undefined, meeting);
112
-
113
- assert.isFalse(audio.isMuted());
114
- assert.isFalse(audio.isSelf());
115
- });
116
-
117
- it('rejects client request in progress if localAudioUnmuteRequired is received', async () => {
118
- let clientPromiseResolved = false;
119
- let clientPromiseRejected = false;
120
-
121
- // first we need to mute and make that request last forever
122
- let serverResponseResolve;
123
-
124
- MeetingUtil.remoteUpdateAudioVideo = sinon.stub().returns(
125
- new Promise((resolve) => {
126
- serverResponseResolve = resolve;
127
- })
128
- );
129
-
130
- audio
131
- .handleClientRequest(meeting, true)
132
- .then(() => {
133
- clientPromiseResolved = true;
134
- })
135
- .catch(() => {
136
- clientPromiseRejected = true;
137
- });
138
-
139
- MeetingUtil.remoteUpdateAudioVideo.resetHistory();
140
-
141
- // now simulate server requiring us to locally unmute
142
- audio.handleServerLocalUnmuteRequired(meeting);
143
- await testUtils.flushPromises();
144
-
145
- // the original client request should have been rejected by now
146
- assert.isTrue(clientPromiseRejected);
147
- assert.isFalse(clientPromiseResolved);
148
-
149
- // now make the server respond to the original mute request
150
- serverResponseResolve();
151
- await testUtils.flushPromises();
152
-
153
- // local unmute should be sent to server
154
- assert.calledOnce(MeetingUtil.remoteUpdateAudioVideo);
155
- assert.calledWith(MeetingUtil.remoteUpdateAudioVideo, false, undefined, meeting);
156
-
157
- // and local track should be enabled
158
- assert.calledWith(Media.setLocalTrack, true, meeting.mediaProperties.audioTrack);
159
-
160
- assert.isFalse(audio.isMuted());
161
- assert.isFalse(audio.isSelf());
162
- });
163
-
164
- describe('#isLocallyMuted()', () => {
165
- it('does not consider remote mute status for audio', async () => {
166
- // simulate being already remote muted
167
- meeting.remoteMuted = true;
168
- // create a new MuteState intance
169
- audio = createMuteState(AUDIO, meeting, {sendAudio: true});
170
-
171
- assert.isFalse(audio.isLocallyMuted());
172
- });
173
- });
174
-
175
- describe('#handleClientRequest', () => {
176
- it('disables/enables the local audio track when audio is muted/unmuted', async () => {
177
- // mute
178
- audio.handleClientRequest(meeting, true);
179
- assert.calledWith(Media.setLocalTrack, false, meeting.mediaProperties.audioTrack);
180
-
181
- // even when calling mute when it's already muted should still call setLocalTrack
182
- audio.handleClientRequest(meeting, true);
183
- assert.calledWith(Media.setLocalTrack, false, meeting.mediaProperties.audioTrack);
184
-
185
- // unmute
186
- audio.handleClientRequest(meeting, false);
187
- assert.calledWith(Media.setLocalTrack, true, meeting.mediaProperties.audioTrack);
188
-
189
- // even when calling unmute when it's already unmuted should still call setLocalTrack
190
- audio.handleClientRequest(meeting, false);
191
- assert.calledWith(Media.setLocalTrack, true, meeting.mediaProperties.audioTrack);
192
- });
193
-
194
- it('disables/enables the local video track when video is muted/unmuted', async () => {
195
- // mute
196
- video.handleClientRequest(meeting, true);
197
- assert.calledWith(Media.setLocalTrack, false, meeting.mediaProperties.videoTrack);
198
-
199
- // even when calling mute when it's already muted should still call setLocalTrack
200
- video.handleClientRequest(meeting, false);
201
- assert.calledWith(Media.setLocalTrack, false, meeting.mediaProperties.videoTrack);
202
-
203
- // unmute
204
- video.handleClientRequest(meeting, false);
205
- assert.calledWith(Media.setLocalTrack, true, meeting.mediaProperties.videoTrack);
206
-
207
- // even when calling unmute when it's already unmuted should still call setLocalTrack
208
- video.handleClientRequest(meeting, false);
209
- assert.calledWith(Media.setLocalTrack, true, meeting.mediaProperties.videoTrack);
210
- });
211
-
212
- it('returns correct value in isMuted()/isSelf() methods after client mute/unmute requests', async () => {
213
- // mute
214
- audio.handleClientRequest(meeting, true);
215
-
216
- assert.isTrue(audio.isMuted());
217
- assert.isTrue(audio.isSelf());
218
-
219
- // unmute
220
- audio.handleClientRequest(meeting, false);
221
-
222
- assert.isFalse(audio.isMuted());
223
- assert.isFalse(audio.isSelf());
224
- });
225
-
226
- it('does remote unmute when unmuting and remote mute is on', async () => {
227
- // simulate remote mute
228
- audio.handleServerRemoteMuteUpdate(true, true);
229
-
230
- // unmute
231
- await audio.handleClientRequest(meeting, false);
232
-
233
- // check that remote unmute was sent to server
234
- assert.calledOnce(meeting.members.muteMember);
235
- assert.calledWith(meeting.members.muteMember, meeting.members.selfId, false);
236
-
237
- assert.isFalse(audio.isMuted());
238
- assert.isFalse(audio.isSelf());
239
- });
240
-
241
- it('resolves client request promise once the server is updated', async () => {
242
- let clientPromiseResolved = false;
243
-
244
- let serverResponseResolve;
245
-
246
- MeetingUtil.remoteUpdateAudioVideo = sinon.stub().returns(
247
- new Promise((resolve) => {
248
- serverResponseResolve = resolve;
249
- })
250
- );
251
-
252
- audio.handleClientRequest(meeting, true).then(() => {
253
- clientPromiseResolved = true;
254
- });
255
-
256
- // do a small delay to make sure that the client promise doesn't resolve in that time
257
- await testUtils.waitUntil(200);
258
- assert.isFalse(clientPromiseResolved);
259
-
260
- // now allow the server response to arrive, this should trigger the client promise to get resolved
261
- serverResponseResolve();
262
- await testUtils.flushPromises();
263
-
264
- assert.isTrue(clientPromiseResolved);
265
- });
266
-
267
- it('rejects client request promise if server request for local mute fails', async () => {
268
- MeetingUtil.remoteUpdateAudioVideo = sinon.stub().returns(
269
- new Promise((resolve, reject) => {
270
- reject();
271
- })
272
- );
273
-
274
- assert.isRejected(audio.handleClientRequest(meeting, true));
275
- });
276
-
277
- it('rejects client request promise if server request for remote mute fails', async () => {
278
- // we only send remote mute requests when we're unmuting, so first we need to do a remote mute
279
- audio.handleServerRemoteMuteUpdate(true, true);
280
-
281
- // setup the stub to simulate server error response
282
- meeting.members.muteMember = sinon.stub().rejects();
283
-
284
- // try to unmute - it should fail
285
- await assert.isRejected(audio.handleClientRequest(meeting, false));
286
-
287
- // even though remote mute update in the server failed, isMuted() should still return true,
288
- // because of local mute
289
- assert.isTrue(audio.isMuted());
290
- });
291
-
292
- it('does not send a server request if client state matches the server', async () => {
293
- let serverResponseResolve;
294
-
295
- MeetingUtil.remoteUpdateAudioVideo = sinon.stub().returns(
296
- new Promise((resolve) => {
297
- serverResponseResolve = resolve;
298
- })
299
- );
300
-
301
- // simulate many client requests, with the last one matching the initial one
302
- audio.handleClientRequest(meeting, true);
303
- audio.handleClientRequest(meeting, false);
304
- audio.handleClientRequest(meeting, true);
305
- audio.handleClientRequest(meeting, false);
306
- audio.handleClientRequest(meeting, true);
307
-
308
- // so far there should have been only 1 request to server (because our stub hasn't resolved yet
309
- // and MuteState sends only 1 server request at a time)
310
- assert.calledOnce(MeetingUtil.remoteUpdateAudioVideo);
311
- MeetingUtil.remoteUpdateAudioVideo.resetHistory();
312
-
313
- // now allow the server response to arrive for that initial request
314
- serverResponseResolve();
315
- await testUtils.flushPromises();
316
-
317
- // there should have not been any more server requests, because client state already matches the server state
318
- assert.notCalled(MeetingUtil.remoteUpdateAudioVideo);
319
- });
320
-
321
- it('queues up server requests when multiple client requests are received', async () => {
322
- let serverResponseResolve;
323
-
324
- MeetingUtil.remoteUpdateAudioVideo = sinon.stub().returns(
325
- new Promise((resolve) => {
326
- serverResponseResolve = resolve;
327
- })
328
- );
329
-
330
- let firstClientPromiseResolved = false;
331
- let secondClientPromiseResolved = false;
332
-
333
- // 2 client requests, one after another without waiting for first one to resolve
334
- audio.handleClientRequest(meeting, true).then(() => {
335
- firstClientPromiseResolved = true;
336
- });
337
- audio.handleClientRequest(meeting, false).then(() => {
338
- secondClientPromiseResolved = true;
339
- });
340
-
341
- await testUtils.flushPromises();
342
-
343
- assert.calledOnce(MeetingUtil.remoteUpdateAudioVideo);
344
- assert.calledWith(MeetingUtil.remoteUpdateAudioVideo, true, undefined, meeting);
345
-
346
- // now allow the first request to complete
347
- serverResponseResolve();
348
- await testUtils.flushPromises();
349
- assert.isTrue(firstClientPromiseResolved);
350
-
351
- // that should trigger the second server request to be sent
352
- assert.calledTwice(MeetingUtil.remoteUpdateAudioVideo);
353
- assert.strictEqual(false, MeetingUtil.remoteUpdateAudioVideo.getCall(1).args[0]);
354
- assert.strictEqual(undefined, MeetingUtil.remoteUpdateAudioVideo.getCall(1).args[1]);
355
- assert.strictEqual(meeting, MeetingUtil.remoteUpdateAudioVideo.getCall(1).args[2]);
356
-
357
- serverResponseResolve();
358
- await testUtils.flushPromises();
359
-
360
- assert.isTrue(secondClientPromiseResolved);
361
- });
362
-
363
- it('rejects client request to unmute if hard mute is used', (done) => {
364
- audio.handleServerRemoteMuteUpdate(true, false);
365
-
366
- audio
367
- .handleClientRequest(meeting, false)
368
- .then(() => {
369
- done(new Error('expected handleClientRequest to fail, but it did not!'));
370
- })
371
- .catch((e) => {
372
- assert.isTrue(e instanceof PermissionError);
373
- done();
374
- });
375
- });
376
-
377
- it('does not send remote mute for video', async () => {
378
- // mute
379
- await video.handleClientRequest(meeting, true);
380
-
381
- assert.isTrue(video.isMuted());
382
- assert.isTrue(video.isSelf());
383
-
384
- // check local mute is done, but not remote one
385
- assert.calledWith(Media.setLocalTrack, false, meeting.mediaProperties.videoTrack);
386
- assert.calledWith(MeetingUtil.remoteUpdateAudioVideo, undefined, true, meeting);
387
- assert.notCalled(meeting.members.muteMember);
388
-
389
- Media.setLocalTrack.resetHistory();
390
- MeetingUtil.remoteUpdateAudioVideo.resetHistory();
391
- meeting.members.muteMember.resetHistory();
392
-
393
- // unmute
394
- await video.handleClientRequest(meeting, false);
395
-
396
- assert.isFalse(video.isMuted());
397
- assert.isFalse(video.isSelf());
398
-
399
- assert.calledWith(Media.setLocalTrack, true, meeting.mediaProperties.videoTrack);
400
- assert.calledWith(MeetingUtil.remoteUpdateAudioVideo, undefined, false, meeting);
401
- assert.notCalled(meeting.members.muteMember);
402
- });
403
-
404
- it('sends correct audio value when sending local mute for video', async () => {
405
- // make sure the meeting object has mute state machines for both audio and video
406
- meeting.audio = audio;
407
- meeting.video = video;
408
-
409
- // mute audio -> request sent to server should have video unmuted
410
- await audio.handleClientRequest(meeting, true);
411
- assert.calledWith(MeetingUtil.remoteUpdateAudioVideo, true, false, meeting);
412
- MeetingUtil.remoteUpdateAudioVideo.resetHistory();
413
-
414
- // now mute video -> request sent to server should have mute for both audio and video
415
- await video.handleClientRequest(meeting, true);
416
- assert.calledWith(MeetingUtil.remoteUpdateAudioVideo, true, true, meeting);
417
- MeetingUtil.remoteUpdateAudioVideo.resetHistory();
418
-
419
- // now unmute the audio -> request sent to server should still have video muted
420
- await audio.handleClientRequest(meeting, false);
421
- assert.calledWith(MeetingUtil.remoteUpdateAudioVideo, false, true, meeting);
422
- MeetingUtil.remoteUpdateAudioVideo.resetHistory();
423
-
424
- // unmute video -> request sent to server should have both audio and video unmuted
425
- await video.handleClientRequest(meeting, false);
426
- assert.calledWith(MeetingUtil.remoteUpdateAudioVideo, false, false, meeting);
427
- });
428
- });
429
- });
430
- });
1
+ import sinon from 'sinon';
2
+ import {assert} from '@webex/test-helper-chai';
3
+ import MeetingUtil from '@webex/plugin-meetings/src/meeting/util';
4
+ import createMuteState from '@webex/plugin-meetings/src/meeting/muteState';
5
+ import Media from '@webex/plugin-meetings/src/media/index';
6
+ import PermissionError from '@webex/plugin-meetings/src/common/errors/permission';
7
+ import {AUDIO, VIDEO} from '@webex/plugin-meetings/src/constants';
8
+
9
+ import testUtils from '../../../utils/testUtils';
10
+
11
+ describe('plugin-meetings', () => {
12
+ let meeting;
13
+ let audio;
14
+ let video;
15
+
16
+ const fakeLocus = {info: 'this is a fake locus'};
17
+
18
+ beforeEach(() => {
19
+ meeting = {
20
+ mediaProperties: {
21
+ audioTrack: 'fake audio track',
22
+ videoTrack: 'fake video track',
23
+ },
24
+ remoteMuted: false,
25
+ unmuteAllowed: true,
26
+ locusInfo: {
27
+ onFullLocus: sinon.stub(),
28
+ },
29
+ members: {
30
+ selfId: 'fake self id',
31
+ muteMember: sinon.stub().resolves(),
32
+ },
33
+ };
34
+ audio = createMuteState(AUDIO, meeting, {sendAudio: true});
35
+ video = createMuteState(VIDEO, meeting, {sendVideo: true});
36
+
37
+ MeetingUtil.remoteUpdateAudioVideo = sinon.stub().resolves(fakeLocus);
38
+ Media.setLocalTrack = sinon.stub();
39
+ });
40
+
41
+ describe('mute state library', () => {
42
+ it('does not create an audio instance if we are not sending audio', async () => {
43
+ assert.isNull(createMuteState(AUDIO, meeting, {sendAudio: false}));
44
+ assert.isNull(createMuteState(AUDIO, meeting, {}));
45
+ });
46
+
47
+ it('does not create a video instance if we are not sending video', async () => {
48
+ assert.isNull(createMuteState(VIDEO, meeting, {sendVideo: false}));
49
+ assert.isNull(createMuteState(VIDEO, meeting, {}));
50
+ });
51
+
52
+ it('takes into account current remote mute status when instantiated', async () => {
53
+ // simulate being already remote muted
54
+ meeting.remoteMuted = true;
55
+ // create a new MuteState intance
56
+ audio = createMuteState(AUDIO, meeting, {sendAudio: true});
57
+
58
+ assert.isTrue(audio.isMuted());
59
+ assert.isFalse(audio.isSelf());
60
+
61
+ // now check the opposite case
62
+ meeting.remoteMuted = false;
63
+
64
+ // create a new MuteState intance
65
+ audio = createMuteState(AUDIO, meeting, {sendAudio: true});
66
+
67
+ assert.isFalse(audio.isMuted());
68
+ assert.isFalse(audio.isSelf());
69
+ });
70
+
71
+ it('initialises correctly for video', async () => {
72
+ // setup fields related to audio remote state
73
+ meeting.remoteMuted = true;
74
+ meeting.unmuteAllowed = false;
75
+ // create a new video MuteState intance
76
+ video = createMuteState(VIDEO, meeting, {sendVideo: true});
77
+
78
+ assert.isFalse(video.isMuted());
79
+ assert.isFalse(video.state.server.remoteMute);
80
+ assert.isTrue(video.state.server.unmuteAllowed);
81
+ });
82
+
83
+ it('takes remote mute into account when reporting current state', async () => {
84
+ assert.isFalse(audio.isMuted());
85
+
86
+ // simulate remote mute
87
+ audio.handleServerRemoteMuteUpdate(true, true);
88
+
89
+ assert.isTrue(audio.isMuted());
90
+ assert.isFalse(audio.isSelf());
91
+ });
92
+
93
+ it('does local unmute if localAudioUnmuteRequired is received', async () => {
94
+ // first we need to mute
95
+ await audio.handleClientRequest(meeting, true);
96
+
97
+ assert.isTrue(audio.isMuted());
98
+ assert.isTrue(audio.isSelf());
99
+
100
+ MeetingUtil.remoteUpdateAudioVideo.resetHistory();
101
+
102
+ // now simulate server requiring us to locally unmute
103
+ audio.handleServerLocalUnmuteRequired(meeting);
104
+ await testUtils.flushPromises();
105
+
106
+ // check that local track was enabled
107
+ assert.calledWith(Media.setLocalTrack, true, meeting.mediaProperties.audioTrack);
108
+
109
+ // and local unmute was sent to server
110
+ assert.calledOnce(MeetingUtil.remoteUpdateAudioVideo);
111
+ assert.calledWith(MeetingUtil.remoteUpdateAudioVideo, false, undefined, meeting);
112
+
113
+ assert.isFalse(audio.isMuted());
114
+ assert.isFalse(audio.isSelf());
115
+ });
116
+
117
+ it('rejects client request in progress if localAudioUnmuteRequired is received', async () => {
118
+ let clientPromiseResolved = false;
119
+ let clientPromiseRejected = false;
120
+
121
+ // first we need to mute and make that request last forever
122
+ let serverResponseResolve;
123
+
124
+ MeetingUtil.remoteUpdateAudioVideo = sinon.stub().returns(
125
+ new Promise((resolve) => {
126
+ serverResponseResolve = resolve;
127
+ })
128
+ );
129
+
130
+ audio
131
+ .handleClientRequest(meeting, true)
132
+ .then(() => {
133
+ clientPromiseResolved = true;
134
+ })
135
+ .catch(() => {
136
+ clientPromiseRejected = true;
137
+ });
138
+
139
+ MeetingUtil.remoteUpdateAudioVideo.resetHistory();
140
+
141
+ // now simulate server requiring us to locally unmute
142
+ audio.handleServerLocalUnmuteRequired(meeting);
143
+ await testUtils.flushPromises();
144
+
145
+ // the original client request should have been rejected by now
146
+ assert.isTrue(clientPromiseRejected);
147
+ assert.isFalse(clientPromiseResolved);
148
+
149
+ // now make the server respond to the original mute request
150
+ serverResponseResolve();
151
+ await testUtils.flushPromises();
152
+
153
+ // local unmute should be sent to server
154
+ assert.calledOnce(MeetingUtil.remoteUpdateAudioVideo);
155
+ assert.calledWith(MeetingUtil.remoteUpdateAudioVideo, false, undefined, meeting);
156
+
157
+ // and local track should be enabled
158
+ assert.calledWith(Media.setLocalTrack, true, meeting.mediaProperties.audioTrack);
159
+
160
+ assert.isFalse(audio.isMuted());
161
+ assert.isFalse(audio.isSelf());
162
+ });
163
+
164
+ describe('#isLocallyMuted()', () => {
165
+ it('does not consider remote mute status for audio', async () => {
166
+ // simulate being already remote muted
167
+ meeting.remoteMuted = true;
168
+ // create a new MuteState intance
169
+ audio = createMuteState(AUDIO, meeting, {sendAudio: true});
170
+
171
+ assert.isFalse(audio.isLocallyMuted());
172
+ });
173
+ });
174
+
175
+ describe('#handleClientRequest', () => {
176
+ it('disables/enables the local audio track when audio is muted/unmuted', async () => {
177
+ // mute
178
+ audio.handleClientRequest(meeting, true);
179
+ assert.calledWith(Media.setLocalTrack, false, meeting.mediaProperties.audioTrack);
180
+
181
+ // even when calling mute when it's already muted should still call setLocalTrack
182
+ audio.handleClientRequest(meeting, true);
183
+ assert.calledWith(Media.setLocalTrack, false, meeting.mediaProperties.audioTrack);
184
+
185
+ // unmute
186
+ audio.handleClientRequest(meeting, false);
187
+ assert.calledWith(Media.setLocalTrack, true, meeting.mediaProperties.audioTrack);
188
+
189
+ // even when calling unmute when it's already unmuted should still call setLocalTrack
190
+ audio.handleClientRequest(meeting, false);
191
+ assert.calledWith(Media.setLocalTrack, true, meeting.mediaProperties.audioTrack);
192
+ });
193
+
194
+ it('disables/enables the local video track when video is muted/unmuted', async () => {
195
+ // mute
196
+ video.handleClientRequest(meeting, true);
197
+ assert.calledWith(Media.setLocalTrack, false, meeting.mediaProperties.videoTrack);
198
+
199
+ // even when calling mute when it's already muted should still call setLocalTrack
200
+ video.handleClientRequest(meeting, false);
201
+ assert.calledWith(Media.setLocalTrack, false, meeting.mediaProperties.videoTrack);
202
+
203
+ // unmute
204
+ video.handleClientRequest(meeting, false);
205
+ assert.calledWith(Media.setLocalTrack, true, meeting.mediaProperties.videoTrack);
206
+
207
+ // even when calling unmute when it's already unmuted should still call setLocalTrack
208
+ video.handleClientRequest(meeting, false);
209
+ assert.calledWith(Media.setLocalTrack, true, meeting.mediaProperties.videoTrack);
210
+ });
211
+
212
+ it('returns correct value in isMuted()/isSelf() methods after client mute/unmute requests', async () => {
213
+ // mute
214
+ audio.handleClientRequest(meeting, true);
215
+
216
+ assert.isTrue(audio.isMuted());
217
+ assert.isTrue(audio.isSelf());
218
+
219
+ // unmute
220
+ audio.handleClientRequest(meeting, false);
221
+
222
+ assert.isFalse(audio.isMuted());
223
+ assert.isFalse(audio.isSelf());
224
+ });
225
+
226
+ it('does remote unmute when unmuting and remote mute is on', async () => {
227
+ // simulate remote mute
228
+ audio.handleServerRemoteMuteUpdate(true, true);
229
+
230
+ // unmute
231
+ await audio.handleClientRequest(meeting, false);
232
+
233
+ // check that remote unmute was sent to server
234
+ assert.calledOnce(meeting.members.muteMember);
235
+ assert.calledWith(meeting.members.muteMember, meeting.members.selfId, false);
236
+
237
+ assert.isFalse(audio.isMuted());
238
+ assert.isFalse(audio.isSelf());
239
+ });
240
+
241
+ it('resolves client request promise once the server is updated', async () => {
242
+ let clientPromiseResolved = false;
243
+
244
+ let serverResponseResolve;
245
+
246
+ MeetingUtil.remoteUpdateAudioVideo = sinon.stub().returns(
247
+ new Promise((resolve) => {
248
+ serverResponseResolve = resolve;
249
+ })
250
+ );
251
+
252
+ audio.handleClientRequest(meeting, true).then(() => {
253
+ clientPromiseResolved = true;
254
+ });
255
+
256
+ // do a small delay to make sure that the client promise doesn't resolve in that time
257
+ await testUtils.waitUntil(200);
258
+ assert.isFalse(clientPromiseResolved);
259
+
260
+ // now allow the server response to arrive, this should trigger the client promise to get resolved
261
+ serverResponseResolve();
262
+ await testUtils.flushPromises();
263
+
264
+ assert.isTrue(clientPromiseResolved);
265
+ });
266
+
267
+ it('rejects client request promise if server request for local mute fails', async () => {
268
+ MeetingUtil.remoteUpdateAudioVideo = sinon.stub().returns(
269
+ new Promise((resolve, reject) => {
270
+ reject();
271
+ })
272
+ );
273
+
274
+ assert.isRejected(audio.handleClientRequest(meeting, true));
275
+ });
276
+
277
+ it('rejects client request promise if server request for remote mute fails', async () => {
278
+ // we only send remote mute requests when we're unmuting, so first we need to do a remote mute
279
+ audio.handleServerRemoteMuteUpdate(true, true);
280
+
281
+ // setup the stub to simulate server error response
282
+ meeting.members.muteMember = sinon.stub().rejects();
283
+
284
+ // try to unmute - it should fail
285
+ await assert.isRejected(audio.handleClientRequest(meeting, false));
286
+
287
+ // even though remote mute update in the server failed, isMuted() should still return true,
288
+ // because of local mute
289
+ assert.isTrue(audio.isMuted());
290
+ });
291
+
292
+ it('does not send a server request if client state matches the server', async () => {
293
+ let serverResponseResolve;
294
+
295
+ MeetingUtil.remoteUpdateAudioVideo = sinon.stub().returns(
296
+ new Promise((resolve) => {
297
+ serverResponseResolve = resolve;
298
+ })
299
+ );
300
+
301
+ // simulate many client requests, with the last one matching the initial one
302
+ audio.handleClientRequest(meeting, true);
303
+ audio.handleClientRequest(meeting, false);
304
+ audio.handleClientRequest(meeting, true);
305
+ audio.handleClientRequest(meeting, false);
306
+ audio.handleClientRequest(meeting, true);
307
+
308
+ // so far there should have been only 1 request to server (because our stub hasn't resolved yet
309
+ // and MuteState sends only 1 server request at a time)
310
+ assert.calledOnce(MeetingUtil.remoteUpdateAudioVideo);
311
+ MeetingUtil.remoteUpdateAudioVideo.resetHistory();
312
+
313
+ // now allow the server response to arrive for that initial request
314
+ serverResponseResolve();
315
+ await testUtils.flushPromises();
316
+
317
+ // there should have not been any more server requests, because client state already matches the server state
318
+ assert.notCalled(MeetingUtil.remoteUpdateAudioVideo);
319
+ });
320
+
321
+ it('queues up server requests when multiple client requests are received', async () => {
322
+ let serverResponseResolve;
323
+
324
+ MeetingUtil.remoteUpdateAudioVideo = sinon.stub().returns(
325
+ new Promise((resolve) => {
326
+ serverResponseResolve = resolve;
327
+ })
328
+ );
329
+
330
+ let firstClientPromiseResolved = false;
331
+ let secondClientPromiseResolved = false;
332
+
333
+ // 2 client requests, one after another without waiting for first one to resolve
334
+ audio.handleClientRequest(meeting, true).then(() => {
335
+ firstClientPromiseResolved = true;
336
+ });
337
+ audio.handleClientRequest(meeting, false).then(() => {
338
+ secondClientPromiseResolved = true;
339
+ });
340
+
341
+ await testUtils.flushPromises();
342
+
343
+ assert.calledOnce(MeetingUtil.remoteUpdateAudioVideo);
344
+ assert.calledWith(MeetingUtil.remoteUpdateAudioVideo, true, undefined, meeting);
345
+
346
+ // now allow the first request to complete
347
+ serverResponseResolve();
348
+ await testUtils.flushPromises();
349
+ assert.isTrue(firstClientPromiseResolved);
350
+
351
+ // that should trigger the second server request to be sent
352
+ assert.calledTwice(MeetingUtil.remoteUpdateAudioVideo);
353
+ assert.strictEqual(false, MeetingUtil.remoteUpdateAudioVideo.getCall(1).args[0]);
354
+ assert.strictEqual(undefined, MeetingUtil.remoteUpdateAudioVideo.getCall(1).args[1]);
355
+ assert.strictEqual(meeting, MeetingUtil.remoteUpdateAudioVideo.getCall(1).args[2]);
356
+
357
+ serverResponseResolve();
358
+ await testUtils.flushPromises();
359
+
360
+ assert.isTrue(secondClientPromiseResolved);
361
+ });
362
+
363
+ it('rejects client request to unmute if hard mute is used', (done) => {
364
+ audio.handleServerRemoteMuteUpdate(true, false);
365
+
366
+ audio
367
+ .handleClientRequest(meeting, false)
368
+ .then(() => {
369
+ done(new Error('expected handleClientRequest to fail, but it did not!'));
370
+ })
371
+ .catch((e) => {
372
+ assert.isTrue(e instanceof PermissionError);
373
+ done();
374
+ });
375
+ });
376
+
377
+ it('does not send remote mute for video', async () => {
378
+ // mute
379
+ await video.handleClientRequest(meeting, true);
380
+
381
+ assert.isTrue(video.isMuted());
382
+ assert.isTrue(video.isSelf());
383
+
384
+ // check local mute is done, but not remote one
385
+ assert.calledWith(Media.setLocalTrack, false, meeting.mediaProperties.videoTrack);
386
+ assert.calledWith(MeetingUtil.remoteUpdateAudioVideo, undefined, true, meeting);
387
+ assert.notCalled(meeting.members.muteMember);
388
+
389
+ Media.setLocalTrack.resetHistory();
390
+ MeetingUtil.remoteUpdateAudioVideo.resetHistory();
391
+ meeting.members.muteMember.resetHistory();
392
+
393
+ // unmute
394
+ await video.handleClientRequest(meeting, false);
395
+
396
+ assert.isFalse(video.isMuted());
397
+ assert.isFalse(video.isSelf());
398
+
399
+ assert.calledWith(Media.setLocalTrack, true, meeting.mediaProperties.videoTrack);
400
+ assert.calledWith(MeetingUtil.remoteUpdateAudioVideo, undefined, false, meeting);
401
+ assert.notCalled(meeting.members.muteMember);
402
+ });
403
+
404
+ it('sends correct audio value when sending local mute for video', async () => {
405
+ // make sure the meeting object has mute state machines for both audio and video
406
+ meeting.audio = audio;
407
+ meeting.video = video;
408
+
409
+ // mute audio -> request sent to server should have video unmuted
410
+ await audio.handleClientRequest(meeting, true);
411
+ assert.calledWith(MeetingUtil.remoteUpdateAudioVideo, true, false, meeting);
412
+ MeetingUtil.remoteUpdateAudioVideo.resetHistory();
413
+
414
+ // now mute video -> request sent to server should have mute for both audio and video
415
+ await video.handleClientRequest(meeting, true);
416
+ assert.calledWith(MeetingUtil.remoteUpdateAudioVideo, true, true, meeting);
417
+ MeetingUtil.remoteUpdateAudioVideo.resetHistory();
418
+
419
+ // now unmute the audio -> request sent to server should still have video muted
420
+ await audio.handleClientRequest(meeting, false);
421
+ assert.calledWith(MeetingUtil.remoteUpdateAudioVideo, false, true, meeting);
422
+ MeetingUtil.remoteUpdateAudioVideo.resetHistory();
423
+
424
+ // unmute video -> request sent to server should have both audio and video unmuted
425
+ await video.handleClientRequest(meeting, false);
426
+ assert.calledWith(MeetingUtil.remoteUpdateAudioVideo, false, false, meeting);
427
+ });
428
+ });
429
+ });
430
+ });