djs-selfbot-v13 3.2.2 → 3.7.2

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/README.md +63 -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 +941 -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/QuestManager.js +376 -0
  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 -160
  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 -85
  241. package/src/structures/ClientUser.js +653 -448
  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 +1697 -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 -1227
  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 -318
  284. package/src/structures/MessageReaction.js +181 -171
  285. package/src/structures/MessageSelectMenu.js +141 -140
  286. package/src/structures/Modal.js +161 -161
  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 +1137 -1101
  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 -543
  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 -719
  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 -1773
  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 -336
  349. package/src/util/Permissions.js +202 -202
  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 -889
  361. package/typings/enums.d.ts +439 -297
  362. package/typings/index.d.ts +8392 -7432
  363. package/typings/rawDataTypes.d.ts +403 -342
  364. package/src/structures/MessagePoll.js +0 -238
@@ -1,488 +1,488 @@
1
- 'use strict';
2
-
3
- const process = require('node:process');
4
- const { Collection } = require('@discordjs/collection');
5
- const CachedManager = require('./CachedManager');
6
- const { Error, TypeError } = require('../errors');
7
- const GuildChannel = require('../structures/GuildChannel');
8
- const PermissionOverwrites = require('../structures/PermissionOverwrites');
9
- const ThreadChannel = require('../structures/ThreadChannel');
10
- const Webhook = require('../structures/Webhook');
11
- const ChannelFlags = require('../util/ChannelFlags');
12
- const {
13
- ThreadChannelTypes,
14
- ChannelTypes,
15
- VideoQualityModes,
16
- SortOrderTypes,
17
- ForumLayoutTypes,
18
- } = require('../util/Constants');
19
- const DataResolver = require('../util/DataResolver');
20
- const Util = require('../util/Util');
21
- const { resolveAutoArchiveMaxLimit, transformGuildForumTag, transformGuildDefaultReaction } = require('../util/Util');
22
-
23
- let cacheWarningEmitted = false;
24
- let storeChannelDeprecationEmitted = false;
25
-
26
- /**
27
- * Manages API methods for GuildChannels and stores their cache.
28
- * @extends {CachedManager}
29
- */
30
- class GuildChannelManager extends CachedManager {
31
- constructor(guild, iterable) {
32
- super(guild.client, GuildChannel, iterable);
33
- const defaultCaching =
34
- this._cache.constructor.name === 'Collection' ||
35
- ((this._cache.maxSize === undefined || this._cache.maxSize === Infinity) &&
36
- (this._cache.sweepFilter === undefined || this._cache.sweepFilter.isDefault));
37
- if (!cacheWarningEmitted && !defaultCaching) {
38
- cacheWarningEmitted = true;
39
- process.emitWarning(
40
- `Overriding the cache handling for ${this.constructor.name} is unsupported and breaks functionality.`,
41
- 'UnsupportedCacheOverwriteWarning',
42
- );
43
- }
44
-
45
- /**
46
- * The guild this Manager belongs to
47
- * @type {Guild}
48
- */
49
- this.guild = guild;
50
- }
51
-
52
- /**
53
- * The number of channels in this managers cache excluding thread channels
54
- * that do not count towards a guild's maximum channels restriction.
55
- * @type {number}
56
- * @readonly
57
- */
58
- get channelCountWithoutThreads() {
59
- return this.cache.reduce((acc, channel) => {
60
- if (ThreadChannelTypes.includes(channel.type)) return acc;
61
- return ++acc;
62
- }, 0);
63
- }
64
-
65
- /**
66
- * The cache of this Manager
67
- * @type {Collection<Snowflake, GuildChannel|ThreadChannel>}
68
- * @name GuildChannelManager#cache
69
- */
70
-
71
- _add(channel) {
72
- const existing = this.cache.get(channel.id);
73
- if (existing) return existing;
74
- this.cache.set(channel.id, channel);
75
- return channel;
76
- }
77
-
78
- /**
79
- * Data that can be resolved to give a Guild Channel object. This can be:
80
- * * A GuildChannel object
81
- * * A ThreadChannel object
82
- * * A Snowflake
83
- * @typedef {GuildChannel|ThreadChannel|Snowflake} GuildChannelResolvable
84
- */
85
-
86
- /**
87
- * Resolves a GuildChannelResolvable to a Channel object.
88
- * @param {GuildChannelResolvable} channel The GuildChannel resolvable to resolve
89
- * @returns {?(GuildChannel|ThreadChannel)}
90
- */
91
- resolve(channel) {
92
- if (channel instanceof ThreadChannel) return super.resolve(channel.id);
93
- return super.resolve(channel);
94
- }
95
-
96
- /**
97
- * Resolves a GuildChannelResolvable to a channel id.
98
- * @param {GuildChannelResolvable} channel The GuildChannel resolvable to resolve
99
- * @returns {?Snowflake}
100
- */
101
- resolveId(channel) {
102
- if (channel instanceof ThreadChannel) return super.resolveId(channel.id);
103
- return super.resolveId(channel);
104
- }
105
-
106
- /**
107
- * Options used to create a new channel in a guild.
108
- * @typedef {CategoryCreateChannelOptions} GuildChannelCreateOptions
109
- * @property {CategoryChannelResolvable} [parent] Parent of the new channel
110
- */
111
-
112
- /**
113
- * Creates a new channel in the guild.
114
- * @param {string} name The name of the new channel
115
- * @param {GuildChannelCreateOptions} [options={}] Options for creating the new channel
116
- * @returns {Promise<GuildChannel>}
117
- * @example
118
- * // Create a new text channel
119
- * guild.channels.create('new-general', { reason: 'Needed a cool new channel' })
120
- * .then(console.log)
121
- * .catch(console.error);
122
- * @example
123
- * // Create a new channel with permission overwrites
124
- * guild.channels.create('new-voice', {
125
- * type: 'GUILD_VOICE',
126
- * permissionOverwrites: [
127
- * {
128
- * id: message.author.id,
129
- * deny: [Permissions.FLAGS.VIEW_CHANNEL],
130
- * },
131
- * ],
132
- * })
133
- */
134
- async create(
135
- name,
136
- {
137
- type,
138
- topic,
139
- nsfw,
140
- bitrate,
141
- userLimit,
142
- parent,
143
- permissionOverwrites,
144
- position,
145
- rateLimitPerUser,
146
- rtcRegion,
147
- videoQualityMode,
148
- availableTags,
149
- defaultReactionEmoji,
150
- defaultSortOrder,
151
- defaultForumLayout,
152
- defaultThreadRateLimitPerUser,
153
- reason,
154
- } = {},
155
- ) {
156
- parent &&= this.client.channels.resolveId(parent);
157
- permissionOverwrites &&= permissionOverwrites.map(o => PermissionOverwrites.resolve(o, this.guild));
158
- const intType = typeof type === 'number' ? type : ChannelTypes[type] ?? ChannelTypes.GUILD_TEXT;
159
-
160
- const videoMode = typeof videoQualityMode === 'number' ? videoQualityMode : VideoQualityModes[videoQualityMode];
161
-
162
- const sortMode = typeof defaultSortOrder === 'number' ? defaultSortOrder : SortOrderTypes[defaultSortOrder];
163
-
164
- const layoutMode =
165
- typeof defaultForumLayout === 'number' ? defaultForumLayout : ForumLayoutTypes[defaultForumLayout];
166
-
167
- if (intType === ChannelTypes.GUILD_STORE && !storeChannelDeprecationEmitted) {
168
- storeChannelDeprecationEmitted = true;
169
- process.emitWarning(
170
- // eslint-disable-next-line max-len
171
- 'Creating store channels is deprecated by Discord and will stop working in March 2022. Check the docs for more info.',
172
- 'DeprecationWarning',
173
- );
174
- }
175
-
176
- const data = await this.client.api.guilds(this.guild.id).channels.post({
177
- data: {
178
- name,
179
- topic,
180
- type: intType,
181
- nsfw,
182
- bitrate,
183
- user_limit: userLimit,
184
- parent_id: parent,
185
- position,
186
- permission_overwrites: permissionOverwrites,
187
- rate_limit_per_user: rateLimitPerUser,
188
- rtc_region: rtcRegion,
189
- video_quality_mode: videoMode,
190
- available_tags: availableTags?.map(availableTag => transformGuildForumTag(availableTag)),
191
- default_reaction_emoji: defaultReactionEmoji && transformGuildDefaultReaction(defaultReactionEmoji),
192
- default_sort_order: sortMode,
193
- default_forum_layout: layoutMode,
194
- default_thread_rate_limit_per_user: defaultThreadRateLimitPerUser,
195
- },
196
- reason,
197
- });
198
- return this.client.actions.ChannelCreate.handle(data).channel;
199
- }
200
-
201
- /**
202
- * Creates a webhook for the channel.
203
- * @param {GuildChannelResolvable} channel The channel to create the webhook for
204
- * @param {string} name The name of the webhook
205
- * @param {ChannelWebhookCreateOptions} [options] Options for creating the webhook
206
- * @returns {Promise<Webhook>} Returns the created Webhook
207
- * @example
208
- * // Create a webhook for the current channel
209
- * guild.channels.createWebhook('222197033908436994', 'Snek', {
210
- * avatar: 'https://i.imgur.com/mI8XcpG.jpg',
211
- * reason: 'Needed a cool new Webhook'
212
- * })
213
- * .then(console.log)
214
- * .catch(console.error)
215
- */
216
- async createWebhook(channel, name, { avatar, reason } = {}) {
217
- const id = this.resolveId(channel);
218
- if (!id) throw new TypeError('INVALID_TYPE', 'channel', 'GuildChannelResolvable');
219
- if (typeof avatar === 'string' && !avatar.startsWith('data:')) {
220
- avatar = await DataResolver.resolveImage(avatar);
221
- }
222
- const data = await this.client.api.channels[id].webhooks.post({
223
- data: {
224
- name,
225
- avatar,
226
- },
227
- reason,
228
- });
229
- return new Webhook(this.client, data);
230
- }
231
-
232
- /**
233
- * Adds the target channel to a channel's followers.
234
- * @param {NewsChannel|Snowflake} channel The channel to follow
235
- * @param {TextChannelResolvable} targetChannel The channel where published announcements will be posted at
236
- * @param {string} [reason] Reason for creating the webhook
237
- * @returns {Promise<Snowflake>} Returns created target webhook id.
238
- */
239
- async addFollower(channel, targetChannel, reason) {
240
- const channelId = this.resolveId(channel);
241
- const targetChannelId = this.resolveId(targetChannel);
242
- if (!channelId || !targetChannelId) throw new Error('GUILD_CHANNEL_RESOLVE');
243
- const { webhook_id } = await this.client.api.channels[channelId].followers.post({
244
- data: { webhook_channel_id: targetChannelId },
245
- reason,
246
- });
247
- return webhook_id;
248
- }
249
-
250
- /**
251
- * The data for a guild channel.
252
- * @typedef {Object} ChannelData
253
- * @property {string} [name] The name of the channel
254
- * @property {ChannelType} [type] The type of the channel (only conversion between text and news is supported)
255
- * @property {number} [position] The position of the channel
256
- * @property {string} [topic] The topic of the text channel
257
- * @property {boolean} [nsfw] Whether the channel is NSFW
258
- * @property {number} [bitrate] The bitrate of the voice channel
259
- * @property {number} [userLimit] The user limit of the voice channel
260
- * @property {?CategoryChannelResolvable} [parent] The parent of the channel
261
- * @property {boolean} [lockPermissions]
262
- * Lock the permissions of the channel to what the parent's permissions are
263
- * @property {OverwriteResolvable[]|Collection<Snowflake, OverwriteResolvable>} [permissionOverwrites]
264
- * Permission overwrites for the channel
265
- * @property {number} [rateLimitPerUser] The rate limit per user (slowmode) for the channel in seconds
266
- * @property {ThreadAutoArchiveDuration} [defaultAutoArchiveDuration]
267
- * The default auto archive duration for all new threads in this channel
268
- * @property {?string} [rtcRegion] The RTC region of the channel
269
- * @property {?VideoQualityMode|number} [videoQualityMode] The camera video quality mode of the channel
270
- * @property {ChannelFlagsResolvable} [flags] The flags to set on the channel
271
- * @property {GuildForumTagData[]} [availableTags] The tags to set as available in a forum channel
272
- * @property {?DefaultReactionEmoji} [defaultReactionEmoji] The emoji to set as the default reaction emoji
273
- * @property {number} [defaultThreadRateLimitPerUser] The rate limit per user (slowmode) to set on forum posts
274
- * @property {?SortOrderType} [defaultSortOrder] The default sort order mode to set on the channel
275
- */
276
-
277
- /**
278
- * Edits the channel.
279
- * @param {GuildChannelResolvable} channel The channel to edit
280
- * @param {ChannelData} data The new data for the channel
281
- * @param {string} [reason] Reason for editing this channel
282
- * @returns {Promise<GuildChannel>}
283
- * @example
284
- * // Edit a channel
285
- * guild.channels.edit('222197033908436994', { name: 'new-channel' })
286
- * .then(console.log)
287
- * .catch(console.error);
288
- */
289
- async edit(channel, data, reason) {
290
- channel = this.resolve(channel);
291
- if (!channel) throw new TypeError('INVALID_TYPE', 'channel', 'GuildChannelResolvable');
292
-
293
- const parent = data.parent && this.client.channels.resolveId(data.parent);
294
-
295
- if (typeof data.position !== 'undefined') await this.setPosition(channel, data.position, { reason });
296
-
297
- let permission_overwrites = data.permissionOverwrites?.map(o => PermissionOverwrites.resolve(o, this.guild));
298
-
299
- if (data.lockPermissions) {
300
- if (parent) {
301
- const newParent = this.guild.channels.resolve(parent);
302
- if (newParent?.type === 'GUILD_CATEGORY') {
303
- permission_overwrites = newParent.permissionOverwrites.cache.map(o =>
304
- PermissionOverwrites.resolve(o, this.guild),
305
- );
306
- }
307
- } else if (channel.parent) {
308
- permission_overwrites = channel.parent.permissionOverwrites.cache.map(o =>
309
- PermissionOverwrites.resolve(o, this.guild),
310
- );
311
- }
312
- }
313
-
314
- let defaultAutoArchiveDuration = data.defaultAutoArchiveDuration;
315
- if (defaultAutoArchiveDuration === 'MAX') defaultAutoArchiveDuration = resolveAutoArchiveMaxLimit(this.guild);
316
-
317
- const newData = await this.client.api.channels(channel.id).patch({
318
- data: {
319
- name: (data.name ?? channel.name).trim(),
320
- type: data.type,
321
- topic: data.topic,
322
- nsfw: data.nsfw,
323
- bitrate: data.bitrate ?? channel.bitrate,
324
- user_limit: data.userLimit ?? channel.userLimit,
325
- rtc_region: 'rtcRegion' in data ? data.rtcRegion : channel.rtcRegion,
326
- video_quality_mode:
327
- typeof data.videoQualityMode === 'string' ? VideoQualityModes[data.videoQualityMode] : data.videoQualityMode,
328
- parent_id: parent,
329
- lock_permissions: data.lockPermissions,
330
- rate_limit_per_user: data.rateLimitPerUser,
331
- default_auto_archive_duration: defaultAutoArchiveDuration,
332
- permission_overwrites,
333
- available_tags: data.availableTags?.map(availableTag => transformGuildForumTag(availableTag)),
334
- default_reaction_emoji: data.defaultReactionEmoji && transformGuildDefaultReaction(data.defaultReactionEmoji),
335
- default_thread_rate_limit_per_user: data.defaultThreadRateLimitPerUser,
336
- flags: 'flags' in data ? ChannelFlags.resolve(data.flags) : undefined,
337
- default_sort_order:
338
- typeof data.defaultSortOrder === 'string' ? SortOrderTypes[data.defaultSortOrder] : data.defaultSortOrder,
339
- },
340
- reason,
341
- });
342
-
343
- return this.client.actions.ChannelUpdate.handle(newData).updated;
344
- }
345
-
346
- /**
347
- * Sets a new position for the guild channel.
348
- * @param {GuildChannelResolvable} channel The channel to set the position for
349
- * @param {number} position The new position for the guild channel
350
- * @param {SetChannelPositionOptions} [options] Options for setting position
351
- * @returns {Promise<GuildChannel>}
352
- * @example
353
- * // Set a new channel position
354
- * guild.channels.setPosition('222078374472843266', 2)
355
- * .then(newChannel => console.log(`Channel's new position is ${newChannel.position}`))
356
- * .catch(console.error);
357
- */
358
- async setPosition(channel, position, { relative, reason } = {}) {
359
- channel = this.resolve(channel);
360
- if (!channel) throw new TypeError('INVALID_TYPE', 'channel', 'GuildChannelResolvable');
361
- const updatedChannels = await Util.setPosition(
362
- channel,
363
- position,
364
- relative,
365
- this.guild._sortedChannels(channel),
366
- this.client.api.guilds(this.guild.id).channels,
367
- reason,
368
- );
369
-
370
- this.client.actions.GuildChannelsPositionUpdate.handle({
371
- guild_id: this.guild.id,
372
- channels: updatedChannels,
373
- });
374
- return channel;
375
- }
376
-
377
- /**
378
- * Obtains one or more guild channels from Discord, or the channel cache if they're already available.
379
- * @param {Snowflake} [id] The channel's id
380
- * @param {BaseFetchOptions} [options] Additional options for this fetch
381
- * @returns {Promise<?GuildChannel|ThreadChannel|Collection<Snowflake, ?GuildChannel>>}
382
- * @example
383
- * // Fetch all channels from the guild (excluding threads)
384
- * message.guild.channels.fetch()
385
- * .then(channels => console.log(`There are ${channels.size} channels.`))
386
- * .catch(console.error);
387
- * @example
388
- * // Fetch a single channel
389
- * message.guild.channels.fetch('222197033908436994')
390
- * .then(channel => console.log(`The channel name is: ${channel.name}`))
391
- * .catch(console.error);
392
- */
393
- async fetch(id, { cache = true, force = false } = {}) {
394
- if (id && !force) {
395
- const existing = this.cache.get(id);
396
- if (existing) return existing;
397
- }
398
-
399
- if (id) {
400
- const data = await this.client.api.channels(id).get();
401
- // Since this is the guild manager, throw if on a different guild
402
- if (this.guild.id !== data.guild_id) throw new Error('GUILD_CHANNEL_UNOWNED');
403
- return this.client.channels._add(data, this.guild, { cache });
404
- }
405
-
406
- const data = await this.client.api.guilds(this.guild.id).channels.get();
407
- const channels = new Collection();
408
- for (const channel of data) channels.set(channel.id, this.client.channels._add(channel, this.guild, { cache }));
409
- return channels;
410
- }
411
-
412
- /**
413
- * Fetches all webhooks for the channel.
414
- * @param {GuildChannelResolvable} channel The channel to fetch webhooks for
415
- * @returns {Promise<Collection<Snowflake, Webhook>>}
416
- * @example
417
- * // Fetch webhooks
418
- * guild.channels.fetchWebhooks('769862166131245066')
419
- * .then(hooks => console.log(`This channel has ${hooks.size} hooks`))
420
- * .catch(console.error);
421
- */
422
- async fetchWebhooks(channel) {
423
- const id = this.resolveId(channel);
424
- if (!id) throw new TypeError('INVALID_TYPE', 'channel', 'GuildChannelResolvable');
425
- const data = await this.client.api.channels[id].webhooks.get();
426
- return data.reduce((hooks, hook) => hooks.set(hook.id, new Webhook(this.client, hook)), new Collection());
427
- }
428
-
429
- /**
430
- * Data that can be resolved to give a Category Channel object. This can be:
431
- * * A CategoryChannel object
432
- * * A Snowflake
433
- * @typedef {CategoryChannel|Snowflake} CategoryChannelResolvable
434
- */
435
-
436
- /**
437
- * The data needed for updating a channel's position.
438
- * @typedef {Object} ChannelPosition
439
- * @property {GuildChannel|Snowflake} channel Channel to update
440
- * @property {number} [position] New position for the channel
441
- * @property {CategoryChannelResolvable} [parent] Parent channel for this channel
442
- * @property {boolean} [lockPermissions] If the overwrites should be locked to the parents overwrites
443
- */
444
-
445
- /**
446
- * Batch-updates the guild's channels' positions.
447
- * <info>Only one channel's parent can be changed at a time</info>
448
- * @param {ChannelPosition[]} channelPositions Channel positions to update
449
- * @returns {Promise<Guild>}
450
- * @example
451
- * guild.channels.setPositions([{ channel: channelId, position: newChannelIndex }])
452
- * .then(guild => console.log(`Updated channel positions for ${guild}`))
453
- * .catch(console.error);
454
- */
455
- async setPositions(channelPositions) {
456
- channelPositions = channelPositions.map(r => ({
457
- id: this.client.channels.resolveId(r.channel),
458
- position: r.position,
459
- lock_permissions: r.lockPermissions,
460
- parent_id: typeof r.parent !== 'undefined' ? this.resolveId(r.parent) : undefined,
461
- }));
462
-
463
- await this.client.api.guilds(this.guild.id).channels.patch({ data: channelPositions });
464
- return this.client.actions.GuildChannelsPositionUpdate.handle({
465
- guild_id: this.guild.id,
466
- channels: channelPositions,
467
- }).guild;
468
- }
469
-
470
- /**
471
- * Deletes the channel.
472
- * @param {GuildChannelResolvable} channel The channel to delete
473
- * @param {string} [reason] Reason for deleting this channel
474
- * @returns {Promise<void>}
475
- * @example
476
- * // Delete the channel
477
- * guild.channels.delete('858850993013260338', 'making room for new channels')
478
- * .then(console.log)
479
- * .catch(console.error);
480
- */
481
- async delete(channel, reason) {
482
- const id = this.resolveId(channel);
483
- if (!id) throw new TypeError('INVALID_TYPE', 'channel', 'GuildChannelResolvable');
484
- await this.client.api.channels(id).delete({ reason });
485
- }
486
- }
487
-
488
- module.exports = GuildChannelManager;
1
+ 'use strict';
2
+
3
+ const process = require('node:process');
4
+ const { Collection } = require('@discordjs/collection');
5
+ const CachedManager = require('./CachedManager');
6
+ const { Error, TypeError } = require('../errors');
7
+ const GuildChannel = require('../structures/GuildChannel');
8
+ const PermissionOverwrites = require('../structures/PermissionOverwrites');
9
+ const ThreadChannel = require('../structures/ThreadChannel');
10
+ const Webhook = require('../structures/Webhook');
11
+ const ChannelFlags = require('../util/ChannelFlags');
12
+ const {
13
+ ThreadChannelTypes,
14
+ ChannelTypes,
15
+ VideoQualityModes,
16
+ SortOrderTypes,
17
+ ForumLayoutTypes,
18
+ } = require('../util/Constants');
19
+ const DataResolver = require('../util/DataResolver');
20
+ const Util = require('../util/Util');
21
+ const { resolveAutoArchiveMaxLimit, transformGuildForumTag, transformGuildDefaultReaction } = require('../util/Util');
22
+
23
+ let cacheWarningEmitted = false;
24
+ let storeChannelDeprecationEmitted = false;
25
+
26
+ /**
27
+ * Manages API methods for GuildChannels and stores their cache.
28
+ * @extends {CachedManager}
29
+ */
30
+ class GuildChannelManager extends CachedManager {
31
+ constructor(guild, iterable) {
32
+ super(guild.client, GuildChannel, iterable);
33
+ const defaultCaching =
34
+ this._cache.constructor.name === 'Collection' ||
35
+ ((this._cache.maxSize === undefined || this._cache.maxSize === Infinity) &&
36
+ (this._cache.sweepFilter === undefined || this._cache.sweepFilter.isDefault));
37
+ if (!cacheWarningEmitted && !defaultCaching) {
38
+ cacheWarningEmitted = true;
39
+ process.emitWarning(
40
+ `Overriding the cache handling for ${this.constructor.name} is unsupported and breaks functionality.`,
41
+ 'UnsupportedCacheOverwriteWarning',
42
+ );
43
+ }
44
+
45
+ /**
46
+ * The guild this Manager belongs to
47
+ * @type {Guild}
48
+ */
49
+ this.guild = guild;
50
+ }
51
+
52
+ /**
53
+ * The number of channels in this managers cache excluding thread channels
54
+ * that do not count towards a guild's maximum channels restriction.
55
+ * @type {number}
56
+ * @readonly
57
+ */
58
+ get channelCountWithoutThreads() {
59
+ return this.cache.reduce((acc, channel) => {
60
+ if (ThreadChannelTypes.includes(channel.type)) return acc;
61
+ return ++acc;
62
+ }, 0);
63
+ }
64
+
65
+ /**
66
+ * The cache of this Manager
67
+ * @type {Collection<Snowflake, GuildChannel|ThreadChannel>}
68
+ * @name GuildChannelManager#cache
69
+ */
70
+
71
+ _add(channel) {
72
+ const existing = this.cache.get(channel.id);
73
+ if (existing) return existing;
74
+ this.cache.set(channel.id, channel);
75
+ return channel;
76
+ }
77
+
78
+ /**
79
+ * Data that can be resolved to give a Guild Channel object. This can be:
80
+ * * A GuildChannel object
81
+ * * A ThreadChannel object
82
+ * * A Snowflake
83
+ * @typedef {GuildChannel|ThreadChannel|Snowflake} GuildChannelResolvable
84
+ */
85
+
86
+ /**
87
+ * Resolves a GuildChannelResolvable to a Channel object.
88
+ * @param {GuildChannelResolvable} channel The GuildChannel resolvable to resolve
89
+ * @returns {?(GuildChannel|ThreadChannel)}
90
+ */
91
+ resolve(channel) {
92
+ if (channel instanceof ThreadChannel) return this.cache.get(channel.id) ?? null;
93
+ return super.resolve(channel);
94
+ }
95
+
96
+ /**
97
+ * Resolves a GuildChannelResolvable to a channel id.
98
+ * @param {GuildChannelResolvable} channel The GuildChannel resolvable to resolve
99
+ * @returns {?Snowflake}
100
+ */
101
+ resolveId(channel) {
102
+ if (channel instanceof ThreadChannel) return super.resolveId(channel.id);
103
+ return super.resolveId(channel);
104
+ }
105
+
106
+ /**
107
+ * Options used to create a new channel in a guild.
108
+ * @typedef {CategoryCreateChannelOptions} GuildChannelCreateOptions
109
+ * @property {CategoryChannelResolvable} [parent] Parent of the new channel
110
+ */
111
+
112
+ /**
113
+ * Creates a new channel in the guild.
114
+ * @param {string} name The name of the new channel
115
+ * @param {GuildChannelCreateOptions} [options={}] Options for creating the new channel
116
+ * @returns {Promise<GuildChannel>}
117
+ * @example
118
+ * // Create a new text channel
119
+ * guild.channels.create('new-general', { reason: 'Needed a cool new channel' })
120
+ * .then(console.log)
121
+ * .catch(console.error);
122
+ * @example
123
+ * // Create a new channel with permission overwrites
124
+ * guild.channels.create('new-voice', {
125
+ * type: 'GUILD_VOICE',
126
+ * permissionOverwrites: [
127
+ * {
128
+ * id: message.author.id,
129
+ * deny: [Permissions.FLAGS.VIEW_CHANNEL],
130
+ * },
131
+ * ],
132
+ * })
133
+ */
134
+ async create(
135
+ name,
136
+ {
137
+ type,
138
+ topic,
139
+ nsfw,
140
+ bitrate,
141
+ userLimit,
142
+ parent,
143
+ permissionOverwrites,
144
+ position,
145
+ rateLimitPerUser,
146
+ rtcRegion,
147
+ videoQualityMode,
148
+ availableTags,
149
+ defaultReactionEmoji,
150
+ defaultSortOrder,
151
+ defaultForumLayout,
152
+ defaultThreadRateLimitPerUser,
153
+ reason,
154
+ } = {},
155
+ ) {
156
+ parent &&= this.client.channels.resolveId(parent);
157
+ permissionOverwrites &&= permissionOverwrites.map(o => PermissionOverwrites.resolve(o, this.guild));
158
+ const intType = typeof type === 'number' ? type : ChannelTypes[type] ?? ChannelTypes.GUILD_TEXT;
159
+
160
+ const videoMode = typeof videoQualityMode === 'number' ? videoQualityMode : VideoQualityModes[videoQualityMode];
161
+
162
+ const sortMode = typeof defaultSortOrder === 'number' ? defaultSortOrder : SortOrderTypes[defaultSortOrder];
163
+
164
+ const layoutMode =
165
+ typeof defaultForumLayout === 'number' ? defaultForumLayout : ForumLayoutTypes[defaultForumLayout];
166
+
167
+ if (intType === ChannelTypes.GUILD_STORE && !storeChannelDeprecationEmitted) {
168
+ storeChannelDeprecationEmitted = true;
169
+ process.emitWarning(
170
+ // eslint-disable-next-line max-len
171
+ 'Creating store channels is deprecated by Discord and will stop working in March 2022. Check the docs for more info.',
172
+ 'DeprecationWarning',
173
+ );
174
+ }
175
+
176
+ const data = await this.client.api.guilds(this.guild.id).channels.post({
177
+ data: {
178
+ name,
179
+ topic,
180
+ type: intType,
181
+ nsfw,
182
+ bitrate,
183
+ user_limit: userLimit,
184
+ parent_id: parent,
185
+ position,
186
+ permission_overwrites: permissionOverwrites,
187
+ rate_limit_per_user: rateLimitPerUser,
188
+ rtc_region: rtcRegion,
189
+ video_quality_mode: videoMode,
190
+ available_tags: availableTags?.map(availableTag => transformGuildForumTag(availableTag)),
191
+ default_reaction_emoji: defaultReactionEmoji && transformGuildDefaultReaction(defaultReactionEmoji),
192
+ default_sort_order: sortMode,
193
+ default_forum_layout: layoutMode,
194
+ default_thread_rate_limit_per_user: defaultThreadRateLimitPerUser,
195
+ },
196
+ reason,
197
+ });
198
+ return this.client.actions.ChannelCreate.handle(data).channel;
199
+ }
200
+
201
+ /**
202
+ * Creates a webhook for the channel.
203
+ * @param {GuildChannelResolvable} channel The channel to create the webhook for
204
+ * @param {string} name The name of the webhook
205
+ * @param {ChannelWebhookCreateOptions} [options] Options for creating the webhook
206
+ * @returns {Promise<Webhook>} Returns the created Webhook
207
+ * @example
208
+ * // Create a webhook for the current channel
209
+ * guild.channels.createWebhook('222197033908436994', 'Snek', {
210
+ * avatar: 'https://i.imgur.com/mI8XcpG.jpg',
211
+ * reason: 'Needed a cool new Webhook'
212
+ * })
213
+ * .then(console.log)
214
+ * .catch(console.error)
215
+ */
216
+ async createWebhook(channel, name, { avatar, reason } = {}) {
217
+ const id = this.resolveId(channel);
218
+ if (!id) throw new TypeError('INVALID_TYPE', 'channel', 'GuildChannelResolvable');
219
+
220
+ const resolvedImage = await DataResolver.resolveImage(avatar);
221
+
222
+ const data = await this.client.api.channels[id].webhooks.post({
223
+ data: {
224
+ name,
225
+ avatar: resolvedImage,
226
+ },
227
+ reason,
228
+ });
229
+ return new Webhook(this.client, data);
230
+ }
231
+
232
+ /**
233
+ * Adds the target channel to a channel's followers.
234
+ * @param {NewsChannel|Snowflake} channel The channel to follow
235
+ * @param {TextChannelResolvable} targetChannel The channel where published announcements will be posted at
236
+ * @param {string} [reason] Reason for creating the webhook
237
+ * @returns {Promise<Snowflake>} Returns created target webhook id.
238
+ */
239
+ async addFollower(channel, targetChannel, reason) {
240
+ const channelId = this.resolveId(channel);
241
+ const targetChannelId = this.resolveId(targetChannel);
242
+ if (!channelId || !targetChannelId) throw new Error('GUILD_CHANNEL_RESOLVE');
243
+ const { webhook_id } = await this.client.api.channels[channelId].followers.post({
244
+ data: { webhook_channel_id: targetChannelId },
245
+ reason,
246
+ });
247
+ return webhook_id;
248
+ }
249
+
250
+ /**
251
+ * The data for a guild channel.
252
+ * @typedef {Object} ChannelData
253
+ * @property {string} [name] The name of the channel
254
+ * @property {ChannelType} [type] The type of the channel (only conversion between text and news is supported)
255
+ * @property {number} [position] The position of the channel
256
+ * @property {string} [topic] The topic of the text channel
257
+ * @property {boolean} [nsfw] Whether the channel is NSFW
258
+ * @property {number} [bitrate] The bitrate of the voice channel
259
+ * @property {number} [userLimit] The user limit of the voice channel
260
+ * @property {?CategoryChannelResolvable} [parent] The parent of the channel
261
+ * @property {boolean} [lockPermissions]
262
+ * Lock the permissions of the channel to what the parent's permissions are
263
+ * @property {OverwriteResolvable[]|Collection<Snowflake, OverwriteResolvable>} [permissionOverwrites]
264
+ * Permission overwrites for the channel
265
+ * @property {number} [rateLimitPerUser] The rate limit per user (slowmode) for the channel in seconds
266
+ * @property {ThreadAutoArchiveDuration} [defaultAutoArchiveDuration]
267
+ * The default auto archive duration for all new threads in this channel
268
+ * @property {?string} [rtcRegion] The RTC region of the channel
269
+ * @property {?VideoQualityMode|number} [videoQualityMode] The camera video quality mode of the channel
270
+ * @property {ChannelFlagsResolvable} [flags] The flags to set on the channel
271
+ * @property {GuildForumTagData[]} [availableTags] The tags to set as available in a forum channel
272
+ * @property {?DefaultReactionEmoji} [defaultReactionEmoji] The emoji to set as the default reaction emoji
273
+ * @property {number} [defaultThreadRateLimitPerUser] The rate limit per user (slowmode) to set on forum posts
274
+ * @property {?SortOrderType} [defaultSortOrder] The default sort order mode to set on the channel
275
+ */
276
+
277
+ /**
278
+ * Edits the channel.
279
+ * @param {GuildChannelResolvable} channel The channel to edit
280
+ * @param {ChannelData} data The new data for the channel
281
+ * @param {string} [reason] Reason for editing this channel
282
+ * @returns {Promise<GuildChannel>}
283
+ * @example
284
+ * // Edit a channel
285
+ * guild.channels.edit('222197033908436994', { name: 'new-channel' })
286
+ * .then(console.log)
287
+ * .catch(console.error);
288
+ */
289
+ async edit(channel, data, reason) {
290
+ channel = this.resolve(channel);
291
+ if (!channel) throw new TypeError('INVALID_TYPE', 'channel', 'GuildChannelResolvable');
292
+
293
+ const parentId = data.parent && this.client.channels.resolveId(data.parent);
294
+
295
+ if (typeof data.position !== 'undefined') await this.setPosition(channel, data.position, { reason });
296
+
297
+ let permission_overwrites = data.permissionOverwrites?.map(o => PermissionOverwrites.resolve(o, this.guild));
298
+
299
+ if (data.lockPermissions) {
300
+ if (parentId) {
301
+ const newParent = this.cache.get(parentId);
302
+ if (newParent?.type === 'GUILD_CATEGORY') {
303
+ permission_overwrites = newParent.permissionOverwrites.cache.map(o =>
304
+ PermissionOverwrites.resolve(o, this.guild),
305
+ );
306
+ }
307
+ } else if (channel.parent) {
308
+ permission_overwrites = channel.parent.permissionOverwrites.cache.map(o =>
309
+ PermissionOverwrites.resolve(o, this.guild),
310
+ );
311
+ }
312
+ }
313
+
314
+ let defaultAutoArchiveDuration = data.defaultAutoArchiveDuration;
315
+ if (defaultAutoArchiveDuration === 'MAX') defaultAutoArchiveDuration = resolveAutoArchiveMaxLimit(this.guild);
316
+
317
+ const newData = await this.client.api.channels(channel.id).patch({
318
+ data: {
319
+ name: (data.name ?? channel.name).trim(),
320
+ type: data.type,
321
+ topic: data.topic,
322
+ nsfw: data.nsfw,
323
+ bitrate: data.bitrate ?? channel.bitrate,
324
+ user_limit: data.userLimit ?? channel.userLimit,
325
+ rtc_region: 'rtcRegion' in data ? data.rtcRegion : channel.rtcRegion,
326
+ video_quality_mode:
327
+ typeof data.videoQualityMode === 'string' ? VideoQualityModes[data.videoQualityMode] : data.videoQualityMode,
328
+ parent_id: parentId,
329
+ lock_permissions: data.lockPermissions,
330
+ rate_limit_per_user: data.rateLimitPerUser,
331
+ default_auto_archive_duration: defaultAutoArchiveDuration,
332
+ permission_overwrites,
333
+ available_tags: data.availableTags?.map(availableTag => transformGuildForumTag(availableTag)),
334
+ default_reaction_emoji: data.defaultReactionEmoji && transformGuildDefaultReaction(data.defaultReactionEmoji),
335
+ default_thread_rate_limit_per_user: data.defaultThreadRateLimitPerUser,
336
+ flags: 'flags' in data ? ChannelFlags.resolve(data.flags) : undefined,
337
+ default_sort_order:
338
+ typeof data.defaultSortOrder === 'string' ? SortOrderTypes[data.defaultSortOrder] : data.defaultSortOrder,
339
+ },
340
+ reason,
341
+ });
342
+
343
+ return this.client.actions.ChannelUpdate.handle(newData).updated;
344
+ }
345
+
346
+ /**
347
+ * Sets a new position for the guild channel.
348
+ * @param {GuildChannelResolvable} channel The channel to set the position for
349
+ * @param {number} position The new position for the guild channel
350
+ * @param {SetChannelPositionOptions} [options] Options for setting position
351
+ * @returns {Promise<GuildChannel>}
352
+ * @example
353
+ * // Set a new channel position
354
+ * guild.channels.setPosition('222078374472843266', 2)
355
+ * .then(newChannel => console.log(`Channel's new position is ${newChannel.position}`))
356
+ * .catch(console.error);
357
+ */
358
+ async setPosition(channel, position, { relative, reason } = {}) {
359
+ channel = this.resolve(channel);
360
+ if (!channel) throw new TypeError('INVALID_TYPE', 'channel', 'GuildChannelResolvable');
361
+ const updatedChannels = await Util.setPosition(
362
+ channel,
363
+ position,
364
+ relative,
365
+ this.guild._sortedChannels(channel),
366
+ this.client.api.guilds(this.guild.id).channels,
367
+ reason,
368
+ );
369
+
370
+ this.client.actions.GuildChannelsPositionUpdate.handle({
371
+ guild_id: this.guild.id,
372
+ channels: updatedChannels,
373
+ });
374
+ return channel;
375
+ }
376
+
377
+ /**
378
+ * Obtains one or more guild channels from Discord, or the channel cache if they're already available.
379
+ * @param {Snowflake} [id] The channel's id
380
+ * @param {BaseFetchOptions} [options] Additional options for this fetch
381
+ * @returns {Promise<?GuildChannel|ThreadChannel|Collection<Snowflake, ?GuildChannel>>}
382
+ * @example
383
+ * // Fetch all channels from the guild (excluding threads)
384
+ * message.guild.channels.fetch()
385
+ * .then(channels => console.log(`There are ${channels.size} channels.`))
386
+ * .catch(console.error);
387
+ * @example
388
+ * // Fetch a single channel
389
+ * message.guild.channels.fetch('222197033908436994')
390
+ * .then(channel => console.log(`The channel name is: ${channel.name}`))
391
+ * .catch(console.error);
392
+ */
393
+ async fetch(id, { cache = true, force = false } = {}) {
394
+ if (id && !force) {
395
+ const existing = this.cache.get(id);
396
+ if (existing) return existing;
397
+ }
398
+
399
+ if (id) {
400
+ const data = await this.client.api.channels(id).get();
401
+ // Since this is the guild manager, throw if on a different guild
402
+ if (this.guild.id !== data.guild_id) throw new Error('GUILD_CHANNEL_UNOWNED');
403
+ return this.client.channels._add(data, this.guild, { cache });
404
+ }
405
+
406
+ const data = await this.client.api.guilds(this.guild.id).channels.get();
407
+ const channels = new Collection();
408
+ for (const channel of data) channels.set(channel.id, this.client.channels._add(channel, this.guild, { cache }));
409
+ return channels;
410
+ }
411
+
412
+ /**
413
+ * Fetches all webhooks for the channel.
414
+ * @param {GuildChannelResolvable} channel The channel to fetch webhooks for
415
+ * @returns {Promise<Collection<Snowflake, Webhook>>}
416
+ * @example
417
+ * // Fetch webhooks
418
+ * guild.channels.fetchWebhooks('769862166131245066')
419
+ * .then(hooks => console.log(`This channel has ${hooks.size} hooks`))
420
+ * .catch(console.error);
421
+ */
422
+ async fetchWebhooks(channel) {
423
+ const id = this.resolveId(channel);
424
+ if (!id) throw new TypeError('INVALID_TYPE', 'channel', 'GuildChannelResolvable');
425
+ const data = await this.client.api.channels[id].webhooks.get();
426
+ return data.reduce((hooks, hook) => hooks.set(hook.id, new Webhook(this.client, hook)), new Collection());
427
+ }
428
+
429
+ /**
430
+ * Data that can be resolved to give a Category Channel object. This can be:
431
+ * * A CategoryChannel object
432
+ * * A Snowflake
433
+ * @typedef {CategoryChannel|Snowflake} CategoryChannelResolvable
434
+ */
435
+
436
+ /**
437
+ * The data needed for updating a channel's position.
438
+ * @typedef {Object} ChannelPosition
439
+ * @property {GuildChannel|Snowflake} channel Channel to update
440
+ * @property {number} [position] New position for the channel
441
+ * @property {CategoryChannelResolvable} [parent] Parent channel for this channel
442
+ * @property {boolean} [lockPermissions] If the overwrites should be locked to the parents overwrites
443
+ */
444
+
445
+ /**
446
+ * Batch-updates the guild's channels' positions.
447
+ * <info>Only one channel's parent can be changed at a time</info>
448
+ * @param {ChannelPosition[]} channelPositions Channel positions to update
449
+ * @returns {Promise<Guild>}
450
+ * @example
451
+ * guild.channels.setPositions([{ channel: channelId, position: newChannelIndex }])
452
+ * .then(guild => console.log(`Updated channel positions for ${guild}`))
453
+ * .catch(console.error);
454
+ */
455
+ async setPositions(channelPositions) {
456
+ channelPositions = channelPositions.map(r => ({
457
+ id: this.client.channels.resolveId(r.channel),
458
+ position: r.position,
459
+ lock_permissions: r.lockPermissions,
460
+ parent_id: typeof r.parent !== 'undefined' ? this.resolveId(r.parent) : undefined,
461
+ }));
462
+
463
+ await this.client.api.guilds(this.guild.id).channels.patch({ data: channelPositions });
464
+ return this.client.actions.GuildChannelsPositionUpdate.handle({
465
+ guild_id: this.guild.id,
466
+ channels: channelPositions,
467
+ }).guild;
468
+ }
469
+
470
+ /**
471
+ * Deletes the channel.
472
+ * @param {GuildChannelResolvable} channel The channel to delete
473
+ * @param {string} [reason] Reason for deleting this channel
474
+ * @returns {Promise<void>}
475
+ * @example
476
+ * // Delete the channel
477
+ * guild.channels.delete('858850993013260338', 'making room for new channels')
478
+ * .then(console.log)
479
+ * .catch(console.error);
480
+ */
481
+ async delete(channel, reason) {
482
+ const id = this.resolveId(channel);
483
+ if (!id) throw new TypeError('INVALID_TYPE', 'channel', 'GuildChannelResolvable');
484
+ await this.client.api.channels(id).delete({ reason });
485
+ }
486
+ }
487
+
488
+ module.exports = GuildChannelManager;