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

package/dist/index.js

@@ -111,6 +111,7 @@ __export(index_exports, {
   embedPredicate: () => embedPredicate,
   emojiPredicate: () => emojiPredicate,
   enableValidators: () => enableValidators,
+  fileBodyMessagePredicate: () => fileBodyMessagePredicate,
   filePredicate: () => filePredicate,
   fileUploadPredicate: () => fileUploadPredicate,
   idPredicate: () => idPredicate,
@@ -131,6 +132,7 @@ __export(index_exports, {
   pollAnswerPredicate: () => pollAnswerPredicate,
   pollPredicate: () => pollPredicate,
   pollQuestionPredicate: () => pollQuestionPredicate,
+  rawFilePredicate: () => rawFilePredicate,
   resolveAccessoryComponent: () => resolveAccessoryComponent,
   resolveBuilder: () => resolveBuilder,
   sectionPredicate: () => sectionPredicate,
@@ -4773,9 +4775,18 @@ var PollBuilder = class {
 };
 
 // src/messages/Assertions.ts
+var import_node_buffer = require("buffer");
 var import_v1045 = require("discord-api-types/v10");
 var import_zod13 = require("zod");
+var fileKeyRegex = /^files\[(?<placeholder>\d+?)]$/;
+var rawFilePredicate = import_zod13.z.object({
+  data: import_zod13.z.union([import_zod13.z.instanceof(import_node_buffer.Buffer), import_zod13.z.instanceof(Uint8Array), import_zod13.z.string()]),
+  name: import_zod13.z.string().min(1),
+  contentType: import_zod13.z.string().optional(),
+  key: import_zod13.z.string().regex(fileKeyRegex).optional()
+});
 var attachmentPredicate = import_zod13.z.object({
+  // As a string it only makes sense for edits when we do have an attachment snowflake
   id: import_zod13.z.union([import_zod13.z.string(), import_zod13.z.number()]),
   description: import_zod13.z.string().max(1024).optional(),
   duration_secs: import_zod13.z.number().max(2 ** 31 - 1).optional(),
@@ -4862,6 +4873,11 @@ var messageComponentsV2Predicate = baseMessagePredicate.extend({
   poll: import_zod13.z.null().optional()
 });
 var messagePredicate = import_zod13.z.union([messageNoComponentsV2Predicate, messageComponentsV2Predicate]);
+var fileBodyMessagePredicate = import_zod13.z.object({
+  body: messagePredicate,
+  // No min length to support message edits
+  files: rawFilePredicate.array().max(10)
+});
 
 // src/messages/AllowedMentions.ts
 var AllowedMentionsBuilder = class {
@@ -5046,6 +5062,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.
    *
@@ -5053,6 +5079,7 @@ var AttachmentBuilder = class {
    */
   constructor(data = {}) {
     this.data = structuredClone(data);
+    this.fileData = {};
   }
   /**
    * Sets the id of the attachment.
@@ -5111,6 +5138,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.
    *
@@ -5748,10 +5823,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";
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
   ActionRowBuilder,
@@ -5844,6 +5940,7 @@ var version = "2.0.0-dev.1763510521-315f42278";
   embedPredicate,
   emojiPredicate,
   enableValidators,
+  fileBodyMessagePredicate,
   filePredicate,
   fileUploadPredicate,
   idPredicate,
@@ -5864,6 +5961,7 @@ var version = "2.0.0-dev.1763510521-315f42278";
   pollAnswerPredicate,
   pollPredicate,
   pollQuestionPredicate,
+  rawFilePredicate,
   resolveAccessoryComponent,
   resolveBuilder,
   sectionPredicate,