lunibee 0.2.3 → 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;
+      if (child + 1 < heap.length && heap[child + 1].filed < heap[child].filed)
+        child++;
+      if (heap[child].filed >= last.filed)
         break;
-      [heap[smallest], heap[i]] = [heap[i], heap[smallest]];
-      i = smallest;
+      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()];
@@ -1655,7 +1797,7 @@ class ResourceManager extends Manager {
 // packages/rest/package.json
 var package_default = {
   name: "@lunibee/rest",
-  version: "0.2.3",
+  version: "0.2.4",
   type: "module",
   module: "./src/index.ts",
   types: "./src/index.ts",
@@ -1736,7 +1878,7 @@ 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.",
@@ -1795,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}`;
 }
@@ -2049,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`,
@@ -2310,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];
@@ -2325,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;
@@ -2346,6 +2502,22 @@ class WebhookClient {
 var LIBRARY_VERSION = package_default.version;
 var LIBRARY_URL = "https://github.com/Ekretos/lunibee";
 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",
@@ -2430,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))
@@ -2517,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) {
@@ -2599,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 {
@@ -2889,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) {
@@ -4343,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", {
@@ -4632,20 +4811,15 @@ 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
-    }, { reason });
-    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
-    }, { reason });
+    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;
@@ -4668,6 +4842,13 @@ class RoleManager extends ResourceManager {
     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
 function withQuery2(path, params) {
@@ -5304,7 +5485,7 @@ 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));
@@ -5427,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;
   }
 }
 
@@ -5703,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")
@@ -5727,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);
@@ -5742,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)
@@ -5769,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;
@@ -6012,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: {
@@ -6131,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",
@@ -6449,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) {
@@ -6467,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) {
@@ -6475,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]) {
@@ -6497,28 +6710,27 @@ class EventEmitter2 {
   }
   #handleError(event, error) {
     const normalized = error instanceof Error ? error : new Error(String(error), { cause: error });
-    const listeners = event === "error" /* Error */ ? [] : [
-      ...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);
+      return warnListenerError(event, normalized, this.redactSecrets);
     for (const listener of listeners) {
       try {
         const result = listener(normalized);
         if (result && typeof result.then === "function")
-          Promise.resolve(result).catch((failure) => warnListenerError("error" /* Error */, failure));
+          Promise.resolve(result).catch((failure) => warnListenerError("error" /* Error */, failure, this.redactSecrets));
       } catch (failure) {
-        warnListenerError("error" /* Error */, failure);
+        warnListenerError("error" /* Error */, failure, this.redactSecrets);
       }
     }
   }
 }
-function warnListenerError(event, error) {
+function warnListenerError(event, error, redact = (text) => text) {
   const failure = error instanceof Error ? error : new Error(String(error));
-  process.emitWarning(`A "${String(event)}" listener threw and no error listener handled it: ${failure.message}`, {
+  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
+    detail: failure.stack === undefined ? undefined : redact(failure.stack)
   });
 }
 
@@ -6540,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;
   }
@@ -6586,7 +6802,22 @@ 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, reason) => this.channels.deleteMessage(channelId, messageId, reason),
@@ -6600,7 +6831,7 @@ class Client extends EventEmitter2 {
       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),
@@ -6623,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;
@@ -6654,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);
@@ -6701,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) {
@@ -6801,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;
@@ -6897,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);
@@ -6964,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)
@@ -7039,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;
@@ -7056,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) {
@@ -7077,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() {
@@ -7125,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);
@@ -7138,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");
@@ -7156,8 +7395,8 @@ class Client extends EventEmitter2 {
     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`);
@@ -7217,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(`
@@ -7262,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) {
@@ -7280,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) {
@@ -7294,7 +7532,7 @@ class HandlerRegistry {
 // packages/sharding/package.json
 var package_default2 = {
   name: "@lunibee/sharding",
-  version: "0.2.3",
+  version: "0.2.4",
   type: "module",
   module: "./src/index.ts",
   types: "./src/index.ts",
@@ -8039,6 +8277,9 @@ var SpeakingFlags = {
   Soundshare: 2,
   Priority: 4
 };
+function listenerSet(sets, event) {
+  return sets[event] ??= new Set;
+}
 
 class VoiceConnection {
   state = "disconnected" /* Disconnected */;
@@ -8048,7 +8289,7 @@ class VoiceConnection {
   selfDeaf;
   gateway;
   udp;
-  #listeners = new Map;
+  #listeners = {};
   receiver;
   constructor(options) {
     const resolved = typeof options === "string" ? { guildId: options } : options;
@@ -8064,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) {
@@ -8114,7 +8352,7 @@ class VoiceConnection {
     this.receiver.close();
     this.channelId = undefined;
     this.#transition("destroyed" /* Destroyed */);
-    this.#listeners.clear();
+    this.#listeners = {};
   }
   setChannel(channelId) {
     this.assertUsable();
@@ -8165,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) {
@@ -8178,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 {}
@@ -8205,7 +8443,7 @@ class AudioPlayer {
   #stream;
   #reader;
   #resumeSignal;
-  #listeners = new Map;
+  #playerListeners = {};
   get state() {
     return this.#state;
   }
@@ -8250,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) {}
@@ -8300,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 {}
@@ -8562,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 {
@@ -8607,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.");
@@ -8754,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 }));
@@ -9245,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;
   }
 }
@@ -9292,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) {
@@ -9323,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;
@@ -9346,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);
   }
 }
 
@@ -9468,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;
   }
 }
@@ -9501,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.`);
@@ -9589,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") {
@@ -9603,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) {
@@ -9619,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)
@@ -9637,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,
@@ -9910,4 +10092,4 @@ export {
   userMention
 };
 
-//# debugId=97695754EB32311964756E2164756E21
+//# debugId=4ECD86428171907F64756E2164756E21