seyfert 4.5.0 → 4.6.0

package/lib/builders/FileUpload.d.ts

@@ -1,4 +1,5 @@
-import { type APIFileUploadComponent } from '../types';
+import type { RestOrArray } from '../common';
+import { type APIFileUploadComponent, type FileUploadType } from '../types';
 import { BaseComponentBuilder } from './Base';
 export declare class FileUpload extends BaseComponentBuilder<APIFileUploadComponent> {
     constructor(data?: Partial<APIFileUploadComponent>);
@@ -32,4 +33,10 @@ export declare class FileUpload extends BaseComponentBuilder<APIFileUploadCompon
      * @returns The current FileUpload instance.
      */
     setRequired(required: boolean): this;
+    /**
+     * Sets the file types accepted by the file upload.
+     * @param fileTypes - Media groups or dot-prefixed file extensions to accept (maximum of 10).
+     * @returns The current FileUpload instance.
+     */
+    setFileTypes(...fileTypes: RestOrArray<FileUploadType>): this;
 }

package/lib/builders/FileUpload.js

@@ -52,5 +52,14 @@ class FileUpload extends Base_1.BaseComponentBuilder {
         this.data.required = required;
         return this;
     }
+    /**
+     * Sets the file types accepted by the file upload.
+     * @param fileTypes - Media groups or dot-prefixed file extensions to accept (maximum of 10).
+     * @returns The current FileUpload instance.
+     */
+    setFileTypes(...fileTypes) {
+        this.data.file_types = fileTypes.flat();
+        return this;
+    }
 }
 exports.FileUpload = FileUpload;

package/lib/builders/RadioGroup.js

@@ -53,7 +53,7 @@ class RadioGroup extends Base_1.BaseComponentBuilder {
                     ...(0, common_1.createValidationMetadata)('number of options between 2 and 10', optionCount, {
                         component: 'RadioGroup',
                     }),
-                    detail: 'RadioGroup must have between 2 and 10 options.',
+                    detail: `RadioGroup has an invalid options length: expected number of options between 2 and 10, received ${optionCount}.`,
                 },
             });
         }

package/lib/client/base.d.ts

