carbon-proxy 0.14.0

package/dist/src/structures/Role.js

@@ -0,0 +1,291 @@
+import { Routes } from "discord-api-types/v10";
+import { Base } from "../abstracts/Base.js";
+import { buildCDNUrl } from "../utils/index.js";
+import { Guild } from "./Guild.js";
+export class Role extends Base {
+    constructor(client, rawDataOrId, guildId) {
+        super(client);
+        this._guildId = guildId;
+        if (typeof rawDataOrId === "string") {
+            this.id = rawDataOrId;
+        }
+        else {
+            this._rawData = rawDataOrId;
+            this.id = rawDataOrId.id;
+            this.setData(rawDataOrId);
+        }
+    }
+    _rawData = null;
+    _guildId;
+    setData(data) {
+        if (!data)
+            throw new Error("Cannot set data without having data... smh");
+        this._rawData = data;
+    }
+    setField(key, value) {
+        if (!this._rawData)
+            throw new Error("Cannot set field without having data... smh");
+        Reflect.set(this._rawData, key, value);
+    }
+    /**
+     * The raw Discord API data for this role
+     */
+    get rawData() {
+        if (!this._rawData)
+            throw new Error("Cannot access rawData on partial Role. Use fetch() to populate data.");
+        return this._rawData;
+    }
+    /**
+     * The ID of the role.
+     */
+    id;
+    /**
+     * The ID of the guild this role belongs to
+     */
+    get guildId() {
+        if (!this._guildId)
+            throw new Error("Guild ID is not available for this role. Use guild.fetchRole() to get a role with guild context.");
+        return this._guildId;
+    }
+    /**
+     * Whether the role is a partial role (meaning it does not have all the data).
+     * If this is true, you should use {@link Role.fetch} to get the full data of the role.
+     */
+    get partial() {
+        return (this._rawData === null);
+    }
+    /**
+     * The name of the role.
+     */
+    get name() {
+        if (!this._rawData)
+            return undefined;
+        return this._rawData.name;
+    }
+    /**
+     * The color of the role.
+     */
+    get color() {
+        if (!this._rawData)
+            return undefined;
+        return this._rawData.color;
+    }
+    /**
+     * The icon hash of the role.
+     * You can use {@link Role.iconUrl} to get the URL of the icon.
+     */
+    get icon() {
+        if (!this._rawData)
+            return undefined;
+        return this._rawData.icon ?? null;
+    }
+    /**
+     * Get the URL of the role's icon with default settings (png format)
+     */
+    get iconUrl() {
+        if (!this._rawData)
+            return undefined;
+        return buildCDNUrl(`https://cdn.discordapp.com/role-icons/${this.id}`, this.icon);
+    }
+    /**
+     * Get the URL of the role's icon with custom format and size options
+     * @param options Optional format and size parameters
+     * @returns The icon URL or null if no icon is set
+     */
+    getIconUrl(options) {
+        if (!this._rawData)
+            return undefined;
+        return buildCDNUrl(`https://cdn.discordapp.com/role-icons/${this.id}`, this.icon, options);
+    }
+    /**
+     * If this role is mentionable.
+     */
+    get mentionable() {
+        if (!this._rawData)
+            return undefined;
+        return this._rawData.mentionable;
+    }
+    /**
+     * If this role is hoisted.
+     */
+    get hoisted() {
+        if (!this._rawData)
+            return undefined;
+        return this._rawData.hoist;
+    }
+    /**
+     * The position of the role.
+     */
+    get position() {
+        if (!this._rawData)
+            return undefined;
+        return this._rawData.position;
+    }
+    /**
+     * The permissions of the role.
+     */
+    get permissions() {
+        if (!this._rawData)
+            return undefined;
+        return BigInt(this._rawData.permissions);
+    }
+    /**
+     * If this role is managed by an integration.
+     */
+    get managed() {
+        if (!this._rawData)
+            return undefined;
+        return this._rawData.managed;
+    }
+    /**
+     * The unicode emoji for the role.
+     */
+    get unicodeEmoji() {
+        if (!this._rawData)
+            return undefined;
+        return this._rawData.unicode_emoji ?? null;
+    }
+    /**
+     * The flags of this role.
+     * @see https://discord.com/developers/docs/topics/permissions#role-object-role-flags
+     */
+    get flags() {
+        if (!this._rawData)
+            return undefined;
+        return this._rawData.flags;
+    }
+    /**
+     * The tags of this role.
+     * @see https://discord.com/developers/docs/topics/permissions#role-object-role-tags-structure
+     */
+    get tags() {
+        if (!this._rawData)
+            return undefined;
+        return this._rawData.tags;
+    }
+    /**
+     * Returns the Discord mention format for this role
+     * @returns The mention string in the format <@&roleId>
+     */
+    toString() {
+        return `<@&${this.id}>`;
+    }
+    /**
+     * Fetch updated data for this role.
+     * If the role is partial, this will fetch all the data for the role and populate the fields.
+     * If the role is not partial, all fields will be updated with new values from Discord.
+     * @returns A Promise that resolves to a non-partial Role
+     */
+    async fetch() {
+        const newData = (await this.client.rest.get(Routes.guildRole(this.guildId, this.id)));
+        if (!newData)
+            throw new Error(`Role ${this.id} not found`);
+        this.setData(newData);
+        return this;
+    }
+    /**
+     * Set the name of the role
+     * @param name The new name for the role
+     * @param reason The reason for changing the name (will be shown in audit log)
+     */
+    async setName(name, reason) {
+        await this.client.rest.patch(Routes.guildRole(this.guildId, this.id), {
+            body: { name },
+            headers: reason ? { "X-Audit-Log-Reason": reason } : undefined
+        });
+        this.setField("name", name);
+    }
+    /**
+     * Set the color of the role
+     * @param color The new color for the role
+     * @param reason The reason for changing the color (will be shown in audit log)
+     */
+    async setColor(color, reason) {
+        await this.client.rest.patch(Routes.guildRole(this.guildId, this.id), {
+            body: { color },
+            headers: reason ? { "X-Audit-Log-Reason": reason } : undefined
+        });
+        this.setField("color", color);
+    }
+    /**
+     * Set the icon of the role
+     * @param icon The unicode emoji or icon URL to set
+     * @param reason The reason for changing the icon (will be shown in audit log)
+     */
+    async setIcon(icon, reason) {
+        await this.client.rest.patch(Routes.guildRole(this.guildId, this.id), {
+            body: { icon },
+            headers: reason ? { "X-Audit-Log-Reason": reason } : undefined
+        });
+        this.setField("icon", icon);
+    }
+    /**
+     * Set the mentionable status of the role
+     * @param mentionable Whether the role should be mentionable
+     * @param reason The reason for changing the mentionable status (will be shown in audit log)
+     */
+    async setMentionable(mentionable, reason) {
+        await this.client.rest.patch(Routes.guildRole(this.guildId, this.id), {
+            body: { mentionable },
+            headers: reason ? { "X-Audit-Log-Reason": reason } : undefined
+        });
+        this.setField("mentionable", mentionable);
+    }
+    /**
+     * Set the hoisted status of the role
+     * @param hoisted Whether the role should be hoisted
+     * @param reason The reason for changing the hoisted status (will be shown in audit log)
+     */
+    async setHoisted(hoisted, reason) {
+        await this.client.rest.patch(Routes.guildRole(this.guildId, this.id), {
+            body: { hoist: hoisted },
+            headers: reason ? { "X-Audit-Log-Reason": reason } : undefined
+        });
+        this.setField("hoist", hoisted);
+    }
+    /**
+     * Set the position of the role
+     * @param position The new position for the role
+     * @param reason The reason for changing the position (will be shown in audit log)
+     */
+    async setPosition(position, reason) {
+        await this.client.rest.patch(Routes.guildRole(this.guildId, this.id), {
+            body: { position },
+            headers: reason ? { "X-Audit-Log-Reason": reason } : undefined
+        });
+        this.setField("position", position);
+    }
+    /**
+     * Set the permissions of the role
+     * @param permissions The permissions to set
+     * @param reason The reason for changing the permissions (will be shown in audit log)
+     */
+    async setPermissions(permissions, reason) {
+        const permValue = permissions.reduce((acc, perm) => acc | perm, BigInt(0));
+        await this.client.rest.patch(Routes.guildRole(this.guildId, this.id), {
+            body: { permissions: permValue.toString() },
+            headers: reason ? { "X-Audit-Log-Reason": reason } : undefined
+        });
+        this.setField("permissions", permValue.toString());
+    }
+    /**
+     * Delete the role
+     * @param reason The reason for deleting the role (will be shown in audit log)
+     */
+    async delete(reason) {
+        await this.client.rest.delete(Routes.guildRole(this.guildId, this.id), {
+            headers: reason ? { "X-Audit-Log-Reason": reason } : undefined
+        });
+    }
+    /**
+     * Get the member count for this role
+     * @returns A Promise that resolves to the number of members with this role
+     */
+    async fetchMemberCount() {
+        const guild = new Guild(this.client, this.guildId);
+        const roleMemberCounts = await guild.fetchRoleMemberCounts();
+        const roleCount = roleMemberCounts.find((r) => r.id === this.id);
+        return roleCount?.count ?? 0;
+    }
+}
+//# sourceMappingURL=Role.js.map

