@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,111 @@
1
+ import { describe, expect, it } from 'vitest';
2
+ import { AudioCaptureOptions, VideoCaptureOptions, VideoPresets } from './options';
3
+ import { constraintsForOptions, mergeDefaultOptions } from './utils';
4
+
5
+ describe('mergeDefaultOptions', () => {
6
+ const audioDefaults: AudioCaptureOptions = {
7
+ autoGainControl: true,
8
+ channelCount: 2,
9
+ };
10
+ const videoDefaults: VideoCaptureOptions = {
11
+ deviceId: 'video123',
12
+ resolution: VideoPresets.h1080.resolution,
13
+ };
14
+
15
+ it('does not enable undefined options', () => {
16
+ const opts = mergeDefaultOptions(undefined, audioDefaults, videoDefaults);
17
+ expect(opts.audio).toEqual(undefined);
18
+ expect(opts.video).toEqual(undefined);
19
+ });
20
+
21
+ it('does not enable explicitly disabled', () => {
22
+ const opts = mergeDefaultOptions({
23
+ video: false,
24
+ });
25
+ expect(opts.audio).toEqual(undefined);
26
+ expect(opts.video).toEqual(false);
27
+ });
28
+
29
+ it('accepts true for options', () => {
30
+ const opts = mergeDefaultOptions(
31
+ {
32
+ audio: true,
33
+ },
34
+ audioDefaults,
35
+ videoDefaults,
36
+ );
37
+ expect(opts.audio).toEqual(audioDefaults);
38
+ expect(opts.video).toEqual(undefined);
39
+ });
40
+
41
+ it('enables overriding specific fields', () => {
42
+ const opts = mergeDefaultOptions(
43
+ {
44
+ audio: { channelCount: 1 },
45
+ },
46
+ audioDefaults,
47
+ videoDefaults,
48
+ );
49
+ const audioOpts = opts.audio as AudioCaptureOptions;
50
+ expect(audioOpts.channelCount).toEqual(1);
51
+ expect(audioOpts.autoGainControl).toEqual(true);
52
+ });
53
+
54
+ it('does not override explicit false', () => {
55
+ const opts = mergeDefaultOptions(
56
+ {
57
+ audio: { autoGainControl: false },
58
+ },
59
+ audioDefaults,
60
+ videoDefaults,
61
+ );
62
+ const audioOpts = opts.audio as AudioCaptureOptions;
63
+ expect(audioOpts.autoGainControl).toEqual(false);
64
+ });
65
+ });
66
+
67
+ describe('constraintsForOptions', () => {
68
+ it('correctly enables audio bool', () => {
69
+ const constraints = constraintsForOptions({
70
+ audio: true,
71
+ });
72
+ expect(constraints.audio).toEqual(true);
73
+ expect(constraints.video).toEqual(false);
74
+ });
75
+
76
+ it('converts audio options correctly', () => {
77
+ const constraints = constraintsForOptions({
78
+ audio: {
79
+ noiseSuppression: true,
80
+ echoCancellation: false,
81
+ },
82
+ });
83
+ const audioOpts = constraints.audio as MediaTrackConstraints;
84
+ expect(Object.keys(audioOpts)).toEqual(['noiseSuppression', 'echoCancellation']);
85
+ expect(audioOpts.noiseSuppression).toEqual(true);
86
+ expect(audioOpts.echoCancellation).toEqual(false);
87
+ });
88
+
89
+ it('converts video options correctly', () => {
90
+ const constraints = constraintsForOptions({
91
+ video: {
92
+ resolution: VideoPresets.h720.resolution,
93
+ facingMode: 'user',
94
+ deviceId: 'video123',
95
+ },
96
+ });
97
+ const videoOpts = constraints.video as MediaTrackConstraints;
98
+ expect(Object.keys(videoOpts)).toEqual([
99
+ 'width',
100
+ 'height',
101
+ 'frameRate',
102
+ 'aspectRatio',
103
+ 'facingMode',
104
+ 'deviceId',
105
+ ]);
106
+ expect(videoOpts.width).toEqual(VideoPresets.h720.resolution.width);
107
+ expect(videoOpts.height).toEqual(VideoPresets.h720.resolution.height);
108
+ expect(videoOpts.frameRate).toEqual(VideoPresets.h720.resolution.frameRate);
109
+ expect(videoOpts.aspectRatio).toEqual(VideoPresets.h720.resolution.aspectRatio);
110
+ });
111
+ });
@@ -0,0 +1,183 @@
1
+ import { isSafari, sleep } from '../utils';
2
+ import { Track } from './Track';
3
+ import type {
4
+ AudioCaptureOptions,
5
+ CreateLocalTracksOptions,
6
+ ScreenShareCaptureOptions,
7
+ VideoCaptureOptions,
8
+ } from './options';
9
+ import type { AudioTrack } from './types';
10
+
11
+ export function mergeDefaultOptions(
12
+ options?: CreateLocalTracksOptions,
13
+ audioDefaults?: AudioCaptureOptions,
14
+ videoDefaults?: VideoCaptureOptions,
15
+ ): CreateLocalTracksOptions {
16
+ const opts: CreateLocalTracksOptions = {
17
+ ...options,
18
+ };
19
+ if (opts.audio === true) opts.audio = {};
20
+ if (opts.video === true) opts.video = {};
21
+
22
+ // use defaults
23
+ if (opts.audio) {
24
+ mergeObjectWithoutOverwriting(
25
+ opts.audio as Record<string, unknown>,
26
+ audioDefaults as Record<string, unknown>,
27
+ );
28
+ }
29
+ if (opts.video) {
30
+ mergeObjectWithoutOverwriting(
31
+ opts.video as Record<string, unknown>,
32
+ videoDefaults as Record<string, unknown>,
33
+ );
34
+ }
35
+ return opts;
36
+ }
37
+
38
+ function mergeObjectWithoutOverwriting(
39
+ mainObject: Record<string, unknown>,
40
+ objectToMerge: Record<string, unknown>,
41
+ ): Record<string, unknown> {
42
+ Object.keys(objectToMerge).forEach((key) => {
43
+ if (mainObject[key] === undefined) mainObject[key] = objectToMerge[key];
44
+ });
45
+ return mainObject;
46
+ }
47
+
48
+ export function constraintsForOptions(options: CreateLocalTracksOptions): MediaStreamConstraints {
49
+ const constraints: MediaStreamConstraints = {};
50
+
51
+ if (options.video) {
52
+ // default video options
53
+ if (typeof options.video === 'object') {
54
+ const videoOptions: MediaTrackConstraints = {};
55
+ const target = videoOptions as Record<string, unknown>;
56
+ const source = options.video as Record<string, unknown>;
57
+ Object.keys(source).forEach((key) => {
58
+ switch (key) {
59
+ case 'resolution':
60
+ // flatten VideoResolution fields
61
+ mergeObjectWithoutOverwriting(target, source.resolution as Record<string, unknown>);
62
+ break;
63
+ default:
64
+ target[key] = source[key];
65
+ }
66
+ });
67
+ constraints.video = videoOptions;
68
+ } else {
69
+ constraints.video = options.video;
70
+ }
71
+ } else {
72
+ constraints.video = false;
73
+ }
74
+
75
+ if (options.audio) {
76
+ if (typeof options.audio === 'object') {
77
+ constraints.audio = options.audio;
78
+ } else {
79
+ constraints.audio = true;
80
+ }
81
+ } else {
82
+ constraints.audio = false;
83
+ }
84
+ return constraints;
85
+ }
86
+ /**
87
+ * This function detects silence on a given [[Track]] instance.
88
+ * Returns true if the track seems to be entirely silent.
89
+ */
90
+ export async function detectSilence(track: AudioTrack, timeOffset = 200): Promise<boolean> {
91
+ const ctx = getNewAudioContext();
92
+ if (ctx) {
93
+ const analyser = ctx.createAnalyser();
94
+ analyser.fftSize = 2048;
95
+
96
+ const bufferLength = analyser.frequencyBinCount;
97
+ const dataArray = new Uint8Array(bufferLength);
98
+ const source = ctx.createMediaStreamSource(new MediaStream([track.mediaStreamTrack]));
99
+
100
+ source.connect(analyser);
101
+ await sleep(timeOffset);
102
+ analyser.getByteTimeDomainData(dataArray);
103
+ const someNoise = dataArray.some((sample) => sample !== 128 && sample !== 0);
104
+ ctx.close();
105
+ return !someNoise;
106
+ }
107
+ return false;
108
+ }
109
+
110
+ /**
111
+ * @internal
112
+ */
113
+ export function getNewAudioContext(): AudioContext | void {
114
+ const AudioContext =
115
+ // @ts-ignore
116
+ typeof window !== 'undefined' && (window.AudioContext || window.webkitAudioContext);
117
+ if (AudioContext) {
118
+ return new AudioContext({ latencyHint: 'interactive' });
119
+ }
120
+ }
121
+
122
+ /**
123
+ * @internal
124
+ */
125
+ export function kindToSource(kind: MediaDeviceKind) {
126
+ if (kind === 'audioinput') {
127
+ return Track.Source.Microphone;
128
+ } else if (kind === 'videoinput') {
129
+ return Track.Source.Camera;
130
+ } else {
131
+ return Track.Source.Unknown;
132
+ }
133
+ }
134
+
135
+ /**
136
+ * @internal
137
+ */
138
+ export function sourceToKind(source: Track.Source): MediaDeviceKind | undefined {
139
+ if (source === Track.Source.Microphone) {
140
+ return 'audioinput';
141
+ } else if (source === Track.Source.Camera) {
142
+ return 'videoinput';
143
+ } else {
144
+ return undefined;
145
+ }
146
+ }
147
+
148
+ /**
149
+ * @internal
150
+ */
151
+ export function screenCaptureToDisplayMediaStreamOptions(
152
+ options: ScreenShareCaptureOptions,
153
+ ): DisplayMediaStreamOptions {
154
+ let videoConstraints: MediaTrackConstraints | boolean = options.video ?? true;
155
+ if (options.resolution) {
156
+ videoConstraints = typeof videoConstraints === 'boolean' ? {} : videoConstraints;
157
+ if (isSafari()) {
158
+ videoConstraints = {
159
+ ...videoConstraints,
160
+ width: { max: options.resolution.width },
161
+ height: { max: options.resolution.height },
162
+ frameRate: options.resolution.frameRate,
163
+ };
164
+ } else {
165
+ videoConstraints = {
166
+ ...videoConstraints,
167
+ width: { ideal: options.resolution.width },
168
+ height: { ideal: options.resolution.height },
169
+ frameRate: options.resolution.frameRate,
170
+ };
171
+ }
172
+ }
173
+
174
+ return {
175
+ audio: options.audio ?? false,
176
+ video: videoConstraints,
177
+ // @ts-expect-error support for experimental display media features
178
+ controller: options.controller,
179
+ selfBrowserSurface: options.selfBrowserSurface,
180
+ surfaceSwitching: options.surfaceSwitching,
181
+ systemAudio: options.systemAudio,
182
+ };
183
+ }
@@ -0,0 +1,39 @@
1
+ import type RemoteParticipant from './participant/RemoteParticipant';
2
+
3
+ export type SimulationOptions = {
4
+ publish?: {
5
+ audio?: boolean;
6
+ video?: boolean;
7
+ useRealTracks?: boolean;
8
+ };
9
+ participants?: {
10
+ count?: number;
11
+ aspectRatios?: Array<number>;
12
+ audio?: boolean;
13
+ video?: boolean;
14
+ };
15
+ };
16
+
17
+ export type DataPublishOptions = {
18
+ /** the participants who will receive the message, will be sent to every one if empty */
19
+ destination?: RemoteParticipant[] | string[];
20
+ /** the topic under which the message gets published */
21
+ topic?: string;
22
+ };
23
+
24
+ export type LiveKitReactNativeInfo = {
25
+ // Corresponds to RN's PlatformOSType
26
+ platform: 'ios' | 'android' | 'windows' | 'macos' | 'web' | 'native';
27
+ devicePixelRatio: number;
28
+ };
29
+
30
+ export type SimulationScenario =
31
+ | 'signal-reconnect'
32
+ | 'speaker'
33
+ | 'node-failure'
34
+ | 'server-leave'
35
+ | 'migration'
36
+ | 'resume-reconnect'
37
+ | 'force-tcp'
38
+ | 'force-tls'
39
+ | 'full-reconnect';
@@ -0,0 +1,16 @@
1
+ import { describe, expect, it } from 'vitest';
2
+ import { toWebsocketUrl } from './utils';
3
+
4
+ describe('toWebsocketUrl', () => {
5
+ it('leaves wss urls alone', () => {
6
+ expect(toWebsocketUrl('ws://mywebsite.com')).toEqual('ws://mywebsite.com');
7
+ });
8
+
9
+ it('converts https to wss', () => {
10
+ expect(toWebsocketUrl('https://mywebsite.com')).toEqual('wss://mywebsite.com');
11
+ });
12
+
13
+ it('does not convert other parts of URL', () => {
14
+ expect(toWebsocketUrl('https://httpsmywebsite.com')).toEqual('wss://httpsmywebsite.com');
15
+ });
16
+ });