elynn-baileys 1.0.1

package/lib/Discord/structures/ComponentInteraction.js

@@ -0,0 +1,338 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+/** @module ComponentInteraction */
+const Interaction_1 = __importDefault(require("./Interaction"));
+const Message_1 = __importDefault(require("./Message"));
+const Member_1 = __importDefault(require("./Member"));
+const Permission_1 = __importDefault(require("./Permission"));
+const GuildChannel_1 = __importDefault(require("./GuildChannel"));
+const Role_1 = __importDefault(require("./Role"));
+const User_1 = __importDefault(require("./User"));
+const InteractionResolvedChannel_1 = __importDefault(require("./InteractionResolvedChannel"));
+const Constants_1 = require("../Constants");
+const SelectMenuValuesWrapper_1 = __importDefault(require("../util/interactions/SelectMenuValuesWrapper"));
+const TypedCollection_1 = __importDefault(require("../util/TypedCollection"));
+const Errors_1 = require("../util/Errors");
+const MessageInteractionResponse_1 = __importDefault(require("../util/interactions/MessageInteractionResponse"));
+/** Represents a component interaction. */
+class ComponentInteraction extends Interaction_1.default {
+    _cachedChannel;
+    _cachedGuild;
+    /** The permissions the bot has in the channel this interaction was sent from. If in a dm/group dm, this will contain `ATTACH_FILES`, `EMBED_LINKS`, and `MENTION_EVERYONE`. In addition, `USE_EXTERNAL_EMOJIS` will be included for DMs with the app's bot user. */
+    appPermissions;
+    /** The maximum size limit per attachment. This will be 10MiB by default, unless the user that created this interaction has a Nitro subscription or the guild it was sent from has been boosted to level 2 or above. */
+    attachmentSizeLimit;
+    /** Details about the authorizing user or server for the installation(s) relevant to the interaction. See [Discord's docs](https://discord.com/developers/docs/interactions/receiving-and-responding#interaction-object-authorizing-integration-owners-object) for more information. */
+    authorizingIntegrationOwners;
+    /** The ID of the channel this interaction was sent from. */
+    channelID;
+    /** The context this interaction was sent from. */
+    context;
+    /** The data associated with the interaction. */
+    data;
+    /** The entitlements for the user that created this interaction, and the guild it was created in. */
+    entitlements;
+    /** The id of the guild this interaction was sent from, if applicable. */
+    guildID;
+    /** The preferred [locale](https://discord.com/developers/docs/reference#locales) of the guild this interaction was sent from, if applicable. */
+    guildLocale;
+    /** The partial guild this interaction was sent from, if applicable. */
+    guildPartial;
+    /** The [locale](https://discord.com/developers/docs/reference#locales) of the invoking user. */
+    locale;
+    /** The member associated with the invoking user, if this interaction is sent from a guild. */
+    member;
+    /** The permissions of the member associated with the invoking user, if this interaction is sent from a guild. */
+    memberPermissions;
+    /** The message the interaction is from. */
+    message;
+    /** The user that invoked this interaction. */
+    user;
+    constructor(data, client) {
+        super(data, client);
+        if (data.message !== undefined && data.guild_id !== undefined) {
+            data.message.guild_id = data.guild_id;
+        }
+        this.appPermissions = new Permission_1.default(data.app_permissions ?? "0");
+        this.attachmentSizeLimit = data.attachment_size_limit;
+        this.authorizingIntegrationOwners = data.authorizing_integration_owners;
+        this.channelID = data.channel_id;
+        this.context = data.context;
+        this.entitlements = data.entitlements?.map(entitlement => client.util.updateEntitlement(entitlement)) ?? [];
+        this.guildID = (data.guild_id ?? null);
+        this.guildLocale = data.guild_locale;
+        this.guildPartial = data.guild;
+        this.locale = data.locale;
+        this.member = (data.member === undefined ? null : this.client.util.updateMember(data.guild_id, data.member.user.id, data.member));
+        this.memberPermissions = (data.member === undefined ? null : new Permission_1.default(data.member.permissions));
+        this.message = (this.channel && "messages" in this.channel && this.channel.messages.update(data.message)) || new Message_1.default(data.message, client);
+        this.user = client.users.update((data.user ?? data.member.user));
+        switch (data.data.component_type) {
+            case Constants_1.ComponentTypes.BUTTON: {
+                this.data = {
+                    componentType: data.data.component_type,
+                    customID: data.data.custom_id
+                };
+                break;
+            }
+            case Constants_1.ComponentTypes.STRING_SELECT:
+            case Constants_1.ComponentTypes.USER_SELECT:
+            case Constants_1.ComponentTypes.ROLE_SELECT:
+            case Constants_1.ComponentTypes.MENTIONABLE_SELECT:
+            case Constants_1.ComponentTypes.CHANNEL_SELECT: {
+                const resolved = {
+                    channels: new TypedCollection_1.default(InteractionResolvedChannel_1.default, client),
+                    members: new TypedCollection_1.default(Member_1.default, client),
+                    roles: new TypedCollection_1.default(Role_1.default, client),
+                    users: new TypedCollection_1.default(User_1.default, client)
+                };
+                if (data.data.resolved) {
+                    if (data.data.resolved.channels) {
+                        for (const channel of Object.values(data.data.resolved.channels))
+                            resolved.channels.update(channel);
+                    }
+                    if (data.data.resolved.members) {
+                        for (const [id, member] of Object.entries(data.data.resolved.members)) {
+                            const m = member;
+                            m.user = data.data.resolved.users[id];
+                            resolved.members.add(client.util.updateMember(data.guild_id, id, m));
+                        }
+                    }
+                    if (data.data.resolved.roles) {
+                        for (const role of Object.values(data.data.resolved.roles)) {
+                            try {
+                                resolved.roles.add(this.guild?.roles.update(role, this.guildID) ?? new Role_1.default(role, client, this.guildID));
+                            }
+                            catch {
+                                resolved.roles.add(new Role_1.default(role, client, this.guildID));
+                            }
+                        }
+                    }
+                    if (data.data.resolved.users) {
+                        for (const user of Object.values(data.data.resolved.users))
+                            resolved.users.add(client.users.update(user));
+                    }
+                }
+                this.data = {
+                    componentType: data.data.component_type,
+                    customID: data.data.custom_id,
+                    values: new SelectMenuValuesWrapper_1.default(resolved, data.data.values),
+                    resolved
+                };
+                break;
+            }
+        }
+    }
+    /** The channel this interaction was sent from. */
+    get channel() {
+        return this._cachedChannel ??= this.client.getChannel(this.channelID);
+    }
+    /** The guild this interaction was sent from, if applicable. This will throw an error if the guild is not cached. */
+    get guild() {
+        if (this.guildID !== null && this._cachedGuild !== null) {
+            this._cachedGuild = this.client.guilds.get(this.guildID);
+            if (!this._cachedGuild) {
+                throw new Errors_1.UncachedError(this, "guild", "GUILDS", this.client);
+            }
+            return this._cachedGuild;
+        }
+        return this._cachedGuild === null ? this._cachedGuild : (this._cachedGuild = null);
+    }
+    async createFollowup(content, options) {
+        if (typeof content === "string") {
+            options = {
+                ...options,
+                content
+            };
+        }
+        else
+            options = content;
+        const message = await this.client.rest.interactions.createFollowupMessage(this.applicationID, this.token, options);
+        return new MessageInteractionResponse_1.default(this, message, "followup", null);
+    }
+    async createMessage(content, options) {
+        if (typeof content === "string") {
+            options = {
+                ...options,
+                content
+            };
+        }
+        else
+            options = content;
+        if (this.acknowledged) {
+            throw new TypeError("Interactions cannot have more than one initial response.");
+        }
+        this.acknowledged = true;
+        const cb = await this.client.rest.interactions.createInteractionResponse(this.id, this.token, { type: Constants_1.InteractionResponseTypes.CHANNEL_MESSAGE_WITH_SOURCE, data: options }, true);
+        return new MessageInteractionResponse_1.default(this, null, "initial", cb);
+    }
+    /**
+     * Respond to this interaction with a modal. This is an initial response, and more than one initial response cannot be used.
+     * @param options The options for the modal.
+     */
+    async createModal(options) {
+        if (this.acknowledged) {
+            throw new TypeError("Interactions cannot have more than one initial response.");
+        }
+        this.acknowledged = true;
+        return this.client.rest.interactions.createInteractionResponse(this.id, this.token, { type: Constants_1.InteractionResponseTypes.MODAL, data: options }, true);
+    }
+    /**
+     * Defer this interaction with a `DEFERRED_CHANNEL_MESSAGE_WITH_SOURCE` response. This is an initial response, and more than one initial response cannot be used.
+     * @param flags The [flags](https://discord.com/developers/docs/resources/channel#message-object-message-flags) to respond with.
+     */
+    async defer(flags) {
+        if (this.acknowledged) {
+            throw new TypeError("Interactions cannot have more than one initial response.");
+        }
+        this.acknowledged = true;
+        return this.client.rest.interactions.createInteractionResponse(this.id, this.token, { type: Constants_1.InteractionResponseTypes.DEFERRED_CHANNEL_MESSAGE_WITH_SOURCE, data: { flags } }, true);
+    }
+    /**
+     * Defer this interaction with a `DEFERRED_UPDATE_MESSAGE` response. This is an initial response, and more than one initial response cannot be used.
+     * @param flags The [flags](https://discord.com/developers/docs/resources/channel#message-object-message-flags) to respond with.
+     */
+    async deferUpdate(flags) {
+        if (this.acknowledged) {
+            throw new TypeError("Interactions cannot have more than one initial response.");
+        }
+        this.acknowledged = true;
+        return this.client.rest.interactions.createInteractionResponse(this.id, this.token, { type: Constants_1.InteractionResponseTypes.DEFERRED_UPDATE_MESSAGE, data: { flags } }, true);
+    }
+    /**
+     * Delete a follow-up message.
+     * @param messageID The ID of the message.
+     */
+    async deleteFollowup(messageID) {
+        return this.client.rest.interactions.deleteFollowupMessage(this.applicationID, this.token, messageID);
+    }
+    /**
+     * Delete the original interaction response.
+     */
+    async deleteOriginal() {
+        return this.client.rest.interactions.deleteOriginalMessage(this.applicationID, this.token);
+    }
+    async editFollowup(messageID, content, options) {
+        if (typeof content === "string") {
+            options = {
+                ...options,
+                content
+            };
+        }
+        else
+            options = content;
+        return this.client.rest.interactions.editFollowupMessage(this.applicationID, this.token, messageID, options);
+    }
+    async editOriginal(content, options) {
+        if (typeof content === "string") {
+            options = {
+                ...options,
+                content
+            };
+        }
+        else
+            options = content;
+        return this.client.rest.interactions.editOriginalMessage(this.applicationID, this.token, options);
+    }
+    async editParent(content, options) {
+        if (typeof content === "string") {
+            options = {
+                ...options,
+                content
+            };
+        }
+        else
+            options = content;
+        if (this.acknowledged) {
+            throw new TypeError("Interactions cannot have more than one initial response.");
+        }
+        this.acknowledged = true;
+        return this.client.rest.interactions.createInteractionResponse(this.id, this.token, { type: Constants_1.InteractionResponseTypes.UPDATE_MESSAGE, data: options }, true);
+    }
+    /**
+     * Get a followup message.
+     * @param messageID The ID of the message.
+     */
+    async getFollowup(messageID) {
+        return this.client.rest.interactions.getFollowupMessage(this.applicationID, this.token, messageID);
+    }
+    /**
+     * Get the original interaction response.
+     */
+    async getOriginal() {
+        return this.client.rest.interactions.getOriginalMessage(this.applicationID, this.token);
+    }
+    /** Whether this interaction belongs to a cached guild channel. The only difference on using this method over a simple if statement is to easily update all the interaction properties typing definitions based on the channel it belongs to. */
+    inCachedGuildChannel() {
+        return this.channel instanceof GuildChannel_1.default;
+    }
+    /** Whether this interaction belongs to a private channel (PrivateChannel or uncached). The only difference on using this method over a simple if statement is to easily update all the interaction properties typing definitions based on the channel it belongs to. */
+    inPrivateChannel() {
+        return this.guildID === null;
+    }
+    /** Whether this interaction is a button interaction. The only difference on using this method over a simple if statement is to easily update all the interaction properties typing definitions based on the component type. */
+    isButtonComponentInteraction() {
+        return this.data.componentType === Constants_1.ComponentTypes.BUTTON;
+    }
+    /** Whether this interaction is a select menu interaction. The only difference on using this method over a simple if statement is to easily update all the interaction properties typing definitions based on the component type. */
+    isSelectMenuComponentInteraction() {
+        return this.data.componentType === Constants_1.ComponentTypes.STRING_SELECT
+            || this.data.componentType === Constants_1.ComponentTypes.CHANNEL_SELECT
+            || this.data.componentType === Constants_1.ComponentTypes.ROLE_SELECT
+            || this.data.componentType === Constants_1.ComponentTypes.MENTIONABLE_SELECT
+            || this.data.componentType === Constants_1.ComponentTypes.USER_SELECT;
+    }
+    /**
+     * Launch the bot's activity. This is an initial response, and more than one initial response cannot be used.
+     */
+    async launchActivity() {
+        if (this.acknowledged) {
+            throw new TypeError("Interactions cannot have more than one initial response.");
+        }
+        this.acknowledged = true;
+        return this.client.rest.interactions.createInteractionResponse(this.id, this.token, { type: Constants_1.InteractionResponseTypes.LAUNCH_ACTIVITY }, true);
+    }
+    /**
+     * Show a "premium required" response to the user. This is an initial response, and more than one initial response cannot be used.
+     * @deprecated The {@link Constants~InteractionResponseTypes.PREMIUM_REQUIRED | PREMIUM_REQUIRED} interaction response type is now deprecated in favor of using {@link Types/Channels~PremiumButton | custom premium buttons}.
+     */
+    async premiumRequired() {
+        if (this.acknowledged) {
+            throw new TypeError("Interactions cannot have more than one initial response.");
+        }
+        this.acknowledged = true;
+        return this.client.rest.interactions.createInteractionResponse(this.id, this.token, { type: Constants_1.InteractionResponseTypes.PREMIUM_REQUIRED }, true);
+    }
+    async reply(content, options) {
+        if (typeof content === "string") {
+            options = {
+                ...options,
+                content
+            };
+        }
+        else
+            options = content;
+        return this.acknowledged ? this.createFollowup(options) : this.createMessage(options);
+    }
+    toJSON() {
+        return {
+            ...super.toJSON(),
+            appPermissions: this.appPermissions.toJSON(),
+            attachmentSizeLimit: this.attachmentSizeLimit,
+            authorizingIntegrationOwners: this.authorizingIntegrationOwners,
+            channelID: this.channelID,
+            context: this.context,
+            data: this.data,
+            guildID: this.guildID ?? undefined,
+            guildLocale: this.guildLocale,
+            locale: this.locale,
+            member: this.member?.toJSON(),
+            type: this.type,
+            user: this.user.toJSON()
+        };
+    }
+}
+exports.default = ComponentInteraction;

