livekit-client 2.22.4 → 2.24.0

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 (904) hide show
  1. package/README.md +48 -32
  2. package/dist/core/_virtual/_rollupPluginBabelHelpers.mjs +48 -0
  3. package/dist/core/_virtual/_rollupPluginBabelHelpers.mjs.map +1 -0
  4. package/dist/core/api/SignalClient.mjs +1212 -0
  5. package/dist/core/api/SignalClient.mjs.map +1 -0
  6. package/dist/core/api/SignalClientStateMachine.mjs +115 -0
  7. package/dist/core/api/SignalClientStateMachine.mjs.map +1 -0
  8. package/dist/core/api/WebSocketStream.mjs +146 -0
  9. package/dist/core/api/WebSocketStream.mjs.map +1 -0
  10. package/dist/core/api/utils.mjs +66 -0
  11. package/dist/core/api/utils.mjs.map +1 -0
  12. package/dist/core/connectionHelper/ConnectionCheck.mjs +89 -0
  13. package/dist/core/connectionHelper/ConnectionCheck.mjs.map +1 -0
  14. package/dist/core/connectionHelper/checks/Checker.mjs +146 -0
  15. package/dist/core/connectionHelper/checks/Checker.mjs.map +1 -0
  16. package/dist/core/connectionHelper/checks/cloudRegion.mjs +82 -0
  17. package/dist/core/connectionHelper/checks/cloudRegion.mjs.map +1 -0
  18. package/dist/core/connectionHelper/checks/connectionProtocol.mjs +111 -0
  19. package/dist/core/connectionHelper/checks/connectionProtocol.mjs.map +1 -0
  20. package/dist/core/connectionHelper/checks/publishAudio.mjs +35 -0
  21. package/dist/core/connectionHelper/checks/publishAudio.mjs.map +1 -0
  22. package/dist/core/connectionHelper/checks/publishVideo.mjs +82 -0
  23. package/dist/core/connectionHelper/checks/publishVideo.mjs.map +1 -0
  24. package/dist/core/connectionHelper/checks/reconnect.mjs +37 -0
  25. package/dist/core/connectionHelper/checks/reconnect.mjs.map +1 -0
  26. package/dist/core/connectionHelper/checks/turn.mjs +56 -0
  27. package/dist/core/connectionHelper/checks/turn.mjs.map +1 -0
  28. package/dist/core/connectionHelper/checks/webrtc.mjs +73 -0
  29. package/dist/core/connectionHelper/checks/webrtc.mjs.map +1 -0
  30. package/dist/core/connectionHelper/checks/websocket.mjs +47 -0
  31. package/dist/core/connectionHelper/checks/websocket.mjs.map +1 -0
  32. package/dist/core/core.mjs +1 -0
  33. package/dist/core/core.mjs.map +1 -0
  34. package/dist/core/e2ee/E2eeManager.mjs +603 -0
  35. package/dist/core/e2ee/E2eeManager.mjs.map +1 -0
  36. package/dist/core/e2ee/KeyProvider.mjs +95 -0
  37. package/dist/core/e2ee/KeyProvider.mjs.map +1 -0
  38. package/dist/core/e2ee/constants.mjs +19 -0
  39. package/dist/core/e2ee/constants.mjs.map +1 -0
  40. package/dist/core/e2ee/errors.mjs +15 -0
  41. package/dist/core/e2ee/errors.mjs.map +1 -0
  42. package/dist/core/e2ee/events.mjs +24 -0
  43. package/dist/core/e2ee/events.mjs.map +1 -0
  44. package/dist/core/e2ee/extension.mjs +70 -0
  45. package/dist/core/e2ee/extension.mjs.map +1 -0
  46. package/dist/core/e2ee/utils.mjs +168 -0
  47. package/dist/core/e2ee/utils.mjs.map +1 -0
  48. package/dist/core/frameMetadata/FrameMetadataManager.mjs +205 -0
  49. package/dist/core/frameMetadata/FrameMetadataManager.mjs.map +1 -0
  50. package/dist/core/frameMetadata/extension.mjs +17 -0
  51. package/dist/core/frameMetadata/extension.mjs.map +1 -0
  52. package/dist/core/frameMetadata/utils.mjs +42 -0
  53. package/dist/core/frameMetadata/utils.mjs.map +1 -0
  54. package/dist/core/logger.mjs +111 -0
  55. package/dist/core/logger.mjs.map +1 -0
  56. package/dist/core/package.json.mjs +1 -0
  57. package/dist/core/package.json.mjs.map +1 -0
  58. package/dist/core/room/BackOffStrategy.mjs +60 -0
  59. package/dist/core/room/BackOffStrategy.mjs.map +1 -0
  60. package/dist/core/room/CoreRoom.mjs +2279 -0
  61. package/dist/core/room/CoreRoom.mjs.map +1 -0
  62. package/dist/core/room/DefaultReconnectPolicy.mjs +23 -0
  63. package/dist/core/room/DefaultReconnectPolicy.mjs.map +1 -0
  64. package/dist/core/room/DeviceManager.mjs +92 -0
  65. package/dist/core/room/DeviceManager.mjs.map +1 -0
  66. package/dist/core/room/PCTransport.mjs +1110 -0
  67. package/dist/core/room/PCTransport.mjs.map +1 -0
  68. package/dist/core/room/PCTransportManager.mjs +360 -0
  69. package/dist/core/room/PCTransportManager.mjs.map +1 -0
  70. package/dist/core/room/RTCEngine.mjs +1830 -0
  71. package/dist/core/room/RTCEngine.mjs.map +1 -0
  72. package/dist/core/room/RegionUrlProvider.mjs +194 -0
  73. package/dist/core/room/RegionUrlProvider.mjs.map +1 -0
  74. package/dist/core/room/attribute-typings.mjs +24 -0
  75. package/dist/core/room/attribute-typings.mjs.map +1 -0
  76. package/dist/core/room/createRoom.mjs +19 -0
  77. package/dist/core/room/createRoom.mjs.map +1 -0
  78. package/dist/core/room/data-channel/DataChannelManager.mjs +188 -0
  79. package/dist/core/room/data-channel/DataChannelManager.mjs.map +1 -0
  80. package/dist/core/room/data-channel/FlowControlledDataChannel.mjs +185 -0
  81. package/dist/core/room/data-channel/FlowControlledDataChannel.mjs.map +1 -0
  82. package/dist/core/room/data-channel/LossyDataChannel.mjs +99 -0
  83. package/dist/core/room/data-channel/LossyDataChannel.mjs.map +1 -0
  84. package/dist/core/room/data-channel/ReliableDataChannel.mjs +150 -0
  85. package/dist/core/room/data-channel/ReliableDataChannel.mjs.map +1 -0
  86. package/dist/core/room/data-channel/types.mjs +22 -0
  87. package/dist/core/room/data-channel/types.mjs.map +1 -0
  88. package/dist/core/room/data-stream/compression.mjs +68 -0
  89. package/dist/core/room/data-stream/compression.mjs.map +1 -0
  90. package/dist/core/room/data-stream/constants.mjs +26 -0
  91. package/dist/core/room/data-stream/constants.mjs.map +1 -0
  92. package/dist/core/room/data-stream/extension.mjs +42 -0
  93. package/dist/core/room/data-stream/extension.mjs.map +1 -0
  94. package/dist/core/room/data-stream/incoming/IncomingDataStreamManager.mjs +500 -0
  95. package/dist/core/room/data-stream/incoming/IncomingDataStreamManager.mjs.map +1 -0
  96. package/dist/core/room/data-stream/incoming/StreamReader.mjs +279 -0
  97. package/dist/core/room/data-stream/incoming/StreamReader.mjs.map +1 -0
  98. package/dist/core/room/data-stream/outgoing/OutgoingDataStreamManager.mjs +543 -0
  99. package/dist/core/room/data-stream/outgoing/OutgoingDataStreamManager.mjs.map +1 -0
  100. package/dist/core/room/data-stream/outgoing/StreamWriter.mjs +21 -0
  101. package/dist/core/room/data-stream/outgoing/StreamWriter.mjs.map +1 -0
  102. package/dist/core/room/data-stream/outgoing/header-utils.mjs +53 -0
  103. package/dist/core/room/data-stream/outgoing/header-utils.mjs.map +1 -0
  104. package/dist/core/room/data-track/LocalDataTrack.mjs +146 -0
  105. package/dist/core/room/data-track/LocalDataTrack.mjs.map +1 -0
  106. package/dist/core/room/data-track/RemoteDataTrack.mjs +51 -0
  107. package/dist/core/room/data-track/RemoteDataTrack.mjs.map +1 -0
  108. package/dist/core/room/data-track/depacketizer.mjs +193 -0
  109. package/dist/core/room/data-track/depacketizer.mjs.map +1 -0
  110. package/dist/core/room/data-track/extension.mjs +154 -0
  111. package/dist/core/room/data-track/extension.mjs.map +1 -0
  112. package/dist/core/room/data-track/frame.mjs +19 -0
  113. package/dist/core/room/data-track/frame.mjs.map +1 -0
  114. package/dist/core/room/data-track/handle.mjs +50 -0
  115. package/dist/core/room/data-track/handle.mjs.map +1 -0
  116. package/dist/core/room/data-track/incoming/IncomingDataTrackManager.mjs +618 -0
  117. package/dist/core/room/data-track/incoming/IncomingDataTrackManager.mjs.map +1 -0
  118. package/dist/core/room/data-track/incoming/errors.mjs +32 -0
  119. package/dist/core/room/data-track/incoming/errors.mjs.map +1 -0
  120. package/dist/core/room/data-track/incoming/pipeline.mjs +85 -0
  121. package/dist/core/room/data-track/incoming/pipeline.mjs.map +1 -0
  122. package/dist/core/room/data-track/outgoing/OutgoingDataTrackManager.mjs +351 -0
  123. package/dist/core/room/data-track/outgoing/OutgoingDataTrackManager.mjs.map +1 -0
  124. package/dist/core/room/data-track/outgoing/errors.mjs +114 -0
  125. package/dist/core/room/data-track/outgoing/errors.mjs.map +1 -0
  126. package/dist/core/room/data-track/outgoing/pipeline.mjs +41 -0
  127. package/dist/core/room/data-track/outgoing/pipeline.mjs.map +1 -0
  128. package/dist/core/room/data-track/packet/constants.mjs +21 -0
  129. package/dist/core/room/data-track/packet/constants.mjs.map +1 -0
  130. package/dist/core/room/data-track/packet/errors.mjs +56 -0
  131. package/dist/core/room/data-track/packet/errors.mjs.map +1 -0
  132. package/dist/core/room/data-track/packet/extensions.mjs +172 -0
  133. package/dist/core/room/data-track/packet/extensions.mjs.map +1 -0
  134. package/dist/core/room/data-track/packet/index.mjs +242 -0
  135. package/dist/core/room/data-track/packet/index.mjs.map +1 -0
  136. package/dist/core/room/data-track/packet/serializable.mjs +15 -0
  137. package/dist/core/room/data-track/packet/serializable.mjs.map +1 -0
  138. package/dist/core/room/data-track/packetizer.mjs +77 -0
  139. package/dist/core/room/data-track/packetizer.mjs.map +1 -0
  140. package/dist/core/room/data-track/track-interfaces.mjs +2 -0
  141. package/dist/core/room/data-track/track-interfaces.mjs.map +1 -0
  142. package/dist/core/room/data-track/types.mjs +18 -0
  143. package/dist/core/room/data-track/types.mjs.map +1 -0
  144. package/dist/core/room/data-track/utils.mjs +149 -0
  145. package/dist/core/room/data-track/utils.mjs.map +1 -0
  146. package/dist/core/room/debounce.mjs +97 -0
  147. package/dist/core/room/debounce.mjs.map +1 -0
  148. package/dist/core/room/defaults.mjs +34 -0
  149. package/dist/core/room/defaults.mjs.map +1 -0
  150. package/dist/core/room/errors.mjs +208 -0
  151. package/dist/core/room/errors.mjs.map +1 -0
  152. package/dist/core/room/events.mjs +643 -0
  153. package/dist/core/room/events.mjs.map +1 -0
  154. package/dist/core/room/extensions.mjs +48 -0
  155. package/dist/core/room/extensions.mjs.map +1 -0
  156. package/dist/core/room/participant/LocalParticipant.mjs +1324 -0
  157. package/dist/core/room/participant/LocalParticipant.mjs.map +1 -0
  158. package/dist/core/room/participant/Participant.mjs +300 -0
  159. package/dist/core/room/participant/Participant.mjs.map +1 -0
  160. package/dist/core/room/participant/ParticipantTrackPermission.mjs +12 -0
  161. package/dist/core/room/participant/ParticipantTrackPermission.mjs.map +1 -0
  162. package/dist/core/room/participant/RemoteParticipant.mjs +287 -0
  163. package/dist/core/room/participant/RemoteParticipant.mjs.map +1 -0
  164. package/dist/core/room/participant/publishUtils.mjs +356 -0
  165. package/dist/core/room/participant/publishUtils.mjs.map +1 -0
  166. package/dist/core/room/rpc/client/RpcClientManager.mjs +216 -0
  167. package/dist/core/room/rpc/client/RpcClientManager.mjs.map +1 -0
  168. package/dist/core/room/rpc/extension.mjs +82 -0
  169. package/dist/core/room/rpc/extension.mjs.map +1 -0
  170. package/dist/core/room/rpc/server/RpcServerManager.mjs +186 -0
  171. package/dist/core/room/rpc/server/RpcServerManager.mjs.map +1 -0
  172. package/dist/core/room/rpc/utils.mjs +148 -0
  173. package/dist/core/room/rpc/utils.mjs.map +1 -0
  174. package/dist/core/room/simulated-participants/extension.mjs +105 -0
  175. package/dist/core/room/simulated-participants/extension.mjs.map +1 -0
  176. package/dist/core/room/stats.mjs +19 -0
  177. package/dist/core/room/stats.mjs.map +1 -0
  178. package/dist/core/room/statsSummary.mjs +165 -0
  179. package/dist/core/room/statsSummary.mjs.map +1 -0
  180. package/dist/core/room/timers.mjs +20 -0
  181. package/dist/core/room/timers.mjs.map +1 -0
  182. package/dist/core/room/token-source/TokenSource.mjs +230 -0
  183. package/dist/core/room/token-source/TokenSource.mjs.map +1 -0
  184. package/dist/core/room/token-source/types.mjs +18 -0
  185. package/dist/core/room/token-source/types.mjs.map +1 -0
  186. package/dist/core/room/token-source/utils.mjs +76 -0
  187. package/dist/core/room/token-source/utils.mjs.map +1 -0
  188. package/dist/core/room/track/FrameMetadataExtractor.mjs +36 -0
  189. package/dist/core/room/track/FrameMetadataExtractor.mjs.map +1 -0
  190. package/dist/core/room/track/LocalAudioTrack.mjs +327 -0
  191. package/dist/core/room/track/LocalAudioTrack.mjs.map +1 -0
  192. package/dist/core/room/track/LocalTrack.mjs +694 -0
  193. package/dist/core/room/track/LocalTrack.mjs.map +1 -0
  194. package/dist/core/room/track/LocalTrackPublication.mjs +111 -0
  195. package/dist/core/room/track/LocalTrackPublication.mjs.map +1 -0
  196. package/dist/core/room/track/LocalVideoTrack.mjs +810 -0
  197. package/dist/core/room/track/LocalVideoTrack.mjs.map +1 -0
  198. package/dist/core/room/track/RemoteAudioTrack.mjs +245 -0
  199. package/dist/core/room/track/RemoteAudioTrack.mjs.map +1 -0
  200. package/dist/core/room/track/RemoteTrack.mjs +143 -0
  201. package/dist/core/room/track/RemoteTrack.mjs.map +1 -0
  202. package/dist/core/room/track/RemoteTrackPublication.mjs +284 -0
  203. package/dist/core/room/track/RemoteTrackPublication.mjs.map +1 -0
  204. package/dist/core/room/track/RemoteVideoTrack.mjs +384 -0
  205. package/dist/core/room/track/RemoteVideoTrack.mjs.map +1 -0
  206. package/dist/core/room/track/Track.mjs +413 -0
  207. package/dist/core/room/track/Track.mjs.map +1 -0
  208. package/dist/core/room/track/TrackPublication.mjs +97 -0
  209. package/dist/core/room/track/TrackPublication.mjs.map +1 -0
  210. package/dist/core/room/track/create.mjs +142 -0
  211. package/dist/core/room/track/create.mjs.map +1 -0
  212. package/dist/core/room/track/facingMode.mjs +81 -0
  213. package/dist/core/room/track/facingMode.mjs.map +1 -0
  214. package/dist/core/room/track/options.mjs +109 -0
  215. package/dist/core/room/track/options.mjs.map +1 -0
  216. package/dist/core/room/track/record.mjs +67 -0
  217. package/dist/core/room/track/record.mjs.map +1 -0
  218. package/dist/core/room/track/utils.mjs +429 -0
  219. package/dist/core/room/track/utils.mjs.map +1 -0
  220. package/dist/core/room/utils.mjs +852 -0
  221. package/dist/core/room/utils.mjs.map +1 -0
  222. package/dist/core/room/video/create.mjs +71 -0
  223. package/dist/core/room/video/create.mjs.map +1 -0
  224. package/dist/core/room/video/extension.mjs +27 -0
  225. package/dist/core/room/video/extension.mjs.map +1 -0
  226. package/dist/core/room/video/publisher.mjs +343 -0
  227. package/dist/core/room/video/publisher.mjs.map +1 -0
  228. package/dist/core/ts4.2/api/SignalClient.d.ts +19 -0
  229. package/dist/core/ts4.2/api/SignalClientStateMachine.d.ts +84 -0
  230. package/dist/core/ts4.2/api/WebSocketStream.d.ts +33 -0
  231. package/dist/core/ts4.2/api/utils.d.ts +8 -0
  232. package/dist/core/ts4.2/connectionHelper/ConnectionCheck.d.ts +29 -0
  233. package/dist/core/ts4.2/connectionHelper/checks/Checker.d.ts +64 -0
  234. package/dist/core/ts4.2/connectionHelper/checks/cloudRegion.d.ts +17 -0
  235. package/dist/core/ts4.2/connectionHelper/checks/connectionProtocol.d.ts +19 -0
  236. package/dist/core/ts4.2/connectionHelper/checks/publishAudio.d.ts +5 -0
  237. package/dist/core/ts4.2/connectionHelper/checks/publishVideo.d.ts +6 -0
  238. package/dist/core/ts4.2/connectionHelper/checks/reconnect.d.ts +5 -0
  239. package/dist/core/ts4.2/connectionHelper/checks/turn.d.ts +5 -0
  240. package/dist/core/ts4.2/connectionHelper/checks/webrtc.d.ts +5 -0
  241. package/dist/core/ts4.2/connectionHelper/checks/websocket.d.ts +5 -0
  242. package/dist/core/ts4.2/core.d.ts +33 -0
  243. package/dist/core/ts4.2/e2ee/E2eeManager.d.ts +89 -0
  244. package/dist/core/ts4.2/e2ee/KeyProvider.d.ts +53 -0
  245. package/dist/core/ts4.2/e2ee/constants.d.ts +20 -0
  246. package/dist/core/ts4.2/e2ee/errors.d.ts +11 -0
  247. package/dist/core/ts4.2/e2ee/events.d.ts +38 -0
  248. package/dist/core/ts4.2/e2ee/extension.d.ts +19 -0
  249. package/dist/core/ts4.2/e2ee/index.d.ts +5 -0
  250. package/dist/core/ts4.2/e2ee/types.d.ts +244 -0
  251. package/dist/core/ts4.2/e2ee/utils.d.ts +36 -0
  252. package/dist/core/ts4.2/exports.d.ts +82 -0
  253. package/dist/core/ts4.2/frameMetadata/FrameMetadataManager.d.ts +52 -0
  254. package/dist/core/ts4.2/frameMetadata/extension.d.ts +12 -0
  255. package/dist/core/ts4.2/frameMetadata/frameMetadata.d.ts +32 -0
  256. package/dist/core/ts4.2/frameMetadata/types.d.ts +61 -0
  257. package/dist/core/ts4.2/frameMetadata/utils.d.ts +13 -0
  258. package/dist/core/ts4.2/logger.d.ts +59 -0
  259. package/dist/core/ts4.2/options.d.ts +171 -0
  260. package/dist/core/ts4.2/room/BackOffStrategy.d.ts +26 -0
  261. package/dist/core/ts4.2/room/CoreRoom.d.ts +363 -0
  262. package/dist/core/ts4.2/room/DefaultReconnectPolicy.d.ts +7 -0
  263. package/dist/core/ts4.2/room/DeviceManager.d.ts +11 -0
  264. package/dist/core/ts4.2/room/PCTransport.d.ts +132 -0
  265. package/dist/core/ts4.2/room/PCTransportManager.d.ts +80 -0
  266. package/dist/core/ts4.2/room/RTCEngine.d.ts +233 -0
  267. package/dist/core/ts4.2/room/ReconnectPolicy.d.ts +23 -0
  268. package/dist/core/ts4.2/room/RegionUrlProvider.d.ts +33 -0
  269. package/dist/core/ts4.2/room/attribute-typings.d.ts +34 -0
  270. package/dist/core/ts4.2/room/chat/extension.d.ts +21 -0
  271. package/dist/core/ts4.2/room/createRoom.d.ts +19 -0
  272. package/dist/core/ts4.2/room/data-channel/DataChannelManager.d.ts +67 -0
  273. package/dist/core/ts4.2/room/data-channel/FlowControlledDataChannel.d.ts +106 -0
  274. package/dist/core/ts4.2/room/data-channel/LossyDataChannel.d.ts +40 -0
  275. package/dist/core/ts4.2/room/data-channel/ReliableDataChannel.d.ts +56 -0
  276. package/dist/core/ts4.2/room/data-channel/types.d.ts +11 -0
  277. package/dist/core/ts4.2/room/data-stream/compression.d.ts +29 -0
  278. package/dist/core/ts4.2/room/data-stream/constants.d.ts +1 -0
  279. package/dist/core/ts4.2/room/data-stream/extension.d.ts +63 -0
  280. package/dist/core/ts4.2/room/data-stream/incoming/IncomingDataStreamManager.d.ts +33 -0
  281. package/dist/core/ts4.2/room/data-stream/incoming/StreamReader.d.ts +77 -0
  282. package/dist/core/ts4.2/room/data-stream/outgoing/OutgoingDataStreamManager.d.ts +67 -0
  283. package/dist/core/ts4.2/room/data-stream/outgoing/StreamWriter.d.ts +15 -0
  284. package/dist/core/ts4.2/room/data-stream/outgoing/header-utils.d.ts +17 -0
  285. package/dist/core/ts4.2/room/data-track/LocalDataTrack.d.ts +69 -0
  286. package/dist/core/ts4.2/room/data-track/RemoteDataTrack.d.ts +43 -0
  287. package/dist/core/ts4.2/room/data-track/depacketizer.d.ts +58 -0
  288. package/dist/core/ts4.2/room/data-track/extension.d.ts +30 -0
  289. package/dist/core/ts4.2/room/data-track/frame.d.ts +21 -0
  290. package/dist/core/ts4.2/room/data-track/handle.d.ts +26 -0
  291. package/dist/core/ts4.2/room/data-track/incoming/IncomingDataTrackManager.d.ts +95 -0
  292. package/dist/core/ts4.2/room/data-track/incoming/errors.d.ts +23 -0
  293. package/dist/core/ts4.2/room/data-track/incoming/pipeline.d.ts +40 -0
  294. package/dist/core/ts4.2/room/data-track/incoming/types.d.ts +19 -0
  295. package/dist/core/ts4.2/room/data-track/outgoing/OutgoingDataTrackManager.d.ts +64 -0
  296. package/dist/core/ts4.2/room/data-track/outgoing/errors.d.ts +73 -0
  297. package/dist/core/ts4.2/room/data-track/outgoing/pipeline.d.ts +22 -0
  298. package/dist/core/ts4.2/room/data-track/outgoing/types.d.ts +47 -0
  299. package/dist/core/ts4.2/room/data-track/packet/constants.d.ts +19 -0
  300. package/dist/core/ts4.2/room/data-track/packet/errors.d.ts +39 -0
  301. package/dist/core/ts4.2/room/data-track/packet/extensions.d.ts +68 -0
  302. package/dist/core/ts4.2/room/data-track/packet/index.d.ts +97 -0
  303. package/dist/core/ts4.2/room/data-track/packet/serializable.d.ts +12 -0
  304. package/dist/core/ts4.2/room/data-track/packetizer.d.ts +40 -0
  305. package/dist/core/ts4.2/room/data-track/track-interfaces.d.ts +22 -0
  306. package/dist/core/ts4.2/room/data-track/types.d.ts +21 -0
  307. package/dist/core/ts4.2/room/data-track/utils.d.ts +59 -0
  308. package/dist/core/ts4.2/room/debounce.d.ts +10 -0
  309. package/dist/core/ts4.2/room/defaults.d.ts +7 -0
  310. package/dist/core/ts4.2/room/errors.d.ts +179 -0
  311. package/dist/core/ts4.2/room/events.d.ts +534 -0
  312. package/dist/core/ts4.2/room/extensions.d.ts +206 -0
  313. package/dist/core/ts4.2/room/participant/LocalParticipant.d.ts +164 -0
  314. package/dist/core/ts4.2/room/participant/Participant.d.ts +122 -0
  315. package/dist/core/ts4.2/room/participant/ParticipantTrackPermission.d.ts +25 -0
  316. package/dist/core/ts4.2/room/participant/RemoteParticipant.d.ts +37 -0
  317. package/dist/core/ts4.2/room/participant/publishUtils.d.ts +11 -0
  318. package/dist/core/ts4.2/room/rpc/client/RpcClientManager.d.ts +1 -0
  319. package/dist/core/ts4.2/room/rpc/client/events.d.ts +7 -0
  320. package/dist/core/ts4.2/room/rpc/extension.d.ts +73 -0
  321. package/dist/core/ts4.2/room/rpc/index.d.ts +6 -0
  322. package/dist/core/ts4.2/room/rpc/server/RpcServerManager.d.ts +1 -0
  323. package/dist/core/ts4.2/room/rpc/server/events.d.ts +7 -0
  324. package/dist/core/ts4.2/room/rpc/utils.d.ts +76 -0
  325. package/dist/core/ts4.2/room/simulated-participants/extension.d.ts +24 -0
  326. package/dist/core/ts4.2/room/stats.d.ts +70 -0
  327. package/dist/core/ts4.2/room/statsSummary.d.ts +12 -0
  328. package/dist/core/ts4.2/room/timers.d.ts +11 -0
  329. package/dist/core/ts4.2/room/token-source/TokenSource.d.ts +85 -0
  330. package/dist/core/ts4.2/room/token-source/types.d.ts +69 -0
  331. package/dist/core/ts4.2/room/token-source/utils.d.ts +7 -0
  332. package/dist/core/ts4.2/room/track/FrameMetadataExtractor.d.ts +18 -0
  333. package/dist/core/ts4.2/room/track/LocalAudioTrack.d.ts +50 -0
  334. package/dist/core/ts4.2/room/track/LocalTrack.d.ts +118 -0
  335. package/dist/core/ts4.2/room/track/LocalTrackPublication.d.ts +41 -0
  336. package/dist/core/ts4.2/room/track/LocalVideoTrack.d.ts +91 -0
  337. package/dist/core/ts4.2/room/track/RemoteAudioTrack.d.ts +49 -0
  338. package/dist/core/ts4.2/room/track/RemoteTrack.d.ts +29 -0
  339. package/dist/core/ts4.2/room/track/RemoteTrackPublication.d.ts +62 -0
  340. package/dist/core/ts4.2/room/track/RemoteVideoTrack.d.ts +53 -0
  341. package/dist/core/ts4.2/room/track/Track.d.ts +129 -0
  342. package/dist/core/ts4.2/room/track/TrackPublication.d.ts +68 -0
  343. package/dist/core/ts4.2/room/track/create.d.ts +12 -0
  344. package/dist/core/ts4.2/room/track/facingMode.d.ts +40 -0
  345. package/dist/core/ts4.2/room/track/options.d.ts +396 -0
  346. package/dist/core/ts4.2/room/track/processor/types.d.ts +41 -0
  347. package/dist/core/ts4.2/room/track/record.d.ts +12 -0
  348. package/dist/core/ts4.2/room/track/types.d.ts +27 -0
  349. package/dist/core/ts4.2/room/track/utils.d.ts +20 -0
  350. package/dist/core/ts4.2/room/types.d.ts +126 -0
  351. package/dist/core/ts4.2/room/utils.d.ts +246 -0
  352. package/dist/core/ts4.2/room/video/create.d.ts +27 -0
  353. package/dist/core/ts4.2/room/video/extension.d.ts +43 -0
  354. package/dist/core/ts4.2/room/video/publisher.d.ts +23 -0
  355. package/dist/core/ts4.2/type-polyfills/non-shared-typed-arrays.d.ts +1 -0
  356. package/dist/core/ts4.2/utils/AsyncQueue.d.ts +22 -0
  357. package/dist/core/ts4.2/utils/TypedPromise.d.ts +16 -0
  358. package/dist/core/ts4.2/utils/abort-signal-polyfill.d.ts +12 -0
  359. package/dist/core/ts4.2/utils/browserParser.d.ts +9 -0
  360. package/dist/core/ts4.2/utils/camelToSnakeCase.d.ts +7 -0
  361. package/dist/core/ts4.2/utils/cloneDeep.d.ts +1 -0
  362. package/dist/core/ts4.2/utils/dataPacketBuffer.d.ts +33 -0
  363. package/dist/core/ts4.2/utils/deferrable-map.d.ts +31 -0
  364. package/dist/core/ts4.2/utils/machineInspector.d.ts +53 -0
  365. package/dist/core/ts4.2/utils/serializer.d.ts +47 -0
  366. package/dist/core/ts4.2/utils/throws.d.ts +9 -0
  367. package/dist/core/ts4.2/utils/ttlmap.d.ts +19 -0
  368. package/dist/core/ts4.2/version.d.ts +17 -0
  369. package/dist/core/types/src/api/SignalClient.d.ts +19 -0
  370. package/dist/core/types/src/api/SignalClientStateMachine.d.ts +84 -0
  371. package/dist/core/types/src/api/WebSocketStream.d.ts +33 -0
  372. package/dist/core/types/src/api/utils.d.ts +8 -0
  373. package/dist/core/types/src/connectionHelper/ConnectionCheck.d.ts +28 -0
  374. package/dist/core/types/src/connectionHelper/checks/Checker.d.ts +64 -0
  375. package/dist/core/types/src/connectionHelper/checks/cloudRegion.d.ts +16 -0
  376. package/dist/core/types/src/connectionHelper/checks/connectionProtocol.d.ts +18 -0
  377. package/dist/core/types/src/connectionHelper/checks/publishAudio.d.ts +5 -0
  378. package/dist/core/types/src/connectionHelper/checks/publishVideo.d.ts +6 -0
  379. package/dist/core/types/src/connectionHelper/checks/reconnect.d.ts +5 -0
  380. package/dist/core/types/src/connectionHelper/checks/turn.d.ts +5 -0
  381. package/dist/core/types/src/connectionHelper/checks/webrtc.d.ts +5 -0
  382. package/dist/core/types/src/connectionHelper/checks/websocket.d.ts +5 -0
  383. package/dist/core/types/src/core.d.ts +32 -0
  384. package/dist/core/types/src/e2ee/E2eeManager.d.ts +89 -0
  385. package/dist/core/types/src/e2ee/KeyProvider.d.ts +53 -0
  386. package/dist/core/types/src/e2ee/constants.d.ts +20 -0
  387. package/dist/core/types/src/e2ee/errors.d.ts +11 -0
  388. package/dist/core/types/src/e2ee/events.d.ts +38 -0
  389. package/dist/core/types/src/e2ee/extension.d.ts +18 -0
  390. package/dist/core/types/src/e2ee/index.d.ts +5 -0
  391. package/dist/core/types/src/e2ee/types.d.ts +244 -0
  392. package/dist/core/types/src/e2ee/utils.d.ts +35 -0
  393. package/dist/core/types/src/exports.d.ts +75 -0
  394. package/dist/core/types/src/frameMetadata/FrameMetadataManager.d.ts +52 -0
  395. package/dist/core/types/src/frameMetadata/extension.d.ts +10 -0
  396. package/dist/core/types/src/frameMetadata/frameMetadata.d.ts +32 -0
  397. package/dist/core/types/src/frameMetadata/types.d.ts +61 -0
  398. package/dist/core/types/src/frameMetadata/utils.d.ts +13 -0
  399. package/dist/core/types/src/logger.d.ts +59 -0
  400. package/dist/core/types/src/options.d.ts +171 -0
  401. package/dist/core/types/src/room/BackOffStrategy.d.ts +26 -0
  402. package/dist/core/types/src/room/CoreRoom.d.ts +374 -0
  403. package/dist/core/types/src/room/DefaultReconnectPolicy.d.ts +7 -0
  404. package/dist/core/types/src/room/DeviceManager.d.ts +11 -0
  405. package/dist/core/types/src/room/PCTransport.d.ts +132 -0
  406. package/dist/core/types/src/room/PCTransportManager.d.ts +80 -0
  407. package/dist/core/types/src/room/RTCEngine.d.ts +232 -0
  408. package/dist/core/types/src/room/ReconnectPolicy.d.ts +23 -0
  409. package/dist/core/types/src/room/RegionUrlProvider.d.ts +33 -0
  410. package/dist/core/types/src/room/attribute-typings.d.ts +34 -0
  411. package/dist/core/types/src/room/chat/extension.d.ts +21 -0
  412. package/dist/core/types/src/room/createRoom.d.ts +18 -0
  413. package/dist/core/types/src/room/data-channel/DataChannelManager.d.ts +68 -0
  414. package/dist/core/types/src/room/data-channel/FlowControlledDataChannel.d.ts +107 -0
  415. package/dist/core/types/src/room/data-channel/LossyDataChannel.d.ts +39 -0
  416. package/dist/core/types/src/room/data-channel/ReliableDataChannel.d.ts +55 -0
  417. package/dist/core/types/src/room/data-channel/types.d.ts +11 -0
  418. package/dist/core/types/src/room/data-stream/compression.d.ts +29 -0
  419. package/dist/core/types/src/room/data-stream/constants.d.ts +1 -0
  420. package/dist/core/types/src/room/data-stream/extension.d.ts +62 -0
  421. package/dist/core/types/src/room/data-stream/incoming/IncomingDataStreamManager.d.ts +32 -0
  422. package/dist/core/types/src/room/data-stream/incoming/StreamReader.d.ts +77 -0
  423. package/dist/core/types/src/room/data-stream/outgoing/OutgoingDataStreamManager.d.ts +67 -0
  424. package/dist/core/types/src/room/data-stream/outgoing/StreamWriter.d.ts +15 -0
  425. package/dist/core/types/src/room/data-stream/outgoing/header-utils.d.ts +17 -0
  426. package/dist/core/types/src/room/data-track/LocalDataTrack.d.ts +70 -0
  427. package/dist/core/types/src/room/data-track/RemoteDataTrack.d.ts +43 -0
  428. package/dist/core/types/src/room/data-track/depacketizer.d.ts +58 -0
  429. package/dist/core/types/src/room/data-track/extension.d.ts +30 -0
  430. package/dist/core/types/src/room/data-track/frame.d.ts +21 -0
  431. package/dist/core/types/src/room/data-track/handle.d.ts +26 -0
  432. package/dist/core/types/src/room/data-track/incoming/IncomingDataTrackManager.d.ts +95 -0
  433. package/dist/core/types/src/room/data-track/incoming/errors.d.ts +23 -0
  434. package/dist/core/types/src/room/data-track/incoming/pipeline.d.ts +40 -0
  435. package/dist/core/types/src/room/data-track/incoming/types.d.ts +19 -0
  436. package/dist/core/types/src/room/data-track/outgoing/OutgoingDataTrackManager.d.ts +64 -0
  437. package/dist/core/types/src/room/data-track/outgoing/errors.d.ts +73 -0
  438. package/dist/core/types/src/room/data-track/outgoing/pipeline.d.ts +22 -0
  439. package/dist/core/types/src/room/data-track/outgoing/types.d.ts +47 -0
  440. package/dist/core/types/src/room/data-track/packet/constants.d.ts +19 -0
  441. package/dist/core/types/src/room/data-track/packet/errors.d.ts +39 -0
  442. package/dist/core/types/src/room/data-track/packet/extensions.d.ts +68 -0
  443. package/dist/core/types/src/room/data-track/packet/index.d.ts +91 -0
  444. package/dist/core/types/src/room/data-track/packet/serializable.d.ts +12 -0
  445. package/dist/core/types/src/room/data-track/packetizer.d.ts +40 -0
  446. package/dist/core/types/src/room/data-track/track-interfaces.d.ts +22 -0
  447. package/dist/core/types/src/room/data-track/types.d.ts +21 -0
  448. package/dist/core/types/src/room/data-track/utils.d.ts +59 -0
  449. package/dist/core/types/src/room/debounce.d.ts +10 -0
  450. package/dist/core/types/src/room/defaults.d.ts +7 -0
  451. package/dist/core/types/src/room/errors.d.ts +179 -0
  452. package/dist/core/types/src/room/events.d.ts +534 -0
  453. package/dist/core/types/src/room/extensions.d.ts +205 -0
  454. package/dist/core/types/src/room/participant/LocalParticipant.d.ts +164 -0
  455. package/dist/core/types/src/room/participant/Participant.d.ts +123 -0
  456. package/dist/core/types/src/room/participant/ParticipantTrackPermission.d.ts +25 -0
  457. package/dist/core/types/src/room/participant/RemoteParticipant.d.ts +37 -0
  458. package/dist/core/types/src/room/participant/publishUtils.d.ts +11 -0
  459. package/dist/core/types/src/room/rpc/client/RpcClientManager.d.ts +1 -0
  460. package/dist/core/types/src/room/rpc/client/events.d.ts +7 -0
  461. package/dist/core/types/src/room/rpc/extension.d.ts +69 -0
  462. package/dist/core/types/src/room/rpc/index.d.ts +5 -0
  463. package/dist/core/types/src/room/rpc/server/RpcServerManager.d.ts +1 -0
  464. package/dist/core/types/src/room/rpc/server/events.d.ts +7 -0
  465. package/dist/core/types/src/room/rpc/utils.d.ts +76 -0
  466. package/dist/core/types/src/room/simulated-participants/extension.d.ts +24 -0
  467. package/dist/core/types/src/room/stats.d.ts +70 -0
  468. package/dist/core/types/src/room/statsSummary.d.ts +12 -0
  469. package/dist/core/types/src/room/timers.d.ts +11 -0
  470. package/dist/core/types/src/room/token-source/TokenSource.d.ts +91 -0
  471. package/dist/core/types/src/room/token-source/types.d.ts +69 -0
  472. package/dist/core/types/src/room/token-source/utils.d.ts +7 -0
  473. package/dist/core/types/src/room/track/FrameMetadataExtractor.d.ts +18 -0
  474. package/dist/core/types/src/room/track/LocalAudioTrack.d.ts +53 -0
  475. package/dist/core/types/src/room/track/LocalTrack.d.ts +118 -0
  476. package/dist/core/types/src/room/track/LocalTrackPublication.d.ts +41 -0
  477. package/dist/core/types/src/room/track/LocalVideoTrack.d.ts +91 -0
  478. package/dist/core/types/src/room/track/RemoteAudioTrack.d.ts +49 -0
  479. package/dist/core/types/src/room/track/RemoteTrack.d.ts +29 -0
  480. package/dist/core/types/src/room/track/RemoteTrackPublication.d.ts +76 -0
  481. package/dist/core/types/src/room/track/RemoteVideoTrack.d.ts +56 -0
  482. package/dist/core/types/src/room/track/Track.d.ts +134 -0
  483. package/dist/core/types/src/room/track/TrackPublication.d.ts +74 -0
  484. package/dist/core/types/src/room/track/create.d.ts +12 -0
  485. package/dist/core/types/src/room/track/facingMode.d.ts +40 -0
  486. package/dist/core/types/src/room/track/options.d.ts +384 -0
  487. package/dist/core/types/src/room/track/processor/types.d.ts +41 -0
  488. package/dist/core/types/src/room/track/record.d.ts +12 -0
  489. package/dist/core/types/src/room/track/types.d.ts +27 -0
  490. package/dist/core/types/src/room/track/utils.d.ts +20 -0
  491. package/dist/core/types/src/room/types.d.ts +126 -0
  492. package/dist/core/types/src/room/utils.d.ts +246 -0
  493. package/dist/core/types/src/room/video/create.d.ts +27 -0
  494. package/dist/core/types/src/room/video/extension.d.ts +43 -0
  495. package/dist/core/types/src/room/video/publisher.d.ts +23 -0
  496. package/dist/core/types/src/type-polyfills/non-shared-typed-arrays.d.ts +1 -0
  497. package/dist/core/types/src/utils/AsyncQueue.d.ts +22 -0
  498. package/dist/core/types/src/utils/TypedPromise.d.ts +15 -0
  499. package/dist/core/types/src/utils/abort-signal-polyfill.d.ts +12 -0
  500. package/dist/core/types/src/utils/browserParser.d.ts +9 -0
  501. package/dist/core/types/src/utils/camelToSnakeCase.d.ts +7 -0
  502. package/dist/core/types/src/utils/cloneDeep.d.ts +1 -0
  503. package/dist/core/types/src/utils/dataPacketBuffer.d.ts +33 -0
  504. package/dist/core/types/src/utils/deferrable-map.d.ts +31 -0
  505. package/dist/core/types/src/utils/machineInspector.d.ts +53 -0
  506. package/dist/core/types/src/utils/serializer.d.ts +47 -0
  507. package/dist/core/types/src/utils/throws.d.ts +9 -0
  508. package/dist/core/types/src/utils/ttlmap.d.ts +19 -0
  509. package/dist/core/types/src/version.d.ts +17 -0
  510. package/dist/core/utils/AsyncQueue.mjs +41 -0
  511. package/dist/core/utils/AsyncQueue.mjs.map +1 -0
  512. package/dist/core/utils/TypedPromise.mjs +23 -0
  513. package/dist/core/utils/TypedPromise.mjs.map +1 -0
  514. package/dist/core/utils/abort-signal-polyfill.mjs +53 -0
  515. package/dist/core/utils/abort-signal-polyfill.mjs.map +1 -0
  516. package/dist/core/utils/browserParser.mjs +62 -0
  517. package/dist/core/utils/browserParser.mjs.map +1 -0
  518. package/dist/core/utils/cloneDeep.mjs +14 -0
  519. package/dist/core/utils/cloneDeep.mjs.map +1 -0
  520. package/dist/core/utils/dataPacketBuffer.mjs +76 -0
  521. package/dist/core/utils/dataPacketBuffer.mjs.map +1 -0
  522. package/dist/core/utils/deferrable-map.mjs +94 -0
  523. package/dist/core/utils/deferrable-map.mjs.map +1 -0
  524. package/dist/core/utils/machineInspector.mjs +19 -0
  525. package/dist/core/utils/machineInspector.mjs.map +1 -0
  526. package/dist/core/utils/serializer.mjs +47 -0
  527. package/dist/core/utils/serializer.mjs.map +1 -0
  528. package/dist/core/utils/ttlmap.mjs +97 -0
  529. package/dist/core/utils/ttlmap.mjs.map +1 -0
  530. package/dist/core/version.mjs +17 -0
  531. package/dist/core/version.mjs.map +1 -0
  532. package/dist/livekit-client.e2ee.worker.js +1 -1
  533. package/dist/livekit-client.e2ee.worker.js.map +1 -1
  534. package/dist/livekit-client.e2ee.worker.mjs +225 -137
  535. package/dist/livekit-client.e2ee.worker.mjs.map +1 -1
  536. package/dist/livekit-client.esm.mjs +32913 -31390
  537. package/dist/livekit-client.esm.mjs.map +1 -1
  538. package/dist/livekit-client.fm.worker.js +1 -1
  539. package/dist/livekit-client.fm.worker.js.map +1 -1
  540. package/dist/livekit-client.fm.worker.mjs +21 -82
  541. package/dist/livekit-client.fm.worker.mjs.map +1 -1
  542. package/dist/livekit-client.umd.js +1 -1
  543. package/dist/livekit-client.umd.js.map +1 -1
  544. package/dist/src/api/SignalClient.d.ts +1 -1
  545. package/dist/src/api/SignalClient.d.ts.map +1 -1
  546. package/dist/src/api/WebSocketStream.d.ts +1 -0
  547. package/dist/src/api/WebSocketStream.d.ts.map +1 -1
  548. package/dist/src/api/utils.d.ts +1 -1
  549. package/dist/src/api/utils.d.ts.map +1 -1
  550. package/dist/src/connectionHelper/checks/Checker.d.ts +7 -4
  551. package/dist/src/connectionHelper/checks/Checker.d.ts.map +1 -1
  552. package/dist/src/core.d.ts +33 -0
  553. package/dist/src/core.d.ts.map +1 -0
  554. package/dist/src/e2ee/E2eeManager.d.ts +25 -5
  555. package/dist/src/e2ee/E2eeManager.d.ts.map +1 -1
  556. package/dist/src/e2ee/KeyProvider.d.ts.map +1 -1
  557. package/dist/src/e2ee/extension.d.ts +19 -0
  558. package/dist/src/e2ee/extension.d.ts.map +1 -0
  559. package/dist/src/e2ee/types.d.ts +14 -0
  560. package/dist/src/e2ee/types.d.ts.map +1 -1
  561. package/dist/src/e2ee/utils.d.ts +6 -1
  562. package/dist/src/e2ee/utils.d.ts.map +1 -1
  563. package/dist/src/e2ee/worker/FrameCryptor.d.ts +7 -1
  564. package/dist/src/e2ee/worker/FrameCryptor.d.ts.map +1 -1
  565. package/dist/src/e2ee/worker/naluUtils.d.ts +19 -1
  566. package/dist/src/e2ee/worker/naluUtils.d.ts.map +1 -1
  567. package/dist/src/e2ee/worker/sifPayload.d.ts +1 -1
  568. package/dist/src/e2ee/worker/sifPayload.d.ts.map +1 -1
  569. package/dist/src/exports.d.ts +76 -0
  570. package/dist/src/exports.d.ts.map +1 -0
  571. package/dist/src/frameMetadata/FrameMetadataManager.d.ts +5 -2
  572. package/dist/src/frameMetadata/FrameMetadataManager.d.ts.map +1 -1
  573. package/dist/src/frameMetadata/extension.d.ts +11 -0
  574. package/dist/src/frameMetadata/extension.d.ts.map +1 -0
  575. package/dist/src/frameMetadata/utils.d.ts +5 -0
  576. package/dist/src/frameMetadata/utils.d.ts.map +1 -1
  577. package/dist/src/index.d.ts +35 -63
  578. package/dist/src/index.d.ts.map +1 -1
  579. package/dist/src/logger.d.ts +1 -3
  580. package/dist/src/logger.d.ts.map +1 -1
  581. package/dist/src/options.d.ts +20 -6
  582. package/dist/src/options.d.ts.map +1 -1
  583. package/dist/src/room/CoreRoom.d.ts +392 -0
  584. package/dist/src/room/CoreRoom.d.ts.map +1 -0
  585. package/dist/src/room/DefaultReconnectPolicy.d.ts.map +1 -1
  586. package/dist/src/room/PCTransport.d.ts +31 -6
  587. package/dist/src/room/PCTransport.d.ts.map +1 -1
  588. package/dist/src/room/PCTransportManager.d.ts +8 -4
  589. package/dist/src/room/PCTransportManager.d.ts.map +1 -1
  590. package/dist/src/room/RTCEngine.d.ts +31 -6
  591. package/dist/src/room/RTCEngine.d.ts.map +1 -1
  592. package/dist/src/room/Room.d.ts +5 -350
  593. package/dist/src/room/Room.d.ts.map +1 -1
  594. package/dist/src/room/chat/extension.d.ts +22 -0
  595. package/dist/src/room/chat/extension.d.ts.map +1 -0
  596. package/dist/src/room/createRoom.d.ts +19 -0
  597. package/dist/src/room/createRoom.d.ts.map +1 -0
  598. package/dist/src/room/data-channel/DataChannelManager.d.ts +16 -9
  599. package/dist/src/room/data-channel/DataChannelManager.d.ts.map +1 -1
  600. package/dist/src/room/data-channel/FlowControlledDataChannel.d.ts +25 -12
  601. package/dist/src/room/data-channel/FlowControlledDataChannel.d.ts.map +1 -1
  602. package/dist/src/room/data-channel/LossyDataChannel.d.ts.map +1 -1
  603. package/dist/src/room/data-channel/ReliableDataChannel.d.ts.map +1 -1
  604. package/dist/src/room/data-stream/constants.d.ts +9 -0
  605. package/dist/src/room/data-stream/constants.d.ts.map +1 -1
  606. package/dist/src/room/data-stream/extension.d.ts +73 -0
  607. package/dist/src/room/data-stream/extension.d.ts.map +1 -0
  608. package/dist/src/room/data-stream/incoming/IncomingDataStreamManager.d.ts +6 -1
  609. package/dist/src/room/data-stream/incoming/IncomingDataStreamManager.d.ts.map +1 -1
  610. package/dist/src/room/data-stream/incoming/StreamReader.d.ts.map +1 -1
  611. package/dist/src/room/data-stream/outgoing/OutgoingDataStreamManager.d.ts +0 -1
  612. package/dist/src/room/data-stream/outgoing/OutgoingDataStreamManager.d.ts.map +1 -1
  613. package/dist/src/room/data-track/LocalDataTrack.d.ts +1 -1
  614. package/dist/src/room/data-track/depacketizer.d.ts +1 -1
  615. package/dist/src/room/data-track/depacketizer.d.ts.map +1 -1
  616. package/dist/src/room/data-track/extension.d.ts +31 -0
  617. package/dist/src/room/data-track/extension.d.ts.map +1 -0
  618. package/dist/src/room/data-track/handle.d.ts +1 -1
  619. package/dist/src/room/data-track/handle.d.ts.map +1 -1
  620. package/dist/src/room/data-track/incoming/IncomingDataTrackManager.d.ts +1 -1
  621. package/dist/src/room/data-track/incoming/IncomingDataTrackManager.d.ts.map +1 -1
  622. package/dist/src/room/data-track/incoming/pipeline.d.ts +1 -1
  623. package/dist/src/room/data-track/incoming/pipeline.d.ts.map +1 -1
  624. package/dist/src/room/data-track/outgoing/OutgoingDataTrackManager.d.ts +2 -1
  625. package/dist/src/room/data-track/outgoing/OutgoingDataTrackManager.d.ts.map +1 -1
  626. package/dist/src/room/data-track/outgoing/pipeline.d.ts +1 -1
  627. package/dist/src/room/data-track/outgoing/pipeline.d.ts.map +1 -1
  628. package/dist/src/room/data-track/packet/extensions.d.ts +1 -1
  629. package/dist/src/room/data-track/packet/extensions.d.ts.map +1 -1
  630. package/dist/src/room/data-track/packet/index.d.ts +1 -1
  631. package/dist/src/room/data-track/packet/index.d.ts.map +1 -1
  632. package/dist/src/room/data-track/packet/serializable.d.ts +1 -1
  633. package/dist/src/room/data-track/packet/serializable.d.ts.map +1 -1
  634. package/dist/src/room/data-track/packetizer.d.ts +1 -1
  635. package/dist/src/room/data-track/packetizer.d.ts.map +1 -1
  636. package/dist/src/room/data-track/track-interfaces.d.ts +1 -1
  637. package/dist/src/room/data-track/track-interfaces.d.ts.map +1 -1
  638. package/dist/src/room/data-track/utils.d.ts +1 -1
  639. package/dist/src/room/defaults.d.ts +1 -2
  640. package/dist/src/room/defaults.d.ts.map +1 -1
  641. package/dist/src/room/extensions.d.ts +208 -0
  642. package/dist/src/room/extensions.d.ts.map +1 -0
  643. package/dist/src/room/participant/LocalParticipant.d.ts +49 -120
  644. package/dist/src/room/participant/LocalParticipant.d.ts.map +1 -1
  645. package/dist/src/room/participant/Participant.d.ts +9 -2
  646. package/dist/src/room/participant/Participant.d.ts.map +1 -1
  647. package/dist/src/room/participant/RemoteParticipant.d.ts +3 -3
  648. package/dist/src/room/participant/RemoteParticipant.d.ts.map +1 -1
  649. package/dist/src/room/participant/publishUtils.d.ts.map +1 -1
  650. package/dist/src/room/rpc/extension.d.ts +70 -0
  651. package/dist/src/room/rpc/extension.d.ts.map +1 -0
  652. package/dist/src/room/rpc/index.d.ts +1 -1
  653. package/dist/src/room/rpc/index.d.ts.map +1 -1
  654. package/dist/src/room/rpc/legacyExtension.d.ts +34 -0
  655. package/dist/src/room/rpc/legacyExtension.d.ts.map +1 -0
  656. package/dist/src/room/rpc/utils.d.ts.map +1 -1
  657. package/dist/src/room/simulated-participants/extension.d.ts +25 -0
  658. package/dist/src/room/simulated-participants/extension.d.ts.map +1 -0
  659. package/dist/src/room/token-source/TokenSource.d.ts +5 -1
  660. package/dist/src/room/token-source/TokenSource.d.ts.map +1 -1
  661. package/dist/src/room/token-source/utils.d.ts.map +1 -1
  662. package/dist/src/room/track/LocalAudioTrack.d.ts +24 -1
  663. package/dist/src/room/track/LocalAudioTrack.d.ts.map +1 -1
  664. package/dist/src/room/track/LocalTrack.d.ts +19 -1
  665. package/dist/src/room/track/LocalTrack.d.ts.map +1 -1
  666. package/dist/src/room/track/LocalVideoTrack.d.ts +7 -0
  667. package/dist/src/room/track/LocalVideoTrack.d.ts.map +1 -1
  668. package/dist/src/room/track/RemoteAudioTrack.d.ts +6 -0
  669. package/dist/src/room/track/RemoteAudioTrack.d.ts.map +1 -1
  670. package/dist/src/room/track/RemoteTrackPublication.d.ts +14 -1
  671. package/dist/src/room/track/RemoteTrackPublication.d.ts.map +1 -1
  672. package/dist/src/room/track/Track.d.ts.map +1 -1
  673. package/dist/src/room/track/TrackPublication.d.ts +2 -2
  674. package/dist/src/room/track/TrackPublication.d.ts.map +1 -1
  675. package/dist/src/room/track/create.d.ts +15 -13
  676. package/dist/src/room/track/create.d.ts.map +1 -1
  677. package/dist/src/room/track/facingMode.d.ts.map +1 -1
  678. package/dist/src/room/track/options.d.ts +0 -6
  679. package/dist/src/room/track/options.d.ts.map +1 -1
  680. package/dist/src/room/track/processor/types.d.ts +13 -2
  681. package/dist/src/room/track/processor/types.d.ts.map +1 -1
  682. package/dist/src/room/track/utils.d.ts +1 -1
  683. package/dist/src/room/track/utils.d.ts.map +1 -1
  684. package/dist/src/room/utils.d.ts +30 -3
  685. package/dist/src/room/utils.d.ts.map +1 -1
  686. package/dist/src/room/video/create.d.ts +28 -0
  687. package/dist/src/room/video/create.d.ts.map +1 -0
  688. package/dist/src/room/video/extension.d.ts +48 -0
  689. package/dist/src/room/video/extension.d.ts.map +1 -0
  690. package/dist/src/room/video/publisher.d.ts +24 -0
  691. package/dist/src/room/video/publisher.d.ts.map +1 -0
  692. package/dist/src/test/MockMediaStream.d.ts +6 -0
  693. package/dist/src/test/MockMediaStream.d.ts.map +1 -0
  694. package/dist/src/utils/browserParser.d.ts +0 -3
  695. package/dist/src/utils/browserParser.d.ts.map +1 -1
  696. package/dist/src/utils/deferrable-map.d.ts +1 -1
  697. package/dist/src/utils/deferrable-map.d.ts.map +1 -1
  698. package/dist/src/utils/serializer.d.ts.map +1 -1
  699. package/dist/src/utils/throws.d.ts +10 -0
  700. package/dist/src/utils/throws.d.ts.map +1 -0
  701. package/dist/src/version.d.ts +4 -1
  702. package/dist/src/version.d.ts.map +1 -1
  703. package/dist/ts4.2/api/WebSocketStream.d.ts +1 -0
  704. package/dist/ts4.2/api/utils.d.ts +1 -1
  705. package/dist/ts4.2/connectionHelper/checks/Checker.d.ts +7 -4
  706. package/dist/ts4.2/core.d.ts +34 -0
  707. package/dist/ts4.2/e2ee/E2eeManager.d.ts +25 -5
  708. package/dist/ts4.2/e2ee/extension.d.ts +20 -0
  709. package/dist/ts4.2/e2ee/types.d.ts +14 -0
  710. package/dist/ts4.2/e2ee/utils.d.ts +6 -1
  711. package/dist/ts4.2/e2ee/worker/FrameCryptor.d.ts +7 -1
  712. package/dist/ts4.2/e2ee/worker/naluUtils.d.ts +19 -1
  713. package/dist/ts4.2/e2ee/worker/sifPayload.d.ts +1 -1
  714. package/dist/ts4.2/exports.d.ts +83 -0
  715. package/dist/ts4.2/frameMetadata/FrameMetadataManager.d.ts +5 -2
  716. package/dist/ts4.2/frameMetadata/extension.d.ts +13 -0
  717. package/dist/ts4.2/frameMetadata/utils.d.ts +5 -0
  718. package/dist/ts4.2/index.d.ts +35 -69
  719. package/dist/ts4.2/logger.d.ts +1 -3
  720. package/dist/ts4.2/options.d.ts +20 -6
  721. package/dist/ts4.2/room/CoreRoom.d.ts +381 -0
  722. package/dist/ts4.2/room/PCTransport.d.ts +31 -6
  723. package/dist/ts4.2/room/PCTransportManager.d.ts +8 -4
  724. package/dist/ts4.2/room/RTCEngine.d.ts +31 -6
  725. package/dist/ts4.2/room/Room.d.ts +6 -339
  726. package/dist/ts4.2/room/chat/extension.d.ts +22 -0
  727. package/dist/ts4.2/room/createRoom.d.ts +20 -0
  728. package/dist/ts4.2/room/data-channel/DataChannelManager.d.ts +15 -9
  729. package/dist/ts4.2/room/data-channel/FlowControlledDataChannel.d.ts +25 -12
  730. package/dist/ts4.2/room/data-stream/constants.d.ts +9 -0
  731. package/dist/ts4.2/room/data-stream/extension.d.ts +74 -0
  732. package/dist/ts4.2/room/data-stream/incoming/IncomingDataStreamManager.d.ts +6 -1
  733. package/dist/ts4.2/room/data-stream/outgoing/OutgoingDataStreamManager.d.ts +0 -1
  734. package/dist/ts4.2/room/data-track/LocalDataTrack.d.ts +1 -1
  735. package/dist/ts4.2/room/data-track/depacketizer.d.ts +1 -1
  736. package/dist/ts4.2/room/data-track/extension.d.ts +31 -0
  737. package/dist/ts4.2/room/data-track/handle.d.ts +1 -1
  738. package/dist/ts4.2/room/data-track/incoming/IncomingDataTrackManager.d.ts +1 -1
  739. package/dist/ts4.2/room/data-track/incoming/pipeline.d.ts +1 -1
  740. package/dist/ts4.2/room/data-track/outgoing/OutgoingDataTrackManager.d.ts +2 -1
  741. package/dist/ts4.2/room/data-track/outgoing/pipeline.d.ts +1 -1
  742. package/dist/ts4.2/room/data-track/packet/extensions.d.ts +1 -1
  743. package/dist/ts4.2/room/data-track/packet/index.d.ts +1 -1
  744. package/dist/ts4.2/room/data-track/packet/serializable.d.ts +1 -1
  745. package/dist/ts4.2/room/data-track/packetizer.d.ts +1 -1
  746. package/dist/ts4.2/room/data-track/track-interfaces.d.ts +1 -1
  747. package/dist/ts4.2/room/data-track/utils.d.ts +1 -1
  748. package/dist/ts4.2/room/defaults.d.ts +1 -2
  749. package/dist/ts4.2/room/extensions.d.ts +214 -0
  750. package/dist/ts4.2/room/participant/LocalParticipant.d.ts +48 -121
  751. package/dist/ts4.2/room/participant/Participant.d.ts +9 -2
  752. package/dist/ts4.2/room/participant/RemoteParticipant.d.ts +3 -3
  753. package/dist/ts4.2/room/rpc/extension.d.ts +74 -0
  754. package/dist/ts4.2/room/rpc/index.d.ts +1 -1
  755. package/dist/ts4.2/room/rpc/legacyExtension.d.ts +39 -0
  756. package/dist/ts4.2/room/simulated-participants/extension.d.ts +25 -0
  757. package/dist/ts4.2/room/token-source/TokenSource.d.ts +5 -1
  758. package/dist/ts4.2/room/track/LocalAudioTrack.d.ts +24 -1
  759. package/dist/ts4.2/room/track/LocalTrack.d.ts +19 -1
  760. package/dist/ts4.2/room/track/LocalVideoTrack.d.ts +7 -0
  761. package/dist/ts4.2/room/track/RemoteAudioTrack.d.ts +6 -0
  762. package/dist/ts4.2/room/track/RemoteTrackPublication.d.ts +3 -1
  763. package/dist/ts4.2/room/track/TrackPublication.d.ts +2 -2
  764. package/dist/ts4.2/room/track/create.d.ts +15 -13
  765. package/dist/ts4.2/room/track/options.d.ts +0 -6
  766. package/dist/ts4.2/room/track/processor/types.d.ts +13 -2
  767. package/dist/ts4.2/room/track/utils.d.ts +1 -1
  768. package/dist/ts4.2/room/utils.d.ts +30 -3
  769. package/dist/ts4.2/room/video/create.d.ts +28 -0
  770. package/dist/ts4.2/room/video/extension.d.ts +48 -0
  771. package/dist/ts4.2/room/video/publisher.d.ts +24 -0
  772. package/dist/ts4.2/test/MockMediaStream.d.ts +6 -0
  773. package/dist/ts4.2/utils/browserParser.d.ts +0 -3
  774. package/dist/ts4.2/utils/deferrable-map.d.ts +1 -1
  775. package/dist/ts4.2/utils/throws.d.ts +10 -0
  776. package/dist/ts4.2/version.d.ts +4 -1
  777. package/package.json +24 -9
  778. package/src/api/SignalClient.test.ts +341 -0
  779. package/src/api/SignalClient.ts +71 -26
  780. package/src/api/WebSocketStream.test.ts +78 -0
  781. package/src/api/WebSocketStream.ts +63 -4
  782. package/src/api/utils.ts +1 -1
  783. package/src/connectionHelper/checks/Checker.ts +12 -5
  784. package/src/connectionHelper/checks/publishVideo.ts +1 -1
  785. package/src/connectionHelper/checks/reconnect.ts +1 -1
  786. package/src/core.ts +35 -0
  787. package/src/e2ee/E2eeManager.test.ts +113 -1
  788. package/src/e2ee/E2eeManager.ts +58 -33
  789. package/src/e2ee/KeyProvider.ts +2 -1
  790. package/src/e2ee/extension.ts +113 -0
  791. package/src/e2ee/subscriberBlackScreen.test.ts +9 -12
  792. package/src/e2ee/types.ts +14 -0
  793. package/src/e2ee/utils.test.ts +47 -0
  794. package/src/e2ee/utils.ts +26 -14
  795. package/src/e2ee/worker/DataCryptor.test.ts +42 -1
  796. package/src/e2ee/worker/DataCryptor.ts +2 -2
  797. package/src/e2ee/worker/FrameCryptor.race.test.ts +3 -7
  798. package/src/e2ee/worker/FrameCryptor.test.ts +280 -103
  799. package/src/e2ee/worker/FrameCryptor.ts +97 -20
  800. package/src/e2ee/worker/e2ee.worker.test.ts +151 -0
  801. package/src/e2ee/worker/e2ee.worker.ts +28 -20
  802. package/src/e2ee/worker/naluUtils.test.ts +143 -0
  803. package/src/e2ee/worker/naluUtils.ts +87 -2
  804. package/src/e2ee/worker/sifPayload.ts +1 -1
  805. package/src/exports.ts +224 -0
  806. package/src/frameMetadata/FrameMetadataManager.ts +9 -3
  807. package/src/frameMetadata/extension.ts +34 -0
  808. package/src/frameMetadata/frameMetadata.ts +1 -1
  809. package/src/frameMetadata/utils.ts +23 -0
  810. package/src/index.ts +47 -187
  811. package/src/logger.ts +1 -3
  812. package/src/options.ts +25 -6
  813. package/src/room/CoreRoom.ts +3017 -0
  814. package/src/room/DefaultReconnectPolicy.test.ts +58 -0
  815. package/src/room/DefaultReconnectPolicy.ts +14 -2
  816. package/src/room/DeviceManager.test.ts +55 -1
  817. package/src/room/DeviceManager.ts +1 -1
  818. package/src/room/PCTransport.test.ts +187 -2
  819. package/src/room/PCTransport.ts +173 -31
  820. package/src/room/PCTransportManager.test.ts +65 -3
  821. package/src/room/PCTransportManager.ts +28 -12
  822. package/src/room/RTCEngine.test.ts +654 -22
  823. package/src/room/RTCEngine.ts +240 -41
  824. package/src/room/RegionUrlProvider.ts +1 -1
  825. package/src/room/Room.test.ts +833 -4
  826. package/src/room/Room.ts +34 -3105
  827. package/src/room/chat/extension.ts +78 -0
  828. package/src/room/createRoom.test.ts +149 -0
  829. package/src/room/createRoom.ts +26 -0
  830. package/src/room/data-channel/DataChannelManager.test.ts +61 -7
  831. package/src/room/data-channel/DataChannelManager.ts +61 -38
  832. package/src/room/data-channel/FlowControlledDataChannel.test.ts +60 -18
  833. package/src/room/data-channel/FlowControlledDataChannel.ts +40 -22
  834. package/src/room/data-channel/LossyDataChannel.test.ts +38 -0
  835. package/src/room/data-channel/LossyDataChannel.ts +10 -1
  836. package/src/room/data-channel/ReliableDataChannel.test.ts +72 -0
  837. package/src/room/data-channel/ReliableDataChannel.ts +16 -5
  838. package/src/room/data-stream/constants.ts +10 -0
  839. package/src/room/data-stream/extension.ts +162 -0
  840. package/src/room/data-stream/incoming/IncomingDataStreamManager.test.ts +300 -3
  841. package/src/room/data-stream/incoming/IncomingDataStreamManager.ts +64 -2
  842. package/src/room/data-stream/incoming/StreamReader.ts +14 -4
  843. package/src/room/data-stream/outgoing/OutgoingDataStreamManager.ts +1 -2
  844. package/src/room/data-track/depacketizer.ts +2 -2
  845. package/src/room/data-track/extension.ts +244 -0
  846. package/src/room/data-track/handle.ts +1 -1
  847. package/src/room/data-track/incoming/IncomingDataTrackManager.ts +2 -2
  848. package/src/room/data-track/incoming/pipeline.ts +2 -2
  849. package/src/room/data-track/outgoing/OutgoingDataTrackManager.test.ts +42 -3
  850. package/src/room/data-track/outgoing/OutgoingDataTrackManager.ts +5 -3
  851. package/src/room/data-track/outgoing/pipeline.ts +1 -1
  852. package/src/room/data-track/packet/extensions.ts +1 -1
  853. package/src/room/data-track/packet/index.ts +1 -1
  854. package/src/room/data-track/packet/serializable.ts +1 -1
  855. package/src/room/data-track/packetizer.ts +1 -1
  856. package/src/room/data-track/track-interfaces.ts +4 -4
  857. package/src/room/data-track/utils.ts +1 -1
  858. package/src/room/defaults.ts +3 -16
  859. package/src/room/extensions.ts +310 -0
  860. package/src/room/participant/LocalParticipant.test.ts +154 -2
  861. package/src/room/participant/LocalParticipant.ts +141 -669
  862. package/src/room/participant/Participant.test.ts +60 -0
  863. package/src/room/participant/Participant.ts +27 -4
  864. package/src/room/participant/RemoteParticipant.ts +3 -8
  865. package/src/room/participant/publishUtils.ts +3 -3
  866. package/src/room/participant/restartOnDefaultAudioDevice.test.ts +177 -0
  867. package/src/room/rpc/extension.ts +159 -0
  868. package/src/room/rpc/index.ts +1 -10
  869. package/src/room/rpc/legacyExtension.ts +36 -0
  870. package/src/room/rpc/utils.test.ts +32 -0
  871. package/src/room/rpc/utils.ts +7 -0
  872. package/src/room/simulated-participants/extension.ts +189 -0
  873. package/src/room/token-source/TokenSource.test.ts +29 -0
  874. package/src/room/token-source/TokenSource.ts +8 -3
  875. package/src/room/token-source/utils.test.ts +34 -0
  876. package/src/room/token-source/utils.ts +23 -1
  877. package/src/room/track/LocalAudioTrack.ts +101 -10
  878. package/src/room/track/LocalTrack.ts +88 -23
  879. package/src/room/track/LocalVideoTrack.test.ts +66 -2
  880. package/src/room/track/LocalVideoTrack.ts +12 -3
  881. package/src/room/track/RemoteAudioTrack.ts +56 -11
  882. package/src/room/track/RemoteTrackPublication.ts +14 -1
  883. package/src/room/track/RemoteVideoTrack.test.ts +2 -0
  884. package/src/room/track/Track.test.ts +102 -0
  885. package/src/room/track/Track.ts +8 -1
  886. package/src/room/track/TrackPublication.ts +2 -2
  887. package/src/room/track/create.ts +59 -71
  888. package/src/room/track/facingMode.ts +5 -2
  889. package/src/room/track/options.ts +26 -34
  890. package/src/room/track/processor/types.ts +13 -2
  891. package/src/room/track/utils.test.ts +5 -0
  892. package/src/room/track/utils.ts +34 -6
  893. package/src/room/utils.test.ts +126 -0
  894. package/src/room/utils.ts +86 -23
  895. package/src/room/video/create.ts +95 -0
  896. package/src/room/video/extension.ts +115 -0
  897. package/src/room/video/publisher.ts +472 -0
  898. package/src/test/MockMediaStream.ts +13 -0
  899. package/src/utils/browserParser.ts +0 -3
  900. package/src/utils/deferrable-map.test.ts +60 -0
  901. package/src/utils/deferrable-map.ts +7 -4
  902. package/src/utils/serializer.ts +1 -1
  903. package/src/utils/throws.ts +15 -0
  904. package/src/version.ts +6 -1
