seyfert 2.2.1-dev-13755013058.0 → 2.2.1-dev-13823891089.0

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

@@ -3,6 +3,7 @@ import type { GuildMemberStructure, GuildStructure, InteractionGuildMemberStruct
 import type { If, MakeRequired, UnionToTuple, When } from '../../common';
 import type { InteractionCreateBodyRequest, InteractionMessageUpdateBodyRequest, MessageWebhookCreateBodyRequest } from '../../common/types/write';
 import { type AllChannels, ChatInputCommandInteraction } from '../../structures';
+import { type RESTGetAPIGuildQuery } from '../../types';
 import { BaseContext } from '../basecontext';
 import type { RegisteredMiddlewares } from '../decorators';
 import type { Command, ContextOptions, OptionsRecord, SubCommand } from './chat';
@@ -36,8 +37,8 @@ export declare class CommandContext<T extends OptionsRecord = {}, M extends keyo
     channel(mode: 'cache'): ReturnCache<If<InferWithPrefix, AllChannels | undefined, AllChannels>>;
     me(mode?: 'rest' | 'flow'): Promise<GuildMemberStructure | undefined>;
     me(mode: 'cache'): ReturnCache<GuildMemberStructure | undefined>;
-    guild(mode?: 'rest' | 'flow'): Promise<GuildStructure<'cached' | 'api'> | undefined>;
-    guild(mode: 'cache'): ReturnCache<GuildStructure<'cached'> | undefined>;
+    guild(mode?: 'rest' | 'flow', query?: RESTGetAPIGuildQuery): Promise<GuildStructure<'cached' | 'api'> | undefined>;
+    guild(mode: 'cache', query?: RESTGetAPIGuildQuery): ReturnCache<GuildStructure<'cached'> | undefined>;
     get guildId(): string | undefined;
     get channelId(): string;
     get author(): UserStructure;

package/lib/commands/applications/chatcontext.js

@@ -104,7 +104,7 @@ class CommandContext extends basecontext_1.BaseContext {
                 return this.client.members.fetch(this.guildId, this.client.botId, mode === 'rest');
         }
     }
