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

package/dist/index.js

@@ -47,6 +47,7 @@ __export(index_exports, {
   ChatInputCommandUserOption: () => ChatInputCommandUserOption,
   CommandBuilder: () => CommandBuilder,
   ComponentBuilder: () => ComponentBuilder,
+  ContainerBuilder: () => ContainerBuilder,
   ContextMenuCommandBuilder: () => ContextMenuCommandBuilder,
   CustomIdButtonBuilder: () => CustomIdButtonBuilder,
   DangerButtonBuilder: () => DangerButtonBuilder,
@@ -4315,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(),
@@ -4356,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) => {
@@ -4404,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);
@@ -4420,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.
    *
@@ -4453,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);
@@ -4472,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.
    *
@@ -4505,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);
@@ -4525,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;
@@ -4552,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;
@@ -4636,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
    */
@@ -4672,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
    */
@@ -4736,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.
    *
@@ -4778,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)
     };
   }
   /**
@@ -4827,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;
@@ -4895,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.
    *
@@ -4910,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;
   }
   /**
@@ -4935,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;
   }
   /**
@@ -5064,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.
@@ -5116,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.
@@ -5165,6 +5215,8 @@ var MessageBuilder = class {
   }
   /**
    * Sets the flags for this message.
+   *
+   * @param flags - The flags to set
    */
   setFlags(flags) {
     this.data.flags = flags;
@@ -5178,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;
@@ -5199,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;
   }
   /**
@@ -5221,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);
@@ -5235,7 +5289,7 @@ var MessageBuilder = class {
 };
 
 // src/index.ts
-var version = "2.0.0-dev.1745453588-abc5d99ce";
+var version = "2.0.0-dev.1745626390-8f375275c";
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
   ActionRowBuilder,
@@ -5264,6 +5318,7 @@ var version = "2.0.0-dev.1745453588-abc5d99ce";
   ChatInputCommandUserOption,
   CommandBuilder,
   ComponentBuilder,
+  ContainerBuilder,
   ContextMenuCommandBuilder,
   CustomIdButtonBuilder,
   DangerButtonBuilder,