djs-selfbot-v13 3.2.2 → 3.7.1

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