livekit-client 2.23.0 → 2.24.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 (879) hide show
  1. package/README.md +47 -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 +1214 -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 +600 -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 +234 -0
  167. package/dist/core/room/rpc/client/RpcClientManager.mjs.map +1 -0
  168. package/dist/core/room/rpc/extension.mjs +83 -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 +150 -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 +855 -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 +90 -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 +77 -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 +90 -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 +77 -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 +163 -134
  535. package/dist/livekit-client.e2ee.worker.mjs.map +1 -1
  536. package/dist/livekit-client.esm.mjs +31589 -30883
  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.map +1 -1
  547. package/dist/src/connectionHelper/checks/Checker.d.ts +7 -4
  548. package/dist/src/connectionHelper/checks/Checker.d.ts.map +1 -1
  549. package/dist/src/core.d.ts +33 -0
  550. package/dist/src/core.d.ts.map +1 -0
  551. package/dist/src/e2ee/E2eeManager.d.ts +26 -5
  552. package/dist/src/e2ee/E2eeManager.d.ts.map +1 -1
  553. package/dist/src/e2ee/KeyProvider.d.ts.map +1 -1
  554. package/dist/src/e2ee/extension.d.ts +19 -0
  555. package/dist/src/e2ee/extension.d.ts.map +1 -0
  556. package/dist/src/e2ee/types.d.ts +14 -0
  557. package/dist/src/e2ee/types.d.ts.map +1 -1
  558. package/dist/src/e2ee/utils.d.ts +6 -1
  559. package/dist/src/e2ee/utils.d.ts.map +1 -1
  560. package/dist/src/e2ee/worker/FrameCryptor.d.ts +7 -1
  561. package/dist/src/e2ee/worker/FrameCryptor.d.ts.map +1 -1
  562. package/dist/src/e2ee/worker/naluUtils.d.ts +7 -0
  563. package/dist/src/e2ee/worker/naluUtils.d.ts.map +1 -1
  564. package/dist/src/e2ee/worker/sifPayload.d.ts +1 -1
  565. package/dist/src/e2ee/worker/sifPayload.d.ts.map +1 -1
  566. package/dist/src/exports.d.ts +76 -0
  567. package/dist/src/exports.d.ts.map +1 -0
  568. package/dist/src/frameMetadata/FrameMetadataManager.d.ts +5 -2
  569. package/dist/src/frameMetadata/FrameMetadataManager.d.ts.map +1 -1
  570. package/dist/src/frameMetadata/extension.d.ts +11 -0
  571. package/dist/src/frameMetadata/extension.d.ts.map +1 -0
  572. package/dist/src/frameMetadata/utils.d.ts +5 -0
  573. package/dist/src/frameMetadata/utils.d.ts.map +1 -1
  574. package/dist/src/index.d.ts +35 -63
  575. package/dist/src/index.d.ts.map +1 -1
  576. package/dist/src/logger.d.ts +1 -3
  577. package/dist/src/logger.d.ts.map +1 -1
  578. package/dist/src/options.d.ts +20 -6
  579. package/dist/src/options.d.ts.map +1 -1
  580. package/dist/src/room/CoreRoom.d.ts +392 -0
  581. package/dist/src/room/CoreRoom.d.ts.map +1 -0
  582. package/dist/src/room/PCTransport.d.ts +5 -2
  583. package/dist/src/room/PCTransport.d.ts.map +1 -1
  584. package/dist/src/room/PCTransportManager.d.ts +8 -4
  585. package/dist/src/room/PCTransportManager.d.ts.map +1 -1
  586. package/dist/src/room/RTCEngine.d.ts +23 -6
  587. package/dist/src/room/RTCEngine.d.ts.map +1 -1
  588. package/dist/src/room/Room.d.ts +5 -403
  589. package/dist/src/room/Room.d.ts.map +1 -1
  590. package/dist/src/room/chat/extension.d.ts +22 -0
  591. package/dist/src/room/chat/extension.d.ts.map +1 -0
  592. package/dist/src/room/createRoom.d.ts +19 -0
  593. package/dist/src/room/createRoom.d.ts.map +1 -0
  594. package/dist/src/room/data-channel/DataChannelManager.d.ts +7 -1
  595. package/dist/src/room/data-channel/DataChannelManager.d.ts.map +1 -1
  596. package/dist/src/room/data-stream/constants.d.ts +9 -0
  597. package/dist/src/room/data-stream/constants.d.ts.map +1 -1
  598. package/dist/src/room/data-stream/extension.d.ts +73 -0
  599. package/dist/src/room/data-stream/extension.d.ts.map +1 -0
  600. package/dist/src/room/data-stream/incoming/IncomingDataStreamManager.d.ts +6 -1
  601. package/dist/src/room/data-stream/incoming/IncomingDataStreamManager.d.ts.map +1 -1
  602. package/dist/src/room/data-stream/incoming/StreamReader.d.ts.map +1 -1
  603. package/dist/src/room/data-stream/outgoing/OutgoingDataStreamManager.d.ts +0 -1
  604. package/dist/src/room/data-stream/outgoing/OutgoingDataStreamManager.d.ts.map +1 -1
  605. package/dist/src/room/data-track/LocalDataTrack.d.ts +1 -1
  606. package/dist/src/room/data-track/depacketizer.d.ts +1 -1
  607. package/dist/src/room/data-track/depacketizer.d.ts.map +1 -1
  608. package/dist/src/room/data-track/extension.d.ts +31 -0
  609. package/dist/src/room/data-track/extension.d.ts.map +1 -0
  610. package/dist/src/room/data-track/handle.d.ts +1 -1
  611. package/dist/src/room/data-track/handle.d.ts.map +1 -1
  612. package/dist/src/room/data-track/incoming/IncomingDataTrackManager.d.ts +1 -1
  613. package/dist/src/room/data-track/incoming/IncomingDataTrackManager.d.ts.map +1 -1
  614. package/dist/src/room/data-track/incoming/pipeline.d.ts +1 -1
  615. package/dist/src/room/data-track/incoming/pipeline.d.ts.map +1 -1
  616. package/dist/src/room/data-track/outgoing/OutgoingDataTrackManager.d.ts +2 -1
  617. package/dist/src/room/data-track/outgoing/OutgoingDataTrackManager.d.ts.map +1 -1
  618. package/dist/src/room/data-track/outgoing/pipeline.d.ts +1 -1
  619. package/dist/src/room/data-track/outgoing/pipeline.d.ts.map +1 -1
  620. package/dist/src/room/data-track/packet/extensions.d.ts +1 -1
  621. package/dist/src/room/data-track/packet/extensions.d.ts.map +1 -1
  622. package/dist/src/room/data-track/packet/index.d.ts +1 -1
  623. package/dist/src/room/data-track/packet/index.d.ts.map +1 -1
  624. package/dist/src/room/data-track/packet/serializable.d.ts +1 -1
  625. package/dist/src/room/data-track/packet/serializable.d.ts.map +1 -1
  626. package/dist/src/room/data-track/packetizer.d.ts +1 -1
  627. package/dist/src/room/data-track/packetizer.d.ts.map +1 -1
  628. package/dist/src/room/data-track/track-interfaces.d.ts +1 -1
  629. package/dist/src/room/data-track/track-interfaces.d.ts.map +1 -1
  630. package/dist/src/room/data-track/utils.d.ts +1 -1
  631. package/dist/src/room/defaults.d.ts +1 -2
  632. package/dist/src/room/defaults.d.ts.map +1 -1
  633. package/dist/src/room/extensions.d.ts +208 -0
  634. package/dist/src/room/extensions.d.ts.map +1 -0
  635. package/dist/src/room/participant/LocalParticipant.d.ts +45 -120
  636. package/dist/src/room/participant/LocalParticipant.d.ts.map +1 -1
  637. package/dist/src/room/participant/Participant.d.ts +8 -1
  638. package/dist/src/room/participant/Participant.d.ts.map +1 -1
  639. package/dist/src/room/participant/RemoteParticipant.d.ts +3 -3
  640. package/dist/src/room/participant/RemoteParticipant.d.ts.map +1 -1
  641. package/dist/src/room/participant/publishUtils.d.ts.map +1 -1
  642. package/dist/src/room/rpc/client/RpcClientManager.d.ts +5 -0
  643. package/dist/src/room/rpc/client/RpcClientManager.d.ts.map +1 -1
  644. package/dist/src/room/rpc/extension.d.ts +70 -0
  645. package/dist/src/room/rpc/extension.d.ts.map +1 -0
  646. package/dist/src/room/rpc/index.d.ts +1 -1
  647. package/dist/src/room/rpc/index.d.ts.map +1 -1
  648. package/dist/src/room/rpc/legacyExtension.d.ts +34 -0
  649. package/dist/src/room/rpc/legacyExtension.d.ts.map +1 -0
  650. package/dist/src/room/rpc/utils.d.ts +1 -0
  651. package/dist/src/room/rpc/utils.d.ts.map +1 -1
  652. package/dist/src/room/simulated-participants/extension.d.ts +25 -0
  653. package/dist/src/room/simulated-participants/extension.d.ts.map +1 -0
  654. package/dist/src/room/token-source/TokenSource.d.ts +5 -1
  655. package/dist/src/room/token-source/TokenSource.d.ts.map +1 -1
  656. package/dist/src/room/token-source/utils.d.ts.map +1 -1
  657. package/dist/src/room/track/LocalTrack.d.ts +1 -1
  658. package/dist/src/room/track/LocalTrack.d.ts.map +1 -1
  659. package/dist/src/room/track/LocalVideoTrack.d.ts.map +1 -1
  660. package/dist/src/room/track/RemoteTrackPublication.d.ts +14 -1
  661. package/dist/src/room/track/RemoteTrackPublication.d.ts.map +1 -1
  662. package/dist/src/room/track/Track.d.ts.map +1 -1
  663. package/dist/src/room/track/TrackPublication.d.ts +2 -2
  664. package/dist/src/room/track/TrackPublication.d.ts.map +1 -1
  665. package/dist/src/room/track/create.d.ts +15 -13
  666. package/dist/src/room/track/create.d.ts.map +1 -1
  667. package/dist/src/room/track/facingMode.d.ts.map +1 -1
  668. package/dist/src/room/track/options.d.ts +0 -6
  669. package/dist/src/room/track/options.d.ts.map +1 -1
  670. package/dist/src/room/track/processor/types.d.ts +2 -2
  671. package/dist/src/room/track/processor/types.d.ts.map +1 -1
  672. package/dist/src/room/track/utils.d.ts +1 -1
  673. package/dist/src/room/track/utils.d.ts.map +1 -1
  674. package/dist/src/room/utils.d.ts +2 -2
  675. package/dist/src/room/utils.d.ts.map +1 -1
  676. package/dist/src/room/video/create.d.ts +28 -0
  677. package/dist/src/room/video/create.d.ts.map +1 -0
  678. package/dist/src/room/video/extension.d.ts +48 -0
  679. package/dist/src/room/video/extension.d.ts.map +1 -0
  680. package/dist/src/room/video/publisher.d.ts +24 -0
  681. package/dist/src/room/video/publisher.d.ts.map +1 -0
  682. package/dist/src/test/MockMediaStream.d.ts +6 -0
  683. package/dist/src/test/MockMediaStream.d.ts.map +1 -0
  684. package/dist/src/utils/browserParser.d.ts +0 -3
  685. package/dist/src/utils/browserParser.d.ts.map +1 -1
  686. package/dist/src/utils/deferrable-map.d.ts +1 -1
  687. package/dist/src/utils/deferrable-map.d.ts.map +1 -1
  688. package/dist/src/utils/serializer.d.ts.map +1 -1
  689. package/dist/src/utils/throws.d.ts +10 -0
  690. package/dist/src/utils/throws.d.ts.map +1 -0
  691. package/dist/src/version.d.ts +4 -1
  692. package/dist/src/version.d.ts.map +1 -1
  693. package/dist/ts4.2/connectionHelper/checks/Checker.d.ts +7 -4
  694. package/dist/ts4.2/core.d.ts +34 -0
  695. package/dist/ts4.2/e2ee/E2eeManager.d.ts +26 -5
  696. package/dist/ts4.2/e2ee/extension.d.ts +20 -0
  697. package/dist/ts4.2/e2ee/types.d.ts +14 -0
  698. package/dist/ts4.2/e2ee/utils.d.ts +6 -1
  699. package/dist/ts4.2/e2ee/worker/FrameCryptor.d.ts +7 -1
  700. package/dist/ts4.2/e2ee/worker/naluUtils.d.ts +7 -0
  701. package/dist/ts4.2/e2ee/worker/sifPayload.d.ts +1 -1
  702. package/dist/ts4.2/exports.d.ts +83 -0
  703. package/dist/ts4.2/frameMetadata/FrameMetadataManager.d.ts +5 -2
  704. package/dist/ts4.2/frameMetadata/extension.d.ts +13 -0
  705. package/dist/ts4.2/frameMetadata/utils.d.ts +5 -0
  706. package/dist/ts4.2/index.d.ts +35 -69
  707. package/dist/ts4.2/logger.d.ts +1 -3
  708. package/dist/ts4.2/options.d.ts +20 -6
  709. package/dist/ts4.2/room/CoreRoom.d.ts +381 -0
  710. package/dist/ts4.2/room/PCTransport.d.ts +5 -2
  711. package/dist/ts4.2/room/PCTransportManager.d.ts +8 -4
  712. package/dist/ts4.2/room/RTCEngine.d.ts +23 -6
  713. package/dist/ts4.2/room/Room.d.ts +6 -392
  714. package/dist/ts4.2/room/chat/extension.d.ts +22 -0
  715. package/dist/ts4.2/room/createRoom.d.ts +20 -0
  716. package/dist/ts4.2/room/data-channel/DataChannelManager.d.ts +6 -1
  717. package/dist/ts4.2/room/data-stream/constants.d.ts +9 -0
  718. package/dist/ts4.2/room/data-stream/extension.d.ts +74 -0
  719. package/dist/ts4.2/room/data-stream/incoming/IncomingDataStreamManager.d.ts +6 -1
  720. package/dist/ts4.2/room/data-stream/outgoing/OutgoingDataStreamManager.d.ts +0 -1
  721. package/dist/ts4.2/room/data-track/LocalDataTrack.d.ts +1 -1
  722. package/dist/ts4.2/room/data-track/depacketizer.d.ts +1 -1
  723. package/dist/ts4.2/room/data-track/extension.d.ts +31 -0
  724. package/dist/ts4.2/room/data-track/handle.d.ts +1 -1
  725. package/dist/ts4.2/room/data-track/incoming/IncomingDataTrackManager.d.ts +1 -1
  726. package/dist/ts4.2/room/data-track/incoming/pipeline.d.ts +1 -1
  727. package/dist/ts4.2/room/data-track/outgoing/OutgoingDataTrackManager.d.ts +2 -1
  728. package/dist/ts4.2/room/data-track/outgoing/pipeline.d.ts +1 -1
  729. package/dist/ts4.2/room/data-track/packet/extensions.d.ts +1 -1
  730. package/dist/ts4.2/room/data-track/packet/index.d.ts +1 -1
  731. package/dist/ts4.2/room/data-track/packet/serializable.d.ts +1 -1
  732. package/dist/ts4.2/room/data-track/packetizer.d.ts +1 -1
  733. package/dist/ts4.2/room/data-track/track-interfaces.d.ts +1 -1
  734. package/dist/ts4.2/room/data-track/utils.d.ts +1 -1
  735. package/dist/ts4.2/room/defaults.d.ts +1 -2
  736. package/dist/ts4.2/room/extensions.d.ts +214 -0
  737. package/dist/ts4.2/room/participant/LocalParticipant.d.ts +44 -121
  738. package/dist/ts4.2/room/participant/Participant.d.ts +8 -1
  739. package/dist/ts4.2/room/participant/RemoteParticipant.d.ts +3 -3
  740. package/dist/ts4.2/room/rpc/client/RpcClientManager.d.ts +5 -0
  741. package/dist/ts4.2/room/rpc/extension.d.ts +74 -0
  742. package/dist/ts4.2/room/rpc/index.d.ts +1 -1
  743. package/dist/ts4.2/room/rpc/legacyExtension.d.ts +39 -0
  744. package/dist/ts4.2/room/rpc/utils.d.ts +1 -0
  745. package/dist/ts4.2/room/simulated-participants/extension.d.ts +25 -0
  746. package/dist/ts4.2/room/token-source/TokenSource.d.ts +5 -1
  747. package/dist/ts4.2/room/track/LocalTrack.d.ts +1 -1
  748. package/dist/ts4.2/room/track/RemoteTrackPublication.d.ts +3 -1
  749. package/dist/ts4.2/room/track/TrackPublication.d.ts +2 -2
  750. package/dist/ts4.2/room/track/create.d.ts +15 -13
  751. package/dist/ts4.2/room/track/options.d.ts +0 -6
  752. package/dist/ts4.2/room/track/processor/types.d.ts +2 -2
  753. package/dist/ts4.2/room/track/utils.d.ts +1 -1
  754. package/dist/ts4.2/room/utils.d.ts +2 -2
  755. package/dist/ts4.2/room/video/create.d.ts +28 -0
  756. package/dist/ts4.2/room/video/extension.d.ts +48 -0
  757. package/dist/ts4.2/room/video/publisher.d.ts +24 -0
  758. package/dist/ts4.2/test/MockMediaStream.d.ts +6 -0
  759. package/dist/ts4.2/utils/browserParser.d.ts +0 -3
  760. package/dist/ts4.2/utils/deferrable-map.d.ts +1 -1
  761. package/dist/ts4.2/utils/throws.d.ts +10 -0
  762. package/dist/ts4.2/version.d.ts +4 -1
  763. package/package.json +24 -9
  764. package/src/api/SignalClient.test.ts +150 -0
  765. package/src/api/SignalClient.ts +19 -4
  766. package/src/api/WebSocketStream.test.ts +67 -0
  767. package/src/api/WebSocketStream.ts +41 -3
  768. package/src/connectionHelper/checks/Checker.ts +12 -5
  769. package/src/connectionHelper/checks/publishVideo.ts +1 -1
  770. package/src/connectionHelper/checks/reconnect.ts +1 -1
  771. package/src/core.ts +35 -0
  772. package/src/e2ee/E2eeManager.test.ts +156 -3
  773. package/src/e2ee/E2eeManager.ts +64 -41
  774. package/src/e2ee/KeyProvider.ts +2 -1
  775. package/src/e2ee/extension.ts +113 -0
  776. package/src/e2ee/subscriberBlackScreen.test.ts +9 -12
  777. package/src/e2ee/types.ts +14 -0
  778. package/src/e2ee/utils.test.ts +47 -0
  779. package/src/e2ee/utils.ts +26 -14
  780. package/src/e2ee/worker/DataCryptor.test.ts +42 -1
  781. package/src/e2ee/worker/DataCryptor.ts +2 -2
  782. package/src/e2ee/worker/FrameCryptor.race.test.ts +3 -7
  783. package/src/e2ee/worker/FrameCryptor.test.ts +94 -13
  784. package/src/e2ee/worker/FrameCryptor.ts +85 -22
  785. package/src/e2ee/worker/e2ee.worker.test.ts +151 -0
  786. package/src/e2ee/worker/e2ee.worker.ts +28 -20
  787. package/src/e2ee/worker/naluUtils.test.ts +21 -1
  788. package/src/e2ee/worker/naluUtils.ts +30 -0
  789. package/src/e2ee/worker/sifPayload.ts +1 -1
  790. package/src/exports.ts +224 -0
  791. package/src/frameMetadata/FrameMetadataManager.ts +9 -3
  792. package/src/frameMetadata/extension.ts +34 -0
  793. package/src/frameMetadata/frameMetadata.ts +1 -1
  794. package/src/frameMetadata/utils.ts +23 -0
  795. package/src/index.ts +47 -189
  796. package/src/logger.ts +1 -3
  797. package/src/options.ts +25 -6
  798. package/src/room/CoreRoom.ts +3017 -0
  799. package/src/room/DeviceManager.test.ts +55 -1
  800. package/src/room/DeviceManager.ts +1 -1
  801. package/src/room/PCTransport.test.ts +43 -0
  802. package/src/room/PCTransport.ts +22 -22
  803. package/src/room/PCTransportManager.test.ts +65 -3
  804. package/src/room/PCTransportManager.ts +28 -12
  805. package/src/room/RTCEngine.test.ts +421 -21
  806. package/src/room/RTCEngine.ts +138 -34
  807. package/src/room/RegionUrlProvider.ts +1 -1
  808. package/src/room/Room.test.ts +741 -4
  809. package/src/room/Room.ts +34 -3317
  810. package/src/room/chat/extension.ts +78 -0
  811. package/src/room/createRoom.test.ts +149 -0
  812. package/src/room/createRoom.ts +26 -0
  813. package/src/room/data-channel/DataChannelManager.test.ts +37 -0
  814. package/src/room/data-channel/DataChannelManager.ts +21 -3
  815. package/src/room/data-stream/constants.ts +10 -0
  816. package/src/room/data-stream/extension.ts +162 -0
  817. package/src/room/data-stream/incoming/IncomingDataStreamManager.test.ts +269 -3
  818. package/src/room/data-stream/incoming/IncomingDataStreamManager.ts +53 -2
  819. package/src/room/data-stream/incoming/StreamReader.ts +14 -4
  820. package/src/room/data-stream/outgoing/OutgoingDataStreamManager.ts +1 -2
  821. package/src/room/data-track/depacketizer.ts +2 -2
  822. package/src/room/data-track/extension.ts +244 -0
  823. package/src/room/data-track/handle.ts +1 -1
  824. package/src/room/data-track/incoming/IncomingDataTrackManager.ts +2 -2
  825. package/src/room/data-track/incoming/pipeline.ts +2 -2
  826. package/src/room/data-track/outgoing/OutgoingDataTrackManager.test.ts +42 -3
  827. package/src/room/data-track/outgoing/OutgoingDataTrackManager.ts +5 -3
  828. package/src/room/data-track/outgoing/pipeline.ts +1 -1
  829. package/src/room/data-track/packet/extensions.ts +1 -1
  830. package/src/room/data-track/packet/index.ts +1 -1
  831. package/src/room/data-track/packet/serializable.ts +1 -1
  832. package/src/room/data-track/packetizer.ts +1 -1
  833. package/src/room/data-track/track-interfaces.ts +4 -4
  834. package/src/room/data-track/utils.ts +1 -1
  835. package/src/room/defaults.ts +3 -16
  836. package/src/room/extensions.ts +310 -0
  837. package/src/room/participant/LocalParticipant.test.ts +23 -6
  838. package/src/room/participant/LocalParticipant.ts +92 -669
  839. package/src/room/participant/Participant.test.ts +60 -0
  840. package/src/room/participant/Participant.ts +21 -1
  841. package/src/room/participant/RemoteParticipant.ts +3 -8
  842. package/src/room/participant/publishUtils.ts +3 -3
  843. package/src/room/participant/restartOnDefaultAudioDevice.test.ts +1 -1
  844. package/src/room/rpc/client/RpcClientManager.test.ts +29 -0
  845. package/src/room/rpc/client/RpcClientManager.ts +17 -0
  846. package/src/room/rpc/extension.ts +162 -0
  847. package/src/room/rpc/index.ts +1 -10
  848. package/src/room/rpc/legacyExtension.ts +36 -0
  849. package/src/room/rpc/utils.ts +2 -0
  850. package/src/room/simulated-participants/extension.ts +189 -0
  851. package/src/room/token-source/TokenSource.test.ts +29 -0
  852. package/src/room/token-source/TokenSource.ts +8 -3
  853. package/src/room/token-source/utils.test.ts +34 -0
  854. package/src/room/token-source/utils.ts +23 -1
  855. package/src/room/track/LocalTrack.ts +18 -10
  856. package/src/room/track/LocalVideoTrack.test.ts +66 -2
  857. package/src/room/track/LocalVideoTrack.ts +5 -3
  858. package/src/room/track/RemoteTrackPublication.ts +14 -1
  859. package/src/room/track/RemoteVideoTrack.test.ts +2 -0
  860. package/src/room/track/Track.test.ts +102 -0
  861. package/src/room/track/Track.ts +8 -1
  862. package/src/room/track/TrackPublication.ts +2 -2
  863. package/src/room/track/create.ts +59 -71
  864. package/src/room/track/facingMode.ts +5 -2
  865. package/src/room/track/options.ts +26 -34
  866. package/src/room/track/processor/types.ts +2 -2
  867. package/src/room/track/utils.ts +5 -1
  868. package/src/room/utils.test.ts +36 -1
  869. package/src/room/utils.ts +13 -3
  870. package/src/room/video/create.ts +95 -0
  871. package/src/room/video/extension.ts +115 -0
  872. package/src/room/video/publisher.ts +472 -0
  873. package/src/test/MockMediaStream.ts +13 -0
  874. package/src/utils/browserParser.ts +0 -3
  875. package/src/utils/deferrable-map.test.ts +60 -0
  876. package/src/utils/deferrable-map.ts +7 -4
  877. package/src/utils/serializer.ts +1 -1
  878. package/src/utils/throws.ts +15 -0
  879. package/src/version.ts +6 -1