@@ -5,7 +5,7 @@ import type { Command, CommandContext, ContextMenuCommand, ExtendedRC, ExtendedR
 import { type InferWithPrefix, type MiddlewareContext } from '../commands/applications/shared';
 import { HandleCommand } from '../commands/handle';
 import { CommandHandler } from '../commands/handler';
-import { ApplicationShorter, ChannelShorter, EmojiShorter, GuildShorter, InteractionShorter, InvitesShorter, Logger, type MakeRequired, MemberShorter, MessageShorter, ReactionShorter, RoleShorter, TemplateShorter, ThreadShorter, UsersShorter, WebhookShorter } from '../common';
+import { ApplicationShorter, ChannelShorter, EmojiShorter, GuildShorter, InteractionShorter, InvitesShorter, Logger, type MakePresent, type MakeRequired, MemberShorter, MessageShorter, ReactionShorter, RoleShorter, TemplateShorter, ThreadShorter, UsersShorter, WebhookShorter } from '../common';
 import { BanShorter } from '../common/shorters/bans';
 import { SoundboardShorter } from '../common/shorters/soundboard';
 import { VoiceStateShorter } from '../common/shorters/voiceStates';
@@ -154,13 +154,13 @@ interface RC extends ExtendedRC {
     port?: number;
     publicKey?: string;
 }
-export type InternalRuntimeConfigHTTP = Omit<MakeRequired<RC, 'publicKey' | 'port' | 'applicationId'>, 'intents' | 'locations'> & {
+export type InternalRuntimeConfigHTTP = Omit<MakePresent<RC, 'publicKey' | 'port' | 'applicationId'>, 'intents' | 'locations'> & {
     locations: Omit<RC['locations'], 'events'>;
 };
 export type RuntimeConfigHTTP = Omit<MakeRequired<RC, 'publicKey' | 'applicationId'>, 'intents' | 'locations'> & {
     locations: Omit<RC['locations'], 'events'>;
 };
-export type InternalRuntimeConfig = MakeRequired<RC, 'intents'>;
+export type InternalRuntimeConfig = MakePresent<RC, 'intents'>;
 export type RuntimeConfig = OmitInsert<InternalRuntimeConfig, 'intents', {
     intents?: IntentStrings | number[] | number;
 }>;

package/lib/client/collectors.d.ts

@@ -1,8 +1,10 @@
 import type { Awaitable, CamelCase } from '../common';
-import type { CallbackEventHandler, CustomEventsKeys, GatewayEvents } from '../events';
+import type { CallbackEventHandler, CustomEventsKeys, GatewayEvents, ResolveEventRunParams } from '../events';
 export type AllClientEvents = CustomEventsKeys | GatewayEvents;
 export type ParseClientEventName<T extends AllClientEvents> = T extends CustomEventsKeys ? T : CamelCase<T>;
-export type CollectorRunPameters<T extends AllClientEvents> = Awaited<Parameters<CallbackEventHandler[ParseClientEventName<T>]>[0]>;
+export type CollectorRunParameters<T extends AllClientEvents> = T extends CustomEventsKeys ? ResolveEventRunParams<T> : Awaited<Parameters<CallbackEventHandler[ParseClientEventName<T>]>[0]>;
+/** @deprecated Use {@link CollectorRunParameters}. */
+export type CollectorRunPameters<T extends AllClientEvents> = CollectorRunParameters<T>;
 type RunData<T extends AllClientEvents> = {
     options: {
         event: T;
@@ -10,9 +12,9 @@ type RunData<T extends AllClientEvents> = {
         timeout?: number;
         onStop?: (reason: string) => unknown;
         onStopError?: (reason: string, error: unknown) => unknown;
-        filter: (arg: CollectorRunPameters<T>) => Awaitable<boolean>;
-        run: (arg: CollectorRunPameters<T>, stop: (reason?: string) => void) => unknown;
-        onRunError?: (arg: CollectorRunPameters<T>, error: unknown, stop: (reason?: string) => void) => unknown;
+        filter: (arg: CollectorRunParameters<T>) => Awaitable<boolean>;
+        run: (arg: CollectorRunParameters<T>, stop: (reason?: string) => void) => unknown;
+        onRunError?: (arg: CollectorRunParameters<T>, error: unknown, stop: (reason?: string) => void) => unknown;
     };
     idle?: NodeJS.Timeout;
     timeout?: NodeJS.Timeout;
@@ -27,9 +29,9 @@ export declare class Collectors {
         timeout?: number;
         onStop?: (reason: string) => unknown;
         onStopError?: (reason: string, error: unknown) => unknown;
-        filter: (arg: Awaited<Parameters<CallbackEventHandler[ParseClientEventName<T>]>[0]>) => Awaitable<boolean>;
-        run: (arg: Awaited<Parameters<CallbackEventHandler[ParseClientEventName<T>]>[0]>, stop: (reason?: string) => void) => unknown;
-        onRunError?: ((arg: Awaited<Parameters<CallbackEventHandler[ParseClientEventName<T>]>[0]>, error: unknown, stop: (reason?: string) => void) => unknown) | undefined;
+        filter: (arg: CollectorRunParameters<T>) => Awaitable<boolean>;
+        run: (arg: CollectorRunParameters<T>, stop: (reason?: string) => void) => unknown;
+        onRunError?: ((arg: CollectorRunParameters<T>, error: unknown, stop: (reason?: string) => void) => unknown) | undefined;
     };
     private delete;
 }

package/lib/client/transformers.d.ts

@@ -13,6 +13,11 @@ export type BaseChannelStructure = InferCustomStructure<BaseChannel<ChannelType>
 export type BaseGuildChannelStructure = InferCustomStructure<BaseGuildChannel, 'BaseGuildChannel'>;
 export type TextGuildChannelStructure = InferCustomStructure<TextGuildChannel, 'TextGuildChannel'>;
 export type DMChannelStructure = InferCustomStructure<DMChannel, 'DMChannel'>;
+export type GroupDMChannelStructure = Omit<DMChannelStructure, 'isDM' | 'name' | 'type'> & {
+    isDM(): this is GroupDMChannelStructure;
+    name: string | null;
+    type: ChannelType.GroupDM;
+};
 export type VoiceChannelStructure = InferCustomStructure<VoiceChannel, 'VoiceChannel'>;
 export type StageChannelStructure = InferCustomStructure<StageChannel, 'StageChannel'>;
 export type MediaChannelStructure = InferCustomStructure<MediaChannel, 'MediaChannel'>;

package/lib/client/workerclient.d.ts

@@ -1,6 +1,6 @@
 import { type Awaitable, type DeepPartial, type MakeRequired, type When } from '../common';
 import { EventHandler } from '../events';
-import { type GatewayDispatchPayload } from '../types';
+import { type GatewayDispatchPayload, type GatewaySendPayload } from '../types';
 import { Shard, type ShardManagerOptions, type WorkerData } from '../websocket';
 import { MemberUpdateHandler } from '../websocket/discord/events/memberUpdate';
 import { PresenceUpdateHandler } from '../websocket/discord/events/presenceUpdate';
@@ -41,6 +41,13 @@ export declare class WorkerClient<Ready extends boolean = boolean> extends BaseC
     postMessage(body: WorkerMessages | ClientHeartbeaterMessages): unknown;
     handleManagerMessages(data: ManagerMessages | WorkerHeartbeaterMessages): Promise<any>;
     calculateShardId(guildId: string): number;
+    /**
+     * Sends a Gateway payload through the worker client's shard rate limiter.
+     *
+     * @returns `true` after the payload is sent.
+     */
+    sendGatewayPayload<T extends GatewaySendPayload>(shardId: number, payload: T): Promise<boolean>;
+    private sendGatewayPayloadOnShard;
     private generateNonce;
     private generateSendPromise;
     tellWorker<R, V extends Record<string, unknown>>(workerId: number, func: (_: this, vars: V) => R, vars: V): Promise<R>;

package/lib/client/workerclient.js

@@ -156,14 +156,12 @@ class WorkerClient extends base_1.BaseClient {
                 break;
             case 'SEND_PAYLOAD':
                 {
-                    const shard = this.shards.get(data.shardId);
-                    if (!shard) {
-                        this.logger.fatal('Worker trying send payload by non-existent shard');
+                    const { nonce: _nonce, shardId: _shardId, type: _type, ...payload } = data;
+                    const result = await this.sendGatewayPayloadOnShard(data.shardId, payload, true);
+                    if (result === 'missing') {
+                        this.logger.fatal(`Worker trying to send payload by non-existent shard (#${data.shardId})`);
                         return;
                     }
-                    await shard.send(true, {
-                        ...data,
-                    });
                     this.postMessage({
                         type: 'RESULT_PAYLOAD',
                         nonce: data.nonce,
@@ -289,7 +287,7 @@ class WorkerClient extends base_1.BaseClient {
                     this.rest.workerPromises.delete(data.nonce);
                     if (data.error)
                         return promise.reject(data.error);
-                    promise.resolve(data.response);
+                    promise.resolve(data.responseType === 'arrayBuffer' ? Uint8Array.from(data.response).buffer : data.response);
                 }
                 break;
             case 'EXECUTE_EVAL':
@@ -362,17 +360,38 @@ class WorkerClient extends base_1.BaseClient {
     calculateShardId(guildId) {
         return (0, common_1.calculateShardId)(guildId, this.workerData.totalShards);
     }
+    /**
+     * Sends a Gateway payload through the worker client's shard rate limiter.
+     *
+     * @returns `true` after the payload is sent.
+     */
+    async sendGatewayPayload(shardId, payload) {
+        const result = await this.sendGatewayPayloadOnShard(shardId, payload, false);
+        if (result === 'missing') {
+            throw new common_1.SeyfertError('INTERNAL_ERROR', { metadata: { detail: `Shard #${shardId} doesn't exist` } });
+        }
+        return true;
+    }
+    async sendGatewayPayloadOnShard(shardId, payload, force) {
+        const shard = this.shards.get(shardId);
+        if (!shard)
+            return 'missing';
+        await shard.send(force, payload);
+        return 'sent';
+    }
     generateNonce() {
         const uuid = (0, node_crypto_1.randomUUID)();
         if (this.promises.has(uuid))
             return this.generateNonce();
         return uuid;
     }
-    generateSendPromise(nonce, message = 'Timeout') {
+    generateSendPromise(nonce, operation = 'Worker request') {
         return new Promise((res, rej) => {
             const timeout = setTimeout(() => {
                 this.promises.delete(nonce);
-                rej(new common_1.SeyfertError('WORKER_TIMEOUT', { metadata: { ...{ nonce }, detail: message } }));
+                rej(new common_1.SeyfertError('WORKER_TIMEOUT', {
+                    metadata: { nonce, operation, detail: `${operation} timed out (nonce: ${nonce}).` },
+                }));
             }, 60e3);
             this.promises.set(nonce, { resolve: res, timeout });
         });

package/lib/commands/applications/chat.d.ts

@@ -1,12 +1,14 @@
 import type { PermissionStrings, SeyfertBaseChoiceableOption, SeyfertBasicOption, SeyfertChoice } from '../..';
 import type { Attachment } from '../../builders';
 import type { GuildMemberStructure, GuildRoleStructure, InteractionGuildMemberStructure, UserStructure } from '../../client/transformers';
-import type { AllChannels, AutocompleteInteraction } from '../../structures';
+import { type If } from '../../common';
+import type { AutocompleteInteraction, MaybeResolvedChannel, ResolvedChannel } from '../../structures';
 import { type APIApplicationCommandBasicOption, type APIApplicationCommandOption, ApplicationCommandOptionType, ApplicationCommandType, type ApplicationIntegrationType, type InteractionContextType, type LocaleString } from '../../types';
 import type { Groups, RegisteredMiddlewares } from '../decorators';
 import type { CommandOptionWithType } from '../handle';
 import type { CommandContext } from './chatcontext';
-import type { ExtraProps, IgnoreCommand, OnOptionsReturnObject, SeyfertChannelMap, UsingClient } from './shared';
+import type { ExtraProps, IgnoreCommand, InferWithPrefix, OnOptionsReturnObject, SeyfertChannelMap, UsingClient } from './shared';
+export type CommandOptionChannel<C extends keyof SeyfertChannelMap = keyof SeyfertChannelMap> = If<InferWithPrefix, MaybeResolvedChannel<SeyfertChannelMap[C]>, ResolvedChannel<SeyfertChannelMap[C]>>;
 export interface ReturnOptionsTypes {
     1: never;
     2: never;
@@ -14,7 +16,7 @@ export interface ReturnOptionsTypes {
     4: number;
     5: boolean;
     6: InteractionGuildMemberStructure | UserStructure;
-    7: AllChannels;
+    7: CommandOptionChannel;
     8: GuildRoleStructure;
     9: GuildRoleStructure | InteractionGuildMemberStructure | GuildMemberStructure | UserStructure;
     10: number;
@@ -44,7 +46,7 @@ type ContextOptionsAuxInternal<T extends CommandBaseOption & {
     type: ApplicationCommandOptionType;
 }> = T['value'] extends (...args: any) => any ? Parameters<Parameters<T['value']>[1]>[0] : NonNullable<T['value']> extends (...args: any) => any ? Parameters<Parameters<NonNullable<T['value']>>[1]>[0] extends never ? T extends {
     channel_types?: infer C;
-} ? C extends any[] ? C[number] extends keyof SeyfertChannelMap ? SeyfertChannelMap[C[number]] : never : never : T extends {
+} ? C extends any[] ? C[number] extends keyof SeyfertChannelMap ? CommandOptionChannel<C[number]> : never : never : T extends {
     choices?: infer C;
 } ? C extends SeyfertChoice<string | number>[] ? C[number]['value'] : never : never : Parameters<Parameters<NonNullable<T['value']>>[1]>[0] : ReturnOptionsTypes[T['type']];
 type ContextOptionsAux<T extends OptionsRecord> = {

package/lib/commands/applications/options.d.ts

@@ -2,9 +2,9 @@ import type { Awaitable, FlatObjectKeys } from '../../common';
 import type { ModalContext } from '../../components';
 import type { ComponentContext } from '../../components/componentcontext';
 import type { MessageCommandInteraction, UserCommandInteraction } from '../../structures';
-import { type APIApplicationCommandBasicOption, type APIApplicationCommandOptionChoice, ApplicationCommandOptionType } from '../../types';
+import { type APIApplicationCommandBasicOption, type APIApplicationCommandOptionChoice, ApplicationCommandOptionType, type FileUploadType } from '../../types';
 import type { LocalizationMap } from '../../types/payloads';
-import type { AutocompleteCallback, EntryPointContext, MenuCommandContext, OnAutocompleteErrorCallback, ReturnOptionsTypes } from '..';
+import type { AutocompleteCallback, CommandOptionChannel, EntryPointContext, MenuCommandContext, OnAutocompleteErrorCallback, ReturnOptionsTypes } from '..';
 import type { CommandContext } from './chatcontext';
 import type { DefaultLocale, MiddlewareContext, OKFunction, SeyfertChannelMap, StopFunction } from './shared';
 export interface SeyfertBasicOption<T extends keyof ReturnOptionsTypes, R = true | false> {
@@ -49,7 +49,7 @@ export interface ChoiceableValues {
 }
 export type ValueCallback<T extends keyof ReturnOptionsTypes, C = T extends ChoiceableTypes ? SeyfertChoice<ChoiceableValues[T]>[] : keyof SeyfertChannelMap, I = any> = (data: {
     context: CommandContext;
-    value: T extends ChoiceableTypes ? C extends SeyfertChoice<ChoiceableValues[T]>[] ? C[number]['value'] extends ReturnOptionsTypes[T] ? C[number]['value'] : never : never : C extends keyof SeyfertChannelMap ? SeyfertChannelMap[C] : never;
+    value: T extends ChoiceableTypes ? C extends SeyfertChoice<ChoiceableValues[T]>[] ? C[number]['value'] extends ReturnOptionsTypes[T] ? C[number]['value'] : never : never : C extends keyof SeyfertChannelMap ? CommandOptionChannel<C> : never;
 }, ok: OKFunction<I>, fail: StopFunction) => Awaitable<void>;
 export type SeyfertStringOption<T = SeyfertChoice<string>[], R = boolean, VC = never> = SeyfertBaseChoiceableOption<ApplicationCommandOptionType.String, T, R, VC> & {
     autocomplete?: AutocompleteCallback;
@@ -85,7 +85,9 @@ export type SeyfertChannelOption<C = keyof SeyfertChannelMap, R = true | false,
 };
 export type SeyfertRoleOption<R = boolean> = SeyfertBasicOption<ApplicationCommandOptionType.Role, R>;
 export type SeyfertMentionableOption<R = boolean> = SeyfertBasicOption<ApplicationCommandOptionType.Mentionable, R>;
-export type SeyfertAttachmentOption<R = boolean> = SeyfertBasicOption<ApplicationCommandOptionType.Attachment, R>;
+export type SeyfertAttachmentOption<R = boolean> = SeyfertBasicOption<ApplicationCommandOptionType.Attachment, R> & {
+    file_types?: readonly FileUploadType[];
+};
 export declare function createStringOption<R extends boolean, C extends SeyfertChoice<string>[] = SeyfertChoice<string>[], VC = never>(data: SeyfertStringOption<C, R, VC>): {
     readonly type: ApplicationCommandOptionType.String;
     readonly required?: R | undefined;

package/lib/commands/applications/shared.d.ts

@@ -1,4 +1,4 @@
-import type { CategoryChannelStructure, DirectoryChannelStructure, DMChannelStructure, ForumChannelStructure, MediaChannelStructure, NewsChannelStructure, StageChannelStructure, TextGuildChannelStructure, ThreadChannelStructure, VoiceChannelStructure } from '../../client';
+import type { CategoryChannelStructure, DirectoryChannelStructure, DMChannelStructure, ForumChannelStructure, GroupDMChannelStructure, MediaChannelStructure, NewsChannelStructure, StageChannelStructure, TextGuildChannelStructure, ThreadChannelStructure, VoiceChannelStructure } from '../../client';
 import type { BaseClient } from '../../client/base';
 import type { IsStrictlyUndefined } from '../../common';
 import type { ChannelType } from '../../types';
@@ -73,7 +73,7 @@ export interface SeyfertChannelMap {
     [ChannelType.GuildText]: TextGuildChannelStructure;
     [ChannelType.DM]: DMChannelStructure;
     [ChannelType.GuildVoice]: VoiceChannelStructure;
-    [ChannelType.GroupDM]: DMChannelStructure;
+    [ChannelType.GroupDM]: GroupDMChannelStructure;
     [ChannelType.GuildCategory]: CategoryChannelStructure;
     [ChannelType.GuildAnnouncement]: NewsChannelStructure;
     [ChannelType.AnnouncementThread]: ThreadChannelStructure;

package/lib/commands/handle.d.ts

@@ -1,8 +1,8 @@
 import { type MessageStructure, type OptionResolverStructure, Transformers } from '../client/transformers';
-import type { MakeRequired } from '../common';
+import { type Awaitable, type MakeRequired, type PermissionStrings } from '../common';
 import { type __InternalReplyFunction, AutocompleteInteraction, type ChatInputCommandInteraction, type ComponentInteraction, type EntryPointInteraction, type MessageCommandInteraction, type ModalSubmitInteraction, type UserCommandInteraction } from '../structures';
 import type { PermissionsBitField } from '../structures/extra/Permissions';
-import { type APIApplicationCommandInteraction, type APIApplicationCommandInteractionDataOption, type APIInteraction, ApplicationCommandOptionType, type GatewayMessageCreateDispatchData } from '../types';
+import { type APIApplicationCommandInteraction, type APIApplicationCommandInteractionDataOption, type APIGuildMember, type APIInteraction, ApplicationCommandOptionType, type GatewayMessageCreateDispatchData } from '../types';
 import { Command, type CommandAutocompleteOption, CommandContext, type CommandOption, type ContextMenuCommand, type ContextOptionsResolved, type EntryPointCommand, EntryPointContext, MenuCommandContext, type MessageCommandOptionErrors, SubCommand, type UsingClient } from '.';
 export type CommandOptionWithType = CommandOption & {
     type: ApplicationCommandOptionType;
@@ -36,10 +36,14 @@ export declare class HandleCommand {
         guild_id?: string;
         name: string;
     }): T | undefined;
+    /** Checks the member permissions required by a command. */
+    checkMemberPermissions(command: Command | SubCommand, _context: CommandContext, permissions: PermissionsBitField): Awaitable<PermissionStrings | undefined>;
+    /** Checks the bot permissions required by a command. */
+    checkBotPermissions(command: Command | SubCommand | ContextMenuCommand | EntryPointCommand, _context: CommandContext | MenuCommandContext<any> | EntryPointContext, permissions: PermissionsBitField): Awaitable<PermissionStrings | undefined>;
     checkPermissions(app: PermissionsBitField, bot: bigint): ("CreateInstantInvite" | "KickMembers" | "BanMembers" | "Administrator" | "ManageChannels" | "ManageGuild" | "AddReactions" | "ViewAuditLog" | "PrioritySpeaker" | "Stream" | "ViewChannel" | "SendMessages" | "SendTTSMessages" | "ManageMessages" | "EmbedLinks" | "AttachFiles" | "ReadMessageHistory" | "MentionEveryone" | "UseExternalEmojis" | "ViewGuildInsights" | "Connect" | "Speak" | "MuteMembers" | "DeafenMembers" | "MoveMembers" | "UseVAD" | "ChangeNickname" | "ManageNicknames" | "ManageRoles" | "ManageWebhooks" | "ManageGuildExpressions" | "UseApplicationCommands" | "RequestToSpeak" | "ManageEvents" | "ManageThreads" | "CreatePublicThreads" | "CreatePrivateThreads" | "UseExternalStickers" | "SendMessagesInThreads" | "UseEmbeddedActivities" | "ModerateMembers" | "ViewCreatorMonetizationAnalytics" | "UseSoundboard" | "CreateGuildExpressions" | "CreateEvents" | "UseExternalSounds" | "SendVoiceMessages" | "SetVoiceChannelStatus" | "SendPolls" | "UseExternalApps" | "PinMessages" | "BypassSlowmode")[] | undefined;
     fetchChannel(_option: CommandOptionWithType, query: string): Promise<import("../types").APIChannel> | null;
     fetchUser(_option: CommandOptionWithType, query: string): Promise<import("../types").APIUser> | null;
-    fetchMember(_option: CommandOptionWithType, query: string, guildId: string): Promise<import("../types").APIGuildMember> | null;
+    fetchMember(_option: CommandOptionWithType, query: string, guildId: string): Promise<APIGuildMember | null>;
     fetchRole(_option: CommandOptionWithType, query: string, guildId?: string): Promise<import("../types").APIRole> | null;
     runGlobalMiddlewares(command: Command | ContextMenuCommand | SubCommand | EntryPointCommand, context: CommandContext<{}, never> | MenuCommandContext<any> | EntryPointContext): Promise<false | {
         error?: string;

package/lib/commands/handle.js

@@ -2,6 +2,7 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.HandleCommand = void 0;
 const transformers_1 = require("../client/transformers");
+const common_1 = require("../common");
 const constants_1 = require("../common/it/constants");
 const components_1 = require("../components");
 const structures_1 = require("../structures");
@@ -39,7 +40,7 @@ class HandleCommand {
     async contextMenu(command, interaction, context) {
         try {
             if (context.guildId && command.botPermissions) {
-                const permissions = this.checkPermissions(interaction.appPermissions, command.botPermissions);
+                const permissions = await this.checkBotPermissions(command, context, interaction.appPermissions);
                 if (permissions)
                     return await command.onBotPermissionsFail?.(context, permissions);
             }
@@ -77,7 +78,7 @@ class HandleCommand {
     async entryPoint(command, interaction, context) {
         try {
             if (context.guildId && command.botPermissions) {
-                const permissions = this.checkPermissions(interaction.appPermissions, command.botPermissions);
+                const permissions = await this.checkBotPermissions(command, context, interaction.appPermissions);
                 if (permissions)
                     return await command.onBotPermissionsFail(context, permissions);
             }
@@ -110,12 +111,12 @@ class HandleCommand {
         try {
             if (context.guildId) {
                 if (command.botPermissions) {
-                    const permissions = this.checkPermissions(interaction.appPermissions, command.botPermissions);
+                    const permissions = await this.checkBotPermissions(command, context, interaction.appPermissions);
                     if (permissions)
                         return await command.onBotPermissionsFail?.(context, permissions);
                 }
                 if (command.defaultMemberPermissions) {
-                    const permissions = this.checkPermissions(interaction.member.permissions, command.defaultMemberPermissions);
+                    const permissions = await this.checkMemberPermissions(command, context, interaction.member.permissions);
                     if (permissions)
                         return await command.onPermissionsFail?.(context, permissions);
                 }
@@ -288,15 +289,15 @@ class HandleCommand {
             if (rawMessage.guild_id) {
                 if (command.defaultMemberPermissions) {
                     const memberPermissions = await self.members.permissions(rawMessage.guild_id, rawMessage.author.id);
-                    const permissions = this.checkPermissions(memberPermissions, command.defaultMemberPermissions);
+                    const permissions = await this.checkMemberPermissions(command, context, memberPermissions);
                     const guild = await this.client.guilds.raw(rawMessage.guild_id);
                     if (permissions && guild.owner_id !== rawMessage.author.id) {
-                        return await command.onPermissionsFail?.(context, memberPermissions.keys(permissions));
+                        return await command.onPermissionsFail?.(context, permissions);
                     }
                 }
                 if (command.botPermissions) {
                     const appPermissions = await self.members.permissions(rawMessage.guild_id, self.botId);
-                    const permissions = this.checkPermissions(appPermissions, command.botPermissions);
+                    const permissions = await this.checkBotPermissions(command, context, appPermissions);
                     if (permissions) {
                         return await command.onBotPermissionsFail?.(context, permissions);
                     }
@@ -402,6 +403,18 @@ class HandleCommand {
             return command.name === data.name;
         });
     }
+    /** Checks the member permissions required by a command. */
+    checkMemberPermissions(command, _context, permissions) {
+        if (!command.defaultMemberPermissions)
+            return;
+        return this.checkPermissions(permissions, command.defaultMemberPermissions);
+    }
+    /** Checks the bot permissions required by a command. */
+    checkBotPermissions(command, _context, permissions) {
+        if (!command.botPermissions)
+            return;
+        return this.checkPermissions(permissions, command.botPermissions);
+    }
     checkPermissions(app, bot) {
         if (app.has(['Administrator']))
             return;
@@ -423,11 +436,23 @@ class HandleCommand {
             return this.client.users.raw(id);
         return null;
     }
-    fetchMember(_option, query, guildId) {
+    async fetchMember(_option, query, guildId) {
         const id = query.match(/[0-9]{17,19}/g)?.[0];
-        if (id)
-            return this.client.members.raw(guildId, id);
-        return null;
+        if (!id)
+            return null;
+        try {
+            return await this.client.members.raw(guildId, id);
+        }
+        catch (error) {
+            const response = common_1.SeyfertError.is(error) ? error.metadata?.response : undefined;
+            if (typeof response === 'object' &&
+                response !== null &&
+                'code' in response &&
+                [types_1.RESTJSONErrorCodes.UnknownMember, types_1.RESTJSONErrorCodes.UnknownUser].includes(response.code)) {
+                return null;
+            }
+            throw error;
+        }
     }
     fetchRole(_option, query, guildId) {
         const id = query.match(/[0-9]{17,19}/g)?.[0];

package/lib/commands/handler.js

@@ -136,6 +136,17 @@ class CommandHandler extends common_1.BaseHandler {
                     !!option.autocomplete !== !!cached.autocomplete ||
                     this.shoudUploadChoices(option, cached));
             case types_1.ApplicationCommandOptionType.Attachment:
+                {
+                    const cachedAttachment = cached;
+                    if (option.file_types?.length !== cachedAttachment.file_types?.length)
+                        return true;
+                    if (option.file_types && cachedAttachment.file_types) {
+                        const fileTypes = [...option.file_types].sort();
+                        const cachedFileTypes = [...cachedAttachment.file_types].sort();
+                        return fileTypes.some((fileType, index) => fileType !== cachedFileTypes[index]);
+                    }
+                }
+                break;
             case types_1.ApplicationCommandOptionType.Boolean:
             case types_1.ApplicationCommandOptionType.Mentionable:
             case types_1.ApplicationCommandOptionType.Role:

package/lib/commands/optionresolver.d.ts

@@ -1,9 +1,8 @@
 import { Attachment } from '../builders';
 import { type GuildMemberStructure, type GuildRoleStructure, type InteractionGuildMemberStructure, type UserStructure } from '../client/transformers';
-import { type MakeRequired } from '../common';
-import { type AllChannels } from '../structures';
+import { type MakePresent } from '../common';
 import { type APIApplicationCommandInteractionDataOption, type APIAttachment, type APIGuildMember, type APIInteractionDataResolvedChannel, type APIInteractionGuildMember, type APIRole, type APIUser, ApplicationCommandOptionType } from '../types';
-import type { Command, CommandAutocompleteOption, SubCommand } from './applications/chat';
+import type { Command, CommandAutocompleteOption, CommandOptionChannel, SubCommand } from './applications/chat';
 import type { UsingClient } from './applications/shared';
 export type ContextOptionsResolved = {
     members?: Record<string, APIGuildMember | Omit<APIGuildMember, 'user'> | APIInteractionGuildMember>;
@@ -31,9 +30,9 @@ export declare class OptionResolver {
     getGroup(): string | undefined;
     get(name: string): OptionResolved | undefined;
     getHoisted(name: string): OptionResolved | undefined;
-    getValue(name: string): AllChannels | Attachment | boolean | number | string | UserStructure | GuildMemberStructure | InteractionGuildMemberStructure | GuildRoleStructure | undefined;
+    getValue(name: string): CommandOptionChannel | Attachment | boolean | number | string | UserStructure | GuildMemberStructure | InteractionGuildMemberStructure | GuildRoleStructure | undefined;
     private getTypedOption;
-    getChannel(name: string, required?: true): AllChannels;
+    getChannel(name: string, required?: true): CommandOptionChannel;
     getString(name: string, required?: true): string;
     transformOption(option: APIApplicationCommandInteractionDataOption, resolved?: ContextOptionsResolved): OptionResolved;
 }
@@ -45,11 +44,11 @@ export interface OptionResolved {
     user?: UserStructure;
     member?: GuildMemberStructure | InteractionGuildMemberStructure;
     attachment?: Attachment;
-    channel?: AllChannels;
+    channel?: CommandOptionChannel;
     role?: GuildRoleStructure;
     focused?: boolean;
 }
-export type OptionResolvedWithValue = MakeRequired<Pick<OptionResolved, 'name' | 'value' | 'focused'>, 'value'> & {
+export type OptionResolvedWithValue = MakePresent<Pick<OptionResolved, 'name' | 'value' | 'focused'>, 'value'> & {
     type: ApplicationCommandOptionType.Boolean | ApplicationCommandOptionType.Integer | ApplicationCommandOptionType.Number | ApplicationCommandOptionType.String;
 };
 export type OptionResolvedWithProp = Exclude<OptionResolved, {

package/lib/common/it/error.d.ts

@@ -31,6 +31,10 @@ export declare class SeyfertError extends Error {
      * Optional contextual data attached to the error.
      */
     metadata?: Record<string, unknown>;
+    static is(error: unknown): error is SeyfertError;
+    static is<C extends SeyfertErrorCode>(error: unknown, code: C): error is SeyfertError & {
+        code: C;
+    };
     /**
      * Creates a SeyfertError instance.
      *
@@ -72,6 +76,15 @@ export declare const SeyfertErrorMessages: {
     INVALID_OPTIONS_LENGTH: string;
     MISSING_COMPONENT: string;
     MISSING_ACCESSORY: string;
+    MISSING_MEDIA: string;
+    MISSING_MODAL_CUSTOM_ID: string;
+    MISSING_MODAL_TITLE: string;
+    MISSING_POLL_QUESTION: string;
+    MISSING_POLL_ANSWERS: string;
+    MISSING_RADIO_GROUP_OPTION_LABEL: string;
+    MISSING_RADIO_GROUP_OPTION_VALUE: string;
+    MISSING_STRING_SELECT_OPTION_LABEL: string;
+    MISSING_STRING_SELECT_OPTION_VALUE: string;
     INVALID_ATTACHMENT_TYPE: string;
     INVALID_ANSWER_ID: string;
     UNDEFINED_LOCALE: string;

package/lib/common/it/error.js

@@ -35,6 +35,9 @@ class SeyfertError extends Error {
      * Optional contextual data attached to the error.
      */
     metadata;
+    static is(error, code) {
+        return error instanceof SeyfertError && (code === undefined || error.code === code);
+    }
     /**
      * Creates a SeyfertError instance.
      *
@@ -85,6 +88,15 @@ exports.SeyfertErrorMessages = {
     INVALID_OPTIONS_LENGTH: 'Invalid options length.',
     MISSING_COMPONENT: 'Cannot convert to JSON without a component.',
     MISSING_ACCESSORY: 'Cannot convert to JSON without an accessory.',
+    MISSING_MEDIA: 'Cannot convert to JSON without media.',
+    MISSING_MODAL_CUSTOM_ID: 'Cannot convert to JSON without a custom_id.',
+    MISSING_MODAL_TITLE: 'Cannot convert to JSON without a title.',
+    MISSING_POLL_QUESTION: 'Cannot convert to JSON without a question.',
+    MISSING_POLL_ANSWERS: 'Cannot convert to JSON without answers.',
+    MISSING_RADIO_GROUP_OPTION_LABEL: 'Cannot convert to JSON without a label.',
+    MISSING_RADIO_GROUP_OPTION_VALUE: 'Cannot convert to JSON without a value.',
+    MISSING_STRING_SELECT_OPTION_LABEL: 'Cannot convert to JSON without a label.',
+    MISSING_STRING_SELECT_OPTION_VALUE: 'Cannot convert to JSON without a value.',
     INVALID_ATTACHMENT_TYPE: 'Invalid attachment type.',
     INVALID_ANSWER_ID: 'Invalid answer id.',
     UNDEFINED_LOCALE: 'Undefined locale.',
@@ -127,7 +139,9 @@ exports.SeyfertErrorMessages = {
     GUILD_SEARCH_INDEX_NOT_READY: 'Guild search index is not yet available.',
 };
 function resolveSeyfertErrorMessage(code) {
-    const preset = exports.SeyfertErrorMessages[code];
+    const preset = Object.hasOwn(exports.SeyfertErrorMessages, code)
+        ? exports.SeyfertErrorMessages[code]
+        : undefined;
     if (preset)
         return preset;
     return code

package/lib/common/it/logger.js

@@ -72,15 +72,18 @@ class Logger {
         Logger.__assignFileName = cb;
     }
     static async clearLogs() {
-        for (const i of await node_fs_1.promises.readdir((0, node_path_1.join)(process.cwd(), Logger.dirname), { withFileTypes: true })) {
-            if (Logger.streams[i.name])
-                await new Promise((res, rej) => Logger.streams[i.name].close(err => {
-                    if (err)
-                        return rej(err);
-                    res(err);
-                }));
-            await node_fs_1.promises.unlink((0, node_path_1.join)(process.cwd(), Logger.dirname, i.name)).catch(() => undefined);
-            delete Logger.streams[i.name];
+        for (const [fileName, stream] of Object.entries(Logger.streams)) {
+            if (!stream)
+                continue;
+            await new Promise((resolve, reject) => stream.close(error => {
+                if (error)
+                    return reject(error);
+                resolve();
+            }));
+            delete Logger.streams[fileName];
+        }
+        for (const entry of await node_fs_1.promises.readdir((0, node_path_1.join)(process.cwd(), Logger.dirname), { withFileTypes: true })) {
+            await node_fs_1.promises.unlink((0, node_path_1.join)(process.cwd(), Logger.dirname, entry.name)).catch(() => undefined);
         }
     }
     /**

package/lib/common/shorters/application.d.ts

@@ -17,7 +17,7 @@ export declare class ApplicationShorter extends BaseShorter {
     /**
      * Creates a new emoji for the application.
      * @param body.name The name of the emoji.
-     * @param body.image The [image data string](https://discord.com/developers/docs/reference#image-data) of the emoji.
+     * @param body.image The [image data string](https://docs.discord.com/developers/reference#image-data) of the emoji.
      * @returns The created emoji.
      */
     createEmoji(raw: ApplicationEmojiResolvable): Promise<ApplicationEmojiStructure>;

package/lib/common/shorters/application.js

@@ -37,7 +37,7 @@ class ApplicationShorter extends base_1.BaseShorter {
     /**
      * Creates a new emoji for the application.
      * @param body.name The name of the emoji.
-     * @param body.image The [image data string](https://discord.com/developers/docs/reference#image-data) of the emoji.
+     * @param body.image The [image data string](https://docs.discord.com/developers/reference#image-data) of the emoji.
      * @returns The created emoji.
      */
     async createEmoji(raw) {

package/lib/common/shorters/bans.js

@@ -12,7 +12,7 @@ class BanShorter extends base_1.BaseShorter {
      * @param reason The reason for bulk banning members.
      */
     async bulkCreate(guildId, body, reason) {
-        const bans = await this.client.proxy.guilds(guildId)['bulk-bans'].post({ reason, body });
+        const bans = await this.client.proxy.guilds(guildId)['bulk-ban'].post({ reason, body });
         await Promise.all(bans.banned_users.map(id => this.client.cache.members?.removeIfNI('GuildModeration', id, guildId)));
         return bans;
     }