@discordjs/builders 2.0.0-pr-11005.1765454364-f3f6d34e7 → 2.0.0-pr-11005.1765463668-087384722

package/dist/index.js

@@ -107,16 +107,16 @@ __export(index_exports, {
   embedAuthorPredicate: () => embedAuthorPredicate,
   embedFieldPredicate: () => embedFieldPredicate,
   embedFooterPredicate: () => embedFooterPredicate,
-  embedLength: () => embedLength,
   embedPredicate: () => embedPredicate,
   emojiPredicate: () => emojiPredicate,
   enableValidators: () => enableValidators,
+  fileBodyMessagePredicate: () => fileBodyMessagePredicate,
   filePredicate: () => filePredicate,
   fileUploadPredicate: () => fileUploadPredicate,
   idPredicate: () => idPredicate,
   integerOptionPredicate: () => integerOptionPredicate,
   isValidationEnabled: () => isValidationEnabled,
-  labelPredicate: () => labelPredicate2,
+  labelPredicate: () => labelPredicate,
   localeMapPredicate: () => localeMapPredicate,
   mediaGalleryItemPredicate: () => mediaGalleryItemPredicate,
   mediaGalleryPredicate: () => mediaGalleryPredicate,
@@ -131,6 +131,7 @@ __export(index_exports, {
   pollAnswerPredicate: () => pollAnswerPredicate,
   pollPredicate: () => pollPredicate,
   pollQuestionPredicate: () => pollQuestionPredicate,
+  rawFilePredicate: () => rawFilePredicate,
   resolveAccessoryComponent: () => resolveAccessoryComponent,
   resolveBuilder: () => resolveBuilder,
   sectionPredicate: () => sectionPredicate,
@@ -141,6 +142,7 @@ __export(index_exports, {
   selectMenuStringPredicate: () => selectMenuStringPredicate,
   selectMenuUserPredicate: () => selectMenuUserPredicate,
   separatorPredicate: () => separatorPredicate,
+  snowflakePredicate: () => snowflakePredicate,
   stringOptionPredicate: () => stringOptionPredicate,
   textDisplayPredicate: () => textDisplayPredicate,
   textInputPredicate: () => textInputPredicate,
@@ -244,15 +246,15 @@ var import_v10 = require("discord-api-types/v10");
 var import_zod2 = require("zod");
 var idPredicate = import_zod2.z.int().min(0).max(2147483647).optional();
 var customIdPredicate = import_zod2.z.string().min(1).max(100);
+var snowflakePredicate = import_zod2.z.string().regex(/^(?:0|[1-9]\d*)$/);
 var memberPermissionsPredicate = import_zod2.z.coerce.bigint();
 var localeMapPredicate = import_zod2.z.strictObject(
   Object.fromEntries(Object.values(import_v10.Locale).map((loc) => [loc, import_zod2.z.string().optional()]))
 );
 
 // src/components/Assertions.ts
-var labelPredicate = import_zod3.z.string().min(1).max(80);
 var emojiPredicate = import_zod3.z.strictObject({
-  id: import_zod3.z.string().optional(),
+  id: snowflakePredicate.optional(),
   name: import_zod3.z.string().min(2).max(32).optional(),
   animated: import_zod3.z.boolean().optional()
 }).refine((data) => data.id !== void 0 || data.name !== void 0, {
@@ -262,24 +264,29 @@ var buttonPredicateBase = import_zod3.z.strictObject({
   type: import_zod3.z.literal(import_v102.ComponentType.Button),
   disabled: import_zod3.z.boolean().optional()
 });
+var buttonLabelPredicate = import_zod3.z.string().min(1).max(80);
 var buttonCustomIdPredicateBase = buttonPredicateBase.extend({
   custom_id: customIdPredicate,
   emoji: emojiPredicate.optional(),
-  label: labelPredicate
+  label: buttonLabelPredicate.optional()
+}).refine((data) => data.emoji !== void 0 || data.label !== void 0, {
+  message: "Buttons with a custom id must have either an emoji or a label."
 });
-var buttonPrimaryPredicate = buttonCustomIdPredicateBase.extend({ style: import_zod3.z.literal(import_v102.ButtonStyle.Primary) });
-var buttonSecondaryPredicate = buttonCustomIdPredicateBase.extend({ style: import_zod3.z.literal(import_v102.ButtonStyle.Secondary) });
-var buttonSuccessPredicate = buttonCustomIdPredicateBase.extend({ style: import_zod3.z.literal(import_v102.ButtonStyle.Success) });
-var buttonDangerPredicate = buttonCustomIdPredicateBase.extend({ style: import_zod3.z.literal(import_v102.ButtonStyle.Danger) });
+var buttonPrimaryPredicate = buttonCustomIdPredicateBase.safeExtend({ style: import_zod3.z.literal(import_v102.ButtonStyle.Primary) });
+var buttonSecondaryPredicate = buttonCustomIdPredicateBase.safeExtend({ style: import_zod3.z.literal(import_v102.ButtonStyle.Secondary) });
+var buttonSuccessPredicate = buttonCustomIdPredicateBase.safeExtend({ style: import_zod3.z.literal(import_v102.ButtonStyle.Success) });
+var buttonDangerPredicate = buttonCustomIdPredicateBase.safeExtend({ style: import_zod3.z.literal(import_v102.ButtonStyle.Danger) });
 var buttonLinkPredicate = buttonPredicateBase.extend({
   style: import_zod3.z.literal(import_v102.ButtonStyle.Link),
   url: import_zod3.z.url({ protocol: /^(?:https?|discord)$/ }).max(512),
   emoji: emojiPredicate.optional(),
-  label: labelPredicate
+  label: buttonLabelPredicate.optional()
+}).refine((data) => data.emoji !== void 0 || data.label !== void 0, {
+  message: "Link buttons must have either an emoji or a label."
 });
 var buttonPremiumPredicate = buttonPredicateBase.extend({
   style: import_zod3.z.literal(import_v102.ButtonStyle.Premium),
-  sku_id: import_zod3.z.string()
+  sku_id: snowflakePredicate
 });
 var buttonPredicate = import_zod3.z.discriminatedUnion("style", [
   buttonLinkPredicate,
@@ -300,21 +307,21 @@ var selectMenuBasePredicate = import_zod3.z.object({
 var selectMenuChannelPredicate = selectMenuBasePredicate.extend({
   type: import_zod3.z.literal(import_v102.ComponentType.ChannelSelect),
   channel_types: import_zod3.z.enum(import_v102.ChannelType).array().optional(),
-  default_values: import_zod3.z.object({ id: import_zod3.z.string(), type: import_zod3.z.literal(import_v102.SelectMenuDefaultValueType.Channel) }).array().max(25).optional()
+  default_values: import_zod3.z.object({ id: snowflakePredicate, type: import_zod3.z.literal(import_v102.SelectMenuDefaultValueType.Channel) }).array().max(25).optional()
 });
 var selectMenuMentionablePredicate = selectMenuBasePredicate.extend({
   type: import_zod3.z.literal(import_v102.ComponentType.MentionableSelect),
   default_values: import_zod3.z.object({
-    id: import_zod3.z.string(),
+    id: snowflakePredicate,
     type: import_zod3.z.literal([import_v102.SelectMenuDefaultValueType.Role, import_v102.SelectMenuDefaultValueType.User])
   }).array().max(25).optional()
 });
 var selectMenuRolePredicate = selectMenuBasePredicate.extend({
   type: import_zod3.z.literal(import_v102.ComponentType.RoleSelect),
-  default_values: import_zod3.z.object({ id: import_zod3.z.string(), type: import_zod3.z.literal(import_v102.SelectMenuDefaultValueType.Role) }).array().max(25).optional()
+  default_values: import_zod3.z.object({ id: snowflakePredicate, type: import_zod3.z.literal(import_v102.SelectMenuDefaultValueType.Role) }).array().max(25).optional()
 });
 var selectMenuStringOptionPredicate = import_zod3.z.object({
-  label: labelPredicate,
+  label: import_zod3.z.string().min(1).max(100),
   value: import_zod3.z.string().min(1).max(100),
   description: import_zod3.z.string().min(1).max(100).optional(),
   emoji: emojiPredicate.optional(),
@@ -352,7 +359,7 @@ var selectMenuStringPredicate = selectMenuBasePredicate.extend({
 });
 var selectMenuUserPredicate = selectMenuBasePredicate.extend({
   type: import_zod3.z.literal(import_v102.ComponentType.UserSelect),
-  default_values: import_zod3.z.object({ id: import_zod3.z.string(), type: import_zod3.z.literal(import_v102.SelectMenuDefaultValueType.User) }).array().max(25).optional()
+  default_values: import_zod3.z.object({ id: snowflakePredicate, type: import_zod3.z.literal(import_v102.SelectMenuDefaultValueType.User) }).array().max(25).optional()
 });
 var actionRowPredicate = import_zod3.z.object({
   id: idPredicate,
@@ -2644,7 +2651,7 @@ __name(resolveAccessoryComponent, "resolveAccessoryComponent");
 // src/components/label/Assertions.ts
 var import_v1025 = require("discord-api-types/v10");
 var import_zod7 = require("zod");
-var labelPredicate2 = import_zod7.z.object({
+var labelPredicate = import_zod7.z.object({
   id: idPredicate,
   type: import_zod7.z.literal(import_v1025.ComponentType.Label),
   label: import_zod7.z.string().min(1).max(45),
@@ -2797,7 +2804,7 @@ var LabelBuilder = class extends ComponentBuilder {
       // The label predicate validates the component.
       component: component?.toJSON(false)
     };
-    validate(labelPredicate2, data, validationOverride);
+    validate(labelPredicate, data, validationOverride);
     return data;
   }
 };
@@ -3123,8 +3130,8 @@ var numberOptionPredicate = import_zod8.z.object({
   ...numericMixinNumberOptionPredicate.shape
 }).and(autocompleteOrNumberChoicesMixinOptionPredicate);
 var stringOptionPredicate = basicOptionPredicate.extend({
-  max_length: import_zod8.z.number().min(0).max(6e3).optional(),
-  min_length: import_zod8.z.number().min(1).max(6e3).optional()
+  max_length: import_zod8.z.number().min(1).max(6e3).optional(),
+  min_length: import_zod8.z.number().min(0).max(6e3).optional()
 }).and(autocompleteOrStringChoicesMixinOptionPredicate);
 var baseChatInputCommandPredicate = sharedNameAndDescriptionPredicate.extend({
   contexts: import_zod8.z.array(import_zod8.z.enum(import_v1028.InteractionContextType)).optional(),
@@ -3134,8 +3141,12 @@ var baseChatInputCommandPredicate = sharedNameAndDescriptionPredicate.extend({
 });
 var chatInputCommandOptionsPredicate = import_zod8.z.union([
   import_zod8.z.object({ type: basicOptionTypesPredicate }).array(),
-  import_zod8.z.object({ type: import_zod8.z.literal(import_v1028.ApplicationCommandOptionType.Subcommand) }).array(),
-  import_zod8.z.object({ type: import_zod8.z.literal(import_v1028.ApplicationCommandOptionType.SubcommandGroup) }).array()
+  import_zod8.z.object({
+    type: import_zod8.z.union([
+      import_zod8.z.literal(import_v1028.ApplicationCommandOptionType.Subcommand),
+      import_zod8.z.literal(import_v1028.ApplicationCommandOptionType.SubcommandGroup)
+    ])
+  }).array()
 ]);
 var chatInputCommandPredicate = baseChatInputCommandPredicate.extend({
   options: chatInputCommandOptionsPredicate.optional()
@@ -3786,7 +3797,7 @@ var modalPredicate = import_zod10.z.object({
       type: import_zod10.z.literal(import_v1043.ComponentType.ActionRow),
       components: import_zod10.z.object({ type: import_zod10.z.literal(import_v1043.ComponentType.TextInput) }).array().length(1)
     }),
-    labelPredicate2,
+    labelPredicate,
     textDisplayPredicate
   ]).array().min(1).max(5)
 });
@@ -3910,15 +3921,8 @@ var ModalBuilder = class {
 };
 
 // src/messages/embed/Assertions.ts
+var import_util = require("@discordjs/util");
 var import_zod11 = require("zod");
-
-// src/util/componentUtil.ts
-function embedLength(data) {
-  return (data.title?.length ?? 0) + (data.description?.length ?? 0) + (data.fields?.reduce((prev, curr) => prev + curr.name.length + curr.value.length, 0) ?? 0) + (data.footer?.text.length ?? 0) + (data.author?.name.length ?? 0);
-}
-__name(embedLength, "embedLength");
-
-// src/messages/embed/Assertions.ts
 var namePredicate3 = import_zod11.z.string().max(256);
 var URLPredicate = import_zod11.z.url({ protocol: /^https?$/ });
 var URLWithAttachmentProtocolPredicate = import_zod11.z.url({ protocol: /^(?:https?|attachment)$/ });
@@ -3952,7 +3956,7 @@ var embedPredicate = import_zod11.z.object({
   {
     error: "Embed must have at least a title, description, a field, a footer, an author, an image, OR a thumbnail."
   }
-).refine((embed) => embedLength(embed) <= 6e3, { error: "Embeds must not exceed 6000 characters in total." });
+).refine((embed) => (0, import_util.embedLength)(embed) <= 6e3, { error: "Embeds must not exceed 6000 characters in total." });
 
 // src/messages/embed/EmbedAuthor.ts
 var EmbedAuthorBuilder = class {
@@ -4773,10 +4777,19 @@ 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({
-  id: import_zod13.z.union([import_zod13.z.string(), import_zod13.z.number()]),
+  // As a string it only makes sense for edits when we do have an attachment snowflake
+  id: import_zod13.z.union([snowflakePredicate, import_zod13.z.number()]),
   description: import_zod13.z.string().max(1024).optional(),
   duration_secs: import_zod13.z.number().max(2 ** 31 - 1).optional(),
   filename: import_zod13.z.string().max(1024).optional(),
@@ -4862,6 +4875,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,13 +5064,29 @@ 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.
    *
    * @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 = {}) {
     this.data = structuredClone(data);
+    this.fileData = {};
   }
   /**
    * Sets the id of the attachment.
@@ -5111,6 +5145,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 === void 0 ? void 0 : `files[${this.data.id}]`
+    };
+  }
   /**
    * Sets the title of this attachment.
    *
@@ -5415,7 +5497,7 @@ var MessageBuilder = class {
    *
    * @param allowedMentions - The allowed mentions to set
    */
-  setAllowedMentions(allowedMentions) {
+  setAllowedMentions(allowedMentions = new AllowedMentionsBuilder()) {
     this.data.allowed_mentions = resolveBuilder(allowedMentions, AllowedMentionsBuilder);
     return this;
   }
@@ -5748,10 +5830,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-pr-11005.1765454364-f3f6d34e7";
+var version = "2.0.0-pr-11005.1765463668-087384722";
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
   ActionRowBuilder,
@@ -5840,10 +5943,10 @@ var version = "2.0.0-pr-11005.1765454364-f3f6d34e7";
   embedAuthorPredicate,
   embedFieldPredicate,
   embedFooterPredicate,
-  embedLength,
   embedPredicate,
   emojiPredicate,
   enableValidators,
+  fileBodyMessagePredicate,
   filePredicate,
   fileUploadPredicate,
   idPredicate,
@@ -5864,6 +5967,7 @@ var version = "2.0.0-pr-11005.1765454364-f3f6d34e7";
   pollAnswerPredicate,
   pollPredicate,
   pollQuestionPredicate,
+  rawFilePredicate,
   resolveAccessoryComponent,
   resolveBuilder,
   sectionPredicate,
@@ -5874,6 +5978,7 @@ var version = "2.0.0-pr-11005.1765454364-f3f6d34e7";
   selectMenuStringPredicate,
   selectMenuUserPredicate,
   separatorPredicate,
+  snowflakePredicate,
   stringOptionPredicate,
   textDisplayPredicate,
   textInputPredicate,