@discordjs/builders 2.0.0-dev.1745453588-abc5d99ce → 2.0.0-dev.1745626390-8f375275c

package/dist/index.mjs

@@ -4190,18 +4190,23 @@ import { AllowedMentionsTypes, ComponentType as ComponentType23, MessageFlags, M
 import { z as z10 } from "zod";
 var attachmentPredicate = z10.object({
   id: z10.union([z10.string(), z10.number()]),
-  description: z10.string().optional(),
-  duration_secs: z10.number().optional(),
-  filename: z10.string().optional(),
-  title: z10.string().optional(),
-  waveform: z10.string().optional()
+  description: z10.string().max(1024).optional(),
+  duration_secs: z10.number().max(2 ** 31 - 1).optional(),
+  filename: z10.string().max(1024).optional(),
+  title: z10.string().max(1024).optional(),
+  waveform: z10.string().max(400).optional()
 });
 var allowedMentionPredicate = z10.object({
   parse: z10.nativeEnum(AllowedMentionsTypes).array().optional(),
-  roles: z10.string().array().optional(),
-  users: z10.string().array().optional(),
+  roles: z10.string().array().max(100).optional(),
+  users: z10.string().array().max(100).optional(),
   replied_user: z10.boolean().optional()
-});
+}).refine(
+  (data) => !(data.parse?.includes(AllowedMentionsTypes.User) && data.users?.length || data.parse?.includes(AllowedMentionsTypes.Role) && data.roles?.length),
+  {
+    message: 'Cannot specify both parse: ["users"] and non-empty users array, or parse: ["roles"] and non-empty roles array. These are mutually exclusive'
+  }
+);
 var messageReferencePredicate = z10.object({
   channel_id: z10.string().optional(),
   fail_if_not_exists: z10.boolean().optional(),
@@ -4231,9 +4236,9 @@ var basicActionRowPredicate = z10.object({
   }).array()
 });
 var messageNoComponentsV2Predicate = baseMessagePredicate.extend({
-  content: z10.string().optional(),
+  content: z10.string().max(2e3).optional(),
   embeds: embedPredicate.array().max(10).optional(),
-  sticker_ids: z10.array(z10.string()).min(0).max(3).optional(),
+  sticker_ids: z10.array(z10.string()).max(3).optional(),
   poll: pollPredicate.optional(),
   components: basicActionRowPredicate.array().max(5).optional(),
   flags: z10.number().optional().refine((flags) => {
@@ -4279,9 +4284,9 @@ var AllowedMentionsBuilder = class {
   }
   data;
   /**
-   * Creates new allowed mention builder from API data.
+   * Creates a new allowed mentions builder from API data.
    *
-   * @param data - The API data to create this attachment with
+   * @param data - The API data to create this allowed mentions builder with
    */
   constructor(data = {}) {
     this.data = structuredClone(data);
@@ -4295,6 +4300,13 @@ var AllowedMentionsBuilder = class {
     this.data.parse = normalizeArray(parse);
     return this;
   }
+  /**
+   * Clears the parse mention types.
+   */
+  clearParse() {
+    this.data.parse = void 0;
+    return this;
+  }
   /**
    * Sets the roles to mention.
    *
@@ -4328,7 +4340,7 @@ var AllowedMentionsBuilder = class {
    * allowedMentions.spliceRoles(0, 1);
    * ```
    * @example
-   * Remove the first n role:
+   * Remove the first n roles:
    * ```ts
    * const n = 4;
    * allowedMentions.spliceRoles(0, n);
@@ -4347,6 +4359,13 @@ var AllowedMentionsBuilder = class {
     this.data.roles.splice(index, deleteCount, ...normalizeArray(roles));
     return this;
   }
+  /**
+   * Clears the roles to mention.
+   */
+  clearRoles() {
+    this.data.roles = void 0;
+    return this;
+  }
   /**
    * Sets the users to mention.
    *
@@ -4380,7 +4399,7 @@ var AllowedMentionsBuilder = class {
    * allowedMentions.spliceUsers(0, 1);
    * ```
    * @example
-   * Remove the first n user:
+   * Remove the first n users:
    * ```ts
    * const n = 4;
    * allowedMentions.spliceUsers(0, n);
@@ -4400,7 +4419,16 @@ var AllowedMentionsBuilder = class {
     return this;
   }
   /**
-   * For replies, sets whether to mention the author of the message being replied to
+   * Clears the users to mention.
+   */
+  clearUsers() {
+    this.data.users = void 0;
+    return this;
+  }
+  /**
+   * For replies, sets whether to mention the author of the message being replied to.
+   *
+   * @param repliedUser - Whether to mention the author of the message being replied to
    */
   setRepliedUser(repliedUser = true) {
     this.data.replied_user = repliedUser;
@@ -4427,29 +4455,26 @@ var AttachmentBuilder = class {
   }
   data;
   /**
-   * Creates new attachment builder from API data.
+   * Creates a new attachment builder from API data.
    *
-   * @param data - The API data to create this attachment with
+   * @param data - The API data to create this attachment builder with
    */
   constructor(data = {}) {
     this.data = structuredClone(data);
   }
   /**
+   * Sets the id of the attachment.
+   *
    * @param id - The id of the attachment
    */
   setId(id) {
     this.data.id = id;
     return this;
   }
-  /**
-   * Clears the id of this attachment.
-   */
-  clearId() {
-    this.data.id = void 0;
-    return this;
-  }
   /**
    * Sets the description of this attachment.
+   *
+   * @param description - The description of the attachment
    */
   setDescription(description) {
     this.data.description = description;
@@ -4511,7 +4536,7 @@ var AttachmentBuilder = class {
     return this;
   }
   /**
-   * Sets the waveform of this attachment.
+   * Sets the waveform of this attachment (audio clips).
    *
    * @param waveform - The waveform of the attachment
    */
@@ -4547,15 +4572,15 @@ var MessageReferenceBuilder = class {
   }
   data;
   /**
-   * Creates new allowed mention builder from API data.
+   * Creates a new message reference builder from API data.
    *
-   * @param data - The API data to create this attachment with
+   * @param data - The API data to create this message reference builder with
    */
   constructor(data = {}) {
     this.data = structuredClone(data);
   }
   /**
-   * Sets the types of message reference this represents
+   * Sets the type of message reference this represents
    *
    * @param type - The type of message reference
    */
@@ -4611,6 +4636,15 @@ var MessageReferenceBuilder = class {
     this.data.guild_id = void 0;
     return this;
   }
+  /**
+   * Sets whether to fail the message creation if the referenced message does not exist
+   *
+   * @param failIfNotExists - Whether to fail the message creation if the referenced message does not exist
+   */
+  setFailIfNotExists(failIfNotExists = true) {
+    this.data.fail_if_not_exists = failIfNotExists;
+    return this;
+  }
   /**
    * Serializes this builder to API-compatible JSON data.
    *
@@ -4653,19 +4687,27 @@ var MessageBuilder = class {
     return this.data.embeds;
   }
   /**
-   * Creates new attachment builder from API data.
+   * Creates a new message builder from API data.
    *
-   * @param data - The API data to create this attachment with
+   * @param data - The API data to create this message builder with
    */
-  constructor(data = {}) {
+  constructor({
+    attachments = [],
+    embeds = [],
+    components = [],
+    message_reference,
+    poll,
+    allowed_mentions,
+    ...data
+  } = {}) {
     this.data = {
       ...structuredClone(data),
-      allowed_mentions: data.allowed_mentions ? new AllowedMentionsBuilder(data.allowed_mentions) : void 0,
-      attachments: data.attachments?.map((attachment) => new AttachmentBuilder(attachment)) ?? [],
-      embeds: data.embeds?.map((embed) => new EmbedBuilder(embed)) ?? [],
-      poll: data.poll ? new PollBuilder(data.poll) : void 0,
-      components: data.components?.map((component) => createComponentBuilder(component)) ?? [],
-      message_reference: data.message_reference ? new MessageReferenceBuilder(data.message_reference) : void 0
+      allowed_mentions: allowed_mentions && new AllowedMentionsBuilder(allowed_mentions),
+      attachments: attachments.map((attachment) => new AttachmentBuilder(attachment)),
+      embeds: embeds.map((embed) => new EmbedBuilder(embed)),
+      poll: poll && new PollBuilder(poll),
+      components: components.map((component) => createComponentBuilder(component)),
+      message_reference: message_reference && new MessageReferenceBuilder(message_reference)
     };
   }
   /**
@@ -4702,6 +4744,8 @@ var MessageBuilder = class {
   }
   /**
    * Sets whether the message is TTS.
+   *
+   * @param tts - Whether the message is TTS
    */
   setTTS(tts = true) {
     this.data.tts = tts;
@@ -4770,6 +4814,14 @@ var MessageBuilder = class {
     this.data.embeds.splice(start, deleteCount, ...resolved);
     return this;
   }
+  /**
+   * Sets the embeds for this message.
+   *
+   * @param embeds - The embeds to set
+   */
+  setEmbeds(...embeds) {
+    return this.spliceEmbeds(0, this.embeds.length, ...normalizeArray(embeds));
+  }
   /**
    * Sets the allowed mentions for this message.
    *
@@ -4785,7 +4837,7 @@ var MessageBuilder = class {
    * @param updater - The function to update the allowed mentions with
    */
   updateAllowedMentions(updater) {
-    this.data.allowed_mentions = updater(this.data.allowed_mentions ?? new AllowedMentionsBuilder());
+    updater(this.data.allowed_mentions ??= new AllowedMentionsBuilder());
     return this;
   }
   /**
@@ -4810,7 +4862,7 @@ var MessageBuilder = class {
    * @param updater - The function to update the message reference with
    */
   updateMessageReference(updater) {
-    this.data.message_reference = updater(this.data.message_reference ?? new MessageReferenceBuilder());
+    updater(this.data.message_reference ??= new MessageReferenceBuilder());
     return this;
   }
   /**
@@ -4939,8 +4991,7 @@ var MessageBuilder = class {
    * @param stickerIds - The ids of the stickers to set
    */
   setStickerIds(...stickerIds) {
-    this.data.sticker_ids = normalizeArray(stickerIds);
-    return this;
+    return this.spliceStickerIds(0, this.data.sticker_ids?.length ?? 0, ...normalizeArray(stickerIds));
   }
   /**
    * Adds sticker ids to this message.
@@ -4991,9 +5042,7 @@ var MessageBuilder = class {
    * @param attachments - The attachments to set
    */
   setAttachments(...attachments) {
-    const resolved = normalizeArray(attachments).map((attachment) => resolveBuilder(attachment, AttachmentBuilder));
-    this.data.attachments = resolved;
-    return this;
+    return this.spliceAttachments(0, this.data.attachments.length, ...normalizeArray(attachments));
   }
   /**
    * Adds attachments to this message.
@@ -5040,6 +5089,8 @@ var MessageBuilder = class {
   }
   /**
    * Sets the flags for this message.
+   *
+   * @param flags - The flags to set
    */
   setFlags(flags) {
     this.data.flags = flags;
@@ -5053,7 +5104,9 @@ var MessageBuilder = class {
     return this;
   }
   /**
-   * Sets `enforce_nonce` for this message.
+   * Sets whether to enforce recent uniqueness of the nonce of this message.
+   *
+   * @param enforceNonce - Whether to enforce recent uniqueness of the nonce of this message
    */
   setEnforceNonce(enforceNonce = true) {
     this.data.enforce_nonce = enforceNonce;
@@ -5074,7 +5127,7 @@ var MessageBuilder = class {
    * @param updater - The function to update the poll with
    */
   updatePoll(updater) {
-    this.data.poll = updater(this.data.poll ?? new PollBuilder());
+    updater(this.data.poll ??= new PollBuilder());
     return this;
   }
   /**
@@ -5096,12 +5149,12 @@ var MessageBuilder = class {
     const data = {
       ...structuredClone(rest),
       // Wherever we pass false, it's covered by the messagePredicate already
-      poll: this.data.poll?.toJSON(false),
+      poll: poll?.toJSON(false),
       allowed_mentions: allowed_mentions?.toJSON(false),
       attachments: attachments.map((attachment) => attachment.toJSON(false)),
-      embeds: this.data.embeds.map((embed) => embed.toJSON(false)),
+      embeds: embeds.map((embed) => embed.toJSON(false)),
       // Here, the messagePredicate does specific constraints rather than using the componentPredicate
-      components: this.data.components?.map((component) => component.toJSON(validationOverride)),
+      components: components.map((component) => component.toJSON(validationOverride)),
       message_reference: message_reference?.toJSON(false)
     };
     validate(messagePredicate, data, validationOverride);
@@ -5110,7 +5163,7 @@ var MessageBuilder = class {
 };
 
 // src/index.ts
-var version = "2.0.0-dev.1745453588-abc5d99ce";
+var version = "2.0.0-dev.1745626390-8f375275c";
 export {
   ActionRowBuilder,
   AllowedMentionsBuilder,
@@ -5138,6 +5191,7 @@ export {
   ChatInputCommandUserOption,
   CommandBuilder,
   ComponentBuilder,
+  ContainerBuilder,
   ContextMenuCommandBuilder,
   CustomIdButtonBuilder,
   DangerButtonBuilder,