djs-selfbot-v13 3.1.8 → 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 (364) hide show
  1. package/LICENSE +1 -1
  2. package/README.md +48 -37
  3. package/package.json +44 -26
  4. package/src/WebSocket.js +39 -39
  5. package/src/client/BaseClient.js +86 -86
  6. package/src/client/Client.js +934 -765
  7. package/src/client/WebhookClient.js +61 -61
  8. package/src/client/actions/Action.js +116 -120
  9. package/src/client/actions/ActionsManager.js +80 -78
  10. package/src/client/actions/ApplicationCommandPermissionsUpdate.js +34 -34
  11. package/src/client/actions/AutoModerationActionExecution.js +27 -27
  12. package/src/client/actions/AutoModerationRuleCreate.js +28 -28
  13. package/src/client/actions/AutoModerationRuleDelete.js +32 -32
  14. package/src/client/actions/AutoModerationRuleUpdate.js +30 -30
  15. package/src/client/actions/ChannelCreate.js +23 -23
  16. package/src/client/actions/ChannelDelete.js +39 -39
  17. package/src/client/actions/ChannelUpdate.js +43 -43
  18. package/src/client/actions/GuildAuditLogEntryCreate.js +29 -29
  19. package/src/client/actions/GuildBanAdd.js +20 -20
  20. package/src/client/actions/GuildBanRemove.js +25 -25
  21. package/src/client/actions/GuildChannelsPositionUpdate.js +21 -21
  22. package/src/client/actions/GuildDelete.js +65 -65
  23. package/src/client/actions/GuildEmojiCreate.js +20 -20
  24. package/src/client/actions/GuildEmojiDelete.js +21 -21
  25. package/src/client/actions/GuildEmojiUpdate.js +20 -20
  26. package/src/client/actions/GuildEmojisUpdate.js +34 -34
  27. package/src/client/actions/GuildIntegrationsUpdate.js +19 -19
  28. package/src/client/actions/GuildMemberRemove.js +33 -33
  29. package/src/client/actions/GuildMemberUpdate.js +44 -44
  30. package/src/client/actions/GuildRoleCreate.js +25 -25
  31. package/src/client/actions/GuildRoleDelete.js +31 -31
  32. package/src/client/actions/GuildRoleUpdate.js +39 -39
  33. package/src/client/actions/GuildRolesPositionUpdate.js +21 -21
  34. package/src/client/actions/GuildScheduledEventCreate.js +27 -27
  35. package/src/client/actions/GuildScheduledEventDelete.js +31 -31
  36. package/src/client/actions/GuildScheduledEventUpdate.js +30 -30
  37. package/src/client/actions/GuildScheduledEventUserAdd.js +32 -32
  38. package/src/client/actions/GuildScheduledEventUserRemove.js +32 -32
  39. package/src/client/actions/GuildStickerCreate.js +20 -20
  40. package/src/client/actions/GuildStickerDelete.js +21 -21
  41. package/src/client/actions/GuildStickerUpdate.js +20 -20
  42. package/src/client/actions/GuildStickersUpdate.js +34 -34
  43. package/src/client/actions/GuildUpdate.js +33 -33
  44. package/src/client/actions/InviteCreate.js +28 -28
  45. package/src/client/actions/InviteDelete.js +30 -30
  46. package/src/client/actions/MessageCreate.js +50 -46
  47. package/src/client/actions/MessageDelete.js +32 -32
  48. package/src/client/actions/MessageDeleteBulk.js +46 -46
  49. package/src/client/actions/MessagePollVoteAdd.js +33 -0
  50. package/src/client/actions/MessagePollVoteRemove.js +33 -0
  51. package/src/client/actions/MessageReactionAdd.js +68 -56
  52. package/src/client/actions/MessageReactionRemove.js +50 -45
  53. package/src/client/actions/MessageReactionRemoveAll.js +33 -33
  54. package/src/client/actions/MessageReactionRemoveEmoji.js +28 -28
  55. package/src/client/actions/MessageUpdate.js +26 -26
  56. package/src/client/actions/PresenceUpdate.js +50 -46
  57. package/src/client/actions/StageInstanceCreate.js +28 -28
  58. package/src/client/actions/StageInstanceDelete.js +33 -33
  59. package/src/client/actions/StageInstanceUpdate.js +30 -30
  60. package/src/client/actions/ThreadCreate.js +24 -24
  61. package/src/client/actions/ThreadDelete.js +32 -32
  62. package/src/client/actions/ThreadListSync.js +59 -59
  63. package/src/client/actions/ThreadMemberUpdate.js +30 -30
  64. package/src/client/actions/ThreadMembersUpdate.js +34 -34
  65. package/src/client/actions/TypingStart.js +29 -29
  66. package/src/client/actions/UserUpdate.js +35 -35
  67. package/src/client/actions/VoiceStateUpdate.js +50 -57
  68. package/src/client/actions/WebhooksUpdate.js +20 -20
  69. package/src/client/voice/ClientVoiceManager.js +151 -51
  70. package/src/client/voice/VoiceConnection.js +1249 -0
  71. package/src/client/voice/dispatcher/AnnexBDispatcher.js +120 -0
  72. package/src/client/voice/dispatcher/AudioDispatcher.js +145 -0
  73. package/src/client/voice/dispatcher/BaseDispatcher.js +459 -0
  74. package/src/client/voice/dispatcher/VPxDispatcher.js +54 -0
  75. package/src/client/voice/dispatcher/VideoDispatcher.js +68 -0
  76. package/src/client/voice/networking/VoiceUDPClient.js +173 -0
  77. package/src/client/voice/networking/VoiceWebSocket.js +286 -0
  78. package/src/client/voice/player/MediaPlayer.js +321 -0
  79. package/src/client/voice/player/processing/AnnexBNalSplitter.js +244 -0
  80. package/src/client/voice/player/processing/IvfSplitter.js +106 -0
  81. package/src/client/voice/player/processing/PCMInsertSilence.js +37 -0
  82. package/src/client/voice/receiver/PacketHandler.js +260 -0
  83. package/src/client/voice/receiver/Receiver.js +96 -0
  84. package/src/client/voice/receiver/Recorder.js +173 -0
  85. package/src/client/voice/util/Function.js +116 -0
  86. package/src/client/voice/util/PlayInterface.js +122 -0
  87. package/src/client/voice/util/Secretbox.js +64 -0
  88. package/src/client/voice/util/Silence.js +16 -0
  89. package/src/client/voice/util/Socket.js +62 -0
  90. package/src/client/voice/util/VolumeInterface.js +104 -0
  91. package/src/client/websocket/WebSocketManager.js +392 -392
  92. package/src/client/websocket/WebSocketShard.js +907 -906
  93. package/src/client/websocket/handlers/APPLICATION_COMMAND_CREATE.js +18 -18
  94. package/src/client/websocket/handlers/APPLICATION_COMMAND_DELETE.js +20 -20
  95. package/src/client/websocket/handlers/APPLICATION_COMMAND_PERMISSIONS_UPDATE.js +5 -5
  96. package/src/client/websocket/handlers/APPLICATION_COMMAND_UPDATE.js +20 -20
  97. package/src/client/websocket/handlers/AUTO_MODERATION_ACTION_EXECUTION.js +5 -5
  98. package/src/client/websocket/handlers/AUTO_MODERATION_RULE_CREATE.js +5 -5
  99. package/src/client/websocket/handlers/AUTO_MODERATION_RULE_DELETE.js +5 -5
  100. package/src/client/websocket/handlers/AUTO_MODERATION_RULE_UPDATE.js +5 -5
  101. package/src/client/websocket/handlers/CALL_CREATE.js +14 -14
  102. package/src/client/websocket/handlers/CALL_DELETE.js +11 -11
  103. package/src/client/websocket/handlers/CALL_UPDATE.js +11 -11
  104. package/src/client/websocket/handlers/CHANNEL_CREATE.js +5 -5
  105. package/src/client/websocket/handlers/CHANNEL_DELETE.js +5 -5
  106. package/src/client/websocket/handlers/CHANNEL_PINS_UPDATE.js +22 -22
  107. package/src/client/websocket/handlers/CHANNEL_RECIPIENT_ADD.js +19 -19
  108. package/src/client/websocket/handlers/CHANNEL_RECIPIENT_REMOVE.js +16 -16
  109. package/src/client/websocket/handlers/CHANNEL_UPDATE.js +16 -16
  110. package/src/client/websocket/handlers/GUILD_AUDIT_LOG_ENTRY_CREATE.js +5 -5
  111. package/src/client/websocket/handlers/GUILD_BAN_ADD.js +5 -5
  112. package/src/client/websocket/handlers/GUILD_BAN_REMOVE.js +5 -5
  113. package/src/client/websocket/handlers/GUILD_CREATE.js +52 -53
  114. package/src/client/websocket/handlers/GUILD_DELETE.js +5 -5
  115. package/src/client/websocket/handlers/GUILD_EMOJIS_UPDATE.js +5 -5
  116. package/src/client/websocket/handlers/GUILD_INTEGRATIONS_UPDATE.js +5 -5
  117. package/src/client/websocket/handlers/GUILD_MEMBERS_CHUNK.js +39 -39
  118. package/src/client/websocket/handlers/GUILD_MEMBER_ADD.js +20 -20
  119. package/src/client/websocket/handlers/GUILD_MEMBER_REMOVE.js +5 -5
  120. package/src/client/websocket/handlers/GUILD_MEMBER_UPDATE.js +5 -5
  121. package/src/client/websocket/handlers/GUILD_ROLE_CREATE.js +5 -5
  122. package/src/client/websocket/handlers/GUILD_ROLE_DELETE.js +5 -5
  123. package/src/client/websocket/handlers/GUILD_ROLE_UPDATE.js +5 -5
  124. package/src/client/websocket/handlers/GUILD_SCHEDULED_EVENT_CREATE.js +5 -5
  125. package/src/client/websocket/handlers/GUILD_SCHEDULED_EVENT_DELETE.js +5 -5
  126. package/src/client/websocket/handlers/GUILD_SCHEDULED_EVENT_UPDATE.js +5 -5
  127. package/src/client/websocket/handlers/GUILD_SCHEDULED_EVENT_USER_ADD.js +5 -5
  128. package/src/client/websocket/handlers/GUILD_SCHEDULED_EVENT_USER_REMOVE.js +5 -5
  129. package/src/client/websocket/handlers/GUILD_STICKERS_UPDATE.js +5 -5
  130. package/src/client/websocket/handlers/GUILD_UPDATE.js +5 -5
  131. package/src/client/websocket/handlers/INTERACTION_MODAL_CREATE.js +12 -12
  132. package/src/client/websocket/handlers/INVITE_CREATE.js +5 -5
  133. package/src/client/websocket/handlers/INVITE_DELETE.js +5 -5
  134. package/src/client/websocket/handlers/MESSAGE_CREATE.js +5 -5
  135. package/src/client/websocket/handlers/MESSAGE_DELETE.js +5 -5
  136. package/src/client/websocket/handlers/MESSAGE_DELETE_BULK.js +5 -5
  137. package/src/client/websocket/handlers/MESSAGE_POLL_VOTE_ADD.js +5 -0
  138. package/src/client/websocket/handlers/MESSAGE_POLL_VOTE_REMOVE.js +5 -0
  139. package/src/client/websocket/handlers/MESSAGE_REACTION_ADD.js +5 -5
  140. package/src/client/websocket/handlers/MESSAGE_REACTION_REMOVE.js +5 -5
  141. package/src/client/websocket/handlers/MESSAGE_REACTION_REMOVE_ALL.js +5 -5
  142. package/src/client/websocket/handlers/MESSAGE_REACTION_REMOVE_EMOJI.js +5 -5
  143. package/src/client/websocket/handlers/MESSAGE_UPDATE.js +16 -16
  144. package/src/client/websocket/handlers/PRESENCE_UPDATE.js +5 -5
  145. package/src/client/websocket/handlers/READY.js +121 -80
  146. package/src/client/websocket/handlers/RELATIONSHIP_ADD.js +19 -19
  147. package/src/client/websocket/handlers/RELATIONSHIP_REMOVE.js +17 -17
  148. package/src/client/websocket/handlers/RELATIONSHIP_UPDATE.js +41 -41
  149. package/src/client/websocket/handlers/RESUMED.js +14 -14
  150. package/src/client/websocket/handlers/STAGE_INSTANCE_CREATE.js +5 -5
  151. package/src/client/websocket/handlers/STAGE_INSTANCE_DELETE.js +5 -5
  152. package/src/client/websocket/handlers/STAGE_INSTANCE_UPDATE.js +5 -5
  153. package/src/client/websocket/handlers/THREAD_CREATE.js +5 -5
  154. package/src/client/websocket/handlers/THREAD_DELETE.js +5 -5
  155. package/src/client/websocket/handlers/THREAD_LIST_SYNC.js +5 -5
  156. package/src/client/websocket/handlers/THREAD_MEMBERS_UPDATE.js +5 -5
  157. package/src/client/websocket/handlers/THREAD_MEMBER_UPDATE.js +5 -5
  158. package/src/client/websocket/handlers/THREAD_UPDATE.js +16 -16
  159. package/src/client/websocket/handlers/TYPING_START.js +5 -5
  160. package/src/client/websocket/handlers/USER_GUILD_SETTINGS_UPDATE.js +6 -6
  161. package/src/client/websocket/handlers/USER_NOTE_UPDATE.js +5 -5
  162. package/src/client/websocket/handlers/USER_REQUIRED_ACTION_UPDATE.js +78 -78
  163. package/src/client/websocket/handlers/USER_SETTINGS_UPDATE.js +5 -5
  164. package/src/client/websocket/handlers/USER_UPDATE.js +5 -5
  165. package/src/client/websocket/handlers/VOICE_CHANNEL_EFFECT_SEND.js +16 -0
  166. package/src/client/websocket/handlers/VOICE_CHANNEL_STATUS_UPDATE.js +12 -12
  167. package/src/client/websocket/handlers/VOICE_SERVER_UPDATE.js +6 -6
  168. package/src/client/websocket/handlers/VOICE_STATE_UPDATE.js +5 -5
  169. package/src/client/websocket/handlers/WEBHOOKS_UPDATE.js +5 -5
  170. package/src/client/websocket/handlers/index.js +84 -81
  171. package/src/errors/DJSError.js +61 -61
  172. package/src/errors/Messages.js +217 -182
  173. package/src/errors/index.js +4 -4
  174. package/src/index.js +172 -158
  175. package/src/managers/ApplicationCommandManager.js +264 -264
  176. package/src/managers/ApplicationCommandPermissionsManager.js +417 -417
  177. package/src/managers/AutoModerationRuleManager.js +296 -296
  178. package/src/managers/BaseGuildEmojiManager.js +80 -80
  179. package/src/managers/BaseManager.js +19 -19
  180. package/src/managers/BillingManager.js +66 -66
  181. package/src/managers/CachedManager.js +71 -71
  182. package/src/managers/ChannelManager.js +148 -138
  183. package/src/managers/ClientUserSettingManager.js +372 -372
  184. package/src/managers/DataManager.js +61 -61
  185. package/src/managers/GuildBanManager.js +250 -204
  186. package/src/managers/GuildChannelManager.js +488 -504
  187. package/src/managers/GuildEmojiManager.js +171 -171
  188. package/src/managers/GuildEmojiRoleManager.js +118 -118
  189. package/src/managers/GuildForumThreadManager.js +108 -108
  190. package/src/managers/GuildInviteManager.js +213 -213
  191. package/src/managers/GuildManager.js +338 -304
  192. package/src/managers/GuildMemberManager.js +599 -593
  193. package/src/managers/GuildMemberRoleManager.js +195 -191
  194. package/src/managers/GuildScheduledEventManager.js +314 -296
  195. package/src/managers/GuildSettingManager.js +155 -155
  196. package/src/managers/GuildStickerManager.js +179 -179
  197. package/src/managers/GuildTextThreadManager.js +98 -98
  198. package/src/managers/InteractionManager.js +39 -39
  199. package/src/managers/MessageManager.js +423 -391
  200. package/src/managers/PermissionOverwriteManager.js +164 -166
  201. package/src/managers/PresenceManager.js +71 -58
  202. package/src/managers/ReactionManager.js +67 -67
  203. package/src/managers/ReactionUserManager.js +73 -71
  204. package/src/managers/RelationshipManager.js +278 -265
  205. package/src/managers/RoleManager.js +448 -352
  206. package/src/managers/SessionManager.js +66 -0
  207. package/src/managers/StageInstanceManager.js +162 -162
  208. package/src/managers/ThreadManager.js +175 -174
  209. package/src/managers/ThreadMemberManager.js +186 -186
  210. package/src/managers/UserManager.js +136 -146
  211. package/src/managers/UserNoteManager.js +53 -53
  212. package/src/managers/VoiceStateManager.js +59 -37
  213. package/src/rest/APIRequest.js +154 -154
  214. package/src/rest/APIRouter.js +53 -53
  215. package/src/rest/DiscordAPIError.js +119 -104
  216. package/src/rest/HTTPError.js +62 -62
  217. package/src/rest/RESTManager.js +67 -62
  218. package/src/rest/RateLimitError.js +55 -55
  219. package/src/rest/RequestHandler.js +466 -444
  220. package/src/sharding/Shard.js +444 -443
  221. package/src/sharding/ShardClientUtil.js +279 -275
  222. package/src/sharding/ShardingManager.js +319 -318
  223. package/src/structures/AnonymousGuild.js +98 -98
  224. package/src/structures/ApplicationCommand.js +593 -593
  225. package/src/structures/ApplicationRoleConnectionMetadata.js +48 -48
  226. package/src/structures/AutoModerationActionExecution.js +89 -89
  227. package/src/structures/AutoModerationRule.js +294 -294
  228. package/src/structures/AutocompleteInteraction.js +107 -107
  229. package/src/structures/Base.js +43 -43
  230. package/src/structures/BaseCommandInteraction.js +211 -211
  231. package/src/structures/BaseGuild.js +116 -116
  232. package/src/structures/BaseGuildEmoji.js +56 -56
  233. package/src/structures/BaseGuildTextChannel.js +191 -191
  234. package/src/structures/BaseGuildVoiceChannel.js +241 -241
  235. package/src/structures/BaseMessageComponent.js +181 -114
  236. package/src/structures/ButtonInteraction.js +11 -11
  237. package/src/structures/CallState.js +63 -63
  238. package/src/structures/CategoryChannel.js +85 -85
  239. package/src/structures/Channel.js +284 -270
  240. package/src/structures/ClientPresence.js +77 -88
  241. package/src/structures/ClientUser.js +479 -450
  242. package/src/structures/CommandInteraction.js +41 -41
  243. package/src/structures/CommandInteractionOptionResolver.js +276 -276
  244. package/src/structures/ContainerComponent.js +68 -0
  245. package/src/structures/ContextMenuInteraction.js +65 -65
  246. package/src/structures/DMChannel.js +219 -217
  247. package/src/structures/DirectoryChannel.js +20 -20
  248. package/src/structures/Emoji.js +148 -148
  249. package/src/structures/FileComponent.js +49 -0
  250. package/src/structures/ForumChannel.js +31 -261
  251. package/src/structures/GroupDMChannel.js +394 -387
  252. package/src/structures/Guild.js +1643 -1608
  253. package/src/structures/GuildAuditLogs.js +746 -729
  254. package/src/structures/GuildBan.js +59 -59
  255. package/src/structures/GuildBoost.js +108 -108
  256. package/src/structures/GuildChannel.js +470 -468
  257. package/src/structures/GuildEmoji.js +161 -161
  258. package/src/structures/GuildMember.js +636 -568
  259. package/src/structures/GuildPreview.js +191 -191
  260. package/src/structures/GuildPreviewEmoji.js +27 -27
  261. package/src/structures/GuildScheduledEvent.js +536 -441
  262. package/src/structures/GuildTemplate.js +236 -236
  263. package/src/structures/Integration.js +188 -188
  264. package/src/structures/IntegrationApplication.js +96 -96
  265. package/src/structures/Interaction.js +290 -290
  266. package/src/structures/InteractionCollector.js +248 -248
  267. package/src/structures/InteractionWebhook.js +43 -43
  268. package/src/structures/Invite.js +358 -358
  269. package/src/structures/InviteGuild.js +23 -23
  270. package/src/structures/InviteStageInstance.js +86 -86
  271. package/src/structures/MediaChannel.js +11 -0
  272. package/src/structures/MediaGalleryComponent.js +41 -0
  273. package/src/structures/MediaGalleryItem.js +47 -0
  274. package/src/structures/Message.js +1252 -1236
  275. package/src/structures/MessageActionRow.js +105 -103
  276. package/src/structures/MessageAttachment.js +216 -204
  277. package/src/structures/MessageButton.js +166 -165
  278. package/src/structures/MessageCollector.js +146 -146
  279. package/src/structures/MessageComponentInteraction.js +120 -120
  280. package/src/structures/MessageContextMenuInteraction.js +20 -20
  281. package/src/structures/MessageEmbed.js +596 -586
  282. package/src/structures/MessageMentions.js +273 -273
  283. package/src/structures/MessagePayload.js +354 -316
  284. package/src/structures/MessageReaction.js +181 -171
  285. package/src/structures/MessageSelectMenu.js +141 -140
  286. package/src/structures/Modal.js +161 -174
  287. package/src/structures/ModalSubmitFieldsResolver.js +53 -53
  288. package/src/structures/ModalSubmitInteraction.js +119 -119
  289. package/src/structures/NewsChannel.js +32 -32
  290. package/src/structures/OAuth2Guild.js +28 -28
  291. package/src/structures/PermissionOverwrites.js +198 -196
  292. package/src/structures/Poll.js +108 -0
  293. package/src/structures/PollAnswer.js +88 -0
  294. package/src/structures/Presence.js +1105 -443
  295. package/src/structures/ReactionCollector.js +229 -229
  296. package/src/structures/ReactionEmoji.js +31 -31
  297. package/src/structures/Role.js +590 -531
  298. package/src/structures/SectionComponent.js +48 -0
  299. package/src/structures/SelectMenuInteraction.js +21 -21
  300. package/src/structures/SeparatorComponent.js +48 -0
  301. package/src/structures/Session.js +81 -0
  302. package/src/structures/StageChannel.js +104 -104
  303. package/src/structures/StageInstance.js +208 -208
  304. package/src/structures/Sticker.js +310 -310
  305. package/src/structures/StickerPack.js +95 -95
  306. package/src/structures/StoreChannel.js +56 -56
  307. package/src/structures/Team.js +118 -118
  308. package/src/structures/TeamMember.js +80 -71
  309. package/src/structures/TextChannel.js +33 -33
  310. package/src/structures/TextDisplayComponent.js +40 -0
  311. package/src/structures/TextInputComponent.js +132 -131
  312. package/src/structures/ThreadChannel.js +605 -607
  313. package/src/structures/ThreadMember.js +105 -105
  314. package/src/structures/ThreadOnlyChannel.js +249 -0
  315. package/src/structures/ThumbnailComponent.js +57 -0
  316. package/src/structures/Typing.js +74 -74
  317. package/src/structures/UnfurledMediaItem.js +29 -0
  318. package/src/structures/User.js +640 -509
  319. package/src/structures/UserContextMenuInteraction.js +29 -29
  320. package/src/structures/VoiceChannel.js +110 -110
  321. package/src/structures/VoiceChannelEffect.js +69 -0
  322. package/src/structures/VoiceRegion.js +53 -53
  323. package/src/structures/VoiceState.js +354 -341
  324. package/src/structures/WebEmbed.js +373 -373
  325. package/src/structures/Webhook.js +478 -467
  326. package/src/structures/WelcomeChannel.js +60 -60
  327. package/src/structures/WelcomeScreen.js +48 -48
  328. package/src/structures/Widget.js +87 -87
  329. package/src/structures/WidgetMember.js +99 -99
  330. package/src/structures/interfaces/Application.js +825 -313
  331. package/src/structures/interfaces/Collector.js +300 -300
  332. package/src/structures/interfaces/InteractionResponses.js +313 -313
  333. package/src/structures/interfaces/TextBasedChannel.js +759 -721
  334. package/src/util/APITypes.js +59 -0
  335. package/src/util/ActivityFlags.js +44 -44
  336. package/src/util/ApplicationFlags.js +76 -76
  337. package/src/util/AttachmentFlags.js +38 -38
  338. package/src/util/BitField.js +170 -170
  339. package/src/util/ChannelFlags.js +45 -45
  340. package/src/util/Constants.js +1914 -1760
  341. package/src/util/DataResolver.js +146 -145
  342. package/src/util/Formatters.js +228 -228
  343. package/src/util/GuildMemberFlags.js +43 -43
  344. package/src/util/Intents.js +74 -74
  345. package/src/util/InviteFlags.js +34 -29
  346. package/src/util/LimitedCollection.js +131 -131
  347. package/src/util/MessageFlags.js +63 -54
  348. package/src/util/Options.js +358 -342
  349. package/src/util/Permissions.js +202 -192
  350. package/src/util/PremiumUsageFlags.js +31 -31
  351. package/src/util/PurchasedFlags.js +33 -33
  352. package/src/util/RemoteAuth.js +382 -379
  353. package/src/util/RoleFlags.js +37 -37
  354. package/src/util/SnowflakeUtil.js +92 -92
  355. package/src/util/Speaking.js +33 -0
  356. package/src/util/Sweepers.js +466 -466
  357. package/src/util/SystemChannelFlags.js +55 -55
  358. package/src/util/ThreadMemberFlags.js +30 -30
  359. package/src/util/UserFlags.js +104 -104
  360. package/src/util/Util.js +1048 -803
  361. package/typings/enums.d.ts +439 -291
  362. package/typings/index.d.ts +8247 -7390
  363. package/typings/rawDataTypes.d.ts +403 -342
  364. package/src/structures/RichPresence.js +0 -702
@@ -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
+ };