@fluxerjs/core 1.0.8 → 1.1.0

package/dist/{Channel-TWPDKW2P.mjs → Channel-WJZZSNML.mjs}

@@ -6,7 +6,9 @@ import {
   LinkChannel,
   TextChannel,
   VoiceChannel
-} from "./chunk-CZIO2D7F.mjs";
+} from "./chunk-LU2SNC5G.mjs";
+import "./chunk-AH7KYH2Z.mjs";
+import "./chunk-PM2IUGNR.mjs";
 import "./chunk-XNS4O6QJ.mjs";
 export {
   CategoryChannel,

package/dist/{ClientUser-2K2BACK7.mjs → ClientUser-DJO2FS7P.mjs}

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

package/dist/Guild-2P77HBQM.mjs

@@ -0,0 +1,11 @@
+import {
+  Guild
+} from "./chunk-4XJIM6SC.mjs";
+import "./chunk-DUQAD7F6.mjs";
+import "./chunk-X6K3ZD62.mjs";
+import "./chunk-HQMYRYMY.mjs";
+import "./chunk-DQ4TNBPG.mjs";
+import "./chunk-XNS4O6QJ.mjs";
+export {
+  Guild
+};

package/dist/GuildBan-7CXLTPKY.mjs

@@ -0,0 +1,7 @@
+import {
+  GuildBan
+} from "./chunk-UXIF75BV.mjs";
+import "./chunk-XNS4O6QJ.mjs";
+export {
+  GuildBan
+};

package/dist/GuildMember-43B5E5CH.mjs

@@ -0,0 +1,9 @@
+import {
+  GuildMember
+} from "./chunk-DUQAD7F6.mjs";
+import "./chunk-X6K3ZD62.mjs";
+import "./chunk-HQMYRYMY.mjs";
+import "./chunk-XNS4O6QJ.mjs";
+export {
+  GuildMember
+};

package/dist/{Message-G2QIKZQK.mjs → Invite-UM5BU5A6.mjs}

@@ -1,7 +1,7 @@
 import {
-  Message
-} from "./chunk-CO5EL5LH.mjs";
+  Invite
+} from "./chunk-QEXIYXXU.mjs";
 import "./chunk-XNS4O6QJ.mjs";
 export {
-  Message
+  Invite
 };

package/dist/Message-OFIVTTAZ.mjs

@@ -0,0 +1,9 @@
+import {
+  Message
+} from "./chunk-V7LPVPGH.mjs";
+import "./chunk-AH7KYH2Z.mjs";
+import "./chunk-PM2IUGNR.mjs";
+import "./chunk-XNS4O6QJ.mjs";
+export {
+  Message
+};

package/dist/{MessageReaction-XRPYZDSC.mjs → MessageReaction-V4UZ7OXE.mjs}