package/dist/src/structures/Role.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"Role.js","sourceRoot":"","sources":["../../../src/structures/Role.ts"],"names":[],"mappings":"AAAA,OAAO,EAIN,MAAM,EACN,MAAM,uBAAuB,CAAA;AAC9B,OAAO,EAAE,IAAI,EAAE,MAAM,sBAAsB,CAAA;AAG3C,OAAO,EAAE,WAAW,EAAsB,MAAM,mBAAmB,CAAA;AACnE,OAAO,EAAE,KAAK,EAAE,MAAM,YAAY,CAAA;AAElC,MAAM,OAAO,IAAwC,SAAQ,IAAI;IAChE,YACC,MAAc,EACd,WAAsD,EACtD,OAAgB;QAEhB,KAAK,CAAC,MAAM,CAAC,CAAA;QACb,IAAI,CAAC,QAAQ,GAAG,OAAO,CAAA;QACvB,IAAI,OAAO,WAAW,KAAK,QAAQ,EAAE,CAAC;YACrC,IAAI,CAAC,EAAE,GAAG,WAAW,CAAA;QACtB,CAAC;aAAM,CAAC;YACP,IAAI,CAAC,QAAQ,GAAG,WAAW,CAAA;YAC3B,IAAI,CAAC,EAAE,GAAG,WAAW,CAAC,EAAE,CAAA;YACxB,IAAI,CAAC,OAAO,CAAC,WAAW,CAAC,CAAA;QAC1B,CAAC;IACF,CAAC;IAES,QAAQ,GAAmB,IAAI,CAAA;IACjC,QAAQ,CAAS;IAEjB,OAAO,CAAC,IAA0B;QACzC,IAAI,CAAC,IAAI;YAAE,MAAM,IAAI,KAAK,CAAC,4CAA4C,CAAC,CAAA;QACxE,IAAI,CAAC,QAAQ,GAAG,IAAI,CAAA;IACrB,CAAC;IACO,QAAQ,CAAC,GAAkB,EAAE,KAAc;QAClD,IAAI,CAAC,IAAI,CAAC,QAAQ;YACjB,MAAM,IAAI,KAAK,CAAC,6CAA6C,CAAC,CAAA;QAC/D,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,QAAQ,EAAE,GAAG,EAAE,KAAK,CAAC,CAAA;IACvC,CAAC;IAED;;OAEG;IACH,IAAI,OAAO;QACV,IAAI,CAAC,IAAI,CAAC,QAAQ;YACjB,MAAM,IAAI,KAAK,CACd,sEAAsE,CACtE,CAAA;QACF,OAAO,IAAI,CAAC,QAAQ,CAAA;IACrB,CAAC;IAED;;OAEG;IACM,EAAE,CAAQ;IAEnB;;OAEG;IACH,IAAI,OAAO;QACV,IAAI,CAAC,IAAI,CAAC,QAAQ;YACjB,MAAM,IAAI,KAAK,CACd,kGAAkG,CAClG,CAAA;QACF,OAAO,IAAI,CAAC,QAAQ,CAAA;IACrB,CAAC;IAED;;;OAGG;IACH,IAAI,OAAO;QACV,OAAO,CAAC,IAAI,CAAC,QAAQ,KAAK,IAAI,CAAU,CAAA;IACzC,CAAC;IAED;;OAEG;IACH,IAAI,IAAI;QACP,IAAI,CAAC,IAAI,CAAC,QAAQ;YAAE,OAAO,SAAkB,CAAA;QAC7C,OAAO,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAA;IAC1B,CAAC;IAED;;OAEG;IACH,IAAI,KAAK;QACR,IAAI,CAAC,IAAI,CAAC,QAAQ;YAAE,OAAO,SAAkB,CAAA;QAC7C,OAAO,IAAI,CAAC,QAAQ,CAAC,KAAK,CAAA;IAC3B,CAAC;IAED;;;OAGG;IACH,IAAI,IAAI;QACP,IAAI,CAAC,IAAI,CAAC,QAAQ;YAAE,OAAO,SAAkB,CAAA;QAC7C,OAAO,IAAI,CAAC,QAAQ,CAAC,IAAI,IAAI,IAAI,CAAA;IAClC,CAAC;IAED;;OAEG;IACH,IAAI,OAAO;QACV,IAAI,CAAC,IAAI,CAAC,QAAQ;YAAE,OAAO,SAAkB,CAAA;QAC7C,OAAO,WAAW,CACjB,yCAAyC,IAAI,CAAC,EAAE,EAAE,EAClD,IAAI,CAAC,IAAI,CACT,CAAA;IACF,CAAC;IAED;;;;OAIG;IACH,UAAU,CAAC,OAAuB;QACjC,IAAI,CAAC,IAAI,CAAC,QAAQ;YAAE,OAAO,SAAkB,CAAA;QAC7C,OAAO,WAAW,CACjB,yCAAyC,IAAI,CAAC,EAAE,EAAE,EAClD,IAAI,CAAC,IAAI,EACT,OAAO,CACP,CAAA;IACF,CAAC;IAED;;OAEG;IACH,IAAI,WAAW;QACd,IAAI,CAAC,IAAI,CAAC,QAAQ;YAAE,OAAO,SAAkB,CAAA;QAC7C,OAAO,IAAI,CAAC,QAAQ,CAAC,WAAW,CAAA;IACjC,CAAC;IAED;;OAEG;IACH,IAAI,OAAO;QACV,IAAI,CAAC,IAAI,CAAC,QAAQ;YAAE,OAAO,SAAkB,CAAA;QAC7C,OAAO,IAAI,CAAC,QAAQ,CAAC,KAAK,CAAA;IAC3B,CAAC;IAED;;OAEG;IACH,IAAI,QAAQ;QACX,IAAI,CAAC,IAAI,CAAC,QAAQ;YAAE,OAAO,SAAkB,CAAA;QAC7C,OAAO,IAAI,CAAC,QAAQ,CAAC,QAAQ,CAAA;IAC9B,CAAC;IAED;;OAEG;IACH,IAAI,WAAW;QACd,IAAI,CAAC,IAAI,CAAC,QAAQ;YAAE,OAAO,SAAkB,CAAA;QAC7C,OAAO,MAAM,CAAC,IAAI,CAAC,QAAQ,CAAC,WAAW,CAAC,CAAA;IACzC,CAAC;IAED;;OAEG;IACH,IAAI,OAAO;QACV,IAAI,CAAC,IAAI,CAAC,QAAQ;YAAE,OAAO,SAAkB,CAAA;QAC7C,OAAO,IAAI,CAAC,QAAQ,CAAC,OAAO,CAAA;IAC7B,CAAC;IAED;;OAEG;IACH,IAAI,YAAY;QACf,IAAI,CAAC,IAAI,CAAC,QAAQ;YAAE,OAAO,SAAkB,CAAA;QAC7C,OAAO,IAAI,CAAC,QAAQ,CAAC,aAAa,IAAI,IAAI,CAAA;IAC3C,CAAC;IAED;;;OAGG;IACH,IAAI,KAAK;QACR,IAAI,CAAC,IAAI,CAAC,QAAQ;YAAE,OAAO,SAAkB,CAAA;QAC7C,OAAO,IAAI,CAAC,QAAQ,CAAC,KAAK,CAAA;IAC3B,CAAC;IAED;;;OAGG;IACH,IAAI,IAAI;QACP,IAAI,CAAC,IAAI,CAAC,QAAQ;YAAE,OAAO,SAAkB,CAAA;QAC7C,OAAO,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAA;IAC1B,CAAC;IAED;;;OAGG;IACH,QAAQ;QACP,OAAO,MAAM,IAAI,CAAC,EAAE,GAAG,CAAA;IACxB,CAAC;IAED;;;;;OAKG;IACH,KAAK,CAAC,KAAK;QACV,MAAM,OAAO,GAAG,CAAC,MAAM,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAC1C,MAAM,CAAC,SAAS,CAAC,IAAI,CAAC,OAAO,EAAE,IAAI,CAAC,EAAE,CAAC,CACvC,CAAY,CAAA;QACb,IAAI,CAAC,OAAO;YAAE,MAAM,IAAI,KAAK,CAAC,QAAQ,IAAI,CAAC,EAAE,YAAY,CAAC,CAAA;QAE1D,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC,CAAA;QAErB,OAAO,IAAmB,CAAA;IAC3B,CAAC;IAED;;;;OAIG;IACH,KAAK,CAAC,OAAO,CAAC,IAAY,EAAE,MAAe;QAC1C,MAAM,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,SAAS,CAAC,IAAI,CAAC,OAAO,EAAE,IAAI,CAAC,EAAE,CAAC,EAAE;YACrE,IAAI,EAAE,EAAE,IAAI,EAAE;YACd,OAAO,EAAE,MAAM,CAAC,CAAC,CAAC,EAAE,oBAAoB,EAAE,MAAM,EAAE,CAAC,CAAC,CAAC,SAAS;SAC9D,CAAC,CAAA;QACF,IAAI,CAAC,QAAQ,CAAC,MAAM,EAAE,IAAI,CAAC,CAAA;IAC5B,CAAC;IAED;;;;OAIG;IACH,KAAK,CAAC,QAAQ,CAAC,KAAa,EAAE,MAAe;QAC5C,MAAM,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,SAAS,CAAC,IAAI,CAAC,OAAO,EAAE,IAAI,CAAC,EAAE,CAAC,EAAE;YACrE,IAAI,EAAE,EAAE,KAAK,EAAE;YACf,OAAO,EAAE,MAAM,CAAC,CAAC,CAAC,EAAE,oBAAoB,EAAE,MAAM,EAAE,CAAC,CAAC,CAAC,SAAS;SAC9D,CAAC,CAAA;QACF,IAAI,CAAC,QAAQ,CAAC,OAAO,EAAE,KAAK,CAAC,CAAA;IAC9B,CAAC;IAED;;;;OAIG;IACH,KAAK,CAAC,OAAO,CAAC,IAAY,EAAE,MAAe;QAC1C,MAAM,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,SAAS,CAAC,IAAI,CAAC,OAAO,EAAE,IAAI,CAAC,EAAE,CAAC,EAAE;YACrE,IAAI,EAAE,EAAE,IAAI,EAAE;YACd,OAAO,EAAE,MAAM,CAAC,CAAC,CAAC,EAAE,oBAAoB,EAAE,MAAM,EAAE,CAAC,CAAC,CAAC,SAAS;SAC9D,CAAC,CAAA;QACF,IAAI,CAAC,QAAQ,CAAC,MAAM,EAAE,IAAI,CAAC,CAAA;IAC5B,CAAC;IAED;;;;OAIG;IACH,KAAK,CAAC,cAAc,CAAC,WAAoB,EAAE,MAAe;QACzD,MAAM,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,SAAS,CAAC,IAAI,CAAC,OAAO,EAAE,IAAI,CAAC,EAAE,CAAC,EAAE;YACrE,IAAI,EAAE,EAAE,WAAW,EAAE;YACrB,OAAO,EAAE,MAAM,CAAC,CAAC,CAAC,EAAE,oBAAoB,EAAE,MAAM,EAAE,CAAC,CAAC,CAAC,SAAS;SAC9D,CAAC,CAAA;QACF,IAAI,CAAC,QAAQ,CAAC,aAAa,EAAE,WAAW,CAAC,CAAA;IAC1C,CAAC;IAED;;;;OAIG;IACH,KAAK,CAAC,UAAU,CAAC,OAAgB,EAAE,MAAe;QACjD,MAAM,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,SAAS,CAAC,IAAI,CAAC,OAAO,EAAE,IAAI,CAAC,EAAE,CAAC,EAAE;YACrE,IAAI,EAAE,EAAE,KAAK,EAAE,OAAO,EAAE;YACxB,OAAO,EAAE,MAAM,CAAC,CAAC,CAAC,EAAE,oBAAoB,EAAE,MAAM,EAAE,CAAC,CAAC,CAAC,SAAS;SAC9D,CAAC,CAAA;QACF,IAAI,CAAC,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC,CAAA;IAChC,CAAC;IAED;;;;OAIG;IACH,KAAK,CAAC,WAAW,CAAC,QAAgB,EAAE,MAAe;QAClD,MAAM,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,SAAS,CAAC,IAAI,CAAC,OAAO,EAAE,IAAI,CAAC,EAAE,CAAC,EAAE;YACrE,IAAI,EAAE,EAAE,QAAQ,EAAE;YAClB,OAAO,EAAE,MAAM,CAAC,CAAC,CAAC,EAAE,oBAAoB,EAAE,MAAM,EAAE,CAAC,CAAC,CAAC,SAAS;SAC9D,CAAC,CAAA;QACF,IAAI,CAAC,QAAQ,CAAC,UAAU,EAAE,QAAQ,CAAC,CAAA;IACpC,CAAC;IAED;;;;OAIG;IACH,KAAK,CAAC,cAAc,CAAC,WAAqB,EAAE,MAAe;QAC1D,MAAM,SAAS,GAAG,WAAW,CAAC,MAAM,CAAC,CAAC,GAAG,EAAE,IAAI,EAAE,EAAE,CAAC,GAAG,GAAG,IAAI,EAAE,MAAM,CAAC,CAAC,CAAC,CAAC,CAAA;QAC1E,MAAM,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,SAAS,CAAC,IAAI,CAAC,OAAO,EAAE,IAAI,CAAC,EAAE,CAAC,EAAE;YACrE,IAAI,EAAE,EAAE,WAAW,EAAE,SAAS,CAAC,QAAQ,EAAE,EAAE;YAC3C,OAAO,EAAE,MAAM,CAAC,CAAC,CAAC,EAAE,oBAAoB,EAAE,MAAM,EAAE,CAAC,CAAC,CAAC,SAAS;SAC9D,CAAC,CAAA;QACF,IAAI,CAAC,QAAQ,CAAC,aAAa,EAAE,SAAS,CAAC,QAAQ,EAAE,CAAC,CAAA;IACnD,CAAC;IAED;;;OAGG;IACH,KAAK,CAAC,MAAM,CAAC,MAAe;QAC3B,MAAM,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,SAAS,CAAC,IAAI,CAAC,OAAO,EAAE,IAAI,CAAC,EAAE,CAAC,EAAE;YACtE,OAAO,EAAE,MAAM,CAAC,CAAC,CAAC,EAAE,oBAAoB,EAAE,MAAM,EAAE,CAAC,CAAC,CAAC,SAAS;SAC9D,CAAC,CAAA;IACH,CAAC;IAED;;;OAGG;IACH,KAAK,CAAC,gBAAgB;QACrB,MAAM,KAAK,GAAG,IAAI,KAAK,CAAO,IAAI,CAAC,MAAM,EAAE,IAAI,CAAC,OAAO,CAAC,CAAA;QACxD,MAAM,gBAAgB,GAAG,MAAM,KAAK,CAAC,qBAAqB,EAAE,CAAA;QAC5D,MAAM,SAAS,GAAG,gBAAgB,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,KAAK,IAAI,CAAC,EAAE,CAAC,CAAA;QAEhE,OAAO,SAAS,EAAE,KAAK,IAAI,CAAC,CAAA;IAC7B,CAAC;CACD"}

