@fluxerjs/core 1.2.2 → 1.2.4

package/dist/index.d.mts

@@ -6,7 +6,7 @@ export { GatewayOpcodes, MessageAttachmentFlags, Routes } from '@fluxerjs/types'
 import { Collection } from '@fluxerjs/collection';
 import { EmbedBuilder } from '@fluxerjs/builders';
 export { AttachmentBuilder, EmbedBuilder, MessagePayload } from '@fluxerjs/builders';
-import { PermissionResolvable } from '@fluxerjs/util';
+import { PermissionsBitField, PermissionResolvable, BitField } from '@fluxerjs/util';
 export { PermissionFlags, PermissionResolvable, PermissionString, PermissionsBitField, UserFlagsBitField, UserFlagsBits, UserFlagsResolvable, UserFlagsString, parsePrefixCommand, parseUserMention, resolvePermissionsToBitfield, resolveTenorToImageUrl } from '@fluxerjs/util';
 
 /** Resolved file data (after URL fetch). Used internally by REST layer. */
@@ -45,8 +45,10 @@ type MessageSendOptions = {
     files?: MessageFileData[];
     /** Attachment metadata for files (id = index). Use when files are provided. */
     attachments?: MessageAttachmentMeta[];
+    /** Message flags (e.g. MessageFlags.SuppressNotifications for reply without ping). */
+    flags?: number;
 };
-/** API-ready body from MessageSendOptions (serializes EmbedBuilder, includes attachments when files present). */
+/** API-ready body from MessageSendOptions or text content (serializes EmbedBuilder, includes attachments when files present). */
 interface SendBodyResult {
     content?: string;
     embeds?: APIEmbed[];
@@ -57,6 +59,8 @@ interface SendBodyResult {
         description?: string | null;
         flags?: number;
     }>;
+    /** Message flags (e.g. SuppressNotifications for reply without ping). */
+    flags?: number;
 }
 
 /** Base class for all Fluxer structures. Provides the client reference. */