@@ -1,6 +1,6 @@
 import {
   MessageReaction
-} from "./chunk-HBF5QEDH.mjs";
+} from "./chunk-CEABHTAF.mjs";
 import "./chunk-XNS4O6QJ.mjs";
 export {
   MessageReaction

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

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

package/dist/Webhook-RWDDYW2Q.mjs

@@ -0,0 +1,10 @@
+import {
+  Webhook
+} from "./chunk-CJVQNARM.mjs";
+import "./chunk-PM2IUGNR.mjs";
+import "./chunk-X6K3ZD62.mjs";
+import "./chunk-HQMYRYMY.mjs";
+import "./chunk-XNS4O6QJ.mjs";
+export {
+  Webhook
+};

package/dist/chunk-4XJIM6SC.mjs

@@ -0,0 +1,315 @@
+import {
+  GuildMember
+} from "./chunk-DUQAD7F6.mjs";
+import {
+  CDN_URL
+} from "./chunk-HQMYRYMY.mjs";
+import {
+  Role
+} from "./chunk-DQ4TNBPG.mjs";
+import {
+  Base
+} from "./chunk-XNS4O6QJ.mjs";
+
+// src/structures/Guild.ts
+import { parseRoleMention } from "@fluxerjs/util";
+import { FluxerAPIError } from "@fluxerjs/rest";
+
+// src/errors/FluxerError.ts
+var FluxerError = class _FluxerError extends Error {
+  code;
+  constructor(message, options) {
+    super(message, options?.cause ? { cause: options.cause } : void 0);
+    this.name = "FluxerError";
+    this.code = options?.code;
+    Object.setPrototypeOf(this, _FluxerError.prototype);
+  }
+};
+
+// src/errors/ErrorCodes.ts
+var ErrorCodes = {
+  ClientNotReady: "CLIENT_NOT_READY",
+  InvalidToken: "INVALID_TOKEN",
+  AlreadyLoggedIn: "ALREADY_LOGGED_IN",
+  ChannelNotFound: "CHANNEL_NOT_FOUND",
+  MessageNotFound: "MESSAGE_NOT_FOUND",
+  GuildNotFound: "GUILD_NOT_FOUND",
+  MemberNotFound: "MEMBER_NOT_FOUND"
+};
+
+// src/structures/Guild.ts
+import { Collection } from "@fluxerjs/collection";
+import { Routes } from "@fluxerjs/types";
+var Guild = class extends Base {
+  client;
+  id;
+  name;
+  icon;
+  banner;
+  ownerId;
+  /** Invite splash image hash. Null if none. */
+  splash;
+  /** Custom vanity URL code (e.g. fluxer.gg/code). Null if none. */
+  vanityURLCode;
+  /** Enabled guild features. */
+  features;
+  verificationLevel;
+  defaultMessageNotifications;
+  explicitContentFilter;
+  /** AFK voice channel ID. Null if none. */
+  afkChannelId;
+  /** AFK timeout in seconds. */
+  afkTimeout;
+  /** System messages channel ID. Null if none. */
+  systemChannelId;
+  /** Rules/guidelines channel ID. Null if none. */
+  rulesChannelId;
+  nsfwLevel;
+  mfaLevel;
+  /** Banner image width. Optional. */
+  bannerWidth;
+  /** Banner image height. Optional. */
+  bannerHeight;
+  /** Splash image width. Optional. */
+  splashWidth;
+  /** Splash image height. Optional. */
+  splashHeight;
+  members = new Collection();
+  channels = new Collection();
+  roles = new 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.name = data.name;
+    this.icon = data.icon ?? null;
+    this.banner = data.banner ?? null;
+    this.ownerId = data.owner_id ?? data.ownerId ?? "";
+    this.splash = data.splash ?? null;
+    this.vanityURLCode = data.vanity_url_code ?? null;
+    this.features = data.features ?? [];
+    this.verificationLevel = data.verification_level ?? 0;
+    this.defaultMessageNotifications = data.default_message_notifications ?? 0;
+    this.explicitContentFilter = data.explicit_content_filter ?? 0;
+    this.afkChannelId = data.afk_channel_id ?? null;
+    this.afkTimeout = data.afk_timeout ?? 0;
+    this.systemChannelId = data.system_channel_id ?? null;
+    this.rulesChannelId = data.rules_channel_id ?? null;
+    this.nsfwLevel = data.nsfw_level ?? 0;
+    this.mfaLevel = data.mfa_level ?? 0;
+    this.bannerWidth = data.banner_width ?? null;
+    this.bannerHeight = data.banner_height ?? null;
+    this.splashWidth = data.splash_width ?? null;
+    this.splashHeight = data.splash_height ?? null;
+    for (const r of data.roles ?? []) {
+      this.roles.set(r.id, new Role(client, r, this.id));
+    }
+  }
+  /** Get the guild icon URL, or null if no icon. */
+  iconURL(options) {
+    if (!this.icon) return null;
+    const size = options?.size ? `?size=${options.size}` : "";
+    return `${CDN_URL}/icons/${this.id}/${this.icon}.png${size}`;
+  }
+  /** Get the guild banner URL, or null if no banner. */
+  bannerURL(options) {
+    if (!this.banner) return null;
+    const size = options?.size ? `?size=${options.size}` : "";
+    return `${CDN_URL}/banners/${this.id}/${this.banner}.png${size}`;
+  }
+  /** Get the guild splash (invite background) URL, or null if no splash. */
+  splashURL(options) {
+    if (!this.splash) return null;
+    const size = options?.size ? `?size=${options.size}` : "";
+    return `${CDN_URL}/splashes/${this.id}/${this.splash}.png${size}`;
+  }
+  /**
+   * Add a role to a member by user ID. Does not require fetching the member first.
+   * @param userId - The user ID of the member
+   * @param roleId - The role ID to add (or use guild.resolveRoleId for mention/name resolution)
+   * Requires Manage Roles permission.
+   */
+  async addRoleToMember(userId, roleId) {
+    await this.client.rest.put(Routes.guildMemberRole(this.id, userId, roleId));
+  }
+  /**
+   * Remove a role from a member by user ID. Does not require fetching the member first.
+   * @param userId - The user ID of the member
+   * @param roleId - The role ID to remove
+   * Requires Manage Roles permission.
+   */
+  async removeRoleFromMember(userId, roleId) {
+    await this.client.rest.delete(Routes.guildMemberRole(this.id, userId, roleId));
+  }
+  /**
+   * Resolve a role ID from an argument (role mention, raw ID, or name).
+   * Fetches guild roles if name is provided.
+   * @param arg - Role mention (@role), role ID, or role name
+   * @returns The role ID, or null if not found
+   */
+  async resolveRoleId(arg) {
+    const parsed = parseRoleMention(arg);
+    if (parsed) return parsed;
+    if (/^\d{17,19}$/.test(arg.trim())) return arg.trim();
+    const cached = this.roles.find(
+      (r) => !!(r.name && r.name.toLowerCase() === arg.trim().toLowerCase())
+    );
+    if (cached) return cached.id;
+    const roles = await this.client.rest.get(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) {
+      this.roles.set(role.id, new Role(this.client, role, this.id));
+      return role.id;
+    }
+    return null;
+  }
+  /**
+   * Ban a user from this guild.
+   * @param userId - The user ID to ban
+   * @param options - Optional reason, delete_message_days (0–7), and ban_duration_seconds (temporary ban).
+   *   ban_duration_seconds: 0 = permanent, or use 3600, 43200, 86400, 259200, 432000, 604800, 1209600, 2592000.
+   * Requires Ban Members permission.
+   */
+  async ban(userId, options) {
+    const body = {};
+    if (options?.reason) body.reason = options.reason;
+    if (options?.delete_message_days != null)
+      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(Routes.guildBan(this.id, userId), {
+      body: Object.keys(body).length ? body : void 0,
+      auth: true
+    });
+  }
+  /**
+   * Fetch guild bans. Requires Ban Members permission.
+   * @returns List of GuildBan objects
+   */
+  async fetchBans() {
+    const { GuildBan } = await import("./GuildBan-7CXLTPKY.mjs");
+    const data = await this.client.rest.get(Routes.guildBans(this.id));
+    const list = Array.isArray(data) ? data : data?.bans ?? [];
+    return list.map((b) => new GuildBan(this.client, { ...b, guild_id: this.id }, this.id));
+  }
+  /**
+   * Remove a ban (unban a user).
+   * @param userId - The user ID to unban
+   * Requires Ban Members permission.
+   */
+  async unban(userId) {
+    await this.client.rest.delete(Routes.guildBan(this.id, userId), { auth: true });
+  }
+  /**
+   * Kick a member from this guild.
+   * @param userId - The user ID to kick
+   * Requires Kick Members permission.
+   */
+  async kick(userId) {
+    await this.client.rest.delete(Routes.guildMember(this.id, userId), { auth: true });
+  }
+  /**
+   * Fetch a guild member by user ID.
+   * @param userId - The user ID of the member to fetch
+   * @returns The guild member
+   * @throws FluxerError with MEMBER_NOT_FOUND if user is not in the guild (404)
+   * @throws FluxerError with cause for permission denied (403) or other REST errors
+   */
+  async fetchMember(userId) {
+    try {
+      const data = await this.client.rest.get(
+        Routes.guildMember(this.id, userId)
+      );
+      const member = new GuildMember(this.client, { ...data, guild_id: this.id }, this);
+      this.members.set(member.id, member);
+      return member;
+    } catch (err) {
+      const statusCode = err instanceof FluxerAPIError ? err.statusCode : err?.statusCode;
+      if (statusCode === 404) {
+        throw new FluxerError(`Member ${userId} not found in guild`, {
+          code: ErrorCodes.MemberNotFound,
+          cause: err
+        });
+      }
+      throw err instanceof FluxerError ? err : new FluxerError("Failed to fetch guild member", { cause: err });
+    }
+  }
+  /**
+   * Fetch guild audit logs. Requires View Audit Log permission.
+   * @param options - Optional limit, before, after, user_id, action_type for filtering
+   */
+  async fetchAuditLogs(options) {
+    const params = new URLSearchParams();
+    if (options?.limit != null) params.set("limit", String(options.limit));
+    if (options?.before) params.set("before", options.before);
+    if (options?.after) params.set("after", options.after);
+    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 = 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 } = await import("./Webhook-RWDDYW2Q.mjs");
+    const data = await this.client.rest.get(Routes.guildWebhooks(this.id));
+    const list = Array.isArray(data) ? data : Object.values(data ?? {});
+    return list.map((w) => new Webhook(this.client, w));
+  }
+  /**
+   * Create a channel in this guild.
+   * @param data - Channel data: type (0=text, 2=voice, 4=category, 5=link), name, and optional parent_id, topic, bitrate, user_limit, nsfw, permission_overwrites
+   * Requires Manage Channels permission.
+   */
+  async createChannel(data) {
+    const { Channel } = await import("./Channel-WJZZSNML.mjs");
+    const created = await this.client.rest.post(Routes.guildChannels(this.id), {
+      body: data,
+      auth: true
+    });
+    const channel = Channel.from(this.client, created);
+    if (channel) {
+      this.client.channels.set(channel.id, channel);
+      this.channels.set(channel.id, channel);
+    }
+    return channel;
+  }
+  /**
+   * Fetch all channels in this guild.
+   * @returns Array of GuildChannel objects (cached in guild.channels and client.channels)
+   */
+  async fetchChannels() {
+    const { Channel } = await import("./Channel-WJZZSNML.mjs");
+    const data = await this.client.rest.get(Routes.guildChannels(this.id));
+    const list = Array.isArray(data) ? data : Object.values(data ?? {});
+    const channels = [];
+    for (const ch of list) {
+      const channel = Channel.from(this.client, ch);
+      if (channel) {
+        this.client.channels.set(channel.id, channel);
+        this.channels.set(channel.id, channel);
+        channels.push(channel);
+      }
+    }
+    return channels;
+  }
+  /**
+   * Update channel positions.
+   * @param updates - Array of { id, position?, parent_id?, lock_permissions? }
+   * Requires Manage Channels permission.
+   */
+  async setChannelPositions(updates) {
+    await this.client.rest.patch(Routes.guildChannels(this.id), {
+      body: updates,
+      auth: true
+    });
+  }
+};
+
+export {
+  FluxerError,
+  ErrorCodes,
+  Guild
+};