package/dist/src/structures/ThreadMember.d.ts

@@ -0,0 +1,40 @@
+import type { APIThreadMember, ThreadMemberFlags } from "discord-api-types/v10";
+import { Base } from "../abstracts/Base.js";
+import type { Client } from "../classes/Client.js";
+import { GuildMember } from "./GuildMember.js";
+import { User } from "./User.js";
+export declare class ThreadMember extends Base {
+    constructor(client: Client, rawData: APIThreadMember, guildId?: string);
+    protected _rawData: APIThreadMember | null;
+    private setData;
+    /**
+     * The raw Discord API data for this thread member
+     */
+    get rawData(): Readonly<APIThreadMember>;
+    /**
+     * The ID of the guild. This is not present in the API response, so it must be provided.
+     */
+    guildId: string | undefined;
+    /**
+     * The ID of the thread
+     */
+    get id(): string | undefined;
+    /**
+     * The ID of the user
+     */
+    get userId(): string | undefined;
+    get user(): User<true> | undefined;
+    /**
+     * The timestamp of when the user last joined the thread
+     */
+    get joinTimestamp(): string;
+    /**
+     * 	Any user-thread settings, currently only used for notifications
+     */
+    get flags(): ThreadMemberFlags;
+    /**
+     * The member object of the user
+     */
+    member(guildId?: string): GuildMember<false, true> | undefined;
+}
+//# sourceMappingURL=ThreadMember.d.ts.map

