lunibee 0.2.2 → 0.2.3

package/dist/core/index.d.ts

@@ -101,6 +101,7 @@ export declare class Client extends EventEmitter<ClientEvents> implements Intera
     /** Fetches an invite from Discord. */
     fetchInvite(code: string, options?: {
         withCounts?: boolean;
+        /** @deprecated No effect: Discord always returns `expires_at` and deprecated `with_expiration`. Removed in 0.3.0. */
         withExpiration?: boolean;
         guildScheduledEventId?: string;
     }): Promise<Record<string, unknown>>;

package/dist/core/index.js

@@ -1363,6 +1363,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) {
@@ -1464,12 +1469,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:*"
   }
 };
 
@@ -1544,6 +1552,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;
@@ -1552,12 +1564,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);
@@ -1866,6 +1880,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`,
@@ -1928,7 +1944,7 @@ function snowflake(value, field) {
 // 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",
@@ -2251,13 +2267,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)
@@ -2280,10 +2296,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);
@@ -2330,6 +2346,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)
@@ -2351,14 +2376,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)
@@ -2753,6 +2786,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;
@@ -2841,7 +2881,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;
@@ -2854,7 +2894,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;
@@ -2867,7 +2907,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;
@@ -2880,7 +2920,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;
@@ -2890,9 +2930,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;
   }
@@ -2904,7 +2944,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;
@@ -3208,16 +3248,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;
@@ -3229,10 +3272,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)
@@ -3256,11 +3300,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))
@@ -3377,10 +3422,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)
@@ -3427,15 +3472,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;
@@ -3614,15 +3659,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));
@@ -3826,11 +3878,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;
@@ -3869,7 +3926,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;
@@ -3879,15 +3936,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
@@ -3959,13 +4029,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 = {}) {
@@ -3996,13 +4068,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), {
@@ -4039,7 +4111,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 });
@@ -4157,12 +4229,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));
   }
@@ -4206,15 +4282,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 });
   }
 }
 // packages/managers/src/application.ts
@@ -4277,16 +4355,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) {
@@ -4356,15 +4434,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);
@@ -4400,8 +4483,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) {
@@ -4410,19 +4495,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);
   }
@@ -4465,14 +4548,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, reason) {
+    await this.#rest.put(Routes.channelMessagesPin(channelId, messageId), undefined, { reason });
   }
-  async pinMessage(channelId, messageId) {
-    await this.#rest.put(Routes.channelPin(channelId, messageId));
+  async unpinMessage(channelId, messageId, reason) {
+    await this.#rest.delete(Routes.channelMessagesPin(channelId, messageId), { reason });
   }
-  async unpinMessage(channelId, messageId) {
-    await this.#rest.delete(Routes.channelPin(channelId, messageId));
+  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);
@@ -4490,7 +4579,7 @@ class ChannelManager extends Manager {
       hasMore: messages.length === limit
     };
   }
-  async bulkDelete(channelId, messageIds) {
+  bulkDelete(channelId, messageIds) {
     return this.bulkDeleteMessages(channelId, messageIds);
   }
   clear() {
@@ -5633,18 +5722,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;
@@ -5713,16 +5815,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),
@@ -6275,8 +6377,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();
@@ -6324,4 +6424,4 @@ export {
   resolveGatewayIntents
 };
 
-//# debugId=A5606C420611230B64756E2164756E21
+//# debugId=A8C0111D9C7EBB3664756E2164756E21