discord.jselfbot-v13 0.0.1-security → 2.17.2

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Potentially problematic release.


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

Files changed (343) hide show
  1. package/LICENSE +674 -0
  2. package/README.md +127 -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/managers/ApplicationCommandManager.js +267 -0
  156. package/src/managers/ApplicationCommandPermissionsManager.js +425 -0
  157. package/src/managers/AutoModerationRuleManager.js +296 -0
  158. package/src/managers/BaseGuildEmojiManager.js +80 -0
  159. package/src/managers/BaseManager.js +19 -0
  160. package/src/managers/BillingManager.js +66 -0
  161. package/src/managers/CachedManager.js +71 -0
  162. package/src/managers/ChannelManager.js +139 -0
  163. package/src/managers/ClientUserSettingManager.js +490 -0
  164. package/src/managers/DataManager.js +61 -0
  165. package/src/managers/DeveloperPortalManager.js +104 -0
  166. package/src/managers/GuildApplicationCommandManager.js +28 -0
  167. package/src/managers/GuildBanManager.js +204 -0
  168. package/src/managers/GuildChannelManager.js +502 -0
  169. package/src/managers/GuildEmojiManager.js +171 -0
  170. package/src/managers/GuildEmojiRoleManager.js +118 -0
  171. package/src/managers/GuildFolderManager.js +24 -0
  172. package/src/managers/GuildForumThreadManager.js +114 -0
  173. package/src/managers/GuildInviteManager.js +213 -0
  174. package/src/managers/GuildManager.js +304 -0
  175. package/src/managers/GuildMemberManager.js +724 -0
  176. package/src/managers/GuildMemberRoleManager.js +191 -0
  177. package/src/managers/GuildScheduledEventManager.js +296 -0
  178. package/src/managers/GuildSettingManager.js +148 -0
  179. package/src/managers/GuildStickerManager.js +179 -0
  180. package/src/managers/GuildTextThreadManager.js +98 -0
  181. package/src/managers/InteractionManager.js +39 -0
  182. package/src/managers/MessageManager.js +393 -0
  183. package/src/managers/PermissionOverwriteManager.js +166 -0
  184. package/src/managers/PresenceManager.js +58 -0
  185. package/src/managers/ReactionManager.js +67 -0
  186. package/src/managers/ReactionUserManager.js +71 -0
  187. package/src/managers/RelationshipManager.js +258 -0
  188. package/src/managers/RoleManager.js +352 -0
  189. package/src/managers/SessionManager.js +57 -0
  190. package/src/managers/StageInstanceManager.js +162 -0
  191. package/src/managers/ThreadManager.js +207 -0
  192. package/src/managers/ThreadMemberManager.js +186 -0
  193. package/src/managers/UserManager.js +150 -0
  194. package/src/managers/VoiceStateManager.js +37 -0
  195. package/src/rest/APIRequest.js +136 -0
  196. package/src/rest/APIRouter.js +53 -0
  197. package/src/rest/CaptchaSolver.js +78 -0
  198. package/src/rest/DiscordAPIError.js +103 -0
  199. package/src/rest/HTTPError.js +62 -0
  200. package/src/rest/RESTManager.js +81 -0
  201. package/src/rest/RateLimitError.js +55 -0
  202. package/src/rest/RequestHandler.js +446 -0
  203. package/src/sharding/Shard.js +443 -0
  204. package/src/sharding/ShardClientUtil.js +275 -0
  205. package/src/sharding/ShardingManager.js +318 -0
  206. package/src/structures/AnonymousGuild.js +98 -0
  207. package/src/structures/ApplicationCommand.js +1028 -0
  208. package/src/structures/ApplicationRoleConnectionMetadata.js +45 -0
  209. package/src/structures/AutoModerationActionExecution.js +89 -0
  210. package/src/structures/AutoModerationRule.js +294 -0
  211. package/src/structures/AutocompleteInteraction.js +106 -0
  212. package/src/structures/Base.js +43 -0
  213. package/src/structures/BaseCommandInteraction.js +211 -0
  214. package/src/structures/BaseGuild.js +116 -0
  215. package/src/structures/BaseGuildEmoji.js +56 -0
  216. package/src/structures/BaseGuildTextChannel.js +193 -0
  217. package/src/structures/BaseGuildVoiceChannel.js +243 -0
  218. package/src/structures/BaseMessageComponent.js +114 -0
  219. package/src/structures/ButtonInteraction.js +11 -0
  220. package/src/structures/Call.js +58 -0
  221. package/src/structures/CategoryChannel.js +83 -0
  222. package/src/structures/Channel.js +271 -0
  223. package/src/structures/ClientApplication.js +204 -0
  224. package/src/structures/ClientPresence.js +84 -0
  225. package/src/structures/ClientUser.js +624 -0
  226. package/src/structures/CommandInteraction.js +41 -0
  227. package/src/structures/CommandInteractionOptionResolver.js +276 -0
  228. package/src/structures/ContextMenuInteraction.js +65 -0
  229. package/src/structures/DMChannel.js +280 -0
  230. package/src/structures/DeveloperPortalApplication.js +520 -0
  231. package/src/structures/DirectoryChannel.js +20 -0
  232. package/src/structures/Emoji.js +148 -0
  233. package/src/structures/ForumChannel.js +271 -0
  234. package/src/structures/Guild.js +1744 -0
  235. package/src/structures/GuildAuditLogs.js +734 -0
  236. package/src/structures/GuildBan.js +59 -0
  237. package/src/structures/GuildBoost.js +108 -0
  238. package/src/structures/GuildChannel.js +454 -0
  239. package/src/structures/GuildEmoji.js +161 -0
  240. package/src/structures/GuildFolder.js +75 -0
  241. package/src/structures/GuildMember.js +686 -0
  242. package/src/structures/GuildPreview.js +191 -0
  243. package/src/structures/GuildPreviewEmoji.js +27 -0
  244. package/src/structures/GuildScheduledEvent.js +441 -0
  245. package/src/structures/GuildTemplate.js +236 -0
  246. package/src/structures/Integration.js +188 -0
  247. package/src/structures/IntegrationApplication.js +96 -0
  248. package/src/structures/Interaction.js +351 -0
  249. package/src/structures/InteractionCollector.js +248 -0
  250. package/src/structures/InteractionResponse.js +114 -0
  251. package/src/structures/InteractionWebhook.js +43 -0
  252. package/src/structures/Invite.js +375 -0
  253. package/src/structures/InviteGuild.js +23 -0
  254. package/src/structures/InviteStageInstance.js +86 -0
  255. package/src/structures/Message.js +1188 -0
  256. package/src/structures/MessageActionRow.js +103 -0
  257. package/src/structures/MessageAttachment.js +193 -0
  258. package/src/structures/MessageButton.js +231 -0
  259. package/src/structures/MessageCollector.js +146 -0
  260. package/src/structures/MessageComponentInteraction.js +120 -0
  261. package/src/structures/MessageContextMenuInteraction.js +20 -0
  262. package/src/structures/MessageEmbed.js +586 -0
  263. package/src/structures/MessageMentions.js +272 -0
  264. package/src/structures/MessagePayload.js +358 -0
  265. package/src/structures/MessageReaction.js +171 -0
  266. package/src/structures/MessageSelectMenu.js +391 -0
  267. package/src/structures/Modal.js +279 -0
  268. package/src/structures/ModalSubmitFieldsResolver.js +53 -0
  269. package/src/structures/ModalSubmitInteraction.js +119 -0
  270. package/src/structures/NewsChannel.js +32 -0
  271. package/src/structures/OAuth2Guild.js +28 -0
  272. package/src/structures/PartialGroupDMChannel.js +430 -0
  273. package/src/structures/PermissionOverwrites.js +196 -0
  274. package/src/structures/Presence.js +441 -0
  275. package/src/structures/ReactionCollector.js +229 -0
  276. package/src/structures/ReactionEmoji.js +31 -0
  277. package/src/structures/RichPresence.js +722 -0
  278. package/src/structures/Role.js +515 -0
  279. package/src/structures/SelectMenuInteraction.js +170 -0
  280. package/src/structures/Session.js +81 -0
  281. package/src/structures/StageChannel.js +104 -0
  282. package/src/structures/StageInstance.js +208 -0
  283. package/src/structures/Sticker.js +310 -0
  284. package/src/structures/StickerPack.js +95 -0
  285. package/src/structures/StoreChannel.js +56 -0
  286. package/src/structures/Team.js +167 -0
  287. package/src/structures/TeamMember.js +71 -0
  288. package/src/structures/TextChannel.js +33 -0
  289. package/src/structures/TextInputComponent.js +201 -0
  290. package/src/structures/ThreadChannel.js +626 -0
  291. package/src/structures/ThreadMember.js +105 -0
  292. package/src/structures/Typing.js +74 -0
  293. package/src/structures/User.js +697 -0
  294. package/src/structures/UserContextMenuInteraction.js +29 -0
  295. package/src/structures/VoiceChannel.js +110 -0
  296. package/src/structures/VoiceRegion.js +53 -0
  297. package/src/structures/VoiceState.js +306 -0
  298. package/src/structures/WebEmbed.js +401 -0
  299. package/src/structures/Webhook.js +461 -0
  300. package/src/structures/WelcomeChannel.js +60 -0
  301. package/src/structures/WelcomeScreen.js +48 -0
  302. package/src/structures/Widget.js +87 -0
  303. package/src/structures/WidgetMember.js +99 -0
  304. package/src/structures/interfaces/Application.js +190 -0
  305. package/src/structures/interfaces/Collector.js +300 -0
  306. package/src/structures/interfaces/InteractionResponses.js +313 -0
  307. package/src/structures/interfaces/TextBasedChannel.js +566 -0
  308. package/src/util/ActivityFlags.js +44 -0
  309. package/src/util/ApplicationFlags.js +74 -0
  310. package/src/util/BitField.js +170 -0
  311. package/src/util/ChannelFlags.js +45 -0
  312. package/src/util/Constants.js +1917 -0
  313. package/src/util/DataResolver.js +145 -0
  314. package/src/util/Formatters.js +214 -0
  315. package/src/util/GuildMemberFlags.js +43 -0
  316. package/src/util/Intents.js +74 -0
  317. package/src/util/LimitedCollection.js +131 -0
  318. package/src/util/MessageFlags.js +54 -0
  319. package/src/util/Options.js +360 -0
  320. package/src/util/Permissions.js +187 -0
  321. package/src/util/PremiumUsageFlags.js +31 -0
  322. package/src/util/PurchasedFlags.js +31 -0
  323. package/src/util/RemoteAuth.js +522 -0
  324. package/src/util/SnowflakeUtil.js +92 -0
  325. package/src/util/Sweepers.js +466 -0
  326. package/src/util/Symbols.js +48 -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;