lunibee 0.2.0 → 0.2.1

package/dist/index.js

@@ -396,6 +396,11 @@ class PermissionSet {
   toArray() {
     return Object.keys(Permission).filter((permission) => this.has(permission));
   }
+  static #renamed = {
+    ManageEmojisAndStickers: "ManageGuildExpressions",
+    ManageEmojis: "ManageGuildExpressions",
+    UseSlashCommands: "UseApplicationCommands"
+  };
   #resolve(permission) {
     if (typeof permission === "bigint")
       return permission;
@@ -410,6 +415,9 @@ class PermissionSet {
       return bit;
     }
     if (typeof permission === "string") {
+      const renamed = PermissionSet.#renamed[permission];
+      if (renamed)
+        return this.#resolve(renamed);
       if (permission in Permission)
         return Permission[permission];
       if (permission in Permissions)
@@ -1627,7 +1635,7 @@ class ResourceManager extends Manager {
 // packages/rest/package.json
 var package_default = {
   name: "@lunibee/rest",
-  version: "0.2.0",
+  version: "0.2.1",
   type: "module",
   module: "./src/index.ts",
   types: "./src/index.ts",
@@ -2612,6 +2620,11 @@ class Channel extends BaseStructure {
   editTopic(topic) {
     return this.edit({ topic });
   }
+  editPermissionOverwrite(targetId, changes, options) {
+    if (!this.#context?.editPermissionOverwrite)
+      throw new Error("This channel is not attached to a client.");
+    return this.#context.editPermissionOverwrite(this.id, targetId, changes, options);
+  }
   editParent(parentId) {
     return this.edit({ parent_id: parentId });
   }
@@ -2746,6 +2759,7 @@ class Guild extends BaseStructure {
     return this.name;
   }
 }
+
 // packages/structures/src/resources.ts
 function toDateOrNull(value) {
   if (!value)
@@ -2761,13 +2775,15 @@ class GuildMember {
   roleIds;
   pending;
   joinedAt;
-  permissions;
   avatarHash;
   premiumSince;
   timedOutUntil;
   flags;
-  constructor(data) {
+  #suppliedPermissions;
+  #context;
+  constructor(data, context) {
     this.user = new User(data.user);
+    this.#context = context;
     if (!/^\d{1,20}$/.test(data.guild_id))
       throw new TypeError("Member guild_id must be a valid snowflake.");
     this.guildId = data.guild_id;
@@ -2777,12 +2793,53 @@ class GuildMember {
     this.joinedAt = data.joined_at ? new Date(data.joined_at) : undefined;
     if (this.joinedAt?.toString() === "Invalid Date")
       throw new RangeError("Member joined_at must be a valid date.");
-    this.permissions = new PermissionsBitField(data.permissions ?? 0n);
+    if (data.permissions !== undefined)
+      this.#suppliedPermissions = new PermissionsBitField(data.permissions);
     this.avatarHash = data.avatar ?? null;
     this.premiumSince = toDateOrNull(data.premium_since);
     this.timedOutUntil = toDateOrNull(data.communication_disabled_until);
     this.flags = data.flags ?? 0;
   }
+  get permissions() {
+    if (this.#suppliedPermissions)
+      return this.#suppliedPermissions;
+    return new PermissionsBitField(this.#context?.memberPermissions?.(this.guildId, this.user.id, this.roleIds) ?? 0n);
+  }
+  permissionsIn(channelId) {
+    const computed = this.#context?.memberPermissions?.(this.guildId, this.user.id, this.roleIds, channelId);
+    return computed ? new PermissionsBitField(computed) : null;
+  }
+  #action(name) {
+    const action = this.#context?.[name];
+    if (!action)
+      throw new Error("This member is not attached to a client.");
+    return action;
+  }
+  kick(reason) {
+    return this.#action("kickMember")(this.guildId, this.user.id, reason);
+  }
+  ban(options = {}) {
+    return this.#action("banMember")(this.guildId, this.user.id, options);
+  }
+  edit(options, reason) {
+    return this.#action("editMember")(this.guildId, this.user.id, options, reason);
+  }
+  timeout(milliseconds, reason) {
+    if (milliseconds !== null && !(milliseconds > 0))
+      throw new RangeError("Timeout length must be a positive number of milliseconds.");
+    return this.edit({
+      communication_disabled_until: milliseconds === null ? null : new Date(Date.now() + milliseconds).toISOString()
+    }, reason);
+  }
+  setNickname(nickname, reason) {
+    return this.edit({ nick: nickname }, reason);
+  }
+  addRole(roleId, reason) {
+    return this.#action("addMemberRole")(this.guildId, this.user.id, roleId, reason);
+  }
+  removeRole(roleId, reason) {
+    return this.#action("removeMemberRole")(this.guildId, this.user.id, roleId, reason);
+  }
   get displayName() {
     return this.nickname ?? this.user.displayName;
   }
@@ -3316,6 +3373,17 @@ class CommandOptions {
       throw new TypeError(`Resolved mentionable for option "${name}" is missing.`);
     return resolved;
   }
+  getMentionableType(name) {
+    const opt = this.#get(name);
+    if (!opt || opt.type !== OptionType.Mentionable)
+      return null;
+    const id = String(opt.value);
+    if (this.#resolved?.users?.[id])
+      return "user";
+    if (this.#resolved?.roles?.[id])
+      return "role";
+    return null;
+  }
   getAttachment(name, required = false) {
     const opt = this.#get(name);
     if (!opt || opt.type !== OptionType.Attachment) {
@@ -3403,6 +3471,20 @@ class Interaction {
   isChatInputCommand() {
     return this.type === InteractionType.ApplicationCommand;
   }
+  awaitModalSubmit(options) {
+    const collect = this.#client.resourceContext?.collectInteractions;
+    if (!collect)
+      return Promise.reject(new Error("This interaction is not attached to a client."));
+    if (!(options.time > 0))
+      return Promise.reject(new RangeError("awaitModalSubmit needs a positive time."));
+    const userId = this.user?.id;
+    const collector = collect({
+      time: options.time,
+      max: 1,
+      filter: async (interaction) => interaction.isModalSubmit() && interaction.user?.id === userId && (options.customId === undefined || interaction.customId === options.customId) && (options.filter ? await options.filter(interaction) : true)
+    });
+    return collector.next();
+  }
   isMessageComponent() {
     return this.type === InteractionType.MessageComponent;
   }
@@ -3462,7 +3544,7 @@ class Interaction {
     return new GuildMember({
       ...raw,
       guild_id: this.guildId
-    });
+    }, this.#client.resourceContext);
   }
   get createdTimestamp() {
     return Number((BigInt(this.id) >> 22n) + DISCORD_EPOCH);
@@ -3498,7 +3580,8 @@ class Interaction {
   async reply(options) {
     return this.acknowledge(InteractionResponse.message(toMessageData(options)), "replied");
   }
-  async deferReply(ephemeral = false) {
+  async deferReply(options = false) {
+    const ephemeral = typeof options === "boolean" ? options : options.ephemeral === true;
     await this.acknowledge(InteractionResponse.defer(ephemeral), "deferred");
   }
   editReply(options) {
@@ -3516,7 +3599,8 @@ class Interaction {
     return this.acknowledge(new InteractionResponse(InteractionResponseType.MessageUpdate, toMessageData(options)), "replied");
   }
   async showModal(modal) {
-    return this.acknowledge(new InteractionResponse(InteractionResponseType.Modal, modal), "replied");
+    const data = "toJSON" in modal && typeof modal.toJSON === "function" ? modal.toJSON() : modal;
+    return this.acknowledge(new InteractionResponse(InteractionResponseType.Modal, data), "replied");
   }
 }
 
@@ -3537,6 +3621,9 @@ class ComponentInteraction extends Interaction {
   get customId() {
     return this.data?.data?.custom_id ?? "";
   }
+  get messageId() {
+    return this.data?.message?.id;
+  }
   get componentType() {
     return this.data?.data?.component_type ?? 0;
   }
@@ -3787,6 +3874,7 @@ class AuditLog {
 }
 
 // packages/structures/src/index.ts
+var COMPONENT_COLLECTOR_DEFAULT_TIME = 15 * 60000;
 var NON_SYSTEM_MESSAGE_TYPES = new Set([0, 19, 20, 23]);
 
 class Message extends BaseStructure {
@@ -3807,6 +3895,7 @@ class Message extends BaseStructure {
   reference;
   components;
   referencedMessage;
+  member;
   #context;
   constructor(data, context) {
     super(data.id);
@@ -3829,6 +3918,11 @@ class Message extends BaseStructure {
     this.reference = data.message_reference;
     this.referencedMessage = data.referenced_message ? new Message(data.referenced_message, context) : data.referenced_message === null ? null : undefined;
     this.#context = context;
+    this.member = data.member && data.guild_id ? new GuildMember({
+      ...data.member,
+      user: data.member.user ?? data.author,
+      guild_id: data.guild_id
+    }, context) : null;
     this.channel = new Channel({ id: data.channel_id, type: 0, guild_id: data.guild_id }, context);
   }
   get embedsSuppressed() {
@@ -3869,6 +3963,20 @@ class Message extends BaseStructure {
       throw new Error("This message is not attached to a client.");
     return this.#context.crosspostMessage(this.channelId, this.id);
   }
+  createComponentCollector(options = {}) {
+    const collect = this.#context?.collectInteractions;
+    if (!collect)
+      throw new Error("This message is not attached to a client.");
+    const { componentType, filter, ...rest } = options;
+    return collect({
+      ...rest,
+      time: rest.time ?? (rest.idle ? undefined : COMPONENT_COLLECTOR_DEFAULT_TIME),
+      filter: async (interaction) => interaction.isMessageComponent() && interaction.messageId === this.id && (componentType === undefined || interaction.componentType === componentType) && (filter ? await filter(interaction) : true)
+    });
+  }
+  awaitComponent(options = {}) {
+    return this.createComponentCollector({ ...options, max: 1 }).next();
+  }
   react(emoji) {
     if (!this.#context?.addReaction)
       throw new Error("This message is not attached to a client.");
@@ -3942,6 +4050,20 @@ class Message extends BaseStructure {
 }
 
 // packages/managers/src/message.ts
+function toRequest(options) {
+  const { files, ...body } = options;
+  if (!files?.length)
+    return body;
+  return {
+    body,
+    files: files.map((file) => ({
+      name: file.name,
+      data: typeof file.data === "string" ? new TextEncoder().encode(file.data) : file.data,
+      contentType: file.contentType
+    }))
+  };
+}
+
 class MessageManager {
   cache;
   #caching;
@@ -3964,7 +4086,7 @@ class MessageManager {
     return this.cache.get(messageId) ?? this.fetch(messageId);
   }
   async send(options) {
-    const data = await this.#rest.post(Routes.channelMessages(this.#channelId), options);
+    const data = await this.#rest.post(Routes.channelMessages(this.#channelId), toRequest(options));
     return this.upsert(data);
   }
   async fetch(messageId) {
@@ -4245,14 +4367,20 @@ class MonetizationManager extends Manager {
 // packages/managers/src/member.ts
 class GuildMemberManager extends ResourceManager {
   #rest;
+  #context;
   guildId;
-  constructor(guildId, rest) {
-    super((id) => rest.get(Routes.guildMember(guildId, id)).then((data) => new GuildMember({ ...data, guild_id: guildId })), (member) => member.user.id);
+  constructor(guildId, rest, context = () => {
+    return;
+  }) {
+    super((id) => rest.get(Routes.guildMember(guildId, id)).then((data) => new GuildMember({ ...data, guild_id: guildId }, context())), (member) => member.user.id);
     this.guildId = guildId;
     this.#rest = rest;
+    this.#context = context;
   }
-  async kick(userId) {
-    await this.#rest.delete(Routes.guildMember(this.guildId, userId));
+  async kick(userId, reason) {
+    await this.#rest.delete(Routes.guildMember(this.guildId, userId), {
+      reason
+    });
     this.delete(userId);
   }
   async ban(userId, options = {}) {
@@ -4262,21 +4390,21 @@ class GuildMemberManager extends ResourceManager {
   async unban(userId) {
     await this.#rest.delete(Routes.guildBan(this.guildId, userId));
   }
-  async edit(userId, options) {
-    const data = await this.#rest.patch(Routes.guildMember(this.guildId, userId), options);
-    const member = new GuildMember({ ...data, guild_id: this.guildId });
+  async edit(userId, options, reason) {
+    const data = await this.#rest.patch(Routes.guildMember(this.guildId, userId), options, { reason });
+    const member = new GuildMember({ ...data, guild_id: this.guildId }, this.#context());
     this.set(member.user.id, member);
     return member;
   }
-  async addRole(userId, roleId) {
-    await this.#rest.put(Routes.guildMemberRole(this.guildId, userId, roleId));
+  async addRole(userId, roleId, reason) {
+    await this.#rest.put(Routes.guildMemberRole(this.guildId, userId, roleId), undefined, { reason });
   }
-  async removeRole(userId, roleId) {
-    await this.#rest.delete(Routes.guildMemberRole(this.guildId, userId, roleId));
+  async removeRole(userId, roleId, reason) {
+    await this.#rest.delete(Routes.guildMemberRole(this.guildId, userId, roleId), { reason });
   }
-  async timeout(userId, milliseconds) {
+  async timeout(userId, milliseconds, reason) {
     const timeoutDate = milliseconds === null ? null : new Date(Date.now() + milliseconds).toISOString();
-    return this.edit(userId, { communication_disabled_until: timeoutDate });
+    return this.edit(userId, { communication_disabled_until: timeoutDate }, reason);
   }
 }
 
@@ -4447,10 +4575,25 @@ class StageInstanceManager extends Manager {
 
 class PermissionOverwriteManager {
   #rest;
+  #current;
   channelId;
-  constructor(rest, channelId) {
+  constructor(rest, channelId, current = () => {
+    return;
+  }) {
     this.#rest = rest;
     this.channelId = channelId;
+    this.#current = current;
+  }
+  async update(overwriteId, changes, options = {}) {
+    const overwrites = this.#current() ?? (await this.#rest.get(Routes.channel(this.channelId))).permission_overwrites ?? [];
+    const existing = overwrites.find((entry) => entry.id === overwriteId);
+    const type = existing?.type ?? options.type;
+    if (type !== 0 && type !== 1)
+      throw new TypeError("A new permission overwrite needs a type: 0 for a role, 1 for a member.");
+    const touched = (changes.allow ?? 0n) | (changes.deny ?? 0n) | (changes.inherit ?? 0n);
+    const allow = BigInt(existing?.allow ?? 0) & ~touched | (changes.allow ?? 0n);
+    const deny = BigInt(existing?.deny ?? 0) & ~touched | (changes.deny ?? 0n);
+    await this.edit(overwriteId, { type, allow, deny }, options.reason);
   }
   async edit(overwriteId, options, reason) {
     await this.#rest.put(Routes.channelPermission(this.channelId, overwriteId), {
@@ -4482,6 +4625,10 @@ class GuildManager extends ResourceManager {
   #voiceStates = new Map;
   #autoModerationRules = new Map;
   #invites = new Map;
+  #context;
+  attachContext(context) {
+    this.#context = context;
+  }
   #perGuild(map, guildId, create) {
     let manager = map.get(guildId);
     if (!manager)
@@ -4507,7 +4654,7 @@ class GuildManager extends ResourceManager {
   members(guildId) {
     let manager = this.#members.get(guildId);
     if (!manager)
-      this.#members.set(guildId, manager = new GuildMemberManager(guildId, this.#rest));
+      this.#members.set(guildId, manager = new GuildMemberManager(guildId, this.#rest, () => this.#context));
     return manager;
   }
   roles(guildId) {
@@ -4763,7 +4910,7 @@ class ChannelManager extends Manager {
     return manager;
   }
   permissionOverwrites(channelId) {
-    return new PermissionOverwriteManager(this.#rest, channelId);
+    return new PermissionOverwriteManager(this.#rest, channelId, () => this.get(channelId)?.permissionOverwrites);
   }
   threads(channelId) {
     return new ThreadManager(this.#rest, this.#context, channelId);
@@ -4863,7 +5010,7 @@ class ChannelManager extends Manager {
     return this.messages(data.channel_id).upsert(data);
   }
   async editMessage(channelId, messageId, options) {
-    return this.messages(channelId).upsert(await this.#rest.patch(Routes.message(channelId, messageId), options));
+    return this.messages(channelId).upsert(await this.#rest.patch(Routes.message(channelId, messageId), toRequest(options)));
   }
   async deleteMessage(channelId, messageId) {
     await this.#rest.delete(Routes.message(channelId, messageId));
@@ -6197,8 +6344,32 @@ class Client extends EventEmitter2 {
       removeReaction: (channelId, messageId, emoji, userId) => this.channels.removeReaction(channelId, messageId, emoji, userId),
       removeAllReactions: (channelId, messageId) => this.channels.removeAllReactions(channelId, messageId),
       pinMessage: (channelId, messageId) => this.channels.pinMessage(channelId, messageId),
-      unpinMessage: (channelId, messageId) => this.channels.unpinMessage(channelId, messageId)
+      unpinMessage: (channelId, messageId) => this.channels.unpinMessage(channelId, messageId),
+      collectInteractions: (options) => this.createCollector("interactionCreate" /* InteractionCreate */, options),
+      memberPermissions: (guildId, memberId, roleIds, channelId) => this.#memberPermissions(guildId, memberId, roleIds, channelId),
+      kickMember: (guildId, userId, reason) => this.guilds.members(guildId).kick(userId, reason),
+      banMember: (guildId, userId, options) => this.guilds.members(guildId).ban(userId, options),
+      editMember: (guildId, userId, options, reason) => this.guilds.members(guildId).edit(userId, options, reason),
+      addMemberRole: (guildId, userId, roleId, reason) => this.guilds.members(guildId).addRole(userId, roleId, reason),
+      removeMemberRole: (guildId, userId, roleId, reason) => this.guilds.members(guildId).removeRole(userId, roleId, reason),
+      editPermissionOverwrite: async (channelId, targetId, changes, options) => {
+        const bits = { allow: 0n, deny: 0n, inherit: 0n };
+        for (const [name, value] of Object.entries(changes)) {
+          if (!/^[A-Za-z]+$/.test(name))
+            throw new TypeError(`Unknown permission: ${name}`);
+          let bit;
+          try {
+            bit = new PermissionSet(name).bitfield;
+          } catch {
+            throw new TypeError(`Unknown permission: ${name}`);
+          }
+          const key = value === true ? "allow" : value === false ? "deny" : "inherit";
+          bits[key] |= bit;
+        }
+        return this.channels.permissionOverwrites(channelId).update(targetId, bits, options);
+      }
     };
+    this.guilds.attachContext(this.#resourceContext);
     this.#gateway = new Gateway({
       token: options.token,
       intents: options.intents,
@@ -6230,8 +6401,14 @@ class Client extends EventEmitter2 {
       this.emit("close" /* Close */, data);
     });
     this.#gateway.on("MESSAGE_CREATE", (data) => {
-      const message = new Message(data, this.#resourceContext);
+      const payload = data;
+      const message = new Message(payload, this.#resourceContext);
       this.#observeMessage(message);
+      if (payload.member && payload.guild_id && this.guilds.has(payload.guild_id))
+        this.#upsertMember(payload.guild_id, {
+          ...payload.member,
+          user: payload.member.user ?? payload.author
+        });
       const cached = this.options.messageCache ? this.channels.messages(message.channelId).upsert(data) : message;
       this.emit("messageCreate" /* MessageCreate */, cached);
     });
@@ -6536,7 +6713,7 @@ class Client extends EventEmitter2 {
       this.#merge(this.users, message.author.id, message.author);
   }
   #upsertMember(guildId, data) {
-    const member = new GuildMember({ ...data, guild_id: guildId });
+    const member = new GuildMember({ ...data, guild_id: guildId }, this.#resourceContext);
     if (this.#cache.users)
       this.#merge(this.users, member.user.id, member.user);
     if (!this.#cache.members)
@@ -6579,6 +6756,29 @@ class Client extends EventEmitter2 {
     collector.onDispose(() => this.off(event, listener));
     return collector;
   }
+  get resourceContext() {
+    return this.#resourceContext;
+  }
+  #memberPermissions(guildId, memberId, roleIds, channelId) {
+    const guild = this.guilds.get(guildId);
+    if (!guild)
+      return null;
+    let channel = channelId ? this.channels.get(channelId) : undefined;
+    if (channelId) {
+      if (channel?.isThread())
+        channel = channel.parentId ? this.channels.get(channel.parentId) : undefined;
+      if (!channel || channel.guildId !== guildId)
+        return null;
+    }
+    return computePermissions({
+      guildId,
+      ownerId: guild.ownerId,
+      memberId,
+      memberRoleIds: [...roleIds],
+      roles: this.guilds.roles(guildId).values(),
+      overwrites: channel?.permissionOverwrites
+    });
+  }
   permissionsFor(memberId, guildOrChannelId) {
     let channel = this.channels.get(guildOrChannelId);
     if (channel?.isThread()) {
@@ -6622,12 +6822,21 @@ class Client extends EventEmitter2 {
     this.#gateway.close();
   }
   postInteractionResponse(id, token, response) {
-    return this.rest.post(Routes.interactionCallback(id, token), response.toJSON());
+    const json = response.toJSON();
+    const upload = json.data ? toRequest(json.data) : undefined;
+    if (upload && typeof upload === "object" && "files" in upload) {
+      const { body, files } = upload;
+      return this.rest.post(Routes.interactionCallback(id, token), {
+        body: { ...json, data: body },
+        files
+      });
+    }
+    return this.rest.post(Routes.interactionCallback(id, token), json);
   }
   editInteractionReply(token, data) {
     if (!this.user)
       return Promise.reject(new Error("Client is unauthenticated."));
-    return this.rest.patch(Routes.interactionOriginalResponse(this.user.id, token), data);
+    return this.rest.patch(Routes.interactionOriginalResponse(this.user.id, token), toRequest(data));
   }
   deleteInteractionReply(token) {
     if (!this.user)
@@ -6637,7 +6846,7 @@ class Client extends EventEmitter2 {
   followUpInteraction(token, data) {
     if (!this.user)
       return Promise.reject(new Error("Client is unauthenticated."));
-    return this.rest.post(`/webhooks/${this.user.id}/${token}`, data);
+    return this.rest.post(`/webhooks/${this.user.id}/${token}`, toRequest(data));
   }
   interactionWebhookMessage(method, applicationId, token, messageId, data) {
     const path = messageId === "@original" ? Routes.interactionOriginalResponse(applicationId, token) : Routes.webhookMessage(applicationId, token, messageId);
@@ -6805,7 +7014,7 @@ class HandlerRegistry {
 // packages/sharding/package.json
 var package_default2 = {
   name: "@lunibee/sharding",
-  version: "0.2.0",
+  version: "0.2.1",
   type: "module",
   module: "./src/index.ts",
   types: "./src/index.ts",
@@ -7339,6 +7548,187 @@ class ShardManager {
     });
   }
 }
+// packages/utils/src/args.ts
+var SNOWFLAKE = /^\d{16,22}$/;
+var TRUE_WORDS = new Set([
+  "true",
+  "yes",
+  "y",
+  "on",
+  "1",
+  "enable",
+  "enabled"
+]);
+var FALSE_WORDS = new Set([
+  "false",
+  "no",
+  "n",
+  "off",
+  "0",
+  "disable",
+  "disabled"
+]);
+function tokenizeArgs(input) {
+  const args = [];
+  let current = "";
+  let quote = null;
+  let started = false;
+  for (let index = 0;index < input.length; index++) {
+    const character = input[index];
+    if (character === "\\" && index + 1 < input.length) {
+      current += input[++index];
+      started = true;
+    } else if (quote) {
+      if (character === quote)
+        quote = null;
+      else
+        current += character;
+    } else if (character === '"' || character === "'") {
+      if (started)
+        current += character;
+      else {
+        quote = character;
+        started = true;
+      }
+    } else if (/\s/.test(character)) {
+      if (started)
+        args.push(current);
+      current = "";
+      started = false;
+    } else {
+      current += character;
+      started = true;
+    }
+  }
+  if (started)
+    args.push(current);
+  return args;
+}
+function parseUserMention(value) {
+  const id = /^<@!?(\d{16,22})>$/.exec(value)?.[1] ?? value;
+  return SNOWFLAKE.test(id) ? id : null;
+}
+function parseRoleMention(value) {
+  const id = /^<@&(\d{16,22})>$/.exec(value)?.[1] ?? value;
+  return SNOWFLAKE.test(id) ? id : null;
+}
+function parseChannelMention(value) {
+  const id = /^<#(\d{16,22})>$/.exec(value)?.[1] ?? value;
+  return SNOWFLAKE.test(id) ? id : null;
+}
+function parseMentionable(value) {
+  const role = /^<@&(\d{16,22})>$/.exec(value)?.[1];
+  if (role)
+    return { id: role, type: "role" };
+  const user = parseUserMention(value);
+  return user ? { id: user, type: "user" } : null;
+}
+function readOne(spec, raw) {
+  switch (spec.type) {
+    case "string":
+    case "rest":
+      if (spec.maxLength !== undefined && raw.length > spec.maxLength)
+        return {
+          error: `must be at most ${spec.maxLength} characters`
+        };
+      if (spec.choices && !spec.choices.some((choice) => String(choice).toLowerCase() === raw.toLowerCase()))
+        return { error: `must be one of: ${spec.choices.join(", ")}` };
+      return { value: raw };
+    case "integer":
+    case "number": {
+      const value = Number(raw);
+      if (!Number.isFinite(value) || raw.trim() === "")
+        return { error: "must be a number" };
+      if (spec.type === "integer" && !Number.isSafeInteger(value))
+        return { error: "must be a whole number" };
+      if (spec.min !== undefined && value < spec.min)
+        return { error: `must be at least ${spec.min}` };
+      if (spec.max !== undefined && value > spec.max)
+        return { error: `must be at most ${spec.max}` };
+      if (spec.choices && !spec.choices.includes(value))
+        return { error: `must be one of: ${spec.choices.join(", ")}` };
+      return { value };
+    }
+    case "boolean": {
+      const word = raw.toLowerCase();
+      if (TRUE_WORDS.has(word))
+        return { value: true };
+      if (FALSE_WORDS.has(word))
+        return { value: false };
+      return { error: "must be yes or no" };
+    }
+    case "user": {
+      const id = parseUserMention(raw);
+      return id ? { value: id } : { error: "must be a user mention or ID" };
+    }
+    case "role": {
+      const id = parseRoleMention(raw);
+      return id ? { value: id } : { error: "must be a role mention or ID" };
+    }
+    case "channel": {
+      const id = parseChannelMention(raw);
+      return id ? { value: id } : { error: "must be a channel mention or ID" };
+    }
+    case "mentionable": {
+      const value = parseMentionable(raw);
+      return value ? { value } : { error: "must be a user or role mention" };
+    }
+  }
+}
+function parsePrefixArgs(input, specs) {
+  const args = typeof input === "string" ? tokenizeArgs(input) : [...input];
+  const values = {};
+  let position = 0;
+  for (const [index, spec] of specs.entries()) {
+    if (spec.type === "rest" && index !== specs.length - 1)
+      throw new TypeError(`The rest argument "${spec.name}" must be the last one.`);
+    const raw = spec.type === "rest" ? args.slice(position).join(" ") : args[position];
+    if (raw === undefined || raw === "") {
+      if (spec.required)
+        return { ok: false, arg: spec.name, error: "is required" };
+      values[spec.name] = undefined;
+      continue;
+    }
+    const read = readOne(spec, raw);
+    if ("error" in read)
+      return { ok: false, arg: spec.name, error: read.error };
+    values[spec.name] = read.value;
+    position += spec.type === "rest" ? args.length : 1;
+  }
+  return { ok: true, values };
+}
+var OPTION_TYPES = {
+  3: "string",
+  4: "integer",
+  5: "boolean",
+  6: "user",
+  7: "channel",
+  8: "role",
+  9: "mentionable",
+  10: "number"
+};
+function argsFromCommandOptions(options, restLast = false) {
+  const specs = [];
+  for (const option of options) {
+    const type = OPTION_TYPES[option.type];
+    if (!type)
+      continue;
+    specs.push({
+      name: option.name,
+      type,
+      required: option.required,
+      min: option.min_value,
+      max: option.max_value,
+      maxLength: option.max_length,
+      choices: option.choices?.map((choice) => choice.value)
+    });
+  }
+  const last = specs[specs.length - 1];
+  if (restLast && last?.type === "string")
+    last.type = "rest";
+  return specs;
+}
+
 // packages/utils/src/index.ts
 function sleep4(ms) {
   return new Promise((resolve) => setTimeout(resolve, ms));
@@ -7761,15 +8151,24 @@ function entersState(target, status, timeoutMs) {
 class EmbedBuilder {
   #data = {};
   setTitle(value) {
-    this.#data.title = validate(value, 256, "Embed title");
+    if (value === null)
+      delete this.#data.title;
+    else
+      this.#data.title = validate(value, 256, "Embed title");
     return this;
   }
   setDescription(value) {
-    this.#data.description = validate(value, 4096, "Embed description");
+    if (value === null)
+      delete this.#data.description;
+    else
+      this.#data.description = validate(value, 4096, "Embed description");
     return this;
   }
   setURL(value) {
-    this.#data.url = url(value, "Embed URL");
+    if (value === null)
+      delete this.#data.url;
+    else
+      this.#data.url = url(value, "Embed URL");
     return this;
   }
   setColor(value) {
@@ -7801,11 +8200,19 @@ class EmbedBuilder {
     return this;
   }
   setThumbnail(value) {
+    if (value === null) {
+      delete this.#data.thumbnail;
+      return this;
+    }
     const valueURL = typeof value === "string" ? value : value.url;
     this.#data.thumbnail = { url: url(valueURL, "Thumbnail URL") };
     return this;
   }
   setImage(value) {
+    if (value === null) {
+      delete this.#data.image;
+      return this;
+    }
     const valueURL = typeof value === "string" ? value : value.url;
     this.#data.image = { url: url(valueURL, "Image URL") };
     return this;
@@ -8132,6 +8539,9 @@ class ModalBuilder {
     this.#components.push(...components);
     return this;
   }
+  addTextInputs(...inputs) {
+    return this.addComponents(...inputs.map((input) => new ActionRowBuilder().addComponents(input)));
+  }
   toJSON() {
     if (!this.#custom_id || !this.#title)
       throw new TypeError("Modals require a custom ID and a title.");
@@ -8139,8 +8549,8 @@ class ModalBuilder {
       throw new RangeError("Modals require at least one component.");
     return {
       type: 9,
-      ...this.#custom_id ? { custom_id: this.#custom_id } : {},
-      ...this.#title ? { title: this.#title } : {},
+      custom_id: this.#custom_id,
+      title: this.#title,
       components: this.#components.map((component) => component.toJSON())
     };
   }
@@ -8428,6 +8838,17 @@ function assertSelect(data) {
   if ((data.min_values ?? 1) > (data.max_values ?? 1))
     throw new RangeError("min_values cannot exceed max_values.");
 }
+var IS_COMPONENTS_V2 = 1 << 15;
+function componentsV2Message(components, options) {
+  const list = Array.isArray(components) ? components : [components];
+  if (!list.length)
+    throw new TypeError("A Components V2 message needs at least one component.");
+  return {
+    ...options ?? {},
+    components: list.map((component) => component.toJSON()),
+    flags: (options?.flags ?? 0) | IS_COMPONENTS_V2
+  };
+}
 // packages/builders/src/commands.ts
 var ApplicationCommandOptionType2 = {
   Subcommand: 1,
@@ -9039,6 +9460,7 @@ export {
   WelcomeScreenChannel,
   ZlibStreamDecoder,
   abortError,
+  argsFromCommandOptions,
   blockQuote,
   bold,
   bulletList,
@@ -9047,6 +9469,7 @@ export {
   classifyFrame,
   classifyPayload,
   codeBlock,
+  componentsV2Message,
   computePermissions,
   createAudioPlayer,
   createAudioResource,
@@ -9070,6 +9493,11 @@ export {
   masked,
   normalizeRoutePath,
   orderedList,
+  parseChannelMention,
+  parseMentionable,
+  parsePrefixArgs,
+  parseRoleMention,
+  parseUserMention,
   randomInt,
   redactPath,
   resolveGatewayIntents,
@@ -9082,8 +9510,10 @@ export {
   strikethrough,
   subtext,
   timestamp,
+  toRequest,
+  tokenizeArgs,
   underline,
   userMention
 };
 
-//# debugId=726AE42ABABEBEA864756E2164756E21
+//# debugId=9E598E337B852A0164756E2164756E21