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,58 @@
1
+ import { type Throws } from '../../utils/throws';
2
+ import { LivekitReasonedError } from '../errors';
3
+ import { type DataTrackFrameInternal } from './frame';
4
+ import { DataTrackPacket } from './packet';
5
+ /** An error indicating a frame was dropped. */
6
+ export declare class DataTrackDepacketizerDropError<Reason extends DataTrackDepacketizerDropReason = DataTrackDepacketizerDropReason> extends LivekitReasonedError<Reason> {
7
+ readonly name = "DataTrackDepacketizerDropError";
8
+ reason: Reason;
9
+ reasonName: string;
10
+ frameNumber: number;
11
+ constructor(message: string, reason: Reason, frameNumber: number, options?: {
12
+ cause?: unknown;
13
+ });
14
+ static interrupted(frameNumber: number, newFrameNumber: number): DataTrackDepacketizerDropError<DataTrackDepacketizerDropReason.Interrupted>;
15
+ static unknownFrame(frameNumber: number): DataTrackDepacketizerDropError<DataTrackDepacketizerDropReason.UnknownFrame>;
16
+ static bufferFull(frameNumber: number): DataTrackDepacketizerDropError<DataTrackDepacketizerDropReason.BufferFull>;
17
+ static incomplete(frameNumber: number, receivedPackets: number, expectedPackets: number): DataTrackDepacketizerDropError<DataTrackDepacketizerDropReason.Incomplete>;
18
+ }
19
+ /** Reason why a frame was dropped. */
20
+ export declare enum DataTrackDepacketizerDropReason {
21
+ Interrupted = 0,
22
+ UnknownFrame = 1,
23
+ BufferFull = 2,
24
+ Incomplete = 3
25
+ }
26
+ type PushOptions = {
27
+ /** If true, throws `DataTrackDepacketizerDropError.interrupted` instead of logging a warning
28
+ * when a new frame arrives while the partials map is at capacity. */
29
+ throwOnInterruption: boolean;
30
+ /** Maximum number of partial frames the depacketizer will track concurrently. When a new
31
+ * frame arrives while the partials map is at capacity, the oldest partial is evicted (or
32
+ * `DataTrackDepacketizerDropError.interrupted` is thrown when `throwOnInterruption` is set).
33
+ * Defaults to 1. */
34
+ maxPartialFrames?: number;
35
+ };
36
+ export default class DataTrackDepacketizer {
37
+ /** Maximum number of packets to buffer per frame before dropping. */
38
+ static MAX_BUFFER_PACKETS: number;
39
+ /** Partial frames currently being assembled, keyed by frame number. `Map` preserves insertion
40
+ * order, so the oldest entry is the first key. */
41
+ private partials;
42
+ /** Should be repeatedly called with received {@link DataTrackPacket}s - intermediate calls
43
+ * aggregate the packet's state internally, and return null.
44
+ *
45
+ * Once this method is called with the final packet to form a frame, a new {@link DataTrackFrameInternal}
46
+ * is returned.*/
47
+ push(packet: DataTrackPacket, options?: PushOptions): Throws<DataTrackFrameInternal | null, DataTrackDepacketizerDropError>;
48
+ reset(): void;
49
+ private peekOldestPartialFrameNumber;
50
+ private frameFromSingle;
51
+ /** Begin assembling a new packet. */
52
+ private beginPartial;
53
+ /** Push to the existing partial frame. */
54
+ private pushToPartial;
55
+ /** Try to reassemble the complete frame. */
56
+ private finalize;
57
+ }
58
+ export {};
@@ -0,0 +1,30 @@
1
+ import type { CoreRoom } from '../CoreRoom';
2
+ import type { ConnectionHooks, EngineHooks, ExtensionContext, LocalParticipantApiProvider, ParticipantHooks, SyncStateProvider } from '../extensions';
3
+ import LocalDataTrack from './LocalDataTrack';
4
+ import IncomingDataTrackManager from './incoming/IncomingDataTrackManager';
5
+ import OutgoingDataTrackManager from './outgoing/OutgoingDataTrackManager';
6
+ import type { DataTrackOptions } from './outgoing/types';
7
+ /**
8
+ * Methods the `dataTracks` extension adds to the local participant.
9
+ * @experimental
10
+ */
11
+ export interface DataTrackLocalParticipantApi {
12
+ /** Publishes a data track.
13
+ *
14
+ * Returns the published data track if successful. Use {@link LocalDataTrack#tryPush}
15
+ * to send data frames on the track.
16
+ */
17
+ publishDataTrack(options: DataTrackOptions): Promise<LocalDataTrack>;
18
+ }
19
+ /**
20
+ * Data tracks: continuous unreliable streams for real-time data (`publishDataTrack`,
21
+ * `RemoteParticipant.dataTracks`, `RoomEvent.DataTrackPublished`).
22
+ * @experimental
23
+ */
24
+ export declare const dataTracks: {
25
+ key: symbol;
26
+ install(room: CoreRoom, ctx: ExtensionContext): LocalParticipantApiProvider<DataTrackLocalParticipantApi> & EngineHooks & ConnectionHooks & ParticipantHooks & SyncStateProvider & {
27
+ incoming: IncomingDataTrackManager;
28
+ outgoing: OutgoingDataTrackManager;
29
+ };
30
+ };
@@ -0,0 +1,21 @@
1
+ import type { NonSharedUint8Array } from '../../type-polyfills/non-shared-typed-arrays';
2
+ import { DataTrackExtensions } from './packet/extensions';
3
+ /** A pair of payload bytes and packet extensions which can be fed into a {@link DataTrackPacketizer}. */
4
+ export type DataTrackFrame = {
5
+ payload: NonSharedUint8Array;
6
+ userTimestamp?: bigint;
7
+ };
8
+ /** An internal representation o data track frame which contains all SFU metadata. */
9
+ export type DataTrackFrameInternal = {
10
+ payload: NonSharedUint8Array;
11
+ extensions: DataTrackExtensions;
12
+ };
13
+ export declare const DataTrackFrameInternal: {
14
+ from(frame: DataTrackFrame): {
15
+ payload: Uint8Array<ArrayBuffer>;
16
+ extensions: DataTrackExtensions;
17
+ };
18
+ /** Converts from a DataTrackFrameInternal -> DataTrackFrame. Some internal information is
19
+ * discarded like e2ee encrption extension data. */
20
+ lossyIntoFrame(frame: DataTrackFrameInternal): DataTrackFrame;
21
+ };
@@ -0,0 +1,26 @@
1
+ import { type Throws } from '../../utils/throws';
2
+ import { LivekitReasonedError } from '../errors';
3
+ export declare enum DataTrackHandleErrorReason {
4
+ Reserved = 0,
5
+ TooLarge = 1
6
+ }
7
+ export declare class DataTrackHandleError<Reason extends DataTrackHandleErrorReason = DataTrackHandleErrorReason> extends LivekitReasonedError<DataTrackHandleErrorReason> {
8
+ readonly name = "DataTrackHandleError";
9
+ reason: Reason;
10
+ reasonName: string;
11
+ constructor(message: string, reason: Reason);
12
+ isReason<R extends DataTrackHandleErrorReason>(reason: R): this is DataTrackHandleError<R>;
13
+ static tooLarge(): DataTrackHandleError<DataTrackHandleErrorReason.TooLarge>;
14
+ static reserved(value: number): DataTrackHandleError<DataTrackHandleErrorReason.Reserved>;
15
+ }
16
+ export type DataTrackHandle = number;
17
+ export declare const DataTrackHandle: {
18
+ fromNumber(raw: number): Throws<DataTrackHandle, DataTrackHandleError>;
19
+ };
20
+ /** Manage allocating new handles which don't conflict over the lifetime of the client. */
21
+ export declare class DataTrackHandleAllocator {
22
+ value: number;
23
+ /** Returns a unique track handle for the next publication, if one can be obtained. */
24
+ get(): DataTrackHandle | null;
25
+ reset(): void;
26
+ }
@@ -0,0 +1,95 @@
1
+ import type TypedEmitter from 'typed-emitter';
2
+ import type { BaseE2EEManager } from '../../../e2ee/E2eeManager';
3
+ import type { Throws } from '../../../utils/throws';
4
+ import type Participant from '../../participant/Participant';
5
+ import type RemoteParticipant from '../../participant/RemoteParticipant';
6
+ import { DataTrackDepacketizerDropError } from '../depacketizer';
7
+ import { DataTrackHandle } from '../handle';
8
+ import { type DataTrackInfo, type DataTrackSid } from '../types';
9
+ import { DataTrackSubscribeError } from './errors';
10
+ import { type EventSfuUpdateSubscription, type EventTrackAvailable, type EventTrackUnavailable } from './types';
11
+ export type DataTrackIncomingManagerCallbacks = {
12
+ /** Request sent to the SFU to update the subscription for a data track. */
13
+ sfuUpdateSubscription: (event: EventSfuUpdateSubscription) => void;
14
+ /** A track has been published by a remote participant and is available to be
15
+ * subscribed to. */
16
+ trackPublished: (event: EventTrackAvailable) => void;
17
+ /** A track has been unpublished by a remote participant and can no longer be subscribed to. */
18
+ trackUnpublished: (event: EventTrackUnavailable) => void;
19
+ };
20
+ type IncomingDataTrackManagerOptions = {
21
+ /** Provider to use for decrypting incoming frame payloads.
22
+ * If none, remote tracks using end-to-end encryption will not be available
23
+ * for subscription.
24
+ */
25
+ e2eeManager?: BaseE2EEManager;
26
+ };
27
+ declare const IncomingDataTrackManager_base: new () => TypedEmitter<DataTrackIncomingManagerCallbacks>;
28
+ export default class IncomingDataTrackManager extends IncomingDataTrackManager_base {
29
+ private e2eeManager;
30
+ /** Mapping between track SID and descriptor. */
31
+ private descriptors;
32
+ /** Mapping between subscriber handle and track SID.
33
+ *
34
+ * This is an index that allows track descriptors to be looked up
35
+ * by subscriber handle in O(1) time, to make routing incoming packets
36
+ * (a hot code path) faster.
37
+ */
38
+ private subscriptionHandles;
39
+ constructor(options?: IncomingDataTrackManagerOptions);
40
+ /** Client requested to subscribe to a data track.
41
+ *
42
+ * This is sent when the user calls {@link RemoteDataTrack.subscribe}.
43
+ *
44
+ * Only the first request to subscribe to a given track incurs meaningful overhead; subsequent
45
+ * requests simply attach an additional receiver to the broadcast channel, allowing them to consume
46
+ * frames from the existing subscription pipeline.
47
+ */
48
+ subscribeRequest(sid: DataTrackSid, signal?: AbortSignal): Promise<Throws<void, DataTrackSubscribeError>>;
49
+ /** Client requested to unsubscribe from a data track. */
50
+ unSubscribeRequest(sid: DataTrackSid): void;
51
+ /** Detach abort-signal listeners and close all downstream stream controllers for an active
52
+ * subscription. Used when the subscription is being torn down by the manager (unsubscribe,
53
+ * unpublish, or shutdown). */
54
+ private closeStreamControllers;
55
+ /** SFU notification that track publications have changed.
56
+ *
57
+ * This event is produced from both {@link JoinResponse} and {@link ParticipantUpdate}
58
+ * to provide a complete view of remote participants' track publications:
59
+ *
60
+ * - From a `JoinResponse`, it captures the initial set of tracks published when a participant joins.
61
+ * - From a `ParticipantUpdate`, it captures subsequent changes (i.e., new tracks being
62
+ * published and existing tracks unpublished).
63
+ */
64
+ receiveSfuPublicationUpdates(updates: Map<Participant['identity'], Array<DataTrackInfo>>): Promise<void>;
65
+ handleTrackPublished(publisherIdentity: Participant['identity'], info: DataTrackInfo): Promise<void>;
66
+ /**
67
+ * Detects and handles SID reassignment, which occurs when the publisher
68
+ * republishes its tracks after a full reconnect.
69
+ *
70
+ * Returns `true` if an SID reassignment occurred, `false` otherwise.
71
+ */
72
+ private handleSidReassigned;
73
+ handleTrackUnpublished(sid: DataTrackSid): void;
74
+ /** SFU notification that handles have been assigned for requested subscriptions. */
75
+ receivedSfuSubscriberHandles(
76
+ /** Mapping between track handles attached to incoming packets to the
77
+ * track SIDs they belong to. */
78
+ mapping: Map<DataTrackHandle, DataTrackSid>): void;
79
+ private registerSubscriberHandle;
80
+ /** Packet has been received over the transport. */
81
+ packetReceived(bytes: Uint8Array): Promise<Throws<void, DataTrackDepacketizerDropError>>;
82
+ /** Resend all subscription updates.
83
+ *
84
+ * This must be sent after a full reconnect to ensure the SFU knows which
85
+ * tracks are subscribed to locally.
86
+ */
87
+ resendSubscriptionUpdates(): void;
88
+ /** Called when a remote participant is disconnected so that any pending data tracks can be
89
+ * cancelled. */
90
+ handleRemoteParticipantDisconnected(remoteParticipantIdentity: RemoteParticipant['identity']): void;
91
+ /** Resets the manager, ending any subscriptions, and getting it ready for the next room
92
+ * connection. */
93
+ reset(): void;
94
+ }
95
+ export {};
@@ -0,0 +1,23 @@
1
+ import { LivekitReasonedError } from '../../errors';
2
+ export declare enum DataTrackSubscribeErrorReason {
3
+ /** The track has been unpublished and is no longer available */
4
+ Unpublished = 0,
5
+ /** Request to subscribe to data track timed-out */
6
+ Timeout = 1,
7
+ /** Cannot subscribe to data track when disconnected */
8
+ Disconnected = 2,
9
+ /** Subscription to data track cancelled by caller */
10
+ Cancelled = 4
11
+ }
12
+ export declare class DataTrackSubscribeError<Reason extends DataTrackSubscribeErrorReason = DataTrackSubscribeErrorReason> extends LivekitReasonedError<Reason> {
13
+ readonly name = "DataTrackSubscribeError";
14
+ reason: Reason;
15
+ reasonName: string;
16
+ constructor(message: string, reason: Reason, options?: {
17
+ cause?: unknown;
18
+ });
19
+ static unpublished(): DataTrackSubscribeError<DataTrackSubscribeErrorReason.Unpublished>;
20
+ static timeout(): DataTrackSubscribeError<DataTrackSubscribeErrorReason.Timeout>;
21
+ static disconnected(): DataTrackSubscribeError<DataTrackSubscribeErrorReason.Disconnected>;
22
+ static cancelled(): DataTrackSubscribeError<DataTrackSubscribeErrorReason.Cancelled>;
23
+ }
@@ -0,0 +1,40 @@
1
+ import type { BaseE2EEManager } from '../../../e2ee/E2eeManager';
2
+ import type { Throws } from '../../../utils/throws';
3
+ import { DataTrackDepacketizerDropError } from '../depacketizer';
4
+ import type { DataTrackFrameInternal } from '../frame';
5
+ import { DataTrackPacket } from '../packet';
6
+ import { type DataTrackInfo, type RemoteDataTrackPipelineOptions } from '../types';
7
+ /**
8
+ * Options for creating a {@link IncomingDataTrackPipeline}.
9
+ */
10
+ type Options = {
11
+ info: DataTrackInfo;
12
+ publisherIdentity: string;
13
+ e2eeManager: BaseE2EEManager | null;
14
+ pipelineOptions?: RemoteDataTrackPipelineOptions;
15
+ };
16
+ /**
17
+ * Pipeline for an individual data track subscription.
18
+ */
19
+ export default class IncomingDataTrackPipeline {
20
+ private publisherIdentity;
21
+ private e2eeManager;
22
+ private depacketizer;
23
+ private options;
24
+ /**
25
+ * Creates a new pipeline with the given options.
26
+ */
27
+ constructor(options: Options);
28
+ updateE2eeManager(e2eeManager: BaseE2EEManager | null): void;
29
+ setOptions(options: RemoteDataTrackPipelineOptions): void;
30
+ processPacket(packet: DataTrackPacket): Promise<Throws<DataTrackFrameInternal | null, DataTrackDepacketizerDropError>>;
31
+ /**
32
+ * Depacketize the given frame, log if a drop occurs.
33
+ */
34
+ private depacketize;
35
+ /**
36
+ * Decrypt the frame's payload if E2EE is enabled for this track.
37
+ */
38
+ private decryptIfNeeded;
39
+ }
40
+ export {};
@@ -0,0 +1,19 @@
1
+ import type Participant from '../../participant/Participant';
2
+ import type RemoteDataTrack from '../RemoteDataTrack';
3
+ import { type DataTrackSid } from '../types';
4
+ /** Request sent to the SFU to update the subscription for a data track. */
5
+ export type EventSfuUpdateSubscription = {
6
+ /** Identifier of the affected track. */
7
+ sid: DataTrackSid;
8
+ /** Whether to subscribe or unsubscribe. */
9
+ subscribe: boolean;
10
+ };
11
+ /** A track has been published by a remote participant and is available to be subscribed to. */
12
+ export type EventTrackAvailable = {
13
+ track: RemoteDataTrack;
14
+ };
15
+ /** A track has been unpublished by a remote participant and can no longer be subscribed to. */
16
+ export type EventTrackUnavailable = {
17
+ sid: DataTrackSid;
18
+ publisherIdentity: Participant['identity'];
19
+ };
@@ -0,0 +1,64 @@
1
+ import type TypedEmitter from 'typed-emitter';
2
+ import type { BaseE2EEManager } from '../../../e2ee/E2eeManager';
3
+ import { Future } from '../../utils';
4
+ import { DataTrackHandle } from '../handle';
5
+ import { type DataTrackInfo } from '../types';
6
+ import { DataTrackPublishError } from './errors';
7
+ import DataTrackOutgoingPipeline from './pipeline';
8
+ import { type EventPacketAvailable, type EventPacketsFlushedChange, type EventSfuPublishRequest, type EventSfuUnpublishRequest, type EventTrackPublished, type EventTrackUnpublished } from './types';
9
+ export type PendingDescriptor = {
10
+ type: 'pending';
11
+ /** Resolves when the descriptor is fully published. */
12
+ completionFuture: Future<void, DataTrackPublishError>;
13
+ };
14
+ export type ActiveDescriptor = {
15
+ type: 'active';
16
+ info: DataTrackInfo;
17
+ publishState: 'published' | 'republishing' | 'unpublished';
18
+ pipeline: DataTrackOutgoingPipeline;
19
+ /** Resolves when the descriptor is unpublished. */
20
+ unpublishingFuture: Future<void, never>;
21
+ };
22
+ export type Descriptor = PendingDescriptor | ActiveDescriptor;
23
+ export declare const Descriptor: {
24
+ pending(): PendingDescriptor;
25
+ active(info: DataTrackInfo, e2eeManager: BaseE2EEManager | null): ActiveDescriptor;
26
+ };
27
+ export type DataTrackOutgoingManagerCallbacks = {
28
+ /** Request sent to the SFU to publish a track. */
29
+ sfuPublishRequest: (event: EventSfuPublishRequest) => void;
30
+ /** Request sent to the SFU to unpublish a track. */
31
+ sfuUnpublishRequest: (event: EventSfuUnpublishRequest) => void;
32
+ /** A serialized packet is ready to be sent over the transport. */
33
+ packetAvailable: (event: EventPacketAvailable) => void;
34
+ /** A new {@link LocalDataTrack} has been published */
35
+ trackPublished: (event: EventTrackPublished) => void;
36
+ /** A {@link LocalDataTrack} has been unpublished */
37
+ trackUnpublished: (event: EventTrackUnpublished) => void;
38
+ /** A {@link LocalDataTrack} has had all of its in flight packets sent via the rtc data channel. */
39
+ packetsFlushedChange: (event: EventPacketsFlushedChange) => void;
40
+ /** The manager has been reset and all state has been cleared in preparation for the next room
41
+ * connection. */
42
+ reset: () => void;
43
+ };
44
+ type OutgoingDataTrackManagerOptions = {
45
+ /**
46
+ * Provider to use for encrypting outgoing frame payloads.
47
+ *
48
+ * If null, end-to-end encryption will be disabled for all published tracks.
49
+ */
50
+ e2eeManager?: BaseE2EEManager;
51
+ };
52
+ declare const OutgoingDataTrackManager_base: new () => TypedEmitter<DataTrackOutgoingManagerCallbacks>;
53
+ export default class OutgoingDataTrackManager extends OutgoingDataTrackManager_base {
54
+ private e2eeManager;
55
+ private handleAllocator;
56
+ private descriptors;
57
+ /** Number of packets for each data track which have been emitted via the `packetAvailable` event
58
+ * and which have not yet been sent via the rtc data channel yet. Once this goes to 0, then
59
+ * all in flight packets have been delivered, and the data tracks is "flushed". */
60
+ private inFlightPacketCounter;
61
+ constructor(options?: OutgoingDataTrackManagerOptions);
62
+ static withDescriptors(descriptors: Map<DataTrackHandle, Descriptor>): OutgoingDataTrackManager;
63
+ }
64
+ export {};
@@ -0,0 +1,73 @@
1
+ import { LivekitReasonedError } from '../../errors';
2
+ import { DataTrackPacketizerError } from '../packetizer';
3
+ export declare enum DataTrackPublishErrorReason {
4
+ /**
5
+ * Local participant does not have permission to publish data tracks.
6
+ *
7
+ * Ensure the participant's token contains the `canPublishData` grant.
8
+ */
9
+ NotAllowed = 0,
10
+ /** A track with the same name is already published by the local participant. */
11
+ DuplicateName = 1,
12
+ /** Request to publish the track took long to complete. */
13
+ Timeout = 2,
14
+ /** No additional data tracks can be published by the local participant. */
15
+ LimitReached = 3,
16
+ /** Cannot publish data track when the room is disconnected. */
17
+ Disconnected = 4,
18
+ Cancelled = 5,
19
+ /** The name requested is not able to be used when creating the data track. */
20
+ InvalidName = 6,
21
+ /** There was an error publishing, but it was not something that could be sorted into a known
22
+ * category. */
23
+ Unknown = 7
24
+ }
25
+ export declare class DataTrackPublishError<Reason extends DataTrackPublishErrorReason = DataTrackPublishErrorReason> extends LivekitReasonedError<Reason> {
26
+ readonly name = "DataTrackPublishError";
27
+ reason: Reason;
28
+ reasonName: string;
29
+ /** Underling message from the SFU, if one was provided */
30
+ rawMessage?: string;
31
+ constructor(message: string, reason: Reason, options?: {
32
+ rawMessage?: string;
33
+ cause?: unknown;
34
+ });
35
+ static notAllowed(rawMessage?: string): DataTrackPublishError<DataTrackPublishErrorReason.NotAllowed>;
36
+ static duplicateName(rawMessage?: string): DataTrackPublishError<DataTrackPublishErrorReason.DuplicateName>;
37
+ static invalidName(rawMessage?: string): DataTrackPublishError<DataTrackPublishErrorReason.InvalidName>;
38
+ static timeout(): DataTrackPublishError<DataTrackPublishErrorReason.Timeout>;
39
+ static limitReached(rawMessage?: string): DataTrackPublishError<DataTrackPublishErrorReason.LimitReached>;
40
+ static unknown(reason: number, message: string): DataTrackPublishError<DataTrackPublishErrorReason.Unknown>;
41
+ static disconnected(): DataTrackPublishError<DataTrackPublishErrorReason.Disconnected>;
42
+ static cancelled(): DataTrackPublishError<DataTrackPublishErrorReason.Cancelled>;
43
+ }
44
+ export declare enum DataTrackPushFrameErrorReason {
45
+ /** Track is no longer published. */
46
+ TrackUnpublished = 0,
47
+ /** Frame was dropped. */
48
+ Dropped = 1
49
+ }
50
+ export declare class DataTrackPushFrameError<Reason extends DataTrackPushFrameErrorReason = DataTrackPushFrameErrorReason> extends LivekitReasonedError<Reason> {
51
+ readonly name = "DataTrackPushFrameError";
52
+ reason: Reason;
53
+ reasonName: string;
54
+ constructor(message: string, reason: Reason, options?: {
55
+ cause?: unknown;
56
+ });
57
+ static trackUnpublished(): DataTrackPushFrameError<DataTrackPushFrameErrorReason.TrackUnpublished>;
58
+ static dropped(cause?: unknown): DataTrackPushFrameError<DataTrackPushFrameErrorReason.Dropped>;
59
+ }
60
+ export declare enum DataTrackOutgoingPipelineErrorReason {
61
+ Packetizer = 0,
62
+ Encryption = 1
63
+ }
64
+ export declare class DataTrackOutgoingPipelineError<Reason extends DataTrackOutgoingPipelineErrorReason = DataTrackOutgoingPipelineErrorReason> extends LivekitReasonedError<Reason> {
65
+ readonly name = "DataTrackOutgoingPipelineError";
66
+ reason: Reason;
67
+ reasonName: string;
68
+ constructor(message: string, reason: Reason, options?: {
69
+ cause?: unknown;
70
+ });
71
+ static packetizer(cause: DataTrackPacketizerError): DataTrackOutgoingPipelineError<DataTrackOutgoingPipelineErrorReason.Packetizer>;
72
+ static encryption(cause: unknown): DataTrackOutgoingPipelineError<DataTrackOutgoingPipelineErrorReason.Encryption>;
73
+ }
@@ -0,0 +1,22 @@
1
+ import type { BaseE2EEManager } from '../../../e2ee/E2eeManager';
2
+ import { type Throws } from '../../../utils/throws';
3
+ import { type DataTrackFrameInternal } from '../frame';
4
+ import { DataTrackPacket } from '../packet';
5
+ import type { DataTrackInfo } from '../types';
6
+ import { DataTrackOutgoingPipelineError, DataTrackOutgoingPipelineErrorReason } from './errors';
7
+ type Options = {
8
+ info: DataTrackInfo;
9
+ e2eeManager: BaseE2EEManager | null;
10
+ };
11
+ /** Processes outgoing frames into final packets for distribution to the SFU. */
12
+ export default class DataTrackOutgoingPipeline {
13
+ private e2eeManager;
14
+ private packetizer;
15
+ /** Maximum transmission unit (MTU) of the transport. */
16
+ private static TRANSPORT_MTU_BYTES;
17
+ constructor(options: Options);
18
+ updateE2eeManager(e2eeManager: BaseE2EEManager | null): void;
19
+ processFrame(frame: DataTrackFrameInternal): Throws<AsyncGenerator<DataTrackPacket>, DataTrackOutgoingPipelineError>;
20
+ encryptIfNeeded(frame: DataTrackFrameInternal): Promise<Throws<DataTrackFrameInternal, DataTrackOutgoingPipelineError<DataTrackOutgoingPipelineErrorReason.Encryption>>>;
21
+ }
22
+ export {};
@@ -0,0 +1,47 @@
1
+ import type { NonSharedUint8Array } from '../../../type-polyfills/non-shared-typed-arrays';
2
+ import type LocalDataTrack from '../LocalDataTrack';
3
+ import { type DataTrackHandle } from '../handle';
4
+ import { type DataTrackInfo, type DataTrackSid } from '../types';
5
+ import { type DataTrackPublishError, type DataTrackPublishErrorReason } from './errors';
6
+ /** Options for publishing a data track. */
7
+ export type DataTrackOptions = {
8
+ name: string;
9
+ };
10
+ /** Encodes whether a data track publish request to the SFU has been successful or not. */
11
+ export type SfuPublishResponseResult = {
12
+ type: 'ok';
13
+ data: DataTrackInfo;
14
+ } | {
15
+ type: 'error';
16
+ error: DataTrackPublishError<DataTrackPublishErrorReason.NotAllowed> | DataTrackPublishError<DataTrackPublishErrorReason.DuplicateName> | DataTrackPublishError<DataTrackPublishErrorReason.InvalidName> | DataTrackPublishError<DataTrackPublishErrorReason.LimitReached> | DataTrackPublishError<DataTrackPublishErrorReason.Unknown>;
17
+ };
18
+ /** Request sent to the SFU to publish a track. */
19
+ export type EventSfuPublishRequest = {
20
+ handle: DataTrackHandle;
21
+ name: string;
22
+ usesE2ee: boolean;
23
+ };
24
+ /** Request sent to the SFU to unpublish a track. */
25
+ export type EventSfuUnpublishRequest = {
26
+ handle: DataTrackHandle;
27
+ };
28
+ /** A serialized packet is ready to be sent over the transport. */
29
+ export type EventPacketAvailable = {
30
+ /** The handle associated with the data track which this packet bytes belong to. */
31
+ handle: DataTrackHandle;
32
+ bytes: NonSharedUint8Array;
33
+ };
34
+ /** A track has been created by a local participant and is available to be
35
+ * subscribed to. */
36
+ export type EventTrackPublished = {
37
+ track: LocalDataTrack;
38
+ };
39
+ /** A track has been unpublished by a remote participant and can no longer be subscribed to. */
40
+ export type EventTrackUnpublished = {
41
+ sid: DataTrackSid;
42
+ };
43
+ /** A track has had all of its in flight packets sent via the rtc data channel. */
44
+ export type EventPacketsFlushedChange = {
45
+ handle: DataTrackHandle;
46
+ isFlushed: boolean;
47
+ };
@@ -0,0 +1,19 @@
1
+ export declare const U8_LENGTH_BYTES = 1;
2
+ export declare const U16_LENGTH_BYTES = 2;
3
+ export declare const U32_LENGTH_BYTES = 4;
4
+ export declare const U64_LENGTH_BYTES = 8;
5
+ export declare const SUPPORTED_VERSION = 0;
6
+ export declare const BASE_HEADER_LEN = 12;
7
+ export declare const VERSION_SHIFT = 5;
8
+ export declare const VERSION_MASK = 7;
9
+ export declare const FRAME_MARKER_SHIFT = 3;
10
+ export declare const FRAME_MARKER_MASK = 3;
11
+ export declare const FRAME_MARKER_START = 2;
12
+ export declare const FRAME_MARKER_FINAL = 1;
13
+ export declare const FRAME_MARKER_INTER = 0;
14
+ export declare const FRAME_MARKER_SINGLE = 3;
15
+ export declare const EXT_WORDS_INDICATOR_SIZE = 2;
16
+ export declare const EXT_FLAG_SHIFT = 2;
17
+ export declare const EXT_FLAG_MASK = 1;
18
+ export declare const EXT_MARKER_LEN = 4;
19
+ export declare const EXT_TAG_PADDING = 0;
@@ -0,0 +1,39 @@
1
+ import { LivekitReasonedError } from '../../errors';
2
+ import type { DataTrackHandleError } from '../handle';
3
+ export declare enum DataTrackDeserializeErrorReason {
4
+ TooShort = 0,
5
+ HeaderOverrun = 1,
6
+ MissingExtWords = 2,
7
+ UnsupportedVersion = 3,
8
+ InvalidHandle = 4,
9
+ MalformedExt = 5
10
+ }
11
+ export declare class DataTrackDeserializeError<Reason extends DataTrackDeserializeErrorReason = DataTrackDeserializeErrorReason> extends LivekitReasonedError<DataTrackDeserializeErrorReason> {
12
+ readonly name = "DataTrackDeserializeError";
13
+ reason: Reason;
14
+ reasonName: string;
15
+ cause?: Reason extends DataTrackDeserializeErrorReason.InvalidHandle ? DataTrackHandleError : never;
16
+ constructor(message: string, reason: Reason, options?: {
17
+ cause?: unknown;
18
+ });
19
+ static tooShort(): DataTrackDeserializeError<DataTrackDeserializeErrorReason.TooShort>;
20
+ static headerOverrun(): DataTrackDeserializeError<DataTrackDeserializeErrorReason.HeaderOverrun>;
21
+ static missingExtWords(): DataTrackDeserializeError<DataTrackDeserializeErrorReason.MissingExtWords>;
22
+ static unsupportedVersion(version: number): DataTrackDeserializeError<DataTrackDeserializeErrorReason.UnsupportedVersion>;
23
+ static invalidHandle(cause: DataTrackHandleError): DataTrackDeserializeError<DataTrackDeserializeErrorReason.InvalidHandle>;
24
+ static malformedExt(tag: number): DataTrackDeserializeError<DataTrackDeserializeErrorReason.MalformedExt>;
25
+ }
26
+ export declare enum DataTrackSerializeErrorReason {
27
+ TooSmallForHeader = 0,
28
+ TooSmallForPayload = 1
29
+ }
30
+ export declare class DataTrackSerializeError<Reason extends DataTrackSerializeErrorReason = DataTrackSerializeErrorReason> extends LivekitReasonedError<DataTrackSerializeErrorReason> {
31
+ readonly name = "DataTrackSerializeError";
32
+ reason: Reason;
33
+ reasonName: string;
34
+ constructor(message: string, reason: Reason, options?: {
35
+ cause?: unknown;
36
+ });
37
+ static tooSmallForHeader(): DataTrackSerializeError<DataTrackSerializeErrorReason.TooSmallForHeader>;
38
+ static tooSmallForPayload(): DataTrackSerializeError<DataTrackSerializeErrorReason.TooSmallForPayload>;
39
+ }
@@ -0,0 +1,68 @@
1
+ import type { NonSharedUint8Array } from '../../../type-polyfills/non-shared-typed-arrays';
2
+ import { type Throws } from '../../../utils/throws';
3
+ import { DataTrackDeserializeError, DataTrackDeserializeErrorReason } from './errors';
4
+ import Serializable from './serializable';
5
+ export declare enum DataTrackExtensionTag {
6
+ UserTimestamp = 2,
7
+ E2ee = 1
8
+ }
9
+ declare abstract class DataTrackExtension extends Serializable {
10
+ static tag: DataTrackExtensionTag;
11
+ static lengthBytes: number;
12
+ }
13
+ export declare class DataTrackUserTimestampExtension extends DataTrackExtension {
14
+ static tag: DataTrackExtensionTag;
15
+ static lengthBytes: number;
16
+ timestamp: bigint;
17
+ constructor(timestamp: bigint);
18
+ toBinaryLengthBytes(): number;
19
+ toBinaryInto(dataView: DataView): Throws<number, never>;
20
+ toJSON(): {
21
+ tag: number;
22
+ lengthBytes: number;
23
+ timestamp: bigint;
24
+ };
25
+ }
26
+ export declare class DataTrackE2eeExtension extends DataTrackExtension {
27
+ static tag: DataTrackExtensionTag;
28
+ static lengthBytes: number;
29
+ keyIndex: number;
30
+ iv: NonSharedUint8Array;
31
+ constructor(keyIndex: number, iv: NonSharedUint8Array);
32
+ toBinaryLengthBytes(): number;
33
+ toBinaryInto(dataView: DataView): Throws<number, never>;
34
+ toJSON(): {
35
+ tag: number;
36
+ lengthBytes: number;
37
+ keyIndex: number;
38
+ iv: Uint8Array<ArrayBuffer>;
39
+ };
40
+ }
41
+ export declare class DataTrackExtensions extends Serializable {
42
+ userTimestamp?: DataTrackUserTimestampExtension;
43
+ e2ee?: DataTrackE2eeExtension;
44
+ constructor(opts?: {
45
+ userTimestamp?: DataTrackUserTimestampExtension;
46
+ e2ee?: DataTrackE2eeExtension;
47
+ });
48
+ toBinaryLengthBytes(): number;
49
+ toBinaryInto(dataView: DataView): Throws<number, never>;
50
+ static fromBinary<Input extends DataView | ArrayBuffer | Uint8Array>(input: Input): Throws<[
51
+ extensions: DataTrackExtensions,
52
+ byteLength: number
53
+ ], DataTrackDeserializeError<DataTrackDeserializeErrorReason.MalformedExt>>;
54
+ toJSON(): {
55
+ userTimestamp: {
56
+ tag: number;
57
+ lengthBytes: number;
58
+ timestamp: bigint;
59
+ } | null;
60
+ e2ee: {
61
+ tag: number;
62
+ lengthBytes: number;
63
+ keyIndex: number;
64
+ iv: Uint8Array<ArrayBuffer>;
65
+ } | null;
66
+ };
67
+ }
68
+ export {};