@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,478 +1,478 @@
1
- /*!
2
- * Copyright (c) 2015-2020 Cisco Systems, Inc. See LICENSE file.
3
- */
4
-
5
- /* eslint-disable class-methods-use-this */
6
- /* globals window */
7
- import _ from 'lodash';
8
-
9
- import LoggerProxy from '../common/logs/logger-proxy';
10
- import {ICE_GATHERING_STATE, CONNECTION_STATE, REACHABILITY} from '../constants';
11
-
12
- import ReachabilityRequest from './request';
13
-
14
- const DEFAULT_TIMEOUT = 3000;
15
- const VIDEO_MESH_TIMEOUT = 1000;
16
-
17
- /**
18
- * @class Reachability
19
- * @export
20
- */
21
- export default class Reachability {
22
- webex: object;
23
- reachabilityRequest: any;
24
- clusterLatencyResults: any;
25
-
26
- /**
27
- * Creates an instance of Reachability.
28
- * @param {object} webex
29
- * @memberof Reachability
30
- */
31
- constructor(webex: object) {
32
- this.webex = webex;
33
-
34
- /**
35
- * internal request object for the server
36
- * @instance
37
- * @type {Array}
38
- * @private
39
- * @memberof Reachability
40
- */
41
- this.reachabilityRequest = new ReachabilityRequest(this.webex);
42
-
43
- /**
44
- * internal object of clusters latency results
45
- * @instance
46
- * @type {object}
47
- * @private
48
- * @memberof Reachability
49
- */
50
- this.clusterLatencyResults = {};
51
- }
52
-
53
- /**
54
- * fetches reachability data
55
- * @returns {Object} reachability data
56
- * @public
57
- * @async
58
- * @memberof Reachability
59
- */
60
- public async gatherReachability() {
61
- this.setup();
62
-
63
- // Remove stored reachability results to ensure no stale data
64
- if (window?.localStorage?.removeItem) {
65
- window.localStorage.removeItem(REACHABILITY.localStorage);
66
- } else {
67
- LoggerProxy.logger.error(
68
- 'Reachability:index#gatherReachability --> Error in accessing LocalStorage.'
69
- );
70
-
71
- return {};
72
- }
73
-
74
- // Fetch clusters and measure latency
75
- try {
76
- const clusters = await this.reachabilityRequest.getClusters();
77
-
78
- // Perform Reachability Check
79
- const results = await this.performReachabilityCheck(clusters);
80
-
81
- window.localStorage.setItem(REACHABILITY.localStorage, JSON.stringify(results));
82
-
83
- LoggerProxy.logger.log(
84
- 'Reachability:index#gatherReachability --> Reachability checks completed'
85
- );
86
-
87
- return results;
88
- } catch (getClusterError) {
89
- LoggerProxy.logger.error(
90
- `Reachability:index#gatherReachability --> Error in calling getClusters(): ${getClusterError}`
91
- );
92
-
93
- return {};
94
- }
95
- }
96
-
97
- /**
98
- * fetches reachability data and checks for cluster reachability
99
- * @returns {boolean}
100
- * @public
101
- * @memberof Reachability
102
- */
103
- isAnyClusterReachable() {
104
- let reachable = false;
105
- const reachabilityData = window.localStorage.getItem(REACHABILITY.localStorage);
106
-
107
- if (reachabilityData) {
108
- try {
109
- const reachabilityResults = JSON.parse(reachabilityData);
110
-
111
- reachable = Object.values(reachabilityResults).some(
112
- (result: any) => result.udp?.reachable === 'true' || result.tcp?.reachable === 'true'
113
- );
114
- } catch (e) {
115
- LoggerProxy.logger.error(
116
- `Roap:request#attachReachabilityData --> Error in parsing reachability data: ${e}`
117
- );
118
- }
119
- }
120
-
121
- return reachable;
122
- }
123
-
124
- /**
125
- * Generate peerConnection config settings
126
- * @param {object} cluster
127
- * @returns {object} peerConnectionConfig
128
- * @private
129
- * @memberof Reachability
130
- */
131
- private buildPeerConnectionConfig(cluster: any) {
132
- const iceServers = _.uniq([...cluster.udp, ...cluster.tcp]).map((url) => ({
133
- username: '',
134
- credential: '',
135
- urls: [url],
136
- }));
137
-
138
- return {
139
- iceServers: [...iceServers],
140
- iceCandidatePoolSize: '0',
141
- iceTransportPolicy: 'all',
142
- };
143
- }
144
-
145
- /**
146
- * Creates an RTCPeerConnection
147
- * @param {object} cluster
148
- * @returns {RTCPeerConnection} peerConnection
149
- * @private
150
- * @memberof Reachability
151
- */
152
- private createPeerConnection(cluster: any) {
153
- const {key, config} = cluster;
154
-
155
- try {
156
- const peerConnection = new window.RTCPeerConnection(config);
157
-
158
- // @ts-ignore
159
- peerConnection.key = key;
160
-
161
- return peerConnection;
162
- } catch (peerConnectionError) {
163
- LoggerProxy.logger.log(
164
- `Reachability:index#createPeerConnection --> Error creating peerConnection: ${peerConnectionError}`
165
- );
166
-
167
- return null;
168
- }
169
- }
170
-
171
- /**
172
- * Gets total elapsed time
173
- * @param {RTCPeerConnection} peerConnection
174
- * @returns {Number} Milliseconds
175
- * @private
176
- * @memberof Reachability
177
- */
178
- private getElapsedTime(peerConnection: any) {
179
- const startTime = peerConnection.begin;
180
-
181
- delete peerConnection.begin;
182
-
183
- return Date.now() - startTime;
184
- }
185
-
186
- /**
187
- * creates offer and generates localSDP
188
- * @param {object} clusterList cluster List
189
- * @returns {Promise} Reachability latency results
190
- * @private
191
- * @memberof Reachability
192
- */
193
- private getLocalSDPForClusters(clusterList: object) {
194
- let clusters: any[] = [...Object.keys(clusterList)];
195
-
196
- clusters = clusters.map(async (key) => {
197
- const cluster = clusterList[key];
198
- const config = this.buildPeerConnectionConfig(cluster);
199
- const peerConnection = this.createPeerConnection({key, config});
200
- const description = await peerConnection.createOffer({offerToReceiveAudio: true});
201
-
202
- // @ts-ignore
203
- peerConnection.begin = Date.now();
204
- peerConnection.setLocalDescription(description);
205
-
206
- return this.iceGatheringState(
207
- peerConnection,
208
- cluster.isVideoMesh ? VIDEO_MESH_TIMEOUT : DEFAULT_TIMEOUT
209
- ).catch((iceGatheringStateError) => {
210
- LoggerProxy.logger.log(
211
- `Reachability:index#getLocalSDPForClusters --> Error in getLocalSDP : ${iceGatheringStateError}`
212
- );
213
- });
214
- });
215
-
216
- return Promise.all(clusters)
217
- .then(this.parseIceResultsToReachabilityResults)
218
- .then((reachabilityLatencyResults) => {
219
- this.logUnreachableClusters();
220
-
221
- // return results
222
- return reachabilityLatencyResults;
223
- });
224
- }
225
-
226
- /**
227
- * Get list of all unreachable clusters
228
- * @returns {array} Unreachable clusters
229
- * @private
230
- * @memberof Reachability
231
- */
232
- private getUnreachablClusters() {
233
- const unreachableList = [];
234
- const clusters = this.clusterLatencyResults;
235
-
236
- Object.keys(clusters).forEach((key) => {
237
- const cluster = clusters[key];
238
-
239
- if (cluster.unreachable && !cluster.reachable) {
240
- unreachableList.push(key);
241
- }
242
- });
243
-
244
- return unreachableList;
245
- }
246
-
247
- /**
248
- * Attach an event handler for the icegatheringstatechange
249
- * event and measure latency.
250
- * @param {RTCPeerConnection} peerConnection
251
- * @returns {undefined}
252
- * @private
253
- * @memberof Reachability
254
- */
255
- private handleIceGatheringStateChange(peerConnection: RTCPeerConnection) {
256
- peerConnection.onicegatheringstatechange = () => {
257
- const {COMPLETE} = ICE_GATHERING_STATE;
258
-
259
- if (peerConnection.iceConnectionState === COMPLETE) {
260
- const elapsed = this.getElapsedTime(peerConnection);
261
-
262
- // @ts-ignore
263
- LoggerProxy.logger.log(
264
- // @ts-ignore
265
- `Reachability:index#onIceGatheringStateChange --> Successfully pinged ${peerConnection.key}:`,
266
- elapsed
267
- );
268
- this.setLatencyAndClose(peerConnection, elapsed);
269
- }
270
- };
271
- }
272
-
273
- /**
274
- * Attach an event handler for the icecandidate
275
- * event and measure latency.
276
- * @param {RTCPeerConnection} peerConnection
277
- * @returns {undefined}
278
- * @private
279
- * @memberof Reachability
280
- */
281
- private handleOnIceCandidate(peerConnection: RTCPeerConnection) {
282
- peerConnection.onicecandidate = (e) => {
283
- const SERVER_REFLEXIVE = 'srflx';
284
-
285
- if (e.candidate && String(e.candidate.type).toLowerCase() === SERVER_REFLEXIVE) {
286
- const elapsed = this.getElapsedTime(peerConnection);
287
-
288
- LoggerProxy.logger.log(
289
- // @ts-ignore
290
- `Reachability:index#onIceCandidate --> Successfully pinged ${peerConnection.key}:`,
291
- elapsed
292
- );
293
- this.setLatencyAndClose(peerConnection, elapsed);
294
- }
295
- };
296
- }
297
-
298
- /**
299
- * An event handler on an RTCPeerConnection when the state of the ICE
300
- * candidate gathering process changes. Used to measure connection
301
- * speed.
302
- * @private
303
- * @param {RTCPeerConnection} peerConnection
304
- * @param {number} timeout
305
- * @returns {Promise}
306
- */
307
- private iceGatheringState(peerConnection: RTCPeerConnection, timeout: number) {
308
- const ELAPSED = 'elapsed';
309
-
310
- return new Promise((resolve) => {
311
- const peerConnectionProxy = new window.Proxy(peerConnection, {
312
- get(target, property) {
313
- const targetMember = target[property];
314
-
315
- if (typeof targetMember === 'function') {
316
- return targetMember.bind(target);
317
- }
318
-
319
- return targetMember;
320
- },
321
- set: (target, property, value) => {
322
- // only intercept elapsed property
323
- if (property === ELAPSED) {
324
- // @ts-ignore
325
- resolve({clusterId: peerConnection.key, elapsed: value});
326
-
327
- return true;
328
- }
329
-
330
- // pass thru
331
- return window.Reflect.set(target, property, value);
332
- },
333
- });
334
-
335
- // Using peerConnection proxy so handle functions below
336
- // won't be coupled to our promise implementation
337
- this.handleIceGatheringStateChange(peerConnectionProxy);
338
- this.handleOnIceCandidate(peerConnectionProxy);
339
-
340
- // Set maximum timeout
341
- window.setTimeout(() => {
342
- const {CLOSED} = CONNECTION_STATE;
343
-
344
- // Close any open peerConnections
345
- if (peerConnectionProxy.connectionState !== CLOSED) {
346
- this.setLatencyAndClose(peerConnectionProxy, null);
347
- }
348
- }, timeout);
349
- });
350
- }
351
-
352
- /**
353
- * Make a log of unreachable clusters.
354
- * @returns {undefined}
355
- * @private
356
- * @memberof Reachability
357
- */
358
- private logUnreachableClusters() {
359
- const list = this.getUnreachablClusters();
360
-
361
- list.forEach((cluster) => {
362
- LoggerProxy.logger.log(
363
- `Reachability:index#logUnreachableClusters --> No ice candidate for ${cluster}.`
364
- );
365
- });
366
- }
367
-
368
- /**
369
- * Calculates time to establish connection
370
- * @param {array} iceResults iceResults
371
- * @returns {object} reachabilityMap
372
- * @private
373
- * @memberof Reachability
374
- */
375
- private parseIceResultsToReachabilityResults(iceResults: Array<any>) {
376
- const reachabilityMap = {};
377
-
378
- iceResults.forEach(({clusterId, elapsed}) => {
379
- let latencyResult;
380
-
381
- if (elapsed === null) {
382
- latencyResult = {reachable: 'false'};
383
- } else {
384
- latencyResult = {
385
- reachable: 'true',
386
- latencyInMilliseconds: elapsed.toString(),
387
- };
388
- }
389
-
390
- reachabilityMap[clusterId] = {
391
- udp: latencyResult,
392
- tcp: latencyResult,
393
- };
394
- });
395
-
396
- return reachabilityMap;
397
- }
398
-
399
- /**
400
- * fetches reachability data
401
- * @param {object} clusterList
402
- * @returns {Promise<localSDPData>} reachability check results
403
- * @private
404
- * @memberof Reachability
405
- */
406
- private performReachabilityCheck(clusterList: object) {
407
- if (!clusterList || !Object.keys(clusterList).length) {
408
- return Promise.resolve({});
409
- }
410
-
411
- return new Promise((resolve) => {
412
- this.getLocalSDPForClusters(clusterList)
413
- .then((localSDPData) => {
414
- if (!localSDPData || !Object.keys(localSDPData).length) {
415
- // TODO: handle the error condition properly and try retry
416
- LoggerProxy.logger.log(
417
- 'Reachability:index#performReachabilityCheck --> Local SDP is empty or has missing elements..returning'
418
- );
419
- resolve({});
420
- } else {
421
- resolve(localSDPData);
422
- }
423
- })
424
- .catch((error) => {
425
- LoggerProxy.logger.error(
426
- `Reachability:index#performReachabilityCheck --> Error in getLocalSDPForClusters: ${error}`
427
- );
428
- resolve({});
429
- });
430
- });
431
- }
432
-
433
- /**
434
- * Records latency and closes the peerConnection
435
- * @param {RTCPeerConnection} peerConnection
436
- * @param {number} elapsed Latency in milliseconds
437
- * @returns {undefined}
438
- * @private
439
- * @memberof Reachability
440
- */
441
- private setLatencyAndClose(peerConnection: RTCPeerConnection, elapsed: number) {
442
- const REACHABLE = 'reachable';
443
- const UNREACHABLE = 'unreachable';
444
- const {CLOSED} = CONNECTION_STATE;
445
- // @ts-ignore
446
- const {key} = peerConnection;
447
- const resultKey = elapsed === null ? UNREACHABLE : REACHABLE;
448
- const intialState = {[REACHABLE]: 0, [UNREACHABLE]: 0};
449
-
450
- if (peerConnection.connectionState === CLOSED) {
451
- LoggerProxy.logger.log(
452
- `Reachability:index#setLatencyAndClose --> Attempting to set latency of ${elapsed} on closed peerConnection.`
453
- );
454
-
455
- return;
456
- }
457
-
458
- this.clusterLatencyResults[key] = this.clusterLatencyResults[key] || intialState;
459
- this.clusterLatencyResults[key][resultKey] += 1;
460
-
461
- // Set to null in case this fired from
462
- // an event other than onIceCandidate
463
- peerConnection.onicecandidate = null;
464
- peerConnection.close();
465
- // @ts-ignore
466
- peerConnection.elapsed = elapsed;
467
- }
468
-
469
- /**
470
- * utility function
471
- * @returns {undefined}
472
- * @private
473
- * @memberof Reachability
474
- */
475
- private setup() {
476
- this.clusterLatencyResults = {};
477
- }
478
- }
1
+ /*!
2
+ * Copyright (c) 2015-2020 Cisco Systems, Inc. See LICENSE file.
3
+ */
4
+
5
+ /* eslint-disable class-methods-use-this */
6
+ /* globals window */
7
+ import _ from 'lodash';
8
+
9
+ import LoggerProxy from '../common/logs/logger-proxy';
10
+ import {ICE_GATHERING_STATE, CONNECTION_STATE, REACHABILITY} from '../constants';
11
+
12
+ import ReachabilityRequest from './request';
13
+
14
+ const DEFAULT_TIMEOUT = 3000;
15
+ const VIDEO_MESH_TIMEOUT = 1000;
16
+
17
+ /**
18
+ * @class Reachability
19
+ * @export
20
+ */
21
+ export default class Reachability {
22
+ webex: object;
23
+ reachabilityRequest: any;
24
+ clusterLatencyResults: any;
25
+
26
+ /**
27
+ * Creates an instance of Reachability.
28
+ * @param {object} webex
29
+ * @memberof Reachability
30
+ */
31
+ constructor(webex: object) {
32
+ this.webex = webex;
33
+
34
+ /**
35
+ * internal request object for the server
36
+ * @instance
37
+ * @type {Array}
38
+ * @private
39
+ * @memberof Reachability
40
+ */
41
+ this.reachabilityRequest = new ReachabilityRequest(this.webex);
42
+
43
+ /**
44
+ * internal object of clusters latency results
45
+ * @instance
46
+ * @type {object}
47
+ * @private
48
+ * @memberof Reachability
49
+ */
50
+ this.clusterLatencyResults = {};
51
+ }
52
+
53
+ /**
54
+ * fetches reachability data
55
+ * @returns {Object} reachability data
56
+ * @public
57
+ * @async
58
+ * @memberof Reachability
59
+ */
60
+ public async gatherReachability() {
61
+ this.setup();
62
+
63
+ // Remove stored reachability results to ensure no stale data
64
+ if (window?.localStorage?.removeItem) {
65
+ window.localStorage.removeItem(REACHABILITY.localStorage);
66
+ } else {
67
+ LoggerProxy.logger.error(
68
+ 'Reachability:index#gatherReachability --> Error in accessing LocalStorage.'
69
+ );
70
+
71
+ return {};
72
+ }
73
+
74
+ // Fetch clusters and measure latency
75
+ try {
76
+ const clusters = await this.reachabilityRequest.getClusters();
77
+
78
+ // Perform Reachability Check
79
+ const results = await this.performReachabilityCheck(clusters);
80
+
81
+ window.localStorage.setItem(REACHABILITY.localStorage, JSON.stringify(results));
82
+
83
+ LoggerProxy.logger.log(
84
+ 'Reachability:index#gatherReachability --> Reachability checks completed'
85
+ );
86
+
87
+ return results;
88
+ } catch (getClusterError) {
89
+ LoggerProxy.logger.error(
90
+ `Reachability:index#gatherReachability --> Error in calling getClusters(): ${getClusterError}`
91
+ );
92
+
93
+ return {};
94
+ }
95
+ }
96
+
97
+ /**
98
+ * fetches reachability data and checks for cluster reachability
99
+ * @returns {boolean}
100
+ * @public
101
+ * @memberof Reachability
102
+ */
103
+ isAnyClusterReachable() {
104
+ let reachable = false;
105
+ const reachabilityData = window.localStorage.getItem(REACHABILITY.localStorage);
106
+
107
+ if (reachabilityData) {
108
+ try {
109
+ const reachabilityResults = JSON.parse(reachabilityData);
110
+
111
+ reachable = Object.values(reachabilityResults).some(
112
+ (result: any) => result.udp?.reachable === 'true' || result.tcp?.reachable === 'true'
113
+ );
114
+ } catch (e) {
115
+ LoggerProxy.logger.error(
116
+ `Roap:request#attachReachabilityData --> Error in parsing reachability data: ${e}`
117
+ );
118
+ }
119
+ }
120
+
121
+ return reachable;
122
+ }
123
+
124
+ /**
125
+ * Generate peerConnection config settings
126
+ * @param {object} cluster
127
+ * @returns {object} peerConnectionConfig
128
+ * @private
129
+ * @memberof Reachability
130
+ */
131
+ private buildPeerConnectionConfig(cluster: any) {
132
+ const iceServers = _.uniq([...cluster.udp, ...cluster.tcp]).map((url) => ({
133
+ username: '',
134
+ credential: '',
135
+ urls: [url],
136
+ }));
137
+
138
+ return {
139
+ iceServers: [...iceServers],
140
+ iceCandidatePoolSize: '0',
141
+ iceTransportPolicy: 'all',
142
+ };
143
+ }
144
+
145
+ /**
146
+ * Creates an RTCPeerConnection
147
+ * @param {object} cluster
148
+ * @returns {RTCPeerConnection} peerConnection
149
+ * @private
150
+ * @memberof Reachability
151
+ */
152
+ private createPeerConnection(cluster: any) {
153
+ const {key, config} = cluster;
154
+
155
+ try {
156
+ const peerConnection = new window.RTCPeerConnection(config);
157
+
158
+ // @ts-ignore
159
+ peerConnection.key = key;
160
+
161
+ return peerConnection;
162
+ } catch (peerConnectionError) {
163
+ LoggerProxy.logger.log(
164
+ `Reachability:index#createPeerConnection --> Error creating peerConnection: ${peerConnectionError}`
165
+ );
166
+
167
+ return null;
168
+ }
169
+ }
170
+
171
+ /**
172
+ * Gets total elapsed time
173
+ * @param {RTCPeerConnection} peerConnection
174
+ * @returns {Number} Milliseconds
175
+ * @private
176
+ * @memberof Reachability
177
+ */
178
+ private getElapsedTime(peerConnection: any) {
179
+ const startTime = peerConnection.begin;
180
+
181
+ delete peerConnection.begin;
182
+
183
+ return Date.now() - startTime;
184
+ }
185
+
186
+ /**
187
+ * creates offer and generates localSDP
188
+ * @param {object} clusterList cluster List
189
+ * @returns {Promise} Reachability latency results
190
+ * @private
191
+ * @memberof Reachability
192
+ */
193
+ private getLocalSDPForClusters(clusterList: object) {
194
+ let clusters: any[] = [...Object.keys(clusterList)];
195
+
196
+ clusters = clusters.map(async (key) => {
197
+ const cluster = clusterList[key];
198
+ const config = this.buildPeerConnectionConfig(cluster);
199
+ const peerConnection = this.createPeerConnection({key, config});
200
+ const description = await peerConnection.createOffer({offerToReceiveAudio: true});
201
+
202
+ // @ts-ignore
203
+ peerConnection.begin = Date.now();
204
+ peerConnection.setLocalDescription(description);
205
+
206
+ return this.iceGatheringState(
207
+ peerConnection,
208
+ cluster.isVideoMesh ? VIDEO_MESH_TIMEOUT : DEFAULT_TIMEOUT
209
+ ).catch((iceGatheringStateError) => {
210
+ LoggerProxy.logger.log(
211
+ `Reachability:index#getLocalSDPForClusters --> Error in getLocalSDP : ${iceGatheringStateError}`
212
+ );
213
+ });
214
+ });
215
+
216
+ return Promise.all(clusters)
217
+ .then(this.parseIceResultsToReachabilityResults)
218
+ .then((reachabilityLatencyResults) => {
219
+ this.logUnreachableClusters();
220
+
221
+ // return results
222
+ return reachabilityLatencyResults;
223
+ });
224
+ }
225
+
226
+ /**
227
+ * Get list of all unreachable clusters
228
+ * @returns {array} Unreachable clusters
229
+ * @private
230
+ * @memberof Reachability
231
+ */
232
+ private getUnreachablClusters() {
233
+ const unreachableList = [];
234
+ const clusters = this.clusterLatencyResults;
235
+
236
+ Object.keys(clusters).forEach((key) => {
237
+ const cluster = clusters[key];
238
+
239
+ if (cluster.unreachable && !cluster.reachable) {
240
+ unreachableList.push(key);
241
+ }
242
+ });
243
+
244
+ return unreachableList;
245
+ }
246
+
247
+ /**
248
+ * Attach an event handler for the icegatheringstatechange
249
+ * event and measure latency.
250
+ * @param {RTCPeerConnection} peerConnection
251
+ * @returns {undefined}
252
+ * @private
253
+ * @memberof Reachability
254
+ */
255
+ private handleIceGatheringStateChange(peerConnection: RTCPeerConnection) {
256
+ peerConnection.onicegatheringstatechange = () => {
257
+ const {COMPLETE} = ICE_GATHERING_STATE;
258
+
259
+ if (peerConnection.iceConnectionState === COMPLETE) {
260
+ const elapsed = this.getElapsedTime(peerConnection);
261
+
262
+ // @ts-ignore
263
+ LoggerProxy.logger.log(
264
+ // @ts-ignore
265
+ `Reachability:index#onIceGatheringStateChange --> Successfully pinged ${peerConnection.key}:`,
266
+ elapsed
267
+ );
268
+ this.setLatencyAndClose(peerConnection, elapsed);
269
+ }
270
+ };
271
+ }
272
+
273
+ /**
274
+ * Attach an event handler for the icecandidate
275
+ * event and measure latency.
276
+ * @param {RTCPeerConnection} peerConnection
277
+ * @returns {undefined}
278
+ * @private
279
+ * @memberof Reachability
280
+ */
281
+ private handleOnIceCandidate(peerConnection: RTCPeerConnection) {
282
+ peerConnection.onicecandidate = (e) => {
283
+ const SERVER_REFLEXIVE = 'srflx';
284
+
285
+ if (e.candidate && String(e.candidate.type).toLowerCase() === SERVER_REFLEXIVE) {
286
+ const elapsed = this.getElapsedTime(peerConnection);
287
+
288
+ LoggerProxy.logger.log(
289
+ // @ts-ignore
290
+ `Reachability:index#onIceCandidate --> Successfully pinged ${peerConnection.key}:`,
291
+ elapsed
292
+ );
293
+ this.setLatencyAndClose(peerConnection, elapsed);
294
+ }
295
+ };
296
+ }
297
+
298
+ /**
299
+ * An event handler on an RTCPeerConnection when the state of the ICE
300
+ * candidate gathering process changes. Used to measure connection
301
+ * speed.
302
+ * @private
303
+ * @param {RTCPeerConnection} peerConnection
304
+ * @param {number} timeout
305
+ * @returns {Promise}
306
+ */
307
+ private iceGatheringState(peerConnection: RTCPeerConnection, timeout: number) {
308
+ const ELAPSED = 'elapsed';
309
+
310
+ return new Promise((resolve) => {
311
+ const peerConnectionProxy = new window.Proxy(peerConnection, {
312
+ get(target, property) {
313
+ const targetMember = target[property];
314
+
315
+ if (typeof targetMember === 'function') {
316
+ return targetMember.bind(target);
317
+ }
318
+
319
+ return targetMember;
320
+ },
321
+ set: (target, property, value) => {
322
+ // only intercept elapsed property
323
+ if (property === ELAPSED) {
324
+ // @ts-ignore
325
+ resolve({clusterId: peerConnection.key, elapsed: value});
326
+
327
+ return true;
328
+ }
329
+
330
+ // pass thru
331
+ return window.Reflect.set(target, property, value);
332
+ },
333
+ });
334
+
335
+ // Using peerConnection proxy so handle functions below
336
+ // won't be coupled to our promise implementation
337
+ this.handleIceGatheringStateChange(peerConnectionProxy);
338
+ this.handleOnIceCandidate(peerConnectionProxy);
339
+
340
+ // Set maximum timeout
341
+ window.setTimeout(() => {
342
+ const {CLOSED} = CONNECTION_STATE;
343
+
344
+ // Close any open peerConnections
345
+ if (peerConnectionProxy.connectionState !== CLOSED) {
346
+ this.setLatencyAndClose(peerConnectionProxy, null);
347
+ }
348
+ }, timeout);
349
+ });
350
+ }
351
+
352
+ /**
353
+ * Make a log of unreachable clusters.
354
+ * @returns {undefined}
355
+ * @private
356
+ * @memberof Reachability
357
+ */
358
+ private logUnreachableClusters() {
359
+ const list = this.getUnreachablClusters();
360
+
361
+ list.forEach((cluster) => {
362
+ LoggerProxy.logger.log(
363
+ `Reachability:index#logUnreachableClusters --> No ice candidate for ${cluster}.`
364
+ );
365
+ });
366
+ }
367
+
368
+ /**
369
+ * Calculates time to establish connection
370
+ * @param {array} iceResults iceResults
371
+ * @returns {object} reachabilityMap
372
+ * @private
373
+ * @memberof Reachability
374
+ */
375
+ private parseIceResultsToReachabilityResults(iceResults: Array<any>) {
376
+ const reachabilityMap = {};
377
+
378
+ iceResults.forEach(({clusterId, elapsed}) => {
379
+ let latencyResult;
380
+
381
+ if (elapsed === null) {
382
+ latencyResult = {reachable: 'false'};
383
+ } else {
384
+ latencyResult = {
385
+ reachable: 'true',
386
+ latencyInMilliseconds: elapsed.toString(),
387
+ };
388
+ }
389
+
390
+ reachabilityMap[clusterId] = {
391
+ udp: latencyResult,
392
+ tcp: latencyResult,
393
+ };
394
+ });
395
+
396
+ return reachabilityMap;
397
+ }
398
+
399
+ /**
400
+ * fetches reachability data
401
+ * @param {object} clusterList
402
+ * @returns {Promise<localSDPData>} reachability check results
403
+ * @private
404
+ * @memberof Reachability
405
+ */
406
+ private performReachabilityCheck(clusterList: object) {
407
+ if (!clusterList || !Object.keys(clusterList).length) {
408
+ return Promise.resolve({});
409
+ }
410
+
411
+ return new Promise((resolve) => {
412
+ this.getLocalSDPForClusters(clusterList)
413
+ .then((localSDPData) => {
414
+ if (!localSDPData || !Object.keys(localSDPData).length) {
415
+ // TODO: handle the error condition properly and try retry
416
+ LoggerProxy.logger.log(
417
+ 'Reachability:index#performReachabilityCheck --> Local SDP is empty or has missing elements..returning'
418
+ );
419
+ resolve({});
420
+ } else {
421
+ resolve(localSDPData);
422
+ }
423
+ })
424
+ .catch((error) => {
425
+ LoggerProxy.logger.error(
426
+ `Reachability:index#performReachabilityCheck --> Error in getLocalSDPForClusters: ${error}`
427
+ );
428
+ resolve({});
429
+ });
430
+ });
431
+ }
432
+
433
+ /**
434
+ * Records latency and closes the peerConnection
435
+ * @param {RTCPeerConnection} peerConnection
436
+ * @param {number} elapsed Latency in milliseconds
437
+ * @returns {undefined}
438
+ * @private
439
+ * @memberof Reachability
440
+ */
441
+ private setLatencyAndClose(peerConnection: RTCPeerConnection, elapsed: number) {
442
+ const REACHABLE = 'reachable';
443
+ const UNREACHABLE = 'unreachable';
444
+ const {CLOSED} = CONNECTION_STATE;
445
+ // @ts-ignore
446
+ const {key} = peerConnection;
447
+ const resultKey = elapsed === null ? UNREACHABLE : REACHABLE;
448
+ const intialState = {[REACHABLE]: 0, [UNREACHABLE]: 0};
449
+
450
+ if (peerConnection.connectionState === CLOSED) {
451
+ LoggerProxy.logger.log(
452
+ `Reachability:index#setLatencyAndClose --> Attempting to set latency of ${elapsed} on closed peerConnection.`
453
+ );
454
+
455
+ return;
456
+ }
457
+
458
+ this.clusterLatencyResults[key] = this.clusterLatencyResults[key] || intialState;
459
+ this.clusterLatencyResults[key][resultKey] += 1;
460
+
461
+ // Set to null in case this fired from
462
+ // an event other than onIceCandidate
463
+ peerConnection.onicecandidate = null;
464
+ peerConnection.close();
465
+ // @ts-ignore
466
+ peerConnection.elapsed = elapsed;
467
+ }
468
+
469
+ /**
470
+ * utility function
471
+ * @returns {undefined}
472
+ * @private
473
+ * @memberof Reachability
474
+ */
475
+ private setup() {
476
+ this.clusterLatencyResults = {};
477
+ }
478
+ }