@@ -14,7 +14,11 @@ import {
14
14
  import { areTokenSourceFetchOptionsEqual, decodeTokenPayload, isResponseTokenValid } from './utils';
15
15
 
16
16
  /** A TokenSourceCached is a TokenSource which caches the last {@link TokenSourceResponseObject} value and returns it
17
- * until a) it expires or b) the {@link TokenSourceFetchOptions} provided to .fetch(...) change. */
17
+ * until a) it expires or b) the {@link TokenSourceFetchOptions} provided to .fetch(...) change.
18
+ *
19
+ * Options are compared by value (including the entries of `participantAttributes`), but the cache keeps a
20
+ * reference to the options object passed to the last successful fetch. Treat that object as immutable: to fetch
21
+ * with different options, pass a new object rather than changing the previous one in place. */
18
22
  abstract class TokenSourceCached extends TokenSourceConfigurable {
19
23
  private cachedFetchOptions: TokenSourceFetchOptions | null = null;
20
24
 
@@ -62,9 +66,10 @@ abstract class TokenSourceCached extends TokenSourceConfigurable {
62
66
  if (this.shouldReturnCachedValueFromFetch(options)) {
63
67
  return this.cachedResponse!.toJson() as TokenSourceResponseObject;
64
68
  }
65
- this.cachedFetchOptions = options;
66
-
67
69
  const tokenResponse = await this.update(options);
70
+ // recorded only once the update succeeds, so a failed fetch cannot pair its options
71
+ // with the response cached for the previous ones
72
+ this.cachedFetchOptions = options;
68
73
  this.cachedResponse = tokenResponse;
69
74
  return tokenResponse.toJson() as TokenSourceResponseObject;
70
75
  } finally {
@@ -113,4 +113,38 @@ describe('areTokenSourceFetchOptionsEqual', () => {
113
113
  ),
114
114
  ).to.equal(false);
115
115
  });
