@fluxerjs/core 1.0.8 → 1.0.9

package/dist/index.d.ts

@@ -1,7 +1,7 @@
-import { Collection } from '@fluxerjs/collection';
 import * as _fluxerjs_types from '@fluxerjs/types';
-import { APIWebhook, APIChannel, APIChannelPartial, ChannelType, APIRole, APIGuild, APIMessageAttachment, APIMessage, APIEmbed, APIUserPartial, APIGuildMember, GatewayReactionEmoji, GatewayMessageReactionAddDispatchData, GatewayMessageReactionRemoveDispatchData, GatewayPresenceUpdateData, GatewaySendPayload, Routes, GatewayMessageReactionRemoveAllDispatchData, GatewayMessageReactionRemoveEmojiDispatchData, GatewayVoiceStateUpdateDispatchData, GatewayVoiceServerUpdateDispatchData } from '@fluxerjs/types';
+import { APIWebhook, APIWebhookUpdateRequest, APIWebhookTokenUpdateRequest, APIChannel, APIChannelPartial, ChannelType, APIMessageAttachment, MessageType, APIEmbed, APIMessageSticker, APIMessageReaction, APIMessageReference, APIMessageSnapshot, APIMessageCall, APIMessage, APIUserPartial, APIGuildMember, APIRole, APIGuild, APIGuildAuditLog, APIGuildPartial, APIInvite, APIBan, GatewayReactionEmoji, GatewayMessageReactionAddDispatchData, GatewayMessageReactionRemoveDispatchData, GatewayPresenceUpdateData, GatewaySendPayload, Routes, GatewayMessageReactionRemoveAllDispatchData, GatewayMessageReactionRemoveEmojiDispatchData, GatewayVoiceStateUpdateDispatchData, GatewayVoiceServerUpdateDispatchData, APIEmoji, APISticker } from '@fluxerjs/types';
 export { GatewayOpcodes, Routes } from '@fluxerjs/types';
+import { Collection } from '@fluxerjs/collection';
 import { EmbedBuilder } from '@fluxerjs/builders';
 export { AttachmentBuilder, EmbedBuilder, MessagePayload } from '@fluxerjs/builders';
 import { EventEmitter } from 'events';
@@ -51,7 +51,7 @@ declare class Webhook extends Base {
     readonly client: Client;
     readonly id: string;
     readonly guildId: string;
-    readonly channelId: string;
+    channelId: string;
     name: string;
     avatar: string | null;
     /** Present only when webhook was created via createWebhook(); not returned when fetching. */
@@ -62,6 +62,12 @@ declare class Webhook extends Base {
     });
     /** Delete this webhook. Requires bot token with Manage Webhooks permission. */
     delete(): Promise<void>;
+    /**
+     * Edit this webhook. With token: name and avatar only. Without token (bot auth): name, avatar, and channel_id.
+     * @param options - Fields to update (name, avatar, channel_id when using bot auth)
+     * @returns This webhook instance with updated fields
+     */
+    edit(options: APIWebhookUpdateRequest | APIWebhookTokenUpdateRequest): Promise<Webhook>;
     /**
      * Send a message via this webhook. Requires the webhook token (only present when created, not when fetched).
      * @throws Error if token is not available
@@ -152,6 +158,11 @@ declare class TextChannel extends GuildChannel {
     }): Promise<Message>;
     /** Message manager for this channel. Use channel.messages.fetch(messageId). */
     get messages(): MessageManager;
+    /**
+     * Fetch pinned messages in this channel.
+     * @returns Pinned messages
+     */
+    fetchPinnedMessages(): Promise<Message[]>;
     /**
      * Fetch a message by ID from this channel.
      * @param messageId - Snowflake of the message
@@ -186,6 +197,11 @@ declare class DMChannel extends Channel {
     }): Promise<Message>;
     /** Message manager for this channel. Use channel.messages.fetch(messageId). */
     get messages(): MessageManager;
