livekit-client 2.23.0 → 2.24.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (869) hide show
  1. package/README.md +48 -32
  2. package/dist/core/_virtual/_rollupPluginBabelHelpers.mjs +48 -0
  3. package/dist/core/_virtual/_rollupPluginBabelHelpers.mjs.map +1 -0
  4. package/dist/core/api/SignalClient.mjs +1212 -0
  5. package/dist/core/api/SignalClient.mjs.map +1 -0
  6. package/dist/core/api/SignalClientStateMachine.mjs +115 -0
  7. package/dist/core/api/SignalClientStateMachine.mjs.map +1 -0
  8. package/dist/core/api/WebSocketStream.mjs +146 -0
  9. package/dist/core/api/WebSocketStream.mjs.map +1 -0
  10. package/dist/core/api/utils.mjs +66 -0
  11. package/dist/core/api/utils.mjs.map +1 -0
  12. package/dist/core/connectionHelper/ConnectionCheck.mjs +89 -0
  13. package/dist/core/connectionHelper/ConnectionCheck.mjs.map +1 -0
  14. package/dist/core/connectionHelper/checks/Checker.mjs +146 -0
  15. package/dist/core/connectionHelper/checks/Checker.mjs.map +1 -0
  16. package/dist/core/connectionHelper/checks/cloudRegion.mjs +82 -0
  17. package/dist/core/connectionHelper/checks/cloudRegion.mjs.map +1 -0
  18. package/dist/core/connectionHelper/checks/connectionProtocol.mjs +111 -0
  19. package/dist/core/connectionHelper/checks/connectionProtocol.mjs.map +1 -0
  20. package/dist/core/connectionHelper/checks/publishAudio.mjs +35 -0
  21. package/dist/core/connectionHelper/checks/publishAudio.mjs.map +1 -0
  22. package/dist/core/connectionHelper/checks/publishVideo.mjs +82 -0
  23. package/dist/core/connectionHelper/checks/publishVideo.mjs.map +1 -0
  24. package/dist/core/connectionHelper/checks/reconnect.mjs +37 -0
  25. package/dist/core/connectionHelper/checks/reconnect.mjs.map +1 -0
  26. package/dist/core/connectionHelper/checks/turn.mjs +56 -0
  27. package/dist/core/connectionHelper/checks/turn.mjs.map +1 -0
  28. package/dist/core/connectionHelper/checks/webrtc.mjs +73 -0
  29. package/dist/core/connectionHelper/checks/webrtc.mjs.map +1 -0
  30. package/dist/core/connectionHelper/checks/websocket.mjs +47 -0
  31. package/dist/core/connectionHelper/checks/websocket.mjs.map +1 -0
  32. package/dist/core/core.mjs +1 -0
  33. package/dist/core/core.mjs.map +1 -0
  34. package/dist/core/e2ee/E2eeManager.mjs +603 -0
  35. package/dist/core/e2ee/E2eeManager.mjs.map +1 -0
  36. package/dist/core/e2ee/KeyProvider.mjs +95 -0
  37. package/dist/core/e2ee/KeyProvider.mjs.map +1 -0
  38. package/dist/core/e2ee/constants.mjs +19 -0
  39. package/dist/core/e2ee/constants.mjs.map +1 -0
  40. package/dist/core/e2ee/errors.mjs +15 -0
  41. package/dist/core/e2ee/errors.mjs.map +1 -0
  42. package/dist/core/e2ee/events.mjs +24 -0
  43. package/dist/core/e2ee/events.mjs.map +1 -0
  44. package/dist/core/e2ee/extension.mjs +70 -0
  45. package/dist/core/e2ee/extension.mjs.map +1 -0
  46. package/dist/core/e2ee/utils.mjs +168 -0
  47. package/dist/core/e2ee/utils.mjs.map +1 -0
  48. package/dist/core/frameMetadata/FrameMetadataManager.mjs +205 -0
  49. package/dist/core/frameMetadata/FrameMetadataManager.mjs.map +1 -0
  50. package/dist/core/frameMetadata/extension.mjs +17 -0
  51. package/dist/core/frameMetadata/extension.mjs.map +1 -0
  52. package/dist/core/frameMetadata/utils.mjs +42 -0
  53. package/dist/core/frameMetadata/utils.mjs.map +1 -0
  54. package/dist/core/logger.mjs +111 -0
  55. package/dist/core/logger.mjs.map +1 -0
  56. package/dist/core/package.json.mjs +1 -0
  57. package/dist/core/package.json.mjs.map +1 -0
  58. package/dist/core/room/BackOffStrategy.mjs +60 -0
  59. package/dist/core/room/BackOffStrategy.mjs.map +1 -0
  60. package/dist/core/room/CoreRoom.mjs +2279 -0
  61. package/dist/core/room/CoreRoom.mjs.map +1 -0
  62. package/dist/core/room/DefaultReconnectPolicy.mjs +23 -0
  63. package/dist/core/room/DefaultReconnectPolicy.mjs.map +1 -0
  64. package/dist/core/room/DeviceManager.mjs +92 -0
  65. package/dist/core/room/DeviceManager.mjs.map +1 -0
  66. package/dist/core/room/PCTransport.mjs +1110 -0
  67. package/dist/core/room/PCTransport.mjs.map +1 -0
  68. package/dist/core/room/PCTransportManager.mjs +360 -0
  69. package/dist/core/room/PCTransportManager.mjs.map +1 -0
  70. package/dist/core/room/RTCEngine.mjs +1830 -0
  71. package/dist/core/room/RTCEngine.mjs.map +1 -0
  72. package/dist/core/room/RegionUrlProvider.mjs +194 -0
  73. package/dist/core/room/RegionUrlProvider.mjs.map +1 -0
  74. package/dist/core/room/attribute-typings.mjs +24 -0
  75. package/dist/core/room/attribute-typings.mjs.map +1 -0
  76. package/dist/core/room/createRoom.mjs +19 -0
  77. package/dist/core/room/createRoom.mjs.map +1 -0
  78. package/dist/core/room/data-channel/DataChannelManager.mjs +188 -0
  79. package/dist/core/room/data-channel/DataChannelManager.mjs.map +1 -0
  80. package/dist/core/room/data-channel/FlowControlledDataChannel.mjs +185 -0
  81. package/dist/core/room/data-channel/FlowControlledDataChannel.mjs.map +1 -0
  82. package/dist/core/room/data-channel/LossyDataChannel.mjs +99 -0
  83. package/dist/core/room/data-channel/LossyDataChannel.mjs.map +1 -0
  84. package/dist/core/room/data-channel/ReliableDataChannel.mjs +150 -0
  85. package/dist/core/room/data-channel/ReliableDataChannel.mjs.map +1 -0
  86. package/dist/core/room/data-channel/types.mjs +22 -0
  87. package/dist/core/room/data-channel/types.mjs.map +1 -0
  88. package/dist/core/room/data-stream/compression.mjs +68 -0
  89. package/dist/core/room/data-stream/compression.mjs.map +1 -0
  90. package/dist/core/room/data-stream/constants.mjs +26 -0
  91. package/dist/core/room/data-stream/constants.mjs.map +1 -0
  92. package/dist/core/room/data-stream/extension.mjs +42 -0
  93. package/dist/core/room/data-stream/extension.mjs.map +1 -0
  94. package/dist/core/room/data-stream/incoming/IncomingDataStreamManager.mjs +500 -0
  95. package/dist/core/room/data-stream/incoming/IncomingDataStreamManager.mjs.map +1 -0
  96. package/dist/core/room/data-stream/incoming/StreamReader.mjs +279 -0
  97. package/dist/core/room/data-stream/incoming/StreamReader.mjs.map +1 -0
  98. package/dist/core/room/data-stream/outgoing/OutgoingDataStreamManager.mjs +543 -0
  99. package/dist/core/room/data-stream/outgoing/OutgoingDataStreamManager.mjs.map +1 -0
  100. package/dist/core/room/data-stream/outgoing/StreamWriter.mjs +21 -0
  101. package/dist/core/room/data-stream/outgoing/StreamWriter.mjs.map +1 -0
  102. package/dist/core/room/data-stream/outgoing/header-utils.mjs +53 -0
  103. package/dist/core/room/data-stream/outgoing/header-utils.mjs.map +1 -0
  104. package/dist/core/room/data-track/LocalDataTrack.mjs +146 -0
  105. package/dist/core/room/data-track/LocalDataTrack.mjs.map +1 -0
  106. package/dist/core/room/data-track/RemoteDataTrack.mjs +51 -0
  107. package/dist/core/room/data-track/RemoteDataTrack.mjs.map +1 -0
  108. package/dist/core/room/data-track/depacketizer.mjs +193 -0
  109. package/dist/core/room/data-track/depacketizer.mjs.map +1 -0
  110. package/dist/core/room/data-track/extension.mjs +154 -0
  111. package/dist/core/room/data-track/extension.mjs.map +1 -0
  112. package/dist/core/room/data-track/frame.mjs +19 -0
  113. package/dist/core/room/data-track/frame.mjs.map +1 -0
  114. package/dist/core/room/data-track/handle.mjs +50 -0
  115. package/dist/core/room/data-track/handle.mjs.map +1 -0
  116. package/dist/core/room/data-track/incoming/IncomingDataTrackManager.mjs +618 -0
  117. package/dist/core/room/data-track/incoming/IncomingDataTrackManager.mjs.map +1 -0
  118. package/dist/core/room/data-track/incoming/errors.mjs +32 -0
  119. package/dist/core/room/data-track/incoming/errors.mjs.map +1 -0
  120. package/dist/core/room/data-track/incoming/pipeline.mjs +85 -0
  121. package/dist/core/room/data-track/incoming/pipeline.mjs.map +1 -0
  122. package/dist/core/room/data-track/outgoing/OutgoingDataTrackManager.mjs +351 -0
  123. package/dist/core/room/data-track/outgoing/OutgoingDataTrackManager.mjs.map +1 -0
  124. package/dist/core/room/data-track/outgoing/errors.mjs +114 -0
  125. package/dist/core/room/data-track/outgoing/errors.mjs.map +1 -0
  126. package/dist/core/room/data-track/outgoing/pipeline.mjs +41 -0
  127. package/dist/core/room/data-track/outgoing/pipeline.mjs.map +1 -0
  128. package/dist/core/room/data-track/packet/constants.mjs +21 -0
  129. package/dist/core/room/data-track/packet/constants.mjs.map +1 -0
  130. package/dist/core/room/data-track/packet/errors.mjs +56 -0
  131. package/dist/core/room/data-track/packet/errors.mjs.map +1 -0
  132. package/dist/core/room/data-track/packet/extensions.mjs +172 -0
  133. package/dist/core/room/data-track/packet/extensions.mjs.map +1 -0
  134. package/dist/core/room/data-track/packet/index.mjs +242 -0
  135. package/dist/core/room/data-track/packet/index.mjs.map +1 -0
  136. package/dist/core/room/data-track/packet/serializable.mjs +15 -0
  137. package/dist/core/room/data-track/packet/serializable.mjs.map +1 -0
  138. package/dist/core/room/data-track/packetizer.mjs +77 -0
  139. package/dist/core/room/data-track/packetizer.mjs.map +1 -0
  140. package/dist/core/room/data-track/track-interfaces.mjs +2 -0
  141. package/dist/core/room/data-track/track-interfaces.mjs.map +1 -0
  142. package/dist/core/room/data-track/types.mjs +18 -0
  143. package/dist/core/room/data-track/types.mjs.map +1 -0
  144. package/dist/core/room/data-track/utils.mjs +149 -0
  145. package/dist/core/room/data-track/utils.mjs.map +1 -0
  146. package/dist/core/room/debounce.mjs +97 -0
  147. package/dist/core/room/debounce.mjs.map +1 -0
  148. package/dist/core/room/defaults.mjs +34 -0
  149. package/dist/core/room/defaults.mjs.map +1 -0
  150. package/dist/core/room/errors.mjs +208 -0
  151. package/dist/core/room/errors.mjs.map +1 -0
  152. package/dist/core/room/events.mjs +643 -0
  153. package/dist/core/room/events.mjs.map +1 -0
  154. package/dist/core/room/extensions.mjs +48 -0
  155. package/dist/core/room/extensions.mjs.map +1 -0
  156. package/dist/core/room/participant/LocalParticipant.mjs +1324 -0
  157. package/dist/core/room/participant/LocalParticipant.mjs.map +1 -0
  158. package/dist/core/room/participant/Participant.mjs +300 -0
  159. package/dist/core/room/participant/Participant.mjs.map +1 -0
  160. package/dist/core/room/participant/ParticipantTrackPermission.mjs +12 -0
  161. package/dist/core/room/participant/ParticipantTrackPermission.mjs.map +1 -0
  162. package/dist/core/room/participant/RemoteParticipant.mjs +287 -0
  163. package/dist/core/room/participant/RemoteParticipant.mjs.map +1 -0
  164. package/dist/core/room/participant/publishUtils.mjs +356 -0
  165. package/dist/core/room/participant/publishUtils.mjs.map +1 -0
  166. package/dist/core/room/rpc/client/RpcClientManager.mjs +216 -0
  167. package/dist/core/room/rpc/client/RpcClientManager.mjs.map +1 -0
  168. package/dist/core/room/rpc/extension.mjs +82 -0
  169. package/dist/core/room/rpc/extension.mjs.map +1 -0
  170. package/dist/core/room/rpc/server/RpcServerManager.mjs +186 -0
  171. package/dist/core/room/rpc/server/RpcServerManager.mjs.map +1 -0
  172. package/dist/core/room/rpc/utils.mjs +148 -0
  173. package/dist/core/room/rpc/utils.mjs.map +1 -0
  174. package/dist/core/room/simulated-participants/extension.mjs +105 -0
  175. package/dist/core/room/simulated-participants/extension.mjs.map +1 -0
  176. package/dist/core/room/stats.mjs +19 -0
  177. package/dist/core/room/stats.mjs.map +1 -0
  178. package/dist/core/room/statsSummary.mjs +165 -0
  179. package/dist/core/room/statsSummary.mjs.map +1 -0
  180. package/dist/core/room/timers.mjs +20 -0
  181. package/dist/core/room/timers.mjs.map +1 -0
  182. package/dist/core/room/token-source/TokenSource.mjs +230 -0
  183. package/dist/core/room/token-source/TokenSource.mjs.map +1 -0
  184. package/dist/core/room/token-source/types.mjs +18 -0
  185. package/dist/core/room/token-source/types.mjs.map +1 -0
  186. package/dist/core/room/token-source/utils.mjs +76 -0
  187. package/dist/core/room/token-source/utils.mjs.map +1 -0
  188. package/dist/core/room/track/FrameMetadataExtractor.mjs +36 -0
  189. package/dist/core/room/track/FrameMetadataExtractor.mjs.map +1 -0
  190. package/dist/core/room/track/LocalAudioTrack.mjs +327 -0
  191. package/dist/core/room/track/LocalAudioTrack.mjs.map +1 -0
  192. package/dist/core/room/track/LocalTrack.mjs +694 -0
  193. package/dist/core/room/track/LocalTrack.mjs.map +1 -0
  194. package/dist/core/room/track/LocalTrackPublication.mjs +111 -0
  195. package/dist/core/room/track/LocalTrackPublication.mjs.map +1 -0
  196. package/dist/core/room/track/LocalVideoTrack.mjs +810 -0
  197. package/dist/core/room/track/LocalVideoTrack.mjs.map +1 -0
  198. package/dist/core/room/track/RemoteAudioTrack.mjs +245 -0
  199. package/dist/core/room/track/RemoteAudioTrack.mjs.map +1 -0
  200. package/dist/core/room/track/RemoteTrack.mjs +143 -0
  201. package/dist/core/room/track/RemoteTrack.mjs.map +1 -0
  202. package/dist/core/room/track/RemoteTrackPublication.mjs +284 -0
  203. package/dist/core/room/track/RemoteTrackPublication.mjs.map +1 -0
  204. package/dist/core/room/track/RemoteVideoTrack.mjs +384 -0
  205. package/dist/core/room/track/RemoteVideoTrack.mjs.map +1 -0
  206. package/dist/core/room/track/Track.mjs +413 -0
  207. package/dist/core/room/track/Track.mjs.map +1 -0
  208. package/dist/core/room/track/TrackPublication.mjs +97 -0
  209. package/dist/core/room/track/TrackPublication.mjs.map +1 -0
  210. package/dist/core/room/track/create.mjs +142 -0
  211. package/dist/core/room/track/create.mjs.map +1 -0
  212. package/dist/core/room/track/facingMode.mjs +81 -0
  213. package/dist/core/room/track/facingMode.mjs.map +1 -0
  214. package/dist/core/room/track/options.mjs +109 -0
  215. package/dist/core/room/track/options.mjs.map +1 -0
  216. package/dist/core/room/track/record.mjs +67 -0
  217. package/dist/core/room/track/record.mjs.map +1 -0
  218. package/dist/core/room/track/utils.mjs +429 -0
  219. package/dist/core/room/track/utils.mjs.map +1 -0
  220. package/dist/core/room/utils.mjs +852 -0
  221. package/dist/core/room/utils.mjs.map +1 -0
  222. package/dist/core/room/video/create.mjs +71 -0
  223. package/dist/core/room/video/create.mjs.map +1 -0
  224. package/dist/core/room/video/extension.mjs +27 -0
  225. package/dist/core/room/video/extension.mjs.map +1 -0
  226. package/dist/core/room/video/publisher.mjs +343 -0
  227. package/dist/core/room/video/publisher.mjs.map +1 -0
  228. package/dist/core/ts4.2/api/SignalClient.d.ts +19 -0
  229. package/dist/core/ts4.2/api/SignalClientStateMachine.d.ts +84 -0
  230. package/dist/core/ts4.2/api/WebSocketStream.d.ts +33 -0
  231. package/dist/core/ts4.2/api/utils.d.ts +8 -0
  232. package/dist/core/ts4.2/connectionHelper/ConnectionCheck.d.ts +29 -0
  233. package/dist/core/ts4.2/connectionHelper/checks/Checker.d.ts +64 -0
  234. package/dist/core/ts4.2/connectionHelper/checks/cloudRegion.d.ts +17 -0
  235. package/dist/core/ts4.2/connectionHelper/checks/connectionProtocol.d.ts +19 -0
  236. package/dist/core/ts4.2/connectionHelper/checks/publishAudio.d.ts +5 -0
  237. package/dist/core/ts4.2/connectionHelper/checks/publishVideo.d.ts +6 -0
  238. package/dist/core/ts4.2/connectionHelper/checks/reconnect.d.ts +5 -0
  239. package/dist/core/ts4.2/connectionHelper/checks/turn.d.ts +5 -0
  240. package/dist/core/ts4.2/connectionHelper/checks/webrtc.d.ts +5 -0
  241. package/dist/core/ts4.2/connectionHelper/checks/websocket.d.ts +5 -0
  242. package/dist/core/ts4.2/core.d.ts +33 -0
  243. package/dist/core/ts4.2/e2ee/E2eeManager.d.ts +89 -0
  244. package/dist/core/ts4.2/e2ee/KeyProvider.d.ts +53 -0
  245. package/dist/core/ts4.2/e2ee/constants.d.ts +20 -0
  246. package/dist/core/ts4.2/e2ee/errors.d.ts +11 -0
  247. package/dist/core/ts4.2/e2ee/events.d.ts +38 -0
  248. package/dist/core/ts4.2/e2ee/extension.d.ts +19 -0
  249. package/dist/core/ts4.2/e2ee/index.d.ts +5 -0
  250. package/dist/core/ts4.2/e2ee/types.d.ts +244 -0
  251. package/dist/core/ts4.2/e2ee/utils.d.ts +36 -0
  252. package/dist/core/ts4.2/exports.d.ts +82 -0
  253. package/dist/core/ts4.2/frameMetadata/FrameMetadataManager.d.ts +52 -0
  254. package/dist/core/ts4.2/frameMetadata/extension.d.ts +12 -0
  255. package/dist/core/ts4.2/frameMetadata/frameMetadata.d.ts +32 -0
  256. package/dist/core/ts4.2/frameMetadata/types.d.ts +61 -0
  257. package/dist/core/ts4.2/frameMetadata/utils.d.ts +13 -0
  258. package/dist/core/ts4.2/logger.d.ts +59 -0
  259. package/dist/core/ts4.2/options.d.ts +171 -0
  260. package/dist/core/ts4.2/room/BackOffStrategy.d.ts +26 -0
  261. package/dist/core/ts4.2/room/CoreRoom.d.ts +363 -0
  262. package/dist/core/ts4.2/room/DefaultReconnectPolicy.d.ts +7 -0
  263. package/dist/core/ts4.2/room/DeviceManager.d.ts +11 -0
  264. package/dist/core/ts4.2/room/PCTransport.d.ts +132 -0
  265. package/dist/core/ts4.2/room/PCTransportManager.d.ts +80 -0
  266. package/dist/core/ts4.2/room/RTCEngine.d.ts +233 -0
  267. package/dist/core/ts4.2/room/ReconnectPolicy.d.ts +23 -0
  268. package/dist/core/ts4.2/room/RegionUrlProvider.d.ts +33 -0
  269. package/dist/core/ts4.2/room/attribute-typings.d.ts +34 -0
  270. package/dist/core/ts4.2/room/chat/extension.d.ts +21 -0
  271. package/dist/core/ts4.2/room/createRoom.d.ts +19 -0
  272. package/dist/core/ts4.2/room/data-channel/DataChannelManager.d.ts +67 -0
  273. package/dist/core/ts4.2/room/data-channel/FlowControlledDataChannel.d.ts +106 -0
  274. package/dist/core/ts4.2/room/data-channel/LossyDataChannel.d.ts +40 -0
  275. package/dist/core/ts4.2/room/data-channel/ReliableDataChannel.d.ts +56 -0
  276. package/dist/core/ts4.2/room/data-channel/types.d.ts +11 -0
  277. package/dist/core/ts4.2/room/data-stream/compression.d.ts +29 -0
  278. package/dist/core/ts4.2/room/data-stream/constants.d.ts +1 -0
  279. package/dist/core/ts4.2/room/data-stream/extension.d.ts +63 -0
  280. package/dist/core/ts4.2/room/data-stream/incoming/IncomingDataStreamManager.d.ts +33 -0
  281. package/dist/core/ts4.2/room/data-stream/incoming/StreamReader.d.ts +77 -0
  282. package/dist/core/ts4.2/room/data-stream/outgoing/OutgoingDataStreamManager.d.ts +67 -0
  283. package/dist/core/ts4.2/room/data-stream/outgoing/StreamWriter.d.ts +15 -0
  284. package/dist/core/ts4.2/room/data-stream/outgoing/header-utils.d.ts +17 -0
  285. package/dist/core/ts4.2/room/data-track/LocalDataTrack.d.ts +69 -0
  286. package/dist/core/ts4.2/room/data-track/RemoteDataTrack.d.ts +43 -0
  287. package/dist/core/ts4.2/room/data-track/depacketizer.d.ts +58 -0
  288. package/dist/core/ts4.2/room/data-track/extension.d.ts +30 -0
  289. package/dist/core/ts4.2/room/data-track/frame.d.ts +21 -0
  290. package/dist/core/ts4.2/room/data-track/handle.d.ts +26 -0
  291. package/dist/core/ts4.2/room/data-track/incoming/IncomingDataTrackManager.d.ts +95 -0
  292. package/dist/core/ts4.2/room/data-track/incoming/errors.d.ts +23 -0
  293. package/dist/core/ts4.2/room/data-track/incoming/pipeline.d.ts +40 -0
  294. package/dist/core/ts4.2/room/data-track/incoming/types.d.ts +19 -0
  295. package/dist/core/ts4.2/room/data-track/outgoing/OutgoingDataTrackManager.d.ts +64 -0
  296. package/dist/core/ts4.2/room/data-track/outgoing/errors.d.ts +73 -0
  297. package/dist/core/ts4.2/room/data-track/outgoing/pipeline.d.ts +22 -0
  298. package/dist/core/ts4.2/room/data-track/outgoing/types.d.ts +47 -0
  299. package/dist/core/ts4.2/room/data-track/packet/constants.d.ts +19 -0
  300. package/dist/core/ts4.2/room/data-track/packet/errors.d.ts +39 -0
  301. package/dist/core/ts4.2/room/data-track/packet/extensions.d.ts +68 -0
  302. package/dist/core/ts4.2/room/data-track/packet/index.d.ts +97 -0
  303. package/dist/core/ts4.2/room/data-track/packet/serializable.d.ts +12 -0
  304. package/dist/core/ts4.2/room/data-track/packetizer.d.ts +40 -0
  305. package/dist/core/ts4.2/room/data-track/track-interfaces.d.ts +22 -0
  306. package/dist/core/ts4.2/room/data-track/types.d.ts +21 -0
  307. package/dist/core/ts4.2/room/data-track/utils.d.ts +59 -0
  308. package/dist/core/ts4.2/room/debounce.d.ts +10 -0
  309. package/dist/core/ts4.2/room/defaults.d.ts +7 -0
  310. package/dist/core/ts4.2/room/errors.d.ts +179 -0
  311. package/dist/core/ts4.2/room/events.d.ts +534 -0
  312. package/dist/core/ts4.2/room/extensions.d.ts +206 -0
  313. package/dist/core/ts4.2/room/participant/LocalParticipant.d.ts +164 -0
  314. package/dist/core/ts4.2/room/participant/Participant.d.ts +122 -0
  315. package/dist/core/ts4.2/room/participant/ParticipantTrackPermission.d.ts +25 -0
  316. package/dist/core/ts4.2/room/participant/RemoteParticipant.d.ts +37 -0
  317. package/dist/core/ts4.2/room/participant/publishUtils.d.ts +11 -0
  318. package/dist/core/ts4.2/room/rpc/client/RpcClientManager.d.ts +1 -0
  319. package/dist/core/ts4.2/room/rpc/client/events.d.ts +7 -0
  320. package/dist/core/ts4.2/room/rpc/extension.d.ts +73 -0
  321. package/dist/core/ts4.2/room/rpc/index.d.ts +6 -0
  322. package/dist/core/ts4.2/room/rpc/server/RpcServerManager.d.ts +1 -0
  323. package/dist/core/ts4.2/room/rpc/server/events.d.ts +7 -0
  324. package/dist/core/ts4.2/room/rpc/utils.d.ts +76 -0
  325. package/dist/core/ts4.2/room/simulated-participants/extension.d.ts +24 -0
  326. package/dist/core/ts4.2/room/stats.d.ts +70 -0
  327. package/dist/core/ts4.2/room/statsSummary.d.ts +12 -0
  328. package/dist/core/ts4.2/room/timers.d.ts +11 -0
  329. package/dist/core/ts4.2/room/token-source/TokenSource.d.ts +85 -0
  330. package/dist/core/ts4.2/room/token-source/types.d.ts +69 -0
  331. package/dist/core/ts4.2/room/token-source/utils.d.ts +7 -0
  332. package/dist/core/ts4.2/room/track/FrameMetadataExtractor.d.ts +18 -0
  333. package/dist/core/ts4.2/room/track/LocalAudioTrack.d.ts +50 -0
  334. package/dist/core/ts4.2/room/track/LocalTrack.d.ts +118 -0
  335. package/dist/core/ts4.2/room/track/LocalTrackPublication.d.ts +41 -0
  336. package/dist/core/ts4.2/room/track/LocalVideoTrack.d.ts +91 -0
  337. package/dist/core/ts4.2/room/track/RemoteAudioTrack.d.ts +49 -0
  338. package/dist/core/ts4.2/room/track/RemoteTrack.d.ts +29 -0
  339. package/dist/core/ts4.2/room/track/RemoteTrackPublication.d.ts +62 -0
  340. package/dist/core/ts4.2/room/track/RemoteVideoTrack.d.ts +53 -0
  341. package/dist/core/ts4.2/room/track/Track.d.ts +129 -0
  342. package/dist/core/ts4.2/room/track/TrackPublication.d.ts +68 -0
  343. package/dist/core/ts4.2/room/track/create.d.ts +12 -0
  344. package/dist/core/ts4.2/room/track/facingMode.d.ts +40 -0
  345. package/dist/core/ts4.2/room/track/options.d.ts +396 -0
  346. package/dist/core/ts4.2/room/track/processor/types.d.ts +41 -0
  347. package/dist/core/ts4.2/room/track/record.d.ts +12 -0
  348. package/dist/core/ts4.2/room/track/types.d.ts +27 -0
  349. package/dist/core/ts4.2/room/track/utils.d.ts +20 -0
  350. package/dist/core/ts4.2/room/types.d.ts +126 -0
  351. package/dist/core/ts4.2/room/utils.d.ts +246 -0
  352. package/dist/core/ts4.2/room/video/create.d.ts +27 -0
  353. package/dist/core/ts4.2/room/video/extension.d.ts +43 -0
  354. package/dist/core/ts4.2/room/video/publisher.d.ts +23 -0
  355. package/dist/core/ts4.2/type-polyfills/non-shared-typed-arrays.d.ts +1 -0
  356. package/dist/core/ts4.2/utils/AsyncQueue.d.ts +22 -0
  357. package/dist/core/ts4.2/utils/TypedPromise.d.ts +16 -0
  358. package/dist/core/ts4.2/utils/abort-signal-polyfill.d.ts +12 -0
  359. package/dist/core/ts4.2/utils/browserParser.d.ts +9 -0
  360. package/dist/core/ts4.2/utils/camelToSnakeCase.d.ts +7 -0
  361. package/dist/core/ts4.2/utils/cloneDeep.d.ts +1 -0
  362. package/dist/core/ts4.2/utils/dataPacketBuffer.d.ts +33 -0
  363. package/dist/core/ts4.2/utils/deferrable-map.d.ts +31 -0
  364. package/dist/core/ts4.2/utils/machineInspector.d.ts +53 -0
  365. package/dist/core/ts4.2/utils/serializer.d.ts +47 -0
  366. package/dist/core/ts4.2/utils/throws.d.ts +9 -0
  367. package/dist/core/ts4.2/utils/ttlmap.d.ts +19 -0
  368. package/dist/core/ts4.2/version.d.ts +17 -0
  369. package/dist/core/types/src/api/SignalClient.d.ts +19 -0
  370. package/dist/core/types/src/api/SignalClientStateMachine.d.ts +84 -0
  371. package/dist/core/types/src/api/WebSocketStream.d.ts +33 -0
  372. package/dist/core/types/src/api/utils.d.ts +8 -0
  373. package/dist/core/types/src/connectionHelper/ConnectionCheck.d.ts +28 -0
  374. package/dist/core/types/src/connectionHelper/checks/Checker.d.ts +64 -0
  375. package/dist/core/types/src/connectionHelper/checks/cloudRegion.d.ts +16 -0
  376. package/dist/core/types/src/connectionHelper/checks/connectionProtocol.d.ts +18 -0
  377. package/dist/core/types/src/connectionHelper/checks/publishAudio.d.ts +5 -0
  378. package/dist/core/types/src/connectionHelper/checks/publishVideo.d.ts +6 -0
  379. package/dist/core/types/src/connectionHelper/checks/reconnect.d.ts +5 -0
  380. package/dist/core/types/src/connectionHelper/checks/turn.d.ts +5 -0
  381. package/dist/core/types/src/connectionHelper/checks/webrtc.d.ts +5 -0
  382. package/dist/core/types/src/connectionHelper/checks/websocket.d.ts +5 -0
  383. package/dist/core/types/src/core.d.ts +32 -0
  384. package/dist/core/types/src/e2ee/E2eeManager.d.ts +89 -0
  385. package/dist/core/types/src/e2ee/KeyProvider.d.ts +53 -0
  386. package/dist/core/types/src/e2ee/constants.d.ts +20 -0
  387. package/dist/core/types/src/e2ee/errors.d.ts +11 -0
  388. package/dist/core/types/src/e2ee/events.d.ts +38 -0
  389. package/dist/core/types/src/e2ee/extension.d.ts +18 -0
  390. package/dist/core/types/src/e2ee/index.d.ts +5 -0
  391. package/dist/core/types/src/e2ee/types.d.ts +244 -0
  392. package/dist/core/types/src/e2ee/utils.d.ts +35 -0
  393. package/dist/core/types/src/exports.d.ts +75 -0
  394. package/dist/core/types/src/frameMetadata/FrameMetadataManager.d.ts +52 -0
  395. package/dist/core/types/src/frameMetadata/extension.d.ts +10 -0
  396. package/dist/core/types/src/frameMetadata/frameMetadata.d.ts +32 -0
  397. package/dist/core/types/src/frameMetadata/types.d.ts +61 -0
  398. package/dist/core/types/src/frameMetadata/utils.d.ts +13 -0
  399. package/dist/core/types/src/logger.d.ts +59 -0
  400. package/dist/core/types/src/options.d.ts +171 -0
  401. package/dist/core/types/src/room/BackOffStrategy.d.ts +26 -0
  402. package/dist/core/types/src/room/CoreRoom.d.ts +374 -0
  403. package/dist/core/types/src/room/DefaultReconnectPolicy.d.ts +7 -0
  404. package/dist/core/types/src/room/DeviceManager.d.ts +11 -0
  405. package/dist/core/types/src/room/PCTransport.d.ts +132 -0
  406. package/dist/core/types/src/room/PCTransportManager.d.ts +80 -0
  407. package/dist/core/types/src/room/RTCEngine.d.ts +232 -0
  408. package/dist/core/types/src/room/ReconnectPolicy.d.ts +23 -0
  409. package/dist/core/types/src/room/RegionUrlProvider.d.ts +33 -0
  410. package/dist/core/types/src/room/attribute-typings.d.ts +34 -0
  411. package/dist/core/types/src/room/chat/extension.d.ts +21 -0
  412. package/dist/core/types/src/room/createRoom.d.ts +18 -0
  413. package/dist/core/types/src/room/data-channel/DataChannelManager.d.ts +68 -0
  414. package/dist/core/types/src/room/data-channel/FlowControlledDataChannel.d.ts +107 -0
  415. package/dist/core/types/src/room/data-channel/LossyDataChannel.d.ts +39 -0
  416. package/dist/core/types/src/room/data-channel/ReliableDataChannel.d.ts +55 -0
  417. package/dist/core/types/src/room/data-channel/types.d.ts +11 -0
  418. package/dist/core/types/src/room/data-stream/compression.d.ts +29 -0
  419. package/dist/core/types/src/room/data-stream/constants.d.ts +1 -0
  420. package/dist/core/types/src/room/data-stream/extension.d.ts +62 -0
  421. package/dist/core/types/src/room/data-stream/incoming/IncomingDataStreamManager.d.ts +32 -0
  422. package/dist/core/types/src/room/data-stream/incoming/StreamReader.d.ts +77 -0
  423. package/dist/core/types/src/room/data-stream/outgoing/OutgoingDataStreamManager.d.ts +67 -0
  424. package/dist/core/types/src/room/data-stream/outgoing/StreamWriter.d.ts +15 -0
  425. package/dist/core/types/src/room/data-stream/outgoing/header-utils.d.ts +17 -0
  426. package/dist/core/types/src/room/data-track/LocalDataTrack.d.ts +70 -0
  427. package/dist/core/types/src/room/data-track/RemoteDataTrack.d.ts +43 -0
  428. package/dist/core/types/src/room/data-track/depacketizer.d.ts +58 -0
  429. package/dist/core/types/src/room/data-track/extension.d.ts +30 -0
  430. package/dist/core/types/src/room/data-track/frame.d.ts +21 -0
  431. package/dist/core/types/src/room/data-track/handle.d.ts +26 -0
  432. package/dist/core/types/src/room/data-track/incoming/IncomingDataTrackManager.d.ts +95 -0
  433. package/dist/core/types/src/room/data-track/incoming/errors.d.ts +23 -0
  434. package/dist/core/types/src/room/data-track/incoming/pipeline.d.ts +40 -0
  435. package/dist/core/types/src/room/data-track/incoming/types.d.ts +19 -0
  436. package/dist/core/types/src/room/data-track/outgoing/OutgoingDataTrackManager.d.ts +64 -0
  437. package/dist/core/types/src/room/data-track/outgoing/errors.d.ts +73 -0
  438. package/dist/core/types/src/room/data-track/outgoing/pipeline.d.ts +22 -0
  439. package/dist/core/types/src/room/data-track/outgoing/types.d.ts +47 -0
  440. package/dist/core/types/src/room/data-track/packet/constants.d.ts +19 -0
  441. package/dist/core/types/src/room/data-track/packet/errors.d.ts +39 -0
  442. package/dist/core/types/src/room/data-track/packet/extensions.d.ts +68 -0
  443. package/dist/core/types/src/room/data-track/packet/index.d.ts +91 -0
  444. package/dist/core/types/src/room/data-track/packet/serializable.d.ts +12 -0
  445. package/dist/core/types/src/room/data-track/packetizer.d.ts +40 -0
  446. package/dist/core/types/src/room/data-track/track-interfaces.d.ts +22 -0
  447. package/dist/core/types/src/room/data-track/types.d.ts +21 -0
  448. package/dist/core/types/src/room/data-track/utils.d.ts +59 -0
  449. package/dist/core/types/src/room/debounce.d.ts +10 -0
  450. package/dist/core/types/src/room/defaults.d.ts +7 -0
  451. package/dist/core/types/src/room/errors.d.ts +179 -0
  452. package/dist/core/types/src/room/events.d.ts +534 -0
  453. package/dist/core/types/src/room/extensions.d.ts +205 -0
  454. package/dist/core/types/src/room/participant/LocalParticipant.d.ts +164 -0
  455. package/dist/core/types/src/room/participant/Participant.d.ts +123 -0
  456. package/dist/core/types/src/room/participant/ParticipantTrackPermission.d.ts +25 -0
  457. package/dist/core/types/src/room/participant/RemoteParticipant.d.ts +37 -0
  458. package/dist/core/types/src/room/participant/publishUtils.d.ts +11 -0
  459. package/dist/core/types/src/room/rpc/client/RpcClientManager.d.ts +1 -0
  460. package/dist/core/types/src/room/rpc/client/events.d.ts +7 -0
  461. package/dist/core/types/src/room/rpc/extension.d.ts +69 -0
  462. package/dist/core/types/src/room/rpc/index.d.ts +5 -0
  463. package/dist/core/types/src/room/rpc/server/RpcServerManager.d.ts +1 -0
  464. package/dist/core/types/src/room/rpc/server/events.d.ts +7 -0
  465. package/dist/core/types/src/room/rpc/utils.d.ts +76 -0
  466. package/dist/core/types/src/room/simulated-participants/extension.d.ts +24 -0
  467. package/dist/core/types/src/room/stats.d.ts +70 -0
  468. package/dist/core/types/src/room/statsSummary.d.ts +12 -0
  469. package/dist/core/types/src/room/timers.d.ts +11 -0
  470. package/dist/core/types/src/room/token-source/TokenSource.d.ts +91 -0
  471. package/dist/core/types/src/room/token-source/types.d.ts +69 -0
  472. package/dist/core/types/src/room/token-source/utils.d.ts +7 -0
  473. package/dist/core/types/src/room/track/FrameMetadataExtractor.d.ts +18 -0
  474. package/dist/core/types/src/room/track/LocalAudioTrack.d.ts +53 -0
  475. package/dist/core/types/src/room/track/LocalTrack.d.ts +118 -0
  476. package/dist/core/types/src/room/track/LocalTrackPublication.d.ts +41 -0
  477. package/dist/core/types/src/room/track/LocalVideoTrack.d.ts +91 -0
  478. package/dist/core/types/src/room/track/RemoteAudioTrack.d.ts +49 -0
  479. package/dist/core/types/src/room/track/RemoteTrack.d.ts +29 -0
  480. package/dist/core/types/src/room/track/RemoteTrackPublication.d.ts +76 -0
  481. package/dist/core/types/src/room/track/RemoteVideoTrack.d.ts +56 -0
  482. package/dist/core/types/src/room/track/Track.d.ts +134 -0
  483. package/dist/core/types/src/room/track/TrackPublication.d.ts +74 -0
  484. package/dist/core/types/src/room/track/create.d.ts +12 -0
  485. package/dist/core/types/src/room/track/facingMode.d.ts +40 -0
  486. package/dist/core/types/src/room/track/options.d.ts +384 -0
  487. package/dist/core/types/src/room/track/processor/types.d.ts +41 -0
  488. package/dist/core/types/src/room/track/record.d.ts +12 -0
  489. package/dist/core/types/src/room/track/types.d.ts +27 -0
  490. package/dist/core/types/src/room/track/utils.d.ts +20 -0
  491. package/dist/core/types/src/room/types.d.ts +126 -0
  492. package/dist/core/types/src/room/utils.d.ts +246 -0
  493. package/dist/core/types/src/room/video/create.d.ts +27 -0
  494. package/dist/core/types/src/room/video/extension.d.ts +43 -0
  495. package/dist/core/types/src/room/video/publisher.d.ts +23 -0
  496. package/dist/core/types/src/type-polyfills/non-shared-typed-arrays.d.ts +1 -0
  497. package/dist/core/types/src/utils/AsyncQueue.d.ts +22 -0
  498. package/dist/core/types/src/utils/TypedPromise.d.ts +15 -0
  499. package/dist/core/types/src/utils/abort-signal-polyfill.d.ts +12 -0
  500. package/dist/core/types/src/utils/browserParser.d.ts +9 -0
  501. package/dist/core/types/src/utils/camelToSnakeCase.d.ts +7 -0
  502. package/dist/core/types/src/utils/cloneDeep.d.ts +1 -0
  503. package/dist/core/types/src/utils/dataPacketBuffer.d.ts +33 -0
  504. package/dist/core/types/src/utils/deferrable-map.d.ts +31 -0
  505. package/dist/core/types/src/utils/machineInspector.d.ts +53 -0
  506. package/dist/core/types/src/utils/serializer.d.ts +47 -0
  507. package/dist/core/types/src/utils/throws.d.ts +9 -0
  508. package/dist/core/types/src/utils/ttlmap.d.ts +19 -0
  509. package/dist/core/types/src/version.d.ts +17 -0
  510. package/dist/core/utils/AsyncQueue.mjs +41 -0
  511. package/dist/core/utils/AsyncQueue.mjs.map +1 -0
  512. package/dist/core/utils/TypedPromise.mjs +23 -0
  513. package/dist/core/utils/TypedPromise.mjs.map +1 -0
  514. package/dist/core/utils/abort-signal-polyfill.mjs +53 -0
  515. package/dist/core/utils/abort-signal-polyfill.mjs.map +1 -0
  516. package/dist/core/utils/browserParser.mjs +62 -0
  517. package/dist/core/utils/browserParser.mjs.map +1 -0
  518. package/dist/core/utils/cloneDeep.mjs +14 -0
  519. package/dist/core/utils/cloneDeep.mjs.map +1 -0
  520. package/dist/core/utils/dataPacketBuffer.mjs +76 -0
  521. package/dist/core/utils/dataPacketBuffer.mjs.map +1 -0
  522. package/dist/core/utils/deferrable-map.mjs +94 -0
  523. package/dist/core/utils/deferrable-map.mjs.map +1 -0
  524. package/dist/core/utils/machineInspector.mjs +19 -0
  525. package/dist/core/utils/machineInspector.mjs.map +1 -0
  526. package/dist/core/utils/serializer.mjs +47 -0
  527. package/dist/core/utils/serializer.mjs.map +1 -0
  528. package/dist/core/utils/ttlmap.mjs +97 -0
  529. package/dist/core/utils/ttlmap.mjs.map +1 -0
  530. package/dist/core/version.mjs +17 -0
  531. package/dist/core/version.mjs.map +1 -0
  532. package/dist/livekit-client.e2ee.worker.js +1 -1
  533. package/dist/livekit-client.e2ee.worker.js.map +1 -1
  534. package/dist/livekit-client.e2ee.worker.mjs +157 -131
  535. package/dist/livekit-client.e2ee.worker.mjs.map +1 -1
  536. package/dist/livekit-client.esm.mjs +31497 -30818
  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 +25 -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/extension.d.ts +70 -0
  643. package/dist/src/room/rpc/extension.d.ts.map +1 -0
  644. package/dist/src/room/rpc/index.d.ts +1 -1
  645. package/dist/src/room/rpc/index.d.ts.map +1 -1
  646. package/dist/src/room/rpc/legacyExtension.d.ts +34 -0
  647. package/dist/src/room/rpc/legacyExtension.d.ts.map +1 -0
  648. package/dist/src/room/simulated-participants/extension.d.ts +25 -0
  649. package/dist/src/room/simulated-participants/extension.d.ts.map +1 -0
  650. package/dist/src/room/token-source/TokenSource.d.ts +5 -1
  651. package/dist/src/room/token-source/TokenSource.d.ts.map +1 -1
  652. package/dist/src/room/token-source/utils.d.ts.map +1 -1
  653. package/dist/src/room/track/LocalTrack.d.ts +1 -1
  654. package/dist/src/room/track/LocalTrack.d.ts.map +1 -1
  655. package/dist/src/room/track/LocalVideoTrack.d.ts.map +1 -1
  656. package/dist/src/room/track/RemoteTrackPublication.d.ts +14 -1
  657. package/dist/src/room/track/RemoteTrackPublication.d.ts.map +1 -1
  658. package/dist/src/room/track/Track.d.ts.map +1 -1
  659. package/dist/src/room/track/TrackPublication.d.ts +2 -2
  660. package/dist/src/room/track/TrackPublication.d.ts.map +1 -1
  661. package/dist/src/room/track/create.d.ts +15 -13
  662. package/dist/src/room/track/create.d.ts.map +1 -1
  663. package/dist/src/room/track/facingMode.d.ts.map +1 -1
  664. package/dist/src/room/track/options.d.ts +0 -6
  665. package/dist/src/room/track/options.d.ts.map +1 -1
  666. package/dist/src/room/track/processor/types.d.ts +2 -2
  667. package/dist/src/room/track/processor/types.d.ts.map +1 -1
  668. package/dist/src/room/track/utils.d.ts +1 -1
  669. package/dist/src/room/track/utils.d.ts.map +1 -1
  670. package/dist/src/room/utils.d.ts +2 -2
  671. package/dist/src/room/utils.d.ts.map +1 -1
  672. package/dist/src/room/video/create.d.ts +28 -0
  673. package/dist/src/room/video/create.d.ts.map +1 -0
  674. package/dist/src/room/video/extension.d.ts +48 -0
  675. package/dist/src/room/video/extension.d.ts.map +1 -0
  676. package/dist/src/room/video/publisher.d.ts +24 -0
  677. package/dist/src/room/video/publisher.d.ts.map +1 -0
  678. package/dist/src/test/MockMediaStream.d.ts +6 -0
  679. package/dist/src/test/MockMediaStream.d.ts.map +1 -0
  680. package/dist/src/utils/browserParser.d.ts +0 -3
  681. package/dist/src/utils/browserParser.d.ts.map +1 -1
  682. package/dist/src/utils/deferrable-map.d.ts +1 -1
  683. package/dist/src/utils/deferrable-map.d.ts.map +1 -1
  684. package/dist/src/utils/serializer.d.ts.map +1 -1
  685. package/dist/src/utils/throws.d.ts +10 -0
  686. package/dist/src/utils/throws.d.ts.map +1 -0
  687. package/dist/src/version.d.ts +4 -1
  688. package/dist/src/version.d.ts.map +1 -1
  689. package/dist/ts4.2/connectionHelper/checks/Checker.d.ts +7 -4
  690. package/dist/ts4.2/core.d.ts +34 -0
  691. package/dist/ts4.2/e2ee/E2eeManager.d.ts +25 -5
  692. package/dist/ts4.2/e2ee/extension.d.ts +20 -0
  693. package/dist/ts4.2/e2ee/types.d.ts +14 -0
  694. package/dist/ts4.2/e2ee/utils.d.ts +6 -1
  695. package/dist/ts4.2/e2ee/worker/FrameCryptor.d.ts +7 -1
  696. package/dist/ts4.2/e2ee/worker/naluUtils.d.ts +7 -0
  697. package/dist/ts4.2/e2ee/worker/sifPayload.d.ts +1 -1
  698. package/dist/ts4.2/exports.d.ts +83 -0
  699. package/dist/ts4.2/frameMetadata/FrameMetadataManager.d.ts +5 -2
  700. package/dist/ts4.2/frameMetadata/extension.d.ts +13 -0
  701. package/dist/ts4.2/frameMetadata/utils.d.ts +5 -0
  702. package/dist/ts4.2/index.d.ts +35 -69
  703. package/dist/ts4.2/logger.d.ts +1 -3
  704. package/dist/ts4.2/options.d.ts +20 -6
  705. package/dist/ts4.2/room/CoreRoom.d.ts +381 -0
  706. package/dist/ts4.2/room/PCTransport.d.ts +5 -2
  707. package/dist/ts4.2/room/PCTransportManager.d.ts +8 -4
  708. package/dist/ts4.2/room/RTCEngine.d.ts +23 -6
  709. package/dist/ts4.2/room/Room.d.ts +6 -392
  710. package/dist/ts4.2/room/chat/extension.d.ts +22 -0
  711. package/dist/ts4.2/room/createRoom.d.ts +20 -0
  712. package/dist/ts4.2/room/data-channel/DataChannelManager.d.ts +6 -1
  713. package/dist/ts4.2/room/data-stream/constants.d.ts +9 -0
  714. package/dist/ts4.2/room/data-stream/extension.d.ts +74 -0
  715. package/dist/ts4.2/room/data-stream/incoming/IncomingDataStreamManager.d.ts +6 -1
  716. package/dist/ts4.2/room/data-stream/outgoing/OutgoingDataStreamManager.d.ts +0 -1
  717. package/dist/ts4.2/room/data-track/LocalDataTrack.d.ts +1 -1
  718. package/dist/ts4.2/room/data-track/depacketizer.d.ts +1 -1
  719. package/dist/ts4.2/room/data-track/extension.d.ts +31 -0
  720. package/dist/ts4.2/room/data-track/handle.d.ts +1 -1
  721. package/dist/ts4.2/room/data-track/incoming/IncomingDataTrackManager.d.ts +1 -1
  722. package/dist/ts4.2/room/data-track/incoming/pipeline.d.ts +1 -1
  723. package/dist/ts4.2/room/data-track/outgoing/OutgoingDataTrackManager.d.ts +2 -1
  724. package/dist/ts4.2/room/data-track/outgoing/pipeline.d.ts +1 -1
  725. package/dist/ts4.2/room/data-track/packet/extensions.d.ts +1 -1
  726. package/dist/ts4.2/room/data-track/packet/index.d.ts +1 -1
  727. package/dist/ts4.2/room/data-track/packet/serializable.d.ts +1 -1
  728. package/dist/ts4.2/room/data-track/packetizer.d.ts +1 -1
  729. package/dist/ts4.2/room/data-track/track-interfaces.d.ts +1 -1
  730. package/dist/ts4.2/room/data-track/utils.d.ts +1 -1
  731. package/dist/ts4.2/room/defaults.d.ts +1 -2
  732. package/dist/ts4.2/room/extensions.d.ts +214 -0
  733. package/dist/ts4.2/room/participant/LocalParticipant.d.ts +44 -121
  734. package/dist/ts4.2/room/participant/Participant.d.ts +8 -1
  735. package/dist/ts4.2/room/participant/RemoteParticipant.d.ts +3 -3
  736. package/dist/ts4.2/room/rpc/extension.d.ts +74 -0
  737. package/dist/ts4.2/room/rpc/index.d.ts +1 -1
  738. package/dist/ts4.2/room/rpc/legacyExtension.d.ts +39 -0
  739. package/dist/ts4.2/room/simulated-participants/extension.d.ts +25 -0
  740. package/dist/ts4.2/room/token-source/TokenSource.d.ts +5 -1
  741. package/dist/ts4.2/room/track/LocalTrack.d.ts +1 -1
  742. package/dist/ts4.2/room/track/RemoteTrackPublication.d.ts +3 -1
  743. package/dist/ts4.2/room/track/TrackPublication.d.ts +2 -2
  744. package/dist/ts4.2/room/track/create.d.ts +15 -13
  745. package/dist/ts4.2/room/track/options.d.ts +0 -6
  746. package/dist/ts4.2/room/track/processor/types.d.ts +2 -2
  747. package/dist/ts4.2/room/track/utils.d.ts +1 -1
  748. package/dist/ts4.2/room/utils.d.ts +2 -2
  749. package/dist/ts4.2/room/video/create.d.ts +28 -0
  750. package/dist/ts4.2/room/video/extension.d.ts +48 -0
  751. package/dist/ts4.2/room/video/publisher.d.ts +24 -0
  752. package/dist/ts4.2/test/MockMediaStream.d.ts +6 -0
  753. package/dist/ts4.2/utils/browserParser.d.ts +0 -3
  754. package/dist/ts4.2/utils/deferrable-map.d.ts +1 -1
  755. package/dist/ts4.2/utils/throws.d.ts +10 -0
  756. package/dist/ts4.2/version.d.ts +4 -1
  757. package/package.json +24 -9
  758. package/src/api/SignalClient.test.ts +107 -0
  759. package/src/api/SignalClient.ts +13 -3
  760. package/src/api/WebSocketStream.test.ts +67 -0
  761. package/src/api/WebSocketStream.ts +41 -3
  762. package/src/connectionHelper/checks/Checker.ts +12 -5
  763. package/src/connectionHelper/checks/publishVideo.ts +1 -1
  764. package/src/connectionHelper/checks/reconnect.ts +1 -1
  765. package/src/core.ts +35 -0
  766. package/src/e2ee/E2eeManager.test.ts +70 -1
  767. package/src/e2ee/E2eeManager.ts +53 -32
  768. package/src/e2ee/KeyProvider.ts +2 -1
  769. package/src/e2ee/extension.ts +113 -0
  770. package/src/e2ee/subscriberBlackScreen.test.ts +9 -12
  771. package/src/e2ee/types.ts +14 -0
  772. package/src/e2ee/utils.test.ts +47 -0
  773. package/src/e2ee/utils.ts +26 -14
  774. package/src/e2ee/worker/DataCryptor.test.ts +42 -1
  775. package/src/e2ee/worker/DataCryptor.ts +2 -2
  776. package/src/e2ee/worker/FrameCryptor.race.test.ts +3 -7
  777. package/src/e2ee/worker/FrameCryptor.test.ts +68 -13
  778. package/src/e2ee/worker/FrameCryptor.ts +78 -18
  779. package/src/e2ee/worker/e2ee.worker.test.ts +151 -0
  780. package/src/e2ee/worker/e2ee.worker.ts +28 -20
  781. package/src/e2ee/worker/naluUtils.test.ts +21 -1
  782. package/src/e2ee/worker/naluUtils.ts +30 -0
  783. package/src/e2ee/worker/sifPayload.ts +1 -1
  784. package/src/exports.ts +224 -0
  785. package/src/frameMetadata/FrameMetadataManager.ts +9 -3
  786. package/src/frameMetadata/extension.ts +34 -0
  787. package/src/frameMetadata/frameMetadata.ts +1 -1
  788. package/src/frameMetadata/utils.ts +23 -0
  789. package/src/index.ts +47 -189
  790. package/src/logger.ts +1 -3
  791. package/src/options.ts +25 -6
  792. package/src/room/CoreRoom.ts +3017 -0
  793. package/src/room/DeviceManager.test.ts +55 -1
  794. package/src/room/DeviceManager.ts +1 -1
  795. package/src/room/PCTransport.test.ts +43 -0
  796. package/src/room/PCTransport.ts +22 -22
  797. package/src/room/PCTransportManager.test.ts +65 -3
  798. package/src/room/PCTransportManager.ts +28 -12
  799. package/src/room/RTCEngine.test.ts +421 -21
  800. package/src/room/RTCEngine.ts +138 -34
  801. package/src/room/RegionUrlProvider.ts +1 -1
  802. package/src/room/Room.test.ts +717 -4
  803. package/src/room/Room.ts +34 -3317
  804. package/src/room/chat/extension.ts +78 -0
  805. package/src/room/createRoom.test.ts +149 -0
  806. package/src/room/createRoom.ts +26 -0
  807. package/src/room/data-channel/DataChannelManager.test.ts +37 -0
  808. package/src/room/data-channel/DataChannelManager.ts +21 -3
  809. package/src/room/data-stream/constants.ts +10 -0
  810. package/src/room/data-stream/extension.ts +162 -0
  811. package/src/room/data-stream/incoming/IncomingDataStreamManager.test.ts +269 -3
  812. package/src/room/data-stream/incoming/IncomingDataStreamManager.ts +53 -2
  813. package/src/room/data-stream/incoming/StreamReader.ts +14 -4
  814. package/src/room/data-stream/outgoing/OutgoingDataStreamManager.ts +1 -2
  815. package/src/room/data-track/depacketizer.ts +2 -2
  816. package/src/room/data-track/extension.ts +244 -0
  817. package/src/room/data-track/handle.ts +1 -1
  818. package/src/room/data-track/incoming/IncomingDataTrackManager.ts +2 -2
  819. package/src/room/data-track/incoming/pipeline.ts +2 -2
  820. package/src/room/data-track/outgoing/OutgoingDataTrackManager.test.ts +42 -3
  821. package/src/room/data-track/outgoing/OutgoingDataTrackManager.ts +5 -3
  822. package/src/room/data-track/outgoing/pipeline.ts +1 -1
  823. package/src/room/data-track/packet/extensions.ts +1 -1
  824. package/src/room/data-track/packet/index.ts +1 -1
  825. package/src/room/data-track/packet/serializable.ts +1 -1
  826. package/src/room/data-track/packetizer.ts +1 -1
  827. package/src/room/data-track/track-interfaces.ts +4 -4
  828. package/src/room/data-track/utils.ts +1 -1
  829. package/src/room/defaults.ts +3 -16
  830. package/src/room/extensions.ts +310 -0
  831. package/src/room/participant/LocalParticipant.test.ts +23 -6
  832. package/src/room/participant/LocalParticipant.ts +92 -669
  833. package/src/room/participant/Participant.test.ts +60 -0
  834. package/src/room/participant/Participant.ts +21 -1
  835. package/src/room/participant/RemoteParticipant.ts +3 -8
  836. package/src/room/participant/publishUtils.ts +3 -3
  837. package/src/room/participant/restartOnDefaultAudioDevice.test.ts +1 -1
  838. package/src/room/rpc/extension.ts +159 -0
  839. package/src/room/rpc/index.ts +1 -10
  840. package/src/room/rpc/legacyExtension.ts +36 -0
  841. package/src/room/simulated-participants/extension.ts +189 -0
  842. package/src/room/token-source/TokenSource.test.ts +29 -0
  843. package/src/room/token-source/TokenSource.ts +8 -3
  844. package/src/room/token-source/utils.test.ts +34 -0
  845. package/src/room/token-source/utils.ts +23 -1
  846. package/src/room/track/LocalTrack.ts +18 -10
  847. package/src/room/track/LocalVideoTrack.test.ts +66 -2
  848. package/src/room/track/LocalVideoTrack.ts +5 -3
  849. package/src/room/track/RemoteTrackPublication.ts +14 -1
  850. package/src/room/track/RemoteVideoTrack.test.ts +2 -0
  851. package/src/room/track/Track.test.ts +102 -0
  852. package/src/room/track/Track.ts +8 -1
  853. package/src/room/track/TrackPublication.ts +2 -2
  854. package/src/room/track/create.ts +59 -71
  855. package/src/room/track/facingMode.ts +5 -2
  856. package/src/room/track/options.ts +26 -34
  857. package/src/room/track/processor/types.ts +2 -2
  858. package/src/room/track/utils.ts +5 -1
  859. package/src/room/utils.ts +2 -2
  860. package/src/room/video/create.ts +95 -0
  861. package/src/room/video/extension.ts +115 -0
  862. package/src/room/video/publisher.ts +472 -0
  863. package/src/test/MockMediaStream.ts +13 -0
  864. package/src/utils/browserParser.ts +0 -3
  865. package/src/utils/deferrable-map.test.ts +60 -0
  866. package/src/utils/deferrable-map.ts +7 -4
  867. package/src/utils/serializer.ts +1 -1
  868. package/src/utils/throws.ts +15 -0
  869. package/src/version.ts +6 -1