package/lib/Discord/structures/Entitlement.cjs

@@ -0,0 +1,27 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+const BaseEntitlement_1 = __importDefault(require("./BaseEntitlement.cjs"));
+/** Represents an entitlement. */
+class Entitlement extends BaseEntitlement_1.default {
+    endsAt;
+    startsAt;
+    subscriptionID;
+    constructor(data, client) {
+        super(data, client);
+        this.endsAt = data.ends_at ? new Date(data.ends_at) : null;
+        this.startsAt = data.starts_at ? new Date(data.starts_at) : null;
+        this.subscriptionID = data.subscription_id;
+    }
+    toJSON() {
+        return {
+            ...super.toJSON(),
+            endsAt: this.endsAt?.getTime() || null,
+            startsAt: this.startsAt?.getTime() || null,
+            subscriptionID: this.subscriptionID
+        };
+    }
+}
+exports.default = Entitlement;

package/lib/Discord/structures/Entitlement.d.ts

@@ -0,0 +1,11 @@
+import BaseEntitlement from "./BaseEntitlement";
+import type * as Types from "../types/namespaced";
+import type Client from "../Client";
+/** Represents an entitlement. */
+export default class Entitlement extends BaseEntitlement {
+    endsAt: Date | null;
+    startsAt: Date | null;
+    subscriptionID: string;
+    constructor(data: Types.Applications.RawEntitlement, client: Client);
+    toJSON(): Types.JSON.JSONEntitlement;
+}