package/dist/src/structures/ThreadMember.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ThreadMember.d.ts","sourceRoot":"","sources":["../../../src/structures/ThreadMember.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,iBAAiB,EAAE,MAAM,uBAAuB,CAAA;AAC/E,OAAO,EAAE,IAAI,EAAE,MAAM,sBAAsB,CAAA;AAC3C,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,sBAAsB,CAAA;AAElD,OAAO,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAA;AAC9C,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAA;AAEhC,qBAAa,YAAa,SAAQ,IAAI;gBACzB,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,eAAe,EAAE,OAAO,CAAC,EAAE,MAAM;IAOtE,SAAS,CAAC,QAAQ,EAAE,eAAe,GAAG,IAAI,CAAO;IACjD,OAAO,CAAC,OAAO;IAKf;;OAEG;IACH,IAAI,OAAO,IAAI,QAAQ,CAAC,eAAe,CAAC,CAMvC;IAED;;OAEG;IACI,OAAO,EAAE,MAAM,GAAG,SAAS,CAAA;IAElC;;OAEG;IACH,IAAI,EAAE,IAAI,MAAM,GAAG,SAAS,CAG3B;IACD;;OAEG;IACH,IAAI,MAAM,IAAI,MAAM,GAAG,SAAS,CAG/B;IACD,IAAI,IAAI,IAAI,IAAI,CAAC,IAAI,CAAC,GAAG,SAAS,CAGjC;IACD;;OAEG;IACH,IAAI,aAAa,IAAI,MAAM,CAG1B;IACD;;OAEG;IACH,IAAI,KAAK,IAAI,iBAAiB,CAG7B;IACD;;OAEG;IACH,MAAM,CAAC,OAAO,CAAC,EAAE,MAAM,GAAG,WAAW,CAAC,KAAK,EAAE,IAAI,CAAC,GAAG,SAAS;CAW9D"}

