seyfert 0.1.0

package/lib/common/shorters/guilds.js

@@ -0,0 +1,350 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.GuildShorter = void 0;
+const builders_1 = require("../../builders");
+const structures_1 = require("../../structures");
+const channels_1 = __importDefault(require("../../structures/channels"));
+const base_1 = require("./base");
+class GuildShorter extends base_1.BaseShorter {
+    /**
+     * Provides access to guild-related functionality.
+     */
+    get guilds() {
+        return {
+            /**
+             * Creates a new guild.
+             * @param body The data for creating the guild.
+             * @returns A Promise that resolves to the created guild.
+             */
+            create: async (body) => {
+                const guild = await this.client.proxy.guilds.post({ body });
+                await this.client.cache.guilds?.setIfNI('Guilds', guild.id, guild);
+                return new structures_1.Guild(this.client, guild);
+            },
+            /**
+             * 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.
+             * @returns A Promise that resolves to the fetched guild.
+             */
+            fetch: async (id, force = false) => {
+                if (!force) {
+                    const guild = await this.client.cache.guilds?.get(id);
+                    if (guild)
+                        return guild;
+                }
+                const data = await this.client.proxy.guilds(id).get();
+                await this.client.cache.guilds?.patch(id, data);
+                return (await this.client.cache.guilds?.get(id)) ?? new structures_1.Guild(this.client, data);
+            },
+            /**
+             * Generates the widget URL for the guild.
+             * @param id The ID of the guild.
+             * @param style The style of the widget.
+             * @returns The generated widget URL.
+             */
+            widgetURL: (id, style) => {
+                const query = new URLSearchParams();
+                if (style) {
+                    query.append('style', style);
+                }
+                return this.client.proxy.guilds(id).widget.get({ query });
+            },
+            channels: this.channels,
+            moderation: this.moderation,
+            stickers: this.stickers,
+            emojis: this.emojis,
+        };
+    }
+    /**
+     * Provides access to emoji-related functionality in a guild.
+     */
+    get emojis() {
+        return {
+            /**
+             * Retrieves a list of emojis in the guild.
+             * @param guildId The ID of the guild.
+             * @param force Whether to force fetching emojis from the API even if they exist in the cache.
+             * @returns A Promise that resolves to an array of emojis.
+             */
+            list: async (guildId, force = false) => {
+                let emojis;
+                if (!force) {
+                    emojis = (await this.client.cache.emojis?.values(guildId)) ?? [];
+                    if (emojis.length) {
+                        return emojis;
+                    }
+                }
+                emojis = await this.client.proxy.guilds(guildId).emojis.get();
+                await this.client.cache.emojis?.set(emojis.map(x => [x.id, x]), guildId);
+                return emojis.map(m => new structures_1.GuildEmoji(this.client, m, guildId));
+            },
+            /**
+             * Creates a new emoji in the guild.
+             * @param guildId The ID of the guild.
+             * @param body The data for creating the emoji.
+             * @returns A Promise that resolves to the created emoji.
+             */
+            create: async (guildId, body) => {
+                const bodyResolved = { ...body, image: await (0, builders_1.resolveImage)(body.image) };
+                const emoji = await this.client.proxy.guilds(guildId).emojis.post({
+                    body: bodyResolved,
+                });
+                await this.client.cache.channels?.setIfNI('GuildEmojisAndStickers', emoji.id, guildId, emoji);
+            },
+            /**
+             * Fetches an emoji by its ID.
+             * @param guildId The ID of the guild.
+             * @param emojiId The ID of the emoji to fetch.
+             * @param force Whether to force fetching the emoji from the API even if it exists in the cache.
+             * @returns A Promise that resolves to the fetched emoji.
+             */
+            fetch: async (guildId, emojiId, force = false) => {
+                let emoji;
+                if (!force) {
+                    emoji = await this.client.cache.emojis?.get(emojiId);
+                    if (emoji)
+                        return emoji;
+                }
+                emoji = await this.client.proxy.guilds(guildId).emojis(emojiId).get();
+                return new structures_1.GuildEmoji(this.client, emoji, guildId);
+            },
+            /**
+             * Deletes an emoji from the guild.
+             * @param guildId The ID of the guild.
+             * @param emojiId The ID of the emoji to delete.
+             * @param reason The reason for deleting the emoji.
+             */
+            delete: async (guildId, emojiId, reason) => {
+                await this.client.proxy.guilds(guildId).emojis(emojiId).delete({ reason });
+                await this.client.cache.channels?.removeIfNI('GuildEmojisAndStickers', emojiId, guildId);
+            },
+            /**
+             * Edits an emoji in the guild.
+             * @param guildId The ID of the guild.
+             * @param emojiId The ID of the emoji to edit.
+             * @param body The data to update the emoji with.
+             * @param reason The reason for editing the emoji.
+             * @returns A Promise that resolves to the edited emoji.
+             */
+            edit: async (guildId, emojiId, body, reason) => {
+                const emoji = await this.client.proxy.guilds(guildId).emojis(emojiId).patch({ body, reason });
+                await this.client.cache.channels?.setIfNI('GuildEmojisAndStickers', emoji.id, guildId, emoji);
+                return new structures_1.GuildEmoji(this.client, emoji, guildId);
+            },
+        };
+    }
+    /**
+     * Provides access to channel-related functionality in a guild.
+     */
+    get channels() {
+        return {
+            /**
+             * Retrieves a list of channels in the guild.
+             * @param guildId The ID of the guild.
+             * @param force Whether to force fetching channels from the API even if they exist in the cache.
+             * @returns A Promise that resolves to an array of channels.
+             */
+            list: async (guildId, force = false) => {
+                let channels;
+                if (!force) {
+                    channels = (await this.client.cache.channels?.values(guildId)) ?? [];
+                    if (channels.length) {
+                        return channels;
+                    }
+                }
+                channels = await this.client.proxy.guilds(guildId).channels.get();
+                await this.client.cache.channels?.set(channels.map(x => [x.id, x]), guildId);
+                return channels.map(m => (0, channels_1.default)(m, this.client));
+            },
+            /**
+             * Fetches a channel by its ID.
+             * @param guildId The ID of the guild.
+             * @param channelId The ID of the channel to fetch.
+             * @param force Whether to force fetching the channel from the API even if it exists in the cache.
+             * @returns A Promise that resolves to the fetched channel.
+             */
+            fetch: async (guildId, channelId, force) => {
+                let channel;
+                if (!force) {
+                    channel = await this.client.cache.channels?.get(channelId);
+                    if (channel)
+                        return channel;
+                }
+                channel = await this.client.proxy.channels(channelId).get();
+                await this.client.cache.channels?.patch(channelId, guildId, channel);
+                return (0, channels_1.default)(channel, this.client);
+            },
+            /**
+             * Creates a new channel in the guild.
+             * @param guildId The ID of the guild.
+             * @param body The data for creating the channel.
+             * @returns A Promise that resolves to the created channel.
+             */
+            create: async (guildId, body) => {
+                const res = await this.client.proxy.guilds(guildId).channels.post({ body });
+                await this.client.cache.channels?.setIfNI(structures_1.BaseChannel.__intent__(guildId), res.id, guildId, res);
+                return (0, channels_1.default)(res, this.client);
+            },
+            /**
+             * Deletes a channel from the guild.
+             * @param guildId The ID of the guild.
+             * @param channelId The ID of the channel to delete.
+             * @param reason The reason for deleting the channel.
+             * @returns A Promise that resolves to the deleted channel.
+             */
+            delete: async (guildId, channelId, reason) => {
+                const res = await this.client.proxy.channels(channelId).delete({ reason });
+                await this.client.cache.channels?.removeIfNI(structures_1.BaseChannel.__intent__(guildId), res.id, guildId);
+                return (0, channels_1.default)(res, this.client);
+            },
+            /**
+             * Edits a channel in the guild.
+             * @param guildchannelId The ID of the guild.
+             * @param channelId The ID of the channel to edit.
+             * @param body The data to update the channel with.
+             * @param reason The reason for editing the channel.
+             * @returns A Promise that resolves to the edited channel.
+             */
+            edit: async (guildchannelId, channelId, body, reason) => {
+                const res = await this.client.proxy.channels(channelId).patch({ body, reason });
+                await this.client.cache.channels?.setIfNI(structures_1.BaseChannel.__intent__(guildchannelId), res.id, guildchannelId, res);
+                return (0, channels_1.default)(res, this.client);
+            },
+            /**
+             * Edits the positions of channels in the guild.
+             * @param guildId The ID of the guild.
+             * @param body The data containing the new positions of channels.
+             */
+            editPositions: (guildId, body) => this.client.proxy.guilds(guildId).channels.patch({ body }),
+        };
+    }
+    /**
+     * Provides access to auto-moderation rule-related functionality in a guild.
+     */
+    get moderation() {
+        return {
+            /**
+             * Retrieves a list of auto-moderation rules in the guild.
+             * @param guildId The ID of the guild.
+             * @returns A Promise that resolves to an array of auto-moderation rules.
+             */
+            list: (guildId) => this.client.proxy.guilds(guildId)['auto-moderation'].rules.get(),
+            /**
+             * Creates a new auto-moderation rule in the guild.
+             * @param guildId The ID of the guild.
+             * @param body The data for creating the auto-moderation rule.
+             * @returns A Promise that resolves to the created auto-moderation rule.
+             */
+            create: (guildId, body) => this.client.proxy.guilds(guildId)['auto-moderation'].rules.post({ body }),
+            /**
+             * Deletes an auto-moderation rule from the guild.
+             * @param guildId The ID of the guild.
+             * @param ruleId The ID of the rule to delete.
+             * @param reason The reason for deleting the rule.
+             * @returns A Promise that resolves once the rule is deleted.
+             */
+            delete: (guildId, ruleId, reason) => {
+                return this.client.proxy.guilds(guildId)['auto-moderation'].rules(ruleId).delete({ reason });
+            },
+            /**
+             * Fetches an auto-moderation rule by its ID.
+             * @param guildId The ID of the guild.
+             * @param ruleId The ID of the rule to fetch.
+             * @returns A Promise that resolves to the fetched auto-moderation rule.
+             */
+            fetch: (guildId, ruleId) => {
+                return this.client.proxy.guilds(guildId)['auto-moderation'].rules(ruleId).get();
+            },
+            /**
+             * Edits an auto-moderation rule in the guild.
+             * @param guildId The ID of the guild.
+             * @param ruleId The ID of the rule to edit.
+             * @param body The data to update the rule with.
+             * @param reason The reason for editing the rule.
+             * @returns A Promise that resolves to the edited auto-moderation rule.
+             */
+            edit: (guildId, ruleId, body, reason) => {
+                return this.client.proxy.guilds(guildId)['auto-moderation'].rules(ruleId).patch({ body, reason });
+            },
+        };
+    }
+    /**
+     * Provides access to sticker-related functionality in a guild.
+     */
+    get stickers() {
+        return {
+            /**
+             * Retrieves a list of stickers in the guild.
+             * @param guildId The ID of the guild.
+             * @returns A Promise that resolves to an array of stickers.
+             */
+            list: async (guildId) => {
+                const stickers = await this.client.proxy.guilds(guildId).stickers.get();
+                await this.client.cache.stickers?.set(stickers.map(st => [st.id, st]), guildId);
+                return stickers.map(st => new structures_1.Sticker(this.client, st));
+            },
+            /**
+             * Creates a new sticker in the guild.
+             * @param guildId The ID of the guild.
+             * @param request The request body for creating the sticker.
+             * @param reason The reason for creating the sticker.
+             * @returns A Promise that resolves to the created sticker.
+             */
+            create: async (guildId, { file, ...json }, reason) => {
+                const fileResolve = await (0, builders_1.resolveFiles)([file]);
+                const sticker = await this.client.proxy
+                    .guilds(guildId)
+                    .stickers.post({ reason, body: json, files: [{ ...fileResolve[0], key: 'file' }], appendToFormData: true });
+                await this.client.cache.stickers?.setIfNI('GuildEmojisAndStickers', sticker.id, guildId, sticker);
+                return new structures_1.Sticker(this.client, sticker);
+            },
+            /**
+             * Edits an existing sticker in the guild.
+             * @param guildId The ID of the guild.
+             * @param stickerId The ID of the sticker to edit.
+             * @param body The data to update the sticker with.
+             * @param reason The reason for editing the sticker.
+             * @returns A Promise that resolves to the edited sticker.
+             */
+            edit: async (guildId, stickerId, body, reason) => {
+                const sticker = await this.client.proxy.guilds(guildId).stickers(stickerId).patch({ body, reason });
+                await this.client.cache.stickers?.setIfNI('GuildEmojisAndStickers', stickerId, guildId, sticker);
+                return new structures_1.Sticker(this.client, sticker);
+            },
+            /**
+             * Fetches a sticker by its ID from the guild.
+             * @param guildId The ID of the guild.
+             * @param stickerId The ID of the sticker to fetch.
+             * @param force Whether to force fetching the sticker from the API even if it exists in the cache.
+             * @returns A Promise that resolves to the fetched sticker.
+             */
+            fetch: async (guildId, stickerId, force = false) => {
+                let sticker;
+                if (!force) {
+                    sticker = await this.client.cache.stickers?.get(stickerId);
+                    if (sticker)
+                        return sticker;
+                }
+                sticker = await this.client.proxy.guilds(guildId).stickers(stickerId).get();
+                await this.client.cache.stickers?.patch(stickerId, guildId, sticker);
+                return new structures_1.Sticker(this.client, sticker);
+            },
+            /**
+             * Deletes a sticker from the guild.
+             * @param guildId The ID of the guild.
+             * @param stickerId The ID of the sticker to delete.
+             * @param reason The reason for deleting the sticker.
+             * @returns A Promise that resolves once the sticker is deleted.
+             */
+            delete: async (guildId, stickerId, reason) => {
+                await this.client.proxy.guilds(guildId).stickers(stickerId).delete({ reason });
+                await this.client.cache.stickers?.removeIfNI('GuildEmojisAndStickers', stickerId, guildId);
+            },
+        };
+    }
+}
+exports.GuildShorter = GuildShorter;

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

