@fluxerjs/core 1.0.5 → 1.0.7

package/dist/index.js

@@ -39,113 +39,17 @@ var init_Constants = __esm({
   }
 });
 
-// src/structures/User.ts
-var User;
-var init_User = __esm({
-  "src/structures/User.ts"() {
-    "use strict";
-    init_Base();
-    init_Constants();
-    User = class extends Base {
-      client;
-      id;
-      username;
-      discriminator;
-      globalName;
-      avatar;
-      bot;
-      constructor(client, data) {
-        super();
-        this.client = client;
-        this.id = data.id;
-        this.username = data.username;
-        this.discriminator = data.discriminator;
-        this.globalName = data.global_name ?? null;
-        this.avatar = data.avatar ?? null;
-        this.bot = !!data.bot;
-      }
-      avatarURL(options) {
-        if (!this.avatar) return null;
-        const ext = options?.extension ?? "png";
-        const size = options?.size ? `?size=${options.size}` : "";
-        return `${CDN_URL}/avatars/${this.id}/${this.avatar}.${ext}${size}`;
-      }
-      displayAvatarURL(options) {
-        return this.avatarURL(options) ?? `${CDN_URL}/avatars/0/0.png`;
-      }
-      toString() {
-        return `<@${this.id}>`;
-      }
-    };
-  }
-});
-
-// src/structures/Message.ts
-var Message_exports = {};
-__export(Message_exports, {
-  Message: () => Message
-});
-var import_collection, import_types, Message;
-var init_Message = __esm({
-  "src/structures/Message.ts"() {
-    "use strict";
-    init_Base();
-    import_collection = require("@fluxerjs/collection");
-    import_types = require("@fluxerjs/types");
-    init_User();
-    Message = class _Message extends Base {
-      client;
-      id;
-      channelId;
-      guildId;
-      author;
-      content;
-      createdAt;
-      editedAt;
-      pinned;
-      attachments;
-      channel;
-      constructor(client, data) {
-        super();
-        this.client = client;
-        this.id = data.id;
-        this.channelId = data.channel_id;
-        this.guildId = data.guild_id ?? null;
-        this.author = new User(client, data.author);
-        this.content = data.content;
-        this.createdAt = new Date(data.timestamp);
-        this.editedAt = data.edited_timestamp ? new Date(data.edited_timestamp) : null;
-        this.pinned = data.pinned;
-        this.attachments = new import_collection.Collection();
-        for (const a of data.attachments ?? []) this.attachments.set(a.id, a);
-      }
-      async reply(options) {
-        const body = typeof options === "string" ? { content: options, message_reference: { channel_id: this.channelId, message_id: this.id, guild_id: this.guildId ?? void 0 } } : { ...options, message_reference: { channel_id: this.channelId, message_id: this.id, guild_id: this.guildId ?? void 0 } };
-        const data = await this.client.rest.post(import_types.Routes.channelMessages(this.channelId), { body });
-        return new _Message(this.client, data);
-      }
-      async edit(options) {
-        const data = await this.client.rest.patch(import_types.Routes.channelMessage(this.channelId, this.id), { body: options });
-        return new _Message(this.client, data);
-      }
-      async delete() {
-        await this.client.rest.delete(import_types.Routes.channelMessage(this.channelId, this.id));
-      }
-    };
-  }
-});
-
 // src/structures/Webhook.ts
 var Webhook_exports = {};
 __export(Webhook_exports, {
   Webhook: () => Webhook
 });