package/lib/Discord/structures/Entitlement.js

@@ -0,0 +1,27 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+const BaseEntitlement_1 = __importDefault(require("./BaseEntitlement"));
+/** Represents an entitlement. */
+class Entitlement extends BaseEntitlement_1.default {
+    endsAt;
+    startsAt;
+    subscriptionID;
+    constructor(data, client) {
+        super(data, client);
+        this.endsAt = data.ends_at ? new Date(data.ends_at) : null;
+        this.startsAt = data.starts_at ? new Date(data.starts_at) : null;
+        this.subscriptionID = data.subscription_id;
+    }
+    toJSON() {
+        return {
+            ...super.toJSON(),
+            endsAt: this.endsAt?.getTime() || null,
+            startsAt: this.startsAt?.getTime() || null,
+            subscriptionID: this.subscriptionID
+        };
+    }
+}
+exports.default = Entitlement;

package/lib/Discord/structures/ExtendedUser.cjs

@@ -0,0 +1,58 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+/** @module ExtendedUser */
+const User_1 = __importDefault(require("./User.cjs"));
+/** Represents the currently authenticated user. */
+class ExtendedUser extends User_1.default {
+    /** The user's email. (always null for bots) */
+    email;
+    /** The flags of the user. */
+    flags;
+    /** The locale of the user */
+    locale;
+    /** If the user has mfa enabled on their account */
+    mfaEnabled;
+    /** If this user's email is verified. (always true for bots) */
+    verified;
+    constructor(data, client) {
+        super(data, client);
+        this.email = data.email;
+        this.flags = data.flags;
+        this.verified = !!data.verified;
+        this.mfaEnabled = !!data.mfa_enabled;
+        this.update(data);
+    }
+    update(data) {
+        super.update(data);
+        if (data.email !== undefined) {
+            this.email = data.email;
+        }
+        if (data.flags !== undefined) {
+            this.flags = data.flags;
+        }
+        if (data.locale !== undefined) {
+            this.locale = data.locale;
+        }
+    }
+    /**
+     * Modify this user.
+     * @param options The options for editing the user.
+     */
+    async edit(options) {
+        return this.client.rest.users.editSelf(options);
+    }
+    toJSON() {
+        return {
+            ...super.toJSON(),
+            email: this.email,
+            flags: this.flags,
+            locale: this.locale,
+            mfaEnabled: this.mfaEnabled,
+            verified: this.verified
+        };
+    }
+}
+exports.default = ExtendedUser;

