@webex/plugin-meetings 3.0.0-beta.26 → 3.0.0-beta.261

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 (361) hide show
  1. package/README.md +46 -8
  2. package/dist/annotation/annotation.types.js +7 -0
  3. package/dist/annotation/annotation.types.js.map +1 -0
  4. package/dist/annotation/constants.js +49 -0
  5. package/dist/annotation/constants.js.map +1 -0
  6. package/dist/annotation/index.js +342 -0
  7. package/dist/annotation/index.js.map +1 -0
  8. package/dist/breakouts/breakout.js +114 -14
  9. package/dist/breakouts/breakout.js.map +1 -1
  10. package/dist/breakouts/edit-lock-error.js +52 -0
  11. package/dist/breakouts/edit-lock-error.js.map +1 -0
  12. package/dist/breakouts/events.js +45 -0
  13. package/dist/breakouts/events.js.map +1 -0
  14. package/dist/breakouts/index.js +841 -19
  15. package/dist/breakouts/index.js.map +1 -1
  16. package/dist/breakouts/request.js +78 -0
  17. package/dist/breakouts/request.js.map +1 -0
  18. package/dist/breakouts/utils.js +67 -0
  19. package/dist/breakouts/utils.js.map +1 -0
  20. package/dist/common/errors/webex-errors.js +28 -7
  21. package/dist/common/errors/webex-errors.js.map +1 -1
  22. package/dist/common/logs/logger-proxy.js +1 -1
  23. package/dist/common/logs/logger-proxy.js.map +1 -1
  24. package/dist/common/queue.js +24 -9
  25. package/dist/common/queue.js.map +1 -1
  26. package/dist/config.js +5 -10
  27. package/dist/config.js.map +1 -1
  28. package/dist/constants.js +196 -28
  29. package/dist/constants.js.map +1 -1
  30. package/dist/controls-options-manager/enums.js +14 -2
  31. package/dist/controls-options-manager/enums.js.map +1 -1
  32. package/dist/controls-options-manager/index.js +109 -15
  33. package/dist/controls-options-manager/index.js.map +1 -1
  34. package/dist/controls-options-manager/types.js +7 -0
  35. package/dist/controls-options-manager/types.js.map +1 -0
  36. package/dist/controls-options-manager/util.js +309 -18
  37. package/dist/controls-options-manager/util.js.map +1 -1
  38. package/dist/index.js +112 -1
  39. package/dist/index.js.map +1 -1
  40. package/dist/interpretation/collection.js +23 -0
  41. package/dist/interpretation/collection.js.map +1 -0
  42. package/dist/interpretation/index.js +366 -0
  43. package/dist/interpretation/index.js.map +1 -0
  44. package/dist/interpretation/siLanguage.js +25 -0
  45. package/dist/interpretation/siLanguage.js.map +1 -0
  46. package/dist/locus-info/controlsUtils.js +91 -2
  47. package/dist/locus-info/controlsUtils.js.map +1 -1
  48. package/dist/locus-info/index.js +381 -62
  49. package/dist/locus-info/index.js.map +1 -1
  50. package/dist/locus-info/infoUtils.js +7 -1
  51. package/dist/locus-info/infoUtils.js.map +1 -1
  52. package/dist/locus-info/mediaSharesUtils.js +43 -1
  53. package/dist/locus-info/mediaSharesUtils.js.map +1 -1
  54. package/dist/locus-info/parser.js +224 -63
  55. package/dist/locus-info/parser.js.map +1 -1
  56. package/dist/locus-info/selfUtils.js +89 -14
  57. package/dist/locus-info/selfUtils.js.map +1 -1
  58. package/dist/media/index.js +58 -116
  59. package/dist/media/index.js.map +1 -1
  60. package/dist/media/properties.js +60 -121
  61. package/dist/media/properties.js.map +1 -1
  62. package/dist/meeting/in-meeting-actions.js +82 -2
  63. package/dist/meeting/in-meeting-actions.js.map +1 -1
  64. package/dist/meeting/index.js +3022 -2795
  65. package/dist/meeting/index.js.map +1 -1
  66. package/dist/meeting/locusMediaRequest.js +292 -0
  67. package/dist/meeting/locusMediaRequest.js.map +1 -0
  68. package/dist/meeting/muteState.js +230 -124
  69. package/dist/meeting/muteState.js.map +1 -1
  70. package/dist/meeting/request.js +256 -196
  71. package/dist/meeting/request.js.map +1 -1
  72. package/dist/meeting/util.js +601 -417
  73. package/dist/meeting/util.js.map +1 -1
  74. package/dist/meeting-info/index.js +70 -7
  75. package/dist/meeting-info/index.js.map +1 -1
  76. package/dist/meeting-info/meeting-info-v2.js +189 -51
  77. package/dist/meeting-info/meeting-info-v2.js.map +1 -1
  78. package/dist/meeting-info/util.js +1 -1
  79. package/dist/meeting-info/util.js.map +1 -1
  80. package/dist/meeting-info/utilv2.js +36 -36
  81. package/dist/meeting-info/utilv2.js.map +1 -1
  82. package/dist/meetings/collection.js +22 -0
  83. package/dist/meetings/collection.js.map +1 -1
  84. package/dist/meetings/index.js +372 -90
  85. package/dist/meetings/index.js.map +1 -1
  86. package/dist/meetings/meetings.types.js +7 -0
  87. package/dist/meetings/meetings.types.js.map +1 -0
  88. package/dist/meetings/request.js +2 -0
  89. package/dist/meetings/request.js.map +1 -1
  90. package/dist/meetings/util.js +88 -1
  91. package/dist/meetings/util.js.map +1 -1
  92. package/dist/member/index.js +49 -0
  93. package/dist/member/index.js.map +1 -1
  94. package/dist/member/types.js +25 -0
  95. package/dist/member/types.js.map +1 -0
  96. package/dist/member/util.js +121 -25
  97. package/dist/member/util.js.map +1 -1
  98. package/dist/members/collection.js +10 -0
  99. package/dist/members/collection.js.map +1 -1
  100. package/dist/members/index.js +86 -5
  101. package/dist/members/index.js.map +1 -1
  102. package/dist/members/request.js +106 -38
  103. package/dist/members/request.js.map +1 -1
  104. package/dist/members/types.js +15 -0
  105. package/dist/members/types.js.map +1 -0
  106. package/dist/members/util.js +316 -233
  107. package/dist/members/util.js.map +1 -1
  108. package/dist/metrics/constants.js +10 -5
  109. package/dist/metrics/constants.js.map +1 -1
  110. package/dist/metrics/index.js +1 -468
  111. package/dist/metrics/index.js.map +1 -1
  112. package/dist/multistream/mediaRequestManager.js +238 -49
  113. package/dist/multistream/mediaRequestManager.js.map +1 -1
  114. package/dist/multistream/receiveSlot.js +49 -16
  115. package/dist/multistream/receiveSlot.js.map +1 -1
  116. package/dist/multistream/receiveSlotManager.js +52 -34
  117. package/dist/multistream/receiveSlotManager.js.map +1 -1
  118. package/dist/multistream/remoteMedia.js +44 -18
  119. package/dist/multistream/remoteMedia.js.map +1 -1
  120. package/dist/multistream/remoteMediaGroup.js +60 -3
  121. package/dist/multistream/remoteMediaGroup.js.map +1 -1
  122. package/dist/multistream/remoteMediaManager.js +209 -59
  123. package/dist/multistream/remoteMediaManager.js.map +1 -1
  124. package/dist/multistream/sendSlotManager.js +233 -0
  125. package/dist/multistream/sendSlotManager.js.map +1 -0
  126. package/dist/reachability/index.js +161 -57
  127. package/dist/reachability/index.js.map +1 -1
  128. package/dist/reachability/request.js +17 -8
  129. package/dist/reachability/request.js.map +1 -1
  130. package/dist/reconnection-manager/index.js +199 -154
  131. package/dist/reconnection-manager/index.js.map +1 -1
  132. package/dist/recording-controller/index.js +21 -2
  133. package/dist/recording-controller/index.js.map +1 -1
  134. package/dist/recording-controller/util.js +9 -8
  135. package/dist/recording-controller/util.js.map +1 -1
  136. package/dist/roap/index.js +23 -29
  137. package/dist/roap/index.js.map +1 -1
  138. package/dist/roap/request.js +112 -97
  139. package/dist/roap/request.js.map +1 -1
  140. package/dist/roap/turnDiscovery.js +96 -36
  141. package/dist/roap/turnDiscovery.js.map +1 -1
  142. package/dist/rtcMetrics/constants.js +12 -0
  143. package/dist/rtcMetrics/constants.js.map +1 -0
  144. package/dist/rtcMetrics/index.js +117 -0
  145. package/dist/rtcMetrics/index.js.map +1 -0
  146. package/dist/statsAnalyzer/index.js +51 -34
  147. package/dist/statsAnalyzer/index.js.map +1 -1
  148. package/dist/statsAnalyzer/mqaUtil.js +6 -6
  149. package/dist/statsAnalyzer/mqaUtil.js.map +1 -1
  150. package/dist/types/annotation/annotation.types.d.ts +42 -0
  151. package/dist/types/annotation/constants.d.ts +31 -0
  152. package/dist/types/annotation/index.d.ts +117 -0
  153. package/dist/types/breakouts/edit-lock-error.d.ts +15 -0
  154. package/dist/types/breakouts/events.d.ts +8 -0
  155. package/dist/types/breakouts/request.d.ts +22 -0
  156. package/dist/types/breakouts/utils.d.ts +15 -0
  157. package/dist/types/common/errors/webex-errors.d.ts +13 -1
  158. package/dist/types/common/queue.d.ts +9 -7
  159. package/dist/types/config.d.ts +1 -6
  160. package/dist/types/constants.d.ts +155 -21
  161. package/dist/types/controls-options-manager/enums.d.ts +11 -1
  162. package/dist/types/controls-options-manager/index.d.ts +17 -1
  163. package/dist/types/controls-options-manager/types.d.ts +43 -0
  164. package/dist/types/controls-options-manager/util.d.ts +1 -7
  165. package/dist/types/index.d.ts +6 -4
  166. package/dist/types/interpretation/collection.d.ts +5 -0
  167. package/dist/types/interpretation/index.d.ts +5 -0
  168. package/dist/types/interpretation/siLanguage.d.ts +5 -0
  169. package/dist/types/locus-info/index.d.ts +57 -4
  170. package/dist/types/locus-info/parser.d.ts +65 -6
  171. package/dist/types/media/index.d.ts +2 -0
  172. package/dist/types/media/properties.d.ts +34 -48
  173. package/dist/types/meeting/in-meeting-actions.d.ts +82 -2
  174. package/dist/types/meeting/index.d.ts +344 -506
  175. package/dist/types/meeting/locusMediaRequest.d.ts +74 -0
  176. package/dist/types/meeting/muteState.d.ts +99 -23
  177. package/dist/types/meeting/request.d.ts +72 -43
  178. package/dist/types/meeting/util.d.ts +101 -1
  179. package/dist/types/meeting-info/index.d.ts +13 -1
  180. package/dist/types/meeting-info/meeting-info-v2.d.ts +31 -1
  181. package/dist/types/meetings/collection.d.ts +8 -0
  182. package/dist/types/meetings/index.d.ts +86 -12
  183. package/dist/types/meetings/meetings.types.d.ts +4 -0
  184. package/dist/types/member/index.d.ts +13 -0
  185. package/dist/types/member/types.d.ts +32 -0
  186. package/dist/types/members/collection.d.ts +5 -0
  187. package/dist/types/members/index.d.ts +35 -2
  188. package/dist/types/members/request.d.ts +73 -9
  189. package/dist/types/members/types.d.ts +24 -0
  190. package/dist/types/members/util.d.ts +209 -1
  191. package/dist/types/metrics/constants.d.ts +9 -4
  192. package/dist/types/metrics/index.d.ts +4 -119
  193. package/dist/types/multistream/mediaRequestManager.d.ts +73 -5
  194. package/dist/types/multistream/receiveSlot.d.ts +16 -12
  195. package/dist/types/multistream/receiveSlotManager.d.ts +19 -4
  196. package/dist/types/multistream/remoteMedia.d.ts +8 -29
  197. package/dist/types/multistream/remoteMediaGroup.d.ts +0 -9
  198. package/dist/types/multistream/remoteMediaManager.d.ts +46 -2
  199. package/dist/types/multistream/sendSlotManager.d.ts +61 -0
  200. package/dist/types/reachability/index.d.ts +44 -7
  201. package/dist/types/reachability/request.d.ts +7 -3
  202. package/dist/types/reconnection-manager/index.d.ts +9 -0
  203. package/dist/types/recording-controller/index.d.ts +15 -1
  204. package/dist/types/recording-controller/util.d.ts +5 -4
  205. package/dist/types/roap/request.d.ts +15 -11
  206. package/dist/types/roap/turnDiscovery.d.ts +18 -1
  207. package/dist/types/rtcMetrics/constants.d.ts +4 -0
  208. package/dist/types/rtcMetrics/index.d.ts +47 -0
  209. package/dist/types/statsAnalyzer/index.d.ts +6 -1
  210. package/package.json +23 -20
  211. package/src/annotation/annotation.types.ts +50 -0
  212. package/src/annotation/constants.ts +36 -0
  213. package/src/annotation/index.ts +328 -0
  214. package/src/breakouts/README.md +44 -14
  215. package/src/breakouts/breakout.ts +87 -9
  216. package/src/breakouts/edit-lock-error.ts +25 -0
  217. package/src/breakouts/events.ts +56 -0
  218. package/src/breakouts/index.ts +710 -10
  219. package/src/breakouts/request.ts +55 -0
  220. package/src/breakouts/utils.ts +57 -0
  221. package/src/common/errors/webex-errors.ts +27 -2
  222. package/src/common/logs/logger-proxy.ts +1 -1
  223. package/src/common/queue.ts +22 -8
  224. package/src/config.ts +4 -9
  225. package/src/constants.ts +178 -18
  226. package/src/controls-options-manager/enums.ts +12 -0
  227. package/src/controls-options-manager/index.ts +116 -21
  228. package/src/controls-options-manager/types.ts +59 -0
  229. package/src/controls-options-manager/util.ts +294 -14
  230. package/src/index.ts +40 -0
  231. package/src/interpretation/README.md +60 -0
  232. package/src/interpretation/collection.ts +19 -0
  233. package/src/interpretation/index.ts +332 -0
  234. package/src/interpretation/siLanguage.ts +18 -0
  235. package/src/locus-info/controlsUtils.ts +108 -0
  236. package/src/locus-info/index.ts +412 -59
  237. package/src/locus-info/infoUtils.ts +10 -2
  238. package/src/locus-info/mediaSharesUtils.ts +48 -0
  239. package/src/locus-info/parser.ts +231 -39
  240. package/src/locus-info/selfUtils.ts +81 -5
  241. package/src/media/index.ts +100 -122
  242. package/src/media/properties.ts +70 -108
  243. package/src/meeting/in-meeting-actions.ts +163 -3
  244. package/src/meeting/index.ts +2471 -2306
  245. package/src/meeting/locusMediaRequest.ts +313 -0
  246. package/src/meeting/muteState.ts +229 -131
  247. package/src/meeting/request.ts +172 -121
  248. package/src/meeting/util.ts +588 -394
  249. package/src/meeting-info/index.ts +79 -8
  250. package/src/meeting-info/meeting-info-v2.ts +168 -14
  251. package/src/meeting-info/util.ts +1 -1
  252. package/src/meeting-info/utilv2.ts +23 -23
  253. package/src/meetings/collection.ts +20 -0
  254. package/src/meetings/index.ts +414 -108
  255. package/src/meetings/meetings.types.ts +12 -0
  256. package/src/meetings/request.ts +2 -0
  257. package/src/meetings/util.ts +103 -4
  258. package/src/member/index.ts +49 -0
  259. package/src/member/types.ts +38 -0
  260. package/src/member/util.ts +127 -25
  261. package/src/members/collection.ts +8 -0
  262. package/src/members/index.ts +107 -6
  263. package/src/members/request.ts +97 -17
  264. package/src/members/types.ts +28 -0
  265. package/src/members/util.ts +319 -240
  266. package/src/metrics/constants.ts +9 -4
  267. package/src/metrics/index.ts +1 -490
  268. package/src/multistream/mediaRequestManager.ts +289 -79
  269. package/src/multistream/receiveSlot.ts +55 -18
  270. package/src/multistream/receiveSlotManager.ts +46 -24
  271. package/src/multistream/remoteMedia.ts +27 -2
  272. package/src/multistream/remoteMediaGroup.ts +59 -0
  273. package/src/multistream/remoteMediaManager.ts +148 -30
  274. package/src/multistream/sendSlotManager.ts +170 -0
  275. package/src/reachability/index.ts +165 -37
  276. package/src/reachability/request.ts +17 -8
  277. package/src/reconnection-manager/index.ts +81 -54
  278. package/src/recording-controller/index.ts +20 -3
  279. package/src/recording-controller/util.ts +26 -9
  280. package/src/roap/index.ts +23 -30
  281. package/src/roap/request.ts +100 -104
  282. package/src/roap/turnDiscovery.ts +51 -25
  283. package/src/rtcMetrics/constants.ts +3 -0
  284. package/src/rtcMetrics/index.ts +100 -0
  285. package/src/statsAnalyzer/index.ts +73 -35
  286. package/src/statsAnalyzer/mqaUtil.ts +8 -10
  287. package/test/integration/spec/converged-space-meetings.js +233 -0
  288. package/test/integration/spec/journey.js +320 -261
  289. package/test/integration/spec/space-meeting.js +76 -3
  290. package/test/unit/spec/annotation/index.ts +418 -0
  291. package/test/unit/spec/breakouts/breakout.ts +142 -24
  292. package/test/unit/spec/breakouts/edit-lock-error.ts +30 -0
  293. package/test/unit/spec/breakouts/events.ts +89 -0
  294. package/test/unit/spec/breakouts/index.ts +1545 -48
  295. package/test/unit/spec/breakouts/request.ts +104 -0
  296. package/test/unit/spec/breakouts/utils.js +72 -0
  297. package/test/unit/spec/common/queue.js +31 -2
  298. package/test/unit/spec/controls-options-manager/index.js +163 -0
  299. package/test/unit/spec/controls-options-manager/util.js +576 -60
  300. package/test/unit/spec/fixture/locus.js +1 -0
  301. package/test/unit/spec/interpretation/collection.ts +15 -0
  302. package/test/unit/spec/interpretation/index.ts +589 -0
  303. package/test/unit/spec/interpretation/siLanguage.ts +28 -0
  304. package/test/unit/spec/locus-info/controlsUtils.js +316 -43
  305. package/test/unit/spec/locus-info/index.js +1283 -33
  306. package/test/unit/spec/locus-info/infoUtils.js +37 -15
  307. package/test/unit/spec/locus-info/mediaSharesUtils.ts +22 -0
  308. package/test/unit/spec/locus-info/parser.js +62 -22
  309. package/test/unit/spec/locus-info/selfConstant.js +27 -4
  310. package/test/unit/spec/locus-info/selfUtils.js +208 -17
  311. package/test/unit/spec/media/index.ts +104 -37
  312. package/test/unit/spec/meeting/in-meeting-actions.ts +81 -3
  313. package/test/unit/spec/meeting/index.js +4095 -1913
  314. package/test/unit/spec/meeting/locusMediaRequest.ts +442 -0
  315. package/test/unit/spec/meeting/muteState.js +408 -208
  316. package/test/unit/spec/meeting/request.js +440 -45
  317. package/test/unit/spec/meeting/utils.js +679 -64
  318. package/test/unit/spec/meeting-info/index.js +293 -0
  319. package/test/unit/spec/meeting-info/meetinginfov2.js +517 -5
  320. package/test/unit/spec/meeting-info/utilv2.js +21 -0
  321. package/test/unit/spec/meetings/collection.js +14 -0
  322. package/test/unit/spec/meetings/index.js +941 -151
  323. package/test/unit/spec/meetings/utils.js +206 -2
  324. package/test/unit/spec/member/index.js +58 -4
  325. package/test/unit/spec/member/util.js +479 -35
  326. package/test/unit/spec/members/index.js +319 -1
  327. package/test/unit/spec/members/request.js +206 -27
  328. package/test/unit/spec/members/utils.js +184 -0
  329. package/test/unit/spec/metrics/index.js +1 -50
  330. package/test/unit/spec/multistream/mediaRequestManager.ts +803 -162
  331. package/test/unit/spec/multistream/receiveSlot.ts +72 -13
  332. package/test/unit/spec/multistream/receiveSlotManager.ts +58 -28
  333. package/test/unit/spec/multistream/remoteMedia.ts +30 -0
  334. package/test/unit/spec/multistream/remoteMediaGroup.ts +266 -0
  335. package/test/unit/spec/multistream/remoteMediaManager.ts +326 -0
  336. package/test/unit/spec/multistream/sendSlotManager.ts +242 -0
  337. package/test/unit/spec/reachability/index.ts +343 -9
  338. package/test/unit/spec/reachability/request.js +68 -0
  339. package/test/unit/spec/reconnection-manager/index.js +84 -9
  340. package/test/unit/spec/recording-controller/index.js +294 -218
  341. package/test/unit/spec/recording-controller/util.js +223 -96
  342. package/test/unit/spec/roap/index.ts +31 -51
  343. package/test/unit/spec/roap/request.ts +203 -85
  344. package/test/unit/spec/roap/turnDiscovery.ts +48 -13
  345. package/test/unit/spec/rtcMetrics/index.ts +68 -0
  346. package/test/unit/spec/stats-analyzer/index.js +29 -2
  347. package/test/utils/constants.js +9 -0
  348. package/test/utils/integrationTestUtils.js +46 -0
  349. package/test/utils/testUtils.js +0 -45
  350. package/test/utils/webex-config.js +4 -0
  351. package/test/utils/webex-test-users.js +6 -3
  352. package/dist/meeting/effectsState.js +0 -262
  353. package/dist/meeting/effectsState.js.map +0 -1
  354. package/dist/metrics/config.js +0 -299
  355. package/dist/metrics/config.js.map +0 -1
  356. package/dist/types/meeting/effectsState.d.ts +0 -42
  357. package/dist/types/metrics/config.d.ts +0 -178
  358. package/src/index.js +0 -16
  359. package/src/meeting/effectsState.ts +0 -211
  360. package/src/metrics/config.ts +0 -495
  361. package/test/unit/spec/meeting/effectsState.js +0 -285