@@ -0,0 +1,206 @@
1
+ import type { DataPacket, Encryption_Type, ParticipantInfo, PublishDataTrackResponse, Room as RoomModel } from '@livekit/protocol';
2
+ import type { BaseE2EEManager } from '../e2ee/E2eeManager';
3
+ import type { FrameMetadataOptions } from '../frameMetadata/FrameMetadataManager';
4
+ import type { StructuredLogger } from '../logger';
5
+ import type { CoreRoom } from './CoreRoom';
6
+ import type RTCEngine from './RTCEngine';
7
+ import type { ByteStreamWriter } from './data-stream/outgoing/StreamWriter';
8
+ import type { VideoPublisher } from './participant/LocalParticipant';
9
+ import type RemoteParticipant from './participant/RemoteParticipant';
10
+ import type { StreamBytesOptions } from './types';
11
+ /**
12
+ * A feature that `createRoom(options, [...])` (or the full `Room`) installs on a room. The
13
+ * methods returned from `install` are copied onto the room (`room`) and its local participant
14
+ * (`local`) under the same names the full SDK uses, so code moves between the light and full
15
+ * builds unchanged.
16
+ *
17
+ * `install` runs synchronously right after the room is constructed, before any user code, so
18
+ * handlers registered there are in place before `connect()`.
19
+ * @experimental
20
+ */
21
+ export interface RoomExtension<RoomApi = {}, LocalParticipantApi = {}> {
22
+ readonly key: symbol;
23
+ /** Hard dependencies. They install first; an instance the app lists explicitly wins over them. */
24
+ readonly requires?: readonly RoomExtension<any, any>[];
25
+ install(room: CoreRoom, ctx: ExtensionContext): ExtensionResult<RoomApi, LocalParticipantApi>;
26
+ }
27
+ /**
28
+ * What an extension contributes to the engine.
29
+ * @experimental
30
+ */
31
+ export interface EngineHooks {
32
+ /**
33
+ * Runs once every extension of the list is installed, with the current engine, and again
34
+ * whenever the room replaces it (after a close). The room's own engine listeners are registered
35
+ * first, so a listener on the same engine event sees room state already updated.
36
+ */
37
+ onEngineCreated?(engine: RTCEngine): void;
38
+ }
39
+ /**
40
+ * What an extension contributes to the connection lifecycle.
41
+ * @experimental
42
+ */
43
+ export interface ConnectionHooks {
44
+ /**
45
+ * Runs at the start of every disconnect, including one that reaches an already disconnected
46
+ * room, before the room emits `RoomEvent.Disconnected`.
47
+ */
48
+ onDisconnect?(): void;
49
+ }
50
+ /**
51
+ * What an extension contributes to remote participant bookkeeping.
52
+ * @experimental
53
+ */
54
+ export interface ParticipantHooks {
55
+ /** Runs after the room creates a remote participant from a `ParticipantInfo`. */
56
+ onParticipantCreated?(participant: RemoteParticipant, info: ParticipantInfo): void;
57
+ /** Runs after the room applied a participant update (join, update, reconnect). */
58
+ onParticipantUpdates?(infos: ParticipantInfo[]): void;
59
+ }
60
+ /**
61
+ * An extension that owns `DataPacket` oneof cases. A second owner of a case throws at install.
62
+ * @experimental
63
+ */
64
+ export interface DataPacketOwner {
65
+ dataPackets?: {
66
+ [C in DataPacketCase]?: DataPacketHandler<C>;
67
+ };
68
+ }
69
+ /**
70
+ * An extension that contributes to the sync state the room sends on resume.
71
+ * @experimental
72
+ */
73
+ export interface SyncStateProvider {
74
+ /** Local data track publications. */
75
+ syncState?(): PublishDataTrackResponse[];
76
+ }
77
+ /**
78
+ * An extension that adds methods to the room, copied onto it under the SDK's method names.
79
+ * @experimental
80
+ */
81
+ export interface RoomApiProvider<RoomApi = {}> {
82
+ room: RoomApi;
83
+ }
84
+ /**
85
+ * An extension that adds methods to the local participant, copied onto it.
86
+ * @experimental
87
+ */
88
+ export interface LocalParticipantApiProvider<LocalParticipantApi = {}> {
89
+ localParticipant: LocalParticipantApi;
90
+ }
91
+ /**
92
+ * An extension with something to release.
93
+ * @experimental
94
+ */
95
+ export interface Disposable {
96
+ /** Called from `Room.dispose()`, in reverse install order. Must be synchronous. */
97
+ dispose(): void;
98
+ }
99
+ /**
100
+ * What `install` returns: the APIs plus every contribution to core an extension can opt into,
101
+ * all optional. An extension declares the narrower type it uses, such as
102
+ * `RoomApiProvider<RpcRoomApi> & LocalParticipantApiProvider<RpcLocalParticipantApi> & DataPacketOwner`, so a missing
103
+ * API or an undeclared contribution is a type error. Extra members are not copied anywhere;
104
+ * dependent extensions read them through `ctx.get(extension)`. The room's own typing
105
+ * (`ExtensionApis`) comes from the `RoomExtension<RoomApi, LocalParticipantApi>` generics, which each
106
+ * extension pins with `satisfies`.
107
+ * @experimental
108
+ */
109
+ export type ExtensionResult<RoomApi = {}, LocalParticipantApi = {}> = Partial<RoomApiProvider<RoomApi> & LocalParticipantApiProvider<LocalParticipantApi> & Disposable> & EngineHooks & ConnectionHooks & ParticipantHooks & DataPacketOwner & Partial<CoreSlots> & SyncStateProvider;
110
+ /** @experimental */
111
+ export type DataPacketHandler<C extends DataPacketCase> = (value: DataPacketValue<C>, packet: DataPacket, encryptionType: Encryption_Type, participant: RemoteParticipant | undefined) => void;
112
+ /**
113
+ * The values core reads from extensions. Core copies them off every install result into one
114
+ * store that it and the local participant read; `ctx.slot()` reads it too. Adding one is a
115
+ * member here, its key in `SLOT_KEYS`, and the read in core.
116
+ * @experimental
117
+ */
118
+ export interface CoreSlots {
119
+ /** The E2EE manager `RTCEngine` and the publish path encrypt through (`e2ee`). */
120
+ e2eeManager: BaseE2EEManager;
121
+ /**
122
+ * The frame metadata options the engine's sender transform, the join capability and
123
+ * `publishTrack` read (`frameMetadata`).
124
+ */
125
+ frameMetadataOptions: FrameMetadataOptions;
126
+ /** Opens an outgoing byte stream (`dataStreams`); the preconnect audio buffer goes through it. */
127
+ byteStreamOpener: (options?: StreamBytesOptions) => Promise<ByteStreamWriter>;
128
+ /** The video publish pipeline (`video`). Without one, publishing a video track throws. */
129
+ videoPublisher: VideoPublisher;
130
+ }
131
+ /**
132
+ * An extension that supplies the named slots: `SlotProvider<'byteStreamOpener'>`. A provider
133
+ * whose value is conditional declares `Partial<SlotProvider<...>>`.
134
+ * @experimental
135
+ */
136
+ export type SlotProvider<K extends keyof CoreSlots> = Pick<CoreSlots, K>;
137
+ /** @experimental */
138
+ export type DataPacketCase = NonNullable<DataPacket['value']['case']>;
139
+ /** @experimental */
140
+ export type DataPacketValue<C extends DataPacketCase> = Extract<DataPacket['value'], {
141
+ case: C;
142
+ }>['value'];
143
+ /**
144
+ * What core exposes to an extension at install time. Everything the extension contributes goes
145
+ * through its install result instead. Everything else it needs (`remoteParticipants`,
146
+ * `localParticipant`, `emit`, `options`, `engine`) is public on the room already.
147
+ * @experimental
148
+ */
149
+ export interface ExtensionContext {
150
+ log: StructuredLogger;
151
+ /** The `install` result of an already installed extension (a hard dependency). */
152
+ get<E extends RoomExtension<any, any>>(ext: E): ReturnType<E['install']>;
153
+ /** Reads a slot. Slots of the whole list are filled before any `onEngineCreated` runs. */
154
+ slot<K extends keyof CoreSlots>(slot: K): CoreSlots[K] | undefined;
155
+ /** Returns the remote participant for an identity, creating it from `info` when new. */
156
+ getOrCreateParticipant(identity: string, info: ParticipantInfo): RemoteParticipant;
157
+ /** Puts the room into the connected state without a server (`simulatedParticipants`). */
158
+ simulateConnected(roomInfo: RoomModel, localParticipantInfo: ParticipantInfo): void;
159
+ /** A silent audio track the room hands back to the shared source on disconnect. */
160
+ acquireEmptyAudioStreamTrack(): MediaStreamTrack;
161
+ }
162
+ type UnionToIntersection<U> = (U extends any ? (x: U) => void : never) extends (x: infer I) => void ? I : never;
163
+ type Known<T> = unknown extends T ? {} : T;
164
+ type ApiOf<E> = E extends RoomExtension<infer R, any> ? Known<R> : never;
165
+ type LocalOf<E> = E extends RoomExtension<any, infer L> ? Known<L> : never;
166
+ type Deps<E> = E extends {
167
+ requires: readonly (infer D)[];
168
+ } ? D | Deps<D> : never;
169
+ type All<E> = E | Deps<E>;
170
+ /**
171
+ * The methods a set of extensions (and their dependencies) adds to a room and its local participant.
172
+ * @experimental
173
+ */
174
+ export type ExtensionApis<E> = UnionToIntersection<ApiOf<All<E>>> & {
175
+ localParticipant: UnionToIntersection<LocalOf<All<E>>>;
176
+ };
177
+ /**
178
+ * An extension with its options bound.
179
+ * @experimental
180
+ */
181
+ export type ConfiguredExtension<Result extends ExtensionResult<any, any>, Requires extends readonly RoomExtension<any, any>[]> = {
182
+ readonly key: symbol;
183
+ readonly requires: Requires;
184
+ install(room: CoreRoom, ctx: ExtensionContext): Result;
185
+ };
186
+ /**
187
+ * An extension that takes options. Listed bare (`[e2ee]`) it installs from the room options the
188
+ * full `Room` uses today; called (`[e2ee(options)]`) it installs with those options. A function
189
+ * (`e2ee(() => options)`) is evaluated inside each room's constructor, for resources such as
190
+ * workers that must be per room.
191
+ * @experimental
192
+ */
193
+ export type ConfigurableExtension<Result extends ExtensionResult<any, any>, Options, Requires extends readonly RoomExtension<any, any>[]> = ConfiguredExtension<Result, Requires> & ((options: Options | (() => Options)) => ConfiguredExtension<Result, Requires>);
194
+ /**
195
+ * Builds a {@link ConfigurableExtension}. The option type comes from the `options` parameter.
196
+ * @experimental
197
+ */
198
+ export declare function defineExtension<Result extends ExtensionResult<any, any>, Options, Requires extends readonly RoomExtension<any, any>[] = [
199
+ ]>(name: string, requires: Requires, install: (room: CoreRoom, ctx: ExtensionContext, options: Options | undefined) => Result): ConfigurableExtension<Result, Options, Requires>;
200
+ /**
201
+ * Installs extensions on a room: dependencies first, each key once. An extension the caller
202
+ * lists explicitly wins over the default a dependency would pull in, whatever the order.
203
+ * @experimental
204
+ */
205
+ export declare function installExtensions(room: CoreRoom, extensions: readonly RoomExtension<any, any>[]): void;
206
+ export {};
@@ -0,0 +1,164 @@
1
+ import { AddTrackRequest, TrackInfo } from '@livekit/protocol';
2
+ import type { NonSharedUint8Array } from '../../type-polyfills/non-shared-typed-arrays';
3
+ import LocalTrack from '../track/LocalTrack';
4
+ import LocalTrackPublication from '../track/LocalTrackPublication';
5
+ import type LocalVideoTrack from '../track/LocalVideoTrack';
6
+ import { Track } from '../track/Track';
7
+ import type { AudioCaptureOptions, CreateLocalTracksOptions, ScreenShareCaptureOptions, TrackPublishOptions } from '../track/options';
8
+ import type { DataPublishOptions } from '../types';
9
+ import Participant from './Participant';
10
+ import type { ParticipantTrackPermission } from './ParticipantTrackPermission';
11
+ /**
12
+ * The video publish pipeline. The `video` extension sets it on the local participant; without it,
13
+ * publishing a video track throws.
14
+ * @experimental
15
+ */
16
+ export interface VideoPublisher {
17
+ /**
18
+ * Chooses the codec, settles simulcast and SVC and fills `req` (dimensions, layers, codecs).
19
+ * Returns the encodings for the sender.
20
+ */
21
+ prepare(track: LocalVideoTrack, opts: TrackPublishOptions, req: AddTrackRequest): Promise<RTCRtpEncodingParameters[]>;
22
+ /** Runs once the sender exists: degradation preference and start bitrate. */
23
+ senderCreated(track: LocalVideoTrack, opts: TrackPublishOptions, encodings: RTCRtpEncodingParameters[] | undefined, req: AddTrackRequest): void;
24
+ /** The server may answer with another primary codec. Returns recomputed encodings when it did. */
25
+ serverCodecChanged(track: LocalVideoTrack, opts: TrackPublishOptions, info: TrackInfo, req: AddTrackRequest): RTCRtpEncodingParameters[] | undefined;
26
+ createScreenTracks(options?: ScreenShareCaptureOptions): Promise<LocalTrack[]>;
27
+ }
28
+ export declare class LocalParticipant extends Participant {
29
+ audioTrackPublications: Map<string, LocalTrackPublication>;
30
+ videoTrackPublications: Map<string, LocalTrackPublication>;
31
+ /** map of track sid => all published tracks */
32
+ trackPublications: Map<string, LocalTrackPublication>;
33
+ private pendingPublishPromises;
34
+ private republishPromise;
35
+ private cameraError;
36
+ private microphoneError;
37
+ private participantTrackPermissions;
38
+ private allParticipantsAllowedToSubscribe;
39
+ private roomOptions;
40
+ private encryptionType;
41
+ private e2eeStateMutex;
42
+ private reconnectFuture?;
43
+ private signalConnectedFuture?;
44
+ private activeAgentFuture?;
45
+ private firstActiveAgent?;
46
+ private pendingSignalRequests;
47
+ /** The room's extension slots; the install result of an extension fills them. */
48
+ private readonly slots;
49
+ get lastCameraError(): (Error | undefined);
50
+ get lastMicrophoneError(): (Error | undefined);
51
+ get isE2EEEnabled(): boolean;
52
+ getTrackPublication(source: Track.Source): LocalTrackPublication | undefined;
53
+ getTrackPublicationByName(name: string): LocalTrackPublication | undefined;
54
+ private handleReconnecting;
55
+ private handleReconnected;
56
+ private handleClosing;
57
+ private handleSignalConnected;
58
+ private handleSignalRequestResponse;
59
+ /**
60
+ * Sets and updates the metadata of the local participant.
61
+ * Note: this requires `canUpdateOwnMetadata` permission.
62
+ * method will throw if the user doesn't have the required permissions
63
+ * @param metadata
64
+ */
65
+ setMetadata(metadata: string): Promise<void>;
66
+ /**
67
+ * Sets and updates the name of the local participant.
68
+ * Note: this requires `canUpdateOwnMetadata` permission.
69
+ * method will throw if the user doesn't have the required permissions
70
+ * @param metadata
71
+ */
72
+ setName(name: string): Promise<void>;
73
+ /**
74
+ * Set or update participant attributes. It will make updates only to keys that
75
+ * are present in `attributes`, and will not override others.
76
+ * Note: this requires `canUpdateOwnMetadata` permission.
77
+ * @param attributes attributes to update
78
+ */
79
+ setAttributes(attributes: Record<string, string>): Promise<void>;
80
+ private requestMetadataUpdate;
81
+ /**
82
+ * Enable or disable a participant's microphone track.
83
+ *
84
+ * If a track has already published, it'll mute or unmute the track.
85
+ * Resolves with a `LocalTrackPublication` instance if successful and `undefined` otherwise
86
+ */
87
+ setMicrophoneEnabled(enabled: boolean, options?: AudioCaptureOptions, publishOptions?: TrackPublishOptions): Promise<LocalTrackPublication | undefined>;
88
+ setTrackEnabled(source: Extract<Track.Source, Track.Source.Microphone>, enabled: boolean, options?: AudioCaptureOptions, publishOptions?: TrackPublishOptions): Promise<LocalTrackPublication | undefined>;
89
+ setTrackEnabled(source: Extract<Track.Source, Track.Source.ScreenShare>, enabled: boolean, options?: ScreenShareCaptureOptions, publishOptions?: TrackPublishOptions): Promise<LocalTrackPublication | undefined>;
90
+ /**
91
+ * Create local camera and/or microphone tracks
92
+ * @param options
93
+ * @returns
94
+ */
95
+ createTracks(options?: CreateLocalTracksOptions): Promise<LocalTrack[]>;
96
+ private requireVideoPublisher;
97
+ /**
98
+ * Publish a new track to the room
99
+ * @param track
100
+ * @param options
101
+ */
102
+ publishTrack(track: LocalTrack | MediaStreamTrack, options?: TrackPublishOptions): Promise<LocalTrackPublication>;
103
+ /**
104
+ * Waits for the engine's next `Restarted` event. Unlike `engine.waitForRestarted`, this does
105
+ * not short-circuit when `pcState === Connected` — at the point this is called (right after a
106
+ * `NegotiationError`) the PC transport is still connected, but `fullReconnectOnNext` has been
107
+ * set and `attemptReconnect` is queued via setTimeout. We need to wait for that restart to
108
+ * actually complete (which clears `pendingTrackResolvers` via `cleanupClient`) before retrying.
109
+ */
110
+ private waitForNextEngineRestart;
111
+ private publishOrRepublishTrack;
112
+ private waitUntilEngineConnected;
113
+ private hasPermissionsToPublish;
114
+ private publish;
115
+ private canPublishFrameMetadata;
116
+ get isLocal(): boolean;
117
+ unpublishTrack(track: LocalTrack | MediaStreamTrack, stopOnUnpublish?: boolean): Promise<LocalTrackPublication | undefined>;
118
+ unpublishTracks(tracks: LocalTrack[] | MediaStreamTrack[]): Promise<LocalTrackPublication[]>;
119
+ republishAllTracks(options?: TrackPublishOptions, restartTracks?: boolean): Promise<void>;
120
+ /**
121
+ * Publish a new data payload to the room. Data will be forwarded to each
122
+ * participant in the room if the destination field in publishOptions is empty
123
+ *
124
+ * @param data Uint8Array of the payload. To send string data, use TextEncoder.encode
125
+ * @param options optionally specify a `reliable`, `topic` and `destination`
126
+ */
127
+ publishData(data: NonSharedUint8Array, options?: DataPublishOptions): Promise<void>;
128
+ /**
129
+ * Publish SIP DTMF message to the room.
130
+ *
131
+ * @param code DTMF code
132
+ * @param digit DTMF digit
133
+ */
134
+ publishDtmf(code: number, digit: string): Promise<void>;
135
+ /**
136
+ * Control who can subscribe to LocalParticipant's published tracks.
137
+ *
138
+ * By default, all participants can subscribe. This allows fine-grained control over
139
+ * who is able to subscribe at a participant and track level.
140
+ *
141
+ * Note: if access is given at a track-level (i.e. both [allParticipantsAllowed] and
142
+ * [ParticipantTrackPermission.allTracksAllowed] are false), any newer published tracks
143
+ * will not grant permissions to any participants and will require a subsequent
144
+ * permissions update to allow subscription.
145
+ *
146
+ * @param allParticipantsAllowed Allows all participants to subscribe all tracks.
147
+ * Takes precedence over [[participantTrackPermissions]] if set to true.
148
+ * By default this is set to true.
149
+ * @param participantTrackPermissions Full list of individual permissions per
150
+ * participant/track. Any omitted participants will not receive any permissions.
151
+ */
152
+ setTrackSubscriptionPermissions(allParticipantsAllowed: boolean, participantTrackPermissions?: ParticipantTrackPermission[]): void;
153
+ private updateTrackSubscriptionPermissions;
154
+ private waitUntilActiveAgentPresent;
155
+ private onTrackUpstreamPaused;
156
+ private onTrackUpstreamResumed;
157
+ private onTrackFeatureUpdate;
158
+ private onTrackCpuConstrained;
159
+ private handleLocalTrackUnpublished;
160
+ private handleTrackEnded;
161
+ private getPublicationForTrack;
162
+ private waitForPendingPublicationOfSource;
163
+ }
164
+ export default LocalParticipant;
@@ -0,0 +1,122 @@
1
+ import type { SipDTMF } from '@livekit/protocol';
2
+ import { DataPacket_Kind, Encryption_Type, ParticipantInfo, ParticipantInfo_Kind as ParticipantKind, ParticipantPermission, SubscriptionError } from '@livekit/protocol';
3
+ import type TypedEmitter from 'typed-emitter';
4
+ import type { StructuredLogger } from '../../logger';
5
+ import type { NonSharedUint8Array } from '../../type-polyfills/non-shared-typed-arrays';
6
+ import type LocalTrackPublication from '../track/LocalTrackPublication';
7
+ import type LocalVideoTrack from '../track/LocalVideoTrack';
8
+ import type RemoteTrack from '../track/RemoteTrack';
9
+ import type RemoteTrackPublication from '../track/RemoteTrackPublication';
10
+ import { Track } from '../track/Track';
11
+ import type { TrackPublication } from '../track/TrackPublication';
12
+ import type { ChatMessage, LoggerOptions, TranscriptionSegment } from '../types';
13
+ import { Future } from '../utils';
14
+ export declare enum ConnectionQuality {
15
+ Excellent = "excellent",
16
+ Good = "good",
17
+ Poor = "poor",
18
+ /**
19
+ * Indicates that a participant has temporarily (or permanently) lost connection to LiveKit.
20
+ * For permanent disconnection a `ParticipantDisconnected` event will be emitted after a timeout
21
+ */
22
+ Lost = "lost",
23
+ Unknown = "unknown"
24
+ }
25
+ export { ParticipantKind };
26
+ declare const Participant_base: new () => TypedEmitter<ParticipantEventCallbacks>;
27
+ export default class Participant extends Participant_base {
28
+ protected participantInfo?: ParticipantInfo;
29
+ audioTrackPublications: Map<string, TrackPublication>;
30
+ videoTrackPublications: Map<string, TrackPublication>;
31
+ /** map of track sid => all published tracks */
32
+ trackPublications: Map<string, TrackPublication>;
33
+ /** audio level between 0-1.0, 1 being loudest, 0 being softest */
34
+ audioLevel: number;
35
+ /** if participant is currently speaking */
36
+ isSpeaking: boolean;
37
+ /** server assigned unique id */
38
+ sid: string;
39
+ /** client assigned identity, encoded in JWT token */
40
+ identity: string;
41
+ /** client assigned display name, encoded in JWT token */
42
+ name?: string;
43
+ /** client metadata, opaque to livekit */
44
+ metadata?: string;
45
+ private _attributes;
46
+ lastSpokeAt?: Date | undefined;
47
+ permissions?: ParticipantPermission;
48
+ protected _kind: ParticipantKind;
49
+ private _connectionQuality;
50
+ protected log: StructuredLogger;
51
+ protected loggerOptions?: LoggerOptions;
52
+ protected activeFuture?: Future<void, Error>;
53
+ protected get logContext(): {
54
+ [x: string]: unknown;
55
+ };
56
+ get isEncrypted(): boolean;
57
+ get isAgent(): boolean;
58
+ get isActive(): boolean;
59
+ get kind(): ParticipantKind;
60
+ get attributes(): Readonly<Record<string, string>>;
61
+ getTrackPublications(): TrackPublication[];
62
+ /**
63
+ * Finds the first track that matches the source filter, for example, getting
64
+ * the user's camera track with getTrackBySource(Track.Source.Camera).
65
+ */
66
+ getTrackPublication(source: Track.Source): TrackPublication | undefined;
67
+ /**
68
+ * Finds the first track that matches the track's name.
69
+ */
70
+ getTrackPublicationByName(name: string): TrackPublication | undefined;
71
+ /**
72
+ * Waits until the participant is active and ready to receive data messages
73
+ * @returns a promise that resolves when the participant is active
74
+ */
75
+ waitUntilActive(): Promise<void>;
76
+ get connectionQuality(): ConnectionQuality;
77
+ get isCameraEnabled(): boolean;
78
+ get isMicrophoneEnabled(): boolean;
79
+ get isScreenShareEnabled(): boolean;
80
+ get isLocal(): boolean;
81
+ get joinedAt(): (Date | undefined);
82
+ /**
83
+ * Updates metadata from server
84
+ **/
85
+ private _setMetadata;
86
+ private _setName;
87
+ /**
88
+ * Updates metadata from server
89
+ **/
90
+ private _setAttributes;
91
+ protected addTrackPublication(publication: TrackPublication): void;
92
+ }
93
+ export type ParticipantEventCallbacks = {
94
+ trackPublished: (publication: RemoteTrackPublication) => void;
95
+ trackSubscribed: (track: RemoteTrack, publication: RemoteTrackPublication) => void;
96
+ trackSubscriptionFailed: (trackSid: string, reason?: SubscriptionError) => void;
97
+ trackUnpublished: (publication: RemoteTrackPublication) => void;
98
+ trackUnsubscribed: (track: RemoteTrack, publication: RemoteTrackPublication) => void;
99
+ trackMuted: (publication: TrackPublication) => void;
100
+ trackUnmuted: (publication: TrackPublication) => void;
101
+ localTrackPublished: (publication: LocalTrackPublication) => void;
102
+ localTrackUnpublished: (publication: LocalTrackPublication) => void;
103
+ localTrackCpuConstrained: (track: LocalVideoTrack, publication: LocalTrackPublication) => void;
104
+ localSenderCreated: (sender: RTCRtpSender, track: Track) => void;
105
+ participantMetadataChanged: (prevMetadata: string | undefined, participant?: any) => void;
106
+ participantNameChanged: (name: string) => void;
107
+ dataReceived: (payload: NonSharedUint8Array, kind: DataPacket_Kind, encryptionType?: Encryption_Type) => void;
108
+ sipDTMFReceived: (dtmf: SipDTMF) => void;
109
+ transcriptionReceived: (transcription: TranscriptionSegment[], publication?: TrackPublication) => void;
110
+ isSpeakingChanged: (speaking: boolean) => void;
111
+ connectionQualityChanged: (connectionQuality: ConnectionQuality) => void;
112
+ trackStreamStateChanged: (publication: RemoteTrackPublication, streamState: Track.StreamState) => void;
113
+ trackSubscriptionPermissionChanged: (publication: RemoteTrackPublication, status: TrackPublication.PermissionStatus) => void;
114
+ mediaDevicesError: (error: Error, kind?: MediaDeviceKind) => void;
115
+ audioStreamAcquired: () => void;
116
+ participantPermissionsChanged: (prevPermissions?: ParticipantPermission) => void;
117
+ trackSubscriptionStatusChanged: (publication: RemoteTrackPublication, status: TrackPublication.SubscriptionStatus) => void;
118
+ attributesChanged: (changedAttributes: Record<string, string>) => void;
119
+ localTrackSubscribed: (trackPublication: LocalTrackPublication) => void;
120
+ chatMessage: (msg: ChatMessage) => void;
121
+ active: () => void;
122
+ };
@@ -0,0 +1,25 @@
1
+ import { TrackPermission } from '@livekit/protocol';
2
+ export interface ParticipantTrackPermission {
3
+ /**
4
+ * The participant identity this permission applies to.
5
+ * You can either provide this or `participantSid`
6
+ */
7
+ participantIdentity?: string;
8
+ /**
9
+ * The participant server id this permission applies to.
10
+ * You can either provide this or `participantIdentity`
11
+ */
12
+ participantSid?: string;
13
+ /**
14
+ * Grant permission to all all tracks. Takes precedence over allowedTrackSids.
15
+ * false if unset.
16
+ */
17
+ allowAll?: boolean;
18
+ /**
19
+ * The list of track ids that the target participant can subscribe to.
20
+ * When unset, it'll allow all tracks to be subscribed by the participant.
21
+ * When empty, this participant is disallowed from subscribing to any tracks.
22
+ */
23
+ allowedTrackSids?: string[];
24
+ }
25
+ export declare function trackPermissionToProto(perms: ParticipantTrackPermission): TrackPermission;
@@ -0,0 +1,37 @@
1
+ import { DeferrableMap } from '../../utils/deferrable-map';
2
+ import type RemoteDataTrack from '../data-track/RemoteDataTrack';
3
+ import RemoteTrackPublication from '../track/RemoteTrackPublication';
4
+ import { Track } from '../track/Track';
5
+ import Participant from './Participant';
6
+ export default class RemoteParticipant extends Participant {
7
+ audioTrackPublications: Map<string, RemoteTrackPublication>;
8
+ videoTrackPublications: Map<string, RemoteTrackPublication>;
9
+ trackPublications: Map<string, RemoteTrackPublication>;
10
+ /** A map of data track name to the corresponding {@link RemoteDataTrack}.
11
+ * @example
12
+ * // An already existing data track:
13
+ * const track = remoteParticipant.dataTracks.get("data track name");
14
+ * // Wait for a data track which will be published soon:
15
+ * const track = await remoteParticipant.dataTracks.getDeferred("data track name"); */
16
+ dataTracks: DeferrableMap<RemoteDataTrack['info']['name'], RemoteDataTrack>;
17
+ private volumeMap;
18
+ private audioOutput?;
19
+ protected get logContext(): {
20
+ remoteParticipantID: string;
21
+ remoteParticipant: string;
22
+ };
23
+ protected addTrackPublication(publication: RemoteTrackPublication): void;
24
+ getTrackPublication(source: Track.Source): RemoteTrackPublication | undefined;
25
+ getTrackPublicationByName(name: string): RemoteTrackPublication | undefined;
26
+ /**
27
+ * sets the volume on the participant's audio track
28
+ * by default, this affects the microphone publication
29
+ * a different source can be passed in as a second argument
30
+ * if no track exists the volume will be applied when the microphone track is added
31
+ */
32
+ setVolume(volume: number, source?: Track.Source.Microphone | Track.Source.ScreenShareAudio): void;
33
+ /**
34
+ * gets the volume on the participant's microphone track
35
+ */
36
+ getVolume(source?: Track.Source.Microphone | Track.Source.ScreenShareAudio): number | undefined;
37
+ }
@@ -0,0 +1,11 @@
1
+ import LocalVideoTrack from '../track/LocalVideoTrack';
2
+ import type { BackupVideoCodec, TrackPublishOptions } from '../track/options';
3
+ export declare function computeTrackBackupEncodings(track: LocalVideoTrack, videoCodec: BackupVideoCodec, opts: TrackPublishOptions): RTCRtpEncodingParameters[] | undefined;
4
+ /**
5
+ * Returns the appropriate degradation preference for a video track based on its source.
6
+ *
7
+ * - Camera: 'maintain-framerate' (smoother video for real-time communication)
8
+ * - Screen share: 'maintain-resolution' (clarity is critical for reading text/UI)
9
+ * - Other/unknown: 'balanced'
10
+ */
11
+ export declare function getDefaultDegradationPreference(track: LocalVideoTrack): RTCDegradationPreference;
@@ -0,0 +1,7 @@
1
+ import type { DataPacket } from '@livekit/protocol';
2
+ export type EventSendDataPacket = {
3
+ packet: DataPacket;
4
+ };
5
+ export type RpcClientManagerCallbacks = {
6
+ sendDataPacket: (event: EventSendDataPacket) => void;
7
+ };
@@ -0,0 +1,73 @@
1
+ import type { RpcInvocationData } from '.';
2
+ import { RpcError } from '.';
3
+ import type TypedPromise from '../../utils/TypedPromise';
4
+ import type { CoreRoom } from '../CoreRoom';
5
+ import type { DataPacketOwner, ExtensionContext, LocalParticipantApiProvider, RoomApiProvider } from '../extensions';
6
+ import type { PerformRpcParams } from './utils';
7
+ /**
8
+ * Methods the `rpc` extension adds to the room.
9
+ * @experimental
10
+ */
11
+ export interface RpcRoomApi {
12
+ /**
13
+ * Establishes the participant as a receiver for calls of the specified RPC method.
14
+ *
15
+ * @param method - The name of the indicated RPC method
16
+ * @param handler - Will be invoked when an RPC request for this method is received
17
+ * @returns A promise that resolves when the method is successfully registered
18
+ * @throws {Error} If a handler for this method is already registered (must call unregisterRpcMethod first)
19
+ *
20
+ * @example
21
+ * ```typescript
22
+ * room.localParticipant?.registerRpcMethod(
23
+ * 'greet',
24
+ * async (data: RpcInvocationData) => {
25
+ * console.log(`Received greeting from ${data.callerIdentity}: ${data.payload}`);
26
+ * return `Hello, ${data.callerIdentity}!`;
27
+ * }
28
+ * );
29
+ * ```
30
+ *
31
+ * The handler should return a Promise that resolves to a string.
32
+ * If unable to respond within `responseTimeout`, the request will result in an error on the caller's side.
33
+ *
34
+ * You may throw errors of type `RpcError` with a string `message` in the handler,
35
+ * and they will be received on the caller's side with the message intact.
36
+ * Other errors thrown in your handler will not be transmitted as-is, and will instead arrive to the caller as `1500` ("Application Error").
37
+ */
38
+ registerRpcMethod(method: string, handler: (data: RpcInvocationData) => Promise<string>): void;
39
+ /**
40
+ * Unregisters a previously registered RPC method.
41
+ *
42
+ * @param method - The name of the RPC method to unregister
43
+ */
44
+ unregisterRpcMethod(method: string): void;
45
+ }
46
+ /**
47
+ * Methods the `rpc` extension adds to the local participant.
48
+ * @experimental
49
+ */
50
+ export interface RpcLocalParticipantApi {
51
+ /**
52
+ * Initiate an RPC call to a remote participant
53
+ * @param params - Parameters for initiating the RPC call, see {@link PerformRpcParams}
54
+ * @returns A promise that resolves with the response payload or rejects with an error.
55
+ * @throws Error on failure. Details in `message`.
56
+ */
57
+ performRpc(params: PerformRpcParams): TypedPromise<string, RpcError>;
58
+ }
59
+ /**
60
+ * RPC over the room (`performRpc`, `registerRpcMethod`). Requires {@link dataStreams}.
61
+ * @experimental
62
+ */
63
+ export declare const rpc: {
64
+ key: symbol;
65
+ requires: readonly [
66
+ import("../extensions").ConfigurableExtension<RoomApiProvider<import("../data-stream/extension").DataStreamRoomApi> & LocalParticipantApiProvider<import("../data-stream/extension").DataStreamLocalParticipantApi> & import("../extensions").SlotProvider<"byteStreamOpener"> & DataPacketOwner & import("../extensions").EngineHooks & import("../extensions").ConnectionHooks & {
67
+ incoming: import("../data-stream/incoming/IncomingDataStreamManager").default;
68
+ outgoing: import("../data-stream/outgoing/OutgoingDataStreamManager").default;
69
+ }, import("../../options").RoomDataStreamOptions, readonly [
70
+ ]>
71
+ ];
72
+ install(room: CoreRoom, ctx: ExtensionContext): RoomApiProvider<RpcRoomApi> & LocalParticipantApiProvider<RpcLocalParticipantApi> & DataPacketOwner;
73
+ };
@@ -0,0 +1,6 @@
1
+ export { default as RpcClientManager } from './client/RpcClientManager';
2
+ export type { RpcClientManagerCallbacks } from './client/events';
3
+ export { default as RpcServerManager } from './server/RpcServerManager';
4
+ export type { RpcServerManagerCallbacks } from './server/events';
5
+ export type { PerformRpcParams, RpcInvocationData } from './utils';
6
+ export { RpcError } from './utils';