@discordjs/builders 2.0.0-move-client-init.1761650119-a4c0a246f → 2.0.0-pr-11006.1765450794-e636950b2

package/dist/index.d.mts

@@ -1,10 +1,12 @@
 import * as discord_api_types_v10 from 'discord-api-types/v10';
-import { APIButtonComponent, APIButtonComponentWithSKUId, APIMessageComponentEmoji, APIBaseComponent, ComponentType, APIButtonComponentWithCustomId, APIButtonComponentWithURL, Snowflake, APISelectMenuComponent, APIChannelSelectComponent, ChannelType, APIMentionableSelectComponent, APISelectMenuDefaultValue, SelectMenuDefaultValueType, APIRoleSelectComponent, APISelectMenuOption, APIStringSelectComponent, APIUserSelectComponent, APITextInputComponent, TextInputStyle, APILabelComponent, APIFileComponent, APIMediaGalleryItem, APIMediaGalleryComponent, APITextDisplayComponent, APIThumbnailComponent, APISectionComponent, ButtonStyle, APISeparatorComponent, SeparatorSpacingSize, APIContainerComponent, APIActionRowComponent, APIComponentInMessageActionRow, APIComponentInContainer, APIModalComponent, APIMessageComponent, APISectionAccessoryComponent, APIComponentInActionRow, APIApplicationCommandIntegerOption, APIApplicationCommandChannelOption, APIApplicationCommandNumberOption, APIApplicationCommandStringOption, APIApplicationCommandOptionChoice, RESTPostAPIApplicationCommandsJSONBody, Locale, APIApplicationCommand, APIApplicationCommandBasicOption, APIApplicationCommandOption, ApplicationCommandOptionType, APIApplicationCommandSubcommandOption, APIApplicationCommandSubcommandGroupOption, InteractionContextType, ApplicationIntegrationType, Permissions, RESTPostAPIChatInputApplicationCommandsJSONBody, ApplicationCommandType, RESTPostAPIContextMenuApplicationCommandsJSONBody, APIModalInteractionResponseCallbackData, APIEmbedAuthor, APIEmbedField, APIEmbedFooter, APIEmbed, PollLayoutType, APIPollMedia, APIPartialEmoji, APIPollAnswer, RESTAPIPoll, APIAllowedMentions, AllowedMentionsTypes, MessageReferenceType, RESTAPIAttachment, RESTAPIMessageReference, RESTPostAPIChannelMessageJSONBody, APIMessageReference, APIMessageTopLevelComponent, APIAttachment, MessageFlags, APIPoll } from 'discord-api-types/v10';
-import { JSONEncodable } from '@discordjs/util';
+import { APIButtonComponent, APIButtonComponentWithSKUId, APIMessageComponentEmoji, APIBaseComponent, ComponentType, APIButtonComponentWithCustomId, APIButtonComponentWithURL, Snowflake, APIFileUploadComponent, APISelectMenuComponent, APIChannelSelectComponent, ChannelType, APIMentionableSelectComponent, APISelectMenuDefaultValue, SelectMenuDefaultValueType, APIRoleSelectComponent, APISelectMenuOption, APIStringSelectComponent, APIUserSelectComponent, APITextInputComponent, TextInputStyle, APILabelComponent, APIFileComponent, APIMediaGalleryItem, APIMediaGalleryComponent, APITextDisplayComponent, APIThumbnailComponent, APISectionComponent, ButtonStyle, APISeparatorComponent, SeparatorSpacingSize, APIContainerComponent, APIActionRowComponent, APIComponentInMessageActionRow, APIComponentInContainer, APIModalComponent, APIMessageComponent, APISectionAccessoryComponent, APIComponentInActionRow, APIApplicationCommandIntegerOption, APIApplicationCommandChannelOption, APIApplicationCommandNumberOption, APIApplicationCommandStringOption, APIApplicationCommandOptionChoice, RESTPostAPIApplicationCommandsJSONBody, Locale, APIApplicationCommand, APIApplicationCommandBasicOption, APIApplicationCommandOption, ApplicationCommandOptionType, APIApplicationCommandSubcommandOption, APIApplicationCommandSubcommandGroupOption, InteractionContextType, ApplicationIntegrationType, Permissions, RESTPostAPIChatInputApplicationCommandsJSONBody, ApplicationCommandType, RESTPostAPIContextMenuApplicationCommandsJSONBody, APIModalInteractionResponseCallbackData, APIEmbedAuthor, APIEmbedField, APIEmbedFooter, APIEmbed, PollLayoutType, APIPollMedia, APIPartialEmoji, APIPollAnswer, RESTAPIPoll, APIAllowedMentions, AllowedMentionsTypes, MessageReferenceType, RESTAPIAttachment, RESTAPIMessageReference, RESTPostAPIChannelMessageJSONBody, APIMessageReference, APIMessageTopLevelComponent, APIAttachment, MessageFlags, APIPoll } from 'discord-api-types/v10';
+import { JSONEncodable, RawFile, FileBodyEncodable, FileBodyEncodableResult } from '@discordjs/util';
+export { RawFile } from '@discordjs/util';
 import * as ts_mixer_dist_types_types_js from 'ts-mixer/dist/types/types.js';
 import * as zod from 'zod';
 import { z } from 'zod';
 import * as zod_v4_core from 'zod/v4/core';
