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,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
+ */