@fluxerjs/core 1.0.9 → 1.1.0

package/dist/chunk-DUQAD7F6.mjs

@@ -0,0 +1,173 @@
+import {
+  cdnMemberAvatarURL,
+  cdnMemberBannerURL
+} from "./chunk-X6K3ZD62.mjs";
+import {
+  Base
+} from "./chunk-XNS4O6QJ.mjs";
+
+// src/structures/GuildMember.ts
+import { PermissionFlagsMap } from "@fluxerjs/util";
+import { Routes } from "@fluxerjs/types";
+
+// src/util/permissions.ts
+import { OverwriteType } from "@fluxerjs/types";
+import { ALL_PERMISSIONS_BIGINT } from "@fluxerjs/util";
+function computePermissions(basePermissions, overwrites, memberRoles, memberId, isOwner) {
+  if (isOwner) return ALL_PERMISSIONS_BIGINT;
+  let perms = basePermissions;
+  for (const overwrite of overwrites ?? []) {
+    const applies = overwrite.type === OverwriteType.Role && memberRoles.includes(overwrite.id) || overwrite.type === OverwriteType.Member && overwrite.id === memberId;
+    if (!applies) continue;
+    const allow = BigInt(overwrite.allow || "0");
+    const deny = BigInt(overwrite.deny || "0");
+    perms = perms & ~deny | allow;
+  }
+  return perms;
+}
+function hasPermission(bitfield, permission) {
+  const Administrator = 1n << 3n;
+  if ((bitfield & Administrator) !== 0n) return true;
+  return (bitfield & permission) === permission;
+}
+
+// src/structures/GuildMember.ts
+var GuildMember = class extends Base {
+  client;
+  id;
+  user;
+  guild;
+  nick;
+  roles;
+  joinedAt;
+  communicationDisabledUntil;
+  mute;
+  deaf;
+  avatar;
+  banner;
+  accentColor;
+  profileFlags;
+  /** @param data - API guild member from GET /guilds/{id}/members or GET /guilds/{id}/members/{user_id} */
+  constructor(client, data, guild) {
+    super();
+    this.client = client;
+    this.user = client.getOrCreateUser(data.user);
+    this.id = data.user.id;
+    this.guild = guild;
+    this.nick = data.nick ?? null;
+    this.roles = data.roles ?? [];
+    this.joinedAt = new Date(data.joined_at);
+    this.communicationDisabledUntil = data.communication_disabled_until ? new Date(data.communication_disabled_until) : null;
+    this.mute = data.mute ?? false;
+    this.deaf = data.deaf ?? false;
+    this.avatar = data.avatar ?? null;
+    this.banner = data.banner ?? null;
+    this.accentColor = data.accent_color ?? null;
+    this.profileFlags = data.profile_flags ?? null;
+  }
+  /** Nickname, or global name, or username. */
+  get displayName() {
+    return this.nick ?? this.user.globalName ?? this.user.username;
+  }
+  /**
+   * Get the guild-specific avatar URL for this member.
+   * Returns null if the member has no guild avatar (use displayAvatarURL for fallback).
+   */
+  avatarURL(options) {
+    return cdnMemberAvatarURL(this.guild.id, this.id, this.avatar, options);
+  }
+  /**
+   * Get the avatar URL to display for this member.
+   * Uses guild-specific avatar if set, otherwise falls back to the user's avatar.
+   */
+  displayAvatarURL(options) {
+    return this.avatarURL(options) ?? this.user.displayAvatarURL(options);
+  }
+  /**
+   * Get the guild-specific banner URL for this member.
+   * Returns null if the member has no guild banner.
+   */
+  bannerURL(options) {
+    return cdnMemberBannerURL(this.guild.id, this.id, this.banner, options);
+  }
+  /**
+   * Add a role to this member.
+   * @param roleId - The role ID to add
+   * Requires Manage Roles permission.
+   */
+  async addRole(roleId) {
+    await this.client.rest.put(Routes.guildMemberRole(this.guild.id, this.id, roleId));
+  }
+  /**
+   * Remove a role from this member.
+   * @param roleId - The role ID to remove
+   * Requires Manage Roles permission.
+   */
+  async removeRole(roleId) {
+    await this.client.rest.delete(Routes.guildMemberRole(this.guild.id, this.id, roleId));
+  }
+  /**
+   * Get the member's guild-level permissions (from roles only, no channel overwrites).
+   * Use this for server-wide permission checks (e.g. ban, kick, manage roles).
+   * @returns Object with has(permission) to check specific permissions
+   * @example
+   * const perms = member.permissions;
+   * if (perms.has(PermissionFlags.BanMembers)) { ... }
+   */
+  get permissions() {
+    const base = this._computeBasePermissions();
+    const ownerId = this.guild.ownerId;
+    const isOwner = ownerId != null && ownerId !== "" && String(ownerId) === String(this.id);
+    const perms = computePermissions(base, [], [], this.id, isOwner);
+    return {
+      has(permission) {
+        const perm = typeof permission === "number" ? permission : PermissionFlagsMap[String(permission)];
+        if (perm === void 0) return false;
+        return hasPermission(perms, BigInt(perm));
+      }
+    };
+  }
+  /**
+   * Compute the member's effective permissions in a guild channel.
+   * Applies role permissions and channel overwrites.
+   * @param channel - The guild channel to check permissions for
+   * @returns Object with has(permission) to check specific permissions
+   * @example
+   * const perms = member.permissionsIn(channel);
+   * if (perms.has(PermissionFlags.SendMessages)) { ... }
+   */
+  permissionsIn(channel) {
+    const base = this._computeBasePermissions();
+    const ownerId = this.guild.ownerId;
+    const isOwner = ownerId != null && ownerId !== "" && String(ownerId) === String(this.id);
+    const perms = computePermissions(
+      base,
+      channel.permissionOverwrites,
+      this.roles,
+      this.id,
+      isOwner
+    );
+    return {
+      has(permission) {
+        const perm = typeof permission === "number" ? permission : PermissionFlagsMap[String(permission)];
+        if (perm === void 0) return false;
+        return hasPermission(perms, BigInt(perm));
+      }
+    };
+  }
+  _computeBasePermissions() {
+    let base = 0n;
+    const everyone = this.guild.roles.get(this.guild.id);
+    if (everyone) base |= BigInt(everyone.permissions);
+    for (const roleId of this.roles) {
+      if (roleId === this.guild.id) continue;
+      const role = this.guild.roles.get(roleId);
+      if (role) base |= BigInt(role.permissions);
+    }
+    return base;
+  }
+};
+
+export {
+  GuildMember
+};