@@ -7,6 +7,7 @@ declare const BEHAVIORAL_METRICS: {
7
7
  JOIN_FAILURE: string;
8
8
  ADD_MEDIA_SUCCESS: string;
9
9
  ADD_MEDIA_FAILURE: string;
10
+ ROAP_MERCURY_EVENT_RECEIVED: string;
10
11
  CONNECTION_SUCCESS: string;
11
12
  CONNECTION_FAILURE: string;
12
13
  MEETING_LEAVE_FAILURE: string;
@@ -15,6 +16,8 @@ declare const BEHAVIORAL_METRICS: {
15
16
  GET_USER_MEDIA_FAILURE: string;
16
17
  GET_DISPLAY_MEDIA_FAILURE: string;
17
18
  JOIN_WITH_MEDIA_FAILURE: string;
19
+ LLM_CONNECTION_AFTER_JOIN_FAILURE: string;
20
+ RECEIVE_TRANSCRIPTION_AFTER_JOIN_FAILURE: string;
18
21
  DISCONNECT_DUE_TO_INACTIVITY: string;
19
22
  MEETING_MEDIA_INACTIVE: string;
20
23
  MEETING_RECONNECT_FAILURE: string;
@@ -36,11 +39,8 @@ declare const BEHAVIORAL_METRICS: {
36
39
  PEERCONNECTION_FAILURE: string;
37
40
  INVALID_ICE_CANDIDATE: string;
38
41
  UPLOAD_LOGS_FAILURE: string;
42
+ UPLOAD_LOGS_SUCCESS: string;
39
43
  RECEIVE_TRANSCRIPTION_FAILURE: string;
40
- ENABLE_BNR_SUCCESS: string;
41
- ENABLE_BNR_FAILURE: string;
42
- DISABLE_BNR_SUCCESS: string;
43
- DISABLE_BNR_FAILURE: string;
44
44
  FETCH_MEETING_INFO_V1_SUCCESS: string;
45
45
  FETCH_MEETING_INFO_V1_FAILURE: string;
46
46
  ADHOC_MEETING_SUCCESS: string;
@@ -53,5 +53,10 @@ declare const BEHAVIORAL_METRICS: {
53
53
  MOVE_FROM_SUCCESS: string;
54
54
  MOVE_FROM_FAILURE: string;
55
55
  TURN_DISCOVERY_FAILURE: string;
56
+ MEETING_INFO_POLICY_ERROR: string;
57
+ LOCUS_DELTA_SYNC_FAILED: string;
58
+ LOCUS_DELTA_OUT_OF_ORDER: string;
59
+ PERMISSION_TOKEN_REFRESH: string;
60
+ PERMISSION_TOKEN_REFRESH_ERROR: string;
56
61
  };
57
62
  export { BEHAVIORAL_METRICS as default };
@@ -1,3 +1,6 @@
1
+ /*!
2
+ * Copyright (c) 2015-2020 Cisco Systems, Inc. See LICENSE file.
3
+ */
1
4
  /**
2
5
  * @description Metrics handles all the call metrics events
3
6
  * @export
@@ -5,9 +8,6 @@
5
8
  */
6
9
  declare class Metrics {
7
10
  static instance: Metrics;
8
- _events: any;
9
- keys: any;
10
- meetingCollection: any;
11
11
  webex: any;
12
12
  /**
13
13
  * Create Metrics Object
@@ -19,126 +19,11 @@ declare class Metrics {
19
19
  /**
20
20
  * Initializes the Metrics singleton with a meeting Collection.
21
21
  *
22
- * @param {Object} meetingCollection meetings object
23
22
  * @param {Object} webex webex SDK object
24
23
  *
25
24
  * @returns {void}
26
25
  */
27
- initialSetup(meetingCollection: object, webex: object): void;
28
- /**
29
- * poste Meeting event metrics
30
- * @param {object} options {meetingId/meeting} as a json object
31
- * @param {Meeting} options.meeting Meeting object
32
- * @param {String} options.meetingId
33
- * @param {object} options.data
34
- * @param {object} options.event
35
- * @returns {object} null
36
- */
37
- postEvent(options: {
38
- meeting?: any;
39
- meetingId?: string;
40
- data?: object;
41
- event?: any;
42
- } | any): void;
43
- /**
44
- * Docs for Call analyzer metrics
45
- * https://sqbu-github.cisco.com/WebExSquared/call-analyzer/wiki
46
- * https://sqbu-github.cisco.com/WebExSquared/event-dictionary/blob/master/diagnostic-events.raml
47
- */
48
- initPayload(eventType: any, identifiers: any, options: any): any;
49
- /**
50
- * returns metrics friendly OS versions
51
- * @param {String} osName Os name
52
- * @returns {String}
53
- * @private
54
- * @memberof Metrics
55
- */
56
- private getOsName;
57
- /**
58
- * get the payload specific for a media quality event through call analyzer
59
- * @param {String} eventType the event name
60
- * @param {Object} identifiers contains the identifiers needed for CA
61
- * @param {String} identifiers.correlationId
62
- * @param {String} identifiers.locusUrl
63
- * @param {String} identifiers.locusId
64
- * @param {Object} options
65
- * @param {Object} options.intervalData
66
- * @param {String} options.clientType
67
- * @returns {Object}
68
- * @public
69
- * @memberof Metrics
70
- */
71
- initMediaPayload(eventType: string, identifiers: {
72
- correlationId: string;
73
- locusUrl: string;
74
- locusId: string;
75
- }, options?: {
76
- intervalData: object;
77
- clientType: string;
78
- } | any): {
79
- eventId: any;
80
- version: number;
81
- origin: {
82
- audioSetupDelay: any;
83
- videoSetupDelay: any;
84
- name: string;
85
- networkType: any;
86
- userAgent: string;
87
- clientInfo: {
88
- clientType: any;
89
- clientVersion: string;
90
- localNetworkPrefix: string;
91
- os: any;
92
- osVersion: any;
93
- subClientType: any;
94
- browser: any;
95
- browserVersion: any;
96
- };
97
- };
98
- originTime: {
99
- triggered: string;
100
- };
101
- senderCountryCode: any;
102
- event: {
103
- name: string;
104
- canProceed: boolean;
105
- identifiers: {
106
- correlationId: string;
107
- locusUrl: string;
108
- locusId: string;
109
- };
110
- intervals: any[];
111
- joinTimes: any;
112
- eventData: {
113
- webClientDomain: any;
114
- };
115
- sourceMetadata: {
116
- applicationSoftwareType: string;
117
- applicationSoftwareVersion: any;
118
- mediaEngineSoftwareType: any;
119
- mediaEngineSoftwareVersion: any;
120
- startTime: string;
121
- };
122
- };
123
- };
124
- /**
125
- * This function Parses a Locus error and returns a diagnostic event payload.
126
- * It should keep updating from:
127
- * https://sqbu-github.cisco.com/WebExSquared/spark-client-framework/blob/master/spark-client-framework/Adapters/TelephonyAdapter/TelephonyAdapter.cpp#L920
128
- *
129
- * @param {Object} err the error Object from Locus response
130
- * @param {boolean} showToUser true if a toast is shown to user
131
- * @returns {{showToUser: boolean, category: string, errorDescription: string,
132
- * errorCode: number, errorData: *, fatal: boolean, name: string}}
133
- */
134
- parseLocusError(err: any, showToUser: boolean): any;
135
- generateErrorPayload(errorCode: any, shownToUser: any, name: any, err: any): any;
136
- /**
137
- * Returns a formated string of the user agent.
138
- *
139
- * @returns {string} formatted user agent information
140
- */
141
- userAgentToString(): string;
26
+ initialSetup(webex: object): void;
142
27
  /**
143
28
  * Uploads given metric to the Metrics service as an Behavioral metric.
144
29
  * Metadata about the environment such as browser, OS, SDK and their versions
@@ -1,4 +1,4 @@
1
- import { MediaRequest as WcmeMediaRequest } from '@webex/internal-media-core';
1
+ import { StreamRequest } from '@webex/internal-media-core';
2
2
  import { ReceiveSlot } from './receiveSlot';
3
3
  export interface ActiveSpeakerPolicyInfo {
4
4
  policy: 'active-speaker';
@@ -25,26 +25,94 @@ export interface MediaRequest {
25
25
  policyInfo: PolicyInfo;
26
26
  receiveSlots: Array<ReceiveSlot>;
27
27
  codecInfo?: CodecInfo;
28
+ preferredMaxFs?: number;
29
+ handleMaxFs?: ({ maxFs }: {
30
+ maxFs: number;
31
+ }) => void;
28
32
  }
29
33
  export type MediaRequestId = string;
30
34
  type DegradationPreferences = {
31
35
  maxMacroblocksLimit: number;
32
36
  };
33
- type SendMediaRequestsCallback = (mediaRequests: WcmeMediaRequest[]) => void;
37
+ type SendMediaRequestsCallback = (streamRequests: StreamRequest[]) => void;
38
+ type Kind = 'audio' | 'video';
39
+ type Options = {
40
+ degradationPreferences: DegradationPreferences;
41
+ kind: Kind;
42
+ trimRequestsToNumOfSources: boolean;
43
+ };
34
44
  export declare class MediaRequestManager {
35
45
  private sendMediaRequestsCallback;
46
+ private kind;
36
47
  private counter;
37
48
  private clientRequests;
38
- private slotsActiveInLastMediaRequest;
39
49
  private degradationPreferences;
40
- constructor(degradationPreferences: DegradationPreferences, sendMediaRequestsCallback: SendMediaRequestsCallback);
41
- private resetInactiveReceiveSlots;
50
+ private sourceUpdateListener;
51
+ private debouncedSourceUpdateListener;
52
+ private previousStreamRequests;
53
+ private trimRequestsToNumOfSources;
54
+ private numTotalSources;
55
+ private numLiveSources;
56
+ constructor(sendMediaRequestsCallback: SendMediaRequestsCallback, options: Options);
42
57
  setDegradationPreferences(degradationPreferences: DegradationPreferences): void;
43
58
  private getDegradedClientRequests;
59
+ /**
60
+ * Returns true if two stream requests are the same, false otherwise.
61
+ *
62
+ * @param {StreamRequest} streamRequestA - Stream request A for comparison.
63
+ * @param {StreamRequest} streamRequestB - Stream request B for comparison.
64
+ * @returns {boolean} - Whether they are equal.
65
+ */
66
+ isEqual(streamRequestA: StreamRequest, streamRequestB: StreamRequest): boolean;
67
+ /**
68
+ * Compares new stream requests to previous ones and determines
69
+ * if they are the same.
70
+ *
71
+ * @param {StreamRequest[]} newRequests - Array with new requests.
72
+ * @returns {boolean} - True if they are equal, false otherwise.
73
+ */
74
+ private checkIsNewRequestsEqualToPrev;
75
+ /**
76
+ * Returns the maxPayloadBitsPerSecond per Stream
77
+ *
78
+ * If MediaRequestManager kind is "audio", a constant bitrate will be returned.
79
+ * If MediaRequestManager kind is "video", the bitrate will be calculated based
80
+ * on maxFs (default h264 maxFs as fallback if maxFs is not defined)
81
+ *
82
+ * @param {MediaRequest} mediaRequest - mediaRequest to take data from
83
+ * @returns {number} maxPayloadBitsPerSecond
84
+ */
85
+ private getMaxPayloadBitsPerSecond;
86
+ /**
87
+ * Returns the max Macro Blocks per second (maxMbps) per H264 Stream
88
+ *
89
+ * The maxMbps will be calculated based on maxFs and maxFps
90
+ * (default h264 maxFps as fallback if maxFps is not defined)
91
+ *
92
+ * @param {MediaRequest} mediaRequest - mediaRequest to take data from
93
+ * @returns {number} maxMbps
94
+ */
95
+ private getH264MaxMbps;
96
+ /**
97
+ * Clears the previous stream requests.
98
+ *
99
+ * @returns {void}
100
+ */
101
+ clearPreviousRequests(): void;
102
+ /** Modifies the passed in clientRequests and makes sure that in total they don't ask
103
+ * for more streams than there are available.
104
+ *
105
+ * @param {Object} clientRequests
106
+ * @returns {void}
107
+ */
108
+ private trimRequests;
109
+ private getPreferLiveVideo;
110
+ private cloneClientRequests;
44
111
  private sendRequests;
45
112
  addRequest(mediaRequest: MediaRequest, commit?: boolean): MediaRequestId;
46
113
  cancelRequest(requestId: MediaRequestId, commit?: boolean): void;
47
114
  commit(): void;
48
115
  reset(): void;
116
+ setNumCurrentSources(numTotalSources: number, numLiveSources: number): void;
49
117
  }
50
118
  export {};
@@ -1,9 +1,10 @@
1
- import { MediaType, ReceiveSlot as WcmeReceiveSlot, SourceState } from '@webex/internal-media-core';
1
+ import { MediaType, ReceiveSlot as WcmeReceiveSlot, StreamState } from '@webex/internal-media-core';
2
2
  import EventsScope from '../common/events/events-scope';
3
3
  export declare const ReceiveSlotEvents: {
4
4
  SourceUpdate: string;
5
+ MaxFsUpdate: string;
5
6
  };
6
- export type { SourceState } from '@webex/internal-media-core';
7
+ export type { StreamState } from '@webex/internal-media-core';
7
8
  export type CSI = number;
8
9
  export type MemberId = string;
9
10
  export type ReceiveSlotId = string;
@@ -35,14 +36,25 @@ export declare class ReceiveSlot extends EventsScope {
35
36
  * Getter for csi
36
37
  */
37
38
  get csi(): number;
39
+ /**
40
+ * Set the max frame size for this slot
41
+ * @param newFs frame size
42
+ */
43
+ setMaxFs(newFs: any): void;
38
44
  /**
39
45
  * Getter for sourceState
40
46
  */
41
- get sourceState(): SourceState;
47
+ get sourceState(): StreamState;
42
48
  /**
43
49
  * registers event handlers with the underlying ReceiveSlot
44
50
  */
45
- setupEventListeners(): void;
51
+ private setupEventListeners;
52
+ /** Tries to find the member id for this receive slot if it hasn't got one */
53
+ findMemberId(): void;
54
+ /**
55
+ * @returns {string} a log message used to identify the receive slot
56
+ */
57
+ get logString(): string;
46
58
  /**
47
59
  * The MediaStream object associated with this slot.
48
60
  *
@@ -53,12 +65,4 @@ export declare class ReceiveSlot extends EventsScope {
53
65
  * The underlying WCME receive slot
54
66
  */
55
67
  get wcmeReceiveSlot(): WcmeReceiveSlot;
56
- /**
57
- * Resets the source state to the default 'no source' value.
58
- * This function should be called on receive slots that are
59
- * no longer part of a media request. It's needed because WCME
60
- * does not send any more events on such slots, so the sourceState
61
- * value would not represent the truth anymore.
62
- */
63
- resetSourceState(): void;
64
68
  }
@@ -1,5 +1,7 @@
1
- import { MediaType } from '@webex/internal-media-core';
2
- import { ReceiveSlot } from './receiveSlot';
1
+ import { MediaType, ReceiveSlot as WcmeReceiveSlot } from '@webex/internal-media-core';
2
+ import { FindMemberIdCallback, ReceiveSlot } from './receiveSlot';
3
+ export type CreateSlotCallback = (mediaType: MediaType) => Promise<WcmeReceiveSlot>;
4
+ export type { CSI, FindMemberIdCallback } from './receiveSlot';
3
5
  /**
4
6
  * Manages all receive slots used by a meeting. WMCE receive slots cannot be ever deleted,
5
7
  * so this manager has a pool in order to re-use the slots that were released earlier.
@@ -7,12 +9,13 @@ import { ReceiveSlot } from './receiveSlot';
7
9
  export declare class ReceiveSlotManager {
8
10
  private allocatedSlots;
9
11
  private freeSlots;
10
- private meeting;
12
+ private createSlotCallback;
13
+ private findMemberIdByCsiCallback;
11
14
  /**
12
15
  * Constructor
13
16
  * @param {Meeting} meeting
14
17
  */
15
- constructor(meeting: any);
18
+ constructor(createSlotCallback: CreateSlotCallback, findMemberIdByCsiCallback: FindMemberIdCallback);
16
19
  /**
17
20
  * Creates a new receive slot or returns one from the existing pool of free slots
18
21
  *
@@ -38,4 +41,16 @@ export declare class ReceiveSlotManager {
38
41
  numAllocatedSlots: {};
39
42
  numFreeSlots: {};
40
43
  };
44
+ /**
45
+ * Tries to find the member id on all allocated receive slots
46
+ * This function should be called when new members are added to the meeting.
47
+ */
48
+ updateMemberIds(): void;
49
+ /**
50
+ * Find a receive slot by a ssrc.
51
+ *
52
+ * @param ssrc - The ssrc of the receive slot to find.
53
+ * @returns - The receive slot with this ssrc, undefined if not found.
54
+ */
55
+ findReceiveSlotBySsrc(ssrc: number): ReceiveSlot | undefined;
41
56
  }
@@ -1,7 +1,7 @@
1
- import { MediaType, SourceState } from '@webex/internal-media-core';
1
+ import { MediaType, StreamState } from '@webex/internal-media-core';
2
2
  import EventsScope from '../common/events/events-scope';
3
3
  import { MediaRequestManager } from './mediaRequestManager';
4
- import { CSI, ReceiveSlot } from './receiveSlot';
4
+ import { ReceiveSlot } from './receiveSlot';
5
5
  export declare const RemoteMediaEvents: {
6
6
  SourceUpdate: string;
7
7
  Stopped: string;
@@ -38,28 +38,12 @@ export declare class RemoteMedia extends EventsScope {
38
38
  */
39
39
  constructor(receiveSlot: ReceiveSlot, mediaRequestManager: MediaRequestManager, options?: Options);
40
40
  /**
41
- * Invalidates the remote media by clearing the reference to a receive slot and
42
- * cancelling the media request.
43
- * After this call the remote media is unusable.
44
- *
45
- * @param {boolean} commit - whether to commit the cancellation of the media request
46
- * @internal
47
- */
48
- stop(commit?: boolean): void;
49
- /**
50
- * Sends a new media request. This method can only be used for receiver-selected policy,
51
- * because only in that policy we have a 1-1 relationship between RemoteMedia and MediaRequest
52
- * and the request id is then stored in this RemoteMedia instance.
53
- * For active-speaker policy, the same request is shared among many RemoteMedia instances,
54
- * so it's managed through RemoteMediaGroup
55
- *
56
- * @internal
41
+ * Supply the width and height of the video element
42
+ * to restrict the requested resolution to this size
43
+ * @param width width of the video element
44
+ * @param height height of the video element
57
45
  */
58
- sendMediaRequest(csi: CSI, commit: boolean): void;
59
- /**
60
- * @internal
61
- */
62
- cancelMediaRequest(commit: boolean): void;
46
+ setSizeHint(width: any, height: any): void;
63
47
  /**
64
48
  * registers event listeners on the receive slot and forwards all the events
65
49
  */
@@ -79,15 +63,10 @@ export declare class RemoteMedia extends EventsScope {
79
63
  /**
80
64
  * Getter for source state
81
65
  */
82
- get sourceState(): SourceState;
66
+ get sourceState(): StreamState;
83
67
  /**
84
68
  * Getter for remote media stream
85
69
  */
86
70
  get stream(): MediaStream;
87
- /**
88
- * @internal
89
- * @returns {ReceiveSlot}
90
- */
91
- getUnderlyingReceiveSlot(): ReceiveSlot;
92
71
  }
93
72
  export {};
@@ -35,15 +35,6 @@ export declare class RemoteMediaGroup {
35
35
  isPinned(remoteMedia: RemoteMedia): boolean;
36
36
  private sendActiveSpeakerMediaRequest;
37
37
  private cancelActiveSpeakerMediaRequest;
38
- /**
39
- * Invalidates the remote media group by clearing the references to the receive slots
40
- * used by all remote media from that group and cancelling all media requests.
41
- * After this call the remote media group is unusable.
42
- *
43
- * @param{boolean} commit whether to commit the cancellation of media requests
44
- * @internal
45
- */
46
- stop(commit?: boolean): void;
47
38
  /**
48
39
  * Checks if a given RemoteMedia instance belongs to this group.
49
40
  *
@@ -139,6 +139,20 @@ export declare class RemoteMediaManager extends EventsScope {
139
139
  * @returns {LayoutId}
140
140
  */
141
141
  getLayoutId(): LayoutId | undefined;
142
+ /**
143
+ * sets the preferLiveVideo
144
+ */
145
+ setPreferLiveVideo(preferLiveVideo: boolean): void;
146
+ /**
147
+ * Sets CSIs for multiple RemoteMedia instances belonging to RemoteMediaGroup.
148
+ * For each entry in the remoteMediaCsis array:
149
+ * - if csi is specified, the RemoteMedia instance is pinned to that CSI
150
+ * - if csi is undefined, the RemoteMedia instance is unpinned
151
+ */
152
+ setActiveSpeakerCsis(remoteMediaCsis: {
153
+ remoteMedia: RemoteMedia;
154
+ csi?: number;
155
+ }[]): void;
142
156
  /**
143
157
  * Creates the audio slots
144
158
  */
@@ -161,9 +175,39 @@ export declare class RemoteMediaManager extends EventsScope {
161
175
  */
162
176
  private releaseUnusedVideoSlots;
163
177
  /**
164
- * Allocates receive slots to all video panes in the current selected layout
178
+ * Allocates receive slots to all active speaker video panes
179
+ * in the current selected layout.
180
+ *
181
+ * Allocation tries to keep the same order of the slots between the previous
182
+ * layout and the new one. Sorting helps making sure that highest priority slots
183
+ * go in the same order in the new layout.
184
+ */
185
+ private allocateSlotsToActiveSpeakerPaneGroups;
186
+ /**
187
+ * Allocates receive slots to all receiver selected video panes
188
+ * in the current selected layout
189
+ */
190
+ private allocateSlotsToReceiverSelectedVideoPaneGroups;
191
+ /**
192
+ * Ensures that we have enough slots for the current layout.
193
+ */
194
+ private refillRequiredSlotsIfNeeded;
195
+ /**
196
+ * Move all active speaker slots to "unused"
197
+ */
198
+ private trimActiveSpeakerSlots;
199
+ /**
200
+ * Logs the state of the receive slots
165
201
  */
166
- private allocateSlotsToVideoPaneGroups;
202
+ private logMainVideoReceiveSlots;
203
+ /** logs main audio slots */
204
+ private logMainAudioReceiveSlots;
205
+ /** logs slides video slots */
206
+ private logSlidesVideoReceiveSlots;
207
+ /** logs slides audio slots */
208
+ private logSlidesAudioReceiveSlots;
209
+ /** Logs all current receive slots */
210
+ logAllReceiveSlots(): void;
167
211
  /**
168
212
  * Makes sure we have the right number of receive slots created for the current layout
169
213
  * and allocates them to the right video panes / pane groups
@@ -0,0 +1,61 @@
1
+ import { SendSlot, MediaType, LocalStream, MultistreamRoapMediaConnection } from '@webex/internal-media-core';
2
+ export default class SendSlotManager {
3
+ private readonly slots;
4
+ private readonly LoggerProxy;
5
+ constructor(LoggerProxy: any);
6
+ /**
7
+ * This method is used to create a sendSlot for the given mediaType and returns the created sendSlot
8
+ * @param {MultistreamRoapMediaConnection} mediaConnection MultistreamRoapMediaConnection for which a sendSlot needs to be created
9
+ * @param {MediaType} mediaType MediaType for which a sendSlot needs to be created (AUDIO_MAIN/VIDEO_MAIN/AUDIO_SLIDES/VIDEO_SLIDES)
10
+ * @param {boolean} active This is optional boolean to set the active state of the sendSlot. Default is true
11
+ * @returns {SendSlot} slot The created sendSlot
12
+ */
13
+ createSlot(mediaConnection: MultistreamRoapMediaConnection, mediaType: MediaType, active?: boolean): SendSlot;
14
+ /**
15
+ * This method is used to retrieve the sendSlot for the given mediaType
16
+ * @param {MediaType} mediaType of which the slot needs to be retrieved
17
+ * @returns {SendSlot}
18
+ */
19
+ getSlot(mediaType: MediaType): SendSlot;
20
+ /**
21
+ * This method publishes the given stream to the sendSlot for the given mediaType
22
+ * @param {MediaType} mediaType MediaType of the sendSlot to which a stream needs to be published (AUDIO_MAIN/VIDEO_MAIN/AUDIO_SLIDES/VIDEO_SLIDES)
23
+ * @param {LocalStream} stream LocalStream to be published
24
+ * @returns {Promise<void>}
25
+ */
26
+ publishStream(mediaType: MediaType, stream: LocalStream): Promise<void>;
27
+ /**
28
+ * This method unpublishes the stream from the sendSlot of the given mediaType
29
+ * @param {MediaType} mediaType MediaType of the sendSlot from which a stream needs to be unpublished (AUDIO_MAIN/VIDEO_MAIN/AUDIO_SLIDES/VIDEO_SLIDES)
30
+ * @returns {Promise<void>}
31
+ */
32
+ unpublishStream(mediaType: MediaType): Promise<void>;
33
+ /**
34
+ * This method is used to set the active state of the sendSlot for the given mediaType
35
+ * @param {MediaType} mediaType The MediaType of the sendSlot for which the active state needs to be set (AUDIO_MAIN/VIDEO_MAIN/AUDIO_SLIDES/VIDEO_SLIDES)
36
+ * @param {boolean} active The boolean to set the active state of the sendSlot. Default is true
37
+ * @returns {void}
38
+ */
39
+ setActive(mediaType: MediaType, active?: boolean): void;
40
+ /**
41
+ * This method is used to set the codec parameters for the sendSlot of the given mediaType
42
+ * @param {MediaType} mediaType MediaType of the sendSlot for which the codec parameters needs to be set (AUDIO_MAIN/VIDEO_MAIN/AUDIO_SLIDES/VIDEO_SLIDES)
43
+ * @param {Object} codecParameters
44
+ * @returns {Promise<void>}
45
+ */
46
+ setCodecParameters(mediaType: MediaType, codecParameters: {
47
+ [key: string]: string | undefined;
48
+ }): Promise<void>;
49
+ /**
50
+ * This method is used to delete the codec parameters for the sendSlot of the given mediaType
51
+ * @param {MediaType} mediaType MediaType of the sendSlot for which the codec parameters needs to be deleted (AUDIO_MAIN/VIDEO_MAIN/AUDIO_SLIDES/VIDEO_SLIDES)
52
+ * @param {Array<String>} parameters Array of keys of the codec parameters to be deleted
53
+ * @returns {Promise<void>}
54
+ */
55
+ deleteCodecParameters(mediaType: MediaType, parameters: string[]): Promise<void>;
56
+ /**
57
+ * This method is used to reset the SendSlotsManager by deleting all the sendSlots
58
+ * @returns {undefined}
59
+ */
60
+ reset(): void;
61
+ }
@@ -1,6 +1,29 @@
1
1
  /*!
2
2
  * Copyright (c) 2015-2020 Cisco Systems, Inc. See LICENSE file.
3
3
  */
4
+ export type TransportResult = {
5
+ reachable: 'true' | 'false';
6
+ latencyInMilliseconds?: string;
7
+ clientMediaIPs?: string[];
8
+ untested?: 'true';
9
+ };
10
+ type ReachabilityResult = {
11
+ udp: TransportResult;
12
+ tcp: TransportResult;
13
+ xtls: {
14
+ untested: 'true';
15
+ };
16
+ };
17
+ export type ReachabilityResults = Record<string, ReachabilityResult>;
18
+ type InternalReachabilityResults = Record<string, ReachabilityResult & {
19
+ isVideoMesh?: boolean;
20
+ }>;
21
+ export type ICECandidateResult = {
22
+ clusterId: string;
23
+ isVideoMesh: boolean;
24
+ elapsed?: string | null;
25
+ publicIPs?: string[];
26
+ };
4
27
  /**
5
28
  * @class Reachability
6
29
  * @export
@@ -23,14 +46,20 @@ export default class Reachability {
23
46
  * @async
24
47
  * @memberof Reachability
25
48
  */
26
- gatherReachability(): Promise<unknown>;
49
+ gatherReachability(): Promise<InternalReachabilityResults>;
50
+ /**
51
+ * Reachability results as an object in the format that backend expects
52
+ *
53
+ * @returns {any} reachability results that need to be sent to the backend
54
+ */
55
+ getReachabilityResults(): Promise<ReachabilityResults | undefined>;
27
56
  /**
28
57
  * fetches reachability data and checks for cluster reachability
29
58
  * @returns {boolean}
30
59
  * @public
31
60
  * @memberof Reachability
32
61
  */
33
- isAnyClusterReachable(): Promise<boolean>;
62
+ isAnyPublicClusterReachable(): Promise<boolean>;
34
63
  /**
35
64
  * Generate peerConnection config settings
36
65
  * @param {object} cluster
@@ -94,7 +123,7 @@ export default class Reachability {
94
123
  * speed.
95
124
  * @private
96
125
  * @param {RTCPeerConnection} peerConnection
97
- * @param {number} timeout
126
+ * @param {boolean} isVideoMesh
98
127
  * @returns {Promise}
99
128
  */
100
129
  private iceGatheringState;
@@ -107,20 +136,27 @@ export default class Reachability {
107
136
  private logUnreachableClusters;
108
137
  /**
109
138
  * Calculates time to establish connection
110
- * @param {array} iceResults iceResults
139
+ * @param {Array<ICECandidateResult>} iceResults iceResults
111
140
  * @returns {object} reachabilityMap
112
- * @private
141
+ * @protected
113
142
  * @memberof Reachability
114
143
  */
115
- private parseIceResultsToReachabilityResults;
144
+ protected parseIceResultsToInternalReachabilityResults(iceResults: Array<ICECandidateResult>): InternalReachabilityResults;
116
145
  /**
117
146
  * fetches reachability data
118
147
  * @param {object} clusterList
119
- * @returns {Promise<localSDPData>} reachability check results
148
+ * @returns {Promise<InternalReachabilityResults>} reachability check results
120
149
  * @private
121
150
  * @memberof Reachability
122
151
  */
123
152
  private performReachabilityCheck;
153
+ /**
154
+ * Adds public IP (client media IPs)
155
+ * @param {RTCPeerConnection} peerConnection
156
+ * @param {string} publicIP
157
+ * @returns {void}
158
+ */
159
+ protected addPublicIP(peerConnection: RTCPeerConnection, publicIP?: string | null): void;
124
160
  /**
125
161
  * Records latency and closes the peerConnection
126
162
  * @param {RTCPeerConnection} peerConnection
@@ -138,3 +174,4 @@ export default class Reachability {
138
174
  */
139
175
  private setup;
140
176
  }
177
+ export {};