djs-selfbot-v13 3.2.2 → 3.7.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 (363) hide show
  1. package/README.md +37 -36
  2. package/package.json +89 -85
  3. package/src/WebSocket.js +39 -39
  4. package/src/client/BaseClient.js +86 -86
  5. package/src/client/Client.js +934 -836
  6. package/src/client/WebhookClient.js +61 -61
  7. package/src/client/actions/Action.js +116 -120
  8. package/src/client/actions/ActionsManager.js +80 -78
  9. package/src/client/actions/ApplicationCommandPermissionsUpdate.js +34 -34
  10. package/src/client/actions/AutoModerationActionExecution.js +27 -27
  11. package/src/client/actions/AutoModerationRuleCreate.js +28 -28
  12. package/src/client/actions/AutoModerationRuleDelete.js +32 -32
  13. package/src/client/actions/AutoModerationRuleUpdate.js +30 -30
  14. package/src/client/actions/ChannelCreate.js +23 -23
  15. package/src/client/actions/ChannelDelete.js +39 -39
  16. package/src/client/actions/ChannelUpdate.js +43 -43
  17. package/src/client/actions/GuildAuditLogEntryCreate.js +29 -29
  18. package/src/client/actions/GuildBanAdd.js +20 -20
  19. package/src/client/actions/GuildBanRemove.js +25 -25
  20. package/src/client/actions/GuildChannelsPositionUpdate.js +21 -21
  21. package/src/client/actions/GuildDelete.js +65 -65
  22. package/src/client/actions/GuildEmojiCreate.js +20 -20
  23. package/src/client/actions/GuildEmojiDelete.js +21 -21
  24. package/src/client/actions/GuildEmojiUpdate.js +20 -20
  25. package/src/client/actions/GuildEmojisUpdate.js +34 -34
  26. package/src/client/actions/GuildIntegrationsUpdate.js +19 -19
  27. package/src/client/actions/GuildMemberRemove.js +33 -32
  28. package/src/client/actions/GuildMemberUpdate.js +44 -43
  29. package/src/client/actions/GuildRoleCreate.js +25 -25
  30. package/src/client/actions/GuildRoleDelete.js +31 -31
  31. package/src/client/actions/GuildRoleUpdate.js +39 -39
  32. package/src/client/actions/GuildRolesPositionUpdate.js +21 -21
  33. package/src/client/actions/GuildScheduledEventCreate.js +27 -27
  34. package/src/client/actions/GuildScheduledEventDelete.js +31 -31
  35. package/src/client/actions/GuildScheduledEventUpdate.js +30 -30
  36. package/src/client/actions/GuildScheduledEventUserAdd.js +32 -32
  37. package/src/client/actions/GuildScheduledEventUserRemove.js +32 -32
  38. package/src/client/actions/GuildStickerCreate.js +20 -20
  39. package/src/client/actions/GuildStickerDelete.js +21 -21
  40. package/src/client/actions/GuildStickerUpdate.js +20 -20
  41. package/src/client/actions/GuildStickersUpdate.js +34 -34
  42. package/src/client/actions/GuildUpdate.js +33 -33
  43. package/src/client/actions/InviteCreate.js +28 -28
  44. package/src/client/actions/InviteDelete.js +30 -30
  45. package/src/client/actions/MessageCreate.js +50 -46
  46. package/src/client/actions/MessageDelete.js +32 -32
  47. package/src/client/actions/MessageDeleteBulk.js +46 -46
  48. package/src/client/actions/MessagePollVoteAdd.js +33 -0
  49. package/src/client/actions/MessagePollVoteRemove.js +33 -0
  50. package/src/client/actions/MessageReactionAdd.js +68 -56
  51. package/src/client/actions/MessageReactionRemove.js +50 -45
  52. package/src/client/actions/MessageReactionRemoveAll.js +33 -33
  53. package/src/client/actions/MessageReactionRemoveEmoji.js +28 -28
  54. package/src/client/actions/MessageUpdate.js +26 -26
  55. package/src/client/actions/PresenceUpdate.js +50 -46
  56. package/src/client/actions/StageInstanceCreate.js +28 -28
  57. package/src/client/actions/StageInstanceDelete.js +33 -33
  58. package/src/client/actions/StageInstanceUpdate.js +30 -30
  59. package/src/client/actions/ThreadCreate.js +24 -24
  60. package/src/client/actions/ThreadDelete.js +32 -32
  61. package/src/client/actions/ThreadListSync.js +59 -59
  62. package/src/client/actions/ThreadMemberUpdate.js +30 -30
  63. package/src/client/actions/ThreadMembersUpdate.js +34 -34
  64. package/src/client/actions/TypingStart.js +29 -29
  65. package/src/client/actions/UserUpdate.js +35 -35
  66. package/src/client/actions/VoiceStateUpdate.js +50 -57
  67. package/src/client/actions/WebhooksUpdate.js +20 -20
  68. package/src/client/voice/ClientVoiceManager.js +151 -51
  69. package/src/client/voice/VoiceConnection.js +1249 -0
  70. package/src/client/voice/dispatcher/AnnexBDispatcher.js +120 -0
  71. package/src/client/voice/dispatcher/AudioDispatcher.js +145 -0
  72. package/src/client/voice/dispatcher/BaseDispatcher.js +459 -0
  73. package/src/client/voice/dispatcher/VPxDispatcher.js +54 -0
  74. package/src/client/voice/dispatcher/VideoDispatcher.js +68 -0
  75. package/src/client/voice/networking/VoiceUDPClient.js +173 -0
  76. package/src/client/voice/networking/VoiceWebSocket.js +286 -0
  77. package/src/client/voice/player/MediaPlayer.js +321 -0
  78. package/src/client/voice/player/processing/AnnexBNalSplitter.js +244 -0
  79. package/src/client/voice/player/processing/IvfSplitter.js +106 -0
  80. package/src/client/voice/player/processing/PCMInsertSilence.js +37 -0
  81. package/src/client/voice/receiver/PacketHandler.js +260 -0
  82. package/src/client/voice/receiver/Receiver.js +96 -0
  83. package/src/client/voice/receiver/Recorder.js +173 -0
  84. package/src/client/voice/util/Function.js +116 -0
  85. package/src/client/voice/util/PlayInterface.js +122 -0
  86. package/src/client/voice/util/Secretbox.js +64 -0
  87. package/src/client/voice/util/Silence.js +16 -0
  88. package/src/client/voice/util/Socket.js +62 -0
  89. package/src/client/voice/util/VolumeInterface.js +104 -0
  90. package/src/client/websocket/WebSocketManager.js +392 -392
  91. package/src/client/websocket/WebSocketShard.js +907 -906
  92. package/src/client/websocket/handlers/APPLICATION_COMMAND_CREATE.js +18 -18
  93. package/src/client/websocket/handlers/APPLICATION_COMMAND_DELETE.js +20 -20
  94. package/src/client/websocket/handlers/APPLICATION_COMMAND_PERMISSIONS_UPDATE.js +5 -5
  95. package/src/client/websocket/handlers/APPLICATION_COMMAND_UPDATE.js +20 -20
  96. package/src/client/websocket/handlers/AUTO_MODERATION_ACTION_EXECUTION.js +5 -5
  97. package/src/client/websocket/handlers/AUTO_MODERATION_RULE_CREATE.js +5 -5
  98. package/src/client/websocket/handlers/AUTO_MODERATION_RULE_DELETE.js +5 -5
  99. package/src/client/websocket/handlers/AUTO_MODERATION_RULE_UPDATE.js +5 -5
  100. package/src/client/websocket/handlers/CALL_CREATE.js +14 -14
  101. package/src/client/websocket/handlers/CALL_DELETE.js +11 -11
  102. package/src/client/websocket/handlers/CALL_UPDATE.js +11 -11
  103. package/src/client/websocket/handlers/CHANNEL_CREATE.js +5 -5
  104. package/src/client/websocket/handlers/CHANNEL_DELETE.js +5 -5
  105. package/src/client/websocket/handlers/CHANNEL_PINS_UPDATE.js +22 -22
  106. package/src/client/websocket/handlers/CHANNEL_RECIPIENT_ADD.js +19 -19
  107. package/src/client/websocket/handlers/CHANNEL_RECIPIENT_REMOVE.js +16 -16
  108. package/src/client/websocket/handlers/CHANNEL_UPDATE.js +16 -16
  109. package/src/client/websocket/handlers/GUILD_AUDIT_LOG_ENTRY_CREATE.js +5 -5
  110. package/src/client/websocket/handlers/GUILD_BAN_ADD.js +5 -5
  111. package/src/client/websocket/handlers/GUILD_BAN_REMOVE.js +5 -5
  112. package/src/client/websocket/handlers/GUILD_CREATE.js +52 -52
  113. package/src/client/websocket/handlers/GUILD_DELETE.js +5 -5
  114. package/src/client/websocket/handlers/GUILD_EMOJIS_UPDATE.js +5 -5
  115. package/src/client/websocket/handlers/GUILD_INTEGRATIONS_UPDATE.js +5 -5
  116. package/src/client/websocket/handlers/GUILD_MEMBERS_CHUNK.js +39 -39
  117. package/src/client/websocket/handlers/GUILD_MEMBER_ADD.js +20 -19
  118. package/src/client/websocket/handlers/GUILD_MEMBER_REMOVE.js +5 -5
  119. package/src/client/websocket/handlers/GUILD_MEMBER_UPDATE.js +5 -5
  120. package/src/client/websocket/handlers/GUILD_ROLE_CREATE.js +5 -5
  121. package/src/client/websocket/handlers/GUILD_ROLE_DELETE.js +5 -5
  122. package/src/client/websocket/handlers/GUILD_ROLE_UPDATE.js +5 -5
  123. package/src/client/websocket/handlers/GUILD_SCHEDULED_EVENT_CREATE.js +5 -5
  124. package/src/client/websocket/handlers/GUILD_SCHEDULED_EVENT_DELETE.js +5 -5
  125. package/src/client/websocket/handlers/GUILD_SCHEDULED_EVENT_UPDATE.js +5 -5
  126. package/src/client/websocket/handlers/GUILD_SCHEDULED_EVENT_USER_ADD.js +5 -5
  127. package/src/client/websocket/handlers/GUILD_SCHEDULED_EVENT_USER_REMOVE.js +5 -5
  128. package/src/client/websocket/handlers/GUILD_STICKERS_UPDATE.js +5 -5
  129. package/src/client/websocket/handlers/GUILD_UPDATE.js +5 -5
  130. package/src/client/websocket/handlers/INTERACTION_MODAL_CREATE.js +12 -12
  131. package/src/client/websocket/handlers/INVITE_CREATE.js +5 -5
  132. package/src/client/websocket/handlers/INVITE_DELETE.js +5 -5
  133. package/src/client/websocket/handlers/MESSAGE_CREATE.js +5 -5
  134. package/src/client/websocket/handlers/MESSAGE_DELETE.js +5 -5
  135. package/src/client/websocket/handlers/MESSAGE_DELETE_BULK.js +5 -5
  136. package/src/client/websocket/handlers/MESSAGE_POLL_VOTE_ADD.js +5 -22
  137. package/src/client/websocket/handlers/MESSAGE_POLL_VOTE_REMOVE.js +5 -12
  138. package/src/client/websocket/handlers/MESSAGE_REACTION_ADD.js +5 -5
  139. package/src/client/websocket/handlers/MESSAGE_REACTION_REMOVE.js +5 -5
  140. package/src/client/websocket/handlers/MESSAGE_REACTION_REMOVE_ALL.js +5 -5
  141. package/src/client/websocket/handlers/MESSAGE_REACTION_REMOVE_EMOJI.js +5 -5
  142. package/src/client/websocket/handlers/MESSAGE_UPDATE.js +16 -16
  143. package/src/client/websocket/handlers/PRESENCE_UPDATE.js +5 -5
  144. package/src/client/websocket/handlers/READY.js +121 -120
  145. package/src/client/websocket/handlers/RELATIONSHIP_ADD.js +19 -19
  146. package/src/client/websocket/handlers/RELATIONSHIP_REMOVE.js +17 -17
  147. package/src/client/websocket/handlers/RELATIONSHIP_UPDATE.js +41 -41
  148. package/src/client/websocket/handlers/RESUMED.js +14 -14
  149. package/src/client/websocket/handlers/STAGE_INSTANCE_CREATE.js +5 -5
  150. package/src/client/websocket/handlers/STAGE_INSTANCE_DELETE.js +5 -5
  151. package/src/client/websocket/handlers/STAGE_INSTANCE_UPDATE.js +5 -5
  152. package/src/client/websocket/handlers/THREAD_CREATE.js +5 -5
  153. package/src/client/websocket/handlers/THREAD_DELETE.js +5 -5
  154. package/src/client/websocket/handlers/THREAD_LIST_SYNC.js +5 -5
  155. package/src/client/websocket/handlers/THREAD_MEMBERS_UPDATE.js +5 -5
  156. package/src/client/websocket/handlers/THREAD_MEMBER_UPDATE.js +5 -5
  157. package/src/client/websocket/handlers/THREAD_UPDATE.js +16 -16
  158. package/src/client/websocket/handlers/TYPING_START.js +5 -5
  159. package/src/client/websocket/handlers/USER_GUILD_SETTINGS_UPDATE.js +6 -6
  160. package/src/client/websocket/handlers/USER_NOTE_UPDATE.js +5 -5
  161. package/src/client/websocket/handlers/USER_REQUIRED_ACTION_UPDATE.js +78 -78
  162. package/src/client/websocket/handlers/USER_SETTINGS_UPDATE.js +5 -5
  163. package/src/client/websocket/handlers/USER_UPDATE.js +5 -5
  164. package/src/client/websocket/handlers/VOICE_CHANNEL_EFFECT_SEND.js +16 -0
  165. package/src/client/websocket/handlers/VOICE_CHANNEL_STATUS_UPDATE.js +12 -12
  166. package/src/client/websocket/handlers/VOICE_SERVER_UPDATE.js +6 -6
  167. package/src/client/websocket/handlers/VOICE_STATE_UPDATE.js +5 -5
  168. package/src/client/websocket/handlers/WEBHOOKS_UPDATE.js +5 -5
  169. package/src/client/websocket/handlers/index.js +84 -83
  170. package/src/errors/DJSError.js +61 -61
  171. package/src/errors/Messages.js +217 -183
  172. package/src/errors/index.js +4 -4
  173. package/src/index.js +172 -159
  174. package/src/managers/ApplicationCommandManager.js +264 -264
  175. package/src/managers/ApplicationCommandPermissionsManager.js +417 -417
  176. package/src/managers/AutoModerationRuleManager.js +296 -296
  177. package/src/managers/BaseGuildEmojiManager.js +80 -80
  178. package/src/managers/BaseManager.js +19 -19
  179. package/src/managers/BillingManager.js +66 -66
  180. package/src/managers/CachedManager.js +71 -71
  181. package/src/managers/ChannelManager.js +148 -138
  182. package/src/managers/ClientUserSettingManager.js +372 -372
  183. package/src/managers/DataManager.js +61 -61
  184. package/src/managers/GuildBanManager.js +250 -250
  185. package/src/managers/GuildChannelManager.js +488 -488
  186. package/src/managers/GuildEmojiManager.js +171 -171
  187. package/src/managers/GuildEmojiRoleManager.js +118 -118
  188. package/src/managers/GuildForumThreadManager.js +108 -108
  189. package/src/managers/GuildInviteManager.js +213 -213
  190. package/src/managers/GuildManager.js +338 -304
  191. package/src/managers/GuildMemberManager.js +599 -597
  192. package/src/managers/GuildMemberRoleManager.js +195 -191
  193. package/src/managers/GuildScheduledEventManager.js +314 -296
  194. package/src/managers/GuildSettingManager.js +155 -155
  195. package/src/managers/GuildStickerManager.js +179 -179
  196. package/src/managers/GuildTextThreadManager.js +98 -98
  197. package/src/managers/InteractionManager.js +39 -39
  198. package/src/managers/MessageManager.js +423 -391
  199. package/src/managers/PermissionOverwriteManager.js +164 -166
  200. package/src/managers/PresenceManager.js +71 -58
  201. package/src/managers/ReactionManager.js +67 -67
  202. package/src/managers/ReactionUserManager.js +73 -71
  203. package/src/managers/RelationshipManager.js +278 -265
  204. package/src/managers/RoleManager.js +448 -352
  205. package/src/managers/SessionManager.js +66 -0
  206. package/src/managers/StageInstanceManager.js +162 -162
  207. package/src/managers/ThreadManager.js +175 -174
  208. package/src/managers/ThreadMemberManager.js +186 -186
  209. package/src/managers/UserManager.js +136 -146
  210. package/src/managers/UserNoteManager.js +53 -53
  211. package/src/managers/VoiceStateManager.js +59 -37
  212. package/src/rest/APIRequest.js +154 -160
  213. package/src/rest/APIRouter.js +53 -53
  214. package/src/rest/DiscordAPIError.js +119 -104
  215. package/src/rest/HTTPError.js +62 -62
  216. package/src/rest/RESTManager.js +67 -62
  217. package/src/rest/RateLimitError.js +55 -55
  218. package/src/rest/RequestHandler.js +466 -444
  219. package/src/sharding/Shard.js +444 -443
  220. package/src/sharding/ShardClientUtil.js +279 -275
  221. package/src/sharding/ShardingManager.js +319 -318
  222. package/src/structures/AnonymousGuild.js +98 -98
  223. package/src/structures/ApplicationCommand.js +593 -593
  224. package/src/structures/ApplicationRoleConnectionMetadata.js +48 -48
  225. package/src/structures/AutoModerationActionExecution.js +89 -89
  226. package/src/structures/AutoModerationRule.js +294 -294
  227. package/src/structures/AutocompleteInteraction.js +107 -107
  228. package/src/structures/Base.js +43 -43
  229. package/src/structures/BaseCommandInteraction.js +211 -211
  230. package/src/structures/BaseGuild.js +116 -116
  231. package/src/structures/BaseGuildEmoji.js +56 -56
  232. package/src/structures/BaseGuildTextChannel.js +191 -191
  233. package/src/structures/BaseGuildVoiceChannel.js +241 -241
  234. package/src/structures/BaseMessageComponent.js +181 -114
  235. package/src/structures/ButtonInteraction.js +11 -11
  236. package/src/structures/CallState.js +63 -63
  237. package/src/structures/CategoryChannel.js +85 -85
  238. package/src/structures/Channel.js +284 -270
  239. package/src/structures/ClientPresence.js +77 -85
  240. package/src/structures/ClientUser.js +479 -448
  241. package/src/structures/CommandInteraction.js +41 -41
  242. package/src/structures/CommandInteractionOptionResolver.js +276 -276
  243. package/src/structures/ContainerComponent.js +68 -0
  244. package/src/structures/ContextMenuInteraction.js +65 -65
  245. package/src/structures/DMChannel.js +219 -217
  246. package/src/structures/DirectoryChannel.js +20 -20
  247. package/src/structures/Emoji.js +148 -148
  248. package/src/structures/FileComponent.js +49 -0
  249. package/src/structures/ForumChannel.js +31 -261
  250. package/src/structures/GroupDMChannel.js +394 -387
  251. package/src/structures/Guild.js +1643 -1608
  252. package/src/structures/GuildAuditLogs.js +746 -729
  253. package/src/structures/GuildBan.js +59 -59
  254. package/src/structures/GuildBoost.js +108 -108
  255. package/src/structures/GuildChannel.js +470 -468
  256. package/src/structures/GuildEmoji.js +161 -161
  257. package/src/structures/GuildMember.js +636 -568
  258. package/src/structures/GuildPreview.js +191 -191
  259. package/src/structures/GuildPreviewEmoji.js +27 -27
  260. package/src/structures/GuildScheduledEvent.js +536 -441
  261. package/src/structures/GuildTemplate.js +236 -236
  262. package/src/structures/Integration.js +188 -188
  263. package/src/structures/IntegrationApplication.js +96 -96
  264. package/src/structures/Interaction.js +290 -290
  265. package/src/structures/InteractionCollector.js +248 -248
  266. package/src/structures/InteractionWebhook.js +43 -43
  267. package/src/structures/Invite.js +358 -358
  268. package/src/structures/InviteGuild.js +23 -23
  269. package/src/structures/InviteStageInstance.js +86 -86
  270. package/src/structures/MediaChannel.js +11 -0
  271. package/src/structures/MediaGalleryComponent.js +41 -0
  272. package/src/structures/MediaGalleryItem.js +47 -0
  273. package/src/structures/Message.js +1252 -1227
  274. package/src/structures/MessageActionRow.js +105 -103
  275. package/src/structures/MessageAttachment.js +216 -204
  276. package/src/structures/MessageButton.js +166 -165
  277. package/src/structures/MessageCollector.js +146 -146
  278. package/src/structures/MessageComponentInteraction.js +120 -120
  279. package/src/structures/MessageContextMenuInteraction.js +20 -20
  280. package/src/structures/MessageEmbed.js +596 -586
  281. package/src/structures/MessageMentions.js +273 -273
  282. package/src/structures/MessagePayload.js +354 -318
  283. package/src/structures/MessageReaction.js +181 -171
  284. package/src/structures/MessageSelectMenu.js +141 -140
  285. package/src/structures/Modal.js +161 -161
  286. package/src/structures/ModalSubmitFieldsResolver.js +53 -53
  287. package/src/structures/ModalSubmitInteraction.js +119 -119
  288. package/src/structures/NewsChannel.js +32 -32
  289. package/src/structures/OAuth2Guild.js +28 -28
  290. package/src/structures/PermissionOverwrites.js +198 -196
  291. package/src/structures/Poll.js +108 -0
  292. package/src/structures/PollAnswer.js +88 -0
  293. package/src/structures/Presence.js +1105 -1101
  294. package/src/structures/ReactionCollector.js +229 -229
  295. package/src/structures/ReactionEmoji.js +31 -31
  296. package/src/structures/Role.js +590 -531
  297. package/src/structures/SectionComponent.js +48 -0
  298. package/src/structures/SelectMenuInteraction.js +21 -21
  299. package/src/structures/SeparatorComponent.js +48 -0
  300. package/src/structures/Session.js +81 -0
  301. package/src/structures/StageChannel.js +104 -104
  302. package/src/structures/StageInstance.js +208 -208
  303. package/src/structures/Sticker.js +310 -310
  304. package/src/structures/StickerPack.js +95 -95
  305. package/src/structures/StoreChannel.js +56 -56
  306. package/src/structures/Team.js +118 -118
  307. package/src/structures/TeamMember.js +80 -71
  308. package/src/structures/TextChannel.js +33 -33
  309. package/src/structures/TextDisplayComponent.js +40 -0
  310. package/src/structures/TextInputComponent.js +132 -131
  311. package/src/structures/ThreadChannel.js +605 -607
  312. package/src/structures/ThreadMember.js +105 -105
  313. package/src/structures/ThreadOnlyChannel.js +249 -0
  314. package/src/structures/ThumbnailComponent.js +57 -0
  315. package/src/structures/Typing.js +74 -74
  316. package/src/structures/UnfurledMediaItem.js +29 -0
  317. package/src/structures/User.js +640 -543
  318. package/src/structures/UserContextMenuInteraction.js +29 -29
  319. package/src/structures/VoiceChannel.js +110 -110
  320. package/src/structures/VoiceChannelEffect.js +69 -0
  321. package/src/structures/VoiceRegion.js +53 -53
  322. package/src/structures/VoiceState.js +354 -341
  323. package/src/structures/WebEmbed.js +373 -373
  324. package/src/structures/Webhook.js +478 -467
  325. package/src/structures/WelcomeChannel.js +60 -60
  326. package/src/structures/WelcomeScreen.js +48 -48
  327. package/src/structures/Widget.js +87 -87
  328. package/src/structures/WidgetMember.js +99 -99
  329. package/src/structures/interfaces/Application.js +825 -313
  330. package/src/structures/interfaces/Collector.js +300 -300
  331. package/src/structures/interfaces/InteractionResponses.js +313 -313
  332. package/src/structures/interfaces/TextBasedChannel.js +759 -719
  333. package/src/util/APITypes.js +59 -0
  334. package/src/util/ActivityFlags.js +44 -44
  335. package/src/util/ApplicationFlags.js +76 -76
  336. package/src/util/AttachmentFlags.js +38 -38
  337. package/src/util/BitField.js +170 -170
  338. package/src/util/ChannelFlags.js +45 -45
  339. package/src/util/Constants.js +1914 -1773
  340. package/src/util/DataResolver.js +146 -145
  341. package/src/util/Formatters.js +228 -228
  342. package/src/util/GuildMemberFlags.js +43 -43
  343. package/src/util/Intents.js +74 -74
  344. package/src/util/InviteFlags.js +34 -29
  345. package/src/util/LimitedCollection.js +131 -131
  346. package/src/util/MessageFlags.js +63 -54
  347. package/src/util/Options.js +358 -336
  348. package/src/util/Permissions.js +202 -202
  349. package/src/util/PremiumUsageFlags.js +31 -31
  350. package/src/util/PurchasedFlags.js +33 -33
  351. package/src/util/RemoteAuth.js +382 -379
  352. package/src/util/RoleFlags.js +37 -37
  353. package/src/util/SnowflakeUtil.js +92 -92
  354. package/src/util/Speaking.js +33 -0
  355. package/src/util/Sweepers.js +466 -466
  356. package/src/util/SystemChannelFlags.js +55 -55
  357. package/src/util/ThreadMemberFlags.js +30 -30
  358. package/src/util/UserFlags.js +104 -104
  359. package/src/util/Util.js +1048 -889
  360. package/typings/enums.d.ts +439 -297
  361. package/typings/index.d.ts +8247 -7432
  362. package/typings/rawDataTypes.d.ts +403 -342
  363. package/src/structures/MessagePoll.js +0 -238