package/lib/Discord/structures/ExtendedUser.d.ts

@@ -0,0 +1,25 @@
+/** @module ExtendedUser */
+import User from "./User";
+import type * as Types from "../types/namespaced";
+import type Client from "../Client";
+/** Represents the currently authenticated user. */
+export default class ExtendedUser extends User {
+    /** The user's email. (always null for bots) */
+    email: string | null;
+    /** The flags of the user. */
+    flags: number;
+    /** The locale of the user */
+    locale?: string;
+    /** If the user has mfa enabled on their account */
+    mfaEnabled: boolean;
+    /** If this user's email is verified. (always true for bots) */
+    verified: boolean;
+    constructor(data: Types.Users.RawOAuthUser, client: Client);
+    protected update(data: Partial<Types.Users.RawOAuthUser>): void;
+    /**
+     * Modify this user.
+     * @param options The options for editing the user.
+     */
+    edit(options: Types.Users.EditSelfUserOptions): Promise<ExtendedUser>;
+    toJSON(): Types.JSON.JSONExtendedUser;
+}

package/lib/Discord/structures/ExtendedUser.js

@@ -0,0 +1,58 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+/** @module ExtendedUser */
+const User_1 = __importDefault(require("./User"));
+/** Represents the currently authenticated user. */
+class ExtendedUser extends User_1.default {
+    /** The user's email. (always null for bots) */
+    email;
+    /** The flags of the user. */
+    flags;
+    /** The locale of the user */
+    locale;
+    /** If the user has mfa enabled on their account */
+    mfaEnabled;
+    /** If this user's email is verified. (always true for bots) */
+    verified;
+    constructor(data, client) {
+        super(data, client);
+        this.email = data.email;
+        this.flags = data.flags;
+        this.verified = !!data.verified;
+        this.mfaEnabled = !!data.mfa_enabled;
+        this.update(data);
+    }
+    update(data) {
+        super.update(data);
+        if (data.email !== undefined) {
+            this.email = data.email;
+        }
+        if (data.flags !== undefined) {
+            this.flags = data.flags;
+        }
+        if (data.locale !== undefined) {
+            this.locale = data.locale;
+        }
+    }
+    /**
+     * Modify this user.
+     * @param options The options for editing the user.
+     */
+    async edit(options) {
+        return this.client.rest.users.editSelf(options);
+    }
+    toJSON() {
+        return {
+            ...super.toJSON(),
+            email: this.email,
+            flags: this.flags,
+            locale: this.locale,
+            mfaEnabled: this.mfaEnabled,
+            verified: this.verified
+        };
+    }
+}
+exports.default = ExtendedUser;