+import { Buffer } from 'node:buffer';
 
 interface EmojiOrLabelButtonData extends Pick<Exclude<APIButtonComponent, APIButtonComponentWithSKUId>, 'emoji' | 'label'> {
 }
@@ -172,6 +174,85 @@ declare class PremiumButtonBuilder extends BaseButtonBuilder<APIButtonComponentW
     setSKUId(skuId: Snowflake): this;
 }
 
+/**
+ * A builder that creates API-compatible JSON data for file uploads.
+ */
+declare class FileUploadBuilder extends ComponentBuilder<APIFileUploadComponent> {
+    /**
+     * @internal
+     */
+    protected readonly data: Partial<APIFileUploadComponent>;
+    /**
+     * Creates a new file upload.
+     *
+     * @param data - The API data to create this file upload with
+     * @example
+     * Creating a file upload from an API data object:
+     * ```ts
+     * const fileUpload = new FileUploadBuilder({
+     * 	custom_id: "file_upload",
+     *  min_values: 2,
+     *  max_values: 5,
+     * });
+     * ```
+     * @example
+     * Creating a file upload using setters and API data:
+     * ```ts
+     * const fileUpload = new FileUploadBuilder({
+     * 	custom_id: "file_upload",
+     *  min_values: 2,
+     *  max_values: 5,
+     * }).setRequired();
+     * ```
+     */
+    constructor(data?: Partial<APIFileUploadComponent>);
+    /**
+     * Sets the custom id for this file upload.
+     *
+     * @param customId - The custom id to use
+     */
+    setCustomId(customId: string): this;
+    /**
+     * Sets the minimum number of file uploads required.
+     *
+     * @param minValues - The minimum values that must be uploaded
+     */
+    setMinValues(minValues: number): this;
+    /**
+     * Clears the minimum values.
+     */
+    clearMinValues(): this;
+    /**
+     * Sets the maximum number of file uploads required.
+     *
+     * @param maxValues - The maximum values that can be uploaded
+     */
+    setMaxValues(maxValues: number): this;
+    /**
+     * Clears the maximum values.
+     */
+    clearMaxValues(): this;
+    /**
+     * Sets whether this file upload is required.
+     *
+     * @param required - Whether this file upload is required
+     */
+    setRequired(required?: boolean): this;
+    /**
+     * {@inheritDoc ComponentBuilder.toJSON}
+     */
+    toJSON(validationOverride?: boolean): APIFileUploadComponent;
+}
+
+declare const fileUploadPredicate: z.ZodObject<{
+    type: z.ZodLiteral<ComponentType.FileUpload>;
+    id: z.ZodOptional<z.ZodInt>;
+    custom_id: z.ZodString;
+    min_values: z.ZodOptional<z.ZodInt>;
+    max_values: z.ZodOptional<z.ZodInt>;
+    required: z.ZodOptional<z.ZodBoolean>;
+}, z.core.$strip>;
+
 /**
  * Normalizes data that is a rest parameter or an array into an array with a depth of 1.
  *
@@ -215,9 +296,9 @@ declare abstract class BaseSelectMenuBuilder<Data extends APISelectMenuComponent
      */
     setMinValues(minValues: number): this;
     /**
-     * Sets the maximum values that must be selected in the select menu.
+     * Sets the maximum values that can be selected in the select menu.
      *
-     * @param maxValues - The maximum values that must be selected
+     * @param maxValues - The maximum values that can be selected
      */
     setMaxValues(maxValues: number): this;
     /**
@@ -710,7 +791,7 @@ declare class TextInputBuilder extends ComponentBuilder<APITextInputComponent> {
 }
 
 interface LabelBuilderData extends Partial<Omit<APILabelComponent, 'component'>> {
-    component?: ChannelSelectMenuBuilder | MentionableSelectMenuBuilder | RoleSelectMenuBuilder | StringSelectMenuBuilder | TextInputBuilder | UserSelectMenuBuilder;
+    component?: ChannelSelectMenuBuilder | FileUploadBuilder | MentionableSelectMenuBuilder | RoleSelectMenuBuilder | StringSelectMenuBuilder | TextInputBuilder | UserSelectMenuBuilder;
 }
 /**
  * A builder that creates API-compatible JSON data for labels.
@@ -794,6 +875,12 @@ declare class LabelBuilder extends ComponentBuilder<APILabelComponent> {
      * @param input - A function that returns a component builder or an already built builder
      */
     setTextInputComponent(input: APITextInputComponent | TextInputBuilder | ((builder: TextInputBuilder) => TextInputBuilder)): this;
+    /**
+     * Sets a file upload component to this label.
+     *
+     * @param input - A function that returns a component builder or an already built builder
+     */
+    setFileUploadComponent(input: APIFileUploadComponent | FileUploadBuilder | ((builder: FileUploadBuilder) => FileUploadBuilder)): this;
     /**
      * {@inheritDoc ComponentBuilder.toJSON}
      */
@@ -883,6 +970,13 @@ declare const labelPredicate: z.ZodObject<{
             id: z.ZodString;
             type: z.ZodLiteral<discord_api_types_v10.SelectMenuDefaultValueType.Channel>;
         }, z.core.$strip>>>;