@@ -0,0 +1,260 @@
1
+ 'use strict';
2
+
3
+ const EventEmitter = require('events');
4
+ const { Buffer } = require('node:buffer');
5
+ const crypto = require('node:crypto');
6
+ const { setTimeout } = require('node:timers');
7
+ const { RtpPacket } = require('werift-rtp');
8
+ const Recorder = require('./Recorder');
9
+ const Speaking = require('../../../util/Speaking');
10
+ const Util = require('../../../util/Util');
11
+ const secretbox = require('../util/Secretbox');
12
+ const { SILENCE_FRAME } = require('../util/Silence');
13
+
14
+ // The delay between packets when a user is considered to have stopped speaking
15
+ // https://github.com/discordjs/discord.js/issues/3524#issuecomment-540373200
16
+ const DISCORD_SPEAKING_DELAY = 250;
17
+
18
+ // Unused: const HEADER_EXTENSION_BYTE = Buffer.from([0xbe, 0xde]);
19
+ const UNPADDED_NONCE_LENGTH = 4;
20
+ const AUTH_TAG_LENGTH = 16;
21
+
22
+ class Readable extends require('stream').Readable {
23
+ _read() {} // eslint-disable-line no-empty-function
24
+ }
25
+
26
+ class PacketHandler extends EventEmitter {
27
+ constructor(receiver) {
28
+ super();
29
+ this.receiver = receiver;
30
+ this.streams = new Map();
31
+ this.videoStreams = new Map();
32
+ this.speakingTimeouts = new Map();
33
+ }
34
+
35
+ getNonceBuffer() {
36
+ return this.receiver.connection.authentication.mode === 'aead_aes256_gcm_rtpsize'
37
+ ? Buffer.alloc(12)
38
+ : Buffer.alloc(24);
39
+ }
40
+
41
+ get connection() {
42
+ return this.receiver.connection;
43
+ }
44
+
45
+ _stoppedSpeaking(userId) {
46
+ const streamInfo = this.streams.get(userId);
47
+ if (streamInfo && streamInfo.end === 'silence') {
48
+ this.streams.delete(userId);
49
+ streamInfo.stream.push(null);
50
+ }
51
+ }
52
+
53
+ makeStream(user, end) {
54
+ if (this.streams.has(user)) return this.streams.get(user).stream;
55
+ const stream = new Readable();
56
+ stream.on('end', () => this.streams.delete(user));
57
+ this.streams.set(user, { stream, end });
58
+ return stream;
59
+ }
60
+
61
+ makeVideoStream(user, output) {
62
+ if (this.videoStreams.has(user)) return this.videoStreams.get(user);
63
+ const stream = new Recorder(this, {
64
+ userId: user,
65
+ output,
66
+ portUdpH264: 65506,
67
+ portUdpOpus: 65510,
68
+ });
69
+ stream.on('ready', () => {
70
+ this.videoStreams.set(user, stream);
71
+ });
72
+ return stream;
73
+ }
74
+
75
+ parseBuffer(buffer) {
76
+ const { secret_key, mode } = this.receiver.connection.authentication;
77
+ // Open packet
78
+ if (!secret_key) return new Error('secret_key cannot be null or undefined');
79
+ const nonce = this.getNonceBuffer();
80
+ // Copy the last 4 bytes of unpadded nonce to the padding of (12 - 4) or (24 - 4) bytes
81
+ buffer.copy(nonce, 0, buffer.length - UNPADDED_NONCE_LENGTH);
82
+
83
+ let headerSize = 12;
84
+ const first = buffer.readUint8();
85
+ if ((first >> 4) & 0x01) headerSize += 4;
86
+
87
+ // The unencrypted RTP header contains 12 bytes, HEADER_EXTENSION and the extension size
88
+ const header = buffer.slice(0, headerSize);
89
+
90
+ // Encrypted contains the extension, if any, the opus packet, and the auth tag
91
+ const encrypted = buffer.slice(headerSize, buffer.length - AUTH_TAG_LENGTH - UNPADDED_NONCE_LENGTH);
92
+ const authTag = buffer.slice(
93
+ buffer.length - AUTH_TAG_LENGTH - UNPADDED_NONCE_LENGTH,
94
+ buffer.length - UNPADDED_NONCE_LENGTH,
95
+ );
96
+
97
+ let packet;
98
+ switch (mode) {
99
+ case 'aead_aes256_gcm_rtpsize': {
100
+ const decipheriv = crypto.createDecipheriv('aes-256-gcm', secret_key, nonce);
101
+ decipheriv.setAAD(header);
102
+ decipheriv.setAuthTag(authTag);
103
+
104
+ packet = Buffer.concat([decipheriv.update(encrypted), decipheriv.final()]);
105
+ break;
106
+ }
107
+ case 'aead_xchacha20_poly1305_rtpsize': {
108
+ // Combined mode expects authtag in the encrypted message
109
+ packet = secretbox.methods.crypto_aead_xchacha20poly1305_ietf_decrypt(
110
+ Buffer.concat([encrypted, authTag]),
111
+ header,
112
+ nonce,
113
+ secret_key,
114
+ );
115
+
116
+ packet = Buffer.from(packet);
117
+ break;
118
+ }
119
+ default: {
120
+ return new RangeError(`Unsupported decryption method: ${mode}`);
121
+ }
122
+ }
123
+
124
+ /*
125
+ // Strip decrypted RTP Header Extension if present
126
+ if (buffer.slice(12, 14).compare(HEADER_EXTENSION_BYTE) === 0) {
127
+ const headerExtensionLength = buffer.slice(14).readUInt16BE();
128
+ packet = packet.subarray(4 * headerExtensionLength);
129
+ }
130
+ */
131
+
132
+ return RtpPacket.deSerialize(Buffer.concat([header, packet]));
133
+ }
134
+
135
+ audioReceiver(ssrc, userStat, opusPacket) {
136
+ const streamInfo = this.streams.get(userStat.userId);
137
+ // If the user is in video, we need to check if the packet is just silence
138
+ if (userStat.hasVideo) {
139
+ if (opusPacket instanceof Error) {
140
+ // Only emit an error if we were actively receiving packets from this user
141
+ if (streamInfo) {
142
+ this.emit('error', opusPacket);
143
+ }
144
+ return;
145
+ }
146
+ // Check payload type
147
+ if (opusPacket.header.payloadType !== Util.getPayloadType('opus')) {
148
+ return;
149
+ }
150
+ if (!opusPacket.payload) {
151
+ return;
152
+ }
153
+ if (SILENCE_FRAME.equals(opusPacket.payload)) {
154
+ // If this is a silence frame, pretend we never received it
155
+ return;
156
+ }
157
+ }
158
+
159
+ let speakingTimeout = this.speakingTimeouts.get(ssrc);
160
+ if (typeof speakingTimeout === 'undefined') {
161
+ // Ensure at least the speaking bit is set.
162
+ // As the object is by reference, it's only needed once per client re-connect.
163
+ if (userStat.speaking === 0) {
164
+ userStat.speaking = Speaking.FLAGS.SPEAKING;
165
+ }
166
+ this.connection.onSpeaking({ user_id: userStat.userId, ssrc: ssrc, speaking: userStat.speaking });
167
+ speakingTimeout = setTimeout(() => {
168
+ try {
169
+ this.connection.onSpeaking({ user_id: userStat.userId, ssrc: ssrc, speaking: 0 });
170
+ clearTimeout(speakingTimeout);
171
+ this.speakingTimeouts.delete(ssrc);
172
+ } catch {
173
+ // Connection already closed, ignore
174
+ }
175
+ }, DISCORD_SPEAKING_DELAY).unref();
176
+ this.speakingTimeouts.set(ssrc, speakingTimeout);
177
+ } else {
178
+ speakingTimeout.refresh();
179
+ }
180
+
181
+ if (streamInfo) {
182
+ const { stream } = streamInfo;
183
+ if (opusPacket instanceof Error) {
184
+ this.emit('error', opusPacket);
185
+ return;
186
+ }
187
+ if (opusPacket.header.payloadType !== Util.getPayloadType('opus')) {
188
+ return;
189
+ }
190
+ stream.push(opusPacket.payload);
191
+ }
192
+ }
193
+
194
+ audioReceiverForStream(ssrc, userStat, packet) {
195
+ const streamInfo = this.videoStreams.get(userStat.userId);
196
+ if (!streamInfo) return;
197
+ if (packet instanceof Error) {
198
+ return;
199
+ }
200
+ if (packet.header.payloadType !== Util.getPayloadType('opus')) {
201
+ return;
202
+ }
203
+ streamInfo.feed(packet);
204
+ }
205
+
206
+ /**
207
+ * Test
208
+ * @param {number} ssrc ssrc
209
+ * @param {Object} userStat { userId, hasVideo }
210
+ * @param {RtpPacket} packet RtpPacket
211
+ * @returns {void}
212
+ */
213
+ videoReceiver(ssrc, userStat, packet) {
214
+ const streamInfo = this.videoStreams.get(userStat.userId);
215
+ // If the user is in video, we need to check if the packet is just silence
216
+ if (userStat.hasVideo) {
217
+ if (packet instanceof Error) {
218
+ return;
219
+ }
220
+
221
+ if (packet.header.payloadType === Util.getPayloadType('opus')) {
222
+ return;
223
+ }
224
+
225
+ if (streamInfo) {
226
+ streamInfo.feed(packet);
227
+ }
228
+ }
229
+ }
230
+
231
+ push(buffer) {
232
+ const ssrc = buffer.readUInt32BE(8);
233
+ let userStat, packet;
234
+ if (this.connection.ssrcMap.has(ssrc)) {
235
+ userStat = this.connection.ssrcMap.get(ssrc); // Audio_ssrc
236
+ packet = this.parseBuffer(buffer);
237
+ this.audioReceiver(ssrc, userStat, packet);
238
+ this.audioReceiverForStream(ssrc, userStat, packet);
239
+ } else if (this.connection.ssrcMap.has(ssrc - 1)) {
240
+ userStat = this.connection.ssrcMap.get(ssrc - 1); // Video_ssrc
241
+ packet = this.parseBuffer(buffer);
242
+ this.videoReceiver(ssrc, userStat, packet);
243
+ }
244
+ if (userStat && !(packet instanceof Error)) this.receiver.emit('receiverData', userStat, packet);
245
+ }
246
+
247
+ // When udp connection is closed (STREAM_DELETE), destroy all streams (Memory leak)
248
+ destroyAllStream() {
249
+ for (const stream of this.streams.values()) {
250
+ stream.stream.destroy();
251
+ }
252
+ this.streams.clear();
253
+ for (const stream of this.videoStreams.values()) {
254
+ stream.destroy();
255
+ }
256
+ this.videoStreams.clear();
257
+ }
258
+ }
259
+
260
+ module.exports = PacketHandler;
@@ -0,0 +1,96 @@
1
+ 'use strict';
2
+
3
+ const EventEmitter = require('events');
4
+ const prism = require('prism-media');
5
+ const PacketHandler = require('./PacketHandler');
6
+ const { Error } = require('../../../errors');
7
+ const { PCMInsertSilence } = require('../player/processing/PCMInsertSilence');
8
+
9
+ /**
10
+ * Receives audio packets from a voice connection.
11
+ * @example
12
+ * const receiver = connection.createReceiver();
13
+ * // opusStream is a ReadableStream - that means you could play it back to a voice channel if you wanted to!
14
+ * const opusStream = receiver.createStream(user);
15
+ */
16
+ class VoiceReceiver extends EventEmitter {
17
+ constructor(connection) {
18
+ super();
19
+ this.connection = connection;
20
+ this.packets = new PacketHandler(this);
21
+ /**
22
+ * Emitted whenever there is a warning
23
+ * @event VoiceReceiver#debug
24
+ * @param {Error|string} error The error or message to debug
25
+ */
26
+ this.packets.on('error', err => this.emit('debug', err));
27
+ }
28
+
29
+ /**
30
+ * Options passed to `VoiceReceiver#createStream`.
31
+ * @typedef {Object} ReceiveStreamOptions
32
+ * @property {string} [mode='opus'] The mode for audio output. This defaults to opus, meaning discord.js won't decode
33
+ * the packets for you. You can set this to 'pcm' so that the stream's output will be 16-bit little-endian stereo
34
+ * audio
35
+ * @property {string} [end='silence'] When the stream should be destroyed. If `silence`, this will be when the user
36
+ * stops talking. Otherwise, if `manual`, this should be handled by you.
37
+ * @property {boolean} [paddingSilence=false] Whether to add silence padding
38
+ * If 'end' is set to 'silence', this property automatically defaults to `false`
39
+ */
40
+
41
+ /**
42
+ * Creates a new audio receiving stream. If a stream already exists for a user, then that stream will be returned
43
+ * rather than generating a new one.
44
+ * @param {UserResolvable} user The user to start listening to.
45
+ * @param {ReceiveStreamOptions} options Options.
46
+ * @returns {ReadableStream}
47
+ */
48
+ createStream(user, { mode = 'opus', end = 'silence', paddingSilence = false } = {}) {
49
+ user = this.connection.client.users.resolve(user);
50
+ if (end === 'silence') paddingSilence = false;
51
+ if (!user) throw new Error('VOICE_USER_MISSING');
52
+ const stream = this.packets.makeStream(user.id, end); // Opus stream
53
+ if (paddingSilence) {
54
+ const decoder = new prism.opus.Decoder({ channels: 2, rate: 48000, frameSize: 960 });
55
+ const pcmTransformer = new PCMInsertSilence();
56
+ stream.pipe(decoder).pipe(pcmTransformer);
57
+ if (mode === 'opus') {
58
+ const encoder = new prism.opus.Encoder({ channels: 2, rate: 48000, frameSize: 960 });
59
+ pcmTransformer.pipe(encoder);
60
+ return encoder;
61
+ }
62
+ return pcmTransformer;
63
+ } else {
64
+ if (mode === 'pcm') {
65
+ const decoder = new prism.opus.Decoder({ channels: 2, rate: 48000, frameSize: 960 });
66
+ stream.pipe(decoder);
67
+ return decoder;
68
+ }
69
+ return stream;
70
+ }
71
+ }
72
+
73
+ /**
74
+ * Creates a new video receiving stream. If a stream already exists for a user, then that stream will be returned
75
+ * rather than generating a new one.
76
+ * <info>Proof of concept - Requires a very good internet connection</info>
77
+ * @param {UserResolvable} user The user to start listening to.
78
+ * @param {WritableStream|string} output Output stream or file path to write the video stream to.
79
+ * @returns {Recorder} The video stream for the specified user.
80
+ */
81
+ createVideoStream(user, output) {
82
+ user = this.connection.client.users.resolve(user);
83
+ if (!user) throw new Error('VOICE_USER_MISSING');
84
+ const stream = this.packets.makeVideoStream(user.id, output);
85
+ return stream;
86
+ }
87
+
88
+ /**
89
+ * Emitted whenever there is a data packet received.
90
+ * @event VoiceReceiver#receiverData
91
+ * @param {{ userId: Snowflake, hasVideo: boolean }} ssrcData SSRC Data
92
+ * @param {RtpPacket} header RTP Packet
93
+ */
94
+ }
95
+
96
+ module.exports = VoiceReceiver;
@@ -0,0 +1,173 @@
1
+ 'use strict';
2
+
3
+ const { spawn } = require('child_process');
4
+ const { createSocket } = require('dgram');
5
+ const { EventEmitter } = require('events');
6
+ const { Buffer } = require('node:buffer');
7
+ const { Writable } = require('stream');
8
+ const find = require('find-process');
9
+ const kill = require('tree-kill');
10
+ const { RtpPacket } = require('werift-rtp');
11
+ const Util = require('../../../util/Util');
12
+ const { randomPorts } = require('../util/Function');
13
+ const { StreamOutput } = require('../util/Socket');
14
+
15
+ /**
16
+ * Represents a FFmpeg handler
17
+ * @extends {EventEmitter}
18
+ */
19
+ class Recorder extends EventEmitter {
20
+ constructor(receiver, { userId, portUdpH264, portUdpOpus, output } = {}) {
21
+ super();
22
+
23
+ Object.defineProperty(this, 'receiver', { value: receiver });
24
+
25
+ /**
26
+ * The user ID
27
+ * @type {Snowflake}
28
+ */
29
+ this.userId = userId;
30
+
31
+ this.portUdpH264 = portUdpH264;
32
+ this.portUdpH265 = null;
33
+ this.portUdpOpus = portUdpOpus;
34
+
35
+ this.promise = null;
36
+
37
+ if (!portUdpH264 || !portUdpOpus) {
38
+ this.promise = randomPorts(6, 'udp4').then(ports => {
39
+ ports = ports.filter(port => port % 2 === 0);
40
+ this.portUdpH264 ??= ports[0];
41
+ this.portUdpOpus ??= ports[1];
42
+ });
43
+ }
44
+
45
+ /**
46
+ * The output of the stream
47
+ * @type {string|Readable}
48
+ */
49
+ this.output = output;
50
+
51
+ /**
52
+ * The FFmpeg process is ready or not
53
+ * @type {boolean}
54
+ */
55
+ this.ready = false;
56
+
57
+ this.socket = createSocket('udp4');
58
+
59
+ this.init(output);
60
+ }
61
+ async init(output) {
62
+ await this.promise;
63
+ const sdpData = Util.getSDPCodecName(this.portUdpH264, this.portUdpH265, this.portUdpOpus);
64
+ const isStream = output instanceof Writable;
65
+ if (isStream) {
66
+ this.outputStream = StreamOutput(output);
67
+ }
68
+ const stream = spawn('ffmpeg', [
69
+ '-reorder_queue_size',
70
+ '500',
71
+ '-thread_queue_size',
72
+ '500',
73
+ '-err_detect',
74
+ 'ignore_err',
75
+ '-flags2',
76
+ '+export_mvs',
77
+ '-fflags',
78
+ '+genpts+discardcorrupt',
79
+ '-use_wallclock_as_timestamps',
80
+ '1',
81
+ '-f',
82
+ 'sdp',
83
+ '-analyzeduration',
84
+ '1M',
85
+ '-probesize',
86
+ '1M',
87
+ '-protocol_whitelist',
88
+ 'file,udp,rtp,pipe,fd',
89
+ '-i',
90
+ '-', // Read from stdin
91
+ '-buffer_size',
92
+ '4M',
93
+ '-max_delay',
94
+ '500000', // 500ms
95
+ '-rtbufsize',
96
+ '4M',
97
+ '-c',
98
+ 'copy',
99
+ '-y',
100
+ '-f',
101
+ 'matroska',
102
+ isStream ? this.outputStream.url : output,
103
+ ]);
104
+
105
+ /**
106
+ * The FFmpeg process
107
+ * @type {ChildProcessWithoutNullStreams}
108
+ */
109
+ this.stream = stream;
110
+ this.stream.stdin.write(sdpData);
111
+ this.stream.stdin.end();
112
+ this.stream.stderr.once('data', data => {
113
+ this.emit('debug', `stderr: ${data}`);
114
+ this.ready = true;
115
+ this.emit('ready');
116
+ });
117
+ }
118
+ /**
119
+ * Send a payload to FFmpeg via UDP
120
+ * @param {RtpPacket|string|Buffer} payload The payload
121
+ * @param {*} callback Callback
122
+ */
123
+ feed(
124
+ payload,
125
+ callback = e => {
126
+ if (e) {
127
+ console.error('Error sending packet:', e);
128
+ }
129
+ },
130
+ ) {
131
+ if (!(payload instanceof RtpPacket)) {
132
+ payload = RtpPacket.deSerialize(Buffer.isBuffer(payload) ? payload : Buffer.from(payload));
133
+ }
134
+ const message = payload.serialize();
135
+ // Get port from payloadType
136
+ let port;
137
+ if (payload.header.payloadType === Util.getPayloadType('opus')) {
138
+ port = this.portUdpOpus;
139
+ } else if (payload.header.payloadType === Util.getPayloadType('H264')) {
140
+ port = this.portUdpH264;
141
+ } else if (payload.header.payloadType === Util.getPayloadType('H265')) {
142
+ port = this.portUdpH265;
143
+ } else {
144
+ return;
145
+ }
146
+ this.socket.send(message, 0, message.length, port, '127.0.0.1', callback);
147
+ }
148
+
149
+ destroy() {
150
+ const ffmpegPid = this.stream.pid; // But it is ppid ;-;
151
+ const args = this.stream.spawnargs.slice(1).join(' '); // Skip ffmpeg
152
+ find('name', 'ffmpeg', true).then(list => {
153
+ let process = list.find(o => o.pid === ffmpegPid || o.ppid === ffmpegPid || o.cmd.includes(args));
154
+ if (process) {
155
+ kill(process.pid);
156
+ this.receiver?.videoStreams?.delete(this.userId);
157
+ this.emit('closed');
158
+ }
159
+ });
160
+ }
161
+
162
+ /**
163
+ * Emitted when the Recorder becomes ready to start working.
164
+ * @event Recorder#ready
165
+ */
166
+
167
+ /**
168
+ * Emitted when the Recorder is closed.
169
+ * @event Recorder#closed
170
+ */
171
+ }
172
+
173
+ module.exports = Recorder;
@@ -0,0 +1,116 @@
1
+ 'use strict';
2
+
3
+ const dgram = require('dgram');
4
+ const { setImmediate } = require('node:timers');
5
+
6
+ /**
7
+ * @typedef {Object} InterfaceAddresses
8
+ * @property {string} [udp4] - IPv4 address
9
+ * @property {string} [udp6] - IPv6 address
10
+ */
11
+
12
+ /**
13
+ * Get the interface address for a given socket type.
14
+ * @param {"udp4"|"udp6"} type - The socket type.
15
+ * @param {InterfaceAddresses} [interfaceAddresses] - The interface addresses mapping.
16
+ * @returns {string|undefined} The interface address if available.
17
+ */
18
+ function interfaceAddress(type, interfaceAddresses) {
19
+ return interfaceAddresses ? interfaceAddresses[type] : undefined;
20
+ }
21
+
22
+ /**
23
+ * Get a random available port.
24
+ * @param {"udp4"|"udp6"} [protocol="udp4"] - The socket type.
25
+ * @param {InterfaceAddresses} [interfaceAddresses] - The interface addresses mapping.
26
+ * @returns {Promise<number>} The assigned random port.
27
+ */
28
+ async function randomPort(protocol = 'udp4', interfaceAddresses) {
29
+ const socket = dgram.createSocket(protocol);
30
+
31
+ setImmediate(() =>
32
+ socket.bind({
33
+ port: 0,
34
+ address: interfaceAddress(protocol, interfaceAddresses),
35
+ }),
36
+ );
37
+
38
+ await new Promise((resolve, reject) => {
39
+ socket.once('error', reject);
40
+ socket.once('listening', resolve);
41
+ });
42
+
43
+ const port = socket.address()?.port;
44
+ await new Promise(resolve => socket.close(resolve));
45
+ return port;
46
+ }
47
+
48
+ /**
49
+ * Get multiple random available ports.
50
+ * @param {number} num - Number of ports to find.
51
+ * @param {"udp4"|"udp6"} [protocol="udp4"] - The socket type.
52
+ * @param {InterfaceAddresses} [interfaceAddresses] - The interface addresses mapping.
53
+ * @returns {Promise<number[]>} An array of assigned random ports.
54
+ */
55
+ async function randomPorts(num, protocol = 'udp4', interfaceAddresses) {
56
+ return Promise.all(Array.from({ length: num }).map(() => randomPort(protocol, interfaceAddresses)));
57
+ }
58
+
59
+ /**
60
+ * Find an available port within a given range.
61
+ * @param {number} min - The minimum port number.
62
+ * @param {number} max - The maximum port number.
63
+ * @param {"udp4"|"udp6"} [protocol="udp4"] - The socket type.
64
+ * @param {InterfaceAddresses} [interfaceAddresses] - The interface addresses mapping.
65
+ * @returns {Promise<number>} The available port within range.
66
+ * @throws {Error} If no port is found within the range.
67
+ */
68
+ async function findPort(min, max, protocol = 'udp4', interfaceAddresses) {
69
+ let port;
70
+
71
+ for (let i = min; i <= max; i++) {
72
+ const socket = dgram.createSocket(protocol);
73
+
74
+ setImmediate(() =>
75
+ socket.bind({
76
+ port: i,
77
+ address: interfaceAddress(protocol, interfaceAddresses),
78
+ }),
79
+ );
80
+
81
+ const error = await new Promise(resolve => {
82
+ socket.once('error', resolve);
83
+ socket.once('listening', () => resolve(null));
84
+ });
85
+
86
+ await new Promise(resolve => socket.close(resolve));
87
+
88
+ if (error) continue;
89
+
90
+ const addressInfo = socket.address();
91
+ if (addressInfo && addressInfo.port >= min && addressInfo.port <= max) {
92
+ port = addressInfo.port;
93
+ break;
94
+ }
95
+ }
96
+
97
+ if (!port) throw new Error('port not found');
98
+ return port;
99
+ }
100
+
101
+ function parseStreamKey(key) {
102
+ const Arr = key.split(':');
103
+ const type = Arr[0];
104
+ const guildId = type == 'guild' ? Arr[1] : null;
105
+ const channelId = type == 'guild' ? Arr[2] : Arr[1];
106
+ const userId = type == 'guild' ? Arr[3] : Arr[2];
107
+ return { type, guildId, channelId, userId };
108
+ }
109
+
110
+ module.exports = {
111
+ randomPort,
112
+ randomPorts,
113
+ findPort,
114
+ interfaceAddress,
115
+ parseStreamKey,
116
+ };