seyfert 1.3.3 → 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/api/api.js

@@ -3,14 +3,14 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.ApiHandler = void 0;
 const magic_bytes_js_1 = require("magic-bytes.js");
 const node_crypto_1 = require("node:crypto");
-const promises_1 = require("node:timers/promises");
-const node_worker_threads_1 = require("node:worker_threads");
 const common_1 = require("../common");
 const functions_1 = require("../structures/extra/functions");
 const Router_1 = require("./Router");
 const bucket_1 = require("./bucket");
 const shared_1 = require("./shared");
 const utils_1 = require("./utils/utils");
+let parentPort;
+let workerData;
 class ApiHandler {
     options;
     globalBlock = false;
@@ -32,10 +32,16 @@ class ApiHandler {
                 name: '[API]',
             });
         }
-        if (options.workerProxy && !node_worker_threads_1.parentPort)
+        const worker_threads = (0, common_1.lazyLoadPackage)('node:worker_threads');
+        if (options.workerProxy && !worker_threads?.parentPort)
             throw new Error('Cannot use workerProxy without a parent.');
         if (options.workerProxy)
             this.workerPromises = new Map();
+        if (worker_threads) {
+            workerData = worker_threads.workerData;
+            if (worker_threads.parentPort)
+                parentPort = worker_threads.parentPort;
+        }
     }
     globalUnblock() {
         this.globalBlock = false;
@@ -53,11 +59,11 @@ class ApiHandler {
     async request(method, url, { auth = true, ...request } = {}) {
         if (this.options.workerProxy) {
             const nonce = this.#randomUUID();
-            node_worker_threads_1.parentPort.postMessage({
+            parentPort.postMessage({
                 method,
                 url,
                 type: 'WORKER_API_REQUEST',
-                workerId: node_worker_threads_1.workerData.workerId,
+                workerId: workerData.workerId,
                 nonce,
                 requestOptions: { auth, ...request },
             }, request.files
@@ -182,7 +188,7 @@ class ApiHandler {
         const wait = Math.floor(Math.random() * 1900 + 100);
         this.debugger?.warn(`Handling a 50X status, retrying in ${wait}ms`);
         next();
-        await (0, promises_1.setTimeout)(wait);
+        await (0, common_1.delay)(wait);
         return this.request(method, url, {
             body: request.body,
             auth: request.auth,
@@ -204,7 +210,7 @@ class ApiHandler {
         }
         this.debugger?.info(`${response.headers.get('x-ratelimit-global') ? 'Global' : 'Unexpected'} 429: ${result}\n${content} ${now} ${route} ${response.status}: ${this.ratelimits.get(route).remaining}/${this.ratelimits.get(route).limit} left | Reset ${retryAfter} (${this.ratelimits.get(route).reset - now}ms left) | Scope ${response.headers.get('x-ratelimit-scope')}`);
         if (retryAfter) {
-            await (0, promises_1.setTimeout)(retryAfter);
+            await (0, common_1.delay)(retryAfter);
             next();
             return this.request(method, url, {
                 body: request.body,

package/lib/builders/Attachment.d.ts

@@ -94,10 +94,7 @@ export declare function resolveFiles(resources: (AttachmentBuilder | RawFile | A
  */
 export declare function resolveAttachmentData(data: AttachmentResolvable, type: AttachmentDataType): Promise<{
     data: AttachmentResolvable;
-    contentType?: undefined;
-} | {
-    data: Buffer;
-    contentType: string | null;
+    contentType?: string | null;
 }>;
 /**
  * Resolves a base64 data to a data URL.

package/lib/builders/Attachment.js

@@ -5,10 +5,10 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.resolveImage = exports.resolveBase64 = exports.resolveAttachmentData = exports.resolveFiles = exports.resolveAttachment = exports.AttachmentBuilder = exports.Attachment = void 0;
 const node_crypto_1 = require("node:crypto");
-const promises_1 = require("node:fs/promises");
 const node_path_1 = __importDefault(require("node:path"));
 const __1 = require("..");
 const Base_1 = require("../structures/extra/Base");
+const node_fs_1 = require("node:fs");
 class Attachment extends Base_1.Base {
     data;
     constructor(client, data) {
@@ -24,7 +24,7 @@ class AttachmentBuilder {
      * Creates a new Attachment instance.
      * @param data - The partial attachment data.
      */
-    constructor(data = { name: `${(0, node_crypto_1.randomBytes)(8).toString('base64url')}.jpg` }) {
+    constructor(data = { name: `${((0, node_crypto_1.randomBytes)?.(8))?.toString('base64url') || 'default'}.jpg` }) {
         this.data = data;
     }
     /**
@@ -163,10 +163,10 @@ async function resolveAttachmentData(data, type) {
         }
         case 'path': {
             const file = node_path_1.default.resolve(data);
-            const stats = await (0, promises_1.stat)(file);
+            const stats = await node_fs_1.promises.stat(file);
             if (!stats.isFile())
                 return (0, __1.throwError)(`The attachment type has been expressed as ${type.toUpperCase()} but cannot be resolved as one.`);
-            return { data: await (0, promises_1.readFile)(file) };
+            return { data: await node_fs_1.promises.readFile(file) };
         }
         case 'buffer': {
             if (Buffer.isBuffer(data))

package/lib/cache/adapters/workeradapter.js

@@ -2,17 +2,21 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.WorkerAdapter = void 0;
 const node_crypto_1 = require("node:crypto");
-const node_worker_threads_1 = require("node:worker_threads");
+const common_1 = require("../../common");
+let parentPort;
 class WorkerAdapter {
     workerData;
     isAsync = true;
     promises = new Map();
     constructor(workerData) {
         this.workerData = workerData;
+        const worker_threads = (0, common_1.lazyLoadPackage)('node:worker_threads');
+        if (worker_threads?.parentPort)
+            parentPort = worker_threads.parentPort;
     }
     postMessage(body) {
-        if (node_worker_threads_1.parentPort)
-            return node_worker_threads_1.parentPort.postMessage(body);
+        if (parentPort)
+            return parentPort.postMessage(body);
         return process.send(body);
     }
     send(method, ...args) {

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/default/base.d.ts

@@ -1,10 +1,9 @@
 import type { GatewayIntentBits } from 'discord-api-types/v10';
-import type { BaseClient } from '../../../client/base';
 import type { UsingClient } from '../../../commands';
 import type { Cache, ReturnCache } from '../../index';
 export declare class BaseResource<T = any> {
     protected cache: Cache;
-    client: BaseClient;
+    client: UsingClient;
     namespace: string;
     constructor(cache: Cache, client?: UsingClient);
     filter(data: any, id: string): boolean;

package/lib/cache/resources/default/guild-based.d.ts

@@ -1,10 +1,9 @@
 import type { GatewayIntentBits } from 'discord-api-types/v10';
-import type { BaseClient } from '../../../client/base';
 import type { UsingClient } from '../../../commands';
 import type { Cache, ReturnCache } from '../../index';
 export declare class GuildBasedResource<T = any> {
     protected cache: Cache;
-    client: BaseClient;
+    client: UsingClient;
     namespace: string;
     constructor(cache: Cache, client?: UsingClient);
     filter(data: any, id: string, guild_id: string): boolean;

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,15 +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 } from 'discord-api-types/rest/v10';
-import type { DeepPartial, IntentStrings, OmitInsert, When } from '../common/types/util';
+import type { LocaleString, RESTPostAPIChannelMessageJSONBody } from 'discord-api-types/rest/v10';
+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, UserCommandInteraction } from '../structures';
+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;
@@ -24,6 +26,7 @@ export declare class BaseClient {
     reactions: ReactionShorter;
     emojis: EmojiShorter;
     threads: ThreadShorter;
+    bans: BanShorter;
     interactions: InteractionShorter;
     debugger?: Logger;
     logger: Logger;
@@ -35,17 +38,18 @@ export declare class BaseClient {
     middlewares?: Record<string, MiddlewareContext>;
     protected static assertString(value: unknown, message?: string): asserts value is string;
     protected static getBotIdFromToken(token: string): string;
-    options: BaseClientOptions | undefined;
+    options: BaseClientOptions;
     constructor(options?: BaseClientOptions);
     set botId(id: string);
     get botId(): string;
     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>;
+    shouldUploadCommands(cachePath: string): Promise<boolean>;
     uploadCommands(applicationId?: string): Promise<void>;
     loadCommands(dir?: string): Promise<void>;
     loadComponents(dir?: string): Promise<void>;
@@ -66,7 +70,7 @@ export declare class BaseClient {
     }>;
 }
 export interface BaseClientOptions {
-    context?: (interaction: ChatInputCommandInteraction<boolean> | UserCommandInteraction<boolean> | MessageCommandInteraction<boolean> | ComponentInteraction | When<InferWithPrefix, Message, never>) => {};
+    context?: (interaction: ChatInputCommandInteraction<boolean> | UserCommandInteraction<boolean> | MessageCommandInteraction<boolean> | ComponentInteraction | ModalSubmitInteraction | When<InferWithPrefix, Message, never>) => {};
     globalMiddlewares?: readonly (keyof RegisteredMiddlewares)[];
     commands?: {
         defaults?: {
@@ -77,8 +81,29 @@ export interface BaseClientOptions {
             onMiddlewaresError?: Command['onMiddlewaresError'];
             onOptionsError?: Command['onOptionsError'];
             onAfterRun?: Command['onAfterRun'];
+            props?: ExtraProps;
         };
     };
+    components?: {
+        defaults?: {
+            onRunError?: ComponentCommand['onRunError'];
+            onInternalError?: ComponentCommand['onInternalError'];
+            onMiddlewaresError?: ComponentCommand['onMiddlewaresError'];
+            onAfterRun?: ComponentCommand['onAfterRun'];
+        };
+    };
+    modals?: {
+        defaults?: {
+            onRunError?: ModalCommand['onRunError'];
+            onInternalError?: ModalCommand['onInternalError'];
+            onMiddlewaresError?: ModalCommand['onMiddlewaresError'];
+            onAfterRun?: ModalCommand['onAfterRun'];
+        };
+    };
+    allowedMentions?: Omit<NonNullable<RESTPostAPIChannelMessageJSONBody['allowed_mentions']>, 'parse'> & {
+        parse?: ('everyone' | 'roles' | 'users')[];
+    };
+    getRC?(): Awaitable<InternalRuntimeConfig | InternalRuntimeConfigHTTP>;
 }
 export interface StartOptions {
     eventsDir: string;
@@ -91,6 +116,7 @@ export interface StartOptions {
     httpConnection: {
         publicKey: string;
         port: number;
+        useUWS: boolean;
     };
     token: string;
 }