djs-selfbot-v13 3.2.2 → 3.7.1

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (363) hide show
  1. package/README.md +37 -36
  2. package/package.json +89 -85
  3. package/src/WebSocket.js +39 -39
  4. package/src/client/BaseClient.js +86 -86
  5. package/src/client/Client.js +934 -836
  6. package/src/client/WebhookClient.js +61 -61
  7. package/src/client/actions/Action.js +116 -120
  8. package/src/client/actions/ActionsManager.js +80 -78
  9. package/src/client/actions/ApplicationCommandPermissionsUpdate.js +34 -34
  10. package/src/client/actions/AutoModerationActionExecution.js +27 -27
  11. package/src/client/actions/AutoModerationRuleCreate.js +28 -28
  12. package/src/client/actions/AutoModerationRuleDelete.js +32 -32
  13. package/src/client/actions/AutoModerationRuleUpdate.js +30 -30
  14. package/src/client/actions/ChannelCreate.js +23 -23
  15. package/src/client/actions/ChannelDelete.js +39 -39
  16. package/src/client/actions/ChannelUpdate.js +43 -43
  17. package/src/client/actions/GuildAuditLogEntryCreate.js +29 -29
  18. package/src/client/actions/GuildBanAdd.js +20 -20
  19. package/src/client/actions/GuildBanRemove.js +25 -25
  20. package/src/client/actions/GuildChannelsPositionUpdate.js +21 -21
  21. package/src/client/actions/GuildDelete.js +65 -65
  22. package/src/client/actions/GuildEmojiCreate.js +20 -20
  23. package/src/client/actions/GuildEmojiDelete.js +21 -21
  24. package/src/client/actions/GuildEmojiUpdate.js +20 -20
  25. package/src/client/actions/GuildEmojisUpdate.js +34 -34
  26. package/src/client/actions/GuildIntegrationsUpdate.js +19 -19
  27. package/src/client/actions/GuildMemberRemove.js +33 -32
  28. package/src/client/actions/GuildMemberUpdate.js +44 -43
  29. package/src/client/actions/GuildRoleCreate.js +25 -25
  30. package/src/client/actions/GuildRoleDelete.js +31 -31
  31. package/src/client/actions/GuildRoleUpdate.js +39 -39
  32. package/src/client/actions/GuildRolesPositionUpdate.js +21 -21
  33. package/src/client/actions/GuildScheduledEventCreate.js +27 -27
  34. package/src/client/actions/GuildScheduledEventDelete.js +31 -31
  35. package/src/client/actions/GuildScheduledEventUpdate.js +30 -30
  36. package/src/client/actions/GuildScheduledEventUserAdd.js +32 -32
  37. package/src/client/actions/GuildScheduledEventUserRemove.js +32 -32
  38. package/src/client/actions/GuildStickerCreate.js +20 -20
  39. package/src/client/actions/GuildStickerDelete.js +21 -21
  40. package/src/client/actions/GuildStickerUpdate.js +20 -20
  41. package/src/client/actions/GuildStickersUpdate.js +34 -34
  42. package/src/client/actions/GuildUpdate.js +33 -33
  43. package/src/client/actions/InviteCreate.js +28 -28
  44. package/src/client/actions/InviteDelete.js +30 -30
  45. package/src/client/actions/MessageCreate.js +50 -46
  46. package/src/client/actions/MessageDelete.js +32 -32
  47. package/src/client/actions/MessageDeleteBulk.js +46 -46
  48. package/src/client/actions/MessagePollVoteAdd.js +33 -0
  49. package/src/client/actions/MessagePollVoteRemove.js +33 -0
  50. package/src/client/actions/MessageReactionAdd.js +68 -56
  51. package/src/client/actions/MessageReactionRemove.js +50 -45
  52. package/src/client/actions/MessageReactionRemoveAll.js +33 -33
  53. package/src/client/actions/MessageReactionRemoveEmoji.js +28 -28
  54. package/src/client/actions/MessageUpdate.js +26 -26
  55. package/src/client/actions/PresenceUpdate.js +50 -46
  56. package/src/client/actions/StageInstanceCreate.js +28 -28
  57. package/src/client/actions/StageInstanceDelete.js +33 -33
  58. package/src/client/actions/StageInstanceUpdate.js +30 -30
  59. package/src/client/actions/ThreadCreate.js +24 -24
  60. package/src/client/actions/ThreadDelete.js +32 -32
  61. package/src/client/actions/ThreadListSync.js +59 -59
  62. package/src/client/actions/ThreadMemberUpdate.js +30 -30
  63. package/src/client/actions/ThreadMembersUpdate.js +34 -34
  64. package/src/client/actions/TypingStart.js +29 -29
  65. package/src/client/actions/UserUpdate.js +35 -35
  66. package/src/client/actions/VoiceStateUpdate.js +50 -57
  67. package/src/client/actions/WebhooksUpdate.js +20 -20
  68. package/src/client/voice/ClientVoiceManager.js +151 -51
  69. package/src/client/voice/VoiceConnection.js +1249 -0
  70. package/src/client/voice/dispatcher/AnnexBDispatcher.js +120 -0
  71. package/src/client/voice/dispatcher/AudioDispatcher.js +145 -0
  72. package/src/client/voice/dispatcher/BaseDispatcher.js +459 -0
  73. package/src/client/voice/dispatcher/VPxDispatcher.js +54 -0
  74. package/src/client/voice/dispatcher/VideoDispatcher.js +68 -0
  75. package/src/client/voice/networking/VoiceUDPClient.js +173 -0
  76. package/src/client/voice/networking/VoiceWebSocket.js +286 -0
  77. package/src/client/voice/player/MediaPlayer.js +321 -0
  78. package/src/client/voice/player/processing/AnnexBNalSplitter.js +244 -0
  79. package/src/client/voice/player/processing/IvfSplitter.js +106 -0
  80. package/src/client/voice/player/processing/PCMInsertSilence.js +37 -0
  81. package/src/client/voice/receiver/PacketHandler.js +260 -0
  82. package/src/client/voice/receiver/Receiver.js +96 -0
  83. package/src/client/voice/receiver/Recorder.js +173 -0
  84. package/src/client/voice/util/Function.js +116 -0
  85. package/src/client/voice/util/PlayInterface.js +122 -0
  86. package/src/client/voice/util/Secretbox.js +64 -0
  87. package/src/client/voice/util/Silence.js +16 -0
  88. package/src/client/voice/util/Socket.js +62 -0
  89. package/src/client/voice/util/VolumeInterface.js +104 -0
  90. package/src/client/websocket/WebSocketManager.js +392 -392
  91. package/src/client/websocket/WebSocketShard.js +907 -906
  92. package/src/client/websocket/handlers/APPLICATION_COMMAND_CREATE.js +18 -18
  93. package/src/client/websocket/handlers/APPLICATION_COMMAND_DELETE.js +20 -20
  94. package/src/client/websocket/handlers/APPLICATION_COMMAND_PERMISSIONS_UPDATE.js +5 -5
  95. package/src/client/websocket/handlers/APPLICATION_COMMAND_UPDATE.js +20 -20
  96. package/src/client/websocket/handlers/AUTO_MODERATION_ACTION_EXECUTION.js +5 -5
  97. package/src/client/websocket/handlers/AUTO_MODERATION_RULE_CREATE.js +5 -5
  98. package/src/client/websocket/handlers/AUTO_MODERATION_RULE_DELETE.js +5 -5
  99. package/src/client/websocket/handlers/AUTO_MODERATION_RULE_UPDATE.js +5 -5
  100. package/src/client/websocket/handlers/CALL_CREATE.js +14 -14
  101. package/src/client/websocket/handlers/CALL_DELETE.js +11 -11
  102. package/src/client/websocket/handlers/CALL_UPDATE.js +11 -11
  103. package/src/client/websocket/handlers/CHANNEL_CREATE.js +5 -5
  104. package/src/client/websocket/handlers/CHANNEL_DELETE.js +5 -5
  105. package/src/client/websocket/handlers/CHANNEL_PINS_UPDATE.js +22 -22
  106. package/src/client/websocket/handlers/CHANNEL_RECIPIENT_ADD.js +19 -19
  107. package/src/client/websocket/handlers/CHANNEL_RECIPIENT_REMOVE.js +16 -16
  108. package/src/client/websocket/handlers/CHANNEL_UPDATE.js +16 -16
  109. package/src/client/websocket/handlers/GUILD_AUDIT_LOG_ENTRY_CREATE.js +5 -5
  110. package/src/client/websocket/handlers/GUILD_BAN_ADD.js +5 -5
  111. package/src/client/websocket/handlers/GUILD_BAN_REMOVE.js +5 -5
  112. package/src/client/websocket/handlers/GUILD_CREATE.js +52 -52
  113. package/src/client/websocket/handlers/GUILD_DELETE.js +5 -5
  114. package/src/client/websocket/handlers/GUILD_EMOJIS_UPDATE.js +5 -5
  115. package/src/client/websocket/handlers/GUILD_INTEGRATIONS_UPDATE.js +5 -5
  116. package/src/client/websocket/handlers/GUILD_MEMBERS_CHUNK.js +39 -39
  117. package/src/client/websocket/handlers/GUILD_MEMBER_ADD.js +20 -19
  118. package/src/client/websocket/handlers/GUILD_MEMBER_REMOVE.js +5 -5
  119. package/src/client/websocket/handlers/GUILD_MEMBER_UPDATE.js +5 -5
  120. package/src/client/websocket/handlers/GUILD_ROLE_CREATE.js +5 -5
  121. package/src/client/websocket/handlers/GUILD_ROLE_DELETE.js +5 -5
  122. package/src/client/websocket/handlers/GUILD_ROLE_UPDATE.js +5 -5
  123. package/src/client/websocket/handlers/GUILD_SCHEDULED_EVENT_CREATE.js +5 -5
  124. package/src/client/websocket/handlers/GUILD_SCHEDULED_EVENT_DELETE.js +5 -5
  125. package/src/client/websocket/handlers/GUILD_SCHEDULED_EVENT_UPDATE.js +5 -5
  126. package/src/client/websocket/handlers/GUILD_SCHEDULED_EVENT_USER_ADD.js +5 -5
  127. package/src/client/websocket/handlers/GUILD_SCHEDULED_EVENT_USER_REMOVE.js +5 -5
  128. package/src/client/websocket/handlers/GUILD_STICKERS_UPDATE.js +5 -5
  129. package/src/client/websocket/handlers/GUILD_UPDATE.js +5 -5
  130. package/src/client/websocket/handlers/INTERACTION_MODAL_CREATE.js +12 -12
  131. package/src/client/websocket/handlers/INVITE_CREATE.js +5 -5
  132. package/src/client/websocket/handlers/INVITE_DELETE.js +5 -5
  133. package/src/client/websocket/handlers/MESSAGE_CREATE.js +5 -5
  134. package/src/client/websocket/handlers/MESSAGE_DELETE.js +5 -5
  135. package/src/client/websocket/handlers/MESSAGE_DELETE_BULK.js +5 -5
  136. package/src/client/websocket/handlers/MESSAGE_POLL_VOTE_ADD.js +5 -22
  137. package/src/client/websocket/handlers/MESSAGE_POLL_VOTE_REMOVE.js +5 -12
  138. package/src/client/websocket/handlers/MESSAGE_REACTION_ADD.js +5 -5
  139. package/src/client/websocket/handlers/MESSAGE_REACTION_REMOVE.js +5 -5
  140. package/src/client/websocket/handlers/MESSAGE_REACTION_REMOVE_ALL.js +5 -5
  141. package/src/client/websocket/handlers/MESSAGE_REACTION_REMOVE_EMOJI.js +5 -5
  142. package/src/client/websocket/handlers/MESSAGE_UPDATE.js +16 -16
  143. package/src/client/websocket/handlers/PRESENCE_UPDATE.js +5 -5
  144. package/src/client/websocket/handlers/READY.js +121 -120
  145. package/src/client/websocket/handlers/RELATIONSHIP_ADD.js +19 -19
  146. package/src/client/websocket/handlers/RELATIONSHIP_REMOVE.js +17 -17
  147. package/src/client/websocket/handlers/RELATIONSHIP_UPDATE.js +41 -41
  148. package/src/client/websocket/handlers/RESUMED.js +14 -14
  149. package/src/client/websocket/handlers/STAGE_INSTANCE_CREATE.js +5 -5
  150. package/src/client/websocket/handlers/STAGE_INSTANCE_DELETE.js +5 -5
  151. package/src/client/websocket/handlers/STAGE_INSTANCE_UPDATE.js +5 -5
  152. package/src/client/websocket/handlers/THREAD_CREATE.js +5 -5
  153. package/src/client/websocket/handlers/THREAD_DELETE.js +5 -5
  154. package/src/client/websocket/handlers/THREAD_LIST_SYNC.js +5 -5
  155. package/src/client/websocket/handlers/THREAD_MEMBERS_UPDATE.js +5 -5
  156. package/src/client/websocket/handlers/THREAD_MEMBER_UPDATE.js +5 -5
  157. package/src/client/websocket/handlers/THREAD_UPDATE.js +16 -16
  158. package/src/client/websocket/handlers/TYPING_START.js +5 -5
  159. package/src/client/websocket/handlers/USER_GUILD_SETTINGS_UPDATE.js +6 -6
  160. package/src/client/websocket/handlers/USER_NOTE_UPDATE.js +5 -5
  161. package/src/client/websocket/handlers/USER_REQUIRED_ACTION_UPDATE.js +78 -78
  162. package/src/client/websocket/handlers/USER_SETTINGS_UPDATE.js +5 -5
  163. package/src/client/websocket/handlers/USER_UPDATE.js +5 -5
  164. package/src/client/websocket/handlers/VOICE_CHANNEL_EFFECT_SEND.js +16 -0
  165. package/src/client/websocket/handlers/VOICE_CHANNEL_STATUS_UPDATE.js +12 -12
  166. package/src/client/websocket/handlers/VOICE_SERVER_UPDATE.js +6 -6
  167. package/src/client/websocket/handlers/VOICE_STATE_UPDATE.js +5 -5
  168. package/src/client/websocket/handlers/WEBHOOKS_UPDATE.js +5 -5
  169. package/src/client/websocket/handlers/index.js +84 -83
  170. package/src/errors/DJSError.js +61 -61
  171. package/src/errors/Messages.js +217 -183
  172. package/src/errors/index.js +4 -4
  173. package/src/index.js +172 -159
  174. package/src/managers/ApplicationCommandManager.js +264 -264
  175. package/src/managers/ApplicationCommandPermissionsManager.js +417 -417
  176. package/src/managers/AutoModerationRuleManager.js +296 -296
  177. package/src/managers/BaseGuildEmojiManager.js +80 -80
  178. package/src/managers/BaseManager.js +19 -19
  179. package/src/managers/BillingManager.js +66 -66
  180. package/src/managers/CachedManager.js +71 -71
  181. package/src/managers/ChannelManager.js +148 -138
  182. package/src/managers/ClientUserSettingManager.js +372 -372
  183. package/src/managers/DataManager.js +61 -61
  184. package/src/managers/GuildBanManager.js +250 -250
  185. package/src/managers/GuildChannelManager.js +488 -488
  186. package/src/managers/GuildEmojiManager.js +171 -171
  187. package/src/managers/GuildEmojiRoleManager.js +118 -118
  188. package/src/managers/GuildForumThreadManager.js +108 -108
  189. package/src/managers/GuildInviteManager.js +213 -213
  190. package/src/managers/GuildManager.js +338 -304
  191. package/src/managers/GuildMemberManager.js +599 -597
  192. package/src/managers/GuildMemberRoleManager.js +195 -191
  193. package/src/managers/GuildScheduledEventManager.js +314 -296
  194. package/src/managers/GuildSettingManager.js +155 -155
  195. package/src/managers/GuildStickerManager.js +179 -179
  196. package/src/managers/GuildTextThreadManager.js +98 -98
  197. package/src/managers/InteractionManager.js +39 -39
  198. package/src/managers/MessageManager.js +423 -391
  199. package/src/managers/PermissionOverwriteManager.js +164 -166
  200. package/src/managers/PresenceManager.js +71 -58
  201. package/src/managers/ReactionManager.js +67 -67
  202. package/src/managers/ReactionUserManager.js +73 -71
  203. package/src/managers/RelationshipManager.js +278 -265
  204. package/src/managers/RoleManager.js +448 -352
  205. package/src/managers/SessionManager.js +66 -0
  206. package/src/managers/StageInstanceManager.js +162 -162
  207. package/src/managers/ThreadManager.js +175 -174
  208. package/src/managers/ThreadMemberManager.js +186 -186
  209. package/src/managers/UserManager.js +136 -146
  210. package/src/managers/UserNoteManager.js +53 -53
  211. package/src/managers/VoiceStateManager.js +59 -37
  212. package/src/rest/APIRequest.js +154 -160
  213. package/src/rest/APIRouter.js +53 -53
  214. package/src/rest/DiscordAPIError.js +119 -104
  215. package/src/rest/HTTPError.js +62 -62
  216. package/src/rest/RESTManager.js +67 -62
  217. package/src/rest/RateLimitError.js +55 -55
  218. package/src/rest/RequestHandler.js +466 -444
  219. package/src/sharding/Shard.js +444 -443
  220. package/src/sharding/ShardClientUtil.js +279 -275
  221. package/src/sharding/ShardingManager.js +319 -318
  222. package/src/structures/AnonymousGuild.js +98 -98
  223. package/src/structures/ApplicationCommand.js +593 -593
  224. package/src/structures/ApplicationRoleConnectionMetadata.js +48 -48
  225. package/src/structures/AutoModerationActionExecution.js +89 -89
  226. package/src/structures/AutoModerationRule.js +294 -294
  227. package/src/structures/AutocompleteInteraction.js +107 -107
  228. package/src/structures/Base.js +43 -43
  229. package/src/structures/BaseCommandInteraction.js +211 -211
  230. package/src/structures/BaseGuild.js +116 -116
  231. package/src/structures/BaseGuildEmoji.js +56 -56
  232. package/src/structures/BaseGuildTextChannel.js +191 -191
  233. package/src/structures/BaseGuildVoiceChannel.js +241 -241
  234. package/src/structures/BaseMessageComponent.js +181 -114
  235. package/src/structures/ButtonInteraction.js +11 -11
  236. package/src/structures/CallState.js +63 -63
  237. package/src/structures/CategoryChannel.js +85 -85
  238. package/src/structures/Channel.js +284 -270
  239. package/src/structures/ClientPresence.js +77 -85
  240. package/src/structures/ClientUser.js +479 -448
  241. package/src/structures/CommandInteraction.js +41 -41
  242. package/src/structures/CommandInteractionOptionResolver.js +276 -276
  243. package/src/structures/ContainerComponent.js +68 -0
  244. package/src/structures/ContextMenuInteraction.js +65 -65
  245. package/src/structures/DMChannel.js +219 -217
  246. package/src/structures/DirectoryChannel.js +20 -20
  247. package/src/structures/Emoji.js +148 -148
  248. package/src/structures/FileComponent.js +49 -0
  249. package/src/structures/ForumChannel.js +31 -261
  250. package/src/structures/GroupDMChannel.js +394 -387
  251. package/src/structures/Guild.js +1643 -1608
  252. package/src/structures/GuildAuditLogs.js +746 -729
  253. package/src/structures/GuildBan.js +59 -59
  254. package/src/structures/GuildBoost.js +108 -108
  255. package/src/structures/GuildChannel.js +470 -468
  256. package/src/structures/GuildEmoji.js +161 -161
  257. package/src/structures/GuildMember.js +636 -568
  258. package/src/structures/GuildPreview.js +191 -191
  259. package/src/structures/GuildPreviewEmoji.js +27 -27
  260. package/src/structures/GuildScheduledEvent.js +536 -441
  261. package/src/structures/GuildTemplate.js +236 -236
  262. package/src/structures/Integration.js +188 -188
  263. package/src/structures/IntegrationApplication.js +96 -96
  264. package/src/structures/Interaction.js +290 -290
  265. package/src/structures/InteractionCollector.js +248 -248
  266. package/src/structures/InteractionWebhook.js +43 -43
  267. package/src/structures/Invite.js +358 -358
  268. package/src/structures/InviteGuild.js +23 -23
  269. package/src/structures/InviteStageInstance.js +86 -86
  270. package/src/structures/MediaChannel.js +11 -0
  271. package/src/structures/MediaGalleryComponent.js +41 -0
  272. package/src/structures/MediaGalleryItem.js +47 -0
  273. package/src/structures/Message.js +1252 -1227
  274. package/src/structures/MessageActionRow.js +105 -103
  275. package/src/structures/MessageAttachment.js +216 -204
  276. package/src/structures/MessageButton.js +166 -165
  277. package/src/structures/MessageCollector.js +146 -146
  278. package/src/structures/MessageComponentInteraction.js +120 -120
  279. package/src/structures/MessageContextMenuInteraction.js +20 -20
  280. package/src/structures/MessageEmbed.js +596 -586
  281. package/src/structures/MessageMentions.js +273 -273
  282. package/src/structures/MessagePayload.js +354 -318
  283. package/src/structures/MessageReaction.js +181 -171
  284. package/src/structures/MessageSelectMenu.js +141 -140
  285. package/src/structures/Modal.js +161 -161
  286. package/src/structures/ModalSubmitFieldsResolver.js +53 -53
  287. package/src/structures/ModalSubmitInteraction.js +119 -119
  288. package/src/structures/NewsChannel.js +32 -32
  289. package/src/structures/OAuth2Guild.js +28 -28
  290. package/src/structures/PermissionOverwrites.js +198 -196
  291. package/src/structures/Poll.js +108 -0
  292. package/src/structures/PollAnswer.js +88 -0
  293. package/src/structures/Presence.js +1105 -1101
  294. package/src/structures/ReactionCollector.js +229 -229
  295. package/src/structures/ReactionEmoji.js +31 -31
  296. package/src/structures/Role.js +590 -531
  297. package/src/structures/SectionComponent.js +48 -0
  298. package/src/structures/SelectMenuInteraction.js +21 -21
  299. package/src/structures/SeparatorComponent.js +48 -0
  300. package/src/structures/Session.js +81 -0
  301. package/src/structures/StageChannel.js +104 -104
  302. package/src/structures/StageInstance.js +208 -208
  303. package/src/structures/Sticker.js +310 -310
  304. package/src/structures/StickerPack.js +95 -95
  305. package/src/structures/StoreChannel.js +56 -56
  306. package/src/structures/Team.js +118 -118
  307. package/src/structures/TeamMember.js +80 -71
  308. package/src/structures/TextChannel.js +33 -33
  309. package/src/structures/TextDisplayComponent.js +40 -0
  310. package/src/structures/TextInputComponent.js +132 -131
  311. package/src/structures/ThreadChannel.js +605 -607
  312. package/src/structures/ThreadMember.js +105 -105
  313. package/src/structures/ThreadOnlyChannel.js +249 -0
  314. package/src/structures/ThumbnailComponent.js +57 -0
  315. package/src/structures/Typing.js +74 -74
  316. package/src/structures/UnfurledMediaItem.js +29 -0
  317. package/src/structures/User.js +640 -543
  318. package/src/structures/UserContextMenuInteraction.js +29 -29
  319. package/src/structures/VoiceChannel.js +110 -110
  320. package/src/structures/VoiceChannelEffect.js +69 -0
  321. package/src/structures/VoiceRegion.js +53 -53
  322. package/src/structures/VoiceState.js +354 -341
  323. package/src/structures/WebEmbed.js +373 -373
  324. package/src/structures/Webhook.js +478 -467
  325. package/src/structures/WelcomeChannel.js +60 -60
  326. package/src/structures/WelcomeScreen.js +48 -48
  327. package/src/structures/Widget.js +87 -87
  328. package/src/structures/WidgetMember.js +99 -99
  329. package/src/structures/interfaces/Application.js +825 -313
  330. package/src/structures/interfaces/Collector.js +300 -300
  331. package/src/structures/interfaces/InteractionResponses.js +313 -313
  332. package/src/structures/interfaces/TextBasedChannel.js +759 -719
  333. package/src/util/APITypes.js +59 -0
  334. package/src/util/ActivityFlags.js +44 -44
  335. package/src/util/ApplicationFlags.js +76 -76
  336. package/src/util/AttachmentFlags.js +38 -38
  337. package/src/util/BitField.js +170 -170
  338. package/src/util/ChannelFlags.js +45 -45
  339. package/src/util/Constants.js +1914 -1773
  340. package/src/util/DataResolver.js +146 -145
  341. package/src/util/Formatters.js +228 -228
  342. package/src/util/GuildMemberFlags.js +43 -43
  343. package/src/util/Intents.js +74 -74
  344. package/src/util/InviteFlags.js +34 -29
  345. package/src/util/LimitedCollection.js +131 -131
  346. package/src/util/MessageFlags.js +63 -54
  347. package/src/util/Options.js +358 -336
  348. package/src/util/Permissions.js +202 -202
  349. package/src/util/PremiumUsageFlags.js +31 -31
  350. package/src/util/PurchasedFlags.js +33 -33
  351. package/src/util/RemoteAuth.js +382 -379
  352. package/src/util/RoleFlags.js +37 -37
  353. package/src/util/SnowflakeUtil.js +92 -92
  354. package/src/util/Speaking.js +33 -0
  355. package/src/util/Sweepers.js +466 -466
  356. package/src/util/SystemChannelFlags.js +55 -55
  357. package/src/util/ThreadMemberFlags.js +30 -30
  358. package/src/util/UserFlags.js +104 -104
  359. package/src/util/Util.js +1048 -889
  360. package/typings/enums.d.ts +439 -297
  361. package/typings/index.d.ts +8247 -7432
  362. package/typings/rawDataTypes.d.ts +403 -342
  363. package/src/structures/MessagePoll.js +0 -238
