@fluxerjs/core 1.2.1 → 1.2.2

package/dist/index.d.mts

@@ -9,6 +9,12 @@ export { AttachmentBuilder, EmbedBuilder, MessagePayload } from '@fluxerjs/build
 import { PermissionResolvable } 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. */
+interface ResolvedMessageFile {
+    name: string;
+    data: Blob | ArrayBuffer | Uint8Array | Buffer;
+    filename?: string;
+}
 /** File data for message attachment uploads. Use `data` for buffers or `url` to fetch from a URL. */
 type MessageFileData = {
     name: string;
@@ -31,7 +37,7 @@ interface MessageAttachmentMeta {
 /** 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 | {
+type MessageSendOptions = {
     content?: string;
     /** EmbedBuilder instances are auto-converted; raw APIEmbed also supported. */
     embeds?: (APIEmbed | EmbedBuilder)[];
@@ -40,6 +46,18 @@ type MessageSendOptions = string | {
     /** Attachment metadata for files (id = index). Use when files are provided. */
     attachments?: MessageAttachmentMeta[];
 };
+/** API-ready body from MessageSendOptions (serializes EmbedBuilder, includes attachments when files present). */
+interface SendBodyResult {
+    content?: string;
+    embeds?: APIEmbed[];
+    attachments?: Array<{
+        id: number;
+        filename: string;
+        title?: string | null;
+        description?: string | null;
+        flags?: number;
+    }>;
+}
 
 /** Base class for all Fluxer structures. Provides the client reference. */
 declare abstract class Base {
@@ -908,6 +926,12 @@ interface MessageEditOptions {
     /** New embeds (replaces existing) */
     embeds?: (APIEmbed | EmbedBuilder)[];
 }
+type MessagePayload = {
+    files?: ResolvedMessageFile[];
+    body: SendBodyResult & {
+        referenced_message?: APIMessageReference;
+    };
+};
 
 /** Represents a message in a channel. */
 declare class Message extends Base {
@@ -940,8 +964,11 @@ declare class Message extends Base {
     readonly mentionRoles: string[];
     /** Client-side nonce for acknowledgment. Null if not provided. */
     readonly nonce: string | null;
-    /** Channel where this message was sent. Resolved from cache; null if not cached (e.g. DM channel not in cache). */
-    get channel(): Channel | null;
+    /**
+     * Channel where this message was sent. Resolved from cache; null if not cached.
+     * Messages can only exist in text-based channels (text, DM, announcement), so this always has send() when non-null.
+     */
+    get channel(): (TextChannel | DMChannel | GuildChannel) | null;
     /** Guild where this message was sent. Resolved from cache; null for DMs or if not cached. */
     get guild(): Guild | null;
     /**
@@ -965,7 +992,7 @@ declare class Message extends Base {
      * await message.send({ embeds: [embed] }); // EmbedBuilder auto-converted
      * await message.send({ content: 'File', files: [{ name: 'data.txt', data }] });
      */
-    send(options: MessageSendOptions): Promise<Message>;
+    send(options: string | MessageSendOptions): Promise<Message>;
     /**
      * Send a message to a specific channel. Use for logging, forwarding, or sending to another channel in the guild.
      * @param channelId - Snowflake of the target channel (e.g. log channel ID)
@@ -982,7 +1009,14 @@ declare class Message extends Base {
      * await message.reply('Pong!');
      * await message.reply({ embeds: [embed] });
      */
-    reply(options: MessageSendOptions): Promise<Message>;
+    reply(options: string | MessageSendOptions): 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>;
+    _send(payload: MessagePayload): Promise<Message>;
     /**
      * Edit this message. Only the author (or admins) can edit.
      * @param options - New content and/or embeds
@@ -1162,11 +1196,12 @@ declare class Invite extends Base {
 /** Base class for all channel types. */
 declare abstract class Channel extends Base {
     /** Whether this channel has a send method (TextChannel, DMChannel). */
-    isSendable(): this is TextChannel | DMChannel;
+    isTextBased(): this is TextChannel | DMChannel;
     /** Whether this channel is a DM or Group DM. */
-    isDM(): boolean;
+    isDM(): this is DMChannel;
     /** Whether this channel is voice-based (VoiceChannel). */
-    isVoice(): boolean;
+    isVoice(): this is VoiceChannel;
+    isLink(): this is LinkChannel;
     /** Create a DM channel from API data (type DM or GroupDM). */
     static createDM(client: Client, data: APIChannelPartial): DMChannel;
     readonly client: Client;
@@ -1200,6 +1235,12 @@ declare abstract class Channel extends Base {
      * Send a typing indicator to the channel. Lasts ~10 seconds.
      */
     sendTyping(): Promise<void>;
+    /**
+     * Whether the bot can send messages in this channel.
+     * For DMs: always true (when the channel exists).
+     * For guild channels: checks ViewChannel and SendMessages permissions via guild.members.me.
+     */
+    canSendMessage(): boolean;
 }
 declare class GuildChannel extends Channel {
     readonly guildId: string;
@@ -1249,6 +1290,17 @@ declare class GuildChannel extends Channel {
         allow?: string;
         deny?: string;
     }): Promise<void>;
+    /**
+     * Whether the bot can send messages in this channel.
+     * Checks ViewChannel and SendMessages via guild.members.me permissions.
+     * Returns false if guild or bot member not cached.
+     */
+    canSendMessage(): boolean;
+    /**
+     * Send a message to this guild channel.
+     * Works for text and announcement channels. Voice/category/link channels will fail at the API.
+     */
+    send(options: MessageSendOptions): Promise<Message>;
     /**
      * Remove a permission overwrite. DELETE /channels/{id}/permissions/{overwriteId}.
      */
@@ -1326,7 +1378,7 @@ declare class VoiceChannel extends GuildChannel {
     constructor(client: Client, data: APIChannel);
 }
 declare class LinkChannel extends GuildChannel {
-    url?: string | null;
+    url: string | null;
     constructor(client: Client, data: APIChannel);
 }
 /** DM channel (direct message between bot and a user). */
@@ -1395,7 +1447,7 @@ declare class ChannelManager extends Collection<string, Channel | GuildChannel>
      * @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!');
+     * if (channel?.isTextBased()) await channel.send('Hello!');
      */
     resolve(channelId: string): Promise<Channel>;
     /**
@@ -1405,7 +1457,7 @@ declare class ChannelManager extends Collection<string, Channel | GuildChannel>
      * @throws FluxerError with CHANNEL_NOT_FOUND if the channel does not exist
      * @example
      * const channel = await client.channels.fetch(channelId);
-     * if (channel?.isSendable()) await channel.send('Hello!');
+     * if (channel?.isTextBased()) await channel.send('Hello!');
      */
     fetch(channelId: string): Promise<Channel>;
     /**
@@ -1486,6 +1538,8 @@ interface ClientOptions {
     intents?: number;
     /** Suppress the warning when intents are set (Fluxer does not support intents yet). */
     suppressIntentWarning?: boolean;
+    /** When true, delay the Ready event until all guilds from READY (including unavailable) have been received via GUILD_CREATE. Default: false. */
+    waitForGuilds?: 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. */
@@ -1720,6 +1774,8 @@ declare class Client extends EventEmitter {
     /** Timestamp when the client became ready. Null until READY is received. */
     readyAt: Date | null;
     private _ws;
+    /** When waitForGuilds, set of guild IDs we're waiting for GUILD_CREATE on. Null when not waiting. */
+    _pendingGuildIds: Set<string> | null;
     /** @param options - Token, REST config, WebSocket, presence, etc. */
     constructor(options?: ClientOptions);
     /**
@@ -1763,7 +1819,7 @@ 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.
      */
-    sendToChannel(channelId: string, payload: string | {
+    sendToChannel(channelId: string, content: string | {
         content?: string;
         embeds?: APIEmbed[];
     }): Promise<Message>;
@@ -1786,6 +1842,16 @@ declare class Client extends EventEmitter {
      * @param token - Bot token (e.g. from FLUXER_BOT_TOKEN)
      */
     login(token: string): Promise<string>;
+    /**
+     * Called when all guilds have been received (or immediately if not waiting).
+     * Sets readyAt, emits Ready, clears pending state.
+     */
+    _finalizeReady(): void;
+    /**
+     * Called by GUILD_CREATE handler when waitForGuilds is enabled.
+     * Removes guild from pending set; when empty, finalizes ready.
+     */
+    _onGuildReceived(guildId: string): void;
     /** Disconnect from the gateway and clear cached data. */
     destroy(): Promise<void>;
     /** Returns true if the client has received Ready and `user` is set. */

package/dist/index.d.ts

@@ -9,6 +9,12 @@ export { AttachmentBuilder, EmbedBuilder, MessagePayload } from '@fluxerjs/build
 import { PermissionResolvable } 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. */
+interface ResolvedMessageFile {
+    name: string;
+    data: Blob | ArrayBuffer | Uint8Array | Buffer;
+    filename?: string;
+}
 /** File data for message attachment uploads. Use `data` for buffers or `url` to fetch from a URL. */
 type MessageFileData = {
     name: string;
@@ -31,7 +37,7 @@ interface MessageAttachmentMeta {
 /** 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 | {
+type MessageSendOptions = {
     content?: string;
     /** EmbedBuilder instances are auto-converted; raw APIEmbed also supported. */
     embeds?: (APIEmbed | EmbedBuilder)[];
@@ -40,6 +46,18 @@ type MessageSendOptions = string | {
     /** Attachment metadata for files (id = index). Use when files are provided. */
     attachments?: MessageAttachmentMeta[];
 };
+/** API-ready body from MessageSendOptions (serializes EmbedBuilder, includes attachments when files present). */
+interface SendBodyResult {
+    content?: string;
+    embeds?: APIEmbed[];
+    attachments?: Array<{
+        id: number;
+        filename: string;
+        title?: string | null;
+        description?: string | null;
+        flags?: number;
+    }>;
+}
 
 /** Base class for all Fluxer structures. Provides the client reference. */
 declare abstract class Base {
@@ -908,6 +926,12 @@ interface MessageEditOptions {
     /** New embeds (replaces existing) */
     embeds?: (APIEmbed | EmbedBuilder)[];
 }
+type MessagePayload = {
+    files?: ResolvedMessageFile[];
+    body: SendBodyResult & {
+        referenced_message?: APIMessageReference;
+    };
+};
 
 /** Represents a message in a channel. */
 declare class Message extends Base {
@@ -940,8 +964,11 @@ declare class Message extends Base {
     readonly mentionRoles: string[];
     /** Client-side nonce for acknowledgment. Null if not provided. */
     readonly nonce: string | null;
-    /** Channel where this message was sent. Resolved from cache; null if not cached (e.g. DM channel not in cache). */
-    get channel(): Channel | null;
+    /**
+     * Channel where this message was sent. Resolved from cache; null if not cached.
+     * Messages can only exist in text-based channels (text, DM, announcement), so this always has send() when non-null.
+     */
+    get channel(): (TextChannel | DMChannel | GuildChannel) | null;
     /** Guild where this message was sent. Resolved from cache; null for DMs or if not cached. */
     get guild(): Guild | null;
     /**
@@ -965,7 +992,7 @@ declare class Message extends Base {
      * await message.send({ embeds: [embed] }); // EmbedBuilder auto-converted
      * await message.send({ content: 'File', files: [{ name: 'data.txt', data }] });
      */
-    send(options: MessageSendOptions): Promise<Message>;
+    send(options: string | MessageSendOptions): Promise<Message>;
     /**
      * Send a message to a specific channel. Use for logging, forwarding, or sending to another channel in the guild.
      * @param channelId - Snowflake of the target channel (e.g. log channel ID)
@@ -982,7 +1009,14 @@ declare class Message extends Base {
      * await message.reply('Pong!');
      * await message.reply({ embeds: [embed] });
      */
-    reply(options: MessageSendOptions): Promise<Message>;
+    reply(options: string | MessageSendOptions): 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>;
+    _send(payload: MessagePayload): Promise<Message>;
     /**
      * Edit this message. Only the author (or admins) can edit.
      * @param options - New content and/or embeds
@@ -1162,11 +1196,12 @@ declare class Invite extends Base {
 /** Base class for all channel types. */
 declare abstract class Channel extends Base {
     /** Whether this channel has a send method (TextChannel, DMChannel). */
-    isSendable(): this is TextChannel | DMChannel;
+    isTextBased(): this is TextChannel | DMChannel;
     /** Whether this channel is a DM or Group DM. */
-    isDM(): boolean;
+    isDM(): this is DMChannel;
     /** Whether this channel is voice-based (VoiceChannel). */
-    isVoice(): boolean;
+    isVoice(): this is VoiceChannel;
+    isLink(): this is LinkChannel;
     /** Create a DM channel from API data (type DM or GroupDM). */
     static createDM(client: Client, data: APIChannelPartial): DMChannel;
     readonly client: Client;
@@ -1200,6 +1235,12 @@ declare abstract class Channel extends Base {
      * Send a typing indicator to the channel. Lasts ~10 seconds.
      */
     sendTyping(): Promise<void>;
+    /**
+     * Whether the bot can send messages in this channel.
+     * For DMs: always true (when the channel exists).
+     * For guild channels: checks ViewChannel and SendMessages permissions via guild.members.me.
+     */
+    canSendMessage(): boolean;
 }
 declare class GuildChannel extends Channel {
     readonly guildId: string;
@@ -1249,6 +1290,17 @@ declare class GuildChannel extends Channel {
         allow?: string;
         deny?: string;
     }): Promise<void>;
+    /**
+     * Whether the bot can send messages in this channel.
+     * Checks ViewChannel and SendMessages via guild.members.me permissions.
+     * Returns false if guild or bot member not cached.
+     */
+    canSendMessage(): boolean;
+    /**
+     * Send a message to this guild channel.
+     * Works for text and announcement channels. Voice/category/link channels will fail at the API.
+     */
+    send(options: MessageSendOptions): Promise<Message>;
     /**
      * Remove a permission overwrite. DELETE /channels/{id}/permissions/{overwriteId}.
      */
@@ -1326,7 +1378,7 @@ declare class VoiceChannel extends GuildChannel {
     constructor(client: Client, data: APIChannel);
 }
 declare class LinkChannel extends GuildChannel {
-    url?: string | null;
+    url: string | null;
     constructor(client: Client, data: APIChannel);
 }
 /** DM channel (direct message between bot and a user). */
@@ -1395,7 +1447,7 @@ declare class ChannelManager extends Collection<string, Channel | GuildChannel>
      * @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!');
+     * if (channel?.isTextBased()) await channel.send('Hello!');
      */
     resolve(channelId: string): Promise<Channel>;
     /**
@@ -1405,7 +1457,7 @@ declare class ChannelManager extends Collection<string, Channel | GuildChannel>
      * @throws FluxerError with CHANNEL_NOT_FOUND if the channel does not exist
      * @example
      * const channel = await client.channels.fetch(channelId);
-     * if (channel?.isSendable()) await channel.send('Hello!');
+     * if (channel?.isTextBased()) await channel.send('Hello!');
      */
     fetch(channelId: string): Promise<Channel>;
     /**
@@ -1486,6 +1538,8 @@ interface ClientOptions {
     intents?: number;
     /** Suppress the warning when intents are set (Fluxer does not support intents yet). */
     suppressIntentWarning?: boolean;
+    /** When true, delay the Ready event until all guilds from READY (including unavailable) have been received via GUILD_CREATE. Default: false. */
+    waitForGuilds?: 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. */
@@ -1720,6 +1774,8 @@ declare class Client extends EventEmitter {
     /** Timestamp when the client became ready. Null until READY is received. */
     readyAt: Date | null;
     private _ws;
+    /** When waitForGuilds, set of guild IDs we're waiting for GUILD_CREATE on. Null when not waiting. */
+    _pendingGuildIds: Set<string> | null;
     /** @param options - Token, REST config, WebSocket, presence, etc. */
     constructor(options?: ClientOptions);
     /**
@@ -1763,7 +1819,7 @@ 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.
      */
-    sendToChannel(channelId: string, payload: string | {
+    sendToChannel(channelId: string, content: string | {
         content?: string;
         embeds?: APIEmbed[];
     }): Promise<Message>;
@@ -1786,6 +1842,16 @@ declare class Client extends EventEmitter {
      * @param token - Bot token (e.g. from FLUXER_BOT_TOKEN)
      */
     login(token: string): Promise<string>;
+    /**
+     * Called when all guilds have been received (or immediately if not waiting).
+     * Sets readyAt, emits Ready, clears pending state.
+     */
+    _finalizeReady(): void;
+    /**
+     * Called by GUILD_CREATE handler when waitForGuilds is enabled.
+     * Removes guild from pending set; when empty, finalizes ready.
+     */
+    _onGuildReceived(guildId: string): void;
     /** Disconnect from the gateway and clear cached data. */
     destroy(): Promise<void>;
     /** Returns true if the client has received Ready and `user` is set. */

package/dist/index.js

@@ -50,16 +50,16 @@ __export(index_exports, {
   MessageManager: () => MessageManager,
   MessagePayload: () => import_builders3.MessagePayload,
   MessageReaction: () => MessageReaction,
-  PermissionFlags: () => import_util9.PermissionFlags,
-  PermissionsBitField: () => import_util9.PermissionsBitField,
+  PermissionFlags: () => import_util10.PermissionFlags,
+  PermissionsBitField: () => import_util10.PermissionsBitField,
   ReactionCollector: () => ReactionCollector,
   Role: () => Role,
   Routes: () => import_types22.Routes,
   STATIC_CDN_URL: () => STATIC_CDN_URL,
   TextChannel: () => TextChannel,
   User: () => User,
-  UserFlagsBitField: () => import_util9.UserFlagsBitField,
-  UserFlagsBits: () => import_util9.UserFlagsBits,
+  UserFlagsBitField: () => import_util10.UserFlagsBitField,
+  UserFlagsBits: () => import_util10.UserFlagsBits,
   UsersManager: () => UsersManager,
   VoiceChannel: () => VoiceChannel,
   Webhook: () => Webhook,
@@ -69,10 +69,10 @@ __export(index_exports, {
   cdnDisplayAvatarURL: () => cdnDisplayAvatarURL,
   cdnMemberAvatarURL: () => cdnMemberAvatarURL,
   cdnMemberBannerURL: () => cdnMemberBannerURL,
-  parsePrefixCommand: () => import_util8.parsePrefixCommand,
-  parseUserMention: () => import_util8.parseUserMention,
-  resolvePermissionsToBitfield: () => import_util9.resolvePermissionsToBitfield,
-  resolveTenorToImageUrl: () => import_util8.resolveTenorToImageUrl
+  parsePrefixCommand: () => import_util9.parsePrefixCommand,
+  parseUserMention: () => import_util9.parseUserMention,
+  resolvePermissionsToBitfield: () => import_util10.resolvePermissionsToBitfield,
+  resolveTenorToImageUrl: () => import_util9.resolveTenorToImageUrl
 });
 module.exports = __toCommonJS(index_exports);
 
@@ -85,7 +85,7 @@ var import_types21 = require("@fluxerjs/types");
 // src/client/ChannelManager.ts
 var import_collection4 = require("@fluxerjs/collection");
 var import_types6 = require("@fluxerjs/types");
-var import_util2 = require("@fluxerjs/util");
+var import_util3 = require("@fluxerjs/util");
 var import_rest2 = require("@fluxerjs/rest");
 
 // src/errors/FluxerError.ts
@@ -313,7 +313,10 @@ var Message = class _Message extends Base {
   mentionRoles;
   /** Client-side nonce for acknowledgment. Null if not provided. */
   nonce;
-  /** Channel where this message was sent. Resolved from cache; null if not cached (e.g. DM channel not in cache). */
+  /**
+   * Channel where this message was sent. Resolved from cache; null if not cached.
+   * Messages can only exist in text-based channels (text, DM, announcement), so this always has send() when non-null.
+   */
   get channel() {
     return this.client.channels.get(this.channelId) ?? null;
   }
@@ -375,12 +378,8 @@ var Message = class _Message extends Base {
    * await message.send({ content: 'File', files: [{ name: 'data.txt', data }] });
    */
   async send(options) {
-    const opts = typeof options === "string" ? { content: options } : options;
-    const body = buildSendBody(options);
-    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_types.Routes.channelMessages(this.channelId), postOptions);
-    return new _Message(this.client, data);
+    const payload = await _Message._createMessageBody(options);
+    return this._send(payload);
   }
   /**
    * Send a message to a specific channel. Use for logging, forwarding, or sending to another channel in the guild.
@@ -401,19 +400,30 @@ var Message = class _Message extends Base {
    * await message.reply({ embeds: [embed] });
    */
   async reply(options) {
-    const opts = typeof options === "string" ? { content: options } : options;
-    const base = buildSendBody(options);
-    const body = {
-      ...base,
-      message_reference: {
-        channel_id: this.channelId,
-        message_id: this.id,
-        guild_id: this.guildId ?? void 0
+    const payload = await _Message._createMessageBody(options, {
+      channel_id: this.channelId,
+      message_id: this.id,
+      guild_id: this.guildId ?? void 0
+    });
+    return this._send(payload);
+  }
+  /** Exposed for testing purposes, use Message.reply() or send() for normal use */
+  static async _createMessageBody(content, referenced_message) {
+    if (typeof content === "string") {
+      if (content.length === 0) {
+        throw new RangeError("Cannot send an empty message");
       }
-    };
-    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_types.Routes.channelMessages(this.channelId), postOptions);
+      content = { content };
+    }
+    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 } };
+  }
+  async _send(payload) {
+    const data = await this.client.rest.post(
+      import_types.Routes.channelMessages(this.channelId),
+      payload
+    );
     return new _Message(this.client, data);
   }
   /**
@@ -630,6 +640,7 @@ var MessageCollector = class extends import_events2.EventEmitter {
 // src/structures/Channel.ts
 var import_types5 = require("@fluxerjs/types");
 var import_util = require("@fluxerjs/util");
+var import_util2 = require("@fluxerjs/util");
 
 // src/structures/Webhook.ts
 var import_types3 = require("@fluxerjs/types");
@@ -764,7 +775,7 @@ var Webhook = class _Webhook extends Base {
       );
     }
     const opts = typeof options === "string" ? { content: options } : options;
-    const body = buildSendBody(options);
+    const body = buildSendBody(opts);
     if (opts.username !== void 0) body.username = opts.username;
     if (opts.avatar_url !== void 0) body.avatar_url = opts.avatar_url;
     if (opts.tts !== void 0) body.tts = opts.tts;
@@ -865,7 +876,7 @@ var Invite = class extends Base {
 // src/structures/Channel.ts
 var Channel = class _Channel extends Base {
   /** Whether this channel has a send method (TextChannel, DMChannel). */
-  isSendable() {
+  isTextBased() {
     return "send" in this;
   }
   /** Whether this channel is a DM or Group DM. */
@@ -876,6 +887,9 @@ var Channel = class _Channel extends Base {
   isVoice() {
     return "bitrate" in this;
   }
+  isLink() {
+    return "url" in this;
+  }
   /** Create a DM channel from API data (type DM or GroupDM). */
   static createDM(client, data) {
     return new DMChannel(client, data);
@@ -939,6 +953,15 @@ var Channel = class _Channel extends Base {
   async sendTyping() {
     await this.client.rest.post(import_types5.Routes.channelTyping(this.id), { auth: true });
   }
+  /**
+   * Whether the bot can send messages in this channel.
+   * For DMs: always true (when the channel exists).
+   * For guild channels: checks ViewChannel and SendMessages permissions via guild.members.me.
+   */
+  canSendMessage() {
+    if (this.isDM()) return true;
+    return false;
+  }
 };
 var GuildChannel = class extends Channel {
   guildId;
@@ -1022,6 +1045,31 @@ var GuildChannel = class extends Channel {
     if (idx >= 0) this.permissionOverwrites[idx] = entry;
     else this.permissionOverwrites.push(entry);
   }
+  /**
+   * Whether the bot can send messages in this channel.
+   * Checks ViewChannel and SendMessages via guild.members.me permissions.
+   * Returns false if guild or bot member not cached.
+   */
+  canSendMessage() {
+    const guild = this.client.guilds.get(this.guildId);
+    if (!guild) return false;
+    const me = guild.members.me;
+    if (!me) return false;
+    const perms = me.permissionsIn(this);
+    return perms.has(import_util.PermissionFlags.ViewChannel) && perms.has(import_util.PermissionFlags.SendMessages);
+  }
+  /**
+   * Send a message to this guild channel.
+   * Works for text and announcement channels. Voice/category/link channels will fail at the API.
+   */
+  async send(options) {
+    const opts = typeof options === "string" ? { content: options } : options;
+    const body = buildSendBody(options);
+    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);
+    return new Message(this.client, data);
+  }
   /**
    * Remove a permission overwrite. DELETE /channels/{id}/permissions/{overwriteId}.
    */
@@ -1122,7 +1170,7 @@ var TextChannel = class extends GuildChannel {
    * @deprecated Use channel.messages.fetch(messageId) instead.
    */
   async fetchMessage(messageId) {
-    (0, import_util.emitDeprecationWarning)(
+    (0, import_util2.emitDeprecationWarning)(
       "Channel.fetchMessage()",
       "Use channel.messages.fetch(messageId) instead."
     );
@@ -1208,7 +1256,7 @@ var DMChannel = class extends Channel {
    * @deprecated Use channel.messages.fetch(messageId) instead.
    */
   async fetchMessage(messageId) {
-    (0, import_util.emitDeprecationWarning)(
+    (0, import_util2.emitDeprecationWarning)(
       "Channel.fetchMessage()",
       "Use channel.messages.fetch(messageId) instead."
     );
@@ -1259,7 +1307,7 @@ var ChannelManager = class extends import_collection4.Collection {
    * @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!');
+   * if (channel?.isTextBased()) await channel.send('Hello!');
    */
   async resolve(channelId) {
     return this.get(channelId) ?? this.fetch(channelId);
@@ -1271,7 +1319,7 @@ var ChannelManager = class extends import_collection4.Collection {
    * @throws FluxerError with CHANNEL_NOT_FOUND if the channel does not exist
    * @example
    * const channel = await client.channels.fetch(channelId);
-   * if (channel?.isSendable()) await channel.send('Hello!');
+   * if (channel?.isTextBased()) await channel.send('Hello!');
    */
   async fetch(channelId) {
     const cached = this.get(channelId);
@@ -1313,7 +1361,7 @@ var ChannelManager = class extends import_collection4.Collection {
    * const message = await channel?.messages?.fetch(messageId);
    */
   async fetchMessage(channelId, messageId) {
-    (0, import_util2.emitDeprecationWarning)(
+    (0, import_util3.emitDeprecationWarning)(
       "ChannelManager.fetchMessage()",
       "Use channel.messages.fetch(messageId). Prefer (await client.channels.resolve(channelId))?.messages?.fetch(messageId)."
     );
@@ -1359,7 +1407,7 @@ var import_collection8 = require("@fluxerjs/collection");
 var import_types16 = require("@fluxerjs/types");
 
 // src/structures/Guild.ts
-var import_util6 = require("@fluxerjs/util");
+var import_util7 = require("@fluxerjs/util");
 var import_rest3 = require("@fluxerjs/rest");
 var import_collection7 = require("@fluxerjs/collection");
 
@@ -1368,14 +1416,14 @@ var import_collection6 = require("@fluxerjs/collection");
 var import_types10 = require("@fluxerjs/types");
 
 // src/structures/GuildMember.ts
-var import_util4 = require("@fluxerjs/util");
+var import_util5 = require("@fluxerjs/util");
 var import_types9 = require("@fluxerjs/types");
 
 // src/util/permissions.ts
 var import_types7 = require("@fluxerjs/types");
-var import_util3 = require("@fluxerjs/util");
+var import_util4 = require("@fluxerjs/util");
 function computePermissions(basePermissions, overwrites, memberRoles, memberId, isOwner) {
-  if (isOwner) return import_util3.ALL_PERMISSIONS_BIGINT;
+  if (isOwner) return import_util4.ALL_PERMISSIONS_BIGINT;
   let perms = basePermissions;
   for (const overwrite of overwrites ?? []) {
     const applies = overwrite.type === import_types7.OverwriteType.Role && memberRoles.includes(overwrite.id) || overwrite.type === import_types7.OverwriteType.Member && overwrite.id === memberId;
@@ -1593,7 +1641,7 @@ var GuildMember = class extends Base {
     const perms = computePermissions(base, [], [], this.id, isOwner);
     return {
       has(permission) {
-        const perm = typeof permission === "number" ? permission : import_util4.PermissionFlagsMap[String(permission)];
+        const perm = typeof permission === "number" ? permission : import_util5.PermissionFlagsMap[String(permission)];
         if (perm === void 0) return false;
         return hasPermission(perms, BigInt(perm));
       }
@@ -1621,7 +1669,7 @@ var GuildMember = class extends Base {
     );
     return {
       has(permission) {
-        const perm = typeof permission === "number" ? permission : import_util4.PermissionFlagsMap[String(permission)];
+        const perm = typeof permission === "number" ? permission : import_util5.PermissionFlagsMap[String(permission)];
         if (perm === void 0) return false;
         return hasPermission(perms, BigInt(perm));
       }
@@ -1718,7 +1766,7 @@ var GuildMemberManager = class extends import_collection6.Collection {
 
 // src/structures/Role.ts
 var import_types11 = require("@fluxerjs/types");
-var import_util5 = require("@fluxerjs/util");
+var import_util6 = require("@fluxerjs/util");
 var Role = class extends Base {
   client;
   id;
@@ -1773,13 +1821,13 @@ var Role = class extends Base {
    * if (role.has('ManageChannels')) { ... }
    */
   has(permission) {
-    const perm = typeof permission === "number" ? permission : import_util5.PermissionFlags[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_util5.PermissionFlags.Administrator)) !== 0n) return true;
+    if ((rolePerms & BigInt(import_util6.PermissionFlags.Administrator)) !== 0n) return true;
     return (rolePerms & permBig) === permBig;
   }
   /**
@@ -1794,7 +1842,7 @@ var Role = class extends Base {
     const body = {};
     if (options.name !== void 0) body.name = options.name;
     if (options.permissions !== void 0) {
-      body.permissions = typeof options.permissions === "string" ? options.permissions : (0, import_util5.resolvePermissionsToBitfield)(options.permissions);
+      body.permissions = typeof options.permissions === "string" ? options.permissions : (0, import_util6.resolvePermissionsToBitfield)(options.permissions);
     }
     if (options.color !== void 0) body.color = options.color;
     if (options.hoist !== void 0) body.hoist = options.hoist;
@@ -2065,7 +2113,7 @@ var Guild = class extends Base {
     const body = {};
     if (options.name !== void 0) body.name = options.name;
     if (options.permissions !== void 0) {
-      body.permissions = typeof options.permissions === "string" ? options.permissions : (0, import_util6.resolvePermissionsToBitfield)(options.permissions);
+      body.permissions = typeof options.permissions === "string" ? options.permissions : (0, import_util7.resolvePermissionsToBitfield)(options.permissions);
     }
     if (options.color !== void 0) body.color = options.color;
     if (options.hoist !== void 0) body.hoist = options.hoist;
@@ -2128,7 +2176,7 @@ var Guild = class extends Base {
    * @returns The role ID, or null if not found
    */
   async resolveRoleId(arg) {
-    const parsed = (0, import_util6.parseRoleMention)(arg);
+    const parsed = (0, import_util7.parseRoleMention)(arg);
     if (parsed) return parsed;
     if (/^\d{17,19}$/.test(arg.trim())) return arg.trim();
     const cached = this.roles.find(
@@ -2665,7 +2713,7 @@ var ClientUser = class extends User {
 };
 
 // src/client/Client.ts
-var import_util7 = require("@fluxerjs/util");
+var import_util8 = require("@fluxerjs/util");
 
 // src/client/UsersManager.ts
 var import_collection9 = require("@fluxerjs/collection");
@@ -2890,6 +2938,7 @@ handlers.set("GUILD_CREATE", async (client, d) => {
   if (g.voice_states?.length) {
     client.emit(Events.VoiceStatesSync, { guildId: guild.id, voiceStates: g.voice_states });
   }
+  client._onGuildReceived(guild.id);
 });
 handlers.set("GUILD_UPDATE", async (client, d) => {
   const guildData = normalizeGuildPayload(d);
@@ -3022,7 +3071,11 @@ handlers.set("GUILD_EMOJIS_UPDATE", async (client, d) => {
       if (!e.id || e.name == null) continue;
       guild.emojis.set(
         e.id,
-        new GuildEmoji(client, { id: e.id, name: e.name, animated: e.animated ?? false, guild_id: guild.id }, guild.id)
+        new GuildEmoji(
+          client,
+          { id: e.id, name: e.name, animated: e.animated ?? false, guild_id: guild.id },
+          guild.id
+        )
       );
     }
   }
@@ -3148,6 +3201,8 @@ var Client = class extends import_events3.EventEmitter {
   /** Timestamp when the client became ready. Null until READY is received. */
   readyAt = null;
   _ws = null;
+  /** When waitForGuilds, set of guild IDs we're waiting for GUILD_CREATE on. Null when not waiting. */
+  _pendingGuildIds = null;
   /**
    * Resolve an emoji argument to the API format (unicode or "name:id").
    * Supports: <:name:id>, :name:, name:id, { name, id }, unicode.
@@ -3162,9 +3217,9 @@ var Client = class extends import_events3.EventEmitter {
       if (guildId) {
         await this.assertEmojiInGuild(emoji.id, guildId);
       }
-      return (0, import_util7.formatEmoji)({ name: emoji.name, id: emoji.id, animated: emoji.animated });
+      return (0, import_util8.formatEmoji)({ name: emoji.name, id: emoji.id, animated: emoji.animated });
     }
-    const parsed = (0, import_util7.parseEmoji)(
+    const parsed = (0, import_util8.parseEmoji)(
       typeof emoji === "string" ? emoji : emoji.id ? `:${emoji.name}:` : emoji.name
     );
     if (!parsed) throw new Error("Invalid emoji");
@@ -3172,16 +3227,16 @@ var Client = class extends import_events3.EventEmitter {
       if (guildId) {
         await this.assertEmojiInGuild(parsed.id, guildId);
       }
-      return (0, import_util7.formatEmoji)(parsed);
+      return (0, import_util8.formatEmoji)(parsed);
     }
     if (!/^\w+$/.test(parsed.name)) return parsed.name;
-    const unicodeFromShortcode = (0, import_util7.getUnicodeFromShortcode)(parsed.name);
+    const unicodeFromShortcode = (0, import_util8.getUnicodeFromShortcode)(parsed.name);
     if (unicodeFromShortcode) return unicodeFromShortcode;
     if (guildId) {
       const emojis = await this.rest.get(import_types21.Routes.guildEmojis(guildId));
       const list = Array.isArray(emojis) ? emojis : Object.values(emojis ?? {});
       const found = list.find((e) => e.name && e.name.toLowerCase() === parsed.name.toLowerCase());
-      if (found) return (0, import_util7.formatEmoji)({ ...parsed, id: found.id, animated: found.animated });
+      if (found) return (0, import_util8.formatEmoji)({ ...parsed, id: found.id, animated: found.animated });
       throw new Error(
         `Custom emoji ":${parsed.name}:" not found in guild. Use name:id or <:name:id> format.`
       );
@@ -3227,7 +3282,7 @@ var Client = class extends import_events3.EventEmitter {
    * const message = await channel?.messages?.fetch(messageId);
    */
   async fetchMessage(channelId, messageId) {
-    (0, import_util7.emitDeprecationWarning)(
+    (0, import_util8.emitDeprecationWarning)(
       "Client.fetchMessage()",
       "Use channel.messages.fetch(messageId). For IDs-only: (await client.channels.resolve(channelId))?.messages?.fetch(messageId)"
     );
@@ -3237,7 +3292,8 @@ 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.
    */
-  async sendToChannel(channelId, payload) {
+  async sendToChannel(channelId, content) {
+    const payload = await Message._createMessageBody(content);
     return this.channels.send(channelId, payload);
   }
   /**
@@ -3320,7 +3376,13 @@ var Client = class extends import_events3.EventEmitter {
         data
       }) => {
         this.user = new ClientUser(this, data.user);
+        const waitForGuilds = this.options.waitForGuilds === true;
+        const pending = waitForGuilds ? /* @__PURE__ */ new Set() : null;
         for (const g of data.guilds ?? []) {
+          if (g.unavailable === true) {
+            if (pending !== null && g.id) pending.add(g.id);
+            continue;
+          }
           const guildData = normalizeGuildPayload(g);
           if (!guildData) continue;
           const guild = new Guild(this, guildData);
@@ -3340,8 +3402,11 @@ var Client = class extends import_events3.EventEmitter {
             });
           }
         }
-        this.readyAt = /* @__PURE__ */ new Date();
-        this.emit(Events.Ready);
+        if (pending !== null && pending.size > 0) {
+          this._pendingGuildIds = pending;
+          return;
+        }
+        this._finalizeReady();
       }
     );
     this._ws.on("error", ({ error }) => this.emit(Events.Error, error));
@@ -3349,6 +3414,25 @@ var Client = class extends import_events3.EventEmitter {
     await this._ws.connect();
     return token;
   }
+  /**
+   * Called when all guilds have been received (or immediately if not waiting).
+   * Sets readyAt, emits Ready, clears pending state.
+   */
+  _finalizeReady() {
+    this._pendingGuildIds = null;
+    this.readyAt = /* @__PURE__ */ new Date();
+    this.emit(Events.Ready);
+  }
+  /**
+   * Called by GUILD_CREATE handler when waitForGuilds is enabled.
+   * Removes guild from pending set; when empty, finalizes ready.
+   */
+  _onGuildReceived(guildId) {
+    const pending = this._pendingGuildIds;
+    if (pending === null) return;
+    pending.delete(guildId);
+    if (pending.size === 0) this._finalizeReady();
+  }
   /** Disconnect from the gateway and clear cached data. */
   async destroy() {
     if (this._ws) {
@@ -3358,6 +3442,7 @@ var Client = class extends import_events3.EventEmitter {
     this.rest.setToken(null);
     this.user = null;
     this.readyAt = null;
+    this._pendingGuildIds = null;
     this.guilds.clear();
     this.channels.clear();
     this.users.clear();
@@ -3388,8 +3473,8 @@ var Client = class extends import_events3.EventEmitter {
 // src/index.ts
 var import_builders3 = require("@fluxerjs/builders");
 var import_types22 = require("@fluxerjs/types");
-var import_util8 = require("@fluxerjs/util");
 var import_util9 = require("@fluxerjs/util");
+var import_util10 = require("@fluxerjs/util");
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
   AttachmentBuilder,

package/dist/index.mjs

@@ -237,7 +237,10 @@ var Message = class _Message extends Base {
   mentionRoles;
   /** Client-side nonce for acknowledgment. Null if not provided. */
   nonce;
-  /** Channel where this message was sent. Resolved from cache; null if not cached (e.g. DM channel not in cache). */
+  /**
+   * Channel where this message was sent. Resolved from cache; null if not cached.
+   * Messages can only exist in text-based channels (text, DM, announcement), so this always has send() when non-null.
+   */
   get channel() {
     return this.client.channels.get(this.channelId) ?? null;
   }
@@ -299,12 +302,8 @@ var Message = class _Message extends Base {
    * await message.send({ content: 'File', files: [{ name: 'data.txt', data }] });
    */
   async send(options) {
-    const opts = typeof options === "string" ? { content: options } : options;
-    const body = buildSendBody(options);
-    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(Routes.channelMessages(this.channelId), postOptions);
-    return new _Message(this.client, data);
+    const payload = await _Message._createMessageBody(options);
+    return this._send(payload);
   }
   /**
    * Send a message to a specific channel. Use for logging, forwarding, or sending to another channel in the guild.
@@ -325,19 +324,30 @@ var Message = class _Message extends Base {
    * await message.reply({ embeds: [embed] });
    */
   async reply(options) {
-    const opts = typeof options === "string" ? { content: options } : options;
-    const base = buildSendBody(options);
-    const body = {
-      ...base,
-      message_reference: {
-        channel_id: this.channelId,
-        message_id: this.id,
-        guild_id: this.guildId ?? void 0
+    const payload = await _Message._createMessageBody(options, {
+      channel_id: this.channelId,
+      message_id: this.id,
+      guild_id: this.guildId ?? void 0
+    });
+    return this._send(payload);
+  }
+  /** Exposed for testing purposes, use Message.reply() or send() for normal use */
+  static async _createMessageBody(content, referenced_message) {
+    if (typeof content === "string") {
+      if (content.length === 0) {
+        throw new RangeError("Cannot send an empty message");
       }
-    };
-    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(Routes.channelMessages(this.channelId), postOptions);
+      content = { content };
+    }
+    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 } };
+  }
+  async _send(payload) {
+    const data = await this.client.rest.post(
+      Routes.channelMessages(this.channelId),
+      payload
+    );
     return new _Message(this.client, data);
   }
   /**
@@ -553,6 +563,7 @@ var MessageCollector = class extends EventEmitter2 {
 
 // src/structures/Channel.ts
 import { ChannelType, Routes as Routes5 } from "@fluxerjs/types";
+import { PermissionFlags } from "@fluxerjs/util";
 import { emitDeprecationWarning } from "@fluxerjs/util";
 
 // src/structures/Webhook.ts
@@ -688,7 +699,7 @@ var Webhook = class _Webhook extends Base {
       );
     }
     const opts = typeof options === "string" ? { content: options } : options;
-    const body = buildSendBody(options);
+    const body = buildSendBody(opts);
     if (opts.username !== void 0) body.username = opts.username;
     if (opts.avatar_url !== void 0) body.avatar_url = opts.avatar_url;
     if (opts.tts !== void 0) body.tts = opts.tts;
@@ -789,7 +800,7 @@ var Invite = class extends Base {
 // src/structures/Channel.ts
 var Channel = class _Channel extends Base {
   /** Whether this channel has a send method (TextChannel, DMChannel). */
-  isSendable() {
+  isTextBased() {
     return "send" in this;
   }
   /** Whether this channel is a DM or Group DM. */
@@ -800,6 +811,9 @@ var Channel = class _Channel extends Base {
   isVoice() {
     return "bitrate" in this;
   }
+  isLink() {
+    return "url" in this;
+  }
   /** Create a DM channel from API data (type DM or GroupDM). */
   static createDM(client, data) {
     return new DMChannel(client, data);
@@ -863,6 +877,15 @@ var Channel = class _Channel extends Base {
   async sendTyping() {
     await this.client.rest.post(Routes5.channelTyping(this.id), { auth: true });
   }
+  /**
+   * Whether the bot can send messages in this channel.
+   * For DMs: always true (when the channel exists).
+   * For guild channels: checks ViewChannel and SendMessages permissions via guild.members.me.
+   */
+  canSendMessage() {
+    if (this.isDM()) return true;
+    return false;
+  }
 };
 var GuildChannel = class extends Channel {
   guildId;
@@ -946,6 +969,31 @@ var GuildChannel = class extends Channel {
     if (idx >= 0) this.permissionOverwrites[idx] = entry;
     else this.permissionOverwrites.push(entry);
   }
+  /**
+   * Whether the bot can send messages in this channel.
+   * Checks ViewChannel and SendMessages via guild.members.me permissions.
+   * Returns false if guild or bot member not cached.
+   */
+  canSendMessage() {
+    const guild = this.client.guilds.get(this.guildId);
+    if (!guild) return false;
+    const me = guild.members.me;
+    if (!me) return false;
+    const perms = me.permissionsIn(this);
+    return perms.has(PermissionFlags.ViewChannel) && perms.has(PermissionFlags.SendMessages);
+  }
+  /**
+   * Send a message to this guild channel.
+   * Works for text and announcement channels. Voice/category/link channels will fail at the API.
+   */
+  async send(options) {
+    const opts = typeof options === "string" ? { content: options } : options;
+    const body = buildSendBody(options);
+    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);
+    return new Message(this.client, data);
+  }
   /**
    * Remove a permission overwrite. DELETE /channels/{id}/permissions/{overwriteId}.
    */
@@ -1183,7 +1231,7 @@ var ChannelManager = class extends Collection4 {
    * @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!');
+   * if (channel?.isTextBased()) await channel.send('Hello!');
    */
   async resolve(channelId) {
     return this.get(channelId) ?? this.fetch(channelId);
@@ -1195,7 +1243,7 @@ var ChannelManager = class extends Collection4 {
    * @throws FluxerError with CHANNEL_NOT_FOUND if the channel does not exist
    * @example
    * const channel = await client.channels.fetch(channelId);
-   * if (channel?.isSendable()) await channel.send('Hello!');
+   * if (channel?.isTextBased()) await channel.send('Hello!');
    */
   async fetch(channelId) {
     const cached = this.get(channelId);
@@ -1646,7 +1694,7 @@ var GuildMemberManager = class extends Collection6 {
 // src/structures/Role.ts
 import { Routes as Routes10 } from "@fluxerjs/types";
 import {
-  PermissionFlags,
+  PermissionFlags as PermissionFlags2,
   resolvePermissionsToBitfield
 } from "@fluxerjs/util";
 var Role = class extends Base {
@@ -1703,13 +1751,13 @@ var Role = class extends Base {
    * if (role.has('ManageChannels')) { ... }
    */
   has(permission) {
-    const perm = typeof permission === "number" ? permission : PermissionFlags[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(PermissionFlags.Administrator)) !== 0n) return true;
+    if ((rolePerms & BigInt(PermissionFlags2.Administrator)) !== 0n) return true;
     return (rolePerms & permBig) === permBig;
   }
   /**
@@ -2825,6 +2873,7 @@ handlers.set("GUILD_CREATE", async (client, d) => {
   if (g.voice_states?.length) {
     client.emit(Events.VoiceStatesSync, { guildId: guild.id, voiceStates: g.voice_states });
   }
+  client._onGuildReceived(guild.id);
 });
 handlers.set("GUILD_UPDATE", async (client, d) => {
   const guildData = normalizeGuildPayload(d);
@@ -2957,7 +3006,11 @@ handlers.set("GUILD_EMOJIS_UPDATE", async (client, d) => {
       if (!e.id || e.name == null) continue;
       guild.emojis.set(
         e.id,
-        new GuildEmoji(client, { id: e.id, name: e.name, animated: e.animated ?? false, guild_id: guild.id }, guild.id)
+        new GuildEmoji(
+          client,
+          { id: e.id, name: e.name, animated: e.animated ?? false, guild_id: guild.id },
+          guild.id
+        )
       );
     }
   }
@@ -3083,6 +3136,8 @@ var Client = class extends EventEmitter3 {
   /** Timestamp when the client became ready. Null until READY is received. */
   readyAt = null;
   _ws = null;
+  /** When waitForGuilds, set of guild IDs we're waiting for GUILD_CREATE on. Null when not waiting. */
+  _pendingGuildIds = null;
   /**
    * Resolve an emoji argument to the API format (unicode or "name:id").
    * Supports: <:name:id>, :name:, name:id, { name, id }, unicode.
@@ -3172,7 +3227,8 @@ 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.
    */
-  async sendToChannel(channelId, payload) {
+  async sendToChannel(channelId, content) {
+    const payload = await Message._createMessageBody(content);
     return this.channels.send(channelId, payload);
   }
   /**
@@ -3255,7 +3311,13 @@ var Client = class extends EventEmitter3 {
         data
       }) => {
         this.user = new ClientUser(this, data.user);
+        const waitForGuilds = this.options.waitForGuilds === true;
+        const pending = waitForGuilds ? /* @__PURE__ */ new Set() : null;
         for (const g of data.guilds ?? []) {
+          if (g.unavailable === true) {
+            if (pending !== null && g.id) pending.add(g.id);
+            continue;
+          }
           const guildData = normalizeGuildPayload(g);
           if (!guildData) continue;
           const guild = new Guild(this, guildData);
@@ -3275,8 +3337,11 @@ var Client = class extends EventEmitter3 {
             });
           }
         }
-        this.readyAt = /* @__PURE__ */ new Date();
-        this.emit(Events.Ready);
+        if (pending !== null && pending.size > 0) {
+          this._pendingGuildIds = pending;
+          return;
+        }
+        this._finalizeReady();
       }
     );
     this._ws.on("error", ({ error }) => this.emit(Events.Error, error));
@@ -3284,6 +3349,25 @@ var Client = class extends EventEmitter3 {
     await this._ws.connect();
     return token;
   }
+  /**
+   * Called when all guilds have been received (or immediately if not waiting).
+   * Sets readyAt, emits Ready, clears pending state.
+   */
+  _finalizeReady() {
+    this._pendingGuildIds = null;
+    this.readyAt = /* @__PURE__ */ new Date();
+    this.emit(Events.Ready);
+  }
+  /**
+   * Called by GUILD_CREATE handler when waitForGuilds is enabled.
+   * Removes guild from pending set; when empty, finalizes ready.
+   */
+  _onGuildReceived(guildId) {
+    const pending = this._pendingGuildIds;
+    if (pending === null) return;
+    pending.delete(guildId);
+    if (pending.size === 0) this._finalizeReady();
+  }
   /** Disconnect from the gateway and clear cached data. */
   async destroy() {
     if (this._ws) {
@@ -3293,6 +3377,7 @@ var Client = class extends EventEmitter3 {
     this.rest.setToken(null);
     this.user = null;
     this.readyAt = null;
+    this._pendingGuildIds = null;
     this.guilds.clear();
     this.channels.clear();
     this.users.clear();
@@ -3326,7 +3411,7 @@ import { Routes as Routes21, GatewayOpcodes, MessageAttachmentFlags } from "@flu
 import { resolveTenorToImageUrl, parseUserMention, parsePrefixCommand } from "@fluxerjs/util";
 import {
   PermissionsBitField,
-  PermissionFlags as PermissionFlags2,
+  PermissionFlags as PermissionFlags3,
   resolvePermissionsToBitfield as resolvePermissionsToBitfield3,
   UserFlagsBitField,
   UserFlagsBits
@@ -3362,7 +3447,7 @@ export {
   MessageManager,
   MessagePayload,
   MessageReaction,
-  PermissionFlags2 as PermissionFlags,
+  PermissionFlags3 as PermissionFlags,
   PermissionsBitField,
   ReactionCollector,
   Role,

package/package.json

@@ -3,7 +3,7 @@
   "publishConfig": {
     "access": "public"
   },
-  "version": "1.2.1",
+  "version": "1.2.2",
   "description": "A fully-featured SDK for Fluxer bots",
   "repository": {
     "type": "git",
@@ -34,12 +34,12 @@
     "dist"
   ],
   "dependencies": {
-    "@fluxerjs/rest": "1.2.1",
-    "@fluxerjs/ws": "1.2.1",
-    "@fluxerjs/builders": "1.2.1",
-    "@fluxerjs/collection": "1.2.1",
-    "@fluxerjs/util": "1.2.1",
-    "@fluxerjs/types": "1.2.1"
+    "@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"
   },
   "devDependencies": {
     "@types/node": "^20.0.0",