seyfert 1.4.0 → 1.5.0

package/README.md

@@ -14,15 +14,15 @@
 
 # FAQ
 ## So, what is `seyfert`?
-Seyfert is the ultimate Discord framework! We make easy to interact with the Discord API, big cache control, scalable code and a pretty dev experience.
+Seyfert is the ultimate Discord framework! We make it easy to interact with the Discord API, big cache control, scalable code and a pretty dev experience.
 
-## Why I should use it?
-There are many reasons to use Seyfert, but we cannot put them all in here so there is a few of them!
+## Why should I use it?
+There are many reasons to use Seyfert, but they dont all fit in this tiny readme, so here is a list of the most awesome reasons!
 
-- **RAM Saver**
+- **Low RAM Usage**
 - **Latest features**
 - **Dev experience**
-- **24/6 support (Sunday is for going to church)**
+- **24/6 support (Sunday is for church)**
 - **Written from Scratch**
 - **Type-safe**
 - **And many more!!**
@@ -30,12 +30,12 @@ There are many reasons to use Seyfert, but we cannot put them all in here so the
 
 ## Installation
 > [!NOTE]
-> You **NEED** Node.js 18>= for this to work, also we recomended Node.js 20 LTS and Bun latest
+> You **NEED** Node.js 18>= for this to work, Node.js 20 LTS and Bun latest are recommended
 ```sh
 pnpm add seyfert
 ```
 
-> You may use your preferred package manager, for this example I am using PNPM since is more efficient.
+> You may use your preferred package manager, for this example PNMP is being used since it’s more efficient.
 
 # Useful links
 

package/lib/api/Router.js

