djs-selfbot-v13 3.1.8 → 3.7.1

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