lunibee 0.2.2 → 0.2.3

package/dist/index.js

@@ -1549,6 +1549,11 @@ class Collection extends Map {
 }
 
 // packages/managers/src/base.ts
+function splitReason(options) {
+  const { reason, ...payload } = options;
+  return [payload, reason];
+}
+
 class Manager {
   cache = new Collection;
   get(id) {
@@ -1650,12 +1655,15 @@ class ResourceManager extends Manager {
 // packages/rest/package.json
 var package_default = {
   name: "@lunibee/rest",
-  version: "0.2.2",
+  version: "0.2.3",
   type: "module",
   module: "./src/index.ts",
   types: "./src/index.ts",
   exports: {
     ".": "./src/index.ts"
+  },
+  dependencies: {
+    "@lunibee/types": "workspace:*"
   }
 };
 
@@ -1730,6 +1738,10 @@ function kindFromStatus(status) {
 function redactPath(path) {
   return path.replace(/^(\/webhooks\/[^/?]+\/)[^/?]+/, "$1:token").replace(/^(\/interactions\/[^/?]+\/)[^/?]+/, "$1:token");
 }
+var HINTS = {
+  50001: "The bot cannot see this resource: check that it is in the guild and has View Channel there.",
+  50013: "The bot lacks a permission for this action, or the target role or member is at or above the bot's highest role."
+};
 
 class RESTError extends Error {
   kind;
@@ -1738,12 +1750,14 @@ class RESTError extends Error {
   errors;
   method;
   path;
+  hint;
   constructor(message, status, code, errors, options = {}) {
     super(message, options.cause === undefined ? undefined : { cause: options.cause });
     this.name = "RESTError";
     this.status = status;
     this.kind = options.kind ?? kindFromStatus(status);
     this.code = code;
+    this.hint = code === undefined ? undefined : HINTS[code];
     this.errors = errors;
     this.method = options.method;
     this.path = options.path === undefined ? undefined : redactPath(options.path);
@@ -2052,6 +2066,8 @@ var Routes = {
   crosspostMessage: (channelId, messageId) => `${Routes.message(channelId, messageId)}/crosspost`,
   messageReactions: (channelId, messageId, emoji) => `${Routes.message(channelId, messageId)}/reactions/${encodeURIComponent(emoji)}`,
   messageReactionsAll: (channelId, messageId) => `${Routes.message(channelId, messageId)}/reactions`,
+  channelMessagesPins: (channelId) => `/channels/${snowflake(channelId, "Channel ID")}/messages/pins`,
+  channelMessagesPin: (channelId, messageId) => `/channels/${snowflake(channelId, "Channel ID")}/messages/pins/${snowflake(messageId, "Message ID")}`,
   channelPins: (channelId) => `/channels/${snowflake(channelId, "Channel ID")}/pins`,
   channelPin: (channelId, messageId) => `/channels/${snowflake(channelId, "Channel ID")}/pins/${snowflake(messageId, "Message ID")}`,
   messageThread: (channelId, messageId) => `${Routes.message(channelId, messageId)}/threads`,
@@ -2110,6 +2126,44 @@ function snowflake(value, field) {
     throw new TypeError(`${field} must be a valid Discord snowflake.`);
   return value;
 }
+// packages/rest/src/error-codes.ts
+var RESTErrorCode = {
+  UnknownAccount: 10001,
+  UnknownChannel: 10003,
+  UnknownGuild: 10004,
+  UnknownInvite: 10006,
+  UnknownMember: 10007,
+  UnknownMessage: 10008,
+  UnknownPermissionOverwrite: 10009,
+  UnknownRole: 10011,
+  UnknownUser: 10013,
+  UnknownEmoji: 10014,
+  UnknownWebhook: 10015,
+  UnknownBan: 10026,
+  UnknownSticker: 10060,
+  UnknownInteraction: 10062,
+  UnknownScheduledEvent: 10070,
+  BotsCannotUseEndpoint: 20001,
+  MaxGuilds: 30001,
+  MaxPins: 30003,
+  MaxRoles: 30005,
+  MaxWebhooks: 30007,
+  MaxEmojis: 30008,
+  MaxReactions: 30010,
+  MaxChannels: 30013,
+  InteractionAlreadyAcknowledged: 40060,
+  MissingAccess: 50001,
+  CannotExecuteInDM: 50003,
+  CannotEditOthersMessage: 50005,
+  CannotSendEmptyMessage: 50006,
+  CannotSendMessagesToUser: 50007,
+  MissingPermissions: 50013,
+  InvalidToken: 50014,
+  MessageTooOldToBulkDelete: 50034,
+  InvalidFormBody: 50035,
+  ThreadArchived: 50083,
+  CannotReplyWithoutReadHistory: 160002
+};
 // packages/rest/src/redis.ts
 var RESERVE_SCRIPT = `
 local raw = redis.call('GET', KEYS[1])
@@ -2291,7 +2345,7 @@ class WebhookClient {
 // packages/rest/src/index.ts
 var LIBRARY_VERSION = package_default.version;
 var LIBRARY_URL = "https://github.com/Ekretos/lunibee";
-var USER_AGENT = `DiscordBot (${LIBRARY_URL}, ${package_default.version})`;
+var USER_AGENT = `DiscordBot (${LIBRARY_URL}, ${LIBRARY_VERSION})`;
 var REQUEST_DATA_KEYS = new Set([
   "body",
   "files",
@@ -2614,13 +2668,13 @@ class Channel extends BaseStructure {
     this.permissionOverwrites = (data.permission_overwrites ?? []).map((overwrite) => ({ ...overwrite }));
     this.#context = context;
   }
-  sendMessage(options) {
+  send(options) {
     if (!this.#context)
       throw new Error("This channel is not attached to a client.");
     return this.#context.sendMessage(this.id, options);
   }
-  send(options) {
-    return this.sendMessage(options);
+  sendMessage(options) {
+    return this.send(options);
   }
   edit(options) {
     if (!this.#context?.editChannel)
@@ -2643,10 +2697,10 @@ class Channel extends BaseStructure {
   editParent(parentId) {
     return this.edit({ parent_id: parentId });
   }
-  delete() {
+  delete(reason) {
     if (!this.#context?.deleteChannel)
       throw new Error("This channel is not attached to a client.");
-    return this.#context.deleteChannel(this.id);
+    return this.#context.deleteChannel(this.id, reason);
   }
   update(options) {
     return this.edit(options);
@@ -2693,6 +2747,15 @@ class Guild extends BaseStructure {
   mfaLevel;
   explicitContentFilter;
   defaultMessageNotifications;
+  afkChannelId;
+  afkTimeout;
+  widgetEnabled;
+  widgetChannelId;
+  applicationId;
+  publicUpdatesChannelId;
+  safetyAlertsChannelId;
+  maxPresences;
+  maxVideoChannelUsers;
   constructor(data) {
     super(data.id);
     if (!data.name)
@@ -2714,14 +2777,22 @@ class Guild extends BaseStructure {
     this.vanityUrlCode = data.vanity_url_code ?? null;
     this.nsfwLevel = data.nsfw_level ?? 0;
     this.discoverySplash = data.discovery_splash ?? null;
-    const d = data;
-    this.rulesChannelId = d.rules_channel_id ?? null;
-    this.systemChannelId = d.system_channel_id ?? null;
-    this.systemChannelFlags = d.system_channel_flags ?? 0;
-    this.maxMembers = d.max_members ?? 0;
-    this.mfaLevel = d.mfa_level ?? 0;
-    this.explicitContentFilter = d.explicit_content_filter ?? 0;
-    this.defaultMessageNotifications = d.default_message_notifications ?? 0;
+    this.rulesChannelId = data.rules_channel_id ?? null;
+    this.systemChannelId = data.system_channel_id ?? null;
+    this.systemChannelFlags = data.system_channel_flags ?? 0;
+    this.maxMembers = data.max_members ?? 0;
+    this.mfaLevel = data.mfa_level ?? 0;
+    this.explicitContentFilter = data.explicit_content_filter ?? 0;
+    this.defaultMessageNotifications = data.default_message_notifications ?? 0;
+    this.afkChannelId = data.afk_channel_id ?? null;
+    this.afkTimeout = data.afk_timeout;
+    this.widgetEnabled = data.widget_enabled ?? false;
+    this.widgetChannelId = data.widget_channel_id ?? null;
+    this.applicationId = data.application_id ?? null;
+    this.publicUpdatesChannelId = data.public_updates_channel_id ?? null;
+    this.safetyAlertsChannelId = data.safety_alerts_channel_id ?? null;
+    this.maxPresences = data.max_presences ?? null;
+    this.maxVideoChannelUsers = data.max_video_channel_users;
   }
   iconURL(options = {}) {
     if (!this.icon)
@@ -3257,6 +3328,13 @@ var OptionType = {
 class CommandOptions {
   #options;
   #resolved;
+  #lookup(kind, id) {
+    const group = this.#resolved?.[kind];
+    if (typeof group !== "object" || group === null)
+      return;
+    const entry = group[id];
+    return typeof entry === "object" && entry !== null ? entry : undefined;
+  }
   constructor(options, resolved = {}) {
     let currentOptions = options;
     let group = null;
@@ -3345,7 +3423,7 @@ class CommandOptions {
       return null;
     }
     const userId = String(opt.value);
-    const resolved = this.#resolved?.users?.[userId] ?? null;
+    const resolved = this.#lookup("users", userId) ?? null;
     if (!resolved && required)
       throw new TypeError(`Resolved user for option "${name}" is missing.`);
     return resolved;
@@ -3358,7 +3436,7 @@ class CommandOptions {
       return null;
     }
     const channelId = String(opt.value);
-    const resolved = this.#resolved?.channels?.[channelId] ?? null;
+    const resolved = this.#lookup("channels", channelId) ?? null;
     if (!resolved && required)
       throw new TypeError(`Resolved channel for option "${name}" is missing.`);
     return resolved;
@@ -3371,7 +3449,7 @@ class CommandOptions {
       return null;
     }
     const roleId = String(opt.value);
-    const resolved = this.#resolved?.roles?.[roleId] ?? null;
+    const resolved = this.#lookup("roles", roleId) ?? null;
     if (!resolved && required)
       throw new TypeError(`Resolved role for option "${name}" is missing.`);
     return resolved;
@@ -3384,7 +3462,7 @@ class CommandOptions {
       return null;
     }
     const id = String(opt.value);
-    const resolved = this.#resolved?.users?.[id] ?? this.#resolved?.roles?.[id] ?? null;
+    const resolved = this.#lookup("users", id) ?? this.#lookup("roles", id) ?? null;
     if (!resolved && required)
       throw new TypeError(`Resolved mentionable for option "${name}" is missing.`);
     return resolved;
@@ -3394,9 +3472,9 @@ class CommandOptions {
     if (!opt || opt.type !== OptionType.Mentionable)
       return null;
     const id = String(opt.value);
-    if (this.#resolved?.users?.[id])
+    if (this.#lookup("users", id))
       return "user";
-    if (this.#resolved?.roles?.[id])
+    if (this.#lookup("roles", id))
       return "role";
     return null;
   }
@@ -3408,7 +3486,7 @@ class CommandOptions {
       return null;
     }
     const attachmentId = String(opt.value);
-    const resolved = this.#resolved?.attachments?.[attachmentId] ?? null;
+    const resolved = this.#lookup("attachments", attachmentId) ?? null;
     if (!resolved && required)
       throw new TypeError(`Resolved attachment for option "${name}" is missing.`);
     return resolved;
@@ -3712,16 +3790,19 @@ class ContextMenuCommandInteraction extends CommandInteraction {
 
 class ComponentInteraction extends Interaction {
   get customId() {
-    return this.data?.data?.custom_id ?? "";
+    const id = this.data.data?.custom_id;
+    return typeof id === "string" ? id : "";
   }
   get messageId() {
-    return this.data?.message?.id;
+    return this.data.message?.id;
   }
   get componentType() {
-    return this.data?.data?.component_type ?? 0;
+    const type = this.data.data?.component_type;
+    return typeof type === "number" ? type : 0;
   }
   get values() {
-    return this.data?.data?.values ?? [];
+    const values = this.data.data?.values;
+    return Array.isArray(values) ? values : [];
   }
   async deferUpdate(options = {}) {
     const withResponse = options.withResponse === true;
@@ -3733,10 +3814,11 @@ class ComponentInteraction extends Interaction {
 
 class ModalSubmitInteraction extends Interaction {
   get customId() {
-    return this.data?.data?.custom_id ?? "";
+    const id = this.data.data?.custom_id;
+    return typeof id === "string" ? id : "";
   }
   getInputValue(customId) {
-    const rows = this.data?.data?.components ?? [];
+    const rows = this.data.data?.components ?? [];
     for (const row of rows) {
       for (const comp of row.components ?? []) {
         if (comp.custom_id === customId)
@@ -3760,11 +3842,12 @@ class AutocompleteInteraction extends Interaction {
     this.options = new CommandOptions(data.data?.options ?? []);
   }
   get commandName() {
-    return this.data?.data?.name ?? "";
+    const name = this.data.data?.name;
+    return typeof name === "string" ? name : "";
   }
   get focusedOption() {
-    const options = this.data?.data?.options ?? [];
-    return findFocused(options);
+    const options = this.data.data?.options;
+    return findFocused(Array.isArray(options) ? options : []);
   }
   async respond(choices) {
     if (!Array.isArray(choices))
@@ -4048,10 +4131,10 @@ class Message extends BaseStructure {
   update(options) {
     return this.edit(options);
   }
-  delete() {
+  delete(reason) {
     if (!this.#context)
       throw new Error("This message is not attached to a client.");
-    return this.#context.deleteMessage(this.channelId, this.id);
+    return this.#context.deleteMessage(this.channelId, this.id, reason);
   }
   reply(options) {
     if (!this.#context)
@@ -4098,15 +4181,15 @@ class Message extends BaseStructure {
       throw new Error("This message is not attached to a client.");
     return this.#context.removeAllReactions(this.channelId, this.id);
   }
-  pin() {
+  pin(reason) {
     if (!this.#context?.pinMessage)
       throw new Error("This message is not attached to a client.");
-    return this.#context.pinMessage(this.channelId, this.id);
+    return this.#context.pinMessage(this.channelId, this.id, reason);
   }
-  unpin() {
+  unpin(reason) {
     if (!this.#context?.unpinMessage)
       throw new Error("This message is not attached to a client.");
-    return this.#context.unpinMessage(this.channelId, this.id);
+    return this.#context.unpinMessage(this.channelId, this.id, reason);
   }
   get isEphemeral() {
     return (this.flags & 64) !== 0;
@@ -4285,15 +4368,22 @@ class EmojiManager extends Manager {
     return data.map((item) => this.upsert(item));
   }
   async create(options) {
-    return this.upsert(await this.#rest.post(Routes.guildEmoji(this.#guildId), options));
+    const [payload, reason] = splitReason(options);
+    return this.upsert(await this.#rest.post(Routes.guildEmoji(this.#guildId), payload, { reason }));
   }
   async edit(emojiId, options) {
-    return this.upsert(await this.#rest.patch(Routes.guildEmoji(this.#guildId, emojiId), options));
+    const [payload, reason] = splitReason(options);
+    return this.upsert(await this.#rest.patch(Routes.guildEmoji(this.#guildId, emojiId), payload, { reason }));
   }
-  async deleteEmoji(emojiId) {
-    await this.#rest.delete(Routes.guildEmoji(this.#guildId, emojiId));
+  async remove(emojiId, reason) {
+    await this.#rest.delete(Routes.guildEmoji(this.#guildId, emojiId), {
+      reason
+    });
     this.delete(emojiId);
   }
+  deleteEmoji(emojiId) {
+    return this.remove(emojiId);
+  }
   upsert(data) {
     const key = data.id != null ? data.id : `unicode:${data.name ?? ""}`;
     return this.#merge(key, new Emoji(data));
@@ -4497,11 +4587,16 @@ class GuildMemberManager extends ResourceManager {
     await this.#rest.put(Routes.guildBan(this.guildId, userId), { delete_message_seconds: options.deleteMessageSeconds }, { reason: options.reason });
     this.delete(userId);
   }
-  async unban(userId) {
-    await this.#rest.delete(Routes.guildBan(this.guildId, userId));
+  async unban(userId, reason) {
+    await this.#rest.delete(Routes.guildBan(this.guildId, userId), {
+      reason
+    });
   }
   async edit(userId, options, reason) {
-    const data = await this.#rest.patch(Routes.guildMember(this.guildId, userId), options, { reason });
+    const [payload, optionsReason] = splitReason(options);
+    const data = await this.#rest.patch(Routes.guildMember(this.guildId, userId), payload, {
+      reason: optionsReason ?? reason
+    });
     const member = new GuildMember({ ...data, guild_id: this.guildId }, this.#context());
     this.set(member.user.id, member);
     return member;
@@ -4540,7 +4635,7 @@ class RoleManager extends ResourceManager {
     const data = await this.#rest.post(Routes.guildRoles(this.guildId), {
       ...payload,
       permissions: payload.permissions !== undefined ? String(payload.permissions) : undefined
-    });
+    }, { reason });
     const role = new Role(data);
     this.set(role.id, role);
     return role;
@@ -4550,15 +4645,28 @@ class RoleManager extends ResourceManager {
     const data = await this.#rest.patch(Routes.guildRole(this.guildId, roleId), {
       ...payload,
       permissions: payload.permissions !== undefined ? String(payload.permissions) : undefined
-    });
+    }, { reason });
     const role = new Role(data);
     this.set(role.id, role);
     return role;
   }
-  async deleteRole(roleId) {
-    await this.#rest.delete(Routes.guildRole(this.guildId, roleId));
+  async remove(roleId, reason) {
+    await this.#rest.delete(Routes.guildRole(this.guildId, roleId), {
+      reason
+    });
     this.delete(roleId);
   }
+  async setPositions(positions, reason) {
+    const data = await this.#rest.patch(Routes.guildRoles(this.guildId), positions.map(({ id, position }) => ({ id, position })), { reason });
+    return data.map((item) => {
+      const role = new Role(item);
+      this.set(role.id, role);
+      return role;
+    });
+  }
+  deleteRole(roleId) {
+    return this.remove(roleId);
+  }
 }
 
 // packages/managers/src/guild-resources.ts
@@ -4630,13 +4738,15 @@ class GuildScheduledEventManager extends Manager {
     return events.map((event) => this.#store(event));
   }
   async create(options, reason) {
-    return this.#store(await this.#rest.post(Routes.guildScheduledEvents(this.guildId), options, { reason }));
+    const [payload, optionsReason] = splitReason(options);
+    return this.#store(await this.#rest.post(Routes.guildScheduledEvents(this.guildId), payload, { reason: optionsReason ?? reason }));
   }
   async edit(eventId, options, reason) {
-    return this.#store(await this.#rest.patch(Routes.guildScheduledEvent(this.guildId, eventId), options, { reason }));
+    const [payload, optionsReason] = splitReason(options);
+    return this.#store(await this.#rest.patch(Routes.guildScheduledEvent(this.guildId, eventId), payload, { reason: optionsReason ?? reason }));
   }
-  async remove(eventId) {
-    await this.#rest.delete(Routes.guildScheduledEvent(this.guildId, eventId));
+  async remove(eventId, reason) {
+    await this.#rest.delete(Routes.guildScheduledEvent(this.guildId, eventId), { reason });
     this.delete(eventId);
   }
   async fetchSubscribers(eventId, options = {}) {
@@ -4667,13 +4777,13 @@ class StageInstanceManager extends Manager {
       privacy_level: options.privacyLevel,
       send_start_notification: options.sendStartNotification,
       guild_scheduled_event_id: options.guildScheduledEventId
-    }, { reason }));
+    }, { reason: options.reason ?? reason }));
   }
   async fetch(channelId) {
     return this.#store(await this.#rest.get(Routes.stageInstanceByChannel(channelId)));
   }
   async edit(channelId, options, reason) {
-    return this.#store(await this.#rest.patch(Routes.stageInstanceByChannel(channelId), { topic: options.topic, privacy_level: options.privacyLevel }, { reason }));
+    return this.#store(await this.#rest.patch(Routes.stageInstanceByChannel(channelId), { topic: options.topic, privacy_level: options.privacyLevel }, { reason: options.reason ?? reason }));
   }
   async remove(channelId, reason) {
     await this.#rest.delete(Routes.stageInstanceByChannel(channelId), {
@@ -4710,7 +4820,7 @@ class PermissionOverwriteManager {
       type: options.type,
       allow: BigInt(options.allow ?? 0).toString(),
       deny: BigInt(options.deny ?? 0).toString()
-    }, { reason });
+    }, { reason: options.reason ?? reason });
   }
   async remove(overwriteId, reason) {
     await this.#rest.delete(Routes.channelPermission(this.channelId, overwriteId), { reason });
@@ -4828,12 +4938,16 @@ class GuildManager extends ResourceManager {
     return this.upsert(new Guild(data));
   }
   async edit(id, options) {
-    const data = await this.#rest.patch(Routes.guild(id), options);
+    const [payload, reason] = splitReason(options);
+    const data = await this.#rest.patch(Routes.guild(id), payload, { reason });
     return this.upsert(new Guild(data));
   }
-  async deleteGuild(id) {
+  async remove(id) {
     await this.#rest.delete(Routes.guild(id));
   }
+  deleteGuild(id) {
+    return this.remove(id);
+  }
   async fetchPreview(id) {
     return this.#rest.get(Routes.guildPreview(id));
   }
@@ -4877,15 +4991,17 @@ class GuildManager extends ResourceManager {
     return new AutoModerationRule(rule);
   }
   async createAutoModerationRule(guildId, options) {
-    const rule = await this.#rest.post(Routes.guildAutoModerationRules(guildId), options);
+    const [payload, reason] = splitReason(options);
+    const rule = await this.#rest.post(Routes.guildAutoModerationRules(guildId), payload, { reason });
     return new AutoModerationRule(rule);
   }
   async editAutoModerationRule(guildId, ruleId, options) {
-    const rule = await this.#rest.patch(Routes.guildAutoModerationRule(guildId, ruleId), options);
+    const [payload, reason] = splitReason(options);
+    const rule = await this.#rest.patch(Routes.guildAutoModerationRule(guildId, ruleId), payload, { reason });
     return new AutoModerationRule(rule);
   }
-  async deleteAutoModerationRule(guildId, ruleId) {
-    await this.#rest.delete(Routes.guildAutoModerationRule(guildId, ruleId));
+  async deleteAutoModerationRule(guildId, ruleId, reason) {
+    await this.#rest.delete(Routes.guildAutoModerationRule(guildId, ruleId), { reason });
   }
 }
 var AuditLogEvent = {
@@ -5001,16 +5117,16 @@ class ChannelManager extends Manager {
     this.#context = {
       sendMessage: (channelId, options) => this.send(channelId, options),
       editMessage: (channelId, messageId, options) => this.editMessage(channelId, messageId, options),
-      deleteMessage: (channelId, messageId) => this.deleteMessage(channelId, messageId),
+      deleteMessage: (channelId, messageId, reason) => this.deleteMessage(channelId, messageId, reason),
       crosspostMessage: (channelId, messageId) => this.crosspostMessage(channelId, messageId),
       editChannel: (channelId, options) => this.edit(channelId, options),
-      deleteChannel: (channelId) => this.deleteChannel(channelId),
+      deleteChannel: (channelId, reason) => this.remove(channelId, reason),
       addReaction: (channelId, messageId, emoji) => this.addReaction(channelId, messageId, emoji),
       removeOwnReaction: (channelId, messageId, emoji) => this.removeOwnReaction(channelId, messageId, emoji),
       removeReaction: (channelId, messageId, emoji, userId) => this.removeReaction(channelId, messageId, emoji, userId),
       removeAllReactions: (channelId, messageId) => this.removeAllReactions(channelId, messageId),
-      pinMessage: (channelId, messageId) => this.pinMessage(channelId, messageId),
-      unpinMessage: (channelId, messageId) => this.unpinMessage(channelId, messageId)
+      pinMessage: (channelId, messageId, reason) => this.pinMessage(channelId, messageId, reason),
+      unpinMessage: (channelId, messageId, reason) => this.unpinMessage(channelId, messageId, reason)
     };
   }
   messages(channelId) {
@@ -5080,15 +5196,20 @@ class ChannelManager extends Manager {
     return this.#messageManagers.get(channelId);
   }
   async create(guildId, options) {
-    return this.upsert(await this.#rest.post(Routes.guildChannels(guildId), options));
+    const [payload, reason] = splitReason(options);
+    return this.upsert(await this.#rest.post(Routes.guildChannels(guildId), payload, { reason }));
   }
   async edit(channelId, options) {
-    return this.upsert(await this.#rest.patch(Routes.channel(channelId), options));
+    const [payload, reason] = splitReason(options);
+    return this.upsert(await this.#rest.patch(Routes.channel(channelId), payload, { reason }));
   }
-  async deleteChannel(channelId) {
-    await this.#rest.delete(Routes.channel(channelId));
+  async remove(channelId, reason) {
+    await this.#rest.delete(Routes.channel(channelId), { reason });
     this.delete(channelId);
   }
+  deleteChannel(channelId) {
+    return this.remove(channelId);
+  }
   delete(channelId) {
     this.#messageManagers.delete(channelId);
     return super.delete(channelId);
@@ -5124,8 +5245,10 @@ class ChannelManager extends Manager {
   async editMessage(channelId, messageId, options) {
     return this.messages(channelId).upsert(await this.#rest.patch(Routes.message(channelId, messageId), toRequest(options, this.#allowedMentions)));
   }
-  async deleteMessage(channelId, messageId) {
-    await this.#rest.delete(Routes.message(channelId, messageId));
+  async deleteMessage(channelId, messageId, reason) {
+    await this.#rest.delete(Routes.message(channelId, messageId), {
+      reason
+    });
     this.messages(channelId).delete(messageId);
   }
   deleteCachedMessage(channelId, messageId) {
@@ -5134,19 +5257,17 @@ class ChannelManager extends Manager {
   async crosspostMessage(channelId, messageId) {
     return this.messages(channelId).upsert(await this.#rest.post(Routes.crosspostMessage(channelId, messageId)));
   }
-  async bulkDeleteMessages(channelId, messageIds) {
+  async bulkDeleteMessages(channelId, messageIds, reason) {
     const ids = [...new Set(messageIds)];
     if (ids.length < 1 || ids.length > 100)
       throw new RangeError("bulkDelete requires between 1 and 100 message IDs.");
     if (ids.length === 1)
-      return this.deleteMessage(channelId, ids[0]);
+      return this.deleteMessage(channelId, ids[0], reason);
     const cutoff = Date.now() - BULK_DELETE_MAX_AGE_MS;
     const tooOld = ids.filter((id) => snowflakeTime(id) < cutoff);
     if (tooOld.length)
       throw new RangeError(`bulkDelete cannot delete messages older than 14 days: ${tooOld.join(", ")}`);
-    await this.#rest.post(Routes.channelBulkDelete(channelId), {
-      messages: ids
-    });
+    await this.#rest.post(Routes.channelBulkDelete(channelId), { messages: ids }, { reason });
     for (const id of ids)
       this.messages(channelId).delete(id);
   }
@@ -5189,14 +5310,20 @@ class ChannelManager extends Manager {
     await this.#rest.delete(Routes.messageReactionsAll(channelId, messageId));
   }
   async fetchPinnedMessages(channelId) {
-    const data = await this.#rest.get(Routes.channelPins(channelId));
-    return data.map((item) => this.messages(channelId).upsert(item));
+    const data = await this.#rest.get(Routes.channelMessagesPins(channelId));
+    return data.items.map((item) => this.messages(channelId).upsert(item.message));
   }
-  async pinMessage(channelId, messageId) {
-    await this.#rest.put(Routes.channelPin(channelId, messageId));
+  async pinMessage(channelId, messageId, reason) {
+    await this.#rest.put(Routes.channelMessagesPin(channelId, messageId), undefined, { reason });
   }
-  async unpinMessage(channelId, messageId) {
-    await this.#rest.delete(Routes.channelPin(channelId, messageId));
+  async unpinMessage(channelId, messageId, reason) {
+    await this.#rest.delete(Routes.channelMessagesPin(channelId, messageId), { reason });
+  }
+  async createWebhook(channelId, options) {
+    const [payload, reason] = splitReason(options);
+    return this.#rest.post(Routes.channelWebhooks(channelId), payload, {
+      reason
+    });
   }
   createThreadFromMessage(channelId, messageId, options) {
     return this.threads(channelId).createFromMessage(messageId, options);
@@ -5214,7 +5341,7 @@ class ChannelManager extends Manager {
       hasMore: messages.length === limit
     };
   }
-  async bulkDelete(channelId, messageIds) {
+  bulkDelete(channelId, messageIds) {
     return this.bulkDeleteMessages(channelId, messageIds);
   }
   clear() {
@@ -6369,18 +6496,31 @@ class EventEmitter2 {
     return true;
   }
   #handleError(event, error) {
-    if (event === "error" /* Error */)
-      return;
     const normalized = error instanceof Error ? error : new Error(String(error), { cause: error });
-    for (const listener of [
+    const listeners = event === "error" /* Error */ ? [] : [
       ...this.#listeners.get("error" /* Error */) ?? []
-    ]) {
+    ];
+    if (listeners.length === 0)
+      return warnListenerError(event, normalized);
+    for (const listener of listeners) {
       try {
-        listener(normalized);
-      } catch {}
+        const result = listener(normalized);
+        if (result && typeof result.then === "function")
+          Promise.resolve(result).catch((failure) => warnListenerError("error" /* Error */, failure));
+      } catch (failure) {
+        warnListenerError("error" /* Error */, failure);
+      }
     }
   }
 }
+function warnListenerError(event, error) {
+  const failure = error instanceof Error ? error : new Error(String(error));
+  process.emitWarning(`A "${String(event)}" listener threw and no error listener handled it: ${failure.message}`, {
+    type: "LunibeeWarning",
+    code: "LUNIBEE_UNHANDLED_LISTENER_ERROR",
+    detail: failure.stack
+  });
+}
 
 class Client extends EventEmitter2 {
   options;
@@ -6449,16 +6589,16 @@ class Client extends EventEmitter2 {
     this.#resourceContext = {
       sendMessage: (channelId, options) => this.channels.send(channelId, options),
       editMessage: (channelId, messageId, options) => this.channels.editMessage(channelId, messageId, options),
-      deleteMessage: (channelId, messageId) => this.channels.deleteMessage(channelId, messageId),
+      deleteMessage: (channelId, messageId, reason) => this.channels.deleteMessage(channelId, messageId, reason),
       crosspostMessage: (channelId, messageId) => this.channels.crosspostMessage(channelId, messageId),
       editChannel: (channelId, options) => this.channels.edit(channelId, options),
-      deleteChannel: (channelId) => this.channels.deleteChannel(channelId),
+      deleteChannel: (channelId, reason) => this.channels.remove(channelId, reason),
       addReaction: (channelId, messageId, emoji) => this.channels.addReaction(channelId, messageId, emoji),
       removeOwnReaction: (channelId, messageId, emoji) => this.channels.removeOwnReaction(channelId, messageId, emoji),
       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),
+      pinMessage: (channelId, messageId, reason) => this.channels.pinMessage(channelId, messageId, reason),
+      unpinMessage: (channelId, messageId, reason) => this.channels.unpinMessage(channelId, messageId, reason),
       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),
@@ -7011,8 +7151,6 @@ class Client extends EventEmitter2 {
     const query = new URLSearchParams;
     if (options?.withCounts)
       query.set("with_counts", "true");
-    if (options?.withExpiration)
-      query.set("with_expiration", "true");
     if (options?.guildScheduledEventId)
       query.set("guild_scheduled_event_id", options.guildScheduledEventId);
     const qs = query.toString();
@@ -7156,7 +7294,7 @@ class HandlerRegistry {
 // packages/sharding/package.json
 var package_default2 = {
   name: "@lunibee/sharding",
-  version: "0.2.2",
+  version: "0.2.3",
   type: "module",
   module: "./src/index.ts",
   types: "./src/index.ts",
@@ -7369,12 +7507,12 @@ class ClusterManager {
     const clusterCount = this.#options.clusterCount ?? cpus().length;
     const chunks = Array.from({ length: clusterCount }, () => []);
     for (let i = 0;i < count; i++) {
-      chunks[i % clusterCount].push(i);
+      chunks[i % clusterCount]?.push(i);
     }
-    for (let i = 0;i < clusterCount; i++) {
-      if (chunks[i].length === 0)
+    for (const [i, chunk] of chunks.entries()) {
+      if (chunk.length === 0)
         continue;
-      this.#launch(i, chunks[i], count);
+      this.#launch(i, chunk, count);
       await sleep2(500);
     }
     if (this.#options.autoScaleInterval && this.#options.autoScaleInterval > 0) {
@@ -8224,9 +8362,10 @@ class VoiceReceiver {
     const controllers = this.#streams.get(userId);
     if (!controllers || controllers.size === 0)
       return;
-    const csrcCount = packet[0] & 15;
+    const first = view.getUint8(0);
+    const csrcCount = first & 15;
     let offset = 12 + csrcCount * 4;
-    const hasExtension = (packet[0] & 16) !== 0;
+    const hasExtension = (first & 16) !== 0;
     if (hasExtension) {
       if (packet.length < offset + 4)
         return;
@@ -9028,6 +9167,10 @@ var ApplicationCommandOptionEnum2 = {
   Number: 10,
   Attachment: 11
 };
+function validateContexts(contexts) {
+  if (contexts.some((context) => context !== 0 && context !== 1 && context !== 2))
+    throw new RangeError("Command contexts must be 0, 1 or 2.");
+}
 
 class CreateSlashCommand {
   #data = { type: 1 };
@@ -9041,6 +9184,11 @@ class CreateSlashCommand {
     this.#data.description = description;
     return this;
   }
+  setContexts(...contexts) {
+    validateContexts(contexts);
+    this.#data.contexts = [...contexts];
+    return this;
+  }
   setDMPermission(enabled) {
     this.#data.dm_permission = enabled;
     return this;
@@ -9400,8 +9548,7 @@ class CreateContextMenuCommand {
     return this;
   }
   setContexts(...contexts) {
-    if (contexts.some((context) => context !== 0 && context !== 1 && context !== 2))
-      throw new RangeError("Command contexts must be 0, 1 or 2.");
+    validateContexts(contexts);
     this.data.contexts = [...contexts];
     return this;
   }
@@ -9544,6 +9691,7 @@ export {
   CreateButton,
   CreateChannelOption,
   CreateChannelSelectMenu,
+  CreateCommandOption,
   CreateContainer,
   CreateContentInventoryEntry,
   CreateContextMenuCommand,
@@ -9646,6 +9794,7 @@ export {
   PremiumTier,
   REST,
   RESTError,
+  RESTErrorCode,
   RateLimiter,
   RedisRateLimitStore,
   RequestScheduler,
@@ -9761,4 +9910,4 @@ export {
   userMention
 };
 
-//# debugId=FC58C0F70BD3B2A964756E2164756E21
+//# debugId=97695754EB32311964756E2164756E21