@@ -0,0 +1,115 @@
+import { type GuildMemberResolvable, type RESTGetAPIGuildMembersQuery, type RESTGetAPIGuildMembersSearchQuery, type RESTPatchAPIGuildMemberJSONBody, type RESTPutAPIGuildBanJSONBody, type RESTPutAPIGuildMemberJSONBody } from '..';
+import { GuildMember } from '../../structures';
+import { BaseShorter } from './base';
+export declare class MemberShorter extends BaseShorter {
+    /**
+     * Provides access to member-related functionality in a guild.
+     */
+    get members(): {
+        /**
+         * Resolves a member in the guild based on the provided GuildMemberResolvable.
+         * @param guildId The ID of the guild.
+         * @param resolve The GuildMemberResolvable to resolve.
+         * @returns A Promise that resolves to the resolved member.
+         */
+        resolve: (guildId: string, resolve: GuildMemberResolvable) => Promise<GuildMember | undefined>;
+        /**
+         * Searches for members in the guild based on the provided query.
+         * @param guildId The ID of the guild.
+         * @param query The query parameters for searching members.
+         * @returns A Promise that resolves to an array of matched members.
+         */
+        search: (guildId: string, query?: RESTGetAPIGuildMembersSearchQuery) => Promise<GuildMember[]>;
+        /**
+         * Unbans a member from the guild.
+         * @param guildId The ID of the guild.
+         * @param memberId The ID of the member to unban.
+         * @param body The request body for unbanning the member.
+         * @param reason The reason for unbanning the member.
+         */
+        unban: (guildId: string, memberId: string, body?: RESTPutAPIGuildBanJSONBody, reason?: string) => Promise<void>;
+        /**
+         * Bans a member from the guild.
+         * @param guildId The ID of the guild.
+         * @param memberId The ID of the member to ban.
+         * @param body The request body for banning the member.
+         * @param reason The reason for banning the member.
+         */
+        ban: (guildId: string, memberId: string, body?: RESTPutAPIGuildBanJSONBody, reason?: string) => Promise<void>;
+        /**
+         * Kicks a member from the guild.
+         * @param guildId The ID of the guild.
+         * @param memberId The ID of the member to kick.
+         * @param reason The reason for kicking the member.
+         */
+        kick: (guildId: string, memberId: string, reason?: string) => Promise<void>;
+        /**
+         * Edits a member in the guild.
+         * @param guildId The ID of the guild.
+         * @param memberId The ID of the member to edit.
+         * @param body The data to update the member with.
+         * @param reason The reason for editing the member.
+         * @returns A Promise that resolves to the edited member.
+         */
+        edit: (guildId: string, memberId: string, body: RESTPatchAPIGuildMemberJSONBody, reason?: string) => Promise<GuildMember>;
+        /**
+         * Adds a member to the guild.
+         * @param guildId The ID of the guild.
+         * @param memberId The ID of the member to add.
+         * @param body The request body for adding the member.
+         * @returns A Promise that resolves to the added member.
+         */
+        add: (guildId: string, memberId: string, body: RESTPutAPIGuildMemberJSONBody) => Promise<GuildMember | undefined>;
+        /**
+         * Fetches a member from the guild.
+         * @param guildId The ID of the guild.
+         * @param memberId The ID of the member to fetch.
+         * @param force Whether to force fetching the member from the API even if it exists in the cache.
+         * @returns A Promise that resolves to the fetched member.
+         */
+        fetch: (guildId: string, memberId: string, force?: boolean) => Promise<GuildMember>;
+        /**
+         * Lists members in the guild based on the provided query.
+         * @param guildId The ID of the guild.
+         * @param query The query parameters for listing members.
+         * @param force Whether to force listing members from the API even if they exist in the cache.
+         * @returns A Promise that resolves to an array of listed members.
+         */
+        list: (guildId: string, query?: RESTGetAPIGuildMembersQuery, force?: boolean) => Promise<GuildMember[]>;
+        /**
+         * Provides methods to add and remove roles from a guild member.
+         */
+        roles: {
+            /**
+             * Adds a role to a guild member.
+             * @param guildId The ID of the guild.
+             * @param memberId The ID of the member to add the role to.
+             * @param id The ID of the role to add.
+             */
+            add: (guildId: string, memberId: string, id: string) => Promise<void>;
+            /**
+             * Removes a role from a guild member.
+             * @param guildId The ID of the guild.
+             * @param memberId The ID of the member to remove the role from.
+             * @param id The ID of the role to remove.
+             */
+            remove: (guildId: string, memberId: string, id: string) => Promise<void>;
+        };
+    };
+    get roles(): {
+        /**
+         * Adds a role to a guild member.
+         * @param guildId The ID of the guild.
+         * @param memberId The ID of the member to add the role to.
+         * @param id The ID of the role to add.
+         */
+        add: (guildId: string, memberId: string, id: string) => Promise<void>;
+        /**
+         * Removes a role from a guild member.
+         * @param guildId The ID of the guild.
+         * @param memberId The ID of the member to remove the role from.
+         * @param id The ID of the role to remove.
+         */
+        remove: (guildId: string, memberId: string, id: string) => Promise<void>;
+    };
+}

