seyfert 2.1.1-dev-11317998653.0 → 2.1.1-dev-11319654918.0

package/lib/api/api.d.ts

@@ -1,10 +1,11 @@
-import { Logger } from '../common';
+import { type Awaitable, Logger } from '../common';
 import type { APIRoutes } from './Routes';
 import { Bucket } from './bucket';
 import { type ApiHandlerInternalOptions, type ApiHandlerOptions, type ApiRequestOptions, type HttpMethods, type RawFile, type RequestHeaders } from './shared';
 export interface ApiHandler {
     debugger?: Logger;
 }
+export type OnRatelimitCallback = (response: Response, request: ApiRequestOptions) => Awaitable<any>;
 export declare class ApiHandler {
     #private;
     options: ApiHandlerInternalOptions;
@@ -16,6 +17,7 @@ export declare class ApiHandler {
         resolve: (value: any) => any;
         reject: (error: any) => any;
     }>;
+    onRatelimit?: OnRatelimitCallback;
     constructor(options: ApiHandlerOptions);
     get proxy(): APIRoutes;
     globalUnblock(): void;

package/lib/api/api.js

@@ -16,6 +16,7 @@ class ApiHandler {
     readyQueue = [];
     cdn = Router_1.CDNRouter.createProxy();
     workerPromises;
+    onRatelimit;
     constructor(options) {
         this.options = {
             baseUrl: 'api/v10',
@@ -198,6 +199,7 @@ class ApiHandler {
         });
     }
     async handle429(route, method, url, request, response, result, next, reject, now) {
+        await this.onRatelimit?.(response, request);
         const content = `${JSON.stringify(request)} `;
         let retryAfter = Number(response.headers.get('x-ratelimit-reset-after') || response.headers.get('retry-after')) * 1000;
         if (Number.isNaN(retryAfter)) {

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

@@ -1,6 +1,6 @@
 import type { AllChannels, InferWithPrefix, ReturnCache } from '../..';
 import type { GuildMemberStructure, GuildStructure, InteractionGuildMemberStructure, MessageStructure, OptionResolverStructure, WebhookMessageStructure } from '../../client/transformers';
-import type { If, UnionToTuple, When } from '../../common';
+import type { If, MakeRequired, UnionToTuple, When } from '../../common';
 import type { InteractionCreateBodyRequest, InteractionMessageUpdateBodyRequest } from '../../common/types/write';
 import { ChatInputCommandInteraction } from '../../structures';
 import { BaseContext } from '../basecontext';
@@ -44,3 +44,7 @@ export declare class CommandContext<T extends OptionsRecord = {}, M extends keyo
     get member(): If<InferWithPrefix, GuildMemberStructure | InteractionGuildMemberStructure | undefined, InteractionGuildMemberStructure | undefined>;
     isChat(): this is CommandContext;
 }
+export interface GuildCommandContext<T extends OptionsRecord = {}, M extends keyof RegisteredMiddlewares = never> extends Omit<MakeRequired<CommandContext<T, M>, 'guildId'>, 'guild'> {
+    guild(mode?: 'rest' | 'flow'): Promise<GuildStructure<'cached' | 'api'>>;
+    guild(mode?: 'cache'): ReturnCache<GuildStructure<'cached'> | undefined>;
+}

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

@@ -1,6 +1,6 @@
 import type { ReturnCache } from '../..';
 import type { GuildMemberStructure, GuildStructure, MessageStructure, WebhookMessageStructure } from '../../client/transformers';
-import type { InteractionCreateBodyRequest, InteractionMessageUpdateBodyRequest, ModalCreateBodyRequest, UnionToTuple, When } from '../../common';
+import type { InteractionCreateBodyRequest, InteractionMessageUpdateBodyRequest, MakeRequired, ModalCreateBodyRequest, UnionToTuple, When } from '../../common';
 import type { AllChannels, EntryPointInteraction } from '../../structures';
 import { BaseContext } from '../basecontext';
 import type { RegisteredMiddlewares } from '../decorators';
@@ -38,3 +38,7 @@ export declare class EntryPointContext<M extends keyof RegisteredMiddlewares = n
     get author(): import("../..").User;
     get member(): import("../..").InteractionGuildMember | undefined;
 }
+export interface GuildEntryPointContext<M extends keyof RegisteredMiddlewares = never> extends Omit<MakeRequired<EntryPointContext<M>, 'guildId'>, 'guild'> {
+    guild(mode?: 'rest' | 'flow'): Promise<GuildStructure<'cached' | 'api'>>;
+    guild(mode?: 'cache'): ReturnCache<GuildStructure<'cached'> | undefined>;
+}

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

@@ -1,6 +1,6 @@
 import type { ContextMenuCommand, ReturnCache } from '../..';
 import { type GuildMemberStructure, type GuildStructure, type MessageStructure, type UserStructure, type WebhookMessageStructure } from '../../client/transformers';
-import { type InteractionCreateBodyRequest, type InteractionMessageUpdateBodyRequest, type ModalCreateBodyRequest, type UnionToTuple, type When } from '../../common';
+import { type InteractionCreateBodyRequest, type InteractionMessageUpdateBodyRequest, type MakeRequired, type ModalCreateBodyRequest, type UnionToTuple, type When } from '../../common';
 import type { AllChannels, MessageCommandInteraction, UserCommandInteraction } from '../../structures';
 import { BaseContext } from '../basecontext';
 import type { RegisteredMiddlewares } from '../decorators';
@@ -42,3 +42,7 @@ export declare class MenuCommandContext<T extends MessageCommandInteraction | Us
     isMenuUser(): this is MenuCommandContext<UserCommandInteraction>;
     isMenuMessage(): this is MenuCommandContext<MessageCommandInteraction>;
 }
+export interface GuildMenuCommandContext<T extends MessageCommandInteraction | UserCommandInteraction, M extends keyof RegisteredMiddlewares = never> extends Omit<MakeRequired<MenuCommandContext<T, M>, 'guildId'>, 'guild'> {
+    guild(mode?: 'rest' | 'flow'): Promise<GuildStructure<'cached' | 'api'>>;
+    guild(mode?: 'cache'): ReturnCache<GuildStructure<'cached'> | undefined>;
+}

package/lib/commands/handler.js

@@ -474,8 +474,8 @@ class CommandHandler extends common_1.BaseHandler {
             option.onPermissionsFail?.bind(option) ??
                 commandInstance.onPermissionsFail?.bind(commandInstance) ??
                 this.client.options.commands?.defaults?.onPermissionsFail;
-        option.botPermissions = new Permissions_1.PermissionsBitField().add(option.botPermissions ?? Permissions_1.PermissionsBitField.None, commandInstance.botPermissions);
-        option.defaultMemberPermissions ??= new Permissions_1.PermissionsBitField().add(option.defaultMemberPermissions ?? Permissions_1.PermissionsBitField.None, commandInstance.defaultMemberPermissions);
+        option.botPermissions = Permissions_1.PermissionsBitField.resolve(option.botPermissions ?? Permissions_1.PermissionsBitField.None, commandInstance.botPermissions ?? Permissions_1.PermissionsBitField.None);
+        option.defaultMemberPermissions ??= Permissions_1.PermissionsBitField.resolve(option.defaultMemberPermissions ?? Permissions_1.PermissionsBitField.None, commandInstance.defaultMemberPermissions ?? Permissions_1.PermissionsBitField.None);
         option.contexts ??= commandInstance.contexts;
         option.integrationTypes ??= commandInstance.integrationTypes;
         option.props ??= commandInstance.props;

package/lib/common/index.d.ts

@@ -1,7 +1,7 @@
 export * from './it/constants';
 export * from './it/utils';
 export * from './it/colors';
-export * from './it/logger';
+export { CustomizeLoggerCallback, AssignFilenameCallback, LogLevels, Logger, LoggerOptions } from './it/logger';
 export * from './it/formatter';
 export * from './shorters/channels';
 export * from './shorters/emojis';

package/lib/common/index.js

@@ -14,10 +14,13 @@ var __exportStar = (this && this.__exportStar) || function(m, exports) {
     for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
 };
 Object.defineProperty(exports, "__esModule", { value: true });
+exports.Logger = exports.LogLevels = void 0;
 __exportStar(require("./it/constants"), exports);
 __exportStar(require("./it/utils"), exports);
 __exportStar(require("./it/colors"), exports);
-__exportStar(require("./it/logger"), exports);
+var logger_1 = require("./it/logger");
+Object.defineProperty(exports, "LogLevels", { enumerable: true, get: function () { return logger_1.LogLevels; } });
+Object.defineProperty(exports, "Logger", { enumerable: true, get: function () { return logger_1.Logger; } });
 __exportStar(require("./it/formatter"), exports);
 //
 __exportStar(require("./shorters/channels"), exports);

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

@@ -1,4 +1,3 @@
-import { type WriteStream } from 'node:fs';
 export declare enum LogLevels {
     Debug = 0,
     Info = 1,
@@ -12,7 +11,8 @@ export type LoggerOptions = {
     active?: boolean;
     saveOnFile?: boolean;
 };
-export type CustomCallback = (self: Logger, level: LogLevels, args: unknown[]) => unknown[] | undefined;
+export type CustomizeLoggerCallback = (self: Logger, level: LogLevels, args: unknown[]) => unknown[] | undefined;
+export type AssignFilenameCallback = (self: Logger) => string;
 /**
  * Represents a logger utility for logging messages with various log levels.
  */
@@ -21,14 +21,16 @@ export declare class Logger {
      * The options for configuring the logger.
      */
     readonly options: Required<LoggerOptions>;
-    static streams: Partial<Record<string, WriteStream>>;
     static saveOnFile?: string[] | 'all';
     static dirname: string;
+    private static streams;
+    private static fileNames;
     private static createdDir?;
+    private static __assignFileName;
     /**
      * The custom callback function for logging.
      */
-    private static __callback?;
+    private static __callback;
     /**
      * Allows customization of the logging behavior by providing a custom callback function.
      * @param cb The custom callback function for logging.
@@ -37,7 +39,19 @@ export declare class Logger {
      *     // Custom logging implementation
      * });
      */
-    static customize(cb: CustomCallback): void;
+    static customize(cb: CustomizeLoggerCallback): void;
+    /**
+     * Customizes the logging filename by providing a callback function.
+     * The callback receives the logger instance and should return the desired filename.
+     *
+     * @param cb - A function that takes the logger instance and returns a string
+     *              representing the customized filename for the log.
+     * @example
+     * Logger.customizeFilename((logger) => {
+     *     return `${logger.name}-${Date.now()}.log`;
+     * });
+     */
+    static customizeFilename(cb: AssignFilenameCallback): void;
     static clearLogs(): Promise<void>;
     /**
      * Constructs a new Logger instance with the provided options.
@@ -122,3 +136,9 @@ export declare class Logger {
      */
     static prefixes: Map<LogLevels, string>;
 }
+/**
+ * Formats memory usage data into a string.
+ * @param data The memory usage data.
+ * @returns The formatted string representing memory usage.
+ */
+export declare function formatMemoryUsage(bytes: number): string;

package/lib/common/it/logger.js

@@ -1,6 +1,7 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.Logger = exports.LogLevels = void 0;
+exports.formatMemoryUsage = formatMemoryUsage;
 const node_fs_1 = require("node:fs");
 const node_path_1 = require("node:path");
 const colors_1 = require("./colors");
@@ -21,14 +22,30 @@ class Logger {
      * The options for configuring the logger.
      */
     options;
-    static streams = {};
     static saveOnFile;
     static dirname = 'seyfert-logs';
+    static streams = {};
+    static fileNames = {};
     static createdDir;
+    static __assignFileName = self => {
+        const date = new Date();
+        return `${self.name}-${date.getMonth() + 1}-${date.getDate()}-${date.getFullYear()}-${date.getTime()}.log`;
+    };
     /**
      * The custom callback function for logging.
      */
-    static __callback;
+    static __callback = (self, level, args) => {
+        const color = Logger.colorFunctions.get(level) ?? Logger.noColor;
+        const memoryData = process.memoryUsage?.();
+        const date = new Date();
+        return [
+            (0, colors_1.brightBlack)(formatMemoryUsage(memoryData?.rss ?? 0)),
+            (0, colors_1.bgBrightWhite)((0, colors_1.black)(`[${date.toLocaleDateString()} ${date.toLocaleTimeString()}]`)),
+            color(Logger.prefixes.get(level) ?? 'DEBUG'),
+            self.name ? `${self.name} >` : '>',
+            ...args,
+        ];
+    };
     /**
      * Allows customization of the logging behavior by providing a custom callback function.
      * @param cb The custom callback function for logging.
@@ -40,10 +57,28 @@ class Logger {
     static customize(cb) {
         Logger.__callback = cb;
     }
+    /**
+     * Customizes the logging filename by providing a callback function.
+     * The callback receives the logger instance and should return the desired filename.
+     *
+     * @param cb - A function that takes the logger instance and returns a string
+     *              representing the customized filename for the log.
+     * @example
+     * Logger.customizeFilename((logger) => {
+     *     return `${logger.name}-${Date.now()}.log`;
+     * });
+     */
+    static customizeFilename(cb) {
+        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 => Logger.streams[i.name].close(res));
+                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];
         }
@@ -108,22 +143,7 @@ class Logger {
             return;
         if (level < this.level)
             return;
-        let log;
-        if (Logger.__callback) {
-            log = Logger.__callback(this, level, args);
-        }
-        else {
-            const color = Logger.colorFunctions.get(level) ?? Logger.noColor;
-            const memoryData = process.memoryUsage?.();
-            const date = new Date();
-            log = [
-                (0, colors_1.brightBlack)(formatMemoryUsage(memoryData?.rss ?? 0)),
-                (0, colors_1.bgBrightWhite)((0, colors_1.black)(`[${date.toLocaleDateString()} ${date.toLocaleTimeString()}]`)),
-                color(Logger.prefixes.get(level) ?? 'DEBUG'),
-                this.name ? `${this.name} >` : '>',
-                ...args,
-            ];
-        }
+        const log = Logger.__callback(this, level, args);
         if (!log)
             return;
         this.__write(log);
@@ -170,12 +190,13 @@ class Logger {
                 Logger.createdDir = true;
                 (0, node_fs_1.mkdirSync)((0, node_path_1.join)(process.cwd(), Logger.dirname), { recursive: true });
             }
-            const date = new Date();
-            const name = `${date.getMonth() + 1}-${date.getDate()}-${date.getFullYear()}${this.name}.log`;
-            if (!Logger.streams[name]) {
-                Logger.streams[name] = (0, node_fs_1.createWriteStream)((0, node_path_1.join)(process.cwd(), Logger.dirname, name));
+            const fileName = (Logger.fileNames[this.name] ??= (() => {
+                return (Logger.fileNames[this.name] = Logger.__assignFileName(this));
+            })());
+            if (!Logger.streams[fileName]) {
+                Logger.streams[fileName] = (0, node_fs_1.createWriteStream)((0, node_path_1.join)(process.cwd(), Logger.dirname, fileName));
             }
-            Logger.streams[name].write(`${Buffer.from((0, colors_1.stripColor)(log.join(' ')))}\n`);
+            Logger.streams[fileName].write(`${(0, colors_1.stripColor)(log.join(' '))}\n`);
         }
     }
     /**

package/lib/components/componentcontext.d.ts

@@ -2,7 +2,7 @@ import type { AllChannels, ButtonInteraction, ChannelSelectMenuInteraction, Comp
 import type { GuildMemberStructure, GuildStructure, MessageStructure, WebhookMessageStructure } from '../client/transformers';
 import type { CommandMetadata, ExtendContext, GlobalMetadata, RegisteredMiddlewares, UsingClient } from '../commands';
 import { BaseContext } from '../commands/basecontext';
-import type { ComponentInteractionMessageUpdate, InteractionCreateBodyRequest, InteractionMessageUpdateBodyRequest, ModalCreateBodyRequest, UnionToTuple, When } from '../common';
+import type { ComponentInteractionMessageUpdate, InteractionCreateBodyRequest, InteractionMessageUpdateBodyRequest, MakeRequired, ModalCreateBodyRequest, UnionToTuple, When } from '../common';
 export interface ComponentContext<Type extends keyof ContextComponentCommandInteractionMap = keyof ContextComponentCommandInteractionMap> extends BaseContext, ExtendContext {
 }
 /**
@@ -117,3 +117,7 @@ export interface ContextComponentCommandInteractionMap {
     MentionableSelect: MentionableSelectMenuInteraction;
     ChannelSelect: ChannelSelectMenuInteraction;
 }
+export interface GuildComponentContext<M extends keyof RegisteredMiddlewares = never> extends Omit<MakeRequired<ComponentContext<M>, 'guildId'>, 'guild'> {
+    guild(mode?: 'rest' | 'flow'): Promise<GuildStructure<'cached' | 'api'>>;
+    guild(mode?: 'cache'): ReturnCache<GuildStructure<'cached'> | undefined>;
+}

package/lib/components/modalcontext.d.ts

@@ -2,7 +2,7 @@ import type { AllChannels, ModalCommand, ModalSubmitInteraction, ReturnCache } f
 import type { GuildMemberStructure, GuildStructure, MessageStructure, WebhookMessageStructure } from '../client/transformers';
 import type { CommandMetadata, ExtendContext, GlobalMetadata, RegisteredMiddlewares, UsingClient } from '../commands';
 import { BaseContext } from '../commands/basecontext';
-import type { InteractionCreateBodyRequest, InteractionMessageUpdateBodyRequest, ModalCreateBodyRequest, UnionToTuple, When } from '../common';
+import type { InteractionCreateBodyRequest, InteractionMessageUpdateBodyRequest, MakeRequired, ModalCreateBodyRequest, UnionToTuple, When } from '../common';
 export interface ModalContext extends BaseContext, ExtendContext {
 }
 /**
@@ -103,3 +103,7 @@ export declare class ModalContext<M extends keyof RegisteredMiddlewares = never>
     get member(): import("..").InteractionGuildMember | undefined;
     isModal(): this is ModalContext;
 }
+export interface GuildModalContext<M extends keyof RegisteredMiddlewares = never> extends Omit<MakeRequired<ModalContext<M>, 'guildId'>, 'guild'> {
+    guild(mode?: 'rest' | 'flow'): Promise<GuildStructure<'cached' | 'api'>>;
+    guild(mode?: 'cache'): ReturnCache<GuildStructure<'cached'> | undefined>;
+}

package/lib/structures/extra/BitField.d.ts

@@ -13,5 +13,5 @@ export declare class BitField<T extends object> {
     values(bits?: BitFieldResolvable<T>[]): bigint[];
     add(...bits: (BitFieldResolvable<T> | undefined)[]): bigint;
     remove(...bits: BitFieldResolvable<T>[]): bigint;
-    resolve(bits: BitFieldResolvable<T>): bigint;
+    resolve(...bits: BitFieldResolvable<T>[]): bigint;
 }

package/lib/structures/extra/BitField.js

@@ -60,23 +60,31 @@ class BitField {
         }
         return this.bits;
     }
-    resolve(bits) {
-        switch (typeof bits) {
-            case 'string':
-                return this.resolve(this.Flags[bits]);
-            case 'number':
-                return BigInt(bits);
-            case 'bigint':
-                return bits;
-            case 'object': {
-                if (!Array.isArray(bits)) {
-                    throw new TypeError(`Cannot resolve permission: ${bits}`);
+    resolve(...bits) {
+        let bitsResult = 0n;
+        for (const bit of bits) {
+            switch (typeof bit) {
+                case 'string':
+                    bitsResult |= this.resolve(this.Flags[bit]);
+                    break;
+                case 'number':
+                    bitsResult |= BigInt(bit);
+                    break;
+                case 'bigint':
+                    bitsResult |= bit;
+                    break;
+                case 'object': {
+                    if (!Array.isArray(bit)) {
+                        throw new TypeError(`Cannot resolve permission: ${bit}`);
+                    }
+                    bitsResult |= bits.reduce((acc, val) => this.resolve(val) | acc, BitField.None);
+                    break;
                 }
-                return bits.map(x => this.resolve(x)).reduce((acc, cur) => acc | cur, BitField.None);
+                default:
+                    throw new TypeError(`Cannot resolve permission: ${typeof bit === 'symbol' ? String(bit) : bit}`);
             }
-            default:
-                throw new TypeError(`Cannot resolve permission: ${typeof bits === 'symbol' ? String(bits) : bits}`);
         }
+        return bitsResult;
     }
 }
 exports.BitField = BitField;

package/lib/structures/extra/Permissions.d.ts

@@ -59,6 +59,6 @@ export declare class PermissionsBitField extends BitField<typeof PermissionFlags
     keys: (bits?: BitFieldResolvable<typeof PermissionFlagsBits>[]) => PermissionStrings;
     has(...bits: BitFieldResolvable<typeof PermissionFlagsBits>[]): boolean;
     strictHas(...bits: BitFieldResolvable<typeof PermissionFlagsBits>[]): boolean;
-    resolve<T extends typeof PermissionFlagsBits>(bits: BitFieldResolvable<T>): bigint;
-    static resolve<T extends typeof PermissionFlagsBits>(bits: BitFieldResolvable<T>): bigint;
+    resolve<T extends typeof PermissionFlagsBits>(...bits: BitFieldResolvable<T>[]): bigint;
+    static resolve<T extends typeof PermissionFlagsBits>(...bits: BitFieldResolvable<T>[]): bigint;
 }

package/lib/structures/extra/Permissions.js

@@ -17,26 +17,34 @@ class PermissionsBitField extends BitField_1.BitField {
     strictHas(...bits) {
         return super.has(...bits);
     }
-    resolve(bits) {
-        return PermissionsBitField.resolve(bits);
+    resolve(...bits) {
+        return bits.reduce((acc, cur) => acc | PermissionsBitField.resolve(cur), BitField_1.BitField.None);
     }
-    static resolve(bits) {
-        switch (typeof bits) {
-            case 'string':
-                return PermissionsBitField.resolve(types_1.PermissionFlagsBits[bits]);
-            case 'number':
-                return BigInt(bits);
-            case 'bigint':
-                return bits;
-            case 'object': {
-                if (!Array.isArray(bits)) {
-                    throw new TypeError(`Cannot resolve permission: ${bits}`);
+    static resolve(...bits) {
+        let bitsResult = 0n;
+        for (const bit of bits) {
+            switch (typeof bit) {
+                case 'string':
+                    bitsResult |= PermissionsBitField.resolve(types_1.PermissionFlagsBits[bit]);
+                    break;
+                case 'number':
+                    bitsResult |= BigInt(bit);
+                    break;
+                case 'bigint':
+                    bitsResult |= bit;
+                    break;
+                case 'object': {
+                    if (!Array.isArray(bit)) {
+                        throw new TypeError(`Cannot resolve permission: ${bit}`);
+                    }
+                    bitsResult |= bit.reduce((acc, val) => PermissionsBitField.resolve(val) | acc, BitField_1.BitField.None);
+                    break;
                 }
-                return bits.map(x => PermissionsBitField.resolve(x)).reduce((acc, cur) => acc | cur, BitField_1.BitField.None);
+                default:
+                    throw new TypeError(`Cannot resolve permission: ${typeof bit === 'symbol' ? String(bit) : bit}`);
             }
-            default:
-                throw new TypeError(`Cannot resolve permission: ${typeof bits === 'symbol' ? String(bits) : bits}`);
         }
+        return bitsResult;
     }
 }
 exports.PermissionsBitField = PermissionsBitField;

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "seyfert",
-	"version": "2.1.1-dev-11317998653.0",
+	"version": "2.1.1-dev-11319654918.0",
 	"description": "The most advanced framework for discord bots",
 	"main": "./lib/index.js",
 	"module": "./lib/index.js",