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