@@ -45,7 +45,7 @@ exports.CDNRouter = {
                     return (value, options) => {
                         const lastRoute = `${common_1.CDN_URL}/${route.join('/')}`;
                         let routeResult = lastRoute;
-                        if (typeof value === 'string') {
+                        if (typeof value === 'string' || typeof value === 'number') {
                             routeResult = `${lastRoute}${value ? `/${value}` : ''}`;
                             return parseCDNURL(routeResult, options);
                         }
@@ -63,6 +63,8 @@ exports.CDNRouter = {
 function parseCDNURL(route, options = {}) {
     if (options.forceStatic && route.includes('a_'))
         options.extension = 'png';
+    if (!options.extension && route.includes('a_'))
+        options.extension = 'gif';
     const url = new URL(`${route}.${options.extension || 'png'}`);
     if (options.size)
         url.searchParams.set('size', `${options.size}`);

package/lib/api/Routes/guilds.d.ts

@@ -1,4 +1,4 @@
-import type { APIThreadChannel, RESTDeleteAPIAutoModerationRuleResult, RESTDeleteAPIGuildBanResult, RESTDeleteAPIGuildEmojiResult, RESTDeleteAPIGuildIntegrationResult, RESTDeleteAPIGuildMemberResult, RESTDeleteAPIGuildMemberRoleResult, RESTDeleteAPIGuildResult, RESTDeleteAPIGuildRoleResult, RESTDeleteAPIGuildScheduledEventResult, RESTDeleteAPIGuildStickerResult, RESTDeleteAPIGuildTemplateResult, RESTGetAPIAuditLogQuery, RESTGetAPIAuditLogResult, RESTGetAPIAutoModerationRuleResult, RESTGetAPIAutoModerationRulesResult, RESTGetAPIGuildBanResult, RESTGetAPIGuildBansQuery, RESTGetAPIGuildBansResult, RESTGetAPIGuildChannelsResult, RESTGetAPIGuildEmojiResult, RESTGetAPIGuildEmojisResult, RESTGetAPIGuildIntegrationsResult, RESTGetAPIGuildInvitesResult, RESTGetAPIGuildMemberResult, RESTGetAPIGuildMembersQuery, RESTGetAPIGuildMembersResult, RESTGetAPIGuildMembersSearchQuery, RESTGetAPIGuildMembersSearchResult, RESTGetAPIGuildPreviewResult, RESTGetAPIGuildPruneCountQuery, RESTGetAPIGuildPruneCountResult, RESTGetAPIGuildQuery, RESTGetAPIGuildResult, RESTGetAPIGuildRolesResult, RESTGetAPIGuildScheduledEventQuery, RESTGetAPIGuildScheduledEventResult, RESTGetAPIGuildScheduledEventUsersQuery, RESTGetAPIGuildScheduledEventUsersResult, RESTGetAPIGuildScheduledEventsQuery, RESTGetAPIGuildScheduledEventsResult, RESTGetAPIGuildStickerResult, RESTGetAPIGuildStickersResult, RESTGetAPIGuildTemplatesResult, RESTGetAPIGuildThreadsResult, RESTGetAPIGuildVanityUrlResult, RESTGetAPIGuildVoiceRegionsResult, RESTGetAPIGuildWebhooksResult, RESTGetAPIGuildWelcomeScreenResult, RESTGetAPIGuildWidgetImageQuery, RESTGetAPIGuildWidgetImageResult, RESTGetAPIGuildWidgetJSONResult, RESTGetAPIGuildWidgetSettingsResult, RESTGetAPITemplateResult, RESTPatchAPIAutoModerationRuleJSONBody, RESTPatchAPIAutoModerationRuleResult, RESTPatchAPICurrentGuildMemberJSONBody, RESTPatchAPIGuildChannelPositionsJSONBody, RESTPatchAPIGuildChannelPositionsResult, RESTPatchAPIGuildEmojiJSONBody, RESTPatchAPIGuildEmojiResult, RESTPatchAPIGuildJSONBody, RESTPatchAPIGuildMemberJSONBody, RESTPatchAPIGuildMemberResult, RESTPatchAPIGuildResult, RESTPatchAPIGuildRoleJSONBody, RESTPatchAPIGuildRolePositionsJSONBody, RESTPatchAPIGuildRolePositionsResult, RESTPatchAPIGuildRoleResult, RESTPatchAPIGuildScheduledEventJSONBody, RESTPatchAPIGuildScheduledEventResult, RESTPatchAPIGuildStickerJSONBody, RESTPatchAPIGuildStickerResult, RESTPatchAPIGuildTemplateJSONBody, RESTPatchAPIGuildTemplateResult, RESTPatchAPIGuildVoiceStateCurrentMemberJSONBody, RESTPatchAPIGuildVoiceStateCurrentMemberResult, RESTPatchAPIGuildVoiceStateUserJSONBody, RESTPatchAPIGuildVoiceStateUserResult, RESTPatchAPIGuildWelcomeScreenJSONBody, RESTPatchAPIGuildWelcomeScreenResult, RESTPatchAPIGuildWidgetSettingsJSONBody, RESTPatchAPIGuildWidgetSettingsResult, RESTPostAPIAutoModerationRuleJSONBody, RESTPostAPIAutoModerationRuleResult, RESTPostAPIGuildChannelJSONBody, RESTPostAPIGuildChannelResult, RESTPostAPIGuildEmojiJSONBody, RESTPostAPIGuildEmojiResult, RESTPostAPIGuildPruneJSONBody, RESTPostAPIGuildPruneResult, RESTPostAPIGuildRoleJSONBody, RESTPostAPIGuildRoleResult, RESTPostAPIGuildScheduledEventJSONBody, RESTPostAPIGuildScheduledEventResult, RESTPostAPIGuildStickerFormDataBody, RESTPostAPIGuildStickerResult, RESTPostAPIGuildTemplatesJSONBody, RESTPostAPIGuildTemplatesResult, RESTPostAPIGuildsJSONBody, RESTPostAPIGuildsMFAJSONBody, RESTPostAPIGuildsMFAResult, RESTPostAPIGuildsResult, RESTPostAPITemplateCreateGuildJSONBody, RESTPostAPITemplateCreateGuildResult, RESTPutAPIGuildBanJSONBody, RESTPutAPIGuildBanResult, RESTPutAPIGuildMemberJSONBody, RESTPutAPIGuildMemberResult, RESTPutAPIGuildMemberRoleResult, RESTPutAPIGuildTemplateSyncResult } from 'discord-api-types/v10';
+import type { APIThreadChannel, RESTDeleteAPIAutoModerationRuleResult, RESTDeleteAPIGuildBanResult, RESTDeleteAPIGuildEmojiResult, RESTDeleteAPIGuildIntegrationResult, RESTDeleteAPIGuildMemberResult, RESTDeleteAPIGuildMemberRoleResult, RESTDeleteAPIGuildResult, RESTDeleteAPIGuildRoleResult, RESTDeleteAPIGuildScheduledEventResult, RESTDeleteAPIGuildStickerResult, RESTDeleteAPIGuildTemplateResult, RESTGetAPIAuditLogQuery, RESTGetAPIAuditLogResult, RESTGetAPIAutoModerationRuleResult, RESTGetAPIAutoModerationRulesResult, RESTGetAPIGuildBanResult, RESTGetAPIGuildBansQuery, RESTGetAPIGuildBansResult, RESTGetAPIGuildChannelsResult, RESTGetAPIGuildEmojiResult, RESTGetAPIGuildEmojisResult, RESTGetAPIGuildIntegrationsResult, RESTGetAPIGuildInvitesResult, RESTGetAPIGuildMemberResult, RESTGetAPIGuildMembersQuery, RESTGetAPIGuildMembersResult, RESTGetAPIGuildMembersSearchQuery, RESTGetAPIGuildMembersSearchResult, RESTGetAPIGuildPreviewResult, RESTGetAPIGuildPruneCountQuery, RESTGetAPIGuildPruneCountResult, RESTGetAPIGuildQuery, RESTGetAPIGuildResult, RESTGetAPIGuildRolesResult, RESTGetAPIGuildScheduledEventQuery, RESTGetAPIGuildScheduledEventResult, RESTGetAPIGuildScheduledEventUsersQuery, RESTGetAPIGuildScheduledEventUsersResult, RESTGetAPIGuildScheduledEventsQuery, RESTGetAPIGuildScheduledEventsResult, RESTGetAPIGuildStickerResult, RESTGetAPIGuildStickersResult, RESTGetAPIGuildTemplatesResult, RESTGetAPIGuildThreadsResult, RESTGetAPIGuildVanityUrlResult, RESTGetAPIGuildVoiceRegionsResult, RESTGetAPIGuildWebhooksResult, RESTGetAPIGuildWelcomeScreenResult, RESTGetAPIGuildWidgetImageQuery, RESTGetAPIGuildWidgetImageResult, RESTGetAPIGuildWidgetJSONResult, RESTGetAPIGuildWidgetSettingsResult, RESTGetAPITemplateResult, RESTPatchAPIAutoModerationRuleJSONBody, RESTPatchAPIAutoModerationRuleResult, RESTPatchAPICurrentGuildMemberJSONBody, RESTPatchAPIGuildChannelPositionsJSONBody, RESTPatchAPIGuildChannelPositionsResult, RESTPatchAPIGuildEmojiJSONBody, RESTPatchAPIGuildEmojiResult, RESTPatchAPIGuildJSONBody, RESTPatchAPIGuildMemberJSONBody, RESTPatchAPIGuildMemberResult, RESTPatchAPIGuildResult, RESTPatchAPIGuildRoleJSONBody, RESTPatchAPIGuildRolePositionsJSONBody, RESTPatchAPIGuildRolePositionsResult, RESTPatchAPIGuildRoleResult, RESTPatchAPIGuildScheduledEventJSONBody, RESTPatchAPIGuildScheduledEventResult, RESTPatchAPIGuildStickerJSONBody, RESTPatchAPIGuildStickerResult, RESTPatchAPIGuildTemplateJSONBody, RESTPatchAPIGuildTemplateResult, RESTPatchAPIGuildVoiceStateCurrentMemberJSONBody, RESTPatchAPIGuildVoiceStateCurrentMemberResult, RESTPatchAPIGuildVoiceStateUserJSONBody, RESTPatchAPIGuildVoiceStateUserResult, RESTPatchAPIGuildWelcomeScreenJSONBody, RESTPatchAPIGuildWelcomeScreenResult, RESTPatchAPIGuildWidgetSettingsJSONBody, RESTPatchAPIGuildWidgetSettingsResult, RESTPostAPIAutoModerationRuleJSONBody, RESTPostAPIAutoModerationRuleResult, RESTPostAPIGuildBulkBanJSONBody, RESTPostAPIGuildBulkBanResult, RESTPostAPIGuildChannelJSONBody, RESTPostAPIGuildChannelResult, RESTPostAPIGuildEmojiJSONBody, RESTPostAPIGuildEmojiResult, RESTPostAPIGuildPruneJSONBody, RESTPostAPIGuildPruneResult, RESTPostAPIGuildRoleJSONBody, RESTPostAPIGuildRoleResult, RESTPostAPIGuildScheduledEventJSONBody, RESTPostAPIGuildScheduledEventResult, RESTPostAPIGuildStickerFormDataBody, RESTPostAPIGuildStickerResult, RESTPostAPIGuildTemplatesJSONBody, RESTPostAPIGuildTemplatesResult, RESTPostAPIGuildsJSONBody, RESTPostAPIGuildsMFAJSONBody, RESTPostAPIGuildsMFAResult, RESTPostAPIGuildsResult, RESTPostAPITemplateCreateGuildJSONBody, RESTPostAPITemplateCreateGuildResult, RESTPutAPIGuildBanJSONBody, RESTPutAPIGuildBanResult, RESTPutAPIGuildMemberJSONBody, RESTPutAPIGuildMemberResult, RESTPutAPIGuildMemberRoleResult, RESTPutAPIGuildTemplateSyncResult } from 'discord-api-types/v10';
 import type { Identify, OmitInsert } from '../../common';
 import type { ProxyRequestMethod } from '../Router';
 import type { RestArguments } from '../api';
@@ -82,6 +82,9 @@ export interface GuildRoutes {
                     delete(args?: RestArguments<ProxyRequestMethod.Delete>): Promise<RESTDeleteAPIGuildBanResult>;
                 };
             };
+            'bulk-bans': {
+                post(args: RestArguments<ProxyRequestMethod.Post, RESTPostAPIGuildBulkBanJSONBody>): Promise<RESTPostAPIGuildBulkBanResult>;
+            };
             mfa: {
                 post(args: RestArguments<ProxyRequestMethod.Post, RESTPostAPIGuildsMFAJSONBody>): Promise<RESTPostAPIGuildsMFAResult>;
             };

package/lib/cache/index.d.ts

@@ -11,6 +11,7 @@ import { StageInstances } from './resources/stage-instances';
 import { Stickers } from './resources/stickers';
 import { Threads } from './resources/threads';
 import { VoiceStates } from './resources/voice-states';
+import { Bans } from './resources/bans';
 import { GatewayIntentBits, type GatewayDispatchPayload } from 'discord-api-types/v10';
 import type { InternalOptions, UsingClient } from '../commands';
 import { Overwrites } from './resources/overwrites';
@@ -20,10 +21,10 @@ export type InferAsyncCache = InternalOptions extends {
 } ? P : false;
 export type ReturnCache<T> = If<InferAsyncCache, Promise<T>, T>;
 export type GuildBased = 'members' | 'voiceStates';
-export type GuildRelated = 'emojis' | 'roles' | 'threads' | 'channels' | 'stickers' | 'presences' | 'stageInstances' | 'overwrites' | 'messages';
+export type GuildRelated = 'emojis' | 'roles' | 'threads' | 'channels' | 'stickers' | 'presences' | 'stageInstances' | 'overwrites' | 'messages' | 'bans';
 export type NonGuildBased = 'users' | 'guilds';
 export * from './adapters/index';
-export type CachedEvents = 'READY' | 'GUILD_CREATE' | 'GUILD_UPDATE' | 'GUILD_DELETE' | 'CHANNEL_CREATE' | 'CHANNEL_UPDATE' | 'CHANNEL_DELETE' | 'GUILD_ROLE_CREATE' | 'GUILD_ROLE_UPDATE' | 'GUILD_ROLE_DELETE' | 'GUILD_EMOJIS_UPDATE' | 'GUILD_STICKERS_UPDATE' | 'GUILD_MEMBER_ADD' | 'GUILD_MEMBER_UPDATE' | 'GUILD_MEMBER_REMOVE' | 'MESSAGE_CREATE' | 'PRESENCE_UPDATE' | 'THREAD_DELETE' | 'THREAD_CREATE' | 'THREAD_UPDATE' | 'USER_UPDATE' | 'VOICE_STATE_UPDATE' | 'STAGE_INSTANCE_CREATE' | 'STAGE_INSTANCE_UPDATE' | 'STAGE_INSTANCE_DELETE';
+export type CachedEvents = 'READY' | 'GUILD_CREATE' | 'GUILD_UPDATE' | 'GUILD_DELETE' | 'CHANNEL_CREATE' | 'CHANNEL_UPDATE' | 'CHANNEL_DELETE' | 'GUILD_ROLE_CREATE' | 'GUILD_ROLE_UPDATE' | 'GUILD_ROLE_DELETE' | 'GUILD_BAN_ADD' | 'GUILD_BAN_REMOVE' | 'GUILD_EMOJIS_UPDATE' | 'GUILD_STICKERS_UPDATE' | 'GUILD_MEMBER_ADD' | 'GUILD_MEMBER_UPDATE' | 'GUILD_MEMBER_REMOVE' | 'MESSAGE_CREATE' | 'PRESENCE_UPDATE' | 'THREAD_DELETE' | 'THREAD_CREATE' | 'THREAD_UPDATE' | 'USER_UPDATE' | 'VOICE_STATE_UPDATE' | 'STAGE_INSTANCE_CREATE' | 'STAGE_INSTANCE_UPDATE' | 'STAGE_INSTANCE_DELETE';
 export declare class Cache {
     intents: number;
     adapter: Adapter;
@@ -41,6 +42,7 @@ export declare class Cache {
     presences?: Presences;
     stageInstances?: StageInstances;
     messages?: Messages;
+    bans?: Bans;
     constructor(intents: number, adapter: Adapter, disabledCache?: (NonGuildBased | GuildBased | GuildRelated)[], client?: UsingClient);
     flush(): ReturnCache<void>;
     hasIntent(intent: keyof typeof GatewayIntentBits): boolean;
@@ -52,6 +54,7 @@ export declare class Cache {
     get hasVoiceStatesIntent(): boolean;
     get hasPrenseceUpdates(): boolean;
     get hasDirectMessages(): boolean;
+    get hasBansIntent(): boolean;
     bulkGet(keys: (readonly [
         NonGuildBased | GuildRelated,
         string
@@ -74,6 +77,7 @@ export declare class Cache {
             guild_id: string;
         })[];
         threads: import("..").ThreadChannel[];
+        bans: import("../structures/GuildBan").GuildBan[];
         voiceStates: import("..").VoiceState[];
         stageInstances: (import("discord-api-types/v10").APIStageInstance & {
             guild_id: string;

package/lib/cache/index.js

@@ -26,6 +26,7 @@ const stage_instances_1 = require("./resources/stage-instances");
 const stickers_1 = require("./resources/stickers");
 const threads_1 = require("./resources/threads");
 const voice_states_1 = require("./resources/voice-states");
+const bans_1 = require("./resources/bans");
 const v10_1 = require("discord-api-types/v10");
 const overwrites_1 = require("./resources/overwrites");
 const messages_1 = require("./resources/messages");
@@ -50,6 +51,7 @@ class Cache {
     presences;
     stageInstances;
     messages;
+    bans;
     constructor(intents, adapter, disabledCache = [], client) {
         this.intents = intents;
         this.adapter = adapter;
@@ -96,6 +98,9 @@ class Cache {
         if (!this.disabledCache.includes('messages')) {
             this.messages = new messages_1.Messages(this, client);
         }
+        if (!this.disabledCache.includes('bans')) {
+            this.bans = new bans_1.Bans(this, client);
+        }
     }
     /** @internal */
     __setClient(client) {
@@ -112,6 +117,7 @@ class Cache {
         this.threads?.__setClient(client);
         this.stageInstances?.__setClient(client);
         this.messages?.__setClient(client);
+        this.bans?.__setClient(client);
     }
     flush() {
         return this.adapter.flush();
@@ -144,6 +150,9 @@ class Cache {
     get hasDirectMessages() {
         return this.hasIntent('DirectMessages');
     }
+    get hasBansIntent() {
+        return this.hasIntent('GuildBans');
+    }
     async bulkGet(keys) {
         const allData = {};
         for (const [type, id, guildId] of keys) {
@@ -167,6 +176,7 @@ class Cache {
                 case 'users':
                 case 'guilds':
                 case 'overwrites':
+                case 'bans':
                 case 'messages':
                     {
                         if (!allData[type]) {
@@ -207,6 +217,7 @@ class Cache {
                 case 'stageInstances':
                 case 'emojis':
                 case 'overwrites':
+                case 'bans':
                 case 'messages':
                     {
                         if (!this[type]?.filter(data, id, guildId))
@@ -278,6 +289,7 @@ class Cache {
                 case 'stageInstances':
                 case 'emojis':
                 case 'overwrites':
+                case 'bans':
                 case 'messages':
                     {
                         if (!this[type]?.filter(data, id, guildId))
@@ -376,6 +388,12 @@ class Cache {
             case 'GUILD_ROLE_DELETE':
                 await this.roles?.remove(event.d.role_id, event.d.guild_id);
                 break;
+            case 'GUILD_BAN_ADD':
+                await this.bans?.set(event.d.user.id, event.d.guild_id, event.d);
+                break;
+            case 'GUILD_BAN_REMOVE':
+                await this.bans?.remove(event.d.user.id, event.d.guild_id);
+                break;
             case 'GUILD_EMOJIS_UPDATE':
                 await this.emojis?.remove(await this.emojis?.keys(event.d.guild_id), event.d.guild_id);
                 await this.emojis?.set(event.d.emojis.map(x => [x.id, x]), event.d.guild_id);

package/lib/cache/resources/bans.d.ts

@@ -0,0 +1,12 @@
+import type { APIBan } from 'discord-api-types/v10';
+import type { ReturnCache } from '../..';
+import { GuildBasedResource } from './default/guild-based';
+import { GuildBan } from '../../structures/GuildBan';
+export declare class Bans extends GuildBasedResource {
+    namespace: string;
+    filter(data: APIBan, id: string, guild_id: string): boolean;
+    parse(data: any, key: string, guild_id: string): any;
+    get(id: string, guild: string): ReturnCache<GuildBan | undefined>;
+    bulk(ids: string[], guild: string): ReturnCache<GuildBan[]>;
+    values(guild: string): ReturnCache<GuildBan[]>;
+}

package/lib/cache/resources/bans.js

@@ -0,0 +1,35 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.Bans = void 0;
+const common_1 = require("../../common");
+const guild_based_1 = require("./default/guild-based");
+const GuildBan_1 = require("../../structures/GuildBan");
+class Bans extends guild_based_1.GuildBasedResource {
+    namespace = 'ban';
+    //@ts-expect-error
+    filter(data, id, guild_id) {
+        return true;
+    }
+    parse(data, key, guild_id) {
+        const { user, ...rest } = super.parse(data, data.user?.id ?? key, guild_id);
+        return rest;
+    }
+    get(id, guild) {
+        return (0, common_1.fakePromise)(super.get(id, guild)).then(rawBan => rawBan ? new GuildBan_1.GuildBan(this.client, rawBan, guild) : undefined);
+    }
+    bulk(ids, guild) {
+        return (0, common_1.fakePromise)(super.bulk(ids, guild)).then(bans => bans
+            .map(rawBan => {
+            return rawBan ? new GuildBan_1.GuildBan(this.client, rawBan, guild) : undefined;
+        })
+            .filter(Boolean));
+    }
+    values(guild) {
+        return (0, common_1.fakePromise)(super.values(guild)).then(bans => bans
+            .map(rawBan => {
+            return rawBan ? new GuildBan_1.GuildBan(this.client, rawBan, guild) : undefined;
+        })
+            .filter(Boolean));
+    }
+}
+exports.Bans = Bans;

package/lib/cache/resources/members.js

@@ -18,17 +18,17 @@ class Members extends guild_based_1.GuildBasedResource {
         return (0, common_1.fakePromise)(super.get(id, guild)).then(rawMember => (0, common_1.fakePromise)(this.client.cache.users?.get(id)).then(user => rawMember && user ? new structures_1.GuildMember(this.client, rawMember, user, guild) : undefined));
     }
     bulk(ids, guild) {
-        return (0, common_1.fakePromise)(super.bulk(ids, guild)).then(members => (0, common_1.fakePromise)(this.client.cache.users?.bulk(ids) ?? []).then(users => members
+        return (0, common_1.fakePromise)(super.bulk(ids, guild)).then(members => (0, common_1.fakePromise)(this.client.cache.users?.bulk(ids)).then(users => members
             .map(rawMember => {
-            const user = users.find(x => x.id === rawMember.id);
+            const user = users?.find(x => x.id === rawMember.id);
             return user ? new structures_1.GuildMember(this.client, rawMember, user, guild) : undefined;
         })
             .filter(Boolean)));
     }
     values(guild) {
-        return (0, common_1.fakePromise)(super.values(guild)).then(members => (0, common_1.fakePromise)(this.client.cache.users?.values() ?? []).then(users => members
+        return (0, common_1.fakePromise)(super.values(guild)).then(members => (0, common_1.fakePromise)(this.client.cache.users?.values()).then(users => members
             .map(rawMember => {
-            const user = users.find(x => x.id === rawMember.id);
+            const user = users?.find(x => x.id === rawMember.id);
             return user ? new structures_1.GuildMember(this.client, rawMember, user, rawMember.guild_id) : undefined;
         })
             .filter(Boolean)));

package/lib/cache/resources/messages.js

@@ -18,19 +18,21 @@ class Messages extends guild_related_1.GuildRelatedResource {
     }
     get(id) {
         return (0, common_1.fakePromise)(super.get(id)).then(rawMessage => {
-            const user = this.cache.users && rawMessage?.user_id
-                ? this.cache.adapter.get(this.cache.users.hashId(rawMessage.user_id))
+            return this.cache.users && rawMessage?.user_id
+                ? (0, common_1.fakePromise)(this.cache.adapter.get(this.cache.users.hashId(rawMessage.user_id))).then(user => {
+                    return user ? new structures_1.Message(this.client, { ...rawMessage, author: user }) : undefined;
+                })
                 : undefined;
-            return user ? new structures_1.Message(this.client, { ...rawMessage, author: user }) : undefined;
         });
     }
     bulk(ids) {
         return (0, common_1.fakePromise)(super.bulk(ids)).then(messages => messages
             .map(rawMessage => {
-            const user = this.cache.users && rawMessage.user_id
-                ? this.cache.adapter.get(this.cache.users.hashId(rawMessage.user_id))
+            return this.cache.users && rawMessage?.user_id
+                ? (0, common_1.fakePromise)(this.cache.adapter.get(this.cache.users.hashId(rawMessage.user_id))).then(user => {
+                    return user ? new structures_1.Message(this.client, { ...rawMessage, author: user }) : undefined;
+                })
                 : undefined;
-            return user ? new structures_1.Message(this.client, { ...rawMessage, author: user }) : undefined;
         })
             .filter(Boolean));
     }

package/lib/client/base.d.ts

@@ -1,16 +1,17 @@
 import { ApiHandler } from '../api';
 import type { Adapter } from '../cache';
 import { Cache } from '../cache';
-import type { Command, RegisteredMiddlewares } from '../commands';
+import type { Command, ExtraProps, RegisteredMiddlewares } from '../commands';
 import { type InferWithPrefix, type MiddlewareContext } from '../commands/applications/shared';
 import { CommandHandler } from '../commands/handler';
 import { ChannelShorter, EmojiShorter, GuildShorter, InteractionShorter, Logger, MemberShorter, MessageShorter, ReactionShorter, RoleShorter, TemplateShorter, ThreadShorter, UsersShorter, WebhookShorter, type MakeRequired } from '../common';
 import type { LocaleString, RESTPostAPIChannelMessageJSONBody } from 'discord-api-types/rest/v10';
-import type { DeepPartial, IntentStrings, OmitInsert, When } from '../common/types/util';
+import type { Awaitable, DeepPartial, IntentStrings, OmitInsert, When } from '../common/types/util';
 import { ComponentHandler } from '../components/handler';
 import { LangsHandler } from '../langs/handler';
 import type { ChatInputCommandInteraction, ComponentInteraction, Message, MessageCommandInteraction, ModalSubmitInteraction, UserCommandInteraction } from '../structures';
 import type { ComponentCommand, ModalCommand } from '../components';
+import { BanShorter } from '../common/shorters/bans';
 export declare class BaseClient {
     rest: ApiHandler;
     cache: Cache;
@@ -25,6 +26,7 @@ export declare class BaseClient {
     reactions: ReactionShorter;
     emojis: EmojiShorter;
     threads: ThreadShorter;
+    bans: BanShorter;
     interactions: InteractionShorter;
     debugger?: Logger;
     logger: Logger;
@@ -43,7 +45,7 @@ export declare class BaseClient {
     set applicationId(id: string);
     get applicationId(): string;
     get proxy(): import("../api").APIRoutes;
-    setServices({ rest, cache, langs, middlewares, handlers }: ServicesOptions): void;
+    setServices({ rest, cache, langs, middlewares, handlers, }: ServicesOptions): void;
     protected execute(..._options: unknown[]): Promise<void>;
     start(options?: Pick<DeepPartial<StartOptions>, 'langsDir' | 'commandsDir' | 'connection' | 'token' | 'componentsDir'>): Promise<void>;
     protected onPacket(..._packet: unknown[]): Promise<void>;
@@ -79,6 +81,7 @@ export interface BaseClientOptions {
             onMiddlewaresError?: Command['onMiddlewaresError'];
             onOptionsError?: Command['onOptionsError'];
             onAfterRun?: Command['onAfterRun'];
+            props?: ExtraProps;
         };
     };
     components?: {
@@ -100,6 +103,7 @@ export interface BaseClientOptions {
     allowedMentions?: Omit<NonNullable<RESTPostAPIChannelMessageJSONBody['allowed_mentions']>, 'parse'> & {
         parse?: ('everyone' | 'roles' | 'users')[];
     };
+    getRC?(): Awaitable<InternalRuntimeConfig | InternalRuntimeConfigHTTP>;
 }
 export interface StartOptions {
     eventsDir: string;

package/lib/client/base.js

@@ -10,6 +10,7 @@ const common_1 = require("../common");
 const handler_2 = require("../components/handler");
 const handler_3 = require("../langs/handler");
 const node_fs_1 = require("node:fs");
+const bans_1 = require("../common/shorters/bans");
 class BaseClient {
     rest;
     cache;
@@ -24,6 +25,7 @@ class BaseClient {
     reactions = new common_1.ReactionShorter(this);
     emojis = new common_1.EmojiShorter(this);
     threads = new common_1.ThreadShorter(this);
+    bans = new bans_1.BanShorter(this);
     interactions = new common_1.InteractionShorter(this);
     debugger;
     logger = new common_1.Logger({
@@ -45,7 +47,7 @@ class BaseClient {
     }
     options;
     /**@internal */
-    static _seyferHttpConfig;
+    static _seyfertConfig;
     constructor(options) {
         this.options = (0, common_1.MergeOptions)({
             commands: {
@@ -102,7 +104,7 @@ class BaseClient {
         this._botId = id;
     }
     get botId() {
-        return this._botId ?? BaseClient.getBotIdFromToken(this.rest.options.token);
+        return (this._botId ?? BaseClient.getBotIdFromToken(this.rest.options.token));
     }
     set applicationId(id) {
         this._applicationId = id;
@@ -113,7 +115,7 @@ class BaseClient {
     get proxy() {
         return new api_1.Router(this.rest).createProxy();
     }
-    setServices({ rest, cache, langs, middlewares, handlers }) {
+    setServices({ rest, cache, langs, middlewares, handlers, }) {
         if (rest) {
             this.rest = rest;
         }
@@ -130,7 +132,9 @@ class BaseClient {
                 }
                 else if (typeof handlers.components === 'function') {
                     this.components ??= new handler_2.ComponentHandler(this.logger, this);
-                    this.components.setHandlers({ callback: handlers.components });
+                    this.components.setHandlers({
+                        callback: handlers.components,
+                    });
                 }
                 else {
                     this.components = handlers.components;
@@ -197,11 +201,11 @@ class BaseClient {
                 debug: (await this.getRC()).debug,
             });
         }
-        if (!this.cache) {
-            this.cache = new cache_1.Cache(0, new cache_1.MemoryAdapter(), [], this);
+        if (this.cache) {
+            this.cache.__setClient(this);
         }
         else {
-            this.cache.__setClient(this);
+            this.cache = new cache_1.Cache(0, new cache_1.MemoryAdapter(), [], this);
         }
     }
     async onPacket(..._packet) {
@@ -210,17 +214,19 @@ class BaseClient {
     shouldUploadCommands(cachePath) {
         return this.commands.shouldUpload(cachePath).then(async (should) => {
             if (should)
-                await node_fs_1.promises.writeFile(cachePath, JSON.stringify(this.commands.values.map(x => x.toJSON())));
+                await node_fs_1.promises.writeFile(cachePath, JSON.stringify(this.commands.values.map((x) => x.toJSON())));
             return should;
         });
     }
     async uploadCommands(applicationId) {
-        applicationId ??= await this.getRC().then(x => x.applicationId ?? this.applicationId);
+        applicationId ??= await this.getRC().then((x) => x.applicationId ?? this.applicationId);
         BaseClient.assertString(applicationId, 'applicationId is not a string');
         const commands = this.commands.values;
-        const filter = (0, common_1.filterSplit)(commands, command => !command.guildId);
+        const filter = (0, common_1.filterSplit)(commands, (command) => !command.guildId);
         await this.proxy.applications(applicationId).commands.put({
-            body: filter.expect.filter(cmd => !('ignore' in cmd) || cmd.ignore !== shared_1.IgnoreCommand.Slash).map(x => x.toJSON()),
+            body: filter.expect
+                .filter((cmd) => !('ignore' in cmd) || cmd.ignore !== shared_1.IgnoreCommand.Slash)
+                .map((x) => x.toJSON()),
         });
         const guilds = new Set();
         for (const command of filter.never) {
@@ -234,27 +240,29 @@ class BaseClient {
                 .guilds(guild)
                 .commands.put({
                 body: filter.never
-                    .filter(cmd => cmd.guildId?.includes(guild) && (!('ignore' in cmd) || cmd.ignore !== shared_1.IgnoreCommand.Slash))
-                    .map(x => x.toJSON()),
+                    .filter((cmd) => cmd.guildId?.includes(guild) &&
+                    (!('ignore' in cmd) ||
+                        cmd.ignore !== shared_1.IgnoreCommand.Slash))
+                    .map((x) => x.toJSON()),
             });
         }
     }
     async loadCommands(dir) {
-        dir ??= await this.getRC().then(x => x.commands);
+        dir ??= await this.getRC().then((x) => x.commands);
         if (dir && this.commands) {
             await this.commands.load(dir, this);
             this.logger.info('CommandHandler loaded');
         }
     }
     async loadComponents(dir) {
-        dir ??= await this.getRC().then(x => x.components);
+        dir ??= await this.getRC().then((x) => x.components);
         if (dir && this.components) {
             await this.components.load(dir);
             this.logger.info('ComponentHandler loaded');
         }
     }
     async loadLangs(dir) {
-        dir ??= await this.getRC().then(x => x.langs);
+        dir ??= await this.getRC().then((x) => x.langs);
         if (dir && this.langs) {
             await this.langs.load(dir);
             this.logger.info('LangsHandler loaded');
@@ -264,21 +272,32 @@ class BaseClient {
         return this.langs.get(locale);
     }
     async getRC() {
-        const seyfertConfig = (BaseClient._seyferHttpConfig ||
-            (await (0, common_1.magicImport)((0, node_path_1.join)(process.cwd(), 'seyfert.config.js')).then(x => x.default ?? x)));
+        const seyfertConfig = (BaseClient._seyfertConfig ||
+            (await this.options.getRC?.()) ||
+            (await (0, common_1.magicImport)((0, node_path_1.join)(process.cwd(), 'seyfert.config.js')).then((x) => x.default ?? x)));
         const { locations, debug, ...env } = seyfertConfig;
         const obj = {
             debug: !!debug,
             ...env,
-            templates: locations.templates ? (0, node_path_1.join)(process.cwd(), locations.base, locations.templates) : undefined,
-            langs: locations.langs ? (0, node_path_1.join)(process.cwd(), locations.output, locations.langs) : undefined,
-            events: 'events' in locations && locations.events ? (0, node_path_1.join)(process.cwd(), locations.output, locations.events) : undefined,
-            components: locations.components ? (0, node_path_1.join)(process.cwd(), locations.output, locations.components) : undefined,
-            commands: locations.commands ? (0, node_path_1.join)(process.cwd(), locations.output, locations.commands) : undefined,
+            templates: locations.templates
+                ? (0, node_path_1.join)(process.cwd(), locations.base, locations.templates)
+                : undefined,
+            langs: locations.langs
+                ? (0, node_path_1.join)(process.cwd(), locations.output, locations.langs)
+                : undefined,
+            events: 'events' in locations && locations.events
+                ? (0, node_path_1.join)(process.cwd(), locations.output, locations.events)
+                : undefined,
+            components: locations.components
+                ? (0, node_path_1.join)(process.cwd(), locations.output, locations.components)
+                : undefined,
+            commands: locations.commands
+                ? (0, node_path_1.join)(process.cwd(), locations.output, locations.commands)
+                : undefined,
             base: (0, node_path_1.join)(process.cwd(), locations.base),
             output: (0, node_path_1.join)(process.cwd(), locations.output),
         };
-        BaseClient._seyferHttpConfig = seyfertConfig;
+        BaseClient._seyfertConfig = seyfertConfig;
         return obj;
     }
 }

package/lib/client/client.d.ts

@@ -1,6 +1,6 @@
-import { type GatewayDispatchPayload, type GatewayPresenceUpdateData } from 'discord-api-types/v10';
-import type { Command, CommandContext, Message, SubCommand } from '..';
-import { type DeepPartial, type If } from '../common';
+import { type APIApplicationCommandInteractionDataOption, type GatewayMessageCreateDispatchData, type GatewayDispatchPayload, type GatewayPresenceUpdateData } from 'discord-api-types/v10';
+import type { Command, CommandContext, ContextOptionsResolved, Message, MessageCommandOptionErrors, SubCommand, UsingClient } from '..';
+import { type Awaitable, type MakeRequired, type DeepPartial, type If } from '../common';
 import { EventHandler } from '../events';
 import { ClientUser } from '../structures';
 import { ShardManager, type ShardManagerOptions } from '../websocket';
@@ -8,14 +8,18 @@ import { MemberUpdateHandler } from '../websocket/discord/events/memberUpdate';
 import { PresenceUpdateHandler } from '../websocket/discord/events/presenceUpdate';
 import type { BaseClientOptions, ServicesOptions, StartOptions } from './base';
 import { BaseClient } from './base';
+import { Collectors } from './collectors';
 export declare class Client<Ready extends boolean = boolean> extends BaseClient {
     private __handleGuilds?;
     gateway: ShardManager;
-    events?: EventHandler | undefined;
     me: If<Ready, ClientUser>;
-    options: ClientOptions;
+    options: Omit<ClientOptions, 'commands'> & {
+        commands: MakeRequired<NonNullable<ClientOptions['commands']>, 'argsParser' | 'optionsParser'>;
+    };
     memberUpdateHandler: MemberUpdateHandler;
     presenceUpdateHandler: PresenceUpdateHandler;
+    collectors: Collectors;
+    events?: EventHandler | undefined;
     constructor(options?: ClientOptions);
     setServices({ gateway, ...rest }: ServicesOptions & {
         gateway?: ShardManager;
@@ -47,6 +51,14 @@ export interface ClientOptions extends BaseClientOptions {
         deferReplyResponse?: (ctx: CommandContext) => Parameters<Message['write']>[0];
         reply?: (ctx: CommandContext) => boolean;
         argsParser?: (content: string, command: SubCommand | Command, message: Message) => Record<string, string>;
+        optionsParser?: (self: UsingClient, command: Command | SubCommand, message: GatewayMessageCreateDispatchData, args: Partial<Record<string, string>>, resolved: MakeRequired<ContextOptionsResolved>) => Awaitable<{
+            errors: {
+                name: string;
+                error: string;
+                fullError: MessageCommandOptionErrors;
+            }[];
+            options: APIApplicationCommandInteractionDataOption[];
+        }>;
     };
     handlePayload?: ShardManagerOptions['handlePayload'];
 }