@discordjs/builders 2.0.0-dev.1763510521-315f42278 → 2.0.0-dev.1763596917-68bb8af58

package/dist/index.mjs

@@ -4645,9 +4645,18 @@ var PollBuilder = class {
 };
 
 // src/messages/Assertions.ts
+import { Buffer as Buffer2 } from "buffer";
 import { AllowedMentionsTypes, ComponentType as ComponentType27, MessageFlags, MessageReferenceType } from "discord-api-types/v10";
 import { z as z13 } from "zod";
+var fileKeyRegex = /^files\[(?<placeholder>\d+?)]$/;
+var rawFilePredicate = z13.object({
+  data: z13.union([z13.instanceof(Buffer2), z13.instanceof(Uint8Array), z13.string()]),
+  name: z13.string().min(1),
+  contentType: z13.string().optional(),
+  key: z13.string().regex(fileKeyRegex).optional()
+});
 var attachmentPredicate = z13.object({
+  // As a string it only makes sense for edits when we do have an attachment snowflake
   id: z13.union([z13.string(), z13.number()]),
   description: z13.string().max(1024).optional(),
   duration_secs: z13.number().max(2 ** 31 - 1).optional(),
@@ -4734,6 +4743,11 @@ var messageComponentsV2Predicate = baseMessagePredicate.extend({
   poll: z13.null().optional()
 });
 var messagePredicate = z13.union([messageNoComponentsV2Predicate, messageComponentsV2Predicate]);
+var fileBodyMessagePredicate = z13.object({
+  body: messagePredicate,
+  // No min length to support message edits
+  files: rawFilePredicate.array().max(10)
+});
 
 // src/messages/AllowedMentions.ts
 var AllowedMentionsBuilder = class {
@@ -4918,6 +4932,16 @@ var AttachmentBuilder = class {
    * The API data associated with this attachment.
    */
   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.
+   */
+  fileData;
   /**
    * Creates a new attachment builder.
    *
@@ -4925,6 +4949,7 @@ var AttachmentBuilder = class {
    */
   constructor(data = {}) {
     this.data = structuredClone(data);
+    this.fileData = {};
   }
   /**
    * Sets the id of the attachment.
@@ -4983,6 +5008,54 @@ var AttachmentBuilder = class {
     this.data.filename = void 0;
     return 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) {
+    this.fileData.data = data;
+    return this;
+  }
+  /**
+   * Clears the file data from this attachment.
+   */
+  clearFileData() {
+    this.fileData.data = void 0;
+    return 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) {
+    this.fileData.contentType = contentType;
+    return this;
+  }
+  /**
+   * Clears the content type of the file data from this attachment.
+   */
+  clearFileContentType() {
+    this.fileData.contentType = void 0;
+    return this;
+  }
+  /**
+   * Converts this attachment to a {@link RawFile} for uploading.
+   *
+   * @returns A {@link RawFile} object, or `undefined` if no file data is set
+   */
+  getRawFile() {
+    if (!this.fileData?.data) {
+      return;
+    }
+    return {
+      ...this.fileData,
+      name: this.data.filename,
+      key: this.data.id ? `files[${this.data.id}]` : void 0
+    };
+  }
   /**
    * Sets the title of this attachment.
    *
@@ -5620,10 +5693,31 @@ var MessageBuilder = class {
     validate(messagePredicate, data, validationOverride);
     return data;
   }
+  /**
+   * 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) {
+    const body = this.toJSON(false);
+    const files = [];
+    for (const attachment of this.data.attachments) {
+      const rawFile = attachment.getRawFile();
+      if (rawFile?.data || rawFile?.contentType) {
+        files.push(rawFile);
+      }
+    }
+    const combined = { body, files };
+    validate(fileBodyMessagePredicate, combined, validationOverride);
+    return combined;
+  }
 };
 
 // src/index.ts
-var version = "2.0.0-dev.1763510521-315f42278";
+var version = "2.0.0-dev.1763596917-68bb8af58";
 export {
   ActionRowBuilder,
   AllowedMentionsBuilder,
@@ -5715,6 +5809,7 @@ export {
   embedPredicate,
   emojiPredicate,
   enableValidators,
+  fileBodyMessagePredicate,
   filePredicate,
   fileUploadPredicate,
   idPredicate,
@@ -5735,6 +5830,7 @@ export {
   pollAnswerPredicate,
   pollPredicate,
   pollQuestionPredicate,
+  rawFilePredicate,
   resolveAccessoryComponent,
   resolveBuilder,
   sectionPredicate,