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
@@ -0,0 +1,99 @@
1
+ import {__awaiter}from'tslib';import livekitLogger from'../../logger.mjs';import CriticalTimers from'../timers.mjs';import {FlowControlledDataChannel}from'./FlowControlledDataChannel.mjs';/**
2
+ * A lossy channel: flow control plus a per-instance full-buffer policy.
3
+ *
4
+ * Each instance owns its own byterate stat, drop counter, and (when tuning is started) the
5
+ * dynamic `bufferedAmountLowThreshold` adjustment that keeps the drop gate at roughly 100ms of
6
+ * buffered latency. Keeping these per instance is what prevents one channel's traffic from
7
+ * steering another channel's policy.
8
+ */
9
+ class LossyDataChannel extends FlowControlledDataChannel {
10
+ constructor(opts) {
11
+ super(opts);
12
+ this.statCurrentBytes = 0;
13
+ this.statByterate = 0;
14
+ this.dropCount = 0;
15
+ this.bufferFullBehavior = opts.bufferFullBehavior;
16
+ this.shouldSkipSends = opts.shouldSkipSends;
17
+ }
18
+ /** Sends prepared bytes with this channel's full-buffer policy (drop or wait). */
19
+ send(msg) {
20
+ return __awaiter(this, void 0, void 0, function* () {
21
+ const dc = this.getChannel();
22
+ if (!dc) {
23
+ return;
24
+ }
25
+ // Depending on the channel's policy, either drop or wait for the buffer to drain below the
26
+ // high-water mark before continuing.
27
+ switch (this.bufferFullBehavior) {
28
+ case 'wait':
29
+ if (!this.isBelowHighWaterMark(dc)) {
30
+ try {
31
+ yield this.waitForHeadroomWithLock(dc);
32
+ } catch (error) {
33
+ if (this.isEngineClosed()) {
34
+ throw error;
35
+ }
36
+ // The channel closed or was replaced while this send waited. The replacement may
37
+ // still be connecting, so drop the packet, as sends during a reconnect are.
38
+ return;
39
+ }
40
+ }
41
+ break;
42
+ case 'drop':
43
+ // We check against the actual threshold on the DC here, as it is tuned dynamically.
44
+ if (!this.isBelowLowWaterMark(dc)) {
45
+ // Drop messages to reduce latency
46
+ this.dropCount += 1;
47
+ if (this.dropCount % 100 === 0) {
48
+ livekitLogger.warn("dropping lossy data channel messages, total dropped: ".concat(this.dropCount));
49
+ }
50
+ return;
51
+ }
52
+ }
53
+ this.statCurrentBytes += msg.byteLength;
54
+ if (this.shouldSkipSends()) {
55
+ return;
56
+ }
57
+ try {
58
+ dc.send(msg);
59
+ this.refreshBufferStatus();
60
+ } catch (error) {
61
+ // Preserve prior surface behaviour: a send that fails because the channel is closing is
62
+ // logged, not thrown, so lossy/data-track sends don't reject during teardown windows.
63
+ if (error instanceof TypeError) {
64
+ livekitLogger.error(error);
65
+ } else {
66
+ throw error;
67
+ }
68
+ }
69
+ });
70
+ }
71
+ /**
72
+ * Starts the once-per-second adjustment of the channel's `bufferedAmountLowThreshold` to the
73
+ * observed byterate, keeping the drop gate at roughly 100ms of buffered latency (clamped to
74
+ * the watermarks). Restarts cleanly if already running.
75
+ */
76
+ startThresholdTuning() {
77
+ this.stopThresholdTuning();
78
+ this.statInterval = CriticalTimers.setInterval(() => {
79
+ this.statByterate = this.statCurrentBytes;
80
+ this.statCurrentBytes = 0;
81
+ const dc = this.getChannel();
82
+ if (dc) {
83
+ // control buffered latency to ~100ms
84
+ const threshold = this.statByterate / 10;
85
+ dc.bufferedAmountLowThreshold = Math.min(Math.max(threshold, this.lowWaterMark), this.highWaterMark);
86
+ }
87
+ }, 1000);
88
+ }
89
+ /** Stops the threshold tuning and resets the stats and drop counter. */
90
+ stopThresholdTuning() {
91
+ this.statByterate = 0;
92
+ this.statCurrentBytes = 0;
93
+ if (this.statInterval) {
94
+ CriticalTimers.clearInterval(this.statInterval);
95
+ this.statInterval = undefined;
96
+ }
97
+ this.dropCount = 0;
98
+ }
99
+ }export{LossyDataChannel};//# sourceMappingURL=LossyDataChannel.mjs.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"LossyDataChannel.mjs","sources":["../../../../src/room/data-channel/LossyDataChannel.ts"],"sourcesContent":["import log from '../../logger';\nimport type { NonSharedUint8Array } from '../../type-polyfills/non-shared-typed-arrays';\nimport CriticalTimers from '../timers';\nimport {\n FlowControlledDataChannel,\n type FlowControlledDataChannelOptions,\n} from './FlowControlledDataChannel';\n\nexport interface LossyDataChannelOptions extends FlowControlledDataChannelOptions {\n /**\n * What to do with a send while the buffer is full: `drop` discards it to keep latency bounded\n * (the classic lossy channel), `wait` backpressures the producer until there is headroom (the\n * data-track channel, whose producer decides what to skip at frame granularity).\n */\n bufferFullBehavior: 'drop' | 'wait';\n /** Sends are silently discarded while this is true (a reconnect attempt is underway). */\n shouldSkipSends: () => boolean;\n}\n\n/**\n * A lossy channel: flow control plus a per-instance full-buffer policy.\n *\n * Each instance owns its own byterate stat, drop counter, and (when tuning is started) the\n * dynamic `bufferedAmountLowThreshold` adjustment that keeps the drop gate at roughly 100ms of\n * buffered latency. Keeping these per instance is what prevents one channel's traffic from\n * steering another channel's policy.\n */\nexport class LossyDataChannel extends FlowControlledDataChannel {\n private bufferFullBehavior: 'drop' | 'wait';\n\n private shouldSkipSends: () => boolean;\n\n private statCurrentBytes = 0;\n\n private statByterate = 0;\n\n private statInterval: ReturnType<typeof setInterval> | undefined;\n\n private dropCount = 0;\n\n constructor(opts: LossyDataChannelOptions) {\n super(opts);\n this.bufferFullBehavior = opts.bufferFullBehavior;\n this.shouldSkipSends = opts.shouldSkipSends;\n }\n\n /** Sends prepared bytes with this channel's full-buffer policy (drop or wait). */\n async send(msg: NonSharedUint8Array) {\n const dc = this.getChannel();\n if (!dc) {\n return;\n }\n // Depending on the channel's policy, either drop or wait for the buffer to drain below the\n // high-water mark before continuing.\n switch (this.bufferFullBehavior) {\n case 'wait':\n if (!this.isBelowHighWaterMark(dc)) {\n try {\n await this.waitForHeadroomWithLock(dc);\n } catch (error) {\n if (this.isEngineClosed()) {\n throw error;\n }\n // The channel closed or was replaced while this send waited. The replacement may\n // still be connecting, so drop the packet, as sends during a reconnect are.\n return;\n }\n }\n break;\n case 'drop':\n // We check against the actual threshold on the DC here, as it is tuned dynamically.\n if (!this.isBelowLowWaterMark(dc)) {\n // Drop messages to reduce latency\n this.dropCount += 1;\n if (this.dropCount % 100 === 0) {\n log.warn(`dropping lossy data channel messages, total dropped: ${this.dropCount}`);\n }\n return;\n }\n }\n this.statCurrentBytes += msg.byteLength;\n\n if (this.shouldSkipSends()) {\n return;\n }\n\n try {\n dc.send(msg);\n this.refreshBufferStatus();\n } catch (error: unknown) {\n // Preserve prior surface behaviour: a send that fails because the channel is closing is\n // logged, not thrown, so lossy/data-track sends don't reject during teardown windows.\n if (error instanceof TypeError) {\n log.error(error);\n } else {\n throw error;\n }\n }\n }\n\n /**\n * Starts the once-per-second adjustment of the channel's `bufferedAmountLowThreshold` to the\n * observed byterate, keeping the drop gate at roughly 100ms of buffered latency (clamped to\n * the watermarks). Restarts cleanly if already running.\n */\n startThresholdTuning() {\n this.stopThresholdTuning();\n this.statInterval = CriticalTimers.setInterval(() => {\n this.statByterate = this.statCurrentBytes;\n this.statCurrentBytes = 0;\n\n const dc = this.getChannel();\n if (dc) {\n // control buffered latency to ~100ms\n const threshold = this.statByterate / 10;\n dc.bufferedAmountLowThreshold = Math.min(\n Math.max(threshold, this.lowWaterMark),\n this.highWaterMark,\n );\n }\n }, 1000);\n }\n\n /** Stops the threshold tuning and resets the stats and drop counter. */\n stopThresholdTuning() {\n this.statByterate = 0;\n this.statCurrentBytes = 0;\n if (this.statInterval) {\n CriticalTimers.clearInterval(this.statInterval);\n this.statInterval = undefined;\n }\n this.dropCount = 0;\n }\n}\n"],"names":["LossyDataChannel","FlowControlledDataChannel","constructor","opts","statCurrentBytes","statByterate","dropCount","bufferFullBehavior","shouldSkipSends","send","msg","dc","getChannel","isBelowHighWaterMark","waitForHeadroomWithLock","error","isEngineClosed","isBelowLowWaterMark","log","warn","concat","byteLength","refreshBufferStatus","TypeError","startThresholdTuning","stopThresholdTuning","statInterval","CriticalTimers","setInterval","threshold","bufferedAmountLowThreshold","Math","min","max","lowWaterMark","highWaterMark","clearInterval","undefined"],"mappings":"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"}
@@ -0,0 +1,150 @@
1
+ import {__awaiter}from'tslib';import {DataPacketBuffer}from'../../utils/dataPacketBuffer.mjs';import {UnexpectedConnectionState}from'../errors.mjs';import {FlowControlledDataChannel}from'./FlowControlledDataChannel.mjs';/**
2
+ * The reliable channel: flow control plus delivery-across-resume semantics.
3
+ *
4
+ * Every packet gets a monotonic sequence (stamped into the protobuf by the caller before
5
+ * serialization, via {@link nextSequence}) and is retained in a replay buffer until the channel's
6
+ * `bufferedAmount` confirms it has been handed to the transport. Sends that land in a reconnect
7
+ * window — or whose headroom wait is torn down transiently — are queued unsent and resolve;
8
+ * {@link replay} delivers them (plus any unacked packets) after a resume. Only an engine close
9
+ * rejects, because no replay is coming after that.
10
+ */
11
+ class ReliableDataChannel extends FlowControlledDataChannel {
12
+ constructor(opts) {
13
+ super(opts);
14
+ this.messageBuffer = new DataPacketBuffer();
15
+ this.sequence = 1;
16
+ this.isDeferringSends = opts.isDeferringSends;
17
+ }
18
+ /**
19
+ * Claims the next packet sequence. The caller stamps it into the packet before serialization,
20
+ * then passes it back to {@link send} so the replay buffer stays keyed by wire sequence.
21
+ */
22
+ nextSequence() {
23
+ const sequence = this.sequence;
24
+ this.sequence += 1;
25
+ return sequence;
26
+ }
27
+ /**
28
+ * Sends prepared bytes with reliable semantics. Resolves once the packet has either been handed
29
+ * to the channel or queued for the resume replay; throws only when the engine is closed.
30
+ */
31
+ send(msg, sequence) {
32
+ return __awaiter(this, void 0, void 0, function* () {
33
+ if (this.isDeferringSends()) {
34
+ // A reconnect is already underway — queue for the resume replay instead of parking on a
35
+ // channel that is being torn down. The send resolves; delivery is deferred to the replay.
36
+ this.messageBuffer.push({
37
+ data: msg,
38
+ sequence,
39
+ sent: false
40
+ });
41
+ return;
42
+ }
43
+ const dc = this.getChannel();
44
+ if (!dc) {
45
+ return;
46
+ }
47
+ try {
48
+ yield this.waitForHeadroomWithLock(dc);
49
+ } catch (error) {
50
+ if (this.isEngineClosed()) {
51
+ // No replay is coming after an engine close — surface the failure.
52
+ throw error;
53
+ }
54
+ // Transient teardown (the channel closed or was replaced while we waited): the reliable
55
+ // channel promises delivery across resume, so queue the packet for the replay instead of
56
+ // rejecting a send the app can't meaningfully retry. This also keeps the order: a send
57
+ // queued behind one aborted by a replacement fails the same way (the old handle is closed),
58
+ // so it can't reach the replacement ahead of the lower sequence the replay will deliver.
59
+ this.messageBuffer.push({
60
+ data: msg,
61
+ sequence,
62
+ sent: false
63
+ });
64
+ return;
65
+ }
66
+ if (this.isDeferringSends()) {
67
+ // A reconnect began while we waited for headroom — same deal as above.
68
+ this.messageBuffer.push({
69
+ data: msg,
70
+ sequence,
71
+ sent: false
72
+ });
73
+ return;
74
+ }
75
+ this.messageBuffer.push({
76
+ data: msg,
77
+ sequence,
78
+ sent: true
79
+ });
80
+ dc.send(msg);
81
+ this.refreshBufferStatus();
82
+ });
83
+ }
84
+ /**
85
+ * Replays the buffered backlog after a resume: drops everything the server acked
86
+ * (`lastMessageSeq`), then re-sends the rest in order. The headroom lock is held across the
87
+ * whole replay — releasing it between messages would let a concurrent send (whose newer
88
+ * sequence was already assigned before it queued on the lock) hit the wire mid-replay, and
89
+ * receivers would then discard the remaining lower-sequence resent messages as duplicates.
90
+ */
91
+ replay(lastMessageSeq) {
92
+ return __awaiter(this, void 0, void 0, function* () {
93
+ if (!this.getChannel()) {
94
+ return;
95
+ }
96
+ this.messageBuffer.popToSequence(lastMessageSeq);
97
+ const unlock = yield this.lockHeadroom();
98
+ try {
99
+ // Resolved only once the lock is held: the handle can be replaced while the replay waits
100
+ // for it.
101
+ const dc = this.getChannel();
102
+ if (!dc) {
103
+ throw new UnexpectedConnectionState("DataChannel not found, kind: ".concat(this.kind));
104
+ }
105
+ // Everything left after the ack cutoff must be re-handed to the current channel.
106
+ this.messageBuffer.markAllUnsent();
107
+ // Drain in passes, re-scanning the live buffer each time: a send that arrives (deferred,
108
+ // sent:false) during our own awaits appends after this pass started, so we pick it up on
109
+ // the next one. Mark each packet only once we've actually handed it to the channel — a
110
+ // blanket "mark all sent" would flip such a late arrival to sent without transmitting it,
111
+ // and a later alignBufferedAmount would then drop it for good. If the loop throws
112
+ // mid-drain, unsent entries keep their flag and the next replay picks them up.
113
+ for (let batch = this.messageBuffer.getUnsent(); batch.length > 0; batch = this.messageBuffer.getUnsent()) {
114
+ for (const item of batch) {
115
+ // Respect flow control on resume too, so a large resend doesn't overflow the buffer.
116
+ // Against the handle resolved under the lock: if it is replaced mid-replay (another
117
+ // resume), it has been closed, so this throws and that resume's replay picks up the
118
+ // entries still flagged unsent.
119
+ yield this.waitForHeadroomWithoutLock(dc);
120
+ dc.send(item.data);
121
+ this.messageBuffer.markSent(item);
122
+ }
123
+ }
124
+ } finally {
125
+ unlock();
126
+ }
127
+ this.refreshBufferStatus();
128
+ });
129
+ }
130
+ /**
131
+ * Before recomputing status, trim packets the transport has now delivered — a send or a drain
132
+ * may have acked buffered packets, and the replay buffer is keyed off the channel's buffered
133
+ * bytes.
134
+ */
135
+ refreshBufferStatus() {
136
+ const dc = this.channelHandle;
137
+ if (dc) {
138
+ this.messageBuffer.alignBufferedAmount(dc.bufferedAmount);
139
+ }
140
+ super.refreshBufferStatus();
141
+ }
142
+ /**
143
+ * Drops all replay state and restarts sequencing. Only valid on a full reconnect, where the
144
+ * session (and the receivers' sequence tracking) starts over.
145
+ */
146
+ reset() {
147
+ this.messageBuffer = new DataPacketBuffer();
148
+ this.sequence = 1;
149
+ }
150
+ }export{ReliableDataChannel};//# sourceMappingURL=ReliableDataChannel.mjs.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"ReliableDataChannel.mjs","sources":["../../../../src/room/data-channel/ReliableDataChannel.ts"],"sourcesContent":["import type { NonSharedUint8Array } from '../../type-polyfills/non-shared-typed-arrays';\nimport { DataPacketBuffer } from '../../utils/dataPacketBuffer';\nimport { UnexpectedConnectionState } from '../errors';\nimport {\n FlowControlledDataChannel,\n type FlowControlledDataChannelOptions,\n} from './FlowControlledDataChannel';\n\nexport interface ReliableDataChannelOptions extends FlowControlledDataChannelOptions {\n /**\n * Whether sends should currently be deferred to the resume replay instead of hitting the wire\n * (i.e. a reconnect attempt is underway). Read at send time so the reliable channel matches the\n * engine's reconnect state without owning it.\n */\n isDeferringSends: () => boolean;\n}\n\n/**\n * The reliable channel: flow control plus delivery-across-resume semantics.\n *\n * Every packet gets a monotonic sequence (stamped into the protobuf by the caller before\n * serialization, via {@link nextSequence}) and is retained in a replay buffer until the channel's\n * `bufferedAmount` confirms it has been handed to the transport. Sends that land in a reconnect\n * window — or whose headroom wait is torn down transiently — are queued unsent and resolve;\n * {@link replay} delivers them (plus any unacked packets) after a resume. Only an engine close\n * rejects, because no replay is coming after that.\n */\nexport class ReliableDataChannel extends FlowControlledDataChannel {\n private messageBuffer = new DataPacketBuffer();\n\n private sequence = 1;\n\n private isDeferringSends: () => boolean;\n\n constructor(opts: ReliableDataChannelOptions) {\n super(opts);\n this.isDeferringSends = opts.isDeferringSends;\n }\n\n /**\n * Claims the next packet sequence. The caller stamps it into the packet before serialization,\n * then passes it back to {@link send} so the replay buffer stays keyed by wire sequence.\n */\n nextSequence(): number {\n const sequence = this.sequence;\n this.sequence += 1;\n return sequence;\n }\n\n /**\n * Sends prepared bytes with reliable semantics. Resolves once the packet has either been handed\n * to the channel or queued for the resume replay; throws only when the engine is closed.\n */\n async send(msg: NonSharedUint8Array, sequence: number) {\n if (this.isDeferringSends()) {\n // A reconnect is already underway — queue for the resume replay instead of parking on a\n // channel that is being torn down. The send resolves; delivery is deferred to the replay.\n this.messageBuffer.push({ data: msg, sequence, sent: false });\n return;\n }\n\n const dc = this.getChannel();\n if (!dc) {\n return;\n }\n\n try {\n await this.waitForHeadroomWithLock(dc);\n } catch (error) {\n if (this.isEngineClosed()) {\n // No replay is coming after an engine close — surface the failure.\n throw error;\n }\n // Transient teardown (the channel closed or was replaced while we waited): the reliable\n // channel promises delivery across resume, so queue the packet for the replay instead of\n // rejecting a send the app can't meaningfully retry. This also keeps the order: a send\n // queued behind one aborted by a replacement fails the same way (the old handle is closed),\n // so it can't reach the replacement ahead of the lower sequence the replay will deliver.\n this.messageBuffer.push({ data: msg, sequence, sent: false });\n return;\n }\n\n if (this.isDeferringSends()) {\n // A reconnect began while we waited for headroom — same deal as above.\n this.messageBuffer.push({ data: msg, sequence, sent: false });\n return;\n }\n\n this.messageBuffer.push({ data: msg, sequence, sent: true });\n dc.send(msg);\n this.refreshBufferStatus();\n }\n\n /**\n * Replays the buffered backlog after a resume: drops everything the server acked\n * (`lastMessageSeq`), then re-sends the rest in order. The headroom lock is held across the\n * whole replay — releasing it between messages would let a concurrent send (whose newer\n * sequence was already assigned before it queued on the lock) hit the wire mid-replay, and\n * receivers would then discard the remaining lower-sequence resent messages as duplicates.\n */\n async replay(lastMessageSeq: number) {\n if (!this.getChannel()) {\n return;\n }\n this.messageBuffer.popToSequence(lastMessageSeq);\n const unlock = await this.lockHeadroom();\n try {\n // Resolved only once the lock is held: the handle can be replaced while the replay waits\n // for it.\n const dc = this.getChannel();\n if (!dc) {\n throw new UnexpectedConnectionState(`DataChannel not found, kind: ${this.kind}`);\n }\n // Everything left after the ack cutoff must be re-handed to the current channel.\n this.messageBuffer.markAllUnsent();\n // Drain in passes, re-scanning the live buffer each time: a send that arrives (deferred,\n // sent:false) during our own awaits appends after this pass started, so we pick it up on\n // the next one. Mark each packet only once we've actually handed it to the channel — a\n // blanket \"mark all sent\" would flip such a late arrival to sent without transmitting it,\n // and a later alignBufferedAmount would then drop it for good. If the loop throws\n // mid-drain, unsent entries keep their flag and the next replay picks them up.\n for (\n let batch = this.messageBuffer.getUnsent();\n batch.length > 0;\n batch = this.messageBuffer.getUnsent()\n ) {\n for (const item of batch) {\n // Respect flow control on resume too, so a large resend doesn't overflow the buffer.\n // Against the handle resolved under the lock: if it is replaced mid-replay (another\n // resume), it has been closed, so this throws and that resume's replay picks up the\n // entries still flagged unsent.\n await this.waitForHeadroomWithoutLock(dc);\n dc.send(item.data);\n this.messageBuffer.markSent(item);\n }\n }\n } finally {\n unlock();\n }\n this.refreshBufferStatus();\n }\n\n /**\n * Before recomputing status, trim packets the transport has now delivered — a send or a drain\n * may have acked buffered packets, and the replay buffer is keyed off the channel's buffered\n * bytes.\n */\n override refreshBufferStatus() {\n const dc = this.channelHandle;\n if (dc) {\n this.messageBuffer.alignBufferedAmount(dc.bufferedAmount);\n }\n super.refreshBufferStatus();\n }\n\n /**\n * Drops all replay state and restarts sequencing. Only valid on a full reconnect, where the\n * session (and the receivers' sequence tracking) starts over.\n */\n reset() {\n this.messageBuffer = new DataPacketBuffer();\n this.sequence = 1;\n }\n}\n"],"names":["ReliableDataChannel","FlowControlledDataChannel","constructor","opts","messageBuffer","DataPacketBuffer","sequence","isDeferringSends","nextSequence","send","msg","push","data","sent","dc","getChannel","waitForHeadroomWithLock","error","isEngineClosed","refreshBufferStatus","replay","lastMessageSeq","popToSequence","unlock","lockHeadroom","UnexpectedConnectionState","concat","kind","markAllUnsent","batch","getUnsent","length","item","waitForHeadroomWithoutLock","markSent","channelHandle","alignBufferedAmount","bufferedAmount","reset"],"mappings":"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"}
@@ -0,0 +1,22 @@
1
+ import'@livekit/protocol';var DataChannelKind;
2
+ (function (DataChannelKind) {
3
+ DataChannelKind[DataChannelKind["RELIABLE"] = 0] = "RELIABLE";
4
+ DataChannelKind[DataChannelKind["LOSSY"] = 1] = "LOSSY";
5
+ DataChannelKind[DataChannelKind["DATA_TRACK_LOSSY"] = 2] = "DATA_TRACK_LOSSY";
6
+ })(DataChannelKind || (DataChannelKind = {}));
7
+ // Two-watermark flow control for the reliable and data-track channels. Senders fill the buffer
8
+ // freely up to the high-water mark; once it's exceeded they block until the browser's
9
+ // `bufferedamountlow` event (which we arm at the low-water mark) signals the buffer has drained.
10
+ // The gap between the marks keeps the SCTP send buffer saturated while we refill, so throughput
11
+ // isn't starved, while the high-water mark bounds the buffer well below the level that would abort
12
+ // the channel (see livekit/client-sdk-js#1995).
13
+ const reliableDataChannelWaterMarkLow = 64 * 1024;
14
+ const reliableDataChannelWaterMarkHigh = 1024 * 1024;
15
+ const lossyDataChannelWaterMarkLow = 8 * 1024;
16
+ const lossyDataChannelWaterMarkHigh = 256 * 1024;
17
+ function dataChannelLowWaterMark(kind) {
18
+ return kind === DataChannelKind.RELIABLE ? reliableDataChannelWaterMarkLow : lossyDataChannelWaterMarkLow;
19
+ }
20
+ function dataChannelHighWaterMark(kind) {
21
+ return kind === DataChannelKind.RELIABLE ? reliableDataChannelWaterMarkHigh : lossyDataChannelWaterMarkHigh;
22
+ }export{DataChannelKind,dataChannelHighWaterMark,dataChannelLowWaterMark,lossyDataChannelWaterMarkHigh,lossyDataChannelWaterMarkLow,reliableDataChannelWaterMarkHigh,reliableDataChannelWaterMarkLow};//# sourceMappingURL=types.mjs.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"types.mjs","sources":["../../../../src/room/data-channel/types.ts"],"sourcesContent":["import { DataPacket_Kind } from '@livekit/protocol';\n\nexport enum DataChannelKind {\n RELIABLE = DataPacket_Kind.RELIABLE,\n LOSSY = DataPacket_Kind.LOSSY,\n DATA_TRACK_LOSSY = 2,\n}\n\n// Two-watermark flow control for the reliable and data-track channels. Senders fill the buffer\n// freely up to the high-water mark; once it's exceeded they block until the browser's\n// `bufferedamountlow` event (which we arm at the low-water mark) signals the buffer has drained.\n// The gap between the marks keeps the SCTP send buffer saturated while we refill, so throughput\n// isn't starved, while the high-water mark bounds the buffer well below the level that would abort\n// the channel (see livekit/client-sdk-js#1995).\nexport const reliableDataChannelWaterMarkLow = 64 * 1024;\nexport const reliableDataChannelWaterMarkHigh = 1024 * 1024;\nexport const lossyDataChannelWaterMarkLow = 8 * 1024;\nexport const lossyDataChannelWaterMarkHigh = 256 * 1024;\n\nexport function dataChannelLowWaterMark(kind: DataChannelKind): number {\n return kind === DataChannelKind.RELIABLE\n ? reliableDataChannelWaterMarkLow\n : lossyDataChannelWaterMarkLow;\n}\n\nexport function dataChannelHighWaterMark(kind: DataChannelKind): number {\n return kind === DataChannelKind.RELIABLE\n ? reliableDataChannelWaterMarkHigh\n : lossyDataChannelWaterMarkHigh;\n}\n"],"names":["DataChannelKind","reliableDataChannelWaterMarkLow","reliableDataChannelWaterMarkHigh","lossyDataChannelWaterMarkLow","lossyDataChannelWaterMarkHigh","dataChannelLowWaterMark","kind","RELIABLE","dataChannelHighWaterMark"],"mappings":"8BAEYA;AAAZ,CAAA,UAAYA,eAAe,EAAA;EACzBA,eAAA,CAAAA,eAAA,CAAA,UAAA,CAAA,GAAA,CAAA,CAAA,GAAA,UAAmC;EACnCA,eAAA,CAAAA,eAAA,CAAA,OAAA,CAAA,GAAA,CAAA,CAAA,GAAA,OAA6B;EAC7BA,eAAA,CAAAA,eAAA,CAAA,kBAAA,CAAA,GAAA,CAAA,CAAA,GAAA,kBAAoB;AACtB,CAAC,EAJWA,eAAe,KAAfA,eAAe,GAAA,EAAA,CAAA,CAAA;AAM3B;AACA;AACA;AACA;AACA;AACA;AACO,MAAMC,+BAA+B,GAAG,EAAE,GAAG;AAC7C,MAAMC,gCAAgC,GAAG,IAAI,GAAG;AAChD,MAAMC,4BAA4B,GAAG,CAAC,GAAG;AACzC,MAAMC,6BAA6B,GAAG,GAAG,GAAG;AAE7C,SAAUC,uBAAuBA,CAACC,IAAqB,EAAA;EAC3D,OAAOA,IAAI,KAAKN,eAAe,CAACO,QAAQ,GACpCN,+BAA+B,GAC/BE,4BAA4B;AAClC;AAEM,SAAUK,wBAAwBA,CAACF,IAAqB,EAAA;EAC5D,OAAOA,IAAI,KAAKN,eAAe,CAACO,QAAQ,GACpCL,gCAAgC,GAChCE,6BAA6B;AACnC"}
@@ -0,0 +1,68 @@
1
+ import {__awaiter}from'tslib';import {DataStreamError,DataStreamErrorReason}from'../errors.mjs';/**
2
+ * A `deflate-raw` compression transform (inverse of {@link inflateRawTransform}): pipe a byte stream
3
+ * through it to get the compressed bytes without buffering the whole payload. Used for the chunked
4
+ * `sendText`/`sendBytes`/`sendFile` paths, where the full payload is known up front but is streamed
5
+ * (e.g. from `file.stream()`) rather than held in memory.
6
+ */
7
+ function deflateRawTransform() {
8
+ return new CompressionStream('deflate-raw');
9
+ }
10
+ /**
11
+ * A `deflate-raw` decompression transform (inverse of {@link deflateRawTransform}): pipe a
12
+ * stream of compressed bytes through it to get the decompressed bytes. Inflate emits output greedily,
13
+ * so as long as the sender flushed at write boundaries each write's content is produced as soon as
14
+ * its compressed bytes arrive.
15
+ */
16
+ function inflateRawTransform() {
17
+ return new DecompressionStream('deflate-raw');
18
+ }
19
+ /**
20
+ * Decompresses a raw-deflate byte array in full (inverse of {@link deflateRawCompress}).
21
+ * `maxByteLength` bounds the decompressed output (decompression-bomb guard); exceeding it rejects
22
+ * with a `PayloadTooLarge` error.
23
+ */
24
+ function deflateRawDecompress(data, maxByteLength) {
25
+ return __awaiter(this, void 0, void 0, function* () {
26
+ const ds = new DecompressionStream('deflate-raw');
27
+ const writer = ds.writable.getWriter();
28
+ // The writer promises are intentionally not awaited (output is consumed via `collect`), but
29
+ // they reject when the byte cap cancels the readable mid-stream — swallow that so an enforced
30
+ // cap doesn't surface as an unhandled rejection.
31
+ writer.write(data).catch(() => {});
32
+ writer.close().catch(() => {});
33
+ return collect(ds.readable, maxByteLength);
34
+ });
35
+ }
36
+ /**
37
+ * Drains a byte stream, concatenating all of its chunks into a single array. When
38
+ * `maxByteLength` is given, drops the stream and throws `PayloadTooLarge` as soon as the
39
+ * accumulated output exceeds it.
40
+ */
41
+ function collect(stream, maxByteLength) {
42
+ return __awaiter(this, void 0, void 0, function* () {
43
+ const reader = stream.getReader();
44
+ const chunks = [];
45
+ let total = 0;
46
+ while (true) {
47
+ const _yield$reader$read = yield reader.read(),
48
+ done = _yield$reader$read.done,
49
+ value = _yield$reader$read.value;
50
+ if (done) {
51
+ break;
52
+ }
53
+ chunks.push(value);
54
+ total += value.byteLength;
55
+ if (typeof maxByteLength === 'number' && total > maxByteLength) {
56
+ yield reader.cancel();
57
+ throw new DataStreamError("Decompressed payload exceeds the maximum payload size of ".concat(maxByteLength, " bytes"), DataStreamErrorReason.PayloadTooLarge);
58
+ }
59
+ }
60
+ const result = new Uint8Array(total);
61
+ let offset = 0;
62
+ for (const chunk of chunks) {
63
+ result.set(chunk, offset);
64
+ offset += chunk.byteLength;
65
+ }
66
+ return result;
67
+ });
68
+ }export{collect,deflateRawDecompress,deflateRawTransform,inflateRawTransform};//# sourceMappingURL=compression.mjs.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"compression.mjs","sources":["../../../../src/room/data-stream/compression.ts"],"sourcesContent":["/**\n * Compression helpers for data streams. The buffered deflate-raw variant ({@link deflateRawCompress})\n * is for the inline (single-packet) case where the payload is small and bounded;\n * {@link deflateRawTransform} / {@link inflateRawTransform} serve the chunked (multi-packet)\n * `sendText`/`sendBytes`/`sendFile` paths, streaming the bytes through without buffering the whole\n * payload.\n *\n * These operate on bytes (not strings) so a single set of helpers serves both text and byte streams;\n * the `TextEncoder`/`TextDecoder` boundary lives at the manager/reader edges.\n *\n * Both streaming variants are exposed as `ReadableWritablePair`s so they drop straight into a\n * `pipeThrough` chain. Each needs one localized cast to bridge a DOM lib-type mismatch: the platform\n * `CompressionStream`/`DecompressionStream` type their `writable` as `WritableStream<BufferSource>`\n * (a wider element type than `Uint8Array`), and `WritableStream<W>` is covariant in `W`, so neither\n * is structurally a `ReadableWritablePair<Uint8Array, Uint8Array>` without help.\n *\n * @internal\n */\nimport { type NonSharedUint8Array } from '../../type-polyfills/non-shared-typed-arrays';\nimport { DataStreamError, DataStreamErrorReason } from '../errors';\n\n/**\n * A `deflate-raw` compression transform (inverse of {@link inflateRawTransform}): pipe a byte stream\n * through it to get the compressed bytes without buffering the whole payload. Used for the chunked\n * `sendText`/`sendBytes`/`sendFile` paths, where the full payload is known up front but is streamed\n * (e.g. from `file.stream()`) rather than held in memory.\n */\nexport function deflateRawTransform(): ReadableWritablePair<\n NonSharedUint8Array,\n NonSharedUint8Array\n> {\n return new CompressionStream('deflate-raw') as unknown as ReadableWritablePair<\n NonSharedUint8Array,\n NonSharedUint8Array\n >;\n}\n\n/**\n * A `deflate-raw` decompression transform (inverse of {@link deflateRawTransform}): pipe a\n * stream of compressed bytes through it to get the decompressed bytes. Inflate emits output greedily,\n * so as long as the sender flushed at write boundaries each write's content is produced as soon as\n * its compressed bytes arrive.\n */\nexport function inflateRawTransform(): ReadableWritablePair<\n NonSharedUint8Array,\n NonSharedUint8Array\n> {\n return new DecompressionStream('deflate-raw') as unknown as ReadableWritablePair<\n NonSharedUint8Array,\n NonSharedUint8Array\n >;\n}\n\n/** deflate-raw compresses a byte array in full. Use for inline payloads; prefer the streaming\n * path for the chunked case. */\nexport async function deflateRawCompress(data: NonSharedUint8Array): Promise<NonSharedUint8Array> {\n const cs = new CompressionStream('deflate-raw');\n const writer = cs.writable.getWriter();\n writer.write(data as NonSharedUint8Array);\n writer.close();\n return collect(cs.readable);\n}\n\n/**\n * Decompresses a raw-deflate byte array in full (inverse of {@link deflateRawCompress}).\n * `maxByteLength` bounds the decompressed output (decompression-bomb guard); exceeding it rejects\n * with a `PayloadTooLarge` error.\n */\nexport async function deflateRawDecompress(\n data: NonSharedUint8Array,\n maxByteLength?: number,\n): Promise<NonSharedUint8Array> {\n const ds = new DecompressionStream('deflate-raw');\n const writer = ds.writable.getWriter();\n // The writer promises are intentionally not awaited (output is consumed via `collect`), but\n // they reject when the byte cap cancels the readable mid-stream — swallow that so an enforced\n // cap doesn't surface as an unhandled rejection.\n writer.write(data as NonSharedUint8Array).catch(() => {});\n writer.close().catch(() => {});\n return collect(ds.readable, maxByteLength);\n}\n\n/**\n * Drains a byte stream, concatenating all of its chunks into a single array. When\n * `maxByteLength` is given, drops the stream and throws `PayloadTooLarge` as soon as the\n * accumulated output exceeds it.\n */\nexport async function collect(\n stream: ReadableStream<NonSharedUint8Array>,\n maxByteLength?: number,\n): Promise<NonSharedUint8Array> {\n const reader = stream.getReader();\n const chunks: Array<NonSharedUint8Array> = [];\n let total = 0;\n while (true) {\n const { done, value } = await reader.read();\n if (done) {\n break;\n }\n chunks.push(value);\n total += value.byteLength;\n if (typeof maxByteLength === 'number' && total > maxByteLength) {\n await reader.cancel();\n throw new DataStreamError(\n `Decompressed payload exceeds the maximum payload size of ${maxByteLength} bytes`,\n DataStreamErrorReason.PayloadTooLarge,\n );\n }\n }\n const result = new Uint8Array(total);\n let offset = 0;\n for (const chunk of chunks) {\n result.set(chunk, offset);\n offset += chunk.byteLength;\n }\n return result;\n}\n"],"names":["deflateRawTransform","CompressionStream","inflateRawTransform","DecompressionStream","deflateRawDecompress","data","maxByteLength","ds","writer","writable","getWriter","write","catch","close","collect","readable","stream","reader","getReader","chunks","total","_yield$reader$read","read","done","value","push","byteLength","cancel","DataStreamError","concat","DataStreamErrorReason","PayloadTooLarge","result","Uint8Array","offset","chunk","set"],"mappings":"gGAqBA;;;;;AAKG;SACaA,mBAAmBA,GAAA;AAIjC,EAAA,OAAO,IAAIC,iBAAiB,CAAC,aAAa,CAGzC;AACH;AAEA;;;;;AAKG;SACaC,mBAAmBA,GAAA;AAIjC,EAAA,OAAO,IAAIC,mBAAmB,CAAC,aAAa,CAG3C;AACH;AAYA;;;;AAIG;AACG,SAAgBC,oBAAoBA,CACxCC,IAAyB,EACzBC,aAAsB,EAAA;;AAEtB,IAAA,MAAMC,EAAE,GAAG,IAAIJ,mBAAmB,CAAC,aAAa,CAAC;IACjD,MAAMK,MAAM,GAAGD,EAAE,CAACE,QAAQ,CAACC,SAAS,EAAE;AACtC;AACA;AACA;IACAF,MAAM,CAACG,KAAK,CAACN,IAA2B,CAAC,CAACO,KAAK,CAAC,MAAK,CAAE,CAAC,CAAC;IACzDJ,MAAM,CAACK,KAAK,EAAE,CAACD,KAAK,CAAC,MAAK,CAAE,CAAC,CAAC;AAC9B,IAAA,OAAOE,OAAO,CAACP,EAAE,CAACQ,QAAQ,EAAET,aAAa,CAAC;AAC5C,EAAA,CAAC,CAAA;AAAA;AAED;;;;AAIG;AACG,SAAgBQ,OAAOA,CAC3BE,MAA2C,EAC3CV,aAAsB,EAAA;;AAEtB,IAAA,MAAMW,MAAM,GAAGD,MAAM,CAACE,SAAS,EAAE;IACjC,MAAMC,MAAM,GAA+B,EAAE;IAC7C,IAAIC,KAAK,GAAG,CAAC;AACb,IAAA,OAAO,IAAI,EAAE;AACX,MAAA,MAAAC,kBAAA,GAAwB,MAAMJ,MAAM,CAACK,IAAI,EAAE;QAAnCC,IAAI,GAAAF,kBAAA,CAAJE,IAAI;QAAEC,KAAK,GAAAH,kBAAA,CAALG,KAAK;AACnB,MAAA,IAAID,IAAI,EAAE;AACR,QAAA;AACF,MAAA;AACAJ,MAAAA,MAAM,CAACM,IAAI,CAACD,KAAK,CAAC;MAClBJ,KAAK,IAAII,KAAK,CAACE,UAAU;MACzB,IAAI,OAAOpB,aAAa,KAAK,QAAQ,IAAIc,KAAK,GAAGd,aAAa,EAAE;AAC9D,QAAA,MAAMW,MAAM,CAACU,MAAM,EAAE;QACrB,MAAM,IAAIC,eAAe,CAAA,2DAAA,CAAAC,MAAA,CACqCvB,aAAa,EAAA,QAAA,CAAA,EACzEwB,qBAAqB,CAACC,eAAe,CACtC;AACH,MAAA;AACF,IAAA;AACA,IAAA,MAAMC,MAAM,GAAG,IAAIC,UAAU,CAACb,KAAK,CAAC;IACpC,IAAIc,MAAM,GAAG,CAAC;AACd,IAAA,KAAK,MAAMC,KAAK,IAAIhB,MAAM,EAAE;AAC1Ba,MAAAA,MAAM,CAACI,GAAG,CAACD,KAAK,EAAED,MAAM,CAAC;MACzBA,MAAM,IAAIC,KAAK,CAACT,UAAU;AAC5B,IAAA;AACA,IAAA,OAAOM,MAAM;AACf,EAAA,CAAC,CAAA;AAAA"}
@@ -0,0 +1,26 @@
1
+ /**
2
+ * Maximum size of a single data-stream chunk in bytes, and the budget used to decide whether a
3
+ * payload can be sent inline as a single header packet. Kept below the ~16k data-channel MTU to
4
+ * leave headroom for protocol framing and E2EE overhead.
5
+ *
6
+ * @internal
7
+ */
8
+ const STREAM_CHUNK_SIZE_BYTES = 15000;
9
+ /**
10
+ * Default cap on the number of decompressed bytes a single incoming compressed data stream may
11
+ * produce (5 GB). A tiny compressed payload can inflate to an arbitrarily large output
12
+ * (decompression bomb), so the decompressor's output is bounded rather than trusting the wire
13
+ * size; streams exceeding the cap error with `PayloadTooLarge`.
14
+ *
15
+ * @internal
16
+ */
17
+ const DEFAULT_MAX_PAYLOAD_BYTE_LENGTH = 5000000000;
18
+ /**
19
+ * Maximum number of incoming data streams a single remote participant may have open at once.
20
+ * Each open stream holds receiver-side state until its trailer arrives (or the sender
21
+ * disconnects), so without a cap a participant could open streams it never closes and exhaust
22
+ * the receiver's memory. Headers for new streams beyond the cap are dropped.
23
+ *
24
+ * @internal
25
+ */
26
+ const DEFAULT_MAX_OPEN_STREAMS_PER_PARTICIPANT = 500;export{DEFAULT_MAX_OPEN_STREAMS_PER_PARTICIPANT,DEFAULT_MAX_PAYLOAD_BYTE_LENGTH,STREAM_CHUNK_SIZE_BYTES};//# sourceMappingURL=constants.mjs.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"constants.mjs","sources":["../../../../src/room/data-stream/constants.ts"],"sourcesContent":["/**\n * Maximum size of a single data-stream chunk in bytes, and the budget used to decide whether a\n * payload can be sent inline as a single header packet. Kept below the ~16k data-channel MTU to\n * leave headroom for protocol framing and E2EE overhead.\n *\n * @internal\n */\nexport const STREAM_CHUNK_SIZE_BYTES = 15_000;\n\n/**\n * Default cap on the number of decompressed bytes a single incoming compressed data stream may\n * produce (5 GB). A tiny compressed payload can inflate to an arbitrarily large output\n * (decompression bomb), so the decompressor's output is bounded rather than trusting the wire\n * size; streams exceeding the cap error with `PayloadTooLarge`.\n *\n * @internal\n */\nexport const DEFAULT_MAX_PAYLOAD_BYTE_LENGTH = 5_000_000_000;\n\n/**\n * Maximum number of incoming data streams a single remote participant may have open at once.\n * Each open stream holds receiver-side state until its trailer arrives (or the sender\n * disconnects), so without a cap a participant could open streams it never closes and exhaust\n * the receiver's memory. Headers for new streams beyond the cap are dropped.\n *\n * @internal\n */\nexport const DEFAULT_MAX_OPEN_STREAMS_PER_PARTICIPANT = 500;\n"],"names":["STREAM_CHUNK_SIZE_BYTES","DEFAULT_MAX_PAYLOAD_BYTE_LENGTH","DEFAULT_MAX_OPEN_STREAMS_PER_PARTICIPANT"],"mappings":"AAAA;;;;;;AAMG;AACI,MAAMA,uBAAuB,GAAG;AAEvC;;;;;;;AAOG;AACI,MAAMC,+BAA+B,GAAG;AAE/C;;;;;;;AAOG;AACI,MAAMC,wCAAwC,GAAG"}
@@ -0,0 +1,42 @@
1
+ import {CLIENT_PROTOCOL_DEFAULT}from'../../version.mjs';import {ConnectionState}from'../CoreRoom.mjs';import {RoomEvent}from'../events.mjs';import {defineExtension}from'../extensions.mjs';import IncomingDataStreamManager from'./incoming/IncomingDataStreamManager.mjs';import OutgoingDataStreamManager from'./outgoing/OutgoingDataStreamManager.mjs';/**
2
+ * Text and byte streams (`sendText`, `sendFile`, `registerTextStreamHandler`, ...).
3
+ * @experimental
4
+ */
5
+ const dataStreams = /* @__PURE__ */defineExtension('dataStreams', [], (room, ctx, streamOptions) => {
6
+ const incoming = new IncomingDataStreamManager(streamOptions !== null && streamOptions !== void 0 ? streamOptions : room.options.dataStream);
7
+ const outgoing = new OutgoingDataStreamManager(room.engine, ctx.log, identity => {
8
+ var _a, _b;
9
+ return (_b = (_a = room.remoteParticipants.get(identity)) === null || _a === void 0 ? void 0 : _a.clientProtocol) !== null && _b !== void 0 ? _b : CLIENT_PROTOCOL_DEFAULT;
10
+ }, identity => {
11
+ var _a, _b;
12
+ return (_b = (_a = room.remoteParticipants.get(identity)) === null || _a === void 0 ? void 0 : _a.capabilities) !== null && _b !== void 0 ? _b : [];
13
+ }, () => Array.from(room.remoteParticipants.keys()));
14
+ const onStreamPacket = (_value, packet, encryptionType) => incoming.handleDataStreamPacket(packet, encryptionType);
15
+ room.on(RoomEvent.ConnectionStateChanged, state => incoming.setConnected(state === ConnectionState.Connected)).on(RoomEvent.ParticipantDisconnected, participant => incoming.validateParticipantHasNoActiveDataStreams(participant.identity));
16
+ return {
17
+ incoming,
18
+ outgoing,
19
+ // The preconnect audio buffer is sent as a byte stream from inside the core publish path.
20
+ byteStreamOpener: options => outgoing.streamBytes(options),
21
+ dataPackets: {
22
+ streamHeader: onStreamPacket,
23
+ streamChunk: onStreamPacket,
24
+ streamTrailer: onStreamPacket
25
+ },
26
+ onEngineCreated: engine => outgoing.setupEngine(engine),
27
+ onDisconnect: () => incoming.clearControllers(),
28
+ room: {
29
+ registerTextStreamHandler: (topic, callback) => incoming.registerTextStreamHandler(topic, callback),
30
+ unregisterTextStreamHandler: topic => incoming.unregisterTextStreamHandler(topic),
31
+ registerByteStreamHandler: (topic, callback) => incoming.registerByteStreamHandler(topic, callback),
32
+ unregisterByteStreamHandler: topic => incoming.unregisterByteStreamHandler(topic)
33
+ },
34
+ localParticipant: {
35
+ sendText: (text, options) => outgoing.sendText(text, options),
36
+ streamText: options => outgoing.streamText(options),
37
+ sendFile: (file, options) => outgoing.sendFile(file, options),
38
+ sendBytes: (bytes, options) => outgoing.sendBytes(bytes, options),
39
+ streamBytes: options => outgoing.streamBytes(options)
40
+ }
41
+ };
42
+ });export{dataStreams};//# sourceMappingURL=extension.mjs.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"extension.mjs","sources":["../../../../src/room/data-stream/extension.ts"],"sourcesContent":["import type { DataPacket, Encryption_Type } from '@livekit/protocol';\nimport type { RoomDataStreamOptions } from '../../options';\nimport { CLIENT_PROTOCOL_DEFAULT } from '../../version';\nimport { ConnectionState } from '../CoreRoom';\nimport type { CoreRoom } from '../CoreRoom';\nimport { RoomEvent } from '../events';\nimport {\n type ConnectionHooks,\n type DataPacketOwner,\n type EngineHooks,\n type ExtensionContext,\n type LocalParticipantApiProvider,\n type RoomApiProvider,\n type SlotProvider,\n defineExtension,\n} from '../extensions';\nimport type {\n ByteStreamInfo,\n SendBytesOptions,\n SendFileOptions,\n SendTextOptions,\n StreamBytesOptions,\n StreamTextOptions,\n TextStreamInfo,\n} from '../types';\nimport IncomingDataStreamManager from './incoming/IncomingDataStreamManager';\nimport type { ByteStreamHandler, TextStreamHandler } from './incoming/StreamReader';\nimport OutgoingDataStreamManager from './outgoing/OutgoingDataStreamManager';\nimport type { ByteStreamWriter, TextStreamWriter } from './outgoing/StreamWriter';\n\n/**\n * Methods the `dataStreams` extension adds to the room.\n * @experimental\n */\nexport interface DataStreamRoomApi {\n registerTextStreamHandler(topic: string, callback: TextStreamHandler): void;\n unregisterTextStreamHandler(topic: string): void;\n registerByteStreamHandler(topic: string, callback: ByteStreamHandler): void;\n unregisterByteStreamHandler(topic: string): void;\n}\n\n/**\n * Methods the `dataStreams` extension adds to the local participant.\n * @experimental\n */\nexport interface DataStreamLocalParticipantApi {\n /**\n * Sends the given string to participants in the room via the data channel.\n * For longer messages, consider using {@link streamText} instead.\n *\n * @param text The text payload\n * @param options.topic Topic identifier used to route the stream to appropriate handlers.\n */\n sendText(text: string, options?: SendTextOptions): Promise<TextStreamInfo>;\n\n /**\n * Creates a new TextStreamWriter which can be used to stream text incrementally\n * to participants in the room via the data channel.\n *\n * @param options.topic Topic identifier used to route the stream to appropriate handlers.\n *\n * @internal\n * @experimental CAUTION, might get removed in a minor release\n */\n streamText(options?: StreamTextOptions): Promise<TextStreamWriter>;\n\n /** Send a File to all participants in the room via the data channel.\n * @param file The File object payload\n * @param options.topic Topic identifier used to route the stream to appropriate handlers.\n * @param options.onProgress A callback function used to monitor the upload progress percentage.\n */\n sendFile(file: File, options?: SendFileOptions): Promise<{ id: string }>;\n\n /**\n * Sends the given bytes to participants in the room via the data channel.\n * For files, consider using {@link sendFile}; for longer/incremental payloads, {@link streamBytes}.\n *\n * @param bytes The byte payload\n * @param options.topic Topic identifier used to route the stream to appropriate handlers.\n */\n sendBytes(bytes: Uint8Array, options?: SendBytesOptions): Promise<ByteStreamInfo>;\n\n /**\n * Stream bytes incrementally to participants in the room via the data channel.\n * For sending files, consider using {@link sendFile} instead.\n *\n * @param options.topic Topic identifier used to route the stream to appropriate handlers.\n */\n streamBytes(options?: StreamBytesOptions): Promise<ByteStreamWriter>;\n}\n\n/**\n * Text and byte streams (`sendText`, `sendFile`, `registerTextStreamHandler`, ...).\n * @experimental\n */\nexport const dataStreams = /* @__PURE__ */ defineExtension(\n 'dataStreams',\n [],\n (\n room: CoreRoom,\n ctx: ExtensionContext,\n streamOptions: RoomDataStreamOptions | undefined,\n ): RoomApiProvider<DataStreamRoomApi> &\n LocalParticipantApiProvider<DataStreamLocalParticipantApi> &\n SlotProvider<'byteStreamOpener'> &\n DataPacketOwner &\n EngineHooks &\n ConnectionHooks & {\n incoming: IncomingDataStreamManager;\n outgoing: OutgoingDataStreamManager;\n } => {\n const incoming = new IncomingDataStreamManager(streamOptions ?? room.options.dataStream);\n const outgoing = new OutgoingDataStreamManager(\n room.engine,\n ctx.log,\n (identity) =>\n room.remoteParticipants.get(identity)?.clientProtocol ?? CLIENT_PROTOCOL_DEFAULT,\n (identity) => room.remoteParticipants.get(identity)?.capabilities ?? [],\n () => Array.from(room.remoteParticipants.keys()),\n );\n\n const onStreamPacket = (_value: unknown, packet: DataPacket, encryptionType: Encryption_Type) =>\n incoming.handleDataStreamPacket(packet, encryptionType);\n\n room\n .on(RoomEvent.ConnectionStateChanged, (state) =>\n incoming.setConnected(state === ConnectionState.Connected),\n )\n .on(RoomEvent.ParticipantDisconnected, (participant) =>\n incoming.validateParticipantHasNoActiveDataStreams(participant.identity),\n );\n\n return {\n incoming,\n outgoing,\n // The preconnect audio buffer is sent as a byte stream from inside the core publish path.\n byteStreamOpener: (options) => outgoing.streamBytes(options),\n dataPackets: {\n streamHeader: onStreamPacket,\n streamChunk: onStreamPacket,\n streamTrailer: onStreamPacket,\n },\n onEngineCreated: (engine) => outgoing.setupEngine(engine),\n onDisconnect: () => incoming.clearControllers(),\n room: {\n registerTextStreamHandler: (topic, callback) =>\n incoming.registerTextStreamHandler(topic, callback),\n unregisterTextStreamHandler: (topic) => incoming.unregisterTextStreamHandler(topic),\n registerByteStreamHandler: (topic, callback) =>\n incoming.registerByteStreamHandler(topic, callback),\n unregisterByteStreamHandler: (topic) => incoming.unregisterByteStreamHandler(topic),\n },\n localParticipant: {\n sendText: (text, options) => outgoing.sendText(text, options),\n streamText: (options) => outgoing.streamText(options),\n sendFile: (file, options) => outgoing.sendFile(file, options),\n sendBytes: (bytes, options) => outgoing.sendBytes(bytes, options),\n streamBytes: (options) => outgoing.streamBytes(options),\n },\n };\n },\n);\n"],"names":["dataStreams","defineExtension","room","ctx","streamOptions","incoming","IncomingDataStreamManager","options","dataStream","outgoing","OutgoingDataStreamManager","engine","log","identity","_a","_b","remoteParticipants","get","clientProtocol","CLIENT_PROTOCOL_DEFAULT","capabilities","Array","from","keys","onStreamPacket","_value","packet","encryptionType","handleDataStreamPacket","on","RoomEvent","ConnectionStateChanged","state","setConnected","ConnectionState","Connected","ParticipantDisconnected","participant","validateParticipantHasNoActiveDataStreams","byteStreamOpener","streamBytes","dataPackets","streamHeader","streamChunk","streamTrailer","onEngineCreated","setupEngine","onDisconnect","clearControllers","registerTextStreamHandler","topic","callback","unregisterTextStreamHandler","registerByteStreamHandler","unregisterByteStreamHandler","localParticipant","sendText","text","streamText","sendFile","file","sendBytes","bytes"],"mappings":"4VA2FA;;;AAGG;MACUA,WAAW,kBAAmBC,eAAe,CACxD,aAAa,EACb,EAAE,EACF,CACEC,IAAc,EACdC,GAAqB,EACrBC,aAAgD,KAS5C;EACJ,MAAMC,QAAQ,GAAG,IAAIC,yBAAyB,CAACF,aAAa,KAAA,IAAA,IAAbA,aAAa,KAAA,MAAA,GAAbA,aAAa,GAAIF,IAAI,CAACK,OAAO,CAACC,UAAU,CAAC;AACxF,EAAA,MAAMC,QAAQ,GAAG,IAAIC,yBAAyB,CAC5CR,IAAI,CAACS,MAAM,EACXR,GAAG,CAACS,GAAG,EACNC,QAAQ,IAAI;IAAA,IAAAC,EAAA,EAAAC,EAAA;AACX,IAAA,OAAA,MAAA,CAAAD,EAAA,GAAAZ,IAAI,CAACc,kBAAkB,CAACC,GAAG,CAACJ,QAAQ,CAAC,0CAAEK,cAAc,MAAA,IAAA,IAAAH,EAAA,KAAA,MAAA,GAAAA,EAAA,GAAII,uBAAuB;GAAA,EACjFN,QAAQ,IAAI;IAAA,IAAAC,EAAA,EAAAC,EAAA;AAAC,IAAA,OAAA,CAAAA,EAAA,GAAA,MAAAb,IAAI,CAACc,kBAAkB,CAACC,GAAG,CAACJ,QAAQ,CAAC,MAAA,IAAA,IAAAC,EAAA,KAAA,MAAA,GAAA,MAAA,GAAAA,EAAA,CAAEM,YAAY,MAAA,IAAA,IAAAL,EAAA,KAAA,MAAA,GAAAA,EAAA,GAAI,EAAE;AAAA,EAAA,CAAA,EACvE,MAAMM,KAAK,CAACC,IAAI,CAACpB,IAAI,CAACc,kBAAkB,CAACO,IAAI,EAAE,CAAC,CACjD;AAED,EAAA,MAAMC,cAAc,GAAGA,CAACC,MAAe,EAAEC,MAAkB,EAAEC,cAA+B,KAC1FtB,QAAQ,CAACuB,sBAAsB,CAACF,MAAM,EAAEC,cAAc,CAAC;AAEzDzB,EAAAA,IAAI,CACD2B,EAAE,CAACC,SAAS,CAACC,sBAAsB,EAAGC,KAAK,IAC1C3B,QAAQ,CAAC4B,YAAY,CAACD,KAAK,KAAKE,eAAe,CAACC,SAAS,CAAC,CAC3D,CACAN,EAAE,CAACC,SAAS,CAACM,uBAAuB,EAAGC,WAAW,IACjDhC,QAAQ,CAACiC,yCAAyC,CAACD,WAAW,CAACxB,QAAQ,CAAC,CACzE;EAEH,OAAO;IACLR,QAAQ;IACRI,QAAQ;AACR;IACA8B,gBAAgB,EAAGhC,OAAO,IAAKE,QAAQ,CAAC+B,WAAW,CAACjC,OAAO,CAAC;AAC5DkC,IAAAA,WAAW,EAAE;AACXC,MAAAA,YAAY,EAAElB,cAAc;AAC5BmB,MAAAA,WAAW,EAAEnB,cAAc;AAC3BoB,MAAAA,aAAa,EAAEpB;KAChB;IACDqB,eAAe,EAAGlC,MAAM,IAAKF,QAAQ,CAACqC,WAAW,CAACnC,MAAM,CAAC;AACzDoC,IAAAA,YAAY,EAAEA,MAAM1C,QAAQ,CAAC2C,gBAAgB,EAAE;AAC/C9C,IAAAA,IAAI,EAAE;AACJ+C,MAAAA,yBAAyB,EAAEA,CAACC,KAAK,EAAEC,QAAQ,KACzC9C,QAAQ,CAAC4C,yBAAyB,CAACC,KAAK,EAAEC,QAAQ,CAAC;MACrDC,2BAA2B,EAAGF,KAAK,IAAK7C,QAAQ,CAAC+C,2BAA2B,CAACF,KAAK,CAAC;AACnFG,MAAAA,yBAAyB,EAAEA,CAACH,KAAK,EAAEC,QAAQ,KACzC9C,QAAQ,CAACgD,yBAAyB,CAACH,KAAK,EAAEC,QAAQ,CAAC;AACrDG,MAAAA,2BAA2B,EAAGJ,KAAK,IAAK7C,QAAQ,CAACiD,2BAA2B,CAACJ,KAAK;KACnF;AACDK,IAAAA,gBAAgB,EAAE;AAChBC,MAAAA,QAAQ,EAAEA,CAACC,IAAI,EAAElD,OAAO,KAAKE,QAAQ,CAAC+C,QAAQ,CAACC,IAAI,EAAElD,OAAO,CAAC;MAC7DmD,UAAU,EAAGnD,OAAO,IAAKE,QAAQ,CAACiD,UAAU,CAACnD,OAAO,CAAC;AACrDoD,MAAAA,QAAQ,EAAEA,CAACC,IAAI,EAAErD,OAAO,KAAKE,QAAQ,CAACkD,QAAQ,CAACC,IAAI,EAAErD,OAAO,CAAC;AAC7DsD,MAAAA,SAAS,EAAEA,CAACC,KAAK,EAAEvD,OAAO,KAAKE,QAAQ,CAACoD,SAAS,CAACC,KAAK,EAAEvD,OAAO,CAAC;AACjEiC,MAAAA,WAAW,EAAGjC,OAAO,IAAKE,QAAQ,CAAC+B,WAAW,CAACjC,OAAO;AACvD;GACF;AACH,CAAC"}