lunibee 0.2.3 → 0.3.0

package/dist/managers/index.js

@@ -1,66 +1,37 @@
 // @bun
 // 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,
+    jitter: options.jitter ?? 0,
+    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))
@@ -68,81 +39,95 @@ 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.jitter !== undefined && !(options.jitter >= 0 && options.jitter <= 1))
+      throw new RangeError("jitter must be between 0 and 1.");
     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.jitter !== 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);
+    let window = ttl ?? this.#policy?.ttl;
+    const jitter = this.#policy?.jitter ?? 0;
+    if (window !== undefined && jitter > 0)
+      window = Math.max(1, window * (1 - jitter * Math.random()));
     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);
@@ -150,19 +135,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();
@@ -190,11 +179,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;
@@ -205,133 +194,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() {
@@ -363,19 +474,35 @@ class Collection extends Map {
     }
     return;
   }
+  findLast(predicate) {
+    const keys = this.keyArray();
+    const values = this.array();
+    for (let i = values.length - 1;i >= 0; i--)
+      if (predicate(values[i], keys[i], this))
+        return values[i];
+    return;
+  }
+  findLastKey(predicate) {
+    const keys = this.keyArray();
+    const values = this.array();
+    for (let i = values.length - 1;i >= 0; i--)
+      if (predicate(values[i], keys[i], this))
+        return keys[i];
+    return;
+  }
   filter(predicate) {
-    const result = new Collection;
-    for (const [key, value] of this) {
+    const result = this.#derived();
+    this.forEach((value, key) => {
       if (predicate(value, key, this))
         result.set(key, value);
-    }
+    });
     return result;
   }
   map(transform) {
     const result = [];
-    for (const [key, value] of this) {
+    this.forEach((value, key) => {
       result.push(transform(value, key, this));
-    }
+    });
     return result;
   }
   some(predicate) {
@@ -393,9 +520,9 @@ class Collection extends Map {
     return true;
   }
   each(callback) {
-    for (const [key, value] of this) {
+    this.forEach((value, key) => {
       callback(value, key, this);
-    }
+    });
     return this;
   }
   array() {
@@ -408,9 +535,10 @@ class Collection extends Map {
     return [...this.entries()];
   }
   clone() {
-    const copy = new Collection;
-    for (const [key, value] of this)
+    const copy = this.#derived();
+    this.forEach((value, key) => {
       copy.set(key, value);
+    });
     return copy;
   }
   hasAll(...keys) {
@@ -463,7 +591,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);
@@ -471,7 +599,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);
@@ -479,8 +607,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);
@@ -489,6 +617,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;
@@ -507,6 +710,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,
@@ -517,32 +727,52 @@ 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()];
-    const i = index < 0 ? arr.length + index : index;
-    return arr[i];
+    let remaining = index < 0 ? this.size + index : index;
+    if (remaining < 0)
+      return;
+    for (const value of this.values())
+      if (remaining-- === 0)
+        return value;
+    return;
   }
   keyAt(index) {
-    const arr = [...this.keys()];
-    const i = index < 0 ? arr.length + index : index;
-    return arr[i];
+    let remaining = index < 0 ? this.size + index : index;
+    if (remaining < 0)
+      return;
+    for (const key of this.keys())
+      if (remaining-- === 0)
+        return key;
+    return;
   }
   toJSON() {
     return [...this.entries()];
@@ -656,7 +886,7 @@ class ResourceManager extends Manager {
 // packages/rest/package.json
 var package_default = {
   name: "@lunibee/rest",
-  version: "0.2.3",
+  version: "0.3.0",
   type: "module",
   module: "./src/index.ts",
   types: "./src/index.ts",
@@ -673,6 +903,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`,
@@ -689,11 +922,10 @@ var Routes = {
   message: (channelId, messageId) => `/channels/${snowflake(channelId, "Channel ID")}/messages/${snowflake(messageId, "Message ID")}`,
   crosspostMessage: (channelId, messageId) => `${Routes.message(channelId, messageId)}/crosspost`,
   messageReactions: (channelId, messageId, emoji) => `${Routes.message(channelId, messageId)}/reactions/${encodeURIComponent(emoji)}`,
+  messageReactionMe: (channelId, messageId, emoji) => `${Routes.messageReactions(channelId, messageId, emoji)}/@me`,
   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`,
   channelBulkDelete: (channelId) => `/channels/${snowflake(channelId, "Channel ID")}/messages/bulk-delete`,
   channelWebhooks: (channelId) => `/channels/${snowflake(channelId, "Channel ID")}/webhooks`,
@@ -708,6 +940,10 @@ var Routes = {
   interactionOriginalResponse: (applicationId, token) => `/webhooks/${snowflake(applicationId, "Application ID")}/${encodeURIComponent(token)}/messages/@original`,
   channelPublicArchivedThreads: (channelId) => `/channels/${snowflake(channelId, "Channel ID")}/threads/archived/public`,
   channelPrivateArchivedThreads: (channelId) => `/channels/${snowflake(channelId, "Channel ID")}/threads/archived/private`,
+  channelJoinedPrivateArchivedThreads: (channelId) => `/channels/${snowflake(channelId, "Channel ID")}/users/@me/threads/archived/private`,
+  threadMember: (threadId, userId) => `/channels/${snowflake(threadId, "Thread ID")}/thread-members/${userOrMe(userId)}`,
+  channelTyping: (channelId) => `/channels/${snowflake(channelId, "Channel ID")}/typing`,
+  channelThreads: (channelId) => `/channels/${snowflake(channelId, "Channel ID")}/threads`,
   threadMembers: (threadId) => `/channels/${snowflake(threadId, "Thread ID")}/thread-members`,
   guildScheduledEvents: (guildId) => `/guilds/${snowflake(guildId, "Guild ID")}/scheduled-events`,
   guildScheduledEvent: (guildId, eventId) => `/guilds/${snowflake(guildId, "Guild ID")}/scheduled-events/${snowflake(eventId, "Event ID")}`,
@@ -720,6 +956,13 @@ var Routes = {
   gatewayBot: () => "/gateway/bot",
   guildAuditLog: (guildId) => `/guilds/${snowflake(guildId, "Guild ID")}/audit-logs`,
   guildMembers: (guildId) => `/guilds/${snowflake(guildId, "Guild ID")}/members`,
+  guildMembersSearch: (guildId) => `/guilds/${snowflake(guildId, "Guild ID")}/members/search`,
+  guildMemberMe: (guildId) => `/guilds/${snowflake(guildId, "Guild ID")}/members/@me`,
+  guildBulkBan: (guildId) => `/guilds/${snowflake(guildId, "Guild ID")}/bulk-ban`,
+  guildVoiceState: (guildId, userId) => `/guilds/${snowflake(guildId, "Guild ID")}/voice-states/${userOrMe(userId)}`,
+  guildIntegration: (guildId, integrationId) => `/guilds/${snowflake(guildId, "Guild ID")}/integrations/${snowflake(integrationId, "Integration ID")}`,
+  userGuilds: () => "/users/@me/guilds",
+  stickerPacks: (packId) => packId ? `/sticker-packs/${snowflake(packId, "Sticker pack ID")}` : "/sticker-packs",
   guildWelcomeScreen: (guildId) => `/guilds/${snowflake(guildId, "Guild ID")}/welcome-screen`,
   guildOnboarding: (guildId) => `/guilds/${snowflake(guildId, "Guild ID")}/onboarding`,
   guildPrune: (guildId) => `/guilds/${snowflake(guildId, "Guild ID")}/prune`,
@@ -740,6 +983,9 @@ var Routes = {
   consumeEntitlement: (applicationId, entitlementId) => `/applications/${snowflake(applicationId, "Application ID")}/entitlements/${snowflake(entitlementId, "Entitlement ID")}/consume`,
   skuSubscription: (skuId, subscriptionId) => subscriptionId ? `/skus/${snowflake(skuId, "SKU ID")}/subscriptions/${snowflake(subscriptionId, "Subscription ID")}` : `/skus/${snowflake(skuId, "SKU ID")}/subscriptions`
 };
+function userOrMe(value) {
+  return value === "@me" ? value : snowflake(value, "User ID");
+}
 function integer(value, field) {
   if (!Number.isInteger(value) || value < 0)
     throw new TypeError(`${field} must be a non-negative integer.`);
@@ -765,6 +1011,76 @@ var REQUEST_DATA_KEYS = new Set([
   "signal"
 ]);
 
+// packages/types/src/channel-kind.ts
+var ChannelKinds = {
+  text: [0],
+  dm: [1],
+  voice: [2],
+  "group-dm": [3],
+  category: [4],
+  announcement: [5],
+  thread: [10, 11, 12],
+  stage: [13],
+  directory: [14],
+  forum: [15],
+  media: [16]
+};
+var KIND_OF_TYPE = new Map(Object.keys(ChannelKinds).flatMap((kind) => ChannelKinds[kind].map((type) => [type, kind])));
+function channelKindOf(type) {
+  return KIND_OF_TYPE.get(type) ?? "unknown";
+}
+// packages/types/src/gateway.ts
+var GatewayIntentBits = {
+  Guilds: 1 << 0,
+  GuildMembers: 1 << 1,
+  GuildModeration: 1 << 2,
+  GuildExpressions: 1 << 3,
+  GuildIntegrations: 1 << 4,
+  GuildWebhooks: 1 << 5,
+  GuildInvites: 1 << 6,
+  GuildVoiceStates: 1 << 7,
+  GuildPresences: 1 << 8,
+  GuildMessages: 1 << 9,
+  GuildMessageReactions: 1 << 10,
+  GuildMessageTyping: 1 << 11,
+  DirectMessages: 1 << 12,
+  DirectMessageReactions: 1 << 13,
+  DirectMessageTyping: 1 << 14,
+  MessageContent: 1 << 15,
+  GuildScheduledEvents: 1 << 16,
+  AutoModerationConfiguration: 1 << 20,
+  AutoModerationExecution: 1 << 21,
+  GuildMessagePolls: 1 << 24,
+  DirectMessagePolls: 1 << 25
+};
+var IntentBits = {
+  guild: 1 << 0,
+  guilds: 1 << 0,
+  guildMembers: 1 << 1,
+  guildModeration: 1 << 2,
+  guildBans: 1 << 2,
+  guildExpressions: 1 << 3,
+  guildEmojis: 1 << 3,
+  guildEmojisAndStickers: 1 << 3,
+  guildIntegrations: 1 << 4,
+  guildWebhooks: 1 << 5,
+  guildInvites: 1 << 6,
+  guildVoiceStates: 1 << 7,
+  guildPresences: 1 << 8,
+  guildMessages: 1 << 9,
+  guildMessage: 1 << 9,
+  guildMessageReactions: 1 << 10,
+  guildMessageTyping: 1 << 11,
+  directMessages: 1 << 12,
+  directMessageReactions: 1 << 13,
+  directMessageTyping: 1 << 14,
+  messageContent: 1 << 15,
+  guildScheduledEvents: 1 << 16,
+  autoModerationConfiguration: 1 << 20,
+  autoModerationExecution: 1 << 21,
+  guildMessagePolls: 1 << 24,
+  directMessagePolls: 1 << 25
+};
 // packages/structures/src/base.ts
 class BaseStructure {
   id;
@@ -776,8 +1092,11 @@ class BaseStructure {
   toString() {
     return this.id;
   }
+  get createdTimestamp() {
+    return Number((BigInt(this.id) >> 22n) + 1420070400000n);
+  }
   get createdAt() {
-    return new Date(Number((BigInt(this.id) >> 22n) + 1420070400000n));
+    return new Date(this.createdTimestamp);
   }
 }
 var CDN_BASE = "https://cdn.discordapp.com";
@@ -785,7 +1104,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 {
@@ -859,9 +1178,6 @@ class Channel extends BaseStructure {
       throw new Error("This channel is not attached to a client.");
     return this.#context.sendMessage(this.id, options);
   }
-  sendMessage(options) {
-    return this.send(options);
-  }
   edit(options) {
     if (!this.#context?.editChannel)
       throw new Error("This channel is not attached to a client.");
@@ -891,6 +1207,17 @@ class Channel extends BaseStructure {
   update(options) {
     return this.edit(options);
   }
+  get kind() {
+    return channelKindOf(this.type);
+  }
+  is(...kinds) {
+    return kinds.includes(this.kind);
+  }
+  as(...kinds) {
+    if (!this.is(...kinds))
+      throw new TypeError(`Channel ${this.id} is a ${this.kind} channel, not ${kinds.join(" or ")}.`);
+    return this;
+  }
   isThread() {
     return this.type === 10 || this.type === 11 || this.type === 12;
   }
@@ -942,6 +1269,7 @@ class Guild extends BaseStructure {
   safetyAlertsChannelId;
   maxPresences;
   maxVideoChannelUsers;
+  premiumProgressBarEnabled;
   constructor(data) {
     super(data.id);
     if (!data.name)
@@ -979,6 +1307,7 @@ class Guild extends BaseStructure {
     this.safetyAlertsChannelId = data.safety_alerts_channel_id ?? null;
     this.maxPresences = data.max_presences ?? null;
     this.maxVideoChannelUsers = data.max_video_channel_users;
+    this.premiumProgressBarEnabled = data.premium_progress_bar_enabled ?? false;
   }
   iconURL(options = {}) {
     if (!this.icon)
@@ -1141,60 +1470,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;
@@ -1469,58 +1745,29 @@ class PermissionsBitField extends PermissionSet {
   }
 }
 var ALL_PERMISSIONS = Object.values(Permission).reduce((bits, bit) => bits | bit, 0n);
-// packages/types/src/gateway.ts
-var GatewayIntentBits = {
-  Guilds: 1 << 0,
-  GuildMembers: 1 << 1,
-  GuildModeration: 1 << 2,
-  GuildExpressions: 1 << 3,
-  GuildIntegrations: 1 << 4,
-  GuildWebhooks: 1 << 5,
-  GuildInvites: 1 << 6,
-  GuildVoiceStates: 1 << 7,
-  GuildPresences: 1 << 8,
-  GuildMessages: 1 << 9,
-  GuildMessageReactions: 1 << 10,
-  GuildMessageTyping: 1 << 11,
-  DirectMessages: 1 << 12,
-  DirectMessageReactions: 1 << 13,
-  DirectMessageTyping: 1 << 14,
-  MessageContent: 1 << 15,
-  GuildScheduledEvents: 1 << 16,
-  AutoModerationConfiguration: 1 << 20,
-  AutoModerationExecution: 1 << 21,
-  GuildMessagePolls: 1 << 24,
-  DirectMessagePolls: 1 << 25
-};
-var IntentBits = {
-  guild: 1 << 0,
-  guilds: 1 << 0,
-  guildMembers: 1 << 1,
-  guildModeration: 1 << 2,
-  guildBans: 1 << 2,
-  guildExpressions: 1 << 3,
-  guildEmojis: 1 << 3,
-  guildEmojisAndStickers: 1 << 3,
-  guildIntegrations: 1 << 4,
-  guildWebhooks: 1 << 5,
-  guildInvites: 1 << 6,
-  guildVoiceStates: 1 << 7,
-  guildPresences: 1 << 8,
-  guildMessages: 1 << 9,
-  guildMessage: 1 << 9,
-  guildMessageReactions: 1 << 10,
-  guildMessageTyping: 1 << 11,
-  directMessages: 1 << 12,
-  directMessageReactions: 1 << 13,
-  directMessageTyping: 1 << 14,
-  messageContent: 1 << 15,
-  guildScheduledEvents: 1 << 16,
-  autoModerationConfiguration: 1 << 20,
-  autoModerationExecution: 1 << 21,
-  guildMessagePolls: 1 << 24,
-  directMessagePolls: 1 << 25
-};
+// packages/builders/src/components.ts
+var IS_COMPONENTS_V2 = 1 << 15;
+// packages/builders/src/commands.ts
+var MAX_SAFE = Number.MAX_SAFE_INTEGER;
+// packages/utils/src/args.ts
+var TRUE_WORDS = new Set([
+  "true",
+  "yes",
+  "y",
+  "on",
+  "1",
+  "enable",
+  "enabled"
+]);
+var FALSE_WORDS = new Set([
+  "false",
+  "no",
+  "n",
+  "off",
+  "0",
+  "disable",
+  "disabled"
+]);
 // packages/ws/src/close-codes.ts
 var GatewayCloseCodes = {
   UnknownError: 4000,
@@ -1595,10 +1842,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) {
@@ -1661,6 +1908,7 @@ class Role extends BaseStructure {
   position;
   unicodeEmoji;
   iconHash;
+  colors;
   tags;
   constructor(data) {
     super(data.id);
@@ -1674,6 +1922,11 @@ class Role extends BaseStructure {
     this.mentionable = data.mentionable ?? false;
     this.position = data.position ?? 0;
     this.unicodeEmoji = data.unicode_emoji ?? null;
+    this.colors = data.colors ? {
+      primary: data.colors.primary_color,
+      secondary: data.colors.secondary_color,
+      tertiary: data.colors.tertiary_color
+    } : null;
     this.iconHash = data.icon ?? null;
     this.tags = data.tags ?? null;
   }
@@ -1877,6 +2130,117 @@ function createChannel(data, context) {
 }
 // packages/structures/src/interactions.ts
 var TOKEN_LIFETIME_MS = 15 * 60000;
+// packages/structures/src/audit-log.ts
+function int(value) {
+  return Number(value ?? 0);
+}
+function parseInfo(type, options) {
+  if (!options)
+    return;
+  switch (type) {
+    case 13:
+    case 14:
+    case 15:
+      return {
+        id: options.id ?? "",
+        type: int(options.type),
+        roleName: options.role_name
+      };
+    case 21:
+      return {
+        deleteMemberDays: int(options.delete_member_days),
+        membersRemoved: int(options.members_removed)
+      };
+    case 26:
+    case 72:
+      return {
+        channelId: options.channel_id ?? "",
+        count: int(options.count)
+      };
+    case 27:
+    case 73:
+      return { count: int(options.count) };
+    case 74:
+    case 75:
+      return {
+        channelId: options.channel_id ?? "",
+        messageId: options.message_id ?? ""
+      };
+    case 83:
+    case 84:
+    case 85:
+      return { channelId: options.channel_id ?? "" };
+    case 121:
+      return { applicationId: options.app_id ?? "" };
+    case 143:
+    case 144:
+    case 145:
+      return {
+        ruleName: options.auto_moderation_rule_name ?? "",
+        ruleTriggerType: int(options.auto_moderation_rule_trigger_type),
+        channelId: options.channel_id
+      };
+    default:
+      return;
+  }
+}
+
+class AuditLogEntry extends BaseStructure {
+  targetId;
+  userId;
+  actionType;
+  changes;
+  options;
+  info;
+  reason;
+  constructor(data) {
+    super(data.id);
+    this.targetId = data.target_id;
+    this.userId = data.user_id;
+    this.actionType = data.action_type;
+    this.info = parseInfo(data.action_type, data.options);
+    this.changes = data.changes ?? [];
+    this.options = data.options ?? null;
+    this.reason = data.reason ?? null;
+  }
+  is(type) {
+    return this.actionType === type;
+  }
+  change(key) {
+    const found = this.changes.find((change) => change.key === key);
+    return found && { old: found.old_value, new: found.new_value };
+  }
+}
+
+class AuditLog {
+  entries;
+  constructor(data) {
+    this.entries = new Map;
+    for (const entryData of data.audit_log_entries) {
+      this.entries.set(entryData.id, new AuditLogEntry(entryData));
+    }
+  }
+  filter(query) {
+    const types = query.type === undefined ? undefined : Array.isArray(query.type) ? query.type : [query.type];
+    const since = query.since === undefined ? undefined : new Date(query.since).getTime();
+    const matches = [];
+    for (const entry of this.entries.values()) {
+      if (types && !types.includes(entry.actionType))
+        continue;
+      if (query.targetId !== undefined && entry.targetId !== query.targetId)
+        continue;
+      if (query.userId !== undefined && entry.userId !== query.userId)
+        continue;
+      if (since !== undefined && entry.createdAt.getTime() < since)
+        continue;
+      matches.push(entry);
+    }
+    return matches;
+  }
+  find(query) {
+    return this.filter(query)[0];
+  }
+}
 
 // packages/structures/src/index.ts
 var COMPONENT_COLLECTOR_DEFAULT_TIME = 15 * 60000;
@@ -2065,6 +2429,13 @@ class Message extends BaseStructure {
 }
 
 // packages/managers/src/message.ts
+function toAttachments(files) {
+  return files.map((file) => ({
+    name: file.name,
+    data: typeof file.data === "string" ? new TextEncoder().encode(file.data) : file.data,
+    contentType: file.contentType
+  }));
+}
 function toRequest(options, allowedMentions) {
   const { files, ...body } = options;
   if (allowedMentions !== undefined && body.allowed_mentions === undefined)
@@ -2073,11 +2444,7 @@ function toRequest(options, allowedMentions) {
     return body;
   return {
     body,
-    files: files.map((file) => ({
-      name: file.name,
-      data: typeof file.data === "string" ? new TextEncoder().encode(file.data) : file.data,
-      contentType: file.contentType
-    }))
+    files: toAttachments(files)
   };
 }
 
@@ -2151,6 +2518,70 @@ class ThreadManager {
     });
     return createChannel(data, this.#context);
   }
+  async create(options) {
+    const data = await this.#rest.post(Routes.channelThreads(this.#channelId), {
+      name: options.name,
+      type: options.type ?? 12,
+      auto_archive_duration: options.autoArchiveDuration,
+      rate_limit_per_user: options.rateLimitPerUser,
+      invitable: options.invitable
+    }, { reason: options.reason });
+    return createChannel(data, this.#context);
+  }
+  async createForumPost(options) {
+    const { message, appliedTags, reason, ...thread } = options;
+    const { files, ...content } = message;
+    const data = await this.#rest.post(Routes.channelThreads(this.#channelId), {
+      name: thread.name,
+      auto_archive_duration: thread.autoArchiveDuration,
+      rate_limit_per_user: thread.rateLimitPerUser,
+      applied_tags: appliedTags,
+      message: content
+    }, { files: files?.length ? toAttachments(files) : undefined, reason });
+    return createChannel(data, this.#context);
+  }
+  async fetchArchived(scope, options = {}) {
+    const route = scope === "public" ? Routes.channelPublicArchivedThreads(this.#channelId) : scope === "private" ? Routes.channelPrivateArchivedThreads(this.#channelId) : Routes.channelJoinedPrivateArchivedThreads(this.#channelId);
+    const params = new URLSearchParams;
+    if (options.before)
+      params.set("before", options.before);
+    if (options.limit !== undefined)
+      params.set("limit", String(Math.min(100, Math.max(1, options.limit))));
+    const query = params.toString();
+    const page = await this.#rest.get(`${route}${query ? `?${query}` : ""}`);
+    return {
+      threads: page.threads.map((thread) => createChannel(thread, this.#context)),
+      members: page.members,
+      hasMore: page.has_more
+    };
+  }
+  async join(threadId) {
+    await this.#rest.put(Routes.threadMember(threadId, "@me"));
+  }
+  async leave(threadId) {
+    await this.#rest.delete(Routes.threadMember(threadId, "@me"));
+  }
+  async addMember(threadId, userId) {
+    await this.#rest.put(Routes.threadMember(threadId, userId));
+  }
+  async removeMember(threadId, userId) {
+    await this.#rest.delete(Routes.threadMember(threadId, userId));
+  }
+  async fetchMember(threadId, userId, query = {}) {
+    const suffix = query.withMember ? "?with_member=true" : "";
+    return this.#rest.get(`${Routes.threadMember(threadId, userId)}${suffix}`);
+  }
+  async fetchMembers(threadId, options = {}) {
+    const params = new URLSearchParams;
+    if (options.withMember)
+      params.set("with_member", "true");
+    if (options.after)
+      params.set("after", options.after);
+    if (options.limit !== undefined)
+      params.set("limit", String(Math.min(100, Math.max(1, options.limit))));
+    const query = params.toString();
+    return this.#rest.get(`${Routes.threadMembers(threadId)}${query ? `?${query}` : ""}`);
+  }
 }
 
 // packages/managers/src/user.ts
@@ -2168,8 +2599,21 @@ class UserManager extends ResourceManager {
     const data = await this.#rest.patch("/users/@me", options);
     return this.upsert(new User(data));
   }
+  async fetchGuilds(options = {}) {
+    const params = new URLSearchParams;
+    if (options.limit !== undefined)
+      params.set("limit", String(Math.min(200, Math.max(1, options.limit))));
+    if (options.before)
+      params.set("before", options.before);
+    if (options.after)
+      params.set("after", options.after);
+    if (options.withCounts)
+      params.set("with_counts", "true");
+    const query = params.toString();
+    return this.#rest.get(`${Routes.userGuilds()}${query ? `?${query}` : ""}`);
+  }
   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", {
@@ -2207,9 +2651,6 @@ class EmojiManager extends Manager {
     });
     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 Emoji2(data));
@@ -2390,6 +2831,39 @@ class MonetizationManager extends Manager {
   }
 }
 
+class ApplicationEmojiManager extends Manager {
+  #rest;
+  applicationId;
+  constructor(rest, applicationId) {
+    super();
+    this.#rest = rest;
+    this.applicationId = applicationId;
+  }
+  #store(emoji) {
+    if (emoji.id)
+      this.set(emoji.id, emoji);
+    return emoji;
+  }
+  async fetchAll() {
+    const { items } = await this.#rest.get(Routes.applicationEmoji(this.applicationId));
+    this.clear();
+    return items.map((emoji) => this.#store(emoji));
+  }
+  async fetch(emojiId) {
+    return this.#store(await this.#rest.get(Routes.applicationEmoji(this.applicationId, emojiId)));
+  }
+  async create(options) {
+    return this.#store(await this.#rest.post(Routes.applicationEmoji(this.applicationId), options));
+  }
+  async edit(emojiId, options) {
+    return this.#store(await this.#rest.patch(Routes.applicationEmoji(this.applicationId, emojiId), options));
+  }
+  async remove(emojiId) {
+    await this.#rest.delete(Routes.applicationEmoji(this.applicationId, emojiId));
+    this.delete(emojiId);
+  }
+}
+
 // packages/managers/src/member.ts
 class GuildMemberManager extends ResourceManager {
   #rest;
@@ -2403,6 +2877,27 @@ class GuildMemberManager extends ResourceManager {
     this.#rest = rest;
     this.#context = context;
   }
+  async search(query, limit = 1) {
+    if (!query.trim())
+      throw new TypeError("A search query is required.");
+    const params = new URLSearchParams({
+      query,
+      limit: String(Math.min(1000, Math.max(1, limit)))
+    });
+    const found = await this.#rest.get(`${Routes.guildMembersSearch(this.guildId)}?${params}`);
+    return found.map((data) => {
+      const member = new GuildMember({ ...data, guild_id: this.guildId }, this.#context());
+      this.set(member.user.id, member);
+      return member;
+    });
+  }
+  async editMe(options) {
+    const [payload, reason] = splitReason(options);
+    const data = await this.#rest.patch(Routes.guildMemberMe(this.guildId), payload, { reason });
+    const member = new GuildMember({ ...data, guild_id: this.guildId }, this.#context());
+    this.set(member.user.id, member);
+    return member;
+  }
   async kick(userId, reason) {
     await this.#rest.delete(Routes.guildMember(this.guildId, userId), {
       reason
@@ -2418,10 +2913,10 @@ class GuildMemberManager extends ResourceManager {
       reason
     });
   }
-  async edit(userId, options, reason) {
+  async edit(userId, options) {
     const [payload, optionsReason] = splitReason(options);
     const data = await this.#rest.patch(Routes.guildMember(this.guildId, userId), payload, {
-      reason: optionsReason ?? reason
+      reason: optionsReason
     });
     const member = new GuildMember({ ...data, guild_id: this.guildId }, this.#context());
     this.set(member.user.id, member);
@@ -2435,7 +2930,10 @@ class GuildMemberManager extends ResourceManager {
   }
   async timeout(userId, milliseconds, reason) {
     const timeoutDate = milliseconds === null ? null : new Date(Date.now() + milliseconds).toISOString();
-    return this.edit(userId, { communication_disabled_until: timeoutDate }, reason);
+    return this.edit(userId, {
+      communication_disabled_until: timeoutDate,
+      reason
+    });
   }
 }
 
@@ -2458,20 +2956,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;
@@ -2490,9 +2983,19 @@ class RoleManager extends ResourceManager {
       return role;
     });
   }
-  deleteRole(roleId) {
-    return this.remove(roleId);
-  }
+}
+function rolePayload(options) {
+  const { permissions, colors, unicodeEmoji, ...rest } = options;
+  return {
+    ...rest,
+    permissions: permissions !== undefined ? String(permissions) : undefined,
+    colors: colors && {
+      primary_color: colors.primary,
+      secondary_color: colors.secondary ?? null,
+      tertiary_color: colors.tertiary ?? null
+    },
+    unicode_emoji: unicodeEmoji
+  };
 }
 
 // packages/managers/src/guild-resources.ts
@@ -2532,6 +3035,18 @@ class GuildBanManager extends Manager {
   async create(userId, options = {}) {
     await this.#rest.put(Routes.guildBan(this.guildId, userId), { delete_message_seconds: options.deleteMessageSeconds }, { reason: options.reason });
   }
+  async bulk(userIds, options = {}) {
+    if (userIds.length < 1 || userIds.length > 200)
+      throw new RangeError("Bulk ban takes 1 to 200 user IDs.");
+    const result = await this.#rest.post(Routes.guildBulkBan(this.guildId), {
+      user_ids: userIds,
+      delete_message_seconds: options.deleteMessageSeconds
+    }, { reason: options.reason });
+    return {
+      banned: result.banned_users ?? [],
+      failed: result.failed_users ?? []
+    };
+  }
   async remove(userId, reason) {
     await this.#rest.delete(Routes.guildBan(this.guildId, userId), {
       reason
@@ -2563,13 +3078,13 @@ class GuildScheduledEventManager extends Manager {
     }));
     return events.map((event) => this.#store(event));
   }
-  async create(options, reason) {
+  async create(options) {
     const [payload, optionsReason] = splitReason(options);
-    return this.#store(await this.#rest.post(Routes.guildScheduledEvents(this.guildId), payload, { reason: optionsReason ?? reason }));
+    return this.#store(await this.#rest.post(Routes.guildScheduledEvents(this.guildId), payload, { reason: optionsReason }));
   }
-  async edit(eventId, options, reason) {
+  async edit(eventId, options) {
     const [payload, optionsReason] = splitReason(options);
-    return this.#store(await this.#rest.patch(Routes.guildScheduledEvent(this.guildId, eventId), payload, { reason: optionsReason ?? reason }));
+    return this.#store(await this.#rest.patch(Routes.guildScheduledEvent(this.guildId, eventId), payload, { reason: optionsReason }));
   }
   async remove(eventId, reason) {
     await this.#rest.delete(Routes.guildScheduledEvent(this.guildId, eventId), { reason });
@@ -2596,20 +3111,20 @@ class StageInstanceManager extends Manager {
     this.set(stage.channel_id, stage);
     return stage;
   }
-  async create(channelId, options, reason) {
+  async create(channelId, options) {
     return this.#store(await this.#rest.post(Routes.stageInstances(), {
       channel_id: channelId,
       topic: options.topic,
       privacy_level: options.privacyLevel,
       send_start_notification: options.sendStartNotification,
       guild_scheduled_event_id: options.guildScheduledEventId
-    }, { reason: options.reason ?? reason }));
+    }, { reason: options.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: options.reason ?? reason }));
+  async edit(channelId, options) {
+    return this.#store(await this.#rest.patch(Routes.stageInstanceByChannel(channelId), { topic: options.topic, privacy_level: options.privacyLevel }, { reason: options.reason }));
   }
   async remove(channelId, reason) {
     await this.#rest.delete(Routes.stageInstanceByChannel(channelId), {
@@ -2639,14 +3154,19 @@ class PermissionOverwriteManager {
     const touched = (changes.allow ?? 0n) | (changes.deny ?? 0n) | (changes.inherit ?? 0n);
     const allow = BigInt(existing?.allow ?? 0) & ~touched | (changes.allow ?? 0n);
     const deny = BigInt(existing?.deny ?? 0) & ~touched | (changes.deny ?? 0n);
-    await this.edit(overwriteId, { type, allow, deny }, options.reason);
+    await this.edit(overwriteId, {
+      type,
+      allow,
+      deny,
+      reason: options.reason
+    });
   }
-  async edit(overwriteId, options, reason) {
+  async edit(overwriteId, options) {
     await this.#rest.put(Routes.channelPermission(this.channelId, overwriteId), {
       type: options.type,
       allow: BigInt(options.allow ?? 0).toString(),
       deny: BigInt(options.deny ?? 0).toString()
-    }, { reason: options.reason ?? reason });
+    }, { reason: options.reason });
   }
   async remove(overwriteId, reason) {
     await this.#rest.delete(Routes.channelPermission(this.channelId, overwriteId), { reason });
@@ -2670,6 +3190,7 @@ class GuildManager extends ResourceManager {
   #soundboard = new Map;
   #voiceStates = new Map;
   #autoModerationRules = new Map;
+  #presences = new Map;
   #invites = new Map;
   #context;
   attachContext(context) {
@@ -2730,6 +3251,9 @@ class GuildManager extends ResourceManager {
   voiceStates(guildId) {
     return this.#perGuild(this.#voiceStates, guildId, () => new Manager);
   }
+  presences(guildId) {
+    return this.#perGuild(this.#presences, guildId, () => new Manager);
+  }
   autoModerationRules(guildId) {
     return this.#perGuild(this.#autoModerationRules, guildId, () => new Manager);
   }
@@ -2755,6 +3279,7 @@ class GuildManager extends ResourceManager {
     this.#stickers.delete(id);
     this.#soundboard.delete(id);
     this.#voiceStates.delete(id);
+    this.#presences.delete(id);
     this.#autoModerationRules.delete(id);
     this.#invites.delete(id);
     return super.delete(id);
@@ -2771,12 +3296,35 @@ class GuildManager extends ResourceManager {
   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));
   }
+  async fetchWelcomeScreen(id) {
+    return this.#rest.get(Routes.guildWelcomeScreen(id));
+  }
+  async editWelcomeScreen(id, options) {
+    const { reason, welcomeChannels, ...rest } = options;
+    return this.#rest.patch(Routes.guildWelcomeScreen(id), { ...rest, welcome_channels: welcomeChannels }, { reason });
+  }
+  async fetchOnboarding(id) {
+    return this.#rest.get(Routes.guildOnboarding(id));
+  }
+  async editOnboarding(id, options) {
+    const { reason, defaultChannelIds, ...rest } = options;
+    return this.#rest.put(Routes.guildOnboarding(id), { ...rest, default_channel_ids: defaultChannelIds }, { reason });
+  }
+  async editVoiceState(id, userId, options) {
+    await this.#rest.patch(Routes.guildVoiceState(id, userId), {
+      channel_id: options.channelId,
+      suppress: options.suppress,
+      request_to_speak_timestamp: options.requestToSpeakTimestamp
+    });
+  }
+  async removeIntegration(id, integrationId, reason) {
+    await this.#rest.delete(Routes.guildIntegration(id, integrationId), {
+      reason
+    });
+  }
   async fetchActiveThreads(id) {
     return this.#rest.get(Routes.guildActiveThreads(id));
   }
@@ -2800,6 +3348,9 @@ class GuildManager extends ResourceManager {
       params.set("limit", String(Math.min(100, Math.max(1, options.limit))));
     return this.#rest.get(withQuery3(Routes.guildAuditLog(guildId), params));
   }
+  async fetchAuditLogEntries(guildId, options = {}) {
+    return new AuditLog(await this.fetchAuditLog(guildId, options));
+  }
   async fetchMembers(guildId, options = {}) {
     const params = new URLSearchParams;
     if (options.limit !== undefined)
@@ -3033,9 +3584,6 @@ class ChannelManager extends Manager {
     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);
@@ -3043,9 +3591,6 @@ class ChannelManager extends Manager {
   send(channelId, options) {
     return this.messages(channelId).send(options);
   }
-  sendMessage(channelId, options) {
-    return this.send(channelId, options);
-  }
   async fetchMessage(channelId, messageId, options = {}) {
     return this.messages(channelId).fetch(messageId);
   }
@@ -3114,7 +3659,7 @@ class ChannelManager extends Manager {
     }
   }
   async addReaction(channelId, messageId, emoji) {
-    await this.#rest.put(`${Routes.messageReactions(channelId, messageId, emoji)}/@me`);
+    await this.#rest.put(Routes.messageReactionMe(channelId, messageId, emoji));
   }
   async fetchReactions(channelId, messageId, emoji, options = {}) {
     const params = new URLSearchParams;
@@ -3127,10 +3672,10 @@ class ChannelManager extends Manager {
     return data.map((user) => new User(user));
   }
   async removeOwnReaction(channelId, messageId, emoji) {
-    await this.#rest.delete(`${Routes.messageReactions(channelId, messageId, emoji)}/@me`);
+    await this.#rest.delete(Routes.messageReactionMe(channelId, messageId, emoji));
   }
   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));
@@ -3139,6 +3684,46 @@ class ChannelManager extends Manager {
     const data = await this.#rest.get(Routes.channelMessagesPins(channelId));
     return data.items.map((item) => this.messages(channelId).upsert(item.message));
   }
+  async fetchPins(channelId, options = {}) {
+    const params = new URLSearchParams;
+    if (options.before)
+      params.set("before", options.before);
+    if (options.limit !== undefined)
+      params.set("limit", String(Math.min(50, Math.max(1, options.limit))));
+    const query = params.toString();
+    const data = await this.#rest.get(`${Routes.channelMessagesPins(channelId)}${query ? `?${query}` : ""}`);
+    return {
+      messages: data.items.map((item) => this.messages(channelId).upsert(item.message)),
+      hasMore: data.has_more
+    };
+  }
+  async triggerTyping(channelId) {
+    await this.#rest.post(Routes.channelTyping(channelId));
+  }
+  async createForumTag(channelId, tag, reason) {
+    const tags = await this.#forumTags(channelId);
+    return this.#saveForumTags(channelId, [...tags, tag], reason);
+  }
+  async editForumTag(channelId, tagId, changes, reason) {
+    const tags = await this.#forumTags(channelId);
+    if (!tags.some((tag) => tag.id === tagId))
+      throw new Error(`Channel ${channelId} has no tag ${tagId}.`);
+    return this.#saveForumTags(channelId, tags.map((tag) => tag.id === tagId ? { ...tag, ...changes } : tag), reason);
+  }
+  async removeForumTag(channelId, tagId, reason) {
+    const tags = await this.#forumTags(channelId);
+    if (!tags.some((tag) => tag.id === tagId))
+      throw new Error(`Channel ${channelId} has no tag ${tagId}.`);
+    return this.#saveForumTags(channelId, tags.filter((tag) => tag.id !== tagId), reason);
+  }
+  async#forumTags(channelId) {
+    const channel = await this.#rest.get(Routes.channel(channelId));
+    return channel.available_tags ?? [];
+  }
+  async#saveForumTags(channelId, tags, reason) {
+    const updated = await this.#rest.patch(Routes.channel(channelId), { available_tags: tags }, { reason });
+    return updated.available_tags ?? [];
+  }
   async pinMessage(channelId, messageId, reason) {
     await this.#rest.put(Routes.channelMessagesPin(channelId, messageId), undefined, { reason });
   }
@@ -3167,9 +3752,6 @@ class ChannelManager extends Manager {
       hasMore: messages.length === limit
     };
   }
-  bulkDelete(channelId, messageIds) {
-    return this.bulkDeleteMessages(channelId, messageIds);
-  }
   clear() {
     this.#messageManagers.clear();
     super.clear();
@@ -3180,6 +3762,7 @@ function isMessageQuery(value) {
 }
 export {
   ApplicationCommandManager,
+  ApplicationEmojiManager,
   AuditLogEvent,
   ResourceManager as CachedManager,
   ChannelManager,
@@ -3202,4 +3785,4 @@ export {
   toRequest
 };
 
-//# debugId=1B8C9372B2A05B6E64756E2164756E21
+//# debugId=857DC05BD7F0D60E64756E2164756E21