package/dist/src/structures/ThreadMember.js

@@ -0,0 +1,79 @@
+import { Base } from "../abstracts/Base.js";
+import { Guild } from "./Guild.js";
+import { GuildMember } from "./GuildMember.js";
+import { User } from "./User.js";
+export class ThreadMember extends Base {
+    constructor(client, rawData, guildId) {
+        super(client);
+        this._rawData = rawData;
+        this.setData(rawData);
+        this.guildId = guildId;
+    }
+    _rawData = null;
+    setData(data) {
+        if (!data)
+            throw new Error("Cannot set data without having data... smh");
+        this._rawData = data;
+    }
+    /**
+     * The raw Discord API data for this thread member
+     */
+    get rawData() {
+        if (!this._rawData)
+            throw new Error("Cannot access rawData on partial ThreadMember. Use fetch() to populate data.");
+        return this._rawData;
+    }
+    /**
+     * The ID of the guild. This is not present in the API response, so it must be provided.
+     */
+    guildId;
+    /**
+     * The ID of the thread
+     */
+    get id() {
+        if (!this._rawData)
+            return undefined;
+        return this._rawData.id;
+    }
+    /**
+     * The ID of the user
+     */
+    get userId() {
+        if (!this._rawData)
+            return undefined;
+        return this._rawData.user_id;
+    }
+    get user() {
+        if (!this.userId)
+            return undefined;
+        return new User(this.client, this.userId);
+    }
+    /**
+     * The timestamp of when the user last joined the thread
+     */
+    get joinTimestamp() {
+        if (!this._rawData)
+            return undefined;
+        return this._rawData.join_timestamp;
+    }
+    /**
+     * 	Any user-thread settings, currently only used for notifications
+     */
+    get flags() {
+        if (!this._rawData)
+            return undefined;
+        return this._rawData.flags;
+    }
+    /**
+     * The member object of the user
+     */
+    member(guildId) {
+        if (!this._rawData?.member || !this.user)
+            return undefined;
+        guildId = guildId ?? this.guildId;
+        if (!guildId)
+            throw new Error("Cannot create GuildMember without a guild ID");
+        return new GuildMember(this.client, this._rawData.member, new Guild(this.client, guildId));
+    }
+}
+//# sourceMappingURL=ThreadMember.js.map