116
+ it('should compare participant attributes by content', () => {
117
+ expect(
118
+ areTokenSourceFetchOptionsEqual(
119
+ { participantAttributes: { a: '1', b: '2' } },
120
+ { participantAttributes: { b: '2', a: '1' } },
121
+ ),
122
+ ).to.equal(true);
123
+ expect(
124
+ areTokenSourceFetchOptionsEqual(
125
+ { participantAttributes: { a: '1' } },
126
+ { participantAttributes: { a: '2' } },
127
+ ),
128
+ ).to.equal(false);
129
+ expect(
130
+ areTokenSourceFetchOptionsEqual(
131
+ { participantAttributes: { a: '1' } },
132
+ { participantAttributes: { a: '1', b: '2' } },
133
+ ),
134
+ ).to.equal(false);
135
+ expect(
136
+ areTokenSourceFetchOptionsEqual(
137
+ { participantAttributes: { role: 'viewer' } },
138
+ {
139
+ participantAttributes: Object.assign(Object.create({ role: 'viewer' }), { team: 'blue' }),
140
+ },
141
+ ),
142
+ ).to.equal(false);
143
+ expect(
144
+ areTokenSourceFetchOptionsEqual(
145
+ { participantAttributes: {} },
146
+ { participantAttributes: undefined },
147
+ ),
148
+ ).to.equal(false);
149
+ });
116
150
  });
