lunibee 0.2.2 → 0.2.4

package/dist/index.js

@@ -114,60 +114,7 @@ var Permissions = {
   PinMessages: 1n << 51n,
   BypassSlowmode: 1n << 52n
 };
-var PermissionFlagsBits = {
-  CreateInstantInvite: 1n << 0n,
-  KickMembers: 1n << 1n,
-  BanMembers: 1n << 2n,
-  Administrator: 1n << 3n,
-  ManageChannels: 1n << 4n,
-  ManageGuild: 1n << 5n,
-  AddReactions: 1n << 6n,
-  ViewAuditLog: 1n << 7n,
-  PrioritySpeaker: 1n << 8n,
-  Stream: 1n << 9n,
-  ViewChannel: 1n << 10n,
-  SendMessages: 1n << 11n,
-  SendTTSMessages: 1n << 12n,
-  ManageMessages: 1n << 13n,
-  EmbedLinks: 1n << 14n,
-  AttachFiles: 1n << 15n,
-  ReadMessageHistory: 1n << 16n,
-  MentionEveryone: 1n << 17n,
-  UseExternalEmojis: 1n << 18n,
-  ViewGuildInsights: 1n << 19n,
-  Connect: 1n << 20n,
-  Speak: 1n << 21n,
-  MuteMembers: 1n << 22n,
-  DeafenMembers: 1n << 23n,
-  MoveMembers: 1n << 24n,
-  UseVAD: 1n << 25n,
-  ChangeNickname: 1n << 26n,
-  ManageNicknames: 1n << 27n,
-  ManageRoles: 1n << 28n,
-  ManageWebhooks: 1n << 29n,
-  ManageGuildExpressions: 1n << 30n,
-  UseApplicationCommands: 1n << 31n,
-  RequestToSpeak: 1n << 32n,
-  ManageEvents: 1n << 33n,
-  ManageThreads: 1n << 34n,
-  CreatePublicThreads: 1n << 35n,
-  CreatePrivateThreads: 1n << 36n,
-  UseExternalStickers: 1n << 37n,
-  SendMessagesInThreads: 1n << 38n,
-  UseEmbeddedActivities: 1n << 39n,
-  ModerateMembers: 1n << 40n,
-  ViewCreatorMonetizationAnalytics: 1n << 41n,
-  UseSoundboard: 1n << 42n,
-  CreateGuildExpressions: 1n << 43n,
-  CreateEvents: 1n << 44n,
-  UseExternalSounds: 1n << 45n,
-  SendVoiceMessages: 1n << 46n,
-  SetVoiceChannelStatus: 1n << 48n,
-  SendPolls: 1n << 49n,
-  UseExternalApps: 1n << 50n,
-  PinMessages: 1n << 51n,
-  BypassSlowmode: 1n << 52n
-};
+var PermissionFlagsBits = Permissions;
 
 class PermissionSet {
   bitfield;
@@ -468,6 +415,9 @@ function computePermissions(context) {
   const member = overwrites.find((o) => o.type === 1 /* Member */ && o.id === context.memberId);
   if (member)
     base = base & ~bits(member.deny) | bits(member.allow);
+  const until = context.timedOutUntil instanceof Date ? context.timedOutUntil.getTime() : context.timedOutUntil ?? 0;
+  if (until > Date.now())
+    base &= Permission.viewChannel | Permission.readMessageHistory;
   return new PermissionSet(base);
 }
 // packages/core/src/events.ts
@@ -742,28 +692,26 @@ var IntentBits = {
 };
 var Intents = IntentBits;
 function resolveGatewayIntents(intents) {
-  if (typeof intents === "number")
-    return intents;
-  if (intents && typeof intents === "object" && !Array.isArray(intents))
+  if (Array.isArray(intents))
+    return intents.reduce((acc, intent) => acc | resolveIntent(intent), 0);
+  if (typeof intents === "object")
     return intents.bitfield;
-  if (Array.isArray(intents)) {
-    return intents.reduce((acc, intent) => {
-      return acc | resolveGatewayIntents(intent);
-    }, 0);
-  }
-  if (typeof intents === "string") {
-    if (intents in GatewayIntentBits)
-      return GatewayIntentBits[intents];
-    if (intents in IntentBits)
-      return IntentBits[intents];
-    const lower = intents.charAt(0).toLowerCase() + intents.slice(1);
-    if (lower in IntentBits)
-      return IntentBits[lower];
-    const num = Number(intents);
-    if (!Number.isNaN(num))
-      return num;
-  }
-  return 0;
+  return resolveIntent(intents);
+}
+function resolveIntent(intent) {
+  if (typeof intent === "number")
+    return intent;
+  const bits = {
+    ...IntentBits,
+    ...GatewayIntentBits
+  };
+  const lower = intent.charAt(0).toLowerCase() + intent.slice(1);
+  if (Object.hasOwn(bits, intent))
+    return bits[intent];
+  if (Object.hasOwn(bits, lower))
+    return bits[lower];
+  const num = Number(intent);
+  return Number.isNaN(num) ? 0 : num;
 }
 
 class IntentsBitField {
@@ -830,6 +778,24 @@ var ChannelEnum = {
   GuildForum: 15,
   GuildMedia: 16
 };
+var ComponentEnum = {
+  ActionRow: 1,
+  Button: 2,
+  StringSelect: 3,
+  TextInput: 4,
+  UserSelect: 5,
+  RoleSelect: 6,
+  MentionableSelect: 7,
+  ChannelSelect: 8,
+  Section: 9,
+  TextDisplay: 10,
+  Thumbnail: 11,
+  MediaGallery: 12,
+  File: 13,
+  Separator: 14,
+  ContentInventoryEntry: 16,
+  Container: 17
+};
 var ButtonType = {
   Primary: 1,
   Secondary: 2,
@@ -904,64 +870,36 @@ var StickerType = StickerEnum;
 var StickerFormatType = StickerFormatEnum;
 // packages/collection/src/cache.ts
 class Cache {
-  #entries = new Collection;
-  #maxSize;
-  #ttl;
-  #timer;
+  #entries;
   constructor(options = {}) {
-    this.#maxSize = options.maxSize ?? Infinity;
-    this.#ttl = options.ttl ?? 0;
-    if (!Number.isInteger(this.#maxSize) && this.#maxSize !== Infinity || this.#maxSize < 1)
+    const maxSize = options.maxSize ?? Infinity;
+    const ttl = options.ttl ?? 0;
+    if (!Number.isInteger(maxSize) && maxSize !== Infinity || maxSize < 1)
       throw new RangeError("Cache maxSize must be a positive integer.");
-    if (!Number.isFinite(this.#ttl) || this.#ttl < 0)
+    if (!Number.isFinite(ttl) || ttl < 0)
       throw new RangeError("Cache ttl must be a non-negative finite number.");
-    if (this.#ttl > 0) {
-      const interval = options.sweepInterval ?? Math.min(this.#ttl, 60000);
+    if (ttl > 0) {
+      const interval = options.sweepInterval ?? Math.min(ttl, 60000);
       if (!Number.isFinite(interval) || interval < 1)
         throw new RangeError("Cache sweepInterval must be positive.");
-      this.#timer = setInterval(() => this.sweep(), interval);
-      this.#timer.unref?.();
     }
+    this.#entries = new Collection(null, {
+      ttl: ttl > 0 ? ttl : undefined,
+      maxSize: maxSize === Infinity ? undefined : maxSize,
+      slide: false
+    });
   }
   get size() {
-    this.#sweepExpired();
     return this.#entries.size;
   }
   get(key) {
-    const entry = this.#entries.get(key);
-    if (!entry)
-      return;
-    if (entry.expiresAt > 0 && entry.expiresAt <= Date.now()) {
-      this.#entries.delete(key);
-      return;
-    }
-    this.#entries.delete(key);
-    this.#entries.set(key, entry);
-    return entry.value;
+    return this.#entries.get(key);
   }
   has(key) {
-    const entry = this.#entries.get(key);
-    if (!entry)
-      return false;
-    if (entry.expiresAt > 0 && entry.expiresAt <= Date.now()) {
-      this.#entries.delete(key);
-      return false;
-    }
-    return true;
+    return this.#entries.has(key);
   }
   set(key, value) {
-    const expiresAt = this.#ttl > 0 ? Date.now() + this.#ttl : 0;
-    this.#entries.delete(key);
-    this.#entries.set(key, { value, expiresAt });
-    if (this.#maxSize !== Infinity) {
-      while (this.#entries.size > this.#maxSize) {
-        const oldest = this.#entries.firstKey();
-        if (oldest !== undefined)
-          this.#entries.delete(oldest);
-        else
-          break;
-      }
-    }
+    this.#entries.set(key, value);
     return this;
   }
   delete(key) {
@@ -971,95 +909,52 @@ class Cache {
     this.#entries.clear();
   }
   invalidate(predicate) {
-    return this.#entries.sweep((entry, key) => predicate(entry.value, key));
+    return this.#entries.sweep(predicate);
   }
   sweep() {
-    return this.#entries.sweep((entry) => this.#expired(entry));
-  }
-  dispose() {
-    if (this.#timer)
-      clearInterval(this.#timer);
-    this.#timer = undefined;
+    return this.#entries.purge();
   }
+  dispose() {}
   values() {
-    this.#sweepExpired();
-    return this.#entries.map((entry) => entry.value);
+    return [...this.#entries.values()];
   }
   entries() {
-    this.#sweepExpired();
-    return this.#entries.map((entry, key) => [key, entry.value]);
-  }
-  #expired(entry) {
-    return entry.expiresAt > 0 && entry.expiresAt <= Date.now();
-  }
-  #sweepExpired() {
-    if (this.#ttl > 0)
-      this.sweep();
+    return [...this.#entries.entries()];
   }
 }
 
 // packages/collection/src/index.ts
-class RecencyList {
-  #nodes = new Map;
-  #oldest;
-  #newest;
-  get size() {
-    return this.#nodes.size;
-  }
-  oldest() {
-    return this.#oldest?.key;
-  }
-  touch(key) {
-    const node = this.#nodes.get(key);
-    if (node)
-      return this.#moveNewest(node);
-    const created = { key, older: this.#newest };
-    if (this.#newest)
-      this.#newest.newer = created;
-    else
-      this.#oldest = created;
-    this.#newest = created;
-    this.#nodes.set(key, created);
-  }
-  promote(key) {
-    const node = this.#nodes.get(key);
-    if (node)
-      this.#moveNewest(node);
-  }
-  delete(key) {
-    const node = this.#nodes.get(key);
-    if (!node)
-      return false;
-    this.#unlink(node);
-    this.#nodes.delete(key);
-    return true;
-  }
-  clear() {
-    this.#nodes.clear();
-    this.#oldest = this.#newest = undefined;
-  }
-  #unlink(node) {
-    if (node.older)
-      node.older.newer = node.newer;
-    else
-      this.#oldest = node.newer;
-    if (node.newer)
-      node.newer.older = node.older;
-    else
-      this.#newest = node.older;
-    node.older = node.newer = undefined;
-  }
-  #moveNewest(node) {
-    if (node === this.#newest)
-      return;
-    this.#unlink(node);
-    node.older = this.#newest;
-    if (this.#newest)
-      this.#newest.newer = node;
-    else
-      this.#oldest = node;
-    this.#newest = node;
+function newPolicy(options = {}) {
+  return {
+    ttl: options.ttl,
+    maxSize: options.maxSize,
+    slide: options.slide ?? true,
+    onEvict: options.onEvict,
+    expired: 0,
+    evicted: 0,
+    entries: new Map,
+    oldest: undefined,
+    newest: undefined,
+    lruSize: 0,
+    heap: [],
+    armedFor: Infinity
+  };
+}
+function peekOf(collection, key) {
+  return collection instanceof Map ? Map.prototype.get.call(collection, key) : collection.get(key);
+}
+var mapGet = Map.prototype.get;
+var mapHas = Map.prototype.has;
+function sample(items, amount) {
+  if (!Number.isInteger(amount) || amount < 0)
+    throw new RangeError("amount must be a non-negative integer.");
+  const count = Math.min(amount, items.length);
+  for (let i = 0;i < count; i++) {
+    const j = i + Math.floor(Math.random() * (items.length - i));
+    [items[i], items[j]] = [items[j], items[i]];
   }
+  items.length = count;
+  return items;
 }
 function assertTTL(ttl) {
   if (ttl !== undefined && (!Number.isFinite(ttl) || ttl <= 0))
@@ -1067,81 +962,90 @@ function assertTTL(ttl) {
 }
 
 class Collection extends Map {
-  #ttl;
-  #maxSize;
-  #onEvict;
-  #expiry = new Map;
-  #lru = new RecencyList;
-  #stats = {
-    hits: 0,
-    misses: 0,
-    expired: 0,
-    evicted: 0
-  };
-  #heap = [];
-  #timer;
-  #armedFor = Infinity;
+  #policy;
+  #hits = 0;
+  #misses = 0;
   constructor(entries, options = {}) {
     super();
     assertTTL(options.ttl);
     if (options.maxSize !== undefined && (!Number.isInteger(options.maxSize) || options.maxSize <= 0))
       throw new RangeError("maxSize must be a positive integer.");
-    this.#ttl = options.ttl;
-    this.#maxSize = options.maxSize;
-    this.#onEvict = options.onEvict;
+    if (options.ttl !== undefined || options.maxSize !== undefined || options.slide !== undefined || options.onEvict !== undefined)
+      this.#policy = newPolicy(options);
     if (entries)
       for (const [key, value] of entries)
         this.set(key, value);
   }
   set(key, value, ttl) {
+    if (ttl === undefined && this.#policy === undefined)
+      return super.set(key, value);
     assertTTL(ttl);
-    const window = ttl ?? this.#ttl;
-    if (this.#maxSize !== undefined) {
-      this.#lru.touch(key);
-    }
-    super.set(key, value);
+    const window = ttl ?? this.#policy?.ttl;
     if (window !== undefined)
-      this.#schedule(key, window);
-    else if (this.#expiry.size > 0)
-      this.#expiry.delete(key);
+      this.#policy ??= newPolicy();
+    if (!this.#policy)
+      return super.set(key, value);
+    const before = super.size;
+    super.set(key, value);
+    this.#track(key, value, window, super.size !== before);
     this.#enforceCap();
     return this;
   }
   setWithoutTTL(key, value) {
-    if (this.#expiry.size > 0)
-      this.#expiry.delete(key);
-    if (this.#lru.size > 0)
-      this.#lru.delete(key);
+    if (this.#policy)
+      this.#forget(key);
     super.set(key, value);
     return this;
   }
   get(key) {
-    if (this.#expireIfDue(key)) {
-      this.#stats.misses++;
+    const policy = this.#policy;
+    const entry = policy?.entries.get(key);
+    if (entry === undefined) {
+      const value = mapGet.call(this, key);
+      if (value !== undefined || mapHas.call(this, key)) {
+        this.#hits++;
+        return value;
+      }
+      this.#misses++;
       return;
     }
-    const value = super.get(key);
-    if (value === undefined && !super.has(key)) {
-      this.#stats.misses++;
+    const timed = entry.window !== 0;
+    const now = timed ? Date.now() : 0;
+    if (timed && entry.deadline <= now) {
+      this.#expire(entry);
+      this.#misses++;
       return;
     }
-    this.#stats.hits++;
-    const expiry = this.#expiry.get(key);
-    if (expiry)
-      expiry.deadline = Date.now() + expiry.window;
-    this.#lru.promote(key);
-    return value;
+    this.#hits++;
+    if (timed && policy.slide)
+      entry.deadline = now + entry.window;
+    if (entry.inLru)
+      this.#promote(policy, entry);
+    return entry.value;
+  }
+  ensure(key, factory, ttl) {
+    const existing = this.get(key);
+    if (existing !== undefined || super.has(key))
+      return existing;
+    const created = factory(key, this);
+    this.set(key, created, ttl);
+    return created;
   }
   peek(key) {
     if (!this.#expireIfDue(key) && super.has(key)) {
-      this.#stats.hits++;
+      this.#hits++;
       return super.get(key);
     }
-    this.#stats.misses++;
+    this.#misses++;
     return;
   }
   get stats() {
-    return { ...this.#stats };
+    return {
+      hits: this.#hits,
+      misses: this.#misses,
+      expired: this.#policy?.expired ?? 0,
+      evicted: this.#policy?.evicted ?? 0
+    };
   }
   has(key) {
     return !this.#expireIfDue(key) && super.has(key);
@@ -1149,19 +1053,23 @@ class Collection extends Map {
   delete(key) {
     if (this.#expireIfDue(key))
       return false;
-    this.#expiry.delete(key);
-    this.#lru.delete(key);
+    if (this.#policy)
+      this.#forget(key);
     return super.delete(key);
   }
   clear() {
     super.clear();
-    this.#expiry.clear();
-    this.#lru.clear();
-    this.#heap.length = 0;
-    if (this.#timer)
-      clearTimeout(this.#timer);
-    this.#timer = undefined;
-    this.#armedFor = Infinity;
+    const policy = this.#policy;
+    if (!policy)
+      return;
+    policy.entries.clear();
+    policy.oldest = policy.newest = undefined;
+    policy.lruSize = 0;
+    policy.heap.length = 0;
+    if (policy.timer)
+      clearTimeout(policy.timer);
+    policy.timer = undefined;
+    policy.armedFor = Infinity;
   }
   get size() {
     this.purge();
@@ -1189,11 +1097,11 @@ class Collection extends Map {
   ttlRemaining(key) {
     if (this.#expireIfDue(key))
       return;
-    const expiry = this.#expiry.get(key);
-    return expiry && Math.max(0, expiry.deadline - Date.now());
+    const entry = this.#policy?.entries.get(key);
+    return entry && entry.window !== 0 ? Math.max(0, entry.deadline - Date.now()) : undefined;
   }
   purge() {
-    if (this.#expiry.size === 0)
+    if (!this.#policy || this.#policy.heap.length === 0)
       return 0;
     const now = Date.now();
     let removed = 0;
@@ -1204,133 +1112,255 @@ class Collection extends Map {
       this.#remove(due.key);
       removed++;
     }
-    this.#stats.expired += removed;
+    this.#policy.expired += removed;
     this.#rearm();
     for (const [key, value] of dropped)
       this.#notify(key, value, "expired");
     return removed;
   }
   #expireIfDue(key) {
-    const expiry = this.#expiry.get(key);
-    if (!expiry || expiry.deadline > Date.now())
+    const entry = this.#policy?.entries.get(key);
+    if (!entry || entry.window === 0 || entry.deadline > Date.now())
       return false;
-    const value = super.get(key);
-    this.#remove(key);
-    this.#stats.expired++;
-    this.#notify(key, value, "expired");
+    this.#expire(entry);
     return true;
   }
+  #expire(entry) {
+    const value = super.get(entry.key);
+    this.#remove(entry.key);
+    this.#policy.expired++;
+    this.#notify(entry.key, value, "expired");
+  }
   #remove(key) {
-    this.#expiry.delete(key);
-    this.#lru.delete(key);
+    this.#forget(key);
     super.delete(key);
   }
+  #forget(key) {
+    const policy = this.#policy;
+    const entry = policy.entries.get(key);
+    if (!entry)
+      return;
+    if (entry.inLru)
+      this.#unlink(policy, entry);
+    policy.entries.delete(key);
+  }
+  #track(key, value, window, isNew) {
+    const policy = this.#policy;
+    const lru = policy.maxSize !== undefined;
+    let entry = isNew ? undefined : policy.entries.get(key);
+    if (entry)
+      entry.value = value;
+    if (window === undefined) {
+      if (entry && entry.window !== 0) {
+        if (lru)
+          entry = this.#replace(policy, entry, 0, 0);
+        else {
+          this.#forget(key);
+          return;
+        }
+      }
+      if (!entry && lru) {
+        entry = this.#create(key, value, 0, 0);
+        policy.entries.set(key, entry);
+      }
+      if (entry)
+        this.#promote(policy, entry);
+      return;
+    }
+    const deadline = Date.now() + window;
+    if (entry && entry.window !== 0) {
+      entry.deadline = deadline;
+      entry.window = window;
+      if (deadline < entry.filed)
+        entry = this.#replace(policy, entry, window, deadline);
+      else {
+        if (entry.inLru)
+          this.#promote(policy, entry);
+        return;
+      }
+    } else if (entry) {
+      entry.window = window;
+      entry.deadline = entry.filed = deadline;
+    } else {
+      entry = this.#create(key, value, window, deadline);
+      policy.entries.set(key, entry);
+    }
+    if (lru)
+      this.#promote(policy, entry);
+    this.#heapPush(entry);
+    if (policy.heap.length > 2 * policy.entries.size + 8)
+      this.#compact();
+    if (policy.timer === undefined || deadline < policy.armedFor)
+      this.#rearm();
+  }
+  #create(key, value, window, deadline) {
+    return {
+      key,
+      value,
+      older: undefined,
+      newer: undefined,
+      inLru: false,
+      window,
+      deadline,
+      filed: deadline
+    };
+  }
+  #replace(policy, old, window, deadline) {
+    const entry = {
+      ...old,
+      window,
+      deadline,
+      filed: deadline
+    };
+    if (old.inLru) {
+      if (old.older)
+        old.older.newer = entry;
+      else
+        policy.oldest = entry;
+      if (old.newer)
+        old.newer.older = entry;
+      else
+        policy.newest = entry;
+    }
+    policy.entries.set(old.key, entry);
+    return entry;
+  }
+  #promote(policy, entry) {
+    if (entry === policy.newest)
+      return;
+    if (entry.inLru)
+      this.#unlink(policy, entry, true);
+    else {
+      entry.inLru = true;
+      policy.lruSize++;
+    }
+    entry.older = policy.newest;
+    entry.newer = undefined;
+    if (policy.newest)
+      policy.newest.newer = entry;
+    else
+      policy.oldest = entry;
+    policy.newest = entry;
+  }
+  #unlink(policy, entry, keepCount = false) {
+    if (entry.older)
+      entry.older.newer = entry.newer;
+    else
+      policy.oldest = entry.newer;
+    if (entry.newer)
+      entry.newer.older = entry.older;
+    else
+      policy.newest = entry.older;
+    entry.older = entry.newer = undefined;
+    if (!keepCount) {
+      entry.inLru = false;
+      policy.lruSize--;
+    }
+  }
+  #derived() {
+    const Species = this.constructor[Symbol.species] ?? Collection;
+    return new Species;
+  }
   #notify(key, value, reason) {
-    if (!this.#onEvict)
+    const onEvict = this.#policy?.onEvict;
+    if (!onEvict)
       return;
     try {
-      this.#onEvict(key, value, reason);
+      onEvict(key, value, reason);
     } catch {}
   }
   #enforceCap() {
-    if (this.#maxSize === undefined)
+    const policy = this.#policy;
+    const max = policy.maxSize;
+    if (max === undefined)
       return;
-    while (this.#lru.size > this.#maxSize) {
-      const oldest = this.#lru.oldest();
-      const value = super.get(oldest);
-      this.#remove(oldest);
-      this.#stats.evicted++;
-      this.#notify(oldest, value, "evicted");
+    if (policy.lruSize > max && policy.heap.length > 0 && policy.heap[0].filed <= Date.now())
+      this.purge();
+    while (policy.lruSize > max) {
+      const oldest = policy.oldest;
+      const value = policy.onEvict ? super.get(oldest.key) : undefined;
+      this.#unlink(policy, oldest);
+      policy.entries.delete(oldest.key);
+      super.delete(oldest.key);
+      policy.evicted++;
+      this.#notify(oldest.key, value, "evicted");
     }
   }
-  #schedule(key, window) {
-    const deadline = Date.now() + window;
-    const expiry = this.#expiry.get(key);
-    if (expiry) {
-      expiry.deadline = deadline;
-      expiry.window = window;
-      if (deadline >= expiry.filed)
-        return;
-      expiry.filed = deadline;
-    } else
-      this.#expiry.set(key, { deadline, window, filed: deadline });
-    this.#heapPush({ key, deadline });
-    if (this.#heap.length > 2 * this.#expiry.size + 8)
-      this.#compact();
-    this.#rearm();
-  }
   #nextDeadline() {
+    const policy = this.#policy;
     for (;; ) {
-      const top = this.#heap[0];
+      const top = policy.heap[0];
       if (top === undefined)
         return Infinity;
-      const expiry = this.#expiry.get(top.key);
-      if (!expiry || expiry.filed !== top.deadline) {
+      if (policy.entries.get(top.key) !== top) {
         this.#heapPop();
         continue;
       }
-      if (expiry.deadline === top.deadline)
-        return top.deadline;
+      if (top.deadline === top.filed)
+        return top.filed;
       this.#heapPop();
-      expiry.filed = expiry.deadline;
-      this.#heapPush({ key: top.key, deadline: expiry.deadline });
+      top.filed = top.deadline;
+      this.#heapPush(top);
     }
   }
   #compact() {
-    const live = this.#heap.filter((record) => this.#expiry.get(record.key)?.filed === record.deadline);
-    this.#heap.length = 0;
-    for (const record of live)
-      this.#heapPush(record);
+    const policy = this.#policy;
+    const live = policy.heap.filter((entry) => policy.entries.get(entry.key) === entry);
+    policy.heap.length = 0;
+    for (const entry of live)
+      this.#heapPush(entry);
   }
   #rearm() {
+    const p = this.#policy;
     const deadline = this.#nextDeadline();
-    if (this.#timer !== undefined && deadline >= this.#armedFor)
+    if (p.timer !== undefined && deadline >= p.armedFor)
       return;
-    if (this.#timer)
-      clearTimeout(this.#timer);
-    this.#timer = undefined;
-    this.#armedFor = deadline;
+    if (p.timer)
+      clearTimeout(p.timer);
+    p.timer = undefined;
+    p.armedFor = deadline;
     if (deadline === Infinity)
       return;
-    this.#timer = setTimeout(() => {
-      this.#timer = undefined;
-      this.#armedFor = Infinity;
+    p.timer = setTimeout(() => {
+      p.timer = undefined;
+      p.armedFor = Infinity;
       this.purge();
     }, Math.max(0, deadline - Date.now()));
-    this.#timer.unref?.();
+    p.timer.unref?.();
   }
-  #heapPush(record) {
-    const heap = this.#heap;
-    heap.push(record);
-    let i = heap.length - 1;
+  #heapPush(entry) {
+    const heap = this.#policy.heap;
+    let i = heap.length;
+    heap.push(entry);
     while (i > 0) {
       const parent = i - 1 >> 1;
-      if (heap[parent].deadline <= heap[i].deadline)
+      const above = heap[parent];
+      if (above.filed <= entry.filed)
         break;
-      [heap[parent], heap[i]] = [heap[i], heap[parent]];
+      heap[i] = above;
       i = parent;
     }
+    heap[i] = entry;
   }
   #heapPop() {
-    const heap = this.#heap;
+    const heap = this.#policy.heap;
     const top = heap[0];
     const last = heap.pop();
     if (top === undefined || heap.length === 0)
       return top;
-    heap[0] = last;
-    for (let i = 0;; ) {
-      const left = 2 * i + 1;
-      const right = left + 1;
-      let smallest = i;
-      if (left < heap.length && heap[left].deadline < heap[smallest].deadline)
-        smallest = left;
-      if (right < heap.length && heap[right].deadline < heap[smallest].deadline)
-        smallest = right;
-      if (smallest === i)
+    let i = 0;
+    for (;; ) {
+      let child = 2 * i + 1;
+      if (child >= heap.length)
         break;
-      [heap[smallest], heap[i]] = [heap[i], heap[smallest]];
-      i = smallest;
+      if (child + 1 < heap.length && heap[child + 1].filed < heap[child].filed)
+        child++;
+      if (heap[child].filed >= last.filed)
+        break;
+      heap[i] = heap[child];
+      i = child;
     }
+    heap[i] = last;
     return top;
   }
   first() {
@@ -1362,8 +1392,26 @@ class Collection extends Map {
     }
     return;
   }
+  findLast(predicate) {
+    const entries = [...this];
+    for (let i = entries.length - 1;i >= 0; i--) {
+      const [key, value] = entries[i];
+      if (predicate(value, key, this))
+        return value;
+    }
+    return;
+  }
+  findLastKey(predicate) {
+    const entries = [...this];
+    for (let i = entries.length - 1;i >= 0; i--) {
+      const [key, value] = entries[i];
+      if (predicate(value, key, this))
+        return key;
+    }
+    return;
+  }
   filter(predicate) {
-    const result = new Collection;
+    const result = this.#derived();
     for (const [key, value] of this) {
       if (predicate(value, key, this))
         result.set(key, value);
@@ -1407,7 +1455,7 @@ class Collection extends Map {
     return [...this.entries()];
   }
   clone() {
-    const copy = new Collection;
+    const copy = this.#derived();
     for (const [key, value] of this)
       copy.set(key, value);
     return copy;
@@ -1462,7 +1510,7 @@ class Collection extends Map {
     return result;
   }
   intersection(other) {
-    const result = new Collection;
+    const result = this.#derived();
     for (const [key, value] of this) {
       if (other.has(key))
         result.set(key, value);
@@ -1470,7 +1518,7 @@ class Collection extends Map {
     return result;
   }
   difference(other) {
-    const result = new Collection;
+    const result = this.#derived();
     for (const [key, value] of this) {
       if (!other.has(key))
         result.set(key, value);
@@ -1478,8 +1526,8 @@ class Collection extends Map {
     return result;
   }
   partition(predicate) {
-    const pass = new Collection;
-    const fail = new Collection;
+    const pass = this.#derived();
+    const fail = this.#derived();
     for (const [key, value] of this) {
       if (predicate(value, key, this))
         pass.set(key, value);
@@ -1488,6 +1536,81 @@ class Collection extends Map {
     }
     return [pass, fail];
   }
+  symmetricDifference(other) {
+    const result = this.#derived();
+    for (const [key, value] of this)
+      if (!other.has(key))
+        result.set(key, value);
+    for (const [key, value] of other)
+      if (!this.has(key))
+        result.set(key, value);
+    return result;
+  }
+  concat(...collections) {
+    const result = this.clone();
+    for (const collection of collections)
+      for (const [key, value] of collection)
+        result.set(key, value);
+    return result;
+  }
+  merge(other, whenInSelf, whenInOther, whenInBoth) {
+    const result = this.#derived();
+    const decide = (key, kept) => {
+      if (kept.keep)
+        result.set(key, kept.value);
+    };
+    for (const [key, value] of this) {
+      decide(key, other.has(key) ? whenInBoth(value, peekOf(other, key), key) : whenInSelf(value, key));
+    }
+    for (const [key, value] of other)
+      if (!this.has(key))
+        decide(key, whenInOther(value, key));
+    return result;
+  }
+  equals(other) {
+    if (!other)
+      return false;
+    if (other === this)
+      return true;
+    if (this.size !== other.size)
+      return false;
+    for (const [key, value] of this) {
+      if (!other.has(key))
+        return false;
+      if (value !== peekOf(other, key))
+        return false;
+    }
+    return true;
+  }
+  mapValues(transform) {
+    const result = this.#derived();
+    for (const [key, value] of this)
+      result.set(key, transform(value, key, this));
+    return result;
+  }
+  toReversed() {
+    const result = this.#derived();
+    const entries = [...this];
+    for (let i = entries.length - 1;i >= 0; i--)
+      result.set(entries[i][0], entries[i][1]);
+    return result;
+  }
+  toSorted(comparator) {
+    return this.sorted(comparator);
+  }
+  static groupBy(items, keySelector) {
+    const groups = new Collection;
+    let index = 0;
+    for (const item of items)
+      groups.ensure(keySelector(item, index++), () => []).push(item);
+    return groups;
+  }
+  static combineEntries(entries, combine) {
+    const result = new Collection;
+    for (const [key, value] of entries)
+      result.set(key, result.has(key) ? combine(result.get(key), value, key) : value);
+    return result;
+  }
   tap(fn) {
     fn(this);
     return this;
@@ -1506,6 +1629,13 @@ class Collection extends Map {
       acc = fn(acc, value, key, this);
     return acc;
   }
+  reduceRight(fn, initialValue) {
+    const entries = [...this];
+    let acc = initialValue;
+    for (let i = entries.length - 1;i >= 0; i--)
+      acc = fn(acc, entries[i][1], entries[i][0], this);
+    return acc;
+  }
   sorted(comparator) {
     const decorated = [...this.entries()].map((entry, index) => ({
       entry,
@@ -1516,22 +1646,34 @@ class Collection extends Map {
         const comparison = comparator(x.entry[1], y.entry[1], x.entry[0], y.entry[0]);
         return comparison !== 0 ? comparison : x.index - y.index;
       });
-    const result = new Collection;
+    const result = this.#derived();
     for (const { entry } of decorated)
       result.set(entry[0], entry[1]);
     return result;
   }
-  random() {
-    const arr = [...this.values()];
-    if (!arr.length)
+  random(amount) {
+    if (amount !== undefined)
+      return sample([...this.values()], amount);
+    const size = this.size;
+    if (size === 0)
       return;
-    return arr[Math.floor(Math.random() * arr.length)];
+    let index = Math.floor(Math.random() * size);
+    for (const value of this.values())
+      if (index-- === 0)
+        return value;
+    return;
   }
-  randomKey() {
-    const arr = [...this.keys()];
-    if (!arr.length)
+  randomKey(amount) {
+    if (amount !== undefined)
+      return sample([...this.keys()], amount);
+    const size = this.size;
+    if (size === 0)
       return;
-    return arr[Math.floor(Math.random() * arr.length)];
+    let index = Math.floor(Math.random() * size);
+    for (const key of this.keys())
+      if (index-- === 0)
+        return key;
+    return;
   }
   at(index) {
     const arr = [...this.values()];
@@ -1549,6 +1691,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 +1797,15 @@ class ResourceManager extends Manager {
 // packages/rest/package.json
 var package_default = {
   name: "@lunibee/rest",
-  version: "0.2.2",
+  version: "0.2.4",
   type: "module",
   module: "./src/index.ts",
   types: "./src/index.ts",
   exports: {
     ".": "./src/index.ts"
+  },
+  dependencies: {
+    "@lunibee/types": "workspace:*"
   }
 };
 
@@ -1728,8 +1878,12 @@ function kindFromStatus(status) {
   return "client";
 }
 function redactPath(path) {
-  return path.replace(/^(\/webhooks\/[^/?]+\/)[^/?]+/, "$1:token").replace(/^(\/interactions\/[^/?]+\/)[^/?]+/, "$1:token");
+  return path.replace(/^(\/webhooks\/[^/?]+\/)[^/?]+/i, "$1:token").replace(/^(\/interactions\/[^/?]+\/)[^/?]+/i, "$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 +1892,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);
@@ -1781,19 +1937,23 @@ async function abortable(promise, signal, path) {
 }
 
 // packages/rest/src/route.ts
+import { createHash } from "crypto";
 function normalizeRoutePath(path) {
   const queryIndex = path.indexOf("?");
   const routePath = queryIndex === -1 ? path : path.slice(0, queryIndex);
-  return routePath.replace(/\/\d+(?=\/|$)/g, "/:id");
+  return redactPath(routePath).replace(/\/\d+(?=\/|$)/g, "/:id");
 }
 function majorParameter(path) {
-  const match = /^\/(channels|guilds|webhooks)\/(\d+)(?:\/([^/?]+))?/.exec(path);
+  const match = /^\/(channels|guilds|webhooks)\/(\d+)(?:\/([^/?]+))?/i.exec(path);
   if (!match)
     return "@none";
-  if (match[1] === "webhooks" && match[3] !== undefined)
-    return `${match[2]}:${match[3]}`;
+  if (match[1].toLowerCase() === "webhooks" && match[3] !== undefined)
+    return `${match[2]}:${tokenDigest(match[3])}`;
   return match[2];
 }
+function tokenDigest(token) {
+  return createHash("sha256").update(token).digest("hex").slice(0, 16);
+}
 function scopeBucket(hashOrRoute, major) {
   return `${hashOrRoute}|${major}`;
 }
@@ -2035,6 +2195,9 @@ var Routes = {
   user: () => "/users/@me",
   userById: (userId) => `/users/${snowflake(userId, "User ID")}`,
   guild: (guildId) => `/guilds/${snowflake(guildId, "Guild ID")}`,
+  currentUserGuild: (guildId) => `/users/@me/guilds/${snowflake(guildId, "Guild ID")}`,
+  sticker: (stickerId) => `/stickers/${snowflake(stickerId, "Sticker ID")}`,
+  messageReactionUser: (channelId, messageId, emoji, userId) => `${Routes.messageReactions(channelId, messageId, emoji)}/${snowflake(userId, "User ID")}`,
   guildPreview: (guildId) => `/guilds/${snowflake(guildId, "Guild ID")}/preview`,
   guildActiveThreads: (guildId) => `/guilds/${snowflake(guildId, "Guild ID")}/threads/active`,
   guildWebhooks: (guildId) => `/guilds/${snowflake(guildId, "Guild ID")}/webhooks`,
@@ -2052,6 +2215,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 +2275,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])
@@ -2256,7 +2459,7 @@ class WebhookClient {
   #rest;
   constructor(options, restOptions) {
     if (options.url) {
-      const match = options.url.match(/discord(?:app)?.com\/api\/webhooks\/(\d+)\/([A-Za-z0-9_-]+)/);
+      const match = options.url.match(/^https:\/\/(?:(?:ptb|canary)\.)?discord(?:app)?\.com\/api(?:\/v\d+)?\/webhooks\/(\d{1,20})\/([A-Za-z0-9_-]+)\/?(?:[?#].*)?$/);
       if (!match)
         throw new Error("Invalid Discord webhook URL format.");
       this.id = match[1];
@@ -2271,13 +2474,20 @@ class WebhookClient {
   }
   async send(options) {
     const payload = typeof options === "string" ? { content: options } : options;
-    const { thread_id, ...body } = payload;
-    const query = thread_id ? `?thread_id=${thread_id}&wait=true` : `?wait=true`;
+    const { thread_id, files, ...body } = payload;
+    const params = new URLSearchParams({ wait: "true" });
+    if (thread_id)
+      params.set("thread_id", String(thread_id));
+    const query = `?${params}`;
     const formattedEmbeds = body.embeds?.map((e) => ("toJSON" in e) ? e.toJSON() : e);
-    return this.#rest.post(`${Routes.webhook(this.id, this.token)}${query}`, {
+    const formattedComponents = body.components?.map((c) => ("toJSON" in c) ? c.toJSON() : c);
+    const path = `${Routes.webhook(this.id, this.token)}${query}`;
+    const json = {
       ...body,
-      embeds: formattedEmbeds
-    });
+      embeds: formattedEmbeds,
+      components: formattedComponents
+    };
+    return files?.length ? this.#rest.postWithFiles(path, json, files) : this.#rest.post(path, json);
   }
   async editMessage(messageId, options) {
     const payload = typeof options === "string" ? { content: options } : options;
@@ -2291,7 +2501,23 @@ 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})`;
+function assertSafePath(path) {
+  const end = path.search(/[?#]/);
+  const pathname = end === -1 ? path : path.slice(0, end);
+  if (pathname.includes("\\"))
+    throw new TypeError("REST paths must not contain backslashes.");
+  for (const segment of pathname.split("/")) {
+    let decoded;
+    try {
+      decoded = decodeURIComponent(segment);
+    } catch {
+      throw new TypeError("REST path has malformed percent-encoding.");
+    }
+    if (decoded === "." || decoded === "..")
+      throw new TypeError("REST paths must not contain '.' or '..' segments.");
+  }
+}
 var REQUEST_DATA_KEYS = new Set([
   "body",
   "files",
@@ -2376,6 +2602,7 @@ class REST {
       throw new TypeError("REST method is required.");
     if (!path.startsWith("/"))
       throw new TypeError("REST paths must start with '/'.");
+    assertSafePath(path);
     const route = createRouteKey(method, path);
     const files = options.files;
     if (files && files.length > 0 && !(body instanceof FormData))
@@ -2463,13 +2690,19 @@ class REST {
   #headers(body, options) {
     const isFormData = typeof FormData !== "undefined" && body instanceof FormData;
     const headers = { ...options.headers };
+    const set = (name, value) => {
+      for (const key of Object.keys(headers))
+        if (key.toLowerCase() === name.toLowerCase())
+          delete headers[key];
+      headers[name] = value;
+    };
     if (options.auth !== false && this.#token)
-      headers["Authorization"] = `Bot ${this.#token}`;
-    headers["User-Agent"] = USER_AGENT;
+      set("Authorization", `Bot ${this.#token}`);
+    set("User-Agent", USER_AGENT);
     if (options.reason !== undefined)
-      headers["X-Audit-Log-Reason"] = encodeURIComponent(options.reason);
+      set("X-Audit-Log-Reason", encodeURIComponent(options.reason));
     if (!isFormData)
-      headers["Content-Type"] = "application/json";
+      set("Content-Type", "application/json");
     return headers;
   }
   #encodeBody(body) {
@@ -2545,7 +2778,7 @@ function cdnURL(path, hash, options = {}) {
   const isAnimated = hash.startsWith("a_") && !options.forceStatic;
   const ext = options.extension ?? (isAnimated ? "gif" : "png");
   const size = options.size ? `?size=${options.size}` : "";
-  return `${CDN_BASE}${path}/${hash}.${ext}${size}`;
+  return `${CDN_BASE}${path}/${encodeURIComponent(hash)}.${ext}${size}`;
 }
 
 class User extends BaseStructure {
@@ -2614,13 +2847,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 +2876,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 +2926,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 +2956,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)
@@ -2818,10 +3068,10 @@ class GuildMember {
   get permissions() {
     if (this.#suppliedPermissions)
       return this.#suppliedPermissions;
-    return new PermissionsBitField(this.#context?.memberPermissions?.(this.guildId, this.user.id, this.roleIds) ?? 0n);
+    return new PermissionsBitField(this.#context?.memberPermissions?.(this.guildId, this.user.id, this.roleIds, undefined, this.timedOutUntil) ?? 0n);
   }
   permissionsIn(channelId) {
-    const computed = this.#context?.memberPermissions?.(this.guildId, this.user.id, this.roleIds, channelId);
+    const computed = this.#context?.memberPermissions?.(this.guildId, this.user.id, this.roleIds, channelId, this.timedOutUntil);
     return computed ? new PermissionsBitField(computed) : null;
   }
   #action(name) {
@@ -3257,6 +3507,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 +3602,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 +3615,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 +3628,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 +3641,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 +3651,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 +3665,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 +3969,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 +3993,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 +4021,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 +4310,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 +4360,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;
@@ -4260,7 +4522,7 @@ class UserManager extends ResourceManager {
     return this.upsert(new User(data));
   }
   async leaveGuild(guildId) {
-    await this.#rest.delete(`/users/@me/guilds/${guildId}`);
+    await this.#rest.delete(Routes.currentUserGuild(guildId));
   }
   async createDM(userId) {
     return this.#rest.post("/users/@me/channels", {
@@ -4285,15 +4547,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 +4766,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;
@@ -4537,28 +4811,43 @@ class RoleManager extends ResourceManager {
   }
   async create(options) {
     const { reason, ...payload } = options;
-    const data = await this.#rest.post(Routes.guildRoles(this.guildId), {
-      ...payload,
-      permissions: payload.permissions !== undefined ? String(payload.permissions) : undefined
-    });
-    const role = new Role(data);
-    this.set(role.id, role);
-    return role;
+    const data = await this.#rest.post(Routes.guildRoles(this.guildId), rolePayload(payload), { reason });
+    return this.#store(data);
   }
   async edit(roleId, options) {
     const { reason, ...payload } = options;
-    const data = await this.#rest.patch(Routes.guildRole(this.guildId, roleId), {
-      ...payload,
-      permissions: payload.permissions !== undefined ? String(payload.permissions) : undefined
-    });
+    const data = await this.#rest.patch(Routes.guildRole(this.guildId, roleId), rolePayload(payload), { reason });
+    return this.#store(data);
+  }
+  #store(data) {
     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);
+  }
+}
+function rolePayload(options) {
+  const { permissions, ...rest } = options;
+  return {
+    ...rest,
+    permissions: permissions !== undefined ? String(permissions) : undefined
+  };
 }
 
 // packages/managers/src/guild-resources.ts
@@ -4630,13 +4919,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 +4958,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 +5001,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 +5119,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 +5172,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 +5298,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 +5377,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 +5426,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 +5438,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);
   }
@@ -5183,20 +5485,26 @@ class ChannelManager extends Manager {
     await this.#rest.delete(`${Routes.messageReactions(channelId, messageId, emoji)}/@me`);
   }
   async removeReaction(channelId, messageId, emoji, userId) {
-    await this.#rest.delete(`${Routes.messageReactions(channelId, messageId, emoji)}/${userId}`);
+    await this.#rest.delete(Routes.messageReactionUser(channelId, messageId, emoji, userId));
   }
   async removeAllReactions(channelId, messageId) {
     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 +5522,7 @@ class ChannelManager extends Manager {
       hasMore: messages.length === limit
     };
   }
-  async bulkDelete(channelId, messageIds) {
+  bulkDelete(channelId, messageIds) {
     return this.bulkDeleteMessages(channelId, messageIds);
   }
   clear() {
@@ -5300,7 +5608,26 @@ class GatewaySession {
     return resume ? { type: "resume", ...resume } : { type: "identify" };
   }
   connectURL(fallback) {
-    return this.resumeInfo()?.resumeURL ?? fallback;
+    const resume = this.resumeInfo()?.resumeURL;
+    return resume !== undefined && isTrustedGatewayURL(resume, fallback) ? resume : fallback;
+  }
+}
+function isTrustedGatewayURL(url, fallback) {
+  let parsed;
+  try {
+    parsed = new URL(url);
+  } catch {
+    return false;
+  }
+  if (parsed.protocol !== "wss:" || parsed.username || parsed.password)
+    return false;
+  const host = parsed.hostname.toLowerCase();
+  if (host === "discord.gg" || host.endsWith(".discord.gg"))
+    return true;
+  try {
+    return host === new URL(fallback).hostname.toLowerCase();
+  } catch {
+    return false;
   }
 }
 
@@ -5576,12 +5903,15 @@ class PlainTextDecoder {
 
 class ZlibStreamDecoder {
   #create;
+  #maxFrameBytes;
   #inflate;
   #chunks = [];
+  #size = 0;
   #failure;
   #pendingReject;
-  constructor(create = () => createInflate()) {
+  constructor(create = () => createInflate(), maxFrameBytes = 64 * 1024 * 1024) {
     this.#create = create;
+    this.#maxFrameBytes = maxFrameBytes;
   }
   push(data) {
     if (typeof data === "string")
@@ -5600,6 +5930,7 @@ class ZlibStreamDecoder {
     await this.#awaiting((settle) => inflate.flush(zlibConstants.Z_SYNC_FLUSH, () => settle()));
     const parts = this.#chunks;
     this.#chunks = [];
+    this.#size = 0;
     if (parts.length === 0)
       return [];
     const total = parts.reduce((size, part) => size + part.length, 0);
@@ -5615,6 +5946,7 @@ class ZlibStreamDecoder {
     const inflate = this.#inflate;
     this.#inflate = undefined;
     this.#chunks = [];
+    this.#size = 0;
     this.#failure = undefined;
     this.#pendingReject = undefined;
     if (!inflate)
@@ -5642,7 +5974,17 @@ class ZlibStreamDecoder {
   }
   #open() {
     const inflate = this.#create();
-    inflate.on("data", (chunk) => this.#chunks.push(chunk));
+    inflate.on("data", (chunk) => {
+      if (this.#failure)
+        return;
+      this.#size += chunk.length;
+      if (this.#size > this.#maxFrameBytes) {
+        this.#chunks = [];
+        inflate.emit("error", new Error(`Gateway frame inflated past ${this.#maxFrameBytes} bytes.`));
+        return;
+      }
+      this.#chunks.push(chunk);
+    });
     inflate.on("error", (error) => {
       this.#failure = error;
       const reject = this.#pendingReject;
@@ -5885,9 +6227,9 @@ function classifyPayload(payload) {
 }
 function identifyPayload(options) {
   const props = options.properties ?? {};
-  const os = props.os ?? "Android";
-  const browser = props.browser ?? "Discord Android";
-  const device = props.device ?? "Discord Android";
+  const os = props.os ?? process.platform;
+  const browser = props.browser ?? "Lunibee";
+  const device = props.device ?? "Lunibee";
   return {
     op: GatewayOpcodes.Identify,
     d: {
@@ -6004,9 +6346,9 @@ class Gateway {
       heartbeatAckTimeout: 1e4,
       zombieTimeout: 30000,
       properties: {
-        os: "Android",
-        browser: "Discord Android",
-        device: "Discord Android"
+        os: process.platform,
+        browser: "Lunibee",
+        device: "Lunibee"
       },
       presence: {
         status: "online",
@@ -6322,14 +6664,12 @@ class Gateway {
 
 // packages/core/src/index.ts
 class EventEmitter2 {
-  #listeners = new Map;
+  #listeners = {};
+  redactSecrets = (text) => text;
   on(event, listener) {
     if (typeof listener !== "function")
       throw new TypeError("Event listener must be a function.");
-    let listeners = this.#listeners.get(event);
-    if (!listeners)
-      this.#listeners.set(event, listeners = new Set);
-    listeners.add(listener);
+    (this.#listeners[event] ??= new Set).add(listener);
     return this;
   }
   once(event, listener) {
@@ -6340,7 +6680,7 @@ class EventEmitter2 {
     return this.on(event, wrapped);
   }
   off(event, listener) {
-    this.#listeners.get(event)?.delete(listener);
+    this.#listeners[event]?.delete(listener);
     return this;
   }
   removeListener(event, listener) {
@@ -6348,13 +6688,13 @@ class EventEmitter2 {
   }
   removeAllListeners(event) {
     if (event === undefined)
-      this.#listeners.clear();
+      this.#listeners = {};
     else
-      this.#listeners.delete(event);
+      delete this.#listeners[event];
     return this;
   }
   emit(event, ...args) {
-    const listeners = this.#listeners.get(event);
+    const listeners = this.#listeners[event];
     if (!listeners?.size)
       return false;
     for (const listener of [...listeners]) {
@@ -6369,18 +6709,30 @@ 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 [
-      ...this.#listeners.get("error" /* Error */) ?? []
-    ]) {
+    const errorListeners = this.#listeners["error" /* Error */];
+    const listeners = event === "error" /* Error */ ? [] : [...errorListeners ?? []];
+    if (listeners.length === 0)
+      return warnListenerError(event, normalized, this.redactSecrets);
+    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, this.redactSecrets));
+      } catch (failure) {
+        warnListenerError("error" /* Error */, failure, this.redactSecrets);
+      }
     }
   }
 }
+function warnListenerError(event, error, redact = (text) => text) {
+  const failure = error instanceof Error ? error : new Error(String(error));
+  process.emitWarning(redact(`A "${String(event)}" listener threw and no error listener handled it: ${failure.message}`), {
+    type: "LunibeeWarning",
+    code: "LUNIBEE_UNHANDLED_LISTENER_ERROR",
+    detail: failure.stack === undefined ? undefined : redact(failure.stack)
+  });
+}
 
 class Client extends EventEmitter2 {
   options;
@@ -6400,6 +6752,10 @@ class Client extends EventEmitter2 {
   user;
   readyAt;
   state = "idle";
+  redactSecrets = (text) => {
+    const token = this.options.token;
+    return token && token.length >= 8 ? text.split(token).join("[token]") : text;
+  };
   get token() {
     return this.state === "destroyed" ? null : this.options.token ?? null;
   }
@@ -6446,21 +6802,36 @@ class Client extends EventEmitter2 {
     this.stageInstances = new StageInstanceManager(this.rest);
     const placeholderAppCommands = new ApplicationCommandManager(this.rest, "0");
     this.application = { commands: placeholderAppCommands };
-    this.#resourceContext = {
+    this.#resourceContext = this.#createResourceContext();
+    this.guilds.attachContext(this.#resourceContext);
+    this.#gateway = new Gateway({
+      token: options.token,
+      intents: options.intents,
+      ...options.gateway
+    });
+    this.#wireLifecycle();
+    this.#wireMessages();
+    this.#wireGuilds();
+    this.#wireGuildFeatures();
+    this.#wireChannels();
+    this.#wireMisc();
+  }
+  #createResourceContext() {
+    return {
       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),
+      memberPermissions: (guildId, memberId, roleIds, channelId, timedOutUntil) => this.#memberPermissions(guildId, memberId, roleIds, channelId, timedOutUntil),
       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),
@@ -6483,12 +6854,8 @@ class Client extends EventEmitter2 {
         return this.channels.permissionOverwrites(channelId).update(targetId, bits, options);
       }
     };
-    this.guilds.attachContext(this.#resourceContext);
-    this.#gateway = new Gateway({
-      token: options.token,
-      intents: options.intents,
-      ...options.gateway
-    });
+  }
+  #wireLifecycle() {
     this.#gateway.on("READY", (data) => {
       const ready = data;
       this.user = ready.user;
@@ -6514,6 +6881,8 @@ class Client extends EventEmitter2 {
         this.state = "idle";
       this.emit("close" /* Close */, data);
     });
+  }
+  #wireMessages() {
     this.#gateway.on("MESSAGE_CREATE", (data) => {
       const payload = data;
       const message = new Message(payload, this.#resourceContext);
@@ -6561,6 +6930,8 @@ class Client extends EventEmitter2 {
     this.#gateway.on("MESSAGE_REACTION_REMOVE_EMOJI", (data) => this.emit("messageReactionRemoveEmoji" /* MessageReactionRemoveEmoji */, data));
     this.#gateway.on("MESSAGE_POLL_VOTE_ADD", (data) => this.emit("messagePollVoteAdd" /* MessagePollVoteAdd */, data));
     this.#gateway.on("MESSAGE_POLL_VOTE_REMOVE", (data) => this.emit("messagePollVoteRemove" /* MessagePollVoteRemove */, data));
+  }
+  #wireGuilds() {
     this.#gateway.on("GUILD_CREATE", (data) => {
       const payload = data;
       if (payload.unavailable) {
@@ -6661,6 +7032,8 @@ class Client extends EventEmitter2 {
       roles.delete(event.role_id);
       this.emit("guildRoleDelete" /* GuildRoleDelete */, event, removed);
     });
+  }
+  #wireGuildFeatures() {
     this.#gateway.on("GUILD_EMOJIS_UPDATE", (data) => {
       const event = data;
       let previous = null;
@@ -6757,6 +7130,8 @@ class Client extends EventEmitter2 {
       this.emit("autoModerationRuleDelete" /* AutoModerationRuleDelete */, rule);
     });
     this.#gateway.on("AUTO_MODERATION_ACTION_EXECUTION", (data) => this.emit("autoModerationActionExecution" /* AutoModerationActionExecution */, data));
+  }
+  #wireChannels() {
     this.#gateway.on("CHANNEL_CREATE", (data) => {
       const channel = this.channels.upsert(data);
       this.emit("channelCreate" /* ChannelCreate */, channel);
@@ -6824,6 +7199,8 @@ class Client extends EventEmitter2 {
       this.emit("inviteDelete" /* InviteDelete */, invite);
     });
     this.#gateway.on("WEBHOOKS_UPDATE", (data) => this.emit("webhooksUpdate" /* WebhooksUpdate */, data));
+  }
+  #wireMisc() {
     this.#gateway.on("VOICE_STATE_UPDATE", (data) => {
       const state = data;
       if (state.guild_id)
@@ -6899,7 +7276,7 @@ class Client extends EventEmitter2 {
   get resourceContext() {
     return this.#resourceContext;
   }
-  #memberPermissions(guildId, memberId, roleIds, channelId) {
+  #memberPermissions(guildId, memberId, roleIds, channelId, timedOutUntil) {
     const guild = this.guilds.get(guildId);
     if (!guild)
       return null;
@@ -6916,7 +7293,8 @@ class Client extends EventEmitter2 {
       memberId,
       memberRoleIds: [...roleIds],
       roles: this.guilds.roles(guildId).values(),
-      overwrites: channel?.permissionOverwrites
+      overwrites: channel?.permissionOverwrites,
+      timedOutUntil
     });
   }
   permissionsFor(memberId, guildOrChannelId) {
@@ -6937,7 +7315,8 @@ class Client extends EventEmitter2 {
       memberId,
       memberRoleIds: member.roleIds,
       roles: this.guilds.roles(guildId).values(),
-      overwrites: channel?.permissionOverwrites
+      overwrites: channel?.permissionOverwrites,
+      timedOutUntil: member.timedOutUntil
     });
   }
   fetchDefaultSoundboardSounds() {
@@ -6985,10 +7364,10 @@ class Client extends EventEmitter2 {
       return Promise.reject(new Error("Client is unauthenticated."));
     return this.rest.delete(Routes.interactionOriginalResponse(this.user.id, token));
   }
-  followUpInteraction(token, data) {
+  async followUpInteraction(token, data) {
     if (!this.user)
       return Promise.reject(new Error("Client is unauthenticated."));
-    return this.rest.post(`/webhooks/${this.user.id}/${token}`, toRequest(data, this.options.allowedMentions));
+    return this.rest.post(Routes.webhook(this.user.id, token), toRequest(data, this.options.allowedMentions));
   }
   interactionWebhookMessage(method, applicationId, token, messageId, data) {
     const path = messageId === "@original" ? Routes.interactionOriginalResponse(applicationId, token) : Routes.webhookMessage(applicationId, token, messageId);
@@ -6998,11 +7377,11 @@ class Client extends EventEmitter2 {
       return this.rest.patch(path, data ? toRequest(data, this.options.allowedMentions) : data);
     return this.rest.delete(path);
   }
-  fetchWebhook(id, token) {
-    return this.rest.get(token ? `/webhooks/${id}/${token}` : `/webhooks/${id}`);
+  async fetchWebhook(id, token) {
+    return this.rest.get(Routes.webhook(id, token));
   }
-  fetchGuildPreview(guildId) {
-    return this.rest.get(`/guilds/${guildId}/preview`);
+  async fetchGuildPreview(guildId) {
+    return this.rest.get(Routes.guildPreview(guildId));
   }
   fetchVoiceRegions() {
     return this.rest.get("/voice/regions");
@@ -7011,15 +7390,13 @@ 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();
     return this.rest.get(`/invites/${encodeURIComponent(code)}${qs ? `?${qs}` : ""}`);
   }
-  fetchSticker(id) {
-    return this.rest.get(`/stickers/${id}`);
+  async fetchSticker(id) {
+    return this.rest.get(Routes.sticker(id));
   }
   fetchPremiumStickerPacks() {
     return this.rest.get(`/sticker-packs`);
@@ -7079,13 +7456,17 @@ function inlineCode(text) {
   return `\`${text}\``;
 }
 function codeBlock(text, language = "") {
-  return `\`\`\`${language}
-${text}
+  const safe = text.replace(/```/g, "`\u200B``");
+  const lang = language.replace(/[^\w+#.-]/g, "");
+  return `\`\`\`${lang}
+${safe}
 \`\`\``;
 }
 function link(label, url, title) {
-  const titlePart = title ? ` "${title}"` : "";
-  return `[${label}](${url}${titlePart})`;
+  const text = label.replace(/[[\]\\]/g, "\\$&").replace(/\n/g, " ");
+  const target = url.replace(/[()\s"]/g, (c) => `%${c.charCodeAt(0).toString(16).toUpperCase().padStart(2, "0")}`);
+  const titlePart = title ? ` "${title.replace(/["\n]/g, "")}"` : "";
+  return `[${text}](${target}${titlePart})`;
 }
 function blockQuote(text) {
   return text.split(`
@@ -7124,14 +7505,9 @@ function validateSnowflake(id, field) {
 }
 // packages/handlers/src/index.ts
 class HandlerRegistry {
-  #handlers = new Map;
+  #handlers = {};
   on(event, handler) {
-    let handlers = this.#handlers.get(event);
-    if (!handlers) {
-      handlers = new Set;
-      this.#handlers.set(event, handlers);
-    }
-    handlers.add(handler);
+    (this.#handlers[event] ??= new Set).add(handler);
     return this;
   }
   once(event, handler) {
@@ -7142,11 +7518,11 @@ class HandlerRegistry {
     return this.on(event, wrapped);
   }
   off(event, handler) {
-    this.#handlers.get(event)?.delete(handler);
+    this.#handlers[event]?.delete(handler);
     return this;
   }
   async dispatch(event, ...args) {
-    for (const handler of this.#handlers.get(event) ?? [])
+    for (const handler of this.#handlers[event] ?? [])
       await handler(...args);
   }
   emit(event, ...args) {
@@ -7156,7 +7532,7 @@ class HandlerRegistry {
 // packages/sharding/package.json
 var package_default2 = {
   name: "@lunibee/sharding",
-  version: "0.2.2",
+  version: "0.2.4",
   type: "module",
   module: "./src/index.ts",
   types: "./src/index.ts",
@@ -7369,12 +7745,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) {
@@ -7901,6 +8277,9 @@ var SpeakingFlags = {
   Soundshare: 2,
   Priority: 4
 };
+function listenerSet(sets, event) {
+  return sets[event] ??= new Set;
+}
 
 class VoiceConnection {
   state = "disconnected" /* Disconnected */;
@@ -7910,7 +8289,7 @@ class VoiceConnection {
   selfDeaf;
   gateway;
   udp;
-  #listeners = new Map;
+  #listeners = {};
   receiver;
   constructor(options) {
     const resolved = typeof options === "string" ? { guildId: options } : options;
@@ -7926,14 +8305,11 @@ class VoiceConnection {
   on(event, listener) {
     if (typeof listener !== "function")
       throw new TypeError("Voice listener must be a function.");
-    let listeners = this.#listeners.get(event);
-    if (!listeners)
-      this.#listeners.set(event, listeners = new Set);
-    listeners.add(listener);
+    listenerSet(this.#listeners, event).add(listener);
     return this;
   }
   off(event, listener) {
-    this.#listeners.get(event)?.delete(listener);
+    this.#listeners[event]?.delete(listener);
     return this;
   }
   attachTransports(gateway, udp) {
@@ -7976,7 +8352,7 @@ class VoiceConnection {
     this.receiver.close();
     this.channelId = undefined;
     this.#transition("destroyed" /* Destroyed */);
-    this.#listeners.clear();
+    this.#listeners = {};
   }
   setChannel(channelId) {
     this.assertUsable();
@@ -8027,7 +8403,7 @@ class VoiceConnection {
     this.state = next;
     if (previous === next)
       return;
-    for (const listener of this.#listeners.get("stateChange") ?? []) {
+    for (const listener of this.#listeners.stateChange ?? []) {
       try {
         listener(next, previous);
       } catch (error) {
@@ -8040,7 +8416,7 @@ class VoiceConnection {
     }
   }
   #emit(event, ...args) {
-    for (const listener of this.#listeners.get(event) ?? []) {
+    for (const listener of this.#listeners[event] ?? []) {
       try {
         listener(...args);
       } catch {}
@@ -8067,7 +8443,7 @@ class AudioPlayer {
   #stream;
   #reader;
   #resumeSignal;
-  #listeners = new Map;
+  #playerListeners = {};
   get state() {
     return this.#state;
   }
@@ -8112,15 +8488,11 @@ class AudioPlayer {
     }
   }
   on(event, listener) {
-    let set = this.#listeners.get(event);
-    if (!set) {
-      this.#listeners.set(event, set = new Set);
-    }
-    set.add(listener);
+    listenerSet(this.#playerListeners, event).add(listener);
     return this;
   }
   off(event, listener) {
-    this.#listeners.get(event)?.delete(listener);
+    this.#playerListeners[event]?.delete(listener);
     return this;
   }
   onChunk(chunk) {}
@@ -8162,7 +8534,7 @@ class AudioPlayer {
     this.#emit("error", err instanceof Error ? err : new VoiceError(String(err)));
   }
   #emit(event, ...args) {
-    for (const listener of this.#listeners.get(event) ?? []) {
+    for (const listener of this.#playerListeners[event] ?? []) {
       try {
         listener(...args);
       } catch {}
@@ -8224,9 +8596,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;
@@ -8423,24 +8796,6 @@ function url(value, field) {
 }
 var EmbedBuilder = CreateEmbed;
 // packages/builders/src/components.ts
-var ComponentEnum = {
-  ActionRow: 1,
-  Button: 2,
-  StringSelect: 3,
-  TextInput: 4,
-  UserSelect: 5,
-  RoleSelect: 6,
-  MentionableSelect: 7,
-  ChannelSelect: 8,
-  Section: 9,
-  TextDisplay: 10,
-  Thumbnail: 11,
-  MediaGallery: 12,
-  File: 13,
-  Separator: 14,
-  ContentInventoryEntry: 16,
-  Container: 17
-};
 var TextInputType = { Short: 1, Paragraph: 2 };
 
 class CreateActionRow {
@@ -8468,38 +8823,50 @@ class CreateActionRow {
   }
 }
 
-class CreateStringSelect {
-  #data = {
-    type: ComponentEnum.StringSelect
-  };
+class CreateSelectMenu {
+  #select;
+  constructor(data) {
+    this.#select = data;
+  }
   setCustomId(value) {
     validateText(value, 100, "Component custom ID");
-    this.#data.custom_id = value;
+    this.#select.custom_id = value;
     return this;
   }
   setPlaceholder(value) {
     validateText(value, 150, "Component placeholder");
-    this.#data.placeholder = value;
+    this.#select.placeholder = value;
     return this;
   }
   setMinValues(value) {
     validateCount(value, "min_values", 0);
-    this.#data.min_values = value;
+    this.#select.min_values = value;
     return this;
   }
   setMaxValues(value) {
     validateCount(value, "max_values", 1);
-    this.#data.max_values = value;
+    this.#select.max_values = value;
     return this;
   }
   setRequired(value = true) {
-    this.#data.required = value;
+    this.#select.required = value;
     return this;
   }
   setDisabled(value = true) {
-    this.#data.disabled = value;
+    this.#select.disabled = value;
     return this;
   }
+}
+
+class CreateStringSelect extends CreateSelectMenu {
+  #data;
+  constructor() {
+    const data = {
+      type: ComponentEnum.StringSelect
+    };
+    super(data);
+    this.#data = data;
+  }
   addOptions(...options) {
     if (!options.length)
       throw new TypeError("At least one select option is required.");
@@ -8615,40 +8982,14 @@ class CreateButton {
   }
 }
 
-class CreateEntitySelect {
+class CreateEntitySelect extends CreateSelectMenu {
   #data;
   constructor(type) {
     if (type !== ComponentEnum.UserSelect && type !== ComponentEnum.RoleSelect && type !== ComponentEnum.MentionableSelect && type !== ComponentEnum.ChannelSelect)
       throw new TypeError("Invalid select component type.");
-    this.#data = { type };
-  }
-  setCustomId(value) {
-    validateText(value, 100, "Component custom ID");
-    this.#data.custom_id = value;
-    return this;
-  }
-  setPlaceholder(value) {
-    validateText(value, 150, "Component placeholder");
-    this.#data.placeholder = value;
-    return this;
-  }
-  setMinValues(value) {
-    validateCount(value, "min_values", 0);
-    this.#data.min_values = value;
-    return this;
-  }
-  setMaxValues(value) {
-    validateCount(value, "max_values", 1);
-    this.#data.max_values = value;
-    return this;
-  }
-  setRequired(value = true) {
-    this.#data.required = value;
-    return this;
-  }
-  setDisabled(value = true) {
-    this.#data.disabled = value;
-    return this;
+    const data = { type };
+    super(data);
+    this.#data = data;
   }
   setDefaultValues(...values) {
     this.#data.default_values = values.map((value) => ({ ...value }));
@@ -9028,6 +9369,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 +9386,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;
@@ -9097,16 +9447,7 @@ class CreateSlashCommand {
     return structuredClone(this.#data);
   }
   addOption(option) {
-    const options = this.#data.options ?? [];
-    if (options.length >= 25)
-      throw new RangeError("An application command cannot contain more than 25 options.");
-    const payload = option.toJSON();
-    if (options.some((existing) => existing.name === payload.name))
-      throw new RangeError(`Duplicate option name: ${String(payload.name)}.`);
-    if (payload.required === true && options.some((existing) => existing.required !== true))
-      throw new RangeError("Required application command options must be placed before optional options.");
-    options.push(payload);
-    this.#data.options = options;
+    this.#data.options = appendOption(this.#data.options, option.toJSON(), "application command");
     return this;
   }
 }
@@ -9144,21 +9485,9 @@ class CreateStringOption extends CreateCommandOption {
     super(ApplicationCommandOptionEnum2.String);
   }
   addChoices(...choices) {
-    const current = this.data.choices ?? [];
-    if (!choices.length)
-      throw new TypeError("At least one choice is required.");
-    if (this.data.autocomplete === true)
-      throw new RangeError("Autocomplete options cannot define choices.");
-    if (current.length + choices.length > 25)
-      throw new RangeError("An option cannot contain more than 25 choices.");
-    for (const choice of choices) {
-      validateText2(choice.name, "Choice name", 100);
+    for (const choice of choices)
       validateText2(choice.value, "Choice value", 100);
-    }
-    this.data.choices = [
-      ...current,
-      ...choices.map((choice) => ({ ...choice }))
-    ];
+    appendChoices(this.data, choices);
     return this;
   }
   setMinLength(value) {
@@ -9175,18 +9504,21 @@ class CreateStringOption extends CreateCommandOption {
   }
 }
 
-class CreateIntegerOption extends CreateCommandOption {
-  constructor() {
-    super(ApplicationCommandOptionEnum2.Integer);
+class CreateNumericOption extends CreateCommandOption {
+  #integer;
+  constructor(type, integer) {
+    super(type);
+    this.#integer = integer;
   }
   setMinValue(value) {
-    validateNumberRange(value, -9007199254740991, 9007199254740991, "min_value", true);
+    validateNumberRange(value, -MAX_SAFE, MAX_SAFE, "min_value", this.#integer);
     this.data.min_value = value;
     return this;
   }
   setMaxValue(value) {
-    validateNumberRange(value, -9007199254740991, 9007199254740991, "max_value", true);
-    if (this.data.min_value !== undefined && this.data.min_value > value)
+    validateNumberRange(value, -MAX_SAFE, MAX_SAFE, "max_value", this.#integer);
+    const min = this.data.min_value;
+    if (min !== undefined && min > value)
       throw new RangeError("min_value cannot exceed max_value.");
     this.data.max_value = value;
     return this;
@@ -9198,50 +9530,20 @@ class CreateIntegerOption extends CreateCommandOption {
     return this;
   }
   addChoices(...choices) {
-    const current = this.data.choices ?? [];
-    if (!choices.length)
-      throw new TypeError("At least one choice is required.");
-    if (this.data.autocomplete === true)
-      throw new RangeError("Autocomplete options cannot define choices.");
-    if (current.length + choices.length > 25)
-      throw new RangeError("An option cannot contain more than 25 choices.");
-    this.data.choices = [...current, ...choices];
+    appendChoices(this.data, choices);
     return this;
   }
 }
 
-class CreateNumberOption extends CreateCommandOption {
+class CreateIntegerOption extends CreateNumericOption {
   constructor() {
-    super(ApplicationCommandOptionEnum2.Number);
+    super(ApplicationCommandOptionEnum2.Integer, true);
   }
-  setMinValue(value) {
-    validateNumberRange(value, -9007199254740991, 9007199254740991, "min_value", false);
-    this.data.min_value = value;
-    return this;
-  }
-  setMaxValue(value) {
-    validateNumberRange(value, -9007199254740991, 9007199254740991, "max_value", false);
-    if (this.data.min_value !== undefined && this.data.min_value > value)
-      throw new RangeError("min_value cannot exceed max_value.");
-    this.data.max_value = value;
-    return this;
-  }
-  setAutocomplete(enabled = true) {
-    if (enabled && Array.isArray(this.data.choices) && this.data.choices.length)
-      throw new RangeError("Autocomplete options cannot define choices.");
-    this.data.autocomplete = enabled;
-    return this;
-  }
-  addChoices(...choices) {
-    const current = this.data.choices ?? [];
-    if (!choices.length)
-      throw new TypeError("At least one choice is required.");
-    if (this.data.autocomplete === true)
-      throw new RangeError("Autocomplete options cannot define choices.");
-    if (current.length + choices.length > 25)
-      throw new RangeError("An option cannot contain more than 25 choices.");
-    this.data.choices = [...current, ...choices];
-    return this;
+}
+
+class CreateNumberOption extends CreateNumericOption {
+  constructor() {
+    super(ApplicationCommandOptionEnum2.Number, false);
   }
 }
 
@@ -9320,17 +9622,9 @@ class CreateSubcommand extends CreateCommandOption {
   }
   addChildOption(option) {
     const options = this.data.options ?? [];
-    if (options.length >= 25)
-      throw new RangeError("A subcommand cannot contain more than 25 options.");
-    const payload = option.toJSON();
-    if (options.some((existing) => existing.name === payload.name))
-      throw new RangeError(`Duplicate option name: ${String(payload.name)}.`);
-    if (payload.required === true && options.some((existing) => existing.required !== true))
-      throw new RangeError("Required subcommand options must be placed before optional options.");
     if (options.some((existing) => existing.type === ApplicationCommandOptionEnum2.Subcommand))
       throw new RangeError("Subcommands cannot contain nested subcommands.");
-    options.push(payload);
-    this.data.options = options;
+    this.data.options = appendOption(options, option.toJSON(), "subcommand");
     return this;
   }
 }
@@ -9353,6 +9647,29 @@ class CreateSubcommandGroup extends CreateCommandOption {
     return this;
   }
 }
+var MAX_SAFE = Number.MAX_SAFE_INTEGER;
+function appendOption(options, payload, parent) {
+  const list = options ?? [];
+  if (list.length >= 25)
+    throw new RangeError(`${parent === "subcommand" ? "A subcommand" : "An application command"} cannot contain more than 25 options.`);
+  if (list.some((existing) => existing.name === payload.name))
+    throw new RangeError(`Duplicate option name: ${String(payload.name)}.`);
+  if (payload.required === true && list.some((existing) => existing.required !== true))
+    throw new RangeError(`Required ${parent} options must be placed before optional options.`);
+  return [...list, payload];
+}
+function appendChoices(data, choices) {
+  const current = data.choices ?? [];
+  if (!choices.length)
+    throw new TypeError("At least one choice is required.");
+  if (data.autocomplete === true)
+    throw new RangeError("Autocomplete options cannot define choices.");
+  if (current.length + choices.length > 25)
+    throw new RangeError("An option cannot contain more than 25 choices.");
+  for (const choice of choices)
+    validateText2(choice.name, "Choice name", 100);
+  data.choices = [...current, ...choices.map((choice) => ({ ...choice }))];
+}
 function validateName(value, field) {
   if (!/^[\p{L}\p{N}_-]{1,32}$/u.test(value) || value !== value.toLowerCase())
     throw new RangeError(`${field} must contain 1-32 lowercase letters, numbers, underscores, or hyphens.`);
@@ -9400,8 +9717,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;
   }
@@ -9442,13 +9758,14 @@ var SubcommandGroupBuilder = CreateSubcommandGroup;
 var UserCommandBuilder = CreateUserCommand;
 var UserOptionBuilder = CreateUserOption;
 // packages/builders/src/attachment.ts
-import { readFile } from "fs/promises";
-import { basename } from "path";
+import { readFile, realpath } from "fs/promises";
+import { basename, isAbsolute, relative, resolve } from "path";
 
 class CreateAttachment {
   name;
   description;
   file;
+  root;
   constructor(file, data) {
     this.file = file;
     if (typeof data === "string") {
@@ -9456,6 +9773,7 @@ class CreateAttachment {
     } else {
       this.name = data?.name ?? (typeof file === "string" ? basename(file) : "file.bin");
       this.description = data?.description;
+      this.root = data?.root;
     }
   }
   setName(name) {
@@ -9472,7 +9790,8 @@ class CreateAttachment {
   }
   async toBuffer() {
     if (typeof this.file === "string") {
-      const buffer = await readFile(this.file);
+      const path = this.root === undefined ? this.file : await insideRoot(this.root, this.file);
+      const buffer = await readFile(path);
       return new Uint8Array(buffer);
     }
     if (this.file instanceof Uint8Array)
@@ -9490,6 +9809,16 @@ class CreateAttachment {
   }
 }
 var AttachmentBuilder = CreateAttachment;
+async function insideRoot(root, file) {
+  const base = await realpath(root);
+  const target = await realpath(resolve(base, file)).catch(() => {
+    throw new Error("Attachment file was not found inside its root.");
+  });
+  const rel = relative(base, target);
+  if (rel === "" || rel.startsWith("..") || isAbsolute(rel))
+    throw new Error("Attachment file is outside its root folder.");
+  return target;
+}
 export {
   ActionRowBuilder,
   ActivityEnum,
@@ -9544,6 +9873,7 @@ export {
   CreateButton,
   CreateChannelOption,
   CreateChannelSelectMenu,
+  CreateCommandOption,
   CreateContainer,
   CreateContentInventoryEntry,
   CreateContextMenuCommand,
@@ -9646,6 +9976,7 @@ export {
   PremiumTier,
   REST,
   RESTError,
+  RESTErrorCode,
   RateLimiter,
   RedisRateLimitStore,
   RequestScheduler,
@@ -9761,4 +10092,4 @@ export {
   userMention
 };
 
-//# debugId=FC58C0F70BD3B2A964756E2164756E21
+//# debugId=4ECD86428171907F64756E2164756E21