@@ -149,11 +149,6 @@ export interface TrackPublishDefaults {
149
149
  * @experimental
150
150
  */
151
151
  frameMetadata?: FrameMetadataPublishOptions;
152
-
153
- /**
154
- * @deprecated Use {@link TrackPublishDefaults.frameMetadata} instead.
155
- */
156
- packetTrailer?: FrameMetadataPublishOptions;
157
152
  }
158
153
 
159
154
  /**
@@ -442,9 +437,6 @@ export function isBackupVideoCodec(codec: string): codec is BackupVideoCodec {
442
437
  return !!backupVideoCodecs.find((backup) => backup === codec);
443
438
  }
444
439
 
445
- /** @deprecated Use {@link isBackupVideoCodec} instead */
446
- export const isBackupCodec = isBackupVideoCodec;
447
-
448
440
  export enum BackupCodecPolicy {
449
441
  // codec regression is preferred, the sfu will try to regress codec if possible but not guaranteed
450
442
  PREFER_REGRESSION = 0,
@@ -505,40 +497,40 @@ export namespace AudioPresets {
505
497
  * Sane presets for video resolution/encoding
506
498
  */
507
499
  export const VideoPresets = {
508
- h90: new VideoPreset(160, 90, 90_000, 20),
509
- h180: new VideoPreset(320, 180, 160_000, 20),
510
- h216: new VideoPreset(384, 216, 180_000, 20),
511
- h360: new VideoPreset(640, 360, 450_000, 20),
512
- h540: new VideoPreset(960, 540, 800_000, 25),
513
- h720: new VideoPreset(1280, 720, 1_700_000, 30),
514
- h1080: new VideoPreset(1920, 1080, 3_000_000, 30),
515
- h1440: new VideoPreset(2560, 1440, 5_000_000, 30),
516
- h2160: new VideoPreset(3840, 2160, 8_000_000, 30),
500
+ h90: /* @__PURE__ */ new VideoPreset(160, 90, 90_000, 20),
501
+ h180: /* @__PURE__ */ new VideoPreset(320, 180, 160_000, 20),
502
+ h216: /* @__PURE__ */ new VideoPreset(384, 216, 180_000, 20),
503
+ h360: /* @__PURE__ */ new VideoPreset(640, 360, 450_000, 20),
504
+ h540: /* @__PURE__ */ new VideoPreset(960, 540, 800_000, 25),
505
+ h720: /* @__PURE__ */ new VideoPreset(1280, 720, 1_700_000, 30),
506
+ h1080: /* @__PURE__ */ new VideoPreset(1920, 1080, 3_000_000, 30),
507
+ h1440: /* @__PURE__ */ new VideoPreset(2560, 1440, 5_000_000, 30),
508
+ h2160: /* @__PURE__ */ new VideoPreset(3840, 2160, 8_000_000, 30),
517
509
  } as const;
518
510
 
519
511
  /**
520
512
  * Four by three presets
521
513
  */
522
514
  export const VideoPresets43 = {
523
- h120: new VideoPreset(160, 120, 70_000, 20),
524
- h180: new VideoPreset(240, 180, 125_000, 20),
525
- h240: new VideoPreset(320, 240, 140_000, 20),
526
- h360: new VideoPreset(480, 360, 330_000, 20),
527
- h480: new VideoPreset(640, 480, 500_000, 20),
528
- h540: new VideoPreset(720, 540, 600_000, 25),
529
- h720: new VideoPreset(960, 720, 1_300_000, 30),
530
- h1080: new VideoPreset(1440, 1080, 2_300_000, 30),
531
- h1440: new VideoPreset(1920, 1440, 3_800_000, 30),
515
+ h120: /* @__PURE__ */ new VideoPreset(160, 120, 70_000, 20),
516
+ h180: /* @__PURE__ */ new VideoPreset(240, 180, 125_000, 20),
517
+ h240: /* @__PURE__ */ new VideoPreset(320, 240, 140_000, 20),
518
+ h360: /* @__PURE__ */ new VideoPreset(480, 360, 330_000, 20),
519
+ h480: /* @__PURE__ */ new VideoPreset(640, 480, 500_000, 20),
520
+ h540: /* @__PURE__ */ new VideoPreset(720, 540, 600_000, 25),
521
+ h720: /* @__PURE__ */ new VideoPreset(960, 720, 1_300_000, 30),
522
+ h1080: /* @__PURE__ */ new VideoPreset(1440, 1080, 2_300_000, 30),
523
+ h1440: /* @__PURE__ */ new VideoPreset(1920, 1440, 3_800_000, 30),
532
524
  } as const;
533
525
 
534
526
  export const ScreenSharePresets = {
535
- h360fps3: new VideoPreset(640, 360, 200_000, 3, 'medium'),
536
- h360fps15: new VideoPreset(640, 360, 400_000, 15, 'medium'),
537
- h720fps5: new VideoPreset(1280, 720, 800_000, 5, 'medium'),
538
- h720fps15: new VideoPreset(1280, 720, 1_500_000, 15, 'medium'),
539
- h720fps30: new VideoPreset(1280, 720, 2_000_000, 30, 'medium'),
540
- h1080fps15: new VideoPreset(1920, 1080, 2_500_000, 15, 'medium'),
541
- h1080fps30: new VideoPreset(1920, 1080, 5_000_000, 30, 'medium'),
527
+ h360fps3: /* @__PURE__ */ new VideoPreset(640, 360, 200_000, 3, 'medium'),
528
+ h360fps15: /* @__PURE__ */ new VideoPreset(640, 360, 400_000, 15, 'medium'),
529
+ h720fps5: /* @__PURE__ */ new VideoPreset(1280, 720, 800_000, 5, 'medium'),
530
+ h720fps15: /* @__PURE__ */ new VideoPreset(1280, 720, 1_500_000, 15, 'medium'),
531
+ h720fps30: /* @__PURE__ */ new VideoPreset(1280, 720, 2_000_000, 30, 'medium'),
532
+ h1080fps15: /* @__PURE__ */ new VideoPreset(1920, 1080, 2_500_000, 15, 'medium'),
533
+ h1080fps30: /* @__PURE__ */ new VideoPreset(1920, 1080, 5_000_000, 30, 'medium'),
542
534
  // original resolution, without resizing
543
- original: new VideoPreset(0, 0, 7_000_000, 30, 'medium'),
535
+ original: /* @__PURE__ */ new VideoPreset(0, 0, 7_000_000, 30, 'medium'),
544
536
  } as const;
@@ -1,4 +1,4 @@
1
- import type Room from '../../Room';
1
+ import type { CoreRoom } from '../../CoreRoom';
2
2
  import type LocalTrack from '../LocalTrack';
3
3
  import type { Track } from '../Track';
4
4
 
@@ -22,6 +22,17 @@ export interface AudioProcessorOptions extends ProcessorOptions<Track.Kind.Audio
22
22
  */
23
23
  export interface VideoProcessorOptions extends ProcessorOptions<Track.Kind.Video> {}
24
24
 
25
+ /**
26
+ * A processor is bound to the track it was set on, not to the room, and it does not survive the
27
+ * track being stopped: unpublishing a track or disconnecting from a room destroys its processor.
28
+ * Both paths stop the track by default, so after reconnecting or republishing, call
29
+ * `setProcessor` again on the new track to put the processor back.
30
+ *
31
+ * The exception is `stopLocalTrackOnUnpublish: false`, which keeps the track alive across an
32
+ * unpublish or disconnect. A video processor then survives with it. An audio processor only
33
+ * survives if the audio context came from the application, because a context the SDK created is
34
+ * closed on disconnect and the processor goes with it.
35
+ */
25
36
  export interface TrackProcessor<
26
37
  T extends Track.Kind,
27
38
  U extends ProcessorOptions<T> = ProcessorOptions<T>,
@@ -31,6 +42,6 @@ export interface TrackProcessor<
31
42
  restart: (opts: U) => Promise<void>;
32
43
  destroy: () => Promise<void>;
33
44
  processedTrack?: MediaStreamTrack;
34
- onPublish?: (room: Room) => Promise<void>;
45
+ onPublish?: (room: CoreRoom) => Promise<void>;
35
46
  onUnpublish?: () => Promise<void>;
36
47
  }
@@ -105,6 +105,11 @@ describe('constraintsForOptions', () => {
105
105
  expect(videoOpts.frameRate).toEqual(VideoPresets.h720.resolution.frameRate);
106
106
  expect(videoOpts.aspectRatio).toEqual(VideoPresets.h720.resolution.aspectRatio);
107
107
  });
108
+
109
+ it('leaves an explicitly set exact deviceId untouched', () => {
110
+ const constraints = constraintsForOptions({ audio: { deviceId: { exact: 'default' } } });
111
+ expect((constraints.audio as MediaTrackConstraints).deviceId).toEqual({ exact: 'default' });
112
+ });
108
113
  });