+    /**
+     * Fetch pinned messages in this DM channel.
+     * @returns Pinned messages
+     */
+    fetchPinnedMessages(): Promise<Message[]>;
     /**
      * Fetch a message by ID from this DM channel.
      * @param messageId - Snowflake of the message
@@ -195,80 +211,6 @@ declare class DMChannel extends Channel {
     fetchMessage(messageId: string): Promise<Message | null>;
 }
 
-/** Represents a role in a guild. */
-declare class Role extends Base {
-    readonly client: Client;
-    readonly id: string;
-    readonly guildId: string;
-    name: string;
-    color: number;
-    position: number;
-    permissions: string;
-    hoist: boolean;
-    mentionable: boolean;
-    unicodeEmoji: string | null;
-    /** @param client - The client instance */
-    /** @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);
-    /** Returns a mention string (e.g. `<@&123456>`). */
-    toString(): string;
-}
-
-/** Represents a Fluxer guild (server). */
-declare class Guild extends Base {
-    readonly client: Client;
-    readonly id: string;
-    name: string;
-    icon: string | null;
-    banner: string | null;
-    readonly ownerId: string;
-    members: Collection<string, GuildMember>;
-    channels: Collection<string, GuildChannel>;
-    roles: Collection<string, Role>;
-    /** @param data - API guild from GET /guilds/{id} or gateway GUILD_CREATE */
-    constructor(client: Client, data: APIGuild & {
-        roles?: APIRole[];
-    });
-    /** Get the guild icon URL, or null if no icon. */
-    iconURL(options?: {
-        size?: number;
-    }): string | null;
-    /** Get the guild banner URL, or null if no banner. */
-    bannerURL(options?: {
-        size?: number;
-    }): string | null;
-    /**
-     * Add a role to a member by user ID. Does not require fetching the member first.
-     * @param userId - The user ID of the member
-     * @param roleId - The role ID to add (or use guild.resolveRoleId for mention/name resolution)
-     * Requires Manage Roles permission.
-     */
-    addRoleToMember(userId: string, roleId: string): Promise<void>;
-    /**
-     * Remove a role from a member by user ID. Does not require fetching the member first.
-     * @param userId - The user ID of the member
-     * @param roleId - The role ID to remove
-     * Requires Manage Roles permission.
-     */
-    removeRoleFromMember(userId: string, roleId: string): Promise<void>;
-    /**
-     * Resolve a role ID from an argument (role mention, raw ID, or name).
-     * Fetches guild roles if name is provided.
-     * @param arg - Role mention (@role), role ID, or role name
-     * @returns The role ID, or null if not found
-     */
-    resolveRoleId(arg: string): Promise<string | null>;
-    /**
-     * Fetch a guild member by user ID.
-     * @param userId - The user ID of the member to fetch
-     * @returns The guild member, or null if not found
-     */
-    fetchMember(userId: string): Promise<GuildMember | null>;
-    /** Fetch all webhooks in this guild. Returned webhooks do not include the token (cannot send). */
-    fetchWebhooks(): Promise<Webhook[]>;
-}
-
 /** Options for editing a message (content and/or embeds). */
 interface MessageEditOptions {
     /** New text content */
@@ -288,6 +230,17 @@ declare class Message extends Base {
     readonly editedAt: Date | null;
     pinned: boolean;
     readonly attachments: Collection<string, APIMessageAttachment>;
+    readonly type: MessageType;
+    readonly flags: number;
+    readonly mentionEveryone: boolean;
+    readonly tts: boolean;
+    readonly embeds: APIEmbed[];
+    readonly stickers: APIMessageSticker[];
+    readonly reactions: APIMessageReaction[];
+    readonly messageReference: APIMessageReference | null;
+    readonly messageSnapshots: APIMessageSnapshot[];
+    readonly call: APIMessageCall | null;
+    readonly referencedMessage: Message | 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;
     /** Guild where this message was sent. Resolved from cache; null for DMs or if not cached. */
@@ -341,6 +294,10 @@ declare class Message extends Base {
     fetch(): Promise<Message | null>;
     /** Delete this message. */
     delete(): Promise<void>;
+    /** Pin this message to the channel. Requires Manage Messages permission. */
+    pin(): Promise<void>;
+    /** Unpin this message from the channel. Requires Manage Messages permission. */
+    unpin(): Promise<void>;
     /**
      * Format emoji for reaction API: unicode string or "name:id" for custom.
      * For string resolution (e.g. :name:), use client.resolveEmoji; Message methods resolve automatically when guildId is available.
@@ -434,6 +391,12 @@ declare class GuildMember extends Base {
     readonly roles: string[];
     readonly joinedAt: Date;
     communicationDisabledUntil: Date | null;
+    readonly mute: boolean;
+    readonly deaf: boolean;
+    readonly avatar: string | null;
+    readonly banner: string | null;
+    readonly accentColor: number | null;
+    readonly profileFlags: number | null;
     /** @param data - API guild member from GET /guilds/{id}/members or GET /guilds/{id}/members/{user_id} */
     constructor(client: Client, data: APIGuildMember & {
         guild_id?: string;
@@ -454,6 +417,140 @@ declare class GuildMember extends Base {
     removeRole(roleId: string): Promise<void>;
 }
 
+/** Represents a role in a guild. */
+declare class Role extends Base {
+    readonly client: Client;
+    readonly id: string;
+    readonly guildId: string;
+    name: string;
+    color: number;
+    position: number;
+    permissions: string;
+    hoist: boolean;
+    mentionable: boolean;
+    unicodeEmoji: string | null;
+    /** @param client - The client instance */
+    /** @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);
+    /** Returns a mention string (e.g. `<@&123456>`). */
+    toString(): string;
+}
+
+/** Represents a Fluxer guild (server). */
+declare class Guild extends Base {
+    readonly client: Client;
+    readonly id: string;
+    name: string;
+    icon: string | null;
+    banner: string | null;
+    readonly ownerId: string;
+    members: Collection<string, GuildMember>;
+    channels: Collection<string, GuildChannel>;
+    roles: Collection<string, Role>;
+    /** @param data - API guild from GET /guilds/{id} or gateway GUILD_CREATE */
+    constructor(client: Client, data: APIGuild & {
+        roles?: APIRole[];
+    });
+    /** Get the guild icon URL, or null if no icon. */
+    iconURL(options?: {
+        size?: number;
+    }): string | null;
+    /** Get the guild banner URL, or null if no banner. */
+    bannerURL(options?: {
+        size?: number;
+    }): string | null;
+    /**
+     * Add a role to a member by user ID. Does not require fetching the member first.
+     * @param userId - The user ID of the member
+     * @param roleId - The role ID to add (or use guild.resolveRoleId for mention/name resolution)
+     * Requires Manage Roles permission.
+     */
+    addRoleToMember(userId: string, roleId: string): Promise<void>;
+    /**
+     * Remove a role from a member by user ID. Does not require fetching the member first.
+     * @param userId - The user ID of the member
+     * @param roleId - The role ID to remove
+     * Requires Manage Roles permission.
+     */
+    removeRoleFromMember(userId: string, roleId: string): Promise<void>;
+    /**
+     * Resolve a role ID from an argument (role mention, raw ID, or name).
+     * Fetches guild roles if name is provided.
+     * @param arg - Role mention (@role), role ID, or role name
+     * @returns The role ID, or null if not found
+     */
+    resolveRoleId(arg: string): Promise<string | null>;
+    /**
+     * Fetch a guild member by user ID.
+     * @param userId - The user ID of the member to fetch
+     * @returns The guild member, or null if not found
+     */
+    fetchMember(userId: string): Promise<GuildMember | null>;
+    /**
+     * Fetch guild audit logs. Requires View Audit Log permission.
+     * @param options - Optional limit, before, after, user_id, action_type for filtering
+     */
+    fetchAuditLogs(options?: {
+        limit?: number;
+        before?: string;
+        after?: string;
+        userId?: string;
+        actionType?: number;
+    }): Promise<APIGuildAuditLog>;
+    /** Fetch all webhooks in this guild. Returned webhooks do not include the token (cannot send). */
+    fetchWebhooks(): Promise<Webhook[]>;
+}
+
+/** Represents an invite to a guild or channel. */
+declare class Invite extends Base {
+    readonly client: Client;
+    readonly code: string;
+    readonly type: number;
+    readonly guild: APIGuildPartial;
+    readonly channel: APIChannelPartial;
+    readonly inviter: User | null;
+    readonly memberCount: number | null;
+    readonly presenceCount: number | null;
+    readonly expiresAt: string | null;
+    readonly temporary: boolean | null;
+    readonly createdAt: string | null;
+    readonly uses: number | null;
+    readonly maxUses: number | null;
+    readonly maxAge: number | null;
+    /** @param data - API invite from GET /invites/{code}, channel/guild invite list, or gateway INVITE_CREATE */
+    constructor(client: Client, data: APIInvite);
+    /** Full invite URL (https://fluxer.gg/{code} or instance-specific). */
+    get url(): string;
+    /**
+     * Resolve the guild from cache if available.
+     * @returns The guild, or null if not cached
+     */
+    getGuild(): Guild | null;
+    /**
+     * Delete this invite.
+     * Requires Manage Guild or Create Instant Invite permission.
+     */
+    delete(): Promise<void>;
+}
+
+/** Represents a ban in a guild. */
+declare class GuildBan extends Base {
+    readonly client: Client;
+    readonly guildId: string;
+    readonly user: User;
+    readonly reason: string | null;
+    /** @param data - API ban from GET /guilds/{id}/bans or gateway GUILD_BAN_ADD */
+    constructor(client: Client, data: APIBan & {
+        guild_id?: string;
+    }, guildId: string);
+    /**
+     * Remove this ban (unban the user).
+     * Requires Ban Members permission.
+     */
+    unban(): Promise<void>;
+}
+
 /** Represents a reaction added to or removed from a message. */
 declare class MessageReaction extends Base {
     readonly client: Client;
@@ -656,8 +753,8 @@ interface ClientEvents {
     [Events.MessageDeleteBulk]: [
         data: _fluxerjs_types.GatewayMessageDeleteBulkDispatchData
     ];
-    [Events.GuildBanAdd]: [data: _fluxerjs_types.GatewayGuildBanAddDispatchData];
-    [Events.GuildBanRemove]: [data: _fluxerjs_types.GatewayGuildBanRemoveDispatchData];
+    [Events.GuildBanAdd]: [ban: GuildBan];
+    [Events.GuildBanRemove]: [ban: GuildBan];
     [Events.GuildEmojisUpdate]: [data: unknown];
     [Events.GuildStickersUpdate]: [data: unknown];
     [Events.GuildIntegrationsUpdate]: [data: unknown];
@@ -668,8 +765,10 @@ interface ClientEvents {
     [Events.GuildScheduledEventUpdate]: [data: unknown];
     [Events.GuildScheduledEventDelete]: [data: unknown];
     [Events.ChannelPinsUpdate]: [data: unknown];
-    [Events.InviteCreate]: [data: unknown];
-    [Events.InviteDelete]: [data: unknown];
+    [Events.InviteCreate]: [invite: Invite];
+    [Events.InviteDelete]: [
+        data: _fluxerjs_types.GatewayInviteDeleteDispatchData
+    ];
     [Events.TypingStart]: [data: _fluxerjs_types.GatewayTypingStartDispatchData];
     [Events.UserUpdate]: [data: _fluxerjs_types.GatewayUserUpdateDispatchData];
     [Events.PresenceUpdate]: [data: unknown];
@@ -750,6 +849,59 @@ declare class Client extends EventEmitter {
     static get Routes(): typeof Routes;
 }
 
+/** Represents a custom emoji in a guild. */
+declare class GuildEmoji extends Base {
+    readonly client: Client;
+    readonly id: string;
+    readonly guildId: string;
+    name: string;
+    readonly animated: boolean;
+    /** @param data - API emoji from GET /guilds/{id}/emojis or guild emoji events */
+    constructor(client: Client, data: APIEmoji & {
+        guild_id?: string;
+    }, guildId: string);
+    /** CDN URL for this emoji image. */
+    get url(): string;
+    /** Emoji identifier for use in reactions: `name:id` */
+    get identifier(): string;
+    /** Delete this emoji. Requires Manage Emojis and Stickers permission. */
+    delete(): Promise<void>;
+    /**
+     * Edit this emoji's name.
+     * Requires Manage Emojis and Stickers permission.
+     */
+    edit(options: {
+        name: string;
+    }): Promise<GuildEmoji>;
+}
+
+/** Represents a custom sticker in a guild. */
+declare class GuildSticker extends Base {
+    readonly client: Client;
+    readonly id: string;
+    readonly guildId: string;
+    name: string;
+    description: string;
+    readonly tags: string[];
+    readonly animated: boolean;
+    /** @param data - API sticker from GET /guilds/{id}/stickers or guild sticker events */
+    constructor(client: Client, data: APISticker & {
+        guild_id?: string;
+    }, guildId: string);
+    /** CDN URL for this sticker image. */
+    get url(): string;
+    /** Delete this sticker. Requires Manage Emojis and Stickers permission. */
+    delete(): Promise<void>;
+    /**
+     * Edit this sticker's name and/or description.
+     * Requires Manage Emojis and Stickers permission.
+     */
+    edit(options: {
+        name?: string;
+        description?: string;
+    }): Promise<GuildSticker>;
+}
+
 declare class FluxerError extends Error {
     constructor(message: string);
 }
@@ -759,4 +911,4 @@ declare const ErrorCodes: {
     readonly InvalidToken: "INVALID_TOKEN";
 };
 
-export { Base, CategoryChannel, Channel, ChannelManager, Client, type ClientEvents, ClientUser, DMChannel, ErrorCodes, Events, FluxerError, Guild, GuildChannel, GuildMember, LinkChannel, Message, type MessageEditOptions, MessageManager, MessageReaction, type PartialMessage, Role, TextChannel, User, VoiceChannel, Webhook, type WebhookSendOptions };
+export { Base, CategoryChannel, Channel, ChannelManager, Client, type ClientEvents, ClientUser, DMChannel, ErrorCodes, Events, FluxerError, Guild, GuildBan, GuildChannel, GuildEmoji, GuildMember, GuildSticker, Invite, LinkChannel, Message, type MessageEditOptions, MessageManager, MessageReaction, type PartialMessage, Role, TextChannel, User, VoiceChannel, Webhook, type WebhookSendOptions };