+    }, z.core.$strip>, z.ZodObject<{
+        type: z.ZodLiteral<ComponentType.FileUpload>;
+        id: z.ZodOptional<z.ZodInt>;
+        custom_id: z.ZodString;
+        min_values: z.ZodOptional<z.ZodInt>;
+        max_values: z.ZodOptional<z.ZodInt>;
+        required: z.ZodOptional<z.ZodBoolean>;
     }, z.core.$strip>]>;
 }, z.core.$strip>;
 
@@ -1474,7 +1568,7 @@ type MessageComponentBuilder = MessageActionRowComponentBuilder | MessageTopLeve
 /**
  * The builders that may be used for modals.
  */
-type ModalComponentBuilder = ActionRowBuilder | LabelBuilder | ModalActionRowComponentBuilder;
+type ModalComponentBuilder = ActionRowBuilder | FileUploadBuilder | LabelBuilder | ModalActionRowComponentBuilder;
 /**
  * Any button builder
  */
@@ -1494,7 +1588,7 @@ type AnyActionRowComponentBuilder = MessageActionRowComponentBuilder | ModalActi
 /**
  * Any modal component builder.
  */
-type AnyModalComponentBuilder = LabelBuilder | TextDisplayBuilder;
+type AnyModalComponentBuilder = FileUploadBuilder | LabelBuilder | TextDisplayBuilder;
 /**
  * Components here are mapped to their respective builder.
  */
