@fluxerjs/core 1.1.1 → 1.1.2

package/dist/{Channel-4WVFDOCG.mjs → Channel-YB3LWDHZ.mjs}

@@ -6,8 +6,8 @@ import {
   LinkChannel,
   TextChannel,
   VoiceChannel
-} from "./chunk-RWFKZ3DF.mjs";
-import "./chunk-V6T5VMWD.mjs";
+} from "./chunk-ZKKBIQBA.mjs";
+import "./chunk-PU73YRKJ.mjs";
 import "./chunk-AH7KYH2Z.mjs";
 import "./chunk-PM2IUGNR.mjs";
 import "./chunk-XNS4O6QJ.mjs";

package/dist/{ClientUser-PXAAKR2P.mjs → ClientUser-QQXLZ5WP.mjs}

@@ -1,6 +1,6 @@
 import {
   ClientUser
-} from "./chunk-4F765HVV.mjs";
+} from "./chunk-G2YVDCRB.mjs";
 import "./chunk-HQMYRYMY.mjs";
 import "./chunk-XNS4O6QJ.mjs";
 export {

package/dist/{Guild-FMBCTAV4.mjs → Guild-MDW7KF33.mjs}

@@ -1,11 +1,11 @@
 import {
   Guild
-} from "./chunk-FRVZ7D6D.mjs";
-import "./chunk-V6T5VMWD.mjs";
+} from "./chunk-KOTF4TTZ.mjs";
+import "./chunk-PU73YRKJ.mjs";
 import "./chunk-DUQAD7F6.mjs";
 import "./chunk-X6K3ZD62.mjs";
 import "./chunk-HQMYRYMY.mjs";
