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
@@ -0,0 +1,78 @@
1
+ import { ChatMessage as ChatMessageModel, DataPacket, protoInt64 } from '@livekit/protocol';
2
+ import type { CoreRoom } from '../CoreRoom';
3
+ import { DataChannelKind } from '../data-channel/types';
4
+ import { ParticipantEvent, RoomEvent } from '../events';
5
+ import type {
6
+ DataPacketOwner,
7
+ ExtensionContext,
8
+ LocalParticipantApiProvider,
9
+ RoomExtension,
10
+ } from '../extensions';
11
+ import type { ChatMessage, SendTextOptions } from '../types';
12
+ import { extractChatMessage } from '../utils';
13
+
14
+ /**
15
+ * Methods the legacy `chat` extension adds to the local participant.
16
+ * @experimental
17
+ */
18
+ export interface ChatLocalParticipantApi {
19
+ /** @deprecated Consider migrating to {@link sendText} */
20
+ sendChatMessage(text: string, options?: SendTextOptions): Promise<ChatMessage>;
21
+
22
+ /** @deprecated Consider migrating to {@link sendText} */
23
+ editChatMessage(editText: string, originalMessage: ChatMessage): Promise<ChatMessage>;
24
+ }
25
+
26
+ /**
27
+ * The legacy chat message packets (`sendChatMessage`, `RoomEvent.ChatMessage`). Superseded by
28
+ * text streams; the full `Room` keeps it, the core entry does not offer it.
29
+ */
30
+ export const chat = {
31
+ key: /* @__PURE__ */ Symbol('lk.extension.chat'),
32
+ install(
33
+ room: CoreRoom,
34
+ _ctx: ExtensionContext,
35
+ ): LocalParticipantApiProvider<ChatLocalParticipantApi> & DataPacketOwner {
36
+ const participant = room.localParticipant;
37
+
38
+ participant.on(ParticipantEvent.ChatMessage, (msg) => {
39
+ room.emit(RoomEvent.ChatMessage, msg, participant);
40
+ });
41
+
42
+ const send = async (msg: ChatMessage) => {
43
+ const packet = new DataPacket({
44
+ value: {
45
+ case: 'chatMessage',
46
+ value: new ChatMessageModel({
47
+ ...msg,
48
+ timestamp: protoInt64.parse(msg.timestamp),
49
+ editTimestamp:
50
+ msg.editTimestamp !== undefined ? protoInt64.parse(msg.editTimestamp) : undefined,
51
+ }),
52
+ },
53
+ });
54
+ await room.engine.sendDataPacket(packet, DataChannelKind.RELIABLE);
55
+ participant.emit(ParticipantEvent.ChatMessage, msg);
56
+ return msg;
57
+ };
58
+
59
+ return {
60
+ dataPackets: {
61
+ chatMessage: (chatMessage, _packet, _encryptionType, sender) => {
62
+ room.emit(RoomEvent.ChatMessage, extractChatMessage(chatMessage), sender);
63
+ },
64
+ },
65
+ localParticipant: {
66
+ sendChatMessage: (text, options) =>
67
+ send({
68
+ id: crypto.randomUUID(),
69
+ message: text,
70
+ timestamp: Date.now(),
71
+ attachedFiles: options?.attachments,
72
+ }),
73
+ editChatMessage: (editText, originalMessage) =>
74
+ send({ ...originalMessage, message: editText, editTimestamp: Date.now() }),
75
+ },
76
+ };
77
+ },
78
+ } satisfies RoomExtension<{}, ChatLocalParticipantApi>;
@@ -0,0 +1,149 @@
1
+ import { describe, expect, it, vi } from 'vitest';
2
+ import type { BaseE2EEManager } from '../e2ee/E2eeManager';
3
+ import { ExternalE2EEKeyProvider } from '../e2ee/KeyProvider';
4
+ import { e2ee } from '../e2ee/extension';
5
+ import { frameMetadata } from '../frameMetadata/extension';
6
+ import { CoreRoom } from './CoreRoom';
7
+ import { Room } from './Room';
8
+ import { createRoom } from './createRoom';
9
+ import { dataStreams } from './data-stream/extension';
10
+ import { RoomEvent } from './events';
11
+ import { type ExtensionResult, defineExtension } from './extensions';
12
+ import { rpc } from './rpc/extension';
13
+
14
+ // E2EEManager refuses to construct where insertable streams are missing (jsdom)
15
+ vi.mock('../e2ee/utils', async (original) => ({
16
+ ...(await original<typeof import('../e2ee/utils')>()),
17
+ isE2EESupported: () => true,
18
+ }));
19
+
20
+ describe('createRoom', () => {
21
+ it('installs dependencies and keeps an explicitly listed instance', () => {
22
+ const room = createRoom(undefined, [rpc]);
23
+ expect(room).toBeInstanceOf(CoreRoom);
24
+ expect(typeof room.registerRpcMethod).toBe('function');
25
+ expect(typeof room.registerTextStreamHandler).toBe('function');
26
+ expect(typeof room.localParticipant.sendText).toBe('function');
27
+ // the deprecated participant rpc methods come with the full Room only
28
+ expect('registerRpcMethod' in room.localParticipant).toBe(false);
29
+ expect(() => createRoom(undefined, [dataStreams, dataStreams({})])).toThrow('listed twice');
30
+ });
31
+
32
+ it('dedupes a key that two dependency lists name with different instances', () => {
33
+ const a = defineExtension('shared', [], (): ExtensionResult => ({}));
34
+ const needsA = { key: Symbol('needsA'), requires: [a({})] as const, install: () => ({}) };
35
+ const needsAToo = { key: Symbol('needsAToo'), requires: [a({})] as const, install: () => ({}) };
36
+ expect(() => createRoom(undefined, [needsA, needsAToo])).not.toThrow();
37
+ });
38
+
39
+ it('lets a subclass override an extension method', () => {
40
+ class CustomRoom extends Room {
41
+ registerRpcMethod() {
42
+ return 'overridden' as unknown as void;
43
+ }
44
+ }
45
+ const room = new CustomRoom();
46
+ expect(room.registerRpcMethod('x', async () => '')).toBe('overridden');
47
+ expect(typeof room.unregisterRpcMethod).toBe('function');
48
+ });
49
+
50
+ it('evaluates an option function per room', () => {
51
+ let calls = 0;
52
+ const probe = defineExtension(
53
+ 'probe',
54
+ [],
55
+ (_room, _ctx, options: { n: number } | undefined): ExtensionResult<{ n(): number }> => ({
56
+ room: { n: () => options?.n ?? -1 },
57
+ }),
58
+ );
59
+ const perRoom = probe(() => ({ n: ++calls }));
60
+ expect(createRoom(undefined, [perRoom]).n()).toBe(1);
61
+ expect(createRoom(undefined, [perRoom]).n()).toBe(2);
62
+ expect(createRoom(undefined, [probe]).n()).toBe(-1);
63
+ });
64
+
65
+ it('configured frameMetadata reaches the engine, and dispose terminates the worker', async () => {
66
+ const worker = { postMessage() {}, terminate: vi.fn() } as unknown as Worker;
67
+ const room = createRoom(undefined, [frameMetadata({ worker })]);
68
+ expect(room.engine.frameMetadataOptions?.worker).toBe(worker);
69
+ expect(room.options.frameMetadata).toBeUndefined();
70
+ room.emit(RoomEvent.Disconnected);
71
+ expect(worker.terminate).not.toHaveBeenCalled();
72
+ await room.dispose();
73
+ expect(worker.terminate).toHaveBeenCalledTimes(1);
74
+ });
75
+
76
+ it('the full Room installs every extension', async () => {
77
+ const room = new Room();
78
+ expect(typeof room.registerRpcMethod).toBe('function');
79
+ expect(typeof room.localParticipant.sendChatMessage).toBe('function');
80
+ expect(typeof room.localParticipant.registerRpcMethod).toBe('function');
81
+ expect(typeof room.simulateParticipants).toBe('function');
82
+ await room.dispose();
83
+ await expect(room.connect('ws://localhost', 'token')).rejects.toThrow('disposed');
84
+ });
85
+ });
86
+
87
+ describe('e2ee dispose', () => {
88
+ const worker = () =>
89
+ ({ postMessage() {}, addEventListener() {}, terminate: vi.fn() }) as unknown as Worker;
90
+
91
+ it('terminates the worker the extension created a manager for', async () => {
92
+ const w = worker();
93
+ const room = createRoom(undefined, [
94
+ e2ee({ keyProvider: new ExternalE2EEKeyProvider(), worker: w }),
95
+ ]);
96
+ await room.dispose();
97
+ expect(w.terminate).toHaveBeenCalledTimes(1);
98
+ });
99
+
100
+ it('leaves an app-supplied manager alone', async () => {
101
+ // a BaseE2EEManager the app owns; it can serve more than one room
102
+ const manager = {
103
+ isEnabled: false,
104
+ isDataChannelEncryptionEnabled: false,
105
+ setup() {},
106
+ setupEngine() {},
107
+ setParticipantCryptorEnabled() {},
108
+ setSifTrailer() {},
109
+ encryptData: async () => ({}) as never,
110
+ handleEncryptedData: async () => ({}) as never,
111
+ on() {
112
+ return this;
113
+ },
114
+ off() {
115
+ return this;
116
+ },
117
+ dispose: vi.fn(),
118
+ } as unknown as BaseE2EEManager;
119
+ const room = createRoom(undefined, [e2ee({ e2eeManager: manager })]);
120
+ await room.dispose();
121
+ expect(manager.dispose).not.toHaveBeenCalled();
122
+ });
123
+
124
+ it('takes its listeners off an app-supplied manager on dispose', async () => {
125
+ const listeners = new Map<string, Set<unknown>>();
126
+ const manager = {
127
+ isEnabled: false,
128
+ isDataChannelEncryptionEnabled: false,
129
+ setup() {},
130
+ setupEngine() {},
131
+ setParticipantCryptorEnabled() {},
132
+ setSifTrailer() {},
133
+ encryptData: async () => ({}) as never,
134
+ handleEncryptedData: async () => ({}) as never,
135
+ on(event: string, cb: unknown) {
136
+ listeners.set(event, (listeners.get(event) ?? new Set()).add(cb));
137
+ return this;
138
+ },
139
+ off(event: string, cb: unknown) {
140
+ listeners.get(event)?.delete(cb);
141
+ return this;
142
+ },
143
+ } as unknown as BaseE2EEManager;
144
+ const room = createRoom(undefined, [e2ee({ e2eeManager: manager })]);
145
+ expect([...listeners.values()].reduce((n, s) => n + s.size, 0)).toBe(2);
146
+ await room.dispose();
147
+ expect([...listeners.values()].reduce((n, s) => n + s.size, 0)).toBe(0);
148
+ });
149
+ });
@@ -0,0 +1,26 @@
1
+ import type { CoreRoomOptions } from '../options';
2
+ import { CoreRoom } from './CoreRoom';
3
+ import { type ExtensionApis, type RoomExtension, installExtensions } from './extensions';
4
+
5
+ /**
6
+ * Creates a light room with exactly the given extensions. Dependencies install on their own
7
+ * (`rpc` brings `dataStreams`); an extension you list, configured or not, wins over the default a
8
+ * dependency would pull in. The result carries the extension methods under the names the full
9
+ * `Room` uses, so code moves between the two builds unchanged.
10
+ *
11
+ * @example
12
+ * ```typescript
13
+ * const room = createRoom({ adaptiveStream: true }, [rpc, e2ee({ keyProvider, worker })]);
14
+ * room.registerRpcMethod('greet', handler);
15
+ * await room.connect(url, token);
16
+ * ```
17
+ * @experimental
18
+ */
19
+ export function createRoom<const E extends readonly RoomExtension<any, any>[] = []>(
20
+ options?: CoreRoomOptions,
21
+ extensions?: E,
22
+ ): CoreRoom & ExtensionApis<E[number]> {
23
+ const room = new CoreRoom(options);
24
+ installExtensions(room, extensions ?? []);
25
+ return room as CoreRoom & ExtensionApis<E[number]>;
26
+ }
@@ -1,3 +1,4 @@
1
+ import { NegotiatedDataChannelID } from '@livekit/protocol';
1
2
  import { describe, expect, it, vi } from 'vitest';