-var import_types2, Webhook;
+var import_types, Webhook;
 var init_Webhook = __esm({
   "src/structures/Webhook.ts"() {
     "use strict";
     init_Base();
-    import_types2 = require("@fluxerjs/types");
+    import_types = require("@fluxerjs/types");
     Webhook = class _Webhook extends Base {
       client;
       id;
@@ -155,6 +59,7 @@ var init_Webhook = __esm({
       avatar;
       /** Present only when webhook was created via createWebhook(); not returned when fetching. */
       token;
+      /** @param data - API webhook from POST /channels/{id}/webhooks (has token) or GET /webhooks/{id} (no token) */
       constructor(client, data) {
         super();
         this.client = client;
@@ -167,7 +72,7 @@ var init_Webhook = __esm({
       }
       /** Delete this webhook. Requires bot token with Manage Webhooks permission. */
       async delete() {
-        await this.client.rest.delete(import_types2.Routes.webhook(this.id), { auth: true });
+        await this.client.rest.delete(import_types.Routes.webhook(this.id), { auth: true });
       }
       /**
        * Send a message via this webhook. Requires the webhook token (only present when created, not when fetched).
@@ -178,21 +83,27 @@ var init_Webhook = __esm({
           throw new Error("Webhook token is required to send. The token is only returned when creating a webhook; fetched webhooks cannot send.");
         }
         const body = typeof options === "string" ? { content: options } : options;
-        await this.client.rest.post(import_types2.Routes.webhookExecute(this.id, this.token), {
+        await this.client.rest.post(import_types.Routes.webhookExecute(this.id, this.token), {
           body,
           auth: false
         });
       }
       /**
-       * Fetch a webhook by ID using bot auth. The returned webhook will not have a token (cannot send).
+       * 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(import_types2.Routes.webhook(webhookId));
+        const data = await client.rest.get(import_types.Routes.webhook(webhookId));
         return new _Webhook(client, data);
       }
       /**
        * Create a Webhook instance from an ID and token (e.g. from a stored webhook URL).
-       * Useful when you have the token from a previous createWebhook() call.
+       * @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, {
@@ -209,90 +120,49 @@ var init_Webhook = __esm({
   }
 });
 
-// src/structures/Guild.ts
-var Guild_exports = {};
-__export(Guild_exports, {
-  Guild: () => Guild
-});
-var import_collection2, import_types3, Guild;
-var init_Guild = __esm({
-  "src/structures/Guild.ts"() {
-    "use strict";
-    init_Base();
-    import_collection2 = require("@fluxerjs/collection");
-    init_Constants();
-    import_types3 = require("@fluxerjs/types");
-    Guild = class extends Base {
-      client;
-      id;
-      name;
-      icon;
-      banner;
-      ownerId;
-      members = new import_collection2.Collection();
-      channels = new import_collection2.Collection();
-      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;
-      }
-      iconURL(options) {
-        if (!this.icon) return null;
-        const size = options?.size ? `?size=${options.size}` : "";
-        return `${CDN_URL}/icons/${this.id}/${this.icon}.png${size}`;
-      }
-      bannerURL(options) {
-        if (!this.banner) return null;
-        const size = options?.size ? `?size=${options.size}` : "";
-        return `${CDN_URL}/banners/${this.id}/${this.banner}.png${size}`;
-      }
-      /** 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_types3.Routes.guildWebhooks(this.id));
-        const list = Array.isArray(data) ? data : Object.values(data ?? {});
-        return list.map((w) => new Webhook2(this.client, w));
-      }
-    };
-  }
-});
-
 // src/structures/Channel.ts
 var Channel_exports = {};
 __export(Channel_exports, {
   CategoryChannel: () => CategoryChannel,
   Channel: () => Channel,
+  DMChannel: () => DMChannel,
   GuildChannel: () => GuildChannel,
   LinkChannel: () => LinkChannel,
   TextChannel: () => TextChannel,
   VoiceChannel: () => VoiceChannel
 });
-var import_types4, Channel, GuildChannel, TextChannel, CategoryChannel, VoiceChannel, LinkChannel;
+var import_types2, Channel, GuildChannel, TextChannel, CategoryChannel, VoiceChannel, LinkChannel, DMChannel;
 var init_Channel = __esm({
   "src/structures/Channel.ts"() {
     "use strict";
     init_Base();
-    import_types4 = require("@fluxerjs/types");
+    import_types2 = require("@fluxerjs/types");
     Channel = class extends Base {
+      /** Create a DM channel from API data (type DM or GroupDM). */
+      static createDM(client, data) {
+        return new DMChannel(client, data);
+      }
       client;
       id;
       type;
+      /** @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;
       }
+      /**
+       * Create the appropriate channel subclass from API data.
+       * @param client - The client instance
+       * @param data - Channel data from the API
+       */
       static from(client, data) {
         const type = data.type ?? 0;
-        if (type === import_types4.ChannelType.GuildText) return new TextChannel(client, data);
-        if (type === import_types4.ChannelType.GuildCategory) return new CategoryChannel(client, data);
-        if (type === import_types4.ChannelType.GuildVoice) return new VoiceChannel(client, data);
-        if (type === import_types4.ChannelType.GuildLink) return new LinkChannel(client, data);
+        if (type === import_types2.ChannelType.GuildText) return new TextChannel(client, data);
+        if (type === import_types2.ChannelType.GuildCategory) return new CategoryChannel(client, data);
+        if (type === import_types2.ChannelType.GuildVoice) return new VoiceChannel(client, data);
+        if (type === import_types2.ChannelType.GuildLink || type === import_types2.ChannelType.GuildLinkExtended) return new LinkChannel(client, data);
         return new GuildChannel(client, data);
       }
     };
@@ -308,19 +178,26 @@ var init_Channel = __esm({
         this.position = data.position;
         this.parentId = data.parent_id ?? null;
       }
-      /** Create a webhook in this channel. Returns the webhook with token (required for send()). */
+      /**
+       * Create a webhook in this channel.
+       * @param options - Webhook name and optional avatar URL
+       * @returns The webhook with token (required for send()). Requires Manage Webhooks permission.
+       */
       async createWebhook(options) {
         const { Webhook: Webhook2 } = await Promise.resolve().then(() => (init_Webhook(), Webhook_exports));
-        const data = await this.client.rest.post(import_types4.Routes.channelWebhooks(this.id), {
+        const data = await this.client.rest.post(import_types2.Routes.channelWebhooks(this.id), {
           body: options,
           auth: true
         });
         return new Webhook2(this.client, data);
       }
-      /** Fetch all webhooks in this channel. Returned webhooks do not include the token (cannot send). */
+      /**
+       * Fetch all webhooks in this channel.
+       * @returns Webhooks (includes token when listing from channel; can send via send())
+       */
       async fetchWebhooks() {
         const { Webhook: Webhook2 } = await Promise.resolve().then(() => (init_Webhook(), Webhook_exports));
-        const data = await this.client.rest.get(import_types4.Routes.channelWebhooks(this.id));
+        const data = await this.client.rest.get(import_types2.Routes.channelWebhooks(this.id));
         const list = Array.isArray(data) ? data : Object.values(data ?? {});
         return list.map((w) => new Webhook2(this.client, w));
       }
@@ -337,10 +214,14 @@ var init_Channel = __esm({
         this.rateLimitPerUser = data.rate_limit_per_user ?? 0;
         this.lastMessageId = data.last_message_id ?? null;
       }
+      /**
+       * Send a message to this channel.
+       * @param options - Text content or object with `content` and/or `embeds`
+       */
       async send(options) {
         const body = typeof options === "string" ? { content: options } : options;
         const { Message: Message2 } = await Promise.resolve().then(() => (init_Message(), Message_exports));
-        const data = await this.client.rest.post(import_types4.Routes.channelMessages(this.id), { body });
+        const data = await this.client.rest.post(import_types2.Routes.channelMessages(this.id), { body });
         return new Message2(this.client, data);
       }
     };
@@ -364,6 +245,205 @@ var init_Channel = __esm({
         this.url = data.url ?? null;
       }
     };
+    DMChannel = class extends Channel {
+      lastMessageId;
+      constructor(client, data) {
+        super(client, data);
+        this.lastMessageId = data.last_message_id ?? null;
+      }
+      /**
+       * Send a message to this DM channel.
+       * @param options - Text content or object with `content` and/or `embeds`
+       */
+      async send(options) {
+        const body = typeof options === "string" ? { content: options } : options;
+        const { Message: Message2 } = await Promise.resolve().then(() => (init_Message(), Message_exports));
+        const data = await this.client.rest.post(import_types2.Routes.channelMessages(this.id), { body });
+        return new Message2(this.client, data);
+      }
+    };
+  }
+});
+
+// src/structures/User.ts
+var import_types3, User;
+var init_User = __esm({
+  "src/structures/User.ts"() {
+    "use strict";
+    init_Base();
+    import_types3 = require("@fluxerjs/types");
+    init_Constants();
+    User = class extends Base {
+      client;
+      id;
+      username;
+      discriminator;
+      globalName;
+      avatar;
+      bot;
+      /** @param data - API user from message author, GET /users/{id}, or GET /users/@me */
+      constructor(client, data) {
+        super();
+        this.client = client;
+        this.id = data.id;
+        this.username = data.username;
+        this.discriminator = data.discriminator;
+        this.globalName = data.global_name ?? null;
+        this.avatar = data.avatar ?? null;
+        this.bot = !!data.bot;
+      }
+      /**
+       * Get the URL for this user's avatar.
+       * @param options - Optional `size` and `extension` (default: `png`)
+       */
+      avatarURL(options) {
+        if (!this.avatar) return null;
+        const ext = options?.extension ?? "png";
+        const size = options?.size ? `?size=${options.size}` : "";
+        return `${CDN_URL}/avatars/${this.id}/${this.avatar}.${ext}${size}`;
+      }
+      /** Get the avatar URL, or the default avatar if none set. */
+      displayAvatarURL(options) {
+        return this.avatarURL(options) ?? `${CDN_URL}/avatars/0/0.png`;
+      }
+      /** Returns a mention string (e.g. `<@123456>`). */
+      toString() {
+        return `<@${this.id}>`;
+      }
+      /**
+       * Create or get a DM channel with this user.
+       * Returns the DM channel; use {@link DMChannel.send} to send messages.
+       */
+      async createDM() {
+        const { DMChannel: DMChannelClass } = await Promise.resolve().then(() => (init_Channel(), Channel_exports));
+        const data = await this.client.rest.post(import_types3.Routes.userMeChannels(), {
+          body: { recipient_id: this.id },
+          auth: true
+        });
+        return new DMChannelClass(this.client, data);
+      }
+      /**
+       * Send a DM to this user.
+       * Convenience method that creates the DM channel and sends the message.
+       */
+      async send(options) {
+        const dm = await this.createDM();
+        return dm.send(options);
+      }
+    };
+  }
+});
+
+// src/structures/Message.ts
+var Message_exports = {};
+__export(Message_exports, {
+  Message: () => Message
+});
+var import_collection, import_types4, import_builders, Message;
+var init_Message = __esm({
+  "src/structures/Message.ts"() {
+    "use strict";
+    init_Base();
+    import_collection = require("@fluxerjs/collection");
+    import_types4 = require("@fluxerjs/types");
+    import_builders = require("@fluxerjs/builders");
+    init_User();
+    Message = class _Message extends Base {
+      client;
+      id;
+      channelId;
+      guildId;
+      author;
+      content;
+      createdAt;
+      editedAt;
+      pinned;
+      attachments;
+      channel;
+      /** @param data - API message from POST/PATCH /channels/{id}/messages or gateway MESSAGE_CREATE */
+      constructor(client, data) {
+        super();
+        this.client = client;
+        this.id = data.id;
+        this.channelId = data.channel_id;
+        this.guildId = data.guild_id ?? null;
+        this.author = new User(client, data.author);
+        this.content = data.content;
+        this.createdAt = new Date(data.timestamp);
+        this.editedAt = data.edited_timestamp ? new Date(data.edited_timestamp) : null;
+        this.pinned = data.pinned;
+        this.attachments = new import_collection.Collection();
+        for (const a of data.attachments ?? []) this.attachments.set(a.id, a);
+      }
+      /**
+       * Reply to this message.
+       * @param options - Text content or object with content and/or embeds
+       */
+      async reply(options) {
+        const body = typeof options === "string" ? { content: options, message_reference: { channel_id: this.channelId, message_id: this.id, guild_id: this.guildId ?? void 0 } } : { ...options, message_reference: { channel_id: this.channelId, message_id: this.id, guild_id: this.guildId ?? void 0 } };
+        const data = await this.client.rest.post(import_types4.Routes.channelMessages(this.channelId), { body });
+        return new _Message(this.client, data);
+      }
+      /**
+       * Edit this message. Only the author (or admins) can edit.
+       * @param options - New content and/or embeds
+       */
+      async edit(options) {
+        const body = {};
+        if (options.content !== void 0) body.content = options.content;
+        if (options.embeds?.length) {
+          body.embeds = options.embeds.map((e) => e instanceof import_builders.EmbedBuilder ? e.toJSON() : e);
+        }
+        const data = await this.client.rest.patch(import_types4.Routes.channelMessage(this.channelId, this.id), { body });
+        return new _Message(this.client, data);
+      }
+      /** Delete this message. */
+      async delete() {
+        await this.client.rest.delete(import_types4.Routes.channelMessage(this.channelId, this.id));
+      }
+      /**
+       * Format emoji for reaction API: unicode string or "name:id" for custom.
+       * @param emoji - Unicode emoji (e.g. "👍") or custom { name, id } or "name:id" string
+       */
+      static formatEmoji(emoji) {
+        if (typeof emoji === "string") return emoji;
+        return `${emoji.name}:${emoji.id}`;
+      }
+      /**
+       * Add a reaction to this message (as the bot).
+       * @param emoji - Unicode emoji (e.g. `👍`) or custom emoji `{ name, id }`
+       */
+      async react(emoji) {
+        const emojiStr = _Message.formatEmoji(emoji);
+        const route = `${import_types4.Routes.channelMessageReaction(this.channelId, this.id, emojiStr)}/@me`;
+        await this.client.rest.put(route);
+      }
+      /**
+       * Remove the bot's reaction, or a specific user's reaction if userId is provided.
+       * @param emoji - Unicode emoji or custom `{ name, id }`
+       * @param userId - If provided, removes that user's reaction (requires moderator permissions)
+       */
+      async removeReaction(emoji, userId) {
+        const emojiStr = _Message.formatEmoji(emoji);
+        const route = `${import_types4.Routes.channelMessageReaction(this.channelId, this.id, emojiStr)}/${userId ?? "@me"}`;
+        await this.client.rest.delete(route);
+      }
+      /**
+       * Remove all reactions from this message.
+       * Requires moderator permissions.
+       */
+      async removeAllReactions() {
+        await this.client.rest.delete(import_types4.Routes.channelMessageReactions(this.channelId, this.id));
+      }
+      /**
+       * Remove all reactions of a specific emoji from this message.
+       * @param emoji - Unicode emoji or custom `{ name, id }`. Requires moderator permissions.
+       */
+      async removeReactionEmoji(emoji) {
+        const emojiStr = _Message.formatEmoji(emoji);
+        await this.client.rest.delete(import_types4.Routes.channelMessageReaction(this.channelId, this.id, emojiStr));
+      }
+    };
   }
 });
 
@@ -372,12 +452,13 @@ var GuildMember_exports = {};
 __export(GuildMember_exports, {
   GuildMember: () => GuildMember
 });
-var GuildMember;
+var import_types5, GuildMember;
 var init_GuildMember = __esm({
   "src/structures/GuildMember.ts"() {
     "use strict";
     init_Base();
     init_User();
+    import_types5 = require("@fluxerjs/types");
     GuildMember = class extends Base {
       client;
       id;
@@ -387,6 +468,7 @@ var init_GuildMember = __esm({
       roles;
       joinedAt;
       communicationDisabledUntil;
+      /** @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;
@@ -398,9 +480,97 @@ var init_GuildMember = __esm({
         this.joinedAt = new Date(data.joined_at);
         this.communicationDisabledUntil = data.communication_disabled_until ? new Date(data.communication_disabled_until) : null;
       }
+      /** Nickname, or global name, or username. */
       get displayName() {
         return this.nick ?? this.user.globalName ?? this.user.username;
       }
+      /**
+       * 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(import_types5.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(import_types5.Routes.guildMemberRole(this.guild.id, this.id, roleId));
+      }
+    };
+  }
+});
+
+// src/structures/Guild.ts
+var Guild_exports = {};
+__export(Guild_exports, {
+  Guild: () => Guild
+});
+var import_collection2, import_types6, Guild;
+var init_Guild = __esm({
+  "src/structures/Guild.ts"() {
+    "use strict";
+    init_Base();
+    import_collection2 = require("@fluxerjs/collection");
+    init_GuildMember();
+    init_Constants();
+    import_types6 = require("@fluxerjs/types");
+    Guild = class extends Base {
+      client;
+      id;
+      name;
+      icon;
+      banner;
+      ownerId;
+      members = new import_collection2.Collection();
+      channels = new import_collection2.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;
+      }
+      /** 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}`;
+      }
+      /**
+       * Fetch a guild member by user ID.
+       * @param userId - The user ID of the member to fetch
+       * @returns The guild member, or null if not found
+       */
+      async fetchMember(userId) {
+        try {
+          const data = await this.client.rest.get(
+            import_types6.Routes.guildMember(this.id, userId)
+          );
+          return new GuildMember(this.client, { ...data, guild_id: this.id }, this);
+        } catch {
+          return null;
+        }
+      }
+      /** 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_types6.Routes.guildWebhooks(this.id));
+        const list = Array.isArray(data) ? data : Object.values(data ?? {});
+        return list.map((w) => new Webhook2(this.client, w));
+      }
     };
   }
 });
@@ -426,24 +596,25 @@ var init_ClientUser = __esm({
 // src/index.ts
 var index_exports = {};
 __export(index_exports, {
-  AttachmentBuilder: () => import_builders.AttachmentBuilder,
+  AttachmentBuilder: () => import_builders2.AttachmentBuilder,
   Base: () => Base,
   CategoryChannel: () => CategoryChannel,
   Channel: () => Channel,
   Client: () => Client,
   ClientUser: () => ClientUser,
-  EmbedBuilder: () => import_builders.EmbedBuilder,
+  DMChannel: () => DMChannel,
+  EmbedBuilder: () => import_builders2.EmbedBuilder,
   ErrorCodes: () => ErrorCodes,
   Events: () => Events,
   FluxerError: () => FluxerError,
-  GatewayOpcodes: () => import_types6.GatewayOpcodes,
+  GatewayOpcodes: () => import_types8.GatewayOpcodes,
   Guild: () => Guild,
   GuildChannel: () => GuildChannel,
   GuildMember: () => GuildMember,
   LinkChannel: () => LinkChannel,
   Message: () => Message,
-  MessagePayload: () => import_builders.MessagePayload,
-  Routes: () => import_types6.Routes,
+  MessagePayload: () => import_builders2.MessagePayload,
+  Routes: () => import_types8.Routes,
   TextChannel: () => TextChannel,
   User: () => User,
   VoiceChannel: () => VoiceChannel,
@@ -455,7 +626,7 @@ module.exports = __toCommonJS(index_exports);
 var import_events = require("events");
 var import_rest = require("@fluxerjs/rest");
 var import_ws = require("@fluxerjs/ws");
-var import_types5 = require("@fluxerjs/types");
+var import_types7 = require("@fluxerjs/types");
 var import_collection3 = require("@fluxerjs/collection");
 
 // src/util/Events.ts
@@ -487,6 +658,7 @@ var Events = {
 
 // src/client/Client.ts
 var Client = class extends import_events.EventEmitter {
+  /** @param options - Token, REST config, WebSocket, presence, etc. */
   constructor(options = {}) {
     super();
     this.options = options;
@@ -503,11 +675,16 @@ var Client = class extends import_events.EventEmitter {
   user = null;
   readyAt = null;
   _ws = null;
+  /** WebSocket manager. Throws if not logged in. */
   get ws() {
     if (!this._ws) throw new Error("Client is not logged in");
     return this._ws;
   }
-  /** Send a payload to the gateway (e.g. Voice State Update). Uses shard 0 when single-shard. */
+  /**
+   * Send a payload to the gateway (e.g. Voice State Update).
+   * @param shardId - Shard ID (use 0 for single-shard)
+   * @param payload - Gateway payload to send
+   */
   sendToGateway(shardId, payload) {
     this.ws.send(shardId, payload);
   }
@@ -658,6 +835,10 @@ var Client = class extends import_events.EventEmitter {
       this.emit(Events.Error, err instanceof Error ? err : new Error(String(err)));
     }
   }
+  /**
+   * Connect to the Fluxer gateway and authenticate.
+   * @param token - Bot token (e.g. from FLUXER_BOT_TOKEN)
+   */
   async login(token) {
     this.rest.setToken(token);
     let intents = this.options.intents ?? 0;
@@ -708,6 +889,7 @@ var Client = class extends import_events.EventEmitter {
     await this._ws.connect();
     return token;
   }
+  /** Disconnect from the gateway and clear cached data. */
   async destroy() {
     if (this._ws) {
       this._ws.destroy();
@@ -720,11 +902,12 @@ var Client = class extends import_events.EventEmitter {
     this.channels.clear();
     this.users.clear();
   }
+  /** Returns true if the client has received Ready and `user` is set. */
   isReady() {
     return this.readyAt !== null && this.user !== null;
   }
   static get Routes() {
-    return import_types5.Routes;
+    return import_types7.Routes;
   }
 };
 
@@ -754,8 +937,8 @@ var ErrorCodes = {
 };
 
 // src/index.ts
-var import_builders = require("@fluxerjs/builders");
-var import_types6 = require("@fluxerjs/types");
+var import_builders2 = require("@fluxerjs/builders");
+var import_types8 = require("@fluxerjs/types");
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
   AttachmentBuilder,
@@ -764,6 +947,7 @@ var import_types6 = require("@fluxerjs/types");
   Channel,
   Client,
   ClientUser,
+  DMChannel,
   EmbedBuilder,
   ErrorCodes,
   Events,