@fluxerjs/core 1.1.9 → 1.2.0

package/dist/{Channel-JFQXR7SZ.mjs → Channel-4YUSB2MM.mjs}

@@ -6,7 +6,7 @@ import {
   LinkChannel,
   TextChannel,
   VoiceChannel
-} from "./chunk-DJQXAQLR.mjs";
+} from "./chunk-IRDYSGQO.mjs";
 import "./chunk-6S3BDHBI.mjs";
 import "./chunk-AH7KYH2Z.mjs";
 import "./chunk-VJDH54HJ.mjs";

package/dist/{ClientUser-2OHUFUV5.mjs → ClientUser-ET7FW3XL.mjs}

@@ -1,6 +1,6 @@
 import {
   ClientUser
-} from "./chunk-JW4BRX5E.mjs";
+} from "./chunk-U33GNMEZ.mjs";
 import "./chunk-G6F6VL4O.mjs";
 import "./chunk-BKPVGBOT.mjs";
 import "./chunk-XNS4O6QJ.mjs";

package/dist/{Guild-3PLQFT2I.mjs → Guild-4U4U422Z.mjs}

@@ -1,6 +1,6 @@
 import {
   Guild
-} from "./chunk-4SWR3ZEZ.mjs";
+} from "./chunk-YGXCMETR.mjs";
 import "./chunk-6S3BDHBI.mjs";
 import "./chunk-24E6OQID.mjs";
 import "./chunk-G6F6VL4O.mjs";

package/dist/{Message-QNWAPT55.mjs → Message-R7KSI5YU.mjs}

@@ -1,6 +1,6 @@
 import {
   Message
-} from "./chunk-4OEOU7G7.mjs";
+} from "./chunk-HVCL7QLT.mjs";
 import "./chunk-AH7KYH2Z.mjs";
 import "./chunk-VJDH54HJ.mjs";
 import "./chunk-XNS4O6QJ.mjs";

package/dist/{MessageReaction-MUBQ6GIN.mjs → MessageReaction-EYO7AJTL.mjs}

@@ -1,6 +1,6 @@
 import {
   MessageReaction
-} from "./chunk-TDQUAKUL.mjs";
+} from "./chunk-75ODDXY3.mjs";
 import "./chunk-6S3BDHBI.mjs";
 import "./chunk-XNS4O6QJ.mjs";
 export {

package/dist/{Webhook-EARQN5EG.mjs → Webhook-LWYP2BMI.mjs}

@@ -1,6 +1,6 @@
 import {
   Webhook
-} from "./chunk-FHFXUKFP.mjs";
+} from "./chunk-3JVE6RW7.mjs";
 import "./chunk-VJDH54HJ.mjs";
 import "./chunk-G6F6VL4O.mjs";
 import "./chunk-BKPVGBOT.mjs";

package/dist/{chunk-FHFXUKFP.mjs → chunk-3JVE6RW7.mjs}

