@fluxerjs/core 1.1.5 → 1.1.7

package/dist/index.d.ts

@@ -1,5 +1,5 @@
 import * as _fluxerjs_types from '@fluxerjs/types';
-import { 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, APIGuildPartial, APIInvite, GatewayPresenceUpdateData, APIProfileResponse, GatewayMessageReactionRemoveAllDispatchData, GatewayMessageReactionRemoveEmojiDispatchData, GatewayVoiceStateUpdateDispatchData, GatewayVoiceServerUpdateDispatchData, GatewayGuildEmojisUpdateDispatchData, GatewayGuildStickersUpdateDispatchData, GatewayGuildIntegrationsUpdateDispatchData, GatewayGuildScheduledEventCreateDispatchData, GatewayGuildScheduledEventUpdateDispatchData, GatewayGuildScheduledEventDeleteDispatchData, GatewayChannelPinsUpdateDispatchData, GatewayPresenceUpdateDispatchData, GatewayWebhooksUpdateDispatchData, GatewaySendPayload, Routes, APIEmoji, APISticker } 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';
@@ -16,6 +16,59 @@ declare abstract class Base {
     abstract readonly client: Client;
 }
 
+/** 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>;
+}
+
+/** 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>;
+}
+
 /**
  * Manages messages for a channel. Access via channel.messages.
  * @example
@@ -274,6 +327,47 @@ declare class GuildChannel extends Channel {
      * Requires Manage Channel permission.
      */
     fetchInvites(): Promise<Invite[]>;