@@ -1563,6 +1657,10 @@ interface MappedComponentTypes {
      * The label component type is associated with a {@link LabelBuilder}.
      */
     [ComponentType.Label]: LabelBuilder;
+    /**
+     * The file upload component type is associated with a {@link FileUploadBuilder}.
+     */
+    [ComponentType.FileUpload]: FileUploadBuilder;
 }
 /**
  * Factory for creating components from API data.
@@ -1756,7 +1854,7 @@ declare const buttonPredicate: z.ZodDiscriminatedUnion<[z.ZodObject<{
         name: z.ZodOptional<z.ZodString>;
         animated: z.ZodOptional<z.ZodBoolean>;
     }, z.core.$strict>>;
-    label: z.ZodString;
+    label: z.ZodOptional<z.ZodString>;
 }, z.core.$strict>, z.ZodObject<{
     type: z.ZodLiteral<ComponentType.Button>;
     disabled: z.ZodOptional<z.ZodBoolean>;
@@ -1766,7 +1864,7 @@ declare const buttonPredicate: z.ZodDiscriminatedUnion<[z.ZodObject<{
         name: z.ZodOptional<z.ZodString>;
         animated: z.ZodOptional<z.ZodBoolean>;
     }, z.core.$strict>>;
-    label: z.ZodString;
+    label: z.ZodOptional<z.ZodString>;
     style: z.ZodLiteral<ButtonStyle.Primary>;
 }, z.core.$strict>, z.ZodObject<{
     type: z.ZodLiteral<ComponentType.Button>;
@@ -1777,7 +1875,7 @@ declare const buttonPredicate: z.ZodDiscriminatedUnion<[z.ZodObject<{
         name: z.ZodOptional<z.ZodString>;
         animated: z.ZodOptional<z.ZodBoolean>;
     }, z.core.$strict>>;
-    label: z.ZodString;
+    label: z.ZodOptional<z.ZodString>;
     style: z.ZodLiteral<ButtonStyle.Secondary>;
 }, z.core.$strict>, z.ZodObject<{
     type: z.ZodLiteral<ComponentType.Button>;
@@ -1788,7 +1886,7 @@ declare const buttonPredicate: z.ZodDiscriminatedUnion<[z.ZodObject<{
         name: z.ZodOptional<z.ZodString>;
         animated: z.ZodOptional<z.ZodBoolean>;
     }, z.core.$strict>>;
-    label: z.ZodString;
+    label: z.ZodOptional<z.ZodString>;
     style: z.ZodLiteral<ButtonStyle.Success>;
 }, z.core.$strict>, z.ZodObject<{
     type: z.ZodLiteral<ComponentType.Button>;
@@ -1799,7 +1897,7 @@ declare const buttonPredicate: z.ZodDiscriminatedUnion<[z.ZodObject<{
         name: z.ZodOptional<z.ZodString>;
         animated: z.ZodOptional<z.ZodBoolean>;
     }, z.core.$strict>>;
-    label: z.ZodString;
+    label: z.ZodOptional<z.ZodString>;
     style: z.ZodLiteral<ButtonStyle.Danger>;
 }, z.core.$strict>, z.ZodObject<{
     type: z.ZodLiteral<ComponentType.Button>;
@@ -2740,9 +2838,7 @@ declare const chatInputCommandPredicate: z.ZodObject<{
     options: z.ZodOptional<z.ZodUnion<readonly [z.ZodArray<z.ZodObject<{
         type: z.ZodLiteral<ApplicationCommandOptionType.String | ApplicationCommandOptionType.Integer | ApplicationCommandOptionType.Boolean | ApplicationCommandOptionType.User | ApplicationCommandOptionType.Channel | ApplicationCommandOptionType.Role | ApplicationCommandOptionType.Mentionable | ApplicationCommandOptionType.Number | ApplicationCommandOptionType.Attachment>;
     }, z.core.$strip>>, z.ZodArray<z.ZodObject<{
-        type: z.ZodLiteral<ApplicationCommandOptionType.Subcommand>;
-    }, z.core.$strip>>, z.ZodArray<z.ZodObject<{
-        type: z.ZodLiteral<ApplicationCommandOptionType.SubcommandGroup>;
+        type: z.ZodUnion<readonly [z.ZodLiteral<ApplicationCommandOptionType.Subcommand>, z.ZodLiteral<ApplicationCommandOptionType.SubcommandGroup>]>;
     }, z.core.$strip>>]>>;
 }, z.core.$strip>;
 declare const chatInputCommandSubcommandGroupPredicate: z.ZodObject<{
@@ -2995,6 +3091,13 @@ declare const modalPredicate: z.ZodObject<{
                 id: z.ZodString;
                 type: z.ZodLiteral<discord_api_types_v10.SelectMenuDefaultValueType.Channel>;
             }, z.core.$strip>>>;
+        }, z.core.$strip>, z.ZodObject<{
+            type: z.ZodLiteral<ComponentType.FileUpload>;
+            id: z.ZodOptional<z.ZodInt>;
+            custom_id: z.ZodString;
+            min_values: z.ZodOptional<z.ZodInt>;
+            max_values: z.ZodOptional<z.ZodInt>;
+            required: z.ZodOptional<z.ZodBoolean>;
         }, z.core.$strip>]>;
     }, z.core.$strip>, z.ZodObject<{
         type: z.ZodLiteral<ComponentType.TextDisplay>;
@@ -3879,6 +3982,12 @@ declare class AllowedMentionsBuilder implements JSONEncodable<APIAllowedMentions
     toJSON(validationOverride?: boolean): APIAllowedMentions;
 }
 
+declare const rawFilePredicate: z.ZodObject<{
+    data: z.ZodUnion<readonly [z.ZodCustom<Buffer<ArrayBufferLike>, Buffer<ArrayBufferLike>>, z.ZodCustom<Uint8Array<ArrayBuffer>, Uint8Array<ArrayBuffer>>, z.ZodString]>;
+    name: z.ZodString;
+    contentType: z.ZodOptional<z.ZodString>;
+    key: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
 declare const attachmentPredicate: z.ZodObject<{
     id: z.ZodUnion<readonly [z.ZodString, z.ZodNumber]>;
     description: z.ZodOptional<z.ZodString>;
@@ -4018,6 +4127,132 @@ declare const messagePredicate: z.ZodUnion<readonly [z.ZodObject<{
     sticker_ids: z.ZodOptional<z.ZodNullable<z.ZodArray<z.ZodNever>>>;
     poll: z.ZodOptional<z.ZodNull>;
 }, z.core.$strip>]>;
+declare const fileBodyMessagePredicate: z.ZodObject<{
+    body: z.ZodUnion<readonly [z.ZodObject<{
+        nonce: z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodNumber]>>;
+        tts: z.ZodOptional<z.ZodBoolean>;
+        allowed_mentions: z.ZodOptional<z.ZodObject<{
+            parse: z.ZodOptional<z.ZodArray<z.ZodEnum<typeof AllowedMentionsTypes>>>;
+            roles: z.ZodOptional<z.ZodArray<z.ZodString>>;
+            users: z.ZodOptional<z.ZodArray<z.ZodString>>;
+            replied_user: z.ZodOptional<z.ZodBoolean>;
+        }, z.core.$strip>>;
+        message_reference: z.ZodOptional<z.ZodObject<{
+            channel_id: z.ZodOptional<z.ZodString>;
+            fail_if_not_exists: z.ZodOptional<z.ZodBoolean>;
+            guild_id: z.ZodOptional<z.ZodString>;
+            message_id: z.ZodString;
+            type: z.ZodOptional<z.ZodEnum<typeof MessageReferenceType>>;
+        }, z.core.$strip>>;
+        attachments: z.ZodOptional<z.ZodArray<z.ZodObject<{
+            id: z.ZodUnion<readonly [z.ZodString, z.ZodNumber]>;
+            description: z.ZodOptional<z.ZodString>;
+            duration_secs: z.ZodOptional<z.ZodNumber>;
+            filename: z.ZodOptional<z.ZodString>;
+            title: z.ZodOptional<z.ZodString>;
+            waveform: z.ZodOptional<z.ZodString>;
+        }, z.core.$strip>>>;
+        enforce_nonce: z.ZodOptional<z.ZodBoolean>;
+        content: z.ZodOptional<z.ZodString>;
+        embeds: z.ZodOptional<z.ZodArray<z.ZodObject<{
+            title: z.ZodOptional<z.ZodString>;
+            description: z.ZodOptional<z.ZodString>;
+            url: z.ZodOptional<z.ZodURL>;
+            timestamp: z.ZodOptional<z.ZodString>;
+            color: z.ZodOptional<z.ZodInt>;
+            footer: z.ZodOptional<z.ZodObject<{
+                text: z.ZodString;
+                icon_url: z.ZodOptional<z.ZodURL>;
+            }, z.core.$strip>>;
+            image: z.ZodOptional<z.ZodObject<{
+                url: z.ZodURL;
+            }, z.core.$strip>>;
+            thumbnail: z.ZodOptional<z.ZodObject<{
+                url: z.ZodURL;
+            }, z.core.$strip>>;
+            author: z.ZodOptional<z.ZodObject<{
+                name: z.ZodString;
+                icon_url: z.ZodOptional<z.ZodURL>;
+                url: z.ZodOptional<z.ZodURL>;
+            }, z.core.$strip>>;
+            fields: z.ZodOptional<z.ZodArray<z.ZodObject<{
+                name: z.ZodString;
+                value: z.ZodString;
+                inline: z.ZodOptional<z.ZodBoolean>;
+            }, z.core.$strip>>>;
+        }, z.core.$strip>>>;
+        sticker_ids: z.ZodOptional<z.ZodArray<z.ZodString>>;
+        poll: z.ZodOptional<z.ZodObject<{
+            question: z.ZodObject<{
+                text: z.ZodString;
+            }, z.core.$strip>;
+            answers: z.ZodArray<z.ZodObject<{
+                poll_media: z.ZodObject<{
+                    text: z.ZodString;
+                    emoji: z.ZodOptional<z.ZodObject<{
+                        id: z.ZodOptional<z.ZodString>;
+                        name: z.ZodOptional<z.ZodString>;
+                        animated: z.ZodOptional<z.ZodBoolean>;
+                    }, z.core.$strict>>;
+                }, z.core.$strip>;
+            }, z.core.$strip>>;
+            duration: z.ZodOptional<z.ZodNumber>;
+            allow_multiselect: z.ZodOptional<z.ZodBoolean>;
+            layout_type: z.ZodOptional<z.ZodEnum<typeof discord_api_types_v10.PollLayoutType>>;
+        }, z.core.$strip>>;
+        components: z.ZodOptional<z.ZodArray<z.ZodObject<{
+            type: z.ZodLiteral<ComponentType.ActionRow>;
+            components: z.ZodArray<z.ZodObject<{
+                type: z.ZodLiteral<ComponentType.Button | ComponentType.StringSelect | ComponentType.UserSelect | ComponentType.RoleSelect | ComponentType.MentionableSelect | ComponentType.ChannelSelect>;
+            }, z.core.$strip>>;
+        }, z.core.$strip>>>;
+        flags: z.ZodOptional<z.ZodInt>;
+    }, z.core.$strip>, z.ZodObject<{
+        nonce: z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodNumber]>>;
+        tts: z.ZodOptional<z.ZodBoolean>;
+        allowed_mentions: z.ZodOptional<z.ZodObject<{
+            parse: z.ZodOptional<z.ZodArray<z.ZodEnum<typeof AllowedMentionsTypes>>>;
+            roles: z.ZodOptional<z.ZodArray<z.ZodString>>;
+            users: z.ZodOptional<z.ZodArray<z.ZodString>>;
+            replied_user: z.ZodOptional<z.ZodBoolean>;
+        }, z.core.$strip>>;
+        message_reference: z.ZodOptional<z.ZodObject<{
+            channel_id: z.ZodOptional<z.ZodString>;
+            fail_if_not_exists: z.ZodOptional<z.ZodBoolean>;
+            guild_id: z.ZodOptional<z.ZodString>;
+            message_id: z.ZodString;
+            type: z.ZodOptional<z.ZodEnum<typeof MessageReferenceType>>;
+        }, z.core.$strip>>;
+        attachments: z.ZodOptional<z.ZodArray<z.ZodObject<{
+            id: z.ZodUnion<readonly [z.ZodString, z.ZodNumber]>;
+            description: z.ZodOptional<z.ZodString>;
+            duration_secs: z.ZodOptional<z.ZodNumber>;
+            filename: z.ZodOptional<z.ZodString>;
+            title: z.ZodOptional<z.ZodString>;
+            waveform: z.ZodOptional<z.ZodString>;
+        }, z.core.$strip>>>;
+        enforce_nonce: z.ZodOptional<z.ZodBoolean>;
+        components: z.ZodArray<z.ZodUnion<readonly [z.ZodObject<{
+            type: z.ZodLiteral<ComponentType.ActionRow>;
+            components: z.ZodArray<z.ZodObject<{
+                type: z.ZodLiteral<ComponentType.Button | ComponentType.StringSelect | ComponentType.UserSelect | ComponentType.RoleSelect | ComponentType.MentionableSelect | ComponentType.ChannelSelect>;
+            }, z.core.$strip>>;
+        }, z.core.$strip>, z.ZodObject<{
+            type: z.ZodLiteral<ComponentType.Section | ComponentType.TextDisplay | ComponentType.Thumbnail | ComponentType.MediaGallery | ComponentType.File | ComponentType.Separator | ComponentType.Container>;
+        }, z.core.$strip>]>>;
+        flags: z.ZodInt;
+        content: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        embeds: z.ZodOptional<z.ZodNullable<z.ZodArray<z.ZodNever>>>;
+        sticker_ids: z.ZodOptional<z.ZodNullable<z.ZodArray<z.ZodNever>>>;
+        poll: z.ZodOptional<z.ZodNull>;
+    }, z.core.$strip>]>;
+    files: z.ZodArray<z.ZodObject<{
+        data: z.ZodUnion<readonly [z.ZodCustom<Buffer<ArrayBufferLike>, Buffer<ArrayBufferLike>>, z.ZodCustom<Uint8Array<ArrayBuffer>, Uint8Array<ArrayBuffer>>, z.ZodString]>;
+        name: z.ZodString;
+        contentType: z.ZodOptional<z.ZodString>;
+        key: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>>;
+}, z.core.$strip>;
 
 /**
  * A builder that creates API-compatible JSON data for attachments.
@@ -4027,10 +4262,25 @@ declare class AttachmentBuilder implements JSONEncodable<RESTAPIAttachment> {
      * The API data associated with this attachment.
      */
     private readonly data;
