@discordjs/builders 2.0.0-dev.1745540007-8e4e319c2 → 2.0.0-dev.1745626390-8f375275c

package/dist/index.js

@@ -4316,18 +4316,23 @@ var import_v1041 = require("discord-api-types/v10");
 var import_zod10 = require("zod");
 var attachmentPredicate = import_zod10.z.object({
   id: import_zod10.z.union([import_zod10.z.string(), import_zod10.z.number()]),
-  description: import_zod10.z.string().optional(),
-  duration_secs: import_zod10.z.number().optional(),
-  filename: import_zod10.z.string().optional(),
-  title: import_zod10.z.string().optional(),
-  waveform: import_zod10.z.string().optional()
+  description: import_zod10.z.string().max(1024).optional(),
+  duration_secs: import_zod10.z.number().max(2 ** 31 - 1).optional(),
+  filename: import_zod10.z.string().max(1024).optional(),
+  title: import_zod10.z.string().max(1024).optional(),
+  waveform: import_zod10.z.string().max(400).optional()
 });
 var allowedMentionPredicate = import_zod10.z.object({
   parse: import_zod10.z.nativeEnum(import_v1041.AllowedMentionsTypes).array().optional(),
-  roles: import_zod10.z.string().array().optional(),
-  users: import_zod10.z.string().array().optional(),
+  roles: import_zod10.z.string().array().max(100).optional(),
+  users: import_zod10.z.string().array().max(100).optional(),
   replied_user: import_zod10.z.boolean().optional()
-});
+}).refine(
+  (data) => !(data.parse?.includes(import_v1041.AllowedMentionsTypes.User) && data.users?.length || data.parse?.includes(import_v1041.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 = import_zod10.z.object({
   channel_id: import_zod10.z.string().optional(),
   fail_if_not_exists: import_zod10.z.boolean().optional(),
@@ -4357,9 +4362,9 @@ var basicActionRowPredicate = import_zod10.z.object({
   }).array()
 });
 var messageNoComponentsV2Predicate = baseMessagePredicate.extend({
-  content: import_zod10.z.string().optional(),
+  content: import_zod10.z.string().max(2e3).optional(),
   embeds: embedPredicate.array().max(10).optional(),
-  sticker_ids: import_zod10.z.array(import_zod10.z.string()).min(0).max(3).optional(),
+  sticker_ids: import_zod10.z.array(import_zod10.z.string()).max(3).optional(),
   poll: pollPredicate.optional(),
   components: basicActionRowPredicate.array().max(5).optional(),
   flags: import_zod10.z.number().optional().refine((flags) => {
@@ -4405,9 +4410,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);
@@ -4421,6 +4426,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.
    *
@@ -4454,7 +4466,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);
@@ -4473,6 +4485,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.
    *
@@ -4506,7 +4525,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);
@@ -4526,7 +4545,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;
@@ -4553,29 +4581,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;
@@ -4637,7 +4662,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
    */
@@ -4673,15 +4698,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
    */
@@ -4737,6 +4762,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.
    *
@@ -4779,19 +4813,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)
     };
   }
   /**
@@ -4828,6 +4870,8 @@ var MessageBuilder = class {
   }
   /**
    * Sets whether the message is TTS.
+   *
+   * @param tts - Whether the message is TTS
    */
   setTTS(tts = true) {
     this.data.tts = tts;
@@ -4896,6 +4940,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.
    *
@@ -4911,7 +4963,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;
   }
   /**
@@ -4936,7 +4988,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;
   }
   /**
@@ -5065,8 +5117,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.
@@ -5117,9 +5168,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.
@@ -5166,6 +5215,8 @@ var MessageBuilder = class {
   }
   /**
    * Sets the flags for this message.
+   *
+   * @param flags - The flags to set
    */
   setFlags(flags) {
     this.data.flags = flags;
@@ -5179,7 +5230,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;
@@ -5200,7 +5253,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;
   }
   /**
@@ -5222,12 +5275,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);
@@ -5236,7 +5289,7 @@ var MessageBuilder = class {
 };
 
 // src/index.ts
-var version = "2.0.0-dev.1745540007-8e4e319c2";
+var version = "2.0.0-dev.1745626390-8f375275c";
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
   ActionRowBuilder,