discord-selfbot-v13.js 0.0.1-security → 3.2.0

Sign up to get free protection for your applications and to get access to all the features.

Potentially problematic release.


This version of discord-selfbot-v13.js might be problematic. Click here for more details.

Files changed (343) hide show
  1. package/LICENSE +674 -0
  2. package/README.md +119 -5
  3. package/package.json +101 -6
  4. package/src/WebSocket.js +39 -0
  5. package/src/client/BaseClient.js +87 -0
  6. package/src/client/Client.js +1154 -0
  7. package/src/client/WebhookClient.js +61 -0
  8. package/src/client/actions/Action.js +115 -0
  9. package/src/client/actions/ActionsManager.js +72 -0
  10. package/src/client/actions/ApplicationCommandPermissionsUpdate.js +34 -0
  11. package/src/client/actions/AutoModerationActionExecution.js +26 -0
  12. package/src/client/actions/AutoModerationRuleCreate.js +27 -0
  13. package/src/client/actions/AutoModerationRuleDelete.js +31 -0
  14. package/src/client/actions/AutoModerationRuleUpdate.js +29 -0
  15. package/src/client/actions/ChannelCreate.js +23 -0
  16. package/src/client/actions/ChannelDelete.js +39 -0
  17. package/src/client/actions/ChannelUpdate.js +34 -0
  18. package/src/client/actions/GuildAuditLogEntryCreate.js +29 -0
  19. package/src/client/actions/GuildBanAdd.js +20 -0
  20. package/src/client/actions/GuildBanRemove.js +25 -0
  21. package/src/client/actions/GuildChannelsPositionUpdate.js +21 -0
  22. package/src/client/actions/GuildDelete.js +65 -0
  23. package/src/client/actions/GuildEmojiCreate.js +20 -0
  24. package/src/client/actions/GuildEmojiDelete.js +21 -0
  25. package/src/client/actions/GuildEmojiUpdate.js +20 -0
  26. package/src/client/actions/GuildEmojisUpdate.js +34 -0
  27. package/src/client/actions/GuildIntegrationsUpdate.js +19 -0
  28. package/src/client/actions/GuildMemberRemove.js +33 -0
  29. package/src/client/actions/GuildMemberUpdate.js +44 -0
  30. package/src/client/actions/GuildRoleCreate.js +25 -0
  31. package/src/client/actions/GuildRoleDelete.js +31 -0
  32. package/src/client/actions/GuildRoleUpdate.js +39 -0
  33. package/src/client/actions/GuildRolesPositionUpdate.js +21 -0
  34. package/src/client/actions/GuildScheduledEventCreate.js +27 -0
  35. package/src/client/actions/GuildScheduledEventDelete.js +31 -0
  36. package/src/client/actions/GuildScheduledEventUpdate.js +30 -0
  37. package/src/client/actions/GuildScheduledEventUserAdd.js +32 -0
  38. package/src/client/actions/GuildScheduledEventUserRemove.js +32 -0
  39. package/src/client/actions/GuildStickerCreate.js +20 -0
  40. package/src/client/actions/GuildStickerDelete.js +21 -0
  41. package/src/client/actions/GuildStickerUpdate.js +20 -0
  42. package/src/client/actions/GuildStickersUpdate.js +34 -0
  43. package/src/client/actions/GuildUpdate.js +33 -0
  44. package/src/client/actions/InteractionCreate.js +115 -0
  45. package/src/client/actions/InviteCreate.js +28 -0
  46. package/src/client/actions/InviteDelete.js +30 -0
  47. package/src/client/actions/MessageCreate.js +50 -0
  48. package/src/client/actions/MessageDelete.js +32 -0
  49. package/src/client/actions/MessageDeleteBulk.js +46 -0
  50. package/src/client/actions/MessageReactionAdd.js +56 -0
  51. package/src/client/actions/MessageReactionRemove.js +45 -0
  52. package/src/client/actions/MessageReactionRemoveAll.js +33 -0
  53. package/src/client/actions/MessageReactionRemoveEmoji.js +28 -0
  54. package/src/client/actions/MessageUpdate.js +26 -0
  55. package/src/client/actions/PresenceUpdate.js +45 -0
  56. package/src/client/actions/StageInstanceCreate.js +28 -0
  57. package/src/client/actions/StageInstanceDelete.js +33 -0
  58. package/src/client/actions/StageInstanceUpdate.js +30 -0
  59. package/src/client/actions/ThreadCreate.js +24 -0
  60. package/src/client/actions/ThreadDelete.js +32 -0
  61. package/src/client/actions/ThreadListSync.js +59 -0
  62. package/src/client/actions/ThreadMemberUpdate.js +30 -0
  63. package/src/client/actions/ThreadMembersUpdate.js +34 -0
  64. package/src/client/actions/TypingStart.js +29 -0
  65. package/src/client/actions/UserUpdate.js +35 -0
  66. package/src/client/actions/VoiceStateUpdate.js +57 -0
  67. package/src/client/actions/WebhooksUpdate.js +20 -0
  68. package/src/client/voice/ClientVoiceManager.js +51 -0
  69. package/src/client/websocket/WebSocketManager.js +412 -0
  70. package/src/client/websocket/WebSocketShard.js +908 -0
  71. package/src/client/websocket/handlers/APPLICATION_COMMAND_AUTOCOMPLETE_RESPONSE.js +23 -0
  72. package/src/client/websocket/handlers/APPLICATION_COMMAND_CREATE.js +18 -0
  73. package/src/client/websocket/handlers/APPLICATION_COMMAND_DELETE.js +20 -0
  74. package/src/client/websocket/handlers/APPLICATION_COMMAND_PERMISSIONS_UPDATE.js +5 -0
  75. package/src/client/websocket/handlers/APPLICATION_COMMAND_UPDATE.js +20 -0
  76. package/src/client/websocket/handlers/AUTO_MODERATION_ACTION_EXECUTION.js +5 -0
  77. package/src/client/websocket/handlers/AUTO_MODERATION_RULE_CREATE.js +5 -0
  78. package/src/client/websocket/handlers/AUTO_MODERATION_RULE_DELETE.js +5 -0
  79. package/src/client/websocket/handlers/AUTO_MODERATION_RULE_UPDATE.js +5 -0
  80. package/src/client/websocket/handlers/CALL_CREATE.js +14 -0
  81. package/src/client/websocket/handlers/CALL_DELETE.js +11 -0
  82. package/src/client/websocket/handlers/CALL_UPDATE.js +11 -0
  83. package/src/client/websocket/handlers/CHANNEL_CREATE.js +5 -0
  84. package/src/client/websocket/handlers/CHANNEL_DELETE.js +5 -0
  85. package/src/client/websocket/handlers/CHANNEL_PINS_UPDATE.js +22 -0
  86. package/src/client/websocket/handlers/CHANNEL_RECIPIENT_ADD.js +16 -0
  87. package/src/client/websocket/handlers/CHANNEL_RECIPIENT_REMOVE.js +16 -0
  88. package/src/client/websocket/handlers/CHANNEL_UPDATE.js +16 -0
  89. package/src/client/websocket/handlers/GUILD_APPLICATION_COMMANDS_UPDATE.js +11 -0
  90. package/src/client/websocket/handlers/GUILD_AUDIT_LOG_ENTRY_CREATE.js +5 -0
  91. package/src/client/websocket/handlers/GUILD_BAN_ADD.js +5 -0
  92. package/src/client/websocket/handlers/GUILD_BAN_REMOVE.js +5 -0
  93. package/src/client/websocket/handlers/GUILD_CREATE.js +46 -0
  94. package/src/client/websocket/handlers/GUILD_DELETE.js +5 -0
  95. package/src/client/websocket/handlers/GUILD_EMOJIS_UPDATE.js +5 -0
  96. package/src/client/websocket/handlers/GUILD_INTEGRATIONS_UPDATE.js +5 -0
  97. package/src/client/websocket/handlers/GUILD_MEMBERS_CHUNK.js +39 -0
  98. package/src/client/websocket/handlers/GUILD_MEMBER_ADD.js +20 -0
  99. package/src/client/websocket/handlers/GUILD_MEMBER_LIST_UPDATE.js +55 -0
  100. package/src/client/websocket/handlers/GUILD_MEMBER_REMOVE.js +5 -0
  101. package/src/client/websocket/handlers/GUILD_MEMBER_UPDATE.js +5 -0
  102. package/src/client/websocket/handlers/GUILD_ROLE_CREATE.js +5 -0
  103. package/src/client/websocket/handlers/GUILD_ROLE_DELETE.js +5 -0
  104. package/src/client/websocket/handlers/GUILD_ROLE_UPDATE.js +5 -0
  105. package/src/client/websocket/handlers/GUILD_SCHEDULED_EVENT_CREATE.js +5 -0
  106. package/src/client/websocket/handlers/GUILD_SCHEDULED_EVENT_DELETE.js +5 -0
  107. package/src/client/websocket/handlers/GUILD_SCHEDULED_EVENT_UPDATE.js +5 -0
  108. package/src/client/websocket/handlers/GUILD_SCHEDULED_EVENT_USER_ADD.js +5 -0
  109. package/src/client/websocket/handlers/GUILD_SCHEDULED_EVENT_USER_REMOVE.js +5 -0
  110. package/src/client/websocket/handlers/GUILD_STICKERS_UPDATE.js +5 -0
  111. package/src/client/websocket/handlers/GUILD_UPDATE.js +5 -0
  112. package/src/client/websocket/handlers/INTERACTION_CREATE.js +16 -0
  113. package/src/client/websocket/handlers/INTERACTION_FAILURE.js +18 -0
  114. package/src/client/websocket/handlers/INTERACTION_MODAL_CREATE.js +11 -0
  115. package/src/client/websocket/handlers/INTERACTION_SUCCESS.js +30 -0
  116. package/src/client/websocket/handlers/INVITE_CREATE.js +5 -0
  117. package/src/client/websocket/handlers/INVITE_DELETE.js +5 -0
  118. package/src/client/websocket/handlers/MESSAGE_ACK.js +16 -0
  119. package/src/client/websocket/handlers/MESSAGE_CREATE.js +5 -0
  120. package/src/client/websocket/handlers/MESSAGE_DELETE.js +5 -0
  121. package/src/client/websocket/handlers/MESSAGE_DELETE_BULK.js +5 -0
  122. package/src/client/websocket/handlers/MESSAGE_REACTION_ADD.js +5 -0
  123. package/src/client/websocket/handlers/MESSAGE_REACTION_REMOVE.js +5 -0
  124. package/src/client/websocket/handlers/MESSAGE_REACTION_REMOVE_ALL.js +5 -0
  125. package/src/client/websocket/handlers/MESSAGE_REACTION_REMOVE_EMOJI.js +5 -0
  126. package/src/client/websocket/handlers/MESSAGE_UPDATE.js +16 -0
  127. package/src/client/websocket/handlers/PRESENCE_UPDATE.js +5 -0
  128. package/src/client/websocket/handlers/READY.js +172 -0
  129. package/src/client/websocket/handlers/RELATIONSHIP_ADD.js +17 -0
  130. package/src/client/websocket/handlers/RELATIONSHIP_REMOVE.js +15 -0
  131. package/src/client/websocket/handlers/RELATIONSHIP_UPDATE.js +18 -0
  132. package/src/client/websocket/handlers/RESUMED.js +14 -0
  133. package/src/client/websocket/handlers/STAGE_INSTANCE_CREATE.js +5 -0
  134. package/src/client/websocket/handlers/STAGE_INSTANCE_DELETE.js +5 -0
  135. package/src/client/websocket/handlers/STAGE_INSTANCE_UPDATE.js +5 -0
  136. package/src/client/websocket/handlers/THREAD_CREATE.js +5 -0
  137. package/src/client/websocket/handlers/THREAD_DELETE.js +5 -0
  138. package/src/client/websocket/handlers/THREAD_LIST_SYNC.js +5 -0
  139. package/src/client/websocket/handlers/THREAD_MEMBERS_UPDATE.js +5 -0
  140. package/src/client/websocket/handlers/THREAD_MEMBER_UPDATE.js +5 -0
  141. package/src/client/websocket/handlers/THREAD_UPDATE.js +16 -0
  142. package/src/client/websocket/handlers/TYPING_START.js +5 -0
  143. package/src/client/websocket/handlers/USER_GUILD_SETTINGS_UPDATE.js +12 -0
  144. package/src/client/websocket/handlers/USER_NOTE_UPDATE.js +5 -0
  145. package/src/client/websocket/handlers/USER_SETTINGS_UPDATE.js +9 -0
  146. package/src/client/websocket/handlers/USER_UPDATE.js +5 -0
  147. package/src/client/websocket/handlers/VOICE_SERVER_UPDATE.js +6 -0
  148. package/src/client/websocket/handlers/VOICE_STATE_UPDATE.js +5 -0
  149. package/src/client/websocket/handlers/WEBHOOKS_UPDATE.js +5 -0
  150. package/src/client/websocket/handlers/index.js +86 -0
  151. package/src/errors/DJSError.js +61 -0
  152. package/src/errors/Messages.js +227 -0
  153. package/src/errors/index.js +4 -0
  154. package/src/index.js +190 -0
  155. package/src/main.js +42 -0
  156. package/src/managers/ApplicationCommandManager.js +267 -0
  157. package/src/managers/ApplicationCommandPermissionsManager.js +425 -0
  158. package/src/managers/AutoModerationRuleManager.js +296 -0
  159. package/src/managers/BaseGuildEmojiManager.js +80 -0
  160. package/src/managers/BaseManager.js +19 -0
  161. package/src/managers/BillingManager.js +66 -0
  162. package/src/managers/CachedManager.js +71 -0
  163. package/src/managers/ChannelManager.js +139 -0
  164. package/src/managers/ClientUserSettingManager.js +490 -0
  165. package/src/managers/DataManager.js +61 -0
  166. package/src/managers/DeveloperPortalManager.js +104 -0
  167. package/src/managers/GuildApplicationCommandManager.js +28 -0
  168. package/src/managers/GuildBanManager.js +204 -0
  169. package/src/managers/GuildChannelManager.js +502 -0
  170. package/src/managers/GuildEmojiManager.js +171 -0
  171. package/src/managers/GuildEmojiRoleManager.js +118 -0
  172. package/src/managers/GuildFolderManager.js +24 -0
  173. package/src/managers/GuildForumThreadManager.js +114 -0
  174. package/src/managers/GuildInviteManager.js +213 -0
  175. package/src/managers/GuildManager.js +304 -0
  176. package/src/managers/GuildMemberManager.js +724 -0
  177. package/src/managers/GuildMemberRoleManager.js +191 -0
  178. package/src/managers/GuildScheduledEventManager.js +296 -0
  179. package/src/managers/GuildSettingManager.js +148 -0
  180. package/src/managers/GuildStickerManager.js +179 -0
  181. package/src/managers/GuildTextThreadManager.js +98 -0
  182. package/src/managers/InteractionManager.js +39 -0
  183. package/src/managers/MessageManager.js +393 -0
  184. package/src/managers/PermissionOverwriteManager.js +166 -0
  185. package/src/managers/PresenceManager.js +58 -0
  186. package/src/managers/ReactionManager.js +67 -0
  187. package/src/managers/ReactionUserManager.js +71 -0
  188. package/src/managers/RelationshipManager.js +258 -0
  189. package/src/managers/RoleManager.js +352 -0
  190. package/src/managers/SessionManager.js +57 -0
  191. package/src/managers/StageInstanceManager.js +162 -0
  192. package/src/managers/ThreadManager.js +207 -0
  193. package/src/managers/ThreadMemberManager.js +186 -0
  194. package/src/managers/UserManager.js +150 -0
  195. package/src/managers/VoiceStateManager.js +37 -0
  196. package/src/rest/APIRequest.js +136 -0
  197. package/src/rest/APIRouter.js +53 -0
  198. package/src/rest/CaptchaSolver.js +78 -0
  199. package/src/rest/DiscordAPIError.js +103 -0
  200. package/src/rest/HTTPError.js +62 -0
  201. package/src/rest/RESTManager.js +81 -0
  202. package/src/rest/RateLimitError.js +55 -0
  203. package/src/rest/RequestHandler.js +446 -0
  204. package/src/sharding/Shard.js +443 -0
  205. package/src/sharding/ShardClientUtil.js +275 -0
  206. package/src/sharding/ShardingManager.js +318 -0
  207. package/src/structures/AnonymousGuild.js +98 -0
  208. package/src/structures/ApplicationCommand.js +1028 -0
  209. package/src/structures/ApplicationRoleConnectionMetadata.js +45 -0
  210. package/src/structures/AutoModerationActionExecution.js +89 -0
  211. package/src/structures/AutoModerationRule.js +294 -0
  212. package/src/structures/AutocompleteInteraction.js +106 -0
  213. package/src/structures/Base.js +43 -0
  214. package/src/structures/BaseCommandInteraction.js +211 -0
  215. package/src/structures/BaseGuild.js +116 -0
  216. package/src/structures/BaseGuildEmoji.js +56 -0
  217. package/src/structures/BaseGuildTextChannel.js +193 -0
  218. package/src/structures/BaseGuildVoiceChannel.js +243 -0
  219. package/src/structures/BaseMessageComponent.js +114 -0
  220. package/src/structures/ButtonInteraction.js +11 -0
  221. package/src/structures/Call.js +58 -0
  222. package/src/structures/CategoryChannel.js +83 -0
  223. package/src/structures/Channel.js +271 -0
  224. package/src/structures/ClientApplication.js +204 -0
  225. package/src/structures/ClientPresence.js +84 -0
  226. package/src/structures/ClientUser.js +624 -0
  227. package/src/structures/CommandInteraction.js +41 -0
  228. package/src/structures/CommandInteractionOptionResolver.js +276 -0
  229. package/src/structures/ContextMenuInteraction.js +65 -0
  230. package/src/structures/DMChannel.js +280 -0
  231. package/src/structures/DeveloperPortalApplication.js +520 -0
  232. package/src/structures/DirectoryChannel.js +20 -0
  233. package/src/structures/Emoji.js +148 -0
  234. package/src/structures/ForumChannel.js +271 -0
  235. package/src/structures/Guild.js +1744 -0
  236. package/src/structures/GuildAuditLogs.js +734 -0
  237. package/src/structures/GuildBan.js +59 -0
  238. package/src/structures/GuildBoost.js +108 -0
  239. package/src/structures/GuildChannel.js +454 -0
  240. package/src/structures/GuildEmoji.js +161 -0
  241. package/src/structures/GuildFolder.js +75 -0
  242. package/src/structures/GuildMember.js +686 -0
  243. package/src/structures/GuildPreview.js +191 -0
  244. package/src/structures/GuildPreviewEmoji.js +27 -0
  245. package/src/structures/GuildScheduledEvent.js +441 -0
  246. package/src/structures/GuildTemplate.js +236 -0
  247. package/src/structures/Integration.js +188 -0
  248. package/src/structures/IntegrationApplication.js +96 -0
  249. package/src/structures/Interaction.js +351 -0
  250. package/src/structures/InteractionCollector.js +248 -0
  251. package/src/structures/InteractionResponse.js +114 -0
  252. package/src/structures/InteractionWebhook.js +43 -0
  253. package/src/structures/Invite.js +375 -0
  254. package/src/structures/InviteGuild.js +23 -0
  255. package/src/structures/InviteStageInstance.js +86 -0
  256. package/src/structures/Message.js +1188 -0
  257. package/src/structures/MessageActionRow.js +103 -0
  258. package/src/structures/MessageAttachment.js +193 -0
  259. package/src/structures/MessageButton.js +231 -0
  260. package/src/structures/MessageCollector.js +146 -0
  261. package/src/structures/MessageComponentInteraction.js +120 -0
  262. package/src/structures/MessageContextMenuInteraction.js +20 -0
  263. package/src/structures/MessageEmbed.js +586 -0
  264. package/src/structures/MessageMentions.js +272 -0
  265. package/src/structures/MessagePayload.js +358 -0
  266. package/src/structures/MessageReaction.js +171 -0
  267. package/src/structures/MessageSelectMenu.js +391 -0
  268. package/src/structures/Modal.js +279 -0
  269. package/src/structures/ModalSubmitFieldsResolver.js +53 -0
  270. package/src/structures/ModalSubmitInteraction.js +119 -0
  271. package/src/structures/NewsChannel.js +32 -0
  272. package/src/structures/OAuth2Guild.js +28 -0
  273. package/src/structures/PartialGroupDMChannel.js +430 -0
  274. package/src/structures/PermissionOverwrites.js +196 -0
  275. package/src/structures/Presence.js +441 -0
  276. package/src/structures/ReactionCollector.js +229 -0
  277. package/src/structures/ReactionEmoji.js +31 -0
  278. package/src/structures/RichPresence.js +722 -0
  279. package/src/structures/Role.js +515 -0
  280. package/src/structures/SelectMenuInteraction.js +170 -0
  281. package/src/structures/Session.js +81 -0
  282. package/src/structures/StageChannel.js +104 -0
  283. package/src/structures/StageInstance.js +208 -0
  284. package/src/structures/Sticker.js +310 -0
  285. package/src/structures/StickerPack.js +95 -0
  286. package/src/structures/StoreChannel.js +56 -0
  287. package/src/structures/Team.js +167 -0
  288. package/src/structures/TeamMember.js +71 -0
  289. package/src/structures/TextChannel.js +33 -0
  290. package/src/structures/TextInputComponent.js +201 -0
  291. package/src/structures/ThreadChannel.js +626 -0
  292. package/src/structures/ThreadMember.js +105 -0
  293. package/src/structures/Typing.js +74 -0
  294. package/src/structures/User.js +697 -0
  295. package/src/structures/UserContextMenuInteraction.js +29 -0
  296. package/src/structures/VoiceChannel.js +110 -0
  297. package/src/structures/VoiceRegion.js +53 -0
  298. package/src/structures/VoiceState.js +306 -0
  299. package/src/structures/WebEmbed.js +401 -0
  300. package/src/structures/Webhook.js +461 -0
  301. package/src/structures/WelcomeChannel.js +60 -0
  302. package/src/structures/WelcomeScreen.js +48 -0
  303. package/src/structures/Widget.js +87 -0
  304. package/src/structures/WidgetMember.js +99 -0
  305. package/src/structures/interfaces/Application.js +190 -0
  306. package/src/structures/interfaces/Collector.js +300 -0
  307. package/src/structures/interfaces/InteractionResponses.js +313 -0
  308. package/src/structures/interfaces/TextBasedChannel.js +566 -0
  309. package/src/util/ActivityFlags.js +44 -0
  310. package/src/util/ApplicationFlags.js +74 -0
  311. package/src/util/BitField.js +170 -0
  312. package/src/util/ChannelFlags.js +45 -0
  313. package/src/util/Constants.js +1917 -0
  314. package/src/util/DataResolver.js +145 -0
  315. package/src/util/Formatters.js +214 -0
  316. package/src/util/GuildMemberFlags.js +43 -0
  317. package/src/util/Intents.js +74 -0
  318. package/src/util/LimitedCollection.js +131 -0
  319. package/src/util/MessageFlags.js +54 -0
  320. package/src/util/Options.js +360 -0
  321. package/src/util/Permissions.js +187 -0
  322. package/src/util/PremiumUsageFlags.js +31 -0
  323. package/src/util/PurchasedFlags.js +31 -0
  324. package/src/util/RemoteAuth.js +522 -0
  325. package/src/util/SnowflakeUtil.js +92 -0
  326. package/src/util/Sweepers.js +466 -0
  327. package/src/util/SystemChannelFlags.js +55 -0
  328. package/src/util/ThreadMemberFlags.js +30 -0
  329. package/src/util/UserFlags.js +104 -0
  330. package/src/util/Util.js +741 -0
  331. package/src/util/Voice.js +1456 -0
  332. package/src/util/arRPC/index.js +229 -0
  333. package/src/util/arRPC/process/detectable.json +1 -0
  334. package/src/util/arRPC/process/index.js +102 -0
  335. package/src/util/arRPC/process/native/index.js +5 -0
  336. package/src/util/arRPC/process/native/linux.js +37 -0
  337. package/src/util/arRPC/process/native/win32.js +25 -0
  338. package/src/util/arRPC/transports/ipc.js +281 -0
  339. package/src/util/arRPC/transports/websocket.js +128 -0
  340. package/typings/enums.d.ts +346 -0
  341. package/typings/index.d.ts +7725 -0
  342. package/typings/index.test-d.ts +0 -0
  343. package/typings/rawDataTypes.d.ts +283 -0