109
114
 
110
115
  describe('diffAttributes', () => {
@@ -1,5 +1,4 @@
1
1
  import { TrackInfo, TrackPublishedResponse, TrackSource, VideoQuality } from '@livekit/protocol';
2
- import type { AudioProcessorOptions, TrackProcessor, VideoProcessorOptions } from '../..';
3
2
  import log from '../../logger';
4
3
  import { cloneDeep } from '../../utils/cloneDeep';
5
4
  import { isSafari, sleep } from '../utils';
@@ -12,6 +11,11 @@ import {
12
11
  type VideoCaptureOptions,
13
12
  type VideoCodec,
14
13
  } from './options';
14
+ import type {
15
+ AudioProcessorOptions,
16
+ TrackProcessor,
17
+ VideoProcessorOptions,
18
+ } from './processor/types';
15
19
  import type { AudioTrack } from './types';
16
20
 
17
21
  export function mergeDefaultOptions(
@@ -108,22 +112,46 @@ export function constraintsForOptions(options: CreateLocalTracksOptions): MediaS
108
112
  */
109
113
  export async function detectSilence(track: AudioTrack, timeOffset = 200): Promise<boolean> {
110
114
  const ctx = getNewAudioContext();
111
- if (ctx) {
112
- const analyser = ctx.createAnalyser();
115
+ if (!ctx) {
116
+ return false;
117
+ }
118
+ let source: MediaStreamAudioSourceNode | undefined;
119
+ let analyser: AnalyserNode | undefined;
120
+ try {
121
+ analyser = ctx.createAnalyser();
113
122
  analyser.fftSize = 2048;
114
123
 
115
124
  const bufferLength = analyser.frequencyBinCount;
116
125
  const dataArray = new Uint8Array(bufferLength);
117
- const source = ctx.createMediaStreamSource(new MediaStream([track.mediaStreamTrack]));
126
+ source = ctx.createMediaStreamSource(new MediaStream([track.mediaStreamTrack]));
118
127
 
119
128
  source.connect(analyser);
129
+ // read through a function so that `state` isn't narrowed to its value from before `resume`
130
+ const isRunning = () => ctx.state === 'running';
131
+ if (!isRunning()) {
132
+ try {
133
+ // `resume` can stay pending indefinitely on a blocked page rather than rejecting, which
134
+ // would keep the context and its nodes alive past the `finally` below
135
+ await Promise.race([ctx.resume(), sleep(200)]);
136
+ } catch {
137
+ // autoplay policies can keep us from resuming the context
138
+ }
139
+ if (!isRunning()) {
140
+ // a context that isn't running doesn't process any audio, so the analyser would only ever
141
+ // read silence. Report the track as not silent rather than raising a false positive.
142
+ return false;
143
+ }
144
+ }
120
145
  await sleep(timeOffset);
121
146
  analyser.getByteTimeDomainData(dataArray);
122
147
  const someNoise = dataArray.some((sample) => sample !== 128 && sample !== 0);
123
- ctx.close();
124
148
  return !someNoise;
149
+ } finally {
150
+ source?.disconnect();
151
+ analyser?.disconnect();
152
+ // don't let a failing teardown mask the detection result
153
+ await ctx.close().catch(() => {});
125
154
  }
126
- return false;
127
155
  }
128
156
 
129
157
  /**
@@ -13,6 +13,7 @@ import {
13
13
  isCompressionStreamSupported,
14
14
  isDeflateRawCompressionSupported,
15
15
  isIPadOS,
16
+ isPermissionDeniedError,
16
17
  isSVCSimulcast,
17
18
  isSVCSimulcastSupportedByServer,
18
19
  negotiateDependencyDescriptor,
@@ -491,3 +492,128 @@ describe('isDeflateRawCompressionSupported', () => {
491
492
  }
492
493
  });
493
494
  });
495
+
496
+ describe('isPermissionDeniedError', () => {
497
+ function errorNamed(name: string) {
498
+ const e = new Error(name);
499
+ e.name = name;
500
+ return e;
501
+ }
502
+
503
+ it('matches the permission denial names and their legacy aliases', () => {
504
+ expect(isPermissionDeniedError(errorNamed('NotAllowedError'))).toBe(true);
505
+ expect(isPermissionDeniedError(errorNamed('SecurityError'))).toBe(true);
506
+ expect(isPermissionDeniedError(errorNamed('PermissionDeniedError'))).toBe(true);
507
+ expect(isPermissionDeniedError(errorNamed('PermissionDismissedError'))).toBe(true);
508
+ });
509
+
510
+ it('does not match failures that a softer constraint could still satisfy', () => {
511
+ expect(isPermissionDeniedError(errorNamed('OverconstrainedError'))).toBe(false);
512
+ expect(isPermissionDeniedError(errorNamed('ConstraintNotSatisfiedError'))).toBe(false);
513
+ expect(isPermissionDeniedError(errorNamed('NotFoundError'))).toBe(false);
514
+ expect(isPermissionDeniedError(errorNamed('SomeNameNobodyHasShippedYet'))).toBe(false);
515
+ });
516
+
517
+ it('does not match a plain error, undefined or null', () => {
518
+ expect(isPermissionDeniedError(new Error('boom'))).toBe(false);
519
+ expect(isPermissionDeniedError(undefined)).toBe(false);
520
+ expect(isPermissionDeniedError(null)).toBe(false);
521
+ });
522
+ });
523
+
524
+ // `freshUtils` below calls `vi.resetModules()`, so a dynamic import of `./utils` from a later
525
+ // block would get a different module instance than the static import at the top of this file.
526
+ // Keep this block last.
527
+ describe('empty audio stream track refcounting', () => {
528
+ let closedContexts: number;
529
+
530
+ function makeTrack(): MediaStreamTrack {
531
+ const track = {
532
+ enabled: true,
533
+ stopped: false,
534
+ stop() {
535
+ track.stopped = true;
536
+ },
537
+ clone: () => makeTrack(),
538
+ };
539
+ return track as unknown as MediaStreamTrack;
540
+ }
541
+
542
+ /** reloads `./utils` so its module level context and refcount start empty */
543
+ async function freshUtils() {
544
+ closedContexts = 0;
545
+ vi.resetModules();
546
+ vi.stubGlobal(
547
+ 'AudioContext',
548
+ class {
549
+ createOscillator() {
550
+ return { connect: () => {}, start: () => {} };
551
+ }
552
+
553
+ createGain() {
554
+ return { gain: { setValueAtTime: () => {} }, connect: () => {} };
555
+ }
556
+
557
+ createMediaStreamDestination() {
558
+ return { stream: { getAudioTracks: () => [makeTrack()] } };
559
+ }
560
+
561
+ async close() {
562
+ closedContexts += 1;
563
+ }
564
+ },
565
+ );
566
+ return import('./utils');
567
+ }
568
+
569
+ afterEach(() => {
570
+ vi.unstubAllGlobals();
571
+ });
572
+
573
+ it('closes the shared context once every track handed out is released', async () => {
574
+ const { getEmptyAudioStreamTrack, releaseEmptyAudioStreamTrack } = await freshUtils();
575
+ const first = getEmptyAudioStreamTrack();
576
+ const second = getEmptyAudioStreamTrack();
577
+
578
+ await releaseEmptyAudioStreamTrack(first);
579
+ expect(closedContexts).toBe(0);
580
+
581
+ await releaseEmptyAudioStreamTrack(second);
582
+ expect(closedContexts).toBe(1);
583
+ });
584
+
585
+ it('ignores a second release of the same track', async () => {
586
+ const { getEmptyAudioStreamTrack, releaseEmptyAudioStreamTrack } = await freshUtils();
587
+ const first = getEmptyAudioStreamTrack();
588
+ const second = getEmptyAudioStreamTrack();
589
+
590
+ await releaseEmptyAudioStreamTrack(first);
591
+ await releaseEmptyAudioStreamTrack(first);
592
+ expect(closedContexts).toBe(0);
593
+
594
+ await releaseEmptyAudioStreamTrack(second);
595
+ expect(closedContexts).toBe(1);
596
+ });
597
+
598
+ it('leaves a track it never handed out alone', async () => {
599
+ const { getEmptyAudioStreamTrack, releaseEmptyAudioStreamTrack } = await freshUtils();
600
+ const owned = getEmptyAudioStreamTrack();
601
+ const foreign = makeTrack();
602
+
603
+ await releaseEmptyAudioStreamTrack(foreign);
604
+ expect(closedContexts).toBe(0);
605
+ expect((foreign as unknown as { stopped: boolean }).stopped).toBe(false);
606
+
607
+ await releaseEmptyAudioStreamTrack(owned);
608
+ expect(closedContexts).toBe(1);
609
+ });
610
+
611
+ it('builds a fresh context for an acquire that arrives after the last release', async () => {
612
+ const { getEmptyAudioStreamTrack, releaseEmptyAudioStreamTrack } = await freshUtils();
613
+ await releaseEmptyAudioStreamTrack(getEmptyAudioStreamTrack());
614
+ expect(closedContexts).toBe(1);
615
+
616
+ await releaseEmptyAudioStreamTrack(getEmptyAudioStreamTrack());
617
+ expect(closedContexts).toBe(2);
618
+ });
619
+ });
package/src/room/utils.ts CHANGED
@@ -6,14 +6,14 @@ import {
6
6
  DisconnectReason,
7
7
  Transcription as TranscriptionModel,
8
8
  } from '@livekit/protocol';
9
- import { type Throws } from '@livekit/throws-transformer/throws';
10
9
  import type { NonSharedUint8Array } from '../type-polyfills/non-shared-typed-arrays';
11
10
  import TypedPromise from '../utils/TypedPromise';
12
11
  import { getBrowser } from '../utils/browserParser';
13
12
  import type { BrowserDetails } from '../utils/browserParser';
13
+ import { type Throws } from '../utils/throws';
14
14
  import { clientProtocol, protocolVersion, version } from '../version';
15
15
  import { type ConnectionError, ConnectionErrorReason } from './errors';
16
- import type LocalParticipant from './participant/LocalParticipant';
16
+ import type { LocalParticipant } from './participant/LocalParticipant';
17
17
  import type Participant from './participant/Participant';
18
18
  import type RemoteParticipant from './participant/RemoteParticipant';
19
19
  import CriticalTimers from './timers';
@@ -559,6 +559,17 @@ export function createDummyVideoStreamTrack(
559
559
 
560
560
  let emptyAudioStreamTrack: MediaStreamTrack | undefined;
561
561
 
562
+ let emptyAudioStreamContext: AudioContext | undefined;
563
+
564
+ /** tracks handed out by `getEmptyAudioStreamTrack` that haven't been released yet */
565
+ const outstandingEmptyAudioStreamTracks = new Set<MediaStreamTrack>();
566
+
567
+ /**
568
+ * Returns a silent audio track, cloned off a shared `AudioContext` created on first use. Hand the
569
+ * clone back to `releaseEmptyAudioStreamTrack` rather than stopping it, so the context can close.
570
+ * A clone that is only stopped stays counted as outstanding, which holds the shared context open
571
+ * for the lifetime of the page.
572
+ */
562
573
  export function getEmptyAudioStreamTrack() {
563
574
  if (!emptyAudioStreamTrack) {
564
575
  // implementation adapted from https://blog.mozilla.org/webrtc/warm-up-with-replacetrack/
@@ -572,31 +583,37 @@ export function getEmptyAudioStreamTrack() {
572
583
  oscillator.start();
573
584
  [emptyAudioStreamTrack] = dst.stream.getAudioTracks();
574
585
  if (!emptyAudioStreamTrack) {
586
+ // don't hold on to a context we can't get a track out of
587
+ ctx.close().catch(() => {});
575
588
  throw Error('Could not get empty media stream audio track');
576
589
  }
577
590
  emptyAudioStreamTrack.enabled = false;
591
+ emptyAudioStreamContext = ctx;
592
+ }
593
+ const track = emptyAudioStreamTrack.clone();
594
+ outstandingEmptyAudioStreamTracks.add(track);
595
+ return track;
596
+ }
597
+
598
+ /**
599
+ * Stops a track obtained from `getEmptyAudioStreamTrack` and closes the shared `AudioContext`
600
+ * backing it once every track it handed out has been released. Does nothing for a track this
601
+ * module never handed out, or one that has been released already.
602
+ */
603
+ export async function releaseEmptyAudioStreamTrack(track: MediaStreamTrack) {
604
+ if (!outstandingEmptyAudioStreamTracks.delete(track)) {
605
+ // the track wasn't obtained from `getEmptyAudioStreamTrack`, or has been released before
606
+ return;
578
607
  }
579
- return emptyAudioStreamTrack.clone();
580
- }
581
-
582
- export function getStereoAudioStreamTrack() {
583
- const ctx = new AudioContext();
584
- const oscLeft = ctx.createOscillator();
585
- const oscRight = ctx.createOscillator();
586
- oscLeft.frequency.value = 440;
587
- oscRight.frequency.value = 220;
588
- const merger = ctx.createChannelMerger(2);
589
- oscLeft.connect(merger, 0, 0); // left channel
590
- oscRight.connect(merger, 0, 1); // right channel
591
- const dst = ctx.createMediaStreamDestination();
592
- merger.connect(dst);
593
- oscLeft.start();
594
- oscRight.start();
595
- const [stereoTrack] = dst.stream.getAudioTracks();
596
- if (!stereoTrack) {
597
- throw Error('Could not get stereo media stream audio track');
608
+ track.stop();
609
+ if (outstandingEmptyAudioStreamTracks.size > 0) {
610
+ return;
598
611
  }
599
- return stereoTrack;
612
+ const context = emptyAudioStreamContext;
613
+ emptyAudioStreamTrack?.stop();
614
+ emptyAudioStreamTrack = undefined;
615
+ emptyAudioStreamContext = undefined;
616
+ await context?.close();
600
617
  }
601
618
 
602
619
  /** An object that represents a serialized version of a `new Promise((resolve, reject) => {})`
@@ -708,11 +725,20 @@ export function createAudioAnalyser(
708
725
  return volume;
709
726
  };
710
727
 
728
+ let isCleanedUp = false;
729
+
711
730
  const cleanup = async () => {
712
- await audioContext.close();
731
+ if (isCleanedUp) {
732
+ // closing an already closed context would reject, make repeated cleanups a no-op instead
733
+ return;
734
+ }
735
+ isCleanedUp = true;
736
+ mediaStreamSource.disconnect();
737
+ analyser.disconnect();
713
738
  if (opts.cloneTrack) {
714
739
  streamTrack.stop();
715
740
  }
741
+ await audioContext.close();
716
742
  };
717
743
 
718
744
  return { calculateVolume, analyser, cleanup };
@@ -751,6 +777,43 @@ export function unwrapConstraint(constraint: ConstrainDOMString | ConstrainULong
751
777
  throw Error('could not unwrap constraint');
752
778
  }
753
779
 
780
+ /**
781
+ * The getUserMedia rejections that no softer constraint can recover from, because the user or the
782
+ * document refused capture outright. Retrying one of these would put a second prompt in front of
783
+ * someone who already said no. The last two names are legacy spellings still reported by older
784
+ * engines. Matched by `name` rather than with `instanceof`, because these are not reliably distinct
785
+ * constructors across environments. happy-dom, which the tests run under, aliases them to `Event`.
786
+ */
787
+ export function isPermissionDeniedError(e: unknown): boolean {
788
+ return (
789
+ typeof e === 'object' &&
790
+ e !== null &&
791
+ 'name' in e &&
792
+ (e.name === 'NotAllowedError' ||
793
+ e.name === 'SecurityError' ||
794
+ e.name === 'PermissionDeniedError' ||
795
+ e.name === 'PermissionDismissedError')
796
+ );
797
+ }
798
+
799
+ const deviceAcquisitionFailures = new WeakSet();
800
+
801
+ /** Records that `e` is the rejection getUserMedia itself produced. */
802
+ export function markDeviceAcquisitionFailure(e: unknown) {
803
+ if (typeof e === 'object' && e !== null) {
804
+ deviceAcquisitionFailures.add(e);
805
+ }
806
+ }
807
+
808
+ /**
809
+ * Whether a track restart failed at getUserMedia rather than in the work that adopts the new track.
810
+ * Recorded on the side rather than by wrapping, because callers of `restartTrack` match on the
811
+ * rejection's own name.
812
+ */
813
+ export function isDeviceAcquisitionFailure(e: unknown): boolean {
814
+ return typeof e === 'object' && e !== null && deviceAcquisitionFailures.has(e);
815
+ }
816
+
754
817
  export function toWebsocketUrl(url: string): string {
755
818
  if (url.startsWith('http')) {
756
819
  return url.replace(/^(http)/, 'ws');
@@ -0,0 +1,95 @@
1
+ import { defaultVideoCodec } from '../defaults';
2
+ import { DeviceUnsupportedError, TrackInvalidError } from '../errors';
3
+ import LocalAudioTrack from '../track/LocalAudioTrack';
4
+ import type LocalTrack from '../track/LocalTrack';
5
+ import LocalVideoTrack from '../track/LocalVideoTrack';
6
+ import { Track } from '../track/Track';
7
+ import { type VideoCapture, createLocalTracks, setVideoCapture } from '../track/create';
8
+ import type {
9
+ ScreenShareCaptureOptions,
10
+ TrackPublishDefaults,
11
+ VideoCaptureOptions,
12
+ VideoEncoding,
13
+ } from '../track/options';
14
+ import { ScreenSharePresets, VideoPresets } from '../track/options';
15
+ import { screenCaptureToDisplayMediaStreamOptions } from '../track/utils';
16
+ import { isSafari17Based } from '../utils';
17
+
18
+ export const videoDefaults: VideoCaptureOptions = {
19
+ deviceId: { ideal: 'default' },
20
+ resolution: VideoPresets.h720.resolution,
21
+ };
22
+
23
+ /** The video part of `publishDefaults`; the `video` extension merges it under the room options. */
24
+ export const videoPublishDefaults = {
25
+ simulcast: true,
26
+ screenShareEncoding: ScreenSharePresets.h1080fps15.encoding as VideoEncoding,
27
+ videoCodec: defaultVideoCodec,
28
+ backupCodec: true,
29
+ } as const satisfies Partial<TrackPublishDefaults>;
30
+
31
+ const videoCapture: VideoCapture = {
32
+ defaults: videoDefaults,
33
+ createTrack: (mediaStreamTrack, constraints, userProvidedTrack, loggerOptions) =>
34
+ new LocalVideoTrack(mediaStreamTrack, constraints, userProvidedTrack, loggerOptions),
35
+ };
36
+
37
+ /**
38
+ * Lets `createLocalTracks` and `publishTrack` produce video tracks. Safe to call repeatedly.
39
+ * @experimental
40
+ */
41
+ export function registerVideoCapture() {
42
+ setVideoCapture(videoCapture);
43
+ }
44
+
45
+ /**
46
+ * Creates a [[LocalVideoTrack]] with getUserMedia()
47
+ * @param options
48
+ */
49
+ export async function createLocalVideoTrack(
50
+ options?: VideoCaptureOptions,
51
+ ): Promise<LocalVideoTrack> {
52
+ registerVideoCapture();
53
+ const tracks = await createLocalTracks({
54
+ audio: false,
55
+ video: options ?? true,
56
+ });
57
+ return <LocalVideoTrack>tracks[0];
58
+ }
59
+
60
+ /**
61
+ * Creates a screen capture tracks with getDisplayMedia().
62
+ * A LocalVideoTrack is always created and returned.
63
+ * If { audio: true }, and the browser supports audio capture, a LocalAudioTrack is also created.
64
+ */
65
+ export async function createLocalScreenTracks(
66
+ options?: ScreenShareCaptureOptions,
67
+ ): Promise<Array<LocalTrack>> {
68
+ if (options === undefined) {
69
+ options = {};
70
+ }
71
+ if (options.resolution === undefined && !isSafari17Based()) {
72
+ options.resolution = ScreenSharePresets.h1080fps30.resolution;
73
+ }
74
+
75
+ if (navigator.mediaDevices.getDisplayMedia === undefined) {
76
+ throw new DeviceUnsupportedError('getDisplayMedia not supported');
77
+ }
78
+
79
+ const constraints = screenCaptureToDisplayMediaStreamOptions(options);
80
+ const stream: MediaStream = await navigator.mediaDevices.getDisplayMedia(constraints);
81
+
82
+ const tracks = stream.getVideoTracks();
83
+ if (tracks.length === 0) {
84
+ throw new TrackInvalidError('no video track found');
85
+ }
86
+ const screenVideo = new LocalVideoTrack(tracks[0], undefined, false);
87
+ screenVideo.source = Track.Source.ScreenShare;
88
+ const localTracks: Array<LocalTrack> = [screenVideo];
89
+ if (stream.getAudioTracks().length > 0) {
90
+ const screenAudio = new LocalAudioTrack(stream.getAudioTracks()[0], undefined, false);
91
+ screenAudio.source = Track.Source.ScreenShareAudio;
92
+ localTracks.push(screenAudio);
93
+ }
94
+ return localTracks;
95
+ }