@dtelecom/livekit-client 1.12.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 (279) hide show
  1. package/LICENSE +175 -0
  2. package/README.md +315 -0
  3. package/dist/@dtelecom/livekit-client.e2ee.worker.js +2 -0
  4. package/dist/@dtelecom/livekit-client.e2ee.worker.js.map +1 -0
  5. package/dist/@dtelecom/livekit-client.e2ee.worker.mjs +1633 -0
  6. package/dist/@dtelecom/livekit-client.e2ee.worker.mjs.map +1 -0
  7. package/dist/@dtelecom/livekit-client.esm.mjs +22545 -0
  8. package/dist/@dtelecom/livekit-client.esm.mjs.map +1 -0
  9. package/dist/@dtelecom/livekit-client.umd.js +2 -0
  10. package/dist/@dtelecom/livekit-client.umd.js.map +1 -0
  11. package/dist/@dtelecom/src/api/SignalClient.d.ts +102 -0
  12. package/dist/@dtelecom/src/api/SignalClient.d.ts.map +1 -0
  13. package/dist/@dtelecom/src/connectionHelper/ConnectionCheck.d.ts +26 -0
  14. package/dist/@dtelecom/src/connectionHelper/ConnectionCheck.d.ts.map +1 -0
  15. package/dist/@dtelecom/src/connectionHelper/checks/Checker.d.ts +59 -0
  16. package/dist/@dtelecom/src/connectionHelper/checks/Checker.d.ts.map +1 -0
  17. package/dist/@dtelecom/src/connectionHelper/checks/publishAudio.d.ts +6 -0
  18. package/dist/@dtelecom/src/connectionHelper/checks/publishAudio.d.ts.map +1 -0
  19. package/dist/@dtelecom/src/connectionHelper/checks/publishVideo.d.ts +6 -0
  20. package/dist/@dtelecom/src/connectionHelper/checks/publishVideo.d.ts.map +1 -0
  21. package/dist/@dtelecom/src/connectionHelper/checks/reconnect.d.ts +6 -0
  22. package/dist/@dtelecom/src/connectionHelper/checks/reconnect.d.ts.map +1 -0
  23. package/dist/@dtelecom/src/connectionHelper/checks/turn.d.ts +6 -0
  24. package/dist/@dtelecom/src/connectionHelper/checks/turn.d.ts.map +1 -0
  25. package/dist/@dtelecom/src/connectionHelper/checks/webrtc.d.ts +6 -0
  26. package/dist/@dtelecom/src/connectionHelper/checks/webrtc.d.ts.map +1 -0
  27. package/dist/@dtelecom/src/connectionHelper/checks/websocket.d.ts +6 -0
  28. package/dist/@dtelecom/src/connectionHelper/checks/websocket.d.ts.map +1 -0
  29. package/dist/@dtelecom/src/e2ee/E2eeManager.d.ts +47 -0
  30. package/dist/@dtelecom/src/e2ee/E2eeManager.d.ts.map +1 -0
  31. package/dist/@dtelecom/src/e2ee/KeyProvider.d.ts +44 -0
  32. package/dist/@dtelecom/src/e2ee/KeyProvider.d.ts.map +1 -0
  33. package/dist/@dtelecom/src/e2ee/constants.d.ts +15 -0
  34. package/dist/@dtelecom/src/e2ee/constants.d.ts.map +1 -0
  35. package/dist/@dtelecom/src/e2ee/errors.d.ts +11 -0
  36. package/dist/@dtelecom/src/e2ee/errors.d.ts.map +1 -0
  37. package/dist/@dtelecom/src/e2ee/index.d.ts +4 -0
  38. package/dist/@dtelecom/src/e2ee/index.d.ts.map +1 -0
  39. package/dist/@dtelecom/src/e2ee/types.d.ts +130 -0
  40. package/dist/@dtelecom/src/e2ee/types.d.ts.map +1 -0
  41. package/dist/@dtelecom/src/e2ee/utils.d.ts +24 -0
  42. package/dist/@dtelecom/src/e2ee/utils.d.ts.map +1 -0
  43. package/dist/@dtelecom/src/e2ee/worker/FrameCryptor.d.ts +176 -0
  44. package/dist/@dtelecom/src/e2ee/worker/FrameCryptor.d.ts.map +1 -0
  45. package/dist/@dtelecom/src/e2ee/worker/ParticipantKeyHandler.d.ts +65 -0
  46. package/dist/@dtelecom/src/e2ee/worker/ParticipantKeyHandler.d.ts.map +1 -0
  47. package/dist/@dtelecom/src/e2ee/worker/e2ee.worker.d.ts +2 -0
  48. package/dist/@dtelecom/src/e2ee/worker/e2ee.worker.d.ts.map +1 -0
  49. package/dist/@dtelecom/src/index.d.ts +38 -0
  50. package/dist/@dtelecom/src/index.d.ts.map +1 -0
  51. package/dist/@dtelecom/src/logger.d.ts +29 -0
  52. package/dist/@dtelecom/src/logger.d.ts.map +1 -0
  53. package/dist/@dtelecom/src/options.d.ts +104 -0
  54. package/dist/@dtelecom/src/options.d.ts.map +1 -0
  55. package/dist/@dtelecom/src/proto/livekit_models_pb.d.ts +1264 -0
  56. package/dist/@dtelecom/src/proto/livekit_models_pb.d.ts.map +1 -0
  57. package/dist/@dtelecom/src/proto/livekit_rtc_pb.d.ts +1373 -0
  58. package/dist/@dtelecom/src/proto/livekit_rtc_pb.d.ts.map +1 -0
  59. package/dist/@dtelecom/src/room/DefaultReconnectPolicy.d.ts +8 -0
  60. package/dist/@dtelecom/src/room/DefaultReconnectPolicy.d.ts.map +1 -0
  61. package/dist/@dtelecom/src/room/DeviceManager.d.ts +9 -0
  62. package/dist/@dtelecom/src/room/DeviceManager.d.ts.map +1 -0
  63. package/dist/@dtelecom/src/room/PCTransport.d.ts +41 -0
  64. package/dist/@dtelecom/src/room/PCTransport.d.ts.map +1 -0
  65. package/dist/@dtelecom/src/room/RTCEngine.d.ts +143 -0
  66. package/dist/@dtelecom/src/room/RTCEngine.d.ts.map +1 -0
  67. package/dist/@dtelecom/src/room/ReconnectPolicy.d.ts +24 -0
  68. package/dist/@dtelecom/src/room/ReconnectPolicy.d.ts.map +1 -0
  69. package/dist/@dtelecom/src/room/RegionUrlProvider.d.ts +17 -0
  70. package/dist/@dtelecom/src/room/RegionUrlProvider.d.ts.map +1 -0
  71. package/dist/@dtelecom/src/room/Room.d.ts +248 -0
  72. package/dist/@dtelecom/src/room/Room.d.ts.map +1 -0
  73. package/dist/@dtelecom/src/room/defaults.d.ts +8 -0
  74. package/dist/@dtelecom/src/room/defaults.d.ts.map +1 -0
  75. package/dist/@dtelecom/src/room/errors.d.ts +43 -0
  76. package/dist/@dtelecom/src/room/errors.d.ts.map +1 -0
  77. package/dist/@dtelecom/src/room/events.d.ts +477 -0
  78. package/dist/@dtelecom/src/room/events.d.ts.map +1 -0
  79. package/dist/@dtelecom/src/room/participant/LocalParticipant.d.ts +177 -0
  80. package/dist/@dtelecom/src/room/participant/LocalParticipant.d.ts.map +1 -0
  81. package/dist/@dtelecom/src/room/participant/Participant.d.ts +95 -0
  82. package/dist/@dtelecom/src/room/participant/Participant.d.ts.map +1 -0
  83. package/dist/@dtelecom/src/room/participant/ParticipantTrackPermission.d.ts +26 -0
  84. package/dist/@dtelecom/src/room/participant/ParticipantTrackPermission.d.ts.map +1 -0
  85. package/dist/@dtelecom/src/room/participant/RemoteParticipant.d.ts +55 -0
  86. package/dist/@dtelecom/src/room/participant/RemoteParticipant.d.ts.map +1 -0
  87. package/dist/@dtelecom/src/room/participant/publishUtils.d.ts +28 -0
  88. package/dist/@dtelecom/src/room/participant/publishUtils.d.ts.map +1 -0
  89. package/dist/@dtelecom/src/room/stats.d.ts +67 -0
  90. package/dist/@dtelecom/src/room/stats.d.ts.map +1 -0
  91. package/dist/@dtelecom/src/room/timers.d.ts +13 -0
  92. package/dist/@dtelecom/src/room/timers.d.ts.map +1 -0
  93. package/dist/@dtelecom/src/room/track/LocalAudioTrack.d.ts +25 -0
  94. package/dist/@dtelecom/src/room/track/LocalAudioTrack.d.ts.map +1 -0
  95. package/dist/@dtelecom/src/room/track/LocalTrack.d.ts +78 -0
  96. package/dist/@dtelecom/src/room/track/LocalTrack.d.ts.map +1 -0
  97. package/dist/@dtelecom/src/room/track/LocalTrackPublication.d.ts +38 -0
  98. package/dist/@dtelecom/src/room/track/LocalTrackPublication.d.ts.map +1 -0
  99. package/dist/@dtelecom/src/room/track/LocalVideoTrack.d.ts +54 -0
  100. package/dist/@dtelecom/src/room/track/LocalVideoTrack.d.ts.map +1 -0
  101. package/dist/@dtelecom/src/room/track/RemoteAudioTrack.d.ts +53 -0
  102. package/dist/@dtelecom/src/room/track/RemoteAudioTrack.d.ts.map +1 -0
  103. package/dist/@dtelecom/src/room/track/RemoteTrack.d.ts +15 -0
  104. package/dist/@dtelecom/src/room/track/RemoteTrack.d.ts.map +1 -0
  105. package/dist/@dtelecom/src/room/track/RemoteTrackPublication.d.ts +64 -0
  106. package/dist/@dtelecom/src/room/track/RemoteTrackPublication.d.ts.map +1 -0
  107. package/dist/@dtelecom/src/room/track/RemoteVideoTrack.d.ts +56 -0
  108. package/dist/@dtelecom/src/room/track/RemoteVideoTrack.d.ts.map +1 -0
  109. package/dist/@dtelecom/src/room/track/Track.d.ts +125 -0
  110. package/dist/@dtelecom/src/room/track/Track.d.ts.map +1 -0
  111. package/dist/@dtelecom/src/room/track/TrackPublication.d.ts +72 -0
  112. package/dist/@dtelecom/src/room/track/TrackPublication.d.ts.map +1 -0
  113. package/dist/@dtelecom/src/room/track/create.d.ts +24 -0
  114. package/dist/@dtelecom/src/room/track/create.d.ts.map +1 -0
  115. package/dist/@dtelecom/src/room/track/facingMode.d.ts +41 -0
  116. package/dist/@dtelecom/src/room/track/facingMode.d.ts.map +1 -0
  117. package/dist/@dtelecom/src/room/track/options.d.ts +272 -0
  118. package/dist/@dtelecom/src/room/track/options.d.ts.map +1 -0
  119. package/dist/@dtelecom/src/room/track/processor/types.d.ts +19 -0
  120. package/dist/@dtelecom/src/room/track/processor/types.d.ts.map +1 -0
  121. package/dist/@dtelecom/src/room/track/types.d.ts +24 -0
  122. package/dist/@dtelecom/src/room/track/types.d.ts.map +1 -0
  123. package/dist/@dtelecom/src/room/track/utils.d.ts +27 -0
  124. package/dist/@dtelecom/src/room/track/utils.d.ts.map +1 -0
  125. package/dist/@dtelecom/src/room/types.d.ts +26 -0
  126. package/dist/@dtelecom/src/room/types.d.ts.map +1 -0
  127. package/dist/@dtelecom/src/room/utils.d.ts +92 -0
  128. package/dist/@dtelecom/src/room/utils.d.ts.map +1 -0
  129. package/dist/@dtelecom/src/test/MockMediaStreamTrack.d.ts +26 -0
  130. package/dist/@dtelecom/src/test/MockMediaStreamTrack.d.ts.map +1 -0
  131. package/dist/@dtelecom/src/test/mocks.d.ts +12 -0
  132. package/dist/@dtelecom/src/test/mocks.d.ts.map +1 -0
  133. package/dist/@dtelecom/src/utils/AsyncQueue.d.ts +23 -0
  134. package/dist/@dtelecom/src/utils/AsyncQueue.d.ts.map +1 -0
  135. package/dist/@dtelecom/src/utils/browserParser.d.ts +12 -0
  136. package/dist/@dtelecom/src/utils/browserParser.d.ts.map +1 -0
  137. package/dist/@dtelecom/src/version.d.ts +3 -0
  138. package/dist/@dtelecom/src/version.d.ts.map +1 -0
  139. package/dist/ts4.2/@dtelecom/src/api/SignalClient.d.ts +105 -0
  140. package/dist/ts4.2/@dtelecom/src/connectionHelper/ConnectionCheck.d.ts +26 -0
  141. package/dist/ts4.2/@dtelecom/src/connectionHelper/checks/Checker.d.ts +59 -0
  142. package/dist/ts4.2/@dtelecom/src/connectionHelper/checks/publishAudio.d.ts +6 -0
  143. package/dist/ts4.2/@dtelecom/src/connectionHelper/checks/publishVideo.d.ts +6 -0
  144. package/dist/ts4.2/@dtelecom/src/connectionHelper/checks/reconnect.d.ts +6 -0
  145. package/dist/ts4.2/@dtelecom/src/connectionHelper/checks/turn.d.ts +6 -0
  146. package/dist/ts4.2/@dtelecom/src/connectionHelper/checks/webrtc.d.ts +6 -0
  147. package/dist/ts4.2/@dtelecom/src/connectionHelper/checks/websocket.d.ts +6 -0
  148. package/dist/ts4.2/@dtelecom/src/e2ee/E2eeManager.d.ts +47 -0
  149. package/dist/ts4.2/@dtelecom/src/e2ee/KeyProvider.d.ts +44 -0
  150. package/dist/ts4.2/@dtelecom/src/e2ee/constants.d.ts +15 -0
  151. package/dist/ts4.2/@dtelecom/src/e2ee/errors.d.ts +11 -0
  152. package/dist/ts4.2/@dtelecom/src/e2ee/index.d.ts +4 -0
  153. package/dist/ts4.2/@dtelecom/src/e2ee/types.d.ts +130 -0
  154. package/dist/ts4.2/@dtelecom/src/e2ee/utils.d.ts +24 -0
  155. package/dist/ts4.2/@dtelecom/src/e2ee/worker/FrameCryptor.d.ts +176 -0
  156. package/dist/ts4.2/@dtelecom/src/e2ee/worker/ParticipantKeyHandler.d.ts +65 -0
  157. package/dist/ts4.2/@dtelecom/src/e2ee/worker/e2ee.worker.d.ts +2 -0
  158. package/dist/ts4.2/@dtelecom/src/index.d.ts +38 -0
  159. package/dist/ts4.2/@dtelecom/src/logger.d.ts +29 -0
  160. package/dist/ts4.2/@dtelecom/src/options.d.ts +104 -0
  161. package/dist/ts4.2/@dtelecom/src/proto/livekit_models_pb.d.ts +1264 -0
  162. package/dist/ts4.2/@dtelecom/src/proto/livekit_rtc_pb.d.ts +1373 -0
  163. package/dist/ts4.2/@dtelecom/src/room/DefaultReconnectPolicy.d.ts +8 -0
  164. package/dist/ts4.2/@dtelecom/src/room/DeviceManager.d.ts +9 -0
  165. package/dist/ts4.2/@dtelecom/src/room/PCTransport.d.ts +43 -0
  166. package/dist/ts4.2/@dtelecom/src/room/RTCEngine.d.ts +143 -0
  167. package/dist/ts4.2/@dtelecom/src/room/ReconnectPolicy.d.ts +24 -0
  168. package/dist/ts4.2/@dtelecom/src/room/RegionUrlProvider.d.ts +17 -0
  169. package/dist/ts4.2/@dtelecom/src/room/Room.d.ts +248 -0
  170. package/dist/ts4.2/@dtelecom/src/room/defaults.d.ts +8 -0
  171. package/dist/ts4.2/@dtelecom/src/room/errors.d.ts +43 -0
  172. package/dist/ts4.2/@dtelecom/src/room/events.d.ts +477 -0
  173. package/dist/ts4.2/@dtelecom/src/room/participant/LocalParticipant.d.ts +177 -0
  174. package/dist/ts4.2/@dtelecom/src/room/participant/Participant.d.ts +95 -0
  175. package/dist/ts4.2/@dtelecom/src/room/participant/ParticipantTrackPermission.d.ts +26 -0
  176. package/dist/ts4.2/@dtelecom/src/room/participant/RemoteParticipant.d.ts +55 -0
  177. package/dist/ts4.2/@dtelecom/src/room/participant/publishUtils.d.ts +28 -0
  178. package/dist/ts4.2/@dtelecom/src/room/stats.d.ts +67 -0
  179. package/dist/ts4.2/@dtelecom/src/room/timers.d.ts +13 -0
  180. package/dist/ts4.2/@dtelecom/src/room/track/LocalAudioTrack.d.ts +25 -0
  181. package/dist/ts4.2/@dtelecom/src/room/track/LocalTrack.d.ts +78 -0
  182. package/dist/ts4.2/@dtelecom/src/room/track/LocalTrackPublication.d.ts +38 -0
  183. package/dist/ts4.2/@dtelecom/src/room/track/LocalVideoTrack.d.ts +54 -0
  184. package/dist/ts4.2/@dtelecom/src/room/track/RemoteAudioTrack.d.ts +53 -0
  185. package/dist/ts4.2/@dtelecom/src/room/track/RemoteTrack.d.ts +15 -0
  186. package/dist/ts4.2/@dtelecom/src/room/track/RemoteTrackPublication.d.ts +64 -0
  187. package/dist/ts4.2/@dtelecom/src/room/track/RemoteVideoTrack.d.ts +56 -0
  188. package/dist/ts4.2/@dtelecom/src/room/track/Track.d.ts +125 -0
  189. package/dist/ts4.2/@dtelecom/src/room/track/TrackPublication.d.ts +72 -0
  190. package/dist/ts4.2/@dtelecom/src/room/track/create.d.ts +24 -0
  191. package/dist/ts4.2/@dtelecom/src/room/track/facingMode.d.ts +41 -0
  192. package/dist/ts4.2/@dtelecom/src/room/track/options.d.ts +280 -0
  193. package/dist/ts4.2/@dtelecom/src/room/track/processor/types.d.ts +19 -0
  194. package/dist/ts4.2/@dtelecom/src/room/track/types.d.ts +24 -0
  195. package/dist/ts4.2/@dtelecom/src/room/track/utils.d.ts +27 -0
  196. package/dist/ts4.2/@dtelecom/src/room/types.d.ts +26 -0
  197. package/dist/ts4.2/@dtelecom/src/room/utils.d.ts +92 -0
  198. package/dist/ts4.2/@dtelecom/src/test/MockMediaStreamTrack.d.ts +26 -0
  199. package/dist/ts4.2/@dtelecom/src/test/mocks.d.ts +12 -0
  200. package/dist/ts4.2/@dtelecom/src/utils/AsyncQueue.d.ts +23 -0
  201. package/dist/ts4.2/@dtelecom/src/utils/browserParser.d.ts +12 -0
  202. package/dist/ts4.2/@dtelecom/src/version.d.ts +3 -0
  203. package/package.json +102 -0
  204. package/src/api/SignalClient.ts +790 -0
  205. package/src/connectionHelper/ConnectionCheck.ts +90 -0
  206. package/src/connectionHelper/checks/Checker.ts +163 -0
  207. package/src/connectionHelper/checks/publishAudio.ts +33 -0
  208. package/src/connectionHelper/checks/publishVideo.ts +33 -0
  209. package/src/connectionHelper/checks/reconnect.ts +45 -0
  210. package/src/connectionHelper/checks/turn.ts +54 -0
  211. package/src/connectionHelper/checks/webrtc.ts +82 -0
  212. package/src/connectionHelper/checks/websocket.ts +27 -0
  213. package/src/e2ee/E2eeManager.ts +375 -0
  214. package/src/e2ee/KeyProvider.ts +78 -0
  215. package/src/e2ee/constants.ts +44 -0
  216. package/src/e2ee/errors.ts +16 -0
  217. package/src/e2ee/index.ts +3 -0
  218. package/src/e2ee/types.ts +161 -0
  219. package/src/e2ee/utils.ts +127 -0
  220. package/src/e2ee/worker/FrameCryptor.test.ts +19 -0
  221. package/src/e2ee/worker/FrameCryptor.ts +612 -0
  222. package/src/e2ee/worker/ParticipantKeyHandler.ts +175 -0
  223. package/src/e2ee/worker/e2ee.worker.ts +223 -0
  224. package/src/e2ee/worker/tsconfig.json +6 -0
  225. package/src/index.ts +85 -0
  226. package/src/logger.ts +64 -0
  227. package/src/options.ts +127 -0
  228. package/src/proto/livekit_models_pb.ts +2096 -0
  229. package/src/proto/livekit_rtc_pb.ts +2332 -0
  230. package/src/room/DefaultReconnectPolicy.ts +35 -0
  231. package/src/room/DeviceManager.ts +88 -0
  232. package/src/room/PCTransport.ts +452 -0
  233. package/src/room/RTCEngine.ts +1421 -0
  234. package/src/room/ReconnectPolicy.ts +27 -0
  235. package/src/room/RegionUrlProvider.ts +82 -0
  236. package/src/room/Room.test.ts +30 -0
  237. package/src/room/Room.ts +1907 -0
  238. package/src/room/defaults.ts +49 -0
  239. package/src/room/errors.ts +90 -0
  240. package/src/room/events.ts +535 -0
  241. package/src/room/participant/LocalParticipant.ts +1350 -0
  242. package/src/room/participant/Participant.ts +299 -0
  243. package/src/room/participant/ParticipantTrackPermission.ts +42 -0
  244. package/src/room/participant/RemoteParticipant.ts +359 -0
  245. package/src/room/participant/publishUtils.test.ts +189 -0
  246. package/src/room/participant/publishUtils.ts +399 -0
  247. package/src/room/stats.ts +136 -0
  248. package/src/room/timers.ts +16 -0
  249. package/src/room/track/LocalAudioTrack.ts +171 -0
  250. package/src/room/track/LocalTrack.ts +430 -0
  251. package/src/room/track/LocalTrackPublication.ts +87 -0
  252. package/src/room/track/LocalVideoTrack.test.ts +73 -0
  253. package/src/room/track/LocalVideoTrack.ts +513 -0
  254. package/src/room/track/RemoteAudioTrack.ts +248 -0
  255. package/src/room/track/RemoteTrack.ts +62 -0
  256. package/src/room/track/RemoteTrackPublication.ts +311 -0
  257. package/src/room/track/RemoteVideoTrack.test.ts +152 -0
  258. package/src/room/track/RemoteVideoTrack.ts +410 -0
  259. package/src/room/track/Track.ts +452 -0
  260. package/src/room/track/TrackPublication.ts +158 -0
  261. package/src/room/track/create.ts +143 -0
  262. package/src/room/track/facingMode.test.ts +31 -0
  263. package/src/room/track/facingMode.ts +103 -0
  264. package/src/room/track/options.ts +362 -0
  265. package/src/room/track/processor/types.ts +20 -0
  266. package/src/room/track/types.ts +25 -0
  267. package/src/room/track/utils.test.ts +111 -0
  268. package/src/room/track/utils.ts +183 -0
  269. package/src/room/types.ts +39 -0
  270. package/src/room/utils.test.ts +16 -0
  271. package/src/room/utils.ts +501 -0
  272. package/src/room/worker.d.ts +4 -0
  273. package/src/test/MockMediaStreamTrack.ts +84 -0
  274. package/src/test/mocks.ts +19 -0
  275. package/src/utils/AsyncQueue.test.ts +100 -0
  276. package/src/utils/AsyncQueue.ts +57 -0
  277. package/src/utils/browserParser.test.ts +88 -0
  278. package/src/utils/browserParser.ts +74 -0
  279. package/src/version.ts +4 -0