package/dist/chunk-AH7KYH2Z.mjs

@@ -0,0 +1,50 @@
+// src/util/Events.ts
+var Events = {
+  Ready: "ready",
+  MessageCreate: "messageCreate",
+  MessageUpdate: "messageUpdate",
+  MessageDelete: "messageDelete",
+  MessageDeleteBulk: "messageDeleteBulk",
+  MessageReactionAdd: "messageReactionAdd",
+  MessageReactionRemove: "messageReactionRemove",
+  MessageReactionRemoveAll: "messageReactionRemoveAll",
+  MessageReactionRemoveEmoji: "messageReactionRemoveEmoji",
+  InteractionCreate: "interactionCreate",
+  GuildCreate: "guildCreate",
+  GuildUpdate: "guildUpdate",
+  GuildDelete: "guildDelete",
+  GuildBanAdd: "guildBanAdd",
+  GuildBanRemove: "guildBanRemove",
+  GuildEmojisUpdate: "guildEmojisUpdate",
+  GuildStickersUpdate: "guildStickersUpdate",
+  GuildIntegrationsUpdate: "guildIntegrationsUpdate",
+  GuildMemberAdd: "guildMemberAdd",
+  GuildMemberUpdate: "guildMemberUpdate",
+  GuildMemberRemove: "guildMemberRemove",
+  GuildRoleCreate: "guildRoleCreate",
+  GuildRoleUpdate: "guildRoleUpdate",
+  GuildRoleDelete: "guildRoleDelete",
+  GuildScheduledEventCreate: "guildScheduledEventCreate",
+  GuildScheduledEventUpdate: "guildScheduledEventUpdate",
+  GuildScheduledEventDelete: "guildScheduledEventDelete",
+  ChannelCreate: "channelCreate",
+  ChannelUpdate: "channelUpdate",
+  ChannelDelete: "channelDelete",
+  ChannelPinsUpdate: "channelPinsUpdate",
+  InviteCreate: "inviteCreate",
+  InviteDelete: "inviteDelete",
+  TypingStart: "typingStart",
+  UserUpdate: "userUpdate",
+  PresenceUpdate: "presenceUpdate",
+  VoiceStateUpdate: "voiceStateUpdate",
+  VoiceServerUpdate: "voiceServerUpdate",
+  VoiceStatesSync: "voiceStatesSync",
+  WebhooksUpdate: "webhooksUpdate",
+  Resumed: "resumed",
+  Error: "error",
+  Debug: "debug"
+};
+
+export {
+  Events
+};