2
3
  import type { PCTransportManager } from '../PCTransportManager';
3
4
  import { UnexpectedConnectionState } from '../errors';
@@ -17,15 +18,22 @@ class FakeDataChannel extends EventTarget {
17
18
 
18
19
  onbufferedamountlow: (() => void) | null = null;
19
20
 
21
+ readyState: RTCDataChannelState = 'open';
22
+
20
23
  send = vi.fn();
21
24
 
22
- close = vi.fn();
25
+ close = vi.fn(() => {
26
+ this.readyState = 'closing';
27
+ });
23
28
 
24
29
  constructor(public label: string) {
25
30
  super();
26
31
  }
27
32
  }
28
33
 
34
+ const reliableHandle = (manager: DataChannelManager) =>
35
+ manager.getHandle(DataChannelKind.RELIABLE) as RTCDataChannel;
36
+
29
37
  const tick = () => new Promise<void>((resolve) => setTimeout(resolve, 0));
30
38
 
31
39
  function makeManager(overrides?: Partial<DataChannelManagerOptions>) {
@@ -89,22 +97,68 @@ describe('DataChannelManager', () => {
89
97
  manager.lossy.stopThresholdTuning();
90
98
  });
91
99
 
92
- it('recreating channels rejects waiters parked on the replaced handles', async () => {
93
- const { manager, pcManager, created } = makeManager();
100
+ it('recreating channels closes the replaced handles and rejects waiters parked on them', async () => {
101
+ const { manager, opts, pcManager, created } = makeManager();
94
102
  manager.createPublisherChannels(pcManager);
103
+ const firstGeneration = { ...created };
95
104
 
96
105
  // Park a reliable sender on the first-generation channel.
97
106
  created._reliable.bufferedAmount = 2 * 1024 * 1024;
98
- const parked = manager.reliable.waitForHeadroomWithLock();
107
+ const parked = manager.reliable.waitForHeadroomWithLock(reliableHandle(manager));
99
108
  parked.catch(() => {});
100
109
  await tick();
101
110
 
102
- // Safari null-id path: channels recreated without closing the old ones.
111
+ // Safari null-id path: channels recreated while the old ones are still open.
103
112
  manager.createPublisherChannels(pcManager);
104
113
 
105
114
  await expect(parked).rejects.toBeInstanceOf(UnexpectedConnectionState);
115
+ for (const dc of Object.values(firstGeneration)) {
116
+ expect(dc.close).toHaveBeenCalled();
117
+ // Unhooked before closing, so the deliberate close isn't reported as an unexpected one.
118
+ expect(dc.onclose).toBeNull();
119
+ expect(dc.onbufferedamountlow).toBeNull();
120
+ }
121
+ expect(opts.onChannelClose).not.toHaveBeenCalled();
106
122
  // The gate recovers against the fresh (empty) channel.
107
- await expect(manager.reliable.waitForHeadroomWithLock()).resolves.toBeUndefined();
123
+ await expect(
124
+ manager.reliable.waitForHeadroomWithLock(reliableHandle(manager)),
125
+ ).resolves.toBeUndefined();
126
+
127
+ manager.lossy.stopThresholdTuning();
128
+ });
129
+
130
+ it('creates negotiated channels with fixed ids and can fall back to in-band ones', () => {
131
+ const { manager, pcManager } = makeManager();
132
+ const createSpy = vi.mocked(pcManager.createPublisherDataChannel);
133
+
134
+ manager.createPublisherChannels(pcManager, true);
135
+
136
+ expect(manager.publisherChannelsNegotiated).toBe(true);
137
+ expect(createSpy).toHaveBeenCalledWith('_reliable', {
138
+ ordered: true,
139
+ negotiated: true,
140
+ id: NegotiatedDataChannelID.NDCI_RELIABLE,
141
+ });
142
+ expect(createSpy).toHaveBeenCalledWith('_lossy', {
143
+ ordered: false,
144
+ maxRetransmits: 0,
145
+ negotiated: true,
146
+ id: NegotiatedDataChannelID.NDCI_LOSSY,
147
+ });
148
+ expect(createSpy).toHaveBeenCalledWith('_data_track', {
149
+ ordered: false,
150
+ maxRetransmits: 0,
151
+ negotiated: true,
152
+ id: NegotiatedDataChannelID.NDCI_DATA_TRACK,
153
+ });
154
+
155
+ createSpy.mockClear();
156
+ manager.createPublisherChannels(pcManager, false);
157
+
158
+ expect(manager.publisherChannelsNegotiated).toBe(false);
159
+ expect(createSpy).toHaveBeenCalledWith('_reliable', { ordered: true });
160
+ manager.teardown();
161
+ expect(manager.publisherChannelsNegotiated).toBe(false);
108
162
 
109
163
  manager.lossy.stopThresholdTuning();
110
164
  });
@@ -133,7 +187,7 @@ describe('DataChannelManager', () => {
133
187
  manager.adoptSubscriberChannel(sub as unknown as RTCDataChannel);
134
188
 
135
189
  created._reliable.bufferedAmount = 2 * 1024 * 1024;
136
- const parked = manager.reliable.waitForHeadroomWithLock();
190
+ const parked = manager.reliable.waitForHeadroomWithLock(reliableHandle(manager));
137
191
  parked.catch(() => {});
138
192
  await tick();
139
193
 
@@ -1,3 +1,4 @@
1
+ import { NegotiatedDataChannelID } from '@livekit/protocol';
1
2
  import type { PCTransportManager } from '../PCTransportManager';
2
3
  import { FlowControlledDataChannel } from './FlowControlledDataChannel';
3
4
  import { LossyDataChannel } from './LossyDataChannel';
@@ -24,13 +25,24 @@ export interface DataChannelManagerOptions {
24
25
  onBufferStatusChanged: (kind: DataChannelKind, isLow: boolean) => void;
25
26
  }
26
27
 
28
+ /** Unhooks every handler the manager may have wired onto `dc`, ahead of closing it. */
29
+ function clearHandlers(dc: RTCDataChannel) {
30
+ dc.onbufferedamountlow = null;
31
+ dc.onclose = null;
32
+ dc.onclosing = null;
33
+ dc.onerror = null;
34
+ dc.onmessage = null;
35
+ dc.onopen = null;
36
+ }
37
+
27
38
  /**
28
39
  * Owns the engine's data channels: the three flow-controlled publisher channel wrappers (which
29
40
  * live for the engine's lifetime and have RTCDataChannel handles attached/detached as peer
30
41
  * connections come and go) plus the subscriber-side receive handles adopted by label.
31
42
  *
32
- * Handle turnover goes through {@link FlowControlledDataChannel.attach}/`detach`, which reject
33
- * parked headroom waiters as a built-in — there is no separate invalidation step to forget.
43
+ * Handle turnover goes through {@link FlowControlledDataChannel.attach}/`detach`, which close the
44
+ * released handle and reject parked headroom waiters as a built-in — there is no separate
45
+ * invalidation step to forget.
34
46
  */
35
47
  export class DataChannelManager {
36
48
  readonly reliable: ReliableDataChannel;
@@ -47,6 +59,8 @@ export class DataChannelManager {
47
59
 
48
60
  private opts: DataChannelManagerOptions;
49
61
 
62
+ private negotiated = false;
63
+
50
64
  constructor(opts: DataChannelManagerOptions) {
51
65
  this.opts = opts;
52
66
  const flowControlOptions = (kind: DataChannelKind) => ({
@@ -108,19 +122,27 @@ export class DataChannelManager {
108
122
  );
109
123
  }
110
124
 
125
+ /** Whether the current publisher channels were created as negotiated (fixed IDs). */
126
+ get publisherChannelsNegotiated(): boolean {
127
+ return this.hasPublisherChannels && this.negotiated;
128
+ }
129
+
111
130
  /**
112
131
  * Creates the three publisher data channels on the given transport, wires their handlers, and
113
- * attaches them to the wrappers — attaching rejects any waiters still parked on replaced
114
- * channel objects.
132
+ * attaches them to the wrappers — attaching closes any replaced channel objects and rejects the
133
+ * waiters still parked on them.
134
+ *
135
+ * With `negotiated`, the channels use fixed SCTP stream IDs agreed with the server instead of
136
+ * the in-band DCEP open handshake, so the server can send on them right away.
115
137
  */
116
- createPublisherChannels(pcManager: PCTransportManager) {
117
- // clear old data channel callbacks if recreate
138
+ createPublisherChannels(pcManager: PCTransportManager, negotiated: boolean = false) {
139
+ // Recreating (the Safari null-id path, or the in-band fallback after join): attaching the new
140
+ // handles below closes the old ones, so unhook them first — the old channel's close must not
141
+ // report an unexpected close.
118
142
  for (const channel of [this.lossy, this.reliable, this.dataTrack]) {
119
143
  const old = channel.channelHandle;
120
144
  if (old) {
121
- old.onmessage = null;
122
- old.onerror = null;
123
- old.onclose = null;
145
+ clearHandlers(old);
124
146
  }
125
147
  }
126
148
 
@@ -142,11 +164,14 @@ export class DataChannelManager {
142
164
  channel.attach(dc);
143
165
  };
144
166
 
167
+ const idFor = (id: number) => (negotiated ? { negotiated, id } : {});
168
+
145
169
  wire(
146
170
  this.lossy,
147
171
  pcManager.createPublisherDataChannel(lossyDataChannelLabel, {
148
172
  ordered: false,
149
173
  maxRetransmits: 0,
174
+ ...idFor(NegotiatedDataChannelID.NDCI_LOSSY),
150
175
  }),
151
176
  this.opts.onDataMessage,
152
177
  );
@@ -154,6 +179,7 @@ export class DataChannelManager {
154
179
  this.reliable,
155
180
  pcManager.createPublisherDataChannel(reliableDataChannelLabel, {
156
181
  ordered: true,
182
+ ...idFor(NegotiatedDataChannelID.NDCI_RELIABLE),
157
183
  }),
158
184
  this.opts.onDataMessage,
159
185
  );
@@ -162,9 +188,11 @@ export class DataChannelManager {
162
188
  pcManager.createPublisherDataChannel(dataTrackDataChannelLabel, {
163
189
  ordered: false,
164
190
  maxRetransmits: 0,
191
+ ...idFor(NegotiatedDataChannelID.NDCI_DATA_TRACK),
165
192
  }),
166
193
  this.opts.onDataTrackMessage,
167
194
  );
195
+ this.negotiated = negotiated;
168
196
 
169
197
  this.lossy.startThresholdTuning();
170
198
  }
@@ -192,41 +220,36 @@ export class DataChannelManager {
192
220
  }
193
221
 
194
222
  /**
195
- * Tears down all channels for a peer-connection cleanup: rejects parked waiters (detach — the
196
- * spec allows `pc.close()` to transition channels to 'closed' without firing events, so waiting
197
- * for browser close events is not an option), strips handlers, closes the handles, and resets
198
- * the reliable session state.
223
+ * Tears down all channels for a peer-connection cleanup: strips handlers, closes the handles,
224
+ * and resets the reliable session state. Detaching the publisher handles closes them and
225
+ * rejects parked waiters (the spec allows `pc.close()` to transition channels to 'closed'
226
+ * without firing events, so waiting for browser close events is not an option).
199
227
  */
200
228
  teardown() {
201
- const dcCleanup = (dc: RTCDataChannel | undefined) => {
202
- if (!dc) {
203
- return;
204
- }
229
+ // Detach the data channel handlers before closing anything. Closing a peer connection tears
230
+ // down the SCTP transport, which can dispatch `error`/`close` events on the still-open data
231
+ // channels; if our handlers are still attached at that point, handleDataError logs a spurious
232
+ // "Unknown DataChannel error" during an otherwise graceful disconnect. Removing the handlers
233
+ // before dc.close()/pcManager.close() makes this deterministic regardless of how/when the
234
+ // browser dispatches those teardown events. See livekit/client-sdk-js#1953.
235
+ const publisherDataChannels = [this.lossy, this.reliable, this.dataTrack];
236
+ const subscriberDataChannels = [this.lossySub, this.reliableSub, this.dataTrackSub];
205
237
 
206
- // Detach the data channel handlers before closing anything. Closing a peer connection tears
207
- // down the SCTP transport, which can dispatch `error`/`close` events on the still-open data
208
- // channels; if our handlers are still attached at that point, handleDataError logs a spurious
209
- // "Unknown DataChannel error" during an otherwise graceful disconnect. Removing the handlers
210
- // before dc.close()/pcManager.close() makes this deterministic regardless of how/when the
211
- // browser dispatches those teardown events. See livekit/client-sdk-js#1953.
212
- dc.onbufferedamountlow = null;
213
- dc.onclose = null;
214
- dc.onclosing = null;
215
- dc.onerror = null;
216
- dc.onmessage = null;
217
- dc.onopen = null;
218
-
219
- dc.close();
220
- };
221
-
222
- for (const channel of [this.lossy, this.reliable, this.dataTrack]) {
238
+ // Publisher handles are closed by detach, which also rejects parked waiters.
239
+ for (const channel of publisherDataChannels) {
223
240
  const dc = channel.channelHandle;
241
+ if (dc) {
242
+ clearHandlers(dc);
243
+ }
224
244
  channel.detach('peer connections cleaned up');
225
- dcCleanup(dc);
226
245
  }
227
- dcCleanup(this.lossySub);
228
- dcCleanup(this.reliableSub);
229
- dcCleanup(this.dataTrackSub);
246
+ // Subscriber handles have no wrapper, so close them directly.
247
+ for (const dc of subscriberDataChannels) {
248
+ if (dc) {
249
+ clearHandlers(dc);
250
+ dc.close();
251
+ }
252
+ }
230
253
  this.lossySub = undefined;
231
254
  this.reliableSub = undefined;
232
255
  this.dataTrackSub = undefined;