@@ -1,468 +1,470 @@
1
- 'use strict';
2
-
3
- const { Channel } = require('./Channel');
4
- const { Error } = require('../errors');
5
- const PermissionOverwriteManager = require('../managers/PermissionOverwriteManager');
6
- const { VoiceBasedChannelTypes } = require('../util/Constants');
7
- const Permissions = require('../util/Permissions');
8
- const Util = require('../util/Util');
9
-
10
- /**
11
- * Represents a guild channel from any of the following:
12
- * - {@link TextChannel}
13
- * - {@link VoiceChannel}
14
- * - {@link CategoryChannel}
15
- * - {@link NewsChannel}
16
- * - {@link StoreChannel}
17
- * - {@link StageChannel}
18
- * - {@link ForumChannel}
19
- * @extends {Channel}
20
- * @abstract
21
- */
22
- class GuildChannel extends Channel {
23
- constructor(guild, data, client, immediatePatch = true) {
24
- super(guild?.client ?? client, data, false);
25
-
26
- /**
27
- * The guild the channel is in
28
- * @type {Guild}
29
- */
30
- this.guild = guild;
31
-
32
- /**
33
- * The id of the guild the channel is in
34
- * @type {Snowflake}
35
- */
36
- this.guildId = guild?.id ?? data.guild_id;
37
-
38
- this.parentId = this.parentId ?? null;
39
- /**
40
- * A manager of permission overwrites that belong to this channel
41
- * @type {PermissionOverwriteManager}
42
- */
43
- this.permissionOverwrites = new PermissionOverwriteManager(this);
44
-
45
- if (data && immediatePatch) this._patch(data);
46
- }
47
-
48
- _patch(data) {
49
- super._patch(data);
50
-
51
- if ('name' in data) {
52
- /**
53
- * The name of the guild channel
54
- * @type {string}
55
- */
56
- this.name = data.name;
57
- }
58
-
59
- if ('position' in data) {
60
- /**
61
- * The raw position of the channel from Discord
62
- * @type {number}
63
- */
64
- this.rawPosition = data.position;
65
- }
66
-
67
- if ('guild_id' in data) {
68
- this.guildId = data.guild_id;
69
- }
70
-
71
- if ('parent_id' in data) {
72
- /**
73
- * The id of the category parent of this channel
74
- * @type {?Snowflake}
75
- */
76
- this.parentId = data.parent_id;
77
- }
78
-
79
- if ('permission_overwrites' in data) {
80
- this.permissionOverwrites.cache.clear();
81
- for (const overwrite of data.permission_overwrites) {
82
- this.permissionOverwrites._add(overwrite);
83
- }
84
- }
85
- }
86
-
87
- _clone() {
88
- const clone = super._clone();
89
- clone.permissionOverwrites = new PermissionOverwriteManager(clone, this.permissionOverwrites.cache.values());
90
- return clone;
91
- }
92
-
93
- /**
94
- * The category parent of this channel
95
- * @type {?CategoryChannel}
96
- * @readonly
97
- */
98
- get parent() {
99
- return this.guild.channels.resolve(this.parentId);
100
- }
101
-
102
- /**
103
- * If the permissionOverwrites match the parent channel, null if no parent
104
- * @type {?boolean}
105
- * @readonly
106
- */
107
- get permissionsLocked() {
108
- if (!this.parent) return null;
109
-
110
- // Get all overwrites
111
- const overwriteIds = new Set([
112
- ...this.permissionOverwrites.cache.keys(),
113
- ...this.parent.permissionOverwrites.cache.keys(),
114
- ]);
115
-
116
- // Compare all overwrites
117
- return [...overwriteIds].every(key => {
118
- const channelVal = this.permissionOverwrites.cache.get(key);
119
- const parentVal = this.parent.permissionOverwrites.cache.get(key);
120
-
121
- // Handle empty overwrite
122
- if (
123
- (!channelVal &&
124
- parentVal.deny.bitfield === Permissions.defaultBit &&
125
- parentVal.allow.bitfield === Permissions.defaultBit) ||
126
- (!parentVal &&
127
- channelVal.deny.bitfield === Permissions.defaultBit &&
128
- channelVal.allow.bitfield === Permissions.defaultBit)
129
- ) {
130
- return true;
131
- }
132
-
133
- // Compare overwrites
134
- return (
135
- typeof channelVal !== 'undefined' &&
136
- typeof parentVal !== 'undefined' &&
137
- channelVal.deny.bitfield === parentVal.deny.bitfield &&
138
- channelVal.allow.bitfield === parentVal.allow.bitfield
139
- );
140
- });
141
- }
142
-
143
- /**
144
- * The position of the channel
145
- * @type {number}
146
- * @readonly
147
- */
148
- get position() {
149
- const selfIsCategory = this.type === 'GUILD_CATEGORY';
150
- const types = Util.getSortableGroupTypes(this.type);
151
-
152
- let count = 0;
153
- for (const channel of this.guild.channels.cache.values()) {
154
- if (!types.includes(channel.type)) continue;
155
- if (!selfIsCategory && channel.parentId !== this.parentId) continue;
156
- if (this.rawPosition === channel.rawPosition) {
157
- if (BigInt(channel.id) < BigInt(this.id)) count++;
158
- } else if (this.rawPosition > channel.rawPosition) {
159
- count++;
160
- }
161
- }
162
-
163
- return count;
164
- }
165
-
166
- /**
167
- * Gets the overall set of permissions for a member or role in this channel, taking into account channel overwrites.
168
- * @param {GuildMemberResolvable|RoleResolvable} memberOrRole The member or role to obtain the overall permissions for
169
- * @param {boolean} [checkAdmin=true] Whether having `ADMINISTRATOR` will return all permissions
170
- * @returns {?Readonly<Permissions>}
171
- */
172
- permissionsFor(memberOrRole, checkAdmin = true) {
173
- const member = this.guild.members.resolve(memberOrRole);
174
- if (member) return this.memberPermissions(member, checkAdmin);
175
- const role = this.guild.roles.resolve(memberOrRole);
176
- return role && this.rolePermissions(role, checkAdmin);
177
- }
178
-
179
- overwritesFor(member, verified = false, roles = null) {
180
- if (!verified) member = this.guild.members.resolve(member);
181
- if (!member) return [];
182
-
183
- roles ??= member.roles.cache;
184
- const roleOverwrites = [];
185
- let memberOverwrites;
186
- let everyoneOverwrites;
187
-
188
- for (const overwrite of this.permissionOverwrites.cache.values()) {
189
- if (overwrite.id === this.guild.id) {
190
- everyoneOverwrites = overwrite;
191
- } else if (roles.has(overwrite.id)) {
192
- roleOverwrites.push(overwrite);
193
- } else if (overwrite.id === member.id) {
194
- memberOverwrites = overwrite;
195
- }
196
- }
197
-
198
- return {
199
- everyone: everyoneOverwrites,
200
- roles: roleOverwrites,
201
- member: memberOverwrites,
202
- };
203
- }
204
-
205
- /**
206
- * Gets the overall set of permissions for a member in this channel, taking into account channel overwrites.
207
- * @param {GuildMember} member The member to obtain the overall permissions for
208
- * @param {boolean} checkAdmin=true Whether having `ADMINISTRATOR` will return all permissions
209
- * @returns {Readonly<Permissions>}
210
- * @private
211
- */
212
- memberPermissions(member, checkAdmin) {
213
- if (checkAdmin && member.id === this.guild.ownerId) return new Permissions(Permissions.ALL).freeze();
214
-
215
- const roles = member.roles.cache;
216
- const permissions = new Permissions(roles.map(role => role.permissions));
217
-
218
- if (checkAdmin && permissions.has(Permissions.FLAGS.ADMINISTRATOR)) {
219
- return new Permissions(Permissions.ALL).freeze();
220
- }
221
-
222
- const overwrites = this.overwritesFor(member, true, roles);
223
-
224
- return permissions
225
- .remove(overwrites.everyone?.deny ?? Permissions.defaultBit)
226
- .add(overwrites.everyone?.allow ?? Permissions.defaultBit)
227
- .remove(overwrites.roles.length > 0 ? overwrites.roles.map(role => role.deny) : Permissions.defaultBit)
228
- .add(overwrites.roles.length > 0 ? overwrites.roles.map(role => role.allow) : Permissions.defaultBit)
229
- .remove(overwrites.member?.deny ?? Permissions.defaultBit)
230
- .add(overwrites.member?.allow ?? Permissions.defaultBit)
231
- .freeze();
232
- }
233
-
234
- /**
235
- * Gets the overall set of permissions for a role in this channel, taking into account channel overwrites.
236
- * @param {Role} role The role to obtain the overall permissions for
237
- * @param {boolean} checkAdmin Whether having `ADMINISTRATOR` will return all permissions
238
- * @returns {Readonly<Permissions>}
239
- * @private
240
- */
241
- rolePermissions(role, checkAdmin) {
242
- if (checkAdmin && role.permissions.has(Permissions.FLAGS.ADMINISTRATOR)) {
243
- return new Permissions(Permissions.ALL).freeze();
244
- }
245
-
246
- const everyoneOverwrites = this.permissionOverwrites.cache.get(this.guild.id);
247
- const roleOverwrites = this.permissionOverwrites.cache.get(role.id);
248
-
249
- return role.permissions
250
- .remove(everyoneOverwrites?.deny ?? Permissions.defaultBit)
251
- .add(everyoneOverwrites?.allow ?? Permissions.defaultBit)
252
- .remove(roleOverwrites?.deny ?? Permissions.defaultBit)
253
- .add(roleOverwrites?.allow ?? Permissions.defaultBit)
254
- .freeze();
255
- }
256
-
257
- /**
258
- * Locks in the permission overwrites from the parent channel.
259
- * @returns {Promise<GuildChannel>}
260
- */
261
- lockPermissions() {
262
- if (!this.parent) return Promise.reject(new Error('GUILD_CHANNEL_ORPHAN'));
263
- const permissionOverwrites = this.parent.permissionOverwrites.cache.map(overwrite => overwrite.toJSON());
264
- return this.edit({ permissionOverwrites });
265
- }
266
-
267
- /**
268
- * A collection of cached members of this channel, mapped by their ids.
269
- * Members that can view this channel, if the channel is text-based.
270
- * Members in the channel, if the channel is voice-based.
271
- * @type {Collection<Snowflake, GuildMember>}
272
- * @readonly
273
- */
274
- get members() {
275
- return this.guild.members.cache.filter(m => this.permissionsFor(m).has(Permissions.FLAGS.VIEW_CHANNEL, false));
276
- }
277
-
278
- /**
279
- * Edits the channel.
280
- * @param {ChannelData} data The new data for the channel
281
- * @param {string} [reason] Reason for editing this channel
282
- * @returns {Promise<GuildChannel>}
283
- * @example
284
- * // Edit a channel
285
- * channel.edit({ name: 'new-channel' })
286
- * .then(console.log)
287
- * .catch(console.error);
288
- */
289
- edit(data, reason) {
290
- return this.guild.channels.edit(this, data, reason);
291
- }
292
-
293
- /**
294
- * Sets a new name for the guild channel.
295
- * @param {string} name The new name for the guild channel
296
- * @param {string} [reason] Reason for changing the guild channel's name
297
- * @returns {Promise<GuildChannel>}
298
- * @example
299
- * // Set a new channel name
300
- * channel.setName('not_general')
301
- * .then(newChannel => console.log(`Channel's new name is ${newChannel.name}`))
302
- * .catch(console.error);
303
- */
304
- setName(name, reason) {
305
- return this.edit({ name }, reason);
306
- }
307
-
308
- /**
309
- * Options used to set the parent of a channel.
310
- * @typedef {Object} SetParentOptions
311
- * @property {boolean} [lockPermissions=true] Whether to lock the permissions to what the parent's permissions are
312
- * @property {string} [reason] The reason for modifying the parent of the channel
313
- */
314
-
315
- /**
316
- * Sets the parent of this channel.
317
- * @param {?CategoryChannelResolvable} channel The category channel to set as the parent
318
- * @param {SetParentOptions} [options={}] The options for setting the parent
319
- * @returns {Promise<GuildChannel>}
320
- * @example
321
- * // Add a parent to a channel
322
- * message.channel.setParent('355908108431917066', { lockPermissions: false })
323
- * .then(channel => console.log(`New parent of ${message.channel.name}: ${channel.name}`))
324
- * .catch(console.error);
325
- */
326
- setParent(channel, { lockPermissions = true, reason } = {}) {
327
- return this.edit(
328
- {
329
- parent: channel ?? null,
330
- lockPermissions,
331
- },
332
- reason,
333
- );
334
- }
335
-
336
- /**
337
- * Options used to set the position of a channel.
338
- * @typedef {Object} SetChannelPositionOptions
339
- * @property {boolean} [relative=false] Whether or not to change the position relative to its current value
340
- * @property {string} [reason] The reason for changing the position
341
- */
342
-
343
- /**
344
- * Sets a new position for the guild channel.
345
- * @param {number} position The new position for the guild channel
346
- * @param {SetChannelPositionOptions} [options] Options for setting position
347
- * @returns {Promise<GuildChannel>}
348
- * @example
349
- * // Set a new channel position
350
- * channel.setPosition(2)
351
- * .then(newChannel => console.log(`Channel's new position is ${newChannel.position}`))
352
- * .catch(console.error);
353
- */
354
- setPosition(position, options = {}) {
355
- return this.guild.channels.setPosition(this, position, options);
356
- }
357
-
358
- /**
359
- * Options used to clone a guild channel.
360
- * @typedef {GuildChannelCreateOptions} GuildChannelCloneOptions
361
- * @property {string} [name=this.name] Name of the new channel
362
- */
363
-
364
- /**
365
- * Clones this channel.
366
- * @param {GuildChannelCloneOptions} [options] The options for cloning this channel
367
- * @returns {Promise<GuildChannel>}
368
- */
369
- clone(options = {}) {
370
- return this.guild.channels.create(options.name ?? this.name, {
371
- permissionOverwrites: this.permissionOverwrites.cache,
372
- topic: this.topic,
373
- type: this.type,
374
- nsfw: this.nsfw,
375
- parent: this.parent,
376
- bitrate: this.bitrate,
377
- userLimit: this.userLimit,
378
- rateLimitPerUser: this.rateLimitPerUser,
379
- position: this.rawPosition,
380
- reason: null,
381
- ...options,
382
- });
383
- }
384
-
385
- /**
386
- * Checks if this channel has the same type, topic, position, name, overwrites, and id as another channel.
387
- * In most cases, a simple `channel.id === channel2.id` will do, and is much faster too.
388
- * @param {GuildChannel} channel Channel to compare with
389
- * @returns {boolean}
390
- */
391
- equals(channel) {
392
- let equal =
393
- channel &&
394
- this.id === channel.id &&
395
- this.type === channel.type &&
396
- this.topic === channel.topic &&
397
- this.position === channel.position &&
398
- this.name === channel.name;
399
-
400
- if (equal) {
401
- if (this.permissionOverwrites && channel.permissionOverwrites) {
402
- equal = this.permissionOverwrites.cache.equals(channel.permissionOverwrites.cache);
403
- } else {
404
- equal = !this.permissionOverwrites && !channel.permissionOverwrites;
405
- }
406
- }
407
-
408
- return equal;
409
- }
410
-
411
- /**
412
- * Whether the channel is deletable by the client user
413
- * @type {boolean}
414
- * @readonly
415
- */
416
- get deletable() {
417
- return this.manageable && this.guild.rulesChannelId !== this.id && this.guild.publicUpdatesChannelId !== this.id;
418
- }
419
-
420
- /**
421
- * Whether the channel is manageable by the client user
422
- * @type {boolean}
423
- * @readonly
424
- */
425
- get manageable() {
426
- if (this.client.user.id === this.guild.ownerId) return true;
427
- const permissions = this.permissionsFor(this.client.user);
428
- if (!permissions) return false;
429
-
430
- // This flag allows managing even if timed out
431
- if (permissions.has(Permissions.FLAGS.ADMINISTRATOR, false)) return true;
432
- if (this.guild.members.me.communicationDisabledUntilTimestamp > Date.now()) return false;
433
-
434
- const bitfield = VoiceBasedChannelTypes.includes(this.type)
435
- ? Permissions.FLAGS.MANAGE_CHANNELS | Permissions.FLAGS.CONNECT
436
- : Permissions.FLAGS.VIEW_CHANNEL | Permissions.FLAGS.MANAGE_CHANNELS;
437
- return permissions.has(bitfield, false);
438
- }
439
-
440
- /**
441
- * Whether the channel is viewable by the client user
442
- * @type {boolean}
443
- * @readonly
444
- */
445
- get viewable() {
446
- if (this.client.user.id === this.guild.ownerId) return true;
447
- const permissions = this.permissionsFor(this.client.user);
448
- if (!permissions) return false;
449
- return permissions.has(Permissions.FLAGS.VIEW_CHANNEL, false);
450
- }
451
-
452
- /**
453
- * Deletes this channel.
454
- * @param {string} [reason] Reason for deleting this channel
455
- * @returns {Promise<GuildChannel>}
456
- * @example
457
- * // Delete the channel
458
- * channel.delete('making room for new channels')
459
- * .then(console.log)
460
- * .catch(console.error);
461
- */
462
- async delete(reason) {
463
- await this.guild.channels.delete(this.id, reason);
464
- return this;
465
- }
466
- }
467
-
468
- module.exports = GuildChannel;
1
+ 'use strict';
2
+
3
+ const { Channel } = require('./Channel');
4
+ const { Error } = require('../errors');
5
+ const PermissionOverwriteManager = require('../managers/PermissionOverwriteManager');
6
+ const { VoiceBasedChannelTypes } = require('../util/Constants');
7
+ const Permissions = require('../util/Permissions');
8
+ const Util = require('../util/Util');
9
+
10
+ /**
11
+ * Represents a guild channel from any of the following:
12
+ * - {@link TextChannel}
13
+ * - {@link VoiceChannel}
14
+ * - {@link CategoryChannel}
15
+ * - {@link NewsChannel}
16
+ * - {@link StoreChannel}
17
+ * - {@link StageChannel}
18
+ * - {@link ForumChannel}
19
+ * - {@link MediaChannel}
20
+ * @extends {Channel}
21
+ * @abstract
22
+ */
23
+ class GuildChannel extends Channel {
24
+ constructor(guild, data, client, immediatePatch = true) {
25
+ super(guild?.client ?? client, data, false);
26
+
27
+ /**
28
+ * The guild the channel is in
29
+ * @type {Guild}
30
+ */
31
+ this.guild = guild;
32
+
33
+ /**
34
+ * The id of the guild the channel is in
35
+ * @type {Snowflake}
36
+ */
37
+ this.guildId = guild?.id ?? data.guild_id;
38
+
39
+ this.parentId = this.parentId ?? null;
40
+ /**
41
+ * A manager of permission overwrites that belong to this channel
42
+ * @type {PermissionOverwriteManager}
43
+ */
44
+ this.permissionOverwrites = new PermissionOverwriteManager(this);
45
+
46
+ if (data && immediatePatch) this._patch(data);
47
+ }
48
+
49
+ _patch(data) {
50
+ super._patch(data);
51
+
52
+ if ('name' in data) {
53
+ /**
54
+ * The name of the guild channel
55
+ * @type {string}
56
+ */
57
+ this.name = data.name;
58
+ }
59
+
60
+ if ('position' in data) {
61
+ /**
62
+ * The raw position of the channel from Discord
63
+ * @type {number}
64
+ */
65
+ this.rawPosition = data.position;
66
+ }
67
+
68
+ if ('guild_id' in data) {
69
+ this.guildId = data.guild_id;
70
+ }
71
+
72
+ if ('parent_id' in data) {
73
+ /**
74
+ * The id of the category parent of this channel
75
+ * @type {?Snowflake}
76
+ */
77
+ this.parentId = data.parent_id;
78
+ }
79
+
80
+ if ('permission_overwrites' in data) {
81
+ this.permissionOverwrites.cache.clear();
82
+ for (const overwrite of data.permission_overwrites) {
83
+ this.permissionOverwrites._add(overwrite);
84
+ }
85
+ }
86
+ }
87
+
88
+ _clone() {
89
+ const clone = super._clone();
90
+ clone.permissionOverwrites = new PermissionOverwriteManager(clone, this.permissionOverwrites.cache.values());
91
+ return clone;
92
+ }
93
+
94
+ /**
95
+ * The category parent of this channel
96
+ * @type {?CategoryChannel}
97
+ * @readonly
98
+ */
99
+ get parent() {
100
+ return this.guild.channels.resolve(this.parentId);
101
+ }
102
+
103
+ /**
104
+ * If the permissionOverwrites match the parent channel, null if no parent
105
+ * @type {?boolean}
106
+ * @readonly
107
+ */
108
+ get permissionsLocked() {
109
+ if (!this.parent) return null;
110
+
111
+ // Get all overwrites
112
+ const overwriteIds = new Set([
113
+ ...this.permissionOverwrites.cache.keys(),
114
+ ...this.parent.permissionOverwrites.cache.keys(),
115
+ ]);
116
+
117
+ // Compare all overwrites
118
+ return [...overwriteIds].every(key => {
119
+ const channelVal = this.permissionOverwrites.cache.get(key);
120
+ const parentVal = this.parent.permissionOverwrites.cache.get(key);
121
+
122
+ // Handle empty overwrite
123
+ if (
124
+ (!channelVal &&
125
+ parentVal.deny.bitfield === Permissions.defaultBit &&
126
+ parentVal.allow.bitfield === Permissions.defaultBit) ||
127
+ (!parentVal &&
128
+ channelVal.deny.bitfield === Permissions.defaultBit &&
129
+ channelVal.allow.bitfield === Permissions.defaultBit)
130
+ ) {
131
+ return true;
132
+ }
133
+
134
+ // Compare overwrites
135
+ return (
136
+ typeof channelVal !== 'undefined' &&
137
+ typeof parentVal !== 'undefined' &&
138
+ channelVal.deny.bitfield === parentVal.deny.bitfield &&
139
+ channelVal.allow.bitfield === parentVal.allow.bitfield
140
+ );
141
+ });
142
+ }
143
+
144
+ /**
145
+ * The position of the channel
146
+ * @type {number}
147
+ * @readonly
148
+ */
149
+ get position() {
150
+ const selfIsCategory = this.type === 'GUILD_CATEGORY';
151
+ const types = Util.getSortableGroupTypes(this.type);
152
+
153
+ let count = 0;
154
+ for (const channel of this.guild.channels.cache.values()) {
155
+ if (!types.includes(channel.type)) continue;
156
+ if (!selfIsCategory && channel.parentId !== this.parentId) continue;
157
+ if (this.rawPosition === channel.rawPosition) {
158
+ if (BigInt(channel.id) < BigInt(this.id)) count++;
159
+ } else if (this.rawPosition > channel.rawPosition) {
160
+ count++;
161
+ }
162
+ }
163
+
164
+ return count;
165
+ }
166
+
167
+ /**
168
+ * Gets the overall set of permissions for a member or role in this channel, taking into account channel overwrites.
169
+ * @param {GuildMemberResolvable|RoleResolvable} memberOrRole The member or role to obtain the overall permissions for
170
+ * @param {boolean} [checkAdmin=true] Whether having `ADMINISTRATOR` will return all permissions
171
+ * @returns {?Readonly<Permissions>}
172
+ */
173
+ permissionsFor(memberOrRole, checkAdmin = true) {
174
+ const member = this.guild.members.resolve(memberOrRole);
175
+ if (member) return this.memberPermissions(member, checkAdmin);
176
+ const role = this.guild.roles.resolve(memberOrRole);
177
+ return role && this.rolePermissions(role, checkAdmin);
178
+ }
179
+
180
+ overwritesFor(member, verified = false, roles = null) {
181
+ if (!verified) member = this.guild.members.resolve(member);
182
+ if (!member) return [];
183
+
184
+ roles ??= member.roles.cache;
185
+ const roleOverwrites = [];
186
+ let memberOverwrites;
187
+ let everyoneOverwrites;
188
+
189
+ for (const overwrite of this.permissionOverwrites.cache.values()) {
190
+ if (overwrite.id === this.guild.id) {
191
+ everyoneOverwrites = overwrite;
192
+ } else if (roles.has(overwrite.id)) {
193
+ roleOverwrites.push(overwrite);
194
+ } else if (overwrite.id === member.id) {
195
+ memberOverwrites = overwrite;
196
+ }
197
+ }
198
+
199
+ return {
200
+ everyone: everyoneOverwrites,
201
+ roles: roleOverwrites,
202
+ member: memberOverwrites,
203
+ };
204
+ }
205
+
206
+ /**
207
+ * Gets the overall set of permissions for a member in this channel, taking into account channel overwrites.
208
+ * @param {GuildMember} member The member to obtain the overall permissions for
209
+ * @param {boolean} checkAdmin=true Whether having `ADMINISTRATOR` will return all permissions
210
+ * @returns {Readonly<Permissions>}
211
+ * @private
212
+ */
213
+ memberPermissions(member, checkAdmin) {
214
+ if (checkAdmin && member.id === this.guild.ownerId) return new Permissions(Permissions.ALL).freeze();
215
+
216
+ const roles = member.roles.cache;
217
+ const permissions = new Permissions(roles.map(role => role.permissions));
218
+
219
+ if (checkAdmin && permissions.has(Permissions.FLAGS.ADMINISTRATOR)) {
220
+ return new Permissions(Permissions.ALL).freeze();
221
+ }
222
+
223
+ const overwrites = this.overwritesFor(member, true, roles);
224
+
225
+ return permissions
226
+ .remove(overwrites.everyone?.deny ?? Permissions.defaultBit)
227
+ .add(overwrites.everyone?.allow ?? Permissions.defaultBit)
228
+ .remove(overwrites.roles.length > 0 ? overwrites.roles.map(role => role.deny) : Permissions.defaultBit)
229
+ .add(overwrites.roles.length > 0 ? overwrites.roles.map(role => role.allow) : Permissions.defaultBit)
230
+ .remove(overwrites.member?.deny ?? Permissions.defaultBit)
231
+ .add(overwrites.member?.allow ?? Permissions.defaultBit)
232
+ .freeze();
233
+ }
234
+
235
+ /**
236
+ * Gets the overall set of permissions for a role in this channel, taking into account channel overwrites.
237
+ * @param {Role} role The role to obtain the overall permissions for
238
+ * @param {boolean} checkAdmin Whether having `ADMINISTRATOR` will return all permissions
239
+ * @returns {Readonly<Permissions>}
240
+ * @private
241
+ */
242
+ rolePermissions(role, checkAdmin) {
243
+ if (checkAdmin && role.permissions.has(Permissions.FLAGS.ADMINISTRATOR)) {
244
+ return new Permissions(Permissions.ALL).freeze();
245
+ }
246
+
247
+ const basePermissions = new Permissions([role.permissions, role.guild.roles.everyone.permissions]);
248
+ const everyoneOverwrites = this.permissionOverwrites.cache.get(this.guild.id);
249
+ const roleOverwrites = this.permissionOverwrites.cache.get(role.id);
250
+
251
+ return basePermissions
252
+ .remove(everyoneOverwrites?.deny ?? Permissions.defaultBit)
253
+ .add(everyoneOverwrites?.allow ?? Permissions.defaultBit)
254
+ .remove(roleOverwrites?.deny ?? Permissions.defaultBit)
255
+ .add(roleOverwrites?.allow ?? Permissions.defaultBit)
256
+ .freeze();
257
+ }
258
+
259
+ /**
260
+ * Locks in the permission overwrites from the parent channel.
261
+ * @returns {Promise<GuildChannel>}
262
+ */
263
+ async lockPermissions() {
264
+ if (!this.parent) throw new Error('GUILD_CHANNEL_ORPHAN');
265
+ const permissionOverwrites = this.parent.permissionOverwrites.cache.map(overwrite => overwrite.toJSON());
266
+ return this.edit({ permissionOverwrites });
267
+ }
268
+
269
+ /**
270
+ * A collection of cached members of this channel, mapped by their ids.
271
+ * Members that can view this channel, if the channel is text-based.
272
+ * Members in the channel, if the channel is voice-based.
273
+ * @type {Collection<Snowflake, GuildMember>}
274
+ * @readonly
275
+ */
276
+ get members() {
277
+ return this.guild.members.cache.filter(m => this.permissionsFor(m).has(Permissions.FLAGS.VIEW_CHANNEL, false));
278
+ }
279
+
280
+ /**
281
+ * Edits the channel.
282
+ * @param {ChannelData} data The new data for the channel
283
+ * @param {string} [reason] Reason for editing this channel
284
+ * @returns {Promise<GuildChannel>}
285
+ * @example
286
+ * // Edit a channel
287
+ * channel.edit({ name: 'new-channel' })
288
+ * .then(console.log)
289
+ * .catch(console.error);
290
+ */
291
+ edit(data, reason) {
292
+ return this.guild.channels.edit(this, data, reason);
293
+ }
294
+
295
+ /**
296
+ * Sets a new name for the guild channel.
297
+ * @param {string} name The new name for the guild channel
298
+ * @param {string} [reason] Reason for changing the guild channel's name
299
+ * @returns {Promise<GuildChannel>}
300
+ * @example
301
+ * // Set a new channel name
302
+ * channel.setName('not_general')
303
+ * .then(newChannel => console.log(`Channel's new name is ${newChannel.name}`))
304
+ * .catch(console.error);
305
+ */
306
+ setName(name, reason) {
307
+ return this.edit({ name }, reason);
308
+ }
309
+
310
+ /**
311
+ * Options used to set the parent of a channel.
312
+ * @typedef {Object} SetParentOptions
313
+ * @property {boolean} [lockPermissions=true] Whether to lock the permissions to what the parent's permissions are
314
+ * @property {string} [reason] The reason for modifying the parent of the channel
315
+ */
316
+
317
+ /**
318
+ * Sets the parent of this channel.
319
+ * @param {?CategoryChannelResolvable} channel The category channel to set as the parent
320
+ * @param {SetParentOptions} [options={}] The options for setting the parent
321
+ * @returns {Promise<GuildChannel>}
322
+ * @example
323
+ * // Add a parent to a channel
324
+ * message.channel.setParent('355908108431917066', { lockPermissions: false })
325
+ * .then(channel => console.log(`New parent of ${message.channel.name}: ${channel.name}`))
326
+ * .catch(console.error);
327
+ */
328
+ setParent(channel, { lockPermissions = true, reason } = {}) {
329
+ return this.edit(
330
+ {
331
+ parent: channel ?? null,
332
+ lockPermissions,
333
+ },
334
+ reason,
335
+ );
336
+ }
337
+
338
+ /**
339
+ * Options used to set the position of a channel.
340
+ * @typedef {Object} SetChannelPositionOptions
341
+ * @property {boolean} [relative=false] Whether or not to change the position relative to its current value
342
+ * @property {string} [reason] The reason for changing the position
343
+ */
344
+
345
+ /**
346
+ * Sets a new position for the guild channel.
347
+ * @param {number} position The new position for the guild channel
348
+ * @param {SetChannelPositionOptions} [options] Options for setting position
349
+ * @returns {Promise<GuildChannel>}
350
+ * @example
351
+ * // Set a new channel position
352
+ * channel.setPosition(2)
353
+ * .then(newChannel => console.log(`Channel's new position is ${newChannel.position}`))
354
+ * .catch(console.error);
355
+ */
356
+ setPosition(position, options = {}) {
357
+ return this.guild.channels.setPosition(this, position, options);
358
+ }
359
+
360
+ /**
361
+ * Options used to clone a guild channel.
362
+ * @typedef {GuildChannelCreateOptions} GuildChannelCloneOptions
363
+ * @property {string} [name=this.name] Name of the new channel
364
+ */
365
+
366
+ /**
367
+ * Clones this channel.
368
+ * @param {GuildChannelCloneOptions} [options] The options for cloning this channel
369
+ * @returns {Promise<GuildChannel>}
370
+ */
371
+ clone(options = {}) {
372
+ return this.guild.channels.create(options.name ?? this.name, {
373
+ permissionOverwrites: this.permissionOverwrites.cache,
374
+ topic: this.topic,
375
+ type: this.type,
376
+ nsfw: this.nsfw,
377
+ parent: this.parent,
378
+ bitrate: this.bitrate,
379
+ userLimit: this.userLimit,
380
+ rateLimitPerUser: this.rateLimitPerUser,
381
+ position: this.rawPosition,
382
+ reason: null,
383
+ ...options,
384
+ });
385
+ }
386
+
387
+ /**
388
+ * Checks if this channel has the same type, topic, position, name, overwrites, and id as another channel.
389
+ * In most cases, a simple `channel.id === channel2.id` will do, and is much faster too.
390
+ * @param {GuildChannel} channel Channel to compare with
391
+ * @returns {boolean}
392
+ */
393
+ equals(channel) {
394
+ let equal =
395
+ channel &&
396
+ this.id === channel.id &&
397
+ this.type === channel.type &&
398
+ this.topic === channel.topic &&
399
+ this.position === channel.position &&
400
+ this.name === channel.name;
401
+
402
+ if (equal) {
403
+ if (this.permissionOverwrites && channel.permissionOverwrites) {
404
+ equal = this.permissionOverwrites.cache.equals(channel.permissionOverwrites.cache);
405
+ } else {
406
+ equal = !this.permissionOverwrites && !channel.permissionOverwrites;
407
+ }
408
+ }
409
+
410
+ return equal;
411
+ }
412
+
413
+ /**
414
+ * Whether the channel is deletable by the client user
415
+ * @type {boolean}
416
+ * @readonly
417
+ */
418
+ get deletable() {
419
+ return this.manageable && this.guild.rulesChannelId !== this.id && this.guild.publicUpdatesChannelId !== this.id;
420
+ }
421
+
422
+ /**
423
+ * Whether the channel is manageable by the client user
424
+ * @type {boolean}
425
+ * @readonly
426
+ */
427
+ get manageable() {
428
+ if (this.client.user.id === this.guild.ownerId) return true;
429
+ const permissions = this.permissionsFor(this.client.user);
430
+ if (!permissions) return false;
431
+
432
+ // This flag allows managing even if timed out
433
+ if (permissions.has(Permissions.FLAGS.ADMINISTRATOR, false)) return true;
434
+ if (this.guild.members.me.communicationDisabledUntilTimestamp > Date.now()) return false;
435
+
436
+ const bitfield = VoiceBasedChannelTypes.includes(this.type)
437
+ ? Permissions.FLAGS.MANAGE_CHANNELS | Permissions.FLAGS.CONNECT
438
+ : Permissions.FLAGS.VIEW_CHANNEL | Permissions.FLAGS.MANAGE_CHANNELS;
439
+ return permissions.has(bitfield, false);
440
+ }
441
+
442
+ /**
443
+ * Whether the channel is viewable by the client user
444
+ * @type {boolean}
445
+ * @readonly
446
+ */
447
+ get viewable() {
448
+ if (this.client.user.id === this.guild.ownerId) return true;
449
+ const permissions = this.permissionsFor(this.client.user);
450
+ if (!permissions) return false;
451
+ return permissions.has(Permissions.FLAGS.VIEW_CHANNEL, false);
452
+ }
453
+
454
+ /**
455
+ * Deletes this channel.
456
+ * @param {string} [reason] Reason for deleting this channel
457
+ * @returns {Promise<GuildChannel>}
458
+ * @example
459
+ * // Delete the channel
460
+ * channel.delete('making room for new channels')
461
+ * .then(console.log)
462
+ * .catch(console.error);
463
+ */
464
+ async delete(reason) {
465
+ await this.guild.channels.delete(this.id, reason);
466
+ return this;
467
+ }
468
+ }
469
+
470
+ module.exports = GuildChannel;