package/dist/{chunk-HBF5QEDH.mjs → chunk-CEABHTAF.mjs}

@@ -31,6 +31,7 @@ var MessageReaction = class extends Base {
   /**
    * Fetch the message this reaction belongs to.
    * Use when you need to edit, delete, or otherwise interact with the message.
+   * @throws FluxerError with MESSAGE_NOT_FOUND if the message does not exist
    */
   async fetchMessage() {
     return this.client.channels.fetchMessage(this.channelId, this.messageId);

package/dist/chunk-CJVQNARM.mjs

@@ -0,0 +1,145 @@
+import {
+  buildSendBody
+} from "./chunk-PM2IUGNR.mjs";
+import {
+  cdnAvatarURL
+} from "./chunk-X6K3ZD62.mjs";
+import {
+  Base
+} from "./chunk-XNS4O6QJ.mjs";
+
+// src/structures/Webhook.ts
+import { Routes } from "@fluxerjs/types";
+var Webhook = class _Webhook extends Base {
+  client;
+  id;
+  guildId;
+  channelId;
+  name;
+  avatar;
+  /** Present only when webhook was created via createWebhook(); not returned when fetching. */
+  token;
+  /** User who created the webhook. */
+  user;
+  /** @param data - API webhook from POST /channels/{id}/webhooks (has token) or GET /webhooks/{id} (no token) */
+  constructor(client, data) {
+    super();
+    this.client = client;
+    this.id = data.id;
+    this.guildId = data.guild_id;
+    this.channelId = data.channel_id;
+    this.name = data.name ?? "Unknown";
+    this.avatar = data.avatar ?? null;
+    this.token = data.token ?? null;
+    this.user = client.getOrCreateUser(data.user);
+  }
+  /**
+   * Get the URL for this webhook's avatar.
+   * Returns null if the webhook has no custom avatar.
+   */
+  avatarURL(options) {
+    return cdnAvatarURL(this.id, this.avatar, options);
+  }
+  /** Delete this webhook. Requires bot token with Manage Webhooks permission. */
+  async delete() {
+    await this.client.rest.delete(Routes.webhook(this.id), { auth: true });
+  }
+  /**
+   * Edit this webhook. With token: name and avatar only. Without token (bot auth): name, avatar, and channel_id.
+   * @param options - Fields to update (name, avatar, channel_id when using bot auth)
+   * @returns This webhook instance with updated fields
+   */
+  async edit(options) {
+    const body = {};
+    if (options.name !== void 0) body.name = options.name;
+    if (options.avatar !== void 0) body.avatar = options.avatar;
+    if ("channel_id" in options && options.channel_id !== void 0 && !this.token) {
+      body.channel_id = options.channel_id;
+    }
+    if (this.token) {
+      const data2 = await this.client.rest.patch(Routes.webhookExecute(this.id, this.token), {
+        body,
+        auth: false
+      });
+      const w2 = data2;
+      this.name = w2.name ?? this.name;
+      this.avatar = w2.avatar ?? null;
+      return this;
+    }
+    const data = await this.client.rest.patch(Routes.webhook(this.id), {
+      body,
+      auth: true
+    });
+    const w = data;
+    this.name = w.name ?? this.name;
+    this.avatar = w.avatar ?? null;
+    this.channelId = w.channel_id ?? this.channelId;
+    return this;
+  }
+  /**
+   * Send a message via this webhook. Requires the webhook token (only present when created, not when fetched).
+   * @param options - Text content or object with content, embeds, username, avatar_url, tts, files, attachments
+   * @param wait - If true, waits for the API and returns the created Message; otherwise returns void (204)
+   * @throws Error if token is not available
+   * @example
+   * await webhook.send('Hello!');
+   * await webhook.send({ embeds: [embed.toJSON()] });
+   * await webhook.send({ content: 'File attached', files: [{ name: 'data.txt', data: buffer }] });
+   * const msg = await webhook.send({ content: 'Hi' }, true);
+   */
+  async send(options, wait) {
+    if (!this.token) {
+      throw new Error(
+        "Webhook token is required to send. The token is only returned when creating a webhook; fetched webhooks cannot send."
+      );
+    }
+    const opts = typeof options === "string" ? { content: options } : options;
+    const body = buildSendBody(options);
+    if (opts.username !== void 0) body.username = opts.username;
+    if (opts.avatar_url !== void 0) body.avatar_url = opts.avatar_url;
+    if (opts.tts !== void 0) body.tts = opts.tts;
+    const route = Routes.webhookExecute(this.id, this.token) + (wait ? "?wait=true" : "");
+    const postOptions = opts.files?.length ? { body, files: opts.files, auth: false } : { body, auth: false };
+    const data = await this.client.rest.post(
+      route,
+      postOptions
+    );
+    if (wait && data) {
+      const { Message } = await import("./Message-OFIVTTAZ.mjs");
+      return new Message(this.client, data);
+    }
+    return void 0;
+  }
+  /**
+   * Fetch a webhook by ID using bot auth.
+   * @param client - The client instance
+   * @param webhookId - The webhook ID
+   * @returns Webhook without token (cannot send)
+   */
+  static async fetch(client, webhookId) {
+    const data = await client.rest.get(Routes.webhook(webhookId));
+    return new _Webhook(client, data);
+  }
+  /**
+   * Create a Webhook instance from an ID and token (e.g. from a stored webhook URL).
+   * @param client - The client instance
+   * @param webhookId - The webhook ID
+   * @param token - The webhook token (from createWebhook or stored)
+   * @param options - Optional channelId, guildId, name for display
+   */
+  static fromToken(client, webhookId, token, options) {
+    return new _Webhook(client, {
+      id: webhookId,
+      guild_id: options?.guildId ?? "",
+      channel_id: options?.channelId ?? "",
+      name: options?.name ?? "Webhook",
+      avatar: null,
+      token,
+      user: { id: "", username: "webhook", discriminator: "0" }
+    });
+  }
+};
+
+export {
+  Webhook
+};

package/dist/chunk-DQ4TNBPG.mjs

@@ -0,0 +1,63 @@
+import {
+  Base
+} from "./chunk-XNS4O6QJ.mjs";
+
+// src/structures/Role.ts
+import { PermissionFlags } 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;
+  }
+  /** 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;
+  }
+};
+
+export {
+  Role
+};