-import "./chunk-DQ4TNBPG.mjs";
+import "./chunk-5I54OXBG.mjs";
 import "./chunk-XNS4O6QJ.mjs";
 export {
   Guild

package/dist/{MessageReaction-AYSOCOMX.mjs → MessageReaction-GYQNJ6GX.mjs}

@@ -1,7 +1,7 @@
 import {
   MessageReaction
-} from "./chunk-K6NLD6SB.mjs";
-import "./chunk-V6T5VMWD.mjs";
+} from "./chunk-YL5S4W6R.mjs";
+import "./chunk-PU73YRKJ.mjs";
 import "./chunk-XNS4O6QJ.mjs";
 export {
   MessageReaction

package/dist/{Role-5MWSGL66.mjs → Role-N2ZEMRUQ.mjs}

@@ -1,6 +1,6 @@
 import {
   Role
-} from "./chunk-DQ4TNBPG.mjs";
+} from "./chunk-5I54OXBG.mjs";
 import "./chunk-XNS4O6QJ.mjs";
 export {
   Role

package/dist/chunk-5I54OXBG.mjs

@@ -0,0 +1,111 @@
+import {
+  Base
+} from "./chunk-XNS4O6QJ.mjs";
+
+// src/structures/Role.ts
+import { Routes } from "@fluxerjs/types";
+import { PermissionFlags, resolvePermissionsToBitfield } from "@fluxerjs/util";
+var Role = class extends Base {
+  client;
+  id;
+  guildId;
+  name;
+  color;
+  position;
+  permissions;
+  hoist;
+  mentionable;
+  unicodeEmoji;
+  /** Separately sorted position for hoisted roles. Null if not set. */
+  hoistPosition;
+  /** @param client - The client instance */
+  /** @param data - API role from GET /guilds/{id}/roles or gateway role events */
+  /** @param guildId - The guild this role belongs to */
+  constructor(client, data, guildId) {
+    super();
+    this.client = client;
+    this.id = data.id;
+    this.guildId = guildId;
+    this.name = data.name;
+    this.color = data.color;
+    this.position = data.position;
+    this.permissions = data.permissions;
+    this.hoist = !!data.hoist;
+    this.mentionable = !!data.mentionable;
+    this.unicodeEmoji = data.unicode_emoji ?? null;
+    this.hoistPosition = data.hoist_position ?? null;
+  }
+  /** Update mutable fields from fresh API data. Used by edit and gateway events. */
+  _patch(data) {
+    if (data.name !== void 0) this.name = data.name;
+    if (data.color !== void 0) this.color = data.color;
+    if (data.position !== void 0) this.position = data.position;
+    if (data.permissions !== void 0) this.permissions = data.permissions;
+    if (data.hoist !== void 0) this.hoist = !!data.hoist;
+    if (data.mentionable !== void 0) this.mentionable = !!data.mentionable;
+    if (data.unicode_emoji !== void 0) this.unicodeEmoji = data.unicode_emoji ?? null;
+    if (data.hoist_position !== void 0) this.hoistPosition = data.hoist_position ?? null;
+  }
+  /** Returns a mention string (e.g. `<@&123456>`). */
+  toString() {
+    return `<@&${this.id}>`;
+  }
+  /**
+   * Check if this role has a permission. Administrator grants all permissions.
+   * @param permission - Permission flag, name, or resolvable
+   * @returns true if the role has the permission
+   * @example
+   * if (role.has(PermissionFlags.BanMembers)) { ... }
+   * if (role.has('ManageChannels')) { ... }
+   */
+  has(permission) {
+    const perm = typeof permission === "number" ? permission : PermissionFlags[permission];
+    if (perm === void 0) return false;
+    const permNum = Number(perm);
+    const rolePerms = BigInt(this.permissions);
+    const permBig = BigInt(permNum);
+    if (permBig < 0) return false;
+    if ((rolePerms & BigInt(PermissionFlags.Administrator)) !== 0n) return true;
+    return (rolePerms & permBig) === permBig;
+  }
+  /**
+   * Edit this role.
+   * Requires Manage Roles permission.
+   * @param options - Role updates (permissions accepts PermissionResolvable for convenience)
+   * @returns This role (updated in place)
+   * @example
+   * await role.edit({ name: 'Moderator', permissions: ['BanMembers', 'KickMembers'] });
+   */
+  async edit(options) {
+    const body = {};
+    if (options.name !== void 0) body.name = options.name;
+    if (options.permissions !== void 0) {
+      body.permissions = typeof options.permissions === "string" ? options.permissions : resolvePermissionsToBitfield(options.permissions);
+    }
+    if (options.color !== void 0) body.color = options.color;
+    if (options.hoist !== void 0) body.hoist = options.hoist;
+    if (options.mentionable !== void 0) body.mentionable = options.mentionable;
+    if (options.unicode_emoji !== void 0) body.unicode_emoji = options.unicode_emoji;
+    if (options.position !== void 0) body.position = options.position;
+    if (options.hoist_position !== void 0) body.hoist_position = options.hoist_position;
+    const data = await this.client.rest.patch(Routes.guildRole(this.guildId, this.id), {
+      body: Object.keys(body).length ? body : void 0,
+      auth: true
+    });
+    this._patch(data);
+    return this;
+  }
+  /**
+   * Delete this role.
+   * Requires Manage Roles permission.
+   */
+  async delete() {
+    await this.client.rest.delete(Routes.guildRole(this.guildId, this.id), { auth: true });
+    const guild = this.client.guilds.get(this.guildId);
+    if (guild) guild.roles.delete(this.id);
+  }
+};
+
+export {
+  Role
+};

package/dist/{chunk-4F765HVV.mjs → chunk-G2YVDCRB.mjs}

@@ -82,7 +82,7 @@ var User = class extends Base {
    * Returns the DM channel; use {@link DMChannel.send} to send messages.
    */
   async createDM() {
-    const { DMChannel: DMChannelClass } = await import("./Channel-4WVFDOCG.mjs");
+    const { DMChannel: DMChannelClass } = await import("./Channel-YB3LWDHZ.mjs");
     const data = await this.client.rest.post(Routes.userMeChannels(), {
       body: { recipient_id: this.id },
       auth: true
@@ -110,7 +110,7 @@ var ClientUser = class extends User {
    * @returns Array of Guild objects (cached in client.guilds)
    */
   async fetchGuilds() {
-    const { Guild } = await import("./Guild-FMBCTAV4.mjs");
+    const { Guild } = await import("./Guild-MDW7KF33.mjs");
     const data = await this.client.rest.get(Routes2.currentUserGuilds());
     const list = Array.isArray(data) ? data : data?.guilds ?? [];
     const guilds = [];

package/dist/{chunk-FRVZ7D6D.mjs → chunk-KOTF4TTZ.mjs}

@@ -1,7 +1,7 @@
 import {
   ErrorCodes,
   FluxerError
-} from "./chunk-V6T5VMWD.mjs";
+} from "./chunk-PU73YRKJ.mjs";
 import {
   GuildMember
 } from "./chunk-DUQAD7F6.mjs";
@@ -10,15 +10,55 @@ import {
 } from "./chunk-HQMYRYMY.mjs";
 import {
   Role
-} from "./chunk-DQ4TNBPG.mjs";
+} from "./chunk-5I54OXBG.mjs";
 import {
   Base
 } from "./chunk-XNS4O6QJ.mjs";
 
 // src/structures/Guild.ts
-import { parseRoleMention } from "@fluxerjs/util";
+import { parseRoleMention, resolvePermissionsToBitfield } from "@fluxerjs/util";
 import { FluxerAPIError } from "@fluxerjs/rest";
+import { Collection as Collection2 } from "@fluxerjs/collection";
+
+// src/client/GuildMemberManager.ts
 import { Collection } from "@fluxerjs/collection";
+var GuildMemberManager = class extends Collection {
+  constructor(guild) {
+    super();
+    this.guild = guild;
+  }
+  /**
+   * The current bot user as a GuildMember in this guild.
+   * Returns null if the bot's member is not cached or client.user is null.
+   * Use fetchMe() to load the bot's member when not cached.
+   *
+   * @example
+   * const perms = guild.members.me?.permissions;
+   * if (perms?.has(PermissionFlags.BanMembers)) { ... }
+   */
+  get me() {
+    const userId = this.guild.client.user?.id;
+    return userId ? this.get(userId) ?? null : null;
+  }
+  /**
+   * Fetch the current bot user as a GuildMember in this guild.
+   * Caches the result in guild.members.
+   *
+   * @throws Error if client.user is null (client not ready)
+   * @example
+   * const me = await guild.members.fetchMe();
+   * console.log(me.displayName);
+   */
+  async fetchMe() {
+    const userId = this.guild.client.user?.id;
+    if (!userId) {
+      throw new Error("Cannot fetch me: client.user is null (client not ready)");
+    }
+    return this.guild.fetchMember(userId);
+  }
+};
+
+// src/structures/Guild.ts
 import { Routes } from "@fluxerjs/types";
 var Guild = class extends Base {
   client;
@@ -54,14 +94,15 @@ var Guild = class extends Base {
   splashWidth;
   /** Splash image height. Optional. */
   splashHeight;
-  members = new Collection();
-  channels = new Collection();
-  roles = new Collection();
+  members;
+  channels = new Collection2();
+  roles = new Collection2();
   /** @param data - API guild from GET /guilds/{id} or gateway GUILD_CREATE */
   constructor(client, data) {
     super();
     this.client = client;
     this.id = data.id;
+    this.members = new GuildMemberManager(this);
     this.name = data.name;
     this.icon = data.icon ?? null;
     this.banner = data.banner ?? null;
@@ -122,6 +163,74 @@ var Guild = class extends Base {
   async removeRoleFromMember(userId, roleId) {
     await this.client.rest.delete(Routes.guildMemberRole(this.id, userId, roleId));
   }
+  /**
+   * Create a role in this guild.
+   * Requires Manage Roles permission.
+   * @param options - Role data (permissions accepts PermissionResolvable for convenience)
+   * @returns The created role
+   * @example
+   * const role = await guild.createRole({ name: 'Mod', permissions: ['KickMembers', 'BanMembers'] });
+   */
+  async createRole(options) {
+    const body = {};
+    if (options.name !== void 0) body.name = options.name;
+    if (options.permissions !== void 0) {
+      body.permissions = typeof options.permissions === "string" ? options.permissions : resolvePermissionsToBitfield(options.permissions);
+    }
+    if (options.color !== void 0) body.color = options.color;
+    if (options.hoist !== void 0) body.hoist = options.hoist;
+    if (options.mentionable !== void 0) body.mentionable = options.mentionable;
+    if (options.unicode_emoji !== void 0) body.unicode_emoji = options.unicode_emoji;
+    if (options.position !== void 0) body.position = options.position;
+    if (options.hoist_position !== void 0) body.hoist_position = options.hoist_position;
+    const data = await this.client.rest.post(Routes.guildRoles(this.id), {
+      body: Object.keys(body).length ? body : void 0,
+      auth: true
+    });
+    const role = new Role(this.client, data, this.id);
+    this.roles.set(role.id, role);
+    return role;
+  }
+  /**
+   * Fetch all roles in this guild.
+   * @returns Array of Role objects (cached in guild.roles)
+   */
+  async fetchRoles() {
+    const data = await this.client.rest.get(
+      Routes.guildRoles(this.id)
+    );
+    const list = Array.isArray(data) ? data : Object.values(data ?? {});
+    const roles = [];
+    for (const r of list) {
+      const role = new Role(this.client, r, this.id);
+      this.roles.set(role.id, role);
+      roles.push(role);
+    }
+    return roles;
+  }
+  /**
+   * Fetch a role by ID.
+   * @param roleId - The role ID to fetch
+   * @returns The role
+   * @throws FluxerError with ROLE_NOT_FOUND if role does not exist (404)
+   */
+  async fetchRole(roleId) {
+    try {
+      const data = await this.client.rest.get(Routes.guildRole(this.id, roleId));
+      const role = new Role(this.client, data, this.id);
+      this.roles.set(role.id, role);
+      return role;
+    } catch (err) {
+      const statusCode = err instanceof FluxerAPIError ? err.statusCode : err?.statusCode;
+      if (statusCode === 404) {
+        throw new FluxerError(`Role ${roleId} not found in guild`, {
+          code: ErrorCodes.RoleNotFound,
+          cause: err
+        });
+      }
+      throw err instanceof FluxerError ? err : new FluxerError("Failed to fetch guild role", { cause: err });
+    }
+  }
   /**
    * Resolve a role ID from an argument (role mention, raw ID, or name).
    * Fetches guild roles if name is provided.
@@ -244,7 +353,7 @@ var Guild = class extends Base {
    * Requires Manage Channels permission.
    */
   async createChannel(data) {
-    const { Channel } = await import("./Channel-4WVFDOCG.mjs");
+    const { Channel } = await import("./Channel-YB3LWDHZ.mjs");
     const created = await this.client.rest.post(Routes.guildChannels(this.id), {
       body: data,
       auth: true
@@ -261,7 +370,7 @@ var Guild = class extends Base {
    * @returns Array of GuildChannel objects (cached in guild.channels and client.channels)
    */
   async fetchChannels() {
-    const { Channel } = await import("./Channel-4WVFDOCG.mjs");
+    const { Channel } = await import("./Channel-YB3LWDHZ.mjs");
     const data = await this.client.rest.get(Routes.guildChannels(this.id));
     const list = Array.isArray(data) ? data : Object.values(data ?? {});
     const channels = [];
@@ -289,5 +398,6 @@ var Guild = class extends Base {
 };
 
 export {
+  GuildMemberManager,
   Guild
 };

package/dist/{chunk-V6T5VMWD.mjs → chunk-PU73YRKJ.mjs}

@@ -17,7 +17,8 @@ var ErrorCodes = {
   ChannelNotFound: "CHANNEL_NOT_FOUND",
   MessageNotFound: "MESSAGE_NOT_FOUND",
   GuildNotFound: "GUILD_NOT_FOUND",
-  MemberNotFound: "MEMBER_NOT_FOUND"
+  MemberNotFound: "MEMBER_NOT_FOUND",
+  RoleNotFound: "ROLE_NOT_FOUND"
 };
 
 export {

package/dist/{chunk-K6NLD6SB.mjs → chunk-YL5S4W6R.mjs}

@@ -1,7 +1,7 @@
 import {
   ErrorCodes,
   FluxerError
-} from "./chunk-V6T5VMWD.mjs";
+} from "./chunk-PU73YRKJ.mjs";
 import {
   Base
 } from "./chunk-XNS4O6QJ.mjs";
@@ -49,10 +49,10 @@ var MessageReaction = class extends Base {
     } catch (err) {
       if (err instanceof RateLimitError) throw err;
       if (err instanceof FluxerAPIError && err.statusCode === 404) {
-        throw new FluxerError(
-          `Message ${this.messageId} not found in channel ${this.channelId}`,
-          { code: ErrorCodes.MessageNotFound, cause: err }
-        );
+        throw new FluxerError(`Message ${this.messageId} not found in channel ${this.channelId}`, {
+          code: ErrorCodes.MessageNotFound,
+          cause: err
+        });
       }
       throw err instanceof FluxerError ? err : new FluxerError(String(err), { cause: err });
     }

package/dist/{chunk-RWFKZ3DF.mjs → chunk-ZKKBIQBA.mjs}

@@ -1,7 +1,7 @@
 import {
   ErrorCodes,
   FluxerError
-} from "./chunk-V6T5VMWD.mjs";
+} from "./chunk-PU73YRKJ.mjs";
 import {
   Events
 } from "./chunk-AH7KYH2Z.mjs";

package/dist/index.d.mts

@@ -1,12 +1,12 @@
 import * as _fluxerjs_types from '@fluxerjs/types';
-import { APIEmbed, APIWebhook, APIWebhookUpdateRequest, APIWebhookTokenUpdateRequest, APIChannelOverwrite, APIChannel, APIChannelPartial, ChannelType, GatewayReactionEmoji, GatewayMessageReactionAddDispatchData, GatewayMessageReactionRemoveDispatchData, APIMessageAttachment, MessageType, APIMessageSticker, APIMessageReaction, APIMessageReference, APIMessageSnapshot, APIMessageCall, APIMessage, APIUserPartial, APIGuildMember, APIRole, APIBan, GuildFeature, GuildVerificationLevel, DefaultMessageNotifications, GuildExplicitContentFilter, GuildMFALevel, APIGuild, APIGuildAuditLog, APIGuildPartial, APIInvite, GatewayPresenceUpdateData, GatewayMessageReactionRemoveAllDispatchData, GatewayMessageReactionRemoveEmojiDispatchData, GatewayVoiceStateUpdateDispatchData, GatewayVoiceServerUpdateDispatchData, GatewayGuildEmojisUpdateDispatchData, GatewayGuildStickersUpdateDispatchData, GatewayGuildIntegrationsUpdateDispatchData, GatewayGuildScheduledEventCreateDispatchData, GatewayGuildScheduledEventUpdateDispatchData, GatewayGuildScheduledEventDeleteDispatchData, GatewayChannelPinsUpdateDispatchData, GatewayPresenceUpdateDispatchData, GatewayWebhooksUpdateDispatchData, GatewaySendPayload, Routes, APIEmoji, APISticker } from '@fluxerjs/types';
+import { APIEmbed, APIWebhook, APIWebhookUpdateRequest, APIWebhookTokenUpdateRequest, APIChannelOverwrite, APIChannel, APIChannelPartial, ChannelType, GatewayReactionEmoji, GatewayMessageReactionAddDispatchData, GatewayMessageReactionRemoveDispatchData, APIMessageAttachment, MessageType, APIMessageSticker, APIMessageReaction, APIMessageReference, APIMessageSnapshot, APIMessageCall, APIMessage, APIUserPartial, APIGuildMember, APIRole, RESTUpdateRoleBody, APIBan, GuildFeature, GuildVerificationLevel, DefaultMessageNotifications, GuildExplicitContentFilter, GuildMFALevel, APIGuild, RESTCreateRoleBody, APIGuildAuditLog, APIGuildPartial, APIInvite, GatewayPresenceUpdateData, APIProfileResponse, GatewayMessageReactionRemoveAllDispatchData, GatewayMessageReactionRemoveEmojiDispatchData, GatewayVoiceStateUpdateDispatchData, GatewayVoiceServerUpdateDispatchData, GatewayGuildEmojisUpdateDispatchData, GatewayGuildStickersUpdateDispatchData, GatewayGuildIntegrationsUpdateDispatchData, GatewayGuildScheduledEventCreateDispatchData, GatewayGuildScheduledEventUpdateDispatchData, GatewayGuildScheduledEventDeleteDispatchData, GatewayChannelPinsUpdateDispatchData, GatewayPresenceUpdateDispatchData, GatewayWebhooksUpdateDispatchData, GatewaySendPayload, Routes, APIEmoji, APISticker } from '@fluxerjs/types';
 export { GatewayOpcodes, MessageAttachmentFlags, Routes } from '@fluxerjs/types';
+import { PermissionResolvable } from '@fluxerjs/util';
+export { PermissionFlags, PermissionResolvable, PermissionString, PermissionsBitField, UserFlagsBitField, UserFlagsBits, UserFlagsResolvable, UserFlagsString, resolvePermissionsToBitfield, resolveTenorToImageUrl } from '@fluxerjs/util';
 import { Collection } from '@fluxerjs/collection';
 import { EmbedBuilder } from '@fluxerjs/builders';
 export { AttachmentBuilder, EmbedBuilder, MessagePayload } from '@fluxerjs/builders';
 import { EventEmitter } from 'events';
-import { PermissionResolvable } from '@fluxerjs/util';
-export { PermissionFlags, PermissionResolvable, PermissionString, PermissionsBitField, resolveTenorToImageUrl } from '@fluxerjs/util';
 import { REST } from '@fluxerjs/rest';
 import { WebSocketManager } from '@fluxerjs/ws';
 
@@ -715,6 +715,36 @@ declare class GuildMember extends Base {
     private _computeBasePermissions;
 }
 
+/**
+ * Manages guild members with a Collection-like API.
+ * Extends Collection so you can use .get(), .set(), .filter(), etc.
+ * Provides guild.members.me for Discord.js parity.
+ */
+declare class GuildMemberManager extends Collection<string, GuildMember> {
+    private readonly guild;
+    constructor(guild: Guild);
+    /**
+     * The current bot user as a GuildMember in this guild.
+     * Returns null if the bot's member is not cached or client.user is null.
+     * Use fetchMe() to load the bot's member when not cached.
+     *
+     * @example
+     * const perms = guild.members.me?.permissions;
+     * if (perms?.has(PermissionFlags.BanMembers)) { ... }
+     */
+    get me(): GuildMember | null;
+    /**
+     * Fetch the current bot user as a GuildMember in this guild.
+     * Caches the result in guild.members.
+     *
+     * @throws Error if client.user is null (client not ready)
+     * @example
+     * const me = await guild.members.fetchMe();
+     * console.log(me.displayName);
+     */
+    fetchMe(): Promise<GuildMember>;
+}
+
 /** Represents a role in a guild. */
 declare class Role extends Base {
     readonly client: Client;
@@ -733,6 +763,8 @@ declare class Role extends Base {
     /** @param data - API role from GET /guilds/{id}/roles or gateway role events */
     /** @param guildId - The guild this role belongs to */
     constructor(client: Client, data: APIRole, guildId: string);
+    /** Update mutable fields from fresh API data. Used by edit and gateway events. */
+    _patch(data: Partial<APIRole>): void;
     /** Returns a mention string (e.g. `<@&123456>`). */
     toString(): string;
     /**
@@ -744,6 +776,22 @@ declare class Role extends Base {
      * if (role.has('ManageChannels')) { ... }
      */
     has(permission: PermissionResolvable): boolean;
+    /**
+     * Edit this role.
+     * Requires Manage Roles permission.
+     * @param options - Role updates (permissions accepts PermissionResolvable for convenience)
+     * @returns This role (updated in place)
+     * @example
+     * await role.edit({ name: 'Moderator', permissions: ['BanMembers', 'KickMembers'] });
+     */
+    edit(options: RESTUpdateRoleBody & {
+        permissions?: string | PermissionResolvable;
+    }): Promise<Role>;
+    /**
+     * Delete this role.
+     * Requires Manage Roles permission.
+     */
+    delete(): Promise<void>;
 }
 
 /** Represents a ban in a guild. */
@@ -800,7 +848,7 @@ declare class Guild extends Base {
     splashWidth?: number | null;
     /** Splash image height. Optional. */
     splashHeight?: number | null;
-    members: Collection<string, GuildMember>;
+    members: GuildMemberManager;
     channels: Collection<string, GuildChannel>;
     roles: Collection<string, Role>;
     /** @param data - API guild from GET /guilds/{id} or gateway GUILD_CREATE */
@@ -834,6 +882,29 @@ declare class Guild extends Base {
      * Requires Manage Roles permission.
      */
     removeRoleFromMember(userId: string, roleId: string): Promise<void>;
+    /**
+     * Create a role in this guild.
+     * Requires Manage Roles permission.
+     * @param options - Role data (permissions accepts PermissionResolvable for convenience)
+     * @returns The created role
+     * @example
+     * const role = await guild.createRole({ name: 'Mod', permissions: ['KickMembers', 'BanMembers'] });
+     */
+    createRole(options: RESTCreateRoleBody & {
+        permissions?: string | PermissionResolvable;
+    }): Promise<Role>;
+    /**
+     * Fetch all roles in this guild.
+     * @returns Array of Role objects (cached in guild.roles)
+     */
+    fetchRoles(): Promise<Role[]>;
+    /**
+     * Fetch a role by ID.
+     * @param roleId - The role ID to fetch
+     * @returns The role
+     * @throws FluxerError with ROLE_NOT_FOUND if role does not exist (404)
+     */
+    fetchRole(roleId: string): Promise<Role>;
     /**
      * Resolve a role ID from an argument (role mention, raw ID, or name).
      * Fetches guild roles if name is provided.
@@ -1106,6 +1177,62 @@ declare const Events: {
     readonly Debug: "debug";
 };
 
+/** Result of {@link UsersManager.fetchWithProfile}. */
+interface FetchedUserWithProfile {
+    /** The user (cached in client.users). */
+    user: User;
+    /** Raw user data from GET /users/{id}. */
+    userData: APIUserPartial;
+    /** Global profile (bio, pronouns, mutual guilds, etc.). Null if unavailable. */
+    globalProfile: APIProfileResponse | null;
+    /** Server-specific profile when guildId was provided. Null if unavailable. */
+    serverProfile: APIProfileResponse | null;
+    /** Guild member when guildId was provided and user is in the guild. Null otherwise. */
+    member: GuildMember | null;
+    /** Raw member data when member exists (for premium_since, etc.). */
+    memberData: (APIGuildMember & {
+        user: {
+            id: string;
+        };
+    }) | null;
+}
+/**
+ * Manages users with fetch and profile helpers.
+ * Extends Collection so you can use .get(), .set(), .filter(), etc.
+ */
+declare class UsersManager extends Collection<string, User> {
+    private readonly client;
+    constructor(client: Client);
+    /**
+     * Fetch a user by ID from the API.
+     * Updates cache if user already exists.
+     * @param userId - Snowflake of the user
+     * @returns The user
+     * @throws FluxerError (or REST error) if user not found
+     * @example
+     * const user = await client.users.fetch(userId);
+     * console.log(user.username);
+     */
+    fetch(userId: string): Promise<User>;
+    /**
+     * Fetch a user with full profile and optional guild context.
+     * Returns user, global profile, server profile (when guildId), and member (when guildId).
+     * Ideal for userinfo commands.
+     * @param userId - Snowflake of the user
+     * @param options - Optional guildId for server profile and member data
+     * @returns User, raw data, profiles, and member (when in guild)
+     * @throws FluxerError (or REST error) if user not found
+     * @example
+     * const { user, globalProfile, serverProfile, member } = await client.users.fetchWithProfile(
+     *   userId,
+     *   { guildId: message.guildId ?? undefined },
+     * );
+     */
+    fetchWithProfile(userId: string, options?: {
+        guildId?: string | null;
+    }): Promise<FetchedUserWithProfile>;
+}
+
 /**
  * Callback parameter types for client events. Use with client.on(Events.X, handler).
  * @see Events
@@ -1197,7 +1324,7 @@ declare class Client extends EventEmitter {
     readonly rest: REST;
     readonly guilds: GuildManager;
     readonly channels: ChannelManager;
-    readonly users: Collection<string, User>;
+    readonly users: UsersManager;
     /** Typed event handlers. Use client.events.MessageReactionAdd((reaction, user, messageId, channelId, emoji, userId) => {...}) or client.on(Events.MessageReactionAdd, ...). */
     readonly events: ClientEventMethods;
     /** The authenticated bot user. Null until READY is received. */
@@ -1338,6 +1465,7 @@ declare const ErrorCodes: {
     readonly MessageNotFound: "MESSAGE_NOT_FOUND";
     readonly GuildNotFound: "GUILD_NOT_FOUND";
     readonly MemberNotFound: "MEMBER_NOT_FOUND";
+    readonly RoleNotFound: "ROLE_NOT_FOUND";
 };
 
 interface CdnUrlOptions {
@@ -1401,4 +1529,4 @@ declare function cdnMemberBannerURL(guildId: string, userId: string, bannerHash:
  */
 declare function cdnDefaultAvatarURL(discriminatorIndex?: number): string;
 
-export { Base, CategoryChannel, type CdnUrlOptions, Channel, ChannelManager, Client, type ClientEventMethods, type ClientEvents, ClientUser, type CollectedReaction, DMChannel, ErrorCodes, Events, FluxerError, type FluxerErrorOptions, Guild, GuildBan, GuildChannel, GuildEmoji, GuildMember, GuildSticker, Invite, LinkChannel, Message, MessageCollector, type MessageCollectorEndReason, type MessageCollectorOptions, type MessageEditOptions, MessageManager, MessageReaction, type MessageSendOptions, type PartialMessage, ReactionCollector, type ReactionCollectorEndReason, type ReactionCollectorOptions, Role, TextChannel, User, VoiceChannel, Webhook, type WebhookSendOptions, cdnAvatarURL, cdnBannerURL, cdnDefaultAvatarURL, cdnDisplayAvatarURL, cdnMemberAvatarURL, cdnMemberBannerURL };
+export { Base, CategoryChannel, type CdnUrlOptions, Channel, ChannelManager, Client, type ClientEventMethods, type ClientEvents, ClientUser, type CollectedReaction, DMChannel, ErrorCodes, Events, type FetchedUserWithProfile, FluxerError, type FluxerErrorOptions, Guild, GuildBan, GuildChannel, GuildEmoji, GuildMember, GuildMemberManager, GuildSticker, Invite, LinkChannel, Message, MessageCollector, type MessageCollectorEndReason, type MessageCollectorOptions, type MessageEditOptions, MessageManager, MessageReaction, type MessageSendOptions, type PartialMessage, ReactionCollector, type ReactionCollectorEndReason, type ReactionCollectorOptions, Role, TextChannel, User, UsersManager, VoiceChannel, Webhook, type WebhookSendOptions, cdnAvatarURL, cdnBannerURL, cdnDefaultAvatarURL, cdnDisplayAvatarURL, cdnMemberAvatarURL, cdnMemberBannerURL };