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,417 +1,417 @@
1
- 'use strict';
2
-
3
- const { Collection } = require('@discordjs/collection');
4
- const BaseManager = require('./BaseManager');
5
- const { Error, TypeError } = require('../errors');
6
- const { ApplicationCommandPermissionTypes, APIErrors } = require('../util/Constants');
7
-
8
- /**
9
- * Manages API methods for permissions of Application Commands.
10
- * @extends {BaseManager}
11
- */
12
- class ApplicationCommandPermissionsManager extends BaseManager {
13
- constructor(manager) {
14
- super(manager.client);
15
-
16
- /**
17
- * The manager or command that this manager belongs to
18
- * @type {ApplicationCommandManager|ApplicationCommand}
19
- * @private
20
- */
21
- this.manager = manager;
22
-
23
- /**
24
- * The guild that this manager acts on
25
- * @type {?Guild}
26
- */
27
- this.guild = manager.guild ?? null;
28
-
29
- /**
30
- * The id of the guild that this manager acts on
31
- * @type {?Snowflake}
32
- */
33
- this.guildId = manager.guildId ?? manager.guild?.id ?? null;
34
-
35
- /**
36
- * The id of the command this manager acts on
37
- * @type {?Snowflake}
38
- */
39
- this.commandId = manager.id ?? null;
40
- }
41
-
42
- /**
43
- * The APIRouter path to the commands
44
- * @param {Snowflake} guildId The guild's id to use in the path,
45
- * @param {Snowflake} [commandId] The application command's id
46
- * @returns {Object}
47
- * @private
48
- */
49
- permissionsPath(guildId, commandId) {
50
- return this.client.api.applications(this.client.application.id).guilds(guildId).commands(commandId).permissions;
51
- }
52
-
53
- /**
54
- * Data for setting the permissions of an application command.
55
- * @typedef {Object} ApplicationCommandPermissionData
56
- * @property {Snowflake} id The role or user's id
57
- * @property {ApplicationCommandPermissionType|number} type Whether this permission is for a role or a user
58
- * @property {boolean} permission Whether the role or user has the permission to use this command
59
- */
60
-
61
- /**
62
- * The object returned when fetching permissions for an application command.
63
- * @typedef {Object} ApplicationCommandPermissions
64
- * @property {Snowflake} id The role or user's id
65
- * @property {ApplicationCommandPermissionType} type Whether this permission is for a role or a user
66
- * @property {boolean} permission Whether the role or user has the permission to use this command
67
- */
68
-
69
- /**
70
- * Options for managing permissions for one or more Application Commands
71
- * <warn>When passing these options to a manager where `guildId` is `null`,
72
- * `guild` is a required parameter</warn>
73
- * @typedef {Object} BaseApplicationCommandPermissionsOptions
74
- * @property {GuildResolvable} [guild] The guild to modify / check permissions for
75
- * <warn>Ignored when the manager has a non-null `guildId` property</warn>
76
- * @property {ApplicationCommandResolvable} [command] The command to modify / check permissions for
77
- * <warn>Ignored when the manager has a non-null `commandId` property</warn>
78
- */
79
-
80
- /**
81
- * Fetches the permissions for one or multiple commands.
82
- * @param {BaseApplicationCommandPermissionsOptions} [options] Options used to fetch permissions
83
- * @returns {Promise<ApplicationCommandPermissions[]|Collection<Snowflake, ApplicationCommandPermissions[]>>}
84
- * @example
85
- * // Fetch permissions for one command
86
- * guild.commands.permissions.fetch({ command: '123456789012345678' })
87
- * .then(perms => console.log(`Fetched permissions for ${perms.length} users`))
88
- * .catch(console.error);
89
- * @example
90
- * // Fetch permissions for all commands in a guild
91
- * client.application.commands.permissions.fetch({ guild: '123456789012345678' })
92
- * .then(perms => console.log(`Fetched permissions for ${perms.size} commands`))
93
- * .catch(console.error);
94
- */
95
- async fetch({ guild, command } = {}) {
96
- const { guildId, commandId } = this._validateOptions(guild, command);
97
- if (commandId) {
98
- const data = await this.permissionsPath(guildId, commandId).get();
99
- return data.permissions.map(perm => this.constructor.transformPermissions(perm, true));
100
- }
101
-
102
- const data = await this.permissionsPath(guildId).get();
103
- return data.reduce(
104
- (coll, perm) =>
105
- coll.set(
106
- perm.id,
107
- perm.permissions.map(p => this.constructor.transformPermissions(p, true)),
108
- ),
109
- new Collection(),
110
- );
111
- }
112
-
113
- /**
114
- * Data used for overwriting the permissions for all application commands in a guild.
115
- * @typedef {Object} GuildApplicationCommandPermissionData
116
- * @property {Snowflake} id The command's id
117
- * @property {ApplicationCommandPermissionData[]} permissions The permissions for this command
118
- */
119
-
120
- /**
121
- * Options used to set permissions for one or more Application Commands in a guild
122
- * <warn>One of `command` AND `permissions`, OR `fullPermissions` is required.
123
- * `fullPermissions` is not a valid option when passing to a manager where `commandId` is non-null</warn>
124
- * @typedef {BaseApplicationCommandPermissionsOptions} SetApplicationCommandPermissionsOptions
125
- * @property {ApplicationCommandPermissionData[]} [permissions] The new permissions for the command
126
- * @property {GuildApplicationCommandPermissionData[]} [fullPermissions] The new permissions for all commands
127
- * in a guild <warn>When this parameter is set, `permissions` and `command` are ignored</warn>
128
- */
129
-
130
- /**
131
- * Sets the permissions for one or more commands.
132
- * @param {SetApplicationCommandPermissionsOptions} options Options used to set permissions
133
- * @returns {Promise<ApplicationCommandPermissions[]|Collection<Snowflake, ApplicationCommandPermissions[]>>}
134
- * @example
135
- * // Set the permissions for one command
136
- * client.application.commands.permissions.set({ guild: '892455839386304532', command: '123456789012345678',
137
- * permissions: [
138
- * {
139
- * id: '876543210987654321',
140
- * type: 'USER',
141
- * permission: false,
142
- * },
143
- * ]})
144
- * .then(console.log)
145
- * .catch(console.error);
146
- * @example
147
- * // Set the permissions for all commands
148
- * guild.commands.permissions.set({ fullPermissions: [
149
- * {
150
- * id: '123456789012345678',
151
- * permissions: [{
152
- * id: '876543210987654321',
153
- * type: 'USER',
154
- * permission: false,
155
- * }],
156
- * },
157
- * ]})
158
- * .then(console.log)
159
- * .catch(console.error);
160
- */
161
- async set({ guild, command, permissions, fullPermissions } = {}) {
162
- const { guildId, commandId } = this._validateOptions(guild, command);
163
-
164
- if (commandId) {
165
- if (!Array.isArray(permissions)) {
166
- throw new TypeError('INVALID_TYPE', 'permissions', 'Array of ApplicationCommandPermissionData', true);
167
- }
168
- const data = await this.permissionsPath(guildId, commandId).put({
169
- data: { permissions: permissions.map(perm => this.constructor.transformPermissions(perm)) },
170
- });
171
- return data.permissions.map(perm => this.constructor.transformPermissions(perm, true));
172
- }
173
-
174
- if (!Array.isArray(fullPermissions)) {
175
- throw new TypeError('INVALID_TYPE', 'fullPermissions', 'Array of GuildApplicationCommandPermissionData', true);
176
- }
177
-
178
- const APIPermissions = [];
179
- for (const perm of fullPermissions) {
180
- if (!Array.isArray(perm.permissions)) throw new TypeError('INVALID_ELEMENT', 'Array', 'fullPermissions', perm);
181
- APIPermissions.push({
182
- id: perm.id,
183
- permissions: perm.permissions.map(p => this.constructor.transformPermissions(p)),
184
- });
185
- }
186
- const data = await this.permissionsPath(guildId).put({
187
- data: APIPermissions,
188
- });
189
- return data.reduce(
190
- (coll, perm) =>
191
- coll.set(
192
- perm.id,
193
- perm.permissions.map(p => this.constructor.transformPermissions(p, true)),
194
- ),
195
- new Collection(),
196
- );
197
- }
198
-
199
- /**
200
- * Options used to add permissions to a command
201
- * <warn>The `command` parameter is not optional when the managers `commandId` is `null`</warn>
202
- * @typedef {BaseApplicationCommandPermissionsOptions} AddApplicationCommandPermissionsOptions
203
- * @property {ApplicationCommandPermissionData[]} permissions The permissions to add to the command
204
- */
205
-
206
- /**
207
- * Add permissions to a command.
208
- * @param {AddApplicationCommandPermissionsOptions} options Options used to add permissions
209
- * @returns {Promise<ApplicationCommandPermissions[]>}
210
- * @example
211
- * // Block a role from the command permissions
212
- * guild.commands.permissions.add({ command: '123456789012345678', permissions: [
213
- * {
214
- * id: '876543211234567890',
215
- * type: 'ROLE',
216
- * permission: false
217
- * },
218
- * ]})
219
- * .then(console.log)
220
- * .catch(console.error);
221
- */
222
- async add({ guild, command, permissions }) {
223
- const { guildId, commandId } = this._validateOptions(guild, command);
224
- if (!commandId) throw new TypeError('INVALID_TYPE', 'command', 'ApplicationCommandResolvable');
225
- if (!Array.isArray(permissions)) {
226
- throw new TypeError('INVALID_TYPE', 'permissions', 'Array of ApplicationCommandPermissionData', true);
227
- }
228
-
229
- let existing = [];
230
- try {
231
- existing = await this.fetch({ guild: guildId, command: commandId });
232
- } catch (error) {
233
- if (error.code !== APIErrors.UNKNOWN_APPLICATION_COMMAND_PERMISSIONS) throw error;
234
- }
235
-
236
- const newPermissions = permissions.slice();
237
- for (const perm of existing) {
238
- if (!newPermissions.some(x => x.id === perm.id)) {
239
- newPermissions.push(perm);
240
- }
241
- }
242
-
243
- return this.set({ guild: guildId, command: commandId, permissions: newPermissions });
244
- }
245
-
246
- /**
247
- * Options used to remove permissions from a command
248
- * <warn>The `command` parameter is not optional when the managers `commandId` is `null`</warn>
249
- * @typedef {BaseApplicationCommandPermissionsOptions} RemoveApplicationCommandPermissionsOptions
250
- * @property {UserResolvable|UserResolvable[]} [users] The user(s) to remove from the command permissions
251
- * <warn>One of `users` or `roles` is required</warn>
252
- * @property {RoleResolvable|RoleResolvable[]} [roles] The role(s) to remove from the command permissions
253
- * <warn>One of `users` or `roles` is required</warn>
254
- */
255
-
256
- /**
257
- * Remove permissions from a command.
258
- * @param {RemoveApplicationCommandPermissionsOptions} options Options used to remove permissions
259
- * @returns {Promise<ApplicationCommandPermissions[]>}
260
- * @example
261
- * // Remove a user permission from this command
262
- * guild.commands.permissions.remove({ command: '123456789012345678', users: '876543210123456789' })
263
- * .then(console.log)
264
- * .catch(console.error);
265
- * @example
266
- * // Remove multiple roles from this command
267
- * guild.commands.permissions.remove({
268
- * command: '123456789012345678', roles: ['876543210123456789', '765432101234567890']
269
- * })
270
- * .then(console.log)
271
- * .catch(console.error);
272
- */
273
- async remove({ guild, command, users, roles }) {
274
- const { guildId, commandId } = this._validateOptions(guild, command);
275
- if (!commandId) throw new TypeError('INVALID_TYPE', 'command', 'ApplicationCommandResolvable');
276
-
277
- if (!users && !roles) throw new TypeError('INVALID_TYPE', 'users OR roles', 'Array or Resolvable', true);
278
-
279
- let resolvedIds = [];
280
- if (Array.isArray(users)) {
281
- users.forEach(user => {
282
- const userId = this.client.users.resolveId(user);
283
- if (!userId) throw new TypeError('INVALID_ELEMENT', 'Array', 'users', user);
284
- resolvedIds.push(userId);
285
- });
286
- } else if (users) {
287
- const userId = this.client.users.resolveId(users);
288
- if (!userId) {
289
- throw new TypeError('INVALID_TYPE', 'users', 'Array or UserResolvable');
290
- }
291
- resolvedIds.push(userId);
292
- }
293
-
294
- if (Array.isArray(roles)) {
295
- roles.forEach(role => {
296
- if (typeof role === 'string') {
297
- resolvedIds.push(role);
298
- return;
299
- }
300
- if (!this.guild) throw new Error('GUILD_UNCACHED_ROLE_RESOLVE');
301
- const roleId = this.guild.roles.resolveId(role);
302
- if (!roleId) throw new TypeError('INVALID_ELEMENT', 'Array', 'users', role);
303
- resolvedIds.push(roleId);
304
- });
305
- } else if (roles) {
306
- if (typeof roles === 'string') {
307
- resolvedIds.push(roles);
308
- } else {
309
- if (!this.guild) throw new Error('GUILD_UNCACHED_ROLE_RESOLVE');
310
- const roleId = this.guild.roles.resolveId(roles);
311
- if (!roleId) {
312
- throw new TypeError('INVALID_TYPE', 'users', 'Array or RoleResolvable');
313
- }
314
- resolvedIds.push(roleId);
315
- }
316
- }
317
-
318
- let existing = [];
319
- try {
320
- existing = await this.fetch({ guild: guildId, command: commandId });
321
- } catch (error) {
322
- if (error.code !== APIErrors.UNKNOWN_APPLICATION_COMMAND_PERMISSIONS) throw error;
323
- }
324
-
325
- const permissions = existing.filter(perm => !resolvedIds.includes(perm.id));
326
-
327
- return this.set({ guild: guildId, command: commandId, permissions });
328
- }
329
-
330
- /**
331
- * Options used to check the existence of permissions on a command
332
- * <warn>The `command` parameter is not optional when the managers `commandId` is `null`</warn>
333
- * @typedef {BaseApplicationCommandPermissionsOptions} HasApplicationCommandPermissionsOptions
334
- * @property {UserResolvable|RoleResolvable} permissionId The user or role to check if a permission exists for
335
- * on this command.
336
- */
337
-
338
- /**
339
- * Check whether a permission exists for a user or role
340
- * @param {AddApplicationCommandPermissionsOptions} options Options used to check permissions
341
- * @returns {Promise<boolean>}
342
- * @example
343
- * // Check whether a user has permission to use a command
344
- * guild.commands.permissions.has({ command: '123456789012345678', permissionId: '876543210123456789' })
345
- * .then(console.log)
346
- * .catch(console.error);
347
- */
348
- async has({ guild, command, permissionId }) {
349
- const { guildId, commandId } = this._validateOptions(guild, command);
350
- if (!commandId) throw new TypeError('INVALID_TYPE', 'command', 'ApplicationCommandResolvable');
351
-
352
- if (!permissionId) throw new TypeError('INVALID_TYPE', 'permissionId', 'UserResolvable or RoleResolvable');
353
- let resolvedId = permissionId;
354
- if (typeof permissionId !== 'string') {
355
- resolvedId = this.client.users.resolveId(permissionId);
356
- if (!resolvedId) {
357
- if (!this.guild) throw new Error('GUILD_UNCACHED_ROLE_RESOLVE');
358
- resolvedId = this.guild.roles.resolveId(permissionId);
359
- }
360
- if (!resolvedId) {
361
- throw new TypeError('INVALID_TYPE', 'permissionId', 'UserResolvable or RoleResolvable');
362
- }
363
- }
364
-
365
- let existing = [];
366
- try {
367
- existing = await this.fetch({ guild: guildId, command: commandId });
368
- } catch (error) {
369
- if (error.code !== APIErrors.UNKNOWN_APPLICATION_COMMAND_PERMISSIONS) throw error;
370
- }
371
-
372
- return existing.some(perm => perm.id === resolvedId);
373
- }
374
-
375
- _validateOptions(guild, command) {
376
- const guildId = this.guildId ?? this.client.guilds.resolveId(guild);
377
- if (!guildId) throw new Error('GLOBAL_COMMAND_PERMISSIONS');
378
- let commandId = this.commandId;
379
- if (command && !commandId) {
380
- commandId = this.manager.resolveId?.(command);
381
- if (!commandId && this.guild) {
382
- commandId = this.guild.commands.resolveId(command);
383
- }
384
- commandId ??= this.client.application?.commands.resolveId(command);
385
- if (!commandId) {
386
- throw new TypeError('INVALID_TYPE', 'command', 'ApplicationCommandResolvable', true);
387
- }
388
- }
389
- return { guildId, commandId };
390
- }
391
-
392
- /**
393
- * Transforms an {@link ApplicationCommandPermissionData} object into something that can be used with the API.
394
- * @param {ApplicationCommandPermissionData} permissions The permissions to transform
395
- * @param {boolean} [received] Whether these permissions have been received from Discord
396
- * @returns {APIApplicationCommandPermissions}
397
- * @private
398
- */
399
- static transformPermissions(permissions, received) {
400
- return {
401
- id: permissions.id,
402
- permission: permissions.permission,
403
- type:
404
- typeof permissions.type === 'number' && !received
405
- ? permissions.type
406
- : ApplicationCommandPermissionTypes[permissions.type],
407
- };
408
- }
409
- }
410
-
411
- module.exports = ApplicationCommandPermissionsManager;
412
-
413
- /* eslint-disable max-len */
414
- /**
415
- * @external APIApplicationCommandPermissions
416
- * @see {@link https://discord.com/developers/docs/interactions/application-commands#application-command-permissions-object-application-command-permissions-structure}
417
- */
1
+ 'use strict';
2
+
3
+ const { Collection } = require('@discordjs/collection');
4
+ const BaseManager = require('./BaseManager');
5
+ const { Error, TypeError } = require('../errors');
6
+ const { ApplicationCommandPermissionTypes, APIErrors } = require('../util/Constants');
7
+
8
+ /**
9
+ * Manages API methods for permissions of Application Commands.
10
+ * @extends {BaseManager}
11
+ */
12
+ class ApplicationCommandPermissionsManager extends BaseManager {
13
+ constructor(manager) {
14
+ super(manager.client);
15
+
16
+ /**
17
+ * The manager or command that this manager belongs to
18
+ * @type {ApplicationCommandManager|ApplicationCommand}
19
+ * @private
20
+ */
21
+ this.manager = manager;
22
+
23
+ /**
24
+ * The guild that this manager acts on
25
+ * @type {?Guild}
26
+ */
27
+ this.guild = manager.guild ?? null;
28
+
29
+ /**
30
+ * The id of the guild that this manager acts on
31
+ * @type {?Snowflake}
32
+ */
33
+ this.guildId = manager.guildId ?? manager.guild?.id ?? null;
34
+
35
+ /**
36
+ * The id of the command this manager acts on
37
+ * @type {?Snowflake}
38
+ */
39
+ this.commandId = manager.id ?? null;
40
+ }
41
+
42
+ /**
43
+ * The APIRouter path to the commands
44
+ * @param {Snowflake} guildId The guild's id to use in the path,
45
+ * @param {Snowflake} [commandId] The application command's id
46
+ * @returns {Object}
47
+ * @private
48
+ */
49
+ permissionsPath(guildId, commandId) {
50
+ return this.client.api.applications(this.client.application.id).guilds(guildId).commands(commandId).permissions;
51
+ }
52
+
53
+ /**
54
+ * Data for setting the permissions of an application command.
55
+ * @typedef {Object} ApplicationCommandPermissionData
56
+ * @property {Snowflake} id The role or user's id
57
+ * @property {ApplicationCommandPermissionType|number} type Whether this permission is for a role or a user
58
+ * @property {boolean} permission Whether the role or user has the permission to use this command
59
+ */
60
+
61
+ /**
62
+ * The object returned when fetching permissions for an application command.
63
+ * @typedef {Object} ApplicationCommandPermissions
64
+ * @property {Snowflake} id The role or user's id
65
+ * @property {ApplicationCommandPermissionType} type Whether this permission is for a role or a user
66
+ * @property {boolean} permission Whether the role or user has the permission to use this command
67
+ */
68
+
69
+ /**
70
+ * Options for managing permissions for one or more Application Commands
71
+ * <warn>When passing these options to a manager where `guildId` is `null`,
72
+ * `guild` is a required parameter</warn>
73
+ * @typedef {Object} BaseApplicationCommandPermissionsOptions
74
+ * @property {GuildResolvable} [guild] The guild to modify / check permissions for
75
+ * <warn>Ignored when the manager has a non-null `guildId` property</warn>
76
+ * @property {ApplicationCommandResolvable} [command] The command to modify / check permissions for
77
+ * <warn>Ignored when the manager has a non-null `commandId` property</warn>
78
+ */
79
+
80
+ /**
81
+ * Fetches the permissions for one or multiple commands.
82
+ * @param {BaseApplicationCommandPermissionsOptions} [options] Options used to fetch permissions
83
+ * @returns {Promise<ApplicationCommandPermissions[]|Collection<Snowflake, ApplicationCommandPermissions[]>>}
84
+ * @example
85
+ * // Fetch permissions for one command
86
+ * guild.commands.permissions.fetch({ command: '123456789012345678' })
87
+ * .then(perms => console.log(`Fetched permissions for ${perms.length} users`))
88
+ * .catch(console.error);
89
+ * @example
90
+ * // Fetch permissions for all commands in a guild
91
+ * client.application.commands.permissions.fetch({ guild: '123456789012345678' })
92
+ * .then(perms => console.log(`Fetched permissions for ${perms.size} commands`))
93
+ * .catch(console.error);
94
+ */
95
+ async fetch({ guild, command } = {}) {
96
+ const { guildId, commandId } = this._validateOptions(guild, command);
97
+ if (commandId) {
98
+ const data = await this.permissionsPath(guildId, commandId).get();
99
+ return data.permissions.map(perm => this.constructor.transformPermissions(perm, true));
100
+ }
101
+
102
+ const data = await this.permissionsPath(guildId).get();
103
+ return data.reduce(
104
+ (coll, perm) =>
105
+ coll.set(
106
+ perm.id,
107
+ perm.permissions.map(p => this.constructor.transformPermissions(p, true)),
108
+ ),
109
+ new Collection(),
110
+ );
111
+ }
112
+
113
+ /**
114
+ * Data used for overwriting the permissions for all application commands in a guild.
115
+ * @typedef {Object} GuildApplicationCommandPermissionData
116
+ * @property {Snowflake} id The command's id
117
+ * @property {ApplicationCommandPermissionData[]} permissions The permissions for this command
118
+ */
119
+
120
+ /**
121
+ * Options used to set permissions for one or more Application Commands in a guild
122
+ * <warn>One of `command` AND `permissions`, OR `fullPermissions` is required.
123
+ * `fullPermissions` is not a valid option when passing to a manager where `commandId` is non-null</warn>
124
+ * @typedef {BaseApplicationCommandPermissionsOptions} SetApplicationCommandPermissionsOptions
125
+ * @property {ApplicationCommandPermissionData[]} [permissions] The new permissions for the command
126
+ * @property {GuildApplicationCommandPermissionData[]} [fullPermissions] The new permissions for all commands
127
+ * in a guild <warn>When this parameter is set, `permissions` and `command` are ignored</warn>
128
+ */
129
+
130
+ /**
131
+ * Sets the permissions for one or more commands.
132
+ * @param {SetApplicationCommandPermissionsOptions} options Options used to set permissions
133
+ * @returns {Promise<ApplicationCommandPermissions[]|Collection<Snowflake, ApplicationCommandPermissions[]>>}
134
+ * @example
135
+ * // Set the permissions for one command
136
+ * client.application.commands.permissions.set({ guild: '892455839386304532', command: '123456789012345678',
137
+ * permissions: [
138
+ * {
139
+ * id: '876543210987654321',
140
+ * type: 'USER',
141
+ * permission: false,
142
+ * },
143
+ * ]})
144
+ * .then(console.log)
145
+ * .catch(console.error);
146
+ * @example
147
+ * // Set the permissions for all commands
148
+ * guild.commands.permissions.set({ fullPermissions: [
149
+ * {
150
+ * id: '123456789012345678',
151
+ * permissions: [{
152
+ * id: '876543210987654321',
153
+ * type: 'USER',
154
+ * permission: false,
155
+ * }],
156
+ * },
157
+ * ]})
158
+ * .then(console.log)
159
+ * .catch(console.error);
160
+ */
161
+ async set({ guild, command, permissions, fullPermissions } = {}) {
162
+ const { guildId, commandId } = this._validateOptions(guild, command);
163
+
164
+ if (commandId) {
165
+ if (!Array.isArray(permissions)) {
166
+ throw new TypeError('INVALID_TYPE', 'permissions', 'Array of ApplicationCommandPermissionData', true);
167
+ }
168
+ const data = await this.permissionsPath(guildId, commandId).put({
169
+ data: { permissions: permissions.map(perm => this.constructor.transformPermissions(perm)) },
170
+ });
171
+ return data.permissions.map(perm => this.constructor.transformPermissions(perm, true));
172
+ }
173
+
174
+ if (!Array.isArray(fullPermissions)) {
175
+ throw new TypeError('INVALID_TYPE', 'fullPermissions', 'Array of GuildApplicationCommandPermissionData', true);
176
+ }
177
+
178
+ const APIPermissions = [];
179
+ for (const perm of fullPermissions) {
180
+ if (!Array.isArray(perm.permissions)) throw new TypeError('INVALID_ELEMENT', 'Array', 'fullPermissions', perm);
181
+ APIPermissions.push({
182
+ id: perm.id,
183
+ permissions: perm.permissions.map(p => this.constructor.transformPermissions(p)),
184
+ });
185
+ }
186
+ const data = await this.permissionsPath(guildId).put({
187
+ data: APIPermissions,
188
+ });
189
+ return data.reduce(
190
+ (coll, perm) =>
191
+ coll.set(
192
+ perm.id,
193
+ perm.permissions.map(p => this.constructor.transformPermissions(p, true)),
194
+ ),
195
+ new Collection(),
196
+ );
197
+ }
198
+
199
+ /**
200
+ * Options used to add permissions to a command
201
+ * <warn>The `command` parameter is not optional when the managers `commandId` is `null`</warn>
202
+ * @typedef {BaseApplicationCommandPermissionsOptions} AddApplicationCommandPermissionsOptions
203
+ * @property {ApplicationCommandPermissionData[]} permissions The permissions to add to the command
204
+ */
205
+
206
+ /**
207
+ * Add permissions to a command.
208
+ * @param {AddApplicationCommandPermissionsOptions} options Options used to add permissions
209
+ * @returns {Promise<ApplicationCommandPermissions[]>}
210
+ * @example
211
+ * // Block a role from the command permissions
212
+ * guild.commands.permissions.add({ command: '123456789012345678', permissions: [
213
+ * {
214
+ * id: '876543211234567890',
215
+ * type: 'ROLE',
216
+ * permission: false
217
+ * },
218
+ * ]})
219
+ * .then(console.log)
220
+ * .catch(console.error);
221
+ */
222
+ async add({ guild, command, permissions }) {
223
+ const { guildId, commandId } = this._validateOptions(guild, command);
224
+ if (!commandId) throw new TypeError('INVALID_TYPE', 'command', 'ApplicationCommandResolvable');
225
+ if (!Array.isArray(permissions)) {
226
+ throw new TypeError('INVALID_TYPE', 'permissions', 'Array of ApplicationCommandPermissionData', true);
227
+ }
228
+
229
+ let existing = [];
230
+ try {
231
+ existing = await this.fetch({ guild: guildId, command: commandId });
232
+ } catch (error) {
233
+ if (error.code !== APIErrors.UNKNOWN_APPLICATION_COMMAND_PERMISSIONS) throw error;
234
+ }
235
+
236
+ const newPermissions = permissions.slice();
237
+ for (const perm of existing) {
238
+ if (!newPermissions.some(x => x.id === perm.id)) {
239
+ newPermissions.push(perm);
240
+ }
241
+ }
242
+
243
+ return this.set({ guild: guildId, command: commandId, permissions: newPermissions });
244
+ }
245
+
246
+ /**
247
+ * Options used to remove permissions from a command
248
+ * <warn>The `command` parameter is not optional when the managers `commandId` is `null`</warn>
249
+ * @typedef {BaseApplicationCommandPermissionsOptions} RemoveApplicationCommandPermissionsOptions
250
+ * @property {UserResolvable|UserResolvable[]} [users] The user(s) to remove from the command permissions
251
+ * <warn>One of `users` or `roles` is required</warn>
252
+ * @property {RoleResolvable|RoleResolvable[]} [roles] The role(s) to remove from the command permissions
253
+ * <warn>One of `users` or `roles` is required</warn>
254
+ */
255
+
256
+ /**
257
+ * Remove permissions from a command.
258
+ * @param {RemoveApplicationCommandPermissionsOptions} options Options used to remove permissions
259
+ * @returns {Promise<ApplicationCommandPermissions[]>}
260
+ * @example
261
+ * // Remove a user permission from this command
262
+ * guild.commands.permissions.remove({ command: '123456789012345678', users: '876543210123456789' })
263
+ * .then(console.log)
264
+ * .catch(console.error);
265
+ * @example
266
+ * // Remove multiple roles from this command
267
+ * guild.commands.permissions.remove({
268
+ * command: '123456789012345678', roles: ['876543210123456789', '765432101234567890']
269
+ * })
270
+ * .then(console.log)
271
+ * .catch(console.error);
272
+ */
273
+ async remove({ guild, command, users, roles }) {
274
+ const { guildId, commandId } = this._validateOptions(guild, command);
275
+ if (!commandId) throw new TypeError('INVALID_TYPE', 'command', 'ApplicationCommandResolvable');
276
+
277
+ if (!users && !roles) throw new TypeError('INVALID_TYPE', 'users OR roles', 'Array or Resolvable', true);
278
+
279
+ let resolvedIds = [];
280
+ if (Array.isArray(users)) {
281
+ users.forEach(user => {
282
+ const userId = this.client.users.resolveId(user);
283
+ if (!userId) throw new TypeError('INVALID_ELEMENT', 'Array', 'users', user);
284
+ resolvedIds.push(userId);
285
+ });
286
+ } else if (users) {
287
+ const userId = this.client.users.resolveId(users);
288
+ if (!userId) {
289
+ throw new TypeError('INVALID_TYPE', 'users', 'Array or UserResolvable');
290
+ }
291
+ resolvedIds.push(userId);
292
+ }
293
+
294
+ if (Array.isArray(roles)) {
295
+ roles.forEach(role => {
296
+ if (typeof role === 'string') {
297
+ resolvedIds.push(role);
298
+ return;
299
+ }
300
+ if (!this.guild) throw new Error('GUILD_UNCACHED_ROLE_RESOLVE');
301
+ const roleId = this.guild.roles.resolveId(role);
302
+ if (!roleId) throw new TypeError('INVALID_ELEMENT', 'Array', 'users', role);
303
+ resolvedIds.push(roleId);
304
+ });
305
+ } else if (roles) {
306
+ if (typeof roles === 'string') {
307
+ resolvedIds.push(roles);
308
+ } else {
309
+ if (!this.guild) throw new Error('GUILD_UNCACHED_ROLE_RESOLVE');
310
+ const roleId = this.guild.roles.resolveId(roles);
311
+ if (!roleId) {
312
+ throw new TypeError('INVALID_TYPE', 'users', 'Array or RoleResolvable');
313
+ }
314
+ resolvedIds.push(roleId);
315
+ }
316
+ }
317
+
318
+ let existing = [];
319
+ try {
320
+ existing = await this.fetch({ guild: guildId, command: commandId });
321
+ } catch (error) {
322
+ if (error.code !== APIErrors.UNKNOWN_APPLICATION_COMMAND_PERMISSIONS) throw error;
323
+ }
324
+
325
+ const permissions = existing.filter(perm => !resolvedIds.includes(perm.id));
326
+
327
+ return this.set({ guild: guildId, command: commandId, permissions });
328
+ }
329
+
330
+ /**
331
+ * Options used to check the existence of permissions on a command
332
+ * <warn>The `command` parameter is not optional when the managers `commandId` is `null`</warn>
333
+ * @typedef {BaseApplicationCommandPermissionsOptions} HasApplicationCommandPermissionsOptions
334
+ * @property {UserResolvable|RoleResolvable} permissionId The user or role to check if a permission exists for
335
+ * on this command.
336
+ */
337
+
338
+ /**
339
+ * Check whether a permission exists for a user or role
340
+ * @param {AddApplicationCommandPermissionsOptions} options Options used to check permissions
341
+ * @returns {Promise<boolean>}
342
+ * @example
343
+ * // Check whether a user has permission to use a command
344
+ * guild.commands.permissions.has({ command: '123456789012345678', permissionId: '876543210123456789' })
345
+ * .then(console.log)
346
+ * .catch(console.error);
347
+ */
348
+ async has({ guild, command, permissionId }) {
349
+ const { guildId, commandId } = this._validateOptions(guild, command);
350
+ if (!commandId) throw new TypeError('INVALID_TYPE', 'command', 'ApplicationCommandResolvable');
351
+
352
+ if (!permissionId) throw new TypeError('INVALID_TYPE', 'permissionId', 'UserResolvable or RoleResolvable');
353
+ let resolvedId = permissionId;
354
+ if (typeof permissionId !== 'string') {
355
+ resolvedId = this.client.users.resolveId(permissionId);
356
+ if (!resolvedId) {
357
+ if (!this.guild) throw new Error('GUILD_UNCACHED_ROLE_RESOLVE');
358
+ resolvedId = this.guild.roles.resolveId(permissionId);
359
+ }
360
+ if (!resolvedId) {
361
+ throw new TypeError('INVALID_TYPE', 'permissionId', 'UserResolvable or RoleResolvable');
362
+ }
363
+ }
364
+
365
+ let existing = [];
366
+ try {
367
+ existing = await this.fetch({ guild: guildId, command: commandId });
368
+ } catch (error) {
369
+ if (error.code !== APIErrors.UNKNOWN_APPLICATION_COMMAND_PERMISSIONS) throw error;
370
+ }
371
+
372
+ return existing.some(perm => perm.id === resolvedId);
373
+ }
374
+
375
+ _validateOptions(guild, command) {
376
+ const guildId = this.guildId ?? this.client.guilds.resolveId(guild);
377
+ if (!guildId) throw new Error('GLOBAL_COMMAND_PERMISSIONS');
378
+ let commandId = this.commandId;
379
+ if (command && !commandId) {
380
+ commandId = this.manager.resolveId?.(command);
381
+ if (!commandId && this.guild) {
382
+ commandId = this.guild.commands.resolveId(command);
383
+ }
384
+ commandId ??= this.client.application?.commands.resolveId(command);
385
+ if (!commandId) {
386
+ throw new TypeError('INVALID_TYPE', 'command', 'ApplicationCommandResolvable', true);
387
+ }
388
+ }
389
+ return { guildId, commandId };
390
+ }
391
+
392
+ /**
393
+ * Transforms an {@link ApplicationCommandPermissionData} object into something that can be used with the API.
394
+ * @param {ApplicationCommandPermissionData} permissions The permissions to transform
395
+ * @param {boolean} [received] Whether these permissions have been received from Discord
396
+ * @returns {APIApplicationCommandPermissions}
397
+ * @private
398
+ */
399
+ static transformPermissions(permissions, received) {
400
+ return {
401
+ id: permissions.id,
402
+ permission: permissions.permission,
403
+ type:
404
+ typeof permissions.type === 'number' && !received
405
+ ? permissions.type
406
+ : ApplicationCommandPermissionTypes[permissions.type],
407
+ };
408
+ }
409
+ }
410
+
411
+ module.exports = ApplicationCommandPermissionsManager;
412
+
413
+ /* eslint-disable max-len */
414
+ /**
415
+ * @external APIApplicationCommandPermissions
416
+ * @see {@link https://discord.com/developers/docs/interactions/application-commands#application-command-permissions-object-application-command-permissions-structure}
417
+ */