package/dist/{chunk-GCIJYVRC.mjs → chunk-JHNKZIHY.mjs}

@@ -15,6 +15,14 @@ var User = class extends Base {
   globalName;
   avatar;
   bot;
+  /** RGB avatar color (e.g. 7577782). Null if not set. */
+  avatarColor;
+  /** Public flags bitfield. Null if not set. */
+  flags;
+  /** Whether this is an official system user. */
+  system;
+  /** Banner hash (from profile, member, or invite context). Null when not available. */
+  banner;
   /** @param data - API user from message author, GET /users/{id}, or GET /users/@me */
   constructor(client, data) {
     super();
@@ -25,6 +33,10 @@ var User = class extends Base {
     this.globalName = data.global_name ?? null;
     this.avatar = data.avatar ?? null;
     this.bot = !!data.bot;
+    this.avatarColor = data.avatar_color ?? null;
+    this.flags = data.flags ?? data.public_flags ?? null;
+    this.system = !!data.system;
+    this.banner = data.banner ?? null;
   }
   /** Update mutable fields from fresh API data. Used by getOrCreateUser cache. */
   _patch(data) {
@@ -32,14 +44,18 @@ var User = class extends Base {
     this.discriminator = data.discriminator;
     this.globalName = data.global_name ?? null;
     this.avatar = data.avatar ?? null;
+    if (data.avatar_color !== void 0) this.avatarColor = data.avatar_color;
+    if (data.flags !== void 0) this.flags = data.flags;
+    if (data.banner !== void 0) this.banner = data.banner;
   }
   /**
    * Get the URL for this user's avatar.
-   * @param options - Optional `size` and `extension` (default: `png`)
+   * Auto-detects animated avatars (hash starting with `a_`) and uses gif extension.
+   * @param options - Optional `size` and `extension` (default: png, or gif for animated)
    */
   avatarURL(options) {
     if (!this.avatar) return null;
-    const ext = options?.extension ?? "png";
+    const ext = this.avatar.startsWith("a_") ? "gif" : options?.extension ?? "png";
     const size = options?.size ? `?size=${options.size}` : "";
     return `${CDN_URL}/avatars/${this.id}/${this.avatar}.${ext}${size}`;
   }
@@ -47,6 +63,16 @@ var User = class extends Base {
   displayAvatarURL(options) {
     return this.avatarURL(options) ?? `${CDN_URL}/avatars/0/0.png`;
   }
+  /**
+   * Get the URL for this user's banner.
+   * Returns null if the user has no banner (only available when fetched from profile/member context).
+   */
+  bannerURL(options) {
+    if (!this.banner) return null;
+    const ext = this.banner.startsWith("a_") ? "gif" : options?.extension ?? "png";
+    const size = options?.size ? `?size=${options.size}` : "";
+    return `${CDN_URL}/banners/${this.id}/${this.banner}.${ext}${size}`;
+  }
   /** Returns a mention string (e.g. `<@123456>`). */
   toString() {
     return `<@${this.id}>`;
@@ -56,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-ICWNKXBR.mjs");
+    const { DMChannel: DMChannelClass } = await import("./Channel-WJZZSNML.mjs");
     const data = await this.client.rest.post(Routes.userMeChannels(), {
       body: { recipient_id: this.id },
       auth: true
@@ -74,10 +100,35 @@ var User = class extends Base {
 };
 
 // src/client/ClientUser.ts
+import { Routes as Routes2 } from "@fluxerjs/types";
 var ClientUser = class extends User {
   constructor(client, data) {
     super(client, { ...data });
   }
+  /**
+   * Fetch guilds the bot is a member of.
+   * @returns Array of Guild objects (cached in client.guilds)
+   */
+  async fetchGuilds() {
+    const { Guild } = await import("./Guild-2P77HBQM.mjs");
+    const data = await this.client.rest.get(Routes2.currentUserGuilds());
+    const list = Array.isArray(data) ? data : data?.guilds ?? [];
+    const guilds = [];
+    for (const g of list) {
+      const guild = new Guild(this.client, g);
+      this.client.guilds.set(guild.id, guild);
+      guilds.push(guild);
+    }
+    return guilds;
+  }
+  /**
+   * Leave a guild. Requires the bot to be a member.
+   * @param guildId - The guild ID to leave
+   */
+  async leaveGuild(guildId) {
+    await this.client.rest.delete(Routes2.leaveGuild(guildId), { auth: true });
+    this.client.guilds.delete(guildId);
+  }
 };
 
 export {

package/dist/{chunk-FJS5FBXO.mjs → chunk-LU2SNC5G.mjs}

@@ -1,3 +1,9 @@
+import {
+  Events
+} from "./chunk-AH7KYH2Z.mjs";
+import {
+  buildSendBody
+} from "./chunk-PM2IUGNR.mjs";
 import {
   Base
 } from "./chunk-XNS4O6QJ.mjs";
@@ -11,15 +17,69 @@ var MessageManager = class {
   /**
    * Fetch a message by ID from this channel.
    * @param messageId - Snowflake of the message
-   * @returns The message, or null if not found
+   * @returns The message
+   * @throws FluxerError with MESSAGE_NOT_FOUND if the message does not exist
    */
   async fetch(messageId) {
     return this.client.channels.fetchMessage(this.channelId, messageId);
   }
 };
 
+// src/util/MessageCollector.ts
+import { EventEmitter } from "events";
+import { Collection } from "@fluxerjs/collection";
+var MessageCollector = class extends EventEmitter {
+  client;
+  channelId;
+  options;
+  collected = new Collection();
+  _timeout = null;
+  _ended = false;
+  _listener;
+  constructor(client, channelId, options = {}) {
+    super();
+    this.client = client;
+    this.channelId = channelId;
+    this.options = {
+      filter: options.filter ?? (() => true),
+      time: options.time ?? 0,
+      max: options.max ?? 0
+    };
+    this._listener = (message) => {
+      if (this._ended || message.channelId !== this.channelId) return;
+      if (!this.options.filter(message)) return;
+      this.collected.set(message.id, message);
+      this.emit("collect", message);
+      if (this.options.max > 0 && this.collected.size >= this.options.max) {
+        this.stop("limit");
+      }
+    };
+    this.client.on(Events.MessageCreate, this._listener);
+    if (this.options.time > 0) {
+      this._timeout = setTimeout(() => this.stop("time"), this.options.time);
+    }
+  }
+  stop(reason = "user") {
+    if (this._ended) return;
+    this._ended = true;
+    this.client.off(Events.MessageCreate, this._listener);
+    if (this._timeout) {
+      clearTimeout(this._timeout);
+      this._timeout = null;
+    }
+    this.emit("end", this.collected, reason);
+  }
+  on(event, listener) {
+    return super.on(event, listener);
+  }
+  emit(event, ...args) {
+    return super.emit(event, ...args);
+  }
+};
+
 // src/structures/Channel.ts
 import { ChannelType, Routes } from "@fluxerjs/types";
+import { emitDeprecationWarning } from "@fluxerjs/util";
 var Channel = class _Channel extends Base {
   /** Whether this channel has a send method (TextChannel, DMChannel). */
   isSendable() {
@@ -40,12 +100,21 @@ var Channel = class _Channel extends Base {
   client;
   id;
   type;
+  /** Channel name. Guild channels and Group DMs have names; 1:1 DMs are typically null. */
+  name;
+  /** Channel icon hash (Group DMs). Null if none. */
+  icon;
+  /** ISO timestamp when the last message was pinned. Null if never pinned. */
+  lastPinTimestamp;
   /** @param data - API channel from GET /channels/{id} or GET /guilds/{id}/channels */
   constructor(client, data) {
     super();
     this.client = client;
     this.id = data.id;
     this.type = data.type;
+    this.name = data.name ?? null;
+    this.icon = data.icon ?? null;
+    this.lastPinTimestamp = data.last_pin_timestamp ?? null;
   }
   /**
    * Create the appropriate channel subclass from API data.
@@ -71,18 +140,37 @@ var Channel = class _Channel extends Base {
       return _Channel.createDM(client, data);
     return _Channel.from(client, data);
   }
+  /**
+   * Bulk delete messages. Requires Manage Messages permission.
+   * @param messageIds - Array of message IDs to delete (2–100)
+   */
+  async bulkDeleteMessages(messageIds) {
+    await this.client.rest.post(Routes.channelBulkDelete(this.id), {
+      body: { message_ids: messageIds },
+      auth: true
+    });
+  }
+  /**
+   * Send a typing indicator to the channel. Lasts ~10 seconds.
+   */
+  async sendTyping() {
+    await this.client.rest.post(Routes.channelTyping(this.id), { auth: true });
+  }
 };
 var GuildChannel = class extends Channel {
   guildId;
   name;
   position;
   parentId;
+  /** Permission overwrites for roles and members. */
+  permissionOverwrites;
   constructor(client, data) {
     super(client, data);
     this.guildId = data.guild_id ?? "";
     this.name = data.name ?? null;
     this.position = data.position;
     this.parentId = data.parent_id ?? null;
+    this.permissionOverwrites = data.permission_overwrites ?? [];
   }
   /**
    * Create a webhook in this channel.
@@ -90,7 +178,7 @@ var GuildChannel = class extends Channel {
    * @returns The webhook with token (required for send()). Requires Manage Webhooks permission.
    */
   async createWebhook(options) {
-    const { Webhook } = await import("./Webhook-32VJD4AL.mjs");
+    const { Webhook } = await import("./Webhook-RWDDYW2Q.mjs");
     const data = await this.client.rest.post(Routes.channelWebhooks(this.id), {
       body: options,
       auth: true
@@ -102,11 +190,39 @@ var GuildChannel = class extends Channel {
    * @returns Webhooks (includes token when listing from channel; can send via send())
    */
   async fetchWebhooks() {
-    const { Webhook } = await import("./Webhook-32VJD4AL.mjs");
+    const { Webhook } = await import("./Webhook-RWDDYW2Q.mjs");
     const data = await this.client.rest.get(Routes.channelWebhooks(this.id));
     const list = Array.isArray(data) ? data : Object.values(data ?? {});
     return list.map((w) => new Webhook(this.client, w));
   }
+  /**
+   * Create an invite for this channel.
+   * @param options - max_uses (0–100), max_age (0–604800 seconds), unique, temporary
+   * Requires Create Instant Invite permission.
+   */
+  async createInvite(options) {
+    const { Invite } = await import("./Invite-UM5BU5A6.mjs");
+    const body = {};
+    if (options?.max_uses != null) body.max_uses = options.max_uses;
+    if (options?.max_age != null) body.max_age = options.max_age;
+    if (options?.unique != null) body.unique = options.unique;
+    if (options?.temporary != null) body.temporary = options.temporary;
+    const data = await this.client.rest.post(Routes.channelInvites(this.id), {
+      body: Object.keys(body).length ? body : void 0,
+      auth: true
+    });
+    return new Invite(this.client, data);
+  }
+  /**
+   * Fetch invites for this channel.
+   * Requires Manage Channel permission.
+   */
+  async fetchInvites() {
+    const { Invite } = await import("./Invite-UM5BU5A6.mjs");
+    const data = await this.client.rest.get(Routes.channelInvites(this.id));
+    const list = Array.isArray(data) ? data : Object.values(data ?? {});
+    return list.map((i) => new Invite(this.client, i));
+  }
 };
 var TextChannel = class extends GuildChannel {
   topic;
@@ -122,24 +238,38 @@ var TextChannel = class extends GuildChannel {
   }
   /**
    * Send a message to this channel.
-   * @param options - Text content or object with `content` and/or `embeds`
+   * @param options - Text content or object with content, embeds, and/or files
    */
   async send(options) {
-    const body = typeof options === "string" ? { content: options } : options;
-    const { Message } = await import("./Message-6IYEYSV6.mjs");
-    const data = await this.client.rest.post(Routes.channelMessages(this.id), { body });
+    const opts = typeof options === "string" ? { content: options } : options;
+    const body = buildSendBody(options);
+    const { Message } = await import("./Message-OFIVTTAZ.mjs");
+    const postOptions = opts.files?.length ? { body, files: opts.files } : { body };
+    const data = await this.client.rest.post(Routes.channelMessages(this.id), postOptions);
     return new Message(this.client, data);
   }
   /** Message manager for this channel. Use channel.messages.fetch(messageId). */
   get messages() {
     return new MessageManager(this.client, this.id);
   }
+  /**
+   * Create a message collector for this channel.
+   * Collects messages matching the filter until time expires or max is reached.
+   * @param options - Filter, time (ms), and max count
+   * @example
+   * const collector = channel.createMessageCollector({ filter: m => m.author.id === userId, time: 10000 });
+   * collector.on('collect', m => console.log(m.content));
+   * collector.on('end', (collected, reason) => { ... });
+   */
+  createMessageCollector(options) {
+    return new MessageCollector(this.client, this.id, options);
+  }
   /**
    * Fetch pinned messages in this channel.
    * @returns Pinned messages
    */
   async fetchPinnedMessages() {
-    const { Message } = await import("./Message-6IYEYSV6.mjs");
+    const { Message } = await import("./Message-OFIVTTAZ.mjs");
     const data = await this.client.rest.get(Routes.channelPins(this.id));
     const list = Array.isArray(data) ? data : data?.items ?? [];
     return list.map((item) => {
@@ -154,6 +284,10 @@ var TextChannel = class extends GuildChannel {
    * @deprecated Use channel.messages.fetch(messageId) instead.
    */
   async fetchMessage(messageId) {
+    emitDeprecationWarning(
+      "Channel.fetchMessage()",
+      "Use channel.messages.fetch(messageId) instead."
+    );
     return this.client.channels.fetchMessage(this.id, messageId);
   }
 };
@@ -179,30 +313,50 @@ var LinkChannel = class extends GuildChannel {
 };
 var DMChannel = class extends Channel {
   lastMessageId;
+  /** Group DM creator ID. Null for 1:1 DMs. */
+  ownerId;
+  /** Group DM recipients as User objects. Empty for 1:1 DMs. */
+  recipients;
+  /** Group DM member display names (userId -> nickname). */
+  nicks;
   constructor(client, data) {
     super(client, data);
     this.lastMessageId = data.last_message_id ?? null;
+    this.ownerId = data.owner_id ?? null;
+    this.recipients = (data.recipients ?? []).map(
+      (u) => client.getOrCreateUser(u)
+    );
+    this.nicks = data.nicks ?? {};
   }
   /**
    * Send a message to this DM channel.
-   * @param options - Text content or object with `content` and/or `embeds`
+   * @param options - Text content or object with content, embeds, and/or files
    */
   async send(options) {
-    const body = typeof options === "string" ? { content: options } : options;
-    const { Message } = await import("./Message-6IYEYSV6.mjs");
-    const data = await this.client.rest.post(Routes.channelMessages(this.id), { body });
+    const opts = typeof options === "string" ? { content: options } : options;
+    const body = buildSendBody(options);
+    const { Message } = await import("./Message-OFIVTTAZ.mjs");
+    const postOptions = opts.files?.length ? { body, files: opts.files } : { body };
+    const data = await this.client.rest.post(Routes.channelMessages(this.id), postOptions);
     return new Message(this.client, data);
   }
   /** Message manager for this channel. Use channel.messages.fetch(messageId). */
   get messages() {
     return new MessageManager(this.client, this.id);
   }
+  /**
+   * Create a message collector for this DM channel.
+   * @param options - Filter, time (ms), and max count
+   */
+  createMessageCollector(options) {
+    return new MessageCollector(this.client, this.id, options);
+  }
   /**
    * Fetch pinned messages in this DM channel.
    * @returns Pinned messages
    */
   async fetchPinnedMessages() {
-    const { Message } = await import("./Message-6IYEYSV6.mjs");
+    const { Message } = await import("./Message-OFIVTTAZ.mjs");
     const data = await this.client.rest.get(Routes.channelPins(this.id));
     const list = Array.isArray(data) ? data : data?.items ?? [];
     return list.map((item) => {
@@ -217,12 +371,17 @@ var DMChannel = class extends Channel {
    * @deprecated Use channel.messages.fetch(messageId) instead.
    */
   async fetchMessage(messageId) {
+    emitDeprecationWarning(
+      "Channel.fetchMessage()",
+      "Use channel.messages.fetch(messageId) instead."
+    );
     return this.client.channels.fetchMessage(this.id, messageId);
   }
 };
 
 export {
   MessageManager,
+  MessageCollector,
   Channel,
   GuildChannel,
   TextChannel,

package/dist/chunk-PM2IUGNR.mjs

@@ -0,0 +1,29 @@
+// src/util/messageUtils.ts
+import { EmbedBuilder } from "@fluxerjs/builders";
+function buildSendBody(options) {
+  const body = typeof options === "string" ? { content: options } : options;
+  const result = {};
+  if (body.content !== void 0) result.content = body.content;
+  if (body.embeds?.length) {
+    result.embeds = body.embeds.map((e) => e instanceof EmbedBuilder ? e.toJSON() : e);
+  }
+  if (body.files?.length && body.attachments) {
+    result.attachments = body.attachments.map((a) => ({
+      id: a.id,
+      filename: a.filename,
+      ...a.title != null && { title: a.title },
+      ...a.description != null && { description: a.description },
+      ...a.flags != null && { flags: a.flags }
+    }));
+  } else if (body.files?.length) {
+    result.attachments = body.files.map((f, i) => ({
+      id: i,
+      filename: f.filename ?? f.name
+    }));
+  }
+  return result;
+}
+
+export {
+  buildSendBody
+};

package/dist/{chunk-RCP27MRC.mjs → chunk-UXIF75BV.mjs}

@@ -9,6 +9,8 @@ var GuildBan = class extends Base {
   guildId;
   user;
   reason;
+  /** ISO timestamp when a temporary ban expires. Null for permanent bans. */
+  expiresAt;
   /** @param data - API ban from GET /guilds/{id}/bans or gateway GUILD_BAN_ADD */
   constructor(client, data, guildId) {
     super();
@@ -16,6 +18,7 @@ var GuildBan = class extends Base {
     this.guildId = data.guild_id ?? guildId;
     this.user = client.getOrCreateUser(data.user);
     this.reason = data.reason ?? null;
+    this.expiresAt = data.expires_at ?? null;
   }
   /**
    * Remove this ban (unban the user).