@@ -130,7 +134,7 @@ declare class Role extends Base {
     name: string;
     color: number;
     position: number;
-    permissions: string;
+    _permissions: string;
     hoist: boolean;
     mentionable: boolean;
     unicodeEmoji: string | null;
@@ -140,19 +144,11 @@ declare class Role extends Base {
     /** @param data - API role from GET /guilds/{id}/roles or gateway role events */
     /** @param guildId - The guild this role belongs to */
     constructor(client: Client, data: APIRole, guildId: string);
+    get permissions(): PermissionsBitField;
     /** Update mutable fields from fresh API data. Used by edit and gateway events. */
     _patch(data: Partial<APIRole>): void;
     /** Returns a mention string (e.g. `<@&123456>`). */
     toString(): string;
-    /**
-     * 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: PermissionResolvable): boolean;
     /**
      * Edit this role.
      * Requires Manage Roles permission.
@@ -332,9 +328,7 @@ declare class GuildMember extends Base {
      * const perms = member.permissions;
      * if (perms.has(PermissionFlags.BanMembers)) { ... }
      */
-    get permissions(): {
-        has(permission: PermissionResolvable): boolean;
-    };
+    get permissions(): BitField<"CreateInstantInvite" | "KickMembers" | "BanMembers" | "Administrator" | "ManageChannels" | "ManageGuild" | "AddReactions" | "ViewAuditLog" | "PrioritySpeaker" | "Stream" | "ViewChannel" | "SendMessages" | "SendTtsMessages" | "ManageMessages" | "EmbedLinks" | "AttachFiles" | "ReadMessageHistory" | "MentionEveryone" | "UseExternalEmojis" | "Connect" | "Speak" | "MuteMembers" | "DeafenMembers" | "MoveMembers" | "UseVad" | "ChangeNickname" | "ManageNicknames" | "ManageRoles" | "ManageWebhooks" | "ManageEmojisAndStickers" | "ManageExpressions" | "UseExternalStickers" | "ModerateMembers" | "CreateExpressions" | "PinMessages" | "BypassSlowmode" | "UpdateRtcRegion">;
     /**
      * Compute the member's effective permissions in a guild channel.
      * Applies role permissions and channel overwrites.
@@ -344,9 +338,21 @@ declare class GuildMember extends Base {
      * const perms = member.permissionsIn(channel);
      * if (perms.has(PermissionFlags.SendMessages)) { ... }
      */
-    permissionsIn(channel: GuildChannel): {
-        has(permission: PermissionResolvable): boolean;
-    };
+    permissionsIn(channel: GuildChannel): BitField<"CreateInstantInvite" | "KickMembers" | "BanMembers" | "Administrator" | "ManageChannels" | "ManageGuild" | "AddReactions" | "ViewAuditLog" | "PrioritySpeaker" | "Stream" | "ViewChannel" | "SendMessages" | "SendTtsMessages" | "ManageMessages" | "EmbedLinks" | "AttachFiles" | "ReadMessageHistory" | "MentionEveryone" | "UseExternalEmojis" | "Connect" | "Speak" | "MuteMembers" | "DeafenMembers" | "MoveMembers" | "UseVad" | "ChangeNickname" | "ManageNicknames" | "ManageRoles" | "ManageWebhooks" | "ManageEmojisAndStickers" | "ManageExpressions" | "UseExternalStickers" | "ModerateMembers" | "CreateExpressions" | "PinMessages" | "BypassSlowmode" | "UpdateRtcRegion">;
+    /**
+     * Move this member to a different voice channel or disconnect them from voice.
+     * Requires Move Members permission.
+     * @param channelId - The voice channel ID to move the member to, or null to disconnect
+     * @param connectionId - Optional connection ID for the specific voice session (usually not needed)
+     * @returns Promise that resolves when the member has been moved
+     * @example
+     * // Move member to a different voice channel
+     * await member.move('123456789012345678');
+     *
+     * // Disconnect member from voice
+     * await member.move(null);
+     */
+    move(channelId: string | null, connectionId?: string | null): Promise<void>;
     private _computeBasePermissions;
 }
 
@@ -929,9 +935,20 @@ interface MessageEditOptions {
 type MessagePayload = {
     files?: ResolvedMessageFile[];
     body: SendBodyResult & {
-        referenced_message?: APIMessageReference;
+        message_reference?: APIMessageReference;
+        flags?: number;
     };
 };
+/** Options for message.reply() — ping toggle and reply-to-different-message. */
+interface ReplyOptions {
+    /** Whether to ping the replied-to user (default true). Use false to suppress the mention notification. */
+    ping?: boolean;
+    /** Reply to a different message instead of this one. Default: this message. */
+    replyTo?: Message | {
+        channelId: string;
+        messageId: string;
+    };
+}
 
 /** Represents a message in a channel. */
 declare class Message extends Base {
@@ -1004,18 +1021,20 @@ declare class Message extends Base {
     sendTo(channelId: string, options: MessageSendOptions): Promise<Message>;
     /**
      * Reply to this message (shows as a reply in the client).
-     * @param options - Text content or object with content, embeds, and/or files
+     * @param options - Text content or object with content, embeds, and/or reply options (ping, replyTo)
      * @example
      * await message.reply('Pong!');
      * await message.reply({ embeds: [embed] });
+     * await message.reply('No ping!', { ping: false });
+     * await message.reply({ content: 'Reply to other', replyTo: otherMessage });
      */
-    reply(options: string | MessageSendOptions): Promise<Message>;
+    reply(options: string | (MessageSendOptions & ReplyOptions), replyOptions?: ReplyOptions): Promise<Message>;
     /** Exposed for testing purposes, use Message.reply() or send() for normal use */
     static _createMessageBody(content: string | MessageSendOptions, referenced_message?: {
         channel_id: string;
         message_id: string;
         guild_id?: string;
-    }): Promise<MessagePayload>;
+    }, ping?: boolean): Promise<MessagePayload>;
     _send(payload: MessagePayload): Promise<Message>;
     /**
      * Edit this message. Only the author (or admins) can edit.
@@ -1111,15 +1130,23 @@ declare class Message extends Base {
 /**
  * Manages messages for a channel. Access via channel.messages.
  * @example
- * const message = await channel.messages.fetch(messageId);
+ * const message = channel.messages.get(messageId);  // from cache (if enabled)
+ * const message = await channel.messages.fetch(messageId);  // from API
  * if (message) await message.edit({ content: 'Updated!' });
  */
 declare class MessageManager {
     private readonly client;
     private readonly channelId;
     constructor(client: Client, channelId: string);
+    /**
+     * Get a message from cache. Returns undefined if not cached or caching is disabled.
+     * Requires options.cache.messages > 0.
+     * @param messageId - Snowflake of the message
+     */
+    get(messageId: string): Message | undefined;
     /**
      * Fetch a message by ID from this channel.
+     * When message caching is enabled, the fetched message is added to the cache.
      * @param messageId - Snowflake of the message
      * @returns The message
      * @throws FluxerError with MESSAGE_NOT_FOUND if the message does not exist
@@ -1483,7 +1510,7 @@ declare class ChannelManager extends Collection<string, Channel | GuildChannel>
      * await client.channels.send(channelId, { embeds: [embed] });
      * await client.channels.send(channelId, { content: 'Report', files: [{ name: 'log.txt', data }] });
      */
-    send(channelId: string, payload: MessageSendOptions): Promise<Message>;
+    send(channelId: string, payload: string | MessageSendOptions): Promise<Message>;
 }
 
 /**
@@ -1531,6 +1558,8 @@ interface CacheSizeLimits {
     channels?: number;
     guilds?: number;
     users?: number;
+    /** Max messages per channel to cache. Enables channel.messages.get() and oldMessage in messageUpdate. 0 = disabled. */
+    messages?: number;
 }
 interface ClientOptions {
     rest?: Partial<ConstructorParameters<typeof REST>[0]>;
@@ -1776,6 +1805,10 @@ declare class Client extends EventEmitter {
     private _ws;
     /** When waitForGuilds, set of guild IDs we're waiting for GUILD_CREATE on. Null when not waiting. */
     _pendingGuildIds: Set<string> | null;
+    /** Timeout for guild stream when READY has no guilds (gateway sends only GUILD_CREATE). Cleared in finally. */
+    private _guildStreamSettleTimeout;
+    /** Per-channel message cache (channelId -> messageId -> APIMessage). Used when options.cache.messages > 0. */
+    private _messageCaches;
     /** @param options - Token, REST config, WebSocket, presence, etc. */
     constructor(options?: ClientOptions);
     /**
@@ -1818,11 +1851,25 @@ declare class Client extends EventEmitter {
     /**
      * Send a message to any channel by ID. Shorthand for client.channels.send().
      * Works even when the channel is not cached.
+     * @deprecated Use client.channels.send(channelId, payload).
+     */
+    sendToChannel(channelId: string, payload: string | MessageSendOptions): Promise<Message>;
+    /**
+     * Get the message cache for a channel. Returns null if message caching is disabled.
+     * Used by MessageManager.get() and event handlers.
+     * @internal
+     */
+    _getMessageCache(channelId: string): Map<string, APIMessage> | null;
+    /**
+     * Add a message to the channel cache. Evicts oldest (FIFO) when over limit.
+     * @internal
+     */
+    _addMessageToCache(channelId: string, data: APIMessage): void;
+    /**
+     * Remove a message from the channel cache.
+     * @internal
      */
-    sendToChannel(channelId: string, content: string | {
-        content?: string;
-        embeds?: APIEmbed[];
-    }): Promise<Message>;
+    _removeMessageFromCache(channelId: string, messageId: string): void;
     /**
      * Get or create a User from API data. Caches in client.users.
      * Updates existing user's username, avatar, etc. when fresh data is provided.
@@ -1957,4 +2004,4 @@ declare function cdnMemberBannerURL(guildId: string, userId: string, bannerHash:
  */
 declare function cdnDefaultAvatarURL(userIdOrIndex: string | number): string;
 
-export { Base, CDN_URL, CategoryChannel, type CdnUrlOptions, Channel, ChannelManager, Client, type ClientEventMethods, type ClientEvents, ClientUser, type CollectedReaction, DMChannel, ErrorCodes, Events, type FetchedUserWithProfile, FluxerError, type FluxerErrorOptions, Guild, GuildBan, GuildChannel, GuildEmoji, GuildMember, GuildMemberManager, GuildMemberRoleManager, GuildSticker, Invite, LinkChannel, Message, MessageCollector, type MessageCollectorEndReason, type MessageCollectorOptions, type MessageEditOptions, MessageManager, MessageReaction, type MessageSendOptions, type PartialMessage, ReactionCollector, type ReactionCollectorEndReason, type ReactionCollectorOptions, Role, type RoleResolvable, STATIC_CDN_URL, TextChannel, User, UsersManager, VoiceChannel, Webhook, type WebhookSendOptions, cdnAvatarURL, cdnBannerURL, cdnDefaultAvatarURL, cdnDisplayAvatarURL, cdnMemberAvatarURL, cdnMemberBannerURL };
+export { Base, CDN_URL, CategoryChannel, type CdnUrlOptions, Channel, ChannelManager, Client, type ClientEventMethods, type ClientEvents, ClientUser, type CollectedReaction, DMChannel, ErrorCodes, Events, type FetchedUserWithProfile, FluxerError, type FluxerErrorOptions, Guild, GuildBan, GuildChannel, GuildEmoji, GuildMember, GuildMemberManager, GuildMemberRoleManager, GuildSticker, Invite, LinkChannel, Message, MessageCollector, type MessageCollectorEndReason, type MessageCollectorOptions, type MessageEditOptions, MessageManager, MessageReaction, type MessageSendOptions, type PartialMessage, ReactionCollector, type ReactionCollectorEndReason, type ReactionCollectorOptions, type ReplyOptions, Role, type RoleResolvable, STATIC_CDN_URL, TextChannel, User, UsersManager, VoiceChannel, Webhook, type WebhookSendOptions, cdnAvatarURL, cdnBannerURL, cdnDefaultAvatarURL, cdnDisplayAvatarURL, cdnMemberAvatarURL, cdnMemberBannerURL };

package/dist/index.d.ts

@@ -6,7 +6,7 @@ export { GatewayOpcodes, MessageAttachmentFlags, Routes } from '@fluxerjs/types'
 import { Collection } from '@fluxerjs/collection';
 import { EmbedBuilder } from '@fluxerjs/builders';
 export { AttachmentBuilder, EmbedBuilder, MessagePayload } from '@fluxerjs/builders';
-import { PermissionResolvable } from '@fluxerjs/util';
+import { PermissionsBitField, PermissionResolvable, BitField } from '@fluxerjs/util';
 export { PermissionFlags, PermissionResolvable, PermissionString, PermissionsBitField, UserFlagsBitField, UserFlagsBits, UserFlagsResolvable, UserFlagsString, parsePrefixCommand, parseUserMention, resolvePermissionsToBitfield, resolveTenorToImageUrl } from '@fluxerjs/util';
 
 /** Resolved file data (after URL fetch). Used internally by REST layer. */
@@ -45,8 +45,10 @@ type MessageSendOptions = {
     files?: MessageFileData[];
     /** Attachment metadata for files (id = index). Use when files are provided. */
     attachments?: MessageAttachmentMeta[];
+    /** Message flags (e.g. MessageFlags.SuppressNotifications for reply without ping). */
+    flags?: number;
 };
-/** API-ready body from MessageSendOptions (serializes EmbedBuilder, includes attachments when files present). */
+/** API-ready body from MessageSendOptions or text content (serializes EmbedBuilder, includes attachments when files present). */
 interface SendBodyResult {
     content?: string;
     embeds?: APIEmbed[];
@@ -57,6 +59,8 @@ interface SendBodyResult {
         description?: string | null;
         flags?: number;
     }>;
+    /** Message flags (e.g. SuppressNotifications for reply without ping). */
+    flags?: number;
 }
 
 /** Base class for all Fluxer structures. Provides the client reference. */
@@ -130,7 +134,7 @@ declare class Role extends Base {
     name: string;
     color: number;
     position: number;
-    permissions: string;
+    _permissions: string;
     hoist: boolean;
     mentionable: boolean;
     unicodeEmoji: string | null;
@@ -140,19 +144,11 @@ declare class Role extends Base {
     /** @param data - API role from GET /guilds/{id}/roles or gateway role events */
     /** @param guildId - The guild this role belongs to */
     constructor(client: Client, data: APIRole, guildId: string);
+    get permissions(): PermissionsBitField;
     /** Update mutable fields from fresh API data. Used by edit and gateway events. */
     _patch(data: Partial<APIRole>): void;
     /** Returns a mention string (e.g. `<@&123456>`). */
     toString(): string;
-    /**
-     * 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: PermissionResolvable): boolean;
     /**
      * Edit this role.
      * Requires Manage Roles permission.
@@ -332,9 +328,7 @@ declare class GuildMember extends Base {
      * const perms = member.permissions;
      * if (perms.has(PermissionFlags.BanMembers)) { ... }
      */
-    get permissions(): {
-        has(permission: PermissionResolvable): boolean;
-    };
+    get permissions(): BitField<"CreateInstantInvite" | "KickMembers" | "BanMembers" | "Administrator" | "ManageChannels" | "ManageGuild" | "AddReactions" | "ViewAuditLog" | "PrioritySpeaker" | "Stream" | "ViewChannel" | "SendMessages" | "SendTtsMessages" | "ManageMessages" | "EmbedLinks" | "AttachFiles" | "ReadMessageHistory" | "MentionEveryone" | "UseExternalEmojis" | "Connect" | "Speak" | "MuteMembers" | "DeafenMembers" | "MoveMembers" | "UseVad" | "ChangeNickname" | "ManageNicknames" | "ManageRoles" | "ManageWebhooks" | "ManageEmojisAndStickers" | "ManageExpressions" | "UseExternalStickers" | "ModerateMembers" | "CreateExpressions" | "PinMessages" | "BypassSlowmode" | "UpdateRtcRegion">;
     /**
      * Compute the member's effective permissions in a guild channel.
      * Applies role permissions and channel overwrites.
@@ -344,9 +338,21 @@ declare class GuildMember extends Base {
      * const perms = member.permissionsIn(channel);
      * if (perms.has(PermissionFlags.SendMessages)) { ... }
      */
-    permissionsIn(channel: GuildChannel): {
-        has(permission: PermissionResolvable): boolean;
-    };
+    permissionsIn(channel: GuildChannel): BitField<"CreateInstantInvite" | "KickMembers" | "BanMembers" | "Administrator" | "ManageChannels" | "ManageGuild" | "AddReactions" | "ViewAuditLog" | "PrioritySpeaker" | "Stream" | "ViewChannel" | "SendMessages" | "SendTtsMessages" | "ManageMessages" | "EmbedLinks" | "AttachFiles" | "ReadMessageHistory" | "MentionEveryone" | "UseExternalEmojis" | "Connect" | "Speak" | "MuteMembers" | "DeafenMembers" | "MoveMembers" | "UseVad" | "ChangeNickname" | "ManageNicknames" | "ManageRoles" | "ManageWebhooks" | "ManageEmojisAndStickers" | "ManageExpressions" | "UseExternalStickers" | "ModerateMembers" | "CreateExpressions" | "PinMessages" | "BypassSlowmode" | "UpdateRtcRegion">;
+    /**
+     * Move this member to a different voice channel or disconnect them from voice.
+     * Requires Move Members permission.
+     * @param channelId - The voice channel ID to move the member to, or null to disconnect
+     * @param connectionId - Optional connection ID for the specific voice session (usually not needed)
+     * @returns Promise that resolves when the member has been moved
+     * @example
+     * // Move member to a different voice channel
+     * await member.move('123456789012345678');
+     *
+     * // Disconnect member from voice
+     * await member.move(null);
+     */
+    move(channelId: string | null, connectionId?: string | null): Promise<void>;
     private _computeBasePermissions;
 }
 
@@ -929,9 +935,20 @@ interface MessageEditOptions {
 type MessagePayload = {
     files?: ResolvedMessageFile[];
     body: SendBodyResult & {
-        referenced_message?: APIMessageReference;
+        message_reference?: APIMessageReference;
+        flags?: number;
     };
 };
+/** Options for message.reply() — ping toggle and reply-to-different-message. */
+interface ReplyOptions {
+    /** Whether to ping the replied-to user (default true). Use false to suppress the mention notification. */
+    ping?: boolean;
+    /** Reply to a different message instead of this one. Default: this message. */
+    replyTo?: Message | {
+        channelId: string;
+        messageId: string;
+    };
+}
 
 /** Represents a message in a channel. */
 declare class Message extends Base {
@@ -1004,18 +1021,20 @@ declare class Message extends Base {
     sendTo(channelId: string, options: MessageSendOptions): Promise<Message>;
     /**
      * Reply to this message (shows as a reply in the client).
-     * @param options - Text content or object with content, embeds, and/or files
+     * @param options - Text content or object with content, embeds, and/or reply options (ping, replyTo)
      * @example
      * await message.reply('Pong!');
      * await message.reply({ embeds: [embed] });
+     * await message.reply('No ping!', { ping: false });
+     * await message.reply({ content: 'Reply to other', replyTo: otherMessage });
      */
-    reply(options: string | MessageSendOptions): Promise<Message>;
+    reply(options: string | (MessageSendOptions & ReplyOptions), replyOptions?: ReplyOptions): Promise<Message>;
     /** Exposed for testing purposes, use Message.reply() or send() for normal use */
     static _createMessageBody(content: string | MessageSendOptions, referenced_message?: {
         channel_id: string;
         message_id: string;
         guild_id?: string;
-    }): Promise<MessagePayload>;
+    }, ping?: boolean): Promise<MessagePayload>;
     _send(payload: MessagePayload): Promise<Message>;
     /**
      * Edit this message. Only the author (or admins) can edit.
@@ -1111,15 +1130,23 @@ declare class Message extends Base {
 /**
  * Manages messages for a channel. Access via channel.messages.
  * @example
- * const message = await channel.messages.fetch(messageId);
+ * const message = channel.messages.get(messageId);  // from cache (if enabled)
+ * const message = await channel.messages.fetch(messageId);  // from API
  * if (message) await message.edit({ content: 'Updated!' });
  */
 declare class MessageManager {
     private readonly client;
     private readonly channelId;
     constructor(client: Client, channelId: string);
+    /**
+     * Get a message from cache. Returns undefined if not cached or caching is disabled.
+     * Requires options.cache.messages > 0.
+     * @param messageId - Snowflake of the message
+     */
+    get(messageId: string): Message | undefined;
     /**
      * Fetch a message by ID from this channel.
+     * When message caching is enabled, the fetched message is added to the cache.
      * @param messageId - Snowflake of the message
      * @returns The message
      * @throws FluxerError with MESSAGE_NOT_FOUND if the message does not exist
@@ -1483,7 +1510,7 @@ declare class ChannelManager extends Collection<string, Channel | GuildChannel>
      * await client.channels.send(channelId, { embeds: [embed] });
      * await client.channels.send(channelId, { content: 'Report', files: [{ name: 'log.txt', data }] });
      */
-    send(channelId: string, payload: MessageSendOptions): Promise<Message>;
+    send(channelId: string, payload: string | MessageSendOptions): Promise<Message>;
 }
 
 /**
@@ -1531,6 +1558,8 @@ interface CacheSizeLimits {
     channels?: number;
     guilds?: number;
     users?: number;
+    /** Max messages per channel to cache. Enables channel.messages.get() and oldMessage in messageUpdate. 0 = disabled. */
+    messages?: number;
 }
 interface ClientOptions {
     rest?: Partial<ConstructorParameters<typeof REST>[0]>;
@@ -1776,6 +1805,10 @@ declare class Client extends EventEmitter {
     private _ws;
     /** When waitForGuilds, set of guild IDs we're waiting for GUILD_CREATE on. Null when not waiting. */
     _pendingGuildIds: Set<string> | null;
+    /** Timeout for guild stream when READY has no guilds (gateway sends only GUILD_CREATE). Cleared in finally. */
+    private _guildStreamSettleTimeout;
+    /** Per-channel message cache (channelId -> messageId -> APIMessage). Used when options.cache.messages > 0. */
+    private _messageCaches;
     /** @param options - Token, REST config, WebSocket, presence, etc. */
     constructor(options?: ClientOptions);
     /**
@@ -1818,11 +1851,25 @@ declare class Client extends EventEmitter {
     /**
      * Send a message to any channel by ID. Shorthand for client.channels.send().
      * Works even when the channel is not cached.
+     * @deprecated Use client.channels.send(channelId, payload).
+     */
+    sendToChannel(channelId: string, payload: string | MessageSendOptions): Promise<Message>;
+    /**
+     * Get the message cache for a channel. Returns null if message caching is disabled.
+     * Used by MessageManager.get() and event handlers.
+     * @internal
+     */
+    _getMessageCache(channelId: string): Map<string, APIMessage> | null;
+    /**
+     * Add a message to the channel cache. Evicts oldest (FIFO) when over limit.
+     * @internal
+     */
+    _addMessageToCache(channelId: string, data: APIMessage): void;
+    /**
+     * Remove a message from the channel cache.
+     * @internal
      */
-    sendToChannel(channelId: string, content: string | {
-        content?: string;
-        embeds?: APIEmbed[];
-    }): Promise<Message>;
+    _removeMessageFromCache(channelId: string, messageId: string): void;
     /**
      * Get or create a User from API data. Caches in client.users.
      * Updates existing user's username, avatar, etc. when fresh data is provided.
@@ -1957,4 +2004,4 @@ declare function cdnMemberBannerURL(guildId: string, userId: string, bannerHash:
  */
 declare function cdnDefaultAvatarURL(userIdOrIndex: string | number): string;
 
-export { Base, CDN_URL, CategoryChannel, type CdnUrlOptions, Channel, ChannelManager, Client, type ClientEventMethods, type ClientEvents, ClientUser, type CollectedReaction, DMChannel, ErrorCodes, Events, type FetchedUserWithProfile, FluxerError, type FluxerErrorOptions, Guild, GuildBan, GuildChannel, GuildEmoji, GuildMember, GuildMemberManager, GuildMemberRoleManager, GuildSticker, Invite, LinkChannel, Message, MessageCollector, type MessageCollectorEndReason, type MessageCollectorOptions, type MessageEditOptions, MessageManager, MessageReaction, type MessageSendOptions, type PartialMessage, ReactionCollector, type ReactionCollectorEndReason, type ReactionCollectorOptions, Role, type RoleResolvable, STATIC_CDN_URL, TextChannel, User, UsersManager, VoiceChannel, Webhook, type WebhookSendOptions, cdnAvatarURL, cdnBannerURL, cdnDefaultAvatarURL, cdnDisplayAvatarURL, cdnMemberAvatarURL, cdnMemberBannerURL };
+export { Base, CDN_URL, CategoryChannel, type CdnUrlOptions, Channel, ChannelManager, Client, type ClientEventMethods, type ClientEvents, ClientUser, type CollectedReaction, DMChannel, ErrorCodes, Events, type FetchedUserWithProfile, FluxerError, type FluxerErrorOptions, Guild, GuildBan, GuildChannel, GuildEmoji, GuildMember, GuildMemberManager, GuildMemberRoleManager, GuildSticker, Invite, LinkChannel, Message, MessageCollector, type MessageCollectorEndReason, type MessageCollectorOptions, type MessageEditOptions, MessageManager, MessageReaction, type MessageSendOptions, type PartialMessage, ReactionCollector, type ReactionCollectorEndReason, type ReactionCollectorOptions, type ReplyOptions, Role, type RoleResolvable, STATIC_CDN_URL, TextChannel, User, UsersManager, VoiceChannel, Webhook, type WebhookSendOptions, cdnAvatarURL, cdnBannerURL, cdnDefaultAvatarURL, cdnDisplayAvatarURL, cdnMemberAvatarURL, cdnMemberBannerURL };

package/dist/index.js

@@ -162,6 +162,7 @@ function buildSendBody(options) {
       filename: f.filename ?? f.name
     }));
   }
+  if (body.flags !== void 0) result.flags = body.flags;
   return result;
 }
 
@@ -394,21 +395,31 @@ var Message = class _Message extends Base {
   }
   /**
    * Reply to this message (shows as a reply in the client).
-   * @param options - Text content or object with content, embeds, and/or files
+   * @param options - Text content or object with content, embeds, and/or reply options (ping, replyTo)
    * @example
    * await message.reply('Pong!');
    * await message.reply({ embeds: [embed] });
+   * await message.reply('No ping!', { ping: false });
+   * await message.reply({ content: 'Reply to other', replyTo: otherMessage });
    */
-  async reply(options) {
-    const payload = await _Message._createMessageBody(options, {
-      channel_id: this.channelId,
-      message_id: this.id,
-      guild_id: this.guildId ?? void 0
-    });
+  async reply(options, replyOptions) {
+    const opts = typeof options === "string" ? { content: options } : options;
+    const mergedReply = replyOptions ?? (opts.ping !== void 0 || opts.replyTo !== void 0) ? { ping: opts.ping, replyTo: opts.replyTo } : void 0;
+    const refMessage = mergedReply?.replyTo ?? this;
+    const ref = refMessage instanceof _Message ? {
+      channel_id: refMessage.channelId,
+      message_id: refMessage.id,
+      guild_id: refMessage.guildId ?? void 0
+    } : {
+      channel_id: refMessage.channelId,
+      message_id: refMessage.messageId,
+      guild_id: void 0
+    };
+    const payload = await _Message._createMessageBody(opts, ref, mergedReply?.ping !== false);
     return this._send(payload);
   }
   /** Exposed for testing purposes, use Message.reply() or send() for normal use */
-  static async _createMessageBody(content, referenced_message) {
+  static async _createMessageBody(content, referenced_message, ping) {
     if (typeof content === "string") {
       if (content.length === 0) {
         throw new RangeError("Cannot send an empty message");
@@ -417,13 +428,21 @@ var Message = class _Message extends Base {
     }
     const base = buildSendBody(content);
     const files = content.files?.length ? await resolveMessageFiles(content.files) : void 0;
-    return referenced_message ? { files, body: { ...base, referenced_message } } : { files, body: { ...base } };
+    const body = { ...base };
+    if (referenced_message) {
+      body.message_reference = referenced_message;
+      if (ping === false) {
+        body.flags = (body.flags ?? 0) | import_types.MessageFlags.SuppressNotifications;
+      }
+    }
+    return { files, body };
   }
   async _send(payload) {
     const data = await this.client.rest.post(
       import_types.Routes.channelMessages(this.channelId),
       payload
     );
+    this.client._addMessageToCache(this.channelId, data);
     return new _Message(this.client, data);
   }
   /**
@@ -560,8 +579,18 @@ var MessageManager = class {
     this.client = client;
     this.channelId = channelId;
   }
+  /**
+   * Get a message from cache. Returns undefined if not cached or caching is disabled.
+   * Requires options.cache.messages > 0.
+   * @param messageId - Snowflake of the message
+   */
+  get(messageId) {
+    const data = this.client._getMessageCache(this.channelId)?.get(messageId);
+    return data ? new Message(this.client, data) : void 0;
+  }
   /**
    * Fetch a message by ID from this channel.
+   * When message caching is enabled, the fetched message is added to the cache.
    * @param messageId - Snowflake of the message
    * @returns The message
    * @throws FluxerError with MESSAGE_NOT_FOUND if the message does not exist
@@ -571,6 +600,7 @@ var MessageManager = class {
       const data = await this.client.rest.get(
         import_types2.Routes.channelMessage(this.channelId, messageId)
       );
+      this.client._addMessageToCache(this.channelId, data);
       return new Message(this.client, data);
     } catch (err) {
       if (err instanceof import_rest.RateLimitError) throw err;
@@ -1068,6 +1098,7 @@ var GuildChannel = class extends Channel {
     const files = opts.files?.length ? await resolveMessageFiles(opts.files) : void 0;
     const postOptions = files?.length ? { body, files } : { body };
     const data = await this.client.rest.post(import_types5.Routes.channelMessages(this.id), postOptions);
+    this.client._addMessageToCache(this.id, data);
     return new Message(this.client, data);
   }
   /**
@@ -1133,6 +1164,7 @@ var TextChannel = class extends GuildChannel {
     const files = opts.files?.length ? await resolveMessageFiles(opts.files) : void 0;
     const postOptions = files?.length ? { body, files } : { body };
     const data = await this.client.rest.post(import_types5.Routes.channelMessages(this.id), postOptions);
+    this.client._addMessageToCache(this.id, data);
     return new Message(this.client, data);
   }
   /** Message manager for this channel. Use channel.messages.fetch(messageId). */
@@ -1224,6 +1256,7 @@ var DMChannel = class extends Channel {
     const files = opts.files?.length ? await resolveMessageFiles(opts.files) : void 0;
     const postOptions = files?.length ? { body, files } : { body };
     const data = await this.client.rest.post(import_types5.Routes.channelMessages(this.id), postOptions);
+    this.client._addMessageToCache(this.id, data);
     return new Message(this.client, data);
   }
   /** Message manager for this channel. Use channel.messages.fetch(messageId). */
@@ -1398,6 +1431,7 @@ var ChannelManager = class extends import_collection4.Collection {
     const files = opts.files?.length ? await resolveMessageFiles(opts.files) : void 0;
     const postOptions = files?.length ? { body, files } : { body };
     const data = await this.client.rest.post(import_types6.Routes.channelMessages(channelId), postOptions);
+    this.client._addMessageToCache(channelId, data);
     return new Message(this.client, data);
   }
 };
@@ -1432,12 +1466,7 @@ function computePermissions(basePermissions, overwrites, memberRoles, memberId,
     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;
+  return (perms & import_util4.PermissionFlags.Administrator) !== 0n ? import_util4.ALL_PERMISSIONS_BIGINT : perms;
 }
 
 // src/structures/GuildMemberRoleManager.ts
@@ -1639,13 +1668,7 @@ var GuildMember = class extends Base {
     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 : import_util5.PermissionFlagsMap[String(permission)];
-        if (perm === void 0) return false;
-        return hasPermission(perms, BigInt(perm));
-      }
-    };
+    return new import_util5.BitField(perms);
   }
   /**
    * Compute the member's effective permissions in a guild channel.
@@ -1667,22 +1690,35 @@ var GuildMember = class extends Base {
       this.id,
       isOwner
     );
-    return {
-      has(permission) {
-        const perm = typeof permission === "number" ? permission : import_util5.PermissionFlagsMap[String(permission)];
-        if (perm === void 0) return false;
-        return hasPermission(perms, BigInt(perm));
-      }
-    };
+    return new import_util5.BitField(perms);
+  }
+  /**
+   * Move this member to a different voice channel or disconnect them from voice.
+   * Requires Move Members permission.
+   * @param channelId - The voice channel ID to move the member to, or null to disconnect
+   * @param connectionId - Optional connection ID for the specific voice session (usually not needed)
+   * @returns Promise that resolves when the member has been moved
+   * @example
+   * // Move member to a different voice channel
+   * await member.move('123456789012345678');
+   *
+   * // Disconnect member from voice
+   * await member.move(null);
+   */
+  async move(channelId, connectionId) {
+    await this.edit({
+      channel_id: channelId,
+      connection_id: connectionId
+    });
   }
   _computeBasePermissions() {
     let base = 0n;
     const everyone = this.guild.roles.get(this.guild.id);
-    if (everyone) base |= BigInt(everyone.permissions);
+    if (everyone) base |= everyone.permissions.bitfield;
     for (const roleId of this.roles.roleIds) {
       if (roleId === this.guild.id) continue;
       const role = this.guild.roles.get(roleId);
-      if (role) base |= BigInt(role.permissions);
+      if (role) base |= role.permissions.bitfield;
     }
     return base;
   }
@@ -1774,7 +1810,7 @@ var Role = class extends Base {
   name;
   color;
   position;
-  permissions;
+  _permissions;
   hoist;
   mentionable;
   unicodeEmoji;
@@ -1791,18 +1827,24 @@ var Role = class extends Base {
     this.name = data.name;
     this.color = data.color;
     this.position = data.position;
-    this.permissions = data.permissions;
+    this._permissions = data.permissions;
     this.hoist = !!data.hoist;
     this.mentionable = !!data.mentionable;
     this.unicodeEmoji = data.unicode_emoji ?? null;
     this.hoistPosition = data.hoist_position ?? null;
   }
+  get permissions() {
+    const bits = BigInt(this._permissions);
+    return new import_util6.PermissionsBitField(
+      (bits & import_util6.PermissionFlags.Administrator) !== 0n ? import_util6.ALL_PERMISSIONS_BIGINT : bits
+    );
+  }
   /** 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.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;
@@ -1812,24 +1854,6 @@ var Role = class extends Base {
   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 : import_util6.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(import_util6.PermissionFlags.Administrator)) !== 0n) return true;
-    return (rolePerms & permBig) === permBig;
-  }
   /**
    * Edit this role.
    * Requires Manage Roles permission.
@@ -2869,13 +2893,28 @@ handlers.set("MESSAGE_CREATE", async (client, d) => {
       guild.members.set(member.id, member);
     }
   }
+  client._addMessageToCache(data.channel_id, data);
   client.emit(Events.MessageCreate, new Message(client, data));
 });
 handlers.set("MESSAGE_UPDATE", async (client, d) => {
-  client.emit(Events.MessageUpdate, null, new Message(client, d));
+  const partial = d;
+  const cache = client._getMessageCache(partial.channel_id);
+  let oldMessage = null;
+  let mergedData = partial;
+  if (cache) {
+    const oldData = cache.get(partial.id);
+    if (oldData) {
+      oldMessage = new Message(client, oldData);
+      mergedData = { ...oldData, ...partial };
+    }
+    cache.set(partial.id, mergedData);
+  }
+  const newMessage = new Message(client, mergedData);
+  client.emit(Events.MessageUpdate, oldMessage, newMessage);
 });
 handlers.set("MESSAGE_DELETE", async (client, d) => {
   const data = d;
+  client._removeMessageFromCache(data.channel_id, data.id);
   const channel = client.channels.get(data.channel_id) ?? null;
   client.emit(Events.MessageDelete, {
     id: data.id,
@@ -3045,7 +3084,11 @@ handlers.set("VOICE_SERVER_UPDATE", async (client, d) => {
   client.emit(Events.VoiceServerUpdate, d);
 });
 handlers.set("MESSAGE_DELETE_BULK", async (client, d) => {
-  client.emit(Events.MessageDeleteBulk, d);
+  const data = d;
+  for (const id of data.ids ?? []) {
+    client._removeMessageFromCache(data.channel_id, id);
+  }
+  client.emit(Events.MessageDeleteBulk, data);
 });
 handlers.set("GUILD_BAN_ADD", async (client, d) => {
   const data = d;
@@ -3203,6 +3246,10 @@ var Client = class extends import_events3.EventEmitter {
   _ws = null;
   /** When waitForGuilds, set of guild IDs we're waiting for GUILD_CREATE on. Null when not waiting. */
   _pendingGuildIds = null;
+  /** Timeout for guild stream when READY has no guilds (gateway sends only GUILD_CREATE). Cleared in finally. */
+  _guildStreamSettleTimeout = null;
+  /** Per-channel message cache (channelId -> messageId -> APIMessage). Used when options.cache.messages > 0. */
+  _messageCaches = null;
   /**
    * Resolve an emoji argument to the API format (unicode or "name:id").
    * Supports: <:name:id>, :name:, name:id, { name, id }, unicode.
@@ -3291,11 +3338,52 @@ var Client = class extends import_events3.EventEmitter {
   /**
    * Send a message to any channel by ID. Shorthand for client.channels.send().
    * Works even when the channel is not cached.
+   * @deprecated Use client.channels.send(channelId, payload).
    */
-  async sendToChannel(channelId, content) {
-    const payload = await Message._createMessageBody(content);
+  async sendToChannel(channelId, payload) {
+    (0, import_util8.emitDeprecationWarning)(
+      "Client.sendToChannel()",
+      "Use client.channels.send(channelId, payload)."
+    );
     return this.channels.send(channelId, payload);
   }
+  /**
+   * Get the message cache for a channel. Returns null if message caching is disabled.
+   * Used by MessageManager.get() and event handlers.
+   * @internal
+   */
+  _getMessageCache(channelId) {
+    const limit = this.options.cache?.messages ?? 0;
+    if (limit <= 0) return null;
+    if (!this._messageCaches) this._messageCaches = /* @__PURE__ */ new Map();
+    let cache = this._messageCaches.get(channelId);
+    if (!cache) {
+      cache = /* @__PURE__ */ new Map();
+      this._messageCaches.set(channelId, cache);
+    }
+    return cache;
+  }
+  /**
+   * Add a message to the channel cache. Evicts oldest (FIFO) when over limit.
+   * @internal
+   */
+  _addMessageToCache(channelId, data) {
+    const cache = this._getMessageCache(channelId);
+    if (!cache) return;
+    const limit = this.options.cache?.messages ?? 0;
+    if (limit > 0 && cache.size >= limit && !cache.has(data.id)) {
+      const firstKey = cache.keys().next().value;
+      if (firstKey !== void 0) cache.delete(firstKey);
+    }
+    cache.set(data.id, { ...data });
+  }
+  /**
+   * Remove a message from the channel cache.
+   * @internal
+   */
+  _removeMessageFromCache(channelId, messageId) {
+    this._messageCaches?.get(channelId)?.delete(messageId);
+  }
   /**
    * Get or create a User from API data. Caches in client.users.
    * Updates existing user's username, avatar, etc. when fresh data is provided.
@@ -3406,6 +3494,14 @@ var Client = class extends import_events3.EventEmitter {
           this._pendingGuildIds = pending;
           return;
         }
+        if (waitForGuilds && (data.guilds ?? []).length === 0) {
+          const GUILD_STREAM_SETTLE_MS = 500;
+          this._guildStreamSettleTimeout = setTimeout(() => {
+            this._guildStreamSettleTimeout = null;
+            this._finalizeReady();
+          }, GUILD_STREAM_SETTLE_MS);
+          return;
+        }
         this._finalizeReady();
       }
     );
@@ -3435,6 +3531,10 @@ var Client = class extends import_events3.EventEmitter {
   }
   /** Disconnect from the gateway and clear cached data. */
   async destroy() {
+    if (this._guildStreamSettleTimeout !== null) {
+      clearTimeout(this._guildStreamSettleTimeout);
+      this._guildStreamSettleTimeout = null;
+    }
     if (this._ws) {
       this._ws.destroy();
       this._ws = null;

package/dist/index.mjs

@@ -86,6 +86,7 @@ function buildSendBody(options) {
       filename: f.filename ?? f.name
     }));
   }
+  if (body.flags !== void 0) result.flags = body.flags;
   return result;
 }
 
@@ -99,7 +100,7 @@ var Base = class {
 
 // src/structures/Message.ts
 import { Collection as Collection2 } from "@fluxerjs/collection";
-import { MessageType, Routes } from "@fluxerjs/types";
+import { MessageType, MessageFlags, Routes } from "@fluxerjs/types";
 import { EmbedBuilder as EmbedBuilder2 } from "@fluxerjs/builders";
 
 // src/util/ReactionCollector.ts
@@ -318,21 +319,31 @@ var Message = class _Message extends Base {
   }
   /**
    * Reply to this message (shows as a reply in the client).
-   * @param options - Text content or object with content, embeds, and/or files
+   * @param options - Text content or object with content, embeds, and/or reply options (ping, replyTo)
    * @example
    * await message.reply('Pong!');
    * await message.reply({ embeds: [embed] });
+   * await message.reply('No ping!', { ping: false });
+   * await message.reply({ content: 'Reply to other', replyTo: otherMessage });
    */
-  async reply(options) {
-    const payload = await _Message._createMessageBody(options, {
-      channel_id: this.channelId,
-      message_id: this.id,
-      guild_id: this.guildId ?? void 0
-    });
+  async reply(options, replyOptions) {
+    const opts = typeof options === "string" ? { content: options } : options;
+    const mergedReply = replyOptions ?? (opts.ping !== void 0 || opts.replyTo !== void 0) ? { ping: opts.ping, replyTo: opts.replyTo } : void 0;
+    const refMessage = mergedReply?.replyTo ?? this;
+    const ref = refMessage instanceof _Message ? {
+      channel_id: refMessage.channelId,
+      message_id: refMessage.id,
+      guild_id: refMessage.guildId ?? void 0
+    } : {
+      channel_id: refMessage.channelId,
+      message_id: refMessage.messageId,
+      guild_id: void 0
+    };
+    const payload = await _Message._createMessageBody(opts, ref, mergedReply?.ping !== false);
     return this._send(payload);
   }
   /** Exposed for testing purposes, use Message.reply() or send() for normal use */
-  static async _createMessageBody(content, referenced_message) {
+  static async _createMessageBody(content, referenced_message, ping) {
     if (typeof content === "string") {
       if (content.length === 0) {
         throw new RangeError("Cannot send an empty message");
@@ -341,13 +352,21 @@ var Message = class _Message extends Base {
     }
     const base = buildSendBody(content);
     const files = content.files?.length ? await resolveMessageFiles(content.files) : void 0;
-    return referenced_message ? { files, body: { ...base, referenced_message } } : { files, body: { ...base } };
+    const body = { ...base };
+    if (referenced_message) {
+      body.message_reference = referenced_message;
+      if (ping === false) {
+        body.flags = (body.flags ?? 0) | MessageFlags.SuppressNotifications;
+      }
+    }
+    return { files, body };
   }
   async _send(payload) {
     const data = await this.client.rest.post(
       Routes.channelMessages(this.channelId),
       payload
     );
+    this.client._addMessageToCache(this.channelId, data);
     return new _Message(this.client, data);
   }
   /**
@@ -484,8 +503,18 @@ var MessageManager = class {
     this.client = client;
     this.channelId = channelId;
   }
+  /**
+   * Get a message from cache. Returns undefined if not cached or caching is disabled.
+   * Requires options.cache.messages > 0.
+   * @param messageId - Snowflake of the message
+   */
+  get(messageId) {
+    const data = this.client._getMessageCache(this.channelId)?.get(messageId);
+    return data ? new Message(this.client, data) : void 0;
+  }
   /**
    * Fetch a message by ID from this channel.
+   * When message caching is enabled, the fetched message is added to the cache.
    * @param messageId - Snowflake of the message
    * @returns The message
    * @throws FluxerError with MESSAGE_NOT_FOUND if the message does not exist
@@ -495,6 +524,7 @@ var MessageManager = class {
       const data = await this.client.rest.get(
         Routes2.channelMessage(this.channelId, messageId)
       );
+      this.client._addMessageToCache(this.channelId, data);
       return new Message(this.client, data);
     } catch (err) {
       if (err instanceof RateLimitError) throw err;
@@ -992,6 +1022,7 @@ var GuildChannel = class extends Channel {
     const files = opts.files?.length ? await resolveMessageFiles(opts.files) : void 0;
     const postOptions = files?.length ? { body, files } : { body };
     const data = await this.client.rest.post(Routes5.channelMessages(this.id), postOptions);
+    this.client._addMessageToCache(this.id, data);
     return new Message(this.client, data);
   }
   /**
@@ -1057,6 +1088,7 @@ var TextChannel = class extends GuildChannel {
     const files = opts.files?.length ? await resolveMessageFiles(opts.files) : void 0;
     const postOptions = files?.length ? { body, files } : { body };
     const data = await this.client.rest.post(Routes5.channelMessages(this.id), postOptions);
+    this.client._addMessageToCache(this.id, data);
     return new Message(this.client, data);
   }
   /** Message manager for this channel. Use channel.messages.fetch(messageId). */
@@ -1148,6 +1180,7 @@ var DMChannel = class extends Channel {
     const files = opts.files?.length ? await resolveMessageFiles(opts.files) : void 0;
     const postOptions = files?.length ? { body, files } : { body };
     const data = await this.client.rest.post(Routes5.channelMessages(this.id), postOptions);
+    this.client._addMessageToCache(this.id, data);
     return new Message(this.client, data);
   }
   /** Message manager for this channel. Use channel.messages.fetch(messageId). */
@@ -1322,6 +1355,7 @@ var ChannelManager = class extends Collection4 {
     const files = opts.files?.length ? await resolveMessageFiles(opts.files) : void 0;
     const postOptions = files?.length ? { body, files } : { body };
     const data = await this.client.rest.post(Routes6.channelMessages(channelId), postOptions);
+    this.client._addMessageToCache(channelId, data);
     return new Message(this.client, data);
   }
 };
@@ -1343,12 +1377,12 @@ import { Collection as Collection6 } from "@fluxerjs/collection";
 import { Routes as Routes9 } from "@fluxerjs/types";
 
 // src/structures/GuildMember.ts
-import { PermissionFlagsMap } from "@fluxerjs/util";
+import { BitField } from "@fluxerjs/util";
 import { Routes as Routes8 } from "@fluxerjs/types";
 
 // src/util/permissions.ts
 import { OverwriteType } from "@fluxerjs/types";
-import { ALL_PERMISSIONS_BIGINT } from "@fluxerjs/util";
+import { ALL_PERMISSIONS_BIGINT, PermissionFlags as PermissionFlags2 } from "@fluxerjs/util";
 function computePermissions(basePermissions, overwrites, memberRoles, memberId, isOwner) {
   if (isOwner) return ALL_PERMISSIONS_BIGINT;
   let perms = basePermissions;
@@ -1359,12 +1393,7 @@ function computePermissions(basePermissions, overwrites, memberRoles, memberId,
     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;
+  return (perms & PermissionFlags2.Administrator) !== 0n ? ALL_PERMISSIONS_BIGINT : perms;
 }
 
 // src/structures/GuildMemberRoleManager.ts
@@ -1566,13 +1595,7 @@ var GuildMember = class extends Base {
     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));
-      }
-    };
+    return new BitField(perms);
   }
   /**
    * Compute the member's effective permissions in a guild channel.
@@ -1594,22 +1617,35 @@ var GuildMember = class extends 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));
-      }
-    };
+    return new BitField(perms);
+  }
+  /**
+   * Move this member to a different voice channel or disconnect them from voice.
+   * Requires Move Members permission.
+   * @param channelId - The voice channel ID to move the member to, or null to disconnect
+   * @param connectionId - Optional connection ID for the specific voice session (usually not needed)
+   * @returns Promise that resolves when the member has been moved
+   * @example
+   * // Move member to a different voice channel
+   * await member.move('123456789012345678');
+   *
+   * // Disconnect member from voice
+   * await member.move(null);
+   */
+  async move(channelId, connectionId) {
+    await this.edit({
+      channel_id: channelId,
+      connection_id: connectionId
+    });
   }
   _computeBasePermissions() {
     let base = 0n;
     const everyone = this.guild.roles.get(this.guild.id);
-    if (everyone) base |= BigInt(everyone.permissions);
+    if (everyone) base |= everyone.permissions.bitfield;
     for (const roleId of this.roles.roleIds) {
       if (roleId === this.guild.id) continue;
       const role = this.guild.roles.get(roleId);
-      if (role) base |= BigInt(role.permissions);
+      if (role) base |= role.permissions.bitfield;
     }
     return base;
   }
@@ -1694,8 +1730,10 @@ var GuildMemberManager = class extends Collection6 {
 // src/structures/Role.ts
 import { Routes as Routes10 } from "@fluxerjs/types";
 import {
-  PermissionFlags as PermissionFlags2,
-  resolvePermissionsToBitfield
+  PermissionFlags as PermissionFlags4,
+  resolvePermissionsToBitfield,
+  ALL_PERMISSIONS_BIGINT as ALL_PERMISSIONS_BIGINT2,
+  PermissionsBitField
 } from "@fluxerjs/util";
 var Role = class extends Base {
   client;
@@ -1704,7 +1742,7 @@ var Role = class extends Base {
   name;
   color;
   position;
-  permissions;
+  _permissions;
   hoist;
   mentionable;
   unicodeEmoji;
@@ -1721,18 +1759,24 @@ var Role = class extends Base {
     this.name = data.name;
     this.color = data.color;
     this.position = data.position;
-    this.permissions = data.permissions;
+    this._permissions = data.permissions;
     this.hoist = !!data.hoist;
     this.mentionable = !!data.mentionable;
     this.unicodeEmoji = data.unicode_emoji ?? null;
     this.hoistPosition = data.hoist_position ?? null;
   }
+  get permissions() {
+    const bits = BigInt(this._permissions);
+    return new PermissionsBitField(
+      (bits & PermissionFlags4.Administrator) !== 0n ? ALL_PERMISSIONS_BIGINT2 : bits
+    );
+  }
   /** 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.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;
@@ -1742,24 +1786,6 @@ var Role = class extends Base {
   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 : PermissionFlags2[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(PermissionFlags2.Administrator)) !== 0n) return true;
-    return (rolePerms & permBig) === permBig;
-  }
   /**
    * Edit this role.
    * Requires Manage Roles permission.
@@ -2804,13 +2830,28 @@ handlers.set("MESSAGE_CREATE", async (client, d) => {
       guild.members.set(member.id, member);
     }
   }
+  client._addMessageToCache(data.channel_id, data);
   client.emit(Events.MessageCreate, new Message(client, data));
 });
 handlers.set("MESSAGE_UPDATE", async (client, d) => {
-  client.emit(Events.MessageUpdate, null, new Message(client, d));
+  const partial = d;
+  const cache = client._getMessageCache(partial.channel_id);
+  let oldMessage = null;
+  let mergedData = partial;
+  if (cache) {
+    const oldData = cache.get(partial.id);
+    if (oldData) {
+      oldMessage = new Message(client, oldData);
+      mergedData = { ...oldData, ...partial };
+    }
+    cache.set(partial.id, mergedData);
+  }
+  const newMessage = new Message(client, mergedData);
+  client.emit(Events.MessageUpdate, oldMessage, newMessage);
 });
 handlers.set("MESSAGE_DELETE", async (client, d) => {
   const data = d;
+  client._removeMessageFromCache(data.channel_id, data.id);
   const channel = client.channels.get(data.channel_id) ?? null;
   client.emit(Events.MessageDelete, {
     id: data.id,
@@ -2980,7 +3021,11 @@ handlers.set("VOICE_SERVER_UPDATE", async (client, d) => {
   client.emit(Events.VoiceServerUpdate, d);
 });
 handlers.set("MESSAGE_DELETE_BULK", async (client, d) => {
-  client.emit(Events.MessageDeleteBulk, d);
+  const data = d;
+  for (const id of data.ids ?? []) {
+    client._removeMessageFromCache(data.channel_id, id);
+  }
+  client.emit(Events.MessageDeleteBulk, data);
 });
 handlers.set("GUILD_BAN_ADD", async (client, d) => {
   const data = d;
@@ -3138,6 +3183,10 @@ var Client = class extends EventEmitter3 {
   _ws = null;
   /** When waitForGuilds, set of guild IDs we're waiting for GUILD_CREATE on. Null when not waiting. */
   _pendingGuildIds = null;
+  /** Timeout for guild stream when READY has no guilds (gateway sends only GUILD_CREATE). Cleared in finally. */
+  _guildStreamSettleTimeout = null;
+  /** Per-channel message cache (channelId -> messageId -> APIMessage). Used when options.cache.messages > 0. */
+  _messageCaches = null;
   /**
    * Resolve an emoji argument to the API format (unicode or "name:id").
    * Supports: <:name:id>, :name:, name:id, { name, id }, unicode.
@@ -3226,11 +3275,52 @@ var Client = class extends EventEmitter3 {
   /**
    * Send a message to any channel by ID. Shorthand for client.channels.send().
    * Works even when the channel is not cached.
+   * @deprecated Use client.channels.send(channelId, payload).
    */
-  async sendToChannel(channelId, content) {
-    const payload = await Message._createMessageBody(content);
+  async sendToChannel(channelId, payload) {
+    emitDeprecationWarning3(
+      "Client.sendToChannel()",
+      "Use client.channels.send(channelId, payload)."
+    );
     return this.channels.send(channelId, payload);
   }
+  /**
+   * Get the message cache for a channel. Returns null if message caching is disabled.
+   * Used by MessageManager.get() and event handlers.
+   * @internal
+   */
+  _getMessageCache(channelId) {
+    const limit = this.options.cache?.messages ?? 0;
+    if (limit <= 0) return null;
+    if (!this._messageCaches) this._messageCaches = /* @__PURE__ */ new Map();
+    let cache = this._messageCaches.get(channelId);
+    if (!cache) {
+      cache = /* @__PURE__ */ new Map();
+      this._messageCaches.set(channelId, cache);
+    }
+    return cache;
+  }
+  /**
+   * Add a message to the channel cache. Evicts oldest (FIFO) when over limit.
+   * @internal
+   */
+  _addMessageToCache(channelId, data) {
+    const cache = this._getMessageCache(channelId);
+    if (!cache) return;
+    const limit = this.options.cache?.messages ?? 0;
+    if (limit > 0 && cache.size >= limit && !cache.has(data.id)) {
+      const firstKey = cache.keys().next().value;
+      if (firstKey !== void 0) cache.delete(firstKey);
+    }
+    cache.set(data.id, { ...data });
+  }
+  /**
+   * Remove a message from the channel cache.
+   * @internal
+   */
+  _removeMessageFromCache(channelId, messageId) {
+    this._messageCaches?.get(channelId)?.delete(messageId);
+  }
   /**
    * Get or create a User from API data. Caches in client.users.
    * Updates existing user's username, avatar, etc. when fresh data is provided.
@@ -3341,6 +3431,14 @@ var Client = class extends EventEmitter3 {
           this._pendingGuildIds = pending;
           return;
         }
+        if (waitForGuilds && (data.guilds ?? []).length === 0) {
+          const GUILD_STREAM_SETTLE_MS = 500;
+          this._guildStreamSettleTimeout = setTimeout(() => {
+            this._guildStreamSettleTimeout = null;
+            this._finalizeReady();
+          }, GUILD_STREAM_SETTLE_MS);
+          return;
+        }
         this._finalizeReady();
       }
     );
@@ -3370,6 +3468,10 @@ var Client = class extends EventEmitter3 {
   }
   /** Disconnect from the gateway and clear cached data. */
   async destroy() {
+    if (this._guildStreamSettleTimeout !== null) {
+      clearTimeout(this._guildStreamSettleTimeout);
+      this._guildStreamSettleTimeout = null;
+    }
     if (this._ws) {
       this._ws.destroy();
       this._ws = null;
@@ -3410,8 +3512,8 @@ import { EmbedBuilder as EmbedBuilder3, MessagePayload, AttachmentBuilder } from
 import { Routes as Routes21, GatewayOpcodes, MessageAttachmentFlags } from "@fluxerjs/types";
 import { resolveTenorToImageUrl, parseUserMention, parsePrefixCommand } from "@fluxerjs/util";
 import {
-  PermissionsBitField,
-  PermissionFlags as PermissionFlags3,
+  PermissionsBitField as PermissionsBitField2,
+  PermissionFlags as PermissionFlags5,
   resolvePermissionsToBitfield as resolvePermissionsToBitfield3,
   UserFlagsBitField,
   UserFlagsBits
@@ -3447,8 +3549,8 @@ export {
   MessageManager,
   MessagePayload,
   MessageReaction,
-  PermissionFlags3 as PermissionFlags,
-  PermissionsBitField,
+  PermissionFlags5 as PermissionFlags,
+  PermissionsBitField2 as PermissionsBitField,
   ReactionCollector,
   Role,
   Routes21 as Routes,

package/package.json

@@ -3,7 +3,7 @@
   "publishConfig": {
     "access": "public"
   },
-  "version": "1.2.2",
+  "version": "1.2.4",
   "description": "A fully-featured SDK for Fluxer bots",
   "repository": {
     "type": "git",
@@ -34,12 +34,12 @@
     "dist"
   ],
   "dependencies": {
-    "@fluxerjs/rest": "1.2.2",
-    "@fluxerjs/ws": "1.2.2",
-    "@fluxerjs/util": "1.2.2",
-    "@fluxerjs/collection": "1.2.2",
-    "@fluxerjs/builders": "1.2.2",
-    "@fluxerjs/types": "1.2.2"
+    "@fluxerjs/rest": "1.2.4",
+    "@fluxerjs/builders": "1.2.4",
+    "@fluxerjs/collection": "1.2.4",
+    "@fluxerjs/types": "1.2.4",
+    "@fluxerjs/util": "1.2.4",
+    "@fluxerjs/ws": "1.2.4"
   },
   "devDependencies": {
     "@types/node": "^20.0.0",
@@ -55,6 +55,6 @@
     "lint": "eslint src --max-warnings 0 --config ../../eslint.config.js",
     "lint:fix": "eslint src --fix --config ../../eslint.config.js",
     "test": "vitest run --passWithNoTests",
-    "test:coverage": "vitest run --coverage --passWithNoTests"
+    "test:coverage": "vitest run --coverage"
   }
 }