@@ -84,7 +84,7 @@ var Webhook = class _Webhook extends Base {
    * @throws Error if token is not available
    * @example
    * await webhook.send('Hello!');
-   * await webhook.send({ embeds: [embed.toJSON()] });
+   * await webhook.send({ embeds: [embed] });
    * await webhook.send({ content: 'File attached', files: [{ name: 'data.txt', data: buffer }] });
    * const msg = await webhook.send({ content: 'Hi' }, true);
    */
@@ -107,7 +107,7 @@ var Webhook = class _Webhook extends Base {
       postOptions
     );
     if (wait && data) {
-      const { Message } = await import("./Message-QNWAPT55.mjs");
+      const { Message } = await import("./Message-R7KSI5YU.mjs");
       return new Message(this.client, data);
     }
     return void 0;

package/dist/{chunk-TDQUAKUL.mjs → chunk-75ODDXY3.mjs}

@@ -41,7 +41,7 @@ var MessageReaction = class extends Base {
    */
   async fetchMessage() {
     try {
-      const { Message } = await import("./Message-QNWAPT55.mjs");
+      const { Message } = await import("./Message-R7KSI5YU.mjs");
       const data = await this.client.rest.get(
         Routes.channelMessage(this.channelId, this.messageId)
       );

package/dist/{chunk-4OEOU7G7.mjs → chunk-HVCL7QLT.mjs}

@@ -108,6 +108,21 @@ var Message = class _Message extends Base {
   get guild() {
     return this.guildId ? this.client.guilds.get(this.guildId) ?? null : null;
   }
+  /**
+   * Resolve the channel (from cache or API). Use when you need the channel and it may not be cached.
+   * @returns The channel
+   * @throws FluxerError with CHANNEL_NOT_FOUND if the channel does not exist
+   */
+  async resolveChannel() {
+    return this.client.channels.resolve(this.channelId);
+  }
+  /**
+   * Resolve the guild (from cache or API). Returns null for DMs.
+   * @returns The guild, or null if this is a DM or guild not found
+   */
+  async resolveGuild() {
+    return this.guildId ? this.client.guilds.resolve(this.guildId) : null;
+  }
   /** @param data - API message from POST/PATCH /channels/{id}/messages or gateway MESSAGE_CREATE */
   constructor(client, data) {
     super();
@@ -143,7 +158,7 @@ var Message = class _Message extends Base {
    * @param options - Text content or object with content, embeds, and/or files
    * @example
    * await message.send('Pong!');
-   * await message.send({ embeds: [embed.toJSON()] });
+   * await message.send({ embeds: [embed] }); // EmbedBuilder auto-converted
    * await message.send({ content: 'File', files: [{ name: 'data.txt', data }] });
    */
   async send(options) {
@@ -160,14 +175,17 @@ var Message = class _Message extends Base {
    * @param options - Text content or object with content and/or embeds
    * @example
    * await message.sendTo(logChannelId, 'User ' + message.author.username + ' said: ' + message.content);
-   * await message.sendTo(announceChannelId, { embeds: [embed.toJSON()] });
+   * await message.sendTo(announceChannelId, { embeds: [embed] });
    */
   async sendTo(channelId, options) {
     return this.client.channels.send(channelId, options);
   }
   /**
-   * Reply to this message.
+   * Reply to this message (shows as a reply in the client).
    * @param options - Text content or object with content, embeds, and/or files
+   * @example
+   * await message.reply('Pong!');
+   * await message.reply({ embeds: [embed] });
    */
   async reply(options) {
     const opts = typeof options === "string" ? { content: options } : options;

package/dist/{chunk-DJQXAQLR.mjs → chunk-IRDYSGQO.mjs}

@@ -29,7 +29,7 @@ var MessageManager = class {
    */
   async fetch(messageId) {
     try {
-      const { Message } = await import("./Message-QNWAPT55.mjs");
+      const { Message } = await import("./Message-R7KSI5YU.mjs");
       const data = await this.client.rest.get(
         Routes.channelMessage(this.channelId, messageId)
       );
@@ -200,7 +200,7 @@ var GuildChannel = class extends Channel {
    * @returns The webhook with token (required for send()). Requires Manage Webhooks permission.
    */
   async createWebhook(options) {
-    const { Webhook } = await import("./Webhook-EARQN5EG.mjs");
+    const { Webhook } = await import("./Webhook-LWYP2BMI.mjs");
     const data = await this.client.rest.post(Routes2.channelWebhooks(this.id), {
       body: options,
       auth: true
@@ -212,7 +212,7 @@ var GuildChannel = class extends Channel {
    * @returns Webhooks (includes token when listing from channel; can send via send())
    */
   async fetchWebhooks() {
-    const { Webhook } = await import("./Webhook-EARQN5EG.mjs");
+    const { Webhook } = await import("./Webhook-LWYP2BMI.mjs");
     const data = await this.client.rest.get(Routes2.channelWebhooks(this.id));
     const list = Array.isArray(data) ? data : Object.values(data ?? {});
     return list.map((w) => new Webhook(this.client, w));
@@ -325,7 +325,7 @@ var TextChannel = class extends GuildChannel {
   async send(options) {
     const opts = typeof options === "string" ? { content: options } : options;
     const body = buildSendBody(options);
-    const { Message } = await import("./Message-QNWAPT55.mjs");
+    const { Message } = await import("./Message-R7KSI5YU.mjs");
     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(Routes2.channelMessages(this.id), postOptions);
@@ -352,7 +352,7 @@ var TextChannel = class extends GuildChannel {
    * @returns Pinned messages
    */
   async fetchPinnedMessages() {
-    const { Message } = await import("./Message-QNWAPT55.mjs");
+    const { Message } = await import("./Message-R7KSI5YU.mjs");
     const data = await this.client.rest.get(Routes2.channelPins(this.id));
     const list = Array.isArray(data) ? data : data?.items ?? [];
     return list.map((item) => {
@@ -418,7 +418,7 @@ var DMChannel = class extends Channel {
   async send(options) {
     const opts = typeof options === "string" ? { content: options } : options;
     const body = buildSendBody(options);
-    const { Message } = await import("./Message-QNWAPT55.mjs");
+    const { Message } = await import("./Message-R7KSI5YU.mjs");
     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(Routes2.channelMessages(this.id), postOptions);
@@ -440,7 +440,7 @@ var DMChannel = class extends Channel {
    * @returns Pinned messages
    */
   async fetchPinnedMessages() {
-    const { Message } = await import("./Message-QNWAPT55.mjs");
+    const { Message } = await import("./Message-R7KSI5YU.mjs");
     const data = await this.client.rest.get(Routes2.channelPins(this.id));
     const list = Array.isArray(data) ? data : data?.items ?? [];
     return list.map((item) => {

package/dist/{chunk-JW4BRX5E.mjs → chunk-U33GNMEZ.mjs}

@@ -85,7 +85,7 @@ var User = class extends Base {
    * Returns the DM channel; use {@link DMChannel.send} to send messages.
    */
   async createDM() {
-    const { DMChannel: DMChannelClass } = await import("./Channel-JFQXR7SZ.mjs");
+    const { DMChannel: DMChannelClass } = await import("./Channel-4YUSB2MM.mjs");
     const data = await this.client.rest.post(Routes.userMeChannels(), {
       body: { recipient_id: this.id },
       auth: true
@@ -113,7 +113,7 @@ var ClientUser = class extends User {
    * @returns Array of Guild objects (cached in client.guilds)
    */
   async fetchGuilds() {
-    const { Guild } = await import("./Guild-3PLQFT2I.mjs");
+    const { Guild } = await import("./Guild-4U4U422Z.mjs");
     const data = await this.client.rest.get(Routes2.currentUserGuilds());
     const list = Array.isArray(data) ? data : data?.guilds ?? [];
     const guilds = [];

package/dist/{chunk-4SWR3ZEZ.mjs → chunk-YGXCMETR.mjs}

@@ -31,6 +31,19 @@ var GuildMemberManager = class extends Collection {
     super();
     this.guild = guild;
   }
+  /**
+   * Get a guild member from cache or fetch from the API if not present.
+   * Convenience helper to avoid repeating `guild.members.get(userId) ?? (await guild.fetchMember(userId))`.
+   * @param userId - Snowflake of the user
+   * @returns The guild member
+   * @throws FluxerError with MEMBER_NOT_FOUND if user is not in the guild (404)
+   * @example
+   * const member = await guild.members.resolve(userId);
+   * console.log(member.displayName);
+   */
+  async resolve(userId) {
+    return this.get(userId) ?? this.guild.fetchMember(userId);
+  }
   /**
    * The current bot user as a GuildMember in this guild.
    * Returns null if the bot's member is not cached or client.user is null.
@@ -372,7 +385,7 @@ var Guild = class extends Base {
   }
   /** Fetch all webhooks in this guild. Returned webhooks do not include the token (cannot send). */
   async fetchWebhooks() {
-    const { Webhook } = await import("./Webhook-EARQN5EG.mjs");
+    const { Webhook } = await import("./Webhook-LWYP2BMI.mjs");
     const data = await this.client.rest.get(Routes2.guildWebhooks(this.id));
     const list = Array.isArray(data) ? data : Object.values(data ?? {});
     return list.map((w) => new Webhook(this.client, w));
@@ -383,7 +396,7 @@ var Guild = class extends Base {
    * Requires Manage Channels permission.
    */
   async createChannel(data) {
-    const { Channel } = await import("./Channel-JFQXR7SZ.mjs");
+    const { Channel } = await import("./Channel-4YUSB2MM.mjs");
     const created = await this.client.rest.post(Routes2.guildChannels(this.id), {
       body: data,
       auth: true
@@ -400,7 +413,7 @@ var Guild = class extends Base {
    * @returns Array of GuildChannel objects (cached in guild.channels and client.channels)
    */
   async fetchChannels() {
-    const { Channel } = await import("./Channel-JFQXR7SZ.mjs");
+    const { Channel } = await import("./Channel-4YUSB2MM.mjs");
     const data = await this.client.rest.get(Routes2.guildChannels(this.id));
     const list = Array.isArray(data) ? data : Object.values(data ?? {});
     const channels = [];

package/dist/guildUtils-FTEGCNNJ.mjs

@@ -0,0 +1,17 @@
+// src/util/guildUtils.ts
+function normalizeGuildPayload(raw) {
+  if (!raw || typeof raw !== "object") {
+    return null;
+  }
+  if ("properties" in raw && raw.properties != null && typeof raw.properties === "object") {
+    const r = raw;
+    return {
+      ...r.properties,
+      roles: r.roles
+    };
+  }
+  return raw;
+}
+export {
+  normalizeGuildPayload
+};

package/dist/index.d.mts

@@ -2,7 +2,7 @@ import * as _fluxerjs_types from '@fluxerjs/types';
 import { APISticker, APIEmoji, APIEmbed, APIWebhook, APIWebhookUpdateRequest, APIWebhookTokenUpdateRequest, APIChannelOverwrite, APIChannel, APIChannelPartial, ChannelType, GatewayReactionEmoji, GatewayMessageReactionAddDispatchData, GatewayMessageReactionRemoveDispatchData, APIMessageAttachment, MessageType, APIMessageSticker, APIMessageReaction, APIMessageReference, APIMessageSnapshot, APIMessageCall, APIMessage, APIUserPartial, APIGuildMember, APIRole, RESTUpdateRoleBody, APIBan, GuildFeature, GuildVerificationLevel, DefaultMessageNotifications, GuildExplicitContentFilter, GuildMFALevel, APIGuild, RESTCreateRoleBody, APIGuildAuditLog, APIVanityURL, APIGuildPartial, APIInvite, GatewayPresenceUpdateData, APIProfileResponse, GatewayMessageReactionRemoveAllDispatchData, GatewayMessageReactionRemoveEmojiDispatchData, GatewayVoiceStateUpdateDispatchData, GatewayVoiceServerUpdateDispatchData, GatewayGuildEmojisUpdateDispatchData, GatewayGuildStickersUpdateDispatchData, GatewayGuildIntegrationsUpdateDispatchData, GatewayGuildScheduledEventCreateDispatchData, GatewayGuildScheduledEventUpdateDispatchData, GatewayGuildScheduledEventDeleteDispatchData, GatewayChannelPinsUpdateDispatchData, GatewayPresenceUpdateDispatchData, GatewayWebhooksUpdateDispatchData, APIInstance, GatewaySendPayload, Routes } from '@fluxerjs/types';
 export { GatewayOpcodes, MessageAttachmentFlags, Routes } from '@fluxerjs/types';
 import { PermissionResolvable } from '@fluxerjs/util';
-export { PermissionFlags, PermissionResolvable, PermissionString, PermissionsBitField, UserFlagsBitField, UserFlagsBits, UserFlagsResolvable, UserFlagsString, resolvePermissionsToBitfield, resolveTenorToImageUrl } from '@fluxerjs/util';
+export { PermissionFlags, PermissionResolvable, PermissionString, PermissionsBitField, UserFlagsBitField, UserFlagsBits, UserFlagsResolvable, UserFlagsString, parsePrefixCommand, parseUserMention, resolvePermissionsToBitfield, resolveTenorToImageUrl } from '@fluxerjs/util';
 import { Collection } from '@fluxerjs/collection';
 import { EmbedBuilder } from '@fluxerjs/builders';
 export { AttachmentBuilder, EmbedBuilder, MessagePayload } from '@fluxerjs/builders';
@@ -141,9 +141,12 @@ interface MessageAttachmentMeta {
     /** MessageAttachmentFlags: IS_SPOILER (8), CONTAINS_EXPLICIT_MEDIA (16), IS_ANIMATED (32) */
     flags?: number;
 }
-/** Options for sending a message (content, embeds, files). Used by Message.send, Channel.send, ChannelManager.send. */
+/** Options for sending a message (content, embeds, files). Used by Message.send, Channel.send, ChannelManager.send.
+ * EmbedBuilder instances are auto-converted to API format—no need to call .toJSON().
+ */
 type MessageSendOptions = string | {
     content?: string;
+    /** EmbedBuilder instances are auto-converted; raw APIEmbed also supported. */
     embeds?: (APIEmbed | EmbedBuilder)[];
     /** File attachments. When present, request uses multipart/form-data. */
     files?: MessageFileData[];
@@ -221,7 +224,7 @@ declare class Webhook extends Base {
      * @throws Error if token is not available
      * @example
      * await webhook.send('Hello!');
-     * await webhook.send({ embeds: [embed.toJSON()] });
+     * await webhook.send({ embeds: [embed] });
      * await webhook.send({ content: 'File attached', files: [{ name: 'data.txt', data: buffer }] });
      * const msg = await webhook.send({ content: 'Hi' }, true);
      */
@@ -570,6 +573,17 @@ declare class Message extends Base {
     get channel(): Channel | null;
     /** Guild where this message was sent. Resolved from cache; null for DMs or if not cached. */
     get guild(): Guild | null;
+    /**
+     * Resolve the channel (from cache or API). Use when you need the channel and it may not be cached.
+     * @returns The channel
+     * @throws FluxerError with CHANNEL_NOT_FOUND if the channel does not exist
+     */
+    resolveChannel(): Promise<Channel>;
+    /**
+     * Resolve the guild (from cache or API). Returns null for DMs.
+     * @returns The guild, or null if this is a DM or guild not found
+     */
+    resolveGuild(): Promise<Guild | null>;
     /** @param data - API message from POST/PATCH /channels/{id}/messages or gateway MESSAGE_CREATE */
     constructor(client: Client, data: APIMessage);
     /**
@@ -577,7 +591,7 @@ declare class Message extends Base {
      * @param options - Text content or object with content, embeds, and/or files
      * @example
      * await message.send('Pong!');
-     * await message.send({ embeds: [embed.toJSON()] });
+     * await message.send({ embeds: [embed] }); // EmbedBuilder auto-converted
      * await message.send({ content: 'File', files: [{ name: 'data.txt', data }] });
      */
     send(options: MessageSendOptions): Promise<Message>;
@@ -587,12 +601,15 @@ declare class Message extends Base {
      * @param options - Text content or object with content and/or embeds
      * @example
      * await message.sendTo(logChannelId, 'User ' + message.author.username + ' said: ' + message.content);
-     * await message.sendTo(announceChannelId, { embeds: [embed.toJSON()] });
+     * await message.sendTo(announceChannelId, { embeds: [embed] });
      */
     sendTo(channelId: string, options: MessageSendOptions): Promise<Message>;
     /**
-     * Reply to this message.
+     * Reply to this message (shows as a reply in the client).
      * @param options - Text content or object with content, embeds, and/or files
+     * @example
+     * await message.reply('Pong!');
+     * await message.reply({ embeds: [embed] });
      */
     reply(options: MessageSendOptions): Promise<Message>;
     /**
@@ -857,6 +874,17 @@ declare class GuildMember extends Base {
 declare class GuildMemberManager extends Collection<string, GuildMember> {
     private readonly guild;
     constructor(guild: Guild);
+    /**
+     * Get a guild member from cache or fetch from the API if not present.
+     * Convenience helper to avoid repeating `guild.members.get(userId) ?? (await guild.fetchMember(userId))`.
+     * @param userId - Snowflake of the user
+     * @returns The guild member
+     * @throws FluxerError with MEMBER_NOT_FOUND if user is not in the guild (404)
+     * @example
+     * const member = await guild.members.resolve(userId);
+     * console.log(member.displayName);
+     */
+    resolve(userId: string): Promise<GuildMember>;
     /**
      * The current bot user as a GuildMember in this guild.
      * Returns null if the bot's member is not cached or client.user is null.
@@ -1279,7 +1307,20 @@ interface PartialMessage {
  */
 declare class ChannelManager extends Collection<string, Channel> {
     private readonly client;
+    private readonly maxSize;
     constructor(client: Client);
+    set(key: string, value: Channel): this;
+    /**
+     * Get a channel from cache or fetch from the API if not present.
+     * Convenience helper to avoid repeating `client.channels.get(id) ?? (await client.channels.fetch(id))`.
+     * @param channelId - Snowflake of the channel
+     * @returns The channel
+     * @throws FluxerError with CHANNEL_NOT_FOUND if the channel does not exist
+     * @example
+     * const channel = await client.channels.resolve(message.channelId);
+     * if (channel?.isSendable()) await channel.send('Hello!');
+     */
+    resolve(channelId: string): Promise<Channel>;
     /**
      * Fetch a channel by ID from the API (or return from cache if present).
      * @param channelId - Snowflake of the channel
@@ -1296,9 +1337,9 @@ declare class ChannelManager extends Collection<string, Channel> {
      * @param messageId - Snowflake of the message
      * @returns The message
      * @throws FluxerError with MESSAGE_NOT_FOUND if the message does not exist
-     * @deprecated Use channel.messages.fetch(messageId). Prefer (await client.channels.fetch(channelId))?.messages?.fetch(messageId).
+     * @deprecated Use channel.messages.fetch(messageId). Prefer (await client.channels.resolve(channelId))?.messages?.fetch(messageId).
      * @example
-     * const channel = await client.channels.fetch(channelId);
+     * const channel = await client.channels.resolve(channelId);
      * const message = await channel?.messages?.fetch(messageId);
      */
     fetchMessage(channelId: string, messageId: string): Promise<Message>;
@@ -1310,7 +1351,7 @@ declare class ChannelManager extends Collection<string, Channel> {
      * @returns The created message
      * @example
      * await client.channels.send(logChannelId, 'User joined!');
-     * await client.channels.send(channelId, { embeds: [embed.toJSON()] });
+     * 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>;
@@ -1322,7 +1363,19 @@ declare class ChannelManager extends Collection<string, Channel> {
  */
 declare class GuildManager extends Collection<string, Guild> {
     private readonly client;
+    private readonly maxSize;
     constructor(client: Client);
+    set(key: string, value: Guild): this;
+    /**
+     * Get a guild from cache or fetch from the API if not present.
+     * Convenience helper to avoid repeating `client.guilds.get(id) ?? (await client.guilds.fetch(id))`.
+     * @param guildId - Snowflake of the guild
+     * @returns The guild, or null if not found
+     * @example
+     * const guild = await client.guilds.resolve(message.guildId);
+     * if (guild) console.log(guild.name);
+     */
+    resolve(guildId: string): Promise<Guild | null>;
     /**
      * Create a guild. POST /guilds.
      * @param options - name (required), icon (base64), empty_features
@@ -1344,9 +1397,20 @@ declare class GuildManager extends Collection<string, Guild> {
     fetch(guildId: string): Promise<Guild | null>;
 }
 
+/** Optional cache size limits. When exceeded, oldest entries are evicted (FIFO). Omit or use 0 for unbounded. */
+interface CacheSizeLimits {
+    channels?: number;
+    guilds?: number;
+    users?: number;
+}
 interface ClientOptions {
     rest?: Partial<ConstructorParameters<typeof REST>[0]>;
+    /** Gateway intents. Not yet supported by Fluxer—value is always sent as 0. Set suppressIntentWarning to silence the warning. */
     intents?: number;
+    /** Suppress the warning when intents are set (Fluxer does not support intents yet). */
+    suppressIntentWarning?: boolean;
+    /** Cache size limits (channels, guilds, users). When exceeded, oldest entries are evicted. Omit or 0 = unbounded. */
+    cache?: CacheSizeLimits;
     /** Initial presence (status, custom_status, etc.) sent on identify. Can also update via PresenceUpdate after connect. */
     presence?: GatewayPresenceUpdateData;
     /** Optional WebSocket constructor (e.g. `require('ws')` in Node for compatibility) */
@@ -1446,7 +1510,9 @@ interface FetchedUserWithProfile {
  */
 declare class UsersManager extends Collection<string, User> {
     private readonly client;
+    private readonly maxSize;
     constructor(client: Client);
+    set(key: string, value: User): this;
     /**
      * Fetch a user by ID from the API.
      * Updates cache if user already exists.
@@ -1609,9 +1675,9 @@ declare class Client extends EventEmitter {
      * @param messageId - Snowflake of the message
      * @returns The message
      * @throws FluxerError with MESSAGE_NOT_FOUND if the message does not exist
-     * @deprecated Use channel.messages.fetch(messageId). For IDs-only: (await client.channels.fetch(channelId))?.messages?.fetch(messageId)
+     * @deprecated Use channel.messages.fetch(messageId). For IDs-only: (await client.channels.resolve(channelId))?.messages?.fetch(messageId)
      * @example
-     * const channel = await client.channels.fetch(channelId);
+     * const channel = await client.channels.resolve(channelId);
      * const message = await channel?.messages?.fetch(messageId);
      */
     fetchMessage(channelId: string, messageId: string): Promise<Message>;
@@ -1648,6 +1714,13 @@ declare class Client extends EventEmitter {
     isReady(): this is Client & {
         user: NonNullable<Client['user']>;
     };
+    /**
+     * Throws if the client is not ready. Use before accessing client.user or other post-ready state.
+     * @throws FluxerError with CLIENT_NOT_READY if client has not received Ready yet
+     */
+    assertReady(): asserts this is Client & {
+        user: NonNullable<Client['user']>;
+    };
     static get Routes(): typeof Routes;
 }