@confis/discordapiwrapper/dist/Role.js

A fast and lightweight discord api wrapper.

/**
 * Base class for all API objects.
 */
class Base {
    constructor(client) {
        Object.defineProperty(this, "_client", {
            value: client,
            configurable: false,
            enumerable: false,
        });
    }
    /**
     * Returns the client
     */
    get client() {
        return this._client;
    }
    _clone() {
        return Object.assign(Object.create(this), this);
    }
    /**
     * Returns a JSON representation of the object.
     */
    toJson() {
        const dict = {};
        for (const [k, v] of Object.entries(this)) {
            if (k !== "client")
                Reflect.set(dict, k, v?.id ?? v?.toJSON?.() ?? v);
        }
        return dict;
    }
    _patch(data) { }
}

/**
 * A bitfield of all available permissions.
 */
const PermissionsBitField = {
    CREATE_INSTANT_INVITE: 0x1,
    KICK_MEMBERS: 0x2,
    BAN_MEMBERS: 0x4,
    ADMINISTRATOR: 0x8,
    MANAGE_CHANNELS: 0x10,
    MANAGE_GUILD: 0x20,
    ADD_REACTIONS: 0x40,
    VIEW_AUDIT_LOG: 0x80,
    PRIORITY_SPEAKER: 0x100,
    STREAM: 0x200,
    VIEW_CHANNEL: 0x400,
    SEND_MESSAGES: 0x800,
    SEND_TTS_MESSAGES: 0x1000,
    MANAGE_MESSAGES: 0x2000,
    EMBED_LINKS: 0x4000,
    ATTACH_FILES: 0x8000,
    READ_MESSAGE_HISTORY: 0x10000,
    MENTION_EVERYONE: 0x20000,
    USE_EXTERNAL_EMOJIS: 0x40000,
    VIEW_GUILD_INSIGHTS: 0x80000,
    CONNECT: 0x100000,
    SPEAK: 0x200000,
    MUTE_MEMBERS: 0x400000,
    DEAFEN_MEMBERS: 0x800000,
    MOVE_MEMBERS: 0x1000000,
    USE_VAD: 0x2000000,
    CHANGE_NICKNAME: 0x4000000,
    MANAGE_NICKNAMES: 0x8000000,
    MANAGE_ROLES: 0x10000000,
    MANAGE_WEBHOOKS: 0x20000000,
    MANAGE_EMOJIS_AND_STICKERS: 0x40000000,
    USE_APPLICATION_COMMANDS: 0x800000000,
    REQUEST_TO_SPEAK: 0x100000000,
    MANAGE_EVENTS: 0x200000000,
    MANAGE_THREADS: 0x400000000,
    CREATE_PUBLIC_THREADS: 0x800000000,
    CREATE_PRIVATE_THREADS: 0x1000000000,
    USE_EXTERNAL_STICKERS: 0x2000000000,
    SEND_MESSAGES_IN_THREADS: 0x4000000000,
    START_EMBEDDED_ACTIVITIES: 0x8000000000,
    MODERATE_MEMBERS: 0x10000000000,
};
/**
 * Calculates the permissions from a given bitfield.
 * @param permBitfield The bitfield to calculate the permissions from.
 * @returns An array of permissions.
 */
function PermissionCalculator(permBitfield) {
    const currentPermissions = [];
    const permissionUpper = Math.floor(permBitfield / 0x100000000);
    const permissionLower = Math.floor(permBitfield % 0x100000000);
    for (let key in PermissionsBitField) {
        if ((PermissionsBitField[key] >= 0x100000000 &&
            permissionUpper & Math.floor(PermissionsBitField[key] / 0x100000000)) ||
            (PermissionsBitField[key] < 0x100000000 &&
                permissionLower & PermissionsBitField[key])) {
            currentPermissions.push(key);
        }
        else {
            continue;
        }
    }
    if (currentPermissions.includes("ADMINISTRATOR")) {
        for (let key in PermissionsBitField) {
            if (!currentPermissions.find((a) => a === key)) {
                currentPermissions.push(key);
            }
        }
    }
    return currentPermissions;
}

/** Role object */
class Role extends Base {
    constructor(options, client) {
        super(client);
        Object.assign(this, options);
    }
    /**
     * Get the guild of the role
     *
     * @returns A guild object
     */
    get guild() {
        return this.client.guilds.get(this.guild_id);
    }
    /**
     * Get the permissions of the role
     *
     * @returns An array of permissions
     */
    getPermissions() {
        return PermissionCalculator(Number(this.permissions));
    }
    /**
     * Check if the role has a specific permission
     *
     * @param permission The permission name
     * @returns Whether the role has this permission or not
     */
    hasPermission(permission) {
        const permissionArray = this.getPermissions();
        if (permissionArray.find((a) => a === permission))
            return true;
        else
            return false;
    }
    /**
     * Update the role
     *
     * @param data The new data of the role
     */
    _patch(data) {
        Object.assign(this, data);
    }
    toJson() {
        return {
            id: this.id,
            name: this.name,
            color: this.color,
            hoist: this.hoist,
            icon: this.icon,
            unicode_emoji: this.unicode_emoji,
            position: this.position,
            permissions: this.permissions,
            managed: this.managed,
            mentionable: this.mentionable,
            tags: {
                bot_id: this.tags?.bot_id,
                integration_id: this.tags?.integration_id,
            },
            flags: this.flags,
            guild_id: this.guild_id,
        };
    }
}

exports.Role = Role;