package/dist/src/structures/ThreadMember.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ThreadMember.js","sourceRoot":"","sources":["../../../src/structures/ThreadMember.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,IAAI,EAAE,MAAM,sBAAsB,CAAA;AAE3C,OAAO,EAAE,KAAK,EAAE,MAAM,YAAY,CAAA;AAClC,OAAO,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAA;AAC9C,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAA;AAEhC,MAAM,OAAO,YAAa,SAAQ,IAAI;IACrC,YAAY,MAAc,EAAE,OAAwB,EAAE,OAAgB;QACrE,KAAK,CAAC,MAAM,CAAC,CAAA;QACb,IAAI,CAAC,QAAQ,GAAG,OAAO,CAAA;QACvB,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC,CAAA;QACrB,IAAI,CAAC,OAAO,GAAG,OAAO,CAAA;IACvB,CAAC;IAES,QAAQ,GAA2B,IAAI,CAAA;IACzC,OAAO,CAAC,IAA0B;QACzC,IAAI,CAAC,IAAI;YAAE,MAAM,IAAI,KAAK,CAAC,4CAA4C,CAAC,CAAA;QACxE,IAAI,CAAC,QAAQ,GAAG,IAAI,CAAA;IACrB,CAAC;IAED;;OAEG;IACH,IAAI,OAAO;QACV,IAAI,CAAC,IAAI,CAAC,QAAQ;YACjB,MAAM,IAAI,KAAK,CACd,8EAA8E,CAC9E,CAAA;QACF,OAAO,IAAI,CAAC,QAAQ,CAAA;IACrB,CAAC;IAED;;OAEG;IACI,OAAO,CAAoB;IAElC;;OAEG;IACH,IAAI,EAAE;QACL,IAAI,CAAC,IAAI,CAAC,QAAQ;YAAE,OAAO,SAAkB,CAAA;QAC7C,OAAO,IAAI,CAAC,QAAQ,CAAC,EAAE,CAAA;IACxB,CAAC;IACD;;OAEG;IACH,IAAI,MAAM;QACT,IAAI,CAAC,IAAI,CAAC,QAAQ;YAAE,OAAO,SAAkB,CAAA;QAC7C,OAAO,IAAI,CAAC,QAAQ,CAAC,OAAO,CAAA;IAC7B,CAAC;IACD,IAAI,IAAI;QACP,IAAI,CAAC,IAAI,CAAC,MAAM;YAAE,OAAO,SAAS,CAAA;QAClC,OAAO,IAAI,IAAI,CAAO,IAAI,CAAC,MAAM,EAAE,IAAI,CAAC,MAAM,CAAC,CAAA;IAChD,CAAC;IACD;;OAEG;IACH,IAAI,aAAa;QAChB,IAAI,CAAC,IAAI,CAAC,QAAQ;YAAE,OAAO,SAAkB,CAAA;QAC7C,OAAO,IAAI,CAAC,QAAQ,CAAC,cAAc,CAAA;IACpC,CAAC;IACD;;OAEG;IACH,IAAI,KAAK;QACR,IAAI,CAAC,IAAI,CAAC,QAAQ;YAAE,OAAO,SAAkB,CAAA;QAC7C,OAAO,IAAI,CAAC,QAAQ,CAAC,KAAK,CAAA;IAC3B,CAAC;IACD;;OAEG;IACH,MAAM,CAAC,OAAgB;QACtB,IAAI,CAAC,IAAI,CAAC,QAAQ,EAAE,MAAM,IAAI,CAAC,IAAI,CAAC,IAAI;YAAE,OAAO,SAAS,CAAA;QAC1D,OAAO,GAAG,OAAO,IAAI,IAAI,CAAC,OAAO,CAAA;QACjC,IAAI,CAAC,OAAO;YACX,MAAM,IAAI,KAAK,CAAC,8CAA8C,CAAC,CAAA;QAChE,OAAO,IAAI,WAAW,CACrB,IAAI,CAAC,MAAM,EACX,IAAI,CAAC,QAAQ,CAAC,MAAM,EACpB,IAAI,KAAK,CAAO,IAAI,CAAC,MAAM,EAAE,OAAO,CAAC,CACrC,CAAA;IACF,CAAC;CACD"}