@@ -62,7 +62,6 @@ export function areTokenSourceFetchOptionsEqual(
62
62
  case 'participantName':
63
63
  case 'participantIdentity':
64
64
  case 'participantMetadata':
65
- case 'participantAttributes':
66
65
  case 'agentName':
67
66
  case 'agentMetadata':
68
67
  case 'deployment':
@@ -70,6 +69,11 @@ export function areTokenSourceFetchOptionsEqual(
70
69
  return false;
71
70
  }
72
71
  break;
72
+ case 'participantAttributes':
73
+ if (!areAttributesEqual(a[key], b[key])) {
74
+ return false;
75
+ }
76
+ break;
73
77
  default:
74
78
  // ref: https://stackoverflow.com/a/58009992
75
79
  const exhaustiveCheckedKey: never = key;
@@ -79,3 +83,21 @@ export function areTokenSourceFetchOptionsEqual(
79
83
 
80
84
  return true;
81
85
  }
86
+
87
+ function areAttributesEqual(
88
+ a: TokenSourceFetchOptions['participantAttributes'],
89
+ b: TokenSourceFetchOptions['participantAttributes'],
90
+ ) {
91
+ if (a === b) {
92
+ return true;
93
+ }
94
+ if (!a || !b) {
95
+ return false;
96
+ }
97
+ const aKeys = Object.keys(a);
98
+ const bKeys = new Set(Object.keys(b));
99
+ if (aKeys.length !== bKeys.size) {
100
+ return false;
101
+ }
102
+ return aKeys.every((key) => bKeys.has(key) && a[key] === b[key]);
103
+ }
@@ -8,6 +8,7 @@ import type { LoggerOptions } from '../types';
8
8
  import {
9
9
  compareVersions,
10
10
  isAppleMobile,
11
+ isChromiumBased,
11
12
  isMobile,
12
13
  markDeviceAcquisitionFailure,
13
14
  sleep,
@@ -63,7 +64,7 @@ export default abstract class LocalTrack<
63
64
 
64
65
  protected processorElement?: HTMLMediaElement;
65
66
 
66
- protected processor?: TrackProcessor<TrackKind, any>;
67
+ protected processor?: TrackProcessor<TrackKind, any> | undefined;
67
68
 
68
69
  protected audioContext?: AudioContext;
69
70
 
@@ -252,15 +253,22 @@ export default abstract class LocalTrack<
252
253
 
253
254
  const started = Date.now();
254
255
 
255
- if (isAppleMobile()) {
256
- // iOS and iPadOS keep reporting the camera's sensor frame from getSettings() until the
257
- // camera has delivered its first picture, so a portrait capture initially reads as
258
- // landscape. Wait for that first frame instead of guessing at a delay.
259
- // Gated to the Apple capture pipeline rather than run everywhere: elsewhere getSettings() is
260
- // already right and the first frame can be hundreds of milliseconds out (measured ~500ms on
261
- // macOS Safari), which would be pure added publish latency.
262
- // https://github.com/livekit/client-sdk-js/issues/2099
263
- // https://github.com/livekit/client-sdk-js/issues/2107
256
+ if (isAppleMobile() || (isChromiumBased() && this.source === Track.Source.ScreenShare)) {
257
+ // In a few cases, wait for the first video frame:
258
+ //
259
+ // - iOS and iPadOS keep reporting the camera's sensor frame from getSettings() until the
260
+ // camera has delivered its first picture, so a portrait capture initially reads as
261
+ // landscape. Wait for that first frame instead of guessing at a delay.
262
+ // https://github.com/livekit/client-sdk-js/issues/2099
263
+ // https://github.com/livekit/client-sdk-js/issues/2107
264
+ //
265
+ // - Chrome reports the resolution a screen share asked for (1920x1080 for a 1536x664 tab), which
266
+ // would announce simulcast layers at sizes they never have.
267
+ // https://github.com/livekit/client-sdk-js/pull/2217
268
+ //
269
+ // Outside of these limited cases, getSettings() is already right and the first frame can
270
+ // be hundreds of milliseconds out (measured ~500ms on macOS Safari), which would be pure
271
+ // added publish latency.
264
272
  await waitForFirstVideoFrame(this._mediaStreamTrack, timeout, this.attachedElements);
265
273
  }
266
274
 
@@ -1,8 +1,20 @@
1
- import { describe, expect, it, vi } from 'vitest';
1
+ import { afterEach, describe, expect, it, vi } from 'vitest';
2
+ import { isChromiumBased } from '../utils';
2
3
  import LocalVideoTrack, { videoLayersFromEncodings } from './LocalVideoTrack';
3
4
  import type { SimulcastTrackInfo } from './LocalVideoTrack';
4
- import { VideoQuality } from './Track';
5
+ import { Track, VideoQuality } from './Track';
5
6
  import type { VideoCodec } from './options';
7
+ import { waitForFirstVideoFrame } from './utils';
8
+
9
+ vi.mock('../utils', async (importOriginal) => ({
10
+ ...(await importOriginal<typeof import('../utils')>()),
11
+ isChromiumBased: vi.fn(() => true),
12
+ }));
13
+
14
+ vi.mock('./utils', async (importOriginal) => ({
15
+ ...(await importOriginal<typeof import('./utils')>()),
16
+ waitForFirstVideoFrame: vi.fn(async () => true),
17
+ }));
6
18
 
7
19
  describe('videoLayersFromEncodings', () => {
8
20
  it('returns single layer for no encoding', () => {
@@ -234,3 +246,55 @@ describe('setDegradationPreference', () => {
234
246
  expect(events).toEqual(['primary:start', 'primary:done', 'backup:start', 'backup:done']);
235
247
  });
236
248
  });
249
+
250
+ /** A capture whose getSettings() reports `settings`, which a test may change in place */
251
+ function videoCapture(settings: MediaTrackSettings) {
252
+ return Object.assign(new EventTarget(), {
253
+ kind: 'video',
254
+ id: 'video-capture',
255
+ label: 'capture',
256
+ enabled: true,
257
+ muted: false,
258
+ readyState: 'live',
259
+ getSettings: () => settings,
260
+ getConstraints: () => ({}),
261
+ }) as unknown as MediaStreamTrack;
262
+ }
263
+
264
+ describe('waitForDimensions', () => {
265
+ afterEach(() => {
266
+ vi.mocked(waitForFirstVideoFrame).mockClear();
267
+ vi.mocked(isChromiumBased).mockReset().mockReturnValue(true);
268
+ });
269
+
270
+ it('reads a screen share once its first frame has arrived', async () => {
271
+ // Chrome reports the requested resolution until the shared tab delivers its first frame
272
+ const settings: MediaTrackSettings = { width: 1920, height: 1080 };
273
+ vi.mocked(waitForFirstVideoFrame).mockImplementationOnce(async () => {
274
+ Object.assign(settings, { width: 1536, height: 664 });
275
+ return true;
276
+ });
277
+ const track = new LocalVideoTrack(videoCapture(settings));
278
+ track.source = Track.Source.ScreenShare;
279
+
280
+ await expect(track.waitForDimensions()).resolves.toEqual({ width: 1536, height: 664 });
281
+ });
282
+
283
+ it('reads a camera without waiting for a frame', async () => {
284
+ const track = new LocalVideoTrack(videoCapture({ width: 1280, height: 720 }));
285
+ track.source = Track.Source.Camera;
286
+
287
+ await expect(track.waitForDimensions()).resolves.toEqual({ width: 1280, height: 720 });
288
+ expect(waitForFirstVideoFrame).not.toHaveBeenCalled();
289
+ });
290
+
291
+ it('reads a screen share outside Chromium without waiting for a frame', async () => {
292
+ // Firefox and Safari already report the delivered size from getSettings()
293
+ vi.mocked(isChromiumBased).mockReturnValue(false);
294
+ const track = new LocalVideoTrack(videoCapture({ width: 1536, height: 664 }));
295
+ track.source = Track.Source.ScreenShare;
296
+
297
+ await expect(track.waitForDimensions()).resolves.toEqual({ width: 1536, height: 664 });
298
+ expect(waitForFirstVideoFrame).not.toHaveBeenCalled();
299
+ });
300
+ });
@@ -109,9 +109,7 @@ export default class LocalVideoTrack extends LocalTrack<Track.Kind.Video> {
109
109
  /* @internal */
110
110
  startMonitor(signalClient: SignalClient) {
111
111
  this.signalClient = signalClient;
112
- if (!isWeb()) {
113
- return;
114
- }
112
+
115
113
  // save original encodings
116
114
  // TODO : merge simulcast tracks stats
117
115
  const params = this.sender?.getParameters();
@@ -119,6 +117,10 @@ export default class LocalVideoTrack extends LocalTrack<Track.Kind.Video> {
119
117
  this.encodings = params.encodings;
120
118
  }
121
119
 
120
+ if (!isWeb()) {
121
+ return;
122
+ }
123
+
122
124
  if (this.monitorInterval) {
123
125
  return;
124
126
  }
@@ -156,7 +156,9 @@ export default class RemoteTrackPublication extends TrackPublication {
156
156
  /**
157
157
  * Explicitly set the video dimensions for this track.
158
158
  *
159
- * This will take precedence over adaptive stream dimensions.
159
+ * With adaptive stream, the SDK requests the smaller of these and the adaptive stream dimensions
160
+ * (by pixel count).
161
+ * It clears a quality that was requested with `setVideoQuality()`.
160
162
  *
161
163
  * @param dimensions The video dimensions to set.
162
164
  */
@@ -195,6 +197,17 @@ export default class RemoteTrackPublication extends TrackPublication {
195
197
  this.emitTrackUpdate();
196
198
  }
197
199
 
200
+ /**
201
+ * The maximum video quality that was requested with `setVideoQuality()`.
202
+ * When no quality was requested, it is `VideoQuality.HIGH`. `setVideoDimensions()` clears the
203
+ * requested quality, so it is `VideoQuality.HIGH` after that call too.
204
+ *
205
+ * This value does not show the layer that the server sends. Adaptive stream and network
206
+ * bandwidth can make the server send a lower layer, and this value does not change.
207
+ *
208
+ * @see `RemoteVideoTrack.getReceiverStats()` (`frameWidth` and `frameHeight`) for the size of
209
+ * the video that the client receives.
210
+ */
198
211
  get videoQuality(): VideoQuality | undefined {
199
212
  return this.requestedMaxQuality ?? VideoQuality.HIGH;
200
213
  }
@@ -144,9 +144,11 @@ describe('Document Picture-in-Picture detection', () => {
144
144
  /**
145
145
  * Creates a frame in the given document and returns its document. happy-dom implements
146
146
  * neither frameElement nor a correct top on a frame's window, so both are wired up here.
147
+ * The empty srcdoc gives the frame a document: happy-dom does not load a src page by default.
147
148
  */
148
149
  function createFrame(parentDocument: Document, topWindow: Window) {
149
150
  const frame = parentDocument.createElement('iframe');
151
+ frame.srcdoc = '';
150
152
  parentDocument.body.appendChild(frame);
151
153
  const frameDocument = frame.contentDocument!;
152
154
  Object.defineProperties(frameDocument.defaultView!, {
@@ -0,0 +1,102 @@
1
+ import { afterEach, beforeEach, describe, expect, it, vi } from 'vitest';
2
+ import MockMediaStreamTrack from '../../test/MockMediaStreamTrack';
3
+ import { detachTrack } from './Track';
4
+
5
+ const CHROME_UA =
6
+ 'Mozilla/5.0 (Macintosh; Intel Mac OS X 10_15_7) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/142.0.0.0 Safari/537.36';
7
+ const FIREFOX_UA =
8
+ 'Mozilla/5.0 (Macintosh; Intel Mac OS X 10.15; rv:145.0) Gecko/20100101 Firefox/145.0';
9
+ const SAFARI_UA =
10
+ 'Mozilla/5.0 (Macintosh; Intel Mac OS X 10_15_7) AppleWebKit/605.1.15 (KHTML, like Gecko) Version/26.4 Safari/605.1.15';
11
+
12
+ const stubUserAgent = (userAgent: string) =>
13
+ vi.stubGlobal('navigator', { userAgent, product: 'Gecko' });
14
+
15
+ const mockTrack = (kind: 'audio' | 'video') => {
16
+ const track = new MockMediaStreamTrack();
17
+ track.kind = kind;
18
+ return track as MediaStreamTrack;
19
+ };
20
+
21
+ /** happy-dom's MediaStream implements everything except getTracks(), which detachTrack() reads. */
22
+ class TestMediaStream extends MediaStream {
23
+ getTracks() {
24
+ return [...this.getAudioTracks(), ...this.getVideoTracks()];
25
+ }
26
+ }
27
+
28
+ // Attaches the tracks to the element and records the element's srcObject each time a track is
29
+ // removed from the stream.
30
+ const attach = (element: HTMLMediaElement, tracks: MediaStreamTrack[]) => {
31
+ const stream = new TestMediaStream(tracks);
32
+ element.srcObject = stream;
33
+ const srcObjectOnRemove: Array<MediaProvider | null> = [];
34
+ const removeTrack = stream.removeTrack.bind(stream);
35
+ stream.removeTrack = (track) => {
36
+ srcObjectOnRemove.push(element.srcObject);
37
+ removeTrack(track);
38
+ };
39
+ return { stream, srcObjectOnRemove };
40
+ };
41
+
42
+ describe('detachTrack', () => {
43
+ beforeEach(() => {
44
+ stubUserAgent(CHROME_UA);
45
+ });
46
+
47
+ afterEach(() => {
48
+ vi.unstubAllGlobals();
49
+ });
50
+
51
+ it('releases the stream before removing an audio track in Chromium', () => {
52
+ const element = document.createElement('audio');
53
+ const audioTrack = mockTrack('audio');
54
+ const { srcObjectOnRemove } = attach(element, [audioTrack]);
55
+
56
+ detachTrack(audioTrack, element);
57
+
58
+ expect(srcObjectOnRemove).toEqual([null]);
59
+ expect(element.srcObject).toBeNull();
60
+ });
61
+
62
+ it('reattaches the remaining tracks after removing an audio track in Chromium', () => {
63
+ const element = document.createElement('video');
64
+ const videoTrack = mockTrack('video');
65
+ const audioTrack = mockTrack('audio');
66
+ const { stream, srcObjectOnRemove } = attach(element, [videoTrack, audioTrack]);
67
+
68
+ detachTrack(audioTrack, element);
69
+
70
+ expect(srcObjectOnRemove).toEqual([null]);
71
+ expect(element.srcObject).toBe(stream);
72
+ expect(stream.getTracks()).toEqual([videoTrack]);
73
+ });
74
+
75
+ it.each([
76
+ ['Firefox', FIREFOX_UA],
77
+ ['Safari', SAFARI_UA],
78
+ ])('removes an audio track without releasing the stream in %s', (_, userAgent) => {
79
+ stubUserAgent(userAgent);
80
+ const element = document.createElement('audio');
81
+ const audioTrack = mockTrack('audio');
82
+ const { stream, srcObjectOnRemove } = attach(element, [audioTrack]);
83
+
84
+ detachTrack(audioTrack, element);
85
+
86
+ expect(srcObjectOnRemove).toEqual([stream]);
87
+ expect(element.srcObject).toBeNull();
88
+ });
89
+
90
+ it('removes a video track without releasing the stream', () => {
91
+ const element = document.createElement('video');
92
+ const videoTrack = mockTrack('video');
93
+ const audioTrack = mockTrack('audio');
94
+ const { stream, srcObjectOnRemove } = attach(element, [videoTrack, audioTrack]);
95
+
96
+ detachTrack(videoTrack, element);
97
+
98
+ expect(srcObjectOnRemove).toEqual([stream]);
99
+ expect(element.srcObject).toBe(stream);
100
+ expect(stream.getTracks()).toEqual([audioTrack]);
101
+ });
102
+ });
@@ -13,7 +13,7 @@ import type { NonSharedUint8Array } from '../../type-polyfills/non-shared-typed-
13
13
  import { TrackEvent } from '../events';
14
14
  import { summarizeStatsReport } from '../statsSummary';
15
15
  import type { LoggerOptions } from '../types';
16
- import { isFireFox, isSafari, isWeb } from '../utils';
16
+ import { isChromiumBased, isFireFox, isSafari, isWeb } from '../utils';
17
17
  import type { TrackProcessor } from './processor/types';
18
18
  import { getLogContextFromTrack } from './utils';
19
19
 
@@ -443,6 +443,13 @@ export function attachToElement(track: MediaStreamTrack, element: HTMLMediaEleme
443
443
  export function detachTrack(track: MediaStreamTrack, element: HTMLMediaElement) {
444
444
  if (element.srcObject instanceof MediaStream) {
445
445
  const mediaStream = element.srcObject;
446
+ if (track.kind === 'audio' && isChromiumBased()) {
447
+ // Release the stream before removing an audio track from it. When an element stops playing,
448
+ // Chrome silences only the tracks still in its stream, so a removed remote audio track keeps
449
+ // playing while another remote audio element in the page plays. Firefox and Safari stop it.
450
+ // https://issues.chromium.org/issues/41336384
451
+ element.srcObject = null;
452
+ }
446
453
  mediaStream.removeTrack(track);
447
454
  if (mediaStream.getTracks().length > 0) {
448
455
  element.srcObject = mediaStream;
@@ -12,10 +12,10 @@ import { TrackEvent } from '../events';
12
12
  import type { LoggerOptions, TranscriptionSegment } from '../types';
13
13
  import { isAudioTrack, isVideoTrack } from '../utils';
14
14
  import LocalAudioTrack from './LocalAudioTrack';
15
- import LocalVideoTrack from './LocalVideoTrack';
15
+ import type LocalVideoTrack from './LocalVideoTrack';
16
16
  import RemoteAudioTrack from './RemoteAudioTrack';
17
17
  import type RemoteTrack from './RemoteTrack';
18
- import RemoteVideoTrack from './RemoteVideoTrack';
18
+ import type RemoteVideoTrack from './RemoteVideoTrack';
19
19
  import { Track } from './Track';
20
20
  import { getLogContextFromTrack } from './utils';
21
21
 
@@ -1,26 +1,47 @@
1
1
  import DeviceManager from '../DeviceManager';
2
- import { audioDefaults, videoDefaults } from '../defaults';
3
- import { DeviceUnsupportedError, TrackInvalidError } from '../errors';
4
- import { mediaTrackToLocalTrack } from '../participant/publishUtils';
2
+ import { audioDefaults } from '../defaults';
3
+ import { TrackInvalidError } from '../errors';
5
4
  import type { LoggerOptions } from '../types';
6
- import { isAudioTrack, isSafari17Based, isVideoTrack, unwrapConstraint } from '../utils';
5
+ import { isAudioTrack, isVideoTrack, unwrapConstraint } from '../utils';
7
6
  import LocalAudioTrack from './LocalAudioTrack';
8
7
  import type LocalTrack from './LocalTrack';
9
- import LocalVideoTrack from './LocalVideoTrack';
8
+ import type LocalVideoTrack from './LocalVideoTrack';
10
9
  import { Track } from './Track';
11
- import type {
12
- AudioCaptureOptions,
13
- CreateLocalTracksOptions,
14
- ScreenShareCaptureOptions,
15
- VideoCaptureOptions,
16
- } from './options';
17
- import { ScreenSharePresets } from './options';
18
- import {
19
- constraintsForOptions,
20
- extractProcessorsFromOptions,
21
- mergeDefaultOptions,
22
- screenCaptureToDisplayMediaStreamOptions,
23
- } from './utils';
10
+ import type { AudioCaptureOptions, CreateLocalTracksOptions, VideoCaptureOptions } from './options';
11
+ import { constraintsForOptions, extractProcessorsFromOptions, mergeDefaultOptions } from './utils';
12
+
13
+ /**
14
+ * How core creates video tracks. The `video` extension (and the full entry) registers it; without
15
+ * it, requesting a video track throws.
16
+ * @internal
17
+ */
18
+ export interface VideoCapture {
19
+ defaults: VideoCaptureOptions;
20
+ createTrack(
21
+ mediaStreamTrack: MediaStreamTrack,
22
+ constraints: MediaTrackConstraints | undefined,
23
+ userProvidedTrack: boolean,
24
+ loggerOptions?: LoggerOptions,
25
+ ): LocalVideoTrack;
26
+ }
27
+
28
+ let videoCapture: VideoCapture | undefined;
29
+
30
+ /** @internal */
31
+ export function setVideoCapture(capture: VideoCapture) {
32
+ videoCapture = capture;
33
+ }
34
+
35
+ /** @internal */
36
+ export function getVideoCapture(): VideoCapture {
37
+ if (!videoCapture) {
38
+ // @throws-transformer ignore - programmer error
39
+ throw new TrackInvalidError(
40
+ 'video capture is not available in this build, add the video extension',
41
+ );
42
+ }
43
+ return videoCapture;
44
+ }
24
45
 
25
46
  /**
26
47
  * Creates a local video and audio track at the same time. When acquiring both
@@ -91,7 +112,11 @@ export async function createLocalTracks(
91
112
  } else if (typeof internalOptions.video === 'object' && !internalOptions.video.deviceId) {
92
113
  internalOptions.video.deviceId = 'default';
93
114
  }
94
- const opts = mergeDefaultOptions(internalOptions, audioDefaults, videoDefaults);
115
+ const opts = mergeDefaultOptions(
116
+ internalOptions,
117
+ audioDefaults,
118
+ internalOptions.video ? getVideoCapture().defaults : undefined,
119
+ );
95
120
  const constraints = constraintsForOptions(opts);
96
121
 
97
122
  // Keep a reference to the promise on DeviceManager and await it in getLocalDevices()
@@ -129,7 +154,21 @@ export async function createLocalTracks(
129
154
  trackConstraints = { deviceId: newDeviceId };
130
155
  }
131
156
 
132
- const track = mediaTrackToLocalTrack(mediaStreamTrack, trackConstraints, loggerOptions);
157
+ const track: LocalTrack =
158
+ mediaStreamTrack.kind === 'audio'
159
+ ? new LocalAudioTrack(
160
+ mediaStreamTrack,
161
+ trackConstraints,
162
+ false,
163
+ undefined,
164
+ loggerOptions,
165
+ )
166
+ : getVideoCapture().createTrack(
167
+ mediaStreamTrack,
168
+ trackConstraints,
169
+ false,
170
+ loggerOptions,
171
+ );
133
172
  if (track.kind === Track.Kind.Video) {
134
173
  track.source = Track.Source.Camera;
135
174
  } else if (track.kind === Track.Kind.Audio) {
@@ -161,20 +200,6 @@ export async function createLocalTracks(
161
200
  }
162
201
  }
163
202
 
164
- /**
165
- * Creates a [[LocalVideoTrack]] with getUserMedia()
166
- * @param options
167
- */
168
- export async function createLocalVideoTrack(
169
- options?: VideoCaptureOptions,
170
- ): Promise<LocalVideoTrack> {
171
- const tracks = await createLocalTracks({
172
- audio: false,
173
- video: options ?? true,
174
- });
175
- return <LocalVideoTrack>tracks[0];
176
- }
177
-
178
203
  export async function createLocalAudioTrack(
179
204
  options?: AudioCaptureOptions,
180
205
  ): Promise<LocalAudioTrack> {
@@ -184,40 +209,3 @@ export async function createLocalAudioTrack(
184
209
  });
185
210
  return <LocalAudioTrack>tracks[0];
186
211
  }
187
-
188
- /**
189
- * Creates a screen capture tracks with getDisplayMedia().
190
- * A LocalVideoTrack is always created and returned.
191
- * If { audio: true }, and the browser supports audio capture, a LocalAudioTrack is also created.
192
- */
193
- export async function createLocalScreenTracks(
194
- options?: ScreenShareCaptureOptions,
195
- ): Promise<Array<LocalTrack>> {
196
- if (options === undefined) {
197
- options = {};
198
- }
199
- if (options.resolution === undefined && !isSafari17Based()) {
200
- options.resolution = ScreenSharePresets.h1080fps30.resolution;
201
- }
202
-
203
- if (navigator.mediaDevices.getDisplayMedia === undefined) {
204
- throw new DeviceUnsupportedError('getDisplayMedia not supported');
205
- }
206
-
207
- const constraints = screenCaptureToDisplayMediaStreamOptions(options);
208
- const stream: MediaStream = await navigator.mediaDevices.getDisplayMedia(constraints);
209
-
210
- const tracks = stream.getVideoTracks();
211
- if (tracks.length === 0) {
212
- throw new TrackInvalidError('no video track found');
213
- }
214
- const screenVideo = new LocalVideoTrack(tracks[0], undefined, false);
215
- screenVideo.source = Track.Source.ScreenShare;
216
- const localTracks: Array<LocalTrack> = [screenVideo];
217
- if (stream.getAudioTracks().length > 0) {
218
- const screenAudio = new LocalAudioTrack(stream.getAudioTracks()[0], undefined, false);
219
- screenAudio.source = Track.Source.ScreenShareAudio;
220
- localTracks.push(screenAudio);
221
- }
222
- return localTracks;
223
- }
@@ -66,10 +66,13 @@ export function facingModeFromLocalTrack(
66
66
  return result;
67
67
  }
68
68
 
69
- const knownDeviceLabels = new Map<string, FacingModeFromLocalTrackReturnValue>([
69
+ const knownDeviceLabels = /* @__PURE__ */ new Map<string, FacingModeFromLocalTrackReturnValue>([
70
70
  ['obs virtual camera', { facingMode: 'environment', confidence: 'medium' }],
71
71
  ]);
72
- const knownDeviceLabelSections = new Map<string, FacingModeFromLocalTrackReturnValue>([
72
+ const knownDeviceLabelSections = /* @__PURE__ */ new Map<
73
+ string,
74
+ FacingModeFromLocalTrackReturnValue
75
+ >([
73
76
  ['iphone', { facingMode: 'environment', confidence: 'medium' }],
74
77
  ['ipad', { facingMode: 'environment', confidence: 'medium' }],
75
78
  ]);