seyfert 1.1.0 → 1.2.0

package/lib/structures/GuildMember.js

@@ -54,12 +54,15 @@ class BaseGuildMember extends DiscordBase_1.DiscordBase {
     }
     get roles() {
         return {
-            values: Object.freeze(this._roles),
+            keys: Object.freeze(this._roles.concat(this.guildId)),
+            list: (force = false) => this.client.roles
+                .list(this.guildId, force)
+                .then(roles => roles.filter(role => this.roles.keys.includes(role.id))),
             add: (id) => this.client.members.addRole(this.guildId, this.id, id),
             remove: (id) => this.client.members.removeRole(this.guildId, this.id, id),
-            permissions: async () => new Permissions_1.PermissionsBitField(((await this.cache.roles?.bulk(this.roles.values)) ?? [])
-                .filter(x => x)
-                .map(x => BigInt(x.permissions.bits))),
+            permissions: (force = false) => this.roles.list(force).then(roles => new Permissions_1.PermissionsBitField(roles.map(x => BigInt(x.permissions.bits)))),
+            sorted: (force = false) => this.roles.list(force).then(roles => roles.sort((a, b) => b.position - a.position)),
+            highest: (force = false) => this.roles.sorted(force).then(roles => roles[0]),
         };
     }
     static methods({ client, guildId }) {
@@ -84,6 +87,7 @@ exports.BaseGuildMember = BaseGuildMember;
 class GuildMember extends BaseGuildMember {
     guildId;
     user;
+    __me;
     constructor(client, data, user, 
     /** the choosen guild id */
     guildId) {
@@ -125,10 +129,35 @@ class GuildMember extends BaseGuildMember {
         }
         return this.rest.cdn.guildMemberAvatar(this.guildId, this.id, this.avatar, options);
     }
-    async fetchPermissions() {
+    bannerURL(options) {
+        return this.user.bannerURL(options);
+    }
+    async fetchPermissions(force = false) {
         if ('permissions' in this)
             return this.permissions;
-        return this.roles.permissions();
+        return this.roles.permissions(force);
+    }
+    async manageable(force = false) {
+        this.__me = await this.client.guilds.fetchSelf(this.guildId, force);
+        const ownerId = (await this.client.guilds.fetch(this.guildId, force)).ownerId;
+        if (this.user.id === ownerId)
+            return false;
+        if (this.user.id === this.client.botId)
+            return false;
+        if (this.client.botId === ownerId)
+            return true;
+        return (await this.__me.roles.highest()).position > (await this.roles.highest(force)).position;
+    }
+    async bannable(force = false) {
+        return (await this.manageable(force)) && (await this.__me.fetchPermissions(force)).has('BanMembers');
+    }
+    async kickable(force = false) {
+        return (await this.manageable(force)) && (await this.__me.fetchPermissions(force)).has('KickMembers');
+    }
+    async moderatable(force = false) {
+        return (!(await this.roles.permissions(force)).has('Administrator') &&
+            (await this.manageable(force)) &&
+            (await this.__me.fetchPermissions(force)).has('KickMembers'));
     }
 }
 exports.GuildMember = GuildMember;

package/lib/structures/GuildPreview.d.ts

@@ -1,5 +1,5 @@
+import type { APIGuildPreview } from 'discord-api-types/v10';
 import type { UsingClient } from '../commands';
-import type { APIGuildPreview } from '../common';
 import { AnonymousGuild } from './AnonymousGuild';
 /**
  * Represent Discord Guild Preview Object

package/lib/structures/GuildRole.d.ts

@@ -1,5 +1,6 @@
+import type { APIRole, RESTPatchAPIGuildRoleJSONBody, RESTPatchAPIGuildRolePositionsJSONBody, RESTPostAPIGuildRoleJSONBody } from 'discord-api-types/v10';
 import type { UsingClient } from '../commands';
-import type { APIRole, MethodContext, ObjectToLower, RESTPatchAPIGuildRoleJSONBody, RESTPatchAPIGuildRolePositionsJSONBody, RESTPostAPIGuildRoleJSONBody } from '../common';
+import type { MethodContext, ObjectToLower } from '../common';
 import { DiscordBase } from './extra/DiscordBase';
 import { PermissionsBitField } from './extra/Permissions';
 export interface GuildRole extends DiscordBase, ObjectToLower<Omit<APIRole, 'permissions'>> {

package/lib/structures/GuildTemplate.d.ts

@@ -1,5 +1,6 @@
+import type { APITemplate, RESTPatchAPIGuildTemplateJSONBody, RESTPostAPIGuildTemplatesJSONBody } from 'discord-api-types/v10';
 import type { UsingClient } from '../commands';
-import type { APITemplate, MethodContext, ObjectToLower, RESTPatchAPIGuildTemplateJSONBody, RESTPostAPIGuildTemplatesJSONBody } from '../common';
+import type { MethodContext, ObjectToLower } from '../common';
 import { Base } from './extra/Base';
 export interface GuildTemplate extends Base, ObjectToLower<APITemplate> {
 }
@@ -14,7 +15,7 @@ export declare class GuildTemplate extends Base {
         guildId: string;
     }>): {
         fetch: (code: string) => Promise<APITemplate>;
-        list: () => Promise<import("discord-api-types/rest/v10/template").RESTGetAPIGuildTemplatesResult>;
+        list: () => Promise<import("discord-api-types/v10").RESTGetAPIGuildTemplatesResult>;
         create: (body: RESTPostAPIGuildTemplatesJSONBody) => Promise<APITemplate>;
         sync: (code: string) => Promise<APITemplate>;
         edit: (code: string, body: RESTPatchAPIGuildTemplateJSONBody) => Promise<APITemplate>;

package/lib/structures/Interaction.d.ts

@@ -1,6 +1,6 @@
+import { type APIApplicationCommandAutocompleteInteraction, type APIApplicationCommandInteraction, type APIBaseInteraction, type APIChatInputApplicationCommandInteraction, type APIChatInputApplicationCommandInteractionData, type APICommandAutocompleteInteractionResponseCallbackData, type APIInteraction, type APIInteractionResponse, type APIInteractionResponseChannelMessageWithSource, type APIInteractionResponseDeferredChannelMessageWithSource, type APIInteractionResponseDeferredMessageUpdate, type APIInteractionResponsePong, type APIInteractionResponseUpdateMessage, type APIMessageApplicationCommandInteraction, type APIMessageApplicationCommandInteractionData, type APIMessageButtonInteractionData, type APIMessageComponentInteraction, type APIMessageComponentSelectMenuInteraction, type APIMessageStringSelectInteractionData, type APIModalSubmission, type APIModalSubmitInteraction, type APIUserApplicationCommandInteraction, type APIUserApplicationCommandInteractionData, ApplicationCommandType, ComponentType, type GatewayInteractionCreateDispatchData, InteractionResponseType, InteractionType, type MessageFlags, type RESTPostAPIInteractionCallbackJSONBody } from 'discord-api-types/v10';
 import { OptionResolver, type UsingClient } from '../commands';
-import type { APIApplicationCommandAutocompleteInteraction, APIApplicationCommandInteraction, APIBaseInteraction, APIChatInputApplicationCommandInteraction, APIChatInputApplicationCommandInteractionData, APICommandAutocompleteInteractionResponseCallbackData, APIInteraction, APIInteractionResponse, APIInteractionResponseChannelMessageWithSource, APIInteractionResponseDeferredChannelMessageWithSource, APIInteractionResponseDeferredMessageUpdate, APIInteractionResponsePong, APIInteractionResponseUpdateMessage, APIMessageApplicationCommandInteraction, APIMessageApplicationCommandInteractionData, APIMessageButtonInteractionData, APIMessageComponentInteraction, APIMessageComponentSelectMenuInteraction, APIMessageStringSelectInteractionData, APIModalSubmission, APIModalSubmitInteraction, APIUserApplicationCommandInteraction, APIUserApplicationCommandInteractionData, GatewayInteractionCreateDispatchData, MessageFlags, ObjectToLower, OmitInsert, RESTPostAPIInteractionCallbackJSONBody, ToClass, When } from '../common';
-import { ApplicationCommandType, ComponentType, InteractionResponseType, InteractionType } from '../common';
+import type { ObjectToLower, OmitInsert, ToClass, When } from '../common';
 import type { ComponentInteractionMessageUpdate, InteractionCreateBodyRequest, InteractionMessageUpdateBodyRequest, MessageCreateBodyRequest, MessageUpdateBodyRequest, MessageWebhookCreateBodyRequest, ModalCreateBodyRequest } from '../common/types/write';
 import { InteractionGuildMember, type AllChannels } from './';
 import { GuildRole } from './GuildRole';
@@ -32,7 +32,7 @@ export declare class BaseInteraction<FromGuild extends boolean = boolean, Type e
     private matchReplied;
     reply(body: ReplyInteractionBody): Promise<void>;
     deferReply(flags?: MessageFlags): Promise<void>;
-    static from(client: UsingClient, gateway: GatewayInteractionCreateDispatchData, __reply?: __InternalReplyFunction): StringSelectMenuInteraction<string[]> | AutocompleteInteraction<boolean> | BaseInteraction<boolean, import("discord-api-types/payloads/v10/_interactions/ping").APIPingInteraction>;
+    static from(client: UsingClient, gateway: GatewayInteractionCreateDispatchData, __reply?: __InternalReplyFunction): StringSelectMenuInteraction<string[]> | AutocompleteInteraction<boolean> | BaseInteraction<boolean, import("discord-api-types/v10").APIPingInteraction>;
     fetchGuild(force?: boolean): Promise<import("./Guild").Guild<"cached"> | import("./Guild").Guild<"api">> | undefined;
 }
 export type AllInteractions = AutocompleteInteraction | ChatInputCommandInteraction | UserCommandInteraction | MessageCommandInteraction | ComponentInteraction | SelectMenuInteraction | ModalSubmitInteraction | BaseInteraction;
@@ -57,8 +57,8 @@ export declare class Interaction<FromGuild extends boolean = boolean, Type exten
     editOrReply<FR extends boolean = false>(body: InteractionCreateBodyRequest, fetchReply?: FR): Promise<When<FR, WebhookMessage, void>>;
     editMessage(messageId: string, body: InteractionMessageUpdateBodyRequest): Promise<Message>;
     editResponse(body: InteractionMessageUpdateBodyRequest): Promise<Message>;
-    deleteResponse(): Promise<void>;
-    deleteMessage(messageId: string): Promise<void>;
+    deleteResponse(): Promise<void | undefined>;
+    deleteMessage(messageId: string): Promise<void | undefined>;
     createResponse({ files, ...body }: MessageWebhookCreateBodyRequest): Promise<Message>;
 }
 export declare class ApplicationCommandInteraction<FromGuild extends boolean = boolean, Type extends APIApplicationCommandInteraction = APIApplicationCommandInteraction> extends Interaction<FromGuild, Type> {

package/lib/structures/Interaction.js

@@ -10,10 +10,10 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
 };
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.ModalSubmitInteraction = exports.MessageCommandInteraction = exports.UserCommandInteraction = exports.ChatInputCommandInteraction = exports.UserSelectMenuInteraction = exports.RoleSelectMenuInteraction = exports.MentionableSelectMenuInteraction = exports.ChannelSelectMenuInteraction = exports.StringSelectMenuInteraction = exports.SelectMenuInteraction = exports.ButtonInteraction = exports.ComponentInteraction = exports.ApplicationCommandInteraction = exports.Interaction = exports.AutocompleteInteraction = exports.BaseInteraction = void 0;
+const v10_1 = require("discord-api-types/v10");
 const ts_mixer_1 = require("ts-mixer");
 const builders_1 = require("../builders");
 const commands_1 = require("../commands");
-const common_1 = require("../common");
 const _1 = require("./");
 const GuildRole_1 = require("./GuildRole");
 const Message_1 = require("./Message");
@@ -50,12 +50,12 @@ class BaseInteraction extends DiscordBase_1.DiscordBase {
     }
     static transformBodyRequest(body) {
         switch (body.type) {
-            case common_1.InteractionResponseType.ApplicationCommandAutocompleteResult:
-            case common_1.InteractionResponseType.DeferredMessageUpdate:
-            case common_1.InteractionResponseType.DeferredChannelMessageWithSource:
+            case v10_1.InteractionResponseType.ApplicationCommandAutocompleteResult:
+            case v10_1.InteractionResponseType.DeferredMessageUpdate:
+            case v10_1.InteractionResponseType.DeferredChannelMessageWithSource:
                 return body;
-            case common_1.InteractionResponseType.ChannelMessageWithSource:
-            case common_1.InteractionResponseType.UpdateMessage:
+            case v10_1.InteractionResponseType.ChannelMessageWithSource:
+            case v10_1.InteractionResponseType.UpdateMessage:
                 return {
                     type: body.type,
                     // @ts-ignore
@@ -68,7 +68,7 @@ class BaseInteraction extends DiscordBase_1.DiscordBase {
                         attachments: body.data?.attachments?.map((x, i) => ({ id: i, ...(0, builders_1.resolveAttachment)(x) })) ?? undefined,
                     },
                 };
-            case common_1.InteractionResponseType.Modal:
+            case v10_1.InteractionResponseType.Modal:
                 return {
                     type: body.type,
                     data: body.data instanceof builders_1.Modal
@@ -122,7 +122,7 @@ class BaseInteraction extends DiscordBase_1.DiscordBase {
     }
     deferReply(flags) {
         return this.reply({
-            type: common_1.InteractionResponseType.DeferredChannelMessageWithSource,
+            type: v10_1.InteractionResponseType.DeferredChannelMessageWithSource,
             data: {
                 flags,
             },
@@ -130,35 +130,35 @@ class BaseInteraction extends DiscordBase_1.DiscordBase {
     }
     static from(client, gateway, __reply) {
         switch (gateway.type) {
-            case common_1.InteractionType.ApplicationCommandAutocomplete:
+            case v10_1.InteractionType.ApplicationCommandAutocomplete:
                 return new AutocompleteInteraction(client, gateway, __reply);
             // biome-ignore lint/suspicious/noFallthroughSwitchClause: bad interaction  between biome and ts-server
-            case common_1.InteractionType.ApplicationCommand:
+            case v10_1.InteractionType.ApplicationCommand:
                 switch (gateway.data.type) {
-                    case common_1.ApplicationCommandType.ChatInput:
+                    case v10_1.ApplicationCommandType.ChatInput:
                         return new ChatInputCommandInteraction(client, gateway, __reply);
-                    case common_1.ApplicationCommandType.User:
+                    case v10_1.ApplicationCommandType.User:
                         return new UserCommandInteraction(client, gateway, __reply);
-                    case common_1.ApplicationCommandType.Message:
+                    case v10_1.ApplicationCommandType.Message:
                         return new MessageCommandInteraction(client, gateway, __reply);
                 }
             // biome-ignore lint/suspicious/noFallthroughSwitchClause: bad interaction  between biome and ts-server
-            case common_1.InteractionType.MessageComponent:
+            case v10_1.InteractionType.MessageComponent:
                 switch (gateway.data.component_type) {
-                    case common_1.ComponentType.Button:
+                    case v10_1.ComponentType.Button:
                         return new ButtonInteraction(client, gateway, __reply);
-                    case common_1.ComponentType.ChannelSelect:
+                    case v10_1.ComponentType.ChannelSelect:
                         return new ChannelSelectMenuInteraction(client, gateway, __reply);
-                    case common_1.ComponentType.RoleSelect:
+                    case v10_1.ComponentType.RoleSelect:
                         return new RoleSelectMenuInteraction(client, gateway, __reply);
-                    case common_1.ComponentType.MentionableSelect:
+                    case v10_1.ComponentType.MentionableSelect:
                         return new MentionableSelectMenuInteraction(client, gateway, __reply);
-                    case common_1.ComponentType.UserSelect:
+                    case v10_1.ComponentType.UserSelect:
                         return new UserSelectMenuInteraction(client, gateway, __reply);
-                    case common_1.ComponentType.StringSelect:
+                    case v10_1.ComponentType.StringSelect:
                         return new StringSelectMenuInteraction(client, gateway, __reply);
                 }
-            case common_1.InteractionType.ModalSubmit:
+            case v10_1.InteractionType.ModalSubmit:
                 return new ModalSubmitInteraction(client, gateway);
             default:
                 return new BaseInteraction(client, gateway);
@@ -181,7 +181,7 @@ class AutocompleteInteraction extends BaseInteraction {
         return this.options.getAutocompleteValue() ?? '';
     }
     respond(choices) {
-        return super.reply({ data: { choices }, type: common_1.InteractionResponseType.ApplicationCommandAutocompleteResult });
+        return super.reply({ data: { choices }, type: v10_1.InteractionResponseType.ApplicationCommandAutocompleteResult });
     }
     /** @intenal */
     async reply(..._args) {
@@ -198,7 +198,7 @@ class Interaction extends BaseInteraction {
     }
     async write(body, fetchReply) {
         (await this.reply({
-            type: common_1.InteractionResponseType.ChannelMessageWithSource,
+            type: v10_1.InteractionResponseType.ChannelMessageWithSource,
             data: body,
         }));
         if (fetchReply)
@@ -207,7 +207,7 @@ class Interaction extends BaseInteraction {
     }
     modal(body) {
         return this.reply({
-            type: common_1.InteractionResponseType.Modal,
+            type: v10_1.InteractionResponseType.Modal,
             data: body,
         });
     }
@@ -240,7 +240,7 @@ class Interaction extends BaseInteraction {
             .webhooks(this.applicationId)(this.token)
             .messages(messageId)
             .delete()
-            .then(() => this.client.components.onMessageDelete(messageId === '@original' ? this.id : messageId));
+            .then(() => this.client.components?.onMessageDelete(messageId === '@original' ? this.id : messageId));
     }
     async createResponse({ files, ...body }) {
         files ??= files ? await (0, builders_1.resolveFiles)(files) : undefined;
@@ -255,7 +255,7 @@ class Interaction extends BaseInteraction {
 }
 exports.Interaction = Interaction;
 class ApplicationCommandInteraction extends Interaction {
-    type = common_1.ApplicationCommandType.ChatInput;
+    type = v10_1.ApplicationCommandType.ChatInput;
     respond(data) {
         return this.reply(data);
     }
@@ -264,13 +264,13 @@ exports.ApplicationCommandInteraction = ApplicationCommandInteraction;
 class ComponentInteraction extends Interaction {
     update(data) {
         return this.reply({
-            type: common_1.InteractionResponseType.UpdateMessage,
+            type: v10_1.InteractionResponseType.UpdateMessage,
             data,
         });
     }
     deferUpdate() {
         return this.reply({
-            type: common_1.InteractionResponseType.DeferredMessageUpdate,
+            type: v10_1.InteractionResponseType.DeferredMessageUpdate,
         });
     }
     get customId() {
@@ -280,22 +280,22 @@ class ComponentInteraction extends Interaction {
         return this.data.componentType;
     }
     isButton() {
-        return this.data.componentType === common_1.ComponentType.Button;
+        return this.data.componentType === v10_1.ComponentType.Button;
     }
     isChannelSelectMenu() {
-        return this.componentType === common_1.ComponentType.ChannelSelect;
+        return this.componentType === v10_1.ComponentType.ChannelSelect;
     }
     isRoleSelectMenu() {
-        return this.componentType === common_1.ComponentType.RoleSelect;
+        return this.componentType === v10_1.ComponentType.RoleSelect;
     }
     isMentionableSelectMenu() {
-        return this.componentType === common_1.ComponentType.MentionableSelect;
+        return this.componentType === v10_1.ComponentType.MentionableSelect;
     }
     isUserSelectMenu() {
-        return this.componentType === common_1.ComponentType.UserSelect;
+        return this.componentType === v10_1.ComponentType.UserSelect;
     }
     isStringSelectMenu() {
-        return this.componentType === common_1.ComponentType.StringSelect;
+        return this.componentType === v10_1.ComponentType.StringSelect;
     }
 }
 exports.ComponentInteraction = ComponentInteraction;

package/lib/structures/Message.d.ts

@@ -1,6 +1,7 @@
+import type { APIChannelMention, APIMessage, GatewayMessageCreateDispatchData } from 'discord-api-types/v10';
 import type { ListenerOptions } from '../builders';
 import type { UsingClient } from '../commands';
-import type { APIChannelMention, APIMessage, GatewayMessageCreateDispatchData, ObjectToLower } from '../common';
+import type { ObjectToLower } from '../common';
 import type { EmojiResolvable } from '../common/types/resolvables';
 import type { MessageCreateBodyRequest, MessageUpdateBodyRequest } from '../common/types/write';
 import type { ActionRowMessageComponents } from '../components';
@@ -26,8 +27,8 @@ export declare class BaseMessage extends DiscordBase {
     constructor(client: UsingClient, data: MessageData);
     get user(): User;
     createComponentCollector(options?: ListenerOptions): {
-        run: (customId: string | RegExp | string[], callback: import("../builders").ComponentCallback) => any;
-        stop: (reason?: string | undefined) => void;
+        run<T extends import("./Interaction").StringSelectMenuInteraction<string[]> | import("./Interaction").ComponentInteraction<boolean, import("discord-api-types/v10").APIMessageComponentInteraction> = import("./Interaction").StringSelectMenuInteraction<string[]> | import("./Interaction").ComponentInteraction<boolean, import("discord-api-types/v10").APIMessageComponentInteraction>>(customId: string | RegExp | string[], callback: import("../builders").ComponentCallback<T>): any;
+        stop(reason?: string | undefined): any;
     };
     get url(): string;
     guild(force?: boolean): Promise<import("./Guild").Guild<"cached"> | import("./Guild").Guild<"api">> | undefined;
@@ -43,7 +44,7 @@ export declare class Message extends BaseMessage {
     reply(body: Omit<MessageCreateBodyRequest, 'message_reference'>, fail?: boolean): Promise<Message>;
     edit(body: MessageUpdateBodyRequest): Promise<Message>;
     write(body: MessageCreateBodyRequest): Promise<Message>;
-    delete(reason?: string): Promise<void>;
+    delete(reason?: string): Promise<void | undefined>;
     crosspost(reason?: string): Promise<Message>;
 }
 export type EditMessageWebhook = Omit<MessageWebhookMethodEditParams, 'messageId'>;
@@ -52,7 +53,7 @@ export declare class WebhookMessage extends BaseMessage {
     readonly webhookId: string;
     readonly webhookToken: string;
     constructor(client: UsingClient, data: MessageData, webhookId: string, webhookToken: string);
-    fetch(): Promise<import("discord-api-types/rest/v10/webhook").RESTGetAPIWebhookWithTokenResult>;
+    fetch(): Promise<import("discord-api-types/v10").RESTGetAPIWebhookWithTokenResult>;
     edit(body: EditMessageWebhook): Promise<WebhookMessage>;
     write(body: WriteMessageWebhook): Promise<WebhookMessage | null>;
     delete(reason?: string): Promise<never>;

package/lib/structures/Sticker.d.ts

@@ -1,6 +1,7 @@
+import type { APISticker, RESTPatchAPIGuildStickerJSONBody, RESTPostAPIGuildStickerFormDataBody } from 'discord-api-types/v10';
 import type { UsingClient } from '..';
 import type { Attachment } from '../builders';
-import type { APISticker, MethodContext, ObjectToLower, RESTPatchAPIGuildStickerJSONBody, RESTPostAPIGuildStickerFormDataBody } from '../common';
+import type { MethodContext, ObjectToLower } from '../common';
 import { User } from './User';
 import { DiscordBase } from './extra/DiscordBase';
 export interface Sticker extends DiscordBase, ObjectToLower<Omit<APISticker, 'user'>> {

package/lib/structures/User.d.ts

@@ -1,4 +1,5 @@
-import type { APIUser, MessageCreateBodyRequest, ObjectToLower } from '../common';
+import type { APIUser } from 'discord-api-types/v10';
+import type { MessageCreateBodyRequest, ObjectToLower } from '../common';
 import type { ImageOptions } from '../common/types/options';
 import { DiscordBase } from './extra/DiscordBase';
 export interface User extends ObjectToLower<APIUser> {
@@ -16,8 +17,11 @@ export declare class User extends DiscordBase<APIUser> {
     dm(force?: boolean): Promise<import("./channels").DMChannel>;
     write(body: MessageCreateBodyRequest): Promise<import("./Message").Message>;
     avatarURL(options?: ImageOptions): string;
-    presence(): import("..").ReturnCache<(Omit<import("discord-api-types/payloads/v10/gateway").GatewayPresenceUpdate, "user"> & {
-        id: string;
+    bannerURL(options?: ImageOptions): string | undefined;
+    presence(): import("..").ReturnCache<(Omit<import("discord-api-types/v10").GatewayPresenceUpdate, "user"> & {
+        id: string; /**
+         * Fetch user
+         */
     } & {
         guild_id: string;
     }) | undefined>;

package/lib/structures/User.js

@@ -30,6 +30,11 @@ class User extends DiscordBase_1.DiscordBase {
         }
         return this.rest.cdn.avatar(this.id, this.avatar, options);
     }
+    bannerURL(options) {
+        if (!this.banner)
+            return;
+        return this.rest.cdn.banner(this.id, this.banner, options);
+    }
     presence() {
         return this.cache.presences?.get(this.id);
     }

package/lib/structures/Webhook.d.ts

@@ -1,42 +1,101 @@
+/**
+ * Represents a Discord webhook.
+ */
+import type { APIWebhook, RESTGetAPIWebhookWithTokenMessageQuery, RESTPatchAPIWebhookJSONBody, RESTPatchAPIWebhookWithTokenJSONBody, RESTPostAPIWebhookWithTokenQuery } from 'discord-api-types/v10';
 import type { UsingClient } from '../commands';
-import type { APIWebhook, ImageOptions, MessageWebhookCreateBodyRequest, MessageWebhookPayload, MessageWebhookUpdateBodyRequest, MethodContext, ObjectToLower, RESTGetAPIWebhookWithTokenMessageQuery, RESTPatchAPIWebhookJSONBody, RESTPatchAPIWebhookWithTokenJSONBody, RESTPostAPIWebhookWithTokenQuery } from '../common';
+import type { ImageOptions, MessageWebhookCreateBodyRequest, MessageWebhookPayload, MessageWebhookUpdateBodyRequest, MethodContext, ObjectToLower } from '../common';
 import { AnonymousGuild } from './AnonymousGuild';
 import { User } from './User';
 import { DiscordBase } from './extra/DiscordBase';
 export interface Webhook extends DiscordBase, ObjectToLower<Omit<APIWebhook, 'user' | 'source_guild'>> {
 }
+/**
+ * Represents a Discord webhook.
+ */
 export declare class Webhook extends DiscordBase {
+    /** The user associated with the webhook, if applicable. */
     user?: User;
+    /** The source guild of the webhook, if applicable. */
     sourceGuild?: Partial<AnonymousGuild>;
+    /** Methods related to interacting with messages through the webhook. */
     messages: ReturnType<typeof Webhook.messages>;
+    /**
+     * Constructs a new Webhook instance.
+     * @param client The Discord client instance.
+     * @param data The data representing the webhook.
+     */
     constructor(client: UsingClient, data: APIWebhook);
+    /**
+     * Fetches the guild associated with the webhook.
+     * @param force Whether to force fetching the guild even if it's already cached.
+     * @returns A promise that resolves to the guild associated with the webhook, or undefined if not applicable.
+     */
     guild(force?: boolean): Promise<import("./Guild").Guild<"cached"> | import("./Guild").Guild<"api">> | undefined;
-    channel(force?: boolean): Promise<import("./channels").BaseChannel<import("discord-api-types/payloads/v10/channel").ChannelType> | import("./channels").DMChannel | import("./channels").CategoryChannel | undefined>;
+    /**
+     * Fetches the channel associated with the webhook.
+     * @param force Whether to force fetching the channel even if it's already cached.
+     * @returns A promise that resolves to the channel associated with the webhook, or undefined if not applicable.
+     */
+    channel(force?: boolean): Promise<import("./channels").BaseChannel<import("discord-api-types/v10").ChannelType> | import("./channels").DMChannel | import("./channels").CategoryChannel | undefined>;
+    /**
+     * Retrieves the avatar URL of the webhook.
+     * @param options The image options for the avatar.
+     * @returns The avatar URL of the webhook, or null if no avatar is set.
+     */
     avatarURL(options?: ImageOptions): string | null;
+    /**
+     * Fetches the webhook data from the Discord API.
+     * @returns A promise that resolves to the fetched webhook data.
+     */
     fetch(): Promise<Webhook>;
-    edit(body: RESTPatchAPIWebhookJSONBody | RESTPatchAPIWebhookWithTokenJSONBody, reason?: string): Promise<import("discord-api-types/rest/v10/webhook").RESTGetAPIWebhookWithTokenResult>;
+    /**
+     * Edits the webhook.
+     * @param body The new webhook data.
+     * @param reason The reason for editing the webhook.
+     * @returns A promise that resolves when the webhook is successfully edited.
+     */
+    edit(body: RESTPatchAPIWebhookJSONBody | RESTPatchAPIWebhookWithTokenJSONBody, reason?: string): Promise<import("discord-api-types/v10").RESTGetAPIWebhookWithTokenResult>;
+    /**
+     * Deletes the webhook.
+     * @param reason The reason for deleting the webhook.
+     * @returns A promise that resolves when the webhook is successfully deleted.
+     */
     delete(reason?: string): Promise<never>;
+    /**
+     * Static methods related to interacting with messages through webhooks.
+     */
     static messages({ client, webhookId, webhookToken }: MethodContext<{
         webhookId: string;
         webhookToken: string;
     }>): {
+        /** Writes a message through the webhook. */
         write: (payload: MessageWebhookMethodWriteParams) => Promise<import("./Message").WebhookMessage | null>;
+        /** Edits a message sent through the webhook. */
         edit: (payload: MessageWebhookMethodEditParams) => Promise<import("./Message").WebhookMessage>;
+        /** Deletes a message sent through the webhook. */
         delete: (messageId: string, reason?: string) => Promise<never>;
     };
+    /**
+     * Static methods related to managing webhooks.
+     */
     static methods({ client, webhookId, webhookToken }: MethodContext<{
         webhookId: string;
         webhookToken?: string;
     }>): {
+        /** Deletes the webhook. */
         delete: (reason?: string) => Promise<never>;
-        edit: (body: RESTPatchAPIWebhookWithTokenJSONBody | RESTPatchAPIWebhookJSONBody, reason?: string) => Promise<import("discord-api-types/rest/v10/webhook").RESTGetAPIWebhookWithTokenResult>;
+        /** Edits the webhook. */
+        edit: (body: RESTPatchAPIWebhookWithTokenJSONBody | RESTPatchAPIWebhookJSONBody, reason?: string) => Promise<import("discord-api-types/v10").RESTGetAPIWebhookWithTokenResult>;
+        /** Fetches the webhook data from the Discord API. */
         fetch: () => Promise<Webhook>;
     };
 }
+/** Type definition for parameters of editing a message through a webhook. */
 export type MessageWebhookMethodEditParams = MessageWebhookPayload<MessageWebhookUpdateBodyRequest, {
     messageId: string;
     query?: RESTGetAPIWebhookWithTokenMessageQuery;
 }>;
+/** Type definition for parameters of writing a message through a webhook. */
 export type MessageWebhookMethodWriteParams = MessageWebhookPayload<MessageWebhookCreateBodyRequest, {
     query?: RESTPostAPIWebhookWithTokenQuery;
 }>;

package/lib/structures/Webhook.js

@@ -4,10 +4,21 @@ exports.Webhook = void 0;
 const AnonymousGuild_1 = require("./AnonymousGuild");
 const User_1 = require("./User");
 const DiscordBase_1 = require("./extra/DiscordBase");
+/**
+ * Represents a Discord webhook.
+ */
 class Webhook extends DiscordBase_1.DiscordBase {
+    /** The user associated with the webhook, if applicable. */
     user;
+    /** The source guild of the webhook, if applicable. */
     sourceGuild;
+    /** Methods related to interacting with messages through the webhook. */
     messages;
+    /**
+     * Constructs a new Webhook instance.
+     * @param client The Discord client instance.
+     * @param data The data representing the webhook.
+     */
     constructor(client, data) {
         super(client, data);
         if (data.user) {
@@ -20,42 +31,84 @@ class Webhook extends DiscordBase_1.DiscordBase {
             messages: Webhook.messages({ client, webhookId: this.id, webhookToken: this.token }),
         });
     }
+    /**
+     * Fetches the guild associated with the webhook.
+     * @param force Whether to force fetching the guild even if it's already cached.
+     * @returns A promise that resolves to the guild associated with the webhook, or undefined if not applicable.
+     */
     guild(force = false) {
         if (!this.sourceGuild?.id)
             return;
         return this.client.guilds.fetch(this.sourceGuild.id, force);
     }
+    /**
+     * Fetches the channel associated with the webhook.
+     * @param force Whether to force fetching the channel even if it's already cached.
+     * @returns A promise that resolves to the channel associated with the webhook, or undefined if not applicable.
+     */
     async channel(force = false) {
         if (!this.sourceChannel?.id)
             return;
         return this.client.channels.fetch(this.sourceChannel.id, force);
     }
+    /**
+     * Retrieves the avatar URL of the webhook.
+     * @param options The image options for the avatar.
+     * @returns The avatar URL of the webhook, or null if no avatar is set.
+     */
     avatarURL(options) {
         if (!this.avatar) {
             return null;
         }
         return this.rest.cdn.avatar(this.id, this.avatar, options);
     }
+    /**
+     * Fetches the webhook data from the Discord API.
+     * @returns A promise that resolves to the fetched webhook data.
+     */
     async fetch() {
         return this.client.webhooks.fetch(this.id, this.token);
     }
+    /**
+     * Edits the webhook.
+     * @param body The new webhook data.
+     * @param reason The reason for editing the webhook.
+     * @returns A promise that resolves when the webhook is successfully edited.
+     */
     async edit(body, reason) {
         return this.client.webhooks.edit(this.id, body, { reason, token: this.token });
     }
+    /**
+     * Deletes the webhook.
+     * @param reason The reason for deleting the webhook.
+     * @returns A promise that resolves when the webhook is successfully deleted.
+     */
     delete(reason) {
         return this.client.webhooks.delete(this.id, { token: this.token, reason });
     }
+    /**
+     * Static methods related to interacting with messages through webhooks.
+     */
     static messages({ client, webhookId, webhookToken }) {
         return {
+            /** Writes a message through the webhook. */
             write: (payload) => client.webhooks.writeMessage(webhookId, webhookToken, payload),
+            /** Edits a message sent through the webhook. */
             edit: (payload) => client.webhooks.editMessage(webhookId, webhookToken, payload),
+            /** Deletes a message sent through the webhook. */
             delete: (messageId, reason) => client.webhooks.deleteMessage(webhookId, webhookToken, messageId, reason),
         };
     }
+    /**
+     * Static methods related to managing webhooks.
+     */
     static methods({ client, webhookId, webhookToken }) {
         return {
+            /** Deletes the webhook. */
             delete: (reason) => client.webhooks.delete(webhookId, { reason, token: webhookToken }),
+            /** Edits the webhook. */
             edit: (body, reason) => client.webhooks.edit(webhookId, body, { token: webhookToken, reason }),
+            /** Fetches the webhook data from the Discord API. */
             fetch: () => client.webhooks.fetch(webhookId, webhookToken),
         };
     }