package/dist/src/structures/User.d.ts

@@ -0,0 +1,104 @@
+import { type APIDMChannel, type APIUser, type UserFlags } from "discord-api-types/v10";
+import { Base } from "../abstracts/Base.js";
+import type { Client } from "../classes/Client.js";
+import type { IfPartial, MessagePayload } from "../types/index.js";
+import { type CDNUrlOptions } from "../utils/index.js";
+import { Message } from "./Message.js";
+export declare class User<IsPartial extends boolean = false> extends Base {
+    constructor(client: Client, rawDataOrId: IsPartial extends true ? string : APIUser);
+    protected _rawData: APIUser | null;
+    private setData;
+    /**
+     * The raw Discord API data for this user
+     */
+    get rawData(): Readonly<APIUser>;
+    /**
+     * The ID of the user
+     */
+    readonly id: string;
+    /**
+     * Whether the user is a partial user (meaning it does not have all the data).
+     * If this is true, you should use {@link User.fetch} to get the full data of the user.
+     */
+    get partial(): IsPartial;
+    /**
+     * The username of the user.
+     */
+    get username(): IfPartial<IsPartial, string>;
+    /**
+     * The global name of the user.
+     */
+    get globalName(): IfPartial<IsPartial, string | null>;
+    /**
+     * The discriminator of the user.
+     */
+    get discriminator(): IfPartial<IsPartial, string>;
+    /**
+     * Is this user a bot?
+     */
+    get bot(): IfPartial<IsPartial, boolean>;
+    /**
+     * Is this user a system user?
+     */
+    get system(): IfPartial<IsPartial, boolean>;
+    /**
+     * The public flags of the user. (Bitfield)
+     * @see https://discord.com/developers/docs/resources/user#user-object-user-flags
+     */
+    get flags(): IfPartial<IsPartial, UserFlags | undefined>;
+    /**
+     * The avatar hash of the user.
+     * You can use {@link User.avatarUrl} to get the URL of the avatar.
+     */
+    get avatar(): IfPartial<IsPartial, string | null>;
+    /**
+     * Get the URL of the user's avatar with default settings (png format)
+     */
+    get avatarUrl(): IfPartial<IsPartial, string | null>;
+    /**
+     * Get the URL of the user's avatar with custom format and size options
+     * @param options Optional format and size parameters
+     * @returns The avatar URL or null if no avatar is set
+     */
+    getAvatarUrl(options?: CDNUrlOptions): IfPartial<IsPartial, string | null>;
+    /**
+     * The banner hash of the user.
+     * You can use {@link User.bannerUrl} to get the URL of the banner.
+     */
+    get banner(): IfPartial<IsPartial, string | null>;
+    /**
+     * Get the URL of the user's banner with default settings (png format)
+     */
+    get bannerUrl(): IfPartial<IsPartial, string | null>;
+    /**
+     * Get the URL of the user's banner with custom format and size options
+     * @param options Optional format and size parameters
+     * @returns The banner URL or null if no banner is set
+     */
+    getBannerUrl(options?: CDNUrlOptions): IfPartial<IsPartial, string | null>;
+    /**
+     * The accent color of the user.
+     */
+    get accentColor(): IfPartial<IsPartial, number | null>;
+    /**
+     * Returns the Discord mention format for this user
+     * @returns The mention string in the format <@userId>
+     */
+    toString(): string;
+    /**
+     * Fetch updated data for this user.
+     * If the user is partial, this will fetch all the data for the user and populate the fields.
+     * If the user is not partial, all fields will be updated with new values from Discord.
+     * @returns A Promise that resolves to a non-partial User
+     */
+    fetch(): Promise<User<false>>;
+    /**
+     * Instantiate a new DM channel with this user.
+     */
+    createDm(): Promise<APIDMChannel>;
+    /**
+     * Send a message to this user.
+     */
+    send(data: MessagePayload): Promise<Message<false>>;
+}
+//# sourceMappingURL=User.d.ts.map