package/lib/common/shorters/members.js

@@ -0,0 +1,179 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.MemberShorter = void 0;
+const __1 = require("..");
+const structures_1 = require("../../structures");
+const base_1 = require("./base");
+class MemberShorter extends base_1.BaseShorter {
+    /**
+     * Provides access to member-related functionality in a guild.
+     */
+    get members() {
+        return {
+            /**
+             * Resolves a member in the guild based on the provided GuildMemberResolvable.
+             * @param guildId The ID of the guild.
+             * @param resolve The GuildMemberResolvable to resolve.
+             * @returns A Promise that resolves to the resolved member.
+             */
+            resolve: async (guildId, resolve) => {
+                if (typeof resolve === 'string') {
+                    const match = resolve.match(__1.FormattingPatterns.User)?.groups;
+                    if (match?.id) {
+                        return this.members.fetch(guildId, match.id);
+                    }
+                    if (resolve.match(/\d{17,20}/)) {
+                        return this.members.fetch(guildId, resolve);
+                    }
+                    return this.members.search(guildId, { query: resolve, limit: 1 }).then(x => x[0]);
+                }
+                if (resolve.id) {
+                    return this.client.members.fetch(guildId, resolve.id);
+                }
+                return resolve.displayName
+                    ? this.members.search(guildId, { query: resolve.displayName, limit: 1 }).then(x => x[0])
+                    : undefined;
+            },
+            /**
+             * Searches for members in the guild based on the provided query.
+             * @param guildId The ID of the guild.
+             * @param query The query parameters for searching members.
+             * @returns A Promise that resolves to an array of matched members.
+             */
+            search: async (guildId, query) => {
+                const members = await this.client.proxy.guilds(guildId).members.search.get({
+                    query,
+                });
+                await this.client.cache.members?.set(members.map(x => [x.user.id, x]), guildId);
+                return members.map(m => new structures_1.GuildMember(this.client, m, m.user, guildId));
+            },
+            /**
+             * Unbans a member from the guild.
+             * @param guildId The ID of the guild.
+             * @param memberId The ID of the member to unban.
+             * @param body The request body for unbanning the member.
+             * @param reason The reason for unbanning the member.
+             */
+            unban: async (guildId, memberId, body, reason) => {
+                await this.client.proxy.guilds(guildId).bans(memberId).delete({ reason, body });
+            },
+            /**
+             * Bans a member from the guild.
+             * @param guildId The ID of the guild.
+             * @param memberId The ID of the member to ban.
+             * @param body The request body for banning the member.
+             * @param reason The reason for banning the member.
+             */
+            ban: async (guildId, memberId, body, reason) => {
+                await this.client.proxy.guilds(guildId).bans(memberId).put({ reason, body });
+                await this.client.cache.members?.removeIfNI('GuildBans', memberId, guildId);
+            },
+            /**
+             * Kicks a member from the guild.
+             * @param guildId The ID of the guild.
+             * @param memberId The ID of the member to kick.
+             * @param reason The reason for kicking the member.
+             */
+            kick: async (guildId, memberId, reason) => {
+                await this.client.proxy.guilds(guildId).members(memberId).delete({ reason });
+                await this.client.cache.members?.removeIfNI('GuildMembers', memberId, guildId);
+            },
+            /**
+             * Edits a member in the guild.
+             * @param guildId The ID of the guild.
+             * @param memberId The ID of the member to edit.
+             * @param body The data to update the member with.
+             * @param reason The reason for editing the member.
+             * @returns A Promise that resolves to the edited member.
+             */
+            edit: async (guildId, memberId, body, reason) => {
+                const member = await this.client.proxy.guilds(guildId).members(memberId).patch({ body, reason });
+                await this.client.cache.members?.setIfNI('GuildMembers', memberId, guildId, member);
+                return new structures_1.GuildMember(this.client, member, member.user, guildId);
+            },
+            /**
+             * Adds a member to the guild.
+             * @param guildId The ID of the guild.
+             * @param memberId The ID of the member to add.
+             * @param body The request body for adding the member.
+             * @returns A Promise that resolves to the added member.
+             */
+            add: async (guildId, memberId, body) => {
+                const member = await this.client.proxy.guilds(guildId).members(memberId).put({
+                    body,
+                });
+                // Thanks dapi-types, fixed
+                if (!member) {
+                    return;
+                }
+                await this.client.cache.members?.setIfNI('GuildMembers', member.user.id, guildId, member);
+                return new structures_1.GuildMember(this.client, member, member.user, guildId);
+            },
+            /**
+             * Fetches a member from the guild.
+             * @param guildId The ID of the guild.
+             * @param memberId The ID of the member to fetch.
+             * @param force Whether to force fetching the member from the API even if it exists in the cache.
+             * @returns A Promise that resolves to the fetched member.
+             */
+            fetch: async (guildId, memberId, force = false) => {
+                let member;
+                if (!force) {
+                    member = await this.client.cache.members?.get(memberId, guildId);
+                    if (member)
+                        return member;
+                }
+                member = await this.client.proxy.guilds(guildId).members(memberId).get();
+                await this.client.cache.members?.set(member.user.id, guildId, member);
+                return new structures_1.GuildMember(this.client, member, member.user, guildId);
+            },
+            /**
+             * Lists members in the guild based on the provided query.
+             * @param guildId The ID of the guild.
+             * @param query The query parameters for listing members.
+             * @param force Whether to force listing members from the API even if they exist in the cache.
+             * @returns A Promise that resolves to an array of listed members.
+             */
+            list: async (guildId, query, force = false) => {
+                let members;
+                if (!force) {
+                    members = (await this.client.cache.members?.values(guildId)) ?? [];
+                    if (members.length)
+                        return members;
+                }
+                members = await this.client.proxy.guilds(guildId).members.get({
+                    query,
+                });
+                await this.client.cache.members?.set(members.map(x => [x.user.id, x]), guildId);
+                return members.map(m => new structures_1.GuildMember(this.client, m, m.user, guildId));
+            },
+            /**
+             * Provides methods to add and remove roles from a guild member.
+             */
+            roles: this.roles,
+        };
+    }
+    get roles() {
+        return {
+            /**
+             * Adds a role to a guild member.
+             * @param guildId The ID of the guild.
+             * @param memberId The ID of the member to add the role to.
+             * @param id The ID of the role to add.
+             */
+            add: async (guildId, memberId, id) => {
+                await this.client.proxy.guilds(guildId).members(memberId).roles(id).put({});
+            },
+            /**
+             * Removes a role from a guild member.
+             * @param guildId The ID of the guild.
+             * @param memberId The ID of the member to remove the role from.
+             * @param id The ID of the role to remove.
+             */
+            remove: async (guildId, memberId, id) => {
+                await this.client.proxy.guilds(guildId).members(memberId).roles(id).delete();
+            },
+        };
+    }
+}
+exports.MemberShorter = MemberShorter;

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