+    /**
+     * This data is not included in the output of `toJSON()`. For this class specifically, this refers to binary data
+     * that will wind up being included in the multipart/form-data request, if used with the `MessageBuilder`.
+     * To retrieve this data, use {@link getRawFile}.
+     *
+     * @remarks This cannot be set via the constructor, primarily because of the behavior described
+     * {@link https://discord.com/developers/docs/reference#editing-message-attachments | here}.
+     * That is, when editing a message's attachments, you should only be providing file data for new attachments.
+     */
+    private readonly fileData;
     /**
      * Creates a new attachment builder.
      *
      * @param data - The API data to create this attachment with
+     * @example
+     * ```ts
+     * const attachment = new AttachmentBuilder().setId(1).setFileData(':)').setFilename('smiley.txt')
+     * ```
+     * @remarks Please note that the `id` field is required, it's rather easy to miss!
      */
     constructor(data?: Partial<RESTAPIAttachment>);
     /**
@@ -4038,7 +4288,7 @@ declare class AttachmentBuilder implements JSONEncodable<RESTAPIAttachment> {
      *
      * @param id - The id of the attachment
      */
-    setId(id: Snowflake): this;
+    setId(id: Snowflake | number): this;
     /**
      * Sets the description of this attachment.
      *
@@ -4069,6 +4319,33 @@ declare class AttachmentBuilder implements JSONEncodable<RESTAPIAttachment> {
      * Clears the filename of this attachment.
      */
     clearFilename(): this;