package/lib/Discord/structures/ForumChannel.cjs

@@ -0,0 +1,20 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+/** @module ForumChannel */
+const ThreadOnlyChannel_1 = __importDefault(require("./ThreadOnlyChannel.cjs"));
+/** Represents a thread forum channel. */
+class ForumChannel extends ThreadOnlyChannel_1.default {
+    constructor(data, client) {
+        super(data, client);
+    }
+    toJSON() {
+        return {
+            ...super.toJSON(),
+            type: this.type
+        };
+    }
+}
+exports.default = ForumChannel;

package/lib/Discord/structures/ForumChannel.d.ts

@@ -0,0 +1,11 @@
+/** @module ForumChannel */
+import ThreadOnlyChannel from "./ThreadOnlyChannel";
+import type * as Types from "../types/namespaced";
+import type Client from "../Client";
+import type { ChannelTypes } from "../Constants";
+/** Represents a thread forum channel. */
+export default class ForumChannel extends ThreadOnlyChannel {
+    type: ChannelTypes.GUILD_FORUM;
+    constructor(data: Types.Channels.RawForumChannel, client: Client);
+    toJSON(): Types.JSON.JSONForumChannel;
+}

package/lib/Discord/structures/ForumChannel.js

@@ -0,0 +1,20 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+/** @module ForumChannel */
+const ThreadOnlyChannel_1 = __importDefault(require("./ThreadOnlyChannel"));
+/** Represents a thread forum channel. */
+class ForumChannel extends ThreadOnlyChannel_1.default {
+    constructor(data, client) {
+        super(data, client);
+    }
+    toJSON() {
+        return {
+            ...super.toJSON(),
+            type: this.type
+        };
+    }
+}
+exports.default = ForumChannel;