@@ -0,0 +1,27 @@
+import type { RESTGetAPIChannelMessageReactionUsersQuery } from 'discord-api-types/v10';
+import { Message, User } from '../../structures';
+import type { EmojiResolvable } from '../types/resolvables';
+import type { MessageCreateBodyRequest, MessageUpdateBodyRequest } from '../types/write';
+import { BaseShorter } from './base';
+export declare class MessageShorter extends BaseShorter {
+    get messages(): {
+        write: (channelId: string, { files, ...body }: MessageCreateBodyRequest) => Promise<Message>;
+        edit: (messageId: string, channelId: string, { files, ...body }: MessageUpdateBodyRequest) => Promise<Message>;
+        crosspost: (messageId: string, channelId: string, reason?: string) => Promise<Message>;
+        delete: (messageId: string, channelId: string, reason?: string) => Promise<void>;
+        fetch: (messageId: string, channelId: string) => Promise<Message>;
+        purge: (messages: string[], channelId: string, reason?: string) => Promise<never>;
+        reactions: {
+            add: (messageId: string, channelId: string, emoji: EmojiResolvable) => Promise<never>;
+            delete: (messageId: string, channelId: string, emoji: EmojiResolvable, userId?: string) => Promise<never>;
+            fetch: (messageId: string, channelId: string, emoji: EmojiResolvable, query?: RESTGetAPIChannelMessageReactionUsersQuery | undefined) => Promise<User[]>;
+            purge: (messageId: string, channelId: string, emoji?: EmojiResolvable | undefined) => Promise<never>;
+        };
+    };
+    get reactions(): {
+        add: (messageId: string, channelId: string, emoji: EmojiResolvable) => Promise<never>;
+        delete: (messageId: string, channelId: string, emoji: EmojiResolvable, userId?: string) => Promise<never>;
+        fetch: (messageId: string, channelId: string, emoji: EmojiResolvable, query?: RESTGetAPIChannelMessageReactionUsersQuery) => Promise<User[]>;
+        purge: (messageId: string, channelId: string, emoji?: EmojiResolvable) => Promise<never>;
+    };
+}