@@ -0,0 +1,35 @@
1
+ import type { ReconnectContext, ReconnectPolicy } from './ReconnectPolicy';
2
+
3
+ const maxRetryDelay = 7000;
4
+
5
+ const DEFAULT_RETRY_DELAYS_IN_MS = [
6
+ 0,
7
+ 300,
8
+ 2 * 2 * 300,
9
+ 3 * 3 * 300,
10
+ 4 * 4 * 300,
11
+ maxRetryDelay,
12
+ maxRetryDelay,
13
+ maxRetryDelay,
14
+ maxRetryDelay,
15
+ maxRetryDelay,
16
+ ];
17
+
18
+ class DefaultReconnectPolicy implements ReconnectPolicy {
19
+ private readonly _retryDelays: number[];
20
+
21
+ constructor(retryDelays?: number[]) {
22
+ this._retryDelays = retryDelays !== undefined ? [...retryDelays] : DEFAULT_RETRY_DELAYS_IN_MS;
23
+ }
24
+
25
+ public nextRetryDelayInMs(context: ReconnectContext): number | null {
26
+ if (context.retryCount >= this._retryDelays.length) return null;
27
+
28
+ const retryDelay = this._retryDelays[context.retryCount];
29
+ if (context.retryCount <= 1) return retryDelay;
30
+
31
+ return retryDelay + Math.random() * 1_000;
32
+ }
33
+ }
34
+
35
+ export default DefaultReconnectPolicy;
@@ -0,0 +1,88 @@
1
+ import log from '../logger';
2
+ import { isSafari } from './utils';
3
+
4
+ const defaultId = 'default';
5
+
6
+ export default class DeviceManager {
7
+ private static instance?: DeviceManager;
8
+
9
+ static mediaDeviceKinds: MediaDeviceKind[] = ['audioinput', 'audiooutput', 'videoinput'];
10
+
11
+ static getInstance(): DeviceManager {
12
+ if (this.instance === undefined) {
13
+ this.instance = new DeviceManager();
14
+ }
15
+ return this.instance;
16
+ }
17
+
18
+ static userMediaPromiseMap: Map<MediaDeviceKind, Promise<MediaStream>> = new Map();
19
+
20
+ async getDevices(
21
+ kind?: MediaDeviceKind,
22
+ requestPermissions: boolean = true,
23
+ ): Promise<MediaDeviceInfo[]> {
24
+ if (DeviceManager.userMediaPromiseMap?.size > 0) {
25
+ log.debug('awaiting getUserMedia promise');
26
+ try {
27
+ if (kind) {
28
+ await DeviceManager.userMediaPromiseMap.get(kind);
29
+ } else {
30
+ await Promise.all(DeviceManager.userMediaPromiseMap.values());
31
+ }
32
+ } catch (e: any) {
33
+ log.warn('error waiting for media permissons');
34
+ }
35
+ }
36
+ let devices = await navigator.mediaDevices.enumerateDevices();
37
+
38
+ if (
39
+ requestPermissions &&
40
+ kind &&
41
+ // for safari we need to skip this check, as otherwise it will re-acquire user media and fail on iOS https://bugs.webkit.org/show_bug.cgi?id=179363
42
+ (!DeviceManager.userMediaPromiseMap.get(kind) || !isSafari())
43
+ ) {
44
+ const isDummyDeviceOrEmpty =
45
+ devices.length === 0 ||
46
+ devices.some((device) => {
47
+ const noLabel = device.label === '';
48
+ const isRelevant = kind ? device.kind === kind : true;
49
+ return noLabel && isRelevant;
50
+ });
51
+
52
+ if (isDummyDeviceOrEmpty) {
53
+ const permissionsToAcquire = {
54
+ video: kind !== 'audioinput' && kind !== 'audiooutput',
55
+ audio: kind !== 'videoinput',
56
+ };
57
+ const stream = await navigator.mediaDevices.getUserMedia(permissionsToAcquire);
58
+ devices = await navigator.mediaDevices.enumerateDevices();
59
+ stream.getTracks().forEach((track) => {
60
+ track.stop();
61
+ });
62
+ }
63
+ }
64
+ if (kind) {
65
+ devices = devices.filter((device) => device.kind === kind);
66
+ }
67
+
68
+ return devices;
69
+ }
70
+
71
+ async normalizeDeviceId(
72
+ kind: MediaDeviceKind,
73
+ deviceId?: string,
74
+ groupId?: string,
75
+ ): Promise<string | undefined> {
76
+ if (deviceId !== defaultId) {
77
+ return deviceId;
78
+ }
79
+
80
+ // resolve actual device id if it's 'default': Chrome returns it when no
81
+ // device has been chosen
82
+ const devices = await this.getDevices(kind);
83
+
84
+ const device = devices.find((d) => d.groupId === groupId && d.deviceId !== defaultId);
85
+
86
+ return device?.deviceId;
87
+ }
88
+ }
@@ -0,0 +1,452 @@
1
+ import { EventEmitter } from 'events';
2
+ import { parse, write } from 'sdp-transform';
3
+ import type { MediaDescription } from 'sdp-transform';
4
+ import { debounce } from 'ts-debounce';
5
+ import log from '../logger';
6
+ import { NegotiationError, UnexpectedConnectionState } from './errors';
7
+ import { ddExtensionURI, isChromiumBased, isSVCCodec } from './utils';
8
+
9
+ /** @internal */
10
+ interface TrackBitrateInfo {
11
+ cid?: string;
12
+ transceiver?: RTCRtpTransceiver;
13
+ codec: string;
14
+ maxbr: number;
15
+ }
16
+
17
+ /* The svc codec (av1/vp9) would use a very low bitrate at the begining and
18
+ increase slowly by the bandwidth estimator until it reach the target bitrate. The
19
+ process commonly cost more than 10 seconds cause subscriber will get blur video at
20
+ the first few seconds. So we use a 70% of target bitrate here as the start bitrate to
21
+ eliminate this issue.
22
+ */
23
+ const startBitrateForSVC = 0.7;
24
+
25
+ export const PCEvents = {
26
+ NegotiationStarted: 'negotiationStarted',
27
+ NegotiationComplete: 'negotiationComplete',
28
+ RTPVideoPayloadTypes: 'rtpVideoPayloadTypes',
29
+ } as const;
30
+
31
+ /** @internal */
32
+ export default class PCTransport extends EventEmitter {
33
+ private _pc: RTCPeerConnection | null;
34
+
35
+ public get pc() {
36
+ if (this._pc) return this._pc;
37
+ throw new UnexpectedConnectionState('Expected peer connection to be available');
38
+ }
39
+
40
+ pendingCandidates: RTCIceCandidateInit[] = [];
41
+
42
+ restartingIce: boolean = false;
43
+
44
+ renegotiate: boolean = false;
45
+
46
+ trackBitrates: TrackBitrateInfo[] = [];
47
+
48
+ remoteStereoMids: string[] = [];
49
+
50
+ remoteNackMids: string[] = [];
51
+
52
+ onOffer?: (offer: RTCSessionDescriptionInit) => void;
53
+
54
+ constructor(config?: RTCConfiguration, mediaConstraints: Record<string, unknown> = {}) {
55
+ super();
56
+ this._pc = isChromiumBased()
57
+ ? // @ts-expect-error chrome allows additional media constraints to be passed into the RTCPeerConnection constructor
58
+ new RTCPeerConnection(config, mediaConstraints)
59
+ : new RTCPeerConnection(config);
60
+ }
61
+
62
+ get isICEConnected(): boolean {
63
+ return (
64
+ this._pc !== null &&
65
+ (this.pc.iceConnectionState === 'connected' || this.pc.iceConnectionState === 'completed')
66
+ );
67
+ }
68
+
69
+ async addIceCandidate(candidate: RTCIceCandidateInit): Promise<void> {
70
+ if (this.pc.remoteDescription && !this.restartingIce) {
71
+ return this.pc.addIceCandidate(candidate);
72
+ }
73
+ this.pendingCandidates.push(candidate);
74
+ }
75
+
76
+ async setRemoteDescription(sd: RTCSessionDescriptionInit): Promise<void> {
77
+ let mungedSDP: string | undefined = undefined;
78
+ if (sd.type === 'offer') {
79
+ let { stereoMids, nackMids } = extractStereoAndNackAudioFromOffer(sd);
80
+ this.remoteStereoMids = stereoMids;
81
+ this.remoteNackMids = nackMids;
82
+ } else if (sd.type === 'answer') {
83
+ const sdpParsed = parse(sd.sdp ?? '');
84
+ sdpParsed.media.forEach((media) => {
85
+ if (media.type === 'audio') {
86
+ // mung sdp for opus bitrate settings
87
+ this.trackBitrates.some((trackbr): boolean => {
88
+ if (!trackbr.transceiver || media.mid != trackbr.transceiver.mid) {
89
+ return false;
90
+ }
91
+
92
+ let codecPayload = 0;
93
+ media.rtp.some((rtp): boolean => {
94
+ if (rtp.codec.toUpperCase() === trackbr.codec.toUpperCase()) {
95
+ codecPayload = rtp.payload;
96
+ return true;
97
+ }
98
+ return false;
99
+ });
100
+
101
+ if (codecPayload === 0) {
102
+ return true;
103
+ }
104
+
105
+ let fmtpFound = false;
106
+ for (const fmtp of media.fmtp) {
107
+ if (fmtp.payload === codecPayload) {
108
+ fmtp.config = fmtp.config
109
+ .split(';')
110
+ .filter((attr) => !attr.includes('maxaveragebitrate'))
111
+ .join(';');
112
+ if (trackbr.maxbr > 0) {
113
+ fmtp.config += `;maxaveragebitrate=${trackbr.maxbr * 1000}`;
114
+ }
115
+ fmtpFound = true;
116
+ break;
117
+ }
118
+ }
119
+
120
+ if (!fmtpFound) {
121
+ if (trackbr.maxbr > 0) {
122
+ media.fmtp.push({
123
+ payload: codecPayload,
124
+ config: `maxaveragebitrate=${trackbr.maxbr * 1000}`,
125
+ });
126
+ }
127
+ }
128
+
129
+ return true;
130
+ });
131
+ }
132
+ });
133
+ mungedSDP = write(sdpParsed);
134
+ }
135
+ await this.setMungedSDP(sd, mungedSDP, true);
136
+
137
+ this.pendingCandidates.forEach((candidate) => {
138
+ this.pc.addIceCandidate(candidate);
139
+ });
140
+ this.pendingCandidates = [];
141
+ this.restartingIce = false;
142
+
143
+ if (this.renegotiate) {
144
+ this.renegotiate = false;
145
+ this.createAndSendOffer();
146
+ } else if (sd.type === 'answer') {
147
+ this.emit(PCEvents.NegotiationComplete);
148
+ if (sd.sdp) {
149
+ const sdpParsed = parse(sd.sdp);
150
+ sdpParsed.media.forEach((media) => {
151
+ if (media.type === 'video') {
152
+ this.emit(PCEvents.RTPVideoPayloadTypes, media.rtp);
153
+ }
154
+ });
155
+ }
156
+ }
157
+ }
158
+
159
+ // debounced negotiate interface
160
+ negotiate = debounce((onError?: (e: Error) => void) => {
161
+ this.emit(PCEvents.NegotiationStarted);
162
+ try {
163
+ this.createAndSendOffer();
164
+ } catch (e) {
165
+ if (onError) {
166
+ onError(e as Error);
167
+ } else {
168
+ throw e;
169
+ }
170
+ }
171
+ }, 100);
172
+
173
+ async createAndSendOffer(options?: RTCOfferOptions) {
174
+ if (this.onOffer === undefined) {
175
+ return;
176
+ }
177
+
178
+ if (options?.iceRestart) {
179
+ log.debug('restarting ICE');
180
+ this.restartingIce = true;
181
+ }
182
+
183
+ if (this._pc && this._pc.signalingState === 'have-local-offer') {
184
+ // we're waiting for the peer to accept our offer, so we'll just wait
185
+ // the only exception to this is when ICE restart is needed
186
+ const currentSD = this.pc.remoteDescription;
187
+ if (options?.iceRestart && currentSD) {
188
+ // TODO: handle when ICE restart is needed but we don't have a remote description
189
+ // the best thing to do is to recreate the peerconnection
190
+ await this.pc.setRemoteDescription(currentSD);
191
+ } else {
192
+ this.renegotiate = true;
193
+ return;
194
+ }
195
+ } else if (!this._pc || this._pc.signalingState === 'closed') {
196
+ log.warn('could not createOffer with closed peer connection');
197
+ return;
198
+ }
199
+
200
+ // actually negotiate
201
+ log.debug('starting to negotiate');
202
+ const offer = await this.pc.createOffer(options);
203
+
204
+ const sdpParsed = parse(offer.sdp ?? '');
205
+ sdpParsed.media.forEach((media) => {
206
+ if (media.type === 'audio') {
207
+ ensureAudioNackAndStereo(media, [], []);
208
+ } else if (media.type === 'video') {
209
+ ensureVideoDDExtensionForSVC(media);
210
+ // mung sdp for codec bitrate setting that can't apply by sendEncoding
211
+ this.trackBitrates.some((trackbr): boolean => {
212
+ if (!media.msid || !trackbr.cid || !media.msid.includes(trackbr.cid)) {
213
+ return false;
214
+ }
215
+
216
+ let codecPayload = 0;
217
+ media.rtp.some((rtp): boolean => {
218
+ if (rtp.codec.toUpperCase() === trackbr.codec.toUpperCase()) {
219
+ codecPayload = rtp.payload;
220
+ return true;
221
+ }
222
+ return false;
223
+ });
224
+
225
+ if (codecPayload === 0) {
226
+ return true;
227
+ }
228
+
229
+ let fmtpFound = false;
230
+ for (const fmtp of media.fmtp) {
231
+ if (fmtp.payload === codecPayload) {
232
+ if (!fmtp.config.includes('x-google-start-bitrate')) {
233
+ fmtp.config += `;x-google-start-bitrate=${trackbr.maxbr * startBitrateForSVC}`;
234
+ }
235
+ if (!fmtp.config.includes('x-google-max-bitrate')) {
236
+ fmtp.config += `;x-google-max-bitrate=${trackbr.maxbr}`;
237
+ }
238
+ fmtpFound = true;
239
+ break;
240
+ }
241
+ }
242
+
243
+ if (!fmtpFound) {
244
+ media.fmtp.push({
245
+ payload: codecPayload,
246
+ config: `x-google-start-bitrate=${
247
+ trackbr.maxbr * startBitrateForSVC
248
+ };x-google-max-bitrate=${trackbr.maxbr}`,
249
+ });
250
+ }
251
+
252
+ return true;
253
+ });
254
+ }
255
+ });
256
+
257
+ await this.setMungedSDP(offer, write(sdpParsed));
258
+ this.onOffer(offer);
259
+ }
260
+
261
+ async createAndSetAnswer(): Promise<RTCSessionDescriptionInit> {
262
+ const answer = await this.pc.createAnswer();
263
+ const sdpParsed = parse(answer.sdp ?? '');
264
+ sdpParsed.media.forEach((media) => {
265
+ if (media.type === 'audio') {
266
+ ensureAudioNackAndStereo(media, this.remoteStereoMids, this.remoteNackMids);
267
+ }
268
+ });
269
+ await this.setMungedSDP(answer, write(sdpParsed));
270
+ return answer;
271
+ }
272
+
273
+ setTrackCodecBitrate(info: TrackBitrateInfo) {
274
+ this.trackBitrates.push(info);
275
+ }
276
+
277
+ close() {
278
+ if (!this._pc) {
279
+ return;
280
+ }
281
+ this._pc.close();
282
+ this._pc.onconnectionstatechange = null;
283
+ this._pc.oniceconnectionstatechange = null;
284
+ this._pc.onicegatheringstatechange = null;
285
+ this._pc.ondatachannel = null;
286
+ this._pc.onnegotiationneeded = null;
287
+ this._pc.onsignalingstatechange = null;
288
+ this._pc.onicecandidate = null;
289
+ this._pc.ondatachannel = null;
290
+ this._pc.ontrack = null;
291
+ this._pc.onconnectionstatechange = null;
292
+ this._pc.oniceconnectionstatechange = null;
293
+ this._pc = null;
294
+ }
295
+
296
+ private async setMungedSDP(sd: RTCSessionDescriptionInit, munged?: string, remote?: boolean) {
297
+ if (munged) {
298
+ const originalSdp = sd.sdp;
299
+ sd.sdp = munged;
300
+ try {
301
+ log.debug(`setting munged ${remote ? 'remote' : 'local'} description`);
302
+ if (remote) {
303
+ await this.pc.setRemoteDescription(sd);
304
+ } else {
305
+ await this.pc.setLocalDescription(sd);
306
+ }
307
+ return;
308
+ } catch (e) {
309
+ log.warn(`not able to set ${sd.type}, falling back to unmodified sdp`, {
310
+ error: e,
311
+ });
312
+ sd.sdp = originalSdp;
313
+ }
314
+ }
315
+
316
+ try {
317
+ if (remote) {
318
+ await this.pc.setRemoteDescription(sd);
319
+ } else {
320
+ await this.pc.setLocalDescription(sd);
321
+ }
322
+ } catch (e) {
323
+ // this error cannot always be caught.
324
+ // If the local description has a setCodecPreferences error, this error will be uncaught
325
+ let msg = 'unknown error';
326
+ if (e instanceof Error) {
327
+ msg = e.message;
328
+ } else if (typeof e === 'string') {
329
+ msg = e;
330
+ }
331
+ throw new NegotiationError(msg);
332
+ }
333
+ }
334
+ }
335
+
336
+ function ensureAudioNackAndStereo(
337
+ media: {
338
+ type: string;
339
+ port: number;
340
+ protocol: string;
341
+ payloads?: string | undefined;
342
+ } & MediaDescription,
343
+ stereoMids: string[],
344
+ nackMids: string[],
345
+ ) {
346
+ // found opus codec to add nack fb
347
+ let opusPayload = 0;
348
+ media.rtp.some((rtp): boolean => {
349
+ if (rtp.codec === 'opus') {
350
+ opusPayload = rtp.payload;
351
+ return true;
352
+ }
353
+ return false;
354
+ });
355
+
356
+ // add nack rtcpfb if not exist
357
+ if (opusPayload > 0) {
358
+ if (!media.rtcpFb) {
359
+ media.rtcpFb = [];
360
+ }
361
+
362
+ if (
363
+ nackMids.includes(media.mid!) &&
364
+ !media.rtcpFb.some((fb) => fb.payload === opusPayload && fb.type === 'nack')
365
+ ) {
366
+ media.rtcpFb.push({
367
+ payload: opusPayload,
368
+ type: 'nack',
369
+ });
370
+ }
371
+
372
+ if (stereoMids.includes(media.mid!)) {
373
+ media.fmtp.some((fmtp): boolean => {
374
+ if (fmtp.payload === opusPayload) {
375
+ if (!fmtp.config.includes('stereo=1')) {
376
+ fmtp.config += ';stereo=1';
377
+ }
378
+ return true;
379
+ }
380
+ return false;
381
+ });
382
+ }
383
+ }
384
+ }
385
+
386
+ function ensureVideoDDExtensionForSVC(
387
+ media: {
388
+ type: string;
389
+ port: number;
390
+ protocol: string;
391
+ payloads?: string | undefined;
392
+ } & MediaDescription,
393
+ ) {
394
+ const codec = media.rtp[0]?.codec?.toLowerCase();
395
+ if (!isSVCCodec(codec)) {
396
+ return;
397
+ }
398
+
399
+ let maxID = 0;
400
+ const ddFound = media.ext?.some((ext): boolean => {
401
+ if (ext.uri === ddExtensionURI) {
402
+ return true;
403
+ }
404
+ if (ext.value > maxID) {
405
+ maxID = ext.value;
406
+ }
407
+ return false;
408
+ });
409
+
410
+ if (!ddFound) {
411
+ media.ext?.push({
412
+ value: maxID + 1,
413
+ uri: ddExtensionURI,
414
+ });
415
+ }
416
+ }
417
+
418
+ function extractStereoAndNackAudioFromOffer(offer: RTCSessionDescriptionInit): {
419
+ stereoMids: string[];
420
+ nackMids: string[];
421
+ } {
422
+ const stereoMids: string[] = [];
423
+ const nackMids: string[] = [];
424
+ const sdpParsed = parse(offer.sdp ?? '');
425
+ let opusPayload = 0;
426
+ sdpParsed.media.forEach((media) => {
427
+ if (media.type === 'audio') {
428
+ media.rtp.some((rtp): boolean => {
429
+ if (rtp.codec === 'opus') {
430
+ opusPayload = rtp.payload;
431
+ return true;
432
+ }
433
+ return false;
434
+ });
435
+
436
+ if (media.rtcpFb?.some((fb) => fb.payload === opusPayload && fb.type === 'nack')) {
437
+ nackMids.push(media.mid!);
438
+ }
439
+
440
+ media.fmtp.some((fmtp): boolean => {
441
+ if (fmtp.payload === opusPayload) {
442
+ if (fmtp.config.includes('sprop-stereo=1')) {
443
+ stereoMids.push(media.mid!);
444
+ }
445
+ return true;
446
+ }
447
+ return false;
448
+ });
449
+ }
450
+ });
451
+ return { stereoMids, nackMids };
452
+ }