@@ -0,0 +1,204 @@
1
+ 'use strict';
2
+
3
+ const process = require('node:process');
4
+ const { Collection } = require('@discordjs/collection');
5
+ const CachedManager = require('./CachedManager');
6
+ const { TypeError, Error } = require('../errors');
7
+ const GuildBan = require('../structures/GuildBan');
8
+ const { GuildMember } = require('../structures/GuildMember');
9
+
10
+ let deprecationEmittedForDays = false;
11
+
12
+ /**
13
+ * Manages API methods for GuildBans and stores their cache.
14
+ * @extends {CachedManager}
15
+ */
16
+ class GuildBanManager extends CachedManager {
17
+ constructor(guild, iterable) {
18
+ super(guild.client, GuildBan, iterable);
19
+
20
+ /**
21
+ * The guild this Manager belongs to
22
+ * @type {Guild}
23
+ */
24
+ this.guild = guild;
25
+ }
26
+
27
+ /**
28
+ * The cache of this Manager
29
+ * @type {Collection<Snowflake, GuildBan>}
30
+ * @name GuildBanManager#cache
31
+ */
32
+
33
+ _add(data, cache) {
34
+ return super._add(data, cache, { id: data.user.id, extras: [this.guild] });
35
+ }
36
+
37
+ /**
38
+ * Data that resolves to give a GuildBan object. This can be:
39
+ * * A GuildBan object
40
+ * * A User resolvable
41
+ * @typedef {GuildBan|UserResolvable} GuildBanResolvable
42
+ */
43
+
44
+ /**
45
+ * Resolves a GuildBanResolvable to a GuildBan object.
46
+ * @param {GuildBanResolvable} ban The ban that is in the guild
47
+ * @returns {?GuildBan}
48
+ */
49
+ resolve(ban) {
50
+ return super.resolve(ban) ?? super.resolve(this.client.users.resolveId(ban));
51
+ }
52
+
53
+ /**
54
+ * Options used to fetch a single ban from a guild.
55
+ * @typedef {BaseFetchOptions} FetchBanOptions
56
+ * @property {UserResolvable} user The ban to fetch
57
+ */
58
+
59
+ /**
60
+ * Options used to fetch multiple bans from a guild.
61
+ * @typedef {Object} FetchBansOptions
62
+ * @property {number} [limit] The maximum number of bans to return
63
+ * @property {Snowflake} [before] Consider only bans before this id
64
+ * @property {Snowflake} [after] Consider only bans after this id
65
+ * @property {boolean} [cache] Whether to cache the fetched bans
66
+ */
67
+
68
+ /**
69
+ * Fetches ban(s) from Discord.
70
+ * @param {UserResolvable|FetchBanOptions|FetchBansOptions} [options] Options for fetching guild ban(s)
71
+ * @returns {Promise<GuildBan|Collection<Snowflake, GuildBan>>}
72
+ * @example
73
+ * // Fetch multiple bans from a guild
74
+ * guild.bans.fetch()
75
+ * .then(console.log)
76
+ * .catch(console.error);
77
+ * @example
78
+ * // Fetch a maximum of 5 bans from a guild without caching
79
+ * guild.bans.fetch({ limit: 5, cache: false })
80
+ * .then(console.log)
81
+ * .catch(console.error);
82
+ * @example
83
+ * // Fetch a single ban
84
+ * guild.bans.fetch('351871113346809860')
85
+ * .then(console.log)
86
+ * .catch(console.error);
87
+ * @example
88
+ * // Fetch a single ban without checking cache
89
+ * guild.bans.fetch({ user, force: true })
90
+ * .then(console.log)
91
+ * .catch(console.error)
92
+ * @example
93
+ * // Fetch a single ban without caching
94
+ * guild.bans.fetch({ user, cache: false })
95
+ * .then(console.log)
96
+ * .catch(console.error);
97
+ */
98
+ fetch(options) {
99
+ if (!options) return this._fetchMany();
100
+ const { user, cache, force, limit, before, after } = options;
101
+ const resolvedUser = this.client.users.resolveId(user ?? options);
102
+ if (resolvedUser) return this._fetchSingle({ user: resolvedUser, cache, force });
103
+
104
+ if (!before && !after && !limit && typeof cache === 'undefined') {
105
+ return Promise.reject(new Error('FETCH_BAN_RESOLVE_ID'));
106
+ }
107
+
108
+ return this._fetchMany(options);
109
+ }
110
+
111
+ async _fetchSingle({ user, cache, force = false }) {
112
+ if (!force) {
113
+ const existing = this.cache.get(user);
114
+ if (existing && !existing.partial) return existing;
115
+ }
116
+
117
+ const data = await this.client.api.guilds(this.guild.id).bans(user).get();
118
+ return this._add(data, cache);
119
+ }
120
+
121
+ async _fetchMany(options = {}) {
122
+ const data = await this.client.api.guilds(this.guild.id).bans.get({
123
+ query: options,
124
+ });
125
+
126
+ return data.reduce((col, ban) => col.set(ban.user.id, this._add(ban, options.cache)), new Collection());
127
+ }
128
+ /**
129
+ * Options used to ban a user from a guild.
130
+ * @typedef {Object} BanOptions
131
+ * @property {number} [days=0] Number of days of messages to delete, must be between 0 and 7, inclusive
132
+ * <warn>This property is deprecated. Use `deleteMessageSeconds` instead.</warn>
133
+ * @property {number} [deleteMessageSeconds=0] Number of seconds of messages to delete,
134
+ * must be between 0 and 604800 (7 days), inclusive
135
+ * @property {string} [reason] The reason for the ban
136
+ */
137
+
138
+ /**
139
+ * Bans a user from the guild.
140
+ * @param {UserResolvable} user The user to ban
141
+ * @param {BanOptions} [options] Options for the ban
142
+ * @returns {Promise<GuildMember|User|Snowflake>} Result object will be resolved as specifically as possible.
143
+ * If the GuildMember cannot be resolved, the User will instead be attempted to be resolved. If that also cannot
144
+ * be resolved, the user id will be the result.
145
+ * @example
146
+ * // Ban a user by id (or with a user/guild member object)
147
+ * guild.bans.create('84484653687267328')
148
+ * .then(banInfo => console.log(`Banned ${banInfo.user?.tag ?? banInfo.tag ?? banInfo}`))
149
+ * .catch(console.error);
150
+ */
151
+ async create(user, options = {}) {
152
+ if (typeof options !== 'object') throw new TypeError('INVALID_TYPE', 'options', 'object', true);
153
+ const id = this.client.users.resolveId(user);
154
+ if (!id) throw new Error('BAN_RESOLVE_ID', true);
155
+
156
+ if (typeof options.days !== 'undefined' && !deprecationEmittedForDays) {
157
+ process.emitWarning(
158
+ 'The days option for GuildBanManager#create() is deprecated. Use the deleteMessageSeconds option instead.',
159
+ 'DeprecationWarning',
160
+ );
161
+
162
+ deprecationEmittedForDays = true;
163
+ }
164
+
165
+ await this.client.api
166
+ .guilds(this.guild.id)
167
+ .bans(id)
168
+ .put({
169
+ data: {
170
+ delete_message_seconds:
171
+ typeof options.deleteMessageSeconds !== 'undefined'
172
+ ? options.deleteMessageSeconds
173
+ : (options.days ?? 0) * 24 * 60 * 60,
174
+ },
175
+ reason: options.reason,
176
+ });
177
+ if (user instanceof GuildMember) return user;
178
+ const _user = this.client.users.resolve(id);
179
+ if (_user) {
180
+ return this.guild.members.resolve(_user) ?? _user;
181
+ }
182
+ return id;
183
+ }
184
+
185
+ /**
186
+ * Unbans a user from the guild.
187
+ * @param {UserResolvable} user The user to unban
188
+ * @param {string} [reason] Reason for unbanning user
189
+ * @returns {Promise<?User>}
190
+ * @example
191
+ * // Unban a user by id (or with a user/guild member object)
192
+ * guild.bans.remove('84484653687267328')
193
+ * .then(user => console.log(`Unbanned ${user.username} from ${guild.name}`))
194
+ * .catch(console.error);
195
+ */
196
+ async remove(user, reason) {
197
+ const id = this.client.users.resolveId(user);
198
+ if (!id) throw new Error('BAN_RESOLVE_ID');
199
+ await this.client.api.guilds(this.guild.id).bans(id).delete({ reason });
200
+ return this.client.users.resolve(user);
201
+ }
202
+ }
203
+
204
+ module.exports = GuildBanManager;
@@ -0,0 +1,502 @@
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
+ 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
+ },
195
+ reason,
196
+ });
197
+ return this.client.actions.ChannelCreate.handle(data).channel;
198
+ }
199
+
200
+ /**
201
+ * Creates a webhook for the channel.
202
+ * @param {GuildChannelResolvable} channel The channel to create the webhook for
203
+ * @param {string} name The name of the webhook
204
+ * @param {ChannelWebhookCreateOptions} [options] Options for creating the webhook
205
+ * @returns {Promise<Webhook>} Returns the created Webhook
206
+ * @example
207
+ * // Create a webhook for the current channel
208
+ * guild.channels.createWebhook('222197033908436994', 'Snek', {
209
+ * avatar: 'https://i.imgur.com/mI8XcpG.jpg',
210
+ * reason: 'Needed a cool new Webhook'
211
+ * })
212
+ * .then(console.log)
213
+ * .catch(console.error)
214
+ */
215
+ async createWebhook(channel, name, { avatar, reason } = {}) {
216
+ const id = this.resolveId(channel);
217
+ if (!id) throw new TypeError('INVALID_TYPE', 'channel', 'GuildChannelResolvable');
218
+ if (typeof avatar === 'string' && !avatar.startsWith('data:')) {
219
+ avatar = await DataResolver.resolveImage(avatar);
220
+ }
221
+ const data = await this.client.api.channels[id].webhooks.post({
222
+ data: {
223
+ name,
224
+ avatar,
225
+ },
226
+ reason,
227
+ });
228
+ return new Webhook(this.client, data);
229
+ }
230
+
231
+ /**
232
+ * Adds the target channel to a channel's followers.
233
+ * @param {NewsChannel|Snowflake} channel The channel to follow
234
+ * @param {TextChannelResolvable} targetChannel The channel where published announcements will be posted at
235
+ * @param {string} [reason] Reason for creating the webhook
236
+ * @returns {Promise<Snowflake>} Returns created target webhook id.
237
+ */
238
+ async addFollower(channel, targetChannel, reason) {
239
+ const channelId = this.resolveId(channel);
240
+ const targetChannelId = this.resolveId(targetChannel);
241
+ if (!channelId || !targetChannelId) throw new Error('GUILD_CHANNEL_RESOLVE');
242
+ const { webhook_id } = await this.client.api.channels[channelId].followers.post({
243
+ data: { webhook_channel_id: targetChannelId },
244
+ reason,
245
+ });
246
+ return webhook_id;
247
+ }
248
+
249
+ /**
250
+ * The data for a guild channel.
251
+ * @typedef {Object} ChannelData
252
+ * @property {string} [name] The name of the channel
253
+ * @property {ChannelType} [type] The type of the channel (only conversion between text and news is supported)
254
+ * @property {number} [position] The position of the channel
255
+ * @property {string} [topic] The topic of the text channel
256
+ * @property {boolean} [nsfw] Whether the channel is NSFW
257
+ * @property {number} [bitrate] The bitrate of the voice channel
258
+ * @property {number} [userLimit] The user limit of the voice channel
259
+ * @property {?CategoryChannelResolvable} [parent] The parent of the channel
260
+ * @property {boolean} [lockPermissions]
261
+ * Lock the permissions of the channel to what the parent's permissions are
262
+ * @property {OverwriteResolvable[]|Collection<Snowflake, OverwriteResolvable>} [permissionOverwrites]
263
+ * Permission overwrites for the channel
264
+ * @property {number} [rateLimitPerUser] The rate limit per user (slowmode) for the channel in seconds
265
+ * @property {ThreadAutoArchiveDuration} [defaultAutoArchiveDuration]
266
+ * The default auto archive duration for all new threads in this channel
267
+ * @property {?string} [rtcRegion] The RTC region of the channel
268
+ * @property {?VideoQualityMode|number} [videoQualityMode] The camera video quality mode of the channel
269
+ * @property {ChannelFlagsResolvable} [flags] The flags to set on the channel
270
+ * @property {GuildForumTagData[]} [availableTags] The tags to set as available in a forum channel
271
+ * @property {?DefaultReactionEmoji} [defaultReactionEmoji] The emoji to set as the default reaction emoji
272
+ * @property {number} [defaultThreadRateLimitPerUser] The rate limit per user (slowmode) to set on forum posts
273
+ * @property {?SortOrderType} [defaultSortOrder] The default sort order mode to set on the channel
274
+ */
275
+
276
+ /**
277
+ * Edits the channel.
278
+ * @param {GuildChannelResolvable} channel The channel to edit
279
+ * @param {ChannelData} data The new data for the channel
280
+ * @param {string} [reason] Reason for editing this channel
281
+ * @returns {Promise<GuildChannel>}
282
+ * @example
283
+ * // Edit a channel
284
+ * guild.channels.edit('222197033908436994', { name: 'new-channel' })
285
+ * .then(console.log)
286
+ * .catch(console.error);
287
+ */
288
+ async edit(channel, data, reason) {
289
+ channel = this.resolve(channel);
290
+ if (!channel) throw new TypeError('INVALID_TYPE', 'channel', 'GuildChannelResolvable');
291
+
292
+ const parent = data.parent && this.client.channels.resolveId(data.parent);
293
+
294
+ if (typeof data.position !== 'undefined') await this.setPosition(channel, data.position, { reason });
295
+
296
+ let permission_overwrites = data.permissionOverwrites?.map(o => PermissionOverwrites.resolve(o, this.guild));
297
+
298
+ if (data.lockPermissions) {
299
+ if (parent) {
300
+ const newParent = this.guild.channels.resolve(parent);
301
+ if (newParent?.type === 'GUILD_CATEGORY') {
302
+ permission_overwrites = newParent.permissionOverwrites.cache.map(o =>
303
+ PermissionOverwrites.resolve(o, this.guild),
304
+ );
305
+ }
306
+ } else if (channel.parent) {
307
+ permission_overwrites = channel.parent.permissionOverwrites.cache.map(o =>
308
+ PermissionOverwrites.resolve(o, this.guild),
309
+ );
310
+ }
311
+ }
312
+
313
+ let defaultAutoArchiveDuration = data.defaultAutoArchiveDuration;
314
+ if (defaultAutoArchiveDuration === 'MAX') defaultAutoArchiveDuration = resolveAutoArchiveMaxLimit(this.guild);
315
+
316
+ const newData = await this.client.api.channels(channel.id).patch({
317
+ data: {
318
+ name: (data.name ?? channel.name).trim(),
319
+ type: data.type,
320
+ topic: data.topic,
321
+ nsfw: data.nsfw,
322
+ bitrate: data.bitrate ?? channel.bitrate,
323
+ user_limit: data.userLimit ?? channel.userLimit,
324
+ rtc_region: 'rtcRegion' in data ? data.rtcRegion : channel.rtcRegion,
325
+ video_quality_mode:
326
+ typeof data.videoQualityMode === 'string' ? VideoQualityModes[data.videoQualityMode] : data.videoQualityMode,
327
+ parent_id: parent,
328
+ lock_permissions: data.lockPermissions,
329
+ rate_limit_per_user: data.rateLimitPerUser,
330
+ default_auto_archive_duration: defaultAutoArchiveDuration,
331
+ permission_overwrites,
332
+ available_tags: data.availableTags?.map(availableTag => transformGuildForumTag(availableTag)),
333
+ default_reaction_emoji: data.defaultReactionEmoji && transformGuildDefaultReaction(data.defaultReactionEmoji),
334
+ default_thread_rate_limit_per_user: data.defaultThreadRateLimitPerUser,
335
+ flags: 'flags' in data ? ChannelFlags.resolve(data.flags) : undefined,
336
+ default_sort_order:
337
+ typeof data.defaultSortOrder === 'string' ? SortOrderTypes[data.defaultSortOrder] : data.defaultSortOrder,
338
+ },
339
+ reason,
340
+ });
341
+
342
+ return this.client.actions.ChannelUpdate.handle(newData).updated;
343
+ }
344
+
345
+ /**
346
+ * Sets a new position for the guild channel.
347
+ * @param {GuildChannelResolvable} channel The channel to set the position for
348
+ * @param {number} position The new position for the guild channel
349
+ * @param {SetChannelPositionOptions} [options] Options for setting position
350
+ * @returns {Promise<GuildChannel>}
351
+ * @example
352
+ * // Set a new channel position
353
+ * guild.channels.setPosition('222078374472843266', 2)
354
+ * .then(newChannel => console.log(`Channel's new position is ${newChannel.position}`))
355
+ * .catch(console.error);
356
+ */
357
+ async setPosition(channel, position, { relative, reason } = {}) {
358
+ channel = this.resolve(channel);
359
+ if (!channel) throw new TypeError('INVALID_TYPE', 'channel', 'GuildChannelResolvable');
360
+ const updatedChannels = await Util.setPosition(
361
+ channel,
362
+ position,
363
+ relative,
364
+ this.guild._sortedChannels(channel),
365
+ this.client.api.guilds(this.guild.id).channels,
366
+ reason,
367
+ );
368
+
369
+ this.client.actions.GuildChannelsPositionUpdate.handle({
370
+ guild_id: this.guild.id,
371
+ channels: updatedChannels,
372
+ });
373
+ return channel;
374
+ }
375
+
376
+ /**
377
+ * Obtains one or more guild channels from Discord, or the channel cache if they're already available.
378
+ * @param {Snowflake} [id] The channel's id
379
+ * @param {BaseFetchOptions} [options] Additional options for this fetch
380
+ * @returns {Promise<?GuildChannel|ThreadChannel|Collection<Snowflake, ?GuildChannel>>}
381
+ * @example
382
+ * // Fetch all channels from the guild (excluding threads)
383
+ * message.guild.channels.fetch()
384
+ * .then(channels => console.log(`There are ${channels.size} channels.`))
385
+ * .catch(console.error);
386
+ * @example
387
+ * // Fetch a single channel
388
+ * message.guild.channels.fetch('222197033908436994')
389
+ * .then(channel => console.log(`The channel name is: ${channel.name}`))
390
+ * .catch(console.error);
391
+ */
392
+ async fetch(id, { cache = true, force = false } = {}) {
393
+ if (id && !force) {
394
+ const existing = this.cache.get(id);
395
+ if (existing) return existing;
396
+ }
397
+
398
+ if (id) {
399
+ const data = await this.client.api.channels(id).get();
400
+ // Since this is the guild manager, throw if on a different guild
401
+ if (this.guild.id !== data.guild_id) throw new Error('GUILD_CHANNEL_UNOWNED');
402
+ return this.client.channels._add(data, this.guild, { cache });
403
+ }
404
+
405
+ const data = await this.client.api.guilds(this.guild.id).channels.get();
406
+ const channels = new Collection();
407
+ for (const channel of data) channels.set(channel.id, this.client.channels._add(channel, this.guild, { cache }));
408
+ return channels;
409
+ }
410
+
411
+ /**
412
+ * Fetches all webhooks for the channel.
413
+ * @param {GuildChannelResolvable} channel The channel to fetch webhooks for
414
+ * @returns {Promise<Collection<Snowflake, Webhook>>}
415
+ * @example
416
+ * // Fetch webhooks
417
+ * guild.channels.fetchWebhooks('769862166131245066')
418
+ * .then(hooks => console.log(`This channel has ${hooks.size} hooks`))
419
+ * .catch(console.error);
420
+ */
421
+ async fetchWebhooks(channel) {
422
+ const id = this.resolveId(channel);
423
+ if (!id) throw new TypeError('INVALID_TYPE', 'channel', 'GuildChannelResolvable');
424
+ const data = await this.client.api.channels[id].webhooks.get();
425
+ return data.reduce((hooks, hook) => hooks.set(hook.id, new Webhook(this.client, hook)), new Collection());
426
+ }
427
+
428
+ /**
429
+ * Data that can be resolved to give a Category Channel object. This can be:
430
+ * * A CategoryChannel object
431
+ * * A Snowflake
432
+ * @typedef {CategoryChannel|Snowflake} CategoryChannelResolvable
433
+ */
434
+
435
+ /**
436
+ * The data needed for updating a channel's position.
437
+ * @typedef {Object} ChannelPosition
438
+ * @property {GuildChannel|Snowflake} channel Channel to update
439
+ * @property {number} [position] New position for the channel
440
+ * @property {CategoryChannelResolvable} [parent] Parent channel for this channel
441
+ * @property {boolean} [lockPermissions] If the overwrites should be locked to the parents overwrites
442
+ */
443
+
444
+ /**
445
+ * Batch-updates the guild's channels' positions.
446
+ * <info>Only one channel's parent can be changed at a time</info>
447
+ * @param {ChannelPosition[]} channelPositions Channel positions to update
448
+ * @returns {Promise<Guild>}
449
+ * @example
450
+ * guild.channels.setPositions([{ channel: channelId, position: newChannelIndex }])
451
+ * .then(guild => console.log(`Updated channel positions for ${guild}`))
452
+ * .catch(console.error);
453
+ */
454
+ async setPositions(channelPositions) {
455
+ channelPositions = channelPositions.map(r => ({
456
+ id: this.client.channels.resolveId(r.channel),
457
+ position: r.position,
458
+ lock_permissions: r.lockPermissions,
459
+ parent_id: typeof r.parent !== 'undefined' ? this.resolveId(r.parent) : undefined,
460
+ }));
461
+
462
+ await this.client.api.guilds(this.guild.id).channels.patch({ data: channelPositions });
463
+ return this.client.actions.GuildChannelsPositionUpdate.handle({
464
+ guild_id: this.guild.id,
465
+ channels: channelPositions,
466
+ }).guild;
467
+ }
468
+
469
+ /**
470
+ * Obtains all active thread channels in the guild from Discord
471
+ * @param {boolean} [cache=true] Whether to cache the fetched data
472
+ * @returns {Promise<FetchedThreads>}
473
+ * @example
474
+ * // Fetch all threads from the guild
475
+ * message.guild.channels.fetchActiveThreads()
476
+ * .then(fetched => console.log(`There are ${fetched.threads.size} threads.`))
477
+ * .catch(console.error);
478
+ */
479
+ async fetchActiveThreads(cache = true) {
480
+ const raw = await this.client.api.guilds(this.guild.id).threads.active.get();
481
+ return ThreadManager._mapThreads(raw, this.client, { guild: this.guild, cache });
482
+ }
483
+
484
+ /**
485
+ * Deletes the channel.
486
+ * @param {GuildChannelResolvable} channel The channel to delete
487
+ * @param {string} [reason] Reason for deleting this channel
488
+ * @returns {Promise<void>}
489
+ * @example
490
+ * // Delete the channel
491
+ * guild.channels.delete('858850993013260338', 'making room for new channels')
492
+ * .then(console.log)
493
+ * .catch(console.error);
494
+ */
495
+ async delete(channel, reason) {
496
+ const id = this.resolveId(channel);
497
+ if (!id) throw new TypeError('INVALID_TYPE', 'channel', 'GuildChannelResolvable');
498
+ await this.client.api.channels(id).delete({ reason });
499
+ }
500
+ }
501
+
502
+ module.exports = GuildChannelManager;