package/dist/src/structures/User.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"User.d.ts","sourceRoot":"","sources":["../../../src/structures/User.ts"],"names":[],"mappings":"AAAA,OAAO,EACN,KAAK,YAAY,EAEjB,KAAK,OAAO,EAEZ,KAAK,SAAS,EACd,MAAM,uBAAuB,CAAA;AAC9B,OAAO,EAAE,IAAI,EAAE,MAAM,sBAAsB,CAAA;AAC3C,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,sBAAsB,CAAA;AAClD,OAAO,KAAK,EAAE,SAAS,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAA;AAClE,OAAO,EAEN,KAAK,aAAa,EAElB,MAAM,mBAAmB,CAAA;AAC1B,OAAO,EAAE,OAAO,EAAE,MAAM,cAAc,CAAA;AAEtC,qBAAa,IAAI,CAAC,SAAS,SAAS,OAAO,GAAG,KAAK,CAAE,SAAQ,IAAI;gBAE/D,MAAM,EAAE,MAAM,EACd,WAAW,EAAE,SAAS,SAAS,IAAI,GAAG,MAAM,GAAG,OAAO;IAYvD,SAAS,CAAC,QAAQ,EAAE,OAAO,GAAG,IAAI,CAAO;IACzC,OAAO,CAAC,OAAO;IASf;;OAEG;IACH,IAAI,OAAO,IAAI,QAAQ,CAAC,OAAO,CAAC,CAM/B;IAED;;OAEG;IACH,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAA;IAEnB;;;OAGG;IACH,IAAI,OAAO,IAAI,SAAS,CAEvB;IAED;;OAEG;IACH,IAAI,QAAQ,IAAI,SAAS,CAAC,SAAS,EAAE,MAAM,CAAC,CAG3C;IAED;;OAEG;IACH,IAAI,UAAU,IAAI,SAAS,CAAC,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC,CAGpD;IAED;;OAEG;IACH,IAAI,aAAa,IAAI,SAAS,CAAC,SAAS,EAAE,MAAM,CAAC,CAGhD;IAED;;OAEG;IACH,IAAI,GAAG,IAAI,SAAS,CAAC,SAAS,EAAE,OAAO,CAAC,CAGvC;IAED;;OAEG;IACH,IAAI,MAAM,IAAI,SAAS,CAAC,SAAS,EAAE,OAAO,CAAC,CAG1C;IAED;;;OAGG;IACH,IAAI,KAAK,IAAI,SAAS,CAAC,SAAS,EAAE,SAAS,GAAG,SAAS,CAAC,CAGvD;IAED;;;OAGG;IAEH,IAAI,MAAM,IAAI,SAAS,CAAC,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC,CAGhD;IAED;;OAEG;IACH,IAAI,SAAS,IAAI,SAAS,CAAC,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC,CAMnD;IAED;;;;OAIG;IACH,YAAY,CAAC,OAAO,CAAC,EAAE,aAAa,GAAG,SAAS,CAAC,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;IAS1E;;;OAGG;IACH,IAAI,MAAM,IAAI,SAAS,CAAC,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC,CAGhD;IAED;;OAEG;IACH,IAAI,SAAS,IAAI,SAAS,CAAC,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC,CAMnD;IAED;;;;OAIG;IACH,YAAY,CAAC,OAAO,CAAC,EAAE,aAAa,GAAG,SAAS,CAAC,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;IAS1E;;OAEG;IACH,IAAI,WAAW,IAAI,SAAS,CAAC,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC,CAGrD;IAED;;;OAGG;IACH,QAAQ,IAAI,MAAM;IAIlB;;;;;OAKG;IACG,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IAWnC;;OAEG;IACG,QAAQ;IASd;;OAEG;IACG,IAAI,CAAC,IAAI,EAAE,cAAc;CAU/B"}