@fluxerjs/core 1.1.1 → 1.1.3

package/dist/index.js

@@ -49,7 +49,8 @@ var init_ErrorCodes = __esm({
       ChannelNotFound: "CHANNEL_NOT_FOUND",
       MessageNotFound: "MESSAGE_NOT_FOUND",
       GuildNotFound: "GUILD_NOT_FOUND",
-      MemberNotFound: "MEMBER_NOT_FOUND"
+      MemberNotFound: "MEMBER_NOT_FOUND",
+      RoleNotFound: "ROLE_NOT_FOUND"
     };
   }
 });
@@ -1148,6 +1149,50 @@ var init_Channel = __esm({
   }
 });
 
+// src/client/GuildMemberManager.ts
+var import_collection5, GuildMemberManager;
+var init_GuildMemberManager = __esm({
+  "src/client/GuildMemberManager.ts"() {
+    "use strict";
+    import_collection5 = require("@fluxerjs/collection");
+    GuildMemberManager = class extends import_collection5.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/util/permissions.ts
 function computePermissions(basePermissions, overwrites, memberRoles, memberId, isOwner) {
   if (isOwner) return import_util3.ALL_PERMISSIONS_BIGINT;
@@ -1332,11 +1377,12 @@ var Role_exports = {};
 __export(Role_exports, {
   Role: () => Role
 });
-var import_util5, Role;
+var import_types9, import_util5, Role;
 var init_Role = __esm({
   "src/structures/Role.ts"() {
     "use strict";
     init_Base();
+    import_types9 = require("@fluxerjs/types");
     import_util5 = require("@fluxerjs/util");
     Role = class extends Base {
       client;
@@ -1368,6 +1414,17 @@ var init_Role = __esm({
         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}>`;
@@ -1390,6 +1447,42 @@ var init_Role = __esm({
         if ((rolePerms & BigInt(import_util5.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 : (0, import_util5.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(import_types9.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(import_types9.Routes.guildRole(this.guildId, this.id), { auth: true });
+        const guild = this.client.guilds.get(this.guildId);
+        if (guild) guild.roles.delete(this.id);
+      }
     };
   }
 });
@@ -1399,12 +1492,12 @@ var GuildBan_exports = {};
 __export(GuildBan_exports, {
   GuildBan: () => GuildBan
 });
-var import_types9, GuildBan;
+var import_types10, GuildBan;
 var init_GuildBan = __esm({
   "src/structures/GuildBan.ts"() {
     "use strict";
     init_Base();
-    import_types9 = require("@fluxerjs/types");
+    import_types10 = require("@fluxerjs/types");
     GuildBan = class extends Base {
       client;
       guildId;
@@ -1426,7 +1519,7 @@ var init_GuildBan = __esm({
        * Requires Ban Members permission.
        */
       async unban() {
-        await this.client.rest.delete(import_types9.Routes.guildBan(this.guildId, this.user.id), {
+        await this.client.rest.delete(import_types10.Routes.guildBan(this.guildId, this.user.id), {
           auth: true
         });
       }
@@ -1439,20 +1532,21 @@ var Guild_exports = {};
 __export(Guild_exports, {
   Guild: () => Guild
 });
-var import_util6, import_rest3, import_collection5, import_types10, Guild;
+var import_util6, import_rest3, import_collection6, import_types11, Guild;
 var init_Guild = __esm({
   "src/structures/Guild.ts"() {
     "use strict";
     import_util6 = require("@fluxerjs/util");
     import_rest3 = require("@fluxerjs/rest");
+    import_collection6 = require("@fluxerjs/collection");
     init_Base();
     init_FluxerError();
     init_ErrorCodes();
-    import_collection5 = require("@fluxerjs/collection");
+    init_GuildMemberManager();
     init_GuildMember();
     init_Role();
     init_Constants();
-    import_types10 = require("@fluxerjs/types");
+    import_types11 = require("@fluxerjs/types");
     Guild = class extends Base {
       client;
       id;
@@ -1487,14 +1581,15 @@ var init_Guild = __esm({
       splashWidth;
       /** Splash image height. Optional. */
       splashHeight;
-      members = new import_collection5.Collection();
-      channels = new import_collection5.Collection();
-      roles = new import_collection5.Collection();
+      members;
+      channels = new import_collection6.Collection();
+      roles = new import_collection6.Collection();
       /** @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;
@@ -1544,7 +1639,7 @@ var init_Guild = __esm({
        * Requires Manage Roles permission.
        */
       async addRoleToMember(userId, roleId) {
-        await this.client.rest.put(import_types10.Routes.guildMemberRole(this.id, userId, roleId));
+        await this.client.rest.put(import_types11.Routes.guildMemberRole(this.id, userId, roleId));
       }
       /**
        * Remove a role from a member by user ID. Does not require fetching the member first.
@@ -1553,7 +1648,75 @@ var init_Guild = __esm({
        * Requires Manage Roles permission.
        */
       async removeRoleFromMember(userId, roleId) {
-        await this.client.rest.delete(import_types10.Routes.guildMemberRole(this.id, userId, roleId));
+        await this.client.rest.delete(import_types11.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 : (0, import_util6.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(import_types11.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(
+          import_types11.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(import_types11.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 import_rest3.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).
@@ -1569,7 +1732,7 @@ var init_Guild = __esm({
           (r) => !!(r.name && r.name.toLowerCase() === arg.trim().toLowerCase())
         );
         if (cached) return cached.id;
-        const roles = await this.client.rest.get(import_types10.Routes.guildRoles(this.id));
+        const roles = await this.client.rest.get(import_types11.Routes.guildRoles(this.id));
         const list = Array.isArray(roles) ? roles : Object.values(roles ?? {});
         const role = list.find((r) => !!(r.name && r.name.toLowerCase() === arg.trim().toLowerCase()));
         if (role) {
@@ -1592,7 +1755,7 @@ var init_Guild = __esm({
           body.delete_message_days = options.delete_message_days;
         if (options?.ban_duration_seconds != null)
           body.ban_duration_seconds = options.ban_duration_seconds;
-        await this.client.rest.put(import_types10.Routes.guildBan(this.id, userId), {
+        await this.client.rest.put(import_types11.Routes.guildBan(this.id, userId), {
           body: Object.keys(body).length ? body : void 0,
           auth: true
         });
@@ -1603,7 +1766,7 @@ var init_Guild = __esm({
        */
       async fetchBans() {
         const { GuildBan: GuildBan2 } = await Promise.resolve().then(() => (init_GuildBan(), GuildBan_exports));
-        const data = await this.client.rest.get(import_types10.Routes.guildBans(this.id));
+        const data = await this.client.rest.get(import_types11.Routes.guildBans(this.id));
         const list = Array.isArray(data) ? data : data?.bans ?? [];
         return list.map((b) => new GuildBan2(this.client, { ...b, guild_id: this.id }, this.id));
       }
@@ -1613,7 +1776,7 @@ var init_Guild = __esm({
        * Requires Ban Members permission.
        */
       async unban(userId) {
-        await this.client.rest.delete(import_types10.Routes.guildBan(this.id, userId), { auth: true });
+        await this.client.rest.delete(import_types11.Routes.guildBan(this.id, userId), { auth: true });
       }
       /**
        * Kick a member from this guild.
@@ -1621,7 +1784,7 @@ var init_Guild = __esm({
        * Requires Kick Members permission.
        */
       async kick(userId) {
-        await this.client.rest.delete(import_types10.Routes.guildMember(this.id, userId), { auth: true });
+        await this.client.rest.delete(import_types11.Routes.guildMember(this.id, userId), { auth: true });
       }
       /**
        * Fetch a guild member by user ID.
@@ -1633,7 +1796,7 @@ var init_Guild = __esm({
       async fetchMember(userId) {
         try {
           const data = await this.client.rest.get(
-            import_types10.Routes.guildMember(this.id, userId)
+            import_types11.Routes.guildMember(this.id, userId)
           );
           const member = new GuildMember(this.client, { ...data, guild_id: this.id }, this);
           this.members.set(member.id, member);
@@ -1661,13 +1824,13 @@ var init_Guild = __esm({
         if (options?.userId) params.set("user_id", options.userId);
         if (options?.actionType != null) params.set("action_type", String(options.actionType));
         const qs = params.toString();
-        const url = import_types10.Routes.guildAuditLogs(this.id) + (qs ? `?${qs}` : "");
+        const url = import_types11.Routes.guildAuditLogs(this.id) + (qs ? `?${qs}` : "");
         return this.client.rest.get(url);
       }
       /** Fetch all webhooks in this guild. Returned webhooks do not include the token (cannot send). */
       async fetchWebhooks() {
         const { Webhook: Webhook2 } = await Promise.resolve().then(() => (init_Webhook(), Webhook_exports));
-        const data = await this.client.rest.get(import_types10.Routes.guildWebhooks(this.id));
+        const data = await this.client.rest.get(import_types11.Routes.guildWebhooks(this.id));
         const list = Array.isArray(data) ? data : Object.values(data ?? {});
         return list.map((w) => new Webhook2(this.client, w));
       }
@@ -1678,7 +1841,7 @@ var init_Guild = __esm({
        */
       async createChannel(data) {
         const { Channel: Channel2 } = await Promise.resolve().then(() => (init_Channel(), Channel_exports));
-        const created = await this.client.rest.post(import_types10.Routes.guildChannels(this.id), {
+        const created = await this.client.rest.post(import_types11.Routes.guildChannels(this.id), {
           body: data,
           auth: true
         });
@@ -1695,7 +1858,7 @@ var init_Guild = __esm({
        */
       async fetchChannels() {
         const { Channel: Channel2 } = await Promise.resolve().then(() => (init_Channel(), Channel_exports));
-        const data = await this.client.rest.get(import_types10.Routes.guildChannels(this.id));
+        const data = await this.client.rest.get(import_types11.Routes.guildChannels(this.id));
         const list = Array.isArray(data) ? data : Object.values(data ?? {});
         const channels = [];
         for (const ch of list) {
@@ -1714,7 +1877,7 @@ var init_Guild = __esm({
        * Requires Manage Channels permission.
        */
       async setChannelPositions(updates) {
-        await this.client.rest.patch(import_types10.Routes.guildChannels(this.id), {
+        await this.client.rest.patch(import_types11.Routes.guildChannels(this.id), {
           body: updates,
           auth: true
         });
@@ -1724,12 +1887,12 @@ var init_Guild = __esm({
 });
 
 // src/structures/User.ts
-var import_types12, User;
+var import_types13, User;
 var init_User = __esm({
   "src/structures/User.ts"() {
     "use strict";
     init_Base();
-    import_types12 = require("@fluxerjs/types");
+    import_types13 = require("@fluxerjs/types");
     init_Constants();
     User = class extends Base {
       client;
@@ -1807,7 +1970,7 @@ var init_User = __esm({
        */
       async createDM() {
         const { DMChannel: DMChannelClass } = await Promise.resolve().then(() => (init_Channel(), Channel_exports));
-        const data = await this.client.rest.post(import_types12.Routes.userMeChannels(), {
+        const data = await this.client.rest.post(import_types13.Routes.userMeChannels(), {
           body: { recipient_id: this.id },
           auth: true
         });
@@ -1830,11 +1993,11 @@ var MessageReaction_exports = {};
 __export(MessageReaction_exports, {
   MessageReaction: () => MessageReaction
 });
-var import_types13, import_rest4, MessageReaction;
+var import_types15, import_rest4, MessageReaction;
 var init_MessageReaction = __esm({
   "src/structures/MessageReaction.ts"() {
     "use strict";
-    import_types13 = require("@fluxerjs/types");
+    import_types15 = require("@fluxerjs/types");
     import_rest4 = require("@fluxerjs/rest");
     init_FluxerError();
     init_ErrorCodes();
@@ -1873,16 +2036,16 @@ var init_MessageReaction = __esm({
         try {
           const { Message: Message2 } = await Promise.resolve().then(() => (init_Message(), Message_exports));
           const data = await this.client.rest.get(
-            import_types13.Routes.channelMessage(this.channelId, this.messageId)
+            import_types15.Routes.channelMessage(this.channelId, this.messageId)
           );
           return new Message2(this.client, data);
         } catch (err) {
           if (err instanceof import_rest4.RateLimitError) throw err;
           if (err instanceof import_rest4.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 });
         }
@@ -1896,12 +2059,12 @@ var ClientUser_exports = {};
 __export(ClientUser_exports, {
   ClientUser: () => ClientUser
 });
-var import_types14, ClientUser;
+var import_types16, ClientUser;
 var init_ClientUser = __esm({
   "src/client/ClientUser.ts"() {
     "use strict";
     init_User();
-    import_types14 = require("@fluxerjs/types");
+    import_types16 = require("@fluxerjs/types");
     ClientUser = class extends User {
       constructor(client, data) {
         super(client, { ...data });
@@ -1912,7 +2075,7 @@ var init_ClientUser = __esm({
        */
       async fetchGuilds() {
         const { Guild: Guild2 } = await Promise.resolve().then(() => (init_Guild(), Guild_exports));
-        const data = await this.client.rest.get(import_types14.Routes.currentUserGuilds());
+        const data = await this.client.rest.get(import_types16.Routes.currentUserGuilds());
         const list = Array.isArray(data) ? data : data?.guilds ?? [];
         const guilds = [];
         for (const g of list) {
@@ -1927,7 +2090,7 @@ var init_ClientUser = __esm({
        * @param guildId - The guild ID to leave
        */
       async leaveGuild(guildId) {
-        await this.client.rest.delete(import_types14.Routes.leaveGuild(guildId), { auth: true });
+        await this.client.rest.delete(import_types16.Routes.leaveGuild(guildId), { auth: true });
         this.client.guilds.delete(guildId);
       }
     };
@@ -1949,17 +2112,18 @@ __export(index_exports, {
   ErrorCodes: () => ErrorCodes,
   Events: () => Events,
   FluxerError: () => FluxerError,
-  GatewayOpcodes: () => import_types18.GatewayOpcodes,
+  GatewayOpcodes: () => import_types20.GatewayOpcodes,
   Guild: () => Guild,
   GuildBan: () => GuildBan,
   GuildChannel: () => GuildChannel,
   GuildEmoji: () => GuildEmoji,
   GuildMember: () => GuildMember,
+  GuildMemberManager: () => GuildMemberManager,
   GuildSticker: () => GuildSticker,
   Invite: () => Invite,
   LinkChannel: () => LinkChannel,
   Message: () => Message,
-  MessageAttachmentFlags: () => import_types18.MessageAttachmentFlags,
+  MessageAttachmentFlags: () => import_types20.MessageAttachmentFlags,
   MessageCollector: () => MessageCollector,
   MessageManager: () => MessageManager,
   MessagePayload: () => import_builders3.MessagePayload,
@@ -1968,9 +2132,12 @@ __export(index_exports, {
   PermissionsBitField: () => import_util9.PermissionsBitField,
   ReactionCollector: () => ReactionCollector,
   Role: () => Role,
-  Routes: () => import_types18.Routes,
+  Routes: () => import_types20.Routes,
   TextChannel: () => TextChannel,
   User: () => User,
+  UserFlagsBitField: () => import_util9.UserFlagsBitField,
+  UserFlagsBits: () => import_util9.UserFlagsBits,
+  UsersManager: () => UsersManager,
   VoiceChannel: () => VoiceChannel,
   Webhook: () => Webhook,
   cdnAvatarURL: () => cdnAvatarURL,
@@ -1979,6 +2146,7 @@ __export(index_exports, {
   cdnDisplayAvatarURL: () => cdnDisplayAvatarURL,
   cdnMemberAvatarURL: () => cdnMemberAvatarURL,
   cdnMemberBannerURL: () => cdnMemberBannerURL,
+  resolvePermissionsToBitfield: () => import_util9.resolvePermissionsToBitfield,
   resolveTenorToImageUrl: () => import_util8.resolveTenorToImageUrl
 });
 module.exports = __toCommonJS(index_exports);
@@ -1987,8 +2155,7 @@ module.exports = __toCommonJS(index_exports);
 var import_events3 = require("events");
 var import_rest5 = require("@fluxerjs/rest");
 var import_ws = require("@fluxerjs/ws");
-var import_types15 = require("@fluxerjs/types");
-var import_collection7 = require("@fluxerjs/collection");
+var import_types17 = require("@fluxerjs/types");
 
 // src/client/ChannelManager.ts
 var import_collection4 = require("@fluxerjs/collection");
@@ -2094,9 +2261,9 @@ var ChannelManager = class extends import_collection4.Collection {
 };
 
 // src/client/GuildManager.ts
-var import_collection6 = require("@fluxerjs/collection");
-var import_types11 = require("@fluxerjs/types");
-var GuildManager = class extends import_collection6.Collection {
+var import_collection7 = require("@fluxerjs/collection");
+var import_types12 = require("@fluxerjs/types");
+var GuildManager = class extends import_collection7.Collection {
   constructor(client) {
     super();
     this.client = client;
@@ -2115,7 +2282,7 @@ var GuildManager = class extends import_collection6.Collection {
     try {
       const { Guild: Guild2 } = await Promise.resolve().then(() => (init_Guild(), Guild_exports));
       const data = await this.client.rest.get(
-        import_types11.Routes.guild(guildId)
+        import_types12.Routes.guild(guildId)
       );
       const guild = new Guild2(this.client, data);
       this.set(guild.id, guild);
@@ -2133,6 +2300,73 @@ init_Events();
 var import_util7 = require("@fluxerjs/util");
 init_User();
 
+// src/client/UsersManager.ts
+var import_collection8 = require("@fluxerjs/collection");
+var import_types14 = require("@fluxerjs/types");
+init_GuildMember();
+var UsersManager = class extends import_collection8.Collection {
+  constructor(client) {
+    super();
+    this.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);
+   */
+  async fetch(userId) {
+    const data = await this.client.rest.get(import_types14.Routes.user(userId));
+    return this.client.getOrCreateUser(data);
+  }
+  /**
+   * 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 },
+   * );
+   */
+  async fetchWithProfile(userId, options) {
+    const guildId = options?.guildId ?? void 0;
+    const [userData, globalProfileData, serverProfileData, memberData] = await Promise.all([
+      this.client.rest.get(import_types14.Routes.user(userId)),
+      this.client.rest.get(import_types14.Routes.userProfile(userId)).catch(() => null),
+      guildId ? this.client.rest.get(import_types14.Routes.userProfile(userId, guildId)).catch(() => null) : Promise.resolve(null),
+      guildId ? this.client.rest.get(import_types14.Routes.guildMember(guildId, userId)).catch(() => null) : Promise.resolve(null)
+    ]);
+    const user = this.client.getOrCreateUser(userData);
+    const globalProfile = globalProfileData && typeof globalProfileData === "object" ? globalProfileData : null;
+    const serverProfile = serverProfileData && typeof serverProfileData === "object" ? serverProfileData : null;
+    let member = null;
+    if (memberData && guildId) {
+      const guild = this.client.guilds.get(guildId) ?? await this.client.guilds.fetch(guildId);
+      if (guild) {
+        member = new GuildMember(this.client, { ...memberData, guild_id: guildId }, guild);
+        guild.members.set(member.id, member);
+      }
+    }
+    return {
+      user,
+      userData,
+      globalProfile,
+      serverProfile,
+      member,
+      memberData
+    };
+  }
+};
+
 // src/client/EventHandlerRegistry.ts
 init_Events();
 var handlers = /* @__PURE__ */ new Map();
@@ -2213,6 +2447,7 @@ handlers.set("MESSAGE_REACTION_REMOVE_EMOJI", async (client, d) => {
 handlers.set("GUILD_CREATE", async (client, d) => {
   const { Guild: Guild2 } = await Promise.resolve().then(() => (init_Guild(), Guild_exports));
   const { Channel: Channel2 } = await Promise.resolve().then(() => (init_Channel(), Channel_exports));
+  const { GuildMember: GuildMember2 } = await Promise.resolve().then(() => (init_GuildMember(), GuildMember_exports));
   const raw = d;
   const guildData = raw?.properties != null ? { ...raw.properties, roles: raw.roles } : raw;
   const guild = new Guild2(client, guildData);
@@ -2222,6 +2457,13 @@ handlers.set("GUILD_CREATE", async (client, d) => {
     const channel = Channel2.from(client, ch);
     if (channel) client.channels.set(channel.id, channel);
   }
+  for (const m of g.members ?? []) {
+    if (m?.user?.id) {
+      const memberData = { ...m, guild_id: guild.id };
+      const member = new GuildMember2(client, memberData, guild);
+      guild.members.set(member.id, member);
+    }
+  }
   client.emit(Events.GuildCreate, guild);
   if (g.voice_states?.length) {
     client.emit(Events.VoiceStatesSync, { guildId: guild.id, voiceStates: g.voice_states });
@@ -2348,8 +2590,13 @@ handlers.set("GUILD_ROLE_UPDATE", async (client, d) => {
   const data = d;
   const guild = client.guilds.get(data.guild_id);
   if (guild) {
-    const { Role: Role2 } = await Promise.resolve().then(() => (init_Role(), Role_exports));
-    guild.roles.set(data.role.id, new Role2(client, data.role, guild.id));
+    const existing = guild.roles.get(data.role.id);
+    if (existing) {
+      existing._patch(data.role);
+    } else {
+      const { Role: Role2 } = await Promise.resolve().then(() => (init_Role(), Role_exports));
+      guild.roles.set(data.role.id, new Role2(client, data.role, guild.id));
+    }
   }
   client.emit(Events.GuildRoleUpdate, data);
 });
@@ -2426,6 +2673,10 @@ var Client = class extends import_events3.EventEmitter {
       get: () => this.guilds,
       configurable: true
     });
+    Object.defineProperty(this.users, "cache", {
+      get: () => this.users,
+      configurable: true
+    });
     this.rest = new import_rest5.REST({
       api: options.rest?.api ?? "https://api.fluxer.app",
       version: options.rest?.version ?? "1",
@@ -2435,7 +2686,7 @@ var Client = class extends import_events3.EventEmitter {
   rest;
   guilds = new GuildManager(this);
   channels = new ChannelManager(this);
-  users = new import_collection7.Collection();
+  users = new UsersManager(this);
   /** Typed event handlers. Use client.events.MessageReactionAdd((reaction, user, messageId, channelId, emoji, userId) => {...}) or client.on(Events.MessageReactionAdd, ...). */
   events;
   /** The authenticated bot user. Null until READY is received. */
@@ -2462,7 +2713,7 @@ var Client = class extends import_events3.EventEmitter {
     if (parsed.id) return (0, import_util7.formatEmoji)(parsed);
     if (!/^\w+$/.test(parsed.name)) return encodeURIComponent(parsed.name);
     if (guildId) {
-      const emojis = await this.rest.get(import_types15.Routes.guildEmojis(guildId));
+      const emojis = await this.rest.get(import_types17.Routes.guildEmojis(guildId));
       const list = Array.isArray(emojis) ? emojis : Object.values(emojis ?? {});
       const found = list.find((e) => e.name && e.name.toLowerCase() === parsed.name.toLowerCase());
       if (found) return (0, import_util7.formatEmoji)({ ...parsed, id: found.id, animated: found.animated });
@@ -2629,11 +2880,12 @@ var Client = class extends import_events3.EventEmitter {
     return this.readyAt !== null && this.user !== null;
   }
   static get Routes() {
-    return import_types15.Routes;
+    return import_types17.Routes;
   }
 };
 
 // src/index.ts
+init_GuildMemberManager();
 init_MessageManager();
 init_ClientUser();
 init_Base();
@@ -2650,7 +2902,7 @@ init_GuildBan();
 
 // src/structures/GuildEmoji.ts
 init_Base();
-var import_types16 = require("@fluxerjs/types");
+var import_types18 = require("@fluxerjs/types");
 init_Constants();
 var GuildEmoji = class extends Base {
   client;
@@ -2678,7 +2930,7 @@ var GuildEmoji = class extends Base {
   }
   /** Delete this emoji. Requires Manage Emojis and Stickers permission. */
   async delete() {
-    await this.client.rest.delete(import_types16.Routes.guildEmoji(this.guildId, this.id), {
+    await this.client.rest.delete(import_types18.Routes.guildEmoji(this.guildId, this.id), {
       auth: true
     });
   }
@@ -2687,7 +2939,7 @@ var GuildEmoji = class extends Base {
    * Requires Manage Emojis and Stickers permission.
    */
   async edit(options) {
-    const data = await this.client.rest.patch(import_types16.Routes.guildEmoji(this.guildId, this.id), {
+    const data = await this.client.rest.patch(import_types18.Routes.guildEmoji(this.guildId, this.id), {
       body: options,
       auth: true
     });
@@ -2698,7 +2950,7 @@ var GuildEmoji = class extends Base {
 
 // src/structures/GuildSticker.ts
 init_Base();
-var import_types17 = require("@fluxerjs/types");
+var import_types19 = require("@fluxerjs/types");
 init_Constants();
 var GuildSticker = class extends Base {
   client;
@@ -2726,7 +2978,7 @@ var GuildSticker = class extends Base {
   }
   /** Delete this sticker. Requires Manage Emojis and Stickers permission. */
   async delete() {
-    await this.client.rest.delete(import_types17.Routes.guildSticker(this.guildId, this.id), {
+    await this.client.rest.delete(import_types19.Routes.guildSticker(this.guildId, this.id), {
       auth: true
     });
   }
@@ -2735,7 +2987,7 @@ var GuildSticker = class extends Base {
    * Requires Manage Emojis and Stickers permission.
    */
   async edit(options) {
-    const data = await this.client.rest.patch(import_types17.Routes.guildSticker(this.guildId, this.id), {
+    const data = await this.client.rest.patch(import_types19.Routes.guildSticker(this.guildId, this.id), {
       body: options,
       auth: true
     });
@@ -2753,7 +3005,7 @@ init_ReactionCollector();
 init_FluxerError();
 init_ErrorCodes();
 var import_builders3 = require("@fluxerjs/builders");
-var import_types18 = require("@fluxerjs/types");
+var import_types20 = require("@fluxerjs/types");
 var import_util8 = require("@fluxerjs/util");
 var import_util9 = require("@fluxerjs/util");
 init_cdn();
@@ -2777,6 +3029,7 @@ init_cdn();
   GuildChannel,
   GuildEmoji,
   GuildMember,
+  GuildMemberManager,
   GuildSticker,
   Invite,
   LinkChannel,
@@ -2793,6 +3046,9 @@ init_cdn();
   Routes,
   TextChannel,
   User,
+  UserFlagsBitField,
+  UserFlagsBits,
+  UsersManager,
   VoiceChannel,
   Webhook,
   cdnAvatarURL,
@@ -2801,5 +3057,6 @@ init_cdn();
   cdnDisplayAvatarURL,
   cdnMemberAvatarURL,
   cdnMemberBannerURL,
+  resolvePermissionsToBitfield,
   resolveTenorToImageUrl
 });