+    /**
+     * Set or update a permission overwrite. PUT /channels/{id}/permissions/{overwriteId}.
+     * @param overwriteId - Role or member ID
+     * @param options - type (0=role, 1=member), allow, deny (permission bitfields)
+     */
+    editPermission(overwriteId: string, options: {
+        type: 0 | 1;
+        allow?: string;
+        deny?: string;
+    }): Promise<void>;
+    /**
+     * Remove a permission overwrite. DELETE /channels/{id}/permissions/{overwriteId}.
+     */
+    deletePermission(overwriteId: string): Promise<void>;
+    /**
+     * Edit this channel. PATCH /channels/{id}.
+     * Requires Manage Channel permission.
+     */
+    edit(options: {
+        name?: string | null;
+        topic?: string | null;
+        parent_id?: string | null;
+        bitrate?: number | null;
+        user_limit?: number | null;
+        nsfw?: boolean;
+        rate_limit_per_user?: number;
+        rtc_region?: string | null;
+        permission_overwrites?: Array<{
+            id: string;
+            type: number;
+            allow?: string;
+            deny?: string;
+        }>;
+    }): Promise<this>;
+    /**
+     * Delete this channel. Requires Manage Channel permission.
+     * @param options - silent: if true, does not send a system message (default false)
+     */
+    delete(options?: {
+        silent?: boolean;
+    }): Promise<void>;
 }
 declare class TextChannel extends GuildChannel {
     topic?: string | null;
@@ -357,6 +451,19 @@ declare class DMChannel extends Channel {
      * @deprecated Use channel.messages.fetch(messageId) instead.
      */
     fetchMessage(messageId: string): Promise<Message>;
+    /**
+     * Add a recipient to this Group DM. Requires Group DM (type GroupDM).
+     * PUT /channels/{id}/recipients/{userId}.
+     */
+    addRecipient(userId: string): Promise<void>;
+    /**
+     * Remove a recipient from this Group DM. Requires Group DM (type GroupDM).
+     * DELETE /channels/{id}/recipients/{userId}.
+     * @param options - silent: if true, does not send a system message (default false)
+     */
+    removeRecipient(userId: string, options?: {
+        silent?: boolean;
+    }): Promise<void>;
 }
 
 /** Represents a reaction added to or removed from a message. */
@@ -515,6 +622,11 @@ declare class Message extends Base {
     fetch(): Promise<Message>;
     /** Delete this message. */
     delete(): Promise<void>;
+    /**
+     * Delete a specific attachment from this message.
+     * DELETE /channels/{id}/messages/{id}/attachments/{attachmentId}.
+     */
+    deleteAttachment(attachmentId: string): 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. */
@@ -689,6 +801,28 @@ declare class GuildMember extends Base {
      * Requires Manage Roles permission.
      */
     removeRole(roleId: string): Promise<void>;
+    /**
+     * Edit this guild member. PATCH /guilds/{id}/members/{userId} or /members/@me for the bot.
+     * For @me: nick, avatar, banner, bio, pronouns, accent_color, profile_flags, mute, deaf,
+     * communication_disabled_until, timeout_reason, channel_id, connection_id.
+     * For other members: same plus roles (array of role IDs).
+     */
+    edit(options: {
+        nick?: string | null;
+        roles?: string[];
+        avatar?: string | null;
+        banner?: string | null;
+        bio?: string | null;
+        pronouns?: string | null;
+        accent_color?: number | null;
+        profile_flags?: number | null;
+        mute?: boolean;
+        deaf?: boolean;
+        communication_disabled_until?: string | null;
+        timeout_reason?: string | null;
+        channel_id?: string | null;
+        connection_id?: string | null;
+    }): Promise<this>;
     /**
      * Get the member's guild-level permissions (from roles only, no channel overwrites).
      * Use this for server-wide permission checks (e.g. ban, kick, manage roles).
@@ -743,6 +877,15 @@ declare class GuildMemberManager extends Collection<string, GuildMember> {
      * console.log(me.displayName);
      */
     fetchMe(): Promise<GuildMember>;
+    /**
+     * Fetch guild members with pagination. GET /guilds/{id}/members.
+     * @param options - limit (1-1000), after (user ID for pagination)
+     * @returns Array of GuildMember objects (cached in guild.members)
+     */
+    fetch(options?: {
+        limit?: number;
+        after?: string;
+    }): Promise<GuildMember[]>;
 }
 
 /** Represents a role in a guild. */
@@ -987,6 +1130,73 @@ declare class Guild extends Base {
      * @returns Array of GuildChannel objects (cached in guild.channels and client.channels)
      */
     fetchChannels(): Promise<GuildChannel[]>;
+    /**
+     * Edit this guild. PATCH /guilds/{id}.
+     * Requires guild owner or Administrator.
+     */
+    edit(options: {
+        name?: string;
+        icon?: string | null;
+        system_channel_id?: string | null;
+        system_channel_flags?: number;
+        afk_channel_id?: string | null;
+        afk_timeout?: number;
+        default_message_notifications?: DefaultMessageNotifications;
+        verification_level?: GuildVerificationLevel;
+        mfa_level?: GuildMFALevel;
+        explicit_content_filter?: GuildExplicitContentFilter;
+        banner?: string | null;
+        splash?: string | null;
+        embed_splash?: string | null;
+        splash_card_alignment?: string;
+        features?: GuildFeature[];
+    }): Promise<this>;
+    /**
+     * Delete this guild. POST /guilds/{id}/delete.
+     * Must be the guild owner.
+     */
+    delete(): Promise<void>;
+    /**
+     * Fetch vanity URL for this guild. GET /guilds/{id}/vanity-url.
+     * Requires Manage Guild permission.
+     */
+    fetchVanityURL(): Promise<APIVanityURL>;
+    /**
+     * Transfer guild ownership to another user. POST /guilds/{id}/transfer-ownership.
+     * Must be the guild owner.
+     */
+    transferOwnership(newOwnerId: string, password?: string): Promise<void>;
+    /**
+     * Set text channel flexible names feature. PATCH /guilds/{id}/text-channel-flexible-names.
+     */
+    setTextChannelFlexibleNames(enabled: boolean): Promise<this>;
+    /**
+     * Set detached banner feature. PATCH /guilds/{id}/detached-banner.
+     */
+    setDetachedBanner(enabled: boolean): Promise<this>;
+    /**
+     * Set disallow unclaimed accounts. PATCH /guilds/{id}/disallow-unclaimed-accounts.
+     */
+    setDisallowUnclaimedAccounts(enabled: boolean): Promise<this>;
+    /**
+     * Update role positions. PATCH /guilds/{id}/roles.
+     * @param updates - Array of { id, position? }
+     */
+    setRolePositions(updates: Array<{
+        id: string;
+        position?: number;
+    }>): Promise<APIRole[]>;
+    /**
+     * Update role hoist positions. PATCH /guilds/{id}/roles/hoist-positions.
+     */
+    setRoleHoistPositions(updates: Array<{
+        id: string;
+        hoist_position?: number;
+    }>): Promise<APIRole[]>;
+    /**
+     * Reset role hoist positions. DELETE /guilds/{id}/roles/hoist-positions.
+     */
+    resetRoleHoistPositions(): Promise<APIRole[]>;
     /**
      * Update channel positions.
      * @param updates - Array of { id, position?, parent_id?, lock_permissions? }
@@ -998,6 +1208,26 @@ declare class Guild extends Base {
         parent_id?: string | null;
         lock_permissions?: boolean;
     }>): Promise<void>;
+    /**
+     * Bulk create emojis. POST /guilds/{id}/emojis/bulk.
+     * @param emojis - Array of { name, image } (base64), 1-50 emojis
+     * @returns Array of created GuildEmoji objects
+     */
+    createEmojisBulk(emojis: Array<{
+        name: string;
+        image: string;
+    }>): Promise<GuildEmoji[]>;
+    /**
+     * Bulk create stickers. POST /guilds/{id}/stickers/bulk.
+     * @param stickers - Array of { name, image, description?, tags? }, 1-50 stickers
+     * @returns Array of created GuildSticker objects
+     */
+    createStickersBulk(stickers: Array<{
+        name: string;
+        image: string;
+        description?: string;
+        tags?: string[];
+    }>): Promise<GuildSticker[]>;
 }
 
 /** Represents an invite to a guild or channel. */
@@ -1089,6 +1319,16 @@ declare class ChannelManager extends Collection<string, Channel> {
 declare class GuildManager extends Collection<string, Guild> {
     private readonly client;
     constructor(client: Client);
+    /**
+     * Create a guild. POST /guilds.
+     * @param options - name (required), icon (base64), empty_features
+     * @returns The created guild
+     */
+    create(options: {
+        name: string;
+        icon?: string | null;
+        empty_features?: boolean;
+    }): Promise<Guild>;
     /**
      * Fetch a guild by ID from the API (or return from cache if present).
      * @param guildId - Snowflake of the guild
@@ -1347,6 +1587,11 @@ declare class Client extends EventEmitter {
         id?: string;
         animated?: boolean;
     }, guildId?: string | null): Promise<string>;
+    /**
+     * Fetch instance info (API URL, gateway URL, features). GET /instance.
+     * Does not require authentication.
+     */
+    fetchInstance(): Promise<APIInstance>;
     /**
      * Fetch a message by channel and message ID. Use when you have IDs (e.g. from a DB).
      * @param channelId - Snowflake of the channel
@@ -1395,59 +1640,6 @@ 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>;
-}
-
 interface FluxerErrorOptions {
     code?: string;
     cause?: Error;