@discordjs/builders 2.0.0-dev.1741219959-e273afbb9 → 2.0.0-dev.1741953893-09beb8a6a

package/dist/index.mjs

@@ -872,7 +872,7 @@ var StringSelectMenuBuilder = class extends BaseSelectMenuBuilder {
    *
    * @remarks
    * This method behaves similarly
-   * to {@link https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Array/slice | Array.prototype.splice()}.
+   * to {@link https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/Array/slice | Array.prototype.splice()}.
    * It's useful for modifying and adjusting the order of existing options.
    * @example
    * Remove the first option:
@@ -1387,7 +1387,7 @@ var ActionRowBuilder = class extends ComponentBuilder {
    *
    * @remarks
    * This method behaves similarly
-   * to {@link https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Array/splice | Array.prototype.splice()}.
+   * to {@link https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/Array/splice | Array.prototype.splice()}.
    *
    * It's useful for modifying and adjusting order of the already-existing components of an action row.
    * @example
@@ -2042,7 +2042,7 @@ var SharedChatInputCommandOptions = class {
    *
    * @remarks
    * This method behaves similarly
-   * to {@link https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Array/splice | Array.prototype.splice()}.
+   * to {@link https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/Array/splice | Array.prototype.splice()}.
    *
    * It's useful for modifying and adjusting order of the already-existing options for this command.
    * @example
@@ -2412,7 +2412,7 @@ var ModalBuilder = class {
    *
    * @remarks
    * This method behaves similarly
-   * to {@link https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Array/splice | Array.prototype.splice()}.
+   * to {@link https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/Array/splice | Array.prototype.splice()}.
    * The maximum amount of action rows that can be added is 5.
    *
    * It's useful for modifying and adjusting order of the already-existing action rows of a modal.
@@ -2470,10 +2470,10 @@ __name(embedLength, "embedLength");
 
 // src/messages/embed/Assertions.ts
 var namePredicate3 = z7.string().max(256);
-var iconURLPredicate = z7.string().url().refine(refineURLPredicate(["http:", "https:", "attachment:"]), {
-  message: "Invalid protocol for icon URL. Must be http:, https:, or attachment:"
-});
 var URLPredicate = z7.string().url().refine(refineURLPredicate(["http:", "https:"]), { message: "Invalid protocol for URL. Must be http: or https:" });
+var URLWithAttachmentProtocolPredicate = z7.string().url().refine(refineURLPredicate(["http:", "https:", "attachment:"]), {
+  message: "Invalid protocol for URL. Must be http:, https:, or attachment:"
+});
 var embedFieldPredicate = z7.object({
   name: namePredicate3,
   value: z7.string().max(1024),
@@ -2481,12 +2481,12 @@ var embedFieldPredicate = z7.object({
 });
 var embedAuthorPredicate = z7.object({
   name: namePredicate3.min(1),
-  icon_url: iconURLPredicate.optional(),
+  icon_url: URLWithAttachmentProtocolPredicate.optional(),
   url: URLPredicate.optional()
 });
 var embedFooterPredicate = z7.object({
   text: z7.string().min(1).max(2048),
-  icon_url: iconURLPredicate.optional()
+  icon_url: URLWithAttachmentProtocolPredicate.optional()
 });
 var embedPredicate = z7.object({
   title: namePredicate3.min(1).optional(),
@@ -2495,8 +2495,8 @@ var embedPredicate = z7.object({
   timestamp: z7.string().optional(),
   color: z7.number().int().min(0).max(16777215).optional(),
   footer: embedFooterPredicate.optional(),
-  image: z7.object({ url: URLPredicate }).optional(),
-  thumbnail: z7.object({ url: URLPredicate }).optional(),
+  image: z7.object({ url: URLWithAttachmentProtocolPredicate }).optional(),
+  thumbnail: z7.object({ url: URLWithAttachmentProtocolPredicate }).optional(),
   author: embedAuthorPredicate.optional(),
   fields: z7.array(embedFieldPredicate).max(25).optional()
 }).refine(
@@ -2753,7 +2753,7 @@ var EmbedBuilder = class {
    *
    * @remarks
    * This method behaves similarly
-   * to {@link https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Array/splice | Array.prototype.splice()}.
+   * to {@link https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/Array/splice | Array.prototype.splice()}.
    * The maximum amount of fields that can be added is 25.
    *
    * It's useful for modifying and adjusting order of the already-existing fields of an embed.
@@ -3189,7 +3189,7 @@ var PollBuilder = class {
    *
    * @remarks
    * This method behaves similarly
-   * to {@link https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Array/splice | Array.prototype.splice()}.
+   * to {@link https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/Array/splice | Array.prototype.splice()}.
    * The maximum amount of answers that can be added is 10.
    *
    * It's useful for modifying and adjusting order of the already-existing answers of a poll.
@@ -3317,16 +3317,854 @@ var PollBuilder = class {
   }
 };
 
+// src/messages/Assertions.ts
+import { AllowedMentionsTypes, ComponentType as ComponentType15, MessageReferenceType } from "discord-api-types/v10";
+import { z as z9 } from "zod";
+var attachmentPredicate = z9.object({
+  id: z9.union([z9.string(), z9.number()]),
+  description: z9.string().optional(),
+  duration_secs: z9.number().optional(),
+  filename: z9.string().optional(),
+  title: z9.string().optional(),
+  waveform: z9.string().optional()
+});
+var allowedMentionPredicate = z9.object({
+  parse: z9.nativeEnum(AllowedMentionsTypes).array().optional(),
+  roles: z9.string().array().optional(),
+  users: z9.string().array().optional(),
+  replied_user: z9.boolean().optional()
+});
+var messageReferencePredicate = z9.object({
+  channel_id: z9.string().optional(),
+  fail_if_not_exists: z9.boolean().optional(),
+  guild_id: z9.string().optional(),
+  message_id: z9.string(),
+  type: z9.nativeEnum(MessageReferenceType).optional()
+});
+var messagePredicate = z9.object({
+  content: z9.string().optional(),
+  nonce: z9.union([z9.string().max(25), z9.number()]).optional(),
+  tts: z9.boolean().optional(),
+  embeds: embedPredicate.array().max(10).optional(),
+  allowed_mentions: allowedMentionPredicate.optional(),
+  message_reference: messageReferencePredicate.optional(),
+  // Partial validation here to ensure the components are valid,
+  // rest of the validation is done in the action row predicate
+  components: z9.object({
+    type: z9.literal(ComponentType15.ActionRow),
+    components: z9.object({
+      type: z9.union([
+        z9.literal(ComponentType15.Button),
+        z9.literal(ComponentType15.ChannelSelect),
+        z9.literal(ComponentType15.MentionableSelect),
+        z9.literal(ComponentType15.RoleSelect),
+        z9.literal(ComponentType15.StringSelect),
+        z9.literal(ComponentType15.UserSelect)
+      ])
+    }).array()
+  }).array().max(5).optional(),
+  sticker_ids: z9.array(z9.string()).min(0).max(3).optional(),
+  attachments: attachmentPredicate.array().max(10).optional(),
+  flags: z9.number().optional(),
+  enforce_nonce: z9.boolean().optional(),
+  poll: pollPredicate.optional()
+}).refine(
+  (data) => {
+    return data.content !== void 0 || data.embeds !== void 0 && data.embeds.length > 0 || data.poll !== void 0 || data.attachments !== void 0 && data.attachments.length > 0 || data.components !== void 0 && data.components.length > 0 || data.sticker_ids !== void 0 && data.sticker_ids.length > 0;
+  },
+  { message: "Messages must have content, embeds, a poll, attachments, components, or stickers" }
+);
+
+// src/messages/AllowedMentions.ts
+var AllowedMentionsBuilder = class {
+  static {
+    __name(this, "AllowedMentionsBuilder");
+  }
+  data;
+  /**
+   * Creates new allowed mention builder from API data.
+   *
+   * @param data - The API data to create this attachment with
+   */
+  constructor(data = {}) {
+    this.data = structuredClone(data);
+  }
+  /**
+   * Sets the types of mentions to parse from the content.
+   *
+   * @param parse - The types of mentions to parse from the content
+   */
+  setParse(...parse) {
+    this.data.parse = normalizeArray(parse);
+    return this;
+  }
+  /**
+   * Sets the roles to mention.
+   *
+   * @param roles - The roles to mention
+   */
+  setRoles(...roles) {
+    this.data.roles = normalizeArray(roles);
+    return this;
+  }
+  /**
+   * Adds roles to mention.
+   *
+   * @param roles - The roles to mention
+   */
+  addRoles(...roles) {
+    this.data.roles ??= [];
+    this.data.roles.push(...normalizeArray(roles));
+    return this;
+  }
+  /**
+   * Removes, replaces, or inserts roles.
+   *
+   * @remarks
+   * This method behaves similarly
+   * to {@link https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/Array/splice | Array.prototype.splice()}.
+   *
+   * It's useful for modifying and adjusting order of the already-existing roles.
+   * @example
+   * Remove the first role:
+   * ```ts
+   * allowedMentions.spliceRoles(0, 1);
+   * ```
+   * @example
+   * Remove the first n role:
+   * ```ts
+   * const n = 4;
+   * allowedMentions.spliceRoles(0, n);
+   * ```
+   * @example
+   * Remove the last role:
+   * ```ts
+   * allowedMentions.spliceRoles(-1, 1);
+   * ```
+   * @param index - The index to start at
+   * @param deleteCount - The number of roles to remove
+   * @param roles - The replacing role ids
+   */
+  spliceRoles(index, deleteCount, ...roles) {
+    this.data.roles ??= [];
+    this.data.roles.splice(index, deleteCount, ...normalizeArray(roles));
+    return this;
+  }
+  /**
+   * Sets the users to mention.
+   *
+   * @param users - The users to mention
+   */
+  setUsers(...users) {
+    this.data.users = normalizeArray(users);
+    return this;
+  }
+  /**
+   * Adds users to mention.
+   *
+   * @param users - The users to mention
+   */
+  addUsers(...users) {
+    this.data.users ??= [];
+    this.data.users.push(...normalizeArray(users));
+    return this;
+  }
+  /**
+   * Removes, replaces, or inserts users.
+   *
+   * @remarks
+   * This method behaves similarly
+   * to {@link https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/Array/splice | Array.prototype.splice()}.
+   *
+   * It's useful for modifying and adjusting order of the already-existing users.
+   * @example
+   * Remove the first user:
+   * ```ts
+   * allowedMentions.spliceUsers(0, 1);
+   * ```
+   * @example
+   * Remove the first n user:
+   * ```ts
+   * const n = 4;
+   * allowedMentions.spliceUsers(0, n);
+   * ```
+   * @example
+   * Remove the last user:
+   * ```ts
+   * allowedMentions.spliceUsers(-1, 1);
+   * ```
+   * @param index - The index to start at
+   * @param deleteCount - The number of users to remove
+   * @param users - The replacing user ids
+   */
+  spliceUsers(index, deleteCount, ...users) {
+    this.data.users ??= [];
+    this.data.users.splice(index, deleteCount, ...normalizeArray(users));
+    return this;
+  }
+  /**
+   * For replies, sets whether to mention the author of the message being replied to
+   */
+  setRepliedUser(repliedUser = true) {
+    this.data.replied_user = repliedUser;
+    return this;
+  }
+  /**
+   * Serializes this builder to API-compatible JSON data.
+   *
+   * Note that by disabling validation, there is no guarantee that the resulting object will be valid.
+   *
+   * @param validationOverride - Force validation to run/not run regardless of your global preference
+   */
+  toJSON(validationOverride) {
+    const clone = structuredClone(this.data);
+    validate(allowedMentionPredicate, clone, validationOverride);
+    return clone;
+  }
+};
+
+// src/messages/Attachment.ts
+var AttachmentBuilder = class {
+  static {
+    __name(this, "AttachmentBuilder");
+  }
+  data;
+  /**
+   * Creates new attachment builder from API data.
+   *
+   * @param data - The API data to create this attachment with
+   */
+  constructor(data = {}) {
+    this.data = structuredClone(data);
+  }
+  /**
+   * @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.
+   */
+  setDescription(description) {
+    this.data.description = description;
+    return this;
+  }
+  /**
+   * Clears the description of this attachment.
+   */
+  clearDescription() {
+    this.data.description = void 0;
+    return this;
+  }
+  /**
+   * Sets the duration of this attachment (audio clips).
+   *
+   * @param duration - The duration of the attachment in seconds
+   */
+  setDuration(duration) {
+    this.data.duration_secs = duration;
+    return this;
+  }
+  /**
+   * Clears the duration of this attachment.
+   */
+  clearDuration() {
+    this.data.duration_secs = void 0;
+    return this;
+  }
+  /**
+   * Sets the filename of this attachment.
+   *
+   * @param filename - The filename of the attachment
+   */
+  setFilename(filename) {
+    this.data.filename = filename;
+    return this;
+  }
+  /**
+   * Clears the filename of this attachment.
+   */
+  clearFilename() {
+    this.data.filename = void 0;
+    return this;
+  }
+  /**
+   * Sets the title of this attachment.
+   *
+   * @param title - The title of the attachment
+   */
+  setTitle(title) {
+    this.data.title = title;
+    return this;
+  }
+  /**
+   * Clears the title of this attachment.
+   */
+  clearTitle() {
+    this.data.title = void 0;
+    return this;
+  }
+  /**
+   * Sets the waveform of this attachment.
+   *
+   * @param waveform - The waveform of the attachment
+   */
+  setWaveform(waveform) {
+    this.data.waveform = waveform;
+    return this;
+  }
+  /**
+   * Clears the waveform of this attachment.
+   */
+  clearWaveform() {
+    this.data.waveform = void 0;
+    return this;
+  }
+  /**
+   * Serializes this builder to API-compatible JSON data.
+   *
+   * Note that by disabling validation, there is no guarantee that the resulting object will be valid.
+   *
+   * @param validationOverride - Force validation to run/not run regardless of your global preference
+   */
+  toJSON(validationOverride) {
+    const clone = structuredClone(this.data);
+    validate(attachmentPredicate, clone, validationOverride);
+    return clone;
+  }
+};
+
+// src/messages/MessageReference.ts
+var MessageReferenceBuilder = class {
+  static {
+    __name(this, "MessageReferenceBuilder");
+  }
+  data;
+  /**
+   * Creates new allowed mention builder from API data.
+   *
+   * @param data - The API data to create this attachment with
+   */
+  constructor(data = {}) {
+    this.data = structuredClone(data);
+  }
+  /**
+   * Sets the types of message reference this represents
+   *
+   * @param type - The type of message reference
+   */
+  setType(type) {
+    this.data.type = type;
+    return this;
+  }
+  /**
+   * Clear the type of message reference this represents
+   */
+  clearType() {
+    this.data.type = void 0;
+    return this;
+  }
+  /**
+   * Sets the id of the message being referenced
+   *
+   * @param messageId - The id of the message being referenced
+   */
+  setMessageId(messageId) {
+    this.data.message_id = messageId;
+    return this;
+  }
+  /**
+   * Sets the id of the channel being referenced
+   *
+   * @param channelId - The id of the channel being referenced
+   */
+  setChannelId(channelId) {
+    this.data.channel_id = channelId;
+    return this;
+  }
+  /**
+   * Clear the id of the channel being referenced
+   */
+  clearChannelId() {
+    this.data.channel_id = void 0;
+    return this;
+  }
+  /**
+   * Sets the id of the guild being referenced
+   *
+   * @param guildId - The id of the guild being referenced
+   */
+  setGuildId(guildId) {
+    this.data.guild_id = guildId;
+    return this;
+  }
+  /**
+   * Clear the id of the guild being referenced
+   */
+  clearGuildId() {
+    this.data.guild_id = void 0;
+    return this;
+  }
+  /**
+   * Serializes this builder to API-compatible JSON data.
+   *
+   * Note that by disabling validation, there is no guarantee that the resulting object will be valid.
+   *
+   * @param validationOverride - Force validation to run/not run regardless of your global preference
+   */
+  toJSON(validationOverride) {
+    const clone = structuredClone(this.data);
+    validate(messageReferencePredicate, clone, validationOverride);
+    return clone;
+  }
+};
+
+// src/messages/Message.ts
+var MessageBuilder = class {
+  static {
+    __name(this, "MessageBuilder");
+  }
+  /**
+   * The API data associated with this message.
+   */
+  data;
+  /**
+   * Gets the attachments of this message.
+   */
+  get attachments() {
+    return this.data.attachments;
+  }
+  /**
+   * Gets the components of this message.
+   */
+  get components() {
+    return this.data.components;
+  }
+  /**
+   * Gets the embeds of this message.
+   */
+  get embeds() {
+    return this.data.embeds;
+  }
+  /**
+   * Creates new attachment builder from API data.
+   *
+   * @param data - The API data to create this attachment with
+   */
+  constructor(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) => new ActionRowBuilder(component)) ?? [],
+      message_reference: data.message_reference ? new MessageReferenceBuilder(data.message_reference) : void 0
+    };
+  }
+  /**
+   * Sets the content of the message.
+   *
+   * @param content - The content to set
+   */
+  setContent(content) {
+    this.data.content = content;
+    return this;
+  }
+  /**
+   * Clears the content of the message.
+   */
+  clearContent() {
+    this.data.content = void 0;
+    return this;
+  }
+  /**
+   * Sets the nonce of the message.
+   *
+   * @param nonce - The nonce to set
+   */
+  setNonce(nonce) {
+    this.data.nonce = nonce;
+    return this;
+  }
+  /**
+   * Clears the nonce of the message.
+   */
+  clearNonce() {
+    this.data.nonce = void 0;
+    return this;
+  }
+  /**
+   * Sets whether the message is TTS.
+   */
+  setTTS(tts = true) {
+    this.data.tts = tts;
+    return this;
+  }
+  /**
+   * Appends embeds to this message.
+   *
+   * @remarks
+   * The maximum amount of embeds that can be added is 10.
+   * @example
+   * Using an array:
+   * ```ts
+   * const embeds: APIEmbed[] = ...;
+   * const message = new MessageBuilder()
+   * 	.addEmbeds(embeds);
+   * ```
+   * @example
+   * Using rest parameters (variadic):
+   * ```ts
+   * const message = new MessageBuilder()
+   * 	.addEmbeds(
+   * 		{ title: 'Embed 1' },
+   * 		{ title: 'Embed 2' },
+   * 	);
+   * ```
+   * @param embeds - The embeds to add
+   */
+  addEmbeds(...embeds) {
+    this.data.embeds ??= [];
+    const resolved = normalizeArray(embeds).map((embed) => resolveBuilder(embed, EmbedBuilder));
+    this.data.embeds.push(...resolved);
+    return this;
+  }
+  /**
+   * Removes, replaces, or inserts embeds for this message.
+   *
+   * @remarks
+   * This method behaves similarly
+   * to {@link https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/Array/splice | Array.prototype.splice()}.
+   *
+   * It's useful for modifying and adjusting order of the already-existing embeds of a message.
+   * @example
+   * Remove the first embed:
+   * ```ts
+   * message.spliceEmbeds(0, 1);
+   * ```
+   * @example
+   * Remove the first n embeds:
+   * ```ts
+   * const n = 4;
+   * message.spliceEmbeds(0, n);
+   * ```
+   * @example
+   * Remove the last embed:
+   * ```ts
+   * message.spliceEmbeds(-1, 1);
+   * ```
+   * @param start - The index to start at
+   * @param deleteCount - The amount of embeds to remove
+   * @param embeds - The embeds to insert
+   */
+  spliceEmbeds(start, deleteCount, ...embeds) {
+    this.data.embeds ??= [];
+    const resolved = normalizeArray(embeds).map((embed) => resolveBuilder(embed, EmbedBuilder));
+    this.data.embeds.splice(start, deleteCount, ...resolved);
+    return this;
+  }
+  /**
+   * Sets the allowed mentions for this message.
+   *
+   * @param allowedMentions - The allowed mentions to set
+   */
+  setAllowedMentions(allowedMentions) {
+    this.data.allowed_mentions = resolveBuilder(allowedMentions, AllowedMentionsBuilder);
+    return this;
+  }
+  /**
+   * Updates the allowed mentions for this message (and creates it if it doesn't exist)
+   *
+   * @param updater - The function to update the allowed mentions with
+   */
+  updateAllowedMentions(updater) {
+    this.data.allowed_mentions = updater(this.data.allowed_mentions ?? new AllowedMentionsBuilder());
+    return this;
+  }
+  /**
+   * Clears the allowed mentions for this message.
+   */
+  clearAllowedMentions() {
+    this.data.allowed_mentions = void 0;
+    return this;
+  }
+  /**
+   * Sets the message reference for this message.
+   *
+   * @param reference - The reference to set
+   */
+  setMessageReference(reference) {
+    this.data.message_reference = resolveBuilder(reference, MessageReferenceBuilder);
+    return this;
+  }
+  /**
+   * Updates the message reference for this message (and creates it if it doesn't exist)
+   *
+   * @param updater - The function to update the message reference with
+   */
+  updateMessageReference(updater) {
+    this.data.message_reference = updater(this.data.message_reference ?? new MessageReferenceBuilder());
+    return this;
+  }
+  /**
+   * Clears the message reference for this message.
+   */
+  clearMessageReference() {
+    this.data.message_reference = void 0;
+    return this;
+  }
+  /**
+   * Adds components to this message.
+   *
+   * @param components - The components to add
+   */
+  addComponents(...components) {
+    this.data.components ??= [];
+    const resolved = normalizeArray(components).map((component) => resolveBuilder(component, ActionRowBuilder));
+    this.data.components.push(...resolved);
+    return this;
+  }
+  /**
+   * Removes, replaces, or inserts components for this message.
+   *
+   * @remarks
+   * This method behaves similarly
+   * to {@link https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/Array/splice | Array.prototype.splice()}.
+   *
+   * It's useful for modifying and adjusting order of the already-existing components of a message.
+   * @example
+   * Remove the first component:
+   * ```ts
+   * message.spliceComponents(0, 1);
+   * ```
+   * @example
+   * Remove the first n components:
+   * ```ts
+   * const n = 4;
+   * message.spliceComponents(0, n);
+   * ```
+   * @example
+   * Remove the last component:
+   * ```ts
+   * message.spliceComponents(-1, 1);
+   * ```
+   * @param start - The index to start at
+   * @param deleteCount - The amount of components to remove
+   * @param components - The components to insert
+   */
+  spliceComponents(start, deleteCount, ...components) {
+    this.data.components ??= [];
+    const resolved = normalizeArray(components).map((component) => resolveBuilder(component, ActionRowBuilder));
+    this.data.components.splice(start, deleteCount, ...resolved);
+    return this;
+  }
+  /**
+   * Sets the components of this message.
+   *
+   * @param components - The components to set
+   */
+  setComponents(...components) {
+    this.data.components = normalizeArray(components).map((component) => resolveBuilder(component, ActionRowBuilder));
+    return this;
+  }
+  /**
+   * Sets the sticker ids of this message.
+   *
+   * @param stickerIds - The ids of the stickers to set
+   */
+  setStickerIds(...stickerIds) {
+    this.data.sticker_ids = normalizeArray(stickerIds);
+    return this;
+  }
+  /**
+   * Adds sticker ids to this message.
+   *
+   * @param stickerIds - The ids of the stickers to add
+   */
+  addStickerIds(...stickerIds) {
+    this.data.sticker_ids ??= [];
+    this.data.sticker_ids.push(...normalizeArray(stickerIds));
+    return this;
+  }
+  /**
+   * Removes, replaces, or inserts sticker ids for this message.
+   *
+   * @remarks
+   * This method behaves similarly
+   * to {@link https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/Array/splice | Array.prototype.splice()}.
+   *
+   * It's useful for modifying and adjusting order of the already-existing sticker ids of a message.
+   * @example
+   * Remove the first sticker id:
+   * ```ts
+   * message.spliceStickerIds(0, 1);
+   * ```
+   * @example
+   * Remove the first n sticker ids:
+   * ```ts
+   * const n = 4;
+   * message.spliceStickerIds(0, n);
+   * ```
+   * @example
+   * Remove the last sticker id:
+   * ```ts
+   * message.spliceStickerIds(-1, 1);
+   * ```
+   * @param index - The index to start at
+   * @param deleteCount - The amount of sticker ids to remove
+   * @param stickerIds - The sticker ids to insert
+   */
+  spliceStickerIds(index, deleteCount, ...stickerIds) {
+    this.data.sticker_ids ??= [];
+    this.data.sticker_ids.splice(index, deleteCount, ...normalizeArray(stickerIds));
+    return this;
+  }
+  /**
+   * Sets attachments for this message.
+   *
+   * @param attachments - The attachments to set
+   */
+  setAttachments(...attachments) {
+    const resolved = normalizeArray(attachments).map((attachment) => resolveBuilder(attachment, AttachmentBuilder));
+    this.data.attachments = resolved;
+    return this;
+  }
+  /**
+   * Adds attachments to this message.
+   *
+   * @param attachments - The attachments to add
+   */
+  addAttachments(...attachments) {
+    const resolved = normalizeArray(attachments).map((attachment) => resolveBuilder(attachment, AttachmentBuilder));
+    this.data.attachments.push(...resolved);
+    return this;
+  }
+  /**
+   * Removes, replaces, or inserts attachments for this message.
+   *
+   * @remarks
+   * This method behaves similarly
+   * to {@link https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/Array/splice | Array.prototype.splice()}.
+   *
+   * It's useful for modifying and adjusting order of the already-existing attachments of a message.
+   * @example
+   * Remove the first attachment:
+   * ```ts
+   * message.spliceAttachments(0, 1);
+   * ```
+   * @example
+   * Remove the first n attachments:
+   * ```ts
+   * const n = 4;
+   * message.spliceAttachments(0, n);
+   * ```
+   * @example
+   * Remove the last attachment:
+   * ```ts
+   * message.spliceAttachments(-1, 1);
+   * ```
+   * @param start - The index to start at
+   * @param deleteCount - The amount of attachments to remove
+   * @param attachments - The attachments to insert
+   */
+  spliceAttachments(start, deleteCount, ...attachments) {
+    const resolved = normalizeArray(attachments).map((attachment) => resolveBuilder(attachment, AttachmentBuilder));
+    this.data.attachments.splice(start, deleteCount, ...resolved);
+    return this;
+  }
+  /**
+   * Sets the flags for this message.
+   */
+  setFlags(flags) {
+    this.data.flags = flags;
+    return this;
+  }
+  /**
+   * Clears the flags for this message.
+   */
+  clearFlags() {
+    this.data.flags = void 0;
+    return this;
+  }
+  /**
+   * Sets `enforce_nonce` for this message.
+   */
+  setEnforceNonce(enforceNonce = true) {
+    this.data.enforce_nonce = enforceNonce;
+    return this;
+  }
+  /**
+   * Sets the poll for this message.
+   *
+   * @param poll - The poll to set
+   */
+  setPoll(poll) {
+    this.data.poll = resolveBuilder(poll, PollBuilder);
+    return this;
+  }
+  /**
+   * Updates the poll for this message (and creates it if it doesn't exist)
+   *
+   * @param updater - The function to update the poll with
+   */
+  updatePoll(updater) {
+    this.data.poll = updater(this.data.poll ?? new PollBuilder());
+    return this;
+  }
+  /**
+   * Clears the poll for this message.
+   */
+  clearPoll() {
+    this.data.poll = void 0;
+    return this;
+  }
+  /**
+   * Serializes this builder to API-compatible JSON data.
+   *
+   * Note that by disabling validation, there is no guarantee that the resulting object will be valid.
+   *
+   * @param validationOverride - Force validation to run/not run regardless of your global preference
+   */
+  toJSON(validationOverride) {
+    const { poll, allowed_mentions, attachments, embeds, components, message_reference, ...rest } = this.data;
+    const data = {
+      ...structuredClone(rest),
+      // Wherever we pass false, it's covered by the messagePredicate already
+      poll: this.data.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)),
+      // Here, the messagePredicate does specific constraints rather than using the componentPredicate
+      components: this.data.components?.map((component) => component.toJSON(validationOverride)),
+      message_reference: message_reference?.toJSON(false)
+    };
+    validate(messagePredicate, data, validationOverride);
+    return data;
+  }
+};
+
 // src/index.ts
-var version = "2.0.0-dev.1741219959-e273afbb9";
+var version = "2.0.0-dev.1741953893-09beb8a6a";
 export {
   ActionRowBuilder,
+  AllowedMentionsBuilder,
   ApplicationCommandNumericOptionMinMaxValueMixin,
   ApplicationCommandOptionAllowedChannelTypes,
   ApplicationCommandOptionBase,
   ApplicationCommandOptionChannelTypesMixin,
   ApplicationCommandOptionWithAutocompleteMixin,
   ApplicationCommandOptionWithChoicesMixin,
+  AttachmentBuilder,
   BaseButtonBuilder,
   BaseSelectMenuBuilder,
   ChannelSelectMenuBuilder,
@@ -3354,7 +4192,9 @@ export {
   EmojiOrLabelButtonMixin,
   LinkButtonBuilder,
   MentionableSelectMenuBuilder,
+  MessageBuilder,
   MessageContextCommandBuilder,
+  MessageReferenceBuilder,
   ModalBuilder,
   PollAnswerBuilder,
   PollAnswerMediaBuilder,
@@ -3376,6 +4216,8 @@ export {
   UserContextCommandBuilder,
   UserSelectMenuBuilder,
   actionRowPredicate,
+  allowedMentionPredicate,
+  attachmentPredicate,
   basicOptionPredicate,
   buttonPredicate,
   channelOptionPredicate,
@@ -3397,6 +4239,8 @@ export {
   localeMapPredicate,
   memberPermissionsPredicate,
   messageCommandPredicate,
+  messagePredicate,
+  messageReferencePredicate,
   modalPredicate,
   normalizeArray,
   numberOptionPredicate,