-    guild(mode = 'flow') {
+    guild(mode = 'flow', query) {
         if (!this.guildId)
             return mode === 'cache' ? (this.client.cache.adapter.isAsync ? Promise.resolve() : undefined) : Promise.resolve();
         switch (mode) {
@@ -112,7 +112,7 @@ class CommandContext extends basecontext_1.BaseContext {
                 return (this.client.cache.guilds?.get(this.guildId) ||
                     (this.client.cache.adapter.isAsync ? Promise.resolve() : undefined));
             default:
-                return this.client.guilds.fetch(this.guildId, mode === 'rest');
+                return this.client.guilds.fetch(this.guildId, { force: mode === 'rest', query });
         }
     }
     get guildId() {

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

@@ -2,6 +2,7 @@ import type { ReturnCache } from '../../cache';
 import type { GuildMemberStructure, GuildStructure, InteractionGuildMemberStructure, UserStructure, WebhookMessageStructure } from '../../client/transformers';
 import type { InteractionCreateBodyRequest, InteractionMessageUpdateBodyRequest, MakeRequired, MessageWebhookCreateBodyRequest, ModalCreateBodyRequest, UnionToTuple, When } from '../../common';
 import type { AllChannels, EntryPointInteraction } from '../../structures';
+import { type RESTGetAPIGuildQuery } from '../../types';
 import { BaseContext } from '../basecontext';
 import type { RegisteredMiddlewares } from '../decorators';
 import type { EntryPointCommand } from './entryPoint';
@@ -32,8 +33,8 @@ export declare class EntryPointContext<M extends keyof RegisteredMiddlewares = n
     channel(mode: 'cache'): ReturnCache<AllChannels>;
     me(mode?: 'rest' | 'flow'): Promise<GuildMemberStructure | undefined>;
     me(mode: 'cache'): ReturnCache<GuildMemberStructure | undefined>;
-    guild(mode?: 'rest' | 'flow'): Promise<GuildStructure<'cached' | 'api'> | undefined>;
-    guild(mode: 'cache'): ReturnCache<GuildStructure<'cached'> | undefined>;
+    guild(mode?: 'rest' | 'flow', query?: RESTGetAPIGuildQuery): Promise<GuildStructure<'cached' | 'api'> | undefined>;
+    guild(mode: 'cache', query?: RESTGetAPIGuildQuery): ReturnCache<GuildStructure<'cached'> | undefined>;
     get guildId(): string | undefined;
     get channelId(): string;
     get author(): UserStructure;

package/lib/commands/applications/entrycontext.js

@@ -63,14 +63,15 @@ class EntryPointContext extends basecontext_1.BaseContext {
                 return this.client.members.fetch(this.guildId, this.client.botId, mode === 'rest');
         }
     }
-    guild(mode = 'flow') {
+    guild(mode = 'flow', query) {
         if (!this.guildId)
-            return (mode === 'cache' ? (this.client.cache.adapter.isAsync ? Promise.resolve() : undefined) : Promise.resolve());
+            return mode === 'cache' ? (this.client.cache.adapter.isAsync ? Promise.resolve() : undefined) : Promise.resolve();
         switch (mode) {
             case 'cache':
-                return this.client.cache.guilds?.get(this.guildId);
+                return (this.client.cache.guilds?.get(this.guildId) ||
+                    (this.client.cache.adapter.isAsync ? Promise.resolve() : undefined));
             default:
-                return this.client.guilds.fetch(this.guildId, mode === 'rest');
+                return this.client.guilds.fetch(this.guildId, { force: mode === 'rest', query });
         }
     }
     get guildId() {

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

@@ -2,6 +2,7 @@ import type { ContextMenuCommand, InteractionGuildMemberStructure, ReturnCache }
 import { type GuildMemberStructure, type GuildStructure, type MessageStructure, type UserStructure, type WebhookMessageStructure } from '../../client/transformers';
 import { type InteractionCreateBodyRequest, type InteractionMessageUpdateBodyRequest, type MakeRequired, type MessageWebhookCreateBodyRequest, type ModalCreateBodyRequest, type UnionToTuple, type When } from '../../common';
 import type { AllChannels, MessageCommandInteraction, UserCommandInteraction } from '../../structures';
+import { type RESTGetAPIGuildQuery } from '../../types';
 import { BaseContext } from '../basecontext';
 import type { RegisteredMiddlewares } from '../decorators';
 import type { CommandMetadata, ExtendContext, GlobalMetadata, UsingClient } from './shared';
@@ -33,8 +34,8 @@ export declare class MenuCommandContext<T extends MessageCommandInteraction | Us
     channel(mode: 'cache'): ReturnCache<AllChannels>;
     me(mode?: 'rest' | 'flow'): Promise<GuildMemberStructure | undefined>;
     me(mode: 'cache'): ReturnCache<GuildMemberStructure | undefined>;
-    guild(mode?: 'rest' | 'flow'): Promise<GuildStructure<'cached' | 'api'> | undefined>;
-    guild(mode: 'cache'): ReturnCache<GuildStructure<'cached'> | undefined>;
+    guild(mode?: 'rest' | 'flow', query?: RESTGetAPIGuildQuery): Promise<GuildStructure<'cached' | 'api'> | undefined>;
+    guild(mode: 'cache', query?: RESTGetAPIGuildQuery): ReturnCache<GuildStructure<'cached'> | undefined>;
     get guildId(): string | undefined;
     get channelId(): string;
     get author(): UserStructure;

package/lib/commands/applications/menucontext.js

@@ -77,14 +77,15 @@ class MenuCommandContext extends basecontext_1.BaseContext {
                 return this.client.members.fetch(this.guildId, this.client.botId, mode === 'rest');
         }
     }
-    guild(mode = 'flow') {
+    guild(mode = 'flow', query) {
         if (!this.guildId)
-            return (mode === 'cache' ? (this.client.cache.adapter.isAsync ? Promise.resolve() : undefined) : Promise.resolve());
+            return mode === 'cache' ? (this.client.cache.adapter.isAsync ? Promise.resolve() : undefined) : Promise.resolve();
         switch (mode) {
             case 'cache':
-                return this.client.cache.guilds?.get(this.guildId);
+                return (this.client.cache.guilds?.get(this.guildId) ||
+                    (this.client.cache.adapter.isAsync ? Promise.resolve() : undefined));
             default:
-                return this.client.guilds.fetch(this.guildId, mode === 'rest');
+                return this.client.guilds.fetch(this.guildId, { force: mode === 'rest', query });
         }
     }
     get guildId() {

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

@@ -1,7 +1,7 @@
 import { type AnonymousGuildStructure, type AutoModerationRuleStructure, type GuildMemberStructure, type GuildStructure, type StickerStructure } from '../../client/transformers';
 import type { SeyfertChannelMap } from '../../commands';
 import { type AllChannels, type CreateStickerBodyRequest, Guild, type GuildChannelTypes } from '../../structures';
-import type { GuildWidgetStyle, RESTGetAPICurrentUserGuildsQuery, RESTPatchAPIAutoModerationRuleJSONBody, RESTPatchAPIChannelJSONBody, RESTPatchAPIGuildChannelPositionsJSONBody, RESTPatchAPIGuildJSONBody, RESTPatchAPIGuildStickerJSONBody, RESTPostAPIAutoModerationRuleJSONBody, RESTPostAPIGuildChannelJSONBody, RESTPostAPIGuildsJSONBody } from '../../types';
+import type { GuildWidgetStyle, RESTGetAPICurrentUserGuildsQuery, RESTGetAPIGuildQuery, RESTPatchAPIAutoModerationRuleJSONBody, RESTPatchAPIChannelJSONBody, RESTPatchAPIGuildChannelPositionsJSONBody, RESTPatchAPIGuildJSONBody, RESTPatchAPIGuildStickerJSONBody, RESTPostAPIAutoModerationRuleJSONBody, RESTPostAPIGuildChannelJSONBody, RESTPostAPIGuildsJSONBody } from '../../types';
 import { BaseShorter } from './base';
 export declare class GuildShorter extends BaseShorter {
     /**
@@ -13,11 +13,21 @@ export declare class GuildShorter extends BaseShorter {
     /**
      * Fetches a guild by its ID.
      * @param id The ID of the guild to fetch.
-     * @param force Whether to force fetching the guild from the API even if it exists in the cache.
+     * @param options The options for fetching the guild.
+     * @param options.query The query parameters for fetching the guild.
+     * @param options.force Whether to force fetching the guild from the API even if it exists in the cache.
      * @returns A Promise that resolves to the fetched guild.
      */
-    fetch(id: string, force?: boolean): Promise<GuildStructure<'api'>>;
-    raw(id: string, force?: boolean): Promise<import("../../types").APIGuild>;
+    fetch(id: string, options?: GuildFetchOptions | boolean): Promise<Guild<"api">>;
+    /**
+     * Fetches a guild by its ID.
+     * @param id The ID of the guild to fetch.
+     * @param options The options for fetching the guild.
+     * @param options.query The query parameters for fetching the guild.
+     * @param options.force Whether to force fetching the guild from the API even if it exists in the cache.
+     * @returns A Promise that resolves to the fetched guild.
+     */
+    raw(id: string, options?: GuildFetchOptions | boolean): Promise<import("../../types").APIGuild>;
     /**
      * Generates the widget URL for the guild.
      * @param id The ID of the guild.
@@ -169,3 +179,7 @@ export declare class GuildShorter extends BaseShorter {
         delete: (guildId: string, stickerId: string, reason?: string) => Promise<void>;
     };
 }
+export interface GuildFetchOptions {
+    query?: RESTGetAPIGuildQuery;
+    force?: boolean;
+}

package/lib/common/shorters/guilds.js

@@ -20,19 +20,29 @@ class GuildShorter extends base_1.BaseShorter {
     /**
      * Fetches a guild by its ID.
      * @param id The ID of the guild to fetch.
-     * @param force Whether to force fetching the guild from the API even if it exists in the cache.
+     * @param options The options for fetching the guild.
+     * @param options.query The query parameters for fetching the guild.
+     * @param options.force Whether to force fetching the guild from the API even if it exists in the cache.
      * @returns A Promise that resolves to the fetched guild.
      */
-    async fetch(id, force = false) {
-        return transformers_1.Transformers.Guild(this.client, await this.raw(id, force));
+    async fetch(id, options = false) {
+        return transformers_1.Transformers.Guild(this.client, await this.raw(id, options));
     }
-    async raw(id, force = false) {
-        if (!force) {
+    /**
+     * Fetches a guild by its ID.
+     * @param id The ID of the guild to fetch.
+     * @param options The options for fetching the guild.
+     * @param options.query The query parameters for fetching the guild.
+     * @param options.force Whether to force fetching the guild from the API even if it exists in the cache.
+     * @returns A Promise that resolves to the fetched guild.
+     */
+    async raw(id, options = false) {
+        if (!(typeof options === 'boolean' ? options : options.force)) {
             const guild = await this.client.cache.guilds?.raw(id);
             if (guild)
                 return guild;
         }
-        const data = await this.client.proxy.guilds(id).get();
+        const data = await this.client.proxy.guilds(id).get({ query: options.query });
         await this.client.cache.guilds?.patch(cache_1.CacheFrom.Rest, id, data);
         return (await this.client.cache.guilds?.raw(id)) ?? data;
     }

package/lib/components/componentcontext.d.ts

@@ -3,6 +3,7 @@ import type { GuildMemberStructure, GuildStructure, InteractionGuildMemberStruct
 import type { CommandMetadata, ExtendContext, GlobalMetadata, RegisteredMiddlewares, UsingClient } from '../commands';
 import { BaseContext } from '../commands/basecontext';
 import type { ComponentInteractionMessageUpdate, InteractionCreateBodyRequest, InteractionMessageUpdateBodyRequest, MakeRequired, MessageWebhookCreateBodyRequest, ModalCreateBodyRequest, UnionToTuple, When } from '../common';
+import { type RESTGetAPIGuildQuery } from '../types';
 export interface ComponentContext<Type extends keyof ContextComponentCommandInteractionMap = keyof ContextComponentCommandInteractionMap> extends BaseContext, ExtendContext {
 }
 /**
@@ -92,8 +93,8 @@ export declare class ComponentContext<Type extends keyof ContextComponentCommand
      * @param mode - The mode to fetch the guild.
      * @returns A promise that resolves to the guild.
      */
-    guild(mode?: 'rest' | 'flow'): Promise<GuildStructure<'cached' | 'api'> | undefined>;
-    guild(mode: 'cache'): ReturnCache<GuildStructure<'cached'> | undefined>;
+    guild(mode?: 'rest' | 'flow', query?: RESTGetAPIGuildQuery): Promise<GuildStructure<'cached' | 'api'> | undefined>;
+    guild(mode: 'cache', query?: RESTGetAPIGuildQuery): ReturnCache<GuildStructure<'cached'> | undefined>;
     /**
      * Gets the ID of the guild of the interaction.
      */

package/lib/components/componentcontext.js

@@ -112,14 +112,15 @@ class ComponentContext extends basecontext_1.BaseContext {
                 return this.client.members.fetch(this.guildId, this.client.botId, mode === 'rest');
         }
     }
-    guild(mode = 'flow') {
+    guild(mode = 'flow', query) {
         if (!this.guildId)
-            return (mode === 'cache' ? (this.client.cache.adapter.isAsync ? Promise.resolve() : undefined) : Promise.resolve());
+            return mode === 'cache' ? (this.client.cache.adapter.isAsync ? Promise.resolve() : undefined) : Promise.resolve();
         switch (mode) {
             case 'cache':
-                return this.client.cache.guilds?.get(this.guildId);
+                return (this.client.cache.guilds?.get(this.guildId) ||
+                    (this.client.cache.adapter.isAsync ? Promise.resolve() : undefined));
             default:
-                return this.client.guilds.fetch(this.guildId, mode === 'rest');
+                return this.client.guilds.fetch(this.guildId, { force: mode === 'rest', query });
         }
     }
     /**

package/package.json

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