+    /**
+     * Sets the file data to upload with this attachment.
+     *
+     * @param data - The file data
+     * @remarks Note that this data is NOT included in the {@link toJSON} output. To retrieve it, use {@link getRawFile}.
+     */
+    setFileData(data: Buffer | Uint8Array | string): this;
+    /**
+     * Clears the file data from this attachment.
+     */
+    clearFileData(): this;
+    /**
+     * Sets the content type of the file data to upload with this attachment.
+     *
+     * @remarks Note that this data is NOT included in the {@link toJSON} output. To retrieve it, use {@link getRawFile}.
+     */
+    setFileContentType(contentType: string): this;
+    /**
+     * Clears the content type of the file data from this attachment.
+     */
+    clearFileContentType(): this;
+    /**
+     * Converts this attachment to a {@link RawFile} for uploading.
+     *
+     * @returns A {@link RawFile} object, or `undefined` if no file data is set
+     */
+    getRawFile(): Partial<RawFile> | undefined;
     /**
      * Sets the title of this attachment.
      *
@@ -4176,7 +4453,7 @@ interface MessageBuilderData extends Partial<Omit<RESTPostAPIChannelMessageJSONB
 /**
  * A builder that creates API-compatible JSON data for messages.
  */
-declare class MessageBuilder implements JSONEncodable<RESTPostAPIChannelMessageJSONBody> {
+declare class MessageBuilder implements JSONEncodable<RESTPostAPIChannelMessageJSONBody>, FileBodyEncodable<RESTPostAPIChannelMessageJSONBody> {
     /**
      * The API data associated with this message.
      */
@@ -4289,7 +4566,7 @@ declare class MessageBuilder implements JSONEncodable<RESTPostAPIChannelMessageJ
      *
      * @param allowedMentions - The allowed mentions to set
      */
-    setAllowedMentions(allowedMentions: AllowedMentionsBuilder | APIAllowedMentions | ((builder: AllowedMentionsBuilder) => AllowedMentionsBuilder)): this;
+    setAllowedMentions(allowedMentions?: AllowedMentionsBuilder | APIAllowedMentions | ((builder: AllowedMentionsBuilder) => AllowedMentionsBuilder)): this;
     /**
      * Updates the allowed mentions for this message (and creates it if it doesn't exist)
      *
@@ -4509,15 +4786,17 @@ declare class MessageBuilder implements JSONEncodable<RESTPostAPIChannelMessageJ
      * @param validationOverride - Force validation to run/not run regardless of your global preference
      */
     toJSON(validationOverride?: boolean): RESTPostAPIChannelMessageJSONBody;
+    /**
+     * Serializes this builder to both JSON body and file data for multipart/form-data requests.
+     *
+     * @param validationOverride - Force validation to run/not run regardless of your global preference
+     * @remarks
+     * This method extracts file data from attachments that have files set via {@link AttachmentBuilder.setFileData}.
+     * The returned body includes attachment metadata, while files contains the binary data for upload.
+     */
+    toFileBody(validationOverride?: boolean): FileBodyEncodableResult<RESTPostAPIChannelMessageJSONBody>;
 }
 
-/**
- * Calculates the length of the embed.
- *
- * @param data - The embed data to check
- */
-declare function embedLength(data: APIEmbed): number;
-
 /**
  * "Resolves" a builder from the 3 ways it can be input:
  * 1. A clean instance
@@ -4564,6 +4843,7 @@ declare class ValidationError extends Error {
 
 declare const idPredicate: z.ZodOptional<z.ZodInt>;
 declare const customIdPredicate: z.ZodString;
+declare const snowflakePredicate: z.ZodString;
 declare const memberPermissionsPredicate: z.ZodCoercedBigInt<unknown>;
 declare const localeMapPredicate: z.ZodObject<Record<Locale, z.ZodOptional<z.ZodString>>, z.core.$strict>;
 
@@ -4575,4 +4855,4 @@ declare const localeMapPredicate: z.ZodObject<Record<Locale, z.ZodOptional<z.Zod
  */
 declare const version: string;
 
-export { ActionRowBuilder, type ActionRowBuilderData, AllowedMentionsBuilder, type AnyActionRowComponentBuilder, type AnyModalComponentBuilder, type ApplicationCommandNumericOptionMinMaxValueData, ApplicationCommandNumericOptionMinMaxValueMixin, type ApplicationCommandOptionAllowedChannelType, ApplicationCommandOptionAllowedChannelTypes, ApplicationCommandOptionBase, type ApplicationCommandOptionBaseData, type ApplicationCommandOptionChannelTypesData, ApplicationCommandOptionChannelTypesMixin, type ApplicationCommandOptionWithAutocompleteData, ApplicationCommandOptionWithAutocompleteMixin, type ApplicationCommandOptionWithChoicesData, ApplicationCommandOptionWithChoicesMixin, AttachmentBuilder, type AutocompletableOptions, BaseButtonBuilder, BaseSelectMenuBuilder, type ButtonBuilder, ChannelSelectMenuBuilder, ChatInputCommandAttachmentOption, ChatInputCommandBooleanOption, ChatInputCommandBuilder, ChatInputCommandChannelOption, ChatInputCommandIntegerOption, ChatInputCommandMentionableOption, ChatInputCommandNumberOption, ChatInputCommandRoleOption, ChatInputCommandStringOption, ChatInputCommandSubcommandBuilder, ChatInputCommandSubcommandGroupBuilder, type ChatInputCommandSubcommandGroupData, ChatInputCommandUserOption, CommandBuilder, type CommandData, ComponentBuilder, type ComponentBuilderBaseData, ContainerBuilder, type ContainerBuilderData, type ContainerComponentBuilders, ContextMenuCommandBuilder, type ContextMenuCommandType, CustomIdButtonBuilder, type CustomIdButtonStyle, DangerButtonBuilder, EmbedAuthorBuilder, EmbedBuilder, type EmbedBuilderData, EmbedFieldBuilder, EmbedFooterBuilder, type EmojiOrLabelButtonData, EmojiOrLabelButtonMixin, FileBuilder, LabelBuilder, type LabelBuilderData, LinkButtonBuilder, type MappedComponentTypes, MediaGalleryBuilder, type MediaGalleryBuilderData, MediaGalleryItemBuilder, MentionableSelectMenuBuilder, type MessageActionRowComponentBuilder, MessageBuilder, type MessageBuilderData, type MessageComponentBuilder, MessageContextCommandBuilder, MessageReferenceBuilder, type MessageTopLevelComponentBuilder, type ModalActionRowComponentBuilder, ModalBuilder, type ModalBuilderData, type ModalComponentBuilder, PollAnswerBuilder, type PollAnswerData, PollAnswerMediaBuilder, PollBuilder, type PollData, PollMediaBuilder, PollQuestionBuilder, PremiumButtonBuilder, PrimaryButtonBuilder, type RestOrArray, RoleSelectMenuBuilder, SecondaryButtonBuilder, SectionBuilder, type SectionBuilderAccessory, type SectionBuilderData, SeparatorBuilder, SharedChatInputCommandOptions, type SharedChatInputCommandOptionsData, SharedChatInputCommandSubcommands, type SharedChatInputCommandSubcommandsData, SharedName, SharedNameAndDescription, type SharedNameAndDescriptionData, type SharedNameData, StringSelectMenuBuilder, type StringSelectMenuData, StringSelectMenuOptionBuilder, SuccessButtonBuilder, TextDisplayBuilder, TextInputBuilder, ThumbnailBuilder, UserContextCommandBuilder, UserSelectMenuBuilder, ValidationError, actionRowPredicate, allowedMentionPredicate, attachmentPredicate, basicOptionPredicate, buttonPredicate, channelOptionPredicate, chatInputCommandPredicate, chatInputCommandSubcommandGroupPredicate, chatInputCommandSubcommandPredicate, containerPredicate, createComponentBuilder, customIdPredicate, disableValidators, embedAuthorPredicate, embedFieldPredicate, embedFooterPredicate, embedLength, embedPredicate, emojiPredicate, enableValidators, filePredicate, idPredicate, integerOptionPredicate, isValidationEnabled, labelPredicate, localeMapPredicate, mediaGalleryItemPredicate, mediaGalleryPredicate, memberPermissionsPredicate, messageCommandPredicate, messagePredicate, messageReferencePredicate, modalPredicate, normalizeArray, numberOptionPredicate, pollAnswerMediaPredicate, pollAnswerPredicate, pollPredicate, pollQuestionPredicate, resolveAccessoryComponent, resolveBuilder, sectionPredicate, selectMenuChannelPredicate, selectMenuMentionablePredicate, selectMenuRolePredicate, selectMenuStringOptionPredicate, selectMenuStringPredicate, selectMenuUserPredicate, separatorPredicate, stringOptionPredicate, textDisplayPredicate, textInputPredicate, thumbnailPredicate, userCommandPredicate, version };
+export { ActionRowBuilder, type ActionRowBuilderData, AllowedMentionsBuilder, type AnyActionRowComponentBuilder, type AnyModalComponentBuilder, type ApplicationCommandNumericOptionMinMaxValueData, ApplicationCommandNumericOptionMinMaxValueMixin, type ApplicationCommandOptionAllowedChannelType, ApplicationCommandOptionAllowedChannelTypes, ApplicationCommandOptionBase, type ApplicationCommandOptionBaseData, type ApplicationCommandOptionChannelTypesData, ApplicationCommandOptionChannelTypesMixin, type ApplicationCommandOptionWithAutocompleteData, ApplicationCommandOptionWithAutocompleteMixin, type ApplicationCommandOptionWithChoicesData, ApplicationCommandOptionWithChoicesMixin, AttachmentBuilder, type AutocompletableOptions, BaseButtonBuilder, BaseSelectMenuBuilder, type ButtonBuilder, ChannelSelectMenuBuilder, ChatInputCommandAttachmentOption, ChatInputCommandBooleanOption, ChatInputCommandBuilder, ChatInputCommandChannelOption, ChatInputCommandIntegerOption, ChatInputCommandMentionableOption, ChatInputCommandNumberOption, ChatInputCommandRoleOption, ChatInputCommandStringOption, ChatInputCommandSubcommandBuilder, ChatInputCommandSubcommandGroupBuilder, type ChatInputCommandSubcommandGroupData, ChatInputCommandUserOption, CommandBuilder, type CommandData, ComponentBuilder, type ComponentBuilderBaseData, ContainerBuilder, type ContainerBuilderData, type ContainerComponentBuilders, ContextMenuCommandBuilder, type ContextMenuCommandType, CustomIdButtonBuilder, type CustomIdButtonStyle, DangerButtonBuilder, EmbedAuthorBuilder, EmbedBuilder, type EmbedBuilderData, EmbedFieldBuilder, EmbedFooterBuilder, type EmojiOrLabelButtonData, EmojiOrLabelButtonMixin, FileBuilder, FileUploadBuilder, LabelBuilder, type LabelBuilderData, LinkButtonBuilder, type MappedComponentTypes, MediaGalleryBuilder, type MediaGalleryBuilderData, MediaGalleryItemBuilder, MentionableSelectMenuBuilder, type MessageActionRowComponentBuilder, MessageBuilder, type MessageBuilderData, type MessageComponentBuilder, MessageContextCommandBuilder, MessageReferenceBuilder, type MessageTopLevelComponentBuilder, type ModalActionRowComponentBuilder, ModalBuilder, type ModalBuilderData, type ModalComponentBuilder, PollAnswerBuilder, type PollAnswerData, PollAnswerMediaBuilder, PollBuilder, type PollData, PollMediaBuilder, PollQuestionBuilder, PremiumButtonBuilder, PrimaryButtonBuilder, type RestOrArray, RoleSelectMenuBuilder, SecondaryButtonBuilder, SectionBuilder, type SectionBuilderAccessory, type SectionBuilderData, SeparatorBuilder, SharedChatInputCommandOptions, type SharedChatInputCommandOptionsData, SharedChatInputCommandSubcommands, type SharedChatInputCommandSubcommandsData, SharedName, SharedNameAndDescription, type SharedNameAndDescriptionData, type SharedNameData, StringSelectMenuBuilder, type StringSelectMenuData, StringSelectMenuOptionBuilder, SuccessButtonBuilder, TextDisplayBuilder, TextInputBuilder, ThumbnailBuilder, UserContextCommandBuilder, UserSelectMenuBuilder, ValidationError, actionRowPredicate, allowedMentionPredicate, attachmentPredicate, basicOptionPredicate, buttonPredicate, channelOptionPredicate, chatInputCommandPredicate, chatInputCommandSubcommandGroupPredicate, chatInputCommandSubcommandPredicate, containerPredicate, createComponentBuilder, customIdPredicate, disableValidators, embedAuthorPredicate, embedFieldPredicate, embedFooterPredicate, embedPredicate, emojiPredicate, enableValidators, fileBodyMessagePredicate, filePredicate, fileUploadPredicate, idPredicate, integerOptionPredicate, isValidationEnabled, labelPredicate, localeMapPredicate, mediaGalleryItemPredicate, mediaGalleryPredicate, memberPermissionsPredicate, messageCommandPredicate, messagePredicate, messageReferencePredicate, modalPredicate, normalizeArray, numberOptionPredicate, pollAnswerMediaPredicate, pollAnswerPredicate, pollPredicate, pollQuestionPredicate, rawFilePredicate, resolveAccessoryComponent, resolveBuilder, sectionPredicate, selectMenuChannelPredicate, selectMenuMentionablePredicate, selectMenuRolePredicate, selectMenuStringOptionPredicate, selectMenuStringPredicate, selectMenuUserPredicate, separatorPredicate, snowflakePredicate, stringOptionPredicate, textDisplayPredicate, textInputPredicate, thumbnailPredicate, userCommandPredicate, version };