djs-selfbot-v13 3.2.2 → 3.7.2

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (364) hide show
  1. package/README.md +63 -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 +941 -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/QuestManager.js +376 -0
  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 -160
  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 -85
  241. package/src/structures/ClientUser.js +653 -448
  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 +1697 -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 -1227
  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 -318
  284. package/src/structures/MessageReaction.js +181 -171
  285. package/src/structures/MessageSelectMenu.js +141 -140
  286. package/src/structures/Modal.js +161 -161
  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 +1137 -1101
  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 -543
  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 -719
  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 -1773
  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 -336
  349. package/src/util/Permissions.js +202 -202
  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 -889
  361. package/typings/enums.d.ts +439 -297
  362. package/typings/index.d.ts +8392 -7432
  363. package/typings/rawDataTypes.d.ts +403 -342
  364. package/src/structures/MessagePoll.js +0 -238
@@ -1,41 +1,41 @@
1
- 'use strict';
2
-
3
- const BaseCommandInteraction = require('./BaseCommandInteraction');
4
- const CommandInteractionOptionResolver = require('./CommandInteractionOptionResolver');
5
-
6
- /**
7
- * Represents a command interaction.
8
- * @extends {BaseCommandInteraction}
9
- */
10
- class CommandInteraction extends BaseCommandInteraction {
11
- constructor(client, data) {
12
- super(client, data);
13
-
14
- /**
15
- * The options passed to the command.
16
- * @type {CommandInteractionOptionResolver}
17
- */
18
- this.options = new CommandInteractionOptionResolver(
19
- this.client,
20
- data.data.options?.map(option => this.transformOption(option, data.data.resolved)) ?? [],
21
- this.transformResolved(data.data.resolved ?? {}),
22
- );
23
- }
24
-
25
- /**
26
- * Returns a string representation of the command interaction.
27
- * This can then be copied by a user and executed again in a new command while keeping the option order.
28
- * @returns {string}
29
- */
30
- toString() {
31
- const properties = [
32
- this.commandName,
33
- this.options._group,
34
- this.options._subcommand,
35
- ...this.options._hoistedOptions.map(o => `${o.name}:${o.value}`),
36
- ];
37
- return `/${properties.filter(Boolean).join(' ')}`;
38
- }
39
- }
40
-
41
- module.exports = CommandInteraction;
1
+ 'use strict';
2
+
3
+ const BaseCommandInteraction = require('./BaseCommandInteraction');
4
+ const CommandInteractionOptionResolver = require('./CommandInteractionOptionResolver');
5
+
6
+ /**
7
+ * Represents a command interaction.
8
+ * @extends {BaseCommandInteraction}
9
+ */
10
+ class CommandInteraction extends BaseCommandInteraction {
11
+ constructor(client, data) {
12
+ super(client, data);
13
+
14
+ /**
15
+ * The options passed to the command.
16
+ * @type {CommandInteractionOptionResolver}
17
+ */
18
+ this.options = new CommandInteractionOptionResolver(
19
+ this.client,
20
+ data.data.options?.map(option => this.transformOption(option, data.data.resolved)) ?? [],
21
+ this.transformResolved(data.data.resolved ?? {}),
22
+ );
23
+ }
24
+
25
+ /**
26
+ * Returns a string representation of the command interaction.
27
+ * This can then be copied by a user and executed again in a new command while keeping the option order.
28
+ * @returns {string}
29
+ */
30
+ toString() {
31
+ const properties = [
32
+ this.commandName,
33
+ this.options._group,
34
+ this.options._subcommand,
35
+ ...this.options._hoistedOptions.map(o => `${o.name}:${o.value}`),
36
+ ];
37
+ return `/${properties.filter(Boolean).join(' ')}`;
38
+ }
39
+ }
40
+
41
+ module.exports = CommandInteraction;
@@ -1,276 +1,276 @@
1
- 'use strict';
2
-
3
- const { TypeError } = require('../errors');
4
-
5
- /**
6
- * A resolver for command interaction options.
7
- */
8
- class CommandInteractionOptionResolver {
9
- constructor(client, options, resolved) {
10
- /**
11
- * The client that instantiated this.
12
- * @name CommandInteractionOptionResolver#client
13
- * @type {Client}
14
- * @readonly
15
- */
16
- Object.defineProperty(this, 'client', { value: client });
17
-
18
- /**
19
- * The name of the subcommand group.
20
- * @type {?string}
21
- * @private
22
- */
23
- this._group = null;
24
-
25
- /**
26
- * The name of the subcommand.
27
- * @type {?string}
28
- * @private
29
- */
30
- this._subcommand = null;
31
-
32
- /**
33
- * The bottom-level options for the interaction.
34
- * If there is a subcommand (or subcommand and group), this is the options for the subcommand.
35
- * @type {CommandInteractionOption[]}
36
- * @private
37
- */
38
- this._hoistedOptions = options;
39
-
40
- // Hoist subcommand group if present
41
- if (this._hoistedOptions[0]?.type === 'SUB_COMMAND_GROUP') {
42
- this._group = this._hoistedOptions[0].name;
43
- this._hoistedOptions = this._hoistedOptions[0].options ?? [];
44
- }
45
- // Hoist subcommand if present
46
- if (this._hoistedOptions[0]?.type === 'SUB_COMMAND') {
47
- this._subcommand = this._hoistedOptions[0].name;
48
- this._hoistedOptions = this._hoistedOptions[0].options ?? [];
49
- }
50
-
51
- /**
52
- * The interaction options array.
53
- * @name CommandInteractionOptionResolver#data
54
- * @type {ReadonlyArray<CommandInteractionOption>}
55
- * @readonly
56
- */
57
- Object.defineProperty(this, 'data', { value: Object.freeze([...options]) });
58
-
59
- /**
60
- * The interaction resolved data
61
- * @name CommandInteractionOptionResolver#resolved
62
- * @type {Readonly<CommandInteractionResolvedData>}
63
- */
64
- Object.defineProperty(this, 'resolved', { value: Object.freeze(resolved) });
65
- }
66
-
67
- /**
68
- * Gets an option by its name.
69
- * @param {string} name The name of the option.
70
- * @param {boolean} [required=false] Whether to throw an error if the option is not found.
71
- * @returns {?CommandInteractionOption} The option, if found.
72
- */
73
- get(name, required = false) {
74
- const option = this._hoistedOptions.find(opt => opt.name === name);
75
- if (!option) {
76
- if (required) {
77
- throw new TypeError('COMMAND_INTERACTION_OPTION_NOT_FOUND', name);
78
- }
79
- return null;
80
- }
81
- return option;
82
- }
83
-
84
- /**
85
- * Gets an option by name and property and checks its type.
86
- * @param {string} name The name of the option.
87
- * @param {ApplicationCommandOptionType} type The type of the option.
88
- * @param {string[]} properties The properties to check for for `required`.
89
- * @param {boolean} required Whether to throw an error if the option is not found.
90
- * @returns {?CommandInteractionOption} The option, if found.
91
- * @private
92
- */
93
- _getTypedOption(name, type, properties, required) {
94
- const option = this.get(name, required);
95
- if (!option) {
96
- return null;
97
- } else if (option.type !== type) {
98
- throw new TypeError('COMMAND_INTERACTION_OPTION_TYPE', name, option.type, type);
99
- } else if (required && properties.every(prop => option[prop] === null || typeof option[prop] === 'undefined')) {
100
- throw new TypeError('COMMAND_INTERACTION_OPTION_EMPTY', name, option.type);
101
- }
102
- return option;
103
- }
104
-
105
- /**
106
- * Gets the selected subcommand.
107
- * @param {boolean} [required=true] Whether to throw an error if there is no subcommand.
108
- * @returns {?string} The name of the selected subcommand, or null if not set and not required.
109
- */
110
- getSubcommand(required = true) {
111
- if (required && !this._subcommand) {
112
- throw new TypeError('COMMAND_INTERACTION_OPTION_NO_SUB_COMMAND');
113
- }
114
- return this._subcommand;
115
- }
116
-
117
- /**
118
- * Gets the selected subcommand group.
119
- * @param {boolean} [required=true] Whether to throw an error if there is no subcommand group.
120
- * @returns {?string} The name of the selected subcommand group, or null if not set and not required.
121
- */
122
- getSubcommandGroup(required = true) {
123
- if (required && !this._group) {
124
- throw new TypeError('COMMAND_INTERACTION_OPTION_NO_SUB_COMMAND_GROUP');
125
- }
126
- return this._group;
127
- }
128
-
129
- /**
130
- * Gets a boolean option.
131
- * @param {string} name The name of the option.
132
- * @param {boolean} [required=false] Whether to throw an error if the option is not found.
133
- * @returns {?boolean} The value of the option, or null if not set and not required.
134
- */
135
- getBoolean(name, required = false) {
136
- const option = this._getTypedOption(name, 'BOOLEAN', ['value'], required);
137
- return option?.value ?? null;
138
- }
139
-
140
- /**
141
- * Gets a channel option.
142
- * @param {string} name The name of the option.
143
- * @param {boolean} [required=false] Whether to throw an error if the option is not found.
144
- * @returns {?(GuildChannel|ThreadChannel|APIChannel)}
145
- * The value of the option, or null if not set and not required.
146
- */
147
- getChannel(name, required = false) {
148
- const option = this._getTypedOption(name, 'CHANNEL', ['channel'], required);
149
- return option?.channel ?? null;
150
- }
151
-
152
- /**
153
- * Gets a string option.
154
- * @param {string} name The name of the option.
155
- * @param {boolean} [required=false] Whether to throw an error if the option is not found.
156
- * @returns {?string} The value of the option, or null if not set and not required.
157
- */
158
- getString(name, required = false) {
159
- const option = this._getTypedOption(name, 'STRING', ['value'], required);
160
- return option?.value ?? null;
161
- }
162
-
163
- /**
164
- * Gets an integer option.
165
- * @param {string} name The name of the option.
166
- * @param {boolean} [required=false] Whether to throw an error if the option is not found.
167
- * @returns {?number} The value of the option, or null if not set and not required.
168
- */
169
- getInteger(name, required = false) {
170
- const option = this._getTypedOption(name, 'INTEGER', ['value'], required);
171
- return option?.value ?? null;
172
- }
173
-
174
- /**
175
- * Gets a number option.
176
- * @param {string} name The name of the option.
177
- * @param {boolean} [required=false] Whether to throw an error if the option is not found.
178
- * @returns {?number} The value of the option, or null if not set and not required.
179
- */
180
- getNumber(name, required = false) {
181
- const option = this._getTypedOption(name, 'NUMBER', ['value'], required);
182
- return option?.value ?? null;
183
- }
184
-
185
- /**
186
- * Gets a user option.
187
- * @param {string} name The name of the option.
188
- * @param {boolean} [required=false] Whether to throw an error if the option is not found.
189
- * @returns {?User} The value of the option, or null if not set and not required.
190
- */
191
- getUser(name, required = false) {
192
- const option = this._getTypedOption(name, 'USER', ['user'], required);
193
- return option?.user ?? null;
194
- }
195
-
196
- /**
197
- * Gets a member option.
198
- * @param {string} name The name of the option.
199
- * @param {boolean} [required=false] Whether to throw an error if the option is not found.
200
- * @returns {?(GuildMember|APIGuildMember)}
201
- * The value of the option, or null if not set and not required.
202
- */
203
- getMember(name, required = false) {
204
- const option = this._getTypedOption(name, 'USER', ['member'], required);
205
- return option?.member ?? null;
206
- }
207
-
208
- /**
209
- * Gets a role option.
210
- * @param {string} name The name of the option.
211
- * @param {boolean} [required=false] Whether to throw an error if the option is not found.
212
- * @returns {?(Role|APIRole)} The value of the option, or null if not set and not required.
213
- */
214
- getRole(name, required = false) {
215
- const option = this._getTypedOption(name, 'ROLE', ['role'], required);
216
- return option?.role ?? null;
217
- }
218
-
219
- /**
220
- * Gets a mentionable option.
221
- * @param {string} name The name of the option.
222
- * @param {boolean} [required=false] Whether to throw an error if the option is not found.
223
- * @returns {?(User|GuildMember|APIGuildMember|Role|APIRole)}
224
- * The value of the option, or null if not set and not required.
225
- */
226
- getMentionable(name, required = false) {
227
- const option = this._getTypedOption(name, 'MENTIONABLE', ['user', 'member', 'role'], required);
228
- return option?.member ?? option?.user ?? option?.role ?? null;
229
- }
230
-
231
- /**
232
- * Gets a message option.
233
- * @param {string} name The name of the option.
234
- * @param {boolean} [required=false] Whether to throw an error if the option is not found.
235
- * @returns {?(Message|APIMessage)}
236
- * The value of the option, or null if not set and not required.
237
- */
238
- getMessage(name, required = false) {
239
- const option = this._getTypedOption(name, '_MESSAGE', ['message'], required);
240
- return option?.message ?? null;
241
- }
242
-
243
- /**
244
- * The full autocomplete option object.
245
- * @typedef {Object} AutocompleteFocusedOption
246
- * @property {string} name The name of the option
247
- * @property {ApplicationCommandOptionType} type The type of the application command option
248
- * @property {string} value The value of the option
249
- * @property {boolean} focused Whether this option is currently in focus for autocomplete
250
- */
251
-
252
- /**
253
- * Gets the focused option.
254
- * @param {boolean} [getFull=false] Whether to get the full option object
255
- * @returns {string|AutocompleteFocusedOption}
256
- * The value of the option, or the whole option if getFull is true
257
- */
258
- getFocused(getFull = false) {
259
- const focusedOption = this._hoistedOptions.find(option => option.focused);
260
- if (!focusedOption) throw new TypeError('AUTOCOMPLETE_INTERACTION_OPTION_NO_FOCUSED_OPTION');
261
- return getFull ? focusedOption : focusedOption.value;
262
- }
263
-
264
- /**
265
- * Gets an attachment option.
266
- * @param {string} name The name of the option.
267
- * @param {boolean} [required=false] Whether to throw an error if the option is not found.
268
- * @returns {?MessageAttachment} The value of the option, or null if not set and not required.
269
- */
270
- getAttachment(name, required = false) {
271
- const option = this._getTypedOption(name, 'ATTACHMENT', ['attachment'], required);
272
- return option?.attachment ?? null;
273
- }
274
- }
275
-
276
- module.exports = CommandInteractionOptionResolver;
1
+ 'use strict';
2
+
3
+ const { TypeError } = require('../errors');
4
+
5
+ /**
6
+ * A resolver for command interaction options.
7
+ */
8
+ class CommandInteractionOptionResolver {
9
+ constructor(client, options, resolved) {
10
+ /**
11
+ * The client that instantiated this.
12
+ * @name CommandInteractionOptionResolver#client
13
+ * @type {Client}
14
+ * @readonly
15
+ */
16
+ Object.defineProperty(this, 'client', { value: client });
17
+
18
+ /**
19
+ * The name of the subcommand group.
20
+ * @type {?string}
21
+ * @private
22
+ */
23
+ this._group = null;
24
+
25
+ /**
26
+ * The name of the subcommand.
27
+ * @type {?string}
28
+ * @private
29
+ */
30
+ this._subcommand = null;
31
+
32
+ /**
33
+ * The bottom-level options for the interaction.
34
+ * If there is a subcommand (or subcommand and group), this is the options for the subcommand.
35
+ * @type {CommandInteractionOption[]}
36
+ * @private
37
+ */
38
+ this._hoistedOptions = options;
39
+
40
+ // Hoist subcommand group if present
41
+ if (this._hoistedOptions[0]?.type === 'SUB_COMMAND_GROUP') {
42
+ this._group = this._hoistedOptions[0].name;
43
+ this._hoistedOptions = this._hoistedOptions[0].options ?? [];
44
+ }
45
+ // Hoist subcommand if present
46
+ if (this._hoistedOptions[0]?.type === 'SUB_COMMAND') {
47
+ this._subcommand = this._hoistedOptions[0].name;
48
+ this._hoistedOptions = this._hoistedOptions[0].options ?? [];
49
+ }
50
+
51
+ /**
52
+ * The interaction options array.
53
+ * @name CommandInteractionOptionResolver#data
54
+ * @type {ReadonlyArray<CommandInteractionOption>}
55
+ * @readonly
56
+ */
57
+ Object.defineProperty(this, 'data', { value: Object.freeze([...options]) });
58
+
59
+ /**
60
+ * The interaction resolved data
61
+ * @name CommandInteractionOptionResolver#resolved
62
+ * @type {Readonly<CommandInteractionResolvedData>}
63
+ */
64
+ Object.defineProperty(this, 'resolved', { value: Object.freeze(resolved) });
65
+ }
66
+
67
+ /**
68
+ * Gets an option by its name.
69
+ * @param {string} name The name of the option.
70
+ * @param {boolean} [required=false] Whether to throw an error if the option is not found.
71
+ * @returns {?CommandInteractionOption} The option, if found.
72
+ */
73
+ get(name, required = false) {
74
+ const option = this._hoistedOptions.find(opt => opt.name === name);
75
+ if (!option) {
76
+ if (required) {
77
+ throw new TypeError('COMMAND_INTERACTION_OPTION_NOT_FOUND', name);
78
+ }
79
+ return null;
80
+ }
81
+ return option;
82
+ }
83
+
84
+ /**
85
+ * Gets an option by name and property and checks its type.
86
+ * @param {string} name The name of the option.
87
+ * @param {ApplicationCommandOptionType} type The type of the option.
88
+ * @param {string[]} properties The properties to check for for `required`.
89
+ * @param {boolean} required Whether to throw an error if the option is not found.
90
+ * @returns {?CommandInteractionOption} The option, if found.
91
+ * @private
92
+ */
93
+ _getTypedOption(name, type, properties, required) {
94
+ const option = this.get(name, required);
95
+ if (!option) {
96
+ return null;
97
+ } else if (option.type !== type) {
98
+ throw new TypeError('COMMAND_INTERACTION_OPTION_TYPE', name, option.type, type);
99
+ } else if (required && properties.every(prop => option[prop] === null || typeof option[prop] === 'undefined')) {
100
+ throw new TypeError('COMMAND_INTERACTION_OPTION_EMPTY', name, option.type);
101
+ }
102
+ return option;
103
+ }
104
+
105
+ /**
106
+ * Gets the selected subcommand.
107
+ * @param {boolean} [required=true] Whether to throw an error if there is no subcommand.
108
+ * @returns {?string} The name of the selected subcommand, or null if not set and not required.
109
+ */
110
+ getSubcommand(required = true) {
111
+ if (required && !this._subcommand) {
112
+ throw new TypeError('COMMAND_INTERACTION_OPTION_NO_SUB_COMMAND');
113
+ }
114
+ return this._subcommand;
115
+ }
116
+
117
+ /**
118
+ * Gets the selected subcommand group.
119
+ * @param {boolean} [required=true] Whether to throw an error if there is no subcommand group.
120
+ * @returns {?string} The name of the selected subcommand group, or null if not set and not required.
121
+ */
122
+ getSubcommandGroup(required = true) {
123
+ if (required && !this._group) {
124
+ throw new TypeError('COMMAND_INTERACTION_OPTION_NO_SUB_COMMAND_GROUP');
125
+ }
126
+ return this._group;
127
+ }
128
+
129
+ /**
130
+ * Gets a boolean option.
131
+ * @param {string} name The name of the option.
132
+ * @param {boolean} [required=false] Whether to throw an error if the option is not found.
133
+ * @returns {?boolean} The value of the option, or null if not set and not required.
134
+ */
135
+ getBoolean(name, required = false) {
136
+ const option = this._getTypedOption(name, 'BOOLEAN', ['value'], required);
137
+ return option?.value ?? null;
138
+ }
139
+
140
+ /**
141
+ * Gets a channel option.
142
+ * @param {string} name The name of the option.
143
+ * @param {boolean} [required=false] Whether to throw an error if the option is not found.
144
+ * @returns {?(GuildChannel|ThreadChannel|APIChannel)}
145
+ * The value of the option, or null if not set and not required.
146
+ */
147
+ getChannel(name, required = false) {
148
+ const option = this._getTypedOption(name, 'CHANNEL', ['channel'], required);
149
+ return option?.channel ?? null;
150
+ }
151
+
152
+ /**
153
+ * Gets a string option.
154
+ * @param {string} name The name of the option.
155
+ * @param {boolean} [required=false] Whether to throw an error if the option is not found.
156
+ * @returns {?string} The value of the option, or null if not set and not required.
157
+ */
158
+ getString(name, required = false) {
159
+ const option = this._getTypedOption(name, 'STRING', ['value'], required);
160
+ return option?.value ?? null;
161
+ }
162
+
163
+ /**
164
+ * Gets an integer option.
165
+ * @param {string} name The name of the option.
166
+ * @param {boolean} [required=false] Whether to throw an error if the option is not found.
167
+ * @returns {?number} The value of the option, or null if not set and not required.
168
+ */
169
+ getInteger(name, required = false) {
170
+ const option = this._getTypedOption(name, 'INTEGER', ['value'], required);
171
+ return option?.value ?? null;
172
+ }
173
+
174
+ /**
175
+ * Gets a number option.
176
+ * @param {string} name The name of the option.
177
+ * @param {boolean} [required=false] Whether to throw an error if the option is not found.
178
+ * @returns {?number} The value of the option, or null if not set and not required.
179
+ */
180
+ getNumber(name, required = false) {
181
+ const option = this._getTypedOption(name, 'NUMBER', ['value'], required);
182
+ return option?.value ?? null;
183
+ }
184
+
185
+ /**
186
+ * Gets a user option.
187
+ * @param {string} name The name of the option.
188
+ * @param {boolean} [required=false] Whether to throw an error if the option is not found.
189
+ * @returns {?User} The value of the option, or null if not set and not required.
190
+ */
191
+ getUser(name, required = false) {
192
+ const option = this._getTypedOption(name, 'USER', ['user'], required);
193
+ return option?.user ?? null;
194
+ }
195
+
196
+ /**
197
+ * Gets a member option.
198
+ * @param {string} name The name of the option.
199
+ * @param {boolean} [required=false] Whether to throw an error if the option is not found.
200
+ * @returns {?(GuildMember|APIGuildMember)}
201
+ * The value of the option, or null if not set and not required.
202
+ */
203
+ getMember(name, required = false) {
204
+ const option = this._getTypedOption(name, 'USER', ['member'], required);
205
+ return option?.member ?? null;
206
+ }
207
+
208
+ /**
209
+ * Gets a role option.
210
+ * @param {string} name The name of the option.
211
+ * @param {boolean} [required=false] Whether to throw an error if the option is not found.
212
+ * @returns {?(Role|APIRole)} The value of the option, or null if not set and not required.
213
+ */
214
+ getRole(name, required = false) {
215
+ const option = this._getTypedOption(name, 'ROLE', ['role'], required);
216
+ return option?.role ?? null;
217
+ }
218
+
219
+ /**
220
+ * Gets a mentionable option.
221
+ * @param {string} name The name of the option.
222
+ * @param {boolean} [required=false] Whether to throw an error if the option is not found.
223
+ * @returns {?(User|GuildMember|APIGuildMember|Role|APIRole)}
224
+ * The value of the option, or null if not set and not required.
225
+ */
226
+ getMentionable(name, required = false) {
227
+ const option = this._getTypedOption(name, 'MENTIONABLE', ['user', 'member', 'role'], required);
228
+ return option?.member ?? option?.user ?? option?.role ?? null;
229
+ }
230
+
231
+ /**
232
+ * Gets a message option.
233
+ * @param {string} name The name of the option.
234
+ * @param {boolean} [required=false] Whether to throw an error if the option is not found.
235
+ * @returns {?(Message|APIMessage)}
236
+ * The value of the option, or null if not set and not required.
237
+ */
238
+ getMessage(name, required = false) {
239
+ const option = this._getTypedOption(name, '_MESSAGE', ['message'], required);
240
+ return option?.message ?? null;
241
+ }
242
+
243
+ /**
244
+ * The full autocomplete option object.
245
+ * @typedef {Object} AutocompleteFocusedOption
246
+ * @property {string} name The name of the option
247
+ * @property {ApplicationCommandOptionType} type The type of the application command option
248
+ * @property {string} value The value of the option
249
+ * @property {boolean} focused Whether this option is currently in focus for autocomplete
250
+ */
251
+
252
+ /**
253
+ * Gets the focused option.
254
+ * @param {boolean} [getFull=false] Whether to get the full option object
255
+ * @returns {string|AutocompleteFocusedOption}
256
+ * The value of the option, or the whole option if getFull is true
257
+ */
258
+ getFocused(getFull = false) {
259
+ const focusedOption = this._hoistedOptions.find(option => option.focused);
260
+ if (!focusedOption) throw new TypeError('AUTOCOMPLETE_INTERACTION_OPTION_NO_FOCUSED_OPTION');
261
+ return getFull ? focusedOption : focusedOption.value;
262
+ }
263
+
264
+ /**
265
+ * Gets an attachment option.
266
+ * @param {string} name The name of the option.
267
+ * @param {boolean} [required=false] Whether to throw an error if the option is not found.
268
+ * @returns {?MessageAttachment} The value of the option, or null if not set and not required.
269
+ */
270
+ getAttachment(name, required = false) {
271
+ const option = this._getTypedOption(name, 'ATTACHMENT', ['attachment'], required);
272
+ return option?.attachment ?? null;
273
+ }
274
+ }
275
+
276
